Hooks

हुक (Hooks) के मुख्य अध्ययन बिंदु

• हुक की परिभाषा: हुक एक निश्चित बिंदु पर चलने वाला निश्चित (deterministic) कोड होता है। यह Claude के सामान्य नियमों को एक अनिवार्य कार्रवाई (guaranteed action) में बदल देता है।
• प्रमुख हुक इवेंट्स (Key Hook Events):
• Pre-tool use: टूल कॉल से पहले फायर होता है (Enforcement Primitive)।
• Post-tool use: सफल टूल कॉल के बाद फायर होता है।
• Stop: जब Claude अपना टर्न समाप्त करना चाहता है।
• Refuse: यदि निर्धारित शर्तें पूरी नहीं होती हैं।
• Session start: वातावरण को तैयार करता है (primes the environment)।
• Pre-compact / Post-compact: कॉम्पैक्शन से पहले और बाद में फायर होता है।
• Pre-tool use की कार्यप्रणाली:
• यह JSON रिटर्न और Exit Code 0 के साथ काम करता है।
• निर्णय (Decision) के प्रकार: allow, deny, ask, या defer (अत्यंत दुर्लभ)।
• Updated Input: आप टूल कॉल को ब्लॉक किए बिना संशोधित (modify) कर सकते हैं (जैसे, कमांड से सीक्रेट हटाना)।
• महत्वपूर्ण एग्जिट कोड (Exit Codes):
• 0: सफलता (Success)। यदि आउटपुट JSON है, तो Claude उसे पार्स करता है।
• 1: नॉन-ब्लॉकिंग एरर (Non-blocking error)। Claude कमांड को वैसे भी चलाता है।
• 2: ब्लॉकिंग एरर (Blocking error)। यह प्रक्रिया को रोक देता है।
• संदर्भ और स्थिति (Context and State):
• Standard Out: JSON या टेक्स्ट आउटपुट को संदर्भ में जोड़ा जाता है।
• Standard Error: इसे Claude को संदर्भ के रूप में वापस फीड किया जाता है।
• State Preservation: कॉम्पैक्शन के बाद संदर्भ को पुनर्स्थापित करने के लिए Session start हुक का उपयोग compact matcher के साथ किया जाता है।
• हुक का उद्देश्य: हुक Claude के व्यवहार को नियंत्रित करते हैं, टूल को सुरक्षित करते हैं (guard tools), और लंबी प्रक्रियाओं में स्थिति को बनाए रखते हैं।

Takeaways

• हुक एक निश्चित (deterministic) कोड है जो Claude के सामान्य नियमों को अनिवार्य कार्रवाई में बदलता है, जिसका मुख्य उद्देश्य Claude के व्यवहार को नियंत्रित करना और टूल को सुरक्षित करना है।
• Pre-tool use हुक टूल कॉल से पहले फायर होता है और allow, deny, ask, या defer जैसे निर्णयों के माध्यम से टूल कॉल को संशोधित या ब्लॉक कर सकता है।
• एग्जिट कोड प्रक्रिया के नियंत्रण के लिए महत्वपूर्ण हैं: 0 (सफलता), 1 (नॉन-ब्लॉकिंग एरर), और 2 (ब्लॉकिंग एरर)।
• लंबी प्रक्रियाओं में स्थिति बनाए रखने के लिए Standard Out (JSON/Text) और Standard Error का उपयोग किया जाता है, और Session start हुक संदर्भ को पुनर्स्थापित करता है।