@epam/ai-dial-chat-shared 1.0.0-rc.1

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@epam/ai-dial-chat-shared",
+  "description": "Shared domain models, utilities, and UI components for AI DIAL Chat libraries",
+  "version": "1.0.0-rc.1",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./index.js",
+  "module": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "default": "./index.js"
+    }
+  },
+  "peerDependencies": {
+    "react": "^19.2.6",
+    "@epam/ai-dial-ui-kit": "0.12.0-dev.36",
+    "vitest": "~4.1.0",
+    "@tabler/icons-react": "^3.44.0",
+    "react-syntax-highlighter": "^16.1.1",
+    "react-markdown": "^10.1.0",
+    "remark-gfm": "^4.0.1"
+  },
+  "dependencies": {
+    "classnames": "2.5.1",
+    "tailwind-merge": "^3.6.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/epam/ai-dial-chat.git",
+    "directory": "libs/chat-shared"
+  }
+}

package/types/attachment.d.ts

@@ -0,0 +1,23 @@
+/** Discriminates why an attachment upload failed. Only set when `status === RequestStatus.Error`. */
+export declare enum AttachmentErrorReason {
+    /** Upload failed because the device was offline. */
+    Network = "network",
+    /** File MIME type is not in the deployment's inputAttachmentTypes list. */
+    UnsupportedType = "unsupported-type"
+}
+/** Discriminates the kind of content an attachment carries. */
+export declare enum AttachmentType {
+    /** Generic file attachment (non-image, non-audio). */
+    File = "file",
+    /** Raster or vector image. */
+    Image = "image",
+    /** Audio file that can be played inline. */
+    Audio = "audio",
+    /** A saved prompt snippet. */
+    Prompt = "prompt",
+    /** Text pasted directly by the user. */
+    Pasted = "pasted",
+    /** A link to a file or webpage. */
+    Link = "link"
+}
+//# sourceMappingURL=attachment.d.ts.map

package/types/attachment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment.d.ts","sourceRoot":"","sources":["../../src/types/attachment.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,oBAAY,qBAAqB;IAC/B,oDAAoD;IACpD,OAAO,YAAY;IACnB,2EAA2E;IAC3E,eAAe,qBAAqB;CACrC;AAED,+DAA+D;AAC/D,oBAAY,cAAc;IACxB,sDAAsD;IACtD,IAAI,SAAS;IACb,8BAA8B;IAC9B,KAAK,UAAU;IACf,4CAA4C;IAC5C,KAAK,UAAU;IACf,8BAA8B;IAC9B,MAAM,WAAW;IACjB,wCAAwC;IACxC,MAAM,WAAW;IACjB,mCAAmC;IACnC,IAAI,SAAS;CACd"}

package/types/code-editor.d.ts

@@ -0,0 +1,8 @@
+/** Color theme for syntax highlighting. */
+export declare enum CodeBlockTheme {
+    /** Dark syntax-highlighting theme. */
+    Dark = "dark",
+    /** Light syntax-highlighting theme. */
+    Light = "light"
+}
+//# sourceMappingURL=code-editor.d.ts.map

package/types/code-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-editor.d.ts","sourceRoot":"","sources":["../../src/types/code-editor.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,oBAAY,cAAc;IACxB,sCAAsC;IACtC,IAAI,SAAS;IACb,uCAAuC;IACvC,KAAK,UAAU;CAChB"}

package/types/mime-type.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Well-known MIME type constants used in DIAL API attachments.
+ * For arbitrary subtypes, pass a plain `string` alongside this enum.
+ */
+export declare enum MIMEType {
+    /** GitHub-flavoured Markdown. */
+    Markdown = "text/markdown",
+    /** Plain unformatted text. */
+    Plain = "text/plain",
+    /** HTML markup. */
+    HTML = "text/html",
+    /** XHTML markup. */
+    XHTML = "application/xhtml+xml",
+    /** Cascading Style Sheets. */
+    CSS = "text/css",
+    /** JavaScript source. */
+    JavaScript = "text/javascript",
+    /** TypeScript source (non-standard but widely used). */
+    TypeScript = "text/typescript",
+    /** CSV spreadsheet data. */
+    CSV = "text/csv",
+    /** JSON data. */
+    JSON = "application/json",
+    /** XML document (application type). */
+    XML = "application/xml",
+    /** PDF document. */
+    PDF = "application/pdf",
+    /** ZIP archive. */
+    ZIP = "application/zip",
+    /** GZIP-compressed data. */
+    GZIP = "application/gzip",
+    /** JPEG raster image. */
+    JPEG = "image/jpeg",
+    /** PNG raster image. */
+    PNG = "image/png",
+    /** GIF image. */
+    GIF = "image/gif",
+    /** WebP image. */
+    WebP = "image/webp",
+    /** BMP bitmap image. */
+    BMP = "image/bmp",
+    /** SVG vector image. */
+    SVG = "image/svg+xml"
+}
+/**
+ * Well-known file extension constants used as fallback when a MIME type is
+ * unavailable or unreliable.
+ */
+export declare enum FileExtension {
+    /** PDF document. */
+    PDF = "pdf",
+    /** Markdown document (`.md`). */
+    Markdown = "md",
+    /** Markdown document, alternate extension (`.markdown`). */
+    MarkdownAlt = "markdown",
+    /** JSON document. */
+    JSON = "json"
+}
+//# sourceMappingURL=mime-type.d.ts.map

package/types/mime-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime-type.d.ts","sourceRoot":"","sources":["../../src/types/mime-type.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,QAAQ;IAElB,iCAAiC;IACjC,QAAQ,kBAAkB;IAC1B,8BAA8B;IAC9B,KAAK,eAAe;IACpB,mBAAmB;IACnB,IAAI,cAAc;IAClB,oBAAoB;IACpB,KAAK,0BAA0B;IAC/B,8BAA8B;IAC9B,GAAG,aAAa;IAChB,yBAAyB;IACzB,UAAU,oBAAoB;IAC9B,wDAAwD;IACxD,UAAU,oBAAoB;IAC9B,4BAA4B;IAC5B,GAAG,aAAa;IAGhB,iBAAiB;IACjB,IAAI,qBAAqB;IACzB,uCAAuC;IACvC,GAAG,oBAAoB;IACvB,oBAAoB;IACpB,GAAG,oBAAoB;IACvB,mBAAmB;IACnB,GAAG,oBAAoB;IACvB,4BAA4B;IAC5B,IAAI,qBAAqB;IAGzB,yBAAyB;IACzB,IAAI,eAAe;IACnB,wBAAwB;IACxB,GAAG,cAAc;IACjB,iBAAiB;IACjB,GAAG,cAAc;IACjB,kBAAkB;IAClB,IAAI,eAAe;IACnB,wBAAwB;IACxB,GAAG,cAAc;IACjB,wBAAwB;IACxB,GAAG,kBAAkB;CACtB;AAED;;;GAGG;AACH,oBAAY,aAAa;IACvB,oBAAoB;IACpB,GAAG,QAAQ;IACX,iCAAiC;IACjC,QAAQ,OAAO;IACf,4DAA4D;IAC5D,WAAW,aAAa;IACxB,qBAAqB;IACrB,IAAI,SAAS;CACd"}

package/types/overlay/overlay-protocol.d.ts

@@ -0,0 +1,308 @@
+/**
+ * Namespace prefix shared by every `@DIAL_OVERLAY` postMessage type string
+ * exchanged between a `ChatOverlay`/`ChatOverlayManager` host page and an
+ * embedded chat app instance.
+ */
+export declare const DIAL_OVERLAY_NAMESPACE = "@DIAL_OVERLAY";
+/**
+ * Request message types the host (library) can send to the embedded app.
+ * Each value is the full wire `type` string sent over `postMessage`.
+ */
+export declare enum OverlayRequestType {
+    /** Fetch the active conversation's messages. */
+    GetMessages = "@DIAL_OVERLAY/GET_MESSAGES",
+    /** Send a new message in the active conversation. */
+    SendMessage = "@DIAL_OVERLAY/SEND_MESSAGE",
+    /** Set the current text content of the message input. */
+    SetInputContent = "@DIAL_OVERLAY/SET_INPUT_CONTENT",
+    /** Set the active conversation's system prompt. */
+    SetSystemPrompt = "@DIAL_OVERLAY/SET_SYSTEM_PROMPT",
+    /** Set the active conversation's temperature. */
+    SetTemperature = "@DIAL_OVERLAY/SET_TEMPERATURE",
+    /** Set host-provided options (theme, model, conversation, host domain). */
+    SetOverlayOptions = "@DIAL_OVERLAY/SET_OVERLAY_OPTIONS",
+    /** Fetch the current user's conversation list. */
+    GetConversations = "@DIAL_OVERLAY/GET_CONVERSATIONS",
+    /** Fetch the currently displayed (active) conversation(s). */
+    GetSelectedConversations = "@DIAL_OVERLAY/GET_SELECTED_CONVERSATIONS",
+    /** Navigate to and load a specific conversation by id. */
+    SelectConversation = "@DIAL_OVERLAY/SELECT_CONVERSATION",
+    /** Create a new conversation, persisting immediately if a first message is given. */
+    CreateConversation = "@DIAL_OVERLAY/CREATE_CONVERSATION",
+    /** Open the conversation composer without persisting anything. */
+    CreateLocalConversation = "@DIAL_OVERLAY/CREATE_LOCAL_CONVERSATION",
+    /** Delete a conversation by id. */
+    DeleteConversation = "@DIAL_OVERLAY/DELETE_CONVERSATION",
+    /** Rename a conversation by id. */
+    RenameConversation = "@DIAL_OVERLAY/RENAME_CONVERSATION"
+}
+/**
+ * Event message types the embedded app can send to the host (library),
+ * without an accompanying request. Each value is the full wire `type`
+ * string sent over `postMessage`.
+ */
+export declare enum OverlayEventType {
+    /** Sent once, immediately, before any host identity is known. */
+    InitReady = "@DIAL_OVERLAY/INIT_READY",
+    /** Sent once, after auth/model-load state resolves. */
+    Ready = "@DIAL_OVERLAY/READY",
+    /** Sent once, after the active conversation has been selected/loaded for the first time. */
+    ReadyToInteract = "@DIAL_OVERLAY/READY_TO_INTERACT",
+    /** Sent whenever the app finishes loading a conversation (initial load or navigation). */
+    SelectedConversationLoaded = "@DIAL_OVERLAY/SELECTED_CONVERSATION_LOADED",
+    /** Sent when a generation starts for the active conversation. */
+    GptStartGenerating = "@DIAL_OVERLAY/GPT_START_GENERATING",
+    /** Sent when a generation completes for the active conversation. */
+    GptEndGenerating = "@DIAL_OVERLAY/GPT_END_GENERATING",
+    /** Sent when a user (or host) stops an in-flight generation. */
+    StopGenerating = "@DIAL_OVERLAY/STOP_GENERATING",
+    /** Sent whenever the app's conversation list changes. */
+    ConversationsUpdated = "@DIAL_OVERLAY/CONVERSATIONS_UPDATED"
+}
+/**
+ * Optional embed-time features a host can opt into via
+ * `ChatOverlayOptions.enabledFeatures`.
+ */
+export declare enum OverlayFeature {
+    /** Enables the `microphone` permission on the iframe's `allow` attribute for voice input. */
+    VoiceInput = "voice-input"
+}
+/**
+ * Minimal message shape carried in overlay protocol payloads. A narrowed
+ * projection of the app's full message model, kept local to this module so
+ * the overlay protocol has no dependency on `libs/chat-shared`'s domain models.
+ */
+export interface OverlayChatMessage {
+    /** Message id. */
+    id: string;
+    /** Author role, e.g. `'user'`, `'assistant'`, or `'system'`. */
+    role: string;
+    /** Message text content. */
+    content: string;
+}
+/**
+ * Host-agnostic projection of a conversation, exposed by the conversation-list
+ * methods. Declared independently of `@epam/chat-api-client` or any app-owned
+ * type so this module keeps no dependency on generated/app code.
+ */
+export interface OverlayConversation {
+    /** Conversation id. */
+    id: string;
+    /** Conversation title. */
+    title: string;
+    /** Epoch milliseconds of the conversation's last update. */
+    updatedAt: number;
+    /** Whether the conversation is pinned. */
+    isPinned: boolean;
+    /** Whether the current user has read-only access. */
+    isReadonly: boolean;
+    /** Whether the conversation was shared with the current user. */
+    sharedWithMe: boolean;
+    /** Whether the conversation was published with the current user. */
+    publishedWithMe: boolean;
+}
+/**
+ * Explicit error signal carried by conversation-list method responses
+ * (`SELECT_CONVERSATION`, `CREATE_CONVERSATION`, `DELETE_CONVERSATION`,
+ * `RENAME_CONVERSATION`) so invalid ids/values/forbidden actions reject with
+ * a clear reason instead of the request silently timing out.
+ */
+export interface OverlayConversationError {
+    /** `NOT_FOUND` for an unknown/inaccessible id, `FORBIDDEN` for a read-only/shared-without-write-access conversation, `INVALID_ARGUMENT` for a rejected value (e.g. blank rename). */
+    code: 'NOT_FOUND' | 'FORBIDDEN' | 'INVALID_ARGUMENT';
+    /** Human-readable description of the failure. */
+    message: string;
+}
+/**
+ * Options a host page passes to `ChatOverlay`'s constructor, and the subset
+ * of them re-sent to the embedded app via `SET_OVERLAY_OPTIONS`.
+ */
+export interface ChatOverlayOptions {
+    /** Full URL of the chat app instance to embed (origin + optional path). */
+    domain: string;
+    /** Milliseconds to wait for a request's response before rejecting. Defaults to `10000`. */
+    requestTimeout?: number;
+    /** Inline CSS properties applied to the loader element while it is visible. */
+    loaderStyles?: Record<string, string>;
+    /** CSS class applied to the loader element. */
+    loaderClass?: string;
+    /** Custom HTML rendered inside the loader element, replacing the default spinner. */
+    loaderInnerHTML?: string;
+    /** Event whose receipt hides the loader. Defaults to `OverlayEventType.Ready`. */
+    loaderHideEvent?: OverlayEventType;
+    /** Embed-time features to enable, e.g. microphone access for voice input. */
+    enabledFeatures?: OverlayFeature[];
+    /** Theme name applied to the embedded app. */
+    theme?: string;
+    /** Deployment/model id to select in the embedded app. */
+    modelId?: string;
+    /** Conversation id the embedded app should load and display. */
+    overlayConversationId?: string;
+}
+/** Payload of a `SET_OVERLAY_OPTIONS` request. */
+export interface SetOverlayOptionsPayload {
+    /** Origin of the host page, used by the app to target responses/events. */
+    hostDomain: string;
+    /** Theme name to apply, if provided. */
+    theme?: string;
+    /** Deployment/model id to select, if provided. */
+    modelId?: string;
+    /** Conversation id to navigate to and load, if provided. */
+    overlayConversationId?: string;
+}
+/** Payload of a `SEND_MESSAGE` request. */
+export interface SendMessagePayload {
+    /** Text content of the message to send. */
+    content: string;
+}
+/** Payload of a `SET_INPUT_CONTENT` request. */
+export interface SetInputContentPayload {
+    /** Text content to set in the message input. */
+    content: string;
+}
+/** Payload of a `SET_SYSTEM_PROMPT` request. */
+export interface SetSystemPromptPayload {
+    /** System prompt to persist on the active conversation. */
+    systemPrompt: string;
+}
+/** Payload of a `SET_TEMPERATURE` request. */
+export interface SetTemperaturePayload {
+    /** Temperature value to persist on the active conversation. */
+    temperature: number;
+}
+/** Payload of a `SELECT_CONVERSATION` request. */
+export interface SelectConversationPayload {
+    /** Id of the conversation to select. */
+    id: string;
+}
+/** Payload of a `DELETE_CONVERSATION` request. */
+export interface DeleteConversationPayload {
+    /** Id of the conversation to delete. */
+    id: string;
+}
+/** Payload of a `RENAME_CONVERSATION` request. */
+export interface RenameConversationPayload {
+    /** Id of the conversation to rename. */
+    id: string;
+    /** New title for the conversation. */
+    newName: string;
+}
+/** Payload of a `CREATE_CONVERSATION` request. */
+export interface CreateConversationPayload {
+    /** Deployment/model id to create the conversation with, if given. */
+    deploymentId?: string;
+    /** Initial message to persist immediately. Omitted/blank opens the composer instead. */
+    firstMessage?: string;
+}
+/** Response payload of a `GET_MESSAGES` request. */
+export interface GetMessagesResponse {
+    /** Messages in the active conversation. */
+    messages: OverlayChatMessage[];
+}
+/** Response payload of a `SEND_MESSAGE` request. */
+export interface SendMessageResponse {
+    /** Messages in the active conversation after the send. */
+    messages: OverlayChatMessage[];
+}
+/** Response payload of a `SET_SYSTEM_PROMPT` request. */
+export interface SetSystemPromptResponse {
+    /** System prompt value that was persisted. */
+    systemPrompt: string;
+}
+/** Response payload of a `SET_TEMPERATURE` request. */
+export interface SetTemperatureResponse {
+    /** Temperature value that was persisted. */
+    temperature: number;
+}
+/** Response payload of a `SET_OVERLAY_OPTIONS` request. */
+export interface SetOverlayOptionsResponse {
+    /** Whether the supplied options were applied (`false` only signals a fallback, never a thrown error). */
+    applied: boolean;
+}
+/** Response payload of a `GET_CONVERSATIONS` request. */
+export interface GetConversationsResponse {
+    /** The current user's conversation list. */
+    conversations: OverlayConversation[];
+}
+/** Response payload of a `GET_SELECTED_CONVERSATIONS` request. */
+export interface GetSelectedConversationsResponse {
+    /** Currently displayed conversation(s); empty when no conversation is mounted. */
+    conversations: OverlayConversation[];
+}
+/** Response payload of a `SELECT_CONVERSATION` request. */
+export interface SelectConversationResponse {
+    /** The now-selected conversation's projection, present on success. */
+    conversation?: OverlayConversation;
+    /** Present when the selection failed. */
+    error?: OverlayConversationError;
+}
+/** Response payload of a `CREATE_CONVERSATION` request. */
+export interface CreateConversationResponse {
+    /** The created conversation's projection, or `null` when the composer path was taken. */
+    conversation: OverlayConversation | null;
+    /** Present when creation failed. */
+    error?: OverlayConversationError;
+}
+/** Response payload of a `CREATE_LOCAL_CONVERSATION` request. */
+export interface CreateLocalConversationResponse {
+    /** Always `null` — the composer opens without persisting anything. */
+    conversation: null;
+}
+/** Response payload of a `DELETE_CONVERSATION` request. */
+export interface DeleteConversationResponse {
+    /** Present when deletion failed. */
+    error?: OverlayConversationError;
+}
+/** Response payload of a `RENAME_CONVERSATION` request. */
+export interface RenameConversationResponse {
+    /** The renamed conversation's projection, present on success. */
+    conversation?: OverlayConversation;
+    /** Present when the rename failed. */
+    error?: OverlayConversationError;
+}
+/**
+ * A request message sent from the host (library) to the embedded app.
+ * `type` is always `'${OverlayRequestType}'`.
+ */
+export interface OverlayMessageRequest<TPayload = unknown> {
+    /** Full wire type string, one of the `OverlayRequestType` values. */
+    type: `${OverlayRequestType}`;
+    /** Unique id used to match this request to its response. */
+    requestId: string;
+    /**
+     * Epoch milliseconds after which the embedded app must stop waiting for
+     * prerequisites (such as an active conversation bridge) and drop the request.
+     */
+    expiresAt?: number;
+    /** Request-specific payload. */
+    payload?: TPayload;
+}
+/**
+ * A response message sent from the embedded app to the host (library),
+ * answering a specific request by `requestId`.
+ */
+export interface OverlayMessageResponse<TPayload = unknown> {
+    /** Full wire type string, always `'${OverlayRequestType}/RESPONSE'`. */
+    type: `${OverlayRequestType}/RESPONSE`;
+    /** `requestId` of the request this message answers. */
+    requestId: string;
+    /** Response-specific payload. */
+    payload?: TPayload;
+}
+/**
+ * An event message sent from the embedded app to the host (library),
+ * with no associated request (no `requestId` field).
+ */
+export interface OverlayMessageEvent<TPayload = unknown> {
+    /** Full wire type string, one of the `OverlayEventType` values. */
+    type: `${OverlayEventType}`;
+    /** Event-specific payload. */
+    payload?: TPayload;
+}
+/** Narrows an arbitrary value to a well-formed `OverlayMessageRequest`. */
+export declare const isOverlayMessageRequest: (data: unknown) => data is OverlayMessageRequest;
+/** Narrows an arbitrary value to a well-formed `OverlayMessageResponse`. */
+export declare const isOverlayMessageResponse: (data: unknown) => data is OverlayMessageResponse;
+/** Narrows an arbitrary value to a well-formed `OverlayMessageEvent`. */
+export declare const isOverlayMessageEvent: (data: unknown) => data is OverlayMessageEvent;
+//# sourceMappingURL=overlay-protocol.d.ts.map

package/types/overlay/overlay-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay-protocol.d.ts","sourceRoot":"","sources":["../../../src/types/overlay/overlay-protocol.ts"],"names":[],"mappings":"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"}

package/utils/avatar-color.d.ts

@@ -0,0 +1,13 @@
+/** A background/foreground colour pair for an initials avatar badge. */
+export interface AvatarColorEntry {
+    /** CSS hex colour for the badge background. */
+    background: string;
+    /** CSS hex colour for the initials text. */
+    foreground: string;
+}
+/**
+ * Deterministically maps a display name to a palette entry using a
+ * char-code-sum hash. The same name always returns the same colours.
+ */
+export declare const pickAvatarColor: (name: string) => AvatarColorEntry;
+//# sourceMappingURL=avatar-color.d.ts.map

package/utils/avatar-color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"avatar-color.d.ts","sourceRoot":"","sources":["../../src/utils/avatar-color.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,UAAU,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;CACpB;AAcD;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,gBAM9C,CAAC"}

package/utils/build-css-vars.d.ts

@@ -0,0 +1,7 @@
+import { CSSProperties } from 'react';
+/**
+ * Builds a `CSSProperties` object from a record mapping CSS custom property
+ * names to values. Entries with `undefined` or empty-string values are omitted.
+ */
+export declare const buildCssVars: (vars: Record<string, string | number | undefined>) => CSSProperties;
+//# sourceMappingURL=build-css-vars.d.ts.map

package/utils/build-css-vars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-css-vars.d.ts","sourceRoot":"","sources":["../../src/utils/build-css-vars.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,YAAY,GACvB,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,KAChD,aAQF,CAAC"}

package/utils/copy-to-clipboard.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Copies `text` to the clipboard. Returns `true` when the write succeeded,
+ * `false` when both paths failed (e.g. sandboxed iframe without clipboard
+ * permission).
+ *
+ * Strategy:
+ * 1. Async Clipboard API (`navigator.clipboard.writeText`) — the preferred
+ *    path on modern browsers. Requires a secure context (HTTPS) and the page
+ *    to be focused.
+ * 2. `execCommand('copy')` fallback — used when the Clipboard API is
+ *    unavailable (HTTP, older browsers) or rejects. Uses `setSelectionRange`
+ *    instead of `select()` because iOS Safari ignores `textarea.select()`.
+ */
+export declare const copyToClipboard: (text: string) => Promise<boolean>;
+//# sourceMappingURL=copy-to-clipboard.d.ts.map

package/utils/copy-to-clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-to-clipboard.d.ts","sourceRoot":"","sources":["../../src/utils/copy-to-clipboard.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,OAAO,CAAC,OAAO,CAY7D,CAAC"}

package/utils/file-download.d.ts

@@ -0,0 +1,9 @@
+/** Returns the file extension (without a leading dot) for a fenced-code-block language identifier, defaulting to `txt`. */
+export declare const getFileExtensionForLanguage: (language: string) => string;
+/** Creates a temporary anchor element and clicks it to trigger a browser download for `href`. */
+export declare const triggerAnchorDownload: (href: string, filename: string) => void;
+/** Triggers a browser download of `blob`, using a temporary object URL that is revoked afterward. */
+export declare const triggerBlobDownload: (blob: Blob, filename: string) => void;
+/** Triggers a browser download of `content` as a text file named `filename`. */
+export declare const downloadTextFile: (content: string, filename: string) => void;
+//# sourceMappingURL=file-download.d.ts.map

package/utils/file-download.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-download.d.ts","sourceRoot":"","sources":["../../src/utils/file-download.ts"],"names":[],"mappings":"AAyCA,2HAA2H;AAC3H,eAAO,MAAM,2BAA2B,GAAI,UAAU,MAAM,KAAG,MACT,CAAC;AAEvD,iGAAiG;AACjG,eAAO,MAAM,qBAAqB,GAAI,MAAM,MAAM,EAAE,UAAU,MAAM,KAAG,IAKtE,CAAC;AAEF,qGAAqG;AACrG,eAAO,MAAM,mBAAmB,GAAI,MAAM,IAAI,EAAE,UAAU,MAAM,KAAG,IAIlE,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,gBAAgB,GAAI,SAAS,MAAM,EAAE,UAAU,MAAM,KAAG,IAKpE,CAAC"}

package/utils/format-file-size.d.ts

@@ -0,0 +1,3 @@
+/** Formats a byte count as a human-readable size string (e.g. `840 KB`, `2.4 MB`). */
+export declare const formatFileSize: (bytes: number) => string;
+//# sourceMappingURL=format-file-size.d.ts.map

package/utils/format-file-size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-file-size.d.ts","sourceRoot":"","sources":["../../src/utils/format-file-size.ts"],"names":[],"mappings":"AAIA,sFAAsF;AACtF,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG,MAQ9C,CAAC"}

package/utils/format-last-used.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Converts a timestamp to a human-readable "last used" string,
+ * e.g. "just now", "5 min ago", "3 hours ago", "2 days ago".
+ *
+ * Returns an empty string when the input is falsy or not a valid date.
+ */
+export declare const formatLastUsed: (timestamp?: number) => string;
+//# sourceMappingURL=format-last-used.d.ts.map

package/utils/format-last-used.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-last-used.d.ts","sourceRoot":"","sources":["../../src/utils/format-last-used.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,YAAY,MAAM,KAAG,MA2BnD,CAAC"}

package/utils/initials.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Returns 1–2 uppercase initials derived from a display name.
+ *
+ * - Empty/whitespace-only → `"?"`
+ * - Two or more words → first letter of each of the first two words (skipping leading punctuation like `[` or `(`)
+ * - Single word → first two letter characters of that word
+ */
+export declare const extractInitials: (name: string) => string;
+//# sourceMappingURL=initials.d.ts.map

package/utils/initials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initials.d.ts","sourceRoot":"","sources":["../../src/utils/initials.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,MAa9C,CAAC"}

package/utils/is-audio-transcription-supported.d.ts

@@ -0,0 +1,3 @@
+/** Returns `true` when `types` contains a wildcard or any audio MIME type; `false` otherwise. */
+export declare const isAudioTranscriptionSupported: (types?: string[]) => boolean;
+//# sourceMappingURL=is-audio-transcription-supported.d.ts.map

package/utils/is-audio-transcription-supported.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-audio-transcription-supported.d.ts","sourceRoot":"","sources":["../../src/utils/is-audio-transcription-supported.ts"],"names":[],"mappings":"AAKA,iGAAiG;AACjG,eAAO,MAAM,6BAA6B,GAAI,QAAQ,MAAM,EAAE,KAAG,OAGrD,CAAC"}

package/utils/merge-class.d.ts

@@ -0,0 +1,4 @@
+import { default as classNames } from 'classnames';
+/** Merge class names (classnames → tailwind-merge). */
+export declare function mergeClasses(...inputs: Parameters<typeof classNames>): string;
+//# sourceMappingURL=merge-class.d.ts.map

package/utils/merge-class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-class.d.ts","sourceRoot":"","sources":["../../src/utils/merge-class.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AAGpC,uDAAuD;AACvD,wBAAgB,YAAY,CAAC,GAAG,MAAM,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,GAAG,MAAM,CAE7E"}

package/utils/message-attachment-to-display.d.ts

@@ -0,0 +1,22 @@
+import { DisplayAttachment, MessageAttachment } from '../models/chat';
+/**
+ * Optional app-owned callbacks used to resolve display URLs for an attachment.
+ * When omitted, the mapper falls back to the attachment's own `url` (or a
+ * synthesized `data:` URL when only inline base64 `data` is present).
+ */
+export interface AttachmentDisplayResolvers {
+    /** Resolves the image preview URL for an attachment that has a remote `url`. */
+    resolvePreviewUrl?(dto: MessageAttachment): string | undefined;
+    /** Resolves the audio playback URL for an attachment that has a remote `url`. */
+    resolvePlayUrl?(dto: MessageAttachment): string | undefined;
+}
+/**
+ * Maps a {@link MessageAttachment} DTO to the display-only {@link DisplayAttachment}
+ * model used by UI components. This is a pure function: any app/host-specific URL
+ * resolution (catalog icon URLs, DIAL file download URLs, etc.) is injected through
+ * the optional `resolvers` argument rather than performed here.
+ */
+export declare const messageAttachmentToDisplayAttachment: (dto: MessageAttachment, resolvers?: AttachmentDisplayResolvers) => DisplayAttachment;
+/** Maps a list of {@link MessageAttachment} DTOs to display-only attachment models. */
+export declare const messageAttachmentsToDisplayAttachments: (dtos: MessageAttachment[] | undefined, resolvers?: AttachmentDisplayResolvers) => DisplayAttachment[];
+//# sourceMappingURL=message-attachment-to-display.d.ts.map

package/utils/message-attachment-to-display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-attachment-to-display.d.ts","sourceRoot":"","sources":["../../src/utils/message-attachment-to-display.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,gBAAgB,CAAC;AAIxB;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,gFAAgF;IAChF,iBAAiB,CAAC,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,GAAG,SAAS,CAAC;IAC/D,iFAAiF;IACjF,cAAc,CAAC,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,GAAG,SAAS,CAAC;CAC7D;AAwCD;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC,GAC/C,KAAK,iBAAiB,EACtB,YAAW,0BAA+B,KACzC,iBA6CF,CAAC;AAEF,uFAAuF;AACvF,eAAO,MAAM,sCAAsC,GACjD,MAAM,iBAAiB,EAAE,GAAG,SAAS,EACrC,YAAW,0BAA+B,KACzC,iBAAiB,EAEhB,CAAC"}

package/utils/message.d.ts

@@ -0,0 +1,10 @@
+import { Message, StatusMessage } from '../models/chat';
+/**
+ * Narrows a `Message` to `StatusMessage` when its role is `MessageRole.Status`.
+ * The parameter accepts `Message | StatusMessage` because `StatusMessage.custom_content`
+ * is not assignable to `Message.custom_content`, so `StatusMessage` cannot be a
+ * structural subtype of `Message`. Callers with `Message`-typed values can still pass
+ * them directly since `Message` is assignable to the union.
+ */
+export declare const isStatusMessage: (msg: Message | StatusMessage) => msg is StatusMessage;
+//# sourceMappingURL=message.d.ts.map

package/utils/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/utils/message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,KAAK,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/E;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAC1B,KAAK,OAAO,GAAG,aAAa,KAC3B,GAAG,IAAI,aAAgD,CAAC"}

package/utils/string-utils.d.ts

@@ -0,0 +1,5 @@
+/** Returns the UTF-8 byte length of `str`. */
+export declare const getUtf8ByteLength: (str: string) => number;
+/** Truncates `str` to at most `maxBytes` UTF-8 bytes without splitting multi-byte characters. */
+export declare const truncateToUtf8Bytes: (str: string, maxBytes: number) => string;
+//# sourceMappingURL=string-utils.d.ts.map

package/utils/string-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.d.ts","sourceRoot":"","sources":["../../src/utils/string-utils.ts"],"names":[],"mappings":"AAGA,8CAA8C;AAC9C,eAAO,MAAM,iBAAiB,GAAI,KAAK,MAAM,KAAG,MACpB,CAAC;AAE7B,iGAAiG;AACjG,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,EAAE,UAAU,MAAM,KAAG,MAanE,CAAC"}