clawntenna 0.12.8 → 0.12.9

package/dist/cli/{chunk-AIISNOCB.js → chunk-EOKSFPRZ.js}

@@ -3,7 +3,7 @@ import {
   CONFIG_DIR,
   loadCredentials,
   output
-} from "./chunk-AQHFWEZF.js";
+} from "./chunk-S2IWR2YO.js";
 
 // src/cli/state.ts
 import { existsSync, mkdirSync, writeFileSync } from "fs";
@@ -21,7 +21,7 @@ function initState(address) {
       startedAt: now,
       lastScanAt: now,
       mode: "active",
-      skillVersion: "0.12.8",
+      skillVersion: "0.12.9",
       lastSkillCheck: now
     },
     chains: {

package/dist/cli/{chunk-AK26RTP5.js → chunk-FDS4E5ME.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   CONFIG_DIR
-} from "./chunk-AQHFWEZF.js";
+} from "./chunk-S2IWR2YO.js";
 
 // src/cli/skill.ts
 import { readFileSync, existsSync, copyFileSync, mkdirSync } from "fs";

package/dist/cli/{chunk-AQHFWEZF.js → chunk-S2IWR2YO.js}

@@ -4462,10 +4462,6 @@ var Clawntenna = class _Clawntenna {
   async registerPublicKey() {
     this.requireSigner();
     if (!this.ecdhPublicKey) throw new Error("ECDH key not derived yet");
-    const hasKey = await this.keyManager.hasPublicKey(this.requireAddress());
-    if (hasKey) {
-      throw new Error("Public key already registered on-chain");
-    }
     return this.keyManager.registerPublicKey(this.ecdhPublicKey);
   }
   /**
@@ -5006,8 +5002,8 @@ function validateKeyAddress(creds) {
   }
 }
 async function runPostInit(address) {
-  const { initState } = await import("./state-73B57RGU.js");
-  const { copySkillFiles } = await import("./skill-HV2NNR3H.js");
+  const { initState } = await import("./state-IT53LF3J.js");
+  const { copySkillFiles } = await import("./skill-CTQZ7YJE.js");
   const stateResult = initState(address);
   const skillResult = copySkillFiles();
   return { stateResult, skillResult };
@@ -5160,7 +5156,8 @@ function parseCommonFlags(flags) {
     chain: flags.chain ?? "base",
     key: flags.key,
     rpc: flags.rpc,
-    json: flags.json === "true"
+    json: flags.json === "true",
+    force: flags.force === "true"
   };
 }
 function loadClient(flags, requireWallet = true) {

package/dist/cli/index.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import {
   stateInit
-} from "./chunk-AIISNOCB.js";
+} from "./chunk-EOKSFPRZ.js";
 import {
   showHeartbeat,
   showSkill,
   showSkillJson
-} from "./chunk-AK26RTP5.js";
+} from "./chunk-FDS4E5ME.js";
 import {
   REGISTRY_ABI,
   chainIdForCredentials,
@@ -17,7 +17,7 @@ import {
   outputError,
   parseCommonFlags,
   saveCredentials
-} from "./chunk-AQHFWEZF.js";
+} from "./chunk-S2IWR2YO.js";
 
 // src/cli/send.ts
 async function send(topicId, message, flags) {
@@ -792,6 +792,13 @@ async function keysRegister(flags) {
   const creds = loadCredentials();
   const chainId = chainIdForCredentials(flags.chain);
   const ecdhCreds = creds?.chains[chainId]?.ecdh;
+  const hadExistingRegistration = await client.hasPublicKey(client.address);
+  if (hadExistingRegistration && !flags.force) {
+    outputError(
+      "ECDH public key already registered on-chain. Re-run with --force to update it. Warning: existing private-topic key grants encrypted to the old public key may need to be regranted.",
+      json
+    );
+  }
   if (ecdhCreds?.privateKey) {
     client.loadECDHKeypair(ecdhCreds.privateKey);
   } else {
@@ -799,21 +806,11 @@ async function keysRegister(flags) {
     await client.deriveECDHFromWallet();
   }
   if (!json) console.log("Registering ECDH public key on-chain...");
-  let txHash = null;
-  let blockNumber;
-  let registeredOnChain = false;
-  try {
-    const tx = await client.registerPublicKey();
-    const receipt = await tx.wait();
-    txHash = tx.hash;
-    blockNumber = receipt?.blockNumber;
-    registeredOnChain = true;
-  } catch (error) {
-    if (!(error instanceof Error) || !error.message.includes("Public key already registered on-chain")) {
-      throw error;
-    }
-    registeredOnChain = true;
-  }
+  const tx = await client.registerPublicKey();
+  const receipt = await tx.wait();
+  const txHash = tx.hash;
+  const blockNumber = receipt?.blockNumber;
+  const registeredOnChain = true;
   const keypair = client.getECDHKeypairHex();
   if (creds && keypair) {
     if (!creds.chains[chainId]) {
@@ -831,13 +828,19 @@ async function keysRegister(flags) {
     saveCredentials(creds);
   }
   if (json) {
-    output({ txHash, blockNumber, chain: flags.chain, registered: registeredOnChain }, true);
+    output({
+      txHash,
+      blockNumber,
+      chain: flags.chain,
+      registered: registeredOnChain,
+      updated: hadExistingRegistration
+    }, true);
   } else {
-    if (txHash) {
-      console.log(`TX: ${txHash}`);
-      console.log(`Confirmed in block ${blockNumber}`);
-    } else {
-      console.log("ECDH public key was already registered on-chain.");
+    console.log(`TX: ${txHash}`);
+    console.log(`Confirmed in block ${blockNumber}`);
+    if (hadExistingRegistration) {
+      console.log("ECDH public key updated on-chain.");
+      console.log("Note: existing private-topic key grants encrypted to the old public key may need to be regranted.");
     }
   }
 }
@@ -1411,7 +1414,7 @@ async function resolveTopicId(client, {
 }
 
 // src/cli/index.ts
-var VERSION = "0.12.8";
+var VERSION = "0.12.9";
 var HELP = `
   clawntenna v${VERSION}
   Encrypted on-chain coordination for wallets, apps, and agents
@@ -1483,7 +1486,7 @@ var HELP = `
     schema publish <schemaId> "<body>"             Publish new schema version
 
   ECDH / Private Topics:
-    keys register                                  Register ECDH public key on-chain
+    keys register [--force]                        Register ECDH public key on-chain
     keys check <address>                           Check if address has public key
     keys grant <topicId> <address>                 Grant key access to user
     keys revoke <topicId> <address>                Revoke key access
@@ -1540,14 +1543,68 @@ var HELP = `
   Docs: https://clawntenna.com/docs
 `;
 var COMMAND_HELP = {
+  init: "Usage: clawntenna init\n       Creates wallet credentials, state, and synced skill files.",
+  whoami: "Usage: clawntenna whoami [appId]\nOptions: --chain <name> --json\n       Shows wallet, balance, nickname/member/agent info, and ECDH status.",
   send: 'Usage: clawntenna send <topicId> "<message>"\n       clawntenna send --app "<app>" --topic "<topic>" "<message>"\nOptions: --reply-to <txHash> --mentions <addr,...> --no-wait --json --chain <name>',
   read: 'Usage: clawntenna read <topicId>\n       clawntenna read --app "<app>" --topic "<topic>"\nOptions: --limit <N> --json --chain <name>',
   subscribe: 'Usage: clawntenna subscribe <topicId>\n       clawntenna subscribe --app "<app>" --topic "<topic>"\nOptions: --json --chain <name>',
   "app info": 'Usage: clawntenna app info <appId>\n       clawntenna app info --app "<name>"',
   "app create": 'Usage: clawntenna app create --name "<name>" [--description "<desc>"] [--url <url>] [--public]\n       clawntenna app create "<name>" "<desc>" [--url <url>] [--public]',
+  "app update-url": 'Usage: clawntenna app update-url <appId> "<url>"',
+  "app transfer-ownership": "Usage: clawntenna app transfer-ownership <appId> <newOwner>",
+  "app accept-ownership": "Usage: clawntenna app accept-ownership <appId>",
+  "app cancel-transfer": "Usage: clawntenna app cancel-transfer <appId>",
+  "app pending-owner": "Usage: clawntenna app pending-owner <appId>",
   "topic info": 'Usage: clawntenna topic info <topicId>\n       clawntenna topic info --app "<app>" --topic "<name>"',
   "topic create": 'Usage: clawntenna topic create --app "<app>" --name "<name>" [--description "<desc>"] [--access public|limited|private]\n       clawntenna topic create <appId> "<name>" "<desc>" [--access public|limited|private]',
-  topics: 'Usage: clawntenna topics <appId>\n       clawntenna topics --app "<name>"'
+  "nickname set": 'Usage: clawntenna nickname set <appId> "<name>"',
+  "nickname get": "Usage: clawntenna nickname get <appId> <address>",
+  "nickname clear": "Usage: clawntenna nickname clear <appId>",
+  members: "Usage: clawntenna members <appId>",
+  "member info": "Usage: clawntenna member info <appId> <address>",
+  "member add": 'Usage: clawntenna member add <appId> <address> "<nick>" [--roles N]',
+  "member remove": "Usage: clawntenna member remove <appId> <address>",
+  "member roles": "Usage: clawntenna member roles <appId> <address> <roles>",
+  "permission set": "Usage: clawntenna permission set <topicId> <address> <level>",
+  "permission get": "Usage: clawntenna permission get <topicId> <address>",
+  "access check": "Usage: clawntenna access check <topicId> <address>",
+  "agent register": "Usage: clawntenna agent register <appId> <tokenId>",
+  "agent clear": "Usage: clawntenna agent clear <appId>",
+  "agent info": "Usage: clawntenna agent info <appId> <address>",
+  "schema create": 'Usage: clawntenna schema create <appId> "<name>" "<desc>" "<body>"',
+  "schema info": "Usage: clawntenna schema info <schemaId>",
+  "schema list": "Usage: clawntenna schema list <appId>",
+  "schema bind": "Usage: clawntenna schema bind <topicId> <schemaId> <version>",
+  "schema unbind": "Usage: clawntenna schema unbind <topicId>",
+  "schema topic": "Usage: clawntenna schema topic <topicId>",
+  "schema version": "Usage: clawntenna schema version <schemaId> <version>",
+  "schema publish": 'Usage: clawntenna schema publish <schemaId> "<body>"',
+  "keys register": "Usage: clawntenna keys register [--force]\n       Registers your ECDH public key. Use --force to overwrite an existing on-chain key.",
+  "keys check": "Usage: clawntenna keys check <address>",
+  "keys grant": "Usage: clawntenna keys grant <topicId> <address>",
+  "keys revoke": "Usage: clawntenna keys revoke <topicId> <address>",
+  "keys rotate": "Usage: clawntenna keys rotate <topicId>",
+  "keys has": "Usage: clawntenna keys has <topicId> <address>",
+  "keys pending": "Usage: clawntenna keys pending <topicId>",
+  topics: 'Usage: clawntenna topics <appId>\n       clawntenna topics --app "<name>"',
+  "fee topic-creation": "Usage: clawntenna fee topic-creation set <appId> <token> <amount>",
+  "fee message": "Usage: clawntenna fee message set <topicId> <token> <amount>\n       clawntenna fee message get <topicId>",
+  "escrow inbox": "Usage: clawntenna escrow inbox <topicId>",
+  "escrow enable": "Usage: clawntenna escrow enable <topicId> <timeout>",
+  "escrow disable": "Usage: clawntenna escrow disable <topicId>",
+  "escrow status": "Usage: clawntenna escrow status <topicId>",
+  "escrow deposits": "Usage: clawntenna escrow deposits <topicId>",
+  "escrow deposit": "Usage: clawntenna escrow deposit <depositId>",
+  "escrow respond": "Usage: clawntenna escrow respond <topicId> <id1> [id2...] --payload 0x...",
+  "escrow release": "Usage: clawntenna escrow release <depositId> [--ref N]",
+  "escrow release-batch": "Usage: clawntenna escrow release-batch <id1> <id2> ...",
+  "escrow refund": "Usage: clawntenna escrow refund <depositId>",
+  "escrow refund-batch": "Usage: clawntenna escrow refund-batch <id1> <id2> ...",
+  "escrow stats": "Usage: clawntenna escrow stats <address>",
+  skill: "Usage: clawntenna skill\n       Prints skill.md.",
+  heartbeat: "Usage: clawntenna heartbeat\n       Prints heartbeat.md.",
+  "skill-json": "Usage: clawntenna skill-json\n       Prints skill.json.",
+  "state init": "Usage: clawntenna state init\n       Initializes ~/.config/clawntenna/state.json."
 };
 function printCommandHelp(command, subcommand) {
   const key = subcommand ? `${command} ${subcommand}` : command;
@@ -1569,7 +1626,7 @@ function parseArgs(argv) {
         flags[key] = "true";
         i++;
       }
-    } else if (arg === "-h") {
+    } else if (arg === "-h" || arg === "help") {
       flags["help"] = "true";
       i++;
     } else if (arg === "-v") {
@@ -1585,6 +1642,15 @@ function parseArgs(argv) {
 async function main() {
   const { command, args, flags } = parseArgs(process.argv.slice(2));
   const json = flags.json === "true";
+  if (command === "help") {
+    if (args.length === 0) {
+      console.log(HELP);
+      return;
+    }
+    const subcommand = args[1];
+    printCommandHelp(args[0], subcommand);
+    return;
+  }
   if (flags.version) {
     console.log(VERSION);
     return;
@@ -1597,9 +1663,17 @@ async function main() {
   try {
     switch (command) {
       case "init":
+        if (flags.help) {
+          printCommandHelp("init");
+          return;
+        }
         await init(json);
         break;
       case "whoami": {
+        if (flags.help) {
+          printCommandHelp("whoami");
+          return;
+        }
         const appId = args[0] ? parseInt(args[0], 10) : null;
         await whoami(appId, cf);
         break;
@@ -1765,6 +1839,10 @@ async function main() {
       // --- Nicknames ---
       case "nickname": {
         const sub = args[0];
+        if (flags.help) {
+          printCommandHelp("nickname", sub);
+          return;
+        }
         if (sub === "set") {
           const appId = parseInt(args[1], 10);
           const name = args[2];
@@ -1786,6 +1864,10 @@ async function main() {
       }
       // --- Members ---
       case "members": {
+        if (flags.help) {
+          printCommandHelp("members");
+          return;
+        }
         const appId = parseInt(args[0], 10);
         if (isNaN(appId)) outputError("Usage: clawntenna members <appId>", json);
         await membersList(appId, cf);
@@ -1793,6 +1875,10 @@ async function main() {
       }
       case "member": {
         const sub = args[0];
+        if (flags.help) {
+          printCommandHelp("member", sub);
+          return;
+        }
         if (sub === "info") {
           const appId = parseInt(args[1], 10);
           const address = args[2];
@@ -1824,6 +1910,10 @@ async function main() {
       // --- Permissions ---
       case "permission": {
         const sub = args[0];
+        if (flags.help) {
+          printCommandHelp("permission", sub);
+          return;
+        }
         if (sub === "set") {
           const topicId = parseInt(args[1], 10);
           const address = args[2];
@@ -1842,6 +1932,10 @@ async function main() {
       }
       case "access": {
         const sub = args[0];
+        if (flags.help) {
+          printCommandHelp("access", sub);
+          return;
+        }
         if (sub === "check") {
           const topicId = parseInt(args[1], 10);
           const address = args[2];
@@ -1855,6 +1949,10 @@ async function main() {
       // --- Agent Identity ---
       case "agent": {
         const sub = args[0];
+        if (flags.help) {
+          printCommandHelp("agent", sub);
+          return;
+        }
         if (sub === "register") {
           const appId = parseInt(args[1], 10);
           const tokenId = parseInt(args[2], 10);
@@ -1877,6 +1975,10 @@ async function main() {
       // --- Schemas ---
       case "schema": {
         const sub = args[0];
+        if (flags.help) {
+          printCommandHelp("schema", sub);
+          return;
+        }
         if (sub === "create") {
           const appId = parseInt(args[1], 10);
           const name = args[2];
@@ -1924,6 +2026,10 @@ async function main() {
       // --- ECDH Keys ---
       case "keys": {
         const sub = args[0];
+        if (flags.help) {
+          printCommandHelp("keys", sub);
+          return;
+        }
         if (sub === "register") {
           await keysRegister(cf);
         } else if (sub === "check") {
@@ -1961,6 +2067,10 @@ async function main() {
       // --- Fees ---
       case "fee": {
         const sub = args[0];
+        if (flags.help) {
+          printCommandHelp("fee", sub);
+          return;
+        }
         if (sub === "topic-creation") {
           if (args[1] === "set") {
             const appId = parseInt(args[2], 10);
@@ -1993,6 +2103,10 @@ async function main() {
       // --- Escrow ---
       case "escrow": {
         const sub = args[0];
+        if (flags.help) {
+          printCommandHelp("escrow", sub);
+          return;
+        }
         if (sub === "inbox") {
           const topicId = parseInt(args[1], 10);
           if (isNaN(topicId)) outputError("Usage: clawntenna escrow inbox <topicId>", json);
@@ -2053,17 +2167,33 @@ async function main() {
       }
       // --- Skill Files ---
       case "skill":
+        if (flags.help) {
+          printCommandHelp("skill");
+          return;
+        }
         showSkill(json);
         break;
       case "heartbeat":
+        if (flags.help) {
+          printCommandHelp("heartbeat");
+          return;
+        }
         showHeartbeat(json);
         break;
       case "skill-json":
+        if (flags.help) {
+          printCommandHelp("skill-json");
+          return;
+        }
         showSkillJson();
         break;
       // --- State ---
       case "state": {
         const sub = args[0];
+        if (flags.help) {
+          printCommandHelp("state", sub);
+          return;
+        }
         if (sub === "init") {
           stateInit(json);
         } else {

package/dist/cli/{skill-HV2NNR3H.js → skill-CTQZ7YJE.js}

@@ -4,8 +4,8 @@ import {
   showHeartbeat,
   showSkill,
   showSkillJson
-} from "./chunk-AK26RTP5.js";
-import "./chunk-AQHFWEZF.js";
+} from "./chunk-FDS4E5ME.js";
+import "./chunk-S2IWR2YO.js";
 export {
   copySkillFiles,
   showHeartbeat,

package/dist/cli/{state-73B57RGU.js → state-IT53LF3J.js}

@@ -2,8 +2,8 @@
 import {
   initState,
   stateInit
-} from "./chunk-AIISNOCB.js";
-import "./chunk-AQHFWEZF.js";
+} from "./chunk-EOKSFPRZ.js";
+import "./chunk-S2IWR2YO.js";
 export {
   initState,
   stateInit

package/dist/index.cjs

@@ -1663,10 +1663,6 @@ var Clawntenna = class _Clawntenna {
   async registerPublicKey() {
     this.requireSigner();
     if (!this.ecdhPublicKey) throw new Error("ECDH key not derived yet");
-    const hasKey = await this.keyManager.hasPublicKey(this.requireAddress());
-    if (hasKey) {
-      throw new Error("Public key already registered on-chain");
-    }
     return this.keyManager.registerPublicKey(this.ecdhPublicKey);
   }
   /**