Libros de jugadas

1. Lea el recurso de equipos cuando el contexto del espacio de trabajo sea importante. Si no puede leer recursos, use epismo_team_list.
2. Use epismo_playbook_resource_list cuando un tipo de recurso pueda acotar el espacio de descubrimiento.
3. Encuentre candidatos con epismo_playbook_search; pase resourceKind y resourceRef juntos para una lista filtrada por recursos, o use una consulta de texto en su lugar.
4. Lea la última definición con epismo_playbook_get, que también devuelve las sugerencias abiertas del playbook, las versiones recientes y los alias en la misma lectura (gratis para un playbook público, 1 crédito en los demás casos).
5. Fije el trabajo reproducible con epismo_playbook_version_get.
6. Valide la entrada y adapte los pasos al plan del tiempo de ejecución del agente.

Un paso no es una tarea. El agente podrá omitir, combinar o reordenar pasos. Las sugerencias de recursos son candidatos, no comandos de instalación; verifique el permiso, la confianza y las credenciales antes de su uso.

epismo_playbook_create / epismo_playbook_version_publish / epismo_playbook_access_get / epismo_playbook_access_set

Playbooks y Casos tienen una cuenta propietaria de Usuario o Espacio de trabajo (ownerId), que también paga su uso. El propietario personal tiene todos los derechos; los Owners y Admins actuales ejercen esos derechos para un Espacio de trabajo. Los demás miembros necesitan permisos explícitos de usuario o Equipo, o visibilidad pública para leer contenido publicado. La membresía por sí sola no concede acceso. Al eliminar un miembro, se revocan sus permisos directos sobre los recursos propiedad de ese Espacio, incluidos los completados y archivados. Si la eliminación dejara algún recurso sin editor explícito, añada primero otro usuario o equipo editor, incluidos los recursos completados o archivados. Se conservan los permisos sobre recursos personales y de otros Espacios. Los permisos de Equipo y administración dependen de la membresía actual. El SSO obligatorio se aplica a los miembros; los usuarios externos con permisos directos usan la autenticación normal de Epismo. El acceso de Equipo entre espacios verifica el SSO del espacio de participación. Los listados usan permisos explícitos y la visibilidad pública admitida; la propiedad por sí sola no incluye un recurso.

Los lectores pueden leer contenido compartido, pero no editar; los borradores requieren edición. Los editores pueden cambiar contenido y permisos, conservar al menos un editor explícito al cambiar permisos, archivar y restaurar. Transferir la cuenta propietaria, cambiar el mantenedor, eliminar Casos definitivamente y archivar versiones históricas requieren derechos de propietario. assignedTo indica responsabilidad sin conceder acceso. Un nuevo responsable o mantenedor debe tener edición y, en recursos del Espacio, pertenecer a ese Espacio. Reasignar conserva los permisos; transferir la propiedad no añade automáticamente al antiguo propietario como editor.

Una superficie de creación itera mediante un borrador en lugar de publicar cada intento: epismo_playbook_draft_save para guardar (con baseRevision, no una clave de idempotencia), epismo_playbook_draft_get para volver a leerlo y epismo_playbook_draft_publish o epismo_playbook_draft_discard para finalizar. Un borrador sigue el acceso de edición del playbook; los lectores públicos y los enlaces compartidos no pueden leerlo.

La configuración explícita de creación y los cambios de acceso usan access: { visibility, grants }: visibilidad restricted/public y claves UUID de usuarios o equipos, o correos de usuarios registrados, con valores viewer/editor. Los correos se resuelven a UUID antes de guardar; las respuestas usan UUID. Un correo no registrado o roles en conflicto para el mismo usuario resuelto rechazan toda la operación. Cada cambio reemplaza el objeto completo; conserve los permisos ajenos al cambio e incluya el suyo si desea mantenerlo. Los propietarios conservan la gestión independientemente de los permisos. Los responsables y mantenedores no reciben acceso implícito. Los editores pueden consultar y reemplazar permisos, conservar al menos un editor explícito al cambiar permisos, archivar y restaurar. El JSON normal omite mapas privados; los editores pueden obtenerlos con access-get. Consulte Acceso e identidad.

Copie una versión publicada legible para adaptarla de forma independiente. La copia tiene contenido y versiones propios; no hereda permisos, borradores, Casos, sugerencias, alias, estrellas ni historial, y las ediciones nunca se sincronizan. Elija los permisos explícitamente; omita ownerId para usar el Espacio activo o su cuenta personal. copiedFrom registra el origen inmediato y su versión inmutable; sourceAccessible indica si aún puede leerlo. Las listas muestran solo copias legibles. Copiar cuesta lo mismo que crear un Playbook.

epismo_playbook_copy / epismo_playbook_copies_list

Propiedad, responsabilidad y ciclo de vida

Omita ownerId al crear o copiar para usar el Espacio de trabajo activo, o su cuenta personal si no hay uno seleccionado. La selección explícita también requiere autorización. Cuando hay un Espacio seleccionado, incluido el predeterminado de la conexión, la creación requiere exactamente una opción: private: true, teamIds no vacío o access. En el espacio personal puede omitirse la configuración. El permiso de edición del Equipo cubre al creador sin añadir un permiso directo redundante; se conserva un permiso directo solicitado explícitamente. Mantener o tener asignado un recurso no sustituye los permisos.

Los editores y propietarios pueden archivar y restaurar el Playbook. Liste los archivados sin consulta de texto con archived=true (playbook list --archived o epismo_playbook_search) y restaure con playbook restore o epismo_playbook_restore. Se conservan versiones, permisos y mantenimiento. Los propietarios pueden cambiar al responsable con playbook assign --assigned-to o epismo_playbook_assign, sin conceder acceso. Archivar versiones históricas sigue requiriendo propiedad; la última versión no se puede archivar.

En la vista web de Playbooks archivados, un propietario puede eliminar definitivamente un Playbook archivado solo si ningún Caso lo referencia (incluidos los completados o archivados) y ningún otro Playbook se copió de él. La operación es irreversible. Las operaciones de archivo y restauración de CLI y MCP no realizan una eliminación definitiva.

Las Sugerencias pertenecen al Playbook padre actual y no tienen propietario ni permisos históricos independientes. authorId identifica al creador y baseVersionId conserva la referencia de contenido inmutable para evaluar la mejora. La lectura requiere acceso actual al padre; archivarlo oculta sus Sugerencias hasta restaurarlo. Los autores pueden editar sus propuestas abiertas mientras mantengan acceso; los editores actuales del Playbook pueden adoptar o rechazar propuestas. Tras una transferencia, las propuestas existentes siguen los permisos actuales del padre. Publique el resultado antes de marcar la propuesta como aplicada.

La asignación de Playbooks usa assignedTo, como la de Casos, y mantiene assignedTo en las respuestas. Use epismo_playbook_assign, playbook assign <playbook-id> --assigned-to <user-id> o PATCH /v1/playbooks/{playbookId}/assignee. Requiere propiedad y edición previa para el destinatario.