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, or actionsFromHandlers)
  • 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.ts typed-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.md skill 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.