প্রকল্প সম্পর্কে

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 পরামর্শ দেয় যেকোনো ফলাফলের সাথে রিভিশন, ওয়ার্কলোড, মডেল, স্কিমা, কাঁচা usage, রিট্রাই, কোয়ালিটি স্কোর ও ব্যর্থতা সংরক্ষণ করতে এবং মোট বিল করা ইনপুট/আউটপুট খরচ তুলনা করতে। প্রকল্পটি SKILL.state পেপার (arXiv:2608.26263) রেফারেন্স করে এবং উল্লেখ করে যে গবেষণার ফলাফল এই ইমপ্লিমেন্টেশনের নির্ভুলতা বা সার্বজনীন সামঞ্জস্য প্রতিষ্ঠা করে না। এটি MIT লাইসেন্সপ্রাপ্ত, OpenAI বা Anthropic-এর সাথে সম্পর্কিত নয়, এবং লাইসেন্স আপস্ট্রিম ইনফারেন্স বা হোস্টিং কভার করে না। স্টেট লোকালি সংরক্ষিত হয় এবং সংবেদনশীল টাস্ক তথ্য থাকতে পারে; আপস্ট্রিম পুনর্লিখিত কনটেক্সট পায়, তাই লিসেনারকে প্রাইভেট রাখা উচিত। README বলে যে শুধু সেশন ID থাকার কারণে প্রকল্পটি মাল্টি-টেন্যান্ট সিকিউরিটি বাউন্ডারি নয়।