async call(tool_id: str, parameters: Dict[str, Any], search_id: str | None = None, session_id: str | None = None, max_response_size: int | None = None, respond_with: str | None = None, compatibility_mode: Literal['strict', 'legacy_optional_fields'] = 'strict', timeout: float | None = None, correlation_id: str | None = None) → ToolExecutionResponse

Call a specific capability.

• Parameters:
  • tool_id – Tool identifier returned by discover(…).
  • parameters – JSON-serializable parameters for the tool.
  • search_id – Search ID returned by discover(…) (recommended for traceability).
  • session_id – Optional correlation id.
  • max_response_size – Optional max response size in bytes. Large responses may be truncated.
  • respond_with – Optional server-side projection (full, summary, or fields:<JSONPath,…>).
  • compatibility_mode – Strict mode never resubmits a paid call. The deprecated legacy mode may replay once without an unsupported optional field.
  • timeout – HTTP request timeout in seconds; credential acquisition is separate.
  • correlation_id – Non-sensitive reference forwarded only to the credential provider.
• Returns: ToolExecutionResponse with success, result, and metadata.