@memberjunction/core-actions 5.50.0 → 6.1.0-edge.0

package/LICENSE

@@ -0,0 +1,7 @@
+ISC License
+
+Copyright (c) 2023 MemberJunction
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/dist/custom/ai/base-find-actions.action.d.ts

@@ -0,0 +1,22 @@
+import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
+import { BaseAction } from "@memberjunction/actions";
+/**
+ * Shared base for the "Find Best Action" / "Find Candidate Actions" wrappers.
+ *
+ * Both rank actions for a task description via the unified
+ * {@link IRunViewProvider.SearchEntity} pipeline (semantic mode, backed by the
+ * daily-synced "Actions Search" EntityDocument) and then hydrate action metadata
+ * + parameters from AIEngine's cache to preserve the legacy
+ * `MatchedActions` / `MatchCount` output shape.
+ *
+ * This base intentionally carries **no** `@RegisterClass` decorator so importing
+ * it from a concrete subclass does not register an extra action.
+ */
+export declare abstract class BaseFindActionsAction extends BaseAction {
+    /** Entity searched by this action. */
+    protected get entityName(): string;
+    /** Verb used in error messages (e.g. "find best action"). */
+    protected abstract get actionLabel(): string;
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+}
+//# sourceMappingURL=base-find-actions.action.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-find-actions.action.d.ts","sourceRoot":"","sources":["../../../src/custom/ai/base-find-actions.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEnF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAMrD;;;;;;;;;;;GAWG;AACH,8BAAsB,qBAAsB,SAAQ,UAAU;IAC1D,sCAAsC;IACtC,SAAS,KAAK,UAAU,IAAI,MAAM,CAA0B;IAC5D,6DAA6D;IAC7D,SAAS,CAAC,QAAQ,KAAK,WAAW,IAAI,MAAM,CAAC;cAE7B,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;CA2G1F"}

package/dist/custom/ai/base-find-actions.action.js

@@ -0,0 +1,118 @@
+import { NormalizeUUID } from "@memberjunction/global";
+import { BaseAction } from "@memberjunction/actions";
+import { AIEngine } from "@memberjunction/aiengine";
+import { RunView } from "@memberjunction/core";
+import { runSemanticEntitySearch, getActionParamValue, getActionBooleanParam } from "./semantic-entity-search.helper.js";
+/**
+ * Shared base for the "Find Best Action" / "Find Candidate Actions" wrappers.
+ *
+ * Both rank actions for a task description via the unified
+ * {@link IRunViewProvider.SearchEntity} pipeline (semantic mode, backed by the
+ * daily-synced "Actions Search" EntityDocument) and then hydrate action metadata
+ * + parameters from AIEngine's cache to preserve the legacy
+ * `MatchedActions` / `MatchCount` output shape.
+ *
+ * This base intentionally carries **no** `@RegisterClass` decorator so importing
+ * it from a concrete subclass does not register an extra action.
+ */
+export class BaseFindActionsAction extends BaseAction {
+    /** Entity searched by this action. */
+    get entityName() { return 'MJ: Actions'; }
+    async InternalRunAction(params) {
+        try {
+            const taskDescription = getActionParamValue(params, 'taskdescription');
+            const maxResults = parseInt(String(getActionParamValue(params, 'maxresults') ?? '10'));
+            const minimumSimilarityScore = parseFloat(String(getActionParamValue(params, 'minimumsimilarityscore') ?? '0.5'));
+            const excludeAgentManagement = getActionBooleanParam(params, 'excludeagentmanagement', true);
+            if (!taskDescription || taskDescription.trim().length === 0) {
+                return { Success: false, ResultCode: 'INVALID_INPUT', Message: 'TaskDescription parameter is required and cannot be empty' };
+            }
+            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' };
+            }
+            if (!params.ContextUser) {
+                return { Success: false, ResultCode: 'MISSING_USER_CONTEXT', Message: 'User context required' };
+            }
+            // Rank via the unified SearchEntity pipeline (over-fetch to allow post-filtering)
+            const search = await runSemanticEntitySearch(params, this.entityName, taskDescription, maxResults * 2, minimumSimilarityScore);
+            if (!search.ok) {
+                return { Success: false, ResultCode: search.resultCode ?? 'SEARCH_FAILED', Message: search.message ?? 'Semantic search failed' };
+            }
+            // Hydrate action metadata from AIEngine's cached actions (no DB round trip)
+            await AIEngine.Instance.Config(false, params.ContextUser);
+            const actionsById = new Map();
+            for (const a of AIEngine.Instance.SystemActions) {
+                actionsById.set(NormalizeUUID(a.ID), a);
+            }
+            let matched = search.results
+                .map(r => ({ action: actionsById.get(NormalizeUUID(r.recordId)), score: r.score }))
+                .filter((m) => m.action != null);
+            if (excludeAgentManagement) {
+                matched = matched.filter(m => m.action.Category !== 'Agent Management');
+            }
+            matched = matched.slice(0, maxResults);
+            if (matched.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 = matched.map(m => m.action.ID);
+            const rv = new RunView();
+            const paramsResult = await rv.RunView({
+                EntityName: 'MJ: Action Params',
+                ExtraFilter: `ActionID IN ('${actionIds.join("','")}')`,
+                OrderBy: 'ActionID, Name',
+                ResultType: 'entity_object'
+            }, params.ContextUser);
+            const paramsByActionId = new Map();
+            if (paramsResult.Success && paramsResult.Results) {
+                for (const param of paramsResult.Results) {
+                    const list = paramsByActionId.get(param.ActionID) ?? [];
+                    list.push(param);
+                    paramsByActionId.set(param.ActionID, list);
+                }
+            }
+            const actionsWithParams = matched.map(m => ({
+                actionId: m.action.ID,
+                actionName: m.action.Name,
+                similarityScore: Math.round(m.score * 100) / 100,
+                description: m.action.Description,
+                categoryName: m.action.Category,
+                status: m.action.Status,
+                driverClass: m.action.DriverClass,
+                parameters: (paramsByActionId.get(m.action.ID) || []).map(p => ({
+                    name: p.Name,
+                    type: p.Type,
+                    valueType: p.ValueType,
+                    isArray: p.IsArray,
+                    description: p.Description,
+                    isRequired: p.IsRequired,
+                    defaultValue: p.DefaultValue
+                }))
+            }));
+            params.Params.push({ Name: 'MatchedActions', Type: 'Output', Value: actionsWithParams });
+            params.Params.push({ Name: 'MatchCount', Type: 'Output', Value: actionsWithParams.length });
+            const responseData = {
+                message: `Found ${actionsWithParams.length} relevant action(s)`,
+                taskDescription,
+                matchCount: actionsWithParams.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 ${this.actionLabel}: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+}
+//# sourceMappingURL=base-find-actions.action.js.map

package/dist/custom/ai/base-find-actions.action.js.map

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

package/dist/custom/ai/base-find-agents.action.d.ts

@@ -0,0 +1,40 @@
+import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
+import { BaseAction } from "@memberjunction/actions";
+import { MJAIAgentEntityExtended } from "@memberjunction/ai-core-plus";
+/**
+ * Shared base for the "Find Best Agent" / "Find Candidate Agents" wrappers.
+ *
+ * Both rank agents for a task description via the unified
+ * {@link IRunViewProvider.SearchEntity} pipeline (semantic mode, backed by the
+ * daily-synced "AI Agents Search" EntityDocument), then permission-filter to
+ * agents the user can run, drop Sub-Agents, and hydrate agent metadata from
+ * AIEngine's cache. Subclasses tune the invocation filter and whether sub-agent
+ * details are included in the output.
+ *
+ * Carries **no** `@RegisterClass` decorator so importing it does not register an
+ * extra action.
+ */
+export declare abstract class BaseFindAgentsAction extends BaseAction {
+    /** Entity searched by this action. */
+    protected get entityName(): string;
+    /** Verb used in error messages. */
+    protected abstract get actionLabel(): string;
+    /** Whether each result includes sub-agent details + default artifact type (candidate variant). */
+    protected get includeSubAgentDetails(): boolean;
+    /**
+     * Variant-specific invocation/parent filtering. Default excludes agents whose
+     * invocation mode is 'Sub-Agent' (they're meant to be called by other agents).
+     */
+    protected applyInvocationFilter(agents: MJAIAgentEntityExtended[], _params: RunActionParams): MJAIAgentEntityExtended[];
+    protected InternalRunAction(params: RunActionParams): Promise<ActionResultSimple>;
+    /** Action names available to the given agent. */
+    protected getAgentActionNames(agentId: string): string[];
+    /** Sub-agents (direct children + relationship-linked) for the given agent. */
+    protected getSubAgents(agentId: string): Array<{
+        name: string;
+        description: string;
+    }>;
+    /** Builds the per-agent result object, including sub-agent details for the candidate variant. */
+    protected buildAgentResult(agent: MJAIAgentEntityExtended, score: number): Record<string, unknown>;
+}
+//# sourceMappingURL=base-find-agents.action.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-find-agents.action.d.ts","sourceRoot":"","sources":["../../../src/custom/ai/base-find-agents.action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEnF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAGvE;;;;;;;;;;;;GAYG;AACH,8BAAsB,oBAAqB,SAAQ,UAAU;IACzD,sCAAsC;IACtC,SAAS,KAAK,UAAU,IAAI,MAAM,CAA4B;IAC9D,mCAAmC;IACnC,SAAS,CAAC,QAAQ,KAAK,WAAW,IAAI,MAAM,CAAC;IAC7C,kGAAkG;IAClG,SAAS,KAAK,sBAAsB,IAAI,OAAO,CAAkB;IAEjE;;;OAGG;IACH,SAAS,CAAC,qBAAqB,CAAC,MAAM,EAAE,uBAAuB,EAAE,EAAE,OAAO,EAAE,eAAe,GAAG,uBAAuB,EAAE;cAIvG,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAoFvF,iDAAiD;IACjD,SAAS,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAMxD,8EAA8E;IAC9E,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAoBrF,iGAAiG;IACjG,SAAS,CAAC,gBAAgB,CAAC,KAAK,EAAE,uBAAuB,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAcrG"}

package/dist/custom/ai/base-find-agents.action.js

@@ -0,0 +1,139 @@
+import { UUIDsEqual, NormalizeUUID } from "@memberjunction/global";
+import { BaseAction } from "@memberjunction/actions";
+import { AIEngine } from "@memberjunction/aiengine";
+import { AIAgentPermissionHelper } from "@memberjunction/ai-engine-base";
+import { runSemanticEntitySearch, getActionParamValue, getActionBooleanParam } from "./semantic-entity-search.helper.js";
+/**
+ * Shared base for the "Find Best Agent" / "Find Candidate Agents" wrappers.
+ *
+ * Both rank agents for a task description via the unified
+ * {@link IRunViewProvider.SearchEntity} pipeline (semantic mode, backed by the
+ * daily-synced "AI Agents Search" EntityDocument), then permission-filter to
+ * agents the user can run, drop Sub-Agents, and hydrate agent metadata from
+ * AIEngine's cache. Subclasses tune the invocation filter and whether sub-agent
+ * details are included in the output.
+ *
+ * Carries **no** `@RegisterClass` decorator so importing it does not register an
+ * extra action.
+ */
+export class BaseFindAgentsAction extends BaseAction {
+    /** Entity searched by this action. */
+    get entityName() { return 'MJ: AI Agents'; }
+    /** Whether each result includes sub-agent details + default artifact type (candidate variant). */
+    get includeSubAgentDetails() { return false; }
+    /**
+     * Variant-specific invocation/parent filtering. Default excludes agents whose
+     * invocation mode is 'Sub-Agent' (they're meant to be called by other agents).
+     */
+    applyInvocationFilter(agents, _params) {
+        return agents.filter(a => a.InvocationMode !== 'Sub-Agent');
+    }
+    async InternalRunAction(params) {
+        try {
+            const taskDescription = getActionParamValue(params, 'taskdescription');
+            const maxResults = parseInt(String(getActionParamValue(params, 'maxresults') ?? '5'));
+            const minimumSimilarityScore = parseFloat(String(getActionParamValue(params, 'minimumsimilarityscore') ?? '0.5'));
+            const includeInactive = getActionBooleanParam(params, 'includeinactive', false);
+            if (!taskDescription || taskDescription.trim().length === 0) {
+                return { Success: false, ResultCode: 'INVALID_INPUT', Message: 'TaskDescription parameter is required and cannot be empty' };
+            }
+            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' };
+            }
+            if (!params.ContextUser) {
+                return { Success: false, ResultCode: 'MISSING_USER_CONTEXT', Message: 'User context required for permission filtering' };
+            }
+            // Rank via the unified SearchEntity pipeline (over-fetch 3x for post-filtering)
+            const search = await runSemanticEntitySearch(params, this.entityName, taskDescription, maxResults * 3, minimumSimilarityScore);
+            if (!search.ok) {
+                return { Success: false, ResultCode: search.resultCode ?? 'SEARCH_FAILED', Message: search.message ?? 'Semantic search failed' };
+            }
+            // Hydrate agent metadata from AIEngine's cache (no DB round trip)
+            await AIEngine.Instance.Config(false, params.ContextUser);
+            const agentsById = new Map();
+            for (const a of AIEngine.Instance.Agents) {
+                agentsById.set(NormalizeUUID(a.ID), a);
+            }
+            const scoreById = new Map();
+            let matched = [];
+            for (const r of search.results) {
+                const agent = agentsById.get(NormalizeUUID(r.recordId));
+                if (agent) {
+                    matched.push(agent);
+                    scoreById.set(NormalizeUUID(agent.ID), r.score);
+                }
+            }
+            // Permission-filter to agents the user can 'run'
+            const accessibleAgents = await AIAgentPermissionHelper.GetAccessibleAgents(params.ContextUser, 'run');
+            const accessibleAgentIds = new Set(accessibleAgents.map(a => NormalizeUUID(a.ID)));
+            matched = matched.filter(a => accessibleAgentIds.has(NormalizeUUID(a.ID)));
+            if (!includeInactive) {
+                matched = matched.filter(a => a.Status === 'Active');
+            }
+            matched = this.applyInvocationFilter(matched, params).slice(0, maxResults);
+            if (matched.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.`
+                };
+            }
+            const allMatches = matched.map(a => this.buildAgentResult(a, scoreById.get(NormalizeUUID(a.ID)) ?? 0));
+            params.Params.push({ Name: 'MatchedAgents', Type: 'Output', Value: allMatches });
+            params.Params.push({ Name: 'MatchCount', Type: 'Output', Value: allMatches.length });
+            const responseData = {
+                message: `Found ${allMatches.length} accessible agent(s)`,
+                taskDescription,
+                matchCount: allMatches.length,
+                allMatches
+            };
+            return { Success: true, ResultCode: 'SUCCESS', Message: JSON.stringify(responseData, null, 2) };
+        }
+        catch (error) {
+            return {
+                Success: false,
+                ResultCode: 'EXECUTION_ERROR',
+                Message: `Failed to ${this.actionLabel}: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+    /** Action names available to the given agent. */
+    getAgentActionNames(agentId) {
+        return AIEngine.Instance.AgentActions
+            .filter(aa => UUIDsEqual(aa.AgentID, agentId) && aa.Status === 'Active')
+            .map(aa => aa.Action);
+    }
+    /** Sub-agents (direct children + relationship-linked) for the given agent. */
+    getSubAgents(agentId) {
+        const subAgents = [];
+        const childAgents = AIEngine.Instance.Agents.filter(a => UUIDsEqual(a.ParentID, agentId) && a.Status === 'Active');
+        subAgents.push(...childAgents.map(a => ({ name: a.Name, description: a.Description || '' })));
+        const relationships = AIEngine.Instance.AgentRelationships.filter(r => UUIDsEqual(r.AgentID, agentId) && r.Status === 'Active');
+        for (const rel of relationships) {
+            const relatedAgent = AIEngine.Instance.Agents.find(a => UUIDsEqual(a.ID, rel.SubAgentID));
+            if (relatedAgent && relatedAgent.Status === 'Active') {
+                subAgents.push({ name: relatedAgent.Name, description: relatedAgent.Description || '' });
+            }
+        }
+        return subAgents;
+    }
+    /** Builds the per-agent result object, including sub-agent details for the candidate variant. */
+    buildAgentResult(agent, score) {
+        const base = {
+            agentId: agent.ID,
+            agentName: agent.Name,
+            similarityScore: Math.round(score * 100) / 100,
+            description: agent.Description,
+            actions: this.getAgentActionNames(agent.ID)
+        };
+        if (this.includeSubAgentDetails) {
+            base.subAgents = this.getSubAgents(agent.ID);
+            base.defaultArtifactType = agent.DefaultArtifactType || null;
+        }
+        return base;
+    }
+}
+//# sourceMappingURL=base-find-agents.action.js.map

package/dist/custom/ai/base-find-agents.action.js.map

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

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

@@ -1,49 +1,24 @@
-import { ActionResultSimple, RunActionParams } from "@memberjunction/actions-base";
-import { BaseAction } from "@memberjunction/actions";
+import { BaseFindActionsAction } from "./base-find-actions.action.js";
 /**
- * Action that finds the best-matching actions for a given task using embedding-based semantic search.
+ * Finds the best-matching actions for a given task using 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.
+ * @deprecated Prefer the generic **Search Entity** action
+ * (`SearchEntity({ entityName: 'MJ: Actions', searchText, options })`). This action
+ * is retained as a thin, backward-compatible wrapper around `Provider.SearchEntity`
+ * (semantic mode, backed by the daily-synced "Actions Search" EntityDocument).
+ *
+ * Inputs: `TaskDescription` (required), `MaxResults` (default 10), `MinimumSimilarityScore`
+ * (cosine 0-1, default 0.5), `ExcludeAgentManagement` (default true).
  *
  * @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
- *   }]
+ *   Params: [{ Name: 'TaskDescription', Value: 'Search the internet for information' }]
  * });
  * ```
  */
-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;
+export declare class FindBestActionAction extends BaseFindActionsAction {
+    protected get actionLabel(): string;
 }
 //# sourceMappingURL=find-best-action.action.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"find-best-action.action.d.ts","sourceRoot":"","sources":["../../../src/custom/ai/find-best-action.action.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBACa,oBAAqB,SAAQ,qBAAqB;IAC3D,SAAS,KAAK,WAAW,IAAI,MAAM,CAA+B;CACrE"}

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

@@ -6,193 +6,28 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { RegisterClass } from "@memberjunction/global";
 import { BaseAction } from "@memberjunction/actions";
-import { AIEngine } from "@memberjunction/aiengine";
-import { RunView } from "@memberjunction/core";
+import { BaseFindActionsAction } from "./base-find-actions.action.js";
 /**
- * Action that finds the best-matching actions for a given task using embedding-based semantic search.
+ * Finds the best-matching actions for a given task using 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.
+ * @deprecated Prefer the generic **Search Entity** action
+ * (`SearchEntity({ entityName: 'MJ: Actions', searchText, options })`). This action
+ * is retained as a thin, backward-compatible wrapper around `Provider.SearchEntity`
+ * (semantic mode, backed by the daily-synced "Actions Search" EntityDocument).
+ *
+ * Inputs: `TaskDescription` (required), `MaxResults` (default 10), `MinimumSimilarityScore`
+ * (cosine 0-1, default 0.5), `ExcludeAgentManagement` (default true).
  *
  * @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
- *   }]
+ *   Params: [{ Name: 'TaskDescription', Value: 'Search the internet for information' }]
  * });
  * ```
  */
-let FindBestActionAction = 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
-     */
-    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.Instance.Config(false, params.ContextUser);
-            // Find similar actions using AIEngine's built-in method - no database round trip!
-            const matchedActions = await 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 RunView();
-            const paramsResult = await rv.RunView({
-                EntityName: 'MJ: 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;
-    }
+let FindBestActionAction = class FindBestActionAction extends BaseFindActionsAction {
+    get actionLabel() { return 'find best action'; }
 };
 FindBestActionAction = __decorate([
     RegisterClass(BaseAction, "Find Best Action")