@memberjunction/core-actions 2.107.0 → 2.109.0

package/dist/custom/ai/find-best-action.action.d.ts

@@ -0,0 +1,53 @@
+import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
+import { BaseAction } from "@memberjunction/actions";
+/**
+ * Action that finds the best-matching actions for a given task using embedding-based semantic search.
+ *
+ * This action uses local embeddings to perform fast similarity search across all available actions,
+ * returning the most relevant actions based on their descriptions and capabilities.
+ *
+ * @example
+ * ```typescript
+ * // Find actions for a web search task
+ * await runAction({
+ *   ActionName: 'Find Best Action',
+ *   Params: [{
+ *     Name: 'TaskDescription',
+ *     Value: 'Search the internet for information on a topic'
+ *   }, {
+ *     Name: 'MaxResults',
+ *     Value: 5
+ *   }, {
+ *     Name: 'MinimumSimilarityScore',
+ *     Value: 0.6
+ *   }]
+ * });
+ * ```
+ */
+export declare class FindBestActionAction extends BaseAction {
+    /**
+     * Executes the Find Best Action action.
+     *
+     * @param params - The action parameters containing:
+     *   - TaskDescription: Description of the task to find actions for (required)
+     *   - MaxResults: Maximum number of actions to return (optional, default: 10)
+     *   - MinimumSimilarityScore: Minimum similarity score 0-1 (optional, default: 0.5)
+     *   - ExcludeAgentManagement: Exclude Agent Management actions (optional, default: true)
+     *
+     * @returns Action result with matched actions
+     */
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    /**
+     * Get boolean parameter with default
+     */
+    private getBooleanParam;
+    /**
+     * Get parameter value by name (case-insensitive)
+     */
+    private getParamValue;
+}
+/**
+ * Loader function to ensure the FindBestActionAction class is included in the bundle
+ */
+export declare function LoadFindBestActionAction(): void;
+//# sourceMappingURL=find-best-action.action.d.ts.map

package/dist/custom/ai/find-best-action.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-best-action.action.d.ts","sourceRoot":"","sources":["../../../src/custom/ai/find-best-action.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEnF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAKrD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBACa,oBAAqB,SAAQ,UAAU;IAChD;;;;;;;;;;OAUG;cACa,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAsJvF;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACH,OAAO,CAAC,aAAa;CAIxB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,SAEvC"}

package/dist/custom/ai/find-best-action.action.js

@@ -0,0 +1,211 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoadFindBestActionAction = exports.FindBestActionAction = void 0;
+const global_1 = require("@memberjunction/global");
+const actions_1 = require("@memberjunction/actions");
+const aiengine_1 = require("@memberjunction/aiengine");
+const core_1 = require("@memberjunction/core");
+/**
+ * Action that finds the best-matching actions for a given task using embedding-based semantic search.
+ *
+ * This action uses local embeddings to perform fast similarity search across all available actions,
+ * returning the most relevant actions based on their descriptions and capabilities.
+ *
+ * @example
+ * ```typescript
+ * // Find actions for a web search task
+ * await runAction({
+ *   ActionName: 'Find Best Action',
+ *   Params: [{
+ *     Name: 'TaskDescription',
+ *     Value: 'Search the internet for information on a topic'
+ *   }, {
+ *     Name: 'MaxResults',
+ *     Value: 5
+ *   }, {
+ *     Name: 'MinimumSimilarityScore',
+ *     Value: 0.6
+ *   }]
+ * });
+ * ```
+ */
+let FindBestActionAction = class FindBestActionAction extends actions_1.BaseAction {
+    /**
+     * Executes the Find Best Action action.
+     *
+     * @param params - The action parameters containing:
+     *   - TaskDescription: Description of the task to find actions for (required)
+     *   - MaxResults: Maximum number of actions to return (optional, default: 10)
+     *   - MinimumSimilarityScore: Minimum similarity score 0-1 (optional, default: 0.5)
+     *   - ExcludeAgentManagement: Exclude Agent Management actions (optional, default: true)
+     *
+     * @returns Action result with matched actions
+     */
+    async InternalRunAction(params) {
+        try {
+            // Extract and validate input parameters
+            const taskDescription = this.getParamValue(params, 'taskdescription');
+            const maxResults = parseInt(this.getParamValue(params, 'maxresults') || '10');
+            const minimumSimilarityScore = parseFloat(this.getParamValue(params, 'minimumsimilarityscore') || '0.5');
+            const excludeAgentManagement = this.getBooleanParam(params, 'excludeagentmanagement', true);
+            // Validate required input
+            if (!taskDescription || taskDescription.trim().length === 0) {
+                return {
+                    Success: false,
+                    ResultCode: 'INVALID_INPUT',
+                    Message: 'TaskDescription parameter is required and cannot be empty'
+                };
+            }
+            // Validate numeric ranges
+            if (maxResults < 1 || maxResults > 50) {
+                return {
+                    Success: false,
+                    ResultCode: 'INVALID_INPUT',
+                    Message: 'MaxResults must be between 1 and 50'
+                };
+            }
+            if (minimumSimilarityScore < 0 || minimumSimilarityScore > 1) {
+                return {
+                    Success: false,
+                    ResultCode: 'INVALID_INPUT',
+                    Message: 'MinimumSimilarityScore must be between 0 and 1'
+                };
+            }
+            // Validate contextUser is provided
+            if (!params.ContextUser) {
+                return {
+                    Success: false,
+                    ResultCode: 'MISSING_USER_CONTEXT',
+                    Message: 'User context required'
+                };
+            }
+            // Ensure AIEngine is loaded (embeddings computed during initialization)
+            await aiengine_1.AIEngine.Instance.Config(false, params.ContextUser);
+            // Find similar actions using AIEngine's built-in method - no database round trip!
+            const matchedActions = await aiengine_1.AIEngine.Instance.FindSimilarActions(taskDescription, maxResults * 2, // Get 2x results to account for filtering
+            minimumSimilarityScore);
+            // Filter out Agent Management actions if requested
+            let filteredActions = matchedActions;
+            if (excludeAgentManagement) {
+                filteredActions = matchedActions.filter(a => a.categoryName !== 'Agent Management');
+            }
+            // Limit to maxResults after filtering
+            filteredActions = filteredActions.slice(0, maxResults);
+            if (filteredActions.length === 0) {
+                return {
+                    Success: false,
+                    ResultCode: 'NO_ACTIONS_FOUND',
+                    Message: `No actions found matching the criteria (minimum similarity: ${minimumSimilarityScore}).`
+                };
+            }
+            // Load action parameters for all matched actions
+            const actionIds = filteredActions.map(a => a.actionId);
+            const rv = new core_1.RunView();
+            const paramsResult = await rv.RunView({
+                EntityName: 'Action Params',
+                ExtraFilter: `ActionID IN ('${actionIds.join("','")}')`,
+                OrderBy: 'ActionID, Name',
+                ResultType: 'entity_object'
+            }, params.ContextUser);
+            // Group parameters by action ID
+            const paramsByActionId = new Map();
+            if (paramsResult.Success && paramsResult.Results) {
+                for (const param of paramsResult.Results) {
+                    const actionId = param.ActionID;
+                    if (!paramsByActionId.has(actionId)) {
+                        paramsByActionId.set(actionId, []);
+                    }
+                    paramsByActionId.get(actionId).push(param);
+                }
+            }
+            // Build response with parameters included
+            const actionsWithParams = filteredActions.map(a => ({
+                actionId: a.actionId,
+                actionName: a.actionName,
+                similarityScore: Math.round(a.similarityScore * 100) / 100,
+                description: a.description,
+                categoryName: a.categoryName,
+                status: a.status,
+                driverClass: a.driverClass,
+                parameters: (paramsByActionId.get(a.actionId) || []).map(p => ({
+                    name: p.Name,
+                    type: p.Type, // Input/Output
+                    valueType: p.ValueType,
+                    isArray: p.IsArray,
+                    description: p.Description,
+                    isRequired: p.IsRequired,
+                    defaultValue: p.DefaultValue
+                }))
+            }));
+            // Add output parameters
+            params.Params.push({
+                Name: 'MatchedActions',
+                Type: 'Output',
+                Value: actionsWithParams
+            });
+            params.Params.push({
+                Name: 'MatchCount',
+                Type: 'Output',
+                Value: filteredActions.length
+            });
+            // Build response message with full descriptions and parameters
+            const responseData = {
+                message: `Found ${filteredActions.length} relevant action(s)`,
+                taskDescription: taskDescription,
+                matchCount: filteredActions.length,
+                allMatches: actionsWithParams
+            };
+            return {
+                Success: true,
+                ResultCode: 'SUCCESS',
+                Message: JSON.stringify(responseData, null, 2)
+            };
+        }
+        catch (error) {
+            return {
+                Success: false,
+                ResultCode: 'EXECUTION_ERROR',
+                Message: `Failed to find best action: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    /**
+     * Get boolean parameter with default
+     */
+    getBooleanParam(params, name, defaultValue) {
+        const value = this.getParamValue(params, name);
+        if (value === undefined || value === null)
+            return defaultValue;
+        if (typeof value === 'boolean')
+            return value;
+        if (typeof value === 'string') {
+            return value.toLowerCase() === 'true';
+        }
+        return defaultValue;
+    }
+    /**
+     * Get parameter value by name (case-insensitive)
+     */
+    getParamValue(params, name) {
+        const param = params.Params.find(p => p.Name.toLowerCase() === name.toLowerCase());
+        return param?.Value;
+    }
+};
+exports.FindBestActionAction = FindBestActionAction;
+exports.FindBestActionAction = FindBestActionAction = __decorate([
+    (0, global_1.RegisterClass)(actions_1.BaseAction, "Find Best Action")
+], FindBestActionAction);
+/**
+ * Loader function to ensure the FindBestActionAction class is included in the bundle
+ */
+function LoadFindBestActionAction() {
+    // Stub function to prevent tree shaking
+}
+exports.LoadFindBestActionAction = LoadFindBestActionAction;
+//# sourceMappingURL=find-best-action.action.js.map

package/dist/custom/ai/find-best-action.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-best-action.action.js","sourceRoot":"","sources":["../../../src/custom/ai/find-best-action.action.ts"],"names":[],"mappings":"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"}

package/dist/custom/ai/find-best-agent.action.d.ts

@@ -0,0 +1,53 @@
+import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
+import { BaseAction } from "@memberjunction/actions";
+/**
+ * Action that finds the best-matching AI agents for a given task using embedding-based semantic search.
+ *
+ * This action uses local embeddings to perform fast similarity search across all available agents,
+ * returning the most relevant agents based on their descriptions and capabilities.
+ *
+ * @example
+ * ```typescript
+ * // Find agents for a research task
+ * await runAction({
+ *   ActionName: 'Find Best Agent',
+ *   Params: [{
+ *     Name: 'TaskDescription',
+ *     Value: 'Research market trends and compile a comprehensive report'
+ *   }, {
+ *     Name: 'MaxResults',
+ *     Value: 5
+ *   }, {
+ *     Name: 'MinimumSimilarityScore',
+ *     Value: 0.7
+ *   }]
+ * });
+ * ```
+ */
+export declare class FindBestAgentAction extends BaseAction {
+    /**
+     * Executes the Find Best Agent action.
+     *
+     * @param params - The action parameters containing:
+     *   - TaskDescription: Description of the task to find agents for (required)
+     *   - MaxResults: Maximum number of agents to return (optional, default: 5)
+     *   - MinimumSimilarityScore: Minimum similarity score 0-1 (optional, default: 0.5)
+     *   - IncludeInactive: Include inactive agents (optional, default: false)
+     *
+     * @returns Action result with matched agents
+     */
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    /**
+     * Get boolean parameter with default
+     */
+    private getBooleanParam;
+    /**
+     * Get parameter value by name (case-insensitive)
+     */
+    private getParamValue;
+}
+/**
+ * Loader function to ensure the FindBestAgentAction class is included in the bundle
+ */
+export declare function LoadFindBestAgentAction(): void;
+//# sourceMappingURL=find-best-agent.action.d.ts.map

package/dist/custom/ai/find-best-agent.action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-best-agent.action.d.ts","sourceRoot":"","sources":["../../../src/custom/ai/find-best-agent.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEnF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAIrD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBACa,mBAAoB,SAAQ,UAAU;IAG/C;;;;;;;;;;OAUG;cACa,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAwIvF;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACH,OAAO,CAAC,aAAa;CAIxB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,SAEtC"}

package/dist/custom/ai/find-best-agent.action.js

@@ -0,0 +1,194 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoadFindBestAgentAction = exports.FindBestAgentAction = void 0;
+const global_1 = require("@memberjunction/global");
+const actions_1 = require("@memberjunction/actions");
+const aiengine_1 = require("@memberjunction/aiengine");
+const ai_engine_base_1 = require("@memberjunction/ai-engine-base");
+/**
+ * Action that finds the best-matching AI agents for a given task using embedding-based semantic search.
+ *
+ * This action uses local embeddings to perform fast similarity search across all available agents,
+ * returning the most relevant agents based on their descriptions and capabilities.
+ *
+ * @example
+ * ```typescript
+ * // Find agents for a research task
+ * await runAction({
+ *   ActionName: 'Find Best Agent',
+ *   Params: [{
+ *     Name: 'TaskDescription',
+ *     Value: 'Research market trends and compile a comprehensive report'
+ *   }, {
+ *     Name: 'MaxResults',
+ *     Value: 5
+ *   }, {
+ *     Name: 'MinimumSimilarityScore',
+ *     Value: 0.7
+ *   }]
+ * });
+ * ```
+ */
+let FindBestAgentAction = class FindBestAgentAction extends actions_1.BaseAction {
+    // Singleton initialization removed - AIEngine handles embedding lifecycle
+    /**
+     * Executes the Find Best Agent action.
+     *
+     * @param params - The action parameters containing:
+     *   - TaskDescription: Description of the task to find agents for (required)
+     *   - MaxResults: Maximum number of agents to return (optional, default: 5)
+     *   - MinimumSimilarityScore: Minimum similarity score 0-1 (optional, default: 0.5)
+     *   - IncludeInactive: Include inactive agents (optional, default: false)
+     *
+     * @returns Action result with matched agents
+     */
+    async InternalRunAction(params) {
+        try {
+            // Extract and validate input parameters
+            const taskDescription = this.getParamValue(params, 'taskdescription');
+            const maxResults = parseInt(this.getParamValue(params, 'maxresults') || '5');
+            const minimumSimilarityScore = parseFloat(this.getParamValue(params, 'minimumsimilarityscore') || '0.5');
+            const includeInactive = this.getBooleanParam(params, 'includeinactive', false);
+            // Validate required input
+            if (!taskDescription || taskDescription.trim().length === 0) {
+                return {
+                    Success: false,
+                    ResultCode: 'INVALID_INPUT',
+                    Message: 'TaskDescription parameter is required and cannot be empty'
+                };
+            }
+            // Validate numeric ranges
+            if (maxResults < 1 || maxResults > 20) {
+                return {
+                    Success: false,
+                    ResultCode: 'INVALID_INPUT',
+                    Message: 'MaxResults must be between 1 and 20'
+                };
+            }
+            if (minimumSimilarityScore < 0 || minimumSimilarityScore > 1) {
+                return {
+                    Success: false,
+                    ResultCode: 'INVALID_INPUT',
+                    Message: 'MinimumSimilarityScore must be between 0 and 1'
+                };
+            }
+            // Validate contextUser is provided for permission filtering
+            if (!params.ContextUser) {
+                return {
+                    Success: false,
+                    ResultCode: 'MISSING_USER_CONTEXT',
+                    Message: 'User context required for permission filtering'
+                };
+            }
+            // Ensure AIEngine is loaded (embeddings computed during initialization)
+            await aiengine_1.AIEngine.Instance.Config(false, params.ContextUser);
+            // Find similar agents using AIEngine's built-in method - no database round trip!
+            const matchedAgents = await aiengine_1.AIEngine.Instance.FindSimilarAgents(taskDescription, maxResults * 3, // Get 3x results to account for filtering
+            minimumSimilarityScore);
+            // Filter by user permissions - user must have 'run' permission
+            const accessibleAgents = await ai_engine_base_1.AIAgentPermissionHelper.GetAccessibleAgents(params.ContextUser, 'run');
+            const accessibleAgentIds = new Set(accessibleAgents.map(a => a.ID));
+            // Filter matched agents by permissions
+            let permissionFilteredAgents = matchedAgents.filter(a => accessibleAgentIds.has(a.agentId));
+            // Filter by status if not including inactive
+            if (!includeInactive) {
+                permissionFilteredAgents = permissionFilteredAgents.filter(a => a.status === 'Active');
+            }
+            // Filter by invocation mode - exclude Sub-Agent agents (only show Any or Top-Level)
+            // Sub-Agents are meant to be called by other agents, not discovered by users/tools
+            const invocationFilteredAgents = permissionFilteredAgents.filter(a => a.invocationMode !== 'Sub-Agent');
+            // Limit to maxResults after all filtering
+            const filteredAgents = invocationFilteredAgents.slice(0, maxResults);
+            if (filteredAgents.length === 0) {
+                return {
+                    Success: false,
+                    ResultCode: 'NO_AGENTS_FOUND',
+                    Message: `No accessible agents found matching the criteria (minimum similarity: ${minimumSimilarityScore}). You may not have permission to run the matching agents.`
+                };
+            }
+            // AIEngine already loaded above - use it to get agent actions
+            // Create map of agentId -> action names
+            const agentActionsMap = new Map();
+            for (const agent of filteredAgents) {
+                const agentActions = aiengine_1.AIEngine.Instance.AgentActions
+                    .filter(aa => aa.AgentID === agent.agentId && aa.Status === 'Active')
+                    .map(aa => aa.Action); // Get action name
+                agentActionsMap.set(agent.agentId, agentActions);
+            }
+            // Add output parameters
+            params.Params.push({
+                Name: 'MatchedAgents',
+                Type: 'Output',
+                Value: filteredAgents
+            });
+            params.Params.push({
+                Name: 'MatchCount',
+                Type: 'Output',
+                Value: filteredAgents.length
+            });
+            // Build response message with full descriptions and actions
+            const responseData = {
+                message: `Found ${filteredAgents.length} accessible agent(s)`,
+                taskDescription: taskDescription,
+                matchCount: filteredAgents.length,
+                allMatches: filteredAgents.map(a => ({
+                    agentName: a.agentName,
+                    similarityScore: Math.round(a.similarityScore * 100) / 100, // Round to 2 decimal places
+                    description: a.description, // Full description, no truncation
+                    actions: agentActionsMap.get(a.agentId) || []
+                }))
+            };
+            return {
+                Success: true,
+                ResultCode: 'SUCCESS',
+                Message: JSON.stringify(responseData, null, 2)
+            };
+        }
+        catch (error) {
+            return {
+                Success: false,
+                ResultCode: 'EXECUTION_ERROR',
+                Message: `Failed to find best agent: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    /**
+     * Get boolean parameter with default
+     */
+    getBooleanParam(params, name, defaultValue) {
+        const value = this.getParamValue(params, name);
+        if (value === undefined || value === null)
+            return defaultValue;
+        if (typeof value === 'boolean')
+            return value;
+        if (typeof value === 'string') {
+            return value.toLowerCase() === 'true';
+        }
+        return defaultValue;
+    }
+    /**
+     * Get parameter value by name (case-insensitive)
+     */
+    getParamValue(params, name) {
+        const param = params.Params.find(p => p.Name.toLowerCase() === name.toLowerCase());
+        return param?.Value;
+    }
+};
+exports.FindBestAgentAction = FindBestAgentAction;
+exports.FindBestAgentAction = FindBestAgentAction = __decorate([
+    (0, global_1.RegisterClass)(actions_1.BaseAction, "Find Best Agent")
+], FindBestAgentAction);
+/**
+ * Loader function to ensure the FindBestAgentAction class is included in the bundle
+ */
+function LoadFindBestAgentAction() {
+    // Stub function to prevent tree shaking
+}
+exports.LoadFindBestAgentAction = LoadFindBestAgentAction;
+//# sourceMappingURL=find-best-agent.action.js.map

package/dist/custom/ai/find-best-agent.action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-best-agent.action.js","sourceRoot":"","sources":["../../../src/custom/ai/find-best-agent.action.ts"],"names":[],"mappings":"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"}

package/dist/custom/ai/summarize-content.action.d.ts

@@ -52,13 +52,13 @@ export declare class SummarizeContentAction extends BaseAction {
      */
     private fetchWebPageContent;
     /**
-     * Generate summary using LLM via the Execute AI Prompt action
+     * Generate summary using AI Prompts package directly
      */
     private generateSummary;
     /**
-     * Execute another action by name
+     * Get prompt by name and category from AIEngine
      */
-    private executeAction;
+    private getPromptByNameAndCategory;
     private getStringParam;
     private getNumericParam;
     private getBooleanParam;

package/dist/custom/ai/summarize-content.action.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"summarize-content.action.d.ts","sourceRoot":"","sources":["../../../src/custom/ai/summarize-content.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAe,MAAM,8BAA8B,CAAC;AAChG,OAAO,EAAE,UAAU,EAAsB,MAAM,yBAAyB,CAAC;AAuBzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,qBACa,sBAAuB,SAAQ,UAAU;cAElC,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA6FvF;;OAEG;YACW,mBAAmB;IAoCjC;;OAEG;YACW,eAAe;IA2H7B;;OAEG;YACW,aAAa;IA4C3B,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,iBAAiB;CAO5B;AAED;;GAEG;AACH,wBAAgB,0BAA0B,SAEzC"}
+{"version":3,"file":"summarize-content.action.d.ts","sourceRoot":"","sources":["../../../src/custom/ai/summarize-content.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAiC,MAAM,8BAA8B,CAAC;AAClH,OAAO,EAAE,UAAU,EAAsB,MAAM,yBAAyB,CAAC;AA2BzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,qBACa,sBAAuB,SAAQ,UAAU;cAElC,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA6FvF;;OAEG;YACW,mBAAmB;IAqDjC;;OAEG;YACW,eAAe;IAiE7B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAOlC,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,iBAAiB;CAO5B;AAED;;GAEG;AACH,wBAAgB,0BAA0B,SAEzC"}