@aexol/spectral 0.7.8 → 0.8.2

package/dist/relay/auto-research.js

@@ -1,6 +1,6 @@
 /**
  * Auto-research handler — sends an auto-research task through the existing
- * PiBridge (backend proxy) instead of spawning a separate pi process.
+ * AgentBridge (backend proxy) instead of spawning a separate pi process.
  *
  * This ensures auto-research uses the same model and API keys as the active
  * session — no separate subprocess, no missing API key errors.
@@ -47,12 +47,12 @@ function makeRelaySubscriber(sessionId, relay) {
     };
 }
 /**
- * Scan the project's .pi/extensions/auto-research/ directory for generated
+ * Scan the project's .spectral/extensions/auto-research/ directory for generated
  * extension directories. Each subdirectory with .ts files counts as one
  * extension.
  */
 function scanGeneratedExtensions(projectPath) {
-    const arDir = path.join(projectPath, ".pi", "extensions", "auto-research");
+    const arDir = path.join(projectPath, ".spectral", "extensions", "auto-research");
     const extensions = [];
     try {
         if (!fs.existsSync(arDir))
@@ -105,7 +105,7 @@ function scanGeneratedExtensions(projectPath) {
             }
             extensions.push({
                 name: entry.name,
-                path: `.pi/extensions/auto-research/${entry.name}`,
+                path: `.spectral/extensions/auto-research/${entry.name}`,
                 description,
                 usesLLM,
                 fileCount,
@@ -137,7 +137,7 @@ function hasAgentsMdUpdate(projectPath) {
  */
 function readManifest(projectPath) {
     try {
-        const mPath = path.join(projectPath, ".pi", "extensions", "auto-research", "manifest.json");
+        const mPath = path.join(projectPath, ".spectral", "extensions", "auto-research", "manifest.json");
         if (!fs.existsSync(mPath))
             return null;
         const raw = fs.readFileSync(mPath, "utf-8");
@@ -164,7 +164,7 @@ function gatherPreRunContext(projectPath) {
     const isIncremental = manifest !== null;
     const existingExtensions = [];
     try {
-        const arDir = path.join(projectPath, ".pi", "extensions", "auto-research");
+        const arDir = path.join(projectPath, ".spectral", "extensions", "auto-research");
         if (fs.existsSync(arDir)) {
             for (const entry of fs.readdirSync(arDir, { withFileTypes: true })) {
                 if (entry.isDirectory() && entry.name !== "node_modules") {
@@ -209,7 +209,7 @@ function buildIncrementalSection(ctx) {
     if (ctx.existingExtensions.length > 0) {
         lines.push("### Existing extensions to review:");
         for (const name of ctx.existingExtensions) {
-            lines.push(`  - \`.pi/extensions/auto-research/${name}/\``);
+            lines.push(`  - \`.spectral/extensions/auto-research/${name}/\``);
         }
         lines.push("");
     }
@@ -224,7 +224,7 @@ function buildIncrementalSection(ctx) {
     lines.push("   was removed from the project, delete the extension directory entirely.", "");
     lines.push("4. **Update AGENTS.md** — The AUTO-RESEARCH section should reflect the CURRENT");
     lines.push("   set of extensions (remove stale entries, add new ones).", "");
-    lines.push("5. **Save manifest.json** — Write/update .pi/extensions/auto-research/manifest.json");
+    lines.push("5. **Save manifest.json** — Write/update .spectral/extensions/auto-research/manifest.json");
     lines.push(`   with: lastRun (ISO), lastCommit (git HEAD), runCount (${ctx.manifest ? ctx.manifest.runCount + 1 : 1}),`);
     lines.push("   and extensions array with name/path/category for each generated extension.", "");
     return lines.join("\n");
@@ -234,7 +234,7 @@ function buildIncrementalSection(ctx) {
  */
 function writeManifest(projectPath, extensions) {
     try {
-        const arDir = path.join(projectPath, ".pi", "extensions", "auto-research");
+        const arDir = path.join(projectPath, ".spectral", "extensions", "auto-research");
         if (!fs.existsSync(arDir))
             fs.mkdirSync(arDir, { recursive: true });
         let currentCommit = "unknown";
@@ -257,7 +257,7 @@ function writeManifest(projectPath, extensions) {
 }
 /**
  * Build the auto-research task prompt. This is sent as a user message
- * through the existing PiBridge, so the agent uses the session's model
+ * through the existing AgentBridge, so the agent uses the session's model
  * and backend proxy.
  *
  * @param projectPath Absolute path to the project root
@@ -297,8 +297,8 @@ function buildAutoResearchTask(projectPath, projectName, preRunContext = null) {
         "}",
         "```",
         "",
-        "Extensions live in: `.pi/extensions/` (project-local) or `~/.pi/agent/extensions/` (user-global).",
-        "Auto-research generates extensions into `.pi/extensions/auto-research/<name>/`.",
+        "Extensions live in: `.spectral/extensions/` (project-local) or `~/.spectral/agent/extensions/` (user-global).",
+        "Auto-research generates extensions into `.spectral/extensions/auto-research/<name>/`.",
         "",
         "### Tools (pi.registerTool)",
         "",
@@ -400,10 +400,10 @@ function buildAutoResearchTask(projectPath, projectName, preRunContext = null) {
         "",
         "### Extension File Structure",
         "",
-        "Each extension is a directory under `.pi/extensions/auto-research/`:",
+        "Each extension is a directory under `.spectral/extensions/auto-research/`:",
         "",
         "```",
-        ".pi/extensions/auto-research/",
+        ".spectral/extensions/auto-research/",
         "  <extension-name>/",
         "    index.ts          # Entry point — default export activate(pi)",
         "    utils.ts          # [optional] Helper functions",
@@ -440,7 +440,7 @@ function buildAutoResearchTask(projectPath, projectName, preRunContext = null) {
         "",
         "1. **Context Collection** — Explore the project structure:",
         "   - Read package.json, tsconfig.json, deno.json (if present)",
-        "   - Check existing extensions under .pi/extensions/",
+        "   - Check existing extensions under .spectral/extensions/",
         "   - Review key source files to understand architecture",
         "   - Check git log for recent changes and patterns",
         "",
@@ -454,9 +454,9 @@ function buildAutoResearchTask(projectPath, projectName, preRunContext = null) {
         "   - Use `pi.registerTool()` for simple tools with TypeBox validation",
         "   - Use `pi.registerCommand()` for custom slash commands",
         "   - For LLM-powered extensions, use `ctx.modelRegistry` to call models",
-        "   - Create files under `.pi/extensions/auto-research/<name>/`",
+        "   - Create files under `.spectral/extensions/auto-research/<name>/`",
         "   - Each extension needs an `index.ts` that registers its tools/commands",
-        "   - Read `.pi/agents/auto-research-templates.md` for proven extension templates",
+        "   - Read `.spectral/agents/auto-research-templates.md` for proven extension templates",
         "",
         "4. **Validation** — Verify generated extensions:",
         "   - Ensure all imports resolve to available packages (see reference above)",
@@ -478,7 +478,7 @@ function buildAutoResearchTask(projectPath, projectName, preRunContext = null) {
         "",
         "### Important Rules",
         "",
-        "- Write each extension as TypeScript files under `.pi/extensions/auto-research/<name>/`",
+        "- Write each extension as TypeScript files under `.spectral/extensions/auto-research/<name>/`",
         "- Every extension directory MUST have an `index.ts` entry point",
         "- Use proper TypeScript with type annotations and error handling",
         "- Extensions must handle errors gracefully (never crash the agent)",
@@ -491,7 +491,7 @@ function buildAutoResearchTask(projectPath, projectName, preRunContext = null) {
         "agent sessions automatically know about the new capabilities.",
         "",
         "**How AGENTS.md works:**",
-        "- Pi loads AGENTS.md at startup from the project root and parent directories",
+        "- Spectral loads AGENTS.md at startup from the project root and parent directories",
         "- All found AGENTS.md files are concatenated and injected into the system prompt",
         "- This means documented extensions get discovered by the agent automatically",
         "",
@@ -502,7 +502,7 @@ function buildAutoResearchTask(projectPath, projectName, preRunContext = null) {
         "## Auto-Generated Extensions",
         "",
         "These extensions were generated by auto-research. They are available",
-        "in every session. Pi loads them automatically from `.pi/extensions/`.",
+        "in every session. Spectral loads them automatically from `.spectral/extensions/`.",
         "",
         "### `<extension-name>`",
         "",
@@ -532,6 +532,40 @@ function buildAutoResearchTask(projectPath, projectName, preRunContext = null) {
         "",
         "Start by collecting project context, then generate the most impactful extensions",
         "and update AGENTS.md when done.",
+        "",
+        "### 6. Persist Key Discoveries as Durable Observations",
+        "",
+        "As you analyze the project, you will discover conventions, rules, and patterns",
+        "that future agent sessions should know. Write these as durable cross-session",
+        "observations using the `write_project_observation` tool:",
+        "",
+        "```",
+        "write_project_observation({",
+        "  content: \"backend/src/models.ts is auto-generated by Axolotl — never edit by hand\",",
+        "  relevance: \"critical\"",
+        "})",
+        "```",
+        "",
+        "**What to capture:**",
+        "",
+        "- **NEVER-EDIT markers** (relevance: critical): Auto-generated files that must",
+        "  be regenerated instead of edited. Seen a comment like 'DO NOT EDIT'? Persist it.",
+        "- **Import/macro conventions** (relevance: high): Rules like \"all Deno imports",
+        "  MUST use .ts extension\" or \"use workspace imports, not relative paths\".",
+        "- **Code-generation commands** (relevance: high): The exact shell commands to",
+        "  regenerate generated files (e.g. 'cd backend && deno task axolotl:build').",
+        "- **Directory roles** (relevance: medium): What each top-level directory contains",
+        "  (e.g. 'packages/parser/ is zero-dependency — never add imports here').",
+        "- **Runtime boundaries** (relevance: medium): Which packages use Deno vs Node.",
+        "- **Database/API patterns** (relevance: medium): How the backend is structured.",
+        "",
+        "**Guidelines:**",
+        "",
+        "- Write 5–10 observations covering the most important discoveries.",
+        "- Each observation is a single self-contained sentence — no markdown, no lists.",
+        "- Focus on facts that would PREVENT MISTAKES or SAVE TIME in future sessions.",
+        "- Deduplication is automatic by content hash — writing the same fact twice is harmless.",
+        "- Future sessions retrieve these via `read_project_observations(\"query\")`.",
     ].join("\n");
 }
 // ---------------------------------------------------------------------------
@@ -539,7 +573,7 @@ function buildAutoResearchTask(projectPath, projectName, preRunContext = null) {
 // ---------------------------------------------------------------------------
 const AR_TIMEOUT_MS = 10 * 60 * 1000; // 10 minutes — generous for LLM-based analysis
 /**
- * Execute auto-research for a project through the existing PiBridge.
+ * Execute auto-research for a project through the existing AgentBridge.
  *
  * Caller (dispatcher) is fire-and-forget — this function is `void` and
  * all errors are surfaced as `auto_research_error` events on the wire
@@ -547,7 +581,7 @@ const AR_TIMEOUT_MS = 10 * 60 * 1000; // 10 minutes — generous for LLM-based a
  *
  * This replaces the old subprocess-spawning approach. Instead of launching
  * a separate pi process (which lacks backend proxy credentials), we send
- * the auto-research task through the session's existing PiBridge. The agent
+ * the auto-research task through the session's existing AgentBridge. The agent
  * uses the session's model, backend proxy, and all available tools.
  */
 export function handleAutoResearch(input, deps) {
@@ -700,7 +734,7 @@ export function handleAutoResearch(input, deps) {
     // then timeout fires and calls finalize() again — but finalize() is
     // gated by watcherFired, so it's a no-op. The only issue is we don't
     // clearTimeout on watcher fire — but that's fine, the timer is harmless.
-    // --- Send the prompt through the existing PiBridge (backend proxy) ---
+    // --- Send the prompt through the existing AgentBridge (backend proxy) ---
     manager.prompt(sessionId, taskContent, storedModelId).catch((err) => {
         if (watcherFired)
             return; // already handled by watcher

package/dist/relay/dispatcher.js

@@ -41,7 +41,7 @@
 import { BadRequestError, NotFoundError } from "../server/handlers/errors.js";
 import { handlePathAutocomplete } from "../server/handlers/paths-autocomplete.js";
 import { handleBindStudioProject, handleCreateProject, handleDeleteProject, handleListProjects, handleListSessionsByProject, handleUpdateProject, } from "../server/handlers/projects.js";
-import { handleCompactSession, handleCreateSession, handleDeleteSession, handleForkSession, handleGetSessionDetail, handleGetSessionMemoryDetails, handleGetSessionMemoryStatus, handleUpdateSession, } from "../server/handlers/sessions.js";
+import { handleCompactSession, handleCreateSession, handleDeleteSession, handleForkSession, handleRememberAndDeleteSession, handleGetSessionDetail, handleGetSessionMemoryDetails, handleGetSessionMemoryStatus, handleUpdateSession, } from "../server/handlers/sessions.js";
 import { handleClearPromptQueue, handleEnqueuePrompt, handleGetPromptQueue, handleRemovePrompt, } from "../server/handlers/queue.js";
 import { shutdownState } from "../server/shutdown.js";
 import { handleAutoResearch } from "./auto-research.js";
@@ -126,6 +126,14 @@ export function matchRoute(method, path) {
             return { route: "compact_session", id };
         return null;
     }
+    // /api/sessions/:id/remember-and-delete
+    const rememberDeleteMatch = /^\/api\/sessions\/([^/]+)\/remember-and-delete$/.exec(cleanPath);
+    if (rememberDeleteMatch) {
+        const id = decodeURIComponent(rememberDeleteMatch[1]);
+        if (method === "POST")
+            return { route: "remember_and_delete_session", id };
+        return null;
+    }
     // /api/sessions/:id/fork
     const forkMatch = /^\/api\/sessions\/([^/]+)\/fork$/.exec(cleanPath);
     if (forkMatch) {
@@ -341,6 +349,24 @@ async function dispatchRoute(match, body, deps) {
         }
         case "compact_session":
             return await handleCompactSession(store, manager, id);
+        case "remember_and_delete_session": {
+            // Compact first — the compaction hook's persistProjectObservations
+            // runs inside compactSession, writing reflections to cross-session
+            // durable memory. On failure (e.g. no API key), we let the error
+            // propagate so the session is NOT deleted.
+            await handleRememberAndDeleteSession(store, manager, id);
+            const detail = store.getSession(id);
+            manager.disposeSessionStream(id);
+            handleDeleteSession(store, id);
+            if (detail) {
+                safePublish(publishMetaEvent, logger, {
+                    type: "session_deleted",
+                    projectId: detail.projectId,
+                    sessionId: id,
+                });
+            }
+            return { ok: true };
+        }
         case "fork_session": {
             const session = handleForkSession(store, id, asObject(body));
             safePublish(publishMetaEvent, logger, {
@@ -682,7 +708,7 @@ export function detachAllSubscribers(manager, subscribers) {
 }
 /**
  * Dispatch an `auto_research` frame. Sends the auto-research task through
- * the existing PiBridge (backend proxy) instead of spawning a separate pi
+ * the existing AgentBridge (backend proxy) instead of spawning a separate pi
  * subprocess. This ensures auto-research uses the same model and API keys
  * as the active session.
  *

package/dist/relay/models-fetch.js

@@ -1,7 +1,7 @@
 /**
  * Fetch the admin-managed list of allowed base models from the backend.
  *
- * Used by `PiBridge` at startup to register synthetic providers
+ * Used by `AgentBridge` at startup to register synthetic providers
  * (`spectral-proxy-anthropic` / `spectral-proxy-openai`) that route every
  * inference call through the backend's `/v1/messages` and
  * `/v1/chat/completions` endpoints. The backend authenticates the call
@@ -32,7 +32,7 @@ const QUERY = `query AvailableBaseModels { availableBaseModels { name provider u
 /**
  * Fetch the whitelist of allowed base models. Throws on any failure with a
  * message tailored for an operator running `spectral serve` — the caller
- * (PiBridge.start) lets the throw propagate so the WS subscriber sees a
+ * (AgentBridge.start) lets the throw propagate so the WS subscriber sees a
  * clear error event instead of a silent fall-through to "no models".
  */
 export async function fetchAllowedModels(opts) {

package/dist/{pi → sdk}/ai/env-api-keys.js

@@ -6,8 +6,8 @@ const dynamicImport = (specifier) => import(specifier);
 const NODE_FS_SPECIFIER = "node:" + "fs";
 const NODE_OS_SPECIFIER = "node:" + "os";
 const NODE_PATH_SPECIFIER = "node:" + "path";
-// Eagerly load in Node.js/Bun environment only
-if (typeof process !== "undefined" && (process.versions?.node || process.versions?.bun)) {
+// Eagerly load in Node.js environment only
+if (typeof process !== "undefined" && process.versions?.node) {
     dynamicImport(NODE_FS_SPECIFIER).then((m) => {
         _existsSync = m.existsSync;
     });
@@ -18,38 +18,6 @@ if (typeof process !== "undefined" && (process.versions?.node || process.version
         _join = m.join;
     });
 }
-let _procEnvCache = null;
-/**
- * Fallback for https://github.com/oven-sh/bun/issues/27802
- * Bun compiled binaries have an empty `process.env` inside sandbox
- * environments on Linux. We can recover the env from `/proc/self/environ`.
- */
-function getProcEnv(key) {
-    if (!process.versions?.bun)
-        return undefined;
-    if (typeof process === "undefined")
-        return undefined;
-    // If process.env already has entries, the bug is not triggered.
-    if (Object.keys(process.env).length > 0)
-        return undefined;
-    if (_procEnvCache === null) {
-        _procEnvCache = new Map();
-        try {
-            const { readFileSync } = require("node:fs");
-            const data = readFileSync("/proc/self/environ", "utf-8");
-            for (const entry of data.split("\0")) {
-                const idx = entry.indexOf("=");
-                if (idx > 0) {
-                    _procEnvCache.set(entry.slice(0, idx), entry.slice(idx + 1));
-                }
-            }
-        }
-        catch {
-            // /proc/self/environ may not be readable.
-        }
-    }
-    return _procEnvCache.get(key);
-}
 let cachedVertexAdcCredentialsExists = null;
 function hasVertexAdcCredentials() {
     if (cachedVertexAdcCredentialsExists === null) {
@@ -57,7 +25,7 @@ function hasVertexAdcCredentials() {
         // return false WITHOUT caching so the next call retries once they're ready.
         // Only cache false permanently in a browser environment where fs is never available.
         if (!_existsSync || !_homedir || !_join) {
-            const isNode = typeof process !== "undefined" && (process.versions?.node || process.versions?.bun);
+            const isNode = typeof process !== "undefined" && process.versions?.node;
             if (!isNode) {
                 // Definitively in a browser — safe to cache false permanently
                 cachedVertexAdcCredentialsExists = false;
@@ -65,7 +33,7 @@ function hasVertexAdcCredentials() {
             return false;
         }
         // Check GOOGLE_APPLICATION_CREDENTIALS env var first (standard way)
-        const gacPath = process.env.GOOGLE_APPLICATION_CREDENTIALS || getProcEnv("GOOGLE_APPLICATION_CREDENTIALS");
+        const gacPath = process.env.GOOGLE_APPLICATION_CREDENTIALS;
         if (gacPath) {
             cachedVertexAdcCredentialsExists = _existsSync(gacPath);
         }
@@ -121,23 +89,21 @@ export function findEnvKeys(provider) {
     const envVars = getApiKeyEnvVars(provider);
     if (!envVars)
         return undefined;
-    const found = envVars.filter((envVar) => !!process.env[envVar] || !!getProcEnv(envVar));
+    const found = envVars.filter((envVar) => !!process.env[envVar]);
     return found.length > 0 ? found : undefined;
 }
 export function getEnvApiKey(provider) {
     const envKeys = findEnvKeys(provider);
     if (envKeys?.[0]) {
-        return process.env[envKeys[0]] || getProcEnv(envKeys[0]);
+        return process.env[envKeys[0]];
     }
     // Vertex AI supports either an explicit API key or Application Default Credentials.
     // Auth is configured via `gcloud auth application-default login`.
     if (provider === "google-vertex") {
         const hasCredentials = hasVertexAdcCredentials();
         const hasProject = !!(process.env.GOOGLE_CLOUD_PROJECT ||
-            process.env.GCLOUD_PROJECT ||
-            getProcEnv("GOOGLE_CLOUD_PROJECT") ||
-            getProcEnv("GCLOUD_PROJECT"));
-        const hasLocation = !!(process.env.GOOGLE_CLOUD_LOCATION || getProcEnv("GOOGLE_CLOUD_LOCATION"));
+            process.env.GCLOUD_PROJECT);
+        const hasLocation = !!(process.env.GOOGLE_CLOUD_LOCATION);
         if (hasCredentials && hasProject && hasLocation) {
             return "<authenticated>";
         }
@@ -155,13 +121,7 @@ export function getEnvApiKey(provider) {
             process.env.AWS_BEARER_TOKEN_BEDROCK ||
             process.env.AWS_CONTAINER_CREDENTIALS_RELATIVE_URI ||
             process.env.AWS_CONTAINER_CREDENTIALS_FULL_URI ||
-            process.env.AWS_WEB_IDENTITY_TOKEN_FILE ||
-            getProcEnv("AWS_PROFILE") ||
-            (getProcEnv("AWS_ACCESS_KEY_ID") && getProcEnv("AWS_SECRET_ACCESS_KEY")) ||
-            getProcEnv("AWS_BEARER_TOKEN_BEDROCK") ||
-            getProcEnv("AWS_CONTAINER_CREDENTIALS_RELATIVE_URI") ||
-            getProcEnv("AWS_CONTAINER_CREDENTIALS_FULL_URI") ||
-            getProcEnv("AWS_WEB_IDENTITY_TOKEN_FILE")) {
+            process.env.AWS_WEB_IDENTITY_TOKEN_FILE) {
             return "<authenticated>";
         }
     }

package/dist/{pi → sdk}/ai/utils/oauth/anthropic.js

@@ -21,7 +21,7 @@ async function getNodeApis() {
     if (nodeApis)
         return nodeApis;
     if (!nodeApisPromise) {
-        if (typeof process === "undefined" || (!process.versions?.node && !process.versions?.bun)) {
+        if (typeof process === "undefined" || !process.versions?.node) {
             throw new Error("Anthropic OAuth is only available in Node.js environments");
         }
         nodeApisPromise = import("node:http").then((httpModule) => ({

package/dist/{pi → sdk}/ai/utils/oauth/openai-codex.js

@@ -7,7 +7,7 @@
 // NEVER convert to top-level imports - breaks browser/Vite builds
 let _randomBytes = null;
 let _http = null;
-if (typeof process !== "undefined" && (process.versions?.node || process.versions?.bun)) {
+if (typeof process !== "undefined" && process.versions?.node) {
     import("node:crypto").then((m) => {
         _randomBytes = m.randomBytes;
     });

package/dist/{pi → sdk}/coding-agent/config.js

@@ -9,13 +9,6 @@ import { normalizePath } from "./utils/paths.js";
 // =============================================================================
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
-/**
- * Detect if we're running as a Bun compiled binary.
- * Bun binaries have import.meta.url containing "$bunfs", "~BUN", or "%7EBUN" (Bun's virtual filesystem path)
- */
-export const isBunBinary = import.meta.url.includes("$bunfs") || import.meta.url.includes("~BUN") || import.meta.url.includes("%7EBUN");
-/** Detect if Bun is the runtime (compiled binary or bun run) */
-export const isBunRuntime = !!process.versions.bun;
 function makeSelfUpdateCommand(installStep, uninstallStep) {
     if (!uninstallStep)
         return installStep;
@@ -33,9 +26,6 @@ function makeSelfUpdateCommandStep(command, args) {
     };
 }
 export function detectInstallMethod() {
-    if (isBunBinary) {
-        return "bun-binary";
-    }
     const resolvedPath = `${__dirname}\0${process.execPath || ""}`.toLowerCase().replace(/\\/g, "/");
     if (resolvedPath.includes("/pnpm/") || resolvedPath.includes("/.pnpm/")) {
         return "pnpm";
@@ -43,9 +33,6 @@ export function detectInstallMethod() {
     if (resolvedPath.includes("/yarn/") || resolvedPath.includes("/.yarn/")) {
         return "yarn";
     }
-    if (isBunRuntime || resolvedPath.includes("/install/global/node_modules/")) {
-        return "bun";
-    }
     if (resolvedPath.includes("/npm/") || resolvedPath.includes("/node_modules/")) {
         return "npm";
     }
@@ -74,8 +61,6 @@ function getInferredNpmInstall() {
 }
 function getSelfUpdateCommandForMethod(method, installedPackageName, updatePackageName = installedPackageName, npmCommand) {
     switch (method) {
-        case "bun-binary":
-            return undefined;
         case "pnpm":
             return makeSelfUpdateCommand(makeSelfUpdateCommandStep("pnpm", ["install", "-g", "--ignore-scripts", updatePackageName]), updatePackageName === installedPackageName
                 ? undefined
@@ -84,10 +69,6 @@ function getSelfUpdateCommandForMethod(method, installedPackageName, updatePacka
             return makeSelfUpdateCommand(makeSelfUpdateCommandStep("yarn", ["global", "add", "--ignore-scripts", updatePackageName]), updatePackageName === installedPackageName
                 ? undefined
                 : makeSelfUpdateCommandStep("yarn", ["global", "remove", installedPackageName]));
-        case "bun":
-            return makeSelfUpdateCommand(makeSelfUpdateCommandStep("bun", ["install", "-g", "--ignore-scripts", updatePackageName]), updatePackageName === installedPackageName
-                ? undefined
-                : makeSelfUpdateCommandStep("bun", ["uninstall", "-g", installedPackageName]));
         case "npm": {
             const [command = "npm", ...npmArgs] = npmCommand ?? [];
             const inferred = npmCommand?.length ? undefined : getInferredNpmInstall();
@@ -126,16 +107,6 @@ function getGlobalPackageRoots(method, _packageName, npmCommand) {
         case "npm": {
             const configured = !!npmCommand?.length;
             const [command = "npm", ...npmArgs] = npmCommand ?? [];
-            if (configured && command === "bun") {
-                const bunBin = readCommandOutput(command, [...npmArgs, "pm", "bin", "-g"], {
-                    requireSuccess: true,
-                });
-                const roots = [join(homedir(), ".bun", "install", "global", "node_modules")];
-                if (bunBin) {
-                    roots.push(join(dirname(bunBin), "install", "global", "node_modules"));
-                }
-                return roots;
-            }
             const root = readCommandOutput(command, [...npmArgs, "root", "-g"], {
                 requireSuccess: configured,
             });
@@ -150,15 +121,6 @@ function getGlobalPackageRoots(method, _packageName, npmCommand) {
             const dir = readCommandOutput("yarn", ["global", "dir"]);
             return dir ? [dir, join(dir, "node_modules")] : [];
         }
-        case "bun": {
-            const bunBin = readCommandOutput("bun", ["pm", "bin", "-g"]);
-            const roots = [join(homedir(), ".bun", "install", "global", "node_modules")];
-            if (bunBin) {
-                roots.push(join(dirname(bunBin), "install", "global", "node_modules"));
-            }
-            return roots;
-        }
-        case "bun-binary":
         case "unknown":
             return [];
     }
@@ -229,9 +191,6 @@ export function getSelfUpdateCommand(packageName, npmCommand, updatePackageName
 }
 export function getSelfUpdateUnavailableInstruction(packageName, npmCommand, updatePackageName = packageName) {
     const method = detectInstallMethod();
-    if (method === "bun-binary") {
-        return `Download from: https://github.com/earendil-works/pi-mono/releases/latest`;
-    }
     const command = getSelfUpdateCommandForMethod(method, packageName, updatePackageName, npmCommand);
     if (command) {
         if (isManagedByGlobalPackageManager(method, packageName, npmCommand) && !isSelfUpdatePathWritable()) {
@@ -254,7 +213,6 @@ export function getUpdateInstruction(packageName) {
 // =============================================================================
 /**
  * Get the base directory for resolving package assets (themes, package.json, README.md, CHANGELOG.md).
- * - For Bun binary: returns the directory containing the executable
  * - For Node.js (dist/): returns __dirname (the dist/ directory)
  * - For tsx (src/): returns parent directory (the package root)
  */
@@ -264,10 +222,6 @@ export function getPackageDir() {
     if (envDir) {
         return normalizePath(envDir);
     }
-    if (isBunBinary) {
-        // Bun binary: process.execPath points to the compiled executable
-        return dirname(process.execPath);
-    }
     // Node.js: walk up from __dirname until we find package.json
     let dir = __dirname;
     while (dir !== dirname(dir)) {
@@ -281,14 +235,10 @@ export function getPackageDir() {
 }
 /**
  * Get path to built-in themes directory (shipped with package)
- * - For Bun binary: theme/ next to executable
  * - For Node.js (dist/): dist/modes/interactive/theme/
  * - For tsx (src/): src/modes/interactive/theme/
  */
 export function getThemesDir() {
-    if (isBunBinary) {
-        return join(getPackageDir(), "theme");
-    }
     // Theme is in modes/interactive/theme/ relative to src/ or dist/
     const packageDir = getPackageDir();
     const srcOrDist = existsSync(join(packageDir, "src")) ? "src" : "dist";
@@ -296,7 +246,8 @@ export function getThemesDir() {
 }
 /**
  * Get path to HTML export template directory (shipped with package)
- * - For Bun binary: export-html/ next to executable
+ * - For Node.js (dist/): returns __dirname (the dist/ directory)
+ * - For tsx (src/): returns parent directory (the package root)
 /** Get path to package.json */
 export function getPackageJsonPath() {
     return join(getPackageDir(), "package.json");
@@ -317,47 +268,29 @@ export function getExamplesPath() {
 export function getChangelogPath() {
     return resolve(join(getPackageDir(), "CHANGELOG.md"));
 }
-/**
- * Get path to built-in interactive assets directory.
- * - For Bun binary: assets/ next to executable
- * - For Node.js (dist/): dist/modes/interactive/assets/
- * - For tsx (src/): src/modes/interactive/assets/
- */
-export function getInteractiveAssetsDir() {
-    if (isBunBinary) {
-        return join(getPackageDir(), "assets");
-    }
-    const packageDir = getPackageDir();
-    const srcOrDist = existsSync(join(packageDir, "src")) ? "src" : "dist";
-    return join(packageDir, srcOrDist, "modes", "interactive", "assets");
-}
-/** Get path to a bundled interactive asset */
-export function getBundledInteractiveAssetPath(name) {
-    return join(getInteractiveAssetsDir(), name);
-}
 const pkg = JSON.parse(readFileSync(getPackageJsonPath(), "utf-8"));
-const piConfigName = pkg.piConfig?.name;
+const spectralConfigName = pkg.spectralConfig?.name;
 export const PACKAGE_NAME = pkg.name || "index.ts";
-export const APP_NAME = piConfigName || "pi";
-export const APP_TITLE = piConfigName ? APP_NAME : "π";
-export const CONFIG_DIR_NAME = pkg.piConfig?.configDir || ".pi";
+export const APP_NAME = spectralConfigName || "spectral";
+export const APP_TITLE = spectralConfigName ? APP_NAME : "spectral";
+export const CONFIG_DIR_NAME = pkg.spectralConfig?.configDir || ".spectral";
 export const VERSION = pkg.version || "0.0.0";
-// e.g., PI_CODING_AGENT_DIR or TAU_CODING_AGENT_DIR
+// e.g., SPECTRAL_CODING_AGENT_DIR
 export const ENV_AGENT_DIR = `${APP_NAME.toUpperCase()}_CODING_AGENT_DIR`;
 export const ENV_SESSION_DIR = `${APP_NAME.toUpperCase()}_CODING_AGENT_SESSION_DIR`;
 export function expandTildePath(path) {
     return normalizePath(path);
 }
-const DEFAULT_SHARE_VIEWER_URL = "https://pi.dev/session/";
+const DEFAULT_SHARE_VIEWER_URL = "https://spectral.dev/session/";
 /** Get the share viewer URL for a gist ID */
 export function getShareViewerUrl(gistId) {
-    const baseUrl = process.env.PI_SHARE_VIEWER_URL || DEFAULT_SHARE_VIEWER_URL;
+    const baseUrl = process.env.SPECTRAL_SHARE_VIEWER_URL || DEFAULT_SHARE_VIEWER_URL;
     return `${baseUrl}#${gistId}`;
 }
 // =============================================================================
-// User Config Paths (~/.pi/agent/*)
+// User Config Paths (~/.spectral/agent/*)
 // =============================================================================
-/** Get the agent config directory (e.g., ~/.pi/agent/) */
+/** Get the agent config directory (e.g., ~/.spectral/agent/) */
 export function getAgentDir() {
     const envDir = process.env[ENV_AGENT_DIR];
     if (envDir) {

package/dist/{pi → sdk}/coding-agent/core/agent-session.js

@@ -465,6 +465,8 @@ export class AgentSession {
      */
     dispose() {
         this._extensionRunner.invalidate("This extension ctx is stale after session replacement or reload. Do not use a captured pi or command ctx after ctx.newSession(), ctx.fork(), ctx.switchSession(), or ctx.reload(). For newSession, fork, and switchSession, move post-replacement work into withSession and use the ctx passed to withSession. For reload, do not use the old ctx after await ctx.reload().");
+        this.abortRetry();
+        this.agent.abort();
         this._disconnectFromAgent();
         this._eventListeners = [];
         cleanupSessionResources(this.sessionId);