@csmedeiros/codemax 1.0.3 → 1.0.7

package/dist/conversation/agentTurn.js

@@ -1,252 +0,0 @@
-import { HumanMessage, AIMessage, ToolMessage } from '@langchain/core/messages';
-import { appendFileSync } from 'node:fs';
-import { Command } from '@langchain/langgraph';
-import { agent } from './agentGraph.js';
-import { createToolUiCallbackHandlerWithSink } from '../tooling/toolUiCallback.js';
-import { getLangfuseCallbacksForTurn } from '../observability/langfuseTracing.js';
-import { getConfig } from '../configuration/configManager.js';
-function debugEventsEnabled() {
-    return getConfig().debugEvents;
-}
-function debugLog(message) {
-    if (!debugEventsEnabled())
-        return;
-    const ts = new Date().toISOString();
-    const line = `[CodeMax][events][${ts}] ${message}\n`;
-    // Writing to stderr corrupts the Ink TUI. Only write to file.
-    try {
-        const filePath = (process.env['CODEMAX_DEBUG_LOG_FILE'] ?? '').trim() ||
-            '/tmp/codemax-debug.log';
-        appendFileSync(filePath, line, { encoding: 'utf8' });
-    }
-    catch {
-        // ignore
-    }
-}
-function messageContentToPlainText(content) {
-    if (typeof content === 'string')
-        return { text: content };
-    if (!content)
-        return { text: '' };
-    if (typeof content === 'object' && !Array.isArray(content)) {
-        const obj = content;
-        if (obj['type'] === 'text' && typeof obj['text'] === 'string') {
-            return { text: obj['text'] };
-        }
-        if ((obj['type'] === 'thinking' || obj['type'] === 'reasoning') &&
-            typeof obj['text'] === 'string') {
-            return { text: obj['text'], isThinking: true };
-        }
-        if (typeof obj['content'] === 'string')
-            return { text: obj['content'] };
-        return { text: '' };
-    }
-    if (!Array.isArray(content))
-        return { text: '' };
-    let fullText = '';
-    let anyThinking = false;
-    for (const part of content) {
-        if (typeof part === 'string') {
-            fullText += part;
-        }
-        else if (part && typeof part === 'object') {
-            const obj = part;
-            if (obj['type'] === 'text' && typeof obj['text'] === 'string') {
-                fullText += obj['text'];
-            }
-            else if ((obj['type'] === 'thinking' || obj['type'] === 'reasoning') &&
-                typeof obj['text'] === 'string') {
-                fullText += obj['text'];
-                anyThinking = true;
-            }
-            else if (typeof obj['content'] === 'string') {
-                fullText += obj['content'];
-            }
-        }
-    }
-    return { text: fullText, isThinking: anyThinking };
-}
-export async function* streamAgentTurn(options) {
-    const queue = [];
-    const waiters = [];
-    let completed = false;
-    const push = (event) => {
-        debugLog(`push ${event.type}`);
-        queue.push(event);
-        const resolve = waiters.shift();
-        resolve?.();
-    };
-    const callbacks = [
-        createToolUiCallbackHandlerWithSink(e => {
-            debugLog(`callback ${e.type} tool=${e.toolName ?? ''} input_len=${(e.input ?? '').length} output_len=${(e.output ?? '').length}`);
-            // Re-emit into our turn event stream.
-            if (e.type === 'on_tool_start')
-                push({ type: 'on_tool_start', toolName: e.toolName, input: e.input });
-            else if (e.type === 'on_tool_end')
-                push({ type: 'on_tool_end', toolName: e.toolName, output: e.output });
-            else
-                push({ type: 'on_tool_error', error: e.error });
-        }),
-        ...(options.tracingEnabled
-            ? getLangfuseCallbacksForTurn(options.sessionId)
-            : []),
-    ];
-    if (options.prompt) {
-        push({ type: 'on_chat_start' });
-        push({ type: 'status', text: `Searching... (${options.threadId})` });
-    }
-    const run = (async () => {
-        try {
-            debugLog(`agent.stream start thread_id=${options.threadId}`);
-            const initialState = await agent.getState({
-                configurable: { thread_id: options.threadId },
-            });
-            if (initialState.values?.todos) {
-                push({ type: 'on_state_update', todos: initialState.values.todos });
-            }
-            const input = options.resumeResponse
-                ? new Command({
-                    resume: options.resumeResponse,
-                    update: { toolExecutionMode: options.toolExecutionMode },
-                })
-                : {
-                    messages: [new HumanMessage(options.prompt)],
-                    toolExecutionMode: options.toolExecutionMode,
-                    activeSkill: options.activeSkill,
-                };
-            const stream = await agent.stream(input, {
-                streamMode: 'messages',
-                configurable: { thread_id: options.threadId },
-                callbacks,
-                signal: options.signal,
-                recursionLimit: getConfig().recursionLimit,
-            });
-            let inThinking = false;
-            const emitThinking = (text) => {
-                if (!text)
-                    return;
-                const prefix = inThinking ? '' : '> [Thinking] ';
-                inThinking = true;
-                const formatted = (prefix + text).replace(/\n/g, '\n> ');
-                push({ type: 'on_chat_delta', text: formatted });
-            };
-            const emitContent = (text) => {
-                if (!text)
-                    return;
-                const prefix = inThinking ? '\n\n' : '';
-                inThinking = false;
-                push({ type: 'on_chat_delta', text: prefix + text });
-            };
-            for await (const chunk of stream) {
-                // Normalize chunk to a message object
-                let msg = null;
-                if (Array.isArray(chunk)) {
-                    msg = chunk[0];
-                }
-                else if (chunk && typeof chunk === 'object') {
-                    msg = chunk;
-                }
-                if (msg) {
-                    // Only push deltas for assistant messages (AIMessage chunks)
-                    // ToolMessages and HumanMessages should not be streamed to the chat buffer
-                    const isAI = msg instanceof AIMessage ||
-                        msg._getType() === 'ai' ||
-                        (msg.tool_calls && !msg.tool_call_id);
-                    if (isAI) {
-                        const reasoning = msg.additional_kwargs?.reasoning_content ??
-                            msg.additional_kwargs?.reasoning;
-                        if (typeof reasoning === 'string' && reasoning.length > 0) {
-                            emitThinking(reasoning);
-                        }
-                        const content = msg.content;
-                        const { text, isThinking } = messageContentToPlainText(content);
-                        if (text) {
-                            if (isThinking)
-                                emitThinking(text);
-                            else
-                                emitContent(text);
-                        }
-                    }
-                }
-            }
-            // Check for interrupts after the stream finishes.
-            // 'messages' stream mode often doesn't yield the interrupt itself.
-            const state = await agent.getState({
-                configurable: { thread_id: options.threadId },
-            });
-            if (state.values?.todos) {
-                push({ type: 'on_state_update', todos: state.values.todos });
-            }
-            if (state.tasks && state.tasks.length > 0) {
-                const lastTask = state.tasks[state.tasks.length - 1];
-                const firstInterrupt = lastTask?.interrupts?.[0];
-                if (firstInterrupt) {
-                    debugLog(`detected interrupt in state thread_id=${options.threadId}`);
-                    push({ type: 'on_interrupt', payload: firstInterrupt.value });
-                    return;
-                }
-            }
-            push({ type: 'on_chat_end' });
-            push({ type: 'status', text: `Ready  ·  thread ${options.threadId}` });
-        }
-        catch (error) {
-            const isAbort = error instanceof Error && error.name === 'AbortError';
-            if (!isAbort) {
-                process.stderr.write(`\n\n[CodeMax] CRITICAL ERROR: ${error?.message || error}\n\n`);
-            }
-            debugLog(`agent.stream ERROR thread_id=${options.threadId} error=${error}`);
-            if (isAbort) {
-                debugLog(`agent.stream aborted thread_id=${options.threadId}`);
-                // Cleanup incomplete tool calls from checkpoint history.
-                try {
-                    const history = await agent.getState({
-                        configurable: { thread_id: options.threadId },
-                    });
-                    const messages = history.values.messages ?? [];
-                    const cleaned = [];
-                    const toolMessageIds = new Set(messages
-                        .filter((m) => m instanceof ToolMessage || m._getType() === 'tool')
-                        .map((m) => m.tool_call_id));
-                    for (const m of messages) {
-                        if (m instanceof AIMessage || m._getType() === 'ai') {
-                            const toolCalls = m.tool_calls ?? [];
-                            const hasOrphan = toolCalls.some(tc => !toolMessageIds.has(tc.id));
-                            if (hasOrphan) {
-                                debugLog(`cleaning up AIMessage with orphan tool calls id=${m.id}`);
-                                continue;
-                            }
-                        }
-                        cleaned.push(m);
-                    }
-                    if (cleaned.length !== messages.length) {
-                        await agent.updateState({ configurable: { thread_id: options.threadId } }, { messages: cleaned }, 'callModel');
-                    }
-                }
-                catch (cleanupError) {
-                    debugLog(`failed to cleanup history: ${cleanupError}`);
-                }
-                push({ type: 'status', text: 'Paused' });
-            }
-            else {
-                push({
-                    type: 'on_tool_error',
-                    error: error instanceof Error ? error.message : String(error),
-                });
-            }
-        }
-        finally {
-            debugLog(`agent.stream done thread_id=${options.threadId}`);
-            completed = true;
-            const resolve = waiters.shift();
-            resolve?.();
-        }
-    })();
-    while (!completed || queue.length) {
-        if (!queue.length) {
-            await new Promise(resolve => waiters.push(resolve));
-            continue;
-        }
-        yield queue.shift();
-    }
-    await run;
-}

package/dist/conversation/chatHistory.d.ts

@@ -1,24 +0,0 @@
-import { type TranscriptItem } from '../shared/types.js';
-export type HistoryMessage = {
-    role: 'user' | 'assistant';
-    content: string;
-};
-export type ThreadSnapshot = {
-    messages: HistoryMessage[];
-    todos: Array<{
-        id: string;
-        task: string;
-        status: 'pending' | 'in_progress' | 'completed';
-    }>;
-};
-export declare function loadThreadSnapshot(threadId: string): ThreadSnapshot;
-export declare function loadChatHistory(threadId: string): TranscriptItem[];
-export type ChatEntry = {
-    threadId: string;
-    name: string | null;
-    createdAt: number;
-};
-export declare function initChatNames(): void;
-export declare function listChats(): ChatEntry[];
-export declare function saveThreadName(threadId: string, name: string): void;
-export declare function generateThreadName(firstUserMessage: string): Promise<string>;

package/dist/conversation/chatHistory.js

@@ -1,251 +0,0 @@
-import { HumanMessage } from '@langchain/core/messages';
-import { db, model, COMPACTION_SUMMARY_SENTINEL } from './agentGraph.js';
-import { resolveToolUi, buildToolUiVars, renderToolTemplate, } from '../tooling/toolConfig.js';
-function loadFullHistoryMessages(threadId) {
-    try {
-        const row = db
-            .prepare(`SELECT messages_json FROM chat_messages_full WHERE thread_id = ?`)
-            .get(threadId);
-        if (!row)
-            return null;
-        const stored = JSON.parse(row.messages_json);
-        // Re-shape storage format into the same shape loaders expect (id-tagged LangChain JSON).
-        return stored.map(m => ({
-            id: [
-                'langchain_core',
-                'messages',
-                m.type === 'human'
-                    ? 'HumanMessage'
-                    : m.type === 'ai'
-                        ? 'AIMessage'
-                        : m.type === 'tool'
-                            ? 'ToolMessage'
-                            : m.type === 'system'
-                                ? 'SystemMessage'
-                                : 'BaseMessage',
-            ],
-            kwargs: {
-                content: m.content,
-                tool_calls: m.tool_calls,
-                tool_call_id: m.tool_call_id,
-                name: m.name,
-            },
-        }));
-    }
-    catch {
-        return null;
-    }
-}
-function isCompactionSummaryMessage(msg) {
-    const c = msg?.kwargs?.content;
-    const text = Array.isArray(c)
-        ? c
-            .map((b) => (typeof b === 'string' ? b : b?.text ?? ''))
-            .join('')
-        : String(c ?? '');
-    return text.startsWith(COMPACTION_SUMMARY_SENTINEL);
-}
-export function loadThreadSnapshot(threadId) {
-    try {
-        const row = db
-            .prepare(`SELECT checkpoint FROM checkpoints WHERE thread_id = ? AND checkpoint_ns = '' ORDER BY checkpoint_id DESC LIMIT 1`)
-            .get(threadId);
-        if (!row)
-            return { messages: [], todos: [] };
-        const parsed = JSON.parse(row.checkpoint);
-        const fullHistory = loadFullHistoryMessages(threadId);
-        const rawMessages = (fullHistory ?? parsed.channel_values?.messages ?? []).filter((m) => !isCompactionSummaryMessage(m));
-        const todos = parsed.channel_values?.todos ?? [];
-        const messages = [];
-        for (const msg of rawMessages) {
-            const msgType = Array.isArray(msg.id)
-                ? msg.id[msg.id.length - 1]
-                : '';
-            const rawContent = msg.kwargs?.content;
-            if (msgType === 'HumanMessage') {
-                const content = Array.isArray(rawContent)
-                    ? rawContent
-                        .filter((b) => b.type === 'text')
-                        .map((b) => b.text ?? '')
-                        .join('')
-                    : String(rawContent ?? '');
-                messages.push({ role: 'user', content });
-            }
-            else if (msgType === 'AIMessage' || msgType === 'AIMessageChunk') {
-                const content = Array.isArray(rawContent)
-                    ? rawContent
-                        .filter((b) => b.type === 'text')
-                        .map((b) => b.text ?? '')
-                        .join('')
-                    : String(rawContent ?? '');
-                if (content)
-                    messages.push({ role: 'assistant', content });
-            }
-        }
-        return { messages, todos };
-    }
-    catch {
-        return { messages: [], todos: [] };
-    }
-}
-export function loadChatHistory(threadId) {
-    try {
-        const row = db
-            .prepare(`SELECT checkpoint FROM checkpoints WHERE thread_id = ? AND checkpoint_ns = '' ORDER BY checkpoint_id DESC LIMIT 1`)
-            .get(threadId);
-        if (!row)
-            return [];
-        const parsed = JSON.parse(row.checkpoint);
-        const fullHistory = loadFullHistoryMessages(threadId);
-        const rawMessages = (fullHistory ?? parsed.channel_values?.messages ?? []).filter((m) => !isCompactionSummaryMessage(m));
-        // Build map of tool_call_id -> tool result content for look-ahead
-        const toolResultMap = new Map();
-        for (const msg of rawMessages) {
-            const msgType = Array.isArray(msg.id)
-                ? msg.id[msg.id.length - 1]
-                : '';
-            if (msgType === 'ToolMessage') {
-                const toolCallId = msg.kwargs?.tool_call_id ?? '';
-                const rawContent = msg.kwargs?.content;
-                const content = typeof rawContent === 'string'
-                    ? rawContent
-                    : JSON.stringify(rawContent ?? '');
-                if (toolCallId)
-                    toolResultMap.set(toolCallId, content);
-            }
-        }
-        const items = [];
-        let counter = 0;
-        for (const msg of rawMessages) {
-            const msgType = Array.isArray(msg.id)
-                ? msg.id[msg.id.length - 1]
-                : '';
-            const rawContent = msg.kwargs?.content;
-            if (msgType === 'HumanMessage') {
-                const text = Array.isArray(rawContent)
-                    ? rawContent
-                        .filter((b) => b.type === 'text')
-                        .map((b) => String(b.text ?? ''))
-                        .join('')
-                    : String(rawContent ?? '');
-                items.push({ id: `hist-${counter++}`, role: 'user', text });
-            }
-            else if (msgType === 'AIMessage' || msgType === 'AIMessageChunk') {
-                const text = Array.isArray(rawContent)
-                    ? rawContent
-                        .filter((b) => b.type === 'text')
-                        .map((b) => String(b.text ?? ''))
-                        .join('')
-                    : String(rawContent ?? '');
-                if (text) {
-                    items.push({
-                        id: `hist-${counter++}`,
-                        role: 'assistant',
-                        text,
-                        timestamp: '',
-                    });
-                }
-                // Emit tool start + end items for each tool_call on this AI message
-                const toolCalls = msg.kwargs?.tool_calls ?? [];
-                for (const tc of toolCalls) {
-                    const toolName = tc.name ?? 'tool';
-                    const input = JSON.stringify(tc.args ?? {});
-                    const output = toolResultMap.get(tc.id ?? '') ?? '';
-                    const cfg = resolveToolUi(toolName);
-                    const vars = buildToolUiVars({
-                        toolName,
-                        input,
-                        output,
-                        toolCallId: tc.id,
-                        runId: `hist-${counter}`,
-                        maxInputPreview: cfg.maxInputPreview,
-                        maxOutputPreview: cfg.maxOutputPreview,
-                        placeholders: cfg.placeholders,
-                    });
-                    items.push({
-                        id: `hist-${counter++}-start`,
-                        role: 'tool',
-                        kind: 'start',
-                        toolName,
-                        text: renderToolTemplate(cfg.onCallTemplate, vars),
-                    });
-                    if (output) {
-                        items.push({
-                            id: `hist-${counter++}-end`,
-                            role: 'tool',
-                            kind: 'end',
-                            toolName,
-                            text: renderToolTemplate(cfg.onResultTemplate, vars),
-                        });
-                    }
-                }
-            }
-            // ToolMessage entries are consumed via toolResultMap; skip standalone
-        }
-        return items;
-    }
-    catch {
-        return [];
-    }
-}
-let chatNamesInitialized = false;
-export function initChatNames() {
-    db.exec(`
-		CREATE TABLE IF NOT EXISTS chat_names (
-			thread_id TEXT PRIMARY KEY,
-			name TEXT NOT NULL,
-			created_at INTEGER NOT NULL
-		)
-	`);
-}
-export function listChats() {
-    if (!chatNamesInitialized) {
-        initChatNames();
-        chatNamesInitialized = true;
-    }
-    try {
-        const rows = db
-            .prepare(`SELECT DISTINCT c.thread_id, cn.name, cn.created_at
-				 FROM checkpoints c
-				 LEFT JOIN chat_names cn ON cn.thread_id = c.thread_id
-				 ORDER BY COALESCE(cn.created_at, 0) DESC`)
-            .all();
-        return rows.map(row => ({
-            threadId: row.thread_id,
-            name: row.name ?? null,
-            createdAt: row.created_at ?? 0,
-        }));
-    }
-    catch {
-        return [];
-    }
-}
-export function saveThreadName(threadId, name) {
-    if (!chatNamesInitialized) {
-        initChatNames();
-        chatNamesInitialized = true;
-    }
-    db.prepare(`INSERT INTO chat_names (thread_id, name, created_at) VALUES (?, ?, ?)
-		 ON CONFLICT(thread_id) DO UPDATE SET name = excluded.name`).run(threadId, name, Date.now());
-}
-export async function generateThreadName(firstUserMessage) {
-    try {
-        const response = await model.invoke([
-            new HumanMessage(`Name this conversation in 6 words or fewer, title case, no punctuation: ${firstUserMessage}`),
-        ]);
-        let text;
-        if (Array.isArray(response.content)) {
-            text = response.content
-                .map(b => (typeof b === 'string' ? b : b.text ?? ''))
-                .join('')
-                .trim();
-        }
-        else {
-            text = String(response.content).trim();
-        }
-        return text || `Conversation ${Date.now()}`;
-    }
-    catch {
-        return `Conversation ${Date.now()}`;
-    }
-}

package/dist/conversation/compactionUtils.d.ts

@@ -1,17 +0,0 @@
-/**
- * Pure, side-effect-free helpers for context compaction.
- * No database, no LLM, no graph — safe to import in tests.
- */
-import { type BaseMessage } from '@langchain/core/messages';
-export declare function estimateTokens(messages: BaseMessage[]): number;
-export declare function shouldCompactMessages(messages: BaseMessage[], opts: {
-    threshold: number;
-    contextWindow: number;
-}): boolean;
-/**
- * Returns the index at which the kept tail begins.
- * Messages before keepStart will be summarized and removed.
- * Guarantees the boundary never splits an AIMessage-with-tool-calls
- * from its following ToolMessages.
- */
-export declare function computeKeepStart(messages: BaseMessage[], tokensToKeep: number): number;

package/dist/conversation/compactionUtils.js

@@ -1,57 +0,0 @@
-/**
- * Pure, side-effect-free helpers for context compaction.
- * No database, no LLM, no graph — safe to import in tests.
- */
-// Char/4 token estimation — no native tiktoken dep, sufficient for thresholding.
-export function estimateTokens(messages) {
-    let chars = 0;
-    for (const m of messages) {
-        const c = m.content;
-        if (typeof c === 'string') {
-            chars += c.length;
-        }
-        else if (Array.isArray(c)) {
-            for (const block of c) {
-                if (typeof block === 'string')
-                    chars += block.length;
-                else if (block && typeof block === 'object' && 'text' in block) {
-                    chars += String(block.text || '').length;
-                }
-            }
-        }
-        const toolCalls = m.tool_calls;
-        if (toolCalls && toolCalls.length > 0) {
-            for (const tc of toolCalls) {
-                chars += JSON.stringify(tc.args ?? {}).length + (tc.name?.length ?? 0);
-            }
-        }
-    }
-    return Math.ceil(chars / 4);
-}
-export function shouldCompactMessages(messages, opts) {
-    const used = estimateTokens(messages);
-    return used >= opts.threshold * opts.contextWindow;
-}
-/**
- * Returns the index at which the kept tail begins.
- * Messages before keepStart will be summarized and removed.
- * Guarantees the boundary never splits an AIMessage-with-tool-calls
- * from its following ToolMessages.
- */
-export function computeKeepStart(messages, tokensToKeep) {
-    let runningTokens = 0;
-    let keepStart = messages.length;
-    for (let i = messages.length - 1; i >= 0; i--) {
-        const t = estimateTokens([messages[i]]);
-        if (runningTokens + t > tokensToKeep)
-            break;
-        runningTokens += t;
-        keepStart = i;
-    }
-    // Advance past any ToolMessages to avoid breaking AIMessage+ToolMessage pairs.
-    while (keepStart < messages.length &&
-        messages[keepStart]._getType() === 'tool') {
-        keepStart++;
-    }
-    return keepStart;
-}

package/dist/conversation/prompts/planPrompt.d.ts

@@ -1 +0,0 @@
-export declare const PLAN_MODE_PROMPT = "<plan_mode>\nYou are operating in PLAN MODE. Your only job is to produce a written implementation plan \u2014 do NOT write, edit, or execute any files or shell commands.\n\nRULES:\n1. Use the `writePlanTool` to output your plan. Do not use `writeFileTool`, `editFileTool`, or `shellTool`.\n2. Analyse the user's request thoroughly before writing. Ask clarifying questions if requirements are ambiguous.\n3. The plan must be a complete, step-by-step implementation guide in Markdown.\n4. After calling `writePlanTool`, wait for user feedback or acceptance from the browser review page.\n5. If you receive a message starting with \"Received user feedback:\", revise and re-call `writePlanTool` with the updated plan.\n\nYou are blocked from modifying the codebase in plan mode. Focus exclusively on producing the plan document.\n</plan_mode>";

package/dist/conversation/prompts/planPrompt.js

@@ -1,12 +0,0 @@
-export const PLAN_MODE_PROMPT = `<plan_mode>
-You are operating in PLAN MODE. Your only job is to produce a written implementation plan — do NOT write, edit, or execute any files or shell commands.
-
-RULES:
-1. Use the \`writePlanTool\` to output your plan. Do not use \`writeFileTool\`, \`editFileTool\`, or \`shellTool\`.
-2. Analyse the user's request thoroughly before writing. Ask clarifying questions if requirements are ambiguous.
-3. The plan must be a complete, step-by-step implementation guide in Markdown.
-4. After calling \`writePlanTool\`, wait for user feedback or acceptance from the browser review page.
-5. If you receive a message starting with "Received user feedback:", revise and re-call \`writePlanTool\` with the updated plan.
-
-You are blocked from modifying the codebase in plan mode. Focus exclusively on producing the plan document.
-</plan_mode>`;

package/dist/conversation/prompts/systemPrompt.d.ts

@@ -1,29 +0,0 @@
-/**
- * System prompts for the LangChain agent.
- *
- * Customize these prompts to change your agent's behavior and personality.
- */
-import type { BaseMessage } from '@langchain/core/messages';
-/**
- * Marks ephemeral per-turn system messages that carry the host date/time; stripped before persisting thread history.
- */
-export declare const CODEMAX_TURN_DATETIME_MARKER: "<!--codemax-datetime-context-->";
-/**
- * Current local date/time using the host OS time zone and locale (via Intl).
- */
-export declare function formatLocalDateTimeContext(): string;
-/**
- * Content for a single-turn HumanMessage injected before each agent invocation.
- * Using a user message (not system) keeps the system prompt stable for prompt caching.
- */
-export declare function buildCodemaxTurnDatetimeUserContent(): string;
-/**
- * Removes the ephemeral datetime user message from graph output so REPL history does not accumulate it.
- */
-export declare function stripCodemaxTurnDatetimeFromMessages(messages: BaseMessage[]): BaseMessage[];
-/**
- * The main system prompt that defines the agent's behavior.
- * This is passed to createAgent as the systemPrompt parameter.
- */
-export declare const COMPACT_SUMMARY_PROMPT = "You are compacting a long agentic coding session. Produce a detailed summary preserving:\n- The user's overarching goals and the current task being worked on.\n- All file paths read, written, or modified and their purposes.\n- Key decisions and their rationale.\n- Current todo state and in-progress work.\n- Important tool results (errors, search hits, file contents that informed decisions).\n- Open questions and unresolved blockers.\n\nBe specific \u2014 preserve exact filenames, function names, identifiers, command outputs, and error messages. Format as structured Markdown with clear sections. Do not omit details that would be needed to continue the work seamlessly.";
-export declare const SYSTEM_PROMPT = "\n<role>\n\nYou are CodeMax, the next-generation code agent.\nYou are responsible for solving software development tasks by generating code, explanations, and reasoning steps.\n\n</role>\n\n<general_instructions>\n\n- When the conversation includes a system message with the host's current local date and time (and time zone), use it for anything that depends on \"now\", \"today\", or scheduling.\n- You will receive a task and you will need to solve it.\n- The first step is to understand the task and the context by reading the codebase documentation and codebase, and write a TO-DO list of the steps you need to take to solve the task using the 'todoTool'.\n- As you progress through the task, you must update the status of the items in the TO-DO list using the 'todoTool'.\n\n</general_instructions>\n\n<rules>\n\nWhen rules are injected into this conversation, you MUST follow them strictly and without exception.\nRules override your default behavior. They are not suggestions \u2014 treat them as hard constraints.\nIf a rule conflicts with a general instruction, the rule wins.\n\n</rules>\n\n<file_reading>\n\n- NEVER read an entire file unless you are certain you need every line.\n- Always use 'startLine' and 'endLine' to read only the portion you need.\n- If you do not know how many lines a file has or where the relevant section is, start by reading lines 1\u201320 to orient yourself, then read further ranges as needed.\n- Prefer multiple small reads over one large read.\n\n</file_reading>\n\n<todo_tool>\n  - Use the 'todoTool' to manage your task list.\n  - Actions: 'add', 'update', 'remove', 'list'.\n  - Statuses: 'pending', 'in_progress', 'completed'.\n  - When starting a task, 'add' all the steps you identified.\n  - When you start working on a step, 'update' its status to 'in_progress'.\n  - When you finish a step, 'update' its status to 'completed'.\n</todo_tool>\n\n<subagents>\n\n  - You are able to use subagents to help you solve tasks.\n  - You can delegate tasks for subagents to solve.\n  - For delegation, you must use the 'subagent' tool.\n  - The subagent tool will return a report of the task completion.\n  - The report will be a JSON file with the following properties:\n    - 'status': 'success' or 'error'\n    - 'message': a short description of the result\n    - 'data': the data returned by the subagent\n    - 'files': a list of dictionaries with the following properties:\n      - 'path': the path of the file\n      - 'content': a short description of what he did in the file\n</subagents>\n\n\n\n<response_format>\n\n- You must NEVER answer with emojis.\n- You must ALWAYS answer with markdown headings and markdown bullet points.\n- You must ALWAYS answer with a clear and concise response.\n- Your answers must be ALWAYS about what the user wants to know about or what you have done in your work.\n- NEVER answer with unnecessary facts or anything that doesn't relate to the user's request, your answer, or what the user wants to know.\n\n</response_format>\n";