@adcp/sdk 14.1.0 → 14.2.0

package/dist/lib/core/SingleAgentClient.d.mts

@@ -199,6 +199,7 @@ export interface SingleAgentClientConfig extends ConversationConfig {
     accountPolicy?: AccountPolicy;
     accountStorage?: BuyerAccountStorage;
     accountRegistryMaxEntries?: number;
+    accountRegistryOptions?: Pick<import('./buyer-account-registry.mjs').BuyerAccountRegistryOptions, 'onDispatchStart' | 'onResult'>;
     /** Trusted stable caller identity for durable registry partitioning. Default is credential fingerprint. */
     accountRegistryScope?: string;
     productCache?: ProductCache;
@@ -1061,7 +1062,9 @@ export declare class SingleAgentClient {
     /**
      * Sync accounts
      */
-    syncAccounts(params: MutatingRequestInput<SyncAccountsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<SyncAccountsResponse>>;
+    syncAccounts(params: MutatingRequestInput<SyncAccountsRequest>, inputHandler?: InputHandler, options?: TaskOptions, 
+    /** @internal Registry-owned final dispatch boundary. */
+    dispatch?: import('./buyer-account-registry.mjs').BuyerAccountProvisioningDispatch): Promise<TaskResult<SyncAccountsResponse>>;
     /**
      * Sync audiences
      */

package/dist/lib/core/SingleAgentClient.d.ts

@@ -199,6 +199,7 @@ export interface SingleAgentClientConfig extends ConversationConfig {
     accountPolicy?: AccountPolicy;
     accountStorage?: BuyerAccountStorage;
     accountRegistryMaxEntries?: number;
+    accountRegistryOptions?: Pick<import('./buyer-account-registry').BuyerAccountRegistryOptions, 'onDispatchStart' | 'onResult'>;
     /** Trusted stable caller identity for durable registry partitioning. Default is credential fingerprint. */
     accountRegistryScope?: string;
     productCache?: ProductCache;
@@ -1061,7 +1062,9 @@ export declare class SingleAgentClient {
     /**
      * Sync accounts
      */
-    syncAccounts(params: MutatingRequestInput<SyncAccountsRequest>, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<SyncAccountsResponse>>;
+    syncAccounts(params: MutatingRequestInput<SyncAccountsRequest>, inputHandler?: InputHandler, options?: TaskOptions, 
+    /** @internal Registry-owned final dispatch boundary. */
+    dispatch?: import('./buyer-account-registry').BuyerAccountProvisioningDispatch): Promise<TaskResult<SyncAccountsResponse>>;
     /**
      * Sync audiences
      */

package/dist/lib/core/SingleAgentClient.js

@@ -883,7 +883,7 @@ class SingleAgentClient {
   getAccountRegistry() {
     return this._accounts ??= new import_buyer_account_registry.BuyerAccountRegistry(
       () => this.accountScope(),
-      async (account, options, taskOptions) => {
+      async (account, options, taskOptions, dispatch) => {
         const caps = await this.getCapabilities(taskOptions);
         const supported = caps.account?.supportedBilling ?? [];
         const billing = options.billing ?? caps.account?.defaultBilling ?? (supported.length === 1 ? supported[0] : void 0);
@@ -896,6 +896,7 @@ class SingleAgentClient {
         }
         return this.syncAccounts(
           {
+            ...dispatch && { idempotency_key: dispatch.idempotencyKey },
             accounts: [
               {
                 ...account,
@@ -906,7 +907,8 @@ class SingleAgentClient {
             ]
           },
           void 0,
-          taskOptions
+          { ...taskOptions, [SKIP_ACCOUNT_REGISTRY_OBSERVATION]: true },
+          dispatch
         );
       },
       this.config.accountStorage,
@@ -933,6 +935,8 @@ class SingleAgentClient {
         throw new Error("Account status reconciliation could not complete pagination.");
       },
       {
+        ...this.config.accountRegistryOptions,
+        provisionOwnsDispatchBoundary: true,
         maxEntries: this.config.accountRegistryMaxEntries,
         normalizeOptions: async (options, taskOptions) => {
           if (options.billing) return options;
@@ -950,7 +954,7 @@ class SingleAgentClient {
    * `resolveAccount()` keeps the SDK 14.0 sync-on-every-call behavior.
    */
   accountRegistryOptedIn() {
-    return (this.config.accountPolicy ?? "off") !== "off" || this.config.accountStorage !== void 0 || this.config.accountRegistryScope !== void 0 || this.config.accountRegistryMaxEntries !== void 0;
+    return (this.config.accountPolicy ?? "off") !== "off" || this.config.accountStorage !== void 0 || this.config.accountRegistryScope !== void 0 || this.config.accountRegistryMaxEntries !== void 0 || this.config.accountRegistryOptions !== void 0;
   }
   accountRegistryContext(task, params, options) {
     const knownOnly = !this.accountRegistryExplicitlyAccessed && (this.config.accountPolicy ?? "off") === "off" && !this.config.accountStorage;
@@ -5307,7 +5311,24 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
   /**
    * Sync accounts
    */
-  async syncAccounts(params, inputHandler, options) {
+  async syncAccounts(params, inputHandler, options, dispatch) {
+    if (dispatch)
+      return this.executeTaskUnprojected(
+        "sync_accounts",
+        params,
+        inputHandler,
+        options,
+        "onSyncAccountsStatusChange",
+        Object.assign(
+          async (effectiveParams) => {
+            if (dispatch.requireIdempotencyKey !== false && effectiveParams.idempotency_key !== dispatch.idempotencyKey)
+              throw new import_errors.ConfigurationError("Account provisioning idempotency key changed before dispatch.");
+            await dispatch.beforeDispatch();
+            return { action: "dispatch_ready" };
+          },
+          { terminalSettlement: "executor" }
+        )
+      );
     return this.executeAndHandle(
       "sync_accounts",
       "onSyncAccountsStatusChange",

package/dist/lib/core/SingleAgentClient.mjs

@@ -953,7 +953,7 @@ class SingleAgentClient {
   getAccountRegistry() {
     return this._accounts ??= new BuyerAccountRegistry(
       () => this.accountScope(),
-      async (account, options, taskOptions) => {
+      async (account, options, taskOptions, dispatch) => {
         const caps = await this.getCapabilities(taskOptions);
         const supported = caps.account?.supportedBilling ?? [];
         const billing = options.billing ?? caps.account?.defaultBilling ?? (supported.length === 1 ? supported[0] : void 0);
@@ -966,6 +966,7 @@ class SingleAgentClient {
         }
         return this.syncAccounts(
           {
+            ...dispatch && { idempotency_key: dispatch.idempotencyKey },
             accounts: [
               {
                 ...account,
@@ -976,7 +977,8 @@ class SingleAgentClient {
             ]
           },
           void 0,
-          taskOptions
+          { ...taskOptions, [SKIP_ACCOUNT_REGISTRY_OBSERVATION]: true },
+          dispatch
         );
       },
       this.config.accountStorage,
@@ -1003,6 +1005,8 @@ class SingleAgentClient {
         throw new Error("Account status reconciliation could not complete pagination.");
       },
       {
+        ...this.config.accountRegistryOptions,
+        provisionOwnsDispatchBoundary: true,
         maxEntries: this.config.accountRegistryMaxEntries,
         normalizeOptions: async (options, taskOptions) => {
           if (options.billing) return options;
@@ -1020,7 +1024,7 @@ class SingleAgentClient {
    * `resolveAccount()` keeps the SDK 14.0 sync-on-every-call behavior.
    */
   accountRegistryOptedIn() {
-    return (this.config.accountPolicy ?? "off") !== "off" || this.config.accountStorage !== void 0 || this.config.accountRegistryScope !== void 0 || this.config.accountRegistryMaxEntries !== void 0;
+    return (this.config.accountPolicy ?? "off") !== "off" || this.config.accountStorage !== void 0 || this.config.accountRegistryScope !== void 0 || this.config.accountRegistryMaxEntries !== void 0 || this.config.accountRegistryOptions !== void 0;
   }
   accountRegistryContext(task, params, options) {
     const knownOnly = !this.accountRegistryExplicitlyAccessed && (this.config.accountPolicy ?? "off") === "off" && !this.config.accountStorage;
@@ -5377,7 +5381,24 @@ Hint: this usually means agent_uri does not include the MCP endpoint path. The S
   /**
    * Sync accounts
    */
-  async syncAccounts(params, inputHandler, options) {
+  async syncAccounts(params, inputHandler, options, dispatch) {
+    if (dispatch)
+      return this.executeTaskUnprojected(
+        "sync_accounts",
+        params,
+        inputHandler,
+        options,
+        "onSyncAccountsStatusChange",
+        Object.assign(
+          async (effectiveParams) => {
+            if (dispatch.requireIdempotencyKey !== false && effectiveParams.idempotency_key !== dispatch.idempotencyKey)
+              throw new ConfigurationError("Account provisioning idempotency key changed before dispatch.");
+            await dispatch.beforeDispatch();
+            return { action: "dispatch_ready" };
+          },
+          { terminalSettlement: "executor" }
+        )
+      );
     return this.executeAndHandle(
       "sync_accounts",
       "onSyncAccountsStatusChange",

package/dist/lib/core/TaskExecutor.d.mts

@@ -41,6 +41,8 @@ export declare function acknowledgeDeferredSettlement(result: TaskResult<any>):
 export declare function rejectDeferredSettlement(result: TaskResult<any>): Promise<void>;
 /** Supporting contract for the internal pre-dispatch boundary. */
 export type BeforeProtocolDispatchHookResult<T> = {
+    action: 'dispatch_ready';
+} | {
     action: 'dispatch_committed';
     /** Require the owning durable coordinator to authorize every seller-input continuation. */
     requireDeferredSettlementResumeAuthorization?: boolean;
@@ -84,7 +86,7 @@ export interface ExternalTaskStatusResult {
     error?: string;
 }
 /** Hook used by higher-level SDK coordinators at the final dispatch boundary. */
-export type BeforeProtocolDispatchHook<T> = (effectiveParams: any, context: BeforeProtocolDispatchContext) => Promise<BeforeProtocolDispatchHookResult<T>>;
+export type BeforeProtocolDispatchHook<T> = ((effectiveParams: any, context: BeforeProtocolDispatchContext) => Promise<BeforeProtocolDispatchHookResult<T>>) & {};
 /**
  * Webhook manager for submitted tasks
  */

package/dist/lib/core/TaskExecutor.d.ts

@@ -41,6 +41,8 @@ export declare function acknowledgeDeferredSettlement(result: TaskResult<any>):
 export declare function rejectDeferredSettlement(result: TaskResult<any>): Promise<void>;
 /** Supporting contract for the internal pre-dispatch boundary. */
 export type BeforeProtocolDispatchHookResult<T> = {
+    action: 'dispatch_ready';
+} | {
     action: 'dispatch_committed';
     /** Require the owning durable coordinator to authorize every seller-input continuation. */
     requireDeferredSettlementResumeAuthorization?: boolean;
@@ -84,7 +86,7 @@ export interface ExternalTaskStatusResult {
     error?: string;
 }
 /** Hook used by higher-level SDK coordinators at the final dispatch boundary. */
-export type BeforeProtocolDispatchHook<T> = (effectiveParams: any, context: BeforeProtocolDispatchContext) => Promise<BeforeProtocolDispatchHookResult<T>>;
+export type BeforeProtocolDispatchHook<T> = ((effectiveParams: any, context: BeforeProtocolDispatchContext) => Promise<BeforeProtocolDispatchHookResult<T>>) & {};
 /**
  * Webhook manager for submitted tasks
  */

package/dist/lib/core/TaskExecutor.js

@@ -944,16 +944,19 @@ class TaskExecutor {
       (0, import_abort.throwIfAborted)(options.signal);
       if (beforeProtocolDispatch) {
         let decision;
-        dispatchBoundaryOwnsTerminalState = true;
+        const ownsSettlement = beforeProtocolDispatch.terminalSettlement !== "executor";
+        dispatchBoundaryOwnsTerminalState = ownsSettlement;
         try {
-          this.compactClosedExternalTaskSettlementFences();
-          if (this.liveExternalTaskSettlementCount() + this.settlementCapacityReservations.size >= COMPACTED_TASK_STATE_LIMIT) {
-            throw new Error("The durable task-settlement capacity is exhausted; no mutation claim was attempted.");
-          }
-          this.settlementCapacityReservations.add(taskId);
-          if (webhookRegistrationPersisted) {
-            await this.config.onDurableSettlementRequired?.(taskId);
-            (0, import_abort.throwIfAborted)(options.signal);
+          if (ownsSettlement) {
+            this.compactClosedExternalTaskSettlementFences();
+            if (this.liveExternalTaskSettlementCount() + this.settlementCapacityReservations.size >= COMPACTED_TASK_STATE_LIMIT) {
+              throw new Error("The durable task-settlement capacity is exhausted; no mutation claim was attempted.");
+            }
+            this.settlementCapacityReservations.add(taskId);
+            if (webhookRegistrationPersisted) {
+              await this.config.onDurableSettlementRequired?.(taskId);
+              (0, import_abort.throwIfAborted)(options.signal);
+            }
           }
           decision = await beforeProtocolDispatch(preparedCall.args, {
             operationId: taskId,
@@ -962,6 +965,7 @@ class TaskExecutor {
             registerExternalTaskSettlement: (handler) => this.registerExternalTaskSettlement(taskId, handler)
           });
           if (decision.action === "dispatch_committed") {
+            if (!ownsSettlement) throw new Error("An executor-settled dispatch hook cannot claim durable settlement.");
             if (decision.requireDeferredSettlementResumeAuthorization === true && this.config.deferredStorage !== void 0) {
               this.requireDeferredSettlementOperationRouting(this.config.deferredStorage);
             }
@@ -985,8 +989,8 @@ class TaskExecutor {
           }
           return (0, import_match.attachMatch)(earlyResult);
         }
-        dispatchCommitted = true;
-        dispatchSettlement = decision;
+        dispatchCommitted = decision.action === "dispatch_committed";
+        dispatchSettlement = decision.action === "dispatch_committed" ? decision : void 0;
       }
       (0, import_abort.throwIfAborted)(options.signal);
       const postDispatchOptions = dispatchCommitted ? { ...options, signal: void 0 } : options;

package/dist/lib/core/TaskExecutor.mjs

@@ -917,16 +917,19 @@ class TaskExecutor {
       throwIfAborted(options.signal);
       if (beforeProtocolDispatch) {
         let decision;
-        dispatchBoundaryOwnsTerminalState = true;
+        const ownsSettlement = beforeProtocolDispatch.terminalSettlement !== "executor";
+        dispatchBoundaryOwnsTerminalState = ownsSettlement;
         try {
-          this.compactClosedExternalTaskSettlementFences();
-          if (this.liveExternalTaskSettlementCount() + this.settlementCapacityReservations.size >= COMPACTED_TASK_STATE_LIMIT) {
-            throw new Error("The durable task-settlement capacity is exhausted; no mutation claim was attempted.");
-          }
-          this.settlementCapacityReservations.add(taskId);
-          if (webhookRegistrationPersisted) {
-            await this.config.onDurableSettlementRequired?.(taskId);
-            throwIfAborted(options.signal);
+          if (ownsSettlement) {
+            this.compactClosedExternalTaskSettlementFences();
+            if (this.liveExternalTaskSettlementCount() + this.settlementCapacityReservations.size >= COMPACTED_TASK_STATE_LIMIT) {
+              throw new Error("The durable task-settlement capacity is exhausted; no mutation claim was attempted.");
+            }
+            this.settlementCapacityReservations.add(taskId);
+            if (webhookRegistrationPersisted) {
+              await this.config.onDurableSettlementRequired?.(taskId);
+              throwIfAborted(options.signal);
+            }
           }
           decision = await beforeProtocolDispatch(preparedCall.args, {
             operationId: taskId,
@@ -935,6 +938,7 @@ class TaskExecutor {
             registerExternalTaskSettlement: (handler) => this.registerExternalTaskSettlement(taskId, handler)
           });
           if (decision.action === "dispatch_committed") {
+            if (!ownsSettlement) throw new Error("An executor-settled dispatch hook cannot claim durable settlement.");
             if (decision.requireDeferredSettlementResumeAuthorization === true && this.config.deferredStorage !== void 0) {
               this.requireDeferredSettlementOperationRouting(this.config.deferredStorage);
             }
@@ -958,8 +962,8 @@ class TaskExecutor {
           }
           return attachMatch(earlyResult);
         }
-        dispatchCommitted = true;
-        dispatchSettlement = decision;
+        dispatchCommitted = decision.action === "dispatch_committed";
+        dispatchSettlement = decision.action === "dispatch_committed" ? decision : void 0;
       }
       throwIfAborted(options.signal);
       const postDispatchOptions = dispatchCommitted ? { ...options, signal: void 0 } : options;

package/dist/lib/core/buyer-account-registry.d.mts

@@ -5,6 +5,8 @@ export interface EnsureAccountOptions {
     billing?: 'operator' | 'agent' | 'advertiser';
     paymentTerms?: PaymentTerms;
     billingEntity?: BusinessEntity;
+    /** Caller-owned retry identity. Settle ambiguous dispatches explicitly with this key; the registry never rotates it. */
+    idempotencyKey?: string;
 }
 export interface ProvisionedAccount {
     account: AccountReference;
@@ -15,13 +17,38 @@ export interface ProvisionedAccount {
     setupTerms?: Partial<Record<keyof EnsureAccountOptions, string>>;
     /** Stored reference aliases for authoritative repair after restart. */
     aliases?: AccountReference[];
+    /** Monotonically increasing row revision when compareAndSet is implemented. */
+    revision?: number;
+    /** Durable claim. Reconcile an uncertain dispatch explicitly before provisioning again. */
+    dispatch?: {
+        idempotencyKey: string;
+        startedAt: string;
+    };
 }
 /** Partitioned by seller and caller scope. Implementations must provide read-your-writes. */
 export interface BuyerAccountStorage {
     get(key: string): Promise<ProvisionedAccount | undefined>;
     set(key: string, account: ProvisionedAccount): Promise<void>;
+    /** Atomically insert (undefined revision) or replace. Store the supplied new revision. Required for multi-process safety. */
+    compareAndSet?(key: string, expectedRevision: number | undefined, account: ProvisionedAccount): Promise<boolean>;
+}
+export interface BuyerAccountDispatch {
+    storageKey: string;
+    account: AccountReference;
+    idempotencyKey: string;
+}
+export interface BuyerAccountProvisioningDispatch {
+    idempotencyKey: string;
+    /** Invoke immediately before the transport receives the mutation. */
+    beforeDispatch(): Promise<void>;
 }
 export interface BuyerAccountRegistryOptions {
+    /** Awaited before dispatch; rejection prevents the mutation. */
+    onDispatchStart?: (dispatch: BuyerAccountDispatch) => Promise<void>;
+    /** Awaited for each seller result before account writes. Rejection preserves the claim for caller reconciliation. */
+    onResult?: (dispatch: BuyerAccountDispatch & {
+        result: TaskResult<unknown>;
+    }) => Promise<void>;
     maxEntries?: number;
     normalizeOptions?: (options: EnsureAccountOptions, taskOptions?: TaskOptions) => Promise<EnsureAccountOptions>;
 }
@@ -30,6 +57,7 @@ export declare class BuyerAccountRegistry {
     private provision;
     private storage?;
     private repair?;
+    private readonly registryOptions;
     private entries;
     private pending;
     private writes;
@@ -41,7 +69,7 @@ export declare class BuyerAccountRegistry {
     private statusEpochs;
     private readonly maxEntries;
     private readonly normalizeOptions?;
-    constructor(scope: () => string, provision: (key: AccountReference, options: EnsureAccountOptions, taskOptions?: TaskOptions) => Promise<TaskResult<SyncAccountsResponse>>, storage?: BuyerAccountStorage | undefined, repair?: ((accountId: string, taskOptions?: TaskOptions) => Promise<readonly unknown[]>) | undefined, options?: BuyerAccountRegistryOptions);
+    constructor(scope: () => string, provision: (key: AccountReference, options: EnsureAccountOptions, taskOptions?: TaskOptions, dispatch?: BuyerAccountProvisioningDispatch) => Promise<TaskResult<SyncAccountsResponse>>, storage?: BuyerAccountStorage | undefined, repair?: ((accountId: string, taskOptions?: TaskOptions) => Promise<readonly unknown[]>) | undefined, registryOptions?: BuyerAccountRegistryOptions);
     private key;
     /** Capture before a seller request; observations older than a status repair are ignored. */
     captureObservation(): number;
@@ -52,7 +80,7 @@ export declare class BuyerAccountRegistry {
     private write;
     private record;
     private enqueue;
-    observeSync(refs: readonly AccountReference[], rows: readonly unknown[], dryRun?: boolean, observationEpoch?: number): Promise<void>;
+    observeSync(refs: readonly AccountReference[], rows: readonly unknown[], dryRun?: boolean, observationEpoch?: number, expectedRevision?: number): Promise<void>;
     private reconcileId;
     observeList(rows: readonly unknown[], queriedAccountId?: string, observationEpoch?: number): Promise<void>;
     private observeListAtScope;

package/dist/lib/core/buyer-account-registry.d.ts

@@ -5,6 +5,8 @@ export interface EnsureAccountOptions {
     billing?: 'operator' | 'agent' | 'advertiser';
     paymentTerms?: PaymentTerms;
     billingEntity?: BusinessEntity;
+    /** Caller-owned retry identity. Settle ambiguous dispatches explicitly with this key; the registry never rotates it. */
+    idempotencyKey?: string;
 }
 export interface ProvisionedAccount {
     account: AccountReference;
@@ -15,13 +17,38 @@ export interface ProvisionedAccount {
     setupTerms?: Partial<Record<keyof EnsureAccountOptions, string>>;
     /** Stored reference aliases for authoritative repair after restart. */
     aliases?: AccountReference[];
+    /** Monotonically increasing row revision when compareAndSet is implemented. */
+    revision?: number;
+    /** Durable claim. Reconcile an uncertain dispatch explicitly before provisioning again. */
+    dispatch?: {
+        idempotencyKey: string;
+        startedAt: string;
+    };
 }
 /** Partitioned by seller and caller scope. Implementations must provide read-your-writes. */
 export interface BuyerAccountStorage {
     get(key: string): Promise<ProvisionedAccount | undefined>;
     set(key: string, account: ProvisionedAccount): Promise<void>;
+    /** Atomically insert (undefined revision) or replace. Store the supplied new revision. Required for multi-process safety. */
+    compareAndSet?(key: string, expectedRevision: number | undefined, account: ProvisionedAccount): Promise<boolean>;
+}
+export interface BuyerAccountDispatch {
+    storageKey: string;
+    account: AccountReference;
+    idempotencyKey: string;
+}
+export interface BuyerAccountProvisioningDispatch {
+    idempotencyKey: string;
+    /** Invoke immediately before the transport receives the mutation. */
+    beforeDispatch(): Promise<void>;
 }
 export interface BuyerAccountRegistryOptions {
+    /** Awaited before dispatch; rejection prevents the mutation. */
+    onDispatchStart?: (dispatch: BuyerAccountDispatch) => Promise<void>;
+    /** Awaited for each seller result before account writes. Rejection preserves the claim for caller reconciliation. */
+    onResult?: (dispatch: BuyerAccountDispatch & {
+        result: TaskResult<unknown>;
+    }) => Promise<void>;
     maxEntries?: number;
     normalizeOptions?: (options: EnsureAccountOptions, taskOptions?: TaskOptions) => Promise<EnsureAccountOptions>;
 }
@@ -30,6 +57,7 @@ export declare class BuyerAccountRegistry {
     private provision;
     private storage?;
     private repair?;
+    private readonly registryOptions;
     private entries;
     private pending;
     private writes;
@@ -41,7 +69,7 @@ export declare class BuyerAccountRegistry {
     private statusEpochs;
     private readonly maxEntries;
     private readonly normalizeOptions?;
-    constructor(scope: () => string, provision: (key: AccountReference, options: EnsureAccountOptions, taskOptions?: TaskOptions) => Promise<TaskResult<SyncAccountsResponse>>, storage?: BuyerAccountStorage | undefined, repair?: ((accountId: string, taskOptions?: TaskOptions) => Promise<readonly unknown[]>) | undefined, options?: BuyerAccountRegistryOptions);
+    constructor(scope: () => string, provision: (key: AccountReference, options: EnsureAccountOptions, taskOptions?: TaskOptions, dispatch?: BuyerAccountProvisioningDispatch) => Promise<TaskResult<SyncAccountsResponse>>, storage?: BuyerAccountStorage | undefined, repair?: ((accountId: string, taskOptions?: TaskOptions) => Promise<readonly unknown[]>) | undefined, registryOptions?: BuyerAccountRegistryOptions);
     private key;
     /** Capture before a seller request; observations older than a status repair are ignored. */
     captureObservation(): number;
@@ -52,7 +80,7 @@ export declare class BuyerAccountRegistry {
     private write;
     private record;
     private enqueue;
-    observeSync(refs: readonly AccountReference[], rows: readonly unknown[], dryRun?: boolean, observationEpoch?: number): Promise<void>;
+    observeSync(refs: readonly AccountReference[], rows: readonly unknown[], dryRun?: boolean, observationEpoch?: number, expectedRevision?: number): Promise<void>;
     private reconcileId;
     observeList(rows: readonly unknown[], queriedAccountId?: string, observationEpoch?: number): Promise<void>;
     private observeListAtScope;