aiengineer.podhood.com

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "What to search for. Ask a natural-language question for a concept, or pass a specific name/term for an exact lookup — no special operators needed."
    },
    "topK": {
      "default": 10,
      "description": "Maximum number of episodes to return, ranked most-relevant first (max 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "maxSegmentsPerEpisode": {
      "default": 3,
      "description": "Quoted transcript segments per episode — the main token dial (max 20). Raise it when scoping to one episode with episodeIds.",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    },
    "includeText": {
      "default": true,
      "description": "Include the quoted segment text. Set false for a lighter list of episodes + citations.",
      "type": "boolean"
    },
    "fast": {
      "default": false,
      "description": "Skip the semantic pass for a faster, cheaper keyword-only search. Good for exact term/name lookups; a natural-language question loses recall.",
      "type": "boolean"
    },
    "episodeIds": {
      "description": "Restrict the search to specific episodes — pass episodeId(s) from a prior result to follow up within them. Omit to search the whole show.",
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}