इस प्रोजेक्ट के बारे में

skillstate-proxy एक लोकल HTTP प्रॉक्सी है जो उन एजेंट वर्कफ़्लो के लिए है जो अपनी प्रगति को स्पष्ट संरचित स्थिति के रूप में व्यक्त कर सकते हैं। यह क्लाइंट और कॉन्फ़िगर किए गए मॉडल प्रोवाइडर के बीच बैठती है, कार्य विनिर्देश, सत्र की JSON स्थिति और नवीनतम अवलोकन से संदर्भ बनाती है, फिर मॉडल की प्रतिक्रिया से state_patch निकालती है। README टोकन कमी को वर्कलोड-निर्भर बताता है और स्पष्ट रूप से कहता है कि बचत, विलंबता, सटीकता और प्रोवाइडर संगतता की गारंटी नहीं है। इंस्टॉलेशन npm (Node.js 20 या नया) का उपयोग करता है। निष्पादन योग्य फ़ाइल skillstate है, जो skillstate-proxy के रूप में भी उपलब्ध है। कॉन्फ़िगरेशन पर्यावरण चर जैसे SKILLSTATE_UPSTREAM, SKILLSTATE_API_KEY, SKILLSTATE_PORT (डिफ़ॉल्ट 127.0.0.1:8789), SKILLSTATE_SCHEMA, SKILLSTATE_INITIAL_STATE, SKILLSTATE_CONFIG और SKILLSTATE_VERBOSE, साथ ही CLI फ़्लैग --config, --upstream, --port, --schema और --verbose के माध्यम से होता है। प्राथमिकता क्रम CLI फ़्लैग, पर्यावरण चर, कॉन्फ़िगरेशन फ़ाइल, फिर डिफ़ॉल्ट है। एक संगत चैट क्लाइंट http://127.0.0.1:8789/v1 की ओर इंगित करता है। स्थिति अनुबंध पैच को सरणियों को बदलकर, ऑब्जेक्ट्स को पुनरावर्ती रूप से मर्ज करके, और जब किसी कुंजी का पैच मान null हो तो उस कुंजी को हटाकर मर्ज करता है। README ज़ोर देता है कि यह लॉसलेस ट्रांसक्रिप्ट संग्रह नहीं है: स्थिति में संरक्षित न किए गए तथ्य बाद में अनुपलब्ध हो सकते हैं, और जब शब्दशः साक्ष्य मायने रखता हो तो अलग ऑडिट रिकॉर्ड की सलाह दी जाती है। अनुमत कुंजी सूचियाँ मान या अवलोकन के आकार को सीमित नहीं करतीं। HTTP सतह में POST /v1/chat/completions, POST /v1/messages (Anthropic-प्रारूप अनुवाद), GET /v1/models, GET /health, GET /state (?session=ID के साथ), DELETE /state?session=ID और GET /cost शामिल हैं। README चेतावनी देता है कि कार्यान्वित रूट यह प्रमाण नहीं है कि हर SDK सुविधा काम करती है, और सलाह देता है कि स्ट्रीमिंग, टूल-कॉल सहसंबंध, समवर्ती सत्र, पुनःप्रयास और रद्दीकरण का परीक्षण सटीक क्लाइंट, प्रोवाइडर और मॉडल के विरुद्ध करें। वैकल्पिक प्रति-अपस्ट्रीम rpm/tpm सेटिंग्स एक लोकल एक-मिनट रोलिंग विंडो का उपयोग करती हैं और प्रोवाइडर-पक्ष कोटा या वितरित लिमिटर नहीं हैं। स्रोत से सत्यापन npm ci, npm run build और npm test का उपयोग करता है, साथ में कमिट किया गया package-lock.json; CI Node.js 20, 22 और 24 की जाँच करता है। वैकल्पिक स्थिर दस्तावेज़ लेआउट जाँच Python Playwright का उपयोग करती है। बेंचमार्क (बातचीत और टूल-लूप) के लिए स्पष्ट प्रोवाइडर कॉन्फ़िगरेशन आवश्यक है और इनमें पैसे लग सकते हैं; README सलाह देता है कि किसी भी परिणाम के साथ रिवीजन, वर्कलोड, मॉडल, स्कीमा, कच्चा उपयोग, पुनःप्रयास, गुणवत्ता स्कोर और विफलताएँ रखें, और कुल बिल किए गए इनपुट/आउटपुट लागत की तुलना करें। प्रोजेक्ट SKILL.state पेपर (arXiv:2608.26263) का संदर्भ देता है और नोट करता है कि शोध परिणाम इस कार्यान्वयन की सटीकता या सार्वभौमिक संगतता स्थापित नहीं करते। यह MIT लाइसेंस प्राप्त है, OpenAI या Anthropic से संबद्ध नहीं है, और लाइसेंस अपस्ट्रीम इन्फरेंस या होस्टिंग को कवर नहीं करता। स्थिति स्थानीय रूप से संग्रहीत होती है और इसमें संवेदनशील कार्य जानकारी हो सकती है; अपस्ट्रीम को पुनर्लिखित संदर्भ प्राप्त होता है, इसलिए लिसनर को निजी रखा जाना चाहिए। README कहता है कि प्रोजेक्ट केवल सत्र ID होने के कारण मल्टी-टेनेंट सुरक्षा सीमा नहीं है।