@acorex/modules 21.0.0-next.50 → 21.0.0-next.53

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@acorex/modules",
-  "version": "21.0.0-next.50",
+  "version": "21.0.0-next.53",
   "peerDependencies": {
-    "@acorex/platform": "21.0.0-next.50",
+    "@acorex/platform": "21.0.0-next.53",
     "@angular/service-worker": "^20.0.0",
     "d3": "^7.0.0",
     "html2canvas": "^1.0.0",

package/types/acorex-modules-ai-management.d.ts

@@ -1,10 +1,10 @@
 import * as i0 from '@angular/core';
 import { OnInit, OnDestroy } from '@angular/core';
 import * as i1 from '@acorex/platform/core';
-import { AXPModuleManifest, AXPDataSourceDefinitionProvider, AXPDataSourceDefinition, AXPMultiLanguageString } from '@acorex/platform/core';
+import { AXPModuleManifest, AXPDataSourceDefinitionProvider, AXPDataSourceDefinition, AXPMultiLanguageString, AXPFileListItem } from '@acorex/platform/core';
 import * as i2 from '@acorex/platform/layout/widgets';
 import { AXPEntity, AXPMenuProvider, AXPMenuProviderContext, AXPFileStorageService } from '@acorex/platform/common';
-import { AXPEntityDefinitionLoader, AXPEntityPreloadEntity, AXPEntityModel } from '@acorex/platform/layout/entity';
+import { AXPEntityDefinitionLoader, AXPEntityPreloadEntity, AXPEntityService, AXPEntityModel } from '@acorex/platform/layout/entity';
 import { AXPPermissionDefinitionProvider, AXPPermissionDefinitionProviderContext } from '@acorex/platform/auth';
 
 declare class AXMAiManagementModule {
@@ -310,13 +310,36 @@ declare class AXMAiManagementMenuProvider implements AXPMenuProvider {
     static ɵprov: i0.ɵɵInjectableDeclaration<AXMAiManagementMenuProvider>;
 }
 
+/** Dynamic assist access permissions (`Assist.{name}.Use`). */
+declare const AXMAiAssistPermissionKeys: {
+    readonly Use: "AiManagement:Permission:Assist.Use";
+    readonly useForAssist: (assistName: string) => string;
+};
 declare const AXMPermissionsKeys: {
     readonly AiManagement: {
         readonly Management: "AiManagement:Permission:Management";
+        readonly Assist: {
+            readonly Use: "AiManagement:Permission:Assist.Use";
+            readonly useForAssist: (assistName: string) => string;
+        };
     };
 };
 
+/** One assist row mapped for permission definition children. */
+interface AXMAiAssistPermissionRow {
+    name: string;
+    title: string;
+    description?: string;
+}
+/**
+ * Loads assist catalog rows for dynamic permission definitions.
+ * Skips rows without a stable programmatic `name`.
+ */
+declare function loadAssistPermissionRows(entityService: AXPEntityService, localeId: string): Promise<AXMAiAssistPermissionRow[]>;
+
 declare class AXMPermissionDefinitionProvider implements AXPPermissionDefinitionProvider {
+    private readonly entityService;
+    private readonly localeId;
     define(context: AXPPermissionDefinitionProviderContext): Promise<void>;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXMPermissionDefinitionProvider, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<AXMPermissionDefinitionProvider>;
@@ -329,6 +352,11 @@ declare class AXMPermissionDefinitionProvider implements AXPPermissionDefinition
 declare const AXPAiManagementSettings: {
     /** Assist primary key (`id`) used when no assist is explicitly selected (tenant-scoped). */
     readonly DefaultAssistId: "AiManagement:Setting:DefaultAssistId";
+    /**
+     * System instructions prepended to every assist/agent chat system prompt in {@link AXPAiEngine}.
+     * Empty string means no global layer (default).
+     */
+    readonly GlobalSystemPrompt: "AiManagement:Setting:GlobalSystemPrompt";
     readonly Providers: {
         readonly Gemini: {
             readonly ApiKey: "AiManagement:Setting:Providers.Gemini.ApiKey";
@@ -430,8 +458,6 @@ interface AXMAiManagementAgentEntityModel extends AXPEntityModel<string> {
     toolIds?: unknown;
     queryIds?: unknown;
     maxSteps?: number;
-    /** When true, this agent is offered in Conversation “Chat with AI” and runs as a direct agent chat. */
-    isAssist?: boolean;
 }
 
 /** Aligns with {@link AXPAiPlanningMode} in ai-engine.types (avoid circular imports). */
@@ -453,7 +479,13 @@ interface AXMAiManagementAssistEntityModel extends AXPEntityModel<string> {
         name?: string;
     };
     initialMessages?: string | null;
+    /** Suggested first user messages shown in chat before the user sends anything. */
+    starterPrompts?: {
+        text: AXPMultiLanguageString;
+    }[] | null;
     systemPrompt?: string;
+    /** Knowledge-base attachments (PDF and image formats) for this assist. */
+    knowledgeFiles?: AXPFileListItem[] | null;
     delegatedAgents?: {
         agent: {
             type?: string;
@@ -464,6 +496,8 @@ interface AXMAiManagementAssistEntityModel extends AXPEntityModel<string> {
 
 /** Prefix for supervisor-delegated specialist tools (`${AXPAI_SUPERVISOR_AGENT_TOOL_PREFIX}${agentId}`). */
 declare const AXPAI_SUPERVISOR_AGENT_TOOL_PREFIX: "agent:";
+/** Catalog `name` of the conversation follow-up delegated agent (engine auto-invoke). */
+declare const AXPAI_CONVERSATION_FOLLOW_UP_AGENT_NAME: "follow-up-prompt-generator";
 /** Default cap for main assist / direct-agent chat tool rounds (one provider call per step). */
 declare const AXPAI_ENGINE_DEFAULT_MAX_STEPS = 16;
 /** Default cap for delegated specialist sub-runs when the agent row has no positive `maxSteps`. */
@@ -574,6 +608,18 @@ interface AXPAiChatNodeResponse {
     type: 'node';
     content: unknown;
 }
+interface AXPAiChatFollowUpCommand {
+    name: string;
+    options?: unknown;
+}
+interface AXPAiChatFollowUpItem {
+    text: string | AXPMultiLanguageString;
+    command: AXPAiChatFollowUpCommand;
+}
+interface AXPAiChatFollowUpResponse {
+    type: 'followUp';
+    content: AXPAiChatFollowUpItem[];
+}
 /** Assistant-side tool / agent invocation segment (replay + OpenAI `tool_calls`). */
 interface AXPAiChatToolInvocationContent {
     command: string;
@@ -597,7 +643,7 @@ interface AXPAiChatToolResultResponse {
 /**
  * Segments a delegated specialist returns to the supervisor (replayable in UI; no tool-call shapes).
  */
-type AXPAiDelegatedAgentResultSegment = AXPAiChatTextResponse | AXPAiChatThinkResponse | AXPAiChatFileResponse | AXPAiChatNodeResponse;
+type AXPAiDelegatedAgentResultSegment = AXPAiChatTextResponse | AXPAiChatThinkResponse | AXPAiChatFileResponse | AXPAiChatNodeResponse | AXPAiChatFollowUpResponse;
 /**
  * Tool-role {@code agent_result} JSON body: either an error or ordered {@code data.responses} from the specialist run.
  */
@@ -617,7 +663,7 @@ interface AXPAiChatAgentResultResponse {
     name?: string;
     content: AXPAiDelegatedAgentResultPayload;
 }
-type AXPAiChatResponse = AXPAiChatTextResponse | AXPAiChatThinkResponse | AXPAiChatFileResponse | AXPAiChatNodeResponse | AXPAiChatToolAssistantResponse | AXPAiChatAgentAssistantResponse | AXPAiChatToolResultResponse | AXPAiChatAgentResultResponse;
+type AXPAiChatResponse = AXPAiChatTextResponse | AXPAiChatThinkResponse | AXPAiChatFileResponse | AXPAiChatNodeResponse | AXPAiChatFollowUpResponse | AXPAiChatToolAssistantResponse | AXPAiChatAgentAssistantResponse | AXPAiChatToolResultResponse | AXPAiChatAgentResultResponse;
 /**
  * One chat line in the persisted transcript (`user` / `assistant` / `system` / `tool`).
  * Optional {@link AXPAiChatMessage.delegatedReflection} marks ephemeral delegated sub-run reflections.
@@ -799,6 +845,27 @@ declare function axpAiChatToolResultBodyJson(message: AXPAiChatMessage): string;
 declare function axpAiSupervisorAgentToolName(agentCatalogId: string): string;
 declare function axpAiParseSupervisorAgentToolName(toolName: string): string | null;
 declare function axpAiMergePlainAssistantTextTurn(messages: AXPAiChatMessage[]): AXPAiChatMessage[];
+/** Normalizes one follow-up chip command object from model JSON. */
+declare function axpAiNormalizeFollowUpCommand(raw: unknown): AXPAiChatFollowUpCommand | null;
+/** Normalizes one follow-up chip row (`text` + `command`). */
+declare function axpAiNormalizeFollowUpItem(raw: unknown): AXPAiChatFollowUpItem | null;
+/** Normalizes follow-up `content` arrays; invalid rows are skipped. */
+declare function axpAiNormalizeFollowUpContent(raw: unknown): AXPAiChatFollowUpItem[];
+/**
+ * Whether the current user turn already has a usable {@code followUp} segment from the follow-up specialist.
+ */
+declare function axpAiTranscriptAlreadyHasFollowUpInTurn(messages: AXPAiChatMessage[], followUpAgentId: string): boolean;
+/**
+ * Engine may auto-call the follow-up specialist after the supervisor finishes, unless the turn is trivial.
+ */
+declare function axpAiShouldAutoInvokeFollowUpAgent(messages: AXPAiChatMessage[]): boolean;
+/** Builds the `query` argument for an automatic follow-up specialist sub-run. */
+declare function axpAiBuildAutoFollowUpAgentQuery(messages: AXPAiChatMessage[]): string;
+/**
+ * Appends delegated {@code followUp} / {@code node} / {@code file} segments from tool {@code agent_result}
+ * lines onto the final supervisor assistant message when the model omitted them.
+ */
+declare function axpAiReconcileSupervisorFinalAssistantWithDelegatedOutcomes(messages: AXPAiChatMessage[]): AXPAiChatMessage[];
 declare function axpAiPruneAssistantPiecesToFirstToolOnly(messages: AXPAiChatMessage[]): AXPAiChatMessage[];
 declare function axpAiChatDelegatedReflectionAssistantMessage(reflectionText: string): AXPAiChatMessage;
 declare function axpAiChatMessageIsDelegatedReflectionExcluded(message: AXPAiChatMessage): boolean;
@@ -814,6 +881,17 @@ declare function axpAiStripAssistInitialHtmlToPlain(raw: string): string;
  */
 declare function axpAiAssistInitialMessagesToTranscript(raw: string | null | undefined): AXPAiChatMessage[];
 
+type AssistStarterPromptsSource = Pick<AXMAiManagementAssistEntityModel, 'starterPrompts'> | Pick<AXPAiEffectiveAssistRow, 'starterPrompts'> | null | undefined;
+/**
+ * Returns non-empty starter prompt labels, preserving repeater order.
+ * Resolve locale in the template via the translate pipe.
+ */
+declare function axpAiAssistStarterPromptLabels(source: AssistStarterPromptsSource): Array<string | AXPMultiLanguageString>;
+/**
+ * Returns non-empty starter prompt strings for the active locale, preserving repeater order.
+ */
+declare function axpAiAssistStarterPromptTexts(source: AssistStarterPromptsSource, locale: string): string[];
+
 /**
  * Builds {@link AXPAiPlatformRuntimeContext} from session and user-scoped regional settings.
  */
@@ -849,7 +927,7 @@ interface AXPAiChatToolRunContext {
     modelEntityId?: string;
     /** Set during a delegated agent sub-run (specialist executing registry tools). */
     agentId?: string;
-    /** AiAgent catalog `name` (slug). Demisco chat API expects this value in `agent_uuid`. */
+    /** Assist or AiAgent catalog `name` (Demisco `agent_uuid` for Demis transport). */
     agentName?: string;
     /** Optional Demisco chat session id (`session_uuid` in multipart). */
     demisSessionUuid?: string;
@@ -1143,5 +1221,5 @@ declare class AXMAiAssistPromptBoxComponent implements OnInit, OnDestroy {
     static ɵcmp: i0.ɵɵComponentDeclaration<AXMAiAssistPromptBoxComponent, "axm-ai-assist-prompt-box", never, { "title": { "alias": "title"; "required": true; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "initialPrompt": { "alias": "initialPrompt"; "required": false; "isSignal": true; }; "contentMaxWidthPx": { "alias": "contentMaxWidthPx"; "required": false; "isSignal": true; }; "initialAssistId": { "alias": "initialAssistId"; "required": false; "isSignal": true; }; "initialDirectAgentId": { "alias": "initialDirectAgentId"; "required": false; "isSignal": true; }; "runPrompt": { "alias": "runPrompt"; "required": true; "isSignal": true; }; "requestClose": { "alias": "requestClose"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-export { AIMANAGEMENT_CHAT_GENERATE_IMAGE_COMMAND_KEY, AIMANAGEMENT_CHAT_SYNTHESIZE_SPEECH_COMMAND_KEY, AIMANAGEMENT_CHAT_TRANSCRIBE_SPEECH_COMMAND_KEY, AIMANAGEMENT_EXTRACT_DOCUMENT_TEXT_COMMAND_KEY, AIMANAGEMENT_STRUCTURED_TEXT_COMPLETION_COMMAND_KEY, AI_AGENT_CATALOG_DATASOURCE_NAME, AI_CHAT_ATTACHMENT_CATEGORY, AI_CHAT_ATTACHMENT_REF_TYPE, AI_CHAT_GENERATED_IMAGE_REF_TYPE, AI_CHAT_GENERATED_SPEECH_REF_TYPE, AI_COMMAND_REGISTRY_CATALOG_DATASOURCE_NAME, AI_GENERATED_IMAGE_MAX_REMOTE_URL_IN_TOOL, AI_MODEL_CATALOG_DATASOURCE_NAME, AI_MODEL_IMAGE_CATALOG_DATASOURCE_NAME, AI_MODEL_SPEECH_CATALOG_DATASOURCE_NAME, AI_MODEL_TTS_CATALOG_DATASOURCE_NAME, AI_QUERY_REGISTRY_CATALOG_DATASOURCE_NAME, AXMAiAgentCatalogDataSourceDefinition, AXMAiAssistPromptBoxComponent, AXMAiAssistPromptBoxService, AXMAiCommandRegistryCatalogDataSourceDefinition, AXMAiManagementEntityProvider, AXMAiManagementMenuProvider, AXMAiManagementModule, AXMAiModelCatalogDataSourceDefinition, AXMAiQueryRegistryCatalogDataSourceDefinition, AXMPermissionDefinitionProvider, AXMPermissionsKeys, AXPAI_DELEGATED_AGENT_DEFAULT_MAX_STEPS, AXPAI_DOCUMENT_VISION_DEFAULT_USER_INSTRUCTION, AXPAI_DOCUMENT_VISION_EXTRACTION_SYSTEM, AXPAI_ENGINE_DEFAULT_MAX_STEPS, AXPAI_SUPERVISOR_AGENT_TOOL_PREFIX, AXPAiAssistChatModelCatalogService, AXPAiAssistDefaultMaxStructuredRetries, AXPAiAssistDefaultStructuredMaxTokens, AXPAiAssistService, AXPAiChatToolRunContextService, AXPAiDefaultModelPickerService, AXPAiEngine, AXPAiManagementMenuKeys, AXPAiManagementSettings, AXPAiManagerService, AXPAiPlatformRuntimeContextBuilder, AXPAiStructuredOutputError, AiManagementManifest, RootConfig, axpAiAssistInitialMessagesToTranscript, axpAiChatAgentResultMessage, axpAiChatDelegatedReflectionAssistantMessage, axpAiChatMessageGetText, axpAiChatMessageIsDelegatedReflectionExcluded, axpAiChatMessagesFromProviderAssistant, axpAiChatTextMessage, axpAiChatToolOrAgentResultBodyJson, axpAiChatToolResultBodyJson, axpAiChatToolResultMessage, axpAiChatUserMessage, axpAiCoercePlanningAssistantTextToThink, axpAiCollectDelegatedAgentOutcomeResponses, axpAiDelegatedAgentOutcomeResponsesPlainText, axpAiDelegatedAgentPromptPreview, axpAiDelegatedSubTranscriptAppendFileArtifactFromToolResults, axpAiExtractLastStoredFileArtifactFromChatMessages, axpAiExtractStoredFileArtifactFromUnknown, axpAiMergePlainAssistantTextTurn, axpAiNormalizeHandlerResultToToolBody, axpAiParseDelegatedAgentResultSegmentsFromUnknown, axpAiParseSupervisorAgentToolName, axpAiPruneAssistantPiecesToFirstToolOnly, axpAiStripAssistInitialHtmlToPlain, axpAiSupervisorAgentToolName, axpAiToolCallFromAssistantToolMessage, blobOrFileFromImageResult, getAiChatCommandLlmParametersOverride, isChatPurposeModelRow, isImagePurposeModelRow, isSpeechPurposeModelRow, isTtsPurposeModelRow, modelRowHasPurpose, normalizeAiToolCommandArgs, normalizeModelPurposes, persistAiChatAttachmentImage, persistAiGeneratedImage, persistAiGeneratedSpeech };
-export type { AXMAiManagementAgentEntityModel, AXMAiManagementAssistEntityModel, AXMAiManagementAssistPlanningMode, AXMAiManagementModelChatTransport, AXMAiManagementModelEntityModel, AXMAiManagementModelPurposeSlug, AXMAiManagementOpenAiEndpointEntityModel, AXMAiModelPurposeSlug, AXPAiAssistPopupSize, AXPAiAssistPromptSubmitPayload, AXPAiAssistRunContext, AXPAiAssistRunInput, AXPAiAssistRunLoadingDialogSpec, AXPAiAssistRunResult, AXPAiAssistShowOptions, AXPAiAssistStructuredOutputAttemptRecord, AXPAiAssistStructuredOutputRunRaw, AXPAiAssistTokenUsageSnapshot, AXPAiAssistUserMediaAttachment, AXPAiChatAgentAssistantResponse, AXPAiChatAgentResultBody, AXPAiChatAgentResultResponse, AXPAiChatFileResponse, AXPAiChatMessage, AXPAiChatModelListItem, AXPAiChatModelListRequest, AXPAiChatNodeResponse, AXPAiChatResponse, AXPAiChatTextResponse, AXPAiChatThinkResponse, AXPAiChatToolAssistantResponse, AXPAiChatToolInvocationContent, AXPAiChatToolResultBody, AXPAiChatToolResultResponse, AXPAiChatToolRunContext, AXPAiChatTransport, AXPAiDelegatedAgentResultPayload, AXPAiDelegatedAgentResultSegment, AXPAiDelegatedAgentTranscriptEntry, AXPAiDelegatedNestedToolCallContext, AXPAiDelegatedParameterBinding, AXPAiDelegatedParameterDefinition, AXPAiEffectiveAgentRow, AXPAiEffectiveAssistRow, AXPAiEngineLastProviderPayload, AXPAiEngineRegistryToolFields, AXPAiEngineRunEvent, AXPAiEngineRunOptions, AXPAiEngineRunResult, AXPAiEngineUsageTotals, AXPAiExtractDocumentTextFromStoredFileRequest, AXPAiPlanningMode, AXPAiPlatformRuntimeContext, AXPAiStructuredTextCompletionOptions, AXPAiStructuredValidator, AXPAiToolCall, AXPAiToolSchema };
+export { AIMANAGEMENT_CHAT_GENERATE_IMAGE_COMMAND_KEY, AIMANAGEMENT_CHAT_SYNTHESIZE_SPEECH_COMMAND_KEY, AIMANAGEMENT_CHAT_TRANSCRIBE_SPEECH_COMMAND_KEY, AIMANAGEMENT_EXTRACT_DOCUMENT_TEXT_COMMAND_KEY, AIMANAGEMENT_STRUCTURED_TEXT_COMPLETION_COMMAND_KEY, AI_AGENT_CATALOG_DATASOURCE_NAME, AI_CHAT_ATTACHMENT_CATEGORY, AI_CHAT_ATTACHMENT_REF_TYPE, AI_CHAT_GENERATED_IMAGE_REF_TYPE, AI_CHAT_GENERATED_SPEECH_REF_TYPE, AI_COMMAND_REGISTRY_CATALOG_DATASOURCE_NAME, AI_GENERATED_IMAGE_MAX_REMOTE_URL_IN_TOOL, AI_MODEL_CATALOG_DATASOURCE_NAME, AI_MODEL_IMAGE_CATALOG_DATASOURCE_NAME, AI_MODEL_SPEECH_CATALOG_DATASOURCE_NAME, AI_MODEL_TTS_CATALOG_DATASOURCE_NAME, AI_QUERY_REGISTRY_CATALOG_DATASOURCE_NAME, AXMAiAgentCatalogDataSourceDefinition, AXMAiAssistPermissionKeys, AXMAiAssistPromptBoxComponent, AXMAiAssistPromptBoxService, AXMAiCommandRegistryCatalogDataSourceDefinition, AXMAiManagementEntityProvider, AXMAiManagementMenuProvider, AXMAiManagementModule, AXMAiModelCatalogDataSourceDefinition, AXMAiQueryRegistryCatalogDataSourceDefinition, AXMPermissionDefinitionProvider, AXMPermissionsKeys, AXPAI_CONVERSATION_FOLLOW_UP_AGENT_NAME, AXPAI_DELEGATED_AGENT_DEFAULT_MAX_STEPS, AXPAI_DOCUMENT_VISION_DEFAULT_USER_INSTRUCTION, AXPAI_DOCUMENT_VISION_EXTRACTION_SYSTEM, AXPAI_ENGINE_DEFAULT_MAX_STEPS, AXPAI_SUPERVISOR_AGENT_TOOL_PREFIX, AXPAiAssistChatModelCatalogService, AXPAiAssistDefaultMaxStructuredRetries, AXPAiAssistDefaultStructuredMaxTokens, AXPAiAssistService, AXPAiChatToolRunContextService, AXPAiDefaultModelPickerService, AXPAiEngine, AXPAiManagementMenuKeys, AXPAiManagementSettings, AXPAiManagerService, AXPAiPlatformRuntimeContextBuilder, AXPAiStructuredOutputError, AiManagementManifest, RootConfig, axpAiAssistInitialMessagesToTranscript, axpAiAssistStarterPromptLabels, axpAiAssistStarterPromptTexts, axpAiBuildAutoFollowUpAgentQuery, axpAiChatAgentResultMessage, axpAiChatDelegatedReflectionAssistantMessage, axpAiChatMessageGetText, axpAiChatMessageIsDelegatedReflectionExcluded, axpAiChatMessagesFromProviderAssistant, axpAiChatTextMessage, axpAiChatToolOrAgentResultBodyJson, axpAiChatToolResultBodyJson, axpAiChatToolResultMessage, axpAiChatUserMessage, axpAiCoercePlanningAssistantTextToThink, axpAiCollectDelegatedAgentOutcomeResponses, axpAiDelegatedAgentOutcomeResponsesPlainText, axpAiDelegatedAgentPromptPreview, axpAiDelegatedSubTranscriptAppendFileArtifactFromToolResults, axpAiExtractLastStoredFileArtifactFromChatMessages, axpAiExtractStoredFileArtifactFromUnknown, axpAiMergePlainAssistantTextTurn, axpAiNormalizeFollowUpCommand, axpAiNormalizeFollowUpContent, axpAiNormalizeFollowUpItem, axpAiNormalizeHandlerResultToToolBody, axpAiParseDelegatedAgentResultSegmentsFromUnknown, axpAiParseSupervisorAgentToolName, axpAiPruneAssistantPiecesToFirstToolOnly, axpAiReconcileSupervisorFinalAssistantWithDelegatedOutcomes, axpAiShouldAutoInvokeFollowUpAgent, axpAiStripAssistInitialHtmlToPlain, axpAiSupervisorAgentToolName, axpAiToolCallFromAssistantToolMessage, axpAiTranscriptAlreadyHasFollowUpInTurn, blobOrFileFromImageResult, getAiChatCommandLlmParametersOverride, isChatPurposeModelRow, isImagePurposeModelRow, isSpeechPurposeModelRow, isTtsPurposeModelRow, loadAssistPermissionRows, modelRowHasPurpose, normalizeAiToolCommandArgs, normalizeModelPurposes, persistAiChatAttachmentImage, persistAiGeneratedImage, persistAiGeneratedSpeech };
+export type { AXMAiAssistPermissionRow, AXMAiManagementAgentEntityModel, AXMAiManagementAssistEntityModel, AXMAiManagementAssistPlanningMode, AXMAiManagementModelChatTransport, AXMAiManagementModelEntityModel, AXMAiManagementModelPurposeSlug, AXMAiManagementOpenAiEndpointEntityModel, AXMAiModelPurposeSlug, AXPAiAssistPopupSize, AXPAiAssistPromptSubmitPayload, AXPAiAssistRunContext, AXPAiAssistRunInput, AXPAiAssistRunLoadingDialogSpec, AXPAiAssistRunResult, AXPAiAssistShowOptions, AXPAiAssistStructuredOutputAttemptRecord, AXPAiAssistStructuredOutputRunRaw, AXPAiAssistTokenUsageSnapshot, AXPAiAssistUserMediaAttachment, AXPAiChatAgentAssistantResponse, AXPAiChatAgentResultBody, AXPAiChatAgentResultResponse, AXPAiChatFileResponse, AXPAiChatFollowUpCommand, AXPAiChatFollowUpItem, AXPAiChatFollowUpResponse, AXPAiChatMessage, AXPAiChatModelListItem, AXPAiChatModelListRequest, AXPAiChatNodeResponse, AXPAiChatResponse, AXPAiChatTextResponse, AXPAiChatThinkResponse, AXPAiChatToolAssistantResponse, AXPAiChatToolInvocationContent, AXPAiChatToolResultBody, AXPAiChatToolResultResponse, AXPAiChatToolRunContext, AXPAiChatTransport, AXPAiDelegatedAgentResultPayload, AXPAiDelegatedAgentResultSegment, AXPAiDelegatedAgentTranscriptEntry, AXPAiDelegatedNestedToolCallContext, AXPAiDelegatedParameterBinding, AXPAiDelegatedParameterDefinition, AXPAiEffectiveAgentRow, AXPAiEffectiveAssistRow, AXPAiEngineLastProviderPayload, AXPAiEngineRegistryToolFields, AXPAiEngineRunEvent, AXPAiEngineRunOptions, AXPAiEngineRunResult, AXPAiEngineUsageTotals, AXPAiExtractDocumentTextFromStoredFileRequest, AXPAiPlanningMode, AXPAiPlatformRuntimeContext, AXPAiStructuredTextCompletionOptions, AXPAiStructuredValidator, AXPAiToolCall, AXPAiToolSchema };

package/types/acorex-modules-assessment-management.d.ts

@@ -227,6 +227,115 @@ declare function normalizeQuestionHintFromEntityRow(row: unknown): AXMAssessment
  */
 declare function parseQuestionHintPartialFromRecord(row: Record<string, unknown> | null | undefined): AXMAssessmentQuestionHintPartial | undefined;
 
+/**
+ * Display settings for questionnaire viewer
+ */
+/** Whether the respondent can save a draft before final submit. */
+type QuestionnaireCompletionMode$1 = 'submit-only' | 'save-and-continue';
+interface QuestionnaireDisplaySettings {
+    /**
+     * View mode: single-page, page-per-group, page-per-question, side-menu
+     */
+    viewMode?: 'single-page' | 'page-per-group' | 'page-per-question' | 'side-menu';
+    /**
+     * submit-only: final submit only; save-and-continue: draft save + submit.
+     */
+    completionMode?: QuestionnaireCompletionMode$1;
+    /**
+     * Show progress bar
+     */
+    showProgressBar?: boolean;
+    /**
+     * Progress calculation mode: answered or navigation
+     */
+    progressMode?: 'answered' | 'navigation';
+    /**
+     * Show timer
+     */
+    showTimer?: boolean;
+    /**
+     * Show question numbers
+     */
+    showQuestionNumbers?: boolean;
+    /**
+     * Auto-save answers as user types
+     */
+    autoSave?: boolean;
+    /**
+     * Show validation errors inline
+     */
+    showValidationErrors?: boolean;
+    /**
+     * Allow skipping questions (if not required)
+     */
+    allowSkipping?: boolean;
+    /**
+     * Show question counter (e.g., "Question 3 of 10")
+     */
+    showQuestionCounter?: boolean;
+    /**
+     * Validation timing strategy:
+     * - step: validate on each step/section navigation
+     * - end: validate only at final submit
+     * Default: step
+     */
+    validationStrategy?: 'step' | 'end';
+}
+/**
+ * Value structure stored in entity (simplified for persistence)
+ */
+interface QuestionnaireBuilderValue {
+    sections: Array<{
+        name: string;
+        title: AXPMultiLanguageString;
+        description?: AXPMultiLanguageString;
+        order: number;
+        tags?: string[];
+        isVisible?: boolean | AXPExpression;
+        items: Array<{
+            name: string;
+            questionBankItemId: string;
+            order: number;
+            isRequired?: boolean | AXPExpression;
+            isVisible?: boolean | AXPExpression;
+            interfaceOverride?: AXPWidgetNode;
+            hint?: AXMAssessmentQuestionHintPartial;
+            comment?: Partial<AXMAssessmentQuestionCommentConfig>;
+            tags?: string[];
+        }>;
+    }>;
+    /**
+     * Display settings for questionnaire viewer
+     */
+    displaySettings?: QuestionnaireDisplaySettings;
+}
+
+type AXMAssessmentSessionRole = 'responder' | 'supervisor' | 'reviewer';
+type AXMAssessmentSessionStatus = 'not-started' | 'in-progress' | 'submitted' | 'under-review' | 'approved' | 'rejected' | 'completed';
+interface AXMAssessmentManagementAssessmentSessionEntityModel extends AXPEntityModel<string> {
+    caseId: string;
+    responderId: string;
+    role: AXMAssessmentSessionRole;
+    /** Status plugin field (`assessment-management.status.session`). */
+    statusId?: AXMAssessmentSessionStatus;
+    startedAt?: Date;
+    lastSavedAt?: Date;
+    timeSpent?: number;
+    progressPercentage: number;
+    answeredQuestionsCount: number;
+    answers: Record<string, unknown>;
+    previousId?: string;
+}
+
+/**
+ * Serializable context for assessment fill in popup (functions cannot cross popup data).
+ */
+interface QuestionnaireAssessmentFillContext {
+    caseId: string;
+    sessionId?: string | null;
+    responderId: string;
+    role: AXMAssessmentSessionRole;
+}
 /**
  * View mode for displaying questionnaire
  * - single-page: All groups in a single page
@@ -306,6 +415,10 @@ interface QuestionnaireViewerConfig {
      * Default: step
      */
     validationStrategy?: QuestionnaireValidationStrategy;
+    /**
+     * submit-only: no draft save; save-and-continue: show Save and continue before submit.
+     */
+    completionMode?: QuestionnaireCompletionMode$1;
 }
 /**
  * Attachment item for display (from question bank item attachments).
@@ -367,83 +480,6 @@ interface QuestionnaireViewerData {
     sections: QuestionnaireViewerSection[];
 }
 
-/**
- * Display settings for questionnaire viewer
- */
-interface QuestionnaireDisplaySettings {
-    /**
-     * View mode: single-page, page-per-group, page-per-question, side-menu
-     */
-    viewMode?: 'single-page' | 'page-per-group' | 'page-per-question' | 'side-menu';
-    /**
-     * Show progress bar
-     */
-    showProgressBar?: boolean;
-    /**
-     * Progress calculation mode: answered or navigation
-     */
-    progressMode?: 'answered' | 'navigation';
-    /**
-     * Show timer
-     */
-    showTimer?: boolean;
-    /**
-     * Show question numbers
-     */
-    showQuestionNumbers?: boolean;
-    /**
-     * Auto-save answers as user types
-     */
-    autoSave?: boolean;
-    /**
-     * Show validation errors inline
-     */
-    showValidationErrors?: boolean;
-    /**
-     * Allow skipping questions (if not required)
-     */
-    allowSkipping?: boolean;
-    /**
-     * Show question counter (e.g., "Question 3 of 10")
-     */
-    showQuestionCounter?: boolean;
-    /**
-     * Validation timing strategy:
-     * - step: validate on each step/section navigation
-     * - end: validate only at final submit
-     * Default: step
-     */
-    validationStrategy?: 'step' | 'end';
-}
-/**
- * Value structure stored in entity (simplified for persistence)
- */
-interface QuestionnaireBuilderValue {
-    sections: Array<{
-        name: string;
-        title: AXPMultiLanguageString;
-        description?: AXPMultiLanguageString;
-        order: number;
-        tags?: string[];
-        isVisible?: boolean | AXPExpression;
-        items: Array<{
-            name: string;
-            questionBankItemId: string;
-            order: number;
-            isRequired?: boolean | AXPExpression;
-            isVisible?: boolean | AXPExpression;
-            interfaceOverride?: AXPWidgetNode;
-            hint?: AXMAssessmentQuestionHintPartial;
-            comment?: Partial<AXMAssessmentQuestionCommentConfig>;
-            tags?: string[];
-        }>;
-    }>;
-    /**
-     * Display settings for questionnaire viewer
-     */
-    displaySettings?: QuestionnaireDisplaySettings;
-}
-
 interface QuestionnaireValidationError {
     name: string;
     questionTitle: string;
@@ -535,6 +571,10 @@ declare class AXMQuestionnaireViewerComponent {
             question: QuestionnaireViewerQuestion;
         }>;
         getSectionUnansweredRequiredCount: (sectionName: string) => number;
+        saveDraft: () => {
+            success: boolean;
+            answers: Record<string, any>;
+        };
         submit: () => Promise<{
             success: boolean;
             answers: Record<string, any>;
@@ -678,6 +718,10 @@ declare class AXMQuestionnaireViewerComponent {
             question: QuestionnaireViewerQuestion;
         }>;
         getSectionUnansweredRequiredCount: (sectionName: string) => number;
+        saveDraft: () => {
+            success: boolean;
+            answers: Record<string, any>;
+        };
         submit: () => Promise<{
             success: boolean;
             answers: Record<string, any>;
@@ -783,6 +827,13 @@ declare class AXMQuestionnaireViewerComponent {
      * Must be called before transitioning to review while viewer is still rendered.
      */
     getReviewContext(): Record<string, any>;
+    /**
+     * Collect answers for draft save (no required-field validation).
+     */
+    saveDraft(): {
+        success: boolean;
+        answers: Record<string, any>;
+    };
     /**
      * Submit questionnaire
      * Validates all questions before submitting
@@ -889,7 +940,8 @@ interface PostQuestionnaireConfig {
 /**
  * Entity-level display options (viewer / builder preview). Subset of {@link QuestionnaireDisplaySettings}.
  */
-type QuestionnaireEntityDisplaySettings = Pick<QuestionnaireDisplaySettings, 'viewMode' | 'showProgressBar' | 'showTimer' | 'showQuestionNumbers' | 'validationStrategy'>;
+type QuestionnaireCompletionMode = 'submit-only' | 'save-and-continue';
+type QuestionnaireEntityDisplaySettings = Pick<QuestionnaireDisplaySettings, 'viewMode' | 'showProgressBar' | 'showTimer' | 'showQuestionNumbers' | 'validationStrategy' | 'completionMode'>;
 declare const DEFAULT_PRE_QUESTIONNAIRE_CONFIG: PreQuestionnaireConfig;
 declare const DEFAULT_POST_QUESTIONNAIRE_CONFIG: PostQuestionnaireConfig;
 declare const DEFAULT_QUESTIONNAIRE_ENTITY_DISPLAY: QuestionnaireEntityDisplaySettings;
@@ -923,6 +975,8 @@ declare const VIEW_MODE_VALUES: readonly ["single-page", "page-per-group", "page
 type ViewModeValue = (typeof VIEW_MODE_VALUES)[number];
 declare const VALIDATION_STRATEGY_VALUES: readonly ["step", "end"];
 type ValidationStrategyValue = (typeof VALIDATION_STRATEGY_VALUES)[number];
+declare const COMPLETION_MODE_VALUES: readonly ["submit-only", "save-and-continue"];
+type CompletionModeValue = (typeof COMPLETION_MODE_VALUES)[number];
 /**
  * Coerces stored view mode (string or SelectBox `{ id }`) to a known value.
  */
@@ -931,12 +985,16 @@ declare function normalizeViewMode(value: unknown): ViewModeValue;
  * Coerces stored validation strategy (string or SelectBox `{ id }`) to a known value.
  */
 declare function normalizeValidationStrategy(value: unknown): ValidationStrategyValue;
+/**
+ * Coerces stored completion mode (string or SelectBox `{ id }`) to a known value.
+ */
+declare function normalizeCompletionMode(value: unknown): CompletionModeValue;
 /**
  * Maps entity `display` to {@link QuestionnaireDisplaySettings} (defaults when omitted).
  */
 declare function toDisplaySettings(q: Partial<AXMAssessmentManagementQuestionnaireEntityModel> | null | undefined): QuestionnaireDisplaySettings | null;
 
-type AXMAssessmentCaseStatus = 'active' | 'closed' | 'cancelled';
+type AXMAssessmentCaseStatus = 'draft' | 'active' | 'in-progress' | 'closed' | 'cancelled';
 interface AXMAssessmentManagementAssessmentCaseEntityModel extends AXPEntityModel<string> {
     /**
      * Single questionnaire assigned to this case.
@@ -951,22 +1009,8 @@ interface AXMAssessmentManagementAssessmentCaseEntityModel extends AXPEntityMode
      * Target entity (e.g. AssetManagement.Asset, HumanCapital.Employee).
      */
     subjectRef: AXPEntityReference;
-    status: AXMAssessmentCaseStatus;
-}
-
-type AXMAssessmentSessionRole = 'responder' | 'supervisor' | 'reviewer';
-type AXMAssessmentSessionStatus = 'not-started' | 'in-progress' | 'submitted' | 'under-review' | 'approved' | 'rejected' | 'completed';
-interface AXMAssessmentManagementAssessmentSessionEntityModel extends AXPEntityModel<string> {
-    caseId: string;
-    responderId: string;
-    role: AXMAssessmentSessionRole;
-    startedAt?: Date;
-    lastSavedAt?: Date;
-    timeSpent?: number;
-    progressPercentage: number;
-    answeredQuestionsCount: number;
-    answers: Record<string, unknown>;
-    previousId?: string;
+    /** Status plugin field (`assessment-management.status.case`). */
+    statusId?: AXMAssessmentCaseStatus;
 }
 
 /** Primitive type of the evaluated value (coercion after expression runs). */
@@ -1037,6 +1081,14 @@ interface AXMQuestionnaireViewerServiceConfig {
      * When provided, called on submit. Should save and return result for summary.
      */
     submitHandler?: (answers: Record<string, any>) => Promise<SummaryPlaceholderValues | null | void>;
+    /**
+     * When provided, called on save-and-continue (draft). Should persist without final validation.
+     */
+    saveHandler?: (answers: Record<string, any>) => Promise<void>;
+    /**
+     * Assessment case/session ids for fill popup persistence (popup cannot receive function handlers).
+     */
+    assessmentFillContext?: QuestionnaireAssessmentFillContext;
 }
 interface AXMQuestionnaireViewerServiceResult {
     /**
@@ -1059,6 +1111,10 @@ interface AXMQuestionnaireViewerServiceResult {
      * Whether the dialog was submitted (true) or closed (false)
      */
     submitted: boolean;
+    /**
+     * Draft saved via save-and-continue without final submit.
+     */
+    saved?: boolean;
 }
 /**
  * Opens the questionnaire viewer dialog and evaluates questionnaire calculations when a questionnaire id is provided.
@@ -1245,6 +1301,10 @@ declare class AXMQuestionnaireViewerPageComponent extends AXPPageLayoutBaseCompo
             question: QuestionnaireViewerQuestion;
         }>;
         getSectionUnansweredRequiredCount: (sectionName: string) => number;
+        saveDraft: () => {
+            success: boolean;
+            answers: Record<string, any>;
+        };
         submit: () => Promise<{
             success: boolean;
             answers: Record<string, any>;
@@ -1403,6 +1463,10 @@ declare class AXMQuestionnaireViewerStandalonePageComponent implements OnInit {
             question: QuestionnaireViewerQuestion;
         }>;
         getSectionUnansweredRequiredCount: (sectionName: string) => number;
+        saveDraft: () => {
+            success: boolean;
+            answers: Record<string, any>;
+        };
         submit: () => Promise<{
             success: boolean;
             answers: Record<string, any>;
@@ -1455,5 +1519,5 @@ declare class AXMQuestionnaireViewerStandalonePageComponent implements OnInit {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXMQuestionnaireViewerStandalonePageComponent, "axm-questionnaire-viewer-standalone-page", never, {}, {}, never, never, true, never>;
 }
 
-export { AXMAssessmentManagementEntityProvider, AXMAssessmentManagementFeatureDefinitionProvider, AXMAssessmentManagementFeatureKeys, AXMAssessmentManagementMenuProvider, AXMAssessmentManagementModule, AXMAssessmentManagementPermissionDefinitionProvider, AXMAssessmentManagementPermissionKeys, AXMAssessmentManagementSearchCommandProvider, AXMQuestionnaireViewerPageComponent, AXMQuestionnaireViewerService, AXMQuestionnaireViewerStandalonePageComponent, AXPAssessmentManagementMenuKeys, DEFAULT_POST_QUESTIONNAIRE_CONFIG, DEFAULT_PRE_QUESTIONNAIRE_CONFIG, DEFAULT_QUESTIONNAIRE_ENTITY_DISPLAY, DEFAULT_QUESTION_COMMENT_CONFIG, DEFAULT_QUESTION_HINT_CONFIG, RootConfig, diffQuestionCommentOverride, diffQuestionHintOverride, getQuestionAnswerCommentStoragePath, mergeQuestionCommentConfig, mergeQuestionHintForViewer, normalizeQuestionCommentConfig, normalizeQuestionHintConfig, normalizeQuestionHintFromEntityRow, normalizeQuestionHintMode, normalizeValidationStrategy, normalizeViewMode, parseQuestionHintPartialFromRecord, readHintFieldsFromRecord, resolveWidgetNodeFromMetaDataDefinitionInterface, stripQuestionBankInterfaceMetadata, toDisplaySettings, toPrePostConfig };
-export type { AXMAssessmentCaseStatus, AXMAssessmentManagementAssessmentCaseEntityModel, AXMAssessmentManagementAssessmentSessionEntityModel, AXMAssessmentManagementQuestionBankItemEntityModel, AXMAssessmentManagementQuestionnaireCalculationEntityModel, AXMAssessmentManagementQuestionnaireEntityModel, AXMAssessmentQuestionCommentConfig, AXMAssessmentQuestionHintConfig, AXMAssessmentQuestionHintConfigOff, AXMAssessmentQuestionHintConfigShown, AXMAssessmentQuestionHintMode, AXMAssessmentQuestionHintPartial, AXMAssessmentQuestionHintVisualMode, AXMAssessmentSessionRole, AXMAssessmentSessionStatus, AXMQuestionBankItemInterfaceMetadata, AXMQuestionBankItemInterfaceValue, AXMQuestionnaireViewerServiceConfig, AXMQuestionnaireViewerServiceResult, PostQuestionnaireConfig, PrePostConfig, PrePostContentValue, PreQuestionnaireConfig, QuestionnaireCalculationResultKind, QuestionnaireCalculationValues, QuestionnaireEntityDisplaySettings };
+export { AXMAssessmentManagementEntityProvider, AXMAssessmentManagementFeatureDefinitionProvider, AXMAssessmentManagementFeatureKeys, AXMAssessmentManagementMenuProvider, AXMAssessmentManagementModule, AXMAssessmentManagementPermissionDefinitionProvider, AXMAssessmentManagementPermissionKeys, AXMAssessmentManagementSearchCommandProvider, AXMQuestionnaireViewerPageComponent, AXMQuestionnaireViewerService, AXMQuestionnaireViewerStandalonePageComponent, AXPAssessmentManagementMenuKeys, DEFAULT_POST_QUESTIONNAIRE_CONFIG, DEFAULT_PRE_QUESTIONNAIRE_CONFIG, DEFAULT_QUESTIONNAIRE_ENTITY_DISPLAY, DEFAULT_QUESTION_COMMENT_CONFIG, DEFAULT_QUESTION_HINT_CONFIG, RootConfig, diffQuestionCommentOverride, diffQuestionHintOverride, getQuestionAnswerCommentStoragePath, mergeQuestionCommentConfig, mergeQuestionHintForViewer, normalizeCompletionMode, normalizeQuestionCommentConfig, normalizeQuestionHintConfig, normalizeQuestionHintFromEntityRow, normalizeQuestionHintMode, normalizeValidationStrategy, normalizeViewMode, parseQuestionHintPartialFromRecord, readHintFieldsFromRecord, resolveWidgetNodeFromMetaDataDefinitionInterface, stripQuestionBankInterfaceMetadata, toDisplaySettings, toPrePostConfig };
+export type { AXMAssessmentCaseStatus, AXMAssessmentManagementAssessmentCaseEntityModel, AXMAssessmentManagementAssessmentSessionEntityModel, AXMAssessmentManagementQuestionBankItemEntityModel, AXMAssessmentManagementQuestionnaireCalculationEntityModel, AXMAssessmentManagementQuestionnaireEntityModel, AXMAssessmentQuestionCommentConfig, AXMAssessmentQuestionHintConfig, AXMAssessmentQuestionHintConfigOff, AXMAssessmentQuestionHintConfigShown, AXMAssessmentQuestionHintMode, AXMAssessmentQuestionHintPartial, AXMAssessmentQuestionHintVisualMode, AXMAssessmentSessionRole, AXMAssessmentSessionStatus, AXMQuestionBankItemInterfaceMetadata, AXMQuestionBankItemInterfaceValue, AXMQuestionnaireViewerServiceConfig, AXMQuestionnaireViewerServiceResult, PostQuestionnaireConfig, PrePostConfig, PrePostContentValue, PreQuestionnaireConfig, QuestionnaireCalculationResultKind, QuestionnaireCalculationValues, QuestionnaireCompletionMode, QuestionnaireEntityDisplaySettings };

package/types/acorex-modules-asset-management.d.ts

@@ -411,7 +411,10 @@ interface AXMAssetManagementAssetEntityModel {
         title: string;
         code?: string;
         hasMaintenance?: boolean;
+        maintenanceTypeIds?: string[];
     };
+    /** Hydrated at read time from asset type and categories (not persisted). */
+    availableMaintenanceTypeIds?: string[];
     description?: string;
     statusId?: AXMAssetStatus;
     status?: {

package/types/acorex-modules-conversation.d.ts

@@ -11,7 +11,7 @@ import { AXPContent, AXPUserReference, AXPFileListItem, AXPContentType, AXPDevic
 import { Observable } from 'rxjs';
 import { AXPPageLayoutBaseComponent } from '@acorex/platform/layout/views';
 import { AXConversationApi, AXMessageApi, AXRealtimeApi, AXUserApi, AXMessage, AXParticipant } from '@acorex/components/conversation2';
-import { AXPAiChatMessage } from '@acorex/modules/ai-management';
+import { AXPAiChatMessage, AXPAiChatFollowUpItem } from '@acorex/modules/ai-management';
 import * as _angular_platform_browser from '@angular/platform-browser';
 import { AXWysiwygContainerComponent } from '@acorex/components/wysiwyg';
 import { AXStyleLookType } from '@acorex/cdk/common';
@@ -479,6 +479,11 @@ interface AxmAssistTranscriptLinePayload {
 declare function axmNormalizeAssistTranscriptLineResponses(line: AXPAiChatMessage): AXPAiChatMessage;
 /** Last {@link AXPAiChatMessage} in the engine turn (index {@code length - 1}). */
 declare function axmAssistLastTranscriptLine(transcript: AXPAiChatMessage[]): AXPAiChatMessage | null;
+/**
+ * User-facing payload line for the assist bubble: merges visible assistant segments in the current turn,
+ * including {@code followUp} from tool {@code agent_result} after auto-invoked specialists.
+ */
+declare function axmAssistUserFacingPayloadLine(transcript: AXPAiChatMessage[]): AXPAiChatMessage | null;
 declare function axmBuildAssistTranscriptLinePayload(line: AXPAiChatMessage): AxmAssistTranscriptLinePayload;
 declare function axmParseAssistTranscriptLinePayload(payload: unknown): AXPAiChatMessage | null;
 declare function axmParseAssistTranscriptTextEnvelope(raw: string): {
@@ -497,8 +502,13 @@ type AxmAssistUserVisibleItem = {
     fileId: string;
     mimeType: string;
     name?: string;
+} | {
+    kind: 'followUp';
+    items: AXPAiChatFollowUpItem[];
 };
 declare function axmAssistUserVisibleItemsForLine(line: AXPAiChatMessage): AxmAssistUserVisibleItem[];
+/** Parses a raw {@code followUp} segment for UI (normalizes chip commands). */
+declare function axmAssistFollowUpItemsFromUnknown(raw: unknown): AXPAiChatFollowUpItem[];
 
 /**
  * True when the participant is an AI Assist peer (synthetic `assist-*` id or assist metadata).
@@ -737,5 +747,5 @@ declare const AXMPermissionsKeys: {
     };
 };
 
-export { AXMChatComponent, AXMChatConversationApi, AXMChatManagementService, AXMChatMessageApi, AXMChatRealtimeApi, AXMChatRealtimeService, AXMChatRealtimeServiceImpl, AXMChatService, AXMChatServiceImpl, AXMChatUserApi, AXMCommentComponent, AXMCommentManagementService, AXMCommentPopupComponent, AXMCommentPopupStartAction, AXMCommentPopupWorkflow, AXMCommentRealtimeService, AXMCommentRealtimeServiceImpl, AXMCommentService, AXMCommentServiceImpl, AXMCommentWidgetViewComponent, AXMConversationModule, AXMConversationTabEntityModule, AXMConversationTabService, AXMConversationTabServiceImpl, AXMMessageEntityModule, AXMMessageService, AXMMessageServiceImpl, AXMPermissionsKeys, AXMRoomEntityModule, AXMRoomService, AXMRoomServiceImpl, AXM_ASSIST_TRANSCRIPT_LINE_PAYLOAD_TYPE, AXPCommentWidget, COMMENTS_PAGE_COMPONENT_KEY, RootConfig, axmAssistLastTranscriptLine, axmAssistUserVisibleItemsForLine, axmAssistWidgetNodeFromUnknown, axmBuildAssistTranscriptLinePayload, axmIsAssistPeerParticipant, axmNormalizeAssistTranscriptForChatUi, axmNormalizeAssistTranscriptLineResponses, axmParseAssistTranscriptLinePayload, axmParseAssistTranscriptTextEnvelope, axmReadAssistAiTranscript, axmReadAssistAiTranscriptRaw, axmSyntheticEmbedMessage, commentsPlugin, messageFactory, roomFactory, tabFactory };
+export { AXMChatComponent, AXMChatConversationApi, AXMChatManagementService, AXMChatMessageApi, AXMChatRealtimeApi, AXMChatRealtimeService, AXMChatRealtimeServiceImpl, AXMChatService, AXMChatServiceImpl, AXMChatUserApi, AXMCommentComponent, AXMCommentManagementService, AXMCommentPopupComponent, AXMCommentPopupStartAction, AXMCommentPopupWorkflow, AXMCommentRealtimeService, AXMCommentRealtimeServiceImpl, AXMCommentService, AXMCommentServiceImpl, AXMCommentWidgetViewComponent, AXMConversationModule, AXMConversationTabEntityModule, AXMConversationTabService, AXMConversationTabServiceImpl, AXMMessageEntityModule, AXMMessageService, AXMMessageServiceImpl, AXMPermissionsKeys, AXMRoomEntityModule, AXMRoomService, AXMRoomServiceImpl, AXM_ASSIST_TRANSCRIPT_LINE_PAYLOAD_TYPE, AXPCommentWidget, COMMENTS_PAGE_COMPONENT_KEY, RootConfig, axmAssistFollowUpItemsFromUnknown, axmAssistLastTranscriptLine, axmAssistUserFacingPayloadLine, axmAssistUserVisibleItemsForLine, axmAssistWidgetNodeFromUnknown, axmBuildAssistTranscriptLinePayload, axmIsAssistPeerParticipant, axmNormalizeAssistTranscriptForChatUi, axmNormalizeAssistTranscriptLineResponses, axmParseAssistTranscriptLinePayload, axmParseAssistTranscriptTextEnvelope, axmReadAssistAiTranscript, axmReadAssistAiTranscriptRaw, axmSyntheticEmbedMessage, commentsPlugin, messageFactory, roomFactory, tabFactory };
 export type { AXMChatMessage, AXMChatMessageEvent, AXMChatRoom, AXMChatRoomEvent, AXMChatTabEvent, AXMComment, AXMCommentEntityData, AXMCommentEvent, AXMCommentEventType, AXMCommentThread, AXMConversationMessage, AXMConversationReaction, AXMConversationRoom, AXMConversationSeen, AXMConversationTab, AXMReactionType, AXMSeenType, AXMThreadEvent, AXMThreadEventType, AxmAssistTranscriptLinePayload, AxmAssistUserVisibleItem, CommentsDisplayMode, CommentsPluginOptions };