langflower 0.0.1

package/vendor/common-nodes/dist/ai/llm-session-shell.d.ts

@@ -0,0 +1,140 @@
+import type { ToolHandle, configureOutput, makeInput } from '@langflower/node-sdk';
+import type { ToolHandlerContext } from '@langflower/tools/domain-tool-configs';
+import type { ChatCompletionMessage } from './chat-completion-stream.js';
+import type { LlmInventoryInputs, SteerControlPayload } from '@langflower/node-sdk/llm';
+import type { PortMeta } from '@langflower/node-sdk';
+import type { combineStatefulObservables, StatefulObservable } from '@rx-evo/stateful-observable';
+import { type Observable, type OperatorFunction } from 'rxjs';
+import { type LlmRolePreset } from './llm-role-preset.js';
+import { type SubAgentRegistration, type SubAgentSpawnPayload } from './sub-agent-protocol.js';
+import type { LlmCompactionConfig } from './openai/normalize-compaction-params.js';
+import type { LlmRecoveryPolicy } from './llm-loop/llm-loop-types.js';
+/** Shared inventory + panel fields assembled for OpenAI / Fake agent binds. */
+export type LlmAgentInventoryContext = {
+    readonly prompt: string;
+    readonly tools: readonly ToolHandle[];
+    readonly subagentRegistrations: readonly SubAgentRegistration[];
+    readonly providerId: string;
+    readonly model: string;
+    readonly skillId: string;
+    readonly rolePreset: LlmRolePreset;
+    readonly effectiveSystemPrompt: string;
+    readonly skillMarkdown: string;
+    readonly agentsMarkdown: string;
+    readonly toolCtx: ToolHandlerContext;
+    readonly maxIterations: number;
+    /** Cap on feedback turns after turn 0; 0 = unlimited (Soft↔Hard guardrail). */
+    readonly maxFeedbackTurns: number;
+    readonly compaction: LlmCompactionConfig;
+    readonly recovery: LlmRecoveryPolicy;
+    /** ADR-032 soft Pause / Steer — set in {@link bindLlmAgentSession}. */
+    readonly steerControl$?: Observable<SteerControlPayload>;
+};
+/**
+ * Prep for the shared LLM session cycle (ADR-016). All LLM nodes MUST use
+ * {@link createLlmSessionCycle$} — per-node cold-start history is forbidden.
+ */
+export type LlmFeedbackSessionPrep<Session = undefined> = {
+    readonly history: readonly ChatCompletionMessage[];
+    /** Append `{ role: assistant, content }` when a `response` chunk arrives. */
+    readonly trackAssistantHistory: boolean;
+    /** Append turn payload as `{ role: user }` before feedback turns (>0). */
+    readonly appendUserFeedbackToHistory: boolean;
+    readonly session: Session;
+};
+export type LlmSessionCycleOptions = {
+    /**
+     * When true (default, Soft↔Hard / openai-llm), prime turn 0 with
+     * `startWith('')` and call `runTurn` with `turnPayload === undefined`.
+     * When false (Critique `packet` / Review `result`), the first non-empty
+     * turn$ value is turn 0's payload — no empty prime.
+     */
+    readonly primeTurn0?: boolean;
+};
+/** Standard agent cycle chunk kinds demuxed to OpenAI / Fake ports. */
+type StandardLlmAgentChunk = {
+    readonly kind: 'reasoning';
+    readonly text: string;
+} | {
+    readonly kind: 'draftResponse';
+    readonly text: string;
+} | {
+    readonly kind: 'toolLog';
+    readonly text: string;
+} | {
+    readonly kind: 'response';
+    readonly text: string;
+} | {
+    readonly kind: 'historySync';
+    readonly messages: readonly ChatCompletionMessage[];
+} | {
+    readonly kind: 'subagentSpawn';
+    readonly payload: SubAgentSpawnPayload;
+};
+type LlmAgentEcSlice = {
+    readonly projectDir: string;
+    readonly runId: string;
+    readonly nodeId: string;
+    readonly params: Readonly<Record<string, unknown>>;
+    readonly toolHandles?: readonly ToolHandle[];
+    readonly mcpHandles?: readonly import('@langflower/node-sdk/mcp').McpHandle[];
+};
+type ReactiveBindHelpers = {
+    readonly makeInput: typeof makeInput;
+    readonly configureOutput: typeof configureOutput;
+    readonly combineInputs: typeof combineStatefulObservables;
+};
+export declare const appendToolInventory: (systemPrompt: string, tools: readonly ToolHandle[]) => string;
+/**
+ * RxJS operator: filter session chunks by `kind` and project the payload.
+ * Use inside `pipeValue` — do not wrap as `(cycle$) => cycle$.pipeValue(...)`.
+ *
+ * `@rx-evo` wraps values in `NoInfer`, which breaks `Extract` type guards —
+ * callers narrow with a cast inside `project`.
+ */
+export declare const demuxByKind: <Out>(kind: string, project: (chunk: {
+    readonly kind: string;
+}) => Out) => OperatorFunction<{
+    readonly kind: string;
+}, Out>;
+/**
+ * Shared LLM session cycle (ADR-016): init context recreates the session;
+ * turn$ drives turn 0 + later turns with accumulated `messages[]`.
+ *
+ * All LLM nodes (openai / fake / critique / review / future) MUST use this —
+ * do not invent per-node cold-start `switchMap` history.
+ */
+export declare const createLlmSessionCycle$: <Context extends {
+    readonly maxFeedbackTurns: number;
+}, Chunk extends {
+    readonly kind: string;
+}, Session, Deps, Meta>(context$: StatefulObservable<Context, Deps, Meta>, turn$: Observable<unknown>, prepareSession: (context: Context) => LlmFeedbackSessionPrep<Session>, runTurn: (context: Context, turnPayload: unknown, history: readonly ChatCompletionMessage[], session: Session) => Observable<Chunk>, options?: LlmSessionCycleOptions) => StatefulObservable<Chunk, Deps, Meta>;
+type BindLlmAgentSessionOptions<Context extends LlmAgentInventoryContext, Chunk extends StandardLlmAgentChunk, Session> = {
+    readonly extendContext: (base: LlmAgentInventoryContext, ec: LlmAgentEcSlice) => Context;
+    readonly prepareSession: (context: Context) => LlmFeedbackSessionPrep<Session>;
+    readonly runTurn: (context: Context, feedback: string | undefined, history: readonly ChatCompletionMessage[], subagentResult$: Observable<unknown>, session: Session) => Observable<Chunk>;
+};
+/**
+ * Composer entry for OpenAI / Fake agent binds.
+ *
+ * Order:
+ * 1. make role inputs (userPrompt / systemPrompt / feedback)
+ * 2. assemble inventory context$ (+ provider extend)
+ * 3. ADR-016 feedback cycle$
+ * 4. demux chunk ports
+ * 5. configure standard outputs
+ */
+export declare const bindLlmAgentSession: <Context extends LlmAgentInventoryContext, Chunk extends StandardLlmAgentChunk, Session = undefined>(ctx: StatefulObservable<LlmAgentEcSlice, unknown, PortMeta>, helpers: ReactiveBindHelpers, inventory: LlmInventoryInputs, options: BindLlmAgentSessionOptions<Context, Chunk, Session>) => {
+    inputs: import("@rx-evo/stateful-observable").StatefulConnection<string, unknown, import("@langflower/node-sdk").InputPortMeta<string>>[];
+    outputs: StatefulObservable<string, unknown, ({
+        readonly wireType: string;
+    } | {
+        readonly inferTypeFrom: import("@langflower/node-sdk").InputParams<unknown> | StatefulObservable<unknown, unknown, PortMeta>;
+    }) & import("@langflower/node-sdk").OutputParams & PortMeta>[];
+    inventoryOutputs: {
+        toolLog$: StatefulObservable<string, [unknown, unknown, unknown, unknown, unknown, unknown], undefined>;
+        subagent$: StatefulObservable<SubAgentSpawnPayload, [unknown, unknown, unknown, unknown, unknown, unknown], undefined>;
+    };
+};
+export {};
+//# sourceMappingURL=llm-session-shell.d.ts.map

package/vendor/common-nodes/dist/ai/llm-session-shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-session-shell.d.ts","sourceRoot":"","sources":["../../src/ai/llm-session-shell.ts"],"names":[],"mappings":"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"}

package/vendor/common-nodes/dist/ai/llm-session-shell.js

@@ -0,0 +1,181 @@
+import { filter, map, pipe, shareReplay, switchMap, } from 'rxjs';
+import { buildEffectiveSystemPrompt } from './build-effective-system-prompt.js';
+import { collectAgentToolHandles } from '../tools/collect-agent-tool-handles.js';
+import { parseLlmRolePreset, resolveEffectiveSkillId, } from './llm-role-preset.js';
+import { flattenSubAgentRegistrations, } from './sub-agent-protocol.js';
+import { normalizeCompactionConfig } from './openai/normalize-compaction-params.js';
+import { getRunHostServices } from './run-host-services.js';
+import { AGENT_MAX_ITERATIONS_CAP, DEFAULT_AGENT_MAX_ITERATIONS, normalizeMaxIterations as normalizeMaxIterationsParam, } from './normalize-max-iterations.js';
+import { normalizeLlmRecoveryPolicy } from './llm-loop/normalize-llm-recovery-policy.js';
+import { runLlmSessionMachine } from './llm-session/run-session-machine.js';
+const toolLabel = (tool) => tool.name.length > 0 ? tool.name : tool.toolId || 'unknown';
+const formatList = (items, labelOf) => (items.length === 0 ? 'none' : items.map(labelOf).join(', '));
+/** 0 = unlimited; positive = max feedback turns after turn 0. */
+const normalizeMaxFeedbackTurns = (value) => {
+    const n = typeof value === 'number' ? value : Number(value);
+    if (!Number.isFinite(n) || n < 1) {
+        return 0;
+    }
+    return Math.min(AGENT_MAX_ITERATIONS_CAP, Math.floor(n));
+};
+export const appendToolInventory = (systemPrompt, tools) => {
+    if (tools.length === 0) {
+        return systemPrompt;
+    }
+    return [
+        systemPrompt,
+        `Available tools (callable via internal tool loop): ${formatList(tools, toolLabel)}.`,
+    ]
+        .filter((part) => part.trim().length > 0)
+        .join('\n\n');
+};
+/**
+ * Step: merge prompt / inventory / role panel into the shared agent context.
+ */
+const assembleLlmAgentInventoryContext = (prompt, toolList, subagentList, mcpList, systemPromptValue, 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 ?? '';
+    return {
+        prompt: String(prompt ?? ''),
+        tools: collectAgentToolHandles({
+            toolHandles: ec.toolHandles,
+            toolsPort: toolList,
+            mcpHandles: ec.mcpHandles,
+            mcpPort: mcpList,
+        }),
+        subagentRegistrations: flattenSubAgentRegistrations(subagentList),
+        providerId: String(ec.params.providerId ?? ''),
+        model: String(ec.params.model ?? ''),
+        skillId,
+        rolePreset,
+        skillMarkdown,
+        agentsMarkdown,
+        effectiveSystemPrompt: buildEffectiveSystemPrompt({
+            rolePreset,
+            systemPromptInput: String(systemPromptValue ?? ''),
+            agentsMarkdown,
+            skillMarkdown,
+        }),
+        toolCtx: {
+            projectDir: ec.projectDir,
+            runId: ec.runId,
+            ...(hostServices?.authorize !== undefined
+                ? { authorize: hostServices.authorize }
+                : {}),
+            ...(hostServices?.denyPaths !== undefined
+                ? { denyPaths: hostServices.denyPaths }
+                : {}),
+            ...(hostServices?.allowedHosts !== undefined
+                ? { allowedHosts: hostServices.allowedHosts }
+                : {}),
+        },
+        maxIterations: normalizeMaxIterationsParam(ec.params.maxIterations, {
+            fallback: DEFAULT_AGENT_MAX_ITERATIONS,
+            maxCap: AGENT_MAX_ITERATIONS_CAP,
+        }),
+        maxFeedbackTurns: normalizeMaxFeedbackTurns(ec.params.maxFeedbackTurns),
+        compaction: normalizeCompactionConfig(ec.params),
+        recovery: normalizeLlmRecoveryPolicy(ec.params),
+    };
+};
+/**
+ * RxJS operator: filter session chunks by `kind` and project the payload.
+ * Use inside `pipeValue` — do not wrap as `(cycle$) => cycle$.pipeValue(...)`.
+ *
+ * `@rx-evo` wraps values in `NoInfer`, which breaks `Extract` type guards —
+ * callers narrow with a cast inside `project`.
+ */
+export const demuxByKind = (kind, project) => pipe(filter((chunk) => chunk.kind === kind), map(project));
+const asKind = (chunk) => chunk;
+const demuxLlmAgentPorts = (cycle$) => ({
+    reasoning$: cycle$.pipeValue(demuxByKind('reasoning', (chunk) => asKind(chunk).text)),
+    draftResponse$: cycle$.pipeValue(demuxByKind('draftResponse', (chunk) => asKind(chunk).text)),
+    toolLog$: cycle$.pipeValue(demuxByKind('toolLog', (chunk) => asKind(chunk).text)),
+    response$: cycle$.pipeValue(demuxByKind('response', (chunk) => asKind(chunk).text)),
+    subagent$: cycle$.pipeValue(demuxByKind('subagentSpawn', (chunk) => asKind(chunk).payload)),
+});
+/**
+ * Shared LLM session cycle (ADR-016): init context recreates the session;
+ * turn$ drives turn 0 + later turns with accumulated `messages[]`.
+ *
+ * All LLM nodes (openai / fake / critique / review / future) MUST use this —
+ * do not invent per-node cold-start `switchMap` history.
+ */
+export const createLlmSessionCycle$ = (context$, turn$, prepareSession, runTurn, options) => {
+    const primeTurn0 = options?.primeTurn0 ?? true;
+    return context$
+        .pipeValue(switchMap((context) => {
+        const prep = prepareSession(context);
+        return runLlmSessionMachine(context, turn$, prep, runTurn, primeTurn0);
+    }))
+        .pipe(shareReplay({ bufferSize: 1, refCount: true }));
+};
+/**
+ * Composer entry for OpenAI / Fake agent binds.
+ *
+ * Order:
+ * 1. make role inputs (userPrompt / systemPrompt / feedback)
+ * 2. assemble inventory context$ (+ provider extend)
+ * 3. ADR-016 feedback cycle$
+ * 4. demux chunk ports
+ * 5. configure standard outputs
+ */
+export const bindLlmAgentSession = (ctx, helpers, inventory, options) => {
+    const { makeInput, configureOutput, combineInputs } = helpers;
+    const { tools, mcp, subagentRegistration, subagentResult, steerControl } = inventory;
+    // 1. role inputs
+    const userPrompt = makeInput('userPrompt', {
+        name: 'userPrompt',
+        wireType: 'string',
+        inline: 'text-multiline',
+        required: true,
+    });
+    const systemPrompt = makeInput('systemPrompt', {
+        name: 'systemPrompt',
+        wireType: 'string',
+        inline: 'text-multiline',
+        defaultValue: '',
+    });
+    const feedback = makeInput('feedback', {
+        name: 'feedback',
+        wireType: 'string',
+        defaultValue: '',
+    });
+    // 2. inventory context$
+    const context$ = combineInputs([userPrompt, tools, subagentRegistration, mcp, systemPrompt, ctx], ([prompt, toolList, subagentList, mcpList, systemPromptValue, ec]) => {
+        const base = assembleLlmAgentInventoryContext(prompt, toolList, subagentList, mcpList, systemPromptValue, ec);
+        return {
+            ...options.extendContext(base, ec),
+            steerControl$: steerControl.value$,
+        };
+    });
+    // 3. feedback cycle$ (ADR-016 Soft↔Hard: primeTurn0)
+    const cycle$ = createLlmSessionCycle$(context$, feedback.value$, options.prepareSession, (context, turnFeedback, history, session) => options.runTurn(context, turnFeedback === undefined
+        ? undefined
+        : String(turnFeedback ?? ''), history, subagentResult.value$, session), { primeTurn0: true });
+    // 4. demux
+    const { reasoning$, draftResponse$, toolLog$, response$, subagent$ } = demuxLlmAgentPorts(cycle$);
+    // 5. outputs
+    return {
+        inputs: [userPrompt, systemPrompt, feedback],
+        outputs: [
+            configureOutput('reasoning', reasoning$, {
+                wireType: 'string',
+                feed: { role: 'reasoning', streaming: true },
+            }),
+            configureOutput('draftResponse', draftResponse$, {
+                wireType: 'string',
+                feed: { role: 'draft', streaming: true },
+            }),
+            configureOutput('response', response$, {
+                wireType: 'string',
+                feed: { role: 'result' },
+            }),
+        ],
+        inventoryOutputs: { toolLog$, subagent$ },
+    };
+};
+//# sourceMappingURL=llm-session-shell.js.map

package/vendor/common-nodes/dist/ai/llm-session-shell.js.map

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

package/vendor/common-nodes/dist/ai/mcp-server/node.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Emits one `mcp-server-config` for wiring into LLM `mcp` init ports.
+ * Runtime spawn/allowlist lives in `langflower.jsonc` `mcp.*` (server).
+ * Future CLI stdio spawn from the node: [docs/TODO/mcp-server-cli-stdio.md](../../../../../docs/TODO/mcp-server-cli-stdio.md).
+ */
+export declare const mcpServerNode: {
+    readonly emitOncePerActivation: boolean;
+    readonly stopsRun: boolean;
+    readonly chatEntry: boolean;
+    readonly uiSchema: readonly [];
+    readonly bypassPorts: Record<string, import("@langflower/runtime").RuntimeWireType>;
+    readonly inputsConfigs: readonly [import("@langflower/node-definitions").InputPortMeta<import("@langflower/node-definitions").ExecutionContext<readonly []>>, ...import("@langflower/node-definitions").InputPortMeta<unknown>[]];
+    readonly outputsConfigs: (({
+        readonly wireType: string;
+    } | {
+        readonly inferTypeFrom: import("@langflower/node-definitions").InputParams<unknown> | import("@rx-evo/stateful-observable").StatefulObservable<unknown, unknown, import("@langflower/runtime").PortMeta>;
+    }) & import("@langflower/node-definitions").OutputParams & import("@langflower/runtime").PortMeta)[];
+    readonly getInstance: () => import("@langflower/node-definitions").ReactiveNodeInstance<readonly []>;
+    readonly paletteSecondary?: true;
+    readonly description?: string;
+    readonly type: string;
+    readonly displayName: string;
+    readonly category: string | undefined;
+    readonly icon: string | undefined;
+};
+//# sourceMappingURL=node.d.ts.map

package/vendor/common-nodes/dist/ai/mcp-server/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/ai/mcp-server/node.ts"],"names":[],"mappings":"AAcA;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;CA0DxB,CAAC"}

package/vendor/common-nodes/dist/ai/mcp-server/node.js

@@ -0,0 +1,68 @@
+import { defineReactiveNode } from '@langflower/node-definitions';
+const parseToolNames = (raw) => {
+    if (typeof raw !== 'string') {
+        return [];
+    }
+    return raw
+        .split(/[,\s]+/)
+        .map((name) => name.trim())
+        .filter((name) => name.length > 0);
+};
+/**
+ * Emits one `mcp-server-config` for wiring into LLM `mcp` init ports.
+ * Runtime spawn/allowlist lives in `langflower.jsonc` `mcp.*` (server).
+ * Future CLI stdio spawn from the node: [docs/TODO/mcp-server-cli-stdio.md](../../../../../docs/TODO/mcp-server-cli-stdio.md).
+ */
+export const mcpServerNode = defineReactiveNode({
+    type: 'common-mcp-server',
+    displayName: 'MCP Server',
+    category: 'AI',
+    description: 'Emits an **mcp-server-config** for wiring into Fake LLM / OpenAI LLM `mcp` (init). Tools invoke via the internal loop when the server id is allowlisted in `langflower.jsonc`.',
+    uiSchema: [],
+    bind(_ctx, { makeInput, configureOutput, combineInputs }) {
+        const serverId = makeInput('serverId', {
+            name: 'serverId',
+            wireType: 'string',
+            inline: 'text',
+            defaultValue: 'echo',
+            required: true,
+        });
+        const name = makeInput('name', {
+            name: 'name',
+            wireType: 'string',
+            inline: 'text',
+            defaultValue: 'echo',
+            required: true,
+        });
+        const description = makeInput('description', {
+            name: 'description',
+            wireType: 'string',
+            inline: 'text',
+            defaultValue: 'Fixture MCP server',
+        });
+        const toolNames = makeInput('toolNames', {
+            name: 'toolNames',
+            wireType: 'string',
+            inline: 'text',
+            defaultValue: 'echo',
+        });
+        const config$ = combineInputs([serverId, name, description, toolNames], ([id, serverName, serverDescription, toolsRaw]) => {
+            const names = parseToolNames(toolsRaw);
+            return {
+                id: String(id ?? ''),
+                name: String(serverName ?? ''),
+                description: String(serverDescription ?? ''),
+                ...(names.length > 0 ? { toolNames: names } : {}),
+            };
+        });
+        return {
+            inputs: [serverId, name, description, toolNames],
+            outputs: [
+                configureOutput('mcpServer', config$, {
+                    wireType: 'mcp-server-config',
+                }),
+            ],
+        };
+    },
+});
+//# sourceMappingURL=node.js.map

package/vendor/common-nodes/dist/ai/mcp-server/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../../src/ai/mcp-server/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGlE,MAAM,cAAc,GAAG,CAAC,GAAY,EAAqB,EAAE;IAC1D,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC;IACX,CAAC;IAED,OAAO,GAAG;SACR,KAAK,CAAC,QAAQ,CAAC;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACrC,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,kBAAkB,CAAC;IAC/C,IAAI,EAAE,mBAAmB;IACzB,WAAW,EAAE,YAAY;IACzB,QAAQ,EAAE,IAAI;IACd,WAAW,EACV,gLAAgL;IACjL,QAAQ,EAAE,EAAW;IACrB,IAAI,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,aAAa,EAAE;QACvD,MAAM,QAAQ,GAAG,SAAS,CAAS,UAAU,EAAE;YAC9C,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,QAAQ;YAClB,MAAM,EAAE,MAAM;YACd,YAAY,EAAE,MAAM;YACpB,QAAQ,EAAE,IAAI;SACd,CAAC,CAAC;QACH,MAAM,IAAI,GAAG,SAAS,CAAS,MAAM,EAAE;YACtC,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,QAAQ;YAClB,MAAM,EAAE,MAAM;YACd,YAAY,EAAE,MAAM;YACpB,QAAQ,EAAE,IAAI;SACd,CAAC,CAAC;QACH,MAAM,WAAW,GAAG,SAAS,CAAS,aAAa,EAAE;YACpD,IAAI,EAAE,aAAa;YACnB,QAAQ,EAAE,QAAQ;YAClB,MAAM,EAAE,MAAM;YACd,YAAY,EAAE,oBAAoB;SAClC,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,SAAS,CAAS,WAAW,EAAE;YAChD,IAAI,EAAE,WAAW;YACjB,QAAQ,EAAE,QAAQ;YAClB,MAAM,EAAE,MAAM;YACd,YAAY,EAAE,MAAM;SACpB,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,aAAa,CAC5B,CAAC,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,EACxC,CAAC,CAAC,EAAE,EAAE,UAAU,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,EAAE;YACjD,MAAM,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;YAEvC,OAAO;gBACN,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;gBACpB,IAAI,EAAE,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;gBAC9B,WAAW,EAAE,MAAM,CAAC,iBAAiB,IAAI,EAAE,CAAC;gBAC5C,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvB,CAAC;QAC7B,CAAC,CACD,CAAC;QAEF,OAAO;YACN,MAAM,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC;YAChD,OAAO,EAAE;gBACR,eAAe,CAAC,WAAW,EAAE,OAAO,EAAE;oBACrC,QAAQ,EAAE,mBAAmB;iBAC7B,CAAC;aACF;SACD,CAAC;IACH,CAAC;CACD,CAAC,CAAC"}

package/vendor/common-nodes/dist/ai/mcp-server-config.d.ts

@@ -0,0 +1,16 @@
+/**
+ * MCP server registration on LLM `mcp` init ports (authoring / binding).
+ * Runtime spawn uses `langflower.jsonc` `mcp.servers` + `mcp.allowlist`;
+ * tools map into the same internal inventory as builtins (epic 16).
+ */
+export type McpServerConfig = {
+    readonly id: string;
+    readonly name: string;
+    readonly description?: string;
+    /**
+     * Author-declared tool names for Inspector `enabledToolIds` options.
+     * Runtime inventory comes from the live MCP `listTools` handshake.
+     */
+    readonly toolNames?: readonly string[];
+};
+//# sourceMappingURL=mcp-server-config.d.ts.map

package/vendor/common-nodes/dist/ai/mcp-server-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server-config.d.ts","sourceRoot":"","sources":["../../src/ai/mcp-server-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC,CAAC"}

package/vendor/common-nodes/dist/ai/mcp-server-config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mcp-server-config.js.map

package/vendor/common-nodes/dist/ai/mcp-server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server-config.js","sourceRoot":"","sources":["../../src/ai/mcp-server-config.ts"],"names":[],"mappings":""}

package/vendor/common-nodes/dist/ai/mcp-tool-id.d.ts

@@ -0,0 +1,11 @@
+/**
+ * MCP inventory ids — keep in sync with
+ * `packages/shared/src/langflower-config/mcp-tool-id.ts`
+ * (common-nodes must not import `@langflower/shared`).
+ */
+export declare const encodeMcpToolId: (serverId: string, toolName: string) => string;
+export declare const parseMcpToolId: (toolId: string) => {
+    readonly serverId: string;
+    readonly toolName: string;
+} | null;
+//# sourceMappingURL=mcp-tool-id.d.ts.map

package/vendor/common-nodes/dist/ai/mcp-tool-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool-id.d.ts","sourceRoot":"","sources":["../../src/ai/mcp-tool-id.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,EAAE,UAAU,MAAM,KAAG,MASpE,CAAC;AAEF,eAAO,MAAM,cAAc,GAC1B,QAAQ,MAAM,KACZ;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAe7D,CAAC"}

package/vendor/common-nodes/dist/ai/mcp-tool-id.js

@@ -0,0 +1,30 @@
+/**
+ * MCP inventory ids — keep in sync with
+ * `packages/shared/src/langflower-config/mcp-tool-id.ts`
+ * (common-nodes must not import `@langflower/shared`).
+ */
+const sanitizeMcpSegment = (raw) => raw
+    .trim()
+    .replace(/[^a-zA-Z0-9_-]+/g, '_')
+    .replace(/^_+|_+$/g, '');
+export const encodeMcpToolId = (serverId, toolName) => {
+    const server = sanitizeMcpSegment(serverId);
+    const tool = sanitizeMcpSegment(toolName);
+    if (server.length === 0 || tool.length === 0) {
+        return '';
+    }
+    return `mcp_${server}__${tool}`;
+};
+export const parseMcpToolId = (toolId) => {
+    const match = /^mcp_([a-zA-Z0-9-]+)__(.+)$/.exec(toolId.trim());
+    if (match === null) {
+        return null;
+    }
+    const serverId = match[1] ?? '';
+    const toolName = match[2] ?? '';
+    if (serverId.length === 0 || toolName.length === 0) {
+        return null;
+    }
+    return { serverId, toolName };
+};
+//# sourceMappingURL=mcp-tool-id.js.map

package/vendor/common-nodes/dist/ai/mcp-tool-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool-id.js","sourceRoot":"","sources":["../../src/ai/mcp-tool-id.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,kBAAkB,GAAG,CAAC,GAAW,EAAU,EAAE,CAClD,GAAG;KACD,IAAI,EAAE;KACN,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC;KAChC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AAE3B,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAgB,EAAE,QAAgB,EAAU,EAAE;IAC7E,MAAM,MAAM,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAE1C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9C,OAAO,EAAE,CAAC;IACX,CAAC;IAED,OAAO,OAAO,MAAM,KAAK,IAAI,EAAE,CAAC;AACjC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,CAC7B,MAAc,EACoD,EAAE;IACpE,MAAM,KAAK,GAAG,6BAA6B,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAEhE,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACb,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAEhC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,OAAO,IAAI,CAAC;IACb,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAC/B,CAAC,CAAC"}

package/vendor/common-nodes/dist/ai/merge-tool-inventory.d.ts

@@ -0,0 +1,10 @@
+import type { BuiltinToolRegistration } from '@langflower/node-definitions';
+import { type ToolRegistration } from './tool-registration.js';
+/**
+ * Merge harness builtins with wired registrations, then apply `enabledToolIds`.
+ * Builtins win on `toolId` collision (they are invokable via `ctx.harness`).
+ * Wired values may be single regs or arrays (domain packs) — flattened first.
+ * `enabledToolIds === undefined` → all; `[]` → none.
+ */
+export declare const mergeToolInventory: (builtins: readonly BuiltinToolRegistration[], wired: readonly unknown[], enabledToolIds: readonly string[] | undefined) => readonly ToolRegistration[];
+//# sourceMappingURL=merge-tool-inventory.d.ts.map

package/vendor/common-nodes/dist/ai/merge-tool-inventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-tool-inventory.d.ts","sourceRoot":"","sources":["../../src/ai/merge-tool-inventory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAE5E,OAAO,EAGN,KAAK,gBAAgB,EACrB,MAAM,wBAAwB,CAAC;AAEhC;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC9B,UAAU,SAAS,uBAAuB,EAAE,EAC5C,OAAO,SAAS,OAAO,EAAE,EACzB,gBAAgB,SAAS,MAAM,EAAE,GAAG,SAAS,KAC3C,SAAS,gBAAgB,EAuB3B,CAAC"}

package/vendor/common-nodes/dist/ai/merge-tool-inventory.js

@@ -0,0 +1,26 @@
+import { filterEnabledRegistrations } from './filter-enabled-registrations.js';
+import { flattenToolRegistrations, toolRegistrationId, } from './tool-registration.js';
+/**
+ * Merge harness builtins with wired registrations, then apply `enabledToolIds`.
+ * Builtins win on `toolId` collision (they are invokable via `ctx.harness`).
+ * Wired values may be single regs or arrays (domain packs) — flattened first.
+ * `enabledToolIds === undefined` → all; `[]` → none.
+ */
+export const mergeToolInventory = (builtins, wired, enabledToolIds) => {
+    const flatWired = flattenToolRegistrations(wired);
+    const byId = new Map();
+    for (const registration of flatWired) {
+        byId.set(registration.toolId, registration);
+    }
+    for (const builtin of builtins) {
+        byId.set(builtin.toolId, {
+            kind: 'harness',
+            toolId: builtin.toolId,
+            name: builtin.name,
+            description: builtin.description,
+            inputSchema: builtin.inputSchema,
+        });
+    }
+    return filterEnabledRegistrations([...byId.values()], enabledToolIds, toolRegistrationId);
+};
+//# sourceMappingURL=merge-tool-inventory.js.map

package/vendor/common-nodes/dist/ai/merge-tool-inventory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-tool-inventory.js","sourceRoot":"","sources":["../../src/ai/merge-tool-inventory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EACN,wBAAwB,EACxB,kBAAkB,GAElB,MAAM,wBAAwB,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CACjC,QAA4C,EAC5C,KAAyB,EACzB,cAA6C,EACf,EAAE;IAChC,MAAM,SAAS,GAAG,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEjD,KAAK,MAAM,YAAY,IAAI,SAAS,EAAE,CAAC;QACtC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAChC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE;YACxB,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,WAAW,EAAE,OAAO,CAAC,WAAW;SAChC,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,0BAA0B,CAChC,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAClB,cAAc,EACd,kBAAkB,CAClB,CAAC;AACH,CAAC,CAAC"}

package/vendor/common-nodes/dist/ai/normalize-max-iterations.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Normalize Inspector / param `maxIterations`.
+ * `0` = unlimited; invalid / negative → `fallback`; positive → floor + `maxCap`.
+ */
+export declare const normalizeMaxIterations: (value: unknown, options: {
+    readonly fallback: number;
+    readonly maxCap: number;
+}) => number;
+export declare const AGENT_MAX_ITERATIONS_CAP = 64;
+export declare const PATH_CHOICE_MAX_ITERATIONS_CAP = 32;
+export declare const DEFAULT_AGENT_MAX_ITERATIONS = 8;
+export declare const DEFAULT_PATH_CHOICE_MAX_ITERATIONS = 5;
+//# sourceMappingURL=normalize-max-iterations.d.ts.map

package/vendor/common-nodes/dist/ai/normalize-max-iterations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-max-iterations.d.ts","sourceRoot":"","sources":["../../src/ai/normalize-max-iterations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAClC,OAAO,OAAO,EACd,SAAS;IACR,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB,KACC,MAiBF,CAAC;AAEF,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,eAAO,MAAM,8BAA8B,KAAK,CAAC;AACjD,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAC9C,eAAO,MAAM,kCAAkC,IAAI,CAAC"}

package/vendor/common-nodes/dist/ai/normalize-max-iterations.js

@@ -0,0 +1,23 @@
+/**
+ * Normalize Inspector / param `maxIterations`.
+ * `0` = unlimited; invalid / negative → `fallback`; positive → floor + `maxCap`.
+ */
+export const normalizeMaxIterations = (value, options) => {
+    const n = typeof value === 'number' ? value : Number(value);
+    if (!Number.isFinite(n) || n < 0) {
+        return options.fallback;
+    }
+    if (n === 0) {
+        return 0;
+    }
+    const floored = Math.floor(n);
+    if (floored < 1) {
+        return options.fallback;
+    }
+    return Math.min(options.maxCap, floored);
+};
+export const AGENT_MAX_ITERATIONS_CAP = 64;
+export const PATH_CHOICE_MAX_ITERATIONS_CAP = 32;
+export const DEFAULT_AGENT_MAX_ITERATIONS = 8;
+export const DEFAULT_PATH_CHOICE_MAX_ITERATIONS = 5;
+//# sourceMappingURL=normalize-max-iterations.js.map

package/vendor/common-nodes/dist/ai/normalize-max-iterations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-max-iterations.js","sourceRoot":"","sources":["../../src/ai/normalize-max-iterations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACrC,KAAc,EACd,OAGC,EACQ,EAAE;IACX,MAAM,CAAC,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE5D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,OAAO,OAAO,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACb,OAAO,CAAC,CAAC;IACV,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QACjB,OAAO,OAAO,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AAC3C,MAAM,CAAC,MAAM,8BAA8B,GAAG,EAAE,CAAC;AACjD,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAC9C,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC"}