A draft soul is body, summary, and monotonic version evidence.
The Panonomous soul document is the public contract for the text Ptah authors before a child agent's
interface is published. It mirrors the minimal AgentSoul evidence: agent_soul_upsert accepts an
agent_id, required body, and optional summary; successful writes create
draft-only, versioned records.
Stable schema URL:
/contracts/panonomous/soul-document/v1/schema.json
Normative v1 fields
| Field | Requirement | Semantics |
|---|---|---|
agent_id | required | Route-local child-agent selector. Ptah-created Lesser actors must also satisfy the naming vocabulary. |
body | required; non-blank; 49,152 UTF-8 bytes max | Markdown-friendly first-person steward framing used verbatim as the soul body. |
summary | optional; non-blank when present; 2,048 UTF-8 bytes max | Short inventory-facing description. |
soul_version | server-assigned | Positive integer incremented by one for each successful draft upsert. |
lifecycle_state | server-assigned | agent_soul_* tools expose draft content only; publishing is a separate operation. |
Sectioning
V1 intentionally defines a single plain-text body. Implementations may render Markdown headings
for humans, but no machine-readable section list is normative in this contract.