@nodetool-ai/websocket 0.7.0-rc.22 → 0.8.1

package/dist/lib/workflow-bundle.d.ts

@@ -0,0 +1,102 @@
+import { type WorkflowGraphLike } from "./package-asset-export.js";
+export declare const WORKFLOW_BUNDLE_SCHEME = "bundle://";
+export declare const WORKFLOW_BUNDLE_FORMAT = "nodetool-workflow-bundle";
+export declare const WORKFLOW_BUNDLE_VERSION = 2;
+export interface WorkflowBundleManifest {
+    format: typeof WORKFLOW_BUNDLE_FORMAT;
+    version: number;
+    nodetool_version?: string;
+    created_at: string;
+    workflows: Array<{
+        file: string;
+        name: string;
+    }>;
+    assets: Array<{
+        file: string;
+        bytes: number;
+        sha256: string;
+    }>;
+    thumbnail?: string | null;
+}
+/** The workflow payload carried in a bundle (no per-user/db fields). */
+export interface BundledWorkflow {
+    id?: string;
+    name: string;
+    description?: string;
+    tags?: string[];
+    run_mode?: string | null;
+    settings?: Record<string, unknown> | null;
+    graph: WorkflowGraphLike;
+}
+export interface PackWorkflowsBundleOptions {
+    workflows: BundledWorkflow[];
+    /** Resolve bytes for a referenced asset (`asset://`/`/api/storage/` uri). */
+    fetchAssetBytes: (ref: string) => Promise<Uint8Array | null>;
+    /** Also embed http(s) and local-file refs. Off by default. */
+    includeRemote?: boolean;
+    nodetoolVersion?: string;
+    thumbnail?: Uint8Array | null;
+}
+export interface PackBundleOptions {
+    workflow: BundledWorkflow;
+    fetchAssetBytes: (ref: string) => Promise<Uint8Array | null>;
+    includeRemote?: boolean;
+    nodetoolVersion?: string;
+    thumbnail?: Uint8Array | null;
+}
+export interface PackBundleResult {
+    bytes: Uint8Array;
+    manifest: WorkflowBundleManifest;
+    /** Refs that looked embeddable but could not be resolved (left as-is). */
+    skipped: string[];
+}
+/** Build a `.nodetool` zip from one or more workflows, embedding their assets. */
+export declare function packWorkflowsBundle(options: PackWorkflowsBundleOptions): Promise<PackBundleResult>;
+/** Convenience wrapper to bundle a single workflow. */
+export declare function packWorkflowBundle(options: PackBundleOptions): Promise<PackBundleResult>;
+export interface UnpackedBundle {
+    manifest: WorkflowBundleManifest;
+    workflows: BundledWorkflow[];
+    /** file name (without the `assets/` prefix) → bytes. */
+    assets: Map<string, Uint8Array>;
+    thumbnail: Uint8Array | null;
+}
+export declare function unpackWorkflowBundle(zipBytes: Uint8Array): UnpackedBundle;
+/** Verify each asset's bytes against the manifest sha256. Returns mismatches. */
+export declare function verifyBundleChecksums(bundle: UnpackedBundle): string[];
+export interface StoreAssetInput {
+    bytes: Uint8Array;
+    fileName: string;
+    contentType: string;
+    refType?: unknown;
+}
+export interface ImportBundleOptions {
+    /**
+     * Persist a bundled asset and return the ref it should be addressed by
+     * (e.g. `asset://<id>`). `assetId`, when provided, is written back onto the
+     * ref so it round-trips through the asset system.
+     */
+    storeAsset: (input: StoreAssetInput) => Promise<{
+        uri: string;
+        assetId?: string;
+    }>;
+    /** Throw if any asset fails its manifest checksum. Default: false (warn). */
+    verifyChecksums?: boolean;
+}
+export interface ImportBundleResult {
+    workflows: BundledWorkflow[];
+    imported: Array<{
+        file: string;
+        uri: string;
+    }>;
+    /** `bundle://` refs whose bytes were missing from the archive. */
+    missing: string[];
+    checksumMismatches: string[];
+}
+/**
+ * Resolve a bundle's `bundle://` refs into concrete stored assets and return
+ * workflows ready to create. `storeAsset` decides where the bytes land; assets
+ * shared across workflows are stored once.
+ */
+export declare function importWorkflowBundle(zipBytes: Uint8Array, options: ImportBundleOptions): Promise<ImportBundleResult>;
+//# sourceMappingURL=workflow-bundle.d.ts.map

package/dist/lib/workflow-bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-bundle.d.ts","sourceRoot":"","sources":["../../src/lib/workflow-bundle.ts"],"names":[],"mappings":"AAyBA,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,2BAA2B,CAAC;AAGnC,eAAO,MAAM,sBAAsB,cAAc,CAAC;AAClD,eAAO,MAAM,sBAAsB,6BAA6B,CAAC;AACjE,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,OAAO,sBAAsB,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1C,KAAK,EAAE,iBAAiB,CAAC;CAC1B;AAED,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,6EAA6E;IAC7E,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC7D,8DAA8D;IAC9D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,eAAe,CAAC;IAC1B,eAAe,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC7D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,sBAAsB,CAAC;IACjC,0EAA0E;IAC1E,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AA6BD,kFAAkF;AAClF,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,gBAAgB,CAAC,CAmF3B;AAED,uDAAuD;AACvD,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,gBAAgB,CAAC,CAG3B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,sBAAsB,CAAC;IACjC,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,wDAAwD;IACxD,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAChC,SAAS,EAAE,UAAU,GAAG,IAAI,CAAC;CAC9B;AAOD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,UAAU,GAAG,cAAc,CAsFzE;AAED,iFAAiF;AACjF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,EAAE,CAgBtE;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,UAAU,EAAE,CACV,KAAK,EAAE,eAAe,KACnB,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,6EAA6E;IAC7E,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,kEAAkE;IAClE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AA2BD;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,UAAU,EACpB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CA6D7B"}

package/dist/lib/workflow-bundle.js

@@ -0,0 +1,306 @@
+/**
+ * `.nodetool` workflow bundle codec — a self-contained, portable archive of one
+ * or more workflows plus the asset bytes they reference, for sharing workflows
+ * as templates (offline file, import-by-URL, or upload to a hosted catalog).
+ *
+ * Layout (a zip):
+ *   manifest.json        — format/version, nodetool version, workflow list,
+ *                          asset checksums
+ *   workflows/<file>.json — one per workflow (graph refs → `bundle://<file>`)
+ *   assets/<file>        — content-addressed asset bytes (sha256 + ext), shared
+ *                          and deduped across all workflows in the bundle
+ *   thumbnail.jpg        — optional preview
+ *
+ * (v1 bundles used a single top-level `workflow.json`; `unpackWorkflowBundle`
+ * still reads those.)
+ *
+ * Export rewrites per-install refs (`asset://`, `/api/storage/`) into
+ * `bundle://<file>` and packs the bytes. Import resolves each `bundle://` ref
+ * back to a concrete asset via a caller-supplied `storeAsset` (which decides
+ * where the bytes land — user storage, a workspace, etc.) and rewrites the ref
+ * to the returned uri. The codec itself is storage-agnostic and dependency-light
+ * (fflate + node:crypto) so it can be reused server-side and, later, in the UI.
+ */
+import { createHash } from "node:crypto";
+import { strFromU8, strToU8, unzipSync, zipSync } from "fflate";
+import { collectWorkflowAssets, mediaExtension, transformMediaRefs } from "./package-asset-export.js";
+import { isString } from "./wire-values.js";
+export const WORKFLOW_BUNDLE_SCHEME = "bundle://";
+export const WORKFLOW_BUNDLE_FORMAT = "nodetool-workflow-bundle";
+export const WORKFLOW_BUNDLE_VERSION = 2;
+function sha256Hex(bytes) {
+    return createHash("sha256").update(bytes).digest("hex");
+}
+function sanitizeFileBase(value) {
+    const cleaned = value.replace(/[^A-Za-z0-9._-]+/g, "_").replace(/^[._]+/, "");
+    return cleaned || "workflow";
+}
+/** A unique `workflows/<file>.json` name, disambiguated against `used`. */
+function uniqueWorkflowFile(workflow, index, used) {
+    const base = sanitizeFileBase(workflow.id || workflow.name || `workflow-${index + 1}`);
+    let candidate = `${base}.json`;
+    let n = 2;
+    while (used.has(candidate)) {
+        candidate = `${base}-${n}.json`;
+        n += 1;
+    }
+    return candidate;
+}
+/** Build a `.nodetool` zip from one or more workflows, embedding their assets. */
+export async function packWorkflowsBundle(options) {
+    // Resolve each source at most once, even when shared across workflows.
+    const memo = new Map();
+    const fetchAssetBytes = (ref) => {
+        let pending = memo.get(ref);
+        if (!pending) {
+            pending = options.fetchAssetBytes(ref);
+            memo.set(ref, pending);
+        }
+        return pending;
+    };
+    const files = {};
+    const manifestAssets = [];
+    const manifestWorkflows = [];
+    const seenAssetFiles = new Set();
+    const usedWorkflowFiles = new Set();
+    const skipped = new Set();
+    const collectOptions = {
+        fetchAssetBytes,
+        fileNameFor: ({ source, bytes, refType }) => `${sha256Hex(bytes)}${mediaExtension(source, refType)}`,
+        uriFor: (fileName) => `${WORKFLOW_BUNDLE_SCHEME}${fileName}`
+    };
+    if (options.includeRemote) {
+        collectOptions.includeRemote = true;
+    }
+    let index = 0;
+    for (const workflow of options.workflows) {
+        const { graph, assets, skipped: workflowSkipped } = await collectWorkflowAssets(workflow.graph, collectOptions);
+        for (const s of workflowSkipped) {
+            skipped.add(s);
+        }
+        for (const asset of assets) {
+            if (seenAssetFiles.has(asset.fileName)) {
+                continue; // identical content already packed
+            }
+            seenAssetFiles.add(asset.fileName);
+            const zipPath = `assets/${asset.fileName}`;
+            files[zipPath] = asset.bytes;
+            manifestAssets.push({
+                file: zipPath,
+                bytes: asset.bytes.byteLength,
+                sha256: sha256Hex(asset.bytes)
+            });
+        }
+        const wfFile = uniqueWorkflowFile(workflow, index, usedWorkflowFiles);
+        usedWorkflowFiles.add(wfFile);
+        const bundled = { ...workflow, graph };
+        files[`workflows/${wfFile}`] = strToU8(JSON.stringify(bundled, null, 2));
+        manifestWorkflows.push({
+            file: `workflows/${wfFile}`,
+            name: workflow.name
+        });
+        index += 1;
+    }
+    const manifest = {
+        format: WORKFLOW_BUNDLE_FORMAT,
+        version: WORKFLOW_BUNDLE_VERSION,
+        created_at: new Date().toISOString(),
+        workflows: manifestWorkflows,
+        assets: manifestAssets,
+        thumbnail: options.thumbnail ? "thumbnail.jpg" : null
+    };
+    if (options.nodetoolVersion) {
+        manifest.nodetool_version = options.nodetoolVersion;
+    }
+    files["manifest.json"] = strToU8(JSON.stringify(manifest, null, 2));
+    if (options.thumbnail) {
+        files["thumbnail.jpg"] = options.thumbnail;
+    }
+    return { bytes: zipSync(files), manifest, skipped: [...skipped] };
+}
+/** Convenience wrapper to bundle a single workflow. */
+export async function packWorkflowBundle(options) {
+    const { workflow, ...rest } = options;
+    return packWorkflowsBundle({ ...rest, workflows: [workflow] });
+}
+/** Max total decompressed size of a bundle — guards against zip bombs. */
+const MAX_BUNDLE_UNCOMPRESSED_BYTES = 512 * 1024 * 1024; // 512 MB
+/** Max number of entries in a bundle. */
+const MAX_BUNDLE_ENTRIES = 10_000;
+export function unpackWorkflowBundle(zipBytes) {
+    // Bound decompression: `unzipSync` otherwise inflates every entry into memory
+    // with no size limit, so a small highly-compressible upload (a deflate run of
+    // zeros) can expand to tens of GB and OOM the whole server (decompression
+    // bomb). The filter runs per entry with the header-declared uncompressed size
+    // before that entry is inflated, so we reject over-budget archives up front.
+    let totalUncompressed = 0;
+    let entryCount = 0;
+    const entries = unzipSync(zipBytes, {
+        filter: (file) => {
+            entryCount += 1;
+            if (entryCount > MAX_BUNDLE_ENTRIES) {
+                throw new Error(`Bundle rejected: too many entries (limit ${MAX_BUNDLE_ENTRIES})`);
+            }
+            totalUncompressed += file.originalSize;
+            if (totalUncompressed > MAX_BUNDLE_UNCOMPRESSED_BYTES) {
+                throw new Error(`Bundle rejected: decompressed size exceeds ${MAX_BUNDLE_UNCOMPRESSED_BYTES} bytes`);
+            }
+            return true;
+        }
+    });
+    const manifestEntry = entries["manifest.json"];
+    if (!manifestEntry) {
+        throw new Error("Invalid bundle: missing manifest.json");
+    }
+    const manifest = JSON.parse(strFromU8(manifestEntry));
+    if (manifest.format !== WORKFLOW_BUNDLE_FORMAT) {
+        throw new Error(`Unrecognized bundle format: ${String(manifest.format)}`);
+    }
+    if (manifest.version > WORKFLOW_BUNDLE_VERSION) {
+        throw new Error(`Bundle version ${manifest.version} is newer than supported (${WORKFLOW_BUNDLE_VERSION})`);
+    }
+    const parseWorkflow = (path) => {
+        const wf = JSON.parse(strFromU8(entries[path]));
+        if (!wf.graph?.nodes) {
+            throw new Error(`Invalid bundle: ${path} has no graph`);
+        }
+        return wf;
+    };
+    const workflows = [];
+    const workflowPaths = Object.keys(entries).filter((p) => p.startsWith("workflows/") && p.endsWith(".json"));
+    if (workflowPaths.length > 0) {
+        // Preserve manifest order, then append any entries the manifest omitted.
+        const seen = new Set();
+        const ordered = (manifest.workflows ?? [])
+            .map((w) => w.file)
+            .filter((f) => entries[f]);
+        for (const path of ordered) {
+            workflows.push(parseWorkflow(path));
+            seen.add(path);
+        }
+        for (const path of workflowPaths.sort()) {
+            if (!seen.has(path)) {
+                workflows.push(parseWorkflow(path));
+            }
+        }
+    }
+    else if (entries["workflow.json"]) {
+        // v1 single-workflow bundle.
+        workflows.push(parseWorkflow("workflow.json"));
+    }
+    if (workflows.length === 0) {
+        throw new Error("Invalid bundle: no workflows found");
+    }
+    const assets = new Map();
+    for (const [path, bytes] of Object.entries(entries)) {
+        if (path.startsWith("assets/")) {
+            assets.set(path.slice("assets/".length), bytes);
+        }
+    }
+    const thumbnail = entries["thumbnail.jpg"] ?? null;
+    return { manifest, workflows, assets, thumbnail };
+}
+/** Verify each asset's bytes against the manifest sha256. Returns mismatches. */
+export function verifyBundleChecksums(bundle) {
+    const mismatches = [];
+    for (const entry of bundle.manifest.assets) {
+        const fileName = entry.file.startsWith("assets/")
+            ? entry.file.slice("assets/".length)
+            : entry.file;
+        const bytes = bundle.assets.get(fileName);
+        if (!bytes) {
+            mismatches.push(`${entry.file} (missing)`);
+            continue;
+        }
+        if (entry.sha256 && sha256Hex(bytes) !== entry.sha256) {
+            mismatches.push(`${entry.file} (checksum)`);
+        }
+    }
+    return mismatches;
+}
+const MIME_BY_EXT = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+    ".svg": "image/svg+xml",
+    ".mp3": "audio/mpeg",
+    ".wav": "audio/wav",
+    ".ogg": "audio/ogg",
+    ".flac": "audio/flac",
+    ".mp4": "video/mp4",
+    ".webm": "video/webm",
+    ".glb": "model/gltf-binary",
+    ".pdf": "application/pdf",
+    ".json": "application/json",
+    ".txt": "text/plain"
+};
+function mimeForFile(fileName) {
+    const dot = fileName.lastIndexOf(".");
+    const ext = dot >= 0 ? fileName.slice(dot).toLowerCase() : "";
+    return MIME_BY_EXT[ext] ?? "application/octet-stream";
+}
+/**
+ * Resolve a bundle's `bundle://` refs into concrete stored assets and return
+ * workflows ready to create. `storeAsset` decides where the bytes land; assets
+ * shared across workflows are stored once.
+ */
+export async function importWorkflowBundle(zipBytes, options) {
+    const bundle = unpackWorkflowBundle(zipBytes);
+    const checksumMismatches = verifyBundleChecksums(bundle);
+    if (options.verifyChecksums && checksumMismatches.length > 0) {
+        throw new Error(`Bundle checksum verification failed: ${checksumMismatches.join(", ")}`);
+    }
+    const imported = [];
+    const missing = new Set();
+    const resolvedByFile = new Map();
+    const rewriteRef = async (ref) => {
+        const uri = isString(ref.uri) ? ref.uri : "";
+        if (!uri.startsWith(WORKFLOW_BUNDLE_SCHEME)) {
+            return;
+        }
+        const fileName = uri.slice(WORKFLOW_BUNDLE_SCHEME.length);
+        const bytes = bundle.assets.get(fileName);
+        if (!bytes) {
+            missing.add(fileName);
+            return;
+        }
+        let stored = resolvedByFile.get(fileName);
+        if (!stored) {
+            const result = await options.storeAsset({
+                bytes,
+                fileName,
+                contentType: mimeForFile(fileName),
+                refType: ref.type
+            });
+            stored = { uri: result.uri };
+            if (result.assetId) {
+                stored.assetId = result.assetId;
+            }
+            resolvedByFile.set(fileName, stored);
+            imported.push({ file: fileName, uri: stored.uri });
+        }
+        ref.uri = stored.uri;
+        delete ref.temp_id;
+        delete ref.data;
+        if (stored.assetId) {
+            ref.asset_id = stored.assetId;
+        }
+        else {
+            delete ref.asset_id;
+        }
+    };
+    const workflows = [];
+    for (const workflow of bundle.workflows) {
+        const graph = await transformMediaRefs(workflow.graph, rewriteRef);
+        workflows.push({ ...workflow, graph });
+    }
+    return {
+        workflows,
+        imported,
+        missing: [...missing],
+        checksumMismatches
+    };
+}
+//# sourceMappingURL=workflow-bundle.js.map

package/dist/lib/workflow-bundle.js.map

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

package/dist/lib/workflow-service.d.ts

@@ -0,0 +1,82 @@
+/**
+ * The one implementation of workflow create/update/delete.
+ *
+ * REST (`routes/workflows.ts` -> `http-api.ts`) and tRPC (`trpc/routers/
+ * workflows.ts`) both call these; each maps `WorkflowServiceError` onto its own
+ * wire shape. The three copies that preceded this had already drifted — REST
+ * deleted the row without the collaborator/share cascade, seeded an example's
+ * graph but not its `app_doc`, and re-implemented the collaborator role check.
+ *
+ * Authoring-quality validation (`normalizeWorkflowGraph`, model-selection and
+ * leftover-handle checks) deliberately stays in the agent capability: the
+ * editor saves in-progress graphs with unset models, so gating persistence on
+ * it would reject saves the UI makes today.
+ */
+import type { Workflow as WorkflowModel } from "@nodetool-ai/models";
+import { ApiErrorCode } from "../error-codes.js";
+import { loadExampleGraph } from "../example-workflows.js";
+type ExampleLoadOptions = NonNullable<Parameters<typeof loadExampleGraph>[2]>;
+export declare const WORKFLOW_CONFLICT_MESSAGE = "Workflow was modified since last read (optimistic concurrency conflict)";
+/** A failure both wire formats can map: tRPC reads `code`, REST reads `status`. */
+export declare class WorkflowServiceError extends Error {
+    readonly code: ApiErrorCode;
+    readonly status: number;
+    constructor(code: ApiErrorCode, message: string, status: number);
+}
+export interface WorkflowGraphInput {
+    nodes: Record<string, unknown>[];
+    edges: Record<string, unknown>[];
+}
+/** The fields both writers accept. Absent means "leave alone" on update. */
+export interface WorkflowWriteInput {
+    name?: string;
+    tool_name?: string | null;
+    package_name?: string | null;
+    path?: string | null;
+    tags?: string[] | null;
+    description?: string | null;
+    thumbnail?: string | null;
+    thumbnail_url?: string | null;
+    access?: string | null;
+    graph?: WorkflowGraphInput | null;
+    settings?: Record<string, unknown> | null;
+    run_mode?: string | null;
+    workspace_id?: string | null;
+    project_id?: string;
+    html_app?: string | null;
+    app_doc?: Record<string, unknown> | null;
+    expected_updated_at?: string;
+}
+/** Seed a new workflow from a shipped example when the caller sent no graph. */
+export interface ExampleSeed {
+    packageName?: string;
+    exampleName: string;
+    apiOptions: ExampleLoadOptions;
+}
+/**
+ * Reconcile `trigger_registrations` against the workflow's current graph.
+ * Non-fatal by design — a broken trigger sync must not stop a graph from
+ * saving, so failures are logged and swallowed.
+ */
+export declare function syncTriggerRegistrations(workflow: WorkflowModel): Promise<void>;
+/**
+ * Create a workflow, optionally seeding graph and app UI from a shipped
+ * example. Both the graph and the example's `app_doc` are carried over; only
+ * one of the two former copies did the latter.
+ */
+export declare function createWorkflow(userId: string, input: WorkflowWriteInput, seed?: ExampleSeed): Promise<WorkflowModel>;
+/**
+ * Update a workflow, or create it under `id` when it does not exist (the
+ * upsert-on-PUT both wire formats rely on). Optional columns are written only
+ * when the caller sent them, so a partial save does not wipe stored values.
+ */
+export declare function updateWorkflow(userId: string, id: string, input: WorkflowWriteInput): Promise<WorkflowModel>;
+/**
+ * Delete a workflow the caller owns. `deleteOwned` carries the collaborator
+ * and share rows with it: a workflow row can be recreated under the same id,
+ * and a grant left behind would then apply to a workflow its holder was never
+ * given.
+ */
+export declare function deleteWorkflow(userId: string, id: string): Promise<void>;
+export {};
+//# sourceMappingURL=workflow-service.d.ts.map

package/dist/lib/workflow-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-service.d.ts","sourceRoot":"","sources":["../../src/lib/workflow-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,QAAQ,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAErE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EACL,gBAAgB,EAEjB,MAAM,yBAAyB,CAAC;AAEjC,KAAK,kBAAkB,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAI9E,eAAO,MAAM,yBAAyB,4EACqC,CAAC;AAE5E,mFAAmF;AACnF,qBAAa,oBAAqB,SAAQ,KAAK;IAE3C,QAAQ,CAAC,IAAI,EAAE,YAAY;IAE3B,QAAQ,CAAC,MAAM,EAAE,MAAM;IAHzB,YACW,IAAI,EAAE,YAAY,EAC3B,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM,EAIxB;CACF;AAUD,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CAClC;AAED,4EAA4E;AAC5E,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,gFAAgF;AAChF,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,kBAAkB,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,QAAQ,EAAE,aAAa,GACtB,OAAO,CAAC,IAAI,CAAC,CASf;AAoDD;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,kBAAkB,EACzB,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,aAAa,CAAC,CA4BxB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,aAAa,CAAC,CAgFxB;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,IAAI,CAAC,CAGf"}