fs.changes - Mesa Docs

fs.changes operates on the mounted filesystem checkout. For REST-level change creation and patching, use mesa.changes.

from mesa_sdk import repo

async with mesa.fs(
    layout={"/workspace": repo("app", mode="rw")},
    authors=[{"name": "Workspace Agent", "email": "agent@example.com"}],
).mount() as fs:
    change_id = await fs.changes.new("app", bookmark="main", message="Cool new feature")
    await fs.write("/workspace/feature.py", b"print('hi')\n")
    current = await fs.changes.current("app")

Methods

async -> str

Create a new change forked from a bookmark or existing change. Exactly one of bookmark or change_id must be supplied. Pass message to set the new change description; None omits it and creates the change with no description.

async -> str

Check out an existing change. This never creates a new change. Exactly one of bookmark or change_id must be supplied.

async -> list[ChangeInfo]

List changes reachable from the current checkout, most recent first.

async -> ChangeInfo

Return the currently active change for a mounted repo.

ChangeInfo

str

Mesa change ID.

str

Git commit OID for the change snapshot.

Errors

Raises MesaBadInputError if the source bookmark or change does not exist. checkpoint() raises MesaBadInputError when the current checkout is not on a bookmark, or MesaTransientError when another client moved the bookmark mid-checkpoint. Catch MesaTransientError to handle retryable failures, or MesaFileSystemError to catch every classified filesystem failure. See Error model.

​Methods

​ChangeInfo

​Errors

Methods

ChangeInfo

Errors