@aigentyc/chat-sdk 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aigentyc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,156 @@
+# @aigentyc/chat-sdk
+
+> React SDK for building AI-powered chat interfaces connected to the Aigentyc platform.
+
+## Features
+- Drop-in `<Chat />` and `<ChatWidget />` components
+- Full slot system — replace any UI piece
+- Headless mode with `useAigentycChat` hook
+- Backend-driven tool rendering (visualization, json-render, custom HTML)
+- Live chat handoff with Socket.IO
+- Built-in i18n (en, he) — extensible with `addLanguage()`
+- React 19, SSR-compatible (Next.js App Router)
+- Multi-instance support — multiple chats on one page
+- White-label — zero forced branding
+
+## Quickest start — scaffold a new app
+
+```bash
+npm create aigentyc-chat@latest my-app
+cd my-app && npm install && npm run dev
+```
+
+Picks Vite or Next.js, wires your `projectId`, drops in `<Chat />`. Done.
+
+## Add to an existing app
+
+```bash
+npm install @aigentyc/chat-sdk
+```
+
+That's it — core chat, streaming, and tool rendering work out of the box.
+
+Optional peer deps — install only if you use that feature:
+- `socket.io-client` — live chat handoff
+- `recharts` — visualization tool renderer
+- `@json-render/core @json-render/react @json-render/shadcn zod` — json-render tools
+
+## Quick Start
+
+```tsx
+import { Chat } from "@aigentyc/chat-sdk"
+import "@aigentyc/chat-sdk/theme/styles.css"
+
+export function App() {
+  return (
+    <Chat
+      projectId="your-project-id"
+      apiEndpoint="https://api.aigentyc.com"
+      apiKey="your-api-key"
+    />
+  )
+}
+```
+
+## Four Levels of Control
+
+### Level 1 — Drop-in
+```tsx
+<Chat projectId="..." apiEndpoint="..." />
+```
+
+### Level 2 — Customize with slots + theme
+```tsx
+<Chat
+  projectId="..." apiEndpoint="..."
+  theme={{ primaryColor: "#3b82f6" }}
+  slots={{ header: MyHeader, input: MyInput }}
+  onMessageSent={(msg) => analytics.track('chat', msg)}
+/>
+```
+
+### Level 3 — Compose components
+```tsx
+<ChatProvider projectId="..." apiEndpoint="...">
+  <MyLayout>
+    <ChatInterface />
+    <ChatInput />
+  </MyLayout>
+</ChatProvider>
+```
+
+### Level 4 — Headless
+```tsx
+const { messages, sendMessage, status } = useAigentycChat({
+  projectId: "...", apiEndpoint: "..."
+})
+```
+
+## Slots
+
+| Slot | Replaces |
+| --- | --- |
+| `header` | Chat header bar |
+| `welcome` | Welcome / empty state |
+| `message` | Individual message bubble |
+| `input` | Composer / input box |
+| `footer` | Footer below input |
+| `loader` | Loading indicator |
+| `suggestions` | Suggested prompts |
+| `tools` | Per-tool renderers (keyed by tool name) |
+
+## Tool Rendering
+Tools created in the Aigentyc platform come with rendering instructions. The SDK auto-renders based on `uiRenderMode`:
+- `visualization` → recharts
+- `json_render` → component spec via @json-render/shadcn
+- `legacy` → custom HTML/CSS template
+- `preset` → built-in renderers
+
+Override per-tool:
+```tsx
+<Chat slots={{ tools: { searchProducts: MyProductGrid } }} />
+```
+
+## Theming
+All theme tokens are CSS variables under `[data-aigentyc-chat]`. Override via `theme` prop or your own CSS.
+
+## i18n
+Built-in: `en`, `he`. Add custom languages:
+```tsx
+import { addLanguage } from "@aigentyc/chat-sdk/i18n"
+addLanguage("fr", { welcomeTitle: "Bienvenue", ... })
+```
+
+## Live Chat
+Enable Socket.IO-based live chat handoff:
+```tsx
+<Chat enableLiveChat chatServiceUrl="wss://..." />
+```
+
+## Next.js / SSR
+All components have `"use client"` directives. Works in App Router and Pages Router.
+
+## Storybook
+```bash
+npm run storybook
+```
+
+## Demo
+```bash
+cd demo && npm install && npm run dev
+```
+
+## Package Exports
+- `@aigentyc/chat-sdk` — main (Chat, ChatWidget, ChatProvider)
+- `@aigentyc/chat-sdk/core` — types, transport, utils
+- `@aigentyc/chat-sdk/hooks` — all hooks
+- `@aigentyc/chat-sdk/components` — individual chat components
+- `@aigentyc/chat-sdk/ai-elements` — Message, Conversation, etc.
+- `@aigentyc/chat-sdk/tools` — ToolRenderer, VisualizationRenderer
+- `@aigentyc/chat-sdk/json-render` — json-render system
+- `@aigentyc/chat-sdk/ui` — shadcn primitives
+- `@aigentyc/chat-sdk/theme` — ThemeProvider + styles.css
+- `@aigentyc/chat-sdk/i18n` — translations
+
+## License
+MIT

package/dist/JsonRenderResult-Ftw4AKwb.d.cts

@@ -0,0 +1,18 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { Spec } from '@json-render/core';
+
+interface JsonRenderResultProps {
+    spec: Spec;
+    data: unknown;
+    onSendMessage?: (message: string) => void;
+    className?: string;
+    conversationMessages?: Array<{
+        role: string;
+        content: string;
+    }>;
+    /** API key for authenticated requests (form submissions etc.) */
+    apiKey?: string;
+}
+declare function JsonRenderResult({ spec: rawSpec, data, onSendMessage, className, conversationMessages, apiKey, }: JsonRenderResultProps): react_jsx_runtime.JSX.Element;
+
+export { JsonRenderResult as J };

package/dist/JsonRenderResult-Ftw4AKwb.d.ts

@@ -0,0 +1,18 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { Spec } from '@json-render/core';
+
+interface JsonRenderResultProps {
+    spec: Spec;
+    data: unknown;
+    onSendMessage?: (message: string) => void;
+    className?: string;
+    conversationMessages?: Array<{
+        role: string;
+        content: string;
+    }>;
+    /** API key for authenticated requests (form submissions etc.) */
+    apiKey?: string;
+}
+declare function JsonRenderResult({ spec: rawSpec, data, onSendMessage, className, conversationMessages, apiKey, }: JsonRenderResultProps): react_jsx_runtime.JSX.Element;
+
+export { JsonRenderResult as J };

package/dist/JsonRenderResult-GQOYPLVH.cjs

@@ -0,0 +1,15 @@
+"use client";
+'use strict';
+
+var chunkJ2H6MLQF_cjs = require('./chunk-J2H6MLQF.cjs');
+require('./chunk-Q7T3VAJV.cjs');
+require('./chunk-525KS5HM.cjs');
+
+
+
+Object.defineProperty(exports, "JsonRenderResult", {
+  enumerable: true,
+  get: function () { return chunkJ2H6MLQF_cjs.JsonRenderResult; }
+});
+//# sourceMappingURL=JsonRenderResult-GQOYPLVH.cjs.map
+//# sourceMappingURL=JsonRenderResult-GQOYPLVH.cjs.map

package/dist/JsonRenderResult-GQOYPLVH.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"JsonRenderResult-GQOYPLVH.cjs"}

package/dist/JsonRenderResult-ZFJ6VWMS.js

@@ -0,0 +1,6 @@
+"use client";
+export { JsonRenderResult } from './chunk-RPDJXB3U.js';
+import './chunk-5T4FJ2SR.js';
+import './chunk-3RW7O444.js';
+//# sourceMappingURL=JsonRenderResult-ZFJ6VWMS.js.map
+//# sourceMappingURL=JsonRenderResult-ZFJ6VWMS.js.map

package/dist/JsonRenderResult-ZFJ6VWMS.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"JsonRenderResult-ZFJ6VWMS.js"}

package/dist/SlotsContext-CBtt36al.d.ts

@@ -0,0 +1,148 @@
+import { RefObject, ComponentType } from 'react';
+import { f as LiveChatState, e as LiveChatMessage, C as ChatProviderProps, c as ChatMessage, a as ChatConfig, b as ChatEventCallbacks } from './types-DKJ_-nbG.js';
+
+type ChatStatus$1 = "idle" | "streaming" | "error";
+interface ActiveTool$1 {
+    toolName: string;
+    state: "partial-call" | "call" | "output-available";
+    args: Record<string, unknown>;
+    result?: unknown;
+    renderMode: string;
+}
+/** Options for the headless `useAigentycChat` hook (same shape as ChatProviderProps). */
+type UseAigentycChatOptions = Omit<ChatProviderProps, "children" | "slots" | "theme">;
+/** Live chat sub-object returned by the hook. */
+interface LiveChatReturn {
+    state: LiveChatState;
+    messages: LiveChatMessage[];
+    operatorName: string;
+    queuePosition: number;
+    showIdentityForm: boolean;
+    initiate: (visitorName?: string, visitorEmail?: string) => Promise<void>;
+    send: (content: string) => void;
+    end: () => void;
+    cancel: () => void;
+    submitRating: (rating: "positive" | "negative", comment?: string) => void;
+    returnToAI: () => void;
+    requestManualHandoff: () => void;
+    setShowIdentityForm: (show: boolean) => void;
+}
+/** Return value of `useAigentycChat`. */
+interface UseAigentycChatReturn {
+    messages: ChatMessage[];
+    status: ChatStatus$1;
+    error: Error | undefined;
+    sessionId: string;
+    sendMessage: (content: string) => void;
+    stopGeneration: () => void;
+    newConversation: () => void;
+    clearMessages: () => void;
+    activeTools: ActiveTool$1[];
+    liveChat: LiveChatReturn;
+    chatRef: RefObject<HTMLDivElement | null>;
+}
+/**
+ * Standalone headless hook for Aigentyc Chat. No provider needed.
+ *
+ * Creates its own transport, session, and persistence internally. Use this
+ * when you want full control over the UI but still want all SDK features
+ * (chat, tools, live chat, persistence).
+ */
+declare function useAigentycChat(options: UseAigentycChatOptions): UseAigentycChatReturn;
+
+type ChatStatus = "idle" | "streaming" | "error";
+interface ActiveTool {
+    toolName: string;
+    state: "partial-call" | "call" | "output-available";
+    args: Record<string, unknown>;
+    result?: unknown;
+    renderMode: string;
+}
+interface ChatContextValue {
+    messages: ChatMessage[];
+    status: ChatStatus;
+    error: Error | undefined;
+    sessionId: string;
+    config: ChatConfig;
+    activeTools: ActiveTool[];
+    sendMessage: (content: string) => void;
+    stopGeneration: () => void;
+    newConversation: () => void;
+    clearMessages: () => void;
+    callbacks?: ChatEventCallbacks;
+}
+/**
+ * Returns the chat context. Must be used within a `ChatContextProvider`.
+ */
+declare function useChatContext(): ChatContextValue;
+
+interface LiveChatContextValue {
+    /** Current live chat state machine state. */
+    state: LiveChatState;
+    /** Live chat messages. */
+    messages: LiveChatMessage[];
+    /** Name of the connected operator. */
+    operatorName: string;
+    /** Current position in queue. */
+    queuePosition: number;
+    /** Whether to show the visitor identity form. */
+    showIdentityForm: boolean;
+    /** Initiate a live chat session. */
+    initiate: (visitorName?: string, visitorEmail?: string) => Promise<void>;
+    /** Send a message in live chat. */
+    send: (content: string) => void;
+    /** End the live chat session. */
+    end: () => void;
+    /** Cancel a pending live chat request. */
+    cancel: () => void;
+    /** Submit a satisfaction rating. */
+    submitRating: (rating: "positive" | "negative", comment?: string) => void;
+    /** Return to AI chat mode. */
+    returnToAI: () => void;
+    /** Request manual handoff (shows identity form). */
+    requestManualHandoff: () => void;
+    /** Control identity form visibility. */
+    setShowIdentityForm: (show: boolean) => void;
+    /** Register a getter for AI chat history (used for context handoff). */
+    registerAiHistoryGetter: (getter: () => Array<{
+        role: string;
+        content: string;
+    }>) => void;
+    /** Pre-filled user info. */
+    userInfo?: {
+        name?: string;
+        email?: string;
+    } | null;
+}
+/**
+ * Returns the live chat context, or `null` if not within a LiveChatProvider.
+ *
+ * Live chat is opt-in (`enableLiveChat` on `ChatProvider`), so components that
+ * optionally show live-chat UI should handle the null case gracefully.
+ */
+declare function useLiveChat(): LiveChatContextValue | null;
+
+/**
+ * All available slot names that can be overridden.
+ */
+type SlotName = "header" | "footer" | "input" | "welcomePage" | "userMessage" | "assistantMessage" | "systemMessage" | "loader" | "feedback" | "tools" | "toolRenderers" | "liveChatPanel" | "satisfactionRating" | "visitorIdentityForm" | "floatingButton" | "emptyState";
+/**
+ * A slot component receives the default component as a prop alongside its own props.
+ */
+type SlotComponent<P = Record<string, unknown>> = ComponentType<P & {
+    DefaultComponent: ComponentType<P>;
+}>;
+/**
+ * Map of slot name to override component.
+ */
+type SlotMap = Partial<Record<SlotName, SlotComponent<any>>>;
+/**
+ * Returns the full SlotMap from context.
+ */
+declare function useSlots(): SlotMap;
+/**
+ * Returns the override component for the given slot name, or undefined if none is set.
+ */
+declare function useSlot<P = Record<string, unknown>>(name: SlotName): SlotComponent<P> | undefined;
+
+export { type LiveChatReturn as L, type UseAigentycChatOptions as U, type UseAigentycChatReturn as a, useChatContext as b, useLiveChat as c, useSlot as d, useSlots as e, useAigentycChat as u };

package/dist/SlotsContext-CHvISDJT.d.cts

@@ -0,0 +1,148 @@
+import { RefObject, ComponentType } from 'react';
+import { f as LiveChatState, e as LiveChatMessage, C as ChatProviderProps, c as ChatMessage, a as ChatConfig, b as ChatEventCallbacks } from './types-DKJ_-nbG.cjs';
+
+type ChatStatus$1 = "idle" | "streaming" | "error";
+interface ActiveTool$1 {
+    toolName: string;
+    state: "partial-call" | "call" | "output-available";
+    args: Record<string, unknown>;
+    result?: unknown;
+    renderMode: string;
+}
+/** Options for the headless `useAigentycChat` hook (same shape as ChatProviderProps). */
+type UseAigentycChatOptions = Omit<ChatProviderProps, "children" | "slots" | "theme">;
+/** Live chat sub-object returned by the hook. */
+interface LiveChatReturn {
+    state: LiveChatState;
+    messages: LiveChatMessage[];
+    operatorName: string;
+    queuePosition: number;
+    showIdentityForm: boolean;
+    initiate: (visitorName?: string, visitorEmail?: string) => Promise<void>;
+    send: (content: string) => void;
+    end: () => void;
+    cancel: () => void;
+    submitRating: (rating: "positive" | "negative", comment?: string) => void;
+    returnToAI: () => void;
+    requestManualHandoff: () => void;
+    setShowIdentityForm: (show: boolean) => void;
+}
+/** Return value of `useAigentycChat`. */
+interface UseAigentycChatReturn {
+    messages: ChatMessage[];
+    status: ChatStatus$1;
+    error: Error | undefined;
+    sessionId: string;
+    sendMessage: (content: string) => void;
+    stopGeneration: () => void;
+    newConversation: () => void;
+    clearMessages: () => void;
+    activeTools: ActiveTool$1[];
+    liveChat: LiveChatReturn;
+    chatRef: RefObject<HTMLDivElement | null>;
+}
+/**
+ * Standalone headless hook for Aigentyc Chat. No provider needed.
+ *
+ * Creates its own transport, session, and persistence internally. Use this
+ * when you want full control over the UI but still want all SDK features
+ * (chat, tools, live chat, persistence).
+ */
+declare function useAigentycChat(options: UseAigentycChatOptions): UseAigentycChatReturn;
+
+type ChatStatus = "idle" | "streaming" | "error";
+interface ActiveTool {
+    toolName: string;
+    state: "partial-call" | "call" | "output-available";
+    args: Record<string, unknown>;
+    result?: unknown;
+    renderMode: string;
+}
+interface ChatContextValue {
+    messages: ChatMessage[];
+    status: ChatStatus;
+    error: Error | undefined;
+    sessionId: string;
+    config: ChatConfig;
+    activeTools: ActiveTool[];
+    sendMessage: (content: string) => void;
+    stopGeneration: () => void;
+    newConversation: () => void;
+    clearMessages: () => void;
+    callbacks?: ChatEventCallbacks;
+}
+/**
+ * Returns the chat context. Must be used within a `ChatContextProvider`.
+ */
+declare function useChatContext(): ChatContextValue;
+
+interface LiveChatContextValue {
+    /** Current live chat state machine state. */
+    state: LiveChatState;
+    /** Live chat messages. */
+    messages: LiveChatMessage[];
+    /** Name of the connected operator. */
+    operatorName: string;
+    /** Current position in queue. */
+    queuePosition: number;
+    /** Whether to show the visitor identity form. */
+    showIdentityForm: boolean;
+    /** Initiate a live chat session. */
+    initiate: (visitorName?: string, visitorEmail?: string) => Promise<void>;
+    /** Send a message in live chat. */
+    send: (content: string) => void;
+    /** End the live chat session. */
+    end: () => void;
+    /** Cancel a pending live chat request. */
+    cancel: () => void;
+    /** Submit a satisfaction rating. */
+    submitRating: (rating: "positive" | "negative", comment?: string) => void;
+    /** Return to AI chat mode. */
+    returnToAI: () => void;
+    /** Request manual handoff (shows identity form). */
+    requestManualHandoff: () => void;
+    /** Control identity form visibility. */
+    setShowIdentityForm: (show: boolean) => void;
+    /** Register a getter for AI chat history (used for context handoff). */
+    registerAiHistoryGetter: (getter: () => Array<{
+        role: string;
+        content: string;
+    }>) => void;
+    /** Pre-filled user info. */
+    userInfo?: {
+        name?: string;
+        email?: string;
+    } | null;
+}
+/**
+ * Returns the live chat context, or `null` if not within a LiveChatProvider.
+ *
+ * Live chat is opt-in (`enableLiveChat` on `ChatProvider`), so components that
+ * optionally show live-chat UI should handle the null case gracefully.
+ */
+declare function useLiveChat(): LiveChatContextValue | null;
+
+/**
+ * All available slot names that can be overridden.
+ */
+type SlotName = "header" | "footer" | "input" | "welcomePage" | "userMessage" | "assistantMessage" | "systemMessage" | "loader" | "feedback" | "tools" | "toolRenderers" | "liveChatPanel" | "satisfactionRating" | "visitorIdentityForm" | "floatingButton" | "emptyState";
+/**
+ * A slot component receives the default component as a prop alongside its own props.
+ */
+type SlotComponent<P = Record<string, unknown>> = ComponentType<P & {
+    DefaultComponent: ComponentType<P>;
+}>;
+/**
+ * Map of slot name to override component.
+ */
+type SlotMap = Partial<Record<SlotName, SlotComponent<any>>>;
+/**
+ * Returns the full SlotMap from context.
+ */
+declare function useSlots(): SlotMap;
+/**
+ * Returns the override component for the given slot name, or undefined if none is set.
+ */
+declare function useSlot<P = Record<string, unknown>>(name: SlotName): SlotComponent<P> | undefined;
+
+export { type LiveChatReturn as L, type UseAigentycChatOptions as U, type UseAigentycChatReturn as a, useChatContext as b, useLiveChat as c, useSlot as d, useSlots as e, useAigentycChat as u };

package/dist/VisualizationRenderer-FNFYNN66.js

@@ -0,0 +1,5 @@
+"use client";
+export { VisualizationRenderer, VisualizationRenderer_default as default } from './chunk-5T4FJ2SR.js';
+import './chunk-3RW7O444.js';
+//# sourceMappingURL=VisualizationRenderer-FNFYNN66.js.map
+//# sourceMappingURL=VisualizationRenderer-FNFYNN66.js.map

package/dist/VisualizationRenderer-FNFYNN66.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"VisualizationRenderer-FNFYNN66.js"}

package/dist/VisualizationRenderer-VKMZXRUX.cjs

@@ -0,0 +1,20 @@
+"use client";
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var chunkQ7T3VAJV_cjs = require('./chunk-Q7T3VAJV.cjs');
+require('./chunk-525KS5HM.cjs');
+
+
+
+Object.defineProperty(exports, "VisualizationRenderer", {
+  enumerable: true,
+  get: function () { return chunkQ7T3VAJV_cjs.VisualizationRenderer; }
+});
+Object.defineProperty(exports, "default", {
+  enumerable: true,
+  get: function () { return chunkQ7T3VAJV_cjs.VisualizationRenderer_default; }
+});
+//# sourceMappingURL=VisualizationRenderer-VKMZXRUX.cjs.map
+//# sourceMappingURL=VisualizationRenderer-VKMZXRUX.cjs.map

package/dist/VisualizationRenderer-VKMZXRUX.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"VisualizationRenderer-VKMZXRUX.cjs"}