@adcp/sdk 17.0.0-beta.1 → 17.0.0-beta.3

package/dist/lib/core/AgentClient.js

@@ -125,9 +125,21 @@ class AgentClient {
   get executor() {
     return this.client.executor;
   }
-  /** Poll one authoritative server task status for compatibility coordinators. @internal */
-  getTaskStatus(taskId, transport, signal, wireOptions) {
-    return this.client.getTaskStatus(taskId, transport, signal, wireOptions);
+  getTaskStatus(taskIdOrParams, transportOrHandler, signalOrOptions, wireOptions) {
+    if (typeof taskIdOrParams !== "string") {
+      return this.executeTask(
+        "get_task_status",
+        taskIdOrParams,
+        transportOrHandler,
+        signalOrOptions
+      );
+    }
+    return this.client.getTaskStatus(
+      taskIdOrParams,
+      transportOrHandler,
+      signalOrOptions,
+      wireOptions
+    );
   }
   /** Register restart/replica callback recovery for a compatibility coordinator. @internal */
   registerDurableSettlementRecovery(recoverer) {
@@ -950,6 +962,429 @@ class AgentClient {
     this.retainSession(result);
     return result;
   }
+  /** Execute the AdCP acquire_rights tool. */
+  async acquireRights(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "acquire_rights",
+      params,
+      inputHandler,
+      this.withSession("acquire_rights", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Generate, transform, refine, retrieve, or adapt creative manifests for advertised creative capabilities. */
+  async buildCreative(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "build_creative",
+      params,
+      inputHandler,
+      this.withSession("build_creative", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Execute the AdCP calibrate_content tool. */
+  async calibrateContent(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "calibrate_content",
+      params,
+      inputHandler,
+      this.withSession("calibrate_content", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Execute the AdCP check_governance tool. */
+  async checkGovernance(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "check_governance",
+      params,
+      inputHandler,
+      this.withSession("check_governance", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Control a seller compliance scenario. Intended for conformance testing. */
+  async complyTestController(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "comply_test_controller",
+      params,
+      inputHandler,
+      this.withSession("comply_test_controller", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Execute the AdCP create_collection_list tool. */
+  async createCollectionList(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "create_collection_list",
+      params,
+      inputHandler,
+      this.withSession("create_collection_list", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Execute the AdCP create_content_standards tool. */
+  async createContentStandards(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "create_content_standards",
+      params,
+      inputHandler,
+      this.withSession("create_content_standards", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Execute the AdCP delete_collection_list tool. */
+  async deleteCollectionList(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "delete_collection_list",
+      params,
+      inputHandler,
+      this.withSession("delete_collection_list", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Retrieve spend, credit or balance status, and invoice history for an operator-billed account. */
+  async getAccountFinancials(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "get_account_financials",
+      params,
+      inputHandler,
+      this.withSession("get_account_financials", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Execute the AdCP get_brand_identity tool. */
+  async getBrandIdentity(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "get_brand_identity",
+      params,
+      inputHandler,
+      this.withSession("get_brand_identity", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Execute the AdCP get_collection_list tool. */
+  async getCollectionList(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "get_collection_list",
+      params,
+      inputHandler,
+      this.withSession("get_collection_list", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Execute the AdCP get_content_standards tool. */
+  async getContentStandards(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "get_content_standards",
+      params,
+      inputHandler,
+      this.withSession("get_content_standards", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Evaluate a creative manifest and return scored safety, content, quality, and governance features. */
+  async getCreativeFeatures(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "get_creative_features",
+      params,
+      inputHandler,
+      this.withSession("get_creative_features", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Execute the AdCP get_media_buy_artifacts tool. */
+  async getMediaBuyArtifacts(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "get_media_buy_artifacts",
+      params,
+      inputHandler,
+      this.withSession("get_media_buy_artifacts", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Execute the AdCP get_plan_audit_logs tool. */
+  async getPlanAuditLogs(params, inputHandler, options) {
+    const result = await this.client.getPlanAuditLogs(
+      params,
+      inputHandler,
+      this.withSession("get_plan_audit_logs", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Check reporting health, enumerate expected periods and all retained revisions, or resolve one exact reporting revision. */
+  async getReportingStatus(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "get_reporting_status",
+      params,
+      inputHandler,
+      this.withSession("get_reporting_status", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Execute the AdCP get_rights tool. */
+  async getRights(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "get_rights",
+      params,
+      inputHandler,
+      this.withSession("get_rights", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Execute the AdCP list_collection_lists tool. */
+  async listCollectionLists(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "list_collection_lists",
+      params,
+      inputHandler,
+      this.withSession("list_collection_lists", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Execute the AdCP list_content_standards tool. */
+  async listContentStandards(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "list_content_standards",
+      params,
+      inputHandler,
+      this.withSession("list_content_standards", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Execute the AdCP list_creative_formats tool. */
+  async listCreativeFormats(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "list_creative_formats",
+      params,
+      inputHandler,
+      this.withSession("list_creative_formats", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Discover account-scoped creative transformers and their selectable configuration options. */
+  async listTransformers(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "list_transformers",
+      params,
+      inputHandler,
+      this.withSession("list_transformers", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Log batches of marketing events against a configured event source for measurement and attribution. */
+  async logEvent(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "log_event",
+      params,
+      inputHandler,
+      this.withSession("log_event", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Execute the AdCP report_plan_outcome tool. */
+  async reportPlanOutcome(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "report_plan_outcome",
+      params,
+      inputHandler,
+      this.withSession("report_plan_outcome", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Report vendor-service consumption and final measurements for revenue tracking and billing reconciliation. */
+  async reportUsage(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "report_usage",
+      params,
+      inputHandler,
+      this.withSession("report_usage", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Execute the AdCP search_brands tool. */
+  async searchBrands(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "search_brands",
+      params,
+      inputHandler,
+      this.withSession("search_brands", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** List or synchronize buyer-managed account catalog feeds, suppress or restore specific items, and read current availability state. */
+  async syncCatalogs(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "sync_catalogs",
+      params,
+      inputHandler,
+      this.withSession("sync_catalogs", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** List or synchronize account event sources with upsert and optional replacement semantics. */
+  async syncEventSources(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "sync_event_sources",
+      params,
+      inputHandler,
+      this.withSession("sync_event_sources", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Bind or replace the governance agent used for approval across specific advertiser accounts. */
+  async syncGovernance(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "sync_governance",
+      params,
+      inputHandler,
+      this.withSession("sync_governance", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Execute the AdCP sync_plans tool. */
+  async syncPlans(params, inputHandler, options) {
+    const result = await this.client.syncPlans(params, inputHandler, this.withSession("sync_plans", options));
+    this.retainSession(result);
+    return result;
+  }
+  /** Record a consumer's independently verified reporting totals and destination evidence in the seller ledger. */
+  async syncReportingReceipts(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "sync_reporting_receipts",
+      params,
+      inputHandler,
+      this.withSession("sync_reporting_receipts", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Tell a seller whether expected reporting was received, omitted, missing, unreadable, or contradictory. */
+  async syncReportingStatus(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "sync_reporting_status",
+      params,
+      inputHandler,
+      this.withSession("sync_reporting_status", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Execute the AdCP update_collection_list tool. */
+  async updateCollectionList(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "update_collection_list",
+      params,
+      inputHandler,
+      this.withSession("update_collection_list", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Execute the AdCP update_content_standards tool. */
+  async updateContentStandards(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "update_content_standards",
+      params,
+      inputHandler,
+      this.withSession("update_content_standards", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Execute the AdCP update_rights tool. */
+  async updateRights(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "update_rights",
+      params,
+      inputHandler,
+      this.withSession("update_rights", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Execute the AdCP validate_content_delivery tool. */
+  async validateContentDelivery(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "validate_content_delivery",
+      params,
+      inputHandler,
+      this.withSession("validate_content_delivery", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Preflight a creative manifest against canonical formats, products, third-party formats, or agent capabilities. */
+  async validateInput(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "validate_input",
+      params,
+      inputHandler,
+      this.withSession("validate_input", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Execute the AdCP validate_property_delivery tool. */
+  async validatePropertyDelivery(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "validate_property_delivery",
+      params,
+      inputHandler,
+      this.withSession("validate_property_delivery", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Execute the AdCP verify_brand_claim tool. */
+  async verifyBrandClaim(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "verify_brand_claim",
+      params,
+      inputHandler,
+      this.withSession("verify_brand_claim", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
+  /** Execute the AdCP verify_brand_claims tool. */
+  async verifyBrandClaims(params, inputHandler, options) {
+    const result = await this.client.executeTask(
+      "verify_brand_claims",
+      params,
+      inputHandler,
+      this.withSession("verify_brand_claims", options)
+    );
+    this.retainSession(result);
+    return result;
+  }
   // ====== GOVERNANCE TASKS ======
   /**
    * Create a property list
@@ -1344,6 +1779,12 @@ class AgentClient {
         return this.getMediaBuyDelivery(params, inputHandler, options);
       case "get_creative_delivery":
         return this.getCreativeDelivery(params, inputHandler, options);
+      case "preview_creative":
+        return this.previewCreative(params, inputHandler, options);
+      case "sync_plans":
+        return this.syncPlans(params, inputHandler, options);
+      case "get_plan_audit_logs":
+        return this.getPlanAuditLogs(params, inputHandler, options);
       case "get_principal":
         return this.getPrincipal(params, inputHandler, options);
       case "sync_principal":
@@ -1374,11 +1815,8 @@ class AgentClient {
     this.retainSession(result);
     return result;
   }
-  // ====== TASK MANAGEMENT DELEGATION ======
-  /**
-   * List all tasks for this agent
-   */
-  async listTasks() {
+  async listTasks(params, inputHandler, options) {
+    if (params !== void 0) return this.executeTask("list_tasks", params, inputHandler, options);
     return (await this.client.listTasks()).map(import_request_proposals_guard.assertNativeRequestProposalsTask);
   }
   /**