Skip to main content

Module value_objects

Module value_objects 

Source
Expand description

Value objects for the MADE domain.

Every public function in the domain exchanges value objects instead of primitives. Each value object validates its invariants on construction and cannot be mutated afterwards.

Structs§

AgentId
Identifier of an Agent within MADE.
AgentKind
AgenticSystemDigest
SHA-256 identity of one revision of an agentic system design.
AgenticSystemExecutionId
Identifier of one run of a composed agentic system.
AgenticSystemId
Identifier of one agentic system design, stable across every revision of it.
AgenticSystemPageLimit
How many designs one page of a catalogue holds.
AgenticSystemRevision
Which edition of one agentic system design this is.
AgenticSystemValidationFinding
One defect found while analysing an agentic system design.
ArtifactDigest
Canonical SHA-256 content digest, including its algorithm label.
ArtifactId
Stable opaque identity for artifact metadata, never a path or URL.
ArtifactImportRef
Opaque reference to the source of imported artifact metadata.
ArtifactMediaType
Canonical media type without parameters.
ArtifactProvenance
Typed origin of artifact metadata. Authentication joins in C5.7.
ArtifactRef
Verifiable artifact metadata. It never contains storage coordinates or bytes.
ArtifactSizeBytes
Exact number of bytes covered by an artifact digest.
AttentionEventId
Stable identity of one projected reason to look at a ceremony.
AttentionPolicy
What an integrator asked to be told about, and how insistently.
AttentionReason
Why a ceremony is asking for the integrator’s attention.
AttentionSummary
What a host is told about the attention behind a delivery.
Attributes
AuditActor
Who caused an audited fact.
AuditActorId
The identifier a caller uses for the party behind an audited action.
AuditRecordHash
SHA-256 digest binding one audit record to the one before it.
AuditSequence
Position of a record within one ceremony’s audit journal.
AuthenticatedPrincipal
AuthorizationDecision
AuthorizationDecisionId
AuthorizationDecisionPageLimit
AuthorizationDecisionPlan
AuthorizationDecisionTtl
AuthorizationEvidence
AuthorizationGrant
AuthorizationGrantId
AuthorizationGrantIssuer
AuthorizationKeyRing
AuthorizationPolicyId
AuthorizationPolicyVersion
AuthorizationRequest
AuthorizationRequestId
AuthorizationRevocation
AuthorizationRevocationReason
AuthorizationTargetDigest
AuthorizedOperation
Full authenticated identity and allow evidence for one admitted operation.
BudgetAccountId
BudgetBalance
BudgetLedgerVersion
BudgetLimits
BudgetOperationId
BudgetPageLimit
BudgetQuantities
BudgetReconciliationId
BudgetReservation
BudgetReservationEstimate
Pre-execution reservation plan supplied by a host or handler.
BudgetReservationId
BudgetReservationPolicy
Reservation bounds are explicit in every dimension, including zero cost. Unlike an absent account limit, a zero policy ceiling prohibits consumption.
BudgetReservationPolicyVersion
Version of the host’s declared reservation-estimation policy.
BudgetReservationRequest
Semantic input a host or handler uses to estimate one operation before it is claimed.
BudgetTokenCount
Capability
Something a participant can do, named the way hosts name it.
CarriedEvidence
One completed step of a predecessor, carried into a successor step.
CeremonyAgentExecutionId
Stable identity of a logical worker’s execution within one ceremony.
CeremonyChildSpawn
CeremonyChildSpec
CeremonyComposition
One ceremony this system composes, referenced and never owned.
CeremonyContext
CeremonyDeadline
CeremonyDefinitionChange
One classified change between two ceremony definitions.
CeremonyDefinitionDiff
Everything that differs between two definitions of one ceremony.
CeremonyDefinitionDigest
SHA-256 identity of a published ceremony definition.
CeremonyDescription
CeremonyEventConsumer
Stable name of one independent consumer of the global ceremony-event feed.
CeremonyEventCursorAttempt
Delivery failures already recorded at a consumer’s next position.
CeremonyEventCursorLease
Exclusive, expiring right to process one named cursor.
CeremonyEventCursorLeaseId
Unique token proving ownership of one cursor lease.
CeremonyEventPageLimit
Validated size of one ceremony-event page.
CeremonyEventQuarantineReason
Operator-visible reason a consumer stopped retrying one event.
CeremonyEvidenceSourceId
CeremonyExecutionLink
What became of one composed ceremony inside one run.
CeremonyGuard
CeremonyGuardApproval
A human guard, and who let it through.
CeremonyGuardDeferral
CeremonyGuardDeferralContent
CeremonyId
CeremonyIdPrefix
A literal, case-sensitive prefix for ceremony identifiers.
CeremonyInputDefinition
CeremonyInstancePageLimit
Maximum number of ceremony instances returned by one public page.
CeremonyInterventionContent
CeremonyInterventionId
CeremonyInterventionPageLimit
How many interventions one page of a listing may carry.
CeremonyInterventionProvenance
CeremonyInterventionResponse
CeremonyLifecycle
CeremonyLineage
CeremonyName
CeremonyOutputDefinition
CeremonyOutputRef
One output of one composed ceremony, named from outside it.
CeremonyParticipantBinding
Who sits in a role’s seat for one working session.
CeremonyProgressWait
How long a progress request waits for another sealed event.
CeremonyReason
Why one thing a session produced led to another.
CeremonyReasonRationale
The caller’s explanation for a causal link between ceremony records.
CeremonyRevision
How many times a ceremony instance has been committed.
CeremonyRole
CeremonyState
CeremonyStep
CeremonyStepContribution
One intervention produced during a ceremony step.
CeremonySuccession
Which ceremony this one succeeds, as the successor’s own opening records it.
CeremonyTimeout
CeremonyTranscript
The ordered list of contributions accumulated during a ceremony.
CeremonyTransition
CeremonyTransitionRecord
One move a session made, and who made it.
CeremonyValidationFinding
One defect found while analysing a ceremony definition.
CeremonyValidationReport
The complete outcome of analysing a ceremony definition.
CeremonyVersion
The version of a working session’s definition.
ChannelName
Where one collaboration happens, in the host’s own vocabulary.
ChildCeremonyId
ChildCompletionRef
ChildDepth
ChildDepthBudget
ChildGroupId
ChildGroupState
ChildPosition
ChildQuorum
ChildSpawnCoordinates
ChildSpawnPlan
ChildrenCompletedCondition
ClaimDisposition
What a plan says about one outstanding claim, against the exact claim it observed.
ClaimText
Claim text submitted to the evidence-support decision port.
CollaborationLink
One arrow of the topology: who works with whom, and in what way.
ContextKey
A top-level key in ceremony context.
ContextPatch
An atomic set of top-level ceremony-context replacements.
ContextWrites
Declared copies from top-level step output fields into ceremony context.
CostMicros
CouncilContractId
Stable identity of the council contract attached to a task.
CouncilId
Identifier of a council (group of agents for a given specialty).
CouncilJournalConsumer
Stable name of one independent consumer of the council journal.
CouncilJournalLease
An exclusive council-consumer lease. Its identity is issued by the store.
CouncilJournalLeaseId
Unique token proving ownership of one cursor lease.
CouncilJournalPageLimit
Validated size of one council-journal page.
CouncilJournalPosition
An ordinal in the council journal. It cannot be a ceremony cursor.
CouncilSnapshotSource
Operator-supplied provenance label for an imported council snapshot; never a credential URL.
CritiqueFeedback
Peer-review feedback returned by an agent.
CurrencyCode
DefinitionPin
An immutable reference to one published ceremony definition.
DelegationDepth
DeliveryAttempt
How many times a delivery has been handed out and come back failed.
DeliveryAttemptLimit
How many failed attempts a delivery is worth before it stays failed.
DeliveryFailureReason
Why a delivery did not reach the host, or was refused by it.
DeliveryHistory
The recent states of one delivery, oldest first.
DeliveryHistoryEntry
One state a delivery passed through, and when.
DeliveryNote
What a host said about a delivery it observed, in its own words.
DeliveryRecipient
The one live agent an intervention was put in front of.
DurationMs
A duration measured in whole milliseconds.
DynamicRoleBinding
A role selected from ceremony context at claim time.
EventId
Identifier of a domain event as emitted by MADE.
EventSchemaVersion
Version of a ceremony event’s payload shape.
EvidenceBody
Non-empty evidence excerpt made available to a support judge.
EvidenceExcerpt
One typed evidence excerpt presented to a support judge.
EvidenceGroundingRule
Field shape and evidence pack required to ground structured claims.
EvidenceReference
Identity of one evidence item cited by a claim.
ExecutionConnectorId
Stable configured identity of an execution connector.
ExecutionDuration
ExecutionId
Stable identity assigned by an execution adapter.
ExecutionIntent
Durable declaration written immediately before one claim calls a connector.
ExecutionOperation
Semantic operation root shared by every technical claim that may execute it.
ExecutionOperationId
Stable identity of one semantic external operation.
ExecutionOutcome
Final result returned by an execution adapter.
ExecutionProfile
Host-owned execution selection recorded with a claimed step.
ExecutionReceipt
Immutable terminal observation of one semantic external operation.
ExecutionReceiptId
Deterministic identity of the sole terminal receipt for an operation.
ExecutionReceiptLink
Immutable reference sealed beside the step result that consumed a receipt.
ExecutionReconciliationRequirement
Durable evidence that a connector actually reported an unresolved effect.
ExecutionRecoveryCursor
Opaque keyset cursor for scanning execution operation roots.
ExecutionRecoveryPageLimit
Bounded number of execution operations returned by one recovery scan.
ExecutionRequestBytes
Canonical semantic input sealed before an external operation starts.
ExecutionRequestDigest
Digest of the semantic request bytes sealed by the first intent.
ExternalOperationId
Opaque operation identity observed from an external connector.
FiniteMetricValue
A metric sample value proven to be finite.
GlobalPosition
Where a sealed record sits in the order every stream shares.
GuardName
GuardRef
One guard of one composed ceremony, named from the system above it.
HostActivationEnvelope
What an activated host is told, and the whole of it.
HostActivationReceipt
Proof that an activation adapter handed the envelope over.
HostAddress
Opaque address of a host destination: a session, a task, a queue.
HostAgentIncarnation
Opaque generation of a host executor; changes when that process is replaced.
HostDeliveryId
Stable identity of one item’s delivery to one host destination.
HostDeliveryLease
Exclusive, expiring right to deliver one item to one host.
HostDeliveryLeaseId
Fencing token of one exclusive, expiring right to deliver.
HostDeliveryObservation
What a host reported about a delivery it was handed.
HostDeliveryPolicy
The terms one delivery is offered under.
HostDeliveryRecord
One item’s journey to one host destination, as the ledger holds it.
HostDeliveryTargetKey
The stable spelling of a delivery destination.
HostDestination
Where an integrator lives, in terms the engine keeps opaque.
HostHandoffDeclaration
Evidence supplied by an authenticated host about one exact accepted producer. Incarnation is the host’s stable worker/task invocation identity, not a new fence.
HostKind
Which sort of host a destination is, as the operator configured it.
HostTransportRef
What the activation transport called the hand-off, for correlation.
IdempotencyKey
IndependenceGroup
A set of participants that count as one party when independence is judged.
IndependenceRule
A demand that one role’s work be judged by somebody other than whoever did it.
InputName
IntegratorBinding
One integrator’s standing claim to drive a ceremony or a system run.
IntegratorBindingId
Identity of one integrator’s binding to a ceremony or a system execution.
IntegratorFence
Monotonic generation of an integrator binding within its scope.
IntegratorScopeKey
The stable spelling of what a binding is scoped to.
InterventionDeliveryAck
The sealed proof that a named agent saw a named intervention.
InterventionDeliveryPolicy
The terms an intervention is offered to a host under.
InterventionRoleIds
Nonempty scoped recipients. Empty boundary lists mean the whole table instead. Historical deserialization remains tolerant so journal replay is unchanged; constructors and aggregate command validation enforce the current limits.
JoinStepCount
LateStepResult
LeaseOwnerId
LifecycleReason
LogicalParticipant
Somebody or something the system expects to take part, described by what it must be able to do rather than by who it is.
LogicalWorkerId
Identity of a ceremony participant independent of the host executor.
LoopLimits
How long an integrator’s loop may go round before it stops itself.
LoopProgressMark
Where one integrator’s loop had got to the last time it asked.
LoopRound
How many rounds of one looping composition a run has already done.
LoopRoundLimit
A count of rounds an integrator’s loop is allowed.
LoopRounds
How many times a looping composition may run before the loop ends.
MaxBounces
Maximum number of times one exact declared edge may be applied.
MaxChildDepth
MaxChildren
MaxParallel
MaxTransitions
Maximum number of transitions one ceremony instance may apply.
MeasuredBudgetQuantities
MemoryCapabilities
What a memory backend can actually do.
MemoryEntry
One thing worth remembering.
MemoryEntryId
What an entry is called, so something else can point at it.
MemoryEvidence
Something that backs an entry up.
MemoryMoment
A point to read memory as of.
MemoryProvenance
Who says so, and when they saw it.
MemoryRelation
Why one remembered thing led to another.
MemoryScope
What a memory is about.
MemoryWrite
What a session is handing to memory in one go.
MetricHelp
Human-readable Prometheus family help text.
MetricLabelName
A Prometheus label name.
MetricLabelValue
A Prometheus label value.
MetricName
A Prometheus metric or sample name.
ModelName
The model a design asks for, never the one that ran.
NumAgents
Number of agents participating in a deliberation. Must be at least one — a deliberation without agents has no meaning.
OutputContract
Typed structured-output contract attached to one invocation.
OutputContractId
Stable identity of a structured output contract.
OutputFieldGuardCondition
Exact structured-output predicate used by a ceremony guard.
OutputFieldRule
Validation rules for one named field in a structured output object.
OutputName
ParticipantBindingPolicy
What a logical participant needs from whatever plays it.
ParticipantId
One logical participant of the system: what a role is played by, before anybody knows which agent or person will turn up.
PlannedChild
PrincipalId
ProcessedActionRef
The act that closed a delivery, named so a repeat is recognisable.
PrometheusText
One complete Prometheus text exposition snapshot.
ProposalContent
Provider-authored proposal text.
ProposalId
Identifier of a concrete proposal produced during deliberation.
QuarantinedCeremonyEvent
One global-feed event a consumer deliberately skipped after retries.
QueueLimit
How many undelivered items one destination may hold before the oldest non-blocking one is dropped.
ReasoningEffort
How hard the design asks the host to think, in the host’s own vocabulary.
RecalledEntry
One thing an earlier session left behind, as a later one reads it.
RecollectionBudget
How much of what memory holds a session is willing to read at its opening, in bytes of summary.
ReconsiderationConditions
Distinct reasons to ask again. Constructors validate new commands; transparent deserialization retains previously accepted journal payloads without rewriting them.
RecorderName
The operational metrics recorder selected by a composition root.
RequestedExecutionProfile
What a role’s work asks of whatever executes it.
Responsibility
What one business role is answerable for.
RetryPolicy
RoleId
Rounds
Number of peer-review rounds performed during a deliberation.
Rubric
A rubric is a map of string keys to structured JSON-shaped values.
Score
A normalized quality score.
SemanticSupportRule
Evidence bodies and acceptance threshold for semantic support judging.
SeparationRule
SessionRecollection
What earlier sessions in this scope decided, as one session reads it when it opens.
SourceRecordRef
One sealed record of another instance, addressed exactly.
Specialty
A specialty label identifying a kind of agent expertise.
StateDeadline
StateId
StateIteration
One complete execution of every step in a ceremony state.
StateRepeatPolicy
Bounded repetition of every step in one ceremony state.
StateRepeatUntilCondition
The exact output predicate that stops repetition of a whole state.
StateTimeout
StateVisit
A durable entry into a state, independent of within-state repetition.
StepAttempt
StepClaimFence
Identity of exactly one accepted claim. It is a concurrency fence, not a credential.
StepDeadline
StepErrorMessage
StepExecutionRecord
StepHandlerConfig
StepHandlerKind
StepId
StepInstructions
The instruction text a ceremony stage gives its handler.
StepIteration
One semantic execution of a ceremony step.
StepLease
StepLeaseRenewalRequest
Stable identity and requested duration of one delegated heartbeat.
StepOutput
StepOutputField
Top-level structured output field inspected by a repeat stop condition.
StepRepeatExhaustedGuardCondition
Reference to the repeating step whose cap may route one transition.
StepRepeatPolicy
Bounded semantic repetition for a successful ceremony step.
StepResult
StepTimeout
StreamVersion
How many events a ceremony’s stream holds.
SuccessionPlan
The whole of a handoff, sealed in the predecessor before anything is opened.
SuccessorCeremonyId
The id of the successor a plan opens, derived from the plan itself.
SupervisionPolicy
What the system insists on beyond the ceremonies themselves.
SupervisorDisplayName
How a supervisor is named to the agent it interrupted.
SupervisorPrincipal
Somebody who may ask a question without holding a seat at the table.
SupportConfidence
Confidence percentage attached to an evidence-support decision.
SupportRationale
Explanation recorded alongside an evidence-support decision.
SupportVerdict
Evidence judge decision captured as domain values.
SystemCeremonyId
The name one composition goes by inside its system.
SystemPin
An immutable reference from a run to the design it is running.
SystemPurpose
Why the system exists, in the words of whoever asked for it.
SystemRole
A business role the system is described in terms of.
SystemRoleId
A business role inside an agentic system, such as the integrator or the reviewer.
TaskDescription
TaskId
Identifier of a task submitted for deliberation.
TokenUsage
Token counts reported by a model for a single call.
ToolCallCount
TraceContext
W3C traceparent shape. All components are lowercase hex.
TraceId
Validated W3C trace identity, without span-local context.
TransitionTrigger
UnavailabilityReason
Why a logical participant could not be materialized.
ValidationPassed
Whether the selected council decision passed its requested validation.
VerificationKey
VerificationKeyFingerprint
Fingerprint of a key, not key material. It is safe to persist in audit evidence and to compare between replicas.
VerificationKeyId
Public identifier for a verification key. Material never crosses this boundary; the host keeps private key bytes in its secret store.

Enums§

AgenticSystemLifecycle
How far along an agentic system design is.
AgenticSystemValidationLocus
The exact element of an agentic system design a finding refers to.
ArtifactSourceKind
What produced an artifact or execution receipt.
AttentionKind
Why a ceremony is worth the integrator’s attention.
AttentionOverflowPolicy
What a full attention queue does with the next item.
AuditActorKind
What kind of participant caused an audited fact.
AuditChainDefect
How a journal failed verification.
AuditChainVerdict
The outcome of verifying a ceremony’s journal.
AuditEventType
The audited fact a record states.
AuthenticationMethod
AuthorizationAction
AuthorizationDecisionKind
AuthorizationDenialReason
AuthorizationScope
BudgetDimension
BudgetDisposition
What a successor does about the ledger its predecessor was spending against.
BudgetMeasurement
CeremonyActivation
What makes one composed ceremony start.
CeremonyChangeImpact
Whether a definition change could strand an already-running ceremony.
CeremonyChangeKind
What happened to one element between two ceremony definitions.
CeremonyClaimPhase
Where one accepted claim stands when a report was taken.
CeremonyEndReason
CeremonyInterventionIntent
What a supervisor wants back from the agent it interrupted.
CeremonyInterventionKind
CeremonyInterventionStatus
CeremonyInterventionTarget
CeremonyLifecyclePhase
CeremonyOutcome
How a ceremony run terminated.
CeremonyReasonKind
How one thing a session produced explains another.
CeremonyRecordRef
Something a session produced that another thing can point at.
CeremonyStateKind
CeremonyStepAggregation
How a step consumes the completed outputs of the concurrent state immediately before it.
CeremonyValidationLocus
The exact element of a ceremony definition a validation finding refers to.
CeremonyValidationSeverity
Whether a validation finding blocks a ceremony definition or only warns about it.
ChildJoin
ClaimDispositionKind
What became of one outstanding claim when a successor was planned.
CollaborationKind
What one arrow between two participants means.
CouncilSelector
CursorTransition
DeliberationOutcome
The terminal result of a deliberation that ran to completion.
DeliveryExpiryCause
Why a delivery stopped being worth making.
Discrimination
How a scoring policy’s winner compares to the structural baseline.
DiversityPreference
Whether an agent should seek an intentionally different proposal.
ExecutionProfileFallbackPolicy
Host behavior when the requested execution profile is unavailable.
ExecutionProfileInheritance
Closed provenance categories for inherited host profile values.
ExecutionReceiptLinkKind
How a terminal receipt became bound to the claim that completed a step.
ExecutionRecoveryCapability
How a connector establishes what happened after an ambiguous interruption.
ExecutionState
Where a whole system run has got to.
ExecutionStatus
Final domain status of an execution attempt.
FollowReplacement
Whether pending work follows a destination that was replaced.
GuardCondition
HostActivationAdapterKind
Which activation adapter a deployment has, if any.
HostActivationMode
How a destination expects to be woken, as its binding declares it.
HostDeliveryItem
What is being delivered to a host destination.
HostDeliveryItemKind
Which kind of thing is being delivered to a host destination.
HostDeliveryMode
How a delivery is expected to reach its destination.
HostDeliveryObservationKind
What the host said when it was handed a delivery.
HostDeliveryState
Where one delivery has got to, and what it carries there.
HostDeliveryStateKind
The name of a delivery’s state, without what the state carries.
HostDeliveryTarget
Where one delivery is addressed.
HostWorkState
An external host declaration, never an engine inference of process liveness.
InputRequirement
IntegratorScope
What an integrator is bound to.
LinkStatus
Where one composed ceremony has got to inside a run.
LlmErrorKind
How an LLM call failed, as a stable metric label.
MemoryCapability
One capability advertised by a memory backend.
MemoryConfidence
How sure the one who said it was.
MemoryEntryKind
What a remembered thing is.
MemoryRelationKind
How one remembered thing explains another.
MetricKind
Prometheus metric family kind.
MetricValue
A Prometheus sample value, including the non-finite values its text exposition permits but JSON numbers do not.
OutputFormat
Wire- and storage-stable structured output format selector.
Owed
Whether the binding was holding work when it asked.
ParticipantKind
Whether a logical participant is meant to be a person or an agent.
ParticipantMaterialization
What a run found when it went looking for somebody to play one logical participant.
PrincipalKind
PriorContext
Whether a ceremony stage sees contributions from earlier stages.
ProcessedActionKind
What the host did about a delivery, once it had acted.
ReasonAsserter
Actor category allowed to assert a ceremony reason.
RecollectionCompleteness
Whether a recollection is all of what the scope held, or as much of it as the budget allowed.
RepeatUntilCondition
A deterministic condition that ends semantic step repetition.
RoleAction
ScoringMode
Which branch a judge-aware scoring policy took for one proposal.
StateExecution
StepFailureKind
A stable failure classification sealed with a step’s result.
StepStatus
SupportDecision
Semantic decision made about a claim and its cited evidence.
SystemRoleKind
What kind of part a business role plays in the system.
ValidationMode
How the RunCouncilDecision RPC treats validator failures when picking a winner.

Constants§

DEFAULT_SUPPORT_MIN_CONFIDENCE
Default minimum confidence required for semantic evidence support.
MAX_EXECUTION_ARTIFACTS