@aaac/runtime 0.1.0 → 0.1.2
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.
- package/README.md +29 -3
- 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).
|