@memberjunction/conversations-runtime 0.0.1 → 5.41.0

package/dist/agent-runner/ConversationAgentRunner.js

@@ -0,0 +1,191 @@
+/**
+ * @fileoverview Pure-TypeScript agent-run pipeline for conversations.
+ *
+ * Ported from `@memberjunction/ng-conversations/src/lib/services/conversation-agent.service.ts`,
+ * scoped to the core `processMessage` flow. The Angular service's other helpers
+ * (intent checking, sub-agent invocation, artifact lookup, configuration-preset
+ * lookup) stay in the widget for now and can move in a follow-up — they aren't
+ * needed to invoke an agent end-to-end.
+ *
+ * Replaces three Angular bindings from the original:
+ * - `MJNotificationService.Instance.CreateSimpleNotification(...)` →
+ *   {@link IConversationsRuntimeContext.Notification}.
+ * - `AgentClientService` (Angular wrapper over `AgentClientSession`) →
+ *   `AgentClientSession` used directly (already pure-TS).
+ * - Hardcoded `Agents.find(a => a.Name === 'Sage')` → {@link DefaultAgentResolver}.
+ *
+ * @module @memberjunction/conversations-runtime
+ */
+import { BehaviorSubject } from 'rxjs';
+import { Metadata } from '@memberjunction/core';
+import { UUIDsEqual } from '@memberjunction/global';
+import { AgentClientSession, } from '@memberjunction/ai-agent-client';
+import { AIEngineBase, AIAgentPermissionHelper, } from '@memberjunction/ai-engine-base';
+/**
+ * Core agent-run orchestrator. Wraps {@link AgentClientSession.RunAgentFromConversationDetail}
+ * with conversation-aware glue: default-agent resolution, permission-filtered
+ * candidate list for Sage's routing decisions, processing-state observable, and
+ * adapter-routed user notifications.
+ *
+ * Usually accessed via `ConversationsRuntime.Instance.AgentRunner`.
+ */
+export class ConversationAgentRunner {
+    /**
+     * @param context Runtime context — used for notifications. Read on each call
+     *     so adapter swaps after construction are picked up immediately.
+     * @param toolRegistry Shared `ClientToolRegistry` — the runner's internal
+     *     `AgentClientSession` uses this so tools registered on
+     *     `ConversationsRuntime.Tools` are visible to the agent.
+     * @param resolver The runtime's `DefaultAgentResolver` — used to pick the
+     *     conversation manager agent when no explicit ID is supplied.
+     */
+    constructor(context, toolRegistry, resolver) {
+        this.context = context;
+        this.resolver = resolver;
+        this._isProcessing$ = new BehaviorSubject(false);
+        this._provider = null;
+        /** Emits `true` while an agent run is in flight, `false` otherwise. */
+        this.isProcessing$ = this._isProcessing$.asObservable();
+        this.session = new AgentClientSession(toolRegistry);
+    }
+    /**
+     * Metadata provider — falls back to `Metadata.Provider` when unset. Setting
+     * this forwards the provider to the internal `AgentClientSession` so GraphQL
+     * calls target the right server in multi-provider scenarios.
+     */
+    get Provider() {
+        return this._provider ?? Metadata.Provider;
+    }
+    set Provider(value) {
+        this._provider = value;
+        this.session.Provider = value;
+    }
+    /**
+     * Process a user message through the default conversation manager agent. Mirrors
+     * the original service's `processMessage(...)` flow, but with the three Angular
+     * deps replaced (notification adapter, default-agent resolver, direct
+     * `AgentClientSession`).
+     *
+     * @returns The agent's `ExecuteAgentResult`, or `null` if the agent failed and
+     *     a notification was surfaced.
+     */
+    async processMessage(input) {
+        const agent = await this.resolveAgent(input);
+        if (!agent)
+            return null;
+        try {
+            this._isProcessing$.next(true);
+            const currentUser = this.Provider.CurrentUser;
+            if (!currentUser) {
+                console.warn('[ConversationAgentRunner] No current user available for permission filtering; using unfiltered agent list.');
+            }
+            const candidateAgents = AIEngineBase.Instance.Agents.filter((a) => !UUIDsEqual(a.ID, agent.ID) &&
+                !a.ParentID &&
+                a.Status === 'Active' &&
+                a.InvocationMode !== 'Sub-Agent');
+            const availableAgents = currentUser
+                ? await this.filterAgentsByPermissions(candidateAgents, currentUser)
+                : candidateAgents;
+            console.log(`[ConversationAgentRunner] Available agents for routing: ${availableAgents.length} (filtered from ${candidateAgents.length} candidates)`);
+            const agentParams = {
+                ConversationDetailId: input.conversationDetailId,
+                AgentId: agent.ID,
+                MaxHistoryMessages: 20,
+                Data: {
+                    ALL_AVAILABLE_AGENTS: availableAgents.map((a) => ({
+                        ID: a.ID,
+                        Name: a.Name,
+                        Description: a.Description,
+                    })),
+                    conversationId: input.conversationId,
+                    latestMessageId: input.message.ID,
+                    ...(input.appContext ? { appContext: input.appContext } : {}),
+                    // Forward registered client tools so the LLM sees them in the prompt.
+                    clientTools: this.session
+                        .GetRegisteredTools()
+                        .map((t) => ({
+                        Name: t.Name,
+                        Description: t.Description,
+                        InputSchema: t.ParameterSchema,
+                    })),
+                },
+                CreateArtifacts: true,
+                CreateNotification: true,
+                OnProgress: input.onProgress
+                    ? (progress) => input.onProgress({
+                        step: progress.CurrentStep,
+                        percentage: progress.Percentage,
+                        message: progress.Message,
+                        metadata: progress.Metadata,
+                    })
+                    : undefined,
+            };
+            const runResult = await this.session.RunAgentFromConversationDetail(agentParams);
+            if (runResult.Success && runResult.Result) {
+                return runResult.Result;
+            }
+            if (!runResult.Success) {
+                const errorMsg = runResult.ErrorMessage ?? 'Agent execution failed';
+                console.error('[ConversationAgentRunner] Agent execution failed:', errorMsg);
+                this.context.Notification.Notify('error', errorMsg, 5_000);
+                return null;
+            }
+            return null;
+        }
+        catch (error) {
+            const errorMsg = 'Error processing message through agent: ' +
+                (error instanceof Error ? error.message : String(error));
+            console.error('[ConversationAgentRunner] Error processing message:', error);
+            this.context.Notification.Notify('error', errorMsg, 5_000);
+            return null;
+        }
+        finally {
+            this._isProcessing$.next(false);
+        }
+    }
+    /**
+     * Resolve the agent that should handle this turn — explicit ID wins, then the
+     * Application Settings chain, then the Sage code-const fallback. Surfaces a
+     * notification on failure rather than throwing, so the caller (UI thread)
+     * sees a friendly message.
+     */
+    async resolveAgent(input) {
+        try {
+            return await this.resolver.resolve({
+                explicitAgentId: input.explicitAgentId,
+                applicationId: input.applicationId,
+                contextUser: this.Provider.CurrentUser ?? undefined,
+                provider: this.Provider,
+            });
+        }
+        catch (error) {
+            const errorMsg = 'Could not resolve a default conversation manager agent: ' +
+                (error instanceof Error ? error.message : String(error));
+            console.error('[ConversationAgentRunner] Agent resolution failed:', error);
+            this.context.Notification.Notify('error', errorMsg, 5_000);
+            return null;
+        }
+    }
+    /**
+     * Filter agents by the user's `run` permission. Identical to the original
+     * service's helper — fails closed on per-agent error so we never expose an
+     * agent the user shouldn't see.
+     */
+    async filterAgentsByPermissions(agents, user) {
+        const permittedAgents = [];
+        for (const agent of agents) {
+            try {
+                const hasPermission = await AIAgentPermissionHelper.HasPermission(agent.ID, user, 'run');
+                if (hasPermission) {
+                    permittedAgents.push(agent);
+                }
+            }
+            catch (error) {
+                console.error(`[ConversationAgentRunner] Error checking permission for agent ${agent.Name}:`, error);
+                // Fail closed — exclude on error.
+            }
+        }
+        return permittedAgents;
+    }
+}
+//# sourceMappingURL=ConversationAgentRunner.js.map

package/dist/agent-runner/ConversationAgentRunner.js.map

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

package/dist/bridge/ConversationBridge.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @fileoverview Pure-TypeScript bridge between conversation surfaces.
+ *
+ * Ported from `@memberjunction/ng-conversations/src/lib/services/conversation-bridge.service.ts`.
+ * The original was pure RxJS — the `@Injectable()` decorator was the only Angular dep. Stripped
+ * that, kept the API identical, renamed `ConversationBridgeService` → `ConversationBridge`
+ * (no "Service" suffix since this layer doesn't use Angular DI).
+ *
+ * Coordinates active-conversation state across multiple surfaces:
+ * - the corner overlay (`mj-chat-agents-overlay`)
+ * - the full-page Chat workspace (`mj-chat-conversations-resource`)
+ * - any future composite surface (e.g., embedded panels in dashboards)
+ *
+ * @module @memberjunction/conversations-runtime
+ */
+import { BehaviorSubject, Subject } from 'rxjs';
+/** Event emitted when switching between overlay and workspace surfaces. */
+export interface ConversationSwitchEvent {
+    /** The conversation ID being transferred. */
+    ConversationID: string | null;
+    /** Surface initiating the switch. */
+    Source: 'overlay' | 'workspace' | 'deep-link';
+    /** Surface that should pick up the conversation. */
+    Target: 'overlay' | 'workspace';
+}
+/** Deep-link parameters for navigating directly to a conversation. */
+export interface ConversationDeepLink {
+    ConversationID: string;
+    /** Optional: scroll to a specific message after opening. */
+    MessageID?: string;
+    /** Optional: auto-open the overlay or workspace. */
+    OpenIn?: 'overlay' | 'workspace';
+}
+/**
+ * Shared state between conversation surfaces. Pure observable hub — knows nothing about
+ * any specific UI framework. Consumers subscribe to the streams they care about.
+ *
+ * Usually accessed via `ConversationsRuntime.Instance.Bridge`.
+ */
+export declare class ConversationBridge {
+    /** The currently active conversation ID shared between overlay and workspace. */
+    ActiveConversationID$: BehaviorSubject<string | null>;
+    /** Whether the overlay surface is currently active (expanded). */
+    OverlayActive$: BehaviorSubject<boolean>;
+    /** Whether the full workspace surface is currently active (visible). */
+    WorkspaceActive$: BehaviorSubject<boolean>;
+    /** Events emitted when switching between overlay and workspace. */
+    SwitchEvent$: Subject<ConversationSwitchEvent>;
+    /** Deep-link navigation requests. */
+    DeepLinkRequest$: Subject<ConversationDeepLink>;
+    /**
+     * "Expand the overlay" requests from anywhere in the app — typically a dashboard's
+     * "Refine with AI" button that wants to pop the chat after setting fresh AppContext.
+     * The mounted overlay subscribes and calls its own `Expand()` in response. Decoupled
+     * this way because the overlay component reference isn't reachable from arbitrary
+     * callers, and we don't want everyone to take a hard dep on the overlay class.
+     */
+    ExpandOverlayRequested$: Subject<void>;
+    /** Ask the overlay to expand. Idempotent if already expanded. */
+    RequestExpandOverlay(): void;
+    /**
+     * Set the active conversation from the overlay. The workspace picks up the change
+     * automatically via the shared `ActiveConversationID$` stream.
+     */
+    SetActiveFromOverlay(conversationId: string | null): void;
+    /**
+     * Set the active conversation from the workspace. The overlay picks up the change
+     * automatically via the shared `ActiveConversationID$` stream.
+     */
+    SetActiveFromWorkspace(conversationId: string | null): void;
+    /**
+     * Request switching from overlay to full workspace. The overlay should minimize;
+     * the workspace should open with the same conversation.
+     */
+    SwitchToWorkspace(conversationId: string | null): void;
+    /**
+     * Request switching from workspace to overlay. The workspace can stay open, but the
+     * overlay resumes the conversation.
+     */
+    SwitchToOverlay(conversationId: string | null): void;
+    /** Navigate to a specific conversation via deep link. */
+    NavigateToConversation(deepLink: ConversationDeepLink): void;
+    /** Notify that the overlay is now active (or inactive). */
+    NotifyOverlayActive(active: boolean): void;
+    /** Notify that the workspace is now active (or inactive). */
+    NotifyWorkspaceActive(active: boolean): void;
+    /**
+     * `true` when the workspace is not active but there's an active conversation —
+     * i.e., the overlay should resume that conversation when expanded.
+     */
+    ShouldResumeInOverlay(): boolean;
+}
+//# sourceMappingURL=ConversationBridge.d.ts.map

package/dist/bridge/ConversationBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationBridge.d.ts","sourceRoot":"","sources":["../../src/bridge/ConversationBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEhD,2EAA2E;AAC3E,MAAM,WAAW,uBAAuB;IACpC,6CAA6C;IAC7C,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,qCAAqC;IACrC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC;IAC9C,oDAAoD;IACpD,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;CACnC;AAED,sEAAsE;AACtE,MAAM,WAAW,oBAAoB;IACjC,cAAc,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,CAAC;CACpC;AAED;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC3B,iFAAiF;IAC1E,qBAAqB,iCAA4C;IAExE,kEAAkE;IAC3D,cAAc,2BAAuC;IAE5D,wEAAwE;IACjE,gBAAgB,2BAAuC;IAE9D,mEAAmE;IAC5D,YAAY,mCAA0C;IAE7D,qCAAqC;IAC9B,gBAAgB,gCAAuC;IAE9D;;;;;;OAMG;IACI,uBAAuB,gBAAuB;IAErD,iEAAiE;IAC1D,oBAAoB,IAAI,IAAI;IAInC;;;OAGG;IACI,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIhE;;;OAGG;IACI,sBAAsB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIlE;;;OAGG;IACI,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAQ7D;;;OAGG;IACI,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAQ3D,yDAAyD;IAClD,sBAAsB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;IAKnE,2DAA2D;IACpD,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAIjD,6DAA6D;IACtD,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAInD;;;OAGG;IACI,qBAAqB,IAAI,OAAO;CAG1C"}

package/dist/bridge/ConversationBridge.js

@@ -0,0 +1,105 @@
+/**
+ * @fileoverview Pure-TypeScript bridge between conversation surfaces.
+ *
+ * Ported from `@memberjunction/ng-conversations/src/lib/services/conversation-bridge.service.ts`.
+ * The original was pure RxJS — the `@Injectable()` decorator was the only Angular dep. Stripped
+ * that, kept the API identical, renamed `ConversationBridgeService` → `ConversationBridge`
+ * (no "Service" suffix since this layer doesn't use Angular DI).
+ *
+ * Coordinates active-conversation state across multiple surfaces:
+ * - the corner overlay (`mj-chat-agents-overlay`)
+ * - the full-page Chat workspace (`mj-chat-conversations-resource`)
+ * - any future composite surface (e.g., embedded panels in dashboards)
+ *
+ * @module @memberjunction/conversations-runtime
+ */
+import { BehaviorSubject, Subject } from 'rxjs';
+/**
+ * Shared state between conversation surfaces. Pure observable hub — knows nothing about
+ * any specific UI framework. Consumers subscribe to the streams they care about.
+ *
+ * Usually accessed via `ConversationsRuntime.Instance.Bridge`.
+ */
+export class ConversationBridge {
+    constructor() {
+        /** The currently active conversation ID shared between overlay and workspace. */
+        this.ActiveConversationID$ = new BehaviorSubject(null);
+        /** Whether the overlay surface is currently active (expanded). */
+        this.OverlayActive$ = new BehaviorSubject(false);
+        /** Whether the full workspace surface is currently active (visible). */
+        this.WorkspaceActive$ = new BehaviorSubject(false);
+        /** Events emitted when switching between overlay and workspace. */
+        this.SwitchEvent$ = new Subject();
+        /** Deep-link navigation requests. */
+        this.DeepLinkRequest$ = new Subject();
+        /**
+         * "Expand the overlay" requests from anywhere in the app — typically a dashboard's
+         * "Refine with AI" button that wants to pop the chat after setting fresh AppContext.
+         * The mounted overlay subscribes and calls its own `Expand()` in response. Decoupled
+         * this way because the overlay component reference isn't reachable from arbitrary
+         * callers, and we don't want everyone to take a hard dep on the overlay class.
+         */
+        this.ExpandOverlayRequested$ = new Subject();
+    }
+    /** Ask the overlay to expand. Idempotent if already expanded. */
+    RequestExpandOverlay() {
+        this.ExpandOverlayRequested$.next();
+    }
+    /**
+     * Set the active conversation from the overlay. The workspace picks up the change
+     * automatically via the shared `ActiveConversationID$` stream.
+     */
+    SetActiveFromOverlay(conversationId) {
+        this.ActiveConversationID$.next(conversationId);
+    }
+    /**
+     * Set the active conversation from the workspace. The overlay picks up the change
+     * automatically via the shared `ActiveConversationID$` stream.
+     */
+    SetActiveFromWorkspace(conversationId) {
+        this.ActiveConversationID$.next(conversationId);
+    }
+    /**
+     * Request switching from overlay to full workspace. The overlay should minimize;
+     * the workspace should open with the same conversation.
+     */
+    SwitchToWorkspace(conversationId) {
+        this.SwitchEvent$.next({
+            ConversationID: conversationId,
+            Source: 'overlay',
+            Target: 'workspace',
+        });
+    }
+    /**
+     * Request switching from workspace to overlay. The workspace can stay open, but the
+     * overlay resumes the conversation.
+     */
+    SwitchToOverlay(conversationId) {
+        this.SwitchEvent$.next({
+            ConversationID: conversationId,
+            Source: 'workspace',
+            Target: 'overlay',
+        });
+    }
+    /** Navigate to a specific conversation via deep link. */
+    NavigateToConversation(deepLink) {
+        this.ActiveConversationID$.next(deepLink.ConversationID);
+        this.DeepLinkRequest$.next(deepLink);
+    }
+    /** Notify that the overlay is now active (or inactive). */
+    NotifyOverlayActive(active) {
+        this.OverlayActive$.next(active);
+    }
+    /** Notify that the workspace is now active (or inactive). */
+    NotifyWorkspaceActive(active) {
+        this.WorkspaceActive$.next(active);
+    }
+    /**
+     * `true` when the workspace is not active but there's an active conversation —
+     * i.e., the overlay should resume that conversation when expanded.
+     */
+    ShouldResumeInOverlay() {
+        return !this.WorkspaceActive$.value && this.ActiveConversationID$.value !== null;
+    }
+}
+//# sourceMappingURL=ConversationBridge.js.map

package/dist/bridge/ConversationBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationBridge.js","sourceRoot":"","sources":["../../src/bridge/ConversationBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAqBhD;;;;;GAKG;AACH,MAAM,OAAO,kBAAkB;IAA/B;QACI,iFAAiF;QAC1E,0BAAqB,GAAG,IAAI,eAAe,CAAgB,IAAI,CAAC,CAAC;QAExE,kEAAkE;QAC3D,mBAAc,GAAG,IAAI,eAAe,CAAU,KAAK,CAAC,CAAC;QAE5D,wEAAwE;QACjE,qBAAgB,GAAG,IAAI,eAAe,CAAU,KAAK,CAAC,CAAC;QAE9D,mEAAmE;QAC5D,iBAAY,GAAG,IAAI,OAAO,EAA2B,CAAC;QAE7D,qCAAqC;QAC9B,qBAAgB,GAAG,IAAI,OAAO,EAAwB,CAAC;QAE9D;;;;;;WAMG;QACI,4BAAuB,GAAG,IAAI,OAAO,EAAQ,CAAC;IAsEzD,CAAC;IApEG,iEAAiE;IAC1D,oBAAoB;QACvB,IAAI,CAAC,uBAAuB,CAAC,IAAI,EAAE,CAAC;IACxC,CAAC;IAED;;;OAGG;IACI,oBAAoB,CAAC,cAA6B;QACrD,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACpD,CAAC;IAED;;;OAGG;IACI,sBAAsB,CAAC,cAA6B;QACvD,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACpD,CAAC;IAED;;;OAGG;IACI,iBAAiB,CAAC,cAA6B;QAClD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;YACnB,cAAc,EAAE,cAAc;YAC9B,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,WAAW;SACtB,CAAC,CAAC;IACP,CAAC;IAED;;;OAGG;IACI,eAAe,CAAC,cAA6B;QAChD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;YACnB,cAAc,EAAE,cAAc;YAC9B,MAAM,EAAE,WAAW;YACnB,MAAM,EAAE,SAAS;SACpB,CAAC,CAAC;IACP,CAAC;IAED,yDAAyD;IAClD,sBAAsB,CAAC,QAA8B;QACxD,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;QACzD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,2DAA2D;IACpD,mBAAmB,CAAC,MAAe;QACtC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,6DAA6D;IACtD,qBAAqB,CAAC,MAAe;QACxC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAED;;;OAGG;IACI,qBAAqB;QACxB,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,KAAK,IAAI,IAAI,CAAC,qBAAqB,CAAC,KAAK,KAAK,IAAI,CAAC;IACrF,CAAC;CACJ"}

package/dist/context/IConversationsRuntimeContext.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Shared context interface — what sub-components see of the runtime.
+ *
+ * Sub-components (`ConversationStreaming`, `ConversationAgentRunner`, etc.) need to
+ * reach the currently-registered adapters at the moment they fire, NOT at the
+ * moment they were constructed. The host may call
+ * `runtime.UseNotificationAdapter(...)` after sub-components already exist.
+ *
+ * Rather than have each sub-component import `ConversationsRuntime` (which would
+ * create a circular module import — runtime imports sub-component to construct it,
+ * sub-component imports runtime to read adapters), we extract this narrow contract.
+ * The runtime implements it; sub-components take it as a constructor parameter.
+ *
+ * Because the runtime is passed by reference and the methods are getters, every
+ * sub-component call reads the *current* adapter — adapter swaps take effect
+ * immediately without rebuilding sub-components.
+ *
+ * @module @memberjunction/conversations-runtime
+ */
+import { INotificationAdapter } from '../adapters/INotificationAdapter.js';
+import { IActiveTaskTracker } from '../adapters/IActiveTaskTracker.js';
+/** Read-only view of the runtime's adapter slots, as seen by sub-components. */
+export interface IConversationsRuntimeContext {
+    /** Currently registered notification adapter (or the console default). */
+    readonly Notification: INotificationAdapter;
+    /** Currently registered active-task tracker (or the no-op default). */
+    readonly Tasks: IActiveTaskTracker;
+}
+//# sourceMappingURL=IConversationsRuntimeContext.d.ts.map

package/dist/context/IConversationsRuntimeContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IConversationsRuntimeContext.d.ts","sourceRoot":"","sources":["../../src/context/IConversationsRuntimeContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE,gFAAgF;AAChF,MAAM,WAAW,4BAA4B;IACzC,0EAA0E;IAC1E,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAE5C,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;CACtC"}

package/dist/context/IConversationsRuntimeContext.js

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Shared context interface — what sub-components see of the runtime.
+ *
+ * Sub-components (`ConversationStreaming`, `ConversationAgentRunner`, etc.) need to
+ * reach the currently-registered adapters at the moment they fire, NOT at the
+ * moment they were constructed. The host may call
+ * `runtime.UseNotificationAdapter(...)` after sub-components already exist.
+ *
+ * Rather than have each sub-component import `ConversationsRuntime` (which would
+ * create a circular module import — runtime imports sub-component to construct it,
+ * sub-component imports runtime to read adapters), we extract this narrow contract.
+ * The runtime implements it; sub-components take it as a constructor parameter.
+ *
+ * Because the runtime is passed by reference and the methods are getters, every
+ * sub-component call reads the *current* adapter — adapter swaps take effect
+ * immediately without rebuilding sub-components.
+ *
+ * @module @memberjunction/conversations-runtime
+ */
+export {};
+//# sourceMappingURL=IConversationsRuntimeContext.js.map

package/dist/context/IConversationsRuntimeContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IConversationsRuntimeContext.js","sourceRoot":"","sources":["../../src/context/IConversationsRuntimeContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG"}

package/dist/default-agent/DefaultAgentResolver.d.ts

@@ -0,0 +1,87 @@
+/**
+ * @fileoverview Default-agent resolution chain.
+ *
+ * Replaces the hardcoded `Agents.find(a => a.Name === 'Sage')` lookup that previously lived
+ * in three places inside `@memberjunction/ng-conversations` with a metadata-driven chain
+ * routed through `MJ: Application Settings`.
+ *
+ * Resolution order on every {@link DefaultAgentResolver.resolve} call:
+ *
+ * 1. **Explicit `explicitAgentId`** on the call (matches the widget's `[DefaultAgentId]`
+ *    `@Input` — already works today, preserved here for layering).
+ * 2. **App-scoped `MJ: Application Settings`** row (`ApplicationID = <current app>`,
+ *    `Name = 'Conversations.DefaultAgentID'`, `Value = <agent ID>`).
+ * 3. **Global `MJ: Application Settings`** row (`ApplicationID IS NULL`, same name).
+ *    Ships as a metadata seed pointing at Sage on a fresh install.
+ * 4. **Code-const fallback** — `Agents.find(a => a.Name === 'Sage')`. Safety net for
+ *    installs where the seed was skipped; preserves today's behavior so the system never
+ *    silently fails to route a turn.
+ *
+ * Steps 2 and 3 are handled by `ApplicationSettingEngine.GetSetting` in one call — that API
+ * already does app-scoped-first / global-fallback resolution internally.
+ *
+ * @module @memberjunction/conversations-runtime
+ */
+import { IMetadataProvider, UserInfo } from '@memberjunction/core';
+import { MJAIAgentEntityExtended } from '@memberjunction/ai-core-plus';
+/**
+ * Options accepted by {@link DefaultAgentResolver.resolve}. Every field is optional;
+ * callers typically pass `applicationId` when an embedder has app context, and the rest
+ * fall through to defaults.
+ */
+export interface DefaultAgentResolveOptions {
+    /**
+     * If supplied AND a matching agent exists, this wins immediately (step 1).
+     * Mirrors the widget's `[DefaultAgentId]` `@Input` — used by Form Builder, Component
+     * Studio AI Assistant, and any future embedder that pins a specific agent.
+     */
+    explicitAgentId?: string | null;
+    /**
+     * Application context for the conversation. When supplied, an app-scoped Application
+     * Setting (step 2) takes precedence over the global default (step 3).
+     */
+    applicationId?: string | null;
+    /** Context user — passed to engines that need it on the server side. */
+    contextUser?: UserInfo;
+    /** Metadata provider to bind to — falls back to `Metadata.Provider`. */
+    provider?: IMetadataProvider;
+}
+/**
+ * Resolves the default agent for a conversation turn.
+ *
+ * Usually accessed via `ConversationsRuntime.Instance.DefaultAgent`. Stateless beyond
+ * lazy delegation to `ApplicationSettingEngine` and `AIEngineBase`.
+ */
+export declare class DefaultAgentResolver {
+    /** Application Setting key consulted in steps 2 and 3. */
+    static readonly SETTING_NAME = "Conversations.DefaultAgentID";
+    /**
+     * Last-resort fallback agent name (step 4). Kept as a constant rather than another
+     * setting so the system has a hard floor even if metadata sync has never run on a
+     * fresh install — preserves today's "Sage is the default" behavior unconditionally.
+     */
+    static readonly FALLBACK_AGENT_NAME = "Sage";
+    /**
+     * Resolve the default agent for this turn. Walks the 4-step chain; throws a descriptive
+     * error if every step misses (vs. the previous code path's silent `null` return, which
+     * made misconfigurations hard to spot at the call site).
+     *
+     * @example
+     * ```typescript
+     * const agent = await runtime.DefaultAgent.resolve({
+     *     explicitAgentId: widgetInput.DefaultAgentId,   // wins if non-null and matches
+     *     applicationId: currentAppId,                    // scopes the settings lookup
+     *     contextUser: this.ProviderToUse.CurrentUser,
+     *     provider: this.ProviderToUse,
+     * });
+     * ```
+     */
+    resolve(options?: DefaultAgentResolveOptions): Promise<MJAIAgentEntityExtended>;
+    /**
+     * Find an agent by ID from the AIEngineBase cache. Returns `undefined` if not found.
+     * Uses {@link UUIDsEqual} per the standing rule about comparing UUIDs across
+     * SQL Server / Postgres (case differences would silently miss).
+     */
+    private findAgentById;
+}
+//# sourceMappingURL=DefaultAgentResolver.d.ts.map

package/dist/default-agent/DefaultAgentResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultAgentResolver.d.ts","sourceRoot":"","sources":["../../src/default-agent/DefaultAgentResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAGvE;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACvC;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEhC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B,wEAAwE;IACxE,WAAW,CAAC,EAAE,QAAQ,CAAC;IAEvB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAChC;AAED;;;;;GAKG;AACH,qBAAa,oBAAoB;IAC7B,0DAA0D;IAC1D,gBAAuB,YAAY,kCAAkC;IAErE;;;;OAIG;IACH,gBAAuB,mBAAmB,UAAU;IAEpD;;;;;;;;;;;;;;OAcG;IACU,OAAO,CAAC,OAAO,GAAE,0BAA+B,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAkDhG;;;;OAIG;IACH,OAAO,CAAC,aAAa;CAGxB"}