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

package/dist/moduleResolution.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"moduleResolution.d.mts","names":[],"sources":["../src/services/moduleResolution/index.ts"],"mappings":";;;;;;;wBA2JgB,aAAa,cAAc;;wBAO3B,qBAAqB,cAAc;;;;;;;wBAcnC,sBAAsB;EAAsB;EAAc;;;KAgDrE,oBAAoB,SAAS;;wBA6ClB,eAAe,mBAAmB;;wBAgBlC,uBAAuB,mBAAmB;;;;;;;;;wBAgB1C,uBACd,mBACA,sBACA,cAAa;;;;;wBAkBC,qBACd,mBACA,sBACA,cAAa;;wBAoCC,mBAAmB,mBAAmB,uBAAuB;;;;;;;;;wBAsB7D,iBAAiB,mBAAmB;;;;;;;;;;wBAsBpC,aAAa,mBAAmB;;;;;wBA0BhC,oBAAoB,mBAAmB;;wBAmBvC,WAAW,mBAAmB;;wBAsC9B"}
+{"version":3,"file":"moduleResolution.d.mts","names":[],"sources":["../src/services/moduleResolution/index.ts"],"mappings":";;;;;;;wBA4JgB,aAAa,cAAc;;;;;;wBAY3B,qBAAqB,cAAc;;wBAgBnC,qBAAqB,cAAc;;;;;;;wBAcnC,sBAAsB;EAAsB;EAAc;;;KAgDrE,oBAAoB,SAAS;;wBAGlB,gBAAgB,cAAc,cAAa;;wBAyD3C,eAAe,mBAAmB;;wBAgBlC,uBAAuB,mBAAmB;;;;;;;;;wBAgB1C,uBACd,mBACA,sBACA,cAAa;;;;;wBAkBC,qBACd,mBACA,sBACA,cAAa;;wBA2CC,mBAAmB,mBAAmB,uBAAuB;;;;;;;;;wBAsB7D,iBAAiB,mBAAmB;;;;;;;;;;wBAsBpC,aAAa,mBAAmB;;;;;wBA0BhC,oBAAoB,mBAAmB;;wBAmBvC,WAAW,mBAAmB;;wBAsC9B"}

package/dist/moduleResolution.mjs

@@ -1,4 +1,6 @@
-import { poRuntimeDirectory } from "./runtimePiSettings.mjs";
+import { poRuntimeDirectory } from "./src/services/piSettings/core.mjs";
+import "./runtimePiSettings.mjs";
+import { isCheckoutPoPackage } from "./src/services/testMode/index.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
@@ -122,6 +124,24 @@ function packageEntry(name, origin = import.meta.url) {
 	if (!entry) throw new Error(`Cannot resolve package entry ${name} from ${origin}`);
 	return fs.realpathSync(entry);
 }
+/**
+* The entry a module running from a Po checkout finds in that checkout's own closure.
+* A checkout package is never an implicit override for a consumer, so callers try
+* the consumer first and use this only as the last resort.
+*/
+function checkoutPackageEntry(name, origin) {
+	const from = path.dirname(fileURLToPath(origin));
+	if (!runsFromCheckout(from)) return void 0;
+	const entry = packageRootEntry(name, from, findInstalledPackage(splitPackageSpecifier(name).name, from));
+	return entry === void 0 ? void 0 : fs.realpathSync(entry);
+}
+/** Whether the package that owns this directory is a package of a Po source checkout. */
+function runsFromCheckout(directory) {
+	for (let current = directory;; current = path.dirname(current)) {
+		if (fs.existsSync(path.join(current, PACKAGE_MANIFEST))) return isCheckoutPoPackage(current);
+		if (path.dirname(current) === current) return false;
+	}
+}
 /** Same as packageEntry, but returns undefined when the package is absent. */
 function optionalPackageEntry(name, origin = import.meta.url) {
 	try {
@@ -180,6 +200,14 @@ function findInstalledPackage(name, consumerRoot) {
 		directory = parent;
 	}
 }
+/** Checkout package overrides inherited by the web, server and sync children of `po --test`. */
+function testPackageRoot(name, environment = process.env) {
+	if (environment.PO_TEST !== "1" || !environment.PO_TEST_PACKAGES) return void 0;
+	const packages = JSON.parse(environment.PO_TEST_PACKAGES);
+	if (!isRecord(packages)) throw new Error("PO_TEST_PACKAGES must be a package-to-directory map.");
+	const root = packages[name];
+	return typeof root === "string" ? root : void 0;
+}
 /**
 * Finds a package Po installed into its shared runtime (`<po home>/runtime`),
 * without touching the consumer's own package manifest.
@@ -212,10 +240,12 @@ function runtimePackageDeclared(name, environment) {
 * their state split between them.
 */
 function findConsumerPackage(name, consumerRoot, environment) {
+	const local = testPackageRoot(name, environment);
+	if (local !== void 0) return local;
 	const installed = findInstalledPackage(name, consumerRoot);
-	if (installed) return installed;
+	if (installed && (environment.PO_TEST === "1" || !isCheckoutPoPackage(installed))) return installed;
 	const runtime = findRuntimePackage(name, environment);
-	return runtime && runtimePackageDeclared(name, environment) ? runtime : void 0;
+	return runtime && (environment.PO_TEST === "1" || !isCheckoutPoPackage(runtime)) && runtimePackageDeclared(name, environment) ? runtime : void 0;
 }
 /** Resolves every extension declared by a bare package's standard Pi manifest. */
 function packageEntries(specifier, origin = import.meta.url) {
@@ -241,7 +271,7 @@ function optionalPackageEntries(specifier, origin = import.meta.url) {
 * Resolves manifest entries from the consumer repository's dependency tree.
 *
 * The meta-package cannot resolve what the repository declares: under an
-* isolated node_modules layout Doom Pi only sees its own dependencies. Walking
+* isolated node_modules layout Po Pi only sees its own dependencies. Walking
 * the consumer's module chain lets its package manifest answer first without
 * accidentally falling through to Po's dependency tree.
 */
@@ -262,9 +292,12 @@ function consumerPackageEntries(specifier, consumerRoot, environment = process.e
 * `environment` names the Po home whose shared runtime answers after the consumer's own tree.
 */
 function consumerPackageEntry(specifier, consumerRoot, environment = process.env) {
-	const { name, subpath } = splitPackageSpecifier(specifier);
-	const packageRoot = findConsumerPackage(name, consumerRoot, environment);
+	return packageRootEntry(specifier, consumerRoot, findConsumerPackage(splitPackageSpecifier(specifier).name, consumerRoot, environment));
+}
+/** One export or package-relative path of an already located package. */
+function packageRootEntry(specifier, consumerRoot, packageRoot) {
 	if (!packageRoot) return void 0;
+	const { subpath } = splitPackageSpecifier(specifier);
 	if (subpath === ".") return localEntry(packageRoot, consumerRoot) ?? extensionIndexEntry(packageRoot);
 	const manifestPath = path.join(packageRoot, PACKAGE_MANIFEST);
 	const directTarget = path.join(packageRoot, subpath);
@@ -391,6 +424,6 @@ function piCliPath() {
 	return path.join(path.dirname(packageEntry("@earendil-works/pi-coding-agent")), "cli.js");
 }
 //#endregion
-export { consumerPackageEntries, consumerPackageEntry, localEntries, localEntry, localPackageEntries, localPackageExport, localPackageName, optionalPackageEntries, optionalPackageEntry, packageEntries, packageEntry, piCliPath, splitPackageSpecifier };
+export { checkoutPackageEntry, consumerPackageEntries, consumerPackageEntry, localEntries, localEntry, localPackageEntries, localPackageExport, localPackageName, optionalPackageEntries, optionalPackageEntry, packageEntries, packageEntry, piCliPath, splitPackageSpecifier, testPackageRoot };
 
 //# sourceMappingURL=moduleResolution.mjs.map

package/dist/moduleResolution.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"moduleResolution.mjs","names":[],"sources":["../src/services/moduleResolution/index.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport { minimatch } from 'minimatch';\n\nimport { poRuntimeDirectory } from '../piSettings';\n\nconst PACKAGE_MANIFEST = 'package.json';\nconst NODE_MODULES = 'node_modules';\nconst CURRENT_DIRECTORY_PREFIX = './';\nconst MANIFEST_PATTERN_PREFIXES = ['!', '+', '-'] as const;\nconst GLOB_CHARACTERS = /[*?[\\]{}()]/;\nconst EXTENSION_INDEX_NAMES = ['index.ts', 'index.js', 'index.mts', 'index.mjs', 'index.cts', 'index.cjs'] as const;\nconst EXTENSION_FILE_SUFFIXES = new Set(['.ts', '.js', '.mts', '.mjs', '.cts', '.cjs']);\n/** Import-side conditions, in the order Node prefers them for an ESM consumer. */\nconst IMPORT_CONDITIONS = ['import', 'module', 'node', 'default'] as const;\n\ninterface PackageManifest {\n  name?: unknown;\n  exports?: unknown;\n  module?: unknown;\n  main?: unknown;\n  pi?: unknown;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction readPackageManifest(packageRoot: string): PackageManifest | undefined {\n  try {\n    const parsed: unknown = JSON.parse(fs.readFileSync(path.join(packageRoot, PACKAGE_MANIFEST), 'utf8'));\n    return isRecord(parsed) ? parsed : undefined;\n  } catch {\n    // An unreadable manifest is equivalent to an absent package declaration;\n    // the normal export resolver remains available as the compatibility path.\n    return undefined;\n  }\n}\n\nfunction manifestDeclaresExtensions(manifest: PackageManifest | undefined): boolean {\n  return Boolean(manifest && isRecord(manifest.pi) && Object.hasOwn(manifest.pi, 'extensions'));\n}\n\nfunction isManifestPattern(entry: string): boolean {\n  return MANIFEST_PATTERN_PREFIXES.some((prefix) => entry.startsWith(prefix));\n}\n\nfunction normalizedRelativePath(packageRoot: string, target: string): string {\n  return path.relative(packageRoot, target).split(path.sep).join('/');\n}\n\nfunction matchesManifestPattern(target: string, pattern: string, packageRoot: string): boolean {\n  const normalizedPattern = pattern.replaceAll('\\\\', '/').replace(/^\\.\\//, '');\n  const relative = normalizedRelativePath(packageRoot, target);\n  return (\n    minimatch(relative, normalizedPattern) ||\n    minimatch(path.basename(target), normalizedPattern) ||\n    minimatch(target.split(path.sep).join('/'), normalizedPattern)\n  );\n}\n\nfunction matchesExactManifestPath(target: string, pattern: string, packageRoot: string): boolean {\n  const normalizedPattern = pattern.replaceAll('\\\\', '/').replace(/^\\.\\//, '');\n  return (\n    normalizedRelativePath(packageRoot, target) === normalizedPattern ||\n    target.split(path.sep).join('/') === normalizedPattern\n  );\n}\n\nfunction extensionIndexEntry(directory: string): string | undefined {\n  for (const indexName of EXTENSION_INDEX_NAMES) {\n    const candidate = path.join(directory, indexName);\n    if (fs.existsSync(candidate)) return candidate;\n  }\n  return undefined;\n}\n\nfunction extensionFilesAt(target: string): string[] {\n  let stats: fs.Stats;\n  try {\n    stats = fs.statSync(target);\n  } catch {\n    return [];\n  }\n  if (stats.isFile()) return [target];\n  if (!stats.isDirectory()) return [];\n\n  const files: string[] = [];\n  for (const entry of fs\n    .readdirSync(target, { withFileTypes: true })\n    .sort((left, right) => left.name.localeCompare(right.name))) {\n    const entryPath = path.join(target, entry.name);\n    if ((entry.isFile() || entry.isSymbolicLink()) && EXTENSION_FILE_SUFFIXES.has(path.extname(entry.name))) {\n      files.push(entryPath);\n      continue;\n    }\n    if (!entry.isDirectory() && !entry.isSymbolicLink()) continue;\n    const indexEntry = extensionIndexEntry(entryPath);\n    if (indexEntry) files.push(indexEntry);\n  }\n  return files;\n}\n\n/** Resolves the standard package.json pi.extensions declaration exactly as a layer contribution. */\nfunction manifestExtensionEntries(\n  packageRoot: string,\n  manifest: PackageManifest | undefined,\n  packageName: string,\n): string[] | undefined {\n  if (!manifestDeclaresExtensions(manifest) || !isRecord(manifest?.pi)) return undefined;\n  const configured = manifest.pi.extensions;\n  if (!Array.isArray(configured) || !configured.every((entry) => typeof entry === 'string')) {\n    throw new Error(`${packageName} package.json pi.extensions must be an array of strings.`);\n  }\n\n  const allPaths: string[] = [];\n  for (const configuredEntry of configured.filter((entry) => !isManifestPattern(entry))) {\n    const candidates = GLOB_CHARACTERS.test(configuredEntry)\n      ? fs.globSync(configuredEntry, { cwd: packageRoot }).sort()\n      : [configuredEntry];\n    for (const candidate of candidates) {\n      for (const target of extensionFilesAt(path.resolve(packageRoot, candidate))) {\n        if (!allPaths.includes(target)) allPaths.push(target);\n      }\n    }\n  }\n\n  const excluded = configured.filter((entry) => entry.startsWith('!')).map((entry) => entry.slice(1));\n  const forceIncluded = configured.filter((entry) => entry.startsWith('+')).map((entry) => entry.slice(1));\n  const forceExcluded = configured.filter((entry) => entry.startsWith('-')).map((entry) => entry.slice(1));\n  const selected = allPaths.filter(\n    (target) => !excluded.some((pattern) => matchesManifestPattern(target, pattern, packageRoot)),\n  );\n  for (const target of allPaths) {\n    if (\n      !selected.includes(target) &&\n      forceIncluded.some((pattern) => matchesExactManifestPath(target, pattern, packageRoot))\n    ) {\n      selected.push(target);\n    }\n  }\n  const filtered = selected.filter(\n    (target) => !forceExcluded.some((pattern) => matchesExactManifestPath(target, pattern, packageRoot)),\n  );\n  return filtered.length > 0 ? filtered : undefined;\n}\n\n/**\n * Resolves the on-disk entry point of an installed package.\n *\n * Pi loads extensions by absolute path, so anything contributed as an\n * extension has to be resolved to a file before it can be passed along.\n */\nexport function packageEntry(name: string, origin: string = import.meta.url): string {\n  const entry = consumerPackageEntry(name, path.dirname(fileURLToPath(origin)));\n  if (!entry) throw new Error(`Cannot resolve package entry ${name} from ${origin}`);\n  return fs.realpathSync(entry);\n}\n\n/** Same as packageEntry, but returns undefined when the package is absent. */\nexport function optionalPackageEntry(name: string, origin: string = import.meta.url): string | undefined {\n  try {\n    return packageEntry(name, origin);\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Splits `@scope/name/sub/path` into the package name and its export subpath.\n *\n * A scoped name owns two segments, an unscoped name one. Everything after that\n * is the subpath the package's own `exports` map has to answer for.\n */\nexport function splitPackageSpecifier(specifier: string): { name: string; subpath: string } {\n  const segments = specifier.split('/');\n  const nameSegments = specifier.startsWith('@') ? 2 : 1;\n  const name = segments.slice(0, nameSegments).join('/');\n  const rest = segments.slice(nameSegments).join('/');\n  return { name, subpath: rest ? `${CURRENT_DIRECTORY_PREFIX}${rest}` : '.' };\n}\n\n/** Picks the import-side target out of one `exports` entry. */\nfunction selectImportTarget(value: unknown): string | undefined {\n  if (typeof value === 'string') return value;\n  if (Array.isArray(value)) {\n    for (const candidate of value) {\n      const target = selectImportTarget(candidate);\n      if (target) return target;\n    }\n    return undefined;\n  }\n  if (typeof value !== 'object' || value === null) return undefined;\n  const conditions = value as Record<string, unknown>;\n  for (const condition of IMPORT_CONDITIONS) {\n    if (condition in conditions) {\n      const target = selectImportTarget(conditions[condition]);\n      if (target) return target;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Finds an installed package directory by walking the consumer's module chain.\n *\n * Node's own lookup order, so a workspace link in the repository root is found\n * exactly where the repository installed it, and nothing outside that chain can\n * answer for a specifier the repository declared.\n */\nfunction findInstalledPackage(name: string, consumerRoot: string): string | undefined {\n  let directory = path.resolve(consumerRoot);\n  while (true) {\n    const candidate = path.join(directory, NODE_MODULES, name);\n    if (fs.existsSync(path.join(candidate, PACKAGE_MANIFEST))) return candidate;\n    const parent = path.dirname(directory);\n    if (parent === directory) return undefined;\n    directory = parent;\n  }\n}\n\n/** The environment a lookup runs for; it names the Po home, and so the shared runtime. */\ntype LookupEnvironment = Readonly<Record<string, string | undefined>>;\n\n/**\n * Finds a package Po installed into its shared runtime (`<po home>/runtime`),\n * without touching the consumer's own package manifest.\n */\nfunction findRuntimePackage(name: string, environment: LookupEnvironment): string | undefined {\n  const candidate = path.join(poRuntimeDirectory(undefined, environment), NODE_MODULES, name);\n  return fs.existsSync(path.join(candidate, PACKAGE_MANIFEST)) ? candidate : undefined;\n}\n\n/**\n * Whether a Po root asked for this package, rather than it arriving\n * transitively. The runtime's manifest is that list, shared by every root; a\n * runtime without one has nothing to check against and every package in it\n * counts.\n */\nfunction runtimePackageDeclared(name: string, environment: LookupEnvironment): boolean {\n  const manifestPath = path.join(poRuntimeDirectory(undefined, environment), PACKAGE_MANIFEST);\n  if (!fs.existsSync(manifestPath)) return true;\n  try {\n    const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8')) as { dependencies?: Record<string, unknown> };\n    return name in (manifest.dependencies ?? {});\n  } catch {\n    // An unreadable manifest declares nothing, so the runtime answers for nothing.\n    return false;\n  }\n}\n\n/**\n * The consumer's own dependency tree answers first, then the packages a Po\n * root asked the shared runtime for. A package that merely arrived in the\n * runtime as a dependency of one of those (po-config beneath a layer package,\n * say) is not the answer: declining lets the caller's fallback resolve it from\n * Po's own tree, so one session never loads two copies of a core package with\n * their state split between them.\n */\nfunction findConsumerPackage(name: string, consumerRoot: string, environment: LookupEnvironment): string | undefined {\n  const installed = findInstalledPackage(name, consumerRoot);\n  if (installed) return installed;\n  const runtime = findRuntimePackage(name, environment);\n  return runtime && runtimePackageDeclared(name, environment) ? runtime : undefined;\n}\n\n/** Resolves every extension declared by a bare package's standard Pi manifest. */\nexport function packageEntries(specifier: string, origin: string = import.meta.url): string[] {\n  const { name, subpath } = splitPackageSpecifier(specifier);\n  if (subpath !== '.') return [packageEntry(specifier, origin)];\n\n  const packageRoot = findInstalledPackage(name, path.dirname(fileURLToPath(origin)));\n  if (!packageRoot) throw new Error(`Cannot resolve package ${name}.`);\n  const manifest = readPackageManifest(packageRoot);\n  if (!manifestDeclaresExtensions(manifest)) {\n    throw new Error(`${name} package.json does not declare pi.extensions.`);\n  }\n  const manifestEntries = manifestExtensionEntries(packageRoot, manifest, name);\n  if (!manifestEntries?.length) throw new Error(`${name} package.json pi.extensions resolves no extension files.`);\n  return manifestEntries;\n}\n\n/** Same as packageEntries, but returns undefined when the package is absent. */\nexport function optionalPackageEntries(specifier: string, origin: string = import.meta.url): string[] | undefined {\n  try {\n    return packageEntries(specifier, origin);\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Resolves manifest entries from the consumer repository's dependency tree.\n *\n * The meta-package cannot resolve what the repository declares: under an\n * isolated node_modules layout Doom Pi only sees its own dependencies. Walking\n * the consumer's module chain lets its package manifest answer first without\n * accidentally falling through to Po's dependency tree.\n */\nexport function consumerPackageEntries(\n  specifier: string,\n  consumerRoot: string,\n  environment: LookupEnvironment = process.env,\n): string[] | undefined {\n  const { name, subpath } = splitPackageSpecifier(specifier);\n  const packageRoot = findConsumerPackage(name, consumerRoot, environment);\n  if (!packageRoot) return undefined;\n  if (subpath === '.') {\n    const manifest = readPackageManifest(packageRoot);\n    if (!manifestDeclaresExtensions(manifest)) return [];\n    return manifestExtensionEntries(packageRoot, manifest, name) ?? [];\n  }\n  const entry = consumerPackageEntry(specifier, consumerRoot, environment);\n  return entry ? [entry] : [];\n}\n\n/**\n * Resolves one explicit package export or direct package-relative path from the consumer.\n * `environment` names the Po home whose shared runtime answers after the consumer's own tree.\n */\nexport function consumerPackageEntry(\n  specifier: string,\n  consumerRoot: string,\n  environment: LookupEnvironment = process.env,\n): string | undefined {\n  const { name, subpath } = splitPackageSpecifier(specifier);\n  const packageRoot = findConsumerPackage(name, consumerRoot, environment);\n  if (!packageRoot) return undefined;\n\n  if (subpath === '.') return localEntry(packageRoot, consumerRoot) ?? extensionIndexEntry(packageRoot);\n\n  const manifestPath = path.join(packageRoot, PACKAGE_MANIFEST);\n  // A relative subpath that the package does not export is still loadable by\n  // path, which is how layers point at a file inside a package (`.../index.ts`).\n  const directTarget = path.join(packageRoot, subpath);\n  let manifest: { exports?: unknown };\n  try {\n    manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8')) as { exports?: unknown };\n  } catch {\n    return fs.existsSync(directTarget) ? directTarget : undefined;\n  }\n\n  const exports = manifest.exports;\n  if (exports !== undefined && exports !== null) {\n    const entry =\n      typeof exports === 'object' && !Array.isArray(exports)\n        ? (exports as Record<string, unknown>)[subpath]\n        : undefined;\n    const target = selectImportTarget(entry);\n    if (target) {\n      const resolved = path.join(packageRoot, target);\n      if (fs.existsSync(resolved)) return resolved;\n    }\n  }\n\n  return fs.existsSync(directTarget) ? directTarget : undefined;\n}\n\n/** Resolves one exports subpath from a path-style package directory. */\nexport function localPackageExport(specifier: string, baseDirectory: string, subpath: string): string | undefined {\n  const packageRoot = path.resolve(baseDirectory, specifier);\n  const manifest = readPackageManifest(packageRoot);\n  const exports = manifest?.exports;\n  if (exports === undefined || exports === null) return undefined;\n  const target = selectImportTarget(isRecord(exports) ? exports[subpath] : undefined);\n  if (!target) return undefined;\n  const resolved = path.join(packageRoot, target);\n  return fs.existsSync(resolved) ? resolved : undefined;\n}\n\n/** Manifest fields consulted when a local package declares no `exports`. */\nconst MAIN_FIELDS = ['module', 'main'] as const;\n\n/**\n * Returns the canonical name of a path-style package directory.\n *\n * A direct file is intentionally anonymous: treating the repository manifest\n * above it as the file's identity would collapse every local extension in that\n * repository. Only a directory with its own named manifest represents a package\n * that can replace another installed version by logical identity.\n */\nexport function localPackageName(specifier: string, baseDirectory: string): string | undefined {\n  const target = path.resolve(baseDirectory, specifier);\n  try {\n    if (!fs.statSync(target).isDirectory()) return undefined;\n    const manifest = JSON.parse(fs.readFileSync(path.join(target, PACKAGE_MANIFEST), 'utf8')) as {\n      name?: unknown;\n    };\n    return typeof manifest.name === 'string' && manifest.name.trim() ? manifest.name.trim() : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Resolves Pi extension entries from a local file, extension directory, or package.\n *\n * A file is taken as the extension entry as written. A package directory uses\n * its native `pi.extensions` declaration or legacy root entry. A plain directory\n * follows Pi's extension discovery convention for scripts and child `index`\n * modules. This lets unpublished extensions live in the repository, or beside\n * the global config in `~/.po`, and still load in deterministic order.\n */\nexport function localEntries(specifier: string, baseDirectory: string): string[] | undefined {\n  const target = path.resolve(baseDirectory, specifier);\n  let stats: fs.Stats;\n  try {\n    stats = fs.statSync(target);\n  } catch {\n    return undefined;\n  }\n  if (stats.isFile()) return [target];\n  if (!stats.isDirectory()) return undefined;\n\n  const manifest = readPackageManifest(target);\n  const manifestEntries = manifestExtensionEntries(\n    target,\n    manifest,\n    localPackageName(specifier, baseDirectory) ?? target,\n  );\n  if (manifestEntries !== undefined) return manifestEntries;\n  const entry = localEntry(specifier, baseDirectory);\n  return entry ? [entry] : extensionFilesAt(target);\n}\n\n/**\n * Resolves a local package selection through its standard Pi manifest.\n * Direct files and extension directories remain valid explicit local paths.\n */\nexport function localPackageEntries(specifier: string, baseDirectory: string): string[] | undefined {\n  const target = path.resolve(baseDirectory, specifier);\n  let stats: fs.Stats;\n  try {\n    stats = fs.statSync(target);\n  } catch {\n    return undefined;\n  }\n  if (stats.isFile()) return [target];\n  if (!stats.isDirectory()) return undefined;\n\n  const manifestPath = path.join(target, PACKAGE_MANIFEST);\n  if (!fs.existsSync(manifestPath)) return extensionFilesAt(target);\n  const manifest = readPackageManifest(target);\n  if (!manifestDeclaresExtensions(manifest)) return [];\n  return manifestExtensionEntries(target, manifest, localPackageName(specifier, baseDirectory) ?? target) ?? [];\n}\n\n/** Resolves the legacy single entry from a local package's exports, module, or main field. */\nexport function localEntry(specifier: string, baseDirectory: string): string | undefined {\n  const target = path.resolve(baseDirectory, specifier);\n  let isDirectory: boolean;\n  try {\n    const stats = fs.statSync(target);\n    if (stats.isFile()) return target;\n    isDirectory = stats.isDirectory();\n  } catch {\n    return undefined;\n  }\n  if (!isDirectory) return undefined;\n\n  let manifest: { exports?: unknown; module?: unknown; main?: unknown };\n  try {\n    manifest = JSON.parse(fs.readFileSync(path.join(target, PACKAGE_MANIFEST), 'utf8')) as typeof manifest;\n  } catch {\n    return undefined;\n  }\n\n  const exports = manifest.exports;\n  const rootExport =\n    typeof exports === 'object' && exports !== null && !Array.isArray(exports)\n      ? ((exports as Record<string, unknown>)['.'] ?? exports)\n      : exports;\n  const candidates = [selectImportTarget(rootExport)];\n  for (const field of MAIN_FIELDS) {\n    if (typeof manifest[field] === 'string') candidates.push(manifest[field]);\n  }\n\n  for (const candidate of candidates) {\n    if (!candidate) continue;\n    const resolved = path.join(target, candidate);\n    if (fs.existsSync(resolved)) return resolved;\n  }\n  return extensionIndexEntry(target);\n}\n\n/** Path to Pi's own CLI, which the launch command spawns. */\nexport function piCliPath(): string {\n  return path.join(path.dirname(packageEntry('@earendil-works/pi-coding-agent')), 'cli.js');\n}\n"],"mappings":"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"}
+{"version":3,"file":"moduleResolution.mjs","names":[],"sources":["../src/services/moduleResolution/index.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport { minimatch } from 'minimatch';\n\nimport { poRuntimeDirectory } from '../piSettings';\nimport { isCheckoutPoPackage } from '../testMode';\n\nconst PACKAGE_MANIFEST = 'package.json';\nconst NODE_MODULES = 'node_modules';\nconst CURRENT_DIRECTORY_PREFIX = './';\nconst MANIFEST_PATTERN_PREFIXES = ['!', '+', '-'] as const;\nconst GLOB_CHARACTERS = /[*?[\\]{}()]/;\nconst EXTENSION_INDEX_NAMES = ['index.ts', 'index.js', 'index.mts', 'index.mjs', 'index.cts', 'index.cjs'] as const;\nconst EXTENSION_FILE_SUFFIXES = new Set(['.ts', '.js', '.mts', '.mjs', '.cts', '.cjs']);\n/** Import-side conditions, in the order Node prefers them for an ESM consumer. */\nconst IMPORT_CONDITIONS = ['import', 'module', 'node', 'default'] as const;\n\ninterface PackageManifest {\n  name?: unknown;\n  exports?: unknown;\n  module?: unknown;\n  main?: unknown;\n  pi?: unknown;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction readPackageManifest(packageRoot: string): PackageManifest | undefined {\n  try {\n    const parsed: unknown = JSON.parse(fs.readFileSync(path.join(packageRoot, PACKAGE_MANIFEST), 'utf8'));\n    return isRecord(parsed) ? parsed : undefined;\n  } catch {\n    // An unreadable manifest is equivalent to an absent package declaration;\n    // the normal export resolver remains available as the compatibility path.\n    return undefined;\n  }\n}\n\nfunction manifestDeclaresExtensions(manifest: PackageManifest | undefined): boolean {\n  return Boolean(manifest && isRecord(manifest.pi) && Object.hasOwn(manifest.pi, 'extensions'));\n}\n\nfunction isManifestPattern(entry: string): boolean {\n  return MANIFEST_PATTERN_PREFIXES.some((prefix) => entry.startsWith(prefix));\n}\n\nfunction normalizedRelativePath(packageRoot: string, target: string): string {\n  return path.relative(packageRoot, target).split(path.sep).join('/');\n}\n\nfunction matchesManifestPattern(target: string, pattern: string, packageRoot: string): boolean {\n  const normalizedPattern = pattern.replaceAll('\\\\', '/').replace(/^\\.\\//, '');\n  const relative = normalizedRelativePath(packageRoot, target);\n  return (\n    minimatch(relative, normalizedPattern) ||\n    minimatch(path.basename(target), normalizedPattern) ||\n    minimatch(target.split(path.sep).join('/'), normalizedPattern)\n  );\n}\n\nfunction matchesExactManifestPath(target: string, pattern: string, packageRoot: string): boolean {\n  const normalizedPattern = pattern.replaceAll('\\\\', '/').replace(/^\\.\\//, '');\n  return (\n    normalizedRelativePath(packageRoot, target) === normalizedPattern ||\n    target.split(path.sep).join('/') === normalizedPattern\n  );\n}\n\nfunction extensionIndexEntry(directory: string): string | undefined {\n  for (const indexName of EXTENSION_INDEX_NAMES) {\n    const candidate = path.join(directory, indexName);\n    if (fs.existsSync(candidate)) return candidate;\n  }\n  return undefined;\n}\n\nfunction extensionFilesAt(target: string): string[] {\n  let stats: fs.Stats;\n  try {\n    stats = fs.statSync(target);\n  } catch {\n    return [];\n  }\n  if (stats.isFile()) return [target];\n  if (!stats.isDirectory()) return [];\n\n  const files: string[] = [];\n  for (const entry of fs\n    .readdirSync(target, { withFileTypes: true })\n    .sort((left, right) => left.name.localeCompare(right.name))) {\n    const entryPath = path.join(target, entry.name);\n    if ((entry.isFile() || entry.isSymbolicLink()) && EXTENSION_FILE_SUFFIXES.has(path.extname(entry.name))) {\n      files.push(entryPath);\n      continue;\n    }\n    if (!entry.isDirectory() && !entry.isSymbolicLink()) continue;\n    const indexEntry = extensionIndexEntry(entryPath);\n    if (indexEntry) files.push(indexEntry);\n  }\n  return files;\n}\n\n/** Resolves the standard package.json pi.extensions declaration exactly as a layer contribution. */\nfunction manifestExtensionEntries(\n  packageRoot: string,\n  manifest: PackageManifest | undefined,\n  packageName: string,\n): string[] | undefined {\n  if (!manifestDeclaresExtensions(manifest) || !isRecord(manifest?.pi)) return undefined;\n  const configured = manifest.pi.extensions;\n  if (!Array.isArray(configured) || !configured.every((entry) => typeof entry === 'string')) {\n    throw new Error(`${packageName} package.json pi.extensions must be an array of strings.`);\n  }\n\n  const allPaths: string[] = [];\n  for (const configuredEntry of configured.filter((entry) => !isManifestPattern(entry))) {\n    const candidates = GLOB_CHARACTERS.test(configuredEntry)\n      ? fs.globSync(configuredEntry, { cwd: packageRoot }).sort()\n      : [configuredEntry];\n    for (const candidate of candidates) {\n      for (const target of extensionFilesAt(path.resolve(packageRoot, candidate))) {\n        if (!allPaths.includes(target)) allPaths.push(target);\n      }\n    }\n  }\n\n  const excluded = configured.filter((entry) => entry.startsWith('!')).map((entry) => entry.slice(1));\n  const forceIncluded = configured.filter((entry) => entry.startsWith('+')).map((entry) => entry.slice(1));\n  const forceExcluded = configured.filter((entry) => entry.startsWith('-')).map((entry) => entry.slice(1));\n  const selected = allPaths.filter(\n    (target) => !excluded.some((pattern) => matchesManifestPattern(target, pattern, packageRoot)),\n  );\n  for (const target of allPaths) {\n    if (\n      !selected.includes(target) &&\n      forceIncluded.some((pattern) => matchesExactManifestPath(target, pattern, packageRoot))\n    ) {\n      selected.push(target);\n    }\n  }\n  const filtered = selected.filter(\n    (target) => !forceExcluded.some((pattern) => matchesExactManifestPath(target, pattern, packageRoot)),\n  );\n  return filtered.length > 0 ? filtered : undefined;\n}\n\n/**\n * Resolves the on-disk entry point of an installed package.\n *\n * Pi loads extensions by absolute path, so anything contributed as an\n * extension has to be resolved to a file before it can be passed along.\n */\nexport function packageEntry(name: string, origin: string = import.meta.url): string {\n  const from = path.dirname(fileURLToPath(origin));\n  const entry = consumerPackageEntry(name, from);\n  if (!entry) throw new Error(`Cannot resolve package entry ${name} from ${origin}`);\n  return fs.realpathSync(entry);\n}\n\n/**\n * The entry a module running from a Po checkout finds in that checkout's own closure.\n * A checkout package is never an implicit override for a consumer, so callers try\n * the consumer first and use this only as the last resort.\n */\nexport function checkoutPackageEntry(name: string, origin: string): string | undefined {\n  const from = path.dirname(fileURLToPath(origin));\n  if (!runsFromCheckout(from)) return undefined;\n  const entry = packageRootEntry(name, from, findInstalledPackage(splitPackageSpecifier(name).name, from));\n  return entry === undefined ? undefined : fs.realpathSync(entry);\n}\n\n/** Whether the package that owns this directory is a package of a Po source checkout. */\nfunction runsFromCheckout(directory: string): boolean {\n  for (let current = directory; ; current = path.dirname(current)) {\n    if (fs.existsSync(path.join(current, PACKAGE_MANIFEST))) return isCheckoutPoPackage(current);\n    if (path.dirname(current) === current) return false;\n  }\n}\n\n/** Same as packageEntry, but returns undefined when the package is absent. */\nexport function optionalPackageEntry(name: string, origin: string = import.meta.url): string | undefined {\n  try {\n    return packageEntry(name, origin);\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Splits `@scope/name/sub/path` into the package name and its export subpath.\n *\n * A scoped name owns two segments, an unscoped name one. Everything after that\n * is the subpath the package's own `exports` map has to answer for.\n */\nexport function splitPackageSpecifier(specifier: string): { name: string; subpath: string } {\n  const segments = specifier.split('/');\n  const nameSegments = specifier.startsWith('@') ? 2 : 1;\n  const name = segments.slice(0, nameSegments).join('/');\n  const rest = segments.slice(nameSegments).join('/');\n  return { name, subpath: rest ? `${CURRENT_DIRECTORY_PREFIX}${rest}` : '.' };\n}\n\n/** Picks the import-side target out of one `exports` entry. */\nfunction selectImportTarget(value: unknown): string | undefined {\n  if (typeof value === 'string') return value;\n  if (Array.isArray(value)) {\n    for (const candidate of value) {\n      const target = selectImportTarget(candidate);\n      if (target) return target;\n    }\n    return undefined;\n  }\n  if (typeof value !== 'object' || value === null) return undefined;\n  const conditions = value as Record<string, unknown>;\n  for (const condition of IMPORT_CONDITIONS) {\n    if (condition in conditions) {\n      const target = selectImportTarget(conditions[condition]);\n      if (target) return target;\n    }\n  }\n  return undefined;\n}\n\n/**\n * Finds an installed package directory by walking the consumer's module chain.\n *\n * Node's own lookup order, so a workspace link in the repository root is found\n * exactly where the repository installed it, and nothing outside that chain can\n * answer for a specifier the repository declared.\n */\nfunction findInstalledPackage(name: string, consumerRoot: string): string | undefined {\n  let directory = path.resolve(consumerRoot);\n  while (true) {\n    const candidate = path.join(directory, NODE_MODULES, name);\n    if (fs.existsSync(path.join(candidate, PACKAGE_MANIFEST))) return candidate;\n    const parent = path.dirname(directory);\n    if (parent === directory) return undefined;\n    directory = parent;\n  }\n}\n\n/** The environment a lookup runs for; it names the Po home, and so the shared runtime. */\ntype LookupEnvironment = Readonly<Record<string, string | undefined>>;\n\n/** Checkout package overrides inherited by the web, server and sync children of `po --test`. */\nexport function testPackageRoot(name: string, environment: LookupEnvironment = process.env): string | undefined {\n  if (environment.PO_TEST !== '1' || !environment.PO_TEST_PACKAGES) return undefined;\n  const packages: unknown = JSON.parse(environment.PO_TEST_PACKAGES);\n  if (!isRecord(packages)) throw new Error('PO_TEST_PACKAGES must be a package-to-directory map.');\n  const root = packages[name];\n  return typeof root === 'string' ? root : undefined;\n}\n\n/**\n * Finds a package Po installed into its shared runtime (`<po home>/runtime`),\n * without touching the consumer's own package manifest.\n */\nfunction findRuntimePackage(name: string, environment: LookupEnvironment): string | undefined {\n  const candidate = path.join(poRuntimeDirectory(undefined, environment), NODE_MODULES, name);\n  return fs.existsSync(path.join(candidate, PACKAGE_MANIFEST)) ? candidate : undefined;\n}\n\n/**\n * Whether a Po root asked for this package, rather than it arriving\n * transitively. The runtime's manifest is that list, shared by every root; a\n * runtime without one has nothing to check against and every package in it\n * counts.\n */\nfunction runtimePackageDeclared(name: string, environment: LookupEnvironment): boolean {\n  const manifestPath = path.join(poRuntimeDirectory(undefined, environment), PACKAGE_MANIFEST);\n  if (!fs.existsSync(manifestPath)) return true;\n  try {\n    const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8')) as { dependencies?: Record<string, unknown> };\n    return name in (manifest.dependencies ?? {});\n  } catch {\n    // An unreadable manifest declares nothing, so the runtime answers for nothing.\n    return false;\n  }\n}\n\n/**\n * The consumer's own dependency tree answers first, then the packages a Po\n * root asked the shared runtime for. A package that merely arrived in the\n * runtime as a dependency of one of those (po-config beneath a layer package,\n * say) is not the answer: declining lets the caller's fallback resolve it from\n * Po's own tree, so one session never loads two copies of a core package with\n * their state split between them.\n */\nfunction findConsumerPackage(name: string, consumerRoot: string, environment: LookupEnvironment): string | undefined {\n  const local = testPackageRoot(name, environment);\n  if (local !== undefined) return local;\n  const installed = findInstalledPackage(name, consumerRoot);\n  if (installed && (environment.PO_TEST === '1' || !isCheckoutPoPackage(installed))) return installed;\n  const runtime = findRuntimePackage(name, environment);\n  return runtime &&\n    (environment.PO_TEST === '1' || !isCheckoutPoPackage(runtime)) &&\n    runtimePackageDeclared(name, environment)\n    ? runtime\n    : undefined;\n}\n\n/** Resolves every extension declared by a bare package's standard Pi manifest. */\nexport function packageEntries(specifier: string, origin: string = import.meta.url): string[] {\n  const { name, subpath } = splitPackageSpecifier(specifier);\n  if (subpath !== '.') return [packageEntry(specifier, origin)];\n\n  const packageRoot = findInstalledPackage(name, path.dirname(fileURLToPath(origin)));\n  if (!packageRoot) throw new Error(`Cannot resolve package ${name}.`);\n  const manifest = readPackageManifest(packageRoot);\n  if (!manifestDeclaresExtensions(manifest)) {\n    throw new Error(`${name} package.json does not declare pi.extensions.`);\n  }\n  const manifestEntries = manifestExtensionEntries(packageRoot, manifest, name);\n  if (!manifestEntries?.length) throw new Error(`${name} package.json pi.extensions resolves no extension files.`);\n  return manifestEntries;\n}\n\n/** Same as packageEntries, but returns undefined when the package is absent. */\nexport function optionalPackageEntries(specifier: string, origin: string = import.meta.url): string[] | undefined {\n  try {\n    return packageEntries(specifier, origin);\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Resolves manifest entries from the consumer repository's dependency tree.\n *\n * The meta-package cannot resolve what the repository declares: under an\n * isolated node_modules layout Po Pi only sees its own dependencies. Walking\n * the consumer's module chain lets its package manifest answer first without\n * accidentally falling through to Po's dependency tree.\n */\nexport function consumerPackageEntries(\n  specifier: string,\n  consumerRoot: string,\n  environment: LookupEnvironment = process.env,\n): string[] | undefined {\n  const { name, subpath } = splitPackageSpecifier(specifier);\n  const packageRoot = findConsumerPackage(name, consumerRoot, environment);\n  if (!packageRoot) return undefined;\n  if (subpath === '.') {\n    const manifest = readPackageManifest(packageRoot);\n    if (!manifestDeclaresExtensions(manifest)) return [];\n    return manifestExtensionEntries(packageRoot, manifest, name) ?? [];\n  }\n  const entry = consumerPackageEntry(specifier, consumerRoot, environment);\n  return entry ? [entry] : [];\n}\n\n/**\n * Resolves one explicit package export or direct package-relative path from the consumer.\n * `environment` names the Po home whose shared runtime answers after the consumer's own tree.\n */\nexport function consumerPackageEntry(\n  specifier: string,\n  consumerRoot: string,\n  environment: LookupEnvironment = process.env,\n): string | undefined {\n  const packageRoot = findConsumerPackage(splitPackageSpecifier(specifier).name, consumerRoot, environment);\n  return packageRootEntry(specifier, consumerRoot, packageRoot);\n}\n\n/** One export or package-relative path of an already located package. */\nfunction packageRootEntry(\n  specifier: string,\n  consumerRoot: string,\n  packageRoot: string | undefined,\n): string | undefined {\n  if (!packageRoot) return undefined;\n  const { subpath } = splitPackageSpecifier(specifier);\n  if (subpath === '.') return localEntry(packageRoot, consumerRoot) ?? extensionIndexEntry(packageRoot);\n  const manifestPath = path.join(packageRoot, PACKAGE_MANIFEST);\n  // A relative subpath that the package does not export is still loadable by\n  // path, which is how layers point at a file inside a package (`.../index.ts`).\n  const directTarget = path.join(packageRoot, subpath);\n  let manifest: { exports?: unknown };\n  try {\n    manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8')) as { exports?: unknown };\n  } catch {\n    return fs.existsSync(directTarget) ? directTarget : undefined;\n  }\n\n  const exports = manifest.exports;\n  if (exports !== undefined && exports !== null) {\n    const entry =\n      typeof exports === 'object' && !Array.isArray(exports)\n        ? (exports as Record<string, unknown>)[subpath]\n        : undefined;\n    const target = selectImportTarget(entry);\n    if (target) {\n      const resolved = path.join(packageRoot, target);\n      if (fs.existsSync(resolved)) return resolved;\n    }\n  }\n\n  return fs.existsSync(directTarget) ? directTarget : undefined;\n}\n\n/** Resolves one exports subpath from a path-style package directory. */\nexport function localPackageExport(specifier: string, baseDirectory: string, subpath: string): string | undefined {\n  const packageRoot = path.resolve(baseDirectory, specifier);\n  const manifest = readPackageManifest(packageRoot);\n  const exports = manifest?.exports;\n  if (exports === undefined || exports === null) return undefined;\n  const target = selectImportTarget(isRecord(exports) ? exports[subpath] : undefined);\n  if (!target) return undefined;\n  const resolved = path.join(packageRoot, target);\n  return fs.existsSync(resolved) ? resolved : undefined;\n}\n\n/** Manifest fields consulted when a local package declares no `exports`. */\nconst MAIN_FIELDS = ['module', 'main'] as const;\n\n/**\n * Returns the canonical name of a path-style package directory.\n *\n * A direct file is intentionally anonymous: treating the repository manifest\n * above it as the file's identity would collapse every local extension in that\n * repository. Only a directory with its own named manifest represents a package\n * that can replace another installed version by logical identity.\n */\nexport function localPackageName(specifier: string, baseDirectory: string): string | undefined {\n  const target = path.resolve(baseDirectory, specifier);\n  try {\n    if (!fs.statSync(target).isDirectory()) return undefined;\n    const manifest = JSON.parse(fs.readFileSync(path.join(target, PACKAGE_MANIFEST), 'utf8')) as {\n      name?: unknown;\n    };\n    return typeof manifest.name === 'string' && manifest.name.trim() ? manifest.name.trim() : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Resolves Pi extension entries from a local file, extension directory, or package.\n *\n * A file is taken as the extension entry as written. A package directory uses\n * its native `pi.extensions` declaration or legacy root entry. A plain directory\n * follows Pi's extension discovery convention for scripts and child `index`\n * modules. This lets unpublished extensions live in the repository, or beside\n * the global config in `~/.po`, and still load in deterministic order.\n */\nexport function localEntries(specifier: string, baseDirectory: string): string[] | undefined {\n  const target = path.resolve(baseDirectory, specifier);\n  let stats: fs.Stats;\n  try {\n    stats = fs.statSync(target);\n  } catch {\n    return undefined;\n  }\n  if (stats.isFile()) return [target];\n  if (!stats.isDirectory()) return undefined;\n\n  const manifest = readPackageManifest(target);\n  const manifestEntries = manifestExtensionEntries(\n    target,\n    manifest,\n    localPackageName(specifier, baseDirectory) ?? target,\n  );\n  if (manifestEntries !== undefined) return manifestEntries;\n  const entry = localEntry(specifier, baseDirectory);\n  return entry ? [entry] : extensionFilesAt(target);\n}\n\n/**\n * Resolves a local package selection through its standard Pi manifest.\n * Direct files and extension directories remain valid explicit local paths.\n */\nexport function localPackageEntries(specifier: string, baseDirectory: string): string[] | undefined {\n  const target = path.resolve(baseDirectory, specifier);\n  let stats: fs.Stats;\n  try {\n    stats = fs.statSync(target);\n  } catch {\n    return undefined;\n  }\n  if (stats.isFile()) return [target];\n  if (!stats.isDirectory()) return undefined;\n\n  const manifestPath = path.join(target, PACKAGE_MANIFEST);\n  if (!fs.existsSync(manifestPath)) return extensionFilesAt(target);\n  const manifest = readPackageManifest(target);\n  if (!manifestDeclaresExtensions(manifest)) return [];\n  return manifestExtensionEntries(target, manifest, localPackageName(specifier, baseDirectory) ?? target) ?? [];\n}\n\n/** Resolves the legacy single entry from a local package's exports, module, or main field. */\nexport function localEntry(specifier: string, baseDirectory: string): string | undefined {\n  const target = path.resolve(baseDirectory, specifier);\n  let isDirectory: boolean;\n  try {\n    const stats = fs.statSync(target);\n    if (stats.isFile()) return target;\n    isDirectory = stats.isDirectory();\n  } catch {\n    return undefined;\n  }\n  if (!isDirectory) return undefined;\n\n  let manifest: { exports?: unknown; module?: unknown; main?: unknown };\n  try {\n    manifest = JSON.parse(fs.readFileSync(path.join(target, PACKAGE_MANIFEST), 'utf8')) as typeof manifest;\n  } catch {\n    return undefined;\n  }\n\n  const exports = manifest.exports;\n  const rootExport =\n    typeof exports === 'object' && exports !== null && !Array.isArray(exports)\n      ? ((exports as Record<string, unknown>)['.'] ?? exports)\n      : exports;\n  const candidates = [selectImportTarget(rootExport)];\n  for (const field of MAIN_FIELDS) {\n    if (typeof manifest[field] === 'string') candidates.push(manifest[field]);\n  }\n\n  for (const candidate of candidates) {\n    if (!candidate) continue;\n    const resolved = path.join(target, candidate);\n    if (fs.existsSync(resolved)) return resolved;\n  }\n  return extensionIndexEntry(target);\n}\n\n/** Path to Pi's own CLI, which the launch command spawns. */\nexport function piCliPath(): string {\n  return path.join(path.dirname(packageEntry('@earendil-works/pi-coding-agent')), 'cli.js');\n}\n"],"mappings":"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"}

package/dist/narration.cjs

@@ -1,10 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_narration = require("./src/schemas/narration.cjs");
-exports.DOOM_NARRATION_SERVICE = require_narration.DOOM_NARRATION_SERVICE;
 exports.MAX_NARRATION_TEXT_CHARACTERS = require_narration.MAX_NARRATION_TEXT_CHARACTERS;
 exports.NarrationRequestSchema = require_narration.NarrationRequestSchema;
+exports.PO_NARRATION_SERVICE = require_narration.PO_NARRATION_SERVICE;
 exports.createNarrationRequest = require_narration.createNarrationRequest;
 exports.isNarrationRequest = require_narration.isNarrationRequest;
 exports.normalizeNarrationText = require_narration.normalizeNarrationText;
-exports.readDoomNarrationService = require_narration.readDoomNarrationService;
-exports.requireDoomNarrationService = require_narration.requireDoomNarrationService;
+exports.readPoNarrationService = require_narration.readPoNarrationService;
+exports.requirePoNarrationService = require_narration.requirePoNarrationService;

package/dist/narration.d.mts

@@ -1,2 +1,2 @@
-import { DOOM_NARRATION_SERVICE, DoomNarrationService, MAX_NARRATION_TEXT_CHARACTERS, NarrationRequest, NarrationRequestSchema, createNarrationRequest, isNarrationRequest, normalizeNarrationText, readDoomNarrationService, requireDoomNarrationService } from "./src/schemas/narration.mjs";
-export { DOOM_NARRATION_SERVICE, type DoomNarrationService, MAX_NARRATION_TEXT_CHARACTERS, type NarrationRequest, NarrationRequestSchema, createNarrationRequest, isNarrationRequest, normalizeNarrationText, readDoomNarrationService, requireDoomNarrationService };
+import { MAX_NARRATION_TEXT_CHARACTERS, NarrationRequest, NarrationRequestSchema, PO_NARRATION_SERVICE, PoNarrationService, createNarrationRequest, isNarrationRequest, normalizeNarrationText, readPoNarrationService, requirePoNarrationService } from "./src/schemas/narration.mjs";
+export { MAX_NARRATION_TEXT_CHARACTERS, type NarrationRequest, NarrationRequestSchema, PO_NARRATION_SERVICE, type PoNarrationService, createNarrationRequest, isNarrationRequest, normalizeNarrationText, readPoNarrationService, requirePoNarrationService };

package/dist/narration.mjs

@@ -1,2 +1 @@
-import { DOOM_NARRATION_SERVICE, MAX_NARRATION_TEXT_CHARACTERS, NarrationRequestSchema, createNarrationRequest, isNarrationRequest, normalizeNarrationText, readDoomNarrationService, requireDoomNarrationService } from "./src/schemas/narration.mjs";
-export { DOOM_NARRATION_SERVICE, MAX_NARRATION_TEXT_CHARACTERS, NarrationRequestSchema, createNarrationRequest, isNarrationRequest, normalizeNarrationText, readDoomNarrationService, requireDoomNarrationService };
+export { MAX_NARRATION_TEXT_CHARACTERS, NarrationRequestSchema, PO_NARRATION_SERVICE, createNarrationRequest, isNarrationRequest, normalizeNarrationText, readPoNarrationService, requirePoNarrationService } from "./src/schemas/narration.mjs";

package/dist/native.cjs

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_home = require("./src/schemas/home.cjs");
 const require_webPlugin = require("./src/extensions/webPlugin.cjs");
 const require_globalStore = require("./src/web/models/globalStore.cjs");
 const require_sessionStore = require("./src/web/models/sessionStore.cjs");
@@ -9,6 +10,9 @@ const require_index$2 = require("./src/web/services/apiRoutes/index.cjs");
 const require_index$3 = require("./src/web/services/nativeApiTransport/index.cjs");
 const require_template = require("./src/web/schemas/template.cjs");
 const require_nativeHost = require("./src/constants/nativeHost.cjs");
+exports.HOME_ENTITY_LIMIT = require_home.HOME_ENTITY_LIMIT;
+exports.HOME_KINDS = require_home.HOME_KINDS;
+exports.HOME_PAGE_LIMIT = require_home.HOME_PAGE_LIMIT;
 exports.NATIVE_HOST_MODULES = require_nativeHost.NATIVE_HOST_MODULES;
 exports.NATIVE_HOST_MODULE_IDS = require_nativeHost.NATIVE_HOST_MODULE_IDS;
 exports.NATIVE_UNISTYLES_COMPONENTS = require_nativeHost.NATIVE_UNISTYLES_COMPONENTS;
@@ -18,6 +22,7 @@ exports.createApiClient = require_index$1.createApiClient;
 exports.defineActivityGroup = require_webPlugin.defineActivityGroup;
 exports.defineApiRoutes = require_index$1.defineApiRoutes;
 exports.defineChannelFile = require_webPlugin.defineChannelFile;
+exports.defineDockFace = require_webPlugin.defineDockFace;
 exports.defineFileLinks = require_webPlugin.defineFileLinks;
 exports.defineFill = require_webPlugin.defineFill;
 exports.defineGlobalStore = require_globalStore.defineGlobalStore;
@@ -34,6 +39,10 @@ exports.defineUserMessageAction = require_webPlugin.defineUserMessageAction;
 exports.defineWebLifecycle = require_webPlugin.defineWebLifecycle;
 exports.defineWorkspaceStore = require_workspaceStore.defineWorkspaceStore;
 exports.nativeApiTransport = require_index$3.nativeApiTransport;
+exports.parseHomeContribution = require_home.parseHomeContribution;
+exports.parseHomeEntity = require_home.parseHomeEntity;
+exports.parseHomeProjection = require_home.parseHomeProjection;
+exports.parseHomeSnapshot = require_home.parseHomeSnapshot;
 exports.parseNativeTemplate = require_template.parseNativeTemplate;
 exports.sessionApiAddress = require_index$2.sessionApiAddress;
 exports.sessionApiPath = require_index$2.sessionApiPath;

package/dist/native.d.mts

@@ -1,8 +1,9 @@
-import { WebTemplateRailActions, WebTemplateRailPendingSetup, WebTemplateRailSession, WebTemplateRailWorkspace } from "./src/web/types/template.mjs";
+import { HOME_ENTITY_LIMIT, HOME_KINDS, HOME_PAGE_LIMIT, HomeContribution, HomeCoverage, HomeEntity, HomeItem, HomeKind, HomeProjection, HomeRequest, HomeSnapshot, HomeSourceStatus, parseHomeContribution, parseHomeEntity, parseHomeProjection, parseHomeSnapshot } from "./src/schemas/home.mjs";
+import { WebTemplateRailActions, WebTemplateRailDirectoryListing, WebTemplateRailPendingSetup, WebTemplateRailSession, WebTemplateRailWorkspace } from "./src/web/types/template.mjs";
 import { NativeTemplateContribution, NativeTemplateScreens, NativeTemplateSessionsActions, NativeTemplateSessionsProps } from "./src/web/types/nativeTemplate.mjs";
 import { ActivityGroupContribution, GlobalStore, SelectionAxisContribution, SessionChannelContribution, SessionFrameSender, SessionRecords, SessionStore, SessionStoreChannel, SettingsSectionContribution, SlotDeclaration, SlotFillContribution, TabContribution, ToolMessageRenderProps, ToolPromptRenderProps, ToolRendererContribution, ToolResultView, UserMessageActionContribution, UserMessageActionRunContext, WebPluginContributions, WebPluginDefinition, WebPluginRuntime, WebPluginSessionContext, WebPluginSlotProps, WorkspaceRecords, WorkspaceStore } from "./src/web/types/webPlugin.mjs";
 import { ActivityGroupFile, ChannelFile, FillFile, NativeTemplateFile, SelectionAxisFile, SettingsSectionFile, SlotFile, TabFile, ToolRendererFile, UserMessageActionFile } from "./src/web/types/extensionFile.mjs";
-import { defineActivityGroup, defineChannelFile, defineFileLinks, defineFill, defineNativeTemplate, defineSelectionAxis, defineSessionChannel, defineSettingsSection, defineSlotFile, defineTab, defineToolRenderer, defineUserMessageAction, defineWebLifecycle, defineWebPlugin } from "./src/extensions/webPlugin.mjs";
+import { defineActivityGroup, defineChannelFile, defineDockFace, defineFileLinks, defineFill, defineNativeTemplate, defineSelectionAxis, defineSessionChannel, defineSettingsSection, defineSlotFile, defineTab, defineToolRenderer, defineUserMessageAction, defineWebLifecycle, defineWebPlugin } from "./src/extensions/webPlugin.mjs";
 import { defineGlobalStore } from "./src/web/models/globalStore.mjs";
 import { defineSessionStore } from "./src/web/models/sessionStore.mjs";
 import { defineWorkspaceStore } from "./src/web/models/workspaceStore.mjs";
@@ -12,4 +13,4 @@ import { sessionApiAddress, sessionApiPath } from "./src/web/services/apiRoutes/
 import { nativeApiTransport } from "./src/web/services/nativeApiTransport/index.mjs";
 import { parseNativeTemplate } from "./src/web/schemas/template.mjs";
 import { NATIVE_HOST_MODULES, NATIVE_HOST_MODULE_IDS, NATIVE_UNISTYLES_COMPONENTS, NATIVE_UNISTYLES_COMPONENT_PREFIX } from "./src/constants/nativeHost.mjs";
-export { type ActivityGroupContribution, type ActivityGroupFile, type ApiCallInit, type ApiResult, type ApiRoutes, type ApiTransport, type ChannelFile, type FillFile, type GlobalStore, NATIVE_HOST_MODULES, NATIVE_HOST_MODULE_IDS, NATIVE_UNISTYLES_COMPONENTS, NATIVE_UNISTYLES_COMPONENT_PREFIX, type NativeTemplateContribution, type NativeTemplateFile, type NativeTemplateScreens, type NativeTemplateSessionsActions, type NativeTemplateSessionsProps, type SelectionAxisContribution, type SelectionAxisFile, type SessionChannelContribution, type SessionFrameSender, type SessionRecords, type SessionStore, type SessionStoreChannel, type SettingsSectionContribution, type SettingsSectionFile, type SlotDeclaration, type SlotFile, type SlotFillContribution, type TabContribution, type TabFile, type ToolMessageRenderProps, type ToolPromptRenderProps, type ToolRendererContribution, type ToolRendererFile, type ToolResultView, type UserMessageActionContribution, type UserMessageActionFile, type UserMessageActionRunContext, type WebPluginContributions, type WebPluginDefinition, type WebPluginRuntime, type WebPluginSessionContext, type WebPluginSlotProps, type WebTemplateRailActions, type WebTemplateRailPendingSetup, type WebTemplateRailSession, type WebTemplateRailWorkspace, type WorkspaceRecords, type WorkspaceStore, apiResponse, createApiClient, defineActivityGroup, defineApiRoutes, defineChannelFile, defineFileLinks, defineFill, defineGlobalStore, defineWebPlugin as defineNativePlugin, defineNativeTemplate, defineSelectionAxis, defineSessionChannel, defineSessionStore, defineSettingsSection, defineSlotFile, defineTab, defineToolRenderer, defineUserMessageAction, defineWebLifecycle, defineWorkspaceStore, nativeApiTransport, parseNativeTemplate, sessionApiAddress, sessionApiPath, toolResultText, toolResultTextLines };
+export { type ActivityGroupContribution, type ActivityGroupFile, type ApiCallInit, type ApiResult, type ApiRoutes, type ApiTransport, type ChannelFile, type FillFile, type GlobalStore, HOME_ENTITY_LIMIT, HOME_KINDS, HOME_PAGE_LIMIT, HomeContribution, HomeCoverage, HomeEntity, HomeItem, HomeKind, HomeProjection, HomeRequest, HomeSnapshot, HomeSourceStatus, NATIVE_HOST_MODULES, NATIVE_HOST_MODULE_IDS, NATIVE_UNISTYLES_COMPONENTS, NATIVE_UNISTYLES_COMPONENT_PREFIX, type NativeTemplateContribution, type NativeTemplateFile, type NativeTemplateScreens, type NativeTemplateSessionsActions, type NativeTemplateSessionsProps, type SelectionAxisContribution, type SelectionAxisFile, type SessionChannelContribution, type SessionFrameSender, type SessionRecords, type SessionStore, type SessionStoreChannel, type SettingsSectionContribution, type SettingsSectionFile, type SlotDeclaration, type SlotFile, type SlotFillContribution, type TabContribution, type TabFile, type ToolMessageRenderProps, type ToolPromptRenderProps, type ToolRendererContribution, type ToolRendererFile, type ToolResultView, type UserMessageActionContribution, type UserMessageActionFile, type UserMessageActionRunContext, type WebPluginContributions, type WebPluginDefinition, type WebPluginRuntime, type WebPluginSessionContext, type WebPluginSlotProps, type WebTemplateRailActions, type WebTemplateRailDirectoryListing, type WebTemplateRailPendingSetup, type WebTemplateRailSession, type WebTemplateRailWorkspace, type WorkspaceRecords, type WorkspaceStore, apiResponse, createApiClient, defineActivityGroup, defineApiRoutes, defineChannelFile, defineDockFace, defineFileLinks, defineFill, defineGlobalStore, defineWebPlugin as defineNativePlugin, defineNativeTemplate, defineSelectionAxis, defineSessionChannel, defineSessionStore, defineSettingsSection, defineSlotFile, defineTab, defineToolRenderer, defineUserMessageAction, defineWebLifecycle, defineWorkspaceStore, nativeApiTransport, parseHomeContribution, parseHomeEntity, parseHomeProjection, parseHomeSnapshot, parseNativeTemplate, sessionApiAddress, sessionApiPath, toolResultText, toolResultTextLines };

package/dist/native.mjs

@@ -1,4 +1,5 @@
-import { defineActivityGroup, defineChannelFile, defineFileLinks, defineFill, defineNativeTemplate, defineSelectionAxis, defineSessionChannel, defineSettingsSection, defineSlotFile, defineTab, defineToolRenderer, defineUserMessageAction, defineWebLifecycle, defineWebPlugin } from "./src/extensions/webPlugin.mjs";
+import { HOME_ENTITY_LIMIT, HOME_KINDS, HOME_PAGE_LIMIT, parseHomeContribution, parseHomeEntity, parseHomeProjection, parseHomeSnapshot } from "./src/schemas/home.mjs";
+import { defineActivityGroup, defineChannelFile, defineDockFace, defineFileLinks, defineFill, defineNativeTemplate, defineSelectionAxis, defineSessionChannel, defineSettingsSection, defineSlotFile, defineTab, defineToolRenderer, defineUserMessageAction, defineWebLifecycle, defineWebPlugin } from "./src/extensions/webPlugin.mjs";
 import { defineGlobalStore } from "./src/web/models/globalStore.mjs";
 import { defineSessionStore } from "./src/web/models/sessionStore.mjs";
 import { defineWorkspaceStore } from "./src/web/models/workspaceStore.mjs";
@@ -8,4 +9,4 @@ import { sessionApiAddress, sessionApiPath } from "./src/web/services/apiRoutes/
 import { nativeApiTransport } from "./src/web/services/nativeApiTransport/index.mjs";
 import { parseNativeTemplate } from "./src/web/schemas/template.mjs";
 import { NATIVE_HOST_MODULES, NATIVE_HOST_MODULE_IDS, NATIVE_UNISTYLES_COMPONENTS, NATIVE_UNISTYLES_COMPONENT_PREFIX } from "./src/constants/nativeHost.mjs";
-export { NATIVE_HOST_MODULES, NATIVE_HOST_MODULE_IDS, NATIVE_UNISTYLES_COMPONENTS, NATIVE_UNISTYLES_COMPONENT_PREFIX, apiResponse, createApiClient, defineActivityGroup, defineApiRoutes, defineChannelFile, defineFileLinks, defineFill, defineGlobalStore, defineWebPlugin as defineNativePlugin, defineNativeTemplate, defineSelectionAxis, defineSessionChannel, defineSessionStore, defineSettingsSection, defineSlotFile, defineTab, defineToolRenderer, defineUserMessageAction, defineWebLifecycle, defineWorkspaceStore, nativeApiTransport, parseNativeTemplate, sessionApiAddress, sessionApiPath, toolResultText, toolResultTextLines };
+export { HOME_ENTITY_LIMIT, HOME_KINDS, HOME_PAGE_LIMIT, NATIVE_HOST_MODULES, NATIVE_HOST_MODULE_IDS, NATIVE_UNISTYLES_COMPONENTS, NATIVE_UNISTYLES_COMPONENT_PREFIX, apiResponse, createApiClient, defineActivityGroup, defineApiRoutes, defineChannelFile, defineDockFace, defineFileLinks, defineFill, defineGlobalStore, defineWebPlugin as defineNativePlugin, defineNativeTemplate, defineSelectionAxis, defineSessionChannel, defineSessionStore, defineSettingsSection, defineSlotFile, defineTab, defineToolRenderer, defineUserMessageAction, defineWebLifecycle, defineWorkspaceStore, nativeApiTransport, parseHomeContribution, parseHomeEntity, parseHomeProjection, parseHomeSnapshot, parseNativeTemplate, sessionApiAddress, sessionApiPath, toolResultText, toolResultTextLines };

package/dist/nodePlatform.cjs

@@ -0,0 +1,77 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
+const require_historyOwnership = require("./historyOwnership.cjs");
+const require_index = require("./src/services/durableSession/index.cjs");
+const require_sqliteSessionStorage = require("./sqliteSessionStorage.cjs");
+let node_os = require("node:os");
+node_os = require_runtime.__toESM(node_os, 1);
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path, 1);
+let node_fs_promises = require("node:fs/promises");
+node_fs_promises = require_runtime.__toESM(node_fs_promises, 1);
+let _earendil_works_pi_durable_storage_sqlite_node = require("@earendil-works/pi-durable/storage/sqlite/node");
+let _earendil_works_pi_durable_env_node = require("@earendil-works/pi-durable/env/node");
+//#region src/services/nodePlatform/index.ts
+/** One lock-owned durable-v1 SQLite file per agent session. */
+function createNodeSessions(options) {
+	let historyOwnership = options.historyOwnership;
+	const root = () => {
+		if (options.sessionsRoot === void 0) throw new Error("This Node platform was given no sessions root.");
+		return options.sessionsRoot;
+	};
+	return {
+		abiVersion: 1,
+		async open(request, context) {
+			historyOwnership ??= require_historyOwnership.createHistoryOwnership({ sourceFormat: "sqlite" });
+			const opened = await require_sqliteSessionStorage.openSqliteSessionStorage({
+				...request,
+				sessionsRoot: root(),
+				historyOwnership
+			}, context);
+			return {
+				storage: opened.storage,
+				assertWritable: () => opened.historyLease.assertQuiescent(),
+				async release(releaseContext) {
+					await opened.session.close(releaseContext);
+					await opened.historyLease.release();
+				}
+			};
+		},
+		openReadOnly: async (sessionId) => require_sqliteSessionStorage.openReadOnlyDurableStorage(require_sqliteSessionStorage.sqliteSessionFile(root(), sessionId)),
+		async list() {
+			const directory = node_path.default.join(root(), require_index.DURABLE_DIRECTORY);
+			const files = await node_fs_promises.default.readdir(directory).catch((error) => {
+				if (error.code === "ENOENT") return [];
+				throw error;
+			});
+			const stored = [];
+			for (const file of files) {
+				if (!/^[a-zA-Z0-9_-]+\.sqlite$/u.test(file)) continue;
+				const { mtimeMs } = await node_fs_promises.default.stat(node_path.default.join(directory, file));
+				stored.push({
+					sessionId: node_path.default.basename(file, ".sqlite"),
+					updatedAt: mtimeMs
+				});
+			}
+			return stored;
+		}
+	};
+}
+/** The Node host: local files and shell, `node:sqlite` files, and lock-owned durable-v1 sessions. */
+function createNodePlatform(options = {}) {
+	return {
+		abiVersion: 1,
+		homeDirectory: options.homeDirectory ?? node_os.default.homedir(),
+		temporaryDirectory: process.platform === "darwin" || process.platform === "linux" ? options.temporaryDirectory ?? node_os.default.tmpdir() : void 0,
+		env: (cwd) => new _earendil_works_pi_durable_env_node.NodeExecutionEnv({ cwd }),
+		sqlite: {
+			abiVersion: 1,
+			open: (file) => (0, _earendil_works_pi_durable_storage_sqlite_node.openNodeSqliteDatabase)(file)
+		},
+		sessions: createNodeSessions(options)
+	};
+}
+//#endregion
+exports.createNodePlatform = createNodePlatform;
+
+//# sourceMappingURL=nodePlatform.cjs.map

package/dist/nodePlatform.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodePlatform.cjs","names":["createHistoryOwnership","openSqliteSessionStorage","openReadOnlyDurableStorage","sqliteSessionFile","path","DURABLE_DIRECTORY","fs","os","NodeExecutionEnv","openNodeSqliteDatabase"],"sources":["../src/services/nodePlatform/index.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport os from 'node:os';\nimport path from 'node:path';\n\nimport { NodeExecutionEnv } from '@earendil-works/pi-durable/env/node';\nimport { openNodeSqliteDatabase } from '@earendil-works/pi-durable/storage/sqlite/node';\n\nimport type { PoPlatform, PoSessionStorageService, PoStoredSession } from '../../schemas/platform';\nimport { DURABLE_DIRECTORY } from '../durableSession';\nimport { createHistoryOwnership } from '../historyOwnership';\nimport type { HistoryOwnership } from '../historyOwnership/type';\nimport { openReadOnlyDurableStorage, openSqliteSessionStorage, sqliteSessionFile } from '../sqliteSessionStorage';\n\nexport interface NodePlatformOptions {\n  /** Defaults to the user's home directory. */\n  readonly homeDirectory?: string;\n  /** Host-admitted override; defaults to this Node host's OS temporary directory. */\n  readonly temporaryDirectory?: string;\n  /** Where the launching entry keeps agent sessions. Without it `sessions` refuses every call. */\n  readonly sessionsRoot?: string;\n  /** Shared ownership for every session this platform opens; created on first open when absent. */\n  readonly historyOwnership?: HistoryOwnership;\n}\n\n/** One lock-owned durable-v1 SQLite file per agent session. */\nfunction createNodeSessions(options: NodePlatformOptions): PoSessionStorageService {\n  let historyOwnership = options.historyOwnership;\n  const root = () => {\n    if (options.sessionsRoot === undefined) throw new Error('This Node platform was given no sessions root.');\n    return options.sessionsRoot;\n  };\n  return {\n    abiVersion: 1,\n    async open(request, context) {\n      historyOwnership ??= createHistoryOwnership({ sourceFormat: 'sqlite' });\n      const opened = await openSqliteSessionStorage({ ...request, sessionsRoot: root(), historyOwnership }, context);\n      return {\n        storage: opened.storage,\n        assertWritable: () => opened.historyLease.assertQuiescent(),\n        async release(releaseContext) {\n          // The lease outlives a failed close so no second writer opens a file still being written.\n          await opened.session.close(releaseContext);\n          await opened.historyLease.release();\n        },\n      };\n    },\n    openReadOnly: async (sessionId) => openReadOnlyDurableStorage(sqliteSessionFile(root(), sessionId)),\n    async list() {\n      const directory = path.join(root(), DURABLE_DIRECTORY);\n      const files = await fs.readdir(directory).catch((error: NodeJS.ErrnoException) => {\n        if (error.code === 'ENOENT') return [];\n        throw error;\n      });\n      const stored: PoStoredSession[] = [];\n      for (const file of files) {\n        if (!/^[a-zA-Z0-9_-]+\\.sqlite$/u.test(file)) continue;\n        const { mtimeMs } = await fs.stat(path.join(directory, file));\n        stored.push({ sessionId: path.basename(file, '.sqlite'), updatedAt: mtimeMs });\n      }\n      return stored;\n    },\n  };\n}\n\n/** The Node host: local files and shell, `node:sqlite` files, and lock-owned durable-v1 sessions. */\nexport function createNodePlatform(options: NodePlatformOptions = {}): PoPlatform {\n  return {\n    abiVersion: 1,\n    homeDirectory: options.homeDirectory ?? os.homedir(),\n    // Secure session-file protection and viewing currently require POSIX ownership semantics.\n    temporaryDirectory:\n      process.platform === 'darwin' || process.platform === 'linux'\n        ? (options.temporaryDirectory ?? os.tmpdir())\n        : undefined,\n    env: (cwd) => new NodeExecutionEnv({ cwd }),\n    sqlite: { abiVersion: 1, open: (file) => openNodeSqliteDatabase(file) },\n    sessions: createNodeSessions(options),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;AAyBA,SAAS,mBAAmB,SAAuD;CACjF,IAAI,mBAAmB,QAAQ;CAC/B,MAAM,aAAa;EACjB,IAAI,QAAQ,iBAAiB,KAAA,GAAW,MAAM,IAAI,MAAM,gDAAgD;EACxG,OAAO,QAAQ;CACjB;CACA,OAAO;EACL,YAAY;EACZ,MAAM,KAAK,SAAS,SAAS;GAC3B,qBAAqBA,yBAAAA,uBAAuB,EAAE,cAAc,SAAS,CAAC;GACtE,MAAM,SAAS,MAAMC,6BAAAA,yBAAyB;IAAE,GAAG;IAAS,cAAc,KAAK;IAAG;GAAiB,GAAG,OAAO;GAC7G,OAAO;IACL,SAAS,OAAO;IAChB,sBAAsB,OAAO,aAAa,gBAAgB;IAC1D,MAAM,QAAQ,gBAAgB;KAE5B,MAAM,OAAO,QAAQ,MAAM,cAAc;KACzC,MAAM,OAAO,aAAa,QAAQ;IACpC;GACF;EACF;EACA,cAAc,OAAO,cAAcC,6BAAAA,2BAA2BC,6BAAAA,kBAAkB,KAAK,GAAG,SAAS,CAAC;EAClG,MAAM,OAAO;GACX,MAAM,YAAYC,UAAAA,QAAK,KAAK,KAAK,GAAGC,cAAAA,iBAAiB;GACrD,MAAM,QAAQ,MAAMC,iBAAAA,QAAG,QAAQ,SAAS,CAAC,CAAC,OAAO,UAAiC;IAChF,IAAI,MAAM,SAAS,UAAU,OAAO,CAAC;IACrC,MAAM;GACR,CAAC;GACD,MAAM,SAA4B,CAAC;GACnC,KAAK,MAAM,QAAQ,OAAO;IACxB,IAAI,CAAC,4BAA4B,KAAK,IAAI,GAAG;IAC7C,MAAM,EAAE,YAAY,MAAMA,iBAAAA,QAAG,KAAKF,UAAAA,QAAK,KAAK,WAAW,IAAI,CAAC;IAC5D,OAAO,KAAK;KAAE,WAAWA,UAAAA,QAAK,SAAS,MAAM,SAAS;KAAG,WAAW;IAAQ,CAAC;GAC/E;GACA,OAAO;EACT;CACF;AACF;;AAGA,SAAgB,mBAAmB,UAA+B,CAAC,GAAe;CAChF,OAAO;EACL,YAAY;EACZ,eAAe,QAAQ,iBAAiBG,QAAAA,QAAG,QAAQ;EAEnD,oBACE,QAAQ,aAAa,YAAY,QAAQ,aAAa,UACjD,QAAQ,sBAAsBA,QAAAA,QAAG,OAAO,IACzC,KAAA;EACN,MAAM,QAAQ,IAAIC,oCAAAA,iBAAiB,EAAE,IAAI,CAAC;EAC1C,QAAQ;GAAE,YAAY;GAAG,OAAO,UAAA,GAASC,+CAAAA,uBAAAA,CAAuB,IAAI;EAAE;EACtE,UAAU,mBAAmB,OAAO;CACtC;AACF"}

package/dist/nodePlatform.d.mts

@@ -0,0 +1,17 @@
+import { PoPlatform } from "./src/schemas/platform.mjs";
+import { HistoryOwnership } from "./src/services/historyOwnership/type.mjs";
+//#region src/services/nodePlatform/index.d.ts
+export interface NodePlatformOptions {
+  /** Defaults to the user's home directory. */
+  readonly homeDirectory?: string;
+  /** Host-admitted override; defaults to this Node host's OS temporary directory. */
+  readonly temporaryDirectory?: string;
+  /** Where the launching entry keeps agent sessions. Without it `sessions` refuses every call. */
+  readonly sessionsRoot?: string;
+  /** Shared ownership for every session this platform opens; created on first open when absent. */
+  readonly historyOwnership?: HistoryOwnership;
+}
+/** The Node host: local files and shell, `node:sqlite` files, and lock-owned durable-v1 sessions. */
+export declare function createNodePlatform(options?: NodePlatformOptions): PoPlatform;
+//#endregion
+//# sourceMappingURL=nodePlatform.d.mts.map

package/dist/nodePlatform.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodePlatform.d.mts","names":[],"sources":["../src/services/nodePlatform/index.ts"],"mappings":";;;iBAaiB;;WAEN;;WAEA;;WAEA;;WAEA,mBAAmB;;;wBA4Cd,mBAAmB,UAAS,sBAA2B"}

package/dist/nodePlatform.mjs

@@ -0,0 +1,72 @@
+import { createHistoryOwnership } from "./historyOwnership.mjs";
+import { DURABLE_DIRECTORY } from "./src/services/durableSession/index.mjs";
+import { openReadOnlyDurableStorage, openSqliteSessionStorage, sqliteSessionFile } from "./sqliteSessionStorage.mjs";
+import os from "node:os";
+import path from "node:path";
+import fs from "node:fs/promises";
+import { openNodeSqliteDatabase } from "@earendil-works/pi-durable/storage/sqlite/node";
+import { NodeExecutionEnv } from "@earendil-works/pi-durable/env/node";
+//#region src/services/nodePlatform/index.ts
+/** One lock-owned durable-v1 SQLite file per agent session. */
+function createNodeSessions(options) {
+	let historyOwnership = options.historyOwnership;
+	const root = () => {
+		if (options.sessionsRoot === void 0) throw new Error("This Node platform was given no sessions root.");
+		return options.sessionsRoot;
+	};
+	return {
+		abiVersion: 1,
+		async open(request, context) {
+			historyOwnership ??= createHistoryOwnership({ sourceFormat: "sqlite" });
+			const opened = await openSqliteSessionStorage({
+				...request,
+				sessionsRoot: root(),
+				historyOwnership
+			}, context);
+			return {
+				storage: opened.storage,
+				assertWritable: () => opened.historyLease.assertQuiescent(),
+				async release(releaseContext) {
+					await opened.session.close(releaseContext);
+					await opened.historyLease.release();
+				}
+			};
+		},
+		openReadOnly: async (sessionId) => openReadOnlyDurableStorage(sqliteSessionFile(root(), sessionId)),
+		async list() {
+			const directory = path.join(root(), DURABLE_DIRECTORY);
+			const files = await fs.readdir(directory).catch((error) => {
+				if (error.code === "ENOENT") return [];
+				throw error;
+			});
+			const stored = [];
+			for (const file of files) {
+				if (!/^[a-zA-Z0-9_-]+\.sqlite$/u.test(file)) continue;
+				const { mtimeMs } = await fs.stat(path.join(directory, file));
+				stored.push({
+					sessionId: path.basename(file, ".sqlite"),
+					updatedAt: mtimeMs
+				});
+			}
+			return stored;
+		}
+	};
+}
+/** The Node host: local files and shell, `node:sqlite` files, and lock-owned durable-v1 sessions. */
+function createNodePlatform(options = {}) {
+	return {
+		abiVersion: 1,
+		homeDirectory: options.homeDirectory ?? os.homedir(),
+		temporaryDirectory: process.platform === "darwin" || process.platform === "linux" ? options.temporaryDirectory ?? os.tmpdir() : void 0,
+		env: (cwd) => new NodeExecutionEnv({ cwd }),
+		sqlite: {
+			abiVersion: 1,
+			open: (file) => openNodeSqliteDatabase(file)
+		},
+		sessions: createNodeSessions(options)
+	};
+}
+//#endregion
+export { createNodePlatform };
+
+//# sourceMappingURL=nodePlatform.mjs.map

package/dist/nodePlatform.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodePlatform.mjs","names":[],"sources":["../src/services/nodePlatform/index.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport os from 'node:os';\nimport path from 'node:path';\n\nimport { NodeExecutionEnv } from '@earendil-works/pi-durable/env/node';\nimport { openNodeSqliteDatabase } from '@earendil-works/pi-durable/storage/sqlite/node';\n\nimport type { PoPlatform, PoSessionStorageService, PoStoredSession } from '../../schemas/platform';\nimport { DURABLE_DIRECTORY } from '../durableSession';\nimport { createHistoryOwnership } from '../historyOwnership';\nimport type { HistoryOwnership } from '../historyOwnership/type';\nimport { openReadOnlyDurableStorage, openSqliteSessionStorage, sqliteSessionFile } from '../sqliteSessionStorage';\n\nexport interface NodePlatformOptions {\n  /** Defaults to the user's home directory. */\n  readonly homeDirectory?: string;\n  /** Host-admitted override; defaults to this Node host's OS temporary directory. */\n  readonly temporaryDirectory?: string;\n  /** Where the launching entry keeps agent sessions. Without it `sessions` refuses every call. */\n  readonly sessionsRoot?: string;\n  /** Shared ownership for every session this platform opens; created on first open when absent. */\n  readonly historyOwnership?: HistoryOwnership;\n}\n\n/** One lock-owned durable-v1 SQLite file per agent session. */\nfunction createNodeSessions(options: NodePlatformOptions): PoSessionStorageService {\n  let historyOwnership = options.historyOwnership;\n  const root = () => {\n    if (options.sessionsRoot === undefined) throw new Error('This Node platform was given no sessions root.');\n    return options.sessionsRoot;\n  };\n  return {\n    abiVersion: 1,\n    async open(request, context) {\n      historyOwnership ??= createHistoryOwnership({ sourceFormat: 'sqlite' });\n      const opened = await openSqliteSessionStorage({ ...request, sessionsRoot: root(), historyOwnership }, context);\n      return {\n        storage: opened.storage,\n        assertWritable: () => opened.historyLease.assertQuiescent(),\n        async release(releaseContext) {\n          // The lease outlives a failed close so no second writer opens a file still being written.\n          await opened.session.close(releaseContext);\n          await opened.historyLease.release();\n        },\n      };\n    },\n    openReadOnly: async (sessionId) => openReadOnlyDurableStorage(sqliteSessionFile(root(), sessionId)),\n    async list() {\n      const directory = path.join(root(), DURABLE_DIRECTORY);\n      const files = await fs.readdir(directory).catch((error: NodeJS.ErrnoException) => {\n        if (error.code === 'ENOENT') return [];\n        throw error;\n      });\n      const stored: PoStoredSession[] = [];\n      for (const file of files) {\n        if (!/^[a-zA-Z0-9_-]+\\.sqlite$/u.test(file)) continue;\n        const { mtimeMs } = await fs.stat(path.join(directory, file));\n        stored.push({ sessionId: path.basename(file, '.sqlite'), updatedAt: mtimeMs });\n      }\n      return stored;\n    },\n  };\n}\n\n/** The Node host: local files and shell, `node:sqlite` files, and lock-owned durable-v1 sessions. */\nexport function createNodePlatform(options: NodePlatformOptions = {}): PoPlatform {\n  return {\n    abiVersion: 1,\n    homeDirectory: options.homeDirectory ?? os.homedir(),\n    // Secure session-file protection and viewing currently require POSIX ownership semantics.\n    temporaryDirectory:\n      process.platform === 'darwin' || process.platform === 'linux'\n        ? (options.temporaryDirectory ?? os.tmpdir())\n        : undefined,\n    env: (cwd) => new NodeExecutionEnv({ cwd }),\n    sqlite: { abiVersion: 1, open: (file) => openNodeSqliteDatabase(file) },\n    sessions: createNodeSessions(options),\n  };\n}\n"],"mappings":";;;;;;;;;;AAyBA,SAAS,mBAAmB,SAAuD;CACjF,IAAI,mBAAmB,QAAQ;CAC/B,MAAM,aAAa;EACjB,IAAI,QAAQ,iBAAiB,KAAA,GAAW,MAAM,IAAI,MAAM,gDAAgD;EACxG,OAAO,QAAQ;CACjB;CACA,OAAO;EACL,YAAY;EACZ,MAAM,KAAK,SAAS,SAAS;GAC3B,qBAAqB,uBAAuB,EAAE,cAAc,SAAS,CAAC;GACtE,MAAM,SAAS,MAAM,yBAAyB;IAAE,GAAG;IAAS,cAAc,KAAK;IAAG;GAAiB,GAAG,OAAO;GAC7G,OAAO;IACL,SAAS,OAAO;IAChB,sBAAsB,OAAO,aAAa,gBAAgB;IAC1D,MAAM,QAAQ,gBAAgB;KAE5B,MAAM,OAAO,QAAQ,MAAM,cAAc;KACzC,MAAM,OAAO,aAAa,QAAQ;IACpC;GACF;EACF;EACA,cAAc,OAAO,cAAc,2BAA2B,kBAAkB,KAAK,GAAG,SAAS,CAAC;EAClG,MAAM,OAAO;GACX,MAAM,YAAY,KAAK,KAAK,KAAK,GAAG,iBAAiB;GACrD,MAAM,QAAQ,MAAM,GAAG,QAAQ,SAAS,CAAC,CAAC,OAAO,UAAiC;IAChF,IAAI,MAAM,SAAS,UAAU,OAAO,CAAC;IACrC,MAAM;GACR,CAAC;GACD,MAAM,SAA4B,CAAC;GACnC,KAAK,MAAM,QAAQ,OAAO;IACxB,IAAI,CAAC,4BAA4B,KAAK,IAAI,GAAG;IAC7C,MAAM,EAAE,YAAY,MAAM,GAAG,KAAK,KAAK,KAAK,WAAW,IAAI,CAAC;IAC5D,OAAO,KAAK;KAAE,WAAW,KAAK,SAAS,MAAM,SAAS;KAAG,WAAW;IAAQ,CAAC;GAC/E;GACA,OAAO;EACT;CACF;AACF;;AAGA,SAAgB,mBAAmB,UAA+B,CAAC,GAAe;CAChF,OAAO;EACL,YAAY;EACZ,eAAe,QAAQ,iBAAiB,GAAG,QAAQ;EAEnD,oBACE,QAAQ,aAAa,YAAY,QAAQ,aAAa,UACjD,QAAQ,sBAAsB,GAAG,OAAO,IACzC,KAAA;EACN,MAAM,QAAQ,IAAI,iBAAiB,EAAE,IAAI,CAAC;EAC1C,QAAQ;GAAE,YAAY;GAAG,OAAO,SAAS,uBAAuB,IAAI;EAAE;EACtE,UAAU,mBAAmB,OAAO;CACtC;AACF"}

package/dist/notification.cjs

@@ -1,17 +1,17 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_notification = require("./src/schemas/notification.cjs");
-exports.DOOM_NOTIFICATION_ENTRY_TYPE = require_notification.DOOM_NOTIFICATION_ENTRY_TYPE;
-exports.DOOM_NOTIFICATION_ENTRY_VERSION = require_notification.DOOM_NOTIFICATION_ENTRY_VERSION;
-exports.DOOM_NOTIFICATION_SERVICE = require_notification.DOOM_NOTIFICATION_SERVICE;
-exports.DoomNotificationEntryDataSchema = require_notification.DoomNotificationEntryDataSchema;
-exports.DoomNotificationLevelSchema = require_notification.DoomNotificationLevelSchema;
-exports.DoomNotificationRequestSchema = require_notification.DoomNotificationRequestSchema;
-exports.MAX_DOOM_NOTIFICATION_BODY_CHARACTERS = require_notification.MAX_DOOM_NOTIFICATION_BODY_CHARACTERS;
-exports.MAX_DOOM_NOTIFICATION_SUBTITLE_CHARACTERS = require_notification.MAX_DOOM_NOTIFICATION_SUBTITLE_CHARACTERS;
-exports.MAX_DOOM_NOTIFICATION_TITLE_CHARACTERS = require_notification.MAX_DOOM_NOTIFICATION_TITLE_CHARACTERS;
-exports.createDoomNotificationEntryData = require_notification.createDoomNotificationEntryData;
-exports.isDoomNotificationEntryData = require_notification.isDoomNotificationEntryData;
-exports.isDoomNotificationRequest = require_notification.isDoomNotificationRequest;
-exports.normalizeDoomNotificationRequest = require_notification.normalizeDoomNotificationRequest;
-exports.readDoomNotificationService = require_notification.readDoomNotificationService;
-exports.requireDoomNotificationService = require_notification.requireDoomNotificationService;
+exports.MAX_PO_NOTIFICATION_BODY_CHARACTERS = require_notification.MAX_PO_NOTIFICATION_BODY_CHARACTERS;
+exports.MAX_PO_NOTIFICATION_SUBTITLE_CHARACTERS = require_notification.MAX_PO_NOTIFICATION_SUBTITLE_CHARACTERS;
+exports.MAX_PO_NOTIFICATION_TITLE_CHARACTERS = require_notification.MAX_PO_NOTIFICATION_TITLE_CHARACTERS;
+exports.PO_NOTIFICATION_ENTRY_TYPE = require_notification.PO_NOTIFICATION_ENTRY_TYPE;
+exports.PO_NOTIFICATION_ENTRY_VERSION = require_notification.PO_NOTIFICATION_ENTRY_VERSION;
+exports.PO_NOTIFICATION_SERVICE = require_notification.PO_NOTIFICATION_SERVICE;
+exports.PoNotificationEntryDataSchema = require_notification.PoNotificationEntryDataSchema;
+exports.PoNotificationLevelSchema = require_notification.PoNotificationLevelSchema;
+exports.PoNotificationRequestSchema = require_notification.PoNotificationRequestSchema;
+exports.createPoNotificationEntryData = require_notification.createPoNotificationEntryData;
+exports.isPoNotificationEntryData = require_notification.isPoNotificationEntryData;
+exports.isPoNotificationRequest = require_notification.isPoNotificationRequest;
+exports.normalizePoNotificationRequest = require_notification.normalizePoNotificationRequest;
+exports.readPoNotificationService = require_notification.readPoNotificationService;
+exports.requirePoNotificationService = require_notification.requirePoNotificationService;

package/dist/notification.d.mts

@@ -1,2 +1,2 @@
-import { DOOM_NOTIFICATION_ENTRY_TYPE, DOOM_NOTIFICATION_ENTRY_VERSION, DOOM_NOTIFICATION_SERVICE, DoomNotificationEntryData, DoomNotificationEntryDataSchema, DoomNotificationLevel, DoomNotificationLevelSchema, DoomNotificationRequest, DoomNotificationRequestSchema, DoomNotificationService, MAX_DOOM_NOTIFICATION_BODY_CHARACTERS, MAX_DOOM_NOTIFICATION_SUBTITLE_CHARACTERS, MAX_DOOM_NOTIFICATION_TITLE_CHARACTERS, createDoomNotificationEntryData, isDoomNotificationEntryData, isDoomNotificationRequest, normalizeDoomNotificationRequest, readDoomNotificationService, requireDoomNotificationService } from "./src/schemas/notification.mjs";
-export { DOOM_NOTIFICATION_ENTRY_TYPE, DOOM_NOTIFICATION_ENTRY_VERSION, DOOM_NOTIFICATION_SERVICE, type DoomNotificationEntryData, DoomNotificationEntryDataSchema, type DoomNotificationLevel, DoomNotificationLevelSchema, type DoomNotificationRequest, DoomNotificationRequestSchema, type DoomNotificationService, MAX_DOOM_NOTIFICATION_BODY_CHARACTERS, MAX_DOOM_NOTIFICATION_SUBTITLE_CHARACTERS, MAX_DOOM_NOTIFICATION_TITLE_CHARACTERS, createDoomNotificationEntryData, isDoomNotificationEntryData, isDoomNotificationRequest, normalizeDoomNotificationRequest, readDoomNotificationService, requireDoomNotificationService };
+import { MAX_PO_NOTIFICATION_BODY_CHARACTERS, MAX_PO_NOTIFICATION_SUBTITLE_CHARACTERS, MAX_PO_NOTIFICATION_TITLE_CHARACTERS, PO_NOTIFICATION_ENTRY_TYPE, PO_NOTIFICATION_ENTRY_VERSION, PO_NOTIFICATION_SERVICE, PoNotificationEntryData, PoNotificationEntryDataSchema, PoNotificationLevel, PoNotificationLevelSchema, PoNotificationRequest, PoNotificationRequestSchema, PoNotificationService, createPoNotificationEntryData, isPoNotificationEntryData, isPoNotificationRequest, normalizePoNotificationRequest, readPoNotificationService, requirePoNotificationService } from "./src/schemas/notification.mjs";
+export { MAX_PO_NOTIFICATION_BODY_CHARACTERS, MAX_PO_NOTIFICATION_SUBTITLE_CHARACTERS, MAX_PO_NOTIFICATION_TITLE_CHARACTERS, PO_NOTIFICATION_ENTRY_TYPE, PO_NOTIFICATION_ENTRY_VERSION, PO_NOTIFICATION_SERVICE, type PoNotificationEntryData, PoNotificationEntryDataSchema, type PoNotificationLevel, PoNotificationLevelSchema, type PoNotificationRequest, PoNotificationRequestSchema, type PoNotificationService, createPoNotificationEntryData, isPoNotificationEntryData, isPoNotificationRequest, normalizePoNotificationRequest, readPoNotificationService, requirePoNotificationService };