Architecture
AWARE’s request path, from the agent to the recorded decision.
- The agent presents its credential and requests a tool call.
- The gateway validates the request, enforces the body-size limit, and proxies to the coordinator. It is deliberately a thin BFF.
- The coordinator resolves the agent’s identity and asks the policy engine to evaluate the call.
- The engine checks tool known-ness and risk level, the data tier, and any matching policy in the policy store. The tool catalogue supplies risk levels and data-tier permissions.
- The decision —
ALLOW,DENY,AUDITorNO_POLICY, with a reason — is written to the audit chain.
Components
| Module | Path | Responsibility |
|---|---|---|
| Policy engine | src/policies/engine.js | Decision logic. Default deny. |
| Tool catalogue | src/policies/tool-catalog.js | Risk levels, approval requirements, data-tier permissions. |
| Policy store | src/policies/store.js | Policy persistence and hot reload. |
| Identity | src/api/models/Agent.js, src/agents/registry.js | Credentials, hashing, rotation, state. |
| Sessions | src/agents/identity-provider-v2.js | JWT sessions with trust-domain claims. |
| Revocation | src/kill-switch/revocation-service.js | Revoke an agent; apply blast radius. |
| Emergency | src/emergency/ | Kill-signal propagation, shutdown control. |
| Audit | src/audit/, src/disclosure/ | Hash chain, verifier, exportable windows. |
| Compliance | src/compliance/framework-mapper.js | Framework and control mapping. |
| Gateway | src/gateway/server.js | Thin BFF, kill switch, body limit. |