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

package/dist/runtime-state-fragment.js

@@ -0,0 +1,173 @@
+import { AGENT_SPECIALIZATION_TAG, RUNTIME_STATE_DATETIME_HEADING, RUNTIME_STATE_PAYLOAD_HEADING, RUNTIME_STATE_SCRATCHPAD_HEADING, RUNTIME_STATE_TAG, } from './constants.js';
+/**
+ * Builds the trailing-message fragment for the loop agent's volatile state.
+ *
+ * Pure: no I/O, no framework dependencies. The caller (BaseAgent's prompt-execution prep) resolves
+ * the strings and decides which blocks to include; this class only renders them.
+ */
+export class RuntimeStateFragmentBuilder {
+    /**
+     * Render the complete fragment: an optional specialization block, then the runtime-state block.
+     * Returns an empty string if nothing was supplied, so callers can skip appending an empty message.
+     */
+    Build(input) {
+        const parts = [];
+        const specialization = input.Specialization?.trim();
+        if (specialization) {
+            parts.push(this.wrap(AGENT_SPECIALIZATION_TAG, specialization));
+        }
+        const state = this.RenderStateBlocks(input);
+        if (state) {
+            parts.push(this.wrap(RUNTIME_STATE_TAG, state));
+        }
+        return parts.join('\n\n');
+    }
+    /**
+     * Render just the three state sections, unwrapped, in the system-prompt template's shape.
+     * Exposed so the snapshot test can compare it against the template's own rendering.
+     */
+    RenderStateBlocks(input) {
+        const blocks = [];
+        if (input.DateTime) {
+            blocks.push(this.renderDateTime(input.DateTime));
+        }
+        if (input.Scratchpad) {
+            blocks.push(this.renderScratchpad(input.Scratchpad));
+        }
+        if (input.Payload) {
+            blocks.push(this.renderPayload(input.Payload.Value));
+        }
+        return blocks.join('\n\n');
+    }
+    renderDateTime(dt) {
+        return [
+            RUNTIME_STATE_DATETIME_HEADING,
+            `- **Date**: ${dt.Date} (${dt.DayOfWeek})`,
+            `- **Time**: ${dt.Time}`,
+        ].join('\n');
+    }
+    renderScratchpad(sp) {
+        return [
+            RUNTIME_STATE_SCRATCHPAD_HEADING,
+            'Your private working memory. Manage via `scratchpad` in your response.',
+            '',
+            '### Notes',
+            sp.Notes,
+            '',
+            `### Tasks (${sp.TaskSummary})`,
+            sp.Tasks,
+        ].join('\n');
+    }
+    renderPayload(value) {
+        // Mirrors the template's `{{ _CURRENT_PAYLOAD | dump | safe }}` — nunjucks `dump` is a compact JSON.stringify.
+        const json = JSON.stringify(value ?? {});
+        return [
+            RUNTIME_STATE_PAYLOAD_HEADING,
+            '**Payload:** Represents your work state. Request changes via `payloadChangeRequest`',
+            '```json',
+            json,
+            '```',
+        ].join('\n');
+    }
+    wrap(tag, body) {
+        return `<${tag}>\n${body}\n</${tag}>`;
+    }
+}
+/**
+ * Matches the fragment's tag literals — opening or closing, any case, tolerant of stray whitespace
+ * inside the angle brackets — so that text from anywhere else cannot pose as the real fragment.
+ */
+const FRAGMENT_TAG_PATTERN = new RegExp(`<\\s*(/?)\\s*(${RUNTIME_STATE_TAG}|${AGENT_SPECIALIZATION_TAG})\\s*>`, 'gi');
+/**
+ * Escapes the fragment's tag literals in a piece of text so they cannot be mistaken for the real
+ * trailing fragment. Applied to every non-system message in the OUTGOING copy of the history under
+ * `'trailingMessage'` placement — user turns, action results, sub-agent results, anything the model or
+ * an external source wrote — never to stored data, and never to the fragment itself.
+ *
+ * This closes tag SPOOFING only. A model that follows imperative text inside a tool result will do so
+ * with or without our tags (measured: Gemini 2.5 Flash/Pro obey; Claude Opus 5 refuses); that exposure
+ * is pre-existing, layout-independent, and addressed structurally elsewhere.
+ */
+export function EscapeRuntimeStateTags(text) {
+    return text.replace(FRAGMENT_TAG_PATTERN, (_m, slash, tag) => `&lt;${slash}${tag.toLowerCase()}&gt;`);
+}
+/**
+ * Returns a copy of the message with fragment tag literals escaped in its text content (string content,
+ * and `text` / `tool_result` blocks) and toolCalls arguments. Returns the SAME object when nothing
+ * needed escaping, so untouched messages keep their identity.
+ */
+export function EscapeRuntimeStateTagsInMessage(message) {
+    const escapedContent = escapeContent(message.content);
+    const escapedCalls = escapeToolCalls(message.toolCalls);
+    if (escapedContent === message.content && !escapedCalls.changed) {
+        return message;
+    }
+    return {
+        ...message,
+        content: escapedContent,
+        ...(message.toolCalls ? { toolCalls: escapedCalls.calls } : {})
+    };
+}
+function escapeValue(val) {
+    if (typeof val === 'string') {
+        const escaped = EscapeRuntimeStateTags(val);
+        return { value: escaped, changed: escaped !== val };
+    }
+    if (Array.isArray(val)) {
+        let changed = false;
+        const arr = val.map(item => {
+            const res = escapeValue(item);
+            if (res.changed)
+                changed = true;
+            return res.value;
+        });
+        return { value: changed ? arr : val, changed };
+    }
+    if (val && typeof val === 'object') {
+        let changed = false;
+        const obj = {};
+        for (const [k, v] of Object.entries(val)) {
+            const res = escapeValue(v);
+            if (res.changed)
+                changed = true;
+            obj[k] = res.value;
+        }
+        return { value: changed ? obj : val, changed };
+    }
+    return { value: val, changed: false };
+}
+function escapeToolCalls(calls) {
+    if (!calls || calls.length === 0) {
+        return { calls, changed: false };
+    }
+    let anyChanged = false;
+    const nextCalls = calls.map(c => {
+        if (!c.arguments)
+            return c;
+        const res = escapeValue(c.arguments);
+        if (res.changed) {
+            anyChanged = true;
+            return { ...c, arguments: res.value };
+        }
+        return c;
+    });
+    return { calls: anyChanged ? nextCalls : calls, changed: anyChanged };
+}
+function escapeContent(content) {
+    if (typeof content === 'string') {
+        return EscapeRuntimeStateTags(content);
+    }
+    let changed = false;
+    const blocks = content.map((block) => {
+        if ((block.type === 'text' || block.type === 'tool_result') && typeof block.content === 'string') {
+            const next = EscapeRuntimeStateTags(block.content);
+            if (next !== block.content) {
+                changed = true;
+                return { ...block, content: next };
+            }
+        }
+        return block;
+    });
+    return changed ? blocks : content;
+}
+//# sourceMappingURL=runtime-state-fragment.js.map

package/dist/runtime-state-fragment.js.map

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

package/dist/self-check.d.ts

@@ -0,0 +1,98 @@
+/** An Active SelfCheck link. Attempts default to 1 when the link does not set a maximum. */
+export interface SelfCheckLink {
+    Purpose: string;
+    Status: string;
+    MaxAttempts?: number | null;
+}
+/** One agent-rubric row the self-check lookup can see. */
+export interface SelfCheckLinkRow {
+    ID?: string;
+    Purpose?: string;
+    Status?: string;
+    RubricID?: string;
+    MaxSelfCheckAttempts?: number | null;
+    PassThreshold?: number | null;
+}
+/**
+ * Picks one Active SelfCheck link. The lowest id wins, so two Active links
+ * do not depend on which row the database returned first.
+ */
+export declare function PickSelfCheckLink(rows: SelfCheckLinkRow[]): SelfCheckLinkRow | undefined;
+export interface SelfCheckFailure {
+    Key: string;
+    Rationale?: string;
+}
+export interface SelfCheckDecision {
+    Action: 'skip' | 'accept' | 'retry' | 'fail' | 'record';
+    Attempt: number;
+    Message?: string;
+}
+/**
+ * Decides what a self-check does with a candidate final output.
+ * No Active SelfCheck link skips. A passing score is accepted.
+ * A loop agent retries while the attempt is still within MaxAttempts, so
+ * MaxAttempts 1 allows the first failure to retry. A flow agent records the
+ * result and leaves the run successful. A loop that has used its attempts fails.
+ */
+export declare function DecideSelfCheck(input: {
+    agentKind: 'loop' | 'flow';
+    link: SelfCheckLink | null;
+    attempt: number;
+    passed: boolean;
+    failedCriteria?: SelfCheckFailure[];
+}): SelfCheckDecision;
+/** The candidate still in memory. FinalPayload is written only after the run finishes. */
+export interface SelfCheckCandidate {
+    Message?: string;
+    Payload?: unknown;
+}
+export interface SelfCheckEngine {
+    EvaluateRecord(input: {
+        rubricId: string;
+        subjectEntityName: string;
+        subjectRecordId: string;
+        evaluator: 'LLM';
+        passThreshold?: number | null;
+        content?: {
+            text?: string;
+            data?: Record<string, unknown>;
+        };
+    }): Promise<{
+        evaluationId: string;
+        outcome: string | null;
+        criteria: {
+            key: string;
+            rationale?: string;
+        }[];
+    }>;
+}
+export interface SelfCheckValidation {
+    StepType: 'Validation';
+    EvaluationId: string;
+    Passed: boolean;
+    Message: string;
+}
+/**
+ * Runs one self-check evaluation and records a Validation step linked to it.
+ * The subject pointer is the current agent run. The text the judge scores is the
+ * in-memory message and payload, because the stored run does not have FinalPayload yet.
+ * The evaluator is the LLM rubric evaluator. The threshold is the link override
+ * when set, otherwise the version's threshold.
+ */
+export declare function ExecuteSelfCheck(input: {
+    engine: SelfCheckEngine;
+    link: SelfCheckLink & {
+        rubricId: string;
+        passThreshold?: number | null;
+    };
+    runId: string;
+    agentKind: 'loop' | 'flow';
+    attempt: number;
+    candidate?: SelfCheckCandidate;
+    record: (step: SelfCheckValidation) => void | Promise<void>;
+}): Promise<{
+    decision: SelfCheckDecision;
+    step: 'Success' | 'Failed' | 'Retry';
+    evaluationId: string;
+}>;
+//# sourceMappingURL=self-check.d.ts.map

package/dist/self-check.d.ts.map

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

package/dist/self-check.js

@@ -0,0 +1,74 @@
+/**
+ * Picks one Active SelfCheck link. The lowest id wins, so two Active links
+ * do not depend on which row the database returned first.
+ */
+export function PickSelfCheckLink(rows) {
+    return [...rows]
+        .filter(row => row.Status === 'Active' && row.Purpose === 'SelfCheck' && !!row.RubricID)
+        .sort((left, right) => String(left.ID ?? '').localeCompare(String(right.ID ?? '')))[0];
+}
+/**
+ * Decides what a self-check does with a candidate final output.
+ * No Active SelfCheck link skips. A passing score is accepted.
+ * A loop agent retries while the attempt is still within MaxAttempts, so
+ * MaxAttempts 1 allows the first failure to retry. A flow agent records the
+ * result and leaves the run successful. A loop that has used its attempts fails.
+ */
+export function DecideSelfCheck(input) {
+    if (!input.link || input.link.Purpose !== 'SelfCheck' || input.link.Status !== 'Active') {
+        return { Action: 'skip', Attempt: input.attempt };
+    }
+    if (input.passed)
+        return { Action: 'accept', Attempt: input.attempt };
+    const message = (input.failedCriteria ?? [])
+        .map(item => item.Rationale ? `${item.Key}: ${item.Rationale}` : item.Key)
+        .join('\n');
+    const maxAttempts = input.link.MaxAttempts ?? 1;
+    if (input.agentKind === 'loop' && input.attempt <= maxAttempts) {
+        return { Action: 'retry', Attempt: input.attempt, Message: message };
+    }
+    if (input.agentKind === 'flow') {
+        return { Action: 'record', Attempt: input.attempt, Message: message };
+    }
+    return { Action: 'fail', Attempt: input.attempt, Message: message || 'Self-check failed.' };
+}
+/**
+ * Runs one self-check evaluation and records a Validation step linked to it.
+ * The subject pointer is the current agent run. The text the judge scores is the
+ * in-memory message and payload, because the stored run does not have FinalPayload yet.
+ * The evaluator is the LLM rubric evaluator. The threshold is the link override
+ * when set, otherwise the version's threshold.
+ */
+export async function ExecuteSelfCheck(input) {
+    const result = await input.engine.EvaluateRecord({
+        rubricId: input.link.rubricId,
+        subjectEntityName: 'MJ: AI Agent Runs',
+        subjectRecordId: input.runId,
+        evaluator: 'LLM',
+        passThreshold: input.link.passThreshold ?? null,
+        ...(input.candidate ? {
+            content: {
+                text: input.candidate.Message,
+                data: { message: input.candidate.Message, finalPayload: input.candidate.Payload },
+            },
+        } : {}),
+    });
+    const passed = result.outcome === 'Passed' || result.outcome === 'Scored';
+    const failedCriteria = passed ? [] : result.criteria.map(item => ({ Key: item.key, Rationale: item.rationale }));
+    const decision = DecideSelfCheck({
+        agentKind: input.agentKind,
+        link: input.link,
+        attempt: input.attempt,
+        passed,
+        failedCriteria,
+    });
+    await input.record({
+        StepType: 'Validation',
+        EvaluationId: result.evaluationId,
+        Passed: passed,
+        Message: decision.Message ?? '',
+    });
+    const step = decision.Action === 'retry' ? 'Retry' : decision.Action === 'fail' ? 'Failed' : 'Success';
+    return { decision, step, evaluationId: result.evaluationId };
+}
+//# sourceMappingURL=self-check.js.map

package/dist/self-check.js.map

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

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"}