{ "tools": [ { "name": "list_agents", "title": "List Agents", "description": "List persistent agents accessible to the API key.", "inputSchema": { "type": "object", "properties": { "page": { "type": "integer", "minimum": 1, "maximum": 100000, "default": 1 }, "page_size": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 }, "user_id": { "type": [ "integer", "string", "null" ], "description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." }, "organization_id": { "type": [ "string", "null" ], "format": "uuid", "description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." } }, "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "agents": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "charter": { "type": [ "string", "null" ] }, "short_description": { "type": [ "string", "null" ] }, "schedule": { "type": [ "string", "null" ] }, "is_active": { "type": "boolean" }, "life_state": { "type": "string" }, "planning_state": { "type": [ "string", "null" ] }, "whitelist_policy": { "type": "string" }, "contact_approval_mode": { "type": "string" }, "created_at": { "type": [ "string", "null" ] }, "updated_at": { "type": [ "string", "null" ] }, "last_interaction_at": { "type": [ "string", "null" ] }, "user_id": { "type": [ "string", "null" ] }, "organization_id": { "type": [ "string", "null" ] }, "team_id": { "type": [ "string", "null" ] }, "workspace": { "type": "object" }, "browser_use_agent_id": { "type": [ "string", "null" ] }, "preferred_contact_endpoint_id": { "type": [ "string", "null" ] }, "preferred_llm_tier": { "type": [ "string", "null" ] }, "daily_credit_limit": { "type": [ "integer", "null" ], "deprecated": true, "description": "Inactive historical credit target; writes are rejected." }, "credit_controls_active": { "type": "boolean", "const": false }, "daily_credit_soft_target": { "type": [ "integer", "number", "string", "null" ] }, "daily_credit_hard_limit": { "type": [ "integer", "number", "string", "null" ] }, "proactive_opt_in": { "type": "boolean" }, "proactive_last_trigger_at": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "id", "name", "schedule", "is_active" ] } }, "page": { "type": "integer" }, "page_size": { "type": "integer" }, "total": { "type": "integer" }, "has_next": { "type": "boolean" }, "access": { "type": "object", "properties": { "admin_access": { "type": "boolean" }, "access_scope": { "type": "string" }, "operator_user_id": { "type": [ "integer", "string", "null" ] }, "target_user_id": { "type": [ "integer", "string", "null" ] }, "target_organization_id": { "type": [ "string", "null" ] }, "requested_user_id": { "type": [ "integer", "string", "null" ] }, "requested_organization_id": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "admin_access", "access_scope" ] } }, "additionalProperties": true, "required": [ "agents", "page", "page_size", "total", "has_next" ] }, "annotations": { "readOnlyHint": true } }, { "name": "get_agent", "title": "Get Agent", "description": "Retrieve details for one persistent agent.", "inputSchema": { "type": "object", "properties": { "agent_id": { "type": "string", "format": "uuid", "description": "Persistent agent UUID." }, "user_id": { "type": [ "integer", "string", "null" ], "description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." }, "organization_id": { "type": [ "string", "null" ], "format": "uuid", "description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." } }, "required": [ "agent_id" ], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "agent": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "charter": { "type": [ "string", "null" ] }, "short_description": { "type": [ "string", "null" ] }, "schedule": { "type": [ "string", "null" ] }, "is_active": { "type": "boolean" }, "life_state": { "type": "string" }, "planning_state": { "type": [ "string", "null" ] }, "whitelist_policy": { "type": "string" }, "contact_approval_mode": { "type": "string" }, "created_at": { "type": [ "string", "null" ] }, "updated_at": { "type": [ "string", "null" ] }, "last_interaction_at": { "type": [ "string", "null" ] }, "user_id": { "type": [ "string", "null" ] }, "organization_id": { "type": [ "string", "null" ] }, "team_id": { "type": [ "string", "null" ] }, "workspace": { "type": "object" }, "browser_use_agent_id": { "type": [ "string", "null" ] }, "preferred_contact_endpoint_id": { "type": [ "string", "null" ] }, "preferred_llm_tier": { "type": [ "string", "null" ] }, "daily_credit_limit": { "type": [ "integer", "null" ], "deprecated": true, "description": "Inactive historical credit target; writes are rejected." }, "credit_controls_active": { "type": "boolean", "const": false }, "daily_credit_soft_target": { "type": [ "integer", "number", "string", "null" ] }, "daily_credit_hard_limit": { "type": [ "integer", "number", "string", "null" ] }, "proactive_opt_in": { "type": "boolean" }, "proactive_last_trigger_at": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "id", "name", "schedule", "is_active" ] }, "access": { "type": "object", "properties": { "admin_access": { "type": "boolean" }, "access_scope": { "type": "string" }, "operator_user_id": { "type": [ "integer", "string", "null" ] }, "target_user_id": { "type": [ "integer", "string", "null" ] }, "target_organization_id": { "type": [ "string", "null" ] }, "requested_user_id": { "type": [ "integer", "string", "null" ] }, "requested_organization_id": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "admin_access", "access_scope" ] } }, "additionalProperties": true, "required": [ "agent" ] }, "annotations": { "readOnlyHint": true } }, { "name": "create_agent", "title": "Create Agent", "description": "Create a persistent agent using the same provisioning path as the public Agent API.", "inputSchema": { "type": "object", "properties": { "name": { "type": "string", "description": "Display name. Required when the organization requires agent names; otherwise Decision Terrain generates one when omitted." }, "charter": { "type": "string", "description": "Instructions describing the agent's job." }, "schedule": { "type": [ "string", "null" ], "description": "Optional cron-like schedule, @daily, or @every interval." }, "is_active": { "type": "boolean", "default": true }, "preferred_llm_tier": { "type": "string", "description": "Preferred intelligence tier key, such as standard, premium, max, ultra, or ultra_max." }, "daily_credit_limit": { "type": [ "integer", "null" ], "minimum": 1, "description": "Deprecated, inactive historical credit field. Writes are rejected." }, "whitelist_policy": { "type": "string", "enum": [ "default", "manual" ], "description": "Contact allowlist policy." }, "contact_approval_mode": { "type": "string", "enum": [ "require_approval", "auto_approve_email" ] }, "proactive_opt_in": { "type": "boolean", "default": true }, "team_id": { "type": "string", "format": "uuid", "description": "Optional active Team within the key Organization; requires Team creation authority." }, "user_id": { "type": [ "integer", "string", "null" ], "description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." }, "organization_id": { "type": [ "string", "null" ], "format": "uuid", "description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." } }, "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "agent": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "charter": { "type": [ "string", "null" ] }, "short_description": { "type": [ "string", "null" ] }, "schedule": { "type": [ "string", "null" ] }, "is_active": { "type": "boolean" }, "life_state": { "type": "string" }, "planning_state": { "type": [ "string", "null" ] }, "whitelist_policy": { "type": "string" }, "contact_approval_mode": { "type": "string" }, "created_at": { "type": [ "string", "null" ] }, "updated_at": { "type": [ "string", "null" ] }, "last_interaction_at": { "type": [ "string", "null" ] }, "user_id": { "type": [ "string", "null" ] }, "organization_id": { "type": [ "string", "null" ] }, "team_id": { "type": [ "string", "null" ] }, "workspace": { "type": "object" }, "browser_use_agent_id": { "type": [ "string", "null" ] }, "preferred_contact_endpoint_id": { "type": [ "string", "null" ] }, "preferred_llm_tier": { "type": [ "string", "null" ] }, "daily_credit_limit": { "type": [ "integer", "null" ], "deprecated": true, "description": "Inactive historical credit target; writes are rejected." }, "credit_controls_active": { "type": "boolean", "const": false }, "daily_credit_soft_target": { "type": [ "integer", "number", "string", "null" ] }, "daily_credit_hard_limit": { "type": [ "integer", "number", "string", "null" ] }, "proactive_opt_in": { "type": "boolean" }, "proactive_last_trigger_at": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "id", "name", "schedule", "is_active" ] }, "access": { "type": "object", "properties": { "admin_access": { "type": "boolean" }, "access_scope": { "type": "string" }, "operator_user_id": { "type": [ "integer", "string", "null" ] }, "target_user_id": { "type": [ "integer", "string", "null" ] }, "target_organization_id": { "type": [ "string", "null" ] }, "requested_user_id": { "type": [ "integer", "string", "null" ] }, "requested_organization_id": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "admin_access", "access_scope" ] } }, "additionalProperties": true, "required": [ "agent" ] }, "annotations": { "destructiveHint": false } }, { "name": "update_agent", "title": "Update Agent", "description": "Update only the supplied persistent agent settings; omitted mutable fields retain their current values. Send null for schedule to clear it. Credit fields are deprecated, inactive reads; writes are rejected.", "inputSchema": { "type": "object", "properties": { "agent_id": { "type": "string", "format": "uuid", "description": "Persistent agent UUID." }, "name": { "type": "string" }, "charter": { "type": "string" }, "schedule": { "type": [ "string", "null" ] }, "is_active": { "type": "boolean" }, "preferred_llm_tier": { "type": "string", "description": "Preferred intelligence tier key, such as standard, premium, max, ultra, or ultra_max." }, "daily_credit_limit": { "type": [ "integer", "null" ], "minimum": 1, "description": "Deprecated, inactive historical credit field. Writes are rejected." }, "whitelist_policy": { "type": "string", "enum": [ "default", "manual" ] }, "contact_approval_mode": { "type": "string", "enum": [ "require_approval", "auto_approve_email" ] }, "proactive_opt_in": { "type": "boolean" }, "user_id": { "type": [ "integer", "string", "null" ], "description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." }, "organization_id": { "type": [ "string", "null" ], "format": "uuid", "description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." } }, "required": [ "agent_id" ], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "agent": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "charter": { "type": [ "string", "null" ] }, "short_description": { "type": [ "string", "null" ] }, "schedule": { "type": [ "string", "null" ] }, "is_active": { "type": "boolean" }, "life_state": { "type": "string" }, "planning_state": { "type": [ "string", "null" ] }, "whitelist_policy": { "type": "string" }, "contact_approval_mode": { "type": "string" }, "created_at": { "type": [ "string", "null" ] }, "updated_at": { "type": [ "string", "null" ] }, "last_interaction_at": { "type": [ "string", "null" ] }, "user_id": { "type": [ "string", "null" ] }, "organization_id": { "type": [ "string", "null" ] }, "team_id": { "type": [ "string", "null" ] }, "workspace": { "type": "object" }, "browser_use_agent_id": { "type": [ "string", "null" ] }, "preferred_contact_endpoint_id": { "type": [ "string", "null" ] }, "preferred_llm_tier": { "type": [ "string", "null" ] }, "daily_credit_limit": { "type": [ "integer", "null" ], "deprecated": true, "description": "Inactive historical credit target; writes are rejected." }, "credit_controls_active": { "type": "boolean", "const": false }, "daily_credit_soft_target": { "type": [ "integer", "number", "string", "null" ] }, "daily_credit_hard_limit": { "type": [ "integer", "number", "string", "null" ] }, "proactive_opt_in": { "type": "boolean" }, "proactive_last_trigger_at": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "id", "name", "schedule", "is_active" ] }, "access": { "type": "object", "properties": { "admin_access": { "type": "boolean" }, "access_scope": { "type": "string" }, "operator_user_id": { "type": [ "integer", "string", "null" ] }, "target_user_id": { "type": [ "integer", "string", "null" ] }, "target_organization_id": { "type": [ "string", "null" ] }, "requested_user_id": { "type": [ "integer", "string", "null" ] }, "requested_organization_id": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "admin_access", "access_scope" ] } }, "additionalProperties": true, "required": [ "agent" ] } }, { "name": "archive_agent", "title": "Archive Agent", "description": "Soft-delete a persistent agent using Decision Terrain's normal archive/delete behavior.", "inputSchema": { "type": "object", "properties": { "agent_id": { "type": "string", "format": "uuid", "description": "Persistent agent UUID." }, "user_id": { "type": [ "integer", "string", "null" ], "description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." }, "organization_id": { "type": [ "string", "null" ], "format": "uuid", "description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." } }, "required": [ "agent_id" ], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "status": { "type": "string" }, "changed": { "type": "boolean" }, "agent": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "charter": { "type": [ "string", "null" ] }, "short_description": { "type": [ "string", "null" ] }, "schedule": { "type": [ "string", "null" ] }, "is_active": { "type": "boolean" }, "life_state": { "type": "string" }, "planning_state": { "type": [ "string", "null" ] }, "whitelist_policy": { "type": "string" }, "contact_approval_mode": { "type": "string" }, "created_at": { "type": [ "string", "null" ] }, "updated_at": { "type": [ "string", "null" ] }, "last_interaction_at": { "type": [ "string", "null" ] }, "user_id": { "type": [ "string", "null" ] }, "organization_id": { "type": [ "string", "null" ] }, "team_id": { "type": [ "string", "null" ] }, "workspace": { "type": "object" }, "browser_use_agent_id": { "type": [ "string", "null" ] }, "preferred_contact_endpoint_id": { "type": [ "string", "null" ] }, "preferred_llm_tier": { "type": [ "string", "null" ] }, "daily_credit_limit": { "type": [ "integer", "null" ], "deprecated": true, "description": "Inactive historical credit target; writes are rejected." }, "credit_controls_active": { "type": "boolean", "const": false }, "daily_credit_soft_target": { "type": [ "integer", "number", "string", "null" ] }, "daily_credit_hard_limit": { "type": [ "integer", "number", "string", "null" ] }, "proactive_opt_in": { "type": "boolean" }, "proactive_last_trigger_at": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "id", "name", "schedule", "is_active" ] }, "access": { "type": "object", "properties": { "admin_access": { "type": "boolean" }, "access_scope": { "type": "string" }, "operator_user_id": { "type": [ "integer", "string", "null" ] }, "target_user_id": { "type": [ "integer", "string", "null" ] }, "target_organization_id": { "type": [ "string", "null" ] }, "requested_user_id": { "type": [ "integer", "string", "null" ] }, "requested_organization_id": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "admin_access", "access_scope" ] } }, "additionalProperties": true, "required": [ "status", "changed", "agent" ] }, "annotations": { "destructiveHint": true } }, { "name": "get_agent_config_options", "title": "Get Agent Config Options", "description": "Discover supported agent configuration fields, intelligence tiers, inference usage, schedules, and policies for this API key.", "inputSchema": { "type": "object", "properties": { "agent_id": { "type": "string", "format": "uuid", "description": "Optional persistent agent UUID to include current per-agent config." }, "user_id": { "type": [ "integer", "string", "null" ], "description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." }, "organization_id": { "type": [ "string", "null" ], "format": "uuid", "description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." } }, "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "owner": { "type": "object", "properties": { "type": { "type": "string" }, "id": { "type": [ "integer", "string" ] }, "name": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "type", "id" ] }, "agent": { "anyOf": [ { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "charter": { "type": [ "string", "null" ] }, "short_description": { "type": [ "string", "null" ] }, "schedule": { "type": [ "string", "null" ] }, "is_active": { "type": "boolean" }, "life_state": { "type": "string" }, "planning_state": { "type": [ "string", "null" ] }, "whitelist_policy": { "type": "string" }, "contact_approval_mode": { "type": "string" }, "created_at": { "type": [ "string", "null" ] }, "updated_at": { "type": [ "string", "null" ] }, "last_interaction_at": { "type": [ "string", "null" ] }, "user_id": { "type": [ "string", "null" ] }, "organization_id": { "type": [ "string", "null" ] }, "team_id": { "type": [ "string", "null" ] }, "workspace": { "type": "object" }, "browser_use_agent_id": { "type": [ "string", "null" ] }, "preferred_contact_endpoint_id": { "type": [ "string", "null" ] }, "preferred_llm_tier": { "type": [ "string", "null" ] }, "daily_credit_limit": { "type": [ "integer", "null" ], "deprecated": true, "description": "Inactive historical credit target; writes are rejected." }, "credit_controls_active": { "type": "boolean", "const": false }, "daily_credit_soft_target": { "type": [ "integer", "number", "string", "null" ] }, "daily_credit_hard_limit": { "type": [ "integer", "number", "string", "null" ] }, "proactive_opt_in": { "type": "boolean" }, "proactive_last_trigger_at": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "id", "name", "schedule", "is_active" ] }, { "type": "null" } ] }, "access": { "type": "object", "properties": { "admin_access": { "type": "boolean" }, "access_scope": { "type": "string" }, "operator_user_id": { "type": [ "integer", "string", "null" ] }, "target_user_id": { "type": [ "integer", "string", "null" ] }, "target_organization_id": { "type": [ "string", "null" ] }, "requested_user_id": { "type": [ "integer", "string", "null" ] }, "requested_organization_id": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "admin_access", "access_scope" ] }, "fields": { "type": "object", "properties": { "preferred_llm_tier": { "type": "object", "properties": { "type": { "type": "string" }, "current_system_default": { "type": "string" }, "max_allowed_tier": { "type": "string" }, "max_allowed_rank": { "type": "integer" }, "options": { "type": "array", "items": { "type": "object", "properties": { "key": { "type": "string" }, "label": { "type": "string" }, "description": { "type": "string" }, "rank": { "type": "integer" }, "credit_multiplier": { "type": [ "number", "string" ] }, "is_default": { "type": "boolean" }, "allowed": { "type": "boolean" } }, "additionalProperties": true, "required": [ "key", "label", "allowed" ] } } }, "additionalProperties": true, "required": [ "type", "options" ] }, "daily_credit_limit": { "type": "object", "properties": { "type": { "type": "string" }, "deprecated": { "type": "boolean" }, "active": { "type": "boolean" }, "writable": { "type": "boolean" }, "enforced_by_agent_runtime": { "type": "boolean" }, "message": { "type": "string" } }, "additionalProperties": true, "required": [ "type", "deprecated", "active", "writable", "enforced_by_agent_runtime", "message" ] } }, "additionalProperties": true, "required": [ "preferred_llm_tier", "daily_credit_limit" ] }, "unsupported_remote_mcp_v1_fields": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": true, "required": [ "owner", "fields", "unsupported_remote_mcp_v1_fields" ] }, "annotations": { "readOnlyHint": true } }, { "name": "list_agent_links", "title": "List Agent Links", "description": "List peer-agent links for accessible agents.", "inputSchema": { "type": "object", "properties": { "agent_id": { "type": "string", "format": "uuid", "description": "Optional agent UUID to filter links." }, "user_id": { "type": [ "integer", "string", "null" ], "description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." }, "organization_id": { "type": [ "string", "null" ], "format": "uuid", "description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." } }, "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "links": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "agent_a": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "is_active": { "type": "boolean" }, "life_state": { "type": "string" } }, "additionalProperties": true, "required": [ "id", "name" ] }, "agent_b": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "is_active": { "type": "boolean" }, "life_state": { "type": "string" } }, "additionalProperties": true, "required": [ "id", "name" ] }, "health": { "type": "object", "properties": { "status": { "type": "string" }, "issues": { "type": "array", "items": { "type": "object", "properties": { "agent_id": { "type": "string", "format": "uuid" }, "reason": { "type": "string" } }, "additionalProperties": true, "required": [ "agent_id", "reason" ] } } }, "additionalProperties": true, "required": [ "status", "issues" ] }, "is_enabled": { "type": "boolean" }, "messages_per_window": { "type": "integer" }, "window_hours": { "type": "integer" }, "feature_flag": { "type": [ "string", "null" ] }, "pair_key": { "type": "string" }, "created_by_user_id": { "type": [ "integer", "string", "null" ] }, "created_at": { "type": [ "string", "null" ] }, "updated_at": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "id", "agent_a", "agent_b", "is_enabled" ] } }, "access": { "type": "object", "properties": { "admin_access": { "type": "boolean" }, "access_scope": { "type": "string" }, "operator_user_id": { "type": [ "integer", "string", "null" ] }, "target_user_id": { "type": [ "integer", "string", "null" ] }, "target_organization_id": { "type": [ "string", "null" ] }, "requested_user_id": { "type": [ "integer", "string", "null" ] }, "requested_organization_id": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "admin_access", "access_scope" ] } }, "additionalProperties": true, "required": [ "links" ] }, "annotations": { "readOnlyHint": true } }, { "name": "link_agents", "title": "Link Agents", "description": "Create or enable a peer-agent link between two accessible agents so they can coordinate.", "inputSchema": { "type": "object", "properties": { "agent_id": { "type": "string", "format": "uuid", "description": "First persistent agent UUID." }, "peer_agent_id": { "type": "string", "format": "uuid", "description": "Second persistent agent UUID." }, "messages_per_window": { "type": "integer", "minimum": 1, "maximum": 500, "default": 30 }, "window_hours": { "type": "integer", "minimum": 1, "maximum": 168, "default": 6 }, "user_id": { "type": [ "integer", "string", "null" ], "description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." }, "organization_id": { "type": [ "string", "null" ], "format": "uuid", "description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." } }, "required": [ "agent_id", "peer_agent_id" ], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "link": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "agent_a": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "is_active": { "type": "boolean" }, "life_state": { "type": "string" } }, "additionalProperties": true, "required": [ "id", "name" ] }, "agent_b": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "is_active": { "type": "boolean" }, "life_state": { "type": "string" } }, "additionalProperties": true, "required": [ "id", "name" ] }, "health": { "type": "object", "properties": { "status": { "type": "string" }, "issues": { "type": "array", "items": { "type": "object", "properties": { "agent_id": { "type": "string", "format": "uuid" }, "reason": { "type": "string" } }, "additionalProperties": true, "required": [ "agent_id", "reason" ] } } }, "additionalProperties": true, "required": [ "status", "issues" ] }, "is_enabled": { "type": "boolean" }, "messages_per_window": { "type": "integer" }, "window_hours": { "type": "integer" }, "feature_flag": { "type": [ "string", "null" ] }, "pair_key": { "type": "string" }, "created_by_user_id": { "type": [ "integer", "string", "null" ] }, "created_at": { "type": [ "string", "null" ] }, "updated_at": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "id", "agent_a", "agent_b", "is_enabled" ] }, "created": { "type": "boolean" }, "access": { "type": "object", "properties": { "admin_access": { "type": "boolean" }, "access_scope": { "type": "string" }, "operator_user_id": { "type": [ "integer", "string", "null" ] }, "target_user_id": { "type": [ "integer", "string", "null" ] }, "target_organization_id": { "type": [ "string", "null" ] }, "requested_user_id": { "type": [ "integer", "string", "null" ] }, "requested_organization_id": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "admin_access", "access_scope" ] } }, "additionalProperties": true, "required": [ "link", "created" ] }, "annotations": { "destructiveHint": false } }, { "name": "unlink_agents", "title": "Unlink Agents", "description": "Remove a peer-agent link while preserving historical peer conversation messages.", "inputSchema": { "type": "object", "properties": { "peer_link_id": { "type": "string", "format": "uuid", "description": "Existing peer link UUID." }, "agent_id": { "type": "string", "format": "uuid", "description": "First persistent agent UUID when peer_link_id is omitted." }, "peer_agent_id": { "type": "string", "format": "uuid", "description": "Second persistent agent UUID when peer_link_id is omitted." }, "user_id": { "type": [ "integer", "string", "null" ], "description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." }, "organization_id": { "type": [ "string", "null" ], "format": "uuid", "description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." } }, "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "status": { "type": "string" }, "link": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "agent_a": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "is_active": { "type": "boolean" }, "life_state": { "type": "string" } }, "additionalProperties": true, "required": [ "id", "name" ] }, "agent_b": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "is_active": { "type": "boolean" }, "life_state": { "type": "string" } }, "additionalProperties": true, "required": [ "id", "name" ] }, "health": { "type": "object", "properties": { "status": { "type": "string" }, "issues": { "type": "array", "items": { "type": "object", "properties": { "agent_id": { "type": "string", "format": "uuid" }, "reason": { "type": "string" } }, "additionalProperties": true, "required": [ "agent_id", "reason" ] } } }, "additionalProperties": true, "required": [ "status", "issues" ] }, "is_enabled": { "type": "boolean" }, "messages_per_window": { "type": "integer" }, "window_hours": { "type": "integer" }, "feature_flag": { "type": [ "string", "null" ] }, "pair_key": { "type": "string" }, "created_by_user_id": { "type": [ "integer", "string", "null" ] }, "created_at": { "type": [ "string", "null" ] }, "updated_at": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "id", "agent_a", "agent_b", "is_enabled" ] }, "access": { "type": "object", "properties": { "admin_access": { "type": "boolean" }, "access_scope": { "type": "string" }, "operator_user_id": { "type": [ "integer", "string", "null" ] }, "target_user_id": { "type": [ "integer", "string", "null" ] }, "target_organization_id": { "type": [ "string", "null" ] }, "requested_user_id": { "type": [ "integer", "string", "null" ] }, "requested_organization_id": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "admin_access", "access_scope" ] } }, "additionalProperties": true, "required": [ "status", "link" ] }, "annotations": { "destructiveHint": true } }, { "name": "send_agent_message", "title": "Send Agent Message", "description": "Send an authenticated Decision Terrain MCP message to a persistent agent and optionally attach existing filespace files.", "inputSchema": { "type": "object", "properties": { "agent_id": { "type": "string", "format": "uuid", "description": "Persistent agent UUID." }, "body": { "type": "string", "description": "Message body sent to the agent." }, "attachment_file_paths": { "type": "array", "items": { "type": "string" }, "description": "Optional filespace paths such as /uploads/report.pdf to attach to the message." }, "attachments": { "type": "array", "maxItems": 10, "items": { "type": "object", "properties": { "path": { "type": "string", "description": "Destination filespace path, such as /uploads/report.pdf." }, "content_base64": { "type": "string", "description": "Base64-encoded file contents." }, "mime_type": { "type": "string", "default": "application/octet-stream" }, "overwrite": { "type": "boolean", "default": false } }, "required": [ "path", "content_base64" ], "additionalProperties": false }, "description": "Optional small files to upload and attach in this message call. Use this instead of a separate upload call when the content is already available." }, "trigger_processing": { "type": "boolean", "default": true, "description": "Whether to queue the agent to process the inbound message." }, "user_id": { "type": [ "integer", "string", "null" ], "description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." }, "organization_id": { "type": [ "string", "null" ], "format": "uuid", "description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." } }, "required": [ "agent_id", "body" ], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "status": { "type": "string" }, "accepted_state": { "type": "string" }, "message_id": { "type": "string", "format": "uuid" }, "agent_id": { "type": "string", "format": "uuid" }, "cursor": { "type": [ "string", "null" ] }, "latest_cursor": { "type": [ "string", "null" ] }, "created_at": { "type": [ "string", "null" ] }, "actor": { "type": "object", "properties": { "type": { "type": "string" }, "source": { "type": "string" }, "user_id": { "type": [ "integer", "string" ] } }, "additionalProperties": true, "required": [ "type", "source" ] }, "message": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "owner_agent_id": { "type": [ "string", "null" ] }, "conversation_id": { "type": [ "string", "null" ] }, "parent_id": { "type": [ "string", "null" ] }, "is_outbound": { "type": "boolean" }, "body": { "type": "string" }, "timestamp": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "id", "body" ] }, "timeline_event": { "type": "object", "properties": { "kind": { "type": "string" }, "cursor": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "kind" ] }, "conversation_id": { "type": "string", "format": "uuid" }, "attachment_count": { "type": "integer" }, "uploaded_attachments": { "type": "array", "items": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "ok", "pending_scan" ] }, "message": { "type": "string" }, "scan_status": { "type": "string" }, "available": { "type": "boolean" }, "path": { "type": "string" }, "node_id": { "type": "string", "format": "uuid" }, "filename": { "type": "string" }, "resource_uri": { "type": "string", "format": "uri" }, "mime_type": { "type": [ "string", "null" ] }, "size_bytes": { "type": [ "integer", "null" ] }, "checksum_sha256": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "status", "path", "node_id", "filename" ] } }, "access": { "type": "object", "properties": { "admin_access": { "type": "boolean" }, "access_scope": { "type": "string" }, "operator_user_id": { "type": [ "integer", "string", "null" ] }, "target_user_id": { "type": [ "integer", "string", "null" ] }, "target_organization_id": { "type": [ "string", "null" ] }, "requested_user_id": { "type": [ "integer", "string", "null" ] }, "requested_organization_id": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "admin_access", "access_scope" ] } }, "additionalProperties": true, "required": [ "status", "message_id", "agent_id", "cursor", "latest_cursor" ] } }, { "name": "get_agent_timeline", "title": "Get Agent Timeline", "description": "Fetch recent chat, task, thinking, and processing events for a persistent agent. Foreign or purged application history requires scoped REST request reads.", "inputSchema": { "type": "object", "properties": { "agent_id": { "type": "string", "format": "uuid", "description": "Persistent agent UUID." }, "after_cursor": { "type": [ "string", "null" ], "description": "Return events strictly newer than this durable timeline cursor. The event with this exact cursor is excluded." }, "cursor": { "type": [ "string", "null" ], "description": "Cursor from a previous timeline result." }, "direction": { "type": "string", "enum": [ "initial", "older", "newer" ], "default": "initial" }, "limit": { "type": "integer", "minimum": 1, "maximum": 100, "default": 40 }, "user_id": { "type": [ "integer", "string", "null" ], "description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." }, "organization_id": { "type": [ "string", "null" ], "format": "uuid", "description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." } }, "required": [ "agent_id" ], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "events": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string" }, "cursor": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "kind" ] } }, "next_cursor": { "type": [ "string", "null" ] }, "latest_cursor": { "type": [ "string", "null" ] }, "oldest_cursor": { "type": [ "string", "null" ] }, "newest_cursor": { "type": [ "string", "null" ] }, "has_more": { "type": "boolean" }, "has_more_older": { "type": "boolean" }, "has_more_newer": { "type": "boolean" }, "processing_active": { "type": "boolean" }, "processing_snapshot": { "type": "object", "properties": {}, "additionalProperties": true }, "access": { "type": "object", "properties": { "admin_access": { "type": "boolean" }, "access_scope": { "type": "string" }, "operator_user_id": { "type": [ "integer", "string", "null" ] }, "target_user_id": { "type": [ "integer", "string", "null" ] }, "target_organization_id": { "type": [ "string", "null" ] }, "requested_user_id": { "type": [ "integer", "string", "null" ] }, "requested_organization_id": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "admin_access", "access_scope" ] } }, "additionalProperties": true, "required": [ "events", "latest_cursor", "has_more" ] }, "annotations": { "readOnlyHint": true } }, { "name": "get_agent_debug_trace", "title": "Get Agent Debug Trace", "description": "Fetch bounded, sanitized debugging information for one accessible agent, including recent timeline/audit events, tool calls, completions, prompt archive metadata, usage/cost, eval artifacts, and diagnostics. Raw prompt archives and secret-like values are not returned. Foreign or purged application history requires scoped REST request reads.", "inputSchema": { "type": "object", "properties": { "agent_id": { "type": "string", "format": "uuid", "description": "Persistent agent UUID." }, "cursor": { "type": [ "string", "null" ], "description": "Optional audit/debug cursor returned as audit.next_cursor for older debug events." }, "limit": { "type": "integer", "minimum": 1, "maximum": 50, "default": 20, "description": "Maximum items per bounded debug section." }, "recent_minutes": { "type": [ "integer", "null" ], "minimum": 1, "maximum": 10080, "default": 60, "description": "Recent time window when no cursor or explicit since is supplied. Null disables the time window and relies on limit/cursor bounds." }, "since": { "type": [ "string", "null" ], "description": "Optional ISO8601 lower time bound. Cannot be combined with recent_minutes." }, "until": { "type": [ "string", "null" ], "description": "Optional ISO8601 upper time bound. Defaults to request time." }, "include": { "type": "array", "items": { "type": "string", "enum": [ "timeline", "audit_events", "completions", "eval_debug_artifacts", "diagnostics" ] }, "default": [ "timeline", "audit_events", "completions", "eval_debug_artifacts", "diagnostics" ], "description": "Optional debug sections to include." }, "detail": { "type": "string", "enum": [ "summary", "standard", "verbose" ], "default": "standard", "description": "Controls sanitized preview length; verbose still redacts secrets and omits raw prompts." }, "eval_run_id": { "type": [ "string", "null" ], "format": "uuid", "description": "Optional eval run UUID to filter eval debug artifacts for this agent." }, "user_id": { "type": [ "integer", "string", "null" ], "description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." }, "organization_id": { "type": [ "string", "null" ], "format": "uuid", "description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." } }, "required": [ "agent_id" ], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "agent": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "is_active": { "type": "boolean" }, "life_state": { "type": "string" } }, "additionalProperties": true, "required": [ "id", "name" ] }, "scope": { "type": "object", "properties": { "agent_id": { "type": "string", "format": "uuid" }, "requested_at": { "type": [ "string", "null" ] }, "since": { "type": [ "string", "null" ] }, "until": { "type": [ "string", "null" ] }, "recent_minutes": { "type": [ "integer", "null" ] }, "cursor": { "type": [ "string", "null" ] }, "limit": { "type": "integer" }, "include": { "type": "array", "items": { "type": "string" } }, "detail": { "type": "string" }, "eval_run_id": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "agent_id", "limit", "include", "detail" ] }, "timeline": { "type": "object", "properties": { "events": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string" }, "cursor": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "kind" ] } }, "latest_cursor": { "type": [ "string", "null" ] }, "oldest_cursor": { "type": [ "string", "null" ] }, "newest_cursor": { "type": [ "string", "null" ] }, "has_more_older": { "type": "boolean" }, "has_more_newer": { "type": "boolean" }, "processing_active": { "type": "boolean" }, "processing_snapshot": { "type": "object", "properties": {}, "additionalProperties": true } }, "additionalProperties": true }, "audit_events": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string" }, "id": { "type": [ "string", "null" ] }, "timestamp": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "kind" ] } }, "audit": { "type": "object", "properties": { "source": { "type": "string" }, "has_more": { "type": "boolean" }, "next_cursor": { "type": [ "string", "null" ] }, "returned": { "type": "integer" } }, "additionalProperties": true }, "completions": { "type": "object", "properties": {}, "additionalProperties": true }, "eval_debug_artifacts": { "type": "object", "properties": {}, "additionalProperties": true }, "diagnostics": { "type": "object", "properties": {}, "additionalProperties": true }, "redaction": { "type": "object", "properties": { "mode": { "type": "string" }, "replacement": { "type": "string" }, "notes": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": true, "required": [ "mode", "replacement" ] }, "warnings": { "type": "array", "items": { "type": "string" } }, "access": { "type": "object", "properties": { "admin_access": { "type": "boolean" }, "access_scope": { "type": "string" }, "operator_user_id": { "type": [ "integer", "string", "null" ] }, "target_user_id": { "type": [ "integer", "string", "null" ] }, "target_organization_id": { "type": [ "string", "null" ] }, "requested_user_id": { "type": [ "integer", "string", "null" ] }, "requested_organization_id": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "admin_access", "access_scope" ] } }, "additionalProperties": true, "required": [ "agent", "scope", "redaction", "warnings" ] }, "annotations": { "readOnlyHint": true } }, { "name": "wait_for_agent_event", "title": "Wait For Agent Timeline Event", "description": "Bounded long-poll over an agent's unified timeline using durable cursors and supported structured filters. Each snapshot rejects foreign or purged application history; use scoped REST request waits.", "inputSchema": { "type": "object", "properties": { "agent_id": { "type": "string", "format": "uuid", "description": "Persistent agent UUID." }, "after_cursor": { "type": [ "string", "null" ], "description": "Only consider timeline events strictly newer than this cursor. The event with this exact cursor is excluded, even when filters.message_id references it." }, "timeout_seconds": { "type": "integer", "minimum": 0, "maximum": 30, "default": 10 }, "limit": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 }, "event_types": { "type": "array", "items": { "type": "string", "enum": [ "message", "plan", "steps", "thinking" ] }, "description": "Optional event kinds to match." }, "filters": { "type": "object", "properties": { "from_actor_type": { "type": "string", "enum": [ "agent", "human_user", "external", "system" ], "description": "Actor source derived from the serialized timeline event: agent for outbound or peer messages, human_user for inbound web user messages, external for MCP and other inbound messages, and system for steps/thinking/plan events." }, "from_agent_id": { "type": "string", "format": "uuid", "description": "Source agent UUID for message events: the owner agent on non-peer outbound messages, or the peer agent on inbound peer messages." }, "to_agent_id": { "type": "string", "format": "uuid", "description": "Target agent UUID for message events: the owner agent on non-peer inbound messages, or the peer agent on outbound peer messages. Ordinary agent-to-human/external replies do not have a to_agent_id." }, "message_id": { "type": "string", "format": "uuid", "description": "Timeline message UUID. Cursor strictness still applies." }, "peer_link_id": { "type": "string", "format": "uuid", "description": "Peer-link UUID for peer message events." }, "channel": { "type": "string", "description": "Message channel from the serialized timeline event, such as mcp, web or email." }, "status": { "type": "string", "description": "Tool-call status for steps events." }, "tool_name": { "type": "string", "description": "Tool name for steps events." } }, "additionalProperties": false }, "user_id": { "type": [ "integer", "string", "null" ], "description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." }, "organization_id": { "type": [ "string", "null" ], "format": "uuid", "description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." } }, "required": [ "agent_id" ], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "matched": { "type": "boolean" }, "timed_out": { "type": "boolean" }, "events": { "type": "array", "items": { "type": "object", "properties": { "kind": { "type": "string" }, "cursor": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "kind" ] } }, "next_cursor": { "type": [ "string", "null" ] }, "latest_cursor": { "type": [ "string", "null" ] }, "waited_seconds": { "type": [ "number", "string" ] }, "access": { "type": "object", "properties": { "admin_access": { "type": "boolean" }, "access_scope": { "type": "string" }, "operator_user_id": { "type": [ "integer", "string", "null" ] }, "target_user_id": { "type": [ "integer", "string", "null" ] }, "target_organization_id": { "type": [ "string", "null" ] }, "requested_user_id": { "type": [ "integer", "string", "null" ] }, "requested_organization_id": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "admin_access", "access_scope" ] } }, "additionalProperties": true, "required": [ "matched", "timed_out", "events", "waited_seconds" ] }, "annotations": { "readOnlyHint": true } }, { "name": "read_agent_resource", "title": "Read Agent File", "description": "Read an authenticated file or image from a Decision Terrain resource URI returned by agent timeline or filespace tools. Content is returned as native MCP resource or image content.", "inputSchema": { "type": "object", "properties": { "uri": { "type": "string", "format": "uri", "description": "An agent:// resource URI returned by another Decision Terrain MCP tool." } }, "required": [ "uri" ], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "resource": { "type": "object", "properties": { "uri": { "type": "string", "format": "uri" }, "name": { "type": "string" }, "mime_type": { "type": "string" }, "size_bytes": { "type": "integer" }, "checksum_sha256": { "type": "string" } }, "additionalProperties": true, "required": [ "uri", "name", "mime_type", "size_bytes", "checksum_sha256" ] } }, "additionalProperties": true, "required": [ "resource" ] }, "annotations": { "readOnlyHint": true } }, { "name": "list_agent_files", "title": "List Agent Files", "description": "List files and folders in an agent's default filespace. Foreign or purged application history prevents broad filespace reads and attachment reuse.", "inputSchema": { "type": "object", "properties": { "agent_id": { "type": "string", "format": "uuid", "description": "Persistent agent UUID." }, "limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "cursor": { "type": "string" }, "user_id": { "type": [ "integer", "string", "null" ], "description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." }, "organization_id": { "type": [ "string", "null" ], "format": "uuid", "description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." } }, "required": [ "agent_id" ], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "filespace": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" } }, "additionalProperties": true, "required": [ "id", "name" ] }, "nodes": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "parent_id": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "path": { "type": "string" }, "node_type": { "type": "string" }, "size_bytes": { "type": [ "integer", "null" ] }, "mime_type": { "type": [ "string", "null" ] }, "checksum_sha256": { "type": [ "string", "null" ] }, "resource_uri": { "type": [ "string", "null" ], "format": "uri" }, "created_at": { "type": [ "string", "null" ] }, "updated_at": { "type": [ "string", "null" ] }, "scan_status": { "type": [ "string", "null" ] }, "available": { "type": [ "boolean", "null" ] }, "availability": { "type": [ "string", "null" ] }, "active_generation": { "type": [ "object", "null" ] }, "pending_generation": { "type": [ "object", "null" ] } }, "additionalProperties": true, "required": [ "id", "name", "path", "node_type" ] } }, "next_cursor": { "type": [ "string", "null" ] }, "access": { "type": "object", "properties": { "admin_access": { "type": "boolean" }, "access_scope": { "type": "string" }, "operator_user_id": { "type": [ "integer", "string", "null" ] }, "target_user_id": { "type": [ "integer", "string", "null" ] }, "target_organization_id": { "type": [ "string", "null" ] }, "requested_user_id": { "type": [ "integer", "string", "null" ] }, "requested_organization_id": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "admin_access", "access_scope" ] } }, "additionalProperties": true, "required": [ "filespace", "nodes" ] }, "annotations": { "readOnlyHint": true } }, { "name": "upload_agent_file", "title": "Upload Agent File", "description": "Upload a small base64-encoded file into an agent's filespace for later use or message attachment.", "inputSchema": { "type": "object", "properties": { "agent_id": { "type": "string", "format": "uuid", "description": "Persistent agent UUID." }, "path": { "type": "string", "description": "Filespace path where the file should be stored, e.g. /uploads/report.txt." }, "content_base64": { "type": "string", "description": "Base64-encoded file content." }, "mime_type": { "type": "string", "default": "application/octet-stream" }, "overwrite": { "type": "boolean", "default": false }, "user_id": { "type": [ "integer", "string", "null" ], "description": "Optional target Django user id. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." }, "organization_id": { "type": [ "string", "null" ], "format": "uuid", "description": "Optional target organization UUID. Staff/superuser API keys only; ordinary API keys receive a structured tool error when this is supplied." } }, "required": [ "agent_id", "path", "content_base64" ], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "ok", "pending_scan" ] }, "message": { "type": [ "string", "null" ] }, "scan_status": { "type": "string" }, "available": { "type": "boolean" }, "path": { "type": "string" }, "node_id": { "type": "string", "format": "uuid" }, "filename": { "type": "string" }, "resource_uri": { "type": "string", "format": "uri" }, "mime_type": { "type": [ "string", "null" ] }, "size_bytes": { "type": [ "integer", "null" ] }, "checksum_sha256": { "type": [ "string", "null" ] }, "access": { "type": "object", "properties": { "admin_access": { "type": "boolean" }, "access_scope": { "type": "string" }, "operator_user_id": { "type": [ "integer", "string", "null" ] }, "target_user_id": { "type": [ "integer", "string", "null" ] }, "target_organization_id": { "type": [ "string", "null" ] }, "requested_user_id": { "type": [ "integer", "string", "null" ] }, "requested_organization_id": { "type": [ "string", "null" ] } }, "additionalProperties": true, "required": [ "admin_access", "access_scope" ] } }, "additionalProperties": true, "required": [ "status" ] } }, { "name": "list_organizations", "title": "List Organizations", "description": "Discover active Organization memberships. Personal keys discover metadata only; use an Organization key to operate that Organization.", "inputSchema": { "type": "object", "properties": { "page": { "type": "integer", "minimum": 1, "maximum": 10000, "default": 1 }, "page_size": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, "required": [], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "status": { "type": "string", "description": "Control completion or action-required state; integration reads use their publication status." }, "code": { "type": "string" }, "request_id": { "type": "string", "format": "uuid" }, "action": { "type": "object" } }, "additionalProperties": true }, "annotations": { "readOnlyHint": true, "idempotentHint": true } }, { "name": "list_workspaces", "title": "List Workspaces", "description": "List this key's personal or Organization-private workspace and accessible active Teams, with creation and management permissions.", "inputSchema": { "type": "object", "properties": { "page": { "type": "integer", "minimum": 1, "maximum": 10000, "default": 1 }, "page_size": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, "required": [], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "status": { "type": "string", "description": "Control completion or action-required state; integration reads use their publication status." }, "code": { "type": "string" }, "request_id": { "type": "string", "format": "uuid" }, "action": { "type": "object" } }, "additionalProperties": true }, "annotations": { "readOnlyHint": true, "idempotentHint": true } }, { "name": "list_workspace_members", "title": "List Workspace Members", "description": "Page Team memberships, or Organization membership when authorized to manage people or agents. Omit team_id for Organization membership.", "inputSchema": { "type": "object", "properties": { "page": { "type": "integer", "minimum": 1, "maximum": 10000, "default": 1 }, "page_size": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 }, "team_id": { "type": "string", "format": "uuid" } }, "required": [], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "status": { "type": "string", "description": "Control completion or action-required state; integration reads use their publication status." }, "code": { "type": "string" }, "request_id": { "type": "string", "format": "uuid" }, "action": { "type": "object" } }, "additionalProperties": true }, "annotations": { "readOnlyHint": true, "idempotentHint": true } }, { "name": "create_team", "title": "Create Team", "description": "Create an Organization Team using the normal Team service. Requires Organization agent administration and exact-request browser approval.", "inputSchema": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 200 }, "request_id": { "type": "string", "format": "uuid", "description": "Client-generated UUID. Reuse with identical arguments to resume approval or replay a completed mutation; never reuse for different input." } }, "required": [ "name", "request_id" ], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "status": { "type": "string", "description": "Control completion or action-required state; integration reads use their publication status." }, "code": { "type": "string" }, "request_id": { "type": "string", "format": "uuid" }, "action": { "type": "object" } }, "additionalProperties": true }, "annotations": { "readOnlyHint": false, "idempotentHint": true } }, { "name": "update_team", "title": "Update Team", "description": "Rename or change Team availability. Availability changes require Organization agent administration. Requires exact-request browser approval.", "inputSchema": { "type": "object", "properties": { "team_id": { "type": "string", "format": "uuid" }, "name": { "type": "string", "minLength": 1, "maxLength": 200 }, "is_active": { "type": "boolean" }, "request_id": { "type": "string", "format": "uuid", "description": "Client-generated UUID. Reuse with identical arguments to resume approval or replay a completed mutation; never reuse for different input." } }, "required": [ "team_id", "request_id" ], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "status": { "type": "string", "description": "Control completion or action-required state; integration reads use their publication status." }, "code": { "type": "string" }, "request_id": { "type": "string", "format": "uuid" }, "action": { "type": "object" } }, "additionalProperties": true }, "annotations": { "readOnlyHint": false, "idempotentHint": true } }, { "name": "set_team_member", "title": "Set Team Member", "description": "Add, update or remove an active Organization member's Team assignment. Requires Team administration and exact-request browser approval.", "inputSchema": { "type": "object", "properties": { "team_id": { "type": "string", "format": "uuid" }, "organization_membership_id": { "anyOf": [ { "type": "integer", "minimum": 1 }, { "type": "string", "pattern": "^[1-9][0-9]*$" } ] }, "role": { "type": "string", "enum": [ "admin", "member", "viewer" ] }, "active": { "type": "boolean" }, "request_id": { "type": "string", "format": "uuid", "description": "Client-generated UUID. Reuse with identical arguments to resume approval or replay a completed mutation; never reuse for different input." } }, "required": [ "team_id", "organization_membership_id", "active", "request_id" ], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "status": { "type": "string", "description": "Control completion or action-required state; integration reads use their publication status." }, "code": { "type": "string" }, "request_id": { "type": "string", "format": "uuid" }, "action": { "type": "object" } }, "additionalProperties": true }, "annotations": { "readOnlyHint": false, "idempotentHint": true } }, { "name": "move_agent", "title": "Move Agent", "description": "Move an agent within this key's ownership boundary using console workspace restrictions; Team-to-private moves remain disabled.", "inputSchema": { "type": "object", "properties": { "agent_id": { "type": "string", "format": "uuid" }, "workspace_type": { "type": "string", "enum": [ "personal", "organization_private", "team" ] }, "team_id": { "type": "string", "format": "uuid" }, "request_id": { "type": "string", "format": "uuid", "description": "Client-generated UUID. Reuse with identical arguments to resume approval or replay a completed mutation; never reuse for different input." } }, "required": [ "agent_id", "workspace_type", "request_id" ], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "status": { "type": "string", "description": "Control completion or action-required state; integration reads use their publication status." }, "code": { "type": "string" }, "request_id": { "type": "string", "format": "uuid" }, "action": { "type": "object" } }, "additionalProperties": true }, "annotations": { "readOnlyHint": false, "idempotentHint": true } }, { "name": "list_integrations", "title": "List Integrations", "description": "Discover native provider capabilities or Organization OpenAPI integrations. Supply agent_id for effective native connections and assignments. No credentials are returned.", "inputSchema": { "type": "object", "properties": { "page": { "type": "integer", "minimum": 1, "maximum": 10000, "default": 1 }, "page_size": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 }, "kind": { "type": "string", "enum": [ "native", "openapi" ] }, "agent_id": { "type": "string", "format": "uuid" } }, "required": [ "kind" ], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "status": { "type": "string", "description": "Control completion or action-required state; integration reads use their publication status." }, "code": { "type": "string" }, "request_id": { "type": "string", "format": "uuid" }, "action": { "type": "object" } }, "additionalProperties": true }, "annotations": { "readOnlyHint": true, "idempotentHint": true } }, { "name": "get_integration", "title": "Get Integration", "description": "Inspect native capabilities or a paged OpenAPI revision's operations and supported configuration, including secret-entry handoff.", "inputSchema": { "type": "object", "properties": { "page": { "type": "integer", "minimum": 1, "maximum": 10000, "default": 1 }, "page_size": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 }, "kind": { "type": "string", "enum": [ "native", "openapi" ] }, "integration_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "agent_id": { "type": "string", "format": "uuid" }, "revision_id": { "type": "string", "format": "uuid" } }, "required": [ "kind", "integration_id" ], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "status": { "type": "string", "description": "Control completion or action-required state; integration reads use their publication status." }, "code": { "type": "string" }, "request_id": { "type": "string", "format": "uuid" }, "action": { "type": "object" } }, "additionalProperties": true }, "annotations": { "readOnlyHint": true, "idempotentHint": true } }, { "name": "configure_openapi_integration", "title": "Configure Openapi Integration", "description": "Create/update configuration, import a bundled specification, configure draft operations, publish a revision, or enable/disable an integration. Secrets and external specification URLs are not accepted. Inspect get_integration for revisions and operations.", "inputSchema": { "type": "object", "properties": { "action": { "type": "string", "enum": [ "create", "update", "import", "operations", "publish", "enable", "disable" ] }, "integration_id": { "type": "string", "format": "uuid" }, "slug": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]{0,63}$" }, "configuration": { "type": "object", "properties": { "display_name": { "type": "string", "minLength": 1, "maxLength": 200 }, "description": { "type": "string", "maxLength": 2000 }, "base_url": { "type": "string", "maxLength": 2048 }, "auth_scheme": { "type": "string", "enum": [ "none", "api_key_header", "api_key_query", "bearer", "basic", "oauth_authorization_code", "oauth_client_credentials" ] }, "auth_parameter_name": { "type": "string", "maxLength": 128 }, "oauth_authorization_url": { "type": "string", "maxLength": 2048 }, "oauth_token_url": { "type": "string", "maxLength": 2048 }, "oauth_scopes": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "maxItems": 100, "uniqueItems": true }, "oauth_client_id": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [], "additionalProperties": false }, "spec": { "type": "string", "minLength": 1, "maxLength": 1000000, "description": "Bundled OpenAPI 3.x JSON/YAML without credentials or private material." }, "revision_id": { "type": "string", "format": "uuid" }, "operations": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "selected": { "type": "boolean" }, "tool_name": { "type": "string", "minLength": 1, "maxLength": 200 }, "description": { "type": "string", "maxLength": 2000 }, "policy": { "type": "string", "enum": [ "read", "autonomous", "approval" ] }, "redaction_paths": { "type": "array", "items": { "type": "string", "maxLength": 2000 }, "maxItems": 100, "uniqueItems": true } }, "required": [ "id" ], "additionalProperties": false }, "maxItems": 100, "uniqueItems": true }, "request_id": { "type": "string", "format": "uuid", "description": "Client-generated UUID. Reuse with identical arguments to resume approval or replay a completed mutation; never reuse for different input." } }, "required": [ "action", "request_id" ], "additionalProperties": false, "allOf": [ { "if": { "properties": { "action": { "const": "create" } } }, "then": { "required": [ "configuration", "slug", "spec" ] } }, { "if": { "properties": { "action": { "const": "update" } } }, "then": { "required": [ "integration_id", "configuration" ] } }, { "if": { "properties": { "action": { "const": "import" } } }, "then": { "required": [ "integration_id", "spec" ] } }, { "if": { "properties": { "action": { "const": "operations" } } }, "then": { "required": [ "integration_id", "revision_id", "operations" ] } }, { "if": { "properties": { "action": { "const": "publish" } } }, "then": { "required": [ "integration_id", "revision_id" ] } }, { "if": { "properties": { "action": { "const": "enable" } } }, "then": { "required": [ "integration_id" ] } }, { "if": { "properties": { "action": { "const": "disable" } } }, "then": { "required": [ "integration_id" ] } } ] }, "outputSchema": { "type": "object", "properties": { "status": { "type": "string", "description": "Control completion or action-required state; integration reads use their publication status." }, "code": { "type": "string" }, "request_id": { "type": "string", "format": "uuid" }, "action": { "type": "object" } }, "additionalProperties": true }, "annotations": { "readOnlyHint": false, "idempotentHint": true } }, { "name": "set_agent_integration", "title": "Set Agent Integration", "description": "Bind/unbind an OpenAPI integration and existing credential, or enable/disable a native system skill using the agent's inherited connection. Native connection IDs cannot retarget credential ownership. Agent-scoped email authentication uses the browser setup flow.", "inputSchema": { "type": "object", "properties": { "agent_id": { "type": "string", "format": "uuid" }, "kind": { "type": "string", "enum": [ "native", "openapi" ] }, "integration_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "enabled": { "type": "boolean" }, "credential_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "approver_ids": { "type": "array", "items": { "type": "integer", "minimum": 1 }, "maxItems": 100, "uniqueItems": true }, "request_id": { "type": "string", "format": "uuid", "description": "Client-generated UUID. Reuse with identical arguments to resume approval or replay a completed mutation; never reuse for different input." } }, "required": [ "agent_id", "kind", "integration_id", "enabled", "request_id" ], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "status": { "type": "string", "description": "Control completion or action-required state; integration reads use their publication status." }, "code": { "type": "string" }, "request_id": { "type": "string", "format": "uuid" }, "action": { "type": "object" } }, "additionalProperties": true }, "annotations": { "readOnlyHint": false, "idempotentHint": true } }, { "name": "list_credentials", "title": "List Credentials", "description": "Page authorized credential metadata. Use agent_id for inherited/global and agent secrets; integration_id for OpenAPI credentials and grants. Secret values, OAuth tokens, and certificate material are never returned.", "inputSchema": { "type": "object", "properties": { "page": { "type": "integer", "minimum": 1, "maximum": 10000, "default": 1 }, "page_size": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 }, "agent_id": { "type": "string", "format": "uuid" }, "integration_id": { "type": "string", "format": "uuid" } }, "required": [], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "status": { "type": "string", "description": "Control completion or action-required state; integration reads use their publication status." }, "code": { "type": "string" }, "request_id": { "type": "string", "format": "uuid" }, "action": { "type": "object" } }, "additionalProperties": true }, "annotations": { "readOnlyHint": true, "idempotentHint": true } }, { "name": "set_credential_grant", "title": "Set Credential Grant", "description": "Grant/revoke one agent's access to a member-owned OpenAPI credential. Only the credential owner may change grants. Revocation removes active bindings through the normal service.", "inputSchema": { "type": "object", "properties": { "integration_id": { "type": "string", "format": "uuid" }, "credential_id": { "type": "string", "format": "uuid" }, "agent_id": { "type": "string", "format": "uuid" }, "active": { "type": "boolean" }, "request_id": { "type": "string", "format": "uuid", "description": "Client-generated UUID. Reuse with identical arguments to resume approval or replay a completed mutation; never reuse for different input." } }, "required": [ "integration_id", "credential_id", "agent_id", "active", "request_id" ], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "status": { "type": "string", "description": "Control completion or action-required state; integration reads use their publication status." }, "code": { "type": "string" }, "request_id": { "type": "string", "format": "uuid" }, "action": { "type": "object" } }, "additionalProperties": true }, "annotations": { "readOnlyHint": false, "idempotentHint": true } }, { "name": "list_machine_identities", "title": "List Machine Identities", "description": "Page Organization identity, destination, or grant metadata. Requires machine-identity viewing authority. Certificate material is excluded; connection health retains its actual process source.", "inputSchema": { "type": "object", "properties": { "page": { "type": "integer", "minimum": 1, "maximum": 10000, "default": 1 }, "page_size": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 }, "section": { "type": "string", "enum": [ "identities", "destinations", "grants" ] }, "agent_id": { "type": "string", "format": "uuid" } }, "required": [ "section" ], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "status": { "type": "string", "description": "Control completion or action-required state; integration reads use their publication status." }, "code": { "type": "string" }, "request_id": { "type": "string", "format": "uuid" }, "action": { "type": "object" } }, "additionalProperties": true }, "annotations": { "readOnlyHint": true, "idempotentHint": true } }, { "name": "configure_machine_identity_destination", "title": "Configure Machine Identity Destination", "description": "Create/update destination policy for an existing Organization. Requires machine-identity administration and browser approval. Custom CA imports use browser setup; no network requests or infrastructure changes are performed.", "inputSchema": { "type": "object", "properties": { "destination_id": { "type": "string", "format": "uuid" }, "configuration": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1, "maxLength": 200 }, "hostname_pattern": { "type": "string", "minLength": 1, "maxLength": 200 }, "port": { "type": "integer", "minimum": 1, "maximum": 65535 }, "network_mode": { "type": "string", "enum": [ "public", "private" ] }, "private_cidrs": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "maxItems": 100, "uniqueItems": true }, "is_active": { "type": "boolean" } }, "required": [], "additionalProperties": false }, "request_id": { "type": "string", "format": "uuid", "description": "Client-generated UUID. Reuse with identical arguments to resume approval or replay a completed mutation; never reuse for different input." } }, "required": [ "configuration", "request_id" ], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "status": { "type": "string", "description": "Control completion or action-required state; integration reads use their publication status." }, "code": { "type": "string" }, "request_id": { "type": "string", "format": "uuid" }, "action": { "type": "object" } }, "additionalProperties": true }, "annotations": { "readOnlyHint": false, "idempotentHint": true } }, { "name": "set_machine_identity_grant", "title": "Set Machine Identity Grant", "description": "Grant or revoke an agent's access to a provisioned identity and destination through normal method/path restrictions and audit. Requires machine-identity administration and browser approval.", "inputSchema": { "type": "object", "properties": { "agent_id": { "type": "string", "format": "uuid" }, "identity_id": { "type": "string", "format": "uuid" }, "destination_id": { "type": "string", "format": "uuid" }, "grant_id": { "type": "string", "format": "uuid" }, "active": { "type": "boolean" }, "allowed_methods": { "type": "array", "items": { "type": "string", "enum": [ "GET", "HEAD", "POST", "PUT", "PATCH", "DELETE", "OPTIONS" ] }, "maxItems": 7, "uniqueItems": true }, "path_prefixes": { "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 200 }, "maxItems": 100, "uniqueItems": true }, "request_id": { "type": "string", "format": "uuid", "description": "Client-generated UUID. Reuse with identical arguments to resume approval or replay a completed mutation; never reuse for different input." } }, "required": [ "agent_id", "active", "request_id" ], "additionalProperties": false, "allOf": [ { "if": { "properties": { "active": { "const": true } } }, "then": { "required": [ "identity_id", "destination_id", "allowed_methods", "path_prefixes" ] }, "else": { "required": [ "grant_id" ] } } ] }, "outputSchema": { "type": "object", "properties": { "status": { "type": "string", "description": "Control completion or action-required state; integration reads use their publication status." }, "code": { "type": "string" }, "request_id": { "type": "string", "format": "uuid" }, "action": { "type": "object" } }, "additionalProperties": true }, "annotations": { "readOnlyHint": false, "idempotentHint": true } }, { "name": "get_integration_setup", "title": "Get Integration Setup", "description": "Return a supported human setup handoff and a machine-readable pending status. Open the authenticated console to enter credentials, import certificates, or complete provider OAuth; then re-inspect through MCP.", "inputSchema": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "native", "openapi", "secret", "machine_identity" ] }, "integration_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "agent_id": { "type": "string", "format": "uuid" } }, "required": [ "kind" ], "additionalProperties": false }, "outputSchema": { "type": "object", "properties": { "status": { "type": "string", "description": "Control completion or action-required state; integration reads use their publication status." }, "code": { "type": "string" }, "request_id": { "type": "string", "format": "uuid" }, "action": { "type": "object" } }, "additionalProperties": true }, "annotations": { "readOnlyHint": true, "idempotentHint": true } }, { "name": "get_agent_readiness", "title": "Get Agent Readiness", "description": "Bounded read-only preflight for agent configuration and optionally one integration or published OpenAPI operation. Checks durable state, never probes URLs or claims worker reachability. unknown means untested, not ready.", "inputSchema": { "type": "object", "properties": { "agent_id": { "type": "string", "format": "uuid" }, "kind": { "type": "string", "enum": [ "native", "openapi" ] }, "integration_id": { "type": "string", "minLength": 1, "maxLength": 200 }, "operation_id": { "type": "string", "format": "uuid" }, "capability": { "type": "string", "minLength": 1, "maxLength": 200 } }, "required": [ "agent_id" ], "additionalProperties": false }, "outputSchema": { "type": "object", "required": [ "status", "checks", "execution_tested" ], "properties": { "status": { "type": "string", "enum": [ "ready", "blocked", "action_required", "unknown" ] }, "execution_tested": { "const": false }, "configuration_ready": { "type": [ "boolean", "null" ] }, "checks": { "type": "array", "maxItems": 30, "items": { "type": "object", "required": [ "check", "status", "code", "next_step", "details" ], "properties": { "check": { "type": "string", "maxLength": 2000 }, "status": { "type": "string", "enum": [ "ready", "blocked", "action_required", "unknown" ] }, "code": { "type": "string", "maxLength": 2000 }, "next_step": { "type": "string", "maxLength": 2000 }, "details": { "type": "object" } } } } } }, "annotations": { "readOnlyHint": true, "idempotentHint": true } } ], "serviceCredentialPolicy": { "requiresInstallationAndOrganizationEnablement": true, "allowedTools": { "list_agents": "agents:read", "get_agent": "agents:read", "list_agent_files": "agents:read", "read_agent_resource": "agents:read", "list_agent_links": "agents:read", "update_agent": "agents:manage", "archive_agent": "agents:manage", "link_agents": "agents:manage", "unlink_agents": "agents:manage", "upload_agent_file": "agents:operate" } }, "admissionPolicy": { "requiresDeploymentEnablement": true, "namespaces": [ "member-user-or-service-identity", "effective-owner" ], "httpQuotaIncludesAcceptedReplay": true, "queuedInputTools": [ "send_agent_message" ], "waitTools": [ "wait_for_agent_event" ], "controlExemptTools": [ "archive_agent" ], "errors": { "429": [ "request_quota_exceeded", "wait_capacity_exceeded" ], "503": [ "admission_unavailable", "work_capacity_exceeded" ] }, "retryHeader": "Retry-After" } }