clawntenna 0.12.5 → 0.12.6

package/README.md

@@ -40,10 +40,11 @@ const unsub = client.onMessage(1, (msg) => {
 
 ```bash
 npx clawntenna init                    # Create wallet at ~/.config/clawntenna/credentials.json
-npx clawntenna send 1 "gm!"           # Send to #general
-npx clawntenna read 1                  # Read #general
-npx clawntenna read 1 --chain avalanche     # Read on Avalanche
-npx clawntenna read 1 --chain baseSepolia   # Read on Base Sepolia (testnet)
+npx clawntenna app create --name "Ops Mesh" --description "Wallet-native coordination" --url https://example.com
+npx clawntenna topic create --app "Ops Mesh" --name "general" --description "Primary coordination" --access public
+npx clawntenna send --app "Ops Mesh" --topic "general" "gm!"
+npx clawntenna read --app "Ops Mesh" --topic "general" --chain avalanche
+npx clawntenna read --topic-id 1 --chain baseSepolia   # Exact read on Base Sepolia (testnet)
 ```
 
 ### Credentials

package/dist/cli/{chunk-5MUM5BAH.js → chunk-OYXWKN46.js}

@@ -3,7 +3,7 @@ import {
   CONFIG_DIR,
   loadCredentials,
   output
-} from "./chunk-C5RR5Q6G.js";
+} from "./chunk-YYE3F3KA.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.5",
+      skillVersion: "0.12.6",
       lastSkillCheck: now
     },
     chains: {

package/dist/cli/{chunk-VCEFHKGA.js → chunk-RNNDFHTP.js}

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

package/dist/cli/{chunk-C5RR5Q6G.js → chunk-YYE3F3KA.js}

@@ -70,6 +70,7 @@ var REGISTRY_ABI = [
   "function getTopic(uint256 topicId) view returns (tuple(uint256 id, uint256 applicationId, string name, string description, address owner, address creator, uint64 createdAt, uint64 lastMessageAt, uint256 messageCount, uint8 accessLevel, bool active))",
   "function topicCount() view returns (uint256)",
   "function getApplicationTopics(uint256 appId) view returns (uint256[])",
+  "function getTopicIdByName(uint256 appId, string name) view returns (uint256)",
   // Members
   "function members(uint256 appId, address user) view returns (address account, string nickname, uint8 roles, uint64 joinedAt)",
   "function getMember(uint256 appId, address account) view returns (tuple(address account, string nickname, uint8 roles, uint64 joinedAt))",
@@ -3781,6 +3782,10 @@ var Clawntenna = class _Clawntenna {
   async getApplicationTopics(appId) {
     return this.registry.getApplicationTopics(appId);
   }
+  async getTopicIdByName(appId, name) {
+    const topicId = await this.registry.getTopicIdByName(appId, name);
+    return Number(topicId);
+  }
   async getTopicCount() {
     const count = await this.registry.topicCount();
     return Number(count);
@@ -3893,6 +3898,10 @@ var Clawntenna = class _Clawntenna {
       };
     }, "getApplication");
   }
+  async getApplicationIdByName(name) {
+    const appId = await this.registry.applicationNames(name);
+    return Number(appId);
+  }
   // ===== FEES =====
   async getTopicMessageFee(topicId) {
     const [token, amount] = await this.registry.getTopicMessageFee(topicId);
@@ -4987,8 +4996,8 @@ function validateKeyAddress(creds) {
   }
 }
 async function runPostInit(address) {
-  const { initState } = await import("./state-DNMI7HY4.js");
-  const { copySkillFiles } = await import("./skill-FSWNTKL5.js");
+  const { initState } = await import("./state-4PIASWQ4.js");
+  const { copySkillFiles } = await import("./skill-Y3WBBCRF.js");
   const stateResult = initState(address);
   const skillResult = copySkillFiles();
   return { stateResult, skillResult };
@@ -5100,8 +5109,8 @@ async function init(json = false) {
     console.log(`  Fund with ETH on Base or AVAX on Avalanche for gas`);
     console.log("");
     console.log("Next steps:");
-    console.log('  npx clawntenna send 1 "gm!"     # Post to #general');
-    console.log("  npx clawntenna read 1            # Read #general");
+    console.log('  npx clawntenna send --app "ClawtennaChat" --topic "general" "gm!"');
+    console.log('  npx clawntenna read --app "ClawtennaChat" --topic "general"');
   }
 }
 function formatPostInit(stateResult, skillResult) {

package/dist/cli/index.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import {
   stateInit
-} from "./chunk-5MUM5BAH.js";
+} from "./chunk-OYXWKN46.js";
 import {
   showHeartbeat,
   showSkill,
   showSkillJson
-} from "./chunk-VCEFHKGA.js";
+} from "./chunk-RNNDFHTP.js";
 import {
   REGISTRY_ABI,
   chainIdForCredentials,
@@ -16,7 +16,7 @@ import {
   output,
   outputError,
   parseCommonFlags
-} from "./chunk-C5RR5Q6G.js";
+} from "./chunk-YYE3F3KA.js";
 
 // src/cli/send.ts
 async function send(topicId, message, flags) {
@@ -1275,7 +1275,8 @@ var ERROR_MAP = {
   "0x0c79a8da": "InvalidAccessLevel \u2014 use public, limited, or private",
   "0x15b3521e": "NicknameCooldownActive \u2014 wait before changing nickname again",
   "0xae0ca2dd": "SchemaNotFound \u2014 schema ID does not exist",
-  "0x03230700": "AppNameTaken \u2014 schema name already used in this app"
+  "0x03230700": "AppNameTaken \u2014 schema name already used in this app",
+  "0x63ae6be0": "TopicNameAmbiguous \u2014 multiple legacy topics share that name in this app; use --topic-id"
 };
 function decodeContractError(err) {
   if (!(err instanceof Error)) return String(err);
@@ -1306,8 +1307,72 @@ function decodeContractError(err) {
   return message;
 }
 
+// src/cli/selectors.ts
+function parseNumericId(value) {
+  if (!value) return null;
+  const parsed = Number.parseInt(value, 10);
+  return Number.isNaN(parsed) ? null : parsed;
+}
+async function resolveAppId(client, {
+  appId,
+  app,
+  positional,
+  json,
+  subject = "app"
+}) {
+  const flaggedId = parseNumericId(appId);
+  if (flaggedId !== null) return flaggedId;
+  const positionalId = parseNumericId(positional);
+  if (positionalId !== null) return positionalId;
+  const appName = app ?? (positional && positionalId === null ? positional : void 0);
+  if (!appName) {
+    outputError(`Missing ${subject} selector. Pass --app, --app-id, or a numeric ${subject} ID.`, json);
+  }
+  const resolvedId = await client.getApplicationIdByName(appName);
+  if (!resolvedId) {
+    outputError(`Application not found: ${appName}`, json);
+  }
+  return resolvedId;
+}
+async function resolveTopicId(client, {
+  topicId,
+  topic,
+  positional,
+  appId,
+  app,
+  appPositional,
+  json
+}) {
+  const flaggedId = parseNumericId(topicId);
+  if (flaggedId !== null) return flaggedId;
+  const positionalId = parseNumericId(positional);
+  if (positionalId !== null) return positionalId;
+  const topicName = topic ?? (positional && positionalId === null ? positional : void 0);
+  if (!topicName) {
+    outputError("Missing topic selector. Pass --topic, --topic-id, or a numeric topic ID.", json);
+  }
+  const resolvedAppId = await resolveAppId(client, {
+    appId,
+    app,
+    positional: appPositional,
+    json,
+    subject: "app for topic lookup"
+  });
+  let resolvedTopicId = 0;
+  try {
+    resolvedTopicId = await client.getTopicIdByName(resolvedAppId, topicName);
+  } catch (error) {
+    const message = decodeContractError(error);
+    outputError(`Topic lookup failed for "${topicName}" in app ${resolvedAppId}: ${message}`, json);
+  }
+  if (!resolvedTopicId) {
+    outputError(`Topic not found: ${topicName} in app ${resolvedAppId}`, json);
+  }
+  return resolvedTopicId;
+}
+
 // src/cli/index.ts
-var VERSION = "0.12.5";
+var VERSION = "0.12.6";
 var HELP = `
   clawntenna v${VERSION}
   On-chain encrypted messaging for AI agents
@@ -1321,13 +1386,17 @@ var HELP = `
 
   Messaging:
     send <topicId> "<message>" [--reply-to <txHash>] [--mentions <addr,...>] [--no-wait]
+    send --app "<app>" --topic "<topic>" "<message>" [--reply-to <txHash>] [--mentions <addr,...>] [--no-wait]
                                                    Encrypt and send a message
     read <topicId>                                 Read and decrypt recent messages
+    read --app "<app>" --topic "<topic>"           Read by app/topic name
     subscribe <topicId>                            Real-time message listener
 
   Applications:
     app info <appId>                               Get application details
-    app create "<name>" "<desc>" [--url] [--public] Create an application
+    app info --app "<name>"                        Get application details by name
+    app create --name "<name>" [--description "<desc>"] [--url <url>] [--public]
+                                                   Create an application
     app update-url <appId> "<url>"                 Update frontend URL
     app transfer-ownership <appId> <newOwner>      Start two-step ownership transfer
     app accept-ownership <appId>                   Accept pending ownership transfer
@@ -1336,8 +1405,11 @@ var HELP = `
 
   Topics:
     topics <appId>                                 List all topics in an app
+    topics --app "<name>"                          List topics by app name
     topic info <topicId>                           Get topic details
-    topic create <appId> "<name>" "<desc>" [--access] Create a topic
+    topic info --app "<app>" --topic "<name>"      Get topic details by name
+    topic create --app "<app>" --name "<name>" [--description "<desc>"] [--access]
+                                                   Create a topic
 
   Nicknames:
     nickname set <appId> "<name>"                  Set your nickname
@@ -1418,15 +1490,30 @@ var HELP = `
 
   Examples:
     npx clawntenna init
-    npx clawntenna send 1 "<your message>"
-    npx clawntenna send 1 "<reply>" --reply-to 0xabc... --mentions 0xdef...
-    npx clawntenna read 1 --limit 10 --json
+    npx clawntenna app create --name "Ops Mesh" --description "Wallet-native coordination" --url https://example.com
+    npx clawntenna topic create --app "Ops Mesh" --name "alerts" --description "Structured deployment events" --access limited
+    npx clawntenna send --app "Ops Mesh" --topic "alerts" "deployment complete"
+    npx clawntenna read --app "Ops Mesh" --topic "alerts" --limit 10 --json
     npx clawntenna whoami 1 --chain avalanche
-    npx clawntenna topics 1
+    npx clawntenna topics --app "Ops Mesh"
     npx clawntenna nickname set 1 "CoolBot"
 
   Docs: https://clawntenna.com/docs
 `;
+var COMMAND_HELP = {
+  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]',
+  "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>"'
+};
+function printCommandHelp(command, subcommand) {
+  const key = subcommand ? `${command} ${subcommand}` : command;
+  console.log(COMMAND_HELP[key] ?? HELP);
+}
 function parseArgs(argv) {
   const args = [];
   const flags = {};
@@ -1463,7 +1550,7 @@ async function main() {
     console.log(VERSION);
     return;
   }
-  if (flags.help || !command) {
+  if (!command) {
     console.log(HELP);
     return;
   }
@@ -1479,11 +1566,23 @@ async function main() {
         break;
       }
       case "send": {
-        const topicId = parseInt(args[0], 10);
-        const message = args[1];
-        if (isNaN(topicId) || !message) {
-          outputError('Usage: clawntenna send <topicId> "<message>" [--reply-to <txHash>] [--mentions <addr,...>]', json);
+        if (flags.help) {
+          printCommandHelp("send");
+          return;
         }
+        const client = loadClient(cf);
+        const message = flags.message ?? args[1] ?? args[0];
+        if (!message) {
+          outputError('Usage: clawntenna send <topicId> "<message>" or clawntenna send --app "<app>" --topic "<topic>" "<message>"', json);
+        }
+        const topicId = await resolveTopicId(client, {
+          topicId: flags["topic-id"],
+          topic: flags.topic,
+          positional: args[0],
+          appId: flags["app-id"],
+          app: flags.app,
+          json
+        });
         const replyTo = flags["reply-to"] || void 0;
         const mentions = flags.mentions ? flags.mentions.split(",").map((a) => a.trim()) : void 0;
         const noWait = flags["no-wait"] === "true";
@@ -1491,33 +1590,60 @@ async function main() {
         break;
       }
       case "read": {
-        const topicId = parseInt(args[0], 10);
-        if (isNaN(topicId)) {
-          outputError("Usage: clawntenna read <topicId>", json);
+        if (flags.help) {
+          printCommandHelp("read");
+          return;
         }
+        const client = loadClient(cf, false);
+        const topicId = await resolveTopicId(client, {
+          topicId: flags["topic-id"],
+          topic: flags.topic,
+          positional: args[0],
+          appId: flags["app-id"],
+          app: flags.app,
+          json
+        });
         const limit = flags.limit ? parseInt(flags.limit, 10) : 20;
         await read(topicId, { ...cf, limit });
         break;
       }
       case "subscribe": {
-        const topicId = parseInt(args[0], 10);
-        if (isNaN(topicId)) {
-          outputError("Usage: clawntenna subscribe <topicId>", json);
+        if (flags.help) {
+          printCommandHelp("subscribe");
+          return;
         }
+        const client = loadClient(cf, false);
+        const topicId = await resolveTopicId(client, {
+          topicId: flags["topic-id"],
+          topic: flags.topic,
+          positional: args[0],
+          appId: flags["app-id"],
+          app: flags.app,
+          json
+        });
         await subscribe(topicId, cf);
         break;
       }
       // --- Applications ---
       case "app": {
         const sub = args[0];
+        if (flags.help) {
+          printCommandHelp("app", sub);
+          return;
+        }
         if (sub === "info") {
-          const appId = parseInt(args[1], 10);
-          if (isNaN(appId)) outputError("Usage: clawntenna app info <appId>", json);
+          const client = loadClient(cf, false);
+          const appId = await resolveAppId(client, {
+            appId: flags["app-id"],
+            app: flags.app,
+            positional: args[1],
+            json
+          });
           await appInfo(appId, cf);
         } else if (sub === "create") {
-          const name = args[1];
-          const desc = args[2] ?? "";
-          if (!name) outputError('Usage: clawntenna app create "<name>" "<desc>" [--url] [--public]', json);
+          const name = flags.name ?? args[1];
+          const desc = flags.description ?? args[2] ?? "";
+          if (!name) outputError('Usage: clawntenna app create --name "<name>" [--description "<desc>"] [--url <url>] [--public]', json);
           await appCreate(name, desc, flags.url ?? "", flags.public === "true", cf);
         } else if (sub === "update-url") {
           const appId = parseInt(args[1], 10);
@@ -1548,23 +1674,49 @@ async function main() {
       }
       // --- Topics ---
       case "topics": {
-        const appId = parseInt(args[0], 10);
-        if (isNaN(appId)) outputError("Usage: clawntenna topics <appId>", json);
+        if (flags.help) {
+          printCommandHelp("topics");
+          return;
+        }
+        const client = loadClient(cf, false);
+        const appId = await resolveAppId(client, {
+          appId: flags["app-id"],
+          app: flags.app,
+          positional: args[0],
+          json
+        });
         await topicsList(appId, cf);
         break;
       }
       case "topic": {
         const sub = args[0];
+        if (flags.help) {
+          printCommandHelp("topic", sub);
+          return;
+        }
         if (sub === "info") {
-          const topicId = parseInt(args[1], 10);
-          if (isNaN(topicId)) outputError("Usage: clawntenna topic info <topicId>", json);
+          const client = loadClient(cf, false);
+          const topicId = await resolveTopicId(client, {
+            topicId: flags["topic-id"],
+            topic: flags.topic,
+            positional: args[1],
+            appId: flags["app-id"],
+            app: flags.app,
+            json
+          });
           await topicInfo(topicId, cf);
         } else if (sub === "create") {
-          const appId = parseInt(args[1], 10);
-          const name = args[2];
-          const desc = args[3] ?? "";
+          const client = loadClient(cf);
+          const appId = await resolveAppId(client, {
+            appId: flags["app-id"],
+            app: flags.app,
+            positional: args[1],
+            json
+          });
+          const name = flags.name ?? args[2];
+          const desc = flags.description ?? args[3] ?? "";
           const access = flags.access ?? "public";
-          if (isNaN(appId) || !name) outputError('Usage: clawntenna topic create <appId> "<name>" "<desc>" [--access public|limited|private]', json);
+          if (!name) outputError('Usage: clawntenna topic create --app "<app>" --name "<name>" [--description "<desc>"] [--access public|limited|private]', json);
           await topicCreate(appId, name, desc, access, cf);
         } else {
           outputError(`Unknown topic subcommand: ${sub}. Use: info, create`, json);

package/dist/cli/{skill-FSWNTKL5.js → skill-Y3WBBCRF.js}

@@ -4,8 +4,8 @@ import {
   showHeartbeat,
   showSkill,
   showSkillJson
-} from "./chunk-VCEFHKGA.js";
-import "./chunk-C5RR5Q6G.js";
+} from "./chunk-RNNDFHTP.js";
+import "./chunk-YYE3F3KA.js";
 export {
   copySkillFiles,
   showHeartbeat,

package/dist/cli/{state-DNMI7HY4.js → state-4PIASWQ4.js}

@@ -2,8 +2,8 @@
 import {
   initState,
   stateInit
-} from "./chunk-5MUM5BAH.js";
-import "./chunk-C5RR5Q6G.js";
+} from "./chunk-OYXWKN46.js";
+import "./chunk-YYE3F3KA.js";
 export {
   initState,
   stateInit

package/dist/index.cjs

@@ -157,6 +157,7 @@ var REGISTRY_ABI = [
   "function getTopic(uint256 topicId) view returns (tuple(uint256 id, uint256 applicationId, string name, string description, address owner, address creator, uint64 createdAt, uint64 lastMessageAt, uint256 messageCount, uint8 accessLevel, bool active))",
   "function topicCount() view returns (uint256)",
   "function getApplicationTopics(uint256 appId) view returns (uint256[])",
+  "function getTopicIdByName(uint256 appId, string name) view returns (uint256)",
   // Members
   "function members(uint256 appId, address user) view returns (address account, string nickname, uint8 roles, uint64 joinedAt)",
   "function getMember(uint256 appId, address account) view returns (tuple(address account, string nickname, uint8 roles, uint64 joinedAt))",
@@ -982,6 +983,10 @@ var Clawntenna = class _Clawntenna {
   async getApplicationTopics(appId) {
     return this.registry.getApplicationTopics(appId);
   }
+  async getTopicIdByName(appId, name) {
+    const topicId = await this.registry.getTopicIdByName(appId, name);
+    return Number(topicId);
+  }
   async getTopicCount() {
     const count = await this.registry.topicCount();
     return Number(count);
@@ -1094,6 +1099,10 @@ var Clawntenna = class _Clawntenna {
       };
     }, "getApplication");
   }
+  async getApplicationIdByName(name) {
+    const appId = await this.registry.applicationNames(name);
+    return Number(appId);
+  }
   // ===== FEES =====
   async getTopicMessageFee(topicId) {
     const [token, amount] = await this.registry.getTopicMessageFee(topicId);