tako-sdk 0.1.4 → 1.0.1

package/dist/index.d.cts

@@ -1,99 +1,3419 @@
 /**
- * Tako API Types
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
  */
-declare enum SourceIndex {
-    TAKO = "tako",
-    WEB = "web"
+declare const BASE_PATH: string;
+interface ConfigurationParameters {
+    basePath?: string;
+    fetchApi?: FetchAPI;
+    middleware?: Middleware[];
+    queryParamsStringify?: (params: HTTPQuery) => string;
+    username?: string;
+    password?: string;
+    apiKey?: string | Promise<string> | ((name: string) => string | Promise<string>);
+    accessToken?: string | Promise<string> | ((name?: string, scopes?: string[]) => string | Promise<string>);
+    headers?: HTTPHeaders;
+    credentials?: RequestCredentials;
 }
-interface TakoConfig {
-    apiKey: string;
-    baseUrl?: string;
-    pathPrefix?: string;
+declare class Configuration {
+    private configuration;
+    constructor(configuration?: ConfigurationParameters);
+    set config(configuration: Configuration);
+    get basePath(): string;
+    get fetchApi(): FetchAPI | undefined;
+    get middleware(): Middleware[];
+    get queryParamsStringify(): (params: HTTPQuery) => string;
+    get username(): string | undefined;
+    get password(): string | undefined;
+    get apiKey(): ((name: string) => string | Promise<string>) | undefined;
+    get accessToken(): ((name?: string, scopes?: string[]) => string | Promise<string>) | undefined;
+    get headers(): HTTPHeaders | undefined;
+    get credentials(): RequestCredentials | undefined;
+}
+declare const DefaultConfig: Configuration;
+/**
+ * This is the base class for all generated API classes.
+ */
+declare class BaseAPI {
+    protected configuration: Configuration;
+    private static readonly jsonRegex;
+    private middleware;
+    constructor(configuration?: Configuration);
+    withMiddleware<T extends BaseAPI>(this: T, ...middlewares: Middleware[]): T;
+    withPreMiddleware<T extends BaseAPI>(this: T, ...preMiddlewares: Array<Middleware['pre']>): T;
+    withPostMiddleware<T extends BaseAPI>(this: T, ...postMiddlewares: Array<Middleware['post']>): T;
+    /**
+     * Check if the given MIME is a JSON MIME.
+     * JSON MIME examples:
+     *   application/json
+     *   application/json; charset=UTF8
+     *   APPLICATION/JSON
+     *   application/vnd.company+json
+     * @param mime - MIME (Multipurpose Internet Mail Extensions)
+     * @return True if the given MIME is JSON, false otherwise.
+     */
+    protected isJsonMime(mime: string | null | undefined): boolean;
+    protected request(context: RequestOpts, initOverrides?: RequestInit | InitOverrideFunction): Promise<Response>;
+    private createFetchParams;
+    private fetchApi;
+    /**
+     * Create a shallow clone of `this` by constructing a new instance
+     * and then shallow cloning data members.
+     */
+    private clone;
 }
-interface KnowledgeSearchInput {
-    text: string;
+declare class ResponseError extends Error {
+    response: Response;
+    name: "ResponseError";
+    constructor(response: Response, msg?: string);
 }
-interface KnowledgeSearchRequest {
-    inputs: KnowledgeSearchInput;
-    source_indexes?: SourceIndex[];
+declare class FetchError extends Error {
+    cause: Error;
+    name: "FetchError";
+    constructor(cause: Error, msg?: string);
 }
-interface Source {
-    source_name: string;
-    source_description: string;
-    source_index: string;
+declare class RequiredError extends Error {
+    field: string;
+    name: "RequiredError";
+    constructor(field: string, msg?: string);
+}
+declare const COLLECTION_FORMATS: {
+    csv: string;
+    ssv: string;
+    tsv: string;
+    pipes: string;
+};
+type FetchAPI = WindowOrWorkerGlobalScope['fetch'];
+type Json = any;
+type HTTPMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'OPTIONS' | 'HEAD';
+type HTTPHeaders = {
+    [key: string]: string;
+};
+type HTTPQuery = {
+    [key: string]: string | number | null | boolean | Array<string | number | null | boolean> | Set<string | number | null | boolean> | HTTPQuery;
+};
+type HTTPBody = Json | FormData | URLSearchParams;
+type HTTPRequestInit = {
+    headers?: HTTPHeaders;
+    method: HTTPMethod;
+    credentials?: RequestCredentials;
+    body?: HTTPBody;
+};
+type ModelPropertyNaming = 'camelCase' | 'snake_case' | 'PascalCase' | 'original';
+type InitOverrideFunction = (requestContext: {
+    init: HTTPRequestInit;
+    context: RequestOpts;
+}) => Promise<RequestInit>;
+interface FetchParams {
     url: string;
+    init: RequestInit;
 }
-interface Methodology {
-    methodology_name: string;
-    methodology_description?: string;
+interface RequestOpts {
+    path: string;
+    method: HTTPMethod;
+    headers: HTTPHeaders;
+    query?: HTTPQuery;
+    body?: HTTPBody;
 }
-interface KnowledgeCard {
-    card_id: string;
-    title: string;
-    description: string;
-    webpage_url: string;
-    image_url: string;
-    embed_url: string;
-    sources: Source[];
-    methodologies?: Methodology[];
-}
-interface KnowledgeSearchResponse {
-    outputs: {
-        knowledge_cards: KnowledgeCard[];
-    };
+declare function querystring(params: HTTPQuery, prefix?: string): string;
+declare function exists(json: any, key: string): boolean;
+declare function mapValues(data: any, fn: (item: any) => any): {
+    [key: string]: any;
+};
+declare function canConsumeForm(consumes: Consume[]): boolean;
+interface Consume {
+    contentType: string;
 }
-interface TakoError {
-    status: number;
-    message: string;
-    details?: any;
+interface RequestContext {
+    fetch: FetchAPI;
+    url: string;
+    init: RequestInit;
+}
+interface ResponseContext {
+    fetch: FetchAPI;
+    url: string;
+    init: RequestInit;
+    response: Response;
+}
+interface ErrorContext {
+    fetch: FetchAPI;
+    url: string;
+    init: RequestInit;
+    error: unknown;
+    response?: Response;
+}
+interface Middleware {
+    pre?(context: RequestContext): Promise<FetchParams | void>;
+    post?(context: ResponseContext): Promise<Response | void>;
+    onError?(context: ErrorContext): Promise<Response | void>;
+}
+interface ApiResponse<T> {
+    raw: Response;
+    value(): Promise<T>;
+}
+interface ResponseTransformer<T> {
+    (json: any): T;
+}
+declare class JSONApiResponse<T> {
+    raw: Response;
+    private transformer;
+    constructor(raw: Response, transformer?: ResponseTransformer<T>);
+    value(): Promise<T>;
+}
+declare class VoidApiResponse {
+    raw: Response;
+    constructor(raw: Response);
+    value(): Promise<void>;
+}
+declare class BlobApiResponse {
+    raw: Response;
+    constructor(raw: Response);
+    value(): Promise<Blob>;
+}
+declare class TextApiResponse {
+    raw: Response;
+    constructor(raw: Response);
+    value(): Promise<string>;
+}
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface KnowledgeCardMethodology
+ */
+interface KnowledgeCardMethodology {
+    /**
+     * The name of the methodology
+     * @type {string}
+     * @memberof KnowledgeCardMethodology
+     */
+    methodology_name: string | null;
+    /**
+     * The description of the methodology
+     * @type {string}
+     * @memberof KnowledgeCardMethodology
+     */
+    methodology_description: string | null;
+}
+/**
+ * Check if a given object implements the KnowledgeCardMethodology interface.
+ */
+declare function instanceOfKnowledgeCardMethodology(value: object): value is KnowledgeCardMethodology;
+declare function KnowledgeCardMethodologyFromJSON(json: any): KnowledgeCardMethodology;
+declare function KnowledgeCardMethodologyFromJSONTyped(json: any, ignoreDiscriminator: boolean): KnowledgeCardMethodology;
+declare function KnowledgeCardMethodologyToJSON(json: any): KnowledgeCardMethodology;
+declare function KnowledgeCardMethodologyToJSONTyped(value?: KnowledgeCardMethodology | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ */
+declare const CardSourceIndex: {
+    readonly Tako: "tako";
+    readonly Web: "web";
+    readonly ConnectedData: "connected_data";
+    readonly TakoDeepV2: "tako_deep_v2";
+};
+type CardSourceIndex = typeof CardSourceIndex[keyof typeof CardSourceIndex];
+declare function instanceOfCardSourceIndex(value: any): boolean;
+declare function CardSourceIndexFromJSON(json: any): CardSourceIndex;
+declare function CardSourceIndexFromJSONTyped(json: any, ignoreDiscriminator: boolean): CardSourceIndex;
+declare function CardSourceIndexToJSON(value?: CardSourceIndex | null): any;
+declare function CardSourceIndexToJSONTyped(value: any, ignoreDiscriminator: boolean): CardSourceIndex;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ *
+ * @export
+ * @interface KnowledgeCardSourceIndexesInner
+ */
+interface KnowledgeCardSourceIndexesInner {
+    /**
+     *
+     * @type {CardSourceIndex}
+     * @memberof KnowledgeCardSourceIndexesInner
+     */
+    index_type: CardSourceIndex;
+    /**
+     * An ID for a segment of a source index
+     * @type {string}
+     * @memberof KnowledgeCardSourceIndexesInner
+     */
+    segment_id: string;
+}
+/**
+ * Check if a given object implements the KnowledgeCardSourceIndexesInner interface.
+ */
+declare function instanceOfKnowledgeCardSourceIndexesInner(value: object): value is KnowledgeCardSourceIndexesInner;
+declare function KnowledgeCardSourceIndexesInnerFromJSON(json: any): KnowledgeCardSourceIndexesInner;
+declare function KnowledgeCardSourceIndexesInnerFromJSONTyped(json: any, ignoreDiscriminator: boolean): KnowledgeCardSourceIndexesInner;
+declare function KnowledgeCardSourceIndexesInnerToJSON(json: any): KnowledgeCardSourceIndexesInner;
+declare function KnowledgeCardSourceIndexesInnerToJSONTyped(value?: KnowledgeCardSourceIndexesInner | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * The index of the source
+ * @export
+ * @interface SourceIndex
+ */
+interface SourceIndex {
+    /**
+     *
+     * @type {CardSourceIndex}
+     * @memberof SourceIndex
+     */
+    index_type: CardSourceIndex;
+    /**
+     * An ID for a segment of a source index (optional for private indexes)
+     * @type {string}
+     * @memberof SourceIndex
+     */
+    segment_id: string;
+    /**
+     * An ID for a private index
+     * @type {string}
+     * @memberof SourceIndex
+     */
+    private_index_id: string;
+}
+/**
+ * Check if a given object implements the SourceIndex interface.
+ */
+declare function instanceOfSourceIndex(value: object): value is SourceIndex;
+declare function SourceIndexFromJSON(json: any): SourceIndex;
+declare function SourceIndexFromJSONTyped(json: any, ignoreDiscriminator: boolean): SourceIndex;
+declare function SourceIndexToJSON(json: any): SourceIndex;
+declare function SourceIndexToJSONTyped(value?: SourceIndex | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ *
+ * @export
+ * @interface KnowledgeCardSource
+ */
+interface KnowledgeCardSource {
+    /**
+     * The name of the source
+     * @type {string}
+     * @memberof KnowledgeCardSource
+     */
+    source_name: string | null;
+    /**
+     * The description of the source
+     * @type {string}
+     * @memberof KnowledgeCardSource
+     */
+    source_description: string | null;
+    /**
+     *
+     * @type {SourceIndex}
+     * @memberof KnowledgeCardSource
+     */
+    source_index: SourceIndex;
+    /**
+     * The URL of the source
+     * @type {string}
+     * @memberof KnowledgeCardSource
+     */
+    url: string | null;
+    /**
+     * Raw excerpt(s) retrieved from the source page — the unmodified web content the answer was grounded in, NOT the synthesized answer. Populated for WEB sources; null for sources that don't carry an extracted excerpt (e.g. TAKO sources).
+     * @type {string}
+     * @memberof KnowledgeCardSource
+     */
+    source_text?: string | null;
+}
+/**
+ * Check if a given object implements the KnowledgeCardSource interface.
+ */
+declare function instanceOfKnowledgeCardSource(value: object): value is KnowledgeCardSource;
+declare function KnowledgeCardSourceFromJSON(json: any): KnowledgeCardSource;
+declare function KnowledgeCardSourceFromJSONTyped(json: any, ignoreDiscriminator: boolean): KnowledgeCardSource;
+declare function KnowledgeCardSourceToJSON(json: any): KnowledgeCardSource;
+declare function KnowledgeCardSourceToJSONTyped(value?: KnowledgeCardSource | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ */
+declare const ContentFormat: {
+    readonly Csv: "csv";
+    readonly Text: "text";
+};
+type ContentFormat = typeof ContentFormat[keyof typeof ContentFormat];
+declare function instanceOfContentFormat(value: any): boolean;
+declare function ContentFormatFromJSON(json: any): ContentFormat;
+declare function ContentFormatFromJSONTyped(json: any, ignoreDiscriminator: boolean): ContentFormat;
+declare function ContentFormatToJSON(value?: ContentFormat | null): any;
+declare function ContentFormatToJSONTyped(value: any, ignoreDiscriminator: boolean): ContentFormat;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * Describes the downloadable content behind a result. `cost` is the USD the
+ * /contents call will charge for this result (Tako card CSV is free; web text is
+ * the canonical Contents rate). The inline fields (`data`/`total_rows`/
+ * `truncated`) are populated only by auto-contents / `/contents` inline mode;
+ * when unset, this is just the quote (format + cost), fetched later via the
+ * Contents endpoint (a Tako card URL -> ChartConfig -> CSV; any other URL ->
+ * page text).
+ * @export
+ * @interface ResultContent
+ */
+interface ResultContent {
+    /**
+     *
+     * @type {ContentFormat}
+     * @memberof ResultContent
+     */
+    format: ContentFormat;
+    /**
+     *
+     * @type {number}
+     * @memberof ResultContent
+     */
+    cost?: number;
+    /**
+     *
+     * @type {string}
+     * @memberof ResultContent
+     */
+    data?: string | null;
+    /**
+     *
+     * @type {number}
+     * @memberof ResultContent
+     */
+    total_rows?: number | null;
+    /**
+     *
+     * @type {boolean}
+     * @memberof ResultContent
+     */
+    truncated?: boolean;
+}
+/**
+ * Check if a given object implements the ResultContent interface.
+ */
+declare function instanceOfResultContent(value: object): value is ResultContent;
+declare function ResultContentFromJSON(json: any): ResultContent;
+declare function ResultContentFromJSONTyped(json: any, ignoreDiscriminator: boolean): ResultContent;
+declare function ResultContentToJSON(json: any): ResultContent;
+declare function ResultContentToJSONTyped(value?: ResultContent | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ */
+declare const KnowledgeCardRelevance: {
+    readonly High: "High";
+    readonly Medium: "Medium";
+    readonly Low: "Low";
+};
+type KnowledgeCardRelevance = typeof KnowledgeCardRelevance[keyof typeof KnowledgeCardRelevance];
+declare function instanceOfKnowledgeCardRelevance(value: any): boolean;
+declare function KnowledgeCardRelevanceFromJSON(json: any): KnowledgeCardRelevance;
+declare function KnowledgeCardRelevanceFromJSONTyped(json: any, ignoreDiscriminator: boolean): KnowledgeCardRelevance;
+declare function KnowledgeCardRelevanceToJSON(value?: KnowledgeCardRelevance | null): any;
+declare function KnowledgeCardRelevanceToJSONTyped(value: any, ignoreDiscriminator: boolean): KnowledgeCardRelevance;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * A Tako knowledge card on the new search/answer surface. Mirrors the
+ * legacy KnowledgeCard minus data_url / visualization_data / ideal_viz_decisions,
+ * plus a `content` download descriptor.
+ * @export
+ * @interface TakoCard
+ */
+interface TakoCard {
+    /**
+     *
+     * @type {string}
+     * @memberof TakoCard
+     */
+    card_id?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof TakoCard
+     */
+    title?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof TakoCard
+     */
+    description?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof TakoCard
+     */
+    semantic_description?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof TakoCard
+     */
+    webpage_url?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof TakoCard
+     */
+    image_url?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof TakoCard
+     */
+    embed_url?: string | null;
+    /**
+     *
+     * @type {Array<KnowledgeCardSource>}
+     * @memberof TakoCard
+     */
+    sources?: Array<KnowledgeCardSource> | null;
+    /**
+     *
+     * @type {Array<KnowledgeCardMethodology>}
+     * @memberof TakoCard
+     */
+    methodologies?: Array<KnowledgeCardMethodology> | null;
+    /**
+     *
+     * @type {Array<KnowledgeCardSourceIndexesInner>}
+     * @memberof TakoCard
+     */
+    source_indexes?: Array<KnowledgeCardSourceIndexesInner> | null;
+    /**
+     *
+     * @type {string}
+     * @memberof TakoCard
+     */
+    card_type?: string | null;
+    /**
+     *
+     * @type {KnowledgeCardRelevance}
+     * @memberof TakoCard
+     */
+    relevance?: KnowledgeCardRelevance | null;
+    /**
+     *
+     * @type {ResultContent}
+     * @memberof TakoCard
+     */
+    content?: ResultContent | null;
 }
-declare class TakoException extends Error {
-    status: number;
-    details?: any | undefined;
-    constructor(status: number, message: string, details?: any | undefined);
+/**
+ * Check if a given object implements the TakoCard interface.
+ */
+declare function instanceOfTakoCard(value: object): value is TakoCard;
+declare function TakoCardFromJSON(json: any): TakoCard;
+declare function TakoCardFromJSONTyped(json: any, ignoreDiscriminator: boolean): TakoCard;
+declare function TakoCardToJSON(json: any): TakoCard;
+declare function TakoCardToJSONTyped(value?: TakoCard | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * A single raw web search result returned by the WEB source index.
+ *
+ * Distinct from `KnowledgeCardSource` (a citation inside a synthesized
+ * answer) and `KnowledgeCard` (a Tako visualization). Web results are
+ * raw retrieval output — title, URL, optional snippet — independent of
+ * any LLM synthesis that may also happen over them.
+ * @export
+ * @interface WebResult
+ */
+interface WebResult {
+    /**
+     * Title of the web page.
+     * @type {string}
+     * @memberof WebResult
+     */
+    title: string;
+    /**
+     * URL of the web page.
+     * @type {string}
+     * @memberof WebResult
+     */
+    url: string;
+    /**
+     * Excerpt(s) from the page that matched the query.
+     * @type {string}
+     * @memberof WebResult
+     */
+    snippet?: string | null;
+    /**
+     * Publisher / domain name, when extractable from the URL.
+     * @type {string}
+     * @memberof WebResult
+     */
+    source_name?: string | null;
+    /**
+     * Publication date of the page, when available.
+     * @type {string}
+     * @memberof WebResult
+     */
+    publish_date?: string | null;
+    /**
+     * Downloadable content descriptor for this result, fetched via the Contents endpoint. Web results are always downloadable as text. None for callers that do not populate it.
+     * @type {ResultContent}
+     * @memberof WebResult
+     */
+    content?: ResultContent | null;
+    /**
+     * 1-based citation number that the answer's inline [N] markers reference. Set only when the answer inline-cites this result (the Agent API); None on raw-retrieval surfaces.
+     * @type {number}
+     * @memberof WebResult
+     */
+    citation_number?: number | null;
 }
-declare class TakoUnauthorizedException extends TakoException {
-    constructor(message?: string, details?: any);
+/**
+ * Check if a given object implements the WebResult interface.
+ */
+declare function instanceOfWebResult(value: object): value is WebResult;
+declare function WebResultFromJSON(json: any): WebResult;
+declare function WebResultFromJSONTyped(json: any, ignoreDiscriminator: boolean): WebResult;
+declare function WebResultToJSON(json: any): WebResult;
+declare function WebResultToJSONTyped(value?: WebResult | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * Final agent output. answer is markdown; cards reuse the sibling TakoCard.
+ * @export
+ * @interface AgentResult
+ */
+interface AgentResult {
+    /**
+     *
+     * @type {string}
+     * @memberof AgentResult
+     */
+    answer?: string | null;
+    /**
+     *
+     * @type {Array<TakoCard>}
+     * @memberof AgentResult
+     */
+    cards?: Array<TakoCard>;
+    /**
+     *
+     * @type {Array<WebResult>}
+     * @memberof AgentResult
+     */
+    web_results?: Array<WebResult>;
+    /**
+     *
+     * @type {string}
+     * @memberof AgentResult
+     */
+    request_id?: string | null;
 }
-declare class TakoRateLimitException extends TakoException {
-    constructor(message?: string, details?: any);
+/**
+ * Check if a given object implements the AgentResult interface.
+ */
+declare function instanceOfAgentResult(value: object): value is AgentResult;
+declare function AgentResultFromJSON(json: any): AgentResult;
+declare function AgentResultFromJSONTyped(json: any, ignoreDiscriminator: boolean): AgentResult;
+declare function AgentResultToJSON(json: any): AgentResult;
+declare function AgentResultToJSONTyped(value?: AgentResult | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ */
+declare const AgentRunStatus: {
+    readonly Queued: "queued";
+    readonly Running: "running";
+    readonly Completed: "completed";
+    readonly Failed: "failed";
+};
+type AgentRunStatus = typeof AgentRunStatus[keyof typeof AgentRunStatus];
+declare function instanceOfAgentRunStatus(value: any): boolean;
+declare function AgentRunStatusFromJSON(json: any): AgentRunStatus;
+declare function AgentRunStatusFromJSONTyped(json: any, ignoreDiscriminator: boolean): AgentRunStatus;
+declare function AgentRunStatusToJSON(value?: AgentRunStatus | null): any;
+declare function AgentRunStatusToJSONTyped(value: any, ignoreDiscriminator: boolean): AgentRunStatus;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface ErrorObject
+ */
+interface ErrorObject {
+    /**
+     *
+     * @type {string}
+     * @memberof ErrorObject
+     */
+    code: string;
+    /**
+     *
+     * @type {string}
+     * @memberof ErrorObject
+     */
+    message: string;
 }
+/**
+ * Check if a given object implements the ErrorObject interface.
+ */
+declare function instanceOfErrorObject(value: object): value is ErrorObject;
+declare function ErrorObjectFromJSON(json: any): ErrorObject;
+declare function ErrorObjectFromJSONTyped(json: any, ignoreDiscriminator: boolean): ErrorObject;
+declare function ErrorObjectToJSON(json: any): ErrorObject;
+declare function ErrorObjectToJSONTyped(value?: ErrorObject | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
 
 /**
- * Tako API Client
+ * The run resource returned by dispatch (202) and poll (GET).
+ * @export
+ * @interface AgentRun
  */
-declare class TakoClient {
-    private apiKey;
-    private baseUrl;
-    private pathPrefix;
+interface AgentRun {
+    /**
+     *
+     * @type {string}
+     * @memberof AgentRun
+     */
+    run_id: string;
+    /**
+     *
+     * @type {AgentRunObjectEnum}
+     * @memberof AgentRun
+     */
+    object?: AgentRunObjectEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof AgentRun
+     */
+    thread_id?: string | null;
+    /**
+     *
+     * @type {AgentRunStatus}
+     * @memberof AgentRun
+     */
+    status: AgentRunStatus;
+    /**
+     *
+     * @type {string}
+     * @memberof AgentRun
+     */
+    created_at: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AgentRun
+     */
+    completed_at?: string | null;
     /**
-     * Create a new Tako API client
-     * @param config Configuration for the Tako API client
+     *
+     * @type {AgentResult}
+     * @memberof AgentRun
      */
-    constructor(config: TakoConfig);
+    result?: AgentResult | null;
     /**
-     * Make a request to the Tako API
-     * @param path API endpoint path
-     * @param method HTTP method
-     * @param body Request body
-     * @returns Response data
+     *
+     * @type {ErrorObject}
+     * @memberof AgentRun
      */
-    private request;
+    error?: ErrorObject | null;
+}
+/**
+ * @export
+ */
+declare const AgentRunObjectEnum: {
+    readonly AgentRun: "agent.run";
+};
+type AgentRunObjectEnum = typeof AgentRunObjectEnum[keyof typeof AgentRunObjectEnum];
+/**
+ * Check if a given object implements the AgentRun interface.
+ */
+declare function instanceOfAgentRun(value: object): value is AgentRun;
+declare function AgentRunFromJSON(json: any): AgentRun;
+declare function AgentRunFromJSONTyped(json: any, ignoreDiscriminator: boolean): AgentRun;
+declare function AgentRunToJSON(json: any): AgentRun;
+declare function AgentRunToJSONTyped(value?: AgentRun | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Public effort taxonomy for the Agent API. Only MEDIUM is supported in v1;
+ * the generated OpenAPI/SDK advertises exactly these members, so we add values
+ * (low/high) only as the agent gains public support for them.
+ * @export
+ */
+declare const AgentEffortLevel: {
+    readonly Medium: "medium";
+};
+type AgentEffortLevel = typeof AgentEffortLevel[keyof typeof AgentEffortLevel];
+declare function instanceOfAgentEffortLevel(value: any): boolean;
+declare function AgentEffortLevelFromJSON(json: any): AgentEffortLevel;
+declare function AgentEffortLevelFromJSONTyped(json: any, ignoreDiscriminator: boolean): AgentEffortLevel;
+declare function AgentEffortLevelToJSON(value?: AgentEffortLevel | null): any;
+declare function AgentEffortLevelToJSONTyped(value: any, ignoreDiscriminator: boolean): AgentEffortLevel;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface AgentOutputSettings
+ */
+interface AgentOutputSettings {
     /**
-     * Search Tako Knowledge using natural language
-     * @param text The natural language query text
-     * @param sourceIndexes Optional array of source indexes to search within
-     * @returns Knowledge search results
+     * Render card preview images in dark mode. Omit to use the default (dark).
+     * @type {boolean}
+     * @memberof AgentOutputSettings
      */
-    knowledgeSearch(text: string, sourceIndexes?: SourceIndex[]): Promise<KnowledgeSearchResponse>;
+    image_dark_mode?: boolean | null;
 }
+/**
+ * Check if a given object implements the AgentOutputSettings interface.
+ */
+declare function instanceOfAgentOutputSettings(value: object): value is AgentOutputSettings;
+declare function AgentOutputSettingsFromJSON(json: any): AgentOutputSettings;
+declare function AgentOutputSettingsFromJSONTyped(json: any, ignoreDiscriminator: boolean): AgentOutputSettings;
+declare function AgentOutputSettingsToJSON(json: any): AgentOutputSettings;
+declare function AgentOutputSettingsToJSONTyped(value?: AgentOutputSettings | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
 
 /**
- * Create a new Tako API client
- * @param apiKey Your Tako API key
- * @param baseUrl Optional base URL for the Tako API
- * @returns A configured Tako client
+ *
+ * @export
+ * @interface AgentRunRequest
  */
-declare function createTakoClient(apiKey: string, baseUrl?: string): TakoClient;
+interface AgentRunRequest {
+    /**
+     * Natural-language request for the agent.
+     * @type {string}
+     * @memberof AgentRunRequest
+     */
+    query: string;
+    /**
+     * Existing thread to continue (follow-up). Omit to start a new thread.
+     * @type {string}
+     * @memberof AgentRunRequest
+     */
+    thread_id?: string | null;
+    /**
+     * Agent effort level. Only 'medium' is currently supported.
+     * @type {AgentEffortLevel}
+     * @memberof AgentRunRequest
+     */
+    effort?: AgentEffortLevel;
+    /**
+     * Which sources the agent may use: 'tako' (connected data) and/or 'web' (open-web search). Defaults to ['tako'].
+     * @type {Array<AgentRunRequestSourceIndexesEnum>}
+     * @memberof AgentRunRequest
+     */
+    source_indexes?: Array<AgentRunRequestSourceIndexesEnum>;
+    /**
+     * BCP-47 locale. Drives the language of the agent's answer (a non-English locale makes the agent respond in that language) and the locale used when rendering card preview images. Defaults to en-US.
+     * @type {string}
+     * @memberof AgentRunRequest
+     */
+    locale?: string;
+    /**
+     * IANA timezone (e.g. 'America/New_York') used to render dates/times in card preview images. Does not affect the returned data.
+     * @type {string}
+     * @memberof AgentRunRequest
+     */
+    timezone?: string | null;
+    /**
+     * Settings controlling the response/rendering.
+     * @type {AgentOutputSettings}
+     * @memberof AgentRunRequest
+     */
+    output_settings?: AgentOutputSettings | null;
+}
+/**
+ * @export
+ */
+declare const AgentRunRequestSourceIndexesEnum: {
+    readonly Tako: "tako";
+    readonly Web: "web";
+};
+type AgentRunRequestSourceIndexesEnum = typeof AgentRunRequestSourceIndexesEnum[keyof typeof AgentRunRequestSourceIndexesEnum];
+/**
+ * Check if a given object implements the AgentRunRequest interface.
+ */
+declare function instanceOfAgentRunRequest(value: object): value is AgentRunRequest;
+declare function AgentRunRequestFromJSON(json: any): AgentRunRequest;
+declare function AgentRunRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): AgentRunRequest;
+declare function AgentRunRequestToJSON(json: any): AgentRunRequest;
+declare function AgentRunRequestToJSONTyped(value?: AgentRunRequest | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+interface CreateAgentRunRequest {
+    agentRunRequest?: AgentRunRequest;
+}
+interface GetAgentRunRequest {
+    runId: string | null;
+    startingAfter?: number;
+}
+/**
+ * AgentApi - interface
+ *
+ * @export
+ * @interface AgentApiInterface
+ */
+interface AgentApiInterface {
+    /**
+     * Creates request options for createAgentRun without sending the request
+     * @param {AgentRunRequest} [agentRunRequest]
+     * @throws {RequiredError}
+     * @memberof AgentApiInterface
+     */
+    createAgentRunRequestOpts(requestParameters: CreateAgentRunRequest): Promise<RequestOpts>;
+    /**
+     * Dispatch a deep-research agent run. Returns 202 with an AgentRun object; poll GET /v1/agent/runs/{run_id} until status is \'completed\' or \'failed\'.
+     * @summary Dispatch an agent run
+     * @param {AgentRunRequest} [agentRunRequest]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AgentApiInterface
+     */
+    createAgentRunRaw(requestParameters: CreateAgentRunRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<ApiResponse<AgentRun>>;
+    /**
+     * Dispatch a deep-research agent run. Returns 202 with an AgentRun object; poll GET /v1/agent/runs/{run_id} until status is \'completed\' or \'failed\'.
+     * Dispatch an agent run
+     */
+    createAgentRun(requestParameters: CreateAgentRunRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<AgentRun>;
+    /**
+     * Creates request options for getAgentRun without sending the request
+     * @param {string} runId Run ID returned by POST /v1/agent/runs
+     * @param {number} [startingAfter] SSE resume cursor (Accept: text/event-stream only). Replay events with seq strictly greater than this value. Equivalent to the Last-Event-ID header.
+     * @throws {RequiredError}
+     * @memberof AgentApiInterface
+     */
+    getAgentRunRequestOpts(requestParameters: GetAgentRunRequest): Promise<RequestOpts>;
+    /**
+     * Retrieve the current state of an agent run. Poll until status is \'completed\' or \'failed\'. result is populated when status is \'completed\'.
+     * @summary Poll an agent run
+     * @param {string} runId Run ID returned by POST /v1/agent/runs
+     * @param {number} [startingAfter] SSE resume cursor (Accept: text/event-stream only). Replay events with seq strictly greater than this value. Equivalent to the Last-Event-ID header.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof AgentApiInterface
+     */
+    getAgentRunRaw(requestParameters: GetAgentRunRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<ApiResponse<AgentRun>>;
+    /**
+     * Retrieve the current state of an agent run. Poll until status is \'completed\' or \'failed\'. result is populated when status is \'completed\'.
+     * Poll an agent run
+     */
+    getAgentRun(requestParameters: GetAgentRunRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<AgentRun>;
+}
+/**
+ *
+ */
+declare class AgentApi extends BaseAPI implements AgentApiInterface {
+    /**
+     * Creates request options for createAgentRun without sending the request
+     */
+    createAgentRunRequestOpts(requestParameters: CreateAgentRunRequest): Promise<RequestOpts>;
+    /**
+     * Dispatch a deep-research agent run. Returns 202 with an AgentRun object; poll GET /v1/agent/runs/{run_id} until status is \'completed\' or \'failed\'.
+     * Dispatch an agent run
+     */
+    createAgentRunRaw(requestParameters: CreateAgentRunRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<ApiResponse<AgentRun>>;
+    /**
+     * Dispatch a deep-research agent run. Returns 202 with an AgentRun object; poll GET /v1/agent/runs/{run_id} until status is \'completed\' or \'failed\'.
+     * Dispatch an agent run
+     */
+    createAgentRun(requestParameters?: CreateAgentRunRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<AgentRun>;
+    /**
+     * Creates request options for getAgentRun without sending the request
+     */
+    getAgentRunRequestOpts(requestParameters: GetAgentRunRequest): Promise<RequestOpts>;
+    /**
+     * Retrieve the current state of an agent run. Poll until status is \'completed\' or \'failed\'. result is populated when status is \'completed\'.
+     * Poll an agent run
+     */
+    getAgentRunRaw(requestParameters: GetAgentRunRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<ApiResponse<AgentRun>>;
+    /**
+     * Retrieve the current state of an agent run. Poll until status is \'completed\' or \'failed\'. result is populated when status is \'completed\'.
+     * Poll an agent run
+     */
+    getAgentRun(requestParameters: GetAgentRunRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<AgentRun>;
+}
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * Response for POST /api/v1/answer — synthesized answer + retrieval.
+ * @export
+ * @interface AnswerResponse
+ */
+interface AnswerResponse {
+    /**
+     * Synthesized text answer.
+     * @type {string}
+     * @memberof AnswerResponse
+     */
+    answer: string;
+    /**
+     * Tako cards backing the answer; cards[0] is the lead card — the best one to show alongside the answer.
+     * @type {Array<TakoCard>}
+     * @memberof AnswerResponse
+     */
+    cards?: Array<TakoCard>;
+    /**
+     *
+     * @type {Array<WebResult>}
+     * @memberof AnswerResponse
+     */
+    web_results?: Array<WebResult>;
+    /**
+     * Total quoted USD cost of the data inlined on this response — the summed per-fetch price of the results whose payload was populated (one charge per distinct extracted web URL; Tako card CSV is free). This is the QUOTE, not necessarily the amount billed: on a depleted prepaid (PAYG) balance the charge is clamped to the remaining balance, so the amount actually drawn can be less. A result's own `cost` is a per-fetch quote present whenever it is downloadable, so a result that was requested but whose extraction was skipped or failed still carries its quote; that un-inlined quote is excluded here. 0 when no contents were inlined.
+     * @type {number}
+     * @memberof AnswerResponse
+     */
+    contents_total_cost?: number;
+    /**
+     *
+     * @type {string}
+     * @memberof AnswerResponse
+     */
+    request_id: string;
+}
+/**
+ * Check if a given object implements the AnswerResponse interface.
+ */
+declare function instanceOfAnswerResponse(value: object): value is AnswerResponse;
+declare function AnswerResponseFromJSON(json: any): AnswerResponse;
+declare function AnswerResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): AnswerResponse;
+declare function AnswerResponseToJSON(json: any): AnswerResponse;
+declare function AnswerResponseToJSONTyped(value?: AnswerResponse | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * How /contents returns the content. URL (default) is the existing
+ * presigned-download behavior; INLINE returns the content in the response body
+ * (CSV text capped at 1000 rows, or web text) and skips the S3 upload.
+ * @export
+ */
+declare const ContentsDeliveryMode: {
+    readonly Url: "url";
+    readonly Inline: "inline";
+};
+type ContentsDeliveryMode = typeof ContentsDeliveryMode[keyof typeof ContentsDeliveryMode];
+declare function instanceOfContentsDeliveryMode(value: any): boolean;
+declare function ContentsDeliveryModeFromJSON(json: any): ContentsDeliveryMode;
+declare function ContentsDeliveryModeFromJSONTyped(json: any, ignoreDiscriminator: boolean): ContentsDeliveryMode;
+declare function ContentsDeliveryModeToJSON(value?: ContentsDeliveryMode | null): any;
+declare function ContentsDeliveryModeToJSONTyped(value: any, ignoreDiscriminator: boolean): ContentsDeliveryMode;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * Request body for POST /api/v1/contents.
+ *
+ * The caller passes the result URL it wants downloadable content for; the
+ * endpoint detects the right content from the URL itself. A Tako card URL
+ * resolves to a CSV of the card's underlying data; any other URL resolves to
+ * the page's extracted full text. `mode` controls delivery: `url` (default)
+ * returns a presigned download link; `inline` returns the content in the
+ * response.
+ * @export
+ * @interface ContentsRequest
+ */
+interface ContentsRequest {
+    /**
+     * The result URL to fetch downloadable content for (a TakoCard.webpage_url or a WebResult.url). A Tako card URL yields a CSV of the card's data; any other URL yields the page's extracted text.
+     * @type {string}
+     * @memberof ContentsRequest
+     */
+    url: string;
+    /**
+     * Delivery mode: 'url' (default) returns a presigned download link; 'inline' returns the content in the response body (CSV capped at 1000 rows, with total_rows; or web text).
+     * @type {ContentsDeliveryMode}
+     * @memberof ContentsRequest
+     */
+    mode?: ContentsDeliveryMode;
+}
+/**
+ * Check if a given object implements the ContentsRequest interface.
+ */
+declare function instanceOfContentsRequest(value: object): value is ContentsRequest;
+declare function ContentsRequestFromJSON(json: any): ContentsRequest;
+declare function ContentsRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): ContentsRequest;
+declare function ContentsRequestToJSON(json: any): ContentsRequest;
+declare function ContentsRequestToJSONTyped(value?: ContentsRequest | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * A single downloadable artifact.
+ *
+ * Inherits `format` + `cost` + the inline fields (`data`/`total_rows`/
+ * `truncated`) from ResultContent. URL mode additionally populates
+ * `url`/`expires_at` (a short-lived presigned download link); INLINE mode
+ * populates the inherited inline fields and leaves `url`/`expires_at` null.
+ * @export
+ * @interface ContentItem
+ */
+interface ContentItem {
+    /**
+     *
+     * @type {ContentFormat}
+     * @memberof ContentItem
+     */
+    format: ContentFormat;
+    /**
+     *
+     * @type {number}
+     * @memberof ContentItem
+     */
+    cost?: number;
+    /**
+     *
+     * @type {string}
+     * @memberof ContentItem
+     */
+    data?: string | null;
+    /**
+     *
+     * @type {number}
+     * @memberof ContentItem
+     */
+    total_rows?: number | null;
+    /**
+     *
+     * @type {boolean}
+     * @memberof ContentItem
+     */
+    truncated?: boolean;
+    /**
+     * The originating result URL that was resolved.
+     * @type {string}
+     * @memberof ContentItem
+     */
+    source_url: string;
+    /**
+     * Presigned, short-lived URL to download the content.
+     * @type {string}
+     * @memberof ContentItem
+     */
+    url?: string | null;
+    /**
+     * ISO-8601 UTC timestamp when `url` expires.
+     * @type {string}
+     * @memberof ContentItem
+     */
+    expires_at?: string | null;
+}
+/**
+ * Check if a given object implements the ContentItem interface.
+ */
+declare function instanceOfContentItem(value: object): value is ContentItem;
+declare function ContentItemFromJSON(json: any): ContentItem;
+declare function ContentItemFromJSONTyped(json: any, ignoreDiscriminator: boolean): ContentItem;
+declare function ContentItemToJSON(json: any): ContentItem;
+declare function ContentItemToJSONTyped(value?: ContentItem | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * Response for POST /api/v1/contents.
+ *
+ * `contents` is a list so the contract stays stable if a single result ever
+ * yields multiple artifacts; today it always carries exactly one item.
+ * @export
+ * @interface ContentsResponse
+ */
+interface ContentsResponse {
+    /**
+     *
+     * @type {Array<ContentItem>}
+     * @memberof ContentsResponse
+     */
+    contents?: Array<ContentItem>;
+    /**
+     *
+     * @type {string}
+     * @memberof ContentsResponse
+     */
+    request_id: string;
+}
+/**
+ * Check if a given object implements the ContentsResponse interface.
+ */
+declare function instanceOfContentsResponse(value: object): value is ContentsResponse;
+declare function ContentsResponseFromJSON(json: any): ContentsResponse;
+declare function ContentsResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): ContentsResponse;
+declare function ContentsResponseToJSON(json: any): ContentsResponse;
+declare function ContentsResponseToJSONTyped(value?: ContentsResponse | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Component types supported for thin viz schemas with builder support.
+ *
+ * These component types have dedicated builders that process configurations,
+ * add defaults, and apply theme styling automatically.
+ * @export
+ */
+declare const ComponentTypeEnum: {
+    readonly CategoricalBar: "categorical_bar";
+    readonly Choropleth: "choropleth";
+    readonly DataTableChart: "data_table_chart";
+    readonly FinancialBoxes: "financial_boxes";
+    readonly GenericTimeseries: "generic_timeseries";
+    readonly Header: "header";
+    readonly Heatmap: "heatmap";
+    readonly Histogram: "histogram";
+    readonly Marimekko: "marimekko";
+    readonly Pie: "pie";
+    readonly Scatter: "scatter";
+    readonly Table: "table";
+    readonly Boxplot: "boxplot";
+    readonly Treemap: "treemap";
+    readonly Waterfall: "waterfall";
+    readonly Sankey: "sankey";
+    readonly Bubble: "bubble";
+    readonly PersonCard: "person_card";
+    readonly Timeline: "timeline";
+    readonly TopLevelMetric: "top_level_metric";
+};
+type ComponentTypeEnum = typeof ComponentTypeEnum[keyof typeof ComponentTypeEnum];
+declare function instanceOfComponentTypeEnum(value: any): boolean;
+declare function ComponentTypeEnumFromJSON(json: any): ComponentTypeEnum;
+declare function ComponentTypeEnumFromJSONTyped(json: any, ignoreDiscriminator: boolean): ComponentTypeEnum;
+declare function ComponentTypeEnumToJSON(value?: ComponentTypeEnum | null): any;
+declare function ComponentTypeEnumToJSONTyped(value: any, ignoreDiscriminator: boolean): ComponentTypeEnum;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * Configuration for a single component in a card.
+ * @export
+ * @interface ComponentConfig
+ */
+interface ComponentConfig {
+    /**
+     * Component type:
+     * - bubble: Bubble chart (scatter plot with size dimension for 3-variable data)
+     * - categorical_bar: Bar chart with categorical x-axis (e.g., regions, products)
+     * - choropleth: Choropleth map showing geographic data with color intensity by region (US states or world)
+     * - data_table_chart: Bar chart with auto-generated data table below showing values
+     * - financial_boxes: Financial metric boxes with values and growth indicators (e.g., Revenue, EPS)
+     * - generic_timeseries: timeseries chart
+     * - header: Card header with title and description, automatically styled with theme
+     * - heatmap: 2D heatmap with color intensity representing values (e.g., correlation matrix)
+     * - histogram: Histogram chart showing frequency distribution of values
+     * - person_card: Person profile card from an Exa person search result (includes career, education, and about tabs)
+     * - pie: Pie chart showing proportional data as slices of a circle
+     * - scatter: Scatter plot showing relationships between two continuous variables
+     * - table: Data table with configurable columns and rows
+     * - boxplot: Box plot showing statistical distributions (min, Q1, median, Q3, max)
+     * - treemap: Treemap chart showing hierarchical data as proportional rectangles
+     * - waterfall: Waterfall chart showing incremental positive/negative changes (e.g., income statement breakdown)
+     * @type {ComponentTypeEnum}
+     * @memberof ComponentConfig
+     */
+    component_type: ComponentTypeEnum;
+    /**
+     * Component variant (e.g., 'simple', 'financial')
+     * @type {string}
+     * @memberof ComponentConfig
+     */
+    component_variant?: string | null;
+    /**
+     * Component configuration data
+     * @type {{ [key: string]: any; }}
+     * @memberof ComponentConfig
+     */
+    config: {
+        [key: string]: any;
+    };
+}
+/**
+ * Check if a given object implements the ComponentConfig interface.
+ */
+declare function instanceOfComponentConfig(value: object): value is ComponentConfig;
+declare function ComponentConfigFromJSON(json: any): ComponentConfig;
+declare function ComponentConfigFromJSONTyped(json: any, ignoreDiscriminator: boolean): ComponentConfig;
+declare function ComponentConfigToJSON(json: any): ComponentConfig;
+declare function ComponentConfigToJSONTyped(value?: ComponentConfig | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * Request model for creating a card directly with components.
+ * @export
+ * @interface CreateCardRequest
+ */
+interface CreateCardRequest {
+    /**
+     * Full component configurations
+     * @type {Array<ComponentConfig>}
+     * @memberof CreateCardRequest
+     */
+    components: Array<ComponentConfig>;
+    /**
+     * Card title (falls back to header component title)
+     * @type {string}
+     * @memberof CreateCardRequest
+     */
+    title?: string | null;
+    /**
+     * Card description
+     * @type {string}
+     * @memberof CreateCardRequest
+     */
+    description?: string | null;
+    /**
+     * Data source attribution (displayed in footer)
+     * @type {string}
+     * @memberof CreateCardRequest
+     */
+    source?: string | null;
+    /**
+     * Chart height in pixels. When set, overrides the default aspect-ratio-based height for all chart components in this card. Must be between 100 and 2000.
+     * @type {number}
+     * @memberof CreateCardRequest
+     */
+    height?: number | null;
+    /**
+     * When True, the embed iframe operates in postMessage mode: the parent page injects visualization_data via window.postMessage after the iframe loads, rather than having data inlined in the embed URL. The response will include embed_mode='postmessage' when this is True, or embed_mode='post' otherwise.
+     * @type {boolean}
+     * @memberof CreateCardRequest
+     */
+    postmessage_embed?: boolean;
+    /**
+     * Target ISO 4217 currency code (e.g., 'USD', 'EUR'). When set, datasets with recognized currency units are converted to this currency using historical exchange rates. A methodology section is added explaining the conversion.
+     * @type {string}
+     * @memberof CreateCardRequest
+     */
+    normalize_currencies?: string | null;
+    /**
+     * Minutes to keep preview image available for download (ZDR only). Min 1, max 1440 (24h). When set on a ZDR card, a temporary preview image is generated and available for download until the TTL expires. Ignored for non-ZDR cards.
+     * @type {number}
+     * @memberof CreateCardRequest
+     */
+    image_ttl_minutes?: number | null;
+}
+/**
+ * Check if a given object implements the CreateCardRequest interface.
+ */
+declare function instanceOfCreateCardRequest(value: object): value is CreateCardRequest;
+declare function CreateCardRequestFromJSON(json: any): CreateCardRequest;
+declare function CreateCardRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): CreateCardRequest;
+declare function CreateCardRequestToJSON(json: any): CreateCardRequest;
+declare function CreateCardRequestToJSONTyped(value?: CreateCardRequest | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Documents a decision made by Tako's ideal viz logic for a specific ChartJS property.
+ *
+ * .. deprecated::
+ *     This class is deprecated in favor of the structured VizDecisions system.
+ *     Use VizDecisions with specific decision types (AggregationDecision, VizTypeDecision, etc.)
+ *     instead. The new system provides:
+ *     - Structured decision tracking with typed fields
+ *     - Override support (apply_override, reset_to_default)
+ *     - Better LLM context generation (get_summary_for_llm)
+ *
+ *     Example migration:
+ *         # Old way (deprecated):
+ *         decisions.append(IdealVizDecision(
+ *             property_path="y_aggregation",
+ *             reason="Applied PCSS due to different units"
+ *         ))
+ *
+ *         # New way:
+ *         viz_decisions.set_decision(
+ *             DecisionType.LEFT_AXIS_AGGREGATION,
+ *             AggregationDecision(
+ *                 value="pcss",
+ *                 source=DecisionSource.DATA_DRIVEN,
+ *                 reason_code="different_units",
+ *                 reason_display="Applied PCSS due to different units",
+ *             )
+ *         )
+ *
+ *     This class will be removed in a future version.
+ * @export
+ * @interface IdealVizDecision
+ */
+interface IdealVizDecision {
+    /**
+     * ChartJS property path
+     * @type {string}
+     * @memberof IdealVizDecision
+     */
+    property_path: string;
+    /**
+     * Human-friendly display name for the property path
+     * @type {string}
+     * @memberof IdealVizDecision
+     */
+    property_path_display_name?: string | null;
+    /**
+     * Why this decision was made
+     * @type {string}
+     * @memberof IdealVizDecision
+     */
+    reason: string;
+}
+/**
+ * Check if a given object implements the IdealVizDecision interface.
+ */
+declare function instanceOfIdealVizDecision(value: object): value is IdealVizDecision;
+declare function IdealVizDecisionFromJSON(json: any): IdealVizDecision;
+declare function IdealVizDecisionFromJSONTyped(json: any, ignoreDiscriminator: boolean): IdealVizDecision;
+declare function IdealVizDecisionToJSON(json: any): IdealVizDecision;
+declare function IdealVizDecisionToJSONTyped(value?: IdealVizDecision | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ *
+ * @export
+ * @interface KnowledgeCard
+ */
+interface KnowledgeCard {
+    /**
+     * The unique ID of the knowledge card
+     * @type {string}
+     * @memberof KnowledgeCard
+     */
+    card_id: string | null;
+    /**
+     * The unique ID of the knowledge card
+     * @type {string}
+     * @memberof KnowledgeCard
+     */
+    title: string | null;
+    /**
+     * The unique ID of the knowledge card
+     * @type {string}
+     * @memberof KnowledgeCard
+     */
+    description: string | null;
+    /**
+     * The unique ID of the knowledge card
+     * @type {string}
+     * @memberof KnowledgeCard
+     */
+    semantic_description?: string | null;
+    /**
+     * The unique ID of the knowledge card
+     * @type {string}
+     * @memberof KnowledgeCard
+     */
+    webpage_url: string | null;
+    /**
+     * The unique ID of the knowledge card
+     * @type {string}
+     * @memberof KnowledgeCard
+     */
+    image_url: string | null;
+    /**
+     * The unique ID of the knowledge card
+     * @type {string}
+     * @memberof KnowledgeCard
+     */
+    embed_url: string | null;
+    /**
+     * The sources of the knowledge card
+     * @type {Array<KnowledgeCardSource>}
+     * @memberof KnowledgeCard
+     */
+    sources: Array<KnowledgeCardSource> | null;
+    /**
+     * The methodologies of the knowledge card
+     * @type {Array<KnowledgeCardMethodology>}
+     * @memberof KnowledgeCard
+     */
+    methodologies: Array<KnowledgeCardMethodology> | null;
+    /**
+     * The source indexes of the knowledge card
+     * @type {Array<KnowledgeCardSourceIndexesInner>}
+     * @memberof KnowledgeCard
+     */
+    source_indexes: Array<KnowledgeCardSourceIndexesInner> | null;
+    /**
+     * The unique ID of the knowledge card
+     * @type {string}
+     * @memberof KnowledgeCard
+     */
+    card_type: string | null;
+    /**
+     * URL of downloadable data of the knowledge card. This needs to be enabled on an account level. Contact support to enable this feature.
+     * @type {string}
+     * @memberof KnowledgeCard
+     */
+    data_url: string | null;
+    /**
+     * How relevant this knowledge card is to the search query
+     * @type {KnowledgeCardRelevance}
+     * @memberof KnowledgeCard
+     */
+    relevance: KnowledgeCardRelevance | null;
+    /**
+     * The visualization data of the knowledge card. Null when the card's sources do not permit raw data export (protected sources); the card remains renderable via embed_url.
+     * @type {{ [key: string]: any; }}
+     * @memberof KnowledgeCard
+     */
+    visualization_data: {
+        [key: string]: any;
+    } | null;
+    /**
+     * Decisions made by Tako's ideal viz logic when constructing this visualization. DEPRECATED: Use ChartConfig.viz_decisions for the new structured system with override support.
+     * @type {Array<IdealVizDecision>}
+     * @memberof KnowledgeCard
+     */
+    ideal_viz_decisions?: Array<IdealVizDecision> | null;
+}
+/**
+ * Check if a given object implements the KnowledgeCard interface.
+ */
+declare function instanceOfKnowledgeCard(value: object): value is KnowledgeCard;
+declare function KnowledgeCardFromJSON(json: any): KnowledgeCard;
+declare function KnowledgeCardFromJSONTyped(json: any, ignoreDiscriminator: boolean): KnowledgeCard;
+declare function KnowledgeCardToJSON(json: any): KnowledgeCard;
+declare function KnowledgeCardToJSONTyped(value?: KnowledgeCard | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Public effort taxonomy for the new endpoints. FAST is the default. INSTANT
+ * serves cached embeds without re-running data retrieval and is available in all
+ * environments. Cannot be combined with sources.tako.defer_data_retrieval.
+ * The generated OpenAPI/SDK advertises exactly these members, so we add values
+ * only as the pipeline gains support.
+ * @export
+ */
+declare const SearchEffortLevel: {
+    readonly Fast: "fast";
+    readonly Instant: "instant";
+};
+type SearchEffortLevel = typeof SearchEffortLevel[keyof typeof SearchEffortLevel];
+declare function instanceOfSearchEffortLevel(value: any): boolean;
+declare function SearchEffortLevelFromJSON(json: any): SearchEffortLevel;
+declare function SearchEffortLevelFromJSONTyped(json: any, ignoreDiscriminator: boolean): SearchEffortLevel;
+declare function SearchEffortLevelToJSON(value?: SearchEffortLevel | null): any;
+declare function SearchEffortLevelToJSONTyped(value: any, ignoreDiscriminator: boolean): SearchEffortLevel;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface OutputSettings
+ */
+interface OutputSettings {
+    /**
+     * Whether to render card preview images in dark mode.
+     * @type {boolean}
+     * @memberof OutputSettings
+     */
+    image_dark_mode?: boolean | null;
+    /**
+     * Instant mode only. When false (default), instant returns existing cached embeds as-is (fastest) and never writes. When true, instant retrieves data for embeds that are missing or stale, then creates or refreshes their static embeds — slower for those, but it writes the result. Embeds already fresh (within the refresh cadence) are still served as-is, not re-retrieved or updated.
+     * @type {boolean}
+     * @memberof OutputSettings
+     */
+    force_refresh?: boolean;
+}
+/**
+ * Check if a given object implements the OutputSettings interface.
+ */
+declare function instanceOfOutputSettings(value: object): value is OutputSettings;
+declare function OutputSettingsFromJSON(json: any): OutputSettings;
+declare function OutputSettingsFromJSONTyped(json: any, ignoreDiscriminator: boolean): OutputSettings;
+declare function OutputSettingsToJSON(json: any): OutputSettings;
+declare function OutputSettingsToJSONTyped(value?: OutputSettings | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface TakoSourceSettings
+ */
+interface TakoSourceSettings {
+    /**
+     * Maximum number of results to return for this source. 1-20.
+     * @type {number}
+     * @memberof TakoSourceSettings
+     */
+    count?: number;
+    /**
+     * Inline this source's underlying data (CSV for Tako cards, extracted text for web results) directly in the response.
+     * @type {boolean}
+     * @memberof TakoSourceSettings
+     */
+    include_contents?: boolean;
+    /**
+     * Defer the expensive data-retrieval step: cards return faster with a semantic_description and a less detailed description. Mutually exclusive with include_contents (cannot inline data that was not fetched).
+     * @type {boolean}
+     * @memberof TakoSourceSettings
+     */
+    defer_data_retrieval?: boolean;
+}
+/**
+ * Check if a given object implements the TakoSourceSettings interface.
+ */
+declare function instanceOfTakoSourceSettings(value: object): value is TakoSourceSettings;
+declare function TakoSourceSettingsFromJSON(json: any): TakoSourceSettings;
+declare function TakoSourceSettingsFromJSONTyped(json: any, ignoreDiscriminator: boolean): TakoSourceSettings;
+declare function TakoSourceSettingsToJSON(json: any): TakoSourceSettings;
+declare function TakoSourceSettingsToJSONTyped(value?: TakoSourceSettings | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface SourceSettings
+ */
+interface SourceSettings {
+    /**
+     * Maximum number of results to return for this source. 1-20.
+     * @type {number}
+     * @memberof SourceSettings
+     */
+    count?: number;
+    /**
+     * Inline this source's underlying data (CSV for Tako cards, extracted text for web results) directly in the response.
+     * @type {boolean}
+     * @memberof SourceSettings
+     */
+    include_contents?: boolean;
+}
+/**
+ * Check if a given object implements the SourceSettings interface.
+ */
+declare function instanceOfSourceSettings(value: object): value is SourceSettings;
+declare function SourceSettingsFromJSON(json: any): SourceSettings;
+declare function SourceSettingsFromJSONTyped(json: any, ignoreDiscriminator: boolean): SourceSettings;
+declare function SourceSettingsToJSON(json: any): SourceSettings;
+declare function SourceSettingsToJSONTyped(value?: SourceSettings | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * Per-source settings. An index is searched iff its field is present.
+ * @export
+ * @interface Sources
+ */
+interface Sources {
+    /**
+     * Tako card source. Searched iff present.
+     * @type {TakoSourceSettings}
+     * @memberof Sources
+     */
+    tako?: TakoSourceSettings | null;
+    /**
+     * Web source. Searched iff present.
+     * @type {SourceSettings}
+     * @memberof Sources
+     */
+    web?: SourceSettings | null;
+}
+/**
+ * Check if a given object implements the Sources interface.
+ */
+declare function instanceOfSources(value: object): value is Sources;
+declare function SourcesFromJSON(json: any): Sources;
+declare function SourcesFromJSONTyped(json: any, ignoreDiscriminator: boolean): Sources;
+declare function SourcesToJSON(json: any): Sources;
+declare function SourcesToJSONTyped(value?: Sources | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ *
+ * @export
+ * @interface SearchRequest
+ */
+interface SearchRequest {
+    /**
+     * Natural language search query.
+     * @type {string}
+     * @memberof SearchRequest
+     */
+    query: string;
+    /**
+     * Search effort level. Only 'fast' is currently supported.
+     * @type {SearchEffortLevel}
+     * @memberof SearchRequest
+     */
+    effort?: SearchEffortLevel;
+    /**
+     * Per-source settings. An index is searched iff its key is present; defaults to {tako:{}} (tako-only, count 5).
+     * @type {Sources}
+     * @memberof SearchRequest
+     */
+    sources?: Sources;
+    /**
+     * ISO 3166-1 alpha-2 country code for localization.
+     * @type {string}
+     * @memberof SearchRequest
+     */
+    country_code?: string;
+    /**
+     * BCP-47 locale tag for language/formatting.
+     * @type {string}
+     * @memberof SearchRequest
+     */
+    locale?: string;
+    /**
+     * IANA timezone (e.g. 'America/New_York').
+     * @type {string}
+     * @memberof SearchRequest
+     */
+    timezone?: string | null;
+    /**
+     * Settings controlling the response shape.
+     * @type {OutputSettings}
+     * @memberof SearchRequest
+     */
+    output_settings?: OutputSettings | null;
+}
+/**
+ * Check if a given object implements the SearchRequest interface.
+ */
+declare function instanceOfSearchRequest(value: object): value is SearchRequest;
+declare function SearchRequestFromJSON(json: any): SearchRequest;
+declare function SearchRequestFromJSONTyped(json: any, ignoreDiscriminator: boolean): SearchRequest;
+declare function SearchRequestToJSON(json: any): SearchRequest;
+declare function SearchRequestToJSONTyped(value?: SearchRequest | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ *
+ * @export
+ * @interface SearchResponse
+ */
+interface SearchResponse {
+    /**
+     *
+     * @type {Array<TakoCard>}
+     * @memberof SearchResponse
+     */
+    cards?: Array<TakoCard>;
+    /**
+     *
+     * @type {Array<WebResult>}
+     * @memberof SearchResponse
+     */
+    web_results?: Array<WebResult>;
+    /**
+     * Total quoted USD cost of the data inlined on this response — the summed per-fetch price of the results whose payload was populated (one charge per distinct extracted web URL; Tako card CSV is free). This is the QUOTE, not necessarily the amount billed: on a depleted prepaid (PAYG) balance the charge is clamped to the remaining balance, so the amount actually drawn can be less. A result's own `cost` is a per-fetch quote present whenever it is downloadable, so a result that was requested but whose extraction was skipped or failed still carries its quote; that un-inlined quote is excluded here. 0 when no contents were inlined.
+     * @type {number}
+     * @memberof SearchResponse
+     */
+    contents_total_cost?: number;
+    /**
+     *
+     * @type {string}
+     * @memberof SearchResponse
+     */
+    request_id: string;
+}
+/**
+ * Check if a given object implements the SearchResponse interface.
+ */
+declare function instanceOfSearchResponse(value: object): value is SearchResponse;
+declare function SearchResponseFromJSON(json: any): SearchResponse;
+declare function SearchResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): SearchResponse;
+declare function SearchResponseToJSON(json: any): SearchResponse;
+declare function SearchResponseToJSONTyped(value?: SearchResponse | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+interface AnswerRequest {
+    searchRequest?: SearchRequest;
+}
+interface ContentsOperationRequest {
+    contentsRequest?: ContentsRequest;
+}
+interface CreateCardOperationRequest {
+    createCardRequest?: CreateCardRequest;
+}
+interface SearchOperationRequest {
+    searchRequest?: SearchRequest;
+}
+/**
+ * TakoApi - interface
+ *
+ * @export
+ * @interface TakoApiInterface
+ */
+interface TakoApiInterface {
+    /**
+     * Creates request options for answer without sending the request
+     * @param {SearchRequest} [searchRequest]
+     * @throws {RequiredError}
+     * @memberof TakoApiInterface
+     */
+    answerRequestOpts(requestParameters: AnswerRequest): Promise<RequestOpts>;
+    /**
+     * Fast-pipeline retrieval plus an LLM-synthesized answer with confidence. Replaces the grounding endpoint.
+     * @summary Answer
+     * @param {SearchRequest} [searchRequest]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof TakoApiInterface
+     */
+    answerRaw(requestParameters: AnswerRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<ApiResponse<AnswerResponse>>;
+    /**
+     * Fast-pipeline retrieval plus an LLM-synthesized answer with confidence. Replaces the grounding endpoint.
+     * Answer
+     */
+    answer(requestParameters: AnswerRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<AnswerResponse>;
+    /**
+     * Creates request options for contents without sending the request
+     * @param {ContentsRequest} [contentsRequest]
+     * @throws {RequiredError}
+     * @memberof TakoApiInterface
+     */
+    contentsRequestOpts(requestParameters: ContentsOperationRequest): Promise<RequestOpts>;
+    /**
+     * Download the content behind a search result: a CSV of a Tako card\'s underlying data, or the full text of a web page. Returns a short-lived presigned download URL. Protected-source cards (data export not available) return 403.
+     * @summary Download content
+     * @param {ContentsRequest} [contentsRequest]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof TakoApiInterface
+     */
+    contentsRaw(requestParameters: ContentsOperationRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<ApiResponse<ContentsResponse>>;
+    /**
+     * Download the content behind a search result: a CSV of a Tako card\'s underlying data, or the full text of a web page. Returns a short-lived presigned download URL. Protected-source cards (data export not available) return 403.
+     * Download content
+     */
+    contents(requestParameters: ContentsOperationRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<ContentsResponse>;
+    /**
+     * Creates request options for createCard without sending the request
+     * @param {CreateCardRequest} [createCardRequest]
+     * @throws {RequiredError}
+     * @memberof TakoApiInterface
+     */
+    createCardRequestOpts(requestParameters: CreateCardOperationRequest): Promise<RequestOpts>;
+    /**
+     * Create a visualization card directly from component configurations. Supported component types: header, generic_timeseries, categorical_bar, stock_boxes, financial_boxes, table.
+     * @param {CreateCardRequest} [createCardRequest]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof TakoApiInterface
+     */
+    createCardRaw(requestParameters: CreateCardOperationRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<ApiResponse<KnowledgeCard>>;
+    /**
+     * Create a visualization card directly from component configurations. Supported component types: header, generic_timeseries, categorical_bar, stock_boxes, financial_boxes, table.
+     */
+    createCard(requestParameters: CreateCardOperationRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<KnowledgeCard>;
+    /**
+     * Creates request options for search without sending the request
+     * @param {SearchRequest} [searchRequest]
+     * @throws {RequiredError}
+     * @memberof TakoApiInterface
+     */
+    searchRequestOpts(requestParameters: SearchOperationRequest): Promise<RequestOpts>;
+    /**
+     * Fast-pipeline knowledge search. Returns Tako cards (and web results when requested) with no LLM synthesis.
+     * @summary Search
+     * @param {SearchRequest} [searchRequest]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof TakoApiInterface
+     */
+    searchRaw(requestParameters: SearchOperationRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<ApiResponse<SearchResponse>>;
+    /**
+     * Fast-pipeline knowledge search. Returns Tako cards (and web results when requested) with no LLM synthesis.
+     * Search
+     */
+    search(requestParameters: SearchOperationRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<SearchResponse>;
+}
+/**
+ *
+ */
+declare class TakoApi extends BaseAPI implements TakoApiInterface {
+    /**
+     * Creates request options for answer without sending the request
+     */
+    answerRequestOpts(requestParameters: AnswerRequest): Promise<RequestOpts>;
+    /**
+     * Fast-pipeline retrieval plus an LLM-synthesized answer with confidence. Replaces the grounding endpoint.
+     * Answer
+     */
+    answerRaw(requestParameters: AnswerRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<ApiResponse<AnswerResponse>>;
+    /**
+     * Fast-pipeline retrieval plus an LLM-synthesized answer with confidence. Replaces the grounding endpoint.
+     * Answer
+     */
+    answer(requestParameters?: AnswerRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<AnswerResponse>;
+    /**
+     * Creates request options for contents without sending the request
+     */
+    contentsRequestOpts(requestParameters: ContentsOperationRequest): Promise<RequestOpts>;
+    /**
+     * Download the content behind a search result: a CSV of a Tako card\'s underlying data, or the full text of a web page. Returns a short-lived presigned download URL. Protected-source cards (data export not available) return 403.
+     * Download content
+     */
+    contentsRaw(requestParameters: ContentsOperationRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<ApiResponse<ContentsResponse>>;
+    /**
+     * Download the content behind a search result: a CSV of a Tako card\'s underlying data, or the full text of a web page. Returns a short-lived presigned download URL. Protected-source cards (data export not available) return 403.
+     * Download content
+     */
+    contents(requestParameters?: ContentsOperationRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<ContentsResponse>;
+    /**
+     * Creates request options for createCard without sending the request
+     */
+    createCardRequestOpts(requestParameters: CreateCardOperationRequest): Promise<RequestOpts>;
+    /**
+     * Create a visualization card directly from component configurations. Supported component types: header, generic_timeseries, categorical_bar, stock_boxes, financial_boxes, table.
+     */
+    createCardRaw(requestParameters: CreateCardOperationRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<ApiResponse<KnowledgeCard>>;
+    /**
+     * Create a visualization card directly from component configurations. Supported component types: header, generic_timeseries, categorical_bar, stock_boxes, financial_boxes, table.
+     */
+    createCard(requestParameters?: CreateCardOperationRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<KnowledgeCard>;
+    /**
+     * Creates request options for search without sending the request
+     */
+    searchRequestOpts(requestParameters: SearchOperationRequest): Promise<RequestOpts>;
+    /**
+     * Fast-pipeline knowledge search. Returns Tako cards (and web results when requested) with no LLM synthesis.
+     * Search
+     */
+    searchRaw(requestParameters: SearchOperationRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<ApiResponse<SearchResponse>>;
+    /**
+     * Fast-pipeline knowledge search. Returns Tako cards (and web results when requested) with no LLM synthesis.
+     * Search
+     */
+    search(requestParameters?: SearchOperationRequest, initOverrides?: RequestInit | InitOverrideFunction): Promise<SearchResponse>;
+}
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ */
+declare const APIErrorType: {
+    readonly BadRequest: "BAD_REQUEST";
+    readonly AuthenticationError: "AUTHENTICATION_ERROR";
+    readonly InternalServerError: "INTERNAL_SERVER_ERROR";
+    readonly RelevantResultsNotFound: "RELEVANT_RESULTS_NOT_FOUND";
+    readonly RateLimitExceeded: "RATE_LIMIT_EXCEEDED";
+    readonly PaymentRequired: "PAYMENT_REQUIRED";
+    readonly RequestTimeout: "REQUEST_TIMEOUT";
+    readonly Forbidden: "FORBIDDEN";
+    readonly NotFound: "NOT_FOUND";
+};
+type APIErrorType = typeof APIErrorType[keyof typeof APIErrorType];
+declare function instanceOfAPIErrorType(value: any): boolean;
+declare function APIErrorTypeFromJSON(json: any): APIErrorType;
+declare function APIErrorTypeFromJSONTyped(json: any, ignoreDiscriminator: boolean): APIErrorType;
+declare function APIErrorTypeToJSON(value?: APIErrorType | null): any;
+declare function APIErrorTypeToJSONTyped(value: any, ignoreDiscriminator: boolean): APIErrorType;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ *
+ * @export
+ * @interface AgentResultEvent
+ */
+interface AgentResultEvent {
+    /**
+     *
+     * @type {AgentResultEventKindEnum}
+     * @memberof AgentResultEvent
+     */
+    kind?: AgentResultEventKindEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof AgentResultEvent
+     */
+    id: string;
+    /**
+     *
+     * @type {AgentResult}
+     * @memberof AgentResultEvent
+     */
+    data: AgentResult;
+}
+/**
+ * @export
+ */
+declare const AgentResultEventKindEnum: {
+    readonly AgentResult: "agent_result";
+};
+type AgentResultEventKindEnum = typeof AgentResultEventKindEnum[keyof typeof AgentResultEventKindEnum];
+/**
+ * Check if a given object implements the AgentResultEvent interface.
+ */
+declare function instanceOfAgentResultEvent(value: object): value is AgentResultEvent;
+declare function AgentResultEventFromJSON(json: any): AgentResultEvent;
+declare function AgentResultEventFromJSONTyped(json: any, ignoreDiscriminator: boolean): AgentResultEvent;
+declare function AgentResultEventToJSON(json: any): AgentResultEvent;
+declare function AgentResultEventToJSONTyped(value?: AgentResultEvent | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ * Signals that the data pipeline produced chart(s) for the answer. Carries
+ * only chart references; the answer text streams in `text` events and the
+ * structured result arrives in the terminal `agent_result` event, not here.
+ * @export
+ * @interface DataPipelineAnswerEvent
+ */
+interface DataPipelineAnswerEvent {
+    /**
+     *
+     * @type {DataPipelineAnswerEventKindEnum}
+     * @memberof DataPipelineAnswerEvent
+     */
+    kind?: DataPipelineAnswerEventKindEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof DataPipelineAnswerEvent
+     */
+    id: string;
+    /**
+     *
+     * @type {Array<string>}
+     * @memberof DataPipelineAnswerEvent
+     */
+    chart_refs?: Array<string>;
+}
+/**
+ * @export
+ */
+declare const DataPipelineAnswerEventKindEnum: {
+    readonly DataPipelineAnswer: "data_pipeline_answer";
+};
+type DataPipelineAnswerEventKindEnum = typeof DataPipelineAnswerEventKindEnum[keyof typeof DataPipelineAnswerEventKindEnum];
+/**
+ * Check if a given object implements the DataPipelineAnswerEvent interface.
+ */
+declare function instanceOfDataPipelineAnswerEvent(value: object): value is DataPipelineAnswerEvent;
+declare function DataPipelineAnswerEventFromJSON(json: any): DataPipelineAnswerEvent;
+declare function DataPipelineAnswerEventFromJSONTyped(json: any, ignoreDiscriminator: boolean): DataPipelineAnswerEvent;
+declare function DataPipelineAnswerEventToJSON(json: any): DataPipelineAnswerEvent;
+declare function DataPipelineAnswerEventToJSONTyped(value?: DataPipelineAnswerEvent | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface HeartbeatEvent
+ */
+interface HeartbeatEvent {
+    /**
+     *
+     * @type {HeartbeatEventKindEnum}
+     * @memberof HeartbeatEvent
+     */
+    kind?: HeartbeatEventKindEnum;
+}
+/**
+ * @export
+ */
+declare const HeartbeatEventKindEnum: {
+    readonly Heartbeat: "heartbeat";
+};
+type HeartbeatEventKindEnum = typeof HeartbeatEventKindEnum[keyof typeof HeartbeatEventKindEnum];
+/**
+ * Check if a given object implements the HeartbeatEvent interface.
+ */
+declare function instanceOfHeartbeatEvent(value: object): value is HeartbeatEvent;
+declare function HeartbeatEventFromJSON(json: any): HeartbeatEvent;
+declare function HeartbeatEventFromJSONTyped(json: any, ignoreDiscriminator: boolean): HeartbeatEvent;
+declare function HeartbeatEventToJSON(json: any): HeartbeatEvent;
+declare function HeartbeatEventToJSONTyped(value?: HeartbeatEvent | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface ReasoningEvent
+ */
+interface ReasoningEvent {
+    /**
+     *
+     * @type {ReasoningEventKindEnum}
+     * @memberof ReasoningEvent
+     */
+    kind?: ReasoningEventKindEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof ReasoningEvent
+     */
+    id: string;
+    /**
+     *
+     * @type {string}
+     * @memberof ReasoningEvent
+     */
+    delta: string;
+    /**
+     *
+     * @type {boolean}
+     * @memberof ReasoningEvent
+     */
+    done?: boolean;
+}
+/**
+ * @export
+ */
+declare const ReasoningEventKindEnum: {
+    readonly Reasoning: "reasoning";
+};
+type ReasoningEventKindEnum = typeof ReasoningEventKindEnum[keyof typeof ReasoningEventKindEnum];
+/**
+ * Check if a given object implements the ReasoningEvent interface.
+ */
+declare function instanceOfReasoningEvent(value: object): value is ReasoningEvent;
+declare function ReasoningEventFromJSON(json: any): ReasoningEvent;
+declare function ReasoningEventFromJSONTyped(json: any, ignoreDiscriminator: boolean): ReasoningEvent;
+declare function ReasoningEventToJSON(json: any): ReasoningEvent;
+declare function ReasoningEventToJSONTyped(value?: ReasoningEvent | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface StatusEvent
+ */
+interface StatusEvent {
+    /**
+     *
+     * @type {StatusEventKindEnum}
+     * @memberof StatusEvent
+     */
+    kind?: StatusEventKindEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof StatusEvent
+     */
+    message: string;
+    /**
+     *
+     * @type {string}
+     * @memberof StatusEvent
+     */
+    parent_id?: string | null;
+}
+/**
+ * @export
+ */
+declare const StatusEventKindEnum: {
+    readonly Status: "status";
+};
+type StatusEventKindEnum = typeof StatusEventKindEnum[keyof typeof StatusEventKindEnum];
+/**
+ * Check if a given object implements the StatusEvent interface.
+ */
+declare function instanceOfStatusEvent(value: object): value is StatusEvent;
+declare function StatusEventFromJSON(json: any): StatusEvent;
+declare function StatusEventFromJSONTyped(json: any, ignoreDiscriminator: boolean): StatusEvent;
+declare function StatusEventToJSON(json: any): StatusEvent;
+declare function StatusEventToJSONTyped(value?: StatusEvent | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface StreamDoneEvent
+ */
+interface StreamDoneEvent {
+    /**
+     *
+     * @type {StreamDoneEventKindEnum}
+     * @memberof StreamDoneEvent
+     */
+    kind?: StreamDoneEventKindEnum;
+}
+/**
+ * @export
+ */
+declare const StreamDoneEventKindEnum: {
+    readonly StreamDone: "stream_done";
+};
+type StreamDoneEventKindEnum = typeof StreamDoneEventKindEnum[keyof typeof StreamDoneEventKindEnum];
+/**
+ * Check if a given object implements the StreamDoneEvent interface.
+ */
+declare function instanceOfStreamDoneEvent(value: object): value is StreamDoneEvent;
+declare function StreamDoneEventFromJSON(json: any): StreamDoneEvent;
+declare function StreamDoneEventFromJSONTyped(json: any, ignoreDiscriminator: boolean): StreamDoneEvent;
+declare function StreamDoneEventToJSON(json: any): StreamDoneEvent;
+declare function StreamDoneEventToJSONTyped(value?: StreamDoneEvent | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface StreamResetEvent
+ */
+interface StreamResetEvent {
+    /**
+     *
+     * @type {StreamResetEventKindEnum}
+     * @memberof StreamResetEvent
+     */
+    kind?: StreamResetEventKindEnum;
+}
+/**
+ * @export
+ */
+declare const StreamResetEventKindEnum: {
+    readonly StreamReset: "stream_reset";
+};
+type StreamResetEventKindEnum = typeof StreamResetEventKindEnum[keyof typeof StreamResetEventKindEnum];
+/**
+ * Check if a given object implements the StreamResetEvent interface.
+ */
+declare function instanceOfStreamResetEvent(value: object): value is StreamResetEvent;
+declare function StreamResetEventFromJSON(json: any): StreamResetEvent;
+declare function StreamResetEventFromJSONTyped(json: any, ignoreDiscriminator: boolean): StreamResetEvent;
+declare function StreamResetEventToJSON(json: any): StreamResetEvent;
+declare function StreamResetEventToJSONTyped(value?: StreamResetEvent | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface SubagentEvent
+ */
+interface SubagentEvent {
+    /**
+     *
+     * @type {SubagentEventKindEnum}
+     * @memberof SubagentEvent
+     */
+    kind?: SubagentEventKindEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof SubagentEvent
+     */
+    agent_id: string;
+    /**
+     *
+     * @type {string}
+     * @memberof SubagentEvent
+     */
+    subagent_type: string;
+    /**
+     *
+     * @type {string}
+     * @memberof SubagentEvent
+     */
+    parent_id?: string | null;
+    /**
+     *
+     * @type {SubagentEventEventEnum}
+     * @memberof SubagentEvent
+     */
+    event: SubagentEventEventEnum;
+}
+/**
+ * @export
+ */
+declare const SubagentEventKindEnum: {
+    readonly Subagent: "subagent";
+};
+type SubagentEventKindEnum = typeof SubagentEventKindEnum[keyof typeof SubagentEventKindEnum];
+/**
+ * @export
+ */
+declare const SubagentEventEventEnum: {
+    readonly Dispatch: "dispatch";
+    readonly Complete: "complete";
+};
+type SubagentEventEventEnum = typeof SubagentEventEventEnum[keyof typeof SubagentEventEventEnum];
+/**
+ * Check if a given object implements the SubagentEvent interface.
+ */
+declare function instanceOfSubagentEvent(value: object): value is SubagentEvent;
+declare function SubagentEventFromJSON(json: any): SubagentEvent;
+declare function SubagentEventFromJSONTyped(json: any, ignoreDiscriminator: boolean): SubagentEvent;
+declare function SubagentEventToJSON(json: any): SubagentEvent;
+declare function SubagentEventToJSONTyped(value?: SubagentEvent | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface TextEvent
+ */
+interface TextEvent {
+    /**
+     *
+     * @type {TextEventKindEnum}
+     * @memberof TextEvent
+     */
+    kind?: TextEventKindEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof TextEvent
+     */
+    id: string;
+    /**
+     *
+     * @type {string}
+     * @memberof TextEvent
+     */
+    delta: string;
+    /**
+     *
+     * @type {boolean}
+     * @memberof TextEvent
+     */
+    done?: boolean;
+}
+/**
+ * @export
+ */
+declare const TextEventKindEnum: {
+    readonly Text: "text";
+};
+type TextEventKindEnum = typeof TextEventKindEnum[keyof typeof TextEventKindEnum];
+/**
+ * Check if a given object implements the TextEvent interface.
+ */
+declare function instanceOfTextEvent(value: object): value is TextEvent;
+declare function TextEventFromJSON(json: any): TextEvent;
+declare function TextEventFromJSONTyped(json: any, ignoreDiscriminator: boolean): TextEvent;
+declare function TextEventToJSON(json: any): TextEvent;
+declare function TextEventToJSONTyped(value?: TextEvent | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface ToolCallEvent
+ */
+interface ToolCallEvent {
+    /**
+     *
+     * @type {ToolCallEventKindEnum}
+     * @memberof ToolCallEvent
+     */
+    kind?: ToolCallEventKindEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof ToolCallEvent
+     */
+    id: string;
+    /**
+     *
+     * @type {string}
+     * @memberof ToolCallEvent
+     */
+    tool: string;
+    /**
+     *
+     * @type {string}
+     * @memberof ToolCallEvent
+     */
+    status_message?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof ToolCallEvent
+     */
+    parent_id?: string | null;
+    /**
+     *
+     * @type {boolean}
+     * @memberof ToolCallEvent
+     */
+    done?: boolean;
+}
+/**
+ * @export
+ */
+declare const ToolCallEventKindEnum: {
+    readonly ToolCall: "tool_call";
+};
+type ToolCallEventKindEnum = typeof ToolCallEventKindEnum[keyof typeof ToolCallEventKindEnum];
+/**
+ * Check if a given object implements the ToolCallEvent interface.
+ */
+declare function instanceOfToolCallEvent(value: object): value is ToolCallEvent;
+declare function ToolCallEventFromJSON(json: any): ToolCallEvent;
+declare function ToolCallEventFromJSONTyped(json: any, ignoreDiscriminator: boolean): ToolCallEvent;
+declare function ToolCallEventToJSON(json: any): ToolCallEvent;
+declare function ToolCallEventToJSONTyped(value?: ToolCallEvent | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface ToolErrorEvent
+ */
+interface ToolErrorEvent {
+    /**
+     *
+     * @type {ToolErrorEventKindEnum}
+     * @memberof ToolErrorEvent
+     */
+    kind?: ToolErrorEventKindEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof ToolErrorEvent
+     */
+    id: string;
+    /**
+     *
+     * @type {string}
+     * @memberof ToolErrorEvent
+     */
+    tool: string;
+    /**
+     *
+     * @type {string}
+     * @memberof ToolErrorEvent
+     */
+    error: string;
+    /**
+     *
+     * @type {string}
+     * @memberof ToolErrorEvent
+     */
+    parent_id?: string | null;
+}
+/**
+ * @export
+ */
+declare const ToolErrorEventKindEnum: {
+    readonly ToolError: "tool_error";
+};
+type ToolErrorEventKindEnum = typeof ToolErrorEventKindEnum[keyof typeof ToolErrorEventKindEnum];
+/**
+ * Check if a given object implements the ToolErrorEvent interface.
+ */
+declare function instanceOfToolErrorEvent(value: object): value is ToolErrorEvent;
+declare function ToolErrorEventFromJSON(json: any): ToolErrorEvent;
+declare function ToolErrorEventFromJSONTyped(json: any, ignoreDiscriminator: boolean): ToolErrorEvent;
+declare function ToolErrorEventToJSON(json: any): ToolErrorEvent;
+declare function ToolErrorEventToJSONTyped(value?: ToolErrorEvent | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface ToolResultEvent
+ */
+interface ToolResultEvent {
+    /**
+     *
+     * @type {ToolResultEventKindEnum}
+     * @memberof ToolResultEvent
+     */
+    kind?: ToolResultEventKindEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof ToolResultEvent
+     */
+    id: string;
+    /**
+     *
+     * @type {string}
+     * @memberof ToolResultEvent
+     */
+    tool: string;
+    /**
+     *
+     * @type {number}
+     * @memberof ToolResultEvent
+     */
+    elapsed_ms?: number;
+    /**
+     *
+     * @type {string}
+     * @memberof ToolResultEvent
+     */
+    link?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof ToolResultEvent
+     */
+    parent_id?: string | null;
+}
+/**
+ * @export
+ */
+declare const ToolResultEventKindEnum: {
+    readonly ToolResult: "tool_result";
+};
+type ToolResultEventKindEnum = typeof ToolResultEventKindEnum[keyof typeof ToolResultEventKindEnum];
+/**
+ * Check if a given object implements the ToolResultEvent interface.
+ */
+declare function instanceOfToolResultEvent(value: object): value is ToolResultEvent;
+declare function ToolResultEventFromJSON(json: any): ToolResultEvent;
+declare function ToolResultEventFromJSONTyped(json: any, ignoreDiscriminator: boolean): ToolResultEvent;
+declare function ToolResultEventToJSON(json: any): ToolResultEvent;
+declare function ToolResultEventToJSONTyped(value?: ToolResultEvent | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface ToolRetryEvent
+ */
+interface ToolRetryEvent {
+    /**
+     *
+     * @type {ToolRetryEventKindEnum}
+     * @memberof ToolRetryEvent
+     */
+    kind?: ToolRetryEventKindEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof ToolRetryEvent
+     */
+    id: string;
+    /**
+     *
+     * @type {string}
+     * @memberof ToolRetryEvent
+     */
+    tool: string;
+    /**
+     *
+     * @type {string}
+     * @memberof ToolRetryEvent
+     */
+    error: string;
+    /**
+     *
+     * @type {number}
+     * @memberof ToolRetryEvent
+     */
+    elapsed_ms?: number;
+    /**
+     *
+     * @type {string}
+     * @memberof ToolRetryEvent
+     */
+    parent_id?: string | null;
+}
+/**
+ * @export
+ */
+declare const ToolRetryEventKindEnum: {
+    readonly ToolRetry: "tool_retry";
+};
+type ToolRetryEventKindEnum = typeof ToolRetryEventKindEnum[keyof typeof ToolRetryEventKindEnum];
+/**
+ * Check if a given object implements the ToolRetryEvent interface.
+ */
+declare function instanceOfToolRetryEvent(value: object): value is ToolRetryEvent;
+declare function ToolRetryEventFromJSON(json: any): ToolRetryEvent;
+declare function ToolRetryEventFromJSONTyped(json: any, ignoreDiscriminator: boolean): ToolRetryEvent;
+declare function ToolRetryEventToJSON(json: any): ToolRetryEvent;
+declare function ToolRetryEventToJSONTyped(value?: ToolRetryEvent | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * @type Block
+ *
+ * @export
+ */
+type Block = {
+    kind: 'agent_result';
+} & AgentResultEvent | {
+    kind: 'data_pipeline_answer';
+} & DataPipelineAnswerEvent | {
+    kind: 'heartbeat';
+} & HeartbeatEvent | {
+    kind: 'reasoning';
+} & ReasoningEvent | {
+    kind: 'status';
+} & StatusEvent | {
+    kind: 'stream_done';
+} & StreamDoneEvent | {
+    kind: 'stream_reset';
+} & StreamResetEvent | {
+    kind: 'subagent';
+} & SubagentEvent | {
+    kind: 'text';
+} & TextEvent | {
+    kind: 'tool_call';
+} & ToolCallEvent | {
+    kind: 'tool_error';
+} & ToolErrorEvent | {
+    kind: 'tool_result';
+} & ToolResultEvent | {
+    kind: 'tool_retry';
+} & ToolRetryEvent;
+declare function BlockFromJSON(json: any): Block;
+declare function BlockFromJSONTyped(json: any, ignoreDiscriminator: boolean): Block;
+declare function BlockToJSON(json: any): any;
+declare function BlockToJSONTyped(value?: Block | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ */
+declare const StreamCategory: {
+    readonly Content: "content";
+    readonly Activity: "activity";
+    readonly Control: "control";
+};
+type StreamCategory = typeof StreamCategory[keyof typeof StreamCategory];
+declare function instanceOfStreamCategory(value: any): boolean;
+declare function StreamCategoryFromJSON(json: any): StreamCategory;
+declare function StreamCategoryFromJSONTyped(json: any, ignoreDiscriminator: boolean): StreamCategory;
+declare function StreamCategoryToJSON(value?: StreamCategory | null): any;
+declare function StreamCategoryToJSONTyped(value: any, ignoreDiscriminator: boolean): StreamCategory;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * Public SSE envelope for the Agent run stream. `run_id` is the run/task id
+ * (renamed from the native envelope's `task_id` for resource consistency).
+ *
+ * `seq` is monotonically increasing but NOT contiguous: the public stream omits
+ * internal block kinds, so gaps in `seq` are expected and do not indicate lost
+ * events. Use `seq` only as the resume cursor (`starting_after` / `Last-Event-ID`),
+ * not as a completeness check.
+ * @export
+ * @interface AgentStreamEnvelope
+ */
+interface AgentStreamEnvelope {
+    /**
+     * Monotonic event sequence number; use as the resume cursor. Values are NOT contiguous — the public stream filters internal block kinds, so gaps are expected and do not mean events were lost.
+     * @type {number}
+     * @memberof AgentStreamEnvelope
+     */
+    seq: number;
+    /**
+     *
+     * @type {string}
+     * @memberof AgentStreamEnvelope
+     */
+    run_id: string;
+    /**
+     *
+     * @type {string}
+     * @memberof AgentStreamEnvelope
+     */
+    thread_id?: string | null;
+    /**
+     *
+     * @type {StreamCategory}
+     * @memberof AgentStreamEnvelope
+     */
+    category: StreamCategory;
+    /**
+     *
+     * @type {Block}
+     * @memberof AgentStreamEnvelope
+     */
+    block: Block;
+}
+/**
+ * Check if a given object implements the AgentStreamEnvelope interface.
+ */
+declare function instanceOfAgentStreamEnvelope(value: object): value is AgentStreamEnvelope;
+declare function AgentStreamEnvelopeFromJSON(json: any): AgentStreamEnvelope;
+declare function AgentStreamEnvelopeFromJSONTyped(json: any, ignoreDiscriminator: boolean): AgentStreamEnvelope;
+declare function AgentStreamEnvelopeToJSON(json: any): AgentStreamEnvelope;
+declare function AgentStreamEnvelopeToJSONTyped(value?: AgentStreamEnvelope | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ *
+ * @export
+ * @interface BaseAPIError
+ */
+interface BaseAPIError {
+    /**
+     *
+     * @type {string}
+     * @memberof BaseAPIError
+     */
+    error_message: string;
+    /**
+     *
+     * @type {APIErrorType}
+     * @memberof BaseAPIError
+     */
+    error_type: APIErrorType;
+}
+/**
+ * Check if a given object implements the BaseAPIError interface.
+ */
+declare function instanceOfBaseAPIError(value: object): value is BaseAPIError;
+declare function BaseAPIErrorFromJSON(json: any): BaseAPIError;
+declare function BaseAPIErrorFromJSONTyped(json: any, ignoreDiscriminator: boolean): BaseAPIError;
+declare function BaseAPIErrorToJSON(json: any): BaseAPIError;
+declare function BaseAPIErrorToJSONTyped(value?: BaseAPIError | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ * A segment of a source index. Within a source index, a segment is a subset of the data.
+ * For connected data, a segment is a subset of connected files. A segment may be used for
+ * multi-tenant data e.g. using a segment per customer.
+ * @export
+ * @interface CardSourceIndexSegment
+ */
+interface CardSourceIndexSegment {
+    /**
+     *
+     * @type {CardSourceIndex}
+     * @memberof CardSourceIndexSegment
+     */
+    index_type: CardSourceIndex;
+    /**
+     * An ID for a segment of a source index
+     * @type {string}
+     * @memberof CardSourceIndexSegment
+     */
+    segment_id: string;
+}
+/**
+ * Check if a given object implements the CardSourceIndexSegment interface.
+ */
+declare function instanceOfCardSourceIndexSegment(value: object): value is CardSourceIndexSegment;
+declare function CardSourceIndexSegmentFromJSON(json: any): CardSourceIndexSegment;
+declare function CardSourceIndexSegmentFromJSONTyped(json: any, ignoreDiscriminator: boolean): CardSourceIndexSegment;
+declare function CardSourceIndexSegmentToJSON(json: any): CardSourceIndexSegment;
+declare function CardSourceIndexSegmentToJSONTyped(value?: CardSourceIndexSegment | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+/**
+ *
+ * @export
+ * @interface CardSourcePrivateIndex
+ */
+interface CardSourcePrivateIndex {
+    /**
+     *
+     * @type {CardSourceIndex}
+     * @memberof CardSourcePrivateIndex
+     */
+    index_type: CardSourceIndex;
+    /**
+     * An ID for a segment of a source index (optional for private indexes)
+     * @type {string}
+     * @memberof CardSourcePrivateIndex
+     */
+    segment_id?: string | null;
+    /**
+     * An ID for a private index
+     * @type {string}
+     * @memberof CardSourcePrivateIndex
+     */
+    private_index_id: string;
+}
+/**
+ * Check if a given object implements the CardSourcePrivateIndex interface.
+ */
+declare function instanceOfCardSourcePrivateIndex(value: object): value is CardSourcePrivateIndex;
+declare function CardSourcePrivateIndexFromJSON(json: any): CardSourcePrivateIndex;
+declare function CardSourcePrivateIndexFromJSONTyped(json: any, ignoreDiscriminator: boolean): CardSourcePrivateIndex;
+declare function CardSourcePrivateIndexToJSON(json: any): CardSourcePrivateIndex;
+declare function CardSourcePrivateIndexToJSONTyped(value?: CardSourcePrivateIndex | null, ignoreDiscriminator?: boolean): any;
+
+/**
+ * Knowledge Search API
+ * No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)
+ *
+ * The version of the OpenAPI document: 1.0.0
+ *
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+/**
+ *
+ * @export
+ * @interface CreateCard400Response
+ */
+interface CreateCard400Response {
+    /**
+     * The unique ID of the knowledge card
+     * @type {string}
+     * @memberof CreateCard400Response
+     */
+    error: string | null;
+}
+/**
+ * Check if a given object implements the CreateCard400Response interface.
+ */
+declare function instanceOfCreateCard400Response(value: object): value is CreateCard400Response;
+declare function CreateCard400ResponseFromJSON(json: any): CreateCard400Response;
+declare function CreateCard400ResponseFromJSONTyped(json: any, ignoreDiscriminator: boolean): CreateCard400Response;
+declare function CreateCard400ResponseToJSON(json: any): CreateCard400Response;
+declare function CreateCard400ResponseToJSONTyped(value?: CreateCard400Response | null, ignoreDiscriminator?: boolean): any;
+
+interface AgentStreamOptions {
+    /** Max reconnect attempts after a transient drop. Default 5. */
+    maxRetries?: number;
+    /** Idle read timeout (ms) before a connection is treated as dropped. Default 120000. */
+    readTimeoutMs?: number;
+}
+/**
+ * Auto-reconnecting SSE stream over an agent run. Async-iterates AgentStreamEnvelope.
+ *
+ *   const stream = tako.agent.stream({ query: "..." });
+ *   try {
+ *     for await (const event of stream) { ... }
+ *   } finally {
+ *     await stream.close();
+ *   }
+ */
+declare class AgentStream implements AsyncIterable<AgentStreamEnvelope> {
+    run_id: string | null;
+    last_seq: number;
+    result: AgentResult | null;
+    private readonly base;
+    private readonly request;
+    private readonly maxRetries;
+    private readonly readTimeoutMs;
+    private readonly apiKeyFn?;
+    private controller;
+    private reader;
+    private buffer;
+    private closed;
+    private decoder;
+    constructor(config: Configuration, request: AgentRunRequest, options?: AgentStreamOptions);
+    private headers;
+    private open;
+    private dispatch;
+    private reconnect;
+    private closeConnection;
+    /** Read one chunk, racing an idle-timeout abort. Returns null at end of stream. */
+    private readChunk;
+    /** Pull the next complete SSE frame's data payload from the buffer, or null if none yet. */
+    private nextFrameData;
+    [Symbol.asyncIterator](): AsyncIterator<AgentStreamEnvelope>;
+    /** Close the underlying connection. Always call this (or use try/finally). */
+    close(): Promise<void>;
+}
+
+/** Agent run operations: dispatch, poll, and live-stream. */
+declare class AgentResource {
+    private readonly config;
+    private readonly api;
+    constructor(config: Configuration);
+    /** Dispatch a new agent run (202). Returns the AgentRun handle. */
+    run(request: AgentRunRequest): Promise<AgentRun>;
+    /** Poll a run's status. `startingAfter` replays events after that seq (JSON mode). */
+    get(runId: string, startingAfter?: number): Promise<AgentRun>;
+    /** Open a live SSE stream over a new agent run. */
+    stream(request: AgentRunRequest, options?: AgentStreamOptions): AgentStream;
+}
+
+interface TakoOptions {
+    /** Tako API key (sent as the X-API-Key header). */
+    apiKey: string;
+    /** API base path. Defaults to https://tako.com/api. */
+    basePath?: string;
+}
+/** Ergonomic Tako client. Build once, then call operations directly. */
+declare class Tako {
+    readonly config: Configuration;
+    readonly agent: AgentResource;
+    private readonly api;
+    constructor(options: TakoOptions);
+    search(request: SearchRequest): Promise<SearchResponse>;
+    answer(request: SearchRequest): Promise<AnswerResponse>;
+    contents(request: ContentsRequest): Promise<ContentsResponse>;
+    createCard(request: CreateCardRequest): Promise<KnowledgeCard>;
+}
 
-export { KnowledgeCard, KnowledgeSearchInput, KnowledgeSearchRequest, KnowledgeSearchResponse, Methodology, Source, SourceIndex, TakoConfig, TakoError, TakoException, TakoRateLimitException, TakoUnauthorizedException, createTakoClient };
+export { APIErrorType, APIErrorTypeFromJSON, APIErrorTypeFromJSONTyped, APIErrorTypeToJSON, APIErrorTypeToJSONTyped, AgentApi, type AgentApiInterface, AgentEffortLevel, AgentEffortLevelFromJSON, AgentEffortLevelFromJSONTyped, AgentEffortLevelToJSON, AgentEffortLevelToJSONTyped, type AgentOutputSettings, AgentOutputSettingsFromJSON, AgentOutputSettingsFromJSONTyped, AgentOutputSettingsToJSON, AgentOutputSettingsToJSONTyped, AgentResource, type AgentResult, type AgentResultEvent, AgentResultEventFromJSON, AgentResultEventFromJSONTyped, AgentResultEventKindEnum, AgentResultEventToJSON, AgentResultEventToJSONTyped, AgentResultFromJSON, AgentResultFromJSONTyped, AgentResultToJSON, AgentResultToJSONTyped, type AgentRun, AgentRunFromJSON, AgentRunFromJSONTyped, AgentRunObjectEnum, type AgentRunRequest, AgentRunRequestFromJSON, AgentRunRequestFromJSONTyped, AgentRunRequestSourceIndexesEnum, AgentRunRequestToJSON, AgentRunRequestToJSONTyped, AgentRunStatus, AgentRunStatusFromJSON, AgentRunStatusFromJSONTyped, AgentRunStatusToJSON, AgentRunStatusToJSONTyped, AgentRunToJSON, AgentRunToJSONTyped, AgentStream, type AgentStreamEnvelope, AgentStreamEnvelopeFromJSON, AgentStreamEnvelopeFromJSONTyped, AgentStreamEnvelopeToJSON, AgentStreamEnvelopeToJSONTyped, type AgentStreamOptions, type AnswerRequest, type AnswerResponse, AnswerResponseFromJSON, AnswerResponseFromJSONTyped, AnswerResponseToJSON, AnswerResponseToJSONTyped, type ApiResponse, BASE_PATH, BaseAPI, type BaseAPIError, BaseAPIErrorFromJSON, BaseAPIErrorFromJSONTyped, BaseAPIErrorToJSON, BaseAPIErrorToJSONTyped, BlobApiResponse, type Block, BlockFromJSON, BlockFromJSONTyped, BlockToJSON, BlockToJSONTyped, COLLECTION_FORMATS, CardSourceIndex, CardSourceIndexFromJSON, CardSourceIndexFromJSONTyped, type CardSourceIndexSegment, CardSourceIndexSegmentFromJSON, CardSourceIndexSegmentFromJSONTyped, CardSourceIndexSegmentToJSON, CardSourceIndexSegmentToJSONTyped, CardSourceIndexToJSON, CardSourceIndexToJSONTyped, type CardSourcePrivateIndex, CardSourcePrivateIndexFromJSON, CardSourcePrivateIndexFromJSONTyped, CardSourcePrivateIndexToJSON, CardSourcePrivateIndexToJSONTyped, type ComponentConfig, ComponentConfigFromJSON, ComponentConfigFromJSONTyped, ComponentConfigToJSON, ComponentConfigToJSONTyped, ComponentTypeEnum, ComponentTypeEnumFromJSON, ComponentTypeEnumFromJSONTyped, ComponentTypeEnumToJSON, ComponentTypeEnumToJSONTyped, Configuration, type ConfigurationParameters, type Consume, ContentFormat, ContentFormatFromJSON, ContentFormatFromJSONTyped, ContentFormatToJSON, ContentFormatToJSONTyped, type ContentItem, ContentItemFromJSON, ContentItemFromJSONTyped, ContentItemToJSON, ContentItemToJSONTyped, ContentsDeliveryMode, ContentsDeliveryModeFromJSON, ContentsDeliveryModeFromJSONTyped, ContentsDeliveryModeToJSON, ContentsDeliveryModeToJSONTyped, type ContentsOperationRequest, type ContentsRequest, ContentsRequestFromJSON, ContentsRequestFromJSONTyped, ContentsRequestToJSON, ContentsRequestToJSONTyped, type ContentsResponse, ContentsResponseFromJSON, ContentsResponseFromJSONTyped, ContentsResponseToJSON, ContentsResponseToJSONTyped, type CreateAgentRunRequest, type CreateCard400Response, CreateCard400ResponseFromJSON, CreateCard400ResponseFromJSONTyped, CreateCard400ResponseToJSON, CreateCard400ResponseToJSONTyped, type CreateCardOperationRequest, type CreateCardRequest, CreateCardRequestFromJSON, CreateCardRequestFromJSONTyped, CreateCardRequestToJSON, CreateCardRequestToJSONTyped, type DataPipelineAnswerEvent, DataPipelineAnswerEventFromJSON, DataPipelineAnswerEventFromJSONTyped, DataPipelineAnswerEventKindEnum, DataPipelineAnswerEventToJSON, DataPipelineAnswerEventToJSONTyped, DefaultConfig, type ErrorContext, type ErrorObject, ErrorObjectFromJSON, ErrorObjectFromJSONTyped, ErrorObjectToJSON, ErrorObjectToJSONTyped, type FetchAPI, FetchError, type FetchParams, type GetAgentRunRequest, type HTTPBody, type HTTPHeaders, type HTTPMethod, type HTTPQuery, type HTTPRequestInit, type HeartbeatEvent, HeartbeatEventFromJSON, HeartbeatEventFromJSONTyped, HeartbeatEventKindEnum, HeartbeatEventToJSON, HeartbeatEventToJSONTyped, type IdealVizDecision, IdealVizDecisionFromJSON, IdealVizDecisionFromJSONTyped, IdealVizDecisionToJSON, IdealVizDecisionToJSONTyped, type InitOverrideFunction, JSONApiResponse, type Json, type KnowledgeCard, KnowledgeCardFromJSON, KnowledgeCardFromJSONTyped, type KnowledgeCardMethodology, KnowledgeCardMethodologyFromJSON, KnowledgeCardMethodologyFromJSONTyped, KnowledgeCardMethodologyToJSON, KnowledgeCardMethodologyToJSONTyped, KnowledgeCardRelevance, KnowledgeCardRelevanceFromJSON, KnowledgeCardRelevanceFromJSONTyped, KnowledgeCardRelevanceToJSON, KnowledgeCardRelevanceToJSONTyped, type KnowledgeCardSource, KnowledgeCardSourceFromJSON, KnowledgeCardSourceFromJSONTyped, type KnowledgeCardSourceIndexesInner, KnowledgeCardSourceIndexesInnerFromJSON, KnowledgeCardSourceIndexesInnerFromJSONTyped, KnowledgeCardSourceIndexesInnerToJSON, KnowledgeCardSourceIndexesInnerToJSONTyped, KnowledgeCardSourceToJSON, KnowledgeCardSourceToJSONTyped, KnowledgeCardToJSON, KnowledgeCardToJSONTyped, type Middleware, type ModelPropertyNaming, type OutputSettings, OutputSettingsFromJSON, OutputSettingsFromJSONTyped, OutputSettingsToJSON, OutputSettingsToJSONTyped, type ReasoningEvent, ReasoningEventFromJSON, ReasoningEventFromJSONTyped, ReasoningEventKindEnum, ReasoningEventToJSON, ReasoningEventToJSONTyped, type RequestContext, type RequestOpts, RequiredError, type ResponseContext, ResponseError, type ResponseTransformer, type ResultContent, ResultContentFromJSON, ResultContentFromJSONTyped, ResultContentToJSON, ResultContentToJSONTyped, SearchEffortLevel, SearchEffortLevelFromJSON, SearchEffortLevelFromJSONTyped, SearchEffortLevelToJSON, SearchEffortLevelToJSONTyped, type SearchOperationRequest, type SearchRequest, SearchRequestFromJSON, SearchRequestFromJSONTyped, SearchRequestToJSON, SearchRequestToJSONTyped, type SearchResponse, SearchResponseFromJSON, SearchResponseFromJSONTyped, SearchResponseToJSON, SearchResponseToJSONTyped, type SourceIndex, SourceIndexFromJSON, SourceIndexFromJSONTyped, SourceIndexToJSON, SourceIndexToJSONTyped, type SourceSettings, SourceSettingsFromJSON, SourceSettingsFromJSONTyped, SourceSettingsToJSON, SourceSettingsToJSONTyped, type Sources, SourcesFromJSON, SourcesFromJSONTyped, SourcesToJSON, SourcesToJSONTyped, type StatusEvent, StatusEventFromJSON, StatusEventFromJSONTyped, StatusEventKindEnum, StatusEventToJSON, StatusEventToJSONTyped, StreamCategory, StreamCategoryFromJSON, StreamCategoryFromJSONTyped, StreamCategoryToJSON, StreamCategoryToJSONTyped, type StreamDoneEvent, StreamDoneEventFromJSON, StreamDoneEventFromJSONTyped, StreamDoneEventKindEnum, StreamDoneEventToJSON, StreamDoneEventToJSONTyped, type StreamResetEvent, StreamResetEventFromJSON, StreamResetEventFromJSONTyped, StreamResetEventKindEnum, StreamResetEventToJSON, StreamResetEventToJSONTyped, type SubagentEvent, SubagentEventEventEnum, SubagentEventFromJSON, SubagentEventFromJSONTyped, SubagentEventKindEnum, SubagentEventToJSON, SubagentEventToJSONTyped, Tako, TakoApi, type TakoApiInterface, type TakoCard, TakoCardFromJSON, TakoCardFromJSONTyped, TakoCardToJSON, TakoCardToJSONTyped, type TakoOptions, type TakoSourceSettings, TakoSourceSettingsFromJSON, TakoSourceSettingsFromJSONTyped, TakoSourceSettingsToJSON, TakoSourceSettingsToJSONTyped, TextApiResponse, type TextEvent, TextEventFromJSON, TextEventFromJSONTyped, TextEventKindEnum, TextEventToJSON, TextEventToJSONTyped, type ToolCallEvent, ToolCallEventFromJSON, ToolCallEventFromJSONTyped, ToolCallEventKindEnum, ToolCallEventToJSON, ToolCallEventToJSONTyped, type ToolErrorEvent, ToolErrorEventFromJSON, ToolErrorEventFromJSONTyped, ToolErrorEventKindEnum, ToolErrorEventToJSON, ToolErrorEventToJSONTyped, type ToolResultEvent, ToolResultEventFromJSON, ToolResultEventFromJSONTyped, ToolResultEventKindEnum, ToolResultEventToJSON, ToolResultEventToJSONTyped, type ToolRetryEvent, ToolRetryEventFromJSON, ToolRetryEventFromJSONTyped, ToolRetryEventKindEnum, ToolRetryEventToJSON, ToolRetryEventToJSONTyped, VoidApiResponse, type WebResult, WebResultFromJSON, WebResultFromJSONTyped, WebResultToJSON, WebResultToJSONTyped, canConsumeForm, exists, instanceOfAPIErrorType, instanceOfAgentEffortLevel, instanceOfAgentOutputSettings, instanceOfAgentResult, instanceOfAgentResultEvent, instanceOfAgentRun, instanceOfAgentRunRequest, instanceOfAgentRunStatus, instanceOfAgentStreamEnvelope, instanceOfAnswerResponse, instanceOfBaseAPIError, instanceOfCardSourceIndex, instanceOfCardSourceIndexSegment, instanceOfCardSourcePrivateIndex, instanceOfComponentConfig, instanceOfComponentTypeEnum, instanceOfContentFormat, instanceOfContentItem, instanceOfContentsDeliveryMode, instanceOfContentsRequest, instanceOfContentsResponse, instanceOfCreateCard400Response, instanceOfCreateCardRequest, instanceOfDataPipelineAnswerEvent, instanceOfErrorObject, instanceOfHeartbeatEvent, instanceOfIdealVizDecision, instanceOfKnowledgeCard, instanceOfKnowledgeCardMethodology, instanceOfKnowledgeCardRelevance, instanceOfKnowledgeCardSource, instanceOfKnowledgeCardSourceIndexesInner, instanceOfOutputSettings, instanceOfReasoningEvent, instanceOfResultContent, instanceOfSearchEffortLevel, instanceOfSearchRequest, instanceOfSearchResponse, instanceOfSourceIndex, instanceOfSourceSettings, instanceOfSources, instanceOfStatusEvent, instanceOfStreamCategory, instanceOfStreamDoneEvent, instanceOfStreamResetEvent, instanceOfSubagentEvent, instanceOfTakoCard, instanceOfTakoSourceSettings, instanceOfTextEvent, instanceOfToolCallEvent, instanceOfToolErrorEvent, instanceOfToolResultEvent, instanceOfToolRetryEvent, instanceOfWebResult, mapValues, querystring };