agentabi 0.1.0__tar.gz

agentabi-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Peng Ding
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

agentabi-0.1.0/PKG-INFO

@@ -0,0 +1,145 @@
+Metadata-Version: 2.4
+Name: agentabi
+Version: 0.1.0
+Summary: Unified async Python API for driving coding agent CLIs — Claude Code, Codex, Gemini CLI, and more
+Author-email: Peng Ding <pding.dp@foxmail.com>
+License-Expression: MIT
+Project-URL: Documentation, https://agentabi.readthedocs.io
+Project-URL: Repository, https://github.com/oaklight/agentabi
+Project-URL: Issues, https://github.com/oaklight/agentabi/issues
+Keywords: ai,agent,coding-agent,cli,claude-code,codex,gemini-cli,opencode,llm,async,subprocess,orchestration,streaming,multi-agent,automation
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typing_extensions>=4.0.0
+Provides-Extra: claude
+Requires-Dist: claude-agent-sdk>=0.1.0; extra == "claude"
+Provides-Extra: codex
+Requires-Dist: codex-sdk-python>=0.1.0; extra == "codex"
+Provides-Extra: gemini
+Requires-Dist: gemini-cli-sdk>=0.5.0; extra == "gemini"
+Provides-Extra: all
+Requires-Dist: claude-agent-sdk>=0.1.0; extra == "all"
+Requires-Dist: codex-sdk-python>=0.1.0; extra == "all"
+Requires-Dist: gemini-cli-sdk>=0.5.0; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+Dynamic: license-file
+
+# agentabi
+
+Unified interface layer for agentic coding CLIs.
+
+One interface. Any coding agent.
+
+## What is agentabi?
+
+`agentabi` provides a stable, unified interface (an "ABI") for interacting with different agentic coding CLIs. Write your integration once, swap agents with a config change.
+
+### Supported Agents
+
+| Agent | Provider | Status |
+|-------|----------|--------|
+| [Claude Code](https://github.com/anthropics/claude-code) | Anthropic | Implemented |
+| [Codex](https://github.com/openai/codex) | OpenAI | Implemented |
+| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | Google | Implemented |
+| [OpenCode](https://opencode.ai) | Open Source | Implemented |
+
+## Installation
+
+```bash
+pip install agentabi
+```
+
+With optional SDK integrations:
+
+```bash
+pip install agentabi[claude]   # Claude Code SDK support
+pip install agentabi[codex]    # Codex SDK support
+pip install agentabi[gemini]   # Gemini CLI SDK support
+pip install agentabi[all]      # All optional SDKs
+```
+
+> **Note:** Each agent's CLI must be installed separately (e.g., `claude`, `codex`, `gemini`, `opencode`).
+
+## Quick Start
+
+### Run a task
+
+```python
+import asyncio
+from agentabi import Session
+
+async def main():
+    session = Session(agent="claude_code")
+    result = await session.run(prompt="Fix the bug in auth.py")
+    print(result["status"])       # "success"
+    print(result["result_text"])  # agent's response
+
+asyncio.run(main())
+```
+
+### Stream events
+
+```python
+async for event in session.stream(prompt="Explain this code"):
+    if event["type"] == "message_delta":
+        print(event["text"], end="")
+```
+
+### Sync convenience
+
+```python
+from agentabi import run_sync
+
+result = run_sync(prompt="List Python files", agent="codex")
+```
+
+### Discover available agents
+
+```python
+from agentabi import detect_agents, get_agent_capabilities
+
+agents = detect_agents()          # ["claude_code", "codex", ...]
+caps = get_agent_capabilities("claude_code")
+print(caps["supports_streaming"]) # True
+```
+
+## Use Cases
+
+- **Fleet Management** — Unified entry point for managing multiple coding agents
+- **Agent-to-Agent Calls** — Translation layer for inter-agent invocation
+- **Benchmarking** — Run the same task across agents, compare results
+- **Fallback & Routing** — Automatic failover and cost-aware routing
+- **Middleware Pipeline** — Inject logging, metering, security scanning, audit trails
+- **CI/CD Integration** — Vendor-agnostic agent integration for pipelines
+
+## Ecosystem
+
+`agentabi` is part of a layered stack:
+
+```
+agentabi  →  Agent CLI unified interface  →  like an OS ABI
+llmir     →  LLM API format conversion    →  like a compiler IR
+```
+
+- [llmir](https://github.com/Oaklight/llmir) — LLM Intermediate Representation for converting between LLM provider API formats (OpenAI, Anthropic, Google)
+
+## License
+
+[MIT](LICENSE)

agentabi-0.1.0/README.md

@@ -0,0 +1,102 @@
+# agentabi
+
+Unified interface layer for agentic coding CLIs.
+
+One interface. Any coding agent.
+
+## What is agentabi?
+
+`agentabi` provides a stable, unified interface (an "ABI") for interacting with different agentic coding CLIs. Write your integration once, swap agents with a config change.
+
+### Supported Agents
+
+| Agent | Provider | Status |
+|-------|----------|--------|
+| [Claude Code](https://github.com/anthropics/claude-code) | Anthropic | Implemented |
+| [Codex](https://github.com/openai/codex) | OpenAI | Implemented |
+| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | Google | Implemented |
+| [OpenCode](https://opencode.ai) | Open Source | Implemented |
+
+## Installation
+
+```bash
+pip install agentabi
+```
+
+With optional SDK integrations:
+
+```bash
+pip install agentabi[claude]   # Claude Code SDK support
+pip install agentabi[codex]    # Codex SDK support
+pip install agentabi[gemini]   # Gemini CLI SDK support
+pip install agentabi[all]      # All optional SDKs
+```
+
+> **Note:** Each agent's CLI must be installed separately (e.g., `claude`, `codex`, `gemini`, `opencode`).
+
+## Quick Start
+
+### Run a task
+
+```python
+import asyncio
+from agentabi import Session
+
+async def main():
+    session = Session(agent="claude_code")
+    result = await session.run(prompt="Fix the bug in auth.py")
+    print(result["status"])       # "success"
+    print(result["result_text"])  # agent's response
+
+asyncio.run(main())
+```
+
+### Stream events
+
+```python
+async for event in session.stream(prompt="Explain this code"):
+    if event["type"] == "message_delta":
+        print(event["text"], end="")
+```
+
+### Sync convenience
+
+```python
+from agentabi import run_sync
+
+result = run_sync(prompt="List Python files", agent="codex")
+```
+
+### Discover available agents
+
+```python
+from agentabi import detect_agents, get_agent_capabilities
+
+agents = detect_agents()          # ["claude_code", "codex", ...]
+caps = get_agent_capabilities("claude_code")
+print(caps["supports_streaming"]) # True
+```
+
+## Use Cases
+
+- **Fleet Management** — Unified entry point for managing multiple coding agents
+- **Agent-to-Agent Calls** — Translation layer for inter-agent invocation
+- **Benchmarking** — Run the same task across agents, compare results
+- **Fallback & Routing** — Automatic failover and cost-aware routing
+- **Middleware Pipeline** — Inject logging, metering, security scanning, audit trails
+- **CI/CD Integration** — Vendor-agnostic agent integration for pipelines
+
+## Ecosystem
+
+`agentabi` is part of a layered stack:
+
+```
+agentabi  →  Agent CLI unified interface  →  like an OS ABI
+llmir     →  LLM API format conversion    →  like a compiler IR
+```
+
+- [llmir](https://github.com/Oaklight/llmir) — LLM Intermediate Representation for converting between LLM provider API formats (OpenAI, Anthropic, Google)
+
+## License
+
+[MIT](LICENSE)

agentabi-0.1.0/pyproject.toml

@@ -0,0 +1,99 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "agentabi"
+dynamic = ["version"]
+authors = [{name = "Peng Ding", email = "pding.dp@foxmail.com"}]
+description = "Unified async Python API for driving coding agent CLIs — Claude Code, Codex, Gemini CLI, and more"
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+keywords = [
+    "ai",
+    "agent",
+    "coding-agent",
+    "cli",
+    "claude-code",
+    "codex",
+    "gemini-cli",
+    "opencode",
+    "llm",
+    "async",
+    "subprocess",
+    "orchestration",
+    "streaming",
+    "multi-agent",
+    "automation",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: OS Independent",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = [
+    "typing_extensions>=4.0.0",
+]
+
+[project.optional-dependencies]
+claude = ["claude-agent-sdk>=0.1.0"]
+codex = ["codex-sdk-python>=0.1.0"]
+gemini = ["gemini-cli-sdk>=0.5.0"]
+all = [
+    "claude-agent-sdk>=0.1.0",
+    "codex-sdk-python>=0.1.0",
+    "gemini-cli-sdk>=0.5.0",
+]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "pytest-cov",
+    "ruff",
+]
+
+[project.urls]
+Documentation = "https://agentabi.readthedocs.io"
+Repository = "https://github.com/oaklight/agentabi"
+Issues = "https://github.com/oaklight/agentabi/issues"
+
+[tool.setuptools.dynamic]
+version = {attr = "agentabi.__version__"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"agentabi" = ["py.typed"]
+
+[tool.ruff]
+line-length = 88
+target-version = "py39"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "W"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+markers = [
+    "integration: Real CLI integration tests (require installed CLIs)",
+    "claude: Tests requiring Claude Code CLI",
+    "codex: Tests requiring Codex CLI",
+    "gemini: Tests requiring Gemini CLI",
+    "opencode: Tests requiring OpenCode CLI",
+    "cross_cli: Cross-CLI consistency tests",
+]
+
+[tool.ty]
+# Optional SDK deps are not installed during type checking
+[tool.ty.rules]
+unresolved-import = "ignore"

agentabi-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

agentabi-0.1.0/src/agentabi/__init__.py

@@ -0,0 +1,95 @@
+"""
+agentabi - Unified interface layer for agentic coding CLIs.
+
+agentabi wraps multiple coding agent CLIs (Claude Code, Codex, Gemini CLI,
+OpenCode) behind a unified async Python API with streaming support.
+
+Quick start:
+    from agentabi import Session
+
+    session = Session(agent="claude_code")
+    result = await session.run(prompt="Fix the bug in auth.py")
+
+Streaming:
+    async for event in session.stream(prompt="Explain this code"):
+        if event["type"] == "message_delta":
+            print(event["text"], end="")
+
+Sync convenience:
+    from agentabi import run_sync
+    result = run_sync(prompt="List Python files", agent="claude_code")
+
+Discovery:
+    from agentabi import detect_agents, get_agent_capabilities
+    agents = detect_agents()
+    caps = get_agent_capabilities("claude_code")
+"""
+
+from .auto_detect import detect_agents, get_agent_capabilities, get_default_agent
+from .providers.base import Provider
+from .providers.registry import AgentNotAvailable, get_provider
+from .session import Session, run_sync
+from .types.ir import (
+    AgentCapabilities,
+    AgentType,
+    ErrorEvent,
+    FileDiffEvent,
+    IREvent,
+    MessageDeltaEvent,
+    MessageEndEvent,
+    MessageStartEvent,
+    PermissionConfig,
+    PermissionLevel,
+    PermissionRequest,
+    PermissionRequestEvent,
+    PermissionResponseEvent,
+    SessionEndEvent,
+    SessionResult,
+    SessionStartEvent,
+    SessionStatus,
+    TaskConfig,
+    ToolResultEvent,
+    ToolUseEvent,
+    UsageEvent,
+)
+
+__version__ = "0.1.0"
+
+__all__ = [
+    # Consumer API
+    "Session",
+    "run_sync",
+    # Discovery
+    "detect_agents",
+    "get_agent_capabilities",
+    "get_default_agent",
+    # Provider
+    "Provider",
+    "get_provider",
+    "AgentNotAvailable",
+    # IR types - Task
+    "TaskConfig",
+    "AgentType",
+    # IR types - Events
+    "IREvent",
+    "SessionStartEvent",
+    "SessionEndEvent",
+    "MessageStartEvent",
+    "MessageDeltaEvent",
+    "MessageEndEvent",
+    "ToolUseEvent",
+    "ToolResultEvent",
+    "PermissionRequestEvent",
+    "PermissionResponseEvent",
+    "UsageEvent",
+    "ErrorEvent",
+    "FileDiffEvent",
+    # IR types - Session
+    "SessionResult",
+    "SessionStatus",
+    # IR types - Capabilities & Permissions
+    "AgentCapabilities",
+    "PermissionConfig",
+    "PermissionLevel",
+    "PermissionRequest",
+]

agentabi-0.1.0/src/agentabi/auto_detect.py

@@ -0,0 +1,68 @@
+"""
+agentabi - Auto Detection
+
+Utility functions for auto-detecting available agent CLIs
+and getting agent capabilities.
+"""
+
+from __future__ import annotations
+
+from typing import List
+
+from .providers.registry import (
+    AgentNotAvailable,
+    get_provider,
+    list_available_agents,
+)
+from .types.ir.capabilities import AgentCapabilities
+
+
+def detect_agents() -> List[str]:
+    """Detect which agents have at least one available provider.
+
+    Returns:
+        List of available agent type identifiers.
+
+    Examples:
+        >>> agents = detect_agents()
+        >>> "claude_code" in agents  # True if `claude` is in PATH
+    """
+    return list_available_agents()
+
+
+def get_agent_capabilities(agent: str) -> AgentCapabilities:
+    """Get the capabilities of a specific agent.
+
+    Args:
+        agent: Agent type identifier.
+
+    Returns:
+        AgentCapabilities for the agent's active provider.
+
+    Raises:
+        AgentNotAvailable: If no provider is available.
+    """
+    provider = get_provider(agent)
+    return provider.capabilities()
+
+
+def get_default_agent() -> str:
+    """Get the first available agent.
+
+    Returns:
+        The first detected agent type identifier.
+
+    Raises:
+        AgentNotAvailable: If no agents are available.
+    """
+    available = detect_agents()
+    if not available:
+        raise AgentNotAvailable("(auto-detect)")
+    return available[0]
+
+
+__all__ = [
+    "detect_agents",
+    "get_agent_capabilities",
+    "get_default_agent",
+]

agentabi-0.1.0/src/agentabi/providers/__init__.py

@@ -0,0 +1,22 @@
+"""
+agentabi - Providers
+
+Flat provider model: each provider implements the same Protocol
+for driving a specific agent CLI or SDK.
+"""
+
+from .base import Provider
+from .registry import (
+    AgentNotAvailable,
+    get_provider,
+    list_agents,
+    resolve_provider,
+)
+
+__all__ = [
+    "Provider",
+    "AgentNotAvailable",
+    "resolve_provider",
+    "get_provider",
+    "list_agents",
+]

agentabi-0.1.0/src/agentabi/providers/base.py

@@ -0,0 +1,141 @@
+"""
+agentabi - Provider Protocol
+
+Single interface for all agent backends. Providers are the only
+abstraction layer between Session and agent CLIs/SDKs.
+"""
+
+from __future__ import annotations
+
+from typing import Any, AsyncIterator, List
+
+from typing_extensions import Protocol, runtime_checkable
+
+from ..types.ir.capabilities import AgentCapabilities
+from ..types.ir.events import IREvent, UsageInfo
+from ..types.ir.session import SessionResult, SessionStatus
+from ..types.ir.task import TaskConfig
+
+
+@runtime_checkable
+class Provider(Protocol):
+    """Single interface for all agent backends.
+
+    Each provider wraps one agent CLI or SDK and translates
+    between TaskConfig/IREvent and the agent's native format.
+
+    Providers form fallback chains per agent (e.g., NativeProvider
+    is tried before SDKProvider). The first available provider wins.
+    """
+
+    @staticmethod
+    def is_available() -> bool:
+        """Check if this provider can be used (CLI/SDK installed).
+
+        Returns:
+            True if the provider's dependencies are satisfied.
+        """
+        ...
+
+    def capabilities(self) -> AgentCapabilities:
+        """Declare supported features.
+
+        Returns:
+            AgentCapabilities describing what this provider supports.
+        """
+        ...
+
+    def stream(self, task: TaskConfig) -> AsyncIterator[IREvent]:
+        """Run task and yield IR events as they arrive.
+
+        Args:
+            task: Unified task configuration.
+
+        Yields:
+            IR events produced by the agent.
+        """
+        ...
+
+    async def run(self, task: TaskConfig) -> SessionResult:
+        """Run task and return aggregated result.
+
+        Default implementation consumes stream() and aggregates events.
+
+        Args:
+            task: Unified task configuration.
+
+        Returns:
+            Aggregated session result.
+        """
+        ...
+
+
+async def default_run(provider: Any, task: TaskConfig) -> SessionResult:
+    """Default run() implementation that aggregates stream() events.
+
+    Providers can use this as their run() body to avoid duplication.
+
+    Args:
+        provider: The provider instance (any object with stream()).
+        task: Unified task configuration.
+
+    Returns:
+        Aggregated SessionResult built from stream events.
+    """
+    session_id = ""
+    delta_parts: List[str] = []
+    result_text = ""
+    status: SessionStatus = "success"
+    model = ""
+    cost_usd = 0.0
+    errors: List[str] = []
+    usage: UsageInfo = {}
+
+    async for event in provider.stream(task):
+        etype = event.get("type")
+        if etype == "session_start":
+            session_id = event.get("session_id", "")
+            model = event.get("model", "")
+        elif etype == "message_delta":
+            text = event.get("text", "")
+            if text:
+                delta_parts.append(text)
+        elif etype == "message_end":
+            text = event.get("text")
+            if text:
+                result_text = text
+            elif delta_parts:
+                result_text = "".join(delta_parts)
+            delta_parts = []
+        elif etype == "usage":
+            usage = event.get("usage", {})
+            cost = event.get("cost_usd")
+            if cost is not None:
+                cost_usd = cost
+        elif etype == "error":
+            errors.append(event.get("error", ""))
+            if event.get("is_fatal"):
+                status = "error"
+
+    result: SessionResult = {
+        "session_id": session_id,
+        "status": status,
+    }
+    if model:
+        result["model"] = model
+    if result_text:
+        result["result_text"] = result_text
+    if usage:
+        result["usage"] = usage
+    if cost_usd:
+        result["cost_usd"] = cost_usd
+    if errors:
+        result["errors"] = errors
+
+    return result
+
+
+__all__ = [
+    "Provider",
+    "default_run",
+]