@nodetool-ai/websocket 0.8.2 → 0.8.4-a24.1

package/dist/trpc/routers/workflows.d.ts

@@ -11,6 +11,7 @@
  *   - recipes (shipped chains of examples)
  *   - public (list + get) — publicProcedure (no auth required)
  *   - versions (list, create, restore, delete)
+ *   - exportScript (workflow → sandbox or Node.js script)
  *
  * Auth note:
  *   - `public.*` endpoints use publicProcedure — no auth required, matches
@@ -66,6 +67,13 @@ export declare const workflowsRouter: import("@trpc/server").TRPCBuiltRouter<{
                         ui_properties?: Record<string, string> | null | undefined;
                         edge_type?: string | undefined;
                     }[];
+                    links?: {
+                        id: string;
+                        source: string;
+                        target: string;
+                        label?: string | null | undefined;
+                        kind?: string | null | undefined;
+                    }[] | undefined;
                 } | null | undefined;
                 input_schema: unknown;
                 output_schema: unknown;
@@ -76,6 +84,10 @@ export declare const workflowsRouter: import("@trpc/server").TRPCBuiltRouter<{
                 workspace_id: string | null;
                 required_providers: unknown;
                 required_models: unknown;
+                needs?: {
+                    modelKinds: string[];
+                    requiredSettings: string[];
+                } | null | undefined;
                 html_app: string | null;
                 app_doc?: Record<string, unknown> | null | undefined;
                 etag: string | null;
@@ -121,6 +133,13 @@ export declare const workflowsRouter: import("@trpc/server").TRPCBuiltRouter<{
                     ui_properties?: Record<string, string> | null | undefined;
                     edge_type?: string | undefined;
                 }[];
+                links?: {
+                    id: string;
+                    source: string;
+                    target: string;
+                    label?: string | null | undefined;
+                    kind?: string | null | undefined;
+                }[] | undefined;
             } | null | undefined;
             input_schema: unknown;
             output_schema: unknown;
@@ -131,6 +150,10 @@ export declare const workflowsRouter: import("@trpc/server").TRPCBuiltRouter<{
             workspace_id: string | null;
             required_providers: unknown;
             required_models: unknown;
+            needs?: {
+                modelKinds: string[];
+                requiredSettings: string[];
+            } | null | undefined;
             html_app: string | null;
             app_doc?: Record<string, unknown> | null | undefined;
             etag: string | null;
@@ -169,6 +192,13 @@ export declare const workflowsRouter: import("@trpc/server").TRPCBuiltRouter<{
                     ui_properties?: Record<string, string> | null | undefined;
                     edge_type?: string | undefined;
                 }[];
+                links?: {
+                    id: string;
+                    source: string;
+                    target: string;
+                    label?: string | null | undefined;
+                    kind?: string | null | undefined;
+                }[] | undefined;
             } | null | undefined;
             settings?: Record<string, unknown> | null | undefined;
             run_mode?: string | null | undefined;
@@ -212,6 +242,13 @@ export declare const workflowsRouter: import("@trpc/server").TRPCBuiltRouter<{
                     ui_properties?: Record<string, string> | null | undefined;
                     edge_type?: string | undefined;
                 }[];
+                links?: {
+                    id: string;
+                    source: string;
+                    target: string;
+                    label?: string | null | undefined;
+                    kind?: string | null | undefined;
+                }[] | undefined;
             } | null | undefined;
             input_schema: unknown;
             output_schema: unknown;
@@ -222,6 +259,10 @@ export declare const workflowsRouter: import("@trpc/server").TRPCBuiltRouter<{
             workspace_id: string | null;
             required_providers: unknown;
             required_models: unknown;
+            needs?: {
+                modelKinds: string[];
+                requiredSettings: string[];
+            } | null | undefined;
             html_app: string | null;
             app_doc?: Record<string, unknown> | null | undefined;
             etag: string | null;
@@ -261,6 +302,13 @@ export declare const workflowsRouter: import("@trpc/server").TRPCBuiltRouter<{
                     ui_properties?: Record<string, string> | null | undefined;
                     edge_type?: string | undefined;
                 }[];
+                links?: {
+                    id: string;
+                    source: string;
+                    target: string;
+                    label?: string | null | undefined;
+                    kind?: string | null | undefined;
+                }[] | undefined;
             } | null | undefined;
             settings?: Record<string, unknown> | null | undefined;
             run_mode?: string | null | undefined;
@@ -303,6 +351,13 @@ export declare const workflowsRouter: import("@trpc/server").TRPCBuiltRouter<{
                     ui_properties?: Record<string, string> | null | undefined;
                     edge_type?: string | undefined;
                 }[];
+                links?: {
+                    id: string;
+                    source: string;
+                    target: string;
+                    label?: string | null | undefined;
+                    kind?: string | null | undefined;
+                }[] | undefined;
             } | null | undefined;
             input_schema: unknown;
             output_schema: unknown;
@@ -313,6 +368,10 @@ export declare const workflowsRouter: import("@trpc/server").TRPCBuiltRouter<{
             workspace_id: string | null;
             required_providers: unknown;
             required_models: unknown;
+            needs?: {
+                modelKinds: string[];
+                requiredSettings: string[];
+            } | null | undefined;
             html_app: string | null;
             app_doc?: Record<string, unknown> | null | undefined;
             etag: string | null;
@@ -352,6 +411,13 @@ export declare const workflowsRouter: import("@trpc/server").TRPCBuiltRouter<{
                     ui_properties?: Record<string, string> | null | undefined;
                     edge_type?: string | undefined;
                 }[];
+                links?: {
+                    id: string;
+                    source: string;
+                    target: string;
+                    label?: string | null | undefined;
+                    kind?: string | null | undefined;
+                }[] | undefined;
             };
             name?: string | undefined;
             description?: string | undefined;
@@ -373,6 +439,7 @@ export declare const workflowsRouter: import("@trpc/server").TRPCBuiltRouter<{
             message: string;
             skipped: boolean;
             updated_at: string | null;
+            etag?: string | null | undefined;
         };
         meta: object;
     }>;
@@ -405,6 +472,10 @@ export declare const workflowsRouter: import("@trpc/server").TRPCBuiltRouter<{
                 workflows: string[];
                 operationCount: number;
                 thumbnailUrl: string | null;
+                needs?: {
+                    modelKinds: string[];
+                    requiredSettings: string[];
+                } | undefined;
                 role: string;
             }[];
             steps: {
@@ -475,6 +546,13 @@ export declare const workflowsRouter: import("@trpc/server").TRPCBuiltRouter<{
                             ui_properties?: Record<string, string> | null | undefined;
                             edge_type?: string | undefined;
                         }[];
+                        links?: {
+                            id: string;
+                            source: string;
+                            target: string;
+                            label?: string | null | undefined;
+                            kind?: string | null | undefined;
+                        }[] | undefined;
                     } | null | undefined;
                     input_schema: unknown;
                     output_schema: unknown;
@@ -485,6 +563,10 @@ export declare const workflowsRouter: import("@trpc/server").TRPCBuiltRouter<{
                     workspace_id: string | null;
                     required_providers: unknown;
                     required_models: unknown;
+                    needs?: {
+                        modelKinds: string[];
+                        requiredSettings: string[];
+                    } | null | undefined;
                     html_app: string | null;
                     app_doc?: Record<string, unknown> | null | undefined;
                     etag: string | null;
@@ -530,6 +612,13 @@ export declare const workflowsRouter: import("@trpc/server").TRPCBuiltRouter<{
                         ui_properties?: Record<string, string> | null | undefined;
                         edge_type?: string | undefined;
                     }[];
+                    links?: {
+                        id: string;
+                        source: string;
+                        target: string;
+                        label?: string | null | undefined;
+                        kind?: string | null | undefined;
+                    }[] | undefined;
                 } | null | undefined;
                 input_schema: unknown;
                 output_schema: unknown;
@@ -540,6 +629,10 @@ export declare const workflowsRouter: import("@trpc/server").TRPCBuiltRouter<{
                 workspace_id: string | null;
                 required_providers: unknown;
                 required_models: unknown;
+                needs?: {
+                    modelKinds: string[];
+                    requiredSettings: string[];
+                } | null | undefined;
                 html_app: string | null;
                 app_doc?: Record<string, unknown> | null | undefined;
                 etag: string | null;
@@ -561,6 +654,59 @@ export declare const workflowsRouter: import("@trpc/server").TRPCBuiltRouter<{
         };
         meta: object;
     }>;
+    exportScript: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            id: string;
+            target: "node" | "sandbox";
+            graph?: {
+                nodes: {
+                    [x: string]: unknown;
+                    id: string;
+                    type: string;
+                    parent_id?: string | null | undefined;
+                    data?: unknown;
+                    ui_properties?: unknown;
+                    dynamic_properties?: Record<string, unknown> | undefined;
+                    dynamic_outputs?: Record<string, unknown> | undefined;
+                }[];
+                edges: {
+                    [x: string]: unknown;
+                    id?: string | null | undefined;
+                    source: string;
+                    sourceHandle: string;
+                    target: string;
+                    targetHandle: string;
+                    ui_properties?: Record<string, string> | null | undefined;
+                    edge_type?: string | undefined;
+                }[];
+                links?: {
+                    id: string;
+                    source: string;
+                    target: string;
+                    label?: string | null | undefined;
+                    kind?: string | null | undefined;
+                }[] | undefined;
+            } | undefined;
+        };
+        output: {
+            code: string;
+            filename: string;
+            inputs: {
+                name: string;
+                type: string;
+            }[];
+            outputs: {
+                name: string;
+                type: string;
+            }[];
+            unsupported: {
+                node_id: string;
+                node_type: string;
+                message: string;
+            }[];
+        };
+        meta: object;
+    }>;
     versions: import("@trpc/server").TRPCBuiltRouter<{
         ctx: import("../context.js").Context;
         meta: object;
@@ -646,6 +792,13 @@ export declare const workflowsRouter: import("@trpc/server").TRPCBuiltRouter<{
                         ui_properties?: Record<string, string> | null | undefined;
                         edge_type?: string | undefined;
                     }[];
+                    links?: {
+                        id: string;
+                        source: string;
+                        target: string;
+                        label?: string | null | undefined;
+                        kind?: string | null | undefined;
+                    }[] | undefined;
                 } | null | undefined;
                 input_schema: unknown;
                 output_schema: unknown;
@@ -656,6 +809,10 @@ export declare const workflowsRouter: import("@trpc/server").TRPCBuiltRouter<{
                 workspace_id: string | null;
                 required_providers: unknown;
                 required_models: unknown;
+                needs?: {
+                    modelKinds: string[];
+                    requiredSettings: string[];
+                } | null | undefined;
                 html_app: string | null;
                 app_doc?: Record<string, unknown> | null | undefined;
                 etag: string | null;
@@ -790,6 +947,13 @@ export declare const workflowsRouter: import("@trpc/server").TRPCBuiltRouter<{
                             ui_properties?: Record<string, string> | null | undefined;
                             edge_type?: string | undefined;
                         }[];
+                        links?: {
+                            id: string;
+                            source: string;
+                            target: string;
+                            label?: string | null | undefined;
+                            kind?: string | null | undefined;
+                        }[] | undefined;
                     } | null | undefined;
                     input_schema: unknown;
                     output_schema: unknown;
@@ -800,6 +964,10 @@ export declare const workflowsRouter: import("@trpc/server").TRPCBuiltRouter<{
                     workspace_id: string | null;
                     required_providers: unknown;
                     required_models: unknown;
+                    needs?: {
+                        modelKinds: string[];
+                        requiredSettings: string[];
+                    } | null | undefined;
                     html_app: string | null;
                     app_doc?: Record<string, unknown> | null | undefined;
                     etag: string | null;
@@ -845,6 +1013,13 @@ export declare const workflowsRouter: import("@trpc/server").TRPCBuiltRouter<{
                         ui_properties?: Record<string, string> | null | undefined;
                         edge_type?: string | undefined;
                     }[];
+                    links?: {
+                        id: string;
+                        source: string;
+                        target: string;
+                        label?: string | null | undefined;
+                        kind?: string | null | undefined;
+                    }[] | undefined;
                 } | null | undefined;
                 input_schema: unknown;
                 output_schema: unknown;
@@ -855,6 +1030,10 @@ export declare const workflowsRouter: import("@trpc/server").TRPCBuiltRouter<{
                 workspace_id: string | null;
                 required_providers: unknown;
                 required_models: unknown;
+                needs?: {
+                    modelKinds: string[];
+                    requiredSettings: string[];
+                } | null | undefined;
                 html_app: string | null;
                 app_doc?: Record<string, unknown> | null | undefined;
                 etag: string | null;
@@ -899,6 +1078,13 @@ export declare const workflowsRouter: import("@trpc/server").TRPCBuiltRouter<{
                             ui_properties?: Record<string, string> | null | undefined;
                             edge_type?: string | undefined;
                         }[];
+                        links?: {
+                            id: string;
+                            source: string;
+                            target: string;
+                            label?: string | null | undefined;
+                            kind?: string | null | undefined;
+                        }[] | undefined;
                     } | null | undefined;
                     input_schema: unknown;
                     output_schema: unknown;
@@ -909,6 +1095,10 @@ export declare const workflowsRouter: import("@trpc/server").TRPCBuiltRouter<{
                     workspace_id: string | null;
                     required_providers: unknown;
                     required_models: unknown;
+                    needs?: {
+                        modelKinds: string[];
+                        requiredSettings: string[];
+                    } | null | undefined;
                     html_app: string | null;
                     app_doc?: Record<string, unknown> | null | undefined;
                     etag: string | null;

package/dist/trpc/routers/workflows.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../../src/trpc/routers/workflows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAgbH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkgB1B,CAAC"}
+{"version":3,"file":"workflows.d.ts","sourceRoot":"","sources":["../../../src/trpc/routers/workflows.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AA8bH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0jB1B,CAAC"}

package/dist/trpc/routers/workflows.js

@@ -11,6 +11,7 @@
  *   - recipes (shipped chains of examples)
  *   - public (list + get) — publicProcedure (no auth required)
  *   - versions (list, create, restore, delete)
+ *   - exportScript (workflow → sandbox or Node.js script)
  *
  * Auth note:
  *   - `public.*` endpoints use publicProcedure — no auth required, matches
@@ -23,6 +24,8 @@ import { z } from "zod";
 import { withCacheBuster } from "../../lib/example-thumbnail.js";
 import { Workflow, WorkflowVersion, WorkflowCollaborator, WorkflowShare } from "@nodetool-ai/models";
 import { loadPythonPackageMetadata } from "@nodetool-ai/node-sdk";
+import { scanExampleNeeds } from "@nodetool-ai/protocol";
+import { workflowToScript } from "@nodetool-ai/dsl";
 import { createLogger } from "@nodetool-ai/config";
 import { deriveExampleAssetsDir } from "../../example-workflows.js";
 import { exampleRecipeSummary } from "@nodetool-ai/protocol/api-schemas/recipes.js";
@@ -32,10 +35,10 @@ import { router, publicProcedure } from "../index.js";
 import { protectedProcedure } from "../middleware.js";
 import { throwApiError } from "../error-formatter.js";
 import { createWorkflow, deleteWorkflow, syncTriggerRegistrations, updateWorkflow, WorkflowServiceError } from "../../lib/workflow-service.js";
-import { listInput, listOutput, getInput, createInput, updateInput, deleteInput, deleteOutput, autosaveInput, autosaveOutput, examplesInput, examplesOutput, publicListInput, publicListOutput, publicGetInput, versionsListInput, versionsListOutput, versionCreateInput, versionResponse, versionRestoreInput, versionDeleteInput, versionDeleteOutput, terminalOutputsInput, terminalOutputsOutput, workflowResponse, graph as graphSchema, sharingGetInput, sharingGetOutput, sharingCreateLinkInput, sharingRevokeLinkInput, sharingSetRoleInput, sharingRemoveCollaboratorInput, sharingOkOutput, sharingAcceptInput, sharingAcceptOutput, sharingPublicTokenInput, shareItem, collaboratorItem, sharedWithMeInput, sharedWithMeOutput } from "@nodetool-ai/protocol/api-schemas/workflows.js";
+import { listInput, listOutput, getInput, createInput, updateInput, deleteInput, deleteOutput, autosaveInput, autosaveOutput, examplesInput, examplesOutput, publicListInput, publicListOutput, publicGetInput, versionsListInput, versionsListOutput, versionCreateInput, versionResponse, versionRestoreInput, versionDeleteInput, versionDeleteOutput, terminalOutputsInput, terminalOutputsOutput, exportScriptInput, exportScriptOutput, workflowResponse, graph as graphSchema, sharingGetInput, sharingGetOutput, sharingCreateLinkInput, sharingRevokeLinkInput, sharingSetRoleInput, sharingRemoveCollaboratorInput, sharingOkOutput, sharingAcceptInput, sharingAcceptOutput, sharingPublicTokenInput, shareItem, collaboratorItem, sharedWithMeInput, sharedWithMeOutput } from "@nodetool-ai/protocol/api-schemas/workflows.js";
 import { isString } from "../../lib/wire-values.js";
 import { getStorageRetentionSettings } from "../../storage-retention.js";
-import { loadPublicShareWorkflow } from "../../lib/public-workflow-share.js";
+import { loadPublicShareWorkflow, parseSharedGraph } from "../../lib/public-workflow-share.js";
 const log = createLogger("nodetool.websocket.trpc.workflows");
 /** Map a `workflow-service` failure onto this router's tRPC error shape. */
 async function runWorkflowService(run) {
@@ -199,7 +202,7 @@ function toShareItem(share) {
 }
 // ── Example workflow helpers ────────────────────────────────────────────────
 const EXAMPLES_THUMBNAILS_PREFIX = "/api/workflows/examples/thumbnails/";
-function buildExamplesFromDir(examplesDir, examplesAssetsFallbackDir) {
+function buildExamplesFromDir(examplesDir, examplesAssetsFallbackDir, registry) {
     if (!existsSync(examplesDir))
         return [];
     const assetsDir = deriveExampleAssetsDir(examplesDir, examplesAssetsFallbackDir);
@@ -253,6 +256,7 @@ function buildExamplesFromDir(examplesDir, examplesAssetsFallbackDir) {
                 workspace_id: null,
                 required_providers: null,
                 required_models: null,
+                needs: scanExampleNeeds(parsed.graph, (nodeType) => registry?.getMetadata(nodeType)?.required_settings),
                 html_app: null,
                 app_doc: null,
                 etag: null
@@ -266,7 +270,7 @@ function buildExamplesFromDir(examplesDir, examplesAssetsFallbackDir) {
 }
 function buildExampleWorkflows(apiOptions) {
     if (apiOptions.examplesDir) {
-        return buildExamplesFromDir(apiOptions.examplesDir, apiOptions.examplesAssetsFallbackDir);
+        return buildExamplesFromDir(apiOptions.examplesDir, apiOptions.examplesAssetsFallbackDir, apiOptions.registry);
     }
     const loaded = loadPythonPackageMetadata({
         roots: apiOptions.metadataRoots,
@@ -389,7 +393,8 @@ export const workflowsRouter = router({
                     version: null,
                     message: "Autosave skipped (rate limited)",
                     skipped: true,
-                    updated_at: workflow.updated_at ?? null
+                    updated_at: workflow.updated_at ?? null,
+                    etag: workflow.getEtag()
                 };
             }
         }
@@ -398,8 +403,8 @@ export const workflowsRouter = router({
         };
         if (input.name !== undefined)
             fields.name = input.name;
-        if (input.description !== undefined)
-            fields.description = input.description;
+        // `description` and `save_type` describe the version row this autosave
+        // creates (e.g. "Before execution" on a checkpoint), never the workflow.
         // Only the owner can change visibility; editors keep it as-is.
         if (role === "owner" &&
             (input.access === "public" || input.access === "private"))
@@ -410,6 +415,7 @@ export const workflowsRouter = router({
         }
         await syncTriggerRegistrations(savedWorkflow);
         recordAutosave(input.id, Date.now());
+        const saveType = input.save_type === "checkpoint" ? "checkpoint" : "autosave";
         let version = null;
         try {
             const nextVer = await WorkflowVersion.nextVersion(input.id);
@@ -418,16 +424,16 @@ export const workflowsRouter = router({
                 user_id: ctx.userId,
                 graph: input.graph,
                 version: nextVer,
-                save_type: "autosave",
+                save_type: saveType,
                 name: savedWorkflow.name,
-                description: savedWorkflow.description
+                description: input.description ?? savedWorkflow.description
             });
             await wv.save();
             version = {
                 id: wv.id,
                 version: wv.version,
                 workflow_id: wv.workflow_id,
-                save_type: wv.save_type ?? "autosave",
+                save_type: wv.save_type ?? saveType,
                 created_at: wv.created_at ?? null
             };
             await WorkflowVersion.pruneOldAutosaves(input.id, maxVersions);
@@ -439,7 +445,8 @@ export const workflowsRouter = router({
             version,
             message: "Autosaved successfully",
             skipped: false,
-            updated_at: savedWorkflow.updated_at ?? null
+            updated_at: savedWorkflow.updated_at ?? null,
+            etag: savedWorkflow.getEtag()
         };
     }),
     // ── examples (GET /api/workflows/examples) ────────────────────────────────
@@ -514,6 +521,34 @@ export const workflowsRouter = router({
         }));
         return { outputs };
     }),
+    // ── exportScript ──────────────────────────────────────────────────────────
+    // The editor's graph when sent (unsaved edits included), else the saved one.
+    exportScript: protectedProcedure
+        .input(exportScriptInput)
+        .output(exportScriptOutput)
+        .mutation(async ({ ctx, input }) => {
+        const { workflow } = await requireWorkflowRole(input.id, ctx.userId, "viewer");
+        const graph = input.graph ?? workflow.graph;
+        if (!graph) {
+            throwApiError(ApiErrorCode.INVALID_INPUT, "Workflow has no graph");
+        }
+        try {
+            const script = workflowToScript(graph, {
+                target: input.target,
+                workflowName: workflow.name,
+                getMetadata: (nodeType) => ctx.registry.getMetadata(nodeType)
+            });
+            const base = (workflow.name ?? "").replace(/[^A-Za-z0-9._-]+/g, "_") ||
+                "workflow";
+            return {
+                ...script,
+                filename: `${base}.${input.target === "node" ? "mjs" : "js"}`
+            };
+        }
+        catch (error) {
+            throwApiError(ApiErrorCode.INVALID_INPUT, error instanceof Error ? error.message : String(error));
+        }
+    }),
     // ── versions ──────────────────────────────────────────────────────────────
     versions: router({
         // GET /api/workflows/:id/versions
@@ -554,9 +589,15 @@ export const workflowsRouter = router({
             const version = await WorkflowVersion.findByVersion(input.id, input.version);
             if (!version)
                 throwApiError(ApiErrorCode.NOT_FOUND, "Version not found");
-            workflow.graph = version.graph;
-            await workflow.save();
-            return toWorkflowResponse(workflow);
+            // Same write path as autosave: a whole-row save would overwrite a
+            // concurrent edit, and the restored graph's trigger nodes must be
+            // armed or disarmed like any other graph change.
+            const restored = await Workflow.updateFieldsIfUnchanged(input.id, workflow.updated_at, { graph: version.graph });
+            if (!restored) {
+                throwApiError(ApiErrorCode.ALREADY_EXISTS, "Workflow was modified since last read (optimistic concurrency conflict)");
+            }
+            await syncTriggerRegistrations(restored);
+            return toWorkflowResponse(restored);
         }),
         // DELETE /api/workflows/:id/versions/:versionId
         delete: protectedProcedure
@@ -693,7 +734,7 @@ export const workflowsRouter = router({
                 description: source.description,
                 tags: source.tags,
                 access: "private",
-                graph: safeGraph(source.id, source.graph),
+                graph: parseSharedGraph(source.graph),
                 settings: source.settings,
                 run_mode: source.run_mode
             }));