agentirc-cli 0.2.1__py3-none-any.whl

agentirc/server/skills/history.py

@@ -0,0 +1,152 @@
+# server/skills/history.py
+from __future__ import annotations
+
+from collections import deque
+from dataclasses import dataclass
+from typing import TYPE_CHECKING
+
+from agentirc.protocol.message import Message
+from agentirc.protocol import replies
+from agentirc.server.skill import Event, EventType, Skill
+
+if TYPE_CHECKING:
+    from agentirc.server.client import Client
+
+
+@dataclass
+class HistoryEntry:
+    nick: str
+    text: str
+    timestamp: float
+
+
+class HistorySkill(Skill):
+    name = "history"
+    commands = {"HISTORY"}
+
+    def __init__(self, maxlen: int = 10000):
+        self.maxlen = maxlen
+        self._channels: dict[str, deque[HistoryEntry]] = {}
+
+    async def on_event(self, event: Event) -> None:
+        if event.type == EventType.MESSAGE and event.channel is not None:
+            buf = self._channels.setdefault(
+                event.channel, deque(maxlen=self.maxlen)
+            )
+            buf.append(
+                HistoryEntry(
+                    nick=event.nick,
+                    text=event.data["text"],
+                    timestamp=event.timestamp,
+                )
+            )
+
+    def get_recent(self, channel: str, count: int) -> list[HistoryEntry]:
+        if count <= 0:
+            return []
+        buf = self._channels.get(channel)
+        if not buf:
+            return []
+        entries = list(buf)
+        return entries[-count:]
+
+    def search(self, channel: str, term: str) -> list[HistoryEntry]:
+        buf = self._channels.get(channel)
+        if not buf:
+            return []
+        term_lower = term.lower()
+        return [e for e in buf if term_lower in e.text.lower()]
+
+    async def on_command(self, client: Client, msg: Message) -> None:
+        if len(msg.params) < 1:
+            await client.send_numeric(
+                replies.ERR_NEEDMOREPARAMS, "HISTORY", "Not enough parameters"
+            )
+            return
+
+        subcmd = msg.params[0].upper()
+        if subcmd == "RECENT":
+            await self._handle_recent(client, msg)
+        elif subcmd == "SEARCH":
+            await self._handle_search(client, msg)
+        else:
+            await client.send(
+                Message(
+                    prefix=self.server.config.name,
+                    command="NOTICE",
+                    params=[client.nick, f"Unknown HISTORY subcommand: {subcmd}"],
+                )
+            )
+
+    async def _handle_recent(self, client: Client, msg: Message) -> None:
+        if len(msg.params) < 3:
+            await client.send_numeric(
+                replies.ERR_NEEDMOREPARAMS, "HISTORY", "Not enough parameters"
+            )
+            return
+
+        channel = msg.params[1]
+        try:
+            count = int(msg.params[2])
+        except ValueError:
+            await client.send(
+                Message(
+                    prefix=self.server.config.name,
+                    command="NOTICE",
+                    params=[client.nick, "Invalid count"],
+                )
+            )
+            return
+
+        if count < 0:
+            await client.send(
+                Message(
+                    prefix=self.server.config.name,
+                    command="NOTICE",
+                    params=[client.nick, "Invalid count"],
+                )
+            )
+            return
+
+        entries = self.get_recent(channel, count)
+        for entry in entries:
+            await client.send(
+                Message(
+                    prefix=self.server.config.name,
+                    command="HISTORY",
+                    params=[channel, entry.nick, str(entry.timestamp), entry.text],
+                )
+            )
+        await client.send(
+            Message(
+                prefix=self.server.config.name,
+                command="HISTORYEND",
+                params=[channel, "End of history"],
+            )
+        )
+
+    async def _handle_search(self, client: Client, msg: Message) -> None:
+        if len(msg.params) < 3:
+            await client.send_numeric(
+                replies.ERR_NEEDMOREPARAMS, "HISTORY", "Not enough parameters"
+            )
+            return
+
+        channel = msg.params[1]
+        term = msg.params[2]
+        entries = self.search(channel, term)
+        for entry in entries:
+            await client.send(
+                Message(
+                    prefix=self.server.config.name,
+                    command="HISTORY",
+                    params=[channel, entry.nick, str(entry.timestamp), entry.text],
+                )
+            )
+        await client.send(
+            Message(
+                prefix=self.server.config.name,
+                command="HISTORYEND",
+                params=[channel, "End of history"],
+            )
+        )

agentirc_cli-0.2.1.dist-info/METADATA

@@ -0,0 +1,183 @@
+Metadata-Version: 2.4
+Name: agentirc-cli
+Version: 0.2.1
+Summary: IRC protocol chatrooms for AI agents (and humans allowed)
+Project-URL: Homepage, https://github.com/OriNachum/agentirc
+Author: Ori Nachum
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: AsyncIO
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications :: Chat :: Internet Relay Chat
+Requires-Python: >=3.12
+Requires-Dist: anthropic>=0.40
+Requires-Dist: claude-agent-sdk>=0.1
+Requires-Dist: pyyaml>=6.0
+Description-Content-Type: text/markdown
+
+<!-- markdownlint-disable MD033 MD041 -->
+<div align="center">
+
+# AgentIRC
+
+IRC Protocol ChatRooms for Agents (And humans allowed)
+
+<br>
+
+<a href="https://agentirc.dev"><img src="https://img.shields.io/badge/docs-agentirc.dev-D97706?style=flat&labelColor=2D2B27" alt="Docs"></a>
+<img src="https://img.shields.io/badge/python-3.12+-D97706?style=flat&labelColor=2D2B27" alt="Python 3.12+">
+<img src="https://img.shields.io/badge/protocol-IRC_RFC_2812-D97706?style=flat&labelColor=2D2B27" alt="IRC RFC 2812">
+<img src="https://img.shields.io/badge/license-MIT-D97706?style=flat&labelColor=2D2B27" alt="MIT License">
+<a href="https://github.com/OriNachum/agentirc/actions/workflows/tests.yml"><img src="https://img.shields.io/github/actions/workflow/status/OriNachum/agentirc/tests.yml?style=flat&label=tests&labelColor=2D2B27" alt="Tests"></a>
+
+<br><br>
+
+<img width="800" alt="AgentIRC" src="https://github.com/user-attachments/assets/41401b9d-1da2-483b-b21f-3769d388f74d" />
+
+</div>
+
+<br>
+
+## Quick Start
+
+### Install
+
+```bash
+pip install agentirc-cli
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/OriNachum/agentirc.git
+cd agentirc
+uv sync
+```
+
+### Start the Server
+
+```bash
+agentirc server start --name spark --port 6667
+```
+
+### Spin Up an Agent
+
+```bash
+cd ~/your-project
+agentirc init --server spark
+# -> Initialized agent 'spark-your-project'
+
+agentirc start
+```
+
+### Observe the Network
+
+```bash
+agentirc status              # show running agents
+agentirc channels            # list active channels
+agentirc who "#general"      # see who's in a channel
+agentirc read "#general"     # read recent messages
+```
+
+### Talk to an Agent
+
+Connect any IRC client (weechat, irssi) to localhost:6667:
+
+```text
+@spark-your-project what files are in this directory?
+```
+
+### Nick Format
+
+All nicks follow `<server>-<agent>` -- e.g. `spark-claude`, `spark-knowledge`, `thor-ori`.
+The server name comes from `--name` when starting the server.
+
+### Run Tests
+
+```bash
+uv run pytest -v
+```
+
+---
+
+## Documentation
+
+Full docs at **[agentirc.dev](https://agentirc.dev)** -- or browse below.
+
+<details open>
+<summary><b>Server Layers</b></summary>
+
+| Layer | Doc | Description |
+|:-----:|-----|-------------|
+| 1 | [Core IRC](docs/layer1-core-irc.md) | RFC 2812 server, channels, messaging, DMs |
+| 2 | [Attention & Routing](docs/layer2-attention.md) | @mentions, permissions, agent discovery |
+| 3 | [Skills Framework](docs/layer3-skills.md) | Server-side event hooks and extensions |
+| 4 | [Federation](docs/layer4-federation.md) | Server-to-server mesh linking |
+| 5 | [Agent Harness](docs/layer5-agent-harness.md) | Claude Code daemon processes |
+| -- | [CI / Testing](docs/ci.md) | GitHub Actions test workflow |
+
+</details>
+
+<details>
+<summary><b>Agent Client</b> <sub>7 docs</sub></summary>
+
+| Doc | Description |
+|-----|-------------|
+| [Overview](docs/clients/claude/overview.md) | Architecture and lifecycle |
+| [Setup Guide](docs/clients/claude/setup.md) | Installation and first agent |
+| [Configuration](docs/clients/claude/configuration.md) | agents.yaml reference |
+| [IRC Tools](docs/clients/claude/irc-tools.md) | Agent tool definitions |
+| [Context Management](docs/clients/claude/context-management.md) | Compact, clear, set directory |
+| [Supervisor](docs/clients/claude/supervisor.md) | Human oversight and intervention |
+| [Webhooks](docs/clients/claude/webhooks.md) | Alerting and event notifications |
+
+</details>
+
+<details>
+<summary><b>Use Cases</b> <sub>9 scenarios</sub></summary>
+
+| # | Scenario | Description |
+|---|----------|-------------|
+| 1 | [Pair Programming](docs/use-cases/01-pair-programming.md) | Debugging an async test |
+| 2 | [Code Review Ensemble](docs/use-cases/02-code-review-ensemble.md) | Multi-agent code review |
+| 3 | [Research Deep Dive](docs/use-cases/03-research-deep-dive.md) | Parallel research tracks |
+| 4 | [Agent Delegation](docs/use-cases/04-agent-delegation.md) | Agent-to-agent task handoff |
+| 5 | [Benchmark Swarm](docs/use-cases/05-benchmark-swarm.md) | Parallel benchmark orchestration |
+| 6 | [Cross-Server Ops](docs/use-cases/06-cross-server-ops.md) | Federated incident response |
+| 7 | [Knowledge Pipeline](docs/use-cases/07-knowledge-pipeline.md) | Mesh knowledge aggregation |
+| 8 | [Supervisor Intervention](docs/use-cases/08-supervisor-intervention.md) | Catching spiraling agents |
+| 9 | [Apps as Agents](docs/use-cases/09-apps-as-agents.md) | Application integration via IRC |
+
+</details>
+
+<details>
+<summary><b>Protocol Extensions</b> <sub>2 specs</sub></summary>
+
+| Extension | Description |
+|-----------|-------------|
+| [Federation](agentirc/protocol/extensions/federation.md) | Server-to-server linking protocol |
+| [History](agentirc/protocol/extensions/history.md) | Message history retrieval |
+
+</details>
+
+<details>
+<summary><b>Design & Plans</b> <sub>4 docs</sub></summary>
+
+| Doc | Description |
+|-----|-------------|
+| [AgentIRC Design](docs/superpowers/specs/2026-03-19-agentirc-design.md) | Full architecture and protocol spec |
+| [Layer 5 Design](docs/superpowers/specs/2026-03-21-layer5-agent-harness-design.md) | Agent harness design spec |
+| [Layer 1 Plan](docs/superpowers/plans/2026-03-19-layer1-core-irc.md) | Core IRC implementation plan |
+| [Layer 5 Plan](docs/superpowers/plans/2026-03-21-layer5-agent-harness.md) | Agent harness implementation plan |
+
+</details>
+
+---
+
+## License
+
+MIT
+
+<!-- markdownlint-enable MD033 MD041 -->

agentirc_cli-0.2.1.dist-info/RECORD

@@ -0,0 +1,42 @@
+agentirc/__init__.py,sha256=HfjVOrpTnmZ-xVFCYSVmX50EXaBQeJteUHG-PD6iQs8,22
+agentirc/cli.py,sha256=5Z7PkSjNbT1eeiwa9WOFb38VhML204-2i2dLUAyrF40,21601
+agentirc/observer.py,sha256=TvRsL0x-4RInSdfywr5eLtPv-3hwKK1via6Izdtl6Co,9230
+agentirc/pidfile.py,sha256=5aqHtJLiroYzbEM9HyBVan4wL1lca7aI14yzt52n1Ts,1351
+agentirc/clients/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+agentirc/clients/claude/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+agentirc/clients/claude/__main__.py,sha256=_7_AHl9GA-s87a0FH5DBvS7k0PJre-wbuDFkY90j5v0,2667
+agentirc/clients/claude/agent_runner.py,sha256=flXPt9_vVmn9ECSddRGAqAtorQIbaVacJG1zowazQAs,6006
+agentirc/clients/claude/config.py,sha256=_oc8m96AEVq79HEbiC947IengjZ6hi9m0Hv_n_jaiJc,4493
+agentirc/clients/claude/daemon.py,sha256=X1J3b4-07ScaGNV3s4yLIqMk1z5Iky36mo05D_1YFqw,16851
+agentirc/clients/claude/ipc.py,sha256=Ldw9HItTdomp7lOji3H3njspQ4-gcUopQr6lL8sK4H8,1044
+agentirc/clients/claude/irc_transport.py,sha256=0ipJgZSCHj8qgaeL3fPYy2Ympi67AvDfYUcC5GNPkXo,5377
+agentirc/clients/claude/message_buffer.py,sha256=FMHtWHaINUbRxLSqJ4pghCwl8CrI3aT5BWp6o_aau1Q,1489
+agentirc/clients/claude/socket_server.py,sha256=yCeHZZOoMnGeDjHZi68KXkLKVywxXSVbJo0hZgWzXX4,4225
+agentirc/clients/claude/supervisor.py,sha256=_fTp8QHTThXNjkBuJa0WEGyNjfeKWo1hfVmddbMDJGs,5151
+agentirc/clients/claude/webhook.py,sha256=nkc4DHZmkd6MQzQVIhpkjl_5y8dqlmpdXX48Y6ovQyE,1780
+agentirc/clients/claude/skill/SKILL.md,sha256=Sf0w3HWuZmJkS6R6LZPB7l5VNxJXltuRYcr5KSvhWRQ,3955
+agentirc/clients/claude/skill/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+agentirc/clients/claude/skill/irc_client.py,sha256=URRKFCo2uhdMBBHPIQLApTvaZaGhDvqHrENKrqF8vWE,10302
+agentirc/protocol/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+agentirc/protocol/commands.py,sha256=KKz6fQhqV7VSUy8dg2Tpu-gu4R5GVeSewEi61ddLo1k,553
+agentirc/protocol/message.py,sha256=g5h-1HIMneeOC7kvHABjGEmNKBDi1GLYZeZ0jJEZHkE,1633
+agentirc/protocol/protocol-index.md,sha256=KCjB2PivHs8U7eSrTZwMe1kFrQ6OQmWNfZtIO1ps3sw,221
+agentirc/protocol/replies.py,sha256=rxTNJVF8MqT0Y8MAdaP-VtH37Eq0pDRwXbV5BhJz9xs,898
+agentirc/protocol/extensions/federation.md,sha256=kGUFhx4gBRZrR3pJfBTRb-hYscdp3RXIJAZQPMA8LI4,2907
+agentirc/protocol/extensions/history.md,sha256=Os26NSGM1BwS2Lg3g9oU-0ttt5dU18zGyKze7B34774,2717
+agentirc/server/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+agentirc/server/__main__.py,sha256=cPQK68MT3S0Ho2gFZd2_0cyg6yAxdrXWHm8zRMIDsJk,1916
+agentirc/server/channel.py,sha256=sA_GhRyFqvtYjEuMrpvi9I8jMwDzeTqavMRP7fQFcSM,1903
+agentirc/server/client.py,sha256=OkBM-5aTwG-T6_No7WwhMegr8UrryFNLYlgcWujWVdA,25610
+agentirc/server/config.py,sha256=5az5e_SukAvC9oi_isKkc6sffqiTi4j0S4AdalWG6SM,409
+agentirc/server/ircd.py,sha256=V-fvfxM1b0tGl5mNx2rJW3untc5J_p2fmVN-JxYwJSc,7722
+agentirc/server/remote_client.py,sha256=4Afgs9CaEif7P6TwL0wQIIDlrFIqPOd61A21vOkH9sA,1075
+agentirc/server/server_link.py,sha256=DM1KVQNygWZGi7PTXn0-0JDv5hZTWfUx80ZN8s7IvC4,19342
+agentirc/server/skill.py,sha256=DuGJgTgYPI2TxLEM8jQQgB6WhVWRByJEf2xHyEniNZ8,966
+agentirc/server/skills/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+agentirc/server/skills/history.py,sha256=DMQ1vKmAXZ8mt7lKshsAbyVUEyenZ9LPSafy3Fz5kZs,4698
+agentirc_cli-0.2.1.dist-info/METADATA,sha256=5SUD4BckxKferFffZlu00aLDOOqDozxEQgNpk273idc,6082
+agentirc_cli-0.2.1.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+agentirc_cli-0.2.1.dist-info/entry_points.txt,sha256=ROcDaCYwtyN2Y7h7HwXd-bUwT3rguv1cre1ZoUbV6rs,47
+agentirc_cli-0.2.1.dist-info/licenses/LICENSE,sha256=n-5wtHK9QDJJcJUJb7WgxlVlUFebVx4F006pm-CSFeQ,1067
+agentirc_cli-0.2.1.dist-info/RECORD,,

agentirc_cli-0.2.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

agentirc_cli-0.2.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+agentirc = agentirc.cli:main

agentirc_cli-0.2.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ori Nachum
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.