@toon-protocol/client-mcp 0.31.0 → 0.31.2

package/dist/{chunk-U227QSQG.js → chunk-I5L5CB4N.js}

@@ -2,7 +2,7 @@ import { createRequire as __cr } from 'module'; const require = __cr(import.meta
 import {
   ControlApiError,
   DaemonUnreachableError
-} from "./chunk-QHNSETFB.js";
+} from "./chunk-ARFPM2PT.js";
 
 // src/mcp-tools.ts
 var TOOL_DEFINITIONS = [
@@ -226,4 +226,4 @@ export {
   TOOL_DEFINITIONS,
   dispatchTool
 };
-//# sourceMappingURL=chunk-U227QSQG.js.map
+//# sourceMappingURL=chunk-I5L5CB4N.js.map

package/dist/{chunk-4K6S3VPM.js → chunk-PRFPAEGG.js}

@@ -1,14 +1,117 @@
 import { createRequire as __cr } from 'module'; const require = __cr(import.meta.url);
 import {
+  DEFAULT_KEYSTORE_PASSWORD,
   ToonError,
   buildIlpPrepare,
+  configDir,
   decodeEventFromToon,
-  encodeEventToToon
-} from "./chunk-QHNSETFB.js";
+  defaultConfigPath,
+  deriveFullIdentity,
+  encodeEventToToon,
+  generateKeystore,
+  readConfigFile
+} from "./chunk-ARFPM2PT.js";
+import {
+  startManagedAnonProxy
+} from "./chunk-SKQTKZIH.js";
 import {
   __require
 } from "./chunk-F22GNSF6.js";
 
+// src/daemon/first-run.ts
+import { existsSync, mkdirSync, writeFileSync } from "fs";
+import { dirname, join } from "path";
+function defaultKeystorePath() {
+  return join(configDir(), "keystore.json");
+}
+function hasConfiguredIdentity(file) {
+  return Boolean(
+    process.env["TOON_CLIENT_MNEMONIC"]?.trim() || file.keystorePath || file.mnemonic
+  );
+}
+var CONFIG_HELP = {
+  transport: "Point btpUrl/relayUrl at your apex. For an .anyone hidden service use ws://<host>.anyone:3000/btp + ws://<host>.anyone:7100 \u2014 the daemon auto-routes through a managed anon proxy. For a direct apex use ws://<host>:3000/btp + ws://<host>:7100.",
+  btpUrl: "REQUIRED. BTP WebSocket URL of the apex/connector for paid writes.",
+  relayUrl: "Town relay WebSocket URL for FREE reads. Default ws://localhost:7100.",
+  managedAnonProxy: "Optional override \u2014 leave unset to auto-infer from btpUrl (.anyone host \u2192 managed anon proxy, anything else \u2192 direct).",
+  keystorePath: "Auto-generated encrypted identity. Do not hand-edit; back up your seed phrase."
+};
+async function scaffoldFirstRun(opts = {}) {
+  const log = opts.log ?? ((m) => console.error(m));
+  const configPath = opts.configPath ?? process.env["TOON_CLIENT_CONFIG"] ?? defaultConfigPath();
+  mkdirSync(dirname(configPath), { recursive: true });
+  const file = readConfigFile(configPath);
+  let updated = { ...file };
+  let changed = false;
+  if (!hasConfiguredIdentity(file)) {
+    const keystorePath = defaultKeystorePath();
+    const envPassword = process.env["TOON_CLIENT_KEYSTORE_PASSWORD"];
+    const password = envPassword ?? DEFAULT_KEYSTORE_PASSWORD;
+    let mnemonic;
+    if (existsSync(keystorePath)) {
+      mnemonic = "";
+      log(
+        `[toon-clientd] first run: relinking existing keystore at ${keystorePath}`
+      );
+    } else {
+      const generated = generateKeystore(keystorePath, password);
+      mnemonic = generated.mnemonic;
+    }
+    updated = {
+      ...updated,
+      keystorePath,
+      // Only flag auto-password when WE chose it, so a user-imported keystore
+      // (custom password) still requires the env var.
+      ...envPassword ? {} : { keystoreAutoPassword: true }
+    };
+    changed = true;
+    if (mnemonic) {
+      await printNewIdentity(mnemonic, keystorePath, Boolean(envPassword), log);
+    }
+  }
+  if (!existsSync(configPath)) {
+    updated = {
+      _help: CONFIG_HELP,
+      btpUrl: "",
+      relayUrl: "ws://localhost:7100",
+      ...updated
+    };
+    changed = true;
+    log(
+      `[toon-clientd] wrote starter config at ${configPath} \u2014 set "btpUrl" to your apex before publishing.`
+    );
+  }
+  if (changed) writeConfigFile(configPath, updated);
+}
+async function printNewIdentity(mnemonic, keystorePath, hasEnvPassword, log) {
+  const id = await deriveFullIdentity(mnemonic);
+  const lines = [
+    "",
+    "\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550",
+    "  TOON client: generated a new identity (first run)",
+    "\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550",
+    `  Nostr pubkey : ${id.nostr.pubkey}`,
+    `  EVM address  : ${id.evm.address}`,
+    ...id.solana.publicKey ? [`  Solana       : ${id.solana.publicKey}`] : [],
+    ...id.mina.publicKey ? [`  Mina         : ${id.mina.publicKey}`] : [],
+    "",
+    "  Seed phrase (BACK THIS UP \u2014 shown only once):",
+    `    ${mnemonic}`,
+    "",
+    `  Encrypted keystore: ${keystorePath}`,
+    hasEnvPassword ? "  Encrypted with TOON_CLIENT_KEYSTORE_PASSWORD." : "  Encrypted with the default password (set TOON_CLIENT_KEYSTORE_PASSWORD\n  + re-import to use your own). Identity reloads automatically on restart.",
+    "\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550",
+    ""
+  ];
+  log(lines.join("\n"));
+}
+function writeConfigFile(path, file) {
+  writeFileSync(path, JSON.stringify(file, null, 2) + "\n", {
+    encoding: "utf8",
+    mode: 384
+  });
+}
+
 // src/relay-subscription.ts
 import { createRequire } from "module";
 var nodeRequire = createRequire(import.meta.url);
@@ -1114,8 +1217,8 @@ function getRandomValues(buf) {
 }
 
 // src/daemon/apex-channel-store.ts
-import { mkdirSync, readFileSync, writeFileSync } from "fs";
-import { dirname } from "path";
+import { mkdirSync as mkdirSync2, readFileSync, writeFileSync as writeFileSync2 } from "fs";
+import { dirname as dirname2 } from "path";
 function key(destination, chain) {
   return `${destination}|${chain}`;
 }
@@ -1132,8 +1235,8 @@ function loadApexChannel(path, destination, chain) {
 function saveApexChannel(path, destination, chain, record) {
   const store = readStore(path);
   store[key(destination, chain)] = record;
-  mkdirSync(dirname(path), { recursive: true });
-  writeFileSync(path, JSON.stringify(store, null, 2), { mode: 384 });
+  mkdirSync2(dirname2(path), { recursive: true });
+  writeFileSync2(path, JSON.stringify(store, null, 2), { mode: 384 });
 }
 
 // src/daemon/client-runner.ts
@@ -1141,6 +1244,7 @@ var ClientRunner = class {
   config;
   client;
   relay;
+  startReadProxy;
   log;
   startedAt = Date.now();
   bootstrapping = false;
@@ -1148,6 +1252,10 @@ var ClientRunner = class {
   lastError;
   /** Channel opened against the default apex destination. */
   apexChannelId;
+  /** Teardown for a daemon-managed read proxy (btp-direct + relay-`.anyone`). */
+  stopReadProxy;
+  /** Error from the read proxy (kept separate from the paid-path `lastError`). */
+  readProxyError;
   stopped = false;
   constructor(deps) {
     this.config = deps.config;
@@ -1159,6 +1267,10 @@ var ClientRunner = class {
       // The TOON relay sends events TOON-encoded (text) on reads, not as JSON.
       decodeEvent: (raw) => decodeEventFromToon(new TextEncoder().encode(raw))
     });
+    this.startReadProxy = deps.startReadProxy ?? ((opts) => startManagedAnonProxy({
+      socksPort: opts.socksPort,
+      ...opts.log ? { log: opts.log } : {}
+    }));
     this.log = deps.logger ?? (() => void 0);
   }
   /**
@@ -1169,9 +1281,33 @@ var ClientRunner = class {
   start() {
     if (this.bootstrapping || this.ready) return;
     this.bootstrapping = true;
+    if (this.config.manageReadProxy) void this.bringUpReadProxy();
     this.relay.start();
     void this.bootstrap();
   }
+  /** Start the daemon-managed `anon` read proxy (best-effort; logs on failure). */
+  async bringUpReadProxy() {
+    const socksPort = this.config.readProxySocksPort ?? 9050;
+    try {
+      this.log(
+        `[runner] starting managed read proxy on 127.0.0.1:${socksPort}`
+      );
+      const proxy = await this.startReadProxy({
+        socksPort,
+        log: (m) => this.log(`[anon] ${m}`)
+      });
+      if (this.stopped) {
+        await proxy.stop();
+        return;
+      }
+      this.stopReadProxy = () => proxy.stop();
+      this.readProxyError = void 0;
+      this.log("[runner] managed read proxy ready");
+    } catch (err) {
+      this.readProxyError = err instanceof Error ? err.message : String(err);
+      this.log(`[runner] managed read proxy failed: ${this.readProxyError}`);
+    }
+  }
   /** The background bootstrap routine (exposed for awaiting in tests). */
   async bootstrap() {
     try {
@@ -1322,7 +1458,8 @@ var ClientRunner = class {
         url: this.config.relayUrl,
         connected: this.relay.isConnected(),
         buffered: this.relay.bufferedCount(),
-        subscriptions: this.relay.activeSubscriptions()
+        subscriptions: this.relay.activeSubscriptions(),
+        ...this.readProxyError ? { proxyError: this.readProxyError } : {}
       },
       ...network ? { network } : {},
       ...this.lastError ? { lastError: this.lastError } : {}
@@ -1435,6 +1572,16 @@ var ClientRunner = class {
     if (this.stopped) return;
     this.stopped = true;
     this.relay.close();
+    if (this.stopReadProxy) {
+      try {
+        await this.stopReadProxy();
+      } catch (err) {
+        this.log(
+          `[runner] read proxy stop error: ${err instanceof Error ? err.message : String(err)}`
+        );
+      }
+      this.stopReadProxy = void 0;
+    }
     try {
       await this.client.stop();
     } catch (err) {
@@ -1558,10 +1705,13 @@ function sendError(reply, status, error, extra = {}) {
 }
 
 export {
+  defaultKeystorePath,
+  hasConfiguredIdentity,
+  scaffoldFirstRun,
   RelaySubscription,
   ClientRunner,
   NotReadyError,
   PublishRejectedError,
   registerRoutes
 };
-//# sourceMappingURL=chunk-4K6S3VPM.js.map
+//# sourceMappingURL=chunk-PRFPAEGG.js.map