@toon-protocol/client-mcp 0.2.0 → 0.3.1

package/dist/daemon.js

@@ -4,7 +4,7 @@ import {
   ClientRunner,
   registerRoutes,
   scaffoldFirstRun
-} from "./chunk-L6F2B3GX.js";
+} from "./chunk-QFHCXJ2V.js";
 import {
   ControlClient,
   ToonClient,
@@ -17,12 +17,11 @@ import {
   resolveConfig,
   spawnDaemonDetached,
   waitForReady
-} from "./chunk-NP35YO5O.js";
+} from "./chunk-CQ2QIZ6Z.js";
 import "./chunk-32QD72IL.js";
 import "./chunk-DLYE6U2Z.js";
 import "./chunk-LR7W2ISE.js";
 import "./chunk-VA7XC4FD.js";
-import "./chunk-SKQTKZIH.js";
 import "./chunk-F22GNSF6.js";
 
 // src/daemon.ts

package/dist/daemon.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/daemon.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * `toon-clientd` — the always-on, detached TOON client daemon. It owns the two\n * long-lived connections that cannot live in an ephemeral agent session:\n *   • a BTP session to the apex/connector (paid writes), and\n *   • a persistent town-relay Nostr-WS subscription (free reads),\n * plus the payment channels (with a persisted nonce watermark) and the signer.\n *\n * Subcommands:\n *   toon-clientd run      Run the daemon in the foreground (used internally by\n *                         the detached spawn; logs to stdout).\n *   toon-clientd start    Spawn the daemon detached and wait until reachable.\n *   toon-clientd stop     Stop a running daemon (SIGTERM the locked PID).\n *   toon-clientd status   Print the daemon status as JSON.\n */\n\nimport Fastify from 'fastify';\nimport { ToonClient } from '@toon-protocol/client';\nimport {\n  defaultConfigPath,\n  readConfigFile,\n  resolveConfig,\n  type ResolvedDaemonConfig,\n} from './daemon/config.js';\nimport { scaffoldFirstRun } from './daemon/first-run.js';\nimport { ClientRunner, type ToonClientLike } from './daemon/client-runner.js';\nimport { registerRoutes } from './daemon/routes.js';\nimport {\n  acquireLock,\n  isProcessAlive,\n  readPid,\n  releaseLock,\n  spawnDaemonDetached,\n  waitForReady,\n} from './daemon/lifecycle.js';\nimport { ControlClient } from './control-client.js';\n\nfunction baseUrl(config: ResolvedDaemonConfig): string {\n  return `http://127.0.0.1:${config.httpPort}`;\n}\n\nfunction loadResolvedConfig(): ResolvedDaemonConfig {\n  const path = process.env['TOON_CLIENT_CONFIG'] ?? defaultConfigPath();\n  return resolveConfig(readConfigFile(path));\n}\n\n/** Run the daemon in the foreground (the detached child's actual work). */\nasync function runForeground(): Promise<void> {\n  acquireLock();\n  const config = loadResolvedConfig();\n  const log = (msg: string): void => console.error(msg);\n\n  const runner = new ClientRunner({\n    config,\n    createClient: (clientConfig) =>\n      new ToonClient(clientConfig) as unknown as ToonClientLike,\n    logger: log,\n  });\n\n  const app = Fastify({ logger: false });\n  registerRoutes(app, runner);\n\n  // Begin bootstrap (non-blocking) before listening so /status is immediately\n  // reachable and reports `bootstrapping: true` while anon/BTP come up.\n  runner.start();\n\n  await app.listen({ host: '127.0.0.1', port: config.httpPort });\n  log(`[toon-clientd] listening on ${baseUrl(config)}`);\n\n  let shuttingDown = false;\n  const shutdown = async (signal: string): Promise<void> => {\n    if (shuttingDown) return;\n    shuttingDown = true;\n    log(`[toon-clientd] received ${signal}, shutting down`);\n    try {\n      await app.close();\n    } catch {\n      /* ignore */\n    }\n    await runner.stop();\n    releaseLock();\n    setTimeout(() => process.exit(0), 500).unref();\n  };\n  process.on('SIGTERM', () => void shutdown('SIGTERM'));\n  process.on('SIGINT', () => void shutdown('SIGINT'));\n}\n\n/** Spawn the daemon detached and wait until the control plane responds. */\nasync function start(): Promise<void> {\n  const config = loadResolvedConfig();\n  const url = baseUrl(config);\n  const existing = readPid();\n  if (existing !== null && isProcessAlive(existing)) {\n    console.log(`toon-clientd already running (pid ${existing}) at ${url}`);\n    return;\n  }\n  const pid = spawnDaemonDetached();\n  const ok = await waitForReady(url, 20_000);\n  if (ok) {\n    console.log(`toon-clientd started (pid ${pid}) at ${url}`);\n  } else {\n    console.error(\n      `toon-clientd spawned (pid ${pid}) but did not become reachable at ${url} in time. ` +\n        `Check the daemon log.`\n    );\n    process.exitCode = 1;\n  }\n}\n\n/** Stop a running daemon via SIGTERM on the locked PID. */\nasync function stop(): Promise<void> {\n  const pid = readPid();\n  if (pid === null || !isProcessAlive(pid)) {\n    console.log('toon-clientd is not running');\n    releaseLock();\n    return;\n  }\n  process.kill(pid, 'SIGTERM');\n  // Wait briefly for the process to exit.\n  for (let i = 0; i < 40; i++) {\n    if (!isProcessAlive(pid)) break;\n    await new Promise((r) => setTimeout(r, 100));\n  }\n  console.log(`toon-clientd stopped (pid ${pid})`);\n}\n\n/** Print the daemon status JSON. */\nasync function status(): Promise<void> {\n  const config = loadResolvedConfig();\n  const client = new ControlClient({ baseUrl: baseUrl(config) });\n  try {\n    const s = await client.status();\n    console.log(JSON.stringify(s, null, 2));\n  } catch {\n    console.log(JSON.stringify({ running: false }, null, 2));\n    process.exitCode = 1;\n  }\n}\n\nasync function main(): Promise<void> {\n  const cmd = process.argv[2] ?? 'run';\n  switch (cmd) {\n    case 'run':\n      // First-run onboarding (#251): mint + persist an identity and scaffold\n      // the transport config so a fresh install starts with no manual setup.\n      await scaffoldFirstRun();\n      await runForeground();\n      break;\n    case 'start':\n      await scaffoldFirstRun();\n      await start();\n      break;\n    case 'stop':\n      await stop();\n      break;\n    case 'status':\n      await status();\n      break;\n    default:\n      console.error(\n        `Unknown command \"${cmd}\". Usage: toon-clientd <run|start|stop|status>`\n      );\n      process.exitCode = 1;\n  }\n}\n\nmain().catch((err) => {\n  console.error(\n    err instanceof Error ? (err.stack ?? err.message) : String(err)\n  );\n  process.exitCode = 1;\n});\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/daemon.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * `toon-clientd` — the always-on, detached TOON client daemon. It owns the two\n * long-lived connections that cannot live in an ephemeral agent session:\n *   • a BTP session to the apex/connector (paid writes), and\n *   • a persistent town-relay Nostr-WS subscription (free reads),\n * plus the payment channels (with a persisted nonce watermark) and the signer.\n *\n * Subcommands:\n *   toon-clientd run      Run the daemon in the foreground (used internally by\n *                         the detached spawn; logs to stdout).\n *   toon-clientd start    Spawn the daemon detached and wait until reachable.\n *   toon-clientd stop     Stop a running daemon (SIGTERM the locked PID).\n *   toon-clientd status   Print the daemon status as JSON.\n */\n\nimport Fastify from 'fastify';\nimport { ToonClient } from '@toon-protocol/client';\nimport {\n  defaultConfigPath,\n  readConfigFile,\n  resolveConfig,\n  type ResolvedDaemonConfig,\n} from './daemon/config.js';\nimport { scaffoldFirstRun } from './daemon/first-run.js';\nimport { ClientRunner, type ToonClientLike } from './daemon/client-runner.js';\nimport { registerRoutes } from './daemon/routes.js';\nimport {\n  acquireLock,\n  isProcessAlive,\n  readPid,\n  releaseLock,\n  spawnDaemonDetached,\n  waitForReady,\n} from './daemon/lifecycle.js';\nimport { ControlClient } from './control-client.js';\n\nfunction baseUrl(config: ResolvedDaemonConfig): string {\n  return `http://127.0.0.1:${config.httpPort}`;\n}\n\nfunction loadResolvedConfig(): ResolvedDaemonConfig {\n  const path = process.env['TOON_CLIENT_CONFIG'] ?? defaultConfigPath();\n  return resolveConfig(readConfigFile(path));\n}\n\n/** Run the daemon in the foreground (the detached child's actual work). */\nasync function runForeground(): Promise<void> {\n  acquireLock();\n  const config = loadResolvedConfig();\n  const log = (msg: string): void => console.error(msg);\n\n  const runner = new ClientRunner({\n    config,\n    createClient: (clientConfig) =>\n      new ToonClient(clientConfig) as unknown as ToonClientLike,\n    logger: log,\n  });\n\n  const app = Fastify({ logger: false });\n  registerRoutes(app, runner);\n\n  // Begin bootstrap (non-blocking) before listening so /status is immediately\n  // reachable and reports `bootstrapping: true` while anon/BTP come up.\n  runner.start();\n\n  await app.listen({ host: '127.0.0.1', port: config.httpPort });\n  log(`[toon-clientd] listening on ${baseUrl(config)}`);\n\n  let shuttingDown = false;\n  const shutdown = async (signal: string): Promise<void> => {\n    if (shuttingDown) return;\n    shuttingDown = true;\n    log(`[toon-clientd] received ${signal}, shutting down`);\n    try {\n      await app.close();\n    } catch {\n      /* ignore */\n    }\n    await runner.stop();\n    releaseLock();\n    setTimeout(() => process.exit(0), 500).unref();\n  };\n  process.on('SIGTERM', () => void shutdown('SIGTERM'));\n  process.on('SIGINT', () => void shutdown('SIGINT'));\n}\n\n/** Spawn the daemon detached and wait until the control plane responds. */\nasync function start(): Promise<void> {\n  const config = loadResolvedConfig();\n  const url = baseUrl(config);\n  const existing = readPid();\n  if (existing !== null && isProcessAlive(existing)) {\n    console.log(`toon-clientd already running (pid ${existing}) at ${url}`);\n    return;\n  }\n  const pid = spawnDaemonDetached();\n  const ok = await waitForReady(url, 20_000);\n  if (ok) {\n    console.log(`toon-clientd started (pid ${pid}) at ${url}`);\n  } else {\n    console.error(\n      `toon-clientd spawned (pid ${pid}) but did not become reachable at ${url} in time. ` +\n        `Check the daemon log.`\n    );\n    process.exitCode = 1;\n  }\n}\n\n/** Stop a running daemon via SIGTERM on the locked PID. */\nasync function stop(): Promise<void> {\n  const pid = readPid();\n  if (pid === null || !isProcessAlive(pid)) {\n    console.log('toon-clientd is not running');\n    releaseLock();\n    return;\n  }\n  process.kill(pid, 'SIGTERM');\n  // Wait briefly for the process to exit.\n  for (let i = 0; i < 40; i++) {\n    if (!isProcessAlive(pid)) break;\n    await new Promise((r) => setTimeout(r, 100));\n  }\n  console.log(`toon-clientd stopped (pid ${pid})`);\n}\n\n/** Print the daemon status JSON. */\nasync function status(): Promise<void> {\n  const config = loadResolvedConfig();\n  const client = new ControlClient({ baseUrl: baseUrl(config) });\n  try {\n    const s = await client.status();\n    console.log(JSON.stringify(s, null, 2));\n  } catch {\n    console.log(JSON.stringify({ running: false }, null, 2));\n    process.exitCode = 1;\n  }\n}\n\nasync function main(): Promise<void> {\n  const cmd = process.argv[2] ?? 'run';\n  switch (cmd) {\n    case 'run':\n      // First-run onboarding (#251): mint + persist an identity and scaffold\n      // the transport config so a fresh install starts with no manual setup.\n      await scaffoldFirstRun();\n      await runForeground();\n      break;\n    case 'start':\n      await scaffoldFirstRun();\n      await start();\n      break;\n    case 'stop':\n      await stop();\n      break;\n    case 'status':\n      await status();\n      break;\n    default:\n      console.error(\n        `Unknown command \"${cmd}\". Usage: toon-clientd <run|start|stop|status>`\n      );\n      process.exitCode = 1;\n  }\n}\n\nmain().catch((err) => {\n  console.error(\n    err instanceof Error ? (err.stack ?? err.message) : String(err)\n  );\n  process.exitCode = 1;\n});\n"],"mappings":"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","names":[]}

package/dist/e2e/run-journey.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node