@code-yeongyu/senpi-codemode 2026.8.7 → 2026.8.9-2

package/CHANGELOG.md

@@ -12,6 +12,39 @@
 
 ### Removed
 
+## [2026.8.9-2] - 2026-08-09
+
+### Breaking Changes
+
+### Added
+
+### Changed
+
+- Detached eval cells now emit the shared `wake_source_state` event under source `senpi-codemode` when they detach, complete, stop, or are disposed. The optional host event passthrough remains guarded, synchronous cells emit no lifecycle transition, and per-cell snapshot metadata is preserved.
+
+### Fixed
+
+### Removed
+
+## [2026.8.9] - 2026-08-09
+
+### Breaking Changes
+
+### Added
+
+- Detached eval cells now publish their liveness as a `resumption_channel_state` event (source `eval-detached`) on the
+  host event bus: a full per-source snapshot with `activeCount` and per-cell `id`/`description`/`startedAtMs` entries is
+  emitted whenever a cell detaches, settles, is stopped, or is disposed, and once on `session_start`. The goal builtin
+  consumes this to hold its hidden continuation while detached cells are still computing instead of nagging immediately
+  at turn end. Hosts without an event bus are unaffected (emission is a no-op), and the footer/status rendering is
+  unchanged.
+
+### Changed
+
+### Fixed
+
+### Removed
+
 ## [2026.8.7] - 2026-08-07
 
 ### Breaking Changes

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@code-yeongyu/senpi-codemode",
-	"version": "2026.8.7",
+	"version": "2026.8.9-2",
 	"description": "Source-only senpi extension package for codemode evaluation tools",
 	"type": "module",
 	"main": "./src/index.ts",
@@ -30,14 +30,14 @@
 	},
 	"dependencies": {
 		"@babel/parser": "8.0.4",
-		"@earendil-works/pi-ai": "npm:@code-yeongyu/senpi-ai@2026.8.7",
+		"@earendil-works/pi-ai": "npm:@code-yeongyu/senpi-ai@2026.8.9-2",
 		"typebox": "1.3.8"
 	},
 	"peerDependencies": {
-		"@code-yeongyu/senpi": "2026.8.7"
+		"@code-yeongyu/senpi": "2026.8.9-2"
 	},
 	"devDependencies": {
-		"@code-yeongyu/senpi": "2026.8.7"
+		"@code-yeongyu/senpi": "2026.8.9-2"
 	},
 	"keywords": [
 		"senpi",

package/src/extension/wake-source-state.ts

@@ -0,0 +1,29 @@
+/**
+ * Wake-source liveness contract shared with the goal builtin.
+ *
+ * The goal builtin delays its hidden continuation while any live wake source
+ * can still wake the session. Each emitter publishes a full per-source
+ * snapshot on every liveness transition and once on `session_start`.
+ *
+ * The event name is duplicated here on purpose: senpi-codemode is a separate
+ * package and must not import across the packages/coding-agent boundary, so
+ * the sentinel test pins this literal to the exact cross-package contract.
+ */
+export const WAKE_SOURCE_STATE_EVENT = "wake_source_state";
+
+/** Source key identifying detached eval cells in the per-source snapshot. */
+export const SENPI_CODEMODE_WAKE_SOURCE = "senpi-codemode";
+
+/** One detached cell as broadcast on the wake-source state event. */
+export interface WakeSourceStateItem {
+	readonly id: string;
+	readonly description: string;
+	/** Epoch milliseconds when the channel registered; lets consumers render their own elapsed labels. */
+	readonly startedAtMs: number;
+}
+
+export interface WakeSourceState {
+	readonly source: string;
+	readonly activeCount: number;
+	readonly items?: readonly WakeSourceStateItem[];
+}

package/src/index.ts

@@ -15,6 +15,7 @@ import {
 } from "./extension/runtime-factory.ts";
 import type { CodemodeSessionManager, CreateCodemodeSessionManagerOptions } from "./extension/session-manager.ts";
 import { SessionManagerProxy } from "./extension/session-manager-proxy.ts";
+import { WAKE_SOURCE_STATE_EVENT, type WakeSourceState } from "./extension/wake-source-state.ts";
 import { EvalDetachedCellManager, type EvalDetachedCellStatusEntry } from "./tool/detached-cell-manager.ts";
 import { createEvalTool } from "./tool/eval-tool.ts";
 import { renderEvalCall, renderEvalResult } from "./tool/render.ts";
@@ -38,6 +39,8 @@ export interface CodemodeExtensionAPI {
 	getActiveTools(): string[];
 	getAllTools(): readonly EvalSchemaToolInfo[];
 	sendUserMessage(content: string, options?: { deliverAs?: "steer" | "followUp" }): void;
+	/** Optional host event bus; a host without one turns wake-source emission into a harmless no-op. */
+	events?: { emit(name: string, data: unknown): void };
 }
 
 export interface SenpiCodemodeOptions {
@@ -79,6 +82,9 @@ export default function senpiCodemode(pi: CodemodeExtensionAPI, options: SenpiCo
 	const showDetachedCells = (entries: readonly EvalDetachedCellStatusEntry[]): void => {
 		statusTicker.sync(entries);
 	};
+	const emitWakeSourceState = (state: WakeSourceState): void => {
+		pi.events?.emit(WAKE_SOURCE_STATE_EVENT, state);
+	};
 	const registerEvalForRuntime = (
 		runtime: SessionRuntime,
 		modelId: string | undefined,
@@ -126,6 +132,7 @@ export default function senpiCodemode(pi: CodemodeExtensionAPI, options: SenpiCo
 			cellManager: new EvalDetachedCellManager({
 				notifier,
 				onStatusChange: showDetachedCells,
+				onWakeSourceState: emitWakeSourceState,
 				...(options.now === undefined ? {} : { now: options.now }),
 			}),
 			executionTracker: manager,
@@ -156,9 +163,12 @@ export default function senpiCodemode(pi: CodemodeExtensionAPI, options: SenpiCo
 			artifactsDir: runtime.artifactsDir,
 			notifier,
 			onStatusChange: showDetachedCells,
+			onWakeSourceState: emitWakeSourceState,
 			...(options.now === undefined ? {} : { now: options.now }),
 		});
 		activeCells = cellManager;
+		// The goal builtin clears its per-session counts at session_start; re-publish our snapshot.
+		cellManager.publishWakeSourceState();
 		activeRuntime = runtime;
 		activeModelId = ctx.model?.id;
 		registerEvalForRuntime(runtime, activeModelId, cellManager);

package/src/tool/detached-cell-manager.ts

@@ -1,4 +1,5 @@
 import type { AgentToolResult } from "@code-yeongyu/senpi";
+import { SENPI_CODEMODE_WAKE_SOURCE, type WakeSourceState } from "../extension/wake-source-state.ts";
 import { detachedNotificationSpillPath } from "./detached-cell-notification.ts";
 import { currentDetachedResult, detachedErrorResult, snapshotDetachedCell } from "./detached-cell-snapshot.ts";
 import {
@@ -58,12 +59,15 @@ export interface EvalDetachedCellManagerOptions {
 	readonly artifactsDir?: string;
 	readonly notifier?: EvalDetachedCellNotifier;
 	readonly onStatusChange?: (entries: readonly EvalDetachedCellStatusEntry[]) => void;
+	/** Receives a full per-source liveness snapshot on every detached-cell transition; used by the goal builtin. */
+	readonly onWakeSourceState?: (state: WakeSourceState) => void;
 	readonly now?: () => number;
 }
 
 export class EvalDetachedCellManager {
 	readonly #artifactsDir: string | undefined;
 	readonly #onStatusChange: ((entries: readonly EvalDetachedCellStatusEntry[]) => void) | undefined;
+	readonly #onWakeSourceState: ((state: WakeSourceState) => void) | undefined;
 	readonly #cells = new Map<string, ManagedCell>();
 	readonly #detachedByLanguage = new Map<EvalLanguage, ManagedCell>();
 	readonly #notificationQueue: DetachedNotificationQueue;
@@ -72,6 +76,7 @@ export class EvalDetachedCellManager {
 	constructor(options: EvalDetachedCellManagerOptions = {}) {
 		this.#artifactsDir = options.artifactsDir;
 		this.#onStatusChange = options.onStatusChange;
+		this.#onWakeSourceState = options.onWakeSourceState;
 		this.#notificationQueue = new DetachedNotificationQueue(options.notifier, options.artifactsDir);
 		this.#now = options.now ?? Date.now;
 	}
@@ -155,6 +160,7 @@ export class EvalDetachedCellManager {
 		await Promise.allSettled(
 			detached.map(async (cell) => await this.stop(cell.cellId, "Session ended; detached eval cell cancelled")),
 		);
+		if (detached.length === 0) this.#emitWakeSourceState([]);
 		await this.#notificationQueue.flush();
 	}
 
@@ -162,6 +168,11 @@ export class EvalDetachedCellManager {
 		await this.#notificationQueue.flush();
 	}
 
+	/** Re-publish the current snapshot; consumers reset their per-source counts at session_start. */
+	publishWakeSourceState(): void {
+		this.#emitWakeSourceState([...this.#detachedByLanguage.values()]);
+	}
+
 	#settle(
 		cell: ManagedCell,
 		state: "completed" | "failed" | "cancelled",
@@ -188,14 +199,29 @@ export class EvalDetachedCellManager {
 	}
 
 	#emitStatus(): void {
+		const liveCells = [...this.#detachedByLanguage.values()];
 		this.#onStatusChange?.(
-			[...this.#detachedByLanguage.values()].map((cell) => ({
+			liveCells.map((cell) => ({
 				cellId: cell.cellId,
 				language: cell.input.language,
 				startedAtMs: cell.startedAtMs,
 				...(cell.input.summary === undefined ? {} : { summary: cell.input.summary }),
 			})),
 		);
+		this.#emitWakeSourceState(liveCells);
+	}
+
+	#emitWakeSourceState(liveCells: readonly ManagedCell[]): void {
+		this.#onWakeSourceState?.({
+			source: SENPI_CODEMODE_WAKE_SOURCE,
+			activeCount: liveCells.length,
+			items: liveCells.map((cell) => ({
+				id: cell.cellId,
+				description:
+					cell.input.summary === undefined || cell.input.summary.length === 0 ? cell.cellId : cell.input.summary,
+				startedAtMs: cell.startedAtMs,
+			})),
+		});
 	}
 
 	#snapshot(cell: ManagedCell): EvalDetachedCellSnapshot {