@memberjunction/ai-agents 6.1.4 → 6.2.0-edge.1

package/dist/types/payload-operations.d.ts

@@ -37,6 +37,8 @@ export interface ParsedPathWithOperations {
  * @param pathSpec The path specification string
  * @returns Parsed path with operations
  */
+export declare function ParsePathWithOperations(pathSpec: string): ParsedPathWithOperations;
+/** @deprecated Use {@link ParsePathWithOperations}. */
 export declare function parsePathWithOperations(pathSpec: string): ParsedPathWithOperations;
 /**
  * Parses multiple path specifications
@@ -44,6 +46,8 @@ export declare function parsePathWithOperations(pathSpec: string): ParsedPathWit
  * @param pathSpecs Array of path specification strings
  * @returns Array of parsed paths with operations
  */
+export declare function ParsePathsWithOperations(pathSpecs: string[]): ParsedPathWithOperations[];
+/** @deprecated Use {@link ParsePathsWithOperations}. */
 export declare function parsePathsWithOperations(pathSpecs: string[]): ParsedPathWithOperations[];
 /**
  * Checks if a specific operation is allowed for a path
@@ -52,6 +56,8 @@ export declare function parsePathsWithOperations(pathSpecs: string[]): ParsedPat
  * @param operation The operation to check
  * @returns True if the operation is allowed
  */
+export declare function IsOperationAllowed(parsedPath: ParsedPathWithOperations, operation: PayloadOperation): boolean;
+/** @deprecated Use {@link IsOperationAllowed}. */
 export declare function isOperationAllowed(parsedPath: ParsedPathWithOperations, operation: PayloadOperation): boolean;
 /**
  * Formats a parsed path back to string representation
@@ -59,5 +65,7 @@ export declare function isOperationAllowed(parsedPath: ParsedPathWithOperations,
  * @param parsedPath The parsed path with operations
  * @returns String representation
  */
+export declare function FormatPathWithOperations(parsedPath: ParsedPathWithOperations): string;
+/** @deprecated Use {@link FormatPathWithOperations}. */
 export declare function formatPathWithOperations(parsedPath: ParsedPathWithOperations): string;
 //# sourceMappingURL=payload-operations.d.ts.map

package/dist/types/payload-operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payload-operations.d.ts","sourceRoot":"","sources":["../../src/types/payload-operations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,gBAAgB,EAAgC,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,kEAAkE;IAClE,aAAa,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,wBAAwB,CA6ClF;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,wBAAwB,EAAE,CAMxF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAC9B,UAAU,EAAE,wBAAwB,EACpC,SAAS,EAAE,gBAAgB,GAC5B,OAAO,CAET;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,wBAAwB,GAAG,MAAM,CAUrF"}
+{"version":3,"file":"payload-operations.d.ts","sourceRoot":"","sources":["../../src/types/payload-operations.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3D;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,gBAAgB,EAAgC,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,kEAAkE;IAClE,aAAa,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,wBAAwB,CA6ClF;AAED,uDAAuD;AACvD,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,wBAAwB,CAElF;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,wBAAwB,EAAE,CAMxF;AAED,wDAAwD;AACxD,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,wBAAwB,EAAE,CAExF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAC9B,UAAU,EAAE,wBAAwB,EACpC,SAAS,EAAE,gBAAgB,GAC5B,OAAO,CAET;AAED,kDAAkD;AAClD,wBAAgB,kBAAkB,CAC9B,UAAU,EAAE,wBAAwB,EACpC,SAAS,EAAE,gBAAgB,GAC5B,OAAO,CAET;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,wBAAwB,GAAG,MAAM,CAUrF;AAED,wDAAwD;AACxD,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,wBAAwB,GAAG,MAAM,CAErF"}

package/dist/types/payload-operations.js

@@ -22,7 +22,7 @@ export const ALL_OPERATIONS = ['add', 'update', 'delete'];
  * @param pathSpec The path specification string
  * @returns Parsed path with operations
  */
-export function parsePathWithOperations(pathSpec) {
+export function ParsePathWithOperations(pathSpec) {
     if (!pathSpec || typeof pathSpec !== 'string') {
         return { path: '', operations: [], allOperations: false };
     }
@@ -61,17 +61,25 @@ export function parsePathWithOperations(pathSpec) {
             ALL_OPERATIONS.every(op => operations.includes(op))
     };
 }
+/** @deprecated Use {@link ParsePathWithOperations}. */
+export function parsePathWithOperations(pathSpec) {
+    return ParsePathWithOperations(pathSpec);
+}
 /**
  * Parses multiple path specifications
  *
  * @param pathSpecs Array of path specification strings
  * @returns Array of parsed paths with operations
  */
-export function parsePathsWithOperations(pathSpecs) {
+export function ParsePathsWithOperations(pathSpecs) {
     if (!Array.isArray(pathSpecs)) {
         return [];
     }
-    return pathSpecs.map(spec => parsePathWithOperations(spec));
+    return pathSpecs.map(spec => ParsePathWithOperations(spec));
+}
+/** @deprecated Use {@link ParsePathsWithOperations}. */
+export function parsePathsWithOperations(pathSpecs) {
+    return ParsePathsWithOperations(pathSpecs);
 }
 /**
  * Checks if a specific operation is allowed for a path
@@ -80,16 +88,20 @@ export function parsePathsWithOperations(pathSpecs) {
  * @param operation The operation to check
  * @returns True if the operation is allowed
  */
-export function isOperationAllowed(parsedPath, operation) {
+export function IsOperationAllowed(parsedPath, operation) {
     return parsedPath.allOperations || parsedPath.operations.includes(operation);
 }
+/** @deprecated Use {@link IsOperationAllowed}. */
+export function isOperationAllowed(parsedPath, operation) {
+    return IsOperationAllowed(parsedPath, operation);
+}
 /**
  * Formats a parsed path back to string representation
  *
  * @param parsedPath The parsed path with operations
  * @returns String representation
  */
-export function formatPathWithOperations(parsedPath) {
+export function FormatPathWithOperations(parsedPath) {
     if (parsedPath.allOperations) {
         return parsedPath.path;
     }
@@ -98,4 +110,8 @@ export function formatPathWithOperations(parsedPath) {
     }
     return `${parsedPath.path}:${parsedPath.operations.join(',')}`;
 }
+/** @deprecated Use {@link FormatPathWithOperations}. */
+export function formatPathWithOperations(parsedPath) {
+    return FormatPathWithOperations(parsedPath);
+}
 //# sourceMappingURL=payload-operations.js.map

package/dist/types/payload-operations.js.map

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

package/dist/utils/ConversationMessageResolver.d.ts

@@ -57,6 +57,8 @@ export declare class ConversationMessageResolver {
      * @param conversationMessages - Array of chat messages to resolve from
      * @returns Resolved message(s) or property value(s), or undefined if invalid path
      */
+    static Resolve(conversationPath: string, conversationMessages: ChatMessage[]): ChatMessage | ChatMessage[] | any | undefined;
+    /** @deprecated Use {@link Resolve}. */
     static resolve(conversationPath: string, conversationMessages: ChatMessage[]): ChatMessage | ChatMessage[] | any | undefined;
     /**
      * Gets the role filter function for a given role specification.
@@ -72,6 +74,8 @@ export declare class ConversationMessageResolver {
      * @param value - The value to check
      * @returns True if the value is a conversation reference
      */
+    static IsConversationReference(value: string): boolean;
+    /** @deprecated Use {@link IsConversationReference}. */
     static isConversationReference(value: string): boolean;
     /**
      * Helper method to get a value from a nested object path.

package/dist/utils/ConversationMessageResolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConversationMessageResolver.d.ts","sourceRoot":"","sources":["../../src/utils/ConversationMessageResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,2BAA2B;IACpC;;;;;;;;;;;;;OAaG;WACW,OAAO,CACjB,gBAAgB,EAAE,MAAM,EACxB,oBAAoB,EAAE,WAAW,EAAE,GACpC,WAAW,GAAG,WAAW,EAAE,GAAG,GAAG,GAAG,SAAS;IAyEhD;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAgB5B;;;;;OAKG;WACW,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAK7D;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;CAwClC"}
+{"version":3,"file":"ConversationMessageResolver.d.ts","sourceRoot":"","sources":["../../src/utils/ConversationMessageResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,qBAAa,2BAA2B;IACpC;;;;;;;;;;;;;OAaG;WACW,OAAO,CACjB,gBAAgB,EAAE,MAAM,EACxB,oBAAoB,EAAE,WAAW,EAAE,GACpC,WAAW,GAAG,WAAW,EAAE,GAAG,GAAG,GAAG,SAAS;IAyEhD,uCAAuC;WACzB,OAAO,CACjB,gBAAgB,EAAE,MAAM,EACxB,oBAAoB,EAAE,WAAW,EAAE,GACpC,WAAW,GAAG,WAAW,EAAE,GAAG,GAAG,GAAG,SAAS;IAIhD;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAgB5B;;;;;OAKG;WACW,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAK7D,uDAAuD;WACzC,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAI7D;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;CAwClC"}

package/dist/utils/ConversationMessageResolver.js

@@ -56,7 +56,7 @@ export class ConversationMessageResolver {
      * @param conversationMessages - Array of chat messages to resolve from
      * @returns Resolved message(s) or property value(s), or undefined if invalid path
      */
-    static resolve(conversationPath, conversationMessages) {
+    static Resolve(conversationPath, conversationMessages) {
         // Parse: conversation.<role>.<position>[count].<property>
         const parts = conversationPath.split('.');
         if (parts[0]?.toLowerCase() !== 'conversation') {
@@ -118,6 +118,10 @@ export class ConversationMessageResolver {
         }
         return result;
     }
+    /** @deprecated Use {@link Resolve}. */
+    static resolve(conversationPath, conversationMessages) {
+        return this.Resolve(conversationPath, conversationMessages);
+    }
     /**
      * Gets the role filter function for a given role specification.
      *
@@ -146,10 +150,14 @@ export class ConversationMessageResolver {
      * @param value - The value to check
      * @returns True if the value is a conversation reference
      */
-    static isConversationReference(value) {
+    static IsConversationReference(value) {
         return typeof value === 'string' &&
             value.trim().toLowerCase().startsWith('conversation.');
     }
+    /** @deprecated Use {@link IsConversationReference}. */
+    static isConversationReference(value) {
+        return this.IsConversationReference(value);
+    }
     /**
      * Helper method to get a value from a nested object path.
      * Supports both dot notation (obj.prop) and array indexing (arr[0]).

package/dist/utils/ConversationMessageResolver.js.map

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

package/dist/volatile-child-prompt.d.ts

@@ -0,0 +1,33 @@
+import { SpecializationPlacement } from './agent-types/loop-agent-prompt-params.js';
+/** Where the specialization ends up for a run: one of the two concrete placements (never `'auto'`). */
+export type ResolvedSpecializationPlacement = Exclude<SpecializationPlacement, 'auto'>;
+/**
+ * Every template variable whose presence in a child prompt makes the rendered specialization
+ * change between iterations. Derived from the system-placeholder registry's "Date & Time"
+ * category (minus the stable timezone) plus the loop agent's own per-iteration variables (both
+ * from `./constants`), so a new temporal placeholder is picked up automatically.
+ */
+export declare const VOLATILE_PLACEHOLDER_NAMES: readonly string[];
+/**
+ * Returns the volatile placeholder names referenced by a template's text, in registry order.
+ * Matches whole identifiers only, so `_CURRENT_DATE` does not match inside `_CURRENT_DATE_AND_TIME`
+ * (both are volatile, but each is reported for itself). Empty array for empty/null text.
+ */
+export declare function DetectVolatilePlaceholders(templateText: string | null | undefined): string[];
+/** True when the template references at least one volatile placeholder. */
+export declare function IsVolatileChildPrompt(templateText: string | null | undefined): boolean;
+/** Normalizes the raw `specializationPlacement` param; anything unrecognized is `'auto'`. */
+export declare function ResolveSpecializationPlacementParam(promptParams: Record<string, unknown> | null | undefined): SpecializationPlacement;
+/**
+ * Decides where the specialization goes for this run.
+ *
+ * The runtime-state fragment is always the final message of the request, so relocation is always
+ * possible. An explicit `specializationPlacement` wins; `'auto'` relocates exactly when the child
+ * template is volatile.
+ *
+ * @param promptParams The merged `__agentTypePromptParams` for the agent.
+ * @param childTemplateText The child prompt's UNRENDERED template text (placeholders intact).
+ *   Pass `null` when the agent has no child prompt; the result is then `'systemPrompt'`.
+ */
+export declare function ResolveSpecializationPlacement(promptParams: Record<string, unknown> | null | undefined, childTemplateText: string | null | undefined): ResolvedSpecializationPlacement;
+//# sourceMappingURL=volatile-child-prompt.d.ts.map

package/dist/volatile-child-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"volatile-child-prompt.d.ts","sourceRoot":"","sources":["../src/volatile-child-prompt.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAGjF,uGAAuG;AACvG,MAAM,MAAM,+BAA+B,GAAG,OAAO,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAC;AAEvF;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAKvD,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,CAQ5F;AAED,2EAA2E;AAC3E,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAEtF;AAED,6FAA6F;AAC7F,wBAAgB,mCAAmC,CAC/C,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACzD,uBAAuB,CAGzB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAC1C,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EACxD,iBAAiB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7C,+BAA+B,CASjC"}

package/dist/volatile-child-prompt.js

@@ -0,0 +1,76 @@
+/**
+ * @fileoverview Decides whether an agent's child prompt (specialization) must be relocated out of
+ * the system prompt for prompt-cache stability.
+ *
+ * The agent OS doesn't control what a designer writes in a child prompt. If that template
+ * references a placeholder that changes per iteration or per minute — the current date/time, the
+ * Payload, the Scratchpad — then the rendered specialization mutates on every call from a position
+ * INSIDE the system prompt, ahead of the catalogs and the entire message history, and the provider's
+ * prefix cache breaks there no matter where the runtime-state tail is placed. Six active Loop agents
+ * do this in the shipped catalog (Agent Manager, Data Scout, Database Designer, Experiment Designer,
+ * Goal Analyst, Model Development Agent); IT95 TRS4 sweeps the live catalog for the current count.
+ *
+ * The check is a static scan of the child template's TEXT, decided once per run, so the layout
+ * never flips mid-run (a flip would itself break the prefix). See {@link SpecializationPlacement}.
+ *
+ * @module @memberjunction/ai-agents
+ */
+import { DEFAULT_SYSTEM_PLACEHOLDERS } from '@memberjunction/ai-core-plus';
+import { STABLE_TEMPORAL_PLACEHOLDERS, VOLATILE_AGENT_VARIABLES } from './constants.js';
+/**
+ * Every template variable whose presence in a child prompt makes the rendered specialization
+ * change between iterations. Derived from the system-placeholder registry's "Date & Time"
+ * category (minus the stable timezone) plus the loop agent's own per-iteration variables (both
+ * from `./constants`), so a new temporal placeholder is picked up automatically.
+ */
+export const VOLATILE_PLACEHOLDER_NAMES = [
+    ...DEFAULT_SYSTEM_PLACEHOLDERS
+        .filter(p => p.category === 'Date & Time' && !STABLE_TEMPORAL_PLACEHOLDERS.has(p.name))
+        .map(p => p.name),
+    ...VOLATILE_AGENT_VARIABLES,
+];
+/**
+ * Returns the volatile placeholder names referenced by a template's text, in registry order.
+ * Matches whole identifiers only, so `_CURRENT_DATE` does not match inside `_CURRENT_DATE_AND_TIME`
+ * (both are volatile, but each is reported for itself). Empty array for empty/null text.
+ */
+export function DetectVolatilePlaceholders(templateText) {
+    if (!templateText) {
+        return [];
+    }
+    return VOLATILE_PLACEHOLDER_NAMES.filter(name => {
+        const pattern = new RegExp(`(?<![A-Za-z0-9_])${name}(?![A-Za-z0-9_])`);
+        return pattern.test(templateText);
+    });
+}
+/** True when the template references at least one volatile placeholder. */
+export function IsVolatileChildPrompt(templateText) {
+    return DetectVolatilePlaceholders(templateText).length > 0;
+}
+/** Normalizes the raw `specializationPlacement` param; anything unrecognized is `'auto'`. */
+export function ResolveSpecializationPlacementParam(promptParams) {
+    const raw = promptParams?.specializationPlacement;
+    return raw === 'systemPrompt' || raw === 'trailingMessage' ? raw : 'auto';
+}
+/**
+ * Decides where the specialization goes for this run.
+ *
+ * The runtime-state fragment is always the final message of the request, so relocation is always
+ * possible. An explicit `specializationPlacement` wins; `'auto'` relocates exactly when the child
+ * template is volatile.
+ *
+ * @param promptParams The merged `__agentTypePromptParams` for the agent.
+ * @param childTemplateText The child prompt's UNRENDERED template text (placeholders intact).
+ *   Pass `null` when the agent has no child prompt; the result is then `'systemPrompt'`.
+ */
+export function ResolveSpecializationPlacement(promptParams, childTemplateText) {
+    if (!childTemplateText) {
+        return 'systemPrompt';
+    }
+    const explicit = ResolveSpecializationPlacementParam(promptParams);
+    if (explicit !== 'auto') {
+        return explicit;
+    }
+    return IsVolatileChildPrompt(childTemplateText) ? 'trailingMessage' : 'systemPrompt';
+}
+//# sourceMappingURL=volatile-child-prompt.js.map

package/dist/volatile-child-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"volatile-child-prompt.js","sourceRoot":"","sources":["../src/volatile-child-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAE3E,OAAO,EAAE,4BAA4B,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAKrF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAsB;IACzD,GAAG,2BAA2B;SACzB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,aAAa,IAAI,CAAC,4BAA4B,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SACtF,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACrB,GAAG,wBAAwB;CAC9B,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,YAAuC;IAC9E,IAAI,CAAC,YAAY,EAAE,CAAC;QAChB,OAAO,EAAE,CAAC;IACd,CAAC;IACD,OAAO,0BAA0B,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE;QAC5C,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,oBAAoB,IAAI,kBAAkB,CAAC,CAAC;QACvE,OAAO,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACP,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,qBAAqB,CAAC,YAAuC;IACzE,OAAO,0BAA0B,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AAC/D,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,mCAAmC,CAC/C,YAAwD;IAExD,MAAM,GAAG,GAAG,YAAY,EAAE,uBAAuB,CAAC;IAClD,OAAO,GAAG,KAAK,cAAc,IAAI,GAAG,KAAK,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;AAC9E,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,8BAA8B,CAC1C,YAAwD,EACxD,iBAA4C;IAE5C,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACrB,OAAO,cAAc,CAAC;IAC1B,CAAC;IACD,MAAM,QAAQ,GAAG,mCAAmC,CAAC,YAAY,CAAC,CAAC;IACnE,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO,QAAQ,CAAC;IACpB,CAAC;IACD,OAAO,qBAAqB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,cAAc,CAAC;AACzF,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@memberjunction/ai-agents",
   "type": "module",
-  "version": "6.1.4",
+  "version": "6.2.0-edge.1",
   "description": "MemberJunction: AI Agent Execution and Management",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,23 +11,23 @@
   "author": "MemberJunction.com",
   "license": "BUSL-1.1",
   "dependencies": {
-    "@memberjunction/actions": "6.1.4",
-    "@memberjunction/actions-base": "6.1.4",
-    "@memberjunction/ai": "6.1.4",
-    "@memberjunction/ai-core-plus": "6.1.4",
-    "@memberjunction/ai-engine-base": "6.1.4",
-    "@memberjunction/ai-prompts": "6.1.4",
-    "@memberjunction/ai-reranker": "6.1.4",
-    "@memberjunction/ai-vector-dupe": "6.1.4",
-    "@memberjunction/ai-vector-sync": "6.1.4",
-    "@memberjunction/aiengine": "6.1.4",
-    "@memberjunction/context-crush": "6.1.4",
-    "@memberjunction/core": "6.1.4",
-    "@memberjunction/core-entities": "6.1.4",
-    "@memberjunction/global": "6.1.4",
-    "@memberjunction/search-engine": "6.1.4",
-    "@memberjunction/storage": "6.1.4",
-    "@memberjunction/templates": "6.1.4",
+    "@memberjunction/actions": "6.2.0-edge.1",
+    "@memberjunction/actions-base": "6.2.0-edge.1",
+    "@memberjunction/ai": "6.2.0-edge.1",
+    "@memberjunction/ai-core-plus": "6.2.0-edge.1",
+    "@memberjunction/ai-engine-base": "6.2.0-edge.1",
+    "@memberjunction/ai-prompts": "6.2.0-edge.1",
+    "@memberjunction/ai-reranker": "6.2.0-edge.1",
+    "@memberjunction/ai-vector-dupe": "6.2.0-edge.1",
+    "@memberjunction/ai-vector-sync": "6.2.0-edge.1",
+    "@memberjunction/aiengine": "6.2.0-edge.1",
+    "@memberjunction/context-crush": "6.2.0-edge.1",
+    "@memberjunction/core": "6.2.0-edge.1",
+    "@memberjunction/core-entities": "6.2.0-edge.1",
+    "@memberjunction/global": "6.2.0-edge.1",
+    "@memberjunction/search-engine": "6.2.0-edge.1",
+    "@memberjunction/storage": "6.2.0-edge.1",
+    "@memberjunction/templates": "6.2.0-edge.1",
     "dotenv": "^17.2.4",
     "exceljs": "^4.4.0",
     "lodash": "^4.17.23",
@@ -40,7 +40,9 @@
   "devDependencies": {
     "@types/lodash": "^4.17.23",
     "@types/node": "24.10.11",
+    "@types/nunjucks": "^3.2.6",
     "@types/safe-regex": "^1.1.6",
+    "nunjucks": "3.2.4",
     "ts-node-dev": "^2.0.0",
     "typescript": "^5.9.3",
     "vitest": "^4.0.18"