@agent-os/workspace-session
Purpose
Section titled “Purpose”Provider-neutral workspace/session lifecycle carrier.
Invariant
Section titled “Invariant”ScopeRef(kind: "session") names the ownership class. Retention, preview,
backup, workspace root, and cleanup refs are payload metadata and proof refs,
not new scope kinds.
Bounded exec runs inside an existing session and returns capped output refs; it
does not create background process lifecycle facts.
Minimal Usage
Section titled “Minimal Usage”Use the carrier to settle start, restore, backup, preview, destroy, and failure
facts. Use a backend package to obtain provider-specific refs.
Use WorkspaceSessionCarrier.exec for one bounded command inside an existing
session. Store any transcript or artifact refs in the app/tool layer that asked
for the exec; the workspace-session ledger remains lifecycle-only.
Verification
Section titled “Verification”cd packages/carriers/workspace-sessionvp test run