@agent-os/workspace-op

Purpose

Provider-neutral workspace operation fact carrier for receipt-backed workspace mutations.

Public API Status

0.5.x active development. Public exports are listed in PUBLIC_API.md to prevent accidental exports; they are not frozen.

Invariant

Workspace-op owns request, completion, rejection, settlement, and projection vocabulary for workspace operations. It does not execute filesystem or shell effects. Providers execute requests and return completed or rejected facts with the required external receipt proof.

Minimal Usage

Emit a workspace_op.requested fact for a write-capable workspace tool. A provider consumes that request and commits either a completed fact with an external_receipt anchor or a rejected fact with a rejected claim. Consumers read projectWorkspaceOperation instead of interpreting provider output directly.

Verification

cd packages/carriers/workspace-op
vp test run