Cloud agents adapter
क्लाउड और पृष्ठभूमि एजेंट्स — Claude Code remote tasks, OpenAI Codex cloud, Jules-class एजेंट्स, और इसी तरह के असंयोज़ित निष्पादन परिवेश — डिज़ाइन से अल्पकालिक हैं: एक सत्र शुरू होता है, सीमित समय के लिए चलता है, और समाप्त होता है। DWP उस बाधा को एक सुविधा में बदल देता है: योजना को टिकाऊ आर्टिफ़ैक्ट बनाकर, सत्र को नहीं।
मूल अंतर्दृष्टि
रिपॉज़िटरी की .dwp/ डायरेक्टरी टिकाऊ spec और state परत है। क्लाउड सत्र अल्पकालिक निष्पादक हैं। योजना निष्पादक को बताती है क्या करना है; state.json उसे बताता है कहाँ से फिर शुरू करना है। सत्र कुछ भी हो सकता है — एक अलग मॉडल, एक अलग provider, एक नया container — और योजना ठीक वहीं से जारी रहती है जहाँ छूटी थी।
समर्थन स्तर
पूर्ण (प्रलेखित) — क्लाउड एजेंट प्लेटफ़ॉर्म AGENTS.md या मूल निर्देश पढ़ते हैं और अपने टर्मिनल या कंटेनर वातावरण के माध्यम से कमांड निष्पादित करते हैं।
wake-resume-yield लूप
प्रत्येक क्लाउड एजेंट turn इस पैटर्न का पालन करता है:
- Wake — सत्र शुरू होता है (cron शेड्यूल, CI इवेंट, या उपयोगकर्ता क्रिया द्वारा ट्रिगर)।
- DWP रेज़्यूमे प्रोटोकॉल चलाएँ — योजना README पढ़ें, चेकपॉइंट खोजें,
journal.ndjsonसेledger.py projectके माध्यम से स्थिति का पुनर्निर्माण करें, सीम का निरीक्षण करें, एक स्मोक टेस्ट चलाएँ। देखें DWP विनिर्देश। - अवरुद्ध स्थिति जाँचें — यदि
state.json.blockedसेट है, तो कारण रिपोर्ट करें और निष्पादन के बिना yield करें। - अगला परमाणु कार्य निष्पादित करें — एक कार्य, अपना पूर्ण सत्यापन गेट पार करते हुए।
- जर्नल में रिकॉर्ड करें —
ledger.pyक्रियाओं (start,gate,complete) के माध्यम सेjournal.ndjsonमें ईवेंट जोड़ें;ledger.py projectव्युत्पन्नstate.jsonस्नैपशॉट प्रोजेक्शन को परमाणु रूप से अद्यतन करता है। पुरानी v5 योजनाओं में, प्रत्यक्ष स्थिति फ़ाइल अद्यतन सुरक्षित रहता है। - Yield — सत्र cleanly समाप्त होता है; अगला turn अद्यतन स्थिति से उठाता है।
आवश्यकताएँ
- योजना में मशीन-पठनीय स्थिति परत (
manifest.json+state.json) MUST होनी चाहिए। इसके बिना, एक अल्पकालिक सत्र के पास रिज्यूम स्थिति निर्धारित करने का कोई विश्वसनीय तरीका नहीं है। देखें योजना-स्थिति। - किसी भी अनुपस्थित क्लाउड turn से पहले MUST एक मानव द्वारा योजना अनुमोदित की जानी चाहिए। योजना अनुमोदन नियंत्रण बिंदु है।
- एजेंट सीमित अधिकार के अंतर्गत संचालित होता है: इसे MUST NOT दायरा विस्तारित करना चाहिए, ऐसे विनाशकारी कार्य करने चाहिए जिन्हें योजना स्पष्ट रूप से अधिकृत नहीं करती, या वर्तमान कार्य के निर्देशों से परे सुधार करना चाहिए। देखें एजेंट प्रोटोकॉल।
टिप्पणियाँ
क्लाउड एजेंट सत्र अनुपस्थित निष्पादन प्रोफ़ाइल का चरम मामला हैं: शून्य सत्र निरंतरता, अधिकतम योजना स्थायित्व। DWP की .dwp/ डायरेक्टरी विशेष रूप से इसे काम करने के लिए डिज़ाइन की गई है — सभी state जिसकी एक एजेंट को काम का एक निकाय शुरू करने, जारी रखने और पूर्ण करने के लिए आवश्यकता है, वह plain markdown और JSON फ़ाइलों में रहता है जिन्हें कोई भी सत्र एक नई checkout से पढ़ सकता है।