@kernel.chat/kbot 2.27.0 → 3.0.0

package/dist/agent.d.ts

@@ -1,5 +1,9 @@
+import { ToolPipeline } from './tool-pipeline.js';
 import { type ProjectContext } from './context.js';
+import type { UIAdapter } from './ui-adapter.js';
 import { type ParsedMessage } from './multimodal.js';
+import { ResponseStream } from './streaming.js';
+import { type Checkpoint } from './checkpoint.js';
 export interface AgentOptions {
     agent?: string;
     model?: string;
@@ -14,6 +18,12 @@ export interface AgentOptions {
     multimodal?: ParsedMessage;
     /** Skip planner re-entry (prevents infinite loop when planner calls runAgent) */
     skipPlanner?: boolean;
+    /** UIAdapter for decoupled output (SDK use). Defaults to TerminalUIAdapter. */
+    ui?: UIAdapter;
+    /** Custom tool execution pipeline (overrides default permission/hook/metrics chain) */
+    pipeline?: ToolPipeline;
+    /** ResponseStream for structured event streaming (SDK/MCP/HTTP consumers) */
+    responseStream?: ResponseStream;
 }
 export interface AgentResponse {
     content: string;
@@ -31,4 +41,9 @@ export interface AgentResponse {
 export declare function runAgent(message: string, options?: AgentOptions): Promise<AgentResponse>;
 /** One-shot: run agent and print response */
 export declare function runAndPrint(message: string, options?: AgentOptions): Promise<void>;
+/**
+ * Resume an agent session from a checkpoint.
+ * Restores conversation messages and state, then continues execution.
+ */
+export declare function runAgentFromCheckpoint(checkpoint: Checkpoint, options?: AgentOptions): Promise<AgentResponse>;
 //# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAwBA,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAc1E,OAAO,EAA8E,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAkEhI,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uDAAuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,sDAAsD;IACtD,UAAU,CAAC,EAAE,aAAa,CAAA;IAC1B,iFAAiF;IACjF,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAGD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAC1E;AAqqBD,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,aAAa,CAAC,CAuhBxB;AAGD,6CAA6C;AAC7C,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAkEf"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAyBA,OAAO,EACL,YAAY,EAGb,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAc1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,EAA8E,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAChI,OAAO,EAAiD,cAAc,EAAoB,MAAM,gBAAgB,CAAA;AAShH,OAAO,EAAmC,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AA0DlF,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uDAAuD;IACvD,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,sDAAsD;IACtD,UAAU,CAAC,EAAE,aAAa,CAAA;IAC1B,iFAAiF;IACjF,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,+EAA+E;IAC/E,EAAE,CAAC,EAAE,SAAS,CAAA;IACd,uFAAuF;IACvF,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,6EAA6E;IAC7E,cAAc,CAAC,EAAE,cAAc,CAAA;CAChC;AAGD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAC1E;AAsqBD,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,aAAa,CAAC,CAyoBxB;AAGD,6CAA6C;AAC7C,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,IAAI,CAAC,CAkEf;AAGD;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,aAAa,CAAC,CAgCxB"}

package/dist/agent.js

@@ -10,7 +10,8 @@
 // 6. Verify: always confirm the output exists and is correct
 // 7. Learn: extract knowledge from every interaction for future use
 import { getByokKey, getByokProvider, getProviderModel, getProvider, estimateCost, isLocalProvider, warmOllamaModelCache, } from './auth.js';
-import { executeTool, getTool, getToolDefinitionsForApi, } from './tools/index.js';
+import { executeTool, getTool, getToolDefinitionsForApi, ensureLazyToolsLoaded, } from './tools/index.js';
+import { createDefaultPipeline, } from './tool-pipeline.js';
 import { formatContextForPrompt } from './context.js';
 import { getMatrixSystemPrompt } from './matrix.js';
 import { buildFullLearningContext, findPattern, recordPattern, cacheSolution, updateProfile, classifyTask, extractKeywords, learnFromExchange, updateProjectMemory, shouldAutoTrain, selfTrain, } from './learning.js';
@@ -19,7 +20,8 @@ import { autoCompact, compressToolResult } from './context-manager.js';
 import { learnedRoute, recordRoute } from './learned-router.js';
 import { buildCacheablePrompt, createPromptSections } from './prompt-cache.js';
 import { saveEmbeddingCache } from './embeddings.js';
-import { createSpinner, printToolCall, printToolResult, printResponse, printError, printInfo, printWarn } from './ui.js';
+import { printResponse, printError, printInfo, printWarn } from './ui.js';
+import { TerminalUIAdapter } from './ui-adapter.js';
 import { parseMultimodalMessage, toAnthropicContent } from './multimodal.js';
 import { streamAnthropicResponse, streamOpenAIResponse } from './streaming.js';
 import { checkPermission } from './permissions.js';
@@ -29,6 +31,8 @@ import { recordSuccess, recordFailure } from './provider-fallback.js';
 import { isSelfEvalEnabled, evaluateResponse } from './self-eval.js';
 import { EntropyScorer } from './entropy-context.js';
 import { LoopDetector } from './godel-limits.js';
+import { CheckpointManager, newSessionId } from './checkpoint.js';
+import { TelemetryEmitter } from './telemetry.js';
 const MAX_TOOL_LOOPS = 75;
 /** Maximum cumulative cost (USD) before auto-stopping tool loops */
 const MAX_COST_CEILING = 1.00;
@@ -488,10 +492,10 @@ async function callProviderStreaming(provider, apiKey, model, systemContext, mes
     const p = getProvider(provider);
     let state;
     if (p.apiStyle === 'anthropic') {
-        state = await streamAnthropicResponse(apiKey, p.apiUrl, model, systemContext, messages.map(m => ({ role: m.role, content: m.content })), tools, { thinking: options?.thinking, thinkingBudget: options?.thinkingBudget });
+        state = await streamAnthropicResponse(apiKey, p.apiUrl, model, systemContext, messages.map(m => ({ role: m.role, content: m.content })), tools, { thinking: options?.thinking, thinkingBudget: options?.thinkingBudget, responseStream: options?.responseStream });
     }
     else {
-        state = await streamOpenAIResponse(apiKey, p.apiUrl, model, systemContext, messages.map(m => ({ role: m.role, content: m.content })), tools);
+        state = await streamOpenAIResponse(apiKey, p.apiUrl, model, systemContext, messages.map(m => ({ role: m.role, content: m.content })), tools, { responseStream: options?.responseStream });
     }
     const result = {
         content: state.content,
@@ -653,6 +657,8 @@ async function callProvider(provider, apiKey, model, systemContext, messages, to
 }
 // ── Main agent loop ──
 export async function runAgent(message, options = {}) {
+    // UIAdapter: defaults to TerminalUIAdapter for CLI, can be overridden for SDK use
+    const ui = options.ui ?? new TerminalUIAdapter();
     const apiKey = getByokKey();
     const byokProvider = getByokProvider();
     const isLocal = byokProvider ? isLocalProvider(byokProvider) : false;
@@ -666,7 +672,7 @@ export async function runAgent(message, options = {}) {
     // Step 0: Parse multimodal content (images in message)
     const parsed = options.multimodal || parseMultimodalMessage(message);
     if (parsed.isMultimodal) {
-        printInfo(`(${parsed.imageCount} image${parsed.imageCount > 1 ? 's' : ''} attached)`);
+        ui.onInfo(`(${parsed.imageCount} image${parsed.imageCount > 1 ? 's' : ''} attached)`);
     }
     // Step 1: Local-first (skip if multimodal — needs AI to interpret)
     if (!parsed.isMultimodal) {
@@ -674,13 +680,13 @@ export async function runAgent(message, options = {}) {
         if (localResult !== null) {
             addTurn({ role: 'user', content: message });
             addTurn({ role: 'assistant', content: localResult });
-            printInfo('(handled locally — 0 tokens used)');
+            ui.onInfo('(handled locally — 0 tokens used)');
             return { content: localResult, agent: 'local', model: 'none', toolCalls: 0 };
         }
     }
     // Step 1.5: Complexity detection — auto-plan complex tasks
     if (isComplexTask(message) && !message.startsWith('/plan') && !options.skipPlanner) {
-        printInfo('Complex task detected. Using autonomous planner...');
+        ui.onInfo('Complex task detected. Using autonomous planner...');
         try {
             const { autonomousExecute, formatPlanSummary } = await import('./planner.js');
             const plan = await autonomousExecute(message, {
@@ -699,7 +705,7 @@ export async function runAgent(message, options = {}) {
         }
         catch {
             // Planner failed — fall through to regular agent loop
-            printWarn('Planner failed, falling back to direct execution...');
+            ui.onWarning('Planner failed, falling back to direct execution...');
         }
     }
     // Step 1.7: Learned routing — try cached route before defaulting
@@ -710,6 +716,9 @@ export async function runAgent(message, options = {}) {
         }
     }
     const tier = options.tier || 'free';
+    // Ensure lazy tools are loaded before building the tool list for the API.
+    // In one-shot mode, lazy tools may still be loading in background — await them here.
+    await ensureLazyToolsLoaded();
     const allTools = getToolDefinitionsForApi(tier);
     const casual = isCasualMessage(message);
     // Smart tool filtering:
@@ -830,6 +839,15 @@ Always quote file paths that contain spaces. Never reference internal system nam
     const toolSequenceLog = [];
     const originalMessage = message;
     let cumulativeCostUsd = 0;
+    // ── Checkpointing & Telemetry ──
+    const sessionId = newSessionId();
+    const checkpointManager = new CheckpointManager();
+    const telemetry = new TelemetryEmitter(sessionId);
+    telemetry.emit('session_start', {
+        agent: options.agent || 'kernel',
+        model: options.model || 'auto',
+        message: originalMessage.slice(0, 200),
+    });
     // ── Gödel limits: detect undecidable loops and hand off to human ──
     const loopDetector = new LoopDetector({
         maxToolRepeats: 5,
@@ -839,6 +857,23 @@ Always quote file paths that contain spaces. Never reference internal system nam
     });
     // ── Entropy scorer: information-theoretic context management ──
     const entropyScorer = new EntropyScorer();
+    // ── Tool execution pipeline ──
+    const pipeline = options.pipeline ?? createDefaultPipeline({
+        checkPermission,
+        runPreHook: (name, args) => {
+            const h = runPreToolHook(name, args, options.agent || 'kernel');
+            return { blocked: h.blocked ?? false, blockReason: h.blockReason };
+        },
+        runPostHook: (name, args, result) => { runPostToolHook(name, args, result, options.agent || 'kernel'); },
+        executeTool: async (name, args) => {
+            const r = await executeTool({ id: name, name, arguments: args });
+            return { result: r.result, error: r.error ? r.result : undefined };
+        },
+        recordMetrics: (name, duration, error) => {
+            telemetry.emit('tool_call_end', { tool: name, duration_ms: duration, error });
+        },
+        emit: (event, data) => telemetry.emit(event, data),
+    });
     // Loop messages track the full conversation within a multi-tool execution.
     // This includes assistant responses (with tool-use reasoning) and tool results,
     // so the AI maintains context across tool iterations.
@@ -846,7 +881,7 @@ Always quote file paths that contain spaces. Never reference internal system nam
     for (let i = 0; i < MAX_TOOL_LOOPS; i++) {
         // Cost ceiling — stop burning money on runaway loops
         if (cumulativeCostUsd > MAX_COST_CEILING) {
-            printWarn(`Cost ceiling reached ($${cumulativeCostUsd.toFixed(2)} > $${MAX_COST_CEILING}). Stopping tool loop.`);
+            ui.onWarning(`Cost ceiling reached ($${cumulativeCostUsd.toFixed(2)} > $${MAX_COST_CEILING}). Stopping tool loop.`);
             break;
         }
         // ── Gödel check: detect stuck loops before burning more tokens ──
@@ -857,23 +892,22 @@ Always quote file paths that contain spaces. Never reference internal system nam
                     ? `Loop detected (${decidability.pattern}): ${decidability.evidence}`
                     : decidability.evidence;
                 if (decidability.recommendation === 'handoff') {
-                    printWarn(`${msg}\nHanding off to you — I need your input to continue.`);
+                    ui.onWarning(`${msg}\nHanding off to you — I need your input to continue.`);
                     break;
                 }
                 else if (decidability.recommendation === 'decompose') {
-                    printWarn(`${msg}\nBreaking this into smaller steps...`);
+                    ui.onWarning(`${msg}\nBreaking this into smaller steps...`);
                     break;
                 }
                 else if (decidability.recommendation === 'simplify') {
-                    printInfo(`${msg} Trying a different approach...`);
+                    ui.onInfo(`${msg} Trying a different approach...`);
                     loopMessages.push({ role: 'user', content: `Your approach isn't working. Try a completely different strategy. ${decidability.evidence}` });
                 }
             }
         }
         // Don't use spinner when streaming (conflicts with stdout)
         const useSpinner = !options.stream;
-        const spinner = useSpinner ? createSpinner(i === 0 ? 'Thinking...' : `Running tools (${toolCallCount})...`) : null;
-        spinner?.start();
+        const spinnerHandle = useSpinner ? ui.onSpinnerStart(i === 0 ? 'Thinking...' : `Running tools (${toolCallCount})...`) : null;
         try {
             // ── BYOK: Call provider directly with tool-use support ──
             // If user passed an explicit model name (not a speed alias), use it directly
@@ -911,7 +945,7 @@ Always quote file paths that contain spaces. Never reference internal system nam
                 role: t.role,
                 content: t.content,
             }));
-            spinner?.stop();
+            spinnerHandle?.stop();
             // Use streaming if requested and provider supports it
             // Disable streaming for local models when tools are active — local models
             // often emit tool calls as raw JSON text, which can't be cleaned up after streaming
@@ -920,18 +954,39 @@ Always quote file paths that contain spaces. Never reference internal system nam
                 && p.apiStyle !== 'google'
                 && p.apiStyle !== 'cohere'
                 && !(isLocal && byokTools.length > 0); // Don't stream local + tools (inline tool parsing needs full response)
-            const result = canStream
-                ? await callProviderStreaming(provider, apiKey || 'local', model, systemContext, messages, byokTools, {
-                    thinking: options.thinking,
-                    thinkingBudget: options.thinkingBudget,
-                })
-                : await callProvider(provider, apiKey || 'local', model, systemContext, messages, byokTools, {
-                    multimodal: i === 0 ? parsed : undefined,
-                    thinking: options.thinking,
-                    thinkingBudget: options.thinkingBudget,
-                });
+            // ── Telemetry: API call ──
+            const apiCallStartMs = Date.now();
+            telemetry.emit('api_call', { provider, model, iteration: i, streaming: !!canStream });
+            let result;
+            try {
+                result = canStream
+                    ? await callProviderStreaming(provider, apiKey || 'local', model, systemContext, messages, byokTools, {
+                        thinking: options.thinking,
+                        thinkingBudget: options.thinkingBudget,
+                        responseStream: options.responseStream,
+                    })
+                    : await callProvider(provider, apiKey || 'local', model, systemContext, messages, byokTools, {
+                        multimodal: i === 0 ? parsed : undefined,
+                        thinking: options.thinking,
+                        thinkingBudget: options.thinkingBudget,
+                    });
+            }
+            catch (apiErr) {
+                telemetry.emit('api_error', {
+                    provider, model, iteration: i,
+                    error: apiErr instanceof Error ? apiErr.message : String(apiErr),
+                }, Date.now() - apiCallStartMs);
+                throw apiErr;
+            }
             const iterationCost = estimateCost(provider, result.usage.input_tokens, result.usage.output_tokens);
             cumulativeCostUsd += iterationCost;
+            telemetry.emit('cost_update', {
+                iteration: i,
+                iterationCost,
+                cumulativeCostUsd,
+                inputTokens: result.usage.input_tokens,
+                outputTokens: result.usage.output_tokens,
+            }, Date.now() - apiCallStartMs);
             // ── Feed Gödel detector with cost/token data ──
             loopDetector.recordCost(iterationCost);
             loopDetector.recordTokens(result.usage.input_tokens + result.usage.output_tokens);
@@ -980,7 +1035,7 @@ Always quote file paths that contain spaces. Never reference internal system nam
                         if (classification && classification.confidence > 0.7) {
                             const { applyCorrection } = await import('./error-correction.js');
                             const correctionPrompt = applyCorrection(originalMessage, content, classification.errorType, classification.evidence);
-                            printWarn(`Error correction: ${classification.errorType} (${(classification.confidence * 100).toFixed(0)}%) — retrying with fix...`);
+                            ui.onWarning(`Error correction: ${classification.errorType} (${(classification.confidence * 100).toFixed(0)}%) — retrying with fix...`);
                             loopMessages.push({ role: 'assistant', content });
                             loopMessages.push({ role: 'user', content: correctionPrompt });
                             continue;
@@ -993,7 +1048,7 @@ Always quote file paths that contain spaces. Never reference internal system nam
                     try {
                         const evalResult = await evaluateResponse(originalMessage, content);
                         if (evalResult.shouldRetry && evalResult.feedback) {
-                            printWarn(`Self-eval: low score (${evalResult.overall.toFixed(2)}), retrying...`);
+                            ui.onWarning(`Self-eval: low score (${evalResult.overall.toFixed(2)}), retrying...`);
                             loopMessages.push({ role: 'assistant', content });
                             loopMessages.push({ role: 'user', content: `Your previous response scored low on quality. Feedback: ${evalResult.feedback}\n\nPlease try again with a better response.` });
                             continue;
@@ -1020,13 +1075,15 @@ Always quote file paths that contain spaces. Never reference internal system nam
                         if (content.length > 50 && toolCallCount <= 5) {
                             cacheSolution(originalMessage, content.slice(0, 2000));
                         }
-                        // Update user profile
+                        // Update user profile + Bayesian skill ratings
                         updateProfile({
                             tokens: totalTokens,
                             tokensSaved: findPattern(originalMessage)?.avgTokensSaved || 0,
                             agent: lastResponse.agent || 'kernel',
                             taskType: classifyTask(originalMessage),
                             techTerms: extractKeywords(originalMessage),
+                            message: originalMessage,
+                            success: true,
                         });
                         // Record routing decision for learned router
                         const routeMethod = learnedRoute(originalMessage)?.method || 'llm';
@@ -1076,6 +1133,14 @@ Always quote file paths that contain spaces. Never reference internal system nam
                     }
                     catch { /* learning failures are non-critical */ }
                 });
+                // ── Checkpoint & Telemetry: session completed successfully ──
+                checkpointManager.markCompleted(sessionId).catch(() => { });
+                telemetry.emit('session_end', {
+                    status: 'completed',
+                    toolCallCount,
+                    cumulativeCostUsd,
+                });
+                telemetry.destroy().catch(() => { });
                 return {
                     content,
                     agent: lastResponse.agent || 'kernel',
@@ -1091,28 +1156,39 @@ Always quote file paths that contain spaces. Never reference internal system nam
             for (const call of toolCalls) {
                 toolCallCount++;
                 toolSequenceLog.push(call.name);
-                printToolCall(call.name, call.arguments || {});
-                // Permission check — confirm destructive operations
-                const permitted = await checkPermission(call.name, call.arguments || {});
-                if (!permitted) {
-                    results.push({ tool_call_id: call.id, result: 'Denied by user — operation skipped.', error: true });
-                    printToolResult('Denied by user', true);
-                    continue;
-                }
-                // Pre-tool hook
-                const preHook = runPreToolHook(call.name, call.arguments || {}, options.agent || 'kernel');
-                if (preHook.blocked) {
-                    results.push({ tool_call_id: call.id, result: `Blocked by hook: ${preHook.blockReason}`, error: true });
-                    printToolResult(`Blocked by hook: ${preHook.blockReason}`, true);
-                    continue;
-                }
-                const result = await executeTool(call);
+                ui.onToolCallStart(call.name, call.arguments || {});
+                // Execute through the middleware pipeline
+                const ctx = {
+                    toolName: call.name,
+                    toolArgs: call.arguments || {},
+                    toolCallId: call.id,
+                    metadata: {},
+                    aborted: false,
+                };
+                await pipeline.execute(ctx);
+                // Build ToolResult from pipeline context
+                const result = {
+                    tool_call_id: call.id,
+                    result: ctx.error
+                        ? (ctx.aborted ? (ctx.abortReason || ctx.error) : `Tool error: ${ctx.error}`)
+                        : (ctx.result || ''),
+                    error: !!ctx.error || ctx.aborted,
+                    duration_ms: ctx.durationMs,
+                };
                 results.push(result);
-                printToolResult(result.result, result.error);
+                ui.onToolCallEnd(call.name, result.result, result.error ? result.result : undefined, result.duration_ms);
+                // ── Structured stream: tool result event ──
+                if (options.responseStream) {
+                    options.responseStream.emit({
+                        type: 'tool_result',
+                        id: call.id,
+                        name: call.name,
+                        result: result.result,
+                        error: result.error ? result.result : undefined,
+                    });
+                }
                 // ── Feed Gödel detector with tool call data ──
                 loopDetector.recordToolCall(call.name, JSON.stringify(call.arguments || {}), result.result.slice(0, 500));
-                // Post-tool hook
-                runPostToolHook(call.name, call.arguments || {}, result.result, options.agent || 'kernel');
             }
             // ── Maintain conversation context across tool iterations ──
             // 1. Include the assistant's response (its reasoning + which tools it chose)
@@ -1127,12 +1203,43 @@ Always quote file paths that contain spaces. Never reference internal system nam
                 return `${r.tool_call_id} (${toolCalls.find(tc => tc.id === r.tool_call_id)?.name || 'unknown'}): ${status}${compressed}`;
             }).join('\n\n');
             loopMessages.push({ role: 'user', content: `Tool results:\n${toolResultSummary}` });
+            // ── Checkpoint: save agent state after tool execution ──
+            checkpointManager.save({
+                id: crypto.randomUUID(),
+                sessionId,
+                timestamp: Date.now(),
+                iteration: i,
+                messages: [...loopMessages],
+                toolSequenceLog: [...toolSequenceLog],
+                toolCallCount,
+                cumulativeCostUsd,
+                agentId: options.agent || 'kernel',
+                model: lastResponse?.model || 'unknown',
+                systemPrompt: systemContext,
+                status: 'in_progress',
+            }).then(() => {
+                telemetry.emit('checkpoint_save', { iteration: i, toolCallCount });
+            }).catch(() => {
+                // Checkpoint save is non-blocking and non-critical
+            });
         }
         catch (err) {
-            spinner?.stop();
+            spinnerHandle?.stop();
+            // ── Telemetry: session failure ──
+            telemetry.emit('session_end', { status: 'failed', error: String(err), toolCallCount });
+            telemetry.destroy().catch(() => { });
             throw err;
         }
     }
+    // ── Checkpoint & Telemetry: session ended (loop exhausted or early break) ──
+    checkpointManager.markCompleted(sessionId).catch(() => { });
+    telemetry.emit('session_end', {
+        status: 'completed',
+        toolCallCount,
+        cumulativeCostUsd,
+        reason: 'loop_exhausted',
+    });
+    telemetry.destroy().catch(() => { });
     const content = lastResponse?.content || 'Reached maximum tool iterations.';
     return {
         content,
@@ -1205,4 +1312,36 @@ export async function runAndPrint(message, options = {}) {
         process.exit(1);
     }
 }
+/**
+ * Resume an agent session from a checkpoint.
+ * Restores conversation messages and state, then continues execution.
+ */
+export async function runAgentFromCheckpoint(checkpoint, options = {}) {
+    const telemetryInstance = new TelemetryEmitter(checkpoint.sessionId);
+    telemetryInstance.emit('checkpoint_resume', {
+        checkpointId: checkpoint.id,
+        iteration: checkpoint.iteration,
+        toolCallCount: checkpoint.toolCallCount,
+        cumulativeCostUsd: checkpoint.cumulativeCostUsd,
+    });
+    printInfo(`Resuming from checkpoint (iteration ${checkpoint.iteration}, ${checkpoint.toolCallCount} tool calls, $${checkpoint.cumulativeCostUsd.toFixed(4)})`);
+    // Restore conversation history from checkpoint messages
+    const { restoreHistory } = await import('./memory.js');
+    const turns = checkpoint.messages.map((m) => ({
+        role: m.role,
+        content: m.content,
+    }));
+    restoreHistory(turns);
+    // Extract the original user message from the first user message in checkpoint
+    const firstUserMsg = checkpoint.messages.find((m) => m.role === 'user');
+    const message = firstUserMsg?.content || 'continue';
+    // Re-run the agent with the restored context
+    const response = await runAgent(message, {
+        ...options,
+        agent: checkpoint.agentId || options.agent,
+        skipPlanner: true, // Don't re-plan, just continue execution
+    });
+    await telemetryInstance.destroy();
+    return response;
+}
 //# sourceMappingURL=agent.js.map