@devicai/ui 0.57.0 → 0.58.0

package/README.md

@@ -12,6 +12,7 @@ React component library for integrating Devic AI assistants into your applicatio
 - **Model Interface Protocol** - Support for client-side tool execution
 - **Message queue** - Write while the assistant is still answering, on assistants that allow it
 - **Message Feedback** - Built-in thumbs up/down feedback with comments
+- **Translations** - A `text: translation` dictionary for every text the library renders
 - **CSS Variables** - Easy theming with CSS custom properties
 - **TypeScript** - Full type definitions included
 - **React 17+** - Compatible with React 17 and above
@@ -96,6 +97,7 @@ Context provider for global configuration.
   tenantId="tenant-123"        // Optional global tenant
   tenantMetadata={{ ... }}     // Optional global metadata
   pollingInterval={1000}       // How often a conversation in progress is polled
+  translations={{ ... }}       // Optional `English text -> your text` dictionary
 >
   <App />
 </DevicProvider>
@@ -134,6 +136,12 @@ Values below 250 ms are clamped — below that the widget floods the API instead
 of answering sooner. The handoff widget, which only watches a subagent run,
 keeps its own 5 s default when nothing is configured.
 
+#### Texts in another language
+
+`translations` replaces the texts the library renders itself, keyed by the
+English text — `{ 'New chat': 'Nueva conversación' }`. See
+[Translations](#translations).
+
 #### Tenant sessions — proving who the end user is
 
 With an API key alone, the tenant is whatever the page says it is. The key sits
@@ -408,6 +416,48 @@ Both are also available from the hook: `useDevicChat().compactions` (the
 checkpoints, oldest first) and `useDevicChat().compaction` (the one being
 written right now, or `null`).
 
+#### Turns stopped by a guardrail
+
+An assistant with guardrails configured can have a turn stopped before it ever
+reaches the model. The backend records that as a `guard_rail` message, and the
+drawer draws it as a notice naming the guardrail that fired — not as a bubble,
+because nobody said it.
+
+To say it in another language, translate its texts like any other
+([Translations](#translations)):
+
+```ts
+translations: {
+  'Your message was stopped by the “{name}” guardrail.':
+    'Tu mensaje ha sido bloqueado por el guardrail «{name}».',
+  'This message was stopped by a guardrail.':
+    'Este mensaje ha sido bloqueado por un guardrail.',
+}
+```
+
+Supply a renderer instead when the notice needs a different shape — to drop the
+guardrail's name, for example, if end users should not see it:
+
+```tsx
+<ChatDrawer
+  assistantId="my-assistant"
+  options={{
+    guardrailRenderer: ({ payload }) => (
+      <MyNotice tone="warning">
+        {`No puedo ayudarte con eso (${payload?.info?.guardrail_name ?? 'guardrail'}).`}
+      </MyNotice>
+    ),
+  }}
+/>
+```
+
+`payload` is the provider result the backend recorded — `info.guardrail_name`,
+`info.confidence`, `info.threshold` and `info.stage_name` (`"input"` when the
+person's message was stopped, otherwise the answer was). `text` carries the
+message instead when the backend sent a plain sentence. Return `null` to hide
+the notice entirely, though a conversation that simply stops with no answer and
+no explanation reads as a bug to the person in it.
+
 ### CoreMemoryModal
 
 Modal showing — and letting the end user edit — the **core memory** of an
@@ -1135,6 +1185,118 @@ Or use the `color` option in ChatDrawer:
 />
 ```
 
+## Translations
+
+Every text the library renders itself — the drawer header, the composer, the
+buttons, tooltips and dialogs — goes through a dictionary you can replace.
+It is a plain `English text → your text` map:
+
+```tsx
+<DevicProvider
+  apiKey="devic-xxx"
+  translations={{
+    'New chat': 'Nueva conversación',
+    'Type a message...': 'Escribe un mensaje...',
+    'Close chat': 'Cerrar el chat',
+    'Send message': 'Enviar mensaje',
+  }}
+>
+  <ChatDrawer assistantId="my-assistant" />
+</DevicProvider>
+```
+
+That is the whole mechanism. There is no i18n runtime bundled here and no key
+catalogue to learn: the key is what you see on screen, and the values come
+from whatever you already use — i18next, react-intl, a JSON file per locale.
+Hand it the strings for the current language and re-render when it changes:
+
+```tsx
+const { t, i18n } = useTranslation('devic');
+
+<DevicProvider
+  apiKey="devic-xxx"
+  // Re-created when the language changes, which is what re-renders the widget.
+  translations={useMemo(
+    () => ({
+      'New chat': t('newChat'),
+      'Type a message...': t('inputPlaceholder'),
+    }),
+    [i18n.language]
+  )}
+>
+```
+
+**Anything you leave out stays in English**, so a partial dictionary is fine —
+translate the drawer today and the apps dialog when you get to it.
+
+### Placeholders
+
+Texts that carry a value use `{name}` placeholders. Keep them in the
+translation; they are filled after the lookup, so they may be reordered:
+
+```tsx
+translations={{
+  '{count} messages': '{count} mensajes',
+  'Resets in {count} minutes.': 'Quedan {count} minutos para el reinicio.',
+  '{label} — {count} switched off': '{count} desactivadas de {label}',
+}}
+```
+
+Counted texts come in a singular and a plural entry (`1 message` and
+`{count} messages`), so a language that inflects differently has somewhere to
+say so.
+
+### Per component
+
+Each component takes its own `translations`, merged on top of the provider's.
+Use it when one widget must read differently from the rest of the page:
+
+```tsx
+<ChatDrawer
+  assistantId="support"
+  options={{ translations: { 'New chat': 'Nueva consulta' } }}
+/>
+```
+
+Available on `ChatDrawer`, `AICommandBar`, `AIGenerationButton` and
+`AIElementWrapper`, and it reaches everything they mount — the message list,
+the composer and the dialogs they open. For anything else, wrap a subtree:
+
+```tsx
+import { DevicTranslationsProvider } from '@devicai/ui';
+
+<DevicTranslationsProvider translations={{ Close: 'Cerrar' }}>
+  <IntegrationsPanel assistantId="my-assistant" />
+</DevicTranslationsProvider>
+```
+
+Later layers win: provider → enclosing component → the component's own option.
+
+### What takes precedence
+
+Texts that already have an option of their own (`welcomeMessage`,
+`inputPlaceholder`, `title`, `integrationsLabel`, `coreMemoryLabels`, …) keep
+winning over the dictionary — the dictionary only supplies their defaults. So
+a host that has always set `inputPlaceholder` sees no change, and one that
+never did gets it translated.
+
+### The full list
+
+[TRANSLATIONS.md](./TRANSLATIONS.md) lists every text, grouped by where it
+appears. Two things to watch: copy the key exactly (same case, same `…` and
+`·`), and note that `AIElementWrapper` has shipped Spanish defaults since it
+was added, so its keys are Spanish.
+
+### Reading the dictionary yourself
+
+`useTranslations` returns the same translator the components use, for a custom
+UI built on `useDevicChat`:
+
+```tsx
+const t = useTranslations();
+<button>{t('Send message')}</button>
+```
+
 ## Message Queue
 
 Assistants can be configured to accept messages sent while they are still

package/dist/cjs/api/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sources":["../../../../src/api/types.ts"],"sourcesContent":["import type { AvatarStyle } from '../utils/avatar';\n\nimport type React from 'react';\n\n/**\n * File attachment for messages\n */\nexport interface ChatFile {\n  name: string;\n  downloadUrl?: string;\n  fileType?: 'image' | 'document' | 'audio' | 'video' | 'other';\n}\n\n/**\n * Attachment as it appears on a message.\n *\n * Two shapes reach the UI for the same thing: the optimistic message built\n * locally on send uses `url`/`type`, while the history returned by the API\n * carries the stored `downloadUrl`/`fileType`. Both are accepted here; use\n * `normalizeMessageFile` before reading them.\n */\nexport interface MessageFile {\n  name: string;\n  url?: string;\n  type?: string;\n  downloadUrl?: string;\n  fileType?: string;\n}\n\n/**\n * Message content structure\n */\nexport interface MessageContent {\n  message?: string;\n  data?: any;\n  files?: MessageFile[];\n}\n\n/** Collapse either attachment shape into a single one the UI can render. */\nexport function normalizeMessageFile(file: MessageFile): {\n  name: string;\n  url: string;\n  type: string;\n} {\n  return {\n    name: file.name,\n    url: file.url || file.downloadUrl || '',\n    type: file.type || file.fileType || 'other',\n  };\n}\n\n/**\n * Tool call from the model\n */\nexport interface ToolCall {\n  id: string;\n  type: 'function';\n  function: {\n    name: string;\n    arguments: string;\n  };\n}\n\n/**\n * Chat message structure\n */\nexport interface ChatMessage {\n  uid: string;\n  role: 'user' | 'assistant' | 'developer' | 'system' | 'tool';\n  content: MessageContent;\n  timestamp: number;\n  chatUid?: string;\n  tool_calls?: ToolCall[];\n  tool_call_id?: string;\n  summary?: string;\n  /**\n   * Where `content.message` came from, when the model did not write it.\n   * `'finish_tool'`: the assistant is configured to require a tool call to\n   * finish (\"Require Tool Use to Finish\") and the backend lifted the reply from\n   * the finish tool's `message` argument, so it can be read without parsing\n   * tool calls. Absent on replies the model wrote itself — use it to label the\n   * bubble as produced by the tool.\n   */\n  contentSource?: string;\n  /**\n   * Id of a speech-to-text transcript (from POST /api/v1/whisper) that seeded\n   * this message. Present on user messages dictated by voice; the chat can use\n   * it to fetch the source audio (GET /api/v1/whisper/:transcriptId) and offer\n   * playback.\n   */\n  transcriptId?: string;\n  /**\n   * Original server uid, present when the UI adopted an optimistic uid for\n   * this message to keep React keys stable. Server-side references (e.g.\n   * memory recall anchors) match against it.\n   */\n  serverUid?: string;\n  /**\n   * Client-side only: the conversation was busy when this message was sent, so\n   * it was accepted into the queue and is waiting its turn. Drawn as a message\n   * that has not landed rather than as part of the conversation. Falls away on\n   * its own once the message comes back inside the history.\n   */\n  queued?: boolean;\n  /**\n   * Client-side only: when this message was accepted into the queue. Used to\n   * tell \"the server has not reported it yet\" from \"the server no longer has\n   * it\", which the timestamp is the only honest way to decide.\n   */\n  queuedAt?: number;\n}\n\n/**\n * Previous conversation message for initialization\n */\nexport interface PreviousMessage {\n  message: string;\n  role: 'user' | 'assistant';\n}\n\n/**\n * Model interface tool schema following OpenAI function calling format\n */\nexport interface ModelInterfaceToolSchema {\n  type: 'function';\n  function: {\n    name: string;\n    description: string;\n    parameters: {\n      type: 'object';\n      properties: Record<string, any>;\n      required?: string[];\n    };\n  };\n}\n\n/**\n * Props passed to a response widget component.\n * The widget is responsible for collecting the user's response and\n * calling `submit` with the payload to resolve the tool call.\n */\nexport interface ResponseWidgetProps {\n  /** The tool call this widget is responding to */\n  toolCall: ToolCall;\n  /** Parsed arguments from the tool call */\n  params: any;\n  /** Submit the tool response payload (sent as the tool call result to the model) */\n  submit: (response: any) => void;\n  /** Cancel the tool call. Sends an error response so the model can continue. */\n  cancel?: (reason?: string) => void;\n  /** Whether the widget is currently submitting */\n  isSubmitting?: boolean;\n}\n\n/**\n * Interactive response widget configuration for a client-side tool.\n *\n * When the model calls a tool configured with a `responseWidget`, the\n * widget is rendered in the chat UI instead of executing a callback.\n * The user interacts with the widget, which calls `submit(response)` to\n * define the tool response sent back to the model.\n *\n * - `render: 'inline'` renders the widget in the message thread at the\n *   position of the tool call. The text input remains enabled.\n * - `render: 'input'` replaces the chat input area with the widget\n *   while it is pending. The text input is disabled until submission.\n */\nexport interface ResponseWidgetConfig {\n  /** Where to render the widget */\n  render: 'inline' | 'input';\n  /** The widget component */\n  component: React.ComponentType<ResponseWidgetProps>;\n}\n\n/**\n * Model interface tool definition for client-side tools.\n *\n * A tool must provide either a `callback` (executed automatically when\n * the model invokes the tool) or a `responseWidget` (renders UI for\n * the user to produce the tool response). Providing both is an error.\n */\nexport interface ModelInterfaceTool {\n  toolName: string;\n  schema: ModelInterfaceToolSchema;\n  /** Executed automatically when the model calls this tool */\n  callback?: (params: any) => Promise<any> | any;\n  /** Interactive widget that collects the user's tool response */\n  responseWidget?: ResponseWidgetConfig;\n}\n\n/**\n * Tool call response to send back to the API\n */\nexport interface ToolCallResponse {\n  tool_call_id: string;\n  content: any;\n  role: 'tool';\n  /**\n   * The client-side tools still on offer for the rest of the turn. The API\n   * reads them off the first response of the batch: leaving them out drops\n   * the tools from the continuation, so the model cannot call them again.\n   */\n  tools?: ModelInterfaceToolSchema[];\n}\n\n/**\n * DTO for sending messages to the assistant\n */\nexport interface ProcessMessageDto {\n  message: string;\n  chatUid?: string;\n  userName?: string;\n  files?: ChatFile[];\n  /** Tags to associate with this chat (top-level, distinct from `metadata`). */\n  tags?: string[];\n  metadata?: {\n    promptTemplateParams?: Record<string, any>;\n    tenantToken?: string;\n    [key: string]: any;\n  };\n  tenantId?: string;\n  previousConversation?: PreviousMessage[];\n  enabledTools?: string[];\n  provider?: string;\n  model?: string;\n  // Model interface protocol fields\n  tools?: ModelInterfaceToolSchema[];\n  applicationState?: Record<string, any>;\n  skipSummarization?: boolean;\n  /**\n   * Id of a speech-to-text transcript (from POST /api/v1/whisper) that seeded\n   * this message. Sent so the conversation keeps a link to the original audio.\n   */\n  transcriptId?: string;\n}\n\n/**\n * Response from the /whisper speech-to-text endpoint.\n */\nexport interface WhisperTranscriptionResponse {\n  /** Public id of the transcript; send it back as ProcessMessageDto.transcriptId. */\n  transcriptId: string;\n  /** Transcribed text. */\n  text: string;\n  /** Language hint used, if any. */\n  language?: string;\n  /** Download URL of the source audio. */\n  audioUrl?: string;\n  /** Transcription model used. */\n  model?: string;\n}\n\n/**\n * Response from the assistant\n */\nexport interface AssistantResponse {\n  messages: ChatMessage[];\n  chatUid: string;\n  inputTokens?: number;\n  outputTokens?: number;\n}\n\n/**\n * Async mode response\n */\nexport interface AsyncResponse {\n  chatUid: string;\n  message?: string;\n  error?: string;\n  /**\n   * The conversation could not take the message right now, so it was queued\n   * instead of starting a run of its own. Still an acceptance: the answer comes\n   * later, and may cover several messages at once.\n   */\n  queued?: boolean;\n  /** How many messages are queued on this conversation, this one included. */\n  queuePosition?: number;\n  /** When the queued message reaches the model. */\n  willProcess?: QueueDisposition;\n}\n\n/**\n * When a queued message will reach the model.\n *\n * `after_delay` is the one that is not about being busy: an idle conversation\n * on an assistant with an input delay collects what is written during the\n * window, so a message can come back queued with nothing in flight at all.\n */\nexport type QueueDisposition = 'after_delay' | 'next_turn' | 'on_resume';\n\n/** Response of the stop endpoint. */\nexport interface StopChatResponse {\n  chatUid: string;\n  message: string;\n  /**\n   * Queued messages the stop threw away — answering them would be the opposite\n   * of what was asked. Handed back so their text can be put where the user\n   * wrote it. Absent on an API older than this, and when nothing was queued.\n   */\n  discardedMessages?: ChatMessage[];\n}\n\n/**\n * Real-time chat history status.\n * `limit_exceeded` means the message was blocked before reaching the LLM\n * because a configured tenant/subtenant usage limit was reached.\n */\nexport type RealtimeStatus =\n  | 'processing'\n  | 'completed'\n  | 'error'\n  | 'waiting_for_tool_response'\n  | 'handed_off'\n  | 'limit_exceeded'\n  /** Collecting messages during the assistant's input delay, before any run. */\n  | 'buffering';\n\n/**\n * Details of a tenant/subtenant usage limit that blocked a message.\n * Returned on the realtime endpoint when status is `limit_exceeded`, and on\n * the HTTP 429 body (`details`) when a synchronous request is blocked.\n */\nexport interface TenantLimitExceeded {\n  /** Human-readable message describing the block. */\n  message?: string;\n  /** The rule that triggered the block (scope, metric, window, limit…). */\n  blockingRule?: {\n    scope?: 'tenant' | 'subtenant';\n    subtenantId?: string;\n    metric?: 'tokens' | 'cost';\n    windowUnit?: 'hour' | 'day' | 'week' | 'month';\n    windowEvery?: number;\n    limit?: number;\n  };\n  /** Current consumption in the blocking window. */\n  current?: number;\n  /** The limit that was reached. */\n  limit?: number;\n  /** Epoch ms when the blocking window resets and usage is allowed again. */\n  resetsAt?: number;\n}\n\n/** One fact a long-term-memory recall surfaced. */\nexport interface RecalledMemoryFact {\n  fact: string;\n  relation: string;\n  /** Source entity name of the graph edge, when the fact connects two. */\n  source: string | null;\n  /** Target entity name of the graph edge, when the fact connects two. */\n  target: string | null;\n  /** ISO date the fact became valid, if known. */\n  validAt: string | null;\n}\n\n/** One graph entity a long-term-memory recall surfaced. */\nexport interface RecalledMemoryEntity {\n  id: string;\n  name: string;\n  type: string;\n  summary: string | null;\n}\n\n/** One previous-session turn a conversation-start recall carried over. */\nexport interface RecalledMemoryTurn {\n  role: string;\n  content: string;\n}\n\n/**\n * One structured long-term-memory recall event of a conversation: the facts,\n * entities and previous-session turns a recall surfaced, plus the uid of the\n * message that brought it in (`messageUid`: the initial user message, or the\n * assistant message carrying the memory tool call — resolvable through\n * `toolCallId` while the run is still in flight).\n */\nexport interface RecalledMemoryRecord {\n  uid: string;\n  messageUid?: string;\n  toolCallId?: string;\n  source:\n    | 'conversation_start'\n    | 'search_memory'\n    | 'search_memory_nodes'\n    | 'explore_memory_graph';\n  query?: string;\n  facts?: RecalledMemoryFact[];\n  entities?: RecalledMemoryEntity[];\n  turns?: RecalledMemoryTurn[];\n  timestampMs: number;\n}\n\n/**\n * Snapshot of the core-memory block a conversation saw (audit trail): the\n * render revision plus the injected entries as structured items.\n */\nexport interface CoreMemorySnapshot {\n  uid: string;\n  revision: string;\n  items: Array<{\n    id: number;\n    section: string;\n    content: string;\n    pinned: boolean;\n    source: string;\n  }>;\n  entries: number;\n  omitted: number;\n  chars: number;\n  timestampMs: number;\n}\n\n/**\n * Real-time chat history response\n */\nexport interface RealtimeChatHistory {\n  chatUID: string;\n  clientUID: string;\n  chatHistory: ChatMessage[];\n  status: RealtimeStatus;\n  lastUpdatedAt: number;\n  pendingToolCalls?: ToolCall[];\n  handedOffSubThreadId?: string;\n  /** Present only when status is `limit_exceeded`. */\n  limitExceeded?: TenantLimitExceeded;\n  /**\n   * Memory-recall events of the in-flight run — lets the UI show what the\n   * assistant is recalling while the response is still processing.\n   */\n  recalledMemories?: RecalledMemoryRecord[];\n  /**\n   * Messages accepted into this conversation that the model has not seen yet.\n   * Non-zero means more is coming: a `completed` status with messages still\n   * queued is not the end of the exchange.\n   */\n  queuedMessages?: number;\n  /**\n   * The queued messages themselves. This is the conversation's queue, not the\n   * caller's — it can include messages the same conversation received through\n   * another channel. Absent on an API that does not return them, in which case\n   * the widget falls back to its own optimistic copies.\n   */\n  pendingUserMessages?: ChatMessage[];\n  /**\n   * Compaction checkpoints of the in-flight run. A conversation that compacts\n   * mid-run stops sending the messages above the cut immediately, so these\n   * arrive here before they are persisted on the conversation.\n   */\n  compactions?: CompactionCheckpoint[];\n  /** The compaction running right now, if any. */\n  compaction?: CompactionActivity;\n}\n\n/**\n * A single usage rule with its current consumption (from GET\n * /api/v1/tenant-usage/:tenantId[/subtenants/:subtenantId]).\n */\nexport interface TenantUsageRule {\n  scope: 'tenant' | 'subtenant';\n  subtenantId?: string;\n  metric: 'tokens' | 'cost';\n  windowUnit: 'hour' | 'day' | 'week' | 'month';\n  windowEvery: number;\n  /** Configured limit for the window. */\n  limit: number;\n  /** Current consumption in the active window. */\n  current: number;\n  /** Utilization percentage (0..100, capped). */\n  percent: number;\n  /** Epoch ms when the active window resets. */\n  resetsAt?: number;\n  /** Where the rule comes from ('tier' | 'adhoc'). */\n  origin?: string;\n  /** Tier the rule belongs to, if any. */\n  tierId?: string;\n}\n\n/**\n * Response of GET /api/v1/tenant-usage/:tenantId[/subtenants/:subtenantId]:\n * the effective usage rules with their current consumption + the active tier.\n */\nexport interface TenantUsage {\n  tenantId: string;\n  subtenantId?: string;\n  tierId?: string;\n  usage: TenantUsageRule[];\n}\n\n/**\n * A durable per-window usage history row (from GET\n * /api/v1/tenant-usage/:tenantId/history).\n */\nexport interface TenantUsageHistoryRow {\n  clientUID: string;\n  tenantId: string;\n  subtenantId: string;\n  scope: 'tenant' | 'subtenant';\n  metric: 'tokens' | 'cost';\n  windowUnit: 'hour' | 'day' | 'week' | 'month';\n  windowEvery: number;\n  windowKey: string;\n  windowStart: number;\n  windowEnd: number;\n  /** Counted consumption (enforced). */\n  consumption: number;\n  /** Exempt consumption that did not count toward the limit, if any. */\n  exemptConsumption?: number;\n  limit: number;\n  percent: number;\n  tierId?: string;\n  origin?: string;\n  capturedAt: number;\n}\n\n/**\n * Options for querying tenant usage history.\n */\nexport interface TenantUsageHistoryQuery {\n  subtenantId?: string;\n  scope?: 'tenant' | 'subtenant';\n  metric?: 'tokens' | 'cost';\n  windowUnit?: 'hour' | 'day' | 'week' | 'month';\n  /** Epoch ms lower bound (windowEnd >= from). */\n  from?: number;\n  /** Epoch ms upper bound (windowEnd <= to). */\n  to?: number;\n  limit?: number;\n  skip?: number;\n}\n\n/**\n * Chat history structure\n */\n/** A concrete value carried verbatim through a compaction. */\nexport interface CompactionFact {\n  kind: string;\n  value: string;\n  label?: string;\n}\n\n/** The structured body a compaction produced. */\nexport interface CompactionSummary {\n  goal?: string;\n  constraints?: string[];\n  inProgress?: string;\n  pending?: string[];\n  decisions?: string[];\n  data?: Array<{ label: string; value: string }>;\n  done?: string[];\n  openQuestions?: string[];\n  /** Fallback when the model answered without structure. */\n  raw?: string;\n}\n\n/**\n * One compaction of a conversation: the messages before its boundary folded\n * into a written summary plus the identifiers, paths and urls lifted out of\n * them verbatim. From then on the model receives the checkpoint instead of\n * those messages — which are still in the conversation, and still shown.\n *\n * Only the newest checkpoint is in force: each compaction merges the previous\n * summary into itself.\n */\nexport interface CompactionCheckpoint {\n  uid: string;\n  /** 1 for the first compaction of the conversation, 2 for the next… */\n  index: number;\n  timestampMs: number;\n  trigger: 'auto' | 'manual';\n  /** First message that still travels verbatim. */\n  firstKeptMessageUid?: string;\n  /** Last folded message: where the widget belongs in the conversation. */\n  anchorMessageUid?: string;\n  compactedMessageCount: number;\n  summary: CompactionSummary;\n  facts: CompactionFact[];\n  tokensBefore: number;\n  tokensAfter: number;\n  provider?: string;\n  model?: string;\n  cost?: number;\n}\n\n/**\n * A compaction happening right now, from the realtime endpoint.\n *\n * A compaction is a model call of its own, taken between two assistant\n * messages, so a client that only knows `processing` shows a conversation\n * that appears to have stalled for a few seconds. Present while it runs and\n * on the single update that reports it finished.\n */\nexport interface CompactionActivity {\n  state: 'running' | 'completed';\n  startedAt: number;\n  /**\n   * What this pass is folding: the messages new since the last checkpoint.\n   * Not the conversation's totals — a checkpoint's own\n   * `compactedMessageCount` and `tokensBefore` are cumulative across every\n   * compaction, so the two are on different scales and must not be paired.\n   */\n  messageCount: number;\n  tokensBefore: number;\n  /** Which checkpoint the pass produced, once it is done. */\n  index?: number;\n  finishedAt?: number;\n}\n\nexport interface ChatHistory {\n  chatUID: string;\n  clientUID: string;\n  userUID: string;\n  chatContent: ChatMessage[];\n  name?: string;\n  assistantSpecializationIdentifier: string;\n  creationTimestampMs: number;\n  lastEditTimestampMs?: number;\n  llm?: string;\n  inputTokens?: number;\n  outputTokens?: number;\n  metadata?: Record<string, any>;\n  tenantId?: string;\n  handedOff?: boolean;\n  handedOffSubThreadId?: string;\n  handedOffToolCallId?: string;\n  /** Structured long-term-memory recall events of the conversation. */\n  recalledMemories?: RecalledMemoryRecord[];\n  /** Audit trail of the core-memory blocks the conversation saw. */\n  coreMemories?: CoreMemorySnapshot[];\n  /** Compaction checkpoints of the conversation, oldest first. */\n  compactions?: CompactionCheckpoint[];\n}\n\n/** One core memory entry (the always-injected tier), as returned by the memory API. */\nexport interface CoreMemoryEntry {\n  id: number;\n  section: string;\n  content: string;\n  source: string;\n  pinned: boolean;\n  supersedes: number | null;\n  archivedAt: string | null;\n  createdAt?: string;\n  updatedAt?: string;\n}\n\n/** Deployment caps of the core memory tier. */\nexport interface CoreMemoryLimits {\n  maxChars: number;\n  maxEntries: number;\n  maxEntryChars: number;\n}\n\n/**\n * Response of GET /api/v1/memory/assistants/:identifier/core — the entries\n * of the bucket the assistant resolves for a tenant/subtenant combination.\n */\nexport interface CoreMemoryList {\n  /** False when the assistant does not have the core memory tier enabled. */\n  enabled: boolean;\n  /** The resolved bucket tuple (tenant/subtenant/owner dimensions). */\n  bucket: { tenantId?: string; subtenantId?: string; entityId?: string };\n  entries: CoreMemoryEntry[];\n  limits?: CoreMemoryLimits;\n}\n\n/**\n * Assistant specialization info\n */\nexport interface AssistantSpecialization {\n  identifier: string;\n  name: string;\n  description: string;\n  state: 'active' | 'inactive' | 'coming_soon';\n  imgUrl?: string;\n  /** Pinned style of the generated avatar shown when there is no imgUrl. */\n  avatarStyle?: AvatarStyle;\n  availableToolsGroups?: Array<{\n    name: string;\n    description?: string;\n    uid?: string;\n    iconUrl?: string;\n    tools?: Array<{\n      name: string;\n      description: string;\n    }>;\n  }>;\n  model?: string;\n  isCustom?: boolean;\n  creationTimestampMs?: number;\n  /**\n   * Whether this assistant offers MCP servers of the tenant's own.\n   *\n   * Same contract as `tenantIntegrations` below, absence included.\n   */\n  tenantMcpServers?: {\n    enabled: boolean;\n    /** Servers listed ready to connect. Says nothing about how many are connected. */\n    count?: number;\n  };\n  /**\n   * Whether this assistant offers connected apps to its tenants.\n   *\n   * **Absent means \"cannot tell\", not \"no\"** — an API older than this field\n   * says nothing, and treating silence as a no would hide the connected-apps\n   * button from anyone whose deployment has not caught up yet.\n   */\n  tenantIntegrations?: {\n    enabled: boolean;\n    /**\n     * How many apps the catalogue offers. An upper bound — the listing drops\n     * any the provider cannot resolve — and enough to size a placeholder.\n     */\n    count?: number;\n  };\n  /**\n   * Whether this assistant accepts messages sent while the conversation is\n   * busy, queueing them instead of refusing them.\n   *\n   * **Absent means no**, unlike `tenantIntegrations` above. Promising a queue\n   * that does not exist is paid for with a 409 and with the user's text left in\n   * the air, so silence is read as the safe answer rather than as the open one.\n   */\n  messageQueueEnabled?: boolean;\n  /** How many messages may wait at once before further sends are refused. */\n  maxQueuedMessages?: number;\n}\n\n/**\n * Summary of a conversation for listing\n */\nexport interface ConversationSummary {\n  chatUID: string;\n  name?: string;\n  creationTimestampMs: number;\n  lastEditTimestampMs?: number;\n}\n\nexport interface ListConversationsResponse {\n  histories: ConversationSummary[];\n  total: number;\n  offset: number;\n  limit: number;\n}\n\n/**\n * API error response\n */\nexport interface ApiError {\n  statusCode: number;\n  message: string;\n  error?: string;\n  /** Optional structured details (e.g. usage-limit blocking info on a 429). */\n  details?: any;\n}\n\n/**\n * Feedback submission request\n */\nexport interface FeedbackSubmission {\n  messageId: string;\n  feedback?: boolean;\n  feedbackComment?: string;\n  feedbackData?: Record<string, any>;\n}\n\n/**\n * Feedback entry response\n */\nexport interface FeedbackEntry {\n  _id: string;\n  requestId: string;\n  chatUID?: string;\n  threadId?: string;\n  agentId?: string;\n  feedback?: boolean;\n  feedbackComment?: string;\n  feedbackData?: Record<string, any>;\n  creationTimestamp: string;\n  lastEditTimestamp?: string;\n}\n\n/**\n * Agent thread states\n */\nexport enum AgentThreadState {\n  QUEUED = 'queued',\n  PROCESSING = 'processing',\n  COMPLETED = 'completed',\n  FAILED = 'failed',\n  TERMINATED = 'terminated',\n  PAUSED = 'paused',\n  PAUSED_FOR_APPROVAL = 'paused_for_approval',\n  APPROVAL_REJECTED = 'approval_rejected',\n  WAITING_FOR_RESPONSE = 'waiting_for_response',\n  PAUSED_FOR_RESUME = 'paused_for_resume',\n  HANDED_OFF = 'handed_off',\n  GUARDRAIL_TRIGGER = 'guardrail_trigger',\n}\n\n/**\n * Task within an agent thread\n */\nexport interface AgentTaskDto {\n  _id?: string;\n  title?: string;\n  description?: string;\n  completed: boolean;\n}\n\n/**\n * Agent thread DTO\n */\nexport interface AgentThreadDto {\n  _id?: string;\n  agentId: string;\n  state: AgentThreadState;\n  threadContent: ChatMessage[];\n  tasks?: AgentTaskDto[];\n  finishReason?: string;\n  pausedReason?: string;\n  name?: string;\n  creationTimestampMs?: number;\n  lastEditTimestampMs?: number;\n  pauseUntil?: number;\n  isSubthread?: boolean;\n  parentThreadId?: string;\n  subThreadToolCallId?: string;\n  parentAgentId?: string;\n}\n\n/**\n * Agent details\n */\nexport interface AgentDto {\n  _id?: string;\n  name: string;\n  description?: string;\n  imgUrl?: string;\n  /** Pinned style of the generated avatar shown when there is no imgUrl. */\n  avatarStyle?: AvatarStyle;\n  agentId?: string;\n}\n\n/**\n * Hand-off tool response content\n */\nexport interface HandOffToolResponse {\n  response: string;\n  subthreadId: string;\n}\n\n/**\n * Represents a single tool call within a tool group\n */\nexport interface ToolGroupCall {\n  name: string;\n  input: any;\n  output: any;\n  toolCallId: string;\n}\n\n/**\n * Configuration for grouping consecutive tool calls under a single renderer\n */\nexport interface ToolGroupConfig {\n  tools: string[];\n  renderer: (calls: ToolGroupCall[]) => React.ReactNode;\n}\n\n/**\n * One of the end user's connected accounts for an app.\n *\n * The provider's own identifiers do not travel here beyond `id`, which the\n * client needs in order to name the account it wants disconnected — and which\n * the server re-checks against the caller's tenant on the way back in.\n */\nexport interface IntegrationAccount {\n  id: string;\n  status: string;\n  connectedAt?: string;\n  updatedAt?: string;\n  /** True when the account exists but can no longer run tools. */\n  needsReconnect?: boolean;\n  statusReason?: string;\n}\n\n/**\n * One value the end user is asked for before an account can be connected —\n * their API key, the subdomain of their instance.\n *\n * Comes from the provider's own catalogue, so the form is rendered from this\n * rather than from anything app-specific: most apps do not authenticate with\n * credentials Devic holds, and there are hundreds of them.\n */\nexport interface IntegrationAuthField {\n  name: string;\n  label: string;\n  type: string;\n  required: boolean;\n  description?: string;\n  /** Prefilled — usually a provider endpoint most accounts should keep. */\n  default?: string;\n  /** Mask it on screen. */\n  secret: boolean;\n}\n\n/**\n * One way of connecting an app.\n *\n * `redirect` schemes send the user to the provider; the rest are connected\n * with the values they type, without ever leaving the page.\n *\n * There is deliberately no field for the *application's* credentials: the\n * OAuth application belongs to the developer who embedded this widget, is\n * registered once for every tenant, and is never the end user's to supply.\n */\nexport interface IntegrationAuthScheme {\n  /** The provider's own name for it: `OAUTH2`, `API_KEY`, … */\n  mode: string;\n  /** Credentials for this scheme are held for you — nothing to fill in. */\n  composioManaged: boolean;\n  redirect: boolean;\n  /** What this account supplies. Empty for a scheme that asks nothing. */\n  accountFields: IntegrationAuthField[];\n  /** The provider's own setup guide, when there is one. */\n  guideUrl?: string;\n}\n\n/**\n * The answer when connecting needs values that were not sent.\n *\n * `stage` decides who can act on it: `account` is the end user, and the form\n * asks them. `app` is the developer's OAuth application, which the end user\n * cannot register — so that case is shown as \"not available yet\" instead of a\n * form asking a stranger for someone else's client secret.\n */\nexport interface IntegrationSetupRequired {\n  code: \"INTEGRATION_SETUP_REQUIRED\";\n  message: string;\n  toolkit: string;\n  authScheme: string;\n  stage: \"app\" | \"account\";\n  fields: IntegrationAuthField[];\n  guideUrl?: string;\n}\n\n/**\n * An app the assistant offers to its tenants, with the accounts THIS tenant\n * has connected. Never another tenant's.\n */\nexport interface Integration {\n  /** App slug, e.g. `gmail`. */\n  app: string;\n  name: string;\n  description?: string;\n  logo?: string;\n  /** True when at least one account is active. */\n  connected: boolean;\n  accounts: IntegrationAccount[];\n  /** Event types the developer allows this tenant to switch on. */\n  availableTriggers?: string[];\n}\n\n// ── MCP servers the end user connects for themselves ──────────────────────\n\nexport type TenantMcpAuthMode = \"oauth\" | \"header\" | \"none\";\n\n/** One of the end user's own MCP connections. */\nexport interface TenantMcpConnection {\n  id: string;\n  /**\n   * What to put in `disabledIntegrations` to have this server sit a message\n   * out. Sent by the API so the prefix that separates it from an app slug lives\n   * on the server, in one place.\n   */\n  toggleId?: string;\n  name?: string;\n  url: string;\n  /** The developer's template this came from, when it came from one. */\n  templateId?: string;\n  authMode?: TenantMcpAuthMode;\n  status: \"pending_auth\" | \"active\" | \"error\";\n  toolCount?: number;\n  tools?: string[];\n  lastProbeStatus?: string;\n  lastProbeError?: string;\n  lastProbeTimestampMs?: number;\n  /** Connected for the whole tenant, so every end user of it shares this. */\n  shared: boolean;\n  /** True when this end user may use it but not change or remove it. */\n  readOnly: boolean;\n}\n\n/**\n * One row of the MCP panel: either a server the developer offers ready to\n * connect, or one this end user added.\n *\n * A single list rather than two, because that is what the panel draws — keeping\n * \"offered\" and \"connected\" apart would leave them out of step for a moment\n * after every connect.\n */\nexport interface TenantMcpServer {\n  source: \"template\" | \"custom\";\n  templateId?: string;\n  name: string;\n  url: string;\n  description?: string;\n  logoUrl?: string;\n  authMode?: TenantMcpAuthMode;\n  /** Header the credential travels in, for `header` servers. */\n  headerName?: string;\n  /** Whether the end user may supply their own OAuth application. */\n  allowClientCredentials?: boolean;\n  /** Null until this tenant connects it. */\n  connection: TenantMcpConnection | null;\n}\n\nexport interface TenantMcpListing {\n  offered: boolean;\n  /** Whether adding a server of one's own is permitted. */\n  allowCustom: boolean;\n  limits: { maxServers: number; maxToolsPerServer: number; used: number };\n  servers: TenantMcpServer[];\n}\n\n/** Credentials the end user supplies when connecting a server. */\nexport interface TenantMcpAuthInput {\n  mode?: TenantMcpAuthMode;\n  headerName?: string;\n  headerValue?: string;\n  upstreamOAuth?: { clientId?: string; clientSecret?: string; scopes?: string[] };\n}\n\n/**\n * What connecting answers with.\n *\n * `status: \"active\"` means it is done. `authorizationUrl` must be opened in a\n * popup. `requiresClientCredentials` means the server has no dynamic client\n * registration and the end user has to register an OAuth application with it\n * themselves, authorising `callbackUrl` as the redirect URI.\n */\nexport interface TenantMcpConnectResult {\n  id: string;\n  status: \"pending_auth\" | \"active\" | \"error\";\n  toolCount?: number;\n  authorizationUrl?: string;\n  requiresClientCredentials?: boolean;\n  callbackUrl?: string;\n  error?: string;\n}\n"],"names":["AgentThreadState"],"mappings":";;AAsCA;AACM,SAAU,oBAAoB,CAAC,IAAiB,EAAA;IAKpD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE;QACvC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,IAAI,OAAO;KAC5C;AACH;AA2tBA;;AAEG;AACSA;AAAZ,CAAA,UAAY,gBAAgB,EAAA;AAC1B,IAAA,gBAAA,CAAA,QAAA,CAAA,GAAA,QAAiB;AACjB,IAAA,gBAAA,CAAA,YAAA,CAAA,GAAA,YAAyB;AACzB,IAAA,gBAAA,CAAA,WAAA,CAAA,GAAA,WAAuB;AACvB,IAAA,gBAAA,CAAA,QAAA,CAAA,GAAA,QAAiB;AACjB,IAAA,gBAAA,CAAA,YAAA,CAAA,GAAA,YAAyB;AACzB,IAAA,gBAAA,CAAA,QAAA,CAAA,GAAA,QAAiB;AACjB,IAAA,gBAAA,CAAA,qBAAA,CAAA,GAAA,qBAA2C;AAC3C,IAAA,gBAAA,CAAA,mBAAA,CAAA,GAAA,mBAAuC;AACvC,IAAA,gBAAA,CAAA,sBAAA,CAAA,GAAA,sBAA6C;AAC7C,IAAA,gBAAA,CAAA,mBAAA,CAAA,GAAA,mBAAuC;AACvC,IAAA,gBAAA,CAAA,YAAA,CAAA,GAAA,YAAyB;AACzB,IAAA,gBAAA,CAAA,mBAAA,CAAA,GAAA,mBAAuC;AACzC,CAAC,EAbWA,wBAAgB,KAAhBA,wBAAgB,GAAA,EAAA,CAAA,CAAA;;"}
+{"version":3,"file":"types.js","sources":["../../../../src/api/types.ts"],"sourcesContent":["import type { AvatarStyle } from '../utils/avatar';\n\nimport type React from 'react';\n\n/**\n * File attachment for messages\n */\nexport interface ChatFile {\n  name: string;\n  downloadUrl?: string;\n  fileType?: 'image' | 'document' | 'audio' | 'video' | 'other';\n}\n\n/**\n * Attachment as it appears on a message.\n *\n * Two shapes reach the UI for the same thing: the optimistic message built\n * locally on send uses `url`/`type`, while the history returned by the API\n * carries the stored `downloadUrl`/`fileType`. Both are accepted here; use\n * `normalizeMessageFile` before reading them.\n */\nexport interface MessageFile {\n  name: string;\n  url?: string;\n  type?: string;\n  downloadUrl?: string;\n  fileType?: string;\n}\n\n/**\n * Message content structure\n */\nexport interface MessageContent {\n  /**\n   * The message text.\n   *\n   * Declared as a string because that is what it is for every role a reader\n   * cares about, but do not trust it blindly on a `guard_rail` message:\n   * conversations stopped by a guardrail before the backend fix carry the raw\n   * provider result object here instead. Guard a `typeof x === 'string'` check\n   * around anything that treats it as text.\n   */\n  message?: string;\n  data?: any;\n  files?: MessageFile[];\n}\n\n/** Collapse either attachment shape into a single one the UI can render. */\nexport function normalizeMessageFile(file: MessageFile): {\n  name: string;\n  url: string;\n  type: string;\n} {\n  return {\n    name: file.name,\n    url: file.url || file.downloadUrl || '',\n    type: file.type || file.fileType || 'other',\n  };\n}\n\n/**\n * Tool call from the model\n */\nexport interface ToolCall {\n  id: string;\n  type: 'function';\n  function: {\n    name: string;\n    arguments: string;\n  };\n}\n\n/**\n * Chat message structure\n */\nexport interface ChatMessage {\n  uid: string;\n  role: 'user' | 'assistant' | 'developer' | 'system' | 'tool' | 'guard_rail';\n  content: MessageContent;\n  timestamp: number;\n  chatUid?: string;\n  tool_calls?: ToolCall[];\n  tool_call_id?: string;\n  summary?: string;\n  /**\n   * Where `content.message` came from, when the model did not write it.\n   * `'finish_tool'`: the assistant is configured to require a tool call to\n   * finish (\"Require Tool Use to Finish\") and the backend lifted the reply from\n   * the finish tool's `message` argument, so it can be read without parsing\n   * tool calls. Absent on replies the model wrote itself — use it to label the\n   * bubble as produced by the tool.\n   */\n  contentSource?: string;\n  /**\n   * Id of a speech-to-text transcript (from POST /api/v1/whisper) that seeded\n   * this message. Present on user messages dictated by voice; the chat can use\n   * it to fetch the source audio (GET /api/v1/whisper/:transcriptId) and offer\n   * playback.\n   */\n  transcriptId?: string;\n  /**\n   * Original server uid, present when the UI adopted an optimistic uid for\n   * this message to keep React keys stable. Server-side references (e.g.\n   * memory recall anchors) match against it.\n   */\n  serverUid?: string;\n  /**\n   * Client-side only: the conversation was busy when this message was sent, so\n   * it was accepted into the queue and is waiting its turn. Drawn as a message\n   * that has not landed rather than as part of the conversation. Falls away on\n   * its own once the message comes back inside the history.\n   */\n  queued?: boolean;\n  /**\n   * Client-side only: when this message was accepted into the queue. Used to\n   * tell \"the server has not reported it yet\" from \"the server no longer has\n   * it\", which the timestamp is the only honest way to decide.\n   */\n  queuedAt?: number;\n}\n\n/**\n * Previous conversation message for initialization\n */\nexport interface PreviousMessage {\n  message: string;\n  role: 'user' | 'assistant';\n}\n\n/**\n * Model interface tool schema following OpenAI function calling format\n */\nexport interface ModelInterfaceToolSchema {\n  type: 'function';\n  function: {\n    name: string;\n    description: string;\n    parameters: {\n      type: 'object';\n      properties: Record<string, any>;\n      required?: string[];\n    };\n  };\n}\n\n/**\n * Props passed to a response widget component.\n * The widget is responsible for collecting the user's response and\n * calling `submit` with the payload to resolve the tool call.\n */\nexport interface ResponseWidgetProps {\n  /** The tool call this widget is responding to */\n  toolCall: ToolCall;\n  /** Parsed arguments from the tool call */\n  params: any;\n  /** Submit the tool response payload (sent as the tool call result to the model) */\n  submit: (response: any) => void;\n  /** Cancel the tool call. Sends an error response so the model can continue. */\n  cancel?: (reason?: string) => void;\n  /** Whether the widget is currently submitting */\n  isSubmitting?: boolean;\n}\n\n/**\n * Interactive response widget configuration for a client-side tool.\n *\n * When the model calls a tool configured with a `responseWidget`, the\n * widget is rendered in the chat UI instead of executing a callback.\n * The user interacts with the widget, which calls `submit(response)` to\n * define the tool response sent back to the model.\n *\n * - `render: 'inline'` renders the widget in the message thread at the\n *   position of the tool call. The text input remains enabled.\n * - `render: 'input'` replaces the chat input area with the widget\n *   while it is pending. The text input is disabled until submission.\n */\nexport interface ResponseWidgetConfig {\n  /** Where to render the widget */\n  render: 'inline' | 'input';\n  /** The widget component */\n  component: React.ComponentType<ResponseWidgetProps>;\n}\n\n/**\n * Model interface tool definition for client-side tools.\n *\n * A tool must provide either a `callback` (executed automatically when\n * the model invokes the tool) or a `responseWidget` (renders UI for\n * the user to produce the tool response). Providing both is an error.\n */\nexport interface ModelInterfaceTool {\n  toolName: string;\n  schema: ModelInterfaceToolSchema;\n  /** Executed automatically when the model calls this tool */\n  callback?: (params: any) => Promise<any> | any;\n  /** Interactive widget that collects the user's tool response */\n  responseWidget?: ResponseWidgetConfig;\n}\n\n/**\n * Tool call response to send back to the API\n */\nexport interface ToolCallResponse {\n  tool_call_id: string;\n  content: any;\n  role: 'tool';\n  /**\n   * The client-side tools still on offer for the rest of the turn. The API\n   * reads them off the first response of the batch: leaving them out drops\n   * the tools from the continuation, so the model cannot call them again.\n   */\n  tools?: ModelInterfaceToolSchema[];\n}\n\n/**\n * DTO for sending messages to the assistant\n */\nexport interface ProcessMessageDto {\n  message: string;\n  chatUid?: string;\n  userName?: string;\n  files?: ChatFile[];\n  /** Tags to associate with this chat (top-level, distinct from `metadata`). */\n  tags?: string[];\n  metadata?: {\n    promptTemplateParams?: Record<string, any>;\n    tenantToken?: string;\n    [key: string]: any;\n  };\n  tenantId?: string;\n  previousConversation?: PreviousMessage[];\n  enabledTools?: string[];\n  provider?: string;\n  model?: string;\n  // Model interface protocol fields\n  tools?: ModelInterfaceToolSchema[];\n  applicationState?: Record<string, any>;\n  skipSummarization?: boolean;\n  /**\n   * Id of a speech-to-text transcript (from POST /api/v1/whisper) that seeded\n   * this message. Sent so the conversation keeps a link to the original audio.\n   */\n  transcriptId?: string;\n}\n\n/**\n * Response from the /whisper speech-to-text endpoint.\n */\nexport interface WhisperTranscriptionResponse {\n  /** Public id of the transcript; send it back as ProcessMessageDto.transcriptId. */\n  transcriptId: string;\n  /** Transcribed text. */\n  text: string;\n  /** Language hint used, if any. */\n  language?: string;\n  /** Download URL of the source audio. */\n  audioUrl?: string;\n  /** Transcription model used. */\n  model?: string;\n}\n\n/**\n * Response from the assistant\n */\nexport interface AssistantResponse {\n  messages: ChatMessage[];\n  chatUid: string;\n  inputTokens?: number;\n  outputTokens?: number;\n}\n\n/**\n * Async mode response\n */\nexport interface AsyncResponse {\n  chatUid: string;\n  message?: string;\n  error?: string;\n  /**\n   * The conversation could not take the message right now, so it was queued\n   * instead of starting a run of its own. Still an acceptance: the answer comes\n   * later, and may cover several messages at once.\n   */\n  queued?: boolean;\n  /** How many messages are queued on this conversation, this one included. */\n  queuePosition?: number;\n  /** When the queued message reaches the model. */\n  willProcess?: QueueDisposition;\n}\n\n/**\n * When a queued message will reach the model.\n *\n * `after_delay` is the one that is not about being busy: an idle conversation\n * on an assistant with an input delay collects what is written during the\n * window, so a message can come back queued with nothing in flight at all.\n */\nexport type QueueDisposition = 'after_delay' | 'next_turn' | 'on_resume';\n\n/** Response of the stop endpoint. */\nexport interface StopChatResponse {\n  chatUid: string;\n  message: string;\n  /**\n   * Queued messages the stop threw away — answering them would be the opposite\n   * of what was asked. Handed back so their text can be put where the user\n   * wrote it. Absent on an API older than this, and when nothing was queued.\n   */\n  discardedMessages?: ChatMessage[];\n}\n\n/**\n * Real-time chat history status.\n * `limit_exceeded` means the message was blocked before reaching the LLM\n * because a configured tenant/subtenant usage limit was reached.\n */\nexport type RealtimeStatus =\n  | 'processing'\n  | 'completed'\n  | 'error'\n  | 'waiting_for_tool_response'\n  | 'handed_off'\n  | 'limit_exceeded'\n  /** Collecting messages during the assistant's input delay, before any run. */\n  | 'buffering';\n\n/**\n * Details of a tenant/subtenant usage limit that blocked a message.\n * Returned on the realtime endpoint when status is `limit_exceeded`, and on\n * the HTTP 429 body (`details`) when a synchronous request is blocked.\n */\nexport interface TenantLimitExceeded {\n  /** Human-readable message describing the block. */\n  message?: string;\n  /** The rule that triggered the block (scope, metric, window, limit…). */\n  blockingRule?: {\n    scope?: 'tenant' | 'subtenant';\n    subtenantId?: string;\n    metric?: 'tokens' | 'cost';\n    windowUnit?: 'hour' | 'day' | 'week' | 'month';\n    windowEvery?: number;\n    limit?: number;\n  };\n  /** Current consumption in the blocking window. */\n  current?: number;\n  /** The limit that was reached. */\n  limit?: number;\n  /** Epoch ms when the blocking window resets and usage is allowed again. */\n  resetsAt?: number;\n}\n\n/** One fact a long-term-memory recall surfaced. */\nexport interface RecalledMemoryFact {\n  fact: string;\n  relation: string;\n  /** Source entity name of the graph edge, when the fact connects two. */\n  source: string | null;\n  /** Target entity name of the graph edge, when the fact connects two. */\n  target: string | null;\n  /** ISO date the fact became valid, if known. */\n  validAt: string | null;\n}\n\n/** One graph entity a long-term-memory recall surfaced. */\nexport interface RecalledMemoryEntity {\n  id: string;\n  name: string;\n  type: string;\n  summary: string | null;\n}\n\n/** One previous-session turn a conversation-start recall carried over. */\nexport interface RecalledMemoryTurn {\n  role: string;\n  content: string;\n}\n\n/**\n * One structured long-term-memory recall event of a conversation: the facts,\n * entities and previous-session turns a recall surfaced, plus the uid of the\n * message that brought it in (`messageUid`: the initial user message, or the\n * assistant message carrying the memory tool call — resolvable through\n * `toolCallId` while the run is still in flight).\n */\nexport interface RecalledMemoryRecord {\n  uid: string;\n  messageUid?: string;\n  toolCallId?: string;\n  source:\n    | 'conversation_start'\n    | 'search_memory'\n    | 'search_memory_nodes'\n    | 'explore_memory_graph';\n  query?: string;\n  facts?: RecalledMemoryFact[];\n  entities?: RecalledMemoryEntity[];\n  turns?: RecalledMemoryTurn[];\n  timestampMs: number;\n}\n\n/**\n * Snapshot of the core-memory block a conversation saw (audit trail): the\n * render revision plus the injected entries as structured items.\n */\nexport interface CoreMemorySnapshot {\n  uid: string;\n  revision: string;\n  items: Array<{\n    id: number;\n    section: string;\n    content: string;\n    pinned: boolean;\n    source: string;\n  }>;\n  entries: number;\n  omitted: number;\n  chars: number;\n  timestampMs: number;\n}\n\n/**\n * Real-time chat history response\n */\nexport interface RealtimeChatHistory {\n  chatUID: string;\n  clientUID: string;\n  chatHistory: ChatMessage[];\n  status: RealtimeStatus;\n  lastUpdatedAt: number;\n  pendingToolCalls?: ToolCall[];\n  handedOffSubThreadId?: string;\n  /** Present only when status is `limit_exceeded`. */\n  limitExceeded?: TenantLimitExceeded;\n  /**\n   * Memory-recall events of the in-flight run — lets the UI show what the\n   * assistant is recalling while the response is still processing.\n   */\n  recalledMemories?: RecalledMemoryRecord[];\n  /**\n   * Messages accepted into this conversation that the model has not seen yet.\n   * Non-zero means more is coming: a `completed` status with messages still\n   * queued is not the end of the exchange.\n   */\n  queuedMessages?: number;\n  /**\n   * The queued messages themselves. This is the conversation's queue, not the\n   * caller's — it can include messages the same conversation received through\n   * another channel. Absent on an API that does not return them, in which case\n   * the widget falls back to its own optimistic copies.\n   */\n  pendingUserMessages?: ChatMessage[];\n  /**\n   * Compaction checkpoints of the in-flight run. A conversation that compacts\n   * mid-run stops sending the messages above the cut immediately, so these\n   * arrive here before they are persisted on the conversation.\n   */\n  compactions?: CompactionCheckpoint[];\n  /** The compaction running right now, if any. */\n  compaction?: CompactionActivity;\n}\n\n/**\n * A single usage rule with its current consumption (from GET\n * /api/v1/tenant-usage/:tenantId[/subtenants/:subtenantId]).\n */\nexport interface TenantUsageRule {\n  scope: 'tenant' | 'subtenant';\n  subtenantId?: string;\n  metric: 'tokens' | 'cost';\n  windowUnit: 'hour' | 'day' | 'week' | 'month';\n  windowEvery: number;\n  /** Configured limit for the window. */\n  limit: number;\n  /** Current consumption in the active window. */\n  current: number;\n  /** Utilization percentage (0..100, capped). */\n  percent: number;\n  /** Epoch ms when the active window resets. */\n  resetsAt?: number;\n  /** Where the rule comes from ('tier' | 'adhoc'). */\n  origin?: string;\n  /** Tier the rule belongs to, if any. */\n  tierId?: string;\n}\n\n/**\n * Response of GET /api/v1/tenant-usage/:tenantId[/subtenants/:subtenantId]:\n * the effective usage rules with their current consumption + the active tier.\n */\nexport interface TenantUsage {\n  tenantId: string;\n  subtenantId?: string;\n  tierId?: string;\n  usage: TenantUsageRule[];\n}\n\n/**\n * A durable per-window usage history row (from GET\n * /api/v1/tenant-usage/:tenantId/history).\n */\nexport interface TenantUsageHistoryRow {\n  clientUID: string;\n  tenantId: string;\n  subtenantId: string;\n  scope: 'tenant' | 'subtenant';\n  metric: 'tokens' | 'cost';\n  windowUnit: 'hour' | 'day' | 'week' | 'month';\n  windowEvery: number;\n  windowKey: string;\n  windowStart: number;\n  windowEnd: number;\n  /** Counted consumption (enforced). */\n  consumption: number;\n  /** Exempt consumption that did not count toward the limit, if any. */\n  exemptConsumption?: number;\n  limit: number;\n  percent: number;\n  tierId?: string;\n  origin?: string;\n  capturedAt: number;\n}\n\n/**\n * Options for querying tenant usage history.\n */\nexport interface TenantUsageHistoryQuery {\n  subtenantId?: string;\n  scope?: 'tenant' | 'subtenant';\n  metric?: 'tokens' | 'cost';\n  windowUnit?: 'hour' | 'day' | 'week' | 'month';\n  /** Epoch ms lower bound (windowEnd >= from). */\n  from?: number;\n  /** Epoch ms upper bound (windowEnd <= to). */\n  to?: number;\n  limit?: number;\n  skip?: number;\n}\n\n/**\n * Chat history structure\n */\n/** A concrete value carried verbatim through a compaction. */\nexport interface CompactionFact {\n  kind: string;\n  value: string;\n  label?: string;\n}\n\n/** The structured body a compaction produced. */\nexport interface CompactionSummary {\n  goal?: string;\n  constraints?: string[];\n  inProgress?: string;\n  pending?: string[];\n  decisions?: string[];\n  data?: Array<{ label: string; value: string }>;\n  done?: string[];\n  openQuestions?: string[];\n  /** Fallback when the model answered without structure. */\n  raw?: string;\n}\n\n/**\n * One compaction of a conversation: the messages before its boundary folded\n * into a written summary plus the identifiers, paths and urls lifted out of\n * them verbatim. From then on the model receives the checkpoint instead of\n * those messages — which are still in the conversation, and still shown.\n *\n * Only the newest checkpoint is in force: each compaction merges the previous\n * summary into itself.\n */\nexport interface CompactionCheckpoint {\n  uid: string;\n  /** 1 for the first compaction of the conversation, 2 for the next… */\n  index: number;\n  timestampMs: number;\n  trigger: 'auto' | 'manual';\n  /** First message that still travels verbatim. */\n  firstKeptMessageUid?: string;\n  /** Last folded message: where the widget belongs in the conversation. */\n  anchorMessageUid?: string;\n  compactedMessageCount: number;\n  summary: CompactionSummary;\n  facts: CompactionFact[];\n  tokensBefore: number;\n  tokensAfter: number;\n  provider?: string;\n  model?: string;\n  cost?: number;\n}\n\n/**\n * A compaction happening right now, from the realtime endpoint.\n *\n * A compaction is a model call of its own, taken between two assistant\n * messages, so a client that only knows `processing` shows a conversation\n * that appears to have stalled for a few seconds. Present while it runs and\n * on the single update that reports it finished.\n */\nexport interface CompactionActivity {\n  state: 'running' | 'completed';\n  startedAt: number;\n  /**\n   * What this pass is folding: the messages new since the last checkpoint.\n   * Not the conversation's totals — a checkpoint's own\n   * `compactedMessageCount` and `tokensBefore` are cumulative across every\n   * compaction, so the two are on different scales and must not be paired.\n   */\n  messageCount: number;\n  tokensBefore: number;\n  /** Which checkpoint the pass produced, once it is done. */\n  index?: number;\n  finishedAt?: number;\n}\n\nexport interface ChatHistory {\n  chatUID: string;\n  clientUID: string;\n  userUID: string;\n  chatContent: ChatMessage[];\n  name?: string;\n  assistantSpecializationIdentifier: string;\n  creationTimestampMs: number;\n  lastEditTimestampMs?: number;\n  llm?: string;\n  inputTokens?: number;\n  outputTokens?: number;\n  metadata?: Record<string, any>;\n  tenantId?: string;\n  handedOff?: boolean;\n  handedOffSubThreadId?: string;\n  handedOffToolCallId?: string;\n  /** Structured long-term-memory recall events of the conversation. */\n  recalledMemories?: RecalledMemoryRecord[];\n  /** Audit trail of the core-memory blocks the conversation saw. */\n  coreMemories?: CoreMemorySnapshot[];\n  /** Compaction checkpoints of the conversation, oldest first. */\n  compactions?: CompactionCheckpoint[];\n}\n\n/** One core memory entry (the always-injected tier), as returned by the memory API. */\nexport interface CoreMemoryEntry {\n  id: number;\n  section: string;\n  content: string;\n  source: string;\n  pinned: boolean;\n  supersedes: number | null;\n  archivedAt: string | null;\n  createdAt?: string;\n  updatedAt?: string;\n}\n\n/** Deployment caps of the core memory tier. */\nexport interface CoreMemoryLimits {\n  maxChars: number;\n  maxEntries: number;\n  maxEntryChars: number;\n}\n\n/**\n * Response of GET /api/v1/memory/assistants/:identifier/core — the entries\n * of the bucket the assistant resolves for a tenant/subtenant combination.\n */\nexport interface CoreMemoryList {\n  /** False when the assistant does not have the core memory tier enabled. */\n  enabled: boolean;\n  /** The resolved bucket tuple (tenant/subtenant/owner dimensions). */\n  bucket: { tenantId?: string; subtenantId?: string; entityId?: string };\n  entries: CoreMemoryEntry[];\n  limits?: CoreMemoryLimits;\n}\n\n/**\n * Assistant specialization info\n */\nexport interface AssistantSpecialization {\n  identifier: string;\n  name: string;\n  description: string;\n  state: 'active' | 'inactive' | 'coming_soon';\n  imgUrl?: string;\n  /** Pinned style of the generated avatar shown when there is no imgUrl. */\n  avatarStyle?: AvatarStyle;\n  availableToolsGroups?: Array<{\n    name: string;\n    description?: string;\n    uid?: string;\n    iconUrl?: string;\n    tools?: Array<{\n      name: string;\n      description: string;\n    }>;\n  }>;\n  model?: string;\n  isCustom?: boolean;\n  creationTimestampMs?: number;\n  /**\n   * Whether this assistant offers MCP servers of the tenant's own.\n   *\n   * Same contract as `tenantIntegrations` below, absence included.\n   */\n  tenantMcpServers?: {\n    enabled: boolean;\n    /** Servers listed ready to connect. Says nothing about how many are connected. */\n    count?: number;\n  };\n  /**\n   * Whether this assistant offers connected apps to its tenants.\n   *\n   * **Absent means \"cannot tell\", not \"no\"** — an API older than this field\n   * says nothing, and treating silence as a no would hide the connected-apps\n   * button from anyone whose deployment has not caught up yet.\n   */\n  tenantIntegrations?: {\n    enabled: boolean;\n    /**\n     * How many apps the catalogue offers. An upper bound — the listing drops\n     * any the provider cannot resolve — and enough to size a placeholder.\n     */\n    count?: number;\n  };\n  /**\n   * Whether this assistant accepts messages sent while the conversation is\n   * busy, queueing them instead of refusing them.\n   *\n   * **Absent means no**, unlike `tenantIntegrations` above. Promising a queue\n   * that does not exist is paid for with a 409 and with the user's text left in\n   * the air, so silence is read as the safe answer rather than as the open one.\n   */\n  messageQueueEnabled?: boolean;\n  /** How many messages may wait at once before further sends are refused. */\n  maxQueuedMessages?: number;\n}\n\n/**\n * Summary of a conversation for listing\n */\nexport interface ConversationSummary {\n  chatUID: string;\n  name?: string;\n  creationTimestampMs: number;\n  lastEditTimestampMs?: number;\n}\n\nexport interface ListConversationsResponse {\n  histories: ConversationSummary[];\n  total: number;\n  offset: number;\n  limit: number;\n}\n\n/**\n * API error response\n */\nexport interface ApiError {\n  statusCode: number;\n  message: string;\n  error?: string;\n  /** Optional structured details (e.g. usage-limit blocking info on a 429). */\n  details?: any;\n}\n\n/**\n * Feedback submission request\n */\nexport interface FeedbackSubmission {\n  messageId: string;\n  feedback?: boolean;\n  feedbackComment?: string;\n  feedbackData?: Record<string, any>;\n}\n\n/**\n * Feedback entry response\n */\nexport interface FeedbackEntry {\n  _id: string;\n  requestId: string;\n  chatUID?: string;\n  threadId?: string;\n  agentId?: string;\n  feedback?: boolean;\n  feedbackComment?: string;\n  feedbackData?: Record<string, any>;\n  creationTimestamp: string;\n  lastEditTimestamp?: string;\n}\n\n/**\n * Agent thread states\n */\nexport enum AgentThreadState {\n  QUEUED = 'queued',\n  PROCESSING = 'processing',\n  COMPLETED = 'completed',\n  FAILED = 'failed',\n  TERMINATED = 'terminated',\n  PAUSED = 'paused',\n  PAUSED_FOR_APPROVAL = 'paused_for_approval',\n  APPROVAL_REJECTED = 'approval_rejected',\n  WAITING_FOR_RESPONSE = 'waiting_for_response',\n  PAUSED_FOR_RESUME = 'paused_for_resume',\n  HANDED_OFF = 'handed_off',\n  GUARDRAIL_TRIGGER = 'guardrail_trigger',\n}\n\n/**\n * Task within an agent thread\n */\nexport interface AgentTaskDto {\n  _id?: string;\n  title?: string;\n  description?: string;\n  completed: boolean;\n}\n\n/**\n * Agent thread DTO\n */\nexport interface AgentThreadDto {\n  _id?: string;\n  agentId: string;\n  state: AgentThreadState;\n  threadContent: ChatMessage[];\n  tasks?: AgentTaskDto[];\n  finishReason?: string;\n  pausedReason?: string;\n  name?: string;\n  creationTimestampMs?: number;\n  lastEditTimestampMs?: number;\n  pauseUntil?: number;\n  isSubthread?: boolean;\n  parentThreadId?: string;\n  subThreadToolCallId?: string;\n  parentAgentId?: string;\n}\n\n/**\n * Agent details\n */\nexport interface AgentDto {\n  _id?: string;\n  name: string;\n  description?: string;\n  imgUrl?: string;\n  /** Pinned style of the generated avatar shown when there is no imgUrl. */\n  avatarStyle?: AvatarStyle;\n  agentId?: string;\n}\n\n/**\n * Hand-off tool response content\n */\nexport interface HandOffToolResponse {\n  response: string;\n  subthreadId: string;\n}\n\n/**\n * Represents a single tool call within a tool group\n */\nexport interface ToolGroupCall {\n  name: string;\n  input: any;\n  output: any;\n  toolCallId: string;\n}\n\n/**\n * Configuration for grouping consecutive tool calls under a single renderer\n */\nexport interface ToolGroupConfig {\n  tools: string[];\n  renderer: (calls: ToolGroupCall[]) => React.ReactNode;\n}\n\n/**\n * One of the end user's connected accounts for an app.\n *\n * The provider's own identifiers do not travel here beyond `id`, which the\n * client needs in order to name the account it wants disconnected — and which\n * the server re-checks against the caller's tenant on the way back in.\n */\nexport interface IntegrationAccount {\n  id: string;\n  status: string;\n  connectedAt?: string;\n  updatedAt?: string;\n  /** True when the account exists but can no longer run tools. */\n  needsReconnect?: boolean;\n  statusReason?: string;\n}\n\n/**\n * One value the end user is asked for before an account can be connected —\n * their API key, the subdomain of their instance.\n *\n * Comes from the provider's own catalogue, so the form is rendered from this\n * rather than from anything app-specific: most apps do not authenticate with\n * credentials Devic holds, and there are hundreds of them.\n */\nexport interface IntegrationAuthField {\n  name: string;\n  label: string;\n  type: string;\n  required: boolean;\n  description?: string;\n  /** Prefilled — usually a provider endpoint most accounts should keep. */\n  default?: string;\n  /** Mask it on screen. */\n  secret: boolean;\n}\n\n/**\n * One way of connecting an app.\n *\n * `redirect` schemes send the user to the provider; the rest are connected\n * with the values they type, without ever leaving the page.\n *\n * There is deliberately no field for the *application's* credentials: the\n * OAuth application belongs to the developer who embedded this widget, is\n * registered once for every tenant, and is never the end user's to supply.\n */\nexport interface IntegrationAuthScheme {\n  /** The provider's own name for it: `OAUTH2`, `API_KEY`, … */\n  mode: string;\n  /** Credentials for this scheme are held for you — nothing to fill in. */\n  composioManaged: boolean;\n  redirect: boolean;\n  /** What this account supplies. Empty for a scheme that asks nothing. */\n  accountFields: IntegrationAuthField[];\n  /** The provider's own setup guide, when there is one. */\n  guideUrl?: string;\n}\n\n/**\n * The answer when connecting needs values that were not sent.\n *\n * `stage` decides who can act on it: `account` is the end user, and the form\n * asks them. `app` is the developer's OAuth application, which the end user\n * cannot register — so that case is shown as \"not available yet\" instead of a\n * form asking a stranger for someone else's client secret.\n */\nexport interface IntegrationSetupRequired {\n  code: \"INTEGRATION_SETUP_REQUIRED\";\n  message: string;\n  toolkit: string;\n  authScheme: string;\n  stage: \"app\" | \"account\";\n  fields: IntegrationAuthField[];\n  guideUrl?: string;\n}\n\n/**\n * An app the assistant offers to its tenants, with the accounts THIS tenant\n * has connected. Never another tenant's.\n */\nexport interface Integration {\n  /** App slug, e.g. `gmail`. */\n  app: string;\n  name: string;\n  description?: string;\n  logo?: string;\n  /** True when at least one account is active. */\n  connected: boolean;\n  accounts: IntegrationAccount[];\n  /** Event types the developer allows this tenant to switch on. */\n  availableTriggers?: string[];\n}\n\n// ── MCP servers the end user connects for themselves ──────────────────────\n\nexport type TenantMcpAuthMode = \"oauth\" | \"header\" | \"none\";\n\n/** One of the end user's own MCP connections. */\nexport interface TenantMcpConnection {\n  id: string;\n  /**\n   * What to put in `disabledIntegrations` to have this server sit a message\n   * out. Sent by the API so the prefix that separates it from an app slug lives\n   * on the server, in one place.\n   */\n  toggleId?: string;\n  name?: string;\n  url: string;\n  /** The developer's template this came from, when it came from one. */\n  templateId?: string;\n  authMode?: TenantMcpAuthMode;\n  status: \"pending_auth\" | \"active\" | \"error\";\n  toolCount?: number;\n  tools?: string[];\n  lastProbeStatus?: string;\n  lastProbeError?: string;\n  lastProbeTimestampMs?: number;\n  /** Connected for the whole tenant, so every end user of it shares this. */\n  shared: boolean;\n  /** True when this end user may use it but not change or remove it. */\n  readOnly: boolean;\n}\n\n/**\n * One row of the MCP panel: either a server the developer offers ready to\n * connect, or one this end user added.\n *\n * A single list rather than two, because that is what the panel draws — keeping\n * \"offered\" and \"connected\" apart would leave them out of step for a moment\n * after every connect.\n */\nexport interface TenantMcpServer {\n  source: \"template\" | \"custom\";\n  templateId?: string;\n  name: string;\n  url: string;\n  description?: string;\n  logoUrl?: string;\n  authMode?: TenantMcpAuthMode;\n  /** Header the credential travels in, for `header` servers. */\n  headerName?: string;\n  /** Whether the end user may supply their own OAuth application. */\n  allowClientCredentials?: boolean;\n  /** Null until this tenant connects it. */\n  connection: TenantMcpConnection | null;\n}\n\nexport interface TenantMcpListing {\n  offered: boolean;\n  /** Whether adding a server of one's own is permitted. */\n  allowCustom: boolean;\n  limits: { maxServers: number; maxToolsPerServer: number; used: number };\n  servers: TenantMcpServer[];\n}\n\n/** Credentials the end user supplies when connecting a server. */\nexport interface TenantMcpAuthInput {\n  mode?: TenantMcpAuthMode;\n  headerName?: string;\n  headerValue?: string;\n  upstreamOAuth?: { clientId?: string; clientSecret?: string; scopes?: string[] };\n}\n\n/**\n * What connecting answers with.\n *\n * `status: \"active\"` means it is done. `authorizationUrl` must be opened in a\n * popup. `requiresClientCredentials` means the server has no dynamic client\n * registration and the end user has to register an OAuth application with it\n * themselves, authorising `callbackUrl` as the redirect URI.\n */\nexport interface TenantMcpConnectResult {\n  id: string;\n  status: \"pending_auth\" | \"active\" | \"error\";\n  toolCount?: number;\n  authorizationUrl?: string;\n  requiresClientCredentials?: boolean;\n  callbackUrl?: string;\n  error?: string;\n}\n"],"names":["AgentThreadState"],"mappings":";;AA+CA;AACM,SAAU,oBAAoB,CAAC,IAAiB,EAAA;IAKpD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,WAAW,IAAI,EAAE;QACvC,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,IAAI,OAAO;KAC5C;AACH;AA2tBA;;AAEG;AACSA;AAAZ,CAAA,UAAY,gBAAgB,EAAA;AAC1B,IAAA,gBAAA,CAAA,QAAA,CAAA,GAAA,QAAiB;AACjB,IAAA,gBAAA,CAAA,YAAA,CAAA,GAAA,YAAyB;AACzB,IAAA,gBAAA,CAAA,WAAA,CAAA,GAAA,WAAuB;AACvB,IAAA,gBAAA,CAAA,QAAA,CAAA,GAAA,QAAiB;AACjB,IAAA,gBAAA,CAAA,YAAA,CAAA,GAAA,YAAyB;AACzB,IAAA,gBAAA,CAAA,QAAA,CAAA,GAAA,QAAiB;AACjB,IAAA,gBAAA,CAAA,qBAAA,CAAA,GAAA,qBAA2C;AAC3C,IAAA,gBAAA,CAAA,mBAAA,CAAA,GAAA,mBAAuC;AACvC,IAAA,gBAAA,CAAA,sBAAA,CAAA,GAAA,sBAA6C;AAC7C,IAAA,gBAAA,CAAA,mBAAA,CAAA,GAAA,mBAAuC;AACvC,IAAA,gBAAA,CAAA,YAAA,CAAA,GAAA,YAAyB;AACzB,IAAA,gBAAA,CAAA,mBAAA,CAAA,GAAA,mBAAuC;AACzC,CAAC,EAbWA,wBAAgB,KAAhBA,wBAAgB,GAAA,EAAA,CAAA,CAAA;;"}

package/dist/cjs/components/AICommandBar/AICommandBar.js

@@ -3,6 +3,7 @@
 var jsxRuntime = require('react/jsx-runtime');
 var React = require('react');
 var useAICommandBar = require('./useAICommandBar.js');
+var useTranslations = require('../../i18n/useTranslations.js');
 var MessageActions = require('../Feedback/MessageActions.js');
 var DevicContext = require('../../provider/DevicContext.js');
 var client = require('../../api/client.js');
@@ -74,6 +75,7 @@ const DEFAULT_OPTIONS = {
     commands: undefined,
     showHistoryCommand: true,
     toolGroups: undefined,
+    translations: undefined,
 };
 /**
  * AI Command Bar component - a floating input for quick AI interactions
@@ -95,6 +97,7 @@ const DEFAULT_OPTIONS = {
 const AICommandBar = React.forwardRef(function AICommandBar(props, ref) {
     const { assistantId, apiKey, baseUrl, pollingInterval, tenantId, tenantMetadata, tags, options = {}, isVisible: controlledVisible, onVisibilityChange, onExecute = 'callback', chatDrawerRef, onResponse, modelInterfaceTools, onSubmit, onToolCall, onError, onOpen, onClose, className, } = props;
     const mergedOptions = React.useMemo(() => ({ ...DEFAULT_OPTIONS, ...options }), [options]);
+    const t = useTranslations.useTranslations(mergedOptions.translations);
     const hook = useAICommandBar.useAICommandBar({
         assistantId,
         apiKey,
@@ -316,14 +319,14 @@ const AICommandBar = React.forwardRef(function AICommandBar(props, ref) {
             return (jsxRuntime.jsxs("div", { className: "devic-command-bar-result-tool-item", children: [customIcon ? (jsxRuntime.jsx("span", { className: "devic-command-bar-result-tool-icon", children: customIcon })) : (jsxRuntime.jsx(CheckIcon, { className: "devic-command-bar-result-tool-icon" })), jsxRuntime.jsx("span", { className: "devic-command-bar-result-tool-name", children: tc.summary || tc.name })] }, tc.id));
         });
     };
-    return (jsxRuntime.jsxs("div", { ref: containerRef, className: `devic-command-bar-container ${className || ''}`, "data-position": mergedOptions.position, "data-visible": hook.isVisible, style: containerStyle, children: [hook.showingCommands && hook.filteredCommands.length > 0 && (jsxRuntime.jsxs("div", { className: "devic-command-bar-dropdown", children: [jsxRuntime.jsxs("div", { className: "devic-command-bar-dropdown-header", children: [jsxRuntime.jsx("span", { children: "Commands" }), jsxRuntime.jsxs("span", { className: "devic-command-bar-dropdown-hint", children: [jsxRuntime.jsx("kbd", { children: "\u2191" }), jsxRuntime.jsx("kbd", { children: "\u2193" }), " to navigate, ", jsxRuntime.jsx("kbd", { children: "Enter" }), " to select"] })] }), jsxRuntime.jsx("div", { className: "devic-command-bar-dropdown-list", children: hook.filteredCommands.map((cmd, index) => (jsxRuntime.jsxs("div", { className: "devic-command-bar-dropdown-item", "data-selected": index === hook.selectedCommandIndex, onClick: () => hook.selectCommand(cmd), onMouseEnter: () => { }, children: [cmd.icon && (jsxRuntime.jsx("span", { className: "devic-command-bar-dropdown-icon", children: cmd.icon })), jsxRuntime.jsxs("span", { className: "devic-command-bar-dropdown-keyword", children: ["/", cmd.keyword] }), jsxRuntime.jsx("span", { className: "devic-command-bar-dropdown-desc", children: cmd.description })] }, cmd.keyword))) })] })), hook.showingHistory && (jsxRuntime.jsxs("div", { className: "devic-command-bar-dropdown", children: [jsxRuntime.jsxs("div", { className: "devic-command-bar-dropdown-header", children: [jsxRuntime.jsx("span", { children: "Command History" }), hook.history.length > 0 && (jsxRuntime.jsx("button", { className: "devic-command-bar-dropdown-clear", onClick: () => {
-                                    hook.clearHistory();
+    return (jsxRuntime.jsx(useTranslations.DevicTranslationsProvider, { translations: mergedOptions.translations, children: jsxRuntime.jsxs("div", { ref: containerRef, className: `devic-command-bar-container ${className || ''}`, "data-position": mergedOptions.position, "data-visible": hook.isVisible, style: containerStyle, children: [hook.showingCommands && hook.filteredCommands.length > 0 && (jsxRuntime.jsxs("div", { className: "devic-command-bar-dropdown", children: [jsxRuntime.jsxs("div", { className: "devic-command-bar-dropdown-header", children: [jsxRuntime.jsx("span", { children: t('Commands') }), jsxRuntime.jsxs("span", { className: "devic-command-bar-dropdown-hint", children: [jsxRuntime.jsx("kbd", { children: "\u2191" }), jsxRuntime.jsx("kbd", { children: "\u2193" }), " ", t('to navigate,'), " ", jsxRuntime.jsx("kbd", { children: "Enter" }), ' ', t('to select')] })] }), jsxRuntime.jsx("div", { className: "devic-command-bar-dropdown-list", children: hook.filteredCommands.map((cmd, index) => (jsxRuntime.jsxs("div", { className: "devic-command-bar-dropdown-item", "data-selected": index === hook.selectedCommandIndex, onClick: () => hook.selectCommand(cmd), onMouseEnter: () => { }, children: [cmd.icon && (jsxRuntime.jsx("span", { className: "devic-command-bar-dropdown-icon", children: cmd.icon })), jsxRuntime.jsxs("span", { className: "devic-command-bar-dropdown-keyword", children: ["/", cmd.keyword] }), jsxRuntime.jsx("span", { className: "devic-command-bar-dropdown-desc", children: cmd.description })] }, cmd.keyword))) })] })), hook.showingHistory && (jsxRuntime.jsxs("div", { className: "devic-command-bar-dropdown", children: [jsxRuntime.jsxs("div", { className: "devic-command-bar-dropdown-header", children: [jsxRuntime.jsx("span", { children: t('Command History') }), hook.history.length > 0 && (jsxRuntime.jsx("button", { className: "devic-command-bar-dropdown-clear", onClick: () => {
+                                        hook.clearHistory();
+                                        hook.setShowingHistory(false);
+                                    }, type: "button", children: t('Clear') }))] }), jsxRuntime.jsx("div", { className: "devic-command-bar-dropdown-list", style: resultMessageStyle, children: hook.history.length === 0 ? (jsxRuntime.jsx("div", { className: "devic-command-bar-dropdown-empty", children: t('No history yet') })) : (hook.history.map((item, index) => (jsxRuntime.jsxs("div", { className: "devic-command-bar-dropdown-item devic-command-bar-history-item", onClick: () => {
                                     hook.setShowingHistory(false);
-                                }, type: "button", children: "Clear" }))] }), jsxRuntime.jsx("div", { className: "devic-command-bar-dropdown-list", style: resultMessageStyle, children: hook.history.length === 0 ? (jsxRuntime.jsx("div", { className: "devic-command-bar-dropdown-empty", children: "No history yet" })) : (hook.history.map((item, index) => (jsxRuntime.jsxs("div", { className: "devic-command-bar-dropdown-item devic-command-bar-history-item", onClick: () => {
-                                hook.setShowingHistory(false);
-                                hook.setInputValue(item);
-                                hook.focus();
-                            }, children: [jsxRuntime.jsx(HistoryIcon, { className: "devic-command-bar-dropdown-icon" }), jsxRuntime.jsx("span", { className: "devic-command-bar-history-text", children: item })] }, `${item}-${index}`)))) })] })), mergedOptions.showResultCard && hook.result && !hook.showingHistory && !hook.showingCommands && (jsxRuntime.jsxs("div", { className: "devic-command-bar-result", children: [hook.result.toolCalls.length > 0 && (jsxRuntime.jsxs("div", { className: "devic-command-bar-result-tools", children: [jsxRuntime.jsxs("div", { className: "devic-command-bar-result-tools-header", "data-expanded": toolsExpanded, onClick: () => setToolsExpanded(!toolsExpanded), children: [jsxRuntime.jsx(ChevronIcon, { className: "devic-command-bar-result-tools-chevron" }), jsxRuntime.jsx("span", { children: "Tool calls" }), jsxRuntime.jsx("span", { className: "devic-command-bar-result-tools-count", children: hook.result.toolCalls.length })] }), jsxRuntime.jsx("div", { className: "devic-command-bar-result-tools-list", "data-expanded": toolsExpanded, children: renderToolCallItems(hook.result.toolCalls, mergedOptions) })] })), jsxRuntime.jsx("div", { className: "devic-command-bar-result-message", style: resultMessageStyle, children: hook.result.message.content?.message || (jsxRuntime.jsx("span", { className: "devic-command-bar-result-empty", children: "No response" })) }), jsxRuntime.jsx("div", { className: "devic-cmd-result-actions", children: jsxRuntime.jsx(MessageActions.MessageActions, { messageId: hook.result.message.uid, messageContent: hook.result.message.content?.message, currentFeedback: feedbackState, onFeedback: handleFeedback, showCopy: true, showFeedback: true, theme: feedbackTheme }) })] })), hook.error && !hook.isProcessing && (jsxRuntime.jsx("div", { className: "devic-command-bar-error", children: hook.error.message })), jsxRuntime.jsxs("div", { className: "devic-command-bar", style: barStyle, children: [jsxRuntime.jsx("div", { className: "devic-command-bar-icon", children: hook.isProcessing ? (jsxRuntime.jsx("div", { className: "devic-command-bar-spinner" })) : (mergedOptions.icon || jsxRuntime.jsx(SparklesIcon, {})) }), hook.isProcessing ? (jsxRuntime.jsxs("div", { className: "devic-command-bar-summary", children: [hook.currentToolSummary || mergedOptions.processingMessage, "..."] })) : (jsxRuntime.jsx("input", { ref: hook.inputRef, type: "text", className: "devic-command-bar-input", placeholder: mergedOptions.placeholder, value: hook.inputValue, onChange: (e) => hook.setInputValue(e.target.value), onKeyDown: hook.handleKeyDown })), mergedOptions.showShortcutHint && mergedOptions.shortcut && !hook.isProcessing && (jsxRuntime.jsx("div", { className: "devic-command-bar-shortcut", children: useAICommandBar.formatShortcut(mergedOptions.shortcut) }))] })] }));
+                                    hook.setInputValue(item);
+                                    hook.focus();
+                                }, children: [jsxRuntime.jsx(HistoryIcon, { className: "devic-command-bar-dropdown-icon" }), jsxRuntime.jsx("span", { className: "devic-command-bar-history-text", children: item })] }, `${item}-${index}`)))) })] })), mergedOptions.showResultCard && hook.result && !hook.showingHistory && !hook.showingCommands && (jsxRuntime.jsxs("div", { className: "devic-command-bar-result", children: [hook.result.toolCalls.length > 0 && (jsxRuntime.jsxs("div", { className: "devic-command-bar-result-tools", children: [jsxRuntime.jsxs("div", { className: "devic-command-bar-result-tools-header", "data-expanded": toolsExpanded, onClick: () => setToolsExpanded(!toolsExpanded), children: [jsxRuntime.jsx(ChevronIcon, { className: "devic-command-bar-result-tools-chevron" }), jsxRuntime.jsx("span", { children: t('Tool calls') }), jsxRuntime.jsx("span", { className: "devic-command-bar-result-tools-count", children: hook.result.toolCalls.length })] }), jsxRuntime.jsx("div", { className: "devic-command-bar-result-tools-list", "data-expanded": toolsExpanded, children: renderToolCallItems(hook.result.toolCalls, mergedOptions) })] })), jsxRuntime.jsx("div", { className: "devic-command-bar-result-message", style: resultMessageStyle, children: hook.result.message.content?.message || (jsxRuntime.jsx("span", { className: "devic-command-bar-result-empty", children: t('No response') })) }), jsxRuntime.jsx("div", { className: "devic-cmd-result-actions", children: jsxRuntime.jsx(MessageActions.MessageActions, { messageId: hook.result.message.uid, messageContent: hook.result.message.content?.message, currentFeedback: feedbackState, onFeedback: handleFeedback, showCopy: true, showFeedback: true, theme: feedbackTheme }) })] })), hook.error && !hook.isProcessing && (jsxRuntime.jsx("div", { className: "devic-command-bar-error", children: hook.error.message })), jsxRuntime.jsxs("div", { className: "devic-command-bar", style: barStyle, children: [jsxRuntime.jsx("div", { className: "devic-command-bar-icon", children: hook.isProcessing ? (jsxRuntime.jsx("div", { className: "devic-command-bar-spinner" })) : (mergedOptions.icon || jsxRuntime.jsx(SparklesIcon, {})) }), hook.isProcessing ? (jsxRuntime.jsxs("div", { className: "devic-command-bar-summary", children: [hook.currentToolSummary || t(mergedOptions.processingMessage), "..."] })) : (jsxRuntime.jsx("input", { ref: hook.inputRef, type: "text", className: "devic-command-bar-input", placeholder: t(mergedOptions.placeholder), value: hook.inputValue, onChange: (e) => hook.setInputValue(e.target.value), onKeyDown: hook.handleKeyDown })), mergedOptions.showShortcutHint && mergedOptions.shortcut && !hook.isProcessing && (jsxRuntime.jsx("div", { className: "devic-command-bar-shortcut", children: useAICommandBar.formatShortcut(mergedOptions.shortcut) }))] })] }) }));
 });
 /**
  * Sparkles icon (default)