Understand CausetWhat is Causet?

What is Causet?

Causet turns fragile workflows into replayable timelines.

Your app submits intents. Causet records events. Queries and projections expose current state. The timeline can be inspected, forked, replayed, or repaired.

Causet sits beside an existing app. It does not replace the frontend, database, queue, vector DB, or services. Adopt it one endpoint, webhook, background job, or agent action at a time.


The problem

Important workflows often live inside API routes and webhook handlers:

validate → write DB → call service → send email → update status

When something fails halfway, logs are not enough. Teams cannot reliably answer what completed, what did not, or how to repair state.

AI agents make the same problem sharper: decisions, memory, tool calls, and side effects also need to be inspectable.

AI is not the only use case. It is the sharpest version of the problem.

Causet gives backend workflows and AI agents the same thing: a durable, replayable timeline of meaningful state changes.


What Causet records

request_access
→ access_requested
→ approval_required
→ access_approved
→ notification_sent

That is not a log dump. It is the application timeline that defines how state changed — and what you can replay or repair.


What you define

Developers author .causet files:

SectionPurpose
stateDurable workflow entity fields
eventsImmutable domain facts
actions / intentsCommands from apps, jobs, webhooks, or agents
projectionsRead models derived from events
queriesNamed reads against projections
sagas / workflowsMulti-step processes
decisions / memoriesOptional AI — same timeline as everything else

The compiler validates the model. The runtime executes state changes deterministically and commits them to the ledger.


What Causet is not

  • Not a replacement for Postgres, Kafka, Redpanda, or your API
  • Not a vector database
  • Not a generic web framework
  • Not only a workflow engine
  • Not a logging product

You keep your database, services, queues, APIs, and frontend. Causet is the deterministic state layer for flows where correctness, auditability, replay, and repair matter.

See What Causet handles.


What’s available today

The supported production core includes the CLI, timeline/replay inspection tooling, inbound/outbound HTTP webhooks (on Managed Cloud), and snapshot rehydration. The JavaScript / TypeScript SDK is a supported preview on npm (0.2.0). Managed Causet Cloud is in controlled early access for approved design partners. A local Docker runtime and wallet demo are available for evaluation — not production-supported.

Replay paths differ: timeline inspection, projection rebuild, forking, and snapshot rehydration re-apply recorded patches without re-running DSL rules. Forensic replay check, recovery stream replay, and repair execution are Preview sandbox tooling.

See What runs today? and Support policy.


Next step

What runs today? →