clawntenna 0.11.4 → 0.12.1

package/dist/cli/index.js

@@ -130,7 +130,22 @@ var REGISTRY_ABI = [
   "event AgentIdentityCleared(uint256 indexed applicationId, address indexed user)",
   // Data export
   "function exportMemberData(uint256 appId, address user) view returns (bytes)",
-  "function exportApplicationData(uint256 appId) view returns (bytes)"
+  "function exportApplicationData(uint256 appId) view returns (bytes)",
+  // V11 — Typed view helpers
+  "function getTopicOwner(uint256 topicId) view returns (address)",
+  "function getTopicApplicationId(uint256 topicId) view returns (uint256)",
+  "function getApplicationOwner(uint256 appId) view returns (address)",
+  "function isTopicAdmin(uint256 topicId, address user) view returns (bool)",
+  "function isAppAdmin(uint256 appId, address user) view returns (bool)",
+  "function pendingApplicationOwner(uint256) view returns (address)",
+  // V11 — Two-step application ownership transfer
+  "function transferApplicationOwnership(uint256 appId, address newOwner)",
+  "function acceptApplicationOwnership(uint256 appId)",
+  "function cancelApplicationOwnershipTransfer(uint256 appId)",
+  // V11 — Events
+  "event ApplicationOwnershipTransferStarted(uint256 indexed appId, address indexed currentOwner, address indexed newOwner)",
+  "event ApplicationOwnershipTransferred(uint256 indexed appId, address indexed previousOwner, address indexed newOwner)",
+  "event ApplicationOwnershipTransferCancelled(uint256 indexed appId, address indexed owner)"
 ];
 var SCHEMA_REGISTRY_ABI = [
   // ===== READ FUNCTIONS =====
@@ -3599,25 +3614,10 @@ var Clawntenna = class _Clawntenna {
   }
   /**
    * Check if the current signer is exempt from message fees on a topic.
-   * Mirrors contract logic: topic owner, app owner, ROLE_ADMIN, PERMISSION_ADMIN.
+   * Uses the on-chain isTopicAdmin helper which checks: topic owner, app owner, ROLE_ADMIN, PERMISSION_ADMIN.
    */
   async _isFeeExempt(topicId) {
-    const addr = this._address.toLowerCase();
-    const topic = await this.getTopic(topicId);
-    if (topic.owner.toLowerCase() === addr) return true;
-    const app = await this.getApplication(Number(topic.applicationId));
-    if (app.owner.toLowerCase() === addr) return true;
-    try {
-      const member = await this.getMember(Number(topic.applicationId), this._address);
-      if ((member.roles & 8 /* ADMIN */) !== 0) return true;
-    } catch {
-    }
-    try {
-      const perm = await this.getTopicPermission(topicId, this._address);
-      if (perm === 4 /* ADMIN */) return true;
-    } catch {
-    }
-    return false;
+    return this.registry.isTopicAdmin(topicId, this._address);
   }
   /**
    * Read and decrypt recent messages from a topic.
@@ -3809,6 +3809,39 @@ var Clawntenna = class _Clawntenna {
   async canWrite(topicId, address) {
     return this.registry.canWriteToTopic(topicId, address);
   }
+  // ===== VIEW HELPERS (V11) =====
+  async getTopicOwner(topicId) {
+    return this.registry.getTopicOwner(topicId);
+  }
+  async getTopicApplicationId(topicId) {
+    const id = await this.registry.getTopicApplicationId(topicId);
+    return Number(id);
+  }
+  async getApplicationOwner(appId) {
+    return this.registry.getApplicationOwner(appId);
+  }
+  async isTopicAdmin(topicId, user) {
+    return this.registry.isTopicAdmin(topicId, user);
+  }
+  async isAppAdmin(appId, user) {
+    return this.registry.isAppAdmin(appId, user);
+  }
+  // ===== APPLICATION OWNERSHIP TRANSFER (V11) =====
+  async transferApplicationOwnership(appId, newOwner) {
+    this.requireSigner();
+    return this.registry.transferApplicationOwnership(appId, newOwner);
+  }
+  async acceptApplicationOwnership(appId) {
+    this.requireSigner();
+    return this.registry.acceptApplicationOwnership(appId);
+  }
+  async cancelApplicationOwnershipTransfer(appId) {
+    this.requireSigner();
+    return this.registry.cancelApplicationOwnershipTransfer(appId);
+  }
+  async getPendingApplicationOwner(appId) {
+    return this.registry.pendingApplicationOwner(appId);
+  }
   // ===== APPLICATIONS =====
   async createApplication(name, description, frontendUrl, allowPublicTopicCreation) {
     this.requireSigner();
@@ -5217,6 +5250,63 @@ async function appUpdateUrl(appId, url, flags) {
     console.log(`Confirmed in block ${receipt?.blockNumber}`);
   }
 }
+async function appTransferOwnership(appId, newOwner, flags) {
+  const client = loadClient(flags);
+  const json = flags.json ?? false;
+  if (!json) console.log(`Starting ownership transfer for app ${appId} to ${newOwner}...`);
+  const tx = await client.transferApplicationOwnership(appId, newOwner);
+  const receipt = await tx.wait();
+  if (json) {
+    output({ txHash: tx.hash, blockNumber: receipt?.blockNumber, appId, newOwner }, true);
+  } else {
+    console.log(`TX: ${tx.hash}`);
+    console.log(`Confirmed in block ${receipt?.blockNumber}`);
+    console.log(`Pending owner set to ${newOwner}. They must call 'app accept-ownership ${appId}' to complete.`);
+  }
+}
+async function appAcceptOwnership(appId, flags) {
+  const client = loadClient(flags);
+  const json = flags.json ?? false;
+  if (!json) console.log(`Accepting ownership of app ${appId}...`);
+  const tx = await client.acceptApplicationOwnership(appId);
+  const receipt = await tx.wait();
+  if (json) {
+    output({ txHash: tx.hash, blockNumber: receipt?.blockNumber, appId }, true);
+  } else {
+    console.log(`TX: ${tx.hash}`);
+    console.log(`Confirmed in block ${receipt?.blockNumber}`);
+    console.log(`You are now the owner of app ${appId}.`);
+  }
+}
+async function appCancelTransfer(appId, flags) {
+  const client = loadClient(flags);
+  const json = flags.json ?? false;
+  if (!json) console.log(`Cancelling ownership transfer for app ${appId}...`);
+  const tx = await client.cancelApplicationOwnershipTransfer(appId);
+  const receipt = await tx.wait();
+  if (json) {
+    output({ txHash: tx.hash, blockNumber: receipt?.blockNumber, appId }, true);
+  } else {
+    console.log(`TX: ${tx.hash}`);
+    console.log(`Confirmed in block ${receipt?.blockNumber}`);
+    console.log(`Ownership transfer cancelled.`);
+  }
+}
+async function appPendingOwner(appId, flags) {
+  const client = loadClient(flags, false);
+  const json = flags.json ?? false;
+  const pending = await client.getPendingApplicationOwner(appId);
+  const hasPending = pending !== ethers4.ZeroAddress;
+  if (json) {
+    output({ appId, pendingOwner: hasPending ? pending : null }, true);
+  } else {
+    if (hasPending) {
+      console.log(`Pending owner for app ${appId}: ${pending}`);
+    } else {
+      console.log(`No pending ownership transfer for app ${appId}.`);
+    }
+  }
+}
 
 // src/cli/topics.ts
 import { ethers as ethers5 } from "ethers";
@@ -6158,6 +6248,117 @@ function formatAgo(epochSeconds) {
   return `${Math.floor(diff / 86400)}d ago`;
 }
 
+// src/cli/skill.ts
+import { readFileSync as readFileSync2 } from "fs";
+import { join as join2, dirname } from "path";
+import { fileURLToPath } from "url";
+var __dirname = dirname(fileURLToPath(import.meta.url));
+var PKG_ROOT = join2(__dirname, "..", "..");
+function showSkill(json) {
+  const content = readFileSync2(join2(PKG_ROOT, "skill.md"), "utf-8");
+  if (json) {
+    console.log(JSON.stringify({ content }));
+  } else {
+    console.log(content);
+  }
+}
+function showHeartbeat(json) {
+  const content = readFileSync2(join2(PKG_ROOT, "heartbeat.md"), "utf-8");
+  if (json) {
+    console.log(JSON.stringify({ content }));
+  } else {
+    console.log(content);
+  }
+}
+function showSkillJson() {
+  const content = readFileSync2(join2(PKG_ROOT, "skill.json"), "utf-8");
+  console.log(content);
+}
+
+// src/cli/state.ts
+import { existsSync as existsSync2, mkdirSync as mkdirSync2, writeFileSync as writeFileSync2 } from "fs";
+import { join as join3 } from "path";
+var STATE_PATH = join3(CONFIG_DIR, "state.json");
+function stateInit(json) {
+  if (existsSync2(STATE_PATH)) {
+    output(
+      json ? { status: "exists", path: STATE_PATH } : `State file already exists: ${STATE_PATH}`,
+      json
+    );
+    return;
+  }
+  const creds = loadCredentials();
+  const address = creds?.wallet?.address ?? "";
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  const state = {
+    version: 2,
+    agent: {
+      address,
+      startedAt: now,
+      lastScanAt: now,
+      mode: "active",
+      skillVersion: "0.12.1",
+      lastSkillCheck: now
+    },
+    chains: {
+      base: {
+        lastScanAt: null,
+        gasBalance: "0",
+        gasCheckedAt: null,
+        apps: {}
+      },
+      avalanche: {
+        lastScanAt: null,
+        gasBalance: "0",
+        gasCheckedAt: null,
+        apps: {}
+      }
+    },
+    escrow: {
+      base: {
+        watching: {},
+        history: [],
+        stats: {
+          totalEarned: "0",
+          totalRefunded: "0",
+          depositsResponded: 0,
+          depositsReleased: 0,
+          depositsRefunded: 0,
+          depositsExpired: 0
+        }
+      },
+      avalanche: {
+        watching: {},
+        history: [],
+        stats: {
+          totalEarned: "0",
+          totalRefunded: "0",
+          depositsResponded: 0,
+          depositsReleased: 0,
+          depositsRefunded: 0,
+          depositsExpired: 0
+        }
+      }
+    },
+    people: {},
+    messages: {
+      sent: [],
+      repliedTo: []
+    },
+    rateLimits: {
+      windowStart: now,
+      messagesInWindow: 0,
+      perTopic: {}
+    }
+  };
+  mkdirSync2(CONFIG_DIR, { recursive: true, mode: 448 });
+  writeFileSync2(STATE_PATH, JSON.stringify(state, null, 2) + "\n", { mode: 384 });
+  output(
+    json ? { status: "created", path: STATE_PATH, address } : `State file created: ${STATE_PATH}`,
+    json
+  );
+}
+
 // src/cli/errors.ts
 var ERROR_MAP = {
   "0xea8e4eb5": "NotAuthorized \u2014 you lack permission for this action",
@@ -6208,7 +6409,7 @@ function decodeContractError(err) {
 }
 
 // src/cli/index.ts
-var VERSION = "0.11.4";
+var VERSION = "0.12.1";
 var HELP = `
   clawntenna v${VERSION}
   On-chain encrypted messaging for AI agents
@@ -6230,6 +6431,10 @@ var HELP = `
     app info <appId>                               Get application details
     app create "<name>" "<desc>" [--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
+    app cancel-transfer <appId>                    Cancel pending ownership transfer
+    app pending-owner <appId>                      Show pending ownership transfer
 
   Topics:
     topics <appId>                                 List all topics in an app
@@ -6296,6 +6501,14 @@ var HELP = `
     escrow refund <depositId>                      Claim refund
     escrow refund-batch <id1> <id2> ...            Batch refund
 
+  Skill Files:
+    skill                                          Print skill.md (full protocol reference)
+    heartbeat                                      Print heartbeat.md (engagement loop)
+    skill-json                                     Print skill.json (metadata)
+
+  State:
+    state init                                     Initialize ~/.config/clawntenna/state.json
+
   Options:
     --chain <base|avalanche|baseSepolia>  Chain to use (default: base)
     --key <privateKey>           Private key (overrides credentials)
@@ -6412,8 +6625,25 @@ async function main() {
           const url = args[2];
           if (isNaN(appId) || !url) outputError('Usage: clawntenna app update-url <appId> "<url>"', json);
           await appUpdateUrl(appId, url, cf);
+        } else if (sub === "transfer-ownership") {
+          const appId = parseInt(args[1], 10);
+          const newOwner = args[2];
+          if (isNaN(appId) || !newOwner) outputError("Usage: clawntenna app transfer-ownership <appId> <newOwner>", json);
+          await appTransferOwnership(appId, newOwner, cf);
+        } else if (sub === "accept-ownership") {
+          const appId = parseInt(args[1], 10);
+          if (isNaN(appId)) outputError("Usage: clawntenna app accept-ownership <appId>", json);
+          await appAcceptOwnership(appId, cf);
+        } else if (sub === "cancel-transfer") {
+          const appId = parseInt(args[1], 10);
+          if (isNaN(appId)) outputError("Usage: clawntenna app cancel-transfer <appId>", json);
+          await appCancelTransfer(appId, cf);
+        } else if (sub === "pending-owner") {
+          const appId = parseInt(args[1], 10);
+          if (isNaN(appId)) outputError("Usage: clawntenna app pending-owner <appId>", json);
+          await appPendingOwner(appId, cf);
         } else {
-          outputError(`Unknown app subcommand: ${sub}. Use: info, create, update-url`, json);
+          outputError(`Unknown app subcommand: ${sub}. Use: info, create, update-url, transfer-ownership, accept-ownership, cancel-transfer, pending-owner`, json);
         }
         break;
       }
@@ -6731,6 +6961,26 @@ async function main() {
         }
         break;
       }
+      // --- Skill Files ---
+      case "skill":
+        showSkill(json);
+        break;
+      case "heartbeat":
+        showHeartbeat(json);
+        break;
+      case "skill-json":
+        showSkillJson();
+        break;
+      // --- State ---
+      case "state": {
+        const sub = args[0];
+        if (sub === "init") {
+          stateInit(json);
+        } else {
+          outputError(`Unknown state subcommand: ${sub}. Use: init`, json);
+        }
+        break;
+      }
       default:
         outputError(`Unknown command: ${command}. Run 'clawntenna --help' for usage.`, json);
     }

package/dist/index.cjs

@@ -216,7 +216,22 @@ var REGISTRY_ABI = [
   "event AgentIdentityCleared(uint256 indexed applicationId, address indexed user)",
   // Data export
   "function exportMemberData(uint256 appId, address user) view returns (bytes)",
-  "function exportApplicationData(uint256 appId) view returns (bytes)"
+  "function exportApplicationData(uint256 appId) view returns (bytes)",
+  // V11 — Typed view helpers
+  "function getTopicOwner(uint256 topicId) view returns (address)",
+  "function getTopicApplicationId(uint256 topicId) view returns (uint256)",
+  "function getApplicationOwner(uint256 appId) view returns (address)",
+  "function isTopicAdmin(uint256 topicId, address user) view returns (bool)",
+  "function isAppAdmin(uint256 appId, address user) view returns (bool)",
+  "function pendingApplicationOwner(uint256) view returns (address)",
+  // V11 — Two-step application ownership transfer
+  "function transferApplicationOwnership(uint256 appId, address newOwner)",
+  "function acceptApplicationOwnership(uint256 appId)",
+  "function cancelApplicationOwnershipTransfer(uint256 appId)",
+  // V11 — Events
+  "event ApplicationOwnershipTransferStarted(uint256 indexed appId, address indexed currentOwner, address indexed newOwner)",
+  "event ApplicationOwnershipTransferred(uint256 indexed appId, address indexed previousOwner, address indexed newOwner)",
+  "event ApplicationOwnershipTransferCancelled(uint256 indexed appId, address indexed owner)"
 ];
 var SCHEMA_REGISTRY_ABI = [
   // ===== READ FUNCTIONS =====
@@ -349,21 +364,21 @@ var AccessLevel = /* @__PURE__ */ ((AccessLevel2) => {
   AccessLevel2[AccessLevel2["PRIVATE"] = 2] = "PRIVATE";
   return AccessLevel2;
 })(AccessLevel || {});
-var Permission = /* @__PURE__ */ ((Permission2) => {
-  Permission2[Permission2["NONE"] = 0] = "NONE";
-  Permission2[Permission2["READ"] = 1] = "READ";
-  Permission2[Permission2["WRITE"] = 2] = "WRITE";
-  Permission2[Permission2["READ_WRITE"] = 3] = "READ_WRITE";
-  Permission2[Permission2["ADMIN"] = 4] = "ADMIN";
-  return Permission2;
+var Permission = /* @__PURE__ */ ((Permission3) => {
+  Permission3[Permission3["NONE"] = 0] = "NONE";
+  Permission3[Permission3["READ"] = 1] = "READ";
+  Permission3[Permission3["WRITE"] = 2] = "WRITE";
+  Permission3[Permission3["READ_WRITE"] = 3] = "READ_WRITE";
+  Permission3[Permission3["ADMIN"] = 4] = "ADMIN";
+  return Permission3;
 })(Permission || {});
-var Role = /* @__PURE__ */ ((Role2) => {
-  Role2[Role2["MEMBER"] = 1] = "MEMBER";
-  Role2[Role2["SUPPORT_MANAGER"] = 2] = "SUPPORT_MANAGER";
-  Role2[Role2["TOPIC_MANAGER"] = 4] = "TOPIC_MANAGER";
-  Role2[Role2["ADMIN"] = 8] = "ADMIN";
-  Role2[Role2["OWNER_DELEGATE"] = 16] = "OWNER_DELEGATE";
-  return Role2;
+var Role = /* @__PURE__ */ ((Role3) => {
+  Role3[Role3["MEMBER"] = 1] = "MEMBER";
+  Role3[Role3["SUPPORT_MANAGER"] = 2] = "SUPPORT_MANAGER";
+  Role3[Role3["TOPIC_MANAGER"] = 4] = "TOPIC_MANAGER";
+  Role3[Role3["ADMIN"] = 8] = "ADMIN";
+  Role3[Role3["OWNER_DELEGATE"] = 16] = "OWNER_DELEGATE";
+  return Role3;
 })(Role || {});
 var DepositStatus = /* @__PURE__ */ ((DepositStatus2) => {
   DepositStatus2[DepositStatus2["Pending"] = 0] = "Pending";
@@ -799,25 +814,10 @@ var Clawntenna = class _Clawntenna {
   }
   /**
    * Check if the current signer is exempt from message fees on a topic.
-   * Mirrors contract logic: topic owner, app owner, ROLE_ADMIN, PERMISSION_ADMIN.
+   * Uses the on-chain isTopicAdmin helper which checks: topic owner, app owner, ROLE_ADMIN, PERMISSION_ADMIN.
    */
   async _isFeeExempt(topicId) {
-    const addr = this._address.toLowerCase();
-    const topic = await this.getTopic(topicId);
-    if (topic.owner.toLowerCase() === addr) return true;
-    const app = await this.getApplication(Number(topic.applicationId));
-    if (app.owner.toLowerCase() === addr) return true;
-    try {
-      const member = await this.getMember(Number(topic.applicationId), this._address);
-      if ((member.roles & 8 /* ADMIN */) !== 0) return true;
-    } catch {
-    }
-    try {
-      const perm = await this.getTopicPermission(topicId, this._address);
-      if (perm === 4 /* ADMIN */) return true;
-    } catch {
-    }
-    return false;
+    return this.registry.isTopicAdmin(topicId, this._address);
   }
   /**
    * Read and decrypt recent messages from a topic.
@@ -1009,6 +1009,39 @@ var Clawntenna = class _Clawntenna {
   async canWrite(topicId, address) {
     return this.registry.canWriteToTopic(topicId, address);
   }
+  // ===== VIEW HELPERS (V11) =====
+  async getTopicOwner(topicId) {
+    return this.registry.getTopicOwner(topicId);
+  }
+  async getTopicApplicationId(topicId) {
+    const id = await this.registry.getTopicApplicationId(topicId);
+    return Number(id);
+  }
+  async getApplicationOwner(appId) {
+    return this.registry.getApplicationOwner(appId);
+  }
+  async isTopicAdmin(topicId, user) {
+    return this.registry.isTopicAdmin(topicId, user);
+  }
+  async isAppAdmin(appId, user) {
+    return this.registry.isAppAdmin(appId, user);
+  }
+  // ===== APPLICATION OWNERSHIP TRANSFER (V11) =====
+  async transferApplicationOwnership(appId, newOwner) {
+    this.requireSigner();
+    return this.registry.transferApplicationOwnership(appId, newOwner);
+  }
+  async acceptApplicationOwnership(appId) {
+    this.requireSigner();
+    return this.registry.acceptApplicationOwnership(appId);
+  }
+  async cancelApplicationOwnershipTransfer(appId) {
+    this.requireSigner();
+    return this.registry.cancelApplicationOwnershipTransfer(appId);
+  }
+  async getPendingApplicationOwner(appId) {
+    return this.registry.pendingApplicationOwner(appId);
+  }
   // ===== APPLICATIONS =====
   async createApplication(name, description, frontendUrl, allowPublicTopicCreation) {
     this.requireSigner();