@roackb2/heddle 0.0.14 → 0.0.16

package/dist/src/core/agent/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../../src/core/agent/util.ts"],"names":[],"mappings":"AAIA,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAOtE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAWtD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAoBxE;AAWD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAMzE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAUlD;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAKtF"}

package/dist/src/core/agent/util.js.map

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

package/dist/src/core/chat/compaction.d.ts

@@ -0,0 +1,17 @@
+import type { ChatMessage, LlmUsage } from '../../index.js';
+import type { ChatContextStats } from './types.js';
+export declare function compactChatHistory(options: {
+    history: ChatMessage[];
+    model: string;
+    usage?: LlmUsage;
+    force?: boolean;
+    systemContext?: string;
+    toolNames?: string[];
+    goal?: string;
+}): {
+    history: ChatMessage[];
+    context: ChatContextStats;
+};
+export declare function estimateChatHistoryTokens(history: ChatMessage[]): number;
+export declare function isCompactedHistorySummary(message: ChatMessage): boolean;
+//# sourceMappingURL=compaction.d.ts.map

package/dist/src/core/chat/compaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../../../src/core/chat/compaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAUnD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE;IAC1C,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG;IAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,CAkCxD;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAExE;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAEvE"}

package/dist/src/core/chat/compaction.js

@@ -0,0 +1,159 @@
+import { buildSystemPrompt } from '../prompts/system-prompt.js';
+import { estimateBuiltInContextWindow } from '../llm/openai-models.js';
+const DEFAULT_CONTEXT_WINDOW_ESTIMATE = 200_000;
+const MAX_HISTORY_RATIO = 0.6;
+const MIN_RECENT_MESSAGES = 16;
+const MIN_FORCED_RECENT_MESSAGES = 3;
+const MAX_SUMMARY_LINES = 12;
+const MAX_SUMMARY_CHARS = 4_000;
+const COMPACTED_HISTORY_MARKER = 'Heddle compacted earlier conversation history.';
+export function compactChatHistory(options) {
+    const estimatedWindow = estimateBuiltInContextWindow(options.model) ?? DEFAULT_CONTEXT_WINDOW_ESTIMATE;
+    const maxHistoryTokens = Math.floor(estimatedWindow * MAX_HISTORY_RATIO);
+    const minRecentMessages = options.force ? MIN_FORCED_RECENT_MESSAGES : MIN_RECENT_MESSAGES;
+    let nextHistory = options.history;
+    let compactedMessages = 0;
+    while ((estimateChatHistoryTokens(nextHistory) > maxHistoryTokens || (options.force && compactedMessages === 0)) &&
+        countNonCompactedMessages(nextHistory) > minRecentMessages) {
+        const splitIndex = findCompactionSplit(nextHistory, minRecentMessages);
+        if (splitIndex <= 0 || splitIndex >= nextHistory.length) {
+            break;
+        }
+        compactedMessages += countNonCompactedMessages(nextHistory.slice(0, splitIndex));
+        nextHistory = buildCompactedHistory(nextHistory, splitIndex);
+    }
+    return {
+        history: nextHistory,
+        context: buildContextStats({
+            history: nextHistory,
+            usage: options.usage,
+            compactedMessages,
+            estimatedRequestTokens: estimateRequestTokens({
+                history: nextHistory,
+                systemContext: options.systemContext,
+                toolNames: options.toolNames ?? [],
+                goal: options.goal,
+            }),
+        }),
+    };
+}
+export function estimateChatHistoryTokens(history) {
+    return history.reduce((total, message) => total + estimateMessageTokens(message), 0);
+}
+export function isCompactedHistorySummary(message) {
+    return message.role === 'system' && message.content.startsWith(COMPACTED_HISTORY_MARKER);
+}
+function buildContextStats(options) {
+    return {
+        estimatedHistoryTokens: estimateChatHistoryTokens(options.history),
+        estimatedRequestTokens: options.estimatedRequestTokens,
+        lastRunInputTokens: options.usage?.inputTokens,
+        lastRunOutputTokens: options.usage?.outputTokens,
+        lastRunTotalTokens: options.usage?.totalTokens,
+        cachedInputTokens: options.usage?.cachedInputTokens,
+        reasoningTokens: options.usage?.reasoningTokens,
+        compactedMessages: options.compactedMessages > 0 ? options.compactedMessages : undefined,
+        compactedAt: options.compactedMessages > 0 ? new Date().toISOString() : undefined,
+    };
+}
+function buildCompactedHistory(history, splitIndex) {
+    const archived = history.slice(0, splitIndex);
+    const recent = history.slice(splitIndex);
+    const priorSummary = extractPriorSummary(archived);
+    const visibleLines = archived
+        .filter((message) => !isCompactedHistorySummary(message))
+        .flatMap(summarizeMessageForCompaction)
+        .slice(-MAX_SUMMARY_LINES);
+    const summaryParts = [COMPACTED_HISTORY_MARKER];
+    if (priorSummary) {
+        summaryParts.push('', 'Earlier compacted summary:', priorSummary);
+    }
+    if (visibleLines.length > 0) {
+        summaryParts.push('', 'More recent archived turns:', ...visibleLines);
+    }
+    const compactedSummary = {
+        role: 'system',
+        content: truncateSummary(summaryParts.join('\n')),
+    };
+    return [compactedSummary, ...recent];
+}
+function extractPriorSummary(history) {
+    const summaryMessage = history.find(isCompactedHistorySummary);
+    if (!summaryMessage || summaryMessage.role !== 'system') {
+        return undefined;
+    }
+    return summaryMessage.content.slice(COMPACTED_HISTORY_MARKER.length).trim() || undefined;
+}
+function summarizeMessageForCompaction(message) {
+    if (message.role === 'user') {
+        return [`User: ${truncateLine(message.content, 220)}`];
+    }
+    if (message.role === 'assistant') {
+        const lines = [`Assistant: ${truncateLine(message.content, 220)}`];
+        if (message.toolCalls?.length) {
+            lines.push(`Assistant tool calls: ${message.toolCalls.map((call) => call.tool).join(', ')}`);
+        }
+        return lines;
+    }
+    if (message.role === 'tool') {
+        return [`Tool result recorded for ${message.toolCallId}.`];
+    }
+    return [];
+}
+function truncateSummary(value) {
+    if (value.length <= MAX_SUMMARY_CHARS) {
+        return value;
+    }
+    return `${value.slice(0, MAX_SUMMARY_CHARS - 1).trimEnd()}…`;
+}
+function truncateLine(value, maxChars) {
+    const compact = value.replace(/\s+/g, ' ').trim();
+    if (compact.length <= maxChars) {
+        return compact;
+    }
+    return `${compact.slice(0, maxChars - 1).trimEnd()}…`;
+}
+function countNonCompactedMessages(history) {
+    return history.filter((message) => !isCompactedHistorySummary(message)).length;
+}
+function findCompactionSplit(history, minRecentMessages) {
+    let splitIndex = Math.max(0, history.length - minRecentMessages);
+    while (splitIndex < history.length && history[splitIndex]?.role === 'tool') {
+        splitIndex++;
+    }
+    while (splitIndex < history.length &&
+        splitIndex > 0 &&
+        isAssistantToolCallMessage(history[splitIndex - 1])) {
+        splitIndex++;
+        while (splitIndex < history.length && history[splitIndex]?.role === 'tool') {
+            splitIndex++;
+        }
+    }
+    return splitIndex;
+}
+function estimateMessageTokens(message) {
+    if (isCompactedHistorySummary(message)) {
+        return estimateTextTokens(message.content) + 12;
+    }
+    switch (message.role) {
+        case 'system':
+        case 'user':
+        case 'tool':
+            return estimateTextTokens(message.content) + 12;
+        case 'assistant':
+            return estimateTextTokens(message.content) + 12 + (message.toolCalls?.length ?? 0) * 24;
+    }
+}
+function estimateTextTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+function estimateRequestTokens(options) {
+    const syntheticGoal = options.goal ?? 'Continue from the current conversation.';
+    const systemPrompt = buildSystemPrompt(syntheticGoal, options.toolNames, options.systemContext);
+    const userPrompt = syntheticGoal;
+    return estimateTextTokens(systemPrompt) + estimateChatHistoryTokens(options.history) + estimateTextTokens(userPrompt) + 24;
+}
+function isAssistantToolCallMessage(message) {
+    return message?.role === 'assistant' && !!message.toolCalls && message.toolCalls.length > 0;
+}
+//# sourceMappingURL=compaction.js.map

package/dist/src/core/chat/compaction.js.map

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

package/dist/src/core/chat/format.d.ts

@@ -0,0 +1,12 @@
+import type { ChatMessage, TraceEvent } from '../../index.js';
+import type { ConversationLine } from './types.js';
+export type ChatFailureHintOptions = {
+    model: string;
+    estimatedHistoryTokens?: number;
+};
+export declare function buildConversationMessages(history: ChatMessage[]): ConversationLine[];
+export declare function summarizeTrace(trace: TraceEvent[]): string[];
+export declare function countAssistantSteps(trace: TraceEvent[]): number;
+export declare function formatChatFailureMessage(message: string, options: ChatFailureHintOptions): string;
+export declare function truncate(value: string, maxLength: number): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/src/core/chat/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../../src/core/chat/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAInD,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,gBAAgB,EAAE,CA6BpF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,CAgC5D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,MAAM,CAE/D;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,MAAM,CAcjG;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAMjE"}

package/dist/src/core/chat/format.js

@@ -0,0 +1,139 @@
+import { isCompactedHistorySummary } from './compaction.js';
+const MAX_TOOL_CALL_SUMMARY_CHARS = 96;
+export function buildConversationMessages(history) {
+    return history.flatMap((message, index) => {
+        if (isCompactedHistorySummary(message)) {
+            return [{
+                    id: `compacted-${index}`,
+                    role: 'assistant',
+                    text: 'Earlier conversation history was compacted to preserve context for longer chats.',
+                }];
+        }
+        if (message.role === 'user' || message.role === 'assistant') {
+            if (!message.content.trim()) {
+                return [];
+            }
+            return [{ id: `${message.role}-${index}-${message.content}`, role: message.role, text: message.content }];
+        }
+        if (message.role === 'tool') {
+            const rendered = renderToolHistoryMessage(message, history, index);
+            if (!rendered) {
+                return [];
+            }
+            return [{ id: `tool-${index}-${rendered}`, role: 'assistant', text: rendered }];
+        }
+        return [];
+    });
+}
+export function summarizeTrace(trace) {
+    return trace.flatMap((event) => {
+        switch (event.type) {
+            case 'assistant.turn':
+                return [
+                    ...(event.diagnostics?.rationale ? [`reasoning: ${truncate(event.diagnostics.rationale, 140)}`] : []),
+                    event.requestedTools ?
+                        `assistant requested ${event.toolCalls?.map((call) => summarizeToolCall(call.tool, call.input)).join(', ')}`
+                        : 'assistant answered',
+                ];
+            case 'tool.approval_requested':
+                return [`approval requested for ${summarizeToolCall(event.call.tool, event.call.input)}`];
+            case 'tool.approval_resolved':
+                return [
+                    `approval ${event.approved ? 'granted' : 'denied'} for ${summarizeToolCall(event.call.tool, event.call.input)}${event.reason ? ` (${truncate(event.reason, 80)})` : ''}`,
+                ];
+            case 'tool.fallback':
+                return [
+                    `fallback ${summarizeToolCall(event.fromCall.tool, event.fromCall.input)} -> ${summarizeToolCall(event.toCall.tool, event.toCall.input)} (${event.reason})`,
+                ];
+            case 'tool.call':
+                return [`tool call ${summarizeToolCall(event.call.tool, event.call.input)}`];
+            case 'tool.result':
+                return [
+                    `tool result ${event.tool}: ${event.result.ok ? 'ok' : event.result.error ?? 'error'}`,
+                ];
+            case 'run.finished':
+                return [`run finished: ${event.outcome}`];
+            default:
+                return [];
+        }
+    });
+}
+export function countAssistantSteps(trace) {
+    return trace.filter((event) => event.type === 'assistant.turn').length;
+}
+export function formatChatFailureMessage(message, options) {
+    if (looksLikeAnthropicInputRateLimit(message)) {
+        const sizeHint = typeof options.estimatedHistoryTokens === 'number' ?
+            ` Current session history is estimated at about ${options.estimatedHistoryTokens.toLocaleString()} tokens before the next request.`
+            : '';
+        return `${message}\n\nThis likely failed because the current prompt plus session history are too large for ${options.model}'s input-token-per-minute limit.${sizeHint} Try /compact, /clear, or /session new, then retry.`;
+    }
+    if (looksLikeOpenAiQuotaError(message)) {
+        return `${message}\n\nThis looks like an OpenAI quota or billing limit for the active key, not a transient prompt-size issue. Switch providers or check the OpenAI account quota and billing state.`;
+    }
+    return message;
+}
+export function truncate(value, maxLength) {
+    if (value.length <= maxLength) {
+        return value;
+    }
+    return `${value.slice(0, maxLength - 1)}…`;
+}
+function summarizeToolCall(tool, input) {
+    const shellCommand = extractShellCommand(input);
+    if (shellCommand) {
+        return `${tool} (${truncate(shellCommand, MAX_TOOL_CALL_SUMMARY_CHARS)})`;
+    }
+    const path = extractPathField(input);
+    if (path) {
+        return `${tool} (${truncate(path, MAX_TOOL_CALL_SUMMARY_CHARS)})`;
+    }
+    return tool;
+}
+function extractShellCommand(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return undefined;
+    }
+    const command = value.command;
+    return typeof command === 'string' && command.trim() ? command.trim() : undefined;
+}
+function extractPathField(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return undefined;
+    }
+    const path = value.path;
+    return typeof path === 'string' && path.trim() ? path.trim() : undefined;
+}
+function renderToolHistoryMessage(message, history, index) {
+    const priorAssistant = findPriorAssistantWithToolCall(history, index, message.toolCallId);
+    const toolName = priorAssistant?.toolCalls?.find((call) => call.id === message.toolCallId)?.tool ?? 'tool';
+    const summary = message.content.trim();
+    if (!summary) {
+        return `${toolName} returned no visible output.`;
+    }
+    return `${toolName}: ${summary}`;
+}
+function findPriorAssistantWithToolCall(history, index, toolCallId) {
+    for (let cursor = index - 1; cursor >= 0; cursor--) {
+        const candidate = history[cursor];
+        if (candidate?.role !== 'assistant' || !candidate.toolCalls?.length) {
+            continue;
+        }
+        if (candidate.toolCalls.some((call) => call.id === toolCallId)) {
+            return candidate;
+        }
+    }
+    return undefined;
+}
+function looksLikeAnthropicInputRateLimit(message) {
+    const normalized = message.toLowerCase();
+    return (normalized.includes('input tokens per minute')
+        || (normalized.includes('reduce the prompt length') && normalized.includes('maximum tokens requested'))
+        || (normalized.includes('rate_limit_error') && normalized.includes('tokens per minute')));
+}
+function looksLikeOpenAiQuotaError(message) {
+    const normalized = message.toLowerCase();
+    return (normalized.includes('exceeded your current quota')
+        || (normalized.includes('billing details') && normalized.includes('quota')));
+}
+//# sourceMappingURL=format.js.map

package/dist/src/core/chat/format.js.map

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

package/dist/src/core/chat/session-submit.d.ts

@@ -0,0 +1,22 @@
+import type { ToolCall, ToolDefinition } from '../../index.js';
+import type { ChatSession } from './types.js';
+import type { AgentLoopEvent } from '../../index.js';
+export type SubmitChatSessionPromptArgs = {
+    workspaceRoot: string;
+    stateRoot: string;
+    sessionStoragePath: string;
+    sessionId: string;
+    prompt: string;
+    onEvent?: (event: AgentLoopEvent) => void;
+    approveToolCall?: (call: ToolCall, tool: ToolDefinition) => Promise<{
+        approved: boolean;
+        reason?: string;
+    }>;
+    abortSignal?: AbortSignal;
+};
+export declare function submitChatSessionPrompt(args: SubmitChatSessionPromptArgs): Promise<{
+    outcome: import("../types.js").StopReason;
+    summary: string;
+    session: ChatSession;
+}>;
+//# sourceMappingURL=session-submit.d.ts.map

package/dist/src/core/chat/session-submit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-submit.d.ts","sourceRoot":"","sources":["../../../../src/core/chat/session-submit.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAG/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,MAAM,2BAA2B,GAAG;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAC1C,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,KAAK,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5G,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B,CAAC;AAEF,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,2BAA2B;;;;GAmF9E"}

package/dist/src/core/chat/session-submit.js

@@ -0,0 +1,83 @@
+import { join } from 'node:path';
+import { createDefaultAgentTools, createLlmAdapter, DEFAULT_OPENAI_MODEL, inferProviderFromModel, runAgentLoop, } from '../../index.js';
+import { compactChatHistory, estimateChatHistoryTokens } from './compaction.js';
+import { loadChatSessions, saveChatSessions, touchSession } from './storage.js';
+import { buildConversationMessages, countAssistantSteps, formatChatFailureMessage, summarizeTrace } from './format.js';
+import { saveTrace } from './trace.js';
+import { resolveApiKeyForModel } from '../../core/runtime/api-keys.js';
+export async function submitChatSessionPrompt(args) {
+    const sessions = loadChatSessions(args.sessionStoragePath, true);
+    const session = sessions.find((candidate) => candidate.id === args.sessionId);
+    if (!session) {
+        throw new Error(`Chat session not found: ${args.sessionId}`);
+    }
+    const model = session.model ?? process.env.OPENAI_MODEL ?? process.env.ANTHROPIC_MODEL ?? DEFAULT_OPENAI_MODEL;
+    const provider = inferProviderFromModel(model);
+    const apiKey = resolveApiKeyForModel(model);
+    if (!apiKey) {
+        throw new Error(`Missing provider API key for ${provider}`);
+    }
+    const llm = createLlmAdapter({ model, apiKey });
+    const tools = createDefaultAgentTools({
+        model,
+        apiKey,
+        workspaceRoot: args.workspaceRoot,
+        memoryDir: join(args.stateRoot, 'memory'),
+        searchIgnoreDirs: [],
+        includePlanTool: true,
+    });
+    const result = await runAgentLoop({
+        goal: args.prompt,
+        model,
+        apiKey,
+        workspaceRoot: args.workspaceRoot,
+        stateDir: args.stateRoot,
+        memoryDir: join(args.stateRoot, 'memory'),
+        llm,
+        tools,
+        includeDefaultTools: false,
+        history: session.history,
+        onEvent: args.onEvent,
+        approveToolCall: args.approveToolCall,
+        abortSignal: args.abortSignal,
+    });
+    const compacted = compactChatHistory({
+        history: result.transcript,
+        model,
+        usage: result.usage,
+        toolNames: tools.map((tool) => tool.name),
+        goal: args.prompt,
+    });
+    const traceFile = saveTrace(join(args.stateRoot, 'traces'), result.trace);
+    const nextTurn = {
+        id: `server-turn-${Date.now()}`,
+        prompt: args.prompt,
+        outcome: result.outcome,
+        summary: result.summary,
+        steps: countAssistantSteps(result.trace),
+        traceFile,
+        events: summarizeTrace(result.trace),
+    };
+    const formattedSummary = result.outcome === 'error' ?
+        formatChatFailureMessage(result.summary, {
+            model,
+            estimatedHistoryTokens: estimateChatHistoryTokens(session.history),
+        })
+        : result.summary;
+    const updatedSession = touchSession({
+        ...session,
+        lastContinuePrompt: args.prompt,
+        history: compacted.history,
+        context: compacted.context,
+        messages: buildConversationMessages(compacted.history),
+        turns: [...session.turns, nextTurn].slice(-8),
+    });
+    const nextSessions = sessions.map((candidate) => candidate.id === session.id ? updatedSession : candidate);
+    saveChatSessions(args.sessionStoragePath, nextSessions);
+    return {
+        outcome: result.outcome,
+        summary: formattedSummary,
+        session: updatedSession,
+    };
+}
+//# sourceMappingURL=session-submit.js.map

package/dist/src/core/chat/session-submit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-submit.js","sourceRoot":"","sources":["../../../../src/core/chat/session-submit.ts"],"names":[],"mappings":"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"}

package/dist/src/core/chat/storage.d.ts

@@ -0,0 +1,33 @@
+import type { ChatContextStats, ChatSession, ConversationLine } from './types.js';
+type ChatSessionCatalogEntry = {
+    id: string;
+    name: string;
+    createdAt: string;
+    updatedAt: string;
+    model?: string;
+    driftEnabled?: boolean;
+    lastContinuePrompt?: string;
+    context?: ChatContextStats;
+};
+export declare function createInitialMessages(apiKeyPresent: boolean): ConversationLine[];
+export declare function createChatSession(options: {
+    id: string;
+    name: string;
+    apiKeyPresent: boolean;
+    model?: string;
+}): ChatSession;
+export declare function touchSession(session: ChatSession): ChatSession;
+export declare function summarizeSession(session: ChatSession): string;
+export declare function isGenericSessionName(name: string): boolean;
+export declare function loadChatSessions(sessionsPath: string, apiKeyPresent: boolean): ChatSession[];
+export declare function readChatSessionCatalog(sessionsPath: string): ChatSessionCatalogEntry[];
+export declare function readChatSession(sessionsPath: string, sessionId: string, apiKeyPresent: boolean): ChatSession | undefined;
+export declare function migrateLegacyChatSessions(sessionsPath: string, apiKeyPresent: boolean): ChatSession[];
+export declare function saveChatSessions(sessionsPath: string, sessions: ChatSession[]): void;
+export declare function deriveSessionStoragePaths(storagePath: string): {
+    legacyPath: string;
+    catalogPath: string;
+    sessionsDir: string;
+};
+export {};
+//# sourceMappingURL=storage.d.ts.map

package/dist/src/core/chat/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../../src/core/chat/storage.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,gBAAgB,EAAe,MAAM,YAAY,CAAC;AAG/F,KAAK,uBAAuB,GAAG;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,gBAAgB,CAAC;CAC5B,CAAC;AAOF,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,OAAO,GAAG,gBAAgB,EAAE,CAiBhF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,WAAW,CAed;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CAE9D;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAI7D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,WAAW,EAAE,CAkB5F;AAED,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,uBAAuB,EAAE,CAItF;AAED,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CASxH;AAED,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,WAAW,EAAE,CAQrG;AAED,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,QA0B7E;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM;;;;EAQ5D"}