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

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

@@ -0,0 +1,276 @@
+import { pathExists, removePath, writeFileAtomic } from "../platformFiles/index.mjs";
+import { isRecord, readJsonAsync } from "../json/core.mjs";
+import "../../../runtimeJson.mjs";
+import { nodeHost } from "../nodeHost/index.mjs";
+import { PACKAGE_MANIFEST, PO_PACKAGE_NAME } from "../poPackage/core.mjs";
+import { createSerialRunner } from "../serialRunner/index.mjs";
+import path from "node:path";
+//#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 = 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 path.join(homeDirectory, configured.slice(2));
+	return path.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 = nodeHost.homeDirectory(), environment = process.env) {
+	const configured = environment[PO_HOME_ENV]?.trim();
+	return configured ? resolveConfiguredDirectory(configured, homeDirectory) : path.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 = nodeHost.homeDirectory(), environment = process.env) {
+	return path.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 = nodeHost.homeDirectory(), environment = process.env) {
+	return marker === path.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 = nodeHost.homeDirectory(), environment = process.env) {
+	const marker = path.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 = nodeHost.homeDirectory()) {
+	const configured = environment[PI_CODING_AGENT_DIR_ENV]?.trim();
+	if (!configured) return path.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 pathExists(fs, path.join(agentDirectory, "models.json"), context) || Object.keys(await readJsonAsync(fs, path.join(agentDirectory, "auth.json"), context)).length > 0 || typeof (await 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 = nodeHost.homeDirectory()) {
+	if (await hasModelConfigAsync(fs, agentDirectory, context)) return agentDirectory;
+	const pi = path.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 = nodeHost.homeDirectory()) {
+	if (await pathExists(fs, piSettingsPath(agentDirectory), context)) return agentDirectory;
+	const pi = path.join(homeDirectory, ".pi", AGENT_DIRECTORY);
+	return await pathExists(fs, piSettingsPath(pi), context) ? pi : agentDirectory;
+}
+function piSettingsPath(agentDirectory) {
+	return path.join(agentDirectory, SETTINGS_FILE);
+}
+function piThemeDirectory(agentDirectory) {
+	return path.join(agentDirectory, THEMES_DIRECTORY);
+}
+function stringList(value) {
+	return Array.isArray(value) ? value.filter((entry) => typeof entry === "string") : [];
+}
+function settingsRelativePath(agentDirectory, target) {
+	const relative = path.relative(agentDirectory, target);
+	if (relative.startsWith("..") || path.isAbsolute(relative)) return target;
+	return relative.split(path.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 isRecord(settings) ? settings : {};
+}
+async function readPiSettingsAsync(fs, agentDirectory, context) {
+	return normalizePiSettings(await 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 = 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 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(path.join(directory, PACKAGE_MANIFEST), context);
+	return result.ok && isPoDispatcherManifest(result.value);
+}
+/** Where `po init` put its dispatcher package inside an agent directory. */
+function poDispatcherPath(agentDirectory) {
+	return path.join(agentDirectory, ...PO_PACKAGE_NAME.split("/"));
+}
+/** Where `po sync` put the Po theme inside an agent directory. */
+function poThemePath(agentDirectory) {
+	return path.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) => path.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 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 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 removePath(fs, dispatcher, context);
+		removed.push(dispatcher);
+	}
+	return removed;
+}
+//#endregion
+export { AGENT_DIRECTORY, AMBIENT_EXTENSION_FILTER, AUTH_FILE, DISABLED_PI_BUILTINS, MODELS_FILE, PI_HOME_DIRECTORY, PO_DISPATCHER_MARKER, PO_EXTENSION, PO_HOME_DIRECTORY, PO_HOME_ENV, PO_THEME_FILE, hasRepositoryPoDirectoryAsync, isPoDispatcherManifest, isPoDispatcherPackageAsync, isPoHomeMarker, mergePiSettings, modelConfigDirectoryAsync, modelSettingsDirectoryAsync, normalizePiSettings, piAgentDirectory, piSettingsPath, piThemeDirectory, poDispatcherPath, poHomeDirectory, poRuntimeDirectory, poThemePath, prunePoPiSettings, readPiSettingsAsync, removePoPiSettingsAsync, serializePiSettings, writePiSettingsAsync };
+
+//# sourceMappingURL=core.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"core.mjs","names":[],"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/sync.cjs

@@ -0,0 +1,119 @@
+const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
+const require_sync = require("../json/sync.cjs");
+require("../../../runtimeJson.cjs");
+const require_index = require("../nodeHost/index.cjs");
+const require_core = require("../poPackage/core.cjs");
+const require_core$1 = require("./core.cjs");
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs, 1);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+//#region src/services/piSettings/sync.ts
+/**
+* True when a directory's `.po` folder exists and is a repository's own configuration.
+*
+* @deprecated Node-only sync shim; use hasRepositoryPoDirectoryAsync. Removed in M2.
+*/
+function hasRepositoryPoDirectory(directory, homeDirectory = require_index.nodeHost.homeDirectory(), environment = process.env) {
+	const marker = node_path.default.resolve(directory, ".po");
+	if (require_core$1.isPoHomeMarker(marker, homeDirectory, environment)) return false;
+	try {
+		return node_fs.default.statSync(marker).isDirectory();
+	} catch {
+		return false;
+	}
+}
+/** True when the directory names a model: credentials, a custom provider, or a default. */
+function hasModelConfig(agentDirectory) {
+	try {
+		return node_fs.default.existsSync(node_path.default.join(agentDirectory, "models.json")) || Object.keys(require_sync.readJson(node_path.default.join(agentDirectory, "auth.json"))).length > 0 || typeof require_sync.readJson(require_core$1.piSettingsPath(agentDirectory)).defaultProvider === "string";
+	} catch {
+		return true;
+	}
+}
+/**
+* Where Po reads auth.json and models.json from.
+*
+* @deprecated Node-only sync shim; use modelConfigDirectoryAsync. Removed in M2.
+*/
+function modelConfigDirectory(agentDirectory, homeDirectory = require_index.nodeHost.homeDirectory()) {
+	if (hasModelConfig(agentDirectory)) return agentDirectory;
+	const pi = node_path.default.join(homeDirectory, ".pi", require_core$1.AGENT_DIRECTORY);
+	return pi !== agentDirectory && hasModelConfig(pi) ? pi : agentDirectory;
+}
+/**
+* Model defaults fall back independently of credentials, only when settings.json is absent.
+*
+* @deprecated Node-only sync shim; use modelSettingsDirectoryAsync. Removed in M2.
+*/
+function modelSettingsDirectory(agentDirectory, homeDirectory = require_index.nodeHost.homeDirectory()) {
+	if (node_fs.default.existsSync(require_core$1.piSettingsPath(agentDirectory))) return agentDirectory;
+	const pi = node_path.default.join(homeDirectory, ".pi", require_core$1.AGENT_DIRECTORY);
+	return node_fs.default.existsSync(require_core$1.piSettingsPath(pi)) ? pi : agentDirectory;
+}
+/** @deprecated Node-only sync shim; use readPiSettingsAsync. Removed in M2. */
+function readPiSettings(agentDirectory) {
+	return require_core$1.normalizePiSettings(require_sync.readJson(require_core$1.piSettingsPath(agentDirectory)));
+}
+/**
+* Merges the Po-owned keys into Pi's user settings file.
+*
+* @deprecated Node-only sync shim; use writePiSettingsAsync. Removed in M2.
+*/
+function writePiSettings(agentDirectory, update) {
+	const settingsPath = require_core$1.piSettingsPath(agentDirectory);
+	require_sync.writeFileAtomic(settingsPath, require_core$1.serializePiSettings(require_core$1.mergePiSettings(readPiSettings(agentDirectory), agentDirectory, update)));
+	return settingsPath;
+}
+/**
+* Whether a directory is the dispatcher package `po init` generated, by its manifest ownership marker.
+*
+* @deprecated Node-only sync shim; use isPoDispatcherPackageAsync. Removed in M2.
+*/
+function isPoDispatcherPackage(directory) {
+	let content;
+	try {
+		content = node_fs.default.readFileSync(node_path.default.join(directory, require_core.PACKAGE_MANIFEST), "utf8");
+	} catch {
+		return false;
+	}
+	return require_core$1.isPoDispatcherManifest(content);
+}
+/**
+* Removes the entries `po init` and older `po sync` runs added to Pi's user agent directory.
+*
+* @deprecated Node-only sync shim; use removePoPiSettingsAsync. Removed in M2.
+*/
+function removePoPiSettings(agentDirectory) {
+	const removed = [];
+	const settingsPath = require_core$1.piSettingsPath(agentDirectory);
+	const next = require_core$1.prunePoPiSettings(readPiSettings(agentDirectory), agentDirectory);
+	if (next) {
+		require_sync.writeFileAtomic(settingsPath, require_core$1.serializePiSettings(next));
+		removed.push(settingsPath);
+	}
+	const themePath = require_core$1.poThemePath(agentDirectory);
+	if (node_fs.default.lstatSync(themePath, { throwIfNoEntry: false })?.isFile()) {
+		node_fs.default.rmSync(themePath, { force: true });
+		removed.push(themePath);
+	}
+	const dispatcher = require_core$1.poDispatcherPath(agentDirectory);
+	if (node_fs.default.lstatSync(dispatcher, { throwIfNoEntry: false })?.isDirectory() && isPoDispatcherPackage(dispatcher)) {
+		node_fs.default.rmSync(dispatcher, {
+			recursive: true,
+			force: true
+		});
+		removed.push(dispatcher);
+	}
+	return removed;
+}
+//#endregion
+exports.hasRepositoryPoDirectory = hasRepositoryPoDirectory;
+exports.isPoDispatcherPackage = isPoDispatcherPackage;
+exports.modelConfigDirectory = modelConfigDirectory;
+exports.modelSettingsDirectory = modelSettingsDirectory;
+exports.readPiSettings = readPiSettings;
+exports.removePoPiSettings = removePoPiSettings;
+exports.writePiSettings = writePiSettings;
+
+//# sourceMappingURL=sync.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync.cjs","names":["nodeHost","path","isPoHomeMarker","fs","readJson","piSettingsPath","AGENT_DIRECTORY","normalizePiSettings","serializePiSettings","mergePiSettings","PACKAGE_MANIFEST","isPoDispatcherManifest","prunePoPiSettings","poThemePath","poDispatcherPath"],"sources":["../../../../src/services/piSettings/sync.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport { readJson, writeFileAtomic } from '../json';\nimport type { JsonObject } from '../json';\nimport { nodeHost } from '../nodeHost';\nimport { PACKAGE_MANIFEST } from '../poPackage';\nimport {\n  AGENT_DIRECTORY,\n  AUTH_FILE,\n  isPoDispatcherManifest,\n  isPoHomeMarker,\n  mergePiSettings,\n  MODELS_FILE,\n  normalizePiSettings,\n  PI_HOME_DIRECTORY,\n  piSettingsPath,\n  PO_HOME_DIRECTORY,\n  poDispatcherPath,\n  poThemePath,\n  prunePoPiSettings,\n  serializePiSettings,\n} from './core';\nimport type { PiSettingsUpdate } from './core';\n\n/**\n * True when a directory's `.po` folder exists and is a repository's own configuration.\n *\n * @deprecated Node-only sync shim; use hasRepositoryPoDirectoryAsync. Removed in M2.\n */\nexport function hasRepositoryPoDirectory(\n  directory: string,\n  homeDirectory: string = nodeHost.homeDirectory(),\n  environment: Readonly<Record<string, string | undefined>> = process.env,\n): boolean {\n  const marker = path.resolve(directory, PO_HOME_DIRECTORY);\n  if (isPoHomeMarker(marker, homeDirectory, environment)) return false;\n  try {\n    return fs.statSync(marker).isDirectory();\n  } catch {\n    // No readable `.po` folder here, so this directory is not marked as a repository.\n    return false;\n  }\n}\n\n/** True when the directory names a model: credentials, a custom provider, or a default. */\nfunction hasModelConfig(agentDirectory: string): boolean {\n  try {\n    return (\n      fs.existsSync(path.join(agentDirectory, MODELS_FILE)) ||\n      Object.keys(readJson(path.join(agentDirectory, AUTH_FILE))).length > 0 ||\n      typeof readJson(piSettingsPath(agentDirectory)).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.\n *\n * @deprecated Node-only sync shim; use modelConfigDirectoryAsync. Removed in M2.\n */\nexport function modelConfigDirectory(agentDirectory: string, homeDirectory: string = nodeHost.homeDirectory()): string {\n  if (hasModelConfig(agentDirectory)) return agentDirectory;\n  const pi = path.join(homeDirectory, PI_HOME_DIRECTORY, AGENT_DIRECTORY);\n  return pi !== agentDirectory && hasModelConfig(pi) ? pi : agentDirectory;\n}\n\n/**\n * Model defaults fall back independently of credentials, only when settings.json is absent.\n *\n * @deprecated Node-only sync shim; use modelSettingsDirectoryAsync. Removed in M2.\n */\nexport function modelSettingsDirectory(\n  agentDirectory: string,\n  homeDirectory: string = nodeHost.homeDirectory(),\n): string {\n  if (fs.existsSync(piSettingsPath(agentDirectory))) return agentDirectory;\n  const pi = path.join(homeDirectory, PI_HOME_DIRECTORY, AGENT_DIRECTORY);\n  return fs.existsSync(piSettingsPath(pi)) ? pi : agentDirectory;\n}\n\n/** @deprecated Node-only sync shim; use readPiSettingsAsync. Removed in M2. */\nexport function readPiSettings(agentDirectory: string): JsonObject {\n  return normalizePiSettings(readJson(piSettingsPath(agentDirectory)));\n}\n\n/**\n * Merges the Po-owned keys into Pi's user settings file.\n *\n * @deprecated Node-only sync shim; use writePiSettingsAsync. Removed in M2.\n */\nexport function writePiSettings(agentDirectory: string, update: PiSettingsUpdate): string {\n  const settingsPath = piSettingsPath(agentDirectory);\n  writeFileAtomic(\n    settingsPath,\n    serializePiSettings(mergePiSettings(readPiSettings(agentDirectory), agentDirectory, update)),\n  );\n  return settingsPath;\n}\n\n/**\n * Whether a directory is the dispatcher package `po init` generated, by its manifest ownership marker.\n *\n * @deprecated Node-only sync shim; use isPoDispatcherPackageAsync. Removed in M2.\n */\nexport function isPoDispatcherPackage(directory: string): boolean {\n  let content: string;\n  try {\n    content = fs.readFileSync(path.join(directory, PACKAGE_MANIFEST), 'utf8');\n  } catch {\n    // No readable manifest, so it is not the dispatcher package.\n    return false;\n  }\n  return isPoDispatcherManifest(content);\n}\n\n/**\n * Removes the entries `po init` and older `po sync` runs added to Pi's user agent directory.\n *\n * @deprecated Node-only sync shim; use removePoPiSettingsAsync. Removed in M2.\n */\nexport function removePoPiSettings(agentDirectory: string): string[] {\n  const removed: string[] = [];\n  const settingsPath = piSettingsPath(agentDirectory);\n  const next = prunePoPiSettings(readPiSettings(agentDirectory), agentDirectory);\n  if (next) {\n    writeFileAtomic(settingsPath, serializePiSettings(next));\n    removed.push(settingsPath);\n  }\n  const themePath = poThemePath(agentDirectory);\n  if (fs.lstatSync(themePath, { throwIfNoEntry: false })?.isFile()) {\n    fs.rmSync(themePath, { force: true });\n    removed.push(themePath);\n  }\n  const dispatcher = poDispatcherPath(agentDirectory);\n  const stat = fs.lstatSync(dispatcher, { throwIfNoEntry: false });\n  if (stat?.isDirectory() && isPoDispatcherPackage(dispatcher)) {\n    fs.rmSync(dispatcher, { recursive: true, force: true });\n    removed.push(dispatcher);\n  }\n  return removed;\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,44 @@
+import { JsonObject } from "../json/core.mjs";
+import "../../../runtimeJson.mjs";
+import { PiSettingsUpdate } from "./core.mjs";
+//#region src/services/piSettings/sync.d.ts
+/**
+ * True when a directory's `.po` folder exists and is a repository's own configuration.
+ *
+ * @deprecated Node-only sync shim; use hasRepositoryPoDirectoryAsync. Removed in M2.
+ */
+export declare function hasRepositoryPoDirectory(directory: string, homeDirectory?: string, environment?: Readonly<Record<string, string | undefined>>): boolean;
+/**
+ * Where Po reads auth.json and models.json from.
+ *
+ * @deprecated Node-only sync shim; use modelConfigDirectoryAsync. Removed in M2.
+ */
+export declare function modelConfigDirectory(agentDirectory: string, homeDirectory?: string): string;
+/**
+ * Model defaults fall back independently of credentials, only when settings.json is absent.
+ *
+ * @deprecated Node-only sync shim; use modelSettingsDirectoryAsync. Removed in M2.
+ */
+export declare function modelSettingsDirectory(agentDirectory: string, homeDirectory?: string): string;
+/** @deprecated Node-only sync shim; use readPiSettingsAsync. Removed in M2. */
+export declare function readPiSettings(agentDirectory: string): JsonObject;
+/**
+ * Merges the Po-owned keys into Pi's user settings file.
+ *
+ * @deprecated Node-only sync shim; use writePiSettingsAsync. Removed in M2.
+ */
+export declare function writePiSettings(agentDirectory: string, update: PiSettingsUpdate): string;
+/**
+ * Whether a directory is the dispatcher package `po init` generated, by its manifest ownership marker.
+ *
+ * @deprecated Node-only sync shim; use isPoDispatcherPackageAsync. Removed in M2.
+ */
+export declare function isPoDispatcherPackage(directory: string): boolean;
+/**
+ * Removes the entries `po init` and older `po sync` runs added to Pi's user agent directory.
+ *
+ * @deprecated Node-only sync shim; use removePoPiSettingsAsync. Removed in M2.
+ */
+export declare function removePoPiSettings(agentDirectory: string): string[];
+//#endregion
+//# sourceMappingURL=sync.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.mts","names":[],"sources":["../../../../src/services/piSettings/sync.ts"],"mappings":";;;;;;;;;wBA8BgB,yBACd,mBACA,wBACA,cAAa,SAAS;;;;;;wBA+BR,qBAAqB,wBAAwB;;;;;;wBAW7C,uBACd,wBACA;;wBAQc,eAAe,yBAAyB;;;;;;wBASxC,gBAAgB,wBAAwB,QAAQ;;;;;;wBAchD,sBAAsB;;;;;;wBAgBtB,mBAAmB"}

package/dist/src/services/piSettings/sync.mjs

@@ -0,0 +1,110 @@
+import { readJson, writeFileAtomic } from "../json/sync.mjs";
+import "../../../runtimeJson.mjs";
+import { nodeHost } from "../nodeHost/index.mjs";
+import { PACKAGE_MANIFEST } from "../poPackage/core.mjs";
+import { AGENT_DIRECTORY, isPoDispatcherManifest, isPoHomeMarker, mergePiSettings, normalizePiSettings, piSettingsPath, poDispatcherPath, poThemePath, prunePoPiSettings, serializePiSettings } from "./core.mjs";
+import fs from "node:fs";
+import path from "node:path";
+//#region src/services/piSettings/sync.ts
+/**
+* True when a directory's `.po` folder exists and is a repository's own configuration.
+*
+* @deprecated Node-only sync shim; use hasRepositoryPoDirectoryAsync. Removed in M2.
+*/
+function hasRepositoryPoDirectory(directory, homeDirectory = nodeHost.homeDirectory(), environment = process.env) {
+	const marker = path.resolve(directory, ".po");
+	if (isPoHomeMarker(marker, homeDirectory, environment)) return false;
+	try {
+		return fs.statSync(marker).isDirectory();
+	} catch {
+		return false;
+	}
+}
+/** True when the directory names a model: credentials, a custom provider, or a default. */
+function hasModelConfig(agentDirectory) {
+	try {
+		return fs.existsSync(path.join(agentDirectory, "models.json")) || Object.keys(readJson(path.join(agentDirectory, "auth.json"))).length > 0 || typeof readJson(piSettingsPath(agentDirectory)).defaultProvider === "string";
+	} catch {
+		return true;
+	}
+}
+/**
+* Where Po reads auth.json and models.json from.
+*
+* @deprecated Node-only sync shim; use modelConfigDirectoryAsync. Removed in M2.
+*/
+function modelConfigDirectory(agentDirectory, homeDirectory = nodeHost.homeDirectory()) {
+	if (hasModelConfig(agentDirectory)) return agentDirectory;
+	const pi = path.join(homeDirectory, ".pi", AGENT_DIRECTORY);
+	return pi !== agentDirectory && hasModelConfig(pi) ? pi : agentDirectory;
+}
+/**
+* Model defaults fall back independently of credentials, only when settings.json is absent.
+*
+* @deprecated Node-only sync shim; use modelSettingsDirectoryAsync. Removed in M2.
+*/
+function modelSettingsDirectory(agentDirectory, homeDirectory = nodeHost.homeDirectory()) {
+	if (fs.existsSync(piSettingsPath(agentDirectory))) return agentDirectory;
+	const pi = path.join(homeDirectory, ".pi", AGENT_DIRECTORY);
+	return fs.existsSync(piSettingsPath(pi)) ? pi : agentDirectory;
+}
+/** @deprecated Node-only sync shim; use readPiSettingsAsync. Removed in M2. */
+function readPiSettings(agentDirectory) {
+	return normalizePiSettings(readJson(piSettingsPath(agentDirectory)));
+}
+/**
+* Merges the Po-owned keys into Pi's user settings file.
+*
+* @deprecated Node-only sync shim; use writePiSettingsAsync. Removed in M2.
+*/
+function writePiSettings(agentDirectory, update) {
+	const settingsPath = piSettingsPath(agentDirectory);
+	writeFileAtomic(settingsPath, serializePiSettings(mergePiSettings(readPiSettings(agentDirectory), agentDirectory, update)));
+	return settingsPath;
+}
+/**
+* Whether a directory is the dispatcher package `po init` generated, by its manifest ownership marker.
+*
+* @deprecated Node-only sync shim; use isPoDispatcherPackageAsync. Removed in M2.
+*/
+function isPoDispatcherPackage(directory) {
+	let content;
+	try {
+		content = fs.readFileSync(path.join(directory, PACKAGE_MANIFEST), "utf8");
+	} catch {
+		return false;
+	}
+	return isPoDispatcherManifest(content);
+}
+/**
+* Removes the entries `po init` and older `po sync` runs added to Pi's user agent directory.
+*
+* @deprecated Node-only sync shim; use removePoPiSettingsAsync. Removed in M2.
+*/
+function removePoPiSettings(agentDirectory) {
+	const removed = [];
+	const settingsPath = piSettingsPath(agentDirectory);
+	const next = prunePoPiSettings(readPiSettings(agentDirectory), agentDirectory);
+	if (next) {
+		writeFileAtomic(settingsPath, serializePiSettings(next));
+		removed.push(settingsPath);
+	}
+	const themePath = poThemePath(agentDirectory);
+	if (fs.lstatSync(themePath, { throwIfNoEntry: false })?.isFile()) {
+		fs.rmSync(themePath, { force: true });
+		removed.push(themePath);
+	}
+	const dispatcher = poDispatcherPath(agentDirectory);
+	if (fs.lstatSync(dispatcher, { throwIfNoEntry: false })?.isDirectory() && isPoDispatcherPackage(dispatcher)) {
+		fs.rmSync(dispatcher, {
+			recursive: true,
+			force: true
+		});
+		removed.push(dispatcher);
+	}
+	return removed;
+}
+//#endregion
+export { hasRepositoryPoDirectory, isPoDispatcherPackage, modelConfigDirectory, modelSettingsDirectory, readPiSettings, removePoPiSettings, writePiSettings };
+
+//# sourceMappingURL=sync.mjs.map

package/dist/src/services/piSettings/sync.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.mjs","names":[],"sources":["../../../../src/services/piSettings/sync.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport { readJson, writeFileAtomic } from '../json';\nimport type { JsonObject } from '../json';\nimport { nodeHost } from '../nodeHost';\nimport { PACKAGE_MANIFEST } from '../poPackage';\nimport {\n  AGENT_DIRECTORY,\n  AUTH_FILE,\n  isPoDispatcherManifest,\n  isPoHomeMarker,\n  mergePiSettings,\n  MODELS_FILE,\n  normalizePiSettings,\n  PI_HOME_DIRECTORY,\n  piSettingsPath,\n  PO_HOME_DIRECTORY,\n  poDispatcherPath,\n  poThemePath,\n  prunePoPiSettings,\n  serializePiSettings,\n} from './core';\nimport type { PiSettingsUpdate } from './core';\n\n/**\n * True when a directory's `.po` folder exists and is a repository's own configuration.\n *\n * @deprecated Node-only sync shim; use hasRepositoryPoDirectoryAsync. Removed in M2.\n */\nexport function hasRepositoryPoDirectory(\n  directory: string,\n  homeDirectory: string = nodeHost.homeDirectory(),\n  environment: Readonly<Record<string, string | undefined>> = process.env,\n): boolean {\n  const marker = path.resolve(directory, PO_HOME_DIRECTORY);\n  if (isPoHomeMarker(marker, homeDirectory, environment)) return false;\n  try {\n    return fs.statSync(marker).isDirectory();\n  } catch {\n    // No readable `.po` folder here, so this directory is not marked as a repository.\n    return false;\n  }\n}\n\n/** True when the directory names a model: credentials, a custom provider, or a default. */\nfunction hasModelConfig(agentDirectory: string): boolean {\n  try {\n    return (\n      fs.existsSync(path.join(agentDirectory, MODELS_FILE)) ||\n      Object.keys(readJson(path.join(agentDirectory, AUTH_FILE))).length > 0 ||\n      typeof readJson(piSettingsPath(agentDirectory)).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.\n *\n * @deprecated Node-only sync shim; use modelConfigDirectoryAsync. Removed in M2.\n */\nexport function modelConfigDirectory(agentDirectory: string, homeDirectory: string = nodeHost.homeDirectory()): string {\n  if (hasModelConfig(agentDirectory)) return agentDirectory;\n  const pi = path.join(homeDirectory, PI_HOME_DIRECTORY, AGENT_DIRECTORY);\n  return pi !== agentDirectory && hasModelConfig(pi) ? pi : agentDirectory;\n}\n\n/**\n * Model defaults fall back independently of credentials, only when settings.json is absent.\n *\n * @deprecated Node-only sync shim; use modelSettingsDirectoryAsync. Removed in M2.\n */\nexport function modelSettingsDirectory(\n  agentDirectory: string,\n  homeDirectory: string = nodeHost.homeDirectory(),\n): string {\n  if (fs.existsSync(piSettingsPath(agentDirectory))) return agentDirectory;\n  const pi = path.join(homeDirectory, PI_HOME_DIRECTORY, AGENT_DIRECTORY);\n  return fs.existsSync(piSettingsPath(pi)) ? pi : agentDirectory;\n}\n\n/** @deprecated Node-only sync shim; use readPiSettingsAsync. Removed in M2. */\nexport function readPiSettings(agentDirectory: string): JsonObject {\n  return normalizePiSettings(readJson(piSettingsPath(agentDirectory)));\n}\n\n/**\n * Merges the Po-owned keys into Pi's user settings file.\n *\n * @deprecated Node-only sync shim; use writePiSettingsAsync. Removed in M2.\n */\nexport function writePiSettings(agentDirectory: string, update: PiSettingsUpdate): string {\n  const settingsPath = piSettingsPath(agentDirectory);\n  writeFileAtomic(\n    settingsPath,\n    serializePiSettings(mergePiSettings(readPiSettings(agentDirectory), agentDirectory, update)),\n  );\n  return settingsPath;\n}\n\n/**\n * Whether a directory is the dispatcher package `po init` generated, by its manifest ownership marker.\n *\n * @deprecated Node-only sync shim; use isPoDispatcherPackageAsync. Removed in M2.\n */\nexport function isPoDispatcherPackage(directory: string): boolean {\n  let content: string;\n  try {\n    content = fs.readFileSync(path.join(directory, PACKAGE_MANIFEST), 'utf8');\n  } catch {\n    // No readable manifest, so it is not the dispatcher package.\n    return false;\n  }\n  return isPoDispatcherManifest(content);\n}\n\n/**\n * Removes the entries `po init` and older `po sync` runs added to Pi's user agent directory.\n *\n * @deprecated Node-only sync shim; use removePoPiSettingsAsync. Removed in M2.\n */\nexport function removePoPiSettings(agentDirectory: string): string[] {\n  const removed: string[] = [];\n  const settingsPath = piSettingsPath(agentDirectory);\n  const next = prunePoPiSettings(readPiSettings(agentDirectory), agentDirectory);\n  if (next) {\n    writeFileAtomic(settingsPath, serializePiSettings(next));\n    removed.push(settingsPath);\n  }\n  const themePath = poThemePath(agentDirectory);\n  if (fs.lstatSync(themePath, { throwIfNoEntry: false })?.isFile()) {\n    fs.rmSync(themePath, { force: true });\n    removed.push(themePath);\n  }\n  const dispatcher = poDispatcherPath(agentDirectory);\n  const stat = fs.lstatSync(dispatcher, { throwIfNoEntry: false });\n  if (stat?.isDirectory() && isPoDispatcherPackage(dispatcher)) {\n    fs.rmSync(dispatcher, { recursive: true, force: true });\n    removed.push(dispatcher);\n  }\n  return removed;\n}\n"],"mappings":";;;;;;;;;;;;;AA8BA,SAAgB,yBACd,WACA,gBAAwB,SAAS,cAAc,GAC/C,cAA4D,QAAQ,KAC3D;CACT,MAAM,SAAS,KAAK,QAAQ,WAAA,KAA4B;CACxD,IAAI,eAAe,QAAQ,eAAe,WAAW,GAAG,OAAO;CAC/D,IAAI;EACF,OAAO,GAAG,SAAS,MAAM,CAAC,CAAC,YAAY;CACzC,QAAQ;EAEN,OAAO;CACT;AACF;;AAGA,SAAS,eAAe,gBAAiC;CACvD,IAAI;EACF,OACE,GAAG,WAAW,KAAK,KAAK,gBAAA,aAA2B,CAAC,KACpD,OAAO,KAAK,SAAS,KAAK,KAAK,gBAAA,WAAyB,CAAC,CAAC,CAAC,CAAC,SAAS,KACrE,OAAO,SAAS,eAAe,cAAc,CAAC,CAAC,CAAC,oBAAoB;CAExE,QAAQ;EAEN,OAAO;CACT;AACF;;;;;;AAOA,SAAgB,qBAAqB,gBAAwB,gBAAwB,SAAS,cAAc,GAAW;CACrH,IAAI,eAAe,cAAc,GAAG,OAAO;CAC3C,MAAM,KAAK,KAAK,KAAK,eAAA,OAAkC,eAAe;CACtE,OAAO,OAAO,kBAAkB,eAAe,EAAE,IAAI,KAAK;AAC5D;;;;;;AAOA,SAAgB,uBACd,gBACA,gBAAwB,SAAS,cAAc,GACvC;CACR,IAAI,GAAG,WAAW,eAAe,cAAc,CAAC,GAAG,OAAO;CAC1D,MAAM,KAAK,KAAK,KAAK,eAAA,OAAkC,eAAe;CACtE,OAAO,GAAG,WAAW,eAAe,EAAE,CAAC,IAAI,KAAK;AAClD;;AAGA,SAAgB,eAAe,gBAAoC;CACjE,OAAO,oBAAoB,SAAS,eAAe,cAAc,CAAC,CAAC;AACrE;;;;;;AAOA,SAAgB,gBAAgB,gBAAwB,QAAkC;CACxF,MAAM,eAAe,eAAe,cAAc;CAClD,gBACE,cACA,oBAAoB,gBAAgB,eAAe,cAAc,GAAG,gBAAgB,MAAM,CAAC,CAC7F;CACA,OAAO;AACT;;;;;;AAOA,SAAgB,sBAAsB,WAA4B;CAChE,IAAI;CACJ,IAAI;EACF,UAAU,GAAG,aAAa,KAAK,KAAK,WAAW,gBAAgB,GAAG,MAAM;CAC1E,QAAQ;EAEN,OAAO;CACT;CACA,OAAO,uBAAuB,OAAO;AACvC;;;;;;AAOA,SAAgB,mBAAmB,gBAAkC;CACnE,MAAM,UAAoB,CAAC;CAC3B,MAAM,eAAe,eAAe,cAAc;CAClD,MAAM,OAAO,kBAAkB,eAAe,cAAc,GAAG,cAAc;CAC7E,IAAI,MAAM;EACR,gBAAgB,cAAc,oBAAoB,IAAI,CAAC;EACvD,QAAQ,KAAK,YAAY;CAC3B;CACA,MAAM,YAAY,YAAY,cAAc;CAC5C,IAAI,GAAG,UAAU,WAAW,EAAE,gBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG;EAChE,GAAG,OAAO,WAAW,EAAE,OAAO,KAAK,CAAC;EACpC,QAAQ,KAAK,SAAS;CACxB;CACA,MAAM,aAAa,iBAAiB,cAAc;CAElD,IADa,GAAG,UAAU,YAAY,EAAE,gBAAgB,MAAM,CACvD,CAAC,EAAE,YAAY,KAAK,sBAAsB,UAAU,GAAG;EAC5D,GAAG,OAAO,YAAY;GAAE,WAAW;GAAM,OAAO;EAAK,CAAC;EACtD,QAAQ,KAAK,UAAU;CACzB;CACA,OAAO;AACT"}