@cyanheads/workflows-mcp-server 0.1.1

package/dist/services/workflow-index/workflow-index-service.js

@@ -0,0 +1,395 @@
+/**
+ * @fileoverview In-memory workflow index service with filesystem watcher.
+ * Loads, validates, and indexes YAML workflow files from the configured directory.
+ * Watches for changes and rebuilds the index with debouncing.
+ * @module services/workflow-index/workflow-index-service
+ */
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { z } from '@cyanheads/mcp-ts-core';
+import { logger } from '@cyanheads/mcp-ts-core/utils';
+import * as semver from 'semver';
+import { parse as parseYaml } from 'yaml';
+// ---------------------------------------------------------------------------
+// Validation schemas
+// ---------------------------------------------------------------------------
+const StepSchema = z.object({
+    server: z.string().min(1),
+    tool: z.string().min(1),
+    action: z.string().optional(),
+    description: z.string().optional(),
+    name: z.string().optional(),
+    params: z.record(z.string(), z.unknown()).optional(),
+    forEach: z.string().optional(),
+});
+const WorkflowSchema = z.object({
+    name: z.string().min(1),
+    version: z.string().regex(/^\d+\.\d+\.\d+/),
+    description: z.string().min(1),
+    author: z.string().min(1),
+    category: z.string().min(1).optional(),
+    tags: z
+        .array(z.string())
+        .nullable()
+        .optional()
+        .transform((v) => v ?? undefined),
+    created_date: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}/)
+        .optional(),
+    last_updated_date: z
+        .string()
+        .regex(/^\d{4}-\d{2}-\d{2}/)
+        .optional(),
+    temporary: z.boolean().optional(),
+    steps: z.array(StepSchema).min(1),
+});
+// ---------------------------------------------------------------------------
+// Slugification
+// ---------------------------------------------------------------------------
+/** Convert a display string to a filesystem-safe kebab-case slug. */
+export function slugify(input) {
+    return input
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+/** Maximum slug length for a name used in a filename (leaves room for version + suffix). */
+const MAX_NAME_SLUG_LENGTH = 200;
+/** Throw a tagged error if the slug derived from a workflow name is empty or too long. */
+function assertValidNameSlug(name, slug) {
+    if (!slug) {
+        throw Object.assign(new Error(`Workflow name "${name}" produces an empty slug`), {
+            _reason: 'invalid_name',
+        });
+    }
+    if (slug.length > MAX_NAME_SLUG_LENGTH) {
+        throw Object.assign(new Error(`Workflow name is too long — keep it under ${MAX_NAME_SLUG_LENGTH} characters after slugification`), { _reason: 'name_too_long' });
+    }
+}
+// ---------------------------------------------------------------------------
+// Logging helpers (background/non-request context)
+// ---------------------------------------------------------------------------
+function logInfo(msg) {
+    logger.info(msg);
+}
+function logWarn(msg) {
+    logger.warning(msg);
+}
+function logError(msg, err) {
+    logger.error(msg, err instanceof Error ? err : new Error(String(err)));
+}
+// ---------------------------------------------------------------------------
+// Service
+// ---------------------------------------------------------------------------
+export class WorkflowIndexService {
+    _index = new Map();
+    _ready = false;
+    _watcherController;
+    _debounceTimer;
+    workflowsDir;
+    globalInstructionsPath;
+    watcherDebounceMs;
+    constructor(workflowsDir, globalInstructionsPath, watcherDebounceMs) {
+        this.workflowsDir = workflowsDir;
+        this.globalInstructionsPath = globalInstructionsPath;
+        this.watcherDebounceMs = watcherDebounceMs;
+    }
+    // --- Public API ---
+    get ready() {
+        return this._ready;
+    }
+    /** The current in-memory index. */
+    get index() {
+        return this._index;
+    }
+    /** Initialize: build initial index and start filesystem watcher. */
+    async init() {
+        await this.rebuild();
+        this.startWatcher();
+    }
+    /** Tear down the watcher. */
+    shutdown() {
+        if (this._debounceTimer)
+            clearTimeout(this._debounceTimer);
+        this._watcherController?.abort();
+    }
+    // --- Lookup ---
+    /** Find all entries matching a name (across all versions). */
+    findByName(name) {
+        const results = [];
+        for (const entry of this._index.values()) {
+            if (entry.workflow.name === name)
+                results.push(entry);
+        }
+        return results;
+    }
+    /** Semver-aware lookup. Returns the highest version match if version is omitted. */
+    findWorkflow(name, version) {
+        if (version) {
+            return this._index.get(`${name}@${version}`);
+        }
+        const matches = this.findByName(name);
+        if (matches.length === 0)
+            return;
+        matches.sort((a, b) => semver.rcompare(a.workflow.version, b.workflow.version));
+        return matches[0];
+    }
+    /** Read global_instructions.md content. Returns null if file missing. */
+    async readGlobalInstructions() {
+        try {
+            return await fs.readFile(this.globalInstructionsPath, 'utf-8');
+        }
+        catch {
+            return null;
+        }
+    }
+    // --- Write operations ---
+    /** Write a permanent workflow YAML and rebuild the index. */
+    async writePermanent(workflow) {
+        const key = `${workflow.name}@${workflow.version}`;
+        const categorySlug = slugify(workflow.category ?? 'uncategorized');
+        const nameSlug = slugify(workflow.name);
+        const versionSlug = slugify(workflow.version);
+        assertValidNameSlug(workflow.name, nameSlug);
+        const categoryDir = path.join(this.workflowsDir, 'categories', categorySlug);
+        // Include version in filename so multiple versions coexist on disk.
+        const filePath = path.join(categoryDir, `${nameSlug}-${versionSlug}-workflow.yaml`);
+        await fs.mkdir(categoryDir, { recursive: true });
+        try {
+            // `wx` flag fails atomically if the file already exists, preventing TOCTOU races.
+            await fs.writeFile(filePath, buildYaml(workflow), { encoding: 'utf-8', flag: 'wx' });
+        }
+        catch (err) {
+            if (err instanceof Error && err.code === 'EEXIST') {
+                throw Object.assign(new Error(`Workflow "${key}" already exists`), {
+                    _reason: 'already_exists',
+                });
+            }
+            throw err;
+        }
+        // Immediately rebuild so the index is fresh for the caller.
+        // The watcher will also fire and trigger a redundant rebuild — that's fine (idempotent).
+        await this.rebuild();
+        return filePath;
+    }
+    /** Write a temporary workflow YAML and rebuild the index. */
+    async writeTemp(workflow) {
+        const nameSlug = slugify(workflow.name);
+        const versionSlug = slugify(workflow.version);
+        assertValidNameSlug(workflow.name, nameSlug);
+        const tempDir = path.join(this.workflowsDir, 'temp');
+        await fs.mkdir(tempDir, { recursive: true });
+        // Include version in filename so different versions are distinct files.
+        const filePath = path.join(tempDir, `${nameSlug}-${versionSlug}-workflow.yaml`);
+        await fs.writeFile(filePath, buildYaml(workflow), 'utf-8');
+        await this.rebuild();
+        return filePath;
+    }
+    // --- Internal ---
+    async rebuild() {
+        const newIndex = new Map();
+        try {
+            const categoriesDir = path.join(this.workflowsDir, 'categories');
+            await this.scanDirectory(categoriesDir, false, newIndex);
+            const tempDir = path.join(this.workflowsDir, 'temp');
+            await this.scanDirectory(tempDir, true, newIndex);
+        }
+        catch (err) {
+            logWarn(`Workflow index rebuild error: ${String(err)}`);
+        }
+        this._index = newIndex;
+        this._ready = true;
+        logInfo(`Workflow index rebuilt (${newIndex.size} entries)`);
+        // Write snapshot asynchronously — don't await
+        this.writeSnapshot(newIndex).catch((err) => {
+            logWarn(`Failed to write index snapshot: ${String(err)}`);
+        });
+    }
+    async scanDirectory(dir, isTemp, index) {
+        let entries;
+        try {
+            entries = await fs.readdir(dir, { withFileTypes: true, recursive: true, encoding: 'utf8' });
+        }
+        catch {
+            // Directory may not exist yet — that's fine
+            return;
+        }
+        for (const entry of entries) {
+            if (!entry.isFile())
+                continue;
+            const name = entry.name;
+            if (!name.endsWith('.yaml') && !name.endsWith('.yml'))
+                continue;
+            if (name === '_index.json')
+                continue;
+            // `recursive: true` sets `entry.parentPath` in Node 22+, falling back to `entry.path`
+            const parentDir = entry.parentPath ?? entry.path ?? dir;
+            const filePath = path.join(parentDir, name);
+            await this.loadFile(filePath, isTemp, index);
+        }
+    }
+    async loadFile(filePath, isTemp, index) {
+        let raw;
+        try {
+            raw = await fs.readFile(filePath, 'utf-8');
+        }
+        catch (err) {
+            logWarn(`Failed to read workflow file ${filePath}: ${String(err)}`);
+            return;
+        }
+        let parsed;
+        try {
+            parsed = parseYaml(raw);
+        }
+        catch (err) {
+            logWarn(`Failed to parse YAML at ${filePath}: ${String(err)}`);
+            return;
+        }
+        const result = WorkflowSchema.safeParse(parsed);
+        if (!result.success) {
+            logWarn(`Invalid workflow schema at ${filePath}: ${JSON.stringify(result.error.flatten().fieldErrors)}`);
+            return;
+        }
+        const workflow = result.data;
+        // Warn if a non-temp file is missing a category
+        if (!isTemp && !workflow.category) {
+            logWarn(`Permanent workflow missing category field: ${filePath} (name: ${workflow.name})`);
+        }
+        const key = `${workflow.name}@${workflow.version}`;
+        if (index.has(key)) {
+            logWarn(`Duplicate workflow key "${key}" — last write wins (file: ${filePath})`);
+        }
+        index.set(key, { workflow, filePath, isTemp });
+    }
+    async writeSnapshot(index) {
+        const snapshot = {
+            generatedAt: new Date().toISOString(),
+            count: index.size,
+            entries: {},
+        };
+        for (const [key, entry] of index) {
+            snapshot.entries[key] = {
+                filePath: entry.filePath,
+                isTemp: entry.isTemp,
+                name: entry.workflow.name,
+                version: entry.workflow.version,
+                ...(entry.workflow.category !== undefined && { category: entry.workflow.category }),
+                ...(entry.workflow.tags !== undefined && { tags: entry.workflow.tags }),
+            };
+        }
+        const snapshotPath = path.join(this.workflowsDir, '_index.json');
+        await fs.writeFile(snapshotPath, JSON.stringify(snapshot, null, 2), 'utf-8');
+    }
+    startWatcher() {
+        this._watcherController = new AbortController();
+        const signal = this._watcherController.signal;
+        const debounceMs = this.watcherDebounceMs;
+        const rebuild = () => this.scheduledRebuild();
+        // Fire and forget — the loop runs in the background
+        void (async () => {
+            try {
+                const watcher = fs.watch(this.workflowsDir, { recursive: true, signal });
+                for await (const event of watcher) {
+                    // Skip snapshot file events to avoid infinite loop
+                    const filename = event.filename;
+                    if (typeof filename === 'string' && filename.endsWith('_index.json')) {
+                        continue;
+                    }
+                    // Debounce
+                    if (this._debounceTimer)
+                        clearTimeout(this._debounceTimer);
+                    this._debounceTimer = setTimeout(rebuild, debounceMs);
+                }
+            }
+            catch (err) {
+                // AbortError is expected on shutdown — ignore it
+                if (err instanceof Error &&
+                    (err.name === 'AbortError' || err.code === 'ABORT_ERR')) {
+                    return;
+                }
+                logWarn(`Filesystem watcher exited unexpectedly: ${String(err)}`);
+            }
+        })();
+    }
+    scheduledRebuild() {
+        this.rebuild().catch((err) => {
+            logWarn(`Debounced rebuild failed: ${String(err)}`);
+        });
+    }
+}
+// ---------------------------------------------------------------------------
+// YAML serialisation helper
+// ---------------------------------------------------------------------------
+function buildYaml(workflow) {
+    const lines = [];
+    lines.push(`name: ${quote(workflow.name)}`);
+    lines.push(`version: "${workflow.version}"`);
+    lines.push(`description: ${quote(workflow.description)}`);
+    lines.push(`author: ${quote(workflow.author)}`);
+    if (workflow.category)
+        lines.push(`category: ${quote(workflow.category)}`);
+    if (workflow.tags && workflow.tags.length > 0) {
+        lines.push('tags:');
+        for (const tag of workflow.tags)
+            lines.push(`  - ${quote(tag)}`);
+    }
+    if (workflow.created_date)
+        lines.push(`created_date: "${workflow.created_date}"`);
+    if (workflow.last_updated_date)
+        lines.push(`last_updated_date: "${workflow.last_updated_date}"`);
+    if (workflow.temporary)
+        lines.push('temporary: true');
+    lines.push('steps:');
+    for (const step of workflow.steps) {
+        lines.push(`  - server: ${quote(step.server)}`);
+        lines.push(`    tool: ${quote(step.tool)}`);
+        if (step.action)
+            lines.push(`    action: ${quote(step.action)}`);
+        if (step.description)
+            lines.push(`    description: ${quote(step.description)}`);
+        if (step.name)
+            lines.push(`    name: ${quote(step.name)}`);
+        if (step.forEach)
+            lines.push(`    forEach: ${quote(step.forEach)}`);
+        if (step.params && Object.keys(step.params).length > 0) {
+            lines.push('    params:');
+            for (const [k, v] of Object.entries(step.params)) {
+                lines.push(`      ${k}: ${yamlValue(v)}`);
+            }
+        }
+    }
+    return `${lines.join('\n')}\n`;
+}
+function quote(s) {
+    if (/[:#[\]{},&*?|<>=!%@`\\]|^[-?]/.test(s) || s.includes('\n')) {
+        return `"${s.replace(/\\/g, '\\\\').replace(/"/g, '\\"')}"`;
+    }
+    return s;
+}
+function yamlValue(v) {
+    if (typeof v === 'string')
+        return quote(v);
+    if (typeof v === 'boolean' || typeof v === 'number')
+        return String(v);
+    if (v === null)
+        return 'null';
+    return JSON.stringify(v);
+}
+// ---------------------------------------------------------------------------
+// Init/accessor pattern
+// ---------------------------------------------------------------------------
+let _service;
+export function initWorkflowIndexService(_config, _storage, workflowsDir, globalInstructionsPath, watcherDebounceMs) {
+    _service = new WorkflowIndexService(workflowsDir, globalInstructionsPath, watcherDebounceMs);
+    _service.init().catch((err) => {
+        logError('WorkflowIndexService init failed', err);
+    });
+}
+export function getWorkflowIndexService() {
+    if (!_service) {
+        throw new Error('WorkflowIndexService not initialized — call initWorkflowIndexService() in setup()');
+    }
+    return _service;
+}
+//# sourceMappingURL=workflow-index-service.js.map

package/dist/services/workflow-index/workflow-index-service.js.map

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

package/package.json

@@ -0,0 +1,103 @@
+{
+  "name": "@cyanheads/workflows-mcp-server",
+  "version": "0.1.1",
+  "mcpName": "io.github.cyanheads/workflows-mcp-server",
+  "description": "Store, query, and create YAML workflow playbooks for LLM agents via MCP. STDIO or Streamable HTTP.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "workflows-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "changelog/",
+    "dist/",
+    "README.md",
+    "LICENSE",
+    "CLAUDE.md",
+    "AGENTS.md",
+    "Dockerfile",
+    "server.json"
+  ],
+  "scripts": {
+    "build": "bun run scripts/build.ts",
+    "rebuild": "bun run scripts/clean.ts && bun run build",
+    "clean": "bun run scripts/clean.ts",
+    "devcheck": "bun run scripts/devcheck.ts",
+    "audit:refresh": "rm -f bun.lock && bun install && bun audit",
+    "tree": "bun run scripts/tree.ts",
+    "list-skills": "bun run scripts/list-skills.ts",
+    "format": "biome check --write --unsafe",
+    "lint:mcp": "bun run scripts/lint-mcp.ts",
+    "lint:packaging": "bun run scripts/lint-packaging.ts",
+    "bundle": "bun run build && npx -y @anthropic-ai/mcpb pack . dist/workflows-mcp-server.mcpb",
+    "changelog:build": "bun run scripts/build-changelog.ts",
+    "changelog:check": "bun run scripts/build-changelog.ts --check",
+    "publish-mcp": "mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish",
+    "test": "bunx vitest run",
+    "start:stdio": "MCP_TRANSPORT_TYPE=stdio bun ./dist/index.js",
+    "start:http": "MCP_TRANSPORT_TYPE=http bun ./dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "ai",
+    "llm",
+    "bun",
+    "stdio",
+    "streamable-http",
+    "workflows",
+    "yaml",
+    "playbook",
+    "automation",
+    "agent-tools"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cyanheads/workflows-mcp-server.git"
+  },
+  "homepage": "https://github.com/cyanheads/workflows-mcp-server#readme",
+  "bugs": {
+    "url": "https://github.com/cyanheads/workflows-mcp-server/issues"
+  },
+  "author": "cyanheads <casey@caseyjhand.com> (https://github.com/cyanheads/workflows-mcp-server#readme)",
+  "funding": [
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/cyanheads"
+    },
+    {
+      "type": "buy_me_a_coffee",
+      "url": "https://www.buymeacoffee.com/cyanheads"
+    }
+  ],
+  "license": "Apache-2.0",
+  "packageManager": "bun@1.3.2",
+  "engines": {
+    "bun": ">=1.3.2",
+    "node": ">=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@cyanheads/mcp-ts-core": "^0.9.11",
+    "pino-pretty": "^13.1.3",
+    "semver": "^7.8.1",
+    "yaml": "^2.9.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.16",
+    "@types/node": "^25.9.1",
+    "@types/semver": "^7.7.1",
+    "@vitest/coverage-istanbul": "^4.1.7",
+    "depcheck": "^1.4.7",
+    "fast-check": "^4.8.0",
+    "ignore": "^7.0.5",
+    "tsc-alias": "^1.8.17",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.7"
+  }
+}

package/server.json

@@ -0,0 +1,129 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.cyanheads/workflows-mcp-server",
+  "description": "Store, query, and create YAML workflow playbooks for LLM agents.",
+  "repository": {
+    "url": "https://github.com/cyanheads/workflows-mcp-server",
+    "source": "github"
+  },
+  "version": "0.1.1",
+  "packages": [
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "@cyanheads/workflows-mcp-server",
+      "runtimeHint": "bun",
+      "version": "0.1.1",
+      "packageArguments": [
+        { "type": "positional", "value": "run" },
+        { "type": "positional", "value": "start:stdio" }
+      ],
+      "environmentVariables": [
+        {
+          "name": "WORKFLOWS_DIR",
+          "description": "Absolute or relative path to the workflows root directory.",
+          "format": "string",
+          "isRequired": false,
+          "default": "./workflows-yaml"
+        },
+        {
+          "name": "GLOBAL_INSTRUCTIONS_PATH",
+          "description": "Path to the global instructions markdown file. Derives from WORKFLOWS_DIR when not set.",
+          "format": "string",
+          "isRequired": false,
+          "default": ""
+        },
+        {
+          "name": "WATCHER_DEBOUNCE_MS",
+          "description": "Milliseconds to debounce filesystem change events before rebuilding the index.",
+          "format": "string",
+          "isRequired": false,
+          "default": "500"
+        },
+        {
+          "name": "MCP_LOG_LEVEL",
+          "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
+          "format": "string",
+          "isRequired": false,
+          "default": "info"
+        }
+      ],
+      "transport": {
+        "type": "stdio"
+      }
+    },
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "@cyanheads/workflows-mcp-server",
+      "runtimeHint": "bun",
+      "version": "0.1.1",
+      "packageArguments": [
+        { "type": "positional", "value": "run" },
+        { "type": "positional", "value": "start:http" }
+      ],
+      "environmentVariables": [
+        {
+          "name": "WORKFLOWS_DIR",
+          "description": "Absolute or relative path to the workflows root directory.",
+          "format": "string",
+          "isRequired": false,
+          "default": "./workflows-yaml"
+        },
+        {
+          "name": "GLOBAL_INSTRUCTIONS_PATH",
+          "description": "Path to the global instructions markdown file. Derives from WORKFLOWS_DIR when not set.",
+          "format": "string",
+          "isRequired": false,
+          "default": ""
+        },
+        {
+          "name": "WATCHER_DEBOUNCE_MS",
+          "description": "Milliseconds to debounce filesystem change events before rebuilding the index.",
+          "format": "string",
+          "isRequired": false,
+          "default": "500"
+        },
+        {
+          "name": "MCP_HTTP_HOST",
+          "description": "The hostname for the HTTP server.",
+          "format": "string",
+          "isRequired": false,
+          "default": "127.0.0.1"
+        },
+        {
+          "name": "MCP_HTTP_PORT",
+          "description": "The port to run the HTTP server on.",
+          "format": "string",
+          "isRequired": false,
+          "default": "3010"
+        },
+        {
+          "name": "MCP_HTTP_ENDPOINT_PATH",
+          "description": "The endpoint path for the MCP server.",
+          "format": "string",
+          "isRequired": false,
+          "default": "/mcp"
+        },
+        {
+          "name": "MCP_AUTH_MODE",
+          "description": "Authentication mode to use: 'none', 'jwt', or 'oauth'.",
+          "format": "string",
+          "isRequired": false,
+          "default": "none"
+        },
+        {
+          "name": "MCP_LOG_LEVEL",
+          "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').",
+          "format": "string",
+          "isRequired": false,
+          "default": "info"
+        }
+      ],
+      "transport": {
+        "type": "streamable-http",
+        "url": "http://localhost:3010/mcp"
+      }
+    }
+  ]
+}