@epam/ai-dial-chat-shared 1.3.0-dev.34 → 1.3.0-dev.37

package/models/custom-visualizer.d.ts

@@ -0,0 +1,61 @@
+/**
+ * A single MIME → visualizer mapping from the `CUSTOM_VISUALIZERS` registry.
+ * Field semantics are fixed by already-deployed visualizer applications and
+ * operator configurations — see `openspec/changes/archive/2026-07-30-add-custom-visualizers/design.md` D9/D10 in the
+ * `add-custom-visualizers` change for why `title` is required and
+ * `contentType` accepts a comma-separated list.
+ */
+export interface CustomVisualizer {
+    /**
+     * The postMessage protocol namespace, NOT a display label. Every message
+     * exchanged with the iframe is prefixed `${title}/…`, and the iframe-side
+     * visualizer application must be constructed with this identical string
+     * as its `appName`. A mismatch is a silent failure — the iframe loads but
+     * never receives data.
+     */
+    title: string;
+    /** Human-readable description of the visualizer (kept for parity with the development schema; not consumed by host UI). */
+    description?: string;
+    /** Icon URL or identifier for the visualizer (kept for parity with the development schema; not consumed by host UI). */
+    icon?: string;
+    /**
+     * Comma-separated list of one or more MIME types this entry matches (e.g.
+     * `'application/vnd.plotly.v1+json'` or
+     * `'application/vnd.plotly.v1+json, application/vnd.vega.v5+json'`).
+     * Stored verbatim; splitting happens at lookup time.
+     */
+    contentType: string;
+    /** Absolute HTTP(S) URL of the visualizer iframe. */
+    url: string;
+    /** Milliseconds to wait for a `send()` request's `/RESPONSE` before rejecting. Defaults to `10000`. Does NOT bound the initial handshake. */
+    requestTimeout?: number;
+    /** Suggested initial width of the canvas panel in pixels. Forwarded as-is in `CustomVisualizerDataLayout`. */
+    width?: number;
+    /** Suggested initial height of the canvas panel in pixels. Forwarded as-is in `CustomVisualizerDataLayout`. */
+    height?: number;
+    /** Suggested canvas panel height on mobile viewports in pixels. Forwarded as-is in `CustomVisualizerDataLayout`. */
+    mobileHeight?: number;
+    /** Whether the host should pass auth info to the visualizer. Accepted for schema parity with development but auth forwarding is not yet wired. */
+    passAuthInfo?: boolean;
+    /** Whether the host should pass an explicit access token. Accepted for schema parity with development but auth forwarding is not yet wired. */
+    passExplicitToken?: boolean;
+}
+/** Presentation-only layout hints forwarded to the visualizer inside `SEND_VISUALIZE_DATA`. */
+export interface CustomVisualizerDataLayout {
+    /** Suggested width of the canvas panel in pixels (from the registry entry). */
+    width?: number;
+    /** Suggested height of the canvas panel in pixels (from the registry entry). */
+    height?: number;
+    /** Suggested height on mobile-sized screens in pixels (from the registry entry). */
+    mobileHeight?: number;
+    /** Id of the host's currently active theme. */
+    themeId: string;
+}
+/** Payload of a `SEND_VISUALIZE_DATA` request: presentation layout plus the opaque attachment payload. */
+export interface CustomVisualizerData {
+    /** Presentation layout hints. */
+    layout: CustomVisualizerDataLayout;
+    /** Opaque attachment payload consumed by the third-party visualizer. */
+    [key: string]: unknown;
+}
+//# sourceMappingURL=custom-visualizer.d.ts.map

package/models/custom-visualizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-visualizer.d.ts","sourceRoot":"","sources":["../../src/models/custom-visualizer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,2HAA2H;IAC3H,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wHAAwH;IACxH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,6IAA6I;IAC7I,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,8GAA8G;IAC9G,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+GAA+G;IAC/G,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oHAAoH;IACpH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kJAAkJ;IAClJ,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+IAA+I;IAC/I,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,+FAA+F;AAC/F,MAAM,WAAW,0BAA0B;IACzC,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,0GAA0G;AAC1G,MAAM,WAAW,oBAAoB;IACnC,iCAAiC;IACjC,MAAM,EAAE,0BAA0B,CAAC;IACnC,wEAAwE;IACxE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/models/deployment-configuration.d.ts

@@ -0,0 +1,55 @@
+/** DIAL-specific options for a single starter button entry. */
+export interface StarterWidgetOptions {
+    /** Text to populate in the input field when the starter is selected. */
+    populateText: string | null;
+    /** When true, automatically submits the message after populating the input. */
+    submit: boolean;
+    /** Optional confirmation message shown before submission. */
+    confirmationMessage: string | null;
+}
+/** A quick-start conversation button entry in the `starter` property's `oneOf` array. */
+export interface StarterOption {
+    /** Numeric index used as the schema `const` value. */
+    const: number;
+    /** Display label for the starter button. */
+    title: string;
+    /** DIAL widget options controlling input population and auto-submit behaviour. */
+    'dial:widgetOptions': StarterWidgetOptions;
+}
+/** A single property entry in a deployment's configuration JSON Schema. */
+export interface DeploymentConfigurationSchemaProperty {
+    /** Default value for this property. */
+    default?: unknown;
+    /** Human-readable description of this property. */
+    description?: string;
+    /** DIAL-specific widget hint (e.g. "buttons"). */
+    'dial:widget'?: string;
+    /** List of allowed value variants (JSON Schema oneOf). For the `starter` property these are {@link StarterOption} entries. */
+    oneOf?: StarterOption[] | unknown[];
+    /** Index signature for additional JSON Schema keywords. */
+    [key: string]: unknown;
+}
+/**
+ * JSON Schema object returned by the DIAL Core deployment configuration endpoint
+ * (`GET /v1/deployments/{deployment_name}/configuration`).
+ * Only present for deployments whose `features.configuration` flag is `true`.
+ */
+export interface DeploymentConfigurationSchema {
+    /** JSON Schema type (typically "object"). */
+    type?: string;
+    /** Human-readable schema title. */
+    title?: string;
+    /** Whether additional properties are allowed, or a schema for them. */
+    additionalProperties?: boolean | Record<string, unknown>;
+    /** Named configuration properties supported by this deployment. */
+    properties?: Record<string, DeploymentConfigurationSchemaProperty>;
+    /**
+     * When `true`, the application does not accept free-form text input.
+     * Users interact only via form/action buttons defined in the schema.
+     * Mapped from `dial:chatMessageInputDisabled` by the backend.
+     */
+    isChatMessageInputDisabled?: boolean;
+    /** Index signature for additional JSON Schema keywords. */
+    [key: string]: unknown;
+}
+//# sourceMappingURL=deployment-configuration.d.ts.map

package/models/deployment-configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-configuration.d.ts","sourceRoot":"","sources":["../../src/models/deployment-configuration.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,MAAM,WAAW,oBAAoB;IACnC,wEAAwE;IACxE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,+EAA+E;IAC/E,MAAM,EAAE,OAAO,CAAC;IAChB,6DAA6D;IAC7D,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,yFAAyF;AACzF,MAAM,WAAW,aAAa;IAC5B,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,oBAAoB,EAAE,oBAAoB,CAAC;CAC5C;AAED,2EAA2E;AAC3E,MAAM,WAAW,qCAAqC;IACpD,uCAAuC;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8HAA8H;IAC9H,KAAK,CAAC,EAAE,aAAa,EAAE,GAAG,OAAO,EAAE,CAAC;IACpC,2DAA2D;IAC3D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC5C,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,oBAAoB,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzD,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,qCAAqC,CAAC,CAAC;IACnE;;;;OAIG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,2DAA2D;IAC3D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/models/deployment-features.d.ts

@@ -0,0 +1,17 @@
+/** Response format options for conversation messages. */
+export declare enum ResponseFormat {
+    /** Messages are rendered as Markdown. */
+    Markdown = "markdown",
+    /** Messages are rendered as plain text. */
+    PlainText = "plain_text"
+}
+/** Feature flags for a deployment, controlling which per-conversation settings are available. */
+export interface DeploymentFeatures {
+    /** Whether the deployment supports a custom system prompt. */
+    systemPrompt: boolean;
+    /** Whether the deployment supports temperature control. */
+    temperature: boolean;
+    /** Whether the deployment supports response format selection. */
+    responseFormat?: boolean;
+}
+//# sourceMappingURL=deployment-features.d.ts.map

package/models/deployment-features.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-features.d.ts","sourceRoot":"","sources":["../../src/models/deployment-features.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,oBAAY,cAAc;IACxB,yCAAyC;IACzC,QAAQ,aAAa;IACrB,2CAA2C;IAC3C,SAAS,eAAe;CACzB;AAED,iGAAiG;AACjG,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,YAAY,EAAE,OAAO,CAAC;IACtB,2DAA2D;IAC3D,WAAW,EAAE,OAAO,CAAC;IACrB,iEAAiE;IACjE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B"}

package/models/deployment.d.ts

@@ -0,0 +1,31 @@
+import { DeploymentFeatures } from './deployment-features';
+/** A host-agnostic view model for a single deployment shown in UI components. */
+export interface DeploymentItem {
+    /** Unique stable identifier from DIAL Core. */
+    id: string;
+    /** Human-readable display name. Falls back to `id` when absent. */
+    displayName?: string;
+    /** URL-safe icon reference. Resolved to a usable `<img src>` by the host app before passing. */
+    iconUrl?: string;
+    /** Deployment kind — used to choose a fallback icon. Typically `'model'` or `'application'`. */
+    type?: string;
+    /** MIME types accepted as input attachments (e.g. `['audio/*', 'image/*']`). Undefined when not specified by DIAL Core. */
+    inputAttachmentTypes?: string[];
+    /** Feature flags for this deployment, controlling which per-conversation settings are available. */
+    features?: DeploymentFeatures;
+    /** Maximum number of attachments allowed per message. Undefined when not specified by DIAL Core. */
+    maxInputAttachments?: number;
+    /** Human-readable description of the deployment. */
+    description?: string;
+    /** Timestamp of last update time from DIAL Core (e.g. 1714768496000). */
+    updatedAt?: number;
+    /** Display version string. */
+    displayVersion?: string;
+    /** Whether this deployment is featured (configured via env). */
+    isFeatured?: boolean;
+    /** Whether this deployment is hidden (configured via env). */
+    isHidden?: boolean;
+    /** Topics associated with the deployment. */
+    topics?: string[];
+}
+//# sourceMappingURL=deployment.d.ts.map

package/models/deployment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment.d.ts","sourceRoot":"","sources":["../../src/models/deployment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,EAAE,EAAE,MAAM,CAAC;IACX,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gGAAgG;IAChG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gGAAgG;IAChG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2HAA2H;IAC3H,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,oGAAoG;IACpG,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B,oGAAoG;IACpG,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8BAA8B;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/models/dial-model.d.ts

@@ -0,0 +1,19 @@
+/** A model entry as returned by the DIAL Core `/v1/models` endpoint. */
+export interface DialModel {
+    /** Unique model identifier used in API calls. */
+    id: string;
+    /** Discriminator — always `'model'`. */
+    object: string;
+    /** Unix timestamp (s) when the model was created. */
+    created?: number;
+    /** Identifier of the model owner/provider. */
+    owned_by?: string;
+    /** Index signature for additional provider-specific fields. */
+    [key: string]: unknown;
+}
+/** Response envelope for the DIAL Core model-listing endpoint. */
+export interface DialModelListResponse {
+    /** List of available models. */
+    data: DialModel[];
+}
+//# sourceMappingURL=dial-model.d.ts.map

package/models/dial-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dial-model.d.ts","sourceRoot":"","sources":["../../src/models/dial-model.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,MAAM,WAAW,SAAS;IACxB,iDAAiD;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,kEAAkE;AAClE,MAAM,WAAW,qBAAqB;IACpC,gCAAgC;IAChC,IAAI,EAAE,SAAS,EAAE,CAAC;CACnB"}

package/models/entity.d.ts

@@ -0,0 +1,15 @@
+import { CatalogEntityType } from '../types/entity-type';
+/** Minimal entity identity fields rendered by `EntityHeader`. */
+export interface EntityHeaderItem {
+    /** Entity category. */
+    type: CatalogEntityType;
+    /** Display name. */
+    name: string;
+    /** Version string shown next to the name. */
+    version: string;
+    /** URL of the icon displayed inside the logo mark. */
+    iconUrl?: string;
+    /** Whether the entity is marked as featured. */
+    isFeatured?: boolean;
+}
+//# sourceMappingURL=entity.d.ts.map

package/models/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../src/models/entity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,iEAAiE;AACjE,MAAM,WAAW,gBAAgB;IAC/B,uBAAuB;IACvB,IAAI,EAAE,iBAAiB,CAAC;IACxB,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB"}

package/models/import-export.d.ts

@@ -0,0 +1,23 @@
+import { Conversation } from './chat';
+/** A minimal conversation-folder record carried in an export file. */
+export interface ExportFolder {
+    /** Unique folder identifier. */
+    id: string;
+    /** Display name of the folder. */
+    name: string;
+    /** Identifier of the parent folder, if nested. */
+    folderId?: string;
+}
+/**
+ * Versioned JSON envelope produced by conversation export, and read back on
+ * import.
+ */
+export interface ExportFormat {
+    /** Format version discriminator. Only `5` is currently produced or accepted. */
+    version: 5;
+    /** Exported conversations. */
+    history: Conversation[];
+    /** Folders the exported conversations belong to. */
+    folders: ExportFolder[];
+}
+//# sourceMappingURL=import-export.d.ts.map

package/models/import-export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-export.d.ts","sourceRoot":"","sources":["../../src/models/import-export.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,sEAAsE;AACtE,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,gFAAgF;IAChF,OAAO,EAAE,CAAC,CAAC;IACX,8BAA8B;IAC9B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,oDAAoD;IACpD,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB"}

package/models/locale.d.ts

@@ -0,0 +1,19 @@
+/** One additional (non-primary) locale's translation of an entity's name and description. */
+export interface LocalizedTextEntry {
+    /** Stable client-side id for list rendering; not part of the persisted locale map. */
+    id: string;
+    /** Locale code this entry translates into (e.g. `'de'`). */
+    language: string;
+    /** Translated name for this locale. */
+    name: string;
+    /** Translated description for this locale. */
+    description: string;
+}
+/** A selectable language option for an additional-locale row. */
+export interface LocaleOption {
+    /** Locale code (e.g. `'de'`). */
+    code: string;
+    /** Display label for the option (e.g. `'DE'`). */
+    label: string;
+}
+//# sourceMappingURL=locale.d.ts.map

package/models/locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../src/models/locale.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,MAAM,WAAW,kBAAkB;IACjC,sFAAsF;IACtF,EAAE,EAAE,MAAM,CAAC;IACX,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,iEAAiE;AACjE,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;CACf"}

package/models/text-refinement.d.ts

@@ -0,0 +1,18 @@
+/** Translatable copy for `TextRefinementField`; every key has an English default. */
+export interface TextRefinementLabels {
+    /** Refinement copy. Defaults to 'Refine with AI'. */
+    refineWithAiLabel?: string;
+    /** Refinement copy. Defaults to 'Undo'. */
+    refineUndoLabel?: string;
+    /** Refinement copy. Defaults to 'Could not refine this text. Please try again.'. */
+    refineErrorLabel?: string;
+    /** Refinement copy. Defaults to 'Refining text'. */
+    refinePendingAriaLabel?: string;
+    /** Refinement copy. Defaults to 'Text refined. Undo is available.'. */
+    refineSuccessAriaLabel?: string;
+    /** Refinement copy. Defaults to 'Original text restored.'. */
+    refineUndoAriaLabel?: string;
+    /** Refinement copy. Defaults to 'No changes were needed.'. */
+    refineUnchangedAriaLabel?: string;
+}
+//# sourceMappingURL=text-refinement.d.ts.map

package/models/text-refinement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-refinement.d.ts","sourceRoot":"","sources":["../../src/models/text-refinement.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oFAAoF;IACpF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oDAAoD;IACpD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,uEAAuE;IACvE,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,8DAA8D;IAC9D,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC"}

package/models/theme.d.ts

@@ -0,0 +1,36 @@
+/** Root theme configuration loaded from the server at startup. */
+export interface ThemeConfiguration {
+    /** Available themes the user can switch between. */
+    themes: Theme[];
+    /** Global image/icon assets shared across all themes. */
+    images: ThemeImages;
+}
+/**
+ * Theme-specific images and icons
+ */
+export interface ThemeImages {
+    /** Fallback icon URL used when an add-on has no custom image. */
+    'default-addon': string;
+    /** Fallback icon URL used when a model has no custom image. */
+    'default-model': string;
+    /** Browser tab favicon URL. */
+    favicon: string;
+    /** Light theme logo URL */
+    'chat-logo-light'?: string;
+    /** Dark theme logo URL */
+    'chat-logo-dark'?: string;
+    /** Dynamic favicon URL (PNG format, 32x32 recommended) */
+    'chat-favicon'?: string;
+}
+/** A single selectable UI theme. */
+export interface Theme {
+    /** Unique theme identifier (e.g. `'dark'`, `'light'`). */
+    id: string;
+    /** Human-readable name shown in the theme picker. */
+    displayName: string;
+    /** CSS custom-property overrides keyed by variable name (without `--` prefix). */
+    colors: Record<string, string>;
+    /** URL of the application logo asset for this theme. */
+    'app-logo': string;
+}
+//# sourceMappingURL=theme.d.ts.map

package/models/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/models/theme.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,yDAAyD;IACzD,MAAM,EAAE,WAAW,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iEAAiE;IACjE,eAAe,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,eAAe,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,0BAA0B;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,oCAAoC;AACpC,MAAM,WAAW,KAAK;IACpB,0DAA0D;IAC1D,EAAE,EAAE,MAAM,CAAC;IACX,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/models/tool-menu-item.d.ts

@@ -0,0 +1,13 @@
+import { ReactNode } from 'react';
+/** Resolved tool toggle item rendered in the conversation input tools submenu. */
+export interface ToolMenuItem {
+    /** Unique tool identifier matching the deployment configuration schema property key. */
+    id: string;
+    /** Human-readable label displayed next to the tool icon. */
+    label: string;
+    /** Icon element rendered inline before the label. */
+    icon: ReactNode;
+    /** Whether the tool is currently toggled on. */
+    isSelected: boolean;
+}
+//# sourceMappingURL=tool-menu-item.d.ts.map

package/models/tool-menu-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-menu-item.d.ts","sourceRoot":"","sources":["../../src/models/tool-menu-item.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,kFAAkF;AAClF,MAAM,WAAW,YAAY;IAC3B,wFAAwF;IACxF,EAAE,EAAE,MAAM,CAAC;IACX,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,IAAI,EAAE,SAAS,CAAC;IAChB,gDAAgD;IAChD,UAAU,EAAE,OAAO,CAAC;CACrB"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@epam/ai-dial-chat-shared",
   "description": "Shared domain models, utilities, and UI components for AI DIAL Chat libraries",
-  "version": "1.3.0-dev.34",
+  "version": "1.3.0-dev.37",
   "license": "Apache-2.0",
   "type": "module",
   "sideEffects": [

package/types/attachment.d.ts

@@ -0,0 +1,25 @@
+/** 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",
+    /** File size exceeds the configured maximum attachment size. */
+    FileTooLarge = "file-too-large"
+}
+/** 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;IACpC,gEAAgE;IAChE,YAAY,mBAAmB;CAChC;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/entity-type.d.ts

@@ -0,0 +1,10 @@
+/** Entity type for a catalog item. Values are uppercase for direct color-map lookup. */
+export declare enum CatalogEntityType {
+    Model = "MODEL",
+    Agent = "AGENT",
+    Toolset = "TOOLSET",
+    Skill = "SKILL",
+    /** Reusable text prompt. Carries a body instead of a runtime. */
+    Prompt = "PROMPT"
+}
+//# sourceMappingURL=entity-type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entity-type.d.ts","sourceRoot":"","sources":["../../src/types/entity-type.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,oBAAY,iBAAiB;IAC3B,KAAK,UAAU;IACf,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,iEAAiE;IACjE,MAAM,WAAW;CAClB"}

package/types/file-manager-node.d.ts

@@ -0,0 +1,17 @@
+import { DialFileNodeType } from '@epam/ai-dial-react-file-manager';
+/**
+ * Minimal node shape file-manager selection predicates are evaluated against.
+ * Satisfied by both grid rows and `DialFile` controller items, so one
+ * predicate can gate manual grid clicks and programmatic selection changes.
+ */
+export interface FileManagerSelectableNode {
+    /** Virtual path of the node. */
+    path: string;
+    /** Distinguishes folders from files. */
+    nodeType: DialFileNodeType;
+    /** MIME type of a file node, when known. */
+    contentType?: string;
+    /** Size in bytes of a file node, when known. */
+    contentLength?: number;
+}
+//# sourceMappingURL=file-manager-node.d.ts.map

package/types/file-manager-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-manager-node.d.ts","sourceRoot":"","sources":["../../src/types/file-manager-node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/types/mime-type.d.ts

@@ -0,0 +1,59 @@
+/** Well-known MIME type constants used in DIAL API attachments. */
+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",
+    /** MPEG audio (`.mp3`). */
+    MP3 = "audio/mpeg",
+    /** WAV audio. */
+    WAV = "audio/wav",
+    /** Ogg audio. */
+    OGG = "audio/ogg"
+}
+/** Well-known file extension constants used as fallback when a MIME type is unavailable. */
+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,mEAAmE;AACnE,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;IAGrB,2BAA2B;IAC3B,GAAG,eAAe;IAClB,iBAAiB;IACjB,GAAG,cAAc;IACjB,iBAAiB;IACjB,GAAG,cAAc;CAClB;AAED,4FAA4F;AAC5F,oBAAY,aAAa;IACvB,oBAAoB;IACpB,GAAG,QAAQ;IACX,iCAAiC;IACjC,QAAQ,OAAO;IACf,4DAA4D;IAC5D,WAAW,aAAa;IACxB,qBAAqB;IACrB,IAAI,SAAS;CACd"}

package/utils/annotation.d.ts

@@ -0,0 +1,29 @@
+import { Annotation, AnnotationSelector } from '../models/annotation';
+import { MessageAttachment } from '../models/chat';
+/** Returns whether `value` is shaped like an annotation selector. */
+export declare const isAnnotationSelector: (value: unknown) => value is AnnotationSelector;
+/**
+ * Repairs persisted `html_tag` annotations created by older normalizers that
+ * defaulted every non-HTML source to PDF. An explicit, recognized file
+ * extension is more reliable than that historical fallback; opaque URLs keep
+ * their stored type so genuine PDF citations without an extension still work.
+ */
+export declare const normalizePersistedHtmlTagAttachmentType: (annotation: Annotation) => Annotation;
+/**
+ * Normalizes raw annotations from the API wire format (stored in
+ * `message.custom_fields.annotations`) to the internal `Annotation` model.
+ *
+ * Recognizes two wire shapes:
+ * - `target.source.attachment_index` (integer) + a `pdf_region` selector
+ *   with `{ left, top, width, height }` coordinates, resolved against
+ *   `attachments` and converted to `body.source.attachment.url` + a
+ *   `pdf_bbox` selector with `{ x1, y1, x2, y2 }` coordinates.
+ * - `target.selector` of type `html_tag` (`{ tag, id }`) with a flat
+ *   `body.source = { type: 'attachment', url }` — normalized to
+ *   `body.source.attachment.url`/`.title` directly, with no attachment-list
+ *   lookup, preserving optional indexes and document selectors.
+ *
+ * Annotations matching neither shape are omitted from the result.
+ */
+export declare const normalizeRawAnnotations: (rawAnnotations: unknown[], attachments: MessageAttachment[]) => Annotation[];
+//# sourceMappingURL=annotation.d.ts.map

package/utils/annotation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotation.d.ts","sourceRoot":"","sources":["../../src/utils/annotation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAGnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAmCxD,qEAAqE;AACrE,eAAO,MAAM,oBAAoB,GAC/B,OAAO,OAAO,KACb,KAAK,IAAI,kBAKoB,CAAC;AAmJjC;;;;;GAKG;AACH,eAAO,MAAM,uCAAuC,GAClD,YAAY,UAAU,KACrB,UAsBF,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,uBAAuB,GAClC,gBAAgB,OAAO,EAAE,EACzB,aAAa,iBAAiB,EAAE,KAC/B,UAAU,EAeT,CAAC"}

package/utils/avatar-color.d.ts

@@ -0,0 +1,10 @@
+/** A background/foreground colour pair for an initials avatar badge. */
+export interface AvatarColorEntry {
+    /** CSS colour value for the badge background — a theme token with a hex fallback. */
+    background: string;
+    /** CSS colour value for the initials text — a theme token with a hex fallback. */
+    foreground: string;
+}
+/** Returns a deterministic colour-pair for the given display name. */
+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,qFAAqF;IACrF,UAAU,EAAE,MAAM,CAAC;IACnB,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;CACpB;AAsCD,sEAAsE;AACtE,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,gBAM9C,CAAC"}

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

@@ -0,0 +1,4 @@
+import { CSSProperties } from 'react';
+/** Builds a `CSSProperties` object from a record of CSS custom property names to values, omitting entries with `undefined` or empty-string values. */
+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,sJAAsJ;AACtJ,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,18 @@
+/**
+ * Renders markdown to sanitized HTML whose styling travels inline, so a
+ * rich-text target it is pasted into shows the tables, headings, and code
+ * blocks the way the conversation does.
+ */
+export declare const markdownToRichTextHtml: (content: string) => string;
+/**
+ * Copies markdown `content` to the clipboard as rich text, so pasting into a
+ * rich-text target (Word, Gmail, Slack) keeps the formatting. Both the
+ * `text/html` and the `text/plain` flavour are written, so a plain-text
+ * target (Notepad, a terminal, a code editor) pastes the raw markdown instead
+ * of nothing. Falls back to {@link copyToClipboard}, and therefore to the raw
+ * markdown, when the multi-format Clipboard API isn't available.
+ */
+export declare const copyMarkdownAsRichText: (content: string) => Promise<boolean>;
+/** Copies `text` to the clipboard; returns `true` on success, `false` when both the Clipboard API and the `execCommand` fallback fail. */
+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":"AA+HA;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,MAAM,KAAG,MAUtD,CAAC;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,MAAM,KAAG,OAAO,CAAC,OAAO,CAoCvE,CAAC;AAEF,0IAA0I;AAC1I,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,OAAO,CAAC,OAAO,CAY7D,CAAC"}

package/utils/entity-field-limits.d.ts

@@ -0,0 +1,11 @@
+/** Maximum length of an entity's name or display name. */
+export declare const ENTITY_NAME_MAX_LENGTH = 256;
+/** Maximum length of an entity's description. */
+export declare const ENTITY_DESCRIPTION_MAX_LENGTH = 2000;
+/** Maximum length of an entity's instructions (prompt body, system prompt, skill instructions). */
+export declare const ENTITY_INSTRUCTIONS_MAX_LENGTH = 50000;
+/** Whether `value` is longer than `maxLength` characters. */
+export declare const exceedsMaxLength: (value: string, maxLength: number) => boolean;
+/** Whether `value` contains a control character (line break, tab, NUL, …) that a single-line name must not carry. */
+export declare const hasControlCharacters: (value: string) => boolean;
+//# sourceMappingURL=entity-field-limits.d.ts.map

package/utils/entity-field-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-field-limits.d.ts","sourceRoot":"","sources":["../../src/utils/entity-field-limits.ts"],"names":[],"mappings":"AAOA,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,iDAAiD;AACjD,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAElD,mGAAmG;AACnG,eAAO,MAAM,8BAA8B,QAAQ,CAAC;AAIpD,6DAA6D;AAC7D,eAAO,MAAM,gBAAgB,GAAI,OAAO,MAAM,EAAE,WAAW,MAAM,KAAG,OAC1C,CAAC;AAE3B,qHAAqH;AACrH,eAAO,MAAM,oBAAoB,GAAI,OAAO,MAAM,KAAG,OACd,CAAC"}