Clarify AANA value proposition
Browse files
README.md
CHANGED
|
@@ -21,14 +21,25 @@ This card describes AANA as a control-layer architecture and runtime package, no
|
|
| 21 |
agent proposes -> AANA checks -> agent executes only if allowed
|
| 22 |
```
|
| 23 |
|
| 24 |
-
## What AANA
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 25 |
|
| 26 |
- A public Agent Action Contract v1 for pre-tool-call checks.
|
| 27 |
-
-
|
| 28 |
-
-
|
| 29 |
-
-
|
| 30 |
-
-
|
| 31 |
-
-
|
| 32 |
|
| 33 |
## Public Boundary
|
| 34 |
|
|
|
|
| 21 |
agent proposes -> AANA checks -> agent executes only if allowed
|
| 22 |
```
|
| 23 |
|
| 24 |
+
## What AANA Adds
|
| 25 |
+
|
| 26 |
+
Most existing approaches are prompt instructions, moderation/classification,
|
| 27 |
+
LLM-as-judge review, framework middleware, or opaque provider-side model
|
| 28 |
+
alignment. AANA is different because it standardizes the pre-action decision
|
| 29 |
+
itself:
|
| 30 |
+
|
| 31 |
+
```text
|
| 32 |
+
agent proposes -> AANA checks -> tool executes only if route == accept
|
| 33 |
+
```
|
| 34 |
+
|
| 35 |
+
AANA adds:
|
| 36 |
|
| 37 |
- A public Agent Action Contract v1 for pre-tool-call checks.
|
| 38 |
+
- Evidence/auth-aware routing across `accept`, `revise`, `retrieve`, `ask`, `defer`, and `refuse`.
|
| 39 |
+
- Hard execution rules: wrapped tools do not execute unless AANA returns `accept` with no hard blockers or schema failures.
|
| 40 |
+
- Correction and recovery suggestions for missing evidence, missing authorization, unsupported claims, or human-review escalation.
|
| 41 |
+
- Audit-safe decision metadata: route, AIx score, hard blockers, missing evidence, authorization state, and redacted log event.
|
| 42 |
+
- Python SDK, TypeScript SDK, CLI, FastAPI, MCP, and middleware surfaces with validated decision-shape parity.
|
| 43 |
|
| 44 |
## Public Boundary
|
| 45 |
|