Agent Manifest
A versioned, JSON-safe definition of steps, variables, conditions, loops, tools, outputs, and limits.
Open source agent infrastructure
Define portable agents as declarative manifests and run them through a standalone TypeScript runtime—locally, inside your application, or on remote compute. Native authorization, sandboxing, durable state, and streaming events are built in. Models and infrastructure remain under your control.
Version 0.1.0 available now
schemaVersion: '1.0'
id: release-brief
name: Release brief
model:
provider: openai
model: gpt-5.6
variables:
- key: topic
type: string
requiresOverride: true
- key: audience
type: string
value: customers
steps:
- id: draft
type: prompt
systemPrompt: Write concise release briefs.
prompt: Draft a brief about {{ topic }} for {{ audience }}.
outputVariable: draft
- id: review
type: prompt
prompt: Improve this brief without adding claims: {{ draft }}
includeInFinalOutput: trueDependency-aware execution
Before a run begins, Agent Runtime analyzes step outputs and variable reads to build an ordered execution plan. Eligible independent branches run concurrently, dependent work waits for its inputs, and results commit in manifest order. Branching tasks can complete substantially faster without changing the manifest.
Portable contracts
The agent describes its steps, variables, tools, and outputs. The run provides invocation values. The host connects models, credentials, state, generated files, and compute.
A versioned, JSON-safe definition of steps, variables, conditions, loops, tools, outputs, and limits.
A small invocation contract that references an agent and supplies validated runtime variable overrides.
Model providers, credentials, connections, persistence, compute, sandboxes, and telemetry remain under host control.
Included capabilities
Resolve declarative steps and variable dependencies into a deterministic execution plan with safe fan-out and fan-in.
OpenAI, Anthropic, Google, xAI, Groq, Cohere, and OpenAI-compatible endpoints through the AI SDK adapter.
Application tools and MCP connections with host-defined credentials, modes, aliases, and tool allowlists.
Credential resolution, connection modes, tool allowlists, read/write narrowing, and host authorization hooks are enforced by the runtime.
Typed variables, checkpoints, resumable loops and sub-runs, manifest verification, and fenced execution attempts.
Ordered lifecycle, model, tool, checkpoint, artifact, and text-delta events for CLIs, applications, and telemetry.
Sandbox contracts and artifact handling are built into the runtime, with Docker and Modal providers and a custom adapter interface.
Execution adapters
Execution adapters provide a consistent interface for submission, status, ordered events, results, resume, and cancellation. Move between local, child-process, and remote execution without changing the Agent Manifest.
Agent Run Manifest
Runtime variables must match declarations in the Agent Manifest. A run can override a default, satisfy a required input, or leave the agent-level value unchanged. It cannot introduce undeclared variables.
schemaVersion: '1.0'
agent:
ref: ./release-brief.agent.yaml
variables:
- key: topic
value: Agent Runtime public release
- key: audience
value: developersReliability and boundaries
Explicit state transitions, bounded operations, and recoverable execution make agent behavior easier to understand and operate.
Release status
Version 0.1.0 is available from npm without a source build, alongside the CLI, worker protocol, adapters, documentation, tests, and interactive examples.
Standalone by design
Clear Ideas Agent Runtime is a standalone open-source project for developers building agent execution into their own applications and infrastructure. Hosted Clear Ideas uses the same runtime foundation for Clear Ideas Agents, but it is not required to install, configure, or operate the runtime.