Tool execution result

Result of a skill edit operation. Attributes: skill_dir: Final skill directory location. content_diff: Combined unified diff (git

Raised when a cloud API call fails.

Framework-wide base exception. Args: message: Human readable error message. code: One of the error codes defined above.

LLMClient class for single round call

Raised when a patch cannot be applied.

Tracks the evolutionary lineage of a skill. ``parent_skill_ids`` may contain multiple parents for DERIVED. FIXED always has exactly one paren

Comprehensive record for a skill: identity + lineage + quality. This is the full profile for a skill within the quality / evolution system. T

Unified context for all evolution triggers. For trigger 1 (ANALYSIS): source_task_id is set, recent_analyses may be just the single triggerin

One evolution action suggested by the analysis LLM. ``target_skill_ids`` lists the parent skill(s) this action targets using **true skill_id*

HTTP client for the OpenSpace cloud API. Args: auth_headers: Pre-resolved auth headers (from ``get_openspace_auth``). api_base: A

Skill primary category.

Metadata for a discovered skill. ``skill_id`` is the globally unique identifier used throughout the system — LLM prompts, database, evolution

SQLite persistence engine — Skill quality tracking and evolution ledger. Architecture: Write path: async method → asyncio.to_thread → _xx

This client provides simple methods to get: - Platform info (OS, architecture, version, etc.) - Screen size - Cursor position

Accumulated token usage statistics for one tracking window. Tracks both *total* usage (all calls) and *agent-only* usage (source == "agent")

Single execution record.

Wrapper for stderr that filters out harmless MCP server shutdown messages. This wrapper suppresses error messages from MCP servers during shu

One file-level operation inside a patch.

Client for screen recording via HTTP API. This client directly calls the local server's recording endpoints: - POST /start_recording

Viewer for analyzing recording sessions. Provides convenient methods to: - Load and display recordings - Analyze agent behaviors

Lightweight skill representation for ranking.

Complete quality record for a tool. Key: "{backend}:{server}:{tool_name}"

LLM-evaluated description quality.

LLM-produced analysis of a single task execution.

File handler that flushes after each emit for real-time logging

Health status

Raised when a required command is not available.

Base exception for MCP dependency errors.

MCP dependencies package installer manager. Responsible for detecting if the MCP server dependencies are installed, and if not, asking t

Connection manager that immediately reports 'ready' without establishing any real connection. Used by LocalShellConnector and LocalGUICon

Raised when the patch text cannot be parsed.

A placeholder connection manager that does nothing. This is used by connectors that set up their real connection manager during the conne

Per-skill assessment within an :class:`ExecutionAnalysis`. One ``ExecutionAnalysis`` (per task) contains zero or more ``SkillJudgment`` entri

How this skill was created / entered the system. Version DAG model — every change creates a new SkillRecord node:: Lineage rules: IMPO

Hybrid BM25 + embedding ranker for skills. Usage:: ranker = SkillRanker() candidates = [SkillCandidate(skill_id=..., name=..., d

Discover, load, select, and inject skills into agent context. Args: skill_dirs: Ordered list of directories to scan. Earlier entries hav

Cloud visibility of a skill. (`Group` is managed by the cloud platform)

Connection manager for SSE-based MCP connections. This class handles the proper task isolation for sse_client context managers to prevent the

UI Integration for OpenSpace Connects OpenSpace components with the UI system to provide real-time visualization of agent activities

Windows platform-specific functionality adapter

API Provider enumeration

Records agent actions and decision-making processes. This recorder captures the 'thinking' layer of the agent: - Task planning and d

Manage a persistent aiohttp.ClientSession.

Anthropic LLM Client for GUI operations. Uses Claude Sonnet 4.5 with computer-use-2025-01-24 API. Features: - Vision-based scree

Base backend configuration

E2B sandbox implementation for secure code execution.

Analyzes task execution results and tracks skill quality. Args: store: Persistence layer for skill records and analyses. llm_clie

LLM-powered GUI Agent Tool. This tool acts as an intelligent agent that: - Takes a task description as input - Observes the desk

Connector for desktop_env HTTP API. Provides action execution and observation methods.

Session for GUI desktop environment. Manages connection and tools for GUI automation.

Global Entry, Facing Agent/Application, only concerned with Provider & Session

Main configuration for Grounding module. Contains configuration for all grounding backends and grounding-level settings. Note: Local

Health checker with functional testing

Connector for MCP implementations using HTTP transport. This connector uses HTTP/SSE or streamable HTTP to communicate with remote MCP implementa

Filter out JSON parsing errors from MCP SDK.

List directory contents via the Shell connector.

GUI connector that runs desktop automation **locally** using pyautogui / ScreenshotHelper / AccessibilityHelper, bypassing the Flask local_se

Shell connector that runs scripts **locally** using asyncio subprocesses, bypassing the Flask local_server entirely. Public API is c

Comprehensive event for tracking complete MCP agent execution

Client for managing MCP servers and sessions. This class provides a unified interface for working with MCP servers, handling configuration, c

Raised when user cancels installation.

Raised when installation fails.

MCP Provider manages multiple MCP server sessions. Each MCP server defined in config corresponds to one session. The provider handle

Session manager for MCP connections. This class manages the lifecycle of an MCP connection, including authentication, initialization, and too

Simple file-based cache for MCP tool metadata.