@devicai/ui 0.57.0 → 0.59.0

package/dist/esm/i18n/useTranslations.js

@@ -0,0 +1,53 @@
+import { jsx } from 'react/jsx-runtime';
+import { createContext, useMemo, useContext } from 'react';
+import { useOptionalDevicContext } from '../provider/DevicContext.js';
+import { createTranslator, mergeTranslations } from './translate.js';
+
+/**
+ * Dictionary contributed by an enclosing component, on top of the provider's.
+ *
+ * It exists so `<ChatDrawer options={{ translations }}>` reaches the input,
+ * the message list and the dialogs it opens without every one of them taking
+ * a prop for it. Nesting merges rather than replaces.
+ */
+const TranslationsScope = createContext(undefined);
+/**
+ * Scopes a dictionary to a subtree. Rarely needed directly — the components
+ * that take a `translations` option already wrap their own subtree with it —
+ * but useful to translate one region of a page differently.
+ */
+function DevicTranslationsProvider({ translations, children, }) {
+    const outer = useContext(TranslationsScope);
+    const value = useMemo(() => mergeTranslations(outer, translations), [outer, translations]);
+    return (jsx(TranslationsScope.Provider, { value: value, children: children }));
+}
+/**
+ * The dictionary in force here: the provider's, plus any scoped by an
+ * enclosing component, plus the `local` argument. Later layers win.
+ */
+function useTranslationsDictionary(local) {
+    const context = useOptionalDevicContext();
+    const scoped = useContext(TranslationsScope);
+    const global = context?.translations;
+    return useMemo(() => mergeTranslations(global, scoped, local), [global, scoped, local]);
+}
+/**
+ * Returns `t`, the translator for every text this library renders itself.
+ *
+ * Works with or without a `DevicProvider`: with no dictionary anywhere it
+ * returns the English text unchanged, which is what a component mounted
+ * standalone gets.
+ *
+ * @example
+ * ```tsx
+ * const t = useTranslations();
+ * <button aria-label={t('New chat')}>…</button>
+ * ```
+ */
+function useTranslations(local) {
+    const dictionary = useTranslationsDictionary(local);
+    return useMemo(() => createTranslator(dictionary), [dictionary]);
+}
+
+export { DevicTranslationsProvider, useTranslations, useTranslationsDictionary };
+//# sourceMappingURL=useTranslations.js.map

package/dist/esm/i18n/useTranslations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTranslations.js","sources":["../../../src/i18n/useTranslations.tsx"],"sourcesContent":["import React, { createContext, useContext, useMemo } from 'react';\nimport { useOptionalDevicContext } from '../provider/DevicContext';\nimport { createTranslator, mergeTranslations } from './translate';\nimport type { DevicTranslations, Translator } from './types';\n\n/**\n * Dictionary contributed by an enclosing component, on top of the provider's.\n *\n * It exists so `<ChatDrawer options={{ translations }}>` reaches the input,\n * the message list and the dialogs it opens without every one of them taking\n * a prop for it. Nesting merges rather than replaces.\n */\nconst TranslationsScope = createContext<DevicTranslations | undefined>(undefined);\n\nexport interface DevicTranslationsProviderProps {\n  /** Entries added on top of the enclosing dictionaries. */\n  translations?: DevicTranslations;\n  children: React.ReactNode;\n}\n\n/**\n * Scopes a dictionary to a subtree. Rarely needed directly — the components\n * that take a `translations` option already wrap their own subtree with it —\n * but useful to translate one region of a page differently.\n */\nexport function DevicTranslationsProvider({\n  translations,\n  children,\n}: DevicTranslationsProviderProps): JSX.Element {\n  const outer = useContext(TranslationsScope);\n  const value = useMemo(\n    () => mergeTranslations(outer, translations),\n    [outer, translations]\n  );\n  return (\n    <TranslationsScope.Provider value={value}>\n      {children}\n    </TranslationsScope.Provider>\n  );\n}\n\n/**\n * The dictionary in force here: the provider's, plus any scoped by an\n * enclosing component, plus the `local` argument. Later layers win.\n */\nexport function useTranslationsDictionary(\n  local?: DevicTranslations\n): DevicTranslations | undefined {\n  const context = useOptionalDevicContext();\n  const scoped = useContext(TranslationsScope);\n  const global = context?.translations;\n  return useMemo(\n    () => mergeTranslations(global, scoped, local),\n    [global, scoped, local]\n  );\n}\n\n/**\n * Returns `t`, the translator for every text this library renders itself.\n *\n * Works with or without a `DevicProvider`: with no dictionary anywhere it\n * returns the English text unchanged, which is what a component mounted\n * standalone gets.\n *\n * @example\n * ```tsx\n * const t = useTranslations();\n * <button aria-label={t('New chat')}>…</button>\n * ```\n */\nexport function useTranslations(local?: DevicTranslations): Translator {\n  const dictionary = useTranslationsDictionary(local);\n  return useMemo(() => createTranslator(dictionary), [dictionary]);\n}\n"],"names":["_jsx"],"mappings":";;;;;AAKA;;;;;;AAMG;AACH,MAAM,iBAAiB,GAAG,aAAa,CAAgC,SAAS,CAAC;AAQjF;;;;AAIG;SACa,yBAAyB,CAAC,EACxC,YAAY,EACZ,QAAQ,GACuB,EAAA;AAC/B,IAAA,MAAM,KAAK,GAAG,UAAU,CAAC,iBAAiB,CAAC;IAC3C,MAAM,KAAK,GAAG,OAAO,CACnB,MAAM,iBAAiB,CAAC,KAAK,EAAE,YAAY,CAAC,EAC5C,CAAC,KAAK,EAAE,YAAY,CAAC,CACtB;AACD,IAAA,QACEA,GAAA,CAAC,iBAAiB,CAAC,QAAQ,EAAA,EAAC,KAAK,EAAE,KAAK,EAAA,QAAA,EACrC,QAAQ,EAAA,CACkB;AAEjC;AAEA;;;AAGG;AACG,SAAU,yBAAyB,CACvC,KAAyB,EAAA;AAEzB,IAAA,MAAM,OAAO,GAAG,uBAAuB,EAAE;AACzC,IAAA,MAAM,MAAM,GAAG,UAAU,CAAC,iBAAiB,CAAC;AAC5C,IAAA,MAAM,MAAM,GAAG,OAAO,EAAE,YAAY;IACpC,OAAO,OAAO,CACZ,MAAM,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAC9C,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,CACxB;AACH;AAEA;;;;;;;;;;;;AAYG;AACG,SAAU,eAAe,CAAC,KAAyB,EAAA;AACvD,IAAA,MAAM,UAAU,GAAG,yBAAyB,CAAC,KAAK,CAAC;AACnD,IAAA,OAAO,OAAO,CAAC,MAAM,gBAAgB,CAAC,UAAU,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;AAClE;;;;"}

package/dist/esm/index.d.ts

@@ -1,7 +1,9 @@
 export { DevicProvider, DevicContext, useDevicContext, useOptionalDevicContext } from './provider';
 export type { DevicProviderConfig, DevicProviderProps, DevicContextValue, TenantMetadata, SubtenantMetadata, AIReference, DrawerRegistration, } from './provider';
-export { ChatDrawer, ChatMessages, ChatInput, ToolTimeline, ConversationSelector, HandoffSubagentWidget, ReferenceChip, UsageBar, LimitBanner, QueueNotice, RecalledMemoriesWidget, CompactionWidget } from './components/ChatDrawer';
-export type { ChatDrawerProps, ChatDrawerOptions, ChatDrawerHandle, ChatMessagesProps, ChatInputProps, CustomPromptBoxProps, MessageBubbleRenderer, MessageBubbleRendererProps, ToolTimelineProps, AllowedFileTypes, ConversationSelectorProps, HandoffSubagentWidgetProps, ReferenceChipProps, ReferenceChipVariant, SuggestedMessage, UsageBarProps, UsageBarDisplay, UsageBarData, LimitBannerProps, QueueNoticeProps, RecalledMemoriesWidgetProps, RecalledMemoriesRenderer, RecalledMemoriesRendererProps, CompactionWidgetProps, CompactionRenderer, CompactionRendererProps, } from './components/ChatDrawer';
+export { DevicTranslationsProvider, useTranslations, useTranslationsDictionary, createTranslator, translate, mergeTranslations, fillTemplate, } from './i18n';
+export type { DevicTranslations, Translator, DevicTranslationsProviderProps, } from './i18n';
+export { ChatDrawer, ChatMessages, ChatInput, ToolTimeline, ConversationSelector, HandoffSubagentWidget, ReferenceChip, UsageBar, LimitBanner, QueueNotice, RecalledMemoriesWidget, CompactionWidget, GuardrailNotice } from './components/ChatDrawer';
+export type { ChatDrawerProps, ChatDrawerOptions, ChatDrawerHandle, ChatMessagesProps, ChatInputProps, CustomPromptBoxProps, MessageBubbleRenderer, MessageBubbleRendererProps, ToolTimelineProps, AllowedFileTypes, ConversationSelectorProps, HandoffSubagentWidgetProps, ReferenceChipProps, ReferenceChipVariant, SuggestedMessage, UsageBarProps, UsageBarDisplay, UsageBarData, LimitBannerProps, QueueNoticeProps, RecalledMemoriesWidgetProps, RecalledMemoriesRenderer, RecalledMemoriesRendererProps, CompactionWidgetProps, CompactionRenderer, CompactionRendererProps, GuardrailNoticeProps, GuardrailRenderer, GuardrailPayload, } from './components/ChatDrawer';
 export { CoreMemoryModal, DEFAULT_CORE_MEMORY_LABELS } from './components/CoreMemoryModal';
 export type { CoreMemoryModalProps, CoreMemoryLabels } from './components/CoreMemoryModal';
 export { IntegrationsModal, IntegrationsPanel, IntegrationsLauncher, IntegrationsHint, IntegrationLogo, useIntegrations, McpServersSection, McpConnectForm, useTenantMcp, integrationChoiceKey, readIntegrationChoice, writeIntegrationChoice, pruneIntegrationChoice, } from './components/IntegrationsModal';

package/dist/esm/index.js

@@ -1,5 +1,7 @@
 export { DevicProvider } from './provider/DevicProvider.js';
 export { DevicContext, useDevicContext, useOptionalDevicContext } from './provider/DevicContext.js';
+export { DevicTranslationsProvider, useTranslations, useTranslationsDictionary } from './i18n/useTranslations.js';
+export { createTranslator, fillTemplate, mergeTranslations, translate } from './i18n/translate.js';
 export { ChatDrawer } from './components/ChatDrawer/ChatDrawer.js';
 export { ChatMessages } from './components/ChatDrawer/ChatMessages.js';
 export { ChatInput } from './components/ChatDrawer/ChatInput.js';
@@ -12,6 +14,7 @@ export { LimitBanner } from './components/ChatDrawer/LimitBanner.js';
 export { QueueNotice } from './components/ChatDrawer/QueueNotice.js';
 export { RecalledMemoriesWidget } from './components/ChatDrawer/RecalledMemoriesWidget.js';
 export { CompactionWidget } from './components/ChatDrawer/CompactionWidget.js';
+export { GuardrailNotice } from './components/ChatDrawer/GuardrailNotice.js';
 export { CoreMemoryModal, DEFAULT_CORE_MEMORY_LABELS } from './components/CoreMemoryModal/CoreMemoryModal.js';
 export { IntegrationsModal } from './components/IntegrationsModal/IntegrationsModal.js';
 export { IntegrationsPanel } from './components/IntegrationsModal/IntegrationsPanel.js';

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/esm/provider/DevicContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"DevicContext.js","sources":["../../../src/provider/DevicContext.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\nimport type { DevicContextValue } from './types';\n\n/**\n * Context for Devic configuration\n */\nexport const DevicContext = createContext<DevicContextValue | null>(null);\n\n/**\n * Hook to access the Devic context\n * @throws Error if used outside of DevicProvider\n */\nexport function useDevicContext(): DevicContextValue {\n  const context = useContext(DevicContext);\n  if (!context) {\n    throw new Error(\n      'useDevicContext must be used within a DevicProvider. ' +\n      'Make sure to wrap your component tree with <DevicProvider>.'\n    );\n  }\n  return context;\n}\n\n/**\n * Hook to optionally access the Devic context\n * Returns null if not within a provider (for components that can work standalone)\n */\nexport function useOptionalDevicContext(): DevicContextValue | null {\n  return useContext(DevicContext);\n}\n"],"names":[],"mappings":";;AAGA;;AAEG;MACU,YAAY,GAAG,aAAa,CAA2B,IAAI;AAExE;;;AAGG;SACa,eAAe,GAAA;AAC7B,IAAA,MAAM,OAAO,GAAG,UAAU,CAAC,YAAY,CAAC;IACxC,IAAI,CAAC,OAAO,EAAE;QACZ,MAAM,IAAI,KAAK,CACb,uDAAuD;AACvD,YAAA,6DAA6D,CAC9D;IACH;AACA,IAAA,OAAO,OAAO;AAChB;AAEA;;;AAGG;SACa,uBAAuB,GAAA;AACrC,IAAA,OAAO,UAAU,CAAC,YAAY,CAAC;AACjC;;"}
+{"version":3,"file":"DevicContext.js","sources":["../../../src/provider/DevicContext.ts"],"sourcesContent":["import { createContext, useContext } from 'react';\nimport type { DevicContextValue } from './types';\n\n/**\n * Context for Devic configuration\n */\nexport const DevicContext = createContext<DevicContextValue | null>(null);\n\n/**\n * Hook to access the Devic context\n * @throws Error if used outside of DevicProvider\n */\nexport function useDevicContext(): DevicContextValue {\n  const context = useContext(DevicContext);\n  if (!context) {\n    throw new Error(\n      'useDevicContext must be used within a DevicProvider. ' +\n      'Make sure to wrap your component tree with <DevicProvider>.'\n    );\n  }\n  return context;\n}\n\n/**\n * Hook to optionally access the Devic context\n * Returns null if not within a provider (for components that can work standalone)\n */\nexport function useOptionalDevicContext(): DevicContextValue | null {\n  return useContext(DevicContext);\n}\n"],"names":[],"mappings":";;AAGA;;AAEG;MACU,YAAY,GAAG,aAAa,CAA2B,IAAI;AAExE;;;AAGG;SACa,eAAe,GAAA;AAC7B,IAAA,MAAM,OAAO,GAAG,UAAU,CAAC,YAAY,CAAC;IACxC,IAAI,CAAC,OAAO,EAAE;QACZ,MAAM,IAAI,KAAK,CACb,uDAAuD;AACvD,YAAA,6DAA6D,CAC9D;IACH;AACA,IAAA,OAAO,OAAO;AAChB;AAEA;;;AAGG;SACa,uBAAuB,GAAA;AACrC,IAAA,OAAO,UAAU,CAAC,YAAY,CAAC;AACjC;;;;"}

package/dist/esm/provider/DevicProvider.d.ts

@@ -14,4 +14,4 @@ import type { DevicProviderProps } from './types';
  * </DevicProvider>
  * ```
  */
-export declare function DevicProvider({ apiKey, getTenantSession, onSessionExpired, baseUrl, tenantId, tenantMetadata, subtenantId, subtenantMetadata, tags, pollingInterval, debug, children, }: DevicProviderProps): JSX.Element;
+export declare function DevicProvider({ apiKey, getTenantSession, onSessionExpired, baseUrl, tenantId, tenantMetadata, subtenantId, subtenantMetadata, tags, pollingInterval, streaming, translations, debug, children, }: DevicProviderProps): JSX.Element;

package/dist/esm/provider/DevicProvider.js

@@ -21,7 +21,7 @@ const DEFAULT_BASE_URL = 'https://api.devic.ai';
  * </DevicProvider>
  * ```
  */
-function DevicProvider({ apiKey, getTenantSession, onSessionExpired, baseUrl = DEFAULT_BASE_URL, tenantId, tenantMetadata, subtenantId, subtenantMetadata, tags, pollingInterval, debug, children, }) {
+function DevicProvider({ apiKey, getTenantSession, onSessionExpired, baseUrl = DEFAULT_BASE_URL, tenantId, tenantMetadata, subtenantId, subtenantMetadata, tags, pollingInterval, streaming, translations, debug, children, }) {
     const [references, setReferences] = useState([]);
     const drawerRef = useRef(null);
     const addReference = useCallback((ref) => {
@@ -81,6 +81,8 @@ function DevicProvider({ apiKey, getTenantSession, onSessionExpired, baseUrl = D
         subtenantMetadata,
         tags,
         pollingInterval,
+        streaming,
+        translations,
         isConfigured: !!apiKey || usesSessions,
         debug,
         references,
@@ -102,6 +104,8 @@ function DevicProvider({ apiKey, getTenantSession, onSessionExpired, baseUrl = D
         subtenantMetadata,
         tags,
         pollingInterval,
+        streaming,
+        translations,
         debug,
         references,
         addReference,

package/dist/esm/provider/DevicProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"DevicProvider.js","sources":["../../../src/provider/DevicProvider.tsx"],"sourcesContent":["import React, { useMemo, useState, useRef, useCallback } from 'react';\nimport { DevicContext } from './DevicContext';\nimport { DevicApiClient } from '../api/client';\nimport { createSharedSession } from './sharedSession';\nimport { generateId } from '../utils';\nimport type {\n  DevicProviderProps,\n  DevicContextValue,\n  AIReference,\n  DrawerRegistration,\n} from './types';\n\nconst DEFAULT_BASE_URL = 'https://api.devic.ai';\n\n/**\n * Provider component for Devic UI configuration\n *\n * @example\n * ```tsx\n * <DevicProvider\n *   apiKey=\"devic-xxx\"\n *   baseUrl=\"https://api.devic.ai\"\n *   tenantId=\"tenant-123\"\n *   tenantMetadata={{ userId: '456' }}\n * >\n *   <App />\n * </DevicProvider>\n * ```\n */\nexport function DevicProvider({\n  apiKey,\n  getTenantSession,\n  onSessionExpired,\n  baseUrl = DEFAULT_BASE_URL,\n  tenantId,\n  tenantMetadata,\n  subtenantId,\n  subtenantMetadata,\n  tags,\n  pollingInterval,\n  debug,\n  children,\n}: DevicProviderProps): JSX.Element {\n  const [references, setReferences] = useState<AIReference[]>([]);\n  const drawerRef = useRef<DrawerRegistration | null>(null);\n\n  const addReference = useCallback((ref: Omit<AIReference, 'id'>): string => {\n    const id = generateId();\n    setReferences((prev) => [...prev, { ...ref, id }]);\n    return id;\n  }, []);\n\n  const removeReference = useCallback((id: string) => {\n    setReferences((prev) => prev.filter((r) => r.id !== id));\n  }, []);\n\n  const clearReferences = useCallback(() => {\n    setReferences([]);\n  }, []);\n\n  const registerDrawer = useCallback((handle: DrawerRegistration) => {\n    drawerRef.current = handle;\n    return () => {\n      if (drawerRef.current === handle) {\n        drawerRef.current = null;\n      }\n    };\n  }, []);\n\n  const openDrawer = useCallback(() => {\n    drawerRef.current?.open();\n  }, []);\n\n  // Both callbacks are read through a ref and handed on as stable wrappers.\n  // An inline `getTenantSession={() => …}` is a new function on every render,\n  // and passing it straight through would rebuild the client — throwing away\n  // the session it holds, so the page fetches a token per render — and rebuild\n  // the context, so every component below it would do the same.\n  const sessionSourceRef = useRef(getTenantSession);\n  sessionSourceRef.current = getTenantSession;\n  const expiredRef = useRef(onSessionExpired);\n  expiredRef.current = onSessionExpired;\n  const usesSessions = !!getTenantSession;\n\n  // One session for the whole tree: every component below builds its own API\n  // client, and each dedupes only its own renewals — so without this, N clients\n  // ask for N tokens. See `createSharedSession`.\n  const tenantSession = useMemo(\n    () =>\n      usesSessions\n        ? createSharedSession(() => sessionSourceRef.current!())\n        : undefined,\n    [usesSessions]\n  );\n  const sessionExpired = useMemo(() => () => expiredRef.current?.(), []);\n\n  const client = useMemo(\n    () =>\n      new DevicApiClient({\n        apiKey,\n        baseUrl,\n        getTenantSession: tenantSession,\n        onSessionExpired: sessionExpired,\n      }),\n    [apiKey, baseUrl, tenantSession, sessionExpired]\n  );\n\n  const contextValue = useMemo<DevicContextValue>(\n    () => ({\n      client,\n      apiKey,\n      getTenantSession: tenantSession,\n      onSessionExpired: sessionExpired,\n      baseUrl,\n      tenantId,\n      tenantMetadata,\n      subtenantId,\n      subtenantMetadata,\n      tags,\n      pollingInterval,\n      isConfigured: !!apiKey || usesSessions,\n      debug,\n      references,\n      addReference,\n      removeReference,\n      clearReferences,\n      registerDrawer,\n      openDrawer,\n    }),\n    [\n      client,\n      apiKey,\n      tenantSession,\n      sessionExpired,\n      usesSessions,\n      baseUrl,\n      tenantId,\n      tenantMetadata,\n      subtenantId,\n      subtenantMetadata,\n      tags,\n      pollingInterval,\n      debug,\n      references,\n      addReference,\n      removeReference,\n      clearReferences,\n      registerDrawer,\n      openDrawer,\n    ]\n  );\n\n  return (\n    <DevicContext.Provider value={contextValue}>\n      {children}\n    </DevicContext.Provider>\n  );\n}\n"],"names":["_jsx"],"mappings":"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"}
+{"version":3,"file":"DevicProvider.js","sources":["../../../src/provider/DevicProvider.tsx"],"sourcesContent":["import React, { useMemo, useState, useRef, useCallback } from 'react';\nimport { DevicContext } from './DevicContext';\nimport { DevicApiClient } from '../api/client';\nimport { createSharedSession } from './sharedSession';\nimport { generateId } from '../utils';\nimport type {\n  DevicProviderProps,\n  DevicContextValue,\n  AIReference,\n  DrawerRegistration,\n} from './types';\n\nconst DEFAULT_BASE_URL = 'https://api.devic.ai';\n\n/**\n * Provider component for Devic UI configuration\n *\n * @example\n * ```tsx\n * <DevicProvider\n *   apiKey=\"devic-xxx\"\n *   baseUrl=\"https://api.devic.ai\"\n *   tenantId=\"tenant-123\"\n *   tenantMetadata={{ userId: '456' }}\n * >\n *   <App />\n * </DevicProvider>\n * ```\n */\nexport function DevicProvider({\n  apiKey,\n  getTenantSession,\n  onSessionExpired,\n  baseUrl = DEFAULT_BASE_URL,\n  tenantId,\n  tenantMetadata,\n  subtenantId,\n  subtenantMetadata,\n  tags,\n  pollingInterval,\n  streaming,\n  translations,\n  debug,\n  children,\n}: DevicProviderProps): JSX.Element {\n  const [references, setReferences] = useState<AIReference[]>([]);\n  const drawerRef = useRef<DrawerRegistration | null>(null);\n\n  const addReference = useCallback((ref: Omit<AIReference, 'id'>): string => {\n    const id = generateId();\n    setReferences((prev) => [...prev, { ...ref, id }]);\n    return id;\n  }, []);\n\n  const removeReference = useCallback((id: string) => {\n    setReferences((prev) => prev.filter((r) => r.id !== id));\n  }, []);\n\n  const clearReferences = useCallback(() => {\n    setReferences([]);\n  }, []);\n\n  const registerDrawer = useCallback((handle: DrawerRegistration) => {\n    drawerRef.current = handle;\n    return () => {\n      if (drawerRef.current === handle) {\n        drawerRef.current = null;\n      }\n    };\n  }, []);\n\n  const openDrawer = useCallback(() => {\n    drawerRef.current?.open();\n  }, []);\n\n  // Both callbacks are read through a ref and handed on as stable wrappers.\n  // An inline `getTenantSession={() => …}` is a new function on every render,\n  // and passing it straight through would rebuild the client — throwing away\n  // the session it holds, so the page fetches a token per render — and rebuild\n  // the context, so every component below it would do the same.\n  const sessionSourceRef = useRef(getTenantSession);\n  sessionSourceRef.current = getTenantSession;\n  const expiredRef = useRef(onSessionExpired);\n  expiredRef.current = onSessionExpired;\n  const usesSessions = !!getTenantSession;\n\n  // One session for the whole tree: every component below builds its own API\n  // client, and each dedupes only its own renewals — so without this, N clients\n  // ask for N tokens. See `createSharedSession`.\n  const tenantSession = useMemo(\n    () =>\n      usesSessions\n        ? createSharedSession(() => sessionSourceRef.current!())\n        : undefined,\n    [usesSessions]\n  );\n  const sessionExpired = useMemo(() => () => expiredRef.current?.(), []);\n\n  const client = useMemo(\n    () =>\n      new DevicApiClient({\n        apiKey,\n        baseUrl,\n        getTenantSession: tenantSession,\n        onSessionExpired: sessionExpired,\n      }),\n    [apiKey, baseUrl, tenantSession, sessionExpired]\n  );\n\n  const contextValue = useMemo<DevicContextValue>(\n    () => ({\n      client,\n      apiKey,\n      getTenantSession: tenantSession,\n      onSessionExpired: sessionExpired,\n      baseUrl,\n      tenantId,\n      tenantMetadata,\n      subtenantId,\n      subtenantMetadata,\n      tags,\n      pollingInterval,\n      streaming,\n      translations,\n      isConfigured: !!apiKey || usesSessions,\n      debug,\n      references,\n      addReference,\n      removeReference,\n      clearReferences,\n      registerDrawer,\n      openDrawer,\n    }),\n    [\n      client,\n      apiKey,\n      tenantSession,\n      sessionExpired,\n      usesSessions,\n      baseUrl,\n      tenantId,\n      tenantMetadata,\n      subtenantId,\n      subtenantMetadata,\n      tags,\n      pollingInterval,\n      streaming,\n      translations,\n      debug,\n      references,\n      addReference,\n      removeReference,\n      clearReferences,\n      registerDrawer,\n      openDrawer,\n    ]\n  );\n\n  return (\n    <DevicContext.Provider value={contextValue}>\n      {children}\n    </DevicContext.Provider>\n  );\n}\n"],"names":["_jsx"],"mappings":"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"}

package/dist/esm/provider/sharedSession.js.map

@@ -1 +1 @@
-{"version":3,"file":"sharedSession.js","sources":["../../../src/provider/sharedSession.ts"],"sourcesContent":["import type { TenantSessionToken } from '../api/client';\n\n/**\n * Renew this long before expiry. A little wider than the client's own margin,\n * so the sharing decides when to renew and the clients find a live token rather\n * than each reaching for one.\n */\nconst RENEWAL_MARGIN_MS = 90_000;\n\n/** The `exp` inside a JWT, in epoch ms. Unknown when it cannot be read. */\nfunction expiryOf(token: string): number | undefined {\n  try {\n    const payload = token.split('.')[1];\n    if (!payload) return undefined;\n    const json = atob(payload.replace(/-/g, '+').replace(/_/g, '/'));\n    const exp = JSON.parse(json)?.exp;\n    return typeof exp === 'number' ? exp * 1000 : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/** Whatever the integrator returned, as a token with an expiry we can compare. */\nexport function normaliseSession(\n  result: string | TenantSessionToken,\n): TenantSessionToken {\n  if (typeof result === 'string') {\n    return { token: result, expiresAt: expiryOf(result) };\n  }\n  const declared =\n    result.expiresAt ??\n    (result.expiresIn ? Date.now() + result.expiresIn * 1000 : undefined);\n  return { ...result, expiresAt: declared ?? expiryOf(result.token) };\n}\n\n/**\n * One session for a whole tree of components.\n *\n * Every component in this library builds its own API client, and each of those\n * dedupes only its own renewals — so N clients ask for N tokens. Opening the\n * drawer fired three requests at the integrator's backend before anyone had\n * said a word. The sharing belongs where there is exactly one of something,\n * which is the provider, and not in each client, where there is not.\n *\n * `force` is what a client passes after the API refused the token it just used.\n * The cached answer is then known to be dead, so it is skipped: without that, a\n * shared cache would hand the refused token straight back and turn a\n * recoverable 401 into a widget that never speaks again.\n */\nexport function createSharedSession(\n  source: () => Promise<string | TenantSessionToken>,\n): (force?: boolean) => Promise<TenantSessionToken> {\n  let value: TenantSessionToken | undefined;\n  let inFlight: Promise<TenantSessionToken> | undefined;\n\n  return (force = false) => {\n    const stillGood =\n      value &&\n      (value.expiresAt === undefined ||\n        value.expiresAt - Date.now() > RENEWAL_MARGIN_MS);\n    if (stillGood && !force) return Promise.resolve(value!);\n\n    if (!inFlight) {\n      inFlight = Promise.resolve(source())\n        .then((result) => {\n          value = normaliseSession(result);\n          return value;\n        })\n        .finally(() => {\n          inFlight = undefined;\n        });\n    }\n    return inFlight;\n  };\n}\n"],"names":[],"mappings":"AAEA;;;;AAIG;AACH,MAAM,iBAAiB,GAAG,KAAM;AAEhC;AACA,SAAS,QAAQ,CAAC,KAAa,EAAA;AAC7B,IAAA,IAAI;QACF,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACnC,QAAA,IAAI,CAAC,OAAO;AAAE,YAAA,OAAO,SAAS;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAChE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG;AACjC,QAAA,OAAO,OAAO,GAAG,KAAK,QAAQ,GAAG,GAAG,GAAG,IAAI,GAAG,SAAS;IACzD;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,SAAS;IAClB;AACF;AAEA;AACM,SAAU,gBAAgB,CAC9B,MAAmC,EAAA;AAEnC,IAAA,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;AAC9B,QAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE;IACvD;AACA,IAAA,MAAM,QAAQ,GACZ,MAAM,CAAC,SAAS;SACf,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,GAAG,IAAI,GAAG,SAAS,CAAC;AACvE,IAAA,OAAO,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;AACrE;AAEA;;;;;;;;;;;;;AAaG;AACG,SAAU,mBAAmB,CACjC,MAAkD,EAAA;AAElD,IAAA,IAAI,KAAqC;AACzC,IAAA,IAAI,QAAiD;AAErD,IAAA,OAAO,CAAC,KAAK,GAAG,KAAK,KAAI;QACvB,MAAM,SAAS,GACb,KAAK;AACL,aAAC,KAAK,CAAC,SAAS,KAAK,SAAS;gBAC5B,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,iBAAiB,CAAC;QACrD,IAAI,SAAS,IAAI,CAAC,KAAK;AAAE,YAAA,OAAO,OAAO,CAAC,OAAO,CAAC,KAAM,CAAC;QAEvD,IAAI,CAAC,QAAQ,EAAE;AACb,YAAA,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE;AAChC,iBAAA,IAAI,CAAC,CAAC,MAAM,KAAI;AACf,gBAAA,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC;AAChC,gBAAA,OAAO,KAAK;AACd,YAAA,CAAC;iBACA,OAAO,CAAC,MAAK;gBACZ,QAAQ,GAAG,SAAS;AACtB,YAAA,CAAC,CAAC;QACN;AACA,QAAA,OAAO,QAAQ;AACjB,IAAA,CAAC;AACH;;"}
+{"version":3,"file":"sharedSession.js","sources":["../../../src/provider/sharedSession.ts"],"sourcesContent":["import type { TenantSessionToken } from '../api/client';\n\n/**\n * Renew this long before expiry. A little wider than the client's own margin,\n * so the sharing decides when to renew and the clients find a live token rather\n * than each reaching for one.\n */\nconst RENEWAL_MARGIN_MS = 90_000;\n\n/** The `exp` inside a JWT, in epoch ms. Unknown when it cannot be read. */\nfunction expiryOf(token: string): number | undefined {\n  try {\n    const payload = token.split('.')[1];\n    if (!payload) return undefined;\n    const json = atob(payload.replace(/-/g, '+').replace(/_/g, '/'));\n    const exp = JSON.parse(json)?.exp;\n    return typeof exp === 'number' ? exp * 1000 : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/** Whatever the integrator returned, as a token with an expiry we can compare. */\nexport function normaliseSession(\n  result: string | TenantSessionToken,\n): TenantSessionToken {\n  if (typeof result === 'string') {\n    return { token: result, expiresAt: expiryOf(result) };\n  }\n  const declared =\n    result.expiresAt ??\n    (result.expiresIn ? Date.now() + result.expiresIn * 1000 : undefined);\n  return { ...result, expiresAt: declared ?? expiryOf(result.token) };\n}\n\n/**\n * One session for a whole tree of components.\n *\n * Every component in this library builds its own API client, and each of those\n * dedupes only its own renewals — so N clients ask for N tokens. Opening the\n * drawer fired three requests at the integrator's backend before anyone had\n * said a word. The sharing belongs where there is exactly one of something,\n * which is the provider, and not in each client, where there is not.\n *\n * `force` is what a client passes after the API refused the token it just used.\n * The cached answer is then known to be dead, so it is skipped: without that, a\n * shared cache would hand the refused token straight back and turn a\n * recoverable 401 into a widget that never speaks again.\n */\nexport function createSharedSession(\n  source: () => Promise<string | TenantSessionToken>,\n): (force?: boolean) => Promise<TenantSessionToken> {\n  let value: TenantSessionToken | undefined;\n  let inFlight: Promise<TenantSessionToken> | undefined;\n\n  return (force = false) => {\n    const stillGood =\n      value &&\n      (value.expiresAt === undefined ||\n        value.expiresAt - Date.now() > RENEWAL_MARGIN_MS);\n    if (stillGood && !force) return Promise.resolve(value!);\n\n    if (!inFlight) {\n      inFlight = Promise.resolve(source())\n        .then((result) => {\n          value = normaliseSession(result);\n          return value;\n        })\n        .finally(() => {\n          inFlight = undefined;\n        });\n    }\n    return inFlight;\n  };\n}\n"],"names":[],"mappings":"AAEA;;;;AAIG;AACH,MAAM,iBAAiB,GAAG,KAAM;AAEhC;AACA,SAAS,QAAQ,CAAC,KAAa,EAAA;AAC7B,IAAA,IAAI;QACF,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACnC,QAAA,IAAI,CAAC,OAAO;AAAE,YAAA,OAAO,SAAS;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAChE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG;AACjC,QAAA,OAAO,OAAO,GAAG,KAAK,QAAQ,GAAG,GAAG,GAAG,IAAI,GAAG,SAAS;IACzD;AAAE,IAAA,MAAM;AACN,QAAA,OAAO,SAAS;IAClB;AACF;AAEA;AACM,SAAU,gBAAgB,CAC9B,MAAmC,EAAA;AAEnC,IAAA,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;AAC9B,QAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE;IACvD;AACA,IAAA,MAAM,QAAQ,GACZ,MAAM,CAAC,SAAS;SACf,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,SAAS,GAAG,IAAI,GAAG,SAAS,CAAC;AACvE,IAAA,OAAO,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;AACrE;AAEA;;;;;;;;;;;;;AAaG;AACG,SAAU,mBAAmB,CACjC,MAAkD,EAAA;AAElD,IAAA,IAAI,KAAqC;AACzC,IAAA,IAAI,QAAiD;AAErD,IAAA,OAAO,CAAC,KAAK,GAAG,KAAK,KAAI;QACvB,MAAM,SAAS,GACb,KAAK;AACL,aAAC,KAAK,CAAC,SAAS,KAAK,SAAS;gBAC5B,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,iBAAiB,CAAC;QACrD,IAAI,SAAS,IAAI,CAAC,KAAK;AAAE,YAAA,OAAO,OAAO,CAAC,OAAO,CAAC,KAAM,CAAC;QAEvD,IAAI,CAAC,QAAQ,EAAE;AACb,YAAA,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE;AAChC,iBAAA,IAAI,CAAC,CAAC,MAAM,KAAI;AACf,gBAAA,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC;AAChC,gBAAA,OAAO,KAAK;AACd,YAAA,CAAC;iBACA,OAAO,CAAC,MAAK;gBACZ,QAAQ,GAAG,SAAS;AACtB,YAAA,CAAC,CAAC;QACN;AACA,QAAA,OAAO,QAAQ;AACjB,IAAA,CAAC;AACH;;;;"}

package/dist/esm/provider/types.d.ts

@@ -1,4 +1,5 @@
 import type { DevicApiClient } from '../api/client';
+import type { DevicTranslations } from '../i18n/types';
 /**
  * Tenant-level identity metadata sent to the Devic API. Used for per-tenant
  * cost attribution and to enrich the tenant record (name, contact, logo).
@@ -138,6 +139,45 @@ export interface DevicProviderConfig {
      * @default 1000
      */
     pollingInterval?: number;
+    /**
+     * Follow a conversation in progress over a server-sent event stream
+     * instead of polling it, for every component under this provider. The
+     * assistant's reply then arrives as it is produced, and the request per
+     * `pollingInterval` becomes a fallback that only runs while the stream is
+     * down. Needs an API that serves `GET .../chats/:chatUid/stream`; against
+     * an older one the widgets notice and keep polling. Overridable per
+     * component via its own `streaming`.
+     *
+     * @default false
+     */
+    streaming?: boolean;
+    /**
+     * Translations for the texts the library renders itself — the drawer
+     * header, the input placeholder, the buttons and tooltips of every widget.
+     *
+     * A plain `English text → your text` map, so the values come from whatever
+     * i18n system the host already runs (i18next, react-intl, a JSON per
+     * locale): nothing is looked up here beyond the key. Anything absent stays
+     * in English, so a partial dictionary is fine, and texts already
+     * configurable on their own (`welcomeMessage`, `inputPlaceholder`, …) keep
+     * winning over it.
+     *
+     * Texts with a `{name}` placeholder keep it in the translation; the
+     * placeholders are filled after the lookup, so they may be reordered.
+     *
+     * @example
+     * ```tsx
+     * <DevicProvider
+     *   apiKey="devic-xxx"
+     *   translations={{
+     *     'New chat': 'Nueva conversación',
+     *     'Type a message...': 'Escribe un mensaje...',
+     *     'Close chat': 'Cerrar el chat',
+     *   }}
+     * >
+     * ```
+     */
+    translations?: DevicTranslations;
     /**
      * Enable debug logging to the browser console
      * @default false
@@ -219,6 +259,17 @@ export interface DevicContextValue {
      * integrator did not configure one, so each component keeps its own default.
      */
     pollingInterval?: number;
+    /**
+     * Whether conversations are followed over a server-sent event stream.
+     * Undefined when the integrator did not choose, so each component keeps its
+     * own default.
+     */
+    streaming?: boolean;
+    /**
+     * Translations for the texts the library renders itself, keyed by the
+     * English text. Undefined when the integrator configured none.
+     */
+    translations?: DevicTranslations;
     /**
      * Whether the provider is properly configured
      */