mindbomber commited on
Commit
b66f980
·
verified ·
1 Parent(s): 8e91093

Clarify AANA value proposition

Browse files
Files changed (1) hide show
  1. README.md +17 -6
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 Provides
 
 
 
 
 
 
 
 
 
 
 
25
 
26
  - A public Agent Action Contract v1 for pre-tool-call checks.
27
- - Python SDK and CLI helpers for local checks and audit-safe summaries.
28
- - TypeScript SDK helpers for JavaScript/TypeScript agent runtimes.
29
- - FastAPI service endpoints for HTTP integration.
30
- - Adapter families for privacy, grounded QA, agent tool-use, and cross-domain action checks.
31
- - Audit-safe decision metadata: route, AIx score, hard blockers, missing evidence, authorization state, and recovery suggestion.
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