@adcp/sdk 15.9.1 → 16.0.0-beta.2

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;

package/dist/lib/reporting/ledger/notification-activity.d.mts

@@ -9,6 +9,9 @@ interface ReportingAccountActivityBaseV1 {
     reporting_obligation_id: string;
     occurredAt: 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 ReportingLifecycleActivityV1 extends ReportingAccountActivityBaseV1 {
     activityType: 'reporting.lifecycle_changed';
     notificationType?: 'reporting.status_changed';
@@ -28,6 +31,9 @@ export interface ReportingLifecycleActivityV1 extends ReportingAccountActivityBa
         };
     };
 }
+/**
+ * @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 ReportingLedgerChangedActivityV1 extends ReportingAccountActivityBaseV1 {
     activityType: 'reporting.ledger_changed';
     notificationType: 'reporting.ledger_changed';
@@ -38,6 +44,9 @@ export interface ReportingLedgerChangedActivityV1 extends ReportingAccountActivi
     reporting_adjustment_id?: string;
     adjusts_reporting_revision_id?: 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 ReportingDeliveryReadyActivityV1 extends ReportingAccountActivityBaseV1 {
     activityType: 'reporting.delivery_ready';
     notificationType: 'reporting.delivery_ready';
@@ -50,31 +59,53 @@ export interface ReportingDeliveryReadyActivityV1 extends ReportingAccountActivi
     finality: ReportingLedgerRevisionV1['finality'];
     data_through: string | 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 type ReportingNotificationActivityV1 = ReportingLifecycleActivityV1 | ReportingLedgerChangedActivityV1 | ReportingDeliveryReadyActivityV1;
-/** Backwards-compatible lifecycle activity surface returned by listActivity(). */
+/**
+ * Backwards-compatible lifecycle activity surface returned by listActivity().
+ *
+ * @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 ReportingAccountActivityV1 extends ReportingLifecycleActivityV1 {
 }
+/**
+ * @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 ReportingAccountActivityRecordV1 extends ReportingAccountActivityV1 {
     recordedAt: string;
     notificationProjectedAt?: string;
     /** Set when the claim was bounded out of the pending set without delivering. */
     notificationAbandonedAt?: 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 type ReportingNotificationActivityRecordV1 = ReportingNotificationActivityV1 & {
     recordedAt: string;
     notificationProjectedAt?: string;
     notificationAbandonedAt?: 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 ReportingAccountActivityPageV1 {
     activities: ReportingAccountActivityRecordV1[];
     hasMore: boolean;
     nextCursor?: 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 ReportingNotificationActivityPageV1 {
     activities: ReportingNotificationActivityRecordV1[];
     hasMore: boolean;
     nextCursor?: 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 ReportingNotificationRecoveryMetricsV1 {
     claimed: number;
     matched: number;
@@ -88,18 +119,26 @@ export interface ReportingNotificationRecoveryMetricsV1 {
  * Raised when live delivery authority failed closed for an operational reason
  * rather than a deliberate one. The claim is released and retried; the activity
  * is never projected as delivered.
+ *
+ * @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 ReportingNotificationRetryableSuppressionError extends Error {
     readonly reason: WebhookAttemptSuppressionReason;
     readonly name = "ReportingNotificationRetryableSuppressionError";
     constructor(reason: WebhookAttemptSuppressionReason);
 }
+/**
+ * @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 ReportingNotificationProjectionErrorV1 {
     transitionId: string;
     tenantId: string;
     accountId: string;
     attemptCount: 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 PostgresReportingNotificationActivityOptions {
     db: ReportingLedgerTransactionV1;
     /**
@@ -181,6 +220,9 @@ export interface PostgresReportingNotificationActivityOptions {
      */
     maxAttempts?: 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 PostgresReportingNotificationActivityRuntime {
     readonly port: ReportingLedgerNotificationActivityPortV1<ReportingLedgerTransactionV1>;
     readonly migrations: {
@@ -216,11 +258,21 @@ export interface PostgresReportingNotificationActivityRuntime {
         limit?: number;
     }): Promise<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 declare function getReportingNotificationActivityMigration(options?: {
     tableName?: string;
 }): string;
-/** Child table holding one row per frozen recipient. */
+/**
+ * Child table holding one row per frozen recipient.
+ *
+ * @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 recipientTableName(tableName?: string): 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 declare const REPORTING_NOTIFICATION_ACTIVITY_MIGRATION: string;
 /**
  * Builds the durable pre-POST attempt checkpoint for the reporting activity
@@ -237,7 +289,11 @@ export declare const REPORTING_NOTIFICATION_ACTIVITY_MIGRATION: string;
  * lease: a checkpoint only ever makes a recipient less revisable, which is the
  * safe direction, and an outbox worker legitimately holds no activity lease.
  */
-/** Durable store a checkpoint is bound to, so a mismatched pairing cannot be silent. */
+/**
+ * Durable store a checkpoint is bound to, so a mismatched pairing cannot be silent.
+ *
+ * @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 ReportingNotificationAttemptCheckpointV1 {
     (input: Readonly<NotificationDeliveryAttemptCheckpointInput>): Promise<void | number>;
     /**
@@ -252,6 +308,9 @@ export interface ReportingNotificationAttemptCheckpointV1 {
         tableName: 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 declare function createPostgresReportingNotificationAttemptCheckpoint(options: {
     db: ReportingLedgerTransactionV1;
     namespace?: string;
@@ -266,5 +325,8 @@ export declare function createPostgresReportingNotificationAttemptCheckpoint(opt
      */
     eventTypes?: readonly string[];
 }): ReportingNotificationAttemptCheckpointV1;
+/**
+ * @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 createPostgresReportingNotificationActivityRuntime(options: PostgresReportingNotificationActivityOptions): PostgresReportingNotificationActivityRuntime;
 export {};