Causalor / Niyati Forensic
← Back

Hosted Forensic API

The production truth surface.

The production API (v0.3.17) serves a hardened set of simulation and solver endpoints, exposing raw structural metrics and unassailable impossibility proofs.

Base URL

https://api.causalorlabs.com

Health Guards

  • GET /healthz
  • GET /readyz
  • GET /metrics
Production Headers 
Content-Type: application/json
X-Niyati-Version: 0.3.17
X-Niyati-Key: <api-key>

Protected Solvers

Route Forensic Purpose
POST /v1/simulate Universal entry point. Returns Ω Triplet, κ Rate, and τ Thickness.
POST /v1/solve/reachability Discrete goal-reachability analysis with T21 error bounds.
POST /v1/solve/fragility T14 Fragility analysis, Anisotropy Ratio, and Lateral Margin.
POST /v1/solve/trajectory T28 Trajectory optimality (Max-Bottleneck path synthesis).
POST /v1/solve/multiagent T15 Multi-agent interference and shared optionality footprint.
POST /v1/solve/competition T16 Adversarial premium and weaponized constraint analysis.
POST /v1/solve/pareto T26 Multi-resource budget enforcement and scalar reduction.
POST /v1/solve/adversarial T20 + T20.5 + T16: Survival verdict under explicit adversary budget ξ. Returns ε* (minimum breaking force), survival margin, and the optionality-preserving path.
POST /v1/solve/saddle-point T25.D + T25.E: Multi-round minimax simulation across N subsystems. Returns survival value V(x), Π regime classification, and the full per-round ε*(t) trace.
POST /v1/solve/nash T15: N-player Nash equilibrium via Iterated Best Response. Returns per-agent optionality at equilibrium and the cooperation deficit (welfare lost to competition).
POST /v1/solve/adversarial-allocation T25.5–T25.10: Greedy-optimal attack budget allocation across N subsystems. Returns per-system collapse status and the unified collapse pressure Π = α + γ − β.

Forensic Response Surface

Field Description
verdict Definitive possible | impossible claim.
point_of_no_return The t* slice where goal reachability permanently closes.
timeline High-fidelity step data: Ω (Raw/Rel/Abs), κ, τ, and A (Anisotropy).
impossibility_proof The minimal set of constraints (T4) making the goal unreachable.
critical_decisions Ranked choices (T19) that destroyed the most future options.
survival_policy The T20 Chebyshev posture for maximum structural safety.
epsilon_star T20.5: Global minimum breaking force ε*(x) across the full horizon. Single scalar — the smallest perturbation that destroys goal-reachability at any point.
pi_trajectory T25.E: Sum of net trajectory pressure ∑Π(t) = ∑(α + γ − β). Positive → collapse regime; negative → survival regime; ≈ 0 → critical boundary.
phase_distribution T12: Step counts across all four phases — Safe, Warning, Critical, Collapsed — with danger_fraction (proportion of horizon spent outside the Safe phase).

Timeline Schema

Field Meaning
omega_rel Normalized optionality (0.0 to 1.0).
omega_abs Absolute structural volume of the feasible space.
anisotropy_ratio Brittleness factor (T14.7). Higher means more narrow corridors.
trajectory_pressure Net rate of optionality loss along the chosen path.
phase_classification T12: Discrete phase label — Safe / Warning / Critical / Collapsed. Derived from local dimension dim_local = n − |A(x)|.
kappa_over_h T19: Normalized collapse rate κ/H. Drives the green / yellow / red verdict. A value of 0 is stable; ≥ 1 means the system is beyond its point of no return. Sentinel value 999 indicates H → 0.
pi_net T25.E: Per-step net trajectory pressure Π(t) = α_t + γ_t − β_t, decomposing adversarial damage, coupling loss, and defensive reinforcement at each timestep.
is_corridor T14.7: Corridor trap flag — true when anisotropy_ratio > 10. Indicates the system is thin in its minimum-thickness direction while retaining large volume, the most dangerous structural configuration.

Version Matrix

The hosted Engine is currently strictly enforced at version 0.3.17. Mismatched X-Niyati-Version headers will result in a 426 Upgrade Required response.