@aaac/runtime

Runtime SDK for the AaaC (Agent-Assisted Architecture Contracts) toolchain. Bridges agent-contracts DSL workflows to multiple Agent SDKs and provides AaaC-specific component binding.

Install

npm install @aaac/runtime

Capabilities

• Task & workflow execution — runTask, runWorkflow, executeTask, executeWorkflow, and a fluent createRuntime() builder API
• SDK adapters — Claude, OpenAI, Gemini (ADK), and Mock adapters via createAdapter()
• Component binding — createRuntimeBinding() dispatches operations to workflows, tasks, or deterministic handlers
• Guardrails & plugins — DSL-driven guardrail hooks and a plugin registry (beforeTask, afterWorkflow, etc.)
• Memory & resume — MemoryRef / MemoryStore with file-backed persistence and agent run logging

Basic usage

import { createProjectRuntime, createRuntimeBinding } from "@aaac/runtime";

// Component binding (generated by @aaac/contracts)
const binding = createRuntimeBinding(component, handlers);

// High-level task execution — project.yaml is discovered by walking up from cwd
const { runtime, context } = await createProjectRuntime({ embeddedDsl, adapter: "claude" });
const result = await runtime.runTask("review", {}, { specPath: "./spec.md" }, context);

For the full API reference, see FEATURES.md.

License

MIT — see LICENSE.