WorkspaceScope

The working folder a run is admitted to (P1.5) and started in.

Identity is a [ProjectId] rather than a path: the project already carries a canonical root the host validates at launch, and an id is what a second device can name without being able to resolve it (D15, D16). The folder inside it is text a person chose, and is redacted like every path.

`None` is unreachable at admission. It exists so a request can be built before a scope is chosen and so the modal has a state to refuse; P1.5 makes it impossible to start a run with it. M4 adds git shapes - a worktree per run - as new variants, which is why this is an enum.

Type object or object or object or object

Shape

One of 4 shapes:

kind: "none"
No scope chosen. Refused at admission (P1.5), never started.
Field Type Description
kindrequired "none"
kind: "project_root"
The root of a session project.
Field Type Description
projectrequired ProjectId
kindrequired "project_root"

Field	Type	Description
kindrequired	"none"

kind: "project_folder"

A folder inside a session project's root.

Field	Type	Description
projectrequired	ProjectId
folderrequired	RelativeFolder	A folder inside a working scope's root, as a person typed or chose it. A path is private (standing requirement 7); the host canonicalizes it at admission and this type only bounds and hides it.
kindrequired	"project_folder"

kind: "temporary"
A directory Koru creates for this run alone and owns (D37 names it: an unregistered result there survives as long as the run does).
Field Type Description
kindrequired "temporary"

Field	Type	Description
kindrequired	"temporary"

Example

{
  "kind": "none"
}

The contract has no example values, so example bodies are generated from each schema: every field is shown with a placeholder of its type.

Generated from contract version 1. Last updated November 12, 2026.