{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "userId": {
      "description": "Optional user identifier. Authenticated users are identified automatically via API key. For trial users, this helps track usage.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "userId": {
      "description": "Optional user identifier.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "mode": {
      "default": "research",
      "description": "Execution mode: \"research\" for topic research (15 API calls), \"compare\" for upload & compare intelligence (20 API calls). Defaults to \"research\".",
      "type": "string",
      "enum": [
        "research",
        "compare"
      ]
    },
    "graphId": {
      "description": "Optional graph ID. If omitted, searches ALL accessible graphs. Examples: 'retail', 'tech', 'food', 'travel', 'beauty', 'sports', 'sic', 'pew', 'ce-design', 'ezra-eeman-wayfinder', 'dhl-ecommerce-trends-2026', 'automotive-color-trends', 'alyson-stevens-macro', 'generative-realities', 'pwc/sxsw-2026-key-insights', 'green-house/thrive-report', 'delta/the-connection-index'",
      "type": "string"
    },
    "query": {
      "type": "string",
      "description": "The search query. Location terms are auto-detected and used to filter results geographically."
    },
    "userId": {
      "description": "Optional user identifier for trial usage tracking.",
      "type": "string"
    },
    "limit": {
      "description": "Maximum number of results (default 10, max 50)",
      "type": "number"
    },
    "use_semantic": {
      "description": "Whether to use semantic search (default true)",
      "type": "boolean"
    },
    "include_evidence": {
      "description": "If true, batch-fetch supporting evidence articles inline with results. Default: true.",
      "type": "boolean"
    },
    "skip_skills": {
      "description": "If true, skip applying any enabled skills (Paralogy, Igloo, etc.) for this query only. Use when the user says \"without skills\", \"skip Paralogy\", or \"just the raw results\". Default: false.",
      "type": "boolean"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "graphId": {
      "type": "string",
      "description": "The graph ID. Use list_graphs to see all options. Examples: 'retail', 'tech', 'food', 'travel', 'beauty', 'sports', 'sic', 'pew', 'ce-design', 'ezra-eeman-wayfinder', 'dhl-ecommerce-trends-2026', 'automotive-color-trends', 'alyson-stevens-macro', 'generative-realities', 'pwc/sxsw-2026-key-insights', 'green-house/thrive-report', 'michaels-2026-creativity-trend-report', 'delta/the-connection-index'"
    },
    "seed_node_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of node IDs to start traversal from. MUST be actual node_id values from a prior search_graph result (e.g. [\"2507.0\"]). Node IDs are NOT sequential integers — do NOT guess or invent IDs like \"1\", \"2\", \"3\". Always call search_graph first to obtain valid IDs."
    },
    "userId": {
      "description": "Optional user identifier for trial usage tracking.",
      "type": "string"
    },
    "relationship_types": {
      "description": "Filter by relationship types: 'EVIDENCED_BY', 'RELATED_TO', 'SEMANTICALLY_SIMILAR', 'ASSOCIATED_BRAND', 'MENTIONS_BRAND', 'IN_LOCATION'",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "direction": {
      "description": "Traversal direction: 'out' (default) follows outgoing edges, 'in' follows incoming edges",
      "type": "string",
      "enum": [
        "in",
        "out"
      ]
    },
    "depth": {
      "description": "Traversal depth (default 1, max 2)",
      "type": "number"
    },
    "limit": {
      "description": "Maximum results (default 50)",
      "type": "number"
    }
  },
  "required": [
    "graphId",
    "seed_node_ids"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "graphId": {
      "type": "string",
      "description": "The graph ID. Use list_graphs to see all options. Examples: 'retail', 'tech', 'food', 'travel', 'beauty', 'sports', 'sic', 'pew', 'ce-design', 'ezra-eeman-wayfinder', 'dhl-ecommerce-trends-2026', 'automotive-color-trends', 'alyson-stevens-macro', 'generative-realities', 'pwc/sxsw-2026-key-insights', 'green-house/thrive-report', 'michaels-2026-creativity-trend-report', 'delta/the-connection-index'"
    },
    "for_node_id": {
      "type": "string",
      "description": "The node_id from a prior search_graph result (e.g. '2507.0'). MUST come from the search result's node_id field. Node IDs are NOT sequential integers — do NOT guess or invent IDs like '1', '2', '3'. Do NOT pass the trend name."
    },
    "userId": {
      "description": "Optional user identifier for trial usage tracking.",
      "type": "string"
    },
    "top_k": {
      "description": "Number of evidence items to return (default 5)",
      "type": "number"
    }
  },
  "required": [
    "graphId",
    "for_node_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "graphId": {
      "type": "string",
      "description": "The graph ID. Use list_graphs to see all options. Examples: 'retail', 'tech', 'food', 'travel', 'beauty', 'sports', 'sic', 'pew', 'ce-design', 'ezra-eeman-wayfinder', 'dhl-ecommerce-trends-2026', 'automotive-color-trends', 'alyson-stevens-macro', 'generative-realities', 'pwc/sxsw-2026-key-insights', 'green-house/thrive-report', 'michaels-2026-creativity-trend-report', 'delta/the-connection-index'"
    },
    "nodeId": {
      "type": "string",
      "description": "The node_id from a prior search_graph result (e.g. '2507.0'). MUST come from the search result's node_id field. Node IDs are NOT sequential integers — do NOT guess or invent IDs like '1', '2', '3'. Do NOT pass the trend name."
    },
    "userId": {
      "description": "Optional user identifier for trial usage tracking.",
      "type": "string"
    }
  },
  "required": [
    "graphId",
    "nodeId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "graphId": {
      "type": "string",
      "description": "The graph ID. Use list_graphs to see all options. Examples: 'retail', 'tech', 'food', 'travel', 'beauty', 'sports', 'sic', 'pew', 'ce-design', 'ezra-eeman-wayfinder', 'dhl-ecommerce-trends-2026', 'automotive-color-trends', 'alyson-stevens-macro', 'generative-realities', 'pwc/sxsw-2026-key-insights', 'green-house/thrive-report', 'michaels-2026-creativity-trend-report', 'delta/the-connection-index'"
    },
    "label": {
      "type": "string",
      "description": "The label to fetch values for (e.g., 'Brand', 'Location', 'Technology', 'Audience', 'RetailerType', 'Trend')"
    },
    "userId": {
      "description": "Optional user identifier for trial usage tracking.",
      "type": "string"
    },
    "property": {
      "description": "Optional property to return values for. Defaults vary by label.",
      "type": "string"
    }
  },
  "required": [
    "graphId",
    "label"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The topic or query to get supplemental data for (e.g., 'sustainable packaging', 'tequila spirits market', 'Gen Z beauty')"
    },
    "domain": {
      "description": "Domain hint to improve source routing: 'retail', 'beauty', 'fashion', 'sports', 'food', 'technology', 'culture', 'travel', 'design'. If omitted, inferred from query.",
      "type": "string"
    },
    "brands": {
      "description": "Brand names to include in demand/product lookups (e.g., ['Nike', 'Adidas']). Triggers Google Trends comparison and Amazon product search.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "graph_ids": {
      "description": "Graph IDs from prior search results — helps refine domain inference.",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "userId": {
      "description": "Optional user identifier for trial usage tracking.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "description": "The Job ID returned by get_supplemental_context"
    }
  },
  "required": [
    "job_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "chart_type": {
      "type": "string",
      "enum": [
        "cultural_shifts",
        "competitive_compass",
        "trend_constellation",
        "implication_ladder",
        "innovation_pathway",
        "opportunity_map"
      ],
      "description": "The type of visualization to generate"
    },
    "data": {
      "type": "string",
      "description": "JSON string containing the chart data. Structure depends on chart_type. cultural_shifts: {shifts:[{from,to}]}. competitive_compass: {brands:[{name,x,y}], axes:{left,right,top,bottom}}. trend_constellation: {trends:[{name,x,y}], connections:[{from,to,strength}]}. implication_ladder: {signal,trend,so_what,do_what}. innovation_pathway: {now,near_term,future}. opportunity_map: {items:[{name,consumer_desire,market_activity}]}"
    }
  },
  "required": [
    "chart_type",
    "data"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "The URL to read and extract content from"
    },
    "userId": {
      "description": "Optional user identifier for usage tracking.",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The research query/topic"
    },
    "graphId": {
      "description": "Optional specific graph ID to limit the research to",
      "type": "string"
    },
    "mode": {
      "description": "Research mode: \"light\" for faster single-pass (20 API calls), \"heavy\" for comprehensive multi-pass (30 API calls). Defaults to \"light\".",
      "type": "string",
      "enum": [
        "light",
        "heavy"
      ]
    },
    "depth": {
      "description": "Research depth: \"light\" for faster single-pass (20 API calls), \"heavy\" for comprehensive multi-pass (30 API calls). Defaults to \"light\".",
      "type": "string",
      "enum": [
        "light",
        "heavy"
      ]
    },
    "userId": {
      "description": "Optional user identifier.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "description": "The Job ID returned by deep_research_topic"
    }
  },
  "required": [
    "job_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}