@agent-native/core 0.76.5 → 0.76.6

package/corpus/core/docs/content/locales/hi-IN/what-is-agent-native.md

@@ -0,0 +1,202 @@
+---
+title: "Agent-Native क्या है?"
+description: "अधिकांश AI ऐप्स आधे-अधूरे क्यों लगते हैं, क्या चीज़ किसी ऐप को वास्तव में एजेंट-नेटिव बनाती है, और परिणामस्वरूप आपका दिन-प्रतिदिन का अनुभव कैसा दिखता है।"
+---
+
+# Agent-Native क्या है?
+
+एजेंट-नेटिव सॉफ्टवेयर बनाने का एक तरीका है जहां एआई एजेंट और उसके आसपास की उत्पाद सतह **समान भागीदार** हैं। वह सतह एक कस्टम कार्रवाई, एक समृद्ध चैट या पूर्ण UI के साथ एक हेडलेस एजेंट हो सकती है। महत्वपूर्ण बात यह है कि एजेंट और मनुष्य समान actions, डेटाबेस और स्थिति साझा करते हैं।
+
+यदि आपको इस पृष्ठ से केवल एक ही बात याद है, तो इसे याद रखें: अधिकांश AI ऐप्स आज उपयोगी होने से एक कदम पीछे रह गए हैं, और वह अंतर इस समय इस क्षेत्र में सबसे बड़ी गलती है।
+
+## एक उपयोगकर्ता के रूप में यह कैसा दिखता है {#what-it-looks-like}
+
+एक बैकग्राउंड वर्कर, इनबॉक्स, कैलेंडर, फॉर्म बिल्डर, या एनालिटिक्स डैशबोर्ड का चित्र बनाएं। कभी-कभी अभी तक कोई कस्टम स्क्रीन नहीं है: आप एक क्रिया या एक हेडलेस ऐप-एजेंट प्रॉम्प्ट चलाते हैं। कभी-कभी पहली स्क्रीन चैट होती है: आप पूछते हैं कि आप क्या चाहते हैं, एजेंट सेटअप का मार्गदर्शन करता है, एक तालिका या चार्ट दिखाता है, और सही ऐप दृश्य खोलता है। कभी-कभी चैट को पूर्ण एप्लिकेशन के दाईं ओर डॉक किया जाता है। उन आकृतियों के पार, आप यह कर सकते हैं:
+
+- **वास्तविक ऑपरेशन से शुरू करें।** एक टिकाऊ कार्रवाई CLI, HTTP, MCP, A2A, ऐप-एजेंट लूप और बाद में UI से चल सकती है।
+- **किसी भी चीज़ पर क्लिक करें जिसे आप आमतौर पर UI होने पर क्लिक करते हैं।** सभी बटन, सूचियाँ, डैशबोर्ड, कीबोर्ड शॉर्टकट - वे सभी उसी ऑपरेशन को कॉल करते हैं जिसे एजेंट कॉल कर सकता है।
+- **या बस पूछें।** एजेंट में "सारा के उस ईमेल का जवाब दें जिसमें कहा गया है कि मैं 3 बजे तक वहां पहुंच जाऊंगा" टाइप करें। यह सही थ्रेड खोलता है, उत्तर का मसौदा तैयार करता है, और इसे आपको अनुमोदन के लिए दिखाता है - ठीक उसी तरह जैसे कि आपने इसे हाथ से बनाया हो।
+- **देखें कि यह क्या देखता है।** एक ईमेल खोलें, और एजेंट को पता चल जाएगा कि कौन सा ईमेल है। एक चार्ट चुनें, और एजेंट को पता है कि कौन सा चार्ट है। एक पैराग्राफ को हाइलाइट करें और Cmd+I दबाएं, और एजेंट केवल उस पैराग्राफ पर कार्य करता है।
+- **इसे काम करते हुए देखें।** जैसे ही एजेंट काम करता है - दृश्य खोलता है, ड्राफ्ट संपादित करता है, रिपोर्ट चलाता है - UI वास्तविक समय में अपडेट होता है। आप इसे रोक सकते हैं, इसे पुनर्निर्देशित कर सकते हैं, या किसी भी क्षण माउस से इसे अपने नियंत्रण में ले सकते हैं।
+- **इसे एक टीम के साथी की तरह चलाएं।** फीडबैक दें, दूसरे कार्य को कतारबद्ध करें, इसके निर्देशों को संपादित करें, कल जो किया उसका ऑडिट करें। यह याद रखता है, और यह समय के साथ आपके वर्कफ़्लो में बेहतर होता जाता है।
+
+यही वह अनुभव है जिसके लिए एजेंट-नेटिव को डिज़ाइन किया गया है। अब यहाँ बताया गया है कि अधिकांश उत्पाद वहाँ क्यों नहीं पहुँचते।
+
+## ज्यादातर "एआई ऐप्स" क्यों कम पड़ जाते हैं (सीढ़ी सिद्धांत) {#the-ladder}
+
+एक प्रगति है कि अधिकांश टीमें सीढ़ी की तरह चढ़ती हैं, और अधिकांश एक पायदान पहले ही रुक जाती हैं।
+
+### रंग 1 - एक एकल LLM कॉल (एंटी-पैटर्न) {#rung-one}
+
+एक टेक्स्ट बॉक्स एक संकेत भेजता है, एआई एक स्ट्रिंग लौटाता है, और आप इसे प्रदर्शित करते हैं। शायद एक स्पिनर के साथ. उपयोगकर्ता के लिए पाठ्यक्रम-सही करने का कोई तरीका नहीं है, एआई के लिए कार्रवाई करने का कोई तरीका नहीं है, यह देखने का कोई तरीका नहीं है कि क्या हुआ या क्यों हुआ।
+
+आप इसे हर जगह देखते हैं: "एआई फीचर्स" जो मूल रूप से एक "सारांश" बटन हैं जो एक SaaS उत्पाद पर बोल्ट किया गया है। वे डेमो में प्रभावशाली दिखते हैं और जैसे ही वास्तविकता गड़बड़ाती है, वे टूट जाते हैं। वह कोई उत्पाद नहीं है; वह एक खिलौना है।
+
+### रंग 2 - टूल के साथ एक चैट {#rung-two}
+
+अब AI काम कर सकता है। इसमें टूल हैं - "ड्राफ्ट ईमेल," "संपर्क खोजें," "क्वेरी चलाएं" - और एक चैट इंटरफ़ेस जहां यह आपके सामने काम करता है, टूल कॉल और परिणाम दिखाता है। हुड के नीचे Claude, ChatGPT और कर्सर इस तरह दिखते हैं।
+
+यह एक वास्तविक कदम है। लेकिन अपने आप में, यह अभी भी एक चैट विंडो है। कोई उचित UI नहीं है। कोई डैशबोर्ड नहीं, कोई सूची नहीं, कोई फॉर्म नहीं, कोई कीबोर्ड शॉर्टकट नहीं, कोई टीम सहयोग नहीं। यदि एआई भ्रमित हो जाता है, तो आप सही बटन पर क्लिक करने के बजाय दोबारा टाइप करने में फंस जाते हैं। गैर-डेवलपर्स को इस प्रारूप में वास्तविक कार्य करने के लिए संघर्ष करना पड़ता है।
+
+### चरण 3 - एजेंट + UI बराबर भागीदार के रूप में {#rung-three}
+
+यह एजेंट-मूल है। आप एजेंट के चारों ओर एक वास्तविक, पूर्ण-विशेषताओं वाला ऐप जोड़ते हैं - और महत्वपूर्ण रूप से, एजेंट जो भी कार्रवाई कर सकता है वह UI में एक बटन भी है, और उपयोगकर्ता द्वारा क्लिक किया गया प्रत्येक बटन उसी तर्क को चलाता है जो एजेंट उपयोग करता है। एक कार्यान्वयन, दो तरीके।
+
+जब आप क्रमांक 3 पर पहुंचते हैं तो तीन चीजें बदल जाती हैं:
+
+- **आपने चैटबॉट में बटन जोड़ना बंद कर दिया है। आपने एक ऐप में एक एजेंट जोड़ा है।** यह दोनों तरफ से बहुत उच्च गुणवत्ता वाला उत्पाद है।
+- **एजेंट के पास वास्तविक संदर्भ होता है।** यह देखता है कि आप क्या देख रहे हैं, आपने क्या चुना है, आपने अभी क्या किया है। यह उसी डेटाबेस पर लिखता है जिससे UI पढ़ता है, इसलिए इसका काम तुरंत दिखाई देता है।
+- **बाहरी एजेंट भी इसका उपयोग कर सकते हैं।** अन्य एजेंट-मूल ऐप्स इसे [A2A protocol](/docs/a2a-protocol) पर actions पर कॉल कर सकते हैं। Claude कोड, Codex, ChatGPT कस्टम MCP ऐप्स, कर्सर और अन्य MCP होस्ट इसे [MCP server](/docs/mcp-protocol) के रूप में चला सकते हैं। एक ऐप, कई प्रवेश बिंदु।
+
+वह क्रमांक 3 है। वह एजेंट-नेटिव है।
+
+```an-diagram title="The Ladder Principle" summary="Most teams stop at rung 1 or 2. Agent-native is rung 3 — a real app and a real agent over one shared action surface."
+{
+  "html": "<div class=\"diagram-ladder\"><div class=\"diagram-card rung rung-3\"><span class=\"diagram-pill accent\">Rung 3 · agent-native</span><strong>Agent + UI as equal partners</strong><small class=\"diagram-muted\">One action surface. Every agent tool is also a button; every button runs the same logic the agent uses.</small></div><div class=\"diagram-card rung rung-2\"><span class=\"diagram-pill\">Rung 2</span><strong>A chat with tools</strong><small class=\"diagram-muted\">The agent can act — but it is still just a chat window. No dashboards, lists, or shortcuts.</small></div><div class=\"diagram-card rung rung-1\"><span class=\"diagram-pill warn\">Rung 1</span><strong>A single LLM call</strong><small class=\"diagram-muted\">Prompt in, string out. Impressive in a demo; breaks the moment reality gets messy.</small></div></div>",
+  "css": ".diagram-ladder{display:flex;flex-direction:column;gap:14px}.diagram-ladder .rung{display:flex;flex-direction:column;gap:6px;padding:16px 18px}.diagram-ladder .rung-2{margin-inline-end:48px}.diagram-ladder .rung-1{margin-inline-end:96px}"
+}
+```
+
+[Key Concepts — Protocols](/docs/key-concepts#protocols) देखें कि कैसे यह सब एक ही क्रिया परिभाषा पर आधारित है।
+
+## प्रत्येक एजेंट को UI की आवश्यकता क्यों है {#why-every-agent-needs-a-ui}
+
+यहां तक कि जब एजेंट सभी भारी सामान उठाता है, तब भी मनुष्यों को इसकी आवश्यकता होती है:
+
+- **देखें कि यह क्या कर रहा है** — प्रगति, मध्यवर्ती आउटपुट, इसने क्या छुआ
+- **इसे संचालित करें** - प्रतिक्रिया दें, बीच में रोकें, अगले कार्य को कतारबद्ध करें
+- **इसे प्रबंधित करें** - इसके निर्देश, skills, मेमोरी, शेड्यूल किए गए कार्य, कनेक्टेड खाते संपादित करें
+- **इसके कार्य का निरीक्षण करें** - ड्राफ्ट, ऑडिट इतिहास, रोल बैक गलतियों की समीक्षा करें
+- **इसके आउटपुट को साझा करें** - टीम के साथियों को भेजने के लिए डैशबोर्ड, रिपोर्ट, फॉर्म, लिंक
+
+कम से कम, "एजेंट के लिए एक UI" एक अवलोकन और प्रबंधन डैशबोर्ड है। अधिकतम, यह एक पूर्ण SaaS ऐप है जिसमें एजेंट सह-पायलट के रूप में एम्बेडेड है। दोनों सिरे एजेंट-नेटिव के रूप में गिने जाते हैं, और सतह बिना पुनर्लेखन के एक से बढ़ सकती है।
+
+आपको सामने से कोई आकृति चुनने की ज़रूरत नहीं है। एजेंट बिना सोचे-समझे दौड़ सकता है, एक समृद्ध चैट के पीछे बैठ सकता है, या एक ही क्रिया सतह के आसपास एक पूर्ण एप्लिकेशन के अंदर रह सकता है - ठोस आकृतियों और APIs के लिए [Agent Surfaces](/docs/agent-surfaces) देखें।
+
+## प्रत्येक ऐप को एक एजेंट से लाभ क्यों होता है {#why-every-app-benefits-from-an-agent}
+
+दूसरा पहलू भी उतना ही महत्वपूर्ण है। मौजूदा SaaS उत्पाद एक ही स्थिति में बने रहते हैं: आपकी ज़रूरत का 80% बढ़िया काम करता है, और 20% आप बदल नहीं सकते। चैट साइडबार जोड़ने से यह शायद ही कभी ठीक होता है - चैट आमतौर पर वह चीजें नहीं कर सकती जो UI कर सकता है।
+
+एजेंट-नेटिव उसे फ़्लिप करता है। क्योंकि ऐप में प्रत्येक क्रिया को एक बार परिभाषित किया जाता है और एक बटन और एक एजेंट टूल दोनों के रूप में प्रदर्शित किया जाता है, एजेंट वह सब कुछ कर सकता है जो बटन कर सकते हैं - और भी बहुत कुछ - बनाए रखने के लिए एक अलग "एआई दुनिया" के बिना। क्लिक के साथ-साथ प्राकृतिक भाषा प्रथम श्रेणी का इनपुट बन जाती है।
+
+तर्क यह नहीं है कि "एजेंट UI को प्रतिस्थापित करते हैं।" यह "**एजेंट अनुप्रयोगों के अंदर होते हैं, शीर्ष पर UI के साथ, समान भागीदार के रूप में**।" यहां तक कि एक ऐप जहां एजेंट उत्पाद है, उसे अभी भी मनुष्यों द्वारा पर्यवेक्षण, कॉन्फ़िगर और संचालित करने के लिए UI की आवश्यकता होती है - [Agent Surfaces — Headless](/docs/agent-surfaces#headless) देखें।
+
+## एजेंट + UI समता {#agent-ui-parity}
+
+यह परिभाषित सिद्धांत है।
+
+> **UI से** - बटन क्लिक करें, फॉर्म भरें, दृश्य नेविगेट करें। UI डेटाबेस को लिखता है; एजेंट परिणाम देखता है।
+>
+> **एजेंट से** - प्राकृतिक भाषा, A2A, Slack, टेलीग्राम के माध्यम से अन्य एजेंट। एजेंट डेटाबेस को लिखता है; UI स्वचालित रूप से अपडेट हो जाता है।
+
+```an-diagram title="One system, two ways in" summary="The agent and the UI write to the same actions and the same database. Whatever one does, the other sees."
+{
+  "html": "<div class=\"diagram-parity\"><div class=\"diagram-col\"><div class=\"diagram-node\">Human<br><small class=\"diagram-muted\">clicks, forms, shortcuts</small></div><div class=\"diagram-node\">Agent<br><small class=\"diagram-muted\">natural language · A2A · Slack</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Actions</span><small class=\"diagram-muted\">defined once</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">SQL database</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-box\">UI updates live</div></div>",
+  "css": ".diagram-parity{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-parity .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-parity .diagram-arrow{font-size:22px;line-height:1}.diagram-parity .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+}
+```
+
+जब एजेंट एक ड्राफ्ट ईमेल बनाता है, तो यह UI में दिखाई देता है। जब आप "भेजें" पर क्लिक करते हैं, तो एजेंट को पता चल जाता है कि यह भेजा गया था। कोई अलग "एजेंट वर्ल्ड" और "UI वर्ल्ड" नहीं है - यह एक प्रणाली है। उस आर्किटेक्चर के लिए [Key Concepts](/docs/key-concepts) देखें जो यह काम करता है।
+
+## अनुकूलन आमतौर पर बिजली उपकरणों के लिए आरक्षित होता है {#workspace-customization}
+
+Claude कोड जैसे टूल के इतना शक्तिशाली महसूस होने का कारण मॉडल नहीं है - यह ** अनुकूलन परत** है: प्रति-प्रोजेक्ट निर्देश, skills, मेमोरी, उप-एजेंट, कनेक्टेड सेवाएं। आप एजेंट को अपने कोडबेस, अपनी प्राथमिकताओं, अपनी टीम के अनुसार आकार दे सकते हैं।
+
+एजेंट-नेटिव प्रत्येक उपयोगकर्ता को वही अनुकूलन परत देता है - ऐप को छोड़े बिना। प्रत्येक ऐप एक व्यक्तिगत **कार्यस्थान** के साथ आता है जहां आप (या आपकी टीम में कोई भी) यह कर सकते हैं:
+
+- टीम-व्यापी नियमों को संपादित करें जिन्हें हर कोई एजेंट पढ़ता है
+- जैसे ही आप इसे ठीक करते हैं, एजेंट को प्राथमिकताएं स्वचालित रूप से याद रखने दें
+- `/slash` कमांड के रूप में पुन: प्रयोज्य कैसे करें मार्गदर्शिकाएँ लिखें
+- विशिष्ट कार्यों के लिए कस्टम उप-एजेंट रखें (`@mentions` के साथ लागू)
+- क्रोन पर चलने के लिए नौकरियों को शेड्यूल करें (उदाहरण के लिए "प्रत्येक सोमवार की सुबह, पिछले सप्ताह का सारांश")
+- प्रति-उपयोगकर्ता MCP सर्वर के माध्यम से बाहरी सेवाओं (Gmail, Stripe, Slack, आंतरिक APIs) को कनेक्ट करें
+
+मोड़: यह सब डेटाबेस में संग्रहीत है, फ़ाइल सिस्टम में नहीं। स्पिन अप करने के लिए कोई देव वातावरण नहीं है, प्रति उपयोगकर्ता कोई कंटेनर नहीं है। प्रत्येक उपयोगकर्ता को अपना पूरा कार्यक्षेत्र - व्यक्तिगत मेमोरी, व्यक्तिगत कनेक्शन, व्यक्तिगत skills - अनिवार्य रूप से निःशुल्क मिलता है, क्योंकि यह एक तालिका में सभी पंक्तियाँ हैं। यही चीज़ Claude-कोड-स्तरीय लचीलेपन को एक वास्तविक बहु-किरायेदार SaaS उत्पाद के अंदर व्यवहार्य बनाती है।
+
+संपूर्ण अवधारणा के लिए [Workspace](/docs/workspace) देखें।
+
+## क्या चीज़ इसे अलग बनाती है {#what-makes-it-different}
+
+| दृष्टिकोण                           | विवरण                                                                                                                                              |
+| ----------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **एआई के साथ पारंपरिक ऐप्स पर जोर** | एआई एक बाद का विचार है। स्वतः पूर्ण, सारांश, या चैट साइडबार तक सीमित जो वास्तव में ऐप में कुछ भी नहीं कर सकता।                                     |
+| **शुद्ध चैट/एजेंट इंटरफ़ेस**        | शक्तिशाली लेकिन दुर्गम। कोई डैशबोर्ड नहीं, कोई वर्कफ़्लो नहीं, कोई दृढ़ता नहीं। गैर-डेवलपर्स उनका प्रभावी ढंग से उपयोग नहीं कर सकते।               |
+| **Claude कोड / SaaS के लिए Codex**  | डेवलपर्स के लिए अपनी मशीनों पर बढ़िया। बहु-किरायेदार SaaS में अनुवाद नहीं करता है - एक डेव-बॉक्स पर प्रति उपयोगकर्ता एक कोडबेस स्केल नहीं करता है। |
+| **एजेंट-मूल ऐप्स**                  | एजेंट प्रथम श्रेणी का नागरिक है। यह समान डेटाबेस, समान स्थिति साझा करता है, और वह सब कुछ कर सकता है जो UI कर सकता है - और इसके विपरीत।             |
+
+## संपूर्ण-टीम विकास {#whole-team-development}
+
+एजेंट-नेटिव केवल डेवलपर्स के लिए नहीं है। क्योंकि एजेंट ऐप के स्वयं के कोड को संपादित कर सकता है, ऐप को विकसित करना केवल डेवलपर की गतिविधि नहीं रह जाता है:
+
+- **डिज़ाइनर** एजेंट के माध्यम से सीधे चल रहे ऐप में डिज़ाइन अपडेट करते हैं
+- **उत्पाद प्रबंधक** उनका वर्णन करके कार्यक्षमता और अद्यतन प्रवाह जोड़ते हैं
+- **QA** ऐप का परीक्षण करता है और एजेंट से जो टूटा हुआ है उसे ठीक करने के लिए कहता है
+- **टीम में कोई भी** प्राकृतिक भाषा के माध्यम से योगदान देता है
+
+दृष्टिकोण: कम हैंडऑफ़, एक व्यक्ति छोटी टीम का काम कर रहा है।
+
+## फोर्क करें और अनुकूलित करें {#fork-and-customize}
+
+एजेंट-नेटिव ऐप्स फोर्क-एंड-कस्टमाइज़ मॉडल का पालन करते हैं। आप एक **टेम्पलेट** से शुरू करें - कैलेंडर, सामग्री, स्लाइड, एनालिटिक्स, मेल, क्लिप्स, डिज़ाइन, फॉर्म, डिस्पैच - और इसे अपना बनाएं। प्रत्येक एक पूर्ण, कार्यशील SaaS उत्पाद है जिसे आप थोक में बेचते हैं, कोई खाली मचान नहीं:
+
+1. [agent-native.com/templates](/templates) पर एक टेम्पलेट चुनें
+2. इसे तुरंत होस्ट किए गए ऐप के रूप में उपयोग करें (उदाहरण के लिए mail.agent-native.com)
+3. जब आप कस्टमाइज़ करना चाहते हैं तो इसे फोर्क करें - "हमारा स्ट्राइप खाता कनेक्ट करें," "एक समूह चार्ट जोड़ें"
+4. एजेंट आपकी आवश्यकताओं से मेल खाने के लिए कोड को संशोधित करता है
+5. अपने फ़ोर्क को अपने स्वयं के डोमेन पर तैनात करें - या एजेंट-नेटिव.कॉम पर बने रहें
+
+क्योंकि यह _आपका_ ऐप है, साझा बुनियादी ढांचा नहीं, एजेंट सुरक्षित रूप से कोड विकसित कर सकता है। जैसे-जैसे आप इसका उपयोग करते हैं, आपका ऐप बेहतर होता जाता है। पूरी कहानी के लिए [Templates](/docs/cloneable-saas) देखें।
+
+पूरे टेम्पलेट को फोर्क करने के लिए तैयार नहीं हैं? आप पहले से उपयोग किए जा रहे कोडिंग एजेंट में **कौशल** जोड़कर एजेंट-नेटिव को भी आज़मा सकते हैं - `npx @agent-native/core@latest skills add visual-plan` के साथ प्लान कौशल स्थापित करें। [Skills Guide](/docs/skills-guide#app-backed-skills) देखें.
+
+## कंपोज़ेबल एजेंट {#composable-agents}
+
+एजेंट-नेटिव ऐप्स एक-दूसरे से बात कर सकते हैं। मेल ऐप के अंदर से, आप डेटा को क्वेरी करने और ड्राफ्ट ईमेल में परिणाम शामिल करने के लिए एनालिटिक्स एजेंट को टैग कर सकते हैं। एजेंट पता लगाते हैं कि अन्य एजेंट क्या उपलब्ध हैं, एक-दूसरे के बीच काम सौंपते हैं, और उस UI में परिणाम सामने लाते हैं जिसमें आप पहले से ही हैं।
+
+यह हुड के नीचे [A2A](/docs/a2a-protocol) और [MCP](/docs/mcp-protocol) द्वारा संचालित है - एक ही परिभाषा, कई सतहें - लेकिन एक उपयोगकर्ता के रूप में, आपको बस इतना जानना है कि "मैं अपने किसी भी ऐप से किसी भी चीज़ के लिए मदद मांग सकता हूं जो उनमें से कोई भी कर सकता है।"
+
+## कोड में यह कैसा दिखता है? {#what-does-it-look-like-in-code}
+
+यदि आप एक एजेंट-नेटिव ऐप बना रहे हैं या उसका विस्तार कर रहे हैं, तो यहां केंद्रीय पैटर्न है: ऐप में प्रत्येक ऑपरेशन एक **एक्शन** है - जिसे एक बार परिभाषित किया गया है, जो एजेंट और UI दोनों के लिए उपलब्ध है।
+
+```an-annotated-code title="One action, defined once"
+{
+  "filename": "actions/reply-to-email.ts",
+  "language": "ts",
+  "code": "import { defineAction } from \"@agent-native/core/action\";\nimport { z } from \"zod\";\n\nexport default defineAction({\n  description: \"Reply to an email thread\",\n  schema: z.object({ emailId: z.string(), body: z.string() }),\n  run: async ({ emailId, body }) => {\n    // db and schema come from your app's server/db setup\n    await db.insert(schema.replies).values({ emailId, body });\n  },\n});",
+  "annotations": [
+    { "lines": "5", "label": "Tool surface", "note": "The `description` is what the agent reads to decide when to call this as a tool." },
+    { "lines": "6", "label": "Typed contract", "note": "One zod `schema` validates input from **every** surface — agent, UI, HTTP, MCP, and A2A." },
+    { "lines": "7-10", "label": "One implementation", "note": "The `run` body is the single source of truth. The UI button and the agent tool both execute exactly this." }
+  ]
+}
+```
+
+```tsx
+// In any React component — same action, called from a button
+const { mutate } = useActionMutation("reply-to-email");
+
+<Button onClick={() => mutate({ emailId, body: "Thanks!" })}>
+  Send Reply
+</Button>;
+```
+
+```tsx
+// And the agent panel mounted anywhere in your app
+import { AgentSidebar } from "@agent-native/core/client";
+
+<AgentSidebar />;
+```
+
+एक कार्रवाई, कई सतहें: एजेंट इसे एक उपकरण के रूप में कहता है, UI इसे एक टाइपसेफ़ म्यूटेशन के रूप में कहता है, [native chat](/docs/native-chat-ui) स्पष्ट विजेट परिणाम प्रस्तुत कर सकता है, बाहरी एजेंट इसे [A2A](/docs/a2a-protocol) पर पहुंचा सकते हैं, और MCP होस्ट इसे ऐप के [MCP server](/docs/mcp-protocol) के माध्यम से कॉल करते हैं, वैकल्पिक रूप से MCP ऐप्स UI संसाधनों और मानक रिमोट MCP के साथ OAuth फ्रेमवर्क द्वारा नियंत्रित किया जाता है। संपूर्ण संदर्भ के लिए [Actions](/docs/actions) देखें।
+
+## आगे क्या {#whats-next}
+
+- [**Getting Started**](/docs/getting-started) - एक क्रिया से शुरू करें, एक टेम्पलेट चुनें, या एक कौशल स्थापित करें
+- [**Agent Surfaces**](/docs/agent-surfaces) - हेडलेस, रिच चैट, एम्बेडेड साइडकार, या पूर्ण ऐप चुनें
+- [**Key Concepts**](/docs/key-concepts) - आर्किटेक्चर: SQL, actions, पोलिंग सिंक, संदर्भ जागरूकता, पोर्टेबिलिटी
+- [**Templates**](/docs/cloneable-saas) - आपके स्वामित्व वाले संपूर्ण उत्पादों के रूप में टेम्पलेट
+- [**Workspace**](/docs/workspace) - प्रति-उपयोगकर्ता अनुकूलन परत (skills, मेमोरी, निर्देश, MCP) SQL द्वारा समर्थित है, फ़ाइलें नहीं
+- [**Dispatch**](/docs/dispatch) - कार्यक्षेत्र नियंत्रण विमान: रहस्य वॉल्ट, Slack/ईमेल इनबॉक्स, क्रॉस-ऐप प्रतिनिधिमंडल
+- [**Extensions**](/docs/extensions) - सैंडबॉक्स्ड मिनी-ऐप्स एजेंट बिना कोड परिवर्तन के तुरंत बनाता है
+- [**Drop-in Agent**](/docs/drop-in-agent) - `<AgentPanel>` को किसी भी React ऐप में माउंट करें

package/corpus/core/docs/content/locales/hi-IN/workspace-connections.md

@@ -0,0 +1,321 @@
+---
+title: "कार्यस्थान कनेक्शन"
+description: "कनेक्ट-वन्स-यूज़-एवरीव्हेयर इंटीग्रेशन के लिए साझा प्रदाता मेटाडेटा, अनुदान और क्रेडेंशियल संदर्भ।"
+---
+
+# कार्यस्थान कनेक्शन
+
+कार्यस्थान कनेक्शन पुन: प्रयोज्य एकीकरण मेटाडेटा के लिए रूपरेखा आदिम हैं। वे "एक बार कनेक्ट करें, ऐप्स प्रदान करें, क्रेडेंशियल्स का पुन: उपयोग करें" को संभव बनाते हैं, बिना यह दिखावा किए कि प्रत्येक प्रदाता पूरी तरह से सामान्य है।
+
+## त्वरित प्रारंभ {#quickstart}
+
+### चार अवधारणाएँ
+
+- **कनेक्शन** - एक नामित प्रदाता खाता (`team-slack`, `acme-hubspot`)। रिकॉर्ड प्रदाता आईडी, खाता लेबल, स्थिति, कार्यक्षेत्र और सुरक्षित कॉन्फ़िगरेशन। कभी भी गुप्त मूल्यों को संग्रहीत नहीं करता।
+- **अनुदान** - किसी विशिष्ट ऐप को कनेक्शन का उपयोग करने की अनुमति। बिना अनुदान वाला कोई ऐप कनेक्शन के क्रेडेंशियल नहीं देख सकता।
+- **credentialRef** — एक वॉल्ट रहस्य का सूचक (`{ key: "SLACK_BOT_TOKEN", scope: "org" }`)। कनेक्शन बताता है कि टोकन कहाँ रहता है; तिजोरी मूल्य रखती है।
+- **तत्परता** - संयुक्त स्थिति जो एक ऐप देखता है: `connected` (मौजूद + क्रेडेंशियल्स), `needs_grant`, `needs_credentials`, `needs_attention`, या `not_configured`।
+
+```an-diagram title="Connect once, grant apps, reuse credentials" summary="A Connection holds provider metadata (never secrets) and credentialRefs that point at the vault. Per-app Grants unlock it. Apps read a single Readiness status."
+{
+  "html": "<div class=\"diagram-conn\"><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill accent\">Connection</span><div class=\"diagram-box\" data-rough>named provider account<br><small class=\"diagram-muted\">provider, label, status, scopes, config &middot; never stores secret values</small></div><div class=\"diagram-muted\">credentialRef &rarr; pointer to a vault secret</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill\">Grant</span><div class=\"diagram-box\" data-rough>per-app permission<br><small class=\"diagram-muted\">no grant = no credential access</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill ok\">Readiness</span><small class=\"diagram-muted\">what the app sees</small><div class=\"sev-row\"><span class=\"diagram-pill ok\">connected</span><span class=\"diagram-pill warn\">needs_grant</span></div><div class=\"sev-row\"><span class=\"diagram-pill warn\">needs_credentials</span><span class=\"diagram-pill warn\">needs_attention</span></div><div class=\"sev-row\"><span class=\"diagram-pill\">not_configured</span></div></div></div>",
+  "css": ".diagram-conn{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-conn .col{display:flex;flex-direction:column;gap:8px;padding:14px;min-width:220px}.diagram-conn .diagram-arrow{font-size:22px;line-height:1}.diagram-conn .sev-row{display:flex;gap:8px;flex-wrap:wrap}"
+}
+```
+
+### कार्यशील उदाहरण: Slack
+
+Slack को एक बार कनेक्ट करें और इसे ब्रेन और एनालिटिक्स को प्रदान करें:
+
+```ts
+import {
+  upsertWorkspaceConnection,
+  upsertWorkspaceConnectionGrant,
+} from "@agent-native/core/workspace-connections";
+
+await upsertWorkspaceConnection({
+  id: "acme-slack",
+  provider: "slack",
+  label: "Acme Slack",
+  accountId: "T012345",
+  accountLabel: "Acme",
+  status: "connected",
+  scopes: ["channels:history", "groups:history", "chat:write"],
+  config: {
+    teamDomain: "acme",
+    channelHints: ["product", "dev-fusion", "customer-success"],
+  },
+  credentialRefs: [{ key: "SLACK_BOT_TOKEN", scope: "org" }],
+});
+
+await upsertWorkspaceConnectionGrant({
+  connectionId: "acme-slack",
+  appId: "brain",
+});
+await upsertWorkspaceConnectionGrant({
+  connectionId: "acme-slack",
+  appId: "analytics",
+});
+```
+
+```an-schema title="The connection model" summary="A connection records safe provider metadata and credentialRefs (pointers, not secrets). Each grant unlocks one app — one connection, many grants."
+{
+  "entities": [
+    {
+      "id": "conn",
+      "name": "workspace_connections",
+      "note": "Named provider account. Never stores secret values.",
+      "fields": [
+        { "name": "id", "type": "string", "pk": true, "note": "e.g. acme-slack" },
+        { "name": "provider", "type": "string", "note": "stable provider id, e.g. slack" },
+        { "name": "label", "type": "string" },
+        { "name": "accountId", "type": "string", "nullable": true },
+        { "name": "accountLabel", "type": "string", "nullable": true },
+        { "name": "status", "type": "string", "note": "e.g. connected" },
+        { "name": "scopes", "type": "string[]", "nullable": true },
+        { "name": "config", "type": "json", "nullable": true, "note": "safe, non-secret config" },
+        { "name": "credentialRefs", "type": "json", "nullable": true, "note": "pointers to vault keys, e.g. { key, scope }" }
+      ]
+    },
+    {
+      "id": "grant",
+      "name": "workspace_connection_grants",
+      "note": "Per-app permission to use a connection.",
+      "fields": [
+        { "name": "connectionId", "type": "string", "fk": "conn.id" },
+        { "name": "appId", "type": "string", "note": "e.g. brain, analytics" }
+      ]
+    }
+  ],
+  "relations": [
+    { "from": "conn", "to": "grant", "kind": "1-n", "label": "grants apps" }
+  ]
+}
+```
+
+### ऐप्स क्या कॉल करते हैं
+
+किसी उपयोगकर्ता से नई कुंजी चिपकाने के लिए कहने से पहले, पहले उसकी तैयारी जांच लें:
+
+```ts
+import { listWorkspaceConnectionProviderCatalogForApp } from "@agent-native/core/workspace-connections";
+
+const catalog = await listWorkspaceConnectionProviderCatalogForApp({
+  appId: "brain",
+  templateUse: "brain",
+  provider: "slack",
+  includeConnections: "all",
+});
+
+const slack = catalog.providers[0];
+if (slack.workspaceConnection.grantState === "needs_grant") {
+  // Show "Grant Brain access" instead of asking for a second Slack token.
+}
+if (slack.readiness.status === "needs_credentials") {
+  // Show the missing credential ref names, never a secret value.
+}
+```
+
+## संदर्भ {#reference}
+
+### प्रदाता कैटलॉग
+
+`@agent-native/core/connections` से कैटलॉग आयात करें:
+
+```ts
+import {
+  getWorkspaceConnectionProvider,
+  listWorkspaceConnectionProvidersForTemplate,
+  workspaceConnectionProviderSupports,
+} from "@agent-native/core/connections";
+
+const brainProviders = listWorkspaceConnectionProvidersForTemplate("brain");
+const slack = getWorkspaceConnectionProvider("slack");
+
+if (workspaceConnectionProviderSupports("slack", "messages")) {
+  // Offer a Slack source, sync check, or onboarding step.
+}
+```
+
+प्रारंभिक प्रदाता आईडी हैं:
+
+| प्रदाता        | क्षमताएं                     | सामान्य उपयोग                   |
+| -------------- | ---------------------------- | ------------------------------- |
+| `slack`        | खोज, आयात, संदेश             | मस्तिष्क, प्रेषण, विश्लेषण      |
+| `github`       | खोज, आयात, कोड, दस्तावेज़    | मस्तिष्क, विश्लेषण, प्रेषण      |
+| `notion`       | खोजें, आयात करें, दस्तावेज़  | मस्तिष्क, सामग्री, प्रेषण       |
+| `gmail`        | खोज, आयात, संदेश             | मेल, मस्तिष्क, प्रेषण           |
+| `google_drive` | खोजें, आयात करें, दस्तावेज़  | मस्तिष्क, सामग्री, स्लाइड       |
+| `hubspot`      | खोजें, आयात करें, सीआरएम     | एनालिटिक्स, मस्तिष्क, मेल       |
+| `granola`      | खोज, आयात, मीटिंग, दस्तावेज़ | मस्तिष्क, कैलेंडर, प्रेषण       |
+| `clips`        | खोज, आयात, मीटिंग्स          | मस्तिष्क, क्लिप, वीडियो         |
+| `generic`      | खोजें, आयात करें, दस्तावेज़  | कस्टम webhooks और फ़ाइल ड्रॉप्स |
+
+क्रेडेंशियल कुंजियाँ केवल नाम हैं, जैसे `SLACK_BOT_TOKEN` या `GITHUB_TOKEN`। प्रदाता मेटाडेटा में कभी भी वास्तविक क्रेडेंशियल मान शामिल नहीं होने चाहिए।
+
+### कनेक्शन स्टोर API
+
+```ts
+import {
+  listWorkspaceConnectionProviderCatalogForApp,
+  listWorkspaceConnectionGrants,
+  listWorkspaceConnections,
+  summarizeWorkspaceConnectionProviderForApp,
+  summarizeWorkspaceConnectionProviderReadiness,
+  upsertWorkspaceConnection,
+  upsertWorkspaceConnectionGrant,
+  revokeWorkspaceConnectionGrant,
+} from "@agent-native/core/workspace-connections";
+
+const connections = await listWorkspaceConnections({ includeDisabled: true });
+const grants = await listWorkspaceConnectionGrants({ appId: "brain" });
+
+const appGrant = summarizeWorkspaceConnectionProviderForApp({
+  providerId: "slack",
+  appId: "brain",
+  connections,
+  grants,
+});
+
+const readiness = summarizeWorkspaceConnectionProviderReadiness({
+  provider: slack!,
+  appId: "brain",
+  connections,
+  grants,
+});
+
+const brainCatalog = await listWorkspaceConnectionProviderCatalogForApp({
+  appId: "brain",
+  templateUse: "brain",
+});
+```
+
+`credentialRefs` सरणी वॉल्ट कुंजियों पर इंगित करती है; यह क्रेडेंशियल भंडारण नहीं है. उदाहरण के लिए, `{ key: "SLACK_BOT_TOKEN", scope: "org" }` एक स्वीकृत ऐप को `SLACK_BOT_TOKEN` नामक ऑर्ग-स्कोप्ड वॉल्ट रहस्य को देखने के लिए कहता है, जब उसे Slack पर कॉल करने की आवश्यकता होती है। कनेक्शन-स्तर रेफरी प्रदाता खाते का वर्णन करता है; अनुदान-स्तर के रेफरी किसी विशिष्ट ऐप द्वारा उपयोग की जाने वाली चीज़ों को सीमित या ओवरराइड कर सकते हैं।
+
+जब कोई मौजूद होता है तो कनेक्शन पंक्तियाँ सक्रिय संगठन के दायरे में आ जाती हैं। बिना किसी संगठन के, उनका दायरा प्रमाणित उपयोगकर्ता तक होता है। अनुदान पंक्तियाँ समान दायरे का उपयोग करती हैं।
+
+**विरासत `allowedApps` फ़ील्ड:** `allowedApps: []` का अर्थ है कि समान दायरे में प्रत्येक ऐप कनेक्शन का उपयोग कर सकता है; `allowedApps: ["dispatch"]` विरासत क्षेत्र के माध्यम से पहुंच प्रदान करता है। नए सेटअप के लिए स्पष्ट `workspace_connection_grants` पंक्तियों का उपयोग करें - वे निरस्तीकरण, ऑडिट और प्रति-ऐप तैयारी को आसान बनाते हैं। `revokeWorkspaceConnectionGrant(connectionId, appId)` एक स्पष्ट अनुदान को हटा देता है लेकिन विरासत `allowedApps` को नहीं बदलता है।
+
+हैंड-रोलिंग अनुदान जांच के बजाय ऐप-फेसिंग स्थिति के लिए `summarizeWorkspaceConnectionProviderForApp()` और `summarizeWorkspaceConnectionProviderReadiness()` का उपयोग करें। साझा सारांश `grantState`, `grantAvailability`, सुरक्षित क्रेडेंशियल रेफरी नाम, प्रति-ऐप कनेक्शन पंक्तियाँ और `readyConnectionCount` और `missingRequiredCredentialKeys` जैसे तैयारी फ़ील्ड लौटाते हैं।
+
+नए ऐप सेटअप स्क्रीन के लिए, उच्च-स्तरीय सीमा के रूप में `listWorkspaceConnectionProviderCatalogForApp()` को प्राथमिकता दें - यह प्रदाता कैटलॉग, स्कोप्ड कनेक्शन, स्पष्ट अनुदान, प्रति-ऐप एक्सेस सारांश और प्रदाता की तैयारी को एक सुरक्षित आकार में जोड़ता है।
+
+### यह कैसे तिजोरी का पूरक है
+
+क्रेडेंशियल वॉल्ट उत्तर देता है: "गुप्त रहस्य कहाँ संग्रहीत है, इसे कौन एक्सेस कर सकता है, और किन ऐप्स को इसकी अनुमति दी गई है?"
+
+वर्कस्पेस कनेक्शन प्रदाता मेटाडेटा उत्तर देता है: "यह कौन सा प्रदाता है, यह क्या कर सकता है, इसे किन क्रेडेंशियल कुंजियों की आवश्यकता हो सकती है, और इसे कौन से टेम्पलेट पेश करने चाहिए?"
+
+```an-diagram title="Connection store vs. vault" summary="The vault owns the secret value. The connection owns provider metadata plus credentialRefs (pointers). At execution time the app resolves the ref through a granted connection and reads the value from the vault."
+{
+  "html": "<div class=\"diagram-vault\"><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill accent\">Connection store</span><div class=\"diagram-box\" data-rough>provider account + metadata<br><small class=\"diagram-muted\">status, scopes, config</small></div><div class=\"diagram-box\" data-rough>credentialRef<br><small class=\"diagram-muted\">{ key: SLACK_BOT_TOKEN, scope: org }</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">App action</span><small class=\"diagram-muted\">resolves at execution time through a granted ref</small><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel col\" data-rough><span class=\"diagram-pill ok\">Vault</span><div class=\"diagram-box\" data-rough>secret value<br><small class=\"diagram-muted\">never returned to the agent or UI</small></div></div></div>",
+  "css": ".diagram-vault{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-vault .col{display:flex;flex-direction:column;gap:8px;padding:14px;min-width:220px}.diagram-vault .diagram-card{display:flex;flex-direction:column;gap:6px;padding:12px 14px}.diagram-vault .diagram-arrow{font-size:22px;line-height:1}"
+}
+```
+
+दोनों का एक साथ उपयोग करें:
+
+1. डिस्पैच (या अन्य कार्यक्षेत्र सेटअप प्रवाह) अंतर्निहित वॉल्ट रहस्य या OAuth क्रेडेंशियल संदर्भ बनाता है।
+2. कार्यस्थान कनेक्शन स्टोर प्रदाता खाते, सुरक्षित मेटाडेटा, क्रेडेंशियल रेफरी और ऐप अनुदान को रिकॉर्ड करता है।
+3. प्रत्येक ऐप कैटलॉग से प्रदाता मेटाडेटा और साझा स्टोर से कनेक्शन/अनुदान सारांश पढ़ता है।
+4. ऐप UI तत्परता दिखाता है: कनेक्टेड, स्वीकृत लेकिन अस्वस्थ, अनुदान की आवश्यकता, अनुपलब्ध क्रेडेंशियल, या केवल मेटाडेटा।
+5. ऐप-विशिष्ट SQL केवल ऐप-विशिष्ट स्रोत आईडी, कर्सर, फ़िल्टर, सिंक विंडो, मीट्रिक परिभाषाएँ, समीक्षा नियम और उपयोगकर्ता विकल्प संग्रहीत करता है।
+6. ऐप actions दिए गए कनेक्शन रेफरी और वॉल्ट के माध्यम से निष्पादन समय पर क्रेडेंशियल्स को हल करता है, और कभी भी गुप्त मान नहीं लौटाता है।
+
+### प्रदाता रीडर रनटाइम
+
+प्रदाता-रीडर परत पहले एक अनुबंध है, यह कोई वादा नहीं है कि प्रत्येक प्रदाता के पास एक साझा लाइव रीडर है। रीडर परिभाषाएँ समर्थित संचालन, क्रेडेंशियल आवश्यकताओं और कार्यान्वयन स्थिति का वर्णन करती हैं: `metadata-only`, `template-owned`, या `shared`। रनटाइम किसी ऐप के लिए दिए गए वर्कस्पेस कनेक्शन और क्रेडेंशियल रेफरी को हल करता है, एक पंजीकृत हैंडलर को कॉल करता है, और गुप्त मूल्यों को उजागर किए बिना सामान्यीकृत आइटम लौटाता है।
+
+अधिकांश लाइव हैंडलर आज भी टेम्प्लेट के स्वामित्व में हैं, जिसका अर्थ है कि ब्रेन अभी भी Slack/GitHub अंतर्ग्रहण व्यवहार का मालिक है और एनालिटिक्स अभी भी एनालिटिक्स व्याख्या का मालिक है। किसी रीडर को `shared` पर तभी प्रमोट करें जब प्रदाता-विशिष्ट API कॉल, पेजिनेशन, अनुमतियाँ और परिणाम शब्दार्थ वास्तव में सभी टेम्प्लेट में पुन: प्रयोज्य हों।
+
+### ऐप तैयारी पैटर्न
+
+ऐसे ऐप्स जो साझा प्रदाता क्रेडेंशियल्स का उपभोग करते हैं, उन्हें केवल-पढ़ने के लिए तत्परता कार्रवाई और एक छोटा सेटअप सतह कवर प्रदर्शित करना चाहिए:
+
+- **प्रदाता सूची:** प्रदाता आईडी, लेबल, क्षमताएं, अनुशंसित टेम्पलेट उपयोग, और `@agent-native/core/connections` से आवश्यक क्रेडेंशियल कुंजी नाम।
+- **कार्यक्षेत्र सारांश:** कनेक्शन गणना, सक्रिय/अनुदत्त गणना, अनुदान स्थिति, क्रेडेंशियल रेफरी नाम, और `@agent-native/core/workspace-connections` से गैर-गुप्त खाता लेबल।
+- **प्रदाता की तैयारी:** `ready`, `needs_credentials`, `needs_attention`, `checking`, `disabled`, या `summarizeWorkspaceConnectionProviderReadiness()` के माध्यम से `not_configured`।
+- **स्रोत स्थिति:** ऐप-स्थानीय कॉन्फ़िगर किए गए स्रोत, कर्सर, सिंक स्थिति और अगली कार्रवाई।
+
+ब्रेन का स्रोत पृष्ठ संदर्भ कार्यान्वयन है। यह ब्रेन सोर्स रिकॉर्ड के अलावा पुन: प्रयोज्य कार्यक्षेत्र कनेक्शन प्रदाताओं को दिखाता है, लेबल अनुदान स्थिति को `connected`, `granted`, `needs_grant`, या `not_connected` के रूप में दिखाता है, और प्रदाता स्वास्थ्य को तैयार, गुम चाबियाँ, अनुदान की आवश्यकता, मरम्मत की आवश्यकता, या केवल मेटाडेटा के रूप में दिखाता है।
+
+### एक पुन: प्रयोज्य कनेक्टर का निर्माण
+
+जब एक नए प्रदाता को एकाधिक टेम्पलेट्स पर काम करना चाहिए:
+
+1. **प्रदाता मेटाडेटा:** `@agent-native/core/connections` में एक प्रदाता जोड़ें या पुन: उपयोग करें। यह स्थिर आईडी, डिस्प्ले लेबल, क्षमता सूची, अनुशंसित टेम्पलेट उपयोग और क्रेडेंशियल कुंजी नाम हैं।
+2. **कार्यस्थान कनेक्शन:** डिस्पैच या अन्य कार्यक्षेत्र सेटअप सतह कनेक्टेड खाते के सुरक्षित मेटाडेटा, स्थिति, स्कोप, `credentialRefs` और ऐप अनुदान को `@agent-native/core/workspace-connections` के माध्यम से संग्रहीत करता है।
+3. **ऐप-स्थानीय स्रोत:** ब्रेन, एनालिटिक्स, मेल, या कोई अन्य ऐप केवल ऐप-विशिष्ट विकल्पों को संग्रहीत करता है, जैसे Slack चैनल, GitHub रिपॉजिटरी, HubSpot ऑब्जेक्ट फ़िल्टर, सिंक कर्सर, या पोलिंग ताल।
+
+प्रत्येक ऐप में OAuth/टोकन स्टोरेज की नकल न करें। कनेक्शन रिकॉर्ड कहता है "यह Acme Slack है और इसका टोकन `SLACK_BOT_TOKEN` पर रहता है"; ऐप-स्थानीय स्रोत का कहना है, "मस्तिष्क उस Slack कनेक्शन से `#product` और `#dev-fusion` को ग्रहण कर सकता है।"
+
+### डिस्पैच कंट्रोल-प्लेन सेटअप
+
+डिस्पैच नियंत्रण-प्लेन actions को उजागर करता है जो समान साझा स्टोर फ़ंक्शन लिखता है जिसे एक ऐप सीधे कॉल कर सकता है:
+
+```ts
+// templates/dispatch/actions/upsert-workspace-connection.ts delegates to this.
+await upsertWorkspaceConnection({
+  id: "team-slack",
+  provider: "slack",
+  label: "Acme Slack",
+  accountId: "T012345",
+  accountLabel: "acme",
+  status: "connected",
+  scopes: ["channels:history", "groups:history"],
+  config: { teamDomain: "acme", preferredChannels: ["product", "dev-fusion"] },
+  credentialRefs: [
+    {
+      key: "SLACK_BOT_TOKEN",
+      scope: "org",
+      provider: "slack",
+      label: "Slack bot token",
+    },
+  ],
+});
+
+// Then grant the apps that should reuse the provider.
+await upsertWorkspaceConnectionGrant({
+  connectionId: "team-slack",
+  appId: "brain",
+});
+await upsertWorkspaceConnectionGrant({
+  connectionId: "team-slack",
+  appId: "analytics",
+});
+```
+
+`allowedApps: []` का उपयोग केवल तभी करें जब एक ही दायरे में प्रत्येक ऐप के लिए कनेक्शन उपलब्ध हो। उत्पादन सेटअप के लिए स्पष्ट अनुदान पंक्तियों को प्राथमिकता दें।
+
+### क्रेडेंशियल रिज़ॉल्यूशन
+
+ऐप निष्पादन कोड सक्रिय अनुरोध दायरे में वॉल्ट के माध्यम से दिए गए `credentialRefs` से क्रेडेंशियल मानों का समाधान करता है। ब्रेन का `source-credentials.ts` वर्तमान संदर्भ कार्यान्वयन है: यह प्रदाता के लिए कार्यक्षेत्र कनेक्शन सूचीबद्ध करता है, `appId: "brain"` के लिए `getWorkspaceConnectionAppAccess` की जांच करता है, कनेक्शन-स्तर और अनुदान-स्तर क्रेडेंशियल रेफरी को मर्ज करता है, और पहले मिलान वाले स्कोप्ड वॉल्ट रहस्य को पढ़ता है। अन्य ऐप्स को `process.env` तक पहुंचने के बजाय उस आकार का अनुसरण करना चाहिए।
+
+## डिज़ाइन नोट्स {#design-notes}
+
+<details>
+<summary>Reader-प्रचार नीति और "एक बार कनेक्ट करें, हर जगह उपयोग करें" का पथ </summary>
+
+### ऐप-स्थानीय सीमा
+
+साझा कनेक्शन और ऐप-स्थानीय स्रोतों के बीच की सीमा जानबूझकर है। आज जो पुन: प्रयोज्य है वह है प्रदाता की पहचान, क्रेडेंशियल-संदर्भ समाधान, प्रति-ऐप अनुदान, प्रदाता की तैयारी, सुरक्षित खाता मेटाडेटा और सामान्यीकृत प्रदाता-रीडर अनुबंध। जो अभी तक सामान्य नहीं है वह अधिकांश लाइव प्रदाता API रीडिंग, OAuth प्रवाह स्वामित्व, अंतर्ग्रहण कर्सर, स्रोत फ़िल्टर, सिंक ताल और डोमेन व्याख्या है। जब तक पाठक कार्यान्वयन को स्पष्ट रूप से साझा करने के लिए प्रचारित नहीं किया जाता है, तब तक वे ऐप में बने रहते हैं जो वर्कफ़्लो का स्वामी होता है।
+
+ऐप स्रोत कनेक्टर्स को उपयोगकर्ता/संगठन स्रोत क्रेडेंशियल्स के फ़ॉलबैक के रूप में परिनियोजन-स्तरीय पर्यावरण चर को नहीं पढ़ना चाहिए। Env संस्करण परिनियोजन के लिए वैश्विक हैं और कार्यक्षेत्र अनुदान व्यक्त नहीं करते हैं।
+
+एजेंटों को एक सरल नियम का पालन करना चाहिए: यदि कोई उपयोगकर्ता Slack, GitHub, HubSpot, Gmail, Google Drive, ग्रेनोला, या किसी अन्य साझा प्रदाता को कनेक्ट करने के लिए कहता है, तो पहले कार्यक्षेत्र कनेक्शन कैटलॉग का निरीक्षण करें। यदि प्रदाता `connected` है, तो इसका उपयोग करें। यदि यह `needs_grant` है, तो ऐप अनुदान मांगें या निष्पादित करें। यदि यह `needs_credentials` है, तो गुम हुई वॉल्ट कुंजी के लिए पूछें। केवल तभी नई कच्ची कुंजी मांगें जब कोई पुन: प्रयोज्य कनेक्शन मौजूद न हो।
+
+### "एक बार कनेक्ट करें, हर जगह उपयोग करें" का पथ
+
+प्रदाता कैटलॉग और अनुदान भंडार एक व्यापक कार्यक्षेत्र परत की नींव हैं:
+
+- साझा प्रदाता आईडी और क्षमता नाम टेम्पलेट्स को संरेखित रखते हैं।
+- वर्कस्पेस-स्तरीय इन्वेंट्री दिखा सकती है कि कौन से प्रदाता ब्रेन, मेल, एनालिटिक्स, डिस्पैच और भविष्य के ऐप्स में कॉन्फ़िगर किए गए हैं।
+- कनेक्शन पंक्तियाँ टेम्प्लेट-फेसिंग प्रदाता आईडी को बदले बिना खाता लेबल, स्थिति, अनुमत ऐप्स, क्रेडेंशियल रेफरी और स्वास्थ्य जांच रिकॉर्ड करती हैं।
+- अनुदान पंक्तियाँ कार्यस्थान स्वामी को एक बार कनेक्ट होने देती हैं, फिर कार्यस्थान द्वारा उन्हें अपनाने पर अलग-अलग ऐप्स को सक्षम करें।
+- एजेंट यह जानकर सभी ऐप्स पर काम कर सकते हैं कि कौन से प्रदाता पहले से जुड़े हुए हैं और किन ऐप्स के पास अनुदान है।
+- फ़ेडरेटेड खोज प्रत्येक ऐप की कनेक्टर सूची को हार्डकोड करने के बजाय `search`, `docs`, `messages`, `meetings`, `crm`, या `code` क्षमताओं वाले प्रदाताओं की मांग कर सकती है।
+- प्रदाता-विशिष्ट पाठक, OAuth ताज़ा प्रवाह, अंतर्ग्रहण चौकियाँ और ऐप-स्वामित्व वाले डेटा मॉडल बाद में साझा किए जा सकते हैं, लेकिन वे आज कार्यक्षेत्र कनेक्शन द्वारा निहित नहीं हैं।
+
+सीमा को सख्त रखें: प्रदाता मेटाडेटा दिखाना सुरक्षित है; क्रेडेंशियल मान तिजोरी में रहते हैं।
+
+</details>