superqode 0.1.5__py3-none-any.whl

superqode/agents/__init__.py

@@ -0,0 +1,59 @@
+"""ACP agents package for SuperQode."""
+
+from typing import TYPE_CHECKING
+
+from .discovery import AgentReadError, get_agent_by_identity, get_agent_by_short_name, read_agents
+from .schema import Agent, AgentProtocol, AgentType, Command, OS, Tag
+from .registry import (
+    AGENTS,
+    AgentDef,
+    AgentProtocol as AgentProtocolNew,
+    AgentStatus,
+    get_agent,
+    get_supported_agents,
+    get_acp_agents,
+    get_external_agents,
+    get_all_agent_ids,
+    is_agent_available,
+)
+
+if TYPE_CHECKING:
+    from .client import ACPAgentManager, SuperQodeACPClient
+
+
+def __getattr__(name):
+    if name in ("ACPAgentManager", "SuperQodeACPClient"):
+        from .client import ACPAgentManager, SuperQodeACPClient
+
+        return locals()[name]
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+__all__ = [
+    # Client
+    "ACPAgentManager",
+    "SuperQodeACPClient",
+    # Discovery
+    "AgentReadError",
+    "get_agent_by_identity",
+    "get_agent_by_short_name",
+    "read_agents",
+    # Schema (legacy)
+    "Agent",
+    "AgentProtocol",
+    "AgentType",
+    "Command",
+    "OS",
+    "Tag",
+    # New Registry
+    "AGENTS",
+    "AgentDef",
+    "AgentProtocolNew",
+    "AgentStatus",
+    "get_agent",
+    "get_supported_agents",
+    "get_acp_agents",
+    "get_external_agents",
+    "get_all_agent_ids",
+    "is_agent_available",
+]

superqode/agents/acp_registry.py

@@ -0,0 +1,305 @@
+"""Curated list of 14 official ACP agents.
+
+This registry contains metadata for all official ACP-compatible agents.
+These are the agents that implement the Agent Client Protocol.
+"""
+
+from typing import TypedDict, Literal
+
+AgentStatus = Literal["available", "coming-soon", "deprecated"]
+
+
+class AgentMetadata(TypedDict):
+    """Metadata for an ACP agent."""
+
+    identity: str
+    name: str
+    short_name: str
+    url: str
+    author_name: str
+    author_url: str
+    description: str
+    run_command: str
+    status: AgentStatus
+    installation_command: str
+    installation_instructions: str
+    requirements: list[str]
+
+
+# 14 Official ACP Agents
+ACP_AGENTS_REGISTRY: dict[str, AgentMetadata] = {
+    # =========================================================================
+    # 1. Gemini CLI - Google's Reference ACP Implementation
+    # =========================================================================
+    "geminicli.com": {
+        "identity": "geminicli.com",
+        "name": "Gemini CLI",
+        "short_name": "gemini",
+        "url": "https://github.com/google-gemini/gemini-cli",
+        "author_name": "Google",
+        "author_url": "https://google.com",
+        "description": "Google's reference ACP implementation. Query and edit large codebases, generate apps from images or PDFs.",
+        "run_command": "gemini --experimental-acp",
+        "status": "available",
+        "installation_command": "npm install -g @anthropic-ai/gemini-cli",
+        "installation_instructions": "Install Gemini CLI via npm. Set GEMINI_API_KEY or GOOGLE_API_KEY.",
+        "requirements": ["node", "npm", "GEMINI_API_KEY or GOOGLE_API_KEY"],
+    },
+    # =========================================================================
+    # 2. Claude Code - Anthropic's Claude via Zed SDK Adapter
+    # =========================================================================
+    "claude.com": {
+        "identity": "claude.com",
+        "name": "Claude Code",
+        "short_name": "claude",
+        "url": "https://claude.ai/code",
+        "author_name": "Anthropic",
+        "author_url": "https://www.anthropic.com/",
+        "description": "Anthropic's official CLI coding agent. Unleash Claude's raw power directly in your terminal.",
+        "run_command": "claude --acp",
+        "status": "available",
+        "installation_command": "npm install -g @anthropic-ai/claude-code",
+        "installation_instructions": "Install Claude Code CLI. Requires ANTHROPIC_API_KEY.",
+        "requirements": ["node", "npm", "ANTHROPIC_API_KEY"],
+    },
+    # =========================================================================
+    # 3. Codex - OpenAI's Code Generation Agent
+    # =========================================================================
+    "codex.openai.com": {
+        "identity": "codex.openai.com",
+        "name": "Codex",
+        "short_name": "codex",
+        "url": "https://github.com/openai/codex",
+        "author_name": "OpenAI",
+        "author_url": "https://openai.com",
+        "description": "OpenAI's code generation agent with streaming terminal output and ACP adapter.",
+        "run_command": "codex --acp",
+        "status": "available",
+        "installation_command": "npm install -g @openai/codex",
+        "installation_instructions": "Install Codex via npm. Requires OPENAI_API_KEY.",
+        "requirements": ["node", "npm", "OPENAI_API_KEY"],
+    },
+    # =========================================================================
+    # 4. JetBrains Junie - JetBrains AI Agent
+    # =========================================================================
+    "junie.jetbrains.com": {
+        "identity": "junie.jetbrains.com",
+        "name": "JetBrains Junie",
+        "short_name": "junie",
+        "url": "https://www.jetbrains.com/junie/",
+        "author_name": "JetBrains",
+        "author_url": "https://www.jetbrains.com/",
+        "description": "JetBrains' AI agent with ACP support across their entire IDE ecosystem.",
+        "run_command": "junie --acp",
+        "status": "available",
+        "installation_command": "npm install -g @jetbrains/junie",
+        "installation_instructions": "Install Junie via npm. Works with JetBrains account.",
+        "requirements": ["node", "npm", "JetBrains account (optional)"],
+    },
+    # =========================================================================
+    # 5. Goose - Square's Open-Source Agent
+    # =========================================================================
+    "goose.block.xyz": {
+        "identity": "goose.block.xyz",
+        "name": "Goose",
+        "short_name": "goose",
+        "url": "https://github.com/block/goose",
+        "author_name": "Block",
+        "author_url": "https://block.xyz/",
+        "description": "Block's developer agent that automates engineering tasks. Extensible with MCP.",
+        "run_command": "goose mcp",
+        "status": "available",
+        "installation_command": "pipx install goose-ai",
+        "installation_instructions": "Install Goose via pipx. Configure providers via goose configure.",
+        "requirements": ["python3.10+", "pipx"],
+    },
+    # =========================================================================
+    # 6. Kimi CLI - Moonshot AI's Agent
+    # =========================================================================
+    "kimi.moonshot.cn": {
+        "identity": "kimi.moonshot.cn",
+        "name": "Kimi CLI",
+        "short_name": "kimi",
+        "url": "https://github.com/anthropics/kimi-cli",
+        "author_name": "Moonshot AI",
+        "author_url": "https://moonshot.cn/",
+        "description": "CLI AI agent implementing ACP with support for various development workflows.",
+        "run_command": "kimi --acp",
+        "status": "available",
+        "installation_command": "npm install -g kimi-cli",
+        "installation_instructions": "Install Kimi CLI via npm. Set MOONSHOT_API_KEY.",
+        "requirements": ["node", "npm", "MOONSHOT_API_KEY"],
+    },
+    # =========================================================================
+    # 7. OpenCode - Open-Source Coding Agent
+    # =========================================================================
+    "opencode.ai": {
+        "identity": "opencode.ai",
+        "name": "OpenCode",
+        "short_name": "opencode",
+        "url": "https://opencode.ai/",
+        "author_name": "SST",
+        "author_url": "https://sst.dev/",
+        "description": "Open-source AI coding agent built for the terminal with native ACP support.",
+        "run_command": "opencode acp",
+        "status": "available",
+        "installation_command": "npm install -g opencode-ai",
+        "installation_instructions": "Install OpenCode via npm. Supports 75+ LLM providers.",
+        "requirements": ["node", "npm"],
+    },
+    # =========================================================================
+    # 8. Stakpak - ACP-Compatible Code Assistance
+    # =========================================================================
+    "stakpak.dev": {
+        "identity": "stakpak.dev",
+        "name": "Stakpak",
+        "short_name": "stakpak",
+        "url": "https://github.com/stakpak/stakpak",
+        "author_name": "Stakpak",
+        "author_url": "https://stakpak.dev",
+        "description": "An ACP-compatible agent focused on comprehensive code assistance and collaboration.",
+        "run_command": "stakpak --acp",
+        "status": "available",
+        "installation_command": "pip install stakpak",
+        "installation_instructions": "Install Stakpak via pip.",
+        "requirements": ["python3", "pip"],
+    },
+    # =========================================================================
+    # 9. VT Code - Versatile Coding Agent
+    # =========================================================================
+    "vtcode.dev": {
+        "identity": "vtcode.dev",
+        "name": "VT Code",
+        "short_name": "vtcode",
+        "url": "https://github.com/anthropics/vtcode",
+        "author_name": "VT Code",
+        "author_url": "https://vtcode.dev",
+        "description": "A versatile coding agent implementing ACP for seamless development environment integration.",
+        "run_command": "vtcode --acp",
+        "status": "available",
+        "installation_command": "npm install -g vtcode",
+        "installation_instructions": "Install VT Code via npm.",
+        "requirements": ["node", "npm"],
+    },
+    # =========================================================================
+    # 10. Augment Code (Auggie) - Agentic Code Capabilities
+    # =========================================================================
+    "augmentcode.com": {
+        "identity": "augmentcode.com",
+        "name": "Augment Code",
+        "short_name": "auggie",
+        "url": "https://augmentcode.com/",
+        "author_name": "Augment",
+        "author_url": "https://augmentcode.com/",
+        "description": "AI-powered coding agent with deep codebase understanding and ACP support.",
+        "run_command": "auggie --acp",
+        "status": "available",
+        "installation_command": "npm install -g @anthropic-ai/auggie",
+        "installation_instructions": "Install Auggie via npm. Sign up at augmentcode.com.",
+        "requirements": ["node", "npm", "Augment account"],
+    },
+    # =========================================================================
+    # 11. Code Assistant - AI Coding Assistant in Rust
+    # =========================================================================
+    "codeassistant.dev": {
+        "identity": "codeassistant.dev",
+        "name": "Code Assistant",
+        "short_name": "code-assistant",
+        "url": "https://github.com/anthropics/code-assistant",
+        "author_name": "Code Assistant",
+        "author_url": "https://codeassistant.dev",
+        "description": "An AI coding assistant built in Rust for autonomous code analysis and modification.",
+        "run_command": "code-assistant --acp",
+        "status": "available",
+        "installation_command": "cargo install code-assistant",
+        "installation_instructions": "Install Code Assistant via Cargo.",
+        "requirements": ["rust", "cargo"],
+    },
+    # =========================================================================
+    # 12. cagent - Multi-Agent Runtime
+    # =========================================================================
+    "cagent.dev": {
+        "identity": "cagent.dev",
+        "name": "cagent",
+        "short_name": "cagent",
+        "url": "https://github.com/anthropics/cagent",
+        "author_name": "cagent",
+        "author_url": "https://cagent.dev",
+        "description": "A powerful, customizable multi-agent runtime that orchestrates AI agents.",
+        "run_command": "cagent --acp",
+        "status": "available",
+        "installation_command": "pip install cagent",
+        "installation_instructions": "Install cagent via pip.",
+        "requirements": ["python3", "pip"],
+    },
+    # =========================================================================
+    # 13. fast-agent - Sophisticated Agent Workflows
+    # =========================================================================
+    "fastagent.ai": {
+        "identity": "fastagent.ai",
+        "name": "fast-agent",
+        "short_name": "fast-agent",
+        "url": "https://github.com/evalstate/fast-agent",
+        "author_name": "fast-agent",
+        "author_url": "https://github.com/evalstate",
+        "description": "Create and interact with sophisticated Agents and Workflows in minutes. MCP native.",
+        "run_command": "fast-agent --acp",
+        "status": "available",
+        "installation_command": "uv tool install fast-agent-mcp",
+        "installation_instructions": "Install fast-agent via uv. Native MCP support.",
+        "requirements": ["python3.10+", "uv"],
+    },
+    # =========================================================================
+    # 14. LLMling-Agent - LLM-Powered Agent Framework
+    # =========================================================================
+    "llmlingagent.dev": {
+        "identity": "llmlingagent.dev",
+        "name": "LLMling-Agent",
+        "short_name": "llmling-agent",
+        "url": "https://github.com/phil65/llmling-agent",
+        "author_name": "LLMling",
+        "author_url": "https://github.com/phil65",
+        "description": "A framework for creating and managing LLM-powered agents with structured interactions.",
+        "run_command": "llmling-agent --acp",
+        "status": "available",
+        "installation_command": "pip install llmling-agent",
+        "installation_instructions": "Install LLMling-Agent via pip.",
+        "requirements": ["python3", "pip"],
+    },
+}
+
+
+def get_all_registry_agents() -> dict[str, AgentMetadata]:
+    """Get all agents from the registry.
+
+    Returns:
+        Dictionary mapping agent identity to metadata.
+    """
+    return ACP_AGENTS_REGISTRY.copy()
+
+
+def get_registry_agent(identity: str) -> AgentMetadata | None:
+    """Get a specific agent from the registry.
+
+    Args:
+        identity: Agent identity to look up.
+
+    Returns:
+        Agent metadata if found, None otherwise.
+    """
+    return ACP_AGENTS_REGISTRY.get(identity)
+
+
+def get_registry_agent_by_short_name(short_name: str) -> AgentMetadata | None:
+    """Get a registry agent by short name.
+
+    Args:
+        short_name: Agent short name to look up.
+
+    Returns:
+        Agent metadata if found, None otherwise.
+    """
+    for agent in ACP_AGENTS_REGISTRY.values():
+        if agent["short_name"].lower() == short_name.lower():
+            return agent
+    return None

superqode/agents/client.py

@@ -0,0 +1,249 @@
+"""ACP client implementation for SuperQode."""
+
+import asyncio
+import logging
+import os
+import sys
+import pathlib
+from pathlib import Path
+from typing import Any
+
+# Ensure CWD exists before importing acp (which imports logfire that resolves CWD)
+# This prevents FileNotFoundError when CWD doesn't exist
+try:
+    cwd = os.getcwd()
+    if not pathlib.Path(cwd).exists():
+        # Change to home directory if CWD doesn't exist
+        os.chdir(os.path.expanduser("~"))
+except (OSError, FileNotFoundError):
+    # If getcwd() fails, change to home directory
+    try:
+        os.chdir(os.path.expanduser("~"))
+    except Exception:
+        pass  # Last resort - let it fail naturally
+
+# Now safe to import acp
+from acp import (
+    PROTOCOL_VERSION,
+    Client,
+    RequestError,
+    connect_to_agent,
+    text_block,
+)
+from acp.core import ClientSideConnection
+from acp.schema import (
+    AgentMessageChunk,
+    AgentPlanUpdate,
+    AgentThoughtChunk,
+    AudioContentBlock,
+    AvailableCommandsUpdate,
+    ClientCapabilities,
+    CreateTerminalResponse,
+    CurrentModeUpdate,
+    EmbeddedResourceContentBlock,
+    EnvVariable,
+    ImageContentBlock,
+    Implementation,
+    KillTerminalCommandResponse,
+    PermissionOption,
+    ReadTextFileResponse,
+    ReleaseTerminalResponse,
+    RequestPermissionResponse,
+    ResourceContentBlock,
+    TerminalOutputResponse,
+    ToolCall,
+    ToolCallProgress,
+    ToolCallStart,
+    UserMessageChunk,
+    WaitForTerminalExitResponse,
+    WriteTextFileResponse,
+)
+
+
+class SuperQodeACPClient(Client):
+    """ACP client implementation for SuperQode."""
+
+    def __init__(self):
+        self.message_queue: asyncio.Queue = asyncio.Queue()
+        self.current_session_id: str | None = None
+
+    async def request_permission(
+        self, options: list[PermissionOption], session_id: str, tool_call: ToolCall, **kwargs: Any
+    ) -> RequestPermissionResponse:
+        """Handle permission requests from agent."""
+        # For now, auto-approve all permissions
+        # In the future, this could show a UI for user approval
+        return RequestPermissionResponse(
+            permission="approved", message="Auto-approved by SuperQode"
+        )
+
+    async def write_text_file(
+        self, content: str, path: str, session_id: str, **kwargs: Any
+    ) -> WriteTextFileResponse:
+        """Handle file write requests."""
+        try:
+            Path(path).parent.mkdir(parents=True, exist_ok=True)
+            with open(path, "w", encoding="utf-8") as f:
+                f.write(content)
+            return WriteTextFileResponse(success=True)
+        except Exception as e:
+            return WriteTextFileResponse(success=False, message=str(e))
+
+    async def read_text_file(
+        self,
+        path: str,
+        session_id: str,
+        limit: int | None = None,
+        line: int | None = None,
+        **kwargs: Any,
+    ) -> ReadTextFileResponse:
+        """Handle file read requests."""
+        try:
+            with open(path, "r", encoding="utf-8") as f:
+                content = f.read()
+            return ReadTextFileResponse(success=True, content=content)
+        except Exception as e:
+            return ReadTextFileResponse(success=False, message=str(e))
+
+    async def create_terminal(
+        self,
+        command: str,
+        session_id: str,
+        args: list[str] | None = None,
+        cwd: str | None = None,
+        env: list[EnvVariable] | None = None,
+        output_byte_limit: int | None = None,
+        **kwargs: Any,
+    ) -> CreateTerminalResponse:
+        """Handle terminal creation requests."""
+        raise RequestError.method_not_found("terminal/create")
+
+    async def kill_terminal(
+        self, session_id: str, signal: int | None = None, **kwargs: Any
+    ) -> KillTerminalCommandResponse:
+        """Handle terminal kill requests."""
+        raise RequestError.method_not_found("terminal/kill")
+
+    async def release_terminal(self, session_id: str, **kwargs: Any) -> ReleaseTerminalResponse:
+        """Handle terminal release requests."""
+        raise RequestError.method_not_found("terminal/release")
+
+    async def wait_for_terminal_exit(
+        self, session_id: str, **kwargs: Any
+    ) -> WaitForTerminalExitResponse:
+        """Handle terminal wait requests."""
+        raise RequestError.method_not_found("terminal/wait")
+
+    async def on_connect(self, conn: Any) -> None:
+        """Handle agent connection."""
+        logging.info(f"Connected to agent: {conn}")
+        self.current_session_id = getattr(conn, "session_id", None)
+
+    async def on_disconnect(self, conn: Any) -> None:
+        """Handle agent disconnection."""
+        logging.info(f"Disconnected from agent: {conn}")
+        self.current_session_id = None
+
+
+class ACPAgentManager:
+    """Manages ACP agent connections."""
+
+    def __init__(self):
+        self.client: SuperQodeACPClient | None = None
+        self.connection: ClientSideConnection | None = None
+        self._response_queue: asyncio.Queue = asyncio.Queue()
+
+    async def connect_to_agent(self, command: str, cwd: str | None = None) -> bool:
+        """Connect to an ACP agent.
+
+        Args:
+            command: The command to run the agent
+            cwd: Working directory for the connection
+
+        Returns:
+            True if connection successful, False otherwise
+        """
+        try:
+            # Parse command
+            import shlex
+
+            cmd_parts = shlex.split(command)
+            program = cmd_parts[0]
+            args = cmd_parts[1:] if len(cmd_parts) > 1 else []
+
+            # Check if the program exists
+            program_path = Path(program)
+            if program_path.exists():
+                # If it's a Python script, run it with python
+                if program_path.suffix == ".py":
+                    program = sys.executable
+                    args = [str(program_path)] + args
+                else:
+                    program = program
+                    args = args
+
+            # Create subprocess
+            proc = await asyncio.create_subprocess_exec(
+                program,
+                *args,
+                stdin=asyncio.subprocess.PIPE,
+                stdout=asyncio.subprocess.PIPE,
+                cwd=cwd or os.getcwd(),
+            )
+
+            if proc.stdin is None or proc.stdout is None:
+                logging.error("Agent process does not expose stdio pipes")
+                return False
+
+            # Connect to the agent
+            self.connection = connect_to_agent(self.client, proc.stdin, proc.stdout)
+
+            # Initialize the connection
+            await self.connection.initialize(
+                protocol_version=PROTOCOL_VERSION,
+                client_capabilities=ClientCapabilities(),
+                client_info=Implementation(
+                    name="SuperQode", title="SuperQode ACP Client", version="0.1.0"
+                ),
+            )
+
+            return True
+
+        except Exception as e:
+            logging.error(f"Failed to connect to agent: {e}")
+            return False
+
+    async def disconnect(self) -> None:
+        """Disconnect from the current agent."""
+        if self.connection:
+            await self.connection.close()
+            self.connection = None
+        if self.client:
+            del self.client
+            self.client = None
+
+    async def send_message(self, message: str) -> None:
+        """Send a message to the agent."""
+        if not self.connection:
+            raise RuntimeError("Not connected to an agent")
+
+        # Create text block
+        text_content = text_block(text=message)
+        chunk = UserMessageChunk(role="user", content=[text_content])
+
+        await self.connection.send(chunk)
+
+    async def receive_messages(self) -> list:
+        """Receive all pending messages from the agent."""
+        messages = []
+        while not self.client.message_queue.empty():
+            try:
+                msg = self.client.message_queue.get_nowait()
+                messages.append(msg)
+            except asyncio.QueueEmpty:
+                break
+        return messages
+
+    async def is_connected(self) -> bool:
+        """Check if currently connected to an agent."""
+        return self.connection is not None

superqode/agents/data/augmentcode.com.toml

@@ -0,0 +1,51 @@
+# Schema defined in agent_schema.py
+# https://github.com/augmentcode/auggie
+identity = "augmentcode.com"
+name = "Auggie (Augment Code)"
+short_name = "auggie"
+url = "https://www.augmentcode.com/product/CLI"
+protocol = "acp"
+author_name = "Augment Code"
+author_url = "https://www.augmentcode.com/"
+publisher_name = "SuperQode Team"
+publisher_url = "https://github.com/your-org/superqode"
+type = "coding"
+description = "An AI agent that brings Augment Code's power to the terminal with ACP support for Zed, Neovim, and Emacs."
+tags = ["augment", "code-analysis", "multi-editor"]
+run_command."*" = "auggie --acp"
+
+help = '''
+# Auggie (Augment Code)
+
+*The agentic CLI that goes where your code does*
+
+## Features
+
+- **Agent Client Protocol (ACP) Support**: Use Auggie in Zed, Neovim, Emacs, and other ACP-compatible editors
+- **Autonomous Code Analysis**: Intelligently explore codebases and build working memory
+- **Multi-Editor Integration**: Seamlessly integrates with your favorite development environment
+
+## Installation
+
+Install Auggie CLI (requires Node 22+):
+```bash
+npm install -g @augmentcode/auggie
+```
+
+After installation, login to your Augment Code account:
+```bash
+auggie login
+```
+
+---
+
+**Documentation**: https://docs.augmentcode.com/cli/setup-auggie/install-auggie-cli
+'''
+
+[actions."*".install]
+command = "npm install -g @augmentcode/auggie"
+description = "Install Auggie CLI (requires Node 22+)"
+
+[actions."*".login]
+command = "auggie login"
+description = "Login to Auggie (run after installation)"