Aionis Runtime API

The Runtime API is the product surface for recording memory, compiling governed Agent context, attributing feedback, expanding evidence, and replaying decisions.


observe -> guide -> agent action -> feedback -> measure

For the full map of Runtime APIs, SDK methods, Agent-facing outputs, integrations, and non-goals, see SDK and API Surface Matrix.

Base URL for a local install:


http://127.0.0.1:3001

Core Loop

Endpoint	Purpose	SDK method
POST /v1/observe	Record ordinary memory, execution evidence, validation output, or handoff state.	`observe`, `remember`, `execution.observeStep`
POST /v1/guide	Compile governed context for an Agent before it acts; supports host-selected task context profiles.	`guide`, `execution.guideForRole`
POST /v1/feedback	Attribute outcomes to memory exposed by a guide.	`feedback`, `execution.feedbackFromOutcome`
POST /v1/measure	Build an effect report from a guide loop or product trace.	`measure`, `execution.measureRun`

Memory Governance

Endpoint	Purpose	SDK method
POST /v1/memory/govern	Govern external memory candidates before prompt use.	`governMemory`, `governMem0SearchResults`
POST /v1/rehydrate	Expand compact evidence pointers on demand.	`rehydrate`
POST /v1/forget	Suppress, unsuppress, or lifecycle-control memory with an audit reason.	`forget`

Evidence & Replay

Endpoint	Purpose	SDK method
POST /v1/operator/snapshot	Create an operator snapshot for a run.	`operatorSnapshot`, `snapshot`, `execution.snapshotRun`
POST /v1/audit/flight-recorder	Replay what memory the Agent saw, used, or had blocked.	`flightRecorder`

Runtime

Endpoint	Purpose	SDK method
GET /health	Check Runtime readiness and configured providers.	`health`

Shared request fields

Field	Meaning
`tenant_id`	Logical tenant boundary. Local installs commonly use `default`.
`scope`	Project, repo, workspace, or task boundary. Keep it stable across observe, guide, and feedback.
`actor`	Human, service, or Agent writing the request.
`run_id`	Execution session identifier.
`task_signature`	Stable task or workflow identity.
`consumer_agent_id`	Agent that will consume a guide.
`consumer_team_id`	Shared team lane for multi-agent memory.
`task_context_profile`	Optional guide-time Agent context posture such as `coding_verifier`, `long_qa`, or `multi_agent_handoff`.

SDK base


import { createAionisClient } from "@aionis/sdk";
 
const aionis = createAionisClient({
  baseUrl: "http://127.0.0.1:3001",
  scope: "checkout-migration",
});

For the first complete loop, see First Agent Loop.