scriptlayer

type Config struct {
	// DB backs the script store; nil leaves the store nil and manage_script
	// unregistered (there is nowhere to keep a script).
	DB *sql.DB
	// Store, when non-nil, is used directly instead of building a Postgres
	// store from DB. Production passes DB and leaves this nil.
	Store script.Store
	// Runs is the run queue run_script enqueues onto and the run history the
	// run commands read. nil leaves run_script unregistered, which is the
	// correct shape for a deployment that cannot execute scripts at all.
	Runs script.RunStore
	// AdminPersona is the persona name that grants authority over every
	// script; matched against the caller's persona in each command.
	AdminPersona string
	// PortalURL is the deployment's public portal address, used by show_scripts
	// to name where the script pages are. Empty leaves the tool registered and
	// linkless: a deployment that has not been told its own address cannot be
	// given one by guessing.
	PortalURL string
	// Destinations is the deployment's configured bucket destinations, which a
	// draft run resolves platform.export names against exactly as a platform
	// run does.
	Destinations []script.Destination
	// Toolkits is the live toolkit registry a draft's write barrier reads the
	// api gateway's operation ids and an MCP gateway's proxied-tool
	// declarations through (#1664). Nil leaves the barrier classifying from
	// its declared table alone, which refuses both of those forms.
	Toolkits scriptdraft.ToolkitLister
	// DraftExports builds the writer a draft run with allow_writes persists
	// its exports through (#1822). Nil leaves every draft export a preview.
	DraftExports scriptdraft.Exports
	// RunLimits are the ceilings a platform run executes under on this
	// deployment, which the help reports so an author sizes a script against
	// the limits it will actually meet (#1843). Zero fields are the defaults.
	RunLimits scriptrun.PlatformLimits
	// Recordings keeps what each run and draft's host calls were answered, for
	// a script's tests and a save's replay (#1939, #1942). Nil builds one over
	// DB.
	Recordings scriptrec.Store
}

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

type KnowledgePage struct {
	// Slug is the page's reconcile key and the only identifier stable across
	// deployments: a built-in page's row id is generated at reconcile time, so
	// it differs per deployment and cannot be named in shipped text.
	Slug string `json:"slug"`
	// Reference is the slug in the form fetch takes.
	Reference string `json:"reference"`
	// Summary says what the page answers, so an author fetches the one that
	// bears on the decision in front of it rather than all of them.
	Summary string `json:"summary"`
}