@adcp/sdk 14.0.0-beta.18 → 14.0.0-beta.19

package/dist/lib/schemas-data/v2.5/_provenance.json

@@ -4,5 +4,5 @@
   "source_sha": "4e553ad955f83b49c7d221ab5c3ff78237ad02e3",
   "source_tarball_sha256": "580656d6466ef9f0d1119985e6726c2efea718dc671e2ad30957fcb2fd54af0f",
   "upstream_adcp_version": "2.5.3",
-  "synced_at": "2026-08-30T04:04:07.159Z"
+  "synced_at": "2026-08-30T04:26:50.358Z"
 }

package/dist/lib/server/decisioning/runtime/postgres-task-settlement-intents.js

@@ -82,6 +82,23 @@ CREATE TABLE IF NOT EXISTS ${table} (
   CONSTRAINT ${table}_valid_payload CHECK (jsonb_typeof(payload) = 'object')
 );
 
+-- Upgrade queues provisioned by an earlier SDK beta before creating indexes
+-- or writing the acknowledged state. These operations are deliberately
+-- idempotent so operators can rerun the generated migration safely.
+ALTER TABLE ${table}
+  ADD COLUMN IF NOT EXISTS retain_until TIMESTAMPTZ;
+
+ALTER TABLE ${table} DROP CONSTRAINT IF EXISTS ${table}_valid_state;
+ALTER TABLE ${table}
+  ADD CONSTRAINT ${table}_valid_state CHECK (state IN ('pending', 'dead_letter', 'acknowledged'));
+
+ALTER TABLE ${table} DROP CONSTRAINT IF EXISTS ${table}_valid_retention;
+ALTER TABLE ${table}
+  ADD CONSTRAINT ${table}_valid_retention CHECK (
+    (state = 'acknowledged' AND retain_until IS NOT NULL) OR
+    (state <> 'acknowledged' AND retain_until IS NULL)
+  );
+
 CREATE INDEX IF NOT EXISTS idx_${table}_due
   ON ${table}(queue_namespace, next_attempt_at, lease_expires_at)
   WHERE state = 'pending';
@@ -129,57 +146,57 @@ function createPostgresTaskSettlementIntentQueue(options) {
            task_id = EXCLUDED.task_id,
            action = EXCLUDED.action,
            payload = CASE
-             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= clock_timestamp()
+             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= statement_timestamp()
                THEN EXCLUDED.payload
              ELSE ${table}.payload
            END,
            intent_fingerprint = EXCLUDED.intent_fingerprint,
            state = CASE
-             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= clock_timestamp()
+             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= statement_timestamp()
                THEN 'pending'
              ELSE ${table}.state
            END,
            attempt_count = CASE
-             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= clock_timestamp()
+             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= statement_timestamp()
                THEN 0
              ELSE ${table}.attempt_count
            END,
            next_attempt_at = CASE
-             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= clock_timestamp()
-               THEN clock_timestamp()
+             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= statement_timestamp()
+               THEN statement_timestamp()
              ELSE ${table}.next_attempt_at
            END,
            lease_owner = CASE
-             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= clock_timestamp()
+             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= statement_timestamp()
                THEN NULL
              ELSE ${table}.lease_owner
            END,
            lease_claim_id = CASE
-             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= clock_timestamp()
+             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= statement_timestamp()
                THEN NULL
              ELSE ${table}.lease_claim_id
            END,
            lease_expires_at = CASE
-             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= clock_timestamp()
+             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= statement_timestamp()
                THEN NULL
              ELSE ${table}.lease_expires_at
            END,
            last_error = CASE
-             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= clock_timestamp()
+             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= statement_timestamp()
                THEN NULL
              ELSE ${table}.last_error
            END,
            retain_until = CASE
-             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= clock_timestamp()
+             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= statement_timestamp()
                THEN NULL
              ELSE ${table}.retain_until
            END,
            created_at = CASE
-             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= clock_timestamp()
-               THEN clock_timestamp()
+             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= statement_timestamp()
+               THEN statement_timestamp()
              ELSE ${table}.created_at
            END,
-           updated_at = clock_timestamp()
+           updated_at = statement_timestamp()
            WHERE (
              ${table}.registry_id = EXCLUDED.registry_id
              AND ${table}.account_id = EXCLUDED.account_id
@@ -189,7 +206,7 @@ function createPostgresTaskSettlementIntentQueue(options) {
              AND ${table}.intent_fingerprint = EXCLUDED.intent_fingerprint
            ) OR (
              ${table}.state = 'acknowledged'
-             AND ${table}.retain_until <= clock_timestamp()
+             AND ${table}.retain_until <= statement_timestamp()
            )
          RETURNING task_id`,
         [
@@ -205,9 +222,7 @@ function createPostgresTaskSettlementIntentQueue(options) {
         ]
       );
       if (result.rowCount !== 1) {
-        throw new TaskSettlementIntentConflictError(
-          `Task ${ref.taskId} is already bound to a different settlement intent`
-        );
+        throw new TaskSettlementIntentConflictError("Task is already bound to a different settlement intent");
       }
       return checkpointFor(namespace, ref, fingerprint);
     },

package/dist/lib/server/decisioning/runtime/postgres-task-settlement-intents.mjs

@@ -55,6 +55,23 @@ CREATE TABLE IF NOT EXISTS ${table} (
   CONSTRAINT ${table}_valid_payload CHECK (jsonb_typeof(payload) = 'object')
 );
 
+-- Upgrade queues provisioned by an earlier SDK beta before creating indexes
+-- or writing the acknowledged state. These operations are deliberately
+-- idempotent so operators can rerun the generated migration safely.
+ALTER TABLE ${table}
+  ADD COLUMN IF NOT EXISTS retain_until TIMESTAMPTZ;
+
+ALTER TABLE ${table} DROP CONSTRAINT IF EXISTS ${table}_valid_state;
+ALTER TABLE ${table}
+  ADD CONSTRAINT ${table}_valid_state CHECK (state IN ('pending', 'dead_letter', 'acknowledged'));
+
+ALTER TABLE ${table} DROP CONSTRAINT IF EXISTS ${table}_valid_retention;
+ALTER TABLE ${table}
+  ADD CONSTRAINT ${table}_valid_retention CHECK (
+    (state = 'acknowledged' AND retain_until IS NOT NULL) OR
+    (state <> 'acknowledged' AND retain_until IS NULL)
+  );
+
 CREATE INDEX IF NOT EXISTS idx_${table}_due
   ON ${table}(queue_namespace, next_attempt_at, lease_expires_at)
   WHERE state = 'pending';
@@ -102,57 +119,57 @@ function createPostgresTaskSettlementIntentQueue(options) {
            task_id = EXCLUDED.task_id,
            action = EXCLUDED.action,
            payload = CASE
-             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= clock_timestamp()
+             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= statement_timestamp()
                THEN EXCLUDED.payload
              ELSE ${table}.payload
            END,
            intent_fingerprint = EXCLUDED.intent_fingerprint,
            state = CASE
-             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= clock_timestamp()
+             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= statement_timestamp()
                THEN 'pending'
              ELSE ${table}.state
            END,
            attempt_count = CASE
-             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= clock_timestamp()
+             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= statement_timestamp()
                THEN 0
              ELSE ${table}.attempt_count
            END,
            next_attempt_at = CASE
-             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= clock_timestamp()
-               THEN clock_timestamp()
+             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= statement_timestamp()
+               THEN statement_timestamp()
              ELSE ${table}.next_attempt_at
            END,
            lease_owner = CASE
-             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= clock_timestamp()
+             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= statement_timestamp()
                THEN NULL
              ELSE ${table}.lease_owner
            END,
            lease_claim_id = CASE
-             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= clock_timestamp()
+             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= statement_timestamp()
                THEN NULL
              ELSE ${table}.lease_claim_id
            END,
            lease_expires_at = CASE
-             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= clock_timestamp()
+             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= statement_timestamp()
                THEN NULL
              ELSE ${table}.lease_expires_at
            END,
            last_error = CASE
-             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= clock_timestamp()
+             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= statement_timestamp()
                THEN NULL
              ELSE ${table}.last_error
            END,
            retain_until = CASE
-             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= clock_timestamp()
+             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= statement_timestamp()
                THEN NULL
              ELSE ${table}.retain_until
            END,
            created_at = CASE
-             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= clock_timestamp()
-               THEN clock_timestamp()
+             WHEN ${table}.state = 'acknowledged' AND ${table}.retain_until <= statement_timestamp()
+               THEN statement_timestamp()
              ELSE ${table}.created_at
            END,
-           updated_at = clock_timestamp()
+           updated_at = statement_timestamp()
            WHERE (
              ${table}.registry_id = EXCLUDED.registry_id
              AND ${table}.account_id = EXCLUDED.account_id
@@ -162,7 +179,7 @@ function createPostgresTaskSettlementIntentQueue(options) {
              AND ${table}.intent_fingerprint = EXCLUDED.intent_fingerprint
            ) OR (
              ${table}.state = 'acknowledged'
-             AND ${table}.retain_until <= clock_timestamp()
+             AND ${table}.retain_until <= statement_timestamp()
            )
          RETURNING task_id`,
         [
@@ -178,9 +195,7 @@ function createPostgresTaskSettlementIntentQueue(options) {
         ]
       );
       if (result.rowCount !== 1) {
-        throw new TaskSettlementIntentConflictError(
-          `Task ${ref.taskId} is already bound to a different settlement intent`
-        );
+        throw new TaskSettlementIntentConflictError("Task is already bound to a different settlement intent");
       }
       return checkpointFor(namespace, ref, fingerprint);
     },

package/dist/lib/testing/storyboard/validations.d.mts

@@ -197,7 +197,7 @@ export interface UpstreamTrafficQueryResult {
  */
 export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
 /** Capability semver emitted in run summaries and used for advisory expiry. */
-export declare const RUNNER_CAPABILITY_VERSION = "14.0.0-beta.18";
+export declare const RUNNER_CAPABILITY_VERSION = "14.0.0-beta.19";
 /** True when a failed validation contributes to the owning step's grade. */
 export declare function validationFailsStep(result: ValidationResult): boolean;
 /**

package/dist/lib/testing/storyboard/validations.d.ts

@@ -197,7 +197,7 @@ export interface UpstreamTrafficQueryResult {
  */
 export declare function runValidations(validations: StoryboardValidation[], context: ValidationContext): ValidationResult[];
 /** Capability semver emitted in run summaries and used for advisory expiry. */
-export declare const RUNNER_CAPABILITY_VERSION = "14.0.0-beta.18";
+export declare const RUNNER_CAPABILITY_VERSION = "14.0.0-beta.19";
 /** True when a failed validation contributes to the owning step's grade. */
 export declare function validationFailsStep(result: ValidationResult): boolean;
 /**

package/dist/lib/version.d.mts

@@ -1,7 +1,7 @@
 /**
  * AdCP SDK library version
  */
-export declare const LIBRARY_VERSION = "14.0.0-beta.18";
+export declare const LIBRARY_VERSION = "14.0.0-beta.19";
 /**
  * AdCP specification version this library is built for
  */
@@ -33,10 +33,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
  * Full version information
  */
 export declare const VERSION_INFO: {
-    readonly library: "14.0.0-beta.18";
+    readonly library: "14.0.0-beta.19";
     readonly adcp: "3.2.0-beta.9";
     readonly compatibleVersions: readonly ["v2.5", "v2.6", "v3", "3.0.0-beta.1", "3.0-beta.1", "3.0-beta", "3.0.0-beta.3", "3.0-beta.3", "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.2.0-beta.9", "3.2-beta.9"];
-    readonly generatedAt: "2026-08-29T22:10:59.071Z";
+    readonly generatedAt: "2026-08-30T04:12:52.476Z";
 };
 /**
  * Get the AdCP specification version this library is built for

package/dist/lib/version.d.ts

@@ -1,7 +1,7 @@
 /**
  * AdCP SDK library version
  */
-export declare const LIBRARY_VERSION = "14.0.0-beta.18";
+export declare const LIBRARY_VERSION = "14.0.0-beta.19";
 /**
  * AdCP specification version this library is built for
  */
@@ -33,10 +33,10 @@ export type AdcpVersion = (typeof COMPATIBLE_ADCP_VERSIONS)[number];
  * Full version information
  */
 export declare const VERSION_INFO: {
-    readonly library: "14.0.0-beta.18";
+    readonly library: "14.0.0-beta.19";
     readonly adcp: "3.2.0-beta.9";
     readonly compatibleVersions: readonly ["v2.5", "v2.6", "v3", "3.0.0-beta.1", "3.0-beta.1", "3.0-beta", "3.0.0-beta.3", "3.0-beta.3", "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.2.0-beta.9", "3.2-beta.9"];
-    readonly generatedAt: "2026-08-29T22:10:59.071Z";
+    readonly generatedAt: "2026-08-30T04:12:52.476Z";
 };
 /**
  * Get the AdCP specification version this library is built for

package/dist/lib/version.js

@@ -31,7 +31,7 @@ __export(version_exports, {
   toReleasePrecisionVersion: () => toReleasePrecisionVersion
 });
 module.exports = __toCommonJS(version_exports);
-const LIBRARY_VERSION = "14.0.0-beta.18";
+const LIBRARY_VERSION = "14.0.0-beta.19";
 const ADCP_VERSION = "3.2.0-beta.9";
 const ADCP_MAJOR_VERSION = 3;
 const COMPATIBLE_ADCP_VERSIONS = [
@@ -94,10 +94,10 @@ const COMPATIBLE_ADCP_VERSIONS = [
   "3.2-beta.9"
 ];
 const VERSION_INFO = {
-  library: "14.0.0-beta.18",
+  library: "14.0.0-beta.19",
   adcp: "3.2.0-beta.9",
   compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
-  generatedAt: "2026-08-29T22:10:59.071Z"
+  generatedAt: "2026-08-30T04:12:52.476Z"
 };
 function getAdcpVersion() {
   return ADCP_VERSION;

package/dist/lib/version.mjs

@@ -1,4 +1,4 @@
-const LIBRARY_VERSION = "14.0.0-beta.18";
+const LIBRARY_VERSION = "14.0.0-beta.19";
 const ADCP_VERSION = "3.2.0-beta.9";
 const ADCP_MAJOR_VERSION = 3;
 const COMPATIBLE_ADCP_VERSIONS = [
@@ -61,10 +61,10 @@ const COMPATIBLE_ADCP_VERSIONS = [
   "3.2-beta.9"
 ];
 const VERSION_INFO = {
-  library: "14.0.0-beta.18",
+  library: "14.0.0-beta.19",
   adcp: "3.2.0-beta.9",
   compatibleVersions: COMPATIBLE_ADCP_VERSIONS,
-  generatedAt: "2026-08-29T22:10:59.071Z"
+  generatedAt: "2026-08-30T04:12:52.476Z"
 };
 function getAdcpVersion() {
   return ADCP_VERSION;

package/docs/llms.txt

@@ -1,7 +1,7 @@
 # Ad Context Protocol (AdCP)
 
-> Generated at: 2026-08-29
-> Library: @adcp/sdk v14.0.0-beta.18
+> Generated at: 2026-08-30
+> Library: @adcp/sdk v14.0.0-beta.19
 > 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.

package/package.json

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