open-multi-agent-kit 0.78.7 → 0.79.1

package/dist/config.d.ts

@@ -0,0 +1,132 @@
+/**
+ * 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 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 declare function detectInstallMethod(): InstallMethod;
+export declare function getSelfUpdateCommand(packageName: string, npmCommand?: string[], updatePackageName?: string): SelfUpdateCommand | undefined;
+export declare function getSelfUpdateUnavailableInstruction(packageName: string, npmCommand?: string[], updatePackageName?: string): 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 (dist/): returns __dirname (the dist/ directory)
+ * - For tsx (src/): returns parent directory (the package root)
+ */
+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 tsx (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 tsx (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 tsx (src/): src/modes/interactive/assets/
+ */
+export declare function getInteractiveAssetsDir(): string;
+/** Get path to a bundled interactive asset */
+export declare function getBundledInteractiveAssetPath(name: string): string;
+export declare function resolveRuntimeAppName(configuredName: string | undefined, _argv1?: string | undefined, _env?: NodeJS.ProcessEnv): string;
+export declare function resolveRuntimeConfigDir(configuredDir: string | undefined, _appName: string): string;
+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 IS_OMK_RUNTIME: boolean;
+export declare const RUNTIME_DISPLAY_NAME: string;
+export declare const RUNTIME_USER_AGENT_NAME: string;
+export declare const ENV_AGENT_DIR = "OMK_CODING_AGENT_DIR";
+export declare const ENV_SESSION_DIR = "OMK_CODING_AGENT_SESSION_DIR";
+export declare const ENV_PACKAGE_DIR = "OMK_PACKAGE_DIR";
+export declare const ENV_OFFLINE = "OMK_OFFLINE";
+export declare const ENV_TELEMETRY = "OMK_TELEMETRY";
+export declare const ENV_SHARE_VIEWER_URL = "OMK_SHARE_VIEWER_URL";
+export declare const ENV_SKIP_VERSION_CHECK = "OMK_SKIP_VERSION_CHECK";
+export declare const ENV_FULLSCREEN = "OMK_FULLSCREEN";
+export declare const ENV_NO_ALT_SCREEN = "OMK_NO_ALT_SCREEN";
+export declare const ENV_TMUX_ALT_SCREEN_AUTO = "OMK_TMUX_ALT_SCREEN_AUTO";
+export declare const ENV_CLEAR_ON_SHRINK = "OMK_CLEAR_ON_SHRINK";
+export declare const ENV_HARDWARE_CURSOR = "OMK_HARDWARE_CURSOR";
+export declare const ENV_STARTUP_BENCHMARK = "OMK_STARTUP_BENCHMARK";
+export declare const ENV_TIMING = "OMK_TIMING";
+export declare const ENV_COMPOSER_LIFT_ROWS = "OMK_COMPOSER_LIFT_ROWS";
+export declare const ENV_AGENT_DIR_ALIASES: string[];
+export declare const ENV_SESSION_DIR_ALIASES: string[];
+export declare const ENV_PACKAGE_DIR_ALIASES: string[];
+export declare const ENV_OFFLINE_ALIASES: string[];
+export declare const ENV_TELEMETRY_ALIASES: string[];
+export declare const ENV_SHARE_VIEWER_URL_ALIASES: string[];
+export declare const ENV_SKIP_VERSION_CHECK_ALIASES: string[];
+export declare const ENV_FULLSCREEN_ALIASES: string[];
+export declare const ENV_NO_ALT_SCREEN_ALIASES: string[];
+export declare const ENV_TMUX_ALT_SCREEN_AUTO_ALIASES: string[];
+export declare const ENV_CLEAR_ON_SHRINK_ALIASES: string[];
+export declare const ENV_HARDWARE_CURSOR_ALIASES: string[];
+export declare const ENV_STARTUP_BENCHMARK_ALIASES: string[];
+export declare const ENV_TIMING_ALIASES: string[];
+export declare const ENV_COMPOSER_LIFT_ROWS_ALIASES: string[];
+export declare function readAliasedEnv(names: readonly string[], env?: NodeJS.ProcessEnv): string | undefined;
+export declare function isAliasedEnvFlagEnabled(names: readonly string[], env?: NodeJS.ProcessEnv): boolean;
+export declare function getComposerLiftRows(env?: NodeJS.ProcessEnv): number;
+export declare function formatAliasedEnvLabel(primary: string, aliases: readonly string[]): string;
+export declare function expandTildePath(path: string): string;
+export declare function getDefaultVersionCheckUrl(env?: NodeJS.ProcessEnv): string | undefined;
+export declare function getDefaultInstallTelemetryUrl(env?: NodeJS.ProcessEnv): string | undefined;
+export declare function getDefaultChangelogUrl(env?: NodeJS.ProcessEnv): string | undefined;
+/** Get the share viewer URL for a gist ID */
+export declare function getShareViewerUrl(gistId: string): string;
+/** Get the agent config directory (e.g., ~/.omk/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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","sourcesContent":["import { accessSync, constants, existsSync, readFileSync, realpathSync } from \"fs\";\nimport { homedir } from \"os\";\nimport { basename, dirname, join, resolve, sep, win32 } from \"path\";\nimport { fileURLToPath } from \"url\";\nimport { spawnProcessSync } from \"./utils/child-process.ts\";\nimport { normalizePath } from \"./utils/paths.ts\";\n\n// =============================================================================\n// Package Detection\n// =============================================================================\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\n/**\n * Detect if we're running as a Bun compiled binary.\n * Bun binaries have import.meta.url containing \"$bunfs\", \"~BUN\", or \"%7EBUN\" (Bun's virtual filesystem path)\n */\nexport const isBunBinary =\n\timport.meta.url.includes(\"$bunfs\") || import.meta.url.includes(\"~BUN\") || import.meta.url.includes(\"%7EBUN\");\n\n/** Detect if Bun is the runtime (compiled binary or bun run) */\nexport const isBunRuntime = !!process.versions.bun;\n\n// =============================================================================\n// Install Method Detection\n// =============================================================================\n\nexport type InstallMethod = \"bun-binary\" | \"npm\" | \"pnpm\" | \"yarn\" | \"bun\" | \"unknown\";\n\ninterface SelfUpdateCommandStep {\n\tcommand: string;\n\targs: string[];\n\tdisplay: string;\n}\n\nexport interface SelfUpdateCommand extends SelfUpdateCommandStep {\n\tsteps?: SelfUpdateCommandStep[];\n}\n\nfunction makeSelfUpdateCommand(\n\tinstallStep: SelfUpdateCommandStep,\n\tuninstallStep?: SelfUpdateCommandStep,\n): SelfUpdateCommand {\n\tif (!uninstallStep) return installStep;\n\treturn {\n\t\t...installStep,\n\t\tdisplay: `${uninstallStep.display} && ${installStep.display}`,\n\t\tsteps: [uninstallStep, installStep],\n\t};\n}\n\nfunction makeSelfUpdateCommandStep(command: string, args: string[]): SelfUpdateCommandStep {\n\treturn {\n\t\tcommand,\n\t\targs,\n\t\tdisplay: [command, ...args].map((arg) => (/\\s/.test(arg) ? `\"${arg}\"` : arg)).join(\" \"),\n\t};\n}\n\nexport function detectInstallMethod(): InstallMethod {\n\tif (isBunBinary) {\n\t\treturn \"bun-binary\";\n\t}\n\n\tconst resolvedPath = `${__dirname}\\0${process.execPath || \"\"}`.toLowerCase().replace(/\\\\/g, \"/\");\n\n\tif (resolvedPath.includes(\"/pnpm/\") || resolvedPath.includes(\"/.pnpm/\")) {\n\t\treturn \"pnpm\";\n\t}\n\tif (resolvedPath.includes(\"/yarn/\") || resolvedPath.includes(\"/.yarn/\")) {\n\t\treturn \"yarn\";\n\t}\n\tif (isBunRuntime || resolvedPath.includes(\"/install/global/node_modules/\")) {\n\t\treturn \"bun\";\n\t}\n\tif (resolvedPath.includes(\"/npm/\") || resolvedPath.includes(\"/node_modules/\")) {\n\t\treturn \"npm\";\n\t}\n\n\treturn \"unknown\";\n}\n\nfunction getInferredNpmInstall(): { root: string; prefix: string } | undefined {\n\tconst packageDir = getPackageDir();\n\tconst path = process.platform === \"win32\" || packageDir.includes(\"\\\\\") ? win32 : { basename, dirname };\n\tconst parent = path.dirname(packageDir);\n\tlet root: string | undefined;\n\tif (path.basename(parent).startsWith(\"@\") && path.basename(path.dirname(parent)) === \"node_modules\") {\n\t\troot = path.dirname(parent);\n\t} else if (path.basename(parent) === \"node_modules\") {\n\t\troot = parent;\n\t}\n\tif (!root) return undefined;\n\tconst rootParent = path.dirname(root);\n\tif (path.basename(rootParent) === \"lib\") return { root, prefix: path.dirname(rootParent) };\n\t// Windows global npm prefixes use `<prefix>\\\\node_modules`, which is\n\t// indistinguishable from local project installs by path shape alone. Do not\n\t// infer unsupported Windows custom prefixes without `npm root -g` evidence.\n\treturn undefined;\n}\n\nfunction getSelfUpdateCommandForMethod(\n\tmethod: InstallMethod,\n\tinstalledPackageName: string,\n\tupdatePackageName = installedPackageName,\n\tnpmCommand?: string[],\n): SelfUpdateCommand | undefined {\n\tswitch (method) {\n\t\tcase \"bun-binary\":\n\t\t\treturn undefined;\n\t\tcase \"pnpm\":\n\t\t\treturn makeSelfUpdateCommand(\n\t\t\t\tmakeSelfUpdateCommandStep(\"pnpm\", [\n\t\t\t\t\t\"install\",\n\t\t\t\t\t\"-g\",\n\t\t\t\t\t\"--ignore-scripts\",\n\t\t\t\t\t\"--config.minimumReleaseAge=0\",\n\t\t\t\t\tupdatePackageName,\n\t\t\t\t]),\n\t\t\t\tupdatePackageName === installedPackageName\n\t\t\t\t\t? undefined\n\t\t\t\t\t: makeSelfUpdateCommandStep(\"pnpm\", [\"remove\", \"-g\", installedPackageName]),\n\t\t\t);\n\t\tcase \"yarn\":\n\t\t\treturn makeSelfUpdateCommand(\n\t\t\t\tmakeSelfUpdateCommandStep(\"yarn\", [\"global\", \"add\", \"--ignore-scripts\", updatePackageName]),\n\t\t\t\tupdatePackageName === installedPackageName\n\t\t\t\t\t? undefined\n\t\t\t\t\t: makeSelfUpdateCommandStep(\"yarn\", [\"global\", \"remove\", installedPackageName]),\n\t\t\t);\n\t\tcase \"bun\":\n\t\t\treturn makeSelfUpdateCommand(\n\t\t\t\tmakeSelfUpdateCommandStep(\"bun\", [\n\t\t\t\t\t\"install\",\n\t\t\t\t\t\"-g\",\n\t\t\t\t\t\"--ignore-scripts\",\n\t\t\t\t\t\"--minimum-release-age=0\",\n\t\t\t\t\tupdatePackageName,\n\t\t\t\t]),\n\t\t\t\tupdatePackageName === installedPackageName\n\t\t\t\t\t? undefined\n\t\t\t\t\t: makeSelfUpdateCommandStep(\"bun\", [\"uninstall\", \"-g\", installedPackageName]),\n\t\t\t);\n\t\tcase \"npm\": {\n\t\t\tconst [command = \"npm\", ...npmArgs] = npmCommand ?? [];\n\t\t\tconst inferred = npmCommand?.length ? undefined : getInferredNpmInstall();\n\t\t\tconst prefixArgs = [...npmArgs, ...(inferred ? [\"--prefix\", inferred.prefix] : [])];\n\t\t\tconst installStep = makeSelfUpdateCommandStep(command, [\n\t\t\t\t...prefixArgs,\n\t\t\t\t\"install\",\n\t\t\t\t\"-g\",\n\t\t\t\t\"--ignore-scripts\",\n\t\t\t\t\"--min-release-age=0\",\n\t\t\t\tupdatePackageName,\n\t\t\t]);\n\t\t\tconst uninstallStep =\n\t\t\t\tupdatePackageName === installedPackageName\n\t\t\t\t\t? undefined\n\t\t\t\t\t: makeSelfUpdateCommandStep(command, [...prefixArgs, \"uninstall\", \"-g\", installedPackageName]);\n\t\t\treturn makeSelfUpdateCommand(installStep, uninstallStep);\n\t\t}\n\t\tcase \"unknown\":\n\t\t\treturn undefined;\n\t}\n}\n\nfunction readCommandOutput(\n\tcommand: string,\n\targs: string[],\n\toptions: { requireSuccess?: boolean } = {},\n): string | undefined {\n\tconst result = spawnProcessSync(command, args, {\n\t\tencoding: \"utf-8\",\n\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t});\n\tif (result.status === 0) return result.stdout.trim() || undefined;\n\tif (options.requireSuccess) {\n\t\tconst reason = result.error?.message || result.stderr.trim() || `exit code ${result.status ?? \"unknown\"}`;\n\t\tthrow new Error(`Failed to run ${[command, ...args].join(\" \")}: ${reason}`);\n\t}\n\treturn undefined;\n}\n\nfunction getGlobalPackageRoots(method: InstallMethod, _packageName: string, npmCommand?: string[]): string[] {\n\tswitch (method) {\n\t\tcase \"npm\": {\n\t\t\tconst configured = !!npmCommand?.length;\n\t\t\tconst [command = \"npm\", ...npmArgs] = npmCommand ?? [];\n\t\t\tif (configured && command === \"bun\") {\n\t\t\t\tconst bunBin = readCommandOutput(command, [...npmArgs, \"pm\", \"bin\", \"-g\"], {\n\t\t\t\t\trequireSuccess: true,\n\t\t\t\t});\n\t\t\t\tconst roots = [join(homedir(), \".bun\", \"install\", \"global\", \"node_modules\")];\n\t\t\t\tif (bunBin) {\n\t\t\t\t\troots.push(join(dirname(bunBin), \"install\", \"global\", \"node_modules\"));\n\t\t\t\t}\n\t\t\t\treturn roots;\n\t\t\t}\n\t\t\tconst root = readCommandOutput(command, [...npmArgs, \"root\", \"-g\"], {\n\t\t\t\trequireSuccess: configured,\n\t\t\t});\n\t\t\tconst inferred = configured ? undefined : getInferredNpmInstall();\n\t\t\treturn [root, inferred?.root].filter((x): x is string => !!x);\n\t\t}\n\t\tcase \"pnpm\": {\n\t\t\tconst root = readCommandOutput(\"pnpm\", [\"root\", \"-g\"]);\n\t\t\treturn root ? [root, dirname(root)] : [];\n\t\t}\n\t\tcase \"yarn\": {\n\t\t\tconst dir = readCommandOutput(\"yarn\", [\"global\", \"dir\"]);\n\t\t\treturn dir ? [dir, join(dir, \"node_modules\")] : [];\n\t\t}\n\t\tcase \"bun\": {\n\t\t\tconst bunBin = readCommandOutput(\"bun\", [\"pm\", \"bin\", \"-g\"]);\n\t\t\tconst roots = [join(homedir(), \".bun\", \"install\", \"global\", \"node_modules\")];\n\t\t\tif (bunBin) {\n\t\t\t\troots.push(join(dirname(bunBin), \"install\", \"global\", \"node_modules\"));\n\t\t\t}\n\t\t\treturn roots;\n\t\t}\n\t\tcase \"bun-binary\":\n\t\tcase \"unknown\":\n\t\t\treturn [];\n\t}\n}\n\nfunction normalizeExistingPathForComparison(path: string, resolveSymlinks: boolean): string | undefined {\n\tconst resolvedPath = resolve(path);\n\tif (!existsSync(resolvedPath)) {\n\t\treturn undefined;\n\t}\n\tlet normalizedPath = resolvedPath;\n\tif (resolveSymlinks) {\n\t\ttry {\n\t\t\tnormalizedPath = realpathSync(resolvedPath);\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\tif (process.platform === \"win32\") {\n\t\tnormalizedPath = normalizedPath.toLowerCase();\n\t}\n\treturn normalizedPath;\n}\n\nfunction getPathComparisonCandidates(path: string): string[] {\n\treturn Array.from(\n\t\tnew Set(\n\t\t\t[normalizeExistingPathForComparison(path, false), normalizeExistingPathForComparison(path, true)].filter(\n\t\t\t\t(candidate): candidate is string => !!candidate,\n\t\t\t),\n\t\t),\n\t);\n}\n\nfunction getEntrypointPackageDir(): string | undefined {\n\tconst entrypoint = process.argv[1];\n\tif (!entrypoint) return undefined;\n\tlet dir = dirname(entrypoint);\n\twhile (dir !== dirname(dir)) {\n\t\tif (existsSync(join(dir, \"package.json\"))) {\n\t\t\treturn dir;\n\t\t}\n\t\tdir = dirname(dir);\n\t}\n\treturn undefined;\n}\n\nfunction isSelfUpdatePathWritable(): boolean {\n\tconst packageDir = getPackageDir();\n\ttry {\n\t\taccessSync(packageDir, constants.W_OK);\n\t\taccessSync(dirname(packageDir), constants.W_OK);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction isManagedByGlobalPackageManager(method: InstallMethod, packageName: string, npmCommand?: string[]): boolean {\n\tconst packageDirs = [getPackageDir(), getEntrypointPackageDir()].filter((dir): dir is string => !!dir);\n\tconst packageDirCandidates = packageDirs.flatMap((dir) => getPathComparisonCandidates(dir));\n\treturn getGlobalPackageRoots(method, packageName, npmCommand).some((root) => {\n\t\treturn getPathComparisonCandidates(root).some((normalizedRoot) => {\n\t\t\tconst rootPrefix = normalizedRoot.endsWith(sep) ? normalizedRoot : `${normalizedRoot}${sep}`;\n\t\t\treturn packageDirCandidates.some((packageDir) => packageDir.startsWith(rootPrefix));\n\t\t});\n\t});\n}\n\nexport function getSelfUpdateCommand(\n\tpackageName: string,\n\tnpmCommand?: string[],\n\tupdatePackageName = packageName,\n): SelfUpdateCommand | undefined {\n\tconst method = detectInstallMethod();\n\tconst command = getSelfUpdateCommandForMethod(method, packageName, updatePackageName, npmCommand);\n\tif (!command || !isManagedByGlobalPackageManager(method, packageName, npmCommand) || !isSelfUpdatePathWritable()) {\n\t\treturn undefined;\n\t}\n\treturn command;\n}\n\nexport function getSelfUpdateUnavailableInstruction(\n\tpackageName: string,\n\tnpmCommand?: string[],\n\tupdatePackageName = packageName,\n): string {\n\tconst method = detectInstallMethod();\n\tif (method === \"bun-binary\") {\n\t\treturn `Download from: https://github.com/earendil-works/pi-mono/releases/latest`;\n\t}\n\tconst command = getSelfUpdateCommandForMethod(method, packageName, updatePackageName, npmCommand);\n\tif (command) {\n\t\tif (isManagedByGlobalPackageManager(method, packageName, npmCommand) && !isSelfUpdatePathWritable()) {\n\t\t\treturn `This installation is managed by a global ${method} install, but the install path is not writable. Update it yourself with: ${command.display}`;\n\t\t}\n\t\treturn `This installation is not managed by a global ${method} install. Update it with the package manager, wrapper, or source checkout that provides it.`;\n\t}\n\treturn `Update ${updatePackageName} using the package manager, wrapper, or source checkout that provides this installation.`;\n}\n\nexport function getUpdateInstruction(packageName: string): string {\n\tconst method = detectInstallMethod();\n\tconst command = getSelfUpdateCommandForMethod(method, packageName);\n\tif (command) {\n\t\treturn `Run: ${command.display}`;\n\t}\n\treturn getSelfUpdateUnavailableInstruction(packageName);\n}\n\n// =============================================================================\n// Package Asset Paths (shipped with executable)\n// =============================================================================\n\n/**\n * Get the base directory for resolving package assets (themes, package.json, README.md, CHANGELOG.md).\n * - For Bun binary: returns the directory containing the executable\n * - For Node.js (dist/): returns __dirname (the dist/ directory)\n * - For tsx (src/): returns parent directory (the package root)\n */\nexport function getPackageDir(): string {\n\t// Allow override via environment variable (useful for Nix/Guix where store paths tokenize poorly)\n\tconst envDir = process.env.OMK_PACKAGE_DIR;\n\tif (envDir) {\n\t\treturn normalizePath(envDir);\n\t}\n\n\tif (isBunBinary) {\n\t\t// Bun binary: process.execPath points to the compiled executable\n\t\treturn dirname(process.execPath);\n\t}\n\t// Node.js: walk up from __dirname until we find package.json\n\tlet dir = __dirname;\n\twhile (dir !== dirname(dir)) {\n\t\tif (existsSync(join(dir, \"package.json\"))) {\n\t\t\treturn dir;\n\t\t}\n\t\tdir = dirname(dir);\n\t}\n\t// Fallback (shouldn't happen)\n\treturn __dirname;\n}\n\n/**\n * Get path to built-in themes directory (shipped with package)\n * - For Bun binary: theme/ next to executable\n * - For Node.js (dist/): dist/modes/interactive/theme/\n * - For tsx (src/): src/modes/interactive/theme/\n */\nexport function getThemesDir(): string {\n\tif (isBunBinary) {\n\t\treturn join(getPackageDir(), \"theme\");\n\t}\n\t// Theme is in modes/interactive/theme/ relative to src/ or dist/\n\tconst packageDir = getPackageDir();\n\tconst srcOrDist = existsSync(join(packageDir, \"src\")) ? \"src\" : \"dist\";\n\treturn join(packageDir, srcOrDist, \"modes\", \"interactive\", \"theme\");\n}\n\n/**\n * Get path to HTML export template directory (shipped with package)\n * - For Bun binary: export-html/ next to executable\n * - For Node.js (dist/): dist/core/export-html/\n * - For tsx (src/): src/core/export-html/\n */\nexport function getExportTemplateDir(): string {\n\tif (isBunBinary) {\n\t\treturn join(getPackageDir(), \"export-html\");\n\t}\n\tconst packageDir = getPackageDir();\n\tconst srcOrDist = existsSync(join(packageDir, \"src\")) ? \"src\" : \"dist\";\n\treturn join(packageDir, srcOrDist, \"core\", \"export-html\");\n}\n\n/** Get path to package.json */\nexport function getPackageJsonPath(): string {\n\treturn join(getPackageDir(), \"package.json\");\n}\n\n/** Get path to README.md */\nexport function getReadmePath(): string {\n\treturn resolve(join(getPackageDir(), \"README.md\"));\n}\n\n/** Get path to docs directory */\nexport function getDocsPath(): string {\n\treturn resolve(join(getPackageDir(), \"docs\"));\n}\n\n/** Get path to examples directory */\nexport function getExamplesPath(): string {\n\treturn resolve(join(getPackageDir(), \"examples\"));\n}\n\n/** Get path to CHANGELOG.md */\nexport function getChangelogPath(): string {\n\treturn resolve(join(getPackageDir(), \"CHANGELOG.md\"));\n}\n\n/**\n * Get path to built-in interactive assets directory.\n * - For Bun binary: assets/ next to executable\n * - For Node.js (dist/): dist/modes/interactive/assets/\n * - For tsx (src/): src/modes/interactive/assets/\n */\nexport function getInteractiveAssetsDir(): string {\n\tif (isBunBinary) {\n\t\treturn join(getPackageDir(), \"assets\");\n\t}\n\tconst packageDir = getPackageDir();\n\tconst srcOrDist = existsSync(join(packageDir, \"src\")) ? \"src\" : \"dist\";\n\treturn join(packageDir, srcOrDist, \"modes\", \"interactive\", \"assets\");\n}\n\n/** Get path to a bundled interactive asset */\nexport function getBundledInteractiveAssetPath(name: string): string {\n\treturn join(getInteractiveAssetsDir(), name);\n}\n\n// =============================================================================\n// App Config (from package.json omkConfig)\n// =============================================================================\n\ninterface RuntimePackageConfig {\n\tname?: string;\n\tconfigDir?: string;\n}\n\ninterface PackageJson {\n\tname?: string;\n\tversion?: string;\n\tomkConfig?: RuntimePackageConfig;\n}\n\nlet pkg: PackageJson = {};\ntry {\n\tpkg = JSON.parse(readFileSync(getPackageJsonPath(), \"utf-8\")) as PackageJson;\n} catch (e: unknown) {\n\tconst err = e as NodeJS.ErrnoException;\n\tif (err.code !== \"ENOENT\") throw e;\n}\n\nfunction envFlagEnabled(value: string | undefined): boolean {\n\treturn value === \"1\" || value === \"true\" || value === \"yes\" || value === \"on\";\n}\n\nexport function resolveRuntimeAppName(\n\tconfiguredName: string | undefined,\n\t_argv1: string | undefined = process.argv[1],\n\t_env: NodeJS.ProcessEnv = process.env,\n): string {\n\tconst trimmedConfigName = configuredName?.trim();\n\tif (trimmedConfigName) return trimmedConfigName;\n\treturn \"omk\";\n}\n\nexport function resolveRuntimeConfigDir(configuredDir: string | undefined, _appName: string): string {\n\tif (configuredDir && configuredDir !== \".pi\") return configuredDir;\n\treturn \".omk\";\n}\n\nconst runtimeConfig: RuntimePackageConfig | undefined = pkg.omkConfig;\nconst runtimeConfigName: string | undefined = runtimeConfig?.name;\nexport const PACKAGE_NAME: string = pkg.name || \"@earendil-works/omk-coding-agent\";\nexport const APP_NAME: string = resolveRuntimeAppName(runtimeConfigName);\nexport const APP_TITLE: string = APP_NAME === \"omk\" ? \"OMK\" : APP_NAME;\nexport const CONFIG_DIR_NAME: string = resolveRuntimeConfigDir(runtimeConfig?.configDir, APP_NAME);\nexport const VERSION: string = pkg.version || \"0.0.0\";\nexport const IS_OMK_RUNTIME = APP_NAME === \"omk\";\nexport const RUNTIME_DISPLAY_NAME: string = IS_OMK_RUNTIME ? \"OMK\" : APP_NAME;\nexport const RUNTIME_USER_AGENT_NAME: string = APP_NAME.toLowerCase();\n\n// OMK hardfork runtime environment variables.\nexport const ENV_AGENT_DIR = \"OMK_CODING_AGENT_DIR\";\nexport const ENV_SESSION_DIR = \"OMK_CODING_AGENT_SESSION_DIR\";\nexport const ENV_PACKAGE_DIR = \"OMK_PACKAGE_DIR\";\nexport const ENV_OFFLINE = \"OMK_OFFLINE\";\nexport const ENV_TELEMETRY = \"OMK_TELEMETRY\";\nexport const ENV_SHARE_VIEWER_URL = \"OMK_SHARE_VIEWER_URL\";\nexport const ENV_SKIP_VERSION_CHECK = \"OMK_SKIP_VERSION_CHECK\";\nexport const ENV_FULLSCREEN = \"OMK_FULLSCREEN\";\nexport const ENV_NO_ALT_SCREEN = \"OMK_NO_ALT_SCREEN\";\nexport const ENV_TMUX_ALT_SCREEN_AUTO = \"OMK_TMUX_ALT_SCREEN_AUTO\";\nexport const ENV_CLEAR_ON_SHRINK = \"OMK_CLEAR_ON_SHRINK\";\nexport const ENV_HARDWARE_CURSOR = \"OMK_HARDWARE_CURSOR\";\nexport const ENV_STARTUP_BENCHMARK = \"OMK_STARTUP_BENCHMARK\";\nexport const ENV_TIMING = \"OMK_TIMING\";\n// OMK-only: controls the neon HUD gap between the sticky composer and footer.\nexport const ENV_COMPOSER_LIFT_ROWS = \"OMK_COMPOSER_LIFT_ROWS\";\n\nexport const ENV_AGENT_DIR_ALIASES = [ENV_AGENT_DIR];\nexport const ENV_SESSION_DIR_ALIASES = [ENV_SESSION_DIR];\nexport const ENV_PACKAGE_DIR_ALIASES = [ENV_PACKAGE_DIR];\nexport const ENV_OFFLINE_ALIASES = [ENV_OFFLINE];\nexport const ENV_TELEMETRY_ALIASES = [ENV_TELEMETRY];\nexport const ENV_SHARE_VIEWER_URL_ALIASES = [ENV_SHARE_VIEWER_URL];\nexport const ENV_SKIP_VERSION_CHECK_ALIASES = [ENV_SKIP_VERSION_CHECK];\nexport const ENV_FULLSCREEN_ALIASES = [ENV_FULLSCREEN];\nexport const ENV_NO_ALT_SCREEN_ALIASES = [ENV_NO_ALT_SCREEN];\nexport const ENV_TMUX_ALT_SCREEN_AUTO_ALIASES = [ENV_TMUX_ALT_SCREEN_AUTO];\nexport const ENV_CLEAR_ON_SHRINK_ALIASES = [ENV_CLEAR_ON_SHRINK];\nexport const ENV_HARDWARE_CURSOR_ALIASES = [ENV_HARDWARE_CURSOR];\nexport const ENV_STARTUP_BENCHMARK_ALIASES = [ENV_STARTUP_BENCHMARK];\nexport const ENV_TIMING_ALIASES = [ENV_TIMING];\nexport const ENV_COMPOSER_LIFT_ROWS_ALIASES = [ENV_COMPOSER_LIFT_ROWS];\n\nexport function readAliasedEnv(names: readonly string[], env: NodeJS.ProcessEnv = process.env): string | undefined {\n\tfor (const name of names) {\n\t\tconst value = env[name];\n\t\tif (value !== undefined && value.length > 0) return value;\n\t}\n\treturn undefined;\n}\n\nexport function isAliasedEnvFlagEnabled(names: readonly string[], env: NodeJS.ProcessEnv = process.env): boolean {\n\treturn envFlagEnabled(readAliasedEnv(names, env));\n}\n\nexport function getComposerLiftRows(env: NodeJS.ProcessEnv = process.env): number {\n\tconst raw = readAliasedEnv(ENV_COMPOSER_LIFT_ROWS_ALIASES, env);\n\tif (raw === undefined) return 0;\n\n\tconst parsed = Number.parseInt(raw, 10);\n\tif (!Number.isFinite(parsed) || parsed < 0) return 0;\n\treturn Math.min(parsed, 8);\n}\n\nexport function formatAliasedEnvLabel(primary: string, aliases: readonly string[]): string {\n\tconst legacy = aliases.filter((name) => name !== primary);\n\treturn legacy.length === 0 ? primary : `${primary} (legacy: ${legacy.join(\", \")})`;\n}\n\nexport function expandTildePath(path: string): string {\n\treturn normalizePath(path);\n}\n\nexport function getDefaultVersionCheckUrl(env: NodeJS.ProcessEnv = process.env): string | undefined {\n\tconst explicitUrl = env.OMK_VERSION_CHECK_URL?.trim();\n\tif (explicitUrl) return explicitUrl;\n\treturn undefined;\n}\n\nexport function getDefaultInstallTelemetryUrl(env: NodeJS.ProcessEnv = process.env): string | undefined {\n\tconst explicitUrl = env.OMK_INSTALL_TELEMETRY_URL?.trim();\n\tif (explicitUrl) return explicitUrl;\n\treturn undefined;\n}\n\nexport function getDefaultChangelogUrl(env: NodeJS.ProcessEnv = process.env): string | undefined {\n\tconst explicitUrl = env.OMK_CHANGELOG_URL?.trim();\n\tif (explicitUrl) return explicitUrl;\n\treturn undefined;\n}\n\n/** Get the share viewer URL for a gist ID */\nexport function getShareViewerUrl(gistId: string): string {\n\tconst configuredUrl = readAliasedEnv(ENV_SHARE_VIEWER_URL_ALIASES);\n\tif (configuredUrl) {\n\t\treturn configuredUrl.includes(\"{gistId}\")\n\t\t\t? configuredUrl.replaceAll(\"{gistId}\", gistId)\n\t\t\t: `${configuredUrl}#${gistId}`;\n\t}\n\treturn `https://gist.github.com/${gistId}`;\n}\n\n// =============================================================================\n// User Config Paths (~/.omk/agent/*)\n// =============================================================================\n\n/** Get the agent config directory (e.g., ~/.omk/agent/) */\nexport function getAgentDir(): string {\n\tconst envDir = readAliasedEnv(ENV_AGENT_DIR_ALIASES);\n\tif (envDir) {\n\t\treturn expandTildePath(envDir);\n\t}\n\treturn join(homedir(), CONFIG_DIR_NAME, \"agent\");\n}\n\n/** Get path to user's custom themes directory */\nexport function getCustomThemesDir(): string {\n\treturn join(getAgentDir(), \"themes\");\n}\n\n/** Get path to models.json */\nexport function getModelsPath(): string {\n\treturn join(getAgentDir(), \"models.json\");\n}\n\n/** Get path to auth.json */\nexport function getAuthPath(): string {\n\treturn join(getAgentDir(), \"auth.json\");\n}\n\n/** Get path to settings.json */\nexport function getSettingsPath(): string {\n\treturn join(getAgentDir(), \"settings.json\");\n}\n\n/** Get path to tools directory */\nexport function getToolsDir(): string {\n\treturn join(getAgentDir(), \"tools\");\n}\n\n/** Get path to managed binaries directory (fd, rg) */\nexport function getBinDir(): string {\n\treturn join(getAgentDir(), \"bin\");\n}\n\n/** Get path to prompt templates directory */\nexport function getPromptsDir(): string {\n\treturn join(getAgentDir(), \"prompts\");\n}\n\n/** Get path to sessions directory */\nexport function getSessionsDir(): string {\n\treturn join(getAgentDir(), \"sessions\");\n}\n\n/** Get path to debug log file */\nexport function getDebugLogPath(): string {\n\treturn join(getAgentDir(), `${APP_NAME}-debug.log`);\n}\n"]}