Problem
The current execution path is still centered on LangGraph-specific assumptions. AgentMesh cannot
credibly say “bring any Agent” until control-plane lifecycle semantics are independent from the
framework that implements cognition.
Proposal
Define Managed Agent Runtime API v0.1 as a provider-neutral port. It must describe runtime identity,
version, capabilities, execution binding, dispatch, heartbeat/status, cancellation, recovery,
events, Artifact references, usage, and terminal results without exposing LangGraph types.
Provide adapters behind the port. The existing LangGraph path becomes the first adapter rather than
the default domain model. PostgreSQL Task/Run/Attempt remains authoritative; adapters never mutate
business tables directly.
Acceptance criteria
- A versioned runtime descriptor and capability discovery contract exist.
- Assignment and result envelopes are bounded, versioned, idempotent, and framework-neutral.
- Dispatch, observe, cancel, recover/reconcile, and shutdown behavior is specified.
- Adapter failures map to stable AgentMesh failure classes.
- Checkpoint support is declared as an optional capability rather than assumed.
- A reusable conformance suite validates lifecycle, duplicate delivery, cancellation, timeout,
usage, Artifact lineage, and recovery.
- Existing LangGraph execution passes the suite without changing Task/Run/Attempt semantics.
- Architecture dependency tests prevent the domain/application layers from importing adapter SDKs.
Non-goals
- Standardizing prompts, reasoning loops, memory implementation, or model APIs.
- Supporting every framework in v0.1.
- Letting a runtime become the business source of truth.
Dependencies
Child of the Agent Control Plane refocus epic. Enables the non-LangGraph proof and isolated runtime
provider.
Problem
The current execution path is still centered on LangGraph-specific assumptions. AgentMesh cannot
credibly say “bring any Agent” until control-plane lifecycle semantics are independent from the
framework that implements cognition.
Proposal
Define Managed Agent Runtime API v0.1 as a provider-neutral port. It must describe runtime identity,
version, capabilities, execution binding, dispatch, heartbeat/status, cancellation, recovery,
events, Artifact references, usage, and terminal results without exposing LangGraph types.
Provide adapters behind the port. The existing LangGraph path becomes the first adapter rather than
the default domain model. PostgreSQL Task/Run/Attempt remains authoritative; adapters never mutate
business tables directly.
Acceptance criteria
usage, Artifact lineage, and recovery.
Non-goals
Dependencies
Child of the Agent Control Plane refocus epic. Enables the non-LangGraph proof and isolated runtime
provider.