langflower 0.0.9 → 0.1.0

package/vendor/common-nodes/dist/ai/nodes/sub-agent/node.js

@@ -1,13 +1,14 @@
 import { defineLlmNode, isSteerControlPayload, toLlmRecoveryPortValue, } from '@langflower/node-sdk/llm';
-import { concat, EMPTY, filter, mergeMap, Observable, of, } from 'rxjs';
+import { TOOL_HANDLE_WIRE_TYPE, } from '@langflower/node-sdk';
+import { randomUUID } from 'node:crypto';
+import { catchError, concat, concatMap, filter, firstValueFrom, map, mergeMap, Observable, of, Subject, take, tap, TimeoutError, } from 'rxjs';
+import { statefulObservable } from '@rx-evo/stateful-observable';
 import { llmPanelUiSchema } from '../../features/ui-schema/llm-panel-ui-schema.js';
 import { llmCompactionUiSchema } from '../../features/ui-schema/llm-compaction-ui-schema.js';
 import { llmRecoveryUiSchema } from '../../features/ui-schema/llm-recovery-ui-schema.js';
 import { AGENT_MAX_ITERATIONS_CAP, DEFAULT_AGENT_MAX_ITERATIONS, normalizeMaxIterations, } from '../../features/prompt/normalize-max-iterations.js';
-import { appendToolInventory, createLlmSessionCycle$, demuxByKind, } from '../../features/llm-session/llm-session-shell.js';
+import { appendToolInventory, demuxByKind, } from '../../features/llm-session/llm-session-shell.js';
 import { runAgentLoop, } from '../../features/llm-loop/run-agent-loop.js';
-import { waitForSubagentResult } from '../../features/wait-for-subagent-result.js';
-import { flattenSubAgentRegistrations, isSubAgentSpawnPayload, SUBAGENT_REGISTRATION_WIRE_TYPE, SUBAGENT_RESULT_WIRE_TYPE, SUBAGENT_SPAWN_WIRE_TYPE, } from '../../features/sub-agent-protocol.js';
 import { collectAgentToolHandles } from '../../../tools/collect-agent-tool-handles.js';
 import { parseLlmRolePreset, resolveEffectiveSkillId, } from '../../features/llm-role-preset.js';
 import { resolveChatProviderModel } from '../../features/prompt/resolve-chat-provider-model.js';
@@ -24,23 +25,59 @@ const normalizeSkillIds = (raw) => {
         .map((entry) => String(entry ?? '').trim())
         .filter((entry) => entry.length > 0);
 };
-const acceptSpawn = (raw, nodeId, skillIds) => {
-    if (!isSubAgentSpawnPayload(raw)) {
-        return null;
+const formatSpecialistHandleName = (displayName) => `${displayName}(subagent)`;
+const slugToolId = (name, nodeId) => {
+    const slug = (raw) => raw
+        .replace(/[^a-zA-Z0-9_-]+/g, '_')
+        .replace(/^_+|_+$/g, '')
+        .slice(0, 64);
+    const fromName = slug(name.trim());
+    if (fromName.length > 0) {
+        return fromName;
     }
-    if (raw.nodeId !== nodeId) {
-        return null;
+    const fromNode = slug(nodeId);
+    return fromNode.length > 0 ? fromNode : 'subagent';
+};
+const formatSpawnUserContent = (task, skillId) => {
+    if (skillId.length === 0) {
+        return task;
+    }
+    return `[skill:${skillId}]\n${task}`;
+};
+const buildSpecialistDescription = (name, description, skillIds) => {
+    const parts = [
+        `${name} is a canvas Sub-Agent — a separate specialist agent, not a regular tool (not files, shell, or MCP).`,
+        'Call this tool to delegate a task; the specialist runs its own model and tools and returns a text result.',
+        'Do not try to do this specialist work yourself when this tool is the right owner.',
+    ];
+    if (description.trim().length > 0) {
+        parts.push(description.trim());
     }
-    if (raw.skillId.length > 0 && !skillIds.includes(raw.skillId)) {
-        return null;
+    if (skillIds.length > 0) {
+        parts.push(`Skills: ${skillIds.join(', ')}.`);
     }
-    return raw;
+    parts.push('Required argument: task — the assignment for this Sub-Agent.');
+    return parts.join(' ');
 };
-const formatSpawnUserContent = (spawn) => {
-    if (spawn.skillId.length === 0) {
-        return spawn.task;
+const buildSpecialistInputSchema = (skillIds) => {
+    const properties = {
+        task: {
+            type: 'string',
+            description: 'Task to delegate to this Sub-Agent specialist',
+        },
+    };
+    if (skillIds.length > 0) {
+        properties.skillId = {
+            type: 'string',
+            enum: [...skillIds],
+            description: 'Optional skill announced by this Sub-Agent Inspector selector',
+        };
     }
-    return `[skill:${spawn.skillId}]\n${spawn.task}`;
+    return {
+        type: 'object',
+        properties,
+        required: ['task'],
+    };
 };
 const resolveTurnFactory = (context) => {
     if (context.scriptedTurns !== undefined) {
@@ -48,33 +85,78 @@ const resolveTurnFactory = (context) => {
     }
     return context.factory;
 };
-const requireChatConfig = (providerId, model, scripted) => {
+const chatConfigError = (providerId, model, scripted) => {
     if (scripted) {
-        return;
+        return undefined;
     }
     if (providerId.trim().length === 0) {
-        throw new Error('Provider is required for Sub-Agent chat');
+        return 'Error: Provider is required for Sub-Agent chat';
     }
     if (model.trim().length === 0) {
-        throw new Error('Model is required for Sub-Agent chat');
+        return 'Error: Model is required for Sub-Agent chat';
+    }
+    return undefined;
+};
+const EMPTY_INVOKE_RESULT = 'Error: Sub-Agent returned no content';
+const finalizeInvokeText = (responseText, lastDraft, lastReasoning) => {
+    if (responseText.trim().length > 0) {
+        return responseText;
+    }
+    if (lastDraft.trim().length > 0) {
+        return lastDraft;
+    }
+    if (lastReasoning.trim().length > 0) {
+        return lastReasoning;
+    }
+    return EMPTY_INVOKE_RESULT;
+};
+const seedInvokeHistory = (history, context) => {
+    const system = {
+        role: 'system',
+        content: appendToolInventory(context.effectiveSystemPrompt, context.tools),
+    };
+    if (history.length === 0) {
+        return [system];
+    }
+    if (history[0]?.role === 'system') {
+        return [system, ...history.slice(1)];
     }
+    return [system, ...history];
 };
-const runSubAgentTurn = (context, spawn, history, subagentResult$) => {
+const reduceInvokeHistory = (history, chunk) => {
+    if (chunk.kind === 'historySync') {
+        return [...chunk.messages];
+    }
+    if (chunk.kind === 'invokeDone' && chunk.text.trim().length > 0) {
+        return [...history, { role: 'assistant', content: chunk.text }];
+    }
+    return history;
+};
+const runSubAgentTurn = (context, turn, history) => {
+    const fail = (text) => of({ kind: 'response', text }, {
+        kind: 'invokeDone',
+        requestId: turn.requestId,
+        text,
+    });
     const scripted = context.scriptedTurns !== undefined;
     const factory = resolveTurnFactory(context);
     if (factory === undefined) {
-        return new Observable((subscriber) => {
-            subscriber.error(new Error('Sub-Agent chat is only available during server workflow runs'));
-        });
+        return fail('Error: Sub-Agent chat is only available during server workflow runs');
     }
-    requireChatConfig(context.providerId, context.model, scripted);
+    const configError = chatConfigError(context.providerId, context.model, scripted);
+    if (configError !== undefined) {
+        return fail(configError);
+    }
+    const userContent = formatSpawnUserContent(turn.task, turn.skillId);
+    let lastDraft = '';
+    let lastReasoning = '';
     return concat(of({
         kind: 'historySync',
         messages: [
             ...history,
             {
                 role: 'user',
-                content: formatSpawnUserContent(spawn),
+                content: userContent,
             },
         ],
     }), runAgentLoop({
@@ -85,50 +167,106 @@ const runSubAgentTurn = (context, spawn, history, subagentResult$) => {
         model: scripted
             ? context.model.trim() || 'scripted'
             : context.model,
-        messages: [
-            ...history,
-            { role: 'user', content: formatSpawnUserContent(spawn) },
-        ],
+        messages: [...history, { role: 'user', content: userContent }],
         tools: context.tools,
         toolCtx: context.toolCtx,
         maxIterations: context.maxIterations,
         compaction: context.compaction,
         recovery: context.recovery,
-        subagentRegistrations: context.subagentRegistrations,
         ...(context.requestPermission !== undefined
             ? { requestPermission: context.requestPermission }
             : {}),
         ...(context.steerControl$ !== undefined
             ? { steerControl$: context.steerControl$ }
             : {}),
-        ...(context.subagentRegistrations.length > 0
-            ? {
-                waitForSubagentResult: (callId, signal) => waitForSubagentResult(subagentResult$, callId, signal, context.recovery.subagentTimeoutMs),
-            }
-            : {}),
     }).pipe(mergeMap((chunk) => {
+        if (chunk.kind === 'reasoning' && chunk.text.length > 0) {
+            lastReasoning += chunk.text;
+        }
+        if (chunk.kind === 'draftResponse' && chunk.text.length > 0) {
+            lastDraft += chunk.text;
+        }
         if (chunk.kind !== 'response') {
             return of(chunk);
         }
-        return of(chunk, {
-            kind: 'subagentResult',
-            payload: {
-                callId: spawn.callId,
-                result: chunk.text,
-            },
+        const text = finalizeInvokeText(chunk.text, lastDraft, lastReasoning);
+        return of({ kind: 'response', text }, {
+            kind: 'invokeDone',
+            requestId: turn.requestId,
+            text,
         });
+    }), catchError((error) => {
+        const text = error instanceof Error
+            ? `Error: ${error.message}`
+            : 'Error: Sub-Agent turn failed.';
+        return fail(text);
     })));
 };
+/** Wall-clock until the inner completes — not `timeout({ first })`, which
+ *  is satisfied by `historySync` and would never abort a hung generator. */
+const withInvokeDeadline = (source, timeoutMs) => new Observable((subscriber) => {
+    const handle = setTimeout(() => {
+        subscriber.error(new TimeoutError());
+    }, timeoutMs);
+    const inner = source.subscribe({
+        next: (value) => {
+            subscriber.next(value);
+        },
+        error: (err) => {
+            clearTimeout(handle);
+            subscriber.error(err);
+        },
+        complete: () => {
+            clearTimeout(handle);
+            subscriber.complete();
+        },
+    });
+    return () => {
+        clearTimeout(handle);
+        inner.unsubscribe();
+    };
+});
+const parseInvokeTurn = (raw, skillIds) => {
+    if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
+        return {
+            ok: false,
+            text: 'Error: Sub-Agent invoke payload is invalid.',
+        };
+    }
+    const record = raw;
+    const requestId = typeof record.requestId === 'string' && record.requestId.length > 0
+        ? record.requestId
+        : randomUUID();
+    const task = typeof record.task === 'string' ? record.task.trim() : '';
+    const skillId = typeof record.skillId === 'string' ? record.skillId.trim() : '';
+    if (task.length === 0) {
+        return {
+            ok: false,
+            text: 'Error: Sub-Agent requires a non-empty task.',
+        };
+    }
+    if (skillId.length > 0 && !skillIds.includes(skillId)) {
+        return {
+            ok: false,
+            text: `Error: Skill «${skillId}» is not announced by this Sub-Agent.`,
+        };
+    }
+    return { ok: true, turn: { requestId, task, skillId } };
+};
 /**
- * Sub-Agent: ordinary OpenAI-compatible agent plus `registration` announce.
- * Parent spawn arrives on `task`; final text returns on `result` with callId.
+ * Sub-Agent: ordinary OpenAI-compatible agent that announces one ToolHandle
+ * on `subagent-registration`. Parent invoke runs this node's in-node loop.
  * @see docs/ADR.md ADR-021
  */
 export const subAgentNode = defineLlmNode({
     type: 'common-sub-agent',
     displayName: 'Sub-Agent',
     category: 'AI',
-    description: 'OpenAI-compatible specialist agent that announces via registration and answers parent spawns on task → result.',
+    description: `
+A specialist agent on the canvas. Wire it into a parent agent's **tools** so the parent can delegate a task.
+
+The specialist streams in its own work-log card. Set name, role, and skills on this node.
+`.trim(),
     uiSchema: [
         {
             field: 'name',
@@ -153,47 +291,31 @@ export const subAgentNode = defineLlmNode({
         ...llmRecoveryUiSchema,
     ],
     bind(ctx, { makeInput, configureOutput, combineInputs }, inventory) {
-        const { tools, mcp, subagentRegistration, subagentResult, steerControl, } = inventory;
+        const { tools, steerControl } = inventory;
         const systemPrompt = makeInput('systemPrompt', {
             name: 'systemPrompt',
             wireType: 'string',
             inline: 'text-multiline',
             defaultValue: '',
         });
-        const task = makeInput('task', {
-            name: 'task',
-            wireType: SUBAGENT_SPAWN_WIRE_TYPE,
-            required: true,
-        });
-        const registration$ = combineInputs([ctx], ([ec]) => {
-            const skillIds = normalizeSkillIds(ec.params.skillIds);
-            const name = String(ec.params.name ?? 'Sub-Agent').trim();
-            const description = String(ec.params.description ?? '');
-            return {
-                targetNodeId: ec.nodeId,
-                name: name.length > 0 ? name : 'Sub-Agent',
-                description,
-                skills: skillIds.map((skillId) => ({
-                    skillId,
-                    description: skillId,
-                })),
-            };
-        });
-        const context$ = combineInputs([systemPrompt, tools, subagentRegistration, mcp, ctx], ([systemPromptValue, toolList, subagentList, mcpList, ec]) => {
+        const invoke$ = new Subject();
+        let latestContext;
+        let history = [];
+        let invokeTail = Promise.resolve();
+        const context$ = combineInputs([systemPrompt, tools, ctx], ([systemPromptValue, toolList, ec]) => {
             const rolePreset = parseLlmRolePreset(ec.params.rolePreset);
             const skillId = resolveEffectiveSkillId(rolePreset, ec.params.skillId);
             const hostServices = getRunHostServices(ec);
             const skillMarkdown = hostServices?.skillMarkdown ?? '';
             const agentsMarkdown = hostServices?.agentsMarkdown ?? '';
+            const name = String(ec.params.name ?? 'Sub-Agent').trim();
+            const inspectorDescription = String(ec.params.description ?? '');
             return {
                 prompt: '',
                 tools: collectAgentToolHandles({
                     toolHandles: ec.toolHandles,
                     toolsPort: toolList,
-                    mcpHandles: ec.mcpHandles,
-                    mcpPort: mcpList,
                 }),
-                subagentRegistrations: flattenSubAgentRegistrations(subagentList),
                 ...resolveChatProviderModel(ec.params, hostServices),
                 skillId,
                 rolePreset,
@@ -234,26 +356,67 @@ export const subAgentNode = defineLlmNode({
                 factory: hostServices?.createChatCompletionStream,
                 scriptedTurns: parseScriptedTurns(ec.params['scriptedToolTurns']),
                 nodeId: ec.nodeId,
+                displayName: name.length > 0 ? name : 'Sub-Agent',
+                inspectorDescription,
                 skillIds: normalizeSkillIds(ec.params.skillIds),
             };
         });
-        const cycle$ = createLlmSessionCycle$(context$, task.value$, (context) => ({
-            history: [
+        // Loader input is invoke start, not the chunk Subject: wrapping
+        // chunks$ would re-pending on every token (demux fans loading).
+        const cycle$ = statefulObservable({
+            input: invoke$,
+            mapOperator: concatMap,
+            loader: ({ context, turn }) => {
+                history = seedInvokeHistory(history, context);
+                const timeoutMs = context.recovery.subagentTimeoutMs;
+                const failTimedOut = (text) => of({ kind: 'response', text }, {
+                    kind: 'invokeDone',
+                    requestId: turn.requestId,
+                    text,
+                });
+                const inner$ = runSubAgentTurn(context, turn, history).pipe(tap((chunk) => {
+                    history = reduceInvokeHistory(history, chunk);
+                }));
+                if (timeoutMs <= 0) {
+                    return inner$;
+                }
+                return withInvokeDeadline(inner$, timeoutMs).pipe(catchError((error) => failTimedOut(error instanceof TimeoutError
+                    ? `Error: Sub-Agent timed out after ${timeoutMs}ms.`
+                    : error instanceof Error
+                        ? `Error: ${error.message}`
+                        : 'Error: Sub-Agent turn failed.')));
+            },
+        });
+        const enqueueInvoke = (announced, args, _toolCtx) => {
+            const context = latestContext ?? announced;
+            const parsed = parseInvokeTurn({ ...args, requestId: randomUUID() }, announced.skillIds);
+            if (!parsed.ok) {
+                return Promise.resolve(parsed.text);
+            }
+            const run = () => {
+                const result = firstValueFrom(cycle$.value$.pipe(filter((chunk) => chunk.kind === 'invokeDone' &&
+                    chunk.requestId === parsed.turn.requestId), map((chunk) => chunk.text), take(1)), { defaultValue: EMPTY_INVOKE_RESULT });
+                invoke$.next({ context, turn: parsed.turn });
+                return result;
+            };
+            const next = invokeTail.then(run, run);
+            invokeTail = next.then(() => undefined, () => undefined);
+            return next;
+        };
+        const specialistTools$ = context$.pipeValue(tap((context) => {
+            latestContext = context;
+        }), map((context) => {
+            const handleName = formatSpecialistHandleName(context.displayName);
+            return [
                 {
-                    role: 'system',
-                    content: appendToolInventory(context.effectiveSystemPrompt, context.tools),
+                    toolId: slugToolId(handleName, context.nodeId),
+                    name: handleName,
+                    description: buildSpecialistDescription(handleName, context.inspectorDescription, context.skillIds),
+                    inputSchema: buildSpecialistInputSchema(context.skillIds),
+                    invoke: (args, toolCtx) => enqueueInvoke(context, args, toolCtx),
                 },
-            ],
-            trackAssistantHistory: true,
-            appendUserFeedbackToHistory: false,
-            session: undefined,
-        }), (context, turnPayload, history, _session) => {
-            const spawn = acceptSpawn(turnPayload, context.nodeId, context.skillIds);
-            if (spawn === null) {
-                return EMPTY;
-            }
-            return runSubAgentTurn(context, spawn, history, subagentResult.value$);
-        }, { primeTurn0: false });
+            ];
+        }));
         const reasoning$ = cycle$.pipeValue(demuxByKind('reasoning', (chunk) => chunk
             .text));
         const draftResponse$ = cycle$.pipeValue(demuxByKind('draftResponse', (chunk) => chunk
@@ -265,14 +428,12 @@ export const subAgentNode = defineLlmNode({
         }));
         const response$ = cycle$.pipeValue(demuxByKind('response', (chunk) => chunk
             .text));
-        const result$ = cycle$.pipeValue(demuxByKind('subagentResult', (chunk) => chunk.payload));
-        const nestedSubagent$ = cycle$.pipeValue(demuxByKind('subagentSpawn', (chunk) => chunk
-            .payload));
         return {
-            inputs: [systemPrompt, task],
+            inputs: [systemPrompt],
             outputs: [
-                configureOutput('registration', registration$, {
-                    wireType: SUBAGENT_REGISTRATION_WIRE_TYPE,
+                configureOutput('subagent-registration', specialistTools$, {
+                    name: 'subagent-registration',
+                    wireType: TOOL_HANDLE_WIRE_TYPE,
                 }),
                 configureOutput('reasoning', reasoning$, {
                     wireType: 'string',
@@ -286,16 +447,10 @@ export const subAgentNode = defineLlmNode({
                     wireType: 'string',
                     feed: { role: 'result' },
                 }),
-                configureOutput('result', result$, {
-                    wireType: SUBAGENT_RESULT_WIRE_TYPE,
-                    // Protocol payload for parent wiring — not work-log content.
-                    feed: { role: 'none' },
-                }),
             ],
             inventoryOutputs: {
                 toolLog$,
                 recovery$,
-                subagent$: nestedSubagent$,
             },
         };
     },

package/vendor/common-nodes/dist/catalog.js

@@ -23,9 +23,11 @@ import { previewNode } from './output/preview/node.js';
 import { booleanNode } from './primitives/boolean/node.js';
 import { numberNode } from './primitives/number/node.js';
 import { stringNode } from './primitives/string/node.js';
+import { stringMultilineNode } from './primitives/string-multiline/node.js';
 import { appendFileNode } from './text/append-file/node.js';
 import { concatNode } from './text/concat/node.js';
 import { readFileNode } from './text/read-file/node.js';
+import { splitPacedNode } from './text/split-paced/node.js';
 import { writeFileNode } from './text/write-file/node.js';
 import { crawlNode } from './crawl/crawl/node.js';
 import { crawlToolsNode } from './crawl/crawl-tools/node.js';
@@ -34,10 +36,15 @@ import { fetchUrlNode } from './crawl/fetch-url/node.js';
 import { savePageNode } from './crawl/save-page/node.js';
 import { memoryToolsNode } from './memory/memory-tools/node.js';
 import { langflowerToolsNode } from './langflower-tools/node.js';
+import { toolCollectionNode } from './tools/tool-collection/node.js';
+import { embedTextNode } from './embeddings/embed-text/node.js';
+import { embedSimilarityNode } from './embeddings/embed-similarity/node.js';
+import { embedProviderNode } from './embeddings/embed-provider/node.js';
 const COMMON_REACTIVE_NODES = [
     booleanNode,
     numberNode,
     stringNode,
+    stringMultilineNode,
     mergeNode,
     delayNode,
     checkpointNode,
@@ -47,6 +54,7 @@ const COMMON_REACTIVE_NODES = [
     previewNode,
     finishNode,
     concatNode,
+    splitPacedNode,
     readFileNode,
     writeFileNode,
     appendFileNode,
@@ -66,11 +74,15 @@ const COMMON_REACTIVE_NODES = [
     switchNode,
     memoryToolsNode,
     langflowerToolsNode,
+    toolCollectionNode,
     fetchUrlNode,
     extractLinksNode,
     savePageNode,
     crawlNode,
     crawlToolsNode,
+    embedTextNode,
+    embedSimilarityNode,
+    embedProviderNode,
 ];
 const COMMON_REACTIVE_NODE_CATALOG = Object.fromEntries(COMMON_REACTIVE_NODES.map((node) => [node.type, node]));
 export function getCommonReactiveNodeCatalog() {

package/vendor/common-nodes/dist/crawl/crawl/node.js

@@ -1,4 +1,4 @@
-import { defineReactiveNode } from '@langflower/node-sdk';
+import { defineReactiveNode, withLoading } from '@langflower/node-sdk';
 import { createCrawlContext } from '@langflower/tools/create-crawl-context';
 import { createWebFetch } from '@langflower/tools/create-web-fetch';
 import { runBfsCrawl } from '@langflower/tools/run-bfs-crawl';
@@ -24,7 +24,13 @@ export const crawlNode = defineReactiveNode({
     displayName: 'Crawl',
     category: 'Crawl',
     paletteSecondary: true,
-    description: 'BFS crawl from a seed URL with depth/page limits; saves pages into the crawl run.',
+    description: `
+Start from a URL and follow links up to a depth and page cap. Pages are saved as they are visited.
+
+Typical uses:
+- Research a site without clicking by hand
+- Collect a small corpus for an LLM
+`.trim(),
     uiSchema: [
         {
             field: 'maxDepth',
@@ -67,7 +73,9 @@ export const crawlNode = defineReactiveNode({
         const pages$ = combineInputs([startUrl, ctx], ([rawUrl, ec]) => ({
             startUrl: String(rawUrl ?? '').trim(),
             ec,
-        })).pipeValue(mergeMap(({ startUrl: seed, ec }) => {
+        }))
+            .pipe(withLoading())
+            .pipeValue(mergeMap(({ startUrl: seed, ec }) => {
             if (seed.length === 0) {
                 return throwError(() => new Error('Crawl requires a non-empty startUrl.'));
             }

package/vendor/common-nodes/dist/crawl/crawl-tools/node.js

@@ -8,6 +8,10 @@ export const crawlToolsNode = defineToolRegistrations({
     type: 'common-crawl-tools',
     displayName: 'Crawl Tools',
     category: 'Tools',
-    description: 'Emits crawl_fetch / crawl_extract_links / crawl_save_page / crawl_bfs with imported handlers for agent inventory.',
+    description: `
+Give an agent fetch, extract-links, save-page, and crawl tools.
+
+Wire **tools** into an LLM so it can research the web from chat.
+`.trim(),
     tools: CRAWL_TOOL_CONFIGS,
 });

package/vendor/common-nodes/dist/crawl/extract-links/node.js

@@ -11,7 +11,13 @@ export const extractLinksNode = defineReactiveNode({
     displayName: 'Extract Links',
     category: 'Crawl',
     paletteSecondary: true,
-    description: 'Resolves `href` values from HTML into an absolute URL list.',
+    description: `
+Pull absolute URLs from HTML.
+
+Typical uses:
+- List outbound links after Fetch URL
+- Feed those URLs into Crawl or another fetch
+`.trim(),
     uiSchema: [],
     bind(_ctx, { makeInput, configureOutput, combineInputs }) {
         const html = makeInput('html', {

package/vendor/common-nodes/dist/crawl/fetch-url/node.js

@@ -1,4 +1,4 @@
-import { defineReactiveNode } from '@langflower/node-sdk';
+import { defineReactiveNode, withLoading } from '@langflower/node-sdk';
 import { createWebFetch } from '@langflower/tools/create-web-fetch';
 import { from, map, mergeMap, throwError } from 'rxjs';
 import { htmlToText } from '@langflower/tools/html';
@@ -18,7 +18,13 @@ export const fetchUrlNode = defineReactiveNode({
     displayName: 'Fetch URL',
     category: 'Crawl',
     paletteSecondary: true,
-    description: 'Fetches a URL through the SSRF-guarded harness and emits HTML + plain text.',
+    description: `
+Download a page and get HTML plus readable text.
+
+Typical uses:
+- Pull an article before Extract Links or an LLM
+- Seed a Crawl
+`.trim(),
     uiSchema: [
         {
             field: 'timeoutMs',
@@ -43,7 +49,9 @@ export const fetchUrlNode = defineReactiveNode({
         const fetched$ = combineInputs([url, ctx], ([rawUrl, ec]) => ({
             rawUrl: String(rawUrl ?? '').trim(),
             ec,
-        })).pipeValue(mergeMap(({ rawUrl, ec }) => {
+        }))
+            .pipe(withLoading())
+            .pipeValue(mergeMap(({ rawUrl, ec }) => {
             if (rawUrl.length === 0) {
                 return throwError(() => new Error('Fetch URL requires a non-empty url.'));
             }
@@ -59,7 +67,8 @@ export const fetchUrlNode = defineReactiveNode({
                 maxBytes,
             })).pipe(map((result) => {
                 if (!result.ok && result.body.length === 0) {
-                    throw new Error(result.error ?? `Fetch failed for ${rawUrl}`);
+                    throw new Error(result.error ??
+                        `Fetch failed for ${rawUrl}`);
                 }
                 return {
                     html: result.body,

package/vendor/common-nodes/dist/crawl/save-page/node.js

@@ -1,4 +1,4 @@
-import { defineReactiveNode } from '@langflower/node-sdk';
+import { defineReactiveNode, withLoading } from '@langflower/node-sdk';
 import { createCrawlContext } from '@langflower/tools/create-crawl-context';
 import { from, mergeMap, throwError } from 'rxjs';
 import { extractHtmlTitle } from '@langflower/tools/html';
@@ -12,7 +12,13 @@ export const savePageNode = defineReactiveNode({
     displayName: 'Save Page',
     category: 'Crawl',
     paletteSecondary: true,
-    description: 'Saves url/html/text into the run crawl directory and emits saved metadata.',
+    description: `
+Store a fetched page in this run's crawl folder and emit where it was saved.
+
+Typical uses:
+- Keep HTML/text for later review
+- Persist a page before the next crawl hop
+`.trim(),
     uiSchema: [],
     bind(ctx, { makeInput, configureOutput, combineInputs }) {
         const url = makeInput('url', {
@@ -38,7 +44,9 @@ export const savePageNode = defineReactiveNode({
             html: String(rawHtml ?? ''),
             text: String(rawText ?? ''),
             ec,
-        })).pipeValue(mergeMap(({ url: pageUrl, html: pageHtml, text: pageText, ec }) => {
+        }))
+            .pipe(withLoading())
+            .pipeValue(mergeMap(({ url: pageUrl, html: pageHtml, text: pageText, ec }) => {
             if (pageUrl.length === 0) {
                 return throwError(() => new Error('Save Page requires a non-empty url.'));
             }