Type Alias StartRunOptions

Type Declaration

• OptionalattemptToken?: string

  Host correlation token for this execution leg.

• OptionaldeadlineMs?: number

  Relative run deadline, measured from this start.

• OptionaleconomicOperations?: readonly RunEconomicOperation[]

  Trusted settlement projection; never accepted by the public run router.

• OptionalinitialState?: unknown

  Schedule-target or ordinary trusted-start state.

• OptionalinputData?: unknown

• runId: string

  Required: the runtime never generates a runId. Hosts mint it server-side (createRunRouter) so a client can never choose the identity a run is keyed by everywhere it lands. A generation fallback here would let any caller that forgets to mint create a run under an id the host never issued.

  A run id is single-use: never start one again, even after retention removed its run. start refuses an id only while its run's row exists, and a leg of the earlier run still running on another instance keeps running against the later run until its next write is refused.

• OptionalscheduleDispatch?: RunScheduleDispatch

  Trusted schedule source; never accepted directly from a public request.

• OptionalstoredRequestContext?: Record<string, unknown>

  Non-reserved context supplied by a trusted host start or a verified schedule target.

• {
      requestedBy: string;
      requestedByKind: "human" | "service" | "agent" | "system";
  }

  • requestedBy: string

    Trusted requester id persisted with the authoritative run snapshot.

  • requestedByKind: "human" | "service" | "agent" | "system"

    Trusted requester kind persisted alongside requestedBy.

• { requestedBy?: undefined; requestedByKind?: undefined }