langflower 0.0.10 → 0.1.0

package/vendor/node-sdk/dist/testing/create-node-harness.js

@@ -0,0 +1,68 @@
+import { of, firstValueFrom } from 'rxjs';
+import { defaultParamsFromUiSchema, } from '../node-factory/define-reactive-node/ui-schema-inference.js';
+const missingPort = (kind, portId) => new Error(`Unknown ${kind} port "${portId}"`);
+/**
+ * Drive a {@link ReactiveNodeDefinition} in unit tests: seed context,
+ * `send` on input ports, `next` / `collect` on outputs.
+ *
+ * Subscribe with `next` or `collect` **before** `send` when the graph can
+ * emit synchronously.
+ */
+export const createNodeHarness = (definition, options) => {
+    const instance = definition.getInstance();
+    const collectors = [];
+    const uiSchema = definition.uiSchema;
+    const params = {
+        ...defaultParamsFromUiSchema(uiSchema),
+        ...options?.params,
+    };
+    instance.ctxConnection.connect(of({
+        projectDir: options?.projectDir ?? '/tmp',
+        runId: options?.runId ?? 'test',
+        nodeId: options?.nodeId ?? 'node-1',
+        params,
+        uiSchema,
+    }));
+    const send = (portId, value) => {
+        const input = instance.inputs[portId];
+        if (input === undefined) {
+            throw missingPort('input', portId);
+        }
+        input.connect(of(value));
+    };
+    const next = (portId) => {
+        const output = instance.outputs[portId];
+        if (output === undefined) {
+            return Promise.reject(missingPort('output', portId));
+        }
+        return firstValueFrom(output.value$);
+    };
+    const collect = (portId) => {
+        const output = instance.outputs[portId];
+        if (output === undefined) {
+            throw missingPort('output', portId);
+        }
+        const values = [];
+        const subscription = output.value$.subscribe({
+            next: (value) => {
+                values.push(value);
+            },
+        });
+        collectors.push(subscription);
+        return {
+            get values() {
+                return values;
+            },
+            stop: () => {
+                subscription.unsubscribe();
+            },
+        };
+    };
+    const dispose = () => {
+        for (const subscription of collectors) {
+            subscription.unsubscribe();
+        }
+        collectors.length = 0;
+    };
+    return { instance, send, next, collect, dispose };
+};

package/vendor/node-sdk/package.json

@@ -13,13 +13,13 @@
 			"types": "./dist/node-factory/define-llm-node/define-llm-node.d.ts",
 			"import": "./dist/node-factory/define-llm-node/define-llm-node.js"
 		},
-		"./mcp": {
-			"types": "./dist/node-factory/define-mcp/mcp-handle.d.ts",
-			"import": "./dist/node-factory/define-mcp/mcp-handle.js"
-		},
 		"./create-typed-ui-schema": {
 			"types": "./dist/node-factory/define-reactive-node/ui-schema-inference.d.ts",
 			"import": "./dist/node-factory/define-reactive-node/ui-schema-inference.js"
+		},
+		"./testing": {
+			"types": "./dist/testing/create-node-harness.d.ts",
+			"import": "./dist/testing/create-node-harness.js"
 		}
 	},
 	"dependencies": {

package/vendor/runtime/dist/types.d.ts

@@ -14,7 +14,7 @@ export type RunId = string & {
     readonly __brand: 'RunId';
 };
 type RuntimeInputPortMode = 'single' | 'merge' | 'combine' | 'zip' | 'bypass';
-export type RuntimeFeedRole = 'none' | 'reasoning' | 'draft' | 'tool' | 'shell' | 'result' | 'recovery';
+export type RuntimeFeedRole = 'none' | 'reasoning' | 'progress' | 'draft' | 'tool' | 'shell' | 'result' | 'recovery';
 export type RuntimeFeedPortMeta = {
     readonly role?: RuntimeFeedRole;
     /** When true, feed visit stays open for chunks / interleaved streams. */

package/vendor/server/dist/bootstrap/project-bootstrap.service.d.ts

@@ -1,7 +1,7 @@
 import { type SeedSkeletonMode, type SeedSkeletonResult } from './seed-skeleton.js';
 export type BootstrapProjectOptions = {
     readonly mode?: SeedSkeletonMode;
-    /** When false, skip seeding skeleton `my-nodes`. Default true. */
+    /** When false, skip seeding skeleton custom-node packs. Default true. */
     readonly seedCustomNodes?: boolean;
 };
 /**

package/vendor/server/dist/bootstrap/seed-skeleton.d.ts

@@ -4,11 +4,11 @@ export type SeedSkeletonResult = {
 };
 export type SeedSkeletonOptions = {
     readonly mode: SeedSkeletonMode;
-    /** When false, leave `nodes/` empty (no skeleton `my-nodes`). Default true. */
+    /** When false, leave `nodes/` empty (no skeleton packs). Default true. */
     readonly seedCustomNodes?: boolean;
 };
 /**
- * Copy skeleton workflows, skills, my-nodes, and instructions into
+ * Copy skeleton workflows, skills, custom-node packs, and instructions into
  * `.langflower/`. Create mode skips existing paths; force overwrites
  * skeleton-owned files (extra project-only files stay).
  */

package/vendor/server/dist/bootstrap/seed-skeleton.js

@@ -23,8 +23,21 @@ const listSkeletonSkillIds = async (skeletonRoot) => {
         return [];
     }
 };
+const listSkeletonPackIds = async (skeletonRoot) => {
+    const nodesDir = path.join(skeletonRoot, 'nodes');
+    try {
+        const entries = await fs.readdir(nodesDir, { withFileTypes: true });
+        return entries
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => entry.name)
+            .sort();
+    }
+    catch {
+        return [];
+    }
+};
 /**
- * Copy skeleton workflows, skills, my-nodes, and instructions into
+ * Copy skeleton workflows, skills, custom-node packs, and instructions into
  * `.langflower/`. Create mode skips existing paths; force overwrites
  * skeleton-owned files (extra project-only files stay).
  */
@@ -34,7 +47,9 @@ export const seedSkeletonContent = async (skeletonRoot, langflowerDir, options)
     const copyFile = mode === 'force' ? copyFileForce : copyFileIfMissing;
     const copyDir = mode === 'force' ? copyDirForce : copyDirIfMissing;
     if (seedCustomNodes) {
-        await copyDir(path.join(skeletonRoot, 'nodes', 'my-nodes'), path.join(langflowerDir, 'nodes', 'my-nodes'));
+        for (const packId of await listSkeletonPackIds(skeletonRoot)) {
+            await copyDir(path.join(skeletonRoot, 'nodes', packId), path.join(langflowerDir, 'nodes', packId));
+        }
     }
     else {
         await fs.mkdir(path.join(langflowerDir, 'nodes'), { recursive: true });

package/vendor/server/dist/bridge/bind-embed-context.d.ts

@@ -0,0 +1,7 @@
+import { type CreateEmbedding } from '@langflower/common-nodes/embeddings/create-embedding';
+import type { LangflowerConfigService } from '../config/langflower-config.service.js';
+/**
+ * Thin credential bind: secrets stay server-side; embeddings HTTP lives in
+ * common-nodes.
+ */
+export declare const bindCreateEmbedding: (langflowerConfigService: LangflowerConfigService) => CreateEmbedding;

package/vendor/server/dist/bridge/bind-embed-context.js

@@ -0,0 +1,16 @@
+import { createEmbedding, } from '@langflower/common-nodes/embeddings/create-embedding';
+import { resolveProviderCredentials } from '../config/resolve-provider-credentials.js';
+/**
+ * Thin credential bind: secrets stay server-side; embeddings HTTP lives in
+ * common-nodes.
+ */
+export const bindCreateEmbedding = (langflowerConfigService) => createEmbedding({
+    resolveProvider: async (providerId) => {
+        const config = await langflowerConfigService.read();
+        const resolved = resolveProviderCredentials(config, providerId);
+        if (!resolved.ok) {
+            throw new Error(resolved.message);
+        }
+        return resolved.credentials;
+    },
+});

package/vendor/server/dist/bridge/build-execution-context.d.ts

@@ -1,9 +1,9 @@
 import type { LangflowerBusRequest } from '@langflower/common-nodes/ai/run-host-services';
 import { type ExecutionContext, type ToolHandle } from '@langflower/node-sdk';
 import type { LlmExecutionCaps } from '@langflower/node-sdk/llm';
-import type { McpHandle } from '@langflower/node-sdk/mcp';
 import type { RuntimeSeedPortValue } from '@langflower/runtime';
 import { type LangflowerConfig, type RunnerPermissionAskPayload } from '@langflower/shared/langflower.js';
+import { type SystemMcpServerTools } from '@langflower/tools/create-system-mcp-handles';
 import type { ServerContext } from '../server-context.js';
 import type { LangflowerSession } from '../session/langflower-session.js';
 type WorkflowGraphNode = {
@@ -20,7 +20,7 @@ type BuildHarnessHooks = {
     readonly requestLangflowerBus?: LangflowerBusRequest;
     readonly getLiveWiredTools?: (agentNodeId: string) => readonly ToolHandle[];
 };
-export declare const buildExecutionContext: (context: ExecutionContextDeps, runId: string, node: WorkflowGraphNode, hooks?: BuildHarnessHooks, preloadedConfig?: LangflowerConfig, runMcpHandles?: readonly McpHandle[]) => Promise<ExecutionContext<never, LlmExecutionCaps>>;
+export declare const buildExecutionContext: (context: ExecutionContextDeps, runId: string, node: WorkflowGraphNode, hooks?: BuildHarnessHooks, preloadedConfig?: LangflowerConfig, runMcpHandles?: readonly SystemMcpServerTools[]) => Promise<ExecutionContext<never, LlmExecutionCaps>>;
 /**
  * Context seeds whose `value` is an Observable (e.g. `throwError` → CtxError)
  * must be `connect`ed directly. Runner `applySeeds` wraps with `of(value)`,

package/vendor/server/dist/bridge/build-execution-context.js

@@ -2,12 +2,13 @@ import { parseLlmRolePreset, resolveEffectiveSkillId, resolveEffectiveToolPermis
 import { attachRunHostServices } from '@langflower/common-nodes/ai/run-host-services';
 import { contextSymbol, } from '@langflower/node-sdk';
 import { parseDefaultChatModel, } from '@langflower/shared/langflower.js';
-import { collectEnabledMcpIdsFromNodes, createSystemMcpHandles, filterMcpFailuresForNode, filterMcpHandlesByIds, parseEnabledMcpIds, } from '@langflower/tools/create-system-mcp-handles';
+import { collectEnabledMcpIdsFromNodes, createSystemMcpHandles, filterMcpFailuresForNode, filterSystemMcpToolsByServerIds, parseEnabledMcpIds, } from '@langflower/tools/create-system-mcp-handles';
 import { createProjectHarness, } from '@langflower/tools/create-project-harness';
 import { createWebFetch } from '@langflower/tools/create-web-fetch';
 import { mergeProjectAndNodePermissions, } from '@langflower/tools/permission';
 import { isObservable, throwError } from 'rxjs';
 import { bindCreateChatCompletionStream } from './bind-llm-context.js';
+import { bindCreateEmbedding } from './bind-embed-context.js';
 import { wrapBuiltinToolHandles } from './wrap-builtin-tool-handles.js';
 import { readAgentsMarkdown } from '../skills/read-agents-markdown.js';
 import { readSkillMarkdown } from '../skills/read-skill-markdown.js';
@@ -74,7 +75,7 @@ export const buildExecutionContext = async (context, runId, node, hooks, preload
     };
     const enabledToolIds = toolPermissionsToEnabledIds(toolPermissions);
     const builtinHandles = wrapBuiltinToolHandles(harness, enabledToolIds, permission);
-    const mcpTools = filterMcpHandlesByIds(runMcpHandles ?? [], parseEnabledMcpIds(node.params.enabledMcpIds)).flatMap((handle) => handle.tools);
+    const mcpTools = filterSystemMcpToolsByServerIds(runMcpHandles ?? [], parseEnabledMcpIds(node.params.enabledMcpIds)).flatMap((entry) => entry.tools);
     const toolHandles = [...builtinHandles, ...mcpTools];
     const base = {
         projectDir: context.projectDir,
@@ -88,13 +89,16 @@ export const buildExecutionContext = async (context, runId, node, hooks, preload
         ...(toolHandles.length > 0 ? { toolHandles } : {}),
     };
     const defaultChat = parseDefaultChatModel(config.model);
+    const defaultEmbedding = parseDefaultChatModel(config.embedding);
     return attachRunHostServices(base, {
         ...(node.type !== 'common-fake-llm'
             ? {
                 createChatCompletionStream: bindCreateChatCompletionStream(context.langflowerConfigService),
             }
             : {}),
+        createEmbedding: bindCreateEmbedding(context.langflowerConfigService),
         ...(defaultChat !== null ? { defaultChat } : {}),
+        ...(defaultEmbedding !== null ? { defaultEmbedding } : {}),
         ...(skillMarkdown.length > 0 ? { skillMarkdown } : {}),
         ...(agentsMarkdown.length > 0 ? { agentsMarkdown } : {}),
         ...(toolHarness.authorize !== undefined

package/vendor/server/dist/bridge/emit-bootstrap.js

@@ -26,7 +26,10 @@ export const emitBootstrap = async (client, context, session, checkpoints, draft
     if (langflowerConfig.dividerPositions !== undefined) {
         session.dividerPositions = langflowerConfig.dividerPositions;
     }
-    // Thin bootstrap — version + config + dividers + selected node only
+    if (langflowerConfig.paletteVisible !== undefined) {
+        session.paletteVisible = langflowerConfig.paletteVisible;
+    }
+    // Thin bootstrap — version + config + dividers + palette chrome + selected node only
     const bootstrap = await buildSessionBootstrap(session, context.langflowerConfigService, context.resolveDefinition, context.projectDir);
     clientEmit(client, 'session.state.snapshot', bootstrap);
     // Domain snapshots

package/vendor/server/dist/bridge/settings-draft-controller.js

@@ -154,12 +154,13 @@ export const createSettingsDraftController = (bridge, context, session) => {
     const commitSave = async (scope, fallback) => {
         await ensureSeeded(scope);
         const state = getState(scope);
-        // Prefer an explicit Save payload (provider/model/serverLogs) so a
-        // trailing draft.patch cannot race past commit. Otherwise persist the
-        // session draft (`{ scope }` only).
+        // Prefer an explicit Save payload (provider/model/embedding/serverLogs)
+        // so a trailing draft.patch cannot race past commit. Otherwise persist
+        // the session draft (`{ scope }` only).
         const payload = fallback !== undefined &&
             (fallback.provider !== undefined ||
                 fallback.model !== undefined ||
+                fallback.embedding !== undefined ||
                 'serverLogs' in fallback)
             ? fallback
             : state !== undefined
@@ -172,6 +173,9 @@ export const createSettingsDraftController = (bridge, context, session) => {
         const layers = await context.langflowerConfigService.writeSettings({
             scope: payload.scope,
             ...(payload.model !== undefined ? { model: payload.model } : {}),
+            ...(payload.embedding !== undefined
+                ? { embedding: payload.embedding }
+                : {}),
             ...(payload.provider !== undefined
                 ? { provider: payload.provider }
                 : {}),

package/vendor/server/dist/bridge/wire-config-handlers.js

@@ -9,6 +9,8 @@ const isSettingsDraft = (value) => {
     const draft = value;
     return (typeof draft['defaultProviderId'] === 'string' &&
         typeof draft['defaultModelId'] === 'string' &&
+        typeof draft['defaultEmbeddingProviderId'] === 'string' &&
+        typeof draft['defaultEmbeddingModelId'] === 'string' &&
         Array.isArray(draft['providers']) &&
         (draft['serverLogs'] === 'off' ||
             draft['serverLogs'] === 'default' ||

package/vendor/server/dist/bridge/wire-editor-handlers.js

@@ -182,6 +182,20 @@ export const wireEditorHandlers = (bridge, context, session, draftController) =>
         bridgeEmit(bridge, 'editor.dividers.snapshot', clamped);
         void context.langflowerConfigService.setDividerPositions(clamped);
     }));
+    subscription.add(bridge['editor.paletteVisible.requested'].subscribe((raw) => {
+        if (!isInboundEvent(raw)) {
+            return;
+        }
+        if (findClientById(bridge, raw.clientId) === undefined) {
+            return;
+        }
+        if (typeof raw.payload !== 'boolean') {
+            return;
+        }
+        session.paletteVisible = raw.payload;
+        bridgeEmit(bridge, 'editor.paletteVisible.snapshot', raw.payload);
+        void context.langflowerConfigService.setPaletteVisible(raw.payload);
+    }));
     subscription.add(bridge['editor.settings.requested'].subscribe((raw) => {
         if (!isInboundEvent(raw)) {
             return;

package/vendor/server/dist/config/langflower-config.service.d.ts

@@ -6,6 +6,7 @@ export type LangflowerConfigLayers = {
 export type LangflowerConfigSettingsWrite = {
     readonly scope: LangflowerConfigScope;
     readonly model?: string;
+    readonly embedding?: string;
     readonly provider?: Readonly<Record<string, LangflowerProviderConfig>>;
     readonly providerApiKeys?: Readonly<Record<string, string>>;
     /** `null` clears the scope key (Settings Default). */
@@ -32,4 +33,5 @@ export declare class LangflowerConfigService {
     writeSettings(input: LangflowerConfigSettingsWrite): Promise<LangflowerConfigLayers>;
     setCurrentWorkflowId(workflowId: string | undefined): Promise<LangflowerConfig>;
     setDividerPositions(positions: DividerPositions): Promise<LangflowerConfig>;
+    setPaletteVisible(visible: boolean): Promise<LangflowerConfig>;
 }

package/vendor/server/dist/config/langflower-config.service.js

@@ -147,6 +147,9 @@ function parseLangflowerConfig(raw) {
             ? { currentWorkflowId: raw.currentWorkflowId }
             : {}),
         ...(typeof raw.model === 'string' ? { model: raw.model } : {}),
+        ...(typeof raw.embedding === 'string'
+            ? { embedding: raw.embedding }
+            : {}),
         ...(typeof raw.serverLogs === 'boolean'
             ? { serverLogs: raw.serverLogs }
             : {}),
@@ -156,6 +159,9 @@ function parseLangflowerConfig(raw) {
         ...(harness !== undefined ? { harness } : {}),
         ...(mcp !== undefined ? { mcp } : {}),
         ...parseDividerPositions(raw.dividerPositions),
+        ...(typeof raw.paletteVisible === 'boolean'
+            ? { paletteVisible: raw.paletteVisible }
+            : {}),
     };
 }
 function parseDividerPositions(raw) {
@@ -205,6 +211,14 @@ function mergeLangflowerConfig(existing, patch) {
             merged.model = patch.model;
         }
     }
+    if (patch.embedding !== undefined) {
+        if (patch.embedding.trim().length === 0) {
+            delete merged.embedding;
+        }
+        else {
+            merged.embedding = patch.embedding;
+        }
+    }
     if ('serverLogs' in patch) {
         if (patch.serverLogs === undefined) {
             delete merged.serverLogs;
@@ -219,6 +233,9 @@ function mergeLangflowerConfig(existing, patch) {
     if (patch.dividerPositions !== undefined) {
         merged.dividerPositions = patch.dividerPositions;
     }
+    if (patch.paletteVisible !== undefined) {
+        merged.paletteVisible = patch.paletteVisible;
+    }
     return merged;
 }
 function serializeLangflowerConfig(merged) {
@@ -302,6 +319,9 @@ export class LangflowerConfigService {
                 ? { currentWorkflowId: config.currentWorkflowId }
                 : {}),
             ...(config.model !== undefined ? { model: config.model } : {}),
+            ...(config.embedding !== undefined
+                ? { embedding: config.embedding }
+                : {}),
             ...(config.provider !== undefined
                 ? { provider: config.provider }
                 : {}),
@@ -330,6 +350,9 @@ export class LangflowerConfigService {
             ]));
         const patch = {
             ...(input.model !== undefined ? { model: input.model } : {}),
+            ...(input.embedding !== undefined
+                ? { embedding: input.embedding }
+                : {}),
             ...(provider !== undefined ? { provider } : {}),
             ...('serverLogs' in input
                 ? {
@@ -357,4 +380,11 @@ export class LangflowerConfigService {
         await this.writeRawAt(this.projectConfigPath(), merged);
         return parseLangflowerConfig(merged);
     }
+    async setPaletteVisible(visible) {
+        const merged = mergeLangflowerConfig(await this.readRawAt(this.projectConfigPath()), {
+            paletteVisible: visible,
+        });
+        await this.writeRawAt(this.projectConfigPath(), merged);
+        return parseLangflowerConfig(merged);
+    }
 }

package/vendor/server/dist/session/build-session-bootstrap.js

@@ -16,6 +16,7 @@ export async function buildSessionBootstrap(session, langflowerConfigService, re
         version: LangflowerSession.snapshotVersion,
         langflowerConfig,
         dividerPositions: session.dividerPositions,
+        paletteVisible: session.paletteVisible,
         selectedNode: buildSelectedNodePayload(session, resolveDefinition).node,
         settings: session.settings,
     };

package/vendor/server/dist/session/langflower-session.d.ts

@@ -14,6 +14,8 @@ export declare class LangflowerSession {
     runnerStatus: RuntimeRunnerStatus;
     runId: RunId | undefined;
     dividerPositions: DividerPositions;
+    /** Left node palette shown. Hydrated from project jsonc; default visible. */
+    paletteVisible: boolean;
     /** In-memory canvas selection, shared across tabs. `null` = nothing selected. */
     selectedNodeId: string | null;
     /** Settings aside chrome — session memory only (not persisted to disk). */
@@ -32,5 +34,5 @@ export declare class LangflowerSession {
     markPristine(): void;
     buildExecutionFeed(): ExecutionFeedSnapshotPayload | null;
     static readonly sessionReadyVersion = 1;
-    static readonly snapshotVersion = 6;
+    static readonly snapshotVersion = 7;
 }

package/vendor/server/dist/session/langflower-session.js

@@ -4,7 +4,7 @@ import { Subscription } from 'rxjs';
 import { PendingPermissionAsks } from '../harness/pending-permission-asks.js';
 import { emptySettingsDraftStore, } from './settings-draft-session.js';
 const SESSION_READY_VERSION = 1;
-const SNAPSHOT_VERSION = 6;
+const SNAPSHOT_VERSION = 7;
 export class LangflowerSession {
     runtime = new RuntimeFacade({ log: true });
     /** Feed permission.ask pause/resume for the internal tool loop. */
@@ -20,6 +20,8 @@ export class LangflowerSession {
         rightWidth: 360,
         composerHeight: 168,
     };
+    /** Left node palette shown. Hydrated from project jsonc; default visible. */
+    paletteVisible = true;
     /** In-memory canvas selection, shared across tabs. `null` = nothing selected. */
     selectedNodeId = null;
     /** Settings aside chrome — session memory only (not persisted to disk). */

package/vendor/server/dist/workflow/apply-editor-mutation.js

@@ -149,6 +149,12 @@ const materializeRuntimeNode = (projectDir, node, resolveDefinition) => {
         if (input === undefined) {
             continue;
         }
+        // HITL ports stay inactive until `pushIntoInput` (composer Start /
+        // reply). Connecting a persisted Chat Input message here would
+        // double-emit when cold-start does startNode + pushIntoInput.
+        if (config.hitl !== undefined) {
+            continue;
+        }
         if (Object.hasOwn(node.inputs, config.portId)) {
             input.connect(of(node.inputs[config.portId]));
             continue;

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

@@ -1,7 +1,8 @@
 /**
  * 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.
+ * Wire-only / preview ports and values equal to the current definition
+ * `defaultValue` must not be written to disk. Hidden ports with an
+ * editable `inline` still persist (Chat Input `message`).
  */
 const valuesEqual = (left, right) => JSON.stringify(left) === JSON.stringify(right);
 const isPreviewInline = (inline) => {
@@ -18,10 +19,8 @@ const isPreviewInline = (inline) => {
     }
     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);
+/** Editable inline field (canvas / inspector), including hidden+inline. */
+const hasVisibleUiInputField = (config) => config.inline !== undefined && !isPreviewInline(config.inline);
 /**
  * Keep only persistable overrides: visible UI field and value !== current
  * definition defaultValue.
@@ -36,6 +35,9 @@ export const prunePersistedInputs = (inputs, definition) => {
         if (!hasVisibleUiInputField(config)) {
             continue;
         }
+        if (typeof value === 'string' && value.trim() === '') {
+            continue;
+        }
         if (config.defaultValue !== undefined &&
             valuesEqual(value, config.defaultValue)) {
             continue;

package/vendor/server/skeleton/instructions.md

@@ -1,7 +1,8 @@
 # Custom Nodes
 
-Author packs under `.langflower/nodes/<pack>/`. Default seed pack:
-**`my-nodes/`**.
+Author packs under `.langflower/nodes/<pack>/`. Default seed packs:
+**`my-nodes/`** (git-diff / review-gate) and **`hello-embed/`** (markdown
+→ local sqlite embeddings; copy as a starting point).
 
 Import **`defineNode`** (default), `defineToolRegistrations` (LLM tool packs),
 or `defineReactiveNode` from `@langflower/node-sdk` — not from a root
@@ -10,8 +11,19 @@ or `defineReactiveNode` from `@langflower/node-sdk` — not from a root
 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.
+Startup **does** compile packs under `.langflower/nodes/`.
 
-See [`nodes/my-nodes/README.md`](nodes/my-nodes/README.md) for the full
+If pack files `import` each other with a **`.ts` suffix**, set
+`"allowImportingTsExtensions": true` next to `"noEmit": true` in the pack
+`tsconfig.json` (hello-embed seed). Without it the pack does not compile.
+`my-nodes` uses extensionless imports and does not need the flag.
+
+- `hello-embed/` — sample embedding KB (`ingest` / `search` /
+  `search-handle`). See [`nodes/hello-embed/README.md`](nodes/hello-embed/README.md).
+  Workflows: `kb-ingest`, `kb-manual-search`, `kb-tool`, `kb-rag`.
+  Settings default embedding model required.
+
+See [`nodes/my-nodes/README.md`](nodes/my-nodes/README.md) for the author
 contract.
 
 ## Seed demo