@memberjunction/ai-agents 6.2.0-edge.0 → 6.2.0-edge.2

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.2.0-edge.0",
+  "version": "6.2.0-edge.2",
   "description": "MemberJunction: AI Agent Execution and Management",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,23 +11,24 @@
   "author": "MemberJunction.com",
   "license": "BUSL-1.1",
   "dependencies": {
-    "@memberjunction/actions": "6.2.0-edge.0",
-    "@memberjunction/actions-base": "6.2.0-edge.0",
-    "@memberjunction/ai": "6.2.0-edge.0",
-    "@memberjunction/ai-core-plus": "6.2.0-edge.0",
-    "@memberjunction/ai-engine-base": "6.2.0-edge.0",
-    "@memberjunction/ai-prompts": "6.2.0-edge.0",
-    "@memberjunction/ai-reranker": "6.2.0-edge.0",
-    "@memberjunction/ai-vector-dupe": "6.2.0-edge.0",
-    "@memberjunction/ai-vector-sync": "6.2.0-edge.0",
-    "@memberjunction/aiengine": "6.2.0-edge.0",
-    "@memberjunction/context-crush": "6.2.0-edge.0",
-    "@memberjunction/core": "6.2.0-edge.0",
-    "@memberjunction/core-entities": "6.2.0-edge.0",
-    "@memberjunction/global": "6.2.0-edge.0",
-    "@memberjunction/search-engine": "6.2.0-edge.0",
-    "@memberjunction/storage": "6.2.0-edge.0",
-    "@memberjunction/templates": "6.2.0-edge.0",
+    "@memberjunction/actions": "6.2.0-edge.2",
+    "@memberjunction/actions-base": "6.2.0-edge.2",
+    "@memberjunction/ai": "6.2.0-edge.2",
+    "@memberjunction/ai-core-plus": "6.2.0-edge.2",
+    "@memberjunction/ai-engine-base": "6.2.0-edge.2",
+    "@memberjunction/ai-prompts": "6.2.0-edge.2",
+    "@memberjunction/ai-reranker": "6.2.0-edge.2",
+    "@memberjunction/ai-vector-dupe": "6.2.0-edge.2",
+    "@memberjunction/ai-vector-sync": "6.2.0-edge.2",
+    "@memberjunction/aiengine": "6.2.0-edge.2",
+    "@memberjunction/context-crush": "6.2.0-edge.2",
+    "@memberjunction/core": "6.2.0-edge.2",
+    "@memberjunction/core-entities": "6.2.0-edge.2",
+    "@memberjunction/global": "6.2.0-edge.2",
+    "@memberjunction/rubrics": "6.2.0-edge.2",
+    "@memberjunction/search-engine": "6.2.0-edge.2",
+    "@memberjunction/storage": "6.2.0-edge.2",
+    "@memberjunction/templates": "6.2.0-edge.2",
     "dotenv": "^17.2.4",
     "exceljs": "^4.4.0",
     "lodash": "^4.17.23",
@@ -40,7 +41,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"