Skip to content

Assistant engine ​

@substrat-run/engine-assistant is the record of a chat between a person and an assistant. It keeps the conversation as an append-only event log, gives one run at a time the right to write the assistant's side, and makes a tool that changes something wait for an approval tied to the exact input the person saw.

At a glance ​

Package@substrat-run/engine-assistant (public on npm)
Entitlement keyassistant
Composedby call: a host runs the loop and calls the engine's functions
Ownsthreads, their events, the run lease on each, and the state of every tool call
Emitsassistant.thread-created, turn-started, turn-finished, approval-requested, approval-resolved, thread-closed
Consumesnothing
Permissions3 (assistant:use, assistant:audit, assistant:run)
Statusin the repo; no vertical composes it yet

What it will not do ​

  • It cannot make a tool's external effect atomic with the execution claim. If the host stops after claiming but before recording the result, the record alone does not prove whether the tool ran. The host integration must handle that recovery boundary, and the target operation still checks its own permissions. Approval is not a grant of target authority.
  • It does not talk to a model or a network. The model call is the host's: a vertical runs it through the platform's model host, createModelHost, on platform-held credentials, so it needs no provider account or API key of its own.
  • It has no message branches, human participants, support handoff or memory yet.

How these pages are organized ​