ब्राउज़र-नेटिव एजेंट हार्नेस

peerd आपके अपने Chrome या Firefox के अंदर सामान्य-उद्देश्य वाले एजेंट चलाता है।

यह आपके पास पहले से मौजूद टैब, साइन-इन किए गए सत्रों, वेब ऐप्स और ब्राउज़र-निहित कंप्यूट के साथ काम करता है। आप एक समर्थित क्लाउड या स्थानीय मॉडल प्रदाता चुनते हैं। किसी Peerd खाते या होस्ट किए गए ब्राउज़र की आवश्यकता नहीं है, और वर्तमान बिल्ड Peerd को कोई उत्पाद टेलीमेट्री नहीं भेजते हैं।

स्थानीय एजेंट आपके पूरे कंप्यूटर तक पहुँच सकते हैं। रिमोट एजेंट किसी और के कंप्यूटर में रहते हैं। peerd आपके ब्राउज़र के अंदर चलता है।

इंस्टॉल करें · peerd.ai · आर्किटेक्चर · सुरक्षा

ब्राउज़र-नेटिव क्यों

आपके ब्राउज़र में पहले से आपके एप्लिकेशन, सत्र, पहचान, नेटवर्किंग, इंटरफ़ेस और उपयोगी स्थानीय कंप्यूट हैं। इसमें शत्रुतापूर्ण पृष्ठों के लिए निर्मित सीमाएँ भी हैं।

peerd उन सीमाओं का उपयोग करता है। पृष्ठ का कार्य अलग-अलग एक्टर्स के पास जाता है, जिनके पास केवल उस टैब या वातावरण के लिए उपकरण होते हैं। क्रेडेंशियल, नेटवर्क नियम, पुष्टिकरण और ऑडिट एक्सटेंशन के पास रहते हैं। यह defense-in-depth डिज़ाइन मानता है कि असुरक्षित सामग्री अंततः फ़िल्टर से निकल जाएगी।

peerd को क्या अलग बनाता है

• आपका ब्राउज़र कार्यक्षेत्र है। एजेंट आपके सामने पहले से मौजूद टैब, ऐप्स, सत्रों और पृष्ठ सामग्री के साथ काम करता है।
• पृष्ठ का कार्य अलग रहता है। Web, WebVM, Notebook, App और प्रीव्यू dweb एक्टर्स को अपने-अपने वातावरण के लिए उपकरण मिलते हैं।
• साइट ज्ञान पुनः प्रयोज्य है। वेब एक्टर किसी साइट के लिए एक अनुकूली क्लाइंट बना सकता है और बाद के कार्यों में इसे फिर से उपयोग कर सकता है।
• कंप्यूट ब्राउज़र की सीमाओं के भीतर रहता है। peerd Chromium पर स्क्रिप्ट, सील किए गए JavaScript Notebooks, संकलित WASI उपकरण, ब्राउज़र Apps और Linux WebVMs चला सकता है।
• आप मॉडल चुनते हैं। लाइव प्रदाता सूची registry.js में परिभाषित है, जिसमें BYOK क्लाउड एडेप्टर और keyless स्थानीय विकल्प शामिल हैं।
• P2P वैकल्पिक है। प्रीव्यू बिल्ड साइन किए गए पहचान, ब्राउज़र-से-ब्राउज़र खोज, dwapps और WebRTC पर एजेंट-से-एजेंट संचार जोड़ते हैं; स्टोर पैकेज इसे पूरी तरह से हटा देते हैं।

स्थिति

peerd एक प्रयोगात्मक 0.x बीटा है। ब्रेकिंग परिवर्तन संभावित हैं। स्टोरेज प्रारूप और उत्पाद व्यवहार बदल सकते हैं। यह ब्राउज़र पृष्ठों को संचालित कर सकता है और API कुंजियों का उपयोग कर सकता है, इसलिए संवेदनशील डेटा के साथ उपयोग करने से पहले सुरक्षा मॉडल की समीक्षा करें।

Chromium प्राथमिक उत्पाद लक्ष्य है। Firefox समर्थन प्रयोगात्मक है। यह dedicated workers में एक्टर्स चलाता है और JavaScript कंप्यूट के लिए दृश्यमान Notebooks का उपयोग करता है। Chrome के offscreen document host की आवश्यकता वाली सुविधाओं को उपयोग से पहले Firefox नियंत्रणों और मॉडल उपकरणों से हटा दिया जाता है। Firefox प्रीव्यू पैकेज भी dweb को तब तक हटा देता है जब तक Firefox के पास mesh host नहीं होता।

कोड वर्तमान व्यवहार के लिए सत्य का स्रोत है। CLAUDE.md से शुरू करें, फिर extension/ के अंतर्गत प्रासंगिक मॉड्यूल पढ़ें।

यह क्या करता है

• Chrome और एक प्रयोगात्मक Firefox पैकेज में एजेंट लूप चलाता है।
• प्रति-वातावरण एक्टर्स के माध्यम से ब्राउज़र टैब पढ़ता और संचालित करता है।
• Linux WebVMs, JavaScript Notebooks, ब्राउज़र Apps और, जहाँ रनटाइम होस्ट उनका समर्थन करता है, headless स्क्रिप्ट चलाता है।
• क्लाउड और स्थानीय मॉडल प्रदाताओं का समर्थन करता है। लाइव सूची extension/peerd-provider/registry.js में है।
• प्रदाता रहस्यों को एक स्थानीय एन्क्रिप्टेड वॉल्ट में संग्रहीत करता है।
• प्रीव्यू बिल्ड में एक वैकल्पिक peer-to-peer dweb शामिल करता है।

Apps और WebVMs वर्तमान में केवल Chrome पर चलते हैं। Apps के पास कोई परिवेश नेटवर्क एक्सेस नहीं है। रिमोट संसाधन, fetches, WebRTC, फ़ॉर्म और बाहरी दस्तावेज़ नेविगेशन अवरुद्ध हैं। बाहरी HTTP और HTTPS लिंक के लिए उपयोगकर्ता पुष्टिकरण आवश्यक है।

सुरक्षा मॉडल

peerd ब्राउज़र अलगाव, संकीर्ण उपकरण एक्सपोज़र, service-worker नीति द्वार और स्पष्ट egress नियंत्रण का उपयोग करता है। मुख्य एजेंट वातावरण के कार्य को keyless एक्टर्स को सौंपता है। Chrome और Firefox पर, गैर-ऑर्केस्ट्रेटर एजेंट लूप अलग dedicated worker heaps में चलते हैं। यदि ब्राउज़र उस सीमा को साबित नहीं कर सकता है, तो एक्टर अनुरोध नहीं चलता है और अपने लक्ष्य पर कोई कार्य नहीं करता है।

नेटवर्क व्यवहार ऑपरेशन पर निर्भर करता है। मॉडल कॉल, वेब रीड, रनटाइम एसेट लोड, सैंडबॉक्स ट्रैफ़िक और प्रीव्यू dweb ट्रैफ़िक विभिन्न scoped पथों और नीतियों का उपयोग करते हैं। वर्तमान सीमाओं और ज्ञात कमियों के लिए SECURITY.md और threat model देखें।

इंस्टॉल करें

Chrome स्रोत से

1. रिपॉजिटरी क्लोन करें।
2. chrome://extensions खोलें।
3. Developer mode सक्षम करें।
4. Load unpacked चुनें और extension/ निर्देशिका चुनें।

स्रोत परिवर्तनों के बाद chrome://extensions से एक्सटेंशन पुनः लोड करें।

Firefox स्रोत से

Firefox को एक Firefox-विशिष्ट पैकेज की आवश्यकता होती है। चेक-इन किए गए Chrome विकास manifest को लोड न करें। manifests/ के अंतर्गत चैनल पैच में घोषित न्यूनतम से ऊपर या उसके बराबर Firefox संस्करण का उपयोग करें। वह न्यूनतम स्तर ब्राउज़र उपकरणों द्वारा उपयोग किए जाने वाले document-bound scripting समर्थन को ट्रैक करता है।

bun run package -- --channel=preview --browser=firefox --no-sign

about:debugging#/runtime/this-firefox खोलें, Load Temporary Add-on चुनें, और artifacts/peerd-preview-firefox.xpi चुनें। Firefox पुनः आरंभ होने के बाद अस्थायी add-ons को फिर से लोड किया जाना चाहिए। ब्राउज़र और चैनल ट्रांसफ़ॉर्म पैकेजिंग स्क्रिप्ट द्वारा परिभाषित किए जाते हैं।

रिलीज़ पैकेज

वर्तमान artifacts के लिए GitHub Releases देखें। स्टोर और प्रीव्यू बिल्ड अलग-अलग हैं। स्टोर बिल्ड dweb को हटा देते हैं। प्रीव्यू बिल्ड इसे शामिल करते हैं और अतिरिक्त स्वचालन सुविधाओं को सक्षम कर सकते हैं। पैकेजिंग कोड प्रत्येक ब्राउज़र और चैनल के लिए प्राधिकारी है।

पहला रन

1. ब्राउज़र टूलबार से peerd खोलें।
2. स्थानीय वॉल्ट बनाएँ और अनलॉक करें। पासफ़्रेज़ अनलॉक हमेशा उपलब्ध है। Passkey अनलॉक ब्राउज़र और डिवाइस में WebAuthn PRF समर्थन पर निर्भर करता है।
3. छोटा प्रोफ़ाइल onboarding पूरा करें।
4. Settings खोलें, फिर एक प्रदाता कुंजी जोड़ें या एक समर्थित स्थानीय प्रदाता चुनें।
5. एक मॉडल चुनें और चैट शुरू करें।

केवल वॉल्ट रहस्य और संरक्षित सुरक्षा रिकॉर्ड वॉल्ट एन्क्रिप्शन सीमा के अंतर्गत आते हैं। अन्य स्थानीय एक्सटेंशन स्थिति सुरक्षा दस्तावेज़ में स्टोरेज नियमों का पालन करती है।

आर्किटेक्चर

एक्सटेंशन में पाँच मुख्य मॉड्यूल हैं। प्रत्येक मॉड्यूल अपनी सार्वजनिक API को अपने index.js के माध्यम से उजागर करता है।

एक्सटेंशन चेसिस background/, offscreen/, sidepanel/, engine-tabs/, permissions/, shared/ और संबंधित समर्थन निर्देशिकाओं में रहता है।

विकास

शिप किया गया एक्सटेंशन ES मॉड्यूल के साथ vanilla JavaScript है और इसमें कोई bundling या transpilation नहीं है। Bun का उपयोग परीक्षण, जनरेशन, पैकेजिंग और रिलीज़ जाँच के लिए किया जाता है।

bun install
bun run gen:dev
bun test ./tests
bun scripts/cdp/run-inbrowser-tests.mjs
bun run typecheck
bun run lint
bun run e2e:verify
bun run preflight

तीन परीक्षण सतहें हैं:

• शुद्ध तर्क के लिए Bun परीक्षण।
• एक्सटेंशन और ब्राउज़र एकीकरण के लिए in-browser परीक्षण।
• पूर्ण प्रवाहों के लिए लाइव Chrome E2E और दृश्य सत्यापन।

UI परिवर्तनों के लिए, bun run e2e:verify चलाएँ, scripts/cdp/artifacts/result.json का निरीक्षण करें, और उत्पन्न स्क्रीनशॉट का निरीक्षण करें।

उत्पन्न फ़ाइलों को हाथ से संपादित नहीं किया जाना चाहिए। विशेष रूप से, extension/manifest.json और extension/shared/channel-config.js manifest और पैकेजिंग स्रोतों से आते हैं। CI उन्हें drift के लिए जाँचता है।

कोड बदलने से पहले CONTRIBUTING.md पढ़ें।

दस्तावेज़

• CLAUDE.md: प्रोजेक्ट संरचना, परंपराएँ और वर्तमान स्थिति
• SECURITY.md: सुरक्षा नीति और रिपोर्टिंग
• docs/security/THREAT-MODEL.md: विश्वास सीमाएँ और अवशिष्ट जोखिम
• docs/security/LIFECYCLE-CONTRACT.md: व्यवधान व्यवहार और पुनर्प्राप्ति सीमाएँ
• docs/security/RED-TEAM-RESULTS.md: red-team कवरेज
• docs/store/: स्टोर पैकेजिंग, अनुमतियाँ, गोपनीयता और समीक्षक नोट
• scripts/cdp/GALLERY.md: E2E और दृश्य स्थितियाँ

docs/design/ के अंतर्गत डिज़ाइन रिकॉर्ड point-in-time प्रस्ताव हैं। वे पिछले निर्णयों और नियोजित कार्य की व्याख्या करते हैं। वे वर्तमान कोड को ओवरराइड नहीं करते हैं।

निर्भरताएँ और लाइसेंस

रनटाइम निर्भरताएँ extension/vendor/ के अंतर्गत vendored हैं। उनके स्रोत, संस्करण, लाइसेंस और अखंडता रिकॉर्ड आसन्न SOURCE.txt फ़ाइलों और extension/vendor/vendor.lock.json में रहते हैं।

peerd Apache License 2.0 के अंतर्गत लाइसेंस प्राप्त है। Vendored घटक अपने स्वयं के लाइसेंस बनाए रखते हैं। CheerpX Leaning Technologies द्वारा प्रदान किया गया एक स्वामित्व रनटाइम है और यह peerd के Apache लाइसेंस के अंतर्गत कवर नहीं है।