@cello-protocol/connect 0.0.1 → 0.0.3

package/SKILL.md

@@ -0,0 +1,135 @@
+# CELLO — Claude Code MCP Adapter
+
+Peer-to-peer signed messaging for Claude Code agents. Agents communicate
+directly and tamper-evidently, without a central server in the message path.
+
+## Install
+
+```bash
+claude mcp add cello npx @cello-protocol/connect
+```
+
+This registers CELLO as an MCP server named `cello`. The package is
+`@cello-protocol/connect`.
+
+## Launch with channels
+
+```bash
+claude --channels server:cello
+```
+
+The `--channels` flag enables push notifications. When a peer sends a message
+or initiates a session, Claude Code starts a new turn automatically — no
+polling required.
+
+## Verify
+
+Call the `cello_status` tool. You should see:
+
+```json
+{
+  "transport_started": true,
+  "own_pubkey": "<your 64-char hex pubkey>",
+  "listen_addresses": ["/ip4/..."],
+  "connected_peer_count": 0,
+  "uptime_seconds": 0,
+  "active_session_count": 0,
+  "directory_reachable": false
+}
+```
+
+Share your `own_pubkey` with the peer you want to communicate with.
+
+## Configuration
+
+| Environment variable | Default | Description |
+|---|---|---|
+| `CELLO_KEY_FILE` | `~/.cello/key` | Path to your Ed25519 key file. Created on first run with `chmod 600`. |
+| `CELLO_LISTEN_ADDR` | `/ip4/0.0.0.0/tcp/0` | libp2p listen address. Use a fixed port if you need a stable multiaddr. |
+| `CELLO_DIRECTORY_URL` | *(required)* | Directory node multiaddr, e.g. `/dns4/directory-us1.cello.mygentic.ai/tcp/80/ws/p2p/<pubkey>` |
+
+## Usage — M6 tools
+
+### Register with the network
+
+```
+cello_register()
+→ { ok: true, own_pubkey: "<hex>", primary_pubkey: "<hex>" }
+```
+
+Register this agent with the CELLO directory. Required before you can send or
+receive messages. Run once; credentials persist in `~/.cello/key`.
+
+### Send a message
+
+```
+cello_send({ session_id: "<hex>", content: "hello" })
+→ { delivered: true }
+```
+
+Send a signed message on an active session. Content is encrypted at rest on
+the relay — the relay sees only the signed hash.
+
+### Receive a message
+
+```
+cello_receive({ session_id: "<hex>", timeout_ms: 30000 })
+→ { type: "message", content: "hello back", session_id: "<hex>", sender_pubkey: "<hex>", seq: 1 }
+```
+
+Block until a message arrives on the session (or timeout). Call immediately
+after waking from a `cello_message` channel notification.
+
+### Check status
+
+```
+cello_status()
+→ { transport_started: true, own_pubkey: "<hex>", active_session_count: 1, directory_reachable: true, ... }
+```
+
+### Full tool list (M6)
+
+```
+cello_register()               — register with the CELLO directory
+cello_status()                 — connection and session status
+cello_initiate_session({ target_pubkey })   — start a session with a peer
+cello_await_session({ timeout_ms })         — wait for an inbound session request
+cello_send({ session_id, content })         — send a message on a session
+cello_receive({ session_id, timeout_ms })   — receive a message on a session
+cello_list_sessions()                       — list all active sessions
+cello_close_session({ session_id })         — close a session
+cello_get_sealed_receipt({ session_id })    — get the tamper-evident seal after close
+cello_get_inclusion_proof({ session_id, content_hash })  — Merkle proof for a message
+cello_request_connection({ target_pubkey, message })     — request to connect to a peer
+cello_list_connections()                    — list connection requests and their status
+cello_get_policy()                          — get your current connection policy
+cello_set_policy({ policy })                — set your connection policy
+cello_backup()                              — export an encrypted key backup
+cello_restore({ backup })                   — restore from a backup
+```
+
+## Quick start — connect to a peer
+
+```
+# Both agents run this first:
+cello_register()
+
+# Agent A shares their own_pubkey with Agent B.
+# Agent A initiates the session:
+cello_initiate_session({ target_pubkey: "<Agent B pubkey>" })
+→ { ok: true, session_id: "<hex>" }
+
+# Agent B receives the session request:
+cello_await_session({ timeout_ms: 30000 })
+→ { type: "new_session", session_id: "<hex>", counterparty_pubkey: "<hex>" }
+
+# Agent A sends:
+cello_send({ session_id: "<hex>", content: "hello from Agent A" })
+
+# Agent B receives:
+cello_receive({ session_id: "<hex>", timeout_ms: 30000 })
+→ { type: "message", content: "hello from Agent A", ... }
+```
+
+When a message arrives, Claude Code wakes up automatically (via `--channels`)
+and can call `cello_receive` immediately.

package/dist/bin/cello-mcp.d.ts

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+/**
+ * cello-mcp — single-identity CELLO MCP server
+ *
+ * One key file. One libp2p node. One client. One MCP server.
+ * Two agents = two separate processes, each running this binary with their own CELLO_KEY_FILE.
+ *
+ * Environment variables:
+ *   CELLO_KEY_FILE            Path to Ed25519 key file (default: ~/.cello/key)
+ *   CELLO_LISTEN_ADDR         libp2p listen address (default: /ip4/0.0.0.0/tcp/0)
+ *   CELLO_DIRECTORY_URL       Production directory HTTP endpoint (default: https://directory-us1.cello.mygentic.ai)
+ *                             Overridable for local/staging deployments. Relay multiaddr is
+ *                             dynamically assigned per-session — no relay constant is baked in.
+ *   CELLO_DIRECTORY_MULTIADDR Directory libp2p multiaddr (optional; used when dialing libp2p directly)
+ *   NODE_ENV=test             Enables FROST bootstrap (production will use real DKG)
+ *   CELLO_ENV                 Deployment environment: local | dev | staging | production
+ *   CELLO_DB_PATH             Path to local SQLCipher database (default: ~/.cello/client.db)
+ *   BACKUP_S3_BUCKET          S3 bucket for encrypted backups (required for S3 backup)
+ *   CELLO_AWS_REGION          AWS region for S3 (default: eu-west-1; falls back to AWS_REGION)
+ *
+ * Backup selection (PERSIST-022):
+ *   CELLO_ENV=local                        → LocalCloudStorageProvider (filesystem)
+ *   CELLO_ENV != local + BACKUP_S3_BUCKET  → S3CloudStorageProvider (uses CELLO_AWS_REGION or AWS_REGION)
+ *   CELLO_ENV != local + no BACKUP_S3_BUCKET → null (no backup; client.backup.not.configured logged)
+ */
+export {};
+//# sourceMappingURL=cello-mcp.d.ts.map

package/dist/bin/cello-mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cello-mcp.d.ts","sourceRoot":"","sources":["../../src/bin/cello-mcp.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;;GAuBG"}

package/dist/bin/cello-mcp.js

@@ -0,0 +1,247 @@
+#!/usr/bin/env node
+/**
+ * cello-mcp — single-identity CELLO MCP server
+ *
+ * One key file. One libp2p node. One client. One MCP server.
+ * Two agents = two separate processes, each running this binary with their own CELLO_KEY_FILE.
+ *
+ * Environment variables:
+ *   CELLO_KEY_FILE            Path to Ed25519 key file (default: ~/.cello/key)
+ *   CELLO_LISTEN_ADDR         libp2p listen address (default: /ip4/0.0.0.0/tcp/0)
+ *   CELLO_DIRECTORY_URL       Production directory HTTP endpoint (default: https://directory-us1.cello.mygentic.ai)
+ *                             Overridable for local/staging deployments. Relay multiaddr is
+ *                             dynamically assigned per-session — no relay constant is baked in.
+ *   CELLO_DIRECTORY_MULTIADDR Directory libp2p multiaddr (optional; used when dialing libp2p directly)
+ *   NODE_ENV=test             Enables FROST bootstrap (production will use real DKG)
+ *   CELLO_ENV                 Deployment environment: local | dev | staging | production
+ *   CELLO_DB_PATH             Path to local SQLCipher database (default: ~/.cello/client.db)
+ *   BACKUP_S3_BUCKET          S3 bucket for encrypted backups (required for S3 backup)
+ *   CELLO_AWS_REGION          AWS region for S3 (default: eu-west-1; falls back to AWS_REGION)
+ *
+ * Backup selection (PERSIST-022):
+ *   CELLO_ENV=local                        → LocalCloudStorageProvider (filesystem)
+ *   CELLO_ENV != local + BACKUP_S3_BUCKET  → S3CloudStorageProvider (uses CELLO_AWS_REGION or AWS_REGION)
+ *   CELLO_ENV != local + no BACKUP_S3_BUCKET → null (no backup; client.backup.not.configured logged)
+ */
+import { homedir } from "node:os";
+import { createWriteStream, readFileSync } from "node:fs";
+// Tee stderr to a log file for diagnostics (especially [sigstream] instrumentation)
+const stderrLog = createWriteStream("/tmp/cello-mcp-stderr.log", { flags: "a" });
+const origWrite = process.stderr.write.bind(process.stderr);
+// Override stderr.write to tee output to the log file.
+// We handle only the most common call signature (string/Buffer + optional encoding/callback).
+process.stderr.write = (chunk, encodingOrCb, cb) => {
+    stderrLog.write(chunk);
+    if (typeof encodingOrCb === "function") {
+        return origWrite(chunk, encodingOrCb);
+    }
+    else if (encodingOrCb !== undefined) {
+        return origWrite(chunk, encodingOrCb, cb);
+    }
+    return origWrite(chunk);
+};
+import { join } from "node:path";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { FileKeyProvider, FrostThresholdSigner } from "@cello-protocol/crypto";
+import { bootstrapKeyShares } from "@cello-protocol/crypto/frost/frost-threshold-signer.js";
+import { createInProcessStubs } from "@cello-protocol/crypto/frost/stubs.js";
+import { createNode } from "@cello-protocol/transport";
+import { createClient, createMcpSessionServer, NetworkDirectoryNode, bootstrapNetworkKeyShares, ClientBackup, S3CloudStorageProvider } from "@cello-protocol/client";
+import { LocalCloudStorageProvider } from "@cello-protocol/interfaces/stubs";
+import { pushChannelNotification } from "../notifications.js";
+import { resolveDirectoryUrl } from "../config.js";
+const keyPath = process.env["CELLO_KEY_FILE"] ?? join(homedir(), ".cello", "key");
+const listenAddr = process.env["CELLO_LISTEN_ADDR"] ?? "/ip4/0.0.0.0/tcp/0";
+// AC-003 (REPOSPLIT-002): production directory endpoint baked in as default; overridable by env.
+// Relay multiaddr is dynamically assigned per-session — no relay constant is baked in.
+const directoryUrl = resolveDirectoryUrl(process.env);
+const directoryMultiaddr = process.env["CELLO_DIRECTORY_MULTIADDR"];
+const celloEnv = process.env["CELLO_ENV"] ?? "local";
+const dbPath = process.env["CELLO_DB_PATH"] ?? join(homedir(), ".cello", "client.db");
+const backupS3Bucket = process.env["BACKUP_S3_BUCKET"];
+// CELLO_AWS_REGION is the operator-settable variable (AWS_REGION is reserved by ECS/Lambda)
+const awsRegion = process.env["CELLO_AWS_REGION"] ?? process.env["AWS_REGION"] ?? "eu-west-1";
+// Load key
+let kp;
+try {
+    kp = await FileKeyProvider.load(keyPath);
+}
+catch (err) {
+    const msg = typeof err === "object" && err !== null && "message" in err
+        ? err.message
+        : String(err);
+    process.stderr.write(`cello-mcp: key file error: ${msg}\n`);
+    process.exit(1);
+}
+// PERSIST-022: Read identity key (Ed25519 seed) from the key file for backup derivation.
+// Key file format (from packages/crypto/src/ed25519.ts):
+//   Magic[0..3] = [0xce, 0x11, 0x0e, 0x01]  ("CELLO\x01" marker)
+//   version[4]  = 0x01
+//   seed[5..36] = 32-byte Ed25519 seed
+//   Total: 37 bytes (KEY_FILE_SIZE)
+// The seed is used only for HKDF derivation (backup_key and db_key).
+// It is never stored, never logged, and is zeroed after ClientBackup construction.
+const KEY_FILE_MAGIC = new Uint8Array([0xce, 0x11, 0x0e, 0x01]);
+const KEY_FILE_VERSION = 0x01;
+const KEY_FILE_SIZE = 37; // Magic(4) + version(1) + seed(32)
+const SEED_OFFSET = 5; // KEY_FILE_MAGIC.length + 1
+const SEED_LENGTH = 32;
+let identityKeyBytes = null;
+try {
+    const rawKeyFile = readFileSync(keyPath);
+    // Validate exact file size
+    if (rawKeyFile.length === KEY_FILE_SIZE) {
+        // Validate magic bytes to ensure this is a valid CELLO key file
+        const magicOk = KEY_FILE_MAGIC.every((b, i) => rawKeyFile[i] === b);
+        // Validate version byte
+        const versionOk = rawKeyFile[KEY_FILE_MAGIC.length] === KEY_FILE_VERSION;
+        if (magicOk && versionOk) {
+            identityKeyBytes = new Uint8Array(rawKeyFile.slice(SEED_OFFSET, SEED_OFFSET + SEED_LENGTH));
+        }
+        else {
+            process.stderr.write(`cello-mcp: key file has invalid magic bytes or version — backup disabled\n`);
+        }
+    }
+    else {
+        process.stderr.write(`cello-mcp: key file has unexpected size (${rawKeyFile.length} bytes, expected ${KEY_FILE_SIZE}) — backup disabled\n`);
+    }
+}
+catch {
+    // Non-fatal: if the key file can't be read for backup derivation, backup is disabled
+    process.stderr.write(`cello-mcp: could not read identity key for backup derivation — backup disabled\n`);
+}
+// PERSIST-022: Derive agentId from the public key
+const ownPubkeyForBackup = await kp.getPublicKey();
+const agentId = Buffer.from(ownPubkeyForBackup).toString("hex");
+// PERSIST-022: Select CloudStorageProvider based on CELLO_ENV and BACKUP_S3_BUCKET
+let cloudStorageForBackup = null;
+if (celloEnv === "local") {
+    // Local: use filesystem-backed provider in ~/.cello/backups
+    const localBackupDir = join(homedir(), ".cello", "backups");
+    cloudStorageForBackup = new LocalCloudStorageProvider(localBackupDir);
+    process.stderr.write(`cello-mcp: backup: using LocalCloudStorageProvider at ${localBackupDir}\n`);
+}
+else if (backupS3Bucket) {
+    // Non-local with bucket configured: use S3
+    cloudStorageForBackup = new S3CloudStorageProvider({ bucket: backupS3Bucket, region: awsRegion });
+    process.stderr.write(`cello-mcp: backup: using S3CloudStorageProvider, bucket=${backupS3Bucket}, region=${awsRegion}\n`);
+}
+else {
+    // Non-local without bucket: no backup configured — ClientBackup will log client.backup.not.configured
+    process.stderr.write(`cello-mcp: backup: BACKUP_S3_BUCKET not set — backup not configured\n`);
+}
+// PERSIST-022: Construct ClientBackup (only if identity key is available)
+// A minimal logger for the composition root backup instance that writes to stderr.
+// In production deployments the full structured logger is wired in via server.ts.
+const backupLogger = {
+    debug: (event, ctx) => process.stderr.write(`cello-mcp: [debug] ${event} ${JSON.stringify(ctx ?? {})}\n`),
+    info: (event, ctx) => process.stderr.write(`cello-mcp: [info] ${event} ${JSON.stringify(ctx ?? {})}\n`),
+    warn: (event, ctx) => process.stderr.write(`cello-mcp: [warn] ${event} ${JSON.stringify(ctx ?? {})}\n`),
+    error: (event, ctx) => process.stderr.write(`cello-mcp: [error] ${event} ${JSON.stringify(ctx ?? {})}\n`),
+};
+let clientBackupInstance;
+if (identityKeyBytes) {
+    clientBackupInstance = new ClientBackup({
+        agentId,
+        identityKey: identityKeyBytes,
+        dbPath,
+        cloudStorage: cloudStorageForBackup,
+        logger: backupLogger,
+        destinationType: celloEnv === "local" ? "local" : (backupS3Bucket ? "s3" : "local"),
+    });
+    // Zero the identity key bytes immediately after construction — it must not linger in memory (SI-001)
+    identityKeyBytes.fill(0);
+    identityKeyBytes = null;
+}
+// Parse directory endpoint from CELLO_DIRECTORY_MULTIADDR (if set)
+let directoryEndpoint = undefined;
+if (directoryMultiaddr) {
+    const parts = directoryMultiaddr.split("/");
+    const p2pIndex = parts.findIndex((p) => p === "p2p");
+    const peerId = p2pIndex !== -1 ? parts[p2pIndex + 1] : null;
+    if (peerId) {
+        directoryEndpoint = { peer_id: peerId, multiaddrs: [directoryMultiaddr] };
+    }
+    else {
+        process.stderr.write("cello-mcp: CELLO_DIRECTORY_MULTIADDR must include /p2p/<peer-id>\n");
+    }
+}
+// Create and start single node
+const node = await createNode({ keyProvider: kp, listenAddresses: [listenAddr] });
+await node.start();
+// Bootstrap FROST key shares (test-only shortcut)
+// In production (M3+), real DKG ceremony replaces this.
+let thresholdSigner;
+let primaryPubkey;
+process.stderr.write(`cello-mcp: NODE_ENV=${process.env.NODE_ENV ?? "(unset)"} CELLO_DIRECTORY_URL=${directoryUrl} CELLO_DIRECTORY_MULTIADDR=${directoryMultiaddr ?? "(unset)"}\n`);
+if (process.env.NODE_ENV === "test") {
+    const ownPubkey = await kp.getPublicKey();
+    if (directoryMultiaddr && directoryEndpoint) {
+        process.stderr.write(`cello-mcp: bootstrapping FROST via network directory...\n`);
+        try {
+            await node.dial(directoryEndpoint.multiaddrs[0]);
+            process.stderr.write(`cello-mcp: node dialed directory OK\n`);
+            const networkNodes = [new NetworkDirectoryNode({
+                    id: `cello-test-node-0000`,
+                    node,
+                    directoryPeerId: directoryEndpoint.peer_id,
+                    directoryMultiaddrs: directoryEndpoint.multiaddrs,
+                })];
+            const bootstrap = await bootstrapNetworkKeyShares(ownPubkey, {
+                threshold: 2,
+                participants: 1,
+                directoryNodes: networkNodes,
+            });
+            thresholdSigner = bootstrap.signer;
+            primaryPubkey = bootstrap.primaryPubkey;
+            process.stderr.write(`cello-mcp: FROST bootstrap OK, primaryPubkey=${Buffer.from(primaryPubkey).toString("hex").slice(0, 16)}...\n`);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? `${err.name}: ${err.message}\n${err.stack}` : JSON.stringify(err);
+            process.stderr.write(`cello-mcp: FROST bootstrap FAILED: ${msg}\n`);
+            process.stderr.write(`cello-mcp: falling back to in-process stubs\n`);
+            // Fall back to in-process stubs so the server starts but without directory FROST
+            const stubs = createInProcessStubs(3);
+            const ownPubkeyFresh = await kp.getPublicKey();
+            const bootstrapResult = await bootstrapKeyShares(ownPubkeyFresh, { threshold: 2, participants: 3, directoryNodeStubs: stubs });
+            thresholdSigner = new FrostThresholdSigner({ threshold: 2, participants: 3, directoryNodeStubs: stubs }, ownPubkeyFresh);
+            primaryPubkey = bootstrapResult.primaryPubkey;
+        }
+    }
+    else {
+        // Fallback: in-process stubs (no directory reachable)
+        const stubs = createInProcessStubs(3);
+        const ownPubkeyFresh = await kp.getPublicKey();
+        const bootstrapResult = await bootstrapKeyShares(ownPubkeyFresh, { threshold: 2, participants: 3, directoryNodeStubs: stubs });
+        thresholdSigner = new FrostThresholdSigner({ threshold: 2, participants: 3, directoryNodeStubs: stubs }, ownPubkeyFresh);
+        primaryPubkey = bootstrapResult.primaryPubkey;
+    }
+}
+// Late-bound server reference — set after createMcpServer returns.
+// The closure captures the box; notifications fired before server is assigned are dropped.
+let mcpServer;
+// Create single client
+const client = createClient(node, kp, {
+    thresholdSigner,
+    directoryEndpoint,
+    onMessageQueued: (senderHex) => {
+        if (mcpServer)
+            void pushChannelNotification(mcpServer, senderHex);
+    },
+});
+if (primaryPubkey) {
+    client.setPrimaryPubkey(primaryPubkey);
+}
+// Create server with single identity.
+// PERSIST-017: checkpointStatusProvider is not available in the cello-mcp binary
+// (the client binary has no access to the directory's MmrStore). The provider is
+// wired in directory-facing deployments via the server.ts composition root.
+// Passing undefined is a safe fallback — the tools return M1 stub responses.
+// PERSIST-022: clientBackupInstance passed so cello_backup/cello_restore are registered
+// inside createMcpSessionServer (single canonical registration path).
+const server = createMcpSessionServer(node, client, kp, { clientBackup: clientBackupInstance });
+mcpServer = server;
+// Connect stdio transport and register handler
+await server.connect(new StdioServerTransport());
+await client.registerHandler();
+//# sourceMappingURL=cello-mcp.js.map

package/dist/bin/cello-mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cello-mcp.js","sourceRoot":"","sources":["../../src/bin/cello-mcp.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,17 @@
+/**
+ * CELLO adapter runtime configuration.
+ *
+ * AC-003 (REPOSPLIT-002): CELLO_DIRECTORY_URL defaults to the production directory
+ * ALB endpoint. No CELLO_RELAY_MULTIADDR constant exists — relay multiaddr is
+ * dynamically assigned per-session by the directory.
+ */
+/** Production directory HTTPS endpoint (ALB / Route53). */
+export declare const PRODUCTION_DIRECTORY_URL = "https://directory-us1.cello.mygentic.ai";
+/**
+ * Resolve the directory URL from the environment, falling back to the
+ * production endpoint when CELLO_DIRECTORY_URL is not set.
+ *
+ * @param env - process.env or a test substitute
+ */
+export declare function resolveDirectoryUrl(env?: Record<string, string | undefined>): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,2DAA2D;AAC3D,eAAO,MAAM,wBAAwB,4CAA4C,CAAC;AAElF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,MAAM,CAEjG"}

package/dist/config.js

@@ -0,0 +1,19 @@
+/**
+ * CELLO adapter runtime configuration.
+ *
+ * AC-003 (REPOSPLIT-002): CELLO_DIRECTORY_URL defaults to the production directory
+ * ALB endpoint. No CELLO_RELAY_MULTIADDR constant exists — relay multiaddr is
+ * dynamically assigned per-session by the directory.
+ */
+/** Production directory HTTPS endpoint (ALB / Route53). */
+export const PRODUCTION_DIRECTORY_URL = "https://directory-us1.cello.mygentic.ai";
+/**
+ * Resolve the directory URL from the environment, falling back to the
+ * production endpoint when CELLO_DIRECTORY_URL is not set.
+ *
+ * @param env - process.env or a test substitute
+ */
+export function resolveDirectoryUrl(env = process.env) {
+    return env["CELLO_DIRECTORY_URL"] ?? PRODUCTION_DIRECTORY_URL;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,2DAA2D;AAC3D,MAAM,CAAC,MAAM,wBAAwB,GAAG,yCAAyC,CAAC;AAElF;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAA0C,OAAO,CAAC,GAAG;IACvF,OAAO,GAAG,CAAC,qBAAqB,CAAC,IAAI,wBAAwB,CAAC;AAChE,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,4 @@
-export {};
+export { createMcpServer } from "./server.js";
+export { pushChannelNotification, pushSessionRequestNotification } from "./notifications.js";
+export { resolveDirectoryUrl, PRODUCTION_DIRECTORY_URL } from "./config.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,3 +1,4 @@
-export {};
-// placeholder — code moves here during REPOSPLIT-002
+export { createMcpServer } from "./server.js";
+export { pushChannelNotification, pushSessionRequestNotification } from "./notifications.js";
+export { resolveDirectoryUrl, PRODUCTION_DIRECTORY_URL } from "./config.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,qDAAqD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,8BAA8B,EAAE,MAAM,oBAAoB,CAAC;AAC7F,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC"}

package/dist/notifications.d.ts

@@ -0,0 +1,15 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Push a claude/channel wake-up notification to the connected Claude Code session.
+ * Content is never included — the agent calls cello_receive to retrieve the message.
+ * SI-001 (ADAPTER-001): notification payload contains only type and sender pubkey.
+ */
+export declare function pushChannelNotification(server: McpServer, from: string): Promise<void>;
+/**
+ * Push a cello_session_request claude/channel notification to the connected Claude Code session.
+ * Carries only counterparty pubkey and session_id — no content, no multiaddrs, no trust data.
+ * SI-001 (ADAPTER-002): notification payload contains exactly type, from, and session_id.
+ * The agent calls cello_await_session to retrieve the full session details.
+ */
+export declare function pushSessionRequestNotification(server: McpServer, from: string, sessionId: string): Promise<void>;
+//# sourceMappingURL=notifications.d.ts.map

package/dist/notifications.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../src/notifications.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS5F;AAED;;;;;GAKG;AACH,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/notifications.js

@@ -0,0 +1,34 @@
+/**
+ * Push a claude/channel wake-up notification to the connected Claude Code session.
+ * Content is never included — the agent calls cello_receive to retrieve the message.
+ * SI-001 (ADAPTER-001): notification payload contains only type and sender pubkey.
+ */
+export async function pushChannelNotification(server, from) {
+    try {
+        await server.server.notification({
+            method: "notifications/claude/channel",
+            params: { type: "cello_message", from },
+        });
+    }
+    catch {
+        // Transport may not be connected or may have closed — silently swallow
+    }
+}
+/**
+ * Push a cello_session_request claude/channel notification to the connected Claude Code session.
+ * Carries only counterparty pubkey and session_id — no content, no multiaddrs, no trust data.
+ * SI-001 (ADAPTER-002): notification payload contains exactly type, from, and session_id.
+ * The agent calls cello_await_session to retrieve the full session details.
+ */
+export async function pushSessionRequestNotification(server, from, sessionId) {
+    try {
+        await server.server.notification({
+            method: "notifications/claude/channel",
+            params: { type: "cello_session_request", from, session_id: sessionId },
+        });
+    }
+    catch {
+        // Transport may not be connected or may have closed — silently swallow
+    }
+}
+//# sourceMappingURL=notifications.js.map

package/dist/notifications.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.js","sourceRoot":"","sources":["../src/notifications.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,MAAiB,EAAE,IAAY;IAC3E,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;YAC/B,MAAM,EAAE,8BAA8B;YACtC,MAAM,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE;SACxC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;IACzE,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,MAAiB,EACjB,IAAY,EACZ,SAAiB;IAEjB,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;YAC/B,MAAM,EAAE,8BAA8B;YACtC,MAAM,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE;SACvE,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;IACzE,CAAC;AACH,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,94 @@
+/**
+ * CELLO Adapter — server.ts (ADAPTER-002 / M1)
+ *
+ * createMcpServer(node, client, keyProvider): McpServer
+ *   Registers the M1 tool set against a CelloClient.
+ *   Transport-agnostic: identical tool names, schemas, and wiring under
+ *   InMemoryTransport (tests) and stdio (production). AC-007.
+ *
+ * PSEUDOCODE (Phase P — ADAPTER-002):
+ *
+ * State held by the MCP server instance:
+ *   sessionEventQueue: Array<InboundSessionEvent>  FIFO; populated by onSessionAssignment handler
+ *   sessionEventResolvers: Array<(event: InboundSessionEvent) => void>  blocked cello_await_session waiters
+ *   startedAt: number = Date.now()
+ *
+ * Session event enqueue (onSessionAssignment handler):
+ *   Receives: SessionAssignmentEvent { sessionIdHex, counterpartyPubkeyHex, genesisPrevRootHex }
+ *   (from CelloClient.onSessionAssignment per CELLO-MCP-002; fields are pre-encoded as hex)
+ *   1. Push cello_session_request notification via claude/channel (SI-001: only type, from, session_id)
+ *   2. If sessionEventResolvers.length > 0:
+ *      - shift the first resolver and call it with the event (wake up blocked cello_await_session)
+ *   3. Else:
+ *      - Push event to sessionEventQueue
+ *
+ * tool: cello_initiate_session({ target_pubkey: string })
+ *   Delegates to CelloClient.initiateSession (added by MCP-002).
+ *   Returns { ok: true, session_id: hex } or { ok: false, reason: string }.
+ *   Stubbed if method not present on client.
+ *
+ * tool: cello_await_session({ timeout_ms: number })
+ *   1. If sessionEventQueue.length > 0:
+ *      - shift first event
+ *      - return { type: 'new_session', session_id, counterparty_pubkey, genesis_prev_root }
+ *   2. Else: block until event arrives or timeout expires:
+ *      - Create a Promise that resolves when an event arrives or deadline fires
+ *      - Push a resolver into sessionEventResolvers
+ *      - Race: event arrival vs setTimeout(timeout_ms)
+ *      - On arrival: return new_session
+ *      - On timeout: remove resolver from array; return { type: 'timeout' }
+ *
+ * tool: cello_send({ session_id: string, content: string })
+ *   1. Guard: transport_not_started
+ *   2. UTF-8 encode content → contentBytes
+ *   3. client.sendMessage(session_id, contentBytes) → SendMessageResult
+ *   4. Map to MCP output:
+ *      ok:true  → { delivered: true }
+ *      ok:false → { delivered: false, reason: result.reason }
+ *
+ * tool: cello_receive_session({ session_id: string, timeout_ms: number })
+ *   1. Guard: transport_not_started
+ *   2. deadline = Date.now() + timeout_ms
+ *   3. Poll every 20ms until deadline:
+ *      a. msg = client.receiveMessage(session_id)
+ *      b. if msg: return formatted message result
+ *      c. await sleep(Math.min(20, remaining))
+ *   4. return { type: 'timeout' }
+ *
+ * tool: cello_close_session({ session_id: string })
+ *   client.closeSession(session_id)
+ *   return { closed: true }
+ *
+ * tool: cello_list_sessions()
+ *   return client.listSessions() mapped to wire shape
+ *
+ * tool: cello_get_sealed_receipt({ session_id: string })
+ *   Stubbed in M1: return { available: false, reason: 'not_yet_sealed' }
+ *   (SESSION-003 implements real seals)
+ *
+ * tool: cello_get_inclusion_proof({ session_id: string, content_hash: string })
+ *   Stubbed in M1: return { available: false, reason: 'not_yet_sealed' }
+ *
+ * tool: cello_status()
+ *   1. ownPubkey = Buffer.from(await keyProvider.getPublicKey()).toString('hex')
+ *   2. sessions = client.listSessions()
+ *   3. return {
+ *        transport_started: transportStarted(),
+ *        own_pubkey: ownPubkey,
+ *        listen_addresses: node.listenAddresses(),
+ *        connected_peer_count: node.getConnections().length,
+ *        uptime_seconds: Math.floor((Date.now() - startedAt) / 1000),
+ *        active_session_count: sessions.filter(s => s.status === 'active').length,
+ *        directory_reachable: false  // M1 stub — directory reachability check deferred
+ *      }
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { CelloClient, ClientBackup } from "@cello-protocol/client";
+import type { CelloNode } from "@cello-protocol/transport";
+import type { KeyProvider } from "@cello-protocol/crypto";
+import type { CheckpointStatusProvider } from "@cello-protocol/interfaces";
+export declare function createMcpServer(node: CelloNode, client: CelloClient, keyProvider: KeyProvider, opts?: {
+    checkpointStatusProvider?: CheckpointStatusProvider;
+    clientBackup?: ClientBackup;
+}): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,WAAW,EAA0B,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAChG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAoB3E,wBAAgB,eAAe,CAC7B,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,WAAW,EACxB,IAAI,CAAC,EAAE;IAAE,wBAAwB,CAAC,EAAE,wBAAwB,CAAC;IAAC,YAAY,CAAC,EAAE,YAAY,CAAA;CAAE,GAC1F,SAAS,CA0cX"}

package/dist/server.js

@@ -0,0 +1,483 @@
+/**
+ * CELLO Adapter — server.ts (ADAPTER-002 / M1)
+ *
+ * createMcpServer(node, client, keyProvider): McpServer
+ *   Registers the M1 tool set against a CelloClient.
+ *   Transport-agnostic: identical tool names, schemas, and wiring under
+ *   InMemoryTransport (tests) and stdio (production). AC-007.
+ *
+ * PSEUDOCODE (Phase P — ADAPTER-002):
+ *
+ * State held by the MCP server instance:
+ *   sessionEventQueue: Array<InboundSessionEvent>  FIFO; populated by onSessionAssignment handler
+ *   sessionEventResolvers: Array<(event: InboundSessionEvent) => void>  blocked cello_await_session waiters
+ *   startedAt: number = Date.now()
+ *
+ * Session event enqueue (onSessionAssignment handler):
+ *   Receives: SessionAssignmentEvent { sessionIdHex, counterpartyPubkeyHex, genesisPrevRootHex }
+ *   (from CelloClient.onSessionAssignment per CELLO-MCP-002; fields are pre-encoded as hex)
+ *   1. Push cello_session_request notification via claude/channel (SI-001: only type, from, session_id)
+ *   2. If sessionEventResolvers.length > 0:
+ *      - shift the first resolver and call it with the event (wake up blocked cello_await_session)
+ *   3. Else:
+ *      - Push event to sessionEventQueue
+ *
+ * tool: cello_initiate_session({ target_pubkey: string })
+ *   Delegates to CelloClient.initiateSession (added by MCP-002).
+ *   Returns { ok: true, session_id: hex } or { ok: false, reason: string }.
+ *   Stubbed if method not present on client.
+ *
+ * tool: cello_await_session({ timeout_ms: number })
+ *   1. If sessionEventQueue.length > 0:
+ *      - shift first event
+ *      - return { type: 'new_session', session_id, counterparty_pubkey, genesis_prev_root }
+ *   2. Else: block until event arrives or timeout expires:
+ *      - Create a Promise that resolves when an event arrives or deadline fires
+ *      - Push a resolver into sessionEventResolvers
+ *      - Race: event arrival vs setTimeout(timeout_ms)
+ *      - On arrival: return new_session
+ *      - On timeout: remove resolver from array; return { type: 'timeout' }
+ *
+ * tool: cello_send({ session_id: string, content: string })
+ *   1. Guard: transport_not_started
+ *   2. UTF-8 encode content → contentBytes
+ *   3. client.sendMessage(session_id, contentBytes) → SendMessageResult
+ *   4. Map to MCP output:
+ *      ok:true  → { delivered: true }
+ *      ok:false → { delivered: false, reason: result.reason }
+ *
+ * tool: cello_receive_session({ session_id: string, timeout_ms: number })
+ *   1. Guard: transport_not_started
+ *   2. deadline = Date.now() + timeout_ms
+ *   3. Poll every 20ms until deadline:
+ *      a. msg = client.receiveMessage(session_id)
+ *      b. if msg: return formatted message result
+ *      c. await sleep(Math.min(20, remaining))
+ *   4. return { type: 'timeout' }
+ *
+ * tool: cello_close_session({ session_id: string })
+ *   client.closeSession(session_id)
+ *   return { closed: true }
+ *
+ * tool: cello_list_sessions()
+ *   return client.listSessions() mapped to wire shape
+ *
+ * tool: cello_get_sealed_receipt({ session_id: string })
+ *   Stubbed in M1: return { available: false, reason: 'not_yet_sealed' }
+ *   (SESSION-003 implements real seals)
+ *
+ * tool: cello_get_inclusion_proof({ session_id: string, content_hash: string })
+ *   Stubbed in M1: return { available: false, reason: 'not_yet_sealed' }
+ *
+ * tool: cello_status()
+ *   1. ownPubkey = Buffer.from(await keyProvider.getPublicKey()).toString('hex')
+ *   2. sessions = client.listSessions()
+ *   3. return {
+ *        transport_started: transportStarted(),
+ *        own_pubkey: ownPubkey,
+ *        listen_addresses: node.listenAddresses(),
+ *        connected_peer_count: node.getConnections().length,
+ *        uptime_seconds: Math.floor((Date.now() - startedAt) / 1000),
+ *        active_session_count: sessions.filter(s => s.status === 'active').length,
+ *        directory_reachable: false  // M1 stub — directory reachability check deferred
+ *      }
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { pushSessionRequestNotification } from "./notifications.js";
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function jsonText(value) {
+    return { content: [{ type: "text", text: JSON.stringify(value) }] };
+}
+const TRANSPORT_NOT_STARTED = jsonText({ error: { reason: "transport_not_started" } });
+const CLIENT_NOT_INITIALIZED = jsonText({ error: { reason: "client_not_initialized" } });
+// ─── createMcpServer ─────────────────────────────────────────────────────────
+export function createMcpServer(node, client, keyProvider, opts) {
+    const checkpointStatusProvider = opts?.checkpointStatusProvider;
+    const clientBackup = opts?.clientBackup;
+    const startedAt = Date.now();
+    // ─── Session event queue ─────────────────────────────────────────────────
+    const sessionEventQueue = [];
+    const sessionEventResolvers = [];
+    function transportStarted() {
+        return node.listenAddresses().length > 0;
+    }
+    const server = new McpServer({ name: "cello", version: "0.1.0" }, { capabilities: { experimental: { "claude/channel": {} } } });
+    // ─── Register onSessionAssignment handler ───────────────────────────────
+    if (client != null && typeof client.onSessionAssignment === "function") {
+        client.onSessionAssignment((event) => {
+            void pushSessionRequestNotification(server, event.counterpartyPubkeyHex, event.sessionIdHex);
+            if (sessionEventResolvers.length > 0) {
+                const resolve = sessionEventResolvers.shift();
+                resolve(event);
+            }
+            else {
+                sessionEventQueue.push(event);
+            }
+        });
+    }
+    // ── cello_initiate_session ────────────────────────────────────────────────
+    server.registerTool("cello_initiate_session", {
+        description: "Initiate a CELLO session with a target agent identified by their public key.",
+        inputSchema: {
+            target_pubkey: z.string().describe("Target agent public key hex (K_local pubkey of the peer)"),
+        },
+    }, async ({ target_pubkey }) => {
+        if (!transportStarted())
+            return TRANSPORT_NOT_STARTED;
+        const result = await client.initiateSession(target_pubkey);
+        if (result.ok) {
+            return jsonText({
+                ok: true,
+                session_id: Buffer.from(result.sessionId).toString("hex"),
+                genesis_prev_root: Buffer.from(result.genesisPrevRoot).toString("hex"),
+            });
+        }
+        return jsonText({ ok: false, reason: result.reason });
+    });
+    // ── cello_await_session ───────────────────────────────────────────────────
+    server.registerTool("cello_await_session", {
+        description: "Wait for an inbound session request. Returns immediately if one is already queued, or blocks until one arrives or the timeout expires.",
+        inputSchema: {
+            timeout_ms: z.number().int().min(0).describe("Maximum wait time in milliseconds"),
+        },
+    }, async ({ timeout_ms }) => {
+        // If a queued event exists, return it immediately (FIFO)
+        if (sessionEventQueue.length > 0) {
+            const event = sessionEventQueue.shift();
+            return jsonText({
+                type: "new_session",
+                session_id: event.sessionIdHex,
+                counterparty_pubkey: event.counterpartyPubkeyHex,
+                genesis_prev_root: event.genesisPrevRootHex,
+            });
+        }
+        // Block until an event arrives or timeout fires
+        const result = await new Promise((resolve) => {
+            let timerId;
+            function resolveEvent(event) {
+                clearTimeout(timerId);
+                resolve(event);
+            }
+            sessionEventResolvers.push(resolveEvent);
+            timerId = setTimeout(() => {
+                const idx = sessionEventResolvers.indexOf(resolveEvent);
+                if (idx !== -1)
+                    sessionEventResolvers.splice(idx, 1);
+                resolve(null);
+            }, timeout_ms);
+        });
+        if (result === null) {
+            return jsonText({ type: "timeout" });
+        }
+        return jsonText({
+            type: "new_session",
+            session_id: result.sessionIdHex,
+            counterparty_pubkey: result.counterpartyPubkeyHex,
+            genesis_prev_root: result.genesisPrevRootHex,
+        });
+    });
+    // ── cello_send (session-keyed, M1) ────────────────────────────────────────
+    server.registerTool("cello_send", {
+        description: "Send a UTF-8 message on an active CELLO session.",
+        inputSchema: {
+            session_id: z.string().describe("Session ID hex (from cello_initiate_session or cello_await_session)"),
+            content: z.string().describe("UTF-8 message content"),
+        },
+    }, async ({ session_id, content }) => {
+        if (client == null)
+            return CLIENT_NOT_INITIALIZED;
+        if (!transportStarted())
+            return TRANSPORT_NOT_STARTED;
+        const contentBytes = new TextEncoder().encode(content);
+        const result = await client.sendMessage(session_id, contentBytes);
+        if (result.ok) {
+            return jsonText({ delivered: true });
+        }
+        return jsonText({ delivered: false, reason: result.reason });
+    });
+    // ── cello_receive_session (session-keyed, M1) ────────────────────────────
+    server.registerTool("cello_receive_session", {
+        description: "Wait for a message on a specific CELLO session (session-locked). Blocks until a message arrives or the timeout expires.",
+        inputSchema: {
+            session_id: z
+                .string()
+                .describe("Session ID hex (from cello_initiate_session or cello_await_session)"),
+            timeout_ms: z.number().int().min(0).describe("Maximum wait time in milliseconds"),
+        },
+    }, async ({ session_id, timeout_ms }) => {
+        if (client == null)
+            return CLIENT_NOT_INITIALIZED;
+        if (!transportStarted())
+            return TRANSPORT_NOT_STARTED;
+        const deadline = Date.now() + timeout_ms;
+        while (Date.now() < deadline) {
+            const msg = client.receiveMessage(session_id);
+            if (msg) {
+                if (msg.type === "session_sealed") {
+                    return jsonText({
+                        type: "session_sealed",
+                        session_id: msg.sessionIdHex,
+                        sealed_root: Buffer.from(msg.sealedRoot).toString("hex"),
+                        close_timestamp: msg.closeTimestamp,
+                        checkpoint_status: msg.checkpointStatus,
+                    });
+                }
+                return jsonText(formatSessionMessage(msg, session_id));
+            }
+            const remaining = deadline - Date.now();
+            if (remaining <= 0)
+                break;
+            await sleep(Math.min(20, remaining));
+        }
+        return jsonText({ type: "timeout" });
+    });
+    // ── cello_receive (any-session, default) ──────────────────────────────────
+    server.registerTool("cello_receive", {
+        description: "Wait for a message from any active CELLO session (default receive). Returns session_id so caller knows which session the message came from. Blocks until a message arrives or the timeout expires.",
+        inputSchema: {
+            timeout_ms: z.number().int().min(0).describe("Maximum wait time in milliseconds"),
+        },
+    }, async ({ timeout_ms }) => {
+        if (client == null)
+            return CLIENT_NOT_INITIALIZED;
+        if (!transportStarted())
+            return TRANSPORT_NOT_STARTED;
+        const result = await client.receiveMessageAsync(timeout_ms);
+        if (result.type === "timeout") {
+            return jsonText({ type: "timeout" });
+        }
+        if (result.type === "session_sealed") {
+            return jsonText({
+                type: "session_sealed",
+                session_id: result.sessionIdHex,
+                sealed_root: Buffer.from(result.sealedRoot).toString("hex"),
+                close_timestamp: result.closeTimestamp,
+                checkpoint_status: result.checkpointStatus,
+                ...(result.otherSessionsPending && result.otherSessionsPending.length > 0
+                    ? { other_sessions_pending: result.otherSessionsPending }
+                    : {}),
+            });
+        }
+        if (result.type === "message") {
+            let content;
+            try {
+                content = new TextDecoder("utf-8", { fatal: true }).decode(result.content);
+            }
+            catch {
+                content = Buffer.from(result.content).toString("hex");
+            }
+            return jsonText({
+                type: "message",
+                session_id: result.sessionIdHex,
+                content,
+                sender_pubkey: Buffer.from(result.senderPubkey).toString("hex"),
+                sequence_number: result.sequenceNumber,
+                leaf_hash: Buffer.from(result.leafHash).toString("hex"),
+                ...(result.otherSessionsPending && result.otherSessionsPending.length > 0
+                    ? { other_sessions_pending: result.otherSessionsPending }
+                    : {}),
+            });
+        }
+        return jsonText({ type: "unknown", raw: JSON.stringify(result) });
+    });
+    // ── cello_close_session ───────────────────────────────────────────────────
+    server.registerTool("cello_close_session", {
+        description: "Close and remove a CELLO session. Idempotent.",
+        inputSchema: {
+            session_id: z.string().describe("Session ID hex to close"),
+        },
+    }, async ({ session_id }) => {
+        if (client == null)
+            return CLIENT_NOT_INITIALIZED;
+        client.closeSession(session_id);
+        // PERSIST-017: include checkpoint_status if CheckpointStatusProvider is wired in.
+        // When not provided (M1 stubs, tests without DB), return closed: true only.
+        if (checkpointStatusProvider) {
+            const stagingStatus = await checkpointStatusProvider.getSealStagingStatus(session_id);
+            if (stagingStatus.status === "pending") {
+                return jsonText({ closed: true, checkpoint_status: "pending", staged_at: stagingStatus.staged_at });
+            }
+            if (stagingStatus.status === "confirmed") {
+                return jsonText({
+                    closed: true,
+                    checkpoint_status: "confirmed",
+                    session_mmr_peak: stagingStatus.checkpoint_peak_hash,
+                    leaf_index: stagingStatus.leaf_index,
+                });
+            }
+        }
+        return jsonText({ closed: true });
+    });
+    // ── cello_list_sessions ───────────────────────────────────────────────────
+    server.registerTool("cello_list_sessions", {
+        description: "List all current CELLO sessions and their status.",
+        inputSchema: {},
+    }, async () => {
+        if (client == null)
+            return CLIENT_NOT_INITIALIZED;
+        const sessions = client.listSessions().map((s) => ({
+            session_id: Buffer.from(s.session_id).toString("hex"),
+            counterparty_pubkey: Buffer.from(s.counterparty_pubkey).toString("hex"),
+            status: s.status,
+        }));
+        return jsonText(sessions);
+    });
+    // ── cello_get_sealed_receipt ──────────────────────────────────────────────
+    // PERSIST-017: returns checkpoint_status when CheckpointStatusProvider is wired.
+    // Falls back to the M1 stub response when no provider is configured.
+    server.registerTool("cello_get_sealed_receipt", {
+        description: "Retrieve the sealed receipt and MMR checkpoint status for a closed session.",
+        inputSchema: {
+            session_id: z.string().describe("Session ID hex"),
+        },
+    }, async ({ session_id }) => {
+        if (checkpointStatusProvider) {
+            const stagingStatus = await checkpointStatusProvider.getSealStagingStatus(session_id);
+            if (stagingStatus.status === "pending") {
+                return jsonText({
+                    available: true,
+                    checkpoint_status: "pending",
+                    staged_at: stagingStatus.staged_at,
+                    attestation_self: "PENDING",
+                    attestation_self_reason: "MMR checkpoint not yet written",
+                });
+            }
+            if (stagingStatus.status === "confirmed") {
+                return jsonText({
+                    available: true,
+                    checkpoint_status: "confirmed",
+                    session_mmr_peak: stagingStatus.checkpoint_peak_hash,
+                    leaf_index: stagingStatus.leaf_index,
+                    checkpoint_id: stagingStatus.checkpoint_id,
+                });
+            }
+            // not_staged: session was never sealed
+            return jsonText({ available: false, reason: "not_yet_sealed" });
+        }
+        return jsonText({ available: false, reason: "not_yet_sealed" });
+    });
+    // ── cello_get_inclusion_proof ─────────────────────────────────────────────
+    // PERSIST-017: returns pending/confirmed status when CheckpointStatusProvider is wired.
+    // Falls back to the M1 stub response when no provider is configured.
+    server.registerTool("cello_get_inclusion_proof", {
+        description: "Retrieve the MMR inclusion proof status for a sealed session.",
+        inputSchema: {
+            session_id: z.string().describe("Session ID hex"),
+            content_hash: z.string().describe("Content hash hex of the message"),
+        },
+    }, async ({ session_id }) => {
+        if (checkpointStatusProvider) {
+            const stagingStatus = await checkpointStatusProvider.getSealStagingStatus(session_id);
+            if (stagingStatus.status === "pending") {
+                return jsonText({
+                    status: "pending",
+                    staged_at: stagingStatus.staged_at,
+                    message: "sealed_root staged; inclusion proof available after next MMR checkpoint",
+                });
+            }
+            if (stagingStatus.status === "confirmed") {
+                return jsonText({
+                    status: "confirmed",
+                    leaf_index: stagingStatus.leaf_index,
+                    checkpoint_peak_hash: stagingStatus.checkpoint_peak_hash,
+                    checkpoint_id: stagingStatus.checkpoint_id,
+                    sibling_hashes: stagingStatus.sibling_hashes,
+                });
+            }
+            // not_staged: session was never sealed — error distinguishes from 'pending'
+            return jsonText({ status: "error", reason: "not_yet_sealed" });
+        }
+        return jsonText({ available: false, reason: "not_yet_sealed" });
+    });
+    // ── cello_status (extended with M1 fields) ────────────────────────────────
+    server.registerTool("cello_status", {
+        description: "Return transport status, own pubkey, connection info, and M1 session summary.",
+        inputSchema: {},
+    }, async () => {
+        const ownPubkey = Buffer.from(await keyProvider.getPublicKey()).toString("hex");
+        const sessions = client.listSessions();
+        const activeSessionCount = sessions.filter((s) => s.status === "active").length;
+        // directoryReachable check: any session with a directory_endpoint indicates reachability
+        const directoryReachable = sessions.some((s) => s.directory_endpoint && s.directory_endpoint.peer_id !== "");
+        return jsonText({
+            transport_started: transportStarted(),
+            own_pubkey: ownPubkey,
+            listen_addresses: node.listenAddresses(),
+            connected_peer_count: node.getConnections().length,
+            uptime_seconds: Math.floor((Date.now() - startedAt) / 1000),
+            active_session_count: activeSessionCount,
+            directory_reachable: directoryReachable,
+        });
+    });
+    // ── cello_backup ─────────────────────────────────────────────────────────────
+    // PERSIST-022: Trigger an immediate encrypted backup of the local database.
+    // If no backup is configured (cloudStorage=null), ClientBackup logs
+    // client.backup.not.configured at WARN and returns without error.
+    server.registerTool("cello_backup", {
+        description: "Trigger an immediate encrypted backup of the local CELLO database to cloud storage. " +
+            "Returns ok:true on success. Returns ok:false with reason if backup fails or is not configured.",
+        inputSchema: {},
+    }, async () => {
+        if (!clientBackup) {
+            return jsonText({ ok: false, reason: "not_configured" });
+        }
+        try {
+            const result = await clientBackup.backup();
+            return jsonText(result);
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            return jsonText({ ok: false, reason });
+        }
+    });
+    // ── cello_restore ─────────────────────────────────────────────────────────────
+    // PERSIST-022: Download and decrypt the backup, replacing the local database file.
+    // On checksum mismatch or decrypt failure the local file is NOT overwritten and restore throws.
+    server.registerTool("cello_restore", {
+        description: "Restore the local CELLO database from the most recent cloud backup. " +
+            "Replaces the local database file only after checksum verification passes. " +
+            "Returns ok:true on success. If cloud storage is not configured, returns ok:false.",
+        inputSchema: {},
+    }, async () => {
+        if (!clientBackup) {
+            return jsonText({ ok: false, reason: "not_configured" });
+        }
+        try {
+            await clientBackup.restore();
+            return jsonText({ ok: true });
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            return jsonText({ ok: false, reason });
+        }
+    });
+    return server;
+}
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+function formatSessionMessage(msg, sessionIdHex) {
+    try {
+        const content = new TextDecoder("utf-8", { fatal: true }).decode(msg.content);
+        return {
+            type: "message",
+            content,
+            session_id: sessionIdHex,
+            sender_pubkey: Buffer.from(msg.senderPubkey).toString("hex"),
+            sequence_number: msg.sequenceNumber,
+            leaf_hash: Buffer.from(msg.leafHash).toString("hex"),
+        };
+    }
+    catch {
+        return {
+            type: "decode_error",
+            session_id: sessionIdHex,
+            sender_pubkey: Buffer.from(msg.senderPubkey).toString("hex"),
+            sequence_number: msg.sequenceNumber,
+            leaf_hash: Buffer.from(msg.leafHash).toString("hex"),
+        };
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cello-protocol/connect",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "private": false,
   "type": "module",
   "engines": {
@@ -11,6 +11,9 @@
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "bin": {
+    "cello-mcp": "./dist/bin/cello-mcp.js"
+  },
   "exports": {
     ".": {
       "import": "./dist/index.js",
@@ -23,12 +26,19 @@
     "SKILL.md"
   ],
   "dependencies": {
-    "@cello-protocol/client": "0.0.1",
-    "@cello-protocol/transport": "0.0.1",
-    "@cello-protocol/crypto": "0.0.1"
+    "@cello-protocol/interfaces": "0.0.3",
+    "@libp2p/peer-id": "^6.0.8",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.2",
+    "@cello-protocol/client": "0.0.3",
+    "@cello-protocol/crypto": "0.0.3",
+    "@cello-protocol/transport": "0.0.3"
   },
   "devDependencies": {
-    "@types/node": "^25.6.2"
+    "@claude-flow/testing": "3.0.0-alpha.6",
+    "@types/node": "^25.6.2",
+    "cbor-x": "^1.6.0",
+    "it-length-prefixed": "^10.0.1"
   },
   "scripts": {
     "typecheck": "tsc --build",