@adapt-toolkit/a2adapt 0.8.1 → 0.9.1

package/dist/cli.js

@@ -13,7 +13,7 @@ import * as fs2 from "node:fs";
 // src/config.ts
 import * as fs from "node:fs";
 import { homedir } from "node:os";
-import { resolve, join, dirname } from "node:path";
+import { resolve, join, dirname, basename } from "node:path";
 var DEFAULT_CONFIG = {
   brokerUrl: "ws://a2adapt.adaptframework.solutions/broker",
   port: 3030,
@@ -70,6 +70,29 @@ function writeConfig(cfg) {
   }
   return path;
 }
+var IDENTITY_FILENAME = ".a2adapt-identity";
+function buildIdentityFile(opts) {
+  if (!opts.name.trim()) throw new Error("identity name must not be empty");
+  const obj = { identity: opts.name.trim() };
+  if (opts.force) obj.force = true;
+  obj.expose_local = opts.exposeLocal ?? true;
+  obj.local_auto_accept = opts.localAutoAccept ?? true;
+  return obj;
+}
+function resolveIdentityFilePath(target) {
+  const abs = resolve(target);
+  return basename(abs) === IDENTITY_FILENAME ? abs : join(abs, IDENTITY_FILENAME);
+}
+function writeIdentityFile(target, opts, overwrite = false) {
+  const obj = buildIdentityFile(opts);
+  const path = resolveIdentityFilePath(target);
+  if (!overwrite && fs.existsSync(path)) {
+    throw new Error(`${path} already exists \u2014 pass overwrite to replace it`);
+  }
+  fs.mkdirSync(dirname(path), { recursive: true });
+  fs.writeFileSync(path, JSON.stringify(obj, null, 2) + "\n");
+  return path;
+}
 
 // src/cli.ts
 var CONFIG = loadConfig();
@@ -274,18 +297,120 @@ daemon is running (pid ${pid}); restart now to apply? [y/N]: `)).trim().toLowerC
   const r = spawnSync(process.execPath, [SELF, "start"], { stdio: "inherit" });
   if (r.status !== 0) process.exit(r.status ?? 1);
 }
-function cmdWatch(which) {
+function flagPair(argv, on, off) {
+  if (argv.includes(off)) return { value: false, set: true };
+  if (argv.includes(on)) return { value: true, set: true };
+  return { value: void 0, set: false };
+}
+function flagValue(argv, name) {
+  const i = argv.indexOf(name);
+  return i >= 0 && i + 1 < argv.length ? argv[i + 1] : void 0;
+}
+async function cmdDefineLocalIdentityFile(argv) {
+  const name = flagValue(argv, "--name");
+  const force = flagPair(argv, "--force-bind", "--no-force-bind");
+  const localBook = flagPair(argv, "--local-book", "--no-local-book");
+  const autoAccept = flagPair(argv, "--auto-accept-local", "--no-auto-accept-local");
+  const overwrite = argv.includes("--overwrite");
+  const print = argv.includes("--print");
+  const target = flagValue(argv, "--path") ?? flagValue(argv, "--dir") ?? process.cwd();
+  const nonInteractive = name !== void 0 || force.set || localBook.set || autoAccept.set || print;
+  let opts;
+  if (nonInteractive) {
+    if (!name || !name.trim()) {
+      err("define-local-identity-file: --name is required in non-interactive mode.");
+      process.exit(1);
+    }
+    opts = {
+      name: name.trim(),
+      force: force.value ?? false,
+      exposeLocal: localBook.value ?? true,
+      localAutoAccept: autoAccept.value ?? true
+    };
+  } else {
+    opts = await runIdentitySurvey();
+  }
+  if (print) {
+    out(JSON.stringify(buildIdentityFile(opts), null, 2));
+    return;
+  }
+  const path = resolveIdentityFilePath(target);
+  if (!overwrite && fs2.existsSync(path)) {
+    if (nonInteractive) {
+      err(`define-local-identity-file: ${path} already exists \u2014 pass --overwrite to replace it.`);
+      process.exit(1);
+    }
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    let ok = false;
+    try {
+      const ans = (await rl.question(`
+${path} already exists \u2014 overwrite? [y/N]: `)).trim().toLowerCase();
+      ok = ans === "y" || ans === "yes";
+    } finally {
+      rl.close();
+    }
+    if (!ok) {
+      out("aborted \u2014 nothing written.");
+      return;
+    }
+  }
+  const written = writeIdentityFile(target, opts, true);
+  out("");
+  out(`wrote ${written}:`);
+  out(JSON.stringify(buildIdentityFile(opts), null, 2));
+}
+async function runIdentitySurvey() {
+  out(`a2adapt-mcp define-local-identity-file \u2014 interactive`);
+  out(`Answer the prompts; the result is written to ${join2(process.cwd(), IDENTITY_FILENAME)}.`);
+  out("");
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    const askYesNo = async (label, def) => {
+      const hint = def ? "Y/n" : "y/N";
+      const ans = (await rl.question(`  ${label} [${hint}]: `)).trim().toLowerCase();
+      if (ans === "") return def;
+      return ans === "y" || ans === "yes";
+    };
+    let name = "";
+    while (!name) {
+      name = (await rl.question("  Identity name: ")).trim();
+      if (!name) out("  (name is required)");
+    }
+    const force = await askYesNo("Force-bind (pin pre-authorizes evicting another session)?", false);
+    const exposeLocal = await askYesNo("Add to the host-local contact book?", true);
+    const localAutoAccept = await askYesNo("Auto-accept local invites/introductions?", true);
+    return { name, force, exposeLocal, localAutoAccept };
+  } finally {
+    rl.close();
+  }
+}
+async function resolveWatchDir() {
+  try {
+    const ctrl = new AbortController();
+    const t = setTimeout(() => ctrl.abort(), 1500);
+    const resp = await fetch(`http://127.0.0.1:${PORT}/state-dir`, { signal: ctrl.signal });
+    clearTimeout(t);
+    if (resp.ok) {
+      const body = await resp.json();
+      if (typeof body.stateDir === "string" && body.stateDir) return resolve2(body.stateDir);
+    }
+  } catch {
+  }
+  return STATE_DIR;
+}
+async function cmdWatch(which) {
+  const watchDir = await resolveWatchDir();
   const offsets = /* @__PURE__ */ new Map();
   const scan = (initial) => {
     let names;
     try {
-      names = fs2.readdirSync(STATE_DIR, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name);
+      names = fs2.readdirSync(watchDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name);
     } catch {
       return;
     }
     for (const name of names) {
       if (which && name !== which) continue;
-      const logPath = join2(STATE_DIR, name, "notifications.log");
+      const logPath = join2(watchDir, name, "notifications.log");
       let size;
       try {
         size = fs2.statSync(logPath).size;
@@ -334,7 +459,7 @@ function cmdWatch(which) {
     }
   };
   err(
-    `a2adapt-mcp watch: watching ${which ? `identity "${which}"` : "all identities"} under ${STATE_DIR} (Ctrl-C to stop)`
+    `a2adapt-mcp watch: watching ${which ? `identity "${which}"` : "all identities"} under ${watchDir} (Ctrl-C to stop)`
   );
   scan(true);
   const timer = setInterval(() => scan(false), 1e3);
@@ -482,6 +607,12 @@ function usage() {
   out("  serve     run in the foreground (used by start; handy for debugging)");
   out("  watch [identity]  stream one line per new inbound message (wake source for a Monitor)");
   out("");
+  out("  define-local-identity-file   write a .a2adapt-identity workspace pin");
+  out("    interactive (default): 4-question survey, writes to CWD");
+  out("    scripted: --name <s> [--force-bind] [--local-book] [--auto-accept-local]");
+  out("              negate with --no-force-bind / --no-local-book / --no-auto-accept-local");
+  out("              --dir <path> | --path <file> (default CWD) \xB7 --overwrite \xB7 --print");
+  out("");
   out("  install-service    install + start a boot-persistent service (systemd/launchd)");
   out("  uninstall-service  stop + remove that service");
   out("");
@@ -531,8 +662,11 @@ async function main() {
     case "setup":
       await cmdSetup();
       break;
+    case "define-local-identity-file":
+      await cmdDefineLocalIdentityFile(process.argv.slice(3));
+      break;
     case "watch":
-      cmdWatch(process.argv[3]);
+      await cmdWatch(process.argv[3]);
       break;
     case "install-service":
       await cmdInstallService();

package/dist/index.js

@@ -22427,7 +22427,7 @@ var StreamableHTTPServerTransport = class {
 };
 
 // src/index.ts
-import { resolve as resolve2, join as join2, dirname as dirname2 } from "node:path";
+import { resolve as resolve2, join as join2, dirname as dirname2, isAbsolute } from "node:path";
 import { fileURLToPath } from "node:url";
 import { randomBytes, randomUUID } from "node:crypto";
 import { createServer as createHttpServer } from "node:http";
@@ -22440,7 +22440,7 @@ import { object_to_adapt_value } from "@adapt-toolkit/sdk/wrapper";
 // src/config.ts
 import * as fs from "node:fs";
 import { homedir } from "node:os";
-import { resolve, join, dirname } from "node:path";
+import { resolve, join, dirname, basename } from "node:path";
 var DEFAULT_CONFIG = {
   brokerUrl: "ws://a2adapt.adaptframework.solutions/broker",
   port: 3030,
@@ -22487,9 +22487,32 @@ function loadConfig() {
     gcIntervalMs: envInt("A2ADAPT_GC_INTERVAL_MS") ?? file.gcIntervalMs ?? DEFAULT_CONFIG.gcIntervalMs
   };
 }
+var IDENTITY_FILENAME = ".a2adapt-identity";
+function buildIdentityFile(opts) {
+  if (!opts.name.trim()) throw new Error("identity name must not be empty");
+  const obj = { identity: opts.name.trim() };
+  if (opts.force) obj.force = true;
+  obj.expose_local = opts.exposeLocal ?? true;
+  obj.local_auto_accept = opts.localAutoAccept ?? true;
+  return obj;
+}
+function resolveIdentityFilePath(target) {
+  const abs = resolve(target);
+  return basename(abs) === IDENTITY_FILENAME ? abs : join(abs, IDENTITY_FILENAME);
+}
+function writeIdentityFile(target, opts, overwrite = false) {
+  const obj = buildIdentityFile(opts);
+  const path = resolveIdentityFilePath(target);
+  if (!overwrite && fs.existsSync(path)) {
+    throw new Error(`${path} already exists \u2014 pass overwrite to replace it`);
+  }
+  fs.mkdirSync(dirname(path), { recursive: true });
+  fs.writeFileSync(path, JSON.stringify(obj, null, 2) + "\n");
+  return path;
+}
 
 // src/index.ts
-var VERSION = true ? "0.8.1" : "0.0.0-dev";
+var VERSION = true ? "0.9.1" : "0.0.0-dev";
 var CONFIG = loadConfig();
 var STATE_DIR = CONFIG.stateDir;
 var BROKER_URL = CONFIG.brokerUrl;
@@ -23049,6 +23072,32 @@ function createMcpServer(getSessionId) {
       }
     }
   );
+  server.tool(
+    "define_local_identity_file",
+    "Write a `.a2adapt-identity` workspace-pin file that ties a directory to an identity, so a future Claude Code session here auto-binds it (and the SessionStart hook arms the right Monitor). Use this instead of hand-writing the file. Because this daemon is shared and its CWD is not the user's project, you MUST pass an absolute `path` (the target directory, or the full path ending in .a2adapt-identity). Refuses to overwrite unless overwrite=true.",
+    {
+      name: external_exports.string().min(1).describe("Identity name the workspace belongs to."),
+      path: external_exports.string().min(1).describe("Absolute target: a directory (file is created inside it) or a full path ending in .a2adapt-identity."),
+      force: external_exports.boolean().default(false).describe("Pin pre-authorizes force-binding (evicting another session) \u2014 no user prompt at bind time."),
+      expose_local: external_exports.boolean().default(true).describe("Publish this identity in the host-local contact book."),
+      local_auto_accept: external_exports.boolean().default(true).describe("Auto-accept local contact-book introductions (false = they queue for approval)."),
+      overwrite: external_exports.boolean().default(false).describe("Replace an existing .a2adapt-identity file.")
+    },
+    async ({ name, path, force, expose_local, local_auto_accept, overwrite }) => {
+      if (!isAbsolute(path)) {
+        return textResult(`define_local_identity_file failed: path must be absolute (got "${path}").`, true);
+      }
+      const opts = { name, force, exposeLocal: expose_local, localAutoAccept: local_auto_accept };
+      try {
+        const written = writeIdentityFile(path, opts, overwrite);
+        const json = JSON.stringify(buildIdentityFile(opts), null, 2);
+        return textResult(`Wrote ${written}:
+${json}`);
+      } catch (err) {
+        return textResult(`define_local_identity_file failed: ${String(err)}`, true);
+      }
+    }
+  );
   server.tool(
     "choose_identity",
     "Bind an existing identity to this session so the messaging tools act as it. Binding is exclusive: if the identity is already in use by another session, this is declined unless force=true, which evicts the other session. Never pass force=true on your own initiative \u2014 ask the user and get an explicit confirmation first.",
@@ -23482,6 +23531,11 @@ async function main() {
   const transports = {};
   const httpServer = createHttpServer(async (req, res) => {
     const url = new URL(req.url, `http://localhost:${PORT}`);
+    if (req.method === "GET" && url.pathname === "/state-dir") {
+      res.writeHead(200, { "Content-Type": "application/json" });
+      res.end(JSON.stringify({ stateDir: STATE_DIR, version: VERSION }));
+      return;
+    }
     if (url.pathname !== "/mcp") {
       res.writeHead(404, { "Content-Type": "text/plain" });
       res.end("Not found");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adapt-toolkit/a2adapt",
-  "version": "0.8.1",
+  "version": "0.9.1",
   "description": "MCP server daemon for a2adapt — one native ADAPT wrapper hosting N self-sovereign identities, exposing secure agent-to-agent messaging tools over HTTP (Streamable HTTP). Run `a2adapt-mcp start`.",
   "type": "module",
   "license": "MIT",