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

package/dist/src/services/nodeHost/index.d.mts

@@ -0,0 +1,16 @@
+//#region src/services/nodeHost/index.d.ts
+/**
+ * Host details that only a Node process has. Portable modules reach them through
+ * this seam; the edge build swaps in `index.edge.ts`.
+ */
+export declare const nodeHost: {
+  homeDirectory: () => string;
+  temporaryDirectory: () => string;
+  processId: () => number;
+  /** POSIX permission bits; the edge has no owner to protect against, so it skips this. */
+  setMode: (filePath: string, mode: number) => Promise<void>;
+  /** POSIX permission bits of an existing file, or `undefined` when it is missing. */
+  fileMode: (filePath: string) => Promise<number | undefined>;
+};
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/src/services/nodeHost/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../../../src/services/nodeHost/index.ts"],"mappings":";;;;;qBAOa;EACX;EACA;EACA;;EAEA,UAAO,kBAAmB,iBAAiB;;EAE3C,WAAQ,qBAA4B"}

package/dist/src/services/nodeHost/index.mjs

@@ -0,0 +1,27 @@
+import os from "node:os";
+import fs from "node:fs/promises";
+//#region src/services/nodeHost/index.ts
+/**
+* Host details that only a Node process has. Portable modules reach them through
+* this seam; the edge build swaps in `index.edge.ts`.
+*/
+const nodeHost = {
+	homeDirectory: () => os.homedir(),
+	temporaryDirectory: () => os.tmpdir(),
+	processId: () => process.pid,
+	/** POSIX permission bits; the edge has no owner to protect against, so it skips this. */
+	setMode: (filePath, mode) => fs.chmod(filePath, mode),
+	/** POSIX permission bits of an existing file, or `undefined` when it is missing. */
+	fileMode: async (filePath) => {
+		try {
+			return (await fs.stat(filePath)).mode & 4095;
+		} catch (error) {
+			if (error.code === "ENOENT") return void 0;
+			throw error;
+		}
+	}
+};
+//#endregion
+export { nodeHost };
+
+//# sourceMappingURL=index.mjs.map

package/dist/src/services/nodeHost/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/nodeHost/index.ts"],"sourcesContent":["import fs from 'node:fs/promises';\nimport os from 'node:os';\n\n/**\n * Host details that only a Node process has. Portable modules reach them through\n * this seam; the edge build swaps in `index.edge.ts`.\n */\nexport const nodeHost = {\n  homeDirectory: (): string => os.homedir(),\n  temporaryDirectory: (): string => os.tmpdir(),\n  processId: (): number => process.pid,\n  /** POSIX permission bits; the edge has no owner to protect against, so it skips this. */\n  setMode: (filePath: string, mode: number): Promise<void> => fs.chmod(filePath, mode),\n  /** POSIX permission bits of an existing file, or `undefined` when it is missing. */\n  fileMode: async (filePath: string): Promise<number | undefined> => {\n    try {\n      return (await fs.stat(filePath)).mode & 0o7777;\n    } catch (error) {\n      if ((error as NodeJS.ErrnoException).code === 'ENOENT') return undefined;\n      throw error;\n    }\n  },\n};\n"],"mappings":";;;;;;;AAOA,MAAa,WAAW;CACtB,qBAA6B,GAAG,QAAQ;CACxC,0BAAkC,GAAG,OAAO;CAC5C,iBAAyB,QAAQ;;CAEjC,UAAU,UAAkB,SAAgC,GAAG,MAAM,UAAU,IAAI;;CAEnF,UAAU,OAAO,aAAkD;EACjE,IAAI;GACF,QAAQ,MAAM,GAAG,KAAK,QAAQ,EAAA,CAAG,OAAO;EAC1C,SAAS,OAAO;GACd,IAAK,MAAgC,SAAS,UAAU,OAAO,KAAA;GAC/D,MAAM;EACR;CACF;AACF"}

package/dist/src/services/nodeModelDependencies/index.cjs

@@ -0,0 +1,89 @@
+const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
+const require_sync = require("../piSettings/sync.cjs");
+require("../../../runtimePiSettings.cjs");
+const require_index = require("../chatgptLogin/index.cjs");
+const require_headless = require("../../schemas/headless.cjs");
+const require_index$1 = require("../piExtensionHost/index.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);
+let _earendil_works_pi_coding_agent = require("@earendil-works/pi-coding-agent");
+//#region src/services/nodeModelDependencies/index.ts
+async function resolveModel(parsed, modelRuntime, settings) {
+	const cli = (0, _earendil_works_pi_coding_agent.resolveCliModel)({
+		cliProvider: parsed.provider,
+		cliModel: parsed.model,
+		cliThinking: parsed.thinking,
+		modelRuntime
+	});
+	if (cli.error) throw new Error(cli.error);
+	let scoped;
+	if (parsed.models !== void 0 && parsed.models.length > 0) {
+		scoped = (await (0, _earendil_works_pi_coding_agent.resolveModelScopeWithDiagnostics)(parsed.models, modelRuntime)).scopedModels[0]?.model;
+		if (scoped === void 0) throw new require_headless.PoSessionSetupError(`No configured model matched --models ${parsed.models.join(", ")}.`);
+	}
+	const configured = cli.model ?? scoped ?? (settings.getDefaultProvider() && settings.getDefaultModel() ? modelRuntime.getModel(settings.getDefaultProvider(), settings.getDefaultModel()) : void 0) ?? (await modelRuntime.getAvailable())[0];
+	if (configured === void 0) {
+		const agentDir = (0, _earendil_works_pi_coding_agent.getAgentDir)();
+		const runtimeError = modelRuntime.getError();
+		throw new require_headless.PoSessionSetupError(`No model is configured, so the session cannot start. Add a provider and its credentials in ${agentDir} (auth.json, or models.json for a custom provider), then set defaultProvider and defaultModel in ${node_path.default.join(agentDir, "settings.json")}.` + (runtimeError ? `\n\n${runtimeError}` : ""));
+	}
+	return {
+		model: configured,
+		thinkingLevel: cli.thinkingLevel ?? parsed.thinking ?? settings.getModelThinkingLevel(configured.provider, configured.id) ?? settings.getDefaultThinkingLevel()
+	};
+}
+/** Models, settings and Pi extensions from `~/.pi/agent` and the worktree, as the Node server loads them. */
+async function createNodeModelDependencies(options) {
+	const agentDir = (0, _earendil_works_pi_coding_agent.getAgentDir)();
+	const settings = _earendil_works_pi_coding_agent.SettingsManager.create(options.cwd, agentDir);
+	const modelDir = require_sync.modelConfigDirectory(agentDir);
+	const settingsDir = require_sync.modelSettingsDirectory(agentDir);
+	const modelSettings = settingsDir === agentDir ? settings : _earendil_works_pi_coding_agent.SettingsManager.create(options.cwd, settingsDir);
+	const modelRuntime = await _earendil_works_pi_coding_agent.ModelRuntime.create({
+		authPath: node_path.default.join(modelDir, "auth.json"),
+		modelsPath: node_path.default.join(modelDir, "models.json"),
+		refreshOnCreate: false
+	});
+	require_index.registerChatgptAuthProvider(modelRuntime);
+	const piExtensionPaths = options.piExtensions === false ? [] : [
+		...options.piExtensionFactories !== void 0 ? [] : options.piExtensionPaths ?? [],
+		...await require_index$1.resolvePiSettingsPackageEntries({
+			cwd: options.cwd,
+			agentDir,
+			settings,
+			...options.onNotice === void 0 ? {} : { onNotice: options.onNotice }
+		}),
+		...modelDir !== agentDir && node_fs.default.existsSync(node_path.default.join(modelDir, "extensions")) ? [node_path.default.join(modelDir, "extensions")] : []
+	];
+	const piPreload = await require_index$1.preloadPiExtensions({
+		cwd: options.cwd,
+		agentDir,
+		models: modelRuntime,
+		extensionPaths: [...new Set(piExtensionPaths)],
+		...options.piExtensions === false || options.piExtensionFactories === void 0 ? {} : { extensionFactories: await options.piExtensionFactories() },
+		...options.onNotice === void 0 ? {} : { onNotice: options.onNotice }
+	});
+	return {
+		agentDir,
+		modelRuntime,
+		projectContextFiles: (0, _earendil_works_pi_coding_agent.loadProjectContextFiles)({
+			cwd: options.cwd,
+			agentDir
+		}),
+		resolveModel: (parsed) => resolveModel(parsed, modelRuntime, modelSettings),
+		...piPreload === void 0 ? {} : { piExtensions: (input) => require_index$1.createPiExtensionHost({
+			...input,
+			cwd: options.cwd,
+			agentDir,
+			models: modelRuntime,
+			settings,
+			preload: piPreload
+		}) }
+	};
+}
+//#endregion
+exports.createNodeModelDependencies = createNodeModelDependencies;
+
+//# sourceMappingURL=index.cjs.map

package/dist/src/services/nodeModelDependencies/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["resolveCliModel","resolveModelScopeWithDiagnostics","PoSessionSetupError","getAgentDir","path","SettingsManager","modelConfigDirectory","modelSettingsDirectory","ModelRuntime","resolvePiSettingsPackageEntries","fs","preloadPiExtensions","loadProjectContextFiles","createPiExtensionHost"],"sources":["../../../../src/services/nodeModelDependencies/index.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { Api, Model } from '@earendil-works/pi-ai';\nimport {\n  getAgentDir,\n  loadProjectContextFiles,\n  ModelRuntime,\n  resolveCliModel,\n  resolveModelScopeWithDiagnostics,\n  SettingsManager,\n  type Args,\n} from '@earendil-works/pi-coding-agent';\n\nimport { PoSessionSetupError } from '../../exports/headless';\nimport type {\n  HeadlessModelDependencies,\n  HeadlessSessionHostOptions,\n} from '../../systems/main/types/headlessSessionHost';\nimport { registerChatgptAuthProvider } from '../chatgptLogin';\nimport { createPiExtensionHost, preloadPiExtensions, resolvePiSettingsPackageEntries } from '../piExtensionHost';\nimport { modelConfigDirectory, modelSettingsDirectory } from '../piSettings';\n\nasync function resolveModel(\n  parsed: Args,\n  modelRuntime: ModelRuntime,\n  settings: SettingsManager,\n): Promise<{ model: Model<Api>; thinkingLevel?: Args['thinking'] }> {\n  const cli = resolveCliModel({\n    cliProvider: parsed.provider,\n    cliModel: parsed.model,\n    cliThinking: parsed.thinking,\n    modelRuntime,\n  });\n  if (cli.error) throw new Error(cli.error);\n\n  let scoped: Model<Api> | undefined;\n  if (parsed.models !== undefined && parsed.models.length > 0) {\n    const resolved = await resolveModelScopeWithDiagnostics(parsed.models, modelRuntime);\n    scoped = resolved.scopedModels[0]?.model;\n    if (scoped === undefined)\n      throw new PoSessionSetupError(`No configured model matched --models ${parsed.models.join(', ')}.`);\n  }\n\n  const configured =\n    cli.model ??\n    scoped ??\n    (settings.getDefaultProvider() && settings.getDefaultModel()\n      ? modelRuntime.getModel(settings.getDefaultProvider()!, settings.getDefaultModel()!)\n      : undefined) ??\n    (await modelRuntime.getAvailable())[0];\n  if (configured === undefined) {\n    const agentDir = getAgentDir();\n    // A failed availability refresh also leaves the list empty; name it instead of blaming setup.\n    const runtimeError = modelRuntime.getError();\n    throw new PoSessionSetupError(\n      `No model is configured, so the session cannot start. Add a provider and its credentials in ${agentDir} ` +\n        `(auth.json, or models.json for a custom provider), then set defaultProvider and defaultModel in ` +\n        `${path.join(agentDir, 'settings.json')}.` +\n        (runtimeError ? `\\n\\n${runtimeError}` : ''),\n    );\n  }\n  return {\n    model: configured,\n    thinkingLevel:\n      cli.thinkingLevel ??\n      parsed.thinking ??\n      settings.getModelThinkingLevel(configured.provider, configured.id) ??\n      settings.getDefaultThinkingLevel(),\n  };\n}\n\n/** Models, settings and Pi extensions from `~/.pi/agent` and the worktree, as the Node server loads them. */\nexport async function createNodeModelDependencies(\n  options: HeadlessSessionHostOptions,\n): Promise<HeadlessModelDependencies> {\n  const agentDir = getAgentDir();\n  const settings = SettingsManager.create(options.cwd, agentDir);\n  // Credentials and model defaults fall back independently to plain Pi's ~/.pi/agent.\n  const modelDir = modelConfigDirectory(agentDir);\n  const settingsDir = modelSettingsDirectory(agentDir);\n  const modelSettings = settingsDir === agentDir ? settings : SettingsManager.create(options.cwd, settingsDir);\n  const modelRuntime = await ModelRuntime.create({\n    authPath: path.join(modelDir, 'auth.json'),\n    modelsPath: path.join(modelDir, 'models.json'),\n    refreshOnCreate: false,\n  });\n  registerChatgptAuthProvider(modelRuntime);\n  // Pi extensions load before the model is resolved: an extension that registers a provider\n  // (a local Vertex or Bedrock bridge, say) must be in the runtime before the configured default\n  // is looked up, or the lookup misses and the session silently falls back to whichever model\n  // happens to be first in `getAvailable()`.\n  // Provider packages from Pi's settings.json `packages` load alongside the Po entry, so a\n  // model that works under `pi` (a Claude Code bridge, say) is also selectable here.\n  const piExtensionPaths =\n    options.piExtensions === false\n      ? []\n      : [\n          ...(options.piExtensionFactories !== undefined ? [] : (options.piExtensionPaths ?? [])),\n          ...(await resolvePiSettingsPackageEntries({\n            cwd: options.cwd,\n            agentDir,\n            settings,\n            ...(options.onNotice === undefined ? {} : { onNotice: options.onNotice }),\n          })),\n          // Falling back to Pi's model config brings Pi's own extensions with it, as po loads\n          // them: a provider such as a local Vertex bridge lives there, not in auth.json.\n          ...(modelDir !== agentDir && fs.existsSync(path.join(modelDir, 'extensions'))\n            ? [path.join(modelDir, 'extensions')]\n            : []),\n        ];\n  const piPreload = await preloadPiExtensions({\n    cwd: options.cwd,\n    agentDir,\n    models: modelRuntime,\n    extensionPaths: [...new Set(piExtensionPaths)],\n    ...(options.piExtensions === false || options.piExtensionFactories === undefined\n      ? {}\n      : { extensionFactories: await options.piExtensionFactories() }),\n    ...(options.onNotice === undefined ? {} : { onNotice: options.onNotice }),\n  });\n  const projectContextFiles = loadProjectContextFiles({\n    cwd: options.cwd,\n    agentDir,\n  });\n  return {\n    agentDir,\n    modelRuntime,\n    projectContextFiles,\n    resolveModel: (parsed) => resolveModel(parsed, modelRuntime, modelSettings),\n    ...(piPreload === undefined\n      ? {}\n      : {\n          piExtensions: (input) =>\n            createPiExtensionHost({\n              ...input,\n              cwd: options.cwd,\n              agentDir,\n              models: modelRuntime,\n              settings,\n              preload: piPreload,\n            }),\n        }),\n  };\n}\n"],"mappings":";;;;;;;;;;;;AAuBA,eAAe,aACb,QACA,cACA,UACkE;CAClE,MAAM,OAAA,GAAMA,gCAAAA,gBAAAA,CAAgB;EAC1B,aAAa,OAAO;EACpB,UAAU,OAAO;EACjB,aAAa,OAAO;EACpB;CACF,CAAC;CACD,IAAI,IAAI,OAAO,MAAM,IAAI,MAAM,IAAI,KAAK;CAExC,IAAI;CACJ,IAAI,OAAO,WAAW,KAAA,KAAa,OAAO,OAAO,SAAS,GAAG;EAE3D,UAAS,OAAA,GADcC,gCAAAA,iCAAAA,CAAiC,OAAO,QAAQ,YAAY,EAAA,CACjE,aAAa,EAAE,EAAE;EACnC,IAAI,WAAW,KAAA,GACb,MAAM,IAAIC,iBAAAA,oBAAoB,wCAAwC,OAAO,OAAO,KAAK,IAAI,EAAE,EAAE;CACrG;CAEA,MAAM,aACJ,IAAI,SACJ,WACC,SAAS,mBAAmB,KAAK,SAAS,gBAAgB,IACvD,aAAa,SAAS,SAAS,mBAAmB,GAAI,SAAS,gBAAgB,CAAE,IACjF,KAAA,OACH,MAAM,aAAa,aAAa,EAAA,CAAG;CACtC,IAAI,eAAe,KAAA,GAAW;EAC5B,MAAM,YAAA,GAAWC,gCAAAA,YAAAA,CAAY;EAE7B,MAAM,eAAe,aAAa,SAAS;EAC3C,MAAM,IAAID,iBAAAA,oBACR,8FAA8F,SAAS,mGAElGE,UAAAA,QAAK,KAAK,UAAU,eAAe,EAAE,MACvC,eAAe,OAAO,iBAAiB,GAC5C;CACF;CACA,OAAO;EACL,OAAO;EACP,eACE,IAAI,iBACJ,OAAO,YACP,SAAS,sBAAsB,WAAW,UAAU,WAAW,EAAE,KACjE,SAAS,wBAAwB;CACrC;AACF;;AAGA,eAAsB,4BACpB,SACoC;CACpC,MAAM,YAAA,GAAWD,gCAAAA,YAAAA,CAAY;CAC7B,MAAM,WAAWE,gCAAAA,gBAAgB,OAAO,QAAQ,KAAK,QAAQ;CAE7D,MAAM,WAAWC,aAAAA,qBAAqB,QAAQ;CAC9C,MAAM,cAAcC,aAAAA,uBAAuB,QAAQ;CACnD,MAAM,gBAAgB,gBAAgB,WAAW,WAAWF,gCAAAA,gBAAgB,OAAO,QAAQ,KAAK,WAAW;CAC3G,MAAM,eAAe,MAAMG,gCAAAA,aAAa,OAAO;EAC7C,UAAUJ,UAAAA,QAAK,KAAK,UAAU,WAAW;EACzC,YAAYA,UAAAA,QAAK,KAAK,UAAU,aAAa;EAC7C,iBAAiB;CACnB,CAAC;CACD,cAAA,4BAA4B,YAAY;CAOxC,MAAM,mBACJ,QAAQ,iBAAiB,QACrB,CAAC,IACD;EACE,GAAI,QAAQ,yBAAyB,KAAA,IAAY,CAAC,IAAK,QAAQ,oBAAoB,CAAC;EACpF,GAAI,MAAMK,gBAAAA,gCAAgC;GACxC,KAAK,QAAQ;GACb;GACA;GACA,GAAI,QAAQ,aAAa,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU,QAAQ,SAAS;EACzE,CAAC;EAGD,GAAI,aAAa,YAAYC,QAAAA,QAAG,WAAWN,UAAAA,QAAK,KAAK,UAAU,YAAY,CAAC,IACxE,CAACA,UAAAA,QAAK,KAAK,UAAU,YAAY,CAAC,IAClC,CAAC;CACP;CACN,MAAM,YAAY,MAAMO,gBAAAA,oBAAoB;EAC1C,KAAK,QAAQ;EACb;EACA,QAAQ;EACR,gBAAgB,CAAC,GAAG,IAAI,IAAI,gBAAgB,CAAC;EAC7C,GAAI,QAAQ,iBAAiB,SAAS,QAAQ,yBAAyB,KAAA,IACnE,CAAC,IACD,EAAE,oBAAoB,MAAM,QAAQ,qBAAqB,EAAE;EAC/D,GAAI,QAAQ,aAAa,KAAA,IAAY,CAAC,IAAI,EAAE,UAAU,QAAQ,SAAS;CACzE,CAAC;CAKD,OAAO;EACL;EACA;EACA,sBAAA,GAP0BC,gCAAAA,wBAAAA,CAAwB;GAClD,KAAK,QAAQ;GACb;EACF,CAIoB;EAClB,eAAe,WAAW,aAAa,QAAQ,cAAc,aAAa;EAC1E,GAAI,cAAc,KAAA,IACd,CAAC,IACD,EACE,eAAe,UACbC,gBAAAA,sBAAsB;GACpB,GAAG;GACH,KAAK,QAAQ;GACb;GACA,QAAQ;GACR;GACA,SAAS;EACX,CAAC,EACL;CACN;AACF"}

package/dist/src/services/nodeModelDependencies/index.mjs

@@ -0,0 +1,86 @@
+import { modelConfigDirectory, modelSettingsDirectory } from "../piSettings/sync.mjs";
+import "../../../runtimePiSettings.mjs";
+import { registerChatgptAuthProvider } from "../chatgptLogin/index.mjs";
+import { PoSessionSetupError } from "../../schemas/headless.mjs";
+import { createPiExtensionHost, preloadPiExtensions, resolvePiSettingsPackageEntries } from "../piExtensionHost/index.mjs";
+import fs from "node:fs";
+import path from "node:path";
+import { ModelRuntime, SettingsManager, getAgentDir, loadProjectContextFiles, resolveCliModel, resolveModelScopeWithDiagnostics } from "@earendil-works/pi-coding-agent";
+//#region src/services/nodeModelDependencies/index.ts
+async function resolveModel(parsed, modelRuntime, settings) {
+	const cli = resolveCliModel({
+		cliProvider: parsed.provider,
+		cliModel: parsed.model,
+		cliThinking: parsed.thinking,
+		modelRuntime
+	});
+	if (cli.error) throw new Error(cli.error);
+	let scoped;
+	if (parsed.models !== void 0 && parsed.models.length > 0) {
+		scoped = (await resolveModelScopeWithDiagnostics(parsed.models, modelRuntime)).scopedModels[0]?.model;
+		if (scoped === void 0) throw new PoSessionSetupError(`No configured model matched --models ${parsed.models.join(", ")}.`);
+	}
+	const configured = cli.model ?? scoped ?? (settings.getDefaultProvider() && settings.getDefaultModel() ? modelRuntime.getModel(settings.getDefaultProvider(), settings.getDefaultModel()) : void 0) ?? (await modelRuntime.getAvailable())[0];
+	if (configured === void 0) {
+		const agentDir = getAgentDir();
+		const runtimeError = modelRuntime.getError();
+		throw new PoSessionSetupError(`No model is configured, so the session cannot start. Add a provider and its credentials in ${agentDir} (auth.json, or models.json for a custom provider), then set defaultProvider and defaultModel in ${path.join(agentDir, "settings.json")}.` + (runtimeError ? `\n\n${runtimeError}` : ""));
+	}
+	return {
+		model: configured,
+		thinkingLevel: cli.thinkingLevel ?? parsed.thinking ?? settings.getModelThinkingLevel(configured.provider, configured.id) ?? settings.getDefaultThinkingLevel()
+	};
+}
+/** Models, settings and Pi extensions from `~/.pi/agent` and the worktree, as the Node server loads them. */
+async function createNodeModelDependencies(options) {
+	const agentDir = getAgentDir();
+	const settings = SettingsManager.create(options.cwd, agentDir);
+	const modelDir = modelConfigDirectory(agentDir);
+	const settingsDir = modelSettingsDirectory(agentDir);
+	const modelSettings = settingsDir === agentDir ? settings : SettingsManager.create(options.cwd, settingsDir);
+	const modelRuntime = await ModelRuntime.create({
+		authPath: path.join(modelDir, "auth.json"),
+		modelsPath: path.join(modelDir, "models.json"),
+		refreshOnCreate: false
+	});
+	registerChatgptAuthProvider(modelRuntime);
+	const piExtensionPaths = options.piExtensions === false ? [] : [
+		...options.piExtensionFactories !== void 0 ? [] : options.piExtensionPaths ?? [],
+		...await resolvePiSettingsPackageEntries({
+			cwd: options.cwd,
+			agentDir,
+			settings,
+			...options.onNotice === void 0 ? {} : { onNotice: options.onNotice }
+		}),
+		...modelDir !== agentDir && fs.existsSync(path.join(modelDir, "extensions")) ? [path.join(modelDir, "extensions")] : []
+	];
+	const piPreload = await preloadPiExtensions({
+		cwd: options.cwd,
+		agentDir,
+		models: modelRuntime,
+		extensionPaths: [...new Set(piExtensionPaths)],
+		...options.piExtensions === false || options.piExtensionFactories === void 0 ? {} : { extensionFactories: await options.piExtensionFactories() },
+		...options.onNotice === void 0 ? {} : { onNotice: options.onNotice }
+	});
+	return {
+		agentDir,
+		modelRuntime,
+		projectContextFiles: loadProjectContextFiles({
+			cwd: options.cwd,
+			agentDir
+		}),
+		resolveModel: (parsed) => resolveModel(parsed, modelRuntime, modelSettings),
+		...piPreload === void 0 ? {} : { piExtensions: (input) => createPiExtensionHost({
+			...input,
+			cwd: options.cwd,
+			agentDir,
+			models: modelRuntime,
+			settings,
+			preload: piPreload
+		}) }
+	};
+}
+//#endregion
+export { createNodeModelDependencies };
+
+//# sourceMappingURL=index.mjs.map

package/dist/src/services/nodeModelDependencies/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/services/nodeModelDependencies/index.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport type { Api, Model } from '@earendil-works/pi-ai';\nimport {\n  getAgentDir,\n  loadProjectContextFiles,\n  ModelRuntime,\n  resolveCliModel,\n  resolveModelScopeWithDiagnostics,\n  SettingsManager,\n  type Args,\n} from '@earendil-works/pi-coding-agent';\n\nimport { PoSessionSetupError } from '../../exports/headless';\nimport type {\n  HeadlessModelDependencies,\n  HeadlessSessionHostOptions,\n} from '../../systems/main/types/headlessSessionHost';\nimport { registerChatgptAuthProvider } from '../chatgptLogin';\nimport { createPiExtensionHost, preloadPiExtensions, resolvePiSettingsPackageEntries } from '../piExtensionHost';\nimport { modelConfigDirectory, modelSettingsDirectory } from '../piSettings';\n\nasync function resolveModel(\n  parsed: Args,\n  modelRuntime: ModelRuntime,\n  settings: SettingsManager,\n): Promise<{ model: Model<Api>; thinkingLevel?: Args['thinking'] }> {\n  const cli = resolveCliModel({\n    cliProvider: parsed.provider,\n    cliModel: parsed.model,\n    cliThinking: parsed.thinking,\n    modelRuntime,\n  });\n  if (cli.error) throw new Error(cli.error);\n\n  let scoped: Model<Api> | undefined;\n  if (parsed.models !== undefined && parsed.models.length > 0) {\n    const resolved = await resolveModelScopeWithDiagnostics(parsed.models, modelRuntime);\n    scoped = resolved.scopedModels[0]?.model;\n    if (scoped === undefined)\n      throw new PoSessionSetupError(`No configured model matched --models ${parsed.models.join(', ')}.`);\n  }\n\n  const configured =\n    cli.model ??\n    scoped ??\n    (settings.getDefaultProvider() && settings.getDefaultModel()\n      ? modelRuntime.getModel(settings.getDefaultProvider()!, settings.getDefaultModel()!)\n      : undefined) ??\n    (await modelRuntime.getAvailable())[0];\n  if (configured === undefined) {\n    const agentDir = getAgentDir();\n    // A failed availability refresh also leaves the list empty; name it instead of blaming setup.\n    const runtimeError = modelRuntime.getError();\n    throw new PoSessionSetupError(\n      `No model is configured, so the session cannot start. Add a provider and its credentials in ${agentDir} ` +\n        `(auth.json, or models.json for a custom provider), then set defaultProvider and defaultModel in ` +\n        `${path.join(agentDir, 'settings.json')}.` +\n        (runtimeError ? `\\n\\n${runtimeError}` : ''),\n    );\n  }\n  return {\n    model: configured,\n    thinkingLevel:\n      cli.thinkingLevel ??\n      parsed.thinking ??\n      settings.getModelThinkingLevel(configured.provider, configured.id) ??\n      settings.getDefaultThinkingLevel(),\n  };\n}\n\n/** Models, settings and Pi extensions from `~/.pi/agent` and the worktree, as the Node server loads them. */\nexport async function createNodeModelDependencies(\n  options: HeadlessSessionHostOptions,\n): Promise<HeadlessModelDependencies> {\n  const agentDir = getAgentDir();\n  const settings = SettingsManager.create(options.cwd, agentDir);\n  // Credentials and model defaults fall back independently to plain Pi's ~/.pi/agent.\n  const modelDir = modelConfigDirectory(agentDir);\n  const settingsDir = modelSettingsDirectory(agentDir);\n  const modelSettings = settingsDir === agentDir ? settings : SettingsManager.create(options.cwd, settingsDir);\n  const modelRuntime = await ModelRuntime.create({\n    authPath: path.join(modelDir, 'auth.json'),\n    modelsPath: path.join(modelDir, 'models.json'),\n    refreshOnCreate: false,\n  });\n  registerChatgptAuthProvider(modelRuntime);\n  // Pi extensions load before the model is resolved: an extension that registers a provider\n  // (a local Vertex or Bedrock bridge, say) must be in the runtime before the configured default\n  // is looked up, or the lookup misses and the session silently falls back to whichever model\n  // happens to be first in `getAvailable()`.\n  // Provider packages from Pi's settings.json `packages` load alongside the Po entry, so a\n  // model that works under `pi` (a Claude Code bridge, say) is also selectable here.\n  const piExtensionPaths =\n    options.piExtensions === false\n      ? []\n      : [\n          ...(options.piExtensionFactories !== undefined ? [] : (options.piExtensionPaths ?? [])),\n          ...(await resolvePiSettingsPackageEntries({\n            cwd: options.cwd,\n            agentDir,\n            settings,\n            ...(options.onNotice === undefined ? {} : { onNotice: options.onNotice }),\n          })),\n          // Falling back to Pi's model config brings Pi's own extensions with it, as po loads\n          // them: a provider such as a local Vertex bridge lives there, not in auth.json.\n          ...(modelDir !== agentDir && fs.existsSync(path.join(modelDir, 'extensions'))\n            ? [path.join(modelDir, 'extensions')]\n            : []),\n        ];\n  const piPreload = await preloadPiExtensions({\n    cwd: options.cwd,\n    agentDir,\n    models: modelRuntime,\n    extensionPaths: [...new Set(piExtensionPaths)],\n    ...(options.piExtensions === false || options.piExtensionFactories === undefined\n      ? {}\n      : { extensionFactories: await options.piExtensionFactories() }),\n    ...(options.onNotice === undefined ? {} : { onNotice: options.onNotice }),\n  });\n  const projectContextFiles = loadProjectContextFiles({\n    cwd: options.cwd,\n    agentDir,\n  });\n  return {\n    agentDir,\n    modelRuntime,\n    projectContextFiles,\n    resolveModel: (parsed) => resolveModel(parsed, modelRuntime, modelSettings),\n    ...(piPreload === undefined\n      ? {}\n      : {\n          piExtensions: (input) =>\n            createPiExtensionHost({\n              ...input,\n              cwd: options.cwd,\n              agentDir,\n              models: modelRuntime,\n              settings,\n              preload: piPreload,\n            }),\n        }),\n  };\n}\n"],"mappings":"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"}

package/dist/src/services/openSessionRegistry/index.cjs

@@ -1,134 +1,12 @@
 const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
-let node_fs = require("node:fs");
-node_fs = require_runtime.__toESM(node_fs, 1);
+require("../platformFiles/index.cjs");
+const require_index$1 = require("../serialRunner/index.cjs");
+const require_sync = require("./sync.cjs");
 let node_path = require("node:path");
 node_path = require_runtime.__toESM(node_path, 1);
-//#region src/services/openSessionRegistry/index.ts
-const REGISTRY_FILE = "open-sessions.json";
-const DIRECTORY_MODE = 448;
-const FILE_MODE = 384;
-/** The id becomes a journal filename, so it is constrained exactly as SQLite storage constrains it. */
-const SESSION_ID_PATTERN = /^[A-Za-z0-9_-]+$/u;
-function isRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function optionalText(value) {
-	return typeof value === "string" && value !== "" ? value : void 0;
-}
-/**
-* Reads one entry, or nothing.
-*
-* The file is editable by hand and its session id is joined into a journal
-* path, so it is a trust boundary rather than trusted state this process wrote.
-* A bad entry is dropped instead of narrowing the whole file to nothing. A legacy
-* `artifact` (the worktree's pinned sync generation) is ignored: sessions compose live.
-*/
-function parseRecord(value) {
-	if (!isRecord(value)) return void 0;
-	const { sessionId, workspaceId, cwd, name, createdAt } = value;
-	if (typeof sessionId !== "string" || !SESSION_ID_PATTERN.test(sessionId)) return void 0;
-	if (typeof workspaceId !== "string" || workspaceId === "") return void 0;
-	if (typeof cwd !== "string" || !node_path.default.isAbsolute(cwd)) return void 0;
-	if (typeof name !== "string" || typeof createdAt !== "string") return void 0;
-	const parentSessionId = optionalText(value.parentSessionId);
-	const sessionProvenance = optionalText(value.sessionProvenance);
-	const repoRoot = optionalText(value.repoRoot);
-	const groupingRoot = optionalText(value.groupingRoot);
-	if (value.repoRoot !== void 0 && (!repoRoot || !node_path.default.isAbsolute(repoRoot))) return void 0;
-	if (value.groupingRoot !== void 0 && (!groupingRoot || !node_path.default.isAbsolute(groupingRoot))) return void 0;
-	return {
-		sessionId,
-		workspaceId,
-		cwd,
-		...repoRoot === void 0 ? {} : { repoRoot },
-		...groupingRoot === void 0 ? {} : { groupingRoot },
-		name,
-		createdAt,
-		...parentSessionId === void 0 ? {} : { parentSessionId },
-		...sessionProvenance === void 0 ? {} : { sessionProvenance }
-	};
-}
-/**
-* The sessions the cockpit had open, so a server restart can offer them back.
-*
-* Journals already survive a restart; what does not is the knowledge of which
-* of them were open rather than merely finished. Without that, a restart either
-* loses every session or revives every thread ever recorded.
-*/
-function createOpenSessionRegistry(options) {
-	const notice = options.onNotice ?? (() => {});
-	const filePath = node_path.default.join(options.directory, REGISTRY_FILE);
-	const load = () => {
-		let raw;
-		try {
-			raw = node_fs.default.readFileSync(filePath, "utf8");
-		} catch {
-			return [];
-		}
-		let parsed;
-		try {
-			parsed = JSON.parse(raw);
-		} catch {
-			notice(`open sessions at ${filePath} are not valid JSON; none will be restored`);
-			return [];
-		}
-		if (!Array.isArray(parsed)) {
-			notice(`open sessions at ${filePath} are not a list; none will be restored`);
-			return [];
-		}
-		const records = [];
-		for (const entry of parsed) {
-			const record = parseRecord(entry);
-			if (record === void 0) notice(`open sessions at ${filePath} contain an unusable entry; skipping it`);
-			else records.push(record);
-		}
-		return records;
-	};
-	let current = load();
-	const persist = (next) => {
-		const temporary = `${filePath}.${String(process.pid)}.tmp`;
-		try {
-			node_fs.default.mkdirSync(options.directory, {
-				recursive: true,
-				mode: DIRECTORY_MODE
-			});
-			const descriptor = node_fs.default.openSync(temporary, "w", FILE_MODE);
-			try {
-				node_fs.default.writeFileSync(descriptor, `${JSON.stringify(next, void 0, 2)}\n`);
-				node_fs.default.fsyncSync(descriptor);
-			} finally {
-				node_fs.default.closeSync(descriptor);
-			}
-			node_fs.default.renameSync(temporary, filePath);
-			current = next;
-			return true;
-		} catch (error) {
-			notice(`${filePath} could not be saved: ${error instanceof Error ? error.message : String(error)}`);
-			try {
-				node_fs.default.rmSync(temporary, { force: true });
-			} catch {}
-			return false;
-		}
-	};
-	return {
-		list: () => current,
-		add(record) {
-			if (!SESSION_ID_PATTERN.test(record.sessionId)) throw new Error(`Invalid session id '${record.sessionId}'.`);
-			for (const directory of [
-				record.cwd,
-				record.repoRoot,
-				record.groupingRoot
-			]) if (directory !== void 0 && !node_path.default.isAbsolute(directory)) throw new Error("Session directories must be absolute.");
-			return persist([...current.filter((held) => held.sessionId !== record.sessionId), record]);
-		},
-		remove(sessionId) {
-			const next = current.filter((held) => held.sessionId !== sessionId);
-			if (next.length === current.length) return;
-			persist(next);
-		}
-	};
-}
+require("@earendil-works/pi-durable/env");
+require_index$1.createSerialRunner();
 //#endregion
-exports.createOpenSessionRegistry = createOpenSessionRegistry;
+exports.createOpenSessionRegistry = require_sync.createOpenSessionRegistry;
 
 //# sourceMappingURL=index.cjs.map

package/dist/src/services/openSessionRegistry/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["path","fs"],"sources":["../../../../src/services/openSessionRegistry/index.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nconst REGISTRY_FILE = 'open-sessions.json';\nconst DIRECTORY_MODE = 0o700;\nconst FILE_MODE = 0o600;\n/** The id becomes a journal filename, so it is constrained exactly as SQLite storage constrains it. */\nconst SESSION_ID_PATTERN = /^[A-Za-z0-9_-]+$/u;\n\n/** One cockpit session the server had open, enough to reopen its journal by id. */\nexport interface OpenSessionRecord {\n  sessionId: string;\n  workspaceId: string;\n  cwd: string;\n  /** Child checkout root, distinct from the parent grouping root for worktrees. */\n  repoRoot?: string;\n  /** Parent workspace path used only to restore the workspace identity. */\n  groupingRoot?: string;\n  name: string;\n  createdAt: string;\n  parentSessionId?: string;\n  sessionProvenance?: string;\n}\n\nexport interface OpenSessionRegistry {\n  list(): readonly OpenSessionRecord[];\n  /** True only after the record is durably published. */\n  add(record: OpenSessionRecord): boolean;\n  remove(sessionId: string): void;\n}\n\nexport interface OpenSessionRegistryOptions {\n  /** Directory holding the `sessions` journal folder, so the registry sits beside what it points at. */\n  directory: string;\n  onNotice?: (message: string) => void;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction optionalText(value: unknown): string | undefined {\n  return typeof value === 'string' && value !== '' ? value : undefined;\n}\n\n/**\n * Reads one entry, or nothing.\n *\n * The file is editable by hand and its session id is joined into a journal\n * path, so it is a trust boundary rather than trusted state this process wrote.\n * A bad entry is dropped instead of narrowing the whole file to nothing. A legacy\n * `artifact` (the worktree's pinned sync generation) is ignored: sessions compose live.\n */\nfunction parseRecord(value: unknown): OpenSessionRecord | undefined {\n  if (!isRecord(value)) return undefined;\n  const { sessionId, workspaceId, cwd, name, createdAt } = value;\n  if (typeof sessionId !== 'string' || !SESSION_ID_PATTERN.test(sessionId)) return undefined;\n  if (typeof workspaceId !== 'string' || workspaceId === '') return undefined;\n  if (typeof cwd !== 'string' || !path.isAbsolute(cwd)) return undefined;\n  if (typeof name !== 'string' || typeof createdAt !== 'string') return undefined;\n  const parentSessionId = optionalText(value.parentSessionId);\n  const sessionProvenance = optionalText(value.sessionProvenance);\n  const repoRoot = optionalText(value.repoRoot);\n  const groupingRoot = optionalText(value.groupingRoot);\n  if (value.repoRoot !== undefined && (!repoRoot || !path.isAbsolute(repoRoot))) return undefined;\n  if (value.groupingRoot !== undefined && (!groupingRoot || !path.isAbsolute(groupingRoot))) return undefined;\n  return {\n    sessionId,\n    workspaceId,\n    cwd,\n    ...(repoRoot === undefined ? {} : { repoRoot }),\n    ...(groupingRoot === undefined ? {} : { groupingRoot }),\n    name,\n    createdAt,\n    ...(parentSessionId === undefined ? {} : { parentSessionId }),\n    ...(sessionProvenance === undefined ? {} : { sessionProvenance }),\n  };\n}\n\n/**\n * The sessions the cockpit had open, so a server restart can offer them back.\n *\n * Journals already survive a restart; what does not is the knowledge of which\n * of them were open rather than merely finished. Without that, a restart either\n * loses every session or revives every thread ever recorded.\n */\nexport function createOpenSessionRegistry(options: OpenSessionRegistryOptions): OpenSessionRegistry {\n  const notice = options.onNotice ?? ((): void => {});\n  const filePath = path.join(options.directory, REGISTRY_FILE);\n\n  const load = (): OpenSessionRecord[] => {\n    let raw: string;\n    try {\n      raw = fs.readFileSync(filePath, 'utf8');\n    } catch {\n      // No file is the normal first run, so this is not worth a notice.\n      return [];\n    }\n    let parsed: unknown;\n    try {\n      parsed = JSON.parse(raw);\n    } catch {\n      // Left in place rather than rewritten: a file somebody hand-edited is\n      // worth more as evidence than as something this process silently repairs.\n      notice(`open sessions at ${filePath} are not valid JSON; none will be restored`);\n      return [];\n    }\n    if (!Array.isArray(parsed)) {\n      notice(`open sessions at ${filePath} are not a list; none will be restored`);\n      return [];\n    }\n    const records: OpenSessionRecord[] = [];\n    for (const entry of parsed) {\n      const record = parseRecord(entry);\n      if (record === undefined) notice(`open sessions at ${filePath} contain an unusable entry; skipping it`);\n      else records.push(record);\n    }\n    return records;\n  };\n\n  let current = load();\n\n  const persist = (next: OpenSessionRecord[]): boolean => {\n    const temporary = `${filePath}.${String(process.pid)}.tmp`;\n    try {\n      fs.mkdirSync(options.directory, { recursive: true, mode: DIRECTORY_MODE });\n      const descriptor = fs.openSync(temporary, 'w', FILE_MODE);\n      try {\n        fs.writeFileSync(descriptor, `${JSON.stringify(next, undefined, 2)}\\n`);\n        fs.fsyncSync(descriptor);\n      } finally {\n        fs.closeSync(descriptor);\n      }\n      // Rename rather than write in place, so a crash mid-write leaves the\n      // previous contents rather than a truncated file.\n      fs.renameSync(temporary, filePath);\n      current = next;\n      return true;\n    } catch (error) {\n      notice(`${filePath} could not be saved: ${error instanceof Error ? error.message : String(error)}`);\n      try {\n        fs.rmSync(temporary, { force: true });\n      } catch {\n        // Nothing further to do; the temp file is inert either way.\n      }\n      return false;\n    }\n  };\n\n  return {\n    list: () => current,\n    add(record) {\n      if (!SESSION_ID_PATTERN.test(record.sessionId)) throw new Error(`Invalid session id '${record.sessionId}'.`);\n      for (const directory of [record.cwd, record.repoRoot, record.groupingRoot]) {\n        if (directory !== undefined && !path.isAbsolute(directory))\n          throw new Error('Session directories must be absolute.');\n      }\n      return persist([...current.filter((held) => held.sessionId !== record.sessionId), record]);\n    },\n    remove(sessionId) {\n      const next = current.filter((held) => held.sessionId !== sessionId);\n      if (next.length === current.length) return;\n      persist(next);\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["createSerialRunner"],"sources":["../../../../src/services/openSessionRegistry/index.ts"],"sourcesContent":["import path from 'node:path';\n\nimport type { Context } from '@earendil-works/chord';\nimport { getOrThrow, type FileSystem } from '@earendil-works/pi-durable/env';\n\nimport { nodeHost } from '../nodeHost';\nimport { writeFileAtomic } from '../platformFiles';\nimport { createSerialRunner } from '../serialRunner';\nimport {\n  assertOpenSessionRecord,\n  DIRECTORY_MODE,\n  FILE_MODE,\n  parseOpenSessionRecords,\n  REGISTRY_FILE,\n  serializeOpenSessionRecords,\n  type OpenSessionRecord,\n  type OpenSessionRegistryOptions,\n} from './openSessionRecords';\n\nexport type { OpenSessionRecord, OpenSessionRegistry, OpenSessionRegistryOptions } from './openSessionRecords';\nexport { createOpenSessionRegistry } from './sync';\n\n/** One queue per registry file, so concurrent writes in this process never interleave. */\nconst registryWrites = createSerialRunner();\n\nexport interface OpenSessionRegistryAsync {\n  list(): readonly OpenSessionRecord[];\n  /** True only after the record is durably published. */\n  add(record: OpenSessionRecord): Promise<boolean>;\n  remove(sessionId: string): Promise<void>;\n}\n\n/**\n * The sessions the cockpit had open, so a server restart can offer them back.\n *\n * Journals already survive a restart; what does not is the knowledge of which\n * of them were open rather than merely finished. Without that, a restart either\n * loses every session or revives every thread ever recorded. Writes serialise per\n * registry file and publish through a uniquely named temporary file and a rename.\n */\nexport async function createOpenSessionRegistryAsync(\n  fs: FileSystem,\n  options: OpenSessionRegistryOptions,\n  context: Context,\n): Promise<OpenSessionRegistryAsync> {\n  const notice = options.onNotice ?? ((): void => {});\n  const filePath = path.join(options.directory, REGISTRY_FILE);\n  const serial = registryWrites.forKey(filePath);\n\n  // No file, or one this process cannot read, is the normal first run, so it is not worth a notice.\n  const raw = await fs.readTextFile(filePath, context);\n  let current = raw.ok ? parseOpenSessionRecords(raw.value, filePath, notice) : [];\n\n  const persist = async (next: OpenSessionRecord[]): Promise<boolean> => {\n    try {\n      if (!getOrThrow(await fs.exists(options.directory, context))) {\n        getOrThrow(await fs.createDir(options.directory, { recursive: true }, context));\n        await nodeHost.setMode(options.directory, DIRECTORY_MODE);\n      }\n      await writeFileAtomic(fs, filePath, serializeOpenSessionRecords(next), context);\n      await nodeHost.setMode(filePath, FILE_MODE);\n      current = next;\n      return true;\n    } catch (error) {\n      notice(`${filePath} could not be saved: ${error instanceof Error ? error.message : String(error)}`);\n      return false;\n    }\n  };\n\n  return {\n    list: () => current,\n    add: async (record) => {\n      assertOpenSessionRecord(record);\n      return await serial(() => persist([...current.filter((held) => held.sessionId !== record.sessionId), record]));\n    },\n    remove: (sessionId) =>\n      serial(async () => {\n        const next = current.filter((held) => held.sessionId !== sessionId);\n        if (next.length !== current.length) await persist(next);\n      }),\n  };\n}\n"],"mappings":";;;;;;;AAuBuBA,gBAAAA,mBAAmB"}

package/dist/src/services/openSessionRegistry/index.d.mts

@@ -1,36 +1,5 @@
-//#region src/services/openSessionRegistry/index.d.ts
-/** One cockpit session the server had open, enough to reopen its journal by id. */
-export interface OpenSessionRecord {
-  sessionId: string;
-  workspaceId: string;
-  cwd: string;
-  /** Child checkout root, distinct from the parent grouping root for worktrees. */
-  repoRoot?: string;
-  /** Parent workspace path used only to restore the workspace identity. */
-  groupingRoot?: string;
-  name: string;
-  createdAt: string;
-  parentSessionId?: string;
-  sessionProvenance?: string;
-}
-export interface OpenSessionRegistry {
-  list(): readonly OpenSessionRecord[];
-  /** True only after the record is durably published. */
-  add(record: OpenSessionRecord): boolean;
-  remove(sessionId: string): void;
-}
-export interface OpenSessionRegistryOptions {
-  /** Directory holding the `sessions` journal folder, so the registry sits beside what it points at. */
-  directory: string;
-  onNotice?: (message: string) => void;
-}
-/**
- * The sessions the cockpit had open, so a server restart can offer them back.
- *
- * Journals already survive a restart; what does not is the knowledge of which
- * of them were open rather than merely finished. Without that, a restart either
- * loses every session or revives every thread ever recorded.
- */
-export declare function createOpenSessionRegistry(options: OpenSessionRegistryOptions): OpenSessionRegistry;
-//#endregion
-//# sourceMappingURL=index.d.mts.map
+import { OpenSessionRecord, OpenSessionRegistry, OpenSessionRegistryOptions } from "./openSessionRecords.mjs";
+import { createOpenSessionRegistry } from "./sync.mjs";
+import { FileSystem } from "@earendil-works/pi-durable/env";
+import { Context } from "@earendil-works/chord";
+export { type OpenSessionRecord, type OpenSessionRegistry, type OpenSessionRegistryOptions, createOpenSessionRegistry };

package/dist/src/services/openSessionRegistry/index.mjs

@@ -1,131 +1,9 @@
-import fs from "node:fs";
-import path from "node:path";
-//#region src/services/openSessionRegistry/index.ts
-const REGISTRY_FILE = "open-sessions.json";
-const DIRECTORY_MODE = 448;
-const FILE_MODE = 384;
-/** The id becomes a journal filename, so it is constrained exactly as SQLite storage constrains it. */
-const SESSION_ID_PATTERN = /^[A-Za-z0-9_-]+$/u;
-function isRecord(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function optionalText(value) {
-	return typeof value === "string" && value !== "" ? value : void 0;
-}
-/**
-* Reads one entry, or nothing.
-*
-* The file is editable by hand and its session id is joined into a journal
-* path, so it is a trust boundary rather than trusted state this process wrote.
-* A bad entry is dropped instead of narrowing the whole file to nothing. A legacy
-* `artifact` (the worktree's pinned sync generation) is ignored: sessions compose live.
-*/
-function parseRecord(value) {
-	if (!isRecord(value)) return void 0;
-	const { sessionId, workspaceId, cwd, name, createdAt } = value;
-	if (typeof sessionId !== "string" || !SESSION_ID_PATTERN.test(sessionId)) return void 0;
-	if (typeof workspaceId !== "string" || workspaceId === "") return void 0;
-	if (typeof cwd !== "string" || !path.isAbsolute(cwd)) return void 0;
-	if (typeof name !== "string" || typeof createdAt !== "string") return void 0;
-	const parentSessionId = optionalText(value.parentSessionId);
-	const sessionProvenance = optionalText(value.sessionProvenance);
-	const repoRoot = optionalText(value.repoRoot);
-	const groupingRoot = optionalText(value.groupingRoot);
-	if (value.repoRoot !== void 0 && (!repoRoot || !path.isAbsolute(repoRoot))) return void 0;
-	if (value.groupingRoot !== void 0 && (!groupingRoot || !path.isAbsolute(groupingRoot))) return void 0;
-	return {
-		sessionId,
-		workspaceId,
-		cwd,
-		...repoRoot === void 0 ? {} : { repoRoot },
-		...groupingRoot === void 0 ? {} : { groupingRoot },
-		name,
-		createdAt,
-		...parentSessionId === void 0 ? {} : { parentSessionId },
-		...sessionProvenance === void 0 ? {} : { sessionProvenance }
-	};
-}
-/**
-* The sessions the cockpit had open, so a server restart can offer them back.
-*
-* Journals already survive a restart; what does not is the knowledge of which
-* of them were open rather than merely finished. Without that, a restart either
-* loses every session or revives every thread ever recorded.
-*/
-function createOpenSessionRegistry(options) {
-	const notice = options.onNotice ?? (() => {});
-	const filePath = path.join(options.directory, REGISTRY_FILE);
-	const load = () => {
-		let raw;
-		try {
-			raw = fs.readFileSync(filePath, "utf8");
-		} catch {
-			return [];
-		}
-		let parsed;
-		try {
-			parsed = JSON.parse(raw);
-		} catch {
-			notice(`open sessions at ${filePath} are not valid JSON; none will be restored`);
-			return [];
-		}
-		if (!Array.isArray(parsed)) {
-			notice(`open sessions at ${filePath} are not a list; none will be restored`);
-			return [];
-		}
-		const records = [];
-		for (const entry of parsed) {
-			const record = parseRecord(entry);
-			if (record === void 0) notice(`open sessions at ${filePath} contain an unusable entry; skipping it`);
-			else records.push(record);
-		}
-		return records;
-	};
-	let current = load();
-	const persist = (next) => {
-		const temporary = `${filePath}.${String(process.pid)}.tmp`;
-		try {
-			fs.mkdirSync(options.directory, {
-				recursive: true,
-				mode: DIRECTORY_MODE
-			});
-			const descriptor = fs.openSync(temporary, "w", FILE_MODE);
-			try {
-				fs.writeFileSync(descriptor, `${JSON.stringify(next, void 0, 2)}\n`);
-				fs.fsyncSync(descriptor);
-			} finally {
-				fs.closeSync(descriptor);
-			}
-			fs.renameSync(temporary, filePath);
-			current = next;
-			return true;
-		} catch (error) {
-			notice(`${filePath} could not be saved: ${error instanceof Error ? error.message : String(error)}`);
-			try {
-				fs.rmSync(temporary, { force: true });
-			} catch {}
-			return false;
-		}
-	};
-	return {
-		list: () => current,
-		add(record) {
-			if (!SESSION_ID_PATTERN.test(record.sessionId)) throw new Error(`Invalid session id '${record.sessionId}'.`);
-			for (const directory of [
-				record.cwd,
-				record.repoRoot,
-				record.groupingRoot
-			]) if (directory !== void 0 && !path.isAbsolute(directory)) throw new Error("Session directories must be absolute.");
-			return persist([...current.filter((held) => held.sessionId !== record.sessionId), record]);
-		},
-		remove(sessionId) {
-			const next = current.filter((held) => held.sessionId !== sessionId);
-			if (next.length === current.length) return;
-			persist(next);
-		}
-	};
-}
+import "../platformFiles/index.mjs";
+import { createSerialRunner } from "../serialRunner/index.mjs";
 //#endregion
-export { createOpenSessionRegistry };
+export { createOpenSessionRegistry } from "./sync.mjs";
+import "node:path";
+import "@earendil-works/pi-durable/env";
+createSerialRunner();
 
 //# sourceMappingURL=index.mjs.map