@epam/ai-dial-chat-hooks 1.2.0-dev.99 → 1.3.0-dev.5

package/index.d.ts

@@ -1,6 +1,7 @@
 import { Annotation } from '@epam/ai-dial-chat-shared';
 import { AnnotationGroup } from '@epam/ai-dial-quotations';
 import { ApplicationExternalServiceDto } from '@epam/ai-dial-chat-api-client';
+import { ApplicationSchemaSummaryDto } from '@epam/ai-dial-chat-api-client';
 import { ApplicationVisualizer } from '@epam/ai-dial-chat-shared';
 import { ArchiveItemDto } from '@epam/ai-dial-chat-api-client';
 import { Attachment } from '@epam/ai-dial-chat-shared';
@@ -10,6 +11,7 @@ import { AttachmentErrorReason } from '@epam/ai-dial-chat-shared';
 import { AttachmentResource } from '@epam/ai-dial-chat-shared';
 import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 import { CatalogContentTreeNode } from '@epam/ai-dial-catalog';
+import { CatalogCreateSearch } from '@epam/ai-dial-catalog';
 import { CatalogEntityType } from '@epam/ai-dial-chat-shared';
 import { CatalogItem } from '@epam/ai-dial-catalog';
 import { CatalogItemApiDetails } from '@epam/ai-dial-catalog';
@@ -37,8 +39,6 @@ import type { CustomVisualizerDataLayout } from '@epam/ai-dial-chat-shared';
 import { DeleteFilesResponseDto } from '@epam/ai-dial-chat-api-client';
 import { DeleteItemDto } from '@epam/ai-dial-chat-api-client';
 import { DeploymentConfigurationSchema } from '@epam/ai-dial-chat-shared';
-import { DeploymentCreationFormLocaleEntry } from '@epam/ai-dial-builder-form';
-import { DeploymentCreationFormLocaleOption } from '@epam/ai-dial-builder-form';
 import { DeploymentDetailsDto } from '@epam/ai-dial-chat-api-client';
 import { DeploymentFeatures } from '@epam/ai-dial-chat-shared';
 import { DeploymentItemDto } from '@epam/ai-dial-chat-api-client';
@@ -75,10 +75,10 @@ import { FileUploadStatus } from '@epam/ai-dial-chat-shared';
 import { FileUploadValidationResult } from '@epam/ai-dial-chat-shared';
 import { FilterChipItem } from '@epam/ai-dial-ui-kit';
 import { FilterTab } from '@epam/ai-dial-chat-shared';
-import { getParentFolderPath } from '@epam/ai-dial-chat-shared';
 import type { GroupedAttachmentItem } from '@epam/ai-dial-chat-shared';
 import { Implementation } from '@modelcontextprotocol/sdk/types.js';
 import type { InputHighlightData } from '@epam/pdf-highlighter-kit';
+import { LimitStatsDto } from '@epam/ai-dial-chat-api-client';
 import { ListFilesItemDto } from '@epam/ai-dial-chat-api-client';
 import { ListFilesResponseDto } from '@epam/ai-dial-chat-api-client';
 import { ListPublicFilesRequest } from '@epam/ai-dial-chat-api-client';
@@ -86,7 +86,9 @@ import { ListScheduledTaskRunsResponseDto } from '@epam/ai-dial-chat-api-client'
 import { ListScheduledTasksResponseDto } from '@epam/ai-dial-chat-api-client';
 import { ListScheduledTasksSortEnum } from '@epam/ai-dial-chat-api-client';
 import { ListSharedFilesRequest } from '@epam/ai-dial-chat-api-client';
+import { LocaleOption } from '@epam/ai-dial-chat-shared';
 import { LocaleTextEntryDto } from '@epam/ai-dial-chat-api-client';
+import { LocalizedTextEntry } from '@epam/ai-dial-chat-shared';
 import { McpAppToolSummaryDto } from '@epam/ai-dial-chat-api-client';
 import { McpUiHostContext } from '@mcp-ui/client';
 import { Message } from '@epam/ai-dial-chat-shared';
@@ -141,6 +143,7 @@ import { SkillEditorFileActions } from '@epam/ai-dial-skill-editor';
 import { SkillEditorValues } from '@epam/ai-dial-skill-editor';
 import { SkillFileBatchError } from '@epam/ai-dial-skill-editor';
 import { SkillFileListResponseDto } from '@epam/ai-dial-chat-api-client';
+import { SkillFileSourceEntry } from '@epam/ai-dial-skill-editor';
 import { SkillFileTreeNode } from '@epam/ai-dial-skill-editor';
 import { SkillFileUploadCandidate } from '@epam/ai-dial-skill-editor';
 import { SkillFileValidationResult } from '@epam/ai-dial-skill-editor';
@@ -162,6 +165,7 @@ import { UpdateScheduledTaskBodyDto } from '@epam/ai-dial-chat-api-client';
 import { UploadArchiveResponseDto } from '@epam/ai-dial-chat-api-client';
 import { UploadedAttachmentResult } from '@epam/ai-dial-chat-shared';
 import { UsageLimitCardData } from '@epam/ai-dial-usage-dashboard';
+import { UsageLimitProgressRow } from '@epam/ai-dial-catalog';
 import { useGridEditingScroll } from '@epam/ai-dial-chat-shared';
 import { UseGridEditingScrollOptions } from '@epam/ai-dial-chat-shared';
 import { UseGridEditingScrollResult } from '@epam/ai-dial-chat-shared';
@@ -181,6 +185,7 @@ export declare interface AgentCapabilities {
     hasConfiguration?: boolean;
     hasChatCompletion?: boolean;
     hasResponsesApi?: boolean;
+    hasSkills?: boolean;
 }
 
 /** Input-attachment configuration for an agent (application) deployment. */
@@ -223,6 +228,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;
@@ -256,12 +264,24 @@ export declare interface AnnouncementListItemLink {
 
 /** Normalized shape returned by {@link getApiErrorDetails}. */
 export declare interface ApiErrorDetails {
+    /** Stable domain error code supplied by the API, when present. */
+    code?: string;
     /** HTTP status code carried by the error, when available. */
     status?: number;
     /** Resolved human-readable error message, or `null` when none could be resolved. */
     message: string | null;
     /** Extracted W3C trace ID, when the error's response carries a valid `traceparent`. */
     traceId?: string;
+    /**
+     * Error code reported by the service behind the API, when the API forwards one
+     * (`upstreamCode`). Passed through as-is; the host decides whether to act on it.
+     */
+    upstreamCode?: string;
+    /**
+     * Error reason reported by the service behind the API, when the API forwards one
+     * (`upstreamMessage`). Untranslated; the host decides whether to display it.
+     */
+    upstreamMessage?: string;
 }
 
 /** Appends a locale's uppercased code to a field label, e.g. `'Name [EN]'`. */
@@ -338,6 +358,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. */
@@ -435,7 +457,7 @@ export declare enum AuthenticationType {
  * `additionalLocaleCodes` and excluding whichever code is already the
  * primary Name/Description field.
  */
-export declare const buildAdditionalLocaleOptions: (additionalLocaleCodes: string[], primaryLocale: string) => DeploymentCreationFormLocaleOption[];
+export declare const buildAdditionalLocaleOptions: (additionalLocaleCodes: string[], primaryLocale: string) => LocaleOption[];
 
 /**
  * Builds the value persisted under `StorageKey.TextOfClosedAnnouncement` when
@@ -497,6 +519,8 @@ export declare const buildPromptOverview: (prompt: PromptResponseDto, labels: Pr
 /** Joins a folder path and a prompt name into the DIAL prompt path used as an id. */
 export declare const buildPromptPath: (folderId: string, name: string) => string;
 
+export declare const buildResetFields: (stats: LimitStatsDto, formatResetTime: FormatResetTime | undefined) => Pick<UsageLimitProgressRow, "resetLabel" | "resetIsoValue" | "resetAriaLabel">;
+
 /** Builds the Responses API endpoint URL for a deployment. */
 export declare const buildResponsesUrl: (baseUrl: string) => string;
 
@@ -522,7 +546,9 @@ export declare const buildSharedItemVirtualPath: (relativePath: string, rootLabe
  * itself) contributes no node. Every folder entry is attached under its own
  * stripped path so an empty grouping folder still appears; every file entry
  * attaches under the folder chain its stripped path implies, synthesizing
- * any intermediate folder the listing never enumerated on its own. A file
+ * any intermediate folder the listing never enumerated on its own. An
+ * empty-folder marker (`.dial_folder`) only proves its folder exists and
+ * never becomes a file node. A file
  * node's `id` is the listing entry's own (unstripped) path, so it round-trips
  * back to `downloadSkillFile` without being re-derived; a folder node's `id`
  * is the stripped path and only keys client-side expand/collapse state.
@@ -532,7 +558,10 @@ export declare const buildSkillContentTree: (files: SkillMetadataItemDto[], skil
 /**
  * Builds the ordered supporting-file paths and `Blob` payload
  * `createSkill`/`updateSkill` expect from the editor's file tree and
- * in-memory content map.
+ * in-memory content map. Every folder node with no descendant node gets a
+ * zero-byte `<folder>/.dial_folder` marker after the real files, so the
+ * empty folder survives the whole-skill write; a folder with content needs
+ * none, and a marker it had before is dropped by that same write.
  */
 export declare const buildSkillFilesPayload: (files: SkillFileTreeNode[], filesContent: Map<string, SkillFileContent>) => SkillFilesPayload;
 
@@ -580,8 +609,8 @@ export declare const buildSkillOverview: (skill: SkillMetadataItemDto | undefine
  * Builds the OAuth authorize URL for a given, already-generated `state`
  * value. The caller owns what `state` carries — see `initiateOAuthLogin`.
  * Returns `null` rather than throwing for a configuration that cannot
- * produce a valid URL, including one whose authorization endpoint is not
- * reachable over a secure transport.
+ * produce a valid URL, including one whose authorization endpoint is not an
+ * `http:`/`https:` URL.
  */
 export declare const buildToolsetAuthorizeUrl: (auth: ToolsetOAuthSettings, redirectUri: string, state: string) => string | null;
 
@@ -618,7 +647,6 @@ export declare interface CatalogDetailsApi extends SkillDetailsApi {
 
 /** Localized copy `useCatalogEditNavigation` needs for the Create menu and delete errors. */
 export declare interface CatalogEditNavigationLabels {
-    createQuickApp: string;
     createToolset: string;
     createCustomApp: string;
     createSkill: string;
@@ -656,9 +684,9 @@ export declare interface CatalogEditNavigationUrls {
     buildCustomAppEditUrl(appId: string): string;
     /** URL to create a new custom (schema-less) app. */
     buildCustomAppCreateUrl(): string;
-    /** URL to edit an existing quick app under the given schema. */
+    /** URL to edit an existing schema-based app (quick app or any other runner) under the given schema. */
     buildQuickAppEditUrl(schemaId: string, appId: string): string;
-    /** URL to create a new quick app under the given schema. */
+    /** URL to create a new schema-based app (quick app or any other runner) under the given schema. */
     buildQuickAppCreateUrl(schemaId: string): string;
 }
 
@@ -757,6 +785,7 @@ export declare interface ChatStreamApi {
     stopCompletion: (dto: {
         generationId: string;
         path: string;
+        content?: string;
     }) => Promise<void>;
 }
 
@@ -801,7 +830,7 @@ export declare const COLUMNS_WITHOUT_AUTHOR: FileManagerColumnKey[];
  * `undefined` (not `[]`) when nothing remains, so a request untouched by
  * this feature stays byte-identical to today.
  */
-export declare const composeLocalePayload: (otherLocales: DeploymentCreationFormLocaleEntry[], primaryLocale: string) => LocaleTextEntryDto[] | undefined;
+export declare const composeLocalePayload: (otherLocales: LocalizedTextEntry[], primaryLocale: string) => LocaleTextEntryDto[] | undefined;
 
 /** Whether an export includes the conversation's attachments. */
 export declare enum ConversationExportMode {
@@ -817,6 +846,28 @@ export declare interface ConversationGenerationLifecycle {
     completeGeneration: (path: string, generationId: string) => void;
 }
 
+/** Labels and formatter callbacks for the conversation-input limits mapping utility. */
+export declare interface ConversationInputLimitsLabels {
+    /** Heading of the group listing the selected deployment's token limits. */
+    tokenGroup: string;
+    /** Heading of the group listing the caller's cost budget and spend against it. */
+    costGroup: string;
+    /** Label for the current-UTC-day row, used by both groups. */
+    periodDay: string;
+    /** Label for the current-UTC-week row, used by both groups. */
+    periodWeek: string;
+    /** Label for the current-UTC-month row, used by both groups. */
+    periodMonth: string;
+    /** Formats the combined used/total display value for a capped row. */
+    formatValueLabel: (used: string, total: string) => string;
+    /** Formats the ARIA label for a capped progress row. */
+    formatProgressAriaLabel: (params: {
+        label: string;
+        used: string;
+        total: string;
+    }) => string;
+}
+
 /** Stable reverse-lookup maps returned by `useConversationLookupMaps`. */
 export declare interface ConversationLookupMaps {
     /** Returns the raw context id for a panel-space conversation id, or `undefined` when not found. */
@@ -880,7 +931,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
@@ -890,10 +941,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>>;
@@ -908,6 +963,13 @@ export declare interface ConversationStreamTransport {
     attachToGeneration(path: string, signal: AbortSignal): Promise<ReadableStream<Uint8Array>>;
     /** Reloads the persisted conversation by its full (bucket-qualified) id. */
     getConversation(conversationId: string, signal?: AbortSignal): Promise<Conversation>;
+    /**
+     * Saves `conversation` at the bucket-stripped `path`, resolving with the saved
+     * conversation. Used only for the single recovery save after the backend's
+     * terminal save was rejected with `401`; without it that failure shows the
+     * persistence warning immediately.
+     */
+    saveConversation?(path: string, conversation: Conversation): Promise<Conversation>;
 }
 
 export { ConversationTransferErrorCode }
@@ -967,6 +1029,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;
 }
 
 /**
@@ -1084,6 +1152,15 @@ export declare type CsrfRefreshOutcome = {
 
 export declare const DATE_OPTIONS: Intl.DateTimeFormatOptions;
 
+/**
+ * Inverse of `encodeDeploymentId` — decodes each `/`-separated segment back
+ * to its raw, human-readable form. A segment that isn't valid
+ * percent-encoding is passed through unchanged rather than throwing, since
+ * this decodes externally-sourced ids (the settings iframe's postMessage
+ * protocol).
+ */
+export declare const decodeDeploymentId: (id: string) => string;
+
 /**
  * Inverse of `encodeToolsetId` — decodes each `/`-separated segment back to
  * its raw, human-readable form. A segment that isn't valid percent-encoding
@@ -1100,11 +1177,17 @@ export declare const decodeToolsetId: (id: string) => string;
  * present in either map, excluding `primaryLocale` — that key is already the
  * primary Name/Description field, not a row in the popup.
  */
-export declare const decomposeLocalizedFields: (displayName: LocalizedText | undefined, description: LocalizedText | undefined, primaryLocale: string) => DeploymentCreationFormLocaleEntry[];
+export declare const decomposeLocalizedFields: (displayName: LocalizedText | undefined, description: LocalizedText | undefined, primaryLocale: string) => LocalizedTextEntry[];
+
+/** The English Overview labels `mapEntityDetailsToCatalogDetails` uses when a host passes none. */
+export declare const DEFAULT_ENTITY_DETAILS_LABELS: EntityDetailsLabels;
 
 /** 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.";
+
 /**
  * Default ceiling on the summed byte length of an export's attachments.
  *
@@ -1118,6 +1201,8 @@ export declare const DEFAULT_GENERATION_CONFLICT_MESSAGE = "A response is alread
  */
 export declare const DEFAULT_MAX_ARCHIVE_BYTES: number;
 
+export declare const DEFAULT_STREAM_IDLE_TIMEOUT_MS = 45000;
+
 /** Translated folder-path labels for the Personal/Shared/Public deployment groupings. */
 export declare interface DeploymentFolderLabels {
     personal: string;
@@ -1135,16 +1220,14 @@ export declare interface DeploymentGenerationApiSupport {
 export declare interface DeploymentLimitsLabels {
     /** Heading of the group every token stat row is listed under. */
     tokenGroup: string;
-    /** Label for the tokens-per-day stat row. */
+    /** Label for the current-UTC-day token row, e.g. "Today". */
     tokensPerDay: string;
-    /** Label for the tokens-per-week stat row. */
+    /** Label for the current-UTC-week token row, e.g. "This week". */
     tokensPerWeek: string;
-    /** Label for the tokens-per-month stat row. */
+    /** Label for the current-UTC-month token row, e.g. "This month". */
     tokensPerMonth: string;
     /** Note shown instead of a total on a row whose limit follows the cost limit. */
     followsCostLimit: string;
-    /** Formats the "$X spent" caption under a row's label. */
-    formatSpentCaption: (amount: string) => string;
     /** Formats the combined used/total display value for a capped row. */
     formatValueLabel: (used: string, total: string) => string;
     /** Formats the ARIA label for a capped progress row. */
@@ -1158,6 +1241,8 @@ export declare interface DeploymentLimitsLabels {
         label: string;
         used: string;
     }) => string;
+    /** Formats each period's `resetsAt` into the row's reset line. Omit it to render rows without one. */
+    formatResetTime?: FormatResetTime;
 }
 
 export declare const deriveActionProfile: (variant: DialFileManagerVariant) => DialFileManagerActionProfile;
@@ -1184,7 +1269,7 @@ export declare const deriveAvailableTabIds: <T extends CatalogEntityType>(items:
 export declare const deriveConversationRowActionState: (item: Pick<ConversationListItemDto, "sharedWithMe" | "publishedWithMe" | "isReadonly">, publishHistory: PublishHistoryEntry[] | undefined, recipients: RecipientsCountEntry) => ConversationRowActionState;
 
 /**
- * Returns items marked as a user favorite, in original order.
+ * Returns items marked as a user favorite that are not hidden, in original order.
  */
 export declare const deriveFavoriteItems: (items: readonly CatalogItem[]) => CatalogItem[];
 
@@ -1193,15 +1278,24 @@ export declare const deriveFavoriteItems: (items: readonly CatalogItem[]) => Cat
  * Unsupported constraints remain Custom, with the full source expression.
  * Calendar-month shifts crossing month boundaries or days 29–31 remain
  * Custom because a shifted monthly day is not equivalent around short months.
+ * The one exception is `day: 'last'` one day behind local time, which is
+ * exactly the local 1st.
  */
 export declare const describeScheduledTaskTrigger: (trigger: ScheduleTriggerDto, { timeZone, referenceDate, }?: ScheduledTaskTriggerDescriptionOptions) => ScheduledTaskTriggerDescription;
 
+/** Source tabs `useDialFileManagerSections` can merge into the All tab, in display order. */
+export declare const DIAL_FILE_MANAGER_SECTION_TABS: readonly DialFileManagerTabs[];
+
 /** Strip the "files/{bucket}/" prefix from a DIAL Core URL to get the path within the bucket. */
 export declare const dialCorePathToRelative: (dialCorePath: string, bucket: string) => string;
 
-export { DialFileManagerActionProfile }
-
-export { DialFileManagerVariant }
+/** One source tab rendered as a top-level folder of the All view. */
+export declare interface DialFileManagerSection {
+    /** Source tab backing this section — `MyFiles`, `Shared` or `Organization`. */
+    tab: DialFileManagerTabs;
+    /** Display name of the section's top-level folder; also the first segment of its virtual paths. An empty, slash-containing or repeated label is replaced by the tab id. */
+    rootLabel: string;
+}
 
 /**
  * Operation port every file-manager hook that performs network I/O accepts as
@@ -1378,6 +1472,62 @@ export declare const encodeDeploymentId: (id: string) => string;
  */
 export declare const encodeToolsetId: (id: string) => string;
 
+/**
+ * Overview section titles and spec labels rendered by
+ * `mapEntityDetailsToCatalogDetails`. Hosts pass translated strings; every
+ * field defaults to the English text in {@link DEFAULT_ENTITY_DETAILS_LABELS}.
+ */
+export declare interface EntityDetailsLabels {
+    /** Default: `'Capabilities'`. */
+    capabilitiesTitle: string;
+    /** Default: `'Specification'`. */
+    specificationTitle: string;
+    /** Default: `'Configuration'`. */
+    configurationTitle: string;
+    /** Default: `'Tools'`. */
+    tools: string;
+    /** Default: `'Parallel tool calls'`. */
+    parallelToolCalls: string;
+    /** Default: `'Reasoning efforts'`. */
+    reasoningEfforts: string;
+    /** Default: `'Skills'`. */
+    skills: string;
+    /** Default: `'Provider'`. */
+    provider: string;
+    /** Default: `'Vendor'`. */
+    vendor: string;
+    /** Default: `'License'`. */
+    license: string;
+    /** Default: `'Knowledge cutoff date'`. */
+    knowledgeCutoffDate: string;
+    /** Default: `'Parameters'`. */
+    parameters: string;
+    /** Default: `'Hosted by'`. */
+    hostedBy: string;
+    /** Default: `'Release date'`. */
+    releaseDate: string;
+    /** Default: `'Context window'`. */
+    contextWindow: string;
+    /** Default: `'Max output tokens'`. */
+    maxOutputTokens: string;
+    /** Default: `'Input modalities'`. */
+    inputModalities: string;
+    /** Default: `'Input attachments'`. */
+    inputAttachments: string;
+    /** Default: `'Routes'`. */
+    routes: string;
+    /** Default: `'Configuration schema'`. */
+    configurationSchema: string;
+    /** Default: `'Authentication'`. */
+    authentication: string;
+    /** Default: `'Authorization endpoint'`. */
+    authorizationEndpoint: string;
+    /** Default: `'Token endpoint'`. */
+    tokenEndpoint: string;
+    /** Default: `'OAuth scopes'`. */
+    oauthScopes: string;
+}
+
 /** Discriminated-union entity details for a deployment, keyed by catalog entity type. */
 export declare type EntitySpecificDetails = {
     type: 'MODEL';
@@ -1535,7 +1685,9 @@ export declare enum FileManagerNotificationReason {
     /** `onUploadArchive` extracted some entries successfully and some failed; `count`/`names`/`restCount` describe the failures. */
     UploadArchivePartiallyFailed = "uploadArchivePartiallyFailed",
     /** `onUploadArchive`'s `uploadArchive` request itself rejected. */
-    UploadArchiveRequestFailed = "uploadArchiveRequestFailed"
+    UploadArchiveRequestFailed = "uploadArchiveRequestFailed",
+    /** A copy/move targeted a destination in a different All-view section from its source items; no request was made. */
+    CrossSectionTransferUnsupported = "crossSectionTransferUnsupported"
 }
 
 /**
@@ -1556,8 +1708,6 @@ export declare type FileNameValidationError = {
 } | {
     reason: FileNameValidationErrorReason.DuplicateName;
     existingName: string;
-} | {
-    reason: FileNameValidationErrorReason.LeadingDot;
 };
 
 /**
@@ -1570,8 +1720,7 @@ export declare enum FileNameValidationErrorReason {
     ForbiddenSymbols = "forbiddenSymbols",
     ReservedName = "reservedName",
     TooLong = "tooLong",
-    DuplicateName = "duplicateName",
-    LeadingDot = "leadingDot"
+    DuplicateName = "duplicateName"
 }
 
 /**
@@ -1588,7 +1737,10 @@ export declare enum FileOperationKind {
     FileCopied = "fileCopied",
     FilesCopied = "filesCopied",
     FileMoved = "fileMoved",
-    FilesMoved = "filesMoved"
+    FilesMoved = "filesMoved",
+    /** A copy whose every item landed in its own source folder (Duplicate). */
+    FileDuplicated = "fileDuplicated",
+    FilesDuplicated = "filesDuplicated"
 }
 
 /**
@@ -1603,13 +1755,15 @@ export declare interface FileOperationSuccessEvent {
     name?: string;
     /** Number of items the operation covered, when applicable. */
     count?: number;
-    /** Destination folder name, for copy/move operations. */
+    /**
+     * Destination folder as a slash-joined virtual path starting at the root
+     * label (e.g. `My files/reports`), for copy/move/duplicate operations.
+     */
     destinationFolderName?: string;
     /**
-     * Whether the affected item is a folder rather than a file. Only set for
-     * `fileRenamed`, since it is the only kind whose current wording depends
-     * on the item's node type (a rename toast reads "Folder renamed" vs.
-     * "File renamed").
+     * Whether the affected item is a folder rather than a file. Set for rename,
+     * copy, move, and duplicate events; on a multi-item event it describes the
+     * first successfully affected item (the one `name` refers to).
      */
     isFolder?: boolean;
 }
@@ -1644,8 +1798,6 @@ export declare interface FilesApiClient {
     listSharedByMe: (bucket: string) => Promise<ListFilesResponseDto>;
 }
 
-export { FileUploadValidationResult }
-
 /**
  * Filters catalog items to those whose type is in `visibleTypes`.
  * Call only when selector mode is active; otherwise pass through the original array.
@@ -1667,6 +1819,12 @@ export declare const filterHiddenOwnedItems: (items: readonly CatalogItem[], hid
  */
 export declare const findDeploymentByIdOrReference: (deployments: DeploymentItemDto[], idOrReference: string | null | undefined) => DeploymentItemDto | undefined;
 
+/**
+ * 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;
+
 export declare const findDialFileByPath: (nodes: DialFile[], targetPath: string) => DialFile | undefined;
 
 export declare const findFirstSuccessfulCopyMoveItem: <TDto extends {
@@ -1721,7 +1879,19 @@ export declare class GenerationConflictError extends Error {
     constructor(message?: string);
 }
 
-/** Normalizes any API error into a `{ status?, message, traceId? }` shape. */
+/** Identifies a failed terminal save independently of the model's generation outcome. */
+export declare class GenerationPersistenceError extends Error {
+    static readonly type = "conversation_save_failed";
+    /** HTTP status of the rejected terminal write, when the backend reported one. */
+    readonly status?: number;
+    /**
+     * Creates the error with the default persistence message.
+     * @param status - HTTP status of the rejected terminal write, if known
+     */
+    constructor(status?: number);
+}
+
+/** Normalizes any API error into a `{ status?, message, traceId?, code?, upstreamCode?, upstreamMessage? }` shape. */
 export declare const getApiErrorDetails: (error: unknown) => Promise<ApiErrorDetails>;
 
 /** Resolves a human-readable message from an API error's response body, or falls back to `Error.message`. */
@@ -1756,6 +1926,21 @@ export declare const getConversationSource: (item: Pick<ConversationListItemDto,
  */
 export declare const getExternalServiceFallbackName: (serviceName: string) => string;
 
+/**
+ * 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
@@ -1766,7 +1951,7 @@ export declare const getExternalServiceFallbackName: (serviceName: string) => st
  * 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.
  */
@@ -1779,6 +1964,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.
  *
@@ -1806,8 +2006,6 @@ export declare const getLastUserMessageToolConfiguration: (messages: Message[])
  */
 export declare const getModelIdFromConversationId: (id: string) => string | undefined;
 
-export { getParentFolderPath }
-
 /**
  * The publish folder a public catalog entity id sits in: the segments between
  * the `public` bucket and the entity name, decoded to the plain text the
@@ -1826,6 +2024,12 @@ export declare const getQuickAppConversationStarters: (conversationStarters: unk
  */
 export declare const getRemainingCharacters: (value: string, maxLength: number) => number | null;
 
+/** Returns the schemas that create schema-based apps: unique by id, without id-less entries or the custom-app schema. */
+export declare const getRunnerSchemas: <T extends QuickAppSchemaLike>(schemas: T[]) => RunnerSchema<T>[];
+
+/** Returns the limit each over-long skill field exceeds, keyed by field; fields within their limit are omitted. */
+export declare const getSkillFieldLengthViolations: (values: Record<SkillTextField, string>) => Partial<Record<SkillTextField, number>>;
+
 /**
  * Returns the text to start/populate a conversation from a selected starter button.
  * `description` (the schema property's shared intro/question text) is used only
@@ -1879,6 +2083,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;
+
 /** Name of the same-origin `BroadcastChannel` shared by an OAuth flow's opener and its callback popup. */
 export declare const getToolsetOAuthChannelName: (flowId: string) => string;
 
@@ -1955,6 +2168,9 @@ export declare const hasDialFileWritePermission: (folder?: DialFile) => boolean;
 
 export declare const hasForbiddenNameSymbols: (name: string, forbiddenSymbolsRegExp?: RegExp) => boolean;
 
+/** Returns `true` when both sets contain exactly the same paths. */
+export declare const hasSamePaths: (a: ReadonlySet<string>, b: ReadonlySet<string>) => boolean;
+
 /**
  * Whether the operator configured the structured banner (title and/or
  * description) rather than only the legacy HTML message. Drives which of the
@@ -1966,10 +2182,16 @@ export declare const hasStructuredAnnouncement: ({ title, description, }: Announ
 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. */
@@ -2003,11 +2225,12 @@ export declare const initiateOAuthLogin: (auth: ToolsetOAuthSettings, toolsetId:
 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;
 
@@ -2083,6 +2306,9 @@ export declare const isQuickAppSchema: (schema?: QuickAppSchemaLike) => boolean;
 /** Share/Unshare/Remove access are Full-only — Browse and Attach never expose them. */
 export declare const isShareActionsAllowed: (actionProfile: DialFileManagerActionProfile) => boolean;
 
+/** Whether a skill-relative path is a folder marker (`<folder>/.dial_folder`, never a root-level `.dial_folder`). */
+export declare const isSkillFolderMarkerPath: (path: string) => boolean;
+
 /** True when `value` is a well-formed absolute `http(s)://` URL. */
 export declare const isValidAbsoluteUrl: (value: string) => boolean;
 
@@ -2093,7 +2319,10 @@ export declare const isValidFeaturesData: (value: string) => boolean;
  * Client-side mirror of the backend's `isValidSkillRelativePath`
  * (`apps/chat-api/src/skills/utils/skill-path.util.ts`), used only for
  * immediate inline feedback — the server remains authoritative and may still
- * reject a path this function accepts.
+ * reject a path this function accepts. It additionally reserves the
+ * `.dial_folder` marker name so a user can never upload or name a folder
+ * after it; the save payload's generated markers never pass through here
+ * (the server accepts them only as a zero-byte final segment).
  */
 export declare const isValidSkillRelativePath: (relativePath: string) => boolean;
 
@@ -2142,8 +2371,8 @@ export declare const mapDeploymentDetailsDtoToEntityDetails: (dto: DeploymentDet
 /** Maps a deployment limits DTO to display-ready catalog limits, or `undefined` when no qualifying stats exist. */
 export declare const mapDeploymentLimitsDtoToCatalogLimits: (dto: DeploymentLimitsResponseDto | undefined, labels: DeploymentLimitsLabels) => CatalogItemLimits | undefined;
 
-/** Maps the monthly deployment token limit to a display-ready value. */
-export declare const mapDeploymentLimitsToInput: (dto: DeploymentLimitsResponseDto | undefined) => MonthlyUsageLimit | undefined;
+/** Maps a deployment's day, week, and month token limits and the caller's cost budget to display-ready rows, or `undefined` when none qualify. */
+export declare const mapDeploymentLimitsToInput: (dto: DeploymentLimitsResponseDto | undefined, labels: ConversationInputLimitsLabels, formatResetTime?: FormatResetTime) => CatalogItemLimits | undefined;
 
 /** Maps a deployment listing row into the catalog UI's `CatalogItem` shape. */
 export declare const mapDeploymentToCatalogItem: (deployment: DeploymentItemDto, { favoriteIds, entityDetails, folderLabels, editableSchemaIds, isCustomAppsEditable, activeLocale, primaryLocale, resolveIconUrl, }: MapDeploymentToCatalogItemOptions) => CatalogItem;
@@ -2185,10 +2414,11 @@ export declare const mapDeploymentToolsetCredentials: (toolsetId: string, authSe
 
 /**
  * Converts a strongly-typed entity domain model into the lib's `CatalogItemTabData` shape.
- * Every label is a fixed English string — the app's i18n keys for these labels are dropped
- * on the move, since the lib cannot import the app's translation-key enum.
+ * Section titles and spec labels come from `labels`, merged over
+ * {@link DEFAULT_ENTITY_DETAILS_LABELS} — the lib cannot import a host's
+ * translation keys, so the host passes its translated strings in.
  */
-export declare const mapEntityDetailsToCatalogDetails: (details: EntitySpecificDetails) => CatalogItemTabData;
+export declare const mapEntityDetailsToCatalogDetails: (details: EntitySpecificDetails, labels?: Partial<EntityDetailsLabels>) => CatalogItemTabData;
 
 /**
  * Overlays a `FileMetadataResponseDto` response onto the clicked grid row so
@@ -2209,9 +2439,8 @@ export declare const mapFileMetadataToDialFile: (metadata: FileMetadataResponseD
 export declare const mapFormValuesToCreateBody: (values: ScheduledTaskCreateFormValues) => CreateScheduledTaskBodyDto;
 
 /**
- * Maps validated edit-form values to the `PUT /api/v1/scheduled-tasks/:scheduleId`
- * request body. `UpdateScheduledTaskBodyDto` has the same shape as
- * `CreateScheduledTaskBodyDto`, so this reuses the same trigger-building logic.
+ * Maps a complete, validated edit draft to an update body. An unset skill
+ * emits null to remove the saved reference; hydrate from detail before editing.
  */
 export declare const mapFormValuesToUpdateBody: (values: ScheduledTaskCreateFormValues) => UpdateScheduledTaskBodyDto;
 
@@ -2281,9 +2510,12 @@ export declare interface MapSkillToCatalogItemOptions {
 }
 
 /**
- * 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;
 
@@ -2320,9 +2552,10 @@ export declare interface MapToolsetToCatalogItemOptions {
 export declare const mapUsageDataToDashboard: (usage: UserLimitStatsResponseDto | undefined, t: Translate, formatResetTime: FormatResetTime) => UsageLimitCardData[];
 
 /**
- * Maps `usage.deployments` into `ModelLimitsSection`'s `rows` prop, joined with model identity
- * from `deploymentItems`. Rows are included only when any displayed period stat has nonzero usage.
- * Order follows `Object.keys(deployments)` — `deploymentItems` is enrichment-only.
+ * Maps `usage.deployments` into `ModelLimitsSection`'s `rows` prop, joined with model or application
+ * identity from `deploymentItems`. Rows are included only when any displayed period stat has nonzero
+ * usage (Cost stats only, for an application). Order follows `Object.keys(deployments)` —
+ * `deploymentItems` is enrichment-only.
  *
  * @param resolveIconUrl - Resolves a deployment's raw `iconUrl` to the URL the avatar should load.
  * @param resolveDisplayName - Resolves a localized-text map or plain string to the display name for `activeLocale`.
@@ -2489,6 +2722,15 @@ export declare enum McpResourceKind {
 
 export declare const mergeCreatedFolderIntoCache: (cache: Map<string, ListFilesItemDto[]>, parentApiPath: string, created: CreateFolderResponseDto, inheritedPermissions?: string[]) => Map<string, ListFilesItemDto[]>;
 
+/**
+ * Merges a freshly-fetched page 0 into the currently-loaded run list: an
+ * already-known id is replaced in place at its existing array position, an
+ * unseen id is prepended (upstream order is `created_at desc`, so it is the
+ * newest), and an id absent from `incoming` is left untouched — a background
+ * refresh never removes a loaded run.
+ */
+export declare const mergeRunsById: (current: ScheduledTaskRunDto[], incoming: ScheduledTaskRunDto[]) => ScheduledTaskRunDto[];
+
 /**
  * Merges incoming stage deltas into an existing stage list, keyed by `index`.
  *
@@ -2514,6 +2756,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;
+}
+
 /** Formats MIME types as a human-readable, comma-separated list of dotted extensions (or the MIME type itself for wildcards). */
 export declare const mimeTypesToAttachmentExtensionLabels: (types: string[]) => string;
 
@@ -2552,6 +2808,7 @@ export declare interface ModelCapabilities {
     hasResume?: boolean;
     hasChatCompletion?: boolean;
     hasResponsesApi?: boolean;
+    hasSkills?: boolean;
     reasoningEfforts?: string[];
 }
 
@@ -2575,6 +2832,8 @@ export declare interface ModelPriceRow {
 export declare interface ModelPricing {
     /** Every price DIAL Core reports for the deployment, `unit` excluded. */
     prices?: ModelPriceRow[];
+    /** DIAL Core billing unit the prices are quoted in, e.g. `token` or `char_without_whitespace`; absent means tokens. */
+    unit?: string;
 }
 
 /** Catalog-facing specification fields for a model deployment. */
@@ -2591,18 +2850,6 @@ export declare interface ModelSpecification {
     createdAt?: number;
 }
 
-/** Normalized monthly token usage consumed by the conversation input control. */
-export declare interface MonthlyUsageLimit {
-    /** Normalized used-token count. */
-    used: number;
-    /** Configured monthly token limit. */
-    total: number;
-    /** Remaining monthly tokens, clamped to zero. */
-    remaining: number;
-    /** Monthly utilization percentage, clamped to 0–100. */
-    usedPercent: number;
-}
-
 /** Returns a skill relative path's final segment (its display name in the file tree). */
 export declare const nameFromPath: (path: string) => string;
 
@@ -2614,6 +2861,20 @@ export declare const nameFromPath: (path: string) => string;
  */
 export declare const navigateToolsetOAuthPopup: (popup: Window, auth: ToolsetOAuthSettings, toolsetId: string, callbackPath: string, credentialsLevel?: ToolsetCredentialsLevel, resourceKind?: OAuthResourceKind, offlineUsageConsent?: boolean) => ToolsetOAuthInitiationResult;
 
+/**
+ * Encodes a deployment/application id to its single-encoded form regardless
+ * of whether the value it received was already percent-encoded or the raw,
+ * human-readable form — decoding first then re-encoding once is idempotent
+ * either way, since `decodeDeploymentId` on a raw (unencoded) id is a no-op.
+ * Use this instead of `encodeDeploymentId` at a boundary that cannot
+ * guarantee which form it receives, such as a `postMessage` payload from the
+ * settings iframe: calling `encodeDeploymentId` directly on a value the
+ * sender already encoded escapes the existing `%` characters a second time
+ * (`%20` becomes `%2520`), which the backend only ever undoes once and so
+ * 404s on.
+ */
+export declare const normalizeDeploymentId: (id: string) => string;
+
 /**
  * Normalises a stored response-format string to the current enum. Legacy data
  * may contain `'Markdown'` or `'PlainText'` (capital-first) instead of the
@@ -2629,6 +2890,19 @@ export declare const normalizeResponseFormat: (value: string | undefined) => Res
  */
 export declare const normalizeSkillName: (input: string) => string;
 
+/**
+ * Encodes a toolset id to its single-encoded form regardless of whether the
+ * value received it in was already percent-encoded or the raw,
+ * human-readable form — decoding first then re-encoding once is idempotent
+ * either way, since `decodeToolsetId` on a raw (unencoded) id is a no-op.
+ * Use this instead of `encodeToolsetId` at a boundary that cannot guarantee
+ * which form it receives, such as a `postMessage` payload from an embedded
+ * iframe: calling `encodeToolsetId` directly on a value the sender already
+ * encoded escapes the existing `%` characters a second time (`%20` becomes
+ * `%2520`), which the backend only ever undoes once and so 404s on.
+ */
+export declare const normalizeToolsetId: (toolsetId: string) => string;
+
 export declare const normalizeVirtualPath: (value: string) => string;
 
 /** Arguments handed to the host's exchange callback. */
@@ -2694,7 +2968,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;
@@ -2758,7 +3032,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;
@@ -2938,7 +3212,7 @@ export declare interface PreparedCopyMoveItem<TDto> {
 export declare const prepareDownloadDestination: (filename: string, mimeType?: string) => Promise<DownloadDestination>;
 
 /**
- * Rename-vs-move disambiguation (design.md D3): entries whose parent folder
+ * Rename-vs-move disambiguation (`openspec/changes/archive/2026-07-21-split-use-dial-file-manager/design.md` D3): entries whose parent folder
  * is unchanged become `renameDtos`; entries whose parent folder changed
  * become `preparedMoveItems`.
  */
@@ -3007,7 +3281,11 @@ export declare enum PromptSource {
     Public = "public"
 }
 
-/** DIAL Core bucket holding organisation-wide skills. */
+/**
+ * DIAL Core bucket holding organisation-wide skills.
+ *
+ * @deprecated Use `PUBLIC_BUCKET` from `@epam/ai-dial-chat-shared`.
+ */
 export declare const PUBLIC_SKILL_BUCKET = "public";
 
 /** The DIAL publish API surface produced by {@link createPublishApiClient}. */
@@ -3058,6 +3336,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;
 }
 
 /**
@@ -3258,9 +3541,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>;
 
@@ -3320,6 +3612,9 @@ export declare const resolvePdfCanvasContent: (attachment: DisplayAttachment, re
  */
 export declare const resolveRelativeDialFilePath: (pathOrFileId: string, bucket: string) => string;
 
+/** Returns the section whose root label is the first segment of `virtualPath`, or `undefined` when none matches. */
+export declare const resolveSectionByPath: <TSection extends DialFileManagerSection>(virtualPath: string, sections: readonly TSection[]) => TSection | undefined;
+
 /**
  * Converts an opaque file-listing id into the path expected by the single-file
  * download endpoint. Core may prefix listing paths with the skill path and its
@@ -3339,6 +3634,16 @@ export declare const resolveSkillManifestFileId: (files: SkillMetadataItemDto[],
 /** Resolves a plain-text canvas content payload from a DisplayAttachment, or `null` if unavailable. */
 export declare const resolveTextCanvasContent: (attachment: DisplayAttachment, resolvers: AttachmentCanvasUrlResolvers) => Promise<PlainTextCanvasContent | ErrorCanvasContent | null>;
 
+/**
+ * Resolves which credentials level a toolset's login applies to, per DIAL
+ * Core's public/private toolset convention: a `public`-bucket toolset is
+ * shared credentials-wise at `User` level, while a private/workspace toolset
+ * is scoped at `Global` level. Every surface that drives a toolset login
+ * (the sign-in-interrupt dialog, the QuickApps editor iframe bridge,
+ * `useToolsetLogin`) must resolve the level this way rather than assuming one.
+ */
+export declare const resolveToolsetCredentialsLevel: (toolsetId: string) => ToolsetCredentialsLevel.User | ToolsetCredentialsLevel.Global;
+
 /**
  * Fetches the attachment payload and builds a `VisualizerCanvasContent` for the
  * given registry entry and theme. Returns `null` when the payload cannot be
@@ -3351,6 +3656,11 @@ export declare const resolveTextCanvasContent: (attachment: DisplayAttachment, r
  */
 export declare const resolveVisualizerCanvasContent: (attachment: DisplayAttachment, resolvers: AttachmentCanvasUrlResolvers, entry: CustomVisualizer, themeId: string) => Promise<VisualizerCanvasContent | null>;
 
+/** An application schema with a resolved id, as returned by {@link getRunnerSchemas}. */
+export declare type RunnerSchema<T extends QuickAppSchemaLike> = T & {
+    id: string;
+};
+
 /** Decodes a URI-encoded path segment, returning the original string if decoding fails. */
 export declare const safeDecodeURI: (path: string) => string;
 
@@ -3426,6 +3736,7 @@ export declare interface ScheduledTasksConfiguredClient {
         offset?: number;
         search?: string;
         sort?: ListScheduledTasksSortEnum;
+        model?: string;
     }, options?: RequestInit) => Promise<ListScheduledTasksResponseDto>;
     listScheduledTaskRuns: (request: {
         scheduleId: string;
@@ -3459,6 +3770,8 @@ export declare interface ScheduledTasksListRequest {
     offset?: number;
     search?: string;
     sort?: ListScheduledTasksSortEnum;
+    /** Only tasks that run against this model/application id, exactly as stored. */
+    model?: string;
     signal?: AbortSignal;
 }
 
@@ -3492,6 +3805,14 @@ export declare interface ScheduledTaskTriggerDescriptionOptions {
     referenceDate?: Date;
 }
 
+/**
+ * Picks the auth-status field matching one credentials level out of a
+ * toolset's `authSettings` — DIAL Core reports `userLevelAuthStatus` and
+ * `globalAuthStatus` as independent fields rather than one status keyed by
+ * level.
+ */
+export declare const selectToolsetAuthStatus: (authSettings: Pick<DialToolsetAuthSettingsDto, "userLevelAuthStatus" | "globalAuthStatus"> | undefined, credentialsLevel: ToolsetCredentialsLevel) => string | undefined;
+
 /** Serializes a prompt export envelope into a pretty-printed JSON blob. */
 export declare const serializePromptExport: (envelope: PromptExportFormat) => Blob;
 
@@ -3525,6 +3846,13 @@ export declare const shouldWatchForDisplayNameUpdate: (conversation: Conversatio
  */
 export declare const SKILL_FILE_UPLOAD_MAX_BYTES = 1048576;
 
+/**
+ * Zero-byte object written at `<folder>/.dial_folder` so an otherwise empty
+ * skill folder survives a save — DIAL Core storage has no directory objects,
+ * so a folder only exists as a file's path prefix.
+ */
+export declare const SKILL_FOLDER_MARKER = ".dial_folder";
+
 /**
  * Upper bound on `nextToken` follow-ups per listing, so a pathological bucket
  * cannot spin the client forever.
@@ -3543,6 +3871,9 @@ export declare const SKILL_MANIFEST_FILE = "SKILL.md";
  */
 export declare const SKILL_MANIFEST_MAX_BYTES: number;
 
+/** Length limit of each skill editor text field. */
+export declare const SKILL_TEXT_FIELD_MAX_LENGTHS: Record<SkillTextField, number>;
+
 /**
  * Client-side mirror of the backend's default `SKILL_UPLOAD_MAX_FILES`
  * (`apps/chat-api/src/config/environment.config.ts`), used only for
@@ -3651,6 +3982,8 @@ export declare interface SkillEditorSubmitClient {
 export declare interface SkillEditorSubmitMessages {
     /** Shown when a required field is empty. */
     required: string;
+    /** Shown when a name, description or instructions value exceeds its length limit, given that limit. */
+    tooLong: (maxLength: number) => string;
     /**
      * Shown when the Instructions value opens with its own YAML frontmatter
      * block — pasting a whole `SKILL.md` in there would otherwise produce a
@@ -3791,6 +4124,9 @@ export declare interface SkillFilesPayload {
  */
 export declare const skillFileToAttachment: (node: SkillFileTreeNode, content: SkillFileContent) => Attachment;
 
+/** Returns the folder path a marker path stands for (`docs/.dial_folder` → `docs`). */
+export declare const skillFolderMarkerParent: (markerPath: string) => string;
+
 /** A `SKILL.md` split into its frontmatter fields and its prose body. */
 export declare interface SkillManifestDocument {
     /** `name` frontmatter field, when present and a string. */
@@ -3857,12 +4193,27 @@ export declare enum SkillSource {
     Public = "public"
 }
 
+/** Skill editor text fields with a length limit. */
+export declare type SkillTextField = 'name' | 'description' | 'instructions';
+
 /** Splits a file name into its base and extension, using only the last dot. */
 export declare const splitFileNameExtension: (fileName: string) => {
     base: string;
     extension: string;
 };
 
+/** 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;
+}
+
 /**
  * Answers one question: would appending this text after the fence that
  * `buildSkillManifest` writes produce a *second* frontmatter block?
@@ -3893,6 +4244,29 @@ 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);
+}
+
 /** Strips leading and trailing slashes from a path segment. */
 export declare const stripSurroundingSlashes: (path: string) => string;
 
@@ -4213,7 +4587,8 @@ export declare const toPublishRuleDto: (rule: PublicationRule) => PublishRuleDto
 /**
  * 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;
 
@@ -4239,19 +4614,25 @@ export declare interface UnauthorizedErrorLike extends Error {
     readonly url: string;
 }
 
+/** Returns a new set containing every path from each of `pathSets`. */
+export declare const unionPathSets: (pathSets: readonly ReadonlySet<string>[]) => Set<string>;
+
 /** A skill archive unpacked into its manifest text and a relative-path → bytes map of every other entry. */
 export declare interface UnpackedSkillArchive {
     /** The root `SKILL.md` entry's decoded text content. */
     manifestText: string;
-    /** Every non-manifest entry, keyed by relative path. */
+    /** Every non-manifest, non-marker entry, keyed by relative path. */
     files: Map<string, Uint8Array>;
+    /** Folder paths restored from `<folder>/.dial_folder` marker entries. */
+    folders: string[];
 }
 
 /**
  * Unpacks a whole-skill ZIP (as downloaded from `GET /api/v1/skills/download`
  * — DIAL Core's whole-resource `GET` is the one place this contract still
- * uses a ZIP, per design.md) into its manifest text and every other entry's
- * bytes. Throws if the archive has no root `SKILL.md` entry.
+ * uses a ZIP, per `openspec/changes/archive/2026-10-05-persist-skill-empty-folders/design.md`) into its manifest text, every other entry's
+ * bytes, and the folders its empty-folder markers stand for. Throws if the
+ * archive has no root `SKILL.md` entry.
  */
 export declare const unpackSkillArchive: (bytes: Uint8Array) => UnpackedSkillArchive;
 
@@ -4265,7 +4646,7 @@ export declare enum UnsupportedTriggerReason {
     MissingRequiredFields = "missingRequiredFields"
 }
 
-export declare const updateEntry: (prev: FileUploadBatchState | null, index: number, patch: FileUploadStatus | Partial<Pick<FileUploadEntry, "status" | "percent">>) => FileUploadBatchState | null;
+export declare const updateEntry: (prev: FileUploadBatchState | null, id: string, patch: FileUploadStatus | Partial<Pick<FileUploadEntry, "status" | "percent">>) => FileUploadBatchState | null;
 
 /** Max number of files uploaded concurrently within a single upload batch. */
 export declare const UPLOAD_CONCURRENCY = 3;
@@ -4343,6 +4724,10 @@ export declare const USAGE_MODEL_LIMITS_I18N_KEYS: {
     readonly progressAriaLabel: "usage.progressAriaLabel";
     /** Label for the spent-cost cell. Receives `{ amount: string }`. */
     readonly spentLabel: "usage.spentLabel";
+    /** Type caption for an application (agent) row. Receives no interpolation. */
+    readonly applicationTypeLabel: "usage.applicationTypeLabel";
+    /** Supporting label on an application row's spent cost. Receives no interpolation. */
+    readonly includesCalledModelsLabel: "usage.includesCalledModelsLabel";
 };
 
 /**
@@ -4353,7 +4738,8 @@ export declare const USAGE_MODEL_LIMITS_I18N_KEYS: {
  * 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;
 
@@ -4493,7 +4879,7 @@ export declare interface UseAttachmentValidationResult {
  * item through the endpoint its type owns and refetching/notifying on
  * completion, and building the Create dropdown's options.
  */
-export declare const useCatalogEditNavigation: ({ deployments, isCustomAppsEnabled, isSchemaAppsEnabled, isHideCustomAppCreationEnabled, isToolsetsEnabled, isPromptsEnabled, quickAppSchemaId, urls, onNavigate, deletePrompt, deleteToolset, deleteSkill, deleteApplication, refetchPrompts, refetchToolsets, refetchSkills, refetchDeployments, onDeleteSuccess, labels, onNotify, onSkillUploadClick, }: UseCatalogEditNavigationParams) => UseCatalogEditNavigationResult;
+export declare const useCatalogEditNavigation: ({ deployments, isCustomAppsEnabled, isSchemaAppsEnabled, isHideCustomAppCreationEnabled, isToolsetsEnabled, isPromptsEnabled, schemas, urls, onNavigate, deletePrompt, deleteToolset, deleteSkill, deleteApplication, refetchPrompts, refetchToolsets, refetchSkills, refetchDeployments, onDeleteSuccess, labels, onNotify, onSkillUploadClick, }: UseCatalogEditNavigationParams) => UseCatalogEditNavigationResult;
 
 /** Parameters accepted by {@link useCatalogEditNavigation}. */
 export declare interface UseCatalogEditNavigationParams {
@@ -4503,8 +4889,8 @@ export declare interface UseCatalogEditNavigationParams {
     isHideCustomAppCreationEnabled: boolean;
     isToolsetsEnabled: boolean;
     isPromptsEnabled: boolean;
-    /** The quick-app schema id resolved by `useCatalogItems`, or `undefined` when no quick-app schema exists. */
-    quickAppSchemaId: string | undefined;
+    /** Application type schemas (runners) loaded at startup; each one except the custom-app schema gets its own Create option. */
+    schemas: ApplicationSchemaSummaryDto[];
     /** Already-configured editor-route URL builders. */
     urls: CatalogEditNavigationUrls;
     /** Navigates the host to a URL built by `urls`. */
@@ -4535,7 +4921,10 @@ export declare interface UseCatalogEditNavigationParams {
 export declare interface UseCatalogEditNavigationResult {
     handleEdit: (item: CatalogItem) => void;
     handleDelete: (item: CatalogItem) => Promise<void>;
+    /** The Create dropdown's items: runners and static options sorted together by label, all filtered by `createSearch.value`. */
     createOptions: DropdownItem[];
+    /** The Create menu's search field state, or `undefined` when no runner option is offered. */
+    createSearch: CatalogCreateSearch | undefined;
 }
 
 /**
@@ -4543,7 +4932,7 @@ export declare interface UseCatalogEditNavigationResult {
  * Extracts the inline dispatch logic from `CatalogView` into a reusable,
  * library-isolated unit.
  */
-export declare const useCatalogItemDetails: ({ api, skills, isAdmin, dialCoreExternalUrl, skillOverviewLabels, promptOverviewLabels, deploymentLimitsLabels, }: UseCatalogItemDetailsOptions) => UseCatalogItemDetailsResult;
+export declare const useCatalogItemDetails: ({ api, skills, isAdmin, dialCoreExternalUrl, skillOverviewLabels, promptOverviewLabels, deploymentLimitsLabels, entityDetailsLabels, }: UseCatalogItemDetailsOptions) => UseCatalogItemDetailsResult;
 
 /** Options accepted by `useCatalogItemDetails`. */
 export declare interface UseCatalogItemDetailsOptions {
@@ -4564,6 +4953,12 @@ export declare interface UseCatalogItemDetailsOptions {
     promptOverviewLabels: PromptOverviewLabels;
     /** Labels for deployment limits table. */
     deploymentLimitsLabels: DeploymentLimitsLabels;
+    /**
+     * Overview section titles and spec labels for models, agents and toolsets,
+     * merged over the English defaults. Memoise it like the other label objects:
+     * a new object on every render recreates `onFetchDetails`.
+     */
+    entityDetailsLabels?: Partial<EntityDetailsLabels>;
 }
 
 /** Returned callbacks from `useCatalogItemDetails`. All callbacks are stable for stable inputs. */
@@ -4798,7 +5193,8 @@ export declare interface UseConversationHandlersResult {
  * `.dial`/`.zip`, v5 envelope, old- or new-chat origin) once per file, then
  * re-uploads any archive attachments to `uploads/<YYYY-MM>/` —
  * disambiguating a name collision with a ` (n)` suffix instead of rejecting
- * it — rewrites attachment references (and renamed titles), regenerates each
+ * it — rewrites attachment references (and renamed titles), drops any
+ * reference still pointing into another user's bucket, regenerates each
  * conversation's id/path with a fresh UUID (collision-free save, no replace
  * dialog), and persists every conversation through the injected
  * `conversationsApi`. One job per imported file, not per conversation.
@@ -4868,10 +5264,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;
@@ -4907,11 +5307,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;
 }
@@ -4978,7 +5379,7 @@ export declare interface UseConversationSourcesResult {
     uploaded: DisplayAttachment[];
     /** Deduplicated attachments the assistant generated across the conversation. */
     generated: DisplayAttachment[];
-    /** Quotation sources referenced by assistant messages, deduplicated by URL. */
+    /** Quotation sources referenced by assistant messages, deduplicated by URL; PDF sources are qualified with `#page=N`. */
     sources: QuotationSource[];
 }
 
@@ -4990,7 +5391,7 @@ export declare interface UseConversationSourcesResult {
  * `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 {
@@ -5008,17 +5409,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>;
 }
 
 /**
@@ -5026,14 +5449,14 @@ export declare interface UseConversationStreamResult {
  * tree's expand/collapse state, search, and the shared per-folder cache that
  * `useDialFileUploadBatch`/`useDialFileMutations`/`useDialFileSharing` invalidate
  * through `invalidateFolders`/`bumpRetry` after their own mutations settle
- * (design.md D1) — this hook is the sole owner/writer of that cache.
+ * (`openspec/changes/archive/2026-07-21-split-use-dial-file-manager/design.md` D1) — this hook is the sole owner/writer of that cache.
  *
  * Supports three listing sources via `activeTab`:
  * - my_files: user's own bucket via `DialFilesApi.listFiles`
  * - shared: files shared with the user via `DialFilesApi.listSharedFiles`
  * - organization: public bucket via `DialFilesApi.listPublicFiles`
  */
-export declare const useDialFileListing: ({ filesApi, bucket, rootLabel, activeTab, onNotification, }: UseDialFileListingOptions) => UseDialFileListingResult;
+export declare const useDialFileListing: ({ filesApi, bucket, rootLabel, activeTab, onNotification, isActive, sessionKey, }: UseDialFileListingOptions) => UseDialFileListingResult;
 
 /** Options accepted by `useDialFileListing`. */
 export declare interface UseDialFileListingOptions {
@@ -5047,6 +5470,10 @@ export declare interface UseDialFileListingOptions {
     activeTab: DialFileManagerTabs;
     /** Called with a structured event when a folder-load operation fails. */
     onNotification?: (notification: FileManagerNotification) => void;
+    /** When false, the hook issues no `DialFilesApi` call and reports `isLoading: false`. Defaults to `true`. */
+    isActive?: boolean;
+    /** Changing this value resets cache and navigation exactly like an `activeTab` change. Defaults to `undefined`. */
+    sessionKey?: string;
 }
 
 /** Values returned by `useDialFileListing`. */
@@ -5082,7 +5509,7 @@ export declare interface UseDialFileListingResult {
     /**
      * Deletes the given API-path cache keys so the next listing fetch/expand for
      * that folder re-fetches from the server. The only way sibling sub-hooks may
-     * invalidate the shared cache (design.md D1).
+     * invalidate the shared cache (`openspec/changes/archive/2026-07-21-split-use-dial-file-manager/design.md` D1).
      */
     invalidateFolders: (apiPaths: string[]) => void;
     /** Merges a just-created folder into its parent's cache entry (optimistic display for create-folder). */
@@ -5103,7 +5530,7 @@ export declare interface UseDialFileListingResult {
  * every translated string reaches it through `labels`,
  * `disabledNewButtonTooltip`, and `buildValidationErrorMessage`.
  */
-export declare const useDialFileManager: ({ filesApi, bucket, rootLabel, activeTab, onNotification, onOperationSuccess, forbiddenSymbolsRegExp, variant, actionProfile, labels, locale, disabledNewButtonTooltip, downloadDestination, buildValidationErrorMessage, }: UseDialFileManagerOptions) => UseDialFileManagerResult;
+export declare const useDialFileManager: ({ filesApi, bucket, rootLabel, activeTab, isActive, sessionKey, onNotification, onOperationSuccess, forbiddenSymbolsRegExp, variant, actionProfile, labels, locale, disabledNewButtonTooltip, downloadDestination, buildValidationErrorMessage, }: UseDialFileManagerOptions) => UseDialFileManagerResult;
 
 export declare interface UseDialFileManagerOptions {
     /** Injected operation port used for every file-manager network call. */
@@ -5114,6 +5541,10 @@ export declare interface UseDialFileManagerOptions {
     rootLabel?: string;
     /** Active tab — drives listing source and per-tab options. Defaults to MyFiles. */
     activeTab?: DialFileManagerTabs;
+    /** When false, the listing issues no `DialFilesApi` call and reports `isLoading: false`. Defaults to `true`. */
+    isActive?: boolean;
+    /** Changing this value resets cache and navigation exactly like an `activeTab` change. Defaults to `undefined`. */
+    sessionKey?: string;
     /** Called when a file-manager action should surface a toast notification. */
     onNotification?: (notification: FileManagerNotification) => void;
     /** Called when a mutation succeeds, instead of invoking an application notification service directly. */
@@ -5168,7 +5599,7 @@ export declare interface UseDialFileManagerResult {
     onSearchFiles: (folder: string, query: string) => void;
     /** Search: true while a search request is in flight. */
     isSearching: boolean;
-    /** Search: flat list of matching files, or null when search is not active. */
+    /** Search: flat, unfiltered recursive listing of the current folder, or null when search is not active. */
     searchResults: DialFile[] | null;
     /** Search: clears results and exits search mode. */
     clearSearchResults: () => void;
@@ -5192,7 +5623,9 @@ export declare interface UseDialFileManagerResult {
     uploadBatchState: FileUploadBatchState | null;
     /** Upload: abort all in-flight and queued uploads. */
     cancelUpload: () => void;
-    /** Upload: dismiss the progress modal after the batch has settled. */
+    /** Upload: abort one queued or in-flight upload by its entry id. */
+    cancelUploadFile: (id: string) => void;
+    /** Upload: empty the upload queue. */
     clearUploadBatch: () => void;
     /** Folder creation: called when user confirms a new folder name. */
     onCreateFolder: (file: DialUploadFileItem, folderPath: string, fileId: string) => Promise<void>;
@@ -5259,7 +5692,7 @@ export declare interface UseDialFileManagerResult {
     /**
      * True while any mutating file-manager operation is in flight: the OR of
      * `isCreatingFolder`, `isDownloading`, `isDeleting`, `isRenaming`, `isCopying`,
-     * `isMoving`, `isUnsharing`, `isRemovingAccess`, and `uploadBatchState != null`.
+     * `isMoving`, `isUnsharing`, `isRemovingAccess`, and any upload still queued or running.
      *
      * Deliberately excludes three flags, each already fully contained by its own
      * scoped loading UI:
@@ -5270,11 +5703,36 @@ export declare interface UseDialFileManagerResult {
     isAnyOperationInProgress: boolean;
 }
 
+/**
+ * Composes one `useDialFileManager` per source tab (My files, Shared,
+ * Organization) so the File storage page can offer an All tab without a
+ * second copy of the per-tab rules. On a single tab it returns that section's
+ * result; on All it merges the section roots into one tree and routes every
+ * callback to the section owning the path. Section availability and names
+ * arrive through `sections` — the hook reads no config, i18n, or context.
+ */
+export declare const useDialFileManagerSections: ({ activeTab, sections, ...managerOptions }: UseDialFileManagerSectionsOptions) => UseDialFileManagerSectionsResult;
+
+/** Options accepted by `useDialFileManagerSections`. */
+export declare interface UseDialFileManagerSectionsOptions extends Omit<UseDialFileManagerOptions, 'activeTab' | 'rootLabel' | 'isActive' | 'sessionKey'> {
+    /** Active tab, including `DialFileManagerTabs.All`. */
+    activeTab: DialFileManagerTabs;
+    /** Enabled source tabs in display order, each with its translated top-level folder name. */
+    sections: DialFileManagerSection[];
+}
+
+/** Values returned by `useDialFileManagerSections`. */
+export declare interface UseDialFileManagerSectionsResult extends UseDialFileManagerResult {
+    /** Source tab of the browsed folder; never `DialFileManagerTabs.All`. */
+    sectionTab: DialFileManagerTabs;
+}
+
 /**
  * Filters the file-manager's tab list down to the host's configured set and
  * resets `activeTab` to the highest-priority still-enabled tab when the
  * current one becomes excluded. A `fileManagerTabs` of `undefined` means no
  * restriction — every tab in `allTabs` stays enabled and no reset ever fires.
+ * The All tab is kept only while at least two source tabs are enabled.
  */
 export declare const useDialFileManagerTabConfig: (activeTab: DialFileManagerTabs, onTabChange: (tab: DialFileManagerTabs) => void, allTabs: FilterChipItem<DialFileManagerTabs>[] | undefined, fileManagerTabs: string[] | undefined) => UseDialFileManagerTabConfigResult;
 
@@ -5405,10 +5863,11 @@ export declare interface UseDialFileSharingResult {
 
 /**
  * Manages upload batches (single-file and ZIP-archive extraction), including
- * concurrency-limited progress tracking and abort. Invalidates the shared
- * listing cache for the destination folder through `invalidateFolders`/
- * `bumpRetry` after a batch settles — it never holds its own copy of the
- * cache.
+ * concurrency-limited progress tracking and per-file abort. A batch started
+ * while another is on screen is appended to it, and settled entries stay in
+ * `uploadBatchState` until `clearUploadBatch`. Invalidates the shared listing
+ * cache for the destination folder through `invalidateFolders`/`bumpRetry`
+ * after a batch settles — it never holds its own copy of the cache.
  */
 export declare const useDialFileUploadBatch: ({ filesApi, bucket, rootLabel, activeTab, cache, sharedRootMetaRef, invalidateFolders, bumpRetry, onNotification, }: UseDialFileUploadBatchOptions) => UseDialFileUploadBatchResult;
 
@@ -5441,6 +5900,7 @@ export declare interface UseDialFileUploadBatchResult {
     onValidateUpload: (files: DialUploadFileItem[], existingFiles: DialFile[], destinationFolder: string) => Promise<FileUploadValidationResult>;
     uploadBatchState: FileUploadBatchState | null;
     cancelUpload: () => void;
+    cancelUploadFile: (id: string) => void;
     clearUploadBatch: () => void;
 }
 
@@ -5604,6 +6064,35 @@ export declare const useMcpAppHostContext: (displayMode: "inline" | "fullscreen"
  */
 export declare const useMcpAppTools: (client: McpAppsApiClient, deployment: DeploymentItemDto | undefined, messages: Message[], toolsets: DialToolsetDto[]) => McpAppToolRef[];
 
+/**
+ * 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;
+}
+
 /**
  * Completes an OAuth authorization-code flow from inside the callback popup:
  * reads and clears the redirect state written into this popup's own
@@ -5805,17 +6294,17 @@ export declare interface UsePublishFoldersResult {
      */
     onCreatePublishFolder: (parentPath: string[], name: string) => Promise<void>;
     /**
-     * Records `folderPath` as a publish destination the user has actually used,
-     * so it keeps appearing in the tree on later publishes. Call it after a
-     * successful publish.
+     * Records `folderPath` as the most recent publish destination (moving it to
+     * the front if already remembered), so it keeps appearing in the tree on
+     * later publishes. Call it after a successful publish.
      */
     rememberPublishFolder: (folderPath: string[]) => void;
     /** Heuristic write-access check for a folder path (see the TODO above). */
     hasPublishWriteAccess: (folderPath: string[]) => boolean;
 }
 
-/** Shared, cancellation-safe pagination for one schedule's run history. */
-export declare const useScheduledTaskRuns: (client: ScheduledTasksApiClient, { scheduleId, enabled, pageSize }: UseScheduledTaskRunsOptions) => {
+/** Shared, cancellation-safe pagination and background refresh for one schedule's run history. */
+export declare const useScheduledTaskRuns: (client: ScheduledTasksApiClient, { scheduleId, enabled, pageSize, nextRunTime, }: UseScheduledTaskRunsOptions) => {
     items: ScheduledTaskRunDto[];
     isLoading: boolean;
     isLoadingMore: boolean;
@@ -5831,10 +6320,16 @@ export declare interface UseScheduledTaskRunsOptions {
     scheduleId: string;
     enabled?: boolean;
     pageSize?: number;
+    /**
+     * The task's next scheduled run time (ISO string), when known. Drives the
+     * one-shot background refresh described on {@link useScheduledTaskRuns}.
+     * The caller already holds the task DTO — this hook never fetches it.
+     */
+    nextRunTime?: string | null;
 }
 
 /** Shared scheduler-list lifecycle with generation-scoped stale-response guards. */
-export declare const useScheduledTasks: (client: ScheduledTasksApiClient, { enabled, pageSize, debounceMs, initialSearch, initialSort, }?: UseScheduledTasksOptions) => {
+export declare const useScheduledTasks: (client: ScheduledTasksApiClient, { enabled, pageSize, debounceMs, initialSearch, initialSort, model, }?: UseScheduledTasksOptions) => {
     items: ScheduledTaskDto[];
     searchQuery: string;
     setSearchQuery: Dispatch<SetStateAction<string>>;
@@ -5856,6 +6351,8 @@ export declare interface UseScheduledTasksOptions {
     debounceMs?: number;
     initialSearch?: string;
     initialSort?: ListScheduledTasksSortEnum;
+    /** Restricts the list to tasks of one model/application; changing it reloads from the first page. */
+    model?: string;
 }
 
 /**
@@ -5900,7 +6397,7 @@ export declare interface UseShareRecipientsCountResult {
 
 /**
  * Headless controller for the skill-archive upload flow: dialog visibility, the exact-filename
- * precheck, in-flight exclusion, and import completion. The host supplies the configured request
+ * precheck, in-flight exclusion, abort-on-close, and import completion. The host supplies the configured request
  * and observes completion/failure through the injected callbacks; the hook never imports app
  * contexts, i18n, or a configured API client.
  */
@@ -5908,8 +6405,8 @@ export declare const useSkillArchiveImport: <TResult>({ importArchive, onImporte
 
 /** Options accepted by {@link useSkillArchiveImport}. */
 export declare interface UseSkillArchiveImportOptions<TResult> {
-    /** Submits the selected archive; the host owns request configuration and the client. */
-    importArchive: (file: File) => Promise<TResult>;
+    /** Submits the selected archive; the host owns the client. `signal` aborts when the dialog closes or the hook unmounts mid-upload. */
+    importArchive: (file: File, signal: AbortSignal) => Promise<TResult>;
     /** Called once after a successful import (and any awaited host follow-up) settles. */
     onImported: (result: TResult) => void | Promise<void>;
     /** Called once when the import request, or the host's follow-up in {@link onImported}, fails. */
@@ -5924,13 +6421,15 @@ export declare interface UseSkillArchiveImportResult {
     isDialogOpen: boolean;
     /** Current phase of the import. */
     status: SkillArchiveImportStatus;
+    /** Whether an import request is in flight; the dialog stays open until it succeeds. */
+    isUploading: boolean;
     /** Reason the current/last selection was rejected locally; `undefined` once cleared. */
     selectionRejectionReason: SkillArchiveSelectionRejectionReason | undefined;
     /** Classified failure of the last import request; `undefined` outside a request failure. */
     errorKind: SkillArchiveImportErrorKind | undefined;
-    /** Opens the dialog, unless an import is already in flight. */
+    /** Opens the dialog and clears any previous rejection or request failure. */
     openDialog: () => void;
-    /** Closes the dialog and clears any rejection reason. */
+    /** Closes the dialog, aborting an in-flight import, and clears any rejection reason. */
     closeDialog: () => void;
     /** Wire to the dialog drop zone's `onChange`. */
     handleFilesSelected: (files: File[]) => void;
@@ -6039,7 +6538,7 @@ export declare interface UseSkillEditorLoadResult {
  * `client.createSkill`/`client.updateSkill`, and mapping the resulting
  * success/error/conflict outcomes to presentable state.
  */
-export declare const useSkillEditorSubmit: ({ bucket, isEditMode, files, filesContentRef, frontmatterRef, loadedPathRef, etagRef, returnUrl, refetchSkills, client, messages, onNavigate, onNotify, }: UseSkillEditorSubmitParams) => UseSkillEditorSubmitResult;
+export declare const useSkillEditorSubmit: ({ bucket, isEditMode, files, filesContentRef, frontmatterRef, loadedPathRef, etagRef, returnUrl, getCreateReturnUrl, refetchSkills, client, messages, onNavigate, onNotify, }: UseSkillEditorSubmitParams) => UseSkillEditorSubmitResult;
 
 /** Parameters accepted by {@link useSkillEditorSubmit}. */
 export declare interface UseSkillEditorSubmitParams {
@@ -6059,6 +6558,8 @@ export declare interface UseSkillEditorSubmitParams {
     etagRef: React.MutableRefObject<string | undefined>;
     /** Where to navigate on a successful save. */
     returnUrl: string;
+    /** Resolves the destination after creation from the normalized skill path. Defaults to `returnUrl`. */
+    getCreateReturnUrl?: (path: string) => string;
     /** Refetches the host's skill listing after a successful save. */
     refetchSkills: () => Promise<void>;
     /** Already-configured create/update operations. */
@@ -6079,6 +6580,10 @@ export declare interface UseSkillEditorSubmitResult {
     errors: SkillEditorErrors;
     /** General submit-time error, distinct from a stale-edit `conflict`. */
     submitError: string | undefined;
+    /** Whether `submitError` was caused by something a plain re-send can clear, rather than by the submission itself. */
+    isSubmitErrorRetryable: boolean;
+    /** Re-submits the values of the attempt that produced `submitError`. No-op before the first submit. */
+    retrySubmit: () => void;
     /** Present when the last save hit a stale-ETag conflict. */
     conflict: {
         message: string;
@@ -6098,10 +6603,11 @@ export declare interface UseSkillEditorSubmitResult {
 /**
  * Owns the Skill Editor's batch file upload workflow: validating a staged
  * batch, committing it atomically (supporting files plus an optional
- * `SKILL.md` manifest import, with a confirmation gate), and removing
+ * `SKILL.md` manifest import, with a confirmation gate), creating empty
+ * folders, expanding `.zip` archives for staging, and removing
  * already-committed nodes.
  */
-export declare const useSkillFileActions: ({ files, setFiles, filesContentRef, frontmatterRef, loadedValues, setLoadedValues, isEditMode, isDirty, setSelectedPath, messages, }: UseSkillFileActionsParams) => UseSkillFileActionsResult;
+export declare const useSkillFileActions: ({ files, setFiles, filesContentRef, frontmatterRef, loadedValues, setLoadedValues, isEditMode, isDirty, setSelectedPath, messages, pickFromFileSystem, }: UseSkillFileActionsParams) => UseSkillFileActionsResult;
 
 /** Parameters accepted by {@link useSkillFileActions}. */
 export declare interface UseSkillFileActionsParams {
@@ -6125,6 +6631,12 @@ export declare interface UseSkillFileActionsParams {
     setSelectedPath: Dispatch<SetStateAction<string>>;
     /** Localized messages, resolved by the host. */
     messages: SkillFileActionsMessages;
+    /**
+     * Opens the host's file-system picker; passed through unchanged as
+     * `fileActions.pickFromFileSystem`. Omit to hide the editor's "Open DIAL
+     * file system" entry.
+     */
+    pickFromFileSystem?: () => Promise<SkillFileSourceEntry[] | undefined>;
 }
 
 /** Return value of {@link useSkillFileActions}. */
@@ -6456,4 +6968,7 @@ export declare enum WithLogin {
     WithConfig = "with-config"
 }
 
+/** Returns `sections` with every root label usable as a unique first path segment, falling back to the tab id. */
+export declare const withRoutableRootLabels: <TSection extends DialFileManagerSection>(sections: readonly TSection[]) => TSection[];
+
 export { }