visual-node 0.1.0

package/dist/connect/files.service.js.map

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

package/dist/connect/node-registry-flow.service.d.ts

@@ -0,0 +1,14 @@
+import { type ConnectRouter } from "@connectrpc/connect";
+import type { AppConfig } from "../config.js";
+/**
+ * Registers the `GetNodeRegistry`/`GetFlow`/`SaveFlow` RPCs from `EditorService` on a
+ * `ConnectRouter`, matching the behavior of the existing REST handlers exactly:
+ * - `GetNodeRegistry` mirrors `routes/nodes.routes.ts`'s `GET /api/node-registry`
+ *   (including its `?scope=function-graph` branch).
+ * - `GetFlow`/`SaveFlow` mirror `routes/flow.routes.ts`'s `GET`/`POST /api/flow` — same
+ *   `<projectDir>/flow.json` path, same on-disk JSON storage format (Phase 8 hasn't cut
+ *   storage over to FlatBuffers yet, only the RPC wire format). A `Flow` crossing the RPC
+ *   boundary is carried as the wire's opaque `flatbuffer_flow` bytes field, converted via
+ *   `@visual-node/core`'s `encodeFlow`/`decodeFlow`.
+ */
+export declare function registerNodeRegistryFlowRoutes(router: ConnectRouter, config: AppConfig): ConnectRouter;

package/dist/connect/node-registry-flow.service.js

@@ -0,0 +1,142 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { Code, ConnectError } from "@connectrpc/connect";
+import { FUNCTION_GRAPH_NODE_DEFINITIONS, FUNCTION_GRAPH_ONLY_TYPES, decodeFlow, encodeFlow, listNodeDefinitions, } from "@visual-node/core";
+import { EditorService } from "@visual-node/proto-gen";
+import { isPlausibleFlow } from "../flow-shape.js";
+// NOTE on message construction: handlers below return plain object literals shaped like
+// the proto message's init shape (e.g. `{ found: true, flatbufferFlow: ... }`) rather than
+// calling `@bufbuild/protobuf`'s `create()` themselves. `@bufbuild/protobuf` is only a
+// *peer* dependency of `@connectrpc/connect` (not a direct dependency of
+// `visual-node`'s package.json, which this task is not allowed to touch), so
+// it isn't resolvable from this package's own imports. This is fine: Connect's own
+// `invokeUnaryImplementation` (`@connectrpc/connect/dist/esm/protocol/normalize.js`) always
+// runs every handler's return value through `create(method.output, returnValue)` internally
+// before serializing, using its *own* bundled `@bufbuild/protobuf` — so a plain
+// `MessageInitShape`-compatible object is exactly what a `UnaryImpl` is documented to
+// return, no local `create()` call needed.
+/** Converts a `ConfigField.default` (documented as "a string, number, boolean, or raw JS
+ * source string for 'code' fields") into a `google.protobuf.Value` init shape — a plain
+ * `{ kind: { case, value } }` oneof object, which Connect's internal `create()` call
+ * normalizes into a real `Value` message just like every other nested field here.
+ *
+ * Typed `any` rather than importing `MessageInit<Value>`: `@bufbuild/protobuf` is not a
+ * direct dependency of this package (see the NOTE above), so even a type-only import of it
+ * is unresolvable here. The runtime shape is verified against
+ * `@bufbuild/protobuf`'s `wkt/gen/google/protobuf/struct_pb.d.ts` `Value` oneof directly. */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function toProtoValueInit(value) {
+    if (value === undefined)
+        return undefined;
+    if (value === null)
+        return { kind: { case: "nullValue", value: 0 } };
+    if (typeof value === "string")
+        return { kind: { case: "stringValue", value } };
+    if (typeof value === "number")
+        return { kind: { case: "numberValue", value } };
+    if (typeof value === "boolean")
+        return { kind: { case: "boolValue", value } };
+    // Not expected per ConfigField.default's documented type, but fall back to a string
+    // representation rather than dropping the value silently.
+    return { kind: { case: "stringValue", value: JSON.stringify(value) } };
+}
+/** Mirrors nodes.routes.ts's `{ emit, ...rest }` destructure: strips the non-serializable
+ * `emit`/`resultIdentifier` function fields before the definition crosses the wire. */
+function toProtoPort(port) {
+    return { id: port.id, label: port.label, kind: port.kind ?? "" };
+}
+function toProtoConfigField(field) {
+    return {
+        key: field.key,
+        label: field.label,
+        type: field.type,
+        options: field.options ?? [],
+        defaultValue: toProtoValueInit(field.default),
+        hint: field.hint ?? "",
+    };
+}
+function toProtoNodeDefinition(def) {
+    return {
+        type: def.type,
+        category: def.category,
+        label: def.label,
+        description: def.description,
+        inputs: def.inputs.map(toProtoPort),
+        outputs: def.outputs.map(toProtoPort),
+        configSchema: def.configSchema.map(toProtoConfigField),
+    };
+}
+/**
+ * Registers the `GetNodeRegistry`/`GetFlow`/`SaveFlow` RPCs from `EditorService` on a
+ * `ConnectRouter`, matching the behavior of the existing REST handlers exactly:
+ * - `GetNodeRegistry` mirrors `routes/nodes.routes.ts`'s `GET /api/node-registry`
+ *   (including its `?scope=function-graph` branch).
+ * - `GetFlow`/`SaveFlow` mirror `routes/flow.routes.ts`'s `GET`/`POST /api/flow` — same
+ *   `<projectDir>/flow.json` path, same on-disk JSON storage format (Phase 8 hasn't cut
+ *   storage over to FlatBuffers yet, only the RPC wire format). A `Flow` crossing the RPC
+ *   boundary is carried as the wire's opaque `flatbuffer_flow` bytes field, converted via
+ *   `@visual-node/core`'s `encodeFlow`/`decodeFlow`.
+ */
+export function registerNodeRegistryFlowRoutes(router, config) {
+    const flowPath = path.join(config.projectDir, "flow.json");
+    router.rpc(EditorService.method.getNodeRegistry, async (req) => {
+        // Plugin nodes are always shaped as either pure-value (no exec pins) or a single
+        // exec-in("in")/exec-out("out") pair (validatePluginNodeSpec enforces this — see
+        // Phase 9 notes in CLAUDE.md) — the same shape as the builtin operators/consoleLog/
+        // customCode types already offered inside a function body. So unlike
+        // FUNCTION_GRAPH_NODE_DEFINITIONS (a static list of builtins), plugins are appended
+        // live from the mutable registry rather than hardcoded, since they're registered at
+        // runtime via InstallPlugin and would otherwise never appear here.
+        const definitions = req.scope === "function-graph"
+            ? [
+                ...FUNCTION_GRAPH_NODE_DEFINITIONS,
+                ...listNodeDefinitions().filter((def) => def.type.startsWith("plugin.")),
+            ]
+            : listNodeDefinitions().filter((def) => !FUNCTION_GRAPH_ONLY_TYPES.has(def.type));
+        return { definitions: definitions.map(toProtoNodeDefinition) };
+    });
+    router.rpc(EditorService.method.getFlow, async () => {
+        let raw;
+        try {
+            raw = await readFile(flowPath, "utf8");
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                return { found: false };
+            }
+            throw err;
+        }
+        let flow;
+        try {
+            flow = JSON.parse(raw);
+        }
+        catch (err) {
+            throw new ConnectError(`flow.json is not valid JSON: ${err.message}`, Code.Internal);
+        }
+        let flatbufferFlow;
+        try {
+            flatbufferFlow = encodeFlow(flow);
+        }
+        catch (err) {
+            throw new ConnectError(`flow.json could not be encoded: ${err.message}`, Code.Internal);
+        }
+        return { found: true, flatbufferFlow };
+    });
+    router.rpc(EditorService.method.saveFlow, async (req) => {
+        let flow;
+        try {
+            flow = decodeFlow(req.flatbufferFlow);
+        }
+        catch (err) {
+            throw new ConnectError(`flatbuffer_flow could not be decoded: ${err.message}`, Code.InvalidArgument);
+        }
+        if (!isPlausibleFlow(flow)) {
+            throw new ConnectError("flatbuffer_flow must decode to a Flow with `nodes`, `edges`, and `meta`", Code.InvalidArgument);
+        }
+        await mkdir(config.projectDir, { recursive: true });
+        await writeFile(flowPath, JSON.stringify(flow, null, 2), "utf8");
+        return { ok: true };
+    });
+    return router;
+}
+//# sourceMappingURL=node-registry-flow.service.js.map

package/dist/connect/node-registry-flow.service.js.map

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

package/dist/connect/plugins.service.d.ts

@@ -0,0 +1,24 @@
+import type { ConnectRouter } from "@connectrpc/connect";
+import type { AppConfig } from "../config.js";
+/**
+ * Registers the `InstallPlugin` RPC (Phase 9 Part B — JSON-based plugin node system, see
+ * packages/core/src/plugins/plugin-schema.ts and plugin-node.ts). Uploading a plugin is
+ * equivalent in trust level to writing a Custom Code node: the spec's `codegen`
+ * imports/setup/body strings are spliced verbatim into generated server code with no
+ * sandboxing — appropriate for a local single-developer tool.
+ *
+ * Always returns `{ ok: false, errors: [...] }` rather than throwing a `ConnectError` on any
+ * expected failure (malformed JSON, spec validation errors, type collision, unsafe path) —
+ * same "expected failure modeled as response data" pattern as
+ * ValidateFlowResponse/GenerateCodeResponse in connect/validate-generate.service.ts, rather
+ * than the `ConnectError`-throwing pattern connect/files.service.ts uses for its CRUD RPCs.
+ *
+ * On success, the validated spec is written to
+ * `<projectDir>/.flowserver/plugins/<sanitized-type>.node.json` (the leading dot directory
+ * means file-tree.ts's existing dotfile filter already hides it from the file explorer with
+ * zero changes there) and immediately `registerNode()`-ed — live for the very next
+ * `GetNodeRegistry` call, no restart needed. Re-uploading a `type` that's already registered
+ * (builtin or a previously installed plugin) is rejected outright: `registerNode()` has no
+ * update path in this codebase, so iterating on a plugin requires renaming its `type`.
+ */
+export declare function registerPluginsRoutes(router: ConnectRouter, config: AppConfig): ConnectRouter;

package/dist/connect/plugins.service.js

@@ -0,0 +1,73 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { EditorService } from "@visual-node/proto-gen";
+import { createPluginNodeDefinition, getNodeDefinition, registerNode, validatePluginNodeSpec, } from "@visual-node/core";
+import { resolveSafePath } from "../path-safety.js";
+/**
+ * Registers the `InstallPlugin` RPC (Phase 9 Part B — JSON-based plugin node system, see
+ * packages/core/src/plugins/plugin-schema.ts and plugin-node.ts). Uploading a plugin is
+ * equivalent in trust level to writing a Custom Code node: the spec's `codegen`
+ * imports/setup/body strings are spliced verbatim into generated server code with no
+ * sandboxing — appropriate for a local single-developer tool.
+ *
+ * Always returns `{ ok: false, errors: [...] }` rather than throwing a `ConnectError` on any
+ * expected failure (malformed JSON, spec validation errors, type collision, unsafe path) —
+ * same "expected failure modeled as response data" pattern as
+ * ValidateFlowResponse/GenerateCodeResponse in connect/validate-generate.service.ts, rather
+ * than the `ConnectError`-throwing pattern connect/files.service.ts uses for its CRUD RPCs.
+ *
+ * On success, the validated spec is written to
+ * `<projectDir>/.flowserver/plugins/<sanitized-type>.node.json` (the leading dot directory
+ * means file-tree.ts's existing dotfile filter already hides it from the file explorer with
+ * zero changes there) and immediately `registerNode()`-ed — live for the very next
+ * `GetNodeRegistry` call, no restart needed. Re-uploading a `type` that's already registered
+ * (builtin or a previously installed plugin) is rejected outright: `registerNode()` has no
+ * update path in this codebase, so iterating on a plugin requires renaming its `type`.
+ */
+export function registerPluginsRoutes(router, config) {
+    router.rpc(EditorService.method.installPlugin, async (req) => {
+        let raw;
+        try {
+            raw = JSON.parse(Buffer.from(req.pluginJson).toString("utf8"));
+        }
+        catch (err) {
+            return {
+                ok: false,
+                type: "",
+                relativePath: "",
+                errors: [`\`plugin_json\` is not valid JSON: ${err instanceof Error ? err.message : String(err)}`],
+            };
+        }
+        const validationErrors = validatePluginNodeSpec(raw);
+        if (validationErrors.length > 0) {
+            return { ok: false, type: "", relativePath: "", errors: validationErrors };
+        }
+        // Safe: validatePluginNodeSpec(raw) returned no errors above.
+        const spec = raw;
+        if (getNodeDefinition(spec.type)) {
+            return {
+                ok: false,
+                type: "",
+                relativePath: "",
+                errors: [`Node type "${spec.type}" is already registered`],
+            };
+        }
+        const filename = `${spec.type.replace(/[^A-Za-z0-9_.-]/g, "_")}.node.json`;
+        const relativePath = `.flowserver/plugins/${filename}`;
+        const target = resolveSafePath(config.projectDir, relativePath);
+        if (!target) {
+            return {
+                ok: false,
+                type: "",
+                relativePath: "",
+                errors: [`Could not resolve a safe on-disk path for plugin type "${spec.type}"`],
+            };
+        }
+        await mkdir(path.dirname(target), { recursive: true });
+        await writeFile(target, JSON.stringify(spec, null, 2), "utf8");
+        registerNode(createPluginNodeDefinition(spec));
+        return { ok: true, type: spec.type, relativePath, errors: [] };
+    });
+    return router;
+}
+//# sourceMappingURL=plugins.service.js.map

package/dist/connect/plugins.service.js.map

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

package/dist/connect/run.service.d.ts

@@ -0,0 +1,3 @@
+import type { ConnectRouter } from "@connectrpc/connect";
+import type { AppConfig } from "../config.js";
+export declare function registerRunRoutes(router: ConnectRouter, config: AppConfig): ConnectRouter;

package/dist/connect/run.service.js

@@ -0,0 +1,159 @@
+import path from "node:path";
+import { EditorService } from "@visual-node/proto-gen";
+import { collectProjectDependencies, writeGeneratedFile, } from "@visual-node/core";
+import { compileProjectFromDisk, ensureCommonJsPackageJson, findEntryFile, nodeModulesInstalled, } from "../codegen-helpers.js";
+import { serverRunner } from "../runner.js";
+/**
+ * Connect RPC mirror of packages/editor-server/src/routes/run.routes.ts's four
+ * `/api/run/*` endpoints, reusing the exact same helpers (`compileProjectFromDisk`,
+ * `findEntryFile`, `ensureCommonJsPackageJson`, `nodeModulesInstalled`) and the same
+ * `serverRunner` singleton — this is a transport-only rewrite, not a behavior change.
+ *
+ * Deliberately no explicit `MessageInitShape`/proto type imports here: every RPC
+ * implementation below is passed to `router.rpc(EditorService.method.x, handler)`
+ * individually (NOT one `router.service(EditorService, {...})` call — see note below),
+ * so TypeScript contextually types each method's parameters and return value from
+ * `EditorService`'s own descriptor. That sidesteps importing anything from
+ * "@bufbuild/protobuf" directly, which this package cannot resolve on its own (it's only
+ * a transitive dependency here, reachable through `@visual-node/proto-gen`'s and
+ * `@connectrpc/connect`'s own node_modules, not this package's) — `@visual-node/proto-gen`'s
+ * generated `.d.ts` resolves it fine from its own directory, but a direct
+ * `import ... from "@bufbuild/protobuf"` written in this file would not resolve under
+ * pnpm's strict per-package node_modules.
+ *
+ * NOTE on `router.rpc()` vs `router.service()`: `router.service(EditorService, partial)`
+ * fills every method of `EditorService` NOT present in `partial` with an "unimplemented"
+ * stub handler and registers all of them (real + stubs) on the router. Since several other
+ * files in `src/connect/` also register a subset of `EditorService`'s methods on the same
+ * shared router, calling `.service()` here too would push "unimplemented" stubs for every
+ * RPC this file doesn't own — and `connect-express`'s middleware keys its route table by
+ * path in a plain `Map`, so whichever registration call runs last for a given path wins,
+ * silently clobbering another file's real implementation. `router.rpc()` registers exactly
+ * one method per call with no such fill-in behavior, which is what safely composes multiple
+ * per-group registration functions on one router.
+ */
+/** Mirrors packages/core's ValidationError/ProjectFileError shapes into the proto ValidationError init shape (proto3 strings default to "", not undefined, for absent optional fields). */
+function toProtoValidationError(err) {
+    return {
+        nodeId: err.nodeId ?? "",
+        blueprintNodeId: err.blueprintNodeId ?? "",
+        message: err.message,
+        relativePath: "relativePath" in err ? err.relativePath : "",
+    };
+}
+export function registerRunRoutes(router, config) {
+    /**
+     * Mirrors POST /api/run/start. The REST route's three failure shapes collapse into
+     * StartRunResponse's `result` oneof: 422 (invalid project) -> `validationFailure`
+     * (structured errors), 400 (no/multiple entry file) and 409 (deps not installed) ->
+     * the generic `error` string variant, success -> `started`.
+     */
+    async function startRun() {
+        const { sourceFiles, result } = await compileProjectFromDisk(config.projectDir);
+        if (!result.valid) {
+            return { result: { case: "validationFailure", value: { errors: result.errors.map(toProtoValidationError) } } };
+        }
+        const entry = findEntryFile(sourceFiles);
+        if ("error" in entry) {
+            return { result: { case: "error", value: entry.error } };
+        }
+        const entryIndex = sourceFiles.indexOf(entry);
+        const entryOutputPath = result.files[entryIndex].relativePath;
+        for (const file of result.files) {
+            await writeGeneratedFile(path.join(config.projectDir, file.relativePath), file.code);
+        }
+        const { dependencies } = collectProjectDependencies(sourceFiles);
+        await ensureCommonJsPackageJson(config.projectDir, path.basename(config.projectDir) || "flowserver-app", {
+            dependencies,
+        });
+        const { installed, missing } = await nodeModulesInstalled(config.projectDir);
+        if (!installed) {
+            return {
+                result: {
+                    case: "error",
+                    value: `Dependencies not installed (missing: ${missing.join(", ")}). Run "npm install" in ${config.projectDir}, then try again.`,
+                },
+            };
+        }
+        const serverPath = path.join(config.projectDir, entryOutputPath);
+        await serverRunner.start(config.projectDir, serverPath);
+        return { result: { case: "started", value: { running: true } } };
+    }
+    /** Mirrors POST /api/run/stop. */
+    async function stopRun() {
+        await serverRunner.stop();
+        return { running: false };
+    }
+    /** Mirrors GET /api/run/status. */
+    async function getRunStatus() {
+        return { running: serverRunner.running };
+    }
+    /**
+     * Mirrors GET /api/run/logs (SSE): replays up to 500 buffered lines, then streams
+     * live "log"/"exit" events off `serverRunner`'s EventEmitter as they happen, forever
+     * (mirroring the SSE route, which never closes the connection itself — only the
+     * client disconnecting ends it).
+     *
+     * Cancellation: a Connect server-streaming handler's second argument is a
+     * `HandlerContext` whose `signal: AbortSignal` fires when the client disconnects or
+     * the call otherwise ends — this is the Connect-idiomatic replacement for the SSE
+     * route's `req.on("close", ...)`. We listen for `context.signal`'s "abort" event to
+     * unblock the generator's wait-for-next-event promise, and unregister the
+     * `serverRunner` "log"/"exit" listeners in a `finally` block so cleanup also runs
+     * when the consumer stops pulling and the generator is `.return()`-ed instead of
+     * aborted (the two ways this loop can end).
+     */
+    async function* runLogs(_req, context) {
+        for (const line of serverRunner.getBufferedLogs()) {
+            yield { event: { case: "log", value: line } };
+        }
+        const queue = [];
+        let wake = null;
+        let done = false;
+        const push = (item) => {
+            queue.push(item);
+            if (wake) {
+                const resolve = wake;
+                wake = null;
+                resolve();
+            }
+        };
+        const onLog = (line) => push({ event: { case: "log", value: line } });
+        const onExit = (code) => push({ event: { case: "exit", value: { code: code ?? undefined } } });
+        const onAbort = () => {
+            done = true;
+            if (wake) {
+                const resolve = wake;
+                wake = null;
+                resolve();
+            }
+        };
+        serverRunner.on("log", onLog);
+        serverRunner.on("exit", onExit);
+        context.signal.addEventListener("abort", onAbort);
+        try {
+            while (!done) {
+                if (queue.length > 0) {
+                    yield queue.shift();
+                    continue;
+                }
+                if (context.signal.aborted)
+                    break;
+                await new Promise((resolve) => {
+                    wake = resolve;
+                });
+            }
+        }
+        finally {
+            serverRunner.off("log", onLog);
+            serverRunner.off("exit", onExit);
+            context.signal.removeEventListener("abort", onAbort);
+        }
+    }
+    router.rpc(EditorService.method.startRun, startRun);
+    router.rpc(EditorService.method.stopRun, stopRun);
+    router.rpc(EditorService.method.getRunStatus, getRunStatus);
+    router.rpc(EditorService.method.runLogs, runLogs);
+    return router;
+}
+//# sourceMappingURL=run.service.js.map

package/dist/connect/run.service.js.map

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

package/dist/connect/validate-generate.service.d.ts

@@ -0,0 +1,19 @@
+import { type ConnectRouter } from "@connectrpc/connect";
+import type { AppConfig } from "../config.js";
+/**
+ * Connect RPC implementations for ValidateFlow, GenerateCode, and WriteGeneratedCode —
+ * the Connect-transport equivalents of packages/editor-server/src/routes/validate.routes.ts
+ * (POST /api/validate) and packages/editor-server/src/routes/generate.routes.ts (POST
+ * /api/generate, POST /api/generate/write). Business logic is not duplicated: this file
+ * calls the exact same `validateFlow`/`compile`/`writeGeneratedFile`/
+ * `ensureCommonJsPackageJson` helpers the REST routes call, only the transport
+ * (Connect unary RPC instead of an Express JSON body) and the `Flow` wire format
+ * (FlatBuffers-encoded `bytes flatbuffer_flow` instead of a JSON `req.body.flow`) differ.
+ *
+ * Registered as individual `router.rpc(...)` calls rather than one `router.service(...)`
+ * call, since this only implements 3 of EditorService's ~21 methods — `router.service()`
+ * would register "unimplemented" stubs for every method this file doesn't own, clobbering
+ * whatever another service-group file registers for those methods when both are wired into
+ * the same router during final app.ts integration.
+ */
+export declare function registerValidateGenerateRoutes(router: ConnectRouter, config: AppConfig): ConnectRouter;

package/dist/connect/validate-generate.service.js

@@ -0,0 +1,102 @@
+import path from "node:path";
+import { ConnectError, Code } from "@connectrpc/connect";
+import { collectFlowDependencies, decodeFlow, validateFlow as validateFlowCore, writeGeneratedFile, } from "@visual-node/core";
+import { EditorService, } from "@visual-node/proto-gen";
+import { compile, ensureCommonJsPackageJson } from "../codegen-helpers.js";
+/**
+ * Connect RPC implementations for ValidateFlow, GenerateCode, and WriteGeneratedCode —
+ * the Connect-transport equivalents of packages/editor-server/src/routes/validate.routes.ts
+ * (POST /api/validate) and packages/editor-server/src/routes/generate.routes.ts (POST
+ * /api/generate, POST /api/generate/write). Business logic is not duplicated: this file
+ * calls the exact same `validateFlow`/`compile`/`writeGeneratedFile`/
+ * `ensureCommonJsPackageJson` helpers the REST routes call, only the transport
+ * (Connect unary RPC instead of an Express JSON body) and the `Flow` wire format
+ * (FlatBuffers-encoded `bytes flatbuffer_flow` instead of a JSON `req.body.flow`) differ.
+ *
+ * Registered as individual `router.rpc(...)` calls rather than one `router.service(...)`
+ * call, since this only implements 3 of EditorService's ~21 methods — `router.service()`
+ * would register "unimplemented" stubs for every method this file doesn't own, clobbering
+ * whatever another service-group file registers for those methods when both are wired into
+ * the same router during final app.ts integration.
+ */
+export function registerValidateGenerateRoutes(router, config) {
+    router.rpc(EditorService.method.validateFlow, (req) => validateFlowRpc(req));
+    router.rpc(EditorService.method.generateCode, (req) => generateCodeRpc(req));
+    router.rpc(EditorService.method.writeGeneratedCode, (req) => writeGeneratedCodeRpc(req, config));
+    return router;
+}
+/**
+ * Decodes the request's opaque FlatBuffers-encoded `Flow`. A malformed/corrupt byte payload
+ * is a client-supplied-garbage problem, not an expected "flow is invalid" outcome the UI
+ * displays inline — so it's surfaced as a `ConnectError` (InvalidArgument), not folded into
+ * the `valid`/`errors` response fields the way `validateFlow()`'s structural errors are.
+ */
+function decodeFlowOrThrow(bytes) {
+    try {
+        return decodeFlow(bytes);
+    }
+    catch (err) {
+        throw new ConnectError(`Request's flatbuffer_flow could not be decoded: ${err instanceof Error ? err.message : String(err)}`, Code.InvalidArgument);
+    }
+}
+function toProtoValidationError(e) {
+    return {
+        $typeName: "flowserver.v1.ValidationError",
+        nodeId: e.nodeId ?? "",
+        blueprintNodeId: e.blueprintNodeId ?? "",
+        message: e.message,
+        relativePath: "",
+    };
+}
+async function validateFlowRpc(req) {
+    const flow = decodeFlowOrThrow(req.flatbufferFlow);
+    const result = validateFlowCore(flow);
+    return {
+        $typeName: "flowserver.v1.ValidateFlowResponse",
+        valid: result.valid,
+        errors: result.errors.map(toProtoValidationError),
+    };
+}
+async function generateCodeRpc(req) {
+    const flow = decodeFlowOrThrow(req.flatbufferFlow);
+    const result = await compile(flow);
+    if (!result.valid) {
+        return {
+            $typeName: "flowserver.v1.GenerateCodeResponse",
+            valid: false,
+            code: "",
+            errors: result.errors.map(toProtoValidationError),
+        };
+    }
+    return {
+        $typeName: "flowserver.v1.GenerateCodeResponse",
+        valid: true,
+        code: result.code,
+        errors: [],
+    };
+}
+async function writeGeneratedCodeRpc(req, config) {
+    const flow = decodeFlowOrThrow(req.flatbufferFlow);
+    const result = await compile(flow);
+    if (!result.valid) {
+        return {
+            $typeName: "flowserver.v1.WriteGeneratedCodeResponse",
+            valid: false,
+            written: false,
+            path: "",
+            errors: result.errors.map(toProtoValidationError),
+        };
+    }
+    const serverPath = path.join(config.projectDir, "server.js");
+    await writeGeneratedFile(serverPath, result.code);
+    const { dependencies } = collectFlowDependencies(flow);
+    await ensureCommonJsPackageJson(config.projectDir, flow.meta?.name ?? "flowserver-app", { dependencies });
+    return {
+        $typeName: "flowserver.v1.WriteGeneratedCodeResponse",
+        valid: true,
+        written: true,
+        path: serverPath,
+        errors: [],
+    };
+}
+//# sourceMappingURL=validate-generate.service.js.map

package/dist/connect/validate-generate.service.js.map

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

package/dist/file-tree.d.ts

@@ -0,0 +1,23 @@
+export interface FileTreeFileNode {
+    type: "file";
+    name: string;
+    relativePath: string;
+}
+export interface FileTreeFolderNode {
+    type: "folder";
+    name: string;
+    relativePath: string;
+    children: FileTreeNode[];
+}
+export type FileTreeNode = FileTreeFileNode | FileTreeFolderNode;
+/**
+ * Lists the whole project directory as a tree, excluding node_modules/.git/dotfiles.
+ * Shows *all* remaining files (not just `.blueprint`) so the tree reflects the real
+ * directory — the UI only treats `.blueprint` files as openable. Folders sort before
+ * files, alphabetical within each group.
+ */
+export declare function listTree(projectDir: string): Promise<FileTreeNode[]>;
+/** Flat list of every ".blueprint" file's relative path, for /api/compile. */
+export declare function listBlueprintFiles(projectDir: string): Promise<{
+    relativePath: string;
+}[]>;