feat(sdk): outcome filter, batch listAllAgents; REST API: global feedback, pagination, missing fields

SDK:
- Add outcome filter to FeedbackSearchOptions
- listAllAgents uses batched loadAgents internally (fixes N+1 RPC calls)

REST API (dashboard):
- GET /api/feedback (global) - feedback across all agents
- GET /api/agents: offset pagination, endpointTypes filter, totalAgents, nonTransferable
- GET /api/feedback/:mint: add message, createdAt, compressedAddress, schema, outcome filter

SKILL.md:
- Document reputation scoring, listAllFeedbacks, browser wallet flow, schema discrimination
- Clarify searchFeedback vs searchAllFeedback, platform ownership model
- Add REST API reference, Outcome enum values, various warnings

Author: tenequm

apps/dashboard/src/worker/identity-api.ts

@@ -254,11 +254,17 @@ export function createIdentityApi(env: Env) {
     const network = getNetwork(c.req.query("network"));
     const nameFilter = c.req.query("name")?.toLowerCase();
     const ownerFilter = c.req.query("owner");
+    const endpointTypesParam = c.req.query("endpointTypes");
     const limitParam = Number.parseInt(c.req.query("limit") ?? "20", 10);
+    const offsetParam = Number.parseInt(c.req.query("offset") ?? "0", 10);
     const limit = Math.min(Math.max(limitParam, 1), 50);
+    const offset = Math.max(offsetParam, 0);
+
+    const endpointTypes = endpointTypesParam?.split(",").filter(Boolean) ?? [];
 
     try {
       const sati = createSatiClient(network, env);
+      const stats = await sati.getRegistryStats();
 
       let agents: AgentIdentity[];
       if (ownerFilter) {
@@ -267,11 +273,11 @@ export function createIdentityApi(env: Env) {
         }
         agents = await sati.listAgentsByOwner(ownerFilter as Address);
       } else {
-        const result = await sati.listAllAgents({ limit });
-        agents = result.agents;
+        const result = await sati.listAllAgents({ limit: limit + offset, offset: 0 });
+        agents = result.agents.slice(offset);
       }
 
-      // Fetch registration files and apply name filter
+      // Fetch registration files and apply filters
       const results = [];
       for (const agent of agents) {
         if (results.length >= limit) break;
@@ -283,6 +289,11 @@ export function createIdentityApi(env: Env) {
           if (!agentName.includes(nameFilter)) continue;
         }
 
+        if (endpointTypes.length > 0) {
+          const serviceNames = (regFile?.services ?? []).map((s) => s.name);
+          if (!endpointTypes.some((t) => serviceNames.includes(t))) continue;
+        }
+
         results.push({
           mint: agent.mint,
           agentId: `${CAIP2_CHAINS[network]}:${agent.mint}`,
@@ -292,14 +303,15 @@ export function createIdentityApi(env: Env) {
           image: regFile?.image ?? "",
           uri: agent.uri,
           memberNumber: Number(agent.memberNumber),
+          nonTransferable: agent.nonTransferable,
           active: regFile?.active ?? true,
           services: regFile?.services ?? [],
           supportedTrust: regFile?.supportedTrust ?? [],
           x402Support: regFile?.x402Support ?? false,
         });
       }
 
-      return c.json({ agents: results, count: results.length });
+      return c.json({ agents: results, count: results.length, totalAgents: Number(stats.totalAgents) });
     } catch (error) {
       console.error("[agents] ERROR:", error);
       return c.json({ error: error instanceof Error ? error.message : "Failed to list agents" }, 500);
@@ -511,57 +523,111 @@ export function createIdentityApi(env: Env) {
   // GET /api/feedback/:mint - List feedback for agent
   // ---------------------------------------------------------------------------
 
+  // Shared feedback query logic for both per-agent and global endpoints
+  async function queryFeedback(
+    sati: Sati,
+    network: "devnet" | "mainnet",
+    agentMint?: Address,
+    filters?: { clientAddress?: string; tag1?: string; tag2?: string; outcome?: string },
+  ) {
+    const networkConfig = getNetworkConfig(sati);
+    const feedbackSchemas = [networkConfig.feedbackSchema, networkConfig.feedbackPublicSchema].filter(Boolean);
+
+    const { rpc: rpcUrl } = env.RPC_URLS[network];
+    const slotResp = await fetch(rpcUrl, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "getSlot", params: [{ commitment: "confirmed" }] }),
+    });
+    const slotJson = (await slotResp.json()) as { result: number };
+    const currentSlot = slotJson.result;
+    const nowSec = Math.floor(Date.now() / 1000);
+
+    const feedbackItems: Array<Record<string, unknown>> = [];
+    let feedbackIndex = 0;
+
+    for (const schema of feedbackSchemas) {
+      const filter: Record<string, unknown> = { sasSchema: schema as Address };
+      if (agentMint) filter.agentMint = agentMint;
+
+      const feedbacks = await sati.listFeedbacks(filter as { sasSchema: Address; agentMint?: Address });
+
+      for (const fb of feedbacks.items) {
+        const parsed = parseFeedbackContent(fb.data.content, fb.data.contentType);
+
+        if (filters?.clientAddress && fb.data.counterparty !== filters.clientAddress) continue;
+        if (filters?.tag1 && parsed?.tag1 !== filters.tag1) continue;
+        if (filters?.tag2 && parsed?.tag2 !== filters.tag2) continue;
+        if (filters?.outcome !== undefined && String(fb.data.outcome) !== filters.outcome) continue;
+
+        const slotDiff = Number(BigInt(currentSlot) - fb.raw.slotCreated);
+        const createdAt = nowSec - Math.floor(slotDiff * 0.4);
+
+        feedbackItems.push({
+          compressedAddress: fb.address,
+          clientAddress: fb.data.counterparty,
+          agentMint: fb.data.agentMint,
+          feedbackIndex: feedbackIndex++,
+          value: parsed?.value ?? 0,
+          valueDecimals: parsed?.valueDecimals ?? 0,
+          tag1: parsed?.tag1 ?? "",
+          tag2: parsed?.tag2 ?? "",
+          message: parsed?.m ?? "",
+          endpoint: parsed?.endpoint ?? "",
+          outcome: fb.data.outcome,
+          createdAt,
+          schema: schema === networkConfig.feedbackSchema ? "FeedbackV1" : "FeedbackPublicV1",
+          isRevoked: false,
+        });
+      }
+    }
+
+    return feedbackItems;
+  }
+
   app.get("/api/feedback/:mint", async (c) => {
     const mint = c.req.param("mint");
     const network = getNetwork(c.req.query("network"));
-    const clientAddressFilter = c.req.query("clientAddress");
-    const tag1Filter = c.req.query("tag1");
-    const tag2Filter = c.req.query("tag2");
 
     if (!isAddress(mint)) {
       return c.json({ error: "Invalid mint address" }, 400);
     }
 
     try {
       const sati = createSatiClient(network, env);
-      const networkConfig = getNetworkConfig(sati);
-      const feedbackSchemas = [networkConfig.feedbackSchema, networkConfig.feedbackPublicSchema].filter(Boolean);
-
-      const feedbackItems: Array<Record<string, unknown>> = [];
-      let feedbackIndex = 0;
+      const feedbackItems = await queryFeedback(sati, network, mint as Address, {
+        clientAddress: c.req.query("clientAddress"),
+        tag1: c.req.query("tag1"),
+        tag2: c.req.query("tag2"),
+        outcome: c.req.query("outcome"),
+      });
 
-      for (const schema of feedbackSchemas) {
-        const feedbacks = await sati.listFeedbacks({
-          sasSchema: schema as Address,
-          agentMint: mint as Address,
-        });
+      return c.json({ feedbacks: feedbackItems, count: feedbackItems.length });
+    } catch (error) {
+      console.error("[feedback list] ERROR:", error);
+      return c.json({ error: error instanceof Error ? error.message : "Failed to list feedback" }, 500);
+    }
+  });
 
-        for (const fb of feedbacks.items) {
-          const parsed = parseFeedbackContent(fb.data.content, fb.data.contentType);
+  // ---------------------------------------------------------------------------
+  // GET /api/feedback - List ALL feedback across all agents
+  // ---------------------------------------------------------------------------
 
-          // Apply filters
-          if (clientAddressFilter && fb.data.counterparty !== clientAddressFilter) continue;
-          if (tag1Filter && parsed?.tag1 !== tag1Filter) continue;
-          if (tag2Filter && parsed?.tag2 !== tag2Filter) continue;
+  app.get("/api/feedback", async (c) => {
+    const network = getNetwork(c.req.query("network"));
 
-          feedbackItems.push({
-            clientAddress: fb.data.counterparty,
-            feedbackIndex: feedbackIndex++,
-            value: parsed?.value ?? 0,
-            valueDecimals: parsed?.valueDecimals ?? 0,
-            tag1: parsed?.tag1 ?? "",
-            tag2: parsed?.tag2 ?? "",
-            endpoint: parsed?.endpoint ?? "",
-            reviewer: parsed?.reviewer ?? "",
-            outcome: fb.data.outcome,
-            isRevoked: false,
-          });
-        }
-      }
+    try {
+      const sati = createSatiClient(network, env);
+      const feedbackItems = await queryFeedback(sati, network, undefined, {
+        clientAddress: c.req.query("clientAddress"),
+        tag1: c.req.query("tag1"),
+        tag2: c.req.query("tag2"),
+        outcome: c.req.query("outcome"),
+      });
 
       return c.json({ feedbacks: feedbackItems, count: feedbackItems.length });
     } catch (error) {
-      console.error("[feedback list] ERROR:", error);
+      console.error("[feedback global] ERROR:", error);
       return c.json({ error: error instanceof Error ? error.message : "Failed to list feedback" }, 500);
     }
   });

docs/reference/rest-api.md

@@ -11,15 +11,17 @@ All endpoints accept a `?network=mainnet|devnet` query parameter (defaults to ma
 ### List agents
 
 ```
-GET /api/agents?network=mainnet&limit=20&name=search&owner=ADDRESS
+GET /api/agents?network=mainnet&limit=20&offset=0&name=search&owner=ADDRESS&endpointTypes=MCP,A2A
 ```
 
 | Param | Type | Description |
 |-------|------|-------------|
 | `network` | `mainnet` \| `devnet` | Network to query |
 | `limit` | number | Max results (1-50, default 20) |
+| `offset` | number | Skip first N agents (default 0) |
 | `name` | string | Filter by name (case-insensitive substring) |
 | `owner` | string | Filter by owner address |
+| `endpointTypes` | string | Comma-separated service types: `MCP`, `A2A`, `OASF` |
 
 **Response:**
 
@@ -35,13 +37,15 @@ GET /api/agents?network=mainnet&limit=20&name=search&owner=ADDRESS
       "image": "https://...",
       "uri": "ipfs://Qm...",
       "memberNumber": 1,
+      "nonTransferable": false,
       "active": true,
       "services": [{"name": "MCP", "endpoint": "https://..."}],
       "supportedTrust": ["reputation"],
       "x402Support": false
     }
   ],
-  "count": 1
+  "count": 1,
+  "totalAgents": 80
 }
 ```
 
@@ -102,34 +106,53 @@ Returns an SVG badge (shields.io style) showing the agent's reputation score. Em
 
 Badge shows score/100 with review count, color-coded: green (70+), yellow (40-69), red (<40), gray (no reviews). Cached for 5 minutes.
 
-### List feedback
+### List feedback (per agent)
 
 ```
-GET /api/feedback/:mint?network=mainnet&clientAddress=ADDR&tag1=starred&tag2=chat
+GET /api/feedback/:mint?network=mainnet&clientAddress=ADDR&tag1=starred&tag2=chat&outcome=2
 ```
 
+| Param | Type | Description |
+|-------|------|-------------|
+| `clientAddress` | string | Filter by reviewer address |
+| `tag1` | string | Filter by primary tag |
+| `tag2` | string | Filter by secondary tag |
+| `outcome` | number | Filter by outcome: 0 = Negative, 1 = Neutral, 2 = Positive |
+
 **Response:**
 
 ```json
 {
   "feedbacks": [
     {
+      "compressedAddress": "Attest...",
       "clientAddress": "Reviewer...",
+      "agentMint": "Agent...",
       "feedbackIndex": 0,
       "value": 87,
       "valueDecimals": 0,
       "tag1": "starred",
       "tag2": "chat",
+      "message": "Great response time",
       "endpoint": "https://...",
-      "reviewer": "",
       "outcome": 2,
+      "createdAt": 1709654400,
+      "schema": "FeedbackPublicV1",
       "isRevoked": false
     }
   ],
   "count": 1
 }
 ```
 
+### List feedback (global)
+
+```
+GET /api/feedback?network=mainnet&clientAddress=ADDR&tag1=starred&outcome=2
+```
+
+Same parameters and response as per-agent endpoint, but returns feedback across all agents. Useful for indexers and scoring providers.
+
 ### Submit feedback
 
 ```
@@ -161,3 +184,5 @@ Server acts as counterparty and pays transaction fees. Rate limited per IP.
 - Reputation is computed by averaging all feedback values (no weighting)
 - `outcome` values: 0 = Negative, 1 = Neutral, 2 = Positive
 - Agent IDs follow CAIP-2 format: `solana:{genesis_hash}:{mint_address}`
+- `createdAt` is a Unix timestamp (seconds), approximate based on Solana slot times
+- `schema` field indicates whether feedback is blind (`FeedbackV1`) or public (`FeedbackPublicV1`)

packages/sdk/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.15.0] - 2026-03-05
+
+### Added
+
+- **`outcome` filter** on `FeedbackSearchOptions` - filter feedback by `Outcome.Positive`, `Outcome.Negative`, or `Outcome.Neutral`
+
+### Changed
+
+- `listAllAgents()` now uses batched `loadAgents()` internally instead of N+1 individual `loadAgent()` calls
+
+### Fixed
+
+- `listAllAgents()` with large limits no longer hits rate limits on default hosted proxy
+
 ## [0.14.0] - 2026-03-05
 
 ### Changed

packages/sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cascade-fyi/sati-sdk",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "TypeScript SDK for SATI - Solana Agent Trust Infrastructure",
   "repository": {
     "type": "git",

packages/sdk/src/client.ts

@@ -1072,16 +1072,18 @@ export class Sati {
     // Batch fetch all AgentIndex accounts
     const indexes = await fetchAllMaybeAgentIndex(this.rpc, pdas);
 
-    // Load agent identities for existing indexes
-    const agents: AgentIdentity[] = [];
+    // Batch load agent identities for existing indexes
+    const existingMints: Address[] = [];
     for (const index of indexes) {
       if (index.exists) {
-        const agent = await this.loadAgent(index.data.mint);
-        if (agent) {
-          agents.push(agent);
-        }
+        existingMints.push(index.data.mint);
       }
     }
+    const loaded = existingMints.length > 0 ? await this.loadAgents(existingMints) : [];
+    const agents: AgentIdentity[] = [];
+    for (const agent of loaded) {
+      if (agent) agents.push(agent);
+    }
 
     return { agents, totalAgents: total };
   }
@@ -3005,6 +3007,7 @@ export class Sati {
 
       if (options?.tag1 !== undefined && tag1 !== options.tag1) continue;
       if (options?.tag2 !== undefined && tag2 !== options.tag2) continue;
+      if (options?.outcome !== undefined && item.data.outcome !== options.outcome) continue;
       if (options?.minValue !== undefined && (value === undefined || value < options.minValue)) continue;
       if (options?.maxValue !== undefined && (value === undefined || value > options.maxValue)) continue;
 

packages/sdk/src/convenience.ts

@@ -86,6 +86,8 @@ export interface FeedbackSearchOptions {
   tag1?: string;
   /** Filter by tag2 */
   tag2?: string;
+  /** Filter by outcome (Positive, Negative, Neutral) */
+  outcome?: Outcome;
   /** Minimum value (inclusive) */
   minValue?: number;
   /** Maximum value (inclusive) */