langflower 0.0.7 → 0.0.9

package/vendor/common-nodes/dist/ai/nodes/review/node.js

@@ -0,0 +1,240 @@
+import { filter, map, Observable } from 'rxjs';
+import { defineLlmNode, isSteerControlPayload, toLlmRecoveryPortValue, } from '@langflower/node-sdk/llm';
+import { collectAgentToolHandles } from '../../../tools/collect-agent-tool-handles.js';
+import { buildEffectiveSystemPrompt } from '../../features/prompt/build-effective-system-prompt.js';
+import { resolveChatProviderModel } from '../../features/prompt/resolve-chat-provider-model.js';
+import { createLlmSessionCycle$, demuxByKind, normalizeMaxFeedbackTurns, } from '../../features/llm-session/llm-session-shell.js';
+import { llmCompactionUiSchema } from '../../features/ui-schema/llm-compaction-ui-schema.js';
+import { llmRecoveryUiSchema } from '../../features/ui-schema/llm-recovery-ui-schema.js';
+import { llmMaxIterationsUiField, llmPanelUiSchema, } from '../../features/ui-schema/llm-panel-ui-schema.js';
+import { parseLlmRolePreset, resolveEffectiveSkillId, } from '../../features/llm-role-preset.js';
+import { DEFAULT_PATH_CHOICE_MAX_ITERATIONS, PATH_CHOICE_MAX_ITERATIONS_CAP, normalizeMaxIterations, } from '../../features/prompt/normalize-max-iterations.js';
+import { normalizeLlmRecoveryPolicy } from '../../features/llm-loop/normalize-llm-recovery-policy.js';
+import { normalizeCompactionConfig } from '../../features/openai/normalize-compaction-params.js';
+import { flattenSubAgentRegistrations, } from '../../features/sub-agent-protocol.js';
+import { waitForSubagentResult } from '../../features/wait-for-subagent-result.js';
+import { REVIEW_ACCEPT_TOOL, REVIEW_FEEDBACK_TOOL, } from '../../features/path-choice/control-tools.js';
+import { runPathChoiceToolLoop, } from '../../features/path-choice/run-reactive-path-choice-loop.js';
+import { getRunHostServices } from '../../features/run-host-services.js';
+const FORCED_TOOL_SYSTEM = [
+    'You are a strict Review node.',
+    `Finish by calling exactly one control tool: ${REVIEW_ACCEPT_TOOL} or ${REVIEW_FEEDBACK_TOOL}.`,
+    'You may call optional inventory tools first when they help verify the artifact.',
+    'Do not write free-form accept/reject essays.',
+    `Call ${REVIEW_ACCEPT_TOOL} when the result meets the task criteria.`,
+    `Call ${REVIEW_FEEDBACK_TOOL} with revision notes when it does not.`,
+].join(' ');
+const requireChatConfig = (providerId, model) => {
+    if (providerId.trim().length === 0) {
+        throw new Error('Provider is required for Review chat');
+    }
+    if (model.trim().length === 0) {
+        throw new Error('Model is required for Review chat');
+    }
+};
+const buildEffectiveReviewSystem = (input) => {
+    const merged = buildEffectiveSystemPrompt(input);
+    const parts = [FORCED_TOOL_SYSTEM];
+    if (merged.trim().length > 0) {
+        parts.push(merged);
+    }
+    return parts.join('\n\n---\n\n');
+};
+const buildUserContent = (task, result) => [
+    '## Task / criteria',
+    task.trim().length > 0 ? task : '(empty task)',
+    '',
+    '## Result under review',
+    result.trim().length > 0 ? result : '(empty result)',
+].join('\n');
+const buildRevisedResultUserContent = (result) => [
+    '## Revised result under review',
+    result.trim().length > 0 ? result : '(empty result)',
+].join('\n');
+const hasUserMessage = (history) => history.some((message) => message.role === 'user');
+const runReviewTurn = (context, result, history, subagentResult$) => {
+    const factory = context.factory;
+    if (factory === undefined) {
+        return new Observable((subscriber) => {
+            subscriber.error(new Error('Review chat is only available during server workflow runs'));
+        });
+    }
+    requireChatConfig(context.providerId, context.model);
+    const userContent = hasUserMessage(history)
+        ? buildRevisedResultUserContent(result)
+        : buildUserContent(context.task, result);
+    const messages = [
+        ...history,
+        { role: 'user', content: userContent },
+    ];
+    return runPathChoiceToolLoop({
+        factory,
+        providerId: context.providerId,
+        model: context.model,
+        messages,
+        maxIterations: context.maxIterations,
+        tools: context.tools,
+        compaction: context.compaction,
+        recovery: context.recovery,
+        steerControl$: context.steerControl$,
+        subagentRegistrations: context.subagentRegistrations,
+        toolCtx: context.toolCtx,
+        ...(context.subagentRegistrations.length > 0
+            ? {
+                waitForSubagentResult: (callId, signal) => waitForSubagentResult(subagentResult$, callId, signal, context.recovery.subagentTimeoutMs),
+            }
+            : {}),
+    }).pipe(map((chunk) => {
+        if (chunk.kind === 'accept') {
+            return {
+                kind: 'accept',
+                notes: chunk.notes,
+                result,
+            };
+        }
+        return chunk;
+    }));
+};
+/**
+ * Dedicated Review node: path choice via **Review-private** control tools
+ * (`accept` / `feedback` in `path-choice/control-tools.ts`). Those chat tools are
+ * ephemeral on completion calls only — they must not leak into shared
+ * inventory / other LLM nodes. Tool payloads demux to `response` / `feedback`
+ * ports; free-form replies get a reminder. Optional inventory / MCP /
+ * Sub-Agents use shared LLM inventory ports.
+ *
+ * Session history uses the shared {@link createLlmSessionCycle$} (ADR-016):
+ * init = task / system / inventory; turn driver = `result`.
+ * @see docs/DONE/EPICS/03-review-node.md
+ * @see docs/DONE/EPICS/MECHANICS-tool-execution.md
+ */
+export const reviewNode = defineLlmNode({
+    type: 'common-review',
+    displayName: 'Review',
+    category: 'AI',
+    description: 'Forced-tool Review: finish with accept or feedback (requires a model with native tool / function calling — prose or markdown tool_code will not route). Optional wired tools / MCP / Sub-Agents may run via harness first.',
+    uiSchema: [
+        ...llmPanelUiSchema.filter((item) => item.field !== 'maxIterations'),
+        llmMaxIterationsUiField(DEFAULT_PATH_CHOICE_MAX_ITERATIONS, PATH_CHOICE_MAX_ITERATIONS_CAP),
+        ...llmCompactionUiSchema,
+        ...llmRecoveryUiSchema,
+    ],
+    bind(ctx, { makeInput, configureOutput, combineInputs }, inventory) {
+        const { tools, mcp, subagentRegistration, subagentResult, steerControl, } = inventory;
+        const task = makeInput('task', {
+            name: 'task',
+            wireType: 'string',
+            inline: 'text-multiline',
+            required: true,
+        });
+        const result = makeInput('result', {
+            name: 'result',
+            wireType: 'string',
+            inline: 'text-multiline',
+            required: true,
+        });
+        const systemPrompt = makeInput('systemPrompt', {
+            name: 'systemPrompt',
+            wireType: 'string',
+            inline: 'text-multiline',
+            defaultValue: '',
+        });
+        // Init peers only — result is the session turn driver (ADR-016).
+        const context$ = combineInputs([task, systemPrompt, tools, subagentRegistration, mcp, ctx], ([taskValue, 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 {
+                task: String(taskValue ?? ''),
+                ...resolveChatProviderModel(ec.params, hostServices),
+                skillId,
+                skillMarkdown,
+                effectiveSystemPrompt: buildEffectiveReviewSystem({
+                    rolePreset,
+                    systemPromptInput: String(systemPromptValue ?? ''),
+                    agentsMarkdown,
+                    skillMarkdown,
+                }),
+                factory: hostServices?.createChatCompletionStream,
+                maxIterations: normalizeMaxIterations(ec.params.maxIterations, {
+                    fallback: DEFAULT_PATH_CHOICE_MAX_ITERATIONS,
+                    maxCap: PATH_CHOICE_MAX_ITERATIONS_CAP,
+                }),
+                maxFeedbackTurns: normalizeMaxFeedbackTurns(ec.params.maxFeedbackTurns),
+                ...(hostServices?.requestPermission !== undefined
+                    ? { requestPermission: hostServices.requestPermission }
+                    : {}),
+                compaction: normalizeCompactionConfig(ec.params),
+                recovery: normalizeLlmRecoveryPolicy(ec.params),
+                steerControl$: steerControl.value$.pipe(filter(isSteerControlPayload)),
+                tools: collectAgentToolHandles({
+                    toolHandles: ec.toolHandles,
+                    toolsPort: toolList,
+                    mcpHandles: ec.mcpHandles,
+                    mcpPort: mcpList,
+                }),
+                subagentRegistrations: flattenSubAgentRegistrations(subagentList),
+                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 }
+                        : {}),
+                },
+            };
+        });
+        const cycle$ = createLlmSessionCycle$(context$, result.value$, (context) => ({
+            history: [
+                {
+                    role: 'system',
+                    content: context.effectiveSystemPrompt,
+                },
+            ],
+            trackAssistantHistory: false,
+            appendUserFeedbackToHistory: false,
+            session: undefined,
+        }), (context, turnPayload, history) => runReviewTurn(context, String(turnPayload ?? ''), 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('accept', (chunk) => chunk.result));
+        const feedback$ = cycle$.pipeValue(demuxByKind('feedback', (chunk) => chunk.notes));
+        const subagent$ = cycle$.pipeValue(demuxByKind('subagentSpawn', (chunk) => chunk
+            .payload));
+        return {
+            inputs: [task, result, systemPrompt],
+            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' },
+                }),
+                configureOutput('feedback', feedback$, {
+                    wireType: 'string',
+                    feed: { role: 'result' },
+                }),
+            ],
+            inventoryOutputs: { toolLog$, recovery$, subagent$ },
+        };
+    },
+});