@memberjunction/server 6.2.0-edge.0 → 6.2.0-edge.1

package/dist/resolvers/RealtimeBridgeResolver.js

@@ -20,7 +20,7 @@ import { CreateBridgeRealtimeSession, FinalizeBridgeCoAgentRuns, GetRealtimeMode
 import { AIBridgeEngine } from '@memberjunction/ai-bridge-server';
 import { SessionManager } from '../agentSessions/SessionManager.js';
 import { NotificationEngine } from '@memberjunction/notifications';
-import { registerMeetingRecordingFile, correlateRecordingStart } from './meetingRecordingRegistration.js';
+import { RegisterMeetingRecordingFile, CorrelateRecordingStart } from './meetingRecordingRegistration.js';
 /**
  * Binds the agent realtime-session factory onto the LiveKit room coordinator's model-session creation seam.
  * Module-load side effect — it runs when MJServer builds its GraphQL schema (which imports this resolver),
@@ -477,7 +477,7 @@ let RealtimeBridgeResolver = class RealtimeBridgeResolver extends ResolverBase {
             // Best-effort: correlate the live recording with the room's Meeting-Room Conversation (if it exists
             // yet) by stamping its EgressID. Never fail the start on this — the stop-flow resolves/creates it.
             const provider = GetReadWriteProvider(context.providers);
-            void correlateRecordingStart(input.RoomName, info.EgressID, user, provider);
+            void CorrelateRecordingStart(input.RoomName, info.EgressID, user, provider);
             return { Success: true, EgressID: info.EgressID, Status: info.Status };
         }
         catch (error) {
@@ -503,7 +503,7 @@ let RealtimeBridgeResolver = class RealtimeBridgeResolver extends ResolverBase {
             // Register the completed egress MP4 as a Files row on the Meeting-Room Conversation. Best-effort:
             // any failure (e.g. storage provider not configured) leaves RecordingFileID unset but still
             // returns the successful stop result.
-            const registration = await registerMeetingRecordingFile({ EgressID: info.EgressID, RoomName: info.RoomName, OutputLocation: info.OutputLocation, OutputSizeBytes: info.OutputSizeBytes }, user, provider);
+            const registration = await RegisterMeetingRecordingFile({ EgressID: info.EgressID, RoomName: info.RoomName, OutputLocation: info.OutputLocation, OutputSizeBytes: info.OutputSizeBytes }, user, provider);
             if (!registration.Success) {
                 LogError(`StopLiveKitRecording: recording stopped but registration did not complete: ${registration.ErrorMessage ?? 'unknown'}`);
             }

package/dist/resolvers/RealtimeClientSessionResolver.js

@@ -45,7 +45,7 @@ import { RealtimeClientSessionService, RealtimeChannelServerHost, EvaluateRuntim
 import { ResolverBase } from '../generic/ResolverBase.js';
 import { GetReadWriteProvider } from '../util.js';
 import { SessionManager } from '../agentSessions/index.js';
-import { resolveWidgetGuestRunContext, ResolveScopedAnonymousRunUser } from '../realtimeWidget/widgetGuestElevation.js';
+import { ResolveWidgetGuestRunContext, ResolveScopedAnonymousRunUser } from '../realtimeWidget/widgetGuestElevation.js';
 /**
  * Progress steps worth narrating to the realtime model — mirrors the normal agent-run path's filter
  * in {@link import('./RunAIAgentResolver.js').RunAIAgentResolver}. Initialization/validation/finalization
@@ -2060,8 +2060,8 @@ let RealtimeClientSessionResolver = class RealtimeClientSessionResolver extends
      * than blocking the start.
      */
     async resolveWidgetVoiceCapSeconds(userPayload, providers) {
-        const elevation = await resolveWidgetGuestRunContext(userPayload, GetReadWriteProvider(providers));
-        const minutes = elevation?.widget.VoiceMaxSessionMinutes;
+        const elevation = await ResolveWidgetGuestRunContext(userPayload, GetReadWriteProvider(providers));
+        const minutes = elevation?.Widget.VoiceMaxSessionMinutes;
         return minutes && minutes > 0 ? minutes * 60 : undefined;
     }
     /**

package/dist/resolvers/RemoteBrowserActionResolver.js

@@ -32,7 +32,7 @@ import { Resolver, Mutation, Query, Arg, Ctx, Float, Int, ObjectType, Field, Pub
 import { LogError } from '@memberjunction/core';
 import { UUIDsEqual } from '@memberjunction/global';
 import { NormalizeInstanceKey, RemoteBrowserEngine } from '@memberjunction/remote-browser-server';
-import { beginBrowserGoalStep, finalizeBrowserGoalStep, extractCoAgentRunID } from '../agentSessions/remoteBrowserGoalEngine.js';
+import { BeginBrowserGoalStep, FinalizeBrowserGoalStep, ExtractCoAgentRunID } from '../agentSessions/remoteBrowserGoalEngine.js';
 import { RemoteBrowserGoalRegistry } from '../agentSessions/remoteBrowserGoalRegistry.js';
 import { randomUUID } from 'node:crypto';
 import { RemoteBrowserCapabilityNotSupportedError, } from '@memberjunction/remote-browser-base';
@@ -377,8 +377,8 @@ let RemoteBrowserActionResolver = class RemoteBrowserActionResolver extends Reso
         const providerName = await this.resolveProviderName(session, contextUser, provider);
         // Observability: nest this goal's many prompt runs under ONE "Browser goal" step on the realtime
         // co-agent run (when the session has one). Best-effort — a null step just means the goal runs unlinked.
-        const coAgentRunID = extractCoAgentRunID(session.Config_);
-        const goalStep = await beginBrowserGoalStep(provider, contextUser, coAgentRunID, goal);
+        const coAgentRunID = ExtractCoAgentRunID(session.Config_);
+        const goalStep = await BeginBrowserGoalStep(provider, contextUser, coAgentRunID, goal);
         // ASYNC START: a goal loop can run for minutes; do NOT hold this request open for it (browser
         // fetch / proxy / janitor timeouts would kill the request while the loop runs on, and the agent
         // would get "no response from the server" despite a successful run). Register the run, kick the
@@ -396,14 +396,14 @@ let RemoteBrowserActionResolver = class RemoteBrowserActionResolver extends Reso
             AgentRunStepID: goalStep?.ID,
         })
             .then(async (result) => {
-            await finalizeBrowserGoalStep(goalStep, result);
+            await FinalizeBrowserGoalStep(goalStep, result);
             RemoteBrowserGoalRegistry.Instance.Complete(agentSessionID, goalRunID, result);
         })
             .catch(async (err) => {
             const message = err instanceof Error ? err.message : String(err);
             LogError(`ExecuteRemoteBrowserGoal failed (provider='${providerName}'): ${message}`);
             const failure = { Success: false, Status: 'Error', Detail: `Remote browser error (${providerName}): ${message}` };
-            await finalizeBrowserGoalStep(goalStep, failure);
+            await FinalizeBrowserGoalStep(goalStep, failure);
             RemoteBrowserGoalRegistry.Instance.Complete(agentSessionID, goalRunID, failure);
         });
         return { Success: true, Status: 'Running', GoalRunID: goalRunID, Detail: 'Goal started.' };

package/dist/resolvers/RunAIAgentResolver.d.ts

@@ -79,8 +79,8 @@ export declare class RunAIAgentResolver extends ResolverBase {
      * Create streaming progress callback
      */
     private createProgressCallback;
-    private PublishProgressUpdate;
-    private PublishStreamingUpdate;
+    private publishProgressUpdate;
+    private publishStreamingUpdate;
     /**
      * Create streaming content callback
      */
@@ -156,7 +156,13 @@ export declare class RunAIAgentResolver extends ResolverBase {
      * @param agentId - The agent to execute
      * @param maxHistoryMessages - Maximum number of history messages to include (default: 20)
      */
-    RunAIAgentFromConversationDetail(conversationDetailId: string, agentId: string, { userPayload, providers, dataSource }: AppContext, sessionId: string, pubSub: PubSubEngine, maxHistoryMessages?: number, data?: string, payload?: string, lastRunId?: string, autoPopulateLastRunPayload?: boolean, configurationId?: string, createArtifacts?: boolean, createNotification?: boolean, sourceArtifactId?: string, sourceArtifactVersionId?: string, fireAndForget?: boolean, planMode?: boolean, requestedSkillIDs?: string[]): Promise<AIAgentRunResult>;
+    RunAIAgentFromConversationDetail(conversationDetailId: string, agentId: string, { userPayload, providers, dataSource }: AppContext, sessionId: string, pubSub: PubSubEngine, maxHistoryMessages?: number, data?: string, payload?: string, lastRunId?: string, autoPopulateLastRunPayload?: boolean, configurationId?: string, createArtifacts?: boolean, createNotification?: boolean, sourceArtifactId?: string, sourceArtifactVersionId?: string, fireAndForget?: boolean, planMode?: boolean, requestedSkillIDs?: string[], 
+    /** History floor: an ISO-8601 timestamp, the first moment of the conversation this run may
+     *  read. The history is loaded from there and no summary of earlier messages is used, and the
+     *  run's own conversation reads honour it too. Omitted (clients send it only when set, so an
+     *  older client never does), the run reads the whole conversation as before. An unreadable
+     *  value fails the request rather than being dropped. */
+    agentHistoryFrom?: string): Promise<AIAgentRunResult>;
     /**
      * Respond to a pending AIAgentRequest from the dashboard or API.
      * Updates the request record with the response and optionally spawns a
@@ -189,7 +195,7 @@ export declare class RunAIAgentResolver extends ResolverBase {
      *
      * Opt #8: Switched from ResultType 'entity_object' to 'simple' with explicit Fields.
      * The history query only needs the window-assembly fields (ConversationWindowFields:
-     * ID, Sequence, Role, Message, SummaryOfEarlierConversation) from each
+     * ID, Sequence, Role, Message, SummaryOfEarlierConversation, __mj_CreatedAt) from each
      * ConversationDetail record. Using 'entity_object' created full BaseEntity instances
      * with getters/setters, dirty tracking, and validation — none of which are needed for
      * read-only history assembly. The 'simple' result type returns plain JS objects,

package/dist/resolvers/RunAIAgentResolver.d.ts.map

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

package/dist/resolvers/RunAIAgentResolver.js

@@ -18,10 +18,10 @@ import { AgentRunner, ArtifactToolManager } from '@memberjunction/ai-agents';
 import { ConversationUtility } from '@memberjunction/ai-core-plus';
 import { AIEngine } from '@memberjunction/aiengine';
 import { ResolverBase } from '../generic/ResolverBase.js';
-import { startLivenessPulse } from '../generic/FireAndForgetHeartbeat.js';
+import { StartLivenessPulse } from '../generic/FireAndForgetHeartbeat.js';
 import { RequireSystemUser } from '../directives/RequireSystemUser.js';
 import { GetReadWriteProvider } from '../util.js';
-import { resolveWidgetGuestRunContext, elevateUserPayload } from '../realtimeWidget/widgetGuestElevation.js';
+import { ResolveWidgetGuestRunContext, ElevateUserPayload } from '../realtimeWidget/widgetGuestElevation.js';
 import { SafeJSONParse, UUIDsEqual } from '@memberjunction/global';
 import { GetAttachmentService } from '@memberjunction/aiengine';
 import { NotificationEngine } from '@memberjunction/notifications';
@@ -324,10 +324,10 @@ let RunAIAgentResolver = class RunAIAgentResolver extends ResolverBase {
                 },
                 timestamp: new Date()
             };
-            this.PublishProgressUpdate(pubSub, progressMsg, userPayload);
+            this.publishProgressUpdate(pubSub, progressMsg, userPayload);
         };
     }
-    PublishProgressUpdate(pubSub, data, userPayload) {
+    publishProgressUpdate(pubSub, data, userPayload) {
         this.PublishStatusUpdate(pubSub, userPayload.sessionId, JSON.stringify({
             resolver: 'RunAIAgentResolver',
             type: 'ExecutionProgress',
@@ -335,7 +335,7 @@ let RunAIAgentResolver = class RunAIAgentResolver extends ResolverBase {
             data,
         }), userPayload);
     }
-    PublishStreamingUpdate(pubSub, data, userPayload) {
+    publishStreamingUpdate(pubSub, data, userPayload) {
         this.PublishStatusUpdate(pubSub, userPayload.sessionId, JSON.stringify({
             resolver: 'RunAIAgentResolver',
             type: 'StreamingContent',
@@ -369,7 +369,7 @@ let RunAIAgentResolver = class RunAIAgentResolver extends ResolverBase {
                 },
                 timestamp: new Date()
             };
-            this.PublishStreamingUpdate(pubSub, streamMsg, userPayload);
+            this.publishStreamingUpdate(pubSub, streamMsg, userPayload);
         };
     }
     /**
@@ -389,7 +389,10 @@ let RunAIAgentResolver = class RunAIAgentResolver extends ResolverBase {
      *  The framework intersects them with the agent's accepted skills AND the user's Run permission. */
     requestedSkillIDs, 
     /** JSON `{ paused?: boolean }` — seeds `$.debug` on a submitted task graph at insert. */
-    taskGraphDebug) {
+    taskGraphDebug, 
+    /** History floor for a conversation run — threaded into ExecuteAgentParams.ConversationHistoryFrom,
+     *  so the framework's own conversation reads (retrieval tools, artifacts, compaction) honour it too. */
+    conversationHistoryFrom) {
         const startTime = Date.now();
         // Best-effort handle for persistInFlightAgentFailure. Populated from a
         // progress event carrying metadata.agentRun, or from the successful
@@ -436,6 +439,7 @@ let RunAIAgentResolver = class RunAIAgentResolver extends ResolverBase {
                 planMode: planMode,
                 requestedSkillIDs: requestedSkillIDs,
                 taskGraphDebug: parseTaskGraphDebug(taskGraphDebug),
+                ConversationHistoryFrom: conversationHistoryFrom,
                 data: parsedData,
                 context: {
                     dataSource: dataSource
@@ -585,7 +589,7 @@ let RunAIAgentResolver = class RunAIAgentResolver extends ResolverBase {
                 partialResult,
                 timestamp: new Date()
             };
-            this.PublishStreamingUpdate(pubSub, partialMsg, userPayload);
+            this.publishStreamingUpdate(pubSub, partialMsg, userPayload);
         }
         // Publish completion with conversationDetailId for client-side routing.
         // Include result data so fire-and-forget clients can receive the full result via WebSocket.
@@ -599,7 +603,7 @@ let RunAIAgentResolver = class RunAIAgentResolver extends ResolverBase {
             errorMessage: result.agentRun?.ErrorMessage || undefined,
             result: resultJson || undefined
         };
-        this.PublishStreamingUpdate(pubSub, completionData, userPayload);
+        this.publishStreamingUpdate(pubSub, completionData, userPayload);
     }
     /**
      * Public mutation for regular users to run AI agents with authentication.
@@ -808,7 +812,7 @@ let RunAIAgentResolver = class RunAIAgentResolver extends ResolverBase {
      * @param agentId - The agent to execute
      * @param maxHistoryMessages - Maximum number of history messages to include (default: 20)
      */
-    async RunAIAgentFromConversationDetail(conversationDetailId, agentId, { userPayload, providers, dataSource }, sessionId, pubSub, maxHistoryMessages, data, payload, lastRunId, autoPopulateLastRunPayload, configurationId, createArtifacts, createNotification, sourceArtifactId, sourceArtifactVersionId, fireAndForget, planMode, requestedSkillIDs) {
+    async RunAIAgentFromConversationDetail(conversationDetailId, agentId, { userPayload, providers, dataSource }, sessionId, pubSub, maxHistoryMessages, data, payload, lastRunId, autoPopulateLastRunPayload, configurationId, createArtifacts, createNotification, sourceArtifactId, sourceArtifactVersionId, fireAndForget, planMode, requestedSkillIDs, agentHistoryFrom) {
         // Check API key scope authorization for agent execution
         await this.CheckAPIKeyScopeAuthorization('agent:execute', agentId, userPayload);
         const p = GetReadWriteProvider(providers);
@@ -827,10 +831,12 @@ let RunAIAgentResolver = class RunAIAgentResolver extends ResolverBase {
         // Conversation OWNERSHIP is still enforced under the guest principal below: the guest loads its
         // own ConversationDetail through the Widget Guest RLS filters, so a detail id from another
         // session resolves to "not found" before any elevated work happens.
-        const widgetElevation = await resolveWidgetGuestRunContext(userPayload, p);
-        const effectiveAgentId = widgetElevation ? widgetElevation.pinnedAgentId : agentId;
-        const effectiveUserPayload = widgetElevation ? elevateUserPayload(userPayload, widgetElevation.elevatedUser) : userPayload;
+        const widgetElevation = await ResolveWidgetGuestRunContext(userPayload, p);
+        const effectiveAgentId = widgetElevation ? widgetElevation.PinnedAgentId : agentId;
+        const effectiveUserPayload = widgetElevation ? ElevateUserPayload(userPayload, widgetElevation.ElevatedUser) : userPayload;
         try {
+            // Parsed before anything loads: a floor the caller asked for must never be dropped.
+            const historyFrom = parseAgentHistoryFrom(agentHistoryFrom);
             // LATENCY OPTIMIZATION (Opt #2 + #3): Load ConversationDetail once here to extract
             // conversationId, then pass it downstream. Previously this record was loaded multiple
             // times: once in loadConversationHistoryWithAttachments (just to get conversationId),
@@ -845,13 +851,14 @@ let RunAIAgentResolver = class RunAIAgentResolver extends ResolverBase {
             const messages = await this.loadConversationHistoryWithAttachments(conversationId, currentUser, maxHistoryMessages || 20, p, 
             // The UI creates the agent-response placeholder row ('⏳ ...') before invoking
             // this mutation — exclude it so the model never sees an empty assistant turn.
-            [conversationDetailId]);
+            [conversationDetailId], historyFrom);
             // Convert to JSON string for the existing executeAIAgent method
             const messagesJson = JSON.stringify(messages);
             if (fireAndForget) {
                 // Fire-and-forget mode: start execution in background, return immediately.
                 // The client will receive the result via WebSocket PubSub completion event.
-                this.executeAgentInBackground(p, dataSource, effectiveAgentId, effectiveUserPayload, messagesJson, sessionId, pubSub, data, payload, lastRunId, autoPopulateLastRunPayload, configurationId, conversationDetailId, createArtifacts || false, createNotification || false, sourceArtifactId, sourceArtifactVersionId, conversationId, planMode, requestedSkillIDs);
+                this.executeAgentInBackground(p, dataSource, effectiveAgentId, effectiveUserPayload, messagesJson, sessionId, pubSub, data, payload, lastRunId, autoPopulateLastRunPayload, configurationId, conversationDetailId, createArtifacts || false, createNotification || false, sourceArtifactId, sourceArtifactVersionId, conversationId, planMode, requestedSkillIDs, undefined, // taskGraphDebug
+                historyFrom);
                 LogStatus(`🔥 Fire-and-forget: Agent ${effectiveAgentId} execution started in background for session ${sessionId}`);
                 return {
                     success: true,
@@ -862,7 +869,8 @@ let RunAIAgentResolver = class RunAIAgentResolver extends ResolverBase {
             return this.executeAIAgent(p, dataSource, effectiveAgentId, effectiveUserPayload, messagesJson, sessionId, pubSub, data, payload, undefined, // templateData
             lastRunId, autoPopulateLastRunPayload, configurationId, conversationDetailId, createArtifacts || false, createNotification || false, sourceArtifactId, sourceArtifactVersionId, conversationId, // LATENCY OPT #2: pass pre-resolved conversationId
             undefined, // runRef
-            planMode, requestedSkillIDs);
+            planMode, requestedSkillIDs, undefined, // taskGraphDebug
+            historyFrom);
         }
         catch (error) {
             const errorMessage = error.message || 'Unknown error loading conversation history';
@@ -1028,10 +1036,12 @@ let RunAIAgentResolver = class RunAIAgentResolver extends ResolverBase {
     /** Per-request Plan Mode toggle — threaded through to ExecuteAgentParams.planMode. */
     planMode, 
     /** Skill IDs the user requested — threaded through to ExecuteAgentParams.requestedSkillIDs. */
-    requestedSkillIDs, taskGraphDebug) {
+    requestedSkillIDs, taskGraphDebug, 
+    /** History floor — threaded through to ExecuteAgentParams.ConversationHistoryFrom. */
+    conversationHistoryFrom) {
         // Ref the liveness pulse reads to enrich heartbeats once the run is created.
         const runRef = { current: null };
-        const pulse = startLivenessPulse({
+        const pulse = StartLivenessPulse({
             pubSub,
             sessionId,
             ownerUserId: userPayload.userRecord.ID,
@@ -1041,7 +1051,7 @@ let RunAIAgentResolver = class RunAIAgentResolver extends ResolverBase {
                 : undefined,
         });
         // Execute in background - errors are handled within, not propagated
-        this.executeAIAgent(p, dataSource, agentId, userPayload, messagesJson, sessionId, pubSub, data, payload, undefined, lastRunId, autoPopulateLastRunPayload, configurationId, conversationDetailId, createArtifacts, createNotification, sourceArtifactId, sourceArtifactVersionId, conversationId, runRef, planMode, requestedSkillIDs, taskGraphDebug).catch((error) => {
+        this.executeAIAgent(p, dataSource, agentId, userPayload, messagesJson, sessionId, pubSub, data, payload, undefined, lastRunId, autoPopulateLastRunPayload, configurationId, conversationDetailId, createArtifacts, createNotification, sourceArtifactId, sourceArtifactVersionId, conversationId, runRef, planMode, requestedSkillIDs, taskGraphDebug, conversationHistoryFrom).catch((error) => {
             // Background execution failed unexpectedly (executeAIAgent has its own try-catch,
             // so this would only fire for truly unexpected errors).
             const errorMessage = (error instanceof Error) ? error.message : 'Unknown background execution error';
@@ -1057,8 +1067,8 @@ let RunAIAgentResolver = class RunAIAgentResolver extends ResolverBase {
                 errorMessage,
                 result: JSON.stringify({ success: false, errorMessage })
             };
-            this.PublishStreamingUpdate(pubSub, errorCompletionData, userPayload);
-        }).finally(() => pulse.stop());
+            this.publishStreamingUpdate(pubSub, errorCompletionData, userPayload);
+        }).finally(() => pulse.Stop());
     }
     /**
      * Load conversation history with attachments from database.
@@ -1074,18 +1084,20 @@ let RunAIAgentResolver = class RunAIAgentResolver extends ResolverBase {
      *
      * Opt #8: Switched from ResultType 'entity_object' to 'simple' with explicit Fields.
      * The history query only needs the window-assembly fields (ConversationWindowFields:
-     * ID, Sequence, Role, Message, SummaryOfEarlierConversation) from each
+     * ID, Sequence, Role, Message, SummaryOfEarlierConversation, __mj_CreatedAt) from each
      * ConversationDetail record. Using 'entity_object' created full BaseEntity instances
      * with getters/setters, dirty tracking, and validation — none of which are needed for
      * read-only history assembly. The 'simple' result type returns plain JS objects,
      * reducing per-record overhead (~30ms total savings).
      */
-    async loadConversationHistoryWithAttachments(conversationId, contextUser, maxMessages, provider, excludeDetailIds) {
+    async loadConversationHistoryWithAttachments(conversationId, contextUser, maxMessages, provider, excludeDetailIds, 
+    /** History floor: only rows written at or after it are loaded, and no summary is used. */
+    historyFrom) {
         // Context windowing (summary boundary + raw tail, or legacy last-N when no
         // summary exists) shares ONE fold implementation with all other callers —
         // ConversationEngine.AssembleContextWindow — and the ROWS come from the
         // single-sourced fresh-per-request loader (same one the compaction pass uses).
-        // Three deliberate properties vs. the engine's cached GetAgentContextWindow:
+        // Four deliberate properties vs. the engine's cached GetAgentContextWindow:
         //   1. Entity RLS applies (the engine path loads via a stored query with no
         //      row-level security — wrong for guest/widget-scoped users), and the
         //      process-global per-conversation cache — keyed by conversation, not user —
@@ -1094,10 +1106,13 @@ let RunAIAgentResolver = class RunAIAgentResolver extends ResolverBase {
         //      cross-server staleness (a warm cache misses rows written by other nodes).
         //   3. Load failure THROWS → the mutation fails, instead of silently running
         //      the agent against zero history.
-        const rows = await ConversationEngine.LoadWindowRowsFresh(conversationId, contextUser, provider);
+        //   4. A history floor (`historyFrom`) is applied in the query, so rows before it never
+        //      leave the database, and again in the assembly, which then skips the summary.
+        const rows = await ConversationEngine.LoadWindowRowsFresh(conversationId, contextUser, provider, historyFrom);
         const window = ConversationEngine.AssembleContextWindow(rows, {
             maxTailMessages: maxMessages,
-            excludeDetailIds
+            excludeDetailIds,
+            historyFrom
         });
         // Batch load input artifacts for the windowed messages. Since the backfill migration
         // (V202605271400__Backfill_Attachment_Artifacts) converted all legacy
@@ -1144,19 +1159,19 @@ let RunAIAgentResolver = class RunAIAgentResolver extends ResolverBase {
             const ext = fileName.includes('.') ? fileName.split('.').pop() : undefined;
             const artifactType = ArtifactMetadataEngine.Instance.GetArtifactTypeByMimeType(artifactMime, ext);
             const decision = RouteArtifact({
-                typeDefault: artifactType?.DefaultDeliveryMode ?? 'ToolsOnly',
-                forceToolsOnly: artifactVersion.ForceToolsOnly,
+                TypeDefault: artifactType?.DefaultDeliveryMode ?? 'ToolsOnly',
+                ForceToolsOnly: artifactVersion.ForceToolsOnly,
                 mimeType: artifactMime,
-                sizeBytes: artifactVersion.ContentSizeBytes ?? 0,
-                inlineSizeCap: INLINE_SIZE_CAP,
-                modelSupportsModality: () => true,
-                modelName: '<resolver>',
-                artifactTypeName: artifactType?.Name ?? artifactMime,
+                SizeBytes: artifactVersion.ContentSizeBytes ?? 0,
+                InlineSizeCap: INLINE_SIZE_CAP,
+                ModelSupportsModality: () => true,
+                ModelName: '<resolver>',
+                ArtifactTypeName: artifactType?.Name ?? artifactMime,
             });
             if (artifactVersion.ContentMode === 'File' && artifactVersion.FileID) {
                 if (decision.delivery !== 'inline') {
-                    if (decision.delivery === 'tools' && decision.annotation) {
-                        LogStatus(`[RunAIAgentResolver] ${decision.annotation}`);
+                    if (decision.delivery === 'tools' && decision.Annotation) {
+                        LogStatus(`[RunAIAgentResolver] ${decision.Annotation}`);
                     }
                     continue;
                 }
@@ -1175,8 +1190,8 @@ let RunAIAgentResolver = class RunAIAgentResolver extends ResolverBase {
                 // Text-mode artifact (ContentMode = 'Text'). Honor the
                 // routing decision the same way as for file-mode.
                 if (decision.delivery !== 'inline') {
-                    if (decision.delivery === 'tools' && decision.annotation) {
-                        LogStatus(`[RunAIAgentResolver] ${decision.annotation}`);
+                    if (decision.delivery === 'tools' && decision.Annotation) {
+                        LogStatus(`[RunAIAgentResolver] ${decision.Annotation}`);
                     }
                     continue;
                 }
@@ -1365,8 +1380,9 @@ __decorate([
     __param(15, Arg('fireAndForget', { nullable: true })),
     __param(16, Arg('planMode', { nullable: true })),
     __param(17, Arg('requestedSkillIDs', () => [String], { nullable: true })),
+    __param(18, Arg('agentHistoryFrom', { nullable: true })),
     __metadata("design:type", Function),
-    __metadata("design:paramtypes", [String, String, Object, String, PubSubEngine, Number, String, String, String, Boolean, String, Boolean, Boolean, String, String, Boolean, Boolean, Array]),
+    __metadata("design:paramtypes", [String, String, Object, String, PubSubEngine, Number, String, String, String, Boolean, String, Boolean, Boolean, String, String, Boolean, Boolean, Array, String]),
     __metadata("design:returntype", Promise)
 ], RunAIAgentResolver.prototype, "RunAIAgentFromConversationDetail", null);
 __decorate([
@@ -1395,6 +1411,21 @@ RunAIAgentResolver = __decorate([
     Resolver()
 ], RunAIAgentResolver);
 export { RunAIAgentResolver };
+/**
+ * Reads the `agentHistoryFrom` argument of `RunAIAgentFromConversationDetail`: an ISO-8601
+ * timestamp. Absent means no floor. A value that is present but not a timestamp throws — a
+ * floor the caller asked for must fail the request, never be dropped, since dropping it lets
+ * the run read the history it was meant to keep out.
+ */
+function parseAgentHistoryFrom(raw) {
+    if (raw == null)
+        return undefined;
+    const parsed = new Date(raw);
+    if (Number.isNaN(parsed.getTime())) {
+        throw new Error(`agentHistoryFrom must be an ISO-8601 timestamp; received "${raw}"`);
+    }
+    return parsed;
+}
 function parseTaskGraphDebug(raw) {
     if (!raw)
         return undefined;