agent-rooms 0.5.0 → 0.5.2
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 +10 -1
- package/dist/cli.js +8 -0
- package/dist/cli.js.map +1 -1
- package/dist/commands/init.js +31 -4
- package/dist/commands/init.js.map +1 -1
- package/package.json +1 -1
- package/skill/agent-rooms/AGENTS.md +114 -109
- package/skill/agent-rooms/SKILL.md +310 -212
- package/skill/agent-rooms/references/tools.md +419 -347
|
@@ -165,12 +165,16 @@ complete_file_upload(file_id) → file becomes available once verified
|
|
|
165
165
|
|
|
166
166
|
## Tasks & board (NEW — spec 03)
|
|
167
167
|
|
|
168
|
-
### `create_task(room, title, definition_of_done, assignee, detail?, order?, idempotency_key?)`
|
|
168
|
+
### `create_task(room, title, definition_of_done, assignee, detail?, order?, depends_on?, idempotency_key?)`
|
|
169
169
|
- `room`, `title`, `definition_of_done`, `assignee` **(required)**.
|
|
170
170
|
- `definition_of_done` — required; a task with no checkable "done" is rejected.
|
|
171
171
|
- `assignee` — alias or plate (resolved via spec 01).
|
|
172
172
|
- `detail` — optional longer description.
|
|
173
173
|
- `order` — position within the lane.
|
|
174
|
+
- `depends_on` — optional array of task ids that must reach `done` before this task
|
|
175
|
+
is claimable. The task can't be claimed until they finish (`claim_task` returns
|
|
176
|
+
`reason:"blocked_by_deps"`), and completing the last one **auto-wakes** this
|
|
177
|
+
task's assignee. Must reference tasks in the same room; cycles are rejected.
|
|
174
178
|
- `idempotency_key` — optional.
|
|
175
179
|
Returns the created task. Cross-owner assignment lands `consent: pending` (a
|
|
176
180
|
proposal); same-owner is `consent: auto`.
|
|
@@ -179,8 +183,9 @@ proposal); same-owner is `consent: auto`.
|
|
|
179
183
|
- `task_id`, `assignee` **(required)**. (Re)assign to an alias/plate. Cross-owner
|
|
180
184
|
becomes a proposal (`pending`).
|
|
181
185
|
|
|
182
|
-
### `update_task(task_id, { title?, detail?, definition_of_done?, order? })`
|
|
183
|
-
- `task_id` **(required)** plus a patch object of any editable fields.
|
|
186
|
+
### `update_task(task_id, { title?, detail?, definition_of_done?, order?, depends_on? })`
|
|
187
|
+
- `task_id` **(required)** plus a patch object of any editable fields. `depends_on`
|
|
188
|
+
replaces the dependency set (same-room ids, no cycles).
|
|
184
189
|
|
|
185
190
|
### `set_status(task_id, status, { result_ref?, reason? })`
|
|
186
191
|
- `task_id`, `status` **(required)** — one of `todo | doing | blocked | done |
|
|
@@ -194,7 +199,9 @@ record (see below).
|
|
|
194
199
|
- `task_id`, `instance_id` **(required)**.
|
|
195
200
|
Atomic compare-and-swap `todo → doing`. Returns `{ ok, lease: { holder,
|
|
196
201
|
session_id, expires_at } }` on success, or `{ ok: false, reason: "already_claimed" }`
|
|
197
|
-
when another instance won
|
|
202
|
+
when another instance won, or `{ ok: false, reason: "blocked_by_deps", blocked_by:
|
|
203
|
+
[…] }` when a prerequisite isn't `done` yet (don't retry — you'll be auto-woken when
|
|
204
|
+
it is). **Claim before working.** Don't retry on
|
|
198
205
|
`already_claimed`.
|
|
199
206
|
|
|
200
207
|
### `renew_lease(task_id)`
|
|
@@ -256,6 +263,35 @@ but lets an in-flight `doing` task finish.
|
|
|
256
263
|
|
|
257
264
|
---
|
|
258
265
|
|
|
266
|
+
## Feedback (NEW — agent feedback system)
|
|
267
|
+
|
|
268
|
+
Evidence-gated, consent-gated. The human sets consent; you only read it. See the
|
|
269
|
+
**Feedback** section of `SKILL.md` for the full behavior — this is the param ref.
|
|
270
|
+
|
|
271
|
+
### `get_feedback_consent({ plate? })`
|
|
272
|
+
- `plate` optional — defaults to (and may only be) your own plate.
|
|
273
|
+
- Returns `{bugs, product, granted_at, revoked}`. Call before sending any feedback.
|
|
274
|
+
A `revoked` consent reads as both scopes off.
|
|
275
|
+
|
|
276
|
+
### `submit_task_feedback(room, task_id, outcome, …)`
|
|
277
|
+
- `room`, `task_id`, `outcome` **(required)**. `outcome` is `clean` or `issue`.
|
|
278
|
+
- `clean` records a silent telemetry signal (no store row, no consent needed) —
|
|
279
|
+
the normal end-of-task answer.
|
|
280
|
+
- `issue` requires `feedback.bugs` consent **and** all of:
|
|
281
|
+
- `evidence` **(required)**: `{ tool, args?, expected, got, error?, latency_ms?, retry_count? }`. No `evidence` → rejected ("no citation = no report").
|
|
282
|
+
- `issue` (3–4 sentences), `recommended_fix` (3 sentences).
|
|
283
|
+
- `severity`: `blocker` | `degraded` | `minor` (from facts).
|
|
284
|
+
- `origin`: `agent_noticed` | `human_struggle`.
|
|
285
|
+
- Server sets the `recurring` flag by tool+evidence signature — you don't.
|
|
286
|
+
|
|
287
|
+
### `submit_product_feedback(room, answers)`
|
|
288
|
+
- `room` **(required)**. `answers`: `{ not_built_for_agent?, faster_or_fewer_calls?, missing_affordance?, feature_specific? }` — each optional ("no notes" is valid).
|
|
289
|
+
- Requires `feedback.product` consent. Periodic + server rate-gated: returns
|
|
290
|
+
`{ recorded: false, reason }` if it's too early or you already answered this
|
|
291
|
+
session. Don't retry on a decline.
|
|
292
|
+
|
|
293
|
+
---
|
|
294
|
+
|
|
259
295
|
## Dedup / claim note
|
|
260
296
|
- **Mentions:** single-handler delivery — one logical mention routes to one
|
|
261
297
|
instance and is claimed by whoever acks it. Re-check / skip a delivery that's
|
|
@@ -288,346 +324,382 @@ but lets an in-flight `doing` task finish.
|
|
|
288
324
|
session id (package 0.2.x captures it). Treat as present-when-available.
|
|
289
325
|
- **`write_file` size ceiling** — ~256 KB is a spec *suggestion* (02), not a hard
|
|
290
326
|
handler value; confirm the real inline limit / `truncated` threshold.
|
|
291
|
-
|
|
292
|
-
## Generated tool index (authoritative params)
|
|
293
|
-
|
|
294
|
-
<!-- GENERATED:tools BEGIN — do not edit by hand; run `npx tsx scripts/generate-skill-docs.ts` -->
|
|
295
|
-
|
|
296
|
-
_29 tools, generated from `backend/src/mcp/server.ts`. Every result is returned as MCP `content` (a JSON string) **and** `structuredContent` (the parsed object)._
|
|
297
|
-
|
|
298
|
-
### `list_rooms`
|
|
299
|
-
|
|
300
|
-
List rooms the calling agent is a member of.
|
|
301
|
-
|
|
302
|
-
| param | type | required | notes |
|
|
303
|
-
|---|---|---|---|
|
|
304
|
-
| `workspace` | string | no | |
|
|
305
|
-
| `host` | string | no | |
|
|
306
|
-
|
|
307
|
-
### `read_room`
|
|
308
|
-
|
|
309
|
-
Read room message history.
|
|
310
|
-
|
|
311
|
-
| param | type | required | notes |
|
|
312
|
-
|---|---|---|---|
|
|
313
|
-
| `room` | string | **yes** | |
|
|
314
|
-
| `limit` | integer | no | |
|
|
315
|
-
| `before_seq` | integer | no | |
|
|
316
|
-
| `workspace` | string | no | |
|
|
317
|
-
| `host` | string | no | |
|
|
318
|
-
|
|
319
|
-
### `check_mentions`
|
|
320
|
-
|
|
321
|
-
Check unread mentions for the calling agent.
|
|
322
|
-
|
|
323
|
-
| param | type | required | notes |
|
|
324
|
-
|---|---|---|---|
|
|
325
|
-
| `since_seq` | integer | no | |
|
|
326
|
-
| `limit` | integer | no | |
|
|
327
|
-
| `room` | string | no | |
|
|
328
|
-
| `rooms` | string[] | no | |
|
|
329
|
-
| `workspace` | string | no | |
|
|
330
|
-
| `host` | string | no | |
|
|
331
|
-
|
|
332
|
-
### `list_members`
|
|
333
|
-
|
|
334
|
-
List humans and agents in a room.
|
|
335
|
-
|
|
336
|
-
| param | type | required | notes |
|
|
337
|
-
|---|---|---|---|
|
|
338
|
-
| `room` | string | **yes** | |
|
|
339
|
-
| `workspace` | string | no | |
|
|
340
|
-
| `host` | string | no | |
|
|
341
|
-
|
|
342
|
-
### `send_message`
|
|
343
|
-
|
|
344
|
-
Send an agent message to a room.
|
|
345
|
-
|
|
346
|
-
| param | type | required | notes |
|
|
347
|
-
|---|---|---|---|
|
|
348
|
-
| `room` | string | **yes** | |
|
|
349
|
-
| `body` | string | **yes** | |
|
|
350
|
-
| `mentions` | string[] | no | |
|
|
351
|
-
| `parent_id` | string,null | no | |
|
|
352
|
-
| `idempotency_key` | string | no | |
|
|
353
|
-
| `workspace` | string | no | |
|
|
354
|
-
| `host` | string | no | |
|
|
355
|
-
|
|
356
|
-
### `share_file`
|
|
357
|
-
|
|
358
|
-
Create a pending file upload.
|
|
359
|
-
|
|
360
|
-
| param | type | required | notes |
|
|
361
|
-
|---|---|---|---|
|
|
362
|
-
| `room` | string | **yes** | |
|
|
363
|
-
| `filename` | string | **yes** | |
|
|
364
|
-
| `content_type` | string | **yes** | |
|
|
365
|
-
| `size_bytes` | integer | **yes** | |
|
|
366
|
-
| `sha256` | string | **yes** | |
|
|
367
|
-
| `idempotency_key` | string | no | |
|
|
368
|
-
| `workspace` | string | no | |
|
|
369
|
-
| `host` | string | no | |
|
|
370
|
-
|
|
371
|
-
### `complete_file_upload`
|
|
372
|
-
|
|
373
|
-
Finalize a pending file upload.
|
|
374
|
-
|
|
375
|
-
| param | type | required | notes |
|
|
376
|
-
|---|---|---|---|
|
|
377
|
-
| `file_id` | string | **yes** | |
|
|
378
|
-
|
|
379
|
-
### `fetch_file`
|
|
380
|
-
|
|
381
|
-
Create a file download URL.
|
|
382
|
-
|
|
383
|
-
| param | type | required | notes |
|
|
384
|
-
|---|---|---|---|
|
|
385
|
-
| `file_id` | string | **yes** | |
|
|
386
|
-
|
|
387
|
-
### `ack_mentions`
|
|
388
|
-
|
|
389
|
-
Advance the mention cursor.
|
|
390
|
-
|
|
391
|
-
| param | type | required | notes |
|
|
392
|
-
|---|---|---|---|
|
|
393
|
-
| `room` | string | no | |
|
|
394
|
-
| `last_mention_seq` | integer | no | |
|
|
395
|
-
| `mention_ids` | string[] | no | |
|
|
396
|
-
| `workspace` | string | no | |
|
|
397
|
-
| `host` | string | no | |
|
|
398
|
-
|
|
399
|
-
### `whoami`
|
|
400
|
-
|
|
401
|
-
Return the calling agent identity.
|
|
402
|
-
|
|
403
|
-
_No parameters._
|
|
404
|
-
|
|
405
|
-
### `write_file`
|
|
406
|
-
|
|
407
|
-
Write text/small file content to a room (versioned).
|
|
408
|
-
|
|
409
|
-
| param | type | required | notes |
|
|
410
|
-
|---|---|---|---|
|
|
411
|
-
| `room` | string | **yes** | |
|
|
412
|
-
| `path` | string | **yes** | |
|
|
413
|
-
| `content` | string | **yes** | |
|
|
414
|
-
| `encoding` | string | no | one of: `utf-8`, `base64` |
|
|
415
|
-
| `content_type` | string | no | |
|
|
416
|
-
| `idempotency_key` | string | no | |
|
|
417
|
-
| `workspace` | string | no | |
|
|
418
|
-
| `host` | string | no | |
|
|
419
|
-
|
|
420
|
-
### `read_file`
|
|
421
|
-
|
|
422
|
-
Read room file content inline by path or file_id.
|
|
423
|
-
|
|
424
|
-
| param | type | required | notes |
|
|
425
|
-
|---|---|---|---|
|
|
426
|
-
| `room` | string | **yes** | |
|
|
427
|
-
| `path` | string | no | |
|
|
428
|
-
| `file_id` | string | no | |
|
|
429
|
-
| `version` | integer | no | |
|
|
430
|
-
| `range` | object | no | |
|
|
431
|
-
| `workspace` | string | no | |
|
|
432
|
-
| `host` | string | no | |
|
|
433
|
-
|
|
434
|
-
### `list_files`
|
|
435
|
-
|
|
436
|
-
List the latest version of room files.
|
|
437
|
-
|
|
438
|
-
| param | type | required | notes |
|
|
439
|
-
|---|---|---|---|
|
|
440
|
-
| `room` | string | **yes** | |
|
|
441
|
-
| `prefix` | string | no | |
|
|
442
|
-
| `workspace` | string | no | |
|
|
443
|
-
| `host` | string | no | |
|
|
444
|
-
|
|
445
|
-
### `delete_file`
|
|
446
|
-
|
|
447
|
-
Delete a room file and its versions.
|
|
448
|
-
|
|
449
|
-
| param | type | required | notes |
|
|
450
|
-
|---|---|---|---|
|
|
451
|
-
| `room` | string | **yes** | |
|
|
452
|
-
| `path` | string | no | |
|
|
453
|
-
| `file_id` | string | no | |
|
|
454
|
-
| `workspace` | string | no | |
|
|
455
|
-
| `host` | string | no | |
|
|
456
|
-
|
|
457
|
-
### `resolve_handle`
|
|
458
|
-
|
|
459
|
-
Resolve @name(owner)[#session] to candidate plates + live instances.
|
|
460
|
-
|
|
461
|
-
| param | type | required | notes |
|
|
462
|
-
|---|---|---|---|
|
|
463
|
-
| `room` | string | **yes** | |
|
|
464
|
-
| `handle` | string | **yes** | |
|
|
465
|
-
| `workspace` | string | no | |
|
|
466
|
-
| `host` | string | no | |
|
|
467
|
-
|
|
468
|
-
### `list_instances`
|
|
469
|
-
|
|
470
|
-
List live agent instances in a room (optionally filtered by plate).
|
|
471
|
-
|
|
472
|
-
| param | type | required | notes |
|
|
473
|
-
|---|---|---|---|
|
|
474
|
-
| `room` | string | **yes** | |
|
|
475
|
-
| `plate` | string | no | |
|
|
476
|
-
| `workspace` | string | no | |
|
|
477
|
-
| `host` | string | no | |
|
|
478
|
-
|
|
479
|
-
### `create_task`
|
|
480
|
-
|
|
481
|
-
Create a task in a room lane.
|
|
482
|
-
|
|
483
|
-
| param | type | required | notes |
|
|
484
|
-
|---|---|---|---|
|
|
485
|
-
| `room` | string | **yes** | |
|
|
486
|
-
| `title` | string | **yes** | |
|
|
487
|
-
| `definition_of_done` | string | **yes** | |
|
|
488
|
-
| `assignee` | string | **yes** | |
|
|
489
|
-
| `detail` | string | no | |
|
|
490
|
-
| `order` | integer | no | |
|
|
491
|
-
| `idempotency_key` | string | no | |
|
|
492
|
-
| `workspace` | string | no | |
|
|
493
|
-
| `host` | string | no | |
|
|
494
|
-
|
|
495
|
-
### `assign_task`
|
|
496
|
-
|
|
497
|
-
Assign or reassign a task to a plate.
|
|
498
|
-
|
|
499
|
-
| param | type | required | notes |
|
|
500
|
-
|---|---|---|---|
|
|
501
|
-
| `task_id` | string | **yes** | |
|
|
502
|
-
| `assignee` | string | **yes** | |
|
|
503
|
-
| `idempotency_key` | string | no | |
|
|
504
|
-
| `workspace` | string | no | |
|
|
505
|
-
| `host` | string | no | |
|
|
506
|
-
|
|
507
|
-
### `update_task`
|
|
508
|
-
|
|
509
|
-
Edit task title/detail/definition/order.
|
|
510
|
-
|
|
511
|
-
| param | type | required | notes |
|
|
512
|
-
|---|---|---|---|
|
|
513
|
-
| `task_id` | string | **yes** | |
|
|
514
|
-
| `title` | string | no | |
|
|
515
|
-
| `detail` | string | no | |
|
|
516
|
-
| `definition_of_done` | string | no | |
|
|
517
|
-
| `order` | integer | no | |
|
|
518
|
-
| `workspace` | string | no | |
|
|
519
|
-
| `host` | string | no | |
|
|
520
|
-
|
|
521
|
-
### `set_status`
|
|
522
|
-
|
|
523
|
-
Advance the task status; write a board record on done.
|
|
524
|
-
|
|
525
|
-
| param | type | required | notes |
|
|
526
|
-
|---|---|---|---|
|
|
527
|
-
| `task_id` | string | **yes** | |
|
|
528
|
-
| `status` | string | **yes** | one of: `todo`, `doing`, `blocked`, `done`, `failed`, `cancelled` |
|
|
529
|
-
| `result_ref` | string | no | |
|
|
530
|
-
| `reason` | string | no | |
|
|
531
|
-
| `summary` | string | no | |
|
|
532
|
-
| `artifacts` | string[] | no | |
|
|
533
|
-
| `next` | string | no | |
|
|
534
|
-
| `workspace` | string | no | |
|
|
535
|
-
| `host` | string | no | |
|
|
536
|
-
|
|
537
|
-
### `claim_task`
|
|
538
|
-
|
|
539
|
-
Atomically claim a todo task (acquire the lease).
|
|
540
|
-
|
|
541
|
-
| param | type | required | notes |
|
|
542
|
-
|---|---|---|---|
|
|
543
|
-
| `task_id` | string | **yes** | |
|
|
544
|
-
| `instance_id` | string | no | |
|
|
545
|
-
| `workspace` | string | no | |
|
|
546
|
-
| `host` | string | no | |
|
|
547
|
-
|
|
548
|
-
### `renew_lease`
|
|
549
|
-
|
|
550
|
-
Heartbeat: extend the lease on a claimed task.
|
|
551
|
-
|
|
552
|
-
| param | type | required | notes |
|
|
553
|
-
|---|---|---|---|
|
|
554
|
-
| `task_id` | string | **yes** | |
|
|
555
|
-
| `workspace` | string | no | |
|
|
556
|
-
| `host` | string | no | |
|
|
557
|
-
|
|
558
|
-
### `release_task`
|
|
559
|
-
|
|
560
|
-
Release a claimed task back to todo.
|
|
561
|
-
|
|
562
|
-
| param | type | required | notes |
|
|
563
|
-
|---|---|---|---|
|
|
564
|
-
| `task_id` | string | **yes** | |
|
|
565
|
-
| `workspace` | string | no | |
|
|
566
|
-
| `host` | string | no | |
|
|
567
|
-
|
|
568
|
-
### `read_board`
|
|
569
|
-
|
|
570
|
-
Read the task board (tasks + records).
|
|
571
|
-
|
|
572
|
-
| param | type | required | notes |
|
|
573
|
-
|---|---|---|---|
|
|
574
|
-
| `room` | string | **yes** | |
|
|
575
|
-
| `assignee` | string | no | |
|
|
576
|
-
| `status` | string | no | one of: `todo`, `doing`, `blocked`, `done`, `failed`, `cancelled` |
|
|
577
|
-
| `workspace` | string | no | |
|
|
578
|
-
| `host` | string | no | |
|
|
579
|
-
|
|
580
|
-
### `archive_task`
|
|
581
|
-
|
|
582
|
-
Remove a task from the active board (keep history).
|
|
583
|
-
|
|
584
|
-
| param | type | required | notes |
|
|
585
|
-
|---|---|---|---|
|
|
586
|
-
| `task_id` | string | **yes** | |
|
|
587
|
-
| `workspace` | string | no | |
|
|
588
|
-
| `host` | string | no | |
|
|
589
|
-
|
|
590
|
-
### `set_room_consent`
|
|
591
|
-
|
|
592
|
-
Set this owner's cross-owner consent mode for a room.
|
|
593
|
-
|
|
594
|
-
| param | type | required | notes |
|
|
595
|
-
|---|---|---|---|
|
|
596
|
-
| `room` | string | **yes** | |
|
|
597
|
-
| `mode` | string | **yes** | one of: `task_by_task`, `approve_all`, `trust_collaborator`, `trust_room` |
|
|
598
|
-
| `collaborator` | string | no | |
|
|
599
|
-
| `workspace` | string | no | |
|
|
600
|
-
| `host` | string | no | |
|
|
601
|
-
|
|
602
|
-
### `accept_task`
|
|
603
|
-
|
|
604
|
-
Accept a pending cross-owner task proposal.
|
|
605
|
-
|
|
606
|
-
| param | type | required | notes |
|
|
607
|
-
|---|---|---|---|
|
|
608
|
-
| `task_id` | string | **yes** | |
|
|
609
|
-
| `workspace` | string | no | |
|
|
610
|
-
| `host` | string | no | |
|
|
611
|
-
|
|
612
|
-
### `reject_task`
|
|
613
|
-
|
|
614
|
-
Reject a pending cross-owner task proposal.
|
|
615
|
-
|
|
616
|
-
| param | type | required | notes |
|
|
617
|
-
|---|---|---|---|
|
|
618
|
-
| `task_id` | string | **yes** | |
|
|
619
|
-
| `reason` | string | no | |
|
|
620
|
-
| `workspace` | string | no | |
|
|
621
|
-
| `host` | string | no | |
|
|
622
|
-
|
|
623
|
-
### `list_pending_consents`
|
|
624
|
-
|
|
625
|
-
List pending cross-owner proposals for this owner.
|
|
626
|
-
|
|
627
|
-
| param | type | required | notes |
|
|
628
|
-
|---|---|---|---|
|
|
629
|
-
| `room` | string | **yes** | |
|
|
630
|
-
| `workspace` | string | no | |
|
|
631
|
-
| `host` | string | no | |
|
|
632
|
-
|
|
633
|
-
|
|
327
|
+
|
|
328
|
+
## Generated tool index (authoritative params)
|
|
329
|
+
|
|
330
|
+
<!-- GENERATED:tools BEGIN — do not edit by hand; run `npx tsx scripts/generate-skill-docs.ts` -->
|
|
331
|
+
|
|
332
|
+
_29 tools, generated from `backend/src/mcp/server.ts`. Every result is returned as MCP `content` (a JSON string) **and** `structuredContent` (the parsed object)._
|
|
333
|
+
|
|
334
|
+
### `list_rooms`
|
|
335
|
+
|
|
336
|
+
List rooms the calling agent is a member of.
|
|
337
|
+
|
|
338
|
+
| param | type | required | notes |
|
|
339
|
+
|---|---|---|---|
|
|
340
|
+
| `workspace` | string | no | |
|
|
341
|
+
| `host` | string | no | |
|
|
342
|
+
|
|
343
|
+
### `read_room`
|
|
344
|
+
|
|
345
|
+
Read room message history.
|
|
346
|
+
|
|
347
|
+
| param | type | required | notes |
|
|
348
|
+
|---|---|---|---|
|
|
349
|
+
| `room` | string | **yes** | |
|
|
350
|
+
| `limit` | integer | no | |
|
|
351
|
+
| `before_seq` | integer | no | |
|
|
352
|
+
| `workspace` | string | no | |
|
|
353
|
+
| `host` | string | no | |
|
|
354
|
+
|
|
355
|
+
### `check_mentions`
|
|
356
|
+
|
|
357
|
+
Check unread mentions for the calling agent.
|
|
358
|
+
|
|
359
|
+
| param | type | required | notes |
|
|
360
|
+
|---|---|---|---|
|
|
361
|
+
| `since_seq` | integer | no | |
|
|
362
|
+
| `limit` | integer | no | |
|
|
363
|
+
| `room` | string | no | |
|
|
364
|
+
| `rooms` | string[] | no | |
|
|
365
|
+
| `workspace` | string | no | |
|
|
366
|
+
| `host` | string | no | |
|
|
367
|
+
|
|
368
|
+
### `list_members`
|
|
369
|
+
|
|
370
|
+
List humans and agents in a room.
|
|
371
|
+
|
|
372
|
+
| param | type | required | notes |
|
|
373
|
+
|---|---|---|---|
|
|
374
|
+
| `room` | string | **yes** | |
|
|
375
|
+
| `workspace` | string | no | |
|
|
376
|
+
| `host` | string | no | |
|
|
377
|
+
|
|
378
|
+
### `send_message`
|
|
379
|
+
|
|
380
|
+
Send an agent message to a room.
|
|
381
|
+
|
|
382
|
+
| param | type | required | notes |
|
|
383
|
+
|---|---|---|---|
|
|
384
|
+
| `room` | string | **yes** | |
|
|
385
|
+
| `body` | string | **yes** | |
|
|
386
|
+
| `mentions` | string[] | no | |
|
|
387
|
+
| `parent_id` | string,null | no | |
|
|
388
|
+
| `idempotency_key` | string | no | |
|
|
389
|
+
| `workspace` | string | no | |
|
|
390
|
+
| `host` | string | no | |
|
|
391
|
+
|
|
392
|
+
### `share_file`
|
|
393
|
+
|
|
394
|
+
Create a pending file upload.
|
|
395
|
+
|
|
396
|
+
| param | type | required | notes |
|
|
397
|
+
|---|---|---|---|
|
|
398
|
+
| `room` | string | **yes** | |
|
|
399
|
+
| `filename` | string | **yes** | |
|
|
400
|
+
| `content_type` | string | **yes** | |
|
|
401
|
+
| `size_bytes` | integer | **yes** | |
|
|
402
|
+
| `sha256` | string | **yes** | |
|
|
403
|
+
| `idempotency_key` | string | no | |
|
|
404
|
+
| `workspace` | string | no | |
|
|
405
|
+
| `host` | string | no | |
|
|
406
|
+
|
|
407
|
+
### `complete_file_upload`
|
|
408
|
+
|
|
409
|
+
Finalize a pending file upload.
|
|
410
|
+
|
|
411
|
+
| param | type | required | notes |
|
|
412
|
+
|---|---|---|---|
|
|
413
|
+
| `file_id` | string | **yes** | |
|
|
414
|
+
|
|
415
|
+
### `fetch_file`
|
|
416
|
+
|
|
417
|
+
Create a file download URL.
|
|
418
|
+
|
|
419
|
+
| param | type | required | notes |
|
|
420
|
+
|---|---|---|---|
|
|
421
|
+
| `file_id` | string | **yes** | |
|
|
422
|
+
|
|
423
|
+
### `ack_mentions`
|
|
424
|
+
|
|
425
|
+
Advance the mention cursor.
|
|
426
|
+
|
|
427
|
+
| param | type | required | notes |
|
|
428
|
+
|---|---|---|---|
|
|
429
|
+
| `room` | string | no | |
|
|
430
|
+
| `last_mention_seq` | integer | no | |
|
|
431
|
+
| `mention_ids` | string[] | no | |
|
|
432
|
+
| `workspace` | string | no | |
|
|
433
|
+
| `host` | string | no | |
|
|
434
|
+
|
|
435
|
+
### `whoami`
|
|
436
|
+
|
|
437
|
+
Return the calling agent identity.
|
|
438
|
+
|
|
439
|
+
_No parameters._
|
|
440
|
+
|
|
441
|
+
### `write_file`
|
|
442
|
+
|
|
443
|
+
Write text/small file content to a room (versioned).
|
|
444
|
+
|
|
445
|
+
| param | type | required | notes |
|
|
446
|
+
|---|---|---|---|
|
|
447
|
+
| `room` | string | **yes** | |
|
|
448
|
+
| `path` | string | **yes** | |
|
|
449
|
+
| `content` | string | **yes** | |
|
|
450
|
+
| `encoding` | string | no | one of: `utf-8`, `base64` |
|
|
451
|
+
| `content_type` | string | no | |
|
|
452
|
+
| `idempotency_key` | string | no | |
|
|
453
|
+
| `workspace` | string | no | |
|
|
454
|
+
| `host` | string | no | |
|
|
455
|
+
|
|
456
|
+
### `read_file`
|
|
457
|
+
|
|
458
|
+
Read room file content inline by path or file_id.
|
|
459
|
+
|
|
460
|
+
| param | type | required | notes |
|
|
461
|
+
|---|---|---|---|
|
|
462
|
+
| `room` | string | **yes** | |
|
|
463
|
+
| `path` | string | no | |
|
|
464
|
+
| `file_id` | string | no | |
|
|
465
|
+
| `version` | integer | no | |
|
|
466
|
+
| `range` | object | no | |
|
|
467
|
+
| `workspace` | string | no | |
|
|
468
|
+
| `host` | string | no | |
|
|
469
|
+
|
|
470
|
+
### `list_files`
|
|
471
|
+
|
|
472
|
+
List the latest version of room files.
|
|
473
|
+
|
|
474
|
+
| param | type | required | notes |
|
|
475
|
+
|---|---|---|---|
|
|
476
|
+
| `room` | string | **yes** | |
|
|
477
|
+
| `prefix` | string | no | |
|
|
478
|
+
| `workspace` | string | no | |
|
|
479
|
+
| `host` | string | no | |
|
|
480
|
+
|
|
481
|
+
### `delete_file`
|
|
482
|
+
|
|
483
|
+
Delete a room file and its versions.
|
|
484
|
+
|
|
485
|
+
| param | type | required | notes |
|
|
486
|
+
|---|---|---|---|
|
|
487
|
+
| `room` | string | **yes** | |
|
|
488
|
+
| `path` | string | no | |
|
|
489
|
+
| `file_id` | string | no | |
|
|
490
|
+
| `workspace` | string | no | |
|
|
491
|
+
| `host` | string | no | |
|
|
492
|
+
|
|
493
|
+
### `resolve_handle`
|
|
494
|
+
|
|
495
|
+
Resolve @name(owner)[#session] to candidate plates + live instances.
|
|
496
|
+
|
|
497
|
+
| param | type | required | notes |
|
|
498
|
+
|---|---|---|---|
|
|
499
|
+
| `room` | string | **yes** | |
|
|
500
|
+
| `handle` | string | **yes** | |
|
|
501
|
+
| `workspace` | string | no | |
|
|
502
|
+
| `host` | string | no | |
|
|
503
|
+
|
|
504
|
+
### `list_instances`
|
|
505
|
+
|
|
506
|
+
List live agent instances in a room (optionally filtered by plate).
|
|
507
|
+
|
|
508
|
+
| param | type | required | notes |
|
|
509
|
+
|---|---|---|---|
|
|
510
|
+
| `room` | string | **yes** | |
|
|
511
|
+
| `plate` | string | no | |
|
|
512
|
+
| `workspace` | string | no | |
|
|
513
|
+
| `host` | string | no | |
|
|
514
|
+
|
|
515
|
+
### `create_task`
|
|
516
|
+
|
|
517
|
+
Create a task in a room lane.
|
|
518
|
+
|
|
519
|
+
| param | type | required | notes |
|
|
520
|
+
|---|---|---|---|
|
|
521
|
+
| `room` | string | **yes** | |
|
|
522
|
+
| `title` | string | **yes** | |
|
|
523
|
+
| `definition_of_done` | string | **yes** | |
|
|
524
|
+
| `assignee` | string | **yes** | |
|
|
525
|
+
| `detail` | string | no | |
|
|
526
|
+
| `order` | integer | no | |
|
|
527
|
+
| `idempotency_key` | string | no | |
|
|
528
|
+
| `workspace` | string | no | |
|
|
529
|
+
| `host` | string | no | |
|
|
530
|
+
|
|
531
|
+
### `assign_task`
|
|
532
|
+
|
|
533
|
+
Assign or reassign a task to a plate.
|
|
534
|
+
|
|
535
|
+
| param | type | required | notes |
|
|
536
|
+
|---|---|---|---|
|
|
537
|
+
| `task_id` | string | **yes** | |
|
|
538
|
+
| `assignee` | string | **yes** | |
|
|
539
|
+
| `idempotency_key` | string | no | |
|
|
540
|
+
| `workspace` | string | no | |
|
|
541
|
+
| `host` | string | no | |
|
|
542
|
+
|
|
543
|
+
### `update_task`
|
|
544
|
+
|
|
545
|
+
Edit task title/detail/definition/order.
|
|
546
|
+
|
|
547
|
+
| param | type | required | notes |
|
|
548
|
+
|---|---|---|---|
|
|
549
|
+
| `task_id` | string | **yes** | |
|
|
550
|
+
| `title` | string | no | |
|
|
551
|
+
| `detail` | string | no | |
|
|
552
|
+
| `definition_of_done` | string | no | |
|
|
553
|
+
| `order` | integer | no | |
|
|
554
|
+
| `workspace` | string | no | |
|
|
555
|
+
| `host` | string | no | |
|
|
556
|
+
|
|
557
|
+
### `set_status`
|
|
558
|
+
|
|
559
|
+
Advance the task status; write a board record on done.
|
|
560
|
+
|
|
561
|
+
| param | type | required | notes |
|
|
562
|
+
|---|---|---|---|
|
|
563
|
+
| `task_id` | string | **yes** | |
|
|
564
|
+
| `status` | string | **yes** | one of: `todo`, `doing`, `blocked`, `done`, `failed`, `cancelled` |
|
|
565
|
+
| `result_ref` | string | no | |
|
|
566
|
+
| `reason` | string | no | |
|
|
567
|
+
| `summary` | string | no | |
|
|
568
|
+
| `artifacts` | string[] | no | |
|
|
569
|
+
| `next` | string | no | |
|
|
570
|
+
| `workspace` | string | no | |
|
|
571
|
+
| `host` | string | no | |
|
|
572
|
+
|
|
573
|
+
### `claim_task`
|
|
574
|
+
|
|
575
|
+
Atomically claim a todo task (acquire the lease).
|
|
576
|
+
|
|
577
|
+
| param | type | required | notes |
|
|
578
|
+
|---|---|---|---|
|
|
579
|
+
| `task_id` | string | **yes** | |
|
|
580
|
+
| `instance_id` | string | no | |
|
|
581
|
+
| `workspace` | string | no | |
|
|
582
|
+
| `host` | string | no | |
|
|
583
|
+
|
|
584
|
+
### `renew_lease`
|
|
585
|
+
|
|
586
|
+
Heartbeat: extend the lease on a claimed task.
|
|
587
|
+
|
|
588
|
+
| param | type | required | notes |
|
|
589
|
+
|---|---|---|---|
|
|
590
|
+
| `task_id` | string | **yes** | |
|
|
591
|
+
| `workspace` | string | no | |
|
|
592
|
+
| `host` | string | no | |
|
|
593
|
+
|
|
594
|
+
### `release_task`
|
|
595
|
+
|
|
596
|
+
Release a claimed task back to todo.
|
|
597
|
+
|
|
598
|
+
| param | type | required | notes |
|
|
599
|
+
|---|---|---|---|
|
|
600
|
+
| `task_id` | string | **yes** | |
|
|
601
|
+
| `workspace` | string | no | |
|
|
602
|
+
| `host` | string | no | |
|
|
603
|
+
|
|
604
|
+
### `read_board`
|
|
605
|
+
|
|
606
|
+
Read the task board (tasks + records).
|
|
607
|
+
|
|
608
|
+
| param | type | required | notes |
|
|
609
|
+
|---|---|---|---|
|
|
610
|
+
| `room` | string | **yes** | |
|
|
611
|
+
| `assignee` | string | no | |
|
|
612
|
+
| `status` | string | no | one of: `todo`, `doing`, `blocked`, `done`, `failed`, `cancelled` |
|
|
613
|
+
| `workspace` | string | no | |
|
|
614
|
+
| `host` | string | no | |
|
|
615
|
+
|
|
616
|
+
### `archive_task`
|
|
617
|
+
|
|
618
|
+
Remove a task from the active board (keep history).
|
|
619
|
+
|
|
620
|
+
| param | type | required | notes |
|
|
621
|
+
|---|---|---|---|
|
|
622
|
+
| `task_id` | string | **yes** | |
|
|
623
|
+
| `workspace` | string | no | |
|
|
624
|
+
| `host` | string | no | |
|
|
625
|
+
|
|
626
|
+
### `set_room_consent`
|
|
627
|
+
|
|
628
|
+
Set this owner's cross-owner consent mode for a room.
|
|
629
|
+
|
|
630
|
+
| param | type | required | notes |
|
|
631
|
+
|---|---|---|---|
|
|
632
|
+
| `room` | string | **yes** | |
|
|
633
|
+
| `mode` | string | **yes** | one of: `task_by_task`, `approve_all`, `trust_collaborator`, `trust_room` |
|
|
634
|
+
| `collaborator` | string | no | |
|
|
635
|
+
| `workspace` | string | no | |
|
|
636
|
+
| `host` | string | no | |
|
|
637
|
+
|
|
638
|
+
### `accept_task`
|
|
639
|
+
|
|
640
|
+
Accept a pending cross-owner task proposal.
|
|
641
|
+
|
|
642
|
+
| param | type | required | notes |
|
|
643
|
+
|---|---|---|---|
|
|
644
|
+
| `task_id` | string | **yes** | |
|
|
645
|
+
| `workspace` | string | no | |
|
|
646
|
+
| `host` | string | no | |
|
|
647
|
+
|
|
648
|
+
### `reject_task`
|
|
649
|
+
|
|
650
|
+
Reject a pending cross-owner task proposal.
|
|
651
|
+
|
|
652
|
+
| param | type | required | notes |
|
|
653
|
+
|---|---|---|---|
|
|
654
|
+
| `task_id` | string | **yes** | |
|
|
655
|
+
| `reason` | string | no | |
|
|
656
|
+
| `workspace` | string | no | |
|
|
657
|
+
| `host` | string | no | |
|
|
658
|
+
|
|
659
|
+
### `list_pending_consents`
|
|
660
|
+
|
|
661
|
+
List pending cross-owner proposals for this owner.
|
|
662
|
+
|
|
663
|
+
| param | type | required | notes |
|
|
664
|
+
|---|---|---|---|
|
|
665
|
+
| `room` | string | **yes** | |
|
|
666
|
+
| `workspace` | string | no | |
|
|
667
|
+
| `host` | string | no | |
|
|
668
|
+
|
|
669
|
+
### `get_feedback_consent`
|
|
670
|
+
|
|
671
|
+
Read the feedback consent (bugs/product) the human set for your plate.
|
|
672
|
+
|
|
673
|
+
| param | type | required | notes |
|
|
674
|
+
|---|---|---|---|
|
|
675
|
+
| `plate` | string | no | defaults to your own plate; may only be your own |
|
|
676
|
+
|
|
677
|
+
### `submit_task_feedback`
|
|
678
|
+
|
|
679
|
+
End-of-task bug/friction channel. `clean` = silent; `issue` = evidence-gated.
|
|
680
|
+
|
|
681
|
+
| param | type | required | notes |
|
|
682
|
+
|---|---|---|---|
|
|
683
|
+
| `room` | string | **yes** | |
|
|
684
|
+
| `task_id` | string | **yes** | |
|
|
685
|
+
| `outcome` | string | **yes** | `clean` \| `issue` |
|
|
686
|
+
| `origin` | string | issue only | `agent_noticed` \| `human_struggle` |
|
|
687
|
+
| `severity` | string | issue only | `blocker` \| `degraded` \| `minor` |
|
|
688
|
+
| `evidence` | object | issue only | `{ tool, args?, expected, got, error?, latency_ms?, retry_count? }` — no citation = no report |
|
|
689
|
+
| `issue` | string | issue only | 3–4 sentences |
|
|
690
|
+
| `recommended_fix` | string | issue only | 3 sentences |
|
|
691
|
+
| `workspace` | string | no | |
|
|
692
|
+
| `host` | string | no | |
|
|
693
|
+
|
|
694
|
+
### `submit_product_feedback`
|
|
695
|
+
|
|
696
|
+
Periodic agent-native product feedback. Consent + server rate-gated.
|
|
697
|
+
|
|
698
|
+
| param | type | required | notes |
|
|
699
|
+
|---|---|---|---|
|
|
700
|
+
| `room` | string | **yes** | |
|
|
701
|
+
| `answers` | object | no | `{ not_built_for_agent?, faster_or_fewer_calls?, missing_affordance?, feature_specific? }` — "no notes" ok |
|
|
702
|
+
| `workspace` | string | no | |
|
|
703
|
+
| `host` | string | no | |
|
|
704
|
+
|
|
705
|
+
<!-- GENERATED:tools END -->
|