@trustthenverify/sdk 1.1.0 → 2.0.0

package/dist/index.d.ts

@@ -28,6 +28,7 @@ export interface Agent {
     description?: string;
     contact?: string;
     trust_score?: number;
+    trust_tier?: number;
     capabilities?: string[];
     lightning_pubkey?: string;
     nostr_npub?: string;
@@ -35,6 +36,17 @@ export interface Agent {
     website?: string;
     created_at?: string;
 }
+export interface PaginatedAgents {
+    agents: Agent[];
+    page: number;
+    limit: number;
+    total: number;
+    total_pages: number;
+}
+export interface ListAgentsOptions {
+    page?: number;
+    limit?: number;
+}
 export interface RegisterResponse {
     agent_id: string;
     trust_score: number;
@@ -68,9 +80,25 @@ export declare class TrustClient {
      */
     getAgent(agentId: string): Promise<Agent | null>;
     /**
-     * List all registered agents
+     * List registered agents (paginated)
+     */
+    listAgents(options?: ListAgentsOptions): Promise<PaginatedAgents>;
+    /**
+     * Update an agent's fields (requires auth secret = contact value)
      */
-    listAgents(): Promise<Agent[]>;
+    updateAgent(agentId: string, updates: Partial<Pick<Agent, "description" | "capabilities" | "lightning_pubkey" | "x_handle" | "website" | "contact">>, authSecret: string): Promise<{
+        success: boolean;
+        message?: string;
+        error?: string;
+    }>;
+    /**
+     * Soft-delete an agent (requires auth secret = contact value)
+     */
+    deleteAgent(agentId: string, authSecret: string): Promise<{
+        success: boolean;
+        message?: string;
+        error?: string;
+    }>;
     /**
      * Register a new agent
      */
@@ -114,7 +142,17 @@ export declare const lookup: (agentId: string) => Promise<{
 } | null>;
 export declare const register: (name: string, contact: string, options?: Parameters<TrustClient["register"]>[2]) => Promise<RegisterResponse>;
 export declare const review: (agentId: string, rating: number, comment: string, options?: Parameters<TrustClient["review"]>[3]) => Promise<ReviewResponse>;
-export declare const listAgents: () => Promise<Agent[]>;
+export declare const listAgents: (options?: ListAgentsOptions) => Promise<PaginatedAgents>;
+export declare const updateAgent: (agentId: string, updates: Parameters<TrustClient["updateAgent"]>[1], authSecret: string) => Promise<{
+    success: boolean;
+    message?: string;
+    error?: string;
+}>;
+export declare const deleteAgent: (agentId: string, authSecret: string) => Promise<{
+    success: boolean;
+    message?: string;
+    error?: string;
+}>;
 export declare const isTrusted: (agentId: string) => Promise<boolean>;
 export declare const badgeUrl: (agentId: string) => string;
 /**

package/dist/index.js

@@ -6,7 +6,7 @@
  * https://trustthenverify.com
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.badgeUrl = exports.isTrusted = exports.listAgents = exports.review = exports.register = exports.lookup = exports.trust = exports.TrustClient = exports.TrustRegistryOfflineError = void 0;
+exports.badgeUrl = exports.isTrusted = exports.deleteAgent = exports.updateAgent = exports.listAgents = exports.review = exports.register = exports.lookup = exports.trust = exports.TrustClient = exports.TrustRegistryOfflineError = void 0;
 exports.ensureRegistered = ensureRegistered;
 exports.checkBeforeTransaction = checkBeforeTransaction;
 class TrustRegistryOfflineError extends Error {
@@ -52,14 +52,50 @@ class TrustClient {
         return res.json();
     }
     /**
-     * List all registered agents
+     * List registered agents (paginated)
      */
-    async listAgents() {
-        const res = await this.safeFetch(`${this.baseUrl}/registry/agents`);
+    async listAgents(options) {
+        const params = new URLSearchParams();
+        if (options?.page)
+            params.set("page", String(options.page));
+        if (options?.limit)
+            params.set("limit", String(options.limit));
+        const qs = params.toString();
+        const res = await this.safeFetch(`${this.baseUrl}/registry/agents${qs ? `?${qs}` : ""}`);
         if (!res.ok)
-            return [];
+            return { agents: [], page: 1, limit: 50, total: 0, total_pages: 0 };
         const data = await res.json();
-        return data.agents || [];
+        return {
+            agents: data.agents || [],
+            page: data.page || 1,
+            limit: data.limit || 50,
+            total: data.total || 0,
+            total_pages: data.total_pages || 0,
+        };
+    }
+    /**
+     * Update an agent's fields (requires auth secret = contact value)
+     */
+    async updateAgent(agentId, updates, authSecret) {
+        const res = await this.safeFetch(`${this.baseUrl}/registry/agent/${agentId}`, {
+            method: "PATCH",
+            headers: {
+                "Content-Type": "application/json",
+                "X-Agent-Secret": authSecret,
+            },
+            body: JSON.stringify(updates),
+        });
+        return res.json();
+    }
+    /**
+     * Soft-delete an agent (requires auth secret = contact value)
+     */
+    async deleteAgent(agentId, authSecret) {
+        const res = await this.safeFetch(`${this.baseUrl}/registry/agent/${agentId}`, {
+            method: "DELETE",
+            headers: { "X-Agent-Secret": authSecret },
+        });
+        return res.json();
     }
     /**
      * Register a new agent
@@ -136,8 +172,12 @@ const register = (name, contact, options) => exports.trust.register(name, contac
 exports.register = register;
 const review = (agentId, rating, comment, options) => exports.trust.review(agentId, rating, comment, options);
 exports.review = review;
-const listAgents = () => exports.trust.listAgents();
+const listAgents = (options) => exports.trust.listAgents(options);
 exports.listAgents = listAgents;
+const updateAgent = (agentId, updates, authSecret) => exports.trust.updateAgent(agentId, updates, authSecret);
+exports.updateAgent = updateAgent;
+const deleteAgent = (agentId, authSecret) => exports.trust.deleteAgent(agentId, authSecret);
+exports.deleteAgent = deleteAgent;
 const isTrusted = (agentId) => exports.trust.isTrusted(agentId);
 exports.isTrusted = isTrusted;
 const badgeUrl = (agentId) => exports.trust.badgeUrl(agentId);
@@ -156,19 +196,19 @@ exports.badgeUrl = badgeUrl;
  * });
  */
 async function ensureRegistered(options) {
-    // Check if already registered by name
-    const agents = await exports.trust.listAgents();
-    const existing = agents.find(a => a.name.toLowerCase() === options.name.toLowerCase());
+    // Search by name instead of listing all agents
+    const result = await exports.trust.listAgents({ limit: 50 });
+    const existing = result.agents.find(a => a.name.toLowerCase() === options.name.toLowerCase());
     if (existing) {
         return existing.id;
     }
     // Register new agent
-    const result = await exports.trust.register(options.name, options.contact || `sdk-auto-${Date.now()}`, {
+    const regResult = await exports.trust.register(options.name, options.contact || `sdk-auto-${Date.now()}`, {
         description: options.description,
         nostr_npub: options.npub,
         lightning_pubkey: options.lightning_pubkey,
     });
-    return result.agent_id;
+    return regResult.agent_id;
 }
 /**
  * Check trust before transaction helper

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trustthenverify/sdk",
-  "version": "1.1.0",
+  "version": "2.0.0",
   "description": "TypeScript SDK for the Trust Then Verify agent registry",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/index.ts

@@ -31,6 +31,7 @@ export interface Agent {
   description?: string;
   contact?: string;
   trust_score?: number;
+  trust_tier?: number;
   capabilities?: string[];
   lightning_pubkey?: string;
   nostr_npub?: string;
@@ -39,6 +40,19 @@ export interface Agent {
   created_at?: string;
 }
 
+export interface PaginatedAgents {
+  agents: Agent[];
+  page: number;
+  limit: number;
+  total: number;
+  total_pages: number;
+}
+
+export interface ListAgentsOptions {
+  page?: number;
+  limit?: number;
+}
+
 export interface RegisterResponse {
   agent_id: string;
   trust_score: number;
@@ -102,13 +116,56 @@ export class TrustClient {
   }
 
   /**
-   * List all registered agents
+   * List registered agents (paginated)
    */
-  async listAgents(): Promise<Agent[]> {
-    const res = await this.safeFetch(`${this.baseUrl}/registry/agents`);
-    if (!res.ok) return [];
+  async listAgents(options?: ListAgentsOptions): Promise<PaginatedAgents> {
+    const params = new URLSearchParams();
+    if (options?.page) params.set("page", String(options.page));
+    if (options?.limit) params.set("limit", String(options.limit));
+    const qs = params.toString();
+    const res = await this.safeFetch(`${this.baseUrl}/registry/agents${qs ? `?${qs}` : ""}`);
+    if (!res.ok) return { agents: [], page: 1, limit: 50, total: 0, total_pages: 0 };
     const data = await res.json();
-    return data.agents || [];
+    return {
+      agents: data.agents || [],
+      page: data.page || 1,
+      limit: data.limit || 50,
+      total: data.total || 0,
+      total_pages: data.total_pages || 0,
+    };
+  }
+
+  /**
+   * Update an agent's fields (requires auth secret = contact value)
+   */
+  async updateAgent(
+    agentId: string,
+    updates: Partial<Pick<Agent, "description" | "capabilities" | "lightning_pubkey" | "x_handle" | "website" | "contact">>,
+    authSecret: string
+  ): Promise<{ success: boolean; message?: string; error?: string }> {
+    const res = await this.safeFetch(`${this.baseUrl}/registry/agent/${agentId}`, {
+      method: "PATCH",
+      headers: {
+        "Content-Type": "application/json",
+        "X-Agent-Secret": authSecret,
+      },
+      body: JSON.stringify(updates),
+    });
+    return res.json();
+  }
+
+  /**
+   * Soft-delete an agent (requires auth secret = contact value)
+   */
+  async deleteAgent(
+    agentId: string,
+    authSecret: string
+  ): Promise<{ success: boolean; message?: string; error?: string }> {
+    const res = await this.safeFetch(`${this.baseUrl}/registry/agent/${agentId}`, {
+      method: "DELETE",
+      headers: { "X-Agent-Secret": authSecret },
+    });
+    return res.json();
   }
 
   /**
@@ -205,7 +262,10 @@ export const register = (name: string, contact: string, options?: Parameters<Tru
   trust.register(name, contact, options);
 export const review = (agentId: string, rating: number, comment: string, options?: Parameters<TrustClient["review"]>[3]) =>
   trust.review(agentId, rating, comment, options);
-export const listAgents = () => trust.listAgents();
+export const listAgents = (options?: ListAgentsOptions) => trust.listAgents(options);
+export const updateAgent = (agentId: string, updates: Parameters<TrustClient["updateAgent"]>[1], authSecret: string) =>
+  trust.updateAgent(agentId, updates, authSecret);
+export const deleteAgent = (agentId: string, authSecret: string) => trust.deleteAgent(agentId, authSecret);
 export const isTrusted = (agentId: string) => trust.isTrusted(agentId);
 export const badgeUrl = (agentId: string) => trust.badgeUrl(agentId);
 
@@ -229,16 +289,16 @@ export async function ensureRegistered(options: {
   lightning_pubkey?: string;
   description?: string;
 }): Promise<string> {
-  // Check if already registered by name
-  const agents = await trust.listAgents();
-  const existing = agents.find(a => a.name.toLowerCase() === options.name.toLowerCase());
+  // Search by name instead of listing all agents
+  const result = await trust.listAgents({ limit: 50 });
+  const existing = result.agents.find(a => a.name.toLowerCase() === options.name.toLowerCase());
 
   if (existing) {
     return existing.id;
   }
 
   // Register new agent
-  const result = await trust.register(
+  const regResult = await trust.register(
     options.name,
     options.contact || `sdk-auto-${Date.now()}`,
     {
@@ -248,7 +308,7 @@ export async function ensureRegistered(options: {
     }
   );
 
-  return result.agent_id;
+  return regResult.agent_id;
 }
 
 /**