@maxmo74/pi-coding-agent 0.0.0-stage → 1.4.0-max.1

package/dist/config.d.ts

@@ -0,0 +1,126 @@
+/**
+ * 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 declare const isBunBinary: boolean;
+/** Detect if Bun is the runtime (compiled binary or bun run) */
+export declare const isBunRuntime: boolean;
+export declare const isBundledNode: boolean;
+export type InstallMethod = "bun-binary" | "npm" | "pnpm" | "yarn" | "bun" | "unknown";
+interface SelfUpdateCommandStep {
+    command: string;
+    args: string[];
+    display: string;
+}
+export interface SelfUpdateCommand extends SelfUpdateCommandStep {
+    steps?: SelfUpdateCommandStep[];
+}
+export type SelfUpdatePackageTarget = string | {
+    packageName: string;
+    installSpec?: string;
+};
+export declare function detectInstallMethod(): InstallMethod;
+export declare function getSelfUpdateCommand(packageName: string, npmCommand?: string[], updatePackageTarget?: SelfUpdatePackageTarget): SelfUpdateCommand | undefined;
+export declare function getSelfUpdateUnavailableInstruction(packageName: string, npmCommand?: string[], updatePackageTarget?: SelfUpdatePackageTarget): string;
+export declare function getUpdateInstruction(packageName: string): string;
+/**
+ * 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: returns the package root containing package.json
+ * - Ignores Bun binary metadata copied into dist/ when the package root is available
+ */
+export declare function findNodePackageDir(startDir: string): string;
+export declare function getPackageDir(): string;
+/**
+ * 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 source (src/): src/modes/interactive/theme/
+ */
+export declare function getThemesDir(): string;
+/**
+ * Get path to HTML export template directory (shipped with package)
+ * - For Bun binary: export-html/ next to executable
+ * - For Node.js (dist/): dist/core/export-html/
+ * - For source (src/): src/core/export-html/
+ */
+export declare function getExportTemplateDir(): string;
+/** Get path to package.json */
+export declare function getPackageJsonPath(): string;
+/** Get path to README.md */
+export declare function getReadmePath(): string;
+/** Get path to docs directory */
+export declare function getDocsPath(): string;
+/** Get path to examples directory */
+export declare function getExamplesPath(): string;
+/** Get path to CHANGELOG.md */
+export declare function getChangelogPath(): string;
+/**
+ * Get path to built-in interactive assets directory.
+ * - For Bun binary: assets/ next to executable
+ * - For Node.js (dist/): dist/modes/interactive/assets/
+ * - For source (src/): src/modes/interactive/assets/
+ */
+export declare function getInteractiveAssetsDir(): string;
+/** Get path to a bundled interactive asset */
+export declare function getBundledInteractiveAssetPath(name: string): string;
+/** Called by the Bun entry with the path of the QuickJS wasm file embedded in the compiled executable. */
+export declare function setEmbeddedQuickJSWasmPath(path: string): void;
+/**
+ * Get path to `quickjs-wasi/quickjs.wasm`, the VM that runs codemode scripts. Resolved once so the
+ * compiled module cached per path keeps working after an update removes this install (#10439).
+ */
+export declare function getQuickJSWasmPath(): string;
+/** Resolve the codemode worker entry for a release runtime. */
+export declare function resolveCodemodeWorkerSpecifier(runtime: "bun-binary" | "bundled-node" | "unbundled", moduleUrl: string): string | URL | undefined;
+/**
+ * Get the codemode worker entry, or undefined to use the worker that ships next to pi-codemode.
+ * The Bun and Node release builds both pass the worker as an extra entrypoint.
+ */
+export declare function getCodemodeWorkerSpecifier(): string | URL | undefined;
+export type InstallChange = {
+    kind: "updated";
+    version: string;
+} | {
+    kind: "removed";
+};
+/**
+ * Detect that the package this process runs from changed on disk, for example after `pi update`
+ * in another terminal. Code loaded on demand can then be missing or from another version.
+ *
+ * Checks the package.json read at startup. Resolving it again would walk up past a deleted install
+ * and could find an unrelated package.json, such as one in the home directory.
+ */
+export declare function detectInstallChange(packageJsonPath?: string | undefined): InstallChange | undefined;
+export declare const PACKAGE_NAME: string;
+export declare const APP_NAME: string;
+export declare const APP_TITLE: string;
+export declare const CONFIG_DIR_NAME: string;
+export declare const VERSION: string;
+export declare const ENV_AGENT_DIR: string;
+export declare const ENV_SESSION_DIR: string;
+export declare function expandTildePath(path: string): string;
+/** Get the share viewer URL for a gist ID. */
+export declare function getShareViewerUrl(gistId: string): string;
+/** Get the agent config directory (e.g., ~/.pi/agent/) */
+export declare function getAgentDir(): string;
+/** Get path to user's custom themes directory */
+export declare function getCustomThemesDir(): string;
+/** Get path to models.json */
+export declare function getModelsPath(): string;
+/** Get path to auth.json */
+export declare function getAuthPath(): string;
+/** Get path to settings.json */
+export declare function getSettingsPath(): string;
+/** Get path to tools directory */
+export declare function getToolsDir(): string;
+/** Get path to managed binaries directory (fd, rg) */
+export declare function getBinDir(): string;
+/** Get path to prompt templates directory */
+export declare function getPromptsDir(): string;
+/** Get path to sessions directory */
+export declare function getSessionsDir(): string;
+/** Get path to debug log file */
+export declare function getDebugLogPath(): string;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/config.js

@@ -0,0 +1,534 @@
+import { accessSync, constants, existsSync, readFileSync, realpathSync } from "fs";
+import { createRequire } from "module";
+import { homedir } from "os";
+import { basename, dirname, join, resolve, sep, win32 } from "path";
+import { fileURLToPath } from "url";
+import { spawnProcessSync } from "./utils/child-process.js";
+import { normalizePath } from "./utils/paths.js";
+import { stripBom } from "./utils/text.js";
+// =============================================================================
+// Package Detection
+// =============================================================================
+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;
+export const isBundledNode = typeof PI_BUNDLED_NODE !== "undefined" && PI_BUNDLED_NODE;
+function normalizeSelfUpdatePackageTarget(target) {
+    if (typeof target === "string") {
+        return { packageName: target, installSpec: target };
+    }
+    return { packageName: target.packageName, installSpec: target.installSpec ?? target.packageName };
+}
+function makeSelfUpdateCommand(installStep, uninstallStep) {
+    if (!uninstallStep)
+        return installStep;
+    return {
+        ...installStep,
+        display: `${uninstallStep.display} && ${installStep.display}`,
+        steps: [uninstallStep, installStep],
+    };
+}
+function makeSelfUpdateCommandStep(command, args) {
+    return {
+        command,
+        args,
+        display: [command, ...args].map((arg) => (/\s/.test(arg) ? `"${arg}"` : arg)).join(" "),
+    };
+}
+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";
+    }
+    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";
+    }
+    return "unknown";
+}
+function getInferredNpmInstall() {
+    const packageDir = getPackageDir();
+    const path = process.platform === "win32" || packageDir.includes("\\") ? win32 : { basename, dirname };
+    const parent = path.dirname(packageDir);
+    let root;
+    if (path.basename(parent).startsWith("@") && path.basename(path.dirname(parent)) === "node_modules") {
+        root = path.dirname(parent);
+    }
+    else if (path.basename(parent) === "node_modules") {
+        root = parent;
+    }
+    if (!root)
+        return undefined;
+    const rootParent = path.dirname(root);
+    if (path.basename(rootParent) === "lib")
+        return { root, prefix: path.dirname(rootParent) };
+    // Windows global npm prefixes use `<prefix>\\node_modules`, which is
+    // indistinguishable from local project installs by path shape alone. Do not
+    // infer unsupported Windows custom prefixes without `npm root -g` evidence.
+    return undefined;
+}
+function getSelfUpdateCommandForMethod(method, installedPackageName, updatePackageTarget = installedPackageName, npmCommand) {
+    const target = normalizeSelfUpdatePackageTarget(updatePackageTarget);
+    switch (method) {
+        case "bun-binary":
+            return undefined;
+        case "pnpm": {
+            const match = readCommandOutput("pnpm", ["root", "-g"])
+                ? undefined
+                : /^(.*[\\/]global[\\/][^\\/]+)[\\/]\.pnpm[\\/]/.exec(getPackageDir());
+            const binDirArgs = match
+                ? [`--config.global-bin-dir=${process.env.PNPM_HOME || dirname(dirname(match[1]))}`]
+                : [];
+            return makeSelfUpdateCommand(makeSelfUpdateCommandStep("pnpm", [
+                "install",
+                "-g",
+                "--ignore-scripts",
+                "--config.minimumReleaseAge=0",
+                ...binDirArgs,
+                target.installSpec,
+            ]), target.packageName === installedPackageName
+                ? undefined
+                : makeSelfUpdateCommandStep("pnpm", ["remove", "-g", ...binDirArgs, installedPackageName]));
+        }
+        case "yarn":
+            return makeSelfUpdateCommand(makeSelfUpdateCommandStep("yarn", ["global", "add", "--ignore-scripts", target.installSpec]), target.packageName === installedPackageName
+                ? undefined
+                : makeSelfUpdateCommandStep("yarn", ["global", "remove", installedPackageName]));
+        case "bun":
+            return makeSelfUpdateCommand(makeSelfUpdateCommandStep("bun", [
+                "install",
+                "-g",
+                "--ignore-scripts",
+                "--minimum-release-age=0",
+                target.installSpec,
+            ]), target.packageName === installedPackageName
+                ? undefined
+                : makeSelfUpdateCommandStep("bun", ["uninstall", "-g", installedPackageName]));
+        case "npm": {
+            const [command = "npm", ...npmArgs] = npmCommand ?? [];
+            const inferred = npmCommand?.length ? undefined : getInferredNpmInstall();
+            const prefixArgs = [...npmArgs, ...(inferred ? ["--prefix", inferred.prefix] : [])];
+            // pi.dev advertises releases immediately, so a configured npm age gate would
+            // block the update. npm has no per-package age gate, so this also lets new
+            // transitive dependency releases through. Managed installs avoid this.
+            const installStep = makeSelfUpdateCommandStep(command, [
+                ...prefixArgs,
+                "install",
+                "-g",
+                "--ignore-scripts",
+                "--min-release-age=0",
+                target.installSpec,
+            ]);
+            const uninstallStep = target.packageName === installedPackageName
+                ? undefined
+                : makeSelfUpdateCommandStep(command, [...prefixArgs, "uninstall", "-g", installedPackageName]);
+            return makeSelfUpdateCommand(installStep, uninstallStep);
+        }
+        case "unknown":
+            return undefined;
+    }
+}
+function readCommandOutput(command, args, options = {}) {
+    const result = spawnProcessSync(command, args, {
+        encoding: "utf-8",
+        stdio: ["ignore", "pipe", "pipe"],
+    });
+    if (result.status === 0)
+        return result.stdout.trim() || undefined;
+    if (options.requireSuccess) {
+        const reason = result.error?.message || result.stderr.trim() || `exit code ${result.status ?? "unknown"}`;
+        throw new Error(`Failed to run ${[command, ...args].join(" ")}: ${reason}`);
+    }
+    return undefined;
+}
+function getGlobalPackageRoots(method, _packageName, npmCommand) {
+    switch (method) {
+        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,
+            });
+            const inferred = configured ? undefined : getInferredNpmInstall();
+            return [root, inferred?.root].filter((x) => !!x);
+        }
+        case "pnpm": {
+            const root = readCommandOutput("pnpm", ["root", "-g"]);
+            if (root)
+                return [root, dirname(root)];
+            const match = /^(.*[\\/]global[\\/][^\\/]+)[\\/]\.pnpm[\\/]/.exec(getPackageDir());
+            return match ? [match[1]] : [];
+        }
+        case "yarn": {
+            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 [];
+    }
+}
+function normalizeExistingPathForComparison(path, resolveSymlinks) {
+    const resolvedPath = resolve(path);
+    if (!existsSync(resolvedPath)) {
+        return undefined;
+    }
+    let normalizedPath = resolvedPath;
+    if (resolveSymlinks) {
+        try {
+            normalizedPath = realpathSync(resolvedPath);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    if (process.platform === "win32") {
+        normalizedPath = normalizedPath.toLowerCase();
+    }
+    return normalizedPath;
+}
+function getPathComparisonCandidates(path) {
+    return Array.from(new Set([normalizeExistingPathForComparison(path, false), normalizeExistingPathForComparison(path, true)].filter((candidate) => !!candidate)));
+}
+function getEntrypointPackageDir() {
+    const entrypoint = process.argv[1];
+    if (!entrypoint)
+        return undefined;
+    let dir = dirname(entrypoint);
+    while (dir !== dirname(dir)) {
+        if (existsSync(join(dir, "package.json"))) {
+            return dir;
+        }
+        dir = dirname(dir);
+    }
+    return undefined;
+}
+function isSelfUpdatePathWritable() {
+    const packageDir = getPackageDir();
+    try {
+        accessSync(packageDir, constants.W_OK);
+        accessSync(dirname(packageDir), constants.W_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isManagedByGlobalPackageManager(method, packageName, npmCommand) {
+    const packageDirs = [getPackageDir(), getEntrypointPackageDir()].filter((dir) => !!dir);
+    const packageDirCandidates = packageDirs.flatMap((dir) => getPathComparisonCandidates(dir));
+    return getGlobalPackageRoots(method, packageName, npmCommand).some((root) => {
+        return getPathComparisonCandidates(root).some((normalizedRoot) => {
+            const rootPrefix = normalizedRoot.endsWith(sep) ? normalizedRoot : `${normalizedRoot}${sep}`;
+            return packageDirCandidates.some((packageDir) => packageDir.startsWith(rootPrefix));
+        });
+    });
+}
+export function getSelfUpdateCommand(packageName, npmCommand, updatePackageTarget = packageName) {
+    const method = detectInstallMethod();
+    const command = getSelfUpdateCommandForMethod(method, packageName, updatePackageTarget, npmCommand);
+    if (!command || !isManagedByGlobalPackageManager(method, packageName, npmCommand) || !isSelfUpdatePathWritable()) {
+        return undefined;
+    }
+    return command;
+}
+export function getSelfUpdateUnavailableInstruction(packageName, npmCommand, updatePackageTarget = packageName) {
+    const method = detectInstallMethod();
+    const target = normalizeSelfUpdatePackageTarget(updatePackageTarget);
+    if (method === "bun-binary") {
+        return `Download from: https://github.com/earendil-works/pi/releases/latest`;
+    }
+    const command = getSelfUpdateCommandForMethod(method, packageName, target, npmCommand);
+    if (command) {
+        if (isManagedByGlobalPackageManager(method, packageName, npmCommand) && !isSelfUpdatePathWritable()) {
+            return `This installation is managed by a global ${method} install, but the install path is not writable. Update it yourself with: ${command.display}`;
+        }
+        return `This installation is not managed by a global ${method} install. Update it with the package manager, wrapper, or source checkout that provides it.`;
+    }
+    return `Update ${target.installSpec} using the package manager, wrapper, or source checkout that provides this installation.`;
+}
+export function getUpdateInstruction(packageName) {
+    const method = detectInstallMethod();
+    const command = getSelfUpdateCommandForMethod(method, packageName);
+    if (command) {
+        return `Run: ${command.display}`;
+    }
+    return getSelfUpdateUnavailableInstruction(packageName);
+}
+// =============================================================================
+// Package Asset Paths (shipped with executable)
+// =============================================================================
+/**
+ * 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: returns the package root containing package.json
+ * - Ignores Bun binary metadata copied into dist/ when the package root is available
+ */
+export function findNodePackageDir(startDir) {
+    let dir = startDir;
+    while (dir !== dirname(dir)) {
+        if (existsSync(join(dir, "package.json"))) {
+            const parent = dirname(dir);
+            // build:binary places Bun's metadata inside dist/. Node still needs the
+            // package root so its dist-relative asset paths do not become dist/dist/.
+            if (basename(dir) === "dist" && existsSync(join(parent, "package.json"))) {
+                return parent;
+            }
+            return dir;
+        }
+        dir = dirname(dir);
+    }
+    return startDir;
+}
+export function getPackageDir() {
+    // Allow override via environment variable (useful for Nix/Guix where store paths tokenize poorly)
+    const envDir = process.env.PI_PACKAGE_DIR;
+    if (envDir) {
+        return normalizePath(envDir);
+    }
+    if (isBunBinary) {
+        // Bun binary: process.execPath points to the compiled executable
+        return dirname(process.execPath);
+    }
+    return findNodePackageDir(__dirname);
+}
+/**
+ * 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 source (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";
+    return join(packageDir, srcOrDist, "modes", "interactive", "theme");
+}
+/**
+ * Get path to HTML export template directory (shipped with package)
+ * - For Bun binary: export-html/ next to executable
+ * - For Node.js (dist/): dist/core/export-html/
+ * - For source (src/): src/core/export-html/
+ */
+export function getExportTemplateDir() {
+    if (isBunBinary) {
+        return join(getPackageDir(), "export-html");
+    }
+    const packageDir = getPackageDir();
+    const srcOrDist = existsSync(join(packageDir, "src")) ? "src" : "dist";
+    return join(packageDir, srcOrDist, "core", "export-html");
+}
+/** Get path to package.json */
+export function getPackageJsonPath() {
+    return join(getPackageDir(), "package.json");
+}
+/** Get path to README.md */
+export function getReadmePath() {
+    return resolve(join(getPackageDir(), "README.md"));
+}
+/** Get path to docs directory */
+export function getDocsPath() {
+    return resolve(join(getPackageDir(), "docs"));
+}
+/** Get path to examples directory */
+export function getExamplesPath() {
+    return resolve(join(getPackageDir(), "examples"));
+}
+/** Get path to CHANGELOG.md */
+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 source (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);
+}
+let quickJSWasmPath;
+/** Called by the Bun entry with the path of the QuickJS wasm file embedded in the compiled executable. */
+export function setEmbeddedQuickJSWasmPath(path) {
+    quickJSWasmPath = path;
+}
+/**
+ * Get path to `quickjs-wasi/quickjs.wasm`, the VM that runs codemode scripts. Resolved once so the
+ * compiled module cached per path keeps working after an update removes this install (#10439).
+ */
+export function getQuickJSWasmPath() {
+    quickJSWasmPath ??= createRequire(import.meta.url).resolve("quickjs-wasi/quickjs.wasm");
+    return quickJSWasmPath;
+}
+/** Resolve the codemode worker entry for a release runtime. */
+export function resolveCodemodeWorkerSpecifier(runtime, moduleUrl) {
+    // Bun embeds explicit source entrypoints, but on Windows Bun 1.3 cannot map an absolute
+    // B:\~BUN URL back to one. A relative string with the original source extension works on
+    // every Bun platform.
+    if (runtime === "bun-binary")
+        return "./src/extensions/codemode/worker.ts";
+    if (runtime === "bundled-node")
+        return new URL("./codemode-worker.js", moduleUrl);
+    return undefined;
+}
+let codemodeWorkerDataUrl;
+/**
+ * Get the codemode worker entry, or undefined to use the worker that ships next to pi-codemode.
+ * The Bun and Node release builds both pass the worker as an extra entrypoint.
+ */
+export function getCodemodeWorkerSpecifier() {
+    const runtime = isBunBinary ? "bun-binary" : isBundledNode ? "bundled-node" : "unbundled";
+    const specifier = resolveCodemodeWorkerSpecifier(runtime, import.meta.url);
+    if (runtime !== "bundled-node" || !(specifier instanceof URL))
+        return specifier;
+    // Spawn workers from an in-memory copy. An update replaces or deletes the file while this
+    // process keeps running (#10439). The bundle build keeps the worker free of relative imports
+    // and import.meta, so it runs from a data: URL.
+    codemodeWorkerDataUrl ??= new URL(`data:text/javascript;base64,${readFileSync(specifier).toString("base64")}`);
+    return codemodeWorkerDataUrl;
+}
+/**
+ * Detect that the package this process runs from changed on disk, for example after `pi update`
+ * in another terminal. Code loaded on demand can then be missing or from another version.
+ *
+ * Checks the package.json read at startup. Resolving it again would walk up past a deleted install
+ * and could find an unrelated package.json, such as one in the home directory.
+ */
+export function detectInstallChange(packageJsonPath = startupPackageJsonPath) {
+    // The Bun binary embeds its code, so replacing the executable does not affect this process.
+    if (isBunBinary || !packageJsonPath)
+        return undefined;
+    let installed;
+    try {
+        installed = JSON.parse(stripBom(readFileSync(packageJsonPath, "utf-8")));
+    }
+    catch (error) {
+        return error.code === "ENOENT" ? { kind: "removed" } : undefined;
+    }
+    return installed.version && installed.version !== VERSION
+        ? { kind: "updated", version: installed.version }
+        : undefined;
+}
+let pkg = {};
+/** The package.json this process started from, if one existed. */
+let startupPackageJsonPath;
+try {
+    const packageJsonPath = getPackageJsonPath();
+    pkg = JSON.parse(stripBom(readFileSync(packageJsonPath, "utf-8")));
+    startupPackageJsonPath = packageJsonPath;
+}
+catch (e) {
+    const err = e;
+    if (err.code !== "ENOENT")
+        throw e;
+}
+const piConfigName = pkg.piConfig?.name;
+export const PACKAGE_NAME = pkg.name || "@earendil-works/pi-coding-agent";
+export const APP_NAME = piConfigName || "pi";
+export const APP_TITLE = piConfigName ? APP_NAME : "π";
+export const CONFIG_DIR_NAME = pkg.piConfig?.configDir || ".pi";
+export const VERSION = pkg.version || "0.0.0";
+// e.g., PI_CODING_AGENT_DIR or TAU_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/";
+/** 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;
+    return `${baseUrl}#${gistId}`;
+}
+// =============================================================================
+// User Config Paths (~/.pi/agent/*)
+// =============================================================================
+/** Get the agent config directory (e.g., ~/.pi/agent/) */
+export function getAgentDir() {
+    const envDir = process.env[ENV_AGENT_DIR];
+    if (envDir) {
+        return expandTildePath(envDir);
+    }
+    return join(homedir(), CONFIG_DIR_NAME, "agent");
+}
+/** Get path to user's custom themes directory */
+export function getCustomThemesDir() {
+    return join(getAgentDir(), "themes");
+}
+/** Get path to models.json */
+export function getModelsPath() {
+    return join(getAgentDir(), "models.json");
+}
+/** Get path to auth.json */
+export function getAuthPath() {
+    return join(getAgentDir(), "auth.json");
+}
+/** Get path to settings.json */
+export function getSettingsPath() {
+    return join(getAgentDir(), "settings.json");
+}
+/** Get path to tools directory */
+export function getToolsDir() {
+    return join(getAgentDir(), "tools");
+}
+/** Get path to managed binaries directory (fd, rg) */
+export function getBinDir() {
+    return join(getAgentDir(), "bin");
+}
+/** Get path to prompt templates directory */
+export function getPromptsDir() {
+    return join(getAgentDir(), "prompts");
+}
+/** Get path to sessions directory */
+export function getSessionsDir() {
+    return join(getAgentDir(), "sessions");
+}
+/** Get path to debug log file */
+export function getDebugLogPath() {
+    return join(getAgentDir(), `${APP_NAME}-debug.log`);
+}
+//# sourceMappingURL=config.js.map