langflower 0.0.9 → 0.1.0

package/vendor/common-nodes/package.json

@@ -17,10 +17,6 @@
 			"types": "./dist/ai/features/llm-role-preset.d.ts",
 			"import": "./dist/ai/features/llm-role-preset.js"
 		},
-		"./ai/sub-agent-protocol": {
-			"types": "./dist/ai/features/sub-agent-protocol.d.ts",
-			"import": "./dist/ai/features/sub-agent-protocol.js"
-		},
 		"./ai/run-host-services": {
 			"types": "./dist/ai/features/run-host-services.d.ts",
 			"import": "./dist/ai/features/run-host-services.js"
@@ -32,13 +28,17 @@
 		"./ai/openai/list-provider-models": {
 			"types": "./dist/ai/features/openai/list-provider-models.d.ts",
 			"import": "./dist/ai/features/openai/list-provider-models.js"
+		},
+		"./embeddings/create-embedding": {
+			"types": "./dist/embeddings/create-embedding.d.ts",
+			"import": "./dist/embeddings/create-embedding.js"
 		}
 	},
 	"dependencies": {
 		"@langflower/node-sdk": "file:../node-sdk",
 		"@langflower/runtime": "file:../runtime",
 		"@langflower/tools": "file:../tools",
-		"@rx-evo/stateful-observable": "^0.5.2",
+		"@rx-evo/stateful-observable": "^0.6.0",
 		"openai": "^4.104.0",
 		"rxjs": "^7.8.1"
 	},

package/vendor/compiler/package.json

@@ -14,7 +14,7 @@
 	},
 	"dependencies": {
 		"@langflower/node-sdk": "file:../node-sdk",
-		"@rx-evo/stateful-observable": "^0.5.2",
+		"@rx-evo/stateful-observable": "^0.6.0",
 		"@types/node": "^22.10.0",
 		"esbuild": "^0.25.0",
 		"rxjs": "^7.8.1",

package/vendor/node-sdk/dist/node-factory/define-embed/embed-handle.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Canvas capability for batch embeddings. Parallel to {@link ToolHandle}
+ * but **not** agent inventory: `embedTexts` returns float vectors, never
+ * LLM-facing strings.
+ *
+ * Wire: provider `embed` out → consumer `embed` in, both
+ * {@link EMBED_HANDLE_WIRE_TYPE}. Live closure (not JSON-serializable).
+ */
+export declare const EMBED_HANDLE_WIRE_TYPE = "embed-handle";
+export type EmbedTextRole = 'document' | 'query';
+export type EmbedTextsOptions = {
+    readonly role?: EmbedTextRole;
+    readonly signal?: AbortSignal;
+};
+export type EmbedHandle = {
+    /** Vector size for this bound model; packs MUST reject a mismatch. */
+    readonly dim: number;
+    readonly embedTexts: (texts: readonly string[], options?: EmbedTextsOptions) => Promise<readonly Float32Array[]>;
+};
+/**
+ * Duck-type guard for {@link EmbedHandle} on `defineNode` `execute` inputs
+ * (`Record<string, unknown>`). Requires a positive finite `dim` (emit only
+ * once dim is set) and an `embedTexts` function.
+ */
+export declare const isEmbedHandle: (value: unknown) => value is EmbedHandle;

package/vendor/node-sdk/dist/node-factory/define-embed/embed-handle.js

@@ -0,0 +1,25 @@
+/**
+ * Canvas capability for batch embeddings. Parallel to {@link ToolHandle}
+ * but **not** agent inventory: `embedTexts` returns float vectors, never
+ * LLM-facing strings.
+ *
+ * Wire: provider `embed` out → consumer `embed` in, both
+ * {@link EMBED_HANDLE_WIRE_TYPE}. Live closure (not JSON-serializable).
+ */
+export const EMBED_HANDLE_WIRE_TYPE = 'embed-handle';
+const isRecord = (value) => typeof value === 'object' && value !== null;
+/**
+ * Duck-type guard for {@link EmbedHandle} on `defineNode` `execute` inputs
+ * (`Record<string, unknown>`). Requires a positive finite `dim` (emit only
+ * once dim is set) and an `embedTexts` function.
+ */
+export const isEmbedHandle = (value) => {
+    if (!isRecord(value)) {
+        return false;
+    }
+    const dim = value['dim'];
+    return (typeof dim === 'number' &&
+        Number.isFinite(dim) &&
+        dim > 0 &&
+        typeof value['embedTexts'] === 'function');
+};

package/vendor/node-sdk/dist/node-factory/define-llm-node/default-llm-ports.d.ts

@@ -3,13 +3,10 @@ import type { StatefulObservable } from '@rx-evo/stateful-observable';
 import type { configureOutput, InputConfig, makeInput, OutputConfig } from '../define-reactive-node/io-helpers.js';
 import type { LlmRecoveryNotice } from './recovery-notice.js';
 /** Port ids that every LLM-class node must expose (inventory + observability). */
-export declare const LLM_INVENTORY_INPUT_PORT_IDS: readonly ["tools", "mcp", "subagentRegistration", "subagentResult", "steerControl"];
-export declare const LLM_INVENTORY_OUTPUT_PORT_IDS: readonly ["toolLog", "recovery", "subagent"];
+export declare const LLM_INVENTORY_INPUT_PORT_IDS: readonly ["tools", "steerControl"];
+export declare const LLM_INVENTORY_OUTPUT_PORT_IDS: readonly ["toolLog", "recovery"];
 export type LlmInventoryInputs = {
     readonly tools: InputConfig;
-    readonly mcp: InputConfig;
-    readonly subagentRegistration: InputConfig;
-    readonly subagentResult: InputConfig;
     /** Soft Pause / Steer (ADR-032) — hidden + HITL textarea. */
     readonly steerControl: InputConfig;
     /** Ordered list for `inputs: [...]` spreads. */
@@ -18,7 +15,6 @@ export type LlmInventoryInputs = {
 export type LlmInventoryOutputStreams = {
     readonly toolLog$: StatefulObservable<string, unknown, PortMeta | undefined>;
     readonly recovery$: StatefulObservable<LlmRecoveryNotice, unknown, PortMeta | undefined>;
-    readonly subagent$: StatefulObservable<unknown, unknown, PortMeta | undefined>;
 };
 /**
  * Create the shared LLM inventory inputs. Authors may extend with role ports
@@ -26,6 +22,6 @@ export type LlmInventoryOutputStreams = {
  */
 export declare const defaultLlmInventoryInputs: (make: typeof makeInput) => LlmInventoryInputs;
 /**
- * Configure the shared LLM inventory outputs (`toolLog`, `recovery`, `subagent`).
+ * Configure the shared LLM inventory outputs (`toolLog`, `recovery`).
  */
 export declare const defaultLlmInventoryOutputs: (configure: typeof configureOutput, streams: LlmInventoryOutputStreams) => readonly OutputConfig[];

package/vendor/node-sdk/dist/node-factory/define-llm-node/default-llm-ports.js

@@ -1,21 +1,12 @@
-import { MCP_HANDLE_WIRE_TYPE } from '../define-mcp/mcp-handle.js';
 import { TOOL_HANDLE_WIRE_TYPE } from '../define-tool-registrations/tool-handle.js';
-import { SUBAGENT_REGISTRATION_WIRE_TYPE, SUBAGENT_RESULT_WIRE_TYPE, SUBAGENT_SPAWN_WIRE_TYPE, } from './llm-inventory-wire.js';
 import { STEER_CONTROL_PORT_ID, } from './steer-control.js';
 import { RECOVERY_PORT_ID } from './recovery-notice.js';
 /** Port ids that every LLM-class node must expose (inventory + observability). */
 export const LLM_INVENTORY_INPUT_PORT_IDS = [
     'tools',
-    'mcp',
-    'subagentRegistration',
-    'subagentResult',
     STEER_CONTROL_PORT_ID,
 ];
-export const LLM_INVENTORY_OUTPUT_PORT_IDS = [
-    'toolLog',
-    'recovery',
-    'subagent',
-];
+export const LLM_INVENTORY_OUTPUT_PORT_IDS = ['toolLog', 'recovery'];
 /**
  * Create the shared LLM inventory inputs. Authors may extend with role ports
  * but must not omit these.
@@ -27,26 +18,6 @@ export const defaultLlmInventoryInputs = (make) => {
         multi: 'combine',
         defaultValue: [],
     });
-    const mcp = make('mcp', {
-        name: 'mcp',
-        wireType: MCP_HANDLE_WIRE_TYPE,
-        multi: 'combine',
-        defaultValue: [],
-    });
-    const subagentRegistration = make('subagentRegistration', {
-        name: 'subagentRegistration',
-        wireType: SUBAGENT_REGISTRATION_WIRE_TYPE,
-        multi: 'combine',
-        defaultValue: [],
-    });
-    const subagentResult = make('subagentResult', {
-        name: 'subagentResult',
-        wireType: SUBAGENT_RESULT_WIRE_TYPE,
-        multi: 'merge',
-        defaultValue: null,
-        // Protocol payload from Sub-Agent — omit from work log.
-        feed: { role: 'none' },
-    });
     const steerControl = make(STEER_CONTROL_PORT_ID, {
         name: 'Steer',
         wireType: 'any',
@@ -64,21 +35,12 @@ export const defaultLlmInventoryInputs = (make) => {
     });
     return {
         tools,
-        mcp,
-        subagentRegistration,
-        subagentResult,
         steerControl,
-        inputs: [
-            tools,
-            mcp,
-            subagentRegistration,
-            subagentResult,
-            steerControl,
-        ],
+        inputs: [tools, steerControl],
     };
 };
 /**
- * Configure the shared LLM inventory outputs (`toolLog`, `recovery`, `subagent`).
+ * Configure the shared LLM inventory outputs (`toolLog`, `recovery`).
  */
 export const defaultLlmInventoryOutputs = (configure, streams) => [
     configure('toolLog', streams.toolLog$, {
@@ -87,10 +49,8 @@ export const defaultLlmInventoryOutputs = (configure, streams) => [
     }),
     configure(RECOVERY_PORT_ID, streams.recovery$, {
         wireType: 'any',
+        // Feed-only — canvas and palette skip hidden outputs.
         hidden: true,
         feed: { role: 'recovery', streaming: true },
     }),
-    configure('subagent', streams.subagent$, {
-        wireType: SUBAGENT_SPAWN_WIRE_TYPE,
-    }),
 ];

package/vendor/node-sdk/dist/node-factory/define-llm-node/define-llm-node.d.ts

@@ -17,10 +17,9 @@ type LlmCtx<UI extends readonly UISchemaConstItem[]> = Parameters<DefinedReactiv
 export type { LlmExecutionCaps };
 /**
  * Purpose factory atop {@link defineReactiveNode}: every LLM-class node gets
- * the shared inventory / observability ports (`tools`, `mcp`,
- * `subagentRegistration`, `subagentResult`, `steerControl`, `toolLog`,
- * `subagent`). Authors may extend with role ports but cannot omit the
- * inventory set.
+ * the shared inventory / observability ports (`tools`, `steerControl`,
+ * `toolLog`, `recovery`). Authors may extend with role ports but cannot omit
+ * the inventory set.
  */
 export declare const defineLlmNode: <UI extends readonly UISchemaConstItem[]>(config: Omit<DefinedReactiveNodeConfig<UI, LlmExecutionCaps>, "bind"> & {
     readonly bind: (ctx: LlmCtx<UI>, helpers: ReactiveBindHelpers, inventory: LlmInventoryInputs) => LlmBindResult;
@@ -41,6 +40,5 @@ export declare const defineLlmNode: <UI extends readonly UISchemaConstItem[]>(co
     readonly icon: string | undefined;
 };
 export { LLM_INVENTORY_INPUT_PORT_IDS, LLM_INVENTORY_OUTPUT_PORT_IDS, type LlmInventoryInputs, type LlmInventoryOutputStreams, } from './default-llm-ports.js';
-export { SUBAGENT_REGISTRATION_WIRE_TYPE, SUBAGENT_RESULT_WIRE_TYPE, SUBAGENT_SPAWN_WIRE_TYPE, } from './llm-inventory-wire.js';
 export { STEER_CONTROL_PORT_ID, isSteerControlContinue, isSteerControlPause, isSteerControlPayload, type SteerControlPayload, type SteerControlPause, type SteerControlResume, type SteerControlSteer, } from './steer-control.js';
 export { RECOVERY_PORT_ID, isLlmRecoveryNotice, isLlmRecoverySuspended, recoveryNoticeText, toLlmRecoveryPortValue, type LlmRecoveryNotice, type LlmRecoveryNoticeCode, type LlmRecoveryRetryReason, } from './recovery-notice.js';

package/vendor/node-sdk/dist/node-factory/define-llm-node/define-llm-node.js

@@ -21,10 +21,9 @@ const assertNoInventoryOutputs = (outputs) => {
 };
 /**
  * Purpose factory atop {@link defineReactiveNode}: every LLM-class node gets
- * the shared inventory / observability ports (`tools`, `mcp`,
- * `subagentRegistration`, `subagentResult`, `steerControl`, `toolLog`,
- * `subagent`). Authors may extend with role ports but cannot omit the
- * inventory set.
+ * the shared inventory / observability ports (`tools`, `steerControl`,
+ * `toolLog`, `recovery`). Authors may extend with role ports but cannot omit
+ * the inventory set.
  */
 export const defineLlmNode = (config) => {
     const { bind: authorBind, ...rest } = config;
@@ -46,6 +45,5 @@ export const defineLlmNode = (config) => {
     });
 };
 export { LLM_INVENTORY_INPUT_PORT_IDS, LLM_INVENTORY_OUTPUT_PORT_IDS, } from './default-llm-ports.js';
-export { SUBAGENT_REGISTRATION_WIRE_TYPE, SUBAGENT_RESULT_WIRE_TYPE, SUBAGENT_SPAWN_WIRE_TYPE, } from './llm-inventory-wire.js';
 export { STEER_CONTROL_PORT_ID, isSteerControlContinue, isSteerControlPause, isSteerControlPayload, } from './steer-control.js';
 export { RECOVERY_PORT_ID, isLlmRecoveryNotice, isLlmRecoverySuspended, recoveryNoticeText, toLlmRecoveryPortValue, } from './recovery-notice.js';

package/vendor/node-sdk/dist/node-factory/define-llm-node/llm-inventory-wire.d.ts

@@ -2,3 +2,4 @@
 export declare const SUBAGENT_REGISTRATION_WIRE_TYPE = "subagent-registration";
 export declare const SUBAGENT_SPAWN_WIRE_TYPE = "subagent-spawn";
 export declare const SUBAGENT_RESULT_WIRE_TYPE = "subagent-result";
+//# sourceMappingURL=llm-inventory-wire.d.ts.map

package/vendor/node-sdk/dist/node-factory/define-llm-node/llm-inventory-wire.js

@@ -2,3 +2,4 @@
 export const SUBAGENT_REGISTRATION_WIRE_TYPE = 'subagent-registration';
 export const SUBAGENT_SPAWN_WIRE_TYPE = 'subagent-spawn';
 export const SUBAGENT_RESULT_WIRE_TYPE = 'subagent-result';
+//# sourceMappingURL=llm-inventory-wire.js.map

package/vendor/node-sdk/dist/node-factory/define-mcp/mcp-handle.d.ts

@@ -1,8 +1,8 @@
 import type { ToolHandle } from '../define-tool-registrations/tool-handle.js';
 /**
- * Live MCP session handle on LLM `mcp` init ports.
- * Owned by MCP stdio/http nodes and server project MCP seed — agents only
- * flatten `tools`. Not JSON-serializable.
+ * Live MCP session handle owned by MCP stdio/http nodes and server project
+ * MCP seed. Agents consume `tools` only — not a canvas wire type.
+ * Not JSON-serializable.
  */
 export type McpHandle = {
     /** Wire: graph nodeId. System: jsonc `mcp.servers` key. */
@@ -12,4 +12,4 @@ export type McpHandle = {
     /** Tools listed+bound at connect (`tools/list`; system MCP may filter). */
     readonly tools: readonly ToolHandle[];
 };
-export declare const MCP_HANDLE_WIRE_TYPE = "mcp-handle";
+//# sourceMappingURL=mcp-handle.d.ts.map

package/vendor/node-sdk/dist/node-factory/define-mcp/mcp-handle.js

@@ -1 +1,2 @@
-export const MCP_HANDLE_WIRE_TYPE = 'mcp-handle';
+export {};
+//# sourceMappingURL=mcp-handle.js.map

package/vendor/node-sdk/dist/node-factory/define-node/define-node.d.ts

@@ -30,5 +30,7 @@ export type DefineNodeConfig<UI extends readonly UISchemaConstItem[] = readonly
 /**
  * Simple authoring factory: sync/Promise `execute` without RxJS.
  * Adapter over {@link defineReactiveNode} (one reactive runtime path).
+ * Stamps `{ pending: true }` on outputs before each `execute` via
+ * {@link withLoading} — authors do not call it.
  */
 export declare const defineNode: <const UI extends readonly UISchemaConstItem[]>(config: DefineNodeConfig<UI>) => ReactiveNodeDefinition;

package/vendor/node-sdk/dist/node-factory/define-node/define-node.js

@@ -1,4 +1,5 @@
 import { from, mergeMap, of, throwError } from 'rxjs';
+import { withLoading, } from '../define-reactive-node/io-helpers.js';
 import { defineReactiveNode, } from '../define-reactive-node/define-reactive-node.js';
 const inputParamsFromMeta = (portId, meta) => {
     const params = {
@@ -21,6 +22,8 @@ const inputParamsFromMeta = (portId, meta) => {
 /**
  * Simple authoring factory: sync/Promise `execute` without RxJS.
  * Adapter over {@link defineReactiveNode} (one reactive runtime path).
+ * Stamps `{ pending: true }` on outputs before each `execute` via
+ * {@link withLoading} — authors do not call it.
  */
 export const defineNode = (config) => {
     const inputEntries = Object.entries(config.inputs ?? {});
@@ -56,7 +59,7 @@ export const defineNode = (config) => {
                 }
                 return { ec, inputs };
             });
-            const result$ = combined$.pipeValue(mergeMap(({ ec, inputs }) => from(Promise.resolve(config.execute(ec, inputs)).then((outputs) => outputs, (error) => {
+            const result$ = combined$.pipe(withLoading()).pipeValue(mergeMap(({ ec, inputs }) => from(Promise.resolve(config.execute(ec, inputs)).then((outputs) => outputs, (error) => {
                 throw error instanceof Error
                     ? error
                     : new Error(String(error));

package/vendor/node-sdk/dist/node-factory/define-reactive-node/define-reactive-node.d.ts

@@ -4,11 +4,13 @@ import type { DefinedReactiveNodeConfig, ExecutionContext, ReactiveNodeInstance
 import type { UISchemaConstItem } from './ui-schema-inference.js';
 export type { CtxError } from './ctx-error.js';
 export type { HitlButtonControl, HitlControl, HitlFileControl, HitlFileValue, HitlInputConfig, HitlPayloadTemplate, HitlTextareaControl, HitlTextValue, HitlUploadedFile, } from './hitl-config.js';
-export { configureOutput, DEFAULT_MULTILINE_MIN_HEIGHT_PX, InlineConfig, InlineSelectOption, InlineTextMultilineConfig, InputConfig, InputParams, InputPortMeta, makeInput, OutputConfig, OutputParams, OutputPortMeta, resolveMultilineInlineLayout, ResolvedMultilineInlineLayout, } from './io-helpers.js';
+export { withLoading, configureOutput, DEFAULT_MULTILINE_MIN_HEIGHT_PX, InlineConfig, InlineSelectOption, InlineTextMultilineConfig, InputConfig, InputParams, InputPortMeta, makeInput, OutputConfig, OutputParams, OutputPortMeta, resolveMultilineInlineLayout, ResolvedMultilineInlineLayout, } from './io-helpers.js';
 export type { FeedPortMeta, FeedRole } from './io-helpers.js';
 export type { InputPortMode, MetaFromStatefulObservable, PortMeta, WireType, } from './port-meta.js';
 export type { ToolHandle, ToolHandler, ToolHandlerContext, } from '../define-tool-registrations/tool-handle.js';
 export { TOOL_HANDLE_WIRE_TYPE } from '../define-tool-registrations/tool-handle.js';
+export type { EmbedHandle, EmbedTextRole, EmbedTextsOptions, } from '../define-embed/embed-handle.js';
+export { EMBED_HANDLE_WIRE_TYPE, isEmbedHandle, } from '../define-embed/embed-handle.js';
 export type { DefinedReactiveNodeConfig, ExecutionContext, ReactiveNodeInstance, } from './types.js';
 export declare const contextSymbol: unique symbol;
 /**

package/vendor/node-sdk/dist/node-factory/define-reactive-node/define-reactive-node.js

@@ -1,7 +1,8 @@
 import { combineStatefulObservables, statefulConnection, } from '@rx-evo/stateful-observable';
 import { configureOutput, makeInput } from './io-helpers.js';
-export { configureOutput, DEFAULT_MULTILINE_MIN_HEIGHT_PX, makeInput, resolveMultilineInlineLayout, } from './io-helpers.js';
+export { withLoading, configureOutput, DEFAULT_MULTILINE_MIN_HEIGHT_PX, makeInput, resolveMultilineInlineLayout, } from './io-helpers.js';
 export { TOOL_HANDLE_WIRE_TYPE } from '../define-tool-registrations/tool-handle.js';
+export { EMBED_HANDLE_WIRE_TYPE, isEmbedHandle, } from '../define-embed/embed-handle.js';
 export const contextSymbol = Symbol('node context');
 const bindHelpers = {
     makeInput,

package/vendor/node-sdk/dist/node-factory/define-reactive-node/io-helpers.d.ts

@@ -1,6 +1,7 @@
 import type { FeedPortMeta, MetaFromStatefulObservable, PortMeta } from './port-meta.js';
 export type { FeedPortMeta, FeedRole } from './port-meta.js';
 import { StatefulObservable } from '@rx-evo/stateful-observable';
+import { type OperatorFunction } from 'rxjs';
 import type { HitlInputConfig } from './hitl-config.js';
 /** One choice for the `select` / `multiselect` / `radio` inline kinds. */
 export type InlineSelectOption = {
@@ -63,6 +64,10 @@ export type InputParams<T> = {
     readonly defaultValue?: T;
     /** On-node editor kind — unset means no on-node control at all. */
     readonly inline?: InlineConfig;
+    /**
+     * Hidden wire port — no canvas handle. With editable `inline`, still a
+     * visible on-node / inspector field (Chat Input `message`).
+     */
     readonly hidden?: boolean;
     readonly dynamic?: boolean;
     readonly hitl?: HitlInputConfig;
@@ -127,3 +132,13 @@ export declare function configureOutput<T>(portId: string, stream: StatefulObser
 export type OutputConfig = ReturnType<typeof configureOutput>;
 /** Serializable descriptor for one output port — `OutputConfig['meta']`. */
 export type OutputPortMeta = MetaFromStatefulObservable<OutputConfig>;
+/**
+ * Stamp `{ pending: true }` on each new success, then re-emit that success.
+ * Use on the raw SO stream **before** async `pipeValue` work:
+ *
+ * `combineInputs(...).pipe(withLoading()).pipeValue(concatMap(delay))`
+ *
+ * `pipeValue` + `delay` / `from(Promise)` does **not** create loading.
+ * Do not wrap token/chunk streams (re-pends every emit through demux).
+ */
+export declare const withLoading: <T>() => OperatorFunction<T, T>;

package/vendor/node-sdk/dist/node-factory/define-reactive-node/io-helpers.js

@@ -1,4 +1,5 @@
-import { statefulConnection, } from '@rx-evo/stateful-observable';
+import { isSuccess, statefulConnection, } from '@rx-evo/stateful-observable';
+import { concat, concatMap, of } from 'rxjs';
 /** Default floor for canvas/inspector multiline textareas (px). */
 export const DEFAULT_MULTILINE_MIN_HEIGHT_PX = 100;
 /** Resolve multiline layout; `null` when `config` is not text-multiline. */
@@ -86,3 +87,18 @@ export function configureOutput(portId, stream, meta) {
         },
     });
 }
+const LOADING = {
+    state: Symbol.for('@rx-evo/stateful-observable/loading'),
+};
+/**
+ * Stamp `{ pending: true }` on each new success, then re-emit that success.
+ * Use on the raw SO stream **before** async `pipeValue` work:
+ *
+ * `combineInputs(...).pipe(withLoading()).pipeValue(concatMap(delay))`
+ *
+ * `pipeValue` + `delay` / `from(Promise)` does **not** create loading.
+ * Do not wrap token/chunk streams (re-pends every emit through demux).
+ */
+export const withLoading = () => concatMap((response) => isSuccess(response)
+    ? concat(of(LOADING), of(response))
+    : of(response));

package/vendor/node-sdk/dist/node-factory/define-reactive-node/port-meta.d.ts

@@ -12,13 +12,26 @@ export type WireType = string & {
     __brand: 'RuntimeWireType';
 };
 export type InputPortMode = 'single' | 'merge' | 'combine' | 'zip' | 'bypass';
-export type FeedRole = 'none' | 'reasoning' | 'draft' | 'tool' | 'shell' | 'result' | 'recovery';
+/**
+ * Sidebar work-log role stamped on a port's `feed.role`.
+ *
+ * - `none` — omit from the work log
+ * - `reasoning` — technical growing stream; caption Reasoning (LLM thinking)
+ * - `progress` — same layout as reasoning; caption PROGRESS (ingest/crawl/job logs)
+ * - `draft` — markdown draft bubble
+ * - `tool` / `shell` — tool/shell rows (growing when streaming)
+ * - `result` — conversation bubble; one row per emit (not for multi-emit logs)
+ * - `recovery` — amber recovery banner
+ */
+export type FeedRole = 'none' | 'reasoning' | 'progress' | 'draft' | 'tool' | 'shell' | 'result' | 'recovery';
 /**
  * Feed projection metadata shared by input and output port contracts.
  *
- * `streaming: true` keeps the visit open (chunks / interleaved streams).
- * Omit it so the frame closes the visit; same-node frames while last still
- * append to that visit.
+ * `streaming: true` keeps the visit open and appends chunks on growing
+ * roles (`reasoning`, `progress`, `draft`, `tool`, `shell`). Omit
+ * `streaming` so the frame closes the visit.
+ *
+ * Progress logs use `{ role: 'progress', streaming: true }`.
  */
 export type FeedPortMeta = {
     readonly role?: FeedRole;

package/vendor/node-sdk/dist/node-factory/define-reactive-node/test/samples/delay-node.js

@@ -1,5 +1,5 @@
 import { concatMap, delay, of } from 'rxjs';
-import { defineReactiveNode } from '../../define-reactive-node.js';
+import { defineReactiveNode, withLoading } from '../../define-reactive-node.js';
 /** Pass-through with async delay on `value` input. */
 export const delaySampleNode = defineReactiveNode({
     type: 'sample-delay',
@@ -12,7 +12,9 @@ export const delaySampleNode = defineReactiveNode({
         const output$ = combineInputs([value, ctx], ([inputValue, ec]) => {
             const delayMs = Math.max(0, Number(ec.params?.delayMs ?? 50));
             return { inputValue, delayMs };
-        }).pipeValue(concatMap(({ inputValue, delayMs }) => of(inputValue).pipe(delay(delayMs))));
+        })
+            .pipe(withLoading())
+            .pipeValue(concatMap(({ inputValue, delayMs }) => of(inputValue).pipe(delay(delayMs))));
         return {
             inputs: [value],
             outputs: [

package/vendor/node-sdk/dist/node-factory/define-reactive-node/types.d.ts

@@ -1,5 +1,4 @@
 import type { combineStatefulObservables, StatefulConnection, StatefulObservable } from '@rx-evo/stateful-observable';
-import type { McpHandle } from '../define-mcp/mcp-handle.js';
 import type { ToolHandle } from '../define-tool-registrations/tool-handle.js';
 import type { CtxError } from './ctx-error.js';
 import { configureOutput, InputConfig, makeInput, OutputConfig } from './io-helpers.js';
@@ -8,7 +7,7 @@ import type { AssertConstUISchema, ParamsFromUISchema, TypedUISchema, UISchemaCo
 /**
  * Identity + panel only. Host I/O (files/kb/crawl/…) is owned by specialized
  * common-nodes internally — not part of the author ExecutionContext API.
- * LLM inventory arrives via {@link LlmExecutionCaps} (`toolHandles` / `mcpHandles`).
+ * LLM inventory arrives via {@link LlmExecutionCaps} (`toolHandles`).
  */
 export type ExecutionContext<UI extends readonly UISchemaConstItem[] = readonly UISchemaConstItem[], Caps extends object = Record<string, never>> = {
     readonly projectDir: string;
@@ -18,10 +17,9 @@ export type ExecutionContext<UI extends readonly UISchemaConstItem[] = readonly
     readonly uiSchema: TypedUISchema<UI>;
     readonly amendInput?: (patch: Readonly<Record<string, unknown>>) => void;
 } & Caps;
-/** Caps for {@link defineLlmNode} — outside world via ToolHandle / MCP only. */
+/** Caps for {@link defineLlmNode} — outside world via ToolHandle only. */
 export type LlmExecutionCaps = {
     readonly toolHandles?: readonly ToolHandle[];
-    readonly mcpHandles?: readonly McpHandle[];
 };
 type ReactiveNodeBindResult = {
     readonly inputs: InputConfig[];
@@ -54,9 +52,10 @@ export type DefinedReactiveNodeConfig<UI extends readonly UISchemaConstItem[] =
      */
     readonly paletteSecondary?: boolean;
     /**
-     * Optional markdown for the palette detail popover footer
-     * (`renderMarkdown`). Omitted → no description block. Copied onto the
-     * definition / `PaletteNodeDefinition` when set.
+     * Optional markdown for the palette detail popover and inspector.
+     * Omitted → no description block. Copied onto the definition /
+     * `PaletteNodeDefinition` when set. Write user-facing use cases, not
+     * author internals.
      */
     readonly description?: string;
     /**

package/vendor/node-sdk/dist/node-factory/define-reactive-node/ui-schema-inference.d.ts

@@ -14,7 +14,7 @@ export type UISchemaConstItem = {
     readonly optionsSource?: 'langflower.providers' | 'langflower.models' | 'langflower.tools' | 'langflower.skills' | 'langflower.mcpServers' | 'node.wiredTools';
     readonly dependsOn?: string;
 };
-export type DataTypeToTsType<D extends string> = D extends 'string' | 'url' | 'file-path' | 'select' | 'phase' | 'llm-message' ? string : D extends 'number' ? number : D extends 'boolean' ? boolean : D extends 'json' | 'tool-handle' | 'tool-registration' | 'mcp-handle' | 'mcp-transport' | 'tool-id-list' | 'tool-permission-table' | 'any' ? unknown : D extends 'stream' ? never : unknown;
+export type DataTypeToTsType<D extends string> = D extends 'string' | 'url' | 'file-path' | 'select' | 'phase' | 'llm-message' ? string : D extends 'number' ? number : D extends 'boolean' ? boolean : D extends 'json' | 'tool-handle' | 'tool-registration' | 'tool-id-list' | 'tool-permission-table' | 'any' ? unknown : D extends 'stream' ? never : unknown;
 export type UISchemaItemValue<I extends UISchemaConstItem> = DataTypeToTsType<I['type']>;
 export type UISchemaFieldNames<UI extends readonly UISchemaConstItem[]> = UI[number]['field'];
 export type AssertConstUISchema<UI extends readonly UISchemaConstItem[]> = string extends UISchemaFieldNames<UI> ? never : UI;

package/vendor/node-sdk/dist/testing/create-node-harness.d.ts

@@ -0,0 +1,30 @@
+import type { ReactiveNodeDefinition, ReactiveNodeInstance } from '../node-factory/define-reactive-node/define-reactive-node.js';
+import { type UISchemaConstItem } from '../node-factory/define-reactive-node/ui-schema-inference.js';
+type HarnessUi = readonly UISchemaConstItem[];
+type HarnessInstance = ReactiveNodeInstance<HarnessUi, object>;
+export type NodeHarnessOptions = {
+    readonly projectDir?: string;
+    readonly runId?: string;
+    readonly nodeId?: string;
+    readonly params?: Readonly<Record<string, unknown>>;
+};
+export type CollectedPort<T> = {
+    readonly values: readonly T[];
+    readonly stop: () => void;
+};
+export type NodeHarness = {
+    readonly instance: HarnessInstance;
+    readonly send: (portId: string, value: unknown) => void;
+    readonly next: <T>(portId: string) => Promise<T>;
+    readonly collect: <T>(portId: string) => CollectedPort<T>;
+    readonly dispose: () => void;
+};
+/**
+ * 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 declare const createNodeHarness: (definition: Pick<ReactiveNodeDefinition, "getInstance" | "uiSchema">, options?: NodeHarnessOptions) => NodeHarness;
+export {};

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,17 +13,17 @@
 			"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": {
-		"@rx-evo/stateful-observable": "^0.5.2",
+		"@rx-evo/stateful-observable": "^0.6.0",
 		"rxjs": "^7.8.1"
 	},
 	"files": [