@adcp/sdk 15.9.0 → 16.0.0-beta.1

package/dist/lib/reporting/ledger/row-encoding.d.mts

@@ -17,17 +17,59 @@
  * A row larger than the chunk byte limit forms its own segment and chunk.
  * Digests always cover uncompressed canonical bytes.
  */
-export declare const REPORTING_ROW_ENCODING_V1: "adcp_canonical_jsonl_v1";
+/**
+ * Stored row format and canonicalization algorithm, as AdCP names them
+ * (`reporting-file-manifest.json` `format`, `reporting-canonicalization-contract.json`
+ * `algorithm`). Neither value is an input to any digest: segment, chunk and
+ * manifest digests cover chunk bytes and manifest fields, and the protocol
+ * `revision_content_sha256` covers the envelope and rows. They label the
+ * encoding and are pinned by the row-set `CHECK` constraints.
+ *
+ * `adcp_jcs_rows_v1` names the per-row RFC 8785 canonicalization. The stored
+ * chunk layout is one canonical row per line (`jsonl`); the protocol content
+ * digest is still computed by the streaming hashers below.
+ *
+ * @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_ROW_FORMAT_V1: "jsonl";
+/**
+ * @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_ROW_ALGORITHM_V1: "adcp_jcs_rows_v1";
+/**
+ * @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_ROW_SEGMENT_MAX_ROWS = 500;
+/**
+ * @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_ROW_CHUNK_MAX_SEGMENTS = 20;
+/**
+ * @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_ROW_CHUNK_MAX_ROWS: 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 const REPORTING_ROW_CHUNK_MAX_BYTES: 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 ReportingRowEncodingErrorCode = 'INVALID_ROW' | 'MANIFEST_MISMATCH' | 'CHUNK_INTEGRITY_FAILED' | 'ENVELOPE_INTEGRITY_FAILED';
+/**
+ * @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 ReportingRowEncodingError extends Error {
     readonly code: ReportingRowEncodingErrorCode;
     constructor(code: ReportingRowEncodingErrorCode, detail: 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 isReportingRowEncodingError(error: unknown): error is ReportingRowEncodingError;
+/**
+ * @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 ReportingRowSegmentManifestV1 {
     first_ordinal: number;
     row_count: number;
@@ -36,6 +78,9 @@ export interface ReportingRowSegmentManifestV1 {
     byte_count: number;
     sha256: 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 ReportingRowChunkManifestV1 {
     chunk_index: number;
     first_ordinal: number;
@@ -44,13 +89,20 @@ export interface ReportingRowChunkManifestV1 {
     sha256: string;
     segments: ReportingRowSegmentManifestV1[];
 }
+/**
+ * @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 ReportingRowChunkV1 {
     manifest: ReportingRowChunkManifestV1;
     /** Uncompressed canonical JSONL bytes. */
     bytes: Buffer;
 }
+/**
+ * @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 ReportingEncodedRowsV1 {
-    encoding: typeof REPORTING_ROW_ENCODING_V1;
+    format: typeof REPORTING_ROW_FORMAT_V1;
+    algorithm: typeof REPORTING_ROW_ALGORITHM_V1;
     rowCount: number;
     /** Total canonical JSONL bytes across all chunks. */
     byteCount: number;
@@ -59,11 +111,17 @@ export interface ReportingEncodedRowsV1 {
     /** `sha256(JCS(manifests))`; bound immutably on the revision header. */
     rowManifestSha256: 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 ReportingRevisionEnvelopeInputV1 {
     reporting_revision_id: string;
     row_count: number;
     control_totals: 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 ReportingRevisionEnvelopeDigestV1 {
     sha256: string;
     /** Byte length of the canonical envelope; equals `binding.byteCount`. */
@@ -73,17 +131,29 @@ export interface ReportingRevisionEnvelopeDigestV1 {
  * Canonicalize one row for storage. Refuses values whose canonical bytes are
  * not portable across conforming JCS implementations: non-plain objects,
  * non-finite numbers, integers outside ±(2^53 − 1), and lone surrogates.
+ *
+ * @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 canonicalReportingRowV1(row: unknown, ordinal?: number): string;
-/** Encode rows into contract-fixed canonical JSONL chunks and manifests. */
+/**
+ * Encode rows into contract-fixed canonical JSONL chunks and manifests.
+ *
+ * @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 encodeReportingRowsV1(rows: readonly unknown[]): ReportingEncodedRowsV1;
-/** `sha256(JCS(manifests))` over the ordered chunk manifests, locators excluded. */
+/**
+ * `sha256(JCS(manifests))` over the ordered chunk manifests, locators excluded.
+ *
+ * @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 reportingRowManifestSha256V1(manifests: readonly ReportingRowChunkManifestV1[]): string;
 /**
  * Verify that a manifest set is internally consistent and matches the
  * header's committed `row_manifest_sha256` and `row_count`. Ordinals must be
  * contiguous from zero, chunk and segment boundaries must follow the contract
  * limits, and segment byte ranges must tile their chunk exactly.
+ *
+ * @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 verifyReportingRowManifestsV1(manifests: readonly ReportingRowChunkManifestV1[], expected: {
     rowCount: number;
@@ -92,6 +162,8 @@ export declare function verifyReportingRowManifestsV1(manifests: readonly Report
 /**
  * Verify a whole chunk's canonical bytes against its manifest: total digest,
  * byte count, and every segment's digest and line count.
+ *
+ * @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 verifyReportingRowChunkV1(manifest: ReportingRowChunkManifestV1, bytes: Uint8Array): void;
 /**
@@ -99,20 +171,32 @@ export declare function verifyReportingRowChunkV1(manifest: ReportingRowChunkMan
  * (inclusive). `bytes` must hold exactly those segments' canonical bytes,
  * starting at the first segment's `byte_offset` — the shape returned by a
  * ranged object read. Rows are released only after every segment verifies.
+ *
+ * @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 decodeVerifiedReportingRowSegmentsV1(manifest: ReportingRowChunkManifestV1, segmentRange: readonly [fromSegment: number, toSegment: number], bytes: Uint8Array): Record<string, unknown>[];
 /**
  * Streaming hasher for the protocol revision binding
  * `sha256(JCS({reporting_revision_id, row_count, control_totals, reporting_rows}))`.
  * Feed verified chunk bytes in order; rows are never parsed.
+ *
+ * @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 createReportingRevisionEnvelopeHasherV1(envelope: ReportingRevisionEnvelopeInputV1): {
     update(chunkBytes: Uint8Array): void;
     digest(): ReportingRevisionEnvelopeDigestV1;
 };
-/** Envelope digest over already-encoded chunk bytes. */
+/**
+ * Envelope digest over already-encoded chunk bytes.
+ *
+ * @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 reportingRevisionEnvelopeDigestV1(envelope: ReportingRevisionEnvelopeInputV1, chunks: Iterable<Uint8Array>): ReportingRevisionEnvelopeDigestV1;
-/** Streaming hasher for digest profile `rows_v1`: `sha256(JCS(rows))`. */
+/**
+ * Streaming hasher for digest profile `rows_v1`: `sha256(JCS(rows))`.
+ *
+ * @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 createReportingRowsOnlyHasherV1(rowCount: number): {
     update(chunkBytes: Uint8Array): void;
     digest(): ReportingRevisionEnvelopeDigestV1;
@@ -121,6 +205,8 @@ export declare function createReportingRowsOnlyHasherV1(rowCount: number): {
  * Throw unless the canonical chunks reproduce the header's committed revision
  * binding. Used at write time (proof that chunks and envelope agree) and for
  * full-revision reads.
+ *
+ * @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 assertReportingRevisionEnvelopeV1(envelope: ReportingRevisionEnvelopeInputV1, chunks: Iterable<Uint8Array>, expected: {
     sha256: string;

package/dist/lib/reporting/ledger/row-encoding.d.ts

@@ -17,17 +17,59 @@
  * A row larger than the chunk byte limit forms its own segment and chunk.
  * Digests always cover uncompressed canonical bytes.
  */
-export declare const REPORTING_ROW_ENCODING_V1: "adcp_canonical_jsonl_v1";
+/**
+ * Stored row format and canonicalization algorithm, as AdCP names them
+ * (`reporting-file-manifest.json` `format`, `reporting-canonicalization-contract.json`
+ * `algorithm`). Neither value is an input to any digest: segment, chunk and
+ * manifest digests cover chunk bytes and manifest fields, and the protocol
+ * `revision_content_sha256` covers the envelope and rows. They label the
+ * encoding and are pinned by the row-set `CHECK` constraints.
+ *
+ * `adcp_jcs_rows_v1` names the per-row RFC 8785 canonicalization. The stored
+ * chunk layout is one canonical row per line (`jsonl`); the protocol content
+ * digest is still computed by the streaming hashers below.
+ *
+ * @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_ROW_FORMAT_V1: "jsonl";
+/**
+ * @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_ROW_ALGORITHM_V1: "adcp_jcs_rows_v1";
+/**
+ * @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_ROW_SEGMENT_MAX_ROWS = 500;
+/**
+ * @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_ROW_CHUNK_MAX_SEGMENTS = 20;
+/**
+ * @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_ROW_CHUNK_MAX_ROWS: 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 const REPORTING_ROW_CHUNK_MAX_BYTES: 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 ReportingRowEncodingErrorCode = 'INVALID_ROW' | 'MANIFEST_MISMATCH' | 'CHUNK_INTEGRITY_FAILED' | 'ENVELOPE_INTEGRITY_FAILED';
+/**
+ * @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 ReportingRowEncodingError extends Error {
     readonly code: ReportingRowEncodingErrorCode;
     constructor(code: ReportingRowEncodingErrorCode, detail: 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 isReportingRowEncodingError(error: unknown): error is ReportingRowEncodingError;
+/**
+ * @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 ReportingRowSegmentManifestV1 {
     first_ordinal: number;
     row_count: number;
@@ -36,6 +78,9 @@ export interface ReportingRowSegmentManifestV1 {
     byte_count: number;
     sha256: 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 ReportingRowChunkManifestV1 {
     chunk_index: number;
     first_ordinal: number;
@@ -44,13 +89,20 @@ export interface ReportingRowChunkManifestV1 {
     sha256: string;
     segments: ReportingRowSegmentManifestV1[];
 }
+/**
+ * @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 ReportingRowChunkV1 {
     manifest: ReportingRowChunkManifestV1;
     /** Uncompressed canonical JSONL bytes. */
     bytes: Buffer;
 }
+/**
+ * @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 ReportingEncodedRowsV1 {
-    encoding: typeof REPORTING_ROW_ENCODING_V1;
+    format: typeof REPORTING_ROW_FORMAT_V1;
+    algorithm: typeof REPORTING_ROW_ALGORITHM_V1;
     rowCount: number;
     /** Total canonical JSONL bytes across all chunks. */
     byteCount: number;
@@ -59,11 +111,17 @@ export interface ReportingEncodedRowsV1 {
     /** `sha256(JCS(manifests))`; bound immutably on the revision header. */
     rowManifestSha256: 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 ReportingRevisionEnvelopeInputV1 {
     reporting_revision_id: string;
     row_count: number;
     control_totals: 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 ReportingRevisionEnvelopeDigestV1 {
     sha256: string;
     /** Byte length of the canonical envelope; equals `binding.byteCount`. */
@@ -73,17 +131,29 @@ export interface ReportingRevisionEnvelopeDigestV1 {
  * Canonicalize one row for storage. Refuses values whose canonical bytes are
  * not portable across conforming JCS implementations: non-plain objects,
  * non-finite numbers, integers outside ±(2^53 − 1), and lone surrogates.
+ *
+ * @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 canonicalReportingRowV1(row: unknown, ordinal?: number): string;
-/** Encode rows into contract-fixed canonical JSONL chunks and manifests. */
+/**
+ * Encode rows into contract-fixed canonical JSONL chunks and manifests.
+ *
+ * @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 encodeReportingRowsV1(rows: readonly unknown[]): ReportingEncodedRowsV1;
-/** `sha256(JCS(manifests))` over the ordered chunk manifests, locators excluded. */
+/**
+ * `sha256(JCS(manifests))` over the ordered chunk manifests, locators excluded.
+ *
+ * @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 reportingRowManifestSha256V1(manifests: readonly ReportingRowChunkManifestV1[]): string;
 /**
  * Verify that a manifest set is internally consistent and matches the
  * header's committed `row_manifest_sha256` and `row_count`. Ordinals must be
  * contiguous from zero, chunk and segment boundaries must follow the contract
  * limits, and segment byte ranges must tile their chunk exactly.
+ *
+ * @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 verifyReportingRowManifestsV1(manifests: readonly ReportingRowChunkManifestV1[], expected: {
     rowCount: number;
@@ -92,6 +162,8 @@ export declare function verifyReportingRowManifestsV1(manifests: readonly Report
 /**
  * Verify a whole chunk's canonical bytes against its manifest: total digest,
  * byte count, and every segment's digest and line count.
+ *
+ * @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 verifyReportingRowChunkV1(manifest: ReportingRowChunkManifestV1, bytes: Uint8Array): void;
 /**
@@ -99,20 +171,32 @@ export declare function verifyReportingRowChunkV1(manifest: ReportingRowChunkMan
  * (inclusive). `bytes` must hold exactly those segments' canonical bytes,
  * starting at the first segment's `byte_offset` — the shape returned by a
  * ranged object read. Rows are released only after every segment verifies.
+ *
+ * @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 decodeVerifiedReportingRowSegmentsV1(manifest: ReportingRowChunkManifestV1, segmentRange: readonly [fromSegment: number, toSegment: number], bytes: Uint8Array): Record<string, unknown>[];
 /**
  * Streaming hasher for the protocol revision binding
  * `sha256(JCS({reporting_revision_id, row_count, control_totals, reporting_rows}))`.
  * Feed verified chunk bytes in order; rows are never parsed.
+ *
+ * @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 createReportingRevisionEnvelopeHasherV1(envelope: ReportingRevisionEnvelopeInputV1): {
     update(chunkBytes: Uint8Array): void;
     digest(): ReportingRevisionEnvelopeDigestV1;
 };
-/** Envelope digest over already-encoded chunk bytes. */
+/**
+ * Envelope digest over already-encoded chunk bytes.
+ *
+ * @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 reportingRevisionEnvelopeDigestV1(envelope: ReportingRevisionEnvelopeInputV1, chunks: Iterable<Uint8Array>): ReportingRevisionEnvelopeDigestV1;
-/** Streaming hasher for digest profile `rows_v1`: `sha256(JCS(rows))`. */
+/**
+ * Streaming hasher for digest profile `rows_v1`: `sha256(JCS(rows))`.
+ *
+ * @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 createReportingRowsOnlyHasherV1(rowCount: number): {
     update(chunkBytes: Uint8Array): void;
     digest(): ReportingRevisionEnvelopeDigestV1;
@@ -121,6 +205,8 @@ export declare function createReportingRowsOnlyHasherV1(rowCount: number): {
  * Throw unless the canonical chunks reproduce the header's committed revision
  * binding. Used at write time (proof that chunks and envelope agree) and for
  * full-revision reads.
+ *
+ * @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 assertReportingRevisionEnvelopeV1(envelope: ReportingRevisionEnvelopeInputV1, chunks: Iterable<Uint8Array>, expected: {
     sha256: string;

package/dist/lib/reporting/ledger/row-encoding.js

@@ -18,10 +18,11 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var row_encoding_exports = {};
 __export(row_encoding_exports, {
+  REPORTING_ROW_ALGORITHM_V1: () => REPORTING_ROW_ALGORITHM_V1,
   REPORTING_ROW_CHUNK_MAX_BYTES: () => REPORTING_ROW_CHUNK_MAX_BYTES,
   REPORTING_ROW_CHUNK_MAX_ROWS: () => REPORTING_ROW_CHUNK_MAX_ROWS,
   REPORTING_ROW_CHUNK_MAX_SEGMENTS: () => REPORTING_ROW_CHUNK_MAX_SEGMENTS,
-  REPORTING_ROW_ENCODING_V1: () => REPORTING_ROW_ENCODING_V1,
+  REPORTING_ROW_FORMAT_V1: () => REPORTING_ROW_FORMAT_V1,
   REPORTING_ROW_SEGMENT_MAX_ROWS: () => REPORTING_ROW_SEGMENT_MAX_ROWS,
   ReportingRowEncodingError: () => ReportingRowEncodingError,
   assertReportingRevisionEnvelopeV1: () => assertReportingRevisionEnvelopeV1,
@@ -39,7 +40,8 @@ __export(row_encoding_exports, {
 module.exports = __toCommonJS(row_encoding_exports);
 var import_crypto = require("crypto");
 var import_jcs = require('../../utils/jcs.js');
-const REPORTING_ROW_ENCODING_V1 = "adcp_canonical_jsonl_v1";
+const REPORTING_ROW_FORMAT_V1 = "jsonl";
+const REPORTING_ROW_ALGORITHM_V1 = "adcp_jcs_rows_v1";
 const REPORTING_ROW_SEGMENT_MAX_ROWS = 500;
 const REPORTING_ROW_CHUNK_MAX_SEGMENTS = 20;
 const REPORTING_ROW_CHUNK_MAX_ROWS = REPORTING_ROW_SEGMENT_MAX_ROWS * REPORTING_ROW_CHUNK_MAX_SEGMENTS;
@@ -101,7 +103,8 @@ function encodeReportingRowsV1(rows) {
   closeChunk();
   const manifests = chunks.map((chunk) => chunk.manifest);
   return {
-    encoding: REPORTING_ROW_ENCODING_V1,
+    format: REPORTING_ROW_FORMAT_V1,
+    algorithm: REPORTING_ROW_ALGORITHM_V1,
     rowCount: rows.length,
     byteCount: chunks.reduce((total, chunk) => total + chunk.manifest.byte_count, 0),
     chunks,
@@ -335,10 +338,11 @@ function sha256Hex(value) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  REPORTING_ROW_ALGORITHM_V1,
   REPORTING_ROW_CHUNK_MAX_BYTES,
   REPORTING_ROW_CHUNK_MAX_ROWS,
   REPORTING_ROW_CHUNK_MAX_SEGMENTS,
-  REPORTING_ROW_ENCODING_V1,
+  REPORTING_ROW_FORMAT_V1,
   REPORTING_ROW_SEGMENT_MAX_ROWS,
   ReportingRowEncodingError,
   assertReportingRevisionEnvelopeV1,

package/dist/lib/reporting/ledger/row-encoding.mjs

@@ -1,6 +1,7 @@
 import { createHash } from "crypto";
 import { canonicalize } from "../../utils/jcs.mjs";
-const REPORTING_ROW_ENCODING_V1 = "adcp_canonical_jsonl_v1";
+const REPORTING_ROW_FORMAT_V1 = "jsonl";
+const REPORTING_ROW_ALGORITHM_V1 = "adcp_jcs_rows_v1";
 const REPORTING_ROW_SEGMENT_MAX_ROWS = 500;
 const REPORTING_ROW_CHUNK_MAX_SEGMENTS = 20;
 const REPORTING_ROW_CHUNK_MAX_ROWS = REPORTING_ROW_SEGMENT_MAX_ROWS * REPORTING_ROW_CHUNK_MAX_SEGMENTS;
@@ -62,7 +63,8 @@ function encodeReportingRowsV1(rows) {
   closeChunk();
   const manifests = chunks.map((chunk) => chunk.manifest);
   return {
-    encoding: REPORTING_ROW_ENCODING_V1,
+    format: REPORTING_ROW_FORMAT_V1,
+    algorithm: REPORTING_ROW_ALGORITHM_V1,
     rowCount: rows.length,
     byteCount: chunks.reduce((total, chunk) => total + chunk.manifest.byte_count, 0),
     chunks,
@@ -295,10 +297,11 @@ function sha256Hex(value) {
   return createHash("sha256").update(value).digest("hex");
 }
 export {
+  REPORTING_ROW_ALGORITHM_V1,
   REPORTING_ROW_CHUNK_MAX_BYTES,
   REPORTING_ROW_CHUNK_MAX_ROWS,
   REPORTING_ROW_CHUNK_MAX_SEGMENTS,
-  REPORTING_ROW_ENCODING_V1,
+  REPORTING_ROW_FORMAT_V1,
   REPORTING_ROW_SEGMENT_MAX_ROWS,
   ReportingRowEncodingError,
   assertReportingRevisionEnvelopeV1,

package/dist/lib/reporting/ledger/row-storage-errors.d.mts

@@ -1,7 +1,17 @@
+/**
+ * @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 ReportingRowStoreErrorCode = 'INVALID_INPUT' | 'CONTENT_CONFLICT' | 'ROWS_INTEGRITY_FAILED' | 'ROWS_UNAVAILABLE' | 'ROWS_EXPIRED' | 'PROVIDER_UNAVAILABLE' | 'DEADLINE_EXCEEDED' | 'ABORTED' | 'UNSAFE_BINDING' | 'STATE_UNAVAILABLE';
-/** Stable, secret-free row-storage failure. Switch on `code`. */
+/**
+ * Stable, secret-free row-storage failure. Switch on `code`.
+ *
+ * @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 ReportingRowStoreError extends Error {
     readonly code: ReportingRowStoreErrorCode;
     constructor(code: ReportingRowStoreErrorCode, detail?: 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 isReportingRowStoreError(error: unknown): error is ReportingRowStoreError;

package/dist/lib/reporting/ledger/row-storage-errors.d.ts

@@ -1,7 +1,17 @@
+/**
+ * @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 ReportingRowStoreErrorCode = 'INVALID_INPUT' | 'CONTENT_CONFLICT' | 'ROWS_INTEGRITY_FAILED' | 'ROWS_UNAVAILABLE' | 'ROWS_EXPIRED' | 'PROVIDER_UNAVAILABLE' | 'DEADLINE_EXCEEDED' | 'ABORTED' | 'UNSAFE_BINDING' | 'STATE_UNAVAILABLE';
-/** Stable, secret-free row-storage failure. Switch on `code`. */
+/**
+ * Stable, secret-free row-storage failure. Switch on `code`.
+ *
+ * @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 ReportingRowStoreError extends Error {
     readonly code: ReportingRowStoreErrorCode;
     constructor(code: ReportingRowStoreErrorCode, detail?: 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 isReportingRowStoreError(error: unknown): error is ReportingRowStoreError;

package/dist/lib/reporting/ledger/row-storage-migration.d.mts

@@ -6,6 +6,16 @@
  * (`gen_random_uuid()`, `sha256()`). Idempotent; reapplying preserves the
  * installation identity and every recorded location.
  *
+ * Stored values use AdCP's names and bounds (`reporting-file-manifest.json`,
+ * `reporting-file-entry.json`): `object_ref` and `native_version_ref` are 1 to
+ * 1024 characters, `size_bytes` is the stored object's size, and the row-set
+ * `format` / `algorithm` are `jsonl` / `adcp_jcs_rows_v1`. A database created by
+ * an earlier 15.x release (`object_key`, `native_version`, `byte_count`,
+ * `physical_byte_count`, `canonical_byte_count`, `encoding`) is renamed in place
+ * by the first block below; the migration also rewrites any open write
+ * intent's `created_objects`. Recorded object keys are not rewritten. Adopters
+ * who have not activated row storage should re-sync instead.
+ *
  * - `adcp_persistence_installation` holds one installation UUID per isolated
  *   schema. A restore of the same authority keeps it; an independently
  *   writable clone must mint a new one before it writes or sweeps.
@@ -22,9 +32,15 @@
  *   predecessor's rows share bodies.
  * - `adcp_reporting_row_write_intents` fences external uploads so a sweep
  *   never deletes bytes a committing writer still needs.
+ *
+ * @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_ROW_STORAGE_MIGRATION: string;
-/** Tables {@link REPORTING_ROW_STORAGE_MIGRATION} creates, in dependency order. */
+/**
+ * Tables {@link REPORTING_ROW_STORAGE_MIGRATION} creates, in dependency order.
+ *
+ * @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_ROW_STORAGE_TABLES: readonly ["adcp_persistence_installation", "adcp_reporting_row_bindings", "adcp_reporting_row_sets", "adcp_reporting_row_chunks", "adcp_reporting_chunk_bodies", "adcp_reporting_row_write_intents"];
 interface QueryablePoolV1 {
     query<Row extends Record<string, unknown> = Record<string, unknown>>(text: string, values?: unknown[]): Promise<{
@@ -34,6 +50,8 @@ interface QueryablePoolV1 {
 /**
  * Fail closed unless every row-storage table exists in the current schema.
  * Returns the installation identity.
+ *
+ * @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 probeReportingRowStorageSchemaV1(pool: QueryablePoolV1): Promise<{
     installationId: string;

package/dist/lib/reporting/ledger/row-storage-migration.d.ts

@@ -6,6 +6,16 @@
  * (`gen_random_uuid()`, `sha256()`). Idempotent; reapplying preserves the
  * installation identity and every recorded location.
  *
+ * Stored values use AdCP's names and bounds (`reporting-file-manifest.json`,
+ * `reporting-file-entry.json`): `object_ref` and `native_version_ref` are 1 to
+ * 1024 characters, `size_bytes` is the stored object's size, and the row-set
+ * `format` / `algorithm` are `jsonl` / `adcp_jcs_rows_v1`. A database created by
+ * an earlier 15.x release (`object_key`, `native_version`, `byte_count`,
+ * `physical_byte_count`, `canonical_byte_count`, `encoding`) is renamed in place
+ * by the first block below; the migration also rewrites any open write
+ * intent's `created_objects`. Recorded object keys are not rewritten. Adopters
+ * who have not activated row storage should re-sync instead.
+ *
  * - `adcp_persistence_installation` holds one installation UUID per isolated
  *   schema. A restore of the same authority keeps it; an independently
  *   writable clone must mint a new one before it writes or sweeps.
@@ -22,9 +32,15 @@
  *   predecessor's rows share bodies.
  * - `adcp_reporting_row_write_intents` fences external uploads so a sweep
  *   never deletes bytes a committing writer still needs.
+ *
+ * @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_ROW_STORAGE_MIGRATION: string;
-/** Tables {@link REPORTING_ROW_STORAGE_MIGRATION} creates, in dependency order. */
+/**
+ * Tables {@link REPORTING_ROW_STORAGE_MIGRATION} creates, in dependency order.
+ *
+ * @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_ROW_STORAGE_TABLES: readonly ["adcp_persistence_installation", "adcp_reporting_row_bindings", "adcp_reporting_row_sets", "adcp_reporting_row_chunks", "adcp_reporting_chunk_bodies", "adcp_reporting_row_write_intents"];
 interface QueryablePoolV1 {
     query<Row extends Record<string, unknown> = Record<string, unknown>>(text: string, values?: unknown[]): Promise<{
@@ -34,6 +50,8 @@ interface QueryablePoolV1 {
 /**
  * Fail closed unless every row-storage table exists in the current schema.
  * Returns the installation identity.
+ *
+ * @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 probeReportingRowStorageSchemaV1(pool: QueryablePoolV1): Promise<{
     installationId: string;