@prometheus-ai/agent 0.5.3 → 0.5.8

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

@@ -1,4 +1,4 @@
-import { type AuthStorage } from "@prometheus-ai/ai";
+import { type AuthStorage, type FetchImpl } from "@prometheus-ai/ai";
 import type { SearchResponse } from "../../../web/search/types";
 import type { SearchParams } from "./base";
 import { SearchProvider } from "./base";
@@ -6,6 +6,7 @@ export declare function searchParallel(params: {
     query: string;
     num_results?: number;
     signal?: AbortSignal;
+    fetch?: FetchImpl;
 }, authStorage: AuthStorage, sessionId?: string): Promise<SearchResponse>;
 export declare class ParallelProvider extends SearchProvider {
     readonly id = "parallel";

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

@@ -1,12 +1,13 @@
 /**
  * Perplexity Web Search Provider
  *
- * Supports three auth modes:
+ * Supports four auth modes:
  * - Cookies (`PERPLEXITY_COOKIES`) via `www.perplexity.ai/rest/sse/perplexity_ask`
  * - OAuth/session bearer via `AuthStorage` and `www.perplexity.ai/rest/sse/perplexity_ask`
  * - API key (`PERPLEXITY_API_KEY`) via `api.perplexity.ai/chat/completions`
+ * - Anonymous via `www.perplexity.ai/rest/sse/perplexity_ask`
  */
-import { type AuthStorage } from "@prometheus-ai/ai";
+import { type AuthStorage, type FetchImpl } from "@prometheus-ai/ai";
 import type { SearchResponse } from "../../../web/search/types";
 import type { SearchParams } from "./base";
 import { SearchProvider } from "./base";
@@ -24,6 +25,7 @@ export interface PerplexitySearchParams {
     num_search_results?: number;
     authStorage: AuthStorage;
     sessionId?: string;
+    fetch?: FetchImpl;
 }
 /** Find PERPLEXITY_API_KEY from environment or .env files (also checks PPLX_API_KEY) */
 export declare function findApiKey(): string | null;
@@ -34,5 +36,11 @@ export declare class PerplexityProvider extends SearchProvider {
     readonly id = "perplexity";
     readonly label = "Perplexity";
     isAvailable(authStorage: AuthStorage): boolean;
+    /**
+     * Perplexity accepts anonymous browser-style ask requests, but keep auto
+     * provider selection credential-gated so a configured provider keeps priority
+     * over the anonymous fallback.
+     */
+    isExplicitlyAvailable(_authStorage: AuthStorage): boolean;
     search(params: SearchParams): Promise<SearchResponse>;
 }

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

@@ -24,7 +24,7 @@
  *
  * Reference: https://docs.searxng.org/dev/search_api.html
  */
-import type { AuthStorage } from "@prometheus-ai/ai";
+import type { AuthStorage, FetchImpl } from "@prometheus-ai/ai";
 import type { SearchResponse } from "../../../web/search/types";
 import type { SearchParams } from "./base";
 import { SearchProvider } from "./base";
@@ -34,6 +34,7 @@ export declare function searchSearXNG(params: {
     num_results?: number;
     recency?: "day" | "week" | "month" | "year";
     signal?: AbortSignal;
+    fetch?: FetchImpl;
 }): Promise<SearchResponse>;
 /** Search provider for SearXNG web search. */
 export declare class SearXNGProvider extends SearchProvider {

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

@@ -4,18 +4,22 @@
  * Uses Synthetic's zero-data-retention web search API for coding agents.
  * Endpoint: POST https://api.synthetic.new/v2/search
  */
-import { type AuthStorage } from "@prometheus-ai/ai";
+import { type AuthStorage, type FetchImpl } from "@prometheus-ai/ai";
 import type { SearchResponse } from "../../../web/search/types";
 import type { SearchParams } from "./base";
 import { SearchProvider } from "./base";
+type SearchParamsWithFetch = SearchParams & {
+    fetch?: FetchImpl;
+};
 /** Resolve Synthetic API key through the shared auth storage pipeline. */
 export declare function findApiKey(authStorage: AuthStorage, sessionId?: string, signal?: AbortSignal): Promise<string | undefined>;
 /** Execute Synthetic web search. */
-export declare function searchSynthetic(params: SearchParams): Promise<SearchResponse>;
+export declare function searchSynthetic(params: SearchParamsWithFetch): Promise<SearchResponse>;
 /** Search provider for Synthetic. */
 export declare class SyntheticProvider extends SearchProvider {
     readonly id = "synthetic";
     readonly label = "Synthetic";
     isAvailable(authStorage: AuthStorage): boolean;
-    search(params: SearchParams): Promise<SearchResponse>;
+    search(params: SearchParamsWithFetch): Promise<SearchResponse>;
 }
+export {};

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

@@ -4,7 +4,7 @@
  * Uses Tavily's agent-focused search API to return structured results with an
  * optional synthesized answer.
  */
-import { type AuthStorage } from "@prometheus-ai/ai";
+import { type AuthStorage, type FetchImpl } from "@prometheus-ai/ai";
 import type { SearchResponse } from "../../../web/search/types";
 import type { SearchParams } from "./base";
 import { SearchProvider } from "./base";
@@ -13,6 +13,7 @@ export interface TavilySearchParams {
     num_results?: number;
     recency?: "day" | "week" | "month" | "year";
     signal?: AbortSignal;
+    fetch?: FetchImpl;
 }
 /** Find Tavily API key through AuthStorage's unified refresh pipeline. */
 export declare function findApiKey(authStorage: AuthStorage, sessionId: string | undefined, signal: AbortSignal | undefined): Promise<string | null>;

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

@@ -4,7 +4,7 @@
  * Calls Z.AI's remote MCP server (`webSearchPrime`) and adapts results into
  * the unified SearchResponse shape used by the web search tool.
  */
-import { type AuthStorage } from "@prometheus-ai/ai";
+import { type AuthStorage, type FetchImpl } from "@prometheus-ai/ai";
 import type { SearchResponse } from "../../../web/search/types";
 import type { SearchParams } from "./base";
 import { SearchProvider } from "./base";
@@ -12,6 +12,7 @@ export interface ZaiSearchParams {
     query: string;
     num_results?: number;
     signal?: AbortSignal;
+    fetch?: FetchImpl;
     authStorage: AuthStorage;
     sessionId?: string;
 }

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

@@ -18,7 +18,7 @@ export declare const SEARCH_PROVIDER_OPTIONS: readonly [{
 }, {
     readonly value: "perplexity";
     readonly label: "Perplexity";
-    readonly description: "Requires PERPLEXITY_COOKIES or PERPLEXITY_API_KEY";
+    readonly description: "Uses auth when configured; explicit selection falls back to anonymous search";
 }, {
     readonly value: "brave";
     readonly label: "Brave";

package/examples/extensions/api-demo.ts

@@ -29,7 +29,7 @@ export default function (pi: ExtensionAPI) {
 			pi.logger[logLevel]("API demo tool executed", { message, logLevel });
 
 			// Access pi module utilities
-			const { logger: piLogger } = pi.pi;
+			const { logger: piLogger } = pi.prometheus;
 			piLogger.debug("Accessed pi module from extension", { sessionFile: ctx.sessionManager.getSessionFile() });
 
 			// Get session information
@@ -49,7 +49,7 @@ export default function (pi: ExtensionAPI) {
 							`Features demonstrated:`,
 							`1. ✓ Logger access via pi.logger`,
 							`2. ✓ Zod access via pi.zod`,
-							`3. ✓ Package exports via pi.pi`,
+							`3. ✓ Package exports via pi.prometheus`,
 							``,
 							`Context:`,
 							`- ${sessionInfo}`,

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@prometheus-ai/agent",
-	"version": "0.5.3",
+	"version": "0.5.8",
 	"description": "Prometheus coding agent CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://prometheus.trivlab.com",
 	"author": "Uttam Trivedi",
@@ -25,7 +25,7 @@
 	"main": "./src/index.ts",
 	"types": "./dist/types/index.d.ts",
 	"bin": {
-		"prometheus": "src/cli.ts"
+		"prometheus": "dist/cli.js"
 	},
 	"scripts": {
 		"build": "bun scripts/build-binary.ts",
@@ -37,21 +37,24 @@
 		"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",
-		"generate-template": "bun scripts/generate-template.ts"
+		"prepack": "bun scripts/generate-docs-index.ts && bun --cwd=../collab-web run build:tool-views && bun scripts/bundle-dist.ts",
+		"bench:guard": "bun scripts/bench-guard.ts"
 	},
 	"dependencies": {
-		"@agentclientprotocol/sdk": "0.22.1",
+		"@agentclientprotocol/sdk": "0.25.0",
 		"@babel/parser": "^7.29.7",
 		"@mozilla/readability": "^0.6.0",
-		"@prometheus-ai/hashline": "0.5.3",
-		"@prometheus-ai/stats": "0.5.3",
-		"@prometheus-ai/agent-core": "0.5.3",
-		"@prometheus-ai/ai": "0.5.3",
-		"@prometheus-ai/memory": "0.5.3",
-		"@prometheus-ai/natives": "0.5.3",
-		"@prometheus-ai/tui": "0.5.3",
-		"@prometheus-ai/utils": "0.5.3",
+		"@prometheus-ai/hashline": "0.5.8",
+		"@prometheus-ai/stats": "0.5.8",
+		"@prometheus-ai/agent-core": "0.5.8",
+		"@prometheus-ai/ai": "0.5.8",
+		"@prometheus-ai/catalog": "0.5.8",
+		"@prometheus-ai/memory": "0.5.8",
+		"@prometheus-ai/natives": "0.5.8",
+		"@prometheus-ai/tui": "0.5.8",
+		"@prometheus-ai/utils": "0.5.8",
+		"@prometheus-ai/wire": "0.5.8",
+		"@prometheus-ai/snapcompact": "0.5.8",
 		"@opentelemetry/api": "^1.9.1",
 		"@opentelemetry/context-async-hooks": "^2.7.1",
 		"@opentelemetry/exporter-trace-otlp-proto": "^0.218.0",
@@ -71,10 +74,11 @@
 		"puppeteer-core": "^25.1.0",
 		"turndown": "7.2.4",
 		"turndown-plugin-gfm": "1.0.2",
-		"zod": "4.4.3"
+		"zod": "^4"
 	},
 	"optionalDependencies": {
-		"@huggingface/transformers": "^4.2.0"
+		"@huggingface/transformers": "^4.2.0",
+		"sherpa-onnx-node": "1.13.2"
 	},
 	"devDependencies": {
 		"@types/bun": "^1.3.14"
@@ -84,6 +88,8 @@
 	},
 	"files": [
 		"src",
+		"dist/cli.js",
+		"dist/*.node",
 		"scripts",
 		"examples",
 		"README.md",
@@ -131,6 +137,14 @@
 			"types": "./dist/types/cli/*.d.ts",
 			"import": "./src/cli/*.ts"
 		},
+		"./cli/gallery-fixtures": {
+			"types": "./dist/types/cli/gallery-fixtures/index.d.ts",
+			"import": "./src/cli/gallery-fixtures/index.ts"
+		},
+		"./cli/gallery-fixtures/*": {
+			"types": "./dist/types/cli/gallery-fixtures/*.d.ts",
+			"import": "./src/cli/gallery-fixtures/*.ts"
+		},
 		"./cli/commands/*": {
 			"types": "./dist/types/cli/commands/*.d.ts",
 			"import": "./src/cli/commands/*.ts"
@@ -403,6 +417,14 @@
 			"types": "./dist/types/modes/*.d.ts",
 			"import": "./src/modes/*.ts"
 		},
+		"./modes/setup-wizard": {
+			"types": "./dist/types/modes/setup-wizard/index.d.ts",
+			"import": "./src/modes/setup-wizard/index.ts"
+		},
+		"./modes/setup-wizard/*": {
+			"types": "./dist/types/modes/setup-wizard/*.d.ts",
+			"import": "./src/modes/setup-wizard/*.ts"
+		},
 		"./modes/acp": {
 			"types": "./dist/types/modes/acp/index.d.ts",
 			"import": "./src/modes/acp/index.ts"
@@ -504,6 +526,10 @@
 			"types": "./dist/types/tools/*.d.ts",
 			"import": "./src/tools/*.ts"
 		},
+		"./tool-discovery/*": {
+			"types": "./dist/types/tool-discovery/*.d.ts",
+			"import": "./src/tool-discovery/*.ts"
+		},
 		"./tui": {
 			"types": "./dist/types/tui/index.d.ts",
 			"import": "./src/tui/index.ts"

package/scripts/bench-guard.ts

@@ -0,0 +1,71 @@
+#!/usr/bin/env bun
+/**
+ * Boot-time regression guard (Phase A1 of the boot/TUI perf work).
+ *
+ * Re-runs the `PROMETHEUS_TIMING=x` cold-boot benchmark under hyperfine and fails when
+ * the median regresses past `baseline * THRESHOLD`. `PROMETHEUS_TIMING=x` runs the full
+ * pre-paint chain in `runRootCommand` and then `process.exit(0)`, so the
+ * never-exiting interactive launch becomes a terminating, benchmarkable boot.
+ *
+ * Boot wall-clock is MACHINE-RELATIVE: a baseline captured on one machine is
+ * meaningless on another (and on CI). This is a LOCAL guard — regenerate the
+ * baseline on the machine you measure on, then compare on that same machine.
+ * It is intentionally NOT wired into CI for that reason.
+ *
+ *   bun scripts/bench-guard.ts --update   # capture/refresh the baseline
+ *   bun scripts/bench-guard.ts            # measure + compare; exit 1 on regression
+ *
+ * Requires `hyperfine` on PATH.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+
+const THRESHOLD = 1.05; // 5% regression budget
+const BASELINE_PATH = path.join(import.meta.dir, "..", "bench", "boot-baseline.json");
+const BENCH_COMMAND = "PROMETHEUS_TIMING=x bun src/cli.ts";
+const cwd = path.join(import.meta.dir, "..");
+
+function medianOf(hyperfineJson: string): number {
+	const parsed = JSON.parse(hyperfineJson) as { results: Array<{ mean: number; median?: number }> };
+	const result = parsed.results[0];
+	if (!result) throw new Error("hyperfine produced no result");
+	return result.median ?? result.mean;
+}
+
+async function measure(): Promise<{ seconds: number; raw: string }> {
+	const tmp = path.join(import.meta.dir, "..", "bench", `.boot-run-${Date.now()}.json`);
+	const proc = Bun.spawn(["hyperfine", "--warmup", "3", "--min-runs", "10", "--export-json", tmp, BENCH_COMMAND], {
+		cwd,
+		stdout: "inherit",
+		stderr: "inherit",
+	});
+	const code = await proc.exited;
+	if (code !== 0) throw new Error(`hyperfine exited ${code}`);
+	const raw = await Bun.file(tmp).text();
+	fs.rmSync(tmp, { force: true });
+	return { seconds: medianOf(raw), raw };
+}
+
+const update = process.argv.includes("--update");
+const { seconds, raw } = await measure();
+
+if (update) {
+	fs.mkdirSync(path.dirname(BASELINE_PATH), { recursive: true });
+	await Bun.write(BASELINE_PATH, raw);
+	console.log(`Baseline updated: ${(seconds * 1000).toFixed(0)}ms median -> ${BASELINE_PATH}`);
+	process.exit(0);
+}
+
+if (!fs.existsSync(BASELINE_PATH)) {
+	console.error("No baseline found. Run `bun scripts/bench-guard.ts --update` on this machine first.");
+	process.exit(2);
+}
+
+const baseline = medianOf(await Bun.file(BASELINE_PATH).text());
+const ratio = seconds / baseline;
+const verdict = ratio > THRESHOLD ? "REGRESSION" : "ok";
+console.log(
+	`boot median: ${(seconds * 1000).toFixed(0)}ms vs baseline ${(baseline * 1000).toFixed(0)}ms ` +
+		`(${((ratio - 1) * 100).toFixed(1)}%, budget ${((THRESHOLD - 1) * 100).toFixed(0)}%) -> ${verdict}`,
+);
+process.exit(ratio > THRESHOLD ? 1 : 0);

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", "prometheus");
 
 // 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",
@@ -54,40 +59,34 @@ async function main(): Promise<void> {
 					`process.env.PROMETHEUS_TINY_TRANSFORMERS_VERSION=${JSON.stringify(transformersVersion)}`,
 					"--external",
 					"mupdf",
+					"--external",
+					"fastembed",
+					"--external",
+					"onnxruntime-node",
 					"--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
+					// `legacy-package-compat.ts`. These are reached via computed bunfs paths
 					// (which `--compile`'s static analyzer cannot trace), so each must be
 					// listed here to land in bunfs at
 					// `/$bunfs/root/packages/<pkg>/<entry>.js`. The coding-agent's own
 					// `./src/index.ts` is intentionally NOT listed: bun --compile silently
 					// 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",
+					// resolve through `legacy-package-agent-shim.ts` instead.
+					"./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-package-ai-shim.ts",
+					"./packages/coding-agent/src/extensibility/legacy-package-agent-shim.ts",
 					"--outfile",
-					"dist/prometheus",
+					"packages/coding-agent/dist/prometheus",
 				],
 				buildEnv,
+				repoRoot,
 			);
 
 			// Bun 1.3.12 emits a truncated Mach-O signature on darwin builds.

package/scripts/bundle-dist.ts

@@ -0,0 +1,97 @@
+#!/usr/bin/env bun
+
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+
+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";
+
+function isEnoent(err: unknown): boolean {
+	return typeof err === "object" && err !== null && "code" in err && err.code === "ENOENT";
+}
+
+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/prometheus); 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();
+	// The npm bundle ships no stats dashboard sources or prebuilt dist/client,
+	// so embed the dashboard archive the same way compiled binaries do
+	// (scripts/build-binary.ts). Reset afterwards to keep the checked-in
+	// placeholder empty.
+	await runCommand(["bun", "--cwd=../stats", "scripts/generate-client-bundle.ts", "--generate"]);
+	try {
+		await runCommand([
+			"bun",
+			"build",
+			"--target=bun",
+			"--outdir",
+			"dist",
+			"--minify-whitespace",
+			"--minify-syntax",
+			"--keep-names",
+			"--external",
+			"mupdf",
+			"--external",
+			"@prometheus-ai/natives",
+			"--external",
+			"@huggingface/transformers",
+			"--external",
+			"fastembed",
+			"--external",
+			"onnxruntime-node",
+			"--define",
+			'process.env.PROMETHEUS_BUNDLED="true"',
+			"./src/cli.ts",
+		]);
+	} finally {
+		await runCommand(["bun", "--cwd=../stats", "scripts/generate-client-bundle.ts", "--reset"]);
+	}
+	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/generate-share-viewer.ts

@@ -0,0 +1,34 @@
+#!/usr/bin/env bun
+/**
+ * Build the standalone Prometheus share-viewer page served at `GET /s/<id>`.
+ *
+ * Same template as HTML exports, but with no embedded session: share-loader.js
+ * (injected right after the empty #session-data tag) fetches the sealed blob
+ * (gist or relay store), decrypts it with the `#<key>` fragment in-browser, and
+ * hands the JSON to template.js via the legacy `window.__PROMETHEUS_SESSION_DATA__` global.
+ *
+ * The relay repo's build script runs this and embeds the output via go:embed.
+ */
+import * as path from "node:path";
+import { generateThemeVars, getTemplate } from "../src/export/html";
+
+const outPath = process.argv[2];
+if (!outPath) {
+	console.error("usage: bun scripts/generate-share-viewer.ts <output.html>");
+	process.exit(2);
+}
+
+const loaderJs = await Bun.file(new URL("../src/export/html/share-loader.js", import.meta.url).pathname).text();
+// Pin a built-in theme: the viewer is a public artifact, not a per-user export.
+const themeVars = await generateThemeVars("dark");
+
+const html = getTemplate()
+	.replace("<theme-vars/>", () => `<style>:root { ${themeVars} }</style>`)
+	.replace("<title>Session Export</title>", () => "<title>Prometheus session</title>")
+	.replace("{{SESSION_DATA}}</script>", () => `</script>\n  <script>${loaderJs}</script>`);
+
+if (html.includes("{{SESSION_DATA}}")) throw new Error("session-data placeholder survived substitution");
+if (!html.includes("__PROMETHEUS_SESSION_DATA__")) throw new Error("share loader not injected");
+
+await Bun.write(outPath, html);
+console.log(`Generated ${path.resolve(outPath)} (${(html.length / 1024).toFixed(0)} KB)`);

package/scripts/prometheus

@@ -0,0 +1,42 @@
+#!/bin/sh
+# Dev launcher for the Prometheus CLI, installed by `bun run install:dev`.
+#
+# Problem it solves: Bun reads `bunfig.toml` from the *current working
+# directory* at startup and evaluates its `preload` entries before running the
+# script. A bun-shebang bin (what `bun link` creates for `src/cli.ts`)
+# therefore inherits whatever `preload` the directory you happen to be in
+# declares. Running `prometheus` inside an unrelated Bun project can execute — and
+# crash on — that project's preload, e.g.
+#   error: Cannot find module '@v12sh/utils/frontmatter' from '.../loader.ts'
+#
+# Bun only reads the *exact* cwd (it does not walk parents) and ignores
+# `--config`/`BUN_BE_BUN` for this, so the fix is to launch Bun from an empty,
+# bunfig-free directory and restore the real cwd inside the process via the
+# preload shim alongside this file.
+set -e
+
+# Resolve this script's real location even when invoked through a symlink
+# (`$HOME/.bun/bin/prometheus` -> this file).
+self=$0
+while [ -L "$self" ]; do
+	link=$(readlink "$self")
+	case $link in
+	/*) self=$link ;;
+	*) self=$(dirname "$self")/$link ;;
+	esac
+done
+scripts_dir=$(CDPATH= cd -- "$(dirname -- "$self")" && pwd -P)
+cli=$scripts_dir/../src/cli.ts
+preload=$scripts_dir/prometheus.ts
+timing_preload=$scripts_dir/../../utils/src/module-timer.ts
+
+launch_dir=${PROMETHEUS_DEV_LAUNCH_DIR:-${HOME}/.prometheus/.dev-cwd}
+mkdir -p "$launch_dir"
+
+PROMETHEUS_LAUNCH_CWD=$PWD
+export PROMETHEUS_LAUNCH_CWD
+cd "$launch_dir"
+if [ -n "${PROMETHEUS_TIMING:-${PROMETHEUS_TIMING:-}}" ]; then
+	exec bun --preload "$preload" --preload "$timing_preload" "$cli" "$@"
+fi
+exec bun --preload "$preload" "$cli" "$@"

package/scripts/prometheus.ts

@@ -0,0 +1,20 @@
+/**
+ * Bun `--preload` shim for the Prometheus dev launcher (`scripts/prometheus`).
+ *
+ * The launcher starts Bun from an empty, bunfig-free directory so a foreign
+ * project's `bunfig.toml` `preload` cannot run inside the Prometheus CLI: Bun reads
+ * `bunfig.toml` from the *current working directory* on startup and evaluates
+ * its `preload` entries before the entrypoint, so a bun-shebang bin inherits
+ * whatever `preload` the directory you launched from declares (and crashes if
+ * that preload can't resolve). This shim is loaded before the entrypoint's
+ * imports run, so it restores the user's real working directory in time for
+ * import-time snapshots (for example `getProjectDir()` in `@prometheus-ai/utils/dirs`).
+ */
+const launchCwd = process.env.PROMETHEUS_LAUNCH_CWD ?? process.env.PROMETHEUS_LAUNCH_CWD;
+if (launchCwd) {
+	delete process.env.PROMETHEUS_LAUNCH_CWD;
+	delete process.env.PROMETHEUS_LAUNCH_CWD;
+	try {
+		process.chdir(launchCwd);
+	} catch {}
+}

package/src/async/index.ts

@@ -1,2 +1 @@
 export * from "./job-manager";
-export * from "./support";