@memberjunction/ai-agents 5.32.0 → 5.34.0

package/dist/artifact-tools/SearchResultSetToolLibrary.js

@@ -0,0 +1,320 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+/**
+ * @fileoverview Artifact tool library for Search Result Set content.
+ *
+ * Search Result Set artifacts are the persisted output of a scoped search
+ * (pre-execution RAG or agent-invoked). They are re-parented onto Data
+ * Snapshot in metadata, so all of Data Snapshot's tabular tools (filter,
+ * sort, paginate, get-row, project-columns) are inherited automatically.
+ * This library adds search-specific tools on top of that:
+ *
+ *   - filterByScore     — narrow by post-fusion score range
+ *   - groupBySourceProvider — markdown summary by provider
+ *   - getMatchingChunks — fetch chunk text + metadata for a row
+ *   - followSourceLink  — lift a row's source entity to a sub-artifact
+ *   - rerankInline      — re-run reranking with a different reranker
+ *
+ * Row identifiers used in the agent-facing tool surface are alpha-sequence
+ * (A, B, ..., AA, AB, ...) per the prompt-engineering convention. The
+ * library maintains a runtime mapping from alpha-id → internal UUID so the
+ * UUIDs never leak into the agent prompt.
+ */
+import { RegisterClass } from '@memberjunction/global';
+import { BaseArtifactToolLibrary, } from '@memberjunction/ai-core-plus';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Convert an integer index to an alpha-sequence handle (A, B, ..., Z, AA, AB).
+ * Used for row IDs surfaced to the LLM.
+ */
+function toAlphaId(index) {
+    let n = index;
+    let s = '';
+    do {
+        s = String.fromCharCode(65 + (n % 26)) + s;
+        n = Math.floor(n / 26) - 1;
+    } while (n >= 0);
+    return s;
+}
+/**
+ * Parse the artifact content. Throws an InvalidContent-style error if the
+ * shape doesn't match what we expect — surfaced as an ArtifactToolResult
+ * failure by the caller.
+ */
+function parseSpec(artifactContent) {
+    const raw = typeof artifactContent === 'string' ? artifactContent : artifactContent.toString('utf8');
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (err) {
+        throw new Error(`Search Result Set artifact is not valid JSON: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    if (!parsed || typeof parsed !== 'object') {
+        throw new Error('Search Result Set artifact must be a JSON object.');
+    }
+    // Two accepted shapes:
+    //   1. Native Search Result Set: { Query, Results: [...] }
+    //   2. Data-Snapshot-compatible (the shape AgentPreExecutionRAG.BuildArtifactPayload
+    //      produces): { tables: [{ rows: [...] }], queries: [...], ... }. We adapt rows
+    //      from the first table by mapping lowercase BuildArtifactPayload fields to the
+    //      uppercase shape `Results: SearchResultRow[]` expects.
+    if ('Results' in parsed && Array.isArray(parsed.Results)) {
+        const spec = parsed;
+        spec.Results.forEach((r, i) => { r.AlphaID = r.AlphaID ?? toAlphaId(i); });
+        return spec;
+    }
+    if ('tables' in parsed && Array.isArray(parsed.tables)) {
+        const tables = parsed.tables;
+        const firstTable = tables[0];
+        const rawRows = Array.isArray(firstTable?.rows) ? firstTable.rows : [];
+        const queries = parsed.queries ?? [];
+        const scopeIDs = parsed.scopeIDs ?? [];
+        const Results = rawRows.map((rawRow, i) => {
+            const row = (rawRow ?? {});
+            const recordID = String(row['recordID'] ?? row['RecordID'] ?? row['id'] ?? row['ID'] ?? '');
+            return {
+                ID: String(row['id'] ?? row['ID'] ?? recordID),
+                AlphaID: toAlphaId(i),
+                EntityName: String(row['entity'] ?? row['EntityName'] ?? ''),
+                RecordID: recordID,
+                Title: String(row['title'] ?? row['Title'] ?? ''),
+                Snippet: String(row['snippet'] ?? row['Snippet'] ?? ''),
+                Score: typeof row['score'] === 'number' ? row['score']
+                    : typeof row['Score'] === 'number' ? row['Score'] : 0,
+                SourceProvider: (row['source'] ?? row['SourceProvider']),
+                SourceType: (row['source'] ?? row['SourceType']),
+                SourceUrl: (row['sourceUrl'] ?? row['SourceUrl']),
+                Chunk: (row['chunk'] ?? row['Chunk']),
+                EmbeddingMetadata: (row['embeddingMetadata'] ?? row['EmbeddingMetadata']),
+            };
+        });
+        return {
+            Query: queries[0]?.query ?? '',
+            ScopeIDs: scopeIDs,
+            Results,
+        };
+    }
+    throw new Error('Search Result Set artifact missing both a Results array and a tables[] structure.');
+}
+function findRowByAlphaId(spec, alphaId) {
+    const target = alphaId.trim().toUpperCase();
+    return spec.Results.find(r => r.AlphaID === target);
+}
+// ---------------------------------------------------------------------------
+// Tool library
+// ---------------------------------------------------------------------------
+/**
+ * Register the library so the ArtifactToolManager can resolve it by the
+ * artifact type's ToolLibraryClass column ('SearchResultSetToolLibrary').
+ */
+let SearchResultSetToolLibrary = class SearchResultSetToolLibrary extends BaseArtifactToolLibrary {
+    /**
+     * Tools provided in addition to whatever the parent chain (DataSnapshot
+     * → Data → ...) supplies. Naming and shape mirror the spec's mockup #5.
+     */
+    GetToolList() {
+        return [
+            {
+                name: 'filterByScore',
+                description: 'Return the subset of search results whose post-fusion Score falls within the given range. Use this to focus on high-confidence matches when the result set is large.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        minScore: { type: 'number', description: 'Minimum post-fusion score (inclusive). Required.' },
+                        maxScore: { type: 'number', description: 'Maximum post-fusion score (inclusive). Optional.' },
+                    },
+                    required: ['minScore'],
+                },
+            },
+            {
+                name: 'groupBySourceProvider',
+                description: 'Summarize the result set grouped by which provider (vector, full-text, entity, storage, external) contributed each row. Returns a markdown table with per-group counts and average scores. Useful for understanding fusion contribution.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                },
+            },
+            {
+                name: 'getMatchingChunks',
+                description: 'Given an alpha-sequence row ID (e.g. A, B, AA), return the underlying chunk text, embedding metadata, and source URL. The deep-dive tool agents will use most often after a filterByScore.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        rowId: { type: 'string', description: 'Alpha-sequence row identifier from the result set (A, B, ..., AA).' },
+                    },
+                    required: ['rowId'],
+                },
+            },
+            {
+                name: 'followSourceLink',
+                description: 'Given an alpha-sequence row ID, lift the underlying source entity (the actual ContentItem, Document, etc.) into the agent context as a sub-artifact for further interrogation. Re-checks entity-level RLS — a search hit does not auto-grant entity permissions.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        rowId: { type: 'string', description: 'Alpha-sequence row identifier (A, B, ..., AA).' },
+                    },
+                    required: ['rowId'],
+                },
+            },
+            {
+                name: 'rerankInline',
+                description: 'Re-run reranking on the current result set with a named reranker (Cohere, Voyage, BGE, OpenAI). Returns the new ordering plus a note of the reranker that produced it. Cost-tracked through AIPromptRunCost.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        rerankerName: { type: 'string', description: 'Name of the reranker class registered with @RegisterClass(BaseReRanker, ...). E.g. "Cohere", "Voyage", "BGE", "OpenAI".' },
+                    },
+                    required: ['rerankerName'],
+                },
+            },
+        ];
+    }
+    async InvokeTool(toolName, input, artifactContent) {
+        try {
+            const spec = parseSpec(artifactContent);
+            switch (toolName) {
+                case 'filterByScore': return this.filterByScore(spec, input);
+                case 'groupBySourceProvider': return this.groupBySourceProvider(spec);
+                case 'getMatchingChunks': return this.getMatchingChunks(spec, input);
+                case 'followSourceLink': return this.followSourceLink(spec, input);
+                case 'rerankInline': return this.rerankInline(spec, input);
+                default:
+                    return { success: false, data: null, errorMessage: `Unknown tool: ${toolName}` };
+            }
+        }
+        catch (err) {
+            return { success: false, data: null, errorMessage: err instanceof Error ? err.message : String(err) };
+        }
+    }
+    // -----------------------------------------------------------------------
+    // Tool implementations
+    // -----------------------------------------------------------------------
+    filterByScore(spec, input) {
+        const { minScore, maxScore } = input;
+        if (typeof minScore !== 'number') {
+            return { success: false, data: null, errorMessage: "Missing or non-numeric 'minScore'." };
+        }
+        const upper = typeof maxScore === 'number' ? maxScore : Number.POSITIVE_INFINITY;
+        const filtered = spec.Results.filter(r => r.Score >= minScore && r.Score <= upper);
+        return {
+            success: true,
+            data: {
+                count: filtered.length,
+                rows: filtered.map(r => this.toAgentRow(r)),
+            },
+        };
+    }
+    groupBySourceProvider(spec) {
+        const groups = new Map();
+        for (const r of spec.Results) {
+            const key = r.SourceProvider ?? r.SourceType ?? 'unknown';
+            const cur = groups.get(key) ?? { count: 0, sumScore: 0 };
+            cur.count += 1;
+            cur.sumScore += r.Score;
+            groups.set(key, cur);
+        }
+        const rows = Array.from(groups.entries())
+            .map(([provider, stats]) => ({
+            Provider: provider,
+            Count: stats.count,
+            AvgScore: stats.count > 0 ? +(stats.sumScore / stats.count).toFixed(4) : 0,
+        }))
+            .sort((a, b) => b.Count - a.Count);
+        // Markdown-friendly summary alongside the structured data — per the
+        // markdown-not-JSON prompt-injection convention (RAG_plan §2.2).
+        const md = [
+            '| Provider | Count | Avg Score |',
+            '|----------|-------|-----------|',
+            ...rows.map(r => `| ${r.Provider} | ${r.Count} | ${r.AvgScore} |`),
+        ].join('\n');
+        return { success: true, data: { groups: rows, markdown: md } };
+    }
+    getMatchingChunks(spec, input) {
+        const row = findRowByAlphaId(spec, input.rowId);
+        if (!row) {
+            return { success: false, data: null, errorMessage: `Row '${input.rowId}' not found.` };
+        }
+        return {
+            success: true,
+            data: {
+                rowId: row.AlphaID,
+                title: row.Title,
+                chunk: row.Chunk ?? row.Snippet ?? '',
+                sourceUrl: row.SourceUrl ?? null,
+                embeddingMetadata: row.EmbeddingMetadata ?? null,
+            },
+        };
+    }
+    followSourceLink(spec, input) {
+        const row = findRowByAlphaId(spec, input.rowId);
+        if (!row) {
+            return { success: false, data: null, errorMessage: `Row '${input.rowId}' not found.` };
+        }
+        if (!row.EntityName || !row.RecordID) {
+            return { success: false, data: null, errorMessage: `Row '${input.rowId}' has no upstream entity reference (storage-only row?).` };
+        }
+        // The actual sub-artifact materialization happens in the agent
+        // runtime — this tool returns a typed pointer plus a note that the
+        // runtime should re-check entity-level RLS before inlining the
+        // record into the agent context.
+        return {
+            success: true,
+            data: {
+                rowId: row.AlphaID,
+                entityName: row.EntityName,
+                recordId: row.RecordID,
+                rlsCheckRequired: true,
+                note: `Caller must re-check entity-level RLS on ${row.EntityName}.${row.RecordID} before exposing this record to the agent.`,
+            },
+        };
+    }
+    rerankInline(spec, input) {
+        // The actual reranker invocation lives in the agent runtime — this
+        // tool returns a typed request that the caller (BaseAgent) hands to
+        // the SearchEngine reranker pipeline. We deliberately do NOT call
+        // ClassFactory.CreateInstance here because that would couple this
+        // pure-data library to the runtime budget guard. The caller is
+        // responsible for budget enforcement before honoring the request.
+        if (!input.rerankerName?.trim()) {
+            return { success: false, data: null, errorMessage: 'rerankerName is required.' };
+        }
+        return {
+            success: true,
+            data: {
+                requested: 'rerank',
+                rerankerName: input.rerankerName,
+                originalReranker: spec.Reranker ?? null,
+                originalOrder: spec.Results.map(r => r.AlphaID),
+                note: 'Runtime must invoke the named reranker via SearchEngine and replace the artifact with the new ordering. Cost-tracked through AIPromptRunCost.',
+            },
+        };
+    }
+    /** Strip internal UUID before handing a row to the LLM. */
+    toAgentRow(row) {
+        const { ID, EmbeddingMetadata, Chunk, ...rest } = row;
+        // Reference unused locals to keep tsc strict happy without losing
+        // intent in the destructuring.
+        void ID;
+        void EmbeddingMetadata;
+        void Chunk;
+        return rest;
+    }
+};
+SearchResultSetToolLibrary = __decorate([
+    RegisterClass(BaseArtifactToolLibrary, 'SearchResultSetToolLibrary')
+], SearchResultSetToolLibrary);
+export { SearchResultSetToolLibrary };
+/** Tree-shake-prevention hook. Call from consumer index to ensure the
+ * @RegisterClass side-effect runs. */
+export function LoadSearchResultSetToolLibrary() {
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    const _ref = SearchResultSetToolLibrary;
+}
+//# sourceMappingURL=SearchResultSetToolLibrary.js.map

package/dist/artifact-tools/SearchResultSetToolLibrary.js.map

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

package/dist/base-agent.d.ts

@@ -15,6 +15,7 @@ import { MJAIAgentRunEntityExtended, MJAIAgentRunStepEntityExtended, MJAIPromptE
 import { UserInfo, IMetadataProvider } from '@memberjunction/core';
 import { ChatMessage, ChatMessageContent } from '@memberjunction/ai';
 import { BaseAgentType } from './agent-types/base-agent-type.js';
+import { AgentPreExecutionRAGResult } from './agent-pre-execution-rag.js';
 import { AIPromptParams, AIPromptRunResult, ExecuteAgentParams, AgentConfiguration, ExecuteAgentResult, AgentAction, AgentSubAgentRequest, BaseAgentNextStep, MessageLifecycleEvent, AgentChatMessage, AIModelSelectionInfo, ActionChange, ActionChangeScope, MediaOutput, SecondaryScopeConfig, SecondaryScopeValue } from '@memberjunction/ai-core-plus';
 import { MJActionEntityExtended, ActionResult } from '@memberjunction/actions-base';
 /**
@@ -530,6 +531,14 @@ export declare class BaseAgent {
      * Storage for injected notes and examples to include in result
      */
     private _injectedMemory;
+    /**
+     * Storage for injected pre-execution RAG context (Phase 1C of search-scopes-rag-plus).
+     * Contains the formatted `<retrieved_context>` system-message block actually injected
+     * into `conversationMessages`, plus the structured per-scope / combined result detail
+     * for downstream observability and artifact persistence.
+     */
+    private _ragContext;
+    private _injectedRAG;
     /**
      * Determine the scope label for a note based on its scope fields.
      * Used for memory attribution logging to help identify which scope level
@@ -560,6 +569,32 @@ export declare class BaseAgent {
         notes: MJAIAgentNoteEntity[];
         examples: MJAIAgentExampleEntity[];
     }>;
+    /**
+     * Inject pre-execution RAG context for this agent using scoped search.
+     *
+     * Runs in parallel with `InjectContextMemory` during Phase 2 of `Execute()`. Loads the
+     * agent's `AIAgentSearchScope` rows (Phase IN 'PreExecution'|'Both'), renders any per-scope
+     * query templates, calls `SearchEngine.Search()` per scope, cross-scope RRF fuses the
+     * results when multiple scopes contributed, and unshifts a `<retrieved_context>` system
+     * message onto `conversationMessages`.
+     *
+     * When the agent has no active pre-execution scopes (or all scopes returned zero results),
+     * this method is a no-op — no system message is injected and `_injectedRAG` stays null.
+     *
+     * See plans/search-scopes-rag-plus.md §4 (Agent Integration — Pre-Execution RAG).
+     *
+     * @param lastUserMessage - The most recent user message text.
+     * @param agent - The agent being executed.
+     * @param contextUser - Calling user (threaded to SearchEngine + Metadata).
+     * @param conversationMessages - The mutated message array that flows to the LLM (system msg is unshifted here).
+     * @param originalMessages - The unmodified messages array (for template `recentMessages`).
+     * @param primaryScopeEntityId - Multi-tenant primary scope entity ID.
+     * @param primaryScopeRecordId - Multi-tenant primary scope record ID.
+     * @param secondaryScopes - Multi-tenant secondary scope dimensions.
+     * @param payload - The agent's current payload (for template rendering).
+     * @returns The structured RAG result, or `null` if no scopes produced results.
+     */
+    protected InjectPreExecutionRAG(lastUserMessage: string, agent: MJAIAgentEntityExtended, contextUser: UserInfo | undefined, conversationMessages: ChatMessage[] | undefined, originalMessages: ChatMessage[] | undefined, primaryScopeEntityId?: string, primaryScopeRecordId?: string, secondaryScopes?: Record<string, SecondaryScopeValue>, payload?: unknown): Promise<AgentPreExecutionRAGResult | null>;
     /**
      * Converts UI markup (@{...} syntax) in user messages to plain text.
      * This prevents agents from being confused by UI-specific JSON syntax and reduces token usage.

package/dist/base-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-agent.d.ts","sourceRoot":"","sources":["../src/base-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,mBAAmB,EAAG,qBAAqB,EAAoD,mBAAmB,EAAE,sBAAsB,EAAyG,MAAM,+BAA+B,CAAC;AAClS,OAAO,EAAE,0BAA0B,EAAE,8BAA8B,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC7J,OAAO,EAAE,QAAQ,EAA4F,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE7J,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAwC,MAAM,oBAAoB,CAAC;AAC3G,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAO9D,OAAO,EACH,cAAc,EACd,iBAAiB,EAEjB,kBAAkB,EAElB,kBAAkB,EAElB,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EAEjB,qBAAqB,EACrB,gBAAgB,EAEhB,oBAAoB,EAEpB,YAAY,EACZ,iBAAiB,EACjB,WAAW,EAGX,oBAAoB,EACpB,mBAAmB,EAQtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAA4B,MAAM,8BAA8B,CAAC;AA4E9G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,qBAAa,SAAS;IAClB;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAM;IAEpD;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,4BAA4B,CAAM;IAE1D;;;OAGG;IACH,OAAO,CAAC,aAAa,CAAwC;IAE7D;;;;;OAKG;IACH,OAAO,CAAC,eAAe,CAAwC;IAE/D;;;;OAIG;IACH,SAAS,KAAK,aAAa,IAAI,iBAAiB,CAE/C;IAED;;;;;OAKG;IACH,OAAO,CAAC,eAAe,CAAa;IACpC;;OAEG;IACH,SAAS,KAAK,cAAc,IAAI,GAAG,CAElC;IAED,OAAO,CAAC,kBAAkB,CAAgB;IAC1C;;OAEG;IACH,IAAW,iBAAiB,IAAI,aAAa,CAE5C;IAED;;;;OAIG;IACH,OAAO,CAAC,gBAAgB,CAAkC;IAE1D;;;OAGG;IACH,OAAO,CAAC,yBAAyB,CAAuC;IAExE;;;;OAIG;IACH,OAAO,CAAC,4BAA4B,CAAa;IAEjD;;;OAGG;IACH,OAAO,CAAC,SAAS,CAA2C;IAE5D;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB,CAAuB;IAEjD,OAAO,CAAC,yBAAyB,CAAuB;IAExD;;;;;;OAMG;IACH,SAAS,KAAK,wBAAwB,IAAI,MAAM,GAAG,IAAI,CAEtD;IAED;;OAEG;IACH,IAAW,QAAQ,IAAI,0BAA0B,GAAG,IAAI,CAEvD;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACI,uBAAuB,CAAC,OAAO,EAAE,MAAM;IAO9C;;;;;OAKG;IACI,6BAA6B,CAAC,OAAO,EAAE,MAAM;IAOpD;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACI,mBAAmB,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,IAAI;IAO7D;;;;OAIG;IACH,IAAW,YAAY,IAAI,WAAW,EAAE,CAEvC;IAED;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAAsB,CAAS;IAEvD;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,iBAAiB;IAUzB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,2BAA2B;IAgGnC;;;;;;;;;OASG;IACH,OAAO,CAAC,gCAAgC;IAuBxC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,iCAAiC;IAqBzC;;;OAGG;IACH,OAAO,CAAC,iCAAiC;IA4BzC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,+BAA+B;IAyCvC;;;;OAIG;IACH,OAAO,CAAC,eAAe,CAAgB;IAEvC;;;;OAIG;IACH,OAAO,CAAC,iBAAiB,CAAqC;IAE9D;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAa;IAE3B;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB,CAAgB;IAGzC;;;OAGG;IACH,OAAO,CAAC,iBAAiB,CAA8B;IAEvD;;;OAGG;IACH,OAAO,CAAC,aAAa,CAA4B;IAEjD;;;;;;OAMG;IACH,OAAO,CAAC,aAAa,CAAqB;IAE1C;;;;;;OAMG;IACH,OAAO,CAAC,YAAY,CAAuB;IAG3C;;;OAGG;IACH,OAAO,CAAC,eAAe,CAAwC;IAE/D;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB,CAA8C;IAExE;;;OAGG;IACH,OAAO,CAAC,oBAAoB,CAAkD;IAE9E;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB,CAAgC;IAEzD;;;;;;;;;OASG;IACH,OAAO,CAAC,gBAAgB,CAAa;IAErC;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB,CAA8B;IAE1D;;;;OAIG;IACH,OAAO,CAAC,qBAAqB,CAAa;IAE1C;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB,CAAa;IAE7C;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAa;IAEnD;;;;;OAKG;IACH,IAAW,oBAAoB,IAAI,MAAM,CAExC;IAED;;;;;OAKG;IACH,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,GAAE,OAAe,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,IAAI;IAYrG;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE;QAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC/B,KAAK,CAAC,EAAE,uBAAuB,CAAC;QAChC,SAAS,CAAC,EAAE,mBAAmB,CAAC;QAChC,QAAQ,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;KAC/C,GAAG,IAAI;IA6BR;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAkD5B;;;;;OAKG;cACa,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,kBAAkB;IAK1F;;;;;;;;;;;;;;OAcG;YACW,gBAAgB;IA4G9B;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH;;;;;OAKG;IACH,SAAS,KAAK,qBAAqB,IAAI,MAAM,CAE5C;IAEY,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;IA8TrG;;;OAGG;cACa,yBAAyB,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrG;;;;;;;;;;;;;;;;;OAiBG;cACa,oBAAoB,CAAC,CAAC,GAAG,GAAG,EACxC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,kBAAkB,GAC3B,OAAO,CAAC;QAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAC,CAAC;IAgFhE;;;;;;;OAOG;cACa,iBAAiB,CAAC,WAAW,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxE;;OAEG;IACH,OAAO,CAAC,cAAc,CAAc;IAEpC;;OAEG;IACH,OAAO,CAAC,eAAe,CAAqG;IAE5H;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;IA4B1B;;;;;;;;;;;;;;;;OAgBG;cACa,mBAAmB,CAC/B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,uBAAuB,EAC9B,MAAM,CAAC,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,QAAQ,EACtB,oBAAoB,CAAC,EAAE,WAAW,EAAE,EACpC,oBAAoB,CAAC,EAAE,MAAM,EAC7B,oBAAoB,CAAC,EAAE,MAAM,EAC7B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,EACrD,oBAAoB,CAAC,EAAE,oBAAoB,GAAG,IAAI,GACnD,OAAO,CAAC;QAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;QAAC,QAAQ,EAAE,sBAAsB,EAAE,CAAA;KAAE,CAAC;IAiFhF;;;;;;;;;OASG;IACH,SAAS,CAAC,yBAAyB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI;IA0BlE;;;;;;;OAOG;YACW,gBAAgB;IAuC9B;;;;;;OAMG;cACa,aAAa,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAiBjG;;;;;;;;;OASG;cACa,+BAA+B,CAAC,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE,kBAAkB,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAyDhI;;;;;;;OAOG;IACH,OAAO,CAAC,+BAA+B;IAuCvC;;;;;;OAMG;cACa,sBAAsB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAqEnG;;;;;;;;;OASG;cACa,mBAAmB,CAAC,CAAC,EACjC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,CAAC,EACV,MAAM,EAAE,kBAAkB,GAC3B,OAAO,CAAC,cAAc,CAAC;IA0K1B;;;;;;;OAOG;cACa,aAAa,CAAC,YAAY,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAQvF;;;;;;;OAOG;cACa,iBAAiB,CAAC,CAAC,EAC/B,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,mBAAmB,EAC9B,YAAY,EAAE,iBAAiB,EAC/B,cAAc,EAAE,CAAC,GAClB,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAQhC;;;;;;;;;;;OAWG;cACa,gBAAgB,CAAC,CAAC,EAC9B,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC9B,cAAc,EAAE,CAAC,EACjB,QAAQ,EAAE,0BAA0B,EACpC,WAAW,EAAE,8BAA8B,GAC5C,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAsChC;;;;;;OAMG;cACa,wBAAwB,CAAC,CAAC,EACtC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC9B,cAAc,EAAE,CAAC,EACjB,QAAQ,EAAE,0BAA0B,EACpC,WAAW,EAAE,8BAA8B,GAC5C,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAmDhC;;;;;;OAMG;cACa,uBAAuB,CAAC,CAAC,EACrC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC9B,cAAc,EAAE,CAAC,EACjB,QAAQ,EAAE,0BAA0B,EACpC,WAAW,EAAE,8BAA8B,GAC5C,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAkHhC;;;;;;;;OAQG;IACH,SAAS,CAAC,gCAAgC,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB,EAAE;IAcrF;;;;;;OAMG;cACa,uBAAuB,CAAC,CAAC,EACrC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC9B,cAAc,EAAE,CAAC,EACjB,QAAQ,EAAE,0BAA0B,EACpC,WAAW,EAAE,8BAA8B,GAC5C,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IA2HhC;;;;;;;;;OASG;cACa,mCAAmC,CAAC,CAAC,EACjD,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC9B,cAAc,EAAE,CAAC,EACjB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,EAAE,EACvB,QAAQ,EAAE,0BAA0B,EACpC,WAAW,EAAE,8BAA8B,GAC5C,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IA2FhC;;;;;;OAMG;cACa,sBAAsB,CAAC,CAAC,EACpC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC9B,cAAc,EAAE,CAAC,EACjB,QAAQ,EAAE,0BAA0B,EACpC,WAAW,EAAE,8BAA8B,GAC5C,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAKhC;;;;;;;OAOG;cACa,qBAAqB,CAAC,CAAC,EACnC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC9B,cAAc,EAAE,CAAC,EACjB,QAAQ,EAAE,0BAA0B,EACpC,WAAW,EAAE,8BAA8B,GAC5C,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAKhC;;;;;;;;OAQG;cACa,oBAAoB,CAAC,CAAC,EAClC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC9B,cAAc,EAAE,CAAC,EACjB,QAAQ,EAAE,0BAA0B,EACpC,WAAW,EAAE,8BAA8B,GAC5C,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IA4ChC;;;;;;;;;;;OAWG;cACa,wBAAwB,CAAC,CAAC,EACtC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC9B,cAAc,EAAE,CAAC,EACjB,QAAQ,EAAE,0BAA0B,EACpC,WAAW,EAAE,8BAA8B,GAC5C,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAgDhC;;;;;;;;OAQG;cACa,6BAA6B,CACzC,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,0BAA0B,GACrC,OAAO,CAAC;QACP,QAAQ,EAAE,OAAO,CAAC;QAClB,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,MAAM,CAAC;QACjD,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IAqFF;;;;;;;;;OASG;IACH,SAAS,CAAC,kBAAkB,CAAC,YAAY,EAAE,iBAAiB,GAAG,OAAO;IAyCtE;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,oBAAoB,CAC1B,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,kBAAkB,GAC5B;QAAE,aAAa,EAAE,OAAO,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE;IA8JtD;;;;;;;OAOG;IACH,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM;IAc9D;;;;;;;;OAQG;IACH,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,MAAa,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE;IA0FpI;;;;;;;OAOG;IACH,SAAS,CAAC,uBAAuB,CAAC,OAAO,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI;IAI9D;;;;;;;OAOG;IACH,SAAS,CAAC,qBAAqB,CAAC,OAAO,EAAE,GAAG,GAAG,MAAM,GAAG,IAAI;IAI5D;;;;;;;;;;OAUG;IACH,SAAS,CAAC,0CAA0C,CAChD,MAAM,EAAE,kBAAkB,EAC1B,YAAY,EAAE,MAAM,EACpB,gBAAgB,EAAE,MAAM,EACxB,MAAM,GAAE,MAAU,GACnB;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE;IAqDhD;;;;;;;;;;OAUG;cACa,wCAAwC,CACpD,MAAM,EAAE,kBAAkB,EAC1B,YAAY,EAAE,MAAM,EACpB,gBAAgB,EAAE,MAAM,EACxB,MAAM,GAAE,MAAU,GACnB,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAwEzD;;;;;;;;OAQG;cACa,wCAAwC,CACpD,MAAM,EAAE,kBAAkB,EAC1B,YAAY,EAAE,MAAM,GACrB,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IA+DzD;;;;;;;;;OASG;IACH,SAAS,CAAC,oCAAoC,CAC1C,MAAM,EAAE,kBAAkB,EAC1B,YAAY,EAAE,MAAM,GACrB;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE;IAqDhD;;;;;;;;;;;OAWG;cACa,sBAAsB,CAAC,CAAC,EACpC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,CAAC,EACV,YAAY,EAAE,MAAM,EACpB,kBAAkB,CAAC,EAAE,oBAAoB,GAC1C,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAqGhC;;;;;;;;OAQG;cACa,eAAe,CAAC,CAAC,EAC7B,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAC9B,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,mBAAmB,EAC9B,YAAY,EAAE,iBAAiB,EAC/B,cAAc,EAAE,CAAC,EACjB,WAAW,EAAE,8BAA8B,GAC5C,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IA0BhC;;;;;;;OAOG;IACH,SAAS,CAAC,yBAAyB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,WAAW;IAuBjG;;;;;;;OAOG;IACH,SAAS,CAAC,2BAA2B,CAAC,QAAQ,EAAE,oBAAoB,EAAE,MAAM,EAAE,kBAAkB,GAAG,WAAW;IAQ9G;;;;;;;;;;;;;;;;;;OAkBG;YACW,wBAAwB;IA4FtC;;;;;;;;;;;;;;;;OAgBG;IACH,SAAS,CAAC,0BAA0B,CAChC,SAAS,EAAE,mBAAmB,GAAG,SAAS,EAC1C,KAAK,EAAE,uBAAuB,EAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAiC1B;;;;;;;;;;;;;;;;;;OAkBG;IACH,SAAS,CAAC,8BAA8B,CACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/C,IAAI;IA6CP;;;;;;;;OAQG;IACH,SAAS,CAAC,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAwB/F;;;;;;;;;;;;OAYG;IACU,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,sBAAsB,EAClH,WAAW,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC;IA+ClD;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,SAAS,CAAC,uBAAuB,CAC7B,MAAM,EAAE,kBAAkB,EAC1B,eAAe,EAAE,oBAAoB,EACrC,QAAQ,EAAE,uBAAuB,EACjC,cAAc,CAAC,EAAE,WAAW,GAC7B,WAAW,EAAE;IA0EhB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;cACa,eAAe,CAAC,EAAE,GAAG,GAAG,EAAE,EAAE,GAAG,GAAG,EAC9C,MAAM,EAAE,kBAAkB,CAAC,EAAE,CAAC,EAC9B,eAAe,EAAE,oBAAoB,CAAC,EAAE,CAAC,EACzC,QAAQ,EAAE,uBAAuB,EACjC,UAAU,EAAE,8BAA8B,EAC1C,OAAO,CAAC,EAAE,EAAE,EACZ,cAAc,CAAC,EAAE,WAAW,EAC5B,SAAS,GAAE,MAAU,GACtB,OAAO,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;IA4FlC;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAU7B;;;;;OAKG;IACH,SAAS,CAAC,wBAAwB,CAAC,KAAK,EAAE,uBAAuB,GAAG,KAAK,CAAC,qBAAqB,CAAC;IAehG,SAAS,CAAC,4BAA4B,CAAC,KAAK,EAAE,uBAAuB,GAAG,MAAM;IAW9E;;;;;;;;OAQG;IACH,OAAO,CAAC,mBAAmB;IAuC3B;;;;;;;OAOG;IACH,OAAO,CAAC,4BAA4B;IAwEpC;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAgD9B;;;;;;;;OAQG;IACH,OAAO,CAAC,qBAAqB;IAwB7B;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,6BAA6B;IAoBrC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,8BAA8B;IA4BtC;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,yBAAyB;IAwBjC;;;;;;;;OAQG;IACH,OAAO,CAAC,0BAA0B;IAyBlC;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;;;;;;;;;OAUG;IACH,SAAS,CAAC,oBAAoB,CAC1B,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,EACf,QAAQ,CAAC,EAAE,MAAM,EAAE,GACpB,OAAO;IAeV;;;;OAIG;IACH,SAAS,CAAC,kBAAkB,CACxB,WAAW,EAAE,sBAAsB,EAAE,EACrC,aAAa,EAAE,YAAY,EAAE,EAC7B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,OAAO,GAChB;QAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE;IAmC/E;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,8BAA8B,CACpC,aAAa,EAAE,YAAY,EAAE,GAAG,SAAS,GAC1C,YAAY,EAAE,GAAG,SAAS;IAkC7B;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAM7B;;;;;OAKG;YACW,kBAAkB;IAmLhC;;;;;;OAMG;YACW,yBAAyB;IA4BvC;;;;;;OAMG;YACW,gBAAgB;IA0D9B;;;;;;;;OAQG;IACH;;;;OAIG;IACH,OAAO,CAAC,+BAA+B;YAuCzB,kBAAkB;IA4BhC;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IA6BzB;;;;;;OAMG;IACH,OAAO,CAAC,yBAAyB;IAWjC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;;;;;;;;;;;OAYG;cACa,eAAe,CAAC,CAAC,GAAG,GAAG,EACnC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,kBAAkB,EAC1B,gBAAgB,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,IAAI,EAC7C,SAAS,GAAE,MAAU,GACtB,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAwKhC;;;OAGG;IACH,OAAO,CAAC,+BAA+B;IAIvC;;;;OAIG;YACW,iBAAiB;IAmb/B;;;;;;OAMG;IACH,OAAO,CAAC,8BAA8B;IAiCtC;;;;;;;;OAQG;YACW,2BAA2B;IAqCzC;;;;;;;OAOG;YACW,wBAAwB;IA+UtC;;;;;;;;OAQG;YACW,mBAAmB;IAiEjC;;;;;;;OAOG;YACW,0BAA0B;IA0RxC;;;;;;OAMG;IACH,OAAO,CAAC,0BAA0B;IAqDlC;;;;;;;;OAQG;IACH,OAAO,CAAC,cAAc;IA4BtB;;;;;;;;;OASG;IACH,OAAO,CAAC,yBAAyB;IA+CjC;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,oCAAoC;IAsD5C;;;;;;;;;OASG;YACW,kBAAkB;IAmYhC;;;;;;;;;;OAUG;IAMH;;;;OAIG;YACW,sBAAsB;IA+HpC;;OAEG;IACH,OAAO,CAAC,iCAAiC;YAsB3B,eAAe;IA8B7B;;;;;;;;;;OAUG;YACW,qBAAqB;IAmDnC;;;;;;;;OAQG;YACW,yBAAyB;IAoCvC;;;OAGG;YACW,iCAAiC;IA8B/C;;;;;;;;;;;;;;;OAeG;cACa,mBAAmB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA2EvF;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;IA0C/B;;;;;;;;OAQG;IACH,OAAO,CAAC,iBAAiB,CAA6C;YAExD,oBAAoB;IA6BlC;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IAoB7B;;;OAGG;YACW,kBAAkB;IA4BhC,OAAO,CAAC,sBAAsB;IAqB9B,OAAO,CAAC,wBAAwB;IAqBhC,SAAS,CAAC,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAyBlE,SAAS,CAAC,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAmCtE;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAUhC;;OAEG;YACW,qBAAqB;IAiBnC;;OAEG;YACW,wBAAwB;IAiBtC;;;OAGG;YACW,kCAAkC;IAyChD;;;;OAIG;YACW,gCAAgC;IA6D9C;;;OAGG;IACH,OAAO,CAAC,aAAa;IAiBrB;;;OAGG;IACH,OAAO,CAAC,+BAA+B;IAyBvC;;OAEG;YACW,6BAA6B;IA+D3C;;OAEG;YACW,mBAAmB;IA2BjC;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;IAuBhC;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,2BAA2B;IAkCnC;;;;OAIG;IACH,OAAO,CAAC,6BAA6B;IA6DrC;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAmC9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;;OAGG;YACW,gBAAgB;IAsB9B;;OAEG;YACW,mBAAmB;IAejC;;OAEG;YACW,sBAAsB;IAmDpC;;OAEG;YACW,2BAA2B;IAgEzC;;OAEG;YACW,iBAAiB;IA2B/B;;;;OAIG;YACW,mBAAmB;IAuBjC;;;;;;OAMG;YACW,qBAAqB;IAuBnC;;;;OAIG;YACW,gBAAgB;IA6F9B;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IA4B3B;;;;;;OAMG;cACa,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9F;;;;;;OAMG;cACa,yBAAyB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIlG;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;IAK/B;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;;;;;;;;;;OAWG;cACa,iCAAiC,CAAC,KAAK,EAAE,uBAAuB,EAAE,QAAQ,EAAE,0BAA0B,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAmC1I;;;;;;;OAOG;cACa,8BAA8B,CAC1C,MAAM,EAAE,kBAAkB,EAC1B,WAAW,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC;IAoIhB;;;;;;;;;OASG;cACa,oBAAoB,CAChC,MAAM,EAAE,wBAAwB,EAChC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,kBAAkB,GAC3B,OAAO,CAAC,8BAA8B,CAAC;IA8B1C;;;;;;;;OAQG;cACa,oBAAoB,CAChC,IAAI,EAAE,8BAA8B,EACpC,MAAM,EAAE,iBAAiB,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,EAC9C,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,kBAAkB,GAC3B,OAAO,CAAC,IAAI,CAAC;IAqBhB;;;;;;;;OAQG;cACa,cAAc,CAC1B,OAAO,EAAE,gBAAgB,EACzB,QAAQ,EAAE;QACN,WAAW,EAAE,eAAe,GAAG,YAAY,CAAC;QAC5C,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,EAAE,MAAM,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;KAC1B,EACD,MAAM,EAAE,kBAAkB,GAC3B,OAAO,CAAC,MAAM,CAAC;IAmFlB;;;;OAIG;IACH,SAAS,CAAC,+BAA+B,IAAI,MAAM;IASnD;;;;;;;OAOG;IACH;;;OAGG;IACH,SAAS,CAAC,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO;IAKxD,SAAS,CAAC,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM;IAUrF;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAmB3B;;;;;;OAMG;IACH,SAAS,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,EAAE,oBAAoB,GAAG,MAAM;IAuDjF;;;;;OAKG;IACH,SAAS,CAAC,0BAA0B,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM;IAMrE;;;OAGG;IACH,SAAS,CAAC,yBAAyB,CAAC,KAAK,EAAE,qBAAqB,GAAG,IAAI;IAMvE;;;;;;;OAOG;IACH,SAAS,CAAC,wBAAwB,CAC9B,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,kBAAkB,EAC1B,WAAW,EAAE,MAAM,GACpB,IAAI;IAoCP;;;OAGG;IACH,SAAS,CAAC,gBAAgB,CACtB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,YAAY,EAAE,MAAM,GACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAoB1B;;;;;;;;;;;;;;;;;OAiBG;IACH,SAAS,CAAC,uBAAuB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,YAAY,EAAE,MAAM,GAAG,GAAG;IAsDzG;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,gCAAgC,CACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,YAAY,EAAE,MAAM,GACrB,MAAM;IAaT;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAsC3D;;;;;;OAMG;IACH,OAAO,CAAC,yBAAyB;IAcjC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,+BAA+B;CAqD1C"}
+{"version":3,"file":"base-agent.d.ts","sourceRoot":"","sources":["../src/base-agent.ts"],"names":[],"mappings":"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"}

package/dist/base-agent.js

@@ -19,6 +19,7 @@ import { AIEngine } from '@memberjunction/aiengine';
 import { ActionEngineServer } from '@memberjunction/actions';
 import { AIAgentPermissionHelper } from '@memberjunction/ai-engine-base';
 import { AgentContextInjector } from './agent-context-injector.js';
+import { AgentPreExecutionRAG } from './agent-pre-execution-rag.js';
 import { RerankerService } from '@memberjunction/ai-reranker';
 import { AIPromptParams, ChildPromptParam, ConversationUtility, ParseFileOutputRef, parseAssignmentStrategy } from '@memberjunction/ai-core-plus';
 import { AgentRunner } from './AgentRunner.js';
@@ -237,6 +238,14 @@ export class BaseAgent {
          * Storage for injected notes and examples to include in result
          */
         this._injectedMemory = { notes: [], examples: [] };
+        /**
+         * Storage for injected pre-execution RAG context (Phase 1C of search-scopes-rag-plus).
+         * Contains the formatted `<retrieved_context>` system-message block actually injected
+         * into `conversationMessages`, plus the structured per-scope / combined result detail
+         * for downstream observability and artifact persistence.
+         */
+        this._ragContext = '';
+        this._injectedRAG = null;
         /**
          * Determines the request type ID based on the Chat step's context.
          * - If the responseForm has only approve/reject-style buttons, uses "Approval"
@@ -1091,7 +1100,8 @@ export class BaseAgent {
             const [config] = await Promise.all([
                 this.loadAgentConfiguration(params.agent),
                 this.preloadAgentData(wrappedParams),
-                this.InjectContextMemory(typeof inputText === 'string' ? inputText : '', params.agent, userId, companyId, params.contextUser, wrappedParams.conversationMessages, primaryScopeEntityId, primaryScopeRecordId, secondaryScopes, scopeConfig)
+                this.InjectContextMemory(typeof inputText === 'string' ? inputText : '', params.agent, userId, companyId, params.contextUser, wrappedParams.conversationMessages, primaryScopeEntityId, primaryScopeRecordId, secondaryScopes, scopeConfig),
+                this.InjectPreExecutionRAG(typeof inputText === 'string' ? inputText : '', params.agent, params.contextUser, wrappedParams.conversationMessages, params.conversationMessages, primaryScopeEntityId, primaryScopeRecordId, secondaryScopes, params.payload)
             ]);
             if (!config.success) {
                 this.logError(`Failed to load agent configuration: ${config.errorMessage}`, {
@@ -1387,6 +1397,67 @@ export class BaseAgent {
         this._injectedMemory = { notes, examples };
         return { notes, examples };
     }
+    /**
+     * Inject pre-execution RAG context for this agent using scoped search.
+     *
+     * Runs in parallel with `InjectContextMemory` during Phase 2 of `Execute()`. Loads the
+     * agent's `AIAgentSearchScope` rows (Phase IN 'PreExecution'|'Both'), renders any per-scope
+     * query templates, calls `SearchEngine.Search()` per scope, cross-scope RRF fuses the
+     * results when multiple scopes contributed, and unshifts a `<retrieved_context>` system
+     * message onto `conversationMessages`.
+     *
+     * When the agent has no active pre-execution scopes (or all scopes returned zero results),
+     * this method is a no-op — no system message is injected and `_injectedRAG` stays null.
+     *
+     * See plans/search-scopes-rag-plus.md §4 (Agent Integration — Pre-Execution RAG).
+     *
+     * @param lastUserMessage - The most recent user message text.
+     * @param agent - The agent being executed.
+     * @param contextUser - Calling user (threaded to SearchEngine + Metadata).
+     * @param conversationMessages - The mutated message array that flows to the LLM (system msg is unshifted here).
+     * @param originalMessages - The unmodified messages array (for template `recentMessages`).
+     * @param primaryScopeEntityId - Multi-tenant primary scope entity ID.
+     * @param primaryScopeRecordId - Multi-tenant primary scope record ID.
+     * @param secondaryScopes - Multi-tenant secondary scope dimensions.
+     * @param payload - The agent's current payload (for template rendering).
+     * @returns The structured RAG result, or `null` if no scopes produced results.
+     */
+    async InjectPreExecutionRAG(lastUserMessage, agent, contextUser, conversationMessages, originalMessages, primaryScopeEntityId, primaryScopeRecordId, secondaryScopes, payload) {
+        try {
+            if (!contextUser)
+                return null;
+            if (!agent?.ID)
+                return null;
+            const rag = new AgentPreExecutionRAG();
+            const result = await rag.Execute({
+                agent,
+                lastUserMessage,
+                recentMessages: originalMessages ? originalMessages.slice(-5) : undefined,
+                payload,
+                primaryScopeRecordId,
+                primaryScopeEntityId,
+                secondaryScopes,
+                contextUser
+            });
+            if (!result)
+                return null;
+            if (conversationMessages && result.formattedSystemMessage) {
+                this._ragContext = result.formattedSystemMessage;
+                conversationMessages.unshift({ role: 'system', content: this._ragContext });
+                this.logStatus(`🔎 Injected pre-execution RAG context: ${result.combinedResults.length} result(s) from ${result.queriedScopeIDs.length} scope(s)`, true);
+            }
+            this._injectedRAG = result;
+            return result;
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            this.logError(`InjectPreExecutionRAG failed — continuing without RAG context: ${msg}`, {
+                agent,
+                category: 'AgentPreExecutionRAG'
+            });
+            return null;
+        }
+    }
     /**
      * Converts UI markup (@{...} syntax) in user messages to plain text.
      * This prevents agents from being confused by UI-specific JSON syntax and reduces token usage.
@@ -3420,10 +3491,16 @@ The context is now within limits. Please retry your request with the recovered c
                 Value: value,
                 Type: 'Input'
             }));
-            // Build action context: preserve the agent's context and inject resolved storage account ID
-            const actionContext = this._resolvedStorageAccountId
-                ? { ...(typeof params.context === 'object' && params.context ? params.context : {}), __resolvedStorageAccountId: this._resolvedStorageAccountId }
-                : params.context;
+            // Build action context: preserve the agent's context, stamp the
+            // calling agent's identity so scope-aware actions (Scoped Search,
+            // future agent-aware tools) can attribute the call without the LLM
+            // needing to pass it explicitly, and inject resolved storage account ID.
+            const baseContext = typeof params.context === 'object' && params.context ? params.context : {};
+            const actionContext = {
+                ...baseContext,
+                AgentID: params.agent.ID,
+                ...(this._resolvedStorageAccountId ? { __resolvedStorageAccountId: this._resolvedStorageAccountId } : {}),
+            };
             // Execute the action and return the full ActionResult
             const result = await actionEngine.RunAction({
                 Action: actionEntity,