polymorph-sdk 0.1.0 → 0.2.2

package/dist/index.d.ts

@@ -1,135 +1,64 @@
-import { ToolSet, streamText, generateText } from 'ai';
-
-/**
- * Configuration options for Polymorph SDK.
- */
-interface PolymorphConfigOptions {
-    /**
-     * User role for potential RBAC functionality.
-     */
-    role: string;
-    /**
-     * API key for authentication. Can also be set via POLYMORPH_API_KEY env var.
-     */
-    apiKey?: string;
-    /**
-     * Base URL for the Polymorph API. Can also be set via POLYMORPH_BASE_URL env var.
-     */
-    baseUrl?: string;
-    /**
-     * HTTP request timeout in milliseconds. Defaults to 10000 (10 seconds).
-     */
-    httpTimeout?: number;
-    /**
-     * Whether HTTP logging is enabled. Defaults to true.
-     */
-    httpEnabled?: boolean;
-}
-/**
- * Configuration for tool logging and permissions.
- */
-declare class PolymorphConfig {
-    readonly role: string;
-    readonly apiKey: string | undefined;
-    readonly baseUrl: string | undefined;
-    readonly httpTimeout: number;
-    readonly httpEnabled: boolean;
-    constructor(options: PolymorphConfigOptions);
-    private getEnv;
-}
-
-/**
- * HTTP client for Polymorph API calls.
- *
- * All errors are caught and logged - never crashes the SDK.
- */
-declare class PolymorphHTTPClient {
-    private baseUrl;
-    private apiKey;
-    private timeout;
-    private enabled;
-    constructor(options: {
-        baseUrl?: string;
-        apiKey?: string;
-        timeout?: number;
-        enabled?: boolean;
-    });
-    /**
-     * Make a POST request to the given endpoint.
-     *
-     * Returns the response JSON if successful, undefined otherwise.
-     * All errors are caught and logged.
-     */
-    post<T = unknown>(endpoint: string, payload: Record<string, unknown>): Promise<T | undefined>;
-    /**
-     * Fire-and-forget POST request. Does not wait for response.
-     */
-    postFireAndForget(endpoint: string, payload: Record<string, unknown>): void;
-}
-
-/**
- * Log an entry to configured destinations.
- */
-declare function log(entry: Record<string, unknown>): void;
-
-type StreamTextParams = Parameters<typeof streamText>[0];
-type GenerateTextParams = Parameters<typeof generateText>[0];
-type StreamTextResult = ReturnType<typeof streamText>;
-type GenerateTextResult = ReturnType<typeof generateText>;
-/**
- * Hook context passed to pre/post tool hooks.
- */
-interface ToolHookContext {
-    toolName: string;
-    toolCallId: string;
-    input: unknown;
-}
-/**
- * Pre-tool hook result. Return `{ deny: true, reason: string }` to deny the tool call.
- */
-interface PreToolHookResult {
-    deny?: boolean;
-    reason?: string;
-}
-/**
- * Post-tool hook context with the result.
- */
-interface PostToolHookContext extends ToolHookContext {
-    result: unknown;
-    error?: Error;
-    durationMs: number;
-}
-/**
- * Options for creating a Polymorph AI client.
- */
-interface PolymorphAIClientOptions {
-    config: PolymorphConfig;
-}
-/**
- * Polymorph AI client that wraps Vercel AI SDK functions with tool logging.
- */
-declare class PolymorphAIClient {
-    private config;
-    private httpClient;
-    private preToolHook;
-    private postToolHook;
-    constructor(options: PolymorphAIClientOptions);
-    /**
-     * Wraps tools with Polymorph logging hooks.
-     */
-    wrapTools<T extends ToolSet>(tools: T): T;
-    /**
-     * Creates a wrapped streamText function that automatically wraps tools.
-     */
-    streamText(originalStreamText: typeof streamText): (params: StreamTextParams) => StreamTextResult;
-    /**
-     * Creates a wrapped generateText function that automatically wraps tools.
-     */
-    generateText(originalGenerateText: typeof generateText): (params: GenerateTextParams) => GenerateTextResult;
-}
-/**
- * Creates a Polymorph AI client for wrapping Vercel AI SDK functions.
- */
-declare function createPolymorphAIClient(options: PolymorphAIClientOptions): PolymorphAIClient;
-
-export { PolymorphAIClient, type PolymorphAIClientOptions, PolymorphConfig, type PolymorphConfigOptions, PolymorphHTTPClient, type PostToolHookContext, type PreToolHookResult, type ToolHookContext, createPolymorphAIClient, log };
+import { JSX } from 'react/jsx-runtime';
+import { Room } from 'livekit-client';
+
+export declare interface ChatMessage {
+    id: string;
+    role: "user" | "agent";
+    text: string;
+    source: "chat" | "voice";
+    timestamp: number;
+}
+
+export declare function PolymorphWidget(props: WidgetConfig): JSX.Element;
+
+declare interface RoomConnection {
+    token: string;
+    livekitUrl: string;
+}
+
+export declare type SessionStatus = "idle" | "connecting" | "connected" | "error";
+
+export declare function usePolymorphSession(config: WidgetConfig): {
+    status: SessionStatus;
+    roomConnection: RoomConnection | null;
+    messages: ChatMessage[];
+    isVoiceEnabled: boolean;
+    isMicActive: boolean;
+    error: string | null;
+    connect: () => Promise<void>;
+    disconnect: () => void;
+    addMessage: (role: "user" | "agent", text: string, source: "chat" | "voice") => void;
+    sendMessage: (text: string) => void;
+    toggleMic: () => Promise<void>;
+    toggleVoice: () => Promise<void>;
+    setRoom: (room: Room | null) => void;
+};
+
+export declare interface WidgetBranding {
+    /** FAB and accent color (default: "#171717") */
+    primaryColor?: string;
+    /** Panel header title (default: "Hi there") */
+    title?: string;
+    /** Panel subheader */
+    subtitle?: string;
+    /** Initial message shown before agent connects */
+    greeting?: string;
+}
+
+export declare interface WidgetConfig {
+    apiBaseUrl: string;
+    apiKey?: string;
+    /** LiveKit dispatched agent name (default: "custom-voice-agent"). */
+    agentName?: string;
+    metadata?: Record<string, string | string[]>;
+    branding?: WidgetBranding;
+    position?: "bottom-right" | "bottom-left";
+    /** Enable voice call (default: true). When false, widget is chat-only. */
+    enableVoice?: boolean;
+    /** Extra options passed to fetch (e.g. { credentials: "include" }) */
+    fetchOptions?: RequestInit;
+    /** Render widget in dark mode (default: false) */
+    darkMode?: boolean;
+}
+
+export { }