v2.0 AI EXECUTION FABRICYou are viewing Pranor v2.0 Documentation. Switch to Stable v1.0 Docs →

Pranor Decision — AI Governance Engine

Version: 2.0.0-dev
Module Path: github.com/vyuvaraj/pranor/decision
License: AGPL-3.0 (OSS) / EE


Overview

Pranor Decision provides a Governed AI execution decision layer with a 6-level veto ladder. It ensures safe and predictable AI operations.


Key Features

  • 6-Level Priority Veto Ladder
  • SIMULATION Mode: Counterfactual evaluation without committing state
  • Fault Contracts

6-Level Priority Veto Ladder

LevelNameModuleHard/SoftEffect
1AuthdecisionHardDENY blocks all subsequent levels
2BudgetdecisionHardDENY on cost/token overflow
3RiskdecisionSoftAPPROVE/DENY from risk signals
4RulesdecisionSoftAPPROVE/DENY/TRANSFORM policy rules
5LearnlearnSoftAdvisory from ML predictor (skip on timeout)
6DefaultdecisionHardFinal ALLOW fallback

Fault Contract

  • Returns DENY if graph context is unavailable.
  • Learn level is skipped on ErrSidecarTimeout.

Types

DecisionRequest Input parameters containing context, agent info, and action intent.

DecisionResult Output containing the veto outcome, priority level hit, and metadata.


Quick Start

engine := decision.NewEngine(cfg)
ctx := context.Background()

// Standard execution
res, err := engine.Evaluate(ctx, decision.DecisionRequest{
    AgentID: "agent_88",
    Action:  "transfer_funds",
})

// Simulation mode
simRes, err := engine.Evaluate(ctx, decision.DecisionRequest{
    AgentID:   "agent_88",
    Action:    "transfer_funds",
    Simulate:  true, // Do not commit state
})

Enterprise Edition

FeatureOSSEE
Basic 6-level ladder
Simulation mode
Advanced Risk Models
Custom Rules Engine UI