Glossary
Accepted terms
Browse the vocabulary. Names lead; identity fields are secondary metadata and are not authorization.
| Term | Identity | Status | Definition |
|---|---|---|---|
| Project | project_id | accepted | A durable named collaboration and policy scope. A Project outlives any single workspace, host conversation, or WorkSession and is the unit that people and systems recognize as "the work we keep doing together." |
| ProjectSnapshot | project_snapshot_id | accepted | An immutable resolved project definition at an exact revision. It is the pinned meaning of a Project that a WorkSession actually ran against. |
| WorkProfile | work_profile_id | accepted | A reusable blueprint for a kind of WorkSession. It describes intended participants, resource shapes, and task patterns without being a live episode of work. |
| Resource | resource_id | accepted | An independently addressable thing relevant to work. A Resource is not necessarily owned by a Project; projects and sessions observe or bind it. |
| ResourceBinding | resource_binding_id | accepted | A WorkSession-specific resolution and grant for a Resource. The binding records how this session names, locates, and is allowed to use the Resource without becoming a second owner of it. |
| Workspace | workspace_id | accepted | A Resource subtype that provides a material working environment (files, checkout, container, or equivalent). A Workspace is not a WorkSession. |
| WorkSession | work_session_id | accepted | A bounded episode of work that coordinates resources and participants. A WorkSession may contain many AgentRuns and ResourceBindings. It is never an MCP connection and never a host chat transcript. |
| AgentProfile | agent_profile_id | accepted | A declarative description of an eligible kind of agent. It names capabilities, constraints, and intended roles without identifying a running process. |
| AgentInstance | agent_instance_id | accepted | A running process or remote endpoint capable of executing RunAttempts. An AgentInstance is not an assignment and is not a Principal. |
| AgentRun | agent_run_id | accepted | One agent's bounded assignment within exactly one WorkSession. An AgentRun may contain Turns and RunAttempts. This is the accepted term that replaces the ambiguous phrase "agent session". |
| RunAttempt | run_attempt_id | accepted | One infrastructure execution attempt for an AgentRun. Failures, retries, and instance replacements produce new RunAttempts under the same AgentRun. |
| Turn | turn_id | accepted | One input-to-output or control-yield cycle inside an AgentRun. A Turn is smaller than a RunAttempt and is not a HostConversation. |
| HostConversation | host_conversation_id | accepted | Conversation history owned by a host product such as Goose, Hermes, or Crush. A HostConversation may attach to a WorkSession but is not the WorkSession. |
| Task | task_id | accepted | A schedulable unit in a WorkSession task graph. A Task is not necessarily one-to-one with an AgentRun. |
| Artifact | artifact_id | accepted | A durable explicit output published by a Task or AgentRun. An Artifact is not private reasoning, scratch, or an unpublished tool side effect. |
| Principal | principal_id | accepted | An authenticated human, service, or agent identity. A Principal is not an AgentInstance and is not an assignment. |