{ "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": "" } } } } ] }