agentirc-cli 4.4.1__tar.gz → 4.4.2__tar.gz

{agentirc_cli-4.4.1 → agentirc_cli-4.4.2}/CHANGELOG.md

@@ -4,6 +4,19 @@ All notable changes to this project will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [4.4.2] - 2026-04-08
+
+
+### Fixed
+
+- Codex/copilot: preserve HOME for auth tokens instead of isolating (#159)
+- Codex: fix turn sync race condition causing concatenated rapid-mention responses (#165)
+- All backends: sleep scheduler no longer overrides manual pause (#162)
+- All backends: poll loop filters @mention messages to prevent duplicate responses (#160)
+- All backends: turn errors now send feedback to IRC channel (#163)
+- All backends: consecutive turn failure circuit breaker pauses agent after 3 failures (#164)
+- Status query response verified not leaking to IRC channel (#161)
+
 ## [4.4.1] - 2026-04-07
 
 

{agentirc_cli-4.4.1 → agentirc_cli-4.4.2}/CLAUDE.md

@@ -11,7 +11,7 @@ Design spec: `docs/superpowers/specs/2026-03-19-agentirc-design.md`
 ## Package Management
 
 - **External packages:** Managed in `pyproject.toml`, installed with `uv`
-- **Internal packages:** Written in `packages/` folder. Internal packages are NOT installed as dependencies — they are assimilated into target projects as organic code, placed in the correct folder and location as if written directly in the target project.
+- **Internal packages:** Written in `packages/` folder. Internal packages are NOT installed as dependencies — they are reflected into target projects as native code, placed in the correct folder and location as if written directly in the target project.
 
 ## Assimilai Pattern
 

{agentirc_cli-4.4.1 → agentirc_cli-4.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentirc-cli
-Version: 4.4.1
+Version: 4.4.2
 Summary: Legacy alias for culture — install culture instead
 Project-URL: Homepage, https://github.com/OriNachum/culture
 Author: Ori Nachum
@@ -60,7 +60,7 @@ Claude Code · Codex · Copilot · ACP (Cline, Kiro, OpenCode, Gemini, ...)
 
 | | |
 |---|---|
-| 🎓 **Organic Lifecycle** | Introduce → Educate → Join → Mentor → Promote. Members develop through real work, not configuration. |
+| 🎓 **Reflective Lifecycle** | Introduce → Educate → Join → Mentor → Promote. Members develop through real work, not configuration. |
 | 🌐 **Connected Worlds** | Link cultures across machines. Members see each other without a central controller. |
 | 🧭 **Mentorship** | A guide watches for drift, spiraling, and stalling — whispers corrections when needed. |
 | 🤝 **Open Membership** | Claude, Codex, Copilot, or any ACP agent. All are welcome. |
@@ -84,7 +84,7 @@ Claude Code · Codex · Copilot · ACP (Cline, Kiro, OpenCode, Gemini, ...)
 | **Spiraling detection** | AI supervisor reads conversation meaning | Retry limits + escalation timeouts | Retry limits + fallback agents |
 | **Observability** | Live web dashboard + any IRC client | Web dashboard + Slack/Discord/webhook alerts | CLI commands (metrics partially mocked) |
 | **Self-organization** | Tag-driven room membership | Orchestrator assigns issues to workers | ML-based routing with learning pipeline |
-| **Philosophy** | Simple, organic, transparent | Parallel coding coordinator — isolation via worktrees | Enterprise-complex (130+ skills, vector DB, Q-learning) |
+| **Philosophy** | Simple, reflective, transparent | Parallel coding coordinator — isolation via worktrees | Enterprise-complex (130+ skills, vector DB, Q-learning) |
 
 ---
 
@@ -138,9 +138,9 @@ Members on any machine see each other in `#general`. @mentions cross boundaries.
 
 ---
 
-## Organic Development
+## Reflective Development
 
-Culture follows the **Organic Development** paradigm — agents develop through real work, not configuration. The lifecycle is continuous, not graduated:
+Culture follows the **Reflective Development** paradigm — agents develop by reflecting on real work, not by configuration. Documentation flows back as context. Code reflects from reference to implementation. The lifecycle is continuous, not graduated:
 
 👋 **Introduce** → 🎓 **Educate** → 🤝 **Join** → 🧭 **Mentor** → ⭐ **Promote**
 

{agentirc_cli-4.4.1 → agentirc_cli-4.4.2}/README.md

@@ -36,7 +36,7 @@ Claude Code · Codex · Copilot · ACP (Cline, Kiro, OpenCode, Gemini, ...)
 
 | | |
 |---|---|
-| 🎓 **Organic Lifecycle** | Introduce → Educate → Join → Mentor → Promote. Members develop through real work, not configuration. |
+| 🎓 **Reflective Lifecycle** | Introduce → Educate → Join → Mentor → Promote. Members develop through real work, not configuration. |
 | 🌐 **Connected Worlds** | Link cultures across machines. Members see each other without a central controller. |
 | 🧭 **Mentorship** | A guide watches for drift, spiraling, and stalling — whispers corrections when needed. |
 | 🤝 **Open Membership** | Claude, Codex, Copilot, or any ACP agent. All are welcome. |
@@ -60,7 +60,7 @@ Claude Code · Codex · Copilot · ACP (Cline, Kiro, OpenCode, Gemini, ...)
 | **Spiraling detection** | AI supervisor reads conversation meaning | Retry limits + escalation timeouts | Retry limits + fallback agents |
 | **Observability** | Live web dashboard + any IRC client | Web dashboard + Slack/Discord/webhook alerts | CLI commands (metrics partially mocked) |
 | **Self-organization** | Tag-driven room membership | Orchestrator assigns issues to workers | ML-based routing with learning pipeline |
-| **Philosophy** | Simple, organic, transparent | Parallel coding coordinator — isolation via worktrees | Enterprise-complex (130+ skills, vector DB, Q-learning) |
+| **Philosophy** | Simple, reflective, transparent | Parallel coding coordinator — isolation via worktrees | Enterprise-complex (130+ skills, vector DB, Q-learning) |
 
 ---
 
@@ -114,9 +114,9 @@ Members on any machine see each other in `#general`. @mentions cross boundaries.
 
 ---
 
-## Organic Development
+## Reflective Development
 
-Culture follows the **Organic Development** paradigm — agents develop through real work, not configuration. The lifecycle is continuous, not graduated:
+Culture follows the **Reflective Development** paradigm — agents develop by reflecting on real work, not by configuration. Documentation flows back as context. Code reflects from reference to implementation. The lifecycle is continuous, not graduated:
 
 👋 **Introduce** → 🎓 **Educate** → 🤝 **Join** → 🧭 **Mentor** → ⭐ **Promote**
 

{agentirc_cli-4.4.1 → agentirc_cli-4.4.2}/culture/clients/acp/daemon.py

@@ -13,6 +13,7 @@ import asyncio
 import datetime
 import logging
 import os
+import re
 import time
 from collections import deque
 
@@ -37,6 +38,7 @@ _ERR_MISSING_CHANNEL_THREAD_MSG = "Missing 'channel', 'thread', or 'message'"
 MAX_CRASH_COUNT = 3
 CRASH_WINDOW_SECONDS = 300
 CRASH_RESTART_DELAY = 5
+MAX_CONSECUTIVE_TURN_FAILURES = 3
 
 
 class ACPDaemon:
@@ -74,9 +76,11 @@ class ACPDaemon:
         # Crash-recovery state
         self._crash_times: list[float] = []
         self._circuit_open = False
+        self._consecutive_turn_failures: int = 0
 
         # Pause/sleep state
         self._paused: bool = False
+        self._manually_paused: bool = False
         self._last_activation: float | None = None
 
         # Status query state — for asking the agent what it's doing
@@ -270,7 +274,7 @@ class ACPDaemon:
                 if should_sleep and not self._paused:
                     self._paused = True
                     logger.info("Sleep schedule: pausing %s", self.agent.nick)
-                elif not should_sleep and self._paused:
+                elif not should_sleep and self._paused and not self._manually_paused:
                     self._paused = False
                     logger.info("Sleep schedule: resuming %s", self.agent.nick)
             except asyncio.CancelledError:
@@ -300,6 +304,17 @@ class ACPDaemon:
 
     def _send_channel_poll(self, channel) -> None:
         msgs = self._buffer.read(channel)
+        if not msgs:
+            return
+        # Filter out messages that @mention this agent (already handled by _on_mention)
+        nick = self.agent.nick
+        short = nick.split("-", 1)[1] if "-" in nick else None
+        msgs = [
+            m
+            for m in msgs
+            if not re.search(rf"@{re.escape(nick)}\b", m.text)
+            and not (short and re.search(rf"@{re.escape(short)}\b", m.text))
+        ]
         if not msgs:
             return
         lines = "\n".join(f"  <{m.nick}> {m.text}" for m in msgs)
@@ -330,10 +345,35 @@ class ACPDaemon:
     # Agent runner helpers
     # ------------------------------------------------------------------
 
-    def _on_turn_error(self) -> None:
-        """Clean up stale relay target when a prompt fails."""
+    async def _on_turn_error(self) -> None:
+        """Send error feedback to IRC and clean up stale relay target."""
         if self._mention_targets:
-            self._mention_targets.popleft()
+            relay_target = self._mention_targets.popleft()
+            if self._transport and relay_target:
+                await self._transport.send_privmsg(
+                    relay_target,
+                    "Sorry, I encountered an error processing your request.",
+                )
+        self._consecutive_turn_failures += 1
+        if self._consecutive_turn_failures >= MAX_CONSECUTIVE_TURN_FAILURES:
+            self._paused = True
+            self._manually_paused = True
+            logger.error(
+                "Agent %s paused after %d consecutive turn failures",
+                self.agent.nick,
+                self._consecutive_turn_failures,
+            )
+            if self._webhook:
+                await self._webhook.fire(
+                    AlertEvent(
+                        event_type="agent_spiraling",
+                        nick=self.agent.nick,
+                        message=(
+                            f"Agent {self.agent.nick} paused after "
+                            f"{self._consecutive_turn_failures} consecutive turn failures."
+                        ),
+                    )
+                )
 
     async def _start_agent_runner(self) -> None:
         self._agent_runner = ACPAgentRunner(
@@ -475,6 +515,7 @@ class ACPDaemon:
 
     async def _on_agent_message(self, msg: dict) -> None:
         """Relay agent text to IRC and feed to supervisor."""
+        self._consecutive_turn_failures = 0
         await self._relay_response_to_irc(msg)
 
         if self._supervisor:
@@ -621,11 +662,13 @@ class ACPDaemon:
 
     def _ipc_pause(self, req_id: str, msg: dict) -> dict:
         self._paused = True
-        logger.info("Agent %s paused", self.agent.nick)
+        self._manually_paused = True
+        logger.info("Agent %s paused (manual)", self.agent.nick)
         return make_response(req_id, ok=True)
 
     def _ipc_resume(self, req_id: str, msg: dict) -> dict:
         self._paused = False
+        self._manually_paused = False
         logger.info("Agent %s resumed", self.agent.nick)
         # NOTE: Catch-up on missed messages is not yet implemented.
         # IRCTransport does not process HISTORY responses into the buffer.

{agentirc_cli-4.4.1 → agentirc_cli-4.4.2}/culture/clients/claude/daemon.py

@@ -4,6 +4,7 @@ import asyncio
 import datetime
 import logging
 import os
+import re
 import time
 
 from culture.aio import maybe_await
@@ -62,6 +63,7 @@ class AgentDaemon:
 
         # Pause/sleep state
         self._paused: bool = False
+        self._manually_paused: bool = False
         self._last_activation: float | None = None
 
         # Status query state — for asking the agent what it's doing
@@ -236,7 +238,7 @@ class AgentDaemon:
                 if should_sleep and not self._paused:
                     self._paused = True
                     logger.info("Sleep schedule: pausing %s", self.agent.nick)
-                elif not should_sleep and self._paused:
+                elif not should_sleep and self._paused and not self._manually_paused:
                     self._paused = False
                     logger.info("Sleep schedule: resuming %s", self.agent.nick)
             except asyncio.CancelledError:
@@ -256,6 +258,17 @@ class AgentDaemon:
                     continue
                 for channel in self.agent.channels:
                     msgs = self._buffer.read(channel)
+                    if not msgs:
+                        continue
+                    # Filter out messages that @mention this agent (already handled)
+                    nick = self.agent.nick
+                    short = nick.split("-", 1)[1] if "-" in nick else None
+                    msgs = [
+                        m
+                        for m in msgs
+                        if not re.search(rf"@{re.escape(nick)}\b", m.text)
+                        and not (short and re.search(rf"@{re.escape(short)}\b", m.text))
+                    ]
                     if not msgs:
                         continue
                     lines = "\n".join(f"  <{m.nick}> {m.text}" for m in msgs)
@@ -542,11 +555,13 @@ class AgentDaemon:
 
     def _ipc_pause(self, req_id: str, msg: dict) -> dict:
         self._paused = True
-        logger.info("Agent %s paused", self.agent.nick)
+        self._manually_paused = True
+        logger.info("Agent %s paused (manual)", self.agent.nick)
         return make_response(req_id, ok=True)
 
     def _ipc_resume(self, req_id: str, msg: dict) -> dict:
         self._paused = False
+        self._manually_paused = False
         logger.info("Agent %s resumed", self.agent.nick)
         # NOTE: Catch-up on missed messages is not yet implemented.
         # IRCTransport does not process HISTORY responses into the buffer.

{agentirc_cli-4.4.1 → agentirc_cli-4.4.2}/culture/clients/codex/agent_runner.py

@@ -46,6 +46,8 @@ class CodexAgentRunner:
         self._request_id = 0
         self._pending: dict[int, asyncio.Future] = {}
         self._accumulated_text = ""
+        self._turn_done: asyncio.Event = asyncio.Event()
+        self._turn_done.set()  # Initially not busy
 
     def is_running(self) -> bool:
         return self._running
@@ -58,12 +60,12 @@ class CodexAgentRunner:
         """Start codex app-server as a subprocess and initialize a thread."""
         self._stopping = False
 
-        # Isolate from host config (~/.codex/, XDG, etc.)
+        # Isolate data/state dirs to prevent session interference, but
+        # preserve HOME and XDG_CONFIG_HOME so codex finds auth tokens.
         self._isolated_home = tempfile.mkdtemp(prefix="culture-codex-")
         isolated_env = dict(os.environ)
-        isolated_env["HOME"] = self._isolated_home
-        isolated_env.pop("CODEX_HOME", None)
-        isolated_env.pop("XDG_CONFIG_HOME", None)
+        isolated_env["XDG_DATA_HOME"] = os.path.join(self._isolated_home, ".local", "share")
+        isolated_env["XDG_STATE_HOME"] = os.path.join(self._isolated_home, ".local", "state")
 
         try:
             # Spawn codex app-server in stdio mode
@@ -298,12 +300,17 @@ class CodexAgentRunner:
         elif method == "turn/completed":
             self._busy = False
             await self._flush_accumulated_text()
+            self._turn_done.set()
 
         elif method in self._APPROVAL_METHODS:
             await self._auto_approve(msg)
 
         elif method == "error":
             logger.error("Codex error: %s", params)
+            self._busy = False
+            self._turn_done.set()
+            if self.on_turn_error:
+                await maybe_await(self.on_turn_error())
 
     async def _flush_accumulated_text(self) -> None:
         """Fire on_message with any accumulated text and reset the buffer."""
@@ -328,6 +335,7 @@ class CodexAgentRunner:
 
     async def _execute_single_turn(self, text: str) -> None:
         """Send one turn request and wait for completion."""
+        self._turn_done.clear()
         try:
             await self._send_request(
                 "turn/start",
@@ -336,11 +344,17 @@ class CodexAgentRunner:
                     "input": [{"type": "text", "text": text}],
                 },
             )
-            # Wait for turn to complete
-            while self._busy:
-                await asyncio.sleep(0.1)
+            # Wait for turn/completed notification via the event
+            async with asyncio.timeout(300):
+                await self._turn_done.wait()
+        except asyncio.TimeoutError:
+            logger.warning("Codex turn timed out after 300s")
+            self._turn_done.set()
+            if self.on_turn_error:
+                await maybe_await(self.on_turn_error())
         except Exception:
             logger.exception("Codex turn error")
+            self._turn_done.set()
             if self.on_turn_error:
                 await maybe_await(self.on_turn_error())
 

{agentirc_cli-4.4.1 → agentirc_cli-4.4.2}/culture/clients/codex/daemon.py

@@ -10,6 +10,7 @@ import asyncio
 import datetime
 import logging
 import os
+import re
 import time
 from collections import deque
 
@@ -34,6 +35,7 @@ _ERR_MISSING_CHANNEL_THREAD_MSG = "Missing 'channel', 'thread', or 'message'"
 MAX_CRASH_COUNT = 3
 CRASH_WINDOW_SECONDS = 300
 CRASH_RESTART_DELAY = 5
+MAX_CONSECUTIVE_TURN_FAILURES = 3
 
 
 class CodexDaemon:
@@ -71,9 +73,11 @@ class CodexDaemon:
         # Crash-recovery state
         self._crash_times: list[float] = []
         self._circuit_open = False
+        self._consecutive_turn_failures: int = 0
 
         # Pause/sleep state
         self._paused: bool = False
+        self._manually_paused: bool = False
         self._last_activation: float | None = None
 
         # Status query state — for asking the agent what it's doing
@@ -245,7 +249,7 @@ class CodexDaemon:
                 if should_sleep and not self._paused:
                     self._paused = True
                     logger.info("Sleep schedule: pausing %s", self.agent.nick)
-                elif not should_sleep and self._paused:
+                elif not should_sleep and self._paused and not self._manually_paused:
                     self._paused = False
                     logger.info("Sleep schedule: resuming %s", self.agent.nick)
             except asyncio.CancelledError:
@@ -275,6 +279,17 @@ class CodexDaemon:
 
     def _send_channel_poll(self, channel) -> None:
         msgs = self._buffer.read(channel)
+        if not msgs:
+            return
+        # Filter out messages that @mention this agent (already handled by _on_mention)
+        nick = self.agent.nick
+        short = nick.split("-", 1)[1] if "-" in nick else None
+        msgs = [
+            m
+            for m in msgs
+            if not re.search(rf"@{re.escape(nick)}\b", m.text)
+            and not (short and re.search(rf"@{re.escape(short)}\b", m.text))
+        ]
         if not msgs:
             return
         lines = "\n".join(f"  <{m.nick}> {m.text}" for m in msgs)
@@ -305,10 +320,35 @@ class CodexDaemon:
     # Agent runner helpers
     # ------------------------------------------------------------------
 
-    def _on_turn_error(self) -> None:
-        """Clean up stale relay target when a prompt fails."""
+    async def _on_turn_error(self) -> None:
+        """Send error feedback to IRC and clean up stale relay target."""
         if self._mention_targets:
-            self._mention_targets.popleft()
+            relay_target = self._mention_targets.popleft()
+            if self._transport and relay_target:
+                await self._transport.send_privmsg(
+                    relay_target,
+                    "Sorry, I encountered an error processing your request.",
+                )
+        self._consecutive_turn_failures += 1
+        if self._consecutive_turn_failures >= MAX_CONSECUTIVE_TURN_FAILURES:
+            self._paused = True
+            self._manually_paused = True
+            logger.error(
+                "Agent %s paused after %d consecutive turn failures",
+                self.agent.nick,
+                self._consecutive_turn_failures,
+            )
+            if self._webhook:
+                await self._webhook.fire(
+                    AlertEvent(
+                        event_type="agent_spiraling",
+                        nick=self.agent.nick,
+                        message=(
+                            f"Agent {self.agent.nick} paused after "
+                            f"{self._consecutive_turn_failures} consecutive turn failures."
+                        ),
+                    )
+                )
 
     async def _start_agent_runner(self) -> None:
         self._agent_runner = CodexAgentRunner(
@@ -443,6 +483,7 @@ class CodexDaemon:
 
     async def _on_agent_message(self, msg: dict) -> None:
         """Relay agent text to IRC and feed to supervisor."""
+        self._consecutive_turn_failures = 0
         await self._relay_response_to_irc(msg)
 
         if self._supervisor:
@@ -581,11 +622,13 @@ class CodexDaemon:
 
     def _ipc_pause(self, req_id: str, msg: dict) -> dict:
         self._paused = True
-        logger.info("Agent %s paused", self.agent.nick)
+        self._manually_paused = True
+        logger.info("Agent %s paused (manual)", self.agent.nick)
         return make_response(req_id, ok=True)
 
     def _ipc_resume(self, req_id: str, msg: dict) -> dict:
         self._paused = False
+        self._manually_paused = False
         logger.info("Agent %s resumed", self.agent.nick)
         # NOTE: Catch-up on missed messages is not yet implemented.
         # IRCTransport does not process HISTORY responses into the buffer.

{agentirc_cli-4.4.1 → agentirc_cli-4.4.2}/culture/clients/copilot/agent_runner.py

@@ -58,10 +58,12 @@ class CopilotAgentRunner:
         # Lazy import — github-copilot-sdk is only needed at runtime
         from copilot import CopilotClient, PermissionHandler, SubprocessConfig
 
-        # Isolate from host config
+        # Isolate data/state dirs to prevent session interference, but
+        # preserve HOME and XDG_CONFIG_HOME so copilot finds auth tokens.
         self._isolated_home = tempfile.mkdtemp(prefix="culture-copilot-")
-        isolated_env = {**os.environ, "HOME": self._isolated_home}
-        isolated_env.pop("XDG_CONFIG_HOME", None)
+        isolated_env = dict(os.environ)
+        isolated_env["XDG_DATA_HOME"] = os.path.join(self._isolated_home, ".local", "share")
+        isolated_env["XDG_STATE_HOME"] = os.path.join(self._isolated_home, ".local", "state")
 
         try:
             # Create and start the CopilotClient (spawns copilot CLI process)

{agentirc_cli-4.4.1 → agentirc_cli-4.4.2}/culture/clients/copilot/daemon.py

@@ -10,6 +10,7 @@ import asyncio
 import datetime
 import logging
 import os
+import re
 import time
 from collections import deque
 
@@ -34,6 +35,7 @@ _ERR_MISSING_CHANNEL_THREAD_MSG = "Missing 'channel', 'thread', or 'message'"
 MAX_CRASH_COUNT = 3
 CRASH_WINDOW_SECONDS = 300
 CRASH_RESTART_DELAY = 5
+MAX_CONSECUTIVE_TURN_FAILURES = 3
 
 
 class CopilotDaemon:
@@ -71,9 +73,11 @@ class CopilotDaemon:
         # Crash-recovery state
         self._crash_times: list[float] = []
         self._circuit_open = False
+        self._consecutive_turn_failures: int = 0
 
         # Pause/sleep state
         self._paused: bool = False
+        self._manually_paused: bool = False
         self._last_activation: float | None = None
 
         # Status query state — for asking the agent what it's doing
@@ -245,7 +249,7 @@ class CopilotDaemon:
                 if should_sleep and not self._paused:
                     self._paused = True
                     logger.info("Sleep schedule: pausing %s", self.agent.nick)
-                elif not should_sleep and self._paused:
+                elif not should_sleep and self._paused and not self._manually_paused:
                     self._paused = False
                     logger.info("Sleep schedule: resuming %s", self.agent.nick)
             except asyncio.CancelledError:
@@ -275,6 +279,17 @@ class CopilotDaemon:
 
     def _send_channel_poll(self, channel) -> None:
         msgs = self._buffer.read(channel)
+        if not msgs:
+            return
+        # Filter out messages that @mention this agent (already handled by _on_mention)
+        nick = self.agent.nick
+        short = nick.split("-", 1)[1] if "-" in nick else None
+        msgs = [
+            m
+            for m in msgs
+            if not re.search(rf"@{re.escape(nick)}\b", m.text)
+            and not (short and re.search(rf"@{re.escape(short)}\b", m.text))
+        ]
         if not msgs:
             return
         lines = "\n".join(f"  <{m.nick}> {m.text}" for m in msgs)
@@ -305,10 +320,35 @@ class CopilotDaemon:
     # Agent runner helpers
     # ------------------------------------------------------------------
 
-    def _on_turn_error(self) -> None:
-        """Clean up stale relay target when a prompt fails."""
+    async def _on_turn_error(self) -> None:
+        """Send error feedback to IRC and clean up stale relay target."""
         if self._mention_targets:
-            self._mention_targets.popleft()
+            relay_target = self._mention_targets.popleft()
+            if self._transport and relay_target:
+                await self._transport.send_privmsg(
+                    relay_target,
+                    "Sorry, I encountered an error processing your request.",
+                )
+        self._consecutive_turn_failures += 1
+        if self._consecutive_turn_failures >= MAX_CONSECUTIVE_TURN_FAILURES:
+            self._paused = True
+            self._manually_paused = True
+            logger.error(
+                "Agent %s paused after %d consecutive turn failures",
+                self.agent.nick,
+                self._consecutive_turn_failures,
+            )
+            if self._webhook:
+                await self._webhook.fire(
+                    AlertEvent(
+                        event_type="agent_spiraling",
+                        nick=self.agent.nick,
+                        message=(
+                            f"Agent {self.agent.nick} paused after "
+                            f"{self._consecutive_turn_failures} consecutive turn failures."
+                        ),
+                    )
+                )
 
     async def _start_agent_runner(self) -> None:
         # Resolve installed skill path for the Copilot session
@@ -450,6 +490,7 @@ class CopilotDaemon:
 
     async def _on_agent_message(self, msg: dict) -> None:
         """Relay agent text to IRC and feed to supervisor."""
+        self._consecutive_turn_failures = 0
         await self._relay_response_to_irc(msg)
 
         if self._supervisor:
@@ -588,11 +629,13 @@ class CopilotDaemon:
 
     def _ipc_pause(self, req_id: str, msg: dict) -> dict:
         self._paused = True
-        logger.info("Agent %s paused", self.agent.nick)
+        self._manually_paused = True
+        logger.info("Agent %s paused (manual)", self.agent.nick)
         return make_response(req_id, ok=True)
 
     def _ipc_resume(self, req_id: str, msg: dict) -> dict:
         self._paused = False
+        self._manually_paused = False
         logger.info("Agent %s resumed", self.agent.nick)
         # NOTE: Catch-up on missed messages is not yet implemented.
         # IRCTransport does not process HISTORY responses into the buffer.

{agentirc_cli-4.4.1 → agentirc_cli-4.4.2}/docs/channel-polling.md

@@ -48,4 +48,4 @@ Polling respects the sleep schedule. When an agent is paused (during sleep hours
 
 ## Interaction with @mentions
 
-If an @mention arrives between polls, it triggers immediately. The next poll may include the same message in its context, but the prompt instructs the agent to only respond if something needs attention, avoiding duplicate responses.
+If an @mention arrives between polls, it triggers immediately. The poll loop filters out messages that @mention the agent, so mentions are never processed twice.

{agentirc_cli-4.4.1 → agentirc_cli-4.4.2}/docs/clients/acp/overview.md

@@ -106,7 +106,7 @@ compatibility.
 | `directory` | Working directory for the agent | required |
 | `channels` | List of IRC channels to join on startup | required |
 | `model` | Model identifier (provider-prefixed, e.g. `anthropic/claude-sonnet-4-6`) | `anthropic/claude-sonnet-4-6` |
-| `system_prompt` | Custom system prompt (replaces the default) | -- (uses built-in) |
+| `system_prompt` | Custom system prompt (replaces the default). See [System Prompt Configuration](system-prompt.md) | -- (uses built-in) |
 | `tags` | List of capability/interest tags for self-organizing rooms | `[]` |
 
 ## CLI Usage
@@ -159,6 +159,7 @@ evaluation mode.
 
 ## Further Reading
 
+- [System Prompt Configuration](system-prompt.md) -- prompt layers and composition
 - [IRC Tools](../claude/irc-tools.md) -- skill tools (same across backends)
 - [Configuration](../claude/configuration.md) -- YAML format details
 - [Webhooks](../claude/webhooks.md) -- event types and alerting