@memberjunction/ai-agents 5.21.0 → 5.23.0

package/dist/ClientToolRequestManager.js

@@ -0,0 +1,107 @@
+/**
+ * @fileoverview Server-side singleton that manages pending client tool requests.
+ *
+ * BaseAgent publishes a request via PubSub and awaits the returned Promise.
+ * The GraphQL resolver receives the client's response and resolves that Promise.
+ *
+ * @module @memberjunction/ai-agents
+ */
+import { BaseSingleton } from '@memberjunction/global';
+import { LogStatus, LogError } from '@memberjunction/core';
+/** The PubSub topic used for client tool requests */
+export const CLIENT_TOOL_REQUEST_TOPIC = 'CLIENT_TOOL_REQUEST';
+/**
+ * Singleton that manages pending client tool requests.
+ * BaseAgent publishes a request and awaits the Promise.
+ * The GraphQL resolver receives the response and resolves the Promise.
+ */
+export class ClientToolRequestManager extends BaseSingleton {
+    constructor() {
+        super();
+        this.pendingRequests = new Map();
+        /** Enriched tool definitions per session (from client decoration) */
+        this.sessionTools = new Map();
+        /** Optional PubSub publish function — injected by the server at startup */
+        this.publishFn = null;
+    }
+    static get Instance() {
+        return super.getInstance();
+    }
+    /**
+     * Set the publish function used to send tool requests to clients.
+     * Called once at server startup after PubSubManager is configured.
+     */
+    SetPublishFunction(fn) {
+        this.publishFn = fn;
+    }
+    /**
+     * Called by BaseAgent to send a request and await the response.
+     * Publishes via PubSub and returns a Promise that resolves when
+     * the client responds or times out.
+     */
+    async RequestClientTool(requestID, toolName, params, sessionID, agentRunID, timeoutMs, description) {
+        if (!this.publishFn) {
+            return {
+                RequestID: requestID,
+                Success: false,
+                ErrorMessage: 'PubSub not configured — cannot send client tool requests'
+            };
+        }
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                this.pendingRequests.delete(requestID);
+                LogError(`Client tool "${toolName}" timed out after ${timeoutMs}ms (request ${requestID})`);
+                resolve({
+                    RequestID: requestID,
+                    Success: false,
+                    ErrorMessage: `Client tool "${toolName}" timed out after ${timeoutMs}ms`
+                });
+            }, timeoutMs);
+            this.pendingRequests.set(requestID, { Resolve: resolve, Timer: timer });
+            const notification = {
+                AgentRunID: agentRunID,
+                SessionID: sessionID,
+                RequestID: requestID,
+                ToolName: toolName,
+                Params: JSON.stringify(params),
+                TimeoutMs: timeoutMs,
+                Description: description ?? ''
+            };
+            this.publishFn(CLIENT_TOOL_REQUEST_TOPIC, notification);
+            LogStatus(`ClientToolRequestManager: published "${toolName}" request (${requestID}) for session ${sessionID}`);
+        });
+    }
+    /**
+     * Called by the RespondToClientToolRequest GraphQL mutation.
+     * Resolves the pending Promise so the agent loop continues.
+     */
+    ReceiveResponse(response) {
+        const pending = this.pendingRequests.get(response.RequestID);
+        if (!pending) {
+            LogError(`ClientToolRequestManager: no pending request for ${response.RequestID}`);
+            return false;
+        }
+        clearTimeout(pending.Timer);
+        this.pendingRequests.delete(response.RequestID);
+        pending.Resolve(response);
+        LogStatus(`ClientToolRequestManager: received response for ${response.RequestID} (success=${response.Success})`);
+        return true;
+    }
+    /** Store enriched tool definitions for a session */
+    SetSessionTools(sessionID, tools) {
+        this.sessionTools.set(sessionID, tools);
+    }
+    /** Get enriched tool definitions for prompt injection */
+    GetSessionTools(sessionID) {
+        return this.sessionTools.get(sessionID) ?? [];
+    }
+    /** Clean up when session ends */
+    ClearSession(sessionID) {
+        this.sessionTools.delete(sessionID);
+    }
+    /** Get the number of pending requests (useful for testing/monitoring) */
+    get PendingRequestCount() {
+        return this.pendingRequests.size;
+    }
+}
+//# sourceMappingURL=ClientToolRequestManager.js.map

package/dist/ClientToolRequestManager.js.map

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

package/dist/KnowledgeAgent.d.ts

@@ -0,0 +1,102 @@
+/**
+ * @fileoverview Knowledge Agent — a sub-agent for Sage that provides
+ * Knowledge Hub capabilities: search, vectorization, duplicate detection,
+ * and client-side navigation.
+ *
+ * Server tools execute on the server (search, vectorize, dedup).
+ * Client tools send instructions to the Angular client (navigate, filter).
+ *
+ * @module @memberjunction/ai-agents
+ */
+import { UserInfo } from '@memberjunction/core';
+/**
+ * Describes a tool available to the Knowledge Agent.
+ */
+export interface KnowledgeAgentTool {
+    /** Unique tool name */
+    Name: string;
+    /** Human-readable description */
+    Description: string;
+    /** Where the tool executes */
+    ExecutionSide: 'server' | 'client';
+    /** JSON schema for tool parameters */
+    ParameterSchema: Record<string, unknown>;
+}
+/**
+ * Request to invoke a client-side tool from the server.
+ */
+export interface ClientToolRequest {
+    /** Unique request ID for correlation */
+    RequestID: string;
+    /** The tool name to invoke */
+    ToolName: string;
+    /** Parameters for the tool */
+    Parameters: Record<string, unknown>;
+    /** Timestamp of the request */
+    RequestedAt: Date;
+}
+/**
+ * Response from a client-side tool invocation.
+ */
+export interface ClientToolResponse {
+    /** Correlates to the original RequestID */
+    RequestID: string;
+    /** Whether the client tool executed successfully */
+    Success: boolean;
+    /** Result data from the tool */
+    Data?: Record<string, unknown>;
+    /** Error message if not successful */
+    ErrorMessage?: string;
+    /** Timestamp of the response */
+    RespondedAt: Date;
+}
+/**
+ * Knowledge Agent provides Knowledge Hub capabilities as a sub-agent.
+ *
+ * ## Server Tools
+ * - `search_knowledge` — Execute a unified search across vector + full-text indexes
+ * - `create_entity_document` — Create a new entity document template for vectorization
+ * - `run_vectorization` — Trigger vectorization for an entity
+ * - `run_duplicate_detection` — Run duplicate detection on an entity
+ *
+ * ## Client Tools (sent to browser)
+ * - `navigate_to_tab` — Switch the Knowledge Hub to a specific tab
+ * - `open_suggest_panel` — Open the document suggestion panel
+ * - `apply_search_filter` — Apply filters to the search UI
+ */
+export declare class KnowledgeAgent {
+    /** All tools this agent can invoke */
+    static readonly Tools: KnowledgeAgentTool[];
+    /**
+     * Execute a server-side tool by name.
+     */
+    ExecuteServerTool(toolName: string, parameters: Record<string, unknown>, contextUser: UserInfo): Promise<{
+        Success: boolean;
+        Data?: Record<string, unknown>;
+        ErrorMessage?: string;
+    }>;
+    /**
+     * Build a client tool request for the Angular frontend.
+     */
+    BuildClientToolRequest(toolName: string, parameters: Record<string, unknown>): ClientToolRequest;
+    /**
+     * Get the tool definitions formatted for LLM function calling.
+     */
+    GetToolDefinitions(): Array<{
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    }>;
+    /**
+     * Execute search via the SearchKnowledge GraphQL mutation.
+     * This uses the same UnifiedSearchService (vector + FTS + RRF fusion) that
+     * the Angular search component uses, ensuring consistent results.
+     */
+    private executeSearchKnowledge;
+    private executeCreateEntityDocument;
+    private executeRunVectorization;
+    private executeRunDuplicateDetection;
+    private buildDuplicateRequest;
+    private generateRequestID;
+}
+//# sourceMappingURL=KnowledgeAgent.d.ts.map

package/dist/KnowledgeAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KnowledgeAgent.d.ts","sourceRoot":"","sources":["../src/KnowledgeAgent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAiC,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAG/E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,aAAa,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACnC,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,+BAA+B;IAC/B,WAAW,EAAE,IAAI,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,OAAO,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gCAAgC;IAChC,WAAW,EAAE,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,cAAc;IACvB,sCAAsC;IACtC,gBAAuB,KAAK,EAAE,kBAAkB,EAAE,CAkGhD;IAEF;;OAEG;IACU,iBAAiB,CAC1B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,WAAW,EAAE,QAAQ,GACtB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAiBvF;;OAEG;IACI,sBAAsB,CACzB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,iBAAiB;IASpB;;OAEG;IACI,kBAAkB,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAY9G;;;;OAIG;YACW,sBAAsB;YAwEtB,2BAA2B;YA0C3B,uBAAuB;YAkCvB,4BAA4B;IAmC1C,OAAO,CAAC,qBAAqB;IAc7B,OAAO,CAAC,iBAAiB;CAG5B"}

package/dist/KnowledgeAgent.js

@@ -0,0 +1,338 @@
+/**
+ * @fileoverview Knowledge Agent — a sub-agent for Sage that provides
+ * Knowledge Hub capabilities: search, vectorization, duplicate detection,
+ * and client-side navigation.
+ *
+ * Server tools execute on the server (search, vectorize, dedup).
+ * Client tools send instructions to the Angular client (navigate, filter).
+ *
+ * @module @memberjunction/ai-agents
+ */
+import { LogStatus, LogError, Metadata } from '@memberjunction/core';
+import { DuplicateRecordDetector } from '@memberjunction/ai-vector-dupe';
+/**
+ * Knowledge Agent provides Knowledge Hub capabilities as a sub-agent.
+ *
+ * ## Server Tools
+ * - `search_knowledge` — Execute a unified search across vector + full-text indexes
+ * - `create_entity_document` — Create a new entity document template for vectorization
+ * - `run_vectorization` — Trigger vectorization for an entity
+ * - `run_duplicate_detection` — Run duplicate detection on an entity
+ *
+ * ## Client Tools (sent to browser)
+ * - `navigate_to_tab` — Switch the Knowledge Hub to a specific tab
+ * - `open_suggest_panel` — Open the document suggestion panel
+ * - `apply_search_filter` — Apply filters to the search UI
+ */
+export class KnowledgeAgent {
+    /** All tools this agent can invoke */
+    static { this.Tools = [
+        // Server tools
+        {
+            Name: 'search_knowledge',
+            Description: 'Search across all knowledge using unified vector + full-text search with RRF fusion',
+            ExecutionSide: 'server',
+            ParameterSchema: {
+                type: 'object',
+                properties: {
+                    query: { type: 'string', description: 'The search query text' },
+                    maxResults: { type: 'number', description: 'Maximum results to return (default: 20)' },
+                    entityNames: { type: 'array', items: { type: 'string' }, description: 'Filter to specific entity names' },
+                },
+                required: ['query'],
+            },
+        },
+        {
+            Name: 'create_entity_document',
+            Description: 'Create a new entity document template for vectorization using AI suggestions',
+            ExecutionSide: 'server',
+            ParameterSchema: {
+                type: 'object',
+                properties: {
+                    entityName: { type: 'string', description: 'The entity to create a document template for' },
+                    useCase: { type: 'string', enum: ['duplicate detection', 'search', 'classification'], description: 'The intended use case' },
+                },
+                required: ['entityName'],
+            },
+        },
+        {
+            Name: 'run_vectorization',
+            Description: 'Trigger vectorization for an entity using its configured document template',
+            ExecutionSide: 'server',
+            ParameterSchema: {
+                type: 'object',
+                properties: {
+                    entityID: { type: 'string', description: 'The Entity ID to vectorize' },
+                    entityDocumentID: { type: 'string', description: 'Optional Entity Document ID (if omitted, uses default for the entity)' },
+                    listID: { type: 'string', description: 'Optional List ID to restrict vectorization to a specific list' },
+                    listBatchCount: { type: 'number', description: 'Number of records to fetch at a time (default: 50)' },
+                },
+                required: ['entityID'],
+            },
+        },
+        {
+            Name: 'run_duplicate_detection',
+            Description: 'Run duplicate detection on an entity using vector similarity',
+            ExecutionSide: 'server',
+            ParameterSchema: {
+                type: 'object',
+                properties: {
+                    entityID: { type: 'string', description: 'The Entity ID to check for duplicates' },
+                    listID: { type: 'string', description: 'The List ID containing records to check' },
+                    entityDocumentID: { type: 'string', description: 'The Entity Document ID defining the vectorization template' },
+                    probabilityScore: { type: 'number', description: 'Minimum score threshold for potential duplicates (0-1)' },
+                },
+                required: ['entityID', 'listID'],
+            },
+        },
+        // Client tools
+        {
+            Name: 'navigate_to_tab',
+            Description: 'Navigate the Knowledge Hub UI to a specific tab (search, config, vectors, duplicates)',
+            ExecutionSide: 'client',
+            ParameterSchema: {
+                type: 'object',
+                properties: {
+                    tab: { type: 'string', enum: ['search', 'config', 'vectors', 'duplicates'], description: 'Tab to navigate to' },
+                },
+                required: ['tab'],
+            },
+        },
+        {
+            Name: 'open_suggest_panel',
+            Description: 'Open the entity document suggestion panel in the UI',
+            ExecutionSide: 'client',
+            ParameterSchema: {
+                type: 'object',
+                properties: {
+                    entityName: { type: 'string', description: 'Pre-select this entity in the suggestion panel' },
+                },
+                required: [],
+            },
+        },
+        {
+            Name: 'apply_search_filter',
+            Description: 'Apply search filters to the Knowledge Hub search UI',
+            ExecutionSide: 'client',
+            ParameterSchema: {
+                type: 'object',
+                properties: {
+                    entityNames: { type: 'array', items: { type: 'string' }, description: 'Filter to these entity names' },
+                    sourceTypes: { type: 'array', items: { type: 'string' }, description: 'Filter to these source types' },
+                    tags: { type: 'array', items: { type: 'string' }, description: 'Filter to these tags' },
+                },
+                required: [],
+            },
+        },
+    ]; }
+    /**
+     * Execute a server-side tool by name.
+     */
+    async ExecuteServerTool(toolName, parameters, contextUser) {
+        LogStatus(`KnowledgeAgent: Executing server tool "${toolName}"`);
+        switch (toolName) {
+            case 'search_knowledge':
+                return this.executeSearchKnowledge(parameters, contextUser);
+            case 'create_entity_document':
+                return this.executeCreateEntityDocument(parameters, contextUser);
+            case 'run_vectorization':
+                return this.executeRunVectorization(parameters, contextUser);
+            case 'run_duplicate_detection':
+                return this.executeRunDuplicateDetection(parameters, contextUser);
+            default:
+                return { Success: false, ErrorMessage: `Unknown server tool: ${toolName}` };
+        }
+    }
+    /**
+     * Build a client tool request for the Angular frontend.
+     */
+    BuildClientToolRequest(toolName, parameters) {
+        return {
+            RequestID: this.generateRequestID(),
+            ToolName: toolName,
+            Parameters: parameters,
+            RequestedAt: new Date(),
+        };
+    }
+    /**
+     * Get the tool definitions formatted for LLM function calling.
+     */
+    GetToolDefinitions() {
+        return KnowledgeAgent.Tools.map(tool => ({
+            name: tool.Name,
+            description: tool.Description,
+            parameters: tool.ParameterSchema,
+        }));
+    }
+    // ================================================================
+    // Private Tool Implementations
+    // ================================================================
+    /**
+     * Execute search via the SearchKnowledge GraphQL mutation.
+     * This uses the same UnifiedSearchService (vector + FTS + RRF fusion) that
+     * the Angular search component uses, ensuring consistent results.
+     */
+    async executeSearchKnowledge(parameters, _contextUser) {
+        try {
+            const query = String(parameters['query'] || '');
+            if (!query.trim()) {
+                return { Success: false, ErrorMessage: 'Query cannot be empty' };
+            }
+            const maxResults = Number(parameters['maxResults']) || 20;
+            const entityFilter = parameters['entityNames'];
+            const provider = Metadata.Provider;
+            if (!provider?.ExecuteGQL) {
+                return { Success: false, ErrorMessage: 'GraphQL provider not available for search' };
+            }
+            const mutation = `
+                mutation SearchKnowledge($query: String!, $maxResults: Float, $filters: SearchFiltersInput) {
+                    SearchKnowledge(query: $query, maxResults: $maxResults, filters: $filters) {
+                        Success
+                        TotalCount
+                        ElapsedMs
+                        ErrorMessage
+                        Results {
+                            ID
+                            EntityName
+                            RecordID
+                            SourceType
+                            Title
+                            Snippet
+                            Score
+                            Tags
+                        }
+                    }
+                }
+            `;
+            const filters = entityFilter?.length
+                ? { EntityNames: entityFilter }
+                : undefined;
+            const gqlResult = await provider.ExecuteGQL(mutation, {
+                query,
+                maxResults,
+                filters
+            });
+            const data = gqlResult['SearchKnowledge'];
+            if (!data?.['Success']) {
+                return {
+                    Success: false,
+                    ErrorMessage: String(data?.['ErrorMessage'] ?? 'Search failed')
+                };
+            }
+            return {
+                Success: true,
+                Data: {
+                    Results: data['Results'],
+                    TotalCount: data['TotalCount'],
+                    ElapsedMs: data['ElapsedMs'],
+                },
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            LogError(`KnowledgeAgent.search_knowledge failed: ${msg}`);
+            return { Success: false, ErrorMessage: msg };
+        }
+    }
+    async executeCreateEntityDocument(parameters, contextUser) {
+        try {
+            const entityName = String(parameters['entityName'] || '');
+            const useCase = String(parameters['useCase'] || 'search');
+            if (!entityName) {
+                return { Success: false, ErrorMessage: 'entityName is required' };
+            }
+            // Dynamic import to avoid circular dependencies
+            const { EntityDocumentSuggester } = await import('@memberjunction/ai-vector-sync');
+            const suggester = new EntityDocumentSuggester();
+            const response = await suggester.SuggestDocument(entityName, useCase, contextUser);
+            if (!response.Success || !response.Suggestion) {
+                return { Success: false, ErrorMessage: response.ErrorMessage || 'Suggestion failed' };
+            }
+            return {
+                Success: true,
+                Data: {
+                    Template: response.Suggestion.template,
+                    SelectedFields: response.Suggestion.selectedFields,
+                    Reasoning: response.Suggestion.reasoning,
+                    PotentialMatchThreshold: response.Suggestion.potentialMatchThreshold,
+                    AbsoluteMatchThreshold: response.Suggestion.absoluteMatchThreshold,
+                },
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            LogError(`KnowledgeAgent.create_entity_document failed: ${msg}`);
+            return { Success: false, ErrorMessage: msg };
+        }
+    }
+    async executeRunVectorization(parameters, contextUser) {
+        try {
+            const entityID = String(parameters['entityID'] || '');
+            if (!entityID) {
+                return { Success: false, ErrorMessage: 'entityID is required' };
+            }
+            // Dynamic import to avoid circular dependencies
+            const { EntityVectorSyncer } = await import('@memberjunction/ai-vector-sync');
+            const syncer = new EntityVectorSyncer();
+            await syncer.Config(false, contextUser);
+            const result = await syncer.VectorizeEntity({
+                entityID,
+                entityDocumentID: parameters['entityDocumentID'] ? String(parameters['entityDocumentID']) : undefined,
+                listID: parameters['listID'] ? String(parameters['listID']) : undefined,
+                listBatchCount: Number(parameters['listBatchCount']) || 50,
+            }, contextUser);
+            return {
+                Success: result.success,
+                Data: { Status: result.status },
+                ErrorMessage: result.errorMessage || undefined,
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            LogError(`KnowledgeAgent.run_vectorization failed: ${msg}`);
+            return { Success: false, ErrorMessage: msg };
+        }
+    }
+    async executeRunDuplicateDetection(parameters, contextUser) {
+        try {
+            const entityID = String(parameters['entityID'] || '');
+            const listID = String(parameters['listID'] || '');
+            if (!entityID) {
+                return { Success: false, ErrorMessage: 'entityID is required' };
+            }
+            if (!listID) {
+                return { Success: false, ErrorMessage: 'listID is required' };
+            }
+            const detector = new DuplicateRecordDetector();
+            detector.CurrentUser = contextUser;
+            const request = this.buildDuplicateRequest(entityID, listID, parameters);
+            const result = await detector.GetDuplicateRecords(request, contextUser);
+            return {
+                Success: result.Status === 'Success',
+                Data: {
+                    Status: result.Status,
+                    DuplicateCount: result.PotentialDuplicateResult?.length || 0,
+                },
+                ErrorMessage: result.ErrorMessage || undefined,
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            LogError(`KnowledgeAgent.run_duplicate_detection failed: ${msg}`);
+            return { Success: false, ErrorMessage: msg };
+        }
+    }
+    buildDuplicateRequest(entityID, listID, parameters) {
+        return {
+            EntityID: entityID,
+            ListID: listID,
+            RecordIDs: [],
+            EntityDocumentID: parameters['entityDocumentID'] ? String(parameters['entityDocumentID']) : undefined,
+            ProbabilityScore: parameters['probabilityScore'] != null ? Number(parameters['probabilityScore']) : undefined,
+        };
+    }
+    generateRequestID() {
+        return `ctr-${Date.now()}-${Math.random().toString(36).substring(2, 8)}`;
+    }
+}
+//# sourceMappingURL=KnowledgeAgent.js.map

package/dist/KnowledgeAgent.js.map

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

package/dist/agent-types/loop-agent-prompt-params.d.ts

@@ -1,10 +1,19 @@
 /**
- * @fileoverview Type definitions for Loop Agent Type prompt parameters.
+ * @fileoverview Type definitions for Loop Agent Type parameters.
  *
- * This module contains the interface definition for parameters that control
- * which sections are included in the Loop Agent Type's system prompt.
- * These parameters enable significant token savings for agents that don't
- * need all capabilities documented in the full system prompt.
+ * This module defines the per-agent configuration interface for Loop-type agents.
+ * These parameters are stored in the `AgentTypePromptParams` JSON field on the
+ * `MJ: AI Agents` entity and control:
+ *
+ * - **Prompt inclusion**: Which sections are included in the system prompt
+ *   (enables token savings by excluding unused documentation)
+ * - **Client tools**: Browser-side tools the agent can invoke (navigation, UI actions)
+ * - **Content limits**: Max sub-agents/actions to include in prompts
+ *
+ * Parameters are merged with three-level precedence:
+ * 1. Schema defaults (from AIAgentType.PromptParamsSchema) — lowest priority
+ * 2. Agent config (from AIAgent.AgentTypePromptParams) — medium priority
+ * 3. Runtime override (from ExecuteAgentParams.data.__agentTypePromptParams) — highest priority
  *
  * @module @memberjunction/ai-agents
  * @author MemberJunction.com
@@ -71,11 +80,13 @@ export interface ResponseTypeInclusionRules {
  */
 export declare const DEFAULT_RESPONSE_TYPE_INCLUSION_RULES: Required<ResponseTypeInclusionRules>;
 /**
- * Prompt parameters for Loop Agent Type.
- * Controls which sections are included in the system prompt to optimize token usage.
+ * Configuration parameters for Loop Agent Type.
+ *
+ * Controls prompt content (which sections are included), client tool availability,
+ * and content limits. Stored in `AIAgent.AgentTypePromptParams` as JSON.
  *
- * All boolean properties default to true (include section) when not specified.
- * Set to false to exclude a section from the prompt.
+ * All boolean prompt-inclusion properties default to true (include section).
+ * Set to false to exclude a section from the prompt and save tokens.
  *
  * These parameters are configured at three levels with merge precedence:
  * 1. Schema defaults (from AIAgentType.PromptParamsSchema) - lowest priority
@@ -191,6 +202,14 @@ export interface LoopAgentTypePromptParams {
      * @default true
      */
     includePayloadInPrompt?: boolean;
+    /**
+     * Include current date, time, and day of week in the prompt.
+     * Provides the LLM with accurate temporal context so it doesn't hallucinate
+     * dates or claim it doesn't know the current time.
+     * Disable for agents where temporal context is irrelevant.
+     * @default true
+     */
+    includeDateTimeInPrompt?: boolean;
     /**
      * Include scratchpad documentation and current scratchpad state in the prompt.
      * The scratchpad is private working memory for notes and task tracking.
@@ -225,7 +244,7 @@ export interface LoopAgentTypePromptParams {
 }
 /**
  * Default values for LoopAgentTypePromptParams.
- * All section flags default to true (include), and limits default to -1 (include all).
+ * All section flags default to true (include), limits default to -1 (include all).
  */
 export declare const DEFAULT_LOOP_AGENT_PROMPT_PARAMS: Required<LoopAgentTypePromptParams>;
 //# sourceMappingURL=loop-agent-prompt-params.d.ts.map

package/dist/agent-types/loop-agent-prompt-params.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loop-agent-prompt-params.d.ts","sourceRoot":"","sources":["../../src/agent-types/loop-agent-prompt-params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,0BAA0B;IACvC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,eAAO,MAAM,qCAAqC,EAAE,QAAQ,CAAC,0BAA0B,CAOtF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,MAAM,WAAW,yBAAyB;IAGtC;;;;;;;;;OASG;IACH,6BAA6B,CAAC,EAAE,0BAA0B,CAAC;IAE3D;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;;;;;OAOG;IACH,2BAA2B,CAAC,EAAE,OAAO,CAAC;IAEtC;;;;;OAKG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAI5B;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;GAGG;AACH,eAAO,MAAM,gCAAgC,EAAE,QAAQ,CAAC,yBAAyB,CAahF,CAAC"}
+{"version":3,"file":"loop-agent-prompt-params.d.ts","sourceRoot":"","sources":["../../src/agent-types/loop-agent-prompt-params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,0BAA0B;IACvC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;GAGG;AACH,eAAO,MAAM,qCAAqC,EAAE,QAAQ,CAAC,0BAA0B,CAOtF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,MAAM,WAAW,yBAAyB;IAGtC;;;;;;;;;OASG;IACH,6BAA6B,CAAC,EAAE,0BAA0B,CAAC;IAE3D;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;;;;;OAOG;IACH,2BAA2B,CAAC,EAAE,OAAO,CAAC;IAEtC;;;;;OAKG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC;;;;;;OAMG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAI5B;;;;;;;OAOG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;;;;OAOG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;GAGG;AACH,eAAO,MAAM,gCAAgC,EAAE,QAAQ,CAAC,yBAAyB,CAchF,CAAC"}