arcade-mcp/schemas/preview/tool_definition.schema.jsonc
Nate Barbettini c1a66a6170
SDK: Fully qualified tool names (#47)
In this PR:
- Handle and require fully-qualified tool names `Toolkit.ToolName` in
the actor

Also, unrelated changes/fixes:
- Cleaned up the logic around actor secrets and `$ARCADE_ACTOR_SECRET`
- Removes experimental Flask actor for now

Note: Must be merged along with
https://github.com/ArcadeAI/Engine/pull/87
2024-09-23 15:47:36 -07:00

181 lines
5.2 KiB
Text

{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$defs": {
"primitives": {
// All supported primitive data types
"type": "string",
"enum": ["string", "integer", "number", "boolean", "json"]
},
"value_schema": {
// Represents the schema of a value (e.g. function input parameter value)
"type": "object",
"properties": {
"val_type": {
"oneOf": [{ "$ref": "#/$defs/primitives" }, { "type": "string", "enum": ["array"] }]
},
"inner_val_type": {
"$ref": "#/$defs/primitives",
"description": "If the value type is a list, the type of the list values."
},
"enum": {
"oneOf": [
{ "type": "null" }, // Can be unset
{
"type": "array",
"items": {
"type": "string"
}
}
]
}
},
"required": ["val_type"],
"additionalProperties": false,
"if": {
"properties": { "val_type": { "const": "array" } }
},
"then": {
"required": ["inner_val_type"]
}
}
},
"type": "object",
"properties": {
"$schema": {
// Explicitly allow JSON-Schema to be referenced (due to additionalProperties: false)
"type": "string",
"format": "uri"
},
"name": {
"type": "string",
"description": "The tool name"
},
"description": {
"type": "string",
"description": "A human-readable description of the tool and when to use it"
},
"toolkit": {
"type": "object",
"description": "The toolkit that contains the tool",
"properties": {
"name": {
"type": "string",
"description": "The name of the toolkit"
},
"description": {
"type": "string",
"description": "A human-readable description of the toolkit"
},
"version": {
"type": "string",
"description": "An identifier for this version of the toolkit"
}
},
"required": ["name", "version"],
"additionalProperties": false
},
"inputs": {
"type": "object",
"properties": {
"parameters": {
"type": "array",
"minItems": 0,
"items": {
"type": "object",
"properties": {
"name": {
"description": "The human-readable name of this parameter.",
"type": "string"
},
"required": {
"description": "Whether this parameter is required (true) or optional (false).",
"type": "boolean"
},
"description": {
"description": "A descriptive, human-readable explanation of the parameter.",
"type": "string"
},
"value_schema": {
"$ref": "#/$defs/value_schema"
},
"inferrable": {
"type": "boolean",
"description": "Whether a value for this parameter can be inferred by a model. Defaults to `true`.",
"default": true
}
},
"required": ["name", "required", "value_schema"],
"additionalProperties": false
}
}
},
"required": ["parameters"],
"additionalProperties": false
},
"output": {
"type": "object",
"properties": {
"available_modes": {
"type": "array",
"minItems": 1,
"items": {
"type": "string",
"enum": ["value", "error", "null", "artifact", "requires_authorization"]
}
},
"description": {
"description": "A descriptive, human-readable explanation of the function's output.",
"type": "string"
},
"value_schema": {
"$ref": "#/$defs/value_schema"
}
},
"required": ["available_modes"],
"additionalProperties": false
},
"requirements": {
"type": "object",
"properties": {
"authorization": {
"oneOf": [
{ "type": "null" }, // Can be unset
{
"type": "string",
"enum": ["none", "token"]
},
{
"type": "object",
"properties": {
"provider": {
"type": "string"
},
"oauth2": {
"type": "object",
"properties": {
"authority": {
"type": "string",
"format": "uri"
},
"scope": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
},
"required": ["provider"],
"additionalProperties": false
}
]
}
},
"additionalProperties": false
}
},
"required": ["name", "toolkit", "inputs", "output"],
"additionalProperties": false
}