chore: release package (beta)

docs/TYPE-SUMMARY.md

@@ -1,7 +1,7 @@
 # AdCP Type Summary
 
-> Generated at: 2026-10-31
-> @adcp/sdk v17.0.0-beta.11
+> Generated at: 2026-11-02
+> @adcp/sdk v17.0.0-beta.12
 
 Curated reference of the types that matter for using the AdCP client. For full generated types see `src/lib/types/tools.generated.ts` and `src/lib/types/core.generated.ts`.
 

docs/llms.txt

@@ -1,7 +1,7 @@
 # Ad Context Protocol (AdCP)
 
-> Generated at: 2026-10-31
-> Library: @adcp/sdk v17.0.0-beta.11
+> Generated at: 2026-11-02
+> Library: @adcp/sdk v17.0.0-beta.12
 > AdCP major version: 3
 > Canonical URL: https://adcontextprotocol.github.io/adcp-client/llms.txt
 > Note: the `Library` stamp reflects the package.json version at doc-generation time. The narrative below describes the surface that lands on the next-published minor — including any 6.7 helpers documented here ahead of the release tag.

docs/migration-14.x-rc-worksheet.md

@@ -16,8 +16,8 @@ pin using `ADCP_VERSION` inside that tarball.
 
 | Fact | Value |
 | --- | --- |
-| Checkout `package.json` version | `@adcp/sdk@17.0.0-beta.11` |
-| npm integrity | registry-derived after publication; run `npm view @adcp/sdk@17.0.0-beta.11 dist.integrity` |
+| Checkout `package.json` version | `@adcp/sdk@17.0.0-beta.12` |
+| npm integrity | registry-derived after publication; run `npm view @adcp/sdk@17.0.0-beta.12 dist.integrity` |
 | Node.js runtime | `^20.19.0 || >=22.12.0` |
 | Default AdCP wire release | `3.3.0-beta.3` |
 | Maintained wire releases | `v3`, `3.0.0`, `3.0`, `3.0.1`, `3.0.2`, `3.0.3`, `3.0.4`, `3.0.5`, `3.0.6`, `3.0.7`, `3.0.8`, `3.0.9`, `3.0.10`, `3.0.11`, `3.0.12`, `3.0.13`, `3.0.14`, `3.0.15`, `3.0.16`, `3.0.17`, `3.0.18`, `3.0.19`, `3.0.20`, `3.0.21`, `3.0.22`, `3.0.23`, `3.0.24`, `3.0.25`, `3.1.0`, `3.1`, `3.1.1`, `3.1.2`, `3.1.3`, `3.1.4`, `3.1.5`, `3.1.6`, `3.1.7`, `3.1.8`, `3.1.9`, `3.1.10`, `3.1.11`, `3.1.12`, `3.1.13`, `3.1.14`, `3.1.15`, `3.1.16`, `3.1.17`, `3.1.18`, `3.1.19`, `3.1.20`, `3.1.21`, `3.1.22`, `3.1.23`, `3.1.24`, `3.1.25`, `3.1.26`, `3.1.27`, `3.1.28`, `3.1.29`, `3.1.30`, `3.1.31`, `3.2.1`, `3.2`, `3.2.2`, `3.2.3`, `3.2.4`, `3.2.5`, `3.2.6`, `3.2.7`, `3.3.0-beta.3`, `3.3-beta.3` |
@@ -26,8 +26,8 @@ pin using `ADCP_VERSION` inside that tarball.
 For a checkout at the published release commit, install the exact package version:
 
 ```bash
-npm install --save-exact '@adcp/sdk@17.0.0-beta.11'
-npm view '@adcp/sdk@17.0.0-beta.11' dist.integrity
+npm install --save-exact '@adcp/sdk@17.0.0-beta.12'
+npm view '@adcp/sdk@17.0.0-beta.12' dist.integrity
 ```
 
 ### Required and optional peers

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adcp/sdk",
-  "version": "17.0.0-beta.11",
+  "version": "17.0.0-beta.12",
   "description": "AdCP SDK — client, server, and compliance harnesses for the AdContext Protocol (MCP + A2A)",
   "workspaces": [
     ".",

packages/client-shim/package.json

@@ -106,7 +106,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@adcp/sdk": "^17.0.0-beta.11"
+    "@adcp/sdk": "^17.0.0-beta.12"
   },
   "keywords": [
     "adcp",

packages/reporting-storage/CHANGELOG.md

@@ -1,5 +1,38 @@
 # @adcp/reporting-storage
 
+## 0.3.0-beta.3
+
+### Minor Changes
+
+- 8374d8d: Reporting subscriptions (experimental, AdCP 3.3): buyer events.
+  - `client.reporting.poll()` returns the events since the last acknowledgement, derived by comparing what the seller reports now (`reconcile`, the subscription readback, each account's `subscription_coverage[]`) with the snapshot saved by the last `batch.ack()`. Delivery is at least once with deterministic ids (`rse_` + `sha256(agent, type, natural key, version)`, the same ids as the Python SDK). A partial read never fabricates a change, and `poll({ baseline: true })` records the present without emitting it.
+  - `client.reporting.events({ pollEvery, signal })` is the loop: each batch is acknowledged after the loop body has run for all its events.
+  - `client.reporting.handleWebhook(verified)` treats a seller webhook as a doorbell: it wakes a running `events()` loop or polls inline. It takes only a `VerifiedWebhook`, built by `VerifiedWebhook.fromOutcome` from a successful signature verification.
+  - Event types: `revision.available`, `revision.adjusted`, `period.late`, `period.missing_obligation`, `period.withheld`, `coverage.exception_opened`, `coverage.exception_closed`, `account.covered`, `account.unauthorized`, `account.regranted`, `subscription.state_changed`, `timezone.cutover`.
+  - Snapshots live in a `ReportingEventStore` with compare-and-set (`ReportingEventConflictError` when another worker acknowledged first). `memoryStorage().events` and `postgresStorage({ pool }).events` provide one, `createReportingEventStore({ store })` builds one over any `AdcpStateStore` with `putIfMatch`, and the client takes it as `reportingEventStore`.
+  - `@adcp/sdk/reporting/advanced` adds `deriveEvents`, `EVENT_TYPES` and `SNAPSHOT_VERSION`.
+
+### Patch Changes
+
+- 8856bbd: The production service refuses `subscriptions.principal` without `notifications` with a message naming the fix. `@adcp/sdk` now lets development storage omit it; PostgreSQL storage still needs a delivering runtime.
+- f31e94f: Reporting subscriptions (experimental, AdCP 3.3): a PostgreSQL production seller configured with `subscriptions.principal` now serves the same principal surface as the `memoryStorage()` seller. `createPostgresReliableReportingProductionService` builds the principal runtime with the `notification_configs` task (`syncAgentNotificationConfigs`) and marks it as service-built, so the service advertises `capability_changes` for it. Before, it served neither.
+- Updated dependencies [a831111]
+- Updated dependencies [b296a8a]
+- Updated dependencies [9cf1b55]
+- Updated dependencies [6141030]
+- Updated dependencies [ed8f98d]
+- Updated dependencies [b5f7461]
+- Updated dependencies [d134d82]
+- Updated dependencies [f31e94f]
+- Updated dependencies [8374d8d]
+- Updated dependencies [e4b43a3]
+- Updated dependencies [7cfccfd]
+- Updated dependencies [1da37d9]
+- Updated dependencies [dc8cad8]
+- Updated dependencies [b7b9ec8]
+- Updated dependencies [8856bbd]
+  - @adcp/sdk@17.0.0-beta.12
+
 ## 0.3.0-beta.2
 
 ### Minor Changes

packages/reporting-storage/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adcp/reporting-storage",
-  "version": "0.3.0-beta.2",
+  "version": "0.3.0-beta.3",
   "description": "Storage for AdCP Reliable Reporting: the PostgreSQL ledger store, row storage with GCS, S3 and Azure providers, managed delivery, notification activity and the BigQuery warehouse sink. Depends on @adcp/sdk for the protocol layer.",
   "main": "dist/index.js",
   "module": "./dist/index.mjs",
@@ -168,7 +168,7 @@
     "node": "^20.19.0 || >=22.12.0"
   },
   "peerDependencies": {
-    "@adcp/sdk": "^17.0.0-beta.11",
+    "@adcp/sdk": "^17.0.0-beta.12",
     "@aws-sdk/client-s3": "^3.700.0",
     "@azure/storage-blob": "^12.23.0",
     "@google-cloud/storage": "^7.22.0 || ^8.2.0"

src/lib/version.ts

@@ -4,7 +4,7 @@
 /**
  * AdCP SDK library version
  */
-export const LIBRARY_VERSION = '17.0.0-beta.11';
+export const LIBRARY_VERSION = '17.0.0-beta.12';
 
 /**
  * AdCP specification version this library is built for
@@ -113,10 +113,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
  * Full version information
  */
 export const VERSION_INFO = {
-  library: '17.0.0-beta.11',
+  library: '17.0.0-beta.12',
   adcp: '3.3.0-beta.3',
   compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
-  generatedAt: '2026-10-31T21:29:26.679Z',
+  generatedAt: '2026-11-02T04:12:19.065Z',
 } as const;
 
 /**