@mxf-dev/core 2.0.5 → 3.1.0

package/dist/types/TaskTypes.d.ts

@@ -62,6 +62,7 @@ export interface ChannelTask {
     maxParticipants?: number;
     coordinationMode?: 'independent' | 'collaborative' | 'sequential' | 'hierarchical';
     leadAgentId?: AgentId;
+    completionAgentId?: AgentId;
     agentSelectionCriteria?: {
         minimumCapabilityMatch?: number;
         excludeBusyAgents?: boolean;
@@ -110,6 +111,7 @@ export interface CreateTaskRequest {
     maxParticipants?: number;
     coordinationMode?: 'independent' | 'collaborative' | 'sequential' | 'hierarchical';
     leadAgentId?: AgentId;
+    completionAgentId?: AgentId;
     agentSelectionCriteria?: {
         minimumCapabilityMatch?: number;
         excludeBusyAgents?: boolean;
@@ -134,6 +136,12 @@ export interface UpdateTaskRequest {
     metadata?: Record<string, any>;
     tags?: string[];
 }
+/**
+ * Fields that may be changed without performing a task lifecycle transition.
+ * Status and assignment changes go through dedicated operations so actor
+ * authorization and legal-state predicates remain on the database write.
+ */
+export type NonLifecycleTaskUpdateRequest = Omit<UpdateTaskRequest, 'status' | 'assignedAgentId'>;
 /**
  * Agent assignment analysis from SystemLLM
  */
@@ -214,7 +222,6 @@ export interface TaskOrchestrationConfig {
     taskTimeoutMinutes: number;
     enableLlmAssignment: boolean;
     llmConfidenceThreshold: number;
-    fallbackStrategy: AssignmentStrategy;
     enableTaskDependencies: boolean;
     enableLateJoinHandling: boolean;
     preventSimultaneousStart: boolean;

package/dist/types/TaskTypes.d.ts.map

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

package/dist/utils/GlobMatcher.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Glob matching for relative file paths without regular expressions.
+ *
+ * Supported syntax:
+ * - `*`  any run of characters inside one path segment (never crosses `/`)
+ * - `?`  exactly one character inside a path segment
+ * - `**` as a whole segment: zero or more whole directories. A `**` that
+ *        is part of a larger segment behaves like `*`.
+ * Every other character is literal, including regex metacharacters.
+ *
+ * The matcher walks the pattern and the candidate with a single backtrack
+ * point per wildcard, so cost is bounded by pattern length × candidate
+ * length. A compiled regular expression is not used because patterns such
+ * as `*a*a*a*b` made the engine backtrack for seconds per file name, and
+ * the filesystem walk runs the matcher once per directory entry on the
+ * server's event loop.
+ */
+/** Upper bound on `*` runs plus `?` characters in one pattern. */
+export declare const MAX_GLOB_WILDCARDS = 32;
+export interface GlobMatcher {
+    /**
+     * True when the pattern contains a path separator. Such a pattern must
+     * be tested against a relative path; a pattern without one addresses a
+     * bare file name.
+     */
+    readonly matchesPath: boolean;
+    /** Return true when `candidate` (segments separated by `/`) matches the whole pattern. */
+    test(candidate: string): boolean;
+}
+/**
+ * Compile a glob pattern into a matcher.
+ *
+ * @throws Error when the pattern is empty or uses more than
+ *         {@link MAX_GLOB_WILDCARDS} wildcards.
+ */
+export declare function createGlobMatcher(pattern: string, caseSensitive: boolean): GlobMatcher;
+//# sourceMappingURL=GlobMatcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GlobMatcher.d.ts","sourceRoot":"","sources":["../../src/utils/GlobMatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,kEAAkE;AAClE,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,MAAM,WAAW,WAAW;IACxB;;;;OAIG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,0FAA0F;IAC1F,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;CACpC;AA+FD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,WAAW,CAyBtF"}

package/dist/utils/GlobMatcher.js

@@ -0,0 +1,131 @@
+/**
+ * Glob matching for relative file paths without regular expressions.
+ *
+ * Supported syntax:
+ * - `*`  any run of characters inside one path segment (never crosses `/`)
+ * - `?`  exactly one character inside a path segment
+ * - `**` as a whole segment: zero or more whole directories. A `**` that
+ *        is part of a larger segment behaves like `*`.
+ * Every other character is literal, including regex metacharacters.
+ *
+ * The matcher walks the pattern and the candidate with a single backtrack
+ * point per wildcard, so cost is bounded by pattern length × candidate
+ * length. A compiled regular expression is not used because patterns such
+ * as `*a*a*a*b` made the engine backtrack for seconds per file name, and
+ * the filesystem walk runs the matcher once per directory entry on the
+ * server's event loop.
+ */
+/** Upper bound on `*` runs plus `?` characters in one pattern. */
+export const MAX_GLOB_WILDCARDS = 32;
+const countWildcards = (pattern) => {
+    let wildcards = 0;
+    for (let index = 0; index < pattern.length; index += 1) {
+        const character = pattern[index];
+        if (character === '?') {
+            wildcards += 1;
+        }
+        else if (character === '*' && pattern[index - 1] !== '*') {
+            wildcards += 1;
+        }
+    }
+    return wildcards;
+};
+/**
+ * Match one path segment against a segment pattern containing `*` and `?`.
+ * Classic greedy wildcard matching with one backtrack point: O(p × t).
+ */
+const matchSegment = (pattern, text) => {
+    let patternIndex = 0;
+    let textIndex = 0;
+    let starIndex = -1;
+    let starTextIndex = -1;
+    while (textIndex < text.length) {
+        const patternCharacter = pattern[patternIndex];
+        if (patternIndex < pattern.length &&
+            (patternCharacter === '?' || patternCharacter === text[textIndex])) {
+            patternIndex += 1;
+            textIndex += 1;
+        }
+        else if (patternIndex < pattern.length && patternCharacter === '*') {
+            starIndex = patternIndex;
+            starTextIndex = textIndex;
+            patternIndex += 1;
+        }
+        else if (starIndex !== -1) {
+            patternIndex = starIndex + 1;
+            starTextIndex += 1;
+            textIndex = starTextIndex;
+        }
+        else {
+            return false;
+        }
+    }
+    while (patternIndex < pattern.length && pattern[patternIndex] === '*') {
+        patternIndex += 1;
+    }
+    return patternIndex === pattern.length;
+};
+/**
+ * Match path segments against pattern segments. A `globstar` pattern
+ * segment plays the role `*` plays inside a segment: it absorbs zero or
+ * more whole path segments, with one backtrack point.
+ */
+const matchSegments = (patternSegments, pathSegments) => {
+    let patternIndex = 0;
+    let pathIndex = 0;
+    let globstarIndex = -1;
+    let globstarPathIndex = -1;
+    while (pathIndex < pathSegments.length) {
+        const patternSegment = patternSegments[patternIndex];
+        if (patternIndex < patternSegments.length && patternSegment.kind === 'globstar') {
+            globstarIndex = patternIndex;
+            globstarPathIndex = pathIndex;
+            patternIndex += 1;
+        }
+        else if (patternIndex < patternSegments.length &&
+            patternSegment.kind === 'segment' &&
+            matchSegment(patternSegment.text, pathSegments[pathIndex])) {
+            patternIndex += 1;
+            pathIndex += 1;
+        }
+        else if (globstarIndex !== -1) {
+            patternIndex = globstarIndex + 1;
+            globstarPathIndex += 1;
+            pathIndex = globstarPathIndex;
+        }
+        else {
+            return false;
+        }
+    }
+    while (patternIndex < patternSegments.length &&
+        patternSegments[patternIndex].kind === 'globstar') {
+        patternIndex += 1;
+    }
+    return patternIndex === patternSegments.length;
+};
+/**
+ * Compile a glob pattern into a matcher.
+ *
+ * @throws Error when the pattern is empty or uses more than
+ *         {@link MAX_GLOB_WILDCARDS} wildcards.
+ */
+export function createGlobMatcher(pattern, caseSensitive) {
+    if (typeof pattern !== 'string' || pattern.length === 0) {
+        throw new Error('Glob pattern must be a non-empty string');
+    }
+    const wildcards = countWildcards(pattern);
+    if (wildcards > MAX_GLOB_WILDCARDS) {
+        throw new Error(`Glob pattern uses ${wildcards} wildcards; at most ${MAX_GLOB_WILDCARDS} are supported`);
+    }
+    const normalizedPattern = caseSensitive ? pattern : pattern.toLowerCase();
+    const patternSegments = normalizedPattern.split('/').map(segment => (segment === '**' ? { kind: 'globstar' } : { kind: 'segment', text: segment }));
+    const matchesPath = pattern.includes('/');
+    return {
+        matchesPath,
+        test(candidate) {
+            const normalizedCandidate = caseSensitive ? candidate : candidate.toLowerCase();
+            return matchSegments(patternSegments, normalizedCandidate.split('/'));
+        }
+    };
+}
+//# sourceMappingURL=GlobMatcher.js.map

package/dist/utils/GlobMatcher.js.map

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

package/dist/utils/PromptTemplateReplacer.d.ts

@@ -30,7 +30,9 @@
  * - {{ISO_TIMESTAMP}}: Current ISO 8601 timestamp
  * - {{AGENT_ID}}: Agent ID (context-based)
  * - {{CHANNEL_ID}}: Channel ID (context-based)
+ * - {{SYSTEM_LLM_STANCE}} / {{SYSTEM_LLM_STANCE_GUIDANCE}}: the channel's SystemLLM stance and what it means for the agent
  */
+import { type SystemLlmStance } from '../types/SystemLlmStanceTypes.js';
 /**
  * Available prompt templates as constants
  * Export these for use in prompt builders
@@ -51,6 +53,8 @@ export declare const PROMPT_TEMPLATES: {
     readonly LLM_PROVIDER: "{{LLM_PROVIDER}}";
     readonly LLM_MODEL: "{{LLM_MODEL}}";
     readonly SYSTEM_LLM_STATUS: "{{SYSTEM_LLM_STATUS}}";
+    readonly SYSTEM_LLM_STANCE: "{{SYSTEM_LLM_STANCE}}";
+    readonly SYSTEM_LLM_STANCE_GUIDANCE: "{{SYSTEM_LLM_STANCE_GUIDANCE}}";
     readonly OS_PLATFORM: "{{OS_PLATFORM}}";
     readonly CURRENT_ORPAR_PHASE: "{{CURRENT_ORPAR_PHASE}}";
     readonly CURRENT_ORPAR_PHASE_GUIDANCE: "{{CURRENT_ORPAR_PHASE_GUIDANCE}}";
@@ -71,6 +75,7 @@ export interface TemplateContext {
     llmProvider?: string;
     llmModel?: string;
     systemLlmEnabled?: boolean;
+    systemLlmStance?: SystemLlmStance;
     currentOrparPhase?: 'Observe' | 'Reason' | 'Plan' | 'Act' | 'Reflect' | null;
     currentTaskId?: string;
     currentTaskTitle?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"PromptTemplateReplacer.d.ts","sourceRoot":"","sources":["../../src/utils/PromptTemplateReplacer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;CAkCnB,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,eAAe;IAE5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAG5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAG3B,iBAAiB,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,IAAI,CAAC;IAG7E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAG7B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED;;GAEG;AACH,qBAAa,sBAAsB;IAC/B;;;;;;OAMG;WACW,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,MAAM;IAgBjF;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAwCvC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAyFtC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAgB5B;;OAEG;WACW,wBAAwB,IAAI;QACtC,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;KACtB;CA6BJ"}
+{"version":3,"file":"PromptTemplateReplacer.d.ts","sourceRoot":"","sources":["../../src/utils/PromptTemplateReplacer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAA4B,KAAK,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAGlG;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;CAoCnB,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,eAAe;IAE5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAG5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,eAAe,CAAC,EAAE,eAAe,CAAC;IAGlC,iBAAiB,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,GAAG,IAAI,CAAC;IAG7E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAG7B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED;;GAEG;AACH,qBAAa,sBAAsB;IAC/B;;;;;;OAMG;WACW,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,MAAM;IAgBjF;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAwCvC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,uBAAuB;IAkGtC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAgB5B;;OAEG;WACW,wBAAwB,IAAI;QACtC,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;KACtB;CA6BJ"}

package/dist/utils/PromptTemplateReplacer.js

@@ -30,7 +30,10 @@
  * - {{ISO_TIMESTAMP}}: Current ISO 8601 timestamp
  * - {{AGENT_ID}}: Agent ID (context-based)
  * - {{CHANNEL_ID}}: Channel ID (context-based)
+ * - {{SYSTEM_LLM_STANCE}} / {{SYSTEM_LLM_STANCE_GUIDANCE}}: the channel's SystemLLM stance and what it means for the agent
  */
+import { DEFAULT_SYSTEMLLM_STANCE } from '../types/SystemLlmStanceTypes.js';
+import { buildSystemLlmStanceGuidance } from '../prompts/SystemLlmStanceGuidance.js';
 /**
  * Available prompt templates as constants
  * Export these for use in prompt builders
@@ -55,6 +58,8 @@ export const PROMPT_TEMPLATES = {
     LLM_PROVIDER: '{{LLM_PROVIDER}}',
     LLM_MODEL: '{{LLM_MODEL}}',
     SYSTEM_LLM_STATUS: '{{SYSTEM_LLM_STATUS}}',
+    SYSTEM_LLM_STANCE: '{{SYSTEM_LLM_STANCE}}',
+    SYSTEM_LLM_STANCE_GUIDANCE: '{{SYSTEM_LLM_STANCE_GUIDANCE}}',
     OS_PLATFORM: '{{OS_PLATFORM}}',
     // Control loop state
     CURRENT_ORPAR_PHASE: '{{CURRENT_ORPAR_PHASE}}',
@@ -165,6 +170,14 @@ export class PromptTemplateReplacer {
             const statusStr = context.systemLlmEnabled ? 'Enabled' : 'Disabled';
             result = result.replace(/\{\{SYSTEM_LLM_STATUS\}\}/g, statusStr);
         }
+        // Replace the SystemLLM stance and its guidance. Always replaced: an
+        // agent that does not know the stance is told the supportive one, which
+        // is the stance a server that never sends one is running.
+        const stance = context.systemLlmStance ?? DEFAULT_SYSTEMLLM_STANCE;
+        const stanceGuidance = buildSystemLlmStanceGuidance(stance);
+        result = result.replace(/\{\{SYSTEM_LLM_STANCE\}\}/g, stance);
+        // Function replacer: the guidance is prose and must not be parsed for `$` patterns.
+        result = result.replace(/\{\{SYSTEM_LLM_STANCE_GUIDANCE\}\}/g, () => stanceGuidance);
         // Replace ORPAR phase - always replace to avoid leftover template markers
         // When phase is null, show "(Not in active cycle)" to indicate ORPAR is available but not running
         const orparPhaseValue = context.currentOrparPhase || '(Not in active cycle)';

package/dist/utils/PromptTemplateReplacer.js.map

@@ -1 +1 @@
-{"version":3,"file":"PromptTemplateReplacer.js","sourceRoot":"","sources":["../../src/utils/PromptTemplateReplacer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC5B,qBAAqB;IACrB,SAAS,EAAE,eAAe;IAC1B,SAAS,EAAE,eAAe;IAC1B,aAAa,EAAE,mBAAmB;IAClC,WAAW,EAAE,iBAAiB;IAC9B,YAAY,EAAE,kBAAkB;IAChC,aAAa,EAAE,mBAAmB;IAClC,WAAW,EAAE,iBAAiB;IAE9B,4BAA4B;IAC5B,QAAQ,EAAE,cAAc;IACxB,UAAU,EAAE,gBAAgB;IAC5B,YAAY,EAAE,kBAAkB;IAEhC,wBAAwB;IACxB,mBAAmB,EAAE,yBAAyB;IAC9C,kBAAkB,EAAE,wBAAwB;IAE5C,+BAA+B;IAC/B,YAAY,EAAE,kBAAkB;IAChC,SAAS,EAAE,eAAe;IAC1B,iBAAiB,EAAE,uBAAuB;IAC1C,WAAW,EAAE,iBAAiB;IAE9B,qBAAqB;IACrB,mBAAmB,EAAE,yBAAyB;IAC9C,4BAA4B,EAAE,kCAAkC;IAEhE,cAAc;IACd,eAAe,EAAE,qBAAqB;IACtC,kBAAkB,EAAE,wBAAwB;IAC5C,mBAAmB,EAAE,yBAAyB;IAC9C,qBAAqB,EAAE,2BAA2B;CAC5C,CAAC;AAmCX;;GAEG;AACH,MAAM,OAAO,sBAAsB;IAC/B;;;;;;OAMG;IACI,MAAM,CAAC,gBAAgB,CAAC,MAAc,EAAE,OAAyB;QACpE,IAAI,CAAC,MAAM;YAAE,OAAO,MAAM,CAAC;QAE3B,IAAI,MAAM,GAAG,MAAM,CAAC;QAEpB,4CAA4C;QAC5C,MAAM,GAAG,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;QAE/C,wCAAwC;QACxC,IAAI,OAAO,EAAE,CAAC;YACV,MAAM,GAAG,IAAI,CAAC,uBAAuB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC3D,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;;OAGG;IACK,MAAM,CAAC,wBAAwB,CAAC,MAAc;QAClD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,QAAQ,CAAC;QAElE,wCAAwC;QACxC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;YAC/C,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,MAAM;YACb,GAAG,EAAE,SAAS;YACd,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,IAAI;YACZ,YAAY,EAAE,OAAO;SACxB,CAAC,CAAC;QAEH,MAAM,iBAAiB,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChD,MAAM,YAAY,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;QAEvC,qCAAqC;QACrC,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACpF,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,CAAC;QACjD,MAAM,YAAY,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACrF,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC;QAE5C,kBAAkB;QAClB,MAAM,UAAU,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QAExC,OAAO,MAAM;aACR,OAAO,CAAC,oBAAoB,EAAE,iBAAiB,CAAC;aAChD,OAAO,CAAC,oBAAoB,EAAE,QAAQ,CAAC;aACvC,OAAO,CAAC,wBAAwB,EAAE,YAAY,CAAC;aAC/C,OAAO,CAAC,sBAAsB,EAAE,SAAS,CAAC;aAC1C,OAAO,CAAC,uBAAuB,EAAE,WAAW,CAAC;aAC7C,OAAO,CAAC,wBAAwB,EAAE,YAAY,CAAC;aAC/C,OAAO,CAAC,sBAAsB,EAAE,UAAU,CAAC;aAC3C,OAAO,CAAC,sBAAsB,EAAE,UAAU,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,uBAAuB,CAAC,MAAc,EAAE,OAAwB;QAC3E,IAAI,MAAM,GAAG,MAAM,CAAC;QAEpB,+BAA+B;QAC/B,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,mBAAmB,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAClE,CAAC;QAED,iCAAiC;QACjC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,qBAAqB,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACtE,CAAC;QAED,mCAAmC;QACnC,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,uBAAuB,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC1E,CAAC;QAED,0CAA0C;QAC1C,IAAI,OAAO,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;YAC1C,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,8BAA8B,EAAE,OAAO,CAAC,iBAAiB,CAAC,QAAQ,EAAE,CAAC,CAAC;QAClG,CAAC;QAED,yCAAyC;QACzC,IAAI,OAAO,CAAC,gBAAgB,IAAI,OAAO,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClE,MAAM,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,6BAA6B,EAAE,YAAY,CAAC,CAAC;QACzE,CAAC;QAED,mCAAmC;QACnC,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,uBAAuB,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC1E,CAAC;QAED,gCAAgC;QAChC,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpE,CAAC;QAED,uCAAuC;QACvC,IAAI,OAAO,CAAC,gBAAgB,KAAK,SAAS,EAAE,CAAC;YACzC,MAAM,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;YACpE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,4BAA4B,EAAE,SAAS,CAAC,CAAC;QACrE,CAAC;QAED,0EAA0E;QAC1E,kGAAkG;QAClG,MAAM,eAAe,GAAG,OAAO,CAAC,iBAAiB,IAAI,uBAAuB,CAAC;QAC7E,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,8BAA8B,EAAE,eAAe,CAAC,CAAC;QAEzE,6DAA6D;QAC7D,IAAI,aAAa,GAAG,EAAE,CAAC;QACvB,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAC5B,MAAM,UAAU,GAA2B;gBACvC,SAAS,EAAE,oGAAoG;gBAC/G,QAAQ,EAAE,2FAA2F;gBACrG,MAAM,EAAE,qFAAqF;gBAC7F,KAAK,EAAE,mEAAmE;gBAC1E,SAAS,EAAE,gFAAgF;aAC9F,CAAC;YACF,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC,iBAAiB,CAAC,IAAI,EAAE,CAAC;QAChE,CAAC;QACD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,uCAAuC,EAAE,aAAa,CAAC,CAAC;QAEhF,kCAAkC;QAClC,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,0BAA0B,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;QAC/E,CAAC;QACD,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAC3B,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,6BAA6B,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAC5B,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,8BAA8B,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACvF,CAAC;QACD,IAAI,OAAO,CAAC,mBAAmB,KAAK,SAAS,EAAE,CAAC;YAC5C,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,gCAAgC,EAAE,GAAG,OAAO,CAAC,mBAAmB,GAAG,CAAC,CAAC;QACjG,CAAC;QAED,4BAA4B;QAC5B,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACvB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC9D,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,SAAS,GAAG,QAAQ,EAAE,GAAG,CAAC,CAAC;gBACvD,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;YAC7C,CAAC;QACL,CAAC;QAED,OAAO,MAAM,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,aAAa;QACxB,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrD,MAAM,WAAW,GAA2B;gBACxC,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,SAAS;gBAClB,OAAO,EAAE,OAAO;gBAChB,SAAS,EAAE,SAAS;gBACpB,SAAS,EAAE,SAAS;gBACpB,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE,KAAK;aACf,CAAC;YACF,OAAO,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC;QAC7D,CAAC;QACD,OAAO,SAAS,CAAC;IACrB,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,wBAAwB;QASlC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,QAAQ,CAAC;QAElE,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;YAC/C,OAAO,EAAE,MAAM;YACf,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,MAAM;YACb,GAAG,EAAE,SAAS;YACd,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,IAAI;YACZ,YAAY,EAAE,OAAO;SACxB,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACpF,MAAM,YAAY,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAErF,OAAO;YACH,QAAQ,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC;YAC/B,QAAQ;YACR,YAAY,EAAE,GAAG,CAAC,WAAW,EAAE;YAC/B,SAAS;YACT,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;YACzC,YAAY;YACZ,UAAU,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SACvC,CAAC;IACN,CAAC;CACJ"}
+{"version":3,"file":"PromptTemplateReplacer.js","sourceRoot":"","sources":["../../src/utils/PromptTemplateReplacer.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mxf-dev/core",
-  "version": "2.0.5",
+  "version": "3.1.0",
   "description": "Model Exchange Framework core: events, schemas, types, services, and protocol contracts",
   "type": "module",
   "license": "Apache-2.0",

package/src/config/ConfigManager.ts

@@ -33,6 +33,12 @@ import { EventBus } from '../events/EventBus.js';
 import { createBaseEventPayload } from '../schemas/EventPayloadSchema.js';
 import { EventName } from '../events/EventNames.js';
 import { ChannelSystemLlmChangeEvent as SharedChannelSystemLlmChangeEvent } from '../events/event-definitions/ConfigEvents.js';
+import {
+    capStance,
+    DEFAULT_SYSTEMLLM_STANCE,
+    DEFAULT_SYSTEMLLM_STANCE_CEILING,
+    type SystemLlmStance
+} from '../types/SystemLlmStanceTypes.js';
 
 /**
  * LLM model configuration
@@ -206,6 +212,18 @@ export interface SdkConfig {
             reflection?: boolean;
             coordination?: boolean;
         };
+
+        /**
+         * Server-wide stance: how SystemLLM talks to agents (see SystemLlmStanceTypes).
+         * Set from SYSTEMLLM_STANCE at boot. Unset means supportive.
+         */
+        stance?: SystemLlmStance;
+
+        /**
+         * Server-wide ceiling on the effective stance of every channel. Set from
+         * SYSTEMLLM_STANCE_MAX at boot. Unset means no ceiling.
+         */
+        stanceCeiling?: SystemLlmStance;
     };
 
     /**
@@ -223,6 +241,8 @@ export interface SdkConfig {
             reflection?: boolean;
             coordination?: boolean;
         };
+        /** Channel stance; unset means inherit the server-wide stance. */
+        stance?: SystemLlmStance;
     }>;
     
     /**
@@ -677,6 +697,33 @@ export interface IConfigManager {
      * @param channelId - Optional channel ID (if not provided, sets global)
      */
     setChannelSystemLlmOperationOverride(operation: string, enabled: boolean, channelId?: string): Observable<boolean>;
+
+    /**
+     * Effective SystemLLM stance for a channel: the channel's own stance when it
+     * has one, otherwise the server-wide stance, otherwise supportive.
+     * @param channelId - Optional channel ID (if not provided, returns the server-wide stance)
+     */
+    getChannelSystemLlmStance(channelId?: string): SystemLlmStance;
+
+    /**
+     * Set the SystemLLM stance
+     * @param stance - The stance
+     * @param channelId - Optional channel ID (if not provided, sets the server-wide stance)
+     */
+    setChannelSystemLlmStance(stance: SystemLlmStance, channelId?: string): Observable<boolean>;
+
+    /**
+     * Remove a channel's own stance so it inherits the server-wide one again.
+     * @param channelId - Channel ID
+     */
+    clearChannelSystemLlmStance(channelId: string): void;
+
+    /**
+     * Set the server-wide ceiling on the effective stance. Channel stances above
+     * it resolve to it.
+     * @param ceiling - The most adversarial stance any channel may reach
+     */
+    setChannelSystemLlmStanceCeiling(ceiling: SystemLlmStance): void;
 }
 
 /**
@@ -1262,6 +1309,76 @@ export class ConfigManager implements IConfigManager {
         return from(Promise.resolve(true));
     }
     
+    /**
+     * Effective SystemLLM stance for a channel.
+     *
+     * A channel entry without a stance inherits the server-wide one: unlike the
+     * enabled flag, a channel-specific entry does not shadow the global value
+     * unless it names a stance of its own.
+     */
+    public getChannelSystemLlmStance(channelId?: string): SystemLlmStance {
+        const ceiling = this.config.channelSystemLlm.stanceCeiling ?? DEFAULT_SYSTEMLLM_STANCE_CEILING;
+        if (channelId && this.config.channelSystemLlmById) {
+            const channelStance = this.config.channelSystemLlmById.get(channelId)?.stance;
+            if (channelStance) {
+                return capStance(channelStance, ceiling);
+            }
+        }
+        return capStance(this.config.channelSystemLlm.stance ?? DEFAULT_SYSTEMLLM_STANCE, ceiling);
+    }
+
+    /**
+     * Set the server-wide ceiling. Installed once at boot from
+     * SYSTEMLLM_STANCE_MAX; it is read on every stance resolution, so it
+     * applies to channels loaded before and after it is set.
+     */
+    public setChannelSystemLlmStanceCeiling(ceiling: SystemLlmStance): void {
+        this.config.channelSystemLlm.stanceCeiling = ceiling;
+    }
+
+    /**
+     * Set the SystemLLM stance, server-wide or for one channel.
+     */
+    public setChannelSystemLlmStance(stance: SystemLlmStance, channelId?: string): Observable<boolean> {
+        let enabled: boolean;
+        let operationOverrides: Record<string, boolean> | undefined;
+
+        if (channelId) {
+            if (!this.config.channelSystemLlmById) {
+                this.config.channelSystemLlmById = new Map();
+            }
+            const existingConfig = this.config.channelSystemLlmById.get(channelId) || { enabled: true };
+            existingConfig.stance = stance;
+            this.config.channelSystemLlmById.set(channelId, existingConfig);
+            enabled = existingConfig.enabled;
+            operationOverrides = existingConfig.operationOverrides;
+        } else {
+            this.config.channelSystemLlm.stance = stance;
+            enabled = this.config.channelSystemLlm.enabled;
+            operationOverrides = this.config.channelSystemLlm.operationOverrides;
+        }
+
+        this.emitChannelSystemLlmChanged(enabled, undefined, operationOverrides, channelId, stance);
+        this.emitConfigUpdated(['channelSystemLlm']);
+
+        return from(Promise.resolve(true));
+    }
+
+    /**
+     * Remove a channel's own stance so it inherits the server-wide one again.
+     *
+     * Called when a channel document is loaded without a stance, which happens
+     * on every channel load. Deliberately emits nothing: it restores the
+     * default rather than announcing a change, and the load path already emits
+     * one CHANNEL_SYSTEM_LLM_CHANGED through setChannelSystemLlmEnabled.
+     */
+    public clearChannelSystemLlmStance(channelId: string): void {
+        const existingConfig = this.config.channelSystemLlmById?.get(channelId);
+        if (existingConfig && existingConfig.stance !== undefined) {
+            delete existingConfig.stance;
+        }
+    }
+
     /**
      * Merge configurations
      * @param baseConfig - Base configuration
@@ -1412,14 +1529,22 @@ export class ConfigManager implements IConfigManager {
      * @param reason - Optional reason for the change
      * @param operationOverrides - Optional operation-specific overrides
      * @param channelId - Optional channel ID for channel-specific changes
+     * @param stance - Stance after the change, when the change set one
      * @private
      */
-    private emitChannelSystemLlmChanged(enabled: boolean, reason?: string, operationOverrides?: Record<string, boolean>, channelId?: string): void {
+    private emitChannelSystemLlmChanged(
+        enabled: boolean,
+        reason?: string,
+        operationOverrides?: Record<string, boolean>,
+        channelId?: string,
+        stance?: SystemLlmStance
+    ): void {
         const data: ChannelSystemLlmChangeEvent = {
             enabled,
             reason,
             operationOverrides,
             channelId,
+            stance,
             timestamp: Date.now()
         };
         const payload = createBaseEventPayload<ChannelSystemLlmChangeEvent>(

package/src/config/ModelContextLimits.ts

@@ -39,7 +39,13 @@ const DEFAULT_CONTEXT_LIMIT = 128_000;
  * then walks prefixes so "claude-3.5-sonnet-20241022" matches "claude-3.5-sonnet".
  */
 const MODEL_CONTEXT_LIMITS: Record<string, number> = {
-    // Claude models
+    // Claude models. The `-latest` rows are OpenRouter's `~anthropic/...-latest`
+    // aliases, which resolve to the newest model in each family. Windows are
+    // as OpenRouter listed them on 2026-08-21; they move with each release.
+    'claude-fable-latest': 1_000_000,
+    'claude-opus-latest': 1_000_000,
+    'claude-sonnet-latest': 1_000_000,
+    'claude-haiku-latest': 200_000,
     'claude-opus-4': 200_000,
     'claude-sonnet-4': 200_000,
     'claude-3.5-sonnet': 200_000,

package/src/constants/CoreTools.ts

@@ -19,18 +19,19 @@
  */
 
 /**
- * Core MXF Tools - Essential tools that should be available when allowedTools is empty/missing
+ * Core MXF Tools - Essential tools available when allowedTools is omitted
  * 
  * These tools provide a curated selection that demonstrates the MXF ecosystem
  * without overwhelming agents with all 180+ available tools.
  * 
- * IMPORTANT: allowedTools always takes priority - if specified, only those tools are allowed.
- * This core set is only used as a fallback when allowedTools is empty or missing.
+ * IMPORTANT: allowedTools always takes priority when specified. An explicit
+ * empty array denies every tool; this core set is used only when the policy is
+ * undefined.
  */
 
 /**
- * Essential core MXF tools that should always be available as fallback
- * when allowedTools is empty or missing
+ * Essential core MXF tools available as the fallback when allowedTools is
+ * undefined.
  */
 export const CORE_MXF_TOOLS = [
     // Meta-discovery tools (most important - gateway to other tools)

package/src/constants/DefaultPhaseProfiles.ts

@@ -560,6 +560,13 @@ export const MODEL_COST_ESTIMATES: Record<string, ParameterCostEstimate> = {
         outputCostPer1k: 0.00125,
         tier: 'budget'
     },
+    // OpenRouter `~anthropic/...-latest` aliases resolve to the newest model in
+    // each family; these rows carry the family's current rate.
+    '~anthropic/claude-haiku-latest': {
+        inputCostPer1k: 0.00100,
+        outputCostPer1k: 0.00500,
+        tier: 'budget'
+    },
 
     // Standard tier (under $5.00/1M tokens)
     'google/gemini-2.5-pro': {
@@ -582,6 +589,12 @@ export const MODEL_COST_ESTIMATES: Record<string, ParameterCostEstimate> = {
         reasoningCostPer1k: 0.01500,
         tier: 'premium'
     },
+    '~anthropic/claude-sonnet-latest': {
+        inputCostPer1k: 0.00200,
+        outputCostPer1k: 0.01000,
+        reasoningCostPer1k: 0.01000,
+        tier: 'premium'
+    },
     'openai/gpt-4.1': {
         inputCostPer1k: 0.00250,
         outputCostPer1k: 0.01000,
@@ -595,6 +608,22 @@ export const MODEL_COST_ESTIMATES: Record<string, ParameterCostEstimate> = {
         outputCostPer1k: 0.07500,
         reasoningCostPer1k: 0.07500,
         tier: 'ultra_premium'
+    },
+    // The `~anthropic/...-latest` alias rows carry the rates OpenRouter listed
+    // for them on 2026-08-21 (USD per 1k tokens); they move with each release.
+    '~anthropic/claude-opus-latest': {
+        inputCostPer1k: 0.00500,
+        outputCostPer1k: 0.02500,
+        reasoningCostPer1k: 0.02500,
+        tier: 'ultra_premium'
+    },
+    // Listed so a configured fable model is priced; nothing in the framework,
+    // demos, or tests selects it.
+    '~anthropic/claude-fable-latest': {
+        inputCostPer1k: 0.01000,
+        outputCostPer1k: 0.05000,
+        reasoningCostPer1k: 0.05000,
+        tier: 'ultra_premium'
     }
 };