langflower 0.1.0 → 0.1.2

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

@@ -1,189 +0,0 @@
-import { toLlmRecoveryPortValue, } from '@langflower/node-sdk/llm';
-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 { resolveChatProviderModel } from './resolve-chat-provider-model.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. */
-export 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),
-        ...resolveChatProviderModel(ec.params, hostServices),
-        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),
-        ...(hostServices?.requestPermission !== undefined
-            ? { requestPermission: hostServices.requestPermission }
-            : {}),
-        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)),
-    recovery$: cycle$.pipeValue(demuxByKind('recoveryNotice', (chunk) => {
-        const notice = asKind(chunk);
-        return toLlmRecoveryPortValue(notice);
-    })),
-    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',
-        multi: 'merge',
-        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$, recovery$, 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$, recovery$, subagent$ },
-    };
-};

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

@@ -1,26 +0,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 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.js

@@ -1,68 +0,0 @@
-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-config.d.ts

@@ -1,16 +0,0 @@
-/**
- * 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.js

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

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

@@ -1,11 +0,0 @@
-/**
- * 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.js

@@ -1,30 +0,0 @@
-/**
- * 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/merge-tool-inventory.d.ts

@@ -1,10 +0,0 @@
-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.js

@@ -1,26 +0,0 @@
-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