Extract knowledge from the task prompt.

Extract discrete memories from content. Delegates to this flow's memory. Args: content: Raw text (e.g. task + result dump).

Fetch latest updates from the remote.

Format an error message with the given template and error. Args: template: The error message template to use error: T

Sync wrapper for aget_all_for_provider.

Return the saved authentication token; raise ``AuthError`` if missing.

Get all completed todos. Returns: List of completed TodoItem objects.

Returns the context window size, using 75% of the maximum to avoid cutting off messages mid-thread. Raises: Valu

Get the ID of the last emitted event for linear chain tracking. Returns: The event_id of the previously emitted event, or None if no even

Get an existing collection or create it if it doesn't exist. Returns existing collection if found, otherwise creates a new one. Keyw

Get the page count of a PDF file. Args: file: The PDF file to measure. Returns: Number of pages, or None if page count canno

Get all todos that are ready to execute (pending with satisfied dependencies). Returns: List of TodoItem objects that can be exec

Get the sanitized names of the tools. Args: tools: List of tools to get names from. Returns: Comma-separated string of sanit

Show method status panel.

Execute the agent with the given messages. Args: messages: Either a string query or a list of message dictionaries.

Start the flow execution asynchronously. This method performs state restoration (if an 'id' is provided and persistence is available)

Acquire a named lock, yielding while it is held. Args: name: A human-readable lock name (e.g. ``"chromadb_init"``). The bui

Entry point for the CLI.

Mark that events have been collected during execution.

Record a tool usage event in the current trace. Args: tool_name: Name of the tool used. tool_args: Arguments passed t

Optimize an image to fit within a target file size. Uses iterative quality reduction to achieve target size. Args: file: The image f

Process the LLM response and format it into an AgentAction or AgentFinish. Args: answer: The raw response from the LLM use_stop_w

Process response through all registered extensions. Args: agent_response: The parsed agent response. extension_states

Process A2A task state and return result dictionary. Shared logic for both polling and streaming handlers. Args: a2a_task: The A2A t

Register a hook scoped to the current :func:`scoped_hooks` context.

Interpolate ``${...}`` expressions inside nested strings as CEL. A string that is exactly one ``${...}`` keeps the evaluated value's

Request user input via console (blocking). Displays the prompt message with formatting and waits for the user to type their response.

Clear all stored task outputs.

Return ``response``, awaiting it first when the client is async. Args: response: A response, or an awaitable resolving to one. Retur

Enter an execution-scoped hook registry. Hooks registered inside this context (via :func:`register_scoped`) run after global hooks and are di

Set reference to batch manager for sending events. Args: batch_manager: The trace batch manager instance.

Determine if tracing should be enabled. This is the single source of truth for tracing enablement. Priority order: 1. Explicit override (

Check if tracing messages should be suppressed. Returns: True if messages should be suppressed, False otherwise.

Store files for a task execution. Args: task_id: Unique identifier for the task. files: Dictionary mapping names to file inputs.

Remove null type from anyOf/type arrays. Pydantic generates `T | None` for optional fields, which creates schemas with null in the type. Howe

Serialize context to a dictionary for persistence. Returns: Dictionary representation suitable for JSON serialization.

Fetch actions and return built tools.

The 400 OpenAI returns for tools + reasoning_effort.

Train the crew by running a command in the UV environment. Args: n_iterations (int): The number of iterations to train the crew.

Context manager to set the triggering event ID for causal chain tracking. All events emitted within this context will have their triggered_by_eve

Update an existing task output in storage. Args: task_index: The index of the task to update. log: Dictionary contain

Validate a file against provider constraints. Args: file: The file to validate. Returns: List of validation

Validate that a directory path is safe to read. Same as :func:`validate_file_path` but also checks that the path is an existing directory.

Validate a file against provider constraints. Dispatches to the appropriate validator based on file type. Args: file: The file to va

Validate an image file against constraints. Args: file: The image file to validate. constraints: Image constraints to validate ag

Asynchronously call provided async handlers. Args: source: The object that emitted the event event: The event instanc

Executes tasks using native async and returns the final output. Args: tasks: List of tasks to execute start_index: In

Add message to conversation history. Args: text: Message content. role: Message role (default: assistant).

Build an EdgeConfig for the given vector dimensionality.

Build an S3 URI from a key. Args: key: The S3 object key. Returns: S3 URI string.

Atomically check max usage and increment the counter. Returns: None if usage was claimed successfully, or an error message

Convert tools to a format that can be used for interference. Args: tools: List of tools to convert. Returns:

Copy metadata from original function to wrapper. Args: wrapper: The wrapper object to copy metadata to original: The original fun

Create a copy of the current state. Returns: A copy of the current state

Create a hook decorator with filtering support. This factory function eliminates code duplication across the four hook decorators. Args:

Helper to create mock plan response.

Creates a summary of all tasks. Returns: A string summarizing all tasks with their details.

Delegate to A2A agent with multi-turn conversation support. Args: self: The agent instance agent_response: The AgentResponse indi

Build the deployment show URL, resolving UUID-only responses if needed.

Display deployment information. Args: json_response (Dict[str, Any]): The deployment information to display.

Create a BTREE scalar index on the ``scope`` column if not present. A scalar index lets LanceDB skip a full table scan when filtering by

Execute the first tool from the tool_uses list and return its result. This is used when available_functions is provided, to directly execute

Execute a project script through uv. Args: script_name: The project script to run. entity_type: The user-facing entity being run.

Extract token usage and response metadata from Azure response.

Extract and parse all built-in tool outputs from Responses API. Parses web_search, file_search, code_interpreter, computer_use, and r

Extract raw finish_reason (``stopReason``) from a Bedrock Converse response dict. Defensive — returns (None, None) on any failure. Be

Extract reasoning items with encrypted content from response. Used for ZDR (Zero Data Retention) compliance to capture encrypted reas

Extract finish_reason and response_id from an OpenAI Responses API ``Response`` object. The Responses API exposes ``status`` rather th

Send batch finalization to backend Args: events_count: Number of events that were successfully sent

Format feedback as a message.

Get or create the async OpenAI client.

Return the path to the version cache file, creating the dir if needed.

Get or create the S3 client.

Get or create the Anthropic client.

Get client parameters for compatibility with base class. Note: This method is kept for compatibility but the Google Gen AI SDK uses a

Extract collection creation parameters from kwargs.

Retrieve a memory prompt from the i18n translations. Args: key: The prompt key under the "memory" section. Returns: The prom

Get unique provider names from cache entries. Args: cache: The upload cache. Returns: Set of provider names.