@aigentyc/chat-sdk 0.4.0 → 0.5.1

package/context7.json

@@ -1,4 +1,4 @@
 {
-  "url": "https://context7.com/llmstxt/cdn_jsdelivr_net_npm_aigentyc_chat-sdk_0_4_0_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-0rq8D5-8.d.cts → ChatInterface-DrzYAWnG.d.cts}

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

package/dist/{ChatInterface--yaDB5yp.d.ts → ChatInterface-qiVhkmx3.d.ts}

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

package/dist/{SlotsContext-CWTjP0mA.d.ts → SlotsContext-B_087V7B.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-DQCjs81O.js';
+import { h as LiveChatState, g as LiveChatMessage, b as ChatProviderProps, f as ChatMessage, c as ChatAttachmentInput, d as ChatConfig, e as ChatEventCallbacks } from './types-DRa1zFlN.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,8 +70,21 @@ 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;
+    /**
+     * Re-run the last turn after a failure. No-op while a turn is in flight.
+     *
+     * Worth offering for a transient refusal — a rate limit, a dropped stream, a
+     * momentary 503. It cannot clear a refusal caused by the history itself,
+     * because the same history is what gets re-sent; that needs
+     * {@link ChatContextValue.newConversation}.
+     */
+    retryLastTurn: () => void;
     newConversation: () => void;
     clearMessages: () => void;
     callbacks?: ChatEventCallbacks;
@@ -123,10 +140,87 @@ 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.
  */
-type SlotName = "header" | "footer" | "input" | "welcomePage" | "userMessage" | "assistantMessage" | "systemMessage" | "loader" | "feedback" | "tools" | "toolRenderers" | "liveChatPanel" | "satisfactionRating" | "visitorIdentityForm" | "floatingButton" | "emptyState";
+type SlotName = "header" | "footer" | "input" | "welcomePage" | "userMessage" | "assistantMessage" | "systemMessage" | "loader" | "feedback" | "tools" | "toolRenderers" | "liveChatPanel" | "satisfactionRating" | "visitorIdentityForm" | "floatingButton" | "emptyState" | "error";
 /**
  * A slot component receives the default component as a prop alongside its own props.
  */
@@ -160,4 +254,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-u5CFB7MS.d.cts → SlotsContext-DAQiASVu.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-DQCjs81O.cjs';
+import { h as LiveChatState, g as LiveChatMessage, b as ChatProviderProps, f as ChatMessage, c as ChatAttachmentInput, d as ChatConfig, e as ChatEventCallbacks } from './types-DRa1zFlN.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,8 +70,21 @@ 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;
+    /**
+     * Re-run the last turn after a failure. No-op while a turn is in flight.
+     *
+     * Worth offering for a transient refusal — a rate limit, a dropped stream, a
+     * momentary 503. It cannot clear a refusal caused by the history itself,
+     * because the same history is what gets re-sent; that needs
+     * {@link ChatContextValue.newConversation}.
+     */
+    retryLastTurn: () => void;
     newConversation: () => void;
     clearMessages: () => void;
     callbacks?: ChatEventCallbacks;
@@ -123,10 +140,87 @@ 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.
  */
-type SlotName = "header" | "footer" | "input" | "welcomePage" | "userMessage" | "assistantMessage" | "systemMessage" | "loader" | "feedback" | "tools" | "toolRenderers" | "liveChatPanel" | "satisfactionRating" | "visitorIdentityForm" | "floatingButton" | "emptyState";
+type SlotName = "header" | "footer" | "input" | "welcomePage" | "userMessage" | "assistantMessage" | "systemMessage" | "loader" | "feedback" | "tools" | "toolRenderers" | "liveChatPanel" | "satisfactionRating" | "visitorIdentityForm" | "floatingButton" | "emptyState" | "error";
 /**
  * A slot component receives the default component as a prop alongside its own props.
  */
@@ -160,4 +254,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 };