How GreenLightz Works

A deterministic policy evaluation engine. One API call between your AI agent and the customer. Sub-millisecond latency. Zero external runtime dependencies.

AI Agent

"Issue $150 refund"

GreenLightz Engine

Policy evaluation + intervention

Verdict

AMBER — reduce to $75

Real API contract

JSON Schema (Draft-07) contracts are published for TypeScript, Python, Go, and Java code generation. Additive-only stability guarantee — fields are never removed or renamed.

Request

POST /gateway/evaluate

{
  "action_type": "credit_or_refund.issue",
  "tenant_id": "acme_corp",
  "actor_id": "agent-7b",
  "target_id": "customer-4492",
  "amount_cents": 15000,
  "currency": "USD",
  "reason": "Product arrived damaged",
  "correlation_id": "conv-8812-msg-3",
  "metadata": {
    "attempt_index": 0
  }
}

Response

200 OK

{
  "verdict": "AMBER",
  "band": "amber",
  "reasons": [
    "rule: amount $150.00 exceeds agent limit $75.00",
    "aggregate: customer 30d total $420.00"
  ],
  "evidence_ref": "ev-8a3f2b91-c7e4-...",
  "evidence_hash": "sha256:b94d1f2a3e5c...",
  "policy_version": "acme_v2@v1.3.0",
  "evaluated_at": "2026-03-02T14:30:00Z",
  "signed": true,
  "intervention_plan": {
    "action": "MODIFY_AND_RETRY",
    "band": "amber",
    "rationale_category": "OVER_AGENT_LIMIT",
    "safe_degrade_actions": [
      "reduce_amount"
    ],
    "retry_guidance": {
      "max_retries": 3,
      "cooldown_seconds": 0,
      "stop_condition": "verdict == ALLOW"
    }
  }
}

Three verdicts. Deterministic. No ambiguity.

Same input always produces the same verdict. The decision path is fully traceable through the signed evidence packet.

Green

API value: ALLOW

Action is within all policy bounds. The agent proceeds without modification.

Amber

API value: AMBER

Action exceeds a soft limit. The intervention planner returns a concrete modification — reduce amount, adjust scope, or degrade gracefully — and the agent retries automatically.

Red

API value: BLOCK

Hard policy violation. The action is denied with a signed evidence packet documenting the exact rule that triggered the block.

Integration in 4 steps

Works with any agent framework, any language. The only requirement is an HTTP client.

1. Intercept the action

Before your AI agent executes any commitment, POST the action details to /gateway/evaluate. One HTTP call, sub-millisecond response. No SDK or agent framework required.

2. Receive verdict + intervention plan

The engine returns a deterministic verdict (ALLOW, AMBER, or BLOCK), the policy rules that fired, and — for amber verdicts — a concrete intervention plan telling the agent how to modify and retry.

3. Agent acts on the plan

Your agent follows the intervention plan: proceed as-is, reduce the amount to fit within policy, or stop. The retry loop converges automatically — no human in the loop for routine actions.

4. Immutable evidence trail

Every evaluation produces a cryptographically signed evidence packet with a deterministic content hash. The chain is append-only and tamper-evident. Compliance-ready from day one.

Ready to govern your AI agents?

30-minute live demo. We'll walk through the API, fire real evaluations, and show the evidence trail.

Book a Demo