langflower 0.0.1

package/vendor/server/dist/workflow/workflow-id.js

@@ -0,0 +1,20 @@
+export const slugifyWorkflowId = (name) => {
+    const slug = name
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    return slug.length > 0 ? slug : 'workflow';
+};
+export const allocateWorkflowId = (base, existingIds) => {
+    const taken = existingIds instanceof Set ? existingIds : new Set(existingIds);
+    if (!taken.has(base)) {
+        return base;
+    }
+    let suffix = 2;
+    while (taken.has(`${base}-${suffix}`)) {
+        suffix += 1;
+    }
+    return `${base}-${suffix}`;
+};
+//# sourceMappingURL=workflow-id.js.map

package/vendor/server/dist/workflow/workflow-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-id.js","sourceRoot":"","sources":["../../src/workflow/workflow-id.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAU,EAAE;IACzD,MAAM,IAAI,GAAG,IAAI;SACf,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAE1B,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC;AAC5C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CACjC,IAAY,EACZ,WAAoD,EAC3C,EAAE;IACX,MAAM,KAAK,GACV,WAAW,YAAY,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;IAEjE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,MAAM,EAAE,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,CAAC,CAAC;IACb,CAAC;IAED,OAAO,GAAG,IAAI,IAAI,MAAM,EAAE,CAAC;AAC5B,CAAC,CAAC"}

package/vendor/server/dist/workflow/workflow-id.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=workflow-id.test.d.ts.map

package/vendor/server/dist/workflow/workflow-id.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-id.test.d.ts","sourceRoot":"","sources":["../../src/workflow/workflow-id.test.ts"],"names":[],"mappings":""}

package/vendor/server/dist/workflow/workflow-id.test.js

@@ -0,0 +1,23 @@
+import { describe, expect, it } from 'vitest';
+import { allocateWorkflowId, slugifyWorkflowId } from './workflow-id.js';
+describe('slugifyWorkflowId', () => {
+    it('slugifies display names', () => {
+        expect(slugifyWorkflowId('Renamed Flow')).toBe('renamed-flow');
+    });
+    it('falls back when empty', () => {
+        expect(slugifyWorkflowId('   ')).toBe('workflow');
+    });
+});
+describe('allocateWorkflowId', () => {
+    it('returns base when free', () => {
+        expect(allocateWorkflowId('untitled', [])).toBe('untitled');
+    });
+    it('appends numeric suffix on collision', () => {
+        expect(allocateWorkflowId('example-copy', ['example-copy'])).toBe('example-copy-2');
+        expect(allocateWorkflowId('example-copy', [
+            'example-copy',
+            'example-copy-2',
+        ])).toBe('example-copy-3');
+    });
+});
+//# sourceMappingURL=workflow-id.test.js.map

package/vendor/server/dist/workflow/workflow-id.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-id.test.js","sourceRoot":"","sources":["../../src/workflow/workflow-id.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEzE,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,iBAAiB,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAChC,MAAM,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,kBAAkB,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,kBAAkB,CAAC,cAAc,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAChE,gBAAgB,CAChB,CAAC;QACF,MAAM,CACL,kBAAkB,CAAC,cAAc,EAAE;YAClC,cAAc;YACd,gBAAgB;SAChB,CAAC,CACF,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/vendor/server/dist/workflow/workflow-persisted-inputs.d.ts

@@ -0,0 +1,14 @@
+import type { ReactiveNodeDefinition } from '@langflower/node-sdk';
+import type { WorkflowLoadedPayload } from '@langflower/shared/langflower.js';
+import type { ResolveNodeDefinition } from './workflow-document.js';
+/**
+ * Keep only persistable overrides: visible UI field and value !== current
+ * definition defaultValue.
+ */
+export declare const prunePersistedInputs: (inputs: Readonly<Record<string, unknown>>, definition: ReactiveNodeDefinition) => Readonly<Record<string, unknown>>;
+/**
+ * Strip non-persistable input keys from every node (unknown ports, hidden /
+ * wire-only, default-equal). Structural validate stays separate.
+ */
+export declare const normalizeWorkflowDocumentInputs: (document: WorkflowLoadedPayload, resolveDefinition: ResolveNodeDefinition) => WorkflowLoadedPayload;
+//# sourceMappingURL=workflow-persisted-inputs.d.ts.map

package/vendor/server/dist/workflow/workflow-persisted-inputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-persisted-inputs.d.ts","sourceRoot":"","sources":["../../src/workflow/workflow-persisted-inputs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAyCpE;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAChC,QAAQ,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzC,YAAY,sBAAsB,KAChC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA2BlC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,+BAA+B,GAC3C,UAAU,qBAAqB,EAC/B,mBAAmB,qBAAqB,KACtC,qBA0BD,CAAC"}

package/vendor/server/dist/workflow/workflow-persisted-inputs.js

@@ -0,0 +1,70 @@
+/**
+ * Persisted `node.inputs` hold visible UI overrides only (ADR-028).
+ * Wire-only / hidden / preview ports and values equal to the current
+ * definition `defaultValue` must not be written to disk.
+ */
+const valuesEqual = (left, right) => JSON.stringify(left) === JSON.stringify(right);
+const isPreviewInline = (inline) => {
+    if (inline === 'preview' ||
+        inline === 'preview-markdown' ||
+        inline === 'preview-code') {
+        return true;
+    }
+    if (typeof inline === 'object' && inline !== null && 'type' in inline) {
+        const type = inline.type;
+        return (type === 'preview' ||
+            type === 'preview-markdown' ||
+            type === 'preview-code');
+    }
+    return false;
+};
+/** Visible editable field on the canvas / inspector (not wire-only, not preview). */
+const hasVisibleUiInputField = (config) => config.hidden !== true &&
+    config.inline !== undefined &&
+    !isPreviewInline(config.inline);
+/**
+ * Keep only persistable overrides: visible UI field and value !== current
+ * definition defaultValue.
+ */
+export const prunePersistedInputs = (inputs, definition) => {
+    const next = {};
+    for (const [portId, value] of Object.entries(inputs)) {
+        const config = definition.inputsConfigs.find((entry) => entry.portId === portId);
+        if (config === undefined || typeof config.portId !== 'string') {
+            continue;
+        }
+        if (!hasVisibleUiInputField(config)) {
+            continue;
+        }
+        if (config.defaultValue !== undefined &&
+            valuesEqual(value, config.defaultValue)) {
+            continue;
+        }
+        next[portId] = value;
+    }
+    return next;
+};
+/**
+ * Strip non-persistable input keys from every node (unknown ports, hidden /
+ * wire-only, default-equal). Structural validate stays separate.
+ */
+export const normalizeWorkflowDocumentInputs = (document, resolveDefinition) => ({
+    ...document,
+    graph: {
+        ...document.graph,
+        nodes: document.graph.nodes.map((node) => {
+            const definition = resolveDefinition(node);
+            if (definition === undefined) {
+                return node;
+            }
+            const inputs = prunePersistedInputs(node.inputs, definition);
+            if (Object.keys(inputs).length ===
+                Object.keys(node.inputs).length &&
+                Object.keys(inputs).every((key) => valuesEqual(inputs[key], node.inputs[key]))) {
+                return node;
+            }
+            return { ...node, inputs };
+        }),
+    },
+});
+//# sourceMappingURL=workflow-persisted-inputs.js.map

package/vendor/server/dist/workflow/workflow-persisted-inputs.js.map

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

package/vendor/server/dist/workflow/workflow.service.d.ts

@@ -0,0 +1,35 @@
+import type { WorkflowListEntry, WorkflowLoadPayload, WorkflowLoadedPayload, WorkflowSavePayload } from '@langflower/shared/langflower.js';
+import { type ResolveNodeDefinition } from './workflow-document.js';
+export declare class WorkflowService {
+    private readonly projectDir;
+    private readonly resolveDefinition;
+    constructor(projectDir: string, resolveDefinition: ResolveNodeDefinition);
+    private workflowsDir;
+    private workflowPath;
+    exists(workflowId: string): Promise<boolean>;
+    list(): Promise<readonly WorkflowListEntry[]>;
+    load(payload: WorkflowLoadPayload): Promise<{
+        readonly ok: true;
+        readonly document: WorkflowLoadedPayload;
+    } | {
+        readonly ok: false;
+        readonly code: string;
+        readonly message: string;
+    }>;
+    save(payload: WorkflowSavePayload): Promise<{
+        readonly ok: true;
+        readonly document: WorkflowLoadedPayload;
+    } | {
+        readonly ok: false;
+        readonly code: string;
+        readonly message: string;
+    }>;
+    delete(workflowId: string): Promise<{
+        readonly ok: true;
+    } | {
+        readonly ok: false;
+        readonly code: string;
+        readonly message: string;
+    }>;
+}
+//# sourceMappingURL=workflow.service.d.ts.map

package/vendor/server/dist/workflow/workflow.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.service.d.ts","sourceRoot":"","sources":["../../src/workflow/workflow.service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAGN,KAAK,qBAAqB,EAC1B,MAAM,wBAAwB,CAAC;AAMhC,qBAAa,eAAe;IAE1B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;gBADjB,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,qBAAqB;IAG1D,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,YAAY;IAId,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS5C,IAAI,IAAI,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC;IA4C7C,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAC9C;QAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAA;KAAE,GAC/D;QACA,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;QACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KACxB,CACH;IAsCK,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAC9C;QAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAA;KAAE,GAC/D;QACA,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;QACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KACxB,CACH;IAgDK,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CACtC;QAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;KAAE,GACrB;QACA,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;QACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;KACxB,CACH;CAYD"}

package/vendor/server/dist/workflow/workflow.service.js

@@ -0,0 +1,126 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { parseWorkflowDocument, validateWorkflowStructure, } from './workflow-document.js';
+import { normalizeWorkflowDocumentInputs } from './workflow-persisted-inputs.js';
+const workflowIdFromFileName = (fileName) => path.basename(fileName, '.json');
+export class WorkflowService {
+    projectDir;
+    resolveDefinition;
+    constructor(projectDir, resolveDefinition) {
+        this.projectDir = projectDir;
+        this.resolveDefinition = resolveDefinition;
+    }
+    workflowsDir() {
+        return path.join(this.projectDir, '.langflower', 'workflows');
+    }
+    workflowPath(workflowId) {
+        return path.join(this.workflowsDir(), `${workflowId}.json`);
+    }
+    async exists(workflowId) {
+        try {
+            await fs.access(this.workflowPath(workflowId));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async list() {
+        try {
+            const files = await fs.readdir(this.workflowsDir());
+            const entries = (await Promise.all(files
+                .filter((file) => file.endsWith('.json'))
+                .map(async (file) => {
+                try {
+                    const workflowId = workflowIdFromFileName(file);
+                    const raw = await fs.readFile(path.join(this.workflowsDir(), file), 'utf8');
+                    const { metadata } = parseWorkflowDocument(JSON.parse(raw));
+                    return {
+                        workflowId,
+                        name: metadata.name,
+                        ...(metadata.description !== undefined
+                            ? { description: metadata.description }
+                            : {}),
+                        createdAt: metadata.createdAt,
+                        updatedAt: metadata.updatedAt,
+                    };
+                }
+                catch {
+                    return undefined;
+                }
+            }))).filter((entry) => entry !== undefined);
+            return entries.sort((left, right) => left.name.localeCompare(right.name));
+        }
+        catch {
+            return [];
+        }
+    }
+    async load(payload) {
+        try {
+            const raw = await fs.readFile(this.workflowPath(payload.workflowId), 'utf8');
+            const disk = parseWorkflowDocument(JSON.parse(raw));
+            const document = normalizeWorkflowDocumentInputs({
+                workflowId: payload.workflowId,
+                metadata: disk.metadata,
+                graph: disk.graph,
+            }, this.resolveDefinition);
+            const validation = validateWorkflowStructure(document, this.resolveDefinition);
+            if (!validation.ok) {
+                return {
+                    ok: false,
+                    code: 'INVALID_GRAPH',
+                    message: validation.message,
+                };
+            }
+            return { ok: true, document };
+        }
+        catch {
+            return {
+                ok: false,
+                code: 'NOT_FOUND',
+                message: `Workflow ${payload.workflowId} not found`,
+            };
+        }
+    }
+    async save(payload) {
+        const document = normalizeWorkflowDocumentInputs({
+            workflowId: payload.workflowId,
+            metadata: payload.metadata,
+            graph: payload.graph,
+        }, this.resolveDefinition);
+        const validation = validateWorkflowStructure(document, this.resolveDefinition);
+        if (!validation.ok) {
+            return {
+                ok: false,
+                code: 'INVALID_GRAPH',
+                message: validation.message,
+            };
+        }
+        await fs.mkdir(this.workflowsDir(), { recursive: true });
+        if (payload.previousWorkflowId !== undefined &&
+            payload.previousWorkflowId !== payload.workflowId) {
+            try {
+                await fs.unlink(this.workflowPath(payload.previousWorkflowId));
+            }
+            catch {
+                // previous file may already be absent
+            }
+        }
+        await fs.writeFile(this.workflowPath(payload.workflowId), `${JSON.stringify({ metadata: document.metadata, graph: document.graph }, null, '\t')}\n`, 'utf8');
+        return { ok: true, document };
+    }
+    async delete(workflowId) {
+        try {
+            await fs.unlink(this.workflowPath(workflowId));
+            return { ok: true };
+        }
+        catch {
+            return {
+                ok: false,
+                code: 'NOT_FOUND',
+                message: `Workflow ${workflowId} not found`,
+            };
+        }
+    }
+}
+//# sourceMappingURL=workflow.service.js.map

package/vendor/server/dist/workflow/workflow.service.js.map

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

package/vendor/server/dist/workflow/workflow.service.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=workflow.service.test.d.ts.map

package/vendor/server/dist/workflow/workflow.service.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.service.test.d.ts","sourceRoot":"","sources":["../../src/workflow/workflow.service.test.ts"],"names":[],"mappings":""}

package/vendor/server/dist/workflow/workflow.service.test.js

@@ -0,0 +1,57 @@
+import { resolveWorkflowNodeDefinition } from '@langflower/common-nodes';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { WorkflowService } from './workflow.service.js';
+const resolveDefinition = (node) => {
+    const definition = resolveWorkflowNodeDefinition({
+        type: node.type,
+        data: { params: node.params },
+    });
+    if (definition === undefined) {
+        return undefined;
+    }
+    return definition;
+};
+describe('WorkflowService.list', () => {
+    let projectDir;
+    let service;
+    beforeEach(async () => {
+        projectDir = await fs.mkdtemp(path.join(os.tmpdir(), 'lf-wf-list-'));
+        service = new WorkflowService(projectDir, resolveDefinition);
+    });
+    afterEach(async () => {
+        await fs.rm(projectDir, { recursive: true, force: true });
+    });
+    it('returns saved workflows', async () => {
+        await service.save({
+            metadata: {
+                id: 'untitled',
+                name: 'untitled',
+                createdAt: '2026-06-24T22:13:29.313Z',
+                updatedAt: '2026-06-24T22:13:30.444Z',
+            },
+            graph: { viewport: { x: 0, y: 0, scale: 1 }, nodes: [], edges: [] },
+        });
+        const workflows = await service.list();
+        expect(workflows.some((entry) => entry.id === 'untitled')).toBe(true);
+    });
+    it('skips corrupt workflow files instead of returning an empty catalog', async () => {
+        const workflowsDir = path.join(projectDir, '.langflower', 'workflows');
+        await fs.mkdir(workflowsDir, { recursive: true });
+        await fs.writeFile(path.join(workflowsDir, 'broken.json'), 'not json', 'utf8');
+        await service.save({
+            metadata: {
+                id: 'untitled',
+                name: 'untitled',
+                createdAt: '2026-06-24T22:13:29.313Z',
+                updatedAt: '2026-06-24T22:13:30.444Z',
+            },
+            graph: { viewport: { x: 0, y: 0, scale: 1 }, nodes: [], edges: [] },
+        });
+        const workflows = await service.list();
+        expect(workflows.some((entry) => entry.id === 'untitled')).toBe(true);
+    });
+});
+//# sourceMappingURL=workflow.service.test.js.map

package/vendor/server/dist/workflow/workflow.service.test.js.map

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

package/vendor/server/package.json

@@ -0,0 +1,35 @@
+{
+	"name": "@langflower/server",
+	"version": "0.1.0",
+	"type": "module",
+	"exports": {
+		"./create-server": {
+			"types": "./dist/create-server.d.ts",
+			"import": "./dist/create-server.js"
+		},
+		"./bootstrap": {
+			"types": "./dist/bootstrap/project-bootstrap.service.d.ts",
+			"import": "./dist/bootstrap/project-bootstrap.service.js"
+		},
+		"./server-context": {
+			"types": "./dist/server-context.d.ts",
+			"import": "./dist/server-context.js"
+		}
+	},
+	"dependencies": {
+		"@langflower/common-nodes": "file:../common-nodes",
+		"@langflower/compiler": "file:../compiler",
+		"@langflower/node-sdk": "file:../node-sdk",
+		"@langflower/runtime": "file:../runtime",
+		"@langflower/shared": "file:../shared",
+		"@langflower/tools": "file:../tools",
+		"@langflower/websocket-bridge": "file:../websocket-bridge",
+		"express": "^4.21.0",
+		"rxjs": "^7.8.1",
+		"ws": "^8.18.0"
+	},
+	"files": [
+		"dist",
+		"skeleton"
+	]
+}

package/vendor/server/skeleton/instructions.md

@@ -0,0 +1,41 @@
+# Custom Nodes
+
+Author packs under `.langflower/nodes/<pack>/`. Default seed pack:
+**`my-nodes/`**.
+
+Import **`defineNode`** (default), `defineToolRegistrations` (LLM tool packs),
+or `defineReactiveNode` from `@langflower/node-sdk` — not from a root
+`nodes/types.ts`.
+
+Each `*.ts` file may `export default` a definition or an array. No required
+`index.ts`. Run `npm install` inside the pack when you add author dependencies;
+Langflower does **not** auto-install on start, bootstrap, or palette reload.
+
+See [`nodes/my-nodes/README.md`](nodes/my-nodes/README.md) for the full
+contract.
+
+## Seed demo
+
+- `my-nodes/git-diff.ts` — `defineNode`; runs `git diff`, emits `diff`.
+- `my-nodes/git-diff-tool.ts` — `defineToolRegistrations`; emits `git_diff`
+  ToolHandle for agent `tools` ports (on demand).
+- `my-nodes/review-gate.ts` — `defineReactiveNode`; runs `npm run test`,
+  emits on **`ok`** or **`fail`** independently.
+
+`git-diff` / `git-diff-tool` use `child_process` until a shell Cap exists on
+`ExecutionContext`.
+
+## Load custom nodes
+
+In the editor Custom section, click **Update** (or reconnect). Langflower
+typechecks each pack (`tsc --noEmit` when `tsconfig.json` is present), then
+esbuild-bundles entries that passed. On success nodes appear under **Custom**.
+Failures write `COMPILATION_ERRORS.md` in the pack without dropping other
+successful custom nodes.
+
+## Gaps
+
+1. No shell Cap on public `ExecutionContext` yet (seed demos use
+   `child_process`).
+2. Sample workflows catalog UI is not shipped — extra skeleton workflows stay
+   in the packaged `skeleton/` until catalog import lands.