@aigentyc/chat-sdk 0.3.1 → 0.5.0

package/dist/theme.d.cts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-export { T as ThemeConfig } from './types-DlNwk-bG.cjs';
+export { T as ThemeConfig } from './types-bsR_-fq8.cjs';
 
 /**
  * Theme configuration for the chat widget.

package/dist/theme.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
-export { T as ThemeConfig } from './types-DlNwk-bG.js';
+export { T as ThemeConfig } from './types-bsR_-fq8.js';
 
 /**
  * Theme configuration for the chat widget.

package/dist/tools.cjs

@@ -2,8 +2,8 @@
 'use strict';
 
 var chunk7AZMWPKX_cjs = require('./chunk-7AZMWPKX.cjs');
-var chunk7IFBPXT3_cjs = require('./chunk-7IFBPXT3.cjs');
-require('./chunk-BPV66QNM.cjs');
+var chunkQ3UJEIBN_cjs = require('./chunk-Q3UJEIBN.cjs');
+require('./chunk-52ZHMTAA.cjs');
 require('./chunk-JOO6C3XT.cjs');
 var chunkH7C3AGA2_cjs = require('./chunk-H7C3AGA2.cjs');
 var chunkQ7T3VAJV_cjs = require('./chunk-Q7T3VAJV.cjs');
@@ -23,15 +23,15 @@ Object.defineProperty(exports, "normalizeToolRows", {
 });
 Object.defineProperty(exports, "ComponentRenderer", {
   enumerable: true,
-  get: function () { return chunk7IFBPXT3_cjs.ComponentRenderer; }
+  get: function () { return chunkQ3UJEIBN_cjs.ComponentRenderer; }
 });
 Object.defineProperty(exports, "SearchKnowledgeBaseRenderer", {
   enumerable: true,
-  get: function () { return chunk7IFBPXT3_cjs.SearchKnowledgeBaseRenderer; }
+  get: function () { return chunkQ3UJEIBN_cjs.SearchKnowledgeBaseRenderer; }
 });
 Object.defineProperty(exports, "ToolRenderer", {
   enumerable: true,
-  get: function () { return chunk7IFBPXT3_cjs.ToolRenderer; }
+  get: function () { return chunkQ3UJEIBN_cjs.ToolRenderer; }
 });
 Object.defineProperty(exports, "JsonRenderResult", {
   enumerable: true,

package/dist/tools.d.cts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { g as ToolRendererProps } from './types-DlNwk-bG.cjs';
-export { d as ComponentAction, h as ToolResult } from './types-DlNwk-bG.cjs';
+import { h as ToolRendererProps } from './types-bsR_-fq8.cjs';
+export { e as ComponentAction, i as ToolResult } from './types-bsR_-fq8.cjs';
 export { J as JsonRenderResult } from './JsonRenderResult-D6ogds0_.cjs';
 export { g as getToolDisplayData, n as normalizeToolRows } from './normalize-KzCLLqpU.cjs';
 import 'react';

package/dist/tools.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { g as ToolRendererProps } from './types-DlNwk-bG.js';
-export { d as ComponentAction, h as ToolResult } from './types-DlNwk-bG.js';
+import { h as ToolRendererProps } from './types-bsR_-fq8.js';
+export { e as ComponentAction, i as ToolResult } from './types-bsR_-fq8.js';
 export { J as JsonRenderResult } from './JsonRenderResult-D6ogds0_.js';
 export { g as getToolDisplayData, n as normalizeToolRows } from './normalize-KzCLLqpU.js';
 import 'react';

package/dist/tools.js

@@ -1,7 +1,7 @@
 "use client";
 export { getToolDisplayData, normalizeToolRows } from './chunk-XEAAB5ZM.js';
-export { ComponentRenderer, SearchKnowledgeBaseRenderer, ToolRenderer } from './chunk-AD6XWKWB.js';
-import './chunk-FPQ3UCCJ.js';
+export { ComponentRenderer, SearchKnowledgeBaseRenderer, ToolRenderer } from './chunk-FJZL33KP.js';
+import './chunk-D75TDRBH.js';
 import './chunk-PS3U7T37.js';
 export { JsonRenderResult } from './chunk-ZXP7IYRC.js';
 export { VisualizationRenderer } from './chunk-5T4FJ2SR.js';

package/dist/{types-DlNwk-bG.d.ts → types-bsR_-fq8.d.cts}

@@ -80,12 +80,30 @@ interface QuestionConfig {
 interface ChatConfig {
     /** Project identifier on the Aigentyc platform */
     projectId: string;
-    /** Base URL of the API (e.g. `"https://api.aigentyc.com"`) */
+    /** Base URL of the API (e.g. `"https://api.aigentyc.ai"`) */
     apiEndpoint: string;
     /** Bearer API key for authentication (alternative to session cookies) */
     apiKey?: string;
     /** Human-readable client / brand name shown in the header */
     clientName?: string;
+    /**
+     * URL of the page the widget is embedded in. Sent with every message so the
+     * assistant can answer in the context of what the visitor is looking at.
+     *
+     * Read fresh on each send, so a single-page app may update it on navigation
+     * without remounting the widget.
+     */
+    pageUrl?: string;
+    /** Title of the page the widget is embedded in. Sent with every message. */
+    pageTitle?: string;
+    /**
+     * Free-form structured context about the host page — the active category, the
+     * filters the visitor has applied, the product they are viewing. Sent verbatim
+     * with every message; the backend renders it into the system prompt as data.
+     *
+     * Shape is up to the host app. Keep it small: it is re-sent on every turn.
+     */
+    pageContext?: unknown;
 }
 /**
  * Props passed to every slot component so it can delegate to the default.
@@ -340,6 +358,12 @@ interface ChatMessage {
         input?: Record<string, unknown>;
         /** Tool output */
         output?: unknown;
+        /** File source (when `type === "file"`) — a `data:` URI or an https URL */
+        url?: string;
+        /** File MIME type (when `type === "file"`) */
+        mediaType?: string;
+        /** Original file name (when `type === "file"`) */
+        filename?: string;
     }>;
 }
 /**
@@ -375,5 +399,22 @@ interface ChatProviderProps extends ChatConfig, ChatEventCallbacks {
     /** React children to render inside the provider */
     children?: React.ReactNode;
 }
+/**
+ * One file travelling out with a user message.
+ *
+ * Structurally the AI SDK's `FileUIPart`, restated here so consumers do not have
+ * to depend on `ai` directly just to type a composer. `url` is what the model is
+ * eventually shown: either a `data:` URI or an https URL the backend can read.
+ */
+interface ChatAttachmentInput {
+    /** Always `"file"` — present so the value is already a valid message part. */
+    type?: "file";
+    /** MIME type, e.g. `"image/jpeg"`. */
+    mediaType: string;
+    /** `data:` URI or an https URL the backend can fetch. */
+    url: string;
+    /** Original file name, shown in the transcript. */
+    filename?: string;
+}
 
-export type { ChatProviderProps as C, Language as L, QuestionConfig as Q, SlotMap as S, ThemeConfig as T, ChatConfig as a, ChatEventCallbacks as b, ChatMessage as c, ComponentAction as d, LiveChatMessage as e, LiveChatState as f, ToolRendererProps as g, ToolResult as h, SlotProps as i };
+export type { ChatProviderProps as C, Language as L, QuestionConfig as Q, SlotMap as S, ThemeConfig as T, ChatAttachmentInput as a, ChatConfig as b, ChatEventCallbacks as c, ChatMessage as d, ComponentAction as e, LiveChatMessage as f, LiveChatState as g, ToolRendererProps as h, ToolResult as i, SlotProps as j };

package/dist/{types-DlNwk-bG.d.cts → types-bsR_-fq8.d.ts}

@@ -80,12 +80,30 @@ interface QuestionConfig {
 interface ChatConfig {
     /** Project identifier on the Aigentyc platform */
     projectId: string;
-    /** Base URL of the API (e.g. `"https://api.aigentyc.com"`) */
+    /** Base URL of the API (e.g. `"https://api.aigentyc.ai"`) */
     apiEndpoint: string;
     /** Bearer API key for authentication (alternative to session cookies) */
     apiKey?: string;
     /** Human-readable client / brand name shown in the header */
     clientName?: string;
+    /**
+     * URL of the page the widget is embedded in. Sent with every message so the
+     * assistant can answer in the context of what the visitor is looking at.
+     *
+     * Read fresh on each send, so a single-page app may update it on navigation
+     * without remounting the widget.
+     */
+    pageUrl?: string;
+    /** Title of the page the widget is embedded in. Sent with every message. */
+    pageTitle?: string;
+    /**
+     * Free-form structured context about the host page — the active category, the
+     * filters the visitor has applied, the product they are viewing. Sent verbatim
+     * with every message; the backend renders it into the system prompt as data.
+     *
+     * Shape is up to the host app. Keep it small: it is re-sent on every turn.
+     */
+    pageContext?: unknown;
 }
 /**
  * Props passed to every slot component so it can delegate to the default.
@@ -340,6 +358,12 @@ interface ChatMessage {
         input?: Record<string, unknown>;
         /** Tool output */
         output?: unknown;
+        /** File source (when `type === "file"`) — a `data:` URI or an https URL */
+        url?: string;
+        /** File MIME type (when `type === "file"`) */
+        mediaType?: string;
+        /** Original file name (when `type === "file"`) */
+        filename?: string;
     }>;
 }
 /**
@@ -375,5 +399,22 @@ interface ChatProviderProps extends ChatConfig, ChatEventCallbacks {
     /** React children to render inside the provider */
     children?: React.ReactNode;
 }
+/**
+ * One file travelling out with a user message.
+ *
+ * Structurally the AI SDK's `FileUIPart`, restated here so consumers do not have
+ * to depend on `ai` directly just to type a composer. `url` is what the model is
+ * eventually shown: either a `data:` URI or an https URL the backend can read.
+ */
+interface ChatAttachmentInput {
+    /** Always `"file"` — present so the value is already a valid message part. */
+    type?: "file";
+    /** MIME type, e.g. `"image/jpeg"`. */
+    mediaType: string;
+    /** `data:` URI or an https URL the backend can fetch. */
+    url: string;
+    /** Original file name, shown in the transcript. */
+    filename?: string;
+}
 
-export type { ChatProviderProps as C, Language as L, QuestionConfig as Q, SlotMap as S, ThemeConfig as T, ChatConfig as a, ChatEventCallbacks as b, ChatMessage as c, ComponentAction as d, LiveChatMessage as e, LiveChatState as f, ToolRendererProps as g, ToolResult as h, SlotProps as i };
+export type { ChatProviderProps as C, Language as L, QuestionConfig as Q, SlotMap as S, ThemeConfig as T, ChatAttachmentInput as a, ChatConfig as b, ChatEventCallbacks as c, ChatMessage as d, ComponentAction as e, LiveChatMessage as f, LiveChatState as g, ToolRendererProps as h, ToolResult as i, SlotProps as j };

package/dist/ui.cjs

@@ -1,8 +1,8 @@
 "use client";
 'use strict';
 
-var chunkOU5OZKYH_cjs = require('./chunk-OU5OZKYH.cjs');
-var chunkTZ7EM3EG_cjs = require('./chunk-TZ7EM3EG.cjs');
+var chunkY4B45DW4_cjs = require('./chunk-Y4B45DW4.cjs');
+var chunkEMVZ7HWM_cjs = require('./chunk-EMVZ7HWM.cjs');
 var chunkJI5KCSOI_cjs = require('./chunk-JI5KCSOI.cjs');
 var chunkAWAJOSFP_cjs = require('./chunk-AWAJOSFP.cjs');
 var chunk525KS5HM_cjs = require('./chunk-525KS5HM.cjs');
@@ -442,163 +442,163 @@ TableCaption.displayName = "TableCaption";
 
 Object.defineProperty(exports, "Alert", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.Alert; }
+  get: function () { return chunkY4B45DW4_cjs.Alert; }
 });
 Object.defineProperty(exports, "AlertDescription", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.AlertDescription; }
+  get: function () { return chunkY4B45DW4_cjs.AlertDescription; }
 });
 Object.defineProperty(exports, "AlertTitle", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.AlertTitle; }
+  get: function () { return chunkY4B45DW4_cjs.AlertTitle; }
 });
 Object.defineProperty(exports, "Badge", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.Badge; }
+  get: function () { return chunkY4B45DW4_cjs.Badge; }
 });
 Object.defineProperty(exports, "Carousel", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.Carousel; }
+  get: function () { return chunkY4B45DW4_cjs.Carousel; }
 });
 Object.defineProperty(exports, "CarouselContent", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.CarouselContent; }
+  get: function () { return chunkY4B45DW4_cjs.CarouselContent; }
 });
 Object.defineProperty(exports, "CarouselItem", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.CarouselItem; }
+  get: function () { return chunkY4B45DW4_cjs.CarouselItem; }
 });
 Object.defineProperty(exports, "CarouselNext", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.CarouselNext; }
+  get: function () { return chunkY4B45DW4_cjs.CarouselNext; }
 });
 Object.defineProperty(exports, "CarouselPrevious", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.CarouselPrevious; }
+  get: function () { return chunkY4B45DW4_cjs.CarouselPrevious; }
 });
 Object.defineProperty(exports, "Dialog", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.Dialog; }
+  get: function () { return chunkY4B45DW4_cjs.Dialog; }
 });
 Object.defineProperty(exports, "DialogClose", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.DialogClose; }
+  get: function () { return chunkY4B45DW4_cjs.DialogClose; }
 });
 Object.defineProperty(exports, "DialogContent", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.DialogContent; }
+  get: function () { return chunkY4B45DW4_cjs.DialogContent; }
 });
 Object.defineProperty(exports, "DialogDescription", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.DialogDescription; }
+  get: function () { return chunkY4B45DW4_cjs.DialogDescription; }
 });
 Object.defineProperty(exports, "DialogFooter", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.DialogFooter; }
+  get: function () { return chunkY4B45DW4_cjs.DialogFooter; }
 });
 Object.defineProperty(exports, "DialogHeader", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.DialogHeader; }
+  get: function () { return chunkY4B45DW4_cjs.DialogHeader; }
 });
 Object.defineProperty(exports, "DialogTitle", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.DialogTitle; }
+  get: function () { return chunkY4B45DW4_cjs.DialogTitle; }
 });
 Object.defineProperty(exports, "DialogTrigger", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.DialogTrigger; }
+  get: function () { return chunkY4B45DW4_cjs.DialogTrigger; }
 });
 Object.defineProperty(exports, "DropdownMenu", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.DropdownMenu; }
+  get: function () { return chunkY4B45DW4_cjs.DropdownMenu; }
 });
 Object.defineProperty(exports, "DropdownMenuContent", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.DropdownMenuContent; }
+  get: function () { return chunkY4B45DW4_cjs.DropdownMenuContent; }
 });
 Object.defineProperty(exports, "DropdownMenuItem", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.DropdownMenuItem; }
+  get: function () { return chunkY4B45DW4_cjs.DropdownMenuItem; }
 });
 Object.defineProperty(exports, "DropdownMenuTrigger", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.DropdownMenuTrigger; }
+  get: function () { return chunkY4B45DW4_cjs.DropdownMenuTrigger; }
 });
 Object.defineProperty(exports, "Input", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.Input; }
+  get: function () { return chunkY4B45DW4_cjs.Input; }
 });
 Object.defineProperty(exports, "Progress", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.Progress; }
+  get: function () { return chunkY4B45DW4_cjs.Progress; }
 });
 Object.defineProperty(exports, "ScrollArea", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.ScrollArea; }
+  get: function () { return chunkY4B45DW4_cjs.ScrollArea; }
 });
 Object.defineProperty(exports, "ScrollBar", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.ScrollBar; }
+  get: function () { return chunkY4B45DW4_cjs.ScrollBar; }
 });
 Object.defineProperty(exports, "Select", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.Select; }
+  get: function () { return chunkY4B45DW4_cjs.Select; }
 });
 Object.defineProperty(exports, "SelectContent", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.SelectContent; }
+  get: function () { return chunkY4B45DW4_cjs.SelectContent; }
 });
 Object.defineProperty(exports, "SelectItem", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.SelectItem; }
+  get: function () { return chunkY4B45DW4_cjs.SelectItem; }
 });
 Object.defineProperty(exports, "SelectTrigger", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.SelectTrigger; }
+  get: function () { return chunkY4B45DW4_cjs.SelectTrigger; }
 });
 Object.defineProperty(exports, "SelectValue", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.SelectValue; }
+  get: function () { return chunkY4B45DW4_cjs.SelectValue; }
 });
-Object.defineProperty(exports, "Separator", {
+Object.defineProperty(exports, "Button", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.Separator; }
+  get: function () { return chunkEMVZ7HWM_cjs.Button; }
 });
-Object.defineProperty(exports, "Tooltip", {
+Object.defineProperty(exports, "Collapsible", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.Tooltip; }
+  get: function () { return chunkEMVZ7HWM_cjs.Collapsible; }
 });
-Object.defineProperty(exports, "TooltipContent", {
+Object.defineProperty(exports, "CollapsibleContent", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.TooltipContent; }
+  get: function () { return chunkEMVZ7HWM_cjs.CollapsibleContent; }
 });
-Object.defineProperty(exports, "TooltipProvider", {
+Object.defineProperty(exports, "CollapsibleTrigger", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.TooltipProvider; }
+  get: function () { return chunkEMVZ7HWM_cjs.CollapsibleTrigger; }
 });
-Object.defineProperty(exports, "TooltipTrigger", {
+Object.defineProperty(exports, "Separator", {
   enumerable: true,
-  get: function () { return chunkOU5OZKYH_cjs.TooltipTrigger; }
+  get: function () { return chunkEMVZ7HWM_cjs.Separator; }
 });
-Object.defineProperty(exports, "Button", {
+Object.defineProperty(exports, "Textarea", {
   enumerable: true,
-  get: function () { return chunkTZ7EM3EG_cjs.Button; }
+  get: function () { return chunkEMVZ7HWM_cjs.Textarea; }
 });
-Object.defineProperty(exports, "Collapsible", {
+Object.defineProperty(exports, "Tooltip", {
   enumerable: true,
-  get: function () { return chunkTZ7EM3EG_cjs.Collapsible; }
+  get: function () { return chunkEMVZ7HWM_cjs.Tooltip; }
 });
-Object.defineProperty(exports, "CollapsibleContent", {
+Object.defineProperty(exports, "TooltipContent", {
   enumerable: true,
-  get: function () { return chunkTZ7EM3EG_cjs.CollapsibleContent; }
+  get: function () { return chunkEMVZ7HWM_cjs.TooltipContent; }
 });
-Object.defineProperty(exports, "CollapsibleTrigger", {
+Object.defineProperty(exports, "TooltipProvider", {
   enumerable: true,
-  get: function () { return chunkTZ7EM3EG_cjs.CollapsibleTrigger; }
+  get: function () { return chunkEMVZ7HWM_cjs.TooltipProvider; }
 });
-Object.defineProperty(exports, "Textarea", {
+Object.defineProperty(exports, "TooltipTrigger", {
   enumerable: true,
-  get: function () { return chunkTZ7EM3EG_cjs.Textarea; }
+  get: function () { return chunkEMVZ7HWM_cjs.TooltipTrigger; }
 });
 Object.defineProperty(exports, "Spinner", {
   enumerable: true,

package/dist/ui.js

@@ -1,6 +1,6 @@
 "use client";
-export { Alert, AlertDescription, AlertTitle, Badge, Carousel, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuTrigger, Input, Progress, ScrollArea, ScrollBar, Select, SelectContent, SelectItem, SelectTrigger, SelectValue, Separator, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from './chunk-3KSMOHNY.js';
-export { Button, Collapsible, CollapsibleContent, CollapsibleTrigger, Textarea } from './chunk-JHWSG5IB.js';
+export { Alert, AlertDescription, AlertTitle, Badge, Carousel, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuTrigger, Input, Progress, ScrollArea, ScrollBar, Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from './chunk-R3TYC66R.js';
+export { Button, Collapsible, CollapsibleContent, CollapsibleTrigger, Separator, Textarea, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from './chunk-JAOD6CNW.js';
 export { Spinner } from './chunk-4QT25AXI.js';
 export { Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from './chunk-NPJKLYLV.js';
 import { cn } from './chunk-3RW7O444.js';

package/llms.txt

@@ -460,7 +460,7 @@ The built-in tool dispatcher already wraps each tool in a boundary, so a single
 | Symptom | Likely cause | Fix |
 | --- | --- | --- |
 | Unstyled / broken layout | Missing CSS import | `import "@aigentyc/chat-sdk/theme/styles.css"` |
-| 401 / "Missing Authorization" on embed | No `apiKey` passed — required for all third-party domain embeds | Pass `apiKey` prop (or `NEXT_PUBLIC_AIGENTYC_API_KEY` / `VITE_AIGENTYC_API_KEY` env var). The "no apiKey needed" path only works inside `app.aigentyc.com` itself (session cookie). |
+| 401 / "Missing Authorization" on embed | No `apiKey` passed — required for all third-party domain embeds | Pass `apiKey` prop (or `NEXT_PUBLIC_AIGENTYC_API_KEY` / `VITE_AIGENTYC_API_KEY` env var). The "no apiKey needed" path only works inside `app.aigentyc.ai` itself (session cookie). |
 | 403 / invalid origin | API key's Allowed Origins list doesn't include your embed domain | Dashboard → Settings → API Keys → edit → add domain |
 | CORS error in browser | Allowed Origins on API key doesn't include current URL | Add `http://localhost:5173` (Vite) or `http://localhost:3000` (Next) to the key's Allowed Origins |
 | Slot override doesn't render | Using `toolRenderers` keyed by tool name | Use `tools` for per-tool overrides; `toolRenderers` is per render mode. Dev console warns automatically. |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigentyc/chat-sdk",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "description": "React SDK for building AI-powered chat interfaces connected to the Aigentyc platform",
   "type": "module",
   "sideEffects": [

package/dist/chunk-3HGOLNGG.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/hooks/use-aigentyc-chat.ts"],"names":["useRef","useState","useMemo","DefaultChatTransport","useChat","useEffect","useCallback","transport","LiveChatTransport"],"mappings":"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","file":"chunk-3HGOLNGG.cjs","sourcesContent":["\"use client\";\n\nimport {\n  useState,\n  useCallback,\n  useRef,\n  useMemo,\n  useEffect,\n  type RefObject,\n} from \"react\";\nimport type {\n  ChatProviderProps,\n  ChatMessage,\n  ChatEventCallbacks,\n  LiveChatState,\n  LiveChatMessage,\n} from \"../core/types\";\n\ntype ChatStatus = \"idle\" | \"streaming\" | \"error\";\n\ninterface ActiveTool {\n  toolName: string;\n  state: \"partial-call\" | \"call\" | \"output-available\";\n  args: Record<string, unknown>;\n  result?: unknown;\n  renderMode: string;\n}\n// NOTE: @ai-sdk/react and ai are optional peer dependencies.\nimport { useChat } from \"@ai-sdk/react\";\nimport { DefaultChatTransport } from \"ai\";\nimport { LiveChatTransport } from \"../core/live-chat-transport\";\n\nconst SESSION_KEY_PREFIX = \"aigentyc-session-\";\nconst MESSAGE_KEY_PREFIX = \"aigentyc-messages-\";\n\nfunction getOrCreateSessionId(projectId: string): string {\n  if (typeof window === \"undefined\") return crypto.randomUUID();\n  const key = SESSION_KEY_PREFIX + projectId;\n  try {\n    const stored = sessionStorage.getItem(key);\n    if (stored) return stored;\n    const id = crypto.randomUUID();\n    sessionStorage.setItem(key, id);\n    return id;\n  } catch {\n    return crypto.randomUUID();\n  }\n}\n\nfunction loadPersistedMessages(projectId: string): ChatMessage[] {\n  if (typeof window === \"undefined\") return [];\n  try {\n    const raw = localStorage.getItem(MESSAGE_KEY_PREFIX + projectId);\n    return raw ? JSON.parse(raw) : [];\n  } catch {\n    return [];\n  }\n}\n\nfunction persistMessages(projectId: string, messages: unknown[]): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    localStorage.setItem(MESSAGE_KEY_PREFIX + projectId, JSON.stringify(messages));\n  } catch {\n    // Ignore.\n  }\n}\n\nfunction clearPersistedMessages(projectId: string): void {\n  if (typeof window === \"undefined\") return;\n  try {\n    localStorage.removeItem(MESSAGE_KEY_PREFIX + projectId);\n  } catch {\n    // Ignore.\n  }\n}\n\n/** Options for the headless `useAigentycChat` hook (same shape as ChatProviderProps). */\nexport type UseAigentycChatOptions = Omit<ChatProviderProps, \"children\" | \"slots\" | \"theme\">;\n\n/** Live chat sub-object returned by the hook. */\nexport interface LiveChatReturn {\n  state: LiveChatState;\n  messages: LiveChatMessage[];\n  operatorName: string;\n  queuePosition: number;\n  showIdentityForm: boolean;\n  initiate: (visitorName?: string, visitorEmail?: string) => Promise<void>;\n  send: (content: string) => void;\n  end: () => void;\n  cancel: () => void;\n  submitRating: (rating: \"positive\" | \"negative\", comment?: string) => void;\n  returnToAI: () => void;\n  requestManualHandoff: () => void;\n  setShowIdentityForm: (show: boolean) => void;\n}\n\n/** Return value of `useAigentycChat`. */\nexport interface UseAigentycChatReturn {\n  messages: ChatMessage[];\n  status: ChatStatus;\n  error: Error | undefined;\n  sessionId: string;\n  sendMessage: (content: string) => void;\n  stopGeneration: () => void;\n  newConversation: () => void;\n  clearMessages: () => void;\n  activeTools: ActiveTool[];\n  liveChat: LiveChatReturn;\n  chatRef: RefObject<HTMLDivElement | null>;\n}\n\nconst CALLBACK_KEYS: (keyof ChatEventCallbacks)[] = [\n  \"onReady\",\n  \"onSessionStart\",\n  \"onSessionRestore\",\n  \"onMessageSent\",\n  \"onMessageReceived\",\n  \"onStreamStart\",\n  \"onStreamEnd\",\n  \"onToolCall\",\n  \"onToolResult\",\n  \"onToolAction\",\n  \"onLiveChatRequested\",\n  \"onLiveChatConnected\",\n  \"onLiveChatEnded\",\n  \"onError\",\n  \"onNewConversation\",\n  \"onStopGeneration\",\n  \"onClearMessages\",\n  \"onInteraction\",\n];\n\nfunction pickCallbacks(opts: Record<string, unknown>): ChatEventCallbacks {\n  const out: Record<string, unknown> = {};\n  for (const key of CALLBACK_KEYS) {\n    if (opts[key] !== undefined) out[key] = opts[key];\n  }\n  return out as ChatEventCallbacks;\n}\n\n/**\n * Standalone headless hook for Aigentyc Chat. No provider needed.\n *\n * Creates its own transport, session, and persistence internally. Use this\n * when you want full control over the UI but still want all SDK features\n * (chat, tools, live chat, persistence).\n */\nexport function useAigentycChat(options: UseAigentycChatOptions): UseAigentycChatReturn {\n  const {\n    projectId,\n    apiEndpoint,\n    apiKey,\n    enableLiveChat = false,\n    chatServiceUrl,\n    persistMessages: shouldPersist = true,\n  } = options;\n\n  const callbacks = pickCallbacks(options as unknown as Record<string, unknown>);\n  const callbacksRef = useRef(callbacks);\n  callbacksRef.current = callbacks;\n\n  const safeProjectId = projectId || \"default\";\n  const [sessionId, setSessionId] = useState(() => getOrCreateSessionId(safeProjectId));\n  const chatRef = useRef<HTMLDivElement | null>(null);\n\n  const initialMessages = useMemo(\n    () => (shouldPersist ? loadPersistedMessages(safeProjectId) : []),\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    []\n  );\n\n  const transport = useMemo(\n    () =>\n      new DefaultChatTransport({\n        api: `${apiEndpoint || \"\"}/api/kb/chat`,\n        headers: apiKey ? { Authorization: `Bearer ${apiKey}` } : undefined,\n        body: { projectId: safeProjectId, sessionId },\n      }),\n    [apiEndpoint, apiKey, safeProjectId, sessionId]\n  );\n\n  const {\n    messages,\n    sendMessage: sdkSendMessage,\n    status: sdkStatus,\n    error,\n    stop,\n    setMessages,\n  } = useChat({\n    id: sessionId,\n    messages: initialMessages as never,\n    transport,\n    onFinish: (message) => {\n      callbacksRef.current?.onMessageReceived?.(message as unknown as ChatMessage);\n    },\n    onError: (err) => {\n      callbacksRef.current?.onError?.(err);\n    },\n  });\n\n  const status: ChatStatus = error\n    ? \"error\"\n    : sdkStatus === \"streaming\" || sdkStatus === \"submitted\"\n      ? \"streaming\"\n      : \"idle\";\n\n  // Persist messages\n  useEffect(() => {\n    if (shouldPersist) persistMessages(safeProjectId, messages);\n  }, [messages, safeProjectId, shouldPersist]);\n\n  // Derive active tools from the latest assistant message\n  const activeTools = useMemo<ActiveTool[]>(() => {\n    if (messages.length === 0) return [];\n    const last = messages[messages.length - 1] as { role: string; parts?: unknown[] };\n    if (last.role !== \"assistant\" || !Array.isArray(last.parts)) return [];\n    return (last.parts as Array<Record<string, unknown>>)\n      .filter((p) => typeof p.type === \"string\" && (p.type as string).startsWith(\"tool-\"))\n      .map((p) => ({\n        toolName: (p.toolName as string) || (p.type as string).replace(\"tool-\", \"\"),\n        state: (p.state as ActiveTool[\"state\"]) || \"output-available\",\n        args: (p.args as Record<string, unknown>) || {},\n        result: p.result,\n        renderMode: (p.renderMode as string) || \"inline\",\n      }));\n  }, [messages]);\n\n  const sendMessage = useCallback(\n    (content: string) => {\n      if (!content.trim()) return;\n      callbacksRef.current?.onMessageSent?.({\n        id: crypto.randomUUID(),\n        role: \"user\",\n        content,\n      } as ChatMessage);\n      sdkSendMessage({ text: content });\n    },\n    [sdkSendMessage]\n  );\n\n  const stopGeneration = useCallback(() => {\n    stop();\n    callbacksRef.current?.onStopGeneration?.();\n  }, [stop]);\n\n  const newConversation = useCallback(() => {\n    setMessages([]);\n    clearPersistedMessages(safeProjectId);\n    if (typeof window !== \"undefined\") {\n      try {\n        sessionStorage.removeItem(SESSION_KEY_PREFIX + safeProjectId);\n      } catch {\n        // Ignore.\n      }\n    }\n    const nextSessionId = getOrCreateSessionId(safeProjectId);\n    setSessionId(nextSessionId);\n    callbacksRef.current?.onNewConversation?.(nextSessionId);\n  }, [safeProjectId, setMessages]);\n\n  const clearMessages = useCallback(() => {\n    setMessages([]);\n    clearPersistedMessages(safeProjectId);\n    callbacksRef.current?.onClearMessages?.();\n  }, [safeProjectId, setMessages]);\n\n  // --- Live Chat (self-contained) ---\n  const [lcState, setLcState] = useState<LiveChatState>(\"ai\");\n  const [lcMessages, setLcMessages] = useState<LiveChatMessage[]>([]);\n  const [lcOperator, setLcOperator] = useState(\"\");\n  const [lcQueue, setLcQueue] = useState(0);\n  const [lcShowIdentity, setLcShowIdentity] = useState(false);\n  const lcTransportRef = useRef<LiveChatTransport | null>(null);\n\n  const lcResetState = useCallback(() => {\n    lcTransportRef.current?.disconnect?.();\n    lcTransportRef.current = null;\n    setLcState(\"ai\");\n    setLcMessages([]);\n    setLcOperator(\"\");\n    setLcQueue(0);\n    setLcShowIdentity(false);\n  }, []);\n\n  const lcInitiate = useCallback(\n    async (visitorName?: string, visitorEmail?: string) => {\n      if (!enableLiveChat || lcTransportRef.current) return;\n      const url = chatServiceUrl ?? apiEndpoint;\n      if (!url || !apiKey) return;\n      try {\n        const transport = new LiveChatTransport({\n          chatServiceUrl: url,\n          apiKey,\n          projectId: safeProjectId,\n          visitorSessionId: sessionId,\n        });\n        transport.on(\"state-change\", (s: LiveChatState) => setLcState(s));\n        transport.on(\"queued\", (data: { position: number }) => setLcQueue(data.position));\n        transport.on(\"queue-update\", (data: { position: number }) => setLcQueue(data.position));\n        transport.on(\"accepted\", (data: { operatorName: string }) => setLcOperator(data.operatorName));\n        transport.on(\"message\", (data: LiveChatMessage) =>\n          setLcMessages((prev) => [...prev, data])\n        );\n        transport.on(\"ended\", () => setLcState(\"ended\"));\n        lcTransportRef.current = transport;\n        await transport.connect();\n        await transport.requestHandoff({\n          visitorName,\n          visitorEmail,\n          aiChatHistory: [],\n        });\n        callbacksRef.current?.onLiveChatRequested?.();\n      } catch (err) {\n        callbacksRef.current?.onError?.(err as Error);\n        setLcState(\"ai\");\n      }\n    },\n    [enableLiveChat, chatServiceUrl, apiEndpoint, apiKey, safeProjectId, sessionId]\n  );\n\n  const liveChat = useMemo<LiveChatReturn>(\n    () => ({\n      state: lcState,\n      messages: lcMessages,\n      operatorName: lcOperator,\n      queuePosition: lcQueue,\n      showIdentityForm: lcShowIdentity,\n      initiate: lcInitiate,\n      send: (content: string) => {\n        if (!content.trim()) return;\n        lcTransportRef.current?.sendMessage?.(content);\n        setLcMessages((prev) => [\n          ...prev,\n          {\n            id: Date.now(),\n            content,\n            senderType: \"visitor\",\n            timestamp: new Date().toISOString(),\n          },\n        ]);\n      },\n      end: () => lcTransportRef.current?.endChat?.(),\n      cancel: () => lcResetState(),\n      submitRating: (rating, comment) =>\n        lcTransportRef.current?.submitRating?.(rating, comment),\n      returnToAI: () => lcResetState(),\n      requestManualHandoff: () => setLcShowIdentity(true),\n      setShowIdentityForm: setLcShowIdentity,\n    }),\n    [lcState, lcMessages, lcOperator, lcQueue, lcShowIdentity, lcInitiate, lcResetState]\n  );\n\n  return {\n    messages: messages as unknown as ChatMessage[],\n    status,\n    error: error as Error | undefined,\n    sessionId,\n    sendMessage,\n    stopGeneration,\n    newConversation,\n    clearMessages,\n    activeTools,\n    liveChat,\n    chatRef,\n  };\n}\n"]}