{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "description": "Your question or request in natural language. Accepts query, q, prompt, text, input as aliases."
    },
    "query": {
      "type": "string",
      "description": "Alias for question."
    },
    "q": {
      "type": "string",
      "description": "Alias for question."
    },
    "prompt": {
      "type": "string",
      "description": "Alias for question."
    },
    "text": {
      "type": "string",
      "description": "Alias for question."
    },
    "input": {
      "type": "string",
      "description": "Alias for question."
    }
  },
  "required": [
    "question"
  ],
  "examples": [
    {
      "question": "What was Apple's revenue in 2024?"
    },
    {
      "question": "Any recent SEC filings for $NVDA?"
    },
    {
      "question": "Current price of bitcoin"
    }
  ]
}

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "description": "Your question in natural language. Accepts query, q, prompt, text, input as aliases."
    },
    "query": {
      "type": "string",
      "description": "Alias for question."
    },
    "q": {
      "type": "string",
      "description": "Alias for question."
    },
    "prompt": {
      "type": "string",
      "description": "Alias for question."
    },
    "text": {
      "type": "string",
      "description": "Alias for question."
    },
    "input": {
      "type": "string",
      "description": "Alias for question."
    }
  },
  "required": [
    "question"
  ]
}

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "description": "The document text to search inside (max ~200K chars)."
    },
    "query": {
      "type": "string",
      "description": "Natural-language query — what passages do you want? E.g. \"supply-chain risk\", \"fiscal year 2024 revenue\", \"drug interactions with warfarin\"."
    },
    "limit": {
      "type": "number",
      "description": "Max passages to return (1-20, default 5)."
    }
  },
  "required": [
    "text",
    "query"
  ]
}

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "description": "The research question, in natural language. Broad/multi-part is fine — decomposition is the point."
    },
    "depth": {
      "type": "string",
      "enum": [
        "quick",
        "standard",
        "thorough"
      ],
      "description": "How many facets to research in parallel: quick=3 (single hop), standard=5 (default; adds a gap-recovery hop that re-angles unanswered facets), thorough=8 (paid; adds a full iterative hop that chases leads + recovers gaps, plus a contradictions[] scan across findings)."
    }
  },
  "required": [
    "question"
  ]
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Natural language description of what you want to do (e.g., \"analyze housing market trends\", \"look up FDA drug approvals\", \"find trade data between countries\"). Accepts task, q, description, search as aliases."
    },
    "task": {
      "type": "string",
      "description": "Alias for query."
    },
    "q": {
      "type": "string",
      "description": "Alias for query."
    },
    "description": {
      "type": "string",
      "description": "Alias for query."
    },
    "search": {
      "type": "string",
      "description": "Alias for query."
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of tools to return (default 20, max 50)"
    }
  },
  "required": [
    "query"
  ],
  "examples": [
    {
      "query": "look up FDA drug approvals"
    },
    {
      "query": "analyze housing market trends"
    }
  ]
}

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "company",
        "drug"
      ],
      "description": "Entity type: \"company\" or \"drug\"."
    },
    "value": {
      "type": "string",
      "description": "For company: ticker (AAPL), CIK (0000320193), or name. For drug: brand or generic name (e.g., \"ozempic\", \"metformin\")."
    }
  },
  "required": [
    "type",
    "value"
  ]
}

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "company",
        "drug"
      ],
      "description": "Entity type: \"company\" or \"drug\"."
    },
    "values": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "For company: 2–5 tickers/CIKs (e.g., [\"AAPL\",\"MSFT\"]). For drug: 2–5 names (e.g., [\"ozempic\",\"mounjaro\"]).",
      "minItems": 2,
      "maxItems": 5
    }
  },
  "required": [
    "type",
    "values"
  ]
}

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "sec_8k",
        "polymarket_edge",
        "fred_series",
        "patent_grant",
        "clinical_trial"
      ],
      "description": "Subscription type."
    },
    "params": {
      "type": "object",
      "description": "Type-specific filter. sec_8k: {ticker:\"AAPL\", items?:[\"5.02\",\"1.01\"]}. polymarket_edge: {topic:\"fed\", min_spread_bps?:500}. fred_series: {series_id:\"UNRATE\"}. patent_grant: {applicant:\"Apple Inc.\"}. clinical_trial: {sponsor?:\"Pfizer\", condition?:\"lung cancer\", phase?:\"PHASE3\"} (sponsor or condition required)."
    },
    "delivery": {
      "type": "object",
      "description": "Optional delivery channels in addition to the always-on persistent feed. {email:\"you@x.com\"} sends a templated alert per fired event. {sms:\"+15551234567\"} sends an SMS per event — must match the verified phone on the caller's account (verify at https://pipeworx.io/account first; 10/day cap). {webhook:\"https://...\"} POSTs each event JSON to your endpoint, HMAC-signed — the response includes delivery.webhook_secret (whsec_…) ONCE; verify X-Pipeworx-Signature = sha256 HMAC of \"<X-Pipeworx-Timestamp>.<raw body>\". Auto-disabled after 10 consecutive failing runs.",
      "properties": {
        "email": {
          "type": "string",
          "description": "Email address to deliver alerts to. Validated against a standard pattern."
        },
        "sms": {
          "type": "string",
          "description": "E.164 phone number, e.g. \"+15551234567\". Must match the account's verified phone."
        },
        "webhook": {
          "type": "string",
          "description": "HTTPS URL to POST fired events to. https only; localhost/private hosts rejected. Signing secret returned once at subscribe time."
        }
      }
    }
  },
  "required": [
    "type",
    "params"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Subscription id (uuid) returned by subscribe."
    }
  },
  "required": [
    "id"
  ]
}

{
  "type": "object",
  "properties": {
    "include_inactive": {
      "type": "boolean",
      "description": "Include cancelled subscriptions in the response (default false)."
    }
  },
  "required": []
}

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "description": "Optional — filter to one subscription type."
    },
    "since": {
      "type": "string",
      "description": "Optional ISO timestamp — return events fired_at >= this time."
    },
    "limit": {
      "type": "number",
      "description": "Max events to return (1-200, default 50)."
    },
    "unread_only": {
      "type": "boolean",
      "description": "Return only events where read_at is null (default false)."
    },
    "mark_read": {
      "type": "boolean",
      "description": "Flag the returned events read in the same call (default false)."
    }
  },
  "required": []
}

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "company"
      ],
      "description": "Entity type. Only \"company\" supported today; person/place coming soon."
    },
    "value": {
      "type": "string",
      "description": "Ticker (e.g., \"AAPL\") or zero-padded CIK (e.g., \"0000320193\"). Names not supported — use resolve_entity first if you only have a name."
    }
  },
  "required": [
    "type",
    "value"
  ]
}

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "company"
      ],
      "description": "Entity type. Only \"company\" supported today."
    },
    "value": {
      "type": "string",
      "description": "Ticker (e.g., \"AAPL\") or zero-padded CIK (e.g., \"0000320193\")."
    },
    "since": {
      "type": "string",
      "description": "Window start — ISO date (\"2026-04-01\") or relative (\"7d\", \"30d\", \"3m\", \"1y\"). Use \"30d\" or \"1m\" for typical monitoring."
    }
  },
  "required": [
    "type",
    "value",
    "since"
  ]
}

{
  "type": "object",
  "properties": {
    "claim": {
      "type": "string",
      "description": "Natural-language factual claim, e.g., \"Apple's FY2024 revenue was $400 billion\" or \"Microsoft made about $100B in profit last year\"."
    }
  },
  "required": [
    "claim"
  ]
}

{
  "type": "object",
  "properties": {
    "package": {
      "type": "string",
      "description": "npm package name. Scoped packages (e.g. \"@types/node\") are accepted."
    },
    "version": {
      "type": "string",
      "description": "Specific version to check (e.g., \"18.3.1\"). Defaults to the latest published version when omitted."
    }
  },
  "required": [
    "package"
  ]
}

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string",
      "description": "Polymarket slug (\"will-bitcoin-hit-150k-by-june-30-2026\"), full URL (\"https://polymarket.com/event/...\"), or question text (\"Will Bitcoin hit $150k by June 30?\")"
    },
    "depth": {
      "type": "string",
      "enum": [
        "quick",
        "thorough"
      ],
      "description": "quick = 2-3 evidence sources, thorough = full fan-out. Default thorough."
    },
    "include_raw": {
      "type": "boolean",
      "description": "Default false. When false (recommended), FRED/FDA/GDELT/Federal-Register evidence is summarized to the few fields agents actually use — keeps responses under ~20KB. Pass true to get full upstream payloads (50KB-500KB) when you need to recompute deltas, cite specific observations, or post-process."
    }
  },
  "required": [
    "market"
  ],
  "examples": [
    {
      "market_input": "will fed cut rates in june 2026"
    },
    {
      "market_input": "https://polymarket.com/event/will-bitcoin-hit-150k-by-june-30-2026"
    }
  ]
}

{
  "type": "object",
  "properties": {
    "event": {
      "type": "string",
      "description": "Single-event mode (use this if you know the specific Polymarket event): event slug like \"fed-decision-may-2026\" or \"when-will-bitcoin-hit-150k\". Full Polymarket URLs also accepted."
    },
    "topic": {
      "type": "string",
      "description": "Cross-event mode (use this if you want to scan related events across the platform): a topic or seed question like \"Fed rate decision\" or \"Strait of Hormuz traffic returns to normal\". Tool searches Polymarket for related events and checks monotonicity across them."
    }
  }
}

{
  "type": "object",
  "properties": {
    "window": {
      "type": "string",
      "enum": [
        "24hr",
        "1wk",
        "1mo"
      ],
      "description": "Polymarket volume window to filter markets. Default 1wk."
    },
    "limit": {
      "type": "number",
      "description": "Top N edges to return after ranking. Default 10, max 25."
    },
    "min_edge_pp": {
      "type": "number",
      "description": "Minimum |edge| in percentage points to include (default 0.5). Edge is evaluated NET of slippage."
    },
    "slippage_pp": {
      "type": "number",
      "description": "Assumed execution slippage in percentage points per leg (default 0.3). Subtracted from raw |edge| before ranking and Kelly sizing. Polymarket has zero trading fees as of 2024 but bid/ask + thin depth typically eats 20-50bp per trade. Bump for very thin partitions; drop to 0 if you have a smarter fill model."
    },
    "category_filter": {
      "type": "string",
      "description": "Comma-separated list to restrict the output: \"model_driven\" (crypto_price + news_momentum), \"structural_arbitrage\" (partition_overround), \"concentrated_longshot\". Combine like \"model_driven,structural_arbitrage\". Default: all."
    },
    "min_kelly": {
      "type": "number",
      "description": "Minimum half-Kelly fraction (as decimal, e.g. 0.005 = 0.5% of bankroll) to include single-leg opportunities. Default 0 (no filter). Skips opportunities that are too small to bet sensibly even if the edge is large."
    },
    "min_partition_leg_kelly": {
      "type": "number",
      "description": "Minimum BEST per-leg half-Kelly fraction across a partition_overround opportunity's top_legs (or longshot_basket legs). Default 0 (no filter). Partition arbs always return kelly_fraction_half=0 at the parent level by design (basket trades don't compose to single-leg Kelly), so min_kelly never filters them — this knob applies to the per-leg Kelly inside top_legs instead. Use to suppress thin partitions whose individual leg edges aren't worth the per-leg slippage cost."
    },
    "min_liquidity": {
      "type": "number",
      "description": "Tradeable-edge filter. Minimum $ liquidity on the representative market (or for partition_overround, on at least one top_leg). Default 0 (no filter). Set to 5000 to drop thin-book opportunities where executing the edge would walk the book past breakeven."
    },
    "max_spread_pp": {
      "type": "number",
      "description": "Tradeable-edge filter. Maximum bid/ask spread in percentage points on the representative market. Default null (no filter). Set to 2 to require tight books — anything wider eats most plausible edges."
    }
  }
}

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "description": "Pre-mapped: fed | btc | cpi | gdp | sp500 | recession | next_pope | next_uk_pm | next_israel_pm | 2028_president"
    },
    "kalshi_event_ticker": {
      "type": "string",
      "description": "Explicit Kalshi event ticker, e.g. \"KXFED-26OCT\". Overrides the topic-mapped Kalshi side."
    },
    "polymarket_event_slug": {
      "type": "string",
      "description": "Explicit Polymarket event slug, e.g. \"fed-decision-in-june-825\". Overrides the topic-mapped Polymarket side."
    }
  },
  "examples": [
    {
      "topic": "fed"
    },
    {
      "topic": "btc"
    }
  ]
}

{
  "type": "object",
  "properties": {
    "market": {
      "type": "string",
      "description": "Single-market mode: market slug or full polymarket.com URL."
    },
    "event": {
      "type": "string",
      "description": "Basket mode: event slug or full polymarket.com URL — checks every leg of the partition."
    },
    "side": {
      "type": "string",
      "description": "Single-market: buy_yes | sell_yes | buy_no | sell_no (default buy_yes). Basket: sell_yes | buy_yes (default auto — sell if partition sum > 1, buy if < 1)."
    },
    "size_usd": {
      "type": "number",
      "description": "Single-market: USD to spend (buys) or target proceeds (sells). Basket: settlement notional — shares per leg, each paying $1 at resolution. Default 1000, clamp 10–1,000,000."
    }
  }
}

{
  "type": "object",
  "properties": {
    "days": {
      "type": "number",
      "description": "Lookback in days (default 14, clamp 2-30)."
    },
    "window": {
      "type": "string",
      "description": "Which polymarket_edges window family to read snapshots for: 24hr | 1wk | 1mo (default 1wk)."
    }
  }
}

{
  "type": "object",
  "properties": {
    "window": {
      "type": "string",
      "enum": [
        "24h",
        "7d",
        "30d"
      ],
      "description": "24h (default) | 7d | 30d. Shorter windows surface what's hot right now; longer windows show steady-state demand."
    }
  }
}

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "description": "Optional focus area: finance | pharma | economics | real-estate | betting | weather | government | science | news. Omit for a cross-category spread."
    }
  }
}

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Full URL of the site to summarize, e.g. \"https://example.com\" or a specific landing page."
    },
    "max_links": {
      "type": "number",
      "description": "Maximum number of link entries to include (default 25, max 50)."
    }
  },
  "required": [
    "url"
  ]
}

{
  "type": "object",
  "properties": {
    "entity": {
      "type": "string",
      "description": "The thing to ask about. Brand/business name, product name, person, or topic. E.g. \"Pipeworx\", \"OpenInvoice\", \"Acme Corp pricing\"."
    },
    "context": {
      "type": "string",
      "description": "Optional: a phrase locating the entity (e.g. \"Boston restaurant\", \"B2B SaaS\"). Helps disambiguate common names."
    },
    "models": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Which models to probe. Supported: \"workers-ai\" (free default), \"anthropic\" (requires _apiKey). Omit for just workers-ai."
    },
    "_apiKey": {
      "type": "string",
      "description": "Optional Anthropic API key (sk-ant-...) — only needed if \"anthropic\" is in models. Passed straight through to api.anthropic.com."
    }
  },
  "required": [
    "entity"
  ]
}

{
  "type": "object",
  "properties": {
    "entities": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of 2-8 entities to compare (brand/business/product names). First entry treated as the \"subject\" for narrative; rest are competitors."
    },
    "context": {
      "type": "string",
      "description": "Optional shared context applied to every probe (e.g. \"B2B SaaS\", \"Boston restaurant\"). Disambiguates common names."
    },
    "models": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Which models to probe. Supported: \"workers-ai\" (free default), \"anthropic\" (requires _apiKey). Omit for just workers-ai."
    },
    "_apiKey": {
      "type": "string",
      "description": "Optional Anthropic API key — only if \"anthropic\" is in models. Passed to api.anthropic.com per probe."
    }
  },
  "required": [
    "entities"
  ]
}

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "bug",
        "feature",
        "data_gap",
        "praise",
        "other"
      ],
      "description": "bug = something broke or returned wrong data. feature = a new tool or capability you wish existed. data_gap = data Pipeworx does not currently expose. praise = positive note. other = anything else."
    },
    "message": {
      "type": "string",
      "description": "Your feedback in plain text. Be specific (which tool, what error, what data was missing). 1-2 sentences typical, 2000 chars max."
    },
    "context": {
      "type": "object",
      "description": "Optional structured context: which tool, pack, or vertical this relates to.",
      "properties": {
        "tool": {
          "type": "string",
          "description": "Tool name (e.g., \"fred_get_series\")"
        },
        "pack": {
          "type": "string",
          "description": "Pack slug (e.g., \"fred\")"
        },
        "vertical": {
          "type": "string",
          "description": "Vertical (e.g., \"housing\")"
        }
      }
    }
  },
  "required": [
    "type",
    "message"
  ]
}

{
  "type": "object",
  "properties": {
    "key": {
      "type": "string",
      "description": "Memory key (e.g., \"subject_property\", \"target_ticker\", \"user_preference\")"
    },
    "value": {
      "type": "string",
      "description": "Value to store (any text — findings, addresses, preferences, notes)"
    }
  },
  "required": [
    "key",
    "value"
  ]
}

{
  "type": "object",
  "properties": {
    "key": {
      "type": "string",
      "description": "Memory key to retrieve (omit to list all keys)"
    }
  },
  "required": [],
  "examples": [
    {
      "key": "user_research_topic"
    },
    {}
  ]
}

{
  "type": "object",
  "properties": {
    "key": {
      "type": "string",
      "description": "Memory key to delete"
    }
  },
  "required": [
    "key"
  ],
  "examples": [
    {
      "key": "user_research_topic"
    }
  ]
}

{
  "type": "object",
  "properties": {
    "_apiKey": {
      "type": "string",
      "description": "YouTube Data API v3 key from Google Cloud Console"
    },
    "query": {
      "type": "string",
      "description": "Search term"
    },
    "type": {
      "type": "string",
      "description": "Resource type to search: \"video\", \"channel\", or \"playlist\" (default: \"video\")"
    },
    "max_results": {
      "type": "number",
      "description": "Number of results to return (default 10, max 50)"
    },
    "channel_id": {
      "type": "string",
      "description": "Filter results to a specific channel ID"
    },
    "order": {
      "type": "string",
      "description": "Sort order: \"date\", \"rating\", \"relevance\", or \"viewCount\" (default: \"relevance\")"
    },
    "published_after": {
      "type": "string",
      "description": "Filter results published after this ISO 8601 date (e.g. \"2024-01-01T00:00:00Z\")"
    }
  },
  "required": [
    "_apiKey",
    "query"
  ],
  "examples": [
    {
      "_apiKey": "your-youtube-api-key",
      "query": "machine learning tutorial"
    },
    {
      "_apiKey": "your-youtube-api-key",
      "query": "Python programming",
      "type": "video",
      "max_results": 20,
      "order": "viewCount",
      "published_after": "2024-01-01T00:00:00Z"
    }
  ]
}

{
  "type": "object",
  "properties": {
    "_apiKey": {
      "type": "string",
      "description": "YouTube Data API v3 key from Google Cloud Console"
    },
    "video_id": {
      "type": "string",
      "description": "Video ID or comma-separated list of video IDs (max 50)"
    }
  },
  "required": [
    "_apiKey",
    "video_id"
  ],
  "examples": [
    {
      "_apiKey": "your-youtube-api-key",
      "video_id": "dQw4w9WgXcQ"
    },
    {
      "_apiKey": "your-youtube-api-key",
      "video_id": "dQw4w9WgXcQ,9bZkp7q19f0"
    }
  ]
}

{
  "type": "object",
  "properties": {
    "_apiKey": {
      "type": "string",
      "description": "YouTube Data API v3 key from Google Cloud Console"
    },
    "channel_id": {
      "type": "string",
      "description": "Channel ID (starts with UC...)"
    },
    "username": {
      "type": "string",
      "description": "Channel username (alternative to channel_id)"
    }
  },
  "required": [
    "_apiKey"
  ],
  "examples": [
    {
      "_apiKey": "your-youtube-api-key",
      "channel_id": "UCkRfArvrzheW2E7b6SVV7vA"
    },
    {
      "_apiKey": "your-youtube-api-key",
      "username": "LinusTechTips"
    }
  ]
}

{
  "type": "object",
  "properties": {
    "_apiKey": {
      "type": "string",
      "description": "YouTube Data API v3 key from Google Cloud Console"
    },
    "channel_id": {
      "type": "string",
      "description": "Channel ID to list videos from"
    },
    "max_results": {
      "type": "number",
      "description": "Number of videos to return (default 10, max 50)"
    },
    "published_after": {
      "type": "string",
      "description": "Filter videos published after this ISO 8601 date"
    },
    "published_before": {
      "type": "string",
      "description": "Filter videos published before this ISO 8601 date"
    }
  },
  "required": [
    "_apiKey",
    "channel_id"
  ],
  "examples": [
    {
      "_apiKey": "your-youtube-api-key",
      "channel_id": "UCkRfArvrzheW2E7b6SVV7vA"
    },
    {
      "_apiKey": "your-youtube-api-key",
      "channel_id": "UCkRfArvrzheW2E7b6SVV7vA",
      "max_results": 25,
      "published_after": "2024-06-01T00:00:00Z"
    }
  ]
}

{
  "type": "object",
  "properties": {
    "_apiKey": {
      "type": "string",
      "description": "YouTube Data API v3 key from Google Cloud Console"
    },
    "video_id": {
      "type": "string",
      "description": "Video ID to fetch comments for"
    },
    "max_results": {
      "type": "number",
      "description": "Number of comment threads to return (default 20, max 100)"
    },
    "order": {
      "type": "string",
      "description": "Sort order: \"time\" or \"relevance\" (default: \"relevance\")"
    }
  },
  "required": [
    "_apiKey",
    "video_id"
  ],
  "examples": [
    {
      "_apiKey": "your-youtube-api-key",
      "video_id": "dQw4w9WgXcQ"
    },
    {
      "_apiKey": "your-youtube-api-key",
      "video_id": "dQw4w9WgXcQ",
      "max_results": 50,
      "order": "time"
    }
  ]
}