langflower 0.1.0 → 0.1.2

package/vendor/common-nodes/dist/ai/path-choice/control-tools.js

@@ -1,70 +0,0 @@
-/**
- * Path-choice control tools (accept / feedback). Must not be merged into shared
- * inventory or harness allowlists. Import only from `ai/review/` and
- * `ai/critique/`.
- */
-export const REVIEW_ACCEPT_TOOL = 'accept';
-export const REVIEW_FEEDBACK_TOOL = 'feedback';
-export const REVIEW_TOOL_REMINDER = 'You must finish by calling exactly one control tool: accept or feedback. Free-form text answers are not valid. Call accept to approve the artifact, or feedback with notes to send it back for revision.';
-/** Chat tool definitions injected only into path-choice completion calls. */
-export const REVIEW_CHAT_TOOLS = [
-    {
-        type: 'function',
-        function: {
-            name: REVIEW_ACCEPT_TOOL,
-            description: 'REQUIRED path when the artifact meets the task criteria. Call this tool to accept — never write a free-form approval. Optional notes may summarize why it passes. Exactly one of accept or feedback must be called to finish.',
-            parameters: {
-                type: 'object',
-                properties: {
-                    notes: {
-                        type: 'string',
-                        description: 'Optional short acceptance notes',
-                    },
-                },
-            },
-        },
-    },
-    {
-        type: 'function',
-        function: {
-            name: REVIEW_FEEDBACK_TOOL,
-            description: 'REQUIRED path when the artifact fails the task criteria. Call this tool with concrete revision notes — never write a free-form reject essay. Exactly one of accept or feedback must be called to finish.',
-            parameters: {
-                type: 'object',
-                properties: {
-                    notes: {
-                        type: 'string',
-                        description: 'Required revision notes for the upstream agent',
-                    },
-                },
-                required: ['notes'],
-            },
-        },
-    },
-];
-export const notesFromControlToolArgs = (args) => {
-    const notes = args.notes;
-    if (typeof notes === 'string') {
-        return notes;
-    }
-    const feedback = args.feedback;
-    if (typeof feedback === 'string') {
-        return feedback;
-    }
-    if (typeof args.__raw === 'string') {
-        return args.__raw;
-    }
-    return '';
-};
-export const findControlToolCall = (toolCalls) => {
-    for (const call of toolCalls) {
-        if (call.name === REVIEW_ACCEPT_TOOL) {
-            return { kind: 'accept', call };
-        }
-        if (call.name === REVIEW_FEEDBACK_TOOL) {
-            return { kind: 'feedback', call };
-        }
-    }
-    return undefined;
-};
-export const isReviewControlToolName = (name) => name === REVIEW_ACCEPT_TOOL || name === REVIEW_FEEDBACK_TOOL;

package/vendor/common-nodes/dist/ai/path-choice/run-path-choice-tool-loop.d.ts

@@ -1,54 +0,0 @@
-import type { Harness } from '@langflower/tools/create-project-harness';
-import type { ToolHandlerContext } from '@langflower/tools/domain-tool-configs';
-import type { ChatCompletionMessage, CreateChatCompletionStream } from '../chat-completion-stream.js';
-import { type Observable as RxObservable } from 'rxjs';
-import type { SubAgentRegistration, SubAgentSpawnPayload } from '../sub-agent-protocol.js';
-import type { ToolHandle } from '@langflower/node-sdk';
-import type { LlmCompactionConfig } from '../openai/normalize-compaction-params.js';
-export type ReviewLoopChunk = {
-    readonly kind: 'reasoning';
-    readonly text: string;
-} | {
-    readonly kind: 'draftResponse';
-    readonly text: string;
-} | {
-    readonly kind: 'toolLog';
-    readonly text: string;
-} | {
-    readonly kind: 'reminder';
-    readonly text: string;
-} | {
-    readonly kind: 'historySync';
-    readonly messages: readonly ChatCompletionMessage[];
-} | {
-    readonly kind: 'accept';
-    readonly notes: string;
-} | {
-    readonly kind: 'feedback';
-    readonly notes: string;
-} | {
-    readonly kind: 'subagentSpawn';
-    readonly payload: SubAgentSpawnPayload;
-};
-/**
- * Review control-tool loop: optional inventory tools (+ MCP) and optional
- * `spawn_subagent` via ToolHandle.invoke, then forced `accept` / `feedback`
- * (port-routed; no chat tool-result after control call).
- *
- * Control tools are ephemeral on the completion `tools` list only — never
- * written into shared inventory.
- */
-export declare const runPathChoiceToolLoop: (args: {
-    readonly factory: CreateChatCompletionStream;
-    readonly providerId: string;
-    readonly model: string;
-    readonly messages: readonly ChatCompletionMessage[];
-    readonly maxIterations: number;
-    readonly tools?: readonly ToolHandle[];
-    readonly harness?: Harness;
-    readonly toolCtx?: ToolHandlerContext;
-    readonly subagentRegistrations?: readonly SubAgentRegistration[];
-    readonly compaction?: LlmCompactionConfig;
-    readonly waitForSubagentResult?: (callId: string, signal: AbortSignal) => Promise<string>;
-}) => RxObservable<ReviewLoopChunk>;
-//# sourceMappingURL=run-path-choice-tool-loop.d.ts.map

package/vendor/common-nodes/dist/ai/path-choice/run-path-choice-tool-loop.js

@@ -1,242 +0,0 @@
-import { Observable } from 'rxjs';
-import { buildSpawnSubagentChatTool, invokeInventoryTool, parseToolArgs, previewToolLogText, runSpawnSubagentRound, SPAWN_SUBAGENT_TOOL, toChatToolDefinitions, } from '../../tools/inventory-tool-round.js';
-import { findControlToolCall, isReviewControlToolName, notesFromControlToolArgs, REVIEW_CHAT_TOOLS, REVIEW_TOOL_REMINDER, } from './control-tools.js';
-import { prepareChatCompletion } from '../openai/prepare-chat-completion.js';
-import { DISABLED_COMPACTION_CONFIG } from '../openai/normalize-compaction-params.js';
-/**
- * Review control-tool loop: optional inventory tools (+ MCP) and optional
- * `spawn_subagent` via ToolHandle.invoke, then forced `accept` / `feedback`
- * (port-routed; no chat tool-result after control call).
- *
- * Control tools are ephemeral on the completion `tools` list only — never
- * written into shared inventory.
- */
-export const runPathChoiceToolLoop = (args) => new Observable((subscriber) => {
-    const abort = new AbortController();
-    const inventory = args.tools ?? [];
-    const subagentRegistrations = args.subagentRegistrations ?? [];
-    // Ephemeral: control tools + inventory for this Review completion only.
-    const chatTools = [
-        ...REVIEW_CHAT_TOOLS,
-        ...toChatToolDefinitions(inventory),
-        ...(subagentRegistrations.length > 0
-            ? [buildSpawnSubagentChatTool(subagentRegistrations)]
-            : []),
-    ];
-    const compaction = args.compaction ?? DISABLED_COMPACTION_CONFIG;
-    void (async () => {
-        let messages = [...args.messages];
-        let nonComplianceCount = 0;
-        let toolRounds = 0;
-        let openSpawnCallId;
-        try {
-            while (nonComplianceCount < args.maxIterations) {
-                if (abort.signal.aborted) {
-                    return;
-                }
-                const prepared = await prepareChatCompletion({
-                    factory: args.factory,
-                    providerId: args.providerId,
-                    model: args.model,
-                    messages,
-                    tools: chatTools,
-                    signal: abort.signal,
-                    compaction,
-                });
-                if (!prepared.ok) {
-                    if (!abort.signal.aborted) {
-                        subscriber.error(prepared.error);
-                    }
-                    return;
-                }
-                messages = [...prepared.messages];
-                if (prepared.compaction !== undefined) {
-                    subscriber.next({
-                        kind: 'toolLog',
-                        text: `Compacted history (${prepared.compaction.reason}): ~${prepared.compaction.beforeTokens} → ~${prepared.compaction.afterTokens} approx tokens`,
-                    });
-                    subscriber.next({
-                        kind: 'historySync',
-                        messages: [...messages],
-                    });
-                }
-                const stream = prepared.stream;
-                let fullText = '';
-                let toolCalls;
-                for await (const chunk of stream) {
-                    if (abort.signal.aborted) {
-                        return;
-                    }
-                    if (chunk.kind === 'reasoning') {
-                        subscriber.next({
-                            kind: 'reasoning',
-                            text: chunk.text,
-                        });
-                    }
-                    else if (chunk.kind === 'draft') {
-                        fullText += chunk.text;
-                        subscriber.next({
-                            kind: 'draftResponse',
-                            text: chunk.text,
-                        });
-                    }
-                    else if (chunk.kind === 'done') {
-                        fullText =
-                            chunk.text.length > 0 ? chunk.text : fullText;
-                        toolCalls = chunk.tool_calls;
-                    }
-                }
-                const control = toolCalls !== undefined && toolCalls.length > 0
-                    ? findControlToolCall(toolCalls)
-                    : undefined;
-                if (control !== undefined) {
-                    const notes = notesFromControlToolArgs(parseToolArgs(control.call.arguments));
-                    // Persist control tool call into history so the shared
-                    // session cycle (ADR-016) can continue across packet /
-                    // result turns without a cold start.
-                    messages = [
-                        ...messages,
-                        {
-                            role: 'assistant',
-                            content: fullText,
-                            tool_calls: [control.call],
-                        },
-                        {
-                            role: 'tool',
-                            tool_call_id: control.call.id,
-                            content: notes,
-                        },
-                    ];
-                    subscriber.next({
-                        kind: 'historySync',
-                        messages: [...messages],
-                    });
-                    subscriber.next({
-                        kind: 'toolLog',
-                        text: `→ ${control.call.name}(${previewToolLogText(control.call.arguments)})`,
-                    });
-                    if (control.kind === 'accept') {
-                        subscriber.next({ kind: 'accept', notes });
-                    }
-                    else {
-                        subscriber.next({ kind: 'feedback', notes });
-                    }
-                    subscriber.complete();
-                    return;
-                }
-                const inventoryCalls = (toolCalls ?? []).filter((call) => !isReviewControlToolName(call.name));
-                if (inventoryCalls.length > 0) {
-                    toolRounds += 1;
-                    if (toolRounds > args.maxIterations) {
-                        subscriber.error(new Error(`Review exceeded ${args.maxIterations} inventory tool rounds without accept/feedback.`));
-                        return;
-                    }
-                    const toolResults = [];
-                    for (const call of inventoryCalls) {
-                        subscriber.next({
-                            kind: 'toolLog',
-                            text: `→ ${call.name}(${previewToolLogText(call.arguments)})`,
-                        });
-                        let resultText;
-                        let loggedResult = false;
-                        if (call.name === SPAWN_SUBAGENT_TOOL) {
-                            const spawn = await runSpawnSubagentRound({
-                                call,
-                                registrations: subagentRegistrations,
-                                openSpawnCallId,
-                                ...(args.waitForSubagentResult !==
-                                    undefined
-                                    ? {
-                                        waitForSubagentResult: args.waitForSubagentResult,
-                                    }
-                                    : {}),
-                                signal: abort.signal,
-                                onSpawn: (payload) => {
-                                    openSpawnCallId = payload.callId;
-                                    subscriber.next({
-                                        kind: 'subagentSpawn',
-                                        payload,
-                                    });
-                                },
-                                onWaiting: (callId) => {
-                                    subscriber.next({
-                                        kind: 'toolLog',
-                                        text: `… waiting for subagentResult callId=${callId}`,
-                                    });
-                                },
-                            });
-                            if (spawn.aborted) {
-                                return;
-                            }
-                            openSpawnCallId = undefined;
-                            resultText = spawn.resultText;
-                        }
-                        else {
-                            const result = await invokeInventoryTool(args.harness, inventory, call, args.toolCtx, {
-                                notInAllowlistText: (toolName) => `Tool «${toolName}» is not in the Review tools allowlist.`,
-                            });
-                            resultText = result.text;
-                            subscriber.next({
-                                kind: 'toolLog',
-                                text: result.ok
-                                    ? `← ${previewToolLogText(result.text)}`
-                                    : `✗ ${previewToolLogText(result.text)}`,
-                            });
-                            loggedResult = true;
-                        }
-                        if (!loggedResult) {
-                            subscriber.next({
-                                kind: 'toolLog',
-                                text: resultText.startsWith('Error:')
-                                    ? `✗ ${previewToolLogText(resultText)}`
-                                    : `← ${previewToolLogText(resultText)}`,
-                            });
-                        }
-                        toolResults.push({
-                            role: 'tool',
-                            tool_call_id: call.id,
-                            content: resultText,
-                        });
-                    }
-                    messages = [
-                        ...messages,
-                        {
-                            role: 'assistant',
-                            content: fullText,
-                            tool_calls: inventoryCalls,
-                        },
-                        ...toolResults,
-                    ];
-                    continue;
-                }
-                nonComplianceCount += 1;
-                const assistantContent = fullText.trim().length > 0
-                    ? fullText
-                    : '(no text; missing accept/feedback tool call)';
-                messages = [
-                    ...messages,
-                    { role: 'assistant', content: assistantContent },
-                    { role: 'user', content: REVIEW_TOOL_REMINDER },
-                ];
-                subscriber.next({
-                    kind: 'reminder',
-                    text: REVIEW_TOOL_REMINDER,
-                });
-                subscriber.next({
-                    kind: 'toolLog',
-                    text: `⚠ ${REVIEW_TOOL_REMINDER}`,
-                });
-            }
-            subscriber.error(new Error(`Review failed after ${args.maxIterations} completions without accept or feedback (forced tool use).`));
-        }
-        catch (error) {
-            if (!abort.signal.aborted) {
-                subscriber.error(error);
-            }
-        }
-    })();
-    return () => {
-        abort.abort();
-    };
-});
-//# sourceMappingURL=run-path-choice-tool-loop.js.map

package/vendor/common-nodes/dist/ai/path-choice/run-reactive-path-choice-loop.d.ts

@@ -1,35 +0,0 @@
-import type { ToolHandle } from '@langflower/node-sdk';
-import type { SteerControlPayload } from '@langflower/node-sdk/llm';
-import type { Harness } from '@langflower/tools/create-project-harness';
-import type { ToolHandlerContext } from '@langflower/tools/domain-tool-configs';
-import type { Observable } from 'rxjs';
-import type { ChatCompletionMessage, CreateChatCompletionStream } from '../chat-completion-stream.js';
-import type { SubAgentRegistration } from '../sub-agent-protocol.js';
-import type { LlmCompactionConfig } from '../openai/normalize-compaction-params.js';
-import { type LlmRecoveryPolicy } from '../llm-loop/llm-loop-types.js';
-import { type SharedLlmLoopChunk } from '../llm-loop/run-llm-loop.js';
-export type ReviewLoopChunk = SharedLlmLoopChunk | {
-    readonly kind: 'reminder';
-    readonly text: string;
-} | {
-    readonly kind: 'accept';
-    readonly notes: string;
-} | {
-    readonly kind: 'feedback';
-    readonly notes: string;
-};
-export declare const runPathChoiceToolLoop: (args: {
-    readonly factory: CreateChatCompletionStream;
-    readonly providerId: string;
-    readonly model: string;
-    readonly messages: readonly ChatCompletionMessage[];
-    readonly maxIterations: number;
-    readonly tools?: readonly ToolHandle[];
-    readonly harness?: Harness;
-    readonly toolCtx?: ToolHandlerContext;
-    readonly subagentRegistrations?: readonly SubAgentRegistration[];
-    readonly compaction?: LlmCompactionConfig;
-    readonly recovery?: LlmRecoveryPolicy;
-    readonly steerControl$?: Observable<SteerControlPayload>;
-    readonly waitForSubagentResult?: (callId: string, signal: AbortSignal) => Promise<string>;
-}) => Observable<ReviewLoopChunk>;

package/vendor/common-nodes/dist/ai/path-choice/run-reactive-path-choice-loop.js

@@ -1,106 +0,0 @@
-import { buildSpawnSubagentChatTool, parseToolArgs, previewToolLogText, toChatToolDefinitions, } from '../../tools/inventory-tool-round.js';
-import { DISABLED_COMPACTION_CONFIG } from '../openai/normalize-compaction-params.js';
-import { DEFAULT_LLM_RECOVERY_POLICY, } from '../llm-loop/llm-loop-types.js';
-import { runLlmLoop, } from '../llm-loop/run-llm-loop.js';
-import { findControlToolCall, isReviewControlToolName, notesFromControlToolArgs, REVIEW_CHAT_TOOLS, REVIEW_TOOL_REMINDER, } from './control-tools.js';
-const PATH_CHOICE_POLICY = {
-    decideCompletion: ({ state, text, toolCalls }) => {
-        // Pre-tool base — never mid-scan committedMessages (orphan tool_calls).
-        const base = state.roundCheckpoint;
-        const control = findControlToolCall(toolCalls);
-        if (control !== undefined) {
-            const notes = notesFromControlToolArgs(parseToolArgs(control.call.arguments));
-            const messages = [
-                ...base,
-                {
-                    role: 'assistant',
-                    content: text,
-                    tool_calls: [control.call],
-                },
-                {
-                    role: 'tool',
-                    tool_call_id: control.call.id,
-                    content: notes,
-                },
-            ];
-            return {
-                kind: 'complete',
-                chunks: [
-                    { kind: 'historySync', messages },
-                    {
-                        kind: 'toolLog',
-                        text: `→ ${control.call.name}(${previewToolLogText(control.call.arguments)})`,
-                    },
-                    control.kind === 'accept'
-                        ? { kind: 'accept', notes }
-                        : { kind: 'feedback', notes },
-                ],
-            };
-        }
-        const inventoryCalls = toolCalls.filter((call) => !isReviewControlToolName(call.name));
-        if (inventoryCalls.length > 0) {
-            return { kind: 'run-tools', calls: inventoryCalls };
-        }
-        const assistantContent = text.trim().length > 0
-            ? text
-            : '(no text; missing accept/feedback tool call)';
-        return {
-            kind: 'continue',
-            messages: [
-                ...base,
-                { role: 'assistant', content: assistantContent },
-                { role: 'user', content: REVIEW_TOOL_REMINDER },
-            ],
-            chunks: [
-                { kind: 'reminder', text: REVIEW_TOOL_REMINDER },
-                {
-                    kind: 'toolLog',
-                    text: `⚠ ${REVIEW_TOOL_REMINDER}`,
-                },
-            ],
-        };
-    },
-    toolNotAllowedText: (toolName) => `Tool «${toolName}» is not in the Review tools allowlist.`,
-    maxIterationsFailure: (maxIterations) => ({
-        kind: 'fail',
-        failure: {
-            kind: 'protocol',
-            message: `Review failed after ${maxIterations} completions ` +
-                'without accept or feedback (forced tool use).',
-            recoverable: false,
-        },
-    }),
-};
-export const runPathChoiceToolLoop = (args) => {
-    const inventory = args.tools ?? [];
-    const subagentRegistrations = args.subagentRegistrations ?? [];
-    return runLlmLoop({
-        factory: args.factory,
-        providerId: args.providerId,
-        model: args.model,
-        messages: args.messages,
-        maxIterations: args.maxIterations,
-        inventoryTools: inventory,
-        chatTools: [
-            ...REVIEW_CHAT_TOOLS,
-            ...toChatToolDefinitions(inventory),
-            ...(subagentRegistrations.length > 0
-                ? [buildSpawnSubagentChatTool(subagentRegistrations)]
-                : []),
-        ],
-        compaction: args.compaction ?? DISABLED_COMPACTION_CONFIG,
-        recovery: args.recovery ?? DEFAULT_LLM_RECOVERY_POLICY,
-        policy: PATH_CHOICE_POLICY,
-        subagentRegistrations,
-        ...(args.harness !== undefined ? { harness: args.harness } : {}),
-        ...(args.toolCtx !== undefined ? { toolCtx: args.toolCtx } : {}),
-        ...(args.steerControl$ !== undefined
-            ? { steerControl$: args.steerControl$ }
-            : {}),
-        ...(args.waitForSubagentResult !== undefined
-            ? {
-                waitForSubagentResult: args.waitForSubagentResult,
-            }
-            : {}),
-    });
-};

package/vendor/common-nodes/dist/ai/resolve-chat-provider-model.d.ts

@@ -1,10 +0,0 @@
-/**
- * Resolve chat provider/model from node params with optional host default
- * (`LangflowerConfig.model` parsed into {@link RunHostServices.defaultChat}).
- */
-import type { RunHostServices } from './run-host-services.js';
-export type ResolvedChatProviderModel = {
-    readonly providerId: string;
-    readonly model: string;
-};
-export declare const resolveChatProviderModel: (params: Readonly<Record<string, unknown>>, host: RunHostServices | undefined) => ResolvedChatProviderModel;

package/vendor/common-nodes/dist/ai/resolve-chat-provider-model.js

@@ -1,8 +0,0 @@
-export const resolveChatProviderModel = (params, host) => {
-    const fromParamsProvider = String(params['providerId'] ?? '').trim();
-    const fromParamsModel = String(params['model'] ?? '').trim();
-    return {
-        providerId: fromParamsProvider || host?.defaultChat?.providerId || '',
-        model: fromParamsModel || host?.defaultChat?.model || '',
-    };
-};

package/vendor/common-nodes/dist/ai/resolve-mcp-inventory.d.ts

@@ -1,8 +0,0 @@
-import type { BuiltinToolRegistration } from '@langflower/node-definitions';
-import type { McpServerConfig } from './mcp-server-config.js';
-/**
- * Filter harness MCP registrations to servers wired on the `mcp` init port.
- * Optional `toolNames` on the wire further narrows the allowlist.
- */
-export declare const resolveMcpInventory: (harnessMcp: readonly BuiltinToolRegistration[], wiredServers: readonly McpServerConfig[]) => readonly BuiltinToolRegistration[];
-//# sourceMappingURL=resolve-mcp-inventory.d.ts.map

package/vendor/common-nodes/dist/ai/resolve-mcp-inventory.js

@@ -1,43 +0,0 @@
-import { encodeMcpToolId, parseMcpToolId, } from '@langflower/tools/mcp-tool-id';
-/**
- * Filter harness MCP registrations to servers wired on the `mcp` init port.
- * Optional `toolNames` on the wire further narrows the allowlist.
- */
-export const resolveMcpInventory = (harnessMcp, wiredServers) => {
-    if (wiredServers.length === 0 || harnessMcp.length === 0) {
-        return [];
-    }
-    const byServer = new Map();
-    for (const server of wiredServers) {
-        const id = server.id.trim();
-        if (id.length === 0) {
-            continue;
-        }
-        const names = server.toolNames
-            ?.map((name) => name.trim())
-            .filter((name) => name.length > 0);
-        if (names === undefined || names.length === 0) {
-            byServer.set(id, 'all');
-            continue;
-        }
-        const encoded = new Set(names
-            .map((name) => encodeMcpToolId(id, name))
-            .filter((toolId) => toolId.length > 0));
-        byServer.set(id, encoded);
-    }
-    return harnessMcp.filter((registration) => {
-        const parsed = parseMcpToolId(registration.toolId);
-        if (parsed === null) {
-            return false;
-        }
-        const allow = byServer.get(parsed.serverId);
-        if (allow === undefined) {
-            return false;
-        }
-        if (allow === 'all') {
-            return true;
-        }
-        return allow.has(registration.toolId);
-    });
-};
-//# sourceMappingURL=resolve-mcp-inventory.js.map