Retrieve the authorization token, or return an empty string if not available.

Async context manager producing an httpx.AsyncClient against an ASGI-mounted manager. Keeps manager.run() and the httpx client inside the same ta

Create evaluation results with multi-run stats for a single model.

Compute the base URL for an Arcade service from the provided overrides. Treats 127.0.0.1 and 0.0.0.0 as aliases for localhost. force_no

Return RFC 9728 Protected Resource Metadata. This metadata tells MCP clients: 1. What resource this server protects (canonical URL)

Convert a MaterializedTool to OpenAI JsonToolSchema format. Args: tool: The MaterializedTool to convert Returns: The OpenAI J

Create a mock errors module with all necessary error classes.

Convert an input JSON schema (MCP `inputSchema`) to OpenAI strict mode format. OpenAI strict mode requires: - additionalProperties: fals

Create a new track with an isolated registry. Args: name: Unique track name. registry: The tool registry for this tra

Public method to resolve a tool name to its original registry key. This is useful for callers that need to look up tools by names ret

Set request metadata for the current async context. Returns a reset token.

Store a successful result for a task.

Convert to dictionary for JSON serialization.

Determine if a 403 error is actually a rate limiting error. Checks if rate limit quota is exhausted. Simply having rate limit header

Generate a safe ID for HTML attributes and CSS selectors. Removes or replaces characters that could break HTML attributes or CSS sele

Remove inline comments from env value, respecting quoted strings.

Convert a MaterializedTool to an MCPTool DTO. Delegates to :func:`arcade_mcp_server.convert.create_mcp_tool`.

Validate MCP-Protocol-Version header. Returns (error_response, version_from_header). Per MCP 2025-11-25 transports.mdx: - Initialize IS

Append debug internals to ``message`` when the corresponding env flags are set. This is a no-op in the default case (both flags off), and also a

Create a mock EvaluationResult with the specified properties.

Format capture results as plain text.

Format capture results as Markdown.

Normalize a list of critic weights to sum to 1.0. Uses Softmax-inspired normalization: each weight is divided by the sum of all weights,

Normalize a tool name for LLM provider compatibility. Both OpenAI and Anthropic have restrictions on tool names: - OpenAI: allows alphan

Parse a --use-provider value into a ProviderConfig. Args: spec: Provider spec string. Examples: - "openai" -> use OpenAI with

Register a tool to the catalog.

Reset request metadata to prior value.

Run comparative cases across all configured tracks. Args: client: The LLM client instance. model: The model to evalua

Track command execution event. Args: command_name: The name of the CLI command that was executed. success: Whether th

Validate metadata consistency and JSON-safety of extras. Called by the catalog when creating a tool definition. Raises:

Check tool requirements before executing the tool

Build a lightweight mock ReadableSpan.

Extract retry-after from Slack API errors. Returns milliseconds to wait before retry. Defaults to 1000ms if not found.

Strip query params and fragments from URI for privacy.

Configure an MCP client to connect to a server. Args: client: The MCP client to configure (claude, cursor, vscode) entrypoin

Find a .env file by traversing upward through parent directories. Starts at the specified directory (or current working directory) and traver

Execute a callable function with validated inputs and outputs via Pydantic models.

Run the quickstart flow: login → determine mode → configure client. Everything is configured as a cloud gateway — no local server required.

Start the MCP server process on a random port. Args: entrypoint: Path to the entrypoint file that runs the MCPApp instance d

Add context to the error message. Args: name: The name of the tool or toolkit that caused the error. Returns:

Convert list of InputParameter to JSON schema parameters object. Unlike OpenAI's strict mode, Anthropic uses standard JSON Schema: - Only act

Parse granted scopes from JWT claims. Order of precedence: ``scope`` (OAuth-canonical, string) > ``scp`` (vendor convention, list). T

Derive the authorization-context key used to scope task visibility. Auth context: ``auth:{issuer}:{client_id}:{user_id}``. Fallback (

Helper to materialize a tool from function + definition.

Patch the loader to return our dummy classes.

Add the tools from a loaded toolkit to the catalog. Args: toolkit: The toolkit to add. version: Optionally o

Add configuration for a track. Args: track_name: The track name. expected_tool_calls: Expected tool calls for this tr

Build a JSON-RPC 2.0 request. Args: method: Method name params: Method parameters request_id: Request ID (omit for n

Build the structured ``extra`` dict for a failed-tool-call WARNING log. Args: error: The ``ToolCallError``. ``kind`` is normalized via ``

Get a capture formatter instance by name. Args: format_name: The format name (e.g., 'json', 'txt', 'md', 'html'). Returns:

Get the registry for a track. Args: track_name: The track name. Returns: The registry if found, None otherwi

Return request metadata for the current async context, or None.

Get task result, blocking until terminal if still working. Raises NotFoundError for missing task or context mismatch. Performs the s

Check if a nested sub-capability was negotiated (dot notation). has_capability("tasks") -> capabilities["tasks"] exists has_capabilit

List all registered tool names. Args: track: Optional track name. If provided, lists tools in that track. Returns:

Resolve a Weight value to a float. Used when a single weight needs to be resolved without full normalization. Args: weight: Eit

Convert list of InputParameter to JSON schema parameters object.

Helper to create a MaterializedTool from a decorated function.

Handle SlackApiError and its subclasses.

Create evaluation results with failed multi-run stats for a single model.

Evaluates whether the expected and actual values are exactly equal after casting. Args: expected: The expected value.

Format capture results as HTML.

Format capture results as JSON.

Get a formatter instance by name. Args: format_name: The format name (e.g., 'txt', 'md'). Returns: An instance of the a

Build an org-scoped URL using the active context. Args: base_url: Base URL of the API (e.g., https://api.arcade.dev) path: P

Fetch principal_id (account_id) from Arcade Cloud API. Prefers any linked principal already stored in usage.json. If not found, attem

Return whether ``key`` names a reserved framework control-plane credential. The comparison is case-insensitive because environment variable names

Create mock comparative results with context.

Create mock multi-model evaluation results.

Mark session as initialized.

Send a request and return the request ID.

Return the ``.bak`` sibling used to back up ``path``. We append ``.bak`` to the full filename rather than replacing the extension so ``.claud

Build a FatalToolError for client-side HTTP construction bugs. Used for exceptions that indicate the tool built an invalid request (b

Build a NetworkTransportError for no-response HTTP failures. Used for transport-level failures (timeouts, connection errors, decoding

Create a mock SlackApiError following Slack API error structure: { "ok": false, "error": "error_code",

Helper to create a ToolDefinition.

Resolve a seed specification into a (policy, value) pair. Args: seed: 'constant', 'random', an integer, a numeric string, or None. R

Validate the Origin header against ``allowed_origins``. Returns a 403 Response if invalid, None if OK.

Validate and normalize version to canonical semver.