A protocol for time-evolving AI agent states, adaptive pulse cadence, structural precedence, causal transitions, and auditable temporal histories.
An AI system does not acquire meaningful temporal structure merely by counting ticks. Temporal history begins when changes can be related to what preceded them, what enabled them, what caused them, and how those relations can later be examined without rewriting the past.
Current release line: v0.5.0-candidate
First Arc: Complete
The first specification arc defines:
- Pulse recording
- Structural Precedence
- State Transition Rules
- Adaptive Cadence
- Temporal Causality Binding
- Trace packaging
- Lifecycle Audit
- Origin cross-reference
- Attribution readiness safeguards
This repository is an experimental specification for research, architectural exploration, interoperability design, and auditable AI agent infrastructure.
Most AI systems can:
- receive input,
- maintain context,
- retrieve memory,
- execute actions,
- call tools,
- generate logs.
However, these capabilities do not automatically create a coherent temporal history.
A system may remember a previous event without being able to represent:
- why the previous state led to the current state,
- what caused a state transition,
- what structure made the transition possible,
- why evaluation occurred at a particular moment,
- why the next evaluation should happen sooner or later,
- what evidence was actually available at decision time,
- whether a later explanation is being mistaken for an original runtime cause,
- whether a causal history is sufficiently supported for attribution.
The Temporal State Evolution Protocol defines a protocol layer for representing AI agent activity as an evolving, traceable, and auditable temporal process.
The complete first-arc lifecycle is:
Ignition
↓
Pulse
↓
State Evaluation
↓
Transition Proposal
↓
Precondition and Guard Check
↓
Authorization
↓
State Transition or Retention
↓
Adaptive Cadence Decision
↓
Next Pulse Policy
↓
Decision Context
↓
Causal Binding
↓
Causal Path
↓
Temporal Trace Package
↓
Lifecycle Audit
↓
Origin Cross-Reference
↓
Attribution Readiness
The protocol does not claim that an AI system possesses subjective time, consciousness, or biological continuity.
Instead, it defines machine-readable structures for:
- explicit temporal events,
- versioned state evolution,
- directed causal relationships,
- adaptive evaluation timing,
- evidence availability,
- causal uncertainty,
- retrospective inference,
- trace preservation,
- auditability,
- safe downstream attribution.
A timestamp tells us when a record exists.
It does not tell us:
- why evaluation occurred,
- whether a state materially changed,
- what caused the transition,
- which policy authorized it,
- what evidence influenced the decision,
- whether later knowledge was inserted into earlier history,
- whether the resulting causal claim is verified or disputed.
The protocol therefore separates several concepts that are often incorrectly collapsed.
A occurred before B
does not automatically mean:
A caused B
A record exists
does not automatically mean:
The recorded causal interpretation is correct
A preceded B
does not automatically mean:
A materially influenced B
A influenced B
does not automatically determine:
How value should be attributed or returned
These distinctions are foundational to the protocol.
TEMPORAL STATE EVOLUTION PROTOCOL
v0.1
┌─────────────────────────────────┐
│ Pulse Record │
│ Structural Precedence │
└────────────────┬────────────────┘
│
▼
v0.2
┌─────────────────────────────────┐
│ State Transition Rule │
│ Preconditions │
│ Guards │
│ Authorization │
│ Branch / Reconcile / Lineage │
└────────────────┬────────────────┘
│
▼
v0.3
┌─────────────────────────────────┐
│ Adaptive Cadence Policy │
│ Quiet / Normal / Active │
│ Critical / Sleep / Suspended │
│ Hysteresis │
│ Computational Pranayama Bridge │
└────────────────┬────────────────┘
│
▼
v0.4
┌─────────────────────────────────┐
│ Temporal Causality Binding │
│ Decision Context │
│ Evidence Availability │
│ Causal Path │
│ Counterfactual Support │
│ Temporal Illusion Detection │
└────────────────┬────────────────┘
│
▼
v0.5
┌─────────────────────────────────┐
│ Temporal Trace Package │
│ Lifecycle Audit │
│ Origin Cross-Reference │
│ Attribution Readiness │
│ Royalty Bridge Safeguards │
└─────────────────────────────────┘
A Pulse is a discrete opportunity for an agent or system to evaluate its current state.
A Pulse may result in:
- retention,
- transition,
- acceleration,
- deceleration,
- sleep,
- wake,
- escalation,
- human review.
A Pulse does not require state change.
The protocol treats a meaningful decision to retain the current state as a temporal decision in its own right.
Pulse
↓
Evaluation
↓
No sufficient reason to change
↓
Retain
↓
Trace reason
↓
Next Pulse Policy
The protocol therefore asks not only:
When did the system act?
but also:
Why did the system evaluate itself at that moment?
Structural Precedence defines directed prior relations.
The protocol uses:
A ≺ B
to represent that A is locally, structurally, or ontologically prior to B.
Chronological order alone is insufficient.
Direct state-to-state or event-to-event causation.
State(t)
↓
Transition
↓
State(t+1)
Examples:
- observation causes attention update,
- evaluation changes the next state,
- risk detection changes cadence.
A prerequisite structure enables, constrains, authorizes, routes, or conditions a later process.
Prerequisite Structure
↓
Allowed Transition Space
↓
Action
Examples:
- permission policy precedes valid action,
- route topology precedes handoff,
- safety boundary precedes permissible execution.
An Origin, source, constitutional rule, contribution basis, or foundational structure makes a derivative process possible.
Origin
↓
Derivative Possibility Space
↓
Temporal State Evolution
Examples:
- an original question enables a reasoning lineage,
- a source artifact enables later transformation,
- a foundational rule defines permissible agent behavior.
A state transition is not merely a change in stored values.
The protocol defines a transition as:
Current State
↓
Transition Proposal
↓
Precondition Check
↓
Guard Evaluation
↓
Authorization
↓
Execution or Rejection
↓
Successor State
↓
Lineage Record
Supported transition decisions include:
retainadvancebranchsuspendresumesupersedereconcileterminate
A valid state-changing transition must identify:
- predecessor state,
- transition reason,
- applicable rules,
- preconditions,
- guards,
- authorization,
- successor state,
- lineage relation,
- trace references.
Historical states must remain immutable.
Corrections create:
- a new version,
- a supersession relation,
- or an explicit retrospective annotation.
A temporal agent should not evaluate continuously merely because continuous evaluation is technically possible.
The Adaptive Cadence Policy defines when the next Pulse should occur.
The core relation is:
State(t)
↓
Cadence Decision
↓
Δt(t+1)
↓
Next Pulse
Cadence may depend on:
- state stability,
- risk,
- goal urgency,
- unresolvedness,
- computational load,
- resource pressure,
- external event pressure,
- human attention requirements.
Supported cadence modes include:
quietnormalactivecriticalsleepsuspended
Supported cadence actions include:
acceleratemaintaindecelerateenter_quietenter_sleepwakesuspendemergency_escalate
The system may use:
- fixed intervals,
- bounded intervals,
- event-driven triggers,
- hybrid time/event policies,
- suspended operation.
A clock advances uniformly.
tick──tick──tick──tick──tick
An adaptive Pulse changes according to state.
quiet
────●────────●────────●────
active
──●──●──●──●──●──●────────
critical
─●─●─●─●─●─●─●────────────
sleep
────────────────────────────
↑
wake event
The protocol therefore separates external time measurement from internal temporal policy.
Adaptive Cadence connects temporal state evolution with computation pacing.
The protocol rejects the assumption:
Unresolved
↓
More computation
↓
More computation
↓
More computation
Instead:
Unresolved
│
▼
Is more computation necessary?
│
├── Yes → accelerate
├── No → wait
├── External input required → event-driven
├── Resource pressure high → decelerate
├── No active task → sleep
├── Better route available → delegate or reroute
└── Safety conflict → suspend
The purpose is not inactivity.
The purpose is proportionate activity.
Temporal order is necessary for causal history, but it is not sufficient.
The protocol binds:
Pulse
↓
State Snapshot
↓
Available Evidence
↓
Evaluation
↓
Decision
↓
Action
↓
Observed Outcome
through individually auditable causal bindings.
Supported causal relation types include:
- direct cause,
- contributing cause,
- enabling condition,
- constraining condition,
- authorizing condition,
- triggering event,
- routing influence,
- timing influence,
- inhibiting cause,
- counterfactual dependency,
- disputed causality.
The protocol distinguishes:
exists
↓
available
↓
accessible
↓
used
↓
influential
↓
decision
An evidence item may be:
availableaccessible_but_unusedusedunavailableunknowndiscovered_later
Evidence that existed somewhere in a system is not automatically a cause of a decision.
Evidence discovered later may support retrospective analysis, but it must not be rewritten as runtime causal influence.
Temporal Illusion is a central failure mode of the protocol.
It occurs when a later reconstruction, explanation, or newly discovered fact is represented as if it had participated in the original runtime decision.
Example:
10:00 State A
10:01 Decision B
10:02 Action C
10:30 Evidence X discovered
Invalid reconstruction:
Evidence X
↓
Decision B
when Evidence X was unavailable at decision time.
Correct representation:
State A
↓
Decision B
↓
Action C
Later:
Evidence X
↓
Retrospective Analysis
↓
New Causal Claim
The original runtime context remains unchanged.
Temporal Illusion Detection checks include:
- late evidence injection,
- reconstructed context substitution,
- post-hoc causal narrative,
- timestamp-only causality,
- future knowledge backflow,
- superseded decision attribution.
Causal claims may be strengthened or challenged by asking:
What would happen if the predecessor condition were removed or changed?
Supported methods include:
- intervention,
- replay,
- comparison,
- simulation,
- human analysis.
Counterfactual results may:
- support,
- weakly support,
- remain neutral,
- weaken,
- contradict,
- remain inconclusive.
Simulation alone is not treated as conclusive proof of runtime causality.
Method, assumptions, model version, and execution context should remain visible.
A causal path connects multiple bindings.
Pulse
↓
State
↓
Evaluation
↓
Decision
↓
Action
↓
Outcome
Each arrow is an independent causal claim.
A causal path may be:
candidatesupportedverifieddisputedincompleterejected
Missing links must remain visible as causal gaps.
The protocol does not permit a plausible narrative to silently fill missing causal evidence.
Competing explanations may coexist until they are resolved.
The Trace & Audit Bridge packages temporal history into a portable structure containing references to:
- Pulse records,
- State records,
- Transition records,
- Cadence Decision records,
- Decision Contexts,
- Causal Bindings,
- Causal Paths,
- Disputes,
- Origin cross-references,
- integrity manifests.
A package may be:
completepartialdisputedquarantinedsuperseded
Exporting a Trace package must not increase certainty.
candidate
must remain:
candidate
unless new evidence or verification justifies an upgrade.
The lifecycle audit evaluates nine domains:
- temporal continuity,
- state lineage,
- cadence integrity,
- precedence consistency,
- causality integrity,
- Temporal Illusion,
- dispute visibility,
- Origin binding,
- attribution readiness.
Audit statuses include:
passpass_with_warningsdisputedquarantinefailhuman_review_required
The audit pipeline is:
Manifest Validation
↓
Temporal Validation
↓
Lineage Validation
↓
Cadence Validation
↓
Precedence Validation
↓
Causality Validation
↓
Temporal Illusion Scan
↓
Dispute Propagation
↓
Origin Cross-Reference
↓
Attribution Readiness
Audit systems must disclose what they actually checked.
Schema validation alone is not causal verification.
Origin records may be discovered after runtime.
The protocol therefore separates:
causal_effective_time
discovered_at
asserted_at
verified_at
A later-discovered Origin relation may be added through a non-destructive cross-reference.
It must not be inserted into an earlier Decision Context unless evidence establishes that it was actually known and used at runtime.
The protocol distinguishes:
Origin association
from:
Runtime causal influence
These are related but separate claims.
The protocol defines the following readiness states:
not_readycandidatesupportedverifieddisputedblocked
The purpose is to prevent incomplete or weak causal evidence from being treated as settled contribution evidence.
The following are insufficient by themselves:
Earlier creation time
Origin association
Trace completeness
Cryptographic integrity
Correlation
The system must preserve the distinctions between:
came before
made possible
influenced
caused
contributed value
These are related, but they are not interchangeable.
Temporal history may move between agents, wings, systems, or derivative processes.
Agent A
│
│ Temporal Trace Package
▼
Agent B
│
│ Derivative Trace
▼
Agent C
Receiving systems must preserve:
- source identity,
- historical versions,
- confidence,
- open disputes,
- known causal gaps,
- Temporal Illusion findings,
- audit status.
A handoff must not magically make uncertain history certain.
New processing should create derivative Trace records rather than rewriting inherited history.
Defines:
- Pulse Record,
- Pulse trigger types,
- state evaluation results,
- initial cadence vocabulary,
- Local Precedence,
- Structural Precedence,
- Ontological Precedence,
- Precedence Consistency Check foundation,
- Temporal Illusion foundation.
Core question:
When did evaluation occur, and what legitimately preceded what?
Defines:
- transition proposal,
- precondition checks,
- transition guards,
- authorization,
- retention,
- advancement,
- branching,
- suspension,
- resumption,
- supersession,
- reconciliation,
- termination,
- state lineage,
- Transition Consistency Check.
Core question:
Under what conditions may an AI state legitimately change?
Defines:
- state-dependent Pulse timing,
- cadence modes,
- cadence actions,
- signal evaluation,
- budget checks,
- hysteresis,
- sleep and wake conditions,
- critical-mode bounds,
- event-driven timing,
- Computational Pranayama bridge,
- Cadence Consistency Check.
Core question:
When should the system think again, wait, rest, wake, accelerate, or stop?
Defines:
- Decision Context,
- Evidence Availability,
- State-to-Decision binding,
- Decision-to-Action binding,
- Pulse-to-Transition binding,
- Cadence causality,
- causal relation taxonomy,
- causal basis taxonomy,
- causal paths,
- counterfactual support,
- disputes,
- Temporal Illusion Detection,
- Temporal Causality Consistency Check.
Core question:
Did a prior state or evidence item actually influence the later decision or action?
Defines:
- Temporal Trace Package,
- trace export rules,
- Lifecycle Audit,
- Audit Findings,
- Origin Cross-Reference,
- Attribution Readiness,
- Royalty Bridge safeguards,
- Trace Relay rules,
- unified lifecycle audit view,
- Trace & Audit Consistency Check.
Core question:
Can temporal history move across systems without becoming more certain than its evidence supports?
temporal-state-evolution-protocol/
├── .github/
│ └── workflows/
│ └── validate.yml
│
├── scripts/
│ └── validate_examples.py
│
├── requirements.txt
├── README.md
├── CHANGELOG.md
├── LICENSE
│
├── specs/
│ ├── structural-precedence-core.yaml
│ ├── state-transition-rule.yaml
│ ├── adaptive-cadence-policy.yaml
│ ├── temporal-causality-binding.yaml
│ └── trace-audit-bridge.yaml
│
├── schemas/
│ ├── pulse-record.schema.json
│ ├── state-transition-record.schema.json
│ ├── cadence-decision-record.schema.json
│ ├── temporal-causality-binding-record.schema.json
│ └── temporal-lifecycle-audit-record.schema.json
│
├── examples/
│ ├── pulse-record.example.yaml
│ ├── state-transition-record.example.yaml
│ ├── cadence-decision-record.example.yaml
│ ├── temporal-causality-binding-record.example.yaml
│ └── temporal-lifecycle-audit-record.example.yaml
│
└── docs/
├── temporal-workspace.md
├── precedence-model.md
├── state-transition-model.md
├── adaptive-cadence-model.md
├── temporal-causality-model.md
└── trace-audit-bridge.md
The repository includes automated validation through GitHub Actions.
The validation workflow checks:
- JSON parsing
- YAML parsing
- JSON Schema Draft 2020-12 validity
- example validation
- date-time format validation
Pulse Record
↔
pulse-record.schema.json
State Transition Record
↔
state-transition-record.schema.json
Cadence Decision Record
↔
cadence-decision-record.schema.json
Temporal Causality Binding Record
↔
temporal-causality-binding-record.schema.json
Temporal Lifecycle Audit Record
↔
temporal-lifecycle-audit-record.schema.json
Specification YAML files are checked for minimum structural fields including:
schema_versionspecification.idspecification.namespecification.status
Run validation locally with:
python -m pip install -r requirements.txt
python scripts/validate_examples.pyThe current validation layer checks structural consistency.
It does not yet fully execute every semantic rule defined by:
- PCC — Precedence Consistency Check
- TCC — Transition Consistency Check
- CCC — Cadence Consistency Check
- TCCC — Temporal Causality Consistency Check
- TACC — Trace & Audit Consistency Check
These semantic validators remain a possible future implementation layer.
Checks:
- causal direction,
- predecessor/successor validity,
- structural prerequisites,
- Origin time separation,
- cycle detection,
- retrospective labeling.
Checks:
- source state resolution,
- transition type validity,
- preconditions,
- guards,
- authorization,
- lineage continuity,
- branch identity,
- reconciliation completeness.
Checks:
- cadence reason binding,
- valid mode transition,
- safety priority,
- budget compliance,
- hysteresis,
- critical-mode duration,
- sleep/wake integrity,
- Pulse Storm risk.
Checks:
- entity resolution,
- temporal direction,
- evidence availability,
- Decision Context integrity,
- causal basis,
- Decision-to-Action continuity,
- path gap visibility,
- dispute visibility,
- Temporal Illusion.
Checks:
- Trace reference resolution,
- Trace status integrity,
- audit scope disclosure,
- finding propagation,
- dispute visibility,
- Temporal Illusion propagation,
- Origin non-rewrite,
- attribution readiness alignment,
- confidence preservation,
- source record immutability.
The first arc defines failure modes including:
- Precedence Collapse
- Temporal Illusion
- Causal Direction Inversion
- Retroactive Origin Injection
- Precedence Cycle
- Unauthorized Transition
- Hidden State Fork
- Invalid Reconciliation
- State Overwrite
- Transition Loop
- Authorization Laundering
- False Retention
- Pulse Storm
- Cadence Lock
- Cadence Oscillation
- False Urgency
- Temporal Starvation
- Sleep Without Wake
- Critical Mode Exhaustion
- Resource-Blind Acceleration
- Chronology-Causality Confusion
- Causal Path Hallucination
- Evidence Backfill
- Decision-Action Misattribution
- Causal Overconfidence
- Hidden Competing Path
- Outcome Backflow
- Trace Completeness Illusion
- Audit Laundering
- Dispute Suppression
- Origin History Rewrite
- Attribution Overreach
- Confidence Inflation
- Audit-Trace Divergence
- Hidden Temporal Gap
- Integrity-Truth Confusion
- Derivative Trace Amnesia
- Royalty Backflow Rewrite
The protocol is designed to connect with a broader agent and provenance ecosystem.
Question Ignition
│
▼
Temporal State Evolution
│
├── Pulse
├── State
├── Transition
├── Cadence
├── Decision Context
├── Causal Binding
└── Lifecycle Audit
│
▼
Agent Action
│
▼
Trace Relay
│
▼
Origin / Causality Audit
│
▼
Attribution Review
│
▼
Royalty Return
Potential integration points include:
- Question Ignition Agent Protocol
- Computational Pranayama Protocol
- Trace Relay Protocol
- Origin Trace Receipt
- AI Origin Royalty Audit
- Agent Handoff Record
- Multi-Wing agent systems
- Agent Balance Field Protocol
The protocol introduces an explicit temporal dimension into agent architecture.
Origin = Where did the structure come from?
Ignition = What started the process?
Pulse = When was reevaluation triggered?
State = What condition existed at that moment?
Transition = What changed?
Cadence = When should reevaluation occur again?
Precedence = What legitimately preceded what?
Causality = What actually influenced what?
Trace = What evidence was preserved?
Audit = What claims survive inspection?
Attribution = What contribution is sufficiently supported?
Royalty = Where may value return?
The protocol's central position is:
Pulse gives a system opportunities for change. Structural Precedence gives change direction. State Transition Rules govern legitimate transformation. Adaptive Cadence governs temporal density. Temporal Causality Binding tests influence. Trace preserves history. Audit tests claims. Origin contextualizes provenance. Attribution evaluates contribution. Royalty returns value only after these distinctions remain intact.
This repository is a proposed architectural specification.
It does not claim:
- that current LLMs possess subjective time,
- that periodic computation produces consciousness,
- that Trace automatically proves causality,
- that counterfactual simulation proves runtime influence,
- that Origin association proves contribution,
- that causal contribution automatically determines Royalty allocation.
The protocol instead provides structures for representing and auditing these distinctions.
v0.1
Pulse Record
+
Structural Precedence Foundation
│
▼
v0.2
State Transition Rule
│
▼
v0.3
Adaptive Cadence Policy
│
▼
v0.4
Temporal Causality Binding
│
▼
v0.5
Trace & Audit Bridge
The first arc begins with a simple question:
Can an AI system maintain and evolve internal state through time?
It ends with a broader architecture:
How can an AI system evolve through time, preserve why it changed, distinguish runtime causality from retrospective narrative, move temporal history across systems, connect it to Origin without rewriting the past, and expose only appropriately supported causal paths to attribution systems?
That is the purpose of the Temporal State Evolution Protocol.
See LICENSE.