@oh-my-pi/pi-coding-agent 15.10.10 → 15.10.11

package/dist/types/slash-commands/helpers/stats-dashboard.d.ts

@@ -0,0 +1,13 @@
+export declare const DEFAULT_STATS_DASHBOARD_PORT = 3847;
+export interface StatsDashboardArgs {
+    port: number;
+}
+export interface StatsDashboardLaunchResult {
+    url: string;
+    message: string;
+}
+export declare function parseStatsDashboardArgs(args: string): StatsDashboardArgs | {
+    error: string;
+};
+export declare function launchStatsDashboard(args: StatsDashboardArgs): Promise<StatsDashboardLaunchResult>;
+export declare function stopStatsDashboard(): void;

package/dist/types/ssh/connection-manager.d.ts

@@ -22,6 +22,14 @@ interface SSHArgsOptions {
 }
 export declare function getHostInfo(hostName: string): Promise<SSHHostInfo | undefined>;
 export declare function getHostInfoForHost(host: SSHConnectionTarget): Promise<SSHHostInfo | undefined>;
+/**
+ * Synchronous, probe-free host info lookup for startup paths.
+ *
+ * Checks the in-memory cache, then falls back to a synchronous read of the
+ * persisted host-info cache file. Never opens a connection or probes the
+ * remote host — callers get `undefined` when nothing is cached yet.
+ */
+export declare function getCachedHostInfoSync(host: SSHConnectionTarget): SSHHostInfo | undefined;
 export declare function ensureHostInfo(host: SSHConnectionTarget): Promise<SSHHostInfo>;
 export declare function buildRemoteCommand(host: SSHConnectionTarget, command: string, options?: SSHArgsOptions): Promise<string[]>;
 export declare function ensureConnection(host: SSHConnectionTarget): Promise<void>;

package/dist/types/task/parallel.d.ts

@@ -19,10 +19,10 @@ export interface ParallelResult<R> {
  *
  * @param items - Items to process
  * @param concurrency - Maximum concurrent operations
- * @param fn - Async function to execute for each item
+ * @param fn - Async function to execute for each item; receives a worker signal that fires on abort or fail-fast so in-flight siblings can cancel
  * @param signal - Optional abort signal to stop scheduling new work
  */
-export declare function mapWithConcurrencyLimit<T, R>(items: T[], concurrency: number, fn: (item: T, index: number) => Promise<R>, signal?: AbortSignal): Promise<ParallelResult<R>>;
+export declare function mapWithConcurrencyLimit<T, R>(items: T[], concurrency: number, fn: (item: T, index: number, signal: AbortSignal) => Promise<R>, signal?: AbortSignal): Promise<ParallelResult<R>>;
 /**
  * Simple counting semaphore for limiting concurrency across independently-scheduled async work.
  */

package/dist/types/task/worktree.d.ts

@@ -78,6 +78,8 @@ export interface MergeBranchResult {
     merged: string[];
     failed: string[];
     conflict?: string;
+    /** Set when cherry-picks landed on HEAD but restoring the stashed working tree failed. */
+    stashConflict?: string;
 }
 /**
  * Cherry-pick task branch commits sequentially onto HEAD.

package/dist/types/tools/ask.d.ts

@@ -41,6 +41,8 @@ export interface QuestionResult {
     multi: boolean;
     selectedOptions: string[];
     customInput?: string;
+    /** True when the answer was auto-selected because the dialog timed out. */
+    timedOut?: boolean;
 }
 export interface AskToolDetails {
     question?: string;
@@ -48,6 +50,8 @@ export interface AskToolDetails {
     multi?: boolean;
     selectedOptions?: string[];
     customInput?: string;
+    /** True when the answer was auto-selected because the dialog timed out. */
+    timedOut?: boolean;
     /** Multi-part question mode */
     results?: QuestionResult[];
 }

package/dist/types/tools/conflict-detect.d.ts

@@ -128,6 +128,22 @@ export declare function parseConflictUri(raw: string): ParsedConflictUri | null;
  * has actually been altered or removed.
  */
 export declare function spliceConflict(originalText: string, entry: ConflictEntry, replacement: string): string;
+/**
+ * True when two registered blocks record the same marker-block content
+ * (labels and all sides). Out-of-band edits can shift a block's line
+ * numbers between reads, registering a fresh id while the stale one
+ * persists; callers use content identity to treat a locate-miss for the
+ * stale twin as "already resolved" instead of a hard failure.
+ */
+export declare function conflictRegionsEqual(a: ConflictBlock, b: ConflictBlock): boolean;
+/**
+ * True when the entry's recorded marker block still occurs in `content`
+ * (LF-normalized — recorded sections are stored LF). Distinguishes a stale
+ * re-registration of a just-resolved region (no longer present) from a
+ * DISTINCT conflict block that happens to be byte-identical (still present
+ * elsewhere in the file and must stay addressable).
+ */
+export declare function conflictRegionPresent(content: string, entry: ConflictBlock): boolean;
 /**
  * Expand `@ours` / `@theirs` / `@base` / `@both` line tokens against the
  * recorded sections of `entry`. A token only triggers when it is the

package/dist/types/tools/github-cache.d.ts

@@ -69,6 +69,13 @@ export declare function invalidate(repo: string, kind: CacheKind, number: number
 export declare function invalidateAllForNumber(number: number, repo?: string): void;
 /** Drop every cached row. Test helper. */
 export declare function clearAll(): void;
+/**
+ * Drop every cached row for a repo, or all rows when the repo is unknown.
+ * Fallback for current-branch `gh pr merge`/`gh pr close`-style mutations
+ * where the bash command names no PR number or URL, so the target row cannot
+ * be identified. Over-invalidation is deliberate (see module header).
+ */
+export declare function invalidateAllForRepo(repo?: string): void;
 /**
  * Test/maintenance helper. Closes and forgets the cached connection so the
  * next access reopens against (possibly) a different DB path.

package/dist/types/tools/sqlite-reader.d.ts

@@ -1,5 +1,7 @@
 import type { Database } from "bun:sqlite";
 export declare function looksLikeSqlite(bytes: Uint8Array): boolean;
+/** Row cap for raw `?q=` SQL — protects against `SELECT *` on multi-million-row tables. */
+export declare const MAX_RAW_QUERY_ROWS = 1000;
 export interface SqlitePathCandidate {
     sqlitePath: string;
     subPath: string;
@@ -84,6 +86,7 @@ export declare function getRowByRowId(db: Database, table: string, key: string):
 export declare function executeReadQuery(db: Database, sql: string): {
     columns: string[];
     rows: Record<string, unknown>[];
+    truncated: boolean;
 };
 export declare function insertRow(db: Database, table: string, data: Record<string, unknown>): void;
 export declare function updateRowByKey(db: Database, table: string, pk: {

package/dist/types/tui/output-block.d.ts

@@ -10,7 +10,7 @@ export interface OutputBlockOptions {
     state?: State;
     sections?: Array<{
         label?: string;
-        lines: string[];
+        lines: readonly string[];
         separator?: boolean;
     }>;
     width: number;
@@ -36,8 +36,8 @@ export declare function renderOutputBlock(options: OutputBlockOptions, theme: Th
  */
 export declare class CachedOutputBlock {
     #private;
-    /** Render with caching. Returns cached result if options haven't changed. */
-    render(options: OutputBlockOptions, theme: Theme): string[];
+    /** Render with caching. Returns the cached (shared, caller-immutable) lines if options haven't changed. */
+    render(options: OutputBlockOptions, theme: Theme): readonly string[];
     /** Invalidate the cache, forcing a rebuild on next render. */
     invalidate(): void;
 }

package/dist/types/utils/changelog.d.ts

@@ -23,3 +23,11 @@ export declare function compareVersions(v1: ChangelogEntry, v2: ChangelogEntry):
  */
 export declare function getNewEntries(entries: ChangelogEntry[], lastVersion: string): ChangelogEntry[];
 export { getChangelogPath } from "../config";
+/**
+ * Last omp version whose changelog the user has seen. Stored as a plain-text
+ * marker file (`~/.omp/agent/last-changelog-version`) rather than in
+ * `config.yml`, so version bumps never dirty user-tracked config files.
+ */
+export declare function readLastChangelogVersion(agentDir?: string): Promise<string | undefined>;
+/** Persist the last-seen changelog version marker. Best-effort: failures are logged, never thrown. */
+export declare function writeLastChangelogVersion(version: string, agentDir?: string): Promise<void>;

package/dist/types/web/scrapers/readthedocs.d.ts

@@ -1,2 +1,5 @@
+/**
+ * Read the Docs handler for web-fetch
+ */
 import { type SpecialHandler } from "./types";
 export declare const handleReadTheDocs: SpecialHandler;

package/dist/types/web/scrapers/types.d.ts

@@ -27,6 +27,12 @@ export interface LoadPageOptions {
     body?: string;
     maxBytes?: number;
     signal?: AbortSignal;
+    /**
+     * Return true to skip reading the response body for this content type
+     * (lowercased mime, no params). The caller is expected to re-fetch the
+     * payload as binary; this avoids streaming + decoding huge binaries twice.
+     */
+    skipBodyForContentType?: (contentType: string) => boolean;
 }
 export interface LoadPageResult {
     content: string;
@@ -34,6 +40,12 @@ export interface LoadPageResult {
     finalUrl: string;
     ok: boolean;
     status?: number;
+    /** True when the body was cut mid-stream at maxBytes. */
+    truncated?: boolean;
+    /** Last transport-level error message when ok is false. */
+    error?: string;
+    /** True when the body read was skipped via skipBodyForContentType. */
+    bodySkipped?: boolean;
 }
 /**
  * Fetch a page with timeout and size limit

package/dist/types/web/search/providers/codex.d.ts

@@ -1,4 +1,4 @@
-import { type AuthStorage, type FetchImpl } from "@oh-my-pi/pi-ai";
+import type { AuthStorage, FetchImpl } from "@oh-my-pi/pi-ai";
 import type { SearchResponse } from "../../../web/search/types";
 import type { SearchParams } from "./base";
 import { SearchProvider } from "./base";

package/dist/types/web/search/providers/gemini.d.ts

@@ -8,7 +8,7 @@
  * sibling SQLite store and never POSTs the broker sentinel to a Google token
  * endpoint.
  */
-import { type AuthStorage, type FetchImpl } from "@oh-my-pi/pi-ai";
+import type { AuthStorage, FetchImpl } from "@oh-my-pi/pi-ai";
 import type { SearchResponse } from "../../../web/search/types";
 import type { SearchParams } from "./base";
 import { SearchProvider } from "./base";

package/examples/extensions/tools.ts

@@ -68,7 +68,7 @@ export default function toolsExtension(pi: ExtensionAPI) {
 			// Refresh tool list
 			allTools = pi.getAllTools();
 
-			await ctx.ui.custom((tui, theme, done) => {
+			await ctx.ui.custom((tui, theme, _keybindings, done) => {
 				// Build settings items for each tool
 				const items: SettingItem[] = allTools.map(tool => ({
 					id: tool,
@@ -78,10 +78,11 @@ export default function toolsExtension(pi: ExtensionAPI) {
 				}));
 
 				const container = new Container();
+				const header: readonly string[] = [theme.fg("accent", theme.bold("Tool Configuration")), ""];
 				container.addChild(
 					new (class {
-						render(_width: number) {
-							return [theme.fg("accent", theme.bold("Tool Configuration")), ""];
+						render(_width: number): readonly string[] {
+							return header;
 						}
 						invalidate() {}
 					})(),
@@ -110,7 +111,7 @@ export default function toolsExtension(pi: ExtensionAPI) {
 				container.addChild(settingsList);
 
 				const component = {
-					render(width: number) {
+					render(width: number): readonly string[] {
 						return container.render(width);
 					},
 					invalidate() {

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "15.10.10",
+	"version": "15.10.11",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -28,7 +28,7 @@
 	"main": "./src/index.ts",
 	"types": "./dist/types/index.d.ts",
 	"bin": {
-		"omp": "src/cli.ts"
+		"omp": "dist/cli.js"
 	},
 	"scripts": {
 		"build": "bun scripts/build-binary.ts",
@@ -40,21 +40,22 @@
 		"fmt": "biome format --write . && bun run format-prompts",
 		"format-prompts": "bun scripts/format-prompts.ts",
 		"generate-docs-index": "bun scripts/generate-docs-index.ts",
-		"prepack": "bun scripts/generate-docs-index.ts",
+		"prepack": "bun scripts/generate-docs-index.ts && bun scripts/bundle-dist.ts",
 		"generate-template": "bun scripts/generate-template.ts"
 	},
 	"dependencies": {
 		"@agentclientprotocol/sdk": "0.22.1",
 		"@babel/parser": "^7.29.7",
 		"@mozilla/readability": "^0.6.0",
-		"@oh-my-pi/hashline": "15.10.10",
-		"@oh-my-pi/omp-stats": "15.10.10",
-		"@oh-my-pi/pi-agent-core": "15.10.10",
-		"@oh-my-pi/pi-ai": "15.10.10",
-		"@oh-my-pi/pi-mnemopi": "15.10.10",
-		"@oh-my-pi/pi-natives": "15.10.10",
-		"@oh-my-pi/pi-tui": "15.10.10",
-		"@oh-my-pi/pi-utils": "15.10.10",
+		"@oh-my-pi/hashline": "15.10.11",
+		"@oh-my-pi/omp-stats": "15.10.11",
+		"@oh-my-pi/pi-agent-core": "15.10.11",
+		"@oh-my-pi/pi-ai": "15.10.11",
+		"@oh-my-pi/pi-catalog": "15.10.11",
+		"@oh-my-pi/pi-mnemopi": "15.10.11",
+		"@oh-my-pi/pi-natives": "15.10.11",
+		"@oh-my-pi/pi-tui": "15.10.11",
+		"@oh-my-pi/pi-utils": "15.10.11",
 		"@opentelemetry/api": "^1.9.1",
 		"@opentelemetry/context-async-hooks": "^2.7.1",
 		"@opentelemetry/exporter-trace-otlp-proto": "^0.218.0",
@@ -87,6 +88,8 @@
 	},
 	"files": [
 		"src",
+		"dist/cli.js",
+		"dist/*.node",
 		"scripts",
 		"examples",
 		"README.md",

package/scripts/build-binary.ts

@@ -4,6 +4,7 @@ import { createRequire } from "node:module";
 import * as path from "node:path";
 
 const packageDir = path.join(import.meta.dir, "..");
+const repoRoot = path.join(packageDir, "..", "..");
 const outputPath = path.join(packageDir, "dist", "omp");
 
 // Transformers.js is an optional, native-heavy dependency that is never bundled
@@ -19,9 +20,13 @@ function shouldAdhocSignDarwinBinary(): boolean {
 	return process.platform === "darwin";
 }
 
-async function runCommand(command: string[], env: NodeJS.ProcessEnv = Bun.env): Promise<void> {
+async function runCommand(
+	command: string[],
+	env: NodeJS.ProcessEnv = Bun.env,
+	cwd: string = packageDir,
+): Promise<void> {
 	const proc = Bun.spawn(command, {
-		cwd: packageDir,
+		cwd,
 		env,
 		stdout: "inherit",
 		stderr: "inherit",
@@ -55,19 +60,8 @@ async function main(): Promise<void> {
 					"--external",
 					"mupdf",
 					"--root",
-					"../..",
-					"./src/cli.ts",
-					// Worker entrypoints. Bun's `--compile` discovers the literal in
-					// `new Worker("…", …)` at each spawn site, but only actually
-					// emits the worker into the bunfs root when it is listed here as
-					// an explicit additional entry. Paths are relative to this
-					// script's cwd (packages/coding-agent) and the `--root` above
-					// (../..) makes them appear inside the binary at
-					// `/$bunfs/root/packages/<pkg>/src/<worker>.js`, which is
-					// exactly what the literals at the spawn sites resolve to.
-					"../stats/src/sync-worker.ts",
-					"./src/tools/browser/tab-worker-entry.ts",
-					"./src/eval/js/worker-entry.ts",
+					".",
+					"./packages/coding-agent/src/cli.ts",
 					// Legacy pi-* extension compat entrypoints served by
 					// `legacy-pi-compat.ts`. These are reached via computed bunfs paths
 					// (which `--compile`'s static analyzer cannot trace), so each must be
@@ -77,17 +71,18 @@ async function main(): Promise<void> {
 					// breaks the CLI entry when the same package's barrel appears as an
 					// extra entrypoint (issue #1474), so legacy `pi-coding-agent` imports
 					// resolve through `legacy-pi-coding-agent-shim.ts` instead.
-					"../agent/src/index.ts",
-					"../natives/native/index.js",
-					"../tui/src/index.ts",
-					"../utils/src/index.ts",
-					"./src/extensibility/typebox.ts",
-					"./src/extensibility/legacy-pi-ai-shim.ts",
-					"./src/extensibility/legacy-pi-coding-agent-shim.ts",
+					"./packages/agent/src/index.ts",
+					"./packages/natives/native/index.js",
+					"./packages/tui/src/index.ts",
+					"./packages/utils/src/index.ts",
+					"./packages/coding-agent/src/extensibility/typebox.ts",
+					"./packages/coding-agent/src/extensibility/legacy-pi-ai-shim.ts",
+					"./packages/coding-agent/src/extensibility/legacy-pi-coding-agent-shim.ts",
 					"--outfile",
-					"dist/omp",
+					"packages/coding-agent/dist/omp",
 				],
 				buildEnv,
+				repoRoot,
 			);
 
 			// Bun 1.3.12 emits a truncated Mach-O signature on darwin builds.

package/scripts/bundle-dist.ts

@@ -0,0 +1,81 @@
+#!/usr/bin/env bun
+
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { isEnoent } from "@oh-my-pi/pi-utils";
+
+const packageDir = path.join(import.meta.dir, "..");
+const outDir = path.join(packageDir, "dist");
+const cliPath = path.join(outDir, "cli.js");
+const shebang = "#!/usr/bin/env bun\n";
+
+async function runCommand(command: string[]): Promise<void> {
+	const proc = Bun.spawn(command, {
+		cwd: packageDir,
+		stdout: "inherit",
+		stderr: "inherit",
+	});
+	const exitCode = await proc.exited;
+	if (exitCode !== 0) throw new Error(`Command failed with exit code ${exitCode}: ${command.join(" ")}`);
+}
+
+async function ensureShebang(): Promise<void> {
+	const text = await Bun.file(cliPath).text();
+	if (text.startsWith(shebang)) return;
+	const withoutExisting = text.startsWith("#!") ? text.slice(text.indexOf("\n") + 1) : text;
+	await Bun.write(cliPath, shebang + withoutExisting);
+}
+
+function formatBytes(bytes: number): string {
+	if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}KB`;
+	return `${(bytes / (1024 * 1024)).toFixed(2)}MB`;
+}
+
+async function cleanBundleOutputs(): Promise<void> {
+	// dist/ is shared with the dev binary (dist/omp); only remove this
+	// script's own outputs (entry bundle + copied native assets).
+	let entries: string[];
+	try {
+		entries = await fs.readdir(outDir);
+	} catch (err) {
+		if (isEnoent(err)) return;
+		throw err;
+	}
+	await Promise.all(
+		entries
+			.filter(entry => entry === "cli.js" || entry.endsWith(".node") || entry.endsWith(".js.map"))
+			.map(entry => fs.rm(path.join(outDir, entry), { force: true })),
+	);
+}
+
+async function main(): Promise<void> {
+	const start = Bun.nanoseconds();
+	await cleanBundleOutputs();
+	await runCommand([
+		"bun",
+		"build",
+		"--target=bun",
+		"--outdir",
+		"dist",
+		"--minify-whitespace",
+		"--minify-syntax",
+		"--keep-names",
+		"--external",
+		"mupdf",
+		"--external",
+		"@oh-my-pi/pi-natives",
+		"--external",
+		"@huggingface/transformers",
+		"--define",
+		'process.env.PI_BUNDLED="true"',
+		"./src/cli.ts",
+	]);
+	await ensureShebang();
+	const stat = await fs.stat(cliPath);
+	const elapsedMs = (Bun.nanoseconds() - start) / 1_000_000;
+	process.stdout.write(
+		`Bundled coding-agent CLI to dist/cli.js (${formatBytes(stat.size)}) in ${elapsedMs.toFixed(0)}ms\n`,
+	);
+}
+
+await main();

package/scripts/{dev-launch → omp}

@@ -27,7 +27,7 @@ while [ -L "$self" ]; do
 done
 scripts_dir=$(CDPATH= cd -- "$(dirname -- "$self")" && pwd -P)
 cli=$scripts_dir/../src/cli.ts
-preload=$scripts_dir/dev-launch-preload.ts
+preload=$scripts_dir/omp.ts
 timing_preload=$scripts_dir/../../utils/src/module-timer.ts
 
 launch_dir=${OMP_DEV_LAUNCH_DIR:-${HOME}/.omp/.dev-cwd}

package/scripts/{dev-launch-preload.ts → omp.ts}

@@ -1,5 +1,5 @@
 /**
- * Bun `--preload` shim for the omp dev launcher (`scripts/dev-launch`).
+ * Bun `--preload` shim for the omp dev launcher (`scripts/omp`).
  *
  * The launcher starts Bun from an empty, bunfig-free directory so a foreign
  * project's `bunfig.toml` `preload` cannot run inside the omp CLI: Bun reads

package/src/async/job-manager.ts

@@ -23,6 +23,12 @@ export interface AsyncJob {
 	 * supply an id (e.g. legacy tests, SDK consumers without an agent context).
 	 */
 	ownerId?: string;
+	/**
+	 * Job is registered but parked behind a caller-managed gate (e.g. a task
+	 * batch semaphore). Queued jobs do not count toward the running-job limit
+	 * until the caller invokes `markRunning()` from the run context.
+	 */
+	queued?: boolean;
 }
 
 export interface AsyncJobManagerOptions {
@@ -53,6 +59,8 @@ export interface AsyncJobRegisterOptions {
 	/** Registry id of the agent that owns this job; used to scope cancelAll. */
 	ownerId?: string;
 	onProgress?: (text: string, details?: Record<string, unknown>) => void | Promise<void>;
+	/** Register the job in queued state; see {@link AsyncJob.queued}. */
+	queued?: boolean;
 }
 
 /**
@@ -110,6 +118,17 @@ export class AsyncJobManager {
 		this.#retentionMs = Math.max(0, Math.floor(options.retentionMs ?? DEFAULT_RETENTION_MS));
 	}
 
+	/** True when the running-job count has reached the configured cap. */
+	get atCapacity(): boolean {
+		if (this.#disposed) return true;
+		// Mirror register(): queued jobs hold no execution slot.
+		let activeCount = 0;
+		for (const job of this.#jobs.values()) {
+			if (job.status === "running" && !job.queued) activeCount++;
+		}
+		return activeCount >= this.#maxRunningJobs;
+	}
+
 	register(
 		type: "bash" | "task",
 		label: string,
@@ -117,14 +136,21 @@ export class AsyncJobManager {
 			jobId: string;
 			signal: AbortSignal;
 			reportProgress: (text: string, details?: Record<string, unknown>) => Promise<void>;
+			/** Clear the queued flag once the job actually starts executing. */
+			markRunning: () => void;
 		}) => Promise<string>,
 		options?: AsyncJobRegisterOptions,
 	): string {
 		if (this.#disposed) {
 			throw new Error("Async job manager is disposed");
 		}
-		const runningCount = this.getRunningJobs().length;
-		if (runningCount >= this.#maxRunningJobs) {
+		// Queued jobs hold no execution slot yet — only count jobs that are
+		// actually running so a large parked batch cannot starve registration.
+		let activeCount = 0;
+		for (const existing of this.#jobs.values()) {
+			if (existing.status === "running" && !existing.queued) activeCount++;
+		}
+		if (activeCount >= this.#maxRunningJobs) {
 			throw new Error(
 				`Background job limit reached (${this.#maxRunningJobs}). Wait for running jobs to finish or cancel one.`,
 			);
@@ -144,6 +170,7 @@ export class AsyncJobManager {
 			abortController,
 			promise: Promise.resolve(),
 			ownerId: options?.ownerId,
+			queued: options?.queued === true,
 		};
 
 		const reportProgress = async (text: string, details?: Record<string, unknown>): Promise<void> => {
@@ -159,7 +186,14 @@ export class AsyncJobManager {
 		};
 		job.promise = (async () => {
 			try {
-				const text = await run({ jobId: id, signal: abortController.signal, reportProgress });
+				const text = await run({
+					jobId: id,
+					signal: abortController.signal,
+					reportProgress,
+					markRunning: () => {
+						job.queued = false;
+					},
+				});
 				if (job.status === "cancelled") {
 					job.resultText = text;
 					this.#scheduleEviction(id);
@@ -278,6 +312,26 @@ export class AsyncJobManager {
 		return before - this.#deliveries.length;
 	}
 
+	/**
+	 * Lift a foreground-wait suppression set via `acknowledgeDeliveries`. If the
+	 * job already finished while suppressed (its delivery enqueue was skipped),
+	 * re-enqueue the completion so the result is still delivered exactly once.
+	 */
+	resumeDeliveries(jobIds: string[]): void {
+		for (const rawId of jobIds) {
+			const jobId = rawId.trim();
+			if (!jobId) continue;
+			if (!this.#suppressedDeliveries.delete(jobId)) continue;
+			const job = this.#jobs.get(jobId);
+			if (!job || (job.status !== "completed" && job.status !== "failed")) continue;
+			const queued =
+				this.#deliveries.some(delivery => delivery.jobId === jobId) ||
+				this.#inFlightDeliveries.some(delivery => delivery.jobId === jobId);
+			if (queued) continue;
+			this.#enqueueDelivery(jobId, job.status === "completed" ? (job.resultText ?? "") : (job.errorText ?? ""));
+		}
+	}
+
 	/**
 	 * Cancel running jobs. With `filter.ownerId` set, cancels only jobs the
 	 * matching agent registered; with no filter, cancels every running job

package/src/autoresearch/dashboard.ts

@@ -66,7 +66,7 @@ export function createDashboardController(): DashboardController {
 
 					let scrollOffset = 0;
 					return {
-						render(width: number): string[] {
+						render(width: number): readonly string[] {
 							const terminalRows = process.stdout.rows ?? 40;
 							const header = renderExpandedHeader(runtime, width, theme);
 							const body = renderDashboardLines(runtime, width, theme, 0);

package/src/autoresearch/prompt-setup.md

@@ -18,16 +18,16 @@ Working directory: `{{working_dir}}`
 {{baseline_warning}}
 {{/if}}
 
-### What you must produce
+### What you MUST produce
 
-Write `./autoresearch.sh` at the working directory. It is the canonical benchmark entrypoint and must:
+Write `./autoresearch.sh` at the working directory. It is the canonical benchmark entrypoint and MUST:
 
 - exit 0 on success and non-zero on failure;
 - print the primary metric as a single line `METRIC <name>=<value>`;
 - print any secondary metrics as additional `METRIC <name>=<value>` lines;
 - run the same workload deterministically every time (no live network, no time-of-day dependencies, fixed seeds where applicable).
 
-You **may** edit anything else needed to make `autoresearch.sh` work — benchmark binaries, `Cargo.toml`, `package.json`, helper scripts, fixtures. All those edits are part of the harness baseline and will be committed for you when you call `init_experiment` on an autoresearch branch.
+You MAY edit anything else needed to make `autoresearch.sh` work — benchmark binaries, `Cargo.toml`, `package.json`, helper scripts, fixtures. All those edits are part of the harness baseline and will be committed for you when you call `init_experiment` on an autoresearch branch.
 
 ### Steps
 
@@ -38,6 +38,6 @@ You **may** edit anything else needed to make `autoresearch.sh` work — benchma
 
 ### Rules
 
-- Do **not** call `run_experiment`, `log_experiment`, or `update_notes` yet. They will error with "no active autoresearch session" until `init_experiment` runs.
-- Do **not** treat a compile-only check as a benchmark. The harness must actually execute the workload and emit `METRIC`.
-- Do **not** create `autoresearch.md`, `autoresearch.checks.sh`, `autoresearch.program.md`, `autoresearch.ideas.md`, `autoresearch.jsonl`, `.autoresearch/`, or `autoresearch.config.json`. Session state is tracked for you.
+- NEVER call `run_experiment`, `log_experiment`, or `update_notes` yet. They will error with "no active autoresearch session" until `init_experiment` runs.
+- NEVER treat a compile-only check as a benchmark. The harness MUST actually execute the workload and emit `METRIC`.
+- NEVER create `autoresearch.md`, `autoresearch.checks.sh`, `autoresearch.program.md`, `autoresearch.ideas.md`, `autoresearch.jsonl`, `.autoresearch/`, or `autoresearch.config.json`. Session state is tracked for you.