uvd-describe-sdk 0.2.0 → 0.4.1

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.
@@ -524,40 +524,60 @@ declare function failedAfterPaying(error: unknown): error is DescribeError & {
524
524
  * string comparison kept returning false and nobody was told.
525
525
  *
526
526
  * Exporting the set is one of the four "día 0" requirements the platform team
527
- * put on any SDK of the house (`D9-c0der.md:234-241`): *los caveat `code`s como
528
- * contrato exportado*. Typing them here means a consumer never re-types them,
527
+ * put on any SDK of the house: *los caveat `code`s como contrato exportado*. Typing them here means a consumer never re-types them,
529
528
  * and a typo is a compile error rather than a branch that is never taken.
530
529
  *
531
530
  * ## Why the type is not a closed union
532
531
  *
533
- * `CaveatCode | (string & {})` gives autocomplete on the eight codes that exist
534
- * today AND still accepts a ninth one the server adds tomorrow. A closed union
535
- * would turn every new server-side code into a type error in code that is
536
- * already deployed and working — the passthrough rule (tipar lo conocido,
537
- * CONSERVAR lo que no) applied to the type system. The measured precedent is
538
- * `Facet.direction`: FastAPI silently dropped a field nobody had declared, and
539
- * the response looked correct with the data missing.
532
+ * `CaveatCode | (string & {})` gives autocomplete on the codes that exist today
533
+ * AND still accepts one more the server adds tomorrow. A closed union would turn
534
+ * every new server-side code into a type error in code that is already deployed
535
+ * and working — the passthrough rule (tipar lo conocido, CONSERVAR lo que no)
536
+ * applied to the type system. The measured precedent is `Facet.direction`:
537
+ * FastAPI silently dropped a field nobody had declared, and the response looked
538
+ * correct with the data missing.
540
539
  *
541
540
  * The codes carry no version and never bump `POLICY_VERSION`: a caveat is
542
541
  * advisory by construction and identifies a CUT, it never moves a score.
543
542
  */
543
+
544
544
  /**
545
- * The eight cuts served on 2026-08-30, copied from the frozen set in
546
- * `describenet/caveats.py:172-183` (which its own
547
- * `tests/test_caveat_codes.py` pins literally, so adding or renaming one over
548
- * there goes red on purpose).
549
- *
550
- * Only `no-score` and `burn-address` are computable from public data, so the
551
- * free routes serve a documented SUBSET — an empty `caveats: []` on a free
552
- * response means "no public-data caveat", NOT "clean". The other six need the
553
- * grain and ride the metered routes. See `CAVEAT_SCOPE_FREE`.
545
+ * The ten cuts describe.net serves on 2026-09-15, copied from the frozen set in
546
+ * `describenet/caveats.py:177-192` (describe-net `origin/main` at `4fd11c0`),
547
+ * which its own `tests/test_caveat_codes.py` pins literally, so adding or
548
+ * renaming one over there goes red on purpose. Same order as upstream.
549
+ *
550
+ * What the FREE route evaluates, per the server itself (`caveats.py:513`,
551
+ * `_publicos_evaluados`): `burn-address` always, and `thin-chain` when it has the
552
+ * per-chain rows — which `GET /wallets/{wallet}/chains` always has. Every other
553
+ * wallet-scope code is DECLARED as not evaluated, by name, in
554
+ * `WalletReputation.caveatsNotComputed`. `facilitator-authored` is agent scope
555
+ * and is in neither: a wallet profile lists no rows. An empty `caveats: []` on a
556
+ * free response therefore still means "no public-data caveat", NOT "clean" — and
557
+ * `requireFullCaveats()` is the gate that knows it. See `CAVEAT_SCOPE_FREE`.
558
+ *
559
+ * `thin-chain` (upstream since 2026-09-04, `cf8f806`; on the free route since
560
+ * 2026-09-05) is mirrored since 0.4.1, added to both twins together so the set
561
+ * both SDKs publish never differs. 0.4.0 shipped nine and knew it: until then
562
+ * `isKnownCaveatCode('thin-chain')` answered `false`, and the caveat still
563
+ * arrived whole — the tolerant answer this module was built to give.
564
+ *
565
+ * ⚠️ CORRECTED 2026-09-15, and the old text is left because somebody will look
566
+ * for it. It read: *"The eight cuts served on 2026-08-30, copied from the frozen
567
+ * set in `describenet/caveats.py:172-183` … Only `no-score` and `burn-address`
568
+ * are computable from public data, so the free routes serve a documented SUBSET
569
+ * … The other six need the grain and ride the metered routes."* Two codes had
570
+ * landed upstream since and this mirror carried neither; `facilitator-authored`
571
+ * (`6e25d71`, 2026-09-14) was mirrored in 0.4.0, `thin-chain` in 0.4.1. And
572
+ * `no-score` is not evaluated on the free route at all: the server declares it
573
+ * in the list.
554
574
  */
555
- declare const CAVEAT_CODES: readonly ["no-score", "concentration-degraded", "single-rater", "few-raters", "top-client-share", "campaign-per-rater", "self-rated", "burn-address"];
556
- /** The eight known codes as a union — for `switch`, not for validation. */
575
+ declare const CAVEAT_CODES: readonly ["no-score", "concentration-degraded", "single-rater", "few-raters", "top-client-share", "campaign-per-rater", "self-rated", "burn-address", "thin-chain", "facilitator-authored"];
576
+ /** The known codes as a union — for `switch`, not for validation. */
557
577
  type KnownCaveatCode = (typeof CAVEAT_CODES)[number];
558
578
  /**
559
- * What a caveat's `code` may be: one of the eight, or any string the server
560
- * starts sending. The `(string & {})` half is what keeps autocomplete alive
579
+ * What a caveat's `code` may be: a known one, or any string the server starts
580
+ * sending. The `(string & {})` half is what keeps autocomplete alive
561
581
  * while leaving the union open.
562
582
  */
563
583
  type CaveatCode = KnownCaveatCode | (string & {});
@@ -597,6 +617,170 @@ declare function isKnownCaveatCode(code: string): code is KnownCaveatCode;
597
617
  declare function hasCaveat(subject: {
598
618
  caveats?: readonly Caveat[];
599
619
  } | null | undefined, code: CaveatCode): boolean;
620
+ /**
621
+ * `requireFullCaveats()` refused: this answer does not vouch for every cut.
622
+ *
623
+ * ## 🔴 NOT a `DescribeError`, and that is the decision
624
+ *
625
+ * `DescribeError` is the failure taxonomy — transport and protocol, "we could
626
+ * not read" — and consumers wrap it in their own fail-open:
627
+ * `catch (e) { if (e instanceof DescribeError) return null; }`. A refusal caught
628
+ * there degrades into "describe.net is down", and a gate built to tolerate
629
+ * outages lets the subject THROUGH: the same silent green the 2026-08-31 row
630
+ * exists to stop. This is not a failure to read; it is a successful read that
631
+ * does not support the decision being asked of it. So it extends `Error`, carries
632
+ * no `kind`, `transient` or `serviceFault`, and `failOpenCovers()` and
633
+ * `failedAfterPaying()` both answer `false` for it.
634
+ *
635
+ * Decided by the Python twin the same night (`CaveatsNotComputedError`,
636
+ * `uvd_describe_sdk/caveats.py`) and adopted here for parity. The first draft of
637
+ * this package made it a `DescribeError` with a new `kind`; the argument above is
638
+ * why that was the wrong door — and it would also have broken, at compile time,
639
+ * every exhaustive `switch` over `DescribeErrorKind`.
640
+ *
641
+ * ## `notComputed` — branch on it, never on the message
642
+ *
643
+ * ```
644
+ * ['few-raters', …] the answer DECLARED these unevaluated: unverified, not passed
645
+ * null the answer declared NOTHING — a server older than
646
+ * 2026-09-14, or a payload stored before then. Not `[]`.
647
+ * ```
648
+ *
649
+ * A declared `[]` never reaches this class: it passes the gate.
650
+ */
651
+ declare class CaveatsNotComputedError extends Error {
652
+ /**
653
+ * What to do INSTEAD, as a frozen literal that interpolates nothing — the
654
+ * redaction rule of `recovery.ts` (invariant 11), without being an entry of
655
+ * that table, because this is not a `kind`. Same text on the class and on
656
+ * every instance.
657
+ *
658
+ * ⚠️ Not byte-identical to the Python twin's, and that is declared rather than
659
+ * hidden: theirs names `wallet_breakdown()`, `payer=`, `partner=` and
660
+ * `fallback_reader`, which are Python spellings. This one names what both SDKs
661
+ * share — the route, and the two ways through it.
662
+ */
663
+ static readonly recovery: string;
664
+ /** Same literal as {@link CaveatsNotComputedError.recovery}, on the instance. */
665
+ readonly recovery: string;
666
+ /** The wallet whose answer was refused, as served. */
667
+ readonly wallet: string;
668
+ /** A COPY of what the answer declared, or `null` if it declared nothing. */
669
+ readonly notComputed: string[] | null;
670
+ constructor(message: string, opts: {
671
+ wallet: string;
672
+ notComputed: readonly string[] | null;
673
+ });
674
+ }
675
+ /**
676
+ * Return `result` only if its answer DECLARED it left no caveat code out.
677
+ *
678
+ * ```ts
679
+ * const rep = await describe.wallet(address);
680
+ * if (rep === null) { … } // no answer at all: decide THAT first
681
+ * requireFullCaveats(rep); // throws CaveatsNotComputedError
682
+ * ```
683
+ *
684
+ * ## The bug it closes, found by karma-hello
685
+ *
686
+ * A quality gate built on the FREE route passes everybody (karma-hello, channel,
687
+ * 2026-08-31; `describe-net/docs/BACKLOG.md:221`). The evidence-quality cuts —
688
+ * `single-rater`, `few-raters`, `campaign-per-rater`, … — are computed only by
689
+ * the paid decomposition, so on `GET /wallets/{wallet}/chains`
690
+ * `hasCaveat(rep, 'single-rater')` is `false` for every wallet, the one with a
691
+ * single rater included. Honest code, and a gate that cannot fail anyone.
692
+ *
693
+ * Since 2026-09-14 the free answer DECLARES the names it did not evaluate
694
+ * (`WalletReputation.caveatsNotComputed`), and the server names this very helper
695
+ * as the reason the declaration is a list and not a count
696
+ * (`describenet/caveats.py:493-494`: *"el SDK puede ofrecer
697
+ * `require_full_caveats()` sin tabla propia"*). No table of our own here either:
698
+ * the verdict is read off the answer, never off a list typed in this package.
699
+ *
700
+ * ## Three states, and only one passes
701
+ *
702
+ * ```
703
+ * caveatsNotComputed = [] → returns `result`, the same object
704
+ * caveatsNotComputed = ['…', …] → throws; `error.notComputed` is the list
705
+ * caveatsNotComputed = null → throws; `error.notComputed` is null
706
+ * ```
707
+ *
708
+ * 🔴 **Against the live index this throws for every `wallet()` today** —
709
+ * measured 2026-09-15: the same seven codes for a wallet with 471 distinct raters
710
+ * and for one with no identity at all. That is the gate working: the free route
711
+ * does not evaluate the evidence-quality cuts, and a decision that needs them has
712
+ * to buy `walletBreakdown()` (or read it over the partner rail). What changes is
713
+ * that the gate can no longer find that out by passing.
714
+ *
715
+ * ## 🔴 Why `null` THROWS — the decision, and its sources
716
+ *
717
+ * - The position of 2026-08-31, written in `describe-net/docs/BACKLOG.md:221`:
718
+ * *"la línea gratis/pago es regla de costo y **el scope es la señal**; el SDK
719
+ * puede ganar `require_full_caveats()`"*. That row is about a gate that goes
720
+ * green without knowing what was not computed. A `null` that passes is that
721
+ * gate, back — silently, on every old deployment and every stored payload.
722
+ * - The service refuses the same collapse on its own side: its MCP tool carries
723
+ * `None` *"cuando la API no lo trae: una API vieja no declaró nada, y `[]`
724
+ * afirmaría que lo calculó todo"* (`describenet/mcp_server.py:896-901`).
725
+ * - Before 2026-09-14 the free route did not evaluate those cuts either; it only
726
+ * did not SAY so (`caveatScope: 'public-data-subset'` was the whole signal). An
727
+ * old answer's silence is the old gap, not a clean bill.
728
+ *
729
+ * ## It takes a `WalletReputation`, and nothing else
730
+ *
731
+ * The one result that declares what it did not compute. Anything else is a
732
+ * `TypeError` naming the mistake — never a pass, and never the refusal above:
733
+ *
734
+ * - `null` is "describe.net did not answer", the third absence (invariant 3).
735
+ * Handle it before asking about caveats.
736
+ * - A `WalletBreakdown` or an `AgentReputation` comes from a metered route, which
737
+ * evaluates its own caveat scope and declares no omissions: there is nothing
738
+ * here for this gate to read.
739
+ * - A raw wire payload (snake_case) was never parsed: `parseWalletReputation()`.
740
+ *
741
+ * Never called by the client and never swallowed by `failOpen`. And passing
742
+ * means the caveats are COMPLETE, not that they are empty — `hasCaveat()` is
743
+ * still the question after the gate.
744
+ */
745
+ declare function requireFullCaveats(result: WalletReputation): WalletReputation;
746
+ /**
747
+ * The two classes served in `ratings[].author_class` since describe.net
748
+ * 2026-09-14 — the schema's own enum (`describenet/api.py:962`,
749
+ * `Literal["facilitator-authored", "rater-authored"]`), and
750
+ * `types.schema.test.ts` pins this tuple against the snapshot's `enum`. The
751
+ * Python twin calls the same set `KNOWN_AUTHOR_CLASSES`, the way it calls
752
+ * `CAVEAT_CODES` `KNOWN_CAVEAT_CODES`.
753
+ *
754
+ * They live next to the caveat codes because one of them IS one: the agent-scope
755
+ * caveat `facilitator-authored` fires exactly when some row carries that class
756
+ * (`describenet/caveats.py:614`, which reads the field instead of recomputing it,
757
+ * so the two cannot disagree inside one answer).
758
+ */
759
+ declare const AUTHOR_CLASSES: readonly ["facilitator-authored", "rater-authored"];
760
+ /** The known classes as a union — for `switch`, not for validation. */
761
+ type KnownAuthorClass = (typeof AUTHOR_CLASSES)[number];
762
+ /**
763
+ * What `Rating.authorClass` may be: a known class, or any string the server
764
+ * starts sending.
765
+ *
766
+ * Open, not closed, and recording that decision is why this type exists. The
767
+ * server's enum is closed TODAY; a third class there is a new contract on their
768
+ * side and must not become a type error — or worse, a thrown parse — on ours. A
769
+ * parser that rejected it would destroy a PAID read over one advisory field; one
770
+ * that nulled it would read as "no class served". So it arrives verbatim and
771
+ * `isKnownAuthorClass()` says whether this SDK has heard of it: the `CaveatCode`
772
+ * rule, applied one field over.
773
+ */
774
+ type AuthorClass = KnownAuthorClass | (string & {});
775
+ /**
776
+ * Is this one of the author classes this SDK knows?
777
+ *
778
+ * NOT a validator, same as `isKnownCaveatCode`: `false` means "newer than this
779
+ * SDK" — or, for `null`, a row served before 2026-09-14 that carries no class at
780
+ * all. Neither is invalid. Before filtering rows on it, decide what an unknown
781
+ * class means for YOUR count; this SDK will not decide that for you.
782
+ */
783
+ declare function isKnownAuthorClass(value: string | null | undefined): value is KnownAuthorClass;
600
784
 
601
785
  /**
602
786
  * The wire shapes — hand-written, and here is the argument for that.
@@ -784,6 +968,34 @@ interface WalletReputation extends Sealed {
784
968
  chainsWithIdentity: number;
785
969
  chainsWithReputation: number;
786
970
  totalReviews: number;
971
+ /**
972
+ * The caveat codes that the paid decomposition evaluates and THIS free answer
973
+ * did not — sorted, served since describe.net 2026-09-14
974
+ * (`describenet/caveats.py:525-532`, `not_computed_public`, derived from the
975
+ * same module that builds `caveats`). **Names, never outcomes**: whether any of
976
+ * them fires for this wallet is exactly what stays paid.
977
+ *
978
+ * Seven codes on 2026-09-15, for a wallet with 471 raters and for `0xdead…beef`
979
+ * alike — the declaration depends on what the route evaluates, not on the
980
+ * subject. Read it live; the count is not a constant.
981
+ *
982
+ * 🔴 **Three states, and they stay three:**
983
+ *
984
+ * ```
985
+ * ['few-raters', …] NOT evaluated here — read each one as UNVERIFIED, never as passed
986
+ * [] the answer says it evaluated every wallet-scope cut
987
+ * null nothing readable was declared: a server older than 2026-09-14,
988
+ * a payload stored before then, or a value that is not a list
989
+ * of non-empty strings. NOT `[]` — nothing was promised, and
990
+ * `caveatScope` still says what was evaluated
991
+ * ```
992
+ *
993
+ * The failure this field closes is karma-hello's (2026-08-31): a quality gate
994
+ * built on this route passed every wallet, because `caveats: []` here is the
995
+ * silence of cuts that were never run. Do not gate on it by hand —
996
+ * `requireFullCaveats()` is the gate, and it reads the `null` correctly.
997
+ */
998
+ caveatsNotComputed: CaveatCode[] | null;
787
999
  }
788
1000
  /** How lopsided the evidence is. `null` when there is not enough to say. */
789
1001
  interface Concentration {
@@ -812,10 +1024,71 @@ interface SelfRated {
812
1024
  /** Distance between the self-rating and everyone else's. */
813
1025
  gap: number | null;
814
1026
  }
1027
+ /**
1028
+ * First and last rating by ON-CHAIN time.
1029
+ *
1030
+ * `lastRatingAt` is the last **eligible** rating — the one that holds up the
1031
+ * score being shown. Since describe.net 2026-09-10 it is documented as a
1032
+ * compatibility alias of `Freshness.lastEligibleRatingAt` and keeps that exact
1033
+ * meaning for the life of v1. Read `WalletBreakdown.freshness` for the question
1034
+ * this pair never could answer: *was this subject described recently, whether
1035
+ * or not it counts?*
1036
+ */
815
1037
  interface Activity {
816
1038
  firstRatingAt: Timestamp;
817
1039
  lastRatingAt: Timestamp;
818
1040
  }
1041
+ /**
1042
+ * WHAT the dates are about. A date without a scope is a date that lies.
1043
+ *
1044
+ * `direction` is the field that matters most: `received` is reputation the
1045
+ * subject GOT, `emitted` is the ratings a wallet WROTE
1046
+ * (`GET /reputation/rater/{wallet}`). Reading the second as the first turns a
1047
+ * busy rater into a much-described subject.
1048
+ */
1049
+ interface FreshnessScope {
1050
+ kind: string | null;
1051
+ direction: string | null;
1052
+ id: string | null;
1053
+ network: string | null;
1054
+ declaredType: string | null;
1055
+ }
1056
+ /**
1057
+ * WHEN this subject was last described. Two dates, because two questions.
1058
+ *
1059
+ * - `lastReceivedFeedbackAt` — the last real NewFeedback in scope, whether or
1060
+ * not it feeds the score.
1061
+ * - `lastEligibleRatingAt` — the last rating that holds up the number shown.
1062
+ *
1063
+ * When the most recent rating was revoked the two differ, and **that difference
1064
+ * is the information**: there was recent activity and the score does not
1065
+ * reflect it.
1066
+ *
1067
+ * NEITHER is `refreshedAt`, which is when the index recomputed its own view and
1068
+ * says nothing about the subject.
1069
+ *
1070
+ * `timestampCoverage` is `none` | `unknown` | `partial` | `complete` over
1071
+ * `dated + undated`. **`none` and `unknown` are different facts**: nothing to
1072
+ * date versus dates we do not have yet.
1073
+ *
1074
+ * NO RELATIVE TEXT, deliberately. The API publishes UTC and nothing else, so
1075
+ * "3 days ago" is derived at the edge with the reader's clock — a serialised
1076
+ * relative string freezes in the first cache.
1077
+ */
1078
+ interface Freshness {
1079
+ scope: FreshnessScope;
1080
+ lastReceivedFeedbackAt: Timestamp;
1081
+ lastEligibleRatingAt: Timestamp;
1082
+ datedFeedbackCount: number;
1083
+ undatedFeedbackCount: number;
1084
+ timestampCoverage: string | null;
1085
+ eligibleDatedCount: number;
1086
+ eligibleUndatedCount: number;
1087
+ eligibleTimestampCoverage: string | null;
1088
+ refreshedAt: Timestamp;
1089
+ indexerCheckedAt: Timestamp;
1090
+ freshnessVersion: string | null;
1091
+ }
819
1092
  /** One facet (`tag1`), as declared on-chain. */
820
1093
  interface Facet {
821
1094
  score: number | null;
@@ -872,6 +1145,12 @@ interface WalletBreakdown extends Sealed {
872
1145
  concentration: Concentration | null;
873
1146
  confidence: Confidence | null;
874
1147
  activity: Activity | null;
1148
+ /**
1149
+ * WHEN, with its scope. Additive: `activity` above keeps its exact meaning.
1150
+ * `null` when the server does not publish the block yet — never an empty
1151
+ * object, so "not published" and "no dates" stay distinguishable.
1152
+ */
1153
+ freshness: Freshness | null;
875
1154
  snapshot: Snapshot | null;
876
1155
  /** What was actually paid, if anything was. */
877
1156
  payment: PaymentEvidence | null;
@@ -887,6 +1166,27 @@ interface WalletBreakdown extends Sealed {
887
1166
  */
888
1167
  interface Rating {
889
1168
  client: string;
1169
+ /**
1170
+ * Who SIGNED this row, as a class — served since describe.net 2026-09-14
1171
+ * (`describenet/api.py:962`, `rating_roles.author_class_of`).
1172
+ *
1173
+ * - `facilitator-authored` — `client` is a known relayer (today the x402
1174
+ * facilitator's EVM wallet) that wrote the rating on behalf of the real
1175
+ * rater. **`client` is NOT the counterparty**: every such row shares one
1176
+ * `client`, so any per-rater count — `concentration.distinctRaters`,
1177
+ * `topClientShare` — merges all of them into one voice. Filter on this
1178
+ * before reading `client` as "who rated".
1179
+ * - `rater-authored` — `client` is not a relayer the index knows about. 🔴 It
1180
+ * does NOT prove who signed; it is the absence of a known relayer.
1181
+ * - `null` — no class was served (a server older than 2026-09-14, or a stored
1182
+ * payload). Unknown, and deliberately NOT defaulted to `rater-authored`:
1183
+ * that would assert the one thing the index says it cannot.
1184
+ *
1185
+ * An unknown string arrives VERBATIM — the union is open, like `CaveatCode`,
1186
+ * and `isKnownAuthorClass()` says whether this SDK has heard of it. Per row
1187
+ * only: neither the index nor this SDK computes any score or count by class.
1188
+ */
1189
+ authorClass: AuthorClass | null;
890
1190
  feedbackIndex: number;
891
1191
  value: number;
892
1192
  valueDecimals: number;
@@ -1021,6 +1321,25 @@ interface IndexHealth {
1021
1321
  orderingPolicy: string;
1022
1322
  raterWeightPolicy: string;
1023
1323
  confidencePolicy: string;
1324
+ /**
1325
+ * The frozen `M` of the per-chain credibility weight, `Z_k = R_k/(R_k+M)`.
1326
+ *
1327
+ * REQUIRED in the server schema since `credibility-weight-per-chain@1`
1328
+ * (2026-09-04) and untyped here until now — `types.schema.test.ts` caught it
1329
+ * the moment the snapshot was refreshed. It ships live because the number is
1330
+ * frozen and versioned: recomputing a `finalScore` by hand needs THIS M, not
1331
+ * a copy of it that went stale.
1332
+ */
1333
+ credibilityM: number | null;
1334
+ /**
1335
+ * WHEN the index as a whole last received a description. The only free,
1336
+ * account-less, parameter-less place to read whether describe.net is still
1337
+ * taking in descriptions or merely still refreshing its views — the two look
1338
+ * identical from the outside, which is the confusion `Freshness` closes.
1339
+ *
1340
+ * `null` against a server that does not publish it yet.
1341
+ */
1342
+ freshness: Freshness | null;
1024
1343
  /** e.g. `{no_ratings: 0, low: 1, medium: 3, high: 6}` — live, never re-typed. */
1025
1344
  confidenceThresholds: Record<string, number>;
1026
1345
  /** e.g. `{min_raters: 3, campaign_per_rater: 20, top_share: 0.5, ...}`. */
@@ -1588,4 +1907,4 @@ declare class DescribeClient {
1588
1907
  private assertPayableTo;
1589
1908
  }
1590
1909
 
1591
- export { type AgentReputation as A, type WalletChainRow as B, CAVEAT_CODES as C, type DescribeErrorKind as D, type X402Payer as E, type Facet as F, failOpenCovers as G, type HealthChain as H, type IndexHealth as I, failedAfterPaying as J, type KnownCaveatCode as K, type LeaderboardRow as L, hasCaveat as M, type Network as N, type Ownership as O, type PaymentEvidence as P, isKnownCaveatCode as Q, type Rating as R, type Sealed as S, type Timestamp as T, type WalletBreakdown as W, type X402Challenge as X, type WalletReputation as a, type Activity as b, CAVEAT_SCOPE_FREE as c, CAVEAT_SCOPE_METERED as d, type Caveat as e, type CaveatCode as f, type Concentration as g, type Confidence as h, DescribeClient as i, type DescribeClientConfig as j, DescribeError as k, type DescribeFailure as l, DescribeHTTPError as m, DescribeMalformedHash as n, DescribeNotFound as o, DescribePartnerRejected as p, DescribePartnerUnsigned as q, DescribePaymentRefused as r, DescribePaymentRequired as s, DescribeTimeout as t, DescribeUnparseable as u, DescribeUnreachable as v, type PartnerSigner as w, type PaymentAttempt as x, type SelfRated as y, type Snapshot as z };
1910
+ export { isKnownAuthorClass as $, type AgentReputation as A, type FreshnessScope as B, CAVEAT_CODES as C, type DescribeErrorKind as D, type KnownCaveatCode as E, type Facet as F, type PartnerSigner as G, type HealthChain as H, type IndexHealth as I, type PaymentAttempt as J, type KnownAuthorClass as K, type LeaderboardRow as L, type SelfRated as M, type Network as N, type Ownership as O, type PaymentEvidence as P, type Snapshot as Q, type Rating as R, type Sealed as S, type Timestamp as T, type WalletChainRow as U, type X402Payer as V, type WalletBreakdown as W, type X402Challenge as X, failOpenCovers as Y, failedAfterPaying as Z, hasCaveat as _, type WalletReputation as a, isKnownCaveatCode as a0, requireFullCaveats as a1, AUTHOR_CLASSES as b, type Activity as c, type AuthorClass as d, CAVEAT_SCOPE_FREE as e, CAVEAT_SCOPE_METERED as f, type Caveat as g, type CaveatCode as h, CaveatsNotComputedError as i, type Concentration as j, type Confidence as k, DescribeClient as l, type DescribeClientConfig as m, DescribeError as n, type DescribeFailure as o, DescribeHTTPError as p, DescribeMalformedHash as q, DescribeNotFound as r, DescribePartnerRejected as s, DescribePartnerUnsigned as t, DescribePaymentRefused as u, DescribePaymentRequired as v, DescribeTimeout as w, DescribeUnparseable as x, DescribeUnreachable as y, type Freshness as z };
@@ -138,7 +138,7 @@ declare const PARTNER_KEY_ENV = "DESCRIBE_PARTNER_PRIVATE_KEY";
138
138
  * time instead of at runtime. Bumping the version without the constant is a
139
139
  * red test, not a silent lie in someone's access log.
140
140
  */
141
- declare const SDK_VERSION = "0.2.0";
141
+ declare const SDK_VERSION = "0.4.1";
142
142
  /** `uvd-describe-sdk-ts/0.1.0`, plus `(+<product>)` when the caller names itself. */
143
143
  declare const SDK_NAME = "uvd-describe-sdk-ts";
144
144
  /**
@@ -138,7 +138,7 @@ declare const PARTNER_KEY_ENV = "DESCRIBE_PARTNER_PRIVATE_KEY";
138
138
  * time instead of at runtime. Bumping the version without the constant is a
139
139
  * red test, not a silent lie in someone's access log.
140
140
  */
141
- declare const SDK_VERSION = "0.2.0";
141
+ declare const SDK_VERSION = "0.4.1";
142
142
  /** `uvd-describe-sdk-ts/0.1.0`, plus `(+<product>)` when the caller names itself. */
143
143
  declare const SDK_NAME = "uvd-describe-sdk-ts";
144
144
  /**
package/dist/index.d.mts CHANGED
@@ -1,6 +1,6 @@
1
- import { D as DescribeErrorKind, P as PaymentEvidence, A as AgentReputation, I as IndexHealth, L as LeaderboardRow, W as WalletBreakdown, a as WalletReputation } from './client-RAhXcpdY.mjs';
2
- export { b as Activity, C as CAVEAT_CODES, c as CAVEAT_SCOPE_FREE, d as CAVEAT_SCOPE_METERED, e as Caveat, f as CaveatCode, g as Concentration, h as Confidence, i as DescribeClient, j as DescribeClientConfig, k as DescribeError, l as DescribeFailure, m as DescribeHTTPError, n as DescribeMalformedHash, o as DescribeNotFound, p as DescribePartnerRejected, q as DescribePartnerUnsigned, r as DescribePaymentRefused, s as DescribePaymentRequired, t as DescribeTimeout, u as DescribeUnparseable, v as DescribeUnreachable, F as Facet, H as HealthChain, K as KnownCaveatCode, N as Network, O as Ownership, w as PartnerSigner, x as PaymentAttempt, R as Rating, S as Sealed, y as SelfRated, z as Snapshot, T as Timestamp, B as WalletChainRow, X as X402Challenge, E as X402Payer, G as failOpenCovers, J as failedAfterPaying, M as hasCaveat, Q as isKnownCaveatCode } from './client-RAhXcpdY.mjs';
3
- export { D as DEFAULT_BASE_URL, a as DEFAULT_JITTER_MS, b as DEFAULT_SITE_URL, c as DEFAULT_TIMEOUT_MS, P as PARTNER_CHAIN_ID, d as PARTNER_KEY_ENV, S as SDK_NAME, e as SDK_VERSION, T as TREASURY_EVM, u as userAgent } from './config-uvI_GS-x.mjs';
1
+ import { D as DescribeErrorKind, P as PaymentEvidence, A as AgentReputation, I as IndexHealth, L as LeaderboardRow, W as WalletBreakdown, a as WalletReputation } from './client-0sg4J53x.mjs';
2
+ export { b as AUTHOR_CLASSES, c as Activity, d as AuthorClass, C as CAVEAT_CODES, e as CAVEAT_SCOPE_FREE, f as CAVEAT_SCOPE_METERED, g as Caveat, h as CaveatCode, i as CaveatsNotComputedError, j as Concentration, k as Confidence, l as DescribeClient, m as DescribeClientConfig, n as DescribeError, o as DescribeFailure, p as DescribeHTTPError, q as DescribeMalformedHash, r as DescribeNotFound, s as DescribePartnerRejected, t as DescribePartnerUnsigned, u as DescribePaymentRefused, v as DescribePaymentRequired, w as DescribeTimeout, x as DescribeUnparseable, y as DescribeUnreachable, F as Facet, z as Freshness, B as FreshnessScope, H as HealthChain, K as KnownAuthorClass, E as KnownCaveatCode, N as Network, O as Ownership, G as PartnerSigner, J as PaymentAttempt, R as Rating, S as Sealed, M as SelfRated, Q as Snapshot, T as Timestamp, U as WalletChainRow, X as X402Challenge, V as X402Payer, Y as failOpenCovers, Z as failedAfterPaying, _ as hasCaveat, $ as isKnownAuthorClass, a0 as isKnownCaveatCode, a1 as requireFullCaveats } from './client-0sg4J53x.mjs';
3
+ export { D as DEFAULT_BASE_URL, a as DEFAULT_JITTER_MS, b as DEFAULT_SITE_URL, c as DEFAULT_TIMEOUT_MS, P as PARTNER_CHAIN_ID, d as PARTNER_KEY_ENV, S as SDK_NAME, e as SDK_VERSION, T as TREASURY_EVM, u as userAgent } from './config-gjJ08BUJ.mjs';
4
4
 
5
5
  /**
6
6
  * What to do INSTEAD — the sentence `transient` cannot say.
package/dist/index.d.ts CHANGED
@@ -1,6 +1,6 @@
1
- import { D as DescribeErrorKind, P as PaymentEvidence, A as AgentReputation, I as IndexHealth, L as LeaderboardRow, W as WalletBreakdown, a as WalletReputation } from './client-RAhXcpdY.js';
2
- export { b as Activity, C as CAVEAT_CODES, c as CAVEAT_SCOPE_FREE, d as CAVEAT_SCOPE_METERED, e as Caveat, f as CaveatCode, g as Concentration, h as Confidence, i as DescribeClient, j as DescribeClientConfig, k as DescribeError, l as DescribeFailure, m as DescribeHTTPError, n as DescribeMalformedHash, o as DescribeNotFound, p as DescribePartnerRejected, q as DescribePartnerUnsigned, r as DescribePaymentRefused, s as DescribePaymentRequired, t as DescribeTimeout, u as DescribeUnparseable, v as DescribeUnreachable, F as Facet, H as HealthChain, K as KnownCaveatCode, N as Network, O as Ownership, w as PartnerSigner, x as PaymentAttempt, R as Rating, S as Sealed, y as SelfRated, z as Snapshot, T as Timestamp, B as WalletChainRow, X as X402Challenge, E as X402Payer, G as failOpenCovers, J as failedAfterPaying, M as hasCaveat, Q as isKnownCaveatCode } from './client-RAhXcpdY.js';
3
- export { D as DEFAULT_BASE_URL, a as DEFAULT_JITTER_MS, b as DEFAULT_SITE_URL, c as DEFAULT_TIMEOUT_MS, P as PARTNER_CHAIN_ID, d as PARTNER_KEY_ENV, S as SDK_NAME, e as SDK_VERSION, T as TREASURY_EVM, u as userAgent } from './config-uvI_GS-x.js';
1
+ import { D as DescribeErrorKind, P as PaymentEvidence, A as AgentReputation, I as IndexHealth, L as LeaderboardRow, W as WalletBreakdown, a as WalletReputation } from './client-0sg4J53x.js';
2
+ export { b as AUTHOR_CLASSES, c as Activity, d as AuthorClass, C as CAVEAT_CODES, e as CAVEAT_SCOPE_FREE, f as CAVEAT_SCOPE_METERED, g as Caveat, h as CaveatCode, i as CaveatsNotComputedError, j as Concentration, k as Confidence, l as DescribeClient, m as DescribeClientConfig, n as DescribeError, o as DescribeFailure, p as DescribeHTTPError, q as DescribeMalformedHash, r as DescribeNotFound, s as DescribePartnerRejected, t as DescribePartnerUnsigned, u as DescribePaymentRefused, v as DescribePaymentRequired, w as DescribeTimeout, x as DescribeUnparseable, y as DescribeUnreachable, F as Facet, z as Freshness, B as FreshnessScope, H as HealthChain, K as KnownAuthorClass, E as KnownCaveatCode, N as Network, O as Ownership, G as PartnerSigner, J as PaymentAttempt, R as Rating, S as Sealed, M as SelfRated, Q as Snapshot, T as Timestamp, U as WalletChainRow, X as X402Challenge, V as X402Payer, Y as failOpenCovers, Z as failedAfterPaying, _ as hasCaveat, $ as isKnownAuthorClass, a0 as isKnownCaveatCode, a1 as requireFullCaveats } from './client-0sg4J53x.js';
3
+ export { D as DEFAULT_BASE_URL, a as DEFAULT_JITTER_MS, b as DEFAULT_SITE_URL, c as DEFAULT_TIMEOUT_MS, P as PARTNER_CHAIN_ID, d as PARTNER_KEY_ENV, S as SDK_NAME, e as SDK_VERSION, T as TREASURY_EVM, u as userAgent } from './config-gjJ08BUJ.js';
4
4
 
5
5
  /**
6
6
  * What to do INSTEAD — the sentence `transient` cannot say.