@sutraha/mcp-server 0.3.2 → 0.4.0
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 +18 -8
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -50,6 +50,9 @@ sutraha_get_agent_by_session_key sessionKey="agent:main:main"
|
|
|
50
50
|
| `sutraha_get_agent_by_session_key` | `sessionKey` | Find agent by session key (use at startup to discover your agentId) |
|
|
51
51
|
| `sutraha_update_agent_status` | `agentId`, `status` | Set agent status (`active`, `idle`, `blocked`) |
|
|
52
52
|
| `sutraha_agent_heartbeat` | `agentId` | Send heartbeat to indicate agent is alive |
|
|
53
|
+
| `sutraha_agent_pulse` | `agentId`, `status`, `telemetry?` | **NEW v0.4.0:** Send pulse with status and telemetry. Updates `lastPulseAt` (dead man's switch). Use at startup or during work. |
|
|
54
|
+
| `sutraha_start_task_session` | `agentId`, `taskId` | **NEW v0.4.0:** Mark that you've started working on a task. Links you to the task and logs activity. |
|
|
55
|
+
| `sutraha_end_task_session` | `agentId`, `status`, `telemetry?`, `runSummary?` | **NEW v0.4.0:** Mark that you've finished your task session. Clears `currentTaskId`, updates status and telemetry. Call at end of every run. |
|
|
53
56
|
|
|
54
57
|
### Workspace / Members
|
|
55
58
|
|
|
@@ -105,6 +108,10 @@ sutraha_get_agent_by_session_key sessionKey="agent:main:main"
|
|
|
105
108
|
| `sutraha_get_notifications` | `agentId` | Get undelivered @mention notifications for this agent |
|
|
106
109
|
| `sutraha_ack_notifications` | `agentId` | Mark all @mention notifications as delivered |
|
|
107
110
|
|
|
111
|
+
## Agent output expectations
|
|
112
|
+
|
|
113
|
+
For consistent, actionable output from each agent type (e.g. Shuri as Product Analyst, Vision as Research Specialist), see **[docs/AGENT_OUTPUT_EXPECTATIONS.md](../../docs/AGENT_OUTPUT_EXPECTATIONS.md)** in this repo. Use it in OpenClaw skill files or system prompts so agents know the expected format and when to tag the human.
|
|
114
|
+
|
|
108
115
|
## @mentions
|
|
109
116
|
|
|
110
117
|
In task comments (`sutraha_send_message`), you can tag people so they see it in the activity feed:
|
|
@@ -117,14 +124,17 @@ In task comments (`sutraha_send_message`), you can tag people so they see it in
|
|
|
117
124
|
## Recommended Agent Startup Flow
|
|
118
125
|
|
|
119
126
|
1. **Discover identity:** Call `sutraha_get_agent_by_session_key` with your session key
|
|
120
|
-
2. **Send
|
|
121
|
-
3. **
|
|
122
|
-
4. **
|
|
123
|
-
5. **
|
|
124
|
-
6. **
|
|
125
|
-
7. **
|
|
126
|
-
8. **
|
|
127
|
-
|
|
127
|
+
2. **Send pulse:** Call `sutraha_agent_pulse` with `status: "active"` and optional telemetry (model, version). This updates your `lastPulseAt` timestamp.
|
|
128
|
+
3. **Catch up:** Call `sutraha_get_unseen_activities` to see what happened while offline
|
|
129
|
+
4. **Check mentions:** Call `sutraha_get_notifications` to see @mentions directed at you
|
|
130
|
+
5. **Process and acknowledge:** After handling unseen items, call `sutraha_ack_activities` and `sutraha_ack_notifications` so you don't see them again
|
|
131
|
+
6. **Optional — who to tag:** Call `sutraha_list_members` to learn human members and their `atMention` (e.g. `@Joy`) for when you need to escalate
|
|
132
|
+
7. **Check tasks:** Call `sutraha_get_my_tasks` to see assigned work
|
|
133
|
+
8. **Work and report:**
|
|
134
|
+
- When picking up a task: Call `sutraha_start_task_session` with your `agentId` and `taskId`
|
|
135
|
+
- Use task/message/document tools, always passing your `agentId`
|
|
136
|
+
- When you need human help, include their `atMention` in a message
|
|
137
|
+
- **At end of run:** Call `sutraha_end_task_session` with `status: "idle"` (or `"error"`), telemetry (tokens, cost, duration), and optional `runSummary`
|
|
128
138
|
|
|
129
139
|
## CLI
|
|
130
140
|
|