@ton-agent-kit/plugin-identity 1.1.0 → 1.2.0

package/src/actions/get-agent-reputation.ts

@@ -1,126 +1,126 @@
-import { z } from "zod";
-import { Address, internal, toNano } from "@ton/core";
-import { defineAction, toFriendlyAddress, sendTransaction } from "@ton-agent-kit/core";
-import { loadAgentRegistry, saveAgentRegistry } from "../utils";
-import { resolveContractAddress } from "../reputation-config";
-import { buildRateBody, callContractGetter, lookupAgentIndex, parseAgentDataFromStack } from "../reputation-helpers";
-
-export function createGetAgentReputationAction(contractAddress?: string) {
-  return defineAction({
-    name: "get_agent_reputation",
-    description:
-      "Get the reputation score of a registered agent. Set addTask=true and success=true/false to record a task result. Works both on-chain and locally.",
-    schema: z.object({
-      agentId: z.string().describe("Agent ID or name to check or update"),
-      addTask: z
-        .union([z.boolean(), z.string()])
-        .optional()
-        .describe("Set to true to record a completed task"),
-      success: z
-        .union([z.boolean(), z.string()])
-        .optional()
-        .describe("If addTask is true, whether the task was successful"),
-    }),
-    handler: async (agent, params) => {
-      const addTask = typeof params.addTask === "string" ? params.addTask === "true" : params.addTask;
-      const success = typeof params.success === "string" ? params.success === "true" : params.success;
-
-      const addr = resolveContractAddress(contractAddress, agent.network);
-
-      // ── On-chain mode ──
-      if (addr) {
-        try {
-          const apiBase =
-            agent.network === "testnet"
-              ? "https://testnet.tonapi.io/v2"
-              : "https://tonapi.io/v2";
-
-          // Get the actual agent name for on-chain lookup
-          // Prefer JSON registry (has the exact name used at registration)
-          const jsonRegistry = loadAgentRegistry();
-          const jsonRecord = jsonRegistry[params.agentId];
-          const agentName = jsonRecord?.name
-            || (params.agentId.startsWith("agent_") ? params.agentId.slice(6) : params.agentId);
-
-          // If rating, send Rate message
-          if (addTask) {
-            const body = buildRateBody(agentName, success !== false);
-
-            await sendTransaction(agent, [
-              internal({
-                to: Address.parse(addr),
-                value: toNano("0.03"),
-                bounce: true,
-                body,
-              }),
-            ]);
-          }
-
-          // Look up agent index by name hash
-          const idx = await lookupAgentIndex(apiBase, addr, agentName, agent.config.TONAPI_KEY);
-
-          if (idx !== null) {
-            // Get on-chain data using index
-            const dataRes = await callContractGetter(
-              apiBase, addr, "agentData", [idx.toString()], agent.config.TONAPI_KEY,
-            );
-            const repRes = await callContractGetter(
-              apiBase, addr, "agentReputation", [idx.toString()], agent.config.TONAPI_KEY,
-            );
-
-            const agentData = dataRes?.stack ? parseAgentDataFromStack(dataRes.stack) : null;
-            const repScore = repRes?.stack?.[0]?.num
-              ? Number(BigInt(repRes.stack[0].num))
-              : 0;
-
-            return {
-              agentId: params.agentId,
-              name: agentName,
-              reputation: {
-                score: repScore,
-                totalTasks: agentData?.totalTasks || 0,
-                successfulTasks: agentData?.successes || 0,
-              },
-              available: agentData?.available ?? true,
-              onChain: true,
-              contractAddress: addr,
-            };
-          }
-
-          // Agent not found on-chain — fall through to JSON
-        } catch {
-          // Fall through to JSON
-        }
-      }
-
-      // ── JSON fallback mode ──
-      const registry = loadAgentRegistry();
-      const agentRecord = registry[params.agentId];
-      if (!agentRecord) throw new Error(`Agent not found: ${params.agentId}`);
-
-      if (addTask) {
-        agentRecord.reputation.totalTasks += 1;
-        if (success !== false) {
-          agentRecord.reputation.successfulTasks += 1;
-        }
-        agentRecord.reputation.score = Math.round(
-          (agentRecord.reputation.successfulTasks / agentRecord.reputation.totalTasks) * 100,
-        );
-        saveAgentRegistry(registry);
-      }
-
-      return {
-        agentId: params.agentId,
-        name: agentRecord.name,
-        address: agentRecord.address,
-        friendlyAddress: toFriendlyAddress(Address.parse(agentRecord.address), agent.network),
-        reputation: agentRecord.reputation,
-        available: agentRecord.available !== false,
-        onChain: false,
-        registeredAt: agentRecord.registeredAt,
-      };
-    },
-  });
-}
-
-export const getAgentReputationAction = createGetAgentReputationAction();
+import { z } from "zod";
+import { Address, internal, toNano } from "@ton/core";
+import { defineAction, toFriendlyAddress, sendTransaction } from "@ton-agent-kit/core";
+import { loadAgentRegistry, saveAgentRegistry } from "../utils";
+import { resolveContractAddress } from "../reputation-config";
+import { buildRateBody, callContractGetter, lookupAgentIndex, parseAgentDataFromStack } from "../reputation-helpers";
+
+export function createGetAgentReputationAction(contractAddress?: string) {
+  return defineAction({
+    name: "get_agent_reputation",
+    description:
+      "Get the reputation score of a registered agent. Set addTask=true and success=true/false to record a task result. Works both on-chain and locally.",
+    schema: z.object({
+      agentId: z.string().describe("Agent ID or name to check or update"),
+      addTask: z
+        .union([z.boolean(), z.string()])
+        .optional()
+        .describe("Set to true to record a completed task"),
+      success: z
+        .union([z.boolean(), z.string()])
+        .optional()
+        .describe("If addTask is true, whether the task was successful"),
+    }),
+    handler: async (agent, params) => {
+      const addTask = typeof params.addTask === "string" ? params.addTask === "true" : params.addTask;
+      const success = typeof params.success === "string" ? params.success === "true" : params.success;
+
+      const addr = resolveContractAddress(contractAddress, agent.network);
+
+      // ── On-chain mode ──
+      if (addr) {
+        try {
+          const apiBase =
+            agent.network === "testnet"
+              ? "https://testnet.tonapi.io/v2"
+              : "https://tonapi.io/v2";
+
+          // Get the actual agent name for on-chain lookup
+          // Prefer JSON registry (has the exact name used at registration)
+          const jsonRegistry = loadAgentRegistry();
+          const jsonRecord = jsonRegistry[params.agentId];
+          const agentName = jsonRecord?.name
+            || (params.agentId.startsWith("agent_") ? params.agentId.slice(6) : params.agentId);
+
+          // If rating, send Rate message
+          if (addTask) {
+            const body = buildRateBody(agentName, success !== false);
+
+            await sendTransaction(agent, [
+              internal({
+                to: Address.parse(addr),
+                value: toNano("0.05"),
+                bounce: true,
+                body,
+              }),
+            ]);
+          }
+
+          // Look up agent index by name hash
+          const idx = await lookupAgentIndex(apiBase, addr, agentName, agent.config.TONAPI_KEY);
+
+          if (idx !== null) {
+            // Get on-chain data using index
+            const dataRes = await callContractGetter(
+              apiBase, addr, "agentData", [idx.toString()], agent.config.TONAPI_KEY,
+            );
+            const repRes = await callContractGetter(
+              apiBase, addr, "agentReputation", [idx.toString()], agent.config.TONAPI_KEY,
+            );
+
+            const agentData = dataRes?.stack ? parseAgentDataFromStack(dataRes.stack) : null;
+            const repScore = repRes?.stack?.[0]?.num
+              ? Number(BigInt(repRes.stack[0].num))
+              : 0;
+
+            return {
+              agentId: params.agentId,
+              name: agentName,
+              reputation: {
+                score: repScore,
+                totalTasks: agentData?.totalTasks || 0,
+                successfulTasks: agentData?.successes || 0,
+              },
+              available: agentData?.available ?? true,
+              onChain: true,
+              contractAddress: addr,
+            };
+          }
+
+          // Agent not found on-chain — fall through to JSON
+        } catch {
+          // Fall through to JSON
+        }
+      }
+
+      // ── JSON fallback mode ──
+      const registry = loadAgentRegistry();
+      const agentRecord = registry[params.agentId];
+      if (!agentRecord) throw new Error(`Agent not found: ${params.agentId}`);
+
+      if (addTask) {
+        agentRecord.reputation.totalTasks += 1;
+        if (success !== false) {
+          agentRecord.reputation.successfulTasks += 1;
+        }
+        agentRecord.reputation.score = Math.round(
+          (agentRecord.reputation.successfulTasks / agentRecord.reputation.totalTasks) * 100,
+        );
+        saveAgentRegistry(registry);
+      }
+
+      return {
+        agentId: params.agentId,
+        name: agentRecord.name,
+        address: agentRecord.address,
+        friendlyAddress: toFriendlyAddress(Address.parse(agentRecord.address), agent.network),
+        reputation: agentRecord.reputation,
+        available: agentRecord.available !== false,
+        onChain: false,
+        registeredAt: agentRecord.registeredAt,
+      };
+    },
+  });
+}
+
+export const getAgentReputationAction = createGetAgentReputationAction();

package/src/actions/get-open-disputes.ts

@@ -1,65 +1,65 @@
-import { z } from "zod";
-import { defineAction } from "@ton-agent-kit/core";
-import { resolveContractAddress } from "../reputation-config";
-import { callContractGetter, parseDisputeData } from "../reputation-helpers";
-
-export const getOpenDisputesAction = defineAction({
-  name: "get_open_disputes",
-  description:
-    "Get all open (unsettled) disputes from the reputation contract. Arbiters use this to find disputes they can join and vote on.",
-  schema: z.object({
-    limit: z.coerce.number().optional().describe("Max disputes to return. Default 20."),
-  }),
-  handler: async (agent, params) => {
-    const addr = resolveContractAddress(undefined, agent.network);
-    if (!addr) {
-      return { disputes: [], count: 0, message: "No reputation contract configured" };
-    }
-
-    const apiBase = agent.network === "testnet"
-      ? "https://testnet.tonapi.io/v2"
-      : "https://tonapi.io/v2";
-
-    const limit = params.limit || 20;
-
-    const countRes = await callContractGetter(apiBase, addr, "disputeCount", undefined, agent.config.TONAPI_KEY);
-    const totalDisputes = countRes?.stack?.[0]?.num ? Number(BigInt(countRes.stack[0].num)) : 0;
-
-    if (totalDisputes === 0) {
-      return { disputes: [], count: 0, total: 0, message: "No disputes registered" };
-    }
-
-    const disputes: any[] = [];
-    let checked = 0;
-    for (let i = totalDisputes - 1; i >= 0 && disputes.length < limit; i--) {
-      try {
-        const dataRes = await callContractGetter(apiBase, addr, "disputeData", [i.toString()], agent.config.TONAPI_KEY);
-        if (dataRes?.stack) {
-          const dispute = parseDisputeData(dataRes.stack);
-          if (dispute && !dispute.settled) {
-            disputes.push({
-              index: i,
-              escrowAddress: dispute.escrowAddress,
-              depositor: dispute.depositor,
-              beneficiary: dispute.beneficiary,
-              amount: dispute.amount,
-              votingDeadline: new Date(dispute.votingDeadline * 1000).toISOString(),
-              isExpired: Date.now() / 1000 > dispute.votingDeadline,
-            });
-          }
-        }
-      } catch {}
-      checked++;
-      if (checked > 100) break;
-    }
-
-    return {
-      disputes,
-      count: disputes.length,
-      total: totalDisputes,
-      onChain: true,
-      contractAddress: addr,
-      message: `Found ${disputes.length} open dispute(s)`,
-    };
-  },
-});
+import { z } from "zod";
+import { defineAction } from "@ton-agent-kit/core";
+import { resolveContractAddress } from "../reputation-config";
+import { callContractGetter, parseDisputeData } from "../reputation-helpers";
+
+export const getOpenDisputesAction = defineAction({
+  name: "get_open_disputes",
+  description:
+    "Get all open (unsettled) disputes from the reputation contract. Arbiters use this to find disputes they can join and vote on.",
+  schema: z.object({
+    limit: z.coerce.number().optional().describe("Max disputes to return. Default 20."),
+  }),
+  handler: async (agent, params) => {
+    const addr = resolveContractAddress(undefined, agent.network);
+    if (!addr) {
+      return { disputes: [], count: 0, message: "No reputation contract configured" };
+    }
+
+    const apiBase = agent.network === "testnet"
+      ? "https://testnet.tonapi.io/v2"
+      : "https://tonapi.io/v2";
+
+    const limit = params.limit || 20;
+
+    const countRes = await callContractGetter(apiBase, addr, "disputeCount", undefined, agent.config.TONAPI_KEY);
+    const totalDisputes = countRes?.stack?.[0]?.num ? Number(BigInt(countRes.stack[0].num)) : 0;
+
+    if (totalDisputes === 0) {
+      return { disputes: [], count: 0, total: 0, message: "No disputes registered" };
+    }
+
+    const disputes: any[] = [];
+    let checked = 0;
+    for (let i = totalDisputes - 1; i >= 0 && disputes.length < limit; i--) {
+      try {
+        const dataRes = await callContractGetter(apiBase, addr, "disputeData", [i.toString()], agent.config.TONAPI_KEY);
+        if (dataRes?.stack) {
+          const dispute = parseDisputeData(dataRes.stack);
+          if (dispute && !dispute.settled) {
+            disputes.push({
+              index: i,
+              escrowAddress: dispute.escrowAddress,
+              depositor: dispute.depositor,
+              beneficiary: dispute.beneficiary,
+              amount: dispute.amount,
+              votingDeadline: new Date(dispute.votingDeadline * 1000).toISOString(),
+              isExpired: Date.now() / 1000 > dispute.votingDeadline,
+            });
+          }
+        }
+      } catch {}
+      checked++;
+      if (checked > 100) break;
+    }
+
+    return {
+      disputes,
+      count: disputes.length,
+      total: totalDisputes,
+      onChain: true,
+      contractAddress: addr,
+      message: `Found ${disputes.length} open dispute(s)`,
+    };
+  },
+});

package/src/actions/process-pending-ratings.ts

@@ -1,114 +1,114 @@
-import { z } from "zod";
-import { defineAction } from "@ton-agent-kit/core";
-
-export const processPendingRatingsAction = defineAction({
-  name: "process_pending_ratings",
-  description:
-    "Process pending reputation ratings left by completed escrow deals. Each escrow completion (release, auto-release, refund) creates pending ratings for both buyer and seller. Call this to review or auto-submit them.",
-  schema: z.object({
-    autoSubmit: z
-      .boolean()
-      .optional()
-      .describe("Automatically submit all pending ratings with suggested success values. Defaults to false (returns pending list for review)."),
-  }),
-  handler: async (agent, params) => {
-    // Load pending ratings from memory
-    let entries: any[] = [];
-    try {
-      const r = await (agent as any).runAction("list_context", {
-        namespace: "pending_ratings",
-      });
-      entries = r.entries || [];
-    } catch {
-      return {
-        processed: 0,
-        pending: 0,
-        ratings: [],
-        message: "Memory plugin not available. Cannot process pending ratings.",
-      };
-    }
-
-    if (entries.length === 0) {
-      return {
-        processed: 0,
-        pending: 0,
-        ratings: [],
-        message: "No pending ratings to process.",
-      };
-    }
-
-    // Parse entries
-    const pending: any[] = [];
-    for (const entry of entries) {
-      try {
-        const data = JSON.parse(entry.value);
-        pending.push({ ...data, memoryKey: entry.key });
-      } catch {
-        continue;
-      }
-    }
-
-    if (!params.autoSubmit) {
-      return {
-        processed: 0,
-        pending: pending.length,
-        ratings: pending.map((p) => ({
-          escrowId: p.escrowId,
-          raterRole: p.raterRole,
-          targetAddress: p.targetAddress,
-          suggestedSuccess: p.suggestedSuccess,
-          escrowOutcome: p.escrowOutcome,
-        })),
-        message: `${pending.length} pending rating(s) found. Set autoSubmit=true to submit them.`,
-      };
-    }
-
-    // Auto-submit ratings
-    let processed = 0;
-    const results: any[] = [];
-
-    for (const rating of pending) {
-      try {
-        // Find the target agent ID by address match in the registry
-        // Use a simple name-based lookup: the target address is stored in the rating
-        await (agent as any).runAction("get_agent_reputation", {
-          agentId: rating.targetAddress,
-          addTask: true,
-          success: rating.suggestedSuccess,
-        });
-
-        // Delete the processed rating from memory
-        try {
-          await (agent as any).runAction("delete_context", {
-            key: rating.memoryKey,
-            namespace: "pending_ratings",
-          });
-        } catch {}
-
-        processed++;
-        results.push({
-          escrowId: rating.escrowId,
-          raterRole: rating.raterRole,
-          targetAddress: rating.targetAddress,
-          success: rating.suggestedSuccess,
-          submitted: true,
-        });
-      } catch (err: any) {
-        results.push({
-          escrowId: rating.escrowId,
-          raterRole: rating.raterRole,
-          targetAddress: rating.targetAddress,
-          submitted: false,
-          error: err.message,
-        });
-      }
-    }
-
-    return {
-      processed,
-      pending: pending.length - processed,
-      ratings: results,
-      message: `Processed ${processed}/${pending.length} ratings.`,
-    };
-  },
-});
+import { z } from "zod";
+import { defineAction } from "@ton-agent-kit/core";
+
+export const processPendingRatingsAction = defineAction({
+  name: "process_pending_ratings",
+  description:
+    "Process pending reputation ratings left by completed escrow deals. Each escrow completion (release, auto-release, refund) creates pending ratings for both buyer and seller. Call this to review or auto-submit them.",
+  schema: z.object({
+    autoSubmit: z
+      .boolean()
+      .optional()
+      .describe("Automatically submit all pending ratings with suggested success values. Defaults to false (returns pending list for review)."),
+  }),
+  handler: async (agent, params) => {
+    // Load pending ratings from memory
+    let entries: any[] = [];
+    try {
+      const r = await (agent as any).runAction("list_context", {
+        namespace: "pending_ratings",
+      });
+      entries = r.entries || [];
+    } catch {
+      return {
+        processed: 0,
+        pending: 0,
+        ratings: [],
+        message: "Memory plugin not available. Cannot process pending ratings.",
+      };
+    }
+
+    if (entries.length === 0) {
+      return {
+        processed: 0,
+        pending: 0,
+        ratings: [],
+        message: "No pending ratings to process.",
+      };
+    }
+
+    // Parse entries
+    const pending: any[] = [];
+    for (const entry of entries) {
+      try {
+        const data = JSON.parse(entry.value);
+        pending.push({ ...data, memoryKey: entry.key });
+      } catch {
+        continue;
+      }
+    }
+
+    if (!params.autoSubmit) {
+      return {
+        processed: 0,
+        pending: pending.length,
+        ratings: pending.map((p) => ({
+          escrowId: p.escrowId,
+          raterRole: p.raterRole,
+          targetAddress: p.targetAddress,
+          suggestedSuccess: p.suggestedSuccess,
+          escrowOutcome: p.escrowOutcome,
+        })),
+        message: `${pending.length} pending rating(s) found. Set autoSubmit=true to submit them.`,
+      };
+    }
+
+    // Auto-submit ratings
+    let processed = 0;
+    const results: any[] = [];
+
+    for (const rating of pending) {
+      try {
+        // Find the target agent ID by address match in the registry
+        // Use a simple name-based lookup: the target address is stored in the rating
+        await (agent as any).runAction("get_agent_reputation", {
+          agentId: rating.targetAddress,
+          addTask: true,
+          success: rating.suggestedSuccess,
+        });
+
+        // Delete the processed rating from memory
+        try {
+          await (agent as any).runAction("delete_context", {
+            key: rating.memoryKey,
+            namespace: "pending_ratings",
+          });
+        } catch {}
+
+        processed++;
+        results.push({
+          escrowId: rating.escrowId,
+          raterRole: rating.raterRole,
+          targetAddress: rating.targetAddress,
+          success: rating.suggestedSuccess,
+          submitted: true,
+        });
+      } catch (err: any) {
+        results.push({
+          escrowId: rating.escrowId,
+          raterRole: rating.raterRole,
+          targetAddress: rating.targetAddress,
+          submitted: false,
+          error: err.message,
+        });
+      }
+    }
+
+    return {
+      processed,
+      pending: pending.length - processed,
+      ratings: results,
+      message: `Processed ${processed}/${pending.length} ratings.`,
+    };
+  },
+});