@tetsuo-ai/marketplace-react 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/CHANGELOG.md +29 -3
  2. package/README.md +50 -20
  3. package/dist/{chunk-ABS77JB2.js → chunk-D2TDU3TJ.js} +3 -3
  4. package/dist/{chunk-ABS77JB2.js.map → chunk-D2TDU3TJ.js.map} +1 -1
  5. package/dist/{chunk-GN5DYVN5.js → chunk-ECU7HGO3.js} +6 -5
  6. package/dist/chunk-ECU7HGO3.js.map +1 -0
  7. package/dist/{chunk-YORZNYZZ.js → chunk-FAIRTAIB.js} +53 -17
  8. package/dist/chunk-FAIRTAIB.js.map +1 -0
  9. package/dist/{chunk-5OTKSRHM.js → chunk-MNJ2EQDJ.js} +3 -3
  10. package/dist/{chunk-5OTKSRHM.js.map → chunk-MNJ2EQDJ.js.map} +1 -1
  11. package/dist/{chunk-KJMR6OGC.js → chunk-WJUVTFJ7.js} +105 -9
  12. package/dist/chunk-WJUVTFJ7.js.map +1 -0
  13. package/dist/components/agenc-components.css +20 -0
  14. package/dist/components/index.cjs +147 -17
  15. package/dist/components/index.cjs.map +1 -1
  16. package/dist/components/index.d.cts +2 -2
  17. package/dist/components/index.d.ts +2 -2
  18. package/dist/components/index.js +3 -3
  19. package/dist/hooks/index.cjs +350 -28
  20. package/dist/hooks/index.cjs.map +1 -1
  21. package/dist/hooks/index.d.cts +160 -36
  22. package/dist/hooks/index.d.ts +160 -36
  23. package/dist/hooks/index.js +299 -19
  24. package/dist/hooks/index.js.map +1 -1
  25. package/dist/{index-BLrlBVj-.d.cts → index-C9R3B80j.d.ts} +176 -47
  26. package/dist/{index-CKTYsNPH.d.ts → index-CTTh1ZPg.d.cts} +176 -47
  27. package/dist/index.cjs +168 -33
  28. package/dist/index.cjs.map +1 -1
  29. package/dist/index.d.cts +10 -19
  30. package/dist/index.d.ts +10 -19
  31. package/dist/index.js +17 -12
  32. package/dist/index.js.map +1 -1
  33. package/dist/signers/index.cjs +4 -3
  34. package/dist/signers/index.cjs.map +1 -1
  35. package/dist/signers/index.js +2 -2
  36. package/dist/{useAgentTrackRecord-BLf1nrbu.d.cts → useAgentTrackRecord-BCvRHYM2.d.cts} +7 -7
  37. package/dist/{useAgentTrackRecord-BLf1nrbu.d.ts → useAgentTrackRecord-BCvRHYM2.d.ts} +7 -7
  38. package/package.json +4 -3
  39. package/src/components/HireButton.tsx +1 -2
  40. package/src/components/HireCheckoutModal.tsx +8 -9
  41. package/src/components/ProviderCard.stories.tsx +54 -4
  42. package/src/components/ProviderCard.tsx +113 -9
  43. package/src/components/ReferrerDisclosure.tsx +8 -12
  44. package/src/components/__fixtures__/index.tsx +28 -0
  45. package/src/components/agenc-components.css +20 -0
  46. package/src/components/index.ts +12 -0
  47. package/src/components/strings.ts +10 -2
  48. package/src/components/useAgentVerification.ts +223 -0
  49. package/src/hooks/index.ts +47 -4
  50. package/src/hooks/internal.ts +74 -2
  51. package/src/hooks/useHire.ts +30 -38
  52. package/src/hooks/useHumanlessHireFlow.ts +259 -0
  53. package/src/hooks/useRateHire.ts +52 -0
  54. package/src/hooks/useReferrerEarnings.ts +32 -33
  55. package/src/hooks/useTaskActivation.ts +58 -0
  56. package/src/hooks/useTaskLifecycle.ts +110 -0
  57. package/src/hooks/useTaskWork.ts +76 -0
  58. package/src/index.ts +12 -2
  59. package/src/provider/AgencProvider.tsx +3 -3
  60. package/src/provider/referrer.ts +24 -32
  61. package/src/strings/index.ts +5 -3
  62. package/src/types.ts +7 -10
  63. package/dist/chunk-GN5DYVN5.js.map +0 -1
  64. package/dist/chunk-KJMR6OGC.js.map +0 -1
  65. package/dist/chunk-YORZNYZZ.js.map +0 -1
@@ -1,7 +1,7 @@
1
1
  import { ReactNode, ButtonHTMLAttributes, HTMLAttributes, RefObject } from 'react';
2
- import { ListActiveListingsOptions, DecodedProgramAccount, ServiceListing, IndexerListing, IndexerHire, IndexerAgentTrackRecord, MarketplaceClient, ProgramAccountsTransport, CreateIndexerClientOptions, TaskStatus } from '@tetsuo-ai/marketplace-sdk';
2
+ import { ListActiveListingsOptions, DecodedProgramAccount, ServiceListing, IndexerListing, IndexerHire, IndexerAgentTrackRecord, MarketplaceClient, ProgramAccountsTransport, CreateIndexerClientOptions, TaskStatus, fetchMaybeAgentVerification, AgentVerification } from '@tetsuo-ai/marketplace-sdk';
3
3
  import { Address, TransactionSigner, Rpc, GetProgramAccountsApi } from '@solana/kit';
4
- import { e as HireStatus, b as AnyHireInput, i as ReviewStatus, c as DisputeStatus, a as AgentTrackRecord } from './useAgentTrackRecord-BLf1nrbu.js';
4
+ import { f as HireStatus, b as AnyHireInput, i as ReviewStatus, c as DisputeStatus, a as AgentTrackRecord } from './useAgentTrackRecord-BCvRHYM2.cjs';
5
5
 
6
6
  /**
7
7
  * Shared types for `@tetsuo-ai/marketplace-react`.
@@ -88,8 +88,8 @@ interface CreateReadTransportConfig {
88
88
  type AgencNetwork = "localnet" | "devnet" | "mainnet";
89
89
  /**
90
90
  * Referrer configuration. Accepted + validated + stored ALWAYS; injected into
91
- * hires only when {@link ReferrerCapability.live} is true (the P6.2 gate — not
92
- * today). See {@link resolveReferrerCapability}.
91
+ * hires only when {@link ReferrerCapability.live} is true. See
92
+ * {@link resolveReferrerCapability}.
93
93
  */
94
94
  interface ReferrerConfig {
95
95
  /** Referrer wallet that earns the fee. Must be a valid base58 address. */
@@ -114,11 +114,9 @@ interface ValidatedReferrerConfig {
114
114
  * The runtime answer to "can a referral fee actually be charged on this
115
115
  * cluster?". Returned by `resolveReferrerCapability()`.
116
116
  *
117
- * THE P6.2 GATE: `live` is hardcoded `false` today because the on-chain
118
- * referrer args + 4th settlement leg (PLAN.md P6.2) are unbuilt. When it ships,
119
- * this resolver will consult P6.5 `getDeployedSurface` instead. Until then:
120
- * referrer is never injected, earnings hooks return a documented not-live
121
- * state, and disclosure UI may still show the pending-support copy.
117
+ * Referrer settlement is live on the full 84-instruction surface. `live` is true
118
+ * when a validated provider referrer is configured. Aggregated earnings remain a
119
+ * separate indexer-gated read surface.
122
120
  */
123
121
  interface ReferrerCapability {
124
122
  /** Whether referral settlement is live on the target cluster. */
@@ -144,7 +142,7 @@ interface AgencProviderConfig {
144
142
  rpcSubscriptionsUrl?: string;
145
143
  /** Indexer connection — presence of `indexer.baseUrl` selects indexer-first. */
146
144
  indexer?: IndexerConfig;
147
- /** Referrer config (accepted + validated; injected only when P6.2 is live). */
145
+ /** Referrer config (accepted + validated; injected into hire transactions). */
148
146
  referrer?: ReferrerConfig;
149
147
  /** Signer for write operations (the kit `TransactionSigner`). */
150
148
  signer?: TransactionSigner;
@@ -179,8 +177,7 @@ interface AgencContextValue {
179
177
  /** Validated referrer config, or `null` when none was supplied. */
180
178
  referrer: ValidatedReferrerConfig | null;
181
179
  /**
182
- * Resolve whether referral settlement is live on this cluster (the P6.2
183
- * gate). Today always `{ live: false, ... }`.
180
+ * Resolve whether this provider has a live referral-settlement config.
184
181
  */
185
182
  resolveReferrerCapability(): ReferrerCapability;
186
183
  }
@@ -223,8 +220,9 @@ declare const EN_STRINGS: {
223
220
  readonly "provider.missingSigner": "No signer is configured on <AgencProvider>. Connect a wallet or pass config.signer.";
224
221
  readonly "referrer.invalidWallet": "Referrer wallet is not a valid base58 Solana address: {wallet}.";
225
222
  readonly "referrer.invalidFeeBps": "Referrer feeBps must be an integer between {min} and {max} (basis points); got {feeBps}.";
226
- readonly "referrer.notLive": "This site earns a referral fee (pending protocol support).";
227
- readonly "referrer.notLiveReason": "Referral settlement is not yet deployed on this cluster (PLAN.md P6.2). Referrer config is accepted and validated but not injected into hires.";
223
+ readonly "referrer.notLive": "Referral fee is not active for this hire.";
224
+ readonly "referrer.notLiveReason": "No referrer is configured for this provider.";
225
+ readonly "referrer.earningsNotLiveReason": "Referral settlement is live, but aggregated referrer earnings are not yet exposed by the indexer.";
228
226
  readonly "transport.noReadSource": "No read source is configured. Pass an indexer baseUrl, an rpc/queryTransport, to <AgencProvider> or createReadTransport().";
229
227
  readonly "state.loading": "Loading…";
230
228
  readonly "state.empty": "Nothing to show yet.";
@@ -481,7 +479,7 @@ declare const EN_COMPONENT_STRINGS: {
481
479
  readonly "components.hire.moderationIssues": "Moderation issues found";
482
480
  readonly "components.hire.notConnected": "Connect a wallet to hire.";
483
481
  readonly "components.referrer.disclosure": "This site earns a referral fee.";
484
- readonly "components.referrer.disclosurePending": "This site earns a referral fee (pending protocol support).";
482
+ readonly "components.referrer.disclosurePending": "Referral fee is not active for this hire.";
485
483
  readonly "components.referrer.feeBps": "{bps} bps";
486
484
  readonly "components.taskTimeline.title": "Task progress";
487
485
  readonly "components.taskTimeline.empty": "No task to track yet.";
@@ -517,6 +515,10 @@ declare const EN_COMPONENT_STRINGS: {
517
515
  readonly "components.provider.provisional": "provisional";
518
516
  readonly "components.provider.noData": "No track record yet.";
519
517
  readonly "components.provider.unavailable": "Track record is unavailable on this read transport.";
518
+ readonly "components.provider.verifiedDomain": "Verified: {domain}";
519
+ readonly "components.provider.verifiedDomainLabel": "Verified domain {domain}";
520
+ readonly "components.provider.claimedDomain": "Claims: {domain}";
521
+ readonly "components.provider.claimedDomainLabel": "Claimed domain {domain} (not verified on-chain)";
520
522
  readonly "components.poweredBy.label": "Powered by AgenC";
521
523
  readonly "components.poweredBy.trustLink": "Learn how this works";
522
524
  };
@@ -770,8 +772,8 @@ declare function ListingGrid({ listings, isLoading, error, hasMore, onLoadMore,
770
772
  * `<HireCheckoutModal>` — the embeddable money path (PLAN_2 A3).
771
773
  *
772
774
  * The accessible, themable checkout dialog: it shows the price, the moderation
773
- * attestation badge, the escrow-funding explanation, the referrer disclosure
774
- * (P6.2-gated), and walks the buyer through idle → confirming → funded /
775
+ * attestation badge, the escrow-funding explanation, the referrer disclosure,
776
+ * and walks the buyer through idle → confirming → funded /
775
777
  * error confirmation states.
776
778
  *
777
779
  * ## Accessibility (STRUCTURAL — this is published to third parties)
@@ -781,12 +783,11 @@ declare function ListingGrid({ listings, isLoading, error, hasMore, onLoadMore,
781
783
  * transaction), ARIA dialog roles, and live-region status announcements for
782
784
  * the confirming/funded/error transitions.
783
785
  *
784
- * ## The P6.2 referrer gate
786
+ * ## Referrer disclosure
785
787
  *
786
- * The disclosure renders when a `referrer` is configured, with the pending-
787
- * support copy until `referrerLive` is true (always false today). The modal
788
- * NEVER computes or claims a fee was charged — it discloses configured intent
789
- * only. Injection/earnings stay in the hooks, blocked on P6.2.
788
+ * The disclosure renders when a `referrer` is configured. The modal never
789
+ * computes earnings; injection lives in `useHire()` and aggregate earnings live
790
+ * in `useReferrerEarnings()`.
790
791
  *
791
792
  * ## Wiring
792
793
  *
@@ -833,8 +834,8 @@ interface HireCheckoutModalProps {
833
834
  */
834
835
  referrer?: ValidatedReferrerConfig | null;
835
836
  /**
836
- * Whether referral settlement is live (P6.2). Always false today. Drives the
837
- * disclosure copy only; never implies a fee was charged.
837
+ * Whether referral settlement is active for this hire. Drives the disclosure
838
+ * copy only; never computes earnings.
838
839
  */
839
840
  referrerLive?: boolean;
840
841
  /** Whether a signer/wallet is connected (gates the confirm button). */
@@ -855,8 +856,7 @@ declare function HireCheckoutModal({ open, onClose, listing, onConfirm, status,
855
856
  * This is the one component that binds the hooks directly: it renders a price-
856
857
  * aware CTA that opens {@link HireCheckoutModal}, drives the hire through
857
858
  * `useHire()`, resolves the signer via `useWalletSigner()`, and threads the
858
- * provider's configured referrer + the P6.2 capability into the modal's
859
- * disclosure (never injecting a fee — the gate lives in `useHire`).
859
+ * provider's configured referrer + capability into the modal's disclosure.
860
860
  *
861
861
  * ## Why the caller supplies the hire input
862
862
  *
@@ -913,14 +913,11 @@ declare function HireButton({ listing, buildHireInput, onHired, onViewTask, show
913
913
  /**
914
914
  * `<ReferrerDisclosure>` — the "this site earns a referral fee" notice.
915
915
  *
916
- * ## THE P6.2 GATE (PLAN_2 §0 / the §0 referrer gate — read before editing)
916
+ * ## Referral disclosure
917
917
  *
918
- * Disclosure is the ONE referrer surface allowed to render while the on-chain
919
- * referrer leg is not live. It NEVER asserts that a fee was charged: when
920
- * `live` is false it shows the "(pending protocol support)" copy. It is purely
921
- * informational and reads no earnings. The actual injection / earnings remain
922
- * blocked on P6.2 (handled by the hooks, not here). This component only
923
- * DISCLOSES the configured intent.
918
+ * Disclosure is informational and reads no earnings. When `live` is true it can
919
+ * use the present-tense fee copy. When `live` is false it shows neutral copy and
920
+ * does not imply a fee was charged.
924
921
  *
925
922
  * Render it only when a referrer is configured on the provider.
926
923
  *
@@ -932,17 +929,16 @@ interface ReferrerDisclosureProps extends ThemableProps {
932
929
  /** The validated referrer config (from the provider context). */
933
930
  referrer: ValidatedReferrerConfig;
934
931
  /**
935
- * Whether the referral fee is actually live on-chain (the P6.2 capability).
936
- * ALWAYS false today — when false the copy shows the pending-support note and
937
- * no fee is implied as charged. Defaults to false.
932
+ * Whether the referral fee is active for this hire. When false, no fee is
933
+ * implied as charged. Defaults to false.
938
934
  */
939
935
  live?: boolean;
940
936
  /** Show the configured fee in bps alongside the disclosure. Default true. */
941
937
  showFee?: boolean;
942
938
  }
943
939
  /**
944
- * Disclose that the embedding site earns a referral fee. Honors the P6.2 gate:
945
- * shows the pending-support copy until referral settlement is live.
940
+ * Disclose that the embedding site earns a referral fee when referral settlement
941
+ * is active for the hire.
946
942
  */
947
943
  declare function ReferrerDisclosure({ referrer, live, showFee, unstyled, className, }: ReferrerDisclosureProps): ReactNode;
948
944
 
@@ -1054,13 +1050,129 @@ interface DisputeBannerProps extends ThemableProps {
1054
1050
  declare function DisputeBanner({ disputeOpen, onInitiate, status, error, unstyled, className, }: DisputeBannerProps): ReactNode;
1055
1051
 
1056
1052
  /**
1057
- * `<ProviderCard>` — a provider's reputation summary.
1053
+ * The decoded, projected verification result for an agent — the PINNED P7.3(3)
1054
+ * shape. When no live verification exists this is `{ verified: false }` (the
1055
+ * narrow "absent / revoked / expired" case); otherwise every field is present
1056
+ * and `verified` is `true`.
1057
+ */
1058
+ type AgentVerificationResult = {
1059
+ /** A live, on-chain, non-revoked, non-expired verification exists. */
1060
+ verified: true;
1061
+ /** The on-chain VERIFIED operator domain (proven, not self-claimed). */
1062
+ domain: string;
1063
+ /** Proof method: `0` = DNS `TXT`, `1` = `.well-known` over HTTPS. */
1064
+ method: number;
1065
+ /** The attestor/authority that recorded this verification. */
1066
+ verifiedBy: Address | string;
1067
+ /** Unix-seconds timestamp the verification was recorded. */
1068
+ verifiedAt: bigint;
1069
+ /** Unix-seconds expiry, or `0n` for no expiry. */
1070
+ expiresAt: bigint;
1071
+ /** Always `false` here (a revoked record is never `verified: true`). */
1072
+ revoked: false;
1073
+ } | {
1074
+ /** No live verification — account absent, revoked, or expired. */
1075
+ verified: false;
1076
+ };
1077
+ /** The unverified sentinel (frozen so callers can compare identity cheaply). */
1078
+ declare const UNVERIFIED: AgentVerificationResult;
1079
+ /**
1080
+ * Decide whether a decoded `AgentVerification` account is a LIVE verification:
1081
+ * it must NOT be revoked AND must not be expired (`expiresAt === 0n` = no
1082
+ * expiry; otherwise `nowSeconds < expiresAt`). Pure + exported so structural
1083
+ * tests assert the revoked/expired/absent boundaries directly.
1084
+ *
1085
+ * @param account - The decoded account, or `null`/`undefined` when absent.
1086
+ * @param nowSeconds - Current unix-seconds (injected for determinism).
1087
+ */
1088
+ declare function evaluateAgentVerification(account: AgentVerification | null | undefined, nowSeconds: bigint): AgentVerificationResult;
1089
+ /**
1090
+ * A function that resolves the raw verification for an agent PDA to the pinned
1091
+ * result shape. Injected so the hook stays decoupled from any specific read
1092
+ * backend (kit RPC, the storefront track-record endpoint, a test stub).
1093
+ */
1094
+ type AgentVerificationReader = (agentPda: Address | string) => Promise<AgentVerificationResult>;
1095
+ /** The minimal kit-RPC surface {@link agentVerificationReaderFromRpc} needs. */
1096
+ type AgentVerificationRpc = Parameters<typeof fetchMaybeAgentVerification>[0];
1097
+ /** Options for {@link agentVerificationReaderFromRpc}. */
1098
+ interface AgentVerificationReaderOptions {
1099
+ /**
1100
+ * Clock source (unix seconds) used to evaluate expiry. Defaults to
1101
+ * `Date.now()`-derived; inject a fixed value in tests/SSR for determinism.
1102
+ */
1103
+ now?: () => bigint;
1104
+ }
1105
+ /**
1106
+ * Build an {@link AgentVerificationReader} over a kit RPC using the SDK's
1107
+ * `findAgentVerificationPda` (the `["agent_verification", agent]` seed) +
1108
+ * `fetchMaybeAgentVerification` (the regenerated decoder). An absent account
1109
+ * yields `{ verified: false }` (never throws on absence).
1110
+ *
1111
+ * @param rpc - A kit RPC capable of `getAccountInfo` (what the SDK fetch needs).
1112
+ * @param options - Optional `now` clock injection.
1113
+ */
1114
+ declare function agentVerificationReaderFromRpc(rpc: AgentVerificationRpc, options?: AgentVerificationReaderOptions): AgentVerificationReader;
1115
+ /** Options for {@link useAgentVerification}. */
1116
+ interface UseAgentVerificationOptions {
1117
+ /**
1118
+ * The reader that resolves the on-chain verification. When omitted the hook
1119
+ * is inert (returns the unverified result, never queries) — a host opts in by
1120
+ * passing {@link agentVerificationReaderFromRpc} or a custom resolver.
1121
+ */
1122
+ reader?: AgentVerificationReader;
1123
+ /** Disable the query. Default `true` when `agentPda` and a `reader` are set. */
1124
+ enabled?: boolean;
1125
+ }
1126
+ /** Return value of {@link useAgentVerification}. */
1127
+ interface UseAgentVerificationResult {
1128
+ /** The resolved verification (defaults to the unverified result). */
1129
+ verification: AgentVerificationResult;
1130
+ /** Convenience: `verification.verified`. */
1131
+ verified: boolean;
1132
+ /** True while the verification read is in flight. */
1133
+ isLoading: boolean;
1134
+ /** A read error, or `null`. A failed read is NEVER treated as verified. */
1135
+ error: Error | null;
1136
+ /** Force a refetch. */
1137
+ refetch: () => void;
1138
+ }
1139
+ /**
1140
+ * Read an agent's on-chain verification (P7.3) into the pinned result shape.
1141
+ *
1142
+ * Defensive by construction: with no `reader`, no resolved data, or a read
1143
+ * error, the result is `{ verified: false }` — an agent is shown verified ONLY
1144
+ * when a live on-chain attestation is actually read back. A self-claimed
1145
+ * `operatorDomain` never reaches this hook.
1146
+ *
1147
+ * @param agentPda - The AgentRegistration PDA (falsy disables the hook).
1148
+ * @param options - The `reader` to resolve with + an `enabled` override.
1149
+ * @returns {@link UseAgentVerificationResult}.
1150
+ */
1151
+ declare function useAgentVerification(agentPda: Address | string | undefined | null, options?: UseAgentVerificationOptions): UseAgentVerificationResult;
1152
+
1153
+ /**
1154
+ * `<ProviderCard>` — a provider's reputation + trust summary.
1058
1155
  *
1059
1156
  * Renders the agent's track record (completion rate, dispute rate, completions,
1060
- * dispute count, slash history count) plus a verified badge. Presentational: it
1061
- * takes the projected `AgentTrackRecord | null` (from
1062
- * `useAgentTrackRecord().trackRecord`) + loading/error, so it renders under SSR
1063
- * and in Ladle.
1157
+ * dispute count) plus an on-chain VERIFIED badge and the operator domain.
1158
+ * Presentational: it takes the projected `AgentTrackRecord | null` (from
1159
+ * `useAgentTrackRecord().trackRecord`) and the resolved
1160
+ * `AgentVerificationResult` (from `useAgentVerification().verification`) +
1161
+ * loading/error, so it renders under SSR and in Ladle.
1162
+ *
1163
+ * ## P7.3(3) claimed vs verified — the trust distinction
1164
+ *
1165
+ * The provider may CLAIM an `operatorDomain` in its agent metadata; that is
1166
+ * self-reported and unproven. The trust signal is the on-chain
1167
+ * `AgentVerification` PDA, written by a trusted attestor only after the operator
1168
+ * PROVED domain control. This card NEVER conflates the two:
1169
+ * - a live verification (`verification.verified === true`) renders a "Verified:
1170
+ * <domain>" badge using the ON-CHAIN `verification.domain` (a success pill);
1171
+ * - otherwise, the merely-CLAIMED `operatorDomain` (when supplied) renders as a
1172
+ * visibly distinct "Claims: <domain>" pill — never styled or labelled as
1173
+ * verified.
1174
+ * An unverified claimed domain therefore can never read as verified, even when
1175
+ * the claimed string happens to equal a domain someone else verified.
1064
1176
  *
1065
1177
  * ## P6.6 honesty
1066
1178
  *
@@ -1077,7 +1189,24 @@ interface ProviderCardProps extends ThemableProps {
1077
1189
  agent?: Address | string | null;
1078
1190
  /** The projected track record (from `useAgentTrackRecord().trackRecord`). */
1079
1191
  trackRecord: AgentTrackRecord | null;
1080
- /** Whether the provider is verified (shows the verified badge). */
1192
+ /**
1193
+ * The resolved ON-CHAIN verification (from
1194
+ * `useAgentVerification().verification`). Defaults to the unverified result,
1195
+ * so omitting it renders the provider as NOT verified — verified state is
1196
+ * opt-in and only ever driven by a live attestation.
1197
+ */
1198
+ verification?: AgentVerificationResult;
1199
+ /**
1200
+ * The provider's CLAIMED operator domain (from agent metadata). Self-reported
1201
+ * and UNPROVEN — shown as a clearly-distinct "claimed" pill, and only when no
1202
+ * on-chain verification supersedes it. Never rendered as verified.
1203
+ */
1204
+ operatorDomain?: string | null;
1205
+ /**
1206
+ * Deprecated boolean verified flag (pre-P7.3). When `verification` is omitted,
1207
+ * a `true` here still shows the legacy verified badge, but WITHOUT a domain
1208
+ * (no on-chain domain is available from a bare boolean). Prefer `verification`.
1209
+ */
1081
1210
  verified?: boolean;
1082
1211
  /** True while loading the track record. */
1083
1212
  isLoading?: boolean;
@@ -1090,9 +1219,9 @@ interface ProviderCardProps extends ThemableProps {
1090
1219
  onRetry?: () => void;
1091
1220
  }
1092
1221
  /**
1093
- * Render a provider reputation card.
1222
+ * Render a provider reputation + trust card.
1094
1223
  */
1095
- declare function ProviderCard({ agent, trackRecord, verified, isLoading, error, onRetry, unstyled, className, }: ProviderCardProps): ReactNode;
1224
+ declare function ProviderCard({ agent, trackRecord, verification, operatorDomain, verified, isLoading, error, onRetry, unstyled, className, }: ProviderCardProps): ReactNode;
1096
1225
 
1097
1226
  /**
1098
1227
  * `<PoweredByAgenC>` — an optional attribution badge linking a trust page.
@@ -1126,4 +1255,4 @@ interface PoweredByAgenCProps extends ThemableProps {
1126
1255
  */
1127
1256
  declare function PoweredByAgenC({ href, newTab, label, unstyled, className, }: PoweredByAgenCProps): ReactNode;
1128
1257
 
1129
- export { type StringId as $, type AgencProviderConfig as A, Badge as B, type CreateReadTransportConfig as C, DEFAULT_TRUST_HREF as D, EN_COMPONENT_STRINGS as E, type PoweredByAgenCProps as F, type GpaReadSource as G, HireButton as H, type IndexerConfig as I, ProviderCard as J, type ProviderCardProps as K, ListingCard as L, Modal as M, type ReadListingResult as N, ReferrerDisclosure as O, PoweredByAgenC as P, type ReferrerDisclosureProps as Q, type ReferrerCapability as R, ReviewPanel as S, type ReviewPanelProps as T, Spinner as U, type ValidatedReferrerConfig as V, type SpinnerProps as W, type StateKind as X, StateMessage as Y, type StateMessageProps as Z, type StringCatalog as _, type AgencContextValue as a, type StringVars as a0, TaskTimeline as a1, type TaskTimelineProps as a2, type ThemableProps as a3, type TranslateOptions as a4, VerifiedBadge as a5, type VerifiedBadgeProps as a6, cx as a7, decodeListingCategory as a8, decodeListingName as a9, decodeListingTags as aa, elementClass as ab, formatPriceSol as ac, formatRate as ad, formatSol as ae, moderationStateOf as af, rootClass as ag, t as ah, tc as ai, toHex as aj, truncateAddress as ak, useFocusTrap as al, type ReferrerConfig as b, type AgencNetwork as c, type ReadTransport as d, type BadgeProps as e, type BadgeTone as f, Button as g, type ButtonProps as h, type ButtonVariant as i, COMPONENT_CATALOG as j, type ComponentStringId as k, DisputeBanner as l, type DisputeBannerProps as m, EN_STRINGS as n, type HireButtonProps as o, type HireCheckoutListing as p, HireCheckoutModal as q, type HireCheckoutModalProps as r, type ListingCardData as s, type ListingCardProps as t, ListingGrid as u, type ListingGridProps as v, type ModalProps as w, ModerationBadge as x, type ModerationBadgeProps as y, type ModerationState as z };
1258
+ export { type StateKind as $, type AgencProviderConfig as A, Badge as B, type CreateReadTransportConfig as C, DEFAULT_TRUST_HREF as D, EN_COMPONENT_STRINGS as E, type ModalProps as F, type GpaReadSource as G, HireButton as H, type IndexerConfig as I, ModerationBadge as J, type ModerationBadgeProps as K, ListingCard as L, Modal as M, type ModerationState as N, type PoweredByAgenCProps as O, PoweredByAgenC as P, ProviderCard as Q, type ReferrerCapability as R, type ProviderCardProps as S, type ReadListingResult as T, ReferrerDisclosure as U, type ValidatedReferrerConfig as V, type ReferrerDisclosureProps as W, ReviewPanel as X, type ReviewPanelProps as Y, Spinner as Z, type SpinnerProps as _, type AgencContextValue as a, StateMessage as a0, type StateMessageProps as a1, type StringCatalog as a2, type StringId as a3, type StringVars as a4, TaskTimeline as a5, type TaskTimelineProps as a6, type ThemableProps as a7, type TranslateOptions as a8, UNVERIFIED as a9, type UseAgentVerificationOptions as aa, type UseAgentVerificationResult as ab, VerifiedBadge as ac, type VerifiedBadgeProps as ad, agentVerificationReaderFromRpc as ae, cx as af, decodeListingCategory as ag, decodeListingName as ah, decodeListingTags as ai, elementClass as aj, evaluateAgentVerification as ak, formatPriceSol as al, formatRate as am, formatSol as an, moderationStateOf as ao, rootClass as ap, t as aq, tc as ar, toHex as as, truncateAddress as at, useAgentVerification as au, useFocusTrap as av, type ReferrerConfig as b, type AgencNetwork as c, type ReadTransport as d, type AgentVerificationReader as e, type AgentVerificationReaderOptions as f, type AgentVerificationResult as g, type AgentVerificationRpc as h, type BadgeProps as i, type BadgeTone as j, Button as k, type ButtonProps as l, type ButtonVariant as m, COMPONENT_CATALOG as n, type ComponentStringId as o, DisputeBanner as p, type DisputeBannerProps as q, EN_STRINGS as r, type HireButtonProps as s, type HireCheckoutListing as t, HireCheckoutModal as u, type HireCheckoutModalProps as v, type ListingCardData as w, type ListingCardProps as x, ListingGrid as y, type ListingGridProps as z };