langflower 0.0.7 → 0.0.9

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

@@ -0,0 +1,302 @@
+import { defineLlmNode, isSteerControlPayload, toLlmRecoveryPortValue, } from '@langflower/node-sdk/llm';
+import { concat, EMPTY, filter, mergeMap, Observable, of, } from 'rxjs';
+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 { 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';
+import { getRunHostServices } from '../../features/run-host-services.js';
+import { buildEffectiveSystemPrompt } from '../../features/prompt/build-effective-system-prompt.js';
+import { normalizeCompactionConfig } from '../../features/openai/normalize-compaction-params.js';
+import { normalizeLlmRecoveryPolicy } from '../../features/llm-loop/normalize-llm-recovery-policy.js';
+import { createScriptedFactory, parseScriptedTurns, } from '../../features/scripted-chat-completion-stream.js';
+const normalizeSkillIds = (raw) => {
+    if (!Array.isArray(raw)) {
+        return [];
+    }
+    return raw
+        .map((entry) => String(entry ?? '').trim())
+        .filter((entry) => entry.length > 0);
+};
+const acceptSpawn = (raw, nodeId, skillIds) => {
+    if (!isSubAgentSpawnPayload(raw)) {
+        return null;
+    }
+    if (raw.nodeId !== nodeId) {
+        return null;
+    }
+    if (raw.skillId.length > 0 && !skillIds.includes(raw.skillId)) {
+        return null;
+    }
+    return raw;
+};
+const formatSpawnUserContent = (spawn) => {
+    if (spawn.skillId.length === 0) {
+        return spawn.task;
+    }
+    return `[skill:${spawn.skillId}]\n${spawn.task}`;
+};
+const resolveTurnFactory = (context) => {
+    if (context.scriptedTurns !== undefined) {
+        return createScriptedFactory(context.scriptedTurns);
+    }
+    return context.factory;
+};
+const requireChatConfig = (providerId, model, scripted) => {
+    if (scripted) {
+        return;
+    }
+    if (providerId.trim().length === 0) {
+        throw new Error('Provider is required for Sub-Agent chat');
+    }
+    if (model.trim().length === 0) {
+        throw new Error('Model is required for Sub-Agent chat');
+    }
+};
+const runSubAgentTurn = (context, spawn, history, subagentResult$) => {
+    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'));
+        });
+    }
+    requireChatConfig(context.providerId, context.model, scripted);
+    return concat(of({
+        kind: 'historySync',
+        messages: [
+            ...history,
+            {
+                role: 'user',
+                content: formatSpawnUserContent(spawn),
+            },
+        ],
+    }), runAgentLoop({
+        factory,
+        providerId: scripted
+            ? context.providerId.trim() || 'scripted'
+            : context.providerId,
+        model: scripted
+            ? context.model.trim() || 'scripted'
+            : context.model,
+        messages: [
+            ...history,
+            { role: 'user', content: formatSpawnUserContent(spawn) },
+        ],
+        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 !== 'response') {
+            return of(chunk);
+        }
+        return of(chunk, {
+            kind: 'subagentResult',
+            payload: {
+                callId: spawn.callId,
+                result: chunk.text,
+            },
+        });
+    })));
+};
+/**
+ * Sub-Agent: ordinary OpenAI-compatible agent plus `registration` announce.
+ * Parent spawn arrives on `task`; final text returns on `result` with callId.
+ * @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.',
+    uiSchema: [
+        {
+            field: 'name',
+            type: 'string',
+            label: 'Name',
+            default: 'Sub-Agent',
+        },
+        {
+            field: 'description',
+            type: 'string',
+            label: 'Description',
+            default: '',
+        },
+        {
+            field: 'skillIds',
+            type: 'tool-id-list',
+            label: 'Skills',
+            optionsSource: 'langflower.skills',
+        },
+        ...llmPanelUiSchema,
+        ...llmCompactionUiSchema,
+        ...llmRecoveryUiSchema,
+    ],
+    bind(ctx, { makeInput, configureOutput, combineInputs }, inventory) {
+        const { tools, mcp, subagentRegistration, subagentResult, 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 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: '',
+                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: normalizeMaxIterations(ec.params.maxIterations, {
+                    fallback: DEFAULT_AGENT_MAX_ITERATIONS,
+                    maxCap: AGENT_MAX_ITERATIONS_CAP,
+                }),
+                maxFeedbackTurns: 0,
+                ...(hostServices?.requestPermission !== undefined
+                    ? {
+                        requestPermission: hostServices.requestPermission,
+                    }
+                    : {}),
+                compaction: normalizeCompactionConfig(ec.params),
+                recovery: normalizeLlmRecoveryPolicy(ec.params),
+                steerControl$: steerControl.value$.pipe(filter(isSteerControlPayload)),
+                factory: hostServices?.createChatCompletionStream,
+                scriptedTurns: parseScriptedTurns(ec.params['scriptedToolTurns']),
+                nodeId: ec.nodeId,
+                skillIds: normalizeSkillIds(ec.params.skillIds),
+            };
+        });
+        const cycle$ = createLlmSessionCycle$(context$, task.value$, (context) => ({
+            history: [
+                {
+                    role: 'system',
+                    content: appendToolInventory(context.effectiveSystemPrompt, context.tools),
+                },
+            ],
+            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
+            .text));
+        const toolLog$ = cycle$.pipeValue(demuxByKind('toolLog', (chunk) => chunk.text));
+        const recovery$ = cycle$.pipeValue(demuxByKind('recoveryNotice', (chunk) => {
+            const notice = chunk;
+            return toLlmRecoveryPortValue(notice);
+        }));
+        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],
+            outputs: [
+                configureOutput('registration', registration$, {
+                    wireType: SUBAGENT_REGISTRATION_WIRE_TYPE,
+                }),
+                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' },
+                }),
+                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/ai/openai/create-chat-completion-stream.js

@@ -124,6 +124,12 @@ export const createChatCompletionStream = (deps) => {
                 messages: toOpenAiMessages(args.messages),
                 stream: true,
                 ...(tools !== undefined ? { tools } : {}),
+                ...(args.frequency_penalty !== undefined
+                    ? { frequency_penalty: args.frequency_penalty }
+                    : {}),
+                ...(args.presence_penalty !== undefined
+                    ? { presence_penalty: args.presence_penalty }
+                    : {}),
             }, {
                 signal: args.signal,
             }));

package/vendor/common-nodes/dist/ai/openai/prepare-chat-completion.d.ts

@@ -25,4 +25,6 @@ export declare const prepareChatCompletion: (args: {
     readonly tools?: readonly ChatCompletionToolDefinition[];
     readonly signal?: AbortSignal;
     readonly compaction?: LlmCompactionConfig;
+    readonly frequency_penalty?: number;
+    readonly presence_penalty?: number;
 }) => Promise<PreparedChatCompletion>;

package/vendor/common-nodes/dist/ai/openai/prepare-chat-completion.js

@@ -7,6 +7,12 @@ const createMainStream = async (args) => args.factory({
     messages: args.messages,
     ...(args.tools.length > 0 ? { tools: args.tools } : {}),
     ...(args.signal !== undefined ? { signal: args.signal } : {}),
+    ...(args.frequency_penalty !== undefined
+        ? { frequency_penalty: args.frequency_penalty }
+        : {}),
+    ...(args.presence_penalty !== undefined
+        ? { presence_penalty: args.presence_penalty }
+        : {}),
 });
 /**
  * Proactive + compact-on-error gate before consuming a chat stream.
@@ -49,6 +55,12 @@ export const prepareChatCompletion = async (args) => {
             messages,
             tools,
             ...(args.signal !== undefined ? { signal: args.signal } : {}),
+            ...(args.frequency_penalty !== undefined
+                ? { frequency_penalty: args.frequency_penalty }
+                : {}),
+            ...(args.presence_penalty !== undefined
+                ? { presence_penalty: args.presence_penalty }
+                : {}),
         });
         return {
             ok: true,
@@ -96,6 +108,12 @@ export const prepareChatCompletion = async (args) => {
                 messages,
                 tools,
                 ...(args.signal !== undefined ? { signal: args.signal } : {}),
+                ...(args.frequency_penalty !== undefined
+                    ? { frequency_penalty: args.frequency_penalty }
+                    : {}),
+                ...(args.presence_penalty !== undefined
+                    ? { presence_penalty: args.presence_penalty }
+                    : {}),
             });
             return {
                 ok: true,

package/vendor/common-nodes/dist/ai/openai-llm/node.d.ts

@@ -115,6 +115,88 @@ export declare const openAiLlmNode: {
         readonly min: 0;
         readonly max: 32;
         readonly step: 1;
+    }, {
+        readonly field: "autokickOnIdle";
+        readonly type: "boolean";
+        readonly label: "Autokick on idle and dead-loop";
+        readonly default: boolean;
+    }, {
+        readonly field: "deadLoopEnabled";
+        readonly type: "boolean";
+        readonly label: "Detect repetition dead loops";
+        readonly default: boolean;
+    }, {
+        readonly field: "maxAutokickAttempts";
+        readonly type: "number";
+        readonly label: "Max autokick reconnects (0 = unlimited)";
+        readonly default: number;
+        readonly min: 0;
+        readonly max: 1000;
+        readonly step: 1;
+    }, {
+        readonly field: "autokickBackoffMs";
+        readonly type: "number";
+        readonly label: "Autokick backoff base (ms)";
+        readonly default: number;
+        readonly min: 1000;
+        readonly step: 1000;
+    }, {
+        readonly field: "autokickMaxBackoffMs";
+        readonly type: "number";
+        readonly label: "Autokick backoff clamp (ms)";
+        readonly default: number;
+        readonly min: 1000;
+        readonly step: 1000;
+    }, {
+        readonly field: "autokickUserMessage";
+        readonly type: "string";
+        readonly label: "Autokick kick message";
+        readonly default: string;
+    }, {
+        readonly field: "autokickPenaltyFrequency";
+        readonly type: "number";
+        readonly label: "Autokick frequency_penalty delta";
+        readonly default: number;
+        readonly min: -2;
+        readonly max: 2;
+        readonly step: 0.1;
+    }, {
+        readonly field: "autokickPenaltyPresence";
+        readonly type: "number";
+        readonly label: "Autokick presence_penalty delta";
+        readonly default: number;
+        readonly min: -2;
+        readonly max: 2;
+        readonly step: 0.1;
+    }, {
+        readonly field: "deadLoopMaxWindowTokens";
+        readonly type: "number";
+        readonly label: "Dead-loop window (tokens)";
+        readonly default: number;
+        readonly min: 10;
+        readonly max: 8000;
+        readonly step: 1;
+    }, {
+        readonly field: "deadLoopConsecutiveThreshold";
+        readonly type: "number";
+        readonly label: "Dead-loop consecutive identical deltas";
+        readonly default: number;
+        readonly min: 1;
+        readonly step: 1;
+    }, {
+        readonly field: "deadLoopMinRepetitions";
+        readonly type: "number";
+        readonly label: "Dead-loop cyclic repetitions";
+        readonly default: number;
+        readonly min: 1;
+        readonly step: 1;
+    }, {
+        readonly field: "deadLoopMinPatternTokens";
+        readonly type: "number";
+        readonly label: "Dead-loop min pattern tokens";
+        readonly default: number;
+        readonly min: 1;
+        readonly step: 1;
     }];
     readonly bypassPorts: Record<string, import("@langflower/node-sdk").WireType>;
     readonly inputsConfigs: readonly [import("@langflower/node-sdk").InputPortMeta<import("@langflower/node-sdk").ExecutionContext<readonly [{
@@ -223,6 +305,88 @@ export declare const openAiLlmNode: {
         readonly min: 0;
         readonly max: 32;
         readonly step: 1;
+    }, {
+        readonly field: "autokickOnIdle";
+        readonly type: "boolean";
+        readonly label: "Autokick on idle and dead-loop";
+        readonly default: boolean;
+    }, {
+        readonly field: "deadLoopEnabled";
+        readonly type: "boolean";
+        readonly label: "Detect repetition dead loops";
+        readonly default: boolean;
+    }, {
+        readonly field: "maxAutokickAttempts";
+        readonly type: "number";
+        readonly label: "Max autokick reconnects (0 = unlimited)";
+        readonly default: number;
+        readonly min: 0;
+        readonly max: 1000;
+        readonly step: 1;
+    }, {
+        readonly field: "autokickBackoffMs";
+        readonly type: "number";
+        readonly label: "Autokick backoff base (ms)";
+        readonly default: number;
+        readonly min: 1000;
+        readonly step: 1000;
+    }, {
+        readonly field: "autokickMaxBackoffMs";
+        readonly type: "number";
+        readonly label: "Autokick backoff clamp (ms)";
+        readonly default: number;
+        readonly min: 1000;
+        readonly step: 1000;
+    }, {
+        readonly field: "autokickUserMessage";
+        readonly type: "string";
+        readonly label: "Autokick kick message";
+        readonly default: string;
+    }, {
+        readonly field: "autokickPenaltyFrequency";
+        readonly type: "number";
+        readonly label: "Autokick frequency_penalty delta";
+        readonly default: number;
+        readonly min: -2;
+        readonly max: 2;
+        readonly step: 0.1;
+    }, {
+        readonly field: "autokickPenaltyPresence";
+        readonly type: "number";
+        readonly label: "Autokick presence_penalty delta";
+        readonly default: number;
+        readonly min: -2;
+        readonly max: 2;
+        readonly step: 0.1;
+    }, {
+        readonly field: "deadLoopMaxWindowTokens";
+        readonly type: "number";
+        readonly label: "Dead-loop window (tokens)";
+        readonly default: number;
+        readonly min: 10;
+        readonly max: 8000;
+        readonly step: 1;
+    }, {
+        readonly field: "deadLoopConsecutiveThreshold";
+        readonly type: "number";
+        readonly label: "Dead-loop consecutive identical deltas";
+        readonly default: number;
+        readonly min: 1;
+        readonly step: 1;
+    }, {
+        readonly field: "deadLoopMinRepetitions";
+        readonly type: "number";
+        readonly label: "Dead-loop cyclic repetitions";
+        readonly default: number;
+        readonly min: 1;
+        readonly step: 1;
+    }, {
+        readonly field: "deadLoopMinPatternTokens";
+        readonly type: "number";
+        readonly label: "Dead-loop min pattern tokens";
+        readonly default: number;
+        readonly min: 1;
+        readonly step: 1;
     }], import("@langflower/node-sdk/llm").LlmExecutionCaps>>, ...import("@langflower/node-sdk").InputPortMeta<unknown>[]];
     readonly outputsConfigs: (import("@langflower/node-sdk").OutputParams & import("@langflower/node-sdk").PortMeta)[];
     readonly getInstance: () => import("@langflower/node-sdk").ReactiveNodeInstance<readonly [{
@@ -331,6 +495,88 @@ export declare const openAiLlmNode: {
         readonly min: 0;
         readonly max: 32;
         readonly step: 1;
+    }, {
+        readonly field: "autokickOnIdle";
+        readonly type: "boolean";
+        readonly label: "Autokick on idle and dead-loop";
+        readonly default: boolean;
+    }, {
+        readonly field: "deadLoopEnabled";
+        readonly type: "boolean";
+        readonly label: "Detect repetition dead loops";
+        readonly default: boolean;
+    }, {
+        readonly field: "maxAutokickAttempts";
+        readonly type: "number";
+        readonly label: "Max autokick reconnects (0 = unlimited)";
+        readonly default: number;
+        readonly min: 0;
+        readonly max: 1000;
+        readonly step: 1;
+    }, {
+        readonly field: "autokickBackoffMs";
+        readonly type: "number";
+        readonly label: "Autokick backoff base (ms)";
+        readonly default: number;
+        readonly min: 1000;
+        readonly step: 1000;
+    }, {
+        readonly field: "autokickMaxBackoffMs";
+        readonly type: "number";
+        readonly label: "Autokick backoff clamp (ms)";
+        readonly default: number;
+        readonly min: 1000;
+        readonly step: 1000;
+    }, {
+        readonly field: "autokickUserMessage";
+        readonly type: "string";
+        readonly label: "Autokick kick message";
+        readonly default: string;
+    }, {
+        readonly field: "autokickPenaltyFrequency";
+        readonly type: "number";
+        readonly label: "Autokick frequency_penalty delta";
+        readonly default: number;
+        readonly min: -2;
+        readonly max: 2;
+        readonly step: 0.1;
+    }, {
+        readonly field: "autokickPenaltyPresence";
+        readonly type: "number";
+        readonly label: "Autokick presence_penalty delta";
+        readonly default: number;
+        readonly min: -2;
+        readonly max: 2;
+        readonly step: 0.1;
+    }, {
+        readonly field: "deadLoopMaxWindowTokens";
+        readonly type: "number";
+        readonly label: "Dead-loop window (tokens)";
+        readonly default: number;
+        readonly min: 10;
+        readonly max: 8000;
+        readonly step: 1;
+    }, {
+        readonly field: "deadLoopConsecutiveThreshold";
+        readonly type: "number";
+        readonly label: "Dead-loop consecutive identical deltas";
+        readonly default: number;
+        readonly min: 1;
+        readonly step: 1;
+    }, {
+        readonly field: "deadLoopMinRepetitions";
+        readonly type: "number";
+        readonly label: "Dead-loop cyclic repetitions";
+        readonly default: number;
+        readonly min: 1;
+        readonly step: 1;
+    }, {
+        readonly field: "deadLoopMinPatternTokens";
+        readonly type: "number";
+        readonly label: "Dead-loop min pattern tokens";
+        readonly default: number;
+        readonly min: 1;
+        readonly step: 1;
     }], import("@langflower/node-sdk/llm").LlmExecutionCaps>;
     readonly paletteSecondary?: true;
     readonly description?: string;