@appsoftwareltd/etherpk-mcp 0.7.0 → 0.7.1

package/README.md

@@ -198,6 +198,12 @@ pnpm publish --access public --no-git-checks             # prepack builds; pnpm
 npx -y @appsoftwareltd/etherpk-mcp@<version> --version   # verify, once the registry lists it
 ```
 
+From outside the `apps/mcp` directory:
+
+```sh
+npx -y @appsoftwareltd/etherpk-mcp@<version> --version   # verify, once the registry lists it
+```
+
 The end-to-end specs in `tests-sync/agents/` build and drive this bundle against a real Sync
 Server and a real folder; the technical notes are in the repo under
 `docs/docs/technical/Headless Client.md`.

package/dist/main.js

@@ -31,7 +31,7 @@ import katex from "katex";
 import Mustache from "mustache";
 var package_default = {
 	name: "@appsoftwareltd/etherpk-mcp",
-	version: "0.7.0",
+	version: "0.7.1",
 	license: "Elastic-2.0",
 	description: "EtherPK Headless Client: an MCP server over a synced knowledge graph, run beside the agent on the user's own machine.",
 	type: "module",
@@ -3854,19 +3854,25 @@ function folderCacheDir(env, folderPath) {
 function cacheRoot(env) {
 	return env.ETHERPK_MCP_CACHE_DIR?.trim() || join(env.XDG_CACHE_HOME?.trim() || join(homedir(), ".cache"), "etherpk", "mcp");
 }
+/**
+* The files this build reads and writes in a graph's directory, by name: the cache, the index,
+* and the [[Embedding]] store beside the index with a stamp of its own (ADR 0076) - an index
+* schema bump discards `index.v<N>` and leaves the vectors alone, because their rows cost
+* minutes to re-derive where the index's cost a second. `removeStaleFiles` keeps exactly these
+* names, so they are declared once here and joined to a directory below; a name is never
+* recovered from a joined path (see there).
+*/
+var CACHE_FILE_NAME = `local-cache.v${CACHE_DB_VERSION}.bin`;
+var INDEX_FILE_NAME = `index.v11.sqlite`;
+var VECTORS_FILE_NAME = `vectors.v1.sqlite`;
 function cacheFile(dir) {
-	return join(dir, `local-cache.v${CACHE_DB_VERSION}.bin`);
+	return join(dir, CACHE_FILE_NAME);
 }
 function indexFile(dir) {
-	return join(dir, `index.v11.sqlite`);
+	return join(dir, INDEX_FILE_NAME);
 }
-/**
-* The [[Embedding]] store, beside the index but with its own stamp (ADR 0076): an index
-* schema bump discards `index.v<N>` and leaves this file alone, because its rows cost minutes
-* to re-derive where the index's cost a second.
-*/
 function vectorsFile(dir) {
-	return join(dir, `vectors.v1.sqlite`);
+	return join(dir, VECTORS_FILE_NAME);
 }
 function request(req) {
 	return new Promise((resolve, reject) => {
@@ -3997,10 +4003,10 @@ var ABANDONED_TMP_AFTER_MS = 10 * 6e4;
 */
 async function removeStaleFiles(dir, now = Date.now()) {
 	const keep = new Set([
-		cacheFile(dir),
-		indexFile(dir),
-		vectorsFile(dir)
-	].map((f) => f.split("/").pop()));
+		CACHE_FILE_NAME,
+		INDEX_FILE_NAME,
+		VECTORS_FILE_NAME
+	]);
 	const removed = [];
 	for (const name of await readdir(dir).catch(() => [])) {
 		const stale = /^(index|vectors)\.v\d+\.sqlite$/.test(name) && !keep.has(name);
@@ -17363,6 +17369,24 @@ async function isGraphFolder(root) {
 	return true;
 }
 //#endregion
+//#region src/serve-lifetime.ts
+/** Bind every end to one single-flight shutdown; returns it, for an end the caller finds itself. */
+function bindServeLifetime(deps) {
+	let ending;
+	const shutdown = (end) => ending ??= deps.shutdown(end);
+	let spoken = false;
+	deps.stdin.once("data", () => {
+		spoken = true;
+	});
+	deps.stdin.once("end", () => {
+		if (spoken) shutdown("the client closed stdin");
+	});
+	deps.signals.on("SIGINT", () => void shutdown("SIGINT"));
+	deps.signals.on("SIGTERM", () => void shutdown("SIGTERM"));
+	deps.transportClosed(() => void shutdown("the transport closed"));
+	return shutdown;
+}
+//#endregion
 //#region src/main.ts
 /**
 * `etherpk-mcp`: the [[Headless Client]]'s command line (ADR 0072).
@@ -17830,14 +17854,19 @@ async function serveGraph(graph, graphName, args) {
 		cmd: CMD
 	});
 	const transport = new StdioServerTransport();
-	const shutdown = async () => {
-		await graph.settle().catch(() => {});
-		await graph.dispose().catch(() => {});
-		process.exit(0);
-	};
-	process.on("SIGINT", () => void shutdown());
-	process.on("SIGTERM", () => void shutdown());
-	transport.onclose = () => void shutdown();
+	bindServeLifetime({
+		signals: process,
+		stdin: process.stdin,
+		transportClosed: (listener) => {
+			transport.onclose = listener;
+		},
+		async shutdown(end) {
+			console.error(`etherpk-mcp: ${end}; flushing and exiting.`);
+			await graph.settle().catch(() => {});
+			await graph.dispose().catch(() => {});
+			process.exit(0);
+		}
+	});
 	await server.connect(transport);
 	console.error(`etherpk-mcp: serving "${graphName}" over stdio as "Agent on ${hostname()}".`);
 	chromiumStatus(process.env, CMD).then((chromium) => {