@acorex/modules 21.0.0-next.40 → 21.0.0-next.42

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

@@ -1,13 +1,14 @@
 import * as _angular_core from '@angular/core';
-import { OnInit } from '@angular/core';
+import { OnInit, OnDestroy } from '@angular/core';
 import * as i1 from '@acorex/platform/core';
-import { AXPModuleManifest, AXPDataSourceDefinitionProvider, AXPDataSourceDefinition, AXPActionMenuItem, AXPExecuteCommand } from '@acorex/platform/core';
+import { AXPModuleManifest, AXPDataSourceDefinitionProvider, AXPDataSourceDefinition, AXPMultiLanguageString, AXPActionMenuItem, AXPExecuteCommand } from '@acorex/platform/core';
 import * as i2 from '@acorex/platform/layout/widgets';
 import { AXPEntity, AXPMenuProvider, AXPMenuProviderContext, AXPFileStorageService } from '@acorex/platform/common';
-import { AXPEntityDefinitionLoader, AXPEntityPreloadEntity } from '@acorex/platform/layout/entity';
-import { AXValueChangedEvent } from '@acorex/cdk/common';
+import { AXPEntityDefinitionLoader, AXPEntityPreloadEntity, AXPEntityModel } from '@acorex/platform/layout/entity';
+import { AXValueChangedEvent, AXDataSource } from '@acorex/cdk/common';
 import { AXPPageLayoutBaseComponent } from '@acorex/platform/layout/views';
-import { AXPWidgetNode } from '@acorex/platform/layout/widget-core';
+import { AXPWidgetNode, AXPWidgetRenderMode } from '@acorex/platform/layout/widget-core';
+import { AXBasePageComponent } from '@acorex/components/page';
 
 declare class AXMAiManagementModule {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMAiManagementModule, never>;
@@ -15,6 +16,209 @@ declare class AXMAiManagementModule {
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<AXMAiManagementModule>;
 }
 
+/** Default max completion tokens when the AiModel row has no `maxOutputTokens` and the caller omits `maxTokens`. */
+declare const AXPAiAssistDefaultStructuredMaxTokens = 128000;
+/** Default maximum follow-up turns after the first model response when validating structured JSON (implementation may use this). */
+declare const AXPAiAssistDefaultMaxStructuredRetries = 3;
+/**
+ * Validates parsed JSON from the assistant. Return the validated value (possibly narrowed), or throw with a message
+ * the pipeline can send back to the model on retry.
+ */
+type AXPAiStructuredValidator<T = unknown> = (parsed: unknown) => T | Promise<T>;
+/**
+ * Thrown when {@link AXPAiAssistRunInput.expectStructuredOutput} is true but the assistant output could not be
+ * parsed and optionally validated after all attempts.
+ */
+declare class AXPAiStructuredOutputError extends Error {
+    /** 1-based count of engine runs performed for this structured-output session. */
+    readonly attempts: number;
+    /** Truncated snapshot of the last assistant plain text (for debugging). */
+    readonly lastAssistantText: string;
+    /** Human-readable validation or parse failure detail. */
+    readonly validationMessage: string;
+    /** Why the pipeline stopped. */
+    readonly code?: 'duplicate_assistant_output' | 'validation_exhausted';
+    constructor(options: {
+        message: string;
+        attempts: number;
+        lastAssistantText: string;
+        validationMessage: string;
+        cause?: unknown;
+        code?: 'duplicate_assistant_output' | 'validation_exhausted';
+    });
+}
+/** One row for assist / agent pickers (catalog UI). */
+interface AXPAiAssistPickerRow {
+    id: string;
+    name?: string;
+    title: string;
+}
+/** One persisted user attachment (same storage contract as the AI chat composer). */
+interface AXPAiAssistUserMediaAttachment {
+    /** `image` / `audio` / `file` (PDF, text, spreadsheets, and other document MIME types). */
+    kind: 'image' | 'audio' | 'file';
+    fileId: string;
+    mimeType: string;
+    name?: string;
+}
+/**
+ * Payload when submitting the assist prompt bottom panel (text, optional target assist/agent, optional media).
+ */
+interface AXPAiAssistPromptSubmitPayload {
+    prompt: string;
+    assistId?: string;
+    directAgentId?: string;
+    userMediaAttachments: AXPAiAssistUserMediaAttachment[];
+}
+/**
+ * Optional structured hints for a single assist run (serialized into the user message by the implementation).
+ */
+interface AXPAiAssistRunContext {
+    /** Short bullet hints appended to the prompt for the model. */
+    hints?: string[];
+    /** Extra system-level instruction for this run (implementation may emit a system message). */
+    systemInstruction?: string;
+    /** Arbitrary structured payload (JSON-serialized in the user message when present). */
+    structuredContext?: unknown;
+}
+/**
+ * Input for the AI assist `run` API (implemented in ai-management).
+ */
+interface AXPAiAssistRunInput {
+    prompt: string;
+    /**
+     * Optional images, audio, or documents (`fileId` from tenant storage). When non-empty, the implementation builds one multimodal
+     * user message (same shape as the AI chat composer) plus the serialized prompt body as text segments.
+     */
+    userMediaAttachments?: AXPAiAssistUserMediaAttachment[];
+    context?: AXPAiAssistRunContext;
+    /**
+     * Catalog assist id. When omitted together with {@link directAgentId}, the platform default assist is used.
+     */
+    assistId?: string;
+    directAgentId?: string;
+    maxSteps?: number;
+    temperature?: number;
+    /**
+     * Max completion tokens for this engine run (when the provider supports it). Structured JSON runs apply a higher
+     * default unless {@link structuredOutputMaxTokens} is set.
+     */
+    maxTokens?: number;
+    /** When true, implementation tries to parse assistant text as JSON into {@link AXPAiAssistRunResult.structured}. */
+    expectStructuredOutput?: boolean;
+    /** Extra instruction appended so the model returns JSON (used when {@link expectStructuredOutput} is true). */
+    structuredOutputInstruction?: string;
+    /**
+     * Shallow merge over built-in platform runtime context fields (see ai-management implementation).
+     */
+    platformRuntimeNotes?: Record<string, unknown>;
+    /**
+     * Max extra engine turns after the first response when structured output is invalid (default {@link AXPAiAssistDefaultMaxStructuredRetries}).
+     * Total attempts = 1 + maxStructuredRetries.
+     */
+    maxStructuredRetries?: number;
+    /** Optional schema or domain validation after JSON parse. */
+    structuredValidator?: AXPAiStructuredValidator;
+    /**
+     * When false, only one engine run is performed; invalid structured output throws {@link AXPAiStructuredOutputError}.
+     * When true (default for {@link expectStructuredOutput}), invalid output triggers follow-up user messages in the same transcript.
+     */
+    retryOnInvalidStructure?: boolean;
+    /**
+     * Optional description of the expected JSON shape (TypeScript-style or JSON schema summary), appended to the first
+     * user message and to retry prompts so the model stays aligned and retries are more accurate.
+     */
+    structuredOutputSchemaSummary?: string;
+    /**
+     * Overrides {@link maxTokens} for {@link expectStructuredOutput} runs only. Prefer setting this or leaving defaults so
+     * the implementation can apply {@link AXPAiAssistDefaultStructuredMaxTokens} and avoid truncated JSON.
+     */
+    structuredOutputMaxTokens?: number;
+}
+/**
+ * Result of the AI assist `run` API.
+ */
+interface AXPAiAssistRunResult {
+    /** Primary assistant reply text (extracted from the engine transcript). */
+    text: string;
+    /**
+     * Present when {@link AXPAiAssistRunInput.expectStructuredOutput} is true: validated structured payload
+     * (parse + optional {@link AXPAiAssistRunInput.structuredValidator}). On failure the implementation throws
+     * {@link AXPAiStructuredOutputError} instead of returning.
+     */
+    structured?: unknown;
+    /**
+     * When {@link AXPAiAssistRunInput.expectStructuredOutput} is false: engine usage / provider payload for that single run.
+     * When true: {@link AXPAiAssistStructuredOutputRunRaw} with per-attempt usage and totals for debugging.
+     */
+    raw?: unknown;
+}
+/**
+ * Token usage for a single engine run; numeric fields align with {@link AXPAiEngineUsageTotals} in this module
+ * for stable client-side debugging contracts.
+ */
+interface AXPAiAssistTokenUsageSnapshot {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    cachedPromptTokens?: number;
+}
+/**
+ * One engine execution within a structured-output session.
+ */
+interface AXPAiAssistStructuredOutputAttemptRecord {
+    /** 1-based index of this engine run. */
+    attemptIndex: number;
+    /** Usage reported for this run only. */
+    usage?: AXPAiAssistTokenUsageSnapshot;
+    /** Whether a last-provider payload was present for this run. */
+    hasLastProviderResult: boolean;
+}
+/**
+ * Explicit `raw` shape for {@link AXPAiAssistRunResult} when {@link AXPAiAssistRunInput.expectStructuredOutput} is true.
+ */
+interface AXPAiAssistStructuredOutputRunRaw {
+    kind: 'structured-output';
+    /** One entry per engine call (`runEngine` / structured-output retries). */
+    attempts: AXPAiAssistStructuredOutputAttemptRecord[];
+    /** Cumulative usage across all attempts. */
+    totalUsage?: AXPAiAssistTokenUsageSnapshot;
+    /** Count of engine runs in this session (same as the last `attemptIndex`). */
+    finalAttempt: number;
+    lastProviderResult?: unknown;
+}
+/**
+ * Typical max width of the assist prompt column inside the bottom overlay (maps to `contentMaxWidthPx`).
+ */
+type AXPAiAssistPopupSize = 'sm' | 'md' | 'lg' | 'xl' | 'full';
+/**
+ * Options for the AI assist `show` prompt API: same run-related fields as {@link AXPAiAssistRunInput} except `prompt`,
+ * plus UI chrome. The user-entered prompt from the surface is merged on Send.
+ */
+interface AXPAiAssistShowOptions {
+    title: string;
+    placeholder?: string;
+    initialPrompt?: string;
+    size?: AXPAiAssistPopupSize;
+    context?: AXPAiAssistRunContext;
+    /**
+     * Optional catalog assist. When omitted (and {@link directAgentId} is not set), the tenant/platform default assist applies.
+     */
+    assistId?: string;
+    directAgentId?: string;
+    maxSteps?: number;
+    temperature?: number;
+    maxTokens?: number;
+    expectStructuredOutput?: boolean;
+    structuredOutputInstruction?: string;
+    platformRuntimeNotes?: Record<string, unknown>;
+    maxStructuredRetries?: number;
+    structuredValidator?: AXPAiStructuredValidator;
+    retryOnInvalidStructure?: boolean;
+    structuredOutputSchemaSummary?: string;
+    structuredOutputMaxTokens?: number;
+}
+
 declare const RootConfig: {
     config: {
         i18n: string;
@@ -112,6 +316,11 @@ declare const AXPAiManagementSettings: {
         readonly Gemini: {
             readonly ApiKey: "AiManagement:Setting:Providers.Gemini.ApiKey";
         };
+        readonly Demis: {
+            readonly BearerToken: "AiManagement:Setting:Providers.Demis.BearerToken";
+            /** AiAgent catalog `name` (slug) used as Demisco `agent_uuid` when no agent run context exists. */
+            readonly DefaultAgentName: "AiManagement:Setting:Providers.Demis.DefaultAgentName";
+        };
     };
 };
 
@@ -194,6 +403,48 @@ declare function axpAiDelegatedAgentPromptPreview(argumentsValue: unknown): stri
  */
 declare function normalizeAiToolCommandArgs(value: unknown, toolName?: string): unknown;
 
+/**
+ * Persisted AiAgent catalog row (entity storage shape).
+ */
+interface AXMAiManagementAgentEntityModel extends AXPEntityModel<string> {
+    name: string;
+    title: AXPMultiLanguageString;
+    description?: AXPMultiLanguageString;
+    systemPrompt?: string;
+    modelEntityId?: string | null;
+    toolIds?: unknown;
+    queryIds?: unknown;
+    maxSteps?: number;
+}
+
+/** Aligns with {@link AXPAiPlanningMode} in ai-engine.types (avoid circular imports). */
+type AXMAiManagementAssistPlanningMode = 'off' | 'once' | 'when-needed';
+/**
+ * Persisted Assist catalog row.
+ */
+interface AXMAiManagementAssistEntityModel extends AXPEntityModel<string> {
+    name: string;
+    title: AXPMultiLanguageString;
+    description?: AXPMultiLanguageString;
+    professionImageUrl?: string;
+    planningMode?: AXMAiManagementAssistPlanningMode;
+    modelId: string;
+    /** Denormalized lookup snapshot when the row is expanded for list/detail. */
+    aiModel?: {
+        id?: string;
+        title?: AXPMultiLanguageString;
+        name?: string;
+    };
+    initialMessages?: string | null;
+    systemPrompt?: string;
+    delegatedAgents?: {
+        agent: {
+            type?: string;
+            options?: Record<string, unknown>;
+        };
+    }[] | null;
+}
+
 /** Prefix for supervisor-delegated specialist tools (`${AXPAI_SUPERVISOR_AGENT_TOOL_PREFIX}${agentId}`). */
 declare const AXPAI_SUPERVISOR_AGENT_TOOL_PREFIX: "agent:";
 /** Default cap for main assist / direct-agent chat tool rounds (one provider call per step). */
@@ -204,7 +455,7 @@ declare const AXPAI_DELEGATED_AGENT_DEFAULT_MAX_STEPS = 8;
 declare const AXPAI_DOCUMENT_VISION_EXTRACTION_SYSTEM = "You are a precise document-reading assistant. Extract readable plain text from the attached file. Preserve headings and lists where obvious. If the content is unreadable, return a short explanation. Output plain text only, no markdown code fences.";
 /** Default user line when the caller passes an empty instruction for vision extraction. */
 declare const AXPAI_DOCUMENT_VISION_DEFAULT_USER_INSTRUCTION = "Extract all readable text from this document. Return plain text only.";
-type AXPAiChatTransport = 'openai' | 'gemini';
+type AXPAiChatTransport = 'openai' | 'gemini' | 'demis';
 type AXPAiPlanningMode = 'off' | 'once' | 'when-needed';
 /**
  * Snapshot of session / tenant / regional defaults injected into system prompts.
@@ -247,57 +498,24 @@ interface AXPAiDelegatedParameterDefinition {
         order?: number;
     };
 }
-/** Effective Assist entity row (chat policy, prompts, delegated routing). */
-interface AXPAiEffectiveAssistRow {
+/**
+ * Effective Assist entity row (chat policy, prompts, delegated routing).
+ * Fields are partial except `id` because runtime/query payloads may omit unused slices.
+ */
+type AXPAiEffectiveAssistRow = Partial<Omit<AXMAiManagementAssistEntityModel, 'id'>> & {
     id: string;
-    name?: string;
-    title?: string;
-    description?: string;
-    systemPrompt?: string;
-    planningMode?: unknown;
-    /** Official chat model (AiModel catalog id) for supervisor assist runs. */
-    modelId?: string;
-    /** Populated for list display when using lookup; mirrors AiModel `title` / `name`. */
-    aiModel?: {
-        id?: string;
-        title?: string;
-        name?: string;
-    };
+    /** Optional catalog row not persisted on the assist entity; used by mock seeds. */
     imageModelId?: string;
-    initialMessages?: string | null;
-    /**
-     * Agents this assist may delegate to: each repeater row has `agent` = widget node with `type` = AiAgent catalog id
-     * and `options` = values for `assist_locked` / `assist_default` (see agent {@link AXPAiEffectiveAgentRow.parameterDefinitions}).
-     */
-    delegatedAgents?: {
-        agent: {
-            type?: string;
-            options?: Record<string, unknown>;
-        };
-    }[] | null;
-}
-/** Effective AiAgent catalog row (registry scope + optional supervisor JSON schema). */
-interface AXPAiEffectiveAgentRow {
+};
+/**
+ * Effective AiAgent catalog row (registry scope + optional supervisor JSON schema).
+ * Fields are partial except `id` because runtime/query payloads may omit unused slices.
+ */
+type AXPAiEffectiveAgentRow = Partial<Omit<AXMAiManagementAgentEntityModel, 'id'>> & {
     id: string;
-    name?: string;
-    title?: string;
-    description?: string;
-    systemPrompt?: string;
-    modelEntityId?: string | null;
-    /**
-     * Allowed command registry rows: prefer repeater persistence
-     * `{ command: { type: registryRowId, options?: defaultInput } }[]`, or legacy `string` / `{ id }` entries.
-     */
-    toolIds?: unknown;
-    /**
-     * Allowed query registry rows: prefer repeater persistence
-     * `{ query: { type: registryRowId, options?: defaultInput } }[]`, or legacy `string` / `{ id }` entries.
-     */
-    queryIds?: unknown;
-    maxSteps?: number;
     /** Defines keys, bindings, and drives supervisor JSON Schema (empty or omitted → default `query` only). */
     parameterDefinitions?: AXPAiDelegatedParameterDefinition[] | null;
-}
+};
 interface AXPAiChatModelListRequest {
     assistId?: string | null;
     directAgentId?: string | null;
@@ -338,6 +556,15 @@ interface AXPAiChatAudioResponse {
         name?: string;
     };
 }
+/** User message document attachment (PDF, text, spreadsheets, etc.) resolved from tenant storage for providers. */
+interface AXPAiChatFileResponse {
+    type: 'file';
+    content: {
+        fileId: string;
+        mimeType: string;
+        name?: string;
+    };
+}
 interface AXPAiChatNodeResponse {
     type: 'node';
     content: unknown;
@@ -377,7 +604,7 @@ interface AXPAiChatAgentResultResponse {
     name?: string;
     content: AXPAiDelegatedAgentResultPayload;
 }
-type AXPAiChatResponse = AXPAiChatTextResponse | AXPAiChatThinkResponse | AXPAiChatImageResponse | AXPAiChatAudioResponse | AXPAiChatNodeResponse | AXPAiChatToolAssistantResponse | AXPAiChatAgentAssistantResponse | AXPAiChatToolResultResponse | AXPAiChatAgentResultResponse;
+type AXPAiChatResponse = AXPAiChatTextResponse | AXPAiChatThinkResponse | AXPAiChatImageResponse | AXPAiChatAudioResponse | AXPAiChatFileResponse | AXPAiChatNodeResponse | 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.
@@ -472,6 +699,8 @@ type AXPAiEngineRunEvent = {
 interface AXPAiEngineRunOptions {
     messages: AXPAiChatMessage[];
     assistId?: string;
+    /** Demisco multipart `session_uuid` when using Demis transport (optional). */
+    demisSessionUuid?: string;
     /** Direct AiAgent thread (registry tools only); uses tenant default assist for model policy when assist id omitted. */
     directAgentId?: string;
     modelEntityId?: string;
@@ -561,7 +790,7 @@ declare class AXPAiPlatformRuntimeContextBuilder {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPAiPlatformRuntimeContextBuilder>;
 }
 
-/** Generates an image from a text prompt; default image model comes from the delegated specialist row (`delegatedAgents[].options.model`). */
+/** Generates an image from a text prompt; model resolution: explicit input, then delegated specialist `options.model`, then mock catalog default (OpenAI gpt-image-1). */
 declare const AIMANAGEMENT_CHAT_GENERATE_IMAGE_COMMAND_KEY: "AiManagement:ChatGenerateImage";
 
 /** Transcribes audio from a stored file; default speech model comes from the delegated specialist row (`delegatedAgents[].options.model`). */
@@ -581,7 +810,10 @@ 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`. */
     agentName?: string;
+    /** Optional Demisco chat session id (`session_uuid` in multipart). */
+    demisSessionUuid?: string;
 }
 /**
  * Per chat run: stores which assist and chat transport are active.
@@ -704,6 +936,13 @@ interface AXMAiComposerDraftAudio {
     /** Set after {@link persistAiChatAttachmentImage} succeeds. */
     fileId?: string;
 }
+/** PDF / text / spreadsheet staged in the composer until send. */
+interface AXMAiComposerDraftFile {
+    clientId: string;
+    mimeType: string;
+    name?: string;
+    fileId?: string;
+}
 /** Parsed delegated-agent (`agent:<id>`) tool result body for chat UI. */
 interface AXMAiDelegatedAgentToolParsed {
     agentName?: string;
@@ -728,6 +967,15 @@ declare class AXMAiChatPageComponent extends AXPPageLayoutBaseComponent implemen
     private readonly popupService;
     private readonly chatToolExecute;
     private readonly platformRuntimeContextBuilder;
+    /**
+     * Stable reference for `axp-widgets-container` context (inline `{}` would be a new object each CD).
+     */
+    protected readonly layoutJsonAssistantEmptyContext: Record<string, unknown>;
+    /**
+     * Parsed widget roots keyed by message responses fingerprint so `axp-widget-renderer` keeps a stable
+     * `node` reference across change detection (avoids ngOnChanges re-render loops).
+     */
+    private readonly layoutJsonParsedWidgetCache;
     /** Primary key of the selected Assist row (supervisor chat). Cleared when {@link selectedDirectAgentId} is set. */
     readonly selectedAssistId: _angular_core.ModelSignal<string | undefined>;
     /**
@@ -736,6 +984,11 @@ declare class AXMAiChatPageComponent extends AXPPageLayoutBaseComponent implemen
     readonly selectedDirectAgentId: _angular_core.ModelSignal<string | undefined>;
     /** Wide layout + delegated-agent mini-chat blocks (assist / supervisor mode only). */
     readonly threadUsesAssistLayout: _angular_core.Signal<boolean>;
+    /**
+     * Direct chat with the layout-JSON specialist agent (see `AXM_AI_CHAT_LAYOUT_JSON_AGENT_ID`):
+     * assistant output is a widget JSON root rendered via {@link assistantLayoutJsonWidgetNode} and the axp-widget-renderer directive.
+     */
+    readonly threadUsesLayoutJsonAgent: _angular_core.Signal<boolean>;
     readonly messages: _angular_core.WritableSignal<AXPAiChatMessage[]>;
     /**
      * Assist-configured greeting lines shown in the thread but **not** sent to the agent.
@@ -761,6 +1014,8 @@ declare class AXMAiChatPageComponent extends AXPPageLayoutBaseComponent implemen
     readonly draftComposerImages: _angular_core.WritableSignal<AXMAiComposerDraftImage[]>;
     /** Audio files chosen for the next message (persisted like images). */
     readonly draftComposerAudios: _angular_core.WritableSignal<AXMAiComposerDraftAudio[]>;
+    /** Documents (PDF, text, etc.) for the next message. */
+    readonly draftComposerFiles: _angular_core.WritableSignal<AXMAiComposerDraftFile[]>;
     /** True while files are being saved to storage after picker closes. */
     readonly isComposerSaving: _angular_core.WritableSignal<boolean>;
     readonly isBusy: _angular_core.WritableSignal<boolean>;
@@ -774,7 +1029,7 @@ declare class AXMAiChatPageComponent extends AXPPageLayoutBaseComponent implemen
     /** Last aggregated token usage from the agent run (for context meter). */
     readonly lastUsageTotals: _angular_core.WritableSignal<AXPAiEngineUsageTotals | null>;
     /**
-     * Specialist sub-run transcripts keyed by supervisor tool_call id (merged from each {@link AXPAiManagerService.run} result).
+     * Specialist sub-run transcripts keyed by supervisor tool_call id (merged from each {@link AXPAiManagerService.runEngine} result).
      */
     readonly delegatedTranscriptsByCallId: _angular_core.WritableSignal<Record<string, AXPAiDelegatedAgentTranscriptEntry>>;
     /** Incremental assistant text while the provider streams (OpenAI SSE); main turn only. */
@@ -868,14 +1123,33 @@ declare class AXMAiChatPageComponent extends AXPPageLayoutBaseComponent implemen
      */
     protected toolTurnPreamblePlain(item: AXMAiChatToolTurnItem): string;
     protected toolTurnPreambleParsed(item: AXMAiChatToolTurnItem): AssistantParsedContent;
+    /**
+     * When the layout-JSON agent renders preamble messages as widgets, suppress the duplicated JSON body block.
+     */
+    protected toolTurnPreambleAggregatedBodyVisible(item: AXMAiChatToolTurnItem): boolean;
     /**
      * Layout node for assistant `node` responses when the payload matches {@link AXPWidgetNode}.
      */
     protected asAssistantLayoutNode(message: AXPAiChatMessage): AXPWidgetNode | null;
     /**
-     * Parses `AiManagement:ChatGenerateImage` tool output for inline image preview.
-     * Prefers persisted `fileId` (resolved via file storage); falls back to legacy `imageUrl`.
+     * Widget root for the layout-JSON specialist agent: prefers a `node` response, otherwise parses
+     * concatenated `text` segments as JSON (optional ``` / ```json fence).
+     * Results are cached by message payload so the same {@link AXPWidgetNode} reference is reused across CD cycles.
+     */
+    protected assistantLayoutJsonWidgetNode(message: AXPAiChatMessage): AXPWidgetNode | null;
+    private layoutJsonMessageResponsesFingerprint;
+    private computeAssistantLayoutJsonWidgetNode;
+    private trimLayoutJsonParsedWidgetCache;
+    /** Render mode for {@link assistantLayoutJsonWidgetNode}; defaults to `edit`. */
+    protected assistantLayoutJsonWidgetMode(message: AXPAiChatMessage): AXPWidgetRenderMode;
+    private stripAssistantJsonLayoutFence;
+    /**
+     * Builds parse attempts for assistant widget JSON: full blob, whole-string fence strip,
+     * and each ``` / ```json fenced segment (handles prose + fenced JSON in one message).
      */
+    private collectAssistantLayoutJsonCandidates;
+    /** Parses one candidate string into a root {@link AXPWidgetNode} when shape matches. */
+    private tryParseAssistantWidgetRootJson;
     /**
      * Parses `AiManagement:ChatSynthesizeSpeech` tool output for inline audio playback.
      */
@@ -884,6 +1158,10 @@ declare class AXMAiChatPageComponent extends AXPPageLayoutBaseComponent implemen
         mimeType: string;
         title: string;
     } | null;
+    /**
+     * Parses `AiManagement:ChatGenerateImage` tool output for inline image preview.
+     * Prefers persisted `fileId` (resolved via file storage); falls back to legacy `imageUrl`.
+     */
     getGenerateImagePreview(pair: AXMAiChatToolCallPair): {
         fileId?: string;
         imageUrl?: string;
@@ -917,6 +1195,7 @@ declare class AXMAiChatPageComponent extends AXPPageLayoutBaseComponent implemen
      */
     openChatImagePicker(): void;
     openChatAudioPicker(): void;
+    openChatDocumentPicker(): void;
     /**
      * Resolves picked files then stages previews and persists via {@link AXPFileStorageService} (like platform file-uploader → storage).
      */
@@ -936,11 +1215,14 @@ declare class AXMAiChatPageComponent extends AXPPageLayoutBaseComponent implemen
     private processComposerChatImageFiles;
     private pickComposerChatAudios;
     private processComposerChatAudioFiles;
+    private pickComposerChatDocuments;
+    private processComposerChatDocumentFiles;
     /**
      * Removes one staged image from the composer and revokes its object URL.
      */
     removeDraftImage(clientId: string): void;
     removeDraftAudio(clientId: string): void;
+    removeDraftFile(clientId: string): void;
     /**
      * Revokes blob URLs and clears composer draft state (assist switch, etc.).
      */
@@ -1018,6 +1300,44 @@ declare class AXMAiChatToolExecuteService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXMAiChatToolExecuteService>;
 }
 
+/** Aligns with {@link AXPAiChatTransport} in ai-engine.types (avoid circular imports). */
+type AXMAiManagementModelChatTransport = 'openai' | 'gemini' | 'demis';
+type AXMAiManagementModelPurposeSlug = 'chat' | 'vision' | 'image' | 'speech' | 'tts';
+/**
+ * Persisted AI model catalog row.
+ */
+interface AXMAiManagementModelEntityModel extends AXPEntityModel<string> {
+    title: AXPMultiLanguageString;
+    description?: AXPMultiLanguageString;
+    /** Vendor API model id (exact string sent to the provider). */
+    name: string;
+    modelPurposes?: AXMAiManagementModelPurposeSlug[];
+    chatTransport: AXMAiManagementModelChatTransport;
+    openAiEndpointId?: string | null;
+    maxContextTokens?: number;
+    maxOutputTokens?: number;
+    maxInputTokens?: number;
+    inputPricePerMillion?: number;
+    outputPricePerMillion?: number;
+    cachedInputPricePerMillion?: number;
+    openAiEndpointIsDisabled?: boolean;
+}
+
+/**
+ * Persisted OpenAI-compatible endpoint row.
+ */
+interface AXMAiManagementOpenAiEndpointEntityModel extends AXPEntityModel<string> {
+    title: AXPMultiLanguageString;
+    description?: AXPMultiLanguageString;
+    apiBase: string;
+    apiKey?: string | null;
+    /**
+     * When false, chat completions use a single non-streaming JSON response (no SSE).
+     * Omitted or true keeps streaming, which matches most cloud OpenAI-compatible APIs.
+     */
+    stream?: boolean;
+}
+
 /**
  * Backend boundary for AI assist runs (chat + tool rounds). Connectivity implementations execute registry
  * commands/queries during the run loop.
@@ -1032,22 +1352,37 @@ declare abstract class AXPAiEngine {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPAiEngine>;
 }
 
-interface AXPAiAssistPickerRow {
-    id: string;
-    name?: string;
-    title: string;
+/**
+ * Optional cross-cutting AI assist: programmatic {@link run} and dialog {@link show}.
+ * Implemented by {@link AXPAiManagerService}. Consumers outside ai-management should prefer hooks or optional injection.
+ */
+declare abstract class AXPAiAssistService {
+    abstract run(input: AXPAiAssistRunInput): Promise<AXPAiAssistRunResult>;
+    /** Opens prompt UI; on Send runs {@link run} and closes the dialog. Cancel resolves `null`. */
+    abstract show(options: AXPAiAssistShowOptions): Promise<AXPAiAssistRunResult | null>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPAiAssistService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPAiAssistService>;
 }
+
 /**
- * Frontend facade for AI chat UX: assist listing, tenant default selection, and chat runs.
- * Delegates {@link AXPAiEngine.run} to connectivity implementations.
+ * Frontend facade for AI: assist catalog, tenant defaults, engine runs, structured assist runs, and prompt UI.
  */
-declare class AXPAiManagerService {
+declare class AXPAiManagerService extends AXPAiAssistService {
     private readonly aiEngine;
     private readonly entityService;
     private readonly settings;
+    private readonly runtimeContextBuilder;
+    private readonly assistPromptBottomPanel;
+    private readonly localeId;
     private readonly assistData;
     private readonly assistListData;
     private readonly agentListData;
+    private readonly modelEntityData;
+    private readonly agentEntityData;
+    /**
+     * Maps catalog `title` (multi-language or plain string) to a single-line picker label.
+     */
+    private toAssistPickerRow;
     /**
      * Loads assist rows for UI pickers (e.g. header menu).
      */
@@ -1064,7 +1399,22 @@ declare class AXPAiManagerService {
      * Resolves the assist row for chat: explicit primary key, otherwise the effective default from settings.
      */
     getAssistForChat(assistId?: string | null): Promise<AXPAiEffectiveAssistRow>;
-    run(options: AXPAiEngineRunOptions): Promise<AXPAiEngineRunResult>;
+    /**
+     * Low-level engine run (chat streaming and tool orchestration).
+     */
+    runEngine(options: AXPAiEngineRunOptions): Promise<AXPAiEngineRunResult>;
+    /**
+     * Normalizes AiModel.maxOutputTokens from the catalog.
+     */
+    private normalizeMaxOutputTokens;
+    /**
+     * Reads {@link AXMAiModelMaxTokensRow.maxOutputTokens} for the model bound to the assist or direct agent.
+     */
+    private resolveCatalogMaxOutputTokens;
+    /** @inheritdoc */
+    run(input: AXPAiAssistRunInput): Promise<AXPAiAssistRunResult>;
+    /** @inheritdoc */
+    show(options: AXPAiAssistShowOptions): Promise<AXPAiAssistRunResult | null>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXPAiManagerService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPAiManagerService>;
 }
@@ -1074,6 +1424,7 @@ declare class AXPAiManagerService {
  */
 declare class AXPAiAssistChatModelCatalogService {
     private readonly entityService;
+    private readonly localeId;
     private readonly modelData;
     private readonly openAiEndpointData;
     /**
@@ -1088,5 +1439,131 @@ declare class AXPAiAssistChatModelCatalogService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXPAiAssistChatModelCatalogService>;
 }
 
-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, AXMAiChatPageComponent, AXMAiChatToolExecuteService, AXMAiCommandRegistryCatalogDataSourceDefinition, AXMAiManagementEntityProvider, AXMAiManagementMenuProvider, AXMAiManagementModule, AXMAiModelCatalogDataSourceDefinition, AXMAiQueryRegistryCatalogDataSourceDefinition, 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, AXPAiChatToolRunContextService, AXPAiEngine, AXPAiManagementMenuKeys, AXPAiManagementSettings, AXPAiManagerService, AXPAiPlatformRuntimeContextBuilder, AiManagementManifest, RootConfig, axpAiAssistInitialMessagesToTranscript, axpAiChatAgentResultMessage, axpAiChatDelegatedReflectionAssistantMessage, axpAiChatMessageGetText, axpAiChatMessageIsDelegatedReflectionExcluded, axpAiChatMessagesFromProviderAssistant, axpAiChatTextMessage, axpAiChatToolOrAgentResultBodyJson, axpAiChatToolResultBodyJson, axpAiChatToolResultMessage, axpAiChatUserMessage, axpAiCoercePlanningAssistantTextToThink, axpAiDelegatedAgentPromptPreview, axpAiMergePlainAssistantTextTurn, axpAiNormalizeHandlerResultToToolBody, axpAiParseSupervisorAgentToolName, axpAiPruneAssistantPiecesToFirstToolOnly, axpAiStripAssistInitialHtmlToPlain, axpAiSupervisorAgentToolName, axpAiToolCallFromAssistantToolMessage, blobOrFileFromImageResult, getAiChatCommandLlmParametersOverride, isChatPurposeModelRow, isImagePurposeModelRow, isSpeechPurposeModelRow, isTtsPurposeModelRow, modelRowHasPurpose, normalizeAiToolCommandArgs, normalizeModelPurposes, persistAiChatAttachmentImage, persistAiGeneratedImage, persistAiGeneratedSpeech };
-export type { AXMAiModelPurposeSlug, AXPAiAssistPickerRow, AXPAiChatAgentAssistantResponse, AXPAiChatAgentResultBody, AXPAiChatAgentResultResponse, AXPAiChatAudioResponse, AXPAiChatImageResponse, AXPAiChatMessage, AXPAiChatModelListItem, AXPAiChatModelListRequest, AXPAiChatNodeResponse, AXPAiChatResponse, AXPAiChatTextResponse, AXPAiChatThinkResponse, AXPAiChatToolAssistantResponse, AXPAiChatToolInvocationContent, AXPAiChatToolResultBody, AXPAiChatToolResultResponse, AXPAiChatToolRunContext, AXPAiChatTransport, AXPAiDelegatedAgentResultPayload, AXPAiDelegatedAgentTranscriptEntry, AXPAiDelegatedNestedToolCallContext, AXPAiDelegatedParameterBinding, AXPAiDelegatedParameterDefinition, AXPAiEffectiveAgentRow, AXPAiEffectiveAssistRow, AXPAiEngineLastProviderPayload, AXPAiEngineRegistryToolFields, AXPAiEngineRunEvent, AXPAiEngineRunOptions, AXPAiEngineRunResult, AXPAiEngineUsageTotals, AXPAiExtractDocumentTextFromStoredFileRequest, AXPAiPlanningMode, AXPAiPlatformRuntimeContext, AXPAiStructuredTextCompletionOptions, AXPAiToolCall, AXPAiToolSchema };
+/** Popup `data` payload from {@link AXPAiManagerService.show}. */
+interface AXMAiAssistPromptPopupData {
+    placeholder?: string;
+    initialPrompt?: string;
+    onSubmit: (prompt: string) => Promise<AXPAiAssistRunResult>;
+}
+declare class AXMAiAssistPromptPopupComponent extends AXBasePageComponent implements OnInit {
+    private readonly toastService;
+    private readonly translation;
+    /** Optional placeholder from caller; falls back to translated default. */
+    placeholder?: string;
+    initialPrompt?: string;
+    onSubmit: (prompt: string) => Promise<AXPAiAssistRunResult>;
+    readonly promptDraft: _angular_core.WritableSignal<string>;
+    readonly busy: _angular_core.WritableSignal<boolean>;
+    ngOnInit(): void;
+    onPromptDraftChange(value: string | null | undefined): void;
+    canSend(): boolean;
+    onCancel(): void;
+    onSend(): Promise<void>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMAiAssistPromptPopupComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXMAiAssistPromptPopupComponent, "axm-ai-assist-prompt-popup", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Opens the AI assist prompt in a bottom overlay using {@link AXOverlayService} (`centered: false`, panel CSS).
+ */
+declare class AXMAiAssistPromptBottomPanelService {
+    private readonly overlayService;
+    private overlayRef;
+    private pendingResolve;
+    private settled;
+    /**
+     * Presents the assist prompt bottom panel and resolves when the user submits, cancels, or dismisses the overlay.
+     */
+    open(options: AXPAiAssistShowOptions, picker: {
+        assistPickerRows: AXPAiAssistPickerRow[];
+        agentPickerRows: AXPAiAssistPickerRow[];
+    }, executeRun: (payload: AXPAiAssistPromptSubmitPayload) => Promise<AXPAiAssistRunResult>): Promise<AXPAiAssistRunResult | null>;
+    private settle;
+    private disposeOverlayOnly;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMAiAssistPromptBottomPanelService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXMAiAssistPromptBottomPanelService>;
+}
+
+interface AXMAiAssistDraftImage {
+    clientId: string;
+    previewUrl: string;
+    mimeType: string;
+    name?: string;
+    fileId?: string;
+}
+interface AXMAiAssistDraftAudio {
+    clientId: string;
+    mimeType: string;
+    name?: string;
+    fileId?: string;
+}
+interface AXMAiAssistDraftFile {
+    clientId: string;
+    mimeType: string;
+    name?: string;
+    fileId?: string;
+}
+/**
+ * Bottom-sheet UI for AI assist: prompt text, optional assist/agent target, and image/audio/document attachments like the chat composer.
+ */
+declare class AXMAiAssistPromptBottomPanelComponent implements OnInit, OnDestroy {
+    private readonly toastService;
+    private readonly translation;
+    private readonly fileStorage;
+    private readonly fileService;
+    private readonly platformId;
+    readonly title: _angular_core.InputSignal<string>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    readonly initialPrompt: _angular_core.InputSignal<string>;
+    readonly contentMaxWidthPx: _angular_core.InputSignal<number>;
+    readonly assistPickerRows: _angular_core.InputSignal<AXPAiAssistPickerRow[]>;
+    readonly agentPickerRows: _angular_core.InputSignal<AXPAiAssistPickerRow[]>;
+    readonly initialAssistId: _angular_core.InputSignal<string | undefined>;
+    readonly initialDirectAgentId: _angular_core.InputSignal<string | undefined>;
+    readonly runPrompt: _angular_core.InputSignal<(payload: AXPAiAssistPromptSubmitPayload) => Promise<AXPAiAssistRunResult>>;
+    readonly requestClose: _angular_core.InputSignal<(result: AXPAiAssistRunResult | null) => void>;
+    readonly promptDraft: _angular_core.WritableSignal<string>;
+    readonly busy: _angular_core.WritableSignal<boolean>;
+    readonly isComposerSaving: _angular_core.WritableSignal<boolean>;
+    readonly draftAttachmentGroupId: _angular_core.WritableSignal<string | null>;
+    readonly draftComposerImages: _angular_core.WritableSignal<AXMAiAssistDraftImage[]>;
+    readonly draftComposerAudios: _angular_core.WritableSignal<AXMAiAssistDraftAudio[]>;
+    readonly draftComposerFiles: _angular_core.WritableSignal<AXMAiAssistDraftFile[]>;
+    readonly assistTargetKey: _angular_core.WritableSignal<string>;
+    readonly defaultAssistLabel: _angular_core.WritableSignal<string>;
+    readonly assistRowPrefix: _angular_core.WritableSignal<string>;
+    readonly agentRowPrefix: _angular_core.WritableSignal<string>;
+    readonly assistSelectItems: _angular_core.Signal<{
+        value: string;
+        text: string;
+    }[]>;
+    readonly assistSelectDataSource: _angular_core.Signal<AXDataSource<{
+        value: string;
+        text: string;
+    } | undefined>>;
+    readonly canSend: _angular_core.Signal<boolean>;
+    ngOnInit(): Promise<void>;
+    ngOnDestroy(): void;
+    onAssistTargetChanged(e: AXValueChangedEvent<string>): void;
+    onPromptDraftChange(value: string | null | undefined): void;
+    onCancel(): void;
+    openImagePicker(): void;
+    openAudioPicker(): void;
+    openDocumentPicker(): void;
+    onSend(): Promise<void>;
+    removeDraftImage(clientId: string): void;
+    removeDraftAudio(clientId: string): void;
+    removeDraftFile(clientId: string): void;
+    private pickComposerImages;
+    private pickComposerAudios;
+    private pickComposerDocuments;
+    private processComposerImageFiles;
+    private processComposerAudioFiles;
+    private processComposerDocumentFiles;
+    private showUploadWarning;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMAiAssistPromptBottomPanelComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXMAiAssistPromptBottomPanelComponent, "axm-ai-assist-prompt-bottom-panel", 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; }; "assistPickerRows": { "alias": "assistPickerRows"; "required": false; "isSignal": true; }; "agentPickerRows": { "alias": "agentPickerRows"; "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, AXMAiAssistPromptBottomPanelComponent, AXMAiAssistPromptBottomPanelService, AXMAiAssistPromptPopupComponent, AXMAiChatPageComponent, AXMAiChatToolExecuteService, AXMAiCommandRegistryCatalogDataSourceDefinition, AXMAiManagementEntityProvider, AXMAiManagementMenuProvider, AXMAiManagementModule, AXMAiModelCatalogDataSourceDefinition, AXMAiQueryRegistryCatalogDataSourceDefinition, 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, AXPAiEngine, AXPAiManagementMenuKeys, AXPAiManagementSettings, AXPAiManagerService, AXPAiPlatformRuntimeContextBuilder, AXPAiStructuredOutputError, AiManagementManifest, RootConfig, axpAiAssistInitialMessagesToTranscript, axpAiChatAgentResultMessage, axpAiChatDelegatedReflectionAssistantMessage, axpAiChatMessageGetText, axpAiChatMessageIsDelegatedReflectionExcluded, axpAiChatMessagesFromProviderAssistant, axpAiChatTextMessage, axpAiChatToolOrAgentResultBodyJson, axpAiChatToolResultBodyJson, axpAiChatToolResultMessage, axpAiChatUserMessage, axpAiCoercePlanningAssistantTextToThink, axpAiDelegatedAgentPromptPreview, axpAiMergePlainAssistantTextTurn, axpAiNormalizeHandlerResultToToolBody, axpAiParseSupervisorAgentToolName, axpAiPruneAssistantPiecesToFirstToolOnly, axpAiStripAssistInitialHtmlToPlain, axpAiSupervisorAgentToolName, axpAiToolCallFromAssistantToolMessage, blobOrFileFromImageResult, getAiChatCommandLlmParametersOverride, isChatPurposeModelRow, isImagePurposeModelRow, isSpeechPurposeModelRow, isTtsPurposeModelRow, modelRowHasPurpose, normalizeAiToolCommandArgs, normalizeModelPurposes, persistAiChatAttachmentImage, persistAiGeneratedImage, persistAiGeneratedSpeech };
+export type { AXMAiAssistPromptPopupData, AXMAiManagementAgentEntityModel, AXMAiManagementAssistEntityModel, AXMAiManagementAssistPlanningMode, AXMAiManagementModelChatTransport, AXMAiManagementModelEntityModel, AXMAiManagementModelPurposeSlug, AXMAiManagementOpenAiEndpointEntityModel, AXMAiModelPurposeSlug, AXPAiAssistPickerRow, AXPAiAssistPopupSize, AXPAiAssistPromptSubmitPayload, AXPAiAssistRunContext, AXPAiAssistRunInput, AXPAiAssistRunResult, AXPAiAssistShowOptions, AXPAiAssistStructuredOutputAttemptRecord, AXPAiAssistStructuredOutputRunRaw, AXPAiAssistTokenUsageSnapshot, AXPAiAssistUserMediaAttachment, AXPAiChatAgentAssistantResponse, AXPAiChatAgentResultBody, AXPAiChatAgentResultResponse, AXPAiChatAudioResponse, AXPAiChatFileResponse, AXPAiChatImageResponse, AXPAiChatMessage, AXPAiChatModelListItem, AXPAiChatModelListRequest, AXPAiChatNodeResponse, AXPAiChatResponse, AXPAiChatTextResponse, AXPAiChatThinkResponse, AXPAiChatToolAssistantResponse, AXPAiChatToolInvocationContent, AXPAiChatToolResultBody, AXPAiChatToolResultResponse, AXPAiChatToolRunContext, AXPAiChatTransport, AXPAiDelegatedAgentResultPayload, AXPAiDelegatedAgentTranscriptEntry, AXPAiDelegatedNestedToolCallContext, AXPAiDelegatedParameterBinding, AXPAiDelegatedParameterDefinition, AXPAiEffectiveAgentRow, AXPAiEffectiveAssistRow, AXPAiEngineLastProviderPayload, AXPAiEngineRegistryToolFields, AXPAiEngineRunEvent, AXPAiEngineRunOptions, AXPAiEngineRunResult, AXPAiEngineUsageTotals, AXPAiExtractDocumentTextFromStoredFileRequest, AXPAiPlanningMode, AXPAiPlatformRuntimeContext, AXPAiStructuredTextCompletionOptions, AXPAiStructuredValidator, AXPAiToolCall, AXPAiToolSchema };