@informedai/react 0.1.0 → 0.2.0

package/dist/index.d.mts

@@ -71,12 +71,10 @@ interface Document {
     };
 }
 interface InformedAssistantConfig {
-    /** API key for authentication (wsk_...) */
-    apiKey: string;
+    /** Document Type ID - identifies which form schema to use */
+    documentTypeId: string;
     /** API base URL (defaults to https://api.informedassistant.ai/api/v1) */
     apiUrl?: string;
-    /** Document ID to work with */
-    documentId: string;
     /** Optional: Existing session ID to resume */
     sessionId?: string;
     /** Callback when a field value is applied */
@@ -119,14 +117,6 @@ interface UseSessionReturn {
     applyPendingValue: () => Promise<void>;
     skipTask: () => Promise<void>;
 }
-interface UseDocumentReturn {
-    document: Document | null;
-    documentType: DocumentType | null;
-    isLoading: boolean;
-    error: Error | null;
-    updateField: (fieldName: string, value: unknown) => Promise<void>;
-    refetch: () => Promise<void>;
-}
 
 interface InformedAssistantProps extends InformedAssistantConfig {
     /** Additional CSS class name */
@@ -173,62 +163,74 @@ declare function InformedAIProvider({ config, children }: InformedAIProviderProp
  */
 
 interface UseSessionOptions {
-    apiKey: string;
+    /** Document Type ID - identifies which form schema to use */
+    documentTypeId: string;
+    /** API base URL (defaults to https://api.informedassistant.ai/api/v1) */
     apiUrl?: string;
-    documentId: string;
+    /** Optional: Existing session ID to resume */
     sessionId?: string;
+    /** Callback when session state changes */
     onSessionChange?: (session: Session) => void;
+    /** Callback when an error occurs */
     onError?: (error: Error) => void;
 }
 declare function useSession(options: UseSessionOptions): UseSessionReturn;
 
-/**
- * useDocument Hook
- * For developers who want direct access to document management
- */
-
-interface UseDocumentOptions {
-    apiKey: string;
-    apiUrl?: string;
-    documentId: string;
-    onError?: (error: Error) => void;
-}
-declare function useDocument(options: UseDocumentOptions): UseDocumentReturn;
-
 /**
  * InformedAI API Client
  * Handles all communication with the InformedAI backend
+ *
+ * Uses keyless widget endpoints with domain-based authentication.
  */
 
+interface CreateSessionResponse {
+    session: Session;
+    document: Document;
+    documentType: {
+        id: string;
+        name: string;
+        displayName: string;
+        schema: unknown;
+    };
+}
+interface ApplyResponse {
+    session: Session;
+    appliedField: string;
+    appliedValue: unknown;
+}
 declare class InformedAIClient {
-    private apiKey;
     private apiUrl;
-    constructor(apiKey: string, apiUrl?: string);
+    constructor(apiUrl?: string);
     private getHeaders;
     private request;
-    getDocument(id: string): Promise<Document>;
-    getDocumentType(id: string): Promise<DocumentType>;
-    updateDocumentField(documentId: string, field: string, value: unknown): Promise<Document>;
-    createSession(documentId: string): Promise<Session>;
+    /**
+     * Create a new session for a document type.
+     * This automatically creates a document with default values.
+     */
+    createSession(documentTypeId: string): Promise<CreateSessionResponse>;
+    /**
+     * Get an existing session.
+     */
     getSession(id: string): Promise<Session>;
-    deleteSession(id: string): Promise<void>;
     /**
-     * Send a message to the session with SSE streaming
+     * Send a message to the session with SSE streaming.
      */
     sendMessage(sessionId: string, message: string, onEvent: (event: SSEEvent) => void): Promise<void>;
     /**
-     * Send a quick action to the session with SSE streaming
+     * Send a quick action to the session.
+     * For actions that trigger AI (task_action:*), returns SSE stream.
+     * For other actions (select_task:*, resume_task:*), returns session directly.
      */
-    sendQuickAction(sessionId: string, action: string, payload?: Record<string, unknown>, onEvent?: (event: SSEEvent) => void): Promise<Session>;
+    sendQuickAction(sessionId: string, action: string, onEvent?: (event: SSEEvent) => void): Promise<Session>;
     /**
-     * Apply the pending value for the active task
+     * Apply the pending value for the active task.
      */
-    applyPendingValue(sessionId: string): Promise<Session>;
+    applyPendingValue(sessionId: string): Promise<ApplyResponse>;
     /**
-     * Skip the active task
+     * Skip the active task.
      */
     skipTask(sessionId: string): Promise<Session>;
     private processSSEStream;
 }
 
-export { type ChatMessage, type Document, type DocumentType, type DocumentTypeSchema, type FieldDefinition, InformedAIClient, InformedAIProvider, InformedAssistant, type InformedAssistantConfig, type QuickAction, type SSEEvent, type Session, type TaskConfig, type TaskState, type UseDocumentReturn, type UseSessionReturn, type WidgetMessage, type WidgetTheme, useDocument, useInformedAI, useSession };
+export { type ChatMessage, type Document, type DocumentType, type DocumentTypeSchema, type FieldDefinition, InformedAIClient, InformedAIProvider, InformedAssistant, type InformedAssistantConfig, type QuickAction, type SSEEvent, type Session, type TaskConfig, type TaskState, type UseSessionReturn, type WidgetMessage, type WidgetTheme, useInformedAI, useSession };

package/dist/index.d.ts

@@ -71,12 +71,10 @@ interface Document {
     };
 }
 interface InformedAssistantConfig {
-    /** API key for authentication (wsk_...) */
-    apiKey: string;
+    /** Document Type ID - identifies which form schema to use */
+    documentTypeId: string;
     /** API base URL (defaults to https://api.informedassistant.ai/api/v1) */
     apiUrl?: string;
-    /** Document ID to work with */
-    documentId: string;
     /** Optional: Existing session ID to resume */
     sessionId?: string;
     /** Callback when a field value is applied */
@@ -119,14 +117,6 @@ interface UseSessionReturn {
     applyPendingValue: () => Promise<void>;
     skipTask: () => Promise<void>;
 }
-interface UseDocumentReturn {
-    document: Document | null;
-    documentType: DocumentType | null;
-    isLoading: boolean;
-    error: Error | null;
-    updateField: (fieldName: string, value: unknown) => Promise<void>;
-    refetch: () => Promise<void>;
-}
 
 interface InformedAssistantProps extends InformedAssistantConfig {
     /** Additional CSS class name */
@@ -173,62 +163,74 @@ declare function InformedAIProvider({ config, children }: InformedAIProviderProp
  */
 
 interface UseSessionOptions {
-    apiKey: string;
+    /** Document Type ID - identifies which form schema to use */
+    documentTypeId: string;
+    /** API base URL (defaults to https://api.informedassistant.ai/api/v1) */
     apiUrl?: string;
-    documentId: string;
+    /** Optional: Existing session ID to resume */
     sessionId?: string;
+    /** Callback when session state changes */
     onSessionChange?: (session: Session) => void;
+    /** Callback when an error occurs */
     onError?: (error: Error) => void;
 }
 declare function useSession(options: UseSessionOptions): UseSessionReturn;
 
-/**
- * useDocument Hook
- * For developers who want direct access to document management
- */
-
-interface UseDocumentOptions {
-    apiKey: string;
-    apiUrl?: string;
-    documentId: string;
-    onError?: (error: Error) => void;
-}
-declare function useDocument(options: UseDocumentOptions): UseDocumentReturn;
-
 /**
  * InformedAI API Client
  * Handles all communication with the InformedAI backend
+ *
+ * Uses keyless widget endpoints with domain-based authentication.
  */
 
+interface CreateSessionResponse {
+    session: Session;
+    document: Document;
+    documentType: {
+        id: string;
+        name: string;
+        displayName: string;
+        schema: unknown;
+    };
+}
+interface ApplyResponse {
+    session: Session;
+    appliedField: string;
+    appliedValue: unknown;
+}
 declare class InformedAIClient {
-    private apiKey;
     private apiUrl;
-    constructor(apiKey: string, apiUrl?: string);
+    constructor(apiUrl?: string);
     private getHeaders;
     private request;
-    getDocument(id: string): Promise<Document>;
-    getDocumentType(id: string): Promise<DocumentType>;
-    updateDocumentField(documentId: string, field: string, value: unknown): Promise<Document>;
-    createSession(documentId: string): Promise<Session>;
+    /**
+     * Create a new session for a document type.
+     * This automatically creates a document with default values.
+     */
+    createSession(documentTypeId: string): Promise<CreateSessionResponse>;
+    /**
+     * Get an existing session.
+     */
     getSession(id: string): Promise<Session>;
-    deleteSession(id: string): Promise<void>;
     /**
-     * Send a message to the session with SSE streaming
+     * Send a message to the session with SSE streaming.
      */
     sendMessage(sessionId: string, message: string, onEvent: (event: SSEEvent) => void): Promise<void>;
     /**
-     * Send a quick action to the session with SSE streaming
+     * Send a quick action to the session.
+     * For actions that trigger AI (task_action:*), returns SSE stream.
+     * For other actions (select_task:*, resume_task:*), returns session directly.
      */
-    sendQuickAction(sessionId: string, action: string, payload?: Record<string, unknown>, onEvent?: (event: SSEEvent) => void): Promise<Session>;
+    sendQuickAction(sessionId: string, action: string, onEvent?: (event: SSEEvent) => void): Promise<Session>;
     /**
-     * Apply the pending value for the active task
+     * Apply the pending value for the active task.
      */
-    applyPendingValue(sessionId: string): Promise<Session>;
+    applyPendingValue(sessionId: string): Promise<ApplyResponse>;
     /**
-     * Skip the active task
+     * Skip the active task.
      */
     skipTask(sessionId: string): Promise<Session>;
     private processSSEStream;
 }
 
-export { type ChatMessage, type Document, type DocumentType, type DocumentTypeSchema, type FieldDefinition, InformedAIClient, InformedAIProvider, InformedAssistant, type InformedAssistantConfig, type QuickAction, type SSEEvent, type Session, type TaskConfig, type TaskState, type UseDocumentReturn, type UseSessionReturn, type WidgetMessage, type WidgetTheme, useDocument, useInformedAI, useSession };
+export { type ChatMessage, type Document, type DocumentType, type DocumentTypeSchema, type FieldDefinition, InformedAIClient, InformedAIProvider, InformedAssistant, type InformedAssistantConfig, type QuickAction, type SSEEvent, type Session, type TaskConfig, type TaskState, type UseSessionReturn, type WidgetMessage, type WidgetTheme, useInformedAI, useSession };

package/dist/index.js

@@ -23,7 +23,6 @@ __export(index_exports, {
   InformedAIClient: () => InformedAIClient,
   InformedAIProvider: () => InformedAIProvider,
   InformedAssistant: () => InformedAssistant,
-  useDocument: () => useDocument,
   useInformedAI: () => useInformedAI,
   useSession: () => useSession
 });
@@ -38,14 +37,12 @@ var import_react = require("react");
 // src/utils/api-client.ts
 var DEFAULT_API_URL = "https://api.informedassistant.ai/api/v1";
 var InformedAIClient = class {
-  constructor(apiKey, apiUrl) {
-    this.apiKey = apiKey;
+  constructor(apiUrl) {
     this.apiUrl = apiUrl || DEFAULT_API_URL;
   }
   getHeaders() {
     return {
-      "Content-Type": "application/json",
-      "Authorization": `Bearer ${this.apiKey}`
+      "Content-Type": "application/json"
     };
   }
   async request(endpoint, options = {}) {
@@ -66,40 +63,29 @@ var InformedAIClient = class {
     return response.json();
   }
   // ========================================================================
-  // Document Operations
+  // Widget Session Operations (keyless)
   // ========================================================================
-  async getDocument(id) {
-    return this.request(`/documents/${id}`);
-  }
-  async getDocumentType(id) {
-    return this.request(`/document-types/${id}`);
-  }
-  async updateDocumentField(documentId, field, value) {
-    return this.request(`/documents/${documentId}/field`, {
-      method: "PATCH",
-      body: JSON.stringify({ field, value })
-    });
-  }
-  // ========================================================================
-  // Session Operations
-  // ========================================================================
-  async createSession(documentId) {
-    return this.request("/sessions", {
+  /**
+   * Create a new session for a document type.
+   * This automatically creates a document with default values.
+   */
+  async createSession(documentTypeId) {
+    return this.request("/widget/sessions", {
       method: "POST",
-      body: JSON.stringify({ documentId })
+      body: JSON.stringify({ documentTypeId })
     });
   }
+  /**
+   * Get an existing session.
+   */
   async getSession(id) {
-    return this.request(`/sessions/${id}`);
-  }
-  async deleteSession(id) {
-    await this.request(`/sessions/${id}`, { method: "DELETE" });
+    return this.request(`/widget/sessions/${id}`);
   }
   /**
-   * Send a message to the session with SSE streaming
+   * Send a message to the session with SSE streaming.
    */
   async sendMessage(sessionId, message, onEvent) {
-    const response = await fetch(`${this.apiUrl}/sessions/${sessionId}/message`, {
+    const response = await fetch(`${this.apiUrl}/widget/sessions/${sessionId}/message`, {
       method: "POST",
       headers: this.getHeaders(),
       body: JSON.stringify({ message })
@@ -111,43 +97,50 @@ var InformedAIClient = class {
     await this.processSSEStream(response, onEvent);
   }
   /**
-   * Send a quick action to the session with SSE streaming
+   * Send a quick action to the session.
+   * For actions that trigger AI (task_action:*), returns SSE stream.
+   * For other actions (select_task:*, resume_task:*), returns session directly.
    */
-  async sendQuickAction(sessionId, action, payload, onEvent) {
-    const response = await fetch(`${this.apiUrl}/sessions/${sessionId}/quick-action`, {
+  async sendQuickAction(sessionId, action, onEvent) {
+    const response = await fetch(`${this.apiUrl}/widget/sessions/${sessionId}/quick-action`, {
       method: "POST",
       headers: this.getHeaders(),
-      body: JSON.stringify({ action, payload })
+      body: JSON.stringify({ action })
     });
     if (!response.ok) {
       const error = await response.json().catch(() => ({ error: "Request failed" }));
       throw new Error(error.error || `HTTP ${response.status}`);
     }
-    let finalSession = null;
-    await this.processSSEStream(response, (event) => {
-      onEvent?.(event);
-      if (event.session) {
-        finalSession = event.session;
+    const contentType = response.headers.get("content-type") || "";
+    if (contentType.includes("text/event-stream")) {
+      let finalSession = null;
+      await this.processSSEStream(response, (event) => {
+        onEvent?.(event);
+        if (event.session) {
+          finalSession = event.session;
+        }
+      });
+      if (!finalSession) {
+        return this.getSession(sessionId);
       }
-    });
-    if (!finalSession) {
-      throw new Error("No session returned from quick action");
+      return finalSession;
+    } else {
+      return response.json();
     }
-    return finalSession;
   }
   /**
-   * Apply the pending value for the active task
+   * Apply the pending value for the active task.
    */
   async applyPendingValue(sessionId) {
-    return this.request(`/sessions/${sessionId}/apply`, {
+    return this.request(`/widget/sessions/${sessionId}/apply`, {
       method: "POST"
     });
   }
   /**
-   * Skip the active task
+   * Skip the active task.
    */
   async skipTask(sessionId) {
-    return this.request(`/sessions/${sessionId}/skip`, {
+    return this.request(`/widget/sessions/${sessionId}/skip`, {
       method: "POST"
     });
   }
@@ -211,25 +204,37 @@ function InformedAIProvider({ config, children }) {
   const [streamingContent, setStreamingContent] = (0, import_react.useState)("");
   const clientRef = (0, import_react.useRef)(null);
   (0, import_react.useEffect)(() => {
-    clientRef.current = new InformedAIClient(config.apiKey, config.apiUrl);
-  }, [config.apiKey, config.apiUrl]);
+    clientRef.current = new InformedAIClient(config.apiUrl);
+  }, [config.apiUrl]);
   (0, import_react.useEffect)(() => {
     async function initialize() {
       if (!clientRef.current) return;
       try {
         setIsLoading(true);
         setError(null);
-        const doc = await clientRef.current.getDocument(config.documentId);
-        setDocument(doc);
-        const dt = await clientRef.current.getDocumentType(doc.documentTypeId);
-        setDocumentType(dt);
         let sess;
+        let doc = null;
+        let dt = null;
         if (config.sessionId) {
           sess = await clientRef.current.getSession(config.sessionId);
         } else {
-          sess = await clientRef.current.createSession(config.documentId);
+          const result = await clientRef.current.createSession(config.documentTypeId);
+          sess = result.session;
+          doc = result.document;
+          dt = {
+            id: result.documentType.id,
+            name: result.documentType.name,
+            displayName: result.documentType.displayName,
+            schema: result.documentType.schema,
+            workspaceId: "",
+            taskConfigs: {},
+            createdAt: "",
+            updatedAt: ""
+          };
         }
         setSession(sess);
+        if (doc) setDocument(doc);
+        if (dt) setDocumentType(dt);
         config.onSessionChange?.(sess);
       } catch (err) {
         const error2 = err instanceof Error ? err : new Error("Initialization failed");
@@ -240,7 +245,7 @@ function InformedAIProvider({ config, children }) {
       }
     }
     initialize();
-  }, [config.documentId, config.sessionId]);
+  }, [config.documentTypeId, config.sessionId]);
   const handleSSEEvent = (0, import_react.useCallback)((event) => {
     if (event.type === "content" && event.content) {
       setStreamingContent((prev) => prev + event.content);
@@ -249,11 +254,6 @@ function InformedAIProvider({ config, children }) {
       if (event.session) {
         setSession(event.session);
         config.onSessionChange?.(event.session);
-        if (event.session.activeTask) {
-          const taskState = event.session.taskStates[event.session.activeTask];
-          if (taskState?.pendingValue !== void 0) {
-          }
-        }
       }
       setStreamingContent("");
       setIsStreaming(false);
@@ -279,7 +279,7 @@ function InformedAIProvider({ config, children }) {
       setIsStreaming(false);
     }
   }, [session, handleSSEEvent, config]);
-  const sendQuickAction = (0, import_react.useCallback)(async (action, payload) => {
+  const sendQuickAction = (0, import_react.useCallback)(async (action) => {
     if (!clientRef.current || !session) return;
     try {
       setIsStreaming(true);
@@ -288,7 +288,6 @@ function InformedAIProvider({ config, children }) {
       const newSession = await clientRef.current.sendQuickAction(
         session.id,
         action,
-        payload,
         handleSSEEvent
       );
       setSession(newSession);
@@ -305,14 +304,10 @@ function InformedAIProvider({ config, children }) {
     if (!clientRef.current || !session) return;
     try {
       setError(null);
-      const activeTask = session.activeTask;
-      const pendingValue = activeTask ? session.taskStates[activeTask]?.pendingValue : void 0;
-      const newSession = await clientRef.current.applyPendingValue(session.id);
-      setSession(newSession);
-      config.onSessionChange?.(newSession);
-      if (activeTask && pendingValue !== void 0) {
-        config.onFieldApply?.(activeTask, pendingValue);
-      }
+      const result = await clientRef.current.applyPendingValue(session.id);
+      setSession(result.session);
+      config.onSessionChange?.(result.session);
+      config.onFieldApply?.(result.appliedField, result.appliedValue);
     } catch (err) {
       const error2 = err instanceof Error ? err : new Error("Failed to apply value");
       setError(error2);
@@ -809,15 +804,15 @@ function LoadingSpinner({ size = 20 }) {
 // src/hooks/useSession.ts
 var import_react3 = require("react");
 function useSession(options) {
-  const { apiKey, apiUrl, documentId, sessionId, onSessionChange, onError } = options;
+  const { apiUrl, documentTypeId, sessionId, onSessionChange, onError } = options;
   const [session, setSession] = (0, import_react3.useState)(null);
   const [isLoading, setIsLoading] = (0, import_react3.useState)(true);
   const [error, setError] = (0, import_react3.useState)(null);
   const clientRef = (0, import_react3.useRef)(null);
   const isStreamingRef = (0, import_react3.useRef)(false);
   (0, import_react3.useEffect)(() => {
-    clientRef.current = new InformedAIClient(apiKey, apiUrl);
-  }, [apiKey, apiUrl]);
+    clientRef.current = new InformedAIClient(apiUrl);
+  }, [apiUrl]);
   (0, import_react3.useEffect)(() => {
     async function initialize() {
       if (!clientRef.current) return;
@@ -828,7 +823,8 @@ function useSession(options) {
         if (sessionId) {
           sess = await clientRef.current.getSession(sessionId);
         } else {
-          sess = await clientRef.current.createSession(documentId);
+          const result = await clientRef.current.createSession(documentTypeId);
+          sess = result.session;
         }
         setSession(sess);
         onSessionChange?.(sess);
@@ -841,7 +837,7 @@ function useSession(options) {
       }
     }
     initialize();
-  }, [documentId, sessionId, onSessionChange, onError]);
+  }, [documentTypeId, sessionId, onSessionChange, onError]);
   const handleSSEEvent = (0, import_react3.useCallback)((event) => {
     if (event.type === "done" || event.type === "session_update") {
       if (event.session) {
@@ -870,7 +866,7 @@ function useSession(options) {
       isStreamingRef.current = false;
     }
   }, [session, handleSSEEvent, onError]);
-  const sendQuickAction = (0, import_react3.useCallback)(async (action, payload) => {
+  const sendQuickAction = (0, import_react3.useCallback)(async (action) => {
     if (!clientRef.current || !session || isStreamingRef.current) return;
     try {
       isStreamingRef.current = true;
@@ -878,7 +874,6 @@ function useSession(options) {
       const newSession = await clientRef.current.sendQuickAction(
         session.id,
         action,
-        payload,
         handleSSEEvent
       );
       setSession(newSession);
@@ -895,9 +890,9 @@ function useSession(options) {
     if (!clientRef.current || !session) return;
     try {
       setError(null);
-      const newSession = await clientRef.current.applyPendingValue(session.id);
-      setSession(newSession);
-      onSessionChange?.(newSession);
+      const result = await clientRef.current.applyPendingValue(session.id);
+      setSession(result.session);
+      onSessionChange?.(result.session);
     } catch (err) {
       const error2 = err instanceof Error ? err : new Error("Failed to apply value");
       setError(error2);
@@ -927,69 +922,11 @@ function useSession(options) {
     skipTask
   };
 }
-
-// src/hooks/useDocument.ts
-var import_react4 = require("react");
-function useDocument(options) {
-  const { apiKey, apiUrl, documentId, onError } = options;
-  const [document, setDocument] = (0, import_react4.useState)(null);
-  const [documentType, setDocumentType] = (0, import_react4.useState)(null);
-  const [isLoading, setIsLoading] = (0, import_react4.useState)(true);
-  const [error, setError] = (0, import_react4.useState)(null);
-  const clientRef = (0, import_react4.useRef)(null);
-  (0, import_react4.useEffect)(() => {
-    clientRef.current = new InformedAIClient(apiKey, apiUrl);
-  }, [apiKey, apiUrl]);
-  const fetchDocument = (0, import_react4.useCallback)(async () => {
-    if (!clientRef.current) return;
-    try {
-      setIsLoading(true);
-      setError(null);
-      const doc = await clientRef.current.getDocument(documentId);
-      setDocument(doc);
-      const dt = await clientRef.current.getDocumentType(doc.documentTypeId);
-      setDocumentType(dt);
-    } catch (err) {
-      const error2 = err instanceof Error ? err : new Error("Failed to fetch document");
-      setError(error2);
-      onError?.(error2);
-    } finally {
-      setIsLoading(false);
-    }
-  }, [documentId, onError]);
-  (0, import_react4.useEffect)(() => {
-    fetchDocument();
-  }, [fetchDocument]);
-  const updateField = (0, import_react4.useCallback)(async (fieldName, value) => {
-    if (!clientRef.current || !document) return;
-    try {
-      setError(null);
-      const updatedDoc = await clientRef.current.updateDocumentField(document.id, fieldName, value);
-      setDocument(updatedDoc);
-    } catch (err) {
-      const error2 = err instanceof Error ? err : new Error("Failed to update field");
-      setError(error2);
-      onError?.(error2);
-    }
-  }, [document, onError]);
-  const refetch = (0, import_react4.useCallback)(async () => {
-    await fetchDocument();
-  }, [fetchDocument]);
-  return {
-    document,
-    documentType,
-    isLoading,
-    error,
-    updateField,
-    refetch
-  };
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   InformedAIClient,
   InformedAIProvider,
   InformedAssistant,
-  useDocument,
   useInformedAI,
   useSession
 });

package/dist/index.mjs

@@ -7,14 +7,12 @@ import { createContext, useContext, useEffect, useState, useCallback, useRef } f
 // src/utils/api-client.ts
 var DEFAULT_API_URL = "https://api.informedassistant.ai/api/v1";
 var InformedAIClient = class {
-  constructor(apiKey, apiUrl) {
-    this.apiKey = apiKey;
+  constructor(apiUrl) {
     this.apiUrl = apiUrl || DEFAULT_API_URL;
   }
   getHeaders() {
     return {
-      "Content-Type": "application/json",
-      "Authorization": `Bearer ${this.apiKey}`
+      "Content-Type": "application/json"
     };
   }
   async request(endpoint, options = {}) {
@@ -35,40 +33,29 @@ var InformedAIClient = class {
     return response.json();
   }
   // ========================================================================
-  // Document Operations
+  // Widget Session Operations (keyless)
   // ========================================================================
-  async getDocument(id) {
-    return this.request(`/documents/${id}`);
-  }
-  async getDocumentType(id) {
-    return this.request(`/document-types/${id}`);
-  }
-  async updateDocumentField(documentId, field, value) {
-    return this.request(`/documents/${documentId}/field`, {
-      method: "PATCH",
-      body: JSON.stringify({ field, value })
-    });
-  }
-  // ========================================================================
-  // Session Operations
-  // ========================================================================
-  async createSession(documentId) {
-    return this.request("/sessions", {
+  /**
+   * Create a new session for a document type.
+   * This automatically creates a document with default values.
+   */
+  async createSession(documentTypeId) {
+    return this.request("/widget/sessions", {
       method: "POST",
-      body: JSON.stringify({ documentId })
+      body: JSON.stringify({ documentTypeId })
     });
   }
+  /**
+   * Get an existing session.
+   */
   async getSession(id) {
-    return this.request(`/sessions/${id}`);
-  }
-  async deleteSession(id) {
-    await this.request(`/sessions/${id}`, { method: "DELETE" });
+    return this.request(`/widget/sessions/${id}`);
   }
   /**
-   * Send a message to the session with SSE streaming
+   * Send a message to the session with SSE streaming.
    */
   async sendMessage(sessionId, message, onEvent) {
-    const response = await fetch(`${this.apiUrl}/sessions/${sessionId}/message`, {
+    const response = await fetch(`${this.apiUrl}/widget/sessions/${sessionId}/message`, {
       method: "POST",
       headers: this.getHeaders(),
       body: JSON.stringify({ message })
@@ -80,43 +67,50 @@ var InformedAIClient = class {
     await this.processSSEStream(response, onEvent);
   }
   /**
-   * Send a quick action to the session with SSE streaming
+   * Send a quick action to the session.
+   * For actions that trigger AI (task_action:*), returns SSE stream.
+   * For other actions (select_task:*, resume_task:*), returns session directly.
    */
-  async sendQuickAction(sessionId, action, payload, onEvent) {
-    const response = await fetch(`${this.apiUrl}/sessions/${sessionId}/quick-action`, {
+  async sendQuickAction(sessionId, action, onEvent) {
+    const response = await fetch(`${this.apiUrl}/widget/sessions/${sessionId}/quick-action`, {
       method: "POST",
       headers: this.getHeaders(),
-      body: JSON.stringify({ action, payload })
+      body: JSON.stringify({ action })
     });
     if (!response.ok) {
       const error = await response.json().catch(() => ({ error: "Request failed" }));
       throw new Error(error.error || `HTTP ${response.status}`);
     }
-    let finalSession = null;
-    await this.processSSEStream(response, (event) => {
-      onEvent?.(event);
-      if (event.session) {
-        finalSession = event.session;
+    const contentType = response.headers.get("content-type") || "";
+    if (contentType.includes("text/event-stream")) {
+      let finalSession = null;
+      await this.processSSEStream(response, (event) => {
+        onEvent?.(event);
+        if (event.session) {
+          finalSession = event.session;
+        }
+      });
+      if (!finalSession) {
+        return this.getSession(sessionId);
       }
-    });
-    if (!finalSession) {
-      throw new Error("No session returned from quick action");
+      return finalSession;
+    } else {
+      return response.json();
     }
-    return finalSession;
   }
   /**
-   * Apply the pending value for the active task
+   * Apply the pending value for the active task.
    */
   async applyPendingValue(sessionId) {
-    return this.request(`/sessions/${sessionId}/apply`, {
+    return this.request(`/widget/sessions/${sessionId}/apply`, {
       method: "POST"
     });
   }
   /**
-   * Skip the active task
+   * Skip the active task.
    */
   async skipTask(sessionId) {
-    return this.request(`/sessions/${sessionId}/skip`, {
+    return this.request(`/widget/sessions/${sessionId}/skip`, {
       method: "POST"
     });
   }
@@ -180,25 +174,37 @@ function InformedAIProvider({ config, children }) {
   const [streamingContent, setStreamingContent] = useState("");
   const clientRef = useRef(null);
   useEffect(() => {
-    clientRef.current = new InformedAIClient(config.apiKey, config.apiUrl);
-  }, [config.apiKey, config.apiUrl]);
+    clientRef.current = new InformedAIClient(config.apiUrl);
+  }, [config.apiUrl]);
   useEffect(() => {
     async function initialize() {
       if (!clientRef.current) return;
       try {
         setIsLoading(true);
         setError(null);
-        const doc = await clientRef.current.getDocument(config.documentId);
-        setDocument(doc);
-        const dt = await clientRef.current.getDocumentType(doc.documentTypeId);
-        setDocumentType(dt);
         let sess;
+        let doc = null;
+        let dt = null;
         if (config.sessionId) {
           sess = await clientRef.current.getSession(config.sessionId);
         } else {
-          sess = await clientRef.current.createSession(config.documentId);
+          const result = await clientRef.current.createSession(config.documentTypeId);
+          sess = result.session;
+          doc = result.document;
+          dt = {
+            id: result.documentType.id,
+            name: result.documentType.name,
+            displayName: result.documentType.displayName,
+            schema: result.documentType.schema,
+            workspaceId: "",
+            taskConfigs: {},
+            createdAt: "",
+            updatedAt: ""
+          };
         }
         setSession(sess);
+        if (doc) setDocument(doc);
+        if (dt) setDocumentType(dt);
         config.onSessionChange?.(sess);
       } catch (err) {
         const error2 = err instanceof Error ? err : new Error("Initialization failed");
@@ -209,7 +215,7 @@ function InformedAIProvider({ config, children }) {
       }
     }
     initialize();
-  }, [config.documentId, config.sessionId]);
+  }, [config.documentTypeId, config.sessionId]);
   const handleSSEEvent = useCallback((event) => {
     if (event.type === "content" && event.content) {
       setStreamingContent((prev) => prev + event.content);
@@ -218,11 +224,6 @@ function InformedAIProvider({ config, children }) {
       if (event.session) {
         setSession(event.session);
         config.onSessionChange?.(event.session);
-        if (event.session.activeTask) {
-          const taskState = event.session.taskStates[event.session.activeTask];
-          if (taskState?.pendingValue !== void 0) {
-          }
-        }
       }
       setStreamingContent("");
       setIsStreaming(false);
@@ -248,7 +249,7 @@ function InformedAIProvider({ config, children }) {
       setIsStreaming(false);
     }
   }, [session, handleSSEEvent, config]);
-  const sendQuickAction = useCallback(async (action, payload) => {
+  const sendQuickAction = useCallback(async (action) => {
     if (!clientRef.current || !session) return;
     try {
       setIsStreaming(true);
@@ -257,7 +258,6 @@ function InformedAIProvider({ config, children }) {
       const newSession = await clientRef.current.sendQuickAction(
         session.id,
         action,
-        payload,
         handleSSEEvent
       );
       setSession(newSession);
@@ -274,14 +274,10 @@ function InformedAIProvider({ config, children }) {
     if (!clientRef.current || !session) return;
     try {
       setError(null);
-      const activeTask = session.activeTask;
-      const pendingValue = activeTask ? session.taskStates[activeTask]?.pendingValue : void 0;
-      const newSession = await clientRef.current.applyPendingValue(session.id);
-      setSession(newSession);
-      config.onSessionChange?.(newSession);
-      if (activeTask && pendingValue !== void 0) {
-        config.onFieldApply?.(activeTask, pendingValue);
-      }
+      const result = await clientRef.current.applyPendingValue(session.id);
+      setSession(result.session);
+      config.onSessionChange?.(result.session);
+      config.onFieldApply?.(result.appliedField, result.appliedValue);
     } catch (err) {
       const error2 = err instanceof Error ? err : new Error("Failed to apply value");
       setError(error2);
@@ -778,15 +774,15 @@ function LoadingSpinner({ size = 20 }) {
 // src/hooks/useSession.ts
 import { useState as useState3, useEffect as useEffect3, useCallback as useCallback2, useRef as useRef3 } from "react";
 function useSession(options) {
-  const { apiKey, apiUrl, documentId, sessionId, onSessionChange, onError } = options;
+  const { apiUrl, documentTypeId, sessionId, onSessionChange, onError } = options;
   const [session, setSession] = useState3(null);
   const [isLoading, setIsLoading] = useState3(true);
   const [error, setError] = useState3(null);
   const clientRef = useRef3(null);
   const isStreamingRef = useRef3(false);
   useEffect3(() => {
-    clientRef.current = new InformedAIClient(apiKey, apiUrl);
-  }, [apiKey, apiUrl]);
+    clientRef.current = new InformedAIClient(apiUrl);
+  }, [apiUrl]);
   useEffect3(() => {
     async function initialize() {
       if (!clientRef.current) return;
@@ -797,7 +793,8 @@ function useSession(options) {
         if (sessionId) {
           sess = await clientRef.current.getSession(sessionId);
         } else {
-          sess = await clientRef.current.createSession(documentId);
+          const result = await clientRef.current.createSession(documentTypeId);
+          sess = result.session;
         }
         setSession(sess);
         onSessionChange?.(sess);
@@ -810,7 +807,7 @@ function useSession(options) {
       }
     }
     initialize();
-  }, [documentId, sessionId, onSessionChange, onError]);
+  }, [documentTypeId, sessionId, onSessionChange, onError]);
   const handleSSEEvent = useCallback2((event) => {
     if (event.type === "done" || event.type === "session_update") {
       if (event.session) {
@@ -839,7 +836,7 @@ function useSession(options) {
       isStreamingRef.current = false;
     }
   }, [session, handleSSEEvent, onError]);
-  const sendQuickAction = useCallback2(async (action, payload) => {
+  const sendQuickAction = useCallback2(async (action) => {
     if (!clientRef.current || !session || isStreamingRef.current) return;
     try {
       isStreamingRef.current = true;
@@ -847,7 +844,6 @@ function useSession(options) {
       const newSession = await clientRef.current.sendQuickAction(
         session.id,
         action,
-        payload,
         handleSSEEvent
       );
       setSession(newSession);
@@ -864,9 +860,9 @@ function useSession(options) {
     if (!clientRef.current || !session) return;
     try {
       setError(null);
-      const newSession = await clientRef.current.applyPendingValue(session.id);
-      setSession(newSession);
-      onSessionChange?.(newSession);
+      const result = await clientRef.current.applyPendingValue(session.id);
+      setSession(result.session);
+      onSessionChange?.(result.session);
     } catch (err) {
       const error2 = err instanceof Error ? err : new Error("Failed to apply value");
       setError(error2);
@@ -896,68 +892,10 @@ function useSession(options) {
     skipTask
   };
 }
-
-// src/hooks/useDocument.ts
-import { useState as useState4, useEffect as useEffect4, useCallback as useCallback3, useRef as useRef4 } from "react";
-function useDocument(options) {
-  const { apiKey, apiUrl, documentId, onError } = options;
-  const [document, setDocument] = useState4(null);
-  const [documentType, setDocumentType] = useState4(null);
-  const [isLoading, setIsLoading] = useState4(true);
-  const [error, setError] = useState4(null);
-  const clientRef = useRef4(null);
-  useEffect4(() => {
-    clientRef.current = new InformedAIClient(apiKey, apiUrl);
-  }, [apiKey, apiUrl]);
-  const fetchDocument = useCallback3(async () => {
-    if (!clientRef.current) return;
-    try {
-      setIsLoading(true);
-      setError(null);
-      const doc = await clientRef.current.getDocument(documentId);
-      setDocument(doc);
-      const dt = await clientRef.current.getDocumentType(doc.documentTypeId);
-      setDocumentType(dt);
-    } catch (err) {
-      const error2 = err instanceof Error ? err : new Error("Failed to fetch document");
-      setError(error2);
-      onError?.(error2);
-    } finally {
-      setIsLoading(false);
-    }
-  }, [documentId, onError]);
-  useEffect4(() => {
-    fetchDocument();
-  }, [fetchDocument]);
-  const updateField = useCallback3(async (fieldName, value) => {
-    if (!clientRef.current || !document) return;
-    try {
-      setError(null);
-      const updatedDoc = await clientRef.current.updateDocumentField(document.id, fieldName, value);
-      setDocument(updatedDoc);
-    } catch (err) {
-      const error2 = err instanceof Error ? err : new Error("Failed to update field");
-      setError(error2);
-      onError?.(error2);
-    }
-  }, [document, onError]);
-  const refetch = useCallback3(async () => {
-    await fetchDocument();
-  }, [fetchDocument]);
-  return {
-    document,
-    documentType,
-    isLoading,
-    error,
-    updateField,
-    refetch
-  };
-}
 export {
   InformedAIClient,
   InformedAIProvider,
   InformedAssistant,
-  useDocument,
   useInformedAI,
   useSession
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@informedai/react",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "React SDK for InformedAI Assistant - AI-powered content creation widget",
   "main": "dist/index.js",
   "module": "dist/index.mjs",