limits

type Limits struct {
	// ErrorBody is how much of a failed HTTP response is kept to put in the error
	// message. It is small on purpose: the value is a diagnostic quotation, not the
	// answer, and the server it came from is already misbehaving.
	ErrorBody int64

	// Theme is a UI theme document — a small set of colours and names. Kept apart
	// from Settings because it is served to every page load.
	Theme int64

	// Registration is a self-service handshake body: an OAuth client registering
	// itself (RFC 7591), a node announcing itself. Deliberately the tightest budget
	// on an authenticated-optional path.
	Registration int64

	// Request is one ordinary JSON request or the answer of a peer Atlas: a user,
	// a FEEL evaluation, a folder, an OIDC claim mapping. The great majority of the
	// API lives here.
	Request int64

	// Settings is a configuration document a person edits: mock configuration, a
	// script's source with its sample variables, a public start form's payload.
	Settings int64

	// Asset is a binary a person uploads for display — a logo — or a generated form
	// answer holding one.
	Asset int64

	// Definition is a modelled artefact in JSON: a form, a collaboration session's
	// payload, a playground request, the answer of a service a process called.
	Definition int64

	// Generated is a document this server produced or is asked to render back:
	// a generated form request, a mail outbox post.
	Generated int64

	// ModelUpload is a BPMN, DMN or XOML document. Four megabytes is a diagram far
	// past what a person maintains by hand.
	ModelUpload int64

	// Payload is the largest thing that legitimately travels in one piece: a model
	// provider's answer, a playground model, a mock's journal, a script's output.
	Payload int64

	// DataUpload is tabular or scenario data: a CSV, a playground scenario.
	DataUpload int64

	// Import is a document imported from another tool — an information model, a
	// process documentation bundle.
	Import int64

	// AppBundle is an application's whole source or export.
	AppBundle int64

	// Archive is a backup or snapshot being restored, compressed *and* decompressed:
	// the same ceiling bounds both, so a small archive cannot expand past it.
	Archive int64

	// TokenSteps is how many element activations one token may drive in a single run
	// before the engine parks it with an incident — a *rate* budget, protecting the
	// single writer from a cycle of automatic elements (ADR-0272).
	TokenSteps int32

	// Iterations is how many iterations one multi-instance activity may ask for
	// before the engine refuses it — a *size* budget, protecting the allocation from
	// a number that came out of an instance variable (ADR-0276). Neither substitutes
	// for the other: a hundred thousand iterations are a hundred thousand tokens
	// taking one step each, which TokenSteps is deliberately built not to stop.
	Iterations int32

	// Variable is how large one process variable's value may be. A variable is a
	// business record — a customer, an order, the inputs of a decision. Anything
	// larger than this is a document, and a document does not belong in a token's
	// scope, where every touch rewrites the whole of it into the log
	// (ADR-0294).
	Variable int64

	// Collection is how large a multi-instance activity's assembled output collection
	// may be. It is a *separate* budget from Variable, and larger, because the two
	// bound different things: Variable asks what one record may weigh, Collection what
	// a legitimate loop at the iteration ceiling may accumulate. One number cannot do
	// both — the collection would have to be small enough to be no ceiling for a
	// record, or the record large enough to be no ceiling at all.
	//
	// It bounds the peak held in memory. It is deliberately *not* a bound on what the
	// loop writes: the collection is re-serialised once per iteration, so the bytes
	// written grow with the square of the iteration count, and a budget small enough
	// to make that safe would be smaller than Variable. That is a defect with its own
	// fix, not a number to hide in.
	Collection int64
}