ue-mcp 0.5.4 → 0.6.1

package/README.md

@@ -94,10 +94,6 @@ Requires `PythonScriptPlugin` (ships with UE 4.26+).
 
 Issues and pull requests welcome. If an AI agent had to fall back to `execute_python` during your session, it will offer to submit structured feedback automatically — this helps us prioritize which native handlers to add next.
 
-### Contributors
-
-- [@robinduckett](https://github.com/robinduckett) — Linux platform support ([#96](https://github.com/db-lyon/ue-mcp/pull/96))
-
 ## License
 
 MIT — see [LICENSE](LICENSE).

package/dist/flow/bridge-task.d.ts

@@ -0,0 +1,18 @@
+import { BaseTask, type TaskResult } from "@db-lyon/flowkit";
+/**
+ * Generic task for bridge-delegation actions.
+ *
+ * Used two ways:
+ *
+ * 1. **YAML-defined tasks** (`class_path: flow.bridge`):
+ *    The `method` option specifies the bridge method to call.
+ *    Remaining options are passed as bridge params.
+ *
+ * 2. **Built-in tasks** via `bridgeTaskClass()` factory:
+ *    The bridge method is baked into the class closure.
+ *    Options are passed through as bridge params.
+ */
+export declare class BridgeTask extends BaseTask {
+    get taskName(): string;
+    execute(): Promise<TaskResult>;
+}

package/dist/flow/bridge-task.js

@@ -0,0 +1,34 @@
+import { BaseTask } from "@db-lyon/flowkit";
+/**
+ * Generic task for bridge-delegation actions.
+ *
+ * Used two ways:
+ *
+ * 1. **YAML-defined tasks** (`class_path: flow.bridge`):
+ *    The `method` option specifies the bridge method to call.
+ *    Remaining options are passed as bridge params.
+ *
+ * 2. **Built-in tasks** via `bridgeTaskClass()` factory:
+ *    The bridge method is baked into the class closure.
+ *    Options are passed through as bridge params.
+ */
+export class BridgeTask extends BaseTask {
+    get taskName() {
+        return `bridge:${this.options.method ?? "unknown"}`;
+    }
+    async execute() {
+        const { method, ...params } = this.options;
+        if (!method || typeof method !== "string") {
+            throw new Error('BridgeTask requires a "method" option');
+        }
+        const ctx = this.ctx;
+        const data = await ctx.bridge.call(method, params);
+        return {
+            success: true,
+            data: typeof data === "object" && data !== null
+                ? data
+                : { result: data },
+        };
+    }
+}
+//# sourceMappingURL=bridge-task.js.map

package/dist/flow/bridge-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge-task.js","sourceRoot":"","sources":["../../src/flow/bridge-task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAmB,MAAM,kBAAkB,CAAC;AAG7D;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,UAAW,SAAQ,QAAQ;IACtC,IAAI,QAAQ;QACV,OAAO,UAAW,IAAI,CAAC,OAAmC,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;IACnF,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,OAAkC,CAAC;QACtE,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAkB,CAAC;QACpC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAgB,EAAE,MAAM,CAAC,CAAC;QAC7D,OAAO;YACL,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;gBAC7C,CAAC,CAAE,IAAgC;gBACnC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE;SACrB,CAAC;IACJ,CAAC;CACF"}

package/dist/flow/context.d.ts

@@ -0,0 +1,7 @@
+import type { TaskContext } from "@db-lyon/flowkit";
+import type { IBridge } from "../bridge.js";
+import type { ProjectContext } from "../project.js";
+export interface FlowContext extends TaskContext {
+    bridge: IBridge;
+    project: ProjectContext;
+}

package/dist/flow/context.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.js.map

package/dist/flow/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/flow/context.ts"],"names":[],"mappings":""}

package/dist/flow/flow-tool.d.ts

@@ -0,0 +1,4 @@
+import type { TaskRegistry } from "@db-lyon/flowkit";
+import type { FlowConfig } from "./schema.js";
+import type { ToolDef } from "../types.js";
+export declare function createFlowTool(registry: TaskRegistry, config: FlowConfig): ToolDef;

package/dist/flow/flow-tool.js

@@ -0,0 +1,87 @@
+import { z } from "zod";
+import { FlowRunner } from "@db-lyon/flowkit";
+export function createFlowTool(registry, config) {
+    const flowNames = Object.keys(config.flows);
+    return {
+        name: "flow",
+        description: `Run or inspect named flows defined in ue-mcp.yml.\n\n` +
+            `Available flows: ${flowNames.length > 0 ? flowNames.join(", ") : "(none — add flows to ue-mcp.yml)"}` +
+            `\n\nActions:\n` +
+            `- run: Execute a flow. Params: flowName, skip?\n` +
+            `- plan: Show execution plan without running. Params: flowName\n` +
+            `- list: List available flows`,
+        schema: {
+            action: z.enum(["run", "plan", "list"]).describe("Action to perform"),
+            flowName: z.string().optional().describe("Flow name from ue-mcp.yml"),
+            skip: z.array(z.string()).optional().describe("Step names or numbers to skip"),
+        },
+        actions: {
+            run: { handler: async (ctx, params) => runFlow(registry, config, ctx, params) },
+            plan: { handler: async (ctx, params) => planFlow(registry, config, ctx, params) },
+            list: { handler: async () => listFlows(config) },
+        },
+        handler: async (ctx, params) => {
+            const action = params.action;
+            if (action === "list")
+                return listFlows(config);
+            if (action === "plan")
+                return planFlow(registry, config, ctx, params);
+            if (action === "run")
+                return runFlow(registry, config, ctx, params);
+            throw new Error(`Unknown flow action: ${action}`);
+        },
+    };
+}
+function listFlows(config) {
+    const flows = Object.entries(config.flows).map(([name, def]) => ({
+        name,
+        description: def.description,
+        stepCount: Object.keys(def.steps).length,
+    }));
+    return { flowCount: flows.length, flows };
+}
+async function planFlow(registry, config, ctx, params) {
+    const flowName = params.flowName;
+    if (!flowName)
+        throw new Error("flowName is required");
+    const runner = makeRunner(registry, config, ctx);
+    return runner.run({ flowName, plan: true });
+}
+async function runFlow(registry, config, ctx, params) {
+    const flowName = params.flowName;
+    if (!flowName)
+        throw new Error("flowName is required");
+    const skip = params.skip ?? [];
+    const runner = makeRunner(registry, config, ctx);
+    const result = await runner.run({ flowName, skip });
+    return formatFlowResult(result);
+}
+function makeRunner(registry, config, ctx) {
+    const flowCtx = {
+        bridge: ctx.bridge,
+        project: ctx.project,
+    };
+    return new FlowRunner({
+        tasks: config.tasks,
+        flows: config.flows,
+        registry,
+        context: flowCtx,
+    });
+}
+function formatFlowResult(result) {
+    return {
+        success: result.success,
+        duration: result.duration,
+        error: result.error?.message,
+        steps: result.steps.map((s) => ({
+            step: s.stepNumber,
+            name: s.name,
+            type: s.type,
+            skipped: s.skipped,
+            success: s.result?.success ?? null,
+            duration: s.duration,
+            error: s.result?.error?.message,
+        })),
+    };
+}
+//# sourceMappingURL=flow-tool.js.map

package/dist/flow/flow-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-tool.js","sourceRoot":"","sources":["../../src/flow/flow-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAM9C,MAAM,UAAU,cAAc,CAC5B,QAAsB,EACtB,MAAkB;IAElB,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE5C,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,WAAW,EACT,uDAAuD;YACvD,oBAAoB,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,kCAAkC,EAAE;YACtG,gBAAgB;YAChB,kDAAkD;YAClD,iEAAiE;YACjE,8BAA8B;QAChC,MAAM,EAAE;YACN,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YACrE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;YACrE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;SAC/E;QACD,OAAO,EAAE;YACP,GAAG,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE;YAC/E,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE;YACjF,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE;SACjD;QACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE;YAC7B,MAAM,MAAM,GAAG,MAAM,CAAC,MAAgB,CAAC;YACvC,IAAI,MAAM,KAAK,MAAM;gBAAE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;YAChD,IAAI,MAAM,KAAK,MAAM;gBAAE,OAAO,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;YACtE,IAAI,MAAM,KAAK,KAAK;gBAAE,OAAO,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,wBAAwB,MAAM,EAAE,CAAC,CAAC;QACpD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,MAAkB;IACnC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/D,IAAI;QACJ,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,MAAM;KACzC,CAAC,CAAC,CAAC;IACJ,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;AAC5C,CAAC;AAED,KAAK,UAAU,QAAQ,CACrB,QAAsB,EACtB,MAAkB,EAClB,GAAgB,EAChB,MAA+B;IAE/B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAkB,CAAC;IAC3C,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAEvD,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IACjD,OAAO,MAAM,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,KAAK,UAAU,OAAO,CACpB,QAAsB,EACtB,MAAkB,EAClB,GAAgB,EAChB,MAA+B;IAE/B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAkB,CAAC;IAC3C,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACvD,MAAM,IAAI,GAAI,MAAM,CAAC,IAA6B,IAAI,EAAE,CAAC;IAEzD,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpD,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,UAAU,CAAC,QAAsB,EAAE,MAAkB,EAAE,GAAgB;IAC9E,MAAM,OAAO,GAAgB;QAC3B,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,OAAO,EAAE,GAAG,CAAC,OAAO;KACrB,CAAC;IAEF,OAAO,IAAI,UAAU,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC,KAAuC;QACrD,KAAK,EAAE,MAAM,CAAC,KAAuC;QACrD,QAAQ;QACR,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAqB;IAC7C,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO;QAC5B,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC9B,IAAI,EAAE,CAAC,CAAC,UAAU;YAClB,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,IAAI,IAAI;YAClC,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO;SAChC,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC"}

package/dist/flow/index.d.ts

@@ -0,0 +1,8 @@
+export type { FlowContext } from "./context.js";
+export { BridgeTask } from "./bridge-task.js";
+export { bridgeTaskClass, handlerTaskClass } from "./task-factory.js";
+export { FlowConfigSchema } from "./schema.js";
+export type { FlowConfig } from "./schema.js";
+export { loadFlowConfig, buildDefaults } from "./loader.js";
+export { buildFlowRegistry } from "./registry.js";
+export { createFlowTool } from "./flow-tool.js";

package/dist/flow/index.js

@@ -0,0 +1,7 @@
+export { BridgeTask } from "./bridge-task.js";
+export { bridgeTaskClass, handlerTaskClass } from "./task-factory.js";
+export { FlowConfigSchema } from "./schema.js";
+export { loadFlowConfig, buildDefaults } from "./loader.js";
+export { buildFlowRegistry } from "./registry.js";
+export { createFlowTool } from "./flow-tool.js";
+//# sourceMappingURL=index.js.map

package/dist/flow/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/flow/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/flow/loader.d.ts

@@ -0,0 +1,13 @@
+import { type LoadedConfig } from "@db-lyon/flowkit";
+import { type FlowConfig } from "./schema.js";
+import type { ToolDef } from "../types.js";
+/**
+ * Build the defaults object from tool definitions.
+ * This is the runtime equivalent of scripts/generate-default-config.ts.
+ */
+export declare function buildDefaults(tools: ToolDef[]): Record<string, unknown>;
+/**
+ * Load ue-mcp.yml from the given directory, layered on top of built-in defaults.
+ * Returns the merged config even if no project ue-mcp.yml exists.
+ */
+export declare function loadFlowConfig(tools: ToolDef[], configDir?: string): LoadedConfig<FlowConfig> | null;

package/dist/flow/loader.js

@@ -0,0 +1,45 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { loadConfig } from "@db-lyon/flowkit";
+import { FlowConfigSchema } from "./schema.js";
+/**
+ * Build the defaults object from tool definitions.
+ * This is the runtime equivalent of scripts/generate-default-config.ts.
+ */
+export function buildDefaults(tools) {
+    const tasks = {};
+    for (const tool of tools) {
+        for (const [actionName, spec] of Object.entries(tool.actions)) {
+            const taskName = `${tool.name}.${actionName}`;
+            const isBridge = !!spec.bridge;
+            const taskDef = {
+                class_path: isBridge ? "ue-mcp.bridge" : taskName,
+                group: tool.name,
+            };
+            if (spec.description)
+                taskDef.description = spec.description;
+            if (isBridge)
+                taskDef.options = { method: spec.bridge };
+            tasks[taskName] = taskDef;
+        }
+    }
+    return { tasks, flows: {} };
+}
+/**
+ * Load ue-mcp.yml from the given directory, layered on top of built-in defaults.
+ * Returns the merged config even if no project ue-mcp.yml exists.
+ */
+export function loadFlowConfig(tools, configDir) {
+    const dir = configDir ?? process.cwd();
+    const configPath = path.join(dir, "ue-mcp.yml");
+    if (!fs.existsSync(configPath))
+        return null;
+    return loadConfig({
+        filename: "ue-mcp.yml",
+        schema: FlowConfigSchema,
+        defaults: buildDefaults(tools),
+        envVar: "UE_MCP_ENV",
+        configDir: dir,
+    });
+}
+//# sourceMappingURL=loader.js.map

package/dist/flow/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../src/flow/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,UAAU,EAAqB,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAmB,MAAM,aAAa,CAAC;AAGhE;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAgB;IAC5C,MAAM,KAAK,GAA4B,EAAE,CAAC;IAE1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9D,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9C,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;YAE/B,MAAM,OAAO,GAA4B;gBACvC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,QAAQ;gBACjD,KAAK,EAAE,IAAI,CAAC,IAAI;aACjB,CAAC;YACF,IAAI,IAAI,CAAC,WAAW;gBAAE,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;YAC7D,IAAI,QAAQ;gBAAE,OAAO,CAAC,OAAO,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;YAExD,KAAK,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAgB,EAChB,SAAkB;IAElB,MAAM,GAAG,GAAG,SAAS,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACvC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAEhD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAE5C,OAAO,UAAU,CAAC;QAChB,QAAQ,EAAE,YAAY;QACtB,MAAM,EAAE,gBAAgB;QACxB,QAAQ,EAAE,aAAa,CAAC,KAAK,CAAC;QAC9B,MAAM,EAAE,YAAY;QACpB,SAAS,EAAE,GAAG;KACf,CAAC,CAAC;AACL,CAAC"}

package/dist/flow/registry.d.ts

@@ -0,0 +1,11 @@
+import { TaskRegistry } from "@db-lyon/flowkit";
+import type { ToolDef } from "../types.js";
+/**
+ * Walk all category tools and register every action as a flowkit task.
+ *
+ * - Bridge actions → factory classes with method + mapParams in closure
+ * - Handler actions → factory classes wrapping the existing handler function
+ *
+ * Also registers `ue-mcp.bridge` as a class_path for YAML-defined bridge tasks.
+ */
+export declare function buildFlowRegistry(tools: ToolDef[]): TaskRegistry;

package/dist/flow/registry.js

@@ -0,0 +1,34 @@
+import { TaskRegistry } from "@db-lyon/flowkit";
+import { BridgeTask } from "./bridge-task.js";
+import { bridgeTaskClass, handlerTaskClass } from "./task-factory.js";
+/**
+ * Walk all category tools and register every action as a flowkit task.
+ *
+ * - Bridge actions → factory classes with method + mapParams in closure
+ * - Handler actions → factory classes wrapping the existing handler function
+ *
+ * Also registers `ue-mcp.bridge` as a class_path for YAML-defined bridge tasks.
+ */
+export function buildFlowRegistry(tools) {
+    const registry = new TaskRegistry();
+    // Register the generic BridgeTask for YAML class_path: ue-mcp.bridge
+    registry.registerClassPath("ue-mcp.bridge", BridgeTask);
+    for (const tool of tools) {
+        for (const [actionName, spec] of Object.entries(tool.actions)) {
+            const taskName = `${tool.name}.${actionName}`;
+            if (spec.handler) {
+                // Wrap the existing handler function — adapt ToolContext to FlowContext
+                const originalHandler = spec.handler;
+                registry.register(taskName, handlerTaskClass(taskName, (ctx, params) => {
+                    const toolCtx = { bridge: ctx.bridge, project: ctx.project };
+                    return originalHandler(toolCtx, params);
+                }));
+            }
+            else if (spec.bridge) {
+                registry.register(taskName, bridgeTaskClass(taskName, spec.bridge, spec.mapParams));
+            }
+        }
+    }
+    return registry;
+}
+//# sourceMappingURL=registry.js.map

package/dist/flow/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/flow/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAIhD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEtE;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAgB;IAChD,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;IAEpC,qEAAqE;IACrE,QAAQ,CAAC,iBAAiB,CAAC,eAAe,EAAE,UAAwC,CAAC,CAAC;IAEtF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9D,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,UAAU,EAAE,CAAC;YAE9C,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,wEAAwE;gBACxE,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC;gBACrC,QAAQ,CAAC,QAAQ,CACf,QAAQ,EACR,gBAAgB,CAAC,QAAQ,EAAE,CAAC,GAAgB,EAAE,MAA+B,EAAE,EAAE;oBAC/E,MAAM,OAAO,GAAgB,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;oBAC1E,OAAO,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAC1C,CAAC,CAAC,CACH,CAAC;YACJ,CAAC;iBAAM,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBACvB,QAAQ,CAAC,QAAQ,CACf,QAAQ,EACR,eAAe,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CACvD,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/flow/schema.d.ts

@@ -0,0 +1,146 @@
+import { z } from "zod";
+export declare const FlowVersionSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+}, "strip", z.ZodTypeAny, {
+    version: 1;
+}, {
+    version: 1;
+}>;
+export declare const FlowProjectSchema: z.ZodOptional<z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    engine: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name?: string | undefined;
+    engine?: string | undefined;
+}, {
+    name?: string | undefined;
+    engine?: string | undefined;
+}>>;
+export declare const FlowConfigSchema: z.ZodObject<{
+    tasks: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        class_path: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        group: z.ZodOptional<z.ZodString>;
+        options: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, "strip", z.ZodTypeAny, {
+        options: Record<string, unknown>;
+        class_path: string;
+        description?: string | undefined;
+        group?: string | undefined;
+    }, {
+        class_path: string;
+        options?: Record<string, unknown> | undefined;
+        description?: string | undefined;
+        group?: string | undefined;
+    }>>>;
+    flows: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        description: z.ZodString;
+        steps: z.ZodRecord<z.ZodString, z.ZodEffects<z.ZodObject<{
+            task: z.ZodOptional<z.ZodString>;
+            flow: z.ZodOptional<z.ZodString>;
+            shell: z.ZodOptional<z.ZodString>;
+            options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            options?: Record<string, unknown> | undefined;
+            task?: string | undefined;
+            flow?: string | undefined;
+            shell?: string | undefined;
+        }, {
+            options?: Record<string, unknown> | undefined;
+            task?: string | undefined;
+            flow?: string | undefined;
+            shell?: string | undefined;
+        }>, {
+            options?: Record<string, unknown> | undefined;
+            task?: string | undefined;
+            flow?: string | undefined;
+            shell?: string | undefined;
+        }, {
+            options?: Record<string, unknown> | undefined;
+            task?: string | undefined;
+            flow?: string | undefined;
+            shell?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        steps: Record<string, {
+            options?: Record<string, unknown> | undefined;
+            task?: string | undefined;
+            flow?: string | undefined;
+            shell?: string | undefined;
+        }>;
+    }, {
+        description: string;
+        steps: Record<string, {
+            options?: Record<string, unknown> | undefined;
+            task?: string | undefined;
+            flow?: string | undefined;
+            shell?: string | undefined;
+        }>;
+    }>>>;
+} & {
+    "ue-mcp": z.ZodOptional<z.ZodObject<{
+        version: z.ZodLiteral<1>;
+    }, "strip", z.ZodTypeAny, {
+        version: 1;
+    }, {
+        version: 1;
+    }>>;
+    project: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        engine: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name?: string | undefined;
+        engine?: string | undefined;
+    }, {
+        name?: string | undefined;
+        engine?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    tasks: Record<string, {
+        options: Record<string, unknown>;
+        class_path: string;
+        description?: string | undefined;
+        group?: string | undefined;
+    }>;
+    flows: Record<string, {
+        description: string;
+        steps: Record<string, {
+            options?: Record<string, unknown> | undefined;
+            task?: string | undefined;
+            flow?: string | undefined;
+            shell?: string | undefined;
+        }>;
+    }>;
+    "ue-mcp"?: {
+        version: 1;
+    } | undefined;
+    project?: {
+        name?: string | undefined;
+        engine?: string | undefined;
+    } | undefined;
+}, {
+    "ue-mcp"?: {
+        version: 1;
+    } | undefined;
+    project?: {
+        name?: string | undefined;
+        engine?: string | undefined;
+    } | undefined;
+    tasks?: Record<string, {
+        class_path: string;
+        options?: Record<string, unknown> | undefined;
+        description?: string | undefined;
+        group?: string | undefined;
+    }> | undefined;
+    flows?: Record<string, {
+        description: string;
+        steps: Record<string, {
+            options?: Record<string, unknown> | undefined;
+            task?: string | undefined;
+            flow?: string | undefined;
+            shell?: string | undefined;
+        }>;
+    }> | undefined;
+}>;
+export type FlowConfig = z.infer<typeof FlowConfigSchema>;

package/dist/flow/schema.js

@@ -0,0 +1,14 @@
+import { z } from "zod";
+import { EngineConfigSchema } from "@db-lyon/flowkit";
+export const FlowVersionSchema = z.object({
+    version: z.literal(1),
+});
+export const FlowProjectSchema = z.object({
+    name: z.string().optional(),
+    engine: z.string().optional(),
+}).optional();
+export const FlowConfigSchema = EngineConfigSchema.extend({
+    "ue-mcp": FlowVersionSchema.optional(),
+    project: FlowProjectSchema,
+});
+//# sourceMappingURL=schema.js.map

package/dist/flow/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/flow/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;CACtB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9B,CAAC,CAAC,QAAQ,EAAE,CAAC;AAEd,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,MAAM,CAAC;IACxD,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IACtC,OAAO,EAAE,iBAAiB;CAC3B,CAAC,CAAC"}

package/dist/flow/task-factory.d.ts

@@ -0,0 +1,12 @@
+import { type TaskConstructor } from "@db-lyon/flowkit";
+import type { FlowContext } from "./context.js";
+/**
+ * Create a TaskConstructor for a bridge-delegation action.
+ * The bridge method (and optional param mapper) are closed over in the class.
+ */
+export declare function bridgeTaskClass(name: string, method: string, mapParams?: (p: Record<string, unknown>) => Record<string, unknown>): TaskConstructor;
+/**
+ * Create a TaskConstructor that wraps an existing async handler function.
+ * Used for the ~19 direct-handler actions (editor control, project ops, etc.).
+ */
+export declare function handlerTaskClass(name: string, fn: (ctx: FlowContext, params: Record<string, unknown>) => Promise<unknown>): TaskConstructor;

package/dist/flow/task-factory.js

@@ -0,0 +1,46 @@
+import { BaseTask } from "@db-lyon/flowkit";
+/**
+ * Create a TaskConstructor for a bridge-delegation action.
+ * The bridge method (and optional param mapper) are closed over in the class.
+ */
+export function bridgeTaskClass(name, method, mapParams) {
+    class FactoryBridgeTask extends BaseTask {
+        get taskName() { return name; }
+        async execute() {
+            const ctx = this.ctx;
+            const params = mapParams
+                ? mapParams(this.options)
+                : this.options;
+            const data = await ctx.bridge.call(method, params);
+            return {
+                success: true,
+                data: typeof data === "object" && data !== null
+                    ? data
+                    : { result: data },
+            };
+        }
+    }
+    Object.defineProperty(FactoryBridgeTask, "name", { value: `BridgeTask_${name}` });
+    return FactoryBridgeTask;
+}
+/**
+ * Create a TaskConstructor that wraps an existing async handler function.
+ * Used for the ~19 direct-handler actions (editor control, project ops, etc.).
+ */
+export function handlerTaskClass(name, fn) {
+    class FactoryHandlerTask extends BaseTask {
+        get taskName() { return name; }
+        async execute() {
+            const data = await fn(this.ctx, this.options);
+            return {
+                success: true,
+                data: typeof data === "object" && data !== null
+                    ? data
+                    : { result: data },
+            };
+        }
+    }
+    Object.defineProperty(FactoryHandlerTask, "name", { value: `HandlerTask_${name}` });
+    return FactoryHandlerTask;
+}
+//# sourceMappingURL=task-factory.js.map

package/dist/flow/task-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-factory.js","sourceRoot":"","sources":["../../src/flow/task-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAA2D,MAAM,kBAAkB,CAAC;AAGrG;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,MAAc,EACd,SAAmE;IAEnE,MAAM,iBAAkB,SAAQ,QAAQ;QACtC,IAAI,QAAQ,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC;QAC/B,KAAK,CAAC,OAAO;YACX,MAAM,GAAG,GAAG,IAAI,CAAC,GAAkB,CAAC;YACpC,MAAM,MAAM,GAAG,SAAS;gBACtB,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,OAAkC,CAAC;gBACpD,CAAC,CAAC,IAAI,CAAC,OAAkC,CAAC;YAC5C,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACnD,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;oBAC7C,CAAC,CAAE,IAAgC;oBACnC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE;aACrB,CAAC;QACJ,CAAC;KACF;IACD,MAAM,CAAC,cAAc,CAAC,iBAAiB,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,cAAc,IAAI,EAAE,EAAE,CAAC,CAAC;IAClF,OAAO,iBAA+C,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,EAA2E;IAE3E,MAAM,kBAAmB,SAAQ,QAAQ;QACvC,IAAI,QAAQ,KAAK,OAAO,IAAI,CAAC,CAAC,CAAC;QAC/B,KAAK,CAAC,OAAO;YACX,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,GAAkB,EAAE,IAAI,CAAC,OAAkC,CAAC,CAAC;YACxF,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;oBAC7C,CAAC,CAAE,IAAgC;oBACnC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE;aACrB,CAAC;QACJ,CAAC;KACF;IACD,MAAM,CAAC,cAAc,CAAC,kBAAkB,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,eAAe,IAAI,EAAE,EAAE,CAAC,CAAC;IACpF,OAAO,kBAAgD,CAAC;AAC1D,CAAC"}