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

package/organization-management/README.md

@@ -9,6 +9,10 @@ Key capabilities:
 - Connectivity mocks and seeders for demo data
 - i18n resources for EN/FA
 
+## Org chart node contributions
+
+Types and `AXM_ORG_CHART_NODE_CONTRIBUTOR` live in this package (`org-chart-node-contribution.token.ts`, `organization-chart.types.ts`, re-exported via `org-chart.type.ts`). Optional integrations that combine org chart with other domains (for example **chat from the org chart**) should live in `@acorex/extensions/conversation/org-chart` so core modules avoid mutual dependencies.
+
 ## Entities
 
 ### BusinessUnitType
@@ -38,7 +42,7 @@ Fields:
 
 ### Position
 
-Standard position catalog with category support. Includes `isManager` and optional `reportsToPositionId` (reports-to position in the catalog).
+Standard position catalog with category support. Includes `isManager`. Line management uses business unit heads and BU hierarchy, not a position-to-parent field on the catalog.
 
 ### Chart
 

package/package.json

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

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

@@ -160,6 +160,23 @@ declare class AXMAiAgentCatalogDataSourceDefinition implements AXPDataSourceDefi
     static ɵprov: _angular_core.ɵɵ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: _angular_core.ɵɵFactoryDeclaration<AXMAiCommandRegistryCatalogDataSourceDefinition, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXMAiCommandRegistryCatalogDataSourceDefinition>;
+}
+declare class AXMAiQueryRegistryCatalogDataSourceDefinition implements AXPDataSourceDefinitionProvider {
+    private readonly entityService;
+    items(): Promise<AXPDataSourceDefinition[]>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMAiQueryRegistryCatalogDataSourceDefinition, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXMAiQueryRegistryCatalogDataSourceDefinition>;
+}
+
 /**
  * Human-readable specialist prompt from delegated-agent tool arguments (conversation / mini-chat UI).
  */
@@ -249,12 +266,14 @@ interface AXPAiEffectiveAssistRow {
     imageModelId?: string;
     initialMessages?: string | null;
     /**
-     * Agents this assist may delegate to: each item has `type` = AiAgent catalog id
+     * 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?: {
-        type?: string;
-        options?: Record<string, unknown>;
+        agent: {
+            type?: string;
+            options?: Record<string, unknown>;
+        };
     }[] | null;
 }
 /** Effective AiAgent catalog row (registry scope + optional supervisor JSON schema). */
@@ -265,7 +284,15 @@ interface AXPAiEffectiveAgentRow {
     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). */
@@ -289,6 +316,11 @@ 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. */
+interface AXPAiChatThinkResponse {
+    type: 'think';
+    content: string;
+}
 interface AXPAiChatImageResponse {
     type: 'image';
     content: {
@@ -345,7 +377,7 @@ interface AXPAiChatAgentResultResponse {
     name?: string;
     content: AXPAiDelegatedAgentResultPayload;
 }
-type AXPAiChatResponse = AXPAiChatTextResponse | AXPAiChatImageResponse | AXPAiChatAudioResponse | AXPAiChatNodeResponse | AXPAiChatToolAssistantResponse | AXPAiChatAgentAssistantResponse | AXPAiChatToolResultResponse | AXPAiChatAgentResultResponse;
+type AXPAiChatResponse = AXPAiChatTextResponse | AXPAiChatThinkResponse | AXPAiChatImageResponse | AXPAiChatAudioResponse | 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.
@@ -370,7 +402,9 @@ interface AXPAiToolSchema {
 }
 /** 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;
 }
 /**
@@ -398,6 +432,43 @@ interface AXPAiDelegatedNestedToolCallContext {
     agentId: string;
     agentName?: string;
 }
+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.
+     */
+    segment?: 'text' | 'think';
+} | {
+    type: 'tool_call_start';
+    call: AXPAiToolCall;
+} | {
+    type: 'tool_call_end';
+    call: AXPAiToolCall;
+    resultMessage: AXPAiChatMessage;
+} | {
+    type: 'delegated_agent_nested_tool_call_start';
+    ctx: AXPAiDelegatedNestedToolCallContext;
+    call: AXPAiToolCall;
+} | {
+    type: 'delegated_agent_nested_tool_call_end';
+    ctx: AXPAiDelegatedNestedToolCallContext;
+    call: AXPAiToolCall;
+    resultMessage: AXPAiChatMessage;
+} | {
+    type: 'delegated_agent_nested_stream_reset';
+    ctx: AXPAiDelegatedNestedToolCallContext;
+} | {
+    type: 'delegated_agent_nested_stream_delta';
+    ctx: AXPAiDelegatedNestedToolCallContext;
+    delta: string;
+} | {
+    type: 'delegated_agent_reflection_phase';
+    active: boolean;
+};
 interface AXPAiEngineRunOptions {
     messages: AXPAiChatMessage[];
     assistId?: string;
@@ -412,15 +483,7 @@ interface AXPAiEngineRunOptions {
     /** Overrides assist-stored planning for this run (UI / tests). */
     planningMode?: AXPAiPlanningMode;
     platformRuntimeContext?: AXPAiPlatformRuntimeContext | null;
-    onAssistantStreamReset?: () => void;
-    onAssistantStreamDelta?: (delta: string) => void;
-    onToolCallStart?: (call: AXPAiToolCall) => void;
-    onToolCallEnd?: (call: AXPAiToolCall, resultMessage: AXPAiChatMessage) => void;
-    onDelegatedAgentNestedToolCallStart?: (ctx: AXPAiDelegatedNestedToolCallContext, call: AXPAiToolCall) => void;
-    onDelegatedAgentNestedToolCallEnd?: (ctx: AXPAiDelegatedNestedToolCallContext, call: AXPAiToolCall, resultMessage: AXPAiChatMessage) => void;
-    onDelegatedAgentNestedStreamReset?: (ctx: AXPAiDelegatedNestedToolCallContext) => void;
-    onDelegatedAgentNestedStreamDelta?: (ctx: AXPAiDelegatedNestedToolCallContext, delta: string) => void;
-    onDelegatedAgentReflectionPhase?: (active: boolean) => void;
+    onRunEvent?: (event: AXPAiEngineRunEvent) => void;
 }
 interface AXPAiEngineRunResult {
     messages: AXPAiChatMessage[];
@@ -449,6 +512,12 @@ type AXPAiChatAgentResultBody = AXPAiDelegatedAgentResultPayload;
 declare function axpAiChatTextMessage(role: AXPAiChatMessage['role'], text: string): AXPAiChatMessage;
 declare function axpAiChatUserMessage(responses: AXPAiChatResponse[]): AXPAiChatMessage;
 declare function axpAiChatMessageGetText(message: AXPAiChatMessage): string;
+/**
+ * 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.
+ */
+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;
@@ -708,8 +777,12 @@ declare class AXMAiChatPageComponent extends AXPPageLayoutBaseComponent implemen
      * Specialist sub-run transcripts keyed by supervisor tool_call id (merged from each {@link AXPAiManagerService.run} result).
      */
     readonly delegatedTranscriptsByCallId: _angular_core.WritableSignal<Record<string, AXPAiDelegatedAgentTranscriptEntry>>;
-    /** Incremental assistant text while the provider streams (OpenAI SSE). */
+    /** Incremental assistant text while the provider streams (OpenAI SSE); main turn only. */
     readonly streamingAssistantPreview: _angular_core.WritableSignal<string>;
+    /**
+     * Incremental planning/reasoning text while the planning turn streams; see {@link AXPAiEngineRunEvent} `segment: 'think'`.
+     */
+    readonly streamingThinkPreview: _angular_core.WritableSignal<string>;
     /**
      * Incremental assistant text streamed inside a delegated `agent:*` sub-run, keyed by supervisor tool_call id.
      * Kept separate from {@link streamingAssistantPreview} so specialist text stays in the delegation collapse.
@@ -764,6 +837,7 @@ declare class AXMAiChatPageComponent extends AXPPageLayoutBaseComponent implemen
      * Parses assistant text: &lt;redacted_thinking&gt; for collapsible UI, remaining body for the main reply.
      */
     parseAssistantMessageForDisplay(raw: string | null | undefined): AssistantParsedContent;
+    protected parseAssistantMessageForDisplayFromMessage(message: AXPAiChatMessage): AssistantParsedContent;
     /**
      * True when the tool name is a supervisor delegated agent (`agent:<catalogId>`).
      */
@@ -793,6 +867,7 @@ declare class AXMAiChatPageComponent extends AXPPageLayoutBaseComponent implemen
      * Concatenates preamble assistant text lines for a tool-turn header block.
      */
     protected toolTurnPreamblePlain(item: AXMAiChatToolTurnItem): string;
+    protected toolTurnPreambleParsed(item: AXMAiChatToolTurnItem): AssistantParsedContent;
     /**
      * Layout node for assistant `node` responses when the payload matches {@link AXPWidgetNode}.
      */
@@ -1013,5 +1088,5 @@ 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_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, AXMAiAgentCatalogDataSourceDefinition, AXMAiChatPageComponent, AXMAiChatToolExecuteService, AXMAiManagementEntityProvider, AXMAiManagementMenuProvider, AXMAiManagementModule, AXMAiModelCatalogDataSourceDefinition, 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, 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, AXPAiChatToolAssistantResponse, AXPAiChatToolInvocationContent, AXPAiChatToolResultBody, AXPAiChatToolResultResponse, AXPAiChatToolRunContext, AXPAiChatTransport, AXPAiDelegatedAgentResultPayload, AXPAiDelegatedAgentTranscriptEntry, AXPAiDelegatedNestedToolCallContext, AXPAiDelegatedParameterBinding, AXPAiDelegatedParameterDefinition, AXPAiEffectiveAgentRow, AXPAiEffectiveAssistRow, AXPAiEngineLastProviderPayload, AXPAiEngineRegistryToolFields, AXPAiEngineRunOptions, AXPAiEngineRunResult, AXPAiEngineUsageTotals, AXPAiExtractDocumentTextFromStoredFileRequest, AXPAiPlanningMode, AXPAiPlatformRuntimeContext, AXPAiStructuredTextCompletionOptions, AXPAiToolCall, AXPAiToolSchema };
+export { AIMANAGEMENT_CHAT_GENERATE_IMAGE_COMMAND_KEY, AIMANAGEMENT_CHAT_SYNTHESIZE_SPEECH_COMMAND_KEY, AIMANAGEMENT_CHAT_TRANSCRIBE_SPEECH_COMMAND_KEY, AIMANAGEMENT_EXTRACT_DOCUMENT_TEXT_COMMAND_KEY, AIMANAGEMENT_STRUCTURED_TEXT_COMPLETION_COMMAND_KEY, AI_AGENT_CATALOG_DATASOURCE_NAME, AI_CHAT_ATTACHMENT_CATEGORY, AI_CHAT_ATTACHMENT_REF_TYPE, AI_CHAT_GENERATED_IMAGE_REF_TYPE, AI_CHAT_GENERATED_SPEECH_REF_TYPE, AI_COMMAND_REGISTRY_CATALOG_DATASOURCE_NAME, AI_GENERATED_IMAGE_MAX_REMOTE_URL_IN_TOOL, AI_MODEL_CATALOG_DATASOURCE_NAME, AI_MODEL_IMAGE_CATALOG_DATASOURCE_NAME, AI_MODEL_SPEECH_CATALOG_DATASOURCE_NAME, AI_MODEL_TTS_CATALOG_DATASOURCE_NAME, AI_QUERY_REGISTRY_CATALOG_DATASOURCE_NAME, AXMAiAgentCatalogDataSourceDefinition, 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 };