@rubytech/create-maxy-code 0.1.0

package/payload/platform/plugins/workflows/mcp/dist/lib/step-resolver.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Step resolver — dependency ordering and template variable resolution.
+ *
+ * Pure functions: steps + context in → ordered execution plan out.
+ * No I/O, no side effects, no Neo4j.
+ *
+ *   STEPS (unordered)
+ *     │
+ *     v
+ *   resolveOrder()  ──→  Kahn's algorithm (topological sort)
+ *     │                    ├─ cycle detected → CyclicDependencyError
+ *     │                    └─ position tiebreak for independent steps
+ *     v
+ *   ORDERED STEPS
+ *     │
+ *     v
+ *   resolveTemplates()  ──→  {{key.path}} substitution
+ *     │                        ├─ JSON parse: object → pass-through, array → {_items}, else {_raw}
+ *     │                        └─ unresolved → UnresolvedTemplateError
+ *     v
+ *   RESOLVED PARAMS
+ */
+interface StepBase {
+    stepId: string;
+    dependsOn?: string[];
+    onFailure?: "abort" | "skip" | "retry";
+    retryLimit?: number;
+    outputKey?: string;
+    timeout?: number;
+    position: number;
+    label: string;
+}
+export interface ToolStepDefinition extends StepBase {
+    type: "tool";
+    plugin: string;
+    tool: string;
+    params?: Record<string, unknown>;
+}
+/**
+ * MCP server configuration for agentic LLM steps.
+ * Same shape as Claude Code's .mcp.json `mcpServers` entries.
+ */
+export interface McpServerConfig {
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+}
+export interface LlmStepDefinition extends StepBase {
+    type: "llm";
+    prompt: string;
+    model?: string;
+    maxTokens?: number;
+    /**
+     * Optional MCP server bindings for agentic steps. When present,
+     * the executor spawns Claude Code with --mcp-config and
+     * --strict-mcp-config, giving the LLM access to the declared
+     * tools for multi-turn reasoning.
+     *
+     * Keys are server names (matching Claude Code's plugin naming),
+     * values are the server spawn configuration.
+     */
+    mcpServers?: Record<string, McpServerConfig>;
+    /**
+     * Maximum agent turns when mcpServers is present.
+     * Controls how many reasoning+tool-use cycles the LLM can perform.
+     * Defaults to 10 when mcpServers is declared, 1 otherwise.
+     * Min 2 when mcpServers is present (1 turn = no tool loop).
+     * Max 50 to prevent runaway agent loops.
+     */
+    maxTurns?: number;
+    /**
+     * Behaviour when the LLM call cannot produce a response
+     * (pre-flight probe failed OR spawn failed during execution).
+     *
+     * - `"fail"` (default): apply the step's onFailure policy
+     *   (abort / skip / retry). Retries are short-circuited when
+     *   pre-flight probe already confirmed the LLM is unavailable.
+     * - `"raw"`: emit a degraded output via renderFallbackTemplate()
+     *   and mark the StepResult with status `"degraded"`. Requires
+     *   outputKey so downstream steps can consume the fallback.
+     */
+    fallbackMode?: "fail" | "raw";
+    /**
+     * Optional custom fallback template. Used only when
+     * `fallbackMode === "raw"`. Resolved via renderFallbackTemplate()
+     * with extra variables `{{_error}}` and `{{_priorOutputs}}`.
+     * Defaults to a standard banner + prior-output dump.
+     * Max 4 KB.
+     */
+    fallbackTemplate?: string;
+}
+export type StepDefinition = ToolStepDefinition | LlmStepDefinition;
+/**
+ * Topological sort with position-based tiebreaking.
+ * Returns steps in execution order. Throws on cycles.
+ */
+export declare function resolveOrder(steps: StepDefinition[]): StepDefinition[];
+/**
+ * Parse a step's MCP tool response text into a structured output.
+ * If the text is valid JSON: objects are returned directly, arrays are
+ * wrapped as { _items: array }. Non-object/array JSON and unparseable
+ * text are wrapped as { _raw: text }.
+ */
+export declare function parseStepOutput(text: string): Record<string, unknown>;
+/**
+ * Resolve all {{template.variables}} in a params object.
+ * Context is a map of outputKey → parsed step output.
+ *
+ * Throws UnresolvedTemplateError if any variable cannot be resolved.
+ */
+export declare function resolveTemplates(params: Record<string, unknown>, context: Record<string, Record<string, unknown>>): Record<string, unknown>;
+/**
+ * Resolve template variables in a single string value.
+ * Supports full replacement: "{{a.b}}" → value of a.b
+ * Supports interpolation: "Hello {{name}}" → "Hello John"
+ */
+export declare function resolveStringTemplate(template: string, context: Record<string, Record<string, unknown>>): unknown;
+export interface RenderFallbackParams {
+    /** Optional custom template. Undefined → use the default template. */
+    template: string | undefined;
+    /** All prior step outputs available in the execution context. */
+    outputContext: Record<string, Record<string, unknown>>;
+    /** One-line summary of the probe or spawn error that triggered fallback. */
+    error: string;
+    /**
+     * Keys to exclude from the `{{_priorOutputs}}` dump (typically the
+     * seeded inputContext keys from the workflow invocation). These keys
+     * may contain credentials or trigger metadata that must not leak into
+     * delivered degraded output. Individual references like
+     * `{{stepKey.field}}` in a custom template still resolve normally —
+     * only the catch-all dump respects this exclusion.
+     */
+    excludeFromPriorOutputs?: ReadonlySet<string>;
+}
+/**
+ * Render a fallback output string when an LLM step's call cannot succeed.
+ *
+ * Lenient by design — unresolved `{{ref}}` variables become
+ * `<unresolved: ref>` rather than throwing. A fallback that itself throws
+ * would defeat the degradation mechanism.
+ *
+ *   DEFAULT TEMPLATE → banner + {{_error}} + {{_priorOutputs}}
+ *   CUSTOM TEMPLATE  → author-supplied string with the same special
+ *                      variables plus any {{stepKey.field}} from outputContext
+ *
+ * This is a dedicated helper, not a `lenient: true` flag on
+ * resolveStringTemplate(), because only fallback rendering needs the
+ * lenient semantics — normal step execution must still fail loudly on
+ * unresolved refs.
+ */
+export declare function renderFallbackTemplate(params: RenderFallbackParams): string;
+export {};
+//# sourceMappingURL=step-resolver.d.ts.map

package/payload/platform/plugins/workflows/mcp/dist/lib/step-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-resolver.d.ts","sourceRoot":"","sources":["../../src/lib/step-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAMH,UAAU,QAAQ;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAmB,SAAQ,QAAQ;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAkB,SAAQ,QAAQ;IACjD,IAAI,EAAE,KAAK,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC7C;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC9B;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,cAAc,GAAG,kBAAkB,GAAG,iBAAiB,CAAC;AAMpE;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAwDtE;AAMD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsBrE;AAkBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC/C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiBzB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC/C,OAAO,CA8BT;AAwED,MAAM,WAAW,oBAAoB;IACnC,sEAAsE;IACtE,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,iEAAiE;IACjE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACvD,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;;OAOG;IACH,uBAAuB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC/C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,oBAAoB,GAC3B,MAAM,CA0BR"}

package/payload/platform/plugins/workflows/mcp/dist/lib/step-resolver.js

@@ -0,0 +1,273 @@
+/**
+ * Step resolver — dependency ordering and template variable resolution.
+ *
+ * Pure functions: steps + context in → ordered execution plan out.
+ * No I/O, no side effects, no Neo4j.
+ *
+ *   STEPS (unordered)
+ *     │
+ *     v
+ *   resolveOrder()  ──→  Kahn's algorithm (topological sort)
+ *     │                    ├─ cycle detected → CyclicDependencyError
+ *     │                    └─ position tiebreak for independent steps
+ *     v
+ *   ORDERED STEPS
+ *     │
+ *     v
+ *   resolveTemplates()  ──→  {{key.path}} substitution
+ *     │                        ├─ JSON parse: object → pass-through, array → {_items}, else {_raw}
+ *     │                        └─ unresolved → UnresolvedTemplateError
+ *     v
+ *   RESOLVED PARAMS
+ */
+// ─────────────────────────────────────────────────────────────
+// Dependency resolution — Kahn's algorithm
+// ─────────────────────────────────────────────────────────────
+/**
+ * Topological sort with position-based tiebreaking.
+ * Returns steps in execution order. Throws on cycles.
+ */
+export function resolveOrder(steps) {
+    const byId = new Map();
+    const inDegree = new Map();
+    const dependents = new Map();
+    for (const step of steps) {
+        byId.set(step.stepId, step);
+        inDegree.set(step.stepId, 0);
+        dependents.set(step.stepId, []);
+    }
+    for (const step of steps) {
+        if (!step.dependsOn)
+            continue;
+        for (const depId of step.dependsOn) {
+            if (!byId.has(depId)) {
+                throw new Error(`Step "${step.label}" (${step.stepId}) depends on unknown step "${depId}"`);
+            }
+            inDegree.set(step.stepId, (inDegree.get(step.stepId) ?? 0) + 1);
+            dependents.get(depId).push(step.stepId);
+        }
+    }
+    // Seed queue with steps that have no dependencies, sorted by position
+    const queue = steps
+        .filter((s) => (inDegree.get(s.stepId) ?? 0) === 0)
+        .sort((a, b) => a.position - b.position);
+    const ordered = [];
+    while (queue.length > 0) {
+        const current = queue.shift();
+        ordered.push(current);
+        for (const depId of dependents.get(current.stepId) ?? []) {
+            const newDegree = (inDegree.get(depId) ?? 1) - 1;
+            inDegree.set(depId, newDegree);
+            if (newDegree === 0) {
+                queue.push(byId.get(depId));
+                // Re-sort by position for deterministic ordering among freed steps
+                queue.sort((a, b) => a.position - b.position);
+            }
+        }
+    }
+    if (ordered.length !== steps.length) {
+        const stuck = steps
+            .filter((s) => !ordered.includes(s))
+            .map((s) => `"${s.label}" (${s.stepId})`);
+        throw new Error(`Cycle detected in step dependencies — stuck steps: ${stuck.join(", ")}`);
+    }
+    return ordered;
+}
+// ─────────────────────────────────────────────────────────────
+// Template resolution
+// ─────────────────────────────────────────────────────────────
+/**
+ * Parse a step's MCP tool response text into a structured output.
+ * If the text is valid JSON: objects are returned directly, arrays are
+ * wrapped as { _items: array }. Non-object/array JSON and unparseable
+ * text are wrapped as { _raw: text }.
+ */
+export function parseStepOutput(text) {
+    // Strip markdown code fences — LLMs frequently wrap JSON in ```json blocks
+    // despite instructions not to. Try the cleaned version first, fall back to raw.
+    const cleaned = text
+        .replace(/^```json?\s*/i, "")
+        .replace(/\s*```\s*$/i, "")
+        .trim();
+    const toParse = cleaned || text;
+    try {
+        const parsed = JSON.parse(toParse);
+        if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
+            return parsed;
+        }
+        if (Array.isArray(parsed)) {
+            return { _items: parsed };
+        }
+        return { _raw: toParse };
+    }
+    catch {
+        return { _raw: toParse };
+    }
+}
+/**
+ * Resolve dot-notation path into a nested object.
+ * "a.b.c" on { a: { b: { c: 42 } } } → 42
+ * Returns undefined if any segment is missing.
+ */
+function resolvePath(obj, path) {
+    let current = obj;
+    for (const segment of path.split(".")) {
+        if (current === null || current === undefined || typeof current !== "object") {
+            return undefined;
+        }
+        current = current[segment];
+    }
+    return current;
+}
+/**
+ * Resolve all {{template.variables}} in a params object.
+ * Context is a map of outputKey → parsed step output.
+ *
+ * Throws UnresolvedTemplateError if any variable cannot be resolved.
+ */
+export function resolveTemplates(params, context) {
+    const resolved = {};
+    for (const [key, value] of Object.entries(params)) {
+        if (typeof value === "string") {
+            resolved[key] = resolveStringTemplate(value, context);
+        }
+        else if (typeof value === "object" && value !== null && !Array.isArray(value)) {
+            resolved[key] = resolveTemplates(value, context);
+        }
+        else {
+            resolved[key] = value;
+        }
+    }
+    return resolved;
+}
+/**
+ * Resolve template variables in a single string value.
+ * Supports full replacement: "{{a.b}}" → value of a.b
+ * Supports interpolation: "Hello {{name}}" → "Hello John"
+ */
+export function resolveStringTemplate(template, context) {
+    const TEMPLATE_RE = /\{\{([^}]+)\}\}/g;
+    const matches = [...template.matchAll(TEMPLATE_RE)];
+    if (matches.length === 0)
+        return template;
+    // If the entire string is a single template variable, return the raw value
+    // (preserving type — number, boolean, object, etc.)
+    if (matches.length === 1 && matches[0][0] === template) {
+        const path = matches[0][1].trim();
+        const value = resolveContextPath(path, context);
+        if (value === undefined) {
+            throw new Error(`Unresolved template variable '{{${path}}}' — not found in context or prior step outputs`);
+        }
+        return value;
+    }
+    // Multiple variables or mixed text+variable — string interpolation
+    return template.replace(TEMPLATE_RE, (_match, rawPath) => {
+        const path = rawPath.trim();
+        const value = resolveContextPath(path, context);
+        if (value === undefined) {
+            throw new Error(`Unresolved template variable '{{${path}}}' — not found in context or prior step outputs`);
+        }
+        return typeof value === "object" ? JSON.stringify(value) : String(value);
+    });
+}
+/**
+ * Resolve a dotted path against the context.
+ * First segment is the outputKey, remaining segments traverse the output object.
+ * e.g. "newContact.contactId" → context["newContact"]["contactId"]
+ */
+function resolveContextPath(path, context) {
+    const [rootKey, ...rest] = path.split(".");
+    const root = context[rootKey];
+    if (root === undefined)
+        return undefined;
+    if (rest.length === 0)
+        return root;
+    return resolvePath(root, rest.join("."));
+}
+// ─────────────────────────────────────────────────────────────
+// Fallback template rendering (degradation path)
+// ─────────────────────────────────────────────────────────────
+const FALLBACK_DEFAULT_TEMPLATE = "⚠️ AI reasoning is temporarily unavailable ({{_error}}).\n\n" +
+    "The workflow has fallen back to raw data.\n\n" +
+    "{{_priorOutputs}}";
+/**
+ * Max characters (JS string length, UTF-16 code units) for the
+ * `{{_priorOutputs}}` substitution. Keeps banner + error line intact
+ * under the workflow-execute MAX_OUTPUT_SIZE (10 KB) storage cap.
+ * Uses char count to match the existing MAX_OUTPUT_SIZE truncation
+ * pattern in workflow-execute.ts; multi-byte characters may exceed
+ * 8 KB on the wire but stay within the storage cap.
+ */
+const PRIOR_OUTPUTS_MAX_CHARS = 8 * 1024;
+/**
+ * Serialise prior step outputs into a human-readable dump for inclusion
+ * in a fallback delivery message. Caps at 8 KB of characters.
+ *
+ * Excluded keys (typically the seeded inputContext keys from the workflow
+ * invocation) are skipped entirely — seeded inputs can contain credentials
+ * or trigger metadata that must not leak into delivered output.
+ */
+function serialisePriorOutputs(outputContext, excludeKeys) {
+    const keys = Object.keys(outputContext).filter((k) => !excludeKeys.has(k));
+    if (keys.length === 0)
+        return "";
+    const parts = [];
+    for (const key of keys) {
+        const val = outputContext[key];
+        parts.push(`### ${key}`);
+        if (val && typeof val === "object" && typeof val._raw === "string") {
+            parts.push(val._raw);
+        }
+        else {
+            try {
+                parts.push(JSON.stringify(val, null, 2));
+            }
+            catch {
+                parts.push(String(val));
+            }
+        }
+    }
+    const joined = parts.join("\n\n");
+    if (joined.length <= PRIOR_OUTPUTS_MAX_CHARS)
+        return joined;
+    return joined.slice(0, PRIOR_OUTPUTS_MAX_CHARS) + "\n...[truncated]";
+}
+/**
+ * Render a fallback output string when an LLM step's call cannot succeed.
+ *
+ * Lenient by design — unresolved `{{ref}}` variables become
+ * `<unresolved: ref>` rather than throwing. A fallback that itself throws
+ * would defeat the degradation mechanism.
+ *
+ *   DEFAULT TEMPLATE → banner + {{_error}} + {{_priorOutputs}}
+ *   CUSTOM TEMPLATE  → author-supplied string with the same special
+ *                      variables plus any {{stepKey.field}} from outputContext
+ *
+ * This is a dedicated helper, not a `lenient: true` flag on
+ * resolveStringTemplate(), because only fallback rendering needs the
+ * lenient semantics — normal step execution must still fail loudly on
+ * unresolved refs.
+ */
+export function renderFallbackTemplate(params) {
+    const { template, outputContext, error, excludeFromPriorOutputs } = params;
+    const effective = template ?? FALLBACK_DEFAULT_TEMPLATE;
+    const excludeKeys = excludeFromPriorOutputs ?? new Set();
+    const priorOutputs = serialisePriorOutputs(outputContext, excludeKeys);
+    const TEMPLATE_RE = /\{\{([^}]+)\}\}/g;
+    return effective.replace(TEMPLATE_RE, (_match, rawPath) => {
+        const path = rawPath.trim();
+        if (path === "_error")
+            return error;
+        if (path === "_priorOutputs")
+            return priorOutputs;
+        const value = resolveContextPath(path, outputContext);
+        if (value === undefined) {
+            console.error(`[workflow-execute] fallback template has unresolved ref: ${path}`);
+            return `<unresolved: ${path}>`;
+        }
+        if (typeof value === "object")
+            return JSON.stringify(value);
+        return String(value);
+    });
+}
+//# sourceMappingURL=step-resolver.js.map

package/payload/platform/plugins/workflows/mcp/dist/lib/step-resolver.js.map

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

package/payload/platform/plugins/workflows/mcp/dist/lib/validate-capabilities.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Capability validation — checks that referenced plugins and MCP servers exist.
+ *
+ * Validates at workflow creation/update time:
+ *   - Tool steps: plugin directory + built MCP server must exist.
+ *   - Agentic LLM steps (mcpServers declared): each server's command
+ *     binary must be resolvable via PATH. Path traversal in commands
+ *     is rejected by the Zod schema before reaching this layer.
+ *
+ * If any capability is missing, the workflow is set to 'draft'.
+ */
+import type { StepDefinition } from "./step-resolver.js";
+export interface ValidationResult {
+    valid: boolean;
+    errors: StepValidationError[];
+}
+export interface StepValidationError {
+    stepId: string;
+    label: string;
+    plugin: string;
+    tool: string;
+    reason: string;
+}
+/**
+ * Validate that every step's referenced capabilities exist.
+ *
+ * - Tool steps: plugin directory and built MCP server.
+ * - Agentic LLM steps: MCP server command binaries resolvable via PATH.
+ * - Non-agentic LLM steps: no validation needed (unchanged).
+ */
+export declare function validateCapabilities(steps: StepDefinition[], platformRoot: string): ValidationResult;
+//# sourceMappingURL=validate-capabilities.d.ts.map

package/payload/platform/plugins/workflows/mcp/dist/lib/validate-capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-capabilities.d.ts","sourceRoot":"","sources":["../../src/lib/validate-capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAeD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,cAAc,EAAE,EACvB,YAAY,EAAE,MAAM,GACnB,gBAAgB,CAmElB"}

package/payload/platform/plugins/workflows/mcp/dist/lib/validate-capabilities.js

@@ -0,0 +1,97 @@
+/**
+ * Capability validation — checks that referenced plugins and MCP servers exist.
+ *
+ * Validates at workflow creation/update time:
+ *   - Tool steps: plugin directory + built MCP server must exist.
+ *   - Agentic LLM steps (mcpServers declared): each server's command
+ *     binary must be resolvable via PATH. Path traversal in commands
+ *     is rejected by the Zod schema before reaching this layer.
+ *
+ * If any capability is missing, the workflow is set to 'draft'.
+ */
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { execFileSync } from "node:child_process";
+/**
+ * Check if a command binary is resolvable via PATH.
+ * Uses `which` on Unix. Returns true if found.
+ */
+function commandExists(command) {
+    try {
+        execFileSync("which", [command], { stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Validate that every step's referenced capabilities exist.
+ *
+ * - Tool steps: plugin directory and built MCP server.
+ * - Agentic LLM steps: MCP server command binaries resolvable via PATH.
+ * - Non-agentic LLM steps: no validation needed (unchanged).
+ */
+export function validateCapabilities(steps, platformRoot) {
+    const pluginsRoot = resolve(platformRoot, "plugins");
+    const errors = [];
+    for (const step of steps) {
+        if (step.type === "llm") {
+            // Agentic LLM steps: validate MCP server command binaries
+            if (step.mcpServers) {
+                for (const [serverName, config] of Object.entries(step.mcpServers)) {
+                    if (!commandExists(config.command)) {
+                        errors.push({
+                            stepId: step.stepId,
+                            label: step.label,
+                            plugin: `mcp:${serverName}`,
+                            tool: config.command,
+                            reason: `MCP server "${serverName}": command "${config.command}" not found in PATH`,
+                        });
+                    }
+                }
+            }
+            continue;
+        }
+        // Tool steps: validate plugin directory + built MCP server
+        const pluginDir = resolve(pluginsRoot, step.plugin);
+        // Path traversal check
+        if (!pluginDir.startsWith(pluginsRoot + "/")) {
+            errors.push({
+                stepId: step.stepId,
+                label: step.label,
+                plugin: step.plugin,
+                tool: step.tool,
+                reason: `Invalid plugin name: "${step.plugin}" — path traversal blocked`,
+            });
+            continue;
+        }
+        // Plugin directory existence
+        if (!existsSync(pluginDir)) {
+            errors.push({
+                stepId: step.stepId,
+                label: step.label,
+                plugin: step.plugin,
+                tool: step.tool,
+                reason: `Plugin not found: "${step.plugin}" — directory does not exist at ${pluginDir}`,
+            });
+            continue;
+        }
+        // MCP server built
+        const serverPath = resolve(pluginDir, "mcp", "dist", "index.js");
+        if (!existsSync(serverPath)) {
+            errors.push({
+                stepId: step.stepId,
+                label: step.label,
+                plugin: step.plugin,
+                tool: step.tool,
+                reason: `Plugin "${step.plugin}" exists but MCP server is not built — expected ${serverPath}`,
+            });
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+//# sourceMappingURL=validate-capabilities.js.map

package/payload/platform/plugins/workflows/mcp/dist/lib/validate-capabilities.js.map

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

package/payload/platform/plugins/workflows/mcp/dist/tools/workflow-create.d.ts

@@ -0,0 +1,48 @@
+import type { McpServerConfig } from "../lib/step-resolver.js";
+import { type CreatedBy } from "../../../../../lib/graph-write/dist/index.js";
+interface StepInputBase {
+    dependsOn?: string[];
+    onFailure?: "abort" | "skip" | "retry";
+    retryLimit?: number;
+    outputKey?: string;
+    timeout?: number;
+    label: string;
+}
+export interface ToolStepInput extends StepInputBase {
+    type: "tool";
+    plugin: string;
+    tool: string;
+    params?: Record<string, unknown>;
+}
+export interface LlmStepInput extends StepInputBase {
+    type: "llm";
+    prompt: string;
+    model?: string;
+    maxTokens?: number;
+    /** MCP server bindings for agentic steps. */
+    mcpServers?: Record<string, McpServerConfig>;
+    /** Max agent turns (default 1, or 10 when mcpServers present). */
+    maxTurns?: number;
+    /** "fail" (default) or "raw" (emit degraded output on LLM unavailability). */
+    fallbackMode?: "fail" | "raw";
+    /** Custom fallback template, used only with fallbackMode="raw". Max 4 KB. */
+    fallbackTemplate?: string;
+}
+export type StepInput = ToolStepInput | LlmStepInput;
+export interface WorkflowCreateParams {
+    accountId: string;
+    name: string;
+    description: string;
+    steps: StepInput[];
+    /** Conversation sessionKey — Workflow is linked PART_OF this Conversation to satisfy the write doctrine. */
+    sessionKey?: string;
+    createdBy: CreatedBy;
+}
+export interface WorkflowCreateResult {
+    workflowId: string;
+    status: "active" | "draft";
+    validationErrors: string[];
+}
+export declare function workflowCreate(params: WorkflowCreateParams): Promise<WorkflowCreateResult>;
+export {};
+//# sourceMappingURL=workflow-create.d.ts.map

package/payload/platform/plugins/workflows/mcp/dist/tools/workflow-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-create.d.ts","sourceRoot":"","sources":["../../src/tools/workflow-create.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EAGL,KAAK,SAAS,EACf,MAAM,8CAA8C,CAAC;AAEtD,UAAU,aAAa;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAc,SAAQ,aAAa;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,IAAI,EAAE,KAAK,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC7C,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC9B,6EAA6E;IAC7E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,YAAY,CAAC;AAErD,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,4GAA4G;IAC5G,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC3B,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CAkL/B"}