OptionalidleIdle TTL in seconds (bounds: see workspace.utils): the workspace is reclaimed by GC after this long without use; every use pushes the deadline forward. Persisted last-write-wins; when absent, the workspace keeps its stored TTL (or the default — one day — for a new one).
OptionallocalReuses an existing pod-local directory without pulling the shared snapshot.
OptionalsignalCancels local synchronization before the caller loses ownership.
Options for WorkspaceClient.create.
Note the durability contract of the directory itself, which is separate from the GC TTL below: only WorkspaceClient.push makes local changes durable. The pod-local copy is evicted after 6 hours without a
create,push, or agent run, so a long-running job that writes files and pushes them more than 6 hours later loses whatever it had not pushed — unlike an expired tracked workspace, whose final push revives it. Push periodically for work that spans hours.