---
title: "[Dummy] Tool response type export for codegen"
method: GET
path: "/api/chat/schema/tool-responses"
tags: ["v2", "chat", "chat"]
---

# [Dummy] Tool response type export for codegen

`GET /api/chat/schema/tool-responses`

This endpoint is not meant to be called. It exists solely to expose tool response models in the OpenAPI schema for frontend codegen.

## Response `200`

Successful Response

- union
  - AgentsFoundResponse — Response for find_agent tool.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `title` string
    - `agents` AgentInfo[], required
      - `id` string, required
      - `name` string, required
      - `description` string, required
      - `source` string, required — marketplace or library
      - `in_library` boolean
      - `creator` string, nullable
      - `category` string, nullable
      - `rating` number, nullable
      - `runs` integer, nullable
      - `is_featured` boolean, nullable
      - `status` string, nullable
      - `can_access_graph` boolean, nullable
      - `has_external_trigger` boolean, nullable
      - `new_output` boolean, nullable
      - `graph_id` string, nullable
      - `graph_version` integer, nullable
      - `match_score` number, nullable — Combined relevance score in [0, 1] when this agent was returned from a similarity search (e.g. the create-time library check). Null for non-similarity sources.
      - `input_schema` object, nullable — JSON Schema for the agent's inputs (for AgentExecutorBlock)
      - `output_schema` object, nullable — JSON Schema for the agent's outputs (for AgentExecutorBlock)
      - `inputs` object, nullable — Input schema for the agent, including field names, types, and defaults
      - `graph` BaseGraphOutput — Graph with nodes, links, and computed I/O schema fields. Used to represent sub-graphs within a `Graph`. Contains the full graph structure including nodes and links, plus computed fields for schemas and trigger info. Does NOT include user_id or created_at (see GraphModel).
        - `id` string
        - `version` integer
        - `is_active` boolean
        - `name` string, required
        - `description` string, required
        - `instructions` string, nullable
        - `recommended_schedule_cron` string, nullable
        - `forked_from_id` string, nullable
        - `forked_from_version` integer, nullable
        - `nodes` Node[]
          - `id` string
          - `block_id` string, required
          - `input_default` object
          - `metadata` object
          - `input_links` Link[]
            - `id` string
            - `source_id` string, required
            - `sink_id` string, required
            - `source_name` string, required
            - `sink_name` string, required
            - `is_static` boolean
          - `output_links` Link[]
            - `id` string
            - `source_id` string, required
            - `sink_id` string, required
            - `source_name` string, required
            - `sink_name` string, required
            - `is_static` boolean
        - `links` Link[]
          - `id` string
          - `source_id` string, required
          - `sink_id` string, required
          - `source_name` string, required
          - `sink_name` string, required
          - `is_static` boolean
        - `input_schema` object, required
        - `output_schema` object, required
        - `has_external_trigger` boolean, required
        - `has_human_in_the_loop` boolean, required
        - `has_sensitive_action` boolean, required
        - `trigger_setup_info` GraphTriggerInfo, required
          - `provider` string, required — Provider name for integrations. Can be any string value, including custom provider names.
          - `config_schema` object, required — Input schema for the trigger block
          - `credentials_input_name` string, nullable, required
      - `trigger_info` GraphTriggerInfo
        - `provider` string, required — Provider name for integrations. Can be any string value, including custom provider names.
        - `config_schema` object, required — Input schema for the trigger block
        - `credentials_input_name` string, nullable, required
    - `count` integer, required
    - `name` string
  - NoResultsResponse — Response when no agents found.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `suggestions` string[]
    - `name` string
  - AgentDetailsResponse — Response for get_details action.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `agent` AgentDetails, required — Detailed agent information.
      - `id` string, required
      - `name` string, required
      - `description` string, required
      - `in_library` boolean
      - `inputs` object
      - `credentials` CredentialsMetaInput[]
        - `id` string, required
        - `title` string, nullable
        - `provider` string, required — Provider name for integrations. Can be any string value, including custom provider names.
        - `type` 'api_key' | 'oauth2' | 'user_password' | 'host_scoped', required
      - `execution_options` ExecutionOptions — Available execution options for an agent.
        - `manual` boolean
        - `scheduled` boolean
        - `webhook` boolean
      - `trigger_info` GraphTriggerInfo
        - `provider` string, required — Provider name for integrations. Can be any string value, including custom provider names.
        - `config_schema` object, required — Input schema for the trigger block
        - `credentials_input_name` string, nullable, required
    - `user_authenticated` boolean
    - `graph_id` string, nullable
    - `graph_version` integer, nullable
  - SetupRequirementsResponse — Response for validate action.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `setup_info` SetupInfo, required — Complete setup information.
      - `agent_id` string, required
      - `agent_name` string, required
      - `requirements` object
      - `user_readiness` UserReadiness — User readiness status.
        - `has_all_credentials` boolean
        - `missing_credentials` object
        - `ready_to_run` boolean
    - `graph_id` string, nullable
    - `graph_version` integer, nullable
  - ExecutionStartedResponse — Response for run/schedule actions.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `execution_id` string, required
    - `graph_id` string, required
    - `graph_name` string, required
    - `library_agent_id` string, nullable
    - `library_agent_link` string, nullable
    - `status` string
    - `saved_preset_id` string, nullable
  - NeedLoginResponse — Response when login is needed.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `agent_info` object, nullable
  - ErrorResponse — Response for errors.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `execution_id` string, nullable
    - `error` string, nullable
    - `details` object, nullable
  - InputValidationErrorResponse — Response when run_agent receives unknown input fields.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `unrecognized_fields` string[], required — List of input field names that were not recognized
    - `inputs` object, required — The agent's valid input schema for reference
    - `graph_id` string, nullable
    - `graph_version` integer, nullable
  - AgentOutputResponse — Response for agent_output tool.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `agent_name` string, required
    - `agent_id` string, required
    - `library_agent_id` string, nullable
    - `library_agent_link` string, nullable
    - `execution` ExecutionOutputInfo — Summary of a single execution's outputs.
      - `execution_id` string, required
      - `status` string, required
      - `started_at` string, date-time, nullable
      - `ended_at` string, date-time, nullable
      - `outputs` object, required
      - `inputs_summary` object, nullable
      - `node_executions` object[], nullable
      - `nodes_failed` NodeFailureSummary[], nullable
        - `node_id` string, required
        - `block_name` string, required
        - `error` string, nullable, required
    - `available_executions` object[], nullable
    - `total_executions` integer
  - UnderstandingUpdatedResponse — Response for add_understanding tool.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `updated_fields` string[]
    - `current_understanding` object
  - AgentPreviewResponse — Response for previewing a generated agent before saving.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `agent_json` object, required
    - `agent_name` string, required
    - `description` string, required
    - `node_count` integer, required
    - `link_count` integer
  - AgentSavedResponse — Response when an agent is saved to the library.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `agent_id` string, required
    - `agent_name` string, required
    - `graph_version` integer, nullable
    - `library_agent_id` string, required
    - `library_agent_link` string, required
    - `agent_page_link` string, required
  - ClarificationNeededResponse — Response when the LLM needs more information from the user.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `questions` ClarifyingQuestion[]
      - `question` string, required
      - `keyword` string, required
      - `example` string, nullable
  - SuggestedGoalResponse — Response when the goal needs refinement with a suggested alternative.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `suggested_goal` string, required — The suggested alternative goal
    - `reason` string — Why the original goal needs refinement
    - `original_goal` string — The user's original goal for context
    - `goal_type` 'vague' | 'unachievable' — Type: 'vague' or 'unachievable'
  - BlockListResponse — Response for find_block tool.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `blocks` BlockInfoSummary[], required
      - `id` string, required
      - `name` string, required
      - `description` string, required
      - `categories` string[], required
      - `input_schema` object — Full JSON schema for block inputs
      - `output_schema` object — Full JSON schema for block outputs
      - `static_output` boolean — Whether the block produces output without needing input
      - `required_inputs` BlockInputFieldInfo[] — List of input fields for this block
        - `name` string, required
        - `type` string, required
        - `description` string
        - `required` boolean
        - `default` unknown
    - `count` integer, required
    - `query` string, required
    - `usage_hint` string
  - BlockDetailsResponse — Response for block details (first run_block attempt).
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `block` BlockDetails, required — Detailed block information.
      - `id` string, required
      - `name` string, required
      - `description` string, required
      - `inputs` object
      - `outputs` object
      - `credentials` CredentialsMetaInput[]
        - `id` string, required
        - `title` string, nullable
        - `provider` string, required — Provider name for integrations. Can be any string value, including custom provider names.
        - `type` 'api_key' | 'oauth2' | 'user_password' | 'host_scoped', required
    - `user_authenticated` boolean
  - BlockOutputResponse — Response for run_block tool.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `block_id` string, required
    - `block_name` string, required
    - `outputs` object, required
    - `success` boolean
    - `is_dry_run` boolean, nullable
  - DocSearchResultsResponse — Response for search_docs tool.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `results` DocSearchResult[], required
      - `title` string, required
      - `path` string, required
      - `section` string, required
      - `snippet` string, required
      - `score` number, required
      - `doc_url` string, nullable
    - `count` integer, required
    - `query` string, required
  - DocPageResponse — Response for get_doc_page tool.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `title` string, required
    - `path` string, required
    - `content` string, required
    - `doc_url` string, nullable
  - MCPToolsDiscoveredResponse — Response when MCP tools are discovered from a server (agent-internal).
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `server_url` string, required
    - `tools` MCPToolInfo[], required
      - `name` string, required
      - `description` string, required
      - `params` string, nullable — Compact argument summary: top-level input field names, required ones marked with *.
      - `input_schema` object, nullable — Full input schema. Omitted in discovery responses to keep them small; the execution error path returns the failed tool's full schema on demand.
  - MCPToolOutputResponse — Response after executing an MCP tool.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `server_url` string, required
    - `tool_name` string, required
    - `result` unknown
    - `success` boolean
  - TaskDecompositionResponse — Response for decompose_goal tool — shows the plan to the user.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `goal` string, required — The original user goal
    - `steps` DecompositionStepModel[], required
      - `step_id` string, required — Unique step identifier, e.g. 'step_1'
      - `description` string, required — Plain-English description of what this step does for the user. Do not put block class names or wiring verbs here — block_name and action carry that technical detail.
      - `action` string, required — Action type: 'add_block', 'connect_blocks', 'configure', etc.
      - `block_name` string, nullable — Block being added, if applicable
      - `status` string — Step status: pending, in_progress, completed, failed
    - `step_count` integer — Number of steps (auto-derived from steps list)
  - ScheduleListResponse — Response containing a list of schedules.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `schedules` ScheduleSummary[], required
      - `schedule_id` string, required
      - `kind` 'graph' | 'copilot_turn', required
      - `name` string, required
      - `timezone` string, required
      - `next_run_time` string, required
      - `cron` string, nullable
      - `run_at` string, nullable
      - `graph_id` string, nullable
      - `graph_version` integer, nullable
      - `session_id` string, nullable
      - `message` string, nullable
  - ScheduleDeletedResponse — Response confirming a schedule was deleted.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `schedule_id` string, required
  - PresetListResponse — Response listing the user's presets.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `presets` PresetSummary[], required
      - `id` string, required
      - `name` string, required
      - `description` string
      - `graph_id` string, required
      - `graph_version` integer, required
      - `is_active` boolean, required
      - `webhook_id` string, nullable
      - `webhook_url` string, nullable
      - `provider` string, nullable
    - `total_count` integer, required
  - PresetUpdatedResponse — Response confirming a preset was updated.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `preset_id` string, required
    - `name` string, required
    - `is_active` boolean, required
    - `webhook_url` string, nullable
  - PresetDeletedResponse — Response confirming a preset was deleted.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `preset_id` string, required
    - `name` string, required
  - MemoryStoreResponse — Response when a memory is stored.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `memory_name` string, required
  - MemorySearchResponse — Response when memories are searched.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `facts` string[]
    - `recent_episodes` string[]
  - MemoryForgetCandidatesResponse — Response with candidate memories to forget.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `candidates` object[]
  - MemoryForgetConfirmResponse — Response after deleting specific memory edges.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `deleted_uuids` string[]
    - `failed_uuids` string[]
  - TodoWriteResponse — Ack returned by ``TodoWrite``. The tool is effectively stateless — the authoritative task list lives in the assistant's latest tool-call arguments, which are replayed from the transcript on each turn. The tool output only needs to confirm that the update was accepted so the model can proceed.
    - `type` 'error' | 'no_results' | 'need_login' | 'agents_found' | 'agent_details' | 'setup_requirements' | 'input_validation_error' | 'execution_started' | 'agent_output' | 'understanding_updated' | 'suggested_goal' | 'agent_builder_guide' | 'agent_builder_preview' | 'agent_builder_saved' | 'agent_builder_clarification_needed' | 'agent_builder_validation_result' | 'agent_builder_fix_result' | 'task_decomposition' | 'block_list' | 'block_details' | 'block_output' | 'review_required' | 'schedule_list' | 'schedule_deleted' | 'schedule_created' | 'agent_trigger_list' | 'trigger_setup' | 'trigger_config_required' | 'preset_list' | 'preset_updated' | 'preset_deleted' | 'mcp_guide' | 'mcp_tools_discovered' | 'mcp_tool_output' | 'doc_search_results' | 'doc_page' | 'workspace_file_list' | 'workspace_file_content' | 'workspace_file_metadata' | 'workspace_file_written' | 'workspace_file_deleted' | 'folder_created' | 'folder_list' | 'folder_updated' | 'folder_moved' | 'folder_deleted' | 'agents_moved_to_folder' | 'browser_navigate' | 'browser_act' | 'browser_screenshot' | 'bash_exec' | 'web_fetch' | 'web_search' | 'feature_request_search' | 'feature_request_created' | 'memory_store' | 'memory_search' | 'memory_forget_candidates' | 'memory_forget_confirm' | 'todo_write' | 'platform_info' | 'chat_platform_channel_list' | 'chat_platform_posted' | 'skill_stored' | 'skill_loaded' | 'skill_deleted' | 'skill_list' — Types of tool responses.
    - `message` string, required
    - `session_id` string, nullable
    - `todos` TodoItem[]
      - `content` string, required — Imperative description of the task.
      - `activeForm` string, required — Present-continuous form shown while the task is running.
      - `status` 'pending' | 'in_progress' | 'completed'

---

[API](https://skmtc.net/significant-gravitas/apis/autogpt-agent-server.md) · [All operations](https://skmtc.net/significant-gravitas/apis/autogpt-agent-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/significant-gravitas/autogpt-agent-server/versions/382041c7ecb2/schema)
