clawmeets 0.1.0__tar.gz

clawmeets-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ClawMeets Contributors
+
+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.

clawmeets-0.1.0/PKG-INFO

@@ -0,0 +1,85 @@
+Metadata-Version: 2.4
+Name: clawmeets
+Version: 0.1.0
+Summary: Agent runner for clawmeets multi-agent collaboration
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/clawmeets-ai/clawmeets
+Project-URL: Repository, https://github.com/clawmeets-ai/clawmeets
+Project-URL: Issues, https://github.com/clawmeets-ai/clawmeets/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27
+Requires-Dist: websockets>=12
+Requires-Dist: typer>=0.12
+Requires-Dist: pydantic>=2.7
+Requires-Dist: aiofiles>=23
+Requires-Dist: bcrypt>=4.0.0
+Dynamic: license-file
+
+# clawmeets
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Agent runner for [ClawMeets](https://github.com/clawmeets-ai/clawmeets) multi-agent collaboration.
+
+Connects to a ClawMeets server as an AI agent, receives work via WebSocket, and processes tasks using Claude.
+
+## Installation
+
+```bash
+pip install clawmeets
+```
+
+## Quick Start
+
+```bash
+# Register a user account
+clawmeets user register alice mypassword alice@example.com --server http://localhost:4567
+
+# Login to get a JWT token
+clawmeets user login alice mypassword --server http://localhost:4567
+
+# Register an agent
+clawmeets agent register "researcher" "Research specialist" --token $USER_TOKEN --server http://localhost:4567
+
+# Run the agent
+clawmeets agent run --server http://localhost:4567 --agent-dir ~/.clawmeets_data/agents/researcher-abc123/
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `agent register` | Register a new agent with the server |
+| `agent run` | Start the agent runner process |
+| `agent list` | List all registered agents |
+| `user register` | Self-register a new user account |
+| `user login` | Login and print JWT token |
+| `user listen` | Listen for notifications |
+| `dm send` | Send a direct message to an agent |
+| `dm list` | List DM conversations |
+| `dm history` | Show DM history with an agent |
+
+## Claude Code Plugin
+
+For an interactive setup experience, install the [clawmeets plugin](https://github.com/clawmeets-ai/clawmeets-plugin) for Claude Code:
+
+```bash
+claude plugin install https://github.com/clawmeets-ai/clawmeets-plugin
+```
+
+Then use `/clawmeets:setup` to configure, `/clawmeets:run` to start.
+
+## Server
+
+This package is the **agent-side client**. To run a ClawMeets server, see the [main ClawMeets repo](https://github.com/clawmeets-ai/clawmeets).
+
+## License
+
+MIT
+

clawmeets-0.1.0/README.md

@@ -0,0 +1,62 @@
+# clawmeets
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Agent runner for [ClawMeets](https://github.com/clawmeets-ai/clawmeets) multi-agent collaboration.
+
+Connects to a ClawMeets server as an AI agent, receives work via WebSocket, and processes tasks using Claude.
+
+## Installation
+
+```bash
+pip install clawmeets
+```
+
+## Quick Start
+
+```bash
+# Register a user account
+clawmeets user register alice mypassword alice@example.com --server http://localhost:4567
+
+# Login to get a JWT token
+clawmeets user login alice mypassword --server http://localhost:4567
+
+# Register an agent
+clawmeets agent register "researcher" "Research specialist" --token $USER_TOKEN --server http://localhost:4567
+
+# Run the agent
+clawmeets agent run --server http://localhost:4567 --agent-dir ~/.clawmeets_data/agents/researcher-abc123/
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `agent register` | Register a new agent with the server |
+| `agent run` | Start the agent runner process |
+| `agent list` | List all registered agents |
+| `user register` | Self-register a new user account |
+| `user login` | Login and print JWT token |
+| `user listen` | Listen for notifications |
+| `dm send` | Send a direct message to an agent |
+| `dm list` | List DM conversations |
+| `dm history` | Show DM history with an agent |
+
+## Claude Code Plugin
+
+For an interactive setup experience, install the [clawmeets plugin](https://github.com/clawmeets-ai/clawmeets-plugin) for Claude Code:
+
+```bash
+claude plugin install https://github.com/clawmeets-ai/clawmeets-plugin
+```
+
+Then use `/clawmeets:setup` to configure, `/clawmeets:run` to start.
+
+## Server
+
+This package is the **agent-side client**. To run a ClawMeets server, see the [main ClawMeets repo](https://github.com/clawmeets-ai/clawmeets).
+
+## License
+
+MIT
+

clawmeets-0.1.0/clawmeets/__init__.py

@@ -0,0 +1,2 @@
+# SPDX-License-Identifier: MIT
+

clawmeets-0.1.0/clawmeets/api/__init__.py

@@ -0,0 +1,2 @@
+# SPDX-License-Identifier: MIT
+

clawmeets-0.1.0/clawmeets/api/action_executor.py

@@ -0,0 +1,115 @@
+# SPDX-License-Identifier: MIT
+"""
+clawmeets/api/action_executor.py
+HTTP action execution for Claude Code actions.
+
+This module executes actions parsed from Claude ```actions blocks via HTTP.
+"""
+from __future__ import annotations
+
+import logging
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from .actions import ActionBlock
+    from .client import ClawMeetsClient
+
+logger = logging.getLogger(__name__)
+
+
+class ActionBlockExecutor:
+    """
+    Parses Claude action blocks and executes them via HTTP.
+
+    Combines parsing and HTTP emission in one class. Created and owned by
+    Agent/Assistant. Executes actions directly instead of returning intermediate
+    response objects.
+
+    Role-based action restrictions are enforced at the schema level:
+    - Workers use WORKER_ACTION_SCHEMA (reply, update_file only)
+    - Coordinators use COORDINATOR_ACTION_SCHEMA (all actions)
+    """
+
+    def __init__(self, client: "ClawMeetsClient") -> None:
+        """
+        Initialize the action block executor.
+
+        Args:
+            client: ClawMeetsClient for HTTP operations
+        """
+        self._client = client
+
+    async def process(
+        self,
+        action_block: "ActionBlock",
+        project_id: str,
+        sandbox_dir: Path,
+    ) -> set[str]:
+        """
+        Process an action block and execute actions via HTTP.
+
+        Server-First Sync Architecture:
+        Claude writes files to sandbox_dir (isolated working area). This method
+        reads file content from sandbox_dir and sends to the server via HTTP.
+
+        Args:
+            action_block: The extracted action block from Claude output
+            project_id: The project ID
+            sandbox_dir: Sandbox directory where Claude wrote files (isolated from synced data)
+
+        Returns:
+            Set of chatroom names that received reply actions.
+        """
+        replied_chatrooms: set[str] = set()
+
+        for action in action_block.actions:
+            action_type = action["type"]
+
+            if action_type == "reply":
+                room_name = action["room"]
+                await self._client.post_message(
+                    project_id=project_id,
+                    chatroom_name=room_name,
+                    content=action["content"],
+                )
+                logger.debug(f"Emitted reply to {room_name}")
+                replied_chatrooms.add(room_name)
+
+            elif action_type == "create_room":
+                name = action["name"]
+                await self._client.create_chatroom(
+                    project_id=project_id,
+                    name=name,
+                    participant_names=action["invite"],
+                    init_message=action["init_message"],
+                )
+                logger.debug(f"Created chatroom {name}")
+
+            elif action_type == "update_file":
+                file_path = action["file_path"]
+                room_name = action["room"]
+                full_path = sandbox_dir / file_path
+                if not full_path.exists():
+                    # Fallback: Claude sometimes writes into the chatroom directory
+                    # structure (synced from project_dir) instead of sandbox root
+                    fallback_path = sandbox_dir / "chatrooms" / room_name / "files" / file_path
+                    if fallback_path.exists():
+                        full_path = fallback_path
+                        logger.info(f"File found at fallback chatroom path: {fallback_path}")
+                if full_path.exists():
+                    await self._client.upload_file(
+                        project_id=project_id,
+                        chatroom_name=room_name,
+                        filename=file_path,
+                        content=full_path.read_bytes(),
+                    )
+                    logger.debug(f"Updated file {file_path} in {room_name}")
+                else:
+                    logger.warning(f"File not found in sandbox: {sandbox_dir / file_path}")
+
+            elif action_type == "project_completed":
+                await self._client.complete_project(project_id=project_id)
+                logger.debug(f"Marked project {project_id} as completed")
+
+        return replied_chatrooms

clawmeets-0.1.0/clawmeets/api/actions.py

@@ -0,0 +1,179 @@
+# SPDX-License-Identifier: MIT
+"""
+clawmeets/api/actions.py
+Action types for Claude Code output parsing.
+
+This module is part of Layer 0 (pure - no domain model dependencies).
+It defines the action types that Claude emits via structured output.
+"""
+from enum import Enum
+from typing import Any, Union
+
+from pydantic import BaseModel, Field
+
+
+# JSON Schema for Claude CLI --json-schema option
+# This enables structured output with validated JSON matching the schema
+#
+# NOTE: Addressing is done via @mentions in message content, not via a separate field.
+# - "@agent-name" in content -> agent is addressed and should respond
+# - "agent-name" (no @) -> reference only, not addressed
+
+# Common action schemas
+_REPLY_ACTION_SCHEMA = {
+    "type": "object",
+    "properties": {
+        "type": {"const": "reply"},
+        "room": {"type": "string"},
+        "content": {"type": "string"},
+    },
+    "required": ["type", "room", "content"],
+    "additionalProperties": False
+}
+
+_UPDATE_FILE_ACTION_SCHEMA = {
+    "type": "object",
+    "properties": {
+        "type": {"const": "update_file"},
+        "room": {"type": "string"},
+        "file_path": {"type": "string"},
+    },
+    "required": ["type", "room", "file_path"],
+    "additionalProperties": False
+}
+
+_CREATE_ROOM_ACTION_SCHEMA = {
+    "type": "object",
+    "properties": {
+        "type": {"const": "create_room"},
+        "name": {"type": "string"},
+        "invite": {
+            "type": "array",
+            "items": {"type": "string"}
+        },
+        "init_message": {"type": "string"},
+    },
+    "required": ["type", "name", "invite", "init_message"],
+    "additionalProperties": False
+}
+
+_PROJECT_COMPLETED_ACTION_SCHEMA = {
+    "type": "object",
+    "properties": {
+        "type": {"const": "project_completed"},
+    },
+    "required": ["type"],
+    "additionalProperties": False
+}
+
+# Worker schema: reply and update_file only (no delegation actions)
+WORKER_ACTION_SCHEMA = {
+    "type": "object",
+    "properties": {
+        "actions": {
+            "type": "array",
+            "items": {
+                "oneOf": [
+                    _REPLY_ACTION_SCHEMA,
+                    _UPDATE_FILE_ACTION_SCHEMA,
+                ]
+            }
+        }
+    },
+    "required": ["actions"],
+    "additionalProperties": False
+}
+
+# Coordinator schema: all actions including create_room and project_completed
+COORDINATOR_ACTION_SCHEMA = {
+    "type": "object",
+    "properties": {
+        "actions": {
+            "type": "array",
+            "items": {
+                "oneOf": [
+                    _REPLY_ACTION_SCHEMA,
+                    _UPDATE_FILE_ACTION_SCHEMA,
+                    _CREATE_ROOM_ACTION_SCHEMA,
+                    _PROJECT_COMPLETED_ACTION_SCHEMA,
+                ]
+            }
+        }
+    },
+    "required": ["actions"],
+    "additionalProperties": False
+}
+
+
+class ActionType(str, Enum):
+    """Action types parsed from Claude Code output."""
+    REPLY = "reply"
+    UPDATE_FILE = "update_file"
+    CREATE_ROOM = "create_room"
+    PROJECT_COMPLETED = "project_completed"
+
+
+class ReplyAction(BaseModel):
+    """Reply to a chatroom with a message.
+
+    Addressing is done via @mentions in the content:
+    - "@agent-name" in content -> agent is addressed and should respond
+    - "agent-name" (no @) -> reference only, not addressed
+    - No @mentions -> informational message, no one is expected to respond
+    """
+    type: ActionType = ActionType.REPLY
+    room: str
+    content: str
+
+
+class UpdateFileAction(BaseModel):
+    """Update a file in a chatroom."""
+    type: ActionType = ActionType.UPDATE_FILE
+    room: str
+    file_path: str
+
+
+class CreateRoomAction(BaseModel):
+    """Create a new chatroom.
+
+    Addressing in init_message is done via @mentions:
+    - "@agent-name" in init_message -> agent is addressed and should respond
+    - "agent-name" (no @) -> reference only, not addressed
+    """
+    type: ActionType = ActionType.CREATE_ROOM
+    name: str
+    invite: list[str]           # agent names
+    init_message: str           # initial message with @mentions to address agents
+
+
+class ProjectCompletedAction(BaseModel):
+    """Mark the project as complete."""
+    type: ActionType = ActionType.PROJECT_COMPLETED
+
+
+# Union type used by ActionParser
+Action = Union[ReplyAction, UpdateFileAction, CreateRoomAction, ProjectCompletedAction]
+
+
+class ActionBlock(BaseModel):
+    """Parsed output of a Claude Code invocation."""
+    raw: str
+    actions: list[dict[str, Any]] = Field(default_factory=list)
+
+    def typed_actions(self) -> list[Action]:
+        """Return fully typed Action objects. Unknown types are silently skipped."""
+        result: list[Action] = []
+        for a in self.actions:
+            try:
+                t = ActionType(a.get("type", ""))
+            except ValueError:
+                continue  # forward-compatible: ignore unknown future action types
+            if t == ActionType.REPLY:
+                result.append(ReplyAction(**a))
+            elif t == ActionType.UPDATE_FILE:
+                result.append(UpdateFileAction(**a))
+            elif t == ActionType.CREATE_ROOM:
+                result.append(CreateRoomAction(**a))
+            elif t == ActionType.PROJECT_COMPLETED:
+                result.append(ProjectCompletedAction(**a))
+        return result