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

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, AXPFileListItem } from '@acorex/platform/core';
+import { AXPMultiLanguageString, AXPFileListItem, AXPModuleManifest, AXPDataSourceDefinitionProvider, AXPDataSourceDefinition } from '@acorex/platform/core';
 import * as i2 from '@acorex/platform/layout/widgets';
-import { AXPEntity, AXPMenuProvider, AXPMenuProviderContext, AXPFileStorageService } from '@acorex/platform/common';
-import { AXPEntityDefinitionLoader, AXPEntityPreloadEntity, AXPEntityService, AXPEntityModel } from '@acorex/platform/layout/entity';
+import { AXPEntityModel, AXPEntityDefinitionLoader, AXPEntityPreloadEntity, AXPEntityService } from '@acorex/platform/layout/entity';
+import { AXPOutputTranscriptSegmentId, AXPAgentOutputKind, AXPAgentOutputContract, AXPJsonSchemaLike, AXPAgentResponseFormat, AXPEntity, AXPMenuProvider, AXPMenuProviderContext, AXPFileStorageService } from '@acorex/platform/common';
 import { AXPPermissionDefinitionProvider, AXPPermissionDefinitionProviderContext } from '@acorex/platform/auth';
 
 declare class AXMAiManagementModule {
@@ -13,439 +13,25 @@ declare class AXMAiManagementModule {
     static ɵinj: i0.ɵɵ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 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 box (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 prompt box column inside the bottom overlay (maps to `contentMaxWidthPx`).
- */
-type AXPAiAssistPopupSize = 'sm' | 'md' | 'lg' | 'xl' | 'full';
-/**
- * Indeterminate loading dialog shown while the prompt box executes an assist run after Send (model work /
- * structured-output retries).
- */
-interface AXPAiAssistRunLoadingDialogSpec {
-    title: string;
-    text: string;
-}
-/**
- * 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 {
-    /**
-     * Prompt box header; must be translated by the caller. Entity list assist uses
-     * `@extensions-ai-entity:assist.dialog-title.{type-level|selected|individual}`.
-     */
-    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;
-    /**
-     * When set, shows an indeterminate loading dialog for the duration of each submitted run until `run` settles.
-     * Callers supply translated strings.
-     */
-    runLoadingDialog?: AXPAiAssistRunLoadingDialogSpec;
-}
-
-declare const RootConfig: {
-    config: {
-        i18n: string;
-        module: string;
-        route: string;
-    };
-    module: {
-        name: string;
-        route: string;
-        title: string;
-        icon: string;
-    };
-    entities: {
-        model: {
-            name: string;
-            fullName: string;
-            title: string;
-            titlePlural: string;
-            icon: string;
-        };
-        assist: {
-            name: string;
-            fullName: string;
-            title: string;
-            titlePlural: string;
-            icon: string;
-        };
-        agent: {
-            name: string;
-            fullName: string;
-            title: string;
-            titlePlural: string;
-            icon: string;
-        };
-        openAiEndpoint: {
-            name: string;
-            fullName: string;
-            title: string;
-            titlePlural: string;
-            icon: string;
-        };
-    };
-};
-
-declare class AXMAiManagementEntityProvider implements AXPEntityDefinitionLoader {
-    preload(): AXPEntityPreloadEntity[];
-    get(moduleName: string, entityName: string): Promise<AXPEntity | null>;
-    list(): Promise<{
-        name: string;
-        module: string;
-    }[]>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXMAiManagementEntityProvider, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXMAiManagementEntityProvider>;
-}
-
-/**
- * AI Management Module Manifest.
- * Defines module metadata for AI provider and API key management.
- */
-declare const AiManagementManifest: AXPModuleManifest;
-
-/**
- * AI Management menu keys.
- * Pattern: AiManagement:Menu:{Path}
- */
-declare const AXPAiManagementMenuKeys: {
-    /** OpenAI-compatible HTTP endpoints (base URL + API key). */
-    readonly OpenAiEndpoints: "AiManagement:Menu:OpenAiEndpoints";
-    /** List of AI models (from providers). */
-    readonly Models: "AiManagement:Menu:Models";
-    /** List of Assists. */
-    readonly Assists: "AiManagement:Menu:Assists";
-    /** Delegated specialist agents (supervisor routing). */
-    readonly Agents: "AiManagement:Menu:Agents";
-};
-
-declare class AXMAiManagementMenuProvider implements AXPMenuProvider {
-    private readonly entityService;
-    provide(context: AXPMenuProviderContext): Promise<void>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXMAiManagementMenuProvider, never>;
-    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 {
+/** Denormalized {@link AiRule} snapshot on assist/agent rows (multi-lookup expose). */
+interface AXMAiManagementRuleRef {
+    id: string;
+    /** Unique programmatic key used by the engine (`includeRules` / `excludeRules`). */
     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>;
+    title: AXPMultiLanguageString;
 }
-
-/**
- * AI Management setting keys.
- * Pattern: AiManagement:Setting:{Path}
- */
-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";
-        };
-        readonly Demis: {
-            readonly BearerToken: "AiManagement:Setting:Providers.Demis.BearerToken";
-        };
-    };
-};
-
 /**
- * Full AI model catalog for chat (rows that include `chat` or `vision` in `modelPurposes`).
- * Registry name: {@link AI_MODEL_CATALOG_DATASOURCE_NAME}.
- */
-declare const AI_MODEL_CATALOG_DATASOURCE_NAME = "ai-management-model-catalog";
-/**
- * Image-generation models only (`modelPurposes` includes `image`).
- * Registry name: {@link AI_MODEL_IMAGE_CATALOG_DATASOURCE_NAME}.
+ * Persisted AiRule catalog row — reusable system-prompt fragments referenced by name.
  */
-declare const AI_MODEL_IMAGE_CATALOG_DATASOURCE_NAME = "ai-management-model-catalog-image";
-/**
- * Speech-to-text models only (`modelPurposes` includes `speech`).
- * Registry name: {@link AI_MODEL_SPEECH_CATALOG_DATASOURCE_NAME}.
- */
-declare const AI_MODEL_SPEECH_CATALOG_DATASOURCE_NAME = "ai-management-model-catalog-speech";
-/**
- * Text-to-speech models only (`modelPurposes` includes `tts`).
- * Registry name: {@link AI_MODEL_TTS_CATALOG_DATASOURCE_NAME}.
- */
-declare const AI_MODEL_TTS_CATALOG_DATASOURCE_NAME = "ai-management-model-catalog-tts";
-type AXMAiModelPurposeSlug = 'chat' | 'vision' | 'image' | 'speech' | 'tts';
-/** Normalizes `modelPurposes` (and legacy `modelPurpose`) to unique non-empty slugs. */
-declare function normalizeModelPurposes(row: Record<string, unknown> | null | undefined): string[];
-declare function modelRowHasPurpose(row: Record<string, unknown> | null | undefined, purpose: AXMAiModelPurposeSlug): boolean;
-/** Rows usable in chat / completion pickers: include `chat` or `vision`; not image/speech/tts-only. */
-declare function isChatPurposeModelRow(row: Record<string, unknown> | null | undefined): boolean;
-declare function isImagePurposeModelRow(row: Record<string, unknown> | null | undefined): boolean;
-declare function isSpeechPurposeModelRow(row: Record<string, unknown> | null | undefined): boolean;
-declare function isTtsPurposeModelRow(row: Record<string, unknown> | null | undefined): boolean;
-declare class AXMAiModelCatalogDataSourceDefinition implements AXPDataSourceDefinitionProvider {
-    private readonly entityService;
-    items(): Promise<AXPDataSourceDefinition[]>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXMAiModelCatalogDataSourceDefinition, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXMAiModelCatalogDataSourceDefinition>;
-}
-
-/** Registry name for AiAgent catalog rows (delegated specialist definitions). */
-declare const AI_AGENT_CATALOG_DATASOURCE_NAME = "ai-management-agent-catalog";
-declare class AXMAiAgentCatalogDataSourceDefinition implements AXPDataSourceDefinitionProvider {
-    private readonly entityService;
-    items(): Promise<AXPDataSourceDefinition[]>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXMAiAgentCatalogDataSourceDefinition, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXMAiAgentCatalogDataSourceDefinition>;
-}
-
-/** AI-capable command definitions for specialist registry scope (matches AiAgent entity lookup filter). */
-declare const AI_COMMAND_REGISTRY_CATALOG_DATASOURCE_NAME = "ai-management-command-registry-catalog";
-/** AI-capable query definitions for specialist registry scope. */
-declare const AI_QUERY_REGISTRY_CATALOG_DATASOURCE_NAME = "ai-management-query-registry-catalog";
-declare class AXMAiCommandRegistryCatalogDataSourceDefinition implements AXPDataSourceDefinitionProvider {
-    private readonly entityService;
-    items(): Promise<AXPDataSourceDefinition[]>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXMAiCommandRegistryCatalogDataSourceDefinition, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXMAiCommandRegistryCatalogDataSourceDefinition>;
-}
-declare class AXMAiQueryRegistryCatalogDataSourceDefinition implements AXPDataSourceDefinitionProvider {
-    private readonly entityService;
-    items(): Promise<AXPDataSourceDefinition[]>;
-    static ɵfac: i0.ɵɵFactoryDeclaration<AXMAiQueryRegistryCatalogDataSourceDefinition, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<AXMAiQueryRegistryCatalogDataSourceDefinition>;
+interface AXMAiManagementRuleEntityModel extends AXPEntityModel<string> {
+    /** Programmatic key (e.g. `markdown`); referenced from assist/agent `rules` and engine run options. */
+    name: string;
+    title: AXPMultiLanguageString;
+    description?: AXPMultiLanguageString;
+    /** Rule body merged into the engine system prompt when the rule is included. */
+    markdown: string;
 }
 
-/**
- * Human-readable specialist prompt from delegated-agent tool arguments (conversation / mini-chat UI).
- */
-declare function axpAiDelegatedAgentPromptPreview(argumentsValue: unknown): string;
-
-/**
- * Recursively parses string values that look like JSON objects or arrays, then
- * normalizes nested values the same way.
- *
- * LLM tool calls often stringify nested payloads (e.g. `__context__` for
- * `Entity:Create`). Use this before passing args to the command or query service
- * from AI paths only — not inside generic command infrastructure.
- *
- * @param toolName When set, command-specific AI defaults from command definitions are merged (e.g. `Entity:Create` redirect).
- */
-declare function normalizeAiToolCommandArgs(value: unknown, toolName?: string): unknown;
-
 /**
  * Persisted AiAgent catalog row (entity storage shape).
  */
@@ -454,12 +40,44 @@ interface AXMAiManagementAgentEntityModel extends AXPEntityModel<string> {
     title: AXPMultiLanguageString;
     description?: AXPMultiLanguageString;
     systemPrompt?: string;
+    /** Selected {@link AiRule} catalog ids (multi-lookup value field). */
+    ruleIds?: string[] | null;
+    /** Denormalized rule rows from multi-lookup expose (`title` = display, `name` = engine key). */
+    rules?: AXMAiManagementRuleRef[] | null;
+    /** Transcript segment preset id (`text` | `node` | `followUp`); resolved via segment providers at runtime. */
+    outputContract?: AXPOutputTranscriptSegmentId | string | null;
     modelEntityId?: string | null;
-    toolIds?: unknown;
+    commandIds?: unknown;
     queryIds?: unknown;
     maxSteps?: number;
 }
 
+/** @see {@link AXPAgentOutputKind} */
+type AXPAiAgentOutputKind = AXPAgentOutputKind;
+/** @see {@link AXPOutputTranscriptSegmentId} */
+type AXPAiOutputTranscriptSegment = AXPOutputTranscriptSegmentId;
+/** @see {@link AXPAgentOutputContract} */
+type AXPAiAgentOutputContract = AXPAgentOutputContract;
+/** @see {@link AXPJsonSchemaLike} */
+type AXPAiJsonSchemaLike$1 = AXPJsonSchemaLike;
+/** @see {@link AXPAgentResponseFormat} */
+type AXPAiResponseFormat$1 = AXPAgentResponseFormat;
+/** @see {@link AXP_AGENT_OUTPUT_CONTRACT_DEFAULT_STRUCTURED_RETRIES} */
+declare const AXPAI_AGENT_OUTPUT_CONTRACT_DEFAULT_STRUCTURED_RETRIES = 2;
+/** Resolved transcript mapping for an object contract (defaults to `text`). */
+declare function resolveOutputTranscriptSegment(contract: AXPAiAgentOutputContract): AXPAiOutputTranscriptSegment;
+/**
+ * Normalizes persisted `outputContract` (object or JSON string from entity forms).
+ * Returns `null` when absent or invalid (engine treats as implicit `string`).
+ */
+declare function parseAgentOutputContract(raw: unknown): AXPAiAgentOutputContract | null;
+/** Resolved contract for engine (never null; defaults to string). */
+declare function resolveAgentOutputContract(raw: unknown): AXPAiAgentOutputContract;
+declare function axpAiAgentOutputContractUsesStructuredFinalize(contract: AXPAiAgentOutputContract): boolean;
+/** Structured kinds omit the string role baseline (Markdown prose hint) in the mock engine. */
+declare function axpAiAgentOutputContractOmitsRoleBaseline(contract: AXPAiAgentOutputContract): boolean;
+declare function axpAiAgentOutputContractStructuredRetryCap(contract: AXPAiAgentOutputContract): number;
+
 /** Aligns with {@link AXPAiPlanningMode} in ai-engine.types (avoid circular imports). */
 type AXMAiManagementAssistPlanningMode = 'off' | 'once' | 'when-needed';
 /**
@@ -484,6 +102,12 @@ interface AXMAiManagementAssistEntityModel extends AXPEntityModel<string> {
         text: AXPMultiLanguageString;
     }[] | null;
     systemPrompt?: string;
+    /** Default output contract for runs using this assist (overridden by agent or run input). */
+    outputContract?: AXPAiAgentOutputContract;
+    /** Selected {@link AiRule} catalog ids (multi-lookup value field). */
+    ruleIds?: string[] | null;
+    /** Denormalized rule rows from multi-lookup expose (`title` = display, `name` = engine key). */
+    rules?: AXMAiManagementRuleRef[] | null;
     /** Knowledge-base attachments (PDF and image formats) for this assist. */
     knowledgeFiles?: AXPFileListItem[] | null;
     delegatedAgents?: {
@@ -494,23 +118,10 @@ interface AXMAiManagementAssistEntityModel extends AXPEntityModel<string> {
     }[] | null;
 }
 
-/** 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`. */
-declare const AXPAI_DELEGATED_AGENT_DEFAULT_MAX_STEPS = 8;
-/** System prompt for vision OCR / document text extraction. */
-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' | 'demis';
-type AXPAiPlanningMode = 'off' | 'once' | 'when-needed';
 /**
  * Snapshot of session / tenant / regional defaults injected into system prompts.
- * Built by {@link AXPAiPlatformRuntimeContextBuilder}.
+ * Built by {@link AXPAiPlatformRuntimeContextBuilder} before calling {@link AXPAiEngine}.
  */
 interface AXPAiPlatformRuntimeContext {
     userId?: string;
@@ -527,45 +138,21 @@ interface AXPAiPlatformRuntimeContext {
     currentLocalDateTime?: string;
     notes?: string;
 }
-/** Who supplies a delegated `agent:<id>` tool argument at runtime. */
-type AXPAiDelegatedParameterBinding = 'assist_locked' | 'assist_default' | 'supervisor';
-/**
- * Per-field policy for arguments the supervisor passes when calling a delegated specialist.
- * Names are the tool argument keys; the runtime builds supervisor JSON Schema from this list.
- */
-interface AXPAiDelegatedParameterDefinition {
-    name: string;
-    title?: string;
-    description?: string;
-    binding: AXPAiDelegatedParameterBinding;
-    /** Used when assist row has no value for an `assist_default` key (optional fallback). */
-    defaultValue?: unknown;
-    /**
-     * Optional UI grouping for property viewer / assist parameter editor (collapsible groups in one tab).
-     */
-    group?: {
-        name: string;
-        title: string;
-        order?: number;
-    };
-}
 /**
  * Effective Assist entity row (chat policy, prompts, delegated routing).
- * Fields are partial except `id` because runtime/query payloads may omit unused slices.
+ * Fields are partial except `id` because API payloads may omit unused slices.
  */
 type AXPAiEffectiveAssistRow = Partial<Omit<AXMAiManagementAssistEntityModel, 'id'>> & {
     id: string;
-    /** Optional catalog row not persisted on the assist entity; used by mock seeds. */
     imageModelId?: string;
 };
 /**
- * Effective AiAgent catalog row (registry scope + optional supervisor JSON schema).
- * Fields are partial except `id` because runtime/query payloads may omit unused slices.
+ * Effective AiAgent catalog row for UI and engine requests.
+ * Engine-specific fields are normalized in connectivity (mock / API).
  */
 type AXPAiEffectiveAgentRow = Partial<Omit<AXMAiManagementAgentEntityModel, 'id'>> & {
     id: string;
-    /** Defines keys, bindings, and drives supervisor JSON Schema (empty or omitted → default `query` only). */
-    parameterDefinitions?: AXPAiDelegatedParameterDefinition[] | null;
+    outputContract?: AXPAiAgentOutputContract | null;
 };
 interface AXPAiChatModelListRequest {
     assistId?: string | null;
@@ -575,7 +162,7 @@ interface AXPAiChatModelListItem {
     id: string;
     name: string;
     title: string;
-    /** Normalized `modelPurposes` from the catalog row (for tenant default / capability checks). */
+    /** `modelPurposes` from the catalog row (provided by the API). */
     modelPurposes?: string[];
     chatTransport?: string;
     maxContextTokens?: number;
@@ -587,14 +174,13 @@ interface AXPAiChatTextResponse {
     type: 'text';
     content: string;
 }
-/** Model reasoning / planning segment; paired with {@link AXPAiChatTextResponse} in assistant messages. Persisted in the transcript; a future setting may omit it from storage. */
+/** Model reasoning / planning segment; paired with {@link AXPAiChatTextResponse} in assistant messages. */
 interface AXPAiChatThinkResponse {
     type: 'think';
     content: string;
 }
 /**
  * Stored binary in tenant file storage (user attachment or assistant/tool output replay).
- * Interpretation is by {@link AXPAiChatFileResponse.content.mimeType} (e.g. image/*, audio/*, application/pdf).
  */
 interface AXPAiChatFileResponse {
     type: 'file';
@@ -620,7 +206,6 @@ interface AXPAiChatFollowUpResponse {
     type: 'followUp';
     content: AXPAiChatFollowUpItem[];
 }
-/** Assistant-side tool / agent invocation segment (replay + OpenAI `tool_calls`). */
 interface AXPAiChatToolInvocationContent {
     command: string;
     arguments: unknown;
@@ -640,20 +225,15 @@ interface AXPAiChatToolResultResponse {
     callId: string;
     content: unknown;
 }
-/**
- * Segments a delegated specialist returns to the supervisor (replayable in UI; no tool-call shapes).
- */
+/** Segments a delegated specialist returns to the supervisor (replayable in UI). */
 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.
- */
+/** Tool-role `agent_result` body from the engine (normalized by connectivity). */
 interface AXPAiDelegatedAgentResultPayload {
     success: boolean;
     error?: string;
     data?: {
         agentName?: string;
         agentId?: string;
-        /** Ordered specialist output (e.g. text only, file only, node only, or mixed). */
         responses: AXPAiDelegatedAgentResultSegment[];
     };
 }
@@ -666,14 +246,12 @@ interface 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.
  */
 interface AXPAiChatMessage {
     role: 'system' | 'user' | 'assistant' | 'tool';
     responses: AXPAiChatResponse[];
-    /** OpenAI `name` on tool results / some provider echoes. */
     name?: string;
-    /** When true, excluded from delegated outcome {@code data.responses} synthesis (see {@link axpAiChatMessageIsDelegatedReflectionExcluded}). */
+    /** Ephemeral delegated sub-run reflection (excluded from user-facing replay). */
     delegatedReflection?: boolean;
 }
 interface AXPAiToolCall {
@@ -681,22 +259,6 @@ interface AXPAiToolCall {
     name: string;
     arguments: unknown;
 }
-interface AXPAiToolSchema {
-    name: string;
-    description?: string;
-    parameters: Record<string, unknown>;
-}
-/** Registry allow-list on an assist or agent (command ids / query ids). */
-interface AXPAiEngineRegistryToolFields {
-    /** Same persistence shapes as {@link AXPAiEffectiveAgentRow.toolIds}. */
-    toolIds?: unknown;
-    /** Same persistence shapes as {@link AXPAiEffectiveAgentRow.queryIds}. */
-    queryIds?: unknown;
-}
-/**
- * Normalized payload from the last underlying LLM/vendor call during an engine run.
- * Detailed chat/extract/image request types live in connectivity mock (`ai-chat-provider.types`).
- */
 interface AXPAiEngineLastProviderPayload {
     messages: AXPAiChatMessage[];
     toolCalls?: AXPAiToolCall[];
@@ -708,7 +270,6 @@ interface AXPAiEngineUsageTotals {
     totalTokens: number;
     cachedPromptTokens?: number;
 }
-/** Cached specialist transcript for a supervisor `agent:*` tool_call id (mock LRU / future server mirror). */
 interface AXPAiDelegatedAgentTranscriptEntry {
     agentName?: string;
     messages: AXPAiChatMessage[];
@@ -722,11 +283,7 @@ type AXPAiEngineRunEvent = {
     type: 'assistant_stream_reset';
 } | {
     type: 'assistant_stream_delta';
-    delta: string;
-    /**
-     * `think` = planning-only stream (no tags required). Omitted or `text` = main assistant stream.
-     * Raw `delta` strings are the same as from the provider; this field is the engine’s semantic.
-     */
+    delta: string;
     segment?: 'text' | 'think';
 } | {
     type: 'tool_call_start';
@@ -758,19 +315,18 @@ 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;
-    /** Legacy catalog `name` (API id) before entity ids were used. */
     modelId?: string;
     maxSteps?: number;
     maxTokens?: number;
     temperature?: number;
-    /** Overrides assist-stored planning for this run (UI / tests). */
-    planningMode?: AXPAiPlanningMode;
+    planningMode?: 'off' | 'once' | 'when-needed';
+    includeRules?: string[];
+    excludeRules?: string[];
     platformRuntimeContext?: AXPAiPlatformRuntimeContext | null;
+    outputContract?: AXPAiAgentOutputContract;
     onRunEvent?: (event: AXPAiEngineRunEvent) => void;
 }
 interface AXPAiEngineRunResult {
@@ -779,96 +335,515 @@ interface AXPAiEngineRunResult {
     usageTotals?: AXPAiEngineUsageTotals;
     delegatedTranscriptsByCallId?: Record<string, AXPAiDelegatedAgentTranscriptEntry>;
 }
-interface AXPAiStructuredTextCompletionOptions {
+
+interface AXPAiAssistValidationError {
+    phase: 'parse' | 'validator';
+    message: string;
+    details?: unknown;
+}
+interface AXPAiAssistCannotComplete {
+    reason: 'missingInput' | 'unsafe' | 'unsupported';
+    missing?: string[];
+    message?: string;
+}
+/**
+ * Normalized result of an assist run or structured-output pipeline session.
+ */
+interface AXPAiAssistExecutionResult<TData = unknown> {
+    success: boolean;
+    outputKind: AXPAiAgentOutputKind;
+    text: string;
+    data?: TData;
+    followUp?: {
+        items: AXPAiChatFollowUpItem[];
+    };
+    followUpRequired?: boolean;
+    followUpQuestion?: string;
+    validationErrors?: AXPAiAssistValidationError[];
+    cannotComplete?: AXPAiAssistCannotComplete;
+    raw?: unknown;
+    messages?: AXPAiChatMessage[];
+}
+
+/** 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 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 box (text, optional target assist/agent, optional media).
+ */
+interface AXPAiAssistPromptSubmitPayload {
+    prompt: string;
     assistId?: string;
-    modelEntityId?: string;
-    modelId?: string;
-    messages: AXPAiChatMessage[];
+    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;
+    /**
+     * Declarative output contract for this run (preferred over legacy {@link expectStructuredOutput} flags).
+     * Resolved with agent/assist defaults via {@link resolveEffectiveOutputContract}.
+     */
+    outputContract?: AXPAiAgentOutputContract;
+    /** 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 {
+    /** When false, structured validation exhausted or cannotComplete (future). */
+    success?: boolean;
+    /** Effective output contract kind for this run. */
+    outputKind?: AXPAiAgentOutputKind;
+    /** 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;
+    /** Same as {@link structured} when using the execution-result envelope. */
+    data?: unknown;
+    /** Validation failures when returned without throwing (reserved). */
+    validationErrors?: AXPAiAssistValidationError[];
+    /** Full normalized transcript when available. */
+    messages?: AXPAiChatMessage[];
+    /**
+     * 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 prompt box column inside the bottom overlay (maps to `contentMaxWidthPx`).
+ */
+type AXPAiAssistPopupSize = 'sm' | 'md' | 'lg' | 'xl' | 'full';
+/**
+ * Indeterminate loading dialog shown while the prompt box executes an assist run after Send (model work /
+ * structured-output retries).
+ */
+interface AXPAiAssistRunLoadingDialogSpec {
+    title: string;
+    text: string;
+}
+/**
+ * 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 {
+    /**
+     * Prompt box header; must be translated by the caller. Entity list assist uses
+     * `@extensions-ai-entity:assist.dialog-title.{type-level|selected|individual}`.
+     */
+    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;
-    platformRuntimeContext?: AXPAiPlatformRuntimeContext | null;
+    maxTokens?: number;
+    outputContract?: AXPAiAgentOutputContract;
+    expectStructuredOutput?: boolean;
+    structuredOutputInstruction?: string;
+    platformRuntimeNotes?: Record<string, unknown>;
+    maxStructuredRetries?: number;
+    structuredValidator?: AXPAiStructuredValidator;
+    retryOnInvalidStructure?: boolean;
+    structuredOutputSchemaSummary?: string;
+    structuredOutputMaxTokens?: number;
+    /**
+     * When set, shows an indeterminate loading dialog for the duration of each submitted run until `run` settles.
+     * Callers supply translated strings.
+     */
+    runLoadingDialog?: AXPAiAssistRunLoadingDialogSpec;
 }
-interface AXPAiExtractDocumentTextFromStoredFileRequest {
-    assistId: string;
-    chatTransport: AXPAiChatTransport;
-    fileId: string;
-    instruction?: string;
-    modelEntityId?: string;
+
+declare const RootConfig: {
+    config: {
+        i18n: string;
+        module: string;
+        route: string;
+    };
+    module: {
+        name: string;
+        route: string;
+        title: string;
+        icon: string;
+    };
+    entities: {
+        model: {
+            name: string;
+            fullName: string;
+            title: string;
+            titlePlural: string;
+            icon: string;
+        };
+        assist: {
+            name: string;
+            fullName: string;
+            title: string;
+            titlePlural: string;
+            icon: string;
+        };
+        agent: {
+            name: string;
+            fullName: string;
+            title: string;
+            titlePlural: string;
+            icon: string;
+        };
+        openAiEndpoint: {
+            name: string;
+            fullName: string;
+            title: string;
+            titlePlural: string;
+            icon: string;
+        };
+        rule: {
+            name: string;
+            fullName: string;
+            title: string;
+            titlePlural: string;
+            icon: string;
+        };
+    };
+};
+
+declare class AXMAiManagementEntityProvider implements AXPEntityDefinitionLoader {
+    preload(): AXPEntityPreloadEntity[];
+    get(moduleName: string, entityName: string): Promise<AXPEntity | null>;
+    list(): Promise<{
+        name: string;
+        module: string;
+    }[]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXMAiManagementEntityProvider, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXMAiManagementEntityProvider>;
 }
-type AXPAiChatToolResultBody = unknown;
-type AXPAiChatAgentResultBody = AXPAiDelegatedAgentResultPayload;
-/**
- * Reads a stored-file artifact from a normalized tool handler body (`{ success, data }`) or a flat `data` object.
- */
-declare function axpAiExtractStoredFileArtifactFromUnknown(content: unknown): AXPAiChatFileResponse['content'] | null;
-/**
- * Returns the last stored-file artifact announced in any `tool` → `tool_result` segment (delegated sub-runs, main chat).
- */
-declare function axpAiExtractLastStoredFileArtifactFromChatMessages(messages: AXPAiChatMessage[]): AXPAiChatFileResponse['content'] | null;
+
 /**
- * Ensures the delegated specialist transcript replays stored files in assistant `responses`
- * (not only prose that points at tool JSON).
+ * AI Management Module Manifest.
+ * Defines module metadata for AI provider and API key management.
  */
-declare function axpAiDelegatedSubTranscriptAppendFileArtifactFromToolResults(messages: AXPAiChatMessage[]): AXPAiChatMessage[];
+declare const AiManagementManifest: AXPModuleManifest;
+
 /**
- * Parses a JSON-like array of specialist segments (e.g. from persisted tool output). Invalid entries are skipped.
+ * AI Management menu keys.
+ * Pattern: AiManagement:Menu:{Path}
  */
-declare function axpAiParseDelegatedAgentResultSegmentsFromUnknown(raw: unknown): AXPAiDelegatedAgentResultSegment[];
+declare const AXPAiManagementMenuKeys: {
+    /** OpenAI-compatible HTTP endpoints (base URL + API key). */
+    readonly OpenAiEndpoints: "AiManagement:Menu:OpenAiEndpoints";
+    /** List of AI models (from providers). */
+    readonly Models: "AiManagement:Menu:Models";
+    /** List of Assists. */
+    readonly Assists: "AiManagement:Menu:Assists";
+    /** Delegated specialist agents (supervisor routing). */
+    readonly Agents: "AiManagement:Menu:Agents";
+    /** Reusable system-prompt rules (Markdown fragments). */
+    readonly Rules: "AiManagement:Menu:Rules";
+};
+
+declare class AXMAiManagementMenuProvider implements AXPMenuProvider {
+    private readonly entityService;
+    provide(context: AXPMenuProviderContext): Promise<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXMAiManagementMenuProvider, never>;
+    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;
+}
 /**
- * Collects ordered {@link AXPAiDelegatedAgentResultSegment} from a delegated sub-run transcript
- * (excludes {@link AXPAiChatMessage.delegatedReflection} lines).
+ * Loads assist catalog rows for dynamic permission definitions.
+ * Skips rows without a stable programmatic `name`.
  */
-declare function axpAiCollectDelegatedAgentOutcomeResponses(messages: AXPAiChatMessage[]): AXPAiDelegatedAgentResultSegment[];
+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>;
+}
+
 /**
- * Plain text from {@link AXPAiDelegatedAgentResultSegment} (text + think only; for provider hints / markdown fallbacks).
+ * AI Management setting keys.
+ * Pattern: AiManagement:Setting:{Path}
  */
-declare function axpAiDelegatedAgentOutcomeResponsesPlainText(segments: AXPAiDelegatedAgentResultSegment[]): string;
-declare function axpAiChatTextMessage(role: AXPAiChatMessage['role'], text: string): AXPAiChatMessage;
-declare function axpAiChatUserMessage(responses: AXPAiChatResponse[]): AXPAiChatMessage;
-declare function axpAiChatMessageGetText(message: AXPAiChatMessage): string;
+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";
+        };
+        readonly Demis: {
+            readonly BearerToken: "AiManagement:Setting:Providers.Demis.BearerToken";
+        };
+    };
+};
+
 /**
- * Planning-only assistant output is always internal reasoning. Provider text may be untagged;
- * the engine maps `text` responses to `think` so the transcript and UI are correct without
- * requiring `<think>` / `<think>` in the model output.
+ * Full AI model catalog for chat (rows that include `chat` or `vision` in `modelPurposes`).
+ * Registry name: {@link AI_MODEL_CATALOG_DATASOURCE_NAME}.
  */
-declare function axpAiCoercePlanningAssistantTextToThink(planningMessages: AXPAiChatMessage[]): AXPAiChatMessage[];
-declare function axpAiChatMessagesFromProviderAssistant(text: string, toolCalls?: AXPAiToolCall[]): AXPAiChatMessage[];
-declare function axpAiToolCallFromAssistantToolMessage(message: AXPAiChatMessage): AXPAiToolCall | null;
-declare function axpAiChatToolResultMessage(callId: string, content: unknown, toolName?: string): AXPAiChatMessage;
-declare function axpAiChatAgentResultMessage(callId: string, content: AXPAiDelegatedAgentResultPayload, toolName?: string): AXPAiChatMessage;
-declare function axpAiNormalizeHandlerResultToToolBody(handlerResult: unknown): unknown;
-declare function axpAiChatToolOrAgentResultBodyJson(message: AXPAiChatMessage): string;
+declare const AI_MODEL_CATALOG_DATASOURCE_NAME = "ai-management-model-catalog";
 /**
- * Compact JSON string of a tool-role message’s `tool_result` body (transcript tail / logs).
+ * Image-generation models only (`modelPurposes` includes `image`).
+ * Registry name: {@link AI_MODEL_IMAGE_CATALOG_DATASOURCE_NAME}.
  */
-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[];
+declare const AI_MODEL_IMAGE_CATALOG_DATASOURCE_NAME = "ai-management-model-catalog-image";
 /**
- * Whether the current user turn already has a usable {@code followUp} segment from the follow-up specialist.
+ * Speech-to-text models only (`modelPurposes` includes `speech`).
+ * Registry name: {@link AI_MODEL_SPEECH_CATALOG_DATASOURCE_NAME}.
  */
-declare function axpAiTranscriptAlreadyHasFollowUpInTurn(messages: AXPAiChatMessage[], followUpAgentId: string): boolean;
+declare const AI_MODEL_SPEECH_CATALOG_DATASOURCE_NAME = "ai-management-model-catalog-speech";
 /**
- * Engine may auto-call the follow-up specialist after the supervisor finishes, unless the turn is trivial.
+ * Text-to-speech models only (`modelPurposes` includes `tts`).
+ * Registry name: {@link AI_MODEL_TTS_CATALOG_DATASOURCE_NAME}.
  */
-declare function axpAiShouldAutoInvokeFollowUpAgent(messages: AXPAiChatMessage[]): boolean;
-/** Builds the `query` argument for an automatic follow-up specialist sub-run. */
-declare function axpAiBuildAutoFollowUpAgentQuery(messages: AXPAiChatMessage[]): string;
+declare const AI_MODEL_TTS_CATALOG_DATASOURCE_NAME = "ai-management-model-catalog-tts";
+type AXMAiModelPurposeSlug = 'chat' | 'vision' | 'image' | 'speech' | 'tts';
+/** Reads `modelPurposes` from a catalog row (API/mock must provide the array). */
+declare function readModelPurposes(row: Record<string, unknown> | null | undefined): string[];
+declare function modelRowHasPurpose(row: Record<string, unknown> | null | undefined, purpose: AXMAiModelPurposeSlug): boolean;
+/** Rows usable in chat / completion pickers: include `chat` or `vision`; not image/speech/tts-only. */
+declare function isChatPurposeModelRow(row: Record<string, unknown> | null | undefined): boolean;
+declare function isImagePurposeModelRow(row: Record<string, unknown> | null | undefined): boolean;
+declare function isSpeechPurposeModelRow(row: Record<string, unknown> | null | undefined): boolean;
+declare function isTtsPurposeModelRow(row: Record<string, unknown> | null | undefined): boolean;
+declare class AXMAiModelCatalogDataSourceDefinition implements AXPDataSourceDefinitionProvider {
+    private readonly entityService;
+    items(): Promise<AXPDataSourceDefinition[]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXMAiModelCatalogDataSourceDefinition, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXMAiModelCatalogDataSourceDefinition>;
+}
+
+/** Registry name for AiAgent catalog rows (delegated specialist definitions). */
+declare const AI_AGENT_CATALOG_DATASOURCE_NAME = "ai-management-agent-catalog";
+declare class AXMAiAgentCatalogDataSourceDefinition implements AXPDataSourceDefinitionProvider {
+    private readonly entityService;
+    items(): Promise<AXPDataSourceDefinition[]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXMAiAgentCatalogDataSourceDefinition, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXMAiAgentCatalogDataSourceDefinition>;
+}
+
+/** Registry name for transcript-segment presets ({@link AXP_OUTPUT_CONTRACT_TRANSCRIPT_SEGMENT_PROVIDER}). */
+declare const AI_OUTPUT_CONTRACT_TRANSCRIPT_SEGMENT_DATASOURCE_NAME = "ai-management-output-contract-transcript-segment";
+interface AXMOutputContractTranscriptSegmentDataSourceRow {
+    id: AXPOutputTranscriptSegmentId;
+    name: AXPOutputTranscriptSegmentId;
+    title: string;
+    description?: string;
+}
+declare class AXMOutputContractTranscriptSegmentDataSourceDefinition implements AXPDataSourceDefinitionProvider {
+    private readonly segmentService;
+    items(): Promise<AXPDataSourceDefinition[]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXMOutputContractTranscriptSegmentDataSourceDefinition, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXMOutputContractTranscriptSegmentDataSourceDefinition>;
+}
+
+/** AI-capable command definitions for specialist registry scope (matches AiAgent entity lookup filter). */
+declare const AI_COMMAND_REGISTRY_CATALOG_DATASOURCE_NAME = "ai-management-command-registry-catalog";
+/** AI-capable query definitions for specialist registry scope. */
+declare const AI_QUERY_REGISTRY_CATALOG_DATASOURCE_NAME = "ai-management-query-registry-catalog";
+declare class AXMAiCommandRegistryCatalogDataSourceDefinition implements AXPDataSourceDefinitionProvider {
+    private readonly entityService;
+    items(): Promise<AXPDataSourceDefinition[]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXMAiCommandRegistryCatalogDataSourceDefinition, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXMAiCommandRegistryCatalogDataSourceDefinition>;
+}
+declare class AXMAiQueryRegistryCatalogDataSourceDefinition implements AXPDataSourceDefinitionProvider {
+    private readonly entityService;
+    items(): Promise<AXPDataSourceDefinition[]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXMAiQueryRegistryCatalogDataSourceDefinition, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXMAiQueryRegistryCatalogDataSourceDefinition>;
+}
+
 /**
- * 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.
+ * Human-readable specialist prompt from delegated-agent tool arguments (conversation / mini-chat UI).
  */
-declare function axpAiReconcileSupervisorFinalAssistantWithDelegatedOutcomes(messages: AXPAiChatMessage[]): AXPAiChatMessage[];
-declare function axpAiPruneAssistantPiecesToFirstToolOnly(messages: AXPAiChatMessage[]): AXPAiChatMessage[];
-declare function axpAiChatDelegatedReflectionAssistantMessage(reflectionText: string): AXPAiChatMessage;
+declare function axpAiDelegatedAgentPromptPreview(argumentsValue: unknown): string;
+
+/** Prefix for supervisor-delegated specialist tools (`${AXPAI_SUPERVISOR_AGENT_TOOL_PREFIX}${agentId}`). */
+declare const AXPAI_SUPERVISOR_AGENT_TOOL_PREFIX: "agent:";
+declare function axpAiParseSupervisorAgentToolName(toolName: string): string | null;
+declare function axpAiChatTextMessage(role: AXPAiChatMessage['role'], text: string): AXPAiChatMessage;
+declare function axpAiChatUserMessage(responses: AXPAiChatResponse[]): AXPAiChatMessage;
+declare function axpAiChatMessageGetText(message: AXPAiChatMessage): string;
 declare function axpAiChatMessageIsDelegatedReflectionExcluded(message: AXPAiChatMessage): boolean;
+/** Reads typed specialist segments from a normalized {@code agent_result} payload. */
+declare function axpAiDelegatedAgentResultSegments(payload: {
+    success?: boolean;
+    data?: {
+        responses?: AXPAiDelegatedAgentResultSegment[];
+    };
+}): AXPAiDelegatedAgentResultSegment[];
+/** Plain text from specialist segments (text + think) for debug / preview UI. */
+declare function axpAiDelegatedAgentOutcomeResponsesPlainText(segments: AXPAiDelegatedAgentResultSegment[]): string;
+declare function axpAiChatToolResultBodyJson(message: AXPAiChatMessage): string;
+declare function axpAiChatToolOrAgentResultBodyJson(message: AXPAiChatMessage): string;
 
 /**
  * Strips HTML tags and decodes a few common entities for safe plain-text transcript lines.
@@ -989,6 +964,165 @@ declare function persistAiGeneratedSpeech(fileStorage: AXPFileStorageService, fi
     fileId: string;
 }>;
 
+/**
+ * Minimal JSON-Schema-like object for native provider hints and local validation.
+ * Aligns with shapes emitted by {@link inputOptionDefinitionsToJsonSchema} in connectivity mock support.
+ */
+interface AXPAiJsonSchemaLike {
+    type?: 'object' | 'array' | 'string' | 'number' | 'integer' | 'boolean' | 'null';
+    properties?: Record<string, AXPAiJsonSchemaLike>;
+    items?: AXPAiJsonSchemaLike | AXPAiJsonSchemaLike[];
+    required?: string[];
+    enum?: unknown[];
+    additionalProperties?: boolean | AXPAiJsonSchemaLike;
+    description?: string;
+    [key: string]: unknown;
+}
+/** Provider-native structured output hint (OpenAI `response_format`, Gemini `responseMimeType`). */
+type AXPAiResponseFormat = {
+    type: 'text';
+} | {
+    type: 'json_object';
+} | {
+    type: 'json_schema';
+    schema: AXPAiJsonSchemaLike;
+    name?: string;
+    strict?: boolean;
+};
+/** Default structured retry count for a contract kind when `structuredRetries` is omitted. */
+declare function defaultRetriesForKind(kind: AXPAiAgentOutputKind): number;
+declare function parseResponseFormat(raw: unknown): AXPAiResponseFormat | undefined;
+/**
+ * Maps an effective output contract to a provider request hint.
+ * Explicit {@link AXPAiAgentOutputContract.providerResponseFormat} wins; otherwise derived from `kind` + `schema`.
+ */
+declare function deriveProviderResponseFormat(contract: AXPAiAgentOutputContract): AXPAiResponseFormat | undefined;
+declare function parseJsonSchemaLike(raw: unknown): AXPAiJsonSchemaLike | undefined;
+
+interface ResolveEffectiveOutputContractInput {
+    /** Highest priority: per engine run (programmatic / automation). */
+    runtime?: AXPAiAgentOutputContract | null;
+    /** Assist `run` / `show` input. */
+    input?: AXPAiAgentOutputContract | null;
+    /** Active AiAgent catalog row. */
+    agent?: AXPAiAgentOutputContract | unknown | null;
+    /** Active Assist catalog row. */
+    assist?: AXPAiAgentOutputContract | unknown | null;
+}
+/**
+ * Resolves the effective output contract for one engine turn.
+ *
+ * Priority: runtime > input > agent > assist > `{ kind: 'string' }`.
+ */
+declare function resolveEffectiveOutputContract(params: ResolveEffectiveOutputContractInput): AXPAiAgentOutputContract;
+
+declare class AXPAiOutputContractResolveService {
+    private readonly segmentService;
+    /**
+     * Resolves a persisted agent/assist `outputContract` value (segment id string)
+     * or a full contract object (runtime / programmatic).
+     */
+    resolveFromPersisted(raw: unknown): Promise<AXPAiAgentOutputContract | null>;
+    /**
+     * Effective contract for one engine turn.
+     * Priority: runtime > input > agent > assist > `{ kind: 'string' }`.
+     */
+    resolveEffective(params: ResolveEffectiveOutputContractInput): Promise<AXPAiAgentOutputContract>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<AXPAiOutputContractResolveService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<AXPAiOutputContractResolveService>;
+}
+
+/**
+ * User follow-up appended to the transcript when structured JSON parse/validation fails.
+ *
+ * @param validationDetail - Parse or schema validation error text.
+ * @param schemaSummary - Optional expected shape (e.g. TypeScript-style) to improve retry quality.
+ * @param failurePhase - Parse failures get stronger anti-truncation wording; validator failures focus on schema/rules.
+ */
+declare function buildStructuredOutputRetryUserText(validationDetail: string, schemaSummary?: string, failurePhase?: 'parse' | 'validator'): string;
+
+type StructuredAssistantValidation = {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    errorMessage: string;
+    failurePhase: 'parse' | 'validator';
+};
+/**
+ * Parses JSON from assistant text (including lightweight local repair), then optionally runs a custom validator.
+ *
+ * @param textSegmentsFallback - When provided, each segment is tried after combined text (last segment first); helps when prose and JSON sit in separate assistant text blocks.
+ */
+declare function validateStructuredAssistantResponse(assistantPlainText: string, structuredValidator: AXPAiStructuredValidator | undefined, textSegmentsFallback?: readonly string[]): Promise<StructuredAssistantValidation>;
+
+interface ContractValidationError {
+    phase: 'parse' | 'validator';
+    message: string;
+    details?: unknown;
+}
+type ContractValidationResult = {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    errors: ContractValidationError[];
+};
+interface ValidateAgainstContractCommandExecutor {
+    execute(commandName: string, args: Record<string, unknown>): Promise<unknown>;
+}
+interface ValidateAgainstContractParams {
+    contract: AXPAiAgentOutputContract;
+    assistantPlainText: string;
+    textSegmentsFallback?: readonly string[];
+    structuredValidator?: AXPAiStructuredValidator;
+    commandExecutor?: ValidateAgainstContractCommandExecutor;
+    /**
+     * When the command returns `{ success, data: { valid, errors?, normalizedJson? } }` envelope shape.
+     */
+    parseCommandEnvelope?: (raw: unknown) => {
+        valid: boolean;
+        errorMessage?: string;
+        normalizedJson?: string;
+    };
+}
+/**
+ * Parses assistant text and validates against contract schema, registry command, and optional custom validator.
+ */
+declare function validateAgainstContract(params: ValidateAgainstContractParams): Promise<ContractValidationResult>;
+
+interface JsonSchemaMiniValidationError {
+    path: string;
+    message: string;
+}
+type JsonSchemaMiniValidationResult = {
+    ok: true;
+} | {
+    ok: false;
+    errors: JsonSchemaMiniValidationError[];
+};
+/**
+ * Validates a value against a minimal JSON Schema subset (types, required, enum, properties, items).
+ */
+declare function validateJsonSchemaMini(schema: AXPAiJsonSchemaLike, value: unknown): JsonSchemaMiniValidationResult;
+
+/**
+ * Text segments from the last assistant message (`type: 'text'` only).
+ * Omits `think` and `node` segments so JSON parsing is not polluted by widget envelopes or reasoning blocks stored separately.
+ */
+declare function extractLastAssistantTextSegments(messages: AXPAiChatMessage[]): string[];
+/**
+ * Combined text for structured JSON extraction (text segments only).
+ */
+declare function extractLastAssistantStructuredParts(messages: AXPAiChatMessage[]): {
+    combined: string;
+    segments: string[];
+};
+/**
+ * Concatenated plain text from the last assistant message in the transcript (includes `node` payloads like {@link axpAiChatMessageGetText}).
+ */
+declare function extractLastAssistantPlainText(messages: AXPAiChatMessage[]): string;
+
 /** Aligns with {@link AXPAiChatTransport} in ai-engine.types (avoid circular imports). */
 type AXMAiManagementModelChatTransport = 'openai' | 'gemini' | 'demis';
 type AXMAiManagementModelPurposeSlug = 'chat' | 'vision' | 'image' | 'speech' | 'tts';
@@ -1058,6 +1192,7 @@ declare abstract class AXPAiAssistService {
  */
 declare class AXPAiManagerService extends AXPAiAssistService {
     private readonly aiEngine;
+    private readonly outputContractResolve;
     private readonly entityService;
     private readonly settings;
     private readonly runtimeContextBuilder;
@@ -1075,6 +1210,10 @@ declare class AXPAiManagerService extends AXPAiAssistService {
      * Resolves the assist row for chat: explicit primary key, otherwise the effective default from settings.
      */
     getAssistForChat(assistId?: string | null): Promise<AXPAiEffectiveAssistRow>;
+    /**
+     * Primary catalog model transport for an assist (`modelId` row).
+     */
+    getAssistPrimaryChatTransport(assistId?: string | null): Promise<AXPAiChatTransport | undefined>;
     /**
      * Low-level engine run (chat streaming and tool orchestration).
      */
@@ -1221,5 +1360,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, 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 };
+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_OUTPUT_CONTRACT_TRANSCRIPT_SEGMENT_DATASOURCE_NAME, AI_QUERY_REGISTRY_CATALOG_DATASOURCE_NAME, AXMAiAgentCatalogDataSourceDefinition, AXMAiAssistPermissionKeys, AXMAiAssistPromptBoxComponent, AXMAiAssistPromptBoxService, AXMAiCommandRegistryCatalogDataSourceDefinition, AXMAiManagementEntityProvider, AXMAiManagementMenuProvider, AXMAiManagementModule, AXMAiModelCatalogDataSourceDefinition, AXMAiQueryRegistryCatalogDataSourceDefinition, AXMOutputContractTranscriptSegmentDataSourceDefinition, AXMPermissionDefinitionProvider, AXMPermissionsKeys, AXPAI_AGENT_OUTPUT_CONTRACT_DEFAULT_STRUCTURED_RETRIES, AXPAI_SUPERVISOR_AGENT_TOOL_PREFIX, AXPAiAssistChatModelCatalogService, AXPAiAssistDefaultMaxStructuredRetries, AXPAiAssistDefaultStructuredMaxTokens, AXPAiAssistService, AXPAiChatToolRunContextService, AXPAiDefaultModelPickerService, AXPAiEngine, AXPAiManagementMenuKeys, AXPAiManagementSettings, AXPAiManagerService, AXPAiOutputContractResolveService, AXPAiPlatformRuntimeContextBuilder, AXPAiStructuredOutputError, AiManagementManifest, RootConfig, axpAiAgentOutputContractOmitsRoleBaseline, axpAiAgentOutputContractStructuredRetryCap, axpAiAgentOutputContractUsesStructuredFinalize, axpAiAssistInitialMessagesToTranscript, axpAiAssistStarterPromptLabels, axpAiAssistStarterPromptTexts, axpAiChatMessageGetText, axpAiChatMessageIsDelegatedReflectionExcluded, axpAiChatTextMessage, axpAiChatToolOrAgentResultBodyJson, axpAiChatToolResultBodyJson, axpAiChatUserMessage, axpAiDelegatedAgentOutcomeResponsesPlainText, axpAiDelegatedAgentPromptPreview, axpAiDelegatedAgentResultSegments, axpAiParseSupervisorAgentToolName, axpAiStripAssistInitialHtmlToPlain, blobOrFileFromImageResult, buildStructuredOutputRetryUserText, defaultRetriesForKind, deriveProviderResponseFormat, extractLastAssistantPlainText, extractLastAssistantStructuredParts, extractLastAssistantTextSegments, getAiChatCommandLlmParametersOverride, isChatPurposeModelRow, isImagePurposeModelRow, isSpeechPurposeModelRow, isTtsPurposeModelRow, loadAssistPermissionRows, modelRowHasPurpose, parseAgentOutputContract, parseJsonSchemaLike, parseResponseFormat, persistAiChatAttachmentImage, persistAiGeneratedImage, persistAiGeneratedSpeech, readModelPurposes, resolveAgentOutputContract, resolveEffectiveOutputContract, resolveOutputTranscriptSegment, validateAgainstContract, validateJsonSchemaMini, validateStructuredAssistantResponse };
+export type { AXMAiAssistPermissionRow, AXMAiManagementAgentEntityModel, AXMAiManagementAssistEntityModel, AXMAiManagementAssistPlanningMode, AXMAiManagementModelChatTransport, AXMAiManagementModelEntityModel, AXMAiManagementModelPurposeSlug, AXMAiManagementOpenAiEndpointEntityModel, AXMAiManagementRuleEntityModel, AXMAiManagementRuleRef, AXMAiModelPurposeSlug, AXMOutputContractTranscriptSegmentDataSourceRow, AXPAiAgentOutputContract, AXPAiAgentOutputKind, AXPAiAssistCannotComplete, AXPAiAssistExecutionResult, AXPAiAssistPopupSize, AXPAiAssistPromptSubmitPayload, AXPAiAssistRunContext, AXPAiAssistRunInput, AXPAiAssistRunLoadingDialogSpec, AXPAiAssistRunResult, AXPAiAssistShowOptions, AXPAiAssistStructuredOutputAttemptRecord, AXPAiAssistStructuredOutputRunRaw, AXPAiAssistTokenUsageSnapshot, AXPAiAssistUserMediaAttachment, AXPAiAssistValidationError, AXPAiChatAgentAssistantResponse, AXPAiChatAgentResultResponse, AXPAiChatFileResponse, AXPAiChatFollowUpCommand, AXPAiChatFollowUpItem, AXPAiChatFollowUpResponse, AXPAiChatMessage, AXPAiChatModelListItem, AXPAiChatModelListRequest, AXPAiChatNodeResponse, AXPAiChatResponse, AXPAiChatTextResponse, AXPAiChatThinkResponse, AXPAiChatToolAssistantResponse, AXPAiChatToolInvocationContent, AXPAiChatToolResultResponse, AXPAiChatToolRunContext, AXPAiChatTransport, AXPAiDelegatedAgentResultPayload, AXPAiDelegatedAgentResultSegment, AXPAiDelegatedAgentTranscriptEntry, AXPAiDelegatedNestedToolCallContext, AXPAiEffectiveAgentRow, AXPAiEffectiveAssistRow, AXPAiEngineLastProviderPayload, AXPAiEngineRunEvent, AXPAiEngineRunOptions, AXPAiEngineRunResult, AXPAiEngineUsageTotals, AXPAiJsonSchemaLike$1 as AXPAiJsonSchemaLike, AXPAiOutputTranscriptSegment, AXPAiPlatformRuntimeContext, AXPAiResponseFormat$1 as AXPAiResponseFormat, AXPAiStructuredValidator, AXPAiToolCall, ResolveEffectiveOutputContractInput };