Scope
Ageniti is the action primitive layer for agentic applications. It helps existing React and TypeScript systems expose selected capabilities as structured actions every surface can call.
In Scope
- define explicit app actions (with
defineAction,defineActions, oractionsFromHandlers) - accept Zod, Standard Schema v1, or the built-in schema layer
- keep existing app structure intact
- invoke actions from React UI via
useAction(state machine + live streaming) - generate CLI commands from action schemas
- emit live streaming events (logs, progress, artifacts) any consumer can subscribe to
- expose actions through a lightweight HTTP JSON handler with detailed status codes
- expose actions as MCP tools (Content-Length and newline framing)
- expose actions as OpenAI-compatible tools and AI SDK-style tools
- expose actions through a JSON runner and a typed in-process / HTTP client
- generate
.d.tstyped-client types for autocomplete on the consumer side - inspect actions in a local dev console
- generate package-ready CLI and MCP launchers
- export deterministic
GUIDE.mdskill documentation - compare action manifests for release safety
- return structured success and failure envelopes
- attach logs, progress, and artifacts
- enforce permissions, confirmation, timeout, retry, idempotency keys, and per-action concurrency limits
- redact secrets in logs, artifact metadata, and error messages
- describe surface capabilities through manifests and adapters
Up To You
The following are intentionally outside this layer so the runtime stays small and unopinionated:
- planning or reasoning loops
- long-term memory systems
- tool routing between models
- workflow orchestration engines
- hosted execution platforms
- durable job queues
- marketplace distribution
- replacing application authentication
- parsing arbitrary React component trees into tools
Build them on top — the runtime exposes a streaming event API and a typed contract any of these layers can read from.
Design Rule
The action contract is the source of truth. Surfaces and clients are derived from it; the runtime observes it.