@cascade-fyi/sati-sdk 0.7.0 → 0.9.0

package/CHANGELOG.md

@@ -5,6 +5,32 @@ 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.9.0] - 2026-02-12
+
+### Breaking Changes
+
+- **`MAX_SINGLE_SIGNATURE_CONTENT_SIZE` replaced** with two mode-specific constants:
+  - `MAX_COUNTERPARTY_SIGNED_CONTENT_SIZE` (100 bytes) - CounterpartySigned mode has SIWS content duplication
+  - `MAX_AGENT_OWNER_SIGNED_CONTENT_SIZE` (240 bytes) - AgentOwnerSigned mode has no SIWS duplication
+- `getMaxContentSize()` and `validateContentSize()` now return correct per-mode limits
+
+### Fixed
+
+- **`getAgentOwner` returns stale/empty data after registration or transfer** - added retry with exponential backoff to handle SPL token index lag on RPC node pools
+
+## [0.8.0] - 2026-02-12
+
+### Breaking Changes
+
+- **Feedback content fields renamed for ERC-8004 alignment**: `score` -> `value`, `tags` -> `tag1`/`tag2`, added `valueDecimals`
+  - `GiveFeedbackParams`: `score?` -> `value?`, `tags?` -> `tag1?`/`tag2?`, added `valueDecimals?`
+  - `ParsedFeedback`: `score?` -> `value?`, `tags` -> `tag1?`/`tag2?`, added `valueDecimals?`
+  - `FeedbackSearchOptions`: `minScore`/`maxScore` -> `minValue`/`maxValue`, `tags?` -> `tag1?`/`tag2?`
+  - `ReputationSummary`: `averageScore` -> `averageValue`
+  - `FeedbackContent`: `score?` -> `value?`, `tags?` -> `tag1?`/`tag2?`, added `valueDecimals?`
+- **`getReputationSummary` signature changed**: `(agentMint, tags?)` -> `(agentMint, tag1?, tag2?)`
+- **Registration file fields renamed**: `endpoints` -> `services`, `x402support` -> `x402Support`
+
 ## [0.7.0] - 2026-02-12
 
 ### Added
@@ -144,6 +170,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Compressed attestation storage via Light Protocol
 - Basic querying via Photon RPC
 
+[0.9.0]: https://github.com/cascade-protocol/sati/compare/@cascade-fyi/sati-sdk@0.8.0...@cascade-fyi/sati-sdk@0.9.0
+[0.8.0]: https://github.com/cascade-protocol/sati/compare/@cascade-fyi/sati-sdk@0.7.0...@cascade-fyi/sati-sdk@0.8.0
 [0.7.0]: https://github.com/cascade-protocol/sati/compare/@cascade-fyi/sati-sdk@0.6.0...@cascade-fyi/sati-sdk@0.7.0
 [0.6.0]: https://github.com/cascade-protocol/sati/compare/@cascade-fyi/sati-sdk@0.5.0...@cascade-fyi/sati-sdk@0.6.0
 [0.5.0]: https://github.com/cascade-protocol/sati/compare/@cascade-fyi/sati-sdk@0.4.2...@cascade-fyi/sati-sdk@0.5.0

package/dist/index.cjs

@@ -2872,13 +2872,24 @@ const MAX_CONTENT_SIZE = 512;
 */
 const MAX_DUAL_SIGNATURE_CONTENT_SIZE = 70;
 /**
-* Maximum content size for SingleSignature mode attestations.
+* Maximum content size for CounterpartySigned mode attestations.
 *
-* SingleSignature mode has more headroom because:
-* 1. Content appears only once (no SIWS message duplication)
+* CounterpartySigned has a SIWS message containing the content, so content
+* appears TWICE in the transaction (data blob + SIWS Details field).
+* This is similar to DualSignature but with one fewer signature (no agent sig),
+* giving slightly more headroom.
+*
+* Use ContentType.IPFS or ContentType.Arweave for larger content.
+*/
+const MAX_COUNTERPARTY_SIGNED_CONTENT_SIZE = 100;
+/**
+* Maximum content size for AgentOwnerSigned mode attestations.
+*
+* AgentOwnerSigned has more headroom because:
+* 1. Content appears only once (no SIWS message - agent signs interaction_hash)
 * 2. No counterparty signature verification overhead
 */
-const MAX_SINGLE_SIGNATURE_CONTENT_SIZE = 240;
+const MAX_AGENT_OWNER_SIGNED_CONTENT_SIZE = 240;
 /**
 * Minimum universal base layout size.
 * All schemas share: layout_version(1) + task_ref(32) + agent_mint(32) + counterparty(32) +
@@ -2937,17 +2948,17 @@ let DataType = /* @__PURE__ */ function(DataType$1) {
 /**
 * Feedback outcome values (ERC-8004 compatible)
 *
-* For ERC-8004 score mapping:
-* - Negative(0) → 0
-* - Neutral(1) → 50
-* - Positive(2) → 100
+* Maps to ERC-8004 outcome semantics:
+* - Negative(0) - unfavorable interaction
+* - Neutral(1) - default / no strong signal
+* - Positive(2) - favorable interaction
 */
 let Outcome = /* @__PURE__ */ function(Outcome$1) {
-	/** Negative feedback (score 0) */
+	/** Negative feedback */
 	Outcome$1[Outcome$1["Negative"] = 0] = "Negative";
-	/** Neutral feedback (score 50) */
+	/** Neutral feedback (default) */
 	Outcome$1[Outcome$1["Neutral"] = 1] = "Neutral";
-	/** Positive feedback (score 100) */
+	/** Positive feedback */
 	Outcome$1[Outcome$1["Positive"] = 2] = "Positive";
 	return Outcome$1;
 }({});
@@ -3316,7 +3327,11 @@ function validateBaseLayout(data) {
 * ```
 */
 function getMaxContentSize(signatureMode) {
-	return signatureMode === SignatureMode.DualSignature ? MAX_DUAL_SIGNATURE_CONTENT_SIZE : MAX_SINGLE_SIGNATURE_CONTENT_SIZE;
+	switch (signatureMode) {
+		case SignatureMode.DualSignature: return MAX_DUAL_SIGNATURE_CONTENT_SIZE;
+		case SignatureMode.CounterpartySigned: return MAX_COUNTERPARTY_SIGNED_CONTENT_SIZE;
+		case SignatureMode.AgentOwnerSigned: return MAX_AGENT_OWNER_SIGNED_CONTENT_SIZE;
+	}
 }
 /**
 * Validate content size for a given signature mode.
@@ -3350,7 +3365,11 @@ function validateContentSize(content, signatureMode, options = {}) {
 		actualSize
 	};
 	if (!valid) {
-		result.error = `Content too large for ${signatureMode === SignatureMode.DualSignature ? "DualSignature" : "SingleSignature"} mode: ${actualSize} bytes exceeds maximum ${maxSize} bytes. Use ContentType.IPFS or ContentType.Arweave for larger content.`;
+		result.error = `Content too large for ${{
+			[SignatureMode.DualSignature]: "DualSignature",
+			[SignatureMode.CounterpartySigned]: "CounterpartySigned",
+			[SignatureMode.AgentOwnerSigned]: "AgentOwnerSigned"
+		}[signatureMode] ?? "Unknown"} mode: ${actualSize} bytes exceeds maximum ${maxSize} bytes. Use ContentType.IPFS or ContentType.Arweave for larger content.`;
 		if (throwOnError) throw new Error(result.error);
 	}
 	return result;
@@ -4323,7 +4342,7 @@ function bytesToHex(bytes) {
 *   outcome: Outcome.Positive,
 *   dataHash: dataHash,
 *   contentType: ContentType.JSON,
-*   content: new TextEncoder().encode('{"score": 95, "tags": ["fast"]}'),
+*   content: new TextEncoder().encode('{"value": 95, "valueDecimals": 0, "tag1": "quality"}'),
 * });
 *
 * // Build counterparty message
@@ -4842,11 +4861,11 @@ const RegistrationFileSchema = zod.object({
 	image: zod.url(),
 	properties: PropertiesSchema,
 	external_url: zod.url().optional(),
-	endpoints: zod.array(EndpointSchema).optional(),
+	services: zod.array(EndpointSchema).optional(),
 	registrations: zod.array(RegistrationEntrySchema).optional(),
 	supportedTrust: zod.array(TrustMechanismSchema).optional(),
 	active: zod.boolean().optional().default(true),
-	x402support: zod.boolean().optional()
+	x402Support: zod.boolean().optional()
 });
 const MIME_TYPES = {
 	png: "image/png",
@@ -4889,11 +4908,11 @@ function buildRegistrationFile(params) {
 			category: "image"
 		},
 		...params.externalUrl && { external_url: params.externalUrl },
-		...params.endpoints?.length && { endpoints: params.endpoints },
+		...params.services?.length && { services: params.services },
 		...params.registrations?.length && { registrations: params.registrations },
 		...params.supportedTrust?.length && { supportedTrust: params.supportedTrust },
 		active: params.active ?? true,
-		...params.x402support !== void 0 && { x402support: params.x402support }
+		...params.x402Support !== void 0 && { x402Support: params.x402Support }
 	};
 	return RegistrationFileSchema.parse(file);
 }
@@ -5029,7 +5048,7 @@ var SatiAgentBuilder = class {
 			name,
 			description,
 			image,
-			endpoints: [],
+			services: [],
 			active: true
 		};
 	}
@@ -5043,9 +5062,9 @@ var SatiAgentBuilder = class {
 	}
 	/** Set a generic endpoint. */
 	setEndpoint(endpoint) {
-		if (!this._params.endpoints) this._params.endpoints = [];
-		this._params.endpoints = this._params.endpoints.filter((ep) => ep.name !== endpoint.name);
-		this._params.endpoints.push(endpoint);
+		if (!this._params.services) this._params.services = [];
+		this._params.services = this._params.services.filter((ep) => ep.name !== endpoint.name);
+		this._params.services.push(endpoint);
 		return this;
 	}
 	/**
@@ -5082,7 +5101,7 @@ var SatiAgentBuilder = class {
 	}
 	/** Remove an endpoint by name. */
 	removeEndpoint(name) {
-		if (this._params.endpoints) this._params.endpoints = this._params.endpoints.filter((ep) => ep.name !== name);
+		if (this._params.services) this._params.services = this._params.services.filter((ep) => ep.name !== name);
 		return this;
 	}
 	/** Set agent active status. */
@@ -5092,7 +5111,7 @@ var SatiAgentBuilder = class {
 	}
 	/** Set x402 payment support. */
 	setX402Support(x402) {
-		this._params.x402support = x402;
+		this._params.x402Support = x402;
 		return this;
 	}
 	/** Set supported trust mechanisms. */
@@ -5503,14 +5522,21 @@ var Sati = class {
 		return { signature: (0, __solana_kit.getSignatureFromTransaction)(signedTx).toString() };
 	}
 	/**
-	* Get current owner of an agent
+	* Get current owner of an agent.
+	*
+	* Uses `getTokenLargestAccounts` which relies on an SPL token index.
+	* This index can lag behind transaction confirmation on RPC node pools,
+	* so we retry with backoff for recently created or transferred tokens.
 	*/
 	async getAgentOwner(mint) {
-		const response = await this.rpc.getTokenLargestAccounts(mint, { commitment: "confirmed" }).send();
-		if (!response.value || response.value.length === 0) throw new Error(`No token accounts found for mint ${mint}`);
-		const holderAccount = response.value.find((acc) => BigInt(acc.amount) > 0n);
-		if (!holderAccount) throw new Error(`No holder found for agent ${mint}`);
-		return (await (0, __solana_program_token_2022.fetchToken)(this.rpc, (0, __solana_kit.address)(holderAccount.address))).data.owner;
+		const maxRetries = 3;
+		const baseDelay = 500;
+		for (let attempt = 0; attempt <= maxRetries; attempt++) {
+			const holderAccount = (await this.rpc.getTokenLargestAccounts(mint, { commitment: "confirmed" }).send()).value?.find((acc) => BigInt(acc.amount) > 0n);
+			if (holderAccount) return (await (0, __solana_program_token_2022.fetchToken)(this.rpc, (0, __solana_kit.address)(holderAccount.address))).data.owner;
+			if (attempt < maxRetries) await new Promise((resolve) => setTimeout(resolve, baseDelay * 2 ** attempt));
+		}
+		throw new Error(`No token accounts found for mint ${mint}`);
 	}
 	/**
 	* Get registry statistics
@@ -6447,8 +6473,9 @@ var Sati = class {
 	* const result = await sati.giveFeedback({
 	*   payer: myKeypair,
 	*   agentMint: address("Agent..."),
-	*   score: 85,
-	*   tags: ["quality", "speed"],
+	*   value: 87,
+	*   valueDecimals: 0,
+	*   tag1: "starred",
 	*   message: "Great response time",
 	* });
 	* ```
@@ -6456,10 +6483,13 @@ var Sati = class {
 	async giveFeedback(params) {
 		const schema = this._requireFeedbackPublicSchema();
 		const payer = params.payer;
-		if (params.score !== void 0 && (!Number.isFinite(params.score) || params.score < 0 || params.score > 100)) throw new Error(`Feedback score must be a finite number between 0 and 100, got: ${params.score}`);
+		if (params.value !== void 0 && !Number.isFinite(params.value)) throw new Error(`Feedback value must be a finite number, got: ${params.value}`);
+		if (params.valueDecimals !== void 0 && (params.valueDecimals < 0 || params.valueDecimals > 18)) throw new Error(`valueDecimals must be 0-18, got: ${params.valueDecimals}`);
 		const contentObj = {};
-		if (params.score !== void 0) contentObj.score = params.score;
-		if (params.tags?.length) contentObj.tags = params.tags;
+		if (params.value !== void 0) contentObj.value = params.value;
+		if (params.valueDecimals !== void 0) contentObj.valueDecimals = params.valueDecimals;
+		if (params.tag1) contentObj.tag1 = params.tag1;
+		if (params.tag2) contentObj.tag2 = params.tag2;
 		if (params.endpoint) contentObj.endpoint = params.endpoint;
 		if (params.message) contentObj.m = params.message;
 		const content = Object.keys(contentObj).length > 0 ? new TextEncoder().encode(JSON.stringify(contentObj)) : new Uint8Array(0);
@@ -6510,10 +6540,13 @@ var Sati = class {
 	*/
 	async prepareFeedback(params) {
 		const schema = this._requireFeedbackPublicSchema();
-		if (params.score !== void 0 && (!Number.isFinite(params.score) || params.score < 0 || params.score > 100)) throw new Error(`Feedback score must be a finite number between 0 and 100, got: ${params.score}`);
+		if (params.value !== void 0 && !Number.isFinite(params.value)) throw new Error(`Feedback value must be a finite number, got: ${params.value}`);
+		if (params.valueDecimals !== void 0 && (params.valueDecimals < 0 || params.valueDecimals > 18)) throw new Error(`valueDecimals must be 0-18, got: ${params.valueDecimals}`);
 		const contentObj = {};
-		if (params.score !== void 0) contentObj.score = params.score;
-		if (params.tags?.length) contentObj.tags = params.tags;
+		if (params.value !== void 0) contentObj.value = params.value;
+		if (params.valueDecimals !== void 0) contentObj.valueDecimals = params.valueDecimals;
+		if (params.tag1) contentObj.tag1 = params.tag1;
+		if (params.tag2) contentObj.tag2 = params.tag2;
 		if (params.endpoint) contentObj.endpoint = params.endpoint;
 		if (params.message) contentObj.m = params.message;
 		const content = Object.keys(contentObj).length > 0 ? new TextEncoder().encode(JSON.stringify(contentObj)) : new Uint8Array(0);
@@ -6544,8 +6577,10 @@ var Sati = class {
 			sasSchema: schema,
 			lookupTable: this._deployedConfig?.lookupTable,
 			meta: {
-				score: params.score,
-				tags: params.tags ? [...params.tags] : void 0,
+				value: params.value,
+				valueDecimals: params.valueDecimals,
+				tag1: params.tag1,
+				tag2: params.tag2,
 				message: params.message,
 				endpoint: params.endpoint
 			}
@@ -6611,8 +6646,8 @@ var Sati = class {
 	* ```typescript
 	* const feedbacks = await sati.searchFeedback({
 	*   agentMint: address("Agent..."),
-	*   tags: ["quality"],
-	*   minScore: 70,
+	*   tag1: "starred",
+	*   minValue: 70,
 	* });
 	* ```
 	*/
@@ -6631,15 +6666,16 @@ var Sati = class {
 		const feedbacks = [];
 		for (const item of result.items) {
 			const rawContent = this._parseContentJson(item.data.content, item.data.contentType);
-			const score = rawContent?.score;
-			const tags = rawContent?.tags ?? [];
+			const value = rawContent?.value;
+			const valueDecimals = rawContent?.valueDecimals;
+			const tag1 = rawContent?.tag1;
+			const tag2 = rawContent?.tag2;
 			const message = rawContent?.m;
 			const endpoint = rawContent?.endpoint;
-			if (options?.tags?.length) {
-				if (!options.tags.every((t) => tags.includes(t))) continue;
-			}
-			if (options?.minScore !== void 0 && (score === void 0 || score < options.minScore)) continue;
-			if (options?.maxScore !== void 0 && (score === void 0 || score > options.maxScore)) continue;
+			if (options?.tag1 !== void 0 && tag1 !== options.tag1) continue;
+			if (options?.tag2 !== void 0 && tag2 !== options.tag2) continue;
+			if (options?.minValue !== void 0 && (value === void 0 || value < options.minValue)) continue;
+			if (options?.maxValue !== void 0 && (value === void 0 || value > options.maxValue)) continue;
 			const slotDiff = Number(BigInt(currentSlot) - item.raw.slotCreated);
 			const createdAt = nowSec - Math.floor(slotDiff * .4);
 			const [compressedAddress] = (0, __solana_kit.getAddressDecoder)().read(item.address, 0);
@@ -6648,8 +6684,10 @@ var Sati = class {
 				agentMint: item.data.agentMint,
 				counterparty: item.data.counterparty,
 				outcome: item.data.outcome,
-				score,
-				tags,
+				value,
+				valueDecimals,
+				tag1,
+				tag2,
 				message,
 				endpoint,
 				createdAt
@@ -6675,15 +6713,15 @@ var Sati = class {
 	/**
 	* Get reputation summary for an agent.
 	*
-	* Aggregates feedback scores, optionally filtered by tags.
+	* Aggregates feedback values, optionally filtered by tag1 and/or tag2.
 	*
 	* @example
 	* ```typescript
 	* const summary = await sati.getReputationSummary(address("Agent..."));
-	* console.log(`${summary.count} reviews, avg ${summary.averageScore}`);
+	* console.log(`${summary.count} reviews, avg ${summary.averageValue}`);
 	* ```
 	*/
-	async getReputationSummary(agentMint, tags) {
+	async getReputationSummary(agentMint, tag1, tag2) {
 		const schema = this._deployedConfig?.schemas.feedbackPublic ?? this._deployedConfig?.schemas.feedback;
 		if (!schema) throw new Error(`No feedback schema deployed for network "${this.network}"`);
 		const cacheKey = FeedbackCache.cacheKey(schema, agentMint);
@@ -6695,23 +6733,25 @@ var Sati = class {
 		if (!cached) this._feedbackCache.set(cacheKey, result);
 		if (result.items.length === 0) return {
 			count: 0,
-			averageScore: 0
+			averageValue: 0
 		};
 		let sum = 0;
 		let count = 0;
 		for (const item of result.items) {
 			const rawContent = this._parseContentJson(item.data.content, item.data.contentType);
-			const score = rawContent?.score;
-			const itemTags = rawContent?.tags ?? [];
-			if (tags?.length && !tags.every((t) => itemTags.includes(t))) continue;
-			if (score !== void 0) {
-				sum += score;
+			const value = rawContent?.value;
+			const itemTag1 = rawContent?.tag1;
+			const itemTag2 = rawContent?.tag2;
+			if (tag1 !== void 0 && itemTag1 !== tag1) continue;
+			if (tag2 !== void 0 && itemTag2 !== tag2) continue;
+			if (value !== void 0) {
+				sum += value;
 				count++;
 			}
 		}
 		return {
 			count,
-			averageScore: count > 0 ? sum / count : 0
+			averageValue: count > 0 ? sum / count : 0
 		};
 	}
 	/**
@@ -6777,10 +6817,10 @@ var Sati = class {
 		for (let i = 0; i < agents.length; i++) {
 			const identity = agents[i];
 			const regFile = regFiles[i];
-			const endpoints = regFile?.endpoints ?? [];
+			const services = regFile?.services ?? [];
 			if (options?.active !== void 0 && (regFile?.active ?? true) !== options.active) continue;
 			if (options?.endpointTypes?.length) {
-				if (!options.endpointTypes.every((type) => endpoints.some((e) => e.name.toUpperCase() === type.toUpperCase()))) continue;
+				if (!options.endpointTypes.every((type) => services.some((e) => e.name.toUpperCase() === type.toUpperCase()))) continue;
 			}
 			filtered.push({
 				identity,
@@ -7030,10 +7070,11 @@ exports.FeedbackCache = FeedbackCache;
 exports.INITIALIZE_DISCRIMINATOR = INITIALIZE_DISCRIMINATOR;
 exports.LIGHT_ERROR_CODES = LIGHT_ERROR_CODES;
 exports.LINK_EVM_ADDRESS_DISCRIMINATOR = LINK_EVM_ADDRESS_DISCRIMINATOR;
+exports.MAX_AGENT_OWNER_SIGNED_CONTENT_SIZE = MAX_AGENT_OWNER_SIGNED_CONTENT_SIZE;
 exports.MAX_CONTENT_SIZE = MAX_CONTENT_SIZE;
+exports.MAX_COUNTERPARTY_SIGNED_CONTENT_SIZE = MAX_COUNTERPARTY_SIGNED_CONTENT_SIZE;
 exports.MAX_DUAL_SIGNATURE_CONTENT_SIZE = MAX_DUAL_SIGNATURE_CONTENT_SIZE;
 exports.MAX_PLAINTEXT_SIZE = MAX_PLAINTEXT_SIZE;
-exports.MAX_SINGLE_SIGNATURE_CONTENT_SIZE = MAX_SINGLE_SIGNATURE_CONTENT_SIZE;
 exports.MIN_BASE_LAYOUT_SIZE = MIN_BASE_LAYOUT_SIZE;
 exports.MIN_ENCRYPTED_SIZE = MIN_ENCRYPTED_SIZE;
 exports.NONCE_SIZE = NONCE_SIZE;