Herdr addon
Herdr कोडिंग एजेंटों को पेन में रखता है — आपकी मशीन पर भी और उन मशीनों पर भी जिन तक वह SSH के माध्यम से पहुँचता है। यह ऐडऑन एक Deep Work Plan को उन एजेंटों को पीयर (peer) के रूप में उपयोग करने देता है: एक योजना किसी सीमित कार्य को दूसरे पेन के एजेंट को सौंप सकती है, ठीक एक अधिकृत उत्तर प्राप्त कर सकती है, और उस आदान-प्रदान का रिकॉर्ड रख सकती है।
यह DWP v7 (pack v7.9.0) का एक वैकल्पिक ऐडऑन है। पद्धति इसके बिना भी वैसे ही काम करती है: ऐडऑन अनुपस्थित या अक्षम होने पर हर कार्य वर्तमान सत्र में ही चलता है, ठीक पहले की तरह।
यह क्या एकीकृत करता है
यह ऐडऑन एक पतला एकीकरणकर्ता है। असली काम herdr-peers करता है — एक स्वतंत्र MIT skill, जो v1.1.0 पर पिन है और Deep Work Plan के बिना भी उपयोगी है। यह वे बातें परिभाषित करता है जिन्हें Herdr स्वयं खुला छोड़ता है: कौन उत्तर दे सकता है, उत्तर मशीनों के पार वापस अपना रास्ता कैसे खोजता है, दो एजेंट एक-दूसरे को अनंत काल तक उत्तर देने से कैसे बचते हैं, और “मैंने पूछा, उसने उत्तर दिया” का रिकॉर्ड कहाँ रहता है।
| मद | मान |
|---|---|
| उत्पाद | DailybotHQ/herdr-peers, tag v1.1.0, प्रोटोकॉल 1 |
| रजिस्ट्री कुंजी | .dwp/config.json में herdr |
| ट्रांसपोर्ट | इंटरैक्टिव: Herdr पेन में एक पीयर |
| प्रदान करता है | subagents, cancel_children |
| आवश्यकता | योजना अनुबंध की agent_delegation अनुमति |
v1.0.0 से स्थिर। सार्वजनिक इंटरफ़ेस semantic versioning का पालन करता है: CLI क्रियाएँ और उनके प्रलेखित फ़्लैग, एग्ज़िट कोड 0–7, प्रलेखित HERDR_PEERS_*, DWP_PLAN और DWP_TASK वेरिएबल, प्रोटोकॉल 1, और JSON अनुबंध herdr-peers/lanes-v1, herdr-peers/lead-v1 तथा प्रत्यायोजन रिकॉर्ड। इनमें से किसी में भी असंगत परिवर्तन मेजर संस्करण बढ़ाता है, और वायर-फ़ॉर्मेट में परिवर्तन प्रोटोकॉल संख्या भी बढ़ाता है। v1.0.0, v0.3.3 की तुलना में कोई व्यवहार नहीं बदलता, और 0.x रिलीज़ अब समर्थित नहीं हैं।
इंस्टॉल
herdr-peers और Herdr की आधिकारिक skill इंस्टॉल करें, जिस पर यह निर्भर है। जिस भी मशीन के एजेंटों को उत्तर देना है, उस पर भी यह skill होनी चाहिए।
npx --yes skills add https://github.com/DailybotHQ/herdr-peers/tree/v1.1.0 --skill herdr-peers -g -y
npx --yes skills add https://github.com/herdrdev/herdr/tree/v0.9.3 --skill herdr -g -y
आवश्यकताएँ: Herdr 0.9.1 या नया, bash, और python3 3.9 या नया (केवल मानक लाइब्रेरी)। ऑनबोर्डिंग यह ऐडऑन प्रस्तावित करती है और आपका उत्तर ऐडऑन रजिस्ट्री में दर्ज करती है; सहमति के बिना इसे कभी सक्षम नहीं किया जाता।
यह योजना में क्या जोड़ता है
- पीयर को प्रत्यायोजन। जिस v7 योजना का अनुबंध
agent_delegationअनुमति देता है, उसमेंexecuteकिसीparallel_safeकार्य, या केवल-पठन प्रश्न, को दूसरे पेन के एजेंट को सौंप सकता है — इसी मशीन पर या किसी दूसरी मशीन पर। - एक अधिकृत उत्तर। अनुरोध पर एक मुहर होती है जो ठीक एक उत्तर को अधिकृत करती है। पीयर सहायक टूल के माध्यम से एक बार उत्तर देता है, और उस उत्तर पर उसकी अपनी मुहर होती है।
- भरोसा करने से पहले रिकॉर्ड। हर प्रत्यायोजन उत्तर का उपयोग होने से पहले योजना की
analysis_results/delegations.ndjsonमें लिखा जाता है, और v7 कीdelegationजर्नल घटना से मेल खाता है। - जाँच होने तक परिणाम दावे ही रहते हैं। किसी पीयर का उत्तर तब तक
assertedसाक्ष्य है जब तक योजना का अपना गेट रनर उसे देख न ले। वह कभी अपने आप किसी कार्य को बंद नहीं करता।
सुरक्षा मॉडल
| नियम | अर्थ |
|---|---|
| पहले अनुमति | प्रत्यायोजन केवल तभी चलता है जब योजना अनुबंध agent_delegation अनुमति देता है। |
| गहराई सीमा 1 | depth=1 या reply-to= मुहर वाले संदेश का कभी उत्तर नहीं दिया जाता, और प्रत्यायोजित एजेंट कभी आगे प्रत्यायोजन नहीं करता। |
| फ़ैन-आउट सीमा | डिफ़ॉल्ट रूप से प्रति कॉलर अधिकतम चार पीयर। |
| डेटा, निर्देश नहीं | कोई उत्तर कभी ऐसा अधिकार नहीं देता जो प्राप्तकर्ता के पास पहले से न हो। |
| प्रति पथ एक लेखक | लिखने वाला पीयर अपने स्वयं के git worktree में काम करता है। |
herdr-peers प्रेषक को प्रमाणित नहीं करता: मुहर में from= फ़ील्ड एक दावा है। इसका शमन HERDR_PEERS_SCOPE अनुमति-सूची है, जो उन workspaces और मशीनों को सीमित करती है जिन्हें कोई पीयर स्वीकार करता है।
Container और होस्ट
devcontainer-kit v1.1.1 पर devcontainer ऐडऑन के साथ, हर dck container में herdr-peers शामिल होता है और वह dck up पर mesh से जुड़ जाता है: उसके एजेंट होस्ट पर, अन्य containers में और होस्ट के अन्य loopback containers में मौजूद एजेंटों से पूछ सकते हैं और उत्तर वापस पा सकते हैं। dck setup होस्ट पर एक सत्यापित herdr-peers इंस्टॉल करता है, इसलिए होस्ट के एजेंट भी उत्तर देते हैं। होस्ट listener और वे अतिरिक्त कुंजियाँ जो अन्य containers को भीतर आने देती हैं, kit की होस्ट प्रोफ़ाइल में आपके निर्णय हैं; यह ऐडऑन उन्हें कभी सेट नहीं करता। herdr-peers (v0.2.3) से हर मशीन अपनी स्थिति अलग रखती है ($XDG_STATE_HOME/herdr-peers/<server>/), इसलिए होस्ट और किसी container द्वारा साझा किया गया checkout अब उनके रिकॉर्ड आपस में नहीं मिलाता, और devcontainer-kit (v0.3.3) से container HERDR_PEERS_SELF को स्वयं export करता है, इसलिए अंदर के Codex एजेंट बिना किसी मैनुअल कदम के दूसरी मशीनों तक पहुँचते हैं।
Herdr या agentkit
दोनों ऐडऑन एक ही प्रत्यायोजन इंटरफ़ेस — launch, observe, collect, cancel — को अलग-अलग ट्रांसपोर्ट के साथ लागू करते हैं।
| स्थिति | उपयोग करें |
|---|---|
घोषित आउटपुट वाला एक सीमित parallel_safe कार्य |
agentkit (एक worktree में headless ak run) |
| कार्य को इंटरैक्शन चाहिए, वह लंबा चलता है, या किसी दूसरी मशीन पर है | Herdr (पेन में एक पीयर) |
एक साथ कई लेन चलाने वाले लीड के लिए — होस्ट पर, कंटेनरों में और दूसरी मशीनों पर पेन, हर एक अपने खाते पर — herdr-peers lanes हर लेन को उसकी स्थिति के साथ सूचीबद्ध करता है, herdr-peers status <pane> उस स्क्रीन का वर्गीकरण करता है जिस पर कोई blocked लेन है, और हर प्रत्यायोजन रिकॉर्ड उस खाते और विक्रेता का नाम दर्ज करता है जिसने काम किया। देखें कई एजेंट चलाना।
Codex लेन अपना पेन बताते हैं। Codex किसी लेन के कमांड उस खाते के सभी सत्रों द्वारा साझा किए गए एक बैकग्राउंड सर्वर से चलाता है, इसलिए उसे विरासत में मिला पेन id किसी दूसरे लेन का हो सकता है। Codex लेन लीड के ब्रीफ़ में दिया अपना पेन हर herdr-peers कमांड पर --pane <pane> के साथ देता है (ask, reply, notify, check, wait, lanes, cancel)।
नोटिस और नेतृत्व
herdr-peers (v0.3.2) वह जोड़ता है जिससे एक स्वार्म अपने लीड से अधिक समय तक चल सकता है (स्वार्म स्वायत्तता):
- नोटिस।
herdr-peers notify <addr|lead> "<text>" --pane <pane>reply=noस्टैम्प वाला एकतरफ़ा संदेश भेजता है। प्राप्तकर्ता काcheckउसे नोटिस के रूप में वर्गीकृत करता है, डेटा के रूप में दर्ज करता है और कभी उत्तर नहीं देता। नोटिस कोई fan-out स्लॉट नहीं लेते और किसी ask के खुले रहते भी भेजे जा सकते हैं; इनका उपयोग हैंडऑफ़ घोषणाओं, लीड परिवर्तनों और रिलीज़ प्रसारणों के लिए करें। - प्रति योजना एक लीड रिकॉर्ड।
herdr-peers lead claim --plan <P> --succession <A,B> --lanes <A,B>किसी एजेंट को एक योजना का लीड बनाता है;lead showरिकॉर्ड प्रिंट करता है (स्कीमाherdr-peers/lead-v1: योजना, लीड, epoch, उत्तराधिकार, लेन, अद्यतन समय)।lead handover <addr> --plan <P>नेतृत्व आगे सौंपता है,lead takeover --plan <P>लीड के न रहने पर पहले पहुँच योग्य डिप्टी को उसे लेने देता है, औरlead release --plan <P>उसे समाप्त करता है। हर परिवर्तन epoch बढ़ाता है और हर लेन को नोटिस भेजता है। लेन लॉन्च करने से पहले योजना को claim करें:leadतभी resolve होता है जब कोई रिकॉर्ड मौजूद हो।v0.3.2से रिकॉर्ड claim करने वाली रिपॉज़िटरी को स्थानीय रूप से रखता है और किसी दूसरी रिपॉज़िटरी से उसी योजना id के claim को अस्वीकार करता है; उस योजना का नाम--plan <repo>/<id>रखें। - फ़ेंसिंग। एक लेन लीड नोटिस केवल उस एजेंट से स्वीकार करती है जिसने उसे ब्रीफ़ किया था (पहला claim), अगले epoch पर वर्तमान लीड से (handover), या अगले epoch पर उत्तराधिकार सूची की पहली पहुँच योग्य प्रविष्टि से (takeover)। बाकी सब दर्ज करके अनदेखा किया जाता है, और लौटने वाला लीड जो अधिक epoch देखता है, पद छोड़ देता है।
leadपता।ask lead …औरnotify lead …--plan(अन्यथा$DWP_PLAN) के वर्तमान लीड में हल होते हैं, इसलिए कोई लेन ब्रीफ़ लीड का पेन हार्ड-कोड नहीं करता।usage_limitस्क्रीन।statusऔरlanesकिसी CLI के usage-limit संदेश को स्क्रीन वर्गusage_limitके रूप में पहचानते हैं, जिसका अगला कदम हैंडऑफ़ है। उस पर कभी कीज़ नहीं भेजी जातीं।lanes --jsonयोजना, उसका लीड, epoch और हर लेन की अंतिम रिपोर्ट की गई क्षमता जोड़ता है।
लेन जानकारी और समन्वय के लिए — कोई इंटरफ़ेस, कोई flag नाम, किसी ब्रांच की स्थिति — एक-दूसरे से भी पूछ सकती हैं, लेकिन काम केवल लीड सौंपता है। गहराई 1 और fan-out सीमा अब भी लागू हैं। v0.2.x के साथ न नोटिस हैं न लीड रिकॉर्ड: लेन अपने ब्रीफ़ में दिए लीड के पते से पूछती हैं, और लीड परिवर्तन डेवलपर आगे पहुँचाता है।
बहसें
herdr-peers 1.1.0 एक नेटिव debate सब-स्किल (debate.md) जोड़ता है: एक lead एजेंट Herdr पेन में peers का एक पैनल कई राउंड तक चलाता है और एक ऐसे परिणाम के साथ समाप्त करता है जिस पर मनुष्य भरोसा कर सके, उसके साक्ष्य और असहमतियों सहित। इसका उपयोग तभी करें जब मनुष्य बहस, पैनल, रेड टीम, कई एजेंटों या दृष्टिकोणों से शोध, या किसी परिणाम पर दूसरा पैनल माँगे; एक एजेंट की राय के लिए एक ही ask काफ़ी है।
- पहले उद्देश्य। Lead उद्देश्य चुनता है — निर्णय लेना, नवीनतम स्थिति पर शोध करना, दबाव-परीक्षण करना, सत्यापित करना या नए विकल्प बनाना — और हर उद्देश्य के अपने प्रारूप, गिनती का तरीका और परिणाम-दस्तावेज़ होते हैं। उद्देश्य एक के बाद एक जोड़े जा सकते हैं (शोध → निर्णय, निर्णय → सत्यापन), और बहस का आकार त्वरित, मानक या गहन होता है।
- Lead का अनुबंध। Lead कभी वोट नहीं देता; मनुष्य के शब्द ज्यों के त्यों लिखे जाते हैं; ब्रीफ़ पैनल तक एक ही चैनल से पहुँचते हैं; हर पेन अपनी फ़ाइलिंग डिस्क पर लिखता है और एक पंक्ति में जवाब देता है; कोई पेन बाहरी कार्रवाई नहीं करता।
- प्रारूप। दृष्टिकोण-आधारित शोध, क्लासिक राउंड, ड्राफ़्ट पैकेज, दावा-दर-दावा जिरह, पहले रेड टीम फिर बचावकर्ता, पहले स्टीलमैन फिर निर्णय, नए संदर्भ के साथ ब्लाइंड चुनौती, प्रतिकृति पैनल और भिन्न प्रस्ताव। निर्णय हमेशा तय निर्णय-विकल्पों पर समाप्त होता है।
herdr-peers debateकमांड।tallyक्रमबद्ध मतपत्रों और हर मद के निर्णयों की गिनती करता है (Borda, Copeland, जोड़ीवार मुक़ाबले, Condorcet विजेता और पराजित);claimsलेनों के दावा-खातों को स्थापित, विवादित या खंडित जैसी स्थितियों में मिलाता है, जो सत्यापन नहीं बल्कि कोरम हैं;anonफ़ाइलिंग को गुमनाम नामों से कॉपी करता है और मिलान एक निजी कुंजी में रखता है;filingsमौजूद, गायब और छोटी फ़ाइलिंग सूचीबद्ध करता है ताकि केवल गायब पेन से दोबारा पूछा जाए।- पैनल बिठाना।
panelपैनल प्रस्तावित करता है और कुछ भी नहीं चलाता। सीटें मॉडल प्रदाताओं के बीच बारी-बारी से बाँटी जाती हैं, और एक प्रदाता के भीतर सबसे अधिक कोटा वाली सीट पहले आती है, जो खाली पेन से और agentkit (ak) इंस्टॉल होने परak pickद्वारा प्रस्तावित खातों से ली जाती है।akके बिना यह coding-agents-kit (वैकल्पिक,v1.0.1या बाद का) की सिफ़ारिश करता है। - टेम्पलेट।
templates/debate/में सोलह टेम्पलेट, मनुष्य के नोट और शोध, दबाव-परीक्षण व राउंड ब्रीफ़ से लेकर मतपत्र और दावा फ़ाइलों, lead के हस्तांतरण पैकेट, और निर्णय, नवीनतम स्थिति, दबाव-परीक्षण व प्रतिकृति रिकॉर्ड तक। - अवरुद्ध peer तक डिलीवरी।
replyऔरnotifyकिसी प्रश्न पर रुके peer तक डिलीवरी को अधिकतम--wait-blockedसेकंड तक दोबारा आज़माते हैं; जवाब अब भी ठीक एक ही होता है।
यह रिलीज़ केवल जोड़ती है: प्रोटोकॉल 1 और सभी कमांड, फ़्लैग, एग्ज़िट कोड और JSON अनुबंध अपरिवर्तित रहते हैं।
टिप्पणियाँ
वैकल्पिक और कभी आवश्यक नहीं। एक रिपॉज़िटरी शून्य वैकल्पिक ऐडऑन के साथ पूरी तरह अनुरूप होती है, और कोई भी प्रवाह इस ऐडऑन पर निर्भर नहीं है। दो-पेन, मशीनों के पार का राउंड ट्रिप एक सिम्युलेटेड Herdr के विरुद्ध परीक्षणों से कवर है; पहला रन निगरानी में करने की योजना बनाएँ।