@agimon-ai/po-core 0.0.0-alpha.2 → 0.0.0-alpha.21

package/dist/src/services/piSettings/core.cjs

@@ -0,0 +1,308 @@
+const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
+const require_index = require("../platformFiles/index.cjs");
+const require_core = require("../json/core.cjs");
+require("../../../runtimeJson.cjs");
+const require_index$1 = require("../nodeHost/index.cjs");
+const require_core$1 = require("../poPackage/core.cjs");
+const require_index$2 = require("../serialRunner/index.cjs");
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+//#region src/services/piSettings/core.ts
+/**
+* Pi's user settings, as `po sync` maintains them.
+*
+* The Po package is registered globally so a plain `pi` process can find the
+* lightweight package bootstrap before project resources are trusted. Sync owns
+* the extension registration, ambient-discovery filter, theme resource, selected default theme, and quiet-startup keys
+* while preserving every unrelated user setting.
+*/
+const PI_CODING_AGENT_DIR_ENV = "PI_CODING_AGENT_DIR";
+/** Moves Po's whole home, agent directory included, away from `~/.po`. */
+const PO_HOME_ENV = "PO_HOME";
+/** The folder name of Po's home and of a repository's own configuration. */
+const PO_HOME_DIRECTORY = ".po";
+/** Plain Pi's home, whose agent directory Po falls back to for model config. */
+const PI_HOME_DIRECTORY = ".pi";
+/** The agent folder inside a Po or Pi home. */
+const AGENT_DIRECTORY = "agent";
+const RUNTIME_DIRECTORY = "runtime";
+const SETTINGS_FILE = "settings.json";
+/** Credentials file inside an agent directory. */
+const AUTH_FILE = "auth.json";
+/** Custom provider file inside an agent directory. */
+const MODELS_FILE = "models.json";
+const THEMES_DIRECTORY = "themes";
+const EXTENSIONS_KEY = "extensions";
+const THEMES_KEY = "themes";
+const THEME_KEY = "theme";
+const QUIET_STARTUP_KEY = "quietStartup";
+const PO_THEME_NAME = "po-dark";
+/** File name of the synchronized Po theme. */
+const PO_THEME_FILE = `${PO_THEME_NAME}.json`;
+const AGIMON_SCOPE_PREFIX = "@agimon-ai/";
+const NPM_SOURCE_PREFIX = "npm:";
+const HOME_ALIAS = "~";
+const HOME_ALIAS_PREFIX = "~/";
+/** The stable package entry Pi loads for every synced repository. */
+const PO_EXTENSION = require_core$1.PO_PACKAGE_NAME;
+/** Suppresses Pi's ambient extension-directory scan while leaving explicit sources intact. */
+const AMBIENT_EXTENSION_FILTER = "!extensions/**";
+/**
+* Pi built-in extensions kept off under Po. po-mcp owns `/mcp` and MCP servers. Codemode and
+* tool search are opt-in in plain Pi, but Po activates every registered tool, so leaving them
+* loaded would declare both to the model in every session.
+*/
+const DISABLED_PI_BUILTINS = [
+	"-builtin:mcp",
+	"-builtin:codemode",
+	"-builtin:tool-search"
+];
+/** Ownership marker `po init` wrote into the dispatcher package manifest. */
+const PO_DISPATCHER_MARKER = 1;
+/**
+* Expands `~` and resolves a relative path against home, never the cwd, so every
+* Po process lands on the same directory wherever it was started.
+*/
+function resolveConfiguredDirectory(configured, homeDirectory) {
+	if (configured === HOME_ALIAS) return homeDirectory;
+	if (configured.startsWith(HOME_ALIAS_PREFIX)) return node_path.default.join(homeDirectory, configured.slice(2));
+	return node_path.default.resolve(homeDirectory, configured);
+}
+/**
+* Po's home: config, workspaces, runtime registry and its Pi agent directory.
+* Defaults to `~/.po`; `PO_HOME` moves all of it.
+*/
+function poHomeDirectory(homeDirectory = require_index$1.nodeHost.homeDirectory(), environment = process.env) {
+	const configured = environment[PO_HOME_ENV]?.trim();
+	return configured ? resolveConfiguredDirectory(configured, homeDirectory) : node_path.default.join(homeDirectory, ".po");
+}
+/**
+* The single install root for runtime packages every Po root shares: its
+* `package.json` declares them and its `node_modules` holds them.
+*/
+function poRuntimeDirectory(homeDirectory = require_index$1.nodeHost.homeDirectory(), environment = process.env) {
+	return node_path.default.join(poHomeDirectory(homeDirectory, environment), RUNTIME_DIRECTORY);
+}
+/** True when a `.po` folder at this path would be Po's own home rather than a repository marker. */
+function isPoHomeMarker(marker, homeDirectory = require_index$1.nodeHost.homeDirectory(), environment = process.env) {
+	return marker === node_path.default.resolve(poHomeDirectory(homeDirectory, environment));
+}
+/**
+* True when a directory's `.po` folder exists and is a repository's own configuration.
+*
+* Po's home is `~/.po`, so the home directory carries a `.po` folder too. That folder is
+* the global layer, not a repository marker: walking up from any path under home must not
+* stop at home and treat the global configuration as repository configuration.
+*/
+async function hasRepositoryPoDirectoryAsync(fs, directory, context, homeDirectory = require_index$1.nodeHost.homeDirectory(), environment = process.env) {
+	const marker = node_path.default.resolve(directory, ".po");
+	if (isPoHomeMarker(marker, homeDirectory, environment)) return false;
+	const resolved = await fs.canonicalPath(marker, context);
+	if (!resolved.ok) return false;
+	const info = await fs.fileInfo(resolved.value, context);
+	return info.ok && info.value.kind === "directory";
+}
+/**
+* The Pi agent directory Po runs with. Honors Pi's documented override; every Po
+* entry point sets that override, so the default only applies to library callers.
+*/
+function piAgentDirectory(environment = process.env, homeDirectory = require_index$1.nodeHost.homeDirectory()) {
+	const configured = environment[PI_CODING_AGENT_DIR_ENV]?.trim();
+	if (!configured) return node_path.default.join(poHomeDirectory(homeDirectory, environment), AGENT_DIRECTORY);
+	return resolveConfiguredDirectory(configured, homeDirectory);
+}
+/** True when the directory names a model: credentials, a custom provider, or a default. */
+async function hasModelConfigAsync(fs, agentDirectory, context) {
+	try {
+		return await require_index.pathExists(fs, node_path.default.join(agentDirectory, "models.json"), context) || Object.keys(await require_core.readJsonAsync(fs, node_path.default.join(agentDirectory, "auth.json"), context)).length > 0 || typeof (await require_core.readJsonAsync(fs, piSettingsPath(agentDirectory), context)).defaultProvider === "string";
+	} catch {
+		return true;
+	}
+}
+/**
+* Where Po reads auth.json and models.json from. Po's own agent
+* directory when it names a model; otherwise plain Pi's `~/.pi/agent`, so a user who
+* already set Pi up can start a session before configuring Po.
+*/
+async function modelConfigDirectoryAsync(fs, agentDirectory, context, homeDirectory = require_index$1.nodeHost.homeDirectory()) {
+	if (await hasModelConfigAsync(fs, agentDirectory, context)) return agentDirectory;
+	const pi = node_path.default.join(homeDirectory, ".pi", AGENT_DIRECTORY);
+	return pi !== agentDirectory && await hasModelConfigAsync(fs, pi, context) ? pi : agentDirectory;
+}
+/** Model defaults fall back independently of credentials, only when settings.json is absent. */
+async function modelSettingsDirectoryAsync(fs, agentDirectory, context, homeDirectory = require_index$1.nodeHost.homeDirectory()) {
+	if (await require_index.pathExists(fs, piSettingsPath(agentDirectory), context)) return agentDirectory;
+	const pi = node_path.default.join(homeDirectory, ".pi", AGENT_DIRECTORY);
+	return await require_index.pathExists(fs, piSettingsPath(pi), context) ? pi : agentDirectory;
+}
+function piSettingsPath(agentDirectory) {
+	return node_path.default.join(agentDirectory, SETTINGS_FILE);
+}
+function piThemeDirectory(agentDirectory) {
+	return node_path.default.join(agentDirectory, THEMES_DIRECTORY);
+}
+function stringList(value) {
+	return Array.isArray(value) ? value.filter((entry) => typeof entry === "string") : [];
+}
+function settingsRelativePath(agentDirectory, target) {
+	const relative = node_path.default.relative(agentDirectory, target);
+	if (relative.startsWith("..") || node_path.default.isAbsolute(relative)) return target;
+	return relative.split(node_path.default.sep).join("/");
+}
+function isManagedExtension(value) {
+	const normalized = value.replaceAll("\\", "/");
+	return normalized === PO_EXTENSION || normalized === "!extensions/**" || DISABLED_PI_BUILTINS.includes(normalized);
+}
+function isLegacyPoTheme(value, themeName) {
+	const normalized = value.replaceAll("\\", "/");
+	return normalized.endsWith(`/po/${themeName}.json`) || normalized === `po/${themeName}.json`;
+}
+/** Produces the user settings content for an update, without writing it. */
+function mergePiSettings(current, agentDirectory, update) {
+	const theme = settingsRelativePath(agentDirectory, update.themePath);
+	const extensions = [
+		PO_EXTENSION,
+		AMBIENT_EXTENSION_FILTER,
+		...DISABLED_PI_BUILTINS,
+		...stringList(current[EXTENSIONS_KEY]).filter((value) => !isManagedExtension(value))
+	];
+	const themes = [theme, ...stringList(current[THEMES_KEY]).filter((value) => value !== theme && !isLegacyPoTheme(value, update.themeName))];
+	return {
+		...current,
+		[QUIET_STARTUP_KEY]: true,
+		[EXTENSIONS_KEY]: extensions,
+		[THEMES_KEY]: themes,
+		[THEME_KEY]: typeof current[THEME_KEY] === "string" ? current[THEME_KEY] : update.themeName
+	};
+}
+/** Settings content as a JSON object; non-object JSON counts as empty. */
+function normalizePiSettings(settings) {
+	return require_core.isRecord(settings) ? settings : {};
+}
+async function readPiSettingsAsync(fs, agentDirectory, context) {
+	return normalizePiSettings(await require_core.readJsonAsync(fs, piSettingsPath(agentDirectory), context));
+}
+function serializePiSettings(settings) {
+	return `${JSON.stringify(settings, null, 2)}\n`;
+}
+/** Serialises every read-modify-write of one settings file in this process. */
+const settingsWrites = require_index$2.createSerialRunner();
+/** Merges the Po-owned keys into Pi's user settings file. */
+async function writePiSettingsAsync(fs, agentDirectory, update, context) {
+	const settingsPath = piSettingsPath(agentDirectory);
+	await settingsWrites.forKey(settingsPath)(async () => {
+		const current = await readPiSettingsAsync(fs, agentDirectory, context);
+		await require_index.writeFileAtomic(fs, settingsPath, serializePiSettings(mergePiSettings(current, agentDirectory, update)), context);
+	});
+	return settingsPath;
+}
+/** Whether manifest text is the dispatcher package `po init` generated, by its ownership marker. */
+function isPoDispatcherManifest(content) {
+	try {
+		const parsed = JSON.parse(content);
+		return parsed.name === "@agimon-ai/po" && parsed.poDispatcher === 1;
+	} catch {
+		return false;
+	}
+}
+/** Whether a directory is the dispatcher package `po init` generated, by its manifest ownership marker. */
+async function isPoDispatcherPackageAsync(fs, directory, context) {
+	const result = await fs.readTextFile(node_path.default.join(directory, require_core$1.PACKAGE_MANIFEST), context);
+	return result.ok && isPoDispatcherManifest(result.value);
+}
+/** Where `po init` put its dispatcher package inside an agent directory. */
+function poDispatcherPath(agentDirectory) {
+	return node_path.default.join(agentDirectory, ...require_core$1.PO_PACKAGE_NAME.split("/"));
+}
+/** Where `po sync` put the Po theme inside an agent directory. */
+function poThemePath(agentDirectory) {
+	return node_path.default.join(piThemeDirectory(agentDirectory), PO_THEME_FILE);
+}
+function isOtherAgimonDistribution(value) {
+	const normalized = value.startsWith(NPM_SOURCE_PREFIX) ? value.slice(4) : value;
+	return normalized.startsWith(AGIMON_SCOPE_PREFIX) && normalized !== PO_EXTENSION;
+}
+function isSharedFilter(value) {
+	return value === "!extensions/**" || DISABLED_PI_BUILTINS.includes(value);
+}
+/**
+* The user settings with Po's entries removed, or undefined when no Po entry is present.
+*
+* The shared ambient and built-in filters stay while another `@agimon-ai/*` distribution
+* is still registered, because it relies on the same filters. Unrelated settings are preserved.
+*/
+function prunePoPiSettings(current, agentDirectory) {
+	const themePath = poThemePath(agentDirectory);
+	const extensions = stringList(current[EXTENSIONS_KEY]);
+	const themes = stringList(current[THEMES_KEY]);
+	const isPoTheme = (value) => node_path.default.resolve(agentDirectory, value) === themePath;
+	if (!(extensions.includes(PO_EXTENSION) || themes.some(isPoTheme) || current[THEME_KEY] === PO_THEME_NAME)) return void 0;
+	const keepFilters = extensions.some(isOtherAgimonDistribution);
+	const next = { ...current };
+	if (Array.isArray(current[EXTENSIONS_KEY])) next[EXTENSIONS_KEY] = current[EXTENSIONS_KEY].filter((value) => value !== PO_EXTENSION && (keepFilters || typeof value !== "string" || !isSharedFilter(value)));
+	if (Array.isArray(current[THEMES_KEY])) next[THEMES_KEY] = current[THEMES_KEY].filter((value) => typeof value !== "string" || !isPoTheme(value));
+	if (current[THEME_KEY] === PO_THEME_NAME) delete next[THEME_KEY];
+	return next;
+}
+/**
+* Removes the entries `po init` and older `po sync` runs added to Pi's user agent directory.
+*
+* Nothing is written when no Po entry is present. Returns the paths and entries it removed.
+*/
+async function removePoPiSettingsAsync(fs, agentDirectory, context) {
+	const removed = [];
+	const settingsPath = piSettingsPath(agentDirectory);
+	await settingsWrites.forKey(settingsPath)(async () => {
+		const next = prunePoPiSettings(await readPiSettingsAsync(fs, agentDirectory, context), agentDirectory);
+		if (!next) return;
+		await require_index.writeFileAtomic(fs, settingsPath, serializePiSettings(next), context);
+		removed.push(settingsPath);
+	});
+	const themePath = poThemePath(agentDirectory);
+	const theme = await fs.fileInfo(themePath, context);
+	if (theme.ok && theme.value.kind === "file") {
+		await require_index.removePath(fs, themePath, context);
+		removed.push(themePath);
+	}
+	const dispatcher = poDispatcherPath(agentDirectory);
+	const dispatcherInfo = await fs.fileInfo(dispatcher, context);
+	if (dispatcherInfo.ok && dispatcherInfo.value.kind === "directory" && await isPoDispatcherPackageAsync(fs, dispatcher, context)) {
+		await require_index.removePath(fs, dispatcher, context);
+		removed.push(dispatcher);
+	}
+	return removed;
+}
+//#endregion
+exports.AGENT_DIRECTORY = AGENT_DIRECTORY;
+exports.AMBIENT_EXTENSION_FILTER = AMBIENT_EXTENSION_FILTER;
+exports.AUTH_FILE = AUTH_FILE;
+exports.DISABLED_PI_BUILTINS = DISABLED_PI_BUILTINS;
+exports.MODELS_FILE = MODELS_FILE;
+exports.PI_HOME_DIRECTORY = PI_HOME_DIRECTORY;
+exports.PO_DISPATCHER_MARKER = PO_DISPATCHER_MARKER;
+exports.PO_EXTENSION = PO_EXTENSION;
+exports.PO_HOME_DIRECTORY = PO_HOME_DIRECTORY;
+exports.PO_HOME_ENV = PO_HOME_ENV;
+exports.PO_THEME_FILE = PO_THEME_FILE;
+exports.hasRepositoryPoDirectoryAsync = hasRepositoryPoDirectoryAsync;
+exports.isPoDispatcherManifest = isPoDispatcherManifest;
+exports.isPoDispatcherPackageAsync = isPoDispatcherPackageAsync;
+exports.isPoHomeMarker = isPoHomeMarker;
+exports.mergePiSettings = mergePiSettings;
+exports.modelConfigDirectoryAsync = modelConfigDirectoryAsync;
+exports.modelSettingsDirectoryAsync = modelSettingsDirectoryAsync;
+exports.normalizePiSettings = normalizePiSettings;
+exports.piAgentDirectory = piAgentDirectory;
+exports.piSettingsPath = piSettingsPath;
+exports.piThemeDirectory = piThemeDirectory;
+exports.poDispatcherPath = poDispatcherPath;
+exports.poHomeDirectory = poHomeDirectory;
+exports.poRuntimeDirectory = poRuntimeDirectory;
+exports.poThemePath = poThemePath;
+exports.prunePoPiSettings = prunePoPiSettings;
+exports.readPiSettingsAsync = readPiSettingsAsync;
+exports.removePoPiSettingsAsync = removePoPiSettingsAsync;
+exports.serializePiSettings = serializePiSettings;
+exports.writePiSettingsAsync = writePiSettingsAsync;
+
+//# sourceMappingURL=core.cjs.map

package/dist/src/services/piSettings/core.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.cjs","names":["PO_PACKAGE_NAME","path","nodeHost","pathExists","readJsonAsync","isRecord","createSerialRunner","writeFileAtomic","PACKAGE_MANIFEST","removePath"],"sources":["../../../../src/services/piSettings/core.ts"],"sourcesContent":["import path from 'node:path';\n\nimport type { Context } from '@earendil-works/chord';\nimport type { FileSystem } from '@earendil-works/pi-durable/env';\n\nimport { isRecord, readJsonAsync } from '../json';\nimport type { JsonObject } from '../json';\nimport { nodeHost } from '../nodeHost';\nimport { pathExists, removePath, writeFileAtomic } from '../platformFiles';\nimport { PO_PACKAGE_NAME, PACKAGE_MANIFEST } from '../poPackage';\nimport { createSerialRunner } from '../serialRunner';\n\n/**\n * Pi's user settings, as `po sync` maintains them.\n *\n * The Po package is registered globally so a plain `pi` process can find the\n * lightweight package bootstrap before project resources are trusted. Sync owns\n * the extension registration, ambient-discovery filter, theme resource, selected default theme, and quiet-startup keys\n * while preserving every unrelated user setting.\n */\n\nconst PI_CODING_AGENT_DIR_ENV = 'PI_CODING_AGENT_DIR';\n/** Moves Po's whole home, agent directory included, away from `~/.po`. */\nexport const PO_HOME_ENV = 'PO_HOME';\n/** The folder name of Po's home and of a repository's own configuration. */\nexport const PO_HOME_DIRECTORY = '.po';\n/** Plain Pi's home, whose agent directory Po falls back to for model config. */\nexport const PI_HOME_DIRECTORY = '.pi';\n/** The agent folder inside a Po or Pi home. */\nexport const AGENT_DIRECTORY = 'agent';\nconst RUNTIME_DIRECTORY = 'runtime';\nconst SETTINGS_FILE = 'settings.json';\n/** Credentials file inside an agent directory. */\nexport const AUTH_FILE = 'auth.json';\n/** Custom provider file inside an agent directory. */\nexport const MODELS_FILE = 'models.json';\nconst THEMES_DIRECTORY = 'themes';\nconst EXTENSIONS_KEY = 'extensions';\nconst THEMES_KEY = 'themes';\nconst THEME_KEY = 'theme';\nconst QUIET_STARTUP_KEY = 'quietStartup';\nconst PO_THEME_NAME = 'po-dark';\n/** File name of the synchronized Po theme. */\nexport const PO_THEME_FILE = `${PO_THEME_NAME}.json`;\nconst AGIMON_SCOPE_PREFIX = '@agimon-ai/';\nconst NPM_SOURCE_PREFIX = 'npm:';\nconst HOME_ALIAS = '~';\nconst HOME_ALIAS_PREFIX = '~/';\n/** The stable package entry Pi loads for every synced repository. */\nexport const PO_EXTENSION = PO_PACKAGE_NAME;\n/** Suppresses Pi's ambient extension-directory scan while leaving explicit sources intact. */\nexport const AMBIENT_EXTENSION_FILTER = '!extensions/**';\n/**\n * Pi built-in extensions kept off under Po. po-mcp owns `/mcp` and MCP servers. Codemode and\n * tool search are opt-in in plain Pi, but Po activates every registered tool, so leaving them\n * loaded would declare both to the model in every session.\n */\nexport const DISABLED_PI_BUILTINS: readonly string[] = ['-builtin:mcp', '-builtin:codemode', '-builtin:tool-search'];\n/** Ownership marker `po init` wrote into the dispatcher package manifest. */\nexport const PO_DISPATCHER_MARKER = 1;\nexport interface PiSettingsUpdate {\n  /** Absolute path to the synchronized user theme file. */\n  themePath: string;\n  themeName: string;\n}\n\n/**\n * Expands `~` and resolves a relative path against home, never the cwd, so every\n * Po process lands on the same directory wherever it was started.\n */\nfunction resolveConfiguredDirectory(configured: string, homeDirectory: string): string {\n  if (configured === HOME_ALIAS) return homeDirectory;\n  if (configured.startsWith(HOME_ALIAS_PREFIX)) {\n    return path.join(homeDirectory, configured.slice(HOME_ALIAS_PREFIX.length));\n  }\n  return path.resolve(homeDirectory, configured);\n}\n\n/**\n * Po's home: config, workspaces, runtime registry and its Pi agent directory.\n * Defaults to `~/.po`; `PO_HOME` moves all of it.\n */\nexport function poHomeDirectory(\n  homeDirectory: string = nodeHost.homeDirectory(),\n  environment: Readonly<Record<string, string | undefined>> = process.env,\n): string {\n  const configured = environment[PO_HOME_ENV]?.trim();\n  return configured\n    ? resolveConfiguredDirectory(configured, homeDirectory)\n    : path.join(homeDirectory, PO_HOME_DIRECTORY);\n}\n\n/**\n * The single install root for runtime packages every Po root shares: its\n * `package.json` declares them and its `node_modules` holds them.\n */\nexport function poRuntimeDirectory(\n  homeDirectory: string = nodeHost.homeDirectory(),\n  environment: Readonly<Record<string, string | undefined>> = process.env,\n): string {\n  return path.join(poHomeDirectory(homeDirectory, environment), RUNTIME_DIRECTORY);\n}\n\n/** True when a `.po` folder at this path would be Po's own home rather than a repository marker. */\nexport function isPoHomeMarker(\n  marker: string,\n  homeDirectory: string = nodeHost.homeDirectory(),\n  environment: Readonly<Record<string, string | undefined>> = process.env,\n): boolean {\n  return marker === path.resolve(poHomeDirectory(homeDirectory, environment));\n}\n\n/**\n * True when a directory's `.po` folder exists and is a repository's own configuration.\n *\n * Po's home is `~/.po`, so the home directory carries a `.po` folder too. That folder is\n * the global layer, not a repository marker: walking up from any path under home must not\n * stop at home and treat the global configuration as repository configuration.\n */\nexport async function hasRepositoryPoDirectoryAsync(\n  fs: FileSystem,\n  directory: string,\n  context: Context,\n  homeDirectory: string = nodeHost.homeDirectory(),\n  environment: Readonly<Record<string, string | undefined>> = process.env,\n): Promise<boolean> {\n  const marker = path.resolve(directory, PO_HOME_DIRECTORY);\n  if (isPoHomeMarker(marker, homeDirectory, environment)) return false;\n  const resolved = await fs.canonicalPath(marker, context);\n  if (!resolved.ok) return false;\n  const info = await fs.fileInfo(resolved.value, context);\n  // No readable `.po` folder here, so this directory is not marked as a repository.\n  return info.ok && info.value.kind === 'directory';\n}\n\n/**\n * The Pi agent directory Po runs with. Honors Pi's documented override; every Po\n * entry point sets that override, so the default only applies to library callers.\n */\nexport function piAgentDirectory(\n  environment: Readonly<Record<string, string | undefined>> = process.env,\n  homeDirectory: string = nodeHost.homeDirectory(),\n): string {\n  const configured = environment[PI_CODING_AGENT_DIR_ENV]?.trim();\n  if (!configured) return path.join(poHomeDirectory(homeDirectory, environment), AGENT_DIRECTORY);\n  return resolveConfiguredDirectory(configured, homeDirectory);\n}\n\n/** True when the directory names a model: credentials, a custom provider, or a default. */\nasync function hasModelConfigAsync(fs: FileSystem, agentDirectory: string, context: Context): Promise<boolean> {\n  try {\n    return (\n      (await pathExists(fs, path.join(agentDirectory, MODELS_FILE), context)) ||\n      Object.keys(await readJsonAsync(fs, path.join(agentDirectory, AUTH_FILE), context)).length > 0 ||\n      typeof (await readJsonAsync(fs, piSettingsPath(agentDirectory), context)).defaultProvider === 'string'\n    );\n  } catch {\n    // A malformed file is still the user's config: surface its error rather than switch away.\n    return true;\n  }\n}\n\n/**\n * Where Po reads auth.json and models.json from. Po's own agent\n * directory when it names a model; otherwise plain Pi's `~/.pi/agent`, so a user who\n * already set Pi up can start a session before configuring Po.\n */\nexport async function modelConfigDirectoryAsync(\n  fs: FileSystem,\n  agentDirectory: string,\n  context: Context,\n  homeDirectory: string = nodeHost.homeDirectory(),\n): Promise<string> {\n  if (await hasModelConfigAsync(fs, agentDirectory, context)) return agentDirectory;\n  const pi = path.join(homeDirectory, PI_HOME_DIRECTORY, AGENT_DIRECTORY);\n  return pi !== agentDirectory && (await hasModelConfigAsync(fs, pi, context)) ? pi : agentDirectory;\n}\n\n/** Model defaults fall back independently of credentials, only when settings.json is absent. */\nexport async function modelSettingsDirectoryAsync(\n  fs: FileSystem,\n  agentDirectory: string,\n  context: Context,\n  homeDirectory: string = nodeHost.homeDirectory(),\n): Promise<string> {\n  if (await pathExists(fs, piSettingsPath(agentDirectory), context)) return agentDirectory;\n  const pi = path.join(homeDirectory, PI_HOME_DIRECTORY, AGENT_DIRECTORY);\n  return (await pathExists(fs, piSettingsPath(pi), context)) ? pi : agentDirectory;\n}\n\nexport function piSettingsPath(agentDirectory: string): string {\n  return path.join(agentDirectory, SETTINGS_FILE);\n}\n\nexport function piThemeDirectory(agentDirectory: string): string {\n  return path.join(agentDirectory, THEMES_DIRECTORY);\n}\n\nfunction stringList(value: unknown): string[] {\n  return Array.isArray(value) ? value.filter((entry): entry is string => typeof entry === 'string') : [];\n}\n\nfunction settingsRelativePath(agentDirectory: string, target: string): string {\n  const relative = path.relative(agentDirectory, target);\n  if (relative.startsWith('..') || path.isAbsolute(relative)) return target;\n  return relative.split(path.sep).join('/');\n}\n\nfunction isManagedExtension(value: string): boolean {\n  const normalized = value.replaceAll('\\\\', '/');\n  return (\n    normalized === PO_EXTENSION || normalized === AMBIENT_EXTENSION_FILTER || DISABLED_PI_BUILTINS.includes(normalized)\n  );\n}\n\nfunction isLegacyPoTheme(value: string, themeName: string): boolean {\n  const normalized = value.replaceAll('\\\\', '/');\n  return normalized.endsWith(`/po/${themeName}.json`) || normalized === `po/${themeName}.json`;\n}\n\n/** Produces the user settings content for an update, without writing it. */\nexport function mergePiSettings(current: JsonObject, agentDirectory: string, update: PiSettingsUpdate): JsonObject {\n  const theme = settingsRelativePath(agentDirectory, update.themePath);\n  // First in the list, so the harness environment is hydrated before any\n  // extension a user added themselves runs. The filter affects only Pi's\n  // automatic extensions/** scan; explicit settings and CLI entries still load.\n  const extensions = [\n    PO_EXTENSION,\n    AMBIENT_EXTENSION_FILTER,\n    ...DISABLED_PI_BUILTINS,\n    ...stringList(current[EXTENSIONS_KEY]).filter((value) => !isManagedExtension(value)),\n  ];\n  const themes = [\n    theme,\n    ...stringList(current[THEMES_KEY]).filter((value) => value !== theme && !isLegacyPoTheme(value, update.themeName)),\n  ];\n  return {\n    ...current,\n    [QUIET_STARTUP_KEY]: true,\n    [EXTENSIONS_KEY]: extensions,\n    [THEMES_KEY]: themes,\n    // Only filled in when unset: a theme the user picked later is their choice,\n    // and re-imposing the Po theme on every sync would silently undo it.\n    [THEME_KEY]: typeof current[THEME_KEY] === 'string' ? current[THEME_KEY] : update.themeName,\n  };\n}\n\n/** Settings content as a JSON object; non-object JSON counts as empty. */\nexport function normalizePiSettings(settings: unknown): JsonObject {\n  return isRecord(settings) ? settings : {};\n}\n\nexport async function readPiSettingsAsync(\n  fs: FileSystem,\n  agentDirectory: string,\n  context: Context,\n): Promise<JsonObject> {\n  return normalizePiSettings(await readJsonAsync(fs, piSettingsPath(agentDirectory), context));\n}\n\nexport function serializePiSettings(settings: JsonObject): string {\n  return `${JSON.stringify(settings, null, 2)}\\n`;\n}\n\n/** Serialises every read-modify-write of one settings file in this process. */\nconst settingsWrites = createSerialRunner();\n\n/** Merges the Po-owned keys into Pi's user settings file. */\nexport async function writePiSettingsAsync(\n  fs: FileSystem,\n  agentDirectory: string,\n  update: PiSettingsUpdate,\n  context: Context,\n): Promise<string> {\n  const settingsPath = piSettingsPath(agentDirectory);\n  await settingsWrites.forKey(settingsPath)(async () => {\n    const current = await readPiSettingsAsync(fs, agentDirectory, context);\n    await writeFileAtomic(\n      fs,\n      settingsPath,\n      serializePiSettings(mergePiSettings(current, agentDirectory, update)),\n      context,\n    );\n  });\n  return settingsPath;\n}\n\n/** Whether manifest text is the dispatcher package `po init` generated, by its ownership marker. */\nexport function isPoDispatcherManifest(content: string): boolean {\n  try {\n    const parsed = JSON.parse(content) as { name?: unknown; poDispatcher?: unknown };\n    return parsed.name === PO_PACKAGE_NAME && parsed.poDispatcher === PO_DISPATCHER_MARKER;\n  } catch {\n    // Unparseable manifest text is not the dispatcher's.\n    return false;\n  }\n}\n\n/** Whether a directory is the dispatcher package `po init` generated, by its manifest ownership marker. */\nexport async function isPoDispatcherPackageAsync(\n  fs: FileSystem,\n  directory: string,\n  context: Context,\n): Promise<boolean> {\n  const result = await fs.readTextFile(path.join(directory, PACKAGE_MANIFEST), context);\n  return result.ok && isPoDispatcherManifest(result.value);\n}\n\n/** Where `po init` put its dispatcher package inside an agent directory. */\nexport function poDispatcherPath(agentDirectory: string): string {\n  return path.join(agentDirectory, ...PO_PACKAGE_NAME.split('/'));\n}\n\n/** Where `po sync` put the Po theme inside an agent directory. */\nexport function poThemePath(agentDirectory: string): string {\n  return path.join(piThemeDirectory(agentDirectory), PO_THEME_FILE);\n}\n\nfunction isOtherAgimonDistribution(value: string): boolean {\n  const normalized = value.startsWith(NPM_SOURCE_PREFIX) ? value.slice(NPM_SOURCE_PREFIX.length) : value;\n  return normalized.startsWith(AGIMON_SCOPE_PREFIX) && normalized !== PO_EXTENSION;\n}\n\nfunction isSharedFilter(value: string): boolean {\n  return value === AMBIENT_EXTENSION_FILTER || DISABLED_PI_BUILTINS.includes(value);\n}\n\n/**\n * The user settings with Po's entries removed, or undefined when no Po entry is present.\n *\n * The shared ambient and built-in filters stay while another `@agimon-ai/*` distribution\n * is still registered, because it relies on the same filters. Unrelated settings are preserved.\n */\nexport function prunePoPiSettings(current: JsonObject, agentDirectory: string): JsonObject | undefined {\n  const themePath = poThemePath(agentDirectory);\n  const extensions = stringList(current[EXTENSIONS_KEY]);\n  const themes = stringList(current[THEMES_KEY]);\n  const isPoTheme = (value: string) => path.resolve(agentDirectory, value) === themePath;\n  const hasPoSettings =\n    extensions.includes(PO_EXTENSION) || themes.some(isPoTheme) || current[THEME_KEY] === PO_THEME_NAME;\n  if (!hasPoSettings) return undefined;\n\n  const keepFilters = extensions.some(isOtherAgimonDistribution);\n  const next: JsonObject = { ...current };\n  if (Array.isArray(current[EXTENSIONS_KEY])) {\n    next[EXTENSIONS_KEY] = (current[EXTENSIONS_KEY] as unknown[]).filter(\n      (value) => value !== PO_EXTENSION && (keepFilters || typeof value !== 'string' || !isSharedFilter(value)),\n    );\n  }\n  if (Array.isArray(current[THEMES_KEY])) {\n    next[THEMES_KEY] = (current[THEMES_KEY] as unknown[]).filter(\n      (value) => typeof value !== 'string' || !isPoTheme(value),\n    );\n  }\n  if (current[THEME_KEY] === PO_THEME_NAME) delete next[THEME_KEY];\n  return next;\n}\n\n/**\n * Removes the entries `po init` and older `po sync` runs added to Pi's user agent directory.\n *\n * Nothing is written when no Po entry is present. Returns the paths and entries it removed.\n */\nexport async function removePoPiSettingsAsync(\n  fs: FileSystem,\n  agentDirectory: string,\n  context: Context,\n): Promise<string[]> {\n  const removed: string[] = [];\n  const settingsPath = piSettingsPath(agentDirectory);\n  await settingsWrites.forKey(settingsPath)(async () => {\n    const next = prunePoPiSettings(await readPiSettingsAsync(fs, agentDirectory, context), agentDirectory);\n    if (!next) return;\n    await writeFileAtomic(fs, settingsPath, serializePiSettings(next), context);\n    removed.push(settingsPath);\n  });\n  const themePath = poThemePath(agentDirectory);\n  const theme = await fs.fileInfo(themePath, context);\n  if (theme.ok && theme.value.kind === 'file') {\n    await removePath(fs, themePath, context);\n    removed.push(themePath);\n  }\n  const dispatcher = poDispatcherPath(agentDirectory);\n  const dispatcherInfo = await fs.fileInfo(dispatcher, context);\n  if (\n    dispatcherInfo.ok &&\n    dispatcherInfo.value.kind === 'directory' &&\n    (await isPoDispatcherPackageAsync(fs, dispatcher, context))\n  ) {\n    await removePath(fs, dispatcher, context);\n    removed.push(dispatcher);\n  }\n  return removed;\n}\n"],"mappings":"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"}

package/dist/src/services/piSettings/core.d.mts

@@ -0,0 +1,102 @@
+import { JsonObject } from "../json/core.mjs";
+import "../../../runtimeJson.mjs";
+import { FileSystem } from "@earendil-works/pi-durable/env";
+import { Context } from "@earendil-works/chord";
+//#region src/services/piSettings/core.d.ts
+/** Moves Po's whole home, agent directory included, away from `~/.po`. */
+export declare const PO_HOME_ENV = "PO_HOME";
+/** The folder name of Po's home and of a repository's own configuration. */
+export declare const PO_HOME_DIRECTORY = ".po";
+/** Plain Pi's home, whose agent directory Po falls back to for model config. */
+export declare const PI_HOME_DIRECTORY = ".pi";
+/** The agent folder inside a Po or Pi home. */
+export declare const AGENT_DIRECTORY = "agent";
+/** Credentials file inside an agent directory. */
+export declare const AUTH_FILE = "auth.json";
+/** Custom provider file inside an agent directory. */
+export declare const MODELS_FILE = "models.json";
+/** File name of the synchronized Po theme. */
+export declare const PO_THEME_FILE = "po-dark.json";
+/** The stable package entry Pi loads for every synced repository. */
+export declare const PO_EXTENSION = "@agimon-ai/po";
+/** Suppresses Pi's ambient extension-directory scan while leaving explicit sources intact. */
+export declare const AMBIENT_EXTENSION_FILTER = "!extensions/**";
+/**
+ * Pi built-in extensions kept off under Po. po-mcp owns `/mcp` and MCP servers. Codemode and
+ * tool search are opt-in in plain Pi, but Po activates every registered tool, so leaving them
+ * loaded would declare both to the model in every session.
+ */
+export declare const DISABLED_PI_BUILTINS: readonly string[];
+/** Ownership marker `po init` wrote into the dispatcher package manifest. */
+export declare const PO_DISPATCHER_MARKER = 1;
+export interface PiSettingsUpdate {
+  /** Absolute path to the synchronized user theme file. */
+  themePath: string;
+  themeName: string;
+}
+/**
+ * Po's home: config, workspaces, runtime registry and its Pi agent directory.
+ * Defaults to `~/.po`; `PO_HOME` moves all of it.
+ */
+export declare function poHomeDirectory(homeDirectory?: string, environment?: Readonly<Record<string, string | undefined>>): string;
+/**
+ * The single install root for runtime packages every Po root shares: its
+ * `package.json` declares them and its `node_modules` holds them.
+ */
+export declare function poRuntimeDirectory(homeDirectory?: string, environment?: Readonly<Record<string, string | undefined>>): string;
+/** True when a `.po` folder at this path would be Po's own home rather than a repository marker. */
+export declare function isPoHomeMarker(marker: string, homeDirectory?: string, environment?: Readonly<Record<string, string | undefined>>): boolean;
+/**
+ * True when a directory's `.po` folder exists and is a repository's own configuration.
+ *
+ * Po's home is `~/.po`, so the home directory carries a `.po` folder too. That folder is
+ * the global layer, not a repository marker: walking up from any path under home must not
+ * stop at home and treat the global configuration as repository configuration.
+ */
+export declare function hasRepositoryPoDirectoryAsync(fs: FileSystem, directory: string, context: Context, homeDirectory?: string, environment?: Readonly<Record<string, string | undefined>>): Promise<boolean>;
+/**
+ * The Pi agent directory Po runs with. Honors Pi's documented override; every Po
+ * entry point sets that override, so the default only applies to library callers.
+ */
+export declare function piAgentDirectory(environment?: Readonly<Record<string, string | undefined>>, homeDirectory?: string): string;
+/**
+ * Where Po reads auth.json and models.json from. Po's own agent
+ * directory when it names a model; otherwise plain Pi's `~/.pi/agent`, so a user who
+ * already set Pi up can start a session before configuring Po.
+ */
+export declare function modelConfigDirectoryAsync(fs: FileSystem, agentDirectory: string, context: Context, homeDirectory?: string): Promise<string>;
+/** Model defaults fall back independently of credentials, only when settings.json is absent. */
+export declare function modelSettingsDirectoryAsync(fs: FileSystem, agentDirectory: string, context: Context, homeDirectory?: string): Promise<string>;
+export declare function piSettingsPath(agentDirectory: string): string;
+export declare function piThemeDirectory(agentDirectory: string): string;
+/** Produces the user settings content for an update, without writing it. */
+export declare function mergePiSettings(current: JsonObject, agentDirectory: string, update: PiSettingsUpdate): JsonObject;
+/** Settings content as a JSON object; non-object JSON counts as empty. */
+export declare function normalizePiSettings(settings: unknown): JsonObject;
+export declare function readPiSettingsAsync(fs: FileSystem, agentDirectory: string, context: Context): Promise<JsonObject>;
+export declare function serializePiSettings(settings: JsonObject): string;
+/** Merges the Po-owned keys into Pi's user settings file. */
+export declare function writePiSettingsAsync(fs: FileSystem, agentDirectory: string, update: PiSettingsUpdate, context: Context): Promise<string>;
+/** Whether manifest text is the dispatcher package `po init` generated, by its ownership marker. */
+export declare function isPoDispatcherManifest(content: string): boolean;
+/** Whether a directory is the dispatcher package `po init` generated, by its manifest ownership marker. */
+export declare function isPoDispatcherPackageAsync(fs: FileSystem, directory: string, context: Context): Promise<boolean>;
+/** Where `po init` put its dispatcher package inside an agent directory. */
+export declare function poDispatcherPath(agentDirectory: string): string;
+/** Where `po sync` put the Po theme inside an agent directory. */
+export declare function poThemePath(agentDirectory: string): string;
+/**
+ * The user settings with Po's entries removed, or undefined when no Po entry is present.
+ *
+ * The shared ambient and built-in filters stay while another `@agimon-ai/*` distribution
+ * is still registered, because it relies on the same filters. Unrelated settings are preserved.
+ */
+export declare function prunePoPiSettings(current: JsonObject, agentDirectory: string): JsonObject | undefined;
+/**
+ * Removes the entries `po init` and older `po sync` runs added to Pi's user agent directory.
+ *
+ * Nothing is written when no Po entry is present. Returns the paths and entries it removed.
+ */
+export declare function removePoPiSettingsAsync(fs: FileSystem, agentDirectory: string, context: Context): Promise<string[]>;
+//#endregion
+//# sourceMappingURL=core.d.mts.map

package/dist/src/services/piSettings/core.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.mts","names":[],"sources":["../../../../src/services/piSettings/core.ts"],"mappings":";;;;;;qBAuBa;;qBAEA;;qBAEA;;qBAEA;;qBAIA;;qBAEA;;qBAQA;;qBAMA;;qBAEA;;;;;;qBAMA;;qBAEA;iBACI;;EAEf;EACA;;;;;;wBAmBc,gBACd,wBACA,cAAa,SAAS;;;;;wBAYR,mBACd,wBACA,cAAa,SAAS;;wBAMR,eACd,gBACA,wBACA,cAAa,SAAS;;;;;;;;wBAYF,8BACpB,IAAI,YACJ,mBACA,SAAS,SACT,wBACA,cAAa,SAAS,sCACrB;;;;;wBAca,iBACd,cAAa,SAAS,qCACtB;;;;;;wBA0BoB,0BACpB,IAAI,YACJ,wBACA,SAAS,SACT,yBACC;;wBAOmB,4BACpB,IAAI,YACJ,wBACA,SAAS,SACT,yBACC;wBAMa,eAAe;wBAIf,iBAAiB;;wBA2BjB,gBAAgB,SAAS,YAAY,wBAAwB,QAAQ,mBAAmB;;wBA2BxF,oBAAoB,oBAAoB;wBAIlC,oBACpB,IAAI,YACJ,wBACA,SAAS,UACR,QAAQ;wBAIK,oBAAoB,UAAU;;wBAQxB,qBACpB,IAAI,YACJ,wBACA,QAAQ,kBACR,SAAS,UACR;;wBAea,uBAAuB;;wBAWjB,2BACpB,IAAI,YACJ,mBACA,SAAS,UACR;;wBAMa,iBAAiB;;wBAKjB,YAAY;;;;;;;wBAmBZ,kBAAkB,SAAS,YAAY,yBAAyB;;;;;;wBA8B1D,wBACpB,IAAI,YACJ,wBACA,SAAS,UACR"}