From 736383305b550960172c7fc7c7e49e8257ccf851 Mon Sep 17 00:00:00 2001 From: Zaid Date: Sun, 1 Mar 2026 03:04:50 +0530 Subject: [PATCH 1/2] Create README.md --- sentinel-agent/README.md | 80 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 80 insertions(+) create mode 100644 sentinel-agent/README.md diff --git a/sentinel-agent/README.md b/sentinel-agent/README.md new file mode 100644 index 0000000..5cac0d8 --- /dev/null +++ b/sentinel-agent/README.md @@ -0,0 +1,80 @@ +# Sentinel - Risk-Aware Validation & Escalation Agent + +A deterministic AI trust firewall built on Cortensor's decentralized inference network. + +## 🎯 Problem Solved + +High-stakes governance decisions require trust enforcement beyond simple AI outputs. Sentinel validates decisions through multi-tier redundancy and weighted consensus before execution. + +## 🏗️ Architecture + +- **Tier-based Redundancy**: 1→3→5 validator escalation +- **Composite Trust**: 60% weighted agreement + 40% average confidence +- **Thresholds**: Low (0.50), Balanced (0.65), Oracle (0.85) +- **Cryptographic Artifacts**: SHA256 + signatures for audit trails + +## 🚀 Live Demo + +- **Frontend**: https://sentinel-rav-agent.vercel.app +- **API Docs**: https://b524e8285ad3fbdb-139-59-8-118.serveousercontent.com/docs + +## 🛠️ Tech Stack + +- **Backend**: Python, FastAPI, PostgreSQL +- **Frontend**: React, Tailwind CSS +- **AI**: Cortensor (Sessions 78, 67, 79) + +## 📊 Cortensor Integration + +- Delegate (Session 78): Risk assessment +- Completions (Session 78): AI inference +- Validate (Sessions 67/79): Multi-tier validation with PoI/PoUW + + +## 📖 Features + +✅ Multi-tier escalation (1→3→5 validators) +✅ Weighted consensus computation +✅ Cryptographic decision artifacts +✅ PostgreSQL audit storage +✅ Real-time Cortensor integration +✅ Professional web interface + +## 🎥 Demo + +Visit https://sentinel-rav-agent.vercel.app and test with: +- Navigate to "Agent" page +- Enter governance decision +- Watch real-time validation + +## 📜 License + +MIT License + +## 👤 Author + +[Your Name] +- GitHub: [@0xZaid10] +- Discord: zaid_678. +``` +MIT License + +Copyright (c) 2025 [Your Name] + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. From 4dbc1ded326f18e71508f0f1bb5f3c771cc38721 Mon Sep 17 00:00:00 2001 From: Zaid Date: Sun, 1 Mar 2026 03:05:25 +0530 Subject: [PATCH 2/2] Update README to remove author and copyright info Removed author name and copyright details from README. --- sentinel-agent/README.md | 23 ++--------------------- 1 file changed, 2 insertions(+), 21 deletions(-) diff --git a/sentinel-agent/README.md b/sentinel-agent/README.md index 5cac0d8..5832b19 100644 --- a/sentinel-agent/README.md +++ b/sentinel-agent/README.md @@ -52,29 +52,10 @@ Visit https://sentinel-rav-agent.vercel.app and test with: MIT License ## 👤 Author - -[Your Name] - GitHub: [@0xZaid10] - Discord: zaid_678. ``` MIT License -Copyright (c) 2025 [Your Name] - -Permission is hereby granted, free of charge, to any person obtaining a copy -of this software and associated documentation files (the "Software"), to deal -in the Software without restriction, including without limitation the rights -to use, copy, modify, merge, publish, distribute, sublicense, and/or sell -copies of the Software, and to permit persons to whom the Software is -furnished to do so, subject to the following conditions: - -The above copyright notice and this permission notice shall be included in all -copies or substantial portions of the Software. - -THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR -IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, -FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE -AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER -LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, -OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE -SOFTWARE. +Copyright (c) 2025 +