@choonkeat/agent-chat 0.1.5 → 0.1.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +79 -0
- package/package.json +7 -7
package/README.md
ADDED
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
# Agent Chat
|
|
2
|
+
|
|
3
|
+
An MCP server that gives your AI agent a rich chat interface. Instead of reading raw tool calls in a terminal, your users get a rendered conversation with markdown, code blocks, canvas diagrams, quick reply buttons, and voice support.
|
|
4
|
+
|
|
5
|
+
This is the MCP that powers the **Agent Chat** tab in [swe-swe](https://swe-swe.netlify.app/).
|
|
6
|
+
|
|
7
|
+
<table>
|
|
8
|
+
<tr>
|
|
9
|
+
<td><strong>Agent Terminal</strong></td>
|
|
10
|
+
<td><strong>Agent Chat</strong></td>
|
|
11
|
+
</tr>
|
|
12
|
+
<tr>
|
|
13
|
+
<td><img src="www/screenshot-terminal.png" alt="Agent Terminal — raw tool calls and diffs" width="480"></td>
|
|
14
|
+
<td><img src="www/screenshot-chat.png" alt="Agent Chat — rich rendered conversation" width="480"></td>
|
|
15
|
+
</tr>
|
|
16
|
+
</table>
|
|
17
|
+
|
|
18
|
+
Same conversation, two views. The terminal shows MCP tool calls and code diffs. Agent Chat renders the same content as a rich, interactive chat.
|
|
19
|
+
|
|
20
|
+
## Features
|
|
21
|
+
|
|
22
|
+
- **Rich markdown** — messages render with full markdown, syntax-highlighted code blocks, and blockquotes
|
|
23
|
+
- **File drag & drop** — drop files into the chat to share them with the agent
|
|
24
|
+
- **Images in messages** — agents can include screenshots and images inline
|
|
25
|
+
- **Canvas drawing** — agents can draw diagrams and visualizations on an interactive canvas
|
|
26
|
+
- **Voice conversation** — speak to your agent and hear responses via text-to-speech
|
|
27
|
+
- **Quick replies** — agents can offer clickable response buttons for common actions
|
|
28
|
+
|
|
29
|
+
## How it works
|
|
30
|
+
|
|
31
|
+
Agent Chat runs as an MCP server alongside your AI agent. The agent calls tools like `send_message`, `draw`, and `check_messages` to communicate with the user through a browser-based chat UI.
|
|
32
|
+
|
|
33
|
+
```
|
|
34
|
+
Agent (Claude, etc.)
|
|
35
|
+
│
|
|
36
|
+
├─ send_message("Here's what I found...") → Chat UI shows rich message
|
|
37
|
+
├─ draw([...instructions...]) → Chat UI renders canvas diagram
|
|
38
|
+
├─ send_progress("Working on it...") → Chat UI shows progress indicator
|
|
39
|
+
└─ check_messages() ← Chat UI returns user's reply
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
## MCP Tools
|
|
43
|
+
|
|
44
|
+
| Tool | Description |
|
|
45
|
+
|------|-------------|
|
|
46
|
+
| `send_message` | Send a message and wait for user response. Supports quick reply buttons. |
|
|
47
|
+
| `send_verbal_reply` | Send a spoken reply in voice mode (text-to-speech). |
|
|
48
|
+
| `draw` | Draw a canvas diagram and wait for user response. |
|
|
49
|
+
| `send_progress` | Send a non-blocking progress update. |
|
|
50
|
+
| `send_verbal_progress` | Send a non-blocking spoken progress update. |
|
|
51
|
+
| `check_messages` | Non-blocking check for queued user messages. |
|
|
52
|
+
|
|
53
|
+
## Installation
|
|
54
|
+
|
|
55
|
+
Add as an MCP server to Claude Code:
|
|
56
|
+
|
|
57
|
+
```bash
|
|
58
|
+
claude mcp add agent-chat -- npx -y @choonkeat/agent-chat
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
Or run standalone (HTTP-only mode):
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
npx -y @choonkeat/agent-chat --no-stdio-mcp
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
The chat UI opens automatically in your browser.
|
|
68
|
+
|
|
69
|
+
### Environment variables
|
|
70
|
+
|
|
71
|
+
| Variable | Description |
|
|
72
|
+
|----------|-------------|
|
|
73
|
+
| `AGENT_CHAT_PORT` | Fixed port for the HTTP server (default: random) |
|
|
74
|
+
| `AGENT_CHAT_EVENT_LOG` | Path to a JSONL file for event persistence across restarts |
|
|
75
|
+
| `AGENT_CHAT_DISABLE` | Set to any value to disable tools and HTTP server |
|
|
76
|
+
|
|
77
|
+
## License
|
|
78
|
+
|
|
79
|
+
MIT
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@choonkeat/agent-chat",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.7",
|
|
4
4
|
"description": "A \"less intimidating\" chat UI for any agent",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -18,11 +18,11 @@
|
|
|
18
18
|
},
|
|
19
19
|
"license": "MIT",
|
|
20
20
|
"optionalDependencies": {
|
|
21
|
-
"@choonkeat/agent-chat-linux-x64": "0.1.
|
|
22
|
-
"@choonkeat/agent-chat-linux-arm64": "0.1.
|
|
23
|
-
"@choonkeat/agent-chat-darwin-x64": "0.1.
|
|
24
|
-
"@choonkeat/agent-chat-darwin-arm64": "0.1.
|
|
25
|
-
"@choonkeat/agent-chat-win32-x64": "0.1.
|
|
26
|
-
"@choonkeat/agent-chat-win32-arm64": "0.1.
|
|
21
|
+
"@choonkeat/agent-chat-linux-x64": "0.1.7",
|
|
22
|
+
"@choonkeat/agent-chat-linux-arm64": "0.1.7",
|
|
23
|
+
"@choonkeat/agent-chat-darwin-x64": "0.1.7",
|
|
24
|
+
"@choonkeat/agent-chat-darwin-arm64": "0.1.7",
|
|
25
|
+
"@choonkeat/agent-chat-win32-x64": "0.1.7",
|
|
26
|
+
"@choonkeat/agent-chat-win32-arm64": "0.1.7"
|
|
27
27
|
}
|
|
28
28
|
}
|