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

package/dist/catalog-narrowing.d.ts

@@ -0,0 +1,136 @@
+/**
+ * @fileoverview Catalog narrowing (typed-decision plan, Task 3.7): the pure half.
+ *
+ * On a run's first prompt, `BaseAgent` asks one decision about its catalog: one Likelihood per
+ * action, sub-agent and skill, against the request that opened the run. These helpers turn the
+ * catalog into those questions, and the answers into the items the prompt hides. The call, the
+ * per-run cache and the `Catalog narrowing` step live on `BaseAgent`.
+ *
+ * Narrowing only HIDES entries from the prompt. It never removes a permission: the effective action
+ * and sub-agent sets that validation reads stay whole, so the model can still use anything it is
+ * permitted to. It is off unless `maxActionsInPrompt` or `maxSubAgentsInPrompt` is a positive number
+ * and the list is longer than it.
+ *
+ * Hidden must never mean unreachable, so a narrowed list starts with a note saying how many items it
+ * hides and how to reach them ({@link CatalogNarrowingNote}), and actions are narrowed only when the
+ * agent has Find Candidate Actions ({@link ReachableCatalogNarrowingLimits}).
+ *
+ * Narrowing is prose-only. It shortens the catalog the prompt describes, never the tools declared
+ * for native tool calling: there, a call to an undeclared tool is refused, so a hidden item has to
+ * stay declared to stay callable.
+ *
+ * @module @memberjunction/ai-agents
+ */
+import type { ChatMessage, DecisionAnswer, DecisionQuestion } from '@memberjunction/ai';
+/** The lists narrowing can shorten. */
+export type CatalogNarrowingKind = 'action' | 'agent' | 'skill';
+/**
+ * The action through which the model reaches an action narrowing hid. Calling an action takes its
+ * parameters, which only its catalog entry or this search gives, so actions are narrowed only when
+ * the agent has it.
+ */
+export declare const CATALOG_NARROWING_FIND_ACTIONS = "Find Candidate Actions";
+/**
+ * Actions never narrowed out, by name: the search tools the model uses to look past its catalog.
+ * Hiding Find Candidate Actions would turn "hidden" into "unreachable".
+ */
+export declare const CATALOG_NARROWING_ALWAYS_SHOWN_ACTIONS: readonly string[];
+/** The most characters of the opening request sent to the decision model as its state. */
+export declare const CATALOG_NARROWING_REQUEST_MAX_CHARS = 8000;
+/** How many items each list may show. `0` means the list is not narrowed. */
+export interface CatalogNarrowingLimits {
+    /** From `maxActionsInPrompt`. */
+    Actions: number;
+    /** From `maxSubAgentsInPrompt`. */
+    SubAgents: number;
+    /** Skills have no limit of their own, so they share `maxActionsInPrompt`. */
+    Skills: number;
+}
+/** One catalog entry offered to narrowing. */
+export interface CatalogNarrowingCandidate {
+    Kind: CatalogNarrowingKind;
+    ID: string;
+    Name: string;
+    Description: string;
+    /**
+     * Always shown, and so never asked about: an action or sub-agent with `MinExecutionsPerRun`
+     * set, or one of {@link CATALOG_NARROWING_ALWAYS_SHOWN_ACTIONS}.
+     */
+    Pinned: boolean;
+}
+/** What narrowing did to one list. */
+export interface CatalogNarrowingListOutcome {
+    /** Items in the list when it was narrowed. */
+    Total: number;
+    /** The most asked items kept. Pinned items are kept on top of it. */
+    Limit: number;
+    /** The names shown, in catalog order, pinned ones included. */
+    Kept: string[];
+    /** The names always shown. */
+    Pinned: string[];
+    /** Each asked item's probability, by name. */
+    Probabilities: Record<string, number>;
+}
+/** A run's narrowing: what each list hides, and what each narrowed list kept. */
+export interface CatalogNarrowingOutcome {
+    /** Normalized IDs of the items judged and not kept, per list. Anything else is shown. */
+    Hidden: Record<CatalogNarrowingKind, ReadonlySet<string>>;
+    /** One entry per list the decision was asked about. */
+    Lists: Partial<Record<CatalogNarrowingKind, CatalogNarrowingListOutcome>>;
+}
+/** A narrowing that hides nothing: the result when narrowing is off or fails open. */
+export declare function NoCatalogNarrowing(): CatalogNarrowingOutcome;
+/**
+ * Reads the per-list limits from merged agent-type prompt params. Anything but a number of at
+ * least 1 is `0`, which leaves the list whole: the default of -1 turns narrowing off.
+ */
+export declare function ResolveCatalogNarrowingLimits(promptParams: Record<string, unknown> | undefined): CatalogNarrowingLimits;
+/** Whether a list of `count` items is narrowed under `limit`: only a positive limit it exceeds. */
+export declare function IsCatalogListNarrowed(limit: number, count: number): boolean;
+/** The limit that applies to one list. */
+export declare function CatalogNarrowingLimitFor(limits: CatalogNarrowingLimits, kind: CatalogNarrowingKind): number;
+/** Whether an action is one of {@link CATALOG_NARROWING_ALWAYS_SHOWN_ACTIONS}. */
+export declare function IsAlwaysShownAction(name: string | null | undefined): boolean;
+/**
+ * The limits with narrowing turned off for any list whose hidden items the model could not reach.
+ * Actions need {@link CATALOG_NARROWING_FIND_ACTIONS} among the agent's actions. Sub-agents and
+ * skills are called by name alone, and the note on a narrowed list names what it hides, so they
+ * need nothing.
+ */
+export declare function ReachableCatalogNarrowingLimits(limits: CatalogNarrowingLimits, actionNames: readonly string[]): CatalogNarrowingLimits;
+/**
+ * The request that opened the run: the text of the last user message when the run starts, before
+ * the framework adds anything. Only text blocks count. Capped at
+ * {@link CATALOG_NARROWING_REQUEST_MAX_CHARS}. Empty when there is none.
+ */
+export declare function OpeningRequestText(messages: ChatMessage[] | undefined): string;
+/**
+ * The candidates the decision is asked about: the unpinned items of each narrowed list. A list
+ * whose unpinned items already fit its limit keeps them all, so it is not asked about.
+ */
+export declare function CatalogNarrowingCandidatesToAsk(candidates: CatalogNarrowingCandidate[], limits: CatalogNarrowingLimits): CatalogNarrowingCandidate[];
+/** The Likelihood question for one candidate. */
+export declare function CatalogNarrowingQuestion(candidate: CatalogNarrowingCandidate): string;
+/** One Likelihood per asked candidate, keyed by its position in `asked`. */
+export declare function BuildCatalogNarrowingQuestions(asked: CatalogNarrowingCandidate[]): Record<string, DecisionQuestion>;
+/**
+ * Keeps the `limit` asked items of each list with the highest probability, ties in catalog order,
+ * and hides the rest. Pinned items are always kept. Returns `undefined` when any asked item has no
+ * Likelihood answer with a finite probability, so the caller can show the full catalog instead of
+ * acting on a partial judgment.
+ */
+export declare function SelectCatalogNarrowing(candidates: CatalogNarrowingCandidate[], asked: CatalogNarrowingCandidate[], answers: Record<string, DecisionAnswer>, limits: CatalogNarrowingLimits): CatalogNarrowingOutcome | undefined;
+/**
+ * The items of one list the prompt shows: every item not in `hidden`, in their original order.
+ * Returns `items` itself when nothing is hidden, so an un-narrowed list is untouched.
+ */
+export declare function ApplyCatalogNarrowing<T extends {
+    ID: string;
+}>(items: T[], hidden: ReadonlySet<string> | undefined): T[];
+/**
+ * The line a narrowed list starts with: how many items it hides, and how the model reaches them.
+ * Actions point to {@link CATALOG_NARROWING_FIND_ACTIONS}, since calling one takes its parameters.
+ * Sub-agents and skills are called by name alone, so the note names them.
+ */
+export declare function CatalogNarrowingNote(kind: CatalogNarrowingKind, hiddenNames: readonly string[]): string;
+//# sourceMappingURL=catalog-narrowing.d.ts.map

package/dist/catalog-narrowing.d.ts.map

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

package/dist/catalog-narrowing.js

@@ -0,0 +1,212 @@
+/**
+ * @fileoverview Catalog narrowing (typed-decision plan, Task 3.7): the pure half.
+ *
+ * On a run's first prompt, `BaseAgent` asks one decision about its catalog: one Likelihood per
+ * action, sub-agent and skill, against the request that opened the run. These helpers turn the
+ * catalog into those questions, and the answers into the items the prompt hides. The call, the
+ * per-run cache and the `Catalog narrowing` step live on `BaseAgent`.
+ *
+ * Narrowing only HIDES entries from the prompt. It never removes a permission: the effective action
+ * and sub-agent sets that validation reads stay whole, so the model can still use anything it is
+ * permitted to. It is off unless `maxActionsInPrompt` or `maxSubAgentsInPrompt` is a positive number
+ * and the list is longer than it.
+ *
+ * Hidden must never mean unreachable, so a narrowed list starts with a note saying how many items it
+ * hides and how to reach them ({@link CatalogNarrowingNote}), and actions are narrowed only when the
+ * agent has Find Candidate Actions ({@link ReachableCatalogNarrowingLimits}).
+ *
+ * Narrowing is prose-only. It shortens the catalog the prompt describes, never the tools declared
+ * for native tool calling: there, a call to an undeclared tool is refused, so a hidden item has to
+ * stay declared to stay callable.
+ *
+ * @module @memberjunction/ai-agents
+ */
+import { NormalizeUUID } from '@memberjunction/global';
+const CATALOG_NARROWING_KINDS = ['action', 'agent', 'skill'];
+/**
+ * The action through which the model reaches an action narrowing hid. Calling an action takes its
+ * parameters, which only its catalog entry or this search gives, so actions are narrowed only when
+ * the agent has it.
+ */
+export const CATALOG_NARROWING_FIND_ACTIONS = 'Find Candidate Actions';
+/**
+ * Actions never narrowed out, by name: the search tools the model uses to look past its catalog.
+ * Hiding Find Candidate Actions would turn "hidden" into "unreachable".
+ */
+export const CATALOG_NARROWING_ALWAYS_SHOWN_ACTIONS = [CATALOG_NARROWING_FIND_ACTIONS, 'Find Candidate Agents'];
+/** The most characters of the opening request sent to the decision model as its state. */
+export const CATALOG_NARROWING_REQUEST_MAX_CHARS = 8000;
+/** A narrowing that hides nothing: the result when narrowing is off or fails open. */
+export function NoCatalogNarrowing() {
+    return { Hidden: { action: new Set(), agent: new Set(), skill: new Set() }, Lists: {} };
+}
+/**
+ * Reads the per-list limits from merged agent-type prompt params. Anything but a number of at
+ * least 1 is `0`, which leaves the list whole: the default of -1 turns narrowing off.
+ */
+export function ResolveCatalogNarrowingLimits(promptParams) {
+    const actions = positiveLimit(promptParams?.maxActionsInPrompt);
+    return { Actions: actions, SubAgents: positiveLimit(promptParams?.maxSubAgentsInPrompt), Skills: actions };
+}
+function positiveLimit(value) {
+    return typeof value === 'number' && value >= 1 ? Math.floor(value) : 0;
+}
+/** Whether a list of `count` items is narrowed under `limit`: only a positive limit it exceeds. */
+export function IsCatalogListNarrowed(limit, count) {
+    return limit > 0 && count > limit;
+}
+/** The limit that applies to one list. */
+export function CatalogNarrowingLimitFor(limits, kind) {
+    switch (kind) {
+        case 'action':
+            return limits.Actions;
+        case 'agent':
+            return limits.SubAgents;
+        case 'skill':
+            return limits.Skills;
+    }
+}
+/** Whether two action names match, ignoring case and surrounding spaces. */
+function sameActionName(a, b) {
+    return (a ?? '').trim().toLowerCase() === b.toLowerCase();
+}
+/** Whether an action is one of {@link CATALOG_NARROWING_ALWAYS_SHOWN_ACTIONS}. */
+export function IsAlwaysShownAction(name) {
+    return CATALOG_NARROWING_ALWAYS_SHOWN_ACTIONS.some(n => sameActionName(name, n));
+}
+/**
+ * The limits with narrowing turned off for any list whose hidden items the model could not reach.
+ * Actions need {@link CATALOG_NARROWING_FIND_ACTIONS} among the agent's actions. Sub-agents and
+ * skills are called by name alone, and the note on a narrowed list names what it hides, so they
+ * need nothing.
+ */
+export function ReachableCatalogNarrowingLimits(limits, actionNames) {
+    const canFindActions = actionNames.some(n => sameActionName(n, CATALOG_NARROWING_FIND_ACTIONS));
+    return canFindActions ? limits : { ...limits, Actions: 0 };
+}
+/**
+ * The request that opened the run: the text of the last user message when the run starts, before
+ * the framework adds anything. Only text blocks count. Capped at
+ * {@link CATALOG_NARROWING_REQUEST_MAX_CHARS}. Empty when there is none.
+ */
+export function OpeningRequestText(messages) {
+    const last = (messages ?? []).filter(m => m.role === 'user').pop();
+    if (!last) {
+        return '';
+    }
+    const text = typeof last.content === 'string'
+        ? last.content
+        : (last.content ?? []).filter(b => b.type === 'text').map(b => b.content).join('\n');
+    return text.trim().slice(0, CATALOG_NARROWING_REQUEST_MAX_CHARS);
+}
+/**
+ * The candidates the decision is asked about: the unpinned items of each narrowed list. A list
+ * whose unpinned items already fit its limit keeps them all, so it is not asked about.
+ */
+export function CatalogNarrowingCandidatesToAsk(candidates, limits) {
+    return CATALOG_NARROWING_KINDS.flatMap(kind => {
+        const limit = CatalogNarrowingLimitFor(limits, kind);
+        const list = candidates.filter(c => c.Kind === kind);
+        if (!IsCatalogListNarrowed(limit, list.length)) {
+            return [];
+        }
+        const unpinned = list.filter(c => !c.Pinned);
+        return unpinned.length > limit ? unpinned : [];
+    });
+}
+/** The Likelihood question for one candidate. */
+export function CatalogNarrowingQuestion(candidate) {
+    const description = (candidate.Description ?? '').trim();
+    return `This ${candidate.Kind} is useful for the request: ${candidate.Name}${description ? `: ${description}` : ''}`;
+}
+function questionKey(index) {
+    return `c${index + 1}`;
+}
+/** One Likelihood per asked candidate, keyed by its position in `asked`. */
+export function BuildCatalogNarrowingQuestions(asked) {
+    const questions = {};
+    asked.forEach((candidate, i) => {
+        questions[questionKey(i)] = { Kind: 'Likelihood', Instructions: CatalogNarrowingQuestion(candidate) };
+    });
+    return questions;
+}
+/**
+ * Keeps the `limit` asked items of each list with the highest probability, ties in catalog order,
+ * and hides the rest. Pinned items are always kept. Returns `undefined` when any asked item has no
+ * Likelihood answer with a finite probability, so the caller can show the full catalog instead of
+ * acting on a partial judgment.
+ */
+export function SelectCatalogNarrowing(candidates, asked, answers, limits) {
+    const probabilities = askedProbabilities(asked, answers);
+    if (!probabilities) {
+        return undefined;
+    }
+    const outcome = NoCatalogNarrowing();
+    for (const kind of CATALOG_NARROWING_KINDS) {
+        const askedOfKind = asked.map((c, i) => ({ Candidate: c, Probability: probabilities[i] })).filter(a => a.Candidate.Kind === kind);
+        if (askedOfKind.length === 0) {
+            continue;
+        }
+        const limit = CatalogNarrowingLimitFor(limits, kind);
+        // Array.prototype.sort is stable, so equal probabilities keep catalog order.
+        const hidden = [...askedOfKind].sort((a, b) => b.Probability - a.Probability).slice(limit).map(a => NormalizeUUID(a.Candidate.ID));
+        const hiddenSet = new Set(hidden);
+        outcome.Hidden[kind] = hiddenSet;
+        outcome.Lists[kind] = listOutcome(candidates.filter(c => c.Kind === kind), askedOfKind, hiddenSet, limit);
+    }
+    return outcome;
+}
+/** Each asked item's probability, by position, or `undefined` when any is missing or not finite. */
+function askedProbabilities(asked, answers) {
+    const probabilities = [];
+    for (let i = 0; i < asked.length; i++) {
+        const answer = answers[questionKey(i)];
+        if (answer?.Kind !== 'Likelihood' || typeof answer.Probability !== 'number' || !Number.isFinite(answer.Probability)) {
+            return undefined;
+        }
+        probabilities.push(answer.Probability);
+    }
+    return probabilities;
+}
+function listOutcome(list, askedOfKind, hidden, limit) {
+    const probabilities = {};
+    for (const a of askedOfKind) {
+        probabilities[a.Candidate.Name] = a.Probability;
+    }
+    return {
+        Total: list.length,
+        Limit: limit,
+        Kept: list.filter(c => !hidden.has(NormalizeUUID(c.ID))).map(c => c.Name),
+        Pinned: list.filter(c => c.Pinned).map(c => c.Name),
+        Probabilities: probabilities,
+    };
+}
+/**
+ * The items of one list the prompt shows: every item not in `hidden`, in their original order.
+ * Returns `items` itself when nothing is hidden, so an un-narrowed list is untouched.
+ */
+export function ApplyCatalogNarrowing(items, hidden) {
+    if (!hidden || hidden.size === 0) {
+        return items;
+    }
+    return items.filter(item => !hidden.has(NormalizeUUID(item?.ID)));
+}
+const NOTE_NOUNS = { action: 'action', agent: 'sub-agent', skill: 'skill' };
+/**
+ * The line a narrowed list starts with: how many items it hides, and how the model reaches them.
+ * Actions point to {@link CATALOG_NARROWING_FIND_ACTIONS}, since calling one takes its parameters.
+ * Sub-agents and skills are called by name alone, so the note names them.
+ */
+export function CatalogNarrowingNote(kind, hiddenNames) {
+    const count = hiddenNames.length;
+    const lead = `${count} of your ${NOTE_NOUNS[kind]}s ${count === 1 ? 'is' : 'are'} not described below`;
+    switch (kind) {
+        case 'action':
+            return `${lead}. If none below fits the task, call ${CATALOG_NARROWING_FIND_ACTIONS} to find one and its parameters, then call it by name.`;
+        case 'agent':
+            return `${lead}: ${hiddenNames.join(', ')}. Call one by name if it fits the task.`;
+        case 'skill':
+            return `${lead}: ${hiddenNames.join(', ')}. Activate one by name if it fits the task.`;
+    }
+}
+//# sourceMappingURL=catalog-narrowing.js.map

package/dist/catalog-narrowing.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @fileoverview The one source of truth for the string literals the agent runtime and its prompt
+ * templates agree on: template placeholder names, the trailing runtime-state fragment's tag
+ * literals and section headings, and the markers that identify a template still rendering volatile
+ * state itself.
+ *
+ * Why a standalone module: `base-agent.ts` imports the modules that need these
+ * (`volatile-child-prompt.ts`, `runtime-state-fragment.ts`, the agent types), so hanging them on
+ * `BaseAgent` would make every one of those imports circular. This file imports nothing, so anything
+ * in the package can depend on it.
+ *
+ * @module @memberjunction/ai-agents
+ */
+/** Template variable the loop agent fills with the current payload (`{{ _CURRENT_PAYLOAD | dump }}`). */
+export declare const CURRENT_PAYLOAD_PLACEHOLDER = "_CURRENT_PAYLOAD";
+/** Template variable holding the rendered scratchpad notes. */
+export declare const SCRATCHPAD_NOTES_PLACEHOLDER = "_SCRATCHPAD_NOTES";
+/** Template variable holding the rendered scratchpad task list. */
+export declare const SCRATCHPAD_TASKS_PLACEHOLDER = "_SCRATCHPAD_TASKS";
+/** Template variable holding the scratchpad task summary, e.g. "1 of 2 tasks complete". */
+export declare const SCRATCHPAD_TASK_SUMMARY_PLACEHOLDER = "_SCRATCHPAD_TASK_SUMMARY";
+/** System placeholder (see `SystemPlaceholderManager`) for today's date. */
+export declare const CURRENT_DATE_PLACEHOLDER = "_CURRENT_DATE";
+/** System placeholder for the current day of the week. */
+export declare const CURRENT_DAY_OF_WEEK_PLACEHOLDER = "_CURRENT_DAY_OF_WEEK";
+/** System placeholder for the current time. */
+export declare const CURRENT_TIME_PLACEHOLDER = "_CURRENT_TIME";
+/**
+ * Agent-level template variables (not system placeholders) that change every iteration. A child
+ * prompt referencing any of these mutates the system prompt per iteration, which is what
+ * `IsVolatileChildPrompt` detects.
+ */
+export declare const VOLATILE_AGENT_VARIABLES: readonly string[];
+/**
+ * Temporal system placeholders that are stable for a run and therefore NOT volatile.
+ * `_CURRENT_TIMEZONE` is in the "Date & Time" category but does not change between iterations.
+ */
+export declare const STABLE_TEMPORAL_PLACEHOLDERS: ReadonlySet<string>;
+/** Tag wrapping the runtime-state blocks in the trailing fragment. */
+export declare const RUNTIME_STATE_TAG = "mj-runtime-state";
+/** Tag wrapping a relocated agent specialization (child prompt) in the trailing fragment. */
+export declare const AGENT_SPECIALIZATION_TAG = "mj-agent-specialization";
+/** Heading of the date/time block, in the fragment and in the legacy system-prompt layout alike. */
+export declare const RUNTIME_STATE_DATETIME_HEADING = "## Current Date/Time";
+/** Heading of the scratchpad block. */
+export declare const RUNTIME_STATE_SCRATCHPAD_HEADING = "## Scratchpad State";
+/** Heading of the payload block. */
+export declare const RUNTIME_STATE_PAYLOAD_HEADING = "## Current State";
+/**
+ * Strings whose presence in a system prompt's UNRENDERED template text means that template still
+ * renders the volatile state itself — the legacy Loop layout on a database whose template has not
+ * synced, or any custom template that embeds the payload. `BaseAgent` suppresses the trailing
+ * fragment for such a template so the model never receives the state twice. Overridable per agent
+ * through `BaseAgent.volatileTemplateMarkers`.
+ */
+export declare const VOLATILE_TEMPLATE_MARKERS: readonly string[];
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,yGAAyG;AACzG,eAAO,MAAM,2BAA2B,qBAAqB,CAAC;AAE9D,+DAA+D;AAC/D,eAAO,MAAM,4BAA4B,sBAAsB,CAAC;AAEhE,mEAAmE;AACnE,eAAO,MAAM,4BAA4B,sBAAsB,CAAC;AAEhE,2FAA2F;AAC3F,eAAO,MAAM,mCAAmC,6BAA6B,CAAC;AAE9E,4EAA4E;AAC5E,eAAO,MAAM,wBAAwB,kBAAkB,CAAC;AAExD,0DAA0D;AAC1D,eAAO,MAAM,+BAA+B,yBAAyB,CAAC;AAEtE,+CAA+C;AAC/C,eAAO,MAAM,wBAAwB,kBAAkB,CAAC;AAExD;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EAKrD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,EAAE,WAAW,CAAC,MAAM,CAAkC,CAAC;AAIhG,sEAAsE;AACtE,eAAO,MAAM,iBAAiB,qBAAqB,CAAC;AAEpD,6FAA6F;AAC7F,eAAO,MAAM,wBAAwB,4BAA4B,CAAC;AAElE,oGAAoG;AACpG,eAAO,MAAM,8BAA8B,yBAAyB,CAAC;AAErE,uCAAuC;AACvC,eAAO,MAAM,gCAAgC,wBAAwB,CAAC;AAEtE,oCAAoC;AACpC,eAAO,MAAM,6BAA6B,qBAAqB,CAAC;AAEhE;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,MAAM,EAMtD,CAAC"}

package/dist/constants.js

@@ -0,0 +1,70 @@
+/**
+ * @fileoverview The one source of truth for the string literals the agent runtime and its prompt
+ * templates agree on: template placeholder names, the trailing runtime-state fragment's tag
+ * literals and section headings, and the markers that identify a template still rendering volatile
+ * state itself.
+ *
+ * Why a standalone module: `base-agent.ts` imports the modules that need these
+ * (`volatile-child-prompt.ts`, `runtime-state-fragment.ts`, the agent types), so hanging them on
+ * `BaseAgent` would make every one of those imports circular. This file imports nothing, so anything
+ * in the package can depend on it.
+ *
+ * @module @memberjunction/ai-agents
+ */
+// ── Template placeholders ───────────────────────────────────────────────────────────────────────
+/** Template variable the loop agent fills with the current payload (`{{ _CURRENT_PAYLOAD | dump }}`). */
+export const CURRENT_PAYLOAD_PLACEHOLDER = '_CURRENT_PAYLOAD';
+/** Template variable holding the rendered scratchpad notes. */
+export const SCRATCHPAD_NOTES_PLACEHOLDER = '_SCRATCHPAD_NOTES';
+/** Template variable holding the rendered scratchpad task list. */
+export const SCRATCHPAD_TASKS_PLACEHOLDER = '_SCRATCHPAD_TASKS';
+/** Template variable holding the scratchpad task summary, e.g. "1 of 2 tasks complete". */
+export const SCRATCHPAD_TASK_SUMMARY_PLACEHOLDER = '_SCRATCHPAD_TASK_SUMMARY';
+/** System placeholder (see `SystemPlaceholderManager`) for today's date. */
+export const CURRENT_DATE_PLACEHOLDER = '_CURRENT_DATE';
+/** System placeholder for the current day of the week. */
+export const CURRENT_DAY_OF_WEEK_PLACEHOLDER = '_CURRENT_DAY_OF_WEEK';
+/** System placeholder for the current time. */
+export const CURRENT_TIME_PLACEHOLDER = '_CURRENT_TIME';
+/**
+ * Agent-level template variables (not system placeholders) that change every iteration. A child
+ * prompt referencing any of these mutates the system prompt per iteration, which is what
+ * `IsVolatileChildPrompt` detects.
+ */
+export const VOLATILE_AGENT_VARIABLES = [
+    CURRENT_PAYLOAD_PLACEHOLDER,
+    SCRATCHPAD_NOTES_PLACEHOLDER,
+    SCRATCHPAD_TASKS_PLACEHOLDER,
+    SCRATCHPAD_TASK_SUMMARY_PLACEHOLDER,
+];
+/**
+ * Temporal system placeholders that are stable for a run and therefore NOT volatile.
+ * `_CURRENT_TIMEZONE` is in the "Date & Time" category but does not change between iterations.
+ */
+export const STABLE_TEMPORAL_PLACEHOLDERS = new Set(['_CURRENT_TIMEZONE']);
+// ── Trailing runtime-state fragment ─────────────────────────────────────────────────────────────
+/** Tag wrapping the runtime-state blocks in the trailing fragment. */
+export const RUNTIME_STATE_TAG = 'mj-runtime-state';
+/** Tag wrapping a relocated agent specialization (child prompt) in the trailing fragment. */
+export const AGENT_SPECIALIZATION_TAG = 'mj-agent-specialization';
+/** Heading of the date/time block, in the fragment and in the legacy system-prompt layout alike. */
+export const RUNTIME_STATE_DATETIME_HEADING = '## Current Date/Time';
+/** Heading of the scratchpad block. */
+export const RUNTIME_STATE_SCRATCHPAD_HEADING = '## Scratchpad State';
+/** Heading of the payload block. */
+export const RUNTIME_STATE_PAYLOAD_HEADING = '## Current State';
+/**
+ * Strings whose presence in a system prompt's UNRENDERED template text means that template still
+ * renders the volatile state itself — the legacy Loop layout on a database whose template has not
+ * synced, or any custom template that embeds the payload. `BaseAgent` suppresses the trailing
+ * fragment for such a template so the model never receives the state twice. Overridable per agent
+ * through `BaseAgent.volatileTemplateMarkers`.
+ */
+export const VOLATILE_TEMPLATE_MARKERS = [
+    RUNTIME_STATE_DATETIME_HEADING,
+    RUNTIME_STATE_SCRATCHPAD_HEADING,
+    RUNTIME_STATE_PAYLOAD_HEADING,
+    CURRENT_DATE_PLACEHOLDER,
+    CURRENT_PAYLOAD_PLACEHOLDER,
+];
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,mGAAmG;AAEnG,yGAAyG;AACzG,MAAM,CAAC,MAAM,2BAA2B,GAAG,kBAAkB,CAAC;AAE9D,+DAA+D;AAC/D,MAAM,CAAC,MAAM,4BAA4B,GAAG,mBAAmB,CAAC;AAEhE,mEAAmE;AACnE,MAAM,CAAC,MAAM,4BAA4B,GAAG,mBAAmB,CAAC;AAEhE,2FAA2F;AAC3F,MAAM,CAAC,MAAM,mCAAmC,GAAG,0BAA0B,CAAC;AAE9E,4EAA4E;AAC5E,MAAM,CAAC,MAAM,wBAAwB,GAAG,eAAe,CAAC;AAExD,0DAA0D;AAC1D,MAAM,CAAC,MAAM,+BAA+B,GAAG,sBAAsB,CAAC;AAEtE,+CAA+C;AAC/C,MAAM,CAAC,MAAM,wBAAwB,GAAG,eAAe,CAAC;AAExD;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAsB;IACvD,2BAA2B;IAC3B,4BAA4B;IAC5B,4BAA4B;IAC5B,mCAAmC;CACtC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAwB,IAAI,GAAG,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC;AAEhG,mGAAmG;AAEnG,sEAAsE;AACtE,MAAM,CAAC,MAAM,iBAAiB,GAAG,kBAAkB,CAAC;AAEpD,6FAA6F;AAC7F,MAAM,CAAC,MAAM,wBAAwB,GAAG,yBAAyB,CAAC;AAElE,oGAAoG;AACpG,MAAM,CAAC,MAAM,8BAA8B,GAAG,sBAAsB,CAAC;AAErE,uCAAuC;AACvC,MAAM,CAAC,MAAM,gCAAgC,GAAG,qBAAqB,CAAC;AAEtE,oCAAoC;AACpC,MAAM,CAAC,MAAM,6BAA6B,GAAG,kBAAkB,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAsB;IACxD,8BAA8B;IAC9B,gCAAgC;IAChC,6BAA6B;IAC7B,wBAAwB;IACxB,2BAA2B;CAC9B,CAAC"}