agentirc-cli 0.7.0__tar.gz → 0.9.0__tar.gz

{agentirc_cli-0.7.0 → agentirc_cli-0.9.0}/CHANGELOG.md

@@ -4,6 +4,25 @@ All notable changes to this project will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [0.9.0] - 2026-03-25
+
+
+### Added
+
+- GitHub Copilot agent harness (Phase 4) using github-copilot-sdk
+
+## [0.8.0] - 2026-03-24
+
+
+### Added
+
+- OpenCode agent harness (Phase 3) — opencode acp over ACP/JSON-RPC/stdio
+
+
+### Changed
+
+- CLI now supports --agent opencode for init, start, and skills install
+
 ## [0.7.0] - 2026-03-24
 
 

{agentirc_cli-0.7.0 → agentirc_cli-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentirc-cli
-Version: 0.7.0
+Version: 0.9.0
 Summary: IRC protocol chatrooms for AI agents (and humans allowed)
 Project-URL: Homepage, https://github.com/OriNachum/agentirc
 Author: Ori Nachum
@@ -15,6 +15,8 @@ Requires-Python: >=3.12
 Requires-Dist: anthropic>=0.40
 Requires-Dist: claude-agent-sdk>=0.1
 Requires-Dist: pyyaml>=6.0
+Provides-Extra: copilot
+Requires-Dist: github-copilot-sdk; extra == 'copilot'
 Description-Content-Type: text/markdown
 
 <!-- markdownlint-disable MD033 MD041 -->
@@ -31,8 +33,10 @@ IRC Protocol ChatRooms for Agents (And humans allowed)
 <img src="https://img.shields.io/badge/protocol-IRC_RFC_2812-D97706?style=flat&labelColor=2D2B27" alt="IRC RFC 2812">
 <img src="https://img.shields.io/badge/license-MIT-D97706?style=flat&labelColor=2D2B27" alt="MIT License">
 <a href="https://github.com/OriNachum/agentirc/actions/workflows/tests.yml"><img src="https://img.shields.io/github/actions/workflow/status/OriNachum/agentirc/tests.yml?style=flat&label=tests&labelColor=2D2B27" alt="Tests"></a>
+<a href="https://github.com/OriNachum/AgentIRC/stargazers"><img src="https://img.shields.io/github/stars/OriNachum/AgentIRC?style=flat&label=%E2%AD%90%20stars&labelColor=2D2B27&color=D97706" alt="GitHub Stars"></a>
 
 <br><br>
+<sub>If you find AgentIRC useful, <a href="https://github.com/OriNachum/AgentIRC/stargazers">give it a ⭐</a> — it helps others discover the project.</sub>
 
 <img width="800" alt="AgentIRC" src="https://github.com/user-attachments/assets/41401b9d-1da2-483b-b21f-3769d388f74d" />
 

{agentirc_cli-0.7.0 → agentirc_cli-0.9.0}/README.md

@@ -12,8 +12,10 @@ IRC Protocol ChatRooms for Agents (And humans allowed)
 <img src="https://img.shields.io/badge/protocol-IRC_RFC_2812-D97706?style=flat&labelColor=2D2B27" alt="IRC RFC 2812">
 <img src="https://img.shields.io/badge/license-MIT-D97706?style=flat&labelColor=2D2B27" alt="MIT License">
 <a href="https://github.com/OriNachum/agentirc/actions/workflows/tests.yml"><img src="https://img.shields.io/github/actions/workflow/status/OriNachum/agentirc/tests.yml?style=flat&label=tests&labelColor=2D2B27" alt="Tests"></a>
+<a href="https://github.com/OriNachum/AgentIRC/stargazers"><img src="https://img.shields.io/github/stars/OriNachum/AgentIRC?style=flat&label=%E2%AD%90%20stars&labelColor=2D2B27&color=D97706" alt="GitHub Stars"></a>
 
 <br><br>
+<sub>If you find AgentIRC useful, <a href="https://github.com/OriNachum/AgentIRC/stargazers">give it a ⭐</a> — it helps others discover the project.</sub>
 
 <img width="800" alt="AgentIRC" src="https://github.com/user-attachments/assets/41401b9d-1da2-483b-b21f-3769d388f74d" />
 

agentirc_cli-0.9.0/agentirc/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.9.0"

{agentirc_cli-0.7.0 → agentirc_cli-0.9.0}/agentirc/cli.py

@@ -98,7 +98,7 @@ def main() -> None:
     init_parser = sub.add_parser("init", help="Register an agent for the current directory")
     init_parser.add_argument("--server", default=None, help="Server name prefix")
     init_parser.add_argument("--nick", default=None, help="Agent suffix (after server-)")
-    init_parser.add_argument("--agent", default="claude", choices=["claude", "codex"], help="Agent backend")
+    init_parser.add_argument("--agent", default="claude", choices=["claude", "codex", "opencode", "copilot"], help="Agent backend")
     init_parser.add_argument("--config", default=DEFAULT_CONFIG, help="Config file path")
 
     # -- start subcommand --------------------------------------------------
@@ -137,8 +137,8 @@ def main() -> None:
     skills_sub = skills_parser.add_subparsers(dest="skills_command")
     skills_install = skills_sub.add_parser("install", help="Install IRC skill for an agent")
     skills_install.add_argument(
-        "target", choices=["claude", "codex", "all"],
-        help="Target agent: claude, codex, or all",
+        "target", choices=["claude", "codex", "opencode", "copilot", "all"],
+        help="Target agent: claude, codex, opencode, copilot, or all",
     )
 
     args = parser.parse_args()
@@ -355,6 +355,22 @@ def _cmd_init(args: argparse.Namespace) -> None:
             directory=os.getcwd(),
             channels=["#general"],
         )
+    elif args.agent == "opencode":
+        from agentirc.clients.opencode.config import AgentConfig as OpenCodeAgentConfig
+        agent = OpenCodeAgentConfig(
+            nick=full_nick,
+            agent="opencode",
+            directory=os.getcwd(),
+            channels=["#general"],
+        )
+    elif args.agent == "copilot":
+        from agentirc.clients.copilot.config import AgentConfig as CopilotAgentConfig
+        agent = CopilotAgentConfig(
+            nick=full_nick,
+            agent="copilot",
+            directory=os.getcwd(),
+            channels=["#general"],
+        )
     else:
         agent = AgentConfig(
             nick=full_nick,
@@ -435,6 +451,32 @@ async def _run_single_agent(config: DaemonConfig, agent: AgentConfig) -> None:
             agents=config.agents,
         )
         daemon = CodexDaemon(codex_config, agent)
+    elif backend == "opencode":
+        from agentirc.clients.opencode.daemon import OpenCodeDaemon
+        from agentirc.clients.opencode.config import (
+            DaemonConfig as OpenCodeDaemonConfig,
+        )
+        # Re-load config through OpenCode module for correct supervisor defaults
+        opencode_config = OpenCodeDaemonConfig(
+            server=config.server,
+            webhooks=config.webhooks,
+            buffer_size=config.buffer_size,
+            agents=config.agents,
+        )
+        daemon = OpenCodeDaemon(opencode_config, agent)
+    elif backend == "copilot":
+        from agentirc.clients.copilot.daemon import CopilotDaemon
+        from agentirc.clients.copilot.config import (
+            DaemonConfig as CopilotDaemonConfig,
+        )
+        # Re-load config through Copilot module for correct supervisor defaults
+        copilot_config = CopilotDaemonConfig(
+            server=config.server,
+            webhooks=config.webhooks,
+            buffer_size=config.buffer_size,
+            agents=config.agents,
+        )
+        daemon = CopilotDaemon(copilot_config, agent)
     else:
         from agentirc.clients.claude.daemon import AgentDaemon
         daemon = AgentDaemon(config, agent)
@@ -737,9 +779,45 @@ def _install_skill_codex() -> None:
     print(f"Installed Codex skill: {dest}")
 
 
+def _get_bundled_opencode_skill_path() -> str:
+    """Return the path to the bundled OpenCode SKILL.md in the installed package."""
+    import agentirc
+    return os.path.join(os.path.dirname(agentirc.__file__), "clients", "opencode", "skill", "SKILL.md")
+
+
+def _install_skill_opencode() -> None:
+    """Install IRC skill for OpenCode."""
+    src = _get_bundled_opencode_skill_path()
+    dest_dir = os.path.expanduser("~/.opencode/skills/agentirc-irc")
+    dest = os.path.join(dest_dir, "SKILL.md")
+
+    os.makedirs(dest_dir, exist_ok=True)
+    import shutil
+    shutil.copy2(src, dest)
+    print(f"Installed OpenCode skill: {dest}")
+
+
+def _get_bundled_copilot_skill_path() -> str:
+    """Return the path to the bundled Copilot SKILL.md in the installed package."""
+    import agentirc
+    return os.path.join(os.path.dirname(agentirc.__file__), "clients", "copilot", "skill", "SKILL.md")
+
+
+def _install_skill_copilot() -> None:
+    """Install IRC skill for GitHub Copilot."""
+    src = _get_bundled_copilot_skill_path()
+    dest_dir = os.path.expanduser("~/.copilot_skills/agentirc-irc")
+    dest = os.path.join(dest_dir, "SKILL.md")
+
+    os.makedirs(dest_dir, exist_ok=True)
+    import shutil
+    shutil.copy2(src, dest)
+    print(f"Installed Copilot skill: {dest}")
+
+
 def _cmd_skills(args: argparse.Namespace) -> None:
     if not hasattr(args, "skills_command") or args.skills_command != "install":
-        print("Usage: agentirc skills install <claude|codex|all>", file=sys.stderr)
+        print("Usage: agentirc skills install <claude|codex|opencode|copilot|all>", file=sys.stderr)
         sys.exit(1)
 
     target = args.target
@@ -748,7 +826,11 @@ def _cmd_skills(args: argparse.Namespace) -> None:
         _install_skill_claude()
     if target in ("codex", "all"):
         _install_skill_codex()
+    if target in ("opencode", "all"):
+        _install_skill_opencode()
+    if target in ("copilot", "all"):
+        _install_skill_copilot()
 
     if target == "all":
-        print("\nSkills installed for both Claude Code and Codex.")
+        print("\nSkills installed for Claude Code, Codex, OpenCode, and Copilot.")
     print(f"\nSet AGENTIRC_NICK in your shell profile to enable the skill.")

{agentirc_cli-0.7.0 → agentirc_cli-0.9.0}/agentirc/clients/codex/daemon.py

@@ -10,6 +10,7 @@ import asyncio
 import logging
 import os
 import time
+from collections import deque
 from typing import Any
 
 from agentirc.clients.codex.config import DaemonConfig, AgentConfig
@@ -56,8 +57,10 @@ class CodexDaemon:
         self._agent_runner: CodexAgentRunner | None = None
         self._supervisor: CodexSupervisor | None = None
 
-        # Track mention context for relaying agent responses
-        self._last_mention_target: str | None = None
+        # FIFO queue of relay targets — each @mention enqueues a target,
+        # each agent response dequeues one, ensuring correct routing even
+        # when multiple mentions arrive while the agent is busy.
+        self._mention_targets: deque[str] = deque()
 
         # Crash-recovery state
         self._crash_times: list[float] = []
@@ -177,8 +180,8 @@ class CodexDaemon:
         Formats a prompt and enqueues it so the Codex session picks it up.
         """
         if self._agent_runner and self._agent_runner.is_running():
-            # Track where to relay the response
-            self._last_mention_target = target if target.startswith("#") else sender
+            # Enqueue relay target (FIFO matches prompt queue order)
+            self._mention_targets.append(target if target.startswith("#") else sender)
             if target.startswith("#"):
                 prompt = f"[IRC @mention in {target}] <{sender}> {text}"
             else:
@@ -187,8 +190,9 @@ class CodexDaemon:
 
     async def _on_agent_message(self, msg: dict) -> None:
         """Relay agent text to IRC and feed to supervisor."""
-        # Relay text response to the channel/user that triggered the mention
-        if self._transport and self._last_mention_target:
+        # Dequeue the relay target that corresponds to this turn
+        relay_target = self._mention_targets.popleft() if self._mention_targets else None
+        if self._transport and relay_target:
             content = msg.get("content", [])
             for item in content:
                 if item.get("type") == "text":
@@ -199,7 +203,7 @@ class CodexDaemon:
                             line = line.strip()
                             if line:
                                 await self._transport.send_privmsg(
-                                    self._last_mention_target, line
+                                    relay_target, line
                                 )
 
         if self._supervisor:
@@ -423,14 +427,19 @@ class CodexDaemon:
         path = msg.get("path", "")
         if not path:
             return make_response(req_id, ok=False, error="Missing 'path'")
+        new_cwd = os.path.abspath(path)
+        if not os.path.isdir(new_cwd):
+            return make_response(req_id, ok=False, error=f"Not a directory: {new_cwd}")
+        # Update the daemon's working directory
+        self.agent.directory = new_cwd
         # Check for AGENTS.md (Codex equivalent of CLAUDE.md)
-        agents_md = os.path.join(path, "AGENTS.md")
+        agents_md = os.path.join(new_cwd, "AGENTS.md")
         agents_md_content = None
         if os.path.isfile(agents_md):
             with open(agents_md) as f:
                 agents_md_content = f.read()
         return make_response(req_id, ok=True, data={
-            "directory": path,
+            "directory": new_cwd,
             "agents_md": agents_md_content,
         })
 

agentirc_cli-0.9.0/agentirc/clients/copilot/agent_runner.py

@@ -0,0 +1,165 @@
+"""Copilot agent runner — manages a GitHub Copilot SDK session."""
+
+from __future__ import annotations
+
+import asyncio
+import logging
+from typing import Any, Awaitable, Callable
+
+logger = logging.getLogger(__name__)
+
+
+class CopilotAgentRunner:
+    """Manages a GitHub Copilot SDK session for the agentirc daemon."""
+
+    def __init__(
+        self,
+        model: str,
+        directory: str,
+        system_prompt: str = "",
+        skill_directories: list[str] | None = None,
+        on_exit: Callable[[int], Awaitable[None]] | None = None,
+        on_message: Callable[[dict[str, Any]], Awaitable[None]] | None = None,
+    ) -> None:
+        self.model = model
+        self.directory = directory
+        self.system_prompt = system_prompt
+        self.skill_directories = skill_directories or []
+        self.on_exit = on_exit
+        self.on_message = on_message
+
+        self._client: Any = None
+        self._session: Any = None
+        self._session_id: str | None = None
+        self._running = False
+        self._stopping = False
+        self._prompt_queue: asyncio.Queue[str] = asyncio.Queue()
+        self._task: asyncio.Task | None = None
+
+    def is_running(self) -> bool:
+        return self._running
+
+    @property
+    def session_id(self) -> str | None:
+        return self._session_id
+
+    async def start(self, initial_prompt: str = "") -> None:
+        """Start the Copilot client and create a session."""
+        self._stopping = False
+
+        # Lazy import — github-copilot-sdk is only needed at runtime
+        from copilot import CopilotClient, PermissionHandler, SubprocessConfig
+
+        # Create and start the CopilotClient (spawns copilot CLI process)
+        subprocess_config = SubprocessConfig(cwd=self.directory)
+        self._client = CopilotClient(config=subprocess_config)
+        await self._client.start()
+
+        # Create a session with model and permissions.
+        # Wrap in try/except so a partial start doesn't leak the CLI process.
+        try:
+            session_kwargs: dict[str, Any] = {
+                "on_permission_request": PermissionHandler.approve_all,
+                "model": self.model,
+            }
+            if self.system_prompt:
+                session_kwargs["system_message"] = {"content": self.system_prompt}
+            if self.skill_directories:
+                session_kwargs["skill_directories"] = self.skill_directories
+
+            self._session = await self._client.create_session(**session_kwargs)
+        except Exception:
+            await self._client.stop()
+            self._client = None
+            raise
+        self._session_id = getattr(self._session, "id", None)
+        self._running = True
+
+        logger.info(
+            "CopilotAgentRunner started (model=%s, session=%s)",
+            self.model, self._session_id,
+        )
+
+        # Start the prompt processing loop
+        self._task = asyncio.create_task(self._prompt_loop())
+
+        if initial_prompt:
+            await self.send_prompt(initial_prompt)
+
+    async def stop(self) -> None:
+        """Stop the Copilot session and client."""
+        self._stopping = True
+        self._running = False
+
+        if self._task:
+            self._task.cancel()
+            try:
+                await self._task
+            except asyncio.CancelledError:
+                pass
+            self._task = None
+
+        if self._session:
+            try:
+                await self._session.destroy()
+            except Exception:
+                logger.debug("Session destroy error (ignoring)", exc_info=True)
+            self._session = None
+
+        if self._client:
+            try:
+                await self._client.stop()
+            except Exception:
+                logger.debug("Client stop error (ignoring)", exc_info=True)
+            self._client = None
+
+    async def send_prompt(self, text: str) -> None:
+        """Queue a prompt for the agent."""
+        await self._prompt_queue.put(text)
+
+    # ------------------------------------------------------------------
+    # Internal: prompt processing loop
+    # ------------------------------------------------------------------
+
+    async def _prompt_loop(self) -> None:
+        """Process queued prompts one at a time using send_and_wait."""
+        try:
+            while self._running:
+                text = await self._prompt_queue.get()
+                if not self._running or self._session is None:
+                    break
+
+                try:
+                    response = await self._session.send_and_wait(
+                        text, timeout=120.0
+                    )
+
+                    # Extract text from SDK response
+                    content_text = ""
+                    if response is not None:
+                        if hasattr(response, "data") and hasattr(response.data, "content"):
+                            content_text = response.data.content or ""
+                        elif isinstance(response, dict):
+                            content_text = response.get("data", {}).get("content", "")
+
+                    if content_text and self.on_message:
+                        msg_dict = {
+                            "type": "assistant",
+                            "model": self.model,
+                            "content": [{"type": "text", "text": content_text}],
+                        }
+                        await self.on_message(msg_dict)
+
+                except Exception:
+                    logger.exception("Copilot session turn error")
+                    if not self._stopping:
+                        self._running = False
+                        if self.on_exit:
+                            await self.on_exit(1)
+                        return
+
+        except asyncio.CancelledError:
+            pass
+
+        if not self._stopping and self.on_exit:
+            await self.on_exit(0)

agentirc_cli-0.9.0/agentirc/clients/copilot/config.py

@@ -0,0 +1,161 @@
+from __future__ import annotations
+
+import os
+import re
+import tempfile
+from dataclasses import asdict, dataclass, field
+from pathlib import Path
+
+import yaml
+
+
+@dataclass
+class ServerConnConfig:
+    """IRC server connection settings."""
+    name: str = "agentirc"
+    host: str = "localhost"
+    port: int = 6667
+
+
+@dataclass
+class SupervisorConfig:
+    """Supervisor sub-agent settings."""
+    model: str = "gpt-4.1"
+    window_size: int = 20
+    eval_interval: int = 5
+    escalation_threshold: int = 3
+
+
+@dataclass
+class WebhookConfig:
+    """Webhook alerting settings."""
+    url: str | None = None
+    irc_channel: str = "#alerts"
+    events: list[str] = field(default_factory=lambda: [
+        "agent_spiraling", "agent_error", "agent_question",
+        "agent_timeout", "agent_complete",
+    ])
+
+
+@dataclass
+class AgentConfig:
+    """Per-agent settings."""
+    nick: str = ""
+    agent: str = "copilot"
+    directory: str = "."
+    channels: list[str] = field(default_factory=lambda: ["#general"])
+    model: str = "gpt-4.1"
+
+
+@dataclass
+class DaemonConfig:
+    """Top-level daemon configuration."""
+    server: ServerConnConfig = field(default_factory=ServerConnConfig)
+    supervisor: SupervisorConfig = field(default_factory=SupervisorConfig)
+    webhooks: WebhookConfig = field(default_factory=WebhookConfig)
+    buffer_size: int = 500
+    agents: list[AgentConfig] = field(default_factory=list)
+
+    def get_agent(self, nick: str) -> AgentConfig | None:
+        for agent in self.agents:
+            if agent.nick == nick:
+                return agent
+        return None
+
+
+def load_config(path: str | Path) -> DaemonConfig:
+    """Load daemon config from a YAML file."""
+    with open(path) as f:
+        raw = yaml.safe_load(f) or {}
+
+    server = ServerConnConfig(**raw.get("server", {}))
+    supervisor = SupervisorConfig(**raw.get("supervisor", {}))
+
+    webhooks = WebhookConfig(**raw.get("webhooks", {}))
+
+    agents = []
+    for agent_raw in raw.get("agents", []):
+        agents.append(AgentConfig(**agent_raw))
+
+    return DaemonConfig(
+        server=server,
+        supervisor=supervisor,
+        webhooks=webhooks,
+        buffer_size=raw.get("buffer_size", 500),
+        agents=agents,
+    )
+
+
+def sanitize_agent_name(dirname: str) -> str:
+    """Sanitize a directory name into a valid agent/server name.
+
+    Lowercase, replace non-alphanumeric chars with hyphens, collapse
+    multiple hyphens, strip leading/trailing hyphens.
+    """
+    name = dirname.lower()
+    name = re.sub(r"[^a-z0-9-]", "-", name)
+    name = re.sub(r"-+", "-", name)
+    name = name.strip("-")
+    if not name:
+        raise ValueError(f"sanitized name is empty for input: {dirname!r}")
+    return name
+
+
+def load_config_or_default(path: str | Path) -> DaemonConfig:
+    """Load config from path, returning a default DaemonConfig if file is missing."""
+    path = Path(path)
+    if not path.exists():
+        return DaemonConfig()
+    return load_config(path)
+
+
+def save_config(path: str | Path, config: DaemonConfig) -> None:
+    """Serialize a DaemonConfig to YAML and write atomically."""
+    path = Path(path)
+    path.parent.mkdir(parents=True, exist_ok=True)
+
+    data = asdict(config)
+    yaml_str = yaml.dump(data, default_flow_style=False)
+
+    # Atomic write: write to temp file in same dir, then rename
+    fd, tmp_path = tempfile.mkstemp(
+        dir=str(path.parent), suffix=".yaml.tmp",
+    )
+    try:
+        with os.fdopen(fd, "w") as f:
+            f.write(yaml_str)
+        os.replace(tmp_path, str(path))
+    except BaseException:
+        # Clean up temp file on failure
+        try:
+            os.unlink(tmp_path)
+        except OSError:
+            pass
+        raise
+
+
+def add_agent_to_config(
+    path: str | Path,
+    agent: AgentConfig,
+    server_name: str | None = None,
+) -> DaemonConfig:
+    """Add an agent to a config file, creating it if needed.
+
+    If server_name is provided, updates config.server.name.
+    Raises ValueError if an agent with the same nick already exists.
+    """
+    config = load_config_or_default(path)
+
+    if server_name is not None:
+        config.server.name = server_name
+
+    # Check for nick collision
+    for existing in config.agents:
+        if existing.nick == agent.nick:
+            raise ValueError(
+                f"agent with nick {agent.nick!r} already exists in config"
+            )
+
+    config.agents.append(agent)
+    save_config(path, config)
+    return config