@memberjunction/ng-conversations 5.40.1 → 5.41.0

package/dist/lib/services/conversation-agent.service.d.ts

@@ -2,10 +2,11 @@ import { Observable } from 'rxjs';
 import { IMetadataProvider } from '@memberjunction/core';
 import { ExecuteAgentResult, AgentExecutionProgressCallback } from '@memberjunction/ai-core-plus';
 import { MJConversationDetailEntity } from '@memberjunction/core-entities';
-import { MJAIAgentEntityExtended, MJAIAgentRunEntityExtended } from "@memberjunction/ai-core-plus";
+import { MJAIAgentEntityExtended, MJAIAgentRunEntityExtended } from '@memberjunction/ai-core-plus';
 import { AgentClientService } from '@memberjunction/ng-agent-client';
 import { LazyArtifactInfo } from '../models/lazy-artifact-info';
 import { MentionParserService } from './mention-parser.service';
+import { ConversationsRuntimeBootstrap } from './conversations-runtime-bootstrap.service';
 import * as i0 from "@angular/core";
 /**
  * Context for artifact lookups - provides pre-loaded data from conversation
@@ -25,52 +26,83 @@ export interface IntentCheckResult {
     targetArtifactVersionId?: string;
 }
 /**
- * Service for managing agent interactions within conversations.
- * Handles communication with the ambient Sage Agent and other agents.
+ * Angular DI service for conversation-level agent orchestration.
+ *
+ * After PR 2 of the conversations-runtime extraction, the core
+ * `processMessage` flow and the conversation-manager-agent resolution are
+ * delegated to `@memberjunction/conversations-runtime`. This service is
+ * primarily a shim for those operations PLUS the holder of the helpers
+ * that haven't been ported yet:
+ *
+ * - `invokeSubAgent(...)` — used by Sage's routing decisions in
+ *   `message-input.component`.
+ * - `checkAgentContinuityIntent(...)` — fast intent classification when the
+ *   user replies to a previous-agent thread.
+ * - `findConfigurationPresetFromHistory(...)` — locates an agent's preset
+ *   from prior @mentions in the conversation.
+ * - `clearSession(...)` — per-conversation session-id bookkeeping.
+ *
+ * These can move to the runtime in a follow-up; they aren't strictly needed
+ * to invoke an agent end-to-end and stay here so the shim has zero behavior
+ * difference vs. the original.
  */
 export declare class ConversationAgentService {
     private mentionParser;
     private agentClientService;
     /** GraphQL AI client - retained for RunAIPrompt (intent checking) which AgentClientService doesn't wrap */
     private _aiClient;
+    /** Cached resolution of the conversation manager agent (default agent). */
     private _conversationManagerAgent;
     private _sessionIds;
-    private _isProcessing$;
-    /**
-     * Observable indicating if the ambient agent is currently processing
-     */
+    /** Observable indicating if the ambient agent is currently processing — delegated to the runtime's AgentRunner. */
     readonly isProcessing$: Observable<boolean>;
     private _provider;
-    constructor(mentionParser: MentionParserService, agentClientService: AgentClientService);
+    constructor(_bootstrap: ConversationsRuntimeBootstrap, mentionParser: MentionParserService, agentClientService: AgentClientService);
     /**
      * The metadata provider this service uses. When unset, falls back to Metadata.Provider.
-     * Setting it re-initializes the AI client to bind to the supplied provider.
+     * Setting it re-initializes the AI client and forwards the provider to the runtime's runner.
      */
     get Provider(): IMetadataProvider;
     set Provider(value: IMetadataProvider | null);
     /**
      * Initialize the GraphQL AI Client.
      * Retained for RunAIPrompt calls (intent checking) which the AgentClientService doesn't wrap.
-     * Agent execution (RunAIAgentFromConversationDetail) now goes through AgentClientService.
+     * Agent execution (RunAIAgentFromConversationDetail) now goes through ConversationsRuntime.AgentRunner.
      */
     private initializeAIClient;
     /**
-     * Get or load the Sage Agent (formerly Conversation Manager Agent)
+     * Resolve the conversation manager agent via the runtime's 4-step
+     * DefaultAgentResolver chain (explicit input → app-scoped Application
+     * Setting → global Application Setting → code-const Sage fallback). The
+     * result is cached on this service for use by the synchronous
+     * {@link ConversationManagerAgentName} getter.
+     *
+     * Existing callers expect a Promise<MJAIAgentEntityExtended | null> — we
+     * preserve that shape (returning null on failure rather than throwing)
+     * so the call sites don't need to change.
      */
     getConversationManagerAgent(): Promise<MJAIAgentEntityExtended | null>;
     /**
-     * Process a message through the ambient Sage Agent.
-     * This should be called for every message sent in a conversation.
-     *
-     * Uses the optimized RunAIAgentFromConversationDetail mutation which loads
-     * conversation history (including attachments) server-side for better performance.
+     * Synchronous read of the cached conversation-manager-agent name. Returns
+     * `null` until {@link getConversationManagerAgent} has been called at least
+     * once and resolved successfully. Used by `MessageItemComponent.isConversationManager`
+     * to flag messages from the routing agent without hardcoding `'Sage'`.
+     */
+    get ConversationManagerAgentName(): string | null;
+    /**
+     * Returns `true` if the supplied agent identifier (UUID or name) matches the
+     * currently cached conversation manager agent. Robust to either input.
+     */
+    IsConversationManagerAgent(agentIdOrName: string | null | undefined): boolean;
+    /**
+     * Process a message through the conversation manager agent. Delegates to
+     * `ConversationsRuntime.Instance.AgentRunner.processMessage(...)`.
      *
-     * @param conversationId The conversation ID
-     * @param message The message that was just sent
-     * @param conversationHistory Recent messages in the conversation for context (kept for backwards compatibility but not used)
-     * @param conversationDetailId The ID of the conversation detail record to link to the agent run
-     * @param onProgress Optional callback for receiving progress updates during execution
-     * @returns The agent's response, or null if the agent chooses not to respond
+     * Signature is preserved verbatim from the original service so existing
+     * call sites continue to compile. The unused `conversationHistory`
+     * parameter is kept for backwards compatibility (it was already
+     * documented as "kept for backwards compatibility but not used" in the
+     * original).
      */
     processMessage(conversationId: string, message: MJConversationDetailEntity, conversationHistory: MJConversationDetailEntity[], conversationDetailId: string, onProgress?: AgentExecutionProgressCallback, appContext?: Record<string, unknown> | null): Promise<ExecuteAgentResult | null>;
     /**
@@ -84,71 +116,25 @@ export declare class ConversationAgentService {
      */
     findConfigurationPresetFromHistory(agentId: string, conversationHistory: MJConversationDetailEntity[]): string | undefined;
     /**
-     * Build the message array for the agent from conversation history.
-     * Note: conversationHistory already includes the current message, so we don't add it separately.
-     * IMPORTANT: This method loads artifacts and attachments for each message.
-     *
-     * @deprecated This method is no longer used by processMessage() which now uses the optimized
-     * RunAIAgentFromConversationDetail mutation that loads history server-side. Kept for backwards
-     * compatibility with other callers that may need client-side message building.
-     */
-    private buildAgentMessages;
-    /**
-     * Load artifacts for messages (OUTPUT direction only)
-     */
-    private loadArtifactsForMessages;
-    /**
-     * Map ConversationDetail Role to agent message role
-     */
-    private mapRoleToAgentRole;
-    /**
-     * Check if a message is tagging another user or agent.
-     * Returns true if the message contains @mentions that are NOT the ambient agent.
-     * Future enhancement: parse @mentions and determine if ambient agent should process.
+     * Clear the session for a conversation (useful when starting a new topic)
      */
-    private isTaggingOthers;
+    clearSession(conversationId: string): void;
     /**
      * Invoke a sub-agent based on Sage Agent's payload.
      * This is called when Sage decides to delegate to a specialist agent.
      *
-     * @param agentName Name of the agent to invoke
-     * @param conversationId The conversation ID
-     * @param message The user message that triggered this
-     * @param conversationHistory Recent conversation history for context
-     * @param reasoning Why this agent is being invoked
-     * @param conversationDetailId The ID of the conversation detail record to link to the agent run
-     * @param payload Optional payload to pass to the agent (e.g., previous OUTPUT artifact for continuity)
-     * @param onProgress Optional callback for receiving progress updates during execution
-     * @param sourceArtifactId Optional source artifact ID for versioning
-     * @param sourceArtifactVersionId Optional source artifact version ID for versioning
-     * @param agentConfigurationPresetId Optional ID of the AIAgentConfiguration preset (will be mapped to AIConfigurationID)
-     * @returns The agent's execution result, or null if agent not found
+     * Stays on the Angular shim because it directly uses AgentClientService.
+     * Could move to the runtime in a follow-up if needed.
      */
     invokeSubAgent(agentName: string, conversationId: string, message: MJConversationDetailEntity, conversationHistory: MJConversationDetailEntity[], reasoning: string, conversationDetailId: string, payload?: unknown, onProgress?: AgentExecutionProgressCallback, sourceArtifactId?: string, sourceArtifactVersionId?: string, agentConfigurationPresetId?: string, appContext?: Record<string, unknown> | null): Promise<ExecuteAgentResult | null>;
     /**
      * Check if user's latest message should continue with the previous agent or route through Sage.
      * Uses fast inference (<500ms) to determine intent and avoid unnecessary Sage overhead.
      *
-     * @param agentId The ID of the previous agent
-     * @param latestMessage The user's new message
-     * @param conversationHistory Recent conversation history for context (last 10 messages)
-     * @param context Pre-loaded artifact and agent run data to avoid database queries
-     * @returns IntentCheckResult with decision, reasoning, and optional target artifact version
+     * Stays on the Angular shim because it directly uses GraphQLAIClient.
+     * Could move to the runtime in a follow-up.
      */
     checkAgentContinuityIntent(agentId: string, latestMessage: string, conversationHistory: MJConversationDetailEntity[], context: ArtifactLookupContext): Promise<IntentCheckResult>;
-    /**
-     * Clear the session for a conversation (useful when starting a new topic)
-     */
-    clearSession(conversationId: string): void;
-    /**
-     * Filter agents based on user's 'run' permission.
-     * Only returns agents that the user has permission to run.
-     *
-     * @param agents List of candidate agents to filter
-     * @param user User to check permissions for
-     * @returns Filtered list of agents the user can run
-     */
-    private filterAgentsByPermissions;
     /**
      * Find all artifacts created by the specified agent in this conversation.
      * Returns artifacts grouped by artifact with versions, ordered most recent first.

package/dist/lib/services/conversation-agent.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-agent.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/conversation-agent.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"conversation-agent.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/conversation-agent.service.ts"],"names":[],"mappings":"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"}