scriptdraft

type Identity struct {
	UserID   string
	Email    string
	Roles    []string
	AuthType string
	Claims   map[string]any
}

type Outcome struct {
	// RunID identifies the run, and is also the session id every audit row the
	// run produced carries.
	RunID string
	// Result is the engine's record of the execution, present even when the
	// script failed.
	Result *scriptrun.Result
	// Err is the script's own failure — a Starlark error, a refused host call,
	// or a limit — and nil when it succeeded.
	Err error
}

type Request struct {
	// Source is the Starlark to execute. It is passed explicitly rather than
	// read from a record because the editor's whole purpose is running an edit
	// that has not been saved.
	Source string
	// Name labels the script in tracebacks.
	Name string
	// Params is the already-bound parameter set. Binding is the domain's
	// (script.BindParams) and happens before a Runner is involved, so a draft
	// and a platform run bind by one rule.
	Params map[string]any
	// State is the script's live state, read by the caller, handed to the
	// draft as run.state (#1537). A draft reads what a platform run created
	// now would read, and writes nothing back: what it would have saved is on
	// the outcome's result.
	State    map[string]any
	Identity Identity
	// AllowWrites lifts the engine's write barrier, letting the draft persist
	// through platform.call for real (#1664).
	//
	// It is off by default because a draft is a rehearsal: an author drafting
	// an ingestion script wants to exercise the landing pipeline without
	// landing, and a draft that forgot to ask for it left resources,
	// registrations and assets behind with no run record. It exists because the
	// rehearsal has a limit — a pipeline whose next step reads what the last
	// one created cannot be exercised without the create — and the person
	// making that call is the one who owns what it writes.
	AllowWrites bool
}

type Runner struct {
	// contains filtered or unexported fields
}

type ToolkitLister interface {
	All() []registry.Toolkit
}