tau-coding-agent 0.1.5 → 0.2.0

package/extensions/memory.ts

@@ -1,5 +1,10 @@
-import { complete } from "@earendil-works/pi-ai/compat";
-import { StringEnum, type Api, type Model, type UserMessage } from "@earendil-works/pi-ai";
+import {
+  StringEnum,
+  type Api,
+  type Model,
+  type Usage,
+  type UserMessage,
+} from "@earendil-works/pi-ai";
 import {
   defineTool,
   withFileMutationQueue,
@@ -8,6 +13,7 @@ import {
   type ExtensionContext,
 } from "@earendil-works/pi-coding-agent";
 import { Type } from "typebox";
+import { createHash, randomUUID } from "node:crypto";
 import fs from "node:fs/promises";
 import path from "node:path";
 
@@ -65,6 +71,9 @@ Schema:
     "focus": "...",
     "pending": "..."
   },
+  "pending_dispositions": [
+    { "id": "pending-1", "status": "retain" }
+  ],
   "summary": "..."
 }
 
@@ -78,9 +87,12 @@ Rules:
 - focus: the current objective and immediate next steps.
 - pending: unresolved follow-ups, open questions, blocked work.
 - Use explicit invalidates/supersedes links when resolving contradictions.
-- Preserve unresolved pending items. Do not clear pending unless the summary explicitly says they were resolved or abandoned.
+- The <pending-items> JSON assigns snapshot-local identifiers to every nonblank line of existing pending.md, including headings and continuation lines. This conservative unit preserves arbitrary existing Markdown without guessing item boundaries.
+- Return pending_dispositions with exactly one {id, status} per provided identifier, no duplicates or unknown identifiers. Return [] when no identifiers were provided.
+- status must be "retain", "complete", or "abandon". Use complete or abandon only when the provided evidence establishes that work is finished or deliberately abandoned; otherwise retain. Summary wording never authorizes deletion.
+- Every retained line must remain verbatim as a separate line in blocks.pending, including repeated occurrences. Do not replace retained work with a paraphrase or an identifier. For multiline work, retain every constituent line unless that work is complete or abandoned. You may reorder retained lines and add new pending work.
 - Keep every block short, concrete, and high-signal.
-- Self-check that JSON.parse(output) succeeds before responding.`;
+- Before returning, check that the output is valid JSON and matches the required structure.`;
 
 // --- Types and errors ---
 
@@ -106,20 +118,27 @@ type PendingCompaction = {
 };
 
 type MemoryState = {
-  // Newest timestamp appended to log.md.
+  // Timestamp of the last entry appended to log.md.
   lastLogAt: string | null;
   // Timestamp of the most recent successful dream run.
   lastDreamAt: string | null;
-  // Next dream replays log.md entries newer than this timestamp.
+  // Timestamp provenance only; replay follows the append cursor, not wall time.
   lastDreamedLogAt: string | null;
+  lastDreamedLogCursor: LogCursor | null;
   // session_compact summaries waiting to be folded into core.
   pendingCompactions: PendingCompaction[];
 };
 
+type LogCursor = {
+  bytes: number;
+  sha256: string;
+};
+
 type MemoryStateFile = {
   last_log_at: string | null;
   last_dream_at: string | null;
   last_dreamed_log_at: string | null;
+  last_dreamed_log_cursor: LogCursor | null;
   pending_compactions: PendingCompaction[];
 };
 
@@ -152,10 +171,17 @@ type DreamReplay = {
   totalLines: number;
   totalChars: number;
   undreamedEntries: LogEntry[];
+  logCursor: LogCursor;
+  previousLogCursor: LogCursor | null;
   pendingCompactions: PendingCompaction[];
   researchFiles: string[];
 };
 
+type PendingItem = {
+  id: string;
+  text: string;
+};
+
 type DreamOutput = {
   blocks: CoreBlocks;
   summary: string;
@@ -171,6 +197,11 @@ type DreamResult = {
   summaryPath: string | null;
 };
 
+type DreamExecution = {
+  result: DreamResult;
+  usage?: Usage;
+};
+
 type AutoDreamStatus = {
   coreLines: number;
   coreChars: number;
@@ -187,8 +218,6 @@ type AutoDreamState = {
 
 type ModelSelection = {
   model: Model<Api>;
-  apiKey?: string;
-  headers?: Record<string, string>;
 };
 
 class MemoryReadmeMissingError extends Error {
@@ -204,12 +233,17 @@ async function toolDream(
   cwd: string,
   ctx: ExtensionContext,
   reason?: string,
-): Promise<{ content: Array<{ type: "text"; text: string }>; details: DreamResult }> {
+): Promise<{
+  content: Array<{ type: "text"; text: string }>;
+  details: DreamResult;
+  usage?: Usage;
+}> {
   try {
-    const result = await runMemoryDream(cwd, ctx, reason);
+    const execution = await runMemoryDream(cwd, ctx, reason);
     return {
-      content: [{ type: "text", text: result.summary }],
-      details: result,
+      content: [{ type: "text", text: execution.result.summary }],
+      details: execution.result,
+      usage: execution.usage,
     };
   } catch (error) {
     if (error instanceof MemoryReadmeMissingError) {
@@ -272,12 +306,6 @@ async function maybeScheduleAutoDream(
     return true;
   }
 
-  const noUndreamedLogs =
-    stateFile.lastLogAt !== null && stateFile.lastLogAt === stateFile.lastDreamedLogAt;
-  if (noUndreamedLogs) {
-    return shouldAutoDream(quickStatus, trigger) ? startAutoDream(quickStatus) : true;
-  }
-
   const status = await loadAutoDreamStatus(cwd, core, stateFile);
   return shouldAutoDream(status, trigger) ? startAutoDream(status) : true;
 }
@@ -356,20 +384,21 @@ function getDreamReplaySignature(replay: DreamReplay): string {
     readme: replay.readme,
     blocks: replay.blocks,
     undreamedEntries: replay.undreamedEntries,
+    logCursor: replay.logCursor,
+    previousLogCursor: replay.previousLogCursor,
     pendingCompactions: replay.pendingCompactions,
     researchFiles: replay.researchFiles,
   });
 }
 
-// Dream reads current core, log.md entries newer than lastDreamedLogAt,
-// pending compactions, and the memory README rules.
-// Dream writes rewritten core blocks, a dream summary in compactions/,
-// and state.json with lastDreamAt, lastDreamedLogAt, and an empty pendingCompactions queue.
+// Dream reads current core, logs after the persisted append cursor,
+// pending compactions, and the memory README rules, then commits only if unchanged.
+// A successful dream advances the cursor and clears pendingCompactions.
 async function runMemoryDream(
   cwd: string,
   ctx: ExtensionContext,
   reason?: string,
-): Promise<DreamResult> {
+): Promise<DreamExecution> {
   const paths = getMemoryPaths(cwd);
   const lockPaths = [
     paths.readmeFile,
@@ -394,28 +423,26 @@ async function runMemoryDream(
     const summary = "Memory dream: nothing to consolidate.";
     notify(ctx, summary, "info");
     return {
-      summary,
-      updatedBlocks: [],
-      consumedLogs: 0,
-      consumedCompactions: 0,
-      lastDreamAt: snapshot.state?.lastDreamAt ?? nowIso(),
-      lastDreamedLogAt: snapshot.state?.lastDreamedLogAt ?? null,
-      summaryPath: null,
+      result: {
+        summary,
+        updatedBlocks: [],
+        consumedLogs: 0,
+        consumedCompactions: 0,
+        lastDreamAt: snapshot.state?.lastDreamAt ?? nowIso(),
+        lastDreamedLogAt: snapshot.state?.lastDreamedLogAt ?? null,
+        summaryPath: null,
+      },
     };
   }
 
   const selection = await selectDreamModel(ctx);
-  const response = await complete(
+  const response = await ctx.modelRegistry.complete(
     selection.model,
     {
       systemPrompt: MEMORY_DREAM_SYSTEM_PROMPT,
       messages: [buildDreamUserMessage(snapshot.replay, reason)],
     },
-    {
-      apiKey: selection.apiKey,
-      headers: selection.headers,
-      signal: ctx.signal,
-    },
+    { signal: ctx.signal },
   );
 
   if (response.stopReason === "aborted") {
@@ -436,19 +463,8 @@ async function runMemoryDream(
     throw new Error("Memory dream returned no text.");
   }
 
-  const abstraction = parseDreamOutput(rawText);
+  const abstraction = parseDreamOutput(rawText, getPendingItems(snapshot.replay.blocks.pending));
   const finalBlocks = abstraction.blocks;
-  if (
-    wouldWipePendingWithoutResolution(
-      snapshot.replay.blocks.pending,
-      finalBlocks.pending,
-      abstraction.summary,
-    )
-  ) {
-    throw new Error(
-      "Memory dream proposed clearing pending.md without saying it was resolved or abandoned.",
-    );
-  }
 
   const finalCoreLines = getCoreLineCount(finalBlocks);
   if (finalCoreLines > CORE_LINE_CAP) {
@@ -464,7 +480,7 @@ async function runMemoryDream(
     );
   }
 
-  return withMemoryMutationQueue(lockPaths, async () => {
+  const result = await withMemoryMutationQueue(lockPaths, async () => {
     ensureMemoryInitialized(await pathExists(paths.memoryRoot));
 
     const currentReplay = await collectDreamReplay(cwd);
@@ -482,6 +498,7 @@ async function runMemoryDream(
       ...previousState,
       lastDreamAt: dreamTimestamp,
       lastDreamedLogAt,
+      lastDreamedLogCursor: snapshot.replay.logCursor,
       pendingCompactions: [],
     });
 
@@ -512,6 +529,8 @@ async function runMemoryDream(
       summaryPath,
     };
   });
+
+  return { result, usage: response.usage };
 }
 
 async function loadMemoryPrompt(cwd: string): Promise<string | undefined> {
@@ -567,7 +586,7 @@ async function loadMemoryStatus(cwd: string): Promise<MemoryStatus> {
     lastLogAt: entries.at(-1)?.timestamp ?? state.lastLogAt,
     lastDreamAt: state.lastDreamAt,
     lastDreamedLogAt: state.lastDreamedLogAt,
-    undreamedLogs: countUndreamedLogs(entries, state.lastDreamedLogAt),
+    undreamedLogs: selectUndreamedLogEntries(logText ?? "", state).length,
     pendingCompactions: state.pendingCompactions.length,
     researchFiles: researchFiles.length,
     hasLog,
@@ -580,8 +599,7 @@ async function loadAutoDreamStatus(
   state: MemoryState,
 ): Promise<AutoDreamStatus> {
   const logText = await readTextIfExists(getMemoryPaths(cwd).logFile);
-  const entries = parseMemoryLog(logText ?? "");
-  const undreamedEntries = selectUndreamedLogEntries(entries, state.lastDreamedLogAt);
+  const undreamedEntries = selectUndreamedLogEntries(logText ?? "", state);
 
   return {
     coreLines: core.totalLines,
@@ -644,14 +662,14 @@ async function updateCoreBlockUnsafe(
   const totalLines = getCoreLineCount(nextBlocks);
   if (totalLines > CORE_LINE_CAP) {
     throw new Error(
-      `Core block update would exceed the ${CORE_LINE_CAP}-line cap (${totalLines}). Run memory_dream or remove content first.`,
+      `Core block update would exceed the ${CORE_LINE_CAP}-line cap (${totalLines}). Run memory_dream to consolidate core memory.`,
     );
   }
 
   const totalChars = getCoreCharCount(nextBlocks);
   if (totalChars > CORE_CHAR_CAP) {
     throw new Error(
-      `Core block update would exceed the ${CORE_CHAR_CAP}-character cap (${totalChars}). Run memory_dream or remove content first.`,
+      `Core block update would exceed the ${CORE_CHAR_CAP}-character cap (${totalChars}). Run memory_dream to consolidate core memory.`,
     );
   }
 
@@ -706,8 +724,7 @@ async function collectDreamReplay(cwd: string): Promise<DreamReplay> {
     readTextIfExists(paths.logFile),
     listResearchFiles(cwd),
   ]);
-  const entries = parseMemoryLog(logText ?? "");
-  const undreamedEntries = selectUndreamedLogEntries(entries, state.lastDreamedLogAt);
+  const undreamedEntries = selectUndreamedLogEntries(logText ?? "", state);
 
   return {
     readme,
@@ -715,6 +732,8 @@ async function collectDreamReplay(cwd: string): Promise<DreamReplay> {
     totalLines: core.totalLines,
     totalChars: core.totalChars,
     undreamedEntries,
+    logCursor: getLogCursor(Buffer.from(logText ?? "", "utf8")),
+    previousLogCursor: state.lastDreamedLogCursor,
     pendingCompactions: state.pendingCompactions,
     researchFiles,
   };
@@ -773,6 +792,7 @@ async function readStateUnsafe(cwd: string): Promise<MemoryState> {
       lastDreamAt: typeof parsed.last_dream_at === "string" ? parsed.last_dream_at : null,
       lastDreamedLogAt:
         typeof parsed.last_dreamed_log_at === "string" ? parsed.last_dreamed_log_at : null,
+      lastDreamedLogCursor: parseLogCursor(parsed.last_dreamed_log_cursor),
       pendingCompactions: Array.isArray(parsed.pending_compactions)
         ? parsed.pending_compactions
             .map((entry) => normalizePendingCompaction(entry))
@@ -783,7 +803,7 @@ async function readStateUnsafe(cwd: string): Promise<MemoryState> {
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
     throw new Error(
-      `${path.relative(cwd, statePath)} is invalid JSON. Repair or restore it before using repo memory. ${message}`,
+      `${path.relative(cwd, statePath)} is invalid. Repair or restore it before using repo memory. ${message}`,
     );
   }
 }
@@ -794,6 +814,7 @@ async function writeStateUnsafe(cwd: string, state: MemoryState): Promise<void>
     last_log_at: state.lastLogAt,
     last_dream_at: state.lastDreamAt,
     last_dreamed_log_at: state.lastDreamedLogAt,
+    last_dreamed_log_cursor: state.lastDreamedLogCursor,
     pending_compactions: state.pendingCompactions,
   };
   const payload = `${JSON.stringify(stateFile, null, 2)}\n`;
@@ -838,7 +859,7 @@ async function writeDreamSummary(
   const paths = getMemoryPaths(cwd);
   const filePath = path.join(
     paths.compactionsDir,
-    `${formatTimestampForFilename(summary.timestamp)}-dream.md`,
+    `${formatTimestampForFilename(summary.timestamp)}-${randomUUID()}-dream.md`,
   );
   await ensureDir(paths.compactionsDir);
   await fs.writeFile(filePath, buildDreamSummaryContent(summary), "utf8");
@@ -928,6 +949,10 @@ function buildDreamUserMessage(replay: DreamReplay, reason?: string): UserMessag
     replay.blocks.pending.trimEnd() || "(empty)",
     "</core>",
     "",
+    "<pending-items>",
+    JSON.stringify(getPendingItems(replay.blocks.pending), null, 2),
+    "</pending-items>",
+    "",
     "<undreamed-log>",
     formatLogEntriesForPrompt(replay.undreamedEntries) || "(none)",
     "</undreamed-log>",
@@ -958,14 +983,10 @@ async function selectDreamModel(ctx: ExtensionContext): Promise<ModelSelection>
     throw new Error("error" in auth ? auth.error : "Memory dream is missing model auth.");
   }
 
-  return {
-    model: ctx.model,
-    apiKey: auth.apiKey,
-    headers: auth.headers,
-  };
+  return { model: ctx.model };
 }
 
-function parseDreamOutput(rawText: string): DreamOutput {
+function parseDreamOutput(rawText: string, pendingItems: PendingItem[]): DreamOutput {
   const parsed = parsePossiblyWrappedJson(rawText);
   if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
     throw new Error("Memory dream output must be a JSON object.");
@@ -993,6 +1014,8 @@ function parseDreamOutput(rawText: string): DreamOutput {
     blocks[name] = normalizeMarkdownBlock(value);
   }
 
+  validatePendingDispositions(record.pending_dispositions, pendingItems, blocks.pending);
+
   const summary =
     typeof record.summary === "string" && record.summary.trim()
       ? normalizeInlineText(record.summary)
@@ -1001,28 +1024,55 @@ function parseDreamOutput(rawText: string): DreamOutput {
   return { blocks, summary };
 }
 
-// Reject dream proposals that clear pending.md unless the summary says the work
-// was resolved or abandoned.
-function wouldWipePendingWithoutResolution(
-  previousPending: string,
+// Snapshot-local line IDs avoid changing existing free-form pending.md files.
+// Treating every nonblank line as a unit also protects prose and continuation lines.
+function getPendingItems(pending: string): PendingItem[] {
+  return normalizeMarkdownBlock(pending)
+    .split("\n")
+    .map((text, index) => ({ id: `pending-${index + 1}`, text }))
+    .filter((item) => item.text.trim().length > 0);
+}
+
+function validatePendingDispositions(
+  input: unknown,
+  items: PendingItem[],
   nextPending: string,
-  summary: string,
-): boolean {
-  if (!previousPending.trim()) {
-    return false;
+): void {
+  if (!Array.isArray(input)) {
+    throw new Error("Memory dream must include a pending_dispositions array.");
   }
-
-  if (nextPending.trim()) {
-    return false;
+  const byId = new Map(items.map((item) => [item.id, item.text]));
+  const seen = new Set<string>();
+  const nextLines = nextPending.split("\n");
+  for (const value of input) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+      throw new Error("Memory dream has an invalid pending disposition.");
+    }
+    const disposition = value as Record<string, unknown>;
+    const { id, status } = disposition;
+    if (typeof id !== "string" || !byId.has(id) || seen.has(id)) {
+      throw new Error("Memory dream has a duplicate or unknown pending identifier.");
+    }
+    if (
+      Object.keys(disposition).some((key) => key !== "id" && key !== "status") ||
+      (status !== "retain" && status !== "complete" && status !== "abandon")
+    ) {
+      throw new Error(`Memory dream has an invalid pending disposition for ${id}.`);
+    }
+    seen.add(id);
+    if (status === "retain") {
+      const lineIndex = nextLines.indexOf(byId.get(id)!);
+      if (lineIndex === -1) {
+        throw new Error(
+          `Memory dream must preserve retained pending item ${id} verbatim in pending.md.`,
+        );
+      }
+      nextLines.splice(lineIndex, 1);
+    }
+  }
+  if (seen.size !== items.length) {
+    throw new Error("Memory dream is missing pending dispositions for existing items.");
   }
-
-  return !mentionsResolution(summary);
-}
-
-function mentionsResolution(text: string): boolean {
-  return /\b(resolve|resolved|abandon|abandoned|drop|dropped|complete|completed|close|closed)\b/i.test(
-    text,
-  );
 }
 
 function buildMemoryPrompt(readme: string, blocks: CoreBlocks, researchFiles: string[]): string {
@@ -1078,9 +1128,11 @@ function buildDefaultMemoryReadme(): string {
     "",
     "Dream is the only consolidation mechanism for `core/`.",
     "",
+    "Dream requires an explicit retain, complete, or abandon disposition for every nonblank line of existing `pending.md`. Retained lines must remain verbatim; prose in a summary cannot authorize deleting pending work.",
+    "",
     "Pi can trigger dreaming automatically on session start when logs are stale and after compaction when new compaction context should be folded into memory. You can also run `/memory dream` manually.",
     "",
-    "Dream reads all log entries newer than the last dreamed log timestamp plus pending compaction summaries. It does not automatically retrieve older log entries.",
+    "Dream reads log entries after the append cursor in `state.json` plus pending compaction summaries. Timestamps are provenance, not replay boundaries. The cursor includes a hash of the consumed log prefix; restore the log if that prefix changes. It does not automatically retrieve consumed entries.",
     "",
   ].join("\n");
 }
@@ -1258,6 +1310,7 @@ function defaultMemoryState(): MemoryState {
     lastLogAt: null,
     lastDreamAt: null,
     lastDreamedLogAt: null,
+    lastDreamedLogCursor: null,
     pendingCompactions: [],
   };
 }
@@ -1382,21 +1435,44 @@ function parseMemoryLog(text: string): LogEntry[] {
   }
 
   flush();
-  return entries.sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+  return entries;
 }
 
-function selectUndreamedLogEntries(
-  entries: LogEntry[],
-  lastDreamedLogAt: string | null,
-): LogEntry[] {
-  if (!lastDreamedLogAt) {
-    return [...entries];
+function selectUndreamedLogEntries(logText: string, state: MemoryState): LogEntry[] {
+  const cursor = state.lastDreamedLogCursor;
+  const log = Buffer.from(logText, "utf8");
+  if (
+    cursor &&
+    (cursor.bytes > log.length ||
+      getLogCursor(log.subarray(0, cursor.bytes)).sha256 !== cursor.sha256)
+  ) {
+    throw new Error(
+      "Memory log changed before its dream cursor. Restore log.md or explicitly reset last_dreamed_log_cursor to null to replay the entire log.",
+    );
   }
-  return entries.filter((entry) => entry.timestamp > lastDreamedLogAt);
+  return parseMemoryLog(log.subarray(cursor?.bytes ?? 0).toString("utf8"));
 }
 
-function countUndreamedLogs(entries: LogEntry[], lastDreamedLogAt: string | null): number {
-  return selectUndreamedLogEntries(entries, lastDreamedLogAt).length;
+function getLogCursor(log: Buffer): LogCursor {
+  return { bytes: log.length, sha256: createHash("sha256").update(log).digest("hex") };
+}
+
+function parseLogCursor(input: unknown): LogCursor | null {
+  if (input === undefined || input === null) return null;
+  if (typeof input !== "object" || Array.isArray(input)) {
+    throw new Error("Invalid last_dreamed_log_cursor.");
+  }
+  const cursor = input as Record<string, unknown>;
+  if (
+    typeof cursor.bytes !== "number" ||
+    !Number.isSafeInteger(cursor.bytes) ||
+    cursor.bytes < 0 ||
+    typeof cursor.sha256 !== "string" ||
+    !/^[a-f0-9]{64}$/.test(cursor.sha256)
+  ) {
+    throw new Error("Invalid last_dreamed_log_cursor.");
+  }
+  return { bytes: cursor.bytes, sha256: cursor.sha256 };
 }
 
 function parseLogEntryBody(body: string): {
@@ -1706,7 +1782,7 @@ export default function memoryExtension(pi: ExtensionAPI): void {
         promptSnippet: `Update one core memory block in .agents/memory/core with ${CORE_LINE_CAP}-line and ${CORE_CHAR_CAP}-character cap enforcement`,
         promptGuidelines: [
           "Use memory_update_block when updating .agents/memory/core/directives.md, context.md, focus.md, or pending.md.",
-          `If a write would exceed the ${CORE_LINE_CAP}-line or ${CORE_CHAR_CAP}-character core cap, run memory_dream or remove content first.`,
+          `If memory_update_block would exceed the ${CORE_LINE_CAP}-line or ${CORE_CHAR_CAP}-character core cap, use memory_dream for consolidation. Do not discard unresolved work to fit.`,
         ],
         parameters: MEMORY_UPDATE_BLOCK_PARAMS,
         async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
@@ -1737,7 +1813,6 @@ export default function memoryExtension(pi: ExtensionAPI): void {
         promptSnippet: "Append an entry to the repo memory log at .agents/memory/log.md",
         promptGuidelines: [
           "Use memory_append_log for important decisions, discoveries, plans, experiments, prompt ingests, and attachment additions worth remembering.",
-          "Use importance labels high, medium, or low.",
           "If this entry replaces or corrects prior memory, set supersedes and/or invalidates links explicitly.",
           "The memory log is append-only. Do not rewrite or truncate older entries.",
         ],
@@ -1770,7 +1845,7 @@ export default function memoryExtension(pi: ExtensionAPI): void {
         name: "memory_dream",
         label: "Memory Dream",
         description:
-          "Consolidate repo memory into .agents/memory/core from newer log entries and compaction context",
+          "Consolidate repo memory into .agents/memory/core from undreamed log entries and compaction context",
         promptSnippet: "Consolidate repo memory with dream-based core compression",
         promptGuidelines: [
           "Dream is the only consolidation mechanism for .agents/memory/core.",

package/extensions/notify.ts

@@ -5,7 +5,7 @@
  * - Agent finished and ready for the next prompt
  * - Extension prompt is waiting for a question/confirmation answer
  * Supports multiple terminal protocols:
- * - OSC 777: Ghostty, iTerm2, WezTerm, rxvt-unicode
+ * - OSC 9: Ghostty, Supacode, iTerm2, WezTerm
  * - OSC 99: Kitty
  * - Windows toast: Windows Terminal (WSL)
  */
@@ -29,8 +29,8 @@ function windowsToastScript(title: string, body: string): string {
   ].join("; ");
 }
 
-function notifyOSC777(title: string, body: string): void {
-  process.stdout.write(`\x1b]777;notify;${title};${body}\x07`);
+function notifyOSC9(title: string, body: string): void {
+  process.stdout.write(`\x1b]9;${title}: ${body}\x1b\\`);
 }
 
 function notifyOSC99(title: string, body: string): void {
@@ -51,18 +51,10 @@ function notify(title: string, body: string): void {
   } else if (process.env.KITTY_WINDOW_ID) {
     notifyOSC99(title, body);
   } else {
-    notifyOSC777(title, body);
+    notifyOSC9(title, body);
   }
 }
 
-function getPromptSource(event: unknown): string | undefined {
-  if (!event || typeof event !== "object") return undefined;
-  const source = (event as Record<string, unknown>).source;
-  if (typeof source !== "string") return undefined;
-  const trimmed = source.trim();
-  return trimmed.length > 0 ? trimmed : undefined;
-}
-
 function getSessionKey(ctx: ExtensionContext): string {
   return ctx.sessionManager.getSessionFile() ?? `session:${ctx.sessionManager.getSessionId()}`;
 }
@@ -89,7 +81,7 @@ function extractReviewOutcome(data: unknown): "success" | "failed" | "cancelled"
 }
 
 export default function (pi: ExtensionAPI) {
-  let pendingPromptCount = 0;
+  let promptPending = false;
   const activeReviewSessions = new Set<string>();
   let currentSessionKey: string | undefined;
   let pendingReadyNotification: ReturnType<typeof setImmediate> | undefined;
@@ -110,7 +102,7 @@ export default function (pi: ExtensionAPI) {
     pendingReadyNotification = setImmediate(() => {
       pendingReadyNotification = undefined;
       if (!ctx.isIdle()) return;
-      if (pendingPromptCount > 0) return;
+      if (promptPending) return;
       if (hasCurrentSessionReviewRun()) return;
       notify("Pi", "Ready for input");
     });
@@ -122,18 +114,13 @@ export default function (pi: ExtensionAPI) {
     currentSessionKey = getSessionKey(ctx);
   });
 
-  pi.events.on("ui:prompt_start", (data) => {
-    const wasIdle = pendingPromptCount === 0;
-    pendingPromptCount += 1;
-
-    if (!wasIdle) return;
-    const source = getPromptSource(data);
-    notify("Pi", source ? `Question pending (${source})` : "Question pending");
+  pi.on("ui_prompt_start", async () => {
+    promptPending = true;
+    notify("Pi", "Waiting for input");
   });
 
-  pi.events.on("ui:prompt_end", () => {
-    if (pendingPromptCount === 0) return;
-    pendingPromptCount -= 1;
+  pi.on("ui_prompt_end", async () => {
+    promptPending = false;
   });
 
   pi.events.on(REVIEW_EVENT_START, (data) => {
@@ -148,8 +135,9 @@ export default function (pi: ExtensionAPI) {
 
     activeReviewSessions.delete(sessionKey);
 
-    if (pendingPromptCount > 0) return;
     if (!currentSessionKey || sessionKey !== currentSessionKey) return;
+    cancelReadyNotification();
+    if (promptPending) return;
 
     const outcome = extractReviewOutcome(data);
     if (outcome === "success") {
@@ -170,7 +158,7 @@ export default function (pi: ExtensionAPI) {
 
   pi.on("session_shutdown", async (_event, ctx) => {
     cancelReadyNotification();
-    pendingPromptCount = 0;
+    promptPending = false;
     const sessionKey = getSessionKey(ctx);
     activeReviewSessions.delete(sessionKey);
     if (currentSessionKey === sessionKey) {