@waniwani/sdk 0.19.9 → 0.20.0

package/dist/legacy/index.d.ts

@@ -1,1820 +0,0 @@
-import { McpServer, ToolCallback } from '@modelcontextprotocol/sdk/server/mcp.js';
-export { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { z } from 'zod';
-import { ZodRawShapeCompat, ShapeOutput } from '@modelcontextprotocol/sdk/server/zod-compat.js';
-export { ZodRawShapeCompat } from '@modelcontextprotocol/sdk/server/zod-compat.js';
-import { ToolAnnotations, ContentBlock, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import * as React$1 from 'react';
-import React__default, { ReactNode, JSX, SetStateAction } from 'react';
-import * as ai from 'ai';
-import { UIMessage } from 'ai';
-
-type WidgetCSP = {
-    /** Domains permitted for fetch/XHR network requests */
-    connect_domains?: string[];
-    /** Domains for static assets (images, fonts, scripts, styles) */
-    resource_domains?: string[];
-    /** Origins allowed for iframe embeds (triggers stricter app review) */
-    frame_domains?: string[];
-    /** Origins that can receive openExternal redirects without safe-link modal */
-    redirect_domains?: string[];
-};
-type ResourceConfig = {
-    /** Unique identifier for the resource */
-    id: string;
-    /** Display title */
-    title: string;
-    /** UI description (describes WHAT the resource displays) */
-    description?: string;
-    /** Base URL for fetching the HTML */
-    baseUrl: string;
-    /** Path to the HTML file (relative to baseUrl) */
-    htmlPath: string;
-    /** Domain for OpenAI security context */
-    widgetDomain: string;
-    /** Whether widget prefers border (defaults to true) */
-    prefersBorder?: boolean;
-    /** When true, the iframe height auto-adapts to its content */
-    autoHeight?: boolean;
-    /** Content Security Policy configuration */
-    widgetCSP?: WidgetCSP;
-};
-type RegisteredResource = {
-    readonly id: string;
-    readonly title: string;
-    readonly description: string | undefined;
-    /** OpenAI URI: ui://widgets/apps-sdk/{id}.html */
-    readonly openaiUri: string;
-    /** MCP URI: ui://widgets/ext-apps/{id}.html */
-    readonly mcpUri: string;
-    readonly autoHeight: boolean | undefined;
-    /** Register this resource on an McpServer */
-    register: (server: McpServer) => Promise<void>;
-};
-
-/**
- * Creates a reusable UI resource (HTML template) that can be attached
- * to tools or flow nodes.
- *
- * @deprecated Prefer `createFlow` with `showWidget` from `@waniwani/sdk/mcp` for new code.
- *   `createResource` is preserved for back-compat with existing customer MCPs but is no longer
- *   documented; it will move to `@waniwani/sdk/legacy` in a future minor release.
- *
- * @example
- * ```ts
- * const pricingUI = createResource({
- *   id: "pricing_table",
- *   title: "Pricing Table",
- *   baseUrl: "https://my-app.com",
- *   htmlPath: "/widgets/pricing",
- *   widgetDomain: "my-app.com",
- * });
- *
- * await pricingUI.register(server);
- * ```
- */
-declare function createResource(config: ResourceConfig): RegisteredResource;
-
-interface SearchResult {
-    source: string;
-    heading: string;
-    content: string;
-    score: number;
-    metadata?: Record<string, string>;
-}
-interface KbSearchTrace {
-    query: string;
-    resultCount: number;
-    results: Array<Pick<SearchResult, "source" | "heading" | "score">>;
-}
-/** A file to ingest into the knowledge base */
-interface KbIngestFile {
-    /** Filename (used as chunk source identifier) */
-    filename: string;
-    /** Markdown content of the file */
-    content: string;
-    /** Arbitrary key-value metadata attached to all chunks from this file */
-    metadata?: Record<string, string>;
-}
-/** Response from the ingest endpoint */
-interface KbIngestResult {
-    /** Number of chunks created from the ingested files */
-    chunksIngested: number;
-    /** Number of files successfully processed */
-    filesProcessed: number;
-}
-/** Options for the search method */
-interface KbSearchOptions {
-    /** Number of results to return (1-20, default 5) */
-    topK?: number;
-    /** Minimum similarity score threshold (0-1, default 0.3) */
-    minScore?: number;
-    /** Filter results to chunks whose metadata contains all these key-value pairs (exact match) */
-    metadata?: Record<string, string>;
-}
-/** A source entry in the knowledge base */
-interface KbSource {
-    /** Source filename */
-    source: string;
-    /** Number of chunks from this source */
-    chunkCount: number;
-    /** ISO timestamp of when the source was first ingested */
-    createdAt: string;
-}
-/** KB client for server-side knowledge base operations */
-interface KbClient {
-    /**
-     * Ingest files into the knowledge base.
-     *
-     * **Warning**: This is destructive — it deletes ALL existing chunks
-     * for the environment before ingesting the new files.
-     */
-    ingest(files: KbIngestFile[]): Promise<KbIngestResult>;
-    /** Search the knowledge base for relevant chunks */
-    search(query: string, options?: KbSearchOptions): Promise<SearchResult[]>;
-    /** List all sources in the knowledge base */
-    sources(): Promise<KbSource[]>;
-}
-
-/**
- * Every event name in the typed taxonomy, as a runtime list. Single source of
- * truth for {@link EventType} and for surfaces that need to recognize
- * first-class names at runtime (the widget transport passes these through
- * verbatim instead of namespacing them as custom widget events).
- */
-declare const EVENT_TYPES: readonly ["session.started", "page.viewed", "tool.called", "link.clicked", "widget_render", "user.identified", "price_shown", "prices_compared", "option_selected", "lead_qualified", "converted", "session.error"];
-type EventType = (typeof EVENT_TYPES)[number];
-declare const SESSION_ERROR_CODES: readonly ["agent_failed", "tool_failed", "upstream_failed"];
-type SessionErrorCodeType = (typeof SESSION_ERROR_CODES)[number];
-declare const ERROR_CAUSES: readonly ["timeout", "rate_limited", "upstream_4xx", "upstream_5xx", "network", "invalid_output", "flow_dead_end", "flow_unknown_node", "flow_loop", "unknown"];
-type ErrorCauseType = (typeof ERROR_CAUSES)[number];
-/**
- * Properties for `page.viewed` — emitted once when the chat widget initializes
- * on a host page (the top of the funnel). Attributed to the anonymous
- * `visitorId` (mapped to `externalUserId`), never to a session: a page view
- * must not create a session, otherwise sessions would equal page views and the
- * "landed → started a conversation" funnel collapses.
- */
-interface PageViewedProperties {
-    /** Full URL of the host page the widget loaded on. */
-    url?: string;
-    /** Referrer of the host page, if any. */
-    referrer?: string;
-    /** Embed mode the widget initialized in. */
-    mode?: "inline" | "floating";
-    /** Resolved device type from the visitor context. */
-    deviceType?: "mobile" | "tablet" | "desktop";
-    /** Primary browser language (BCP-47). */
-    language?: string;
-    /** IANA timezone of the visitor. */
-    timezone?: string;
-}
-interface ToolCalledProperties {
-    name?: string;
-    type?: "pricing" | "product_info" | "availability" | "support" | "other";
-    /** Retrieval traces for kb.search() calls made inside this tool handler. */
-    kbSearch?: KbSearchTrace[];
-    cause?: ErrorCauseType;
-}
-interface LinkClickedProperties {
-    url?: string;
-}
-interface PriceShownProperties {
-    amount: number;
-    currency: string;
-    itemId?: string;
-    label?: string;
-}
-interface ComparedPriceOption {
-    id: string;
-    amount: number;
-    currency: string;
-}
-interface PricesComparedProperties {
-    options: ComparedPriceOption[];
-}
-interface OptionSelectedProperties {
-    id: string;
-    amount: number;
-    currency: string;
-}
-/**
- * Properties for `lead_qualified` — your code declaring that a person met your
- * qualification bar (finished the qualifying questions, requested a demo,
- * matched your target profile). Sharing an email mid-conversation is
- * `identify(userId, { email })`, not a qualified lead.
- */
-interface LeadQualifiedProperties {
-    /**
-     * Your own lead id (e.g. the record id your lead-gen API returns). The
-     * strongest dedup key and the stable reference back to your system.
-     */
-    externalId?: string;
-    /** The lead's email, if known. */
-    email?: string;
-    /** The lead's name, if known. */
-    name?: string;
-}
-interface ConvertedProperties {
-    amount: number;
-    currency: string;
-    /** When the conversion actually happened — for backdated off-platform sales. */
-    occurredAt?: string;
-}
-interface SessionErrorProperties {
-    code: SessionErrorCodeType;
-    cause: ErrorCauseType;
-    tool?: string;
-    node?: string;
-}
-interface TrackingContext {
-    /**
-     * MCP request metadata passed through to the API.
-     *
-     * Location varies by MCP library:
-     * - `@vercel/mcp-handler`: `extra._meta`
-     * - `@modelcontextprotocol/sdk`: `request.params._meta`
-     */
-    meta?: Record<string, unknown>;
-    /** Legacy metadata field supported for backward compatibility. */
-    metadata?: Record<string, unknown>;
-    /** Optional explicit correlation fields. */
-    sessionId?: string;
-    traceId?: string;
-    requestId?: string;
-    correlationId?: string;
-    externalUserId?: string;
-    /**
-     * Anonymous visitor id (the analytics "device id"). Counts as identity on
-     * its own: the ingest API accepts `sessionId`, `externalUserId`, or
-     * `visitorId`. The chat widget uses it for pre-session events like
-     * `page.viewed`.
-     */
-    visitorId?: string;
-    /** Optional explicit envelope fields. */
-    eventId?: string;
-    timestamp?: string | Date;
-    source?: string;
-}
-/**
- * Modern tracking shape (preferred).
- */
-interface BaseTrackEvent extends TrackingContext {
-    event: EventType;
-    properties?: Record<string, unknown>;
-}
-type TrackEvent = ({
-    event: "session.started";
-} & BaseTrackEvent) | ({
-    event: "page.viewed";
-    properties?: PageViewedProperties;
-} & BaseTrackEvent) | ({
-    event: "tool.called";
-    properties?: ToolCalledProperties;
-} & BaseTrackEvent) | ({
-    event: "link.clicked";
-    properties?: LinkClickedProperties;
-} & BaseTrackEvent) | ({
-    event: "user.identified";
-} & BaseTrackEvent) | ({
-    event: "widget_render";
-} & BaseTrackEvent) | ({
-    event: "price_shown";
-    properties?: PriceShownProperties;
-} & BaseTrackEvent) | ({
-    event: "prices_compared";
-    properties?: PricesComparedProperties;
-} & BaseTrackEvent) | ({
-    event: "option_selected";
-    properties?: OptionSelectedProperties;
-} & BaseTrackEvent) | ({
-    event: "lead_qualified";
-    properties?: LeadQualifiedProperties;
-} & BaseTrackEvent) | ({
-    event: "converted";
-    properties?: ConvertedProperties;
-} & BaseTrackEvent) | ({
-    event: "session.error";
-    properties?: SessionErrorProperties;
-} & BaseTrackEvent);
-/**
- * Legacy tracking shape supported for existing integrations.
- */
-interface LegacyTrackEvent extends TrackingContext {
-    eventType: EventType;
-    properties?: Record<string, unknown>;
-    toolName?: string;
-    toolType?: ToolCalledProperties["type"];
-    linkUrl?: string;
-}
-/**
- * Public track input accepted by `client.track()`.
- */
-type TrackInput = TrackEvent | LegacyTrackEvent;
-interface RevenuePriceShownInput extends TrackingContext, PriceShownProperties {
-}
-interface RevenuePricesComparedInput extends TrackingContext, PricesComparedProperties {
-}
-interface RevenueOptionSelectedInput extends TrackingContext, OptionSelectedProperties {
-}
-/**
- * Input for `track.leadQualified()` — identity only (`externalId`, `email`,
- * `name`) plus the shared tracking context. There is no acquisition-source
- * property; the envelope `source` (the origin channel) is set automatically.
- */
-interface RevenueLeadQualifiedInput extends TrackingContext, LeadQualifiedProperties {
-}
-interface RevenueConvertedInput extends TrackingContext, ConvertedProperties {
-}
-/**
- * Revenue-oriented helpers, flat on `client.track.*` (e.g.
- * `client.track.priceShown()`, `client.track.converted()`). Decoupled from
- * product primitives — each maps to a typed first-class revenue event.
- */
-interface RevenueTrackingApi {
-    priceShown: (input: RevenuePriceShownInput) => Promise<{
-        eventId: string;
-    }>;
-    pricesCompared: (input: RevenuePricesComparedInput) => Promise<{
-        eventId: string;
-    }>;
-    optionSelected: (input: RevenueOptionSelectedInput) => Promise<{
-        eventId: string;
-    }>;
-    leadQualified: (input?: RevenueLeadQualifiedInput) => Promise<{
-        eventId: string;
-    }>;
-    converted: (input: RevenueConvertedInput) => Promise<{
-        eventId: string;
-    }>;
-}
-/**
- * `client.track` — callable for generic events (`track(event)`), with the
- * revenue helpers attached flat: `track.priceShown()`, `track.leadQualified()`,
- * `track.converted()`, etc.
- */
-interface TrackFn extends RevenueTrackingApi {
-    (event: TrackInput): Promise<{
-        eventId: string;
-    }>;
-}
-interface TrackingConfig {
-    /** Events API V2 endpoint path. */
-    endpointPath?: string;
-    /** Periodic flush interval for buffered events. */
-    flushIntervalMs?: number;
-    /** Max events per HTTP batch send. */
-    maxBatchSize?: number;
-    /** Max in-memory buffer size before oldest items are dropped. */
-    maxBufferSize?: number;
-    /** Number of retries for retryable failures. */
-    maxRetries?: number;
-    /** Retry backoff base delay. */
-    retryBaseDelayMs?: number;
-    /** Retry backoff max delay. */
-    retryMaxDelayMs?: number;
-    /** Default shutdown timeout when none is provided. */
-    shutdownTimeoutMs?: number;
-}
-interface TrackingShutdownOptions {
-    timeoutMs?: number;
-}
-interface TrackingShutdownResult {
-    timedOut: boolean;
-    pendingEvents: number;
-}
-/**
- * Tracking module methods for WaniWaniClient.
- */
-interface TrackingClient {
-    /**
-     * Send a one-shot identify event for a user.
-     * userId can be any string: an email, an internal ID, etc.
-     */
-    identify: (userId: string, properties?: Record<string, unknown>, meta?: Record<string, unknown>) => Promise<{
-        eventId: string;
-    }>;
-    /**
-     * Track an event using modern or legacy input shape.
-     * Returns a deterministic event id immediately after enqueue.
-     *
-     * Also exposes the revenue helpers flat: `client.track.priceShown()`,
-     * `client.track.leadQualified()`, `client.track.converted()`, etc.
-     */
-    track: TrackFn;
-    /**
-     * Flush all currently buffered events.
-     */
-    flush: () => Promise<void>;
-    /**
-     * Flush and stop the transport.
-     */
-    shutdown: (options?: TrackingShutdownOptions) => Promise<TrackingShutdownResult>;
-}
-
-/**
- * A request-scoped Waniwani client with meta pre-attached.
- *
- * Available as `context.waniwani` inside `createTool` handlers and flow nodes
- * when the server is wrapped with `withWaniwani()`.
- */
-interface ScopedWaniWaniClient {
-    /**
-     * The session id this request's events correlate to, resolved from the
-     * request meta. Read it to link the session to your own records (store it
-     * on a lead, then send an off-platform `converted` with the same
-     * `sessionId` later). `undefined` when the host provided no session id.
-     */
-    readonly sessionId?: string;
-    /**
-     * The anonymous visitor id, resolved from the request meta. Present on the
-     * web chat surface (a persisted per-device id threaded through as
-     * `waniwani/visitorId`); `undefined` on hosts that do not supply one, such
-     * as Claude. Ingest accepts it as an identity in its own right, so use it
-     * to correlate events before a session or user id exists.
-     */
-    readonly visitorId?: string;
-    /**
-     * The external user id, resolved from the request meta (e.g. `openai/userId`
-     * for ChatGPT's anonymous users, or a host-provided `externalUserId`). Read
-     * it alongside `sessionId`/`visitorId` — whichever the current host provides.
-     * `undefined` when the host supplied no user id.
-     */
-    readonly externalUserId?: string;
-    /**
-     * Track an event — request meta is automatically merged. Also exposes the
-     * revenue helpers flat (`track.priceShown()`, `track.converted()`, …), which
-     * inherit the same scoped meta (so identity is carried from the request).
-     */
-    track: TrackFn;
-    /** Identify a user — request meta is automatically merged. */
-    identify(userId: string, properties?: Record<string, unknown>): Promise<{
-        eventId: string;
-    }>;
-    /** Knowledge base client (no meta needed). */
-    readonly kb: KbClient;
-    /** @internal Resolved API config from withWaniwani(). */
-    readonly _config?: {
-        apiUrl?: string;
-        apiKey?: string;
-    };
-}
-
-type ToolHandlerContext = {
-    /** Raw MCP request extra data (includes _meta for session extraction) */
-    extra?: {
-        _meta?: Record<string, unknown>;
-    };
-    /** Session-scoped Waniwani client — available when the server is wrapped with withWaniwani() */
-    waniwani?: ScopedWaniWaniClient;
-};
-type ToolConfig<TInput extends ZodRawShapeCompat> = {
-    /** The resource (HTML template) this tool renders. When present, tool returns structuredContent + widget _meta. */
-    resource?: RegisteredResource;
-    /** Tool identifier. Defaults to resource.id when resource is present, required otherwise. */
-    id?: string;
-    /** Display title. Defaults to resource.title when resource is present, required otherwise. */
-    title?: string;
-    /** Action-oriented description for the tool (tells the model WHEN to use it) */
-    description: string;
-    /** UI component description (describes WHAT the widget displays). Falls back to description. Only relevant when resource is present. */
-    widgetDescription?: string;
-    /** Input schema using zod */
-    inputSchema: TInput;
-    /** Optional loading message (defaults to "Loading..."). Only relevant when resource is present. */
-    invoking?: string;
-    /** Optional loaded message (defaults to "Loaded"). Only relevant when resource is present. */
-    invoked?: string;
-    /**
-     * When a widget calls this tool via `tools/call`, should the host auto-inject
-     * the tool's text result into the next follow-up message if the widget does
-     * not send one itself. Defaults to true. Set false for helper tools whose
-     * result is consumed programmatically by the widget.
-     */
-    autoInjectResultText?: boolean;
-    /**
-     * Annotations describe the tool's potential impact. Passed through to
-     * `registerTool` as-is.
-     *
-     * Includes MCP's `title` — a human-readable name for the tool. Claude's
-     * Connectors Directory requires it on every tool and flags the server at
-     * submission without it; the top-level `title` does not satisfy that.
-     */
-    annotations?: ToolAnnotations;
-};
-type ToolHandler<TInput extends ZodRawShapeCompat> = (input: ShapeOutput<TInput>, context: ToolHandlerContext) => Promise<{
-    /** Text content to return */
-    text: string;
-    /** Structured data returned as MCP `structuredContent`. */
-    data?: Record<string, unknown>;
-}>;
-type ToolToolCallback<TInput extends ZodRawShapeCompat> = ToolCallback<TInput>;
-type RegisteredTool = {
-    id: string;
-    title: string;
-    description: string;
-    /** Register the tool on the server */
-    register: (server: McpServer) => Promise<void>;
-};
-
-/**
- * Creates an MCP tool with minimal boilerplate.
- *
- * When `handler()` returns `data`, the tool includes it as MCP `structuredContent`.
- * When `config.resource` is provided, the tool also returns widget metadata.
- *
- * @deprecated Prefer `createFlow` from `@waniwani/sdk/mcp` for new code. `createTool`
- *   is preserved for back-compat with existing customer MCPs but is no longer documented;
- *   it will move to `@waniwani/sdk/legacy` in a future minor release.
- *
- * @example
- * ```ts
- * // Widget tool (with resource)
- * const pricingTool = createTool({
- *   resource: pricingUI,
- *   description: "Show pricing comparison",
- *   inputSchema: { postalCode: z.string() },
- * }, async ({ postalCode }) => ({
- *   text: "Pricing loaded",
- *   data: { postalCode, prices: [] },
- * }));
- *
- * // Plain tool (no resource)
- * const searchTool = createTool({
- *   id: "search",
- *   title: "Search",
- *   description: "Search the knowledge base",
- *   inputSchema: { query: z.string() },
- * }, async ({ query }) => ({
- *   text: `Results for "${query}"`,
- * }));
- * ```
- */
-declare function createTool<TInput extends z.ZodRawShape>(config: ToolConfig<TInput>, handler: ToolHandler<TInput>): RegisteredTool;
-/**
- * Registers multiple tools on the server.
- *
- * @deprecated Prefer `createFlow` + `.register()` for new code. Preserved for back-compat
- *   with existing customer MCPs; will move to `@waniwani/sdk/legacy` in a future minor release.
- */
-declare function registerTools(server: McpServer, tools: RegisteredTool[]): Promise<void>;
-
-/**
- * Initializes & patches Next.js functionality so an app can run as a
- * widget inside a cross-origin iframe. Used by every MCP widget host —
- * ChatGPT's sandbox, the embed's `/api/mcp/chat/resource` proxy, and any
- * future host that renders the widget on a domain other than its own
- * `baseUrl`.
- *
- * See `applyIframePatches` for the patch behavior.
- *
- * More background on the ChatGPT case:
- * https://vercel.com/blog/running-next-js-inside-chatgpt-a-deep-dive-into-native-app-integration
- *
- * @deprecated Legacy MCP-widget-in-host stack (used with `createResource`/`createTool`).
- *   Preserved for back-compat; will move to `@waniwani/sdk/legacy/react` in a future minor
- *   release.
- */
-declare function InitializeNextJsInIframe({ baseUrl, passthroughOrigins, }: {
-    baseUrl: string;
-    /**
-     * Origins whose fetches should skip the relative same-origin → baseUrl
-     * rewrite. Only needed for relative-URL calls that resolve to an
-     * origin you do not want forwarded to `baseUrl` — absolute URLs are
-     * never rewritten regardless of this list.
-     */
-    passthroughOrigins?: string[];
-}): react_jsx_runtime.JSX.Element;
-
-interface DevControlsProps {
-    defaultProps?: Record<string, unknown>;
-    widgetPaths?: string[];
-}
-/**
- * @deprecated Legacy MCP-widget-in-host stack. Preserved for back-compat; will move to
- *   `@waniwani/sdk/legacy/react` in a future minor release.
- */
-declare function DevModeProvider({ defaultProps, widgetPaths, children, }: DevControlsProps & {
-    children: React.ReactNode;
-}): react_jsx_runtime.JSX.Element | null;
-
-/**
- * Source: https://github.com/openai/openai-apps-sdk-examples/tree/main/src
- */
-type OpenAIGlobals<ToolInput = UnknownObject, ToolOutput = UnknownObject, ToolResponseMetadata = UnknownObject, WidgetState = UnknownObject> = {
-    theme: Theme;
-    userAgent: UserAgent;
-    locale: string;
-    maxHeight: number;
-    displayMode: DisplayMode;
-    safeArea: SafeArea;
-    toolInput: ToolInput;
-    toolOutput: ToolOutput | null;
-    toolResponseMetadata: ToolResponseMetadata | null;
-    widgetState: WidgetState | null;
-    setWidgetState: (state: WidgetState) => Promise<void>;
-};
-type API = {
-    callTool: CallTool;
-    sendFollowUpMessage: (args: {
-        prompt: string;
-    }) => Promise<void>;
-    openExternal(payload: {
-        href: string;
-    }): void;
-    requestDisplayMode: RequestDisplayMode;
-};
-type UnknownObject = Record<string, unknown>;
-type Theme = "light" | "dark";
-type SafeAreaInsets = {
-    top: number;
-    bottom: number;
-    left: number;
-    right: number;
-};
-type SafeArea = {
-    insets: SafeAreaInsets;
-};
-type DeviceType = "mobile" | "tablet" | "desktop" | "unknown";
-type UserAgent = {
-    device: {
-        type: DeviceType;
-    };
-    capabilities: {
-        hover: boolean;
-        touch: boolean;
-    };
-};
-/** Display mode */
-type DisplayMode = "pip" | "inline" | "fullscreen";
-type RequestDisplayMode = (args: {
-    mode: DisplayMode;
-}) => Promise<{
-    /**
-     * The granted display mode. The host may reject the request.
-     * For mobile, PiP is always coerced to fullscreen.
-     */
-    mode: DisplayMode;
-}>;
-type CallToolResponse = {
-    result: string;
-};
-/** Calling APIs */
-type CallTool = (name: string, args: Record<string, unknown>) => Promise<CallToolResponse>;
-/** Extra events */
-declare const SET_GLOBALS_EVENT_TYPE = "openai:set_globals";
-declare class SetGlobalsEvent extends CustomEvent<{
-    globals: Partial<OpenAIGlobals>;
-}> {
-    constructor(detail: {
-        globals: Partial<OpenAIGlobals>;
-    });
-}
-/**
- * Global oai object injected by the web sandbox for communicating with chatgpt host page.
- */
-declare global {
-    interface Window {
-        openai: API & OpenAIGlobals;
-        innerBaseUrl: string;
-    }
-    interface WindowEventMap {
-        [SET_GLOBALS_EVENT_TYPE]: SetGlobalsEvent;
-    }
-}
-
-declare let mockState: Omit<OpenAIGlobals, "setWidgetState">;
-declare function initializeMockOpenAI(initialToolOutput?: Record<string, unknown>): void;
-declare function updateMockGlobal<K extends keyof OpenAIGlobals>(key: K, value: OpenAIGlobals[K]): void;
-declare function getMockState(): typeof mockState;
-declare function updateMockToolOutput(props: Record<string, unknown>): void;
-declare function updateMockDisplayMode(mode: DisplayMode): void;
-declare function updateMockTheme(theme: Theme): void;
-
-type ModelContextContentBlock = ContentBlock;
-type ModelContextUpdate = {
-    content?: ModelContextContentBlock[];
-    structuredContent?: Record<string, unknown>;
-};
-
-interface SendFollowUpOptions {
-    modelContext?: ModelContextUpdate | null;
-}
-/**
- * Get a function to send follow-up messages to the AI.
- * Works on both OpenAI widgets and MCP Apps.
- *
- * @deprecated Legacy MCP-widget-in-host stack. Preserved for back-compat; will move to
- *   `@waniwani/sdk/legacy/react` in a future minor release.
- * @returns A function that sends a follow-up message
- */
-declare function useSendFollowUp(): (prompt: string, options?: SendFollowUpOptions) => void;
-
-interface UnstableSendFollowUpWithGhostGuardResult {
-    /** Wrapped `sendFollowUp`. Same signature as the one you passed in. */
-    sendFollowUp: (prompt: string, options?: SendFollowUpOptions) => void;
-    /**
-     * Wrap your widget's root render with this so the suppression can take
-     * effect. On non-ChatGPT hosts it is a transparent pass-through.
-     */
-    Guard: (props: {
-        children: ReactNode;
-    }) => JSX.Element | null;
-}
-/**
- * ⚠️ EXPERIMENTAL — DO NOT USE UNLESS YOU UNDERSTAND THE TRADE-OFFS ⚠️
- *
- * Wraps an existing `sendFollowUp` with ghost-guard suppression specific
- * to ChatGPT. ChatGPT renders the source widget a SECOND time alongside
- * the new user message a widget emits via `sendFollowUpMessage`. The
- * second iframe is a brand-new React tree with no link to the original;
- * skybridge's `useViewState` persistence does not survive across them.
- * The result is a visible duplicate widget for ~1s before ChatGPT
- * collapses one of them.
- *
- * On ChatGPT the hook adds a per-`viewUUID` `localStorage` write before
- * each `sendFollowUp` call, and the returned `Guard` checks that record
- * on mount — if it sees a record set by a different `mountId` within
- * `ADVANCED_WINDOW_MS`, it collapses the iframe to 0×0.
- *
- * On every other host (Waniwani embed, MCP Apps, etc.) the hook is a
- * pure pass-through: `sendFollowUp` is your function unchanged and
- * `Guard` is a transparent fragment.
- *
- * The hook does NOT require `WidgetProvider`. It reads the widget's
- * `viewUUID` from `WidgetClientContext` when one is available and falls
- * back to `window.openai.toolResponseMetadata.viewUUID` otherwise.
- *
- * Caveats:
- *  - Relies on ChatGPT's widget iframes sharing a single `localStorage`
- *    scope — verified at the time of writing but not guaranteed.
- *  - 10s suppression window per `viewUUID`. Two unrelated `sendFollowUp`
- *    calls inside 10s with the same viewUUID could mistakenly suppress one.
- *  - The `Guard` MUST wrap the widget's root render. If you forget it,
- *    the localStorage write happens but nothing is suppressed.
- *
- * @param sendFollowUp - The underlying `sendFollowUp` to wrap. On ChatGPT the
- *   hook adds the per-`viewUUID` localStorage write before delegating; on any
- *   other host the hook is a pure pass-through. Typically the value of
- *   `useSendFollowUpMessage()` from `skybridge/web` or `useSendFollowUp()`
- *   from this module.
- *
- * @example
- *   function MyWidget() {
- *     const sendFollowUpMessage = useSendFollowUpMessage(); // skybridge/web
- *     const { sendFollowUp, Guard } =
- *       unstable_useSendFollowUpWithGhostGuard(sendFollowUpMessage);
- *
- *     // The Guard MUST wrap the widget's root render, otherwise the ghost
- *     // iframe will not be suppressed.
- *     return (
- *       <Guard>
- *         <div className="my-widget">
- *           <button onClick={() => sendFollowUp("I uploaded my bill")}>
- *             Continue
- *           </button>
- *         </div>
- *       </Guard>
- *     );
- *   }
- *
- * @experimental Subject to change or removal without notice.
- */
-declare function unstable_useSendFollowUpWithGhostGuard(sendFollowUp: (prompt: string) => void | Promise<void>): UnstableSendFollowUpWithGhostGuardResult;
-
-/**
- * Result from calling a tool
- */
-type ToolCallResult = CallToolResult;
-/**
- * Tool result notification (what the host pushes to the widget)
- */
-type ToolResult = CallToolResult;
-/**
- * Host context - all values available from the host.
- */
-type HostContext = {
-    theme: Theme;
-    locale: string;
-    displayMode: DisplayMode;
-    maxHeight: number | null;
-    safeArea: SafeArea | null;
-    toolOutput: UnknownObject | null;
-    toolResponseMetadata: UnknownObject | null;
-    widgetState: UnknownObject | null;
-};
-/**
- * Unified widget client interface that works on both OpenAI and MCP Apps.
- *
- * Platform-specific behavior:
- * - Display mode: OpenAI-only. MCP Apps returns "inline" and requestDisplayMode is a no-op.
- * - Follow-up messages: Unified API, different underlying implementations.
- */
-interface UnifiedWidgetClient {
-    /**
-     * Connect to the host. Must be called before using other methods.
-     * On OpenAI, this is a no-op (already connected via window.openai).
-     * On MCP Apps, this establishes the postMessage connection.
-     */
-    connect(): Promise<void>;
-    /**
-     * Close the connection to the host and clean up resources.
-     * On OpenAI, this is a no-op.
-     * On MCP Apps, this closes the transport and removes event listeners.
-     */
-    close(): Promise<void>;
-    /**
-     * Get the tool output (structured content returned by the tool handler).
-     * This is the main data source for widget rendering.
-     */
-    getToolOutput<T = Record<string, unknown>>(): T | null;
-    /**
-     * Register a callback for when tool results are received.
-     * On OpenAI, this subscribes to toolOutput changes.
-     * On MCP Apps, this sets app.ontoolresult.
-     */
-    onToolResult(callback: (result: ToolResult) => void): () => void;
-    /**
-     * Call another tool on the server.
-     */
-    callTool(name: string, args: Record<string, unknown>): Promise<ToolCallResult>;
-    /**
-     * Open an external URL.
-     * On OpenAI: openai.openExternal({ href })
-     * On MCP Apps: app.sendOpenLink(url)
-     */
-    openExternal(url: string): void;
-    /**
-     * Send a follow-up message to the AI.
-     * On OpenAI: openai.sendFollowUpMessage({ prompt })
-     * On MCP Apps: app.sendMessages([{ role: 'user', content: { type: 'text', text: prompt } }])
-     */
-    sendFollowUp(prompt: string): void | Promise<void>;
-    /**
-     * Update hidden model context for the next assistant turn.
-     * On MCP Apps this uses the standard `ui/update-model-context` request.
-     * On other hosts this may fall back to best-effort behavior.
-     */
-    updateModelContext(context: ModelContextUpdate): Promise<void> | void;
-    /**
-     * Get the current theme.
-     */
-    getTheme(): Theme;
-    /**
-     * Subscribe to theme changes.
-     */
-    onThemeChange(callback: (theme: Theme) => void): () => void;
-    /**
-     * Get the current locale.
-     */
-    getLocale(): string;
-    /**
-     * Get the current display mode.
-     * OpenAI-only: returns "pip" | "inline" | "fullscreen"
-     * MCP Apps: always returns "inline"
-     */
-    getDisplayMode(): DisplayMode;
-    /**
-     * Request a display mode change.
-     * OpenAI-only: requests the mode from the host.
-     * MCP Apps: no-op (returns current mode).
-     */
-    requestDisplayMode(mode: DisplayMode): Promise<DisplayMode>;
-    /**
-     * Subscribe to display mode changes.
-     * OpenAI-only: subscribes to displayMode changes.
-     * MCP Apps: callback is never called.
-     */
-    onDisplayModeChange(callback: (mode: DisplayMode) => void): () => void;
-    /**
-     * Get the safe area insets.
-     * OpenAI-only: returns insets from window.openai.safeArea.
-     * MCP Apps: returns null.
-     */
-    getSafeArea(): SafeArea | null;
-    /**
-     * Subscribe to safe area changes.
-     * OpenAI-only: subscribes to safeArea changes.
-     * MCP Apps: callback is never called.
-     */
-    onSafeAreaChange(callback: (safeArea: SafeArea | null) => void): () => void;
-    /**
-     * Get the max height constraint.
-     * OpenAI-only: returns maxHeight from window.openai.maxHeight.
-     * MCP Apps: returns null.
-     */
-    getMaxHeight(): number | null;
-    /**
-     * Subscribe to max height changes.
-     * OpenAI-only: subscribes to maxHeight changes.
-     * MCP Apps: callback is never called.
-     */
-    onMaxHeightChange(callback: (maxHeight: number | null) => void): () => void;
-    /**
-     * Get the tool response metadata.
-     * OpenAI: returns metadata from window.openai.toolResponseMetadata.
-     * MCP Apps: returns `_meta` from the latest `ui/notifications/tool-result`, if provided by host.
-     */
-    getToolResponseMetadata(): UnknownObject | null;
-    /**
-     * Subscribe to tool response metadata changes.
-     * OpenAI: subscribes to toolResponseMetadata changes.
-     * MCP Apps: fires when tool result `_meta` changes.
-     */
-    onToolResponseMetadataChange(callback: (metadata: UnknownObject | null) => void): () => void;
-    /**
-     * Get the widget state.
-     * OpenAI-only: returns state from window.openai.widgetState.
-     * MCP Apps: returns null.
-     */
-    getWidgetState(): UnknownObject | null;
-    /**
-     * Subscribe to widget state changes.
-     * OpenAI-only: subscribes to widgetState changes.
-     * MCP Apps: callback is never called.
-     */
-    onWidgetStateChange(callback: (state: UnknownObject | null) => void): () => void;
-}
-
-/**
- * Get a function to call other tools.
- * Works on both OpenAI widgets and MCP Apps.
- *
- * @deprecated Legacy MCP-widget-in-host stack. Preserved for back-compat; will move to
- *   `@waniwani/sdk/legacy/react` in a future minor release.
- * @returns A function to call tools with their name and arguments
- */
-declare function useCallTool(): (name: string, args: Record<string, unknown>) => Promise<ToolCallResult>;
-
-/**
- * Get the current display mode.
- * Works on both OpenAI widgets and MCP Apps.
- *
- * @deprecated Legacy MCP-widget-in-host stack. Preserved for back-compat; will move to
- *   `@waniwani/sdk/legacy/react` in a future minor release.
- * @returns The current display mode ("pip" | "inline" | "fullscreen")
- */
-declare function useDisplayMode(): DisplayMode;
-
-/** Return type of the useFlowAction hook */
-type FlowActionResult<T> = {
-    /** Current widget data from structuredContent. */
-    data: T | null;
-};
-/**
- * Hook for reading flow widget data from structuredContent.
- * Lightweight wrapper over `useToolOutput` — will be extended
- * with flow-specific features in the future.
- *
- * @deprecated Legacy MCP-widget-in-host stack. Preserved for back-compat; will move to
- *   `@waniwani/sdk/legacy/react` in a future minor release.
- *
- * @example
- * ```tsx
- * const { data } = useFlowAction<{ plans: string[] }>();
- * if (!data) return null;
- * return <PricingTable plans={data.plans} />;
- * ```
- */
-declare function useFlowAction<T extends Record<string, unknown>>(): FlowActionResult<T>;
-
-/**
- * Check if running in ChatGPT app (OpenAI-only).
- * Returns false on MCP Apps.
- *
- * @deprecated Legacy MCP-widget-in-host stack. Preserved for back-compat; will move to
- *   `@waniwani/sdk/legacy/react` in a future minor release.
- * @returns Whether the widget is running in ChatGPT app
- */
-declare function useIsChatGptApp(): boolean;
-
-/**
- * Get the current locale.
- * Works on both OpenAI widgets and MCP Apps.
- *
- * @deprecated Legacy MCP-widget-in-host stack. Preserved for back-compat; will move to
- *   `@waniwani/sdk/legacy/react` in a future minor release.
- * @returns The current locale string (e.g., "en-US")
- */
-declare function useLocale(): string;
-
-/**
- * Get the maximum height available for the widget (OpenAI-only).
- * Useful for responsive layouts that need to adapt to container constraints.
- * Returns null on MCP Apps.
- *
- * @deprecated Legacy MCP-widget-in-host stack. Preserved for back-compat; will move to
- *   `@waniwani/sdk/legacy/react` in a future minor release.
- * @returns The maximum height in pixels, or null if not available
- */
-declare function useMaxHeight(): number | null;
-
-/**
- * Get a function to open external URLs.
- * Works on both OpenAI widgets and MCP Apps.
- *
- * @deprecated Legacy MCP-widget-in-host stack. Preserved for back-compat; will move to
- *   `@waniwani/sdk/legacy/react` in a future minor release.
- * @returns A function that opens external URLs
- */
-declare function useOpenExternal(): (url: string) => void;
-
-/**
- * Get a function to request display mode changes.
- * On MCP Apps, this may be a no-op depending on host support.
- *
- * @deprecated Legacy MCP-widget-in-host stack. Preserved for back-compat; will move to
- *   `@waniwani/sdk/legacy/react` in a future minor release.
- * @returns A function to request a specific display mode
- */
-declare function useRequestDisplayMode(): (mode: DisplayMode) => Promise<DisplayMode>;
-
-/**
- * Get safe area insets (OpenAI-only).
- * Useful for ensuring UI elements don't get hidden behind the chat input.
- * Returns null on MCP Apps.
- *
- * @deprecated Legacy MCP-widget-in-host stack. Preserved for back-compat; will move to
- *   `@waniwani/sdk/legacy/react` in a future minor release.
- * @returns The safe area insets, or null if not available
- */
-declare function useSafeArea(): SafeArea | null;
-
-/**
- * Get the current theme.
- * Works on both OpenAI widgets and MCP Apps.
- *
- * @deprecated Legacy MCP-widget-in-host stack. Preserved for back-compat; will move to
- *   `@waniwani/sdk/legacy/react` in a future minor release.
- * @returns The current theme ("light" | "dark")
- */
-declare function useTheme(): Theme;
-
-/**
- * Get the tool output (structured content returned by the tool handler).
- * Works on both OpenAI widgets and MCP Apps.
- *
- * @deprecated Legacy MCP-widget-in-host stack. Preserved for back-compat; will move to
- *   `@waniwani/sdk/legacy/react` in a future minor release.
- * @returns The tool output or null
- */
-declare function useToolOutput<T extends Record<string, unknown>>(): T | null;
-
-/**
- * Get tool response metadata.
- * Contains host/tool metadata (for example identifiers like
- * `openai/widgetSessionId` and custom tool `_meta` fields).
- * Returns null when the host does not provide metadata.
- *
- * @deprecated Legacy MCP-widget-in-host stack. Preserved for back-compat; will move to
- *   `@waniwani/sdk/legacy/react` in a future minor release.
- * @returns The tool response metadata object or null if not available
- */
-declare function useToolResponseMetadata(): UnknownObject | null;
-
-/**
- * Get a function to update hidden model context for the next assistant turn.
- * Uses the MCP Apps `ui/update-model-context` request when available.
- *
- * @deprecated Legacy MCP-widget-in-host stack. Preserved for back-compat; will move to
- *   `@waniwani/sdk/legacy/react` in a future minor release.
- */
-declare function useUpdateModelContext(): (context: ModelContextUpdate) => Promise<void>;
-
-/**
- * Provider props
- */
-interface WidgetProviderProps {
-    children: ReactNode;
-    /** Optional loading component while connecting */
-    loading?: ReactNode;
-    /** Optional error component */
-    onError?: (error: Error) => ReactNode;
-}
-/**
- * Provider component that initializes the correct widget client based on platform.
- * Wrap your widget component with this provider.
- *
- * @deprecated Part of the legacy MCP-widget-in-host stack (used with `createResource` /
- *   `createTool`). Preserved for back-compat; will move to `@waniwani/sdk/legacy/react` in
- *   a future minor release. For new code, use `createFlow` from `@waniwani/sdk/mcp` and
- *   `useWaniwani` from `@waniwani/sdk/mcp/react`.
- *
- * @example
- * ```tsx
- * function App() {
- *   return (
- *     <WidgetProvider loading={<Spinner />}>
- *       <MyWidget />
- *     </WidgetProvider>
- *   );
- * }
- * ```
- */
-declare function WidgetProvider({ children, loading, onError, }: WidgetProviderProps): React__default.FunctionComponentElement<React__default.FragmentProps> | React__default.FunctionComponentElement<React__default.ProviderProps<UnifiedWidgetClient | null>>;
-/**
- * Keys that can be selected from the widget client.
- */
-type WidgetKey = "toolOutput" | "theme" | "displayMode" | "locale" | "safeArea" | "maxHeight" | "toolResponseMetadata" | "widgetState";
-/**
- * Value types for each widget key.
- */
-type WidgetKeyValues = {
-    toolOutput: Record<string, unknown> | null;
-    theme: Theme;
-    displayMode: DisplayMode;
-    locale: string;
-    safeArea: SafeArea | null;
-    maxHeight: number | null;
-    toolResponseMetadata: UnknownObject | null;
-    widgetState: UnknownObject | null;
-};
-/**
- * Get the unified widget client instance.
- * Must be used within a WidgetProvider.
- *
- * @deprecated Legacy MCP-widget-in-host stack. Preserved for back-compat; will move to
- *   `@waniwani/sdk/legacy/react` in a future minor release.
- *
- * @example
- * ```tsx
- * // Full client for actions
- * const client = useWidgetClient();
- * client.callTool("foo", {});
- *
- * // Key selector for reactive values
- * const toolOutput = useWidgetClient("toolOutput");
- * const theme = useWidgetClient("theme");
- * ```
- */
-declare function useWidgetClient(): UnifiedWidgetClient;
-declare function useWidgetClient<K extends WidgetKey>(key: K): WidgetKeyValues[K];
-
-/**
- * Widget state that persists across widget lifecycles (OpenAI-only).
- * State is synchronized with the ChatGPT parent window and survives widget minimize/restore.
- * On MCP Apps, returns [null, no-op].
- *
- * @deprecated Legacy MCP-widget-in-host stack. Preserved for back-compat; will move to
- *   `@waniwani/sdk/legacy/react` in a future minor release.
- * @param defaultState - Initial state value or function to compute it
- * @returns A tuple of [state, setState] similar to useState
- */
-declare function useWidgetState<T extends UnknownObject>(defaultState?: T | (() => T | null) | null): readonly [T | null, (state: SetStateAction<T | null>) => void];
-
-/**
- * Default loading fallback for legacy MCP widgets.
- *
- * @deprecated Legacy MCP-widget-in-host stack. Preserved for back-compat; will move to
- *   `@waniwani/sdk/legacy/react` in a future minor release.
- */
-declare const LoadingWidget: () => react_jsx_runtime.JSX.Element;
-
-/**
- * Widget platform types
- */
-type WidgetPlatform = "openai" | "mcp-apps";
-/**
- * Detects which platform the widget is running on.
- *
- * OpenAI injects a global `window.openai` object.
- * MCP Apps runs in a sandboxed iframe and uses postMessage.
- *
- * @deprecated Legacy MCP-widget-in-host stack. Preserved for back-compat; will move to
- *   `@waniwani/sdk/legacy/react` in a future minor release.
- */
-declare function detectPlatform(): WidgetPlatform;
-/**
- * Check if running on OpenAI platform.
- *
- * @deprecated Legacy MCP-widget-in-host stack. Preserved for back-compat; will move to
- *   `@waniwani/sdk/legacy/react` in a future minor release.
- */
-declare function isOpenAI(): boolean;
-/**
- * Check if running on MCP Apps platform.
- *
- * @deprecated Legacy MCP-widget-in-host stack. Preserved for back-compat; will move to
- *   `@waniwani/sdk/legacy/react` in a future minor release.
- */
-declare function isMCPApps(): boolean;
-
-/**
- * Waniwani SDK Client
- *
- * Extends with each module:
- * - TrackingClient: track(), flush(), shutdown()
- *
- * Pass this client to framework adapters:
- * - `toNextJsHandler(wani, { ... })` for Next.js route handlers
- */
-interface WaniWaniClient extends TrackingClient {
-    /** @internal Resolved config — used by framework adapters */
-    readonly _config: InternalConfig;
-    /** Knowledge base client for ingestion, search, and source listing */
-    readonly kb: KbClient;
-}
-interface InternalConfig {
-    apiUrl: string;
-    apiKey: string | undefined;
-    tracking: Required<TrackingConfig>;
-}
-
-/**
- * Server-side geolocation extracted from platform headers (Vercel, Cloudflare).
- * All fields are optional — in local dev, no headers are present.
- */
-interface GeoLocation {
-    city?: string;
-    country?: string;
-    countryRegion?: string;
-    latitude?: string;
-    longitude?: string;
-    timezone?: string;
-    ip?: string;
-}
-
-/** Client-side visitor context sent in the request body */
-interface ClientVisitorContext {
-    timezone: string;
-    language: string;
-    languages: string[];
-    deviceType: "mobile" | "tablet" | "desktop";
-    referrer: string;
-    visitorId: string;
-}
-/** Combined visitor context: server geo + client context */
-interface VisitorMeta {
-    geo: GeoLocation;
-    client: ClientVisitorContext | null;
-}
-interface BeforeRequestContext {
-    /** The conversation messages from the client */
-    messages: UIMessage[];
-    /** Session identifier for conversation continuity */
-    sessionId?: string;
-    /** Hidden widget-provided model context for the next assistant turn */
-    modelContext?: ModelContextUpdate;
-    /** The original HTTP Request object */
-    request: Request;
-    /** Server-extracted geo location + client-provided visitor context */
-    visitor: VisitorMeta;
-}
-type BeforeRequestResult = {
-    /** Override messages (e.g., filtered, augmented) */
-    messages?: UIMessage[];
-    /** Override the system prompt for this request */
-    systemPrompt?: string;
-    /** Override sessionId */
-    sessionId?: string;
-    /** Override hidden widget-provided model context */
-    modelContext?: ModelContextUpdate;
-};
-interface WebSearchConfig {
-    /** Restrict web search results to these domains */
-    includeDomains?: string[];
-    /** Exclude these domains from web search results */
-    excludeDomains?: string[];
-}
-interface ChatOptions {
-    /**
-     * System prompt for the assistant.
-     * Can be overridden per-request via `beforeRequest`.
-     */
-    systemPrompt?: string;
-    /**
-     * Maximum number of tool call steps. Defaults to 5.
-     */
-    maxSteps?: number;
-    /**
-     * Hook called before each request is forwarded to the Waniwani API.
-     * - Return void to use defaults.
-     * - Return an object to override messages, systemPrompt, or sessionId.
-     * - Throw to reject the request (the error message is returned as JSON).
-     */
-    beforeRequest?: (context: BeforeRequestContext) => Promise<BeforeRequestResult | undefined> | BeforeRequestResult | undefined;
-    /**
-     * Override the MCP server URL directly, bypassing config resolution.
-     * Useful for development/testing when pointing to a local MCP server.
-     */
-    mcpServerUrl?: string;
-    /**
-     * Enable web search as an additional tool alongside MCP tools.
-     * Pass `true` to enable with defaults, or a config object to restrict domains.
-     */
-    webSearch?: boolean | WebSearchConfig;
-}
-
-interface NextJsHandlerOptions {
-    /** Chat handler configuration */
-    chat?: ChatOptions;
-    /**
-     * Identifies this chatbar instance in analytics.
-     * Use a descriptive name like "hamilton-support" or "pricing-page".
-     * Shows up as `source` on tracked events.
-     */
-    source: string;
-    /**
-     * Enable verbose debug logging for all handler steps.
-     * Logs request details, response codes, resolved URLs, and caught errors.
-     */
-    debug?: boolean;
-}
-interface NextJsHandlerResult {
-    /** GET handler: routes sub-paths (e.g. /resource for MCP widget content) */
-    GET: (request: Request) => Promise<Response>;
-    /** POST handler: proxies chat messages to the Waniwani API */
-    POST: (request: Request) => Promise<Response>;
-    /** PATCH handler: routes updates (e.g. /scenarios/:id) */
-    PATCH: (request: Request) => Promise<Response>;
-    /** OPTIONS handler: CORS preflight */
-    OPTIONS: (request: Request) => Response;
-}
-
-/**
- * Create Next.js route handlers from a Waniwani client.
- *
- * Returns `{ GET, POST }` for use with catch-all routes.
- * Mount at `app/api/waniwani/[[...path]]/route.ts`:
- *
- * - `POST /api/waniwani`              → chat (proxied to Waniwani API)
- * - `GET  /api/waniwani/resource?uri=…` → MCP resource content
- *
- * @deprecated The chat-server catch-all adapters are being phased out. The chat widget
- *   will talk directly to `app.waniwani.ai` in a future release, removing the need for a
- *   self-hosted BFF. This export is preserved for back-compat with existing customer MCPs
- *   but is no longer documented; it will move to `@waniwani/sdk/legacy/next-js` in a future
- *   minor release.
- *
- * @example
- * ```typescript
- * // app/api/waniwani/[[...path]]/route.ts
- * import { waniwani } from "@waniwani/sdk";
- * import { toNextJsHandler } from "@waniwani/sdk/next-js";
- *
- * const wani = waniwani();
- *
- * export const { GET, POST } = toNextJsHandler(wani, {
- *   chat: {
- *     systemPrompt: "You are a helpful assistant.",
- *     mcpServerUrl: process.env.MCP_SERVER_URL!,
- *   },
- * });
- * ```
- */
-declare function toNextJsHandler(client: WaniWaniClient, options: NextJsHandlerOptions): NextJsHandlerResult;
-
-/**
- * English catalog. Source of truth — every other locale must mirror this
- * shape exactly (the `Messages` type is inferred from here).
- */
-interface Messages {
-    promptInput: {
-        placeholder: string;
-        uploadFiles: string;
-        stop: string;
-        submit: string;
-        removeAttachments: string;
-    };
-    workingIndicator: {
-        default: string;
-    };
-    reasoning: {
-        thinking: string;
-        thoughtBrief: string;
-        thoughtForSeconds: (count: number) => string;
-    };
-    /** Chain-of-thought header (no icon): a generic label per state. */
-    chainOfThought: {
-        working: string;
-        done: string;
-    };
-    tool: {
-        copy: string;
-        copied: string;
-        request: string;
-        response: string;
-        error: string;
-    };
-    attachments: {
-        attachmentFallback: string;
-        fileFallback: string;
-    };
-    threadMenu: {
-        newChat: string;
-        threadHistory: string;
-        deleteThread: string;
-        noPreviousChats: string;
-        hiddenThreads: (count: number) => string;
-    };
-    chatQueue: {
-        attachmentFallback: string;
-        removeFromQueue: string;
-        queued: (count: number) => string;
-    };
-    poweredBy: {
-        label: string;
-    };
-    aiDisclaimer: {
-        default: string;
-    };
-    exportSession: {
-        saving: string;
-        saved: string;
-        error: string;
-        export: string;
-        tooltip: string;
-    };
-    widgetErrorBoundary: {
-        failedToLoad: string;
-        retry: string;
-    };
-    launcher: {
-        prompt: string;
-        open: string;
-        close: string;
-        minimize: string;
-    };
-}
-
-type DeepPartial<T> = T extends (...args: never[]) => unknown ? T : T extends object ? {
-    [K in keyof T]?: DeepPartial<T[K]>;
-} : T;
-type MessageOverrides = DeepPartial<Messages>;
-
-/**
- * A visitor id to apply, or a resolver that produces one. The resolver may be
- * sync (`() => posthog.get_distinct_id()`) or async
- * (`async () => (await sdk.ready()).id`), for analytics SDKs whose id is only
- * available after they bootstrap.
- */
-type VisitorIdInput = string | (() => string | undefined | null | Promise<string | undefined | null>);
-
-/** One pill. `id` is null unless it came from an authored per-page prompt. */
-interface Suggestion {
-    id: string | null;
-    text: string;
-}
-/**
- * One field per origin. `null` means the origin has nothing to say — no entry
- * on this turn, or the rung no longer applies.
- *
- * `flow` alone treats `[]` as authoritative: it clears the row and suppresses
- * every weaker rung. Elsewhere `[]` and `null` are the same.
- */
-interface SuggestionCandidates {
-    flow: Suggestion[] | null;
-    followup: Suggestion[] | null;
-    page: Suggestion[] | null;
-    channel: Suggestion[] | null;
-}
-/**
- * The rungs an embed host reads from `/config`. Grouped because they share a
- * source and a lifetime: both stop applying at the visitor's first message.
- */
-type PreChatSuggestions = Pick<SuggestionCandidates, "page" | "channel">;
-
-/**
- * Built-in theme presets. `auto` follows the host's `prefers-color-scheme`
- * and switches at runtime without re-rendering.
- */
-type ThemePreset = "light" | "dark" | "auto";
-/**
- * Appearance config for the chat widget. Pick a preset and (optionally) layer
- * per-property `variables` on top.
- *
- * ```ts
- * appearance: { theme: "dark", variables: { primaryColor: "#ff6b6b" } }
- * ```
- *
- * The same shape is accepted by the `embed.js` script (`init({ appearance })`),
- * `<WaniwaniChat overrides={{ appearance }} />`, and `<ChatEmbed appearance />`.
- */
-interface ChatAppearance {
-    /** Base theme preset. Defaults to `"light"`. */
-    theme?: ThemePreset;
-    /** Per-property overrides applied on top of the preset. */
-    variables?: ChatTheme;
-    /**
-     * Render assistant messages inside a filled bubble (background + padding +
-     * radius), styled by `variables.assistantBubbleColor` /
-     * `assistantBubbleTextColor`. Defaults to `false` — assistant messages
-     * render as plain text. Opt in for a "both sides bubbled" chat style.
-     */
-    assistantBubble?: boolean;
-}
-/**
- * Tool-call activity rendering mode. Steps are grouped into one collapsible
- * "chain of thought".
- *
- * - `true` (default) — each step expands to its request/response JSON.
- * - `"titles-only"` — step labels only, no JSON.
- * - `false` — the chain (and the reasoning trace) are hidden entirely; only
- *   a generic working indicator shows while the agent works.
- */
-type ShowToolCalls = boolean | "titles-only";
-
-interface ChatTheme {
-    /** Primary brand color (bubble, send button, user messages) */
-    primaryColor?: string;
-    /** Primary text color on primary background */
-    primaryForeground?: string;
-    /** Chat panel background */
-    backgroundColor?: string;
-    /** Default text color */
-    textColor?: string;
-    /** Secondary/muted text */
-    mutedColor?: string;
-    /** Border color */
-    borderColor?: string;
-    /** Border width for the panel (px). Defaults to 0 (no border). */
-    borderWidth?: number;
-    /** Box-shadow shorthand applied to the panel. Use any valid CSS box-shadow string (e.g. `"0 10px 25px rgba(0,0,0,0.1)"`). Defaults to `none`. */
-    boxShadow?: string;
-    /** Assistant message bubble background */
-    assistantBubbleColor?: string;
-    /** User message bubble background */
-    userBubbleColor?: string;
-    /** Input field background */
-    inputBackgroundColor?: string;
-    /** Border radius for the panel (px) */
-    borderRadius?: number;
-    /** Border radius for message bubbles (px) */
-    messageBorderRadius?: number;
-    /** Font family */
-    fontFamily?: string;
-    /** Header background color (card layout). Falls back to backgroundColor. */
-    headerBackgroundColor?: string;
-    /** Header text color. Falls back to textColor. */
-    headerTextColor?: string;
-    /** Status dot color. Defaults to green (#22c55e). */
-    statusColor?: string;
-    /** Tool call JSON section background. Defaults to light gray / #262626 in dark. */
-    toolCardColor?: string;
-    /** Text color inside the user message bubble. Falls back to `primaryForeground`. */
-    userBubbleTextColor?: string;
-    /** Text color inside the assistant message bubble (only visible when `appearance.assistantBubble` is enabled). Falls back to `textColor`. */
-    assistantBubbleTextColor?: string;
-    /** Horizontal padding inside message bubbles (px). Defaults to 16. */
-    messagePaddingX?: number;
-    /** Vertical padding inside message bubbles (px). Defaults to 12. */
-    messagePaddingY?: number;
-    /** Max width of a message bubble as a CSS length/percentage. Defaults to `"80%"`. */
-    messageMaxWidth?: string;
-    /** Base font size for message text (px). When unset, messages use the CSS default of `1rem` (16px at the standard root font size). */
-    fontSize?: number;
-    /** Base line height for message text (unitless string, e.g. `"1.5"`). Defaults to `"1.5"`. */
-    lineHeight?: string;
-    /** Frosted-glass tint color for the floating bar's suggestion card, layered
-     *  over the backdrop blur. Programmatic-only via appearance.variables.
-     *  Unset = the default neutral glass (unchanged). */
-    glassTint?: string;
-    /** Strength of the glass tint, 0–1 as a unitless string (e.g. "0.5").
-     *  Unset/"0" = no tint (default rendering). */
-    glassTintStrength?: string;
-}
-interface WelcomeConfig {
-    /** Icon displayed above the title. Accepts any React node (e.g. an SVG or img). */
-    icon?: React.ReactNode;
-    /** Title text shown prominently in the welcome screen. */
-    title: string;
-    /** Description text shown below the title. */
-    description?: string;
-    /** Suggestion cards shown in the welcome screen. Disappear after the first message. */
-    suggestions?: string[];
-}
-interface SuggestionsConfig {
-    /**
-     * Starter prompts shown before the user sends their first message.
-     * Defaults to an empty array.
-     */
-    initial?: string[];
-}
-/**
- * Per-slot class name overrides for the chat widget. Each string is appended
- * to the slot's own classes (merged with `tailwind-merge`, `ww` prefix). Use
- * with your own (prefixed or plain) CSS to restyle any element. In the React
- * path these reach into internals directly; in the `<script>` embed, prefer
- * the stable `.ww-*` semantic classes with a `data-css` stylesheet.
- */
-interface ChatClassNames {
-    /** Root chat container. */
-    root?: string;
-    /** Sticky header bar. */
-    header?: string;
-    /** Every message wrapper (both roles). */
-    message?: string;
-    /** The user message bubble content. */
-    userBubble?: string;
-    /** The assistant message bubble content. */
-    assistantBubble?: string;
-    /** The input bar container. */
-    input?: string;
-}
-interface ChatBaseProps {
-    /** Waniwani project API key */
-    apiKey?: string;
-    /** Chat API endpoint URL. Defaults to Waniwani hosted endpoint */
-    api?: string;
-    /** Pre-loaded messages to display when the chat mounts. */
-    initialMessages?: ai.UIMessage[];
-    /** Initial greeting shown before user types */
-    welcomeMessage?: string;
-    /**
-     * Rich welcome screen shown when the conversation is empty.
-     * Replaces `welcomeMessage` with a centered layout featuring an icon, title,
-     * description, and card-style suggestion prompts.
-     * Takes precedence over `welcomeMessage` when provided.
-     */
-    welcome?: WelcomeConfig;
-    /**
-     * Theme preset (`light`/`dark`/`auto`) plus per-property overrides.
-     * See `ChatAppearance` for the shape.
-     */
-    appearance?: ChatAppearance;
-    /** Per-slot class name overrides. See {@link ChatClassNames}. */
-    classNames?: ChatClassNames;
-    /**
-     * Override the anonymous visitor id the widget generates with one you
-     * already track (a PostHog / Amplitude / Segment distinct id, your own
-     * cookie, etc.). The chat sends it on every request, so Waniwani sessions
-     * and events correlate to the same visitor, and server-side MCP tools and
-     * flows read it back as `context.waniwani.visitorId`.
-     *
-     * A string, or a resolver that returns one — sync
-     * (`() => posthog.get_distinct_id()`) or async
-     * (`async () => (await sdk.ready()).id`), for analytics SDKs whose id is
-     * only ready after they bootstrap. A blank / failed result is ignored, so
-     * the auto-generated, `localStorage`-persisted id is kept. Leave unset to
-     * always use the auto id.
-     */
-    visitorId?: VisitorIdInput;
-    /** Additional headers to send with chat API requests */
-    headers?: Record<string, string>;
-    /** Additional body fields to send with each chat request */
-    body?: Record<string, unknown>;
-    /** Enable file attachments in the input. Defaults to false. */
-    allowAttachments?: boolean;
-    /** Placeholder text shown in the input field. Defaults to "Ask me anything...". Animates with a typing effect. */
-    placeholder?: string;
-    /**
-     * Name of a custom DOM event to listen for that triggers focus (scroll + glow) and optionally sends a message.
-     * Dispatch via `new CustomEvent('triggerDemoRequest', { detail: { message: 'Hi!' } })`.
-     * Set to `false` to disable. Defaults to `"triggerDemoRequest"`.
-     */
-    triggerEvent?: string | false;
-    /** Callback fired when a message is sent */
-    onMessageSent?: (message: string) => void;
-    /** Callback fired when a response is received */
-    onResponseReceived?: () => void;
-    /**
-     * Suggestion pills. The row obeys a fixed hierarchy — flow > followup >
-     * page > channel — and every origin is always active.
-     *
-     * `false` hides the row; `true` / unset is the default. `{ initial: [...] }`
-     * sets starter prompts. Embed hosts pass the resolved
-     * {@link PreChatSuggestions} from `useSuggestions(config)` instead, which
-     * carries the prompt ids needed for click attribution.
-     */
-    suggestions?: boolean | SuggestionsConfig | PreChatSuggestions;
-    /**
-     * Handler for MCP tool calls from widgets.
-     * Called when a widget uses `callServerTool` (MCP Apps standard).
-     * If not provided, defaults to POSTing to `${api}/tool`.
-     */
-    onCallTool?: CallToolHandler;
-    /**
-     * Enable debug mode. When true, the `_meta` field is shown in tool call
-     * inputs and outputs instead of being filtered out.
-     * Tip: set to `process.env.NEXT_PUBLIC_WANIWANI_DEBUG === '1'` to mirror
-     * the server-side `WANIWANI_DEBUG` env var.
-     */
-    debug?: boolean;
-    /**
-     * How the agent's tool-call activity renders. Steps are grouped into a
-     * single collapsible "chain of thought" that auto-expands while the agent
-     * works and collapses to a summary once it settles.
-     *
-     * - `true` (default) — each step expands to its request/response JSON.
-     * - `"titles-only"` — step labels only, no JSON.
-     * - `false` — the chain is hidden entirely, along with the reasoning
-     *   trace; only the generic "On it…" indicator shows while the agent works.
-     *
-     * MCP App widgets attached to a tool call are always rendered.
-     */
-    showToolCalls?: ShowToolCalls;
-    /**
-     * Skip fetching `/config` and `/tools` from the API on mount.
-     * Use when the chat endpoint doesn't serve these routes (e.g. embed widgets
-     * talking directly to the Waniwani app).
-     * @internal
-     */
-    skipRemoteConfig?: boolean;
-    /**
-     * Persist the conversation across page reloads using IndexedDB so the user
-     * can resume previous threads. Defaults to `false` — opt in explicitly.
-     */
-    enableThreadHistory?: boolean;
-    /**
-     * Force a specific thread to be active. When provided, the embed renders
-     * that thread's messages and ignores the most-recently-updated default.
-     */
-    activeThreadId?: string;
-    /** Fired whenever the active thread changes (new chat, switch, delete). */
-    onThreadChange?: (threadId: string) => void;
-    /**
-     * AI transparency notice rendered under the input (EU AI Act compliance).
-     * Defaults to `"AI can make mistakes. Verify important information."`.
-     * Pass a string to override the wording, or `false` to hide it entirely.
-     */
-    disclaimer?: string | false;
-    /**
-     * UI language for built-in labels (buttons, placeholders, status text).
-     * Supports `"en"`, `"fr"`, `"es"`. When omitted, the widget detects the
-     * locale from `<html lang>` and `navigator.language(s)`, falling back
-     * to English.
-     */
-    locale?: string;
-    /**
-     * Per-key overrides on top of the resolved locale catalog. Use this to
-     * tweak individual built-in strings without contributing a new locale.
-     *
-     * ```tsx
-     * messages={{ promptInput: { placeholder: "Ask the agent…" } }}
-     * ```
-     */
-    messages?: MessageOverrides;
-}
-/** Handler signature for MCP tool calls from widgets. */
-type CallToolHandler = (params: {
-    name: string;
-    arguments: Record<string, unknown>;
-}) => Promise<{
-    content?: Array<{
-        type: string;
-        text?: string;
-    }>;
-    structuredContent?: Record<string, unknown>;
-    _meta?: Record<string, unknown>;
-}>;
-interface ChatHandle {
-    /** Programmatically send a user message into the chat */
-    sendMessage: (text: string) => void;
-    /**
-     * Send a user message and wait for the assistant response to complete.
-     * Returns the final assistant message. Useful for eval/testing flows.
-     */
-    sendMessageAndWait: (text: string) => Promise<unknown>;
-    /** Clear all messages and start a fresh conversation */
-    reset: () => void;
-    /** Scroll to the chat input, focus it, and show a highlight glow */
-    focus: () => void;
-    /** Current chat messages */
-    messages: ai.UIMessage[];
-    /** Session ID used for event correlation. Available after the first message. */
-    sessionId: string | undefined;
-    /**
-     * Track a funnel event from the host page with the chat session attached
-     * automatically. Same surface as the server client: callable with a typed
-     * event, plus the flat revenue helpers (`track.converted({ ... })`, ...).
-     * Present on `WaniwaniChat` (hosted); absent on the bare `ChatEmbed`
-     * primitive, which has no Waniwani credential to send events with.
-     */
-    track?: TrackFn;
-    /**
-     * Tie the visitor to a stable user id (emits `user.identified`).
-     * Present on `WaniwaniChat` only, like `track`.
-     */
-    identify?: (userId: string, traits?: Record<string, unknown>) => Promise<{
-        eventId: string;
-    }>;
-}
-
-/** @deprecated Use `WaniwaniChat` (hosted, React) or the `<script>` embed for new code. `ChatCard` is preserved for back-compat only and lives under `@waniwani/sdk/legacy`. */
-interface ChatCardProps extends ChatBaseProps {
-    /** Title shown in the card header. Defaults to "Assistant". */
-    title?: string;
-    /** Subtitle or status text shown under the title. */
-    subtitle?: string;
-    /** Show the status dot in the header. Defaults to true. */
-    showStatus?: boolean;
-    /** Card width. Accepts a pixel number or any CSS value (e.g. "100%", "50vw"). Defaults to 500. */
-    width?: number | string;
-    /** Card height. Accepts a pixel number or any CSS value (e.g. "100%", "80vh"). Defaults to 600. */
-    height?: number | string;
-    /** Additional class names applied to the root element (e.g. Tailwind classes). */
-    className?: string;
-    /** Theme overrides. Legacy API; new code should use the `appearance` field on `WaniwaniChat` / `ChatEmbed`. */
-    theme?: ChatTheme;
-}
-/**
- * @deprecated Use `WaniwaniChat` from `@waniwani/sdk/chat` for new code.
- * `ChatCard` is preserved for back-compat with customer MCPs that pre-date
- * the hosted-tier React component. It is also re-exported from
- * `@waniwani/sdk/chat` for now; that re-export will be removed in a future
- * minor release — import from `@waniwani/sdk/legacy` going forward.
- */
-declare const ChatCard: React$1.ForwardRefExoticComponent<ChatCardProps & React$1.RefAttributes<ChatHandle>>;
-
-export { ChatCard, type ChatCardProps, DevModeProvider, type DeviceType, type DisplayMode, type FlowActionResult, type HostContext, InitializeNextJsInIframe, LoadingWidget, type ModelContextContentBlock, type ModelContextUpdate, type NextJsHandlerOptions, type NextJsHandlerResult, type RegisteredResource, type RegisteredTool, type ResourceConfig, type SafeArea, type SafeAreaInsets, type SendFollowUpOptions, type Theme, type ToolCallResult, type ToolConfig, type ToolHandler, type ToolHandlerContext, type ToolResult, type ToolToolCallback, type UnifiedWidgetClient, type UnknownObject, type UnstableSendFollowUpWithGhostGuardResult, type UserAgent, type WidgetCSP, type WidgetPlatform, WidgetProvider, createResource, createTool, detectPlatform, getMockState, initializeMockOpenAI, isMCPApps, isOpenAI, registerTools, toNextJsHandler, unstable_useSendFollowUpWithGhostGuard, updateMockDisplayMode, updateMockGlobal, updateMockTheme, updateMockToolOutput, useCallTool, useDisplayMode, useFlowAction, useIsChatGptApp, useLocale, useMaxHeight, useOpenExternal, useRequestDisplayMode, useSafeArea, useSendFollowUp, useTheme, useToolOutput, useToolResponseMetadata, useUpdateModelContext, useWidgetClient, useWidgetState };