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

package/dist/sessionFilesApi.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_runtime = require("./_virtual/_rolldown/runtime.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_durable_env = require("@earendil-works/pi-durable/env");
+let dist_interop_chordContext_mjs = require("../dist/interop/chordContext.mjs");
 let ignore = require("ignore");
 ignore = require_runtime.__toESM(ignore, 1);
 //#region src/server/sessionFilesApi.ts
@@ -20,14 +20,15 @@ const MAX_FILE_RESULTS = 50;
 * unreadable or malformed file leaves completion listing everything, because
 * hiding the tree is the worse failure.
 */
-function readIgnoreRules(cwd) {
-	const rules = IGNORE_FILES.map((name) => {
+async function readIgnoreRules(fs, cwd, context) {
+	const rules = (await Promise.all(IGNORE_FILES.map(async (name) => {
 		try {
-			return node_fs.default.readFileSync(node_path.default.join(cwd, name), "utf8");
+			const result = await fs.readTextFile(node_path.default.join(cwd, name), context);
+			return result.ok ? result.value : "";
 		} catch {
 			return "";
 		}
-	}).join("\n");
+	}))).join("\n");
 	if (rules.trim().length === 0) return void 0;
 	try {
 		const matcher = (0, ignore.default)().add(rules);
@@ -36,8 +37,9 @@ function readIgnoreRules(cwd) {
 		return;
 	}
 }
-async function listSessionFiles(cwd, query, signal) {
-	const isIgnored = readIgnoreRules(cwd);
+async function listSessionFiles(fs, cwd, query, signal) {
+	const context = (0, dist_interop_chordContext_mjs.withAbortSignal)(signal, dist_interop_chordContext_mjs.BACKGROUND_CONTEXT);
+	const isIgnored = await readIgnoreRules(fs, cwd, context);
 	const deadline = Date.now() + FILE_QUERY_TIMEOUT_MS;
 	const pending = [""];
 	let next = 0;
@@ -49,48 +51,50 @@ async function listSessionFiles(cwd, query, signal) {
 		if (relativeDirectory === void 0) break;
 		if (relativeDirectory !== "" && `${relativeDirectory}/`.toLowerCase().includes(query)) matches.push(`${relativeDirectory}/`);
 		if (matches.length === MAX_FILE_RESULTS) break;
-		const entries = await node_fs.default.promises.readdir(node_path.default.join(cwd, relativeDirectory), { withFileTypes: true });
+		const entries = (0, _earendil_works_pi_durable_env.getOrThrow)(await fs.listDir(node_path.default.join(cwd, relativeDirectory), context));
 		const matchingDirectories = [];
 		for (const entry of entries) {
 			const file = relativeDirectory === "" ? entry.name : `${relativeDirectory}/${entry.name}`;
-			if (entry.isDirectory()) {
+			if (entry.kind === "directory") {
 				if (EXCLUDED_DIRECTORIES.has(entry.name) || isIgnored?.(`${file}/`) === true) continue;
 				if (query && entry.name.toLowerCase().includes(query)) matchingDirectories.push(file);
 				else pending.push(file);
-			} else if (entry.isFile() && isIgnored?.(file) !== true && file.toLowerCase().includes(query)) matches.push(file);
+			} else if (entry.kind === "file" && isIgnored?.(file) !== true && file.toLowerCase().includes(query)) matches.push(file);
 			if (matches.length === MAX_FILE_RESULTS) break;
 		}
 		pending.splice(next, 0, ...matchingDirectories);
 	}
 	return matches.sort().slice(0, MAX_FILE_RESULTS);
 }
-/** Bounded, read-only file completion rooted in the owning session. */
-const sessionFilesApi = {
-	basePath: "files",
-	start(context) {
-		if (context.scope !== "session" || !context.cwd) throw new Error("File completion requires a session.");
-		const cwd = context.cwd;
-		let closed = false;
-		return {
-			async fetch(request) {
-				if (closed) return new Response(null, { status: 503 });
-				const url = new URL(request.url);
-				if (request.method !== "GET" || url.pathname !== "/") return new Response(null, { status: 404 });
-				const query = (url.searchParams.get("q") ?? "").toLowerCase();
-				if (query.length > 256) return Response.json({ error: "File query is too long." }, { status: 400 });
-				try {
-					return Response.json({ files: await listSessionFiles(cwd, query, request.signal) });
-				} catch {
-					return Response.json({ error: "File completion could not be read." }, { status: 503 });
+/** Bounded, read-only file completion rooted in the owning session, read through the server's platform fs. */
+function createSessionFilesApi({ fs }) {
+	return {
+		basePath: "files",
+		start(context) {
+			if (context.scope !== "session" || !context.cwd) throw new Error("File completion requires a session.");
+			const cwd = context.cwd;
+			let closed = false;
+			return {
+				async fetch(request) {
+					if (closed) return new Response(null, { status: 503 });
+					const url = new URL(request.url);
+					if (request.method !== "GET" || url.pathname !== "/") return new Response(null, { status: 404 });
+					const query = (url.searchParams.get("q") ?? "").toLowerCase();
+					if (query.length > 256) return Response.json({ error: "File query is too long." }, { status: 400 });
+					try {
+						return Response.json({ files: await listSessionFiles(fs, cwd, query, request.signal) });
+					} catch {
+						return Response.json({ error: "File completion could not be read." }, { status: 503 });
+					}
+				},
+				close() {
+					closed = true;
 				}
-			},
-			close() {
-				closed = true;
-			}
-		};
-	}
-};
+			};
+		}
+	};
+}
 //#endregion
-exports.sessionFilesApi = sessionFilesApi;
+exports.createSessionFilesApi = createSessionFilesApi;
 
 //# sourceMappingURL=sessionFilesApi.cjs.map

package/dist/sessionFilesApi.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"sessionFilesApi.cjs","names":["fs","path"],"sources":["../src/server/sessionFilesApi.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport ignore from 'ignore';\n\nimport type { DoomApi } from '../exports/packageApi';\n\nconst EXCLUDED_DIRECTORIES = new Set(['.git', 'node_modules']);\nconst IGNORE_FILES = ['.gitignore', '.poignore'];\nconst FILE_QUERY_TIMEOUT_MS = 2000;\nconst MAX_FILE_RESULTS = 50;\n\n/**\n * The project's ignore test, or nothing when it declares no rules.\n *\n * Only the session root's files are read. A nested .gitignore would need one\n * matcher per directory, and the cost of skipping it is a suggestion that\n * should not have been offered rather than a file that cannot be opened. An\n * unreadable or malformed file leaves completion listing everything, because\n * hiding the tree is the worse failure.\n */\nfunction readIgnoreRules(cwd: string): ((relativePath: string) => boolean) | undefined {\n  const rules = IGNORE_FILES.map((name) => {\n    try {\n      return fs.readFileSync(path.join(cwd, name), 'utf8');\n    } catch {\n      return '';\n    }\n  }).join('\\n');\n  if (rules.trim().length === 0) return undefined;\n  try {\n    const matcher = ignore().add(rules);\n    return (relativePath: string): boolean => matcher.ignores(relativePath);\n  } catch {\n    return undefined;\n  }\n}\n\nasync function listSessionFiles(cwd: string, query: string, signal: AbortSignal): Promise<string[]> {\n  const isIgnored = readIgnoreRules(cwd);\n  const deadline = Date.now() + FILE_QUERY_TIMEOUT_MS;\n  const pending = [''];\n  let next = 0;\n  const matches: string[] = [];\n\n  while (next < pending.length && matches.length < MAX_FILE_RESULTS) {\n    if (signal.aborted) {\n      throw signal.reason instanceof Error ? signal.reason : new Error('File completion was aborted.');\n    }\n    // ponytail: Return matches found so far on huge trees; a search index is the upgrade path.\n    if (Date.now() > deadline && next > 0) break;\n    const relativeDirectory = pending[next++];\n    if (relativeDirectory === undefined) break;\n    if (relativeDirectory !== '' && `${relativeDirectory}/`.toLowerCase().includes(query)) {\n      matches.push(`${relativeDirectory}/`);\n    }\n    if (matches.length === MAX_FILE_RESULTS) break;\n    const entries = await fs.promises.readdir(path.join(cwd, relativeDirectory), { withFileTypes: true });\n    const matchingDirectories: string[] = [];\n    for (const entry of entries) {\n      // Ignore rules are written in posix form, and so is every result.\n      const file = relativeDirectory === '' ? entry.name : `${relativeDirectory}/${entry.name}`;\n      if (entry.isDirectory()) {\n        // An ignored directory is pruned rather than filtered at its leaves:\n        // walking a build cache is what exhausts the completion budget. The\n        // trailing slash is what makes a directory-only rule such as\n        // '.nx-cache/' match.\n        if (EXCLUDED_DIRECTORIES.has(entry.name) || isIgnored?.(`${file}/`) === true) continue;\n        // Explore a matching folder before its siblings so its files follow it.\n        if (query && entry.name.toLowerCase().includes(query)) matchingDirectories.push(file);\n        else pending.push(file);\n      } else if (entry.isFile() && isIgnored?.(file) !== true && file.toLowerCase().includes(query)) {\n        matches.push(file);\n      }\n      if (matches.length === MAX_FILE_RESULTS) break;\n    }\n    pending.splice(next, 0, ...matchingDirectories);\n  }\n\n  return matches.sort().slice(0, MAX_FILE_RESULTS);\n}\n\n/** Bounded, read-only file completion rooted in the owning session. */\nexport const sessionFilesApi: DoomApi = {\n  basePath: 'files',\n  start(context) {\n    if (context.scope !== 'session' || !context.cwd) throw new Error('File completion requires a session.');\n    const cwd = context.cwd;\n    let closed = false;\n    return {\n      async fetch(request) {\n        if (closed) return new Response(null, { status: 503 });\n        const url = new URL(request.url);\n        if (request.method !== 'GET' || url.pathname !== '/') return new Response(null, { status: 404 });\n        const query = (url.searchParams.get('q') ?? '').toLowerCase();\n        if (query.length > 256) return Response.json({ error: 'File query is too long.' }, { status: 400 });\n        try {\n          return Response.json({ files: await listSessionFiles(cwd, query, request.signal) });\n        } catch {\n          return Response.json({ error: 'File completion could not be read.' }, { status: 503 });\n        }\n      },\n      close() {\n        closed = true;\n      },\n    };\n  },\n};\n"],"mappings":"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"}
+{"version":3,"file":"sessionFilesApi.cjs","names":["path","withAbortSignal","BACKGROUND_CONTEXT","getOrThrow"],"sources":["../src/server/sessionFilesApi.ts"],"sourcesContent":["import path from 'node:path';\n\nimport type { Context } from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT, withAbortSignal } from '@earendil-works/chord/context';\nimport { getOrThrow, type FileSystem } from '@earendil-works/pi-durable/env';\nimport ignore from 'ignore';\n\nimport type { PoApi } from '../exports/packageApi';\n\nconst EXCLUDED_DIRECTORIES = new Set(['.git', 'node_modules']);\nconst IGNORE_FILES = ['.gitignore', '.poignore'];\nconst FILE_QUERY_TIMEOUT_MS = 2000;\nconst MAX_FILE_RESULTS = 50;\n\n/**\n * The project's ignore test, or nothing when it declares no rules.\n *\n * Only the session root's files are read. A nested .gitignore would need one\n * matcher per directory, and the cost of skipping it is a suggestion that\n * should not have been offered rather than a file that cannot be opened. An\n * unreadable or malformed file leaves completion listing everything, because\n * hiding the tree is the worse failure.\n */\nasync function readIgnoreRules(\n  fs: FileSystem,\n  cwd: string,\n  context: Context,\n): Promise<((relativePath: string) => boolean) | undefined> {\n  const rules = (\n    await Promise.all(\n      IGNORE_FILES.map(async (name) => {\n        try {\n          const result = await fs.readTextFile(path.join(cwd, name), context);\n          return result.ok ? result.value : '';\n        } catch {\n          return '';\n        }\n      }),\n    )\n  ).join('\\n');\n  if (rules.trim().length === 0) return undefined;\n  try {\n    const matcher = ignore().add(rules);\n    return (relativePath: string): boolean => matcher.ignores(relativePath);\n  } catch {\n    return undefined;\n  }\n}\n\nasync function listSessionFiles(fs: FileSystem, cwd: string, query: string, signal: AbortSignal): Promise<string[]> {\n  const context = withAbortSignal(signal, BACKGROUND_CONTEXT);\n  const isIgnored = await readIgnoreRules(fs, cwd, context);\n  const deadline = Date.now() + FILE_QUERY_TIMEOUT_MS;\n  const pending = [''];\n  let next = 0;\n  const matches: string[] = [];\n\n  while (next < pending.length && matches.length < MAX_FILE_RESULTS) {\n    if (signal.aborted) {\n      throw signal.reason instanceof Error ? signal.reason : new Error('File completion was aborted.');\n    }\n    // ponytail: Return matches found so far on huge trees; a search index is the upgrade path.\n    if (Date.now() > deadline && next > 0) break;\n    const relativeDirectory = pending[next++];\n    if (relativeDirectory === undefined) break;\n    if (relativeDirectory !== '' && `${relativeDirectory}/`.toLowerCase().includes(query)) {\n      matches.push(`${relativeDirectory}/`);\n    }\n    if (matches.length === MAX_FILE_RESULTS) break;\n    const entries = getOrThrow(await fs.listDir(path.join(cwd, relativeDirectory), context));\n    const matchingDirectories: string[] = [];\n    for (const entry of entries) {\n      // Ignore rules are written in posix form, and so is every result.\n      const file = relativeDirectory === '' ? entry.name : `${relativeDirectory}/${entry.name}`;\n      if (entry.kind === 'directory') {\n        // An ignored directory is pruned rather than filtered at its leaves:\n        // walking a build cache is what exhausts the completion budget. The\n        // trailing slash is what makes a directory-only rule such as\n        // '.nx-cache/' match.\n        if (EXCLUDED_DIRECTORIES.has(entry.name) || isIgnored?.(`${file}/`) === true) continue;\n        // Explore a matching folder before its siblings so its files follow it.\n        if (query && entry.name.toLowerCase().includes(query)) matchingDirectories.push(file);\n        else pending.push(file);\n      } else if (entry.kind === 'file' && isIgnored?.(file) !== true && file.toLowerCase().includes(query)) {\n        matches.push(file);\n      }\n      if (matches.length === MAX_FILE_RESULTS) break;\n    }\n    pending.splice(next, 0, ...matchingDirectories);\n  }\n\n  return matches.sort().slice(0, MAX_FILE_RESULTS);\n}\n\n/** Bounded, read-only file completion rooted in the owning session, read through the server's platform fs. */\nexport function createSessionFilesApi({ fs }: { fs: FileSystem }): PoApi {\n  return {\n    basePath: 'files',\n    start(context) {\n      if (context.scope !== 'session' || !context.cwd) throw new Error('File completion requires a session.');\n      const cwd = context.cwd;\n      let closed = false;\n      return {\n        async fetch(request) {\n          if (closed) return new Response(null, { status: 503 });\n          const url = new URL(request.url);\n          if (request.method !== 'GET' || url.pathname !== '/') return new Response(null, { status: 404 });\n          const query = (url.searchParams.get('q') ?? '').toLowerCase();\n          if (query.length > 256) return Response.json({ error: 'File query is too long.' }, { status: 400 });\n          try {\n            return Response.json({ files: await listSessionFiles(fs, cwd, query, request.signal) });\n          } catch {\n            return Response.json({ error: 'File completion could not be read.' }, { status: 503 });\n          }\n        },\n        close() {\n          closed = true;\n        },\n      };\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/sessionFilesApi.d.mts

@@ -1,7 +1,10 @@
-import { DoomApi } from "./src/schemas/packageApi.mjs";
+import { PoApi } from "./src/schemas/packageApi.mjs";
 import "./packageApi.mjs";
+import { FileSystem } from "@earendil-works/pi-durable/env";
 //#region src/server/sessionFilesApi.d.ts
-/** Bounded, read-only file completion rooted in the owning session. */
-export declare const sessionFilesApi: DoomApi;
+/** Bounded, read-only file completion rooted in the owning session, read through the server's platform fs. */
+export declare function createSessionFilesApi({ fs }: {
+  fs: FileSystem;
+}): PoApi;
 //#endregion
 //# sourceMappingURL=sessionFilesApi.d.mts.map

package/dist/sessionFilesApi.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"sessionFilesApi.d.mts","names":[],"sources":["../src/server/sessionFilesApi.ts"],"mappings":";;;;qBAmFa,iBAAiB"}
+{"version":3,"file":"sessionFilesApi.d.mts","names":[],"sources":["../src/server/sessionFilesApi.ts"],"mappings":";;;;;wBA+FgB,wBAAwB;EAAQ,IAAI;IAAe"}

package/dist/sessionFilesApi.mjs

@@ -1,5 +1,6 @@
-import fs from "node:fs";
 import path from "node:path";
+import { getOrThrow } from "@earendil-works/pi-durable/env";
+import { BACKGROUND_CONTEXT, withAbortSignal } from "@earendil-works/chord/context";
 import ignore from "ignore";
 //#region src/server/sessionFilesApi.ts
 const EXCLUDED_DIRECTORIES = /* @__PURE__ */ new Set([".git", "node_modules"]);
@@ -15,14 +16,15 @@ const MAX_FILE_RESULTS = 50;
 * unreadable or malformed file leaves completion listing everything, because
 * hiding the tree is the worse failure.
 */
-function readIgnoreRules(cwd) {
-	const rules = IGNORE_FILES.map((name) => {
+async function readIgnoreRules(fs, cwd, context) {
+	const rules = (await Promise.all(IGNORE_FILES.map(async (name) => {
 		try {
-			return fs.readFileSync(path.join(cwd, name), "utf8");
+			const result = await fs.readTextFile(path.join(cwd, name), context);
+			return result.ok ? result.value : "";
 		} catch {
 			return "";
 		}
-	}).join("\n");
+	}))).join("\n");
 	if (rules.trim().length === 0) return void 0;
 	try {
 		const matcher = ignore().add(rules);
@@ -31,8 +33,9 @@ function readIgnoreRules(cwd) {
 		return;
 	}
 }
-async function listSessionFiles(cwd, query, signal) {
-	const isIgnored = readIgnoreRules(cwd);
+async function listSessionFiles(fs, cwd, query, signal) {
+	const context = withAbortSignal(signal, BACKGROUND_CONTEXT);
+	const isIgnored = await readIgnoreRules(fs, cwd, context);
 	const deadline = Date.now() + FILE_QUERY_TIMEOUT_MS;
 	const pending = [""];
 	let next = 0;
@@ -44,48 +47,50 @@ async function listSessionFiles(cwd, query, signal) {
 		if (relativeDirectory === void 0) break;
 		if (relativeDirectory !== "" && `${relativeDirectory}/`.toLowerCase().includes(query)) matches.push(`${relativeDirectory}/`);
 		if (matches.length === MAX_FILE_RESULTS) break;
-		const entries = await fs.promises.readdir(path.join(cwd, relativeDirectory), { withFileTypes: true });
+		const entries = getOrThrow(await fs.listDir(path.join(cwd, relativeDirectory), context));
 		const matchingDirectories = [];
 		for (const entry of entries) {
 			const file = relativeDirectory === "" ? entry.name : `${relativeDirectory}/${entry.name}`;
-			if (entry.isDirectory()) {
+			if (entry.kind === "directory") {
 				if (EXCLUDED_DIRECTORIES.has(entry.name) || isIgnored?.(`${file}/`) === true) continue;
 				if (query && entry.name.toLowerCase().includes(query)) matchingDirectories.push(file);
 				else pending.push(file);
-			} else if (entry.isFile() && isIgnored?.(file) !== true && file.toLowerCase().includes(query)) matches.push(file);
+			} else if (entry.kind === "file" && isIgnored?.(file) !== true && file.toLowerCase().includes(query)) matches.push(file);
 			if (matches.length === MAX_FILE_RESULTS) break;
 		}
 		pending.splice(next, 0, ...matchingDirectories);
 	}
 	return matches.sort().slice(0, MAX_FILE_RESULTS);
 }
-/** Bounded, read-only file completion rooted in the owning session. */
-const sessionFilesApi = {
-	basePath: "files",
-	start(context) {
-		if (context.scope !== "session" || !context.cwd) throw new Error("File completion requires a session.");
-		const cwd = context.cwd;
-		let closed = false;
-		return {
-			async fetch(request) {
-				if (closed) return new Response(null, { status: 503 });
-				const url = new URL(request.url);
-				if (request.method !== "GET" || url.pathname !== "/") return new Response(null, { status: 404 });
-				const query = (url.searchParams.get("q") ?? "").toLowerCase();
-				if (query.length > 256) return Response.json({ error: "File query is too long." }, { status: 400 });
-				try {
-					return Response.json({ files: await listSessionFiles(cwd, query, request.signal) });
-				} catch {
-					return Response.json({ error: "File completion could not be read." }, { status: 503 });
+/** Bounded, read-only file completion rooted in the owning session, read through the server's platform fs. */
+function createSessionFilesApi({ fs }) {
+	return {
+		basePath: "files",
+		start(context) {
+			if (context.scope !== "session" || !context.cwd) throw new Error("File completion requires a session.");
+			const cwd = context.cwd;
+			let closed = false;
+			return {
+				async fetch(request) {
+					if (closed) return new Response(null, { status: 503 });
+					const url = new URL(request.url);
+					if (request.method !== "GET" || url.pathname !== "/") return new Response(null, { status: 404 });
+					const query = (url.searchParams.get("q") ?? "").toLowerCase();
+					if (query.length > 256) return Response.json({ error: "File query is too long." }, { status: 400 });
+					try {
+						return Response.json({ files: await listSessionFiles(fs, cwd, query, request.signal) });
+					} catch {
+						return Response.json({ error: "File completion could not be read." }, { status: 503 });
+					}
+				},
+				close() {
+					closed = true;
 				}
-			},
-			close() {
-				closed = true;
-			}
-		};
-	}
-};
+			};
+		}
+	};
+}
 //#endregion
-export { sessionFilesApi };
+export { createSessionFilesApi };
 
 //# sourceMappingURL=sessionFilesApi.mjs.map

package/dist/sessionFilesApi.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"sessionFilesApi.mjs","names":[],"sources":["../src/server/sessionFilesApi.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\n\nimport ignore from 'ignore';\n\nimport type { DoomApi } from '../exports/packageApi';\n\nconst EXCLUDED_DIRECTORIES = new Set(['.git', 'node_modules']);\nconst IGNORE_FILES = ['.gitignore', '.poignore'];\nconst FILE_QUERY_TIMEOUT_MS = 2000;\nconst MAX_FILE_RESULTS = 50;\n\n/**\n * The project's ignore test, or nothing when it declares no rules.\n *\n * Only the session root's files are read. A nested .gitignore would need one\n * matcher per directory, and the cost of skipping it is a suggestion that\n * should not have been offered rather than a file that cannot be opened. An\n * unreadable or malformed file leaves completion listing everything, because\n * hiding the tree is the worse failure.\n */\nfunction readIgnoreRules(cwd: string): ((relativePath: string) => boolean) | undefined {\n  const rules = IGNORE_FILES.map((name) => {\n    try {\n      return fs.readFileSync(path.join(cwd, name), 'utf8');\n    } catch {\n      return '';\n    }\n  }).join('\\n');\n  if (rules.trim().length === 0) return undefined;\n  try {\n    const matcher = ignore().add(rules);\n    return (relativePath: string): boolean => matcher.ignores(relativePath);\n  } catch {\n    return undefined;\n  }\n}\n\nasync function listSessionFiles(cwd: string, query: string, signal: AbortSignal): Promise<string[]> {\n  const isIgnored = readIgnoreRules(cwd);\n  const deadline = Date.now() + FILE_QUERY_TIMEOUT_MS;\n  const pending = [''];\n  let next = 0;\n  const matches: string[] = [];\n\n  while (next < pending.length && matches.length < MAX_FILE_RESULTS) {\n    if (signal.aborted) {\n      throw signal.reason instanceof Error ? signal.reason : new Error('File completion was aborted.');\n    }\n    // ponytail: Return matches found so far on huge trees; a search index is the upgrade path.\n    if (Date.now() > deadline && next > 0) break;\n    const relativeDirectory = pending[next++];\n    if (relativeDirectory === undefined) break;\n    if (relativeDirectory !== '' && `${relativeDirectory}/`.toLowerCase().includes(query)) {\n      matches.push(`${relativeDirectory}/`);\n    }\n    if (matches.length === MAX_FILE_RESULTS) break;\n    const entries = await fs.promises.readdir(path.join(cwd, relativeDirectory), { withFileTypes: true });\n    const matchingDirectories: string[] = [];\n    for (const entry of entries) {\n      // Ignore rules are written in posix form, and so is every result.\n      const file = relativeDirectory === '' ? entry.name : `${relativeDirectory}/${entry.name}`;\n      if (entry.isDirectory()) {\n        // An ignored directory is pruned rather than filtered at its leaves:\n        // walking a build cache is what exhausts the completion budget. The\n        // trailing slash is what makes a directory-only rule such as\n        // '.nx-cache/' match.\n        if (EXCLUDED_DIRECTORIES.has(entry.name) || isIgnored?.(`${file}/`) === true) continue;\n        // Explore a matching folder before its siblings so its files follow it.\n        if (query && entry.name.toLowerCase().includes(query)) matchingDirectories.push(file);\n        else pending.push(file);\n      } else if (entry.isFile() && isIgnored?.(file) !== true && file.toLowerCase().includes(query)) {\n        matches.push(file);\n      }\n      if (matches.length === MAX_FILE_RESULTS) break;\n    }\n    pending.splice(next, 0, ...matchingDirectories);\n  }\n\n  return matches.sort().slice(0, MAX_FILE_RESULTS);\n}\n\n/** Bounded, read-only file completion rooted in the owning session. */\nexport const sessionFilesApi: DoomApi = {\n  basePath: 'files',\n  start(context) {\n    if (context.scope !== 'session' || !context.cwd) throw new Error('File completion requires a session.');\n    const cwd = context.cwd;\n    let closed = false;\n    return {\n      async fetch(request) {\n        if (closed) return new Response(null, { status: 503 });\n        const url = new URL(request.url);\n        if (request.method !== 'GET' || url.pathname !== '/') return new Response(null, { status: 404 });\n        const query = (url.searchParams.get('q') ?? '').toLowerCase();\n        if (query.length > 256) return Response.json({ error: 'File query is too long.' }, { status: 400 });\n        try {\n          return Response.json({ files: await listSessionFiles(cwd, query, request.signal) });\n        } catch {\n          return Response.json({ error: 'File completion could not be read.' }, { status: 503 });\n        }\n      },\n      close() {\n        closed = true;\n      },\n    };\n  },\n};\n"],"mappings":"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"}
+{"version":3,"file":"sessionFilesApi.mjs","names":[],"sources":["../src/server/sessionFilesApi.ts"],"sourcesContent":["import path from 'node:path';\n\nimport type { Context } from '@earendil-works/chord';\nimport { BACKGROUND_CONTEXT, withAbortSignal } from '@earendil-works/chord/context';\nimport { getOrThrow, type FileSystem } from '@earendil-works/pi-durable/env';\nimport ignore from 'ignore';\n\nimport type { PoApi } from '../exports/packageApi';\n\nconst EXCLUDED_DIRECTORIES = new Set(['.git', 'node_modules']);\nconst IGNORE_FILES = ['.gitignore', '.poignore'];\nconst FILE_QUERY_TIMEOUT_MS = 2000;\nconst MAX_FILE_RESULTS = 50;\n\n/**\n * The project's ignore test, or nothing when it declares no rules.\n *\n * Only the session root's files are read. A nested .gitignore would need one\n * matcher per directory, and the cost of skipping it is a suggestion that\n * should not have been offered rather than a file that cannot be opened. An\n * unreadable or malformed file leaves completion listing everything, because\n * hiding the tree is the worse failure.\n */\nasync function readIgnoreRules(\n  fs: FileSystem,\n  cwd: string,\n  context: Context,\n): Promise<((relativePath: string) => boolean) | undefined> {\n  const rules = (\n    await Promise.all(\n      IGNORE_FILES.map(async (name) => {\n        try {\n          const result = await fs.readTextFile(path.join(cwd, name), context);\n          return result.ok ? result.value : '';\n        } catch {\n          return '';\n        }\n      }),\n    )\n  ).join('\\n');\n  if (rules.trim().length === 0) return undefined;\n  try {\n    const matcher = ignore().add(rules);\n    return (relativePath: string): boolean => matcher.ignores(relativePath);\n  } catch {\n    return undefined;\n  }\n}\n\nasync function listSessionFiles(fs: FileSystem, cwd: string, query: string, signal: AbortSignal): Promise<string[]> {\n  const context = withAbortSignal(signal, BACKGROUND_CONTEXT);\n  const isIgnored = await readIgnoreRules(fs, cwd, context);\n  const deadline = Date.now() + FILE_QUERY_TIMEOUT_MS;\n  const pending = [''];\n  let next = 0;\n  const matches: string[] = [];\n\n  while (next < pending.length && matches.length < MAX_FILE_RESULTS) {\n    if (signal.aborted) {\n      throw signal.reason instanceof Error ? signal.reason : new Error('File completion was aborted.');\n    }\n    // ponytail: Return matches found so far on huge trees; a search index is the upgrade path.\n    if (Date.now() > deadline && next > 0) break;\n    const relativeDirectory = pending[next++];\n    if (relativeDirectory === undefined) break;\n    if (relativeDirectory !== '' && `${relativeDirectory}/`.toLowerCase().includes(query)) {\n      matches.push(`${relativeDirectory}/`);\n    }\n    if (matches.length === MAX_FILE_RESULTS) break;\n    const entries = getOrThrow(await fs.listDir(path.join(cwd, relativeDirectory), context));\n    const matchingDirectories: string[] = [];\n    for (const entry of entries) {\n      // Ignore rules are written in posix form, and so is every result.\n      const file = relativeDirectory === '' ? entry.name : `${relativeDirectory}/${entry.name}`;\n      if (entry.kind === 'directory') {\n        // An ignored directory is pruned rather than filtered at its leaves:\n        // walking a build cache is what exhausts the completion budget. The\n        // trailing slash is what makes a directory-only rule such as\n        // '.nx-cache/' match.\n        if (EXCLUDED_DIRECTORIES.has(entry.name) || isIgnored?.(`${file}/`) === true) continue;\n        // Explore a matching folder before its siblings so its files follow it.\n        if (query && entry.name.toLowerCase().includes(query)) matchingDirectories.push(file);\n        else pending.push(file);\n      } else if (entry.kind === 'file' && isIgnored?.(file) !== true && file.toLowerCase().includes(query)) {\n        matches.push(file);\n      }\n      if (matches.length === MAX_FILE_RESULTS) break;\n    }\n    pending.splice(next, 0, ...matchingDirectories);\n  }\n\n  return matches.sort().slice(0, MAX_FILE_RESULTS);\n}\n\n/** Bounded, read-only file completion rooted in the owning session, read through the server's platform fs. */\nexport function createSessionFilesApi({ fs }: { fs: FileSystem }): PoApi {\n  return {\n    basePath: 'files',\n    start(context) {\n      if (context.scope !== 'session' || !context.cwd) throw new Error('File completion requires a session.');\n      const cwd = context.cwd;\n      let closed = false;\n      return {\n        async fetch(request) {\n          if (closed) return new Response(null, { status: 503 });\n          const url = new URL(request.url);\n          if (request.method !== 'GET' || url.pathname !== '/') return new Response(null, { status: 404 });\n          const query = (url.searchParams.get('q') ?? '').toLowerCase();\n          if (query.length > 256) return Response.json({ error: 'File query is too long.' }, { status: 400 });\n          try {\n            return Response.json({ files: await listSessionFiles(fs, cwd, query, request.signal) });\n          } catch {\n            return Response.json({ error: 'File completion could not be read.' }, { status: 503 });\n          }\n        },\n        close() {\n          closed = true;\n        },\n      };\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/sessionProtocol.cjs

@@ -1,8 +1,33 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_home = require("./src/schemas/home.cjs");
 const require_sessionProtocol = require("./src/schemas/sessionProtocol.cjs");
-exports.DOOM_COCKPIT_SERVER_ID = require_sessionProtocol.DOOM_COCKPIT_SERVER_ID;
-exports.DOOM_SESSION_MANAGEMENT_SERVICE_ID = require_sessionProtocol.DOOM_SESSION_MANAGEMENT_SERVICE_ID;
-exports.DOOM_SESSION_SERVICE_ID = require_sessionProtocol.DOOM_SESSION_SERVICE_ID;
-exports.DoomHubService = require_sessionProtocol.DoomHubService;
-exports.DoomSessionManagementService = require_sessionProtocol.DoomSessionManagementService;
-exports.DoomSessionService = require_sessionProtocol.DoomSessionService;
+const require_protocolContracts = require("./src/schemas/protocolContracts.cjs");
+const require_protocolChannelsContract = require("./src/schemas/protocolChannelsContract.cjs");
+const require_protocolHubContract = require("./src/schemas/protocolHubContract.cjs");
+const require_protocolThreadContract = require("./src/schemas/protocolThreadContract.cjs");
+const require_protocolSessionContract = require("./src/schemas/protocolSessionContract.cjs");
+exports.ChannelFrameSchema = require_protocolChannelsContract.ChannelFrameSchema;
+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.HubNoticeSchema = require_protocolHubContract.HubNoticeSchema;
+exports.MAX_SESSION_GROUPS = require_sessionProtocol.MAX_SESSION_GROUPS;
+exports.MAX_SESSION_GROUP_LENGTH = require_sessionProtocol.MAX_SESSION_GROUP_LENGTH;
+exports.PO_SERVER_HOST = require_protocolContracts.PO_SERVER_HOST;
+exports.PoChannelsContract = require_protocolChannelsContract.PoChannelsContract;
+exports.PoChannelsStateSchema = require_protocolChannelsContract.PoChannelsStateSchema;
+exports.PoHubContract = require_protocolHubContract.PoHubContract;
+exports.PoHubStateSchema = require_protocolHubContract.PoHubStateSchema;
+exports.PoSessionContract = require_protocolSessionContract.PoSessionContract;
+exports.PoThreadContract = require_protocolThreadContract.PoThreadContract;
+exports.PoThreadFrameSchema = require_protocolThreadContract.PoThreadFrameSchema;
+exports.SESSION_GROUPS_CHANGED_FRAME = require_sessionProtocol.SESSION_GROUPS_CHANGED_FRAME;
+exports.chordMethods = require_protocolContracts.chordMethods;
+exports.createProtocolClient = require_protocolContracts.createProtocolClient;
+exports.createTextLink = require_protocolContracts.createTextLink;
+exports.isUpdateRequired = require_protocolContracts.isUpdateRequired;
+exports.normalizeSessionGroups = require_sessionProtocol.normalizeSessionGroups;
+exports.parseHomeContribution = require_home.parseHomeContribution;
+exports.parseHomeEntity = require_home.parseHomeEntity;
+exports.parseHomeProjection = require_home.parseHomeProjection;
+exports.parseHomeSnapshot = require_home.parseHomeSnapshot;

package/dist/sessionProtocol.d.mts

@@ -1,3 +1,8 @@
-import { DoomContentBlock, DoomSessionStopReason, DoomSessionUpdate, DoomSessionUpdateEvent, DoomToolCallStatus } from "./src/schemas/sessionUpdates.mjs";
-import { AssistantTranscriptItem, ClearQueueResult, DOOM_COCKPIT_SERVER_ID, DOOM_SESSION_MANAGEMENT_SERVICE_ID, DOOM_SESSION_SERVICE_ID, DoomHubService, DoomSessionManagementService, DoomSessionService, ExtensionUiResponse, FollowUpArgs, HubService, ImageContentPart, JsonValue, ModelRef, PromoteQueuedArgs, PromptArgs, ProtocolEvent, QueuedItemArgs, RewindArgs, RewindResult, RewindSummaryEntry, SessionCommand, SessionCommandSourceInfo, SessionLifecycle, SessionManagementService, SessionMessageArgs, SessionPhase, SessionPresentation, SessionService, SessionServiceState, SessionSnapshot, SessionStateInfo, SessionStats, SessionUsage, SteerArgs, TextContentPart, ThinkingContentPart, ThinkingLevel, ToolCallContentPart, ToolTranscriptItem, TranscriptItem, TranscriptPage, TranscriptPageRequest, TranscriptProgress, UserTranscriptItem } from "./src/schemas/sessionProtocol.mjs";
-export { AssistantTranscriptItem, ClearQueueResult, DOOM_COCKPIT_SERVER_ID, DOOM_SESSION_MANAGEMENT_SERVICE_ID, DOOM_SESSION_SERVICE_ID, DoomContentBlock, DoomHubService, DoomSessionManagementService, DoomSessionService, DoomSessionStopReason, DoomSessionUpdate, DoomSessionUpdateEvent, DoomToolCallStatus, ExtensionUiResponse, FollowUpArgs, HubService, ImageContentPart, JsonValue, ModelRef, PromoteQueuedArgs, PromptArgs, ProtocolEvent, QueuedItemArgs, RewindArgs, RewindResult, RewindSummaryEntry, SessionCommand, SessionCommandSourceInfo, SessionLifecycle, SessionManagementService, SessionMessageArgs, SessionPhase, SessionPresentation, SessionService, SessionServiceState, SessionSnapshot, SessionStateInfo, SessionStats, SessionUsage, SteerArgs, TextContentPart, ThinkingContentPart, ThinkingLevel, ToolCallContentPart, ToolTranscriptItem, TranscriptItem, TranscriptPage, TranscriptPageRequest, TranscriptProgress, UserTranscriptItem };
+import { AssistantTranscriptItem, ClearQueueResult, ExtensionUiResponse, FollowUpArgs, ImageContentPart, JsonValue, MAX_SESSION_GROUPS, MAX_SESSION_GROUP_LENGTH, ModelRef, PromoteQueuedArgs, PromptArgs, ProtocolEvent, QueuedItemArgs, RewindArgs, RewindResult, RewindSummaryEntry, SESSION_GROUPS_CHANGED_FRAME, SessionCommand, SessionCommandSourceInfo, SessionLifecycle, SessionLive, SessionLiveTool, SessionMessageArgs, SessionPhase, SessionPresentation, SessionService, SessionServiceState, SessionSnapshot, SessionStateInfo, SessionStats, SessionUsage, SteerArgs, TextContentPart, ThinkingContentPart, ThinkingLevel, ToolCallContentPart, ToolTranscriptItem, TranscriptItem, TranscriptPage, TranscriptPageRequest, UserTranscriptItem, normalizeSessionGroups } from "./src/schemas/sessionProtocol.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 { ChordMethod, ChordMethods, PO_SERVER_HOST, PoMethodSchemas, ProtocolClient, ProtocolConnectionState, TextPort, chordMethods, createProtocolClient, createTextLink, isUpdateRequired } from "./src/schemas/protocolContracts.mjs";
+import { PoSessionContract, SessionRef } from "./src/schemas/protocolSessionContract.mjs";
+import { HubNotice, HubNoticeSchema, HubRef, HubSessionView, HubWorkspaceView, PoHubContract, PoHubStateSchema } from "./src/schemas/protocolHubContract.mjs";
+import { PoThreadContract, PoThreadFrameSchema, ThreadRef } from "./src/schemas/protocolThreadContract.mjs";
+import { ChannelFrameSchema, ChannelsRef, PoChannelsContract, PoChannelsStateSchema } from "./src/schemas/protocolChannelsContract.mjs";
+export { AssistantTranscriptItem, ChannelFrameSchema, ChannelsRef, ChordMethod, ChordMethods, ClearQueueResult, ExtensionUiResponse, FollowUpArgs, HOME_ENTITY_LIMIT, HOME_KINDS, HOME_PAGE_LIMIT, HomeContribution, HomeCoverage, HomeEntity, HomeItem, HomeKind, HomeProjection, HomeRequest, HomeSnapshot, HomeSourceStatus, HubNotice, HubNoticeSchema, HubRef, HubSessionView, HubWorkspaceView, ImageContentPart, JsonValue, MAX_SESSION_GROUPS, MAX_SESSION_GROUP_LENGTH, ModelRef, PO_SERVER_HOST, PoChannelsContract, PoChannelsStateSchema, PoHubContract, PoHubStateSchema, PoMethodSchemas, PoSessionContract, PoThreadContract, PoThreadFrameSchema, PromoteQueuedArgs, PromptArgs, ProtocolClient, ProtocolConnectionState, ProtocolEvent, QueuedItemArgs, RewindArgs, RewindResult, RewindSummaryEntry, SESSION_GROUPS_CHANGED_FRAME, SessionCommand, SessionCommandSourceInfo, SessionLifecycle, SessionLive, SessionLiveTool, SessionMessageArgs, SessionPhase, SessionPresentation, SessionRef, SessionService, SessionServiceState, SessionSnapshot, SessionStateInfo, SessionStats, SessionUsage, SteerArgs, TextContentPart, TextPort, ThinkingContentPart, ThinkingLevel, ThreadRef, ToolCallContentPart, ToolTranscriptItem, TranscriptItem, TranscriptPage, TranscriptPageRequest, UserTranscriptItem, chordMethods, createProtocolClient, createTextLink, isUpdateRequired, normalizeSessionGroups, parseHomeContribution, parseHomeEntity, parseHomeProjection, parseHomeSnapshot };

package/dist/sessionProtocol.mjs

@@ -1,2 +1,8 @@
-import { DOOM_COCKPIT_SERVER_ID, DOOM_SESSION_MANAGEMENT_SERVICE_ID, DOOM_SESSION_SERVICE_ID, DoomHubService, DoomSessionManagementService, DoomSessionService } from "./src/schemas/sessionProtocol.mjs";
-export { DOOM_COCKPIT_SERVER_ID, DOOM_SESSION_MANAGEMENT_SERVICE_ID, DOOM_SESSION_SERVICE_ID, DoomHubService, DoomSessionManagementService, DoomSessionService };
+import { HOME_ENTITY_LIMIT, HOME_KINDS, HOME_PAGE_LIMIT, parseHomeContribution, parseHomeEntity, parseHomeProjection, parseHomeSnapshot } from "./src/schemas/home.mjs";
+import { MAX_SESSION_GROUPS, MAX_SESSION_GROUP_LENGTH, SESSION_GROUPS_CHANGED_FRAME, normalizeSessionGroups } from "./src/schemas/sessionProtocol.mjs";
+import { PO_SERVER_HOST, chordMethods, createProtocolClient, createTextLink, isUpdateRequired } from "./src/schemas/protocolContracts.mjs";
+import { ChannelFrameSchema, PoChannelsContract, PoChannelsStateSchema } from "./src/schemas/protocolChannelsContract.mjs";
+import { HubNoticeSchema, PoHubContract, PoHubStateSchema } from "./src/schemas/protocolHubContract.mjs";
+import { PoThreadContract, PoThreadFrameSchema } from "./src/schemas/protocolThreadContract.mjs";
+import { PoSessionContract } from "./src/schemas/protocolSessionContract.mjs";
+export { ChannelFrameSchema, HOME_ENTITY_LIMIT, HOME_KINDS, HOME_PAGE_LIMIT, HubNoticeSchema, MAX_SESSION_GROUPS, MAX_SESSION_GROUP_LENGTH, PO_SERVER_HOST, PoChannelsContract, PoChannelsStateSchema, PoHubContract, PoHubStateSchema, PoSessionContract, PoThreadContract, PoThreadFrameSchema, SESSION_GROUPS_CHANGED_FRAME, chordMethods, createProtocolClient, createTextLink, isUpdateRequired, normalizeSessionGroups, parseHomeContribution, parseHomeEntity, parseHomeProjection, parseHomeSnapshot };

package/dist/skills.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_skills = require("./src/schemas/skills.cjs");
-exports.DOOM_RESOURCE_CATALOG_ENTRY_TYPE = require_skills.DOOM_RESOURCE_CATALOG_ENTRY_TYPE;
-exports.DOOM_SKILL_SOURCES_SERVICE = require_skills.DOOM_SKILL_SOURCES_SERVICE;
+exports.PO_RESOURCE_CATALOG_ENTRY_TYPE = require_skills.PO_RESOURCE_CATALOG_ENTRY_TYPE;
+exports.PO_SKILL_SOURCES_SERVICE = require_skills.PO_SKILL_SOURCES_SERVICE;
 exports.SkillSourceContributionSchema = require_skills.SkillSourceContributionSchema;
 exports.SkillSourceNameSchema = require_skills.SkillSourceNameSchema;
-exports.createDoomSkillSourcesService = require_skills.createDoomSkillSourcesService;
-exports.readDoomSkillSourcesService = require_skills.readDoomSkillSourcesService;
-exports.requireDoomSkillSourcesService = require_skills.requireDoomSkillSourcesService;
+exports.createPoSkillSourcesService = require_skills.createPoSkillSourcesService;
+exports.readPoSkillSourcesService = require_skills.readPoSkillSourcesService;
+exports.requirePoSkillSourcesService = require_skills.requirePoSkillSourcesService;

package/dist/skills.d.mts

@@ -1,2 +1,2 @@
-import { DOOM_RESOURCE_CATALOG_ENTRY_TYPE, DOOM_SKILL_SOURCES_SERVICE, DoomSkillSourcesService, ResourceCatalogProjection, SkillSourceContribution, SkillSourceContributionHandle, SkillSourceContributionSchema, SkillSourceNameSchema, createDoomSkillSourcesService, readDoomSkillSourcesService, requireDoomSkillSourcesService } from "./src/schemas/skills.mjs";
-export { DOOM_RESOURCE_CATALOG_ENTRY_TYPE, DOOM_SKILL_SOURCES_SERVICE, type DoomSkillSourcesService, type ResourceCatalogProjection, type SkillSourceContribution, type SkillSourceContributionHandle, SkillSourceContributionSchema, SkillSourceNameSchema, createDoomSkillSourcesService, readDoomSkillSourcesService, requireDoomSkillSourcesService };
+import { PO_RESOURCE_CATALOG_ENTRY_TYPE, PO_SKILL_SOURCES_SERVICE, PoSkillSourcesService, ResourceCatalogProjection, SkillSourceContribution, SkillSourceContributionHandle, SkillSourceContributionSchema, SkillSourceNameSchema, createPoSkillSourcesService, readPoSkillSourcesService, requirePoSkillSourcesService } from "./src/schemas/skills.mjs";
+export { PO_RESOURCE_CATALOG_ENTRY_TYPE, PO_SKILL_SOURCES_SERVICE, type PoSkillSourcesService, type ResourceCatalogProjection, type SkillSourceContribution, type SkillSourceContributionHandle, SkillSourceContributionSchema, SkillSourceNameSchema, createPoSkillSourcesService, readPoSkillSourcesService, requirePoSkillSourcesService };

package/dist/skills.mjs

@@ -1,2 +1 @@
-import { DOOM_RESOURCE_CATALOG_ENTRY_TYPE, DOOM_SKILL_SOURCES_SERVICE, SkillSourceContributionSchema, SkillSourceNameSchema, createDoomSkillSourcesService, readDoomSkillSourcesService, requireDoomSkillSourcesService } from "./src/schemas/skills.mjs";
-export { DOOM_RESOURCE_CATALOG_ENTRY_TYPE, DOOM_SKILL_SOURCES_SERVICE, SkillSourceContributionSchema, SkillSourceNameSchema, createDoomSkillSourcesService, readDoomSkillSourcesService, requireDoomSkillSourcesService };
+export { PO_RESOURCE_CATALOG_ENTRY_TYPE, PO_SKILL_SOURCES_SERVICE, SkillSourceContributionSchema, SkillSourceNameSchema, createPoSkillSourcesService, readPoSkillSourcesService, requirePoSkillSourcesService } from "./src/schemas/skills.mjs";

package/dist/sqliteSessionStorage.cjs

@@ -1,5 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
+const require_docs = require("./src/services/durableSession/docs.cjs");
+const require_index = require("./src/services/durableSession/index.cjs");
 let node_crypto = require("node:crypto");
 let node_fs = require("node:fs");
 node_fs = require_runtime.__toESM(node_fs, 1);
@@ -7,39 +9,19 @@ let node_path = require("node:path");
 node_path = require_runtime.__toESM(node_path, 1);
 let node_sqlite = require("node:sqlite");
 let _earendil_works_pi_durable = require("@earendil-works/pi-durable");
-let _earendil_works_chord_context = require("@earendil-works/chord/context");
+let dist_interop_chordContext_mjs = require("../dist/interop/chordContext.mjs");
 let _earendil_works_pi_durable_storage_sqlite = require("@earendil-works/pi-durable/storage/sqlite");
 let _earendil_works_pi_durable_storage_sqlite_node = require("@earendil-works/pi-durable/storage/sqlite/node");
 //#region src/services/sqliteSessionStorage/index.ts
-const DURABLE_BACKGROUND_CONTEXT = _earendil_works_chord_context.BACKGROUND_CONTEXT;
-const DURABLE_DIRECTORY = "durable-v1";
-/** Public string identity belongs to Doom, not the durable numeric ID namespace. */
-const SessionIdentityDoc = (0, _earendil_works_pi_durable.defineDoc)({
-	kind: "po.session.identity",
-	version: 1,
-	scope: "session",
-	initial: () => ({
-		id: "",
-		createdAt: 0,
-		parentSessionId: ""
-	})
-});
-const SessionMetadataDoc = (0, _earendil_works_pi_durable.defineDoc)({
-	kind: "po.session.metadata",
-	version: 1,
-	scope: "session",
-	initial: () => ({
-		name: "",
-		workspaceRoot: "",
-		execution: "",
-		laneName: "main"
-	})
-});
+const DURABLE_BACKGROUND_CONTEXT = dist_interop_chordContext_mjs.BACKGROUND_CONTEXT;
 /** Validate existing files without admitting a writer or applying schema upgrades. */
 function validateDurableSessionFile(file) {
+	if (!node_fs.default.existsSync(file)) throw new Error(`SQLite session not found: ${node_path.default.basename(file, ".sqlite")}`);
 	const database = new node_sqlite.DatabaseSync(file, { readOnly: true });
+	let version;
 	try {
-		if (database.prepare("SELECT version FROM durable_schema WHERE singleton = 1").get()?.version !== 1) throw new Error("Unsupported durable SQLite schema");
+		version = database.prepare("SELECT version FROM durable_schema WHERE singleton = 1").get()?.version;
+		if (version !== _earendil_works_pi_durable_storage_sqlite.CURRENT_SQLITE_SCHEMA_VERSION) throw new Error("Unsupported durable SQLite schema");
 		const tables = database.prepare("SELECT name FROM sqlite_master WHERE type = 'table'").all();
 		for (const name of [
 			"durable_metadata",
@@ -52,6 +34,7 @@ function validateDurableSessionFile(file) {
 			"document_revisions"
 		]) if (!tables.some((table) => table.name === name)) throw new Error("Invalid durable SQLite schema");
 	} catch (cause) {
+		if (typeof version === "number" && version > _earendil_works_pi_durable_storage_sqlite.CURRENT_SQLITE_SCHEMA_VERSION) throw new Error("This session was written by a newer Po. Update Po to open it.", { cause });
 		throw new Error("Unsupported or legacy SQLite session format", { cause });
 	} finally {
 		database.close();
@@ -95,17 +78,18 @@ async function openReadOnlyDurableStorage(file) {
 		throw error;
 	}
 }
+const SESSION_ID = /^[a-zA-Z0-9_-]+$/u;
+/** The durable-v1 file that holds one session. */
+function sqliteSessionFile(sessionsRoot, sessionId) {
+	if (!SESSION_ID.test(sessionId)) throw new Error("Invalid SQLite session id");
+	return node_path.default.resolve(sessionsRoot, require_index.DURABLE_DIRECTORY, `${sessionId}.sqlite`);
+}
 /** Opens the one fresh-format SQLite container owned by a server session. */
 async function openSqliteSessionStorage(options, context) {
-	if (!options.historyOwnership) throw new Error("SQLite sessions require explicit HistoryOwnership");
-	if (!options.sessionsRoot && !options.sessionPath) throw new Error("SQLite sessions require a server data directory");
-	const id = options.sessionId ?? (options.sessionPath ? node_path.default.basename(options.sessionPath, ".sqlite") : (0, node_crypto.randomUUID)());
-	if (!/^[a-zA-Z0-9_-]+$/u.test(id)) throw new Error("Invalid SQLite session id");
-	const sessionFile = node_path.default.resolve(options.sessionPath ?? node_path.default.join(options.sessionsRoot, "durable-v1", `${id}.sqlite`));
-	if (node_path.default.basename(node_path.default.dirname(sessionFile)) !== "durable-v1" || node_path.default.extname(sessionFile) !== ".sqlite") throw new Error("Unsupported or legacy SQLite session path");
+	const id = options.sessionId ?? (0, node_crypto.randomUUID)();
+	const sessionFile = sqliteSessionFile(options.sessionsRoot, id);
 	const existing = node_fs.default.existsSync(sessionFile);
-	if (!existing && options.sessionsRoot && node_fs.default.existsSync(node_path.default.join(options.sessionsRoot, `${id}.sqlite`))) throw new Error("Legacy SQLite sessions are unsupported by fresh durable storage");
-	if (options.sessionPath && !existing) throw new Error(`SQLite session not found: ${sessionFile}`);
+	if (options.existing && !existing) throw new Error(`SQLite session not found: ${id}`);
 	if (existing) validateDurableSessionFile(sessionFile);
 	node_fs.default.mkdirSync(node_path.default.dirname(sessionFile), {
 		recursive: true,
@@ -122,22 +106,15 @@ async function openSqliteSessionStorage(options, context) {
 		database = await (0, _earendil_works_pi_durable_storage_sqlite_node.openNodeSqliteDatabase)(sessionFile);
 		storage = await _earendil_works_pi_durable_storage_sqlite.SqliteStorage.open(database);
 		const session = (0, _earendil_works_pi_durable.createSession)(storage);
-		const identity = await session.snapshot(SessionIdentityDoc, context);
-		if (existing && (!identity || identity.id !== id)) throw new Error("SQLite session id does not match the requested session");
-		if (!existing) {
-			await session.commit(async (tx) => {
-				const doc = await tx.doc(SessionIdentityDoc);
-				doc.id = id;
-				doc.createdAt = Date.now();
-				doc.parentSessionId = options.parentSessionId ?? "";
-			}, context);
-			node_fs.default.chmodSync(sessionFile, 384);
-		}
+		await require_index.initializeSessionIdentity(session, {
+			id,
+			existing,
+			parentSessionId: options.parentSessionId
+		}, context);
+		if (!existing) node_fs.default.chmodSync(sessionFile, 384);
 		return {
 			storage,
 			session,
-			sessionFile,
-			repository: { close: (closeContext = context) => session.close(closeContext) },
 			historyLease
 		};
 	} catch (error) {
@@ -158,11 +135,12 @@ async function openSqliteSessionStorage(options, context) {
 }
 //#endregion
 exports.DURABLE_BACKGROUND_CONTEXT = DURABLE_BACKGROUND_CONTEXT;
-exports.DURABLE_DIRECTORY = DURABLE_DIRECTORY;
-exports.SessionIdentityDoc = SessionIdentityDoc;
-exports.SessionMetadataDoc = SessionMetadataDoc;
+exports.DURABLE_DIRECTORY = require_index.DURABLE_DIRECTORY;
+exports.SessionIdentityDoc = require_docs.SessionIdentityDoc;
+exports.SessionMetadataDoc = require_docs.SessionMetadataDoc;
 exports.openReadOnlyDurableStorage = openReadOnlyDurableStorage;
 exports.openSqliteSessionStorage = openSqliteSessionStorage;
+exports.sqliteSessionFile = sqliteSessionFile;
 exports.validateDurableSessionFile = validateDurableSessionFile;
 
 //# sourceMappingURL=sqliteSessionStorage.cjs.map