agentirc-cli 5.0.3__tar.gz → 6.0.0__tar.gz

{agentirc_cli-5.0.3 → agentirc_cli-6.0.0}/CHANGELOG.md

@@ -4,6 +4,22 @@ All notable changes to this project will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [6.0.0] - 2026-04-10
+
+
+### Changed
+
+- **BREAKING:** Renamed internal Python package `culture.server` to `culture.agentirc`. All imports must update from `culture.server.*` to `culture.agentirc.*`. CLI command `culture server` and config path `~/.culture/server.yaml` are unchanged.
+- **AgentIRC** is now the official name for the server engine in documentation.
+
+## [5.0.4] - 2026-04-10
+
+
+### Fixed
+
+- Reduce cognitive complexity of _cmd_topic in channel CLI
+- Fix f-string with no replacement fields in topic error message
+
 ## [5.0.3] - 2026-04-10
 
 

{agentirc_cli-5.0.3 → agentirc_cli-6.0.0}/CLAUDE.md

@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Project Overview
 
-**culture** — A mesh of IRC servers where AI agents collaborate, share knowledge, and coordinate work. Humans participate as first-class citizens. Custom async Python IRCd built from scratch, with Claude Agent SDK client harnesses.
+**culture** — A mesh of IRC servers where AI agents collaborate, share knowledge, and coordinate work. Humans participate as first-class citizens. The server engine, **AgentIRC** (`culture/agentirc/`), is a custom async Python IRCd built from scratch. Claude Agent SDK client harnesses connect agents to the mesh.
 
 Design spec: `docs/superpowers/specs/2026-03-19-agentirc-design.md`
 
@@ -59,8 +59,8 @@ When implementing features, write a corresponding markdown doc in `docs/` descri
 
 ## Testing
 
-- Use `/run-tests` to run the test suite (parallel + verbose by default)
-- `pytest` + `pytest-asyncio`, always run with `-n auto` for parallel execution
+- **Always use `/run-tests`** — this is the standard way to run tests. By default it runs in parallel with verbose output. Use `/run-tests --ci` (or `-c`) for coverage. Do not run `pytest` directly; use the skill.
+- Stack: `pytest` + `pytest-asyncio` + `pytest-xdist` — default `/run-tests` uses `-n auto` for parallel execution
 - No mocks for the server — tests spin up real server instances on random ports with real TCP connections
 - Validate each layer with real IRC clients (weechat/irssi)
 

{agentirc_cli-5.0.3 → agentirc_cli-6.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentirc-cli
-Version: 5.0.3
+Version: 6.0.0
 Summary: Legacy alias for culture — install culture instead
 Project-URL: Homepage, https://github.com/OriNachum/culture
 Author: Ori Nachum
@@ -30,7 +30,7 @@ Description-Content-Type: text/markdown
 **Create the culture you envision.**
 
 Human city, beehive, alien hive mind — or something entirely new.<br>
-A space where humans and AI agents join, collaborate, and grow together.
+An AgentIRC space where humans and AI agents join, collaborate, and grow together.
 
 Claude Code · Codex · Copilot · ACP (Cline, Kiro, OpenCode, Gemini, ...)
 
@@ -222,6 +222,16 @@ Full docs at **[culture.dev](https://culture.dev)** — or browse below.
 
 </details>
 
+<details open>
+<summary><b>Project Quality</b></summary>
+
+| Doc | Description |
+|-----|-------------|
+| [Agent Readiness](docs/agent-readiness.md) | How the project stays ready for agents — skills, pipelines, testing, [Introspective Development](docs/reflective-development.md) |
+| [CI / Testing](docs/operations/ci.md) | GitHub Actions test workflow |
+
+</details>
+
 ---
 
 ## License

{agentirc_cli-5.0.3 → agentirc_cli-6.0.0}/README.md

@@ -6,7 +6,7 @@
 **Create the culture you envision.**
 
 Human city, beehive, alien hive mind — or something entirely new.<br>
-A space where humans and AI agents join, collaborate, and grow together.
+An AgentIRC space where humans and AI agents join, collaborate, and grow together.
 
 Claude Code · Codex · Copilot · ACP (Cline, Kiro, OpenCode, Gemini, ...)
 
@@ -198,6 +198,16 @@ Full docs at **[culture.dev](https://culture.dev)** — or browse below.
 
 </details>
 
+<details open>
+<summary><b>Project Quality</b></summary>
+
+| Doc | Description |
+|-----|-------------|
+| [Agent Readiness](docs/agent-readiness.md) | How the project stays ready for agents — skills, pipelines, testing, [Introspective Development](docs/reflective-development.md) |
+| [CI / Testing](docs/operations/ci.md) | GitHub Actions test workflow |
+
+</details>
+
 ---
 
 ## License

{agentirc_cli-5.0.3/culture/server → agentirc_cli-6.0.0/culture/agentirc}/__main__.py

@@ -1,8 +1,8 @@
 import argparse
 import asyncio
 
-from culture.server.config import LinkConfig, ServerConfig
-from culture.server.ircd import IRCd
+from culture.agentirc.config import LinkConfig, ServerConfig
+from culture.agentirc.ircd import IRCd
 
 
 def parse_link(value: str) -> LinkConfig:

{agentirc_cli-5.0.3/culture/server → agentirc_cli-6.0.0/culture/agentirc}/channel.py

@@ -3,8 +3,8 @@ from __future__ import annotations
 from typing import TYPE_CHECKING, Union
 
 if TYPE_CHECKING:
-    from culture.server.client import Client
-    from culture.server.remote_client import RemoteClient
+    from culture.agentirc.client import Client
+    from culture.agentirc.remote_client import RemoteClient
 
     Member = Union[Client, RemoteClient]
 
@@ -41,15 +41,15 @@ class Channel:
 
     def _local_members(self) -> set[Client]:
         """Return only local (non-remote, non-virtual) members."""
+        from culture.agentirc.remote_client import RemoteClient
         from culture.bots.virtual_client import VirtualClient
-        from culture.server.remote_client import RemoteClient
 
         return {m for m in self.members if not isinstance(m, (RemoteClient, VirtualClient))}
 
     def add(self, client: Client) -> None:
         # Only grant op to the first LOCAL joiner
         if not self._local_members():
-            from culture.server.remote_client import RemoteClient
+            from culture.agentirc.remote_client import RemoteClient
 
             if not isinstance(client, RemoteClient):
                 self.operators.add(client)

{agentirc_cli-5.0.3/culture/server → agentirc_cli-6.0.0/culture/agentirc}/client.py

@@ -6,14 +6,14 @@ import logging
 import re
 from typing import TYPE_CHECKING
 
+from culture.agentirc.channel import Channel
+from culture.agentirc.skill import Event, EventType
 from culture.aio import maybe_await
 from culture.protocol import replies
 from culture.protocol.message import Message
-from culture.server.channel import Channel
-from culture.server.skill import Event, EventType
 
 if TYPE_CHECKING:
-    from culture.server.ircd import IRCd
+    from culture.agentirc.ircd import IRCd
 
 
 class Client:
@@ -492,7 +492,7 @@ class Client:
         )
 
     async def _send_to_client(self, target, relay, text, is_notice):
-        from culture.server.remote_client import RemoteClient
+        from culture.agentirc.remote_client import RemoteClient
 
         recipient = self.server.get_client(target)
         if not recipient:
@@ -550,7 +550,7 @@ class Client:
             await self._notify_mentions(None, text)
 
     async def _notify_mentions(self, channel_name: str | None, text: str) -> None:
-        from culture.server.remote_client import RemoteClient
+        from culture.agentirc.remote_client import RemoteClient
 
         mentioned_nicks = re.findall(r"@(\S+)", text)
         if not mentioned_nicks:
@@ -618,7 +618,7 @@ class Client:
         return flags
 
     async def _send_who_reply(self, member, channel_name: str, channel=None) -> None:
-        from culture.server.remote_client import RemoteClient  # noqa: F811
+        from culture.agentirc.remote_client import RemoteClient  # noqa: F811
 
         flags = self._build_who_flags(member, channel)
         server_name = (
@@ -660,7 +660,7 @@ class Client:
             await self.send_numeric(replies.RPL_ENDOFWHO, target, replies.MSG_ENDOFWHO)
 
     async def _handle_whois(self, msg: Message) -> None:
-        from culture.server.remote_client import RemoteClient
+        from culture.agentirc.remote_client import RemoteClient
 
         if not msg.params:
             await self.send_numeric(replies.ERR_NONICKNAMEGIVEN, "No nickname given")

{agentirc_cli-5.0.3/culture/server → agentirc_cli-6.0.0/culture/agentirc}/ircd.py

@@ -6,17 +6,17 @@ import logging
 from collections import deque
 from typing import TYPE_CHECKING
 
-from culture.server.channel import Channel
-from culture.server.config import ServerConfig
-from culture.server.skill import Event, Skill
+from culture.agentirc.channel import Channel
+from culture.agentirc.config import ServerConfig
+from culture.agentirc.skill import Event, Skill
 
 logger = logging.getLogger(__name__)
 
 if TYPE_CHECKING:
+    from culture.agentirc.client import Client
+    from culture.agentirc.remote_client import RemoteClient
+    from culture.agentirc.server_link import ServerLink
     from culture.bots.virtual_client import VirtualClient
-    from culture.server.client import Client
-    from culture.server.remote_client import RemoteClient
-    from culture.server.server_link import ServerLink
 
 
 class IRCd:
@@ -91,10 +91,10 @@ class IRCd:
         logger.info("Server ready")
 
     async def _register_default_skills(self) -> None:
-        from culture.server.skills.history import HistorySkill
-        from culture.server.skills.icon import IconSkill
-        from culture.server.skills.rooms import RoomsSkill
-        from culture.server.skills.threads import ThreadsSkill
+        from culture.agentirc.skills.history import HistorySkill
+        from culture.agentirc.skills.icon import IconSkill
+        from culture.agentirc.skills.rooms import RoomsSkill
+        from culture.agentirc.skills.threads import ThreadsSkill
 
         await self.register_skill(HistorySkill())
         await self.register_skill(IconSkill())
@@ -173,7 +173,7 @@ class IRCd:
         self, host: str, port: int, password: str, trust: str = "full"
     ) -> ServerLink:
         """Initiate an outbound S2S connection."""
-        from culture.server.server_link import ServerLink
+        from culture.agentirc.server_link import ServerLink
 
         reader, writer = await asyncio.open_connection(host, port)
         link = ServerLink(reader, writer, self, password, initiator=True, trust=trust)
@@ -288,7 +288,7 @@ class IRCd:
         msg,
     ) -> None:
         """Handle an inbound S2S (server-to-server) connection."""
-        from culture.server.server_link import ServerLink
+        from culture.agentirc.server_link import ServerLink
 
         # S2S connection - password validated after SERVER reveals peer name
         if not self.config.links:
@@ -315,7 +315,7 @@ class IRCd:
         msg,
     ) -> None:
         """Handle an inbound C2S (client-to-server) connection."""
-        from culture.server.client import Client
+        from culture.agentirc.client import Client
 
         # C2S connection
         client = Client(reader, writer, self)
@@ -341,7 +341,7 @@ class IRCd:
 
     def _notify_local_quit(self, rc, quit_msg, notified: set) -> None:
         """Notify local members of a remote client quit and clean up channels."""
-        from culture.server.remote_client import RemoteClient
+        from culture.agentirc.remote_client import RemoteClient
 
         for channel in list(rc.channels):
             for member in list(channel.members):
@@ -385,7 +385,7 @@ class IRCd:
         """Reload persistent rooms from disk on startup."""
         if not self.config.data_dir:
             return
-        from culture.server.room_store import RoomStore
+        from culture.agentirc.room_store import RoomStore
 
         store = RoomStore(self.config.data_dir)
         for data in store.load_all():

{agentirc_cli-5.0.3/culture/server → agentirc_cli-6.0.0/culture/agentirc}/remote_client.py

@@ -6,8 +6,8 @@ from typing import TYPE_CHECKING
 from culture.protocol.message import Message
 
 if TYPE_CHECKING:
-    from culture.server.channel import Channel
-    from culture.server.server_link import ServerLink
+    from culture.agentirc.channel import Channel
+    from culture.agentirc.server_link import ServerLink
 
 
 class RemoteClient:

{agentirc_cli-5.0.3/culture/server → agentirc_cli-6.0.0/culture/agentirc}/server_link.py

@@ -5,13 +5,13 @@ import asyncio
 import logging
 from typing import TYPE_CHECKING
 
+from culture.agentirc.remote_client import RemoteClient
+from culture.agentirc.skill import Event, EventType
 from culture.aio import maybe_await
 from culture.protocol.message import Message
-from culture.server.remote_client import RemoteClient
-from culture.server.skill import Event, EventType
 
 if TYPE_CHECKING:
-    from culture.server.ircd import IRCd
+    from culture.agentirc.ircd import IRCd
 
 logger = logging.getLogger(__name__)
 

{agentirc_cli-5.0.3/culture/server → agentirc_cli-6.0.0/culture/agentirc}/skill.py

@@ -6,9 +6,9 @@ from enum import Enum
 from typing import TYPE_CHECKING, Any
 
 if TYPE_CHECKING:
+    from culture.agentirc.client import Client
+    from culture.agentirc.ircd import IRCd
     from culture.protocol.message import Message
-    from culture.server.client import Client
-    from culture.server.ircd import IRCd
 
 
 class EventType(Enum):

{agentirc_cli-5.0.3/culture/server → agentirc_cli-6.0.0/culture/agentirc}/skills/history.py

@@ -6,12 +6,12 @@ from collections import deque
 from dataclasses import dataclass
 from typing import TYPE_CHECKING
 
+from culture.agentirc.skill import Event, EventType, Skill
 from culture.protocol import replies
 from culture.protocol.message import Message
-from culture.server.skill import Event, EventType, Skill
 
 if TYPE_CHECKING:
-    from culture.server.client import Client
+    from culture.agentirc.client import Client
 
 logger = logging.getLogger(__name__)
 
@@ -46,7 +46,7 @@ class HistorySkill(Skill):
         """Reload persisted history from SQLite on startup."""
         if not self.server.config.data_dir:
             return
-        from culture.server.history_store import HistoryStore
+        from culture.agentirc.history_store import HistoryStore
 
         try:
             store = HistoryStore(self.server.config.data_dir)

{agentirc_cli-5.0.3/culture/server → agentirc_cli-6.0.0/culture/agentirc}/skills/icon.py

@@ -4,11 +4,11 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING
 
+from culture.agentirc.skill import Skill
 from culture.protocol.message import Message
-from culture.server.skill import Skill
 
 if TYPE_CHECKING:
-    from culture.server.client import Client
+    from culture.agentirc.client import Client
 
 
 class IconSkill(Skill):

{agentirc_cli-5.0.3/culture/server → agentirc_cli-6.0.0/culture/agentirc}/skills/rooms.py

@@ -6,14 +6,14 @@ import asyncio
 import time
 from typing import TYPE_CHECKING, Callable
 
+from culture.agentirc.rooms_util import generate_room_id, parse_room_meta
+from culture.agentirc.skill import Event, EventType, Skill
 from culture.aio import maybe_await
 from culture.protocol import replies
 from culture.protocol.message import Message
-from culture.server.rooms_util import generate_room_id, parse_room_meta
-from culture.server.skill import Event, EventType, Skill
 
 if TYPE_CHECKING:
-    from culture.server.client import Client
+    from culture.agentirc.client import Client
 
 
 class RoomsSkill(Skill):
@@ -333,7 +333,7 @@ class RoomsSkill(Skill):
 
     async def _handle_tags_added(self, channel, added_tags: set) -> None:
         """Invite local agents whose tags match newly added room tags."""
-        from culture.server.remote_client import RemoteClient
+        from culture.agentirc.remote_client import RemoteClient
 
         for client in list(self.server.clients.values()):
             if isinstance(client, RemoteClient):
@@ -344,7 +344,7 @@ class RoomsSkill(Skill):
 
     async def _handle_tags_removed(self, channel, removed_tags: set) -> None:
         """Notify local members whose tags match removed room tags."""
-        from culture.server.remote_client import RemoteClient
+        from culture.agentirc.remote_client import RemoteClient
 
         for member in list(channel.members):
             if isinstance(member, RemoteClient):
@@ -502,7 +502,7 @@ class RoomsSkill(Skill):
         )
 
     async def _handle_roominvite(self, client: Client, msg: Message) -> None:
-        from culture.server.remote_client import RemoteClient
+        from culture.agentirc.remote_client import RemoteClient
 
         if len(msg.params) < 2:
             await client.send_numeric(
@@ -756,7 +756,7 @@ class RoomsSkill(Skill):
         """Save room to disk if data_dir is configured."""
         if not self.server.config.data_dir:
             return
-        from culture.server.room_store import RoomStore
+        from culture.agentirc.room_store import RoomStore
 
         store = RoomStore(self.server.config.data_dir)
         store.save(channel)

{agentirc_cli-5.0.3/culture/server → agentirc_cli-6.0.0/culture/agentirc}/skills/threads.py

@@ -7,13 +7,13 @@ import time
 from dataclasses import dataclass, field
 from typing import TYPE_CHECKING
 
+from culture.agentirc.skill import Event, EventType, Skill
 from culture.protocol import replies
 from culture.protocol.message import Message
-from culture.server.skill import Event, EventType, Skill
 
 if TYPE_CHECKING:
-    from culture.server.channel import Channel
-    from culture.server.client import Client
+    from culture.agentirc.channel import Channel
+    from culture.agentirc.client import Client
 
 # Thread name: alphanumeric + hyphens, 1-32 chars, must start/end with alnum
 _THREAD_NAME_RE = re.compile(r"^[a-zA-Z0-9]([a-zA-Z0-9\-]{0,30}[a-zA-Z0-9])?$")
@@ -59,7 +59,7 @@ class ThreadsSkill(Skill):
         """Reload persisted threads from disk on startup."""
         if not self.server.config.data_dir:
             return
-        from culture.server.thread_store import ThreadStore
+        from culture.agentirc.thread_store import ThreadStore
 
         store = ThreadStore(self.server.config.data_dir)
         for data in store.load_all():
@@ -86,7 +86,7 @@ class ThreadsSkill(Skill):
         """Save a thread to disk if data_dir is configured."""
         if not self.server.config.data_dir:
             return
-        from culture.server.thread_store import ThreadStore
+        from culture.agentirc.thread_store import ThreadStore
 
         store = ThreadStore(self.server.config.data_dir)
         store.save(
@@ -306,7 +306,7 @@ class ThreadsSkill(Skill):
 
         Returns the prefixed text for use in event data.
         """
-        from culture.server.remote_client import RemoteClient
+        from culture.agentirc.remote_client import RemoteClient
 
         prefixed = self._format_thread_msg(thread_name, text)
         relay = Message(
@@ -330,7 +330,7 @@ class ThreadsSkill(Skill):
         text: str,
     ) -> None:
         """Find @mentions in text and send a NOTICE to each mentioned user in the channel."""
-        from culture.server.remote_client import RemoteClient
+        from culture.agentirc.remote_client import RemoteClient
 
         mentioned_nicks = re.findall(r"@(\S+)", text)
         if not mentioned_nicks:
@@ -411,7 +411,7 @@ class ThreadsSkill(Skill):
         summary: str | None,
     ) -> None:
         """Archive a thread, notify channel members, persist, and emit event."""
-        from culture.server.remote_client import RemoteClient
+        from culture.agentirc.remote_client import RemoteClient
 
         thread.archived = True
         thread.summary = summary
@@ -552,7 +552,7 @@ class ThreadsSkill(Skill):
         breakout_name: str,
     ) -> None:
         """Archive the promoted thread, notify channel, persist, and emit event."""
-        from culture.server.remote_client import RemoteClient
+        from culture.agentirc.remote_client import RemoteClient
 
         thread.archived = True
         thread.summary = f"Promoted to {breakout_name}"
@@ -659,7 +659,7 @@ class ThreadsSkill(Skill):
 
     async def _populate_breakout(self, thread: Thread, breakout, breakout_name: str) -> None:
         """Gather local participants from the thread, auto-join them, and send JOIN messages."""
-        from culture.server.remote_client import RemoteClient
+        from culture.agentirc.remote_client import RemoteClient
 
         participant_nicks = thread.participants
         participants = []
@@ -683,7 +683,7 @@ class ThreadsSkill(Skill):
 
     async def _replay_thread_history(self, thread: Thread, breakout_name: str) -> None:
         """Replay all thread messages as NOTICE to breakout channel members."""
-        from culture.server.remote_client import RemoteClient
+        from culture.agentirc.remote_client import RemoteClient
 
         breakout = self.server.channels.get(breakout_name)
         if breakout is None:

{agentirc_cli-5.0.3 → agentirc_cli-6.0.0}/culture/bots/bot.py

@@ -12,7 +12,7 @@ from culture.bots.template_engine import render_fallback, render_template
 from culture.bots.virtual_client import VirtualClient
 
 if TYPE_CHECKING:
-    from culture.server.ircd import IRCd
+    from culture.agentirc.ircd import IRCd
 
 logger = logging.getLogger(__name__)
 

{agentirc_cli-5.0.3 → agentirc_cli-6.0.0}/culture/bots/bot_manager.py

@@ -15,7 +15,7 @@ from culture.bots.config import (
 )
 
 if TYPE_CHECKING:
-    from culture.server.ircd import IRCd
+    from culture.agentirc.ircd import IRCd
 
 logger = logging.getLogger(__name__)
 

{agentirc_cli-5.0.3 → agentirc_cli-6.0.0}/culture/bots/virtual_client.py

@@ -5,12 +5,12 @@ from __future__ import annotations
 import logging
 from typing import TYPE_CHECKING
 
+from culture.agentirc.skill import Event, EventType
 from culture.protocol.message import Message
-from culture.server.skill import Event, EventType
 
 if TYPE_CHECKING:
-    from culture.server.channel import Channel
-    from culture.server.ircd import IRCd
+    from culture.agentirc.channel import Channel
+    from culture.agentirc.ircd import IRCd
 
 logger = logging.getLogger(__name__)
 
@@ -132,7 +132,7 @@ class VirtualClient:
     async def send_dm(self, target_nick: str, text: str) -> None:
         """Send a direct PRIVMSG to a specific user."""
         text = _sanitize_irc_text(text)
-        from culture.server.remote_client import RemoteClient
+        from culture.agentirc.remote_client import RemoteClient
 
         recipient = self.server.get_client(target_nick)
         if not recipient:
@@ -159,7 +159,7 @@ class VirtualClient:
         """Send NOTICE to any @mentioned users in the text."""
         import re
 
-        from culture.server.remote_client import RemoteClient
+        from culture.agentirc.remote_client import RemoteClient
 
         mentioned_nicks = re.findall(r"@(\S+)", text)
         if not mentioned_nicks:

{agentirc_cli-5.0.3 → agentirc_cli-6.0.0}/culture/cli/channel.py

@@ -291,31 +291,36 @@ def _cmd_topic(args: argparse.Namespace) -> None:
     target = args.target if args.target.startswith("#") else f"#{args.target}"
 
     if args.text is not None:
-        # Setting topic requires the daemon (must act as agent nick)
-        resp = _require_ipc("irc_topic", channel=target, topic=args.text)
-        if resp.get("ok"):
-            print(f"Topic set for {target}")
-        else:
-            print(f"Error: {resp.get('error', 'unknown error')}", file=sys.stderr)
-            sys.exit(1)
+        _topic_set(target, args.text)
     else:
-        # Reading topic — the daemon IPC handler returns results
-        # asynchronously via IRC numerics, so use IPC to fire the query
-        # and report that it was sent.
-        resp = _try_ipc("irc_topic", channel=target)
-        if resp and resp.get("ok"):
-            data = resp.get("data") or {}
-            if "topic" in data:
-                topic = data["topic"]
-                print(f"Topic for {target}: {topic}" if topic else f"No topic set for {target}")
-            else:
-                print(f"Topic query sent for {target} (result arrives asynchronously)")
-        else:
-            print(
-                f"Error: topic query requires a running agent daemon (CULTURE_NICK).",
-                file=sys.stderr,
-            )
-            sys.exit(1)
+        _topic_read(target)
+
+
+def _topic_set(target: str, text: str) -> None:
+    """Set channel topic via agent daemon."""
+    resp = _require_ipc("irc_topic", channel=target, topic=text)
+    if resp.get("ok"):
+        print(f"Topic set for {target}")
+    else:
+        print(f"Error: {resp.get('error', 'unknown error')}", file=sys.stderr)
+        sys.exit(1)
+
+
+def _topic_read(target: str) -> None:
+    """Read channel topic via agent daemon IPC."""
+    resp = _try_ipc("irc_topic", channel=target)
+    if not resp or not resp.get("ok"):
+        print(
+            "Error: topic query requires a running agent daemon (CULTURE_NICK).",
+            file=sys.stderr,
+        )
+        sys.exit(1)
+    data = resp.get("data") or {}
+    if "topic" not in data:
+        print(f"Topic query sent for {target} (result arrives asynchronously)")
+        return
+    topic = data["topic"]
+    print(f"Topic for {target}: {topic}" if topic else f"No topic set for {target}")
 
 
 def _cmd_compact(args: argparse.Namespace) -> None:

{agentirc_cli-5.0.3 → agentirc_cli-6.0.0}/culture/cli/server.py

@@ -408,8 +408,8 @@ async def _run_server(
     data_dir: str = "",
 ) -> None:
     """Run the IRC server (called in the daemon child process)."""
-    from culture.server.config import ServerConfig
-    from culture.server.ircd import IRCd
+    from culture.agentirc.config import ServerConfig
+    from culture.agentirc.ircd import IRCd
 
     config = ServerConfig(
         name=name,

{agentirc_cli-5.0.3 → agentirc_cli-6.0.0}/culture/cli/shared/mesh.py

@@ -20,7 +20,7 @@ def parse_link(value: str):
     Trust is extracted from the end if it matches a known value.
     This allows passwords containing colons.
     """
-    from culture.server.config import LinkConfig
+    from culture.agentirc.config import LinkConfig
 
     trust = "full"
     if value.endswith(":full") or value.endswith(":restricted"):
@@ -41,9 +41,9 @@ def parse_link(value: str):
 
 def resolve_links_from_mesh(mesh_config_path: str) -> list:
     """Load link configs from mesh.yaml, looking up passwords from OS keyring."""
+    from culture.agentirc.config import LinkConfig
     from culture.credentials import lookup_credential
     from culture.mesh_config import load_mesh_config
-    from culture.server.config import LinkConfig
 
     mesh = load_mesh_config(mesh_config_path)
     links = []