एजेंट हार्नेस

एक हार्नेस वह है जिसमें आपका एजेंट वास्तव में चलता है। Failproof AI इनमें से बारह को समर्थन करता है, दो श्रेणियों में:

कोडिंग CLIs (10) — Claude Code, Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi, Factory Droid, Devin CLI, Antigravity CLI, Goose
चैट और असिस्टेंट गेटवे (2) — Hermes (Slack, Telegram, cron), OpenClaw (स्व-होस्टेड असिस्टेंट)

एक ही नीतियां और एक ही सेशन हिस्ट्री लागू होती हैं चाहे एजेंट किसी भी हार्नेस में चले। एक एडेप्टर लेयर प्रत्येक हार्नेस के नेटिव ईवेंट नामों, टूल नामों और टूल-इनपुट फील्ड्स को 29 कैनोनिकल ईवेंट्स में मैप करता है, इससे पहले कि कोई नीति चले। एक एजेंट जो बारह में से किसी में भी नहीं चलता, वह सीधे Python SDK के साथ इंस्ट्रुमेंटेड होता है। यह एक अलग कॉन्ट्रैक्ट है, और स्पष्ट रूप से कहा जाना चाहिए: SDK ट्रेसिंग, सेशन, मूल्यांकन और ऑडिट प्रदान करता है — यह अपने आप में नीतियां लागू नहीं करता। किसी असुरक्षित कार्य को निष्पादन से पहले ब्लॉक करने के लिए आपके रनटाइम की टूल सीमा पर एक एनफोर्समेंट हुक की जरूरत है; हमसे संपर्क करें और हम इसे मैप करेंगे।

हार्नेस	समर्थित हुक स्कोप
Claude Code	User, project, local
Codex, GitHub Copilot CLI, Cursor, OpenCode, Pi	User, project
Factory Droid, Devin CLI, Antigravity CLI, Goose	User, project
Hermes, OpenClaw	User

प्रत्येक इंटीग्रेशन अपने नेटिव हुक ईवेंट नामों, टूल नामों और टूल-इनपुट फील्ड्स को सामान्यीकृत करता है इससे पहले कि नीतियां चलें। एक नीति केवल उन ईवेंट्स पर कार्य कर सकती है जो हार्नेस उजागर करता है; आप जो सटीक हार्नेस और संस्करण तैनात करते हैं उस पर टर्न-एंड और निर्देश व्यवहार का परीक्षण करें।

एनफोर्समेंट क्षमता

“ब्लॉक” का मतलब है कि वर्तमान एडेप्टर की रिटर्न की गई निर्णय का नाम दिए गए हार्नेस द्वारा उपभोग किया जाता है। पोस्ट-टूल ब्लॉकिंग मॉडल को दिखाए गए परिणाम को बदल सकती है लेकिन एक टूल साइड इफेक्ट को पूर्ववत नहीं कर सकती जो पहले से ही हुई हो।

हार्नेस	सत्यापित ब्लॉकिंग ईवेंट्स	केवल-अवलोकन या गैर-ब्लॉकिंग सावधानियां
Claude Code	`PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PreCompact`, और कई कार्य/कॉन्फ़िग ईवेंट्स	`PostToolUse`, सेशन लाइफसाइकल, नोटिफिकेशन, और पोस्ट-विफलता ईवेंट्स अवलोकनात्मक हैं।
Codex	`PreToolUse`, `PermissionRequest`, `UserPromptSubmit`, `Stop`, `SubagentStop`, `PostToolUse`	पोस्ट-टूल ब्लॉकिंग निष्पादन के बाद परिणाम को बदलती है; सेशन-स्टार्ट और कॉम्पैक्ट ईवेंट्स वर्तमान एडेप्टर में अवलोकनात्मक हैं।
GitHub Copilot CLI	`PreToolUse`, `UserPromptSubmit`, `PermissionRequest`, `Stop`, `SubagentStop`, `PostToolUse`	पोस्ट-टूल ब्लॉकिंग निष्पादन के बाद परिणाम को बदलती है; सेशन और नोटिफिकेशन ईवेंट्स अवलोकनात्मक हैं।
Cursor	`PreToolUse`, `UserPromptSubmit`, `Stop`	`PostToolUse` और सेशन ईवेंट्स अवलोकनात्मक हैं।
OpenCode	`PreToolUse`	पोस्ट-टूल और लाइफसाइकल ईवेंट्स अवलोकनात्मक हैं; वर्तमान स्टॉप हैंडलिंग एक सत्यापित गेट के बजाय बाद के टर्न के लिए मार्गदर्शन है।
Pi	`PreToolUse`, `UserPromptSubmit`	पोस्ट-टूल और लाइफसाइकल ईवेंट्स अवलोकनात्मक हैं; स्टॉप मार्गदर्शन बाद के टर्न पर लागू होती है।
Hermes	`PreToolUse`	एक नेटिव प्लगइन `instruct()` को एक बंधित, मॉडल-दृश्यमान बाधा के रूप में प्रदान करता है इससे पहले कि एक बाद की API पुनरावृत्ति की अनुमति दें। पोस्ट-टूल, सेशन, और सबएजेंट-स्टॉप निर्णय गेट नहीं हैं।
OpenClaw	`PreToolUse`, `UserPromptSubmit`, `Stop`	पोस्ट-टूल, सेशन, सबएजेंट-स्टॉप, और कॉम्पैक्शन ईवेंट्स अवलोकनात्मक हैं।
Factory Droid	`PreToolUse`, `UserPromptSubmit`, `Stop`, `PreCompact`	पोस्ट-टूल और सबएजेंट-स्टॉप निर्णय अवलोकनात्मक हैं।
Devin CLI	`PreToolUse`, `UserPromptSubmit`, `Stop`, सशर्त `PermissionRequest`	अनुमति हुक हर अनुमति मोड में नहीं चलते; पोस्ट-टूल और सेशन ईवेंट्स अवलोकनात्मक हैं।
Antigravity CLI	`PreToolUse`, `Stop`	उपयोगकर्ता-प्रॉम्प्ट और पोस्ट-टूल निर्णय अवलोकनात्मक हैं; प्रॉम्प्ट निर्देश अभी भी इंजेक्ट किए जा सकते हैं।
Goose	`PreToolUse`	उपयोगकर्ता-प्रॉम्प्ट, पोस्ट-टूल, और सेशन ईवेंट्स अवलोकनात्मक हैं। एक नेटिव ब्लॉकिंग स्टॉप हुक अपस्ट्रीम मौजूद है लेकिन वर्तमान एडेप्टर द्वारा इंस्टॉल नहीं किया गया है।

क्षमताएं संस्करण-संवेदनशील हैं। एजेंट CLI को अपग्रेड करने के बाद फिर से परीक्षण करें, विशेषकर जब कोई नीति प्रॉम्प्ट, स्टॉप, अनुमति, या पोस्ट-टूल व्यवहार पर निर्भर हो, सामान्य पूर्व-टूल गेट के बजाय।

Hermes नेटिव प्लगइन

Hermes को शेल कमांड के बजाय एक प्रोफाइल-स्थानीय नेटिव प्लगइन के माध्यम से एकीकृत किया गया है। स्थापना प्लगइन को हर डिफ़ॉल्ट और नामित Hermes प्रोफाइल में कॉपी करता है, इसे उस प्रोफाइल के config.yaml में सक्षम करता है, और केवल विरासत FailproofAI शेल-हुक प्रविष्टियों को माइग्रेट करता है। यह प्रत्येक हुक पर प्रक्रिया स्पॉन से बचता है और instruct() को Hermes के नेटिव ब्लॉक-टूल परिणाम के माध्यम से मॉडल तक पहुंचने देता है। पहला मिलान वाला निर्देश लंबित कॉल को ब्लॉक करता है। एक ही API अनुरोध ब्लॉक रहता है; एक बाद की मॉडल पुनरावृत्ति पुनः प्रयास कर सकती है। एक स्थायी, प्रोफाइल-स्कोप्ड लेजर और एक प्रति-टर्न कैप एक सलाह निर्देश को एक अंतहीन लूप बनने से रोकता है। deny() एक कठिन ब्लॉक रहता है। एक अक्षम, अपूर्ण, डुप्लिकेट, या नई अनकॉन्फ़िगर्ड प्रोफाइल का पता लगाने के लिए failproofai config --status चलाएं।

कैप्चर और नीति हुक इंस्टॉल करें

Dashboard
CLI

Administration → Keys खोलें और events:add और policies:pull के साथ एक कुंजी बनाएं, मशीन या वातावरण के लिए नामित।
लक्ष्य मशीन पर, प्रदर्शित कुंजी के साथ स्थानीय CLI को कनेक्ट करें और हार्नेस हुक इंस्टॉल करें।
एक नया एजेंट सेशन शुरू करें, फिर Observe → Events के तहत इसके हुक और सेशन ईवेंट्स की पुष्टि करें।
एक ही समय विंडो के लिए Observe → policy खोलें और पुष्टि करें कि एक नीति निर्णय मशीन को जिम्मेदार है।

कनेक्शन एक मशीन कुंजी के साथ शुरू होता है। इससे पहले कि इसका गुप्त कॉपी करें, पुष्टि करें कि इसमें इनजेशन और नीति-डिलीवरी दोनों अनुमतियां शामिल हैं।

इवेंट इनजेशन और नीति डिलीवरी अनुमतियां देने के लिए उपयोग की जाने वाली नई API कुंजी ड्रॉयर।

हुक इंस्टॉल करने के बाद, इवेंट्स स्ट्रीम को मशीन और वातावरण से नई ईवेंट्स दिखानी चाहिए जिससे आपने कनेक्ट किया है।

नई इंस्टॉल की गई हार्नेस की रिपोर्टिंग की पुष्टि करने के लिए उपयोग की जाने वाली लाइव इवेंट्स स्ट्रीम।

अंत में, सत्यापित करें कि नीति निर्णय एक ही मशीन को जिम्मेदार हैं। यह पुष्टि करता है कि हार्नेस ट्रेस ईवेंट्स के साथ-साथ नीति गतिविधि की रिपोर्ट कर रहा है।

नई कनेक्ट की गई हार्नेस से नीति निर्णयों को सत्यापित करने के लिए उपयोग किया जाने वाला नीति पृष्ठ।

मशीन कुंजी को शेल में पढ़ें। read -s इसे एक प्रॉम्प्ट पर लेता है जो ईको नहीं करता, इसलिए यह कभी कमांड में या शेल हिस्ट्री में नहीं दिखता:

read -rs FAILPROOFAI_CLOUD_TOKEN && export FAILPROOFAI_CLOUD_TOKEN

फिर मशीन को सेटअप करें — यह हर पाई गई हार्नेस के लिए हुक वायर करता है, डेमन इंस्टॉल करता है, और Cloud से कनेक्ट करता है:

failproofai config
failproofai policies add FailproofAI/policies

सेटअप अपने आप में कोई नीति सक्षम नहीं करता है, जो दूसरी कमांड के लिए है।या नामित हार्नेस और एक कॉन्फ़िगरेशन स्कोप को लक्षित करें:

failproofai policies --install \
  --cli claude codex cursor \
  --scope user

प्रोजेक्ट स्कोप हुक कॉन्फ़िगरेशन को एक रिपॉजिटरी के साथ रखता है। उपयोगकर्ता स्कोप रिपॉजिटरी में काम को कवर करता है। Claude Code स्थानीय स्कोप को भी समर्थन करता है; समर्थन हार्नेस के अनुसार भिन्न होता है और CLI असमर्थित संयोजनों को अस्वीकार करता है।मशीन और इसकी ईवेंट्स को सत्यापित करें:

failproofai config --status
failproofai flush --wait
fp events --since 1h --event-type hook_triggered,hook_completed

एक गैर-डिफ़ॉल्ट सेशन पथ जोड़ें

Dashboard
CLI

अतिरिक्त पथ मशीन पर पंजीकृत होते हैं, Cloud में नहीं। एक को जोड़ने के बाद, Observe → Sessions खोलें, मशीन के वातावरण को फ़िल्टर करें, और नई पथ से सेशन दिखाई देने की पुष्टि करें। एक सेशन खोलें और इसे ऑडिट में पूरी तरह भरोसे से पहले एजेंट, हार्नेस, और ईवेंट टाइमस्टैम्प जांचें।

अतिरिक्त कैप्चर पथ से डेटा प्राप्त करने वाले पर्यावरण के लिए फ़िल्टर किया गया सेशन सूची।

एक वैकल्पिक लेबल के साथ एक पथ जोड़ें, फिर कॉन्फ़िगर किए गए पथों का निरीक्षण करें:

failproofai harness add-path claude checkout=/srv/checkout/.claude
failproofai harness list claude
failproofai backfill --since 7d --dry-run
failproofai backfill --since 7d

failproofai harness remove-path claude checkout के साथ एक पथ हटाएं।

स्थापना के बाद एक नया सेशन चलाएं। विस्तार रोलआउट से पहले लाइव ईवेंट स्ट्रीम और एक वास्तविक नीति निर्णय दोनों को सत्यापित करें।

​एनफोर्समेंट क्षमता

​Hermes नेटिव प्लगइन

​कैप्चर और नीति हुक इंस्टॉल करें

​एक गैर-डिफ़ॉल्ट सेशन पथ जोड़ें

एनफोर्समेंट क्षमता

Hermes नेटिव प्लगइन

कैप्चर और नीति हुक इंस्टॉल करें

एक गैर-डिफ़ॉल्ट सेशन पथ जोड़ें