Interface TaskOptions

Absolute wall-clock deadline for the entire SDK task call (ms), including discovery and capability/version preflight. Unlike workingTimeout, this deadline never resets on progress and aborts in-flight protocol work.

Caller-owned cancellation signal for the read path and in-flight protocol call. Aborting this signal cancels discovery probes (getAgentInfo, getCapabilities, feature/version preflight) and the tool request where the underlying official protocol client supports it.

Maximum clarification rounds before failing

A2A contextId that binds this call to a server-side conversation. When set, the client sends it on the A2A Message envelope so the server can route to the existing session instead of starting a new one. Retained automatically across calls on the same AgentClient.

A2A taskId of a non-terminal task to resume (HITL / approval flows). When set, the client sends it on the A2A Message envelope so the server continues the same task rather than opening a new one.

Enable debug logging for this task

Suppress automatic webhook URL generation for this call.

Opt a direct mutating A2A call into operation-routed pause recovery.

ownerScope must identify the authenticated buyer principal and account in the host's authorization model. It is hashed together with the trusted seller binding and must be supplied again during recovery.

Requires a DeferredTaskStorage implementation with the operation-route methods. The SDK returns a distinct, host-only recovery capability in result.deferred.recovery when the seller first pauses.

Trusted local authorization tuple for a delegated, cross-origin seller. The SDK snapshots this before dispatch and persists it with any generated webhook registration. It is never inferred from or sent in task arguments.

When present, this whole object takes precedence over the client-wide webhookVerification.resolverOptions.requiredOperator* fallback.

Additional metadata to include

Transport-level safeguards for this call. Overrides the matching field on the client constructor's transport option. Use to lift or tighten maxResponseBytes per call when an agent legitimately publishes large catalogs (e.g., list_creative_formats on a generative seller).