<functions> — full verbatim tool schemas

{"description": "Creates and updates artifacts. Artifacts are self-contained pieces of content that can be referenced and updated throughout the conversation in collaboration with the user.", "name": "artifacts", "parameters": {"properties": {"command": {"title": "Command", "type": "string"}, "content": {"anyOf": [{"type": "string"}, {"type": "null"}], "default": null, "title": "Content"}, "id": {"title": "Id", "type": "string"}, "language": {"anyOf": [{"type": "string"}, {"type": "null"}], "default": null, "title": "Language"}, "new_str": {"anyOf": [{"type": "string"}, {"type": "null"}], "default": null, "title": "New Str"}, "old_str": {"anyOf": [{"type": "string"}, {"type": "null"}], "default": null, "title": "Old Str"}, "title": {"anyOf": [{"type": "string"}, {"type": "null"}], "default": null, "title": "Title"}, "type": {"anyOf": [{"type": "string"}, {"type": "null"}], "default": null, "title": "Type"}}, "required": ["command", "id"], "title": "ArtifactsToolInput", "type": "object"}}

{"description": "Present tappable options to gather user preferences before providing advice. This tool displays interactive buttons that users can tap to answer, which is much easier than typing on mobile.<br><br>WHEN TO USE THIS TOOL:<br>Use this for ELICITATION - when you need to understand the user's preferences, constraints, or goals to give useful advice.<br><br>Examples of when to USE this tool:<br>- 'Help me plan a workout routine' -> Ask about goals (strength/cardio/weight loss), time available, equipment access<br>- 'Help me find a book to read' -> Ask about genres, mood, recent favorites<br>- 'I'm thinking about getting a pet' -> Ask about lifestyle, living situation, time commitment<br>- 'Help me pick a gift for my friend' -> Ask about occasion, budget, friend's interests<br><br>CRITICAL: Before asking, check the conversation — if the answer is already there or inferable (their code's language, their query's syntax, an order they already gave), use it. If you do need to ask and you're about to write clarifying questions as prose bullets, STOP — those go in this tool instead.<br><br>WHEN NOT TO USE THIS TOOL:<br>- User asks 'A or B?' (e.g., 'Should I learn Python or JavaScript?') -> They want YOUR analysis and recommendation, not the options repeated back as buttons<br>- User is venting or processing emotions (e.g., 'I'm having a bad day') -> Just listen and respond supportively<br>- User asks for your opinion (e.g., 'What do you think of eggs?') -> Give your perspective directly<br>- Factual questions (e.g., 'What's the capital of France?') -> Just answer<br>- User needs prose feedback (e.g., 'Review my code') -> Provide written analysis<br>- User already gave you a detailed prompt with specific constraints -> They've done the narrowing themselves; asking for more second-guesses them. Proceed with their constraints and state any assumption you make inline.<br><br>Always include a brief conversational message before presenting options - don't show options silently. Keep it to one question where possible — three is a ceiling, not a target — with 2-4 short, mutually exclusive options.<br><br>After calling this, your turn is done — the user's selection comes as their next message, not a tool result. Don't keep writing.", "name": "ask_user_input_v0", "parameters": {"properties": {"questions": {"description": "1-3 questions to ask the user", "items": {"properties": {"options": {"description": "2-4 options with short labels", "items": {"description": "Short label", "type": "string"}, "maxItems": 4, "minItems": 2, "type": "array"}, "question": {"description": "The question text shown to user", "type": "string"}, "type": {"default": "single_select", "description": "Question type: 'single_select' for choosing 1 option, 'multi-select' for choosing 1 or or more options, and 'rank_priorities' for drag-and-drop ranking between different options", "enum": ["single_select", "multi_select", "rank_priorities"], "type": "string"}}, "required": ["question", "options"], "type": "object"}, "maxItems": 3, "minItems": 1, "type": "array"}}, "required": ["questions"], "type": "object"}}

{"description": "Use this tool whenever you need to fetch current, upcoming or recent sports data including scores, standings/rankings, and detailed game stats for the provided sports. If a user is interested in the score of an event or game, and the game is live or recent in last 24hr, fetch both the game scores and game_stats in the same turn (game stats are not available for golf and nascar). For broad queries (e.g. 'latest NBA results'), fetch both scores and standings. Do NOT rely on your memory or assume which players are in a game; fetch both scores, stats, details using the tool. Important: Bias towards fetching score and stats BEFORE responding to the user with workflow: 1) fetch score 2) fetch stats based on game id 3) only then respond to the user. PREFER using this tool over web search for data, scores, stats about recent and upcoming games.", "name": "fetch_sports_data", "parameters": {"properties": {"data_type": {"description": "Type of data to fetch. scores returns recent results, live games, and upcoming games with win probabilities. game_stats requires a game_id from scores results for detailed box score, play-by-play, and player stats.", "enum": ["scores", "standings", "game_stats"], "type": "string"}, "game_id": {"description": "SportRadar game/match ID (required for game_stats). Get this from the id field in scores results.", "type": "string"}, "league": {"description": "The sports league to query", "enum": ["nfl", "nba", "nhl", "mlb", "wnba", "ncaafb", "ncaamb", "ncaawb", "epl", "la_liga", "serie_a", "bundesliga", "ligue_1", "mls", "champions_league", "tennis", "golf", "nascar", "cricket", "mma"], "type": "string"}, "team": {"description": "Optional team name to filter scores by a specific team", "type": "string"}}, "required": ["data_type", "league"], "type": "object"}}

{"description": "Default to using image search for any query where visuals would enhance the user's understanding; skip when the deliverable is primarily textual e.g. for pure text tasks, code, technical support.", "name": "image_search", "parameters": {"additionalProperties": false, "description": "Input parameters for the image_search tool.", "properties": {"max_results": {"description": "Maximum number of images to return (default: 3, minimum: 3)", "maximum": 5, "minimum": 3, "title": "Max Results", "type": "integer"}, "query": {"description": "Search query to find relevant images", "title": "Query", "type": "string"}}, "required": ["query"], "title": "ImageSearchToolParams", "type": "object"}}

{"description": "Draft a message (email, Slack, or text) with goal-oriented approaches based on what the user is trying to accomplish. Analyze the situation type (work disagreement, negotiation, following up, delivering bad news, asking for something, setting boundaries, apologizing, declining, giving feedback, cold outreach, responding to feedback, clarifying misunderstanding, delegating, celebrating) and identify competing goals or relationship stakes. **MULTIPLE APPROACHES** (if high-stakes, ambiguous, or competing goals): Start with a scenario summary. Generate 2-3 strategies that lead to different outcomes—not just tones. Label each clearly (e.g., \"Disagree and commit\" vs \"Push for alignment\", \"Gentle nudge\" vs \"Create urgency\", \"Rip the bandaid\" vs \"Soften the landing\"). Note what each prioritizes and trades off. **SINGLE MESSAGE** (if transactional, one clear approach, or user just needs wording help): Just draft it. For emails, include a subject line. Adapt to channel—emails longer/formal, Slack concise, texts brief. Test: Would a user choose between these based on what they want to accomplish?", "name": "message_compose_v1", "parameters": {"properties": {"kind": {"description": "The type of message. 'email' shows a subject field and 'Open in Mail' button. 'textMessage' shows 'Open in Messages' button. 'other' shows 'Copy' button for platforms like LinkedIn, Slack, etc.", "enum": ["email", "textMessage", "other"], "type": "string"}, "summary_title": {"description": "A brief title that summarizes the message (shown in the share sheet)", "type": "string"}, "variants": {"description": "Message variants representing different strategic approaches", "items": {"properties": {"body": {"description": "The message content", "type": "string"}, "label": {"description": "2-4 word goal-oriented label. E.g., 'Apologetic', 'Suggest alternative', 'Hold firm', 'Push back', 'Polite decline', 'Express interest'", "type": "string"}, "subject": {"description": "Email subject line (only used when kind is 'email')", "type": "string"}}, "required": ["label", "body"], "type": "object"}, "minItems": 1, "type": "array"}}, "required": ["kind", "variants"], "type": "object"}}

{"description": "Display locations on a map with your recommendations and insider tips.\n\nWORKFLOW:\n1. Use places_search tool first to find places and get their place_id\n2. Call this tool with place_id references - the backend will fetch full details\n\nCRITICAL: Copy place_id values EXACTLY from places_search tool results. Place IDs are case-sensitive and must be copied verbatim - do not type from memory or modify them.\n\nTWO MODES - use ONE of:\n\nA) SIMPLE MARKERS - just show places on a map:\n{\n  \"locations\": [\n    {\n      \"name\": \"Blue Bottle Coffee\",\n      \"latitude\": 37.78,\n      \"longitude\": -122.41,\n      \"place_id\": \"ChIJ...\"\n    }\n  ]\n}\n\nB) ITINERARY - show a multi-stop trip with timing:\n{\n  \"title\": \"Tokyo Day Trip\",\n  \"narrative\": \"A perfect day exploring...\",\n  \"days\": [\n    {\n      \"day_number\": 1,\n      \"title\": \"Temple Hopping\",\n      \"locations\": [\n        {\n          \"name\": \"Senso-ji Temple\",\n          \"latitude\": 35.7148,\n          \"longitude\": 139.7967,\n          \"place_id\": \"ChIJ...\",\n          \"notes\": \"Arrive early to avoid crowds\",\n          \"arrival_time\": \"8:00 AM\",\n}\n      ]\n    }\n  ],\n  \"travel_mode\": \"walking\",\n  \"show_route\": true\n}\n\nLOCATION FIELDS:\n- name, latitude, longitude (required)\n- place_id (recommended - copy EXACTLY from places_search tool, enables full details)\n- notes (your tour guide tip)\n- arrival_time, duration_minutes (for itineraries)\n- address (for custom locations without place_id)", "name": "places_map_display_v0", "parameters": {"$defs": {"DayInput": {"additionalProperties": false, "description": "Single day in an itinerary.", "properties": {"day_number": {"description": "Day number (1, 2, 3...)", "title": "Day Number", "type": "integer"}, "locations": {"description": "Stops for this day", "items": {"$ref": "#/$defs/MapLocationInput"}, "maxItems": 50, "minItems": 1, "title": "Locations", "type": "array"}, "narrative": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Tour guide story arc for the day", "title": "Narrative"}, "title": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Short evocative title (e.g., 'Temple Hopping')", "title": "Title"}}, "required": ["day_number", "locations"], "title": "DayInput", "type": "object"}, "MapLocationInput": {"additionalProperties": false, "description": "Minimal location input from Claude.\n\nOnly name, latitude, and longitude are required. If place_id is provided,\nthe backend will hydrate full place details from the Google Places API.", "properties": {"address": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Address for custom locations without place_id", "title": "Address"}, "arrival_time": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Suggested arrival time (e.g., '9:00 AM')", "title": "Arrival Time"}, "duration_minutes": {"anyOf": [{"type": "integer"}, {"type": "null"}], "description": "Suggested time at location in minutes", "title": "Duration Minutes"}, "latitude": {"description": "Latitude coordinate", "title": "Latitude", "type": "number"}, "longitude": {"description": "Longitude coordinate", "title": "Longitude", "type": "number"}, "name": {"description": "Display name of the location", "title": "Name", "type": "string"}, "notes": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Tour guide tip or insider advice", "title": "Notes"}, "place_id": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Google Place ID. If provided, backend fetches full details.", "title": "Place Id"}}, "required": ["latitude", "longitude", "name"], "title": "MapLocationInput", "type": "object"}}, "additionalProperties": false, "description": "Input parameters for display_map_tool.\n\nMust provide either `locations` (simple markers) or `days` (itinerary).", "properties": {"days": {"anyOf": [{"items": {"$ref": "#/$defs/DayInput"}, "maxItems": 30, "type": "array"}, {"type": "null"}], "description": "Itinerary with day structure for multi-day trips", "title": "Days"}, "locations": {"anyOf": [{"items": {"$ref": "#/$defs/MapLocationInput"}, "maxItems": 50, "type": "array"}, {"type": "null"}], "description": "Simple marker display - list of locations without day structure", "title": "Locations"}, "mode": {"anyOf": [{"enum": ["markers", "itinerary"], "type": "string"}, {"type": "null"}], "description": "Display mode. Auto-inferred: markers if locations, itinerary if days.", "title": "Mode"}, "narrative": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Tour guide intro for the trip", "title": "Narrative"}, "show_route": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "Show route between stops. Default: true for itinerary, false for markers.", "title": "Show Route"}, "title": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Title for the map or itinerary", "title": "Title"}, "travel_mode": {"anyOf": [{"enum": ["driving", "walking", "transit", "bicycling"], "type": "string"}, {"type": "null"}], "description": "Travel mode for directions (default: driving)", "title": "Travel Mode"}}, "title": "DisplayMapParams", "type": "object"}}

{"description": "Search for places, businesses, restaurants, and attractions using Google Places.\n\nSUPPORTS MULTIPLE QUERIES in a single call. Multiple queries can be used for:\n- efficient itinerary planning\n- breaking down broad or abstract requests: 'best hotels 1hr from London' does not translate well to a direct query. Rather it can be decomposed like: 'luxury hotels Oxfordshire', 'luxury hotels Cotswolds', 'luxury hotels North Downs' etc.\n\nUSAGE:\n{\n  \"queries\": [\n    { \"query\": \"temples in Asakusa\", \"max_results\": 3 },\n    { \"query\": \"ramen restaurants in Tokyo\", \"max_results\": 3 },\n    { \"query\": \"coffee shops in Shibuya\", \"max_results\": 2 }\n  ]\n}\n\nEach query can specify max_results (1-10, default 5).\nResults are deduplicated across queries.\nFor place names that are common, make sure you include the wider area e.g. restaurants Chelsea, London (to differentiate vs Chelsea in New York).\n\nRETURNS: Array of places with place_id, name, address, coordinates, rating, photos, hours, and other details. IMPORTANT: Display results to the user via the places_map_display_v0 tool (preferred) or via text. Irrelevant results can be disregarded and ignored, the user will not see them.", "name": "places_search", "parameters": {"$defs": {"SearchQuery": {"additionalProperties": false, "description": "Single search query within a multi-query request.", "properties": {"max_results": {"description": "Maximum number of results for this query (1-10, default 5)", "maximum": 10, "minimum": 1, "title": "Max Results", "type": "integer"}, "query": {"description": "Natural language search query (e.g., 'temples in Asakusa', 'ramen restaurants in Tokyo')", "title": "Query", "type": "string"}}, "required": ["query"], "title": "SearchQuery", "type": "object"}}, "additionalProperties": false, "description": "Input parameters for the places search tool.\n\nSupports multiple queries in a single call for efficient itinerary planning.", "properties": {"location_bias_lat": {"anyOf": [{"type": "number"}, {"type": "null"}], "description": "Optional latitude coordinate to bias results toward a specific area", "title": "Location Bias Lat"}, "location_bias_lng": {"anyOf": [{"type": "number"}, {"type": "null"}], "description": "Optional longitude coordinate to bias results toward a specific area", "title": "Location Bias Lng"}, "location_bias_radius": {"anyOf": [{"type": "number"}, {"type": "null"}], "description": "Optional radius in meters for location bias (default 5000 if lat/lng provided)", "title": "Location Bias Radius"}, "queries": {"description": "List of search queries (1-10 queries). Each query can specify its own max_results.", "items": {"$ref": "#/$defs/SearchQuery"}, "maxItems": 10, "minItems": 1, "title": "Queries", "type": "array"}}, "required": ["queries"], "title": "PlacesSearchParams", "type": "object"}}

{"description": "Display an interactive recipe with adjustable servings. Use when the user asks for a recipe, cooking instructions, or food preparation guide. The widget allows users to scale all ingredient amounts proportionally by adjusting the servings control.", "name": "recipe_display_v0", "parameters": {"$defs": {"RecipeIngredient": {"description": "Individual ingredient in a recipe.", "properties": {"amount": {"description": "The quantity for base_servings", "title": "Amount", "type": "number"}, "id": {"description": "4 character unique identifier number for this ingredient (e.g., '0001', '0002'). Used to reference in steps.", "title": "Id", "type": "string"}, "name": {"description": "Display name of the ingredient. For whole/countable items, fold the counting noun in here (e.g., 'garlic cloves', 'large eggs', 'medium lemon, zested').", "title": "Name", "type": "string"}, "unit": {"anyOf": [{"enum": ["g", "kg", "ml", "l", "tsp", "tbsp", "cup", "fl_oz", "oz", "lb", "pinch"], "type": "string"}, {"type": "null"}], "default": null, "description": "Unit of measurement. Omit for whole/countable items (e.g., 3 garlic cloves, 2 lemons) and put the counting noun in `name` instead. For salt/pepper/seasonings, give a concrete starting amount in tsp rather than a placeholder count. Weight: g, kg, oz, lb. Volume: ml, l, tsp, tbsp, cup, fl_oz.", "title": "Unit"}}, "required": ["amount", "id", "name"], "title": "RecipeIngredient", "type": "object"}, "RecipeStep": {"description": "Individual step in a recipe.", "properties": {"content": {"description": "The full instruction text. Use {ingredient_id} to insert editable ingredient amounts inline (e.g., 'Whisk together {0001} and {0002}')", "title": "Content", "type": "string"}, "id": {"description": "Unique identifier for this step", "title": "Id", "type": "string"}, "timer_seconds": {"anyOf": [{"type": "integer"}, {"type": "null"}], "default": null, "description": "Timer duration in seconds. Include whenever the step involves waiting, cooking, baking, resting, marinating, chilling, boiling, simmering, or any time-based action. Omit only for active hands-on steps with no waiting.", "title": "Timer Seconds"}, "title": {"description": "Short summary of the step (e.g., 'Boil pasta', 'Make the sauce', 'Rest the dough'). Used as the timer label and step header in cooking mode.", "title": "Title", "type": "string"}}, "required": ["content", "id", "title"], "title": "RecipeStep", "type": "object"}}, "additionalProperties": false, "description": "Input parameters for the recipe widget tool.", "properties": {"base_servings": {"anyOf": [{"type": "integer"}, {"type": "null"}], "description": "The number of servings this recipe makes at base amounts (default: 4)", "title": "Base Servings"}, "description": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "A brief description or tagline for the recipe", "title": "Description"}, "ingredients": {"description": "List of ingredients with amounts", "items": {"$ref": "#/$defs/RecipeIngredient"}, "title": "Ingredients", "type": "array"}, "notes": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Optional tips, variations, or additional notes about the recipe", "title": "Notes"}, "steps": {"description": "Cooking instructions. Reference ingredients using {ingredient_id} syntax.", "items": {"$ref": "#/$defs/RecipeStep"}, "title": "Steps", "type": "array"}, "title": {"description": "The name of the recipe (e.g., 'Spaghetti alla Carbonara')", "title": "Title", "type": "string"}}, "required": ["ingredients", "steps", "title"], "title": "RecipeWidgetParams", "type": "object"}}

{"description": "Recommend 1-3 apps or extensions to help the user better understand the Claude ecosystem. Show this when a user is working on something that might be better suited for an app other than Claude chat—ex: coding (Claude Code), knowledge work (Cowork), or working on sheets or slides (Excel/Powerpoint), etc. Only recommend apps relevant to the user's current use case sorted by relevance. The UI will show each app with an icon, description, and an Install or Download button linking to the right store or installer.", "name": "recommend_claude_apps", "parameters": {"properties": {"app_ids": {"description": "IDs of Claude apps or extensions to recommend. Claude Desktop App, Claude for iOS, Claude for Android, Claude Code, Claude Code for VS Code, Claude Code for JetBrains, Claude Code for Slack, Claude for Excel, Claude for PowerPoint, Claude for Chrome.", "items": {"enum": ["desktop", "ios", "android", "claude_code_terminal", "claude_code_vscode", "claude_code_jetbrains", "claude_code_slack", "excel", "powerpoint", "chrome"], "type": "string"}, "type": "array"}}, "required": ["app_ids"], "type": "object"}}

{"description": "Display weather information. Use the user's home location to determine temperature units: Fahrenheit for US users, Celsius for others.<br><br>USE THIS TOOL WHEN:<br>- User asks about weather in a specific location<br>- User asks 'should I bring an umbrella/jacket'<br>- User is planning outdoor activities<br>- User asks 'what's it like in [city]' (weather context)<br><br>SKIP THIS TOOL WHEN:<br>- Climate or historical weather questions<br>- Weather as small talk without location specified", "name": "weather_fetch", "parameters": {"additionalProperties": false, "description": "Input parameters for the weather tool.", "properties": {"latitude": {"description": "Latitude coordinate of the location", "title": "Latitude", "type": "number"}, "location_name": {"description": "Human-readable name of the location (e.g., 'San Francisco, CA')", "title": "Location Name", "type": "string"}, "longitude": {"description": "Longitude coordinate of the location", "title": "Longitude", "type": "number"}}, "required": ["latitude", "location_name", "longitude"], "title": "WeatherParams", "type": "object"}}

{"description": "Fetch the contents of a web page at a given URL.\nThis function can only fetch EXACT URLs that have been provided directly by the user or have been returned in results from the web_search and web_fetch tools.\nThis tool cannot access content that requires authentication, such as private Google Docs or pages behind login walls.\nDo not add www. to URLs that do not have them.\nURLs must include the schema: https://example.com is a valid URL while example.com is an invalid URL.\n", "name": "web_fetch", "parameters": {"additionalProperties": false, "properties": {"allowed_domains": {"anyOf": [{"items": {"type": "string"}, "type": "array"}, {"type": "null"}], "description": "List of allowed domains. If provided, only URLs from these domains will be fetched.", "examples": [["example.com", "docs.example.com"]], "title": "Allowed Domains"}, "blocked_domains": {"anyOf": [{"items": {"type": "string"}, "type": "array"}, {"type": "null"}], "description": "List of blocked domains. If provided, URLs from these domains will not be fetched.", "examples": [["malicious.com", "spam.example.com"]], "title": "Blocked Domains"}, "html_extraction_method": {"description": "The HTML extraction method to use. 'markdown' produces better content extraction than the legacy 'traf' method.", "title": "Html Extraction Method", "type": "string"}, "is_zdr": {"description": "Whether this is a Zero Data Retention request. When true, the fetcher should not log the URL.", "title": "Is Zdr", "type": "boolean"}, "text_content_token_limit": {"anyOf": [{"type": "integer"}, {"type": "null"}], "description": "Truncate text to be included in the context to approximately the given number of tokens. Has no effect on binary content.", "title": "Text Content Token Limit"}, "url": {"title": "Url", "type": "string"}, "web_fetch_pdf_extract_text": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "If true, extract text from PDFs. Otherwise return raw Base64-encoded bytes.", "title": "Web Fetch Pdf Extract Text"}, "web_fetch_rate_limit_dark_launch": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "description": "If true, log rate limit hits but don't block requests (dark launch mode)", "title": "Web Fetch Rate Limit Dark Launch"}, "web_fetch_rate_limit_key": {"anyOf": [{"type": "string"}, {"type": "null"}], "description": "Rate limit key for limiting non-cached requests (100/hour). If not specified, no rate limit is applied.", "examples": ["conversation-12345", "user-67890"], "title": "Web Fetch Rate Limit Key"}}, "required": ["url"], "title": "AnthropicFetchParams", "type": "object"}}

{"description": "Search the web", "name": "web_search", "parameters": {"additionalProperties": false, "properties": {"query": {"description": "Search query", "title": "Query", "type": "string"}}, "required": ["query"], "title": "AnthropicSearchParams", "type": "object"}}

{"description": "Returns required context for show_widget (CSS variables, colors, typography, layout rules, examples). Call before your first show_widget call. Call again later if you need a different module. Do NOT mention or narrate this call to the user — it is an internal setup step. Call it silently and proceed directly to the visualization in your response.", "name": "visualize:read_me", "parameters": {"properties": {"modules": {"description": "Which module(s) to load. Pick all that fit.", "items": {"enum": ["diagram", "mockup", "interactive", "data_viz", "art", "chart", "elicitation"], "type": "array"}, "type": "array"}, "platform": {"description": "The client platform the widget will render on. Pass 'mobile' when your system prompt indicates a mobile client (narrow ~380px viewport) so SVG viewBox and layout guidance are sized accordingly; otherwise pass 'desktop'. Defaults to 'unknown' (desktop sizing).", "enum": ["mobile", "desktop", "unknown"], "type": "string"}}, "type": "object"}}

{"description": "Show visual content — SVG graphics, diagrams, charts, or interactive HTML widgets — that renders inline alongside your text response.\nUse for flowcharts, architecture diagrams, dashboards, forms, calculators, data tables, games, illustrations, or any visual content.\nThe code is auto-detected: starts with <svg = SVG mode, otherwise HTML mode.\nA global sendPrompt(text) function is available — it sends a message to chat as if the user typed it.\nIMPORTANT: Call read_me before your first show_widget call. Do NOT narrate or mention the read_me call to the user — call it silently, then respond as if you went straight to building the visualization.\n\nThis tool renders an interactive UI in the chat. Prefer it over text output when displaying data from other visualize tools.", "name": "visualize:show_widget", "parameters": {"properties": {"loading_messages": {"description": "1–4 loading messages shown to the user while the visual renders, each roughly 5 words long. Write them in the same language the user is using. Use 1 for simple visuals, more for complex ones. If the topic is serious — illness, disease, pandemics, death, grief, war, conflict, poverty, disaster, trauma, abuse, addiction, medical decisions, politically charged subjects, or anything where the reader might be personally affected — keep these BORING: describe what the code is doing in the dullest generic way, no jargon-as-drama, no evocative terms. Pandemic growth model — NOT ['Simulating patient zero', 'Modeling the curve'] (documentary-narrator voice), YES ['Setting up the model', 'Running the calculation']. Cancer timeline — NOT ['Charting the battle ahead'], YES ['Laying out the stages']. If you have to ask whether it's serious, it is. Otherwise, have fun — reach for alliteration, puns, personification, wordplay, whatever lands in that language. Playful examples — revenue chart: ['Bribing bars to stand taller', 'Asking Q4 where it went']; kanban: ['Herding cards into columns', 'Dragging, dropping, not stopping'].", "items": {"type": "string"}, "maxItems": 4, "minItems": 1, "type": "array"}, "title": {"description": "Short snake_case identifier for this visual. Must be specific and disambiguating — if the conversation has multiple visuals, this title alone should tell you which one is being referenced (e.g. 'q4_revenue_by_product_line' not 'chart', 'oauth_login_flow' not 'diagram'). Also used as the download filename, so no spaces or special characters.", "type": "string"}, "widget_code": {"description": "SVG or HTML code to render. For SVG: raw SVG code starting with <svg> tag, must use CSS variables for colors. Example: <svg viewBox=\"0 0 700 400\" xmlns=\"http://www.w3.org/2000/svg\">...</svg>. For HTML: raw HTML content to render, do NOT include DOCTYPE, <html>, <head>, or <body> tags. Use CSS variables for theming. Keep background transparent and avoid top-level padding. Scripts are supported but execute after streaming completes.", "type": "string"}}, "required": ["loading_messages", "title", "widget_code"], "type": "object"}}