@acorex-platform/module-ai-management-client 0.0.28 → 0.0.32

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acorex-platform/module-ai-management-client",
-  "version": "0.0.28",
+  "version": "0.0.32",
   "sideEffects": false,
   "peerDependencies": {
     "@angular/common": "^21.0.0 || ^22.0.0",

package/types/acorex-platform-module-ai-management-client-contracts.d.ts

@@ -6,7 +6,7 @@ import { AXPEntityModel } from '@acorex-platform/framework-shared/entity';
  * `ManageCatalog` is Platform Console only (Intelligence config menu).
  */
 declare const AXPAiManagementFeatureKeys: {
-    /** Configuration → Intelligence (agents, assists, models, endpoints, rules). */
+    /** Configuration → Intelligence (agents, assists, models, endpoints, rules, skills). */
     readonly ManageCatalog: "AiManagement:Feature:ManageCatalog";
 };
 
@@ -27,6 +27,8 @@ declare const AXPAiManagementMenuKeys: {
     readonly Agents: "AiManagement:Menu:Agents";
     /** Reusable system-prompt rules (Markdown fragments). */
     readonly Rules: "AiManagement:Menu:Rules";
+    /** Playbooks (FLOWs) the Assist follows in the same turn. */
+    readonly Skills: "AiManagement:Menu:Skills";
 };
 
 /**
@@ -142,6 +144,13 @@ declare const RootConfig: {
             titlePlural: string;
             icon: string;
         };
+        skill: {
+            name: string;
+            fullName: string;
+            title: string;
+            titlePlural: string;
+            icon: string;
+        };
         mcpServer: {
             name: string;
             fullName: string;
@@ -205,6 +214,26 @@ interface AXMAiManagementAgentEntityModel extends AXPEntityModel<string> {
     maxSteps?: number;
 }
 
+/** Denormalized {@link AiSkill} snapshot on assist rows (multi-lookup expose). */
+interface AXMAiManagementSkillRef {
+    id: string;
+    /** Unique programmatic key used by the engine when listing attached Skills. */
+    name: string;
+    title: AXPMultiLanguageString;
+}
+/**
+ * Persisted AiSkill catalog row — playbooks (FLOWs) the Assist follows in the same turn.
+ */
+interface AXMAiManagementSkillEntityModel extends AXPEntityModel<string> {
+    /** Programmatic key (e.g. `create-entity-record`); referenced from assist `skills`. */
+    name: string;
+    title: AXPMultiLanguageString;
+    /** Trigger: when the Assist should follow this playbook (Cursor Skill `description`). */
+    description?: AXPMultiLanguageString;
+    /** Playbook body merged into the Assist system prompt when this Skill is attached. */
+    markdown: string;
+}
+
 /** Aligns with {@link AXPAiPlanningMode} in ai-engine.types (avoid circular imports). */
 type AXMAiManagementAssistPlanningMode = 'off' | 'once' | 'when-needed';
 /**
@@ -235,6 +264,10 @@ interface AXMAiManagementAssistEntityModel extends AXPEntityModel<string> {
     ruleIds?: string[] | null;
     /** Denormalized rule rows from multi-lookup expose (`title` = display, `name` = engine key). */
     rules?: AXMAiManagementRuleRef[] | null;
+    /** Selected {@link AiSkill} catalog ids (multi-lookup value field). */
+    skillIds?: string[] | null;
+    /** Denormalized skill rows from multi-lookup expose (`title` = display, `name` = engine key). */
+    skills?: AXMAiManagementSkillRef[] | null;
     /** Knowledge-base attachments (PDF and image formats) for this assist. */
     knowledgeFiles?: AXPFileListItem[] | null;
     /** Command registry bindings the assist may call directly in the same session. */
@@ -397,7 +430,6 @@ type AXPAiEffectiveAgentRow = Partial<Omit<AXMAiManagementAgentEntityModel, 'id'
 };
 interface AXPAiChatModelListRequest {
     assistId?: string | null;
-    directAgentId?: string | null;
 }
 interface AXPAiChatModelListItem {
     id: string;
@@ -575,9 +607,9 @@ type AXPAiEngineRunEvent = {
 };
 interface AXPAiEngineRunOptions {
     messages: AXPAiChatMessage[];
+    /** Catalog Assist id. When omitted, the platform/default Assist is used. */
     assistId?: string;
     demisSessionUuid?: string;
-    directAgentId?: string;
     modelEntityId?: string;
     modelId?: string;
     maxSteps?: number;
@@ -893,4 +925,4 @@ declare function axpAiChatMessagesFromProviderAssistant(text: string, toolCalls?
 declare function axcResolveAiMlOrPlainString(value: unknown, locale?: string): string;
 
 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, AXMAiAssistPermissionKeys, AXMAiManagementTransportKeys, AXMPermissionsKeys, AXM_AI_PLATFORM_RUNTIME_CONTEXT_DEFINITIONS, AXPAI_AGENT_OUTPUT_CONTRACT_DEFAULT_STRUCTURED_RETRIES, AXPAI_SUPERVISOR_AGENT_TOOL_PREFIX, AXPAdministrationPermissionKeys, AXPAiManagementFeatureKeys, AXPAiManagementMenuKeys, AXPAiManagementSettings, AXP_AI_SDK_TOOL_CONTEXT_JSON_SCHEMA, AXP_FOLLOW_UP_ENVELOPE_JSON_SCHEMA, AXP_WIDGET_NODE_JSON_SCHEMA, RootConfig, assembleAxpAiPlatformRuntimeContext, attachAxpAiSdkChatContext, axcResolveAiMlOrPlainString, axpAiAgentOutputContractOmitsRoleBaseline, axpAiAgentOutputContractStructuredRetryCap, axpAiAgentOutputContractUsesStructuredFinalize, axpAiChatMessageGetText, axpAiChatMessagesFromProviderAssistant, axpAiChatTextMessage, axpAiChatToolResultMessage, axpAiNormalizeHandlerResultToToolBody, axpAiParseSupervisorAgentToolName, axpAiShouldApplyChatStructuredOutput, axpAiSupervisorAgentToolName, axpAiTextDuplicatesStructuredSegment, axpAiTryParseJsonValueFromAssistantText, buildAxpAiSdkChatContextBundle, canAiExtractDocument, classifyAiExtractDocument, defaultRetriesForKind, deriveProviderResponseFormat, formatAxpAiPlatformRuntimeLocalDateTime, formatAxpAiPlatformRuntimePrompt, isChatPurposeModelRow, modelRowHasPurpose, parseAgentOutputContract, parseChatTransport, parseJsonSchemaLike, parseResponseFormat, readModelPurposes, resolveAgentOutputContract, resolveBuiltinSchemaForOutputContract, resolveEffectiveOutputContract, resolveOutputTranscriptSegment };
-export type { AXMAiManagementAgentEntityModel, AXMAiManagementAssistEntityModel, AXMAiManagementAssistPlanningMode, AXMAiManagementMcpServerEntityModel, AXMAiManagementMcpServerTransport, AXMAiManagementModelChatTransport, AXMAiManagementModelEntityModel, AXMAiManagementModelPurposeSlug, AXMAiManagementOpenAiEndpointEntityModel, AXMAiManagementRuleEntityModel, AXMAiManagementRuleRef, AXMAiModelPurposeSlug, AXPAiAgentOutputContract, AXPAiAgentOutputKind, AXPAiChatAgentAssistantResponse, AXPAiChatAgentResultResponse, AXPAiChatFileResponse, AXPAiChatFollowUpCommand, AXPAiChatFollowUpItem, AXPAiChatFollowUpResponse, AXPAiChatMessage, AXPAiChatModelListItem, AXPAiChatModelListRequest, AXPAiChatNodeResponse, AXPAiChatOptions, AXPAiChatOptionsDemis, AXPAiChatResponse, AXPAiChatResult, AXPAiChatStructuredOutputGate, AXPAiChatTextResponse, AXPAiChatThinkResponse, AXPAiChatToolAssistantResponse, AXPAiChatToolChoice, AXPAiChatToolInvocationContent, AXPAiChatToolResultResponse, AXPAiChatTransport, AXPAiDelegatedAgentResultPayload, AXPAiDelegatedAgentResultSegment, AXPAiDelegatedAgentTranscriptEntry, AXPAiDelegatedAgentTranscriptRunInput, AXPAiDelegatedNestedToolCallContext, AXPAiEffectiveAgentRow, AXPAiEffectiveAssistRow, AXPAiEngineLastProviderPayload, AXPAiEngineRunEvent, AXPAiEngineRunOptions, AXPAiEngineRunRequest, AXPAiEngineRunResult, AXPAiEngineUsageTotals, AXPAiEngineWireEvent, AXPAiExtractDocumentKind, AXPAiExtractDocumentTextOptions, AXPAiGenerateImageOptions, AXPAiGenerateVideoOptions, AXPAiJsonSchemaLike, AXPAiOutputTranscriptSegment, AXPAiPlatformRuntimeContext, AXPAiPlatformRuntimeContextSources, AXPAiResponseFormat, AXPAiSdkChatContextBundle, AXPAiSynthesizeSpeechOptions, AXPAiToolCall, AXPAiToolSchema, AXPAiTranscribeSpeechOptions, ResolveEffectiveOutputContractInput };
+export type { AXMAiManagementAgentEntityModel, AXMAiManagementAssistEntityModel, AXMAiManagementAssistPlanningMode, AXMAiManagementMcpServerEntityModel, AXMAiManagementMcpServerTransport, AXMAiManagementModelChatTransport, AXMAiManagementModelEntityModel, AXMAiManagementModelPurposeSlug, AXMAiManagementOpenAiEndpointEntityModel, AXMAiManagementRuleEntityModel, AXMAiManagementRuleRef, AXMAiManagementSkillEntityModel, AXMAiManagementSkillRef, AXMAiModelPurposeSlug, AXPAiAgentOutputContract, AXPAiAgentOutputKind, AXPAiChatAgentAssistantResponse, AXPAiChatAgentResultResponse, AXPAiChatFileResponse, AXPAiChatFollowUpCommand, AXPAiChatFollowUpItem, AXPAiChatFollowUpResponse, AXPAiChatMessage, AXPAiChatModelListItem, AXPAiChatModelListRequest, AXPAiChatNodeResponse, AXPAiChatOptions, AXPAiChatOptionsDemis, AXPAiChatResponse, AXPAiChatResult, AXPAiChatStructuredOutputGate, AXPAiChatTextResponse, AXPAiChatThinkResponse, AXPAiChatToolAssistantResponse, AXPAiChatToolChoice, AXPAiChatToolInvocationContent, AXPAiChatToolResultResponse, AXPAiChatTransport, AXPAiDelegatedAgentResultPayload, AXPAiDelegatedAgentResultSegment, AXPAiDelegatedAgentTranscriptEntry, AXPAiDelegatedAgentTranscriptRunInput, AXPAiDelegatedNestedToolCallContext, AXPAiEffectiveAgentRow, AXPAiEffectiveAssistRow, AXPAiEngineLastProviderPayload, AXPAiEngineRunEvent, AXPAiEngineRunOptions, AXPAiEngineRunRequest, AXPAiEngineRunResult, AXPAiEngineUsageTotals, AXPAiEngineWireEvent, AXPAiExtractDocumentKind, AXPAiExtractDocumentTextOptions, AXPAiGenerateImageOptions, AXPAiGenerateVideoOptions, AXPAiJsonSchemaLike, AXPAiOutputTranscriptSegment, AXPAiPlatformRuntimeContext, AXPAiPlatformRuntimeContextSources, AXPAiResponseFormat, AXPAiSdkChatContextBundle, AXPAiSynthesizeSpeechOptions, AXPAiToolCall, AXPAiToolSchema, AXPAiTranscribeSpeechOptions, ResolveEffectiveOutputContractInput };

package/types/acorex-platform-module-ai-management-client.d.ts

@@ -92,7 +92,6 @@ interface AXPAiAssistUserMediaAttachment {
 interface AXPAiAssistPromptSubmitPayload {
     prompt: string;
     assistId?: string;
-    directAgentId?: string;
     userMediaAttachments: AXPAiAssistUserMediaAttachment[];
 }
 /**
@@ -118,10 +117,9 @@ interface AXPAiAssistRunInput {
     userMediaAttachments?: AXPAiAssistUserMediaAttachment[];
     context?: AXPAiAssistRunContext;
     /**
-     * Catalog assist id. When omitted together with {@link directAgentId}, the platform default assist is used.
+     * Catalog assist id. When omitted, the platform default assist is used.
      */
     assistId?: string;
-    directAgentId?: string;
     maxSteps?: number;
     temperature?: number;
     /**
@@ -254,10 +252,9 @@ interface AXPAiAssistShowOptions {
     size?: AXPAiAssistPopupSize;
     context?: AXPAiAssistRunContext;
     /**
-     * Optional catalog assist. When omitted (and {@link directAgentId} is not set), the tenant/platform default assist applies.
+     * Optional catalog assist. When omitted, the tenant/platform default assist applies.
      */
     assistId?: string;
-    directAgentId?: string;
     maxSteps?: number;
     temperature?: number;
     maxTokens?: number;
@@ -624,7 +621,6 @@ declare class AXPAiManagerService extends AXPAiAssistService {
     private readonly loadingDialog;
     private readonly assistData;
     private readonly modelEntityData;
-    private readonly agentEntityData;
     /**
      * Loads the effective assist from `DefaultAssistId` (tenant setting), or the assist named `platform-assistant`.
      */
@@ -647,7 +643,7 @@ declare class AXPAiManagerService extends AXPAiAssistService {
      */
     private normalizeMaxOutputTokens;
     /**
-     * Reads {@link AXMAiModelMaxTokensRow.maxOutputTokens} for the model bound to the assist or direct agent.
+     * Reads {@link AXMAiModelMaxTokensRow.maxOutputTokens} for the model bound to the assist.
      */
     private resolveCatalogMaxOutputTokens;
     /** @inheritdoc */
@@ -740,7 +736,6 @@ declare class AXMAiAssistPromptBoxComponent implements OnInit, OnDestroy {
     readonly initialPrompt: i0.InputSignal<string>;
     readonly contentMaxWidthPx: i0.InputSignal<number>;
     readonly initialAssistId: i0.InputSignal<string | undefined>;
-    readonly initialDirectAgentId: i0.InputSignal<string | undefined>;
     readonly runPrompt: i0.InputSignal<(payload: AXPAiAssistPromptSubmitPayload) => Promise<AXPAiAssistRunResult>>;
     readonly requestClose: i0.InputSignal<(result: AXPAiAssistRunResult | null) => void>;
     readonly promptDraft: i0.WritableSignal<string>;
@@ -782,7 +777,7 @@ declare class AXMAiAssistPromptBoxComponent implements OnInit, OnDestroy {
     private processComposerDocumentFiles;
     private showUploadWarning;
     static ɵfac: i0.ɵɵFactoryDeclaration<AXMAiAssistPromptBoxComponent, never>;
-    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>;
+    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; }; "runPrompt": { "alias": "runPrompt"; "required": true; "isSignal": true; }; "requestClose": { "alias": "requestClose"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 /**