@adcp/sdk 14.0.0-rc.49 → 14.0.0-rc.51

package/compliance/cache/{3.1.18 → 3.1.24}/universal/get-products-pagination-integrity.yaml

@@ -67,7 +67,7 @@ fixtures:
       publisher_properties:
         - publisher_domain: "acmeoutdoor.example"
       format_ids:
-        - agent_url: "https://compliance.adcontextprotocol.org"
+        - agent_url: "https://compliance.adcontextprotocol.org/"
           id: "get_products_pagination_integrity_display"
     - product_id: "get_products_pagination_product_2"
       name: "Get Products Pagination Test Product 2"
@@ -77,7 +77,7 @@ fixtures:
       publisher_properties:
         - publisher_domain: "acmeoutdoor.example"
       format_ids:
-        - agent_url: "https://compliance.adcontextprotocol.org"
+        - agent_url: "https://compliance.adcontextprotocol.org/"
           id: "get_products_pagination_integrity_display"
   pricing_options:
     - product_id: "get_products_pagination_product_1"
@@ -166,7 +166,7 @@ phases:
             operator: "pinnacle-agency.example"
           filters:
             format_ids:
-              - agent_url: "https://compliance.adcontextprotocol.org"
+              - agent_url: "https://compliance.adcontextprotocol.org/"
                 id: "get_products_pagination_integrity_display"
           pagination:
             max_results: 1
@@ -188,7 +188,7 @@ phases:
           - check: field_contains
             path: "products[0].format_ids[*]"
             value:
-              agent_url: "https://compliance.adcontextprotocol.org"
+              agent_url: "https://compliance.adcontextprotocol.org/"
               id: "get_products_pagination_integrity_display"
             description: "The returned product satisfies the requested test format filter"
           - check: field_absent
@@ -239,7 +239,7 @@ phases:
             operator: "pinnacle-agency.example"
           filters:
             format_ids:
-              - agent_url: "https://compliance.adcontextprotocol.org"
+              - agent_url: "https://compliance.adcontextprotocol.org/"
                 id: "get_products_pagination_integrity_display"
           pagination:
             cursor: "$context.products_next_cursor"
@@ -262,7 +262,7 @@ phases:
           - check: field_contains
             path: "products[0].format_ids[*]"
             value:
-              agent_url: "https://compliance.adcontextprotocol.org"
+              agent_url: "https://compliance.adcontextprotocol.org/"
               id: "get_products_pagination_integrity_display"
             description: "The terminal-page product satisfies the requested test format filter"
           - check: field_absent

package/compliance/cache/{3.1.18 → 3.1.24}/universal/pagination-integrity-creative-formats.yaml

@@ -174,7 +174,7 @@ phases:
           non-terminal. The runner captures `pagination.cursor` for the
           follow-up step.
         task: list_creative_formats
-        schema_ref: "creative/list-creative-formats-request.json"
+        schema_ref: "media-buy/list-creative-formats-request.json"
         response_schema_ref: "creative/list-creative-formats-response.json"
         doc_ref: "/creative/task-reference/list_creative_formats"
         comply_scenario: pagination_integrity
@@ -225,7 +225,7 @@ phases:
           `cursor` field. A cursor on `has_more=false` is a stale token
           that invites callers to follow it past the end of results.
         task: list_creative_formats
-        schema_ref: "creative/list-creative-formats-request.json"
+        schema_ref: "media-buy/list-creative-formats-request.json"
         response_schema_ref: "creative/list-creative-formats-response.json"
         doc_ref: "/creative/task-reference/list_creative_formats"
         comply_scenario: pagination_integrity

package/compliance/cache/{3.1.18 → 3.1.24}/universal/read-tool-idempotency.yaml

@@ -1,18 +1,18 @@
 id: read_tool_idempotency
 version: "1.0.0"
 introduced_in: "3.1"
-title: "Read-tool idempotency_key tolerance"
+title: "Read-tool idempotency_key envelope tolerance"
 category: idempotency
-summary: "Validates that read-only AdCP tasks accept the 3.1 every-request idempotency_key envelope without strict wrapper rejection."
+summary: "Validates that read-only AdCP tasks and the 3.x get_products compatibility facade tolerate an optional idempotency_key without claiming read-response replay."
 track: core
 required_tools: []  # protocol-level baseline; read-tool probes gate themselves per step
 
 narrative: |
-  AdCP 3.1 extends the `idempotency_key` request envelope from mutating
-  operations to every task request, including read-only tools. Sellers MUST
-  tolerate the field on reads in 3.1. Tool wrappers must pass it through their
-  envelope normalization layer instead of rejecting it as an unknown
-  task-specific input.
+  AdCP requires `idempotency_key` replay protection for state-mutating
+  requests. Read-only tools leave the field optional, but their wrappers MUST
+  tolerate it instead of rejecting it as an unknown task-specific input. A
+  pure-read handler MAY ignore the field, and buyers MUST NOT infer a
+  byte-stable replay guarantee from this storyboard.
 
   This storyboard focuses on the 3.1 read-side contract. It sends
   `idempotency_key`, `context`, and `ext` on representative read tools and
@@ -21,11 +21,8 @@ narrative: |
   mutating replay semantics, conflict detection, TTL declaration, and
   `replayed: true`.
 
-  The final phase intentionally omits `idempotency_key` on a read request.
-  During the 3.1 grace window, sellers SHOULD reject this omission but MAY
-  accept it for compatibility; therefore the probe is documented here as a
-  future 3.2 switch point rather than a hard failure. The 3.2 storyboard cut
-  should flip that probe to a required rejection.
+  The final phase intentionally omits `idempotency_key` on a read request to
+  verify that optional-key requests remain valid.
 
 agent:
   interaction_model: "*"  # applies to every agent regardless of protocol or specialism
@@ -46,7 +43,7 @@ phases:
   - id: read_requests_accept_idempotency_key
     title: "Read requests accept idempotency_key"
     narrative: |
-      Send representative read requests with the full 3.1 request envelope:
+      Send representative read requests with optional envelope fields:
       `idempotency_key`, `context`, and `ext`. Passing these probes confirms
       that task wrappers do not treat read request schemas as closed
       task-specific payloads.
@@ -67,7 +64,8 @@ phases:
         stateful: false
         expected: |
           Return capabilities normally. The read wrapper MUST tolerate the
-          3.1 every-request envelope fields and echo context unchanged.
+          optional envelope fields and echo context unchanged. This step does
+          not require the response to be stored or replayed.
 
         sample_request:
           idempotency_key: "$generate:uuid_v4#read_tools_3_1_capabilities"
@@ -94,9 +92,10 @@ phases:
       - id: get_products_with_idempotency_key
         title: "Product discovery read accepts idempotency_key"
         narrative: |
-          `get_products` is the canonical media-buy read. Sellers that expose
-          it must accept the 3.1 every-request envelope even though the field is
-          not part of the task-specific product-discovery payload.
+          This brief-mode `get_products` probe resolves synchronously as a read,
+          but the compatibility tool is polymorphic: other calls may create a
+          task or finalize a proposal. Its request schema therefore declares an
+          optional `idempotency_key`; this read arm may ignore it.
         task: get_products
         requires_tool: get_products
         schema_ref: "media-buy/get-products-request.json"
@@ -268,27 +267,19 @@ phases:
             value: "read_tool_idempotency--list_creatives_with_key"
             description: "Context correlation_id returned unchanged"
 
-  - id: omitted_key_grace_accept_path
-    title: "3.1 omitted-key grace window — accept path"
+  - id: omitted_key_optional
+    title: "Read request without idempotency_key succeeds"
     narrative: |
-      Exercise the intentional omission vector on a read request. 3.1 sellers
-      SHOULD reject omitted `idempotency_key` values on reads but MAY continue
-      to accept them during the migration window. Passing this path records the
-      compatibility behavior without failing 3.1 acceptance; the peer reject
-      path below records the recommended behavior.
-    optional: true
-    branch_set:
-      id: omitted_key_grace_handled
-      semantics: any_of
+      Exercise the intentional omission vector on a pure read. The optional
+      key must not be required for this request shape.
 
     steps:
-      - id: get_capabilities_without_idempotency_key_3_1_accept
-        title: "Capabilities read without idempotency_key may still succeed in 3.1"
+      - id: get_capabilities_without_idempotency_key
+        title: "Capabilities read without idempotency_key succeeds"
         narrative: |
           The request intentionally omits `idempotency_key` and sets
-          `omit_idempotency_key: true` so future runners that auto-inject keys
-          for all tasks preserve the missing-key vector. Some 3.1 sellers may
-          still accept this request during migration.
+          `omit_idempotency_key: true` so runners preserve the missing-key
+          vector.
         task: get_adcp_capabilities
         schema_ref: "protocol/get-adcp-capabilities-request.json"
         response_schema_ref: "protocol/get-adcp-capabilities-response.json"
@@ -296,110 +287,24 @@ phases:
         comply_scenario: read_tool_idempotency
         omit_idempotency_key: true
         stateful: false
-        contributes: true
         expected: |
-          3.1 grace-window accept behavior: a seller MAY accept this request
-          and return capabilities normally, but SHOULD prepare to reject omitted
-          `idempotency_key` on read tools. The 3.2 compliance cut should remove
-          this accept branch.
+          Return capabilities normally. `idempotency_key` is optional for this
+          pure-read request.
 
         sample_request:
           context:
-            correlation_id: "read_tool_idempotency--capabilities_omitted_key_grace"
+            correlation_id: "read_tool_idempotency--capabilities_without_key"
           ext:
             adcp:
               storyboard: "read_tool_idempotency"
-              probe: "omitted_key_grace"
+              probe: "optional_key_omitted"
         validations:
           - check: response_schema
-            description: "Response matches get-adcp-capabilities-response.json schema during the 3.1 omitted-key grace window"
+            description: "Response matches get-adcp-capabilities-response.json schema without an idempotency key"
           - check: field_present
             path: "context"
             description: "Response echoes back the context object"
           - check: field_value
             path: "context.correlation_id"
-            value: "read_tool_idempotency--capabilities_omitted_key_grace"
+            value: "read_tool_idempotency--capabilities_without_key"
             description: "Context correlation_id returned unchanged"
-
-  - id: omitted_key_grace_reject_path
-    title: "3.1 omitted-key grace window — reject path"
-    narrative: |
-      Exercise the recommended 3.1 behavior for a read request that omits
-      `idempotency_key`: reject the request with `INVALID_REQUEST`. Passing
-      this path contributes the same branch-set flag as the accept path above,
-      so either behavior is conformant during the 3.1 migration window.
-    optional: true
-    branch_set:
-      id: omitted_key_grace_handled
-      semantics: any_of
-
-    steps:
-      - id: get_capabilities_without_idempotency_key_3_1_reject
-        title: "Capabilities read without idempotency_key may reject in 3.1"
-        narrative: |
-          The request intentionally omits `idempotency_key` and sets
-          `omit_idempotency_key: true`. In 3.1, sellers that already enforce
-          the every-request envelope should reject this with `INVALID_REQUEST`.
-          In 3.2 this becomes the only conformant branch.
-        task: get_adcp_capabilities
-        schema_ref: "protocol/get-adcp-capabilities-request.json"
-        response_schema_ref: "protocol/get-adcp-capabilities-response.json"
-        doc_ref: "/protocol/get_adcp_capabilities"
-        comply_scenario: read_tool_idempotency
-        omit_idempotency_key: true
-        expect_error: true
-        negative_path: payload_well_formed
-        stateful: false
-        contributes: true
-        expected: |
-          3.1 grace-window reject behavior: reject the read request with:
-          - Error code: INVALID_REQUEST
-          - Message indicating idempotency_key is required
-
-        sample_request:
-          context:
-            correlation_id: "read_tool_idempotency--capabilities_omitted_key_grace"
-          ext:
-            adcp:
-              storyboard: "read_tool_idempotency"
-              probe: "omitted_key_grace"
-        validations:
-          - check: error_code
-            value: "INVALID_REQUEST"
-            description: "Missing idempotency_key rejected with INVALID_REQUEST"
-          - check: field_present
-            path: "context"
-            description: "Response echoes back the context object"
-          - check: field_value
-            path: "context.correlation_id"
-            value: "read_tool_idempotency--capabilities_omitted_key_grace"
-            description: "Context correlation_id returned unchanged"
-
-  - id: omitted_key_grace_assertion
-    title: "3.1 omitted-key grace window — require handled outcome"
-    narrative: |
-      Synthetic assertion over the two optional omitted-key branches. In 3.1,
-      either success-path compatibility or recommended `INVALID_REQUEST`
-      rejection satisfies the migration window. A transport failure, unrelated
-      error, or schema-invalid success satisfies neither branch and is
-      non-conformant. The 3.2 storyboard cut should collapse this to the
-      rejection branch only.
-
-    steps:
-      - id: assert_omitted_key_grace_handled
-        title: "Require omitted_key_grace_handled from either path"
-        narrative: |
-          At least one omitted-key branch must pass: the 3.1 compatibility
-          accept path or the 3.1 recommended reject path.
-        task: assert_contribution
-        comply_scenario: read_tool_idempotency
-        stateful: false
-        expected: |
-          At least one of omitted_key_grace_accept_path or
-          omitted_key_grace_reject_path contributed
-          `omitted_key_grace_handled`.
-
-        validations:
-          - check: any_of
-            allowed_values: ["omitted_key_grace_handled"]
-            description: "Agent must either accept the omitted-key read during the 3.1 grace window or reject it with INVALID_REQUEST."

package/compliance/cache/{3.1.18 → 3.1.24}/universal/storyboard-schema.yaml

@@ -139,6 +139,14 @@
 #   rule above), not a schema concern — the same storyboard runs against
 #   different topologies.)
 #
+# Applicability order: storyboard-level `requires_capability` predicates MUST
+#   be evaluated before the runner evaluates `requires`. When the capability
+#   predicate is not satisfied, the runner emits `not_applicable` and MUST NOT
+#   report a missing runtime requirement. Only an agent that selected the
+#   storyboard by satisfying its authored capability predicate can receive
+#   `requirement_unmet`. This keeps optional capability storyboards out of the
+#   coverage totals of agents that never claimed the capability.
+#
 # requires: string[] (optional — storyboard-level runtime requirement gate.
 #   Known values: controller | seeded_state | real_wire | webhook_receiver | multi_agent (forward-compat:
 #   unrecognized values are NOT schema violations — runners emit
@@ -691,9 +699,9 @@
 #   `skipIdempotencyAutoInject` so the request reaches the agent WITHOUT an
 #   `idempotency_key`. Use for missing-key rejection vectors — without this flag
 #   the SDK may auto-inject a key and the agent never sees the missing-key path.
-#   3.0 used this only for mutating tasks. 3.1 extends `idempotency_key` to every
-#   request, so read-tool omission probes SHOULD also set this flag to prevent
-#   current or future runner/client auto-injection from masking the vector.)
+#   Read tools leave the key optional, so omission probes SHOULD also set this
+#   flag to prevent current or future runner/client auto-injection from masking
+#   the vector. Supplying a key on a pure read does not by itself require replay.)
 #
 # contributes_to: string (optional — marks this step as contributing a named flag
 #                         that a later assert_contribution step can require)

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

@@ -6,3 +6,4 @@ export { ConfigurationManager } from '../core/ConfigurationManager.mjs';
 export { InMemoryWebhookRegistrationStore, type InMemoryWebhookRegistrationStoreOptions, type WebhookAuthenticationMode, type WebhookRegistration, type WebhookRegistrationStore, } from '../core/webhook-registration.mjs';
 export type { ConversationConfig, ConversationContext, InputHandler, InputHandlerResponse, InputRequest, Message, TaskInfo, TaskOptions, TaskResult, TaskResultCompleted, TaskResultFailure, TaskResultIntermediate, TaskResultMetadata, } from '../core/ConversationTypes.mjs';
 export type { AgentConfig } from '../types/adcp.mjs';
+export type { ResolveAccountOptions, ListedAccount } from '../core/account-resolution.mjs';

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

@@ -6,3 +6,4 @@ export { ConfigurationManager } from '../core/ConfigurationManager';
 export { InMemoryWebhookRegistrationStore, type InMemoryWebhookRegistrationStoreOptions, type WebhookAuthenticationMode, type WebhookRegistration, type WebhookRegistrationStore, } from '../core/webhook-registration';
 export type { ConversationConfig, ConversationContext, InputHandler, InputHandlerResponse, InputRequest, Message, TaskInfo, TaskOptions, TaskResult, TaskResultCompleted, TaskResultFailure, TaskResultIntermediate, TaskResultMetadata, } from '../core/ConversationTypes';
 export type { AgentConfig } from '../types/adcp';
+export type { ResolveAccountOptions, ListedAccount } from '../core/account-resolution';

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

@@ -1,5 +1,6 @@
 import type { Client as MCPClient } from '@modelcontextprotocol/sdk/client/index.js';
-import type { AgentConfig } from '../types/index.mjs';
+import type { AccountReference, AgentConfig } from '../types/index.mjs';
+import type { ResolveAccountOptions } from './account-resolution.mjs';
 import type { MCPWebhookPayload, GetBrandIdentityRequest, GetBrandIdentityResponse, ContextMatchRequest, ContextMatchResponse, IdentityMatchRequest, IdentityMatchResponseRouterPublisher } from '../types/core.generated.mjs';
 import type { Task as A2ATask, TaskStatusUpdateEvent } from '@a2a-js/sdk';
 import { type CapabilityEvidenceScope, type CapabilityEvidenceSnapshot, type CanonicalReadTaskOptions, type CreativeDeliveryTaskOptions, type SingleAgentClientConfig, type SyncCreativesTaskOptions, type VerifyAndParseWebhookOptions, type WebhookHandlerAdapter, type WebhookParseResult, type WebhookRequestContext } from './SingleAgentClient.mjs';
@@ -565,6 +566,8 @@ export declare class AgentClient {
      * List accounts
      */
     listAccounts(params: ListAccountsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ListAccountsResponse>>;
+    /** Resolve the seller's account contract into a reusable wire account reference. */
+    resolveAccount(hints?: ResolveAccountOptions, options?: TaskOptions): Promise<AccountReference>;
     /**
      * Sync accounts
      */

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

@@ -1,5 +1,6 @@
 import type { Client as MCPClient } from '@modelcontextprotocol/sdk/client/index.js';
-import type { AgentConfig } from '../types';
+import type { AccountReference, AgentConfig } from '../types';
+import type { ResolveAccountOptions } from './account-resolution';
 import type { MCPWebhookPayload, GetBrandIdentityRequest, GetBrandIdentityResponse, ContextMatchRequest, ContextMatchResponse, IdentityMatchRequest, IdentityMatchResponseRouterPublisher } from '../types/core.generated';
 import type { Task as A2ATask, TaskStatusUpdateEvent } from '@a2a-js/sdk';
 import { type CapabilityEvidenceScope, type CapabilityEvidenceSnapshot, type CanonicalReadTaskOptions, type CreativeDeliveryTaskOptions, type SingleAgentClientConfig, type SyncCreativesTaskOptions, type VerifyAndParseWebhookOptions, type WebhookHandlerAdapter, type WebhookParseResult, type WebhookRequestContext } from './SingleAgentClient';
@@ -565,6 +566,8 @@ export declare class AgentClient {
      * List accounts
      */
     listAccounts(params: ListAccountsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ListAccountsResponse>>;
+    /** Resolve the seller's account contract into a reusable wire account reference. */
+    resolveAccount(hints?: ResolveAccountOptions, options?: TaskOptions): Promise<AccountReference>;
     /**
      * Sync accounts
      */

package/dist/lib/core/AgentClient.js

@@ -863,6 +863,14 @@ class AgentClient {
     this.retainSession(result);
     return result;
   }
+  /** Resolve the seller's account contract into a reusable wire account reference. */
+  async resolveAccount(hints = {}, options) {
+    return this.client.resolveAccount(
+      hints,
+      this.withSession("resolve_account", options),
+      (result) => this.retainSession(result)
+    );
+  }
   /**
    * Sync accounts
    */

package/dist/lib/core/AgentClient.mjs

@@ -831,6 +831,14 @@ class AgentClient {
     this.retainSession(result);
     return result;
   }
+  /** Resolve the seller's account contract into a reusable wire account reference. */
+  async resolveAccount(hints = {}, options) {
+    return this.client.resolveAccount(
+      hints,
+      this.withSession("resolve_account", options),
+      (result) => this.retainSession(result)
+    );
+  }
   /**
    * Sync accounts
    */

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

@@ -1,5 +1,5 @@
 import { type ListProductsResponseWithSupplyPath, type ProductSupplyPathOptions } from '../supply-path/products.mjs';
-import type { AgentConfig } from '../types/index.mjs';
+import type { AccountReference, AgentConfig } from '../types/index.mjs';
 import { type AdcpVersion } from '../version.mjs';
 import type { GetProductsRequest, GetProductsResponse, ListProductsRequest, ListCreativeFormatsRequest, ListCreativeFormatsResponse, ListTransformersRequest, ListTransformersResponse, CreateMediaBuyRequest, CreateMediaBuyResponse, UpdateMediaBuyRequest, UpdateMediaBuyResponse, SyncCreativesRequest, SyncCreativesResponse, ListCreativesRequest, ListCreativesResponse, GetMediaBuysRequest, GetMediaBuysResponse, GetMediaBuyDeliveryRequest, GetMediaBuyDeliveryResponse, GetCreativeDeliveryRequest, GetCreativeDeliveryResponse, ProvidePerformanceFeedbackRequest, ProvidePerformanceFeedbackResponse, GetSignalsRequest, GetSignalsResponse, ActivateSignalRequest, ActivateSignalResponse, PreviewCreativeRequest, PreviewCreativeResponse, BuildCreativeRequest, BuildCreativeResponse, Format, GetAdCPCapabilitiesRequest, GetAdCPCapabilitiesResponse, ListAccountChangesRequest, ListAccountChangesResponse, ListAccountsRequest, ListAccountsResponse, SyncAccountsRequest, SyncAccountsResponse, SyncAudiencesRequest, SyncAudiencesResponse, CreatePropertyListRequest, CreatePropertyListResponse, GetPropertyListRequest, GetPropertyListResponse, UpdatePropertyListRequest, UpdatePropertyListResponse, ListPropertyListsRequest, ListPropertyListsResponse, DeletePropertyListRequest, DeletePropertyListResponse, ListContentStandardsRequest, ListContentStandardsResponse, GetContentStandardsRequest, GetContentStandardsResponse, CalibrateContentRequest, CalibrateContentResponse, ValidateContentDeliveryRequest, ValidateContentDeliveryResponse, SIGetOfferingRequest, SIGetOfferingResponse, SIInitiateSessionRequest, SIInitiateSessionResponse, SISendMessageRequest, SISendMessageResponse, SITerminateSessionRequest, SITerminateSessionResponse, SyncPlansRequest, SyncPlansResponse, GetPlanAuditLogsRequest, GetPlanAuditLogsResponse, GetPrincipalRequest, GetPrincipalResponse, SyncPrincipalRequest, SyncPrincipalResponse, OutcomeType } from '../types/tools.generated.mjs';
 import { type MutatingRequestInput } from '../utils/idempotency.mjs';
@@ -14,6 +14,7 @@ import { type WebhookHeaderValue, type WebhookHeadersLike } from '../webhooks/in
 import { type WebhookRegistrationStore } from './webhook-registration.mjs';
 import { type ReplayStore, type RevocationStore, type JwksResolver, type WebhookSignatureErrorCode, type ResolvedAgentJwksResolverOptions } from '../signing/server.mjs';
 import type { AdcpCapabilities, FeatureName } from '../utils/capabilities.mjs';
+import { type ResolveAccountOptions } from './account-resolution.mjs';
 import { type BuyerPropertyPolicy, type ProductPropertyPolicyMode } from '../media-buy/property-policy.mjs';
 import { type ResolveListOptions } from '../server/targeting-helpers.mjs';
 import { type CanonicalCreateMediaBuyInput, type CanonicalCreativeResponse, type CanonicalGetProductsRequest, type CanonicalGetProductsResponse, type CanonicalListCreativesRequest, type CanonicalListCreativesResponse, type CanonicalPreviewCreativeRequest, type CanonicalPreviewCreativeResponse, type CanonicalSyncCreativesRequest, type CanonicalUpdateMediaBuyRequest, type SyncCreativeFormatProjection } from '../v2/projection/creative-delivery.mjs';
@@ -1019,6 +1020,14 @@ export declare class SingleAgentClient {
      * List accounts
      */
     listAccounts(params: ListAccountsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ListAccountsResponse>>;
+    /**
+     * Resolve an account for the authenticated caller. Explicit-account sellers
+     * are discovered with list_accounts; implicit-account sellers are registered
+     * with sync_accounts and addressed by their natural key.
+     */
+    resolveAccount(hints?: ResolveAccountOptions, options?: TaskOptions, 
+    /** @internal Allows the AgentClient wrapper to retain nested task session ids. */
+    onTaskResult?: (result: TaskResult<unknown>) => void): Promise<AccountReference>;
     /**
      * Sync accounts
      */

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

@@ -1,5 +1,5 @@
 import { type ListProductsResponseWithSupplyPath, type ProductSupplyPathOptions } from '../supply-path/products';
-import type { AgentConfig } from '../types';
+import type { AccountReference, AgentConfig } from '../types';
 import { type AdcpVersion } from '../version';
 import type { GetProductsRequest, GetProductsResponse, ListProductsRequest, ListCreativeFormatsRequest, ListCreativeFormatsResponse, ListTransformersRequest, ListTransformersResponse, CreateMediaBuyRequest, CreateMediaBuyResponse, UpdateMediaBuyRequest, UpdateMediaBuyResponse, SyncCreativesRequest, SyncCreativesResponse, ListCreativesRequest, ListCreativesResponse, GetMediaBuysRequest, GetMediaBuysResponse, GetMediaBuyDeliveryRequest, GetMediaBuyDeliveryResponse, GetCreativeDeliveryRequest, GetCreativeDeliveryResponse, ProvidePerformanceFeedbackRequest, ProvidePerformanceFeedbackResponse, GetSignalsRequest, GetSignalsResponse, ActivateSignalRequest, ActivateSignalResponse, PreviewCreativeRequest, PreviewCreativeResponse, BuildCreativeRequest, BuildCreativeResponse, Format, GetAdCPCapabilitiesRequest, GetAdCPCapabilitiesResponse, ListAccountChangesRequest, ListAccountChangesResponse, ListAccountsRequest, ListAccountsResponse, SyncAccountsRequest, SyncAccountsResponse, SyncAudiencesRequest, SyncAudiencesResponse, CreatePropertyListRequest, CreatePropertyListResponse, GetPropertyListRequest, GetPropertyListResponse, UpdatePropertyListRequest, UpdatePropertyListResponse, ListPropertyListsRequest, ListPropertyListsResponse, DeletePropertyListRequest, DeletePropertyListResponse, ListContentStandardsRequest, ListContentStandardsResponse, GetContentStandardsRequest, GetContentStandardsResponse, CalibrateContentRequest, CalibrateContentResponse, ValidateContentDeliveryRequest, ValidateContentDeliveryResponse, SIGetOfferingRequest, SIGetOfferingResponse, SIInitiateSessionRequest, SIInitiateSessionResponse, SISendMessageRequest, SISendMessageResponse, SITerminateSessionRequest, SITerminateSessionResponse, SyncPlansRequest, SyncPlansResponse, GetPlanAuditLogsRequest, GetPlanAuditLogsResponse, GetPrincipalRequest, GetPrincipalResponse, SyncPrincipalRequest, SyncPrincipalResponse, OutcomeType } from '../types/tools.generated';
 import { type MutatingRequestInput } from '../utils/idempotency';
@@ -14,6 +14,7 @@ import { type WebhookHeaderValue, type WebhookHeadersLike } from '../webhooks';
 import { type WebhookRegistrationStore } from './webhook-registration';
 import { type ReplayStore, type RevocationStore, type JwksResolver, type WebhookSignatureErrorCode, type ResolvedAgentJwksResolverOptions } from '../signing/server';
 import type { AdcpCapabilities, FeatureName } from '../utils/capabilities';
+import { type ResolveAccountOptions } from './account-resolution';
 import { type BuyerPropertyPolicy, type ProductPropertyPolicyMode } from '../media-buy/property-policy';
 import { type ResolveListOptions } from '../server/targeting-helpers';
 import { type CanonicalCreateMediaBuyInput, type CanonicalCreativeResponse, type CanonicalGetProductsRequest, type CanonicalGetProductsResponse, type CanonicalListCreativesRequest, type CanonicalListCreativesResponse, type CanonicalPreviewCreativeRequest, type CanonicalPreviewCreativeResponse, type CanonicalSyncCreativesRequest, type CanonicalUpdateMediaBuyRequest, type SyncCreativeFormatProjection } from '../v2/projection/creative-delivery';
@@ -1019,6 +1020,14 @@ export declare class SingleAgentClient {
      * List accounts
      */
     listAccounts(params: ListAccountsRequest, inputHandler?: InputHandler, options?: TaskOptions): Promise<TaskResult<ListAccountsResponse>>;
+    /**
+     * Resolve an account for the authenticated caller. Explicit-account sellers
+     * are discovered with list_accounts; implicit-account sellers are registered
+     * with sync_accounts and addressed by their natural key.
+     */
+    resolveAccount(hints?: ResolveAccountOptions, options?: TaskOptions, 
+    /** @internal Allows the AgentClient wrapper to retain nested task session ids. */
+    onTaskResult?: (result: TaskResult<unknown>) => void): Promise<AccountReference>;
     /**
      * Sync accounts
      */