monomind 1.11.13 → 1.11.14

package/packages/@monomind/cli/dist/src/model/complexity-scorer.js

@@ -0,0 +1,106 @@
+/**
+ * Heuristic complexity scorer for task descriptions.
+ *
+ * Returns a score in [0, 100] that drives automatic model-tier selection.
+ * Higher scores indicate tasks that benefit from more capable (and costly)
+ * models.
+ */
+// ---------------------------------------------------------------------------
+// Keyword sets
+// ---------------------------------------------------------------------------
+const HIGH_COMPLEXITY_KEYWORDS = [
+    'architecture',
+    'distributed',
+    'security audit',
+    'cve',
+    'consensus',
+    'fault-tolerant',
+    'migrate',
+    'refactor across',
+    'orchestrat',
+    'design system',
+    'database schema',
+    'performance optim',
+    'threat model',
+    'encryption',
+    'zero-knowledge',
+];
+const LOW_COMPLEXITY_KEYWORDS = [
+    'format',
+    'list',
+    'rename',
+    'sort',
+    'typo',
+    'lint',
+    'log',
+    'comment',
+    'print',
+    'echo',
+    'delete unused',
+    'remove import',
+];
+/**
+ * Agent slugs that inherently deal with high-complexity work.
+ * When one of these agents is involved the score gets a +20 bonus.
+ */
+export const HIGH_COMPLEXITY_AGENTS = new Set([
+    'engineering-software-architect',
+    'security-architect',
+    'security-auditor',
+    'system-architect',
+    'performance-engineer',
+    'byzantine-coordinator',
+    'collective-intelligence-coordinator',
+]);
+// ---------------------------------------------------------------------------
+// Patterns
+// ---------------------------------------------------------------------------
+const STEP_INDICATOR_RE = /(?:step\s*\d|first[\s,].*then[\s,]|phase\s*\d)/i;
+const CODE_BLOCK_RE = /```[\s\S]*?```/;
+const FILE_REF_RE = /\b[\w./-]+\.\w{1,5}\b/;
+// ---------------------------------------------------------------------------
+// Scorer
+// ---------------------------------------------------------------------------
+/**
+ * Score the complexity of a task description.
+ *
+ * @param taskDescription - Free-text description of the task.
+ * @param agentSlug       - Optional agent identifier; certain agents boost the score.
+ * @returns A number in [0, 100].
+ */
+export function scoreComplexity(taskDescription, agentSlug) {
+    let score = 50;
+    const lower = taskDescription.toLowerCase();
+    const wordCount = taskDescription.trim().split(/\s+/).length;
+    // -- Word-count adjustments ------------------------------------------------
+    if (wordCount < 20) {
+        score -= 20;
+    }
+    if (wordCount > 100) {
+        score += 20;
+    }
+    if (wordCount > 200) {
+        score += 10;
+    }
+    // -- Keyword adjustments (first match only) --------------------------------
+    if (HIGH_COMPLEXITY_KEYWORDS.some((kw) => lower.includes(kw))) {
+        score += 10;
+    }
+    if (LOW_COMPLEXITY_KEYWORDS.some((kw) => lower.includes(kw))) {
+        score -= 10;
+    }
+    // -- Structural indicators -------------------------------------------------
+    if (STEP_INDICATOR_RE.test(taskDescription)) {
+        score += 10;
+    }
+    if (CODE_BLOCK_RE.test(taskDescription) || FILE_REF_RE.test(taskDescription)) {
+        score += 5;
+    }
+    // -- Agent bonus -----------------------------------------------------------
+    if (agentSlug && HIGH_COMPLEXITY_AGENTS.has(agentSlug)) {
+        score += 20;
+    }
+    // -- Clamp -----------------------------------------------------------------
+    return Math.max(0, Math.min(100, score));
+}
+//# sourceMappingURL=complexity-scorer.js.map

package/packages/@monomind/cli/dist/src/model/index.d.ts

@@ -0,0 +1,4 @@
+export { type ModelTier, type ModelSettings, type ModelPreference, TIER_DEFAULTS, MODEL_IDS, } from './model-settings.js';
+export { scoreComplexity, HIGH_COMPLEXITY_AGENTS, } from './complexity-scorer.js';
+export { type ResolvedModelSettings, resolveModelTier, } from './model-tier-resolver.js';
+//# sourceMappingURL=index.d.ts.map

package/packages/@monomind/cli/dist/src/model/index.js

@@ -0,0 +1,4 @@
+export { TIER_DEFAULTS, MODEL_IDS, } from './model-settings.js';
+export { scoreComplexity, HIGH_COMPLEXITY_AGENTS, } from './complexity-scorer.js';
+export { resolveModelTier, } from './model-tier-resolver.js';
+//# sourceMappingURL=index.js.map

package/packages/@monomind/cli/dist/src/model/model-settings.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Per-run model tier selection — types and constants.
+ *
+ * Each tier maps to a concrete Claude model ID and carries sensible defaults
+ * for token budget, temperature, and extended-thinking.
+ */
+export type ModelTier = 'haiku' | 'sonnet' | 'opus';
+export interface ModelSettings {
+    model: ModelTier;
+    maxTokens?: number;
+    maxCostUsd?: number;
+    extendedThinking?: boolean;
+    temperature?: number;
+}
+export interface ModelPreference {
+    default: ModelTier;
+    maxCostUsd?: number;
+    extendedThinking?: boolean;
+}
+export declare const TIER_DEFAULTS: Record<ModelTier, ModelSettings>;
+export declare const MODEL_IDS: Record<ModelTier, string>;
+//# sourceMappingURL=model-settings.d.ts.map

package/packages/@monomind/cli/dist/src/model/model-settings.js

@@ -0,0 +1,33 @@
+/**
+ * Per-run model tier selection — types and constants.
+ *
+ * Each tier maps to a concrete Claude model ID and carries sensible defaults
+ * for token budget, temperature, and extended-thinking.
+ */
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+export const TIER_DEFAULTS = {
+    haiku: {
+        model: 'haiku',
+        maxTokens: 2048,
+        temperature: 0.3,
+    },
+    sonnet: {
+        model: 'sonnet',
+        maxTokens: 8192,
+        temperature: 0.5,
+    },
+    opus: {
+        model: 'opus',
+        maxTokens: 16384,
+        temperature: 0.7,
+        extendedThinking: true,
+    },
+};
+export const MODEL_IDS = {
+    haiku: 'claude-haiku-4-5',
+    sonnet: 'claude-sonnet-4-5',
+    opus: 'claude-opus-4-5',
+};
+//# sourceMappingURL=model-settings.js.map

package/packages/@monomind/cli/dist/src/model/model-tier-resolver.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Resolves the concrete model tier for a given agent + task combination.
+ *
+ * Resolution order:
+ *   1. Orchestrator override (explicit)
+ *   2. Complexity-based automatic selection
+ *   3. Agent preference default
+ *   4. Fallback to sonnet
+ */
+import type { ModelSettings, ModelPreference } from './model-settings.js';
+export interface ResolvedModelSettings extends ModelSettings {
+    complexityScore: number;
+    resolutionReason: string;
+}
+/**
+ * Determine the best model tier for a task.
+ *
+ * @param agentSlug            - The agent that will execute the task.
+ * @param taskDescription      - Free-text task description.
+ * @param agentPreference      - Optional per-agent preference.
+ * @param orchestratorOverride - Optional hard override from the orchestrator.
+ */
+export declare function resolveModelTier(agentSlug: string, taskDescription: string, agentPreference?: ModelPreference, orchestratorOverride?: Partial<ModelSettings>): ResolvedModelSettings;
+//# sourceMappingURL=model-tier-resolver.d.ts.map

package/packages/@monomind/cli/dist/src/model/model-tier-resolver.js

@@ -0,0 +1,65 @@
+/**
+ * Resolves the concrete model tier for a given agent + task combination.
+ *
+ * Resolution order:
+ *   1. Orchestrator override (explicit)
+ *   2. Complexity-based automatic selection
+ *   3. Agent preference default
+ *   4. Fallback to sonnet
+ */
+import { TIER_DEFAULTS } from './model-settings.js';
+import { scoreComplexity, HIGH_COMPLEXITY_AGENTS } from './complexity-scorer.js';
+// ---------------------------------------------------------------------------
+// Resolver
+// ---------------------------------------------------------------------------
+/**
+ * Determine the best model tier for a task.
+ *
+ * @param agentSlug            - The agent that will execute the task.
+ * @param taskDescription      - Free-text task description.
+ * @param agentPreference      - Optional per-agent preference.
+ * @param orchestratorOverride - Optional hard override from the orchestrator.
+ */
+export function resolveModelTier(agentSlug, taskDescription, agentPreference, orchestratorOverride) {
+    const complexity = scoreComplexity(taskDescription, agentSlug);
+    // ----- 1. Orchestrator override ------------------------------------------
+    if (orchestratorOverride?.model) {
+        return buildResult(orchestratorOverride.model, complexity, 'orchestrator_override', agentPreference);
+    }
+    // ----- 2. Complexity-based selection -------------------------------------
+    const preferredDefault = agentPreference?.default ?? 'sonnet';
+    let tier;
+    let reason;
+    if (complexity < 30 && preferredDefault !== 'opus') {
+        tier = 'haiku';
+        reason = 'low_complexity';
+    }
+    else if (complexity >= 70 || HIGH_COMPLEXITY_AGENTS.has(agentSlug)) {
+        tier = 'opus';
+        reason = complexity >= 70 ? 'high_complexity' : 'high_complexity_agent';
+    }
+    else {
+        tier = preferredDefault;
+        reason = 'default_preference';
+    }
+    return buildResult(tier, complexity, reason, agentPreference);
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function buildResult(tier, complexityScore, resolutionReason, preference) {
+    const base = { ...TIER_DEFAULTS[tier] };
+    // Propagate preference overrides
+    if (preference?.maxCostUsd !== undefined) {
+        base.maxCostUsd = preference.maxCostUsd;
+    }
+    if (preference?.extendedThinking !== undefined) {
+        base.extendedThinking = preference.extendedThinking;
+    }
+    return {
+        ...base,
+        complexityScore,
+        resolutionReason,
+    };
+}
+//# sourceMappingURL=model-tier-resolver.js.map

package/packages/@monomind/cli/dist/src/monovector/capabilities.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Capability surface for the (removed) @monoes/* native learning packages.
+ *
+ * Lean teardown: the SONA / native / WASM learning layer (@monoes/sona, router,
+ * attention, learning-wasm, core, and @monomind/monovector-upstream) has been
+ * removed. This module is now a stub that always reports "nothing native is
+ * available", so every caller takes the pure-JS / keyword-routing path. The
+ * function and type surface is preserved so importers (index.ts, hooks-tools.ts,
+ * doctor.ts, neural.ts) keep compiling without change.
+ */
+export interface MonoesCapabilities {
+    /** @monoes/sona SonaEngine available — always false after teardown */
+    sona: boolean;
+    /** @monoes/router backend — always 'none' after teardown */
+    router: 'native' | 'js' | 'none';
+    /** @monoes/attention FlashAttention available — always false after teardown */
+    attention: boolean;
+    /** @monoes/learning-wasm WasmMicroLoRA available — always false after teardown */
+    learningWasm: boolean;
+    /** @monomind/monovector-upstream plugin loaded — always false after teardown */
+    upstreamPlugin: boolean;
+}
+/**
+ * Returns the stubbed capability surface — all native backends report absent.
+ * Async to preserve the original signature; callers `await` this everywhere.
+ */
+export declare function getCapabilities(): Promise<MonoesCapabilities>;
+/** Synchronous read of the (constant) capability surface. */
+export declare function getCachedCapabilities(): MonoesCapabilities | null;
+/** No-op after teardown — there is nothing to re-probe. */
+export declare function resetCapabilitiesCache(): void;
+/** Returns the stubbed capability surface — kept for API compatibility. */
+export declare function refreshCapabilities(): Promise<MonoesCapabilities>;
+//# sourceMappingURL=capabilities.d.ts.map

package/packages/@monomind/cli/dist/src/monovector/capabilities.js

@@ -0,0 +1,37 @@
+/**
+ * Capability surface for the (removed) @monoes/* native learning packages.
+ *
+ * Lean teardown: the SONA / native / WASM learning layer (@monoes/sona, router,
+ * attention, learning-wasm, core, and @monomind/monovector-upstream) has been
+ * removed. This module is now a stub that always reports "nothing native is
+ * available", so every caller takes the pure-JS / keyword-routing path. The
+ * function and type surface is preserved so importers (index.ts, hooks-tools.ts,
+ * doctor.ts, neural.ts) keep compiling without change.
+ */
+const STUB_CAPABILITIES = {
+    sona: false,
+    router: 'none',
+    attention: false,
+    learningWasm: false,
+    upstreamPlugin: false,
+};
+/**
+ * Returns the stubbed capability surface — all native backends report absent.
+ * Async to preserve the original signature; callers `await` this everywhere.
+ */
+export async function getCapabilities() {
+    return STUB_CAPABILITIES;
+}
+/** Synchronous read of the (constant) capability surface. */
+export function getCachedCapabilities() {
+    return STUB_CAPABILITIES;
+}
+/** No-op after teardown — there is nothing to re-probe. */
+export function resetCapabilitiesCache() {
+    /* no-op */
+}
+/** Returns the stubbed capability surface — kept for API compatibility. */
+export async function refreshCapabilities() {
+    return STUB_CAPABILITIES;
+}
+//# sourceMappingURL=capabilities.js.map

package/packages/@monomind/cli/dist/src/observability/replay-reader.d.ts

@@ -20,7 +20,7 @@ export interface SessionReplay extends SessionSummary {
 }
 export declare class ReplayReader {
     private sessionsDir;
-    constructor(cwd?: any);
+    constructor(cwd?: string);
     /**
      * Find and return the session data for a given session ID.
      * The ID may be a bare ID (e.g. "session-1234567890") or a timestamp number.

package/packages/@monomind/cli/dist/src/orchestration/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Orchestration — barrel exports for Three-Mode Team Routing (Task 22)
+ */
+export { RouteModeExecutor, CoordinateModeExecutor, CollaborateModeExecutor, parsePlan, } from './routing-modes.js';
+export type { OrchestrationMode, RouteModeConfig, CoordinateModeConfig, CollaborateModeConfig, ModeResult, AgentDispatcher, ModeExecutor, } from './routing-modes.js';
+export { ModeDispatcher } from './mode-dispatcher.js';
+//# sourceMappingURL=index.d.ts.map

package/packages/@monomind/cli/dist/src/orchestration/index.js

@@ -0,0 +1,6 @@
+/**
+ * Orchestration — barrel exports for Three-Mode Team Routing (Task 22)
+ */
+export { RouteModeExecutor, CoordinateModeExecutor, CollaborateModeExecutor, parsePlan, } from './routing-modes.js';
+export { ModeDispatcher } from './mode-dispatcher.js';
+//# sourceMappingURL=index.js.map

package/packages/@monomind/cli/dist/src/orchestration/mode-dispatcher.d.ts

@@ -0,0 +1,11 @@
+/**
+ * ModeDispatcher — selects and executes the correct mode executor
+ * based on the requested OrchestrationMode.
+ */
+import type { AgentDispatcher, CollaborateModeConfig, CoordinateModeConfig, ModeResult, OrchestrationMode, RouteModeConfig } from './routing-modes.js';
+export declare class ModeDispatcher {
+    private readonly dispatcher;
+    constructor(dispatcher: AgentDispatcher);
+    dispatchWithMode(mode: OrchestrationMode | undefined, config: RouteModeConfig | CoordinateModeConfig | CollaborateModeConfig): Promise<ModeResult>;
+}
+//# sourceMappingURL=mode-dispatcher.d.ts.map

package/packages/@monomind/cli/dist/src/orchestration/mode-dispatcher.js

@@ -0,0 +1,31 @@
+/**
+ * ModeDispatcher — selects and executes the correct mode executor
+ * based on the requested OrchestrationMode.
+ */
+import { CollaborateModeExecutor, CoordinateModeExecutor, RouteModeExecutor, } from './routing-modes.js';
+export class ModeDispatcher {
+    dispatcher;
+    constructor(dispatcher) {
+        this.dispatcher = dispatcher;
+    }
+    async dispatchWithMode(mode = 'route', config) {
+        switch (mode) {
+            case 'route': {
+                const executor = new RouteModeExecutor(this.dispatcher);
+                return executor.execute(config);
+            }
+            case 'coordinate': {
+                const executor = new CoordinateModeExecutor(this.dispatcher);
+                return executor.execute(config);
+            }
+            case 'collaborate': {
+                const executor = new CollaborateModeExecutor(this.dispatcher);
+                return executor.execute(config);
+            }
+            default: {
+                throw new Error(`Unknown orchestration mode: ${mode}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=mode-dispatcher.js.map

package/packages/@monomind/cli/dist/src/orchestration/routing-modes.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Three-Mode Team Routing — Task 22
+ *
+ * Provides three orchestration modes:
+ *  - route:       single-agent dispatch
+ *  - coordinate:  planner → fan-out → synthesizer
+ *  - collaborate: iterative A↔B with shared scratchpad
+ */
+export type OrchestrationMode = 'route' | 'coordinate' | 'collaborate';
+export interface RouteModeConfig {
+    agentSlug: string;
+    task: string;
+}
+export interface CoordinateModeConfig {
+    plannerSlug?: string;
+    synthesizerSlug?: string;
+    task: string;
+    maxSubtasks?: number;
+}
+export interface CollaborateModeConfig {
+    agentA: string;
+    agentB: string;
+    task: string;
+    maxIterations?: number;
+    convergencePhrase?: string;
+}
+export interface ModeResult {
+    mode: OrchestrationMode;
+    output: unknown;
+    agentsInvolved: string[];
+    iterationCount: number;
+    tokenUsage: {
+        input: number;
+        output: number;
+    };
+    latencyMs: number;
+}
+export interface AgentDispatcher {
+    dispatch(agentSlug: string, task: string, context?: string): Promise<{
+        output: unknown;
+        tokenUsage?: {
+            input: number;
+            output: number;
+        };
+    }>;
+}
+export declare abstract class ModeExecutor<TConfig> {
+    protected readonly dispatcher: AgentDispatcher;
+    constructor(dispatcher: AgentDispatcher);
+    abstract execute(config: TConfig): Promise<ModeResult>;
+}
+export declare class RouteModeExecutor extends ModeExecutor<RouteModeConfig> {
+    execute(config: RouteModeConfig): Promise<ModeResult>;
+}
+/**
+ * Extract a subtasks array from the planner output.
+ * Accepts either a raw array or JSON containing a `subtasks` key.
+ */
+export declare function parsePlan(output: unknown): string[];
+export declare class CoordinateModeExecutor extends ModeExecutor<CoordinateModeConfig> {
+    execute(config: CoordinateModeConfig): Promise<ModeResult>;
+    private addTokens;
+}
+export declare class CollaborateModeExecutor extends ModeExecutor<CollaborateModeConfig> {
+    execute(config: CollaborateModeConfig): Promise<ModeResult>;
+    private addTokens;
+}
+//# sourceMappingURL=routing-modes.d.ts.map

package/packages/@monomind/cli/dist/src/orchestration/routing-modes.js

@@ -0,0 +1,180 @@
+/**
+ * Three-Mode Team Routing — Task 22
+ *
+ * Provides three orchestration modes:
+ *  - route:       single-agent dispatch
+ *  - coordinate:  planner → fan-out → synthesizer
+ *  - collaborate: iterative A↔B with shared scratchpad
+ */
+import { SharedScratchpad } from '../../../shared/src/scratchpad.js';
+// ---------------------------------------------------------------------------
+// Abstract executor
+// ---------------------------------------------------------------------------
+const SLUG_RE = /^[a-z0-9][a-z0-9\-]{0,63}$/;
+const MAX_TASK_BYTES = 64 * 1024;
+function assertSlug(value, name) {
+    if (!SLUG_RE.test(value))
+        throw new Error(`Invalid agent slug for ${name}: ${JSON.stringify(value)}`);
+}
+function assertTask(task) {
+    if (!task || task.trim().length === 0)
+        throw new Error('task must not be empty');
+    if (task.length > MAX_TASK_BYTES)
+        throw new Error(`task exceeds maximum length (${MAX_TASK_BYTES} bytes)`);
+}
+export class ModeExecutor {
+    dispatcher;
+    constructor(dispatcher) {
+        this.dispatcher = dispatcher;
+    }
+}
+// ---------------------------------------------------------------------------
+// Route mode — single dispatch
+// ---------------------------------------------------------------------------
+export class RouteModeExecutor extends ModeExecutor {
+    async execute(config) {
+        assertSlug(config.agentSlug, 'agentSlug');
+        assertTask(config.task);
+        const start = Date.now();
+        const result = await this.dispatcher.dispatch(config.agentSlug, config.task);
+        return {
+            mode: 'route',
+            output: result.output,
+            agentsInvolved: [config.agentSlug],
+            iterationCount: 1,
+            tokenUsage: result.tokenUsage ?? { input: 0, output: 0 },
+            latencyMs: Date.now() - start,
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Coordinate mode — planner → fan-out → synthesizer
+// ---------------------------------------------------------------------------
+/**
+ * Extract a subtasks array from the planner output.
+ * Accepts either a raw array or JSON containing a `subtasks` key.
+ */
+export function parsePlan(output) {
+    if (Array.isArray(output))
+        return output.map(String);
+    const raw = typeof output === 'string' ? output : JSON.stringify(output);
+    try {
+        const parsed = JSON.parse(raw);
+        if (Array.isArray(parsed))
+            return parsed.map(String);
+        if (parsed !== null && typeof parsed === 'object' && Array.isArray(parsed.subtasks))
+            return parsed.subtasks.map(String);
+    }
+    catch {
+        // not JSON — treat the whole string as a single subtask
+    }
+    return [raw];
+}
+export class CoordinateModeExecutor extends ModeExecutor {
+    async execute(config) {
+        assertTask(config.task);
+        const start = Date.now();
+        const plannerSlug = config.plannerSlug ?? 'planner';
+        const synthesizerSlug = config.synthesizerSlug ?? 'hierarchical-coordinator';
+        assertSlug(plannerSlug, 'plannerSlug');
+        assertSlug(synthesizerSlug, 'synthesizerSlug');
+        const maxSubtasks = config.maxSubtasks ?? 8;
+        const totalTokens = { input: 0, output: 0 };
+        const agents = [plannerSlug];
+        // 1. Call planner
+        const planResult = await this.dispatcher.dispatch(plannerSlug, config.task);
+        this.addTokens(totalTokens, planResult.tokenUsage);
+        // 2. Parse subtasks & cap
+        const subtasks = parsePlan(planResult.output).slice(0, maxSubtasks);
+        // 3. Fan-out
+        const fanOutResults = await Promise.all(subtasks.map((subtask, i) => {
+            const workerSlug = `worker-${i}`;
+            agents.push(workerSlug);
+            return this.dispatcher.dispatch(workerSlug, subtask);
+        }));
+        for (const r of fanOutResults)
+            this.addTokens(totalTokens, r.tokenUsage);
+        // 4. Synthesize
+        agents.push(synthesizerSlug);
+        const synthesisContext = JSON.stringify(fanOutResults.map((r) => r.output));
+        const synthResult = await this.dispatcher.dispatch(synthesizerSlug, 'Synthesize the following results', synthesisContext);
+        this.addTokens(totalTokens, synthResult.tokenUsage);
+        return {
+            mode: 'coordinate',
+            output: synthResult.output,
+            agentsInvolved: agents,
+            iterationCount: 1 + subtasks.length + 1, // planner + workers + synthesizer
+            tokenUsage: totalTokens,
+            latencyMs: Date.now() - start,
+        };
+    }
+    addTokens(total, usage) {
+        if (usage) {
+            total.input += usage.input;
+            total.output += usage.output;
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Collaborate mode — iterative A↔B with shared scratchpad
+// ---------------------------------------------------------------------------
+export class CollaborateModeExecutor extends ModeExecutor {
+    async execute(config) {
+        assertTask(config.task);
+        assertSlug(config.agentA, 'agentA');
+        assertSlug(config.agentB, 'agentB');
+        const start = Date.now();
+        // Cap iterations: each iteration costs 2 LLM dispatches; an unbounded value
+        // turns this into an unbounded token-cost / OOM vector.
+        const maxIterations = Math.max(1, Math.min(config.maxIterations ?? 5, 20));
+        // Reject empty/short convergence phrase — empty string would make
+        // String(bResult.output).includes('') return true on iteration 1, bypassing
+        // the entire iterative review and locking in whatever Agent B produced.
+        const rawPhrase = (config.convergencePhrase ?? 'APPROVED').trim();
+        const convergencePhrase = rawPhrase.length >= 3 ? rawPhrase : 'APPROVED';
+        const pad = new SharedScratchpad();
+        const totalTokens = { input: 0, output: 0 };
+        let lastOutput;
+        for (let i = 0; i < maxIterations; i++) {
+            // Agent A
+            const aResult = await this.dispatcher.dispatch(config.agentA, config.task, pad.read());
+            pad.append(config.agentA, String(aResult.output));
+            this.addTokens(totalTokens, aResult.tokenUsage);
+            // Agent B
+            const bResult = await this.dispatcher.dispatch(config.agentB, config.task, pad.read());
+            pad.append(config.agentB, String(bResult.output));
+            this.addTokens(totalTokens, bResult.tokenUsage);
+            lastOutput = bResult.output;
+            // Convergence check — require the phrase as a stand-alone token so that
+            // an attacker who controls Agent A's output cannot embed `APPROVED` in
+            // prose and force premature convergence on iteration 1.
+            const escaped = convergencePhrase.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+            const convergenceRe = new RegExp(`(^|\\W)${escaped}(\\W|$)`);
+            if (convergenceRe.test(String(bResult.output))) {
+                return {
+                    mode: 'collaborate',
+                    output: lastOutput,
+                    agentsInvolved: [config.agentA, config.agentB],
+                    iterationCount: i + 1,
+                    tokenUsage: totalTokens,
+                    latencyMs: Date.now() - start,
+                };
+            }
+        }
+        return {
+            mode: 'collaborate',
+            output: lastOutput,
+            agentsInvolved: [config.agentA, config.agentB],
+            iterationCount: maxIterations,
+            tokenUsage: totalTokens,
+            latencyMs: Date.now() - start,
+        };
+    }
+    addTokens(total, usage) {
+        if (usage) {
+            total.input += usage.input;
+            total.output += usage.output;
+        }
+    }
+}
+//# sourceMappingURL=routing-modes.js.map

package/packages/@monomind/cli/dist/src/plugins/tests/demo-plugin-store.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env npx tsx
+/**
+ * Plugin Store Demo
+ * Demonstrates the IPFS-based plugin registry working end-to-end
+ */
+export {};
+//# sourceMappingURL=demo-plugin-store.d.ts.map