@aaac/runtime 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +29 -3
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,8 +1,6 @@
1
1
  # @aaac/runtime
2
2
 
3
- Runtime SDK for the AAAC (Agent-Assisted Architecture Contracts) toolchain.
4
-
5
- > **Note:** This package is a placeholder. Implementation is planned for a future release.
3
+ 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.
6
4
 
7
5
  ## Install
8
6
 
@@ -10,6 +8,34 @@ Runtime SDK for the AAAC (Agent-Assisted Architecture Contracts) toolchain.
10
8
  npm install @aaac/runtime
11
9
  ```
12
10
 
11
+ ## Capabilities
12
+
13
+ - **Task & workflow execution** — `runTask`, `runWorkflow`, `executeTask`, `executeWorkflow`, and a fluent `createRuntime()` builder API
14
+ - **SDK adapters** — Claude, OpenAI, Gemini (ADK), and Mock adapters via `createAdapter()`
15
+ - **Component binding** — `createRuntimeBinding()` dispatches operations to workflows, tasks, or deterministic handlers
16
+ - **Guardrails & plugins** — DSL-driven guardrail hooks and a plugin registry (`beforeTask`, `afterWorkflow`, etc.)
17
+ - **Memory & resume** — `MemoryRef` / `MemoryStore` with file-backed persistence and agent run logging
18
+ - **Code generator** — Handlebars-based generator for agent-runtime artifacts from DSL config
19
+
20
+ ## Basic usage
21
+
22
+ ```typescript
23
+ import { createRuntimeBinding, executeTask } from "@aaac/runtime";
24
+
25
+ // Component binding (generated by @aaac/contracts)
26
+ const binding = createRuntimeBinding(component, { handlers });
27
+
28
+ // High-level task execution
29
+ const result = await executeTask({
30
+ taskId: "review",
31
+ adapter: "claude",
32
+ dslPath: "./agents.conf.yaml",
33
+ input: { specPath: "./spec.md" },
34
+ });
35
+ ```
36
+
37
+ For the full API reference, see [FEATURES.md](./FEATURES.md).
38
+
13
39
  ## License
14
40
 
15
41
  MIT — see [LICENSE](../../LICENSE).
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@aaac/runtime",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "Runtime SDK for the AAAC toolchain",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",