Get a background shell by ID.

Interpolate between two values with easing. Args: start: Start value end: End value t: Progress from 0.0 to 1.0

Execute agent loop until task is complete or max steps reached. Args: cancel_event: Optional asyncio.Event that can be set to can

Add multiple frames at once.

Calculate the visible width of text in terminal columns. This function correctly handles: - ANSI escape codes (removed from width calculation

Save frames as optimized GIF for Slack. Args: output_path: Where to save the GIF num_colors: Number of color

Draw emoji with optional shadow for better visual quality. Args: frame: PIL Image to draw on emoji: Emoji character(s)

Add a background shell to management.

Create a blank frame with solid color background. Args: width: Frame width height: Frame height color: RGB color tup

Add a user message to history.

Clear all frames (useful for creating multiple GIFs).

Execute shell command with optional background execution. Args: command: The shell command to execute timeout: Timeou

Append to with automatic attribute injection.

Load configuration from YAML file Args: config_path: Configuration file path Returns: Config instance

Load MCP tools from config file. This function: 1. Reads the MCP config file (with fallback to mcp-example.json) 2. Connects to each

Determine connection type from server config.

Clean up all MCP connections.

Helper to create a JSON stream from data

Convert EMUs (English Metric Units) to inches.

Generate response from LLM. Args: messages: List of conversation messages tools: Optional list of Tool objects or dic

Pad text to reach target width with proper alignment. Args: text: Text to pad (may contain ANSI codes) target_width: Target width

Truncate text to fit within max_width, adding ellipsis if needed. Args: text: Text to truncate (ANSI codes are preserved but not counted)

Load configuration from the default search path.

Get a DOM element by tag and identifier. Finds an element by either its line number in the original file or by matching attr

Convert tool to Anthropic tool schema.

Inject RSID, author, and date attributes into DOM nodes where applicable. Adds attributes to elements that support them: - w:r: gets

Apply opacity to an RGBA image. Args: image: RGBA image opacity: Opacity value (0.0 to 1.0) Returns: Image with

Draw text with outline for maximum readability. This is THE most important function for professional-looking text in GIFs. The outline e

Record a session note. Args: content: The information to record category: Category/tag for this note Returns

Recall session notes. Args: category: Optional category filter Returns: ToolResult with notes content

Load single skill from SKILL.md file Args: skill_path: SKILL.md file path Returns: Skill object, or

Save all modified XML files to disk and copy to destination directory. This persists all changes made via add_comment() and reply_to

Set global MCP timeout configuration. Args: connect_timeout: Connection timeout in seconds execute_timeout: Tool execution timeou

Convert tool to OpenAI tool schema.

Generate random 8-character hex ID for para/durable IDs. Values are constrained to be less than 0x7FFFFFFF per OOXML spec: - paraId must be <

Discover and load all skills in the skills directory Returns: List of Skills

Draw a circle on a frame. Args: frame: PIL Image to draw on center: (x, y) center position radius: Circle radius

Terminate a background shell process. Args: bash_id: The unique identifier of the background shell to terminate Returns:

Get current MCP timeout configuration.

Insert after with automatic attribute injection.

Get effective connect timeout.

Retrieve output from background shell. Args: bash_id: The unique identifier of the background shell filter_str: Optio

Extract text content from all slides in a PowerPoint presentation. Args: pptx_path: Path to the PowerPoint file prs: Optional Pre

Get a font with fallback support. Args: size: Font size in pixels bold: Use bold variant if available Returns:

Load config from config.yaml.

Print session statistics

Parse XML fragment and return list of imported nodes. Args: xml_content: String containing XML fragment Returns

Create 3D-style flip animation. Args: object1_data: First object (front side) object2_data: Second object (back side, None =

Create pulsing/scaling animation. Args: object_type: 'emoji', 'circle', 'text' object_data: Object configuration num

Create a test skill

Find configuration file with priority order Search for config file in the following order of priority: 1) mini_agent/config/{filename

Generate response from Anthropic LLM. Args: messages: List of conversation messages tools: Optional list of available

Get the package installation directory Returns: Path to the mini_agent package directory

Insert before with automatic attribute injection.

Print a single info line with proper padding

Check if agent execution has been cancelled. Returns: True if cancelled, False otherwise.

Remove the incomplete assistant message and its partial tool results. This ensures message consistency after cancellation by removing

Write log entry Args: log_type: Log type (REQUEST, RESPONSE, TOOL_RESULT) content: Log content

Create morphing animation between two objects. Args: object1_data: First object configuration object2_data: Second object co

Create frames showing object moving along a path. Args: object_type: 'circle', 'emoji', or 'custom' object_data: Data for th

Create skill tool for Progressive Disclosure Only provides get_skill tool - the agent uses metadata in system prompt to know what skills

Create a test skill

Create wiggle/wobble animation. Args: object_type: 'emoji', 'text' object_data: Object configuration num_frames: Num

Bounce ease-out (bouncy end).

Extract content from XML tags.

Generate response from LLM. Args: messages: List of conversation messages tools: Optional list of Tool objects or dic

Get a color palette by name. Args: name: Palette name (vibrant, pastel, dark, neon, professional, warm, cool, monochrome) Retur

Get loaded skill Args: name: Skill name Returns: Skill object, or None if not found

Generate prompt containing ONLY metadata (name + description) for all skills. This implements Progressive Disclosure - Level 1.

Terminate the background process.

Add a single comment to commentsExtended.xml.

Add a single comment to commentsExtensible.xml.

Add a single comment to commentsIds.xml.

Add a single comment to comments.xml.

Generate XML for comment range end with reference run. Note: w:rsidR is automatically added by DocxXMLEditor.

Generate XML for comment range start.

Ensure w14 namespace is declared on the root element.

Accurately calculate token count for message history using tiktoken Uses cl100k_base encoder (GPT-4/Claude/M2 compatible)

Extract text content from Word XML, preserving paragraph structure. Empty paragraphs are skipped to avoid false positives when tracked

Extract text content from Word XML, preserving paragraph structure. Empty paragraphs are skipped to avoid false positives when tracked

Get effective execute timeout.

Get effective SSE read timeout.

Check if an override with given part name exists.

Check if a relationship with given target exists.

Clean up MCP connections, suppressing noisy asyncgen teardown tracebacks.

Remove tracked changes authored by Claude from the XML root.

Remove tracked changes authored by Claude from the XML root.

Validate a single XML file against XSD schema. Returns (is_valid, errors_set).

Validate a single XML file against XSD schema. Returns (is_valid, errors_set).

Add new output line.

Add workspace-dependent tools These tools need to know the workspace directory. Args: tools: Existing tools list to add to c

Async function retry decorator Args: config: Retry configuration object, uses default config if None on_retry: Callback function