{ "openapi" : "3.1.0", "info" : { "title" : "Coral Server API", "version" : "1.0" }, "externalDocs" : { "url" : "/" }, "servers" : [ ], "tags" : [ ], "paths" : { "/api/v1/debug/thread/{applicationId}/{privacyKey}/{coralSessionId}/{debugAgentId}" : { "post" : { "tags" : [ "debug" ], "summary" : "Create thread", "description" : "Creates a new thread", "operationId" : "debugCreateThread", "parameters" : [ { "name" : "applicationId", "in" : "path", "description" : "The application ID", "required" : true, "deprecated" : false, "explode" : false, "schema" : { "type" : "string", "title" : "String" } }, { "name" : "privacyKey", "in" : "path", "description" : "The privacy key", "required" : true, "deprecated" : false, "explode" : false, "schema" : { "type" : "string", "title" : "String" } }, { "name" : "coralSessionId", "in" : "path", "description" : "The Coral session ID", "required" : true, "deprecated" : false, "explode" : false, "schema" : { "type" : "string", "title" : "String" } }, { "name" : "debugAgentId", "in" : "path", "description" : "The debug agent ID", "required" : true, "deprecated" : false, "explode" : false, "schema" : { "type" : "string", "title" : "String" } } ], "requestBody" : { "description" : "Thread creation request", "content" : { "application/json" : { "schema" : { "$ref" : "#/components/schemas/CreateThreadInput" } } }, "required" : false }, "responses" : { "200" : { "description" : "Thread created successfully", "headers" : { } }, "404" : { "description" : "Session not found", "headers" : { } }, "500" : { "description" : "Error creating thread", "headers" : { } } }, "deprecated" : false } }, "/api/v1/debug/thread/sendMessage/{applicationId}/{privacyKey}/{coralSessionId}/{debugAgentId}" : { "post" : { "tags" : [ "debug" ], "summary" : "Send message", "description" : "Sends a message in debug mode", "operationId" : "debugSendMessage", "parameters" : [ { "name" : "applicationId", "in" : "path", "description" : "The application ID", "required" : true, "deprecated" : false, "explode" : false, "schema" : { "type" : "string", "title" : "String" } }, { "name" : "privacyKey", "in" : "path", "description" : "The privacy key", "required" : true, "deprecated" : false, "explode" : false, "schema" : { "type" : "string", "title" : "String" } }, { "name" : "coralSessionId", "in" : "path", "description" : "The Coral session ID", "required" : true, "deprecated" : false, "explode" : false, "schema" : { "type" : "string", "title" : "String" } }, { "name" : "debugAgentId", "in" : "path", "description" : "The debug agent ID", "required" : true, "deprecated" : false, "explode" : false, "schema" : { "type" : "string", "title" : "String" } } ], "requestBody" : { "description" : "The message to send", "content" : { "application/json" : { "schema" : { "$ref" : "#/components/schemas/SendMessageInput" } } }, "required" : false }, "responses" : { "200" : { "description" : "Message sent successfully", "headers" : { } }, "404" : { "description" : "Session not found", "headers" : { } }, "500" : { "description" : "Error sending message", "headers" : { } } }, "deprecated" : false } }, "/api/v1/sessions" : { "get" : { "tags" : [ "sessions" ], "summary" : "Get sessions", "description" : "Fetches all active session IDs", "operationId" : "getSessions", "parameters" : [ ], "responses" : { "200" : { "description" : "Success", "headers" : { }, "content" : { "application/json" : { "schema" : { "type" : "array", "items" : { "type" : "string", "title" : "String" }, "title" : "ArrayList" } } } } }, "deprecated" : false }, "post" : { "tags" : [ "sessions" ], "summary" : "Create session", "description" : "Creates a new session", "operationId" : "createSession", "parameters" : [ ], "requestBody" : { "description" : "Session creation request", "content" : { "application/json" : { "schema" : { "$ref" : "#/components/schemas/CreateSessionRequest" } } }, "required" : false }, "responses" : { "200" : { "description" : "Success", "headers" : { }, "content" : { "application/json" : { "schema" : { "$ref" : "#/components/schemas/CreateSessionResponse" } } } }, "403" : { "description" : "Invalid application ID or privacy key", "headers" : { } }, "400" : { "description" : "The agent graph is invalid and could not be processed", "headers" : { } } }, "deprecated" : false } }, "/api/v1/message/{applicationId}/{privacyKey}/{coralSessionId}" : { "post" : { "tags" : [ "message" ], "summary" : "Send message", "description" : "Sends a message", "operationId" : "sendMessage", "parameters" : [ { "name" : "applicationId", "in" : "path", "description" : "The application ID", "required" : true, "deprecated" : false, "explode" : false, "schema" : { "type" : "string", "title" : "String" } }, { "name" : "privacyKey", "in" : "path", "description" : "The privacy key", "required" : true, "deprecated" : false, "explode" : false, "schema" : { "type" : "string", "title" : "String" } }, { "name" : "coralSessionId", "in" : "path", "description" : "The Coral session ID", "required" : true, "deprecated" : false, "explode" : false, "schema" : { "type" : "string", "title" : "String" } } ], "responses" : { "200" : { "description" : "Success", "headers" : { } }, "403" : { "description" : "Invalid application ID or privacy key", "headers" : { } }, "404" : { "description" : "Invalid Coral session ID", "headers" : { } }, "400" : { "description" : "Invalid session ID", "headers" : { } }, "500" : { "description" : "MCP error", "headers" : { } } }, "deprecated" : false } }, "/api/v1/message/devmode/{applicationId}/{privacyKey}/{coralSessionId}" : { "post" : { "tags" : [ "message" ], "summary" : "Send development message", "description" : "Sends a dev-mode message", "operationId" : "sendDevMessage", "parameters" : [ { "name" : "applicationId", "in" : "path", "description" : "The application ID", "required" : true, "deprecated" : false, "explode" : false, "schema" : { "type" : "string", "title" : "String" } }, { "name" : "privacyKey", "in" : "path", "description" : "The privacy key", "required" : true, "deprecated" : false, "explode" : false, "schema" : { "type" : "string", "title" : "String" } }, { "name" : "coralSessionId", "in" : "path", "description" : "The Coral session ID", "required" : true, "deprecated" : false, "explode" : false, "schema" : { "type" : "string", "title" : "String" } } ], "responses" : { "200" : { "description" : "Success", "headers" : { } }, "404" : { "description" : "Invalid Coral session ID", "headers" : { } }, "400" : { "description" : "Invalid session ID", "headers" : { } }, "500" : { "description" : "MCP error", "headers" : { } } }, "deprecated" : false } }, "/api/v1/telemetry/{sessionId}/{threadId}/{messageId}" : { "get" : { "tags" : [ "telemetry" ], "summary" : "Get telemetry", "description" : "Fetches telemetry information for a given message", "operationId" : "getTelemetry", "parameters" : [ { "name" : "sessionId", "in" : "path", "description" : "The session ID", "required" : true, "deprecated" : false, "explode" : false, "schema" : { "type" : "string", "title" : "String" } }, { "name" : "threadId", "in" : "path", "description" : "The thread ID", "required" : true, "deprecated" : false, "explode" : false, "schema" : { "type" : "string", "title" : "String" } }, { "name" : "messageId", "in" : "path", "description" : "The message ID", "required" : true, "deprecated" : false, "explode" : false, "schema" : { "type" : "string", "title" : "String" } } ], "responses" : { "200" : { "description" : "Success", "headers" : { }, "content" : { "application/json" : { "schema" : { "$ref" : "#/components/schemas/Telemetry" } } } }, "404" : { "description" : "Telemetry data not found for specified message", "headers" : { } } }, "deprecated" : false } }, "/api/v1/telemetry/{sessionId}" : { "post" : { "tags" : [ "telemetry" ], "summary" : "Add telemetry", "description" : "Attaches telemetry information a list of messages", "operationId" : "addTelemetry", "parameters" : [ { "name" : "sessionId", "in" : "path", "description" : "The session ID", "required" : true, "deprecated" : false, "explode" : false, "schema" : { "type" : "string", "title" : "String" } } ], "requestBody" : { "description" : "Telemetry data", "content" : { "application/json" : { "schema" : { "$ref" : "#/components/schemas/TelemetryPost" } } }, "required" : false }, "responses" : { "200" : { "description" : "Success", "headers" : { } } }, "deprecated" : false } }, "/api/v1/agents" : { "get" : { "tags" : [ "agents" ], "summary" : "Get available agents", "description" : "Fetches a list of all agents available to the Coral server", "operationId" : "getAvailableAgents", "parameters" : [ ], "responses" : { "200" : { "description" : "Success", "headers" : { }, "content" : { "application/json" : { "schema" : { "type" : "array", "items" : { "$ref" : "#/components/schemas/PublicRegistryAgent" }, "title" : "ArrayList" } } } } }, "deprecated" : false } }, "/api/v1/agents/exported" : { "get" : { "tags" : [ "agents" ], "summary" : "Gets exported agents", "description" : "Fetches agents the Coral server has exported to other servers", "operationId" : "getExportedAgents", "parameters" : [ ], "responses" : { "200" : { "description" : "Success", "headers" : { }, "content" : { "application/json" : { "schema" : { "type" : "array", "items" : { "$ref" : "#/components/schemas/AgentExport" }, "title" : "ArrayList" } } } } }, "deprecated" : false } } }, "components" : { "schemas" : { "SocketEvent" : { "anyOf" : [ { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "agent_list" ], "title" : "String" }, "agents" : { "type" : "array", "items" : { "$ref" : "#/components/schemas/Agent" }, "title" : "ArrayList" } }, "required" : [ "agents", "type" ], "title" : "agent_list" }, { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "debug_agent_registered" ], "title" : "String" }, "id" : { "type" : "string", "title" : "String" } }, "required" : [ "id", "type" ], "title" : "debug_agent_registered" }, { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "session" ], "title" : "String" }, "event" : { "anyOf" : [ { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "agent_ready" ], "title" : "String" }, "agent" : { "type" : "string", "title" : "String" } }, "required" : [ "agent", "type" ], "title" : "agent_ready" }, { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "agent_registered" ], "title" : "String" }, "agent" : { "$ref" : "#/components/schemas/Agent" } }, "required" : [ "agent", "type" ], "title" : "agent_registered" }, { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "agent_state_updated" ], "title" : "String" }, "agent_id" : { "type" : "string", "title" : "String" }, "state" : { "$ref" : "#/components/schemas/AgentState" } }, "required" : [ "agent_id", "state", "type" ], "title" : "agent_state_updated" }, { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "message_sent" ], "title" : "String" }, "thread_id" : { "type" : "string", "title" : "String" }, "message" : { "$ref" : "#/components/schemas/ResolvedMessage" } }, "required" : [ "message", "thread_id", "type" ], "title" : "message_sent" }, { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "thread_created" ], "title" : "String" }, "id" : { "type" : "string", "title" : "String" }, "name" : { "type" : "string", "title" : "String" }, "creator_id" : { "type" : "string", "title" : "String" }, "participants" : { "type" : "array", "items" : { "type" : "string", "title" : "String" }, "title" : "ArrayList" }, "summary" : { "type" : "string", "title" : "String" } }, "required" : [ "creator_id", "id", "name", "participants", "type" ], "title" : "thread_created" } ], "discriminator" : { "propertyName" : "type" }, "title" : "SessionEvent" } }, "required" : [ "event", "type" ], "title" : "session" }, { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "thread_list" ], "title" : "String" }, "threads" : { "type" : "array", "items" : { "$ref" : "#/components/schemas/ResolvedThread" }, "title" : "ArrayList" } }, "required" : [ "threads", "type" ], "title" : "thread_list" } ], "discriminator" : { "propertyName" : "type" }, "title" : "SocketEvent" }, "Agent" : { "type" : "object", "properties" : { "id" : { "type" : "string", "title" : "String" }, "description" : { "type" : "string", "title" : "String" }, "state" : { "$ref" : "#/components/schemas/AgentState" }, "mcp_url" : { "type" : "string", "title" : "String" }, "extra_tools" : { "type" : "array", "items" : { "$ref" : "#/components/schemas/CustomTool" }, "title" : "LinkedHashSet", "uniqueItems" : true } }, "required" : [ "description", "extra_tools", "id", "state" ], "title" : "Agent" }, "AgentState" : { "type" : "string", "enum" : [ "disconnected", "connecting", "listening", "busy", "dead" ], "title" : "AgentState" }, "CustomTool" : { "type" : "object", "properties" : { "transport" : { "anyOf" : [ { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "http" ], "title" : "String" }, "url" : { "type" : "string", "title" : "UriString" } }, "required" : [ "type", "url" ], "title" : "http" } ], "discriminator" : { "propertyName" : "type" }, "title" : "ToolTransport" }, "tool_schema" : { "$ref" : "#/components/schemas/Tool" } }, "required" : [ "tool_schema", "transport" ], "title" : "CustomTool" }, "Tool" : { "type" : "object", "properties" : { "name" : { "type" : "string", "title" : "String" }, "description" : { "type" : "string", "title" : "String" }, "input_schema" : { "$ref" : "#/components/schemas/Input" } }, "required" : [ "input_schema", "name" ], "title" : "Tool" }, "Input" : { "type" : "object", "properties" : { "properties" : { "type" : "object", "additionalProperties" : { "$ref" : "#/components/schemas/JsonElement" }, "title" : "JsonObject" }, "required" : { "type" : "array", "items" : { "type" : "string", "title" : "String" }, "title" : "ArrayList" }, "type" : { "type" : "string", "title" : "String" } }, "required" : [ "properties", "type" ], "title" : "Input" }, "JsonElement" : { "type" : "object", "properties" : { }, "title" : "JsonElement" }, "ResolvedMessage" : { "type" : "object", "properties" : { "id" : { "type" : "string", "title" : "String" }, "thread_name" : { "type" : "string", "title" : "String" }, "thread_id" : { "type" : "string", "title" : "String" }, "sender_id" : { "type" : "string", "title" : "String" }, "content" : { "type" : "string", "title" : "String" }, "timestamp" : { "type" : "integer", "format" : "int64", "title" : "Long" }, "mentions" : { "type" : "array", "items" : { "type" : "string", "title" : "String" }, "title" : "ArrayList" } }, "required" : [ "content", "id", "mentions", "sender_id", "thread_id", "thread_name", "timestamp" ], "title" : "ResolvedMessage" }, "ResolvedThread" : { "type" : "object", "properties" : { "id" : { "type" : "string", "title" : "String" }, "name" : { "type" : "string", "title" : "String" }, "creator_id" : { "type" : "string", "title" : "String" }, "participants" : { "type" : "array", "items" : { "type" : "string", "title" : "String" }, "title" : "ArrayList" }, "messages" : { "type" : "array", "items" : { "$ref" : "#/components/schemas/ResolvedMessage" }, "title" : "ArrayList" }, "is_closed" : { "type" : "boolean", "title" : "Boolean" }, "summary" : { "type" : "string", "title" : "String" } }, "required" : [ "creator_id", "id", "is_closed", "messages", "name", "participants" ], "title" : "ResolvedThread" }, "CreateThreadInput" : { "type" : "object", "properties" : { "thread_name" : { "type" : "string", "title" : "String" }, "participant_ids" : { "type" : "array", "items" : { "type" : "string", "title" : "String" }, "title" : "ArrayList" } }, "required" : [ "participant_ids", "thread_name" ], "title" : "CreateThreadInput" }, "SendMessageInput" : { "type" : "object", "properties" : { "thread_id" : { "type" : "string", "title" : "String" }, "content" : { "type" : "string", "title" : "String" }, "mentions" : { "type" : "array", "items" : { "type" : "string", "title" : "String" }, "title" : "ArrayList" } }, "required" : [ "content", "mentions", "thread_id" ], "title" : "SendMessageInput" }, "AgentGraphRequest" : { "type" : "object", "properties" : { "agents" : { "type" : "object", "additionalProperties" : { "$ref" : "#/components/schemas/GraphAgentRequest" }, "title" : "HashMap" }, "links" : { "type" : "array", "items" : { "type" : "array", "items" : { "type" : "string", "title" : "String" }, "title" : "LinkedHashSet", "uniqueItems" : true }, "title" : "LinkedHashSet>", "uniqueItems" : true }, "tools" : { "type" : "object", "additionalProperties" : { "$ref" : "#/components/schemas/CustomTool" }, "title" : "LinkedHashMap" } }, "required" : [ "agents", "links", "tools" ], "title" : "AgentGraphRequest" }, "GraphAgentRequest" : { "type" : "object", "description" : "A request for an agent", "properties" : { "agent_name" : { "type" : "string", "description" : "The name of the agent to run, this must match the name of the agent in the registry", "title" : "String" }, "options" : { "type" : "object", "additionalProperties" : { "anyOf" : [ { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "number" ], "title" : "String" }, "value" : { "type" : "number", "format" : "double", "title" : "Double" } }, "required" : [ "type", "value" ], "title" : "number" }, { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "string" ], "title" : "String" }, "value" : { "type" : "string", "title" : "String" } }, "required" : [ "type", "value" ], "title" : "string" } ], "discriminator" : { "propertyName" : "type" }, "title" : "AgentOptionValue" }, "description" : "The arguments to pass to the agent", "title" : "LinkedHashMap" }, "system_prompt" : { "type" : "string", "description" : "The system prompt/developer text/preamble passed to the agent", "title" : "String" }, "blocking" : { "type" : "boolean", "description" : "", "title" : "Boolean" }, "tools" : { "type" : "array", "description" : "", "items" : { "type" : "string", "title" : "String" }, "title" : "LinkedHashSet", "uniqueItems" : true }, "provider" : { "anyOf" : [ { "type" : "object", "description" : "The agent will be provided by this server", "properties" : { "type" : { "type" : "string", "enum" : [ "local" ], "title" : "String" }, "runtime" : { "$ref" : "#/components/schemas/RuntimeId" } }, "required" : [ "runtime", "type" ], "title" : "local" }, { "type" : "object", "description" : "Agent will be provided by another Coral server", "properties" : { "type" : { "type" : "string", "enum" : [ "remote" ], "title" : "String" }, "runtime" : { "$ref" : "#/components/schemas/RuntimeId", "description" : "The runtime that should be used for this remote agent. Servers can export only specific runtimes so the runtime choice may narrow servers that can adequately provide the agent" }, "server_source" : { "$ref" : "#/components/schemas/GraphAgentServerSource", "description" : "A description of which servers should be queried for this remote agent request" }, "server_scoring" : { "anyOf" : [ { "type" : "object", "description" : "Custom server scoring. Weights can be added on a flat or multiplier basis per attribute", "properties" : { "type" : { "type" : "string", "enum" : [ "custom" ], "title" : "String" }, "scorers" : { "type" : "array", "items" : { "anyOf" : [ { "type" : "object", "description" : "The effect will be applied for every attribute of the specified type with a boolean false value", "properties" : { "op" : { "type" : "string", "enum" : [ "is_false" ], "title" : "String" }, "type" : { "$ref" : "#/components/schemas/GraphAgentServerAttributeType" }, "effect" : { "$ref" : "#/components/schemas/flat", "description" : "A flat negative or positive weight" } }, "required" : [ "effect", "op", "type" ], "title" : "is_false" }, { "type" : "object", "description" : "The effect will be applied if the no attribute of the specified type is present", "properties" : { "op" : { "type" : "string", "enum" : [ "is_not_present" ], "title" : "String" }, "type" : { "$ref" : "#/components/schemas/GraphAgentServerAttributeType" }, "effect" : { "$ref" : "#/components/schemas/flat", "description" : "A flat negative or positive weight" } }, "required" : [ "effect", "op", "type" ], "title" : "is_not_present" }, { "type" : "object", "description" : "The effect will be applied for every attribute of the specified type", "properties" : { "op" : { "type" : "string", "enum" : [ "is_present" ], "title" : "String" }, "type" : { "$ref" : "#/components/schemas/GraphAgentServerAttributeType" }, "effect" : { "$ref" : "#/components/schemas/GraphAgentServerScorerEffect" } }, "required" : [ "effect", "op", "type" ], "title" : "is_present" }, { "type" : "object", "description" : "The effect will be applied for every attribute of the specified type with a boolean true value", "properties" : { "op" : { "type" : "string", "enum" : [ "is_true" ], "title" : "String" }, "type" : { "$ref" : "#/components/schemas/GraphAgentServerAttributeType" }, "effect" : { "$ref" : "#/components/schemas/flat", "description" : "A flat negative or positive weight" } }, "required" : [ "effect", "op", "type" ], "title" : "is_true" }, { "type" : "object", "description" : "The effect will be applied for every attribute of the specified type with a matching string value", "properties" : { "op" : { "type" : "string", "enum" : [ "string_equal" ], "title" : "String" }, "type" : { "$ref" : "#/components/schemas/GraphAgentServerAttributeType" }, "string" : { "type" : "string", "title" : "String" }, "effect" : { "$ref" : "#/components/schemas/flat", "description" : "A flat negative or positive weight" } }, "required" : [ "effect", "op", "string", "type" ], "title" : "string_equal" }, { "type" : "object", "description" : "The effect will be applied for every attribute of the specified type with a non-matching string value", "properties" : { "op" : { "type" : "string", "enum" : [ "string_not_equal" ], "title" : "String" }, "type" : { "$ref" : "#/components/schemas/GraphAgentServerAttributeType" }, "string" : { "type" : "string", "title" : "String" }, "effect" : { "$ref" : "#/components/schemas/flat", "description" : "A flat negative or positive weight" } }, "required" : [ "effect", "op", "string", "type" ], "title" : "string_not_equal" } ], "discriminator" : { "propertyName" : "op" }, "title" : "GraphAgentServerCustomScorer" }, "title" : "ArrayList" } }, "required" : [ "scorers", "type" ], "title" : "custom" }, { "type" : "object", "description" : "Default server scoring. No weights assigned to any server attribute", "properties" : { "type" : { "type" : "string", "enum" : [ "default" ], "title" : "String" } }, "required" : [ "type" ], "title" : "default" } ], "description" : "Customisation for the scoring of servers", "discriminator" : { "propertyName" : "type" }, "title" : "GraphAgentServerScoring" } }, "required" : [ "runtime", "server_source", "type" ], "title" : "remote" } ], "description" : "The server that should provide this agent and the runtime to use", "discriminator" : { "propertyName" : "type" }, "title" : "GraphAgentProvider" } }, "required" : [ "agent_name", "options", "provider", "tools" ], "title" : "GraphAgentRequest" }, "RuntimeId" : { "type" : "string", "enum" : [ "executable", "docker" ], "title" : "RuntimeId" }, "GraphAgentServerSource" : { "anyOf" : [ { "type" : "object", "properties" : { "indexer" : { "type" : "string", "title" : "String" } }, "required" : [ "indexer" ], "title" : "Indexer" }, { "type" : "object", "properties" : { "servers" : { "type" : "array", "items" : { "$ref" : "#/components/schemas/GraphAgentServer" }, "title" : "ArrayList" } }, "required" : [ "servers" ], "title" : "servers" } ], "title" : "GraphAgentServerSource" }, "GraphAgentServer" : { "type" : "object", "properties" : { "address" : { "type" : "string", "title" : "String" }, "attributes" : { "type" : "array", "items" : { "anyOf" : [ { "type" : "object", "properties" : { "format" : { "type" : "string", "enum" : [ "boolean" ], "title" : "String" }, "type" : { "$ref" : "#/components/schemas/GraphAgentServerAttributeType" }, "value" : { "type" : "boolean", "title" : "Boolean" } }, "required" : [ "format", "type", "value" ], "title" : "boolean" }, { "type" : "object", "properties" : { "format" : { "type" : "string", "enum" : [ "number" ], "title" : "String" }, "type" : { "$ref" : "#/components/schemas/GraphAgentServerAttributeType" }, "value" : { "type" : "number", "format" : "double", "title" : "Double" } }, "required" : [ "format", "type", "value" ], "title" : "number" }, { "type" : "object", "properties" : { "format" : { "type" : "string", "enum" : [ "string" ], "title" : "String" }, "type" : { "$ref" : "#/components/schemas/GraphAgentServerAttributeType" }, "value" : { "type" : "string", "title" : "String" } }, "required" : [ "format", "type", "value" ], "title" : "string" } ], "discriminator" : { "propertyName" : "format" }, "title" : "GraphAgentServerAttribute" }, "title" : "ArrayList" } }, "required" : [ "address", "attributes" ], "title" : "GraphAgentServer" }, "GraphAgentServerAttributeType" : { "type" : "string", "enum" : [ "geographic_location", "attested_by" ], "title" : "GraphAgentServerAttributeType" }, "flat" : { "type" : "object", "description" : "A flat negative or positive weight", "properties" : { "weight" : { "type" : "number", "format" : "double", "title" : "Double" } }, "required" : [ "weight" ], "title" : "flat" }, "GraphAgentServerScorerEffect" : { "anyOf" : [ { "type" : "object", "description" : "A flat negative or positive weight", "properties" : { "weight" : { "type" : "number", "format" : "double", "title" : "Double" } }, "required" : [ "weight" ], "title" : "flat" }, { "type" : "object", "description" : "A multiplier weight, this effect will only multiply against attributes with a number type", "properties" : { "weight" : { "type" : "number", "format" : "double", "title" : "Double" } }, "required" : [ "weight" ], "title" : "multiplier" } ], "title" : "GraphAgentServerScorerEffect" }, "CreateSessionRequest" : { "type" : "object", "properties" : { "application_id" : { "type" : "string", "title" : "String" }, "session_id" : { "type" : "string", "title" : "String" }, "privacy_key" : { "type" : "string", "title" : "String" }, "agent_graph" : { "$ref" : "#/components/schemas/AgentGraphRequest" } }, "required" : [ "application_id", "privacy_key" ], "title" : "CreateSessionRequest" }, "CreateSessionResponse" : { "type" : "object", "properties" : { "session_id" : { "type" : "string", "title" : "String" }, "application_id" : { "type" : "string", "title" : "String" }, "privacy_key" : { "type" : "string", "title" : "String" } }, "required" : [ "application_id", "privacy_key", "session_id" ], "title" : "CreateSessionResponse" }, "Document" : { "type" : "object", "properties" : { "id" : { "type" : "string", "title" : "String" }, "text" : { "type" : "string", "title" : "String" } }, "required" : [ "id", "text" ], "title" : "Document" }, "ToolFunction" : { "type" : "object", "properties" : { "name" : { "type" : "string", "title" : "String" }, "arguments" : { "type" : "string", "title" : "String" } }, "required" : [ "arguments", "name" ], "title" : "ToolFunction" }, "ContentFormat" : { "type" : "string", "enum" : [ "base64", "string" ], "title" : "ContentFormat" }, "AudioMediaType" : { "type" : "string", "enum" : [ "wav", "mp3", "aiff", "aac", "ogg", "flac" ], "title" : "AudioMediaType" }, "DocumentMediaType" : { "type" : "string", "enum" : [ "pdf", "txt", "rtf", "html", "css", "markdown", "csv", "xml", "javascript", "python" ], "title" : "DocumentMediaType" }, "ImageMediaType" : { "type" : "string", "enum" : [ "jpeg", "png", "gif", "webp", "heic", "heif", "svg" ], "title" : "ImageMediaType" }, "ImageDetail" : { "type" : "string", "enum" : [ "low", "high", "auto" ], "title" : "ImageDetail" }, "VideoMediaType" : { "type" : "string", "enum" : [ "avi", "mp4", "mpeg" ], "title" : "VideoMediaType" }, "AudioAssistant" : { "type" : "object", "properties" : { "id" : { "type" : "string", "title" : "String" } }, "required" : [ "id" ], "title" : "AudioAssistant" }, "ToolCall" : { "type" : "object", "properties" : { "id" : { "type" : "string", "title" : "String" }, "type" : { "$ref" : "#/components/schemas/ToolType" }, "function" : { "$ref" : "#/components/schemas/Function" } }, "required" : [ "function", "id", "type" ], "title" : "ToolCall" }, "ToolType" : { "type" : "string", "enum" : [ "function" ], "title" : "ToolType" }, "Function" : { "type" : "object", "properties" : { "name" : { "type" : "string", "title" : "String" }, "arguments" : { "type" : "string", "title" : "String" } }, "required" : [ "arguments", "name" ], "title" : "Function" }, "OpenAISystemContent" : { "type" : "object", "properties" : { "type" : { "$ref" : "#/components/schemas/SystemContentType" }, "text" : { "type" : "string", "title" : "String" } }, "required" : [ "text", "type" ], "title" : "OpenAISystemContent" }, "SystemContentType" : { "type" : "string", "enum" : [ "text" ], "title" : "SystemContentType" }, "OpenAIToolResultContent" : { "type" : "object", "properties" : { "type" : { "$ref" : "#/components/schemas/ToolResultContentType" }, "text" : { "type" : "string", "title" : "String" } }, "required" : [ "text", "type" ], "title" : "OpenAIToolResultContent" }, "ToolResultContentType" : { "type" : "string", "enum" : [ "text" ], "title" : "ToolResultContentType" }, "InputAudio" : { "type" : "object", "properties" : { "data" : { "type" : "string", "title" : "String" }, "format" : { "$ref" : "#/components/schemas/AudioMediaType" } }, "required" : [ "data", "format" ], "title" : "InputAudio" }, "ImageUrl" : { "type" : "object", "properties" : { "url" : { "type" : "string", "title" : "String" }, "detail" : { "$ref" : "#/components/schemas/ImageDetail" } }, "required" : [ "detail", "url" ], "title" : "ImageUrl" }, "Telemetry" : { "type" : "object", "properties" : { "model_description" : { "type" : "string", "title" : "String" }, "preamble" : { "type" : "string", "title" : "String" }, "resources" : { "type" : "array", "items" : { "$ref" : "#/components/schemas/Document" }, "title" : "ArrayList" }, "tools" : { "type" : "array", "items" : { "$ref" : "#/components/schemas/Document" }, "title" : "ArrayList" }, "temperature" : { "type" : "number", "format" : "double", "title" : "Double" }, "max_tokens" : { "type" : "integer", "format" : "int64", "title" : "Long" }, "additional_params" : { "type" : "object", "additionalProperties" : { "$ref" : "#/components/schemas/JsonElement" }, "title" : "JsonObject" }, "messages" : { "anyOf" : [ { "type" : "object", "properties" : { "format" : { "type" : "string", "enum" : [ "Generic" ], "title" : "String" }, "data" : { "type" : "array", "items" : { "anyOf" : [ { "type" : "object", "properties" : { "role" : { "type" : "string", "enum" : [ "assistant" ], "title" : "String" }, "id" : { "type" : "string", "title" : "String" }, "content" : { "type" : "array", "items" : { "anyOf" : [ { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "assistant_reasoning" ], "title" : "String" }, "reasoning" : { "type" : "array", "items" : { "type" : "string", "title" : "String" }, "title" : "ArrayList" } }, "required" : [ "reasoning", "type" ], "title" : "assistant_reasoning" }, { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "assistant_text" ], "title" : "String" }, "text" : { "type" : "string", "title" : "String" } }, "required" : [ "text", "type" ], "title" : "assistant_text" }, { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "assistant_tool_call" ], "title" : "String" }, "id" : { "type" : "string", "title" : "String" }, "call_id" : { "type" : "string", "title" : "String" }, "function" : { "$ref" : "#/components/schemas/ToolFunction" } }, "required" : [ "function", "id", "type" ], "title" : "assistant_tool_call" } ], "discriminator" : { "propertyName" : "type" }, "title" : "GenericAssistantContent" }, "title" : "ArrayList" } }, "required" : [ "content", "role" ], "title" : "assistant" }, { "type" : "object", "properties" : { "role" : { "type" : "string", "enum" : [ "user" ], "title" : "String" }, "content" : { "type" : "array", "items" : { "anyOf" : [ { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "audio" ], "title" : "String" }, "data" : { "type" : "string", "title" : "String" }, "format" : { "$ref" : "#/components/schemas/ContentFormat" }, "media_type" : { "$ref" : "#/components/schemas/AudioMediaType" } }, "required" : [ "data", "type" ], "title" : "audio" }, { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "document" ], "title" : "String" }, "data" : { "type" : "string", "title" : "String" }, "format" : { "$ref" : "#/components/schemas/ContentFormat" }, "media_type" : { "$ref" : "#/components/schemas/DocumentMediaType" } }, "required" : [ "data", "type" ], "title" : "document" }, { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "image" ], "title" : "String" }, "data" : { "type" : "string", "title" : "String" }, "format" : { "$ref" : "#/components/schemas/ContentFormat" }, "media_type" : { "$ref" : "#/components/schemas/ImageMediaType" }, "detail" : { "$ref" : "#/components/schemas/ImageDetail" } }, "required" : [ "data", "type" ], "title" : "image" }, { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "text" ], "title" : "String" }, "text" : { "type" : "string", "title" : "String" } }, "required" : [ "text", "type" ], "title" : "text" }, { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "tool_result" ], "title" : "String" }, "id" : { "type" : "string", "title" : "String" }, "call_id" : { "type" : "string", "title" : "String" }, "content" : { "type" : "array", "items" : { "anyOf" : [ { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "tool_image" ], "title" : "String" }, "data" : { "type" : "string", "title" : "String" }, "format" : { "$ref" : "#/components/schemas/ContentFormat" }, "media_type" : { "$ref" : "#/components/schemas/ImageMediaType" }, "detail" : { "$ref" : "#/components/schemas/ImageDetail" } }, "required" : [ "data", "type" ], "title" : "tool_image" }, { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "tool_text" ], "title" : "String" }, "text" : { "type" : "string", "title" : "String" } }, "required" : [ "text", "type" ], "title" : "tool_text" } ], "discriminator" : { "propertyName" : "type" }, "title" : "GenericToolResultContent" }, "title" : "ArrayList" } }, "required" : [ "content", "id", "type" ], "title" : "tool_result" }, { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "video" ], "title" : "String" }, "data" : { "type" : "string", "title" : "String" }, "format" : { "$ref" : "#/components/schemas/ContentFormat" }, "media_type" : { "$ref" : "#/components/schemas/VideoMediaType" } }, "required" : [ "data", "type" ], "title" : "video" } ], "discriminator" : { "propertyName" : "type" }, "title" : "GenericUserContent" }, "title" : "ArrayList" } }, "required" : [ "content", "role" ], "title" : "user" } ], "discriminator" : { "propertyName" : "role" }, "title" : "GenericMessage" }, "title" : "ArrayList" } }, "required" : [ "data", "format" ], "title" : "Generic" }, { "type" : "object", "properties" : { "format" : { "type" : "string", "enum" : [ "OpenAI" ], "title" : "String" }, "data" : { "type" : "array", "items" : { "anyOf" : [ { "type" : "object", "properties" : { "role" : { "type" : "string", "enum" : [ "assistant" ], "title" : "String" }, "content" : { "type" : "array", "items" : { "anyOf" : [ { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "refusal" ], "title" : "String" }, "refusal" : { "type" : "string", "title" : "String" } }, "required" : [ "refusal", "type" ], "title" : "refusal" }, { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "text" ], "title" : "String" }, "text" : { "type" : "string", "title" : "String" } }, "required" : [ "text", "type" ], "title" : "text" } ], "discriminator" : { "propertyName" : "type" }, "title" : "OpenAIAssistantContent" }, "title" : "ArrayList" }, "refusal" : { "type" : "string", "title" : "String" }, "audio" : { "$ref" : "#/components/schemas/AudioAssistant" }, "name" : { "type" : "string", "title" : "String" }, "tool_calls" : { "type" : "array", "items" : { "$ref" : "#/components/schemas/ToolCall" }, "title" : "ArrayList" } }, "required" : [ "content", "role", "tool_calls" ], "title" : "assistant" }, { "type" : "object", "properties" : { "role" : { "type" : "string", "enum" : [ "developer" ], "title" : "String" }, "content" : { "type" : "array", "items" : { "$ref" : "#/components/schemas/OpenAISystemContent" }, "title" : "ArrayList" }, "name" : { "type" : "string", "title" : "String" } }, "required" : [ "content", "role" ], "title" : "developer" }, { "type" : "object", "properties" : { "role" : { "type" : "string", "enum" : [ "tool" ], "title" : "String" }, "tool_call_id" : { "type" : "string", "title" : "String" }, "content" : { "type" : "array", "items" : { "$ref" : "#/components/schemas/OpenAIToolResultContent" }, "title" : "ArrayList" } }, "required" : [ "content", "role", "tool_call_id" ], "title" : "tool" }, { "type" : "object", "properties" : { "role" : { "type" : "string", "enum" : [ "user" ], "title" : "String" }, "content" : { "type" : "array", "items" : { "anyOf" : [ { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "audio" ], "title" : "String" }, "input_audio" : { "$ref" : "#/components/schemas/InputAudio" } }, "required" : [ "input_audio", "type" ], "title" : "audio" }, { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "image_url" ], "title" : "String" }, "image_url" : { "$ref" : "#/components/schemas/ImageUrl" } }, "required" : [ "image_url", "type" ], "title" : "image_url" }, { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "text" ], "title" : "String" }, "text" : { "type" : "string", "title" : "String" } }, "required" : [ "text", "type" ], "title" : "text" } ], "discriminator" : { "propertyName" : "type" }, "title" : "OpenAIUserContent" }, "title" : "ArrayList" }, "name" : { "type" : "string", "title" : "String" } }, "required" : [ "content", "role" ], "title" : "user" } ], "discriminator" : { "propertyName" : "role" }, "title" : "OpenAIMessage" }, "title" : "ArrayList" } }, "required" : [ "data", "format" ], "title" : "OpenAI" } ], "discriminator" : { "propertyName" : "format" }, "title" : "TelemetryMessages" } }, "required" : [ "messages", "model_description", "resources", "tools" ], "title" : "Telemetry" }, "TelemetryTarget" : { "type" : "object", "properties" : { "thread_id" : { "type" : "string", "title" : "String" }, "message_id" : { "type" : "string", "title" : "String" } }, "required" : [ "message_id", "thread_id" ], "title" : "TelemetryTarget" }, "TelemetryPost" : { "type" : "object", "properties" : { "targets" : { "type" : "array", "items" : { "$ref" : "#/components/schemas/TelemetryTarget" }, "title" : "ArrayList" }, "data" : { "$ref" : "#/components/schemas/Telemetry" } }, "required" : [ "data", "targets" ], "title" : "TelemetryPost" }, "PublicRegistryAgent" : { "type" : "object", "properties" : { "id" : { "type" : "string", "title" : "String" }, "runtimes" : { "type" : "array", "items" : { "$ref" : "#/components/schemas/RuntimeId" }, "title" : "ArrayList" }, "options" : { "type" : "object", "additionalProperties" : { "anyOf" : [ { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "number" ], "title" : "String" }, "description" : { "type" : "string", "title" : "String" }, "default" : { "type" : "number", "format" : "double", "title" : "Double" }, "required" : { "type" : "boolean", "title" : "Boolean" } }, "required" : [ "required", "type" ], "title" : "number" }, { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "secret" ], "title" : "String" }, "description" : { "type" : "string", "title" : "String" }, "required" : { "type" : "boolean", "title" : "Boolean" } }, "required" : [ "required", "type" ], "title" : "secret" }, { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "string" ], "title" : "String" }, "description" : { "type" : "string", "title" : "String" }, "default" : { "type" : "string", "title" : "String" }, "required" : { "type" : "boolean", "title" : "Boolean" } }, "required" : [ "required", "type" ], "title" : "string" } ], "discriminator" : { "propertyName" : "type" }, "title" : "AgentOption" }, "title" : "LinkedHashMap" } }, "required" : [ "id", "options", "runtimes" ], "title" : "PublicRegistryAgent" }, "AgentExport" : { "type" : "object", "properties" : { "agent" : { "$ref" : "#/components/schemas/RegistryAgent" }, "runtimes" : { "type" : "object", "additionalProperties" : { "$ref" : "#/components/schemas/AgentExportPricing" }, "title" : "LinkedHashMap" }, "quantity" : { "type" : "integer", "maximum" : 4294967295, "minimum" : 0, "title" : "UInt" } }, "required" : [ "agent", "quantity", "runtimes" ], "title" : "AgentExport" }, "RegistryAgent" : { "type" : "object", "properties" : { "runtimes" : { "$ref" : "#/components/schemas/runtime" }, "options" : { "type" : "object", "additionalProperties" : { "anyOf" : [ { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "number" ], "title" : "String" }, "description" : { "type" : "string", "title" : "String" }, "default" : { "type" : "number", "format" : "double", "title" : "Double" }, "required" : { "type" : "boolean", "title" : "Boolean" } }, "required" : [ "required", "type" ], "title" : "number" }, { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "secret" ], "title" : "String" }, "description" : { "type" : "string", "title" : "String" }, "required" : { "type" : "boolean", "title" : "Boolean" } }, "required" : [ "required", "type" ], "title" : "secret" }, { "type" : "object", "properties" : { "type" : { "type" : "string", "enum" : [ "string" ], "title" : "String" }, "description" : { "type" : "string", "title" : "String" }, "default" : { "type" : "string", "title" : "String" }, "required" : { "type" : "boolean", "title" : "Boolean" } }, "required" : [ "required", "type" ], "title" : "string" } ], "discriminator" : { "propertyName" : "type" }, "title" : "AgentOption" }, "title" : "LinkedHashMap" } }, "required" : [ "options", "runtimes" ], "title" : "RegistryAgent" }, "runtime" : { "type" : "object", "properties" : { "executable" : { "$ref" : "#/components/schemas/executable" }, "docker" : { "$ref" : "#/components/schemas/docker" } }, "title" : "runtime" }, "executable" : { "type" : "object", "properties" : { "command" : { "type" : "array", "items" : { "type" : "string", "title" : "String" }, "title" : "ArrayList" }, "environment" : { "type" : "array", "items" : { "$ref" : "#/components/schemas/EnvVar" }, "title" : "ArrayList" } }, "required" : [ "command", "environment" ], "title" : "executable" }, "EnvVar" : { "type" : "object", "properties" : { "name" : { "type" : "string", "title" : "String" }, "value" : { "type" : "string", "title" : "String" }, "from" : { "type" : "string", "title" : "String" }, "option" : { "type" : "string", "title" : "String" } }, "title" : "EnvVar" }, "docker" : { "type" : "object", "properties" : { "image" : { "type" : "string", "title" : "String" }, "environment" : { "type" : "array", "items" : { "$ref" : "#/components/schemas/EnvVar" }, "title" : "ArrayList" }, "docker_client_config" : { "$ref" : "#/components/schemas/Polymorphic" }, "docker_client" : { "$ref" : "#/components/schemas/Polymorphic" } }, "required" : [ "docker_client_config", "environment", "image" ], "title" : "docker" }, "Polymorphic" : { "type" : "object", "properties" : { }, "title" : "Polymorphic" }, "Polymorphic" : { "type" : "object", "properties" : { }, "title" : "Polymorphic" }, "AgentExportPricing" : { "type" : "object", "properties" : { "min_price" : { "type" : "number", "format" : "double", "title" : "Double" }, "max_price" : { "type" : "number", "format" : "double", "title" : "Double" } }, "required" : [ "max_price", "min_price" ], "title" : "AgentExportPricing" } }, "examples" : { } }, "webhooks" : { } }