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).
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.