{
  "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": {
    "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": {
    "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": {
    "analyst_id": {
      "type": "string",
      "description": "The analyst ID (e.g., 'ben-dietz-sic')"
    },
    "query": {
      "type": "string",
      "description": "The question or topic to discuss with the analyst"
    },
    "company": {
      "description": "Optional company name or stock ticker (e.g., 'Tesla' or 'TSLA') to bind the analyst to a specific brand context.",
      "type": "string"
    },
    "session_id": {
      "description": "Pass the session_id from a previous consult response to continue that engagement — the analyst keeps context and follow-ups cost less. Omit for a one-off question.",
      "type": "string"
    },
    "userId": {
      "description": "Optional user identifier.",
      "type": "string"
    }
  },
  "required": [
    "analyst_id",
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "analyst_id": {
      "type": "string",
      "description": "The analyst ID producing the deliverable (e.g., 'ben-dietz-sic'). See list_analysts."
    },
    "offering_key": {
      "type": "string",
      "description": "The offering to commission (e.g., 'marketing_plan'). See the `offerings` array on each analyst from list_analysts."
    },
    "brief": {
      "type": "string",
      "description": "2–5 sentences: audience, goal, constraints. Agents imitate the example in the tool description — be concrete."
    },
    "attachments": {
      "description": "Optional supporting text files mounted into the analyst's workspace (max 5).",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "content": {
            "type": "string"
          }
        },
        "required": [
          "content"
        ]
      }
    },
    "userId": {
      "description": "Optional user identifier.",
      "type": "string"
    }
  },
  "required": [
    "analyst_id",
    "offering_key",
    "brief"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "description": "The job_id returned by request_deliverable."
    },
    "userId": {
      "description": "Optional user identifier.",
      "type": "string"
    }
  },
  "required": [
    "job_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}