@memberjunction/ai-agents 5.48.0 → 5.49.0

package/dist/ConversationToolManager.js

@@ -0,0 +1,336 @@
+/**
+ * @fileoverview Conversation-history retrieval tools (RLM-style addressable paging).
+ *
+ * The cross-turn summary (see ConversationCompactionManager) is deliberately lossy — a
+ * compact handle over history that has left the context window. These tools are the
+ * other half of the design (plans/agent-conversation-compaction.md §5): the full
+ * history stays in an addressable external store (ConversationDetail rows keyed by the
+ * persisted per-conversation `Sequence`), and the agent pages exact slices back in on
+ * demand instead of trusting the summary. Zero turn cost — calls ride the
+ * `conversationToolCalls` inline response field, mirroring `artifactToolCalls`.
+ *
+ * All reads are served from `ConversationEngine`'s per-conversation cache (one query on
+ * a cold miss, in-memory afterward).
+ *
+ * @module @memberjunction/ai-agents
+ */
+import { ConversationEngine } from '@memberjunction/core-entities';
+import { FormatSequencedHistoryLine } from './conversation-history-format.js';
+/**
+ * The conversation-tool name vocabulary — single source of truth. The LLM is taught these
+ * exact strings (GetToolDocumentation + the loop-agent system template's response-type
+ * union), the dispatch switch matches them, and framework guidance messages enumerate them.
+ * Add/rename tools HERE; everything else derives from this array.
+ */
+export const ConversationToolNames = ['getMessageBySequence', 'getMessagesByRange', 'searchConversation', 'summarizeRange'];
+/** Hard cap on messages returned by getMessagesByRange. */
+const MAX_RANGE_MESSAGES = 50;
+/** Hard cap on the span a single summarizeRange sub-call may cover. */
+const MAX_SUMMARIZE_RANGE_MESSAGES = 500;
+/** Character budget for the rendered slice fed to the summarizeRange sub-call. */
+const MAX_SUMMARIZE_INPUT_CHARS = 100_000;
+/** Total character budget for a range result — beyond it, messages are dropped with a note. */
+const MAX_RANGE_TOTAL_CHARS = 32_000;
+/** searchConversation result caps. */
+const DEFAULT_SEARCH_RESULTS = 20;
+const MAX_SEARCH_RESULTS = 50;
+/** Snippet length around a search match. */
+const SNIPPET_CHARS = 300;
+/**
+ * Max characters for a searchConversation regex pattern. The pattern is model-authored
+ * (and thus prompt-injection-steerable) — a length cap is the first line of ReDoS
+ * surface control before it ever reaches `new RegExp`.
+ */
+const MAX_SEARCH_PATTERN_CHARS = 256;
+/**
+ * Per-message haystack cap for REGEX matching: patterns run against at most this many
+ * characters of a message body (keyword search stays uncapped — indexOf is linear-safe).
+ * Bounds the per-call work a pathological pattern can do against one huge message.
+ */
+const MAX_SEARCH_HAYSTACK_CHARS = 20_000;
+/**
+ * Total wall-clock budget for one search scan. Checked between messages — it cannot
+ * interrupt a single pathological `match()` call (that would need RE2 or a worker
+ * thread, both disproportionate here); together with the pattern/haystack caps it
+ * bounds the blast radius to "one slow call, contained per-call".
+ */
+const MAX_SEARCH_SCAN_MS = 2_000;
+/**
+ * Max conversationToolCalls executed per LLM response. Each call is a run step (and
+ * summarizeRange is a full LLM sub-call) — an unbounded Promise.all would let a single
+ * response fan out arbitrary work/cost. Excess calls are reported back to the model as
+ * skipped so it can re-request them next turn. Consumed by BaseAgent's executor.
+ */
+export const MAX_CONVERSATION_TOOL_CALLS_PER_TURN = 8;
+/**
+ * Per-run manager for conversation-history retrieval tools. Initialized with the run's
+ * conversationId (the availability gate — no conversation, no tools) and serving all
+ * reads from the ConversationEngine cache.
+ */
+export class ConversationToolManager {
+    constructor() {
+        this.conversationId = null;
+        this.contextUser = null;
+        this.summaryHost = null;
+    }
+    /** Arms the manager for a run. Pass null conversationId to disable (programmatic runs). */
+    Initialize(conversationId, contextUser) {
+        this.conversationId = conversationId;
+        this.contextUser = contextUser;
+    }
+    /** Wires the recursive-sub-call seam (BaseAgent owns prompt execution). */
+    SetSummaryHost(host) {
+        this.summaryHost = host;
+    }
+    /** Disarms the manager (per-run reset). */
+    Clear() {
+        this.conversationId = null;
+        this.contextUser = null;
+        this.summaryHost = null;
+    }
+    /** True when the run has a conversation to page against. */
+    get IsAvailable() {
+        return !!this.conversationId && !!this.contextUser;
+    }
+    /** Executes one tool call with timing + full error containment. */
+    async ExecuteSingleToolCall(call) {
+        const start = Date.now();
+        try {
+            const { data, promptRunId } = await this.dispatch(call);
+            return { tool: call.tool, input: call.input, result: { success: true, data }, durationMs: Date.now() - start, promptRunId };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return { tool: call.tool, input: call.input, result: { success: false, errorMessage }, durationMs: Date.now() - start };
+        }
+    }
+    /**
+     * Markdown tool documentation injected into the system prompt (the
+     * `{{ _CONVERSATION_TOOLS }}` template block), rendered only when the run has a
+     * conversation.
+     */
+    GetToolDocumentation() {
+        return [
+            '## Conversation History Tools',
+            'Older parts of this conversation may have been replaced by a summary. The FULL history remains stored, addressable by the `[seq N]` sequence numbers the summary references. Page exact messages back in with `conversationToolCalls` in your response — results arrive as a conversation message on your next turn. Prefer paging in exact messages over trusting the summary for precise wording, identifiers, numbers, or decisions.',
+            '',
+            '| tool | input | returns |',
+            '|---|---|---|',
+            '| `getMessageBySequence` | `{ "sequence": 42 }` | the exact message at that sequence |',
+            `| \`getMessagesByRange\` | \`{ "startSequence": 10, "endSequence": 20 }\` | the messages in the inclusive range (max ${MAX_RANGE_MESSAGES}) |`,
+            `| \`searchConversation\` | \`{ "query": "text or regex", "isRegex"?: true, "role"?: "User"\\|"AI", "startSequence"?, "endSequence"?, "maxResults"? }\` | matching hits as \`{sequence, role, agent, snippet}\` (default ${DEFAULT_SEARCH_RESULTS}) — then page the hits you need |`,
+            `| \`summarizeRange\` | \`{ "startSequence": 1, "endSequence": 120, "lens": "what the summary should focus on" }\` | a focused summary of the range through YOUR lens (max ${MAX_SUMMARIZE_RANGE_MESSAGES} messages) — use when a range is too big to page in raw |`,
+            '',
+            '',
+            `Max ${MAX_CONVERSATION_TOOL_CALLS_PER_TURN} tool calls per response — excess calls are skipped and reported back; re-request them on your next turn.`,
+            '',
+            'Example: `"conversationToolCalls": [{ "tool": "searchConversation", "input": { "query": "budget approval" } }]`'
+        ].join('\n');
+    }
+    /** Routes a call to its tool implementation. */
+    async dispatch(call) {
+        const details = await this.loadOrderedDetails();
+        switch (call.tool) {
+            case 'getMessageBySequence':
+                return { data: this.getMessageBySequence(details, call.input) };
+            case 'getMessagesByRange':
+                return { data: this.getMessagesByRange(details, call.input) };
+            case 'searchConversation':
+                return { data: this.searchConversation(details, call.input) };
+            case 'summarizeRange':
+                return this.summarizeRange(details, call.input);
+            default:
+                throw new Error(`Unknown conversation tool '${call.tool}'`);
+        }
+    }
+    /**
+     * The recursive sub-call (RLM pattern): renders the requested slice and hands it to
+     * the host's summary prompt with the caller's lens. The agent is not limited to the
+     * one baseline summary's framing — any window can be re-summarized however the
+     * current task needs, on a cheap sub-call model.
+     */
+    async summarizeRange(details, input) {
+        if (!this.summaryHost) {
+            throw new Error('summarizeRange is unavailable: no summary host is wired for this run');
+        }
+        const { startSequence, endSequence } = input;
+        if (typeof startSequence !== 'number' || typeof endSequence !== 'number' || startSequence > endSequence) {
+            throw new Error(`summarizeRange requires numeric 'startSequence' <= 'endSequence'`);
+        }
+        if (!input.lens || input.lens.trim().length === 0) {
+            throw new Error(`summarizeRange requires a 'lens' describing what the summary should focus on`);
+        }
+        if (endSequence - startSequence + 1 > MAX_SUMMARIZE_RANGE_MESSAGES) {
+            throw new Error(`Range spans ${endSequence - startSequence + 1} messages — max ${MAX_SUMMARIZE_RANGE_MESSAGES} per summarizeRange call`);
+        }
+        const inRange = details.filter(d => d.Sequence >= startSequence && d.Sequence <= endSequence);
+        if (inRange.length === 0) {
+            throw new Error(`No messages found in sequence range ${startSequence}..${endSequence}`);
+        }
+        const rangeText = this.renderRangeForSummary(inRange);
+        const summary = await this.summaryHost.RunSummaryPrompt(rangeText, input.lens.trim());
+        return {
+            data: {
+                lens: input.lens.trim(),
+                startSequence,
+                endSequence,
+                messageCount: inRange.length,
+                summary: summary.text
+            },
+            promptRunId: summary.promptRunId
+        };
+    }
+    /** `[seq N] Role: text` rendering (shared shape) with a total input budget for the sub-call model. */
+    renderRangeForSummary(details) {
+        const lines = [];
+        let usedChars = 0;
+        for (const detail of details) {
+            const line = FormatSequencedHistoryLine(detail.Sequence, detail.Role, detail.Message || '');
+            usedChars += line.length;
+            if (usedChars > MAX_SUMMARIZE_INPUT_CHARS && lines.length > 0) {
+                lines.push(`[input capped at ~${MAX_SUMMARIZE_INPUT_CHARS.toLocaleString('en-US')} characters — messages from sequence ${detail.Sequence} onward omitted; summarize a narrower range to cover them]`);
+                break;
+            }
+            lines.push(line);
+        }
+        return lines.join('\n');
+    }
+    /** Full conversation history, ordered by Sequence, from the engine cache. */
+    async loadOrderedDetails() {
+        if (!this.conversationId || !this.contextUser) {
+            throw new Error('Conversation tools are unavailable: no conversation is associated with this run');
+        }
+        const cache = await ConversationEngine.Instance.LoadConversationDetails(this.conversationId, this.contextUser);
+        return [...cache.Details].sort((a, b) => a.Sequence - b.Sequence);
+    }
+    getMessageBySequence(details, input) {
+        if (typeof input.sequence !== 'number') {
+            throw new Error(`getMessageBySequence requires a numeric 'sequence' input`);
+        }
+        const detail = details.find(d => d.Sequence === input.sequence);
+        if (!detail) {
+            throw new Error(`No message found at sequence ${input.sequence} (valid range: 1..${details.length > 0 ? details[details.length - 1].Sequence : 0})`);
+        }
+        return this.toToolMessage(detail);
+    }
+    getMessagesByRange(details, input) {
+        const { startSequence, endSequence } = input;
+        if (typeof startSequence !== 'number' || typeof endSequence !== 'number' || startSequence > endSequence) {
+            throw new Error(`getMessagesByRange requires numeric 'startSequence' <= 'endSequence'`);
+        }
+        if (endSequence - startSequence + 1 > MAX_RANGE_MESSAGES) {
+            throw new Error(`Range spans ${endSequence - startSequence + 1} messages — max ${MAX_RANGE_MESSAGES} per call. Narrow the range or make multiple calls.`);
+        }
+        const inRange = details.filter(d => d.Sequence >= startSequence && d.Sequence <= endSequence);
+        // Enforce the total-character budget so one range call can't blow the context.
+        const messages = [];
+        let usedChars = 0;
+        for (const detail of inRange) {
+            const message = this.toToolMessage(detail);
+            usedChars += message.message.length;
+            if (usedChars > MAX_RANGE_TOTAL_CHARS && messages.length > 0) {
+                return {
+                    messages,
+                    truncated: `Result capped at ~${MAX_RANGE_TOTAL_CHARS.toLocaleString('en-US')} characters — ${inRange.length - messages.length} message(s) from sequence ${message.sequence} onward omitted. Request a narrower range to read them.`
+                };
+            }
+            messages.push(message);
+        }
+        return { messages };
+    }
+    searchConversation(details, input) {
+        if (!input.query || input.query.trim().length === 0) {
+            throw new Error(`searchConversation requires a non-empty 'query'`);
+        }
+        const maxResults = Math.min(input.maxResults || DEFAULT_SEARCH_RESULTS, MAX_SEARCH_RESULTS);
+        const matchType = input.isRegex ? 'regex' : 'keyword';
+        const regex = this.compileSearchRegex(input.query, input.isRegex);
+        const needle = input.query.toLowerCase();
+        const hits = [];
+        let totalMatches = 0;
+        let anyHaystackCapped = false;
+        let warning;
+        const deadline = Date.now() + MAX_SEARCH_SCAN_MS;
+        for (const detail of details) {
+            // Wall-clock budget checked between messages — bounds the total scan a
+            // model-authored pattern can consume on the event loop (see the
+            // MAX_SEARCH_SCAN_MS doc for what this deliberately cannot bound).
+            if (Date.now() > deadline) {
+                warning = `Search stopped after ${MAX_SEARCH_SCAN_MS}ms — results are partial (stopped before sequence ${detail.Sequence}). Narrow the sequence range or simplify the pattern.`;
+                break;
+            }
+            if (!this.passesSearchFilters(detail, input))
+                continue;
+            const text = detail.Message || '';
+            // Regex mode matches a capped slice of long messages (keyword indexOf is
+            // linear-safe and stays uncapped); snippets still render from full text.
+            let haystack = text;
+            if (regex && text.length > MAX_SEARCH_HAYSTACK_CHARS) {
+                haystack = text.slice(0, MAX_SEARCH_HAYSTACK_CHARS);
+                anyHaystackCapped = true;
+            }
+            // `??` (not the usual `||` fallback) — a match at index 0 is a valid hit
+            const matchIndex = regex ? (haystack.match(regex)?.index ?? -1) : text.toLowerCase().indexOf(needle);
+            if (matchIndex < 0)
+                continue;
+            totalMatches++;
+            if (hits.length < maxResults) {
+                hits.push({
+                    sequence: detail.Sequence,
+                    role: detail.Role || '',
+                    agent: detail.Agent || null,
+                    snippet: this.buildSnippet(text, matchIndex),
+                    matchType
+                });
+            }
+        }
+        if (anyHaystackCapped && !warning) {
+            warning = `Regex matching was limited to the first ${MAX_SEARCH_HAYSTACK_CHARS.toLocaleString('en-US')} characters of long messages — a match deeper in such a message would not be found. Page the message in by sequence to inspect it fully.`;
+        }
+        return warning ? { hits, totalMatches, warning } : { hits, totalMatches };
+    }
+    /** Compiles the query as a case-insensitive regex in regex mode; null in keyword mode. */
+    compileSearchRegex(query, isRegex) {
+        if (!isRegex) {
+            return null;
+        }
+        if (query.length > MAX_SEARCH_PATTERN_CHARS) {
+            throw new Error(`Regex pattern is ${query.length} characters — max ${MAX_SEARCH_PATTERN_CHARS}. Use a shorter pattern or keyword search.`);
+        }
+        try {
+            return new RegExp(query, 'i');
+        }
+        catch (error) {
+            throw new Error(`Invalid regular expression '${query}': ${error instanceof Error ? error.message : error}`);
+        }
+    }
+    /** Role and sequence-range filters applied to every candidate message in a search. */
+    passesSearchFilters(detail, input) {
+        const roleFilter = input.role?.toLowerCase();
+        if (roleFilter && (detail.Role || '').toLowerCase() !== roleFilter)
+            return false;
+        if (typeof input.startSequence === 'number' && detail.Sequence < input.startSequence)
+            return false;
+        if (typeof input.endSequence === 'number' && detail.Sequence > input.endSequence)
+            return false;
+        return true;
+    }
+    /** A ~300-char window centered on the match, with ellipses at cut edges. */
+    buildSnippet(text, matchIndex) {
+        const half = Math.floor(SNIPPET_CHARS / 2);
+        const start = Math.max(0, matchIndex - half);
+        const end = Math.min(text.length, start + SNIPPET_CHARS);
+        const prefix = start > 0 ? '…' : '';
+        const suffix = end < text.length ? '…' : '';
+        return `${prefix}${text.slice(start, end)}${suffix}`;
+    }
+    toToolMessage(detail) {
+        return {
+            sequence: detail.Sequence,
+            role: detail.Role || '',
+            agent: detail.Agent || null,
+            message: detail.Message || ''
+        };
+    }
+}
+//# sourceMappingURL=ConversationToolManager.js.map

package/dist/ConversationToolManager.js.map

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

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

@@ -243,6 +243,14 @@ export interface LoopAgentTypePromptParams {
      * @default true
      */
     includeArtifactToolsDocs?: boolean;
+    /**
+     * Include conversation-history retrieval tool documentation in the prompt (the
+     * `_CONVERSATION_TOOLS` block). Only emitted when the run has a conversationId —
+     * these tools page exact pre-summary messages back in by their persisted Sequence
+     * handles. Disable for agents that should never dig into conversation history.
+     * @default true
+     */
+    includeConversationToolsDocs?: boolean;
     /**
      * Include tool-pipeline documentation in the prompt (the `_PIPELINE_TOOLS` block).
      * Only emitted when at least one pipeline source — an Action or artifact tool — is available.

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;;;;;;;;;;;;;;;;;;;;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;IAErB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,qCAAqC,EAAE,QAAQ,CAAC,0BAA0B,CAStF,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;IAE5B;;;;;;OAMG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAEnC;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAI9B;;;;;;;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,CAgBhF,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;IAErB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,eAAO,MAAM,qCAAqC,EAAE,QAAQ,CAAC,0BAA0B,CAStF,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;IAE5B;;;;;;OAMG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAEnC;;;;;;OAMG;IACH,4BAA4B,CAAC,EAAE,OAAO,CAAC;IAEvC;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAI9B;;;;;;;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,CAiBhF,CAAC"}

package/dist/agent-types/loop-agent-prompt-params.js

@@ -50,6 +50,7 @@ export const DEFAULT_LOOP_AGENT_PROMPT_PARAMS = {
     includeScratchpadDocs: true,
     scratchpadMaxTasks: 50,
     includeArtifactToolsDocs: true,
+    includeConversationToolsDocs: true,
     includePipelineDocs: true,
     maxSubAgentsInPrompt: -1,
     maxActionsInPrompt: -1

package/dist/agent-types/loop-agent-prompt-params.js.map

@@ -1 +1 @@
-{"version":3,"file":"loop-agent-prompt-params.js","sourceRoot":"","sources":["../../src/agent-types/loop-agent-prompt-params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AA+EH;;;GAGG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAyC;IACvF,OAAO,EAAE,IAAI;IACb,aAAa,EAAE,IAAI;IACnB,QAAQ,EAAE,IAAI;IACd,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,IAAI;IACX,UAAU,EAAE,IAAI;IAChB,iBAAiB,EAAE,IAAI;IACvB,QAAQ,EAAE,IAAI;CACjB,CAAC;AAuMF;;;GAGG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAwC;IACjF,6BAA6B,EAAE,EAAE,GAAG,qCAAqC,EAAE;IAC3E,kBAAkB,EAAE,IAAI;IACxB,gBAAgB,EAAE,IAAI;IACtB,uBAAuB,EAAE,IAAI;IAC7B,kBAAkB,EAAE,IAAI;IACxB,2BAA2B,EAAE,IAAI;IACjC,uBAAuB,EAAE,IAAI;IAC7B,sBAAsB,EAAE,IAAI;IAC5B,uBAAuB,EAAE,IAAI;IAC7B,qBAAqB,EAAE,IAAI;IAC3B,kBAAkB,EAAE,EAAE;IACtB,wBAAwB,EAAE,IAAI;IAC9B,mBAAmB,EAAE,IAAI;IACzB,oBAAoB,EAAE,CAAC,CAAC;IACxB,kBAAkB,EAAE,CAAC,CAAC;CACzB,CAAC"}
+{"version":3,"file":"loop-agent-prompt-params.js","sourceRoot":"","sources":["../../src/agent-types/loop-agent-prompt-params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AA+EH;;;GAGG;AACH,MAAM,CAAC,MAAM,qCAAqC,GAAyC;IACvF,OAAO,EAAE,IAAI;IACb,aAAa,EAAE,IAAI;IACnB,QAAQ,EAAE,IAAI;IACd,OAAO,EAAE,IAAI;IACb,KAAK,EAAE,IAAI;IACX,UAAU,EAAE,IAAI;IAChB,iBAAiB,EAAE,IAAI;IACvB,QAAQ,EAAE,IAAI;CACjB,CAAC;AAgNF;;;GAGG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAwC;IACjF,6BAA6B,EAAE,EAAE,GAAG,qCAAqC,EAAE;IAC3E,kBAAkB,EAAE,IAAI;IACxB,gBAAgB,EAAE,IAAI;IACtB,uBAAuB,EAAE,IAAI;IAC7B,kBAAkB,EAAE,IAAI;IACxB,2BAA2B,EAAE,IAAI;IACjC,uBAAuB,EAAE,IAAI;IAC7B,sBAAsB,EAAE,IAAI;IAC5B,uBAAuB,EAAE,IAAI;IAC7B,qBAAqB,EAAE,IAAI;IAC3B,kBAAkB,EAAE,EAAE;IACtB,wBAAwB,EAAE,IAAI;IAC9B,4BAA4B,EAAE,IAAI;IAClC,mBAAmB,EAAE,IAAI;IACzB,oBAAoB,EAAE,CAAC,CAAC;IACxB,kBAAkB,EAAE,CAAC,CAAC;CACzB,CAAC"}

package/dist/agent-types/loop-agent-response-type.d.ts

@@ -1,7 +1,8 @@
 import { AgentPayloadChangeRequest, ForEachOperation, WhileOperation, AgentResponseForm, ActionableCommand, AutomaticCommand, AgentScratchpad, AgentPipelineRequest } from "@memberjunction/ai-core-plus";
 import { ArtifactToolCall } from "../ArtifactToolManager.js";
+import { ConversationToolCall } from "../ConversationToolManager.js";
 import { MemoryWriteRequest } from "../MemoryWriteManager.js";
-export type { ForEachOperation, WhileOperation, ArtifactToolCall, MemoryWriteRequest };
+export type { ForEachOperation, WhileOperation, ArtifactToolCall, ConversationToolCall, MemoryWriteRequest };
 /**
  * Response structure for Loop Agent Type
  */
@@ -50,6 +51,14 @@ export interface LoopAgentResponse<P = any> {
      * injected into the next turn's prompt via _ARTIFACT_TOOL_RESULTS.
      */
     artifactToolCalls?: ArtifactToolCall[];
+    /**
+     * Conversation-history retrieval tool invocations — page exact pre-summary
+     * messages back into context by their persisted `Sequence` handles, or search
+     * the full stored history. Processed inline on the same turn as other response
+     * fields (zero turn cost); results are injected as a conversation message on
+     * the next turn. Only honored when the run has a conversationId.
+     */
+    conversationToolCalls?: ConversationToolCall[];
     /**
      * Durable memory writes — record facts/preferences that persist across
      * runs. Processed inline on the same turn as other response fields (zero

package/dist/agent-types/loop-agent-response-type.d.ts.map

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

package/dist/agent-types/loop-agent-response-type.js.map

@@ -1 +1 @@
-{"version":3,"file":"loop-agent-response-type.js","sourceRoot":"","sources":["../../src/agent-types/loop-agent-response-type.ts"],"names":[],"mappings":";AA8MA,oEAAoE;AACpE,sDAAsD"}
+{"version":3,"file":"loop-agent-response-type.js","sourceRoot":"","sources":["../../src/agent-types/loop-agent-response-type.ts"],"names":[],"mappings":";AAwNA,oEAAoE;AACpE,sDAAsD"}

package/dist/agent-types/loop-agent-type.d.ts

@@ -12,42 +12,31 @@
 import { BaseAgentType } from './base-agent-type.js';
 import { AIPromptRunResult, BaseAgentNextStep, AIPromptParams, ExecuteAgentParams, AgentConfiguration, AgentAction } from '@memberjunction/ai-core-plus';
 import { MJAIPromptEntityExtended } from '@memberjunction/ai-core-plus';
-/**
- * Implementation of the Loop Agent Type pattern.
- *
- * This agent type enables iterative execution where the agent continues
- * processing until a task is marked complete. It supports:
- * - Task completion detection
- * - Sub-agent delegation
- * - Action execution
- * - Progress tracking
- * - Error handling
- * - Result accumulation across iterations
- *
- * @class LoopAgentType
- * @extends BaseAgentType
- *
- * @example
- * ```typescript
- * // The agent will execute in a loop until taskComplete is true
- * const loopAgent = new LoopAgentType();
- * const nextStep = await loopAgent.DetermineNextStep(promptResult);
- *
- * switch (nextStep.step) {
- *   case 'success':
- *     console.log('Task completed:', nextStep.payload);
- *     break;
- *   case 'sub-agent':
- *     console.log('Delegating to:', nextStep.subAgentName);
- *     break;
- *   case 'action':
- *     console.log('Executing action:', nextStep.actionName);
- *     break;
- * }
- * ```
- */
 export declare class LoopAgentType extends BaseAgentType {
     private _evaluator;
+    /**
+     * Consecutive inline-read-tool pre-emptions forced so far. Per-run safe: a fresh
+     * LoopAgentType instance is created for each agent run (ClassFactory.CreateInstance
+     * in BaseAgentType.GetAgentTypeInstance). Reset whenever a response arrives without
+     * the terminal-step-plus-read-tools combination.
+     */
+    private consecutiveReadToolPreemptions;
+    /**
+     * Handles the terminal-step-plus-inline-read-tools combination. Inline READ tools
+     * (artifact/conversation) are yield/await: results arrive on the NEXT turn, so a
+     * terminal step in the same response would orphan them — the tools execute and inject
+     * their results, but the run ends and the user gets "one moment…" and silence. Mirrors
+     * the Pipeline/client-tools pre-emption: force one more (non-terminal) turn so the LLM
+     * responds after reading the results. taskComplete + clientTools is excluded — the
+     * ClientTools path already re-enters the loop and consumes the injected results.
+     * memoryWrites/scratchpad are fire-and-forget writes and never trigger pre-emption.
+     *
+     * @returns The forced Retry step, or null when no pre-emption applies — including when
+     * the consecutive cap is reached (the caller then honors the terminal step; pre-emption
+     * retries are exempt from the unproductive-retry limit, so without the ceiling the
+     * combination could extend a run indefinitely).
+     */
+    private buildReadToolPreemptionStep;
     InitializeAgentTypeState<ATS = any, P = any>(params: ExecuteAgentParams<any, P>): Promise<ATS>;
     /**
      * Determines the next step based on the structured response from the AI model.

package/dist/agent-types/loop-agent-type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loop-agent-type.d.ts","sourceRoot":"","sources":["../../src/agent-types/loop-agent-type.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,WAAW,EAA6B,MAAM,8BAA8B,CAAC;AAEpL,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAIxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBACa,aAAc,SAAQ,aAAa;IAC5C,OAAO,CAAC,UAAU,CAAiC;IAEtC,wBAAwB,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAM3G;;;;;;;;;;;OAWG;IACU,iBAAiB,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAC7C,YAAY,EAAE,iBAAiB,GAAG,IAAI,EACtC,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAC,EAClC,OAAO,EAAE,CAAC,EACV,cAAc,EAAE,GAAG,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAuPhC;;;;;;;OAOG;IACH,SAAS,CAAC,mBAAmB,CAAC,cAAc,EAAE,OAAO,GAAG;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAC;IA+I5F;;;;;;;OAOG;IACU,aAAa,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EACzC,OAAO,EAAE,CAAC,EACV,cAAc,EAAE,GAAG,EACnB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GACpD,OAAO,CAAC,IAAI,CAAC;IAShB;;;;;;;;;;OAUG;IACU,oBAAoB,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAK/G;;;;;;;;;;;OAWG;IACU,kBAAkB,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAC9C,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC7B,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC1B,OAAO,EAAE,CAAC,EACV,cAAc,EAAE,GAAG,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAKvC;;;;;;;;;;;OAWG;IACU,gBAAgB,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAC5C,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,CAAC,EACV,cAAc,EAAE,GAAG,EACnB,gBAAgB,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,GAC/C,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC;IAK3C;;;;;;;;;;;;;;;;;OAiBG;IACU,oBAAoB,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAChD,OAAO,EAAE,WAAW,EAAE,EACtB,cAAc,EAAE,CAAC,EACjB,cAAc,EAAE,GAAG,EACnB,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC,EACjC,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC;IAShB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,6BAA6B;CAyBxC"}
+{"version":3,"file":"loop-agent-type.d.ts","sourceRoot":"","sources":["../../src/agent-types/loop-agent-type.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,WAAW,EAA6B,MAAM,8BAA8B,CAAC;AAEpL,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AA+CxE,qBACa,aAAc,SAAQ,aAAa;IAC5C,OAAO,CAAC,UAAU,CAAiC;IAEnD;;;;;OAKG;IACH,OAAO,CAAC,8BAA8B,CAAK;IAE3C;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,2BAA2B;IAmCtB,wBAAwB,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAM3G;;;;;;;;;;;OAWG;IACU,iBAAiB,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAC7C,YAAY,EAAE,iBAAiB,GAAG,IAAI,EACtC,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAC,EAClC,OAAO,EAAE,CAAC,EACV,cAAc,EAAE,GAAG,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAmQhC;;;;;;;OAOG;IACH,SAAS,CAAC,mBAAmB,CAAC,cAAc,EAAE,OAAO,GAAG;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAC;IA+I5F;;;;;;;OAOG;IACU,aAAa,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EACzC,OAAO,EAAE,CAAC,EACV,cAAc,EAAE,GAAG,EACnB,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GACpD,OAAO,CAAC,IAAI,CAAC;IAShB;;;;;;;;;;OAUG;IACU,oBAAoB,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAK/G;;;;;;;;;;;OAWG;IACU,kBAAkB,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAC9C,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC7B,IAAI,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC1B,OAAO,EAAE,CAAC,EACV,cAAc,EAAE,GAAG,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAKvC;;;;;;;;;;;OAWG;IACU,gBAAgB,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAC5C,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,CAAC,EACV,cAAc,EAAE,GAAG,EACnB,gBAAgB,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,GAC/C,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC;IAK3C;;;;;;;;;;;;;;;;;OAiBG;IACU,oBAAoB,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,EAChD,OAAO,EAAE,WAAW,EAAE,EACtB,cAAc,EAAE,CAAC,EACjB,cAAc,EAAE,GAAG,EACnB,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC,EACjC,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC;IAShB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,6BAA6B;CAyBxC"}