Update agent

veryfront__update_agent

Requires project.agents.write.

Access

No external-service connection is required. Use a Veryfront credential with access to the requested resources.

Call type: Can change resources.

Arguments

FieldTypeRequiredDescription and constraints
namestringNoHuman-readable name for the record. Minimum length: 1.
descriptionstring or nullNoHuman-readable description for the record.
modelstring or nullNoAI model id or alias. Call list_models for the ids this deployment serves; never invent a version suffix.
thinkingobjectNoThe thinking associated with this record.
temperaturenumber or nullNoThe temperature associated with this record.
max_stepsinteger or nullNoThe max steps associated with this record.
allowed_modelsstring[]NoAI model ids or aliases the agent may switch between. Call list_models for the accepted ids.
skill_idsstring[]NoThe skill ids associated with this record.
skill_selectionobjectNoThe skill selection associated with this record.
skillsboolean or string or string[] or objectNoThe skills associated with this record.
all_tools_enabledbooleanNoThe all tools enabled associated with this record.
tool_idsstring[]NoProject tools, platform tools, and integration catalog tools returned by get_integration. Use exact names from the agent tool references search.
toolsboolean or string[] or objectNoCallable host-tool selector. Use false to disable all host tools, including skill and delegation tools. An empty array or map selects no project tools but preserves legacy runtime essentials. Provider-native tools use provider_tool_ids.
tool_loadingstringNoThe tool loading associated with this record. Values: "eager", "deferred".
tool_result_contextboolean or objectNoThe tool result context associated with this record.
knowledgeboolean or string or string[] or object or nullNoThe knowledge associated with this record.
provider_tool_idsstring[]NoProvider-native model tools only. Never put tool references from tool_ids here.
suggestionsstring or object[] or nullNoThe suggestions associated with this record.
avatarobject or nullNoThe avatar associated with this record.
avatar_urlstring or nullNoThe avatar url associated with this record.
security_enabledbooleanNoWhether the agent default security guardrails are enabled.
idstringNoUnique identifier for the record. Minimum length: 1. Maximum length: 128.
agent_idstringYesThe agent id associated with this record. Minimum length: 1.
str_replaceobjectNoReplace one exact occurrence in the current system prompt. Do not combine with system or system_prompt.
project_referencestringNoProject identifier or slug associated with the record.
systemstringNoCanonical system prompt for the agent. Set this field only. Minimum length: 1.
system_promptstringNoCompatibility alias for system. Omit this field when system is present. Minimum length: 1.
source_target_kindstringNoWrite authored agent source in project or preview_branch. Omit for project; main_branch is a compatibility alias for project. Environment and release writes are unsupported.
target_branch_idstring or nullNoRequired for preview_branch. Omit or use null for project and main_branch. Use a branch ID returned by project branch discovery.

Example request

Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "veryfront__update_agent",
    "arguments": {
      "agent_id": "example"
    }
  }
}

Result

The published output shape is summarized below. Inspect both the MCP response content and isError when handling a call.

FieldTypeRequiredDescription and constraints
idstringYesUnique identifier for the record.
namestringYesHuman-readable name for the record.
descriptionstring or nullYesHuman-readable description for the record.
modelstring or nullYesModel identifier recovered from authored source. Null means no literal identifier was recovered; an omitted model is valid. The run selects and checks its model at admission, so null is not a missing-configuration error or a verified runtime default.
system_promptstring or nullYesThe system prompt associated with this record.
thinkingobject or nullNoThe thinking associated with this record.
temperaturenumber or nullYesThe temperature associated with this record.
max_stepsinteger or nullYesThe max steps associated with this record.
allowed_modelsstring[]YesAgent-level allowlist for request model overrides. Empty means no restriction by this allowlist; project and run model policies still apply. This does not identify the resolved runtime model.
skill_idsstring[]YesLegacy source-view skill IDs. A read with skill_resolution can include source-catalog matches; a write response can echo only authored IDs. An empty array does not prove that no skills are available, and these IDs do not verify runtime loading. Use skill_selection and skill_resolution for provenance.
skill_selectionobjectYesSkill selection. kind is the authored policy: omitted selects all owner-visible skills. Use skill_resolution for resolved source-catalog matches and their evidence scope.
skill_resolutionobject or nullNoSkill selector policy and owner-visible source catalog matches. Partial catalogs cannot establish that unreturned skills are absent. This does not verify run execution access.
skillsboolean or string or string[] or object or nullNoThe skills associated with this record.
all_tools_enabledbooleanYesWhether the authored selector allows all tools. False can still select individual tools. Read the raw tools selector and capability resolution for the selected set.
tool_idsstring[]YesSource-recovered explicit tool IDs. Empty when all_tools_enabled is true, when tools is false (authored deny-all), or when no explicit IDs were recovered, so an empty array alone does not mean callable host tools are disabled. This source view does not verify execution grants.
toolsboolean or string[] or object or nullNoCallable host-tool selector. Use false to disable all host tools, including skill and delegation tools. An empty array or map selects no project tools but preserves legacy runtime essentials. Provider-native tools use provider_tool_ids.
tool_loadingstring or nullNoThe tool loading associated with this record.
tool_result_contextboolean or object or nullNoThe tool result context associated with this record.
provider_tool_idsstring[]YesProvider-native model tool IDs attached to the record.
knowledgeboolean or string or string[] or object or nullNoThe knowledge associated with this record.
suggestionsstring or object[] or nullNoThe suggestions associated with this record.
avatarobject or null or nullNoThe avatar associated with this record.
avatar_urlstring or null or nullNoAbsolute URL for this agent avatar. Null when no custom avatar has been set.
security_enabledboolean or nullYesWhether the agent default security guardrails are enabled.
source_pathstringYesThe source path associated with this record.
sourcestringYesThe source associated with this record.
edit_modestringYesThe edit mode associated with this record. Values: "structured", "source_only".
source_only_reasonsstring[]YesList of source only reasons associated with this record.

Full schemas

json
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Human-readable name for the record."
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Human-readable description for the record."
    },
    "model": {
      "type": [
        "string",
        "null"
      ],
      "description": "AI model id or alias. Call list_models for the ids this deployment serves; never invent a version suffix."
    },
    "thinking": {
      "type": "object",
      "properties": {
        "enabled": {
          "type": "boolean",
          "description": "The enabled associated with this record."
        },
        "budget_tokens": {
          "type": "number",
          "exclusiveMinimum": 0,
          "description": "The budget tokens associated with this record."
        }
      },
      "required": [
        "enabled"
      ],
      "additionalProperties": false,
      "description": "The thinking associated with this record."
    },
    "temperature": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0,
          "maximum": 2,
          "description": "The temperature associated with this record."
        },
        {
          "type": "null",
          "description": "Provide the temperature."
        }
      ],
      "description": "The temperature associated with this record."
    },
    "max_steps": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "description": "The max steps associated with this record."
        },
        {
          "type": "null",
          "description": "Provide the max steps."
        }
      ],
      "description": "The max steps associated with this record."
    },
    "allowed_models": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "description": "One allowed model item associated with this record."
      },
      "description": "AI model ids or aliases the agent may switch between. Call list_models for the accepted ids."
    },
    "skill_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "description": "One skill id item associated with this record."
      },
      "description": "The skill ids associated with this record."
    },
    "skill_selection": {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "omitted",
            "explicit"
          ],
          "description": "The kind associated with this record."
        },
        "skill_ids": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "description": "One skill id item associated with this record."
          },
          "description": "The skill ids associated with this record.",
          "default": []
        }
      },
      "required": [
        "kind"
      ],
      "additionalProperties": false,
      "description": "The skill selection associated with this record."
    },
    "skills": {
      "anyOf": [
        {
          "type": "boolean",
          "description": "The option 1 associated with this record."
        },
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 128,
          "description": "The option 2 associated with this record."
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/properties/skills/anyOf/1",
            "description": "One skill item supplied to the tool."
          },
          "maxItems": 500,
          "description": "List of option 3 associated with this record."
        },
        {
          "type": "object",
          "additionalProperties": {
            "type": "boolean",
            "description": "Additional structured values associated with this result."
          },
          "propertyNames": {
            "minLength": 1,
            "maxLength": 128
          },
          "description": "The option 4 associated with this record."
        }
      ],
      "description": "The skills associated with this record."
    },
    "all_tools_enabled": {
      "type": "boolean",
      "description": "The all tools enabled associated with this record."
    },
    "tool_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "description": "One tool id item associated with this record."
      },
      "description": "Project tools, platform tools, and integration catalog tools returned by get_integration. Use exact names from the agent tool references search."
    },
    "tools": {
      "anyOf": [
        {
          "type": "boolean",
          "description": "The option 1 associated with this record."
        },
        {
          "type": "array",
          "items": {
            "$ref": "#/properties/skills/anyOf/1",
            "description": "One tool item supplied to the tool."
          },
          "maxItems": 500,
          "description": "List of option 2 associated with this record."
        },
        {
          "$ref": "#/properties/skills/anyOf/3",
          "description": "Provide the tools."
        }
      ],
      "description": "Callable host-tool selector. Use false to disable all host tools, including skill and delegation tools. An empty array or map selects no project tools but preserves legacy runtime essentials. Provider-native tools use provider_tool_ids."
    },
    "tool_loading": {
      "type": "string",
      "enum": [
        "eager",
        "deferred"
      ],
      "description": "The tool loading associated with this record."
    },
    "tool_result_context": {
      "anyOf": [
        {
          "type": "boolean",
          "description": "The option 1 associated with this record."
        },
        {
          "type": "object",
          "properties": {
            "max_inline_bytes": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 1048576,
              "description": "The max inline bytes associated with this record."
            },
            "preview_bytes": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 1048576,
              "description": "The preview bytes associated with this record."
            },
            "max_section_bytes": {
              "type": "integer",
              "minimum": 4,
              "maximum": 1048576,
              "description": "The max section bytes associated with this record."
            },
            "max_stored_results": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 1024,
              "description": "The max stored results associated with this record."
            }
          },
          "additionalProperties": false,
          "description": "Structured option 2 details associated with this record."
        }
      ],
      "description": "The tool result context associated with this record."
    },
    "knowledge": {
      "anyOf": [
        {
          "anyOf": [
            {
              "type": "boolean",
              "description": "The option 1 associated with this record."
            },
            {
              "type": "string",
              "minLength": 1,
              "maxLength": 4096,
              "description": "The option 2 associated with this record."
            },
            {
              "type": "array",
              "items": {
                "$ref": "#/properties/knowledge/anyOf/0/anyOf/1",
                "description": "One knowledge item supplied to the tool."
              },
              "maxItems": 1024,
              "description": "List of option 3 associated with this record."
            },
            {
              "type": "object",
              "additionalProperties": {
                "type": "boolean",
                "description": "Additional structured values associated with this result."
              },
              "description": "The option 4 associated with this record."
            }
          ],
          "description": "The knowledge associated with this record."
        },
        {
          "type": "null",
          "description": "Provide the knowledge."
        }
      ],
      "description": "The knowledge associated with this record."
    },
    "provider_tool_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "description": "One provider tool id item associated with this record."
      },
      "description": "Provider-native model tools only. Never put tool references from tool_ids here."
    },
    "suggestions": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "string",
                "minLength": 1,
                "description": "The option 1 associated with this record."
              },
              {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Short human-readable title for the record."
                  },
                  "prompt": {
                    "type": "string",
                    "minLength": 1,
                    "description": "The prompt associated with this record."
                  }
                },
                "required": [
                  "title",
                  "prompt"
                ],
                "additionalProperties": false,
                "description": "Structured option 2 details associated with this record."
              }
            ],
            "description": "One suggestion item associated with this record."
          },
          "description": "List of suggestions associated with this record."
        },
        {
          "type": "null",
          "description": "Provide the suggestions."
        }
      ],
      "description": "The suggestions associated with this record."
    },
    "avatar": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "seed": {
              "type": "string",
              "minLength": 1,
              "maxLength": 128,
              "description": "The seed associated with this record."
            },
            "archetype": {
              "type": "string",
              "enum": [
                "upright",
                "slumped",
                "alert",
                "profile",
                "leaning",
                "crouched",
                "tall",
                "spread",
                "happy",
                "sad",
                "angry",
                "surprised",
                "sleepy",
                "curious"
              ],
              "description": "The archetype associated with this record."
            },
            "texture": {
              "type": "string",
              "pattern": "^(?:[0-9]|none)$",
              "description": "The texture associated with this record."
            },
            "color": {
              "type": "string",
              "pattern": "^#[0-9a-fA-F]{6}$",
              "description": "The color associated with this record."
            },
            "shape": {
              "type": "string",
              "enum": [
                "snircle",
                "circle",
                "square"
              ],
              "description": "The shape associated with this record."
            },
            "matrix": {
              "type": "string",
              "pattern": "^[012]{16}$",
              "description": "The matrix associated with this record."
            }
          },
          "additionalProperties": false,
          "description": "Structured avatar details associated with this record."
        },
        {
          "type": "null",
          "description": "Provide the avatar."
        }
      ],
      "description": "The avatar associated with this record."
    },
    "avatar_url": {
      "anyOf": [
        {
          "type": "string",
          "format": "uri",
          "description": "The avatar url associated with this record."
        },
        {
          "type": "null",
          "description": "Provide the avatar url."
        }
      ],
      "description": "The avatar url associated with this record."
    },
    "security_enabled": {
      "type": "boolean",
      "description": "Whether the agent default security guardrails are enabled."
    },
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "pattern": "^[a-zA-Z0-9_-]+$",
      "description": "Unique identifier for the record."
    },
    "agent_id": {
      "type": "string",
      "minLength": 1,
      "description": "The agent id associated with this record."
    },
    "str_replace": {
      "type": "object",
      "properties": {
        "old_string": {
          "type": "string",
          "minLength": 1,
          "description": "Exact current text. It must match exactly once."
        },
        "new_string": {
          "type": "string",
          "description": "Replacement text. Use an empty string to delete the matched text."
        }
      },
      "required": [
        "old_string",
        "new_string"
      ],
      "additionalProperties": false,
      "description": "Replace one exact occurrence in the current system prompt. Do not combine with system or system_prompt."
    },
    "project_reference": {
      "type": "string",
      "description": "Project identifier or slug associated with the record."
    },
    "system": {
      "type": "string",
      "minLength": 1,
      "description": "Canonical system prompt for the agent. Set this field only."
    },
    "system_prompt": {
      "type": "string",
      "minLength": 1,
      "description": "Compatibility alias for system. Omit this field when system is present."
    },
    "source_target_kind": {
      "type": "string",
      "description": "Write authored agent source in project or preview_branch. Omit for project; main_branch is a compatibility alias for project. Environment and release writes are unsupported."
    },
    "target_branch_id": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid",
          "description": "The target branch id associated with this record."
        },
        {
          "type": "null",
          "description": "Provide the target branch id."
        }
      ],
      "description": "Required for preview_branch. Omit or use null for project and main_branch. Use a branch ID returned by project branch discovery."
    }
  },
  "required": [
    "agent_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#",
  "description": "Arguments for the update_agent tool."
}
json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique identifier for the record."
    },
    "name": {
      "type": "string",
      "description": "Human-readable name for the record."
    },
    "description": {
      "type": [
        "string",
        "null"
      ],
      "description": "Human-readable description for the record."
    },
    "model": {
      "type": [
        "string",
        "null"
      ],
      "description": "Model identifier recovered from authored source. Null means no literal identifier was recovered; an omitted model is valid. The run selects and checks its model at admission, so null is not a missing-configuration error or a verified runtime default."
    },
    "system_prompt": {
      "type": [
        "string",
        "null"
      ],
      "description": "The system prompt associated with this record."
    },
    "thinking": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "enabled": {
              "type": "boolean",
              "description": "The enabled associated with this record."
            },
            "budget_tokens": {
              "anyOf": [
                {
                  "type": "number",
                  "exclusiveMinimum": 0,
                  "description": "The budget tokens associated with this record."
                },
                {
                  "type": "null",
                  "description": "The budget tokens returned by the tool."
                }
              ],
              "description": "The budget tokens associated with this record."
            }
          },
          "required": [
            "enabled"
          ],
          "additionalProperties": false,
          "description": "Structured thinking details associated with this record."
        },
        {
          "type": "null",
          "description": "The thinking returned by the tool."
        }
      ],
      "description": "The thinking associated with this record."
    },
    "temperature": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0,
          "maximum": 2,
          "description": "The temperature associated with this record."
        },
        {
          "type": "null",
          "description": "The temperature returned by the tool."
        }
      ],
      "description": "The temperature associated with this record."
    },
    "max_steps": {
      "anyOf": [
        {
          "type": "integer",
          "exclusiveMinimum": 0,
          "description": "The max steps associated with this record."
        },
        {
          "type": "null",
          "description": "The max steps returned by the tool."
        }
      ],
      "description": "The max steps associated with this record."
    },
    "allowed_models": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "One allowed model item associated with this record."
      },
      "description": "Agent-level allowlist for request model overrides. Empty means no restriction by this allowlist; project and run model policies still apply. This does not identify the resolved runtime model."
    },
    "skill_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "One skill id item associated with this record."
      },
      "description": "Legacy source-view skill IDs. A read with skill_resolution can include source-catalog matches; a write response can echo only authored IDs. An empty array does not prove that no skills are available, and these IDs do not verify runtime loading. Use skill_selection and skill_resolution for provenance."
    },
    "skill_selection": {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "omitted",
            "explicit"
          ],
          "description": "The kind associated with this record."
        },
        "skill_ids": {
          "type": "array",
          "items": {
            "type": "string",
            "description": "One skill id item associated with this record."
          },
          "description": "Explicit skill IDs when kind is explicit. When kind is omitted, a read lists the owner-visible source-catalog matches (legacy projection) and a write response can echo an empty list. Use skill_resolution for provenance; these IDs do not verify runtime loading."
        }
      },
      "required": [
        "kind",
        "skill_ids"
      ],
      "additionalProperties": false,
      "description": "Skill selection. kind is the authored policy: omitted selects all owner-visible skills. Use skill_resolution for resolved source-catalog matches and their evidence scope."
    },
    "skill_resolution": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "policy": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "const": "all-visible",
                      "description": "The kind associated with this record."
                    },
                    "source": {
                      "type": "string",
                      "enum": [
                        "omitted",
                        "true"
                      ],
                      "description": "The source associated with this record."
                    }
                  },
                  "required": [
                    "kind",
                    "source"
                  ],
                  "additionalProperties": false,
                  "description": "Structured option 1 details associated with this record."
                },
                {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "const": "none",
                      "description": "The kind associated with this record."
                    }
                  },
                  "required": [
                    "kind"
                  ],
                  "additionalProperties": false,
                  "description": "Structured option 2 details associated with this record."
                },
                {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "const": "allowlist",
                      "description": "The kind associated with this record."
                    },
                    "entries": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "description": "One entry item associated with this record."
                      },
                      "description": "List of entries associated with this record."
                    }
                  },
                  "required": [
                    "kind",
                    "entries"
                  ],
                  "additionalProperties": false,
                  "description": "Structured option 3 details associated with this record."
                },
                {
                  "type": "object",
                  "properties": {
                    "kind": {
                      "type": "string",
                      "const": "rules",
                      "description": "The kind associated with this record."
                    },
                    "entries": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "pattern": {
                            "type": "string",
                            "description": "The pattern associated with this record."
                          },
                          "allow": {
                            "type": "boolean",
                            "description": "The allow associated with this record."
                          }
                        },
                        "required": [
                          "pattern",
                          "allow"
                        ],
                        "additionalProperties": false,
                        "description": "One entry item associated with this record."
                      },
                      "description": "List of entries associated with this record."
                    }
                  },
                  "required": [
                    "kind",
                    "entries"
                  ],
                  "additionalProperties": false,
                  "description": "Structured option 4 details associated with this record."
                }
              ],
              "description": "The policy associated with this record."
            },
            "skill_ids": {
              "type": "array",
              "items": {
                "type": "string",
                "description": "One skill id item associated with this record."
              },
              "description": "List of skill ids associated with this record."
            },
            "source_paths": {
              "type": "object",
              "additionalProperties": {
                "type": "string",
                "description": "Additional structured values associated with this result."
              },
              "description": "Structured source paths details associated with this record."
            },
            "unresolved_entry_indexes": {
              "type": "array",
              "items": {
                "type": "integer",
                "minimum": 0,
                "description": "One unresolved entry indexe item associated with this record."
              },
              "description": "List of unresolved entry indexes associated with this record."
            },
            "catalog_status": {
              "type": "string",
              "enum": [
                "complete",
                "partial"
              ],
              "description": "The catalog status associated with this record."
            },
            "evidence_scope": {
              "type": "string",
              "const": "source_catalog",
              "description": "The evidence scope associated with this record."
            }
          },
          "required": [
            "policy",
            "skill_ids",
            "source_paths",
            "unresolved_entry_indexes",
            "catalog_status",
            "evidence_scope"
          ],
          "additionalProperties": false,
          "description": "Skill selector policy and owner-visible source catalog matches. Partial catalogs cannot establish that unreturned skills are absent. This does not verify run execution access."
        },
        {
          "type": "null",
          "description": "The skill resolution returned by the tool."
        }
      ],
      "description": "Skill selector policy and owner-visible source catalog matches. Partial catalogs cannot establish that unreturned skills are absent. This does not verify run execution access."
    },
    "skills": {
      "anyOf": [
        {
          "anyOf": [
            {
              "type": "boolean",
              "description": "The option 1 associated with this record."
            },
            {
              "type": "string",
              "minLength": 1,
              "maxLength": 128,
              "description": "The option 2 associated with this record."
            },
            {
              "type": "array",
              "items": {
                "$ref": "#/properties/skills/anyOf/0/anyOf/1",
                "description": "One skill item returned by the tool."
              },
              "maxItems": 500,
              "description": "List of option 3 associated with this record."
            },
            {
              "type": "object",
              "additionalProperties": {
                "type": "boolean",
                "description": "Additional structured values associated with this result."
              },
              "propertyNames": {
                "minLength": 1,
                "maxLength": 128
              },
              "description": "The option 4 associated with this record."
            }
          ],
          "description": "The skills associated with this record."
        },
        {
          "type": "null",
          "description": "The skills returned by the tool."
        }
      ],
      "description": "The skills associated with this record."
    },
    "all_tools_enabled": {
      "type": "boolean",
      "description": "Whether the authored selector allows all tools. False can still select individual tools. Read the raw tools selector and capability resolution for the selected set."
    },
    "tool_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "One tool id item associated with this record."
      },
      "description": "Source-recovered explicit tool IDs. Empty when all_tools_enabled is true, when tools is false (authored deny-all), or when no explicit IDs were recovered, so an empty array alone does not mean callable host tools are disabled. This source view does not verify execution grants."
    },
    "tools": {
      "anyOf": [
        {
          "anyOf": [
            {
              "type": "boolean",
              "description": "The option 1 associated with this record."
            },
            {
              "type": "array",
              "items": {
                "$ref": "#/properties/skills/anyOf/0/anyOf/1",
                "description": "One tool item returned by the tool."
              },
              "maxItems": 500,
              "description": "List of option 2 associated with this record."
            },
            {
              "$ref": "#/properties/skills/anyOf/0/anyOf/3",
              "description": "The tools returned by the tool."
            }
          ],
          "description": "Callable host-tool selector. Use false to disable all host tools, including skill and delegation tools. An empty array or map selects no project tools but preserves legacy runtime essentials. Provider-native tools use provider_tool_ids."
        },
        {
          "type": "null",
          "description": "The tools returned by the tool."
        }
      ],
      "description": "Callable host-tool selector. Use false to disable all host tools, including skill and delegation tools. An empty array or map selects no project tools but preserves legacy runtime essentials. Provider-native tools use provider_tool_ids."
    },
    "tool_loading": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "eager",
            "deferred"
          ],
          "description": "The tool loading associated with this record."
        },
        {
          "type": "null",
          "description": "The tool loading returned by the tool."
        }
      ],
      "description": "The tool loading associated with this record."
    },
    "tool_result_context": {
      "anyOf": [
        {
          "anyOf": [
            {
              "type": "boolean",
              "description": "The option 1 associated with this record."
            },
            {
              "type": "object",
              "properties": {
                "max_inline_bytes": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 1048576,
                  "description": "The max inline bytes associated with this record."
                },
                "preview_bytes": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 1048576,
                  "description": "The preview bytes associated with this record."
                },
                "max_section_bytes": {
                  "type": "integer",
                  "minimum": 4,
                  "maximum": 1048576,
                  "description": "The max section bytes associated with this record."
                },
                "max_stored_results": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 1024,
                  "description": "The max stored results associated with this record."
                }
              },
              "additionalProperties": false,
              "description": "Structured option 2 details associated with this record."
            }
          ],
          "description": "The tool result context associated with this record."
        },
        {
          "type": "null",
          "description": "The tool result context returned by the tool."
        }
      ],
      "description": "The tool result context associated with this record."
    },
    "provider_tool_ids": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "One provider tool id item associated with this record."
      },
      "description": "Provider-native model tool IDs attached to the record."
    },
    "knowledge": {
      "anyOf": [
        {
          "anyOf": [
            {
              "type": "boolean",
              "description": "The option 1 associated with this record."
            },
            {
              "type": "string",
              "minLength": 1,
              "maxLength": 4096,
              "description": "The option 2 associated with this record."
            },
            {
              "type": "array",
              "items": {
                "$ref": "#/properties/knowledge/anyOf/0/anyOf/1",
                "description": "One knowledge item returned by the tool."
              },
              "maxItems": 1024,
              "description": "List of option 3 associated with this record."
            },
            {
              "type": "object",
              "additionalProperties": {
                "type": "boolean",
                "description": "Additional structured values associated with this result."
              },
              "description": "The option 4 associated with this record."
            }
          ],
          "description": "The knowledge associated with this record."
        },
        {
          "type": "null",
          "description": "The knowledge returned by the tool."
        }
      ],
      "description": "The knowledge associated with this record."
    },
    "suggestions": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "anyOf": [
              {
                "type": "string",
                "minLength": 1,
                "description": "The option 1 associated with this record."
              },
              {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Short human-readable title for the record."
                  },
                  "prompt": {
                    "type": "string",
                    "minLength": 1,
                    "description": "The prompt associated with this record."
                  }
                },
                "required": [
                  "title",
                  "prompt"
                ],
                "additionalProperties": false,
                "description": "Structured option 2 details associated with this record."
              }
            ],
            "description": "One suggestion item associated with this record."
          },
          "description": "List of suggestions associated with this record."
        },
        {
          "type": "null",
          "description": "The suggestions returned by the tool."
        }
      ],
      "description": "The suggestions associated with this record."
    },
    "avatar": {
      "anyOf": [
        {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "seed": {
                  "anyOf": [
                    {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 128,
                      "description": "The seed associated with this record."
                    },
                    {
                      "type": "null",
                      "description": "The seed returned by the tool."
                    }
                  ],
                  "description": "The seed associated with this record."
                },
                "archetype": {
                  "anyOf": [
                    {
                      "type": "string",
                      "enum": [
                        "upright",
                        "slumped",
                        "alert",
                        "profile",
                        "leaning",
                        "crouched",
                        "tall",
                        "spread",
                        "happy",
                        "sad",
                        "angry",
                        "surprised",
                        "sleepy",
                        "curious"
                      ],
                      "description": "The archetype associated with this record."
                    },
                    {
                      "type": "null",
                      "description": "The archetype returned by the tool."
                    }
                  ],
                  "description": "The archetype associated with this record."
                },
                "texture": {
                  "anyOf": [
                    {
                      "type": "string",
                      "pattern": "^(?:[0-9]|none)$",
                      "description": "The texture associated with this record."
                    },
                    {
                      "type": "null",
                      "description": "The texture returned by the tool."
                    }
                  ],
                  "description": "The texture associated with this record."
                },
                "color": {
                  "anyOf": [
                    {
                      "type": "string",
                      "pattern": "^#[0-9a-fA-F]{6}$",
                      "description": "The color associated with this record."
                    },
                    {
                      "type": "null",
                      "description": "The color returned by the tool."
                    }
                  ],
                  "description": "The color associated with this record."
                },
                "shape": {
                  "anyOf": [
                    {
                      "type": "string",
                      "enum": [
                        "snircle",
                        "circle",
                        "square"
                      ],
                      "description": "The shape associated with this record."
                    },
                    {
                      "type": "null",
                      "description": "The shape returned by the tool."
                    }
                  ],
                  "description": "The shape associated with this record."
                },
                "matrix": {
                  "anyOf": [
                    {
                      "type": "string",
                      "pattern": "^[012]{16}$",
                      "description": "The matrix associated with this record."
                    },
                    {
                      "type": "null",
                      "description": "The matrix returned by the tool."
                    }
                  ],
                  "description": "The matrix associated with this record."
                }
              },
              "additionalProperties": false,
              "description": "Structured avatar details associated with this record."
            },
            {
              "type": "null",
              "description": "The avatar returned by the tool."
            }
          ],
          "description": "The avatar associated with this record."
        },
        {
          "type": "null",
          "description": "The avatar returned by the tool."
        }
      ],
      "description": "The avatar associated with this record."
    },
    "avatar_url": {
      "anyOf": [
        {
          "anyOf": [
            {
              "type": "string",
              "format": "uri",
              "description": "The avatar url associated with this record."
            },
            {
              "type": "null",
              "description": "The avatar url returned by the tool."
            }
          ],
          "description": "The avatar url associated with this record."
        },
        {
          "type": "null",
          "description": "The avatar url returned by the tool."
        }
      ],
      "description": "Absolute URL for this agent avatar. Null when no custom avatar has been set."
    },
    "security_enabled": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "Whether the agent default security guardrails are enabled."
    },
    "source_path": {
      "type": "string",
      "description": "The source path associated with this record."
    },
    "source": {
      "type": "string",
      "description": "The source associated with this record."
    },
    "edit_mode": {
      "type": "string",
      "enum": [
        "structured",
        "source_only"
      ],
      "description": "The edit mode associated with this record."
    },
    "source_only_reasons": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "One source only reason item associated with this record."
      },
      "description": "List of source only reasons associated with this record."
    }
  },
  "required": [
    "id",
    "name",
    "description",
    "model",
    "system_prompt",
    "temperature",
    "max_steps",
    "allowed_models",
    "skill_ids",
    "skill_selection",
    "all_tools_enabled",
    "tool_ids",
    "provider_tool_ids",
    "security_enabled",
    "source_path",
    "source",
    "edit_mode",
    "source_only_reasons"
  ],
  "additionalProperties": false,
  "description": "Structured agent source output schema for MCP tools.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}