monomind 1.11.13 → 1.12.0

package/packages/@monomind/cli/dist/src/workflow/dsl-schema.js

@@ -0,0 +1,82 @@
+import { z } from 'zod';
+// ---------- Retry policy (reuse shape from dag-types) ----------
+const retryPolicySchema = z.object({
+    maxAttempts: z.number().int().min(1).max(10).optional(),
+    initialDelayMs: z.number().int().min(0).optional(),
+    backoffMultiplier: z.number().min(1).optional(),
+    jitterMs: z.number().int().min(0).optional(),
+    retryOn: z
+        .array(z.enum(['RATE_LIMIT', 'TIMEOUT', 'VALIDATION', 'UNKNOWN']))
+        .optional(),
+});
+// ---------- Lazy wrapper for recursive step references ----------
+// Use ZodTypeAny to avoid circular type reference (WorkflowStep is defined below)
+const lazyStep = z.lazy(() => workflowStepSchema);
+// ---------- 6 step-type schemas ----------
+export const agentStepSchema = z.object({
+    id: z.string().min(1),
+    type: z.literal('agent'),
+    agent: z.string().min(1),
+    task: z.string().min(1),
+    context_deps: z.array(z.string()).optional(),
+    output_key: z.string().optional(),
+    timeout_ms: z.number().int().positive().optional(),
+    retry_policy: retryPolicySchema.optional(),
+});
+export const parallelStepSchema = z.object({
+    id: z.string().min(1),
+    type: z.literal('parallel'),
+    steps: z.array(lazyStep).min(2).max(50),
+});
+export const sequenceStepSchema = z.object({
+    id: z.string().min(1),
+    type: z.literal('sequence'),
+    steps: z.array(lazyStep).min(1),
+});
+export const conditionalStepSchema = z.object({
+    id: z.string().min(1),
+    type: z.literal('conditional'),
+    condition: z.string().min(1),
+    if_true: lazyStep,
+    if_false: lazyStep.optional(),
+});
+export const mapReduceStepSchema = z.object({
+    id: z.string().min(1),
+    type: z.literal('map_reduce'),
+    items: z.string().min(1),
+    map_agent: z.string().min(1),
+    map_task: z.string().min(1),
+    reduce_agent: z.string().min(1),
+    reduce_task: z.string().min(1),
+    concurrent: z.number().int().min(1).max(500).optional(),
+});
+export const loopStepSchema = z.object({
+    id: z.string().min(1),
+    type: z.literal('loop'),
+    condition: z.string().min(1),
+    max_iterations: z.number().int().min(1).max(100),
+    body: z.array(lazyStep).min(1),
+});
+// ---------- Discriminated union of all step types ----------
+export const workflowStepSchema = z.discriminatedUnion('type', [
+    agentStepSchema,
+    parallelStepSchema,
+    sequenceStepSchema,
+    conditionalStepSchema,
+    mapReduceStepSchema,
+    loopStepSchema,
+]);
+// ---------- Semver regex ----------
+const semverRegex = /^\d+\.\d+\.\d+(-[\w.]+)?$/;
+// ---------- Top-level workflow definition ----------
+export const workflowDefinitionSchema = z.object({
+    name: z.string().min(1),
+    version: z.string().regex(semverRegex, 'version must be valid semver (e.g. 1.0.0)'),
+    description: z.string().optional(),
+    variables: z.record(z.string(), z.unknown()).optional(),
+    steps: z.array(workflowStepSchema).min(1),
+}).refine((def) => {
+    const ids = def.steps.map((s) => s.id);
+    return ids.length === new Set(ids).size;
+}, { message: 'Workflow step IDs must be unique', path: ['steps'] });
+//# sourceMappingURL=dsl-schema.js.map

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

@@ -0,0 +1,13 @@
+export { buildDAG, detectCycles, topologicalSort } from './dag-builder.js';
+export { DAGExecutor, type TaskRunner } from './dag-executor.js';
+export { resolveContext, ContextResolutionError } from './context-resolver.js';
+export type { DAGTask, TaskResult, DAGLevel, DAG, RetryPolicy, } from './dag-types.js';
+export { DEFAULT_RETRY_POLICY } from './dag-types.js';
+export { workflowStepSchema, workflowDefinitionSchema, agentStepSchema, parallelStepSchema, sequenceStepSchema, conditionalStepSchema, mapReduceStepSchema, loopStepSchema, } from './dsl-schema.js';
+export type { WorkflowStep, WorkflowDefinition } from './dsl-schema.js';
+export { DSLParser } from './dsl-parser.js';
+export { substitute } from './template-engine.js';
+export { evaluateCondition } from './condition-evaluator.js';
+export { WorkflowExecutor } from './workflow-executor.js';
+export type { AgentDispatcher, StepResult, WorkflowResult, } from './workflow-executor.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,11 @@
+export { buildDAG, detectCycles, topologicalSort } from './dag-builder.js';
+export { DAGExecutor } from './dag-executor.js';
+export { resolveContext, ContextResolutionError } from './context-resolver.js';
+export { DEFAULT_RETRY_POLICY } from './dag-types.js';
+// DSL workflow modules
+export { workflowStepSchema, workflowDefinitionSchema, agentStepSchema, parallelStepSchema, sequenceStepSchema, conditionalStepSchema, mapReduceStepSchema, loopStepSchema, } from './dsl-schema.js';
+export { DSLParser } from './dsl-parser.js';
+export { substitute } from './template-engine.js';
+export { evaluateCondition } from './condition-evaluator.js';
+export { WorkflowExecutor } from './workflow-executor.js';
+//# sourceMappingURL=index.js.map

package/packages/@monomind/cli/dist/src/workflow/template-engine.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Substitute {{variable}} and {{step-id.field}} placeholders in a template
+ * string using values from a context object.
+ *
+ * - `{{variable}}` resolves to `context[variable]`
+ * - `{{a.b.c}}` resolves to nested path `context.a.b.c`
+ *
+ * Safe regex-based — no eval.
+ */
+export declare function substitute(template: string, context: Record<string, unknown>): string;
+//# sourceMappingURL=template-engine.d.ts.map

package/packages/@monomind/cli/dist/src/workflow/template-engine.js

@@ -0,0 +1,40 @@
+/**
+ * Substitute {{variable}} and {{step-id.field}} placeholders in a template
+ * string using values from a context object.
+ *
+ * - `{{variable}}` resolves to `context[variable]`
+ * - `{{a.b.c}}` resolves to nested path `context.a.b.c`
+ *
+ * Safe regex-based — no eval.
+ */
+export function substitute(template, context) {
+    return template.replace(/\{\{([\w./-]+)\}\}/g, (_match, path) => {
+        const value = resolvePath(context, path);
+        if (value === undefined) {
+            return `{{${path}}}`;
+        }
+        return String(value);
+    });
+}
+const BLOCKED_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
+function resolvePath(obj, path) {
+    const segments = path.split('.');
+    let current = obj;
+    for (const segment of segments) {
+        if (current === null || current === undefined) {
+            return undefined;
+        }
+        if (typeof current !== 'object') {
+            return undefined;
+        }
+        if (BLOCKED_KEYS.has(segment)) {
+            return undefined;
+        }
+        if (!Object.prototype.hasOwnProperty.call(current, segment)) {
+            return undefined;
+        }
+        current = current[segment];
+    }
+    return current;
+}
+//# sourceMappingURL=template-engine.js.map

package/packages/@monomind/cli/dist/src/workflow/workflow-executor.d.ts

@@ -0,0 +1,29 @@
+import type { WorkflowDefinition } from './dsl-schema.js';
+export interface AgentDispatcher {
+    dispatch(agent: string, task: string, context: Record<string, unknown>): Promise<unknown>;
+}
+export interface StepResult {
+    stepId: string;
+    output: unknown;
+    status: 'success' | 'error';
+    error?: string;
+}
+export interface WorkflowResult {
+    workflowName: string;
+    status: 'success' | 'error';
+    stepResults: StepResult[];
+    context: Record<string, unknown>;
+}
+export declare class WorkflowExecutor {
+    private readonly dispatcher;
+    constructor(dispatcher: AgentDispatcher);
+    execute(workflow: WorkflowDefinition): Promise<WorkflowResult>;
+    private executeStep;
+    private executeAgent;
+    private executeParallel;
+    private executeSequence;
+    private executeConditional;
+    private executeMapReduce;
+    private executeLoop;
+}
+//# sourceMappingURL=workflow-executor.d.ts.map

package/packages/@monomind/cli/dist/src/workflow/workflow-executor.js

@@ -0,0 +1,227 @@
+import { substitute } from './template-engine.js';
+import { evaluateCondition } from './condition-evaluator.js';
+const DEFAULT_MAP_CONCURRENCY = 10;
+function classifyWorkflowError(err) {
+    const msg = err.message.toLowerCase();
+    if (msg.includes('rate limit') || msg.includes('429') || msg.includes('too many requests'))
+        return 'RATE_LIMIT';
+    if (msg.includes('timed out') || msg.includes('timeout'))
+        return 'TIMEOUT';
+    if (msg.includes('validation') || msg.includes('invalid') || msg.includes('schema'))
+        return 'VALIDATION';
+    return 'UNKNOWN';
+}
+async function mapWithConcurrency(items, concurrency, fn) {
+    const results = new Array(items.length);
+    const controller = new AbortController();
+    let next = 0;
+    async function worker() {
+        while (next < items.length) {
+            if (controller.signal.aborted)
+                return;
+            const idx = next++;
+            results[idx] = await fn(items[idx], idx, controller.signal);
+        }
+    }
+    try {
+        await Promise.all(Array.from({ length: Math.min(concurrency, items.length) }, worker));
+    }
+    catch (err) {
+        controller.abort();
+        throw err;
+    }
+    return results;
+}
+const BLOCKED_CONTEXT_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
+const SAFE_KEY_RE = /^[a-zA-Z_$][a-zA-Z0-9_$.\-]*$/;
+function safeContextWrite(context, key, value) {
+    if (!SAFE_KEY_RE.test(key) || BLOCKED_CONTEXT_KEYS.has(key)) {
+        throw new Error(`Unsafe workflow context key rejected: "${key}"`);
+    }
+    context[key] = value;
+}
+// ---------- Executor ----------
+export class WorkflowExecutor {
+    dispatcher;
+    constructor(dispatcher) {
+        this.dispatcher = dispatcher;
+    }
+    async execute(workflow) {
+        const context = {
+            variables: workflow.variables ?? {},
+        };
+        const stepResults = [];
+        let status = 'success';
+        for (const step of workflow.steps) {
+            try {
+                const result = await this.executeStep(step, context);
+                stepResults.push(...(Array.isArray(result) ? result : [result]));
+            }
+            catch (err) {
+                status = 'error';
+                stepResults.push({
+                    stepId: step.id,
+                    output: null,
+                    status: 'error',
+                    error: err instanceof Error ? err.message : String(err),
+                });
+                break;
+            }
+        }
+        return {
+            workflowName: workflow.name,
+            status,
+            stepResults,
+            context,
+        };
+    }
+    // ---- Step dispatch ----
+    async executeStep(step, context) {
+        switch (step.type) {
+            case 'agent':
+                return this.executeAgent(step, context);
+            case 'parallel':
+                return this.executeParallel(step, context);
+            case 'sequence':
+                return this.executeSequence(step, context);
+            case 'conditional':
+                return this.executeConditional(step, context);
+            case 'map_reduce':
+                return this.executeMapReduce(step, context);
+            case 'loop':
+                return this.executeLoop(step, context);
+            default: {
+                const _exhaustive = step;
+                throw new Error(`Unknown step type: ${_exhaustive.type}`);
+            }
+        }
+    }
+    // ---- Handlers ----
+    async executeAgent(step, context) {
+        const resolvedTask = substitute(step.task, context);
+        const maxAttempts = step.retry_policy?.maxAttempts ?? 1;
+        const initialDelayMs = step.retry_policy?.initialDelayMs ?? 500;
+        const backoffMultiplier = step.retry_policy?.backoffMultiplier ?? 2;
+        const jitterMs = step.retry_policy?.jitterMs ?? 0;
+        const retryOn = step.retry_policy?.retryOn;
+        let lastError;
+        let delayMs = initialDelayMs;
+        for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+            try {
+                let dispatchPromise = this.dispatcher.dispatch(step.agent, resolvedTask, context);
+                if (step.timeout_ms) {
+                    dispatchPromise = Promise.race([
+                        dispatchPromise,
+                        new Promise((_, reject) => setTimeout(() => reject(new Error(`Agent step "${step.id}" timed out after ${step.timeout_ms}ms`)), step.timeout_ms)),
+                    ]);
+                }
+                const output = await dispatchPromise;
+                if (step.output_key) {
+                    safeContextWrite(context, step.output_key, output);
+                }
+                safeContextWrite(context, step.id, output);
+                return { stepId: step.id, output, status: 'success' };
+            }
+            catch (err) {
+                lastError = err;
+                if (attempt >= maxAttempts)
+                    break;
+                // Only retry for configured error categories (default: retry all)
+                if (retryOn && retryOn.length > 0) {
+                    const category = classifyWorkflowError(err instanceof Error ? err : new Error(String(err)));
+                    if (!retryOn.includes(category))
+                        break;
+                }
+                const jitter = jitterMs > 0 ? Math.random() * jitterMs : 0;
+                await new Promise((r) => setTimeout(r, delayMs + jitter));
+                delayMs = Math.round(delayMs * backoffMultiplier);
+            }
+        }
+        throw lastError;
+    }
+    async executeParallel(step, context) {
+        const results = await Promise.all(step.steps.map((sub) => this.executeStep(sub, context)));
+        return results.flat();
+    }
+    async executeSequence(step, context) {
+        const results = [];
+        for (const sub of step.steps) {
+            const r = await this.executeStep(sub, context);
+            results.push(...(Array.isArray(r) ? r : [r]));
+        }
+        return results;
+    }
+    async executeConditional(step, context) {
+        const conditionMet = evaluateCondition(step.condition, context);
+        if (conditionMet) {
+            return this.executeStep(step.if_true, context);
+        }
+        else if (step.if_false) {
+            return this.executeStep(step.if_false, context);
+        }
+        return { stepId: step.id, output: null, status: 'success' };
+    }
+    async executeMapReduce(step, context) {
+        // Resolve items from context
+        const resolvedItems = substitute(step.items, context);
+        if (resolvedItems.length > 1_000_000) {
+            throw new Error(`map_reduce step "${step.id}": items string exceeds 1MB size limit`);
+        }
+        let items;
+        try {
+            items = JSON.parse(resolvedItems);
+            if (!Array.isArray(items))
+                throw new Error('not an array');
+        }
+        catch {
+            throw new Error(`map_reduce step "${step.id}": items must resolve to a JSON array, got: ${resolvedItems.slice(0, 200)}`);
+        }
+        const MAX_MAP_ITEMS = 500;
+        if (items.length > MAX_MAP_ITEMS) {
+            throw new Error(`map_reduce step "${step.id}": ${items.length} items exceeds limit of ${MAX_MAP_ITEMS}`);
+        }
+        // Map phase: fan-out to map_agent with concurrency cap (default 10, override via --concurrent)
+        const concurrency = step.concurrent ?? DEFAULT_MAP_CONCURRENCY;
+        const mapResults = await mapWithConcurrency(items, concurrency, async (item, idx, signal) => {
+            if (signal.aborted)
+                throw new Error('Map phase aborted');
+            const taskStr = substitute(step.map_task, { ...context, item });
+            const output = await this.dispatcher.dispatch(step.map_agent, taskStr, {
+                ...context,
+                item,
+            });
+            return { stepId: `${step.id}.map[${idx}]`, output, status: 'success' };
+        });
+        // Store mapped outputs for reduce
+        const mapOutputs = mapResults.map((r) => r.output);
+        safeContextWrite(context, `${step.id}_map_results`, mapOutputs);
+        // Reduce phase
+        const reduceTask = substitute(step.reduce_task, {
+            ...context,
+            map_results: mapOutputs,
+        });
+        const reduceOutput = await this.dispatcher.dispatch(step.reduce_agent, reduceTask, { ...context, map_results: mapOutputs });
+        safeContextWrite(context, step.id, reduceOutput);
+        return [
+            ...mapResults,
+            { stepId: `${step.id}.reduce`, output: reduceOutput, status: 'success' },
+        ];
+    }
+    async executeLoop(step, context) {
+        const results = [];
+        let iteration = 0;
+        while (iteration < step.max_iterations) {
+            const conditionMet = evaluateCondition(step.condition, context);
+            if (!conditionMet)
+                break;
+            for (const sub of step.body) {
+                const r = await this.executeStep(sub, context);
+                results.push(...(Array.isArray(r) ? r : [r]));
+            }
+            iteration++;
+        }
+        safeContextWrite(context, `${step.id}_iterations`, iteration);
+        return results;
+    }
+}
+//# sourceMappingURL=workflow-executor.js.map

package/packages/@monomind/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monoes/monomindcli",
-  "version": "1.11.12",
+  "version": "1.12.0",
   "type": "module",
   "description": "Monomind CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code",
   "main": "dist/src/index.js",
@@ -87,19 +87,18 @@
   "dependencies": {
     "ws": "^8.18.0",
     "@noble/ed25519": "^2.1.0",
-    "@monoes/monograph": "workspace:*",
-    "monofence-ai": "workspace:*",
-    "@monomind/hooks": "workspace:*",
-    "@monomind/guidance": "workspace:*",
-    "@monomind/mcp": "workspace:*",
-    "@monomind/routing": "workspace:*",
-    "semver": "^7.6.0"
+    "@monoes/monograph": "^1.2.0"
   },
   "optionalDependencies": {
     "sql.js": "^1.14.1",
-    "@monoes/memory": "workspace:*",
+    "@monoes/memory": "^1.0.0",
     "agentic-flow": "^3.0.0-alpha.1",
-    "@huggingface/transformers": "^3.8.1"
+    "@huggingface/transformers": "^3.8.1",
+    "monofence-ai": "*",
+    "@monomind/hooks": "*",
+    "@monomind/guidance": "*",
+    "@monomind/mcp": "*",
+    "@monomind/routing": "*"
   },
   "publishConfig": {
     "access": "public",