Cases

Use epismo_case_start when an outcome must be shared or resumed. Start from a Playbook Version or create an ad hoc Case with a title.

• Keep local intermediate work in the agent runtime.
• Append outcomes, decisions, and handoffs with epismo_record_append.
• Create Tasks with epismo_task_create only for explicit responsibility or review.
• Generate a fresh idempotency key for each new mutation.
• Read the latest lock version before changing a Case or Task.

After a conflict, re-read the object and decide whether the intent remains valid. Never replay a stale request by changing only its lock version.

Do not invent an agent assignee. When a User assignment is needed, select an ID from the users resource and ensure that User is already in the Case ACL.

Use epismo_record_list without a Case filter to resume from an ACL-scoped activity feed across readable Cases. Add filters only to narrow that feed; an ACL filter is not authorization.