@hasna/conversations 0.0.3 → 0.0.4

package/README.md

@@ -31,10 +31,10 @@ npx @hasna/conversations
 
 ```bash
 # Basic message
-convo send --to claude-code "Hello from codex"
+conversations send --to claude-code "Hello from codex"
 
 # With context
-convo send --to claude-code "Check this branch" \
+conversations send --to claude-code "Check this branch" \
   --from codex \
   --priority high \
   --working-dir /path/to/project \
@@ -42,40 +42,40 @@ convo send --to claude-code "Check this branch" \
   --branch feature/auth
 
 # With metadata
-convo send --to gemini "Deploy ready" --metadata '{"env":"staging"}'
+conversations send --to gemini "Deploy ready" --metadata '{"env":"staging"}'
 ```
 
 ### Read Messages
 
 ```bash
 # Read all messages for an agent
-convo read --to codex
+conversations read --to codex
 
 # Unread only, as JSON
-convo read --to codex --unread --json
+conversations read --to codex --unread --json
 
 # Filter by session
-convo read --session alice-bob-abc123
+conversations read --session alice-bob-abc123
 
 # Read and mark as read
-convo read --to codex --unread --mark-read
+conversations read --to codex --unread --mark-read
 ```
 
 ### Sessions
 
 ```bash
 # List all sessions
-convo sessions
+conversations sessions
 
 # Sessions for a specific agent
-convo sessions --agent claude-code --json
+conversations sessions --agent claude-code --json
 ```
 
 ### Reply
 
 ```bash
 # Reply to a message (auto-resolves session and recipient)
-convo reply --to 42 "Got it, working on it now"
+conversations reply --to 42 "Got it, working on it now"
 ```
 
 ### Channels
@@ -84,44 +84,44 @@ Channels are broadcast spaces — any agent can post, all members can read.
 
 ```bash
 # Create a channel
-convo channel create deployments --description "Deployment notifications"
+conversations channel create deployments --description "Deployment notifications"
 
 # List channels
-convo channel list
+conversations channel list
 
 # Join a channel
-convo channel join deployments --from codex
+conversations channel join deployments --from codex
 
 # Send to a channel
-convo channel send deployments "v1.2 deployed to staging" --from ops
+conversations channel send deployments "v1.2 deployed to staging" --from ops
 
 # Read channel messages
-convo channel read deployments
+conversations channel read deployments
 
 # Leave a channel
-convo channel leave deployments --from codex
+conversations channel leave deployments --from codex
 
 # List members
-convo channel members deployments
+conversations channel members deployments
 ```
 
 ### Mark Read
 
 ```bash
 # Mark specific messages
-convo mark-read 1 2 3 --agent codex
+conversations mark-read 1 2 3 --agent codex
 
 # Mark entire session
-convo mark-read --session abc123 --agent codex
+conversations mark-read --session abc123 --agent codex
 
 # Mark entire channel
-convo mark-read --channel deployments --agent codex
+conversations mark-read --channel deployments --agent codex
 ```
 
 ### Status
 
 ```bash
-convo status
+conversations status
 # Conversations Status
 #   DB Path:    ~/.conversations/messages.db
 #   Messages:   47
@@ -132,7 +132,7 @@ convo status
 ### Interactive TUI
 
 ```bash
-convo
+conversations
 ```
 
 Arrow keys to navigate sessions, Enter to open, `n` for new conversation, `q` to quit, Esc to go back.
@@ -142,7 +142,7 @@ Arrow keys to navigate sessions, Enter to open, `n` for new conversation, `q` to
 For native AI agent integration via the Model Context Protocol:
 
 ```bash
-convo mcp
+conversations mcp
 ```
 
 ### Agent Configuration
@@ -222,20 +222,20 @@ const channelMsgs = readMessages({ channel: "deploys" });
 ## Architecture
 
 ```
-┌─────────────┐    ┌──────────────┐    ┌─────────────┐
-│  Ink TUI    │    │  Headless    │    │  MCP Server  │
-│  `convo`    │    │  `convo send`│    │  `convo mcp` │
-└──────┬──────┘    └──────┬───────┘    └──────┬───────┘
-       │                  │                   │
-       └──────────┬───────┴───────────────────┘
-                  │
-          ┌───────▼────────┐
-          │   Core Library  │
-          │  SQLite WAL     │
-          │  200ms polling  │
-          └────────────────┘
-                  │
-          ~/.conversations/messages.db
+┌──────────────────┐  ┌─────────────────────┐  ┌──────────────────────┐
+│     Ink TUI      │  │      Headless       │  │     MCP Server       │
+│ `conversations`  │  │ `conversations send`│  │ `conversations mcp`  │
+└────────┬─────────┘  └──────────┬──────────┘  └──────────┬───────────┘
+         │                       │                        │
+         └───────────┬───────────┴────────────────────────┘
+                     │
+             ┌───────▼────────┐
+             │  Core Library   │
+             │  SQLite WAL     │
+             │  200ms polling  │
+             └────────────────┘
+                     │
+             ~/.conversations/messages.db
 ```
 
 - **SQLite WAL mode** for concurrent read/write across processes

package/bin/index.js

@@ -31003,7 +31003,7 @@ var init_mcp2 = __esm(() => {
   init_channels();
   server = new McpServer({
     name: "conversations",
-    version: "0.0.3"
+    version: "0.0.4"
   });
   server.registerTool("send_message", {
     title: "Send Message",
@@ -32106,7 +32106,7 @@ function App({ agent }) {
 
 // src/cli/index.tsx
 var program2 = new Command;
-program2.name("convo").description("Real-time CLI messaging for AI agents").version("0.0.3");
+program2.name("conversations").description("Real-time CLI messaging for AI agents").version("0.0.4");
 program2.command("send").description("Send a message to an agent").argument("<message>", "Message content").requiredOption("--to <agent>", "Recipient agent ID").option("--from <agent>", "Sender agent ID").option("--session <id>", "Session ID (auto-generated if omitted)").option("--priority <level>", "Priority: low, normal, high, urgent", "normal").option("--working-dir <path>", "Working directory context").option("--repository <repo>", "Repository context").option("--branch <branch>", "Branch context").option("--metadata <json>", "JSON metadata string").option("--json", "Output as JSON").action((message, opts) => {
   const from = resolveIdentity(opts.from);
   const metadata = opts.metadata ? JSON.parse(opts.metadata) : undefined;

package/bin/mcp.js

@@ -28537,7 +28537,7 @@ function resolveIdentity(explicit) {
 // src/mcp/index.ts
 var server = new McpServer({
   name: "conversations",
-  version: "0.0.3"
+  version: "0.0.4"
 });
 server.registerTool("send_message", {
   title: "Send Message",

package/dist/index.d.ts

@@ -2,12 +2,12 @@
  * @hasna/conversations - Real-time CLI messaging for AI agents
  *
  * Send and receive messages between AI agents on the same machine:
- *   convo send --to claude-code "hello from codex"
- *   convo read --to codex --json
- *   convo channel send deployments "v1.2 deployed"
+ *   conversations send --to claude-code "hello from codex"
+ *   conversations read --to codex --json
+ *   conversations channel send deployments "v1.2 deployed"
  *
  * Or use the interactive TUI:
- *   convo
+ *   conversations
  */
 export { sendMessage, readMessages, markRead, markSessionRead, markChannelRead, getMessageById, } from "./lib/messages.js";
 export { listSessions, getSession, } from "./lib/sessions.js";

package/dist/mcp/index.d.ts

@@ -4,7 +4,7 @@
  * Exposes tools for sending, reading, and managing messages and channels between agents.
  *
  * Usage:
- *   convo mcp          # Start MCP server on stdio
- *   convo-mcp          # Direct binary
+ *   conversations mcp          # Start MCP server on stdio
+ *   conversations-mcp          # Direct binary
  */
 export declare function startMcpServer(): Promise<void>;

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@hasna/conversations",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "Real-time CLI messaging for AI agents",
   "type": "module",
   "bin": {
-    "convo": "bin/index.js",
-    "convo-mcp": "bin/mcp.js"
+    "conversations": "bin/index.js",
+    "conversations-mcp": "bin/mcp.js"
   },
   "exports": {
     ".": {