@adcp/sdk 15.9.0 → 16.0.0-beta.1

package/dist/lib/reporting/ledger/managed-router.d.ts

@@ -2,7 +2,11 @@ import type { ReportingVerification } from '../../types';
 import { type ReportingDestinationAuthorizationV1, type ReportingDestinationPatternV1, type ReportingManagedDeliveryAdapterV1 } from './managed';
 import type { ReportingManagedDeliveryBindingV1 } from './types';
 type VerificationProfile = ReportingVerification['verification_profile'];
-/** Why a delivery, read, revocation or admission could not be routed. */
+/**
+ * Why a delivery, read, revocation or admission could not be routed.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export type ReportingManagedDeliveryRoutingErrorCodeV1 = 
 /** No route is installed for the pattern and transport. */
 'REPORTING_ROUTE_NOT_FOUND'
@@ -12,10 +16,15 @@ export type ReportingManagedDeliveryRoutingErrorCodeV1 =
  | 'REPORTING_ROUTE_CONTRACT_UNRECORDED'
 /** The binding's verification profile is not one its route can verify. */
  | 'REPORTING_ROUTE_VERIFICATION_UNSUPPORTED';
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export type ReportingManagedDeliveryRoutingOperationV1 = 'deliver' | 'read' | 'revoke' | 'admit_binding' | 'admit_offering';
 /**
  * Raised by the router before it touches any adapter. The fields are the
  * non-secret routing facts only: no destination, location or credential.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
  */
 export declare class ReportingManagedDeliveryRoutingErrorV1 extends Error {
     readonly code: ReportingManagedDeliveryRoutingErrorCodeV1;
@@ -33,11 +42,16 @@ export declare class ReportingManagedDeliveryRoutingErrorV1 extends Error {
  * Raised by `router.probe()` when at least one route's probe failed. Carries
  * the ids of the failing routes and nothing else from the provider; the
  * individual errors are on `cause` (an `AggregateError`) for seller logs only.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
  */
 export declare class ReportingManagedDeliveryProbeErrorV1 extends Error {
     readonly failedRouteIds: readonly string[];
     constructor(failedRouteIds: readonly string[], errors: readonly unknown[]);
 }
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface ReportingManagedDeliveryRouteV1 {
     /** Stable id used in per-route counts and probe failures. Lowercase token, at most 64 characters. */
     id: string;
@@ -53,6 +67,9 @@ export interface ReportingManagedDeliveryRouteV1 {
      */
     adapter: ReportingManagedDeliveryAdapterV1;
 }
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface CreateReportingManagedDeliveryAdapterRouterOptionsV1 {
     routes: readonly ReportingManagedDeliveryRouteV1[];
     /**
@@ -70,7 +87,11 @@ export interface CreateReportingManagedDeliveryAdapterRouterOptionsV1 {
      */
     probeTimeoutMilliseconds?: number;
 }
-/** What a router exposes about a route. The adapter itself stays private to the router. */
+/**
+ * What a router exposes about a route. The adapter itself stays private to the router.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface ReportingManagedDeliveryRouteDescriptionV1 {
     readonly id: string;
     readonly match: Readonly<{
@@ -82,6 +103,8 @@ export interface ReportingManagedDeliveryRouteDescriptionV1 {
 /**
  * A `ReportingManagedDeliveryAdapterV1` that dispatches to one adapter per
  * (pattern, transport). The optional hooks are always present on a router.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
  */
 export interface ReportingManagedDeliveryAdapterRouterV1 extends ReportingManagedDeliveryAdapterV1 {
     readonly routes: readonly ReportingManagedDeliveryRouteDescriptionV1[];
@@ -118,6 +141,8 @@ export interface ReportingManagedDeliveryAdapterRouterV1 extends ReportingManage
  *   authorization generation. It never fans out.
  * - Nothing that cannot be routed reaches an adapter: the router throws a
  *   `ReportingManagedDeliveryRoutingErrorV1` first.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
  */
 export declare function createReportingManagedDeliveryAdapterRouterV1(options: CreateReportingManagedDeliveryAdapterRouterOptionsV1): ReportingManagedDeliveryAdapterRouterV1;
 export {};

package/dist/lib/reporting/ledger/managed.d.mts

@@ -7,14 +7,31 @@ import type { ReportingLedgerAdjustmentV1, ReportingLegacyRevisionReaderV1, Repo
  * Upper bound on an adapter's startup probe, so a hung provider cannot hang startup.
  * A router's per-route probe budget must stay under it, or this deadline fires
  * first and the failing route's id never reaches the startup error.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
  */
 export declare const REPORTING_ADAPTER_PROBE_DEADLINE_MILLISECONDS_V1 = 30000;
-/** The delivery pattern a destination authorization generation serves. */
+/**
+ * The delivery pattern a destination authorization generation serves.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export type ReportingDestinationPatternV1 = ReportingManagedDeliveryBindingV1['method'];
-/** Delivery patterns, in the order the protocol lists them. */
+/**
+ * Delivery patterns, in the order the protocol lists them.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export declare const REPORTING_DESTINATION_PATTERNS_V1: readonly ReportingDestinationPatternV1[];
-/** Same constraint the protocol puts on `method.transport`. */
+/**
+ * Same constraint the protocol puts on `method.transport`.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export declare const REPORTING_DESTINATION_TRANSPORT_PATTERN_V1: RegExp;
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface ReportingDestinationAuthorizationV1 {
     account_id: string;
     destination_ref: string;
@@ -38,6 +55,9 @@ export interface ReportingDestinationAuthorizationV1 {
     revoked_at?: string;
     cleanup_completed_at?: string;
 }
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface ReportingManagedDeliveryLeaseV1 {
     materialization: ReportingMaterialization;
     binding: ReportingManagedDeliveryBindingV1;
@@ -47,6 +67,9 @@ export interface ReportingManagedDeliveryLeaseV1 {
     generation: number;
     expires_at: string;
 }
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface ReportingDestinationRevocationLeaseV1 {
     authorization: ReportingDestinationAuthorizationV1;
     owner: string;
@@ -65,6 +88,9 @@ export interface ReportingDestinationRevocationLeaseV1 {
     overdue?: boolean;
     remaining_milliseconds?: number;
 }
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export type ReportingReceiptBatchEntryV1 = {
     kind: 'revision';
     receipt: ReportingReceipt;
@@ -72,6 +98,9 @@ export type ReportingReceiptBatchEntryV1 = {
     kind: 'adjustment';
     receipt: ReportingAdjustmentReceipt;
 };
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface ReportingReceiptBatchInputV1 {
     account_id: string;
     consumer_id: string;
@@ -80,13 +109,20 @@ export interface ReportingReceiptBatchInputV1 {
     entries: ReportingReceiptBatchEntryV1[];
     received_at: string;
 }
-/** Agent-wide Managed Delivery promises durably shared by every replica. */
+/**
+ * Agent-wide Managed Delivery promises durably shared by every replica.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface ReportingManagedDeliveryAdvertisedPoliciesV1 {
     automatedRecoveryWindowSeconds: number;
     statusRetentionDays: number;
     resourceRetentionDays: number;
     authorizationRevocationSeconds: number;
 }
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface ReportingManagedDeliveryStore {
     /**
      * Prove that this store shares the supplied Core authority and has its
@@ -243,6 +279,9 @@ export interface ReportingManagedDeliveryStore {
     }): Promise<boolean>;
     syncReceiptBatch(input: ReportingReceiptBatchInputV1): Promise<SyncReportingReceiptsResponse['results']>;
 }
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface ReportingManagedDeliveryAdapterV1 {
     /** Profiles this installed adapter can actually verify through its consumer/destination path. */
     readonly verificationProfiles: readonly ReportingVerification['verification_profile'][];
@@ -318,6 +357,8 @@ export interface ReportingManagedDeliveryAdapterV1 {
  * when the installed adapter is a router, so a single-adapter runtime's result
  * shape is unchanged. Work that no route could take is counted under
  * `UNROUTED_REPORTING_ROUTE_KEY_V1`, which no route id can equal.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
  */
 export interface ReportingManagedDeliveryRouteCountsV1 {
     /** Materializations settled as delivered, by the route that delivered them. */
@@ -331,8 +372,15 @@ export interface ReportingManagedDeliveryRouteCountsV1 {
     /** Revocations that had already outlived the advertised window when claimed, by route. */
     overdueByRoute: Record<string, number>;
 }
-/** Key for work no delivery route could take. Not a valid route id. */
+/**
+ * Key for work no delivery route could take. Not a valid route id.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export declare const UNROUTED_REPORTING_ROUTE_KEY_V1 = "~unrouted";
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface ReportingManagedDeliveryWorkerResultV1 extends Partial<ReportingManagedDeliveryRouteCountsV1> {
     planned: number;
     claimed: number;
@@ -343,6 +391,9 @@ export interface ReportingManagedDeliveryWorkerResultV1 extends Partial<Reportin
     /** Materializations failed for using every delivery attempt. */
     exhausted: number;
 }
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface ReportingManagedDeliveryWorkerOptionsV1 {
     signal?: AbortSignal;
     now?: () => Date;
@@ -374,6 +425,9 @@ export interface ReportingManagedDeliveryWorkerOptionsV1 {
      */
     hydrateRevision?: (revision: ReportingManagedDeliveryLeaseV1['revision'], account_id: string, signal: AbortSignal | undefined) => Promise<ReportingManagedDeliveryLeaseV1['revision']>;
 }
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface CreateReportingManagedDeliveryRuntimeOptionsV1<TContext extends {
     account?: unknown;
 } = {
@@ -392,6 +446,9 @@ export interface CreateReportingManagedDeliveryRuntimeOptionsV1<TContext extends
     resolveConsumerId?: (context: TContext) => string | Promise<string>;
     consumerMismatchEscalation?: ReportingStatusConsumerScopeOptionsV1<TContext>['consumerMismatchEscalation'];
 }
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface ReportingManagedDeliveryRuntimeV1<TContext extends {
     account?: unknown;
 } = {
@@ -416,6 +473,8 @@ export interface ReportingManagedDeliveryRuntimeV1<TContext extends {
  * Wires all operational components before returning any Managed Delivery
  * capability claim. A missing receipt principal resolver limits the runtime to
  * Managed Delivery even if a consumer-receipt offering was supplied.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
  */
 export declare function createReportingManagedDeliveryRuntime<TContext extends {
     account?: unknown;
@@ -425,7 +484,13 @@ export declare function createReportingManagedDeliveryRuntime<TContext extends {
 export declare function createSyncReportingReceiptsHandler<TContext extends {
     account?: unknown;
 }>(store: ReportingManagedDeliveryStore, resolveConsumerId: (context: TContext) => string | Promise<string>, now?: () => Date): (request: AdcpToolMap["sync_reporting_receipts"]["params"], context: TContext) => Promise<SyncReportingReceiptsResponse>;
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export declare function runManagedDeliveryWorker(store: ReportingManagedDeliveryStore, adapter: ReportingManagedDeliveryAdapterV1, options?: ReportingManagedDeliveryWorkerOptionsV1): Promise<ReportingManagedDeliveryWorkerResultV1>;
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export declare function readManagedReportingResource(store: ReportingManagedDeliveryStore, adapter: ReportingManagedDeliveryAdapterV1, input: {
     account_id: string;
     resource_ref: string;
@@ -433,12 +498,21 @@ export declare function readManagedReportingResource(store: ReportingManagedDeli
     maxBytes?: number;
     deadlineMilliseconds?: number;
 }): Promise<Uint8Array | null>;
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export declare function assertMaterializationOutcome(lease: ReportingManagedDeliveryLeaseV1, outcome: {
     status: 'available' | 'delivered';
     resource: ReportingResource;
     verification: ReportingVerification;
 }, now: string, minimumResourceRetentionDays?: number): void;
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export declare function receiptEvidenceMatches(receipt: ReportingReceipt, materialization: ReportingMaterialization): boolean;
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export declare function adjustmentReceiptEvidenceMatches(receipt: ReportingAdjustmentReceipt, adjustment: ReportingLedgerAdjustmentV1): boolean;
 /**
  * Refuses a retained resource location that carries credential syntax.
@@ -447,9 +521,15 @@ export declare function adjustmentReceiptEvidenceMatches(receipt: ReportingAdjus
  * storage: a caller driving `settleMaterialization` directly must be held to
  * the same rule, or a presigned location is persisted and then published in
  * `get_reporting_status`.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
  */
 export declare function assertCredentialFreeReportingResourceLocationV1(location: string): void;
-/** Stable helper for immutable binding creation. */
+/**
+ * Stable helper for immutable binding creation.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export declare function reportingManagedDeliveryBindingV1(input: Omit<ReportingManagedDeliveryBindingV1, 'created_at' | 'semantic_fingerprint'> & {
     created_at?: string;
 }): ReportingManagedDeliveryBindingV1;

package/dist/lib/reporting/ledger/managed.d.ts

@@ -7,14 +7,31 @@ import type { ReportingLedgerAdjustmentV1, ReportingLegacyRevisionReaderV1, Repo
  * Upper bound on an adapter's startup probe, so a hung provider cannot hang startup.
  * A router's per-route probe budget must stay under it, or this deadline fires
  * first and the failing route's id never reaches the startup error.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
  */
 export declare const REPORTING_ADAPTER_PROBE_DEADLINE_MILLISECONDS_V1 = 30000;
-/** The delivery pattern a destination authorization generation serves. */
+/**
+ * The delivery pattern a destination authorization generation serves.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export type ReportingDestinationPatternV1 = ReportingManagedDeliveryBindingV1['method'];
-/** Delivery patterns, in the order the protocol lists them. */
+/**
+ * Delivery patterns, in the order the protocol lists them.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export declare const REPORTING_DESTINATION_PATTERNS_V1: readonly ReportingDestinationPatternV1[];
-/** Same constraint the protocol puts on `method.transport`. */
+/**
+ * Same constraint the protocol puts on `method.transport`.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export declare const REPORTING_DESTINATION_TRANSPORT_PATTERN_V1: RegExp;
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface ReportingDestinationAuthorizationV1 {
     account_id: string;
     destination_ref: string;
@@ -38,6 +55,9 @@ export interface ReportingDestinationAuthorizationV1 {
     revoked_at?: string;
     cleanup_completed_at?: string;
 }
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface ReportingManagedDeliveryLeaseV1 {
     materialization: ReportingMaterialization;
     binding: ReportingManagedDeliveryBindingV1;
@@ -47,6 +67,9 @@ export interface ReportingManagedDeliveryLeaseV1 {
     generation: number;
     expires_at: string;
 }
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface ReportingDestinationRevocationLeaseV1 {
     authorization: ReportingDestinationAuthorizationV1;
     owner: string;
@@ -65,6 +88,9 @@ export interface ReportingDestinationRevocationLeaseV1 {
     overdue?: boolean;
     remaining_milliseconds?: number;
 }
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export type ReportingReceiptBatchEntryV1 = {
     kind: 'revision';
     receipt: ReportingReceipt;
@@ -72,6 +98,9 @@ export type ReportingReceiptBatchEntryV1 = {
     kind: 'adjustment';
     receipt: ReportingAdjustmentReceipt;
 };
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface ReportingReceiptBatchInputV1 {
     account_id: string;
     consumer_id: string;
@@ -80,13 +109,20 @@ export interface ReportingReceiptBatchInputV1 {
     entries: ReportingReceiptBatchEntryV1[];
     received_at: string;
 }
-/** Agent-wide Managed Delivery promises durably shared by every replica. */
+/**
+ * Agent-wide Managed Delivery promises durably shared by every replica.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface ReportingManagedDeliveryAdvertisedPoliciesV1 {
     automatedRecoveryWindowSeconds: number;
     statusRetentionDays: number;
     resourceRetentionDays: number;
     authorizationRevocationSeconds: number;
 }
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface ReportingManagedDeliveryStore {
     /**
      * Prove that this store shares the supplied Core authority and has its
@@ -243,6 +279,9 @@ export interface ReportingManagedDeliveryStore {
     }): Promise<boolean>;
     syncReceiptBatch(input: ReportingReceiptBatchInputV1): Promise<SyncReportingReceiptsResponse['results']>;
 }
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface ReportingManagedDeliveryAdapterV1 {
     /** Profiles this installed adapter can actually verify through its consumer/destination path. */
     readonly verificationProfiles: readonly ReportingVerification['verification_profile'][];
@@ -318,6 +357,8 @@ export interface ReportingManagedDeliveryAdapterV1 {
  * when the installed adapter is a router, so a single-adapter runtime's result
  * shape is unchanged. Work that no route could take is counted under
  * `UNROUTED_REPORTING_ROUTE_KEY_V1`, which no route id can equal.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
  */
 export interface ReportingManagedDeliveryRouteCountsV1 {
     /** Materializations settled as delivered, by the route that delivered them. */
@@ -331,8 +372,15 @@ export interface ReportingManagedDeliveryRouteCountsV1 {
     /** Revocations that had already outlived the advertised window when claimed, by route. */
     overdueByRoute: Record<string, number>;
 }
-/** Key for work no delivery route could take. Not a valid route id. */
+/**
+ * Key for work no delivery route could take. Not a valid route id.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export declare const UNROUTED_REPORTING_ROUTE_KEY_V1 = "~unrouted";
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface ReportingManagedDeliveryWorkerResultV1 extends Partial<ReportingManagedDeliveryRouteCountsV1> {
     planned: number;
     claimed: number;
@@ -343,6 +391,9 @@ export interface ReportingManagedDeliveryWorkerResultV1 extends Partial<Reportin
     /** Materializations failed for using every delivery attempt. */
     exhausted: number;
 }
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface ReportingManagedDeliveryWorkerOptionsV1 {
     signal?: AbortSignal;
     now?: () => Date;
@@ -374,6 +425,9 @@ export interface ReportingManagedDeliveryWorkerOptionsV1 {
      */
     hydrateRevision?: (revision: ReportingManagedDeliveryLeaseV1['revision'], account_id: string, signal: AbortSignal | undefined) => Promise<ReportingManagedDeliveryLeaseV1['revision']>;
 }
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface CreateReportingManagedDeliveryRuntimeOptionsV1<TContext extends {
     account?: unknown;
 } = {
@@ -392,6 +446,9 @@ export interface CreateReportingManagedDeliveryRuntimeOptionsV1<TContext extends
     resolveConsumerId?: (context: TContext) => string | Promise<string>;
     consumerMismatchEscalation?: ReportingStatusConsumerScopeOptionsV1<TContext>['consumerMismatchEscalation'];
 }
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export interface ReportingManagedDeliveryRuntimeV1<TContext extends {
     account?: unknown;
 } = {
@@ -416,6 +473,8 @@ export interface ReportingManagedDeliveryRuntimeV1<TContext extends {
  * Wires all operational components before returning any Managed Delivery
  * capability claim. A missing receipt principal resolver limits the runtime to
  * Managed Delivery even if a consumer-receipt offering was supplied.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
  */
 export declare function createReportingManagedDeliveryRuntime<TContext extends {
     account?: unknown;
@@ -425,7 +484,13 @@ export declare function createReportingManagedDeliveryRuntime<TContext extends {
 export declare function createSyncReportingReceiptsHandler<TContext extends {
     account?: unknown;
 }>(store: ReportingManagedDeliveryStore, resolveConsumerId: (context: TContext) => string | Promise<string>, now?: () => Date): (request: AdcpToolMap["sync_reporting_receipts"]["params"], context: TContext) => Promise<SyncReportingReceiptsResponse>;
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export declare function runManagedDeliveryWorker(store: ReportingManagedDeliveryStore, adapter: ReportingManagedDeliveryAdapterV1, options?: ReportingManagedDeliveryWorkerOptionsV1): Promise<ReportingManagedDeliveryWorkerResultV1>;
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export declare function readManagedReportingResource(store: ReportingManagedDeliveryStore, adapter: ReportingManagedDeliveryAdapterV1, input: {
     account_id: string;
     resource_ref: string;
@@ -433,12 +498,21 @@ export declare function readManagedReportingResource(store: ReportingManagedDeli
     maxBytes?: number;
     deadlineMilliseconds?: number;
 }): Promise<Uint8Array | null>;
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export declare function assertMaterializationOutcome(lease: ReportingManagedDeliveryLeaseV1, outcome: {
     status: 'available' | 'delivered';
     resource: ReportingResource;
     verification: ReportingVerification;
 }, now: string, minimumResourceRetentionDays?: number): void;
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export declare function receiptEvidenceMatches(receipt: ReportingReceipt, materialization: ReportingMaterialization): boolean;
+/**
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export declare function adjustmentReceiptEvidenceMatches(receipt: ReportingAdjustmentReceipt, adjustment: ReportingLedgerAdjustmentV1): boolean;
 /**
  * Refuses a retained resource location that carries credential syntax.
@@ -447,9 +521,15 @@ export declare function adjustmentReceiptEvidenceMatches(receipt: ReportingAdjus
  * storage: a caller driving `settleMaterialization` directly must be held to
  * the same rule, or a presigned location is persisted and then published in
  * `get_reporting_status`.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
  */
 export declare function assertCredentialFreeReportingResourceLocationV1(location: string): void;
-/** Stable helper for immutable binding creation. */
+/**
+ * Stable helper for immutable binding creation.
+ *
+ * @experimental Reliable Reporting storage surface: breaking changes may ship in minor releases. See https://github.com/adcontextprotocol/adcp-client/blob/main/docs/guides/REPORTING-STABILITY.md
+ */
 export declare function reportingManagedDeliveryBindingV1(input: Omit<ReportingManagedDeliveryBindingV1, 'created_at' | 'semantic_fingerprint'> & {
     created_at?: string;
 }): ReportingManagedDeliveryBindingV1;