@n8n/ai-workflow-builder 1.8.1 → 1.9.1

package/dist/code-builder/tools/suggested-nodes-data.js

@@ -0,0 +1,236 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.categoryList = exports.suggestedNodesData = void 0;
+exports.suggestedNodesData = {
+    chatbot: {
+        description: 'Receiving chat messages and replying (built-in chat, Telegram, Slack, etc.)',
+        patternHint: 'Chat Trigger → AI Agent → Memory → Response',
+        nodes: [
+            {
+                name: '@n8n/n8n-nodes-langchain.chatTrigger',
+                note: 'When loadPreviousSession is set to memory, the downstream Agent must also have its own memory subnode to maintain conversation context during processing',
+            },
+            {
+                name: '@n8n/n8n-nodes-langchain.agent',
+                note: 'Every agent in a conversational workflow MUST have a memory subnode connected. If multiple agents share the same conversation, they must use the same memory session key',
+            },
+            { name: '@n8n/n8n-nodes-langchain.lmChatOpenAi' },
+            { name: '@n8n/n8n-nodes-langchain.lmChatGoogleGemini' },
+            {
+                name: '@n8n/n8n-nodes-langchain.memoryBufferWindow',
+                note: 'Maintains short-term conversation history. Must be connected as a subnode to every Agent that participates in a conversation. When multiple agents share a conversation, use the same session key across all of them',
+            },
+            {
+                name: '@n8n/n8n-nodes-langchain.retrieverVectorStore',
+                note: 'Connects any Vector Store (Pinecone, Qdrant, Supabase, In-Memory, etc.) to an AI Agent for RAG. Use this as a subnode between the vector store and the agent to retrieve relevant documents when answering questions',
+            },
+            { name: 'n8n-nodes-base.slack' },
+            { name: 'n8n-nodes-base.telegram' },
+            { name: 'n8n-nodes-base.whatsApp' },
+            { name: 'n8n-nodes-base.discord' },
+        ],
+    },
+    notification: {
+        description: 'Sending alerts or updates via email, chat, SMS when events occur',
+        patternHint: 'Trigger → Condition → Send (Email/Slack/SMS)',
+        nodes: [
+            { name: 'n8n-nodes-base.webhook', note: 'Event-based notifications from external systems' },
+            {
+                name: 'n8n-nodes-base.scheduleTrigger',
+                note: 'Periodic monitoring and batch notifications',
+            },
+            {
+                name: 'n8n-nodes-base.gmail',
+                note: "Default to this because it's easy for users to setup",
+            },
+            { name: 'n8n-nodes-base.slack' },
+            { name: 'n8n-nodes-base.telegram' },
+            { name: 'n8n-nodes-base.twilio' },
+            {
+                name: 'n8n-nodes-base.httpRequest',
+                note: 'For services without dedicated nodes (Teams, Discord)',
+            },
+            { name: 'n8n-nodes-base.if', note: 'Check alert conditions before sending' },
+            {
+                name: 'n8n-nodes-base.switch',
+                note: 'If routing by severity/type is needed, use Switch to direct to different channels',
+            },
+        ],
+    },
+    scheduling: {
+        description: 'Running actions at specific times or intervals',
+        patternHint: 'Schedule Trigger → Fetch → Process → Act',
+        nodes: [
+            { name: 'n8n-nodes-base.scheduleTrigger' },
+            { name: 'n8n-nodes-base.httpRequest' },
+            { name: 'n8n-nodes-base.set' },
+            { name: 'n8n-nodes-base.wait', note: 'Respect rate limits between API calls' },
+        ],
+    },
+    data_transformation: {
+        description: 'Cleaning, formatting, or restructuring data',
+        patternHint: 'Input → Filter/Map → Transform → Output',
+        nodes: [
+            { name: 'n8n-nodes-base.set' },
+            { name: 'n8n-nodes-base.if', note: 'Use early to validate inputs' },
+            { name: 'n8n-nodes-base.filter', note: 'Use early to reduce data volume' },
+            { name: 'n8n-nodes-base.summarize', note: 'Pivot table-style aggregations' },
+            { name: 'n8n-nodes-base.aggregate', note: 'Combine multiple items into one' },
+            {
+                name: 'n8n-nodes-base.splitOut',
+                note: 'Convert single item with array into multiple items',
+            },
+            { name: 'n8n-nodes-base.sort' },
+            { name: 'n8n-nodes-base.limit' },
+            { name: 'n8n-nodes-base.removeDuplicates' },
+            {
+                name: 'n8n-nodes-base.splitInBatches',
+                note: 'For large datasets (100+ items), batch processing prevents timeouts',
+            },
+        ],
+    },
+    data_persistence: {
+        description: 'Storing, updating, or retrieving records from persistent storage',
+        patternHint: 'Trigger → Process → Store (DataTable/Sheets)',
+        nodes: [
+            { name: 'n8n-nodes-base.dataTable', note: 'PREFERRED - no external config needed' },
+            {
+                name: 'n8n-nodes-base.googleSheets',
+                note: 'For collaboration needs; if >10k rows expected, consider DataTable instead',
+            },
+            {
+                name: 'n8n-nodes-base.airtable',
+                note: 'If relationships between tables are needed',
+            },
+            { name: 'n8n-nodes-base.postgres' },
+            { name: 'n8n-nodes-base.mySql' },
+            { name: 'n8n-nodes-base.mongoDb' },
+        ],
+    },
+    data_extraction: {
+        description: 'Pulling specific information from structured or unstructured inputs',
+        patternHint: 'Source → Extract → Parse → Structure',
+        nodes: [
+            {
+                name: 'n8n-nodes-base.extractFromFile',
+                note: 'For multiple file types, route by file type first with IF/Switch',
+            },
+            { name: 'n8n-nodes-base.htmlExtract', note: 'JS-rendered content may be empty' },
+            { name: 'n8n-nodes-base.splitOut', note: 'Use before Loop Over Items for arrays' },
+            {
+                name: 'n8n-nodes-base.splitInBatches',
+                note: 'Process 200 rows at a time for memory',
+            },
+            { name: 'n8n-nodes-base.code' },
+            { name: '@n8n/n8n-nodes-langchain.informationExtractor', note: 'For unstructured text' },
+            {
+                name: '@n8n/n8n-nodes-langchain.chainSummarization',
+                note: 'Context window limits may truncate',
+            },
+        ],
+    },
+    document_processing: {
+        description: 'Taking action on content within files (PDFs, Word docs, images)',
+        patternHint: 'Trigger → Extract Text → AI Parse → Store',
+        nodes: [
+            {
+                name: 'n8n-nodes-base.gmailTrigger',
+            },
+            { name: 'n8n-nodes-base.googleDriveTrigger' },
+            {
+                name: 'n8n-nodes-base.extractFromFile',
+                note: 'Different file types require different operations - route accordingly',
+            },
+            { name: 'n8n-nodes-base.awsTextract', note: 'For tables and forms in scanned docs' },
+            { name: 'n8n-nodes-base.mindee', note: 'Specialized invoice/receipt parsing' },
+            { name: '@n8n/n8n-nodes-langchain.agent' },
+            {
+                name: '@n8n/n8n-nodes-langchain.documentDefaultDataLoader',
+                note: 'Loads binary files (PDF, CSV, JSON, DOCX, EPUB, text) into LangChain Documents. Auto-detects format from MIME type. Requires a preceding node that outputs binary data',
+            },
+            {
+                name: '@n8n/n8n-nodes-langchain.vectorStoreInMemory',
+                note: 'No external dependencies needed',
+            },
+            { name: 'n8n-nodes-base.splitInBatches', note: 'Process 5-10 files at a time' },
+        ],
+    },
+    form_input: {
+        description: 'Gathering data from users via forms',
+        patternHint: 'Form Trigger → Validate → Store → Respond',
+        nodes: [
+            { name: 'n8n-nodes-base.formTrigger', note: 'ALWAYS store raw data to persistent storage' },
+            { name: 'n8n-nodes-base.form', note: 'Each node is one page/step' },
+            { name: 'n8n-nodes-base.dataTable', note: 'PREFERRED for form data storage' },
+            { name: 'n8n-nodes-base.googleSheets' },
+            { name: 'n8n-nodes-base.airtable' },
+        ],
+    },
+    content_generation: {
+        description: 'Creating text, images, audio, or video',
+        patternHint: 'Trigger → Generate (Text/Image/Video) → Deliver',
+        nodes: [
+            { name: '@n8n/n8n-nodes-langchain.agent', note: 'For text generation' },
+            {
+                name: '@n8n/n8n-nodes-langchain.openAi',
+                note: 'Use for image/video generation. DALL-E, TTS, Sora video generation',
+            },
+            { name: '@n8n/n8n-nodes-langchain.lmChatGoogleGemini', note: 'Imagen, video generation' },
+            { name: 'n8n-nodes-base.httpRequest', note: 'For APIs without dedicated nodes' },
+            { name: 'n8n-nodes-base.editImage', note: 'Resize, crop, format conversion' },
+            { name: 'n8n-nodes-base.markdown', note: 'Convert to HTML' },
+            { name: 'n8n-nodes-base.facebookGraphApi' },
+            {
+                name: 'n8n-nodes-base.wait',
+                note: 'Video generation is async, use wait while polling for updated',
+            },
+        ],
+    },
+    triage: {
+        description: 'Classifying data for routing or prioritization',
+        patternHint: 'Trigger → Classify → Route → Act',
+        nodes: [
+            {
+                name: '@n8n/n8n-nodes-langchain.agent',
+                note: 'For consistent/deterministic classification, always use structured output parser and set temperature 0-0.2',
+            },
+            {
+                name: '@n8n/n8n-nodes-langchain.outputParserStructured',
+                note: 'Critical to ensure agent output is consistent and matching general schema',
+            },
+        ],
+    },
+    scraping_and_research: {
+        description: 'Collecting information from websites or APIs',
+        patternHint: 'Trigger → Fetch → Extract → Store',
+        nodes: [
+            {
+                name: 'n8n-nodes-base.dataTable',
+                note: 'Default storage for scraped data when the user does not specify a destination. No external config needed. Always include a storage step in scraping workflows',
+            },
+            {
+                name: 'n8n-nodes-base.phantombuster',
+                note: 'Use this for social media requests: LinkedIn, Facebook, Instagram, Twitter, etc.',
+            },
+            {
+                name: '@n8n/n8n-nodes-langchain.toolSerpApi',
+                note: 'Give agent web search capability, get up-to-date information from websites.',
+            },
+            { name: 'n8n-nodes-base.perplexity', note: 'Recommended for fetching up-to-date news' },
+            { name: 'n8n-nodes-base.perplexityTool', note: 'Recommended for fetching up-to-date news' },
+            {
+                name: 'n8n-nodes-base.htmlExtract',
+                note: 'Use to extract HTML content from http requests. Though, JS-rendered sites may return empty',
+            },
+            {
+                name: 'n8n-nodes-base.splitInBatches',
+                note: 'Use to batch the processing of items. General recommendation: 200 rows at a time if processing is fast',
+            },
+            { name: 'n8n-nodes-base.wait', note: 'Use this to avoid rate limits (429 errors)' },
+            { name: 'n8n-nodes-base.httpRequest' },
+            { name: 'n8n-nodes-base.httpRequestTool' },
+        ],
+    },
+};
+exports.categoryList = Object.keys(exports.suggestedNodesData);
+//# sourceMappingURL=suggested-nodes-data.js.map

package/dist/code-builder/tools/suggested-nodes-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggested-nodes-data.js","sourceRoot":"","sources":["../../../src/code-builder/tools/suggested-nodes-data.ts"],"names":[],"mappings":"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"}

package/dist/code-builder/triage.agent.d.ts

@@ -0,0 +1,48 @@
+import type { BaseChatModel } from '@langchain/core/language_models/chat_models';
+import type { Logger } from '@n8n/backend-common';
+import type { AssistantHandler } from '../assistant/assistant-handler';
+import type { StreamOutput } from '../types/streaming';
+import type { ChatPayload } from '../workflow-builder-agent';
+type TriageConversationEntry = {
+    type: 'build-request';
+    message: string;
+} | {
+    type: 'assistant-exchange';
+    userQuery: string;
+    assistantSummary: string;
+} | {
+    type: 'plan';
+    userQuery: string;
+    plan: string;
+};
+export interface TriageAgentConfig {
+    llm: BaseChatModel;
+    assistantHandler: AssistantHandler;
+    buildWorkflow: (payload: ChatPayload, userId: string, abortSignal?: AbortSignal) => AsyncIterable<StreamOutput>;
+    logger?: Logger;
+}
+export interface TriageAgentParams {
+    payload: ChatPayload;
+    userId: string;
+    abortSignal?: AbortSignal;
+    sdkSessionId?: string;
+    conversationHistory?: TriageConversationEntry[];
+}
+export interface TriageAgentOutcome {
+    sdkSessionId?: string;
+    assistantSummary?: string;
+    buildExecuted?: boolean;
+}
+export declare class TriageAgent {
+    private readonly llm;
+    private readonly assistantHandler;
+    private readonly buildWorkflow;
+    private readonly logger?;
+    constructor(config: TriageAgentConfig);
+    run(params: TriageAgentParams): AsyncGenerator<StreamOutput, TriageAgentOutcome>;
+    private executeToolWithStreaming;
+    private executeTool;
+    private getOutcome;
+    private wrapChunk;
+}
+export {};

package/dist/code-builder/triage.agent.js

@@ -0,0 +1,223 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TriageAgent = void 0;
+const messages_1 = require("@langchain/core/messages");
+const content_extractors_1 = require("../code-builder/utils/content-extractors");
+const constants_1 = require("../constants");
+const builder_1 = require("../prompts/builder");
+const ask_assistant_tool_1 = require("./tools/ask-assistant.tool");
+const build_workflow_tool_1 = require("./tools/build-workflow.tool");
+function conversationEntryToString(entry) {
+    switch (entry.type) {
+        case 'build-request':
+            return entry.message;
+        case 'assistant-exchange':
+            return `[Help] Q: ${entry.userQuery} → A: ${entry.assistantSummary}`;
+        case 'plan':
+            return `[Plan] Q: ${entry.userQuery} → ${entry.plan}`;
+    }
+}
+function buildTriagePrompt(conversationHistory) {
+    return (0, builder_1.prompt)()
+        .section('role', 'You are a triage agent for the n8n workflow builder. ' +
+        'Your job is to classify each user message and route it to the right handler.')
+        .section('routing', `Route each message using one or more of these:
+
+1. **build_workflow** — The user wants to create, modify, or change a workflow.
+   Pass the full user request as instructions.
+
+2. **ask_assistant** — The user has a general question about n8n concepts, needs help understanding how something works, wants guidance on setting up credentials, or needs to diagnose a workflow error.
+   Pass the user's query faithfully.
+
+3. **Direct reply** — Simple conversational messages that don't need either tool.
+   Respond with helpful text directly.`)
+        .section('rules', `- For error/debug messages: first call ask_assistant to diagnose, then call build_workflow to apply the fix
+- For pure questions (no fix needed): call ask_assistant and respond with its answer — no follow-up build required
+- When in doubt between ask_assistant and build_workflow, prefer build_workflow for any message that implies changing the workflow
+- Use conversation history to resolve references like "change that" or "the previous node"`)
+        .sectionIf(conversationHistory && conversationHistory.length > 0, 'conversation history', () => conversationHistory
+        .map((entry, i) => `${i + 1}. ${conversationEntryToString(entry)}`)
+        .join('\n'))
+        .build();
+}
+class TriageAgent {
+    llm;
+    assistantHandler;
+    buildWorkflow;
+    logger;
+    constructor(config) {
+        this.llm = config.llm;
+        this.assistantHandler = config.assistantHandler;
+        this.buildWorkflow = config.buildWorkflow;
+        this.logger = config.logger;
+    }
+    async *run(params) {
+        const { payload, userId, abortSignal, sdkSessionId, conversationHistory } = params;
+        if (!this.llm.bindTools) {
+            throw new Error('LLM does not support bindTools');
+        }
+        const llmWithTools = this.llm.bindTools([ask_assistant_tool_1.ASK_ASSISTANT_TOOL, build_workflow_tool_1.BUILD_WORKFLOW_TOOL]);
+        const systemContent = buildTriagePrompt(conversationHistory);
+        const messages = [
+            new messages_1.SystemMessage(systemContent),
+            new messages_1.HumanMessage(payload.message),
+        ];
+        const ctx = { userId, payload, abortSignal };
+        const state = { sdkSessionId };
+        let reachedMaxIterations = true;
+        for (let iteration = 0; iteration < constants_1.MAX_TRIAGE_ITERATIONS; iteration++) {
+            const response = await llmWithTools.invoke(messages, {
+                signal: abortSignal,
+            });
+            messages.push(response);
+            const toolCalls = response.tool_calls ?? [];
+            if (toolCalls.length === 0) {
+                this.logger?.debug('[TriageAgent] No tool call, responding with text', {
+                    iteration: iteration + 1,
+                });
+                const text = (0, content_extractors_1.extractTextContent)(new messages_1.AIMessage({ content: response.content })) ?? '';
+                if (text) {
+                    yield this.wrapChunk({
+                        role: 'assistant',
+                        type: 'message',
+                        text,
+                    });
+                }
+                reachedMaxIterations = false;
+                break;
+            }
+            for (const toolCall of toolCalls) {
+                this.logger?.debug('[TriageAgent] Tool called', {
+                    toolName: toolCall.name,
+                    iteration: iteration + 1,
+                });
+                const toolCallId = toolCall.id ?? `tc-${iteration}`;
+                const result = yield* this.executeToolWithStreaming(toolCall, ctx, state);
+                this.logger?.debug('[TriageAgent] Tool completed', {
+                    toolName: toolCall.name,
+                    iteration: iteration + 1,
+                    endLoop: result.endLoop,
+                });
+                messages.push(new messages_1.ToolMessage({
+                    tool_call_id: toolCallId,
+                    content: result.content,
+                }));
+                if (result.endLoop) {
+                    return this.getOutcome(state);
+                }
+            }
+        }
+        if (reachedMaxIterations) {
+            this.logger?.warn('[TriageAgent] Max iterations reached');
+        }
+        return this.getOutcome(state);
+    }
+    async *executeToolWithStreaming(toolCall, ctx, state) {
+        const queue = [];
+        let resolveNext;
+        let done = false;
+        const enqueue = (output) => {
+            queue.push(output);
+            resolveNext?.();
+        };
+        const toolPromise = this.executeTool(toolCall, ctx, state, enqueue).finally(() => {
+            done = true;
+            resolveNext?.();
+        });
+        while (!done || queue.length > 0) {
+            if (queue.length > 0) {
+                yield queue.shift();
+            }
+            else if (!done) {
+                await new Promise((resolve) => {
+                    resolveNext = resolve;
+                    if (queue.length > 0 || done) {
+                        resolve();
+                    }
+                });
+            }
+        }
+        return await toolPromise;
+    }
+    async executeTool(toolCall, ctx, state, enqueue) {
+        switch (toolCall.name) {
+            case 'ask_assistant': {
+                const assistantToolCallId = `triage-ask-assistant-${Date.now()}`;
+                enqueue(this.wrapChunk({
+                    type: 'tool',
+                    toolName: 'assistant',
+                    toolCallId: assistantToolCallId,
+                    customDisplayTitle: 'Asking assistant...',
+                    status: 'running',
+                }));
+                const progressWriter = (chunk) => {
+                    if (chunk.type === 'tool') {
+                        enqueue(this.wrapChunk(chunk));
+                    }
+                };
+                const currentWorkflow = ctx.payload.workflowContext?.currentWorkflow;
+                const workflowJSON = currentWorkflow
+                    ? {
+                        name: currentWorkflow.name ?? '',
+                        nodes: currentWorkflow.nodes ?? [],
+                        connections: currentWorkflow.connections ?? {},
+                    }
+                    : undefined;
+                const result = await this.assistantHandler.execute({
+                    query: toolCall.args.query,
+                    sdkSessionId: state.sdkSessionId,
+                    workflowJSON,
+                }, ctx.userId, progressWriter, ctx.abortSignal);
+                const chunks = [
+                    {
+                        type: 'tool',
+                        toolName: 'assistant',
+                        toolCallId: assistantToolCallId,
+                        status: 'completed',
+                    },
+                ];
+                if (result.responseText) {
+                    chunks.push({
+                        role: 'assistant',
+                        type: 'message',
+                        text: result.responseText,
+                    });
+                }
+                enqueue({ messages: chunks });
+                state.sdkSessionId = result.sdkSessionId;
+                state.assistantSummary = result.summary;
+                return { content: result.summary };
+            }
+            case 'build_workflow': {
+                const enrichedPayload = state.assistantSummary
+                    ? {
+                        ...ctx.payload,
+                        message: `[Diagnosis]: ${state.assistantSummary}\n\n${ctx.payload.message}`,
+                    }
+                    : ctx.payload;
+                for await (const chunk of this.buildWorkflow(enrichedPayload, ctx.userId, ctx.abortSignal)) {
+                    enqueue(chunk);
+                }
+                state.buildExecuted = true;
+                return { content: 'Workflow built.', endLoop: true };
+            }
+            default:
+                this.logger?.warn('[TriageAgent] Unknown tool call', {
+                    toolName: toolCall.name,
+                });
+                return { content: `Unknown tool: ${toolCall.name}` };
+        }
+    }
+    getOutcome(state) {
+        return {
+            sdkSessionId: state.sdkSessionId,
+            assistantSummary: state.assistantSummary,
+            buildExecuted: state.buildExecuted,
+        };
+    }
+    wrapChunk(chunk) {
+        return { messages: [chunk] };
+    }
+}
+exports.TriageAgent = TriageAgent;
+//# sourceMappingURL=triage.agent.js.map

package/dist/code-builder/triage.agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triage.agent.js","sourceRoot":"","sources":["../../src/code-builder/triage.agent.ts"],"names":[],"mappings":"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"}

package/dist/code-builder/types.d.ts

@@ -0,0 +1,51 @@
+import type { Callbacks } from '@langchain/core/callbacks/manager';
+import type { BaseChatModel } from '@langchain/core/language_models/chat_models';
+import type { Logger } from '@n8n/backend-common';
+import type { WorkflowJSON } from '@n8n/workflow-sdk';
+import type { IDisplayOptions, INodeTypeDescription, ITelemetryTrackProperties } from 'n8n-workflow';
+export interface SubnodeRequirement {
+    connectionType: string;
+    required: boolean;
+    displayOptions?: IDisplayOptions;
+}
+export interface CodeBuilderNodeSearchResult {
+    name: string;
+    displayName: string;
+    description: string;
+    version: number;
+    score: number;
+    inputs: INodeTypeDescription['inputs'];
+    outputs: INodeTypeDescription['outputs'];
+    builderHintMessage?: string;
+    subnodeRequirements?: SubnodeRequirement[];
+}
+export interface WorkflowCodeOutput {
+    workflowCode: string;
+}
+export interface ValidationWarning {
+    code: string;
+    message: string;
+    nodeName?: string;
+    parameterPath?: string;
+}
+export interface ParseAndValidateResult {
+    workflow: WorkflowJSON;
+    warnings: ValidationWarning[];
+}
+export interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    thinkingTokens: number;
+}
+export interface CodeBuilderAgentConfig {
+    llm: BaseChatModel;
+    nodeTypes: INodeTypeDescription[];
+    logger?: Logger;
+    nodeDefinitionDirs?: string[];
+    enableTextEditor?: boolean;
+    onTokenUsage?: (usage: TokenUsage) => void;
+    callbacks?: Callbacks;
+    runMetadata?: Record<string, unknown>;
+    onTelemetryEvent?: (event: string, properties: ITelemetryTrackProperties) => void;
+    generatePinData?: boolean;
+}

package/dist/code-builder/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/code-builder/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/code-builder/types.ts"],"names":[],"mappings":""}

package/dist/code-builder/utils/code-builder-session.d.ts

@@ -0,0 +1,25 @@
+import type { BaseChatModel } from '@langchain/core/language_models/chat_models';
+import type { MemorySaver } from '@langchain/langgraph';
+export type ConversationEntry = {
+    type: 'build-request';
+    message: string;
+} | {
+    type: 'assistant-exchange';
+    userQuery: string;
+    assistantSummary: string;
+} | {
+    type: 'plan';
+    userQuery: string;
+    plan: string;
+};
+export declare function entryToString(entry: ConversationEntry): string;
+export interface CodeBuilderSession {
+    conversationEntries: ConversationEntry[];
+    previousSummary?: string;
+    sdkSessionId?: string;
+}
+export declare function loadCodeBuilderSession(checkpointer: MemorySaver, threadId: string): Promise<CodeBuilderSession>;
+export declare function saveCodeBuilderSession(checkpointer: MemorySaver, threadId: string, session: CodeBuilderSession): Promise<void>;
+export declare function compactSessionIfNeeded(session: CodeBuilderSession, llm: BaseChatModel, maxMessages?: number): Promise<CodeBuilderSession>;
+export declare function generateCodeBuilderThreadId(workflowId: string, userId: string): string;
+export declare function saveSessionMessages(checkpointer: MemorySaver, workflowId: string, userId: string, messages: unknown[], versionId?: string, userMessageId?: string): Promise<void>;