@appsoftwareltd/etherpk-mcp 0.1.2 → 0.2.0

package/README.md

@@ -17,18 +17,18 @@ server and graph filled in. They are:
 
 ```sh
 # Once per computer. Prompts for an account-wide Personal Access Token (make one at
-# https://server.etherpk.com/account/tokens, also reachable from "Access tokens" in
+# https://sync.etherpk.com/account/tokens, also reachable from "Access tokens" in
 # EtherPK's account menu), then shows a short code and the address of your EtherPK:
 # open EtherPK there in a browser where you're signed in with your graphs unlocked -
 # any page will do - and confirm the code. The same step as adding a phone.
-npx @appsoftwareltd/etherpk-mcp login --server https://server.etherpk.com
+npx @appsoftwareltd/etherpk-mcp login --sync-server https://sync.etherpk.com
 
 # Self-hosting your own Sync Server? Give its address instead:
-#   npx @appsoftwareltd/etherpk-mcp login --server https://sync.your-domain.example
+#   npx @appsoftwareltd/etherpk-mcp login --sync-server https://sync.your-domain.example
 
 # No EtherPK to hand on this computer (a server you reach over SSH, say)? Press r while
 # login is waiting, or use your Recovery Code from the start:
-#   npx @appsoftwareltd/etherpk-mcp login --server https://server.etherpk.com --recovery-code
+#   npx @appsoftwareltd/etherpk-mcp login --sync-server https://sync.etherpk.com --recovery-code
 
 # Tell the agent about the graph (Claude Code shown; the Agents tab has the others).
 claude mcp add etherpk -- npx @appsoftwareltd/etherpk-mcp serve --graph <graph id>
@@ -83,7 +83,7 @@ pnpm publish --access public --no-git-checks   # prepack runs the build; pnpm re
 npx -y @appsoftwareltd/etherpk-mcp@<version> --version   # verify, once the registry lists it (a few minutes)
 ```
 
-The end-to-end specs in `tests-server/agents/` build and drive this bundle against a real Sync
+The end-to-end specs in `tests-sync/agents/` build and drive this bundle against a real Sync
 Server; the technical notes are in the repo under `docs/docs/technical/Headless Client.md`.
 
 Full guide, including how the cache stays current and what an agent can and can't do:

package/dist/main.js

@@ -17,7 +17,7 @@ import { deserialize, serialize } from "node:v8";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 var package_default = {
 	name: "@appsoftwareltd/etherpk-mcp",
-	version: "0.1.2",
+	version: "0.2.0",
 	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",
@@ -653,13 +653,13 @@ function createSyncTokenSource(mint, opts) {
 */
 function createHeadlessAccount(config) {
 	const api = createSyncApi({
-		baseUrl: config.server,
+		baseUrl: config.syncServer,
 		token: config.pat
 	});
 	return {
 		api,
-		serverBaseUrl: config.server,
-		relayUrl: relayUrlFrom(config.server),
+		serverBaseUrl: config.syncServer,
+		relayUrl: relayUrlFrom(config.syncServer),
 		tokenFor: (graphId) => createSyncTokenSource(() => api.mintSyncToken(graphId))
 	};
 }
@@ -729,9 +729,9 @@ function parseConfig(raw) {
 	}
 	if (typeof parsed !== "object" || parsed === null) return null;
 	const rec = parsed;
-	if (typeof rec.server !== "string" || typeof rec.pat !== "string") return null;
+	if (typeof rec.syncServer !== "string" || typeof rec.pat !== "string") return null;
 	const out = {
-		server: rec.server.replace(/\/$/, ""),
+		syncServer: rec.syncServer.replace(/\/$/, ""),
 		pat: rec.pat
 	};
 	if (typeof rec.vaultKey === "string" && rec.vaultKey !== "") out.vaultKey = rec.vaultKey;
@@ -8390,7 +8390,7 @@ function createMcpServer(graph, info) {
 /**
 * `etherpk-mcp`: the [[Headless Client]]'s command line (ADR 0072).
 *
-*   etherpk-mcp login  --server <url> [--pat <token>] [--recovery-code]
+*   etherpk-mcp login  --sync-server <url> [--pat <token>] [--recovery-code]
 *   etherpk-mcp graphs
 *   etherpk-mcp serve  --graph <id or name>
 *   etherpk-mcp logout
@@ -8408,7 +8408,7 @@ var VERSION = package_default.version;
 var CMD = /[\\/]_npx[\\/]/.test(process.argv[1] ?? "") ? "npx @appsoftwareltd/etherpk-mcp" : "etherpk-mcp";
 var USAGE = `etherpk-mcp - EtherPK Headless Client (an MCP server over one synced graph)
 
-  ${CMD} login --server <url> [--pat <token>] [--recovery-code]
+  ${CMD} login --sync-server <url> [--pat <token>] [--recovery-code]
       Sign this machine in as a device of your account. Prompts for a Personal Access
       Token (an account-wide one, from the Sync Server portal at <url>/account/tokens)
       unless --pat or ETHERPK_PAT is given, then unlocks your keys by Device Approval:
@@ -8471,30 +8471,30 @@ async function ask(question, { secret = false } = {}) {
 }
 async function requireConfig(path) {
 	const config = await readConfig(path);
-	if (!config) fail(`Not logged in on this machine. Run: ${CMD} login --server <url>`);
+	if (!config) fail(`Not logged in on this machine. Run: ${CMD} login --sync-server <url>`);
 	return config;
 }
 async function login(args) {
 	const path = defaultConfigPath();
-	const server = (args.server ?? (await readConfig(path))?.server ?? await ask("Sync Server URL: ")).replace(/\/$/, "");
-	if (!/^https?:\/\//.test(server)) fail("The server must be an http(s) URL.");
-	const pat = args.pat ?? process.env.ETHERPK_PAT ?? await ask(`Personal Access Token (account-wide, from ${server}/account/tokens): `, { secret: true });
+	const syncServer = (args["sync-server"] ?? (await readConfig(path))?.syncServer ?? await ask("Sync Server URL: ")).replace(/\/$/, "");
+	if (!/^https?:\/\//.test(syncServer)) fail("The Sync Server must be an http(s) URL.");
+	const pat = args.pat ?? process.env.ETHERPK_PAT ?? await ask(`Personal Access Token (account-wide, from ${syncServer}/account/tokens): `, { secret: true });
 	if (!pat) fail("A Personal Access Token is required.");
 	const account = await connectAccount({
-		server,
+		syncServer,
 		pat
 	});
-	console.log(`Signed in to ${server} as ${account.principal.email ?? account.principal.name ?? account.principal.id}.`);
+	console.log(`Signed in to ${syncServer} as ${account.principal.email ?? account.principal.name ?? account.principal.id}.`);
 	const byRecoveryCode = async () => unlockByRecoveryCode(account.api, process.env.ETHERPK_RECOVERY_CODE ?? await ask("Recovery Code: ", { secret: true }));
 	const vaultKey = args["recovery-code"] ? await byRecoveryCode() : await approveOrFallBack(account, byRecoveryCode);
 	await writeConfig(path, {
-		server,
+		syncServer,
 		pat,
 		vaultKey: toBase64Url(vaultKey)
 	});
 	console.log(`Keys unlocked and cached in ${path} (owner-only). Anyone who can read your files on this machine can read this account, as with a signed-in browser.`);
 	await listGraphs({
-		server,
+		syncServer,
 		pat,
 		vaultKey: toBase64Url(vaultKey)
 	});
@@ -8642,7 +8642,7 @@ async function main() {
 		args: process.argv.slice(2),
 		allowPositionals: true,
 		options: {
-			server: { type: "string" },
+			"sync-server": { type: "string" },
 			pat: { type: "string" },
 			"recovery-code": { type: "boolean" },
 			graph: { type: "string" },