xevyo-01 / code /spec /tools.json
meet4150's picture
xevyo-01 round 4: merged weights, adapter, model card, code
a46f204 verified
Raw History Blame Contribute Delete
20.8 kB
{
"catalogue_version": "xv01.1",
"argument_conventions": {
"$MESSAGE": "A string argument whose value is exactly \"$MESSAGE\" means the user's message as typed (after any memory-command prefix is removed). Use it where the tool needs the whole request, e.g. code_agent.query for a coding task with pasted code. Code substitutes it before the call.",
"units": "Numeric measurement arguments are passed in the unit the user gave (calculator.py _BMI_DOC / _DOSAGE_DOC): never convert pounds, stones, feet or inches."
},
"tools": [
{
"name": "fetch_page",
"purpose": "Fetch and extract the readable text of one web page the user named (URL or bare domain).",
"group": "web",
"plannable": true,
"planned_via": null,
"side_effect": false,
"requires_confirmation": false,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"minLength": 4,
"maxLength": 2000,
"description": "Full URL (http:// or https://) or a bare domain the user gave."
}
}
}
},
{
"name": "web_search",
"purpose": "Fast web search returning snippets (news, scores, current facts).",
"group": "web",
"plannable": false,
"planned_via": "needs_search",
"side_effect": false,
"requires_confirmation": false,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"num_results": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"default": 5
}
}
}
},
{
"name": "web_rag",
"purpose": "Deep web search that fetches and reranks full pages (prices, profiles, company facts).",
"group": "web",
"plannable": false,
"planned_via": "needs_search",
"side_effect": false,
"requires_confirmation": false,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"use_firecrawl": {
"type": "boolean",
"default": false
}
}
}
},
{
"name": "drug_lookup",
"purpose": "Official label information for a medicine (uses, dosing, side effects, interactions).",
"group": "medical",
"plannable": false,
"planned_via": "drug",
"side_effect": false,
"requires_confirmation": false,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [
"drug_name"
],
"properties": {
"drug_name": {
"type": "string",
"minLength": 2,
"maxLength": 100
}
}
}
},
{
"name": "kb_retrieve",
"purpose": "Search the organisation's internal knowledge base (not the user's uploads).",
"group": "knowledge",
"plannable": true,
"planned_via": null,
"side_effect": false,
"requires_confirmation": false,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"top_k": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"default": 5
}
}
}
},
{
"name": "code_agent",
"purpose": "Send a coding task (write, debug, explain, review code; stack traces) to the code model.",
"group": "coding",
"plannable": true,
"planned_via": null,
"side_effect": false,
"requires_confirmation": false,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 4000,
"description": "The full coding task; usually $MESSAGE."
}
}
}
},
{
"name": "generate_image",
"purpose": "Text-to-image render.",
"group": "image",
"plannable": false,
"planned_via": "image",
"side_effect": true,
"requires_confirmation": false,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [
"prompt"
],
"properties": {
"prompt": {
"type": "string",
"minLength": 1,
"maxLength": 400
},
"visible_text": {
"type": [
"string",
"null"
],
"maxLength": 200
},
"negative_prompt": {
"type": "string",
"maxLength": 300,
"default": ""
},
"width": {
"type": "integer",
"minimum": 0,
"maximum": 2048,
"default": 0
},
"height": {
"type": "integer",
"minimum": 0,
"maximum": 2048,
"default": 0
},
"steps": {
"type": "integer",
"minimum": 0,
"maximum": 100,
"default": 0
}
}
}
},
{
"name": "memory_write_bound",
"purpose": "Propose a fact for long-term memory (never saves; the user confirms with Save).",
"group": "memory",
"plannable": false,
"planned_via": "memory",
"side_effect": true,
"requires_confirmation": true,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [
"memory_type",
"content"
],
"properties": {
"memory_type": {
"enum": [
"medical_condition",
"medication",
"allergy",
"preference",
"fact",
"summary",
"location",
"vital"
]
},
"content": {
"type": "string",
"minLength": 1,
"maxLength": 300
}
}
}
},
{
"name": "check_drug_interactions",
"purpose": "Check one drug against the user's OWN saved medication list using its FDA label.",
"group": "medical",
"plannable": true,
"planned_via": null,
"side_effect": false,
"requires_confirmation": false,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [
"drug_name"
],
"properties": {
"drug_name": {
"type": "string",
"minLength": 2,
"maxLength": 100
}
}
},
"default_off": true
},
{
"name": "calculate_bmi",
"purpose": "BMI and WHO category from a weight and height given in the user's own units.",
"group": "calculation",
"plannable": true,
"planned_via": null,
"side_effect": false,
"requires_confirmation": false,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [],
"minProperties": 2,
"properties": {
"weight_kg": {
"type": "number",
"exclusiveMinimum": 0
},
"height_cm": {
"type": "number",
"exclusiveMinimum": 0
},
"weight_lb": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Pounds, or the pounds part of stones-and-pounds."
},
"height_ft": {
"type": "number",
"exclusiveMinimum": 0
},
"height_in": {
"type": "number",
"minimum": 0,
"description": "Inches part of feet-and-inches, or the whole height in inches."
},
"weight_st": {
"type": "number",
"exclusiveMinimum": 0
},
"height_m": {
"type": "number",
"exclusiveMinimum": 0
},
"age_years": {
"type": "number",
"exclusiveMinimum": 0
}
}
}
},
{
"name": "calculate_dosage",
"purpose": "Weight-based dose: daily total, single dose and liquid volume, from a stated mg/kg or the built-in OTC table.",
"group": "calculation",
"plannable": true,
"planned_via": null,
"side_effect": false,
"requires_confirmation": false,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [
"drug_name"
],
"properties": {
"drug_name": {
"type": "string",
"minLength": 2,
"maxLength": 100
},
"weight_kg": {
"type": "number",
"exclusiveMinimum": 0
},
"dose_per_kg": {
"type": "number",
"exclusiveMinimum": 0,
"description": "mg per kg; omit to use the reference table (OTC drugs only)."
},
"frequency": {
"type": "string",
"maxLength": 60,
"description": "e.g. 'every 12 hours'."
},
"dose_basis": {
"enum": [
"per_dose",
"per_day"
],
"description": "Required whenever dose_per_kg is given."
},
"doses_per_day": {
"type": "number",
"exclusiveMinimum": 0
},
"weight_lb": {
"type": "number",
"exclusiveMinimum": 0
},
"concentration_mg": {
"type": "number",
"exclusiveMinimum": 0,
"description": "250 for '250 mg / 5 mL'."
},
"concentration_ml": {
"type": "number",
"exclusiveMinimum": 0,
"description": "5 for '250 mg / 5 mL'."
}
}
}
},
{
"name": "calculate",
"purpose": "Exact arithmetic on one expression: + - * / // % ** ( ) round(x, n) abs(x).",
"group": "calculation",
"plannable": true,
"planned_via": null,
"side_effect": false,
"requires_confirmation": false,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [
"expression"
],
"properties": {
"expression": {
"type": "string",
"minLength": 1,
"maxLength": 500,
"pattern": "^[0-9+\\-*/%()., roundabs]+$",
"description": "Numbers, + - * / // % **, parentheses, round(x, n), abs(x) only."
}
}
}
},
{
"name": "open_food_facts",
"purpose": "Packaged-food product record by barcode or product name.",
"group": "food",
"plannable": true,
"planned_via": null,
"side_effect": false,
"requires_confirmation": false,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"search_by": {
"enum": [
"name",
"barcode"
],
"default": "name"
}
}
}
},
{
"name": "usda_food_search",
"purpose": "Per-100 g nutrient data for a food from USDA FoodData Central.",
"group": "food",
"plannable": true,
"planned_via": null,
"side_effect": false,
"requires_confirmation": false,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [
"food_name"
],
"properties": {
"food_name": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "As specific as the user was: variety, farmed/wild, raw/cooked."
},
"data_type": {
"enum": [
"",
"Branded",
"Foundation",
"SR Legacy",
"Survey (FNDDS)"
],
"default": "",
"description": "Leave empty unless a branded product is named."
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 5,
"default": 3
}
}
}
},
{
"name": "open_fda",
"purpose": "FDA adverse-event reports and drug/food/device labels and recalls.",
"group": "medical",
"plannable": true,
"planned_via": null,
"side_effect": false,
"requires_confirmation": false,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"category": {
"enum": [
"drug",
"food",
"device"
],
"default": "drug"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 5,
"default": 3
}
}
}
},
{
"name": "dsld_lookup",
"purpose": "NIH Dietary Supplement Label Database: supplement, vitamin, mineral and herbal products.",
"group": "medical",
"plannable": true,
"planned_via": null,
"side_effect": false,
"requires_confirmation": false,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
}
}
},
{
"name": "pharmgkb_lookup",
"purpose": "Pharmacogenomics: how genes affect a drug's response (CYP2D6, VKORC1, ...).",
"group": "medical",
"plannable": true,
"planned_via": null,
"side_effect": false,
"requires_confirmation": false,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 100
}
}
}
},
{
"name": "google_trends_search",
"purpose": "Google Trends interest over time for up to 5 comma-separated terms.",
"group": "research",
"plannable": true,
"planned_via": null,
"side_effect": false,
"requires_confirmation": false,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [
"keywords"
],
"properties": {
"keywords": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"timeframe": {
"enum": [
"week",
"month",
"3m",
"year"
],
"default": "3m"
},
"geo": {
"type": "string",
"maxLength": 2,
"pattern": "^([A-Z]{2})?$",
"default": "",
"description": "ISO country code; empty = worldwide."
}
}
}
},
{
"name": "semantic_scholar_search",
"purpose": "Peer-reviewed papers, only when the user explicitly asks for research or evidence.",
"group": "research",
"plannable": true,
"planned_via": null,
"side_effect": false,
"requires_confirmation": false,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"default": 5
}
}
}
},
{
"name": "openaq_air_quality",
"purpose": "Current outdoor air quality (PM2.5, PM10, O3, NO2) for a city.",
"group": "environment",
"plannable": true,
"planned_via": null,
"side_effect": false,
"requires_confirmation": false,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [
"city"
],
"properties": {
"city": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"country": {
"type": "string",
"maxLength": 2,
"pattern": "^([A-Z]{2})?$",
"default": ""
}
}
}
},
{
"name": "google_calendar_list_events",
"purpose": "List upcoming events in the user's Google Calendar.",
"group": "google",
"plannable": true,
"planned_via": null,
"side_effect": false,
"requires_confirmation": false,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [],
"properties": {
"calendar_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"default": "primary"
},
"max_results": {
"type": "integer",
"minimum": 1,
"maximum": 25,
"default": 10
},
"time_min": {
"type": "string",
"maxLength": 40,
"default": "",
"description": "RFC3339; empty = now."
}
}
}
},
{
"name": "google_calendar_create_event",
"purpose": "Create a calendar event (proposed; the user confirms before it is created).",
"group": "google",
"plannable": true,
"planned_via": null,
"side_effect": true,
"requires_confirmation": true,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [
"summary",
"start_datetime",
"end_datetime"
],
"properties": {
"summary": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"start_datetime": {
"type": "string",
"minLength": 10,
"maxLength": 40,
"description": "RFC3339 with offset."
},
"end_datetime": {
"type": "string",
"minLength": 10,
"maxLength": 40
},
"calendar_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"default": "primary"
},
"description": {
"type": "string",
"maxLength": 1000,
"default": ""
},
"location": {
"type": "string",
"maxLength": 300,
"default": ""
},
"attendees": {
"type": "string",
"maxLength": 1000,
"default": "",
"description": "Comma-separated emails the user gave."
}
}
}
},
{
"name": "google_calendar_delete_event",
"purpose": "Delete a calendar event by id (proposed; the user confirms before it is deleted).",
"group": "google",
"plannable": true,
"planned_via": null,
"side_effect": true,
"requires_confirmation": true,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [
"event_id"
],
"properties": {
"event_id": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"calendar_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"default": "primary"
}
}
}
},
{
"name": "google_calendar_list_calendars",
"purpose": "List the user's Google calendars and their ids.",
"group": "google",
"plannable": true,
"planned_via": null,
"side_effect": false,
"requires_confirmation": false,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [],
"properties": {}
}
},
{
"name": "google_health_read",
"purpose": "Read the user's Google Fit / Health Connect data (steps, heart rate, sleep, weight, calories).",
"group": "google",
"plannable": true,
"planned_via": null,
"side_effect": false,
"requires_confirmation": false,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [],
"properties": {
"data_type": {
"enum": [
"steps",
"heart_rate",
"sleep",
"weight",
"calories"
],
"default": "steps"
},
"days": {
"type": "integer",
"minimum": 1,
"maximum": 30,
"default": 7
}
}
}
},
{
"name": "google_health_list_data_sources",
"purpose": "List the apps and devices writing to the user's Google Fit account.",
"group": "google",
"plannable": true,
"planned_via": null,
"side_effect": false,
"requires_confirmation": false,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [],
"properties": {}
}
},
{
"name": "handoff_to",
"purpose": "Hand the conversation to a colleague agent whose role fits better; ends the turn, the runtime decides.",
"group": "runtime",
"plannable": true,
"planned_via": null,
"side_effect": true,
"requires_confirmation": false,
"parameters": {
"type": "object",
"additionalProperties": false,
"required": [
"agent_slug",
"reason"
],
"properties": {
"agent_slug": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "One of the colleagues the offering agent lists."
},
"reason": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "The topic in a few words."
},
"context_summary": {
"type": "string",
"maxLength": 1500,
"default": ""
}
}
}
}
]
}