agentirc-cli 7.1.5__tar.gz → 7.2.1__tar.gz

{agentirc_cli-7.1.5 → agentirc_cli-7.2.1}/CHANGELOG.md

@@ -4,6 +4,24 @@ All notable changes to this project will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/).
 
+## [7.2.1] - 2026-04-21
+
+### Changed
+
+- `_data/sites.yml`: agex URL → `https://culture.dev/agex/` (was `https://agex.culture.dev`)
+- `_config.culture.yml` + `_config.agentirc.yml`: aux_links and footer_content agex links retargeted to `https://culture.dev/agex/`
+
+## [7.2.0] - 2026-04-18
+
+### Added
+
+- Console: full CommonMark markdown rendering in chat panel — bold/italic/inline code/strikethrough, OSC 8 hyperlinks, fenced code blocks with syntax highlighting, headings, lists, blockquotes, and tables (#233)
+- Console: docs/reference/console.md reference page covering chat-panel markdown rendering
+
+### Changed
+
+- Console: ChatPanel.add_message now writes a header line ([ts] icon nick:) followed by a Rich Markdown body, instead of a single Rich-markup string — this also closes a latent footgun where bracketed text in agent messages could be reinterpreted as Rich markup
+
 ## [7.1.5] - 2026-04-18
 
 ### Added

{agentirc_cli-7.1.5 → agentirc_cli-7.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentirc-cli
-Version: 7.1.5
+Version: 7.2.1
 Summary: Legacy alias for culture — install culture instead
 Project-URL: Homepage, https://github.com/OriNachum/culture
 Author: Ori Nachum

{agentirc_cli-7.1.5 → agentirc_cli-7.2.1}/_config.agentirc.yml

@@ -34,6 +34,8 @@ defaults:
 aux_links:
   "Culture":
     - "https://culture.dev"
+  "agex":
+    - "https://culture.dev/agex/"
   "GitHub":
     - "https://github.com/OriNachum/culture"
 
@@ -42,4 +44,5 @@ aux_links_new_tab: true
 footer_content: >-
   AgentIRC — the runtime layer at the heart of
   <a href="https://culture.dev">Culture</a>.
+  Agent execution via <a href="https://culture.dev/agex/">agex</a>.
   Source on <a href="https://github.com/OriNachum/culture">GitHub</a>.

{agentirc_cli-7.1.5 → agentirc_cli-7.2.1}/_config.culture.yml

@@ -34,6 +34,8 @@ defaults:
 aux_links:
   "AgentIRC":
     - "https://agentirc.dev"
+  "agex":
+    - "https://culture.dev/agex/"
   "GitHub":
     - "https://github.com/OriNachum/culture"
 
@@ -42,4 +44,5 @@ aux_links_new_tab: true
 footer_content: >-
   Culture — human-agent collaboration built around
   <a href="https://agentirc.dev">AgentIRC</a>.
+  Agent execution via <a href="https://culture.dev/agex/">agex</a>.
   Source on <a href="https://github.com/OriNachum/culture">GitHub</a>.

{agentirc_cli-7.1.5 → agentirc_cli-7.2.1}/_data/sites.yml

@@ -1,2 +1,3 @@
 agentirc: https://agentirc.dev
+agex: https://culture.dev/agex/
 culture: https://culture.dev

{agentirc_cli-7.1.5 → agentirc_cli-7.2.1}/_includes/head_custom.html

@@ -2,7 +2,9 @@
 <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 }}">
 {% if site.build_site == "culture" %}
-<link rel="related" href="https://agentirc.dev" title="AgentIRC">
+<link rel="related" href="{{ site.data.sites.agentirc }}" title="AgentIRC">
+<link rel="related" href="{{ site.data.sites.agex }}" title="agex">
 {% elsif site.build_site == "agentirc" %}
-<link rel="related" href="https://culture.dev" title="Culture">
+<link rel="related" href="{{ site.data.sites.culture }}" title="Culture">
+<link rel="related" href="{{ site.data.sites.agex }}" title="agex">
 {% endif %}

{agentirc_cli-7.1.5 → agentirc_cli-7.2.1}/culture/console/app.py

@@ -216,7 +216,7 @@ class ConsoleApp(App):
                 self._handle_agent_management(cmd)
             elif cmd.type == CommandType.UNKNOWN:
                 chat: ChatPanel = self.query_one(ChatPanel)
-                chat.add_message(time.time(), "", "system", f"[red]Unknown command: {cmd.text}[/]")
+                chat.add_system_message(f"[red]Unknown command: {cmd.text}[/]")
         except ConsoleConnectionLost:
             self._notify_connection_lost()
 
@@ -226,11 +226,8 @@ class ConsoleApp(App):
             return
         self._connection_lost_notified = True
         chat: ChatPanel = self.query_one(ChatPanel)
-        chat.add_message(
-            time.time(),
-            "",
-            "system",
-            "[red]Connection to server lost. Restart the console to reconnect.[/]",
+        chat.add_system_message(
+            "[red]Connection to server lost. Restart the console to reconnect.[/]"
         )
 
     # ------------------------------------------------------------------
@@ -242,9 +239,7 @@ class ConsoleApp(App):
         if not cmd.text:
             return
         if not self._current_channel:
-            chat.add_message(
-                time.time(), "", "system", "[red]Not in a channel — use /join #channel[/]"
-            )
+            chat.add_system_message("[red]Not in a channel — use /join #channel[/]")
             return
         await self._client.send_privmsg(self._current_channel, cmd.text)
         chat.add_message(time.time(), "", self._client.nick, cmd.text)
@@ -252,19 +247,19 @@ class ConsoleApp(App):
     async def _handle_join(self, cmd) -> None:  # noqa: ANN001
         chat: ChatPanel = self.query_one(ChatPanel)
         if not cmd.args:
-            chat.add_message(time.time(), "", "system", "[red]Usage: /join #channel[/]")
+            chat.add_system_message("[red]Usage: /join #channel[/]")
             return
         channel = cmd.args[0]
         await self._client.join(channel)
         self._sync_sidebar()
         await self._switch_to_channel(channel)
-        chat.add_message(time.time(), "", "system", f"Joined [bold]{channel}[/]")
+        chat.add_system_message(f"Joined [bold]{channel}[/]")
 
     async def _handle_part(self, cmd) -> None:  # noqa: ANN001
         chat: ChatPanel = self.query_one(ChatPanel)
         channel = cmd.args[0] if cmd.args else self._current_channel
         if not channel:
-            chat.add_message(time.time(), "", "system", "[red]Not in a channel[/]")
+            chat.add_system_message("[red]Not in a channel[/]")
             return
         await self._client.part(channel)
         self._sync_sidebar()
@@ -272,7 +267,7 @@ class ConsoleApp(App):
             remaining = sorted(self._client.joined_channels)
             self._current_channel = remaining[0] if remaining else ""
             chat.set_channel(self._current_channel)
-        chat.add_message(time.time(), "", "system", f"Parted [bold]{channel}[/]")
+        chat.add_system_message(f"Parted [bold]{channel}[/]")
 
     async def _handle_channels(self, cmd) -> None:  # noqa: ANN001
         chat: ChatPanel = self.query_one(ChatPanel)
@@ -288,9 +283,7 @@ class ConsoleApp(App):
         chat: ChatPanel = self.query_one(ChatPanel)
         target = cmd.args[0] if cmd.args else self._current_channel
         if not target:
-            chat.add_message(
-                time.time(), "", "system", "[red]Usage: /who #channel or /who <nick>[/]"
-            )
+            chat.add_system_message("[red]Usage: /who #channel or /who <nick>[/]")
             return
         entries = await self._client.who(target)
         lines = [f"[bold $warning]WHO {target}[/]", ""]
@@ -307,7 +300,7 @@ class ConsoleApp(App):
         chat: ChatPanel = self.query_one(ChatPanel)
         channel = cmd.args[0] if cmd.args else self._current_channel
         if not channel:
-            chat.add_message(time.time(), "", "system", "[red]Usage: /read #channel[/]")
+            chat.add_system_message("[red]Usage: /read #channel[/]")
             return
         limit = 50
         for i, arg in enumerate(cmd.args[1:], start=1):
@@ -326,17 +319,17 @@ class ConsoleApp(App):
                 ts = time.time()
             chat.add_message(ts, "", e.get("nick", ""), e.get("text", ""))
         if not entries:
-            chat.add_message(time.time(), "", "system", f"[dim]No history for {channel}[/]")
+            chat.add_system_message(f"[dim]No history for {channel}[/]")
 
     async def _handle_send(self, cmd) -> None:  # noqa: ANN001
         chat: ChatPanel = self.query_one(ChatPanel)
         if len(cmd.args) < 1:
-            chat.add_message(time.time(), "", "system", "[red]Usage: /send <target> <text>[/]")
+            chat.add_system_message("[red]Usage: /send <target> <text>[/]")
             return
         target = cmd.args[0]
         text = cmd.text
         if not text:
-            chat.add_message(time.time(), "", "system", "[red]No message text provided[/]")
+            chat.add_system_message("[red]No message text provided[/]")
             return
         await self._client.send_privmsg(target, text)
         chat.add_message(time.time(), "", self._client.nick, f"→ {target}: {text}")
@@ -354,41 +347,38 @@ class ConsoleApp(App):
     async def _handle_icon(self, cmd) -> None:  # noqa: ANN001
         chat: ChatPanel = self.query_one(ChatPanel)
         if not cmd.args:
-            chat.add_message(time.time(), "", "system", "[red]Usage: /icon <emoji>[/]")
+            chat.add_system_message("[red]Usage: /icon <emoji>[/]")
             return
         icon = cmd.args[-1]
         await self._client.send_raw(f"ICON {icon}")
-        chat.add_message(time.time(), "", "system", f"Icon set to {icon}")
+        chat.add_system_message(f"Icon set to {icon}")
 
     async def _handle_topic(self, cmd) -> None:  # noqa: ANN001
         chat: ChatPanel = self.query_one(ChatPanel)
         channel = cmd.args[0] if cmd.args else self._current_channel
         if not channel or not cmd.text:
-            chat.add_message(time.time(), "", "system", "[red]Usage: /topic #channel <text>[/]")
+            chat.add_system_message("[red]Usage: /topic #channel <text>[/]")
             return
         await self._client.send_raw(f"TOPIC {channel} :{cmd.text}")
 
     async def _handle_kick(self, cmd) -> None:  # noqa: ANN001
         chat: ChatPanel = self.query_one(ChatPanel)
         if len(cmd.args) < 2:
-            chat.add_message(time.time(), "", "system", "[red]Usage: /kick #channel <nick>[/]")
+            chat.add_system_message("[red]Usage: /kick #channel <nick>[/]")
             return
         await self._client.send_raw(f"KICK {cmd.args[0]} {cmd.args[1]}")
 
     async def _handle_invite(self, cmd) -> None:  # noqa: ANN001
         chat: ChatPanel = self.query_one(ChatPanel)
         if len(cmd.args) < 2:
-            chat.add_message(time.time(), "", "system", "[red]Usage: /invite <nick> #channel[/]")
+            chat.add_system_message("[red]Usage: /invite <nick> #channel[/]")
             return
         await self._client.send_raw(f"INVITE {cmd.args[0]} {cmd.args[1]}")
 
     def _handle_agent_management(self, cmd) -> None:  # noqa: ANN001
         chat: ChatPanel = self.query_one(ChatPanel)
         verb = cmd.type.name.lower()
-        chat.add_message(
-            time.time(),
-            "",
-            "system",
+        chat.add_system_message(
             f"[yellow]Agent management ({verb}) requires the CLI: "
             f"[bold]culture {verb} <agent>[/][/]",
         )
@@ -396,10 +386,7 @@ class ConsoleApp(App):
     def _handle_server(self, cmd) -> None:  # noqa: ANN001
         chat: ChatPanel = self.query_one(ChatPanel)
         target = cmd.args[0] if cmd.args else ""
-        chat.add_message(
-            time.time(),
-            "",
-            "system",
+        chat.add_system_message(
             f"[yellow]To switch servers, restart the console: "
             f"[bold]culture console {target}[/][/]",
         )
@@ -724,7 +711,7 @@ class ConsoleApp(App):
                 ts = time.time()
             chat.add_message(ts, "", e.get("nick", ""), e.get("text", ""))
         if not entries:
-            chat.add_message(time.time(), "", "system", f"[dim]No history for {channel}[/]")
+            chat.add_system_message(f"[dim]No history for {channel}[/]")
 
     def _sync_sidebar(self) -> None:
         """Sync the sidebar channel list from the client's joined_channels."""

{agentirc_cli-7.1.5 → agentirc_cli-7.2.1}/culture/console/widgets/chat.py

@@ -2,8 +2,11 @@
 
 from __future__ import annotations
 
+import time
 from datetime import datetime
 
+from rich.markdown import Markdown
+from rich.text import Text
 from textual.app import ComposeResult
 from textual.binding import Binding
 from textual.containers import Vertical
@@ -12,6 +15,36 @@ from textual.widget import Widget
 from textual.widgets import Input, RichLog, Static
 
 
+def build_message_header(timestamp: float, icon: str, nick: str) -> Text:
+    """Return the ``[ts] icon nick:`` header rendered as a Rich ``Text``.
+
+    Pulled out of ``ChatPanel.add_message`` so it can be unit-tested without
+    a running Textual app. Returns a ``Text`` (not a Rich markup string) so
+    that any ``[stuff]`` substrings inside ``nick`` are rendered verbatim.
+    """
+    ts = datetime.fromtimestamp(timestamp).strftime("%H:%M")
+    header = Text()
+    header.append(ts, style="dim")
+    header.append(" ")
+    if icon:
+        header.append(f"{icon} ")
+    header.append(nick, style="bold")
+    header.append(":")
+    return header
+
+
+def build_system_message_line(timestamp: float, text: str) -> str:
+    """Return the Rich-markup line ``ChatPanel.add_system_message`` writes.
+
+    Pulled out so the formatting can be unit-tested directly. Returns a
+    Rich-markup *string* — the caller is expected to pass it to
+    ``RichLog.write`` so Rich parses ``[red]…[/]`` / ``[bold]…[/]`` tags
+    inside ``text`` as styling.
+    """
+    ts = datetime.fromtimestamp(timestamp).strftime("%H:%M")
+    return f"[dim]{ts}[/] [bold]system[/] {text}"
+
+
 class ChatInput(Input):
     """Input with Alt+Arrow word-jump and Alt+Backspace word-delete."""
 
@@ -119,7 +152,17 @@ class ChatPanel(Widget):
     # ------------------------------------------------------------------
 
     def add_message(self, timestamp: float, icon: str, nick: str, text: str) -> None:
-        """Append a formatted message to the chat log.
+        """Append a chat message rendered as CommonMark markdown.
+
+        Use this for **untrusted** content from IRC (other users, agents,
+        history fetches). The body is parsed as CommonMark and rendered
+        with the matching Rich elements; bracketed substrings such as
+        ``[bold]X[/]`` are shown verbatim because the body is passed as a
+        renderable, not a markup string.
+
+        For **trusted** internal status / error messages where you want to
+        control Rich-markup styling (e.g. ``[red]error[/]``), use
+        :py:meth:`add_system_message` instead.
 
         Parameters
         ----------
@@ -130,13 +173,27 @@ class ChatPanel(Widget):
         nick:
             Sender nick.
         text:
-            Message body.
+            Message body (rendered as markdown).
+        """
+        log: RichLog = self.query_one(self._CHAT_LOG_ID, RichLog)
+        log.write(build_message_header(timestamp, icon, nick))
+        log.write(Markdown(text))
+
+    def add_system_message(self, text: str) -> None:
+        """Append a trusted system / status line interpreted as Rich markup.
+
+        Counterpart to :py:meth:`add_message`. The body is written as a
+        Rich-markup string, so callers can use tags like ``[red]…[/]`` and
+        ``[bold]…[/]`` to style usage hints, error notices, and join/part
+        notifications. The header is ``[ts] system``; the timestamp uses
+        ``time.time()``.
+
+        Do **not** pass IRC-sourced or otherwise untrusted text through
+        this method — markup tags inside that text would be parsed as
+        styling. Use :py:meth:`add_message` for that.
         """
         log: RichLog = self.query_one(self._CHAT_LOG_ID, RichLog)
-        ts = datetime.fromtimestamp(timestamp).strftime("%H:%M")
-        icon_str = icon if icon else ""
-        line = f"[dim]{ts}[/] {icon_str}[bold]{nick}[/] {text}"
-        log.write(line)
+        log.write(build_system_message_line(time.time(), text))
 
     def set_channel(self, channel: str) -> None:
         """Update the header and input placeholder for ``channel``."""

agentirc_cli-7.2.1/docs/reference/console.md

@@ -0,0 +1,90 @@
+---
+title: "Console"
+parent: "Reference"
+nav_order: 6
+sites: [agentirc, culture]
+description: The Culture console TUI — chat panel rendering, markdown support.
+permalink: /reference/console/
+---
+
+# Console TUI
+
+The Culture console is a Textual TUI (`culture console <server>`) that
+connects to an AgentIRC server as a regular IRC client and surfaces channel
+chat, an entity sidebar, and a context-sensitive info panel.
+
+## Markdown rendering in the chat panel
+
+Every chat message is rendered as a two-part block in the message log:
+
+```text
+12:05 🤖 thor-claude:
+  here's the snippet:
+
+  ┌─────────────────────┐
+  │ def f():            │
+  │     return 1        │
+  └─────────────────────┘
+```
+
+The first line is `[timestamp] [icon] <nick>:`. The body below it is parsed
+as **CommonMark** by `rich.markdown.Markdown` and rendered with the
+appropriate Rich elements.
+
+### What's rendered
+
+| Markdown                          | Result                                  |
+|-----------------------------------|-----------------------------------------|
+| `**bold**`                        | bold text                               |
+| `*italic*`                        | italic text                             |
+| `` `inline code` ``               | inline code (monospace, distinct style) |
+| `~~strike~~`                      | strikethrough                           |
+| `[label](https://example.com)`    | OSC 8 hyperlink                         |
+| `# Heading` … `###### Heading`    | ATX headings                            |
+| ` ```language\n…\n``` `           | fenced code block, syntax-highlighted   |
+| `- item` / `1. item`              | bullet / ordered list                   |
+| `> quote`                         | blockquote                              |
+| `\| col \| col \|` rows           | table                                   |
+
+Code fences with a language tag (`` ```python ``, `` ```rust ``, etc.) are
+syntax-highlighted via Pygments. Untagged fences render as plain code.
+
+### Links and OSC 8 support
+
+`[label](url)` produces an OSC 8 hyperlink. Modern terminals
+(iTerm2, Kitty, WezTerm, recent gnome-terminal/VTE, Alacritty 0.13+, recent
+Windows Terminal) render the label as clickable. Older terminals show the
+label as plain styled text and ignore the URL.
+
+### Layout is always block
+
+A short one-liner like `hey` still renders as `[ts] icon nick:` followed by
+the rendered body line below. This keeps a single, predictable rendering
+path — there is no inline-vs-block discrimination to surprise you.
+
+### Escaping
+
+Use a leading backslash to keep markdown punctuation literal:
+
+| Input          | Renders as |
+|----------------|------------|
+| `\*sigh\*`     | `*sigh*`   |
+| `\# 1`         | `# 1`      |
+| `\`code\``     | `` `code` `` |
+
+### Rich-markup safety
+
+Strings that look like Rich markup — for example `[bold]X[/]` typed into a
+message — are **not** reinterpreted. The message body is passed to the chat
+log as a renderable, not a markup string, so brackets stay literal.
+
+### What this does not change
+
+* IRC channel names still use the conventional `#name` form. ATX headings
+  require `#` followed by a space, so `#general` (no space) cannot collide
+  with a heading.
+* `set_content()` (used by overview / status views) is not affected — those
+  panels are built from pre-formatted Rich markup strings constructed by
+  code, not user/agent text.
+* Streaming/incremental rendering of partial messages is out of scope; each
+  IRC `PRIVMSG` is rendered when it arrives.

{agentirc_cli-7.1.5 → agentirc_cli-7.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agentirc-cli"
-version = "7.1.5"
+version = "7.2.1"
 description = "Legacy alias for culture — install culture instead"
 readme = "README.md"
 license = "MIT"