pi-x-ide 1.2.0 → 1.4.0

package/package.json

@@ -1,16 +1,18 @@
 {
   "name": "pi-x-ide",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Pi extension package for IDE selection context integration.",
   "files": [
     "dist",
+    "schemas",
     "src"
   ],
   "keywords": [
     "pi-package",
     "pi",
     "ide",
-    "vscode"
+    "vscode",
+    "zed"
   ],
   "license": "Apache-2.0",
   "repository": {
@@ -21,6 +23,9 @@
     "url": "https://github.com/balaenis/pi-x-ide/issues"
   },
   "homepage": "https://github.com/balaenis/pi-x-ide#readme",
+  "engines": {
+    "node": ">=26"
+  },
   "type": "commonjs",
   "main": "./dist/src/pi/index.js",
   "dependencies": {
@@ -32,7 +37,7 @@
   "devDependencies": {
     "@earendil-works/pi-coding-agent": "^0.79.0",
     "@eslint/js": "^10.0.1",
-    "@types/node": "^22.10.0",
+    "@types/node": "^25.9.2",
     "@types/ws": "^8.5.13",
     "@vscode/vsce": "^3.2.2",
     "esbuild": "^0.27.0",
@@ -51,7 +56,9 @@
   "scripts": {
     "build": "tsc -p tsconfig.json && pnpm --filter './vscode' compile",
     "typecheck": "tsc -p tsconfig.json --noEmit && pnpm --filter './vscode' typecheck",
-    "test": "pnpm build && node --test dist/test/*.test.js",
+    "generate:config-schema": "node scripts/generate-config-schema.cjs",
+    "check:config-schema": "node scripts/generate-config-schema.cjs --check",
+    "test": "pnpm check:config-schema && pnpm build && node --test dist/test/*.test.js",
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "format": "prettier --write .",

package/schemas/config.json

@@ -0,0 +1,120 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/balaenis/pi-x-ide/schemas/config.json",
+  "title": "Pi config.json",
+  "description": "Schema for Pi-side configuration read from ~/.pi/config.json.",
+  "type": "object",
+  "additionalProperties": true,
+  "properties": {
+    "env": {
+      "type": "object",
+      "description": "Pi-side environment variables. Real environment variables override these values.",
+      "additionalProperties": {
+        "type": [
+          "string",
+          "number",
+          "boolean"
+        ]
+      },
+      "properties": {
+        "PI_X_IDE_LOCK_DIR": {
+          "type": "string",
+          "description": "Directory containing Pi x IDE lock files. Defaults to ~/.pi/pi-x-ide/lock."
+        },
+        "PI_X_IDE_AUTO_INSTALL": {
+          "type": [
+            "string",
+            "number",
+            "boolean"
+          ],
+          "description": "Controls VS Code-family extension auto-install. Values 0, false, and off disable it."
+        },
+        "PI_X_IDE_ZED_DB": {
+          "type": "string",
+          "description": "Override path to Zed's SQLite database."
+        },
+        "TERM_PROGRAM": {
+          "type": "string",
+          "description": "Terminal program marker used to detect VS Code, Cursor, Windsurf, or Zed."
+        },
+        "VSCODE_CWD": {
+          "type": "string",
+          "description": "VS Code-family cwd marker and IDE path hint."
+        },
+        "VSCODE_PID": {
+          "type": [
+            "string",
+            "number"
+          ],
+          "description": "VS Code-family process marker."
+        },
+        "VSCODE_IPC_HOOK_CLI": {
+          "type": "string",
+          "description": "VS Code-family IPC marker and IDE path hint."
+        },
+        "VSCODE_GIT_IPC_HANDLE": {
+          "type": "string",
+          "description": "VS Code-family Git IPC marker and IDE path hint."
+        },
+        "ZED_TERM": {
+          "type": [
+            "string",
+            "boolean"
+          ],
+          "description": "Zed terminal marker. Pi x IDE detects Zed when this is true."
+        },
+        "WSL_DISTRO_NAME": {
+          "type": "string",
+          "description": "WSL distribution name used for WSL path normalization and Zed database discovery."
+        },
+        "WSL_INTEROP": {
+          "type": "string",
+          "description": "WSL interop marker used for WSL path normalization and Zed database discovery."
+        },
+        "LOCALAPPDATA": {
+          "type": "string",
+          "description": "Windows local application data directory used to find Zed's database."
+        },
+        "USERPROFILE": {
+          "type": "string",
+          "description": "Windows user profile directory used to find Zed's database when LOCALAPPDATA is unavailable."
+        },
+        "PATH": {
+          "type": "string",
+          "description": "Executable search path used to find code, cursor, and windsurf CLIs."
+        },
+        "Path": {
+          "type": "string",
+          "description": "Windows-style executable search path used to find code, cursor, and windsurf CLIs."
+        },
+        "path": {
+          "type": "string",
+          "description": "Lowercase executable search path used to find code, cursor, and windsurf CLIs."
+        },
+        "PATHEXT": {
+          "type": "string",
+          "description": "Windows executable extensions used when searching for IDE CLIs."
+        }
+      },
+      "patternProperties": {
+        "^(CURSOR|WINDSURF|CODEIUM).*": {
+          "type": [
+            "string",
+            "number",
+            "boolean"
+          ],
+          "description": "IDE-specific marker used to detect Cursor or Windsurf terminals."
+        }
+      }
+    }
+  },
+  "examples": [
+    {
+      "env": {
+        "PI_X_IDE_LOCK_DIR": "/home/user/.pi/pi-x-ide/lock",
+        "PI_X_IDE_AUTO_INSTALL": "0",
+        "PI_X_IDE_ZED_DB": "/home/user/.local/share/zed/db/0-stable/db.sqlite"
+      }
+    }
+  ]
+}

package/src/pi/index.ts

@@ -17,6 +17,7 @@ import { registerIdeCommand } from "./commands";
 import { clearLatestSelection, registerContextHandlers, setLatestSelection } from "./context";
 import { createRuntime, type PiIdeRuntime } from "./state";
 import { clearIdeUi, updateIdeUi } from "./ui";
+import { startZedPolling, stopZedPolling } from "./zed";
 
 const RECONNECT_DELAY_MS = 2_000;
 const INSTALL_RECONNECT_RETRY_MS = 1_500;
@@ -28,7 +29,7 @@ export default function (pi: ExtensionAPI): void {
   registerContextHandlers(pi, runtime);
   registerIdeCommand(pi, runtime, {
     refreshCandidates: (ctx) => refreshCandidates(runtime, ctx),
-    connectAuto: (ctx) => connectAuto(runtime, ctx),
+    connectAuto: (ctx) => connectAutoWithZedFallback(runtime, ctx),
     connectCandidate: (candidate, ctx) => connectCandidate(runtime, candidate, ctx),
     disconnect: (ctx, disabled) => disconnect(runtime, ctx, disabled),
     installExtension: (ctx) => installExtension(runtime, ctx),
@@ -39,18 +40,20 @@ export default function (pi: ExtensionAPI): void {
     const generation = runtime.sessionGeneration;
     runtime.ctx = ctx;
     runtime.cwd = ctx.cwd;
+    stopZedPolling(runtime);
     if (!runtime.enabled) {
       runtime.connectionStatus = "disabled";
       updateIdeUi(runtime, ctx);
       return;
     }
     void maybeAutoInstallAndReconnect(runtime, ctx, generation);
-    await connectAuto(runtime, ctx);
+    await connectAutoWithZedFallback(runtime, ctx, generation);
   });
 
   pi.on("session_shutdown", (_event, ctx) => {
     runtime.sessionGeneration += 1;
     runtime.ctx = ctx;
+    stopZedPolling(runtime);
     if (runtime.reconnectTimer) clearTimeout(runtime.reconnectTimer);
     runtime.reconnectTimer = undefined;
     runtime.connection?.disconnect();
@@ -228,6 +231,17 @@ async function refreshCandidates(
   return runtime.candidates;
 }
 
+async function connectAutoWithZedFallback(
+  runtime: PiIdeRuntime,
+  ctx: ExtensionContext | ExtensionCommandContext,
+  generation = runtime.sessionGeneration,
+): Promise<void> {
+  await connectAuto(runtime, ctx);
+  if (runtime.connectionStatus !== "connected") {
+    startZedPolling(runtime, ctx, { generation });
+  }
+}
+
 async function connectAuto(runtime: PiIdeRuntime, ctx: ExtensionContext | ExtensionCommandContext): Promise<void> {
   runtime.enabled = true;
   const candidates = await refreshCandidates(runtime, ctx);
@@ -258,6 +272,7 @@ async function connectCandidate(
   runtime.ctx = ctx;
   runtime.cwd = ctx.cwd;
   runtime.enabled = true;
+  stopZedPolling(runtime);
   if (runtime.reconnectTimer) clearTimeout(runtime.reconnectTimer);
   runtime.reconnectTimer = undefined;
 
@@ -346,6 +361,7 @@ function isCurrentConnection(runtime: PiIdeRuntime, connection: IdeConnection |
 
 function disconnect(runtime: PiIdeRuntime, ctx: ExtensionContext | ExtensionCommandContext, disabled = false): void {
   runtime.ctx = ctx;
+  stopZedPolling(runtime);
   if (runtime.reconnectTimer) clearTimeout(runtime.reconnectTimer);
   runtime.reconnectTimer = undefined;
   const connection = runtime.connection;
@@ -370,7 +386,7 @@ function scheduleReconnect(runtime: PiIdeRuntime): void {
     runtime.reconnectTimer = undefined;
     const ctx = runtime.ctx;
     if (!ctx || !runtime.enabled) return;
-    connectAuto(runtime, ctx).catch((error: unknown) => {
+    connectAutoWithZedFallback(runtime, ctx).catch((error: unknown) => {
       runtime.connectionStatus = "error";
       runtime.connectionMessage = error instanceof Error ? error.message : String(error);
       updateIdeUi(runtime);

package/src/pi/install.ts

@@ -3,6 +3,7 @@ import { access } from "node:fs/promises";
 import { delimiter, isAbsolute, join } from "node:path";
 import { promisify } from "node:util";
 import packageJson from "../../package.json";
+import { resolvePiConfigEnv } from "../shared/config";
 import type { PiIdeRuntime } from "./state";
 
 const execFileAsync = promisify(execFile);
@@ -61,7 +62,8 @@ export const SUPPORTED_IDE_CLI_PROFILES: IdeCliProfile[] = [
 ];
 
 export function isAutoInstallEnabled(env: NodeJS.ProcessEnv = process.env): boolean {
-  const value = env[PI_X_IDE_AUTO_INSTALL_ENV];
+  const configuredEnv = resolvePiConfigEnv(env);
+  const value = configuredEnv[PI_X_IDE_AUTO_INSTALL_ENV];
   if (value === undefined) return true;
   return !["0", "false", "off"].includes(value.trim().toLowerCase());
 }
@@ -96,10 +98,11 @@ export function compareExtensionVersions(installed: string | undefined, target:
 }
 
 export function inferCurrentIdeFromEnv(env: NodeJS.ProcessEnv = process.env): SupportedIdeId | undefined {
+  const configuredEnv = resolvePiConfigEnv(env);
   const matches = new Set<SupportedIdeId>();
-  const hasWindsurfMarker = hasWindsurfEnvMarker(env);
-  const hasCursorMarker = hasCursorEnvMarker(env);
-  const hasVscodeMarker = hasVscodeEnvMarker(env);
+  const hasWindsurfMarker = hasWindsurfEnvMarker(configuredEnv);
+  const hasCursorMarker = hasCursorEnvMarker(configuredEnv);
+  const hasVscodeMarker = hasVscodeEnvMarker(configuredEnv);
 
   if (hasWindsurfMarker) matches.add("windsurf");
   if (hasCursorMarker) matches.add("cursor");
@@ -146,10 +149,11 @@ export async function findExecutable(
   command: string,
   env: NodeJS.ProcessEnv = process.env,
 ): Promise<string | undefined> {
-  const pathEnv = env.PATH ?? env.Path ?? env.path;
+  const configuredEnv = resolvePiConfigEnv(env);
+  const pathEnv = configuredEnv.PATH ?? configuredEnv.Path ?? configuredEnv.path;
   if (!pathEnv) return undefined;
 
-  const extensions = process.platform === "win32" ? parsePathExt(env) : [""];
+  const extensions = process.platform === "win32" ? parsePathExt(configuredEnv) : [""];
   const candidates = isAbsolute(command)
     ? [command]
     : pathEnv
@@ -184,7 +188,7 @@ export async function runCli(
 export async function discoverInstallCandidates(
   options: DiscoverInstallCandidatesOptions = {},
 ): Promise<IdeInstallCandidate[]> {
-  const env = options.env ?? process.env;
+  const env = resolvePiConfigEnv(options.env ?? process.env);
   const currentIde = inferCurrentIdeFromEnv(env);
   const includeLowConfidence = options.includeLowConfidence ?? false;
   const timeoutMs = options.timeoutMs ?? 15_000;
@@ -228,7 +232,8 @@ export function selectAutoInstallCandidate(
   candidates: IdeInstallCandidate[],
   env: NodeJS.ProcessEnv = process.env,
 ): IdeInstallCandidate | undefined {
-  const currentIde = inferCurrentIdeFromEnv(env);
+  const configuredEnv = resolvePiConfigEnv(env);
+  const currentIde = inferCurrentIdeFromEnv(configuredEnv);
   const highConfidence = candidates.filter(
     (candidate) => candidate.confidence === "current-terminal" && (!currentIde || candidate.id === currentIde),
   );

package/src/pi/state.ts

@@ -17,6 +17,9 @@ export interface PiIdeRuntime {
   attachState: AttachState;
   turnSelection?: EditorSelectionSnapshot;
   reconnectTimer?: NodeJS.Timeout;
+  zedPollTimer?: NodeJS.Timeout;
+  zedPollSelectionKey?: string;
+  zedPollWalMtimeMs?: number;
   installingIdeIds: Set<string>;
   sessionGeneration: number;
 }