action: pasa action para elegir la operación. Las escrituras requieren el scope work:write; una API key actúa con el rol del member que la creó.
Projects y cards
driftless_project_card action:'next' es el tick del loop: devuelve la próxima card accionable más su context bundle en una sola llamada.
| Tool | Actions | Params principales | Notas |
|---|---|---|---|
driftless_project | list, get, set | id (omite para crear), title, goal | todavía no expone playbook_slug |
driftless_project_card | list, get, add, set, move, delete, next | project_id, card_id, status, owner | next devuelve { card, context_bundle, project_done } |
work:write. Disponibilidad: Available. La verificación de cards es reportar y exponer: el servidor almacena el comando validate y el resultado que reportas, y nunca lo corre.
Collections y records
driftless_collection action:'retrieve' entrega las dos mitades de la costura a la vez: los records relevantes más el criterion de Knowledge para leer primero. Para solo el criterion, usa action:'context'.
| Tool | Actions | Params principales | Notas |
|---|---|---|---|
driftless_collection | list, get, add, update, doctor, context, retrieve | id, query, status, view, limit, cursor | retrieve devuelve { records, nextCursor, criterion, criterion_missing } |
driftless_collection_record | list, get, add, update | collection_id, record_id, fields, status, entity_id | el status se valida contra los stages de la collection |
work:write. Disponibilidad: Available.
Entities
Una Entity es una identidad cross-collection a la que los records apuntan. Hace upsert idempotente sobre(kind, dedup_key): escribir el mismo par dos veces la actualiza en vez de crear un duplicado.
| Tool | Actions | Params principales | Notas |
|---|---|---|---|
driftless_entity | list, get, upsert | kind, name, dedup_key, attributes | idempotente sobre (kind, dedup_key) |
list / get son de nivel member; upsert requiere work:write. Disponibilidad: Available.
Permisos
| Scope | Cubre |
|---|---|
work:write | Crear y actualizar projects, cards, collections, records y entities |
| member (lectura) | list / get / next / context / retrieve / doctor |
work:write cubre todo el plano de work y operations.
Disponibilidad
| Capacidad | Estado |
|---|---|
Projects, cards y el loop de next | Available |
| Collections, records y la costura de criterion | Available |
Dedup de Entity sobre (kind, dedup_key) | Available |
playbook_slug en driftless_project | Not available (setéalo desde la CLI o API) |
Ejecución del validate de una card en el servidor | Not available (solo reportar y exponer) |
Relacionado
- Proyectos, Colecciones - los conceptos.
- Continue a project across agents, Operate a Collection - los workflows.
- CLI: Projects, CLI: Collections - la superficie de terminal.
- MCP & OAuth - setup, auth y scopes.