@waniwani/sdk 0.12.8 → 0.12.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waniwani/sdk",
-  "version": "0.12.8",
+  "version": "0.12.9",
   "description": "MCP distribution SDK. Build sales funnels, lead generation, booking, and quote apps on top of your MCP server. Event tracking, flows, widgets, knowledge base.",
   "type": "module",
   "exports": {

package/dist/chat/server/index.d.ts

@@ -1,145 +0,0 @@
-import { UIMessage } from 'ai';
-import { ContentBlock } from '@modelcontextprotocol/sdk/types.js';
-
-declare class WaniWaniError extends Error {
-    status: number;
-    constructor(message: string, status: number);
-}
-
-type ModelContextContentBlock = ContentBlock;
-type ModelContextUpdate = {
-    content?: ModelContextContentBlock[];
-    structuredContent?: Record<string, unknown>;
-};
-
-/**
- * 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;
-}
-/**
- * Extracts geolocation from server-side request headers.
- *
- * Supports Vercel (`x-vercel-ip-*`), Cloudflare (`cf-ip*`, `cf-connecting-ip`),
- * and generic IP headers (`x-real-ip`, `x-forwarded-for`).
- *
- * Returns a `GeoLocation` with all fields optional (empty object in local dev).
- */
-declare function extractGeoFromHeaders(request: Request): GeoLocation;
-
-/** 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 ApiHandlerOptions {
-    /**
-     * Identifies this chatbar instance in analytics.
-     * Forwarded as `waniwani/source` in MCP request metadata.
-     */
-    source?: string;
-    /**
-     * Your WaniWani API key.
-     * Defaults to process.env.WANIWANI_API_KEY.
-     */
-    apiKey?: string;
-    /**
-     * The base URL of the WaniWani API.
-     * Defaults to https://app.waniwani.ai.
-     */
-    apiUrl?: string;
-    /**
-     * 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 verbose debug logging for all handler steps.
-     * Logs request details, response codes, resolved URLs, and caught errors.
-     */
-    debug?: boolean;
-    /**
-     * 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 ApiHandler {
-    /** Proxies chat messages to the WaniWani API */
-    handleChat: (request: Request) => Promise<Response>;
-    /** Serves MCP resource content (HTML widgets) */
-    handleResource: (url: URL) => Promise<Response>;
-    /** Calls an MCP server tool and returns JSON */
-    handleTool: (request: Request) => Promise<Response>;
-    /** Routes GET sub-paths (e.g. /resource) */
-    routeGet: (request: Request) => Promise<Response>;
-    /** Routes POST sub-paths (e.g. /tool), defaults to chat */
-    routePost: (request: Request) => Promise<Response>;
-    /** Routes PATCH sub-paths (e.g. /scenarios/:id) */
-    routePatch: (request: Request) => Promise<Response>;
-    /** Handles CORS preflight requests */
-    handleOptions: () => Response;
-}
-
-export { type ApiHandler, type ApiHandlerOptions, type BeforeRequestContext, type BeforeRequestResult, type ClientVisitorContext, type GeoLocation, type VisitorMeta, WaniWaniError, type WebSearchConfig, extractGeoFromHeaders };

package/dist/kb/index.d.ts

@@ -1,84 +0,0 @@
-interface SearchResult {
-    source: string;
-    heading: string;
-    content: string;
-    score: number;
-    metadata?: Record<string, string>;
-}
-/** 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[]>;
-}
-
-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 InternalConfig {
-    apiUrl: string;
-    apiKey: string | undefined;
-    tracking: Required<TrackingConfig>;
-}
-
-declare function createKbClient(config: InternalConfig): KbClient;
-
-export { type KbClient, type KbIngestFile, type KbIngestResult, type KbSearchOptions, type KbSource, type SearchResult, createKbClient };