@cyanheads/workflows-mcp-server 0.1.1

package/dist/config/server-config.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Server-specific environment configuration for workflows-mcp-server.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+declare const ServerConfigSchema: z.ZodObject<{
+    workflowsDir: z.ZodDefault<z.ZodString>;
+    globalInstructionsPath: z.ZodDefault<z.ZodString>;
+    watcherDebounceMs: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export declare function getServerConfig(): z.infer<typeof ServerConfigSchema>;
+export {};
+//# sourceMappingURL=server-config.d.ts.map

package/dist/config/server-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAG3C,QAAA,MAAM,kBAAkB;;;;iBAetB,CAAC;AAIH,wBAAgB,eAAe,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAOpE"}

package/dist/config/server-config.js

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview Server-specific environment configuration for workflows-mcp-server.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { parseEnvConfig } from '@cyanheads/mcp-ts-core/config';
+const ServerConfigSchema = z.object({
+    workflowsDir: z
+        .string()
+        .default('./workflows-yaml')
+        .describe('Absolute or relative path to the workflows root directory'),
+    globalInstructionsPath: z
+        .string()
+        .default('')
+        .describe('Path to the global instructions markdown file. Empty string means derive from WORKFLOWS_DIR.'),
+    watcherDebounceMs: z.coerce
+        .number()
+        .default(500)
+        .describe('Milliseconds to debounce filesystem change events before rebuilding the index'),
+});
+let _config;
+export function getServerConfig() {
+    _config ??= parseEnvConfig(ServerConfigSchema, {
+        workflowsDir: 'WORKFLOWS_DIR',
+        globalInstructionsPath: 'GLOBAL_INSTRUCTIONS_PATH',
+        watcherDebounceMs: 'WATCHER_DEBOUNCE_MS',
+    });
+    return _config;
+}
+//# sourceMappingURL=server-config.js.map

package/dist/config/server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,OAAO,CAAC,kBAAkB,CAAC;SAC3B,QAAQ,CAAC,2DAA2D,CAAC;IACxE,sBAAsB,EAAE,CAAC;SACtB,MAAM,EAAE;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CACP,8FAA8F,CAC/F;IACH,iBAAiB,EAAE,CAAC,CAAC,MAAM;SACxB,MAAM,EAAE;SACR,OAAO,CAAC,GAAG,CAAC;SACZ,QAAQ,CAAC,+EAA+E,CAAC;CAC7F,CAAC,CAAC;AAEH,IAAI,OAAuD,CAAC;AAE5D,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,cAAc,CAAC,kBAAkB,EAAE;QAC7C,YAAY,EAAE,eAAe;QAC7B,sBAAsB,EAAE,0BAA0B;QAClD,iBAAiB,EAAE,qBAAqB;KACzC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview workflows-mcp-server MCP server entry point.
+ * @module index
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/index.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview workflows-mcp-server MCP server entry point.
+ * @module index
+ */
+import * as path from 'node:path';
+import { createApp } from '@cyanheads/mcp-ts-core';
+import { getServerConfig } from './config/server-config.js';
+import { allToolDefinitions } from './mcp-server/tools/definitions/index.js';
+import { initWorkflowIndexService } from './services/workflow-index/workflow-index-service.js';
+await createApp({
+    tools: allToolDefinitions,
+    resources: [],
+    prompts: [],
+    instructions: 'A declarative workflow library. Use workflow_list to discover available workflows, ' +
+        'workflow_get to retrieve a full workflow definition with global instructions, ' +
+        'workflow_create to persist a new workflow, and workflow_create_temp to store a temporary one-shot plan.',
+    setup(core) {
+        const cfg = getServerConfig();
+        // Resolve the workflows directory relative to CWD
+        const workflowsDir = path.resolve(process.cwd(), cfg.workflowsDir);
+        // Derive globalInstructionsPath: use explicit override, or default to
+        // <workflowsDir>/global_instructions.md
+        const globalInstructionsPath = cfg.globalInstructionsPath.trim()
+            ? path.resolve(process.cwd(), cfg.globalInstructionsPath)
+            : path.join(workflowsDir, 'global_instructions.md');
+        initWorkflowIndexService(core.config, core.storage, workflowsDir, globalInstructionsPath, cfg.watcherDebounceMs);
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,wBAAwB,EAAE,MAAM,qDAAqD,CAAC;AAE/F,MAAM,SAAS,CAAC;IACd,KAAK,EAAE,kBAAkB;IACzB,SAAS,EAAE,EAAE;IACb,OAAO,EAAE,EAAE;IACX,YAAY,EACV,qFAAqF;QACrF,gFAAgF;QAChF,yGAAyG;IAE3G,KAAK,CAAC,IAAI;QACR,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;QAE9B,kDAAkD;QAClD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;QAEnE,sEAAsE;QACtE,wCAAwC;QACxC,MAAM,sBAAsB,GAAG,GAAG,CAAC,sBAAsB,CAAC,IAAI,EAAE;YAC9D,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,sBAAsB,CAAC;YACzD,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,wBAAwB,CAAC,CAAC;QAEtD,wBAAwB,CACtB,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,OAAO,EACZ,YAAY,EACZ,sBAAsB,EACtB,GAAG,CAAC,iBAAiB,CACtB,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/index.d.ts

@@ -0,0 +1,132 @@
+/**
+ * @fileoverview Barrel export for all tool definitions.
+ * @module mcp-server/tools/definitions/index
+ */
+export { workflowCreate } from './workflow-create.tool.js';
+export { workflowCreateTemp } from './workflow-create-temp.tool.js';
+export { workflowGet } from './workflow-get.tool.js';
+export { workflowList } from './workflow-list.tool.js';
+export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    name: import("zod").ZodString;
+    version: import("zod").ZodString;
+    description: import("zod").ZodString;
+    author: import("zod").ZodString;
+    category: import("zod").ZodString;
+    tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    steps: import("zod").ZodArray<import("zod").ZodObject<{
+        server: import("zod").ZodString;
+        tool: import("zod").ZodString;
+        action: import("zod").ZodOptional<import("zod").ZodString>;
+        description: import("zod").ZodOptional<import("zod").ZodString>;
+        name: import("zod").ZodOptional<import("zod").ZodString>;
+        params: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+        forEach: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    status: import("zod").ZodLiteral<"created">;
+    filePath: import("zod").ZodString;
+    key: import("zod").ZodString;
+    created_date: import("zod").ZodString;
+    last_updated_date: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "already_exists";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Conflict;
+    readonly when: "A permanent workflow with this name@version already exists in the index.";
+    readonly recovery: "Change the version field or use a different name to avoid the conflict.";
+}, {
+    readonly reason: "write_failed";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InternalError;
+    readonly when: "Filesystem write error (permissions, disk full, or name too long).";
+    readonly recovery: "Check that the workflows directory is writable, has sufficient disk space, and that the workflow name is not excessively long.";
+}]> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    name: import("zod").ZodString;
+    version: import("zod").ZodString;
+    description: import("zod").ZodString;
+    author: import("zod").ZodString;
+    tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    steps: import("zod").ZodArray<import("zod").ZodObject<{
+        server: import("zod").ZodString;
+        tool: import("zod").ZodString;
+        action: import("zod").ZodOptional<import("zod").ZodString>;
+        description: import("zod").ZodOptional<import("zod").ZodString>;
+        name: import("zod").ZodOptional<import("zod").ZodString>;
+        params: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+        forEach: import("zod").ZodOptional<import("zod").ZodString>;
+    }, import("zod/v4/core").$strip>>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    status: import("zod").ZodLiteral<"created">;
+    filePath: import("zod").ZodString;
+    key: import("zod").ZodString;
+    created_date: import("zod").ZodString;
+    last_updated_date: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "write_failed";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InternalError;
+    readonly when: "Filesystem write error (permissions, disk full, or name too long).";
+    readonly recovery: "Check that the workflows directory is writable, has sufficient disk space, and that the workflow name is not excessively long.";
+}]> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    name: import("zod").ZodString;
+    version: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    workflow: import("zod").ZodObject<{
+        name: import("zod").ZodString;
+        version: import("zod").ZodString;
+        description: import("zod").ZodString;
+        author: import("zod").ZodString;
+        category: import("zod").ZodOptional<import("zod").ZodString>;
+        tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        created_date: import("zod").ZodOptional<import("zod").ZodString>;
+        last_updated_date: import("zod").ZodOptional<import("zod").ZodString>;
+        temporary: import("zod").ZodOptional<import("zod").ZodBoolean>;
+        steps: import("zod").ZodArray<import("zod").ZodObject<{
+            server: import("zod").ZodString;
+            tool: import("zod").ZodString;
+            action: import("zod").ZodOptional<import("zod").ZodString>;
+            description: import("zod").ZodOptional<import("zod").ZodString>;
+            name: import("zod").ZodOptional<import("zod").ZodString>;
+            params: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>>;
+            forEach: import("zod").ZodOptional<import("zod").ZodString>;
+        }, import("zod/v4/core").$strip>>;
+    }, import("zod/v4/core").$strip>;
+    globalInstructions: import("zod").ZodNullable<import("zod").ZodString>;
+    source: import("zod").ZodEnum<{
+        temp: "temp";
+        permanent: "permanent";
+    }>;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "No workflow matches the given name.";
+    readonly recovery: "Use workflow_list to discover available workflow names and verify spelling.";
+}, {
+    readonly reason: "version_not_found";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
+    readonly when: "Name exists but the specific version does not.";
+    readonly recovery: "Omit version to get the latest, or use workflow_list to see available versions.";
+}, {
+    readonly reason: "index_unavailable";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "The workflow index has not finished building yet.";
+    readonly recovery: "Retry after the server has finished initializing its workflow index.";
+}]> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
+    category: import("zod").ZodOptional<import("zod").ZodString>;
+    tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    includeTools: import("zod").ZodOptional<import("zod").ZodBoolean>;
+}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
+    workflows: import("zod").ZodArray<import("zod").ZodObject<{
+        name: import("zod").ZodString;
+        version: import("zod").ZodString;
+        description: import("zod").ZodString;
+        author: import("zod").ZodString;
+        category: import("zod").ZodOptional<import("zod").ZodString>;
+        tags: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+        tools: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
+    }, import("zod/v4/core").$strip>>;
+    totalCount: import("zod").ZodNumber;
+}, import("zod/v4/core").$strip>, readonly [{
+    readonly reason: "index_unavailable";
+    readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "The workflow index has not finished building yet.";
+    readonly recovery: "Retry after the server has finished initializing its workflow index.";
+}]>)[];
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/tools/definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAOvD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAAkE,CAAC"}

package/dist/mcp-server/tools/definitions/index.js

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview Barrel export for all tool definitions.
+ * @module mcp-server/tools/definitions/index
+ */
+export { workflowCreate } from './workflow-create.tool.js';
+export { workflowCreateTemp } from './workflow-create-temp.tool.js';
+export { workflowGet } from './workflow-get.tool.js';
+export { workflowList } from './workflow-list.tool.js';
+import { workflowCreate } from './workflow-create.tool.js';
+import { workflowCreateTemp } from './workflow-create-temp.tool.js';
+import { workflowGet } from './workflow-get.tool.js';
+import { workflowList } from './workflow-list.tool.js';
+export const allToolDefinitions = [workflowList, workflowGet, workflowCreate, workflowCreateTemp];
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/tools/definitions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/workflow-create-temp.tool.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @fileoverview Tool definition for creating a temporary workflow.
+ * @module mcp-server/tools/definitions/workflow-create-temp
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const workflowCreateTemp: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodString;
+    author: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    steps: z.ZodArray<z.ZodObject<{
+        server: z.ZodString;
+        tool: z.ZodString;
+        action: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        forEach: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"created">;
+    filePath: z.ZodString;
+    key: z.ZodString;
+    created_date: z.ZodString;
+    last_updated_date: z.ZodString;
+}, z.core.$strip>, readonly [{
+    readonly reason: "write_failed";
+    readonly code: JsonRpcErrorCode.InternalError;
+    readonly when: "Filesystem write error (permissions, disk full, or name too long).";
+    readonly recovery: "Check that the workflows directory is writable, has sufficient disk space, and that the workflow name is not excessively long.";
+}]>;
+//# sourceMappingURL=workflow-create-temp.tool.d.ts.map

package/dist/mcp-server/tools/definitions/workflow-create-temp.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-create-temp.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/workflow-create-temp.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAwBjE,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;GAwH7B,CAAC"}

package/dist/mcp-server/tools/definitions/workflow-create-temp.tool.js

@@ -0,0 +1,132 @@
+/**
+ * @fileoverview Tool definition for creating a temporary workflow.
+ * @module mcp-server/tools/definitions/workflow-create-temp
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getWorkflowIndexService } from '../../../services/workflow-index/workflow-index-service.js';
+const StepInputSchema = z
+    .object({
+    server: z.string().min(1).describe('Target MCP server name.'),
+    tool: z.string().min(1).describe('Target tool on the server.'),
+    action: z.string().optional().describe('Sub-action or variant label.'),
+    description: z.string().optional().describe('Why this step exists.'),
+    name: z.string().optional().describe('Optional step name.'),
+    params: z
+        .record(z.string(), z.unknown())
+        .optional()
+        .describe('Key-value parameter map. May include {{input.foo}} placeholders for the consuming agent to resolve.'),
+    forEach: z
+        .string()
+        .optional()
+        .describe('Iteration expression (opaque, not executed server-side).'),
+})
+    .describe('A single workflow step with server, tool, and optional params/metadata.');
+export const workflowCreateTemp = tool('workflow_create_temp', {
+    title: 'Create Temporary Workflow',
+    description: 'Write a temporary workflow to the temp/ directory. ' +
+        'Temporary workflows are indexed and retrievable via workflow_get but excluded from workflow_list results. ' +
+        'No conflict check — temp is throwaway. Useful for one-shot plans, short-lived scaffolding, or workflows not intended for the permanent library. ' +
+        'The server stamps created_date and last_updated_date automatically.',
+    annotations: { readOnlyHint: false, idempotentHint: false, openWorldHint: false },
+    input: z.object({
+        name: z.string().min(1).describe('Workflow name (human-readable).'),
+        version: z
+            .string()
+            .regex(/^\d+\.\d+\.\d+/)
+            .describe('Semver version string (e.g. "1.0.0").'),
+        description: z.string().min(1).describe('One-line description of what the workflow does.'),
+        author: z.string().min(1).describe('Author name or team.'),
+        tags: z.array(z.string()).optional().describe('Free-form tags.'),
+        steps: z
+            .array(StepInputSchema)
+            .min(1)
+            .describe('Ordered sequence of steps. Each step must have server and tool fields.'),
+    }),
+    output: z.object({
+        status: z
+            .literal('created')
+            .describe('Confirms the temporary workflow was written to disk and indexed.'),
+        filePath: z.string().describe('Absolute path where the workflow was written.'),
+        key: z.string().describe('Index key for this workflow: name@version.'),
+        created_date: z.string().describe('Date the workflow was created (YYYY-MM-DD).'),
+        last_updated_date: z.string().describe('Date the workflow was last updated (YYYY-MM-DD).'),
+    }),
+    errors: [
+        {
+            reason: 'write_failed',
+            code: JsonRpcErrorCode.InternalError,
+            when: 'Filesystem write error (permissions, disk full, or name too long).',
+            recovery: 'Check that the workflows directory is writable, has sufficient disk space, and that the workflow name is not excessively long.',
+        },
+    ],
+    async handler(input, ctx) {
+        const svc = getWorkflowIndexService();
+        const today = new Date().toISOString().slice(0, 10);
+        const workflow = {
+            name: input.name.trim(),
+            version: input.version.trim(),
+            description: input.description,
+            author: input.author,
+            ...(input.tags !== undefined && { tags: input.tags }),
+            created_date: today,
+            last_updated_date: today,
+            temporary: true,
+            steps: input.steps.map((s) => ({
+                server: s.server,
+                tool: s.tool,
+                ...(s.action !== undefined && { action: s.action }),
+                ...(s.description !== undefined && { description: s.description }),
+                ...(s.name !== undefined && { name: s.name }),
+                ...(s.params !== undefined && { params: s.params }),
+                ...(s.forEach !== undefined && { forEach: s.forEach }),
+            })),
+        };
+        let filePath;
+        try {
+            filePath = await svc.writeTemp(workflow);
+        }
+        catch (err) {
+            const reason = err._reason;
+            if (err instanceof Error && (reason === 'name_too_long' || reason === 'invalid_name')) {
+                throw ctx.fail('write_failed', err.message, { ...ctx.recoveryFor('write_failed') });
+            }
+            ctx.log.error('Failed to write temp workflow', err instanceof Error ? err : new Error(String(err)));
+            const safeMsg = err instanceof Error
+                ? err.message.replace(/\s*open '.*?'/g, '').trim()
+                : 'Unknown write error';
+            throw ctx.fail('write_failed', `Failed to write temp workflow: ${safeMsg}`, {
+                ...ctx.recoveryFor('write_failed'),
+            });
+        }
+        ctx.log.info('workflow_create_temp completed', {
+            name: workflow.name,
+            version: workflow.version,
+            filePath,
+        });
+        return {
+            status: 'created',
+            filePath,
+            key: `${workflow.name}@${workflow.version}`,
+            created_date: today,
+            last_updated_date: today,
+        };
+    },
+    format(result) {
+        return [
+            {
+                type: 'text',
+                text: [
+                    `## Temporary Workflow Created`,
+                    `**Status:** ${result.status}`,
+                    `**Key:** ${result.key}`,
+                    `**File:** ${result.filePath}`,
+                    `**Created:** ${result.created_date}`,
+                    `**Updated:** ${result.last_updated_date}`,
+                    `> This workflow is temporary — excluded from workflow_list but accessible via workflow_get.`,
+                ].join('\n'),
+            },
+        ];
+    },
+});
+//# sourceMappingURL=workflow-create-temp.tool.js.map

package/dist/mcp-server/tools/definitions/workflow-create-temp.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-create-temp.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/workflow-create-temp.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/workflow-create.tool.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview Tool definition for creating a permanent workflow.
+ * @module mcp-server/tools/definitions/workflow-create
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const workflowCreate: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodString;
+    description: z.ZodString;
+    author: z.ZodString;
+    category: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    steps: z.ZodArray<z.ZodObject<{
+        server: z.ZodString;
+        tool: z.ZodString;
+        action: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        params: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        forEach: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    status: z.ZodLiteral<"created">;
+    filePath: z.ZodString;
+    key: z.ZodString;
+    created_date: z.ZodString;
+    last_updated_date: z.ZodString;
+}, z.core.$strip>, readonly [{
+    readonly reason: "already_exists";
+    readonly code: JsonRpcErrorCode.Conflict;
+    readonly when: "A permanent workflow with this name@version already exists in the index.";
+    readonly recovery: "Change the version field or use a different name to avoid the conflict.";
+}, {
+    readonly reason: "write_failed";
+    readonly code: JsonRpcErrorCode.InternalError;
+    readonly when: "Filesystem write error (permissions, disk full, or name too long).";
+    readonly recovery: "Check that the workflows directory is writable, has sufficient disk space, and that the workflow name is not excessively long.";
+}]>;
+//# sourceMappingURL=workflow-create.tool.d.ts.map

package/dist/mcp-server/tools/definitions/workflow-create.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-create.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/workflow-create.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAwBjE,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoJzB,CAAC"}

package/dist/mcp-server/tools/definitions/workflow-create.tool.js

@@ -0,0 +1,153 @@
+/**
+ * @fileoverview Tool definition for creating a permanent workflow.
+ * @module mcp-server/tools/definitions/workflow-create
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getWorkflowIndexService } from '../../../services/workflow-index/workflow-index-service.js';
+const StepInputSchema = z
+    .object({
+    server: z.string().min(1).describe('Target MCP server name.'),
+    tool: z.string().min(1).describe('Target tool on the server.'),
+    action: z.string().optional().describe('Sub-action or variant label.'),
+    description: z.string().optional().describe('Why this step exists.'),
+    name: z.string().optional().describe('Optional step name.'),
+    params: z
+        .record(z.string(), z.unknown())
+        .optional()
+        .describe('Key-value parameter map. May include {{input.foo}} placeholders for the consuming agent to resolve.'),
+    forEach: z
+        .string()
+        .optional()
+        .describe('Iteration expression (opaque, not executed server-side).'),
+})
+    .describe('A single workflow step with server, tool, and optional params/metadata.');
+export const workflowCreate = tool('workflow_create', {
+    title: 'Create Workflow',
+    description: 'Write a new permanent workflow YAML to the categories/<slugified-category>/ directory. ' +
+        'Rejects if name@version already exists in the index — use a different version to update. ' +
+        'The server stamps created_date and last_updated_date automatically. ' +
+        'Rebuilds the index after writing. Template placeholders in params ({{input.foo}}) are stored verbatim.',
+    annotations: { readOnlyHint: false, idempotentHint: false, openWorldHint: false },
+    input: z.object({
+        name: z
+            .string()
+            .min(1)
+            .describe('Workflow name (human-readable, e.g. "Standard Git Wrap-up").'),
+        version: z
+            .string()
+            .regex(/^\d+\.\d+\.\d+/)
+            .describe('Semver version string (e.g. "1.0.0").'),
+        description: z.string().min(1).describe('One-line description of what the workflow does.'),
+        author: z.string().min(1).describe('Author name or team.'),
+        category: z
+            .string()
+            .min(1)
+            .describe('Category name (e.g. "Git Operations"). Used to determine the storage directory. Must not be blank or whitespace-only.'),
+        tags: z.array(z.string()).optional().describe('Free-form tags for filtering.'),
+        steps: z
+            .array(StepInputSchema)
+            .min(1)
+            .describe('Ordered sequence of steps. Each step must have server and tool fields.'),
+    }),
+    output: z.object({
+        status: z.literal('created').describe('Confirms the workflow was written to disk and indexed.'),
+        filePath: z.string().describe('Absolute path where the workflow was written.'),
+        key: z.string().describe('Index key for this workflow: name@version.'),
+        created_date: z.string().describe('Date the workflow was created (YYYY-MM-DD).'),
+        last_updated_date: z.string().describe('Date the workflow was last updated (YYYY-MM-DD).'),
+    }),
+    errors: [
+        {
+            reason: 'already_exists',
+            code: JsonRpcErrorCode.Conflict,
+            when: 'A permanent workflow with this name@version already exists in the index.',
+            recovery: 'Change the version field or use a different name to avoid the conflict.',
+        },
+        {
+            reason: 'write_failed',
+            code: JsonRpcErrorCode.InternalError,
+            when: 'Filesystem write error (permissions, disk full, or name too long).',
+            recovery: 'Check that the workflows directory is writable, has sufficient disk space, and that the workflow name is not excessively long.',
+        },
+    ],
+    async handler(input, ctx) {
+        const svc = getWorkflowIndexService();
+        // Reject whitespace-only category at the tool boundary (Zod min(1) passes "   ").
+        if (input.category.trim().length === 0) {
+            throw ctx.fail('write_failed', 'Category must not be blank or whitespace-only.', {
+                ...ctx.recoveryFor('write_failed'),
+            });
+        }
+        const today = new Date().toISOString().slice(0, 10);
+        const workflow = {
+            name: input.name.trim(),
+            version: input.version.trim(),
+            description: input.description,
+            author: input.author,
+            category: input.category.trim(),
+            ...(input.tags !== undefined && { tags: input.tags }),
+            created_date: today,
+            last_updated_date: today,
+            steps: input.steps.map((s) => ({
+                server: s.server,
+                tool: s.tool,
+                ...(s.action !== undefined && { action: s.action }),
+                ...(s.description !== undefined && { description: s.description }),
+                ...(s.name !== undefined && { name: s.name }),
+                ...(s.params !== undefined && { params: s.params }),
+                ...(s.forEach !== undefined && { forEach: s.forEach }),
+            })),
+        };
+        let filePath;
+        try {
+            filePath = await svc.writePermanent(workflow);
+        }
+        catch (err) {
+            const reason = err._reason;
+            if (err instanceof Error && reason === 'already_exists') {
+                throw ctx.fail('already_exists', `Workflow "${workflow.name}@${workflow.version}" already exists`, { ...ctx.recoveryFor('already_exists') });
+            }
+            if (err instanceof Error && (reason === 'name_too_long' || reason === 'invalid_name')) {
+                // Surface name validation issues as write_failed with the service's message (no path leak).
+                throw ctx.fail('write_failed', err.message, { ...ctx.recoveryFor('write_failed') });
+            }
+            ctx.log.error('Failed to write workflow', err instanceof Error ? err : new Error(String(err)));
+            // Strip filesystem paths from the user-visible message.
+            const safeMsg = err instanceof Error
+                ? err.message.replace(/\s*open '.*?'/g, '').trim()
+                : 'Unknown write error';
+            throw ctx.fail('write_failed', `Failed to write workflow: ${safeMsg}`, {
+                ...ctx.recoveryFor('write_failed'),
+            });
+        }
+        ctx.log.info('workflow_create completed', {
+            name: workflow.name,
+            version: workflow.version,
+            filePath,
+        });
+        return {
+            status: 'created',
+            filePath,
+            key: `${workflow.name}@${workflow.version}`,
+            created_date: today,
+            last_updated_date: today,
+        };
+    },
+    format(result) {
+        return [
+            {
+                type: 'text',
+                text: [
+                    `## Workflow Created`,
+                    `**Status:** ${result.status}`,
+                    `**Key:** ${result.key}`,
+                    `**File:** ${result.filePath}`,
+                    `**Created:** ${result.created_date}`,
+                    `**Updated:** ${result.last_updated_date}`,
+                ].join('\n'),
+            },
+        ];
+    },
+});
+//# sourceMappingURL=workflow-create.tool.js.map