Term
Workspace
A Resource subtype that provides a material working environment (files, checkout, container, or equivalent). A Workspace is not a WorkSession.
Purpose
Name the environment in which work is performed so it can be bound into a WorkSession without being confused with the episode of work itself.
Relationships
| Name | Target | Kind | Cardinality | Inverse |
|---|---|---|---|---|
as_resource | Resource | specializes | 1 | workspace_form 0..1 |
bound_in | ResourceBinding | observes | 0..* |
Invariants
- MUST
is-a-resource: A Workspace MUST be independently addressable as a Resource. - MUST NOT
not-a-session: A Workspace MUST NOT be treated as a WorkSession or as an MCP connection. - MUST NOT
not-the-project: A Workspace MUST NOT be treated as the Project.
Aliases
working-environment
Deprecated aliases
None.
Not synonyms
- WorkSession: The session coordinates work; the workspace is one bound environment.
- Project: The project is the durable policy scope, not a checkout or container.
- HostConversation: Chat history is not a working environment.
Examples
- A git worktree used by one WorkSession.
- A container filesystem mounted for an AgentRun.
Anti-examples
- The host product's chat transcript.
- An MCP stdio connection.
Fields
The identity field is the index of the handle. fields is the exchange shape.
| Name | Kind | Type | Portable | Notes |
|---|---|---|---|---|
workspace_id | identity | name | True | |
resource_id | reference | name | True | |
environment_kind | descriptive | string | True |
Native mapping hooks
| System | Native term | Fidelity | Notes |
|---|---|---|---|
project-interop | _none_ | tbd |