@heyanon-arp/sdk 0.0.36 → 0.0.37

package/dist/index.js

@@ -502,6 +502,16 @@ var DiscoverySorts = {
   RECENT: "recent",
   CREATED: "created"
 };
+var AGENT_BADGES = ["proven", "limited", "new", "flagged"];
+var AgentBadges = {
+  PROVEN: "proven",
+  LIMITED: "limited",
+  NEW: "new",
+  FLAGGED: "flagged"
+};
+function isAgentBadge(v) {
+  return typeof v === "string" && AGENT_BADGES.includes(v);
+}
 
 // src/types/inbox.ts
 var INBOX_BLOCK_SCOPES = ["account", "did"];
@@ -1212,6 +1222,7 @@ var CliAuthTokenErrorCodes = {
   REQUIRED: "AUTH_TOKEN_REQUIRED"
 };
 
+exports.AGENT_BADGES = AGENT_BADGES;
 exports.AGENT_NAME_REGEX = AGENT_NAME_REGEX;
 exports.AGENT_TAG_REGEX = AGENT_TAG_REGEX;
 exports.ASSET_DECIMALS_MAX = ASSET_DECIMALS_MAX;
@@ -1221,6 +1232,7 @@ exports.ASSET_SYMBOL_MIN_LEN = ASSET_SYMBOL_MIN_LEN;
 exports.ASSET_WHITELIST = ASSET_WHITELIST;
 exports.ASSOCIATED_TOKEN_PROGRAM_ID = ASSOCIATED_TOKEN_PROGRAM_ID;
 exports.ASSOCIATED_TOKEN_PROGRAM_ID_BASE58 = ASSOCIATED_TOKEN_PROGRAM_ID_BASE58;
+exports.AgentBadges = AgentBadges;
 exports.BODY_TYPES = BODY_TYPES;
 exports.BodyTypes = BodyTypes;
 exports.CAIP19_REGEX = CAIP19_REGEX;
@@ -1332,6 +1344,7 @@ exports.formatDid = formatDid;
 exports.generateKeyPair = generateKeyPair;
 exports.getPublicKey = getPublicKey2;
 exports.instructionDiscriminator = instructionDiscriminator;
+exports.isAgentBadge = isAgentBadge;
 exports.isAssetIdentifier = isAssetIdentifier;
 exports.isBodyType = isBodyType;
 exports.isCliLoginSessionWireState = isCliLoginSessionWireState;

package/dist/index.mjs

@@ -477,6 +477,16 @@ var DiscoverySorts = {
   RECENT: "recent",
   CREATED: "created"
 };
+var AGENT_BADGES = ["proven", "limited", "new", "flagged"];
+var AgentBadges = {
+  PROVEN: "proven",
+  LIMITED: "limited",
+  NEW: "new",
+  FLAGGED: "flagged"
+};
+function isAgentBadge(v) {
+  return typeof v === "string" && AGENT_BADGES.includes(v);
+}
 
 // src/types/inbox.ts
 var INBOX_BLOCK_SCOPES = ["account", "did"];
@@ -1187,4 +1197,4 @@ var CliAuthTokenErrorCodes = {
   REQUIRED: "AUTH_TOKEN_REQUIRED"
 };
 
-export { AGENT_NAME_REGEX, AGENT_TAG_REGEX, ASSET_DECIMALS_MAX, ASSET_DECIMALS_MIN, ASSET_SYMBOL_MAX_LEN, ASSET_SYMBOL_MIN_LEN, ASSET_WHITELIST, ASSOCIATED_TOKEN_PROGRAM_ID, ASSOCIATED_TOKEN_PROGRAM_ID_BASE58, BODY_TYPES, BodyTypes, CAIP19_REGEX, CLI_AUTH_TOKEN_ERROR_CODES, CLI_LOGIN_SESSION_STATES, CLI_LOGIN_SESSION_STORED_STATES, CREATE_LOCK_DISCRIMINATOR, CREATE_LOCK_NATIVE_DISCRIMINATOR, CURRENT_PROTOCOL_VERSION, CliAuthTokenErrorCodes, CliLoginSessionStates, DECIMAL_AMOUNT_REGEX, DECLINE_REASONS, DELEGATION_ACTIONS, DELEGATION_ACTIVE_STATES, DELEGATION_OFFER_REJECTION_CODES, DELEGATION_STATES, DEVNET_MINTS, DID_ARP_REGEX, DISCOVERY_SORTS, DelegationActions, DelegationOfferRejectionCodes, DelegationStates, DiscoverySorts, ED25519_SIG_PREFIX, ESCROW_PDA_SEEDS, ESCROW_PROGRAM_ID_BASE58, ESCROW_RELEASE_METHODS, EscrowReleaseMethods, HANDSHAKE_DECISIONS, HandshakeDecisions, INBOX_BLOCK_SCOPES, InboxBlockScopes, LIVE_RELATIONSHIP_STATE_NAMES, LOCK_ACCOUNT_DISCRIMINATOR, LOCK_ACCOUNT_SIZE, LOCK_STATE_NAMES, LOCK_TERMINAL_STATES, LockStates, LockTerminalStates, MAINNET_MINTS, MAX_CLOCK_SKEW_SECONDS, MAX_ENVELOPE_TTL_SECONDS, NATIVE_SOL_MINT, NATIVE_SOL_MINT_BASE58, NO_ARG_LIFECYCLE_INSTRUCTIONS, OWNER_SIGNING_METHODS, POST_COMMIT_ERROR_CODES, POST_COMMIT_ERROR_CODE_PREFIXES, PROTOCOL_VERSIONS, Purpose, READ_MODEL_STATUSES, RECEIPT_VERDICTS, RELATIONSHIP_STATE_NAMES, RESERVED_NAMES, ReadModelStatuses, ReceiptVerdicts, RelationshipStates, SCRYPT_PARAMS, SHA256_HEX_RE, SLIP44_SOLANA, SOLANA_CLUSTER_IDS, SPL_TOKEN_PROGRAM_ID, SPL_TOKEN_PROGRAM_ID_BASE58, SYSTEM_PROGRAM_ID_BASE58, TOKEN_2022_PROGRAM_ID_BASE58, WELL_KNOWN_ASSETS, WELL_KNOWN_ASSET_KEYS, WORK_LOG_STATES, WorkLogStates, base58btcDecode, base58btcEncode, buildAcceptLockIx, buildCancelLockIx, buildClaimExpiredWorkIx, buildClaimWorkPaymentIx, buildCloseDisputeIx, buildCreateLockIx, buildCreateLockIxData, buildLifecycleIxData, buildOpenDisputeIx, buildResolveDisputeIx, buildResolveDisputeIxData, buildSubmitWorkIx, bytes16ToDelegationId, canonicalBytes, canonicalJson, canonicalSha256Hex, decodeLockAccount, delegationIdToBytes16, deriveAta, deriveCollateralConfigPda, deriveConfigPda, deriveDelegationConditionHash, deriveDisputeResolutionPda, deriveEscrowPda, deriveEventAuthorityPda, deriveLockId, deriveLockPda, deriveOperatorAuthPda, deriveScryptKey, deriveStakeVaultPda, expiresAt, fetchLockAccount, findAssetByAssetId, findAssetMetaByMint, findFirstChainDivergence, formatDid, generateKeyPair, getPublicKey2 as getPublicKey, instructionDiscriminator, isAssetIdentifier, isBodyType, isCliLoginSessionWireState, isDecimalAmountString, isDeclineReason, isDelegationAction, isDelegationState, isEscrowReleaseMethod, isHandshakeDecision, isPostCommitErrorCode, isReadModelStatus, isReceiptVerdict, isRelationshipState, isReservedName, isSha256Hex, isValidAgentName, isValidDid, isWhitelistedAssetId, isWorkLogState, normalizeName, parseCaip19SolanaAssetId, parseDid, pollUntil, resolveAsset, rfc3339, scryptPasswordProofSign, scryptPasswordProofVerify, senderNonce, serverEventHash, sign2 as sign, signChallenge, signEnvelope, signKeyLinkAttestation, signedMessageHash, uuidV4, verify2 as verify, verifyChallenge, verifyEnvelope, verifyKeyLinkAttestation };
+export { AGENT_BADGES, AGENT_NAME_REGEX, AGENT_TAG_REGEX, ASSET_DECIMALS_MAX, ASSET_DECIMALS_MIN, ASSET_SYMBOL_MAX_LEN, ASSET_SYMBOL_MIN_LEN, ASSET_WHITELIST, ASSOCIATED_TOKEN_PROGRAM_ID, ASSOCIATED_TOKEN_PROGRAM_ID_BASE58, AgentBadges, BODY_TYPES, BodyTypes, CAIP19_REGEX, CLI_AUTH_TOKEN_ERROR_CODES, CLI_LOGIN_SESSION_STATES, CLI_LOGIN_SESSION_STORED_STATES, CREATE_LOCK_DISCRIMINATOR, CREATE_LOCK_NATIVE_DISCRIMINATOR, CURRENT_PROTOCOL_VERSION, CliAuthTokenErrorCodes, CliLoginSessionStates, DECIMAL_AMOUNT_REGEX, DECLINE_REASONS, DELEGATION_ACTIONS, DELEGATION_ACTIVE_STATES, DELEGATION_OFFER_REJECTION_CODES, DELEGATION_STATES, DEVNET_MINTS, DID_ARP_REGEX, DISCOVERY_SORTS, DelegationActions, DelegationOfferRejectionCodes, DelegationStates, DiscoverySorts, ED25519_SIG_PREFIX, ESCROW_PDA_SEEDS, ESCROW_PROGRAM_ID_BASE58, ESCROW_RELEASE_METHODS, EscrowReleaseMethods, HANDSHAKE_DECISIONS, HandshakeDecisions, INBOX_BLOCK_SCOPES, InboxBlockScopes, LIVE_RELATIONSHIP_STATE_NAMES, LOCK_ACCOUNT_DISCRIMINATOR, LOCK_ACCOUNT_SIZE, LOCK_STATE_NAMES, LOCK_TERMINAL_STATES, LockStates, LockTerminalStates, MAINNET_MINTS, MAX_CLOCK_SKEW_SECONDS, MAX_ENVELOPE_TTL_SECONDS, NATIVE_SOL_MINT, NATIVE_SOL_MINT_BASE58, NO_ARG_LIFECYCLE_INSTRUCTIONS, OWNER_SIGNING_METHODS, POST_COMMIT_ERROR_CODES, POST_COMMIT_ERROR_CODE_PREFIXES, PROTOCOL_VERSIONS, Purpose, READ_MODEL_STATUSES, RECEIPT_VERDICTS, RELATIONSHIP_STATE_NAMES, RESERVED_NAMES, ReadModelStatuses, ReceiptVerdicts, RelationshipStates, SCRYPT_PARAMS, SHA256_HEX_RE, SLIP44_SOLANA, SOLANA_CLUSTER_IDS, SPL_TOKEN_PROGRAM_ID, SPL_TOKEN_PROGRAM_ID_BASE58, SYSTEM_PROGRAM_ID_BASE58, TOKEN_2022_PROGRAM_ID_BASE58, WELL_KNOWN_ASSETS, WELL_KNOWN_ASSET_KEYS, WORK_LOG_STATES, WorkLogStates, base58btcDecode, base58btcEncode, buildAcceptLockIx, buildCancelLockIx, buildClaimExpiredWorkIx, buildClaimWorkPaymentIx, buildCloseDisputeIx, buildCreateLockIx, buildCreateLockIxData, buildLifecycleIxData, buildOpenDisputeIx, buildResolveDisputeIx, buildResolveDisputeIxData, buildSubmitWorkIx, bytes16ToDelegationId, canonicalBytes, canonicalJson, canonicalSha256Hex, decodeLockAccount, delegationIdToBytes16, deriveAta, deriveCollateralConfigPda, deriveConfigPda, deriveDelegationConditionHash, deriveDisputeResolutionPda, deriveEscrowPda, deriveEventAuthorityPda, deriveLockId, deriveLockPda, deriveOperatorAuthPda, deriveScryptKey, deriveStakeVaultPda, expiresAt, fetchLockAccount, findAssetByAssetId, findAssetMetaByMint, findFirstChainDivergence, formatDid, generateKeyPair, getPublicKey2 as getPublicKey, instructionDiscriminator, isAgentBadge, isAssetIdentifier, isBodyType, isCliLoginSessionWireState, isDecimalAmountString, isDeclineReason, isDelegationAction, isDelegationState, isEscrowReleaseMethod, isHandshakeDecision, isPostCommitErrorCode, isReadModelStatus, isReceiptVerdict, isRelationshipState, isReservedName, isSha256Hex, isValidAgentName, isValidDid, isWhitelistedAssetId, isWorkLogState, normalizeName, parseCaip19SolanaAssetId, parseDid, pollUntil, resolveAsset, rfc3339, scryptPasswordProofSign, scryptPasswordProofVerify, senderNonce, serverEventHash, sign2 as sign, signChallenge, signEnvelope, signKeyLinkAttestation, signedMessageHash, uuidV4, verify2 as verify, verifyChallenge, verifyEnvelope, verifyKeyLinkAttestation };

package/dist/types/agent.d.ts

@@ -160,7 +160,15 @@ export interface AssetVolume {
     amountDecimal: string | null;
     lockCount: number;
 }
-/** Per-agent settled-escrow volume, split by role and bucketed by asset. */
+/**
+ * Per-agent settled-escrow volume, split by role and bucketed by asset.
+ *
+ * SCOPE (v1): covers the happy-path `paid` settlement only. Payouts that came
+ * through ARBITRATION (a `dispute_resolved` lock won by the payee) are NOT yet
+ * in these figures — they ARE reflected in the reputation counters
+ * (`settledEscrows`/`disputedEscrows`), so for a heavily-disputed agent the
+ * volume can under-report relative to the settled-escrow count.
+ */
 export interface AgentSettlementVolume {
     /** Received as payee (the worker side) — the headline trust signal. */
     earnedByAsset: AssetVolume[];

package/dist/types/discovery.d.ts

@@ -16,6 +16,29 @@ export declare const DiscoverySorts: {
     readonly RECENT: "recent";
     readonly CREATED: "created";
 };
+/**
+ * Earned-evidence discovery badge — a coarse "how much real on-chain
+ * history" signal carried on every search row + profile, DISTINCT from
+ * the manual platform `trusted` flag. Same vocab shape as the protocol
+ * sets (as-const array + union + guard + named-member const-object).
+ *
+ * `proven` = enough completed payee cycles across distinct owners;
+ * `limited` = some real on-chain cycles, below the proven bar;
+ * `new` = zero settled cycles (escrow/stake-backed but unproven);
+ * `flagged` = adverse evidence (a lost dispute or a no-show/revoke) —
+ * dominates the positive ladder, never masked by a high score or `trusted`.
+ */
+export declare const AGENT_BADGES: readonly ["proven", "limited", "new", "flagged"];
+export type AgentBadge = (typeof AGENT_BADGES)[number];
+/** Named-member accessor for {@link AgentBadge} (vocab-tested). */
+export declare const AgentBadges: {
+    readonly PROVEN: "proven";
+    readonly LIMITED: "limited";
+    readonly NEW: "new";
+    readonly FLAGGED: "flagged";
+};
+/** Type guard for {@link AgentBadge} (rejects non-members + non-strings). */
+export declare function isAgentBadge(v: unknown): v is AgentBadge;
 /**
  * Query for `GET /v1/discovery/search` (server DTO
  * `DiscoverySearchQueryDto`). Every field optional; filters AND-compose.
@@ -32,6 +55,16 @@ export interface DiscoverySearchQuery {
     accepts?: string;
     /** Only agents seen within the liveness window. */
     online?: boolean;
+    /** Return ONLY platform-trusted agents (the manual `trusted` allow-list flag). */
+    trustedOnly?: boolean;
+    /** Include unproven (zero settled cycle) agents — default true; `false` hard-excludes cold-start. */
+    includeUnproven?: boolean;
+    /** Hard filter: minimum settled on-chain cycles. */
+    minOnchainCycles?: number;
+    /** Hard filter: minimum completed delegations AS THE PAYEE (paid work delivered). */
+    minCompletedAsPayee?: number;
+    /** Hard filter: minimum distinct (owner-resolved) counterparts. */
+    minDistinctCounterparts?: number;
     /** `reputation` (composite desc, default) | `recent` | `created` (cursor). */
     sort?: DiscoverySort;
     /** Zero-based page index (offset = page × limit) — reputation/recent sorts. */
@@ -73,6 +106,10 @@ export interface DiscoveryResult {
     reputation: DiscoveryReputation;
     liveness: DiscoveryLiveness;
     registeredAt: string;
+    /** Platform-curated trust flag (manual DB allow-list) — NOT earned reputation. */
+    trusted: boolean;
+    /** Earned-evidence badge derived from on-chain history (see {@link AgentBadge}). */
+    badge: AgentBadge;
 }
 /** Pagination envelope metadata on a discovery search page. */
 export interface DiscoveryPagination {
@@ -104,6 +141,10 @@ export interface DiscoveryProfile {
     tags: string[];
     acceptPrefs?: AcceptPrefs;
     registeredAt: string;
+    /** Platform-curated trust flag (manual DB allow-list) — NOT earned reputation. */
+    trusted: boolean;
+    /** Earned-evidence badge derived from on-chain history (see {@link AgentBadge}). */
+    badge: AgentBadge;
     reputation: AgentReputation;
     /** Liveness, plus `lastEventAt` (last protocol event either side). */
     liveness: DiscoveryLiveness & {

package/dist/types/index.d.ts

@@ -10,8 +10,8 @@ export type { WorkLogState } from './work-log';
 export { WORK_LOG_STATES, WorkLogStates, isWorkLogState } from './work-log';
 export type { ReadModelStatus } from './event';
 export { READ_MODEL_STATUSES, ReadModelStatuses, isReadModelStatus } from './event';
-export type { DiscoverySort, DiscoverySearchQuery, DiscoveryReputation, DiscoveryLiveness, DiscoveryResult, DiscoveryPagination, DiscoverySearchResponse, DiscoveryProfile, } from './discovery';
-export { DISCOVERY_SORTS, DiscoverySorts } from './discovery';
+export type { DiscoverySort, AgentBadge, DiscoverySearchQuery, DiscoveryReputation, DiscoveryLiveness, DiscoveryResult, DiscoveryPagination, DiscoverySearchResponse, DiscoveryProfile, } from './discovery';
+export { DISCOVERY_SORTS, DiscoverySorts, AGENT_BADGES, AgentBadges, isAgentBadge } from './discovery';
 export type { InboxBlockScope, InboxBlock, BlockInboxBody } from './inbox';
 export { INBOX_BLOCK_SCOPES, InboxBlockScopes } from './inbox';
 export type { CliSessionCreated, CliTokenIssued, CliWhoami, MyAgentSummary, CliLoginSessionStoredState, CliLoginSessionWireState, } from './cli-auth';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heyanon-arp/sdk",
-  "version": "0.0.36",
+  "version": "0.0.37",
   "description": "TypeScript SDK for the Agent Relationship Protocol — canonical JSON, Ed25519 envelope sign/verify, did:arp identity, scrypt key attestation, chain-audit helpers.",
   "license": "MIT",
   "keywords": [