DelegationTemplate

The reusable request fields. RunId, executing device, and document version pins exist only for one claimed firing and cannot be stored here.

Type object

Shape

Field	Type	Description
requested_byrequired	ActorRef
objectiverequired	Objective	What a person asked the agent to do (D9). The one field of a run that is a prompt, and therefore the one field that must never be reported.
agentrequired	SessionProfileKey	Stable identity for a launch profile. Built-ins remain readable across machines; user-created profiles are opaque UUIDs.
requested_model	DelegateModelName or null
scoperequired	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.
grants	array of WorkspaceId	Default `[]`
context	array of ScheduleContextPointer	Default `[]`

Example

{
  "requested_by": {
    "profile": "00000000-0000-4000-8000-000000000000",
    "kind": "person"
  },
  "objective": "string",
  "agent": {
    "kind": "built_in",
    "value": "string"
  },
  "requested_model": "string",
  "scope": {
    "kind": "none"
  },
  "grants": [],
  "context": []
}

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.