@memberjunction/core-actions 2.106.0 → 2.108.0

package/dist/config.d.ts

@@ -16,12 +16,62 @@ declare const apiIntegrationsSchema: z.ZodObject<{
      * API keys follow format: sk-gamma-xxxxxxxx
      */
     gammaApiKey: z.ZodOptional<z.ZodString>;
+    /**
+     * Google services configuration (nested structure)
+     * Follows MJStorage pattern for better organization and scalability
+     */
+    google: z.ZodOptional<z.ZodObject<{
+        /**
+         * Google Custom Search configuration
+         * Used by: Google Custom Search action
+         * Get your API key from: https://developers.google.com/custom-search/v1/overview
+         * Get your CX from: https://programmablesearchengine.google.com/
+         */
+        customSearch: z.ZodOptional<z.ZodObject<{
+            /**
+             * Google Custom Search API key
+             */
+            apiKey: z.ZodOptional<z.ZodString>;
+            /**
+             * Google Custom Search engine identifier (CX)
+             */
+            cx: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            apiKey?: string;
+            cx?: string;
+        }, {
+            apiKey?: string;
+            cx?: string;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        customSearch?: {
+            apiKey?: string;
+            cx?: string;
+        };
+    }, {
+        customSearch?: {
+            apiKey?: string;
+            cx?: string;
+        };
+    }>>;
 }, "strip", z.ZodTypeAny, {
     perplexityApiKey?: string;
     gammaApiKey?: string;
+    google?: {
+        customSearch?: {
+            apiKey?: string;
+            cx?: string;
+        };
+    };
 }, {
     perplexityApiKey?: string;
     gammaApiKey?: string;
+    google?: {
+        customSearch?: {
+            apiKey?: string;
+            cx?: string;
+        };
+    };
 }>;
 /**
  * Complete configuration schema for Core Actions package
@@ -44,22 +94,84 @@ declare const coreActionsConfigSchema: z.ZodObject<{
          * API keys follow format: sk-gamma-xxxxxxxx
          */
         gammaApiKey: z.ZodOptional<z.ZodString>;
+        /**
+         * Google services configuration (nested structure)
+         * Follows MJStorage pattern for better organization and scalability
+         */
+        google: z.ZodOptional<z.ZodObject<{
+            /**
+             * Google Custom Search configuration
+             * Used by: Google Custom Search action
+             * Get your API key from: https://developers.google.com/custom-search/v1/overview
+             * Get your CX from: https://programmablesearchengine.google.com/
+             */
+            customSearch: z.ZodOptional<z.ZodObject<{
+                /**
+                 * Google Custom Search API key
+                 */
+                apiKey: z.ZodOptional<z.ZodString>;
+                /**
+                 * Google Custom Search engine identifier (CX)
+                 */
+                cx: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                apiKey?: string;
+                cx?: string;
+            }, {
+                apiKey?: string;
+                cx?: string;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            customSearch?: {
+                apiKey?: string;
+                cx?: string;
+            };
+        }, {
+            customSearch?: {
+                apiKey?: string;
+                cx?: string;
+            };
+        }>>;
     }, "strip", z.ZodTypeAny, {
         perplexityApiKey?: string;
         gammaApiKey?: string;
+        google?: {
+            customSearch?: {
+                apiKey?: string;
+                cx?: string;
+            };
+        };
     }, {
         perplexityApiKey?: string;
         gammaApiKey?: string;
+        google?: {
+            customSearch?: {
+                apiKey?: string;
+                cx?: string;
+            };
+        };
     }>>>;
 }, "strip", z.ZodTypeAny, {
     apiIntegrations?: {
         perplexityApiKey?: string;
         gammaApiKey?: string;
+        google?: {
+            customSearch?: {
+                apiKey?: string;
+                cx?: string;
+            };
+        };
     };
 }, {
     apiIntegrations?: {
         perplexityApiKey?: string;
         gammaApiKey?: string;
+        google?: {
+            customSearch?: {
+                apiKey?: string;
+                cx?: string;
+            };
+        };
     };
 }>;
 export type CoreActionsConfig = z.infer<typeof coreActionsConfigSchema>;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;GAEG;AACH,QAAA,MAAM,qBAAqB;IACzB;;;;OAIG;;IAGH;;;;;OAKG;;;;;;;;EAEH,CAAC;AAEH;;GAEG;AACH,QAAA,MAAM,uBAAuB;IAC3B;;OAEG;;QAtBH;;;;WAIG;;QAGH;;;;;WAKG;;;;;;;;;;;;;;;;;;;EAYH,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAI1E;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,CA2BxD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,qBAAqB,CAGhE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;GAEG;AACH,QAAA,MAAM,qBAAqB;IACzB;;;;OAIG;;IAGH;;;;;OAKG;;IAGH;;;OAGG;;QAED;;;;;WAKG;;YAED;;eAEG;;YAEH;;eAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIP,CAAC;AAEH;;GAEG;AACH,QAAA,MAAM,uBAAuB;IAC3B;;OAEG;;QA7CH;;;;WAIG;;QAGH;;;;;WAKG;;QAGH;;;WAGG;;YAED;;;;;eAKG;;gBAED;;mBAEG;;gBAEH;;mBAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAcP,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAI1E;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,CAqCxD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,qBAAqB,CAGhE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/config.js

@@ -22,6 +22,28 @@ const apiIntegrationsSchema = zod_1.z.object({
      * API keys follow format: sk-gamma-xxxxxxxx
      */
     gammaApiKey: zod_1.z.string().optional(),
+    /**
+     * Google services configuration (nested structure)
+     * Follows MJStorage pattern for better organization and scalability
+     */
+    google: zod_1.z.object({
+        /**
+         * Google Custom Search configuration
+         * Used by: Google Custom Search action
+         * Get your API key from: https://developers.google.com/custom-search/v1/overview
+         * Get your CX from: https://programmablesearchengine.google.com/
+         */
+        customSearch: zod_1.z.object({
+            /**
+             * Google Custom Search API key
+             */
+            apiKey: zod_1.z.string().optional(),
+            /**
+             * Google Custom Search engine identifier (CX)
+             */
+            cx: zod_1.z.string().optional(),
+        }).optional(),
+    }).optional(),
 });
 /**
  * Complete configuration schema for Core Actions package
@@ -51,8 +73,18 @@ function getCoreActionsConfig() {
         // Extract only the fields relevant to Core Actions
         const rawConfig = {
             apiIntegrations: {
-                perplexityApiKey: result.config.perplexityApiKey || process.env.PERPLEXITY_API_KEY,
-                gammaApiKey: result.config.gammaApiKey || process.env.GAMMA_API_KEY,
+                perplexityApiKey: result.config?.perplexityApiKey || process.env.PERPLEXITY_API_KEY,
+                gammaApiKey: result.config?.gammaApiKey || process.env.GAMMA_API_KEY,
+                google: {
+                    customSearch: {
+                        apiKey: result.config?.google?.customSearch?.apiKey ||
+                            result.config?.googleCustomSearchApiKey || // Backwards compatibility
+                            process.env.GOOGLE_CUSTOM_SEARCH_API_KEY,
+                        cx: result.config?.google?.customSearch?.cx ||
+                            result.config?.googleCustomSearchCx || // Backwards compatibility
+                            process.env.GOOGLE_CUSTOM_SEARCH_CX,
+                    },
+                },
             },
         };
         _config = coreActionsConfigSchema.parse(rawConfig);

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,6CAA8C;AAC9C,+CAA2D;AAE3D,MAAM,QAAQ,GAAG,IAAA,6BAAe,EAAC,IAAI,EAAE,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC,CAAC;AAErE;;GAEG;AACH,MAAM,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IACrC;;;;OAIG;IACH,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEvC;;;;;OAKG;IACH,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,uBAAuB,GAAG,OAAC,CAAC,MAAM,CAAC;IACvC;;OAEG;IACH,eAAe,EAAE,qBAAqB,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CAC9D,CAAC,CAAC;AAKH,IAAI,OAAO,GAA6B,IAAI,CAAC;AAE7C;;;GAGG;AACH,SAAgB,oBAAoB;IAClC,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;QACjC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAC9B,IAAA,gBAAS,EAAC,kEAAkE,CAAC,CAAC;YAC9E,OAAO,GAAG,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC5C,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,mDAAmD;QACnD,MAAM,SAAS,GAAG;YAChB,eAAe,EAAE;gBACf,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,gBAAgB,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB;gBAClF,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa;aACpE;SACF,CAAC;QAEF,OAAO,GAAG,uBAAuB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACnD,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAA,eAAQ,EAAC,0CAA0C,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QACvE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AA3BD,oDA2BC;AAED;;;GAGG;AACH,SAAgB,wBAAwB;IACtC,MAAM,MAAM,GAAG,oBAAoB,EAAE,CAAC;IACtC,OAAO,MAAM,CAAC,eAAe,CAAC;AAChC,CAAC;AAHD,4DAGC;AAED;;GAEG;AACH,SAAgB,sBAAsB;IACpC,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC;AAFD,wDAEC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.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

@@ -0,0 +1,72 @@
+import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
+import { BaseAction } from "@memberjunction/actions";
+/**
+ * Action that creates a concise summary of content with citations to source material.
+ * Can work with either a URL (fetch + summarize) or pre-fetched content.
+ *
+ * Features:
+ * - Flexible input: URL or pre-fetched content
+ * - Configurable summary length (word count target)
+ * - Optional citations with quotes and links
+ * - Focus instructions for domain-specific summarization
+ * - Multiple output formats (paragraph, bullets, hybrid)
+ * - Automatic anchor link detection for precise citations
+ *
+ * @example
+ * ```typescript
+ * // Summarize from URL
+ * await runAction({
+ *   ActionName: 'Summarize Content',
+ *   Params: [{
+ *     Name: 'url',
+ *     Value: 'https://docs.memberjunction.org/architecture'
+ *   }, {
+ *     Name: 'summaryWords',
+ *     Value: 200
+ *   }, {
+ *     Name: 'instructions',
+ *     Value: 'Focus on metadata layer and entity system'
+ *   }]
+ * });
+ *
+ * // Summarize pre-fetched content
+ * await runAction({
+ *   ActionName: 'Summarize Content',
+ *   Params: [{
+ *     Name: 'content',
+ *     Value: '<html>...</html>'
+ *   }, {
+ *     Name: 'sourceUrl',
+ *     Value: 'https://docs.memberjunction.org/architecture'
+ *   }, {
+ *     Name: 'includeCitations',
+ *     Value: true
+ *   }]
+ * });
+ * ```
+ */
+export declare class SummarizeContentAction extends BaseAction {
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    /**
+     * Fetch web page content using the Get Web Page Content action
+     */
+    private fetchWebPageContent;
+    /**
+     * Generate summary using AI Prompts package directly
+     */
+    private generateSummary;
+    /**
+     * Get prompt by name and category from AIEngine
+     */
+    private getPromptByNameAndCategory;
+    private getStringParam;
+    private getNumericParam;
+    private getBooleanParam;
+    private addOutputParam;
+    private createErrorResult;
+}
+/**
+ * Loader function to ensure the SummarizeContentAction class is included in the bundle.
+ */
+export declare function LoadSummarizeContentAction(): void;
+//# sourceMappingURL=summarize-content.action.d.ts.map

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

@@ -0,0 +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,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"}