pulseed 0.3.0 → 0.4.1

package/dist/interface/chat/chat-events.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=chat-events.js.map

package/dist/interface/chat/chat-events.js.map

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

package/dist/interface/chat/chat-history.d.ts

@@ -41,24 +41,24 @@ export declare const ChatSessionSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     id: string;
     cwd: string;
-    createdAt: string;
     messages: {
         timestamp: string;
         content: string;
         role: "user" | "assistant";
         turnIndex: number;
     }[];
+    createdAt: string;
     compactionSummary?: string | undefined;
 }, {
     id: string;
     cwd: string;
-    createdAt: string;
     messages: {
         timestamp: string;
         content: string;
         role: "user" | "assistant";
         turnIndex: number;
     }[];
+    createdAt: string;
     compactionSummary?: string | undefined;
 }>;
 export type ChatSession = z.infer<typeof ChatSessionSchema>;
@@ -69,8 +69,8 @@ export declare class ChatHistory {
     constructor(stateManager: StateManager, sessionId: string, cwd: string);
     /** Append a user message and persist to disk BEFORE adapter execution. */
     appendUserMessage(content: string): Promise<void>;
-    /** Append an assistant message. Fire-and-forget persistence is acceptable here. */
-    appendAssistantMessage(content: string): void;
+    /** Append an assistant message and persist it as the committed assistant turn. */
+    appendAssistantMessage(content: string): Promise<void>;
     /** Clear all messages and persist the empty state. */
     clear(): void;
     getMessages(): ChatMessage[];

package/dist/interface/chat/chat-history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-history.d.ts","sourceRoot":"","sources":["../../../src/interface/chat/chat-history.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAItE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;EAK5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAI5D,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;gBAE1B,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IAWtE,0EAA0E;IACpE,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvD,mFAAmF;IACnF,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAU7C,sDAAsD;IACtD,KAAK,IAAI,IAAI;IAKb,WAAW,IAAI,WAAW,EAAE;IAI5B,cAAc,IAAI,WAAW;IAIvB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAM/B"}
+{"version":3,"file":"chat-history.d.ts","sourceRoot":"","sources":["../../../src/interface/chat/chat-history.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAItE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;EAK5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAM5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAI5D,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;gBAE1B,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM;IAWtE,0EAA0E;IACpE,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvD,kFAAkF;IAC5E,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5D,sDAAsD;IACtD,KAAK,IAAI,IAAI;IAKb,WAAW,IAAI,WAAW,EAAE;IAI5B,cAAc,IAAI,WAAW;IAIvB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAM/B"}

package/dist/interface/chat/chat-history.js

@@ -42,15 +42,15 @@ export class ChatHistory {
         });
         await this.persist();
     }
-    /** Append an assistant message. Fire-and-forget persistence is acceptable here. */
-    appendAssistantMessage(content) {
+    /** Append an assistant message and persist it as the committed assistant turn. */
+    async appendAssistantMessage(content) {
         this.session.messages.push({
             role: "assistant",
             content,
             timestamp: new Date().toISOString(),
             turnIndex: this.session.messages.length,
         });
-        void this.persist();
+        await this.persist();
     }
     /** Clear all messages and persist the empty state. */
     clear() {

package/dist/interface/chat/chat-history.js.map

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

package/dist/interface/chat/chat-runner.d.ts

@@ -5,8 +5,9 @@ import type { EscalationHandler } from "./escalation.js";
 import type { ApprovalLevel } from "./self-knowledge-mutation-tools.js";
 import type { ToolRegistry } from "../../tools/registry.js";
 import type { ToolExecutor } from "../../tools/executor.js";
-import type { DaemonClient } from "../../runtime/daemon-client.js";
+import type { DaemonClient } from "../../runtime/daemon/client.js";
 import type { GoalNegotiator } from "../../orchestrator/goal/goal-negotiator.js";
+import type { ChatEvent } from "./chat-events.js";
 export interface ChatRunnerDeps {
     stateManager: StateManager;
     adapter: IAdapter;
@@ -55,6 +56,8 @@ export interface ChatRunnerDeps {
     onNotification?: (message: string) => void;
     /** Optional: daemon event server base URL (e.g. http://127.0.0.1:7823) for EventSubscriber. */
     daemonBaseUrl?: string;
+    /** Optional: channel-agnostic chat stream events. */
+    onEvent?: (event: ChatEvent) => void;
 }
 export interface ChatRunResult {
     success: boolean;
@@ -69,8 +72,8 @@ export declare class ChatRunner {
     private sessionActive;
     /** Deferred tools activated by ToolSearch results — included in tool definitions for subsequent turns. */
     private activatedTools;
-    /** Cached system prompt — built once per session, reused across turns. */
-    private cachedSystemPrompt;
+    /** Cached static system prompt — reused across turns; dynamic context is rebuilt each turn. */
+    private cachedStaticSystemPrompt;
     /** Pending /tend state awaiting user confirmation (Y/n). */
     private pendingTend;
     /** Active EventSubscriber instances keyed by goalId. */
@@ -80,6 +83,7 @@ export declare class ChatRunner {
      * Can be set after construction (e.g. from a React component via useEffect).
      */
     onNotification: ((message: string) => void) | undefined;
+    onEvent: ((event: ChatEvent) => void) | undefined;
     constructor(deps: ChatRunnerDeps);
     /**
      * Initialize a persistent session for interactive (multi-turn) mode.
@@ -101,7 +105,7 @@ export declare class ChatRunner {
      *  4. Persist user message BEFORE calling adapter (crash-safe)
      *  5. Execute via adapter
      *  6. Verify changes (git diff + tests); retry up to MAX_VERIFY_RETRIES if tests fail
-     *  7. Persist assistant response (fire-and-forget)
+     *  7. Persist assistant response only after the final assistant text is complete
      */
     execute(input: string, cwd: string, timeoutMs?: number): Promise<ChatRunResult>;
     /**
@@ -116,6 +120,13 @@ export declare class ChatRunner {
     private activateToolSearchResults;
     /** Dispatch a tool call through the registry. */
     private dispatchToolCall;
+    private sendLLMMessage;
+    private createEventContext;
+    private eventBase;
+    private emitEvent;
+    private pushAssistantDelta;
+    private emitLifecycleEndEvent;
+    private emitLifecycleErrorEvent;
     /** Build a ToolCallContext from ChatRunnerDeps for tool dispatch. */
     private buildToolCallContext;
 }

package/dist/interface/chat/chat-runner.d.ts.map

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

package/dist/interface/chat/chat-runner.js

@@ -5,7 +5,7 @@
 import { execFile } from "node:child_process";
 import { ChatHistory } from "./chat-history.js";
 import { buildChatContext, resolveGitRoot } from "../../platform/observation/context-provider.js";
-import { buildSystemPrompt } from "./grounding.js";
+import { buildDynamicContextPrompt, buildStaticSystemPrompt } from "./grounding.js";
 import { verifyChatAction } from "./chat-verifier.js";
 import { toToolDefinitionsFiltered } from "../../tools/tool-definition-adapter.js";
 import { TendCommand } from "./tend-command.js";
@@ -37,8 +37,8 @@ export class ChatRunner {
     sessionActive = false;
     /** Deferred tools activated by ToolSearch results — included in tool definitions for subsequent turns. */
     activatedTools = new Set();
-    /** Cached system prompt — built once per session, reused across turns. */
-    cachedSystemPrompt = null;
+    /** Cached static system prompt — reused across turns; dynamic context is rebuilt each turn. */
+    cachedStaticSystemPrompt = null;
     /** Pending /tend state awaiting user confirmation (Y/n). */
     pendingTend = null;
     /** Active EventSubscriber instances keyed by goalId. */
@@ -48,6 +48,7 @@ export class ChatRunner {
      * Can be set after construction (e.g. from a React component via useEffect).
      */
     onNotification = undefined;
+    onEvent = undefined;
     constructor(deps) {
         this.deps = deps;
     }
@@ -239,17 +240,37 @@ export class ChatRunner {
      *  4. Persist user message BEFORE calling adapter (crash-safe)
      *  5. Execute via adapter
      *  6. Verify changes (git diff + tests); retry up to MAX_VERIFY_RETRIES if tests fail
-     *  7. Persist assistant response (fire-and-forget)
+     *  7. Persist assistant response only after the final assistant text is complete
      */
     async execute(input, cwd, timeoutMs = DEFAULT_TIMEOUT_MS) {
+        const eventContext = this.createEventContext();
         // Intercept commands before any adapter call
         const commandResult = await this.handleCommand(input);
         if (commandResult !== null) {
+            if (commandResult.output) {
+                this.emitEvent({
+                    type: "assistant_final",
+                    text: commandResult.output,
+                    persisted: false,
+                    ...this.eventBase(eventContext),
+                });
+            }
+            this.emitLifecycleEndEvent(commandResult.success ? "completed" : "error", commandResult.elapsed_ms, eventContext, false);
             return commandResult;
         }
         // Intercept plain Y/n responses (and any other input) when a /tend confirmation is pending
         if (this.pendingTend !== null) {
-            return this.handleTendConfirmation(input.trim(), Date.now());
+            const confirmationResult = await this.handleTendConfirmation(input.trim(), Date.now());
+            if (confirmationResult.output) {
+                this.emitEvent({
+                    type: "assistant_final",
+                    text: confirmationResult.output,
+                    persisted: false,
+                    ...this.eventBase(eventContext),
+                });
+            }
+            this.emitLifecycleEndEvent(confirmationResult.success ? "completed" : "error", confirmationResult.elapsed_ms, eventContext, false);
+            return confirmationResult;
         }
         // Reuse session (interactive mode) or create a fresh one per call (1-shot mode)
         if (!this.sessionActive) {
@@ -262,15 +283,31 @@ export class ChatRunner {
         const history = this.history;
         // Persist-before-execute: user message written to disk first
         await history.appendUserMessage(input);
-        // Build grounding system prompt on first turn, cache for session
-        if (this.cachedSystemPrompt === null) {
+        this.emitEvent({
+            type: "lifecycle_start",
+            input,
+            ...this.eventBase(eventContext),
+        });
+        // Build static grounding once per session; dynamic context is rebuilt each turn.
+        if (this.cachedStaticSystemPrompt === null) {
             try {
-                this.cachedSystemPrompt = await buildSystemPrompt({ stateManager: this.deps.stateManager });
+                this.cachedStaticSystemPrompt = buildStaticSystemPrompt();
             }
             catch {
-                this.cachedSystemPrompt = "";
+                this.cachedStaticSystemPrompt = "";
             }
         }
+        let dynamicSystemPrompt = "";
+        try {
+            dynamicSystemPrompt = await buildDynamicContextPrompt({ stateManager: this.deps.stateManager });
+        }
+        catch {
+            dynamicSystemPrompt = "";
+        }
+        const systemPrompt = [this.cachedStaticSystemPrompt, dynamicSystemPrompt]
+            .filter((section) => section && section.trim().length > 0)
+            .join("\n\n")
+            .trim();
         // Build conversation history from prior turns (last 10)
         const messages = history.getMessages();
         const priorTurns = messages.slice(0, -1).slice(-10);
@@ -283,20 +320,42 @@ export class ChatRunner {
         const basePrompt = context ? `${context}\n\n${input}` : input;
         const prompt = historyBlock ? `${historyBlock}${basePrompt}` : basePrompt;
         const start = Date.now();
+        const assistantBuffer = { text: "" };
         // Use llmClient with self-knowledge tools when available (function calling path)
         // Skip executeWithTools for clients that don't support tool calling (e.g. CodexLLMClient)
         if (this.deps.llmClient && this.deps.llmClient.supportsToolCalling?.() !== false) {
-            const toolResult = await this.executeWithTools(prompt, this.cachedSystemPrompt ?? undefined);
-            const elapsed_ms = Date.now() - start;
-            await history.appendAssistantMessage(toolResult);
-            return { success: true, output: toolResult, elapsed_ms };
+            try {
+                const toolResult = await this.executeWithTools(prompt, eventContext, assistantBuffer, systemPrompt || undefined);
+                const elapsed_ms = Date.now() - start;
+                await history.appendAssistantMessage(toolResult);
+                this.emitEvent({
+                    type: "assistant_final",
+                    text: toolResult,
+                    persisted: true,
+                    ...this.eventBase(eventContext),
+                });
+                this.emitLifecycleEndEvent("completed", elapsed_ms, eventContext, true);
+                return { success: true, output: toolResult, elapsed_ms };
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                this.emitLifecycleErrorEvent(message, assistantBuffer.text, eventContext);
+                this.emitLifecycleEndEvent("error", Date.now() - start, eventContext, false);
+                return {
+                    success: false,
+                    output: assistantBuffer.text
+                        ? `${assistantBuffer.text}\n\n[interrupted: ${message}]`
+                        : `Error: ${message}`,
+                    elapsed_ms: Date.now() - start,
+                };
+            }
         }
         const task = {
             prompt,
             timeout_ms: timeoutMs,
             adapter_type: this.deps.adapter.adapterType,
             cwd,
-            ...(this.cachedSystemPrompt ? { system_prompt: this.cachedSystemPrompt } : {}),
+            ...(systemPrompt ? { system_prompt: systemPrompt } : {}),
         };
         const resolvedTimeoutMs = task.timeout_ms ?? DEFAULT_TIMEOUT_MS;
         const adapterPromise = this.deps.adapter.execute(task);
@@ -307,6 +366,9 @@ export class ChatRunner {
             result = { ...result, output: `Error: ${result.error}` };
         }
         const elapsed_ms = Date.now() - start;
+        if (result.output) {
+            this.pushAssistantDelta(result.output, assistantBuffer, eventContext);
+        }
         // Verification loop: check if git has uncommitted changes; if so, run tests
         const gitChanges = await checkGitChanges(gitRoot);
         if (gitChanges !== null && gitChanges !== "") {
@@ -324,17 +386,30 @@ export class ChatRunner {
                 verification = await verifyChatAction(gitRoot, this.deps.toolExecutor);
             }
             if (!verification.passed) {
-                // Fire-and-forget: persist assistant response
-                history.appendAssistantMessage(result.output);
+                this.emitLifecycleErrorEvent(`Changes applied but tests are still failing after ${MAX_VERIFY_RETRIES} retries.`, assistantBuffer.text, eventContext);
+                this.emitLifecycleEndEvent("error", Date.now() - start, eventContext, false);
                 return {
                     success: false,
-                    output: `Changes applied but tests are still failing after ${MAX_VERIFY_RETRIES} retries. Please intervene manually.\n\nTest output:\n${verification.testOutput ?? verification.errors.join("\n")}`,
+                    output: `${assistantBuffer.text}\n\n[interrupted: tests are still failing after ${MAX_VERIFY_RETRIES} retries]\n\nTest output:\n${verification.testOutput ?? verification.errors.join("\n")}`.trim(),
                     elapsed_ms: Date.now() - start,
                 };
             }
         }
-        // Fire-and-forget: persist assistant response after completion
-        history.appendAssistantMessage(result.output);
+        if (result.success) {
+            await history.appendAssistantMessage(result.output);
+            this.emitEvent({
+                type: "assistant_final",
+                text: result.output,
+                persisted: true,
+                ...this.eventBase(eventContext),
+            });
+            this.emitLifecycleEndEvent("completed", elapsed_ms, eventContext, true);
+        }
+        else {
+            const partialText = assistantBuffer.text !== result.output ? assistantBuffer.text : "";
+            this.emitLifecycleErrorEvent(result.output || result.error || "Unknown error", partialText, eventContext);
+            this.emitLifecycleEndEvent("error", elapsed_ms, eventContext, false);
+        }
         return {
             success: result.success,
             output: result.output,
@@ -345,7 +420,7 @@ export class ChatRunner {
      * Execute a chat turn using llmClient with self-knowledge tools (function calling).
      * Loops up to MAX_TOOL_LOOPS times to resolve tool calls, then returns final text.
      */
-    async executeWithTools(prompt, systemPrompt) {
+    async executeWithTools(prompt, eventContext, assistantBuffer, systemPrompt) {
         const llmClient = this.deps.llmClient;
         const messages = [{ role: "user", content: prompt }];
         const toolCallContext = this.buildToolCallContext();
@@ -356,19 +431,19 @@ export class ChatRunner {
                 : [];
             let response;
             try {
-                response = await llmClient.sendMessage(messages, {
+                response = await this.sendLLMMessage(llmClient, messages, {
                     tools,
                     ...(systemPrompt ? { system: systemPrompt } : {}),
-                });
+                }, assistantBuffer, eventContext);
             }
             catch (err) {
                 console.error("[chat-runner] executeWithTools error:", err);
                 const hint = err instanceof Error ? `: ${err.message}` : "";
-                return `Sorry, I encountered an error processing your request${hint}.`;
+                throw new Error(`Sorry, I encountered an error processing your request${hint}.`);
             }
             // No tool calls — return the text content
             if (!response.tool_calls || response.tool_calls.length === 0) {
-                return response.content || "(no response)";
+                return assistantBuffer.text || response.content || "(no response)";
             }
             // Append assistant message, then process tool calls
             messages.push({ role: "assistant", content: response.content || "" });
@@ -380,7 +455,7 @@ export class ChatRunner {
                 catch {
                     // ignore parse errors, use empty args
                 }
-                const toolResult = await this.dispatchToolCall(tc.function.name, args, toolCallContext);
+                const toolResult = await this.dispatchToolCall(tc.id, tc.function.name, args, toolCallContext, eventContext);
                 // When ToolSearch returns results, activate deferred tools for subsequent turns
                 if (tc.function.name === "tool_search") {
                     this.activateToolSearchResults(toolResult);
@@ -413,7 +488,7 @@ export class ChatRunner {
         }
     }
     /** Dispatch a tool call through the registry. */
-    async dispatchToolCall(name, args, context) {
+    async dispatchToolCall(toolCallId, name, args, context, eventContext) {
         if (!this.deps.registry) {
             return JSON.stringify({ error: `No tool registry configured` });
         }
@@ -425,14 +500,47 @@ export class ChatRunner {
         try {
             const parsed = tool.inputSchema.safeParse(args);
             if (!parsed.success) {
+                this.emitEvent({
+                    type: "tool_end",
+                    toolCallId,
+                    toolName: name,
+                    success: false,
+                    summary: `Invalid input: ${parsed.error.message}`,
+                    durationMs: Date.now() - startTime,
+                    ...this.eventBase(eventContext),
+                });
                 return JSON.stringify({ error: `Invalid input: ${parsed.error.message}` });
             }
+            this.emitEvent({
+                type: "tool_start",
+                toolCallId,
+                toolName: name,
+                args,
+                ...this.eventBase(eventContext),
+            });
             // Gate: check permissions before execution
             const permResult = await tool.checkPermissions(parsed.data, context);
             if (permResult.status === "denied") {
+                this.emitEvent({
+                    type: "tool_end",
+                    toolCallId,
+                    toolName: name,
+                    success: false,
+                    summary: permResult.reason,
+                    durationMs: Date.now() - startTime,
+                    ...this.eventBase(eventContext),
+                });
                 return `Tool ${name} denied: ${permResult.reason}`;
             }
             if (permResult.status === "needs_approval") {
+                this.emitEvent({
+                    type: "tool_update",
+                    toolCallId,
+                    toolName: name,
+                    status: "awaiting_approval",
+                    message: permResult.reason,
+                    ...this.eventBase(eventContext),
+                });
                 const approved = await context.approvalFn({
                     toolName: name,
                     input: parsed.data,
@@ -442,22 +550,128 @@ export class ChatRunner {
                     reversibility: "unknown",
                 });
                 if (!approved) {
+                    this.emitEvent({
+                        type: "tool_end",
+                        toolCallId,
+                        toolName: name,
+                        success: false,
+                        summary: `Not approved: ${permResult.reason}`,
+                        durationMs: Date.now() - startTime,
+                        ...this.eventBase(eventContext),
+                    });
                     return `Tool ${name} not approved: ${permResult.reason}`;
                 }
             }
+            this.emitEvent({
+                type: "tool_update",
+                toolCallId,
+                toolName: name,
+                status: "running",
+                message: "running",
+                ...this.eventBase(eventContext),
+            });
             this.deps.onToolStart?.(name, args);
             const result = await tool.call(parsed.data, context);
             const durationMs = Date.now() - startTime;
             this.deps.onToolEnd?.(name, { success: result.success, summary: result.summary || '...', durationMs });
+            this.emitEvent({
+                type: "tool_update",
+                toolCallId,
+                toolName: name,
+                status: "result",
+                message: result.summary || "...",
+                ...this.eventBase(eventContext),
+            });
+            this.emitEvent({
+                type: "tool_end",
+                toolCallId,
+                toolName: name,
+                success: result.success,
+                summary: result.summary || "...",
+                durationMs,
+                ...this.eventBase(eventContext),
+            });
             // Prefer structured data (JSON) over plain summary so the LLM gets actionable content
             return result.data != null ? JSON.stringify(result.data) : (result.summary ?? "(no result)");
         }
         catch (err) {
             const message = err instanceof Error ? err.message : String(err);
-            this.deps.onToolEnd?.(name, { success: false, summary: message, durationMs: Date.now() - startTime });
+            const durationMs = Date.now() - startTime;
+            this.deps.onToolEnd?.(name, { success: false, summary: message, durationMs });
+            this.emitEvent({
+                type: "tool_end",
+                toolCallId,
+                toolName: name,
+                success: false,
+                summary: message,
+                durationMs,
+                ...this.eventBase(eventContext),
+            });
             return JSON.stringify({ error: `Tool ${name} failed: ${message}` });
         }
     }
+    async sendLLMMessage(llmClient, messages, options, assistantBuffer, eventContext) {
+        let streamed = false;
+        if (llmClient.sendMessageStream) {
+            const response = await llmClient.sendMessageStream(messages, options, {
+                onTextDelta: (delta) => {
+                    streamed = true;
+                    this.pushAssistantDelta(delta, assistantBuffer, eventContext);
+                },
+            });
+            if (!streamed && response.content) {
+                this.pushAssistantDelta(response.content, assistantBuffer, eventContext);
+            }
+            return response;
+        }
+        const response = await llmClient.sendMessage(messages, options);
+        if (response.content) {
+            this.pushAssistantDelta(response.content, assistantBuffer, eventContext);
+        }
+        return response;
+    }
+    createEventContext() {
+        return {
+            runId: crypto.randomUUID(),
+            turnId: crypto.randomUUID(),
+        };
+    }
+    eventBase(context) {
+        return { ...context, createdAt: new Date().toISOString() };
+    }
+    emitEvent(event) {
+        const handler = this.onEvent ?? this.deps.onEvent;
+        handler?.(event);
+    }
+    pushAssistantDelta(delta, assistantBuffer, eventContext) {
+        if (!delta)
+            return;
+        assistantBuffer.text += delta;
+        this.emitEvent({
+            type: "assistant_delta",
+            delta,
+            text: assistantBuffer.text,
+            ...this.eventBase(eventContext),
+        });
+    }
+    emitLifecycleEndEvent(status, elapsedMs, eventContext, persisted) {
+        this.emitEvent({
+            type: "lifecycle_end",
+            status,
+            elapsedMs,
+            persisted,
+            ...this.eventBase(eventContext),
+        });
+    }
+    emitLifecycleErrorEvent(error, partialText, eventContext) {
+        this.emitEvent({
+            type: "lifecycle_error",
+            error,
+            partialText,
+            persisted: false,
+            ...this.eventBase(eventContext),
+        });
+    }
     /** Build a ToolCallContext from ChatRunnerDeps for tool dispatch. */
     buildToolCallContext() {
         return {