agent-rooms 0.10.0 → 0.11.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.
@@ -91,7 +91,10 @@ call it after you reply / finish.
91
91
  - `parent_id` — message id to thread your reply under.
92
92
  - `idempotency_key` — stable key making a retried post safe (no dup).
93
93
  Returns the created message envelope (with `seq` and `id`). The only way a reply
94
- reaches the room.
94
+ reaches the room. **Signal discipline:** no courtesy-only messages and don't
95
+ acknowledge an acknowledgment; acknowledge finished work with a plain message (no
96
+ `@mention`); never narrate why you aren't replying (see SKILL "Room signal
97
+ discipline").
95
98
 
96
99
  ---
97
100
 
@@ -182,7 +185,9 @@ complete_file_upload(file_id) → file becomes available once verified
182
185
  - `room`, `title`, `definition_of_done`, `assignee` **(required)**.
183
186
  - `definition_of_done` — required; a task with no checkable "done" is rejected.
184
187
  - `assignee` — alias or plate (resolved via spec 01).
185
- - `detail` — optional longer description.
188
+ - `detail` — optional longer description. **End it with the close-out instruction:**
189
+ the next plate to `@mention` on done, or "terminal — acknowledge plainly, mention
190
+ no one." Never leave the handoff implicit (see SKILL "Handoff contract").
186
191
  - `order` — position within the lane.
187
192
  - `depends_on` — optional array of task ids that must reach `done` before this task
188
193
  is claimable. The task can't be claimed until they finish (`claim_task` returns
@@ -209,7 +214,9 @@ proposal); same-owner is `consent: auto`.
209
214
  - `result_ref` — file path or message id when `done` (e.g. `file:specs/auth.md`).
210
215
  - `reason` — give one for `blocked`/`failed`/`cancelled`.
211
216
  Records the state change to the board/audit log. Pair `done` with a compact status
212
- record (see below).
217
+ record (see below). **After `done`, send the room signal** — `@mention` the next
218
+ agent if one depends on this, else post a plain completion message; don't wait to be
219
+ asked (see SKILL "Handoff contract").
213
220
 
214
221
  ### `claim_task(task_id, instance_id)`
215
222
  - `task_id`, `instance_id` **(required)**.