claude-mcp-workflow 0.1.0

package/build/loader.js

@@ -0,0 +1,166 @@
+import fs from "node:fs";
+import path from "node:path";
+import YAML from "yaml";
+import { WorkflowDefinitionSchema } from "./types.js";
+export class Loader {
+    _bundledDir;
+    _globalDir;
+    _projectDir;
+    _workflows = new Map();
+    _globalWatcher = null;
+    _projectWatcher = null;
+    constructor(bundledDir, globalDir, projectDir) {
+        this._bundledDir = bundledDir;
+        this._globalDir = globalDir;
+        this._projectDir = projectDir;
+        fs.mkdirSync(this._globalDir, { recursive: true });
+        if (this._projectDir)
+            fs.mkdirSync(this._projectDir, { recursive: true });
+        this._loadAll();
+    }
+    get(name) {
+        return this._workflows.get(name);
+    }
+    getAll() {
+        return new Map(this._workflows);
+    }
+    names() {
+        return Array.from(this._workflows.keys());
+    }
+    /** Directory where create saves new YAML files */
+    getWriteDir(scope) {
+        if (scope === "global")
+            return this._globalDir;
+        if (scope === "project") {
+            if (!this._projectDir)
+                throw new Error("No project directory available");
+            return this._projectDir;
+        }
+        // Default: project if available, else global
+        return this._projectDir ?? this._globalDir;
+    }
+    /** @deprecated Use getWriteDir() */
+    get writeDir() {
+        return this.getWriteDir();
+    }
+    startWatching() {
+        this._globalWatcher = this._watchDir(this._globalDir);
+        if (this._projectDir)
+            this._projectWatcher = this._watchDir(this._projectDir);
+    }
+    stopWatching() {
+        this._globalWatcher?.close();
+        this._globalWatcher = null;
+        this._projectWatcher?.close();
+        this._projectWatcher = null;
+    }
+    reload() {
+        this._loadAll();
+    }
+    /** Delete a workflow YAML file. */
+    delete(name, scope) {
+        const dirs = [];
+        if (scope !== "global" && this._projectDir)
+            dirs.push(this._projectDir);
+        if (scope !== "project")
+            dirs.push(this._globalDir);
+        for (const dir of dirs) {
+            const fp = this._findFile(dir, name);
+            if (fp) {
+                fs.unlinkSync(fp);
+                return fp;
+            }
+        }
+        const where = scope ?? "project or global";
+        throw new Error(`Workflow "${name}" not found in ${where} dir`);
+    }
+    _findFile(dir, name) {
+        for (const ext of [".yaml", ".yml"]) {
+            const fp = path.join(dir, name + ext);
+            if (fs.existsSync(fp))
+                return fp;
+        }
+        return null;
+    }
+    _watchDir(dir) {
+        try {
+            return fs.watch(dir, (_event, filename) => {
+                if (filename && (filename.endsWith(".yaml") || filename.endsWith(".yml")))
+                    this._loadAll();
+            });
+        }
+        catch {
+            return null;
+        }
+    }
+    _loadAll() {
+        const next = new Map();
+        // Load bundled first (read-only defaults)
+        if (this._bundledDir)
+            this._loadDir(this._bundledDir, next);
+        // Global overrides bundled
+        this._loadDir(this._globalDir, next);
+        // Project overrides global
+        if (this._projectDir)
+            this._loadDir(this._projectDir, next);
+        this._workflows = next;
+    }
+    _loadDir(dir, target) {
+        if (!fs.existsSync(dir))
+            return;
+        const files = fs.readdirSync(dir)
+            .filter(f => f.endsWith(".yaml") || f.endsWith(".yml"));
+        for (const file of files) {
+            const fp = path.join(dir, file);
+            try {
+                const raw = fs.readFileSync(fp, "utf-8");
+                const parsed = YAML.parse(raw);
+                const validated = WorkflowDefinitionSchema.parse(parsed);
+                const errors = this._validate(validated);
+                if (errors.length > 0) {
+                    console.error(`Validation errors in ${fp}: ${errors.join("; ")}`);
+                    continue;
+                }
+                target.set(validated.name, validated);
+            }
+            catch (err) {
+                console.error(`Failed to load workflow ${fp}:`, err);
+            }
+        }
+    }
+    _validate(wf) {
+        const errors = [];
+        const stateNames = new Set(Object.keys(wf.states));
+        if (!stateNames.has(wf.initial))
+            errors.push(`initial state "${wf.initial}" does not exist`);
+        const hasTerminal = Object.values(wf.states).some(s => s.terminal);
+        if (!hasTerminal)
+            errors.push("no terminal state defined");
+        for (const [name, state] of Object.entries(wf.states)) {
+            if (state.transitions) {
+                for (const [tName, tgt] of Object.entries(state.transitions)) {
+                    if (!stateNames.has(tgt))
+                        errors.push(`state "${name}" transition "${tName}" → unknown state "${tgt}"`);
+                }
+            }
+            if (!state.prompt && !state.sub_workflow && !state.terminal)
+                errors.push(`state "${name}" has no prompt, sub_workflow, or terminal flag`);
+            if (state.sub_workflow && !state.on_complete)
+                errors.push(`state "${name}" has sub_workflow but no on_complete`);
+            // terminal + transitions is allowed: "soft terminal" — considered complete
+            // but can be re-entered via transitions (useful for top-level confirmation loops)
+        }
+        return errors;
+    }
+    validateReferences() {
+        const errors = [];
+        for (const [wfName, wf] of this._workflows) {
+            for (const [stateName, state] of Object.entries(wf.states)) {
+                if (state.sub_workflow && !this._workflows.has(state.sub_workflow))
+                    errors.push(`${wfName}/${stateName}: sub_workflow "${state.sub_workflow}" not found`);
+            }
+        }
+        return errors;
+    }
+}
+//# sourceMappingURL=loader.js.map

package/build/loader.js.map

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

package/build/modifier.d.ts

@@ -0,0 +1,42 @@
+import type { StateDefinition } from "./types.js";
+import type { Storage } from "./storage.js";
+import type { Loader } from "./loader.js";
+import type { Engine } from "./engine.js";
+export interface ModifyInput {
+    readonly add_state?: {
+        readonly name: string;
+        readonly prompt?: string;
+        readonly transitions?: Record<string, string>;
+        readonly terminal?: boolean;
+        readonly outcome?: "complete" | "fail" | "needs_action";
+        readonly max_visits?: number;
+        readonly sub_workflow?: string;
+        readonly on_complete?: string;
+        readonly on_fail?: string;
+    };
+    readonly add_transition?: {
+        readonly from: string;
+        readonly name: string;
+        readonly to: string;
+    };
+    readonly remove_transition?: {
+        readonly from: string;
+        readonly name: string;
+    };
+}
+export declare class Modifier {
+    private readonly _storage;
+    private readonly _loader;
+    private _engine?;
+    constructor(storage: Storage, loader: Loader);
+    /** Late-bind engine to break circular dependency (Engine ↔ Modifier). */
+    setEngine(engine: Engine): void;
+    modify(sessionId: string, changes: ModifyInput): Promise<string[]>;
+    create(name: string, definition: {
+        readonly description?: string;
+        readonly initial: string;
+        readonly max_transitions?: number;
+        readonly states: Record<string, StateDefinition>;
+    }, scope?: "project" | "global"): Promise<string>;
+}
+//# sourceMappingURL=modifier.d.ts.map

package/build/modifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modifier.d.ts","sourceRoot":"","sources":["../src/modifier.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAgB,eAAe,EAAqB,MAAM,YAAY,CAAC;AAEnF,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE;QACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,cAAc,CAAC;QACxD,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,QAAQ,CAAC,cAAc,CAAC,EAAE;QACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,QAAQ,CAAC,iBAAiB,CAAC,EAAE;QAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,OAAO,CAAC,CAAS;gBAEb,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM;IAK5C,yEAAyE;IAClE,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIzB,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAsDlE,MAAM,CACjB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE;QACV,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;QAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;KAClD,EACD,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,GAC3B,OAAO,CAAC,MAAM,CAAC;CAuCnB"}

package/build/modifier.js

@@ -0,0 +1,96 @@
+import fs from "node:fs";
+import path from "node:path";
+import YAML from "yaml";
+import { WorkflowDefinitionSchema } from "./types.js";
+export class Modifier {
+    _storage;
+    _loader;
+    _engine;
+    constructor(storage, loader) {
+        this._storage = storage;
+        this._loader = loader;
+    }
+    /** Late-bind engine to break circular dependency (Engine ↔ Modifier). */
+    setEngine(engine) {
+        this._engine = engine;
+    }
+    async modify(sessionId, changes) {
+        const session = this._storage.read(sessionId);
+        if (!session)
+            throw new Error(`Session "${sessionId}" not found`);
+        if (session.stack.length === 0)
+            throw new Error("No active workflow to modify");
+        // When pending_pop is active, overlays target the parent frame's workflow
+        // (the child completed but couldn't pop because parent lacks on_complete/on_fail)
+        let frame = session.stack[session.active_frame];
+        if (session.pending_pop && session.active_frame > 0)
+            frame = session.stack[session.active_frame - 1];
+        const wfName = frame.workflow;
+        const messages = [];
+        const existing = session.overrides[wfName] ?? {};
+        const updated = { ...existing };
+        if (changes.add_state) {
+            const { name, ...stateDef } = changes.add_state;
+            const addStates = { ...(updated.add_states ?? {}), [name]: stateDef };
+            updated.add_states = addStates;
+            messages.push(`Added state "${name}"`);
+        }
+        if (changes.add_transition) {
+            const addTransitions = [...(updated.add_transitions ?? []), changes.add_transition];
+            updated.add_transitions = addTransitions;
+            messages.push(`Added transition "${changes.add_transition.from}" --${changes.add_transition.name}--> "${changes.add_transition.to}"`);
+        }
+        if (changes.remove_transition) {
+            const removeTransitions = [...(updated.remove_transitions ?? []), changes.remove_transition];
+            updated.remove_transitions = removeTransitions;
+            messages.push(`Removed transition "${changes.remove_transition.name}" from "${changes.remove_transition.from}"`);
+        }
+        const updatedSession = {
+            ...session,
+            overrides: { ...session.overrides, [wfName]: updated },
+            updated_at: new Date().toISOString(),
+        };
+        await this._storage.write(sessionId, updatedSession);
+        // If there's a pending pop, retry it now — the overlay may have added the missing on_complete/on_fail
+        if (this._engine && updatedSession.pending_pop) {
+            const result = await this._engine.retryPendingPop(sessionId);
+            if (result) {
+                messages.push(`Pending pop resolved → ${result.currentWorkflow} @ ${result.currentStateName}`);
+            }
+        }
+        return messages;
+    }
+    async create(name, definition, scope) {
+        const full = { name, ...definition };
+        // Validate
+        const validated = WorkflowDefinitionSchema.parse(full);
+        // Check states consistency
+        const stateNames = new Set(Object.keys(validated.states));
+        if (!stateNames.has(validated.initial)) {
+            throw new Error(`Initial state "${validated.initial}" not found in states`);
+        }
+        const hasTerminal = Object.values(validated.states).some(s => s.terminal);
+        if (!hasTerminal) {
+            throw new Error("Workflow must have at least one terminal state");
+        }
+        for (const [sn, state] of Object.entries(validated.states)) {
+            if (state.transitions) {
+                for (const [tn, target] of Object.entries(state.transitions)) {
+                    if (!stateNames.has(target)) {
+                        throw new Error(`State "${sn}" transition "${tn}" → unknown state "${target}"`);
+                    }
+                }
+            }
+        }
+        // Write YAML
+        const writeDir = this._loader.getWriteDir(scope);
+        const yamlContent = YAML.stringify(full);
+        const filePath = path.join(writeDir, `${name}.yaml`);
+        fs.mkdirSync(writeDir, { recursive: true });
+        fs.writeFileSync(filePath, yamlContent);
+        // Reload to pick up the new workflow
+        this._loader.reload();
+        return filePath;
+    }
+}
+//# sourceMappingURL=modifier.js.map

package/build/modifier.js.map

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

package/build/storage.d.ts

@@ -0,0 +1,12 @@
+import type { SessionState } from "./types.js";
+export declare class Storage {
+    private readonly _stateDir;
+    constructor(stateDir: string);
+    private _filePath;
+    read(sessionId: string): SessionState | null;
+    write(sessionId: string, state: SessionState): Promise<void>;
+    list(): string[];
+    delete(sessionId: string): boolean;
+    readAll(): SessionState[];
+}
+//# sourceMappingURL=storage.d.ts.map

package/build/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,QAAQ,EAAE,MAAM;IAK5B,OAAO,CAAC,SAAS;IAKV,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAOtC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBlE,IAAI,IAAI,MAAM,EAAE;IAOhB,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAOlC,OAAO,IAAI,YAAY,EAAE;CAKjC"}

package/build/storage.js

@@ -0,0 +1,62 @@
+import fs from "node:fs";
+import path from "node:path";
+import lockfile from "proper-lockfile";
+import { LOCK_STALE_MS } from "./types.js";
+export class Storage {
+    _stateDir;
+    constructor(stateDir) {
+        this._stateDir = stateDir;
+        fs.mkdirSync(this._stateDir, { recursive: true });
+    }
+    _filePath(sessionId) {
+        const safe = sessionId.replace(/[^a-zA-Z0-9_-]/g, "_");
+        return path.join(this._stateDir, `${safe}.json`);
+    }
+    read(sessionId) {
+        const fp = this._filePath(sessionId);
+        if (!fs.existsSync(fp))
+            return null;
+        const raw = fs.readFileSync(fp, "utf-8");
+        return JSON.parse(raw);
+    }
+    async write(sessionId, state) {
+        const fp = this._filePath(sessionId);
+        const dir = path.dirname(fp);
+        fs.mkdirSync(dir, { recursive: true });
+        // Create file if it doesn't exist (lockfile needs it)
+        if (!fs.existsSync(fp)) {
+            fs.writeFileSync(fp, "{}");
+        }
+        let release;
+        try {
+            release = await lockfile.lock(fp, { stale: LOCK_STALE_MS });
+            const tmp = fp + ".tmp";
+            fs.writeFileSync(tmp, JSON.stringify(state, null, 2));
+            fs.renameSync(tmp, fp);
+        }
+        finally {
+            if (release)
+                await release();
+        }
+    }
+    list() {
+        if (!fs.existsSync(this._stateDir))
+            return [];
+        return fs.readdirSync(this._stateDir)
+            .filter(f => f.endsWith(".json"))
+            .map(f => f.replace(/\.json$/, ""));
+    }
+    delete(sessionId) {
+        const fp = this._filePath(sessionId);
+        if (!fs.existsSync(fp))
+            return false;
+        fs.unlinkSync(fp);
+        return true;
+    }
+    readAll() {
+        return this.list()
+            .map(id => this.read(id))
+            .filter((s) => s !== null);
+    }
+}
+//# sourceMappingURL=storage.js.map

package/build/storage.js.map

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

package/build/tools.d.ts

@@ -0,0 +1,7 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Engine } from "./engine.js";
+import type { Modifier } from "./modifier.js";
+import type { Loader } from "./loader.js";
+import type { Storage } from "./storage.js";
+export declare function registerTools(server: McpServer, engine: Engine, modifier: Modifier, loader: Loader, storage: Storage): void;
+//# sourceMappingURL=tools.d.ts.map

package/build/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAgB,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AA2D5C,wBAAgB,aAAa,CAC3B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,GACf,IAAI,CA+RN"}