@epam/ai-dial-chat-hooks 1.2.0-dev.99 → 1.2.0-rc.0

package/conversation.d.ts

@@ -215,6 +215,7 @@ export declare interface ChatStreamApi {
     stopCompletion: (dto: {
         generationId: string;
         path: string;
+        content?: string;
     }) => Promise<void>;
 }
 
@@ -297,7 +298,7 @@ export declare interface ConversationStreamOverlayNotifier {
 }
 
 /** The exact `startStream` shape `useConversationStream` returns. */
-export declare type ConversationStreamStarter = (conversationPath: string, userContent: string, messageIndex: number, model: string, customContent?: MessageCustomContent, generationId?: string, mode?: SendCompletionDtoModeEnum) => void;
+export declare type ConversationStreamStarter = (conversationPath: string, userContent: string, messageIndex: number, model: string, customContent?: MessageCustomContent, generationId?: string, mode?: SendCompletionDtoModeEnum, options?: StartStreamOptions) => void;
 
 /**
  * Host-owned transport for the DIAL Core completion protocol. Implemented at
@@ -307,10 +308,14 @@ export declare type ConversationStreamStarter = (conversationPath: string, userC
 export declare interface ConversationStreamTransport {
     /** Starts a completion; delivers chunks/completion/error through `options`, aborted via `options.signal`. */
     streamCompletion(path: string, message: string | undefined, model: string, options: StreamCompletionOptions, customContent?: MessageCustomContent, generationId?: string, mode?: SendCompletionDtoModeEnum, messageIndex?: number, clientChannelId?: string): void;
-    /** Requests the backend stop an active generation. */
+    /**
+     * Requests the backend stop an active generation. `content` is the answer text shown
+     * so far; the backend saves it for a generation whose text it does not hold.
+     */
     stopCompletion(params: {
         generationId: string;
         path: string;
+        content?: string;
     }): Promise<void>;
     /** Opens a stream of resource-update events for `path`, until aborted via `signal`. */
     watchConversation(path: string, signal: AbortSignal): Promise<ReadableStream<Uint8Array>>;
@@ -347,6 +352,12 @@ export declare interface CreateChatStreamApiDeps {
     getTimezone?: () => string | undefined;
     /** `fetch` implementation to issue requests through. Defaults to the global `fetch`. */
     fetchImpl?: typeof fetch;
+    /**
+     * How long an open completion stream may go without receiving a byte
+     * (keepalive comments included) before it is reported as a
+     * {@link StreamInterruptedError}. Defaults to {@link DEFAULT_STREAM_IDLE_TIMEOUT_MS}.
+     */
+    idleTimeoutMs?: number;
 }
 
 /**
@@ -361,6 +372,11 @@ export declare const createMessagePair: (content: string, customContent?: Messag
 /** Fallback text of a {@link GenerationConflictError} when no message is supplied. */
 export declare const DEFAULT_GENERATION_CONFLICT_MESSAGE = "A response is already being generated in this conversation. Wait for it to finish or stop it before sending another message.";
 
+/** Safe fallback for hosts that do not supply a translated persistence warning. */
+export declare const DEFAULT_GENERATION_PERSISTENCE_ERROR_MESSAGE = "The response could not be saved. It is still shown here, but may be lost if you reload or leave this page. Copy it before continuing.";
+
+export declare const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 45000;
+
 /**
  * Derives the row-action visibility state for a single conversation item.
  *
@@ -376,6 +392,12 @@ export declare const DEFAULT_GENERATION_CONFLICT_MESSAGE = "A response is alread
  */
 export declare const deriveConversationRowActionState: (item: Pick<ConversationListItemDto, "sharedWithMe" | "publishedWithMe" | "isReadonly">, publishHistory: PublishHistoryEntry[] | undefined, recipients: RecipientsCountEntry) => ConversationRowActionState;
 
+/**
+ * Returns the deployment a conversation belongs to, resolved from its id
+ * alone, or `undefined` when no candidate matches `deployments`.
+ */
+export declare const findDeploymentForConversationId: (deployments: DeploymentItemDto[], conversationId: string) => DeploymentItemDto | undefined;
+
 /**
  * Normalises a version string for display. The server falls back to a bare
  * `package.json` version (`0.45.0`), while a CI-supplied `CHAT_VERSION` is
@@ -395,6 +417,12 @@ export declare class GenerationConflictError extends Error {
     constructor(message?: string);
 }
 
+/** Identifies a failed terminal save independently of the model's generation outcome. */
+export declare class GenerationPersistenceError extends Error {
+    static readonly type = "conversation_save_failed";
+    constructor();
+}
+
 /**
  * Strips the leading bucket segment from a conversation id and decodes any
  * already-percent-encoded remainder back to raw, so callers that re-encode
@@ -407,6 +435,21 @@ export declare const getConversationPath: (conversationId: string) => string;
  */
 export declare const getConversationSource: (item: Pick<ConversationListItemDto, "sharedWithMe" | "publishedWithMe">) => FilterTab;
 
+/**
+ * Returns the tool values the conversation's last message sets through its
+ * `form_schema`, restricted to `toolIds`, plus a key identifying that exact
+ * application. `undefined` when the last message is not an assistant message
+ * or sets no known tool.
+ *
+ * Streamed chunks and reloads re-create an identical `form_schema`; comparing
+ * keys rather than object identity applies an app's value once and leaves a
+ * later user toggle alone until the app sends a different value.
+ */
+export declare const getFormSchemaToolSyncKey: (conversationId: string, messages: Message[], toolIds: readonly string[]) => {
+    key: string;
+    values: Record<string, boolean>;
+} | undefined;
+
 /**
  * Returns the deployment the conversation was last running on: scanning
  * backwards, the `new_deployment_id` of a `model_changed` status message or
@@ -417,7 +460,7 @@ export declare const getConversationSource: (item: Pick<ConversationListItemDto,
  * an edit truncates past one: the marker is appended at the end of the
  * timeline, so truncating at an earlier message drops it, and the model the
  * user picked reverted on the next page load even though the answer had been
- * regenerated on it (issue #8712). The assistant message the backend writes
+ * regenerated on it ([#8712](https://github.com/epam/ai-dial-chat/issues/8712)). The assistant message the backend writes
  * carries the deployment that produced it, which survives that truncation
  * because it *is* the regenerated message.
  */
@@ -430,6 +473,21 @@ export declare const getLastDeploymentId: (messages: Message[]) => string | null
  */
 export declare const getLastUserMessageToolConfiguration: (messages: Message[]) => Record<string, unknown> | undefined;
 
+/**
+ * Returns the tool configuration a (re-)loaded conversation should show: the
+ * last user message's `configuration_value`, overlaid in order by the
+ * `form_schema` values of the assistant messages after it. An app that turned
+ * a toggle off in its final response must not see it re-armed on reload just
+ * because the user message that started the run had it on.
+ */
+export declare const getLatestToolConfiguration: (messages: Message[]) => Record<string, unknown> | undefined;
+
+/**
+ * Returns every deployment id a conversation id may belong to, longest first,
+ * or an empty array when the format is unrecognised.
+ */
+export declare const getModelIdCandidatesFromConversationId: (id: string) => string[];
+
 /**
  * Extracts the deployment/model ID from a DIAL Core conversation ID.
  *
@@ -513,6 +571,15 @@ export declare const getStarterSubmitText: (starter: StarterOption, description?
  */
 export declare const getTimeOfDayGreeting: (hour: number, translations: GreetingTranslations, firstName?: string) => string;
 
+/**
+ * Returns the boolean values an assistant message's `form_schema` sets, keyed
+ * by property name, or `undefined` when no property resolves to a boolean.
+ * Lets a DIAL app switch a tools-menu toggle (e.g. `deep_research`) per
+ * message — on while a run is in progress, off once its result is delivered.
+ * Not filtered by tool id: `restoreToolConfiguration` ignores unknown ids.
+ */
+export declare const getToolConfigurationFromFormSchema: (formSchema: DeploymentConfigurationSchema | undefined) => Record<string, boolean> | undefined;
+
 /** Pre-translated greeting phrase strings for each time-of-day period. */
 export declare interface GreetingTranslations {
     morningWithName: string;
@@ -546,11 +613,12 @@ export declare const hasStructuredAnnouncement: ({ title, description, }: Announ
 export declare const isAnswerIncomplete: (answer: Message | undefined) => boolean;
 
 /**
- * True when the conversation's last message is an unresolved assistant
- * placeholder: the backend only persists a conversation at generation start
- * (empty placeholder) and at generation end (final content, or a partial
- * flagged `streamErrorMessage`/`wasStoppedByUser`), so this shape means a
- * generation was still active elsewhere when the conversation was loaded.
+ * True when the conversation has a pending background message, or its last
+ * message is an unresolved assistant placeholder: the backend only persists a
+ * conversation at generation start (empty placeholder) and at generation end
+ * (final content, or a partial flagged `streamErrorMessage`/`wasStoppedByUser`).
+ * This can mean generation is still active elsewhere, or that its terminal save
+ * failed.
  */
 export declare const isAwaitingGenerationResume: (conversation: Conversation) => boolean;
 
@@ -593,9 +661,12 @@ declare interface LocalModeValues {
 }
 
 /**
- * Returns the normalized stages of a raw stage array or a message-like
- * payload (reading `custom_content.stages`, falling back to
- * `customContent.stages`), or `undefined` when there are none.
+ * Returns the normalized stages of a complete raw stage array or a
+ * message-like payload (reading `custom_content.stages`, falling back to
+ * `customContent.stages`), or `undefined` when there are none. An entry
+ * without an `index` takes its array position — the identity a complete
+ * non-streaming array's `parent_stage_index` refers to — while explicit
+ * (possibly sparse) indexes are kept. Not for partial stream deltas.
  */
 export declare const mapStages: (source: RawStage[] | RawStageSource | null | undefined) => Stage[] | undefined;
 
@@ -624,6 +695,20 @@ export declare interface MessagePair {
     assistantMessage: Message;
 }
 
+/** A stable snapshot of one eligible native text selection. */
+export declare interface MessageSelectionReplySnapshot {
+    /** Scope that owned the selection when it was captured. */
+    conversationId: string;
+    /** Message text root containing the captured range. */
+    body: HTMLDivElement;
+    /** Captured native range. */
+    range: Range;
+    /** Native selected text preserved for the generated file. */
+    text: string;
+    /** Visible fragment of the selected range. */
+    rect: DOMRect;
+}
+
 /**
  * Normalises a stored response-format string to the current enum. Legacy data
  * may contain `'Markdown'` or `'PlainText'` (capital-first) instead of the
@@ -667,6 +752,11 @@ export declare interface RawStage {
     tag?: string | null;
     /** Files produced or referenced by this stage. */
     attachments?: RawStageAttachment[] | null;
+    /**
+     * `index` of the parent stage (its array position in a complete unindexed
+     * array). Nullish means top level; `0` is a valid parent.
+     */
+    parent_stage_index?: number | null;
 }
 
 /**
@@ -753,6 +843,18 @@ export declare const shouldRerunGenerationOnEdit: (messages: Message[], messageI
 /** True when the first user/assistant exchange is complete and LLM naming may still run. */
 export declare const shouldWatchForDisplayNameUpdate: (conversation: Conversation) => boolean;
 
+/** Per-start options of {@link UseConversationStreamResult.startStream}. */
+export declare interface StartStreamOptions {
+    /**
+     * Treats a `GenerationConflictError` as "this turn is already being
+     * generated" — e.g. a page reloaded before that generation saved its start
+     * state — and joins the running generation instead of showing the conflict
+     * message, which remains the fallback. Only for a start that sends no new
+     * user text; a send the user typed must keep reporting the conflict.
+     */
+    resumeOnConflict?: boolean;
+}
+
 /** Options accepted by {@link ConversationStreamTransport.streamCompletion}. */
 export declare interface StreamCompletionOptions {
     onChunk: (chunk: StreamChunk) => void;
@@ -761,10 +863,34 @@ export declare interface StreamCompletionOptions {
     signal: AbortSignal;
 }
 
+/**
+ * Reported through `onError` when the network connection carrying a
+ * completion stream is lost (a rejected `fetch`, or a read that fails after a
+ * 2xx response) or goes silent past the idle timeout — what a laptop sleep or
+ * a phone lock mid-generation produces. The backend-owned generation may
+ * still be running, so the caller can recover it rather than treat the
+ * response as failed. `cause` holds the original error, when there is one.
+ */
+export declare class StreamInterruptedError extends Error {
+    constructor(cause?: unknown);
+}
+
+/**
+ * Reported through `onError` when DIAL Core itself signals a failure with an
+ * in-band `{ error: { message } }` SSE chunk. Its `message` is upstream text
+ * intended for the user, unlike a transport failure (failed `fetch`, non-OK
+ * status, broken stream), whose message is technical detail. A custom
+ * transport raises this for any user-facing upstream error text.
+ */
+export declare class StreamUpstreamError extends Error {
+    constructor(message: string);
+}
+
 /**
  * Returns a renderable `Stage` for one raw payload: `index` defaults to `0`,
  * `name` to `''`, an unrecognized `status` to `null` (still running), and
- * `content`/`tag`/`attachments` are passed through when present.
+ * `content`/`tag`/`attachments`/`parent_stage_index` are passed through when
+ * present (a parent of `0` included).
  */
 export declare const toStage: (stage: RawStage) => Stage;
 
@@ -784,7 +910,8 @@ export declare interface TranscribeWithDeploymentParams {
  * 1. If the active conversation is not present in the list, requests a
  *    refresh. The list and refresh callback are intentionally excluded from
  *    the dependency array to avoid a refresh-loop on every list update.
- * 2. Marks the active conversation as viewed whenever it or the list changes.
+ * 2. Marks the active conversation as viewed when its matching identity becomes
+ *    available. List refreshes and persistence rollback do not retry the write.
  */
 export declare const useActiveConversationSync: ({ activeConversationId, items, refreshConversations, markConversationViewed, conversationIdsMatch, toPanelConversationId, }: UseActiveConversationSyncParams) => string | undefined;
 
@@ -985,10 +1112,14 @@ export declare interface UseConversationLookupMapsParams {
  * Returns a memoised array whose shape is compatible with the conversation
  * panel's item contract. All app-specific concerns (icon URL resolution,
  * route generation, id normalisation) are injected via resolver callbacks.
+ *
+ * While every input except `items` is unchanged, a DTO that is referentially
+ * the same as in the previous render maps to the same item object, so a list
+ * change (or a navigation that re-derives the list) re-renders only the rows
+ * whose DTO actually changed.
  */
-export declare const useConversationPanelItems: ({ items, deployments, isDeploymentsLoading, toPanelConversationId, resolveIconUrl, resolveIconTooltip, resolveHref, resolveTaskBadge, }: UseConversationPanelItemsParams) => {
-    showTaskBadge?: boolean | undefined;
-    taskBadgeLabel?: string | undefined;
+export declare const useConversationPanelItems: ({ items, deployments, isDeploymentsLoading, toPanelConversationId, resolveIconUrl, resolveIconTooltip, resolveHref, resolveTaskPresentation, }: UseConversationPanelItemsParams) => {
+    leadingIcon?: ReactNode;
     isUnread?: boolean | undefined;
     id: string;
     title: string;
@@ -1024,11 +1155,12 @@ export declare interface UseConversationPanelItemsResolvers {
     /** Resolves the href to navigate to when the conversation row is clicked. */
     resolveHref: (panelConversationId: string) => string;
     /**
-     * Returns badge metadata for a scheduled-task conversation, or `undefined`
-     * when the item should not show a task badge.
+     * Returns the row presentation for a scheduled-task conversation — a
+     * host-rendered leading icon that replaces the deployment avatar, and the
+     * unread flag — or `undefined` for an ordinary conversation.
      */
-    resolveTaskBadge?: (item: ConversationListItemDto) => {
-        label: string;
+    resolveTaskPresentation?: (item: ConversationListItemDto) => {
+        leadingIcon?: ReactNode;
         isUnread: boolean;
     } | undefined;
 }
@@ -1041,7 +1173,7 @@ export declare interface UseConversationPanelItemsResolvers {
  * `transport`/`generation`/`channel`/`overlay` capabilities rather than any
  * app context or `server-api` import.
  */
-export declare const useConversationStream: ({ conversationId, state: { setConversation, conversationRef }, transport, generation: { startGeneration, completeGeneration }, channel, overlay, onStopError, generationConflictMessage, }: UseConversationStreamParams) => UseConversationStreamResult;
+export declare const useConversationStream: ({ conversationId, state: { setConversation, conversationRef }, transport, generation: { startGeneration, completeGeneration }, channel, overlay, onStopError, generationConflictMessage, generationPersistenceErrorMessage, onStreamError, batchChunksPerFrame, }: UseConversationStreamParams) => UseConversationStreamResult;
 
 /** Parameters for {@link useConversationStream}. */
 export declare interface UseConversationStreamParams {
@@ -1059,17 +1191,39 @@ export declare interface UseConversationStreamParams {
      * {@link DEFAULT_GENERATION_CONFLICT_MESSAGE}.
      */
     generationConflictMessage?: string;
+    /** Host-translated warning shown when the received answer could not be saved. */
+    generationPersistenceErrorMessage?: string;
+    /**
+     * Receives the original error of every failed stream. The hook shows only
+     * host-supplied or upstream-supplied text on the message bubble and hides
+     * transport detail (e.g. `Failed to fetch`), so this is where the host can
+     * still log or report the raw error.
+     */
+    onStreamError?: (error: Error) => void;
+    /**
+     * Coalesces the displayed chunk updates into one `setConversation` per
+     * animation frame. Chunks still reach the per-path buffer immediately, and
+     * any pending update is flushed before completion, error, stop, or a
+     * superseding generation. Defaults to `false` (one update per chunk).
+     */
+    batchChunksPerFrame?: boolean;
 }
 
 /** Return value of {@link useConversationStream}. */
 export declare interface UseConversationStreamResult {
-    startStream: (conversationId: string, userContent: string, messageIndex: number, model: string, customContent?: MessageCustomContent, generationId?: string, mode?: SendCompletionDtoModeEnum) => void;
+    startStream: (conversationId: string, userContent: string, messageIndex: number, model: string, customContent?: MessageCustomContent, generationId?: string, mode?: SendCompletionDtoModeEnum, options?: StartStreamOptions) => void;
     handleStop: () => void;
     resumeIfAwaitingGeneration: (currentConversationId: string, conversation: Conversation) => void;
     /** Restores the accumulated live assistant message when its conversation is loaded again before completion. */
     restoreBufferedGeneration: (currentConversationId: string, conversation: Conversation) => Conversation;
     isStreaming: boolean;
     canStopStreaming: boolean;
+    /** Whether the displayed conversation's terminal read failed. */
+    hasConversationReloadError: boolean;
+    /** Whether a retry of that read is in flight. */
+    isReloadingConversation: boolean;
+    /** Retries the failed read without saving or regenerating the answer. */
+    retryConversationReload: () => Promise<void>;
 }
 
 /**
@@ -1105,6 +1259,35 @@ export declare interface UseImportFilePickerResult {
     handleFileChange: (event: ChangeEvent<HTMLInputElement>) => void;
 }
 
+/**
+ * Captures eligible message text and creates Reply files for an existing composer
+ * attachment flow without acquiring host deployment, upload or localization knowledge.
+ */
+export declare const useMessageSelectionReply: ({ conversationId, enabled, droppedFiles, onDroppedFilesConsumed, }: UseMessageSelectionReplyParams) => {
+    contentRef: (node: HTMLDivElement | null) => (() => void) | undefined;
+    actionRef: RefObject<HTMLDivElement | null>;
+    selection: MessageSelectionReplySnapshot | null;
+    onReply: () => void;
+    dismiss: () => void;
+    pendingFiles: File[];
+    onFilesConsumed: () => void;
+    focusRequestId: number | undefined;
+    onAttachmentsChange: (attachments: Attachment[]) => void;
+    addedRevision: number;
+};
+
+/** Parameters accepted by {@link useMessageSelectionReply}. */
+export declare interface UseMessageSelectionReplyParams {
+    /** Identifier used to discard selection and queued files after a scope change. */
+    conversationId: string;
+    /** Whether the host currently permits a Reply attachment. */
+    enabled: boolean;
+    /** Files from the host's ordinary page-drop queue. */
+    droppedFiles: File[];
+    /** Acknowledges the captured page-drop batch after the composer accepts it. */
+    onDroppedFilesConsumed: () => void;
+}
+
 /**
  * Derives the tools submenu from the active deployment's configuration schema:
  * every boolean property becomes a toggle. Manages toggle state locally, resets

package/conversation.js

@@ -1,32 +1,33 @@
 import { buildAnnouncementSignature as e, hasAnnouncementContent as t, hasStructuredAnnouncement as n, sanitizeAnnouncementHtml as r, sanitizeAnnouncementMessageHtml as i } from "./conversation/announcement-message.js";
-import { DEFAULT_GENERATION_CONFLICT_MESSAGE as a, GenerationConflictError as o, createChatStreamApi as s } from "./conversation/create-chat-stream-api.js";
-import { shouldWatchForDisplayNameUpdate as c } from "./conversation/display-name-watch.js";
-import { formatAppVersion as l, sanitizeFooterHtml as u } from "./conversation/footer-message.js";
-import { getModelIdFromConversationId as d } from "./conversation/get-model-id-from-conversation-id.js";
-import { getTimeOfDayGreeting as f } from "./conversation/greeting.js";
-import { createDeploymentChangedMessage as p } from "./conversation/message-factory.js";
-import { getLastDeploymentId as m, getLastUserMessageToolConfiguration as h, isMessageStreaming as g, messageHasStages as _, normalizeResponseFormat as v } from "./conversation/message-utils.js";
-import { getQuickAppConversationStarters as y } from "./conversation/quick-app-conversation-starters.js";
-import { mapStages as b, toStage as x } from "./conversation/stage.js";
-import { getStarterPopulateText as S, getStartersFromSchema as C } from "./conversation/starter-option.js";
-import { deriveConversationRowActionState as w } from "./conversation/deriveConversationRowActionState/deriveConversationRowActionState.js";
-import { useActiveConversationSync as T } from "./conversation/useActiveConversationSync/useActiveConversationSync.js";
-import { useAsyncConfirmDialog as E } from "./conversation/useAsyncConfirmDialog/useAsyncConfirmDialog.js";
-import { useConversationLookupMaps as D } from "./conversation/useConversationLookupMaps/useConversationLookupMaps.js";
-import { getConversationSource as O, useConversationPanelItems as k } from "./conversation/useConversationPanelItems/useConversationPanelItems.js";
-import { useImportFilePicker as A } from "./conversation/useImportFilePicker/useImportFilePicker.js";
-import { useAttachmentUpload as j } from "./conversation/useAttachmentUpload/useAttachmentUpload.js";
-import { AudioTranscriptionError as M, AudioTranscriptionErrorReason as N } from "./conversation/useTranscribeAudio/audio-transcription-error.js";
-import { useTranscribeAudio as P } from "./conversation/useTranscribeAudio/useTranscribeAudio.js";
-import { attachmentToDto as F, attachmentsToDtos as I } from "./conversation/useConversationHandlers/attachment-to-dto.js";
-import { createMessagePair as L } from "./conversation/useConversationHandlers/message-factory.js";
-import { hasActiveToolConfig as R, isAnswerIncomplete as z, isMessageChanged as B, shouldRerunGenerationOnEdit as V } from "./conversation/useConversationHandlers/message-utils.js";
-import { getStarterConversationText as H, getStarterDisplayText as U, getStarterSubmitText as W } from "./conversation/useConversationHandlers/starter-option.js";
-import { getConversationPath as G } from "./conversation/useConversationStream/conversation-path.js";
-import { useConversationHandlers as K } from "./conversation/useConversationHandlers/useConversationHandlers.js";
-import { applyChunkToMessages as q, mergeStages as J } from "./conversation/useConversationStream/apply-chunk.js";
-import { isAwaitingGenerationResume as Y } from "./conversation/useConversationStream/generation-resume.js";
-import { useConversationStream as X } from "./conversation/useConversationStream/useConversationStream.js";
-import { useChatSettingsFormConfig as Z } from "./useChatSettingsFormConfig/useChatSettingsFormConfig.js";
-import { useToolsMenu as Q } from "./useToolsMenu/useToolsMenu.js";
-export { M as AudioTranscriptionError, N as AudioTranscriptionErrorReason, a as DEFAULT_GENERATION_CONFLICT_MESSAGE, o as GenerationConflictError, q as applyChunkToMessages, F as attachmentToDto, I as attachmentsToDtos, e as buildAnnouncementSignature, s as createChatStreamApi, p as createDeploymentChangedMessage, L as createMessagePair, w as deriveConversationRowActionState, l as formatAppVersion, G as getConversationPath, O as getConversationSource, m as getLastDeploymentId, h as getLastUserMessageToolConfiguration, d as getModelIdFromConversationId, y as getQuickAppConversationStarters, H as getStarterConversationText, U as getStarterDisplayText, S as getStarterPopulateText, W as getStarterSubmitText, C as getStartersFromSchema, f as getTimeOfDayGreeting, R as hasActiveToolConfig, t as hasAnnouncementContent, n as hasStructuredAnnouncement, z as isAnswerIncomplete, Y as isAwaitingGenerationResume, B as isMessageChanged, g as isMessageStreaming, b as mapStages, J as mergeStages, _ as messageHasStages, v as normalizeResponseFormat, r as sanitizeAnnouncementHtml, i as sanitizeAnnouncementMessageHtml, u as sanitizeFooterHtml, V as shouldRerunGenerationOnEdit, c as shouldWatchForDisplayNameUpdate, x as toStage, T as useActiveConversationSync, E as useAsyncConfirmDialog, j as useAttachmentUpload, Z as useChatSettingsFormConfig, K as useConversationHandlers, D as useConversationLookupMaps, k as useConversationPanelItems, X as useConversationStream, A as useImportFilePicker, Q as useToolsMenu, P as useTranscribeAudio };
+import { DEFAULT_GENERATION_CONFLICT_MESSAGE as a, DEFAULT_GENERATION_PERSISTENCE_ERROR_MESSAGE as o, DEFAULT_STREAM_IDLE_TIMEOUT_MS as s, GenerationConflictError as c, GenerationPersistenceError as l, StreamInterruptedError as u, StreamUpstreamError as d, createChatStreamApi as f } from "./conversation/create-chat-stream-api.js";
+import { shouldWatchForDisplayNameUpdate as p } from "./conversation/display-name-watch.js";
+import { formatAppVersion as m, sanitizeFooterHtml as h } from "./conversation/footer-message.js";
+import { findDeploymentForConversationId as g, getModelIdCandidatesFromConversationId as _, getModelIdFromConversationId as v } from "./conversation/get-model-id-from-conversation-id.js";
+import { getTimeOfDayGreeting as y } from "./conversation/greeting.js";
+import { createDeploymentChangedMessage as b } from "./conversation/message-factory.js";
+import { getFormSchemaToolSyncKey as x, getLastDeploymentId as S, getLastUserMessageToolConfiguration as C, getLatestToolConfiguration as w, getToolConfigurationFromFormSchema as T, isMessageStreaming as E, messageHasStages as D, normalizeResponseFormat as O } from "./conversation/message-utils.js";
+import { getQuickAppConversationStarters as k } from "./conversation/quick-app-conversation-starters.js";
+import { mapStages as A, toStage as j } from "./conversation/stage.js";
+import { getStarterPopulateText as M, getStartersFromSchema as N } from "./conversation/starter-option.js";
+import { deriveConversationRowActionState as P } from "./conversation/deriveConversationRowActionState/deriveConversationRowActionState.js";
+import { useActiveConversationSync as F } from "./conversation/useActiveConversationSync/useActiveConversationSync.js";
+import { useAsyncConfirmDialog as I } from "./conversation/useAsyncConfirmDialog/useAsyncConfirmDialog.js";
+import { useConversationLookupMaps as L } from "./conversation/useConversationLookupMaps/useConversationLookupMaps.js";
+import { getConversationSource as R, useConversationPanelItems as z } from "./conversation/useConversationPanelItems/useConversationPanelItems.js";
+import { useImportFilePicker as B } from "./conversation/useImportFilePicker/useImportFilePicker.js";
+import { useMessageSelectionReply as V } from "./conversation/useMessageSelectionReply/useMessageSelectionReply.js";
+import { useAttachmentUpload as H } from "./conversation/useAttachmentUpload/useAttachmentUpload.js";
+import { AudioTranscriptionError as U, AudioTranscriptionErrorReason as W } from "./conversation/useTranscribeAudio/audio-transcription-error.js";
+import { useTranscribeAudio as G } from "./conversation/useTranscribeAudio/useTranscribeAudio.js";
+import { attachmentToDto as K, attachmentsToDtos as q } from "./conversation/useConversationHandlers/attachment-to-dto.js";
+import { createMessagePair as J } from "./conversation/useConversationHandlers/message-factory.js";
+import { hasActiveToolConfig as Y, isAnswerIncomplete as X, isMessageChanged as Z, shouldRerunGenerationOnEdit as Q } from "./conversation/useConversationHandlers/message-utils.js";
+import { getStarterConversationText as $, getStarterDisplayText as ee, getStarterSubmitText as te } from "./conversation/useConversationHandlers/starter-option.js";
+import { getConversationPath as ne } from "./conversation/useConversationStream/conversation-path.js";
+import { useConversationHandlers as re } from "./conversation/useConversationHandlers/useConversationHandlers.js";
+import { applyChunkToMessages as ie, mergeStages as ae } from "./conversation/useConversationStream/apply-chunk.js";
+import { isAwaitingGenerationResume as oe } from "./conversation/useConversationStream/generation-resume.js";
+import { useConversationStream as se } from "./conversation/useConversationStream/useConversationStream.js";
+import { useChatSettingsFormConfig as ce } from "./useChatSettingsFormConfig/useChatSettingsFormConfig.js";
+import { useToolsMenu as le } from "./useToolsMenu/useToolsMenu.js";
+export { U as AudioTranscriptionError, W as AudioTranscriptionErrorReason, a as DEFAULT_GENERATION_CONFLICT_MESSAGE, o as DEFAULT_GENERATION_PERSISTENCE_ERROR_MESSAGE, s as DEFAULT_STREAM_IDLE_TIMEOUT_MS, c as GenerationConflictError, l as GenerationPersistenceError, u as StreamInterruptedError, d as StreamUpstreamError, ie as applyChunkToMessages, K as attachmentToDto, q as attachmentsToDtos, e as buildAnnouncementSignature, f as createChatStreamApi, b as createDeploymentChangedMessage, J as createMessagePair, P as deriveConversationRowActionState, g as findDeploymentForConversationId, m as formatAppVersion, ne as getConversationPath, R as getConversationSource, x as getFormSchemaToolSyncKey, S as getLastDeploymentId, C as getLastUserMessageToolConfiguration, w as getLatestToolConfiguration, _ as getModelIdCandidatesFromConversationId, v as getModelIdFromConversationId, k as getQuickAppConversationStarters, $ as getStarterConversationText, ee as getStarterDisplayText, M as getStarterPopulateText, te as getStarterSubmitText, N as getStartersFromSchema, y as getTimeOfDayGreeting, T as getToolConfigurationFromFormSchema, Y as hasActiveToolConfig, t as hasAnnouncementContent, n as hasStructuredAnnouncement, X as isAnswerIncomplete, oe as isAwaitingGenerationResume, Z as isMessageChanged, E as isMessageStreaming, A as mapStages, ae as mergeStages, D as messageHasStages, O as normalizeResponseFormat, r as sanitizeAnnouncementHtml, i as sanitizeAnnouncementMessageHtml, h as sanitizeFooterHtml, Q as shouldRerunGenerationOnEdit, p as shouldWatchForDisplayNameUpdate, j as toStage, F as useActiveConversationSync, I as useAsyncConfirmDialog, H as useAttachmentUpload, ce as useChatSettingsFormConfig, re as useConversationHandlers, L as useConversationLookupMaps, z as useConversationPanelItems, se as useConversationStream, B as useImportFilePicker, V as useMessageSelectionReply, le as useToolsMenu, G as useTranscribeAudio };

package/file-manager-canvas.d.ts

@@ -21,6 +21,9 @@ export declare const annotationToOoxmlCanvasContent: (annotation: Annotation, an
 /**
  * Builds a `PdfCanvasContent` for a PDF citation annotation, including highlights
  * for the clicked annotation's document within its citation group.
+ * When the clicked annotation has a page but no selector with valid geometry,
+ * an invisible page-anchor highlight is added and selected so the viewer
+ * still opens that page.
  * Returns `null` if the annotation has no PDF source attachment.
  */
 export declare const annotationToPdfCanvasContent: (annotation: Annotation, groups: AnnotationGroup[], resolvers: AttachmentCanvasUrlResolvers) => PdfCanvasContent | null;
@@ -37,6 +40,8 @@ export declare interface AttachmentCanvasUrlResolvers {
     resolveDialUrl: (attachment: DisplayAttachment) => string | undefined;
     /** Resolves a DIAL Core file id to a fetchable metadata URL (used for cache-freshness validation). */
     resolveDialFileMetadataUrl: (fileId: string) => string | undefined;
+    /** URL of a host-served bootstrap document that renders HTML with no download URL (inline `data`) under its own response CSP instead of the embedding page's — forwarded as `HtmlCanvasContent.srcdocHostUrl`. When omitted, that HTML renders via plain `srcdoc`. */
+    htmlSrcdocHostUrl?: string;
 }
 
 /** The type of content the canvas can display. */
@@ -127,10 +132,16 @@ export declare const hasAttachmentTextSource: (attachment: DisplayAttachment, re
 declare interface HtmlCanvasContent {
     /** Discriminates the content type to select the correct renderer. */
     type: AttachmentContentType.Html;
-    /** Full HTML text rendered via `srcdoc` in a sandboxed iframe. Used for file attachments. */
+    /** Full HTML text rendered via `srcdoc` in a sandboxed iframe. Populated only when no `url` is available (local, non-downloadable file attachments); when `url` is set, "View source" instead calls `resolveSourceText`. */
     srcdoc?: string;
-    /** External URL rendered via `src` in a sandboxed iframe. Used for external link sources. */
+    /** URL rendered via `src` in a sandboxed iframe when `srcdoc` is absent, or in preference to `srcdoc` when `isSameOriginUrl` is set. Also used as the download-button/"Open in new tab" target. */
     url?: string;
+    /** True when `url`'s origin matches the embedding document's own origin. Forces the iframe sandbox to omit `allow-same-origin` — granting it would let a same-origin framed document reach this page's own cookies/storage — and makes `src` take precedence over `srcdoc`; also skips the `contentDocument` block-detection check, since the iframe is intentionally opaque-origin either way. */
+    isSameOriginUrl?: boolean;
+    /** Lazily fetches the full HTML source text for the "View source" toggle. Used instead of an eagerly-populated `srcdoc` when `url` is set; absent when `srcdoc` is already populated. */
+    resolveSourceText?: () => Promise<string>;
+    /** Host-served bootstrap document used to render `srcdoc` without inheriting the embedding page's CSP. When set alongside `srcdoc`, the iframe loads this URL via `src` (still `sandbox="allow-scripts"`) and posts `{ type: HTML_PREVIEW_FRAME_RENDER_MESSAGE, html: srcdoc }` to it once loaded, so the HTML renders under that response's own policy. Ignored when `srcdoc` is absent or `isSameOriginUrl` selects `url`. */
+    srcdocHostUrl?: string;
 }
 
 /** Content payload for image attachments. */
@@ -189,7 +200,7 @@ declare interface OoxmlDocxHighlightLocation {
     path: number[];
     /** Inclusive start character offset within the story's matched text. */
     start: number;
-    /** Exclusive end character offset, already converted from the wire's inclusive `end`. */
+    /** Exclusive end character offset — the wire's `end`, already exclusive, copied through unchanged. */
     endExclusive: number;
     /** The cited text, compared against the text resolved over `[start, endExclusive)`. */
     text: string;
@@ -253,7 +264,7 @@ declare interface OoxmlPptxHighlightLocation {
     shapeId: string;
     /** Inclusive start character offset within the shape's matched text. */
     start: number;
-    /** Exclusive end character offset, already converted from the wire's inclusive `end`. */
+    /** Exclusive end character offset — the wire's `end`, already exclusive, copied through unchanged. */
     endExclusive: number;
     /** The cited text, compared against the text resolved over `[start, endExclusive)`. */
     text: string;
@@ -330,9 +341,18 @@ export declare const resolveGroupedVisualizerCanvasContent: (attachments: Displa
 
 /**
  * Resolves an HTML canvas content payload from a DisplayAttachment.
- * Fetches and inlines the HTML as `srcdoc` when the attachment has a download URL or inline data.
- * Returns `null` if no source is available, or an `ErrorCanvasContent` on fetch failure.
- * Rejects `srcdoc` payloads larger than 1 MiB to prevent browser truncation.
+ * When the attachment has a download URL, that URL is the primary render
+ * target so the preview loads via `src` and gets its own response-level CSP
+ * instead of inheriting the host document's — no HTML text is fetched up
+ * front; `resolveSourceText` fetches it lazily, only when the "View source"
+ * toggle is used, and rejects if that fetch fails. `isSameOriginUrl` reflects
+ * a real comparison against the embedding document's own origin.
+ * With no download URL (local file or inline data), falls back to `srcdoc`,
+ * rejecting payloads larger than 1 MiB to prevent browser truncation, and
+ * forwards `resolvers.htmlSrcdocHostUrl` so that HTML can still render under
+ * its own response-level CSP.
+ * Returns `null` if no source is available, or an `ErrorCanvasContent` when
+ * that fallback fetch fails.
  */
 export declare const resolveHtmlCanvasContent: (attachment: DisplayAttachment, resolvers: AttachmentCanvasUrlResolvers) => Promise<HtmlCanvasContent | ErrorCanvasContent | null>;