@aigentyc/chat-sdk 0.3.1 → 0.5.0

package/AGENTS.md

@@ -40,7 +40,7 @@ export default function Page() {
   return (
     <Chat
       projectId="YOUR_PROJECT_ID"
-      apiEndpoint="https://api.aigentyc.com"
+      apiEndpoint="https://api.aigentyc.ai"
       apiKey="YOUR_API_KEY"
     />
   )
@@ -140,6 +140,29 @@ Requires `socket.io-client`. Omit both props for AI-only mode.
 
 ---
 
+## Page context (answering about the page the widget is on)
+
+Tell the assistant where the visitor is standing, and it can answer "show me these in 22 AWG"
+without being told which "these".
+
+```tsx
+<ChatWidget
+  projectId="..." apiEndpoint="..."
+  pageUrl={url}                       // current page URL
+  pageTitle={title}                   // current page title
+  pageContext={{ category, filters }} // any JSON your project's system prompt reads
+/>
+```
+
+All three are read **fresh on every message**, so a single-page host can update them on route
+change without remounting the widget — an in-flight stream survives the navigation.
+
+`pageContext` is free-form: shape it to whatever your system prompt expects. Keep it small (it
+is re-sent every turn), and note it is client-supplied — the backend renders it as data, never
+as instructions.
+
+---
+
 ## Rules for agents editing consumer projects
 
 **Do:**

package/claude-skill/aigentyc-chat-sdk/SKILL.md

@@ -24,7 +24,7 @@ Component props are identical between `<Chat>` and `<ChatWidget>` — swap freel
 2. Import CSS once: `import "@aigentyc/chat-sdk/theme/styles.css"`
 3. Pass **three** props: `projectId`, `apiEndpoint`, `apiKey`
 
-**`apiKey` IS required for third-party domain embeds.** Without it, `/api/kb/chat` returns 401. The "no apiKey needed" path only works inside `app.aigentyc.com`. Get a project-scoped key from the dashboard (Settings → API Keys) with permission `Chat: Full` and add the embed domain to Allowed Origins.
+**`apiKey` IS required for third-party domain embeds.** Without it, `/api/kb/chat` returns 401. The "no apiKey needed" path only works inside `app.aigentyc.ai`. Get a project-scoped key from the dashboard (Settings → API Keys) with permission `Chat: Full` and add the embed domain to Allowed Origins.
 
 Environment-variable pattern:
 - Next.js: `NEXT_PUBLIC_AIGENTYC_API_KEY`

package/context7.json

@@ -1,4 +1,4 @@
 {
-  "url": "https://context7.com/llmstxt/cdn_jsdelivr_net_npm_aigentyc_chat-sdk_0_3_1_llms_txt",
+  "url": "https://context7.com/llmstxt/cdn_jsdelivr_net_npm_aigentyc_chat-sdk_0_5_0_llms_txt",
   "public_key": "pk_dHiyF4hGXkgbb1jdrT7TU"
 }

package/dist/{ChatInterface-f8ftS56n.d.ts → ChatInterface-2MN5cpYB.d.ts}

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { Q as QuestionConfig } from './types-DlNwk-bG.js';
+import { Q as QuestionConfig } from './types-bsR_-fq8.js';
 
 interface ChatInterfaceProps {
     /** Allow per-instance overrides of any context value */

package/dist/{ChatInterface-B0zbA3Lm.d.cts → ChatInterface-BnVyOUG5.d.cts}

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { Q as QuestionConfig } from './types-DlNwk-bG.cjs';
+import { Q as QuestionConfig } from './types-bsR_-fq8.cjs';
 
 interface ChatInterfaceProps {
     /** Allow per-instance overrides of any context value */

package/dist/{SlotsContext-BjiX1mRx.d.ts → SlotsContext-BZBi51ZT.d.ts}

@@ -1,6 +1,6 @@
 import * as React from 'react';
 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-DlNwk-bG.js';
+import { g as LiveChatState, f as LiveChatMessage, C as ChatProviderProps, d as ChatMessage, a as ChatAttachmentInput, b as ChatConfig, c as ChatEventCallbacks } from './types-bsR_-fq8.js';
 
 type ChatStatus$1 = "idle" | "streaming" | "error";
 interface ActiveTool$1 {
@@ -34,7 +34,11 @@ interface UseAigentycChatReturn {
     status: ChatStatus$1;
     error: Error | undefined;
     sessionId: string;
-    sendMessage: (content: string) => void;
+    /**
+     * Sends a user turn. `files` travel with it as message parts; a turn carrying
+     * files may have empty text — an image on its own is a question.
+     */
+    sendMessage: (content: string, files?: ChatAttachmentInput[]) => void;
     stopGeneration: () => void;
     newConversation: () => void;
     clearMessages: () => void;
@@ -66,7 +70,11 @@ interface ChatContextValue {
     sessionId: string;
     config: ChatConfig;
     activeTools: ActiveTool[];
-    sendMessage: (content: string) => void;
+    /**
+     * Sends a user turn. `files` travel with it as message parts; a turn carrying
+     * files may have empty text — an image on its own is a question.
+     */
+    sendMessage: (content: string, files?: ChatAttachmentInput[]) => void;
     stopGeneration: () => void;
     newConversation: () => void;
     clearMessages: () => void;
@@ -123,6 +131,83 @@ interface LiveChatContextValue {
  */
 declare function useLiveChat(): LiveChatContextValue | null;
 
+interface AutoResizeOptions {
+    /** Height of a single row, in px, before padding. */
+    minHeight?: number;
+    /** Where growth stops and the textarea starts scrolling internally. */
+    maxHeight?: number;
+}
+/**
+ * Grows a textarea with its content, up to a ceiling.
+ *
+ * Height is recomputed from `scrollHeight`, which only reports the content's
+ * real height once the element has been collapsed first — hence the reset to
+ * `auto` before every measurement. Runs in a layout effect so the box is already
+ * the right size on the frame the character appears, with no visible reflow.
+ *
+ * Returns the ref to attach and a manual `resize()` for the cases React does not
+ * see: a value set imperatively, or a font that finishes loading late.
+ */
+declare function useAutoResize<T extends HTMLTextAreaElement>(value: string, { minHeight, maxHeight }?: AutoResizeOptions): {
+    ref: React.RefObject<T | null>;
+    resize: () => void;
+};
+
+/**
+ * The scripts we can tell apart from a single character, mapped to the BCP-47
+ * tag a speech recogniser wants.
+ *
+ * Deliberately short. A script the visitor is not typing in cannot be guessed
+ * from their text, and a wrong guess is worse than the fallback — dictation in
+ * the wrong language produces confident nonsense rather than an obvious failure.
+ */
+/** Reported for Latin script, which pins a keyboard but not a language. */
+declare const LATIN = "latin";
+/**
+ * The BCP-47 tag implied by a character's script, {@link LATIN} when the script
+ * is Latin, or null when the character says nothing (digits, punctuation,
+ * whitespace, emoji).
+ */
+declare function scriptLanguageOf(char: string): string | null;
+/**
+ * The language of the last character in `text` whose script is identifiable.
+ *
+ * Read from the end because that is what the visitor is typing now: a Hebrew
+ * question that opens with an English part number is still a Hebrew question.
+ */
+declare function detectLanguage(text: string): string | null;
+interface KeyboardLanguageOptions {
+    /**
+     * Used until the visitor has typed something identifiable. Defaults to the
+     * browser's own language.
+     */
+    fallback?: string;
+    /**
+     * Tags this consumer can actually act on, e.g. the languages a recogniser is
+     * configured for. A detection outside the list is ignored rather than
+     * switching to something unsupported.
+     */
+    supported?: string[];
+    /** Latin text is ambiguous; this is which Latin language to call it. */
+    latin?: string;
+}
+/**
+ * Tracks which keyboard the visitor is typing on, by the script of what they type.
+ *
+ * The web exposes no keyboard-layout API, so the characters themselves are the
+ * signal — and they are a good one: a visitor typing Hebrew has a Hebrew
+ * keyboard active, which is exactly what dictation should follow. The answer is
+ * sticky, so clearing the box or dictating into it does not reset the language
+ * back to a default the visitor never chose.
+ *
+ * Feed it every value the composer sees via `observe`.
+ */
+declare function useKeyboardLanguage({ fallback, supported, latin, }?: KeyboardLanguageOptions): {
+    lang: string;
+    setLang: React.Dispatch<React.SetStateAction<string>>;
+    observe: (text: string) => void;
+};
+
 /**
  * All available slot names that can be overridden.
  */
@@ -160,4 +245,4 @@ declare function useSlot<P = Record<string, unknown>>(name: SlotName): SlotCompo
  */
 declare function renderSlot<P>(name: SlotName, props: P, DefaultComponent: ComponentType<P>, slots: SlotMap): React.ReactElement;
 
-export { type LiveChatReturn as L, type SlotComponent as S, type UseAigentycChatOptions as U, type SlotName as a, type UseAigentycChatReturn as b, useChatContext as c, useLiveChat as d, useSlot as e, useSlots as f, renderSlot as r, useAigentycChat as u };
+export { type AutoResizeOptions as A, type KeyboardLanguageOptions as K, LATIN as L, type SlotComponent as S, type UseAigentycChatOptions as U, type LiveChatReturn as a, type SlotName as b, type UseAigentycChatReturn as c, detectLanguage as d, useAutoResize as e, useChatContext as f, useKeyboardLanguage as g, useLiveChat as h, useSlot as i, useSlots as j, renderSlot as r, scriptLanguageOf as s, useAigentycChat as u };

package/dist/{SlotsContext-CEOBjzfh.d.cts → SlotsContext-D_C7zlUA.d.cts}

@@ -1,6 +1,6 @@
 import * as React from 'react';
 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-DlNwk-bG.cjs';
+import { g as LiveChatState, f as LiveChatMessage, C as ChatProviderProps, d as ChatMessage, a as ChatAttachmentInput, b as ChatConfig, c as ChatEventCallbacks } from './types-bsR_-fq8.cjs';
 
 type ChatStatus$1 = "idle" | "streaming" | "error";
 interface ActiveTool$1 {
@@ -34,7 +34,11 @@ interface UseAigentycChatReturn {
     status: ChatStatus$1;
     error: Error | undefined;
     sessionId: string;
-    sendMessage: (content: string) => void;
+    /**
+     * Sends a user turn. `files` travel with it as message parts; a turn carrying
+     * files may have empty text — an image on its own is a question.
+     */
+    sendMessage: (content: string, files?: ChatAttachmentInput[]) => void;
     stopGeneration: () => void;
     newConversation: () => void;
     clearMessages: () => void;
@@ -66,7 +70,11 @@ interface ChatContextValue {
     sessionId: string;
     config: ChatConfig;
     activeTools: ActiveTool[];
-    sendMessage: (content: string) => void;
+    /**
+     * Sends a user turn. `files` travel with it as message parts; a turn carrying
+     * files may have empty text — an image on its own is a question.
+     */
+    sendMessage: (content: string, files?: ChatAttachmentInput[]) => void;
     stopGeneration: () => void;
     newConversation: () => void;
     clearMessages: () => void;
@@ -123,6 +131,83 @@ interface LiveChatContextValue {
  */
 declare function useLiveChat(): LiveChatContextValue | null;
 
+interface AutoResizeOptions {
+    /** Height of a single row, in px, before padding. */
+    minHeight?: number;
+    /** Where growth stops and the textarea starts scrolling internally. */
+    maxHeight?: number;
+}
+/**
+ * Grows a textarea with its content, up to a ceiling.
+ *
+ * Height is recomputed from `scrollHeight`, which only reports the content's
+ * real height once the element has been collapsed first — hence the reset to
+ * `auto` before every measurement. Runs in a layout effect so the box is already
+ * the right size on the frame the character appears, with no visible reflow.
+ *
+ * Returns the ref to attach and a manual `resize()` for the cases React does not
+ * see: a value set imperatively, or a font that finishes loading late.
+ */
+declare function useAutoResize<T extends HTMLTextAreaElement>(value: string, { minHeight, maxHeight }?: AutoResizeOptions): {
+    ref: React.RefObject<T | null>;
+    resize: () => void;
+};
+
+/**
+ * The scripts we can tell apart from a single character, mapped to the BCP-47
+ * tag a speech recogniser wants.
+ *
+ * Deliberately short. A script the visitor is not typing in cannot be guessed
+ * from their text, and a wrong guess is worse than the fallback — dictation in
+ * the wrong language produces confident nonsense rather than an obvious failure.
+ */
+/** Reported for Latin script, which pins a keyboard but not a language. */
+declare const LATIN = "latin";
+/**
+ * The BCP-47 tag implied by a character's script, {@link LATIN} when the script
+ * is Latin, or null when the character says nothing (digits, punctuation,
+ * whitespace, emoji).
+ */
+declare function scriptLanguageOf(char: string): string | null;
+/**
+ * The language of the last character in `text` whose script is identifiable.
+ *
+ * Read from the end because that is what the visitor is typing now: a Hebrew
+ * question that opens with an English part number is still a Hebrew question.
+ */
+declare function detectLanguage(text: string): string | null;
+interface KeyboardLanguageOptions {
+    /**
+     * Used until the visitor has typed something identifiable. Defaults to the
+     * browser's own language.
+     */
+    fallback?: string;
+    /**
+     * Tags this consumer can actually act on, e.g. the languages a recogniser is
+     * configured for. A detection outside the list is ignored rather than
+     * switching to something unsupported.
+     */
+    supported?: string[];
+    /** Latin text is ambiguous; this is which Latin language to call it. */
+    latin?: string;
+}
+/**
+ * Tracks which keyboard the visitor is typing on, by the script of what they type.
+ *
+ * The web exposes no keyboard-layout API, so the characters themselves are the
+ * signal — and they are a good one: a visitor typing Hebrew has a Hebrew
+ * keyboard active, which is exactly what dictation should follow. The answer is
+ * sticky, so clearing the box or dictating into it does not reset the language
+ * back to a default the visitor never chose.
+ *
+ * Feed it every value the composer sees via `observe`.
+ */
+declare function useKeyboardLanguage({ fallback, supported, latin, }?: KeyboardLanguageOptions): {
+    lang: string;
+    setLang: React.Dispatch<React.SetStateAction<string>>;
+    observe: (text: string) => void;
+};
+
 /**
  * All available slot names that can be overridden.
  */
@@ -160,4 +245,4 @@ declare function useSlot<P = Record<string, unknown>>(name: SlotName): SlotCompo
  */
 declare function renderSlot<P>(name: SlotName, props: P, DefaultComponent: ComponentType<P>, slots: SlotMap): React.ReactElement;
 
-export { type LiveChatReturn as L, type SlotComponent as S, type UseAigentycChatOptions as U, type SlotName as a, type UseAigentycChatReturn as b, useChatContext as c, useLiveChat as d, useSlot as e, useSlots as f, renderSlot as r, useAigentycChat as u };
+export { type AutoResizeOptions as A, type KeyboardLanguageOptions as K, LATIN as L, type SlotComponent as S, type UseAigentycChatOptions as U, type LiveChatReturn as a, type SlotName as b, type UseAigentycChatReturn as c, detectLanguage as d, useAutoResize as e, useChatContext as f, useKeyboardLanguage as g, useLiveChat as h, useSlot as i, useSlots as j, renderSlot as r, scriptLanguageOf as s, useAigentycChat as u };