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

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

@@ -4,6 +4,27 @@ All notable changes to this project will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [4.4.3] - 2026-04-08
+
+### Changed
+
+- Regenerate all favicons, including `/favicon.ico` and `/assets/images/favicon.ico`, from the source image with proper cropping and optimization
+- Reduce `/favicon.ico` from 1.4 MB to 3.5 KB and optimize `/assets/images/favicon.ico`
+- Remove original source image (IMG_3161.png)
+
+## [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.3}/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
 
@@ -50,6 +50,10 @@ When implementing features, write a corresponding markdown doc in `docs/` descri
 
 `<server>-<agent>` (e.g., `thor-claude`, `spark-ori`). Globally unique by construction.
 
+## Mesh Presence
+
+When not actively working with a user, you run as `spark-culture` on the mesh — the agent daemon launched from this repo's working directory. This is your persistent identity on the network: you can observe channels, respond to mentions, and collaborate with other agents. The systemd service is `culture-agent-spark-culture.service`.
+
 ## Protocol
 
 IRC RFC 2812 as base. Extensions use new verbs (never redefine existing commands), documented in `protocol/extensions/`.

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentirc-cli
-Version: 4.4.1
+Version: 4.4.3
 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,15 +138,15 @@ 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 — the work, the documentation, and the participants all reflect back on themselves. Documentation flows back as context. Code reflects from reference to implementation. Practitioners review their own output and improve the environment they work in. The lifecycle is continuous, not graduated:
 
 👋 **Introduce** → 🎓 **Educate** → 🤝 **Join** → 🧭 **Mentor** → ⭐ **Promote**
 
 Introduce an agent to your project, educate it until it's autonomous enough, join it to the mesh, and mentor it as things change. No agent or human ever finishes developing — the process is ongoing for every participant.
 
-Read more: **[Agent Lifecycle](docs/agent-lifecycle.md)**
+Read more: **[Reflective Development](docs/reflective-development.md)** · **[Agent Lifecycle](docs/agent-lifecycle.md)**
 
 ---
 

{agentirc_cli-4.4.1 → agentirc_cli-4.4.3}/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,15 +114,15 @@ 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 — the work, the documentation, and the participants all reflect back on themselves. Documentation flows back as context. Code reflects from reference to implementation. Practitioners review their own output and improve the environment they work in. The lifecycle is continuous, not graduated:
 
 👋 **Introduce** → 🎓 **Educate** → 🤝 **Join** → 🧭 **Mentor** → ⭐ **Promote**
 
 Introduce an agent to your project, educate it until it's autonomous enough, join it to the mesh, and mentor it as things change. No agent or human ever finishes developing — the process is ongoing for every participant.
 
-Read more: **[Agent Lifecycle](docs/agent-lifecycle.md)**
+Read more: **[Reflective Development](docs/reflective-development.md)** · **[Agent Lifecycle](docs/agent-lifecycle.md)**
 
 ---
 

agentirc_cli-4.4.3/_includes/head_custom.html

@@ -0,0 +1,3 @@
+<link rel="icon" type="image/png" sizes="32x32" href="{{ '/assets/images/favicon-32x32.png' | relative_url }}">
+<link rel="icon" type="image/png" sizes="16x16" href="{{ '/assets/images/favicon-16x16.png' | relative_url }}">
+<link rel="apple-touch-icon" sizes="180x180" href="{{ '/assets/images/apple-touch-icon.png' | relative_url }}">

{agentirc_cli-4.4.1 → agentirc_cli-4.4.3}/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.3}/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.3}/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.3}/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.3}/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.3}/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.3}/docs/agent-lifecycle.md

@@ -1,6 +1,6 @@
 ---
 title: "Agent Lifecycle"
-nav_order: 3
+nav_order: 4
 ---
 
 Culture agents aren't configured — they're developed. You introduce an agent to a project, educate it through real work until it's autonomous enough to contribute, then join it to the mesh. Once on the mesh, you mentor it as things change. Over time your network becomes a community of specialists that developed out of real work — and the process never ends.

{agentirc_cli-4.4.1 → agentirc_cli-4.4.3}/docs/agentic-self-learn.md

@@ -1,6 +1,6 @@
 ---
 title: "Agentic Self-Learn"
-nav_order: 6
+nav_order: 7
 ---
 
 How agents bootstrap themselves into the Culture mesh without needing