@agent-native/core 0.76.5 → 0.76.6

package/docs/content/locales/hi-IN/faq.md

@@ -0,0 +1,142 @@
+---
+title: "FAQ"
+description: "एजेंट-नेटिव के बारे में सामान्य प्रश्न - यह क्या है, यह किसके लिए है, आप क्या बना सकते हैं और यह कैसे काम करता है।"
+---
+
+# FAQ
+
+एजेंट-नेटिव के बारे में सामान्य प्रश्न, "मैं बस देख रहा हूं" से लेकर "मैं अभी प्रमाणीकरण कर रहा हूं" तक व्यवस्थित।
+
+## बुनियादी बातें {#general}
+
+### एजेंट-नेटिव क्या है? {#what-is-agent-native}
+
+एजेंट-नेटिव ऐप्स बनाने के लिए एक ढांचा है जहां एआई एजेंट और उसके आसपास की उत्पाद सतह समान भागीदार हैं। वह सतह एक कस्टम कार्रवाई के साथ एक हेडलेस एजेंट के रूप में शुरू हो सकती है, समृद्ध चैट में विकसित हो सकती है, या पूर्ण UI बन सकती है। अपरिवर्तनीय यह है कि एजेंट और मनुष्य समान actions, डेटाबेस और स्थिति साझा करते हैं। संपूर्ण स्पष्टीकरण के लिए [What Is Agent-Native?](/docs/what-is-agent-native) देखें।
+
+### यह किसके लिए है? {#who-is-this-for}
+
+एजेंट-नेटिव उन लोगों के लिए है जो एक ही डेटा और actions से काम करने के लिए एक वास्तविक ऐप और एक AI एजेंट चाहते हैं। सामान्य पथ हैं:
+
+- **अगर आप मेल, कैलेंडर, फॉर्म, प्लान या बिना किसी सेटअप वाला कोई अन्य तैयार टेम्पलेट चाहते हैं तो होस्टेड ऐप का उपयोग करें** - [template gallery](/templates) से शुरू करें।
+- **चैट से शुरू करें** यदि आप चाहते हैं कि एक बुनियादी ऐप उपयोगकर्ता तुरंत बात कर सके, तो actions और स्क्रीन के साथ विस्तार करें - [Getting Started](/docs/getting-started) या [Chat](/docs/template-chat) से शुरू करें।
+- **यदि आप UI पर प्रतिबद्ध होने से पहले एक क्रिया और एक हेडलेस ऐप-एजेंट लूप चाहते हैं तो आदिम-पहले शुरू करें** - [Getting Started](/docs/getting-started) से शुरू करें।
+- \*\*यदि आप अपना स्वयं का SaaS उत्पाद ऑथ, डेटाबेस, UI और एजेंट actions के साथ पहले से ही वायर्ड चाहते हैं, तो टेम्पलेट को फोर्क और कस्टमाइज़ करें - [Templates](/docs/cloneable-saas) देखें।
+- **शुरुआत से निर्माण** यदि आप नए एजेंट-संचालित उत्पाद के लिए फ्रेमवर्क प्रिमिटिव चाहते हैं - [Getting Started](/docs/getting-started) से शुरू करें।
+- \*\*यदि आप एजेंट-नेटिव ऐप का उपयोग करने के लिए Claude, ChatGPT, Codex, कर्सर, या GitHub कोपायलट / VS कोड चाहते हैं तो किसी अन्य एजेंट या कोड टूल को कनेक्ट करें - [External Agents](/docs/external-agents) और [Skills Guide](/docs/skills-guide) देखें।
+
+### यह किसी मौजूदा ऐप में AI जोड़ने से किस प्रकार भिन्न है? {#how-is-this-different}
+
+ज्यादातर ऐप्स एआई को एक विचार के रूप में लागू करते हैं जो वास्तव में ऐप में काम नहीं कर सकता है। एजेंट-नेटिव ऐप में एजेंट एक प्रथम श्रेणी का नागरिक होता है जो actions, डेटाबेस और स्थिति को UI के समान साझा करता है, इसलिए यह बटन द्वारा किया जा सकने वाला कुछ भी कर सकता है - और ऐप के स्वयं के कोड को संशोधित कर सकता है। [What Is Agent-Native?](/docs/what-is-agent-native#the-ladder) देखें.
+
+```an-diagram title="Bolted-on AI vs. agent-native" summary="A bolted-on chat sidebar lives in its own world. An agent-native agent shares the same actions, database, and state as the UI."
+{
+  "html": "<div class=\"diagram-vs\"><div class=\"diagram-col\"><span class=\"diagram-pill warn\">Bolted-on AI</span><div class=\"diagram-node\">Chat sidebar</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>separate AI world<br><small class=\"diagram-muted\">can't touch the app</small></div><div class=\"diagram-box diagram-muted\">App UI &amp; data</div></div><div class=\"diagram-divider\" aria-hidden=\"true\"></div><div class=\"diagram-col\"><span class=\"diagram-pill ok\">Agent-native</span><div class=\"diagram-row2\"><div class=\"diagram-node\">UI</div><div class=\"diagram-node\">Agent</div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>shared actions, DB &amp; state</div></div></div>",
+  "css": ".diagram-vs{display:flex;align-items:stretch;gap:18px;flex-wrap:wrap}.diagram-vs .diagram-col{display:flex;flex-direction:column;gap:8px;align-items:center;flex:1;min-width:200px}.diagram-vs .diagram-row2{display:flex;gap:8px}.diagram-vs .diagram-arrow{font-size:20px;line-height:1}.diagram-vs .diagram-divider{width:1px;align-self:stretch;background:currentColor;opacity:.15}"
+}
+```
+
+### क्या यह खुला स्रोत है? {#is-this-open-source}
+
+हां. रूपरेखा और सभी टेम्पलेट खुले स्रोत हैं। आप सब कुछ स्थानीय रूप से चला सकते हैं, स्वयं-होस्ट कर सकते हैं, या प्रबंधित होस्टिंग, सहयोग और टीम सुविधाओं के लिए Builder.io के क्लाउड का उपयोग कर सकते हैं।
+
+### इसकी लागत कितनी है? {#how-much}
+
+फ्रेमवर्क स्वयं मुफ़्त है। ये दो लागतें आप व्यवहार में देखेंगे:
+
+- **एआई उपयोग।** आप अपनी खुद की API कुंजी (एंथ्रोपिक, OpenAI, आदि) लाएं और मॉडल प्रदाता को सीधे भुगतान करें। हमारी ओर से कोई मार्कअप नहीं है।
+- **होस्टिंग.** आपका होस्ट जो भी शुल्क लेता है। अधिकांश टेम्प्लेट छोटे वर्कलोड के लिए फ्री टियर (नेटलिफाई, वर्सेल, क्लाउडफ्लेयर) पर ठीक चलते हैं।
+
+यदि आप इनमें से कुछ भी प्रबंधित नहीं करना चाहते हैं, तो `agent-native.com` (Builder.io द्वारा संचालित) पर होस्ट किया गया संस्करण अनुमान और होस्टिंग को प्रति-सीट योजना में बंडल करता है।
+
+### क्या मैं इसे स्वयं होस्ट कर सकता हूं? {#can-i-self-host}
+
+हां. कोई भी होस्ट चुनें जो नोड चलाता हो - नेटलिफाई, वर्सेल, क्लाउडफ्लेयर, AWS, डेनो डिप्लॉय, आपका अपना सर्वर - और कोई भी SQL डेटाबेस (Postgres, SQLite, Turso, D1)। ढांचा पोर्टेबल होने के लिए बनाया गया है। [Deployment](/docs/deployment) देखें.
+
+### यह किन AI मॉडल का समर्थन करता है? {#what-models}
+
+एंथ्रोपिक Claude, OpenAI (GPT-5 परिवार), गूगल जेमिनी, और कोई भी प्रदाता जो OpenAI API आकार बोलता है (ओलामा के माध्यम से स्थानीय मॉडल सहित)। आप सेटिंग्स में मॉडल को कॉन्फ़िगर करते हैं; स्विचिंग एक कॉन्फ़िगरेशन परिवर्तन है, कोड पुनर्लेखन नहीं। फ़्रेमवर्क का सबसे भारी परीक्षण पथ Claude है, इसलिए यह डिफ़ॉल्ट अनुशंसा है।
+
+### क्या मुझे AI/ML जानने की आवश्यकता है? {#do-i-need-to-know-ai}
+
+नहीं. आप मॉडलों को प्रशिक्षित नहीं करते, फाइन-ट्यून नहीं करते, या एम्बेडिंग से नहीं निपटते। आप एक नियमित वेब ऐप बनाते हैं - और होस्ट किए गए संस्करण पर, आप मुश्किल से कुछ भी बनाते हैं। फ्रेमवर्क एजेंट एकीकरण को संभालता है: संदेशों को रूट करना, actions चलाना, सिंकिंग स्थिति।
+
+### क्या मैं किसी मौजूदा ऐप को एजेंट-नेटिव में स्थानांतरित कर सकता हूं? {#can-i-use-existing-code}
+
+आप कर सकते हैं, लेकिन एजेंट-नेटिव सबसे अच्छा तब काम करता है जब उसे ज़मीन से ऊपर बनाया जाता है। आर्किटेक्चर - साझा डेटाबेस, पोलिंग सिंक, actions, एप्लिकेशन स्थिति - को संपूर्ण रूप से एकीकृत करने की आवश्यकता है। एक टेम्पलेट से शुरू करना और उसे अनुकूलित करना अनुशंसित पथ है। इसे डेस्कटॉप-फर्स्ट से मोबाइल-फर्स्ट में बदलाव की तरह समझें: आप रेट्रोफिट कर सकते हैं, लेकिन देशी निर्माण करना बेहतर है।
+
+## टेम्प्लेट और आप क्या बना सकते हैं {#templates}
+
+### कौन से टेम्पलेट उपलब्ध हैं? {#what-templates-are-available}
+
+फ्रेमवर्क [Chat](/docs/template-chat), [Mail](/docs/template-mail), [Calendar](/docs/template-calendar), [Forms](/docs/template-forms), [Plan](/docs/template-plan) (विजुअल प्लान और पीआर रिकैप्स), [Analytics](/docs/template-analytics), [Dispatch](/docs/template-dispatch), और अधिक सहित उत्पादन-तैयार टेम्पलेट्स के साथ आता है। प्रत्येक UI, एजेंट actions, डेटाबेस स्कीमा और AI निर्देशों के साथ एक संपूर्ण ऐप है। संपूर्ण कैटलॉग के लिए [Templates](/docs/cloneable-saas) देखें।
+
+### क्या मैं टेम्प्लेट कस्टमाइज़ कर सकता हूं? {#can-i-customize-templates}
+
+यही पूरी बात है। एक टेम्प्लेट फोर्क करें और एजेंट से पूछकर उसे कस्टमाइज़ करें। "फ़ॉर्म में प्राथमिकता फ़ील्ड जोड़ें।" "हमारे Salesforce इंस्टेंस से कनेक्ट करें।" "हमारे ब्रांड से मेल खाने के लिए रंग योजना बदलें।" एजेंट कोड को संशोधित करता है, और आपका ऐप समय के साथ विकसित होता है।
+
+### क्या मैं कुछ ऐसा बना सकता हूं जो टेम्पलेट्स में शामिल न हो? {#build-from-scratch}
+
+हां. यदि आप एक बुनियादी चैट ऐप चाहते हैं, तो `npx @agent-native/core@latest create my-chat-app --template chat` चलाएँ; आपको टिकाऊ चैट थ्रेड, actions, ऑथ, SQL-समर्थित रनटाइम स्थिति और अपनी स्क्रीन जोड़ने के लिए जगह मिलती है। यदि आप बिना UI वाला सबसे छोटा एक्शन-फर्स्ट ऐप चाहते हैं, तो `npx @agent-native/core@latest create my-agent --headless` चलाएं। [Getting Started](/docs/getting-started), [Pure-Agent Apps](/docs/pure-agent-apps), और [Chat](/docs/template-chat) देखें।
+
+### क्या मैं बिना टेम्पलेट फोर्क किए इसे आज़मा सकता हूं? {#try-with-a-skill}
+
+हाँ - एक कोडिंग एजेंट में एक कौशल स्थापित करें जिसे आप पहले से ही एक कमांड के साथ उपयोग कर रहे हैं और किसी मचान की आवश्यकता नहीं है। वॉकथ्रू के लिए [Skills Guide](/docs/skills-guide#app-backed-skills) देखें।
+
+## एजेंट क्षमताएं {#agent-capabilities}
+
+### क्या एजेंट वास्तव में ऐप के अपने कोड को संशोधित कर सकता है? {#can-the-agent-modify-code}
+
+हां, और यह एक सुविधा है। एजेंट घटकों, मार्गों, शैलियों और actions को सुरक्षित रूप से संपादित कर सकता है। आप पूछते हैं "एक समूह विश्लेषण चार्ट जोड़ें" और एजेंट इसे बनाता है। आप "हमारे स्ट्राइप खाते से कनेक्ट करें" पूछते हैं और एजेंट एकीकरण लिखता है। सब कुछ सामान्य Git-ट्रैक कोड है, इसलिए ख़राब परिवर्तनों को पूर्ववत करना आसान है।
+
+### क्या उपयोगकर्ता ऐप के बाहर से एजेंट से बात कर सकते हैं? {#external-channels}
+
+हां. वही एजेंट आपके वेब UI में, Slack में, टेलीग्राम में, ईमेल पर और अन्य एजेंटों से ([A2A](/docs/a2a-protocol) के माध्यम से) चलता है। यह समान मेमोरी और समान actions वाला एक ही एजेंट है, बस विभिन्न चैनलों के माध्यम से पहुंचा है। [Messaging the agent](/docs/messaging) देखें.
+
+### क्या एजेंट एक दूसरे से बात कर सकते हैं? {#can-agents-talk-to-each-other}
+
+हां, [A2A (Agent-to-Agent) protocol](/docs/a2a-protocol) के माध्यम से। प्रत्येक एजेंट-नेटिव ऐप को स्वचालित रूप से एक A2A एंडपॉइंट मिलता है। मेल ऐप से, आप डेटा क्वेरी करने के लिए एनालिटिक्स एजेंट को टैग कर सकते हैं। एक एजेंट पता लगाता है कि अन्य एजेंट क्या उपलब्ध हैं, उन्हें प्रोटोकॉल पर कॉल करता है, और UI में परिणाम दिखाता है। किसी कॉन्फ़िगरेशन की आवश्यकता नहीं है - एजेंट कार्ड आपके टेम्पलेट के actions से स्वतः उत्पन्न होता है।
+
+### एजेंट ऐप में क्या देख सकता है? {#what-can-the-agent-see}
+
+एजेंट को हमेशा पता होता है कि उपयोगकर्ता वर्तमान में क्या देख रहा है। UI प्रत्येक मार्ग परिवर्तन पर डेटाबेस में नेविगेशन स्थिति लिखता है - कौन सा दृश्य खुला है, कौन सा आइटम चुना गया है। कार्रवाई करने से पहले एजेंट इसे पढ़ता है। यदि कोई ईमेल खुला है, तो एजेंट को पता होता है कि कौन सा ईमेल खुला है। यदि कोई स्लाइड चुनी जाती है, तो एजेंट को पता होता है कि कौन सी स्लाइड है। [Context Awareness](/docs/context-awareness) देखें.
+
+## विकास प्रश्न {#development}
+
+### कौन से AI कोडिंग टूल एजेंट-नेटिव के साथ काम करते हैं? {#which-ai-tools-work}
+
+कोई भी एआई कोडिंग टूल जो प्रोजेक्ट निर्देश पढ़ता है। फ्रेमवर्क AGENTS.md को सार्वभौमिक मानक के रूप में उपयोग करता है और विशिष्ट उपकरणों के लिए स्वचालित रूप से सिम्लिंक बनाता है:
+
+- **Claude कोड** - CLAUDE.md पढ़ता है (CLI सेटअप द्वारा AGENTS.md से सिम्लिंक किया गया)
+- **कर्सर** - सीधे AGENTS.md पढ़ता है, या यदि आपके प्रोजेक्ट में मौजूद है तो `.cursorrules` (कर्सर का विरासत स्थान) पढ़ता है
+- **विंडसर्फ** - पढ़ता है .windsurfrules (CLI सेटअप द्वारा AGENTS.md से सिम्लिंक किया गया)
+- **Codex, मिथुन, और अन्य** - एम्बेडेड एजेंट पैनल के माध्यम से काम करें
+- **Builder.io** - दृश्य संपादन और सहयोग के साथ क्लाउड-होस्टेड एजेंट
+
+### क्या मैं अपने स्वयं के डेटाबेस का उपयोग कर सकता हूं? {#can-i-use-my-own-database}
+
+हां. `DATABASE_URL` सेट करें और फ्रेमवर्क इसे स्वतः पहचान लेता है। समर्थित डेटाबेस में SQLite, Postgres (नियॉन, सुपाबेस, प्लेन), टुर्सो (libSQL), और क्लाउडफ्लेयर D1 शामिल हैं। सभी SQL Drizzle ORM के माध्यम से बोली-अज्ञेयवादी हैं - एक ही कोड हर जगह काम करता है।
+
+### मैं कहां तैनात कर सकता हूं? {#where-can-i-deploy}
+
+कहीं भी. सर्वर Nitro पर चलता है, जो किसी भी परिनियोजन लक्ष्य को संकलित करता है: Node.js, Cloudflare Workers/Pages, Netlify, Vercel, Deno Deploy, AWS Lambda, और bun। आप प्रबंधित परिनियोजन के लिए Builder.io की होस्टिंग का भी उपयोग कर सकते हैं। [Deployment guide](/docs/deployment) देखें.
+
+## वास्तुकला {#architecture}
+
+### WebSockets के बजाय SSE प्लस पोलिंग क्यों? {#why-polling-not-websockets}
+
+SSE समान-प्रक्रिया ब्राउज़र के लिए एक तत्काल पथ लिखता है, और एक हल्का संस्करण-काउंटर पोल फ़ॉलबैक रहता है क्योंकि यह हर परिनियोजन वातावरण में काम करता है - सर्वर रहित और किनारे सहित, जहां लगातार सॉकेट उपलब्ध नहीं हो सकते हैं। [Key Concepts — Live sync](/docs/key-concepts#polling-sync) देखें.
+
+```an-diagram title="SSE first, polling fallback" summary="Same-process writes stream instantly; a version-counter poll keeps serverless, edge, and cross-process writes convergent."
+{
+  "html": "<div class=\"diagram-transport\"><div class=\"diagram-box\" data-rough>DB write</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-node\">SSE<br><small class=\"diagram-muted\">/_agent-native/events &middot; instant</small></div><div class=\"diagram-node\">Poll<br><small class=\"diagram-muted\">/_agent-native/poll &middot; universal fallback</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Browser refetch</div></div>",
+  "css": ".diagram-transport{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-transport .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-transport .diagram-arrow{font-size:22px;line-height:1}"
+}
+```
+
+### UI सीधे LLM को कॉल क्यों नहीं कर सकता? {#why-no-inline-llm-calls}
+
+एआई गैर-नियतात्मक है, इसलिए आपको फीडबैक देने और पुनरावृत्त करने के लिए वार्तालाप प्रवाह की आवश्यकता है - एक-शॉट बटन की नहीं - और एजेंट के पास पहले से ही आपका कोडबेस, निर्देश, skills और इतिहास है जो इनलाइन कॉल में नहीं है। एजेंट के माध्यम से सब कुछ रूट करने से ऐप को Slack, टेलीग्राम या किसी अन्य एजेंट से संचालित किया जा सकता है। [Key Concepts — Agent chat bridge](/docs/key-concepts#agent-chat-bridge) देखें.
+
+### यह एक ढांचा क्यों है, लाइब्रेरी क्यों नहीं? {#why-framework-not-library}
+
+साझा डेटाबेस, लाइव सिंक, actions सिस्टम और एप्लिकेशन स्थिति केवल इसलिए काम करते हैं क्योंकि वे जमीन से एक साथ जुड़े हुए हैं - UI एजेंट परिवर्तनों पर तुरंत प्रतिक्रिया करता है, एजेंट संचार करते हैं, और एजेंट समझता है कि उपयोगकर्ता क्या देख रहा है। एक पुस्तकालय आपको टुकड़े देता है; यह एक वास्तुकला है. [Key Concepts](/docs/key-concepts) देखें.

package/docs/content/locales/hi-IN/file-uploads.md

@@ -0,0 +1,122 @@
+---
+title: "फ़ाइल अपलोड"
+description: "फ़ाइल अपलोड स्टोरेज कॉन्फ़िगर करें - डेव, Builder.io या उत्पादन के लिए कस्टम प्रदाताओं के लिए SQL फ़ॉलबैक।"
+---
+
+# फ़ाइल अपलोड
+
+फ्रेमवर्क एक फ़ाइल अपलोड एब्स्ट्रैक्शन प्रदान करता है जो एक कॉन्फ़िगर करने योग्य प्रदाता के माध्यम से अपलोड को रूट करता है। टेम्प्लेट `uploadFile()` को कॉल करते हैं और एक URL वापस प्राप्त करते हैं - स्टोरेज बैकएंड एप्लिकेशन कोड को बदले बिना स्वैप किया जा सकता है।
+
+## यह कैसे काम करता है {#how-it-works}
+
+अपलोड अनुरोध `POST /_agent-native/file-upload` पर जाते हैं, जो सक्रिय प्रदाता को भेजता है। आप जाँच सकते हैं कि कौन सा प्रदाता `GET /_agent-native/file-upload/status` पर कॉन्फ़िगर किया गया है।
+
+प्रदाता समाधान आदेश है:
+
+1. **उपयोगकर्ता-पंजीकृत प्रदाता** — `registerFileUploadProvider()` के माध्यम से पंजीकृत कस्टम प्रदाता
+2. **Builder.io प्रदाता** - अंतर्निहित, Builder.io कनेक्ट होने पर स्वचालित रूप से सक्रिय हो जाता है
+3. **SQL फ़ॉलबैक** — डेटाबेस में फ़ाइलों को बेस64 के रूप में संग्रहीत करता है (डेव के लिए ठीक है, उत्पादन के लिए नहीं)
+
+```an-diagram title="Provider resolution order" summary="uploadFile() picks the first configured provider in order. The SQL fallback always exists so uploads work with zero setup."
+{
+  "html": "<div class=\"diagram-upload\"><div class=\"diagram-box\" data-rough>uploadFile()<br><small class=\"diagram-muted\">POST /_agent-native/file-upload</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-step\"><span class=\"diagram-pill accent\">1</span><div class=\"diagram-node\">User-registered<br><small class=\"diagram-muted\">registerFileUploadProvider() — S3, R2, GCS…</small></div></div><div class=\"diagram-step\"><span class=\"diagram-pill\">2</span><div class=\"diagram-node\">Builder.io<br><small class=\"diagram-muted\">auto when connected — CDN-served</small></div></div><div class=\"diagram-step\"><span class=\"diagram-pill warn\">3</span><div class=\"diagram-node\">SQL fallback<br><small class=\"diagram-muted\">base64 in DB — dev only</small></div></div></div></div>",
+  "css": ".diagram-upload{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-upload .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-upload .diagram-step{display:flex;align-items:center;gap:8px}.diagram-upload .diagram-arrow{font-size:22px;line-height:1}"
+}
+```
+
+```an-api title="The upload endpoint" method="POST" path="/_agent-native/file-upload"
+{
+  "method": "POST",
+  "path": "/_agent-native/file-upload",
+  "summary": "Upload a file through the active provider and get back a public URL.",
+  "description": "Dispatches to the first configured provider in resolution order. Check the active provider at `GET /_agent-native/file-upload/status`.",
+  "request": { "contentType": "multipart/form-data" },
+  "responses": [
+    { "status": "200", "description": "{ url, id?, provider } — the public URL and which provider handled it." }
+  ]
+}
+```
+
+## डिफ़ॉल्ट: SQL फ़ॉलबैक {#sql-fallback}
+
+जब कोई प्रदाता कॉन्फ़िगर नहीं किया जाता है, तो फ़ाइलें संसाधन प्रणाली के माध्यम से SQL डेटाबेस में बेस 64 डेटा के रूप में संग्रहीत की जाती हैं। यह स्थानीय विकास के लिए लीक से हटकर काम करता है लेकिन उत्पादन के लिए अनुशंसित नहीं है - बड़ी फ़ाइलें डेटाबेस को फुला देती हैं और कोई CDN नहीं होता है।
+
+फ़ॉलबैक का उपयोग करने पर एक बार की चेतावनी लॉग की जाती है।
+
+## Builder.io होस्टिंग {#builder-hosting}
+
+जब आपका ऐप Builder.io से कनेक्ट होता है, तो फ़ाइल अपलोड स्वचालित रूप से Builder की एसेट होस्टिंग पर रूट हो जाते हैं। फ़ाइलों को CDN से बिना किसी कॉन्फ़िगरेशन की आवश्यकता के परोसा जाता है। यह अनुशंसित उत्पादन सेटअप है.
+
+## कस्टम प्रदाता {#custom-providers}
+
+किसी भी स्टोरेज बैकएंड (S3, Cloudflare R2, GCS, आदि) का उपयोग करने के लिए सर्वर प्लगइन में एक कस्टम प्रदाता पंजीकृत करें:
+
+```ts
+// server/plugins/file-upload.ts
+import { registerFileUploadProvider } from "@agent-native/core/file-upload";
+
+export default defineNitroPlugin(() => {
+  registerFileUploadProvider({
+    id: "s3",
+    name: "Amazon S3",
+    isConfigured: () => !!process.env.S3_BUCKET,
+    upload: async ({ data, filename, mimeType }) => {
+      const key = `uploads/${Date.now()}-${filename}`;
+      await s3Client.putObject({
+        Bucket: process.env.S3_BUCKET!,
+        Key: key,
+        Body: data,
+        ContentType: mimeType,
+      });
+      return {
+        url: `https://${process.env.S3_BUCKET}.s3.amazonaws.com/${key}`,
+        provider: "s3",
+      };
+    },
+  });
+});
+```
+
+## API अपलोड करें {#upload-api}
+
+`FileUploadProvider` इंटरफ़ेस:
+
+```ts
+interface FileUploadProvider {
+  id: string; // Unique id, e.g. "s3"
+  name: string; // Human-readable name
+  isConfigured: () => boolean; // True when ready (env vars set, etc.)
+  upload: (input: FileUploadInput) => Promise<FileUploadResult>;
+}
+
+interface FileUploadInput {
+  data: Uint8Array | Buffer; // File contents
+  filename?: string; // Original filename
+  mimeType?: string; // MIME type, e.g. "image/png"
+  ownerEmail?: string; // For per-user scoping in fallback
+}
+
+interface FileUploadResult {
+  url: string; // Public URL for the uploaded file
+  id?: string; // Provider-specific id
+  provider: string; // Which provider handled it
+}
+```
+
+actions या सर्वर कोड में `@agent-native/core/file-upload` से `uploadFile()` का उपयोग करें:
+
+```ts
+import { uploadFile } from "@agent-native/core/file-upload";
+
+const result = await uploadFile({
+  data: fileBuffer,
+  filename: "photo.jpg",
+  mimeType: "image/jpeg",
+});
+
+if (result) {
+  // Provider handled it — result.url is the public URL
+} else {
+  // No provider configured — handle SQL fallback yourself, or skip
+}
+```

package/docs/content/locales/hi-IN/frames.md

@@ -0,0 +1,153 @@
+---
+title: "फ़्रेम"
+description: "स्थानीय डेव फ़्रेम, एम्बेडेड एजेंट पैनल और क्लाउड फ़्रेम - जिस तरह से AI एजेंट आपके ऐप के साथ चलता है।"
+---
+
+# फ़्रेम्स
+
+प्रत्येक एजेंट-नेटिव ऐप UI ऐप के बगल में एक AI एजेंट के साथ चलता है। एक **फ़्रेम** है
+वह रैपर जो दोनों को होस्ट करता है: यह आपका ऐप दिखाता है और एजेंट को जगह देता है
+चैट करें, चलाएं, और (डेव में) कोड संपादित करें। तीन फ़्रेम हैं, जो एक रनटाइम साझा करते हैं:
+
+- **एम्बेडेड एजेंट पैनल** - `@agent-native/core` से प्रत्येक ऐप के अंदर भेजा जाता है।
+  यह वह साइडबार है जिसे आपका ऐप विकास और उत्पादन दोनों में स्वयं प्रस्तुत करता है।
+- **स्थानीय डेव फ्रेम** - एक पतला आवरण जो आपके चल रहे ऐप को एक आईफ्रेम में लोड करता है
+  और उसके बगल में एक ही एजेंट पैनल और एक एकीकृत CLI टर्मिनल जोड़ता है। प्रयुक्त
+  इस रेपो में टेम्पलेट्स के स्थानीय विकास के लिए।
+- **Builder.io क्लाउड फ्रेम** - सहयोग के साथ एक प्रबंधित, होस्ट किया गया फ्रेम,
+  दृश्य संपादन, और समानांतर एजेंट चलता है।
+
+आपका ऐप कोड समान है, भले ही इसे कौन सा फ़्रेम होस्ट करता हो। एजेंट बात करता है
+प्रत्येक मामले में समान actions और एप्लिकेशन स्थिति के माध्यम से आपके ऐप पर।
+
+```an-diagram title="Three frames, one runtime" summary="Your app and the agent panel are the same in every frame; only the wrapper around them changes."
+{
+  "html": "<div class=\"diagram-frames\"><div class=\"diagram-card\" data-rough><span class=\"diagram-pill accent\">Embedded panel</span><small class=\"diagram-muted\">ships in every app · dev + prod</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill\">Local dev frame</span><small class=\"diagram-muted\">app in an iframe + panel + CLI terminal</small></div><div class=\"diagram-card\" data-rough><span class=\"diagram-pill\">Builder.io cloud frame</span><small class=\"diagram-muted\">hosted: collaboration · visual edit · parallel runs</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box\" data-rough>Same runtime<br><small class=\"diagram-muted\">your app · actions · application state</small></div></div>",
+  "css": ".diagram-frames{display:flex;flex-direction:column;gap:10px;align-items:stretch}.diagram-frames .diagram-card{display:flex;flex-direction:column;gap:4px;padding:12px 16px}.diagram-frames .diagram-arrow{font-size:22px;line-height:1;align-self:center}"
+}
+```
+
+## एंबेडेड एजेंट पैनल {#embedded-agent}
+
+एम्बेडेड पैनल वह एजेंट साइडबार है जिसे आपका ऐप रेंडर करता है। यह
+`@agent-native/core` - इंस्टॉल करने के लिए कोई अलग पैकेज नहीं है - और वही है
+विकास और उत्पादन में घटक।
+
+- `@agent-native/core/client` से `AgentPanel` के रूप में निर्यात किया गया, एक
+  केवल-उत्पादन संस्करण `ProductionAgentPanel`।
+- पूर्ण चैट / CLI / वर्कस्पेस सतह प्रदान करता है, ताकि एजेंट इनपुट चालू रहे
+  साझा कंपोज़र स्टैक फ़्रेमवर्क में हर जगह उपयोग किया जाता है।
+- हर मोड़ पर `application_state.navigation` पढ़ता है, इसलिए यह पहले से ही जानता है कि कौन सा
+  देखें कि आप इसमें हैं और क्या चुना गया है - आपको "यह" दोबारा समझाने की ज़रूरत नहीं है।
+
+### ऐप बनाम कोड टूल मोड {#tool-modes}
+
+पैनल दो टूल मोड में से एक में चलता है:
+
+- **ऐप मोड** - एजेंट के पास केवल आपके ऐप के अपने टूल होते हैं: actions आप
+  `defineAction`, प्लस नेविगेशन और संदर्भ के साथ परिभाषित। कोई फ़ाइल सिस्टम या
+  शेल एक्सेस। अंतिम उपयोगकर्ताओं को यही मिलता है।
+- **कोड मोड** - साझा कोडिंग टूल जोड़ता है (`bash`, `read`, `edit`, `write`)
+  और ऐप टूल के शीर्ष पर डेटाबेस एक्सेस, ताकि एजेंट ऐप को बदल सके
+  स्वयं का स्रोत। कोड अनुरोधों को गेट किया जाता है: जब किसी संदेश को कोड की आवश्यकता होती है
+  (`type: "code"`) और कोई कोड-सक्षम फ़्रेम कनेक्ट नहीं है, पैनल एक दिखाता है
+  संवाद बताता है कि कोड परिवर्तन के लिए Agent Native डेस्कटॉप या Builder की आवश्यकता है;
+  जब कोई फ़्रेम कनेक्ट होता है, तो अनुरोध उस पर और एक कोड-एजेंट पर भेजा जाता है
+  संकेतक काम करते समय दिखाता है (`useSendToAgentChat`)। विहित के लिए
+  कोडिंग-टूल सूची और साझा UI अनुबंध, देखें
+  [Agent-Native Code UI](/docs/code-agents-ui).
+
+```an-diagram title="Code-request gating" summary="A code-typed message needs a code-capable frame. With one connected, the request routes there; without one, the panel explains code changes need Desktop or Builder."
+{
+  "html": "<div class=\"diagram-gate\"><div class=\"diagram-node\" data-rough>message<br><small class=\"diagram-muted\">type: \\\"code\\\"</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough>code-capable frame connected?</div><div class=\"diagram-col\"><div class=\"diagram-pill ok\">yes &rarr; route to frame, show code-agent indicator</div><div class=\"diagram-pill warn\">no &rarr; dialog: needs Desktop or Builder</div></div></div>",
+  "css": ".diagram-gate{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-gate .diagram-col{display:flex;flex-direction:column;gap:8px}.diagram-gate .diagram-arrow{font-size:22px;line-height:1}.diagram-gate .center{text-align:center}"
+}
+```
+
+"कोड मोड" एजेंट-क्षमता टॉगल है - पर्यावरण विकास मोड से अलग
+(`NODE_ENV` / Vite). क्लाइंट हुक `useCodeMode()` है। (देखें
+बैक-कम्पैट उपनामों के लिए [Compatibility notes](#compatibility)।)
+
+स्थानीय डेव फ्रेम में, सेटिंग्स इन मोड के बीच टॉगल करती है। स्विचिंग
+ऑफ कोड मोड फ़्रेम के स्वयं के साइडबार को छुपाता है और ऐप के इन-ऐप एजेंट को दिखाता है
+इसके बजाय आईफ्रेम के अंदर साइडबार, ताकि आप सटीक रूप से पूर्वावलोकन कर सकें कि अंतिम उपयोगकर्ता क्या देखते हैं।
+
+## एकीकृत टर्मिनल और CLI स्विचिंग {#cli-terminal}
+
+विकास में पैनल में एक एम्बेडेड टर्मिनल (`AgentTerminal`, भी
+`@agent-native/core/client` से) PTY सर्वर द्वारा समर्थित। आप असली
+एप्लिकेशन के ठीक बगल में CLI को कोड करना और उनके बीच स्विच करना; टर्मिनल पुनरारंभ होता है
+चयनित CLI के साथ।
+
+समर्थित CLI कोर CLI रजिस्ट्री से आते हैं
+(`packages/core/src/terminal/cli-registry.ts`). केवल इन आदेशों की अनुमति है
+स्पॉन करने के लिए - PTY सर्वर रजिस्ट्री के विरुद्ध अनुरोधित कमांड को मान्य करता है
+इंजेक्शन को रोकने के लिए अनुमति-सूची:
+
+| CLI        | कमांड      | पैकेज स्थापित करें          |
+| ---------- | ---------- | --------------------------- |
+| Claude कोड | `claude`   | `@anthropic-ai/claude-code` |
+| Builder.io | `builder`  | (अंतर्निहित)                |
+| Codex      | `codex`    | `@openai/codex`             |
+| मिथुन CLI  | `gemini`   | `@google/gemini-cli`        |
+| ओपनकोड     | `opencode` | `opencode-ai`               |
+
+यदि चयनित CLI `PATH` पर नहीं मिलता है, तो टर्मिनल इसे चलाने के लिए वापस आ जाता है
+`npx --yes <install-package>@latest` के माध्यम से (जहां एक इंस्टॉल पैकेज मौजूद है)। द
+डिफ़ॉल्ट कमांड `claude` है। किसी भी
+समय.
+
+## Builder.io क्लाउड फ़्रेम {#cloud-frame}
+
+[Builder.io](https://www.builder.io) एक प्रबंधित फ़्रेम प्रदान करता है जो
+क्लाउड में एक ही ऐप और एक ही एजेंट पैनल:
+
+- वास्तविक समय सहयोग - कई उपयोगकर्ता एक साथ देख सकते हैं और बातचीत कर सकते हैं।
+- दृश्य संपादन, भूमिकाएँ, और अनुमतियाँ।
+- तेज पुनरावृत्ति के लिए समानांतर एजेंट निष्पादन।
+- टीम के उपयोग के लिए अच्छा है, जहां हर कोई एक होस्ट किया गया वातावरण साझा करता है।
+
+एम्बेडेड पैनल रूट से Builder फ्रेम तक कोड अनुरोध उसी तरह
+वे स्थानीय डेव फ्रेम पर रूट करते हैं, इसलिए उपरोक्त डेव-बनाम-प्रोड व्यवहार है
+दोनों में संगत।
+
+## रनटाइम APIs {#runtime-apis}
+
+ये `@agent-native/core` के साथ आते हैं और आपका ऐप इनसे बात करने के लिए उपयोग करता है
+एजेंट, चाहे कोई भी फ़्रेम इसे होस्ट कर रहा हो:
+
+1. **एक संदेश भेजें** — `sendToAgentChat()` एजेंट को एक संदेश भेजता है। द
+   `useSendToAgentChat()` हुक इसे वर्णित कोड-अनुरोध गेटिंग के साथ लपेटता है
+   ऊपर और रेंडर करने के लिए एक `codeRequiredDialog` तत्व लौटाता है। देखें
+   पूर्ण उपयोग और विकल्पों के लिए [Drop-in Agent](/docs/drop-in-agent)।
+2. **जनरेशन स्थिति** - एजेंट होने पर `useAgentChatGenerating()` ट्रैक करता है
+   चल रहा है, इसलिए UI सीधे एजेंट से मतदान किए बिना प्रगति दिखा सकता है।
+3. **पोलिंग सिंक** - डेटाबेस-समर्थित सिंक एजेंट होने पर UI कैश को ताज़ा रखता है
+   डेटा या एप्लिकेशन स्थिति बदलता है।
+4. **एक्शन सिस्टम** — `pnpm action <name>` उसी कॉलेबल पर भेजता है
+   actions एजेंट उपकरण के रूप में आह्वान करता है, इसलिए एजेंट जो कुछ भी कर सकता है, आप कर सकते हैं
+   स्क्रिप्ट.
+
+## इसे चला रहा है {#running}
+
+एम्बेडेड एजेंट पैनल हर ऐप का हिस्सा है - एक टेम्पलेट तैयार करें और यह
+पहले से ही वहां:
+
+```bash
+npx @agent-native/core@latest create my-app --template mail --standalone
+cd my-app
+pnpm dev
+```
+
+स्थानीय डेव फ्रेम (फ्रेमवर्क रेपो में निजी `@agent-native/frame` पैकेज) एक आंतरिक टूलींग पैकेज है जो npm पर प्रकाशित नहीं होता है। यह सक्रिय ऐप के डेव सर्वर को एक आईफ्रेम में लोड करता है और उसके बगल में एम्बेडेड पैनल को माउंट करता है, `app` क्वेरी पैरामीटर के माध्यम से ऐप का चयन करता है। एकीकृत CLI टर्मिनल के लिए Agent Native डेस्कटॉप की आवश्यकता होती है, जो स्थानीय कोड और PTY को टर्मिनल की जरूरतों तक पहुंच प्रदान करता है; इसके बिना, पैनल चैट सतह दिखाता है और आपको CLI का उपयोग करने के लिए डेस्कटॉप खोलने का संकेत देता है।
+
+## संगतता नोट {#compatibility}
+
+"कोड मोड" अवधारणा को पहले "डेव मोड" नाम दिया गया था, इसलिए कुछ बैक-कॉम्पैट
+नाम बने रहते हैं. आप इन्हें तब तक अनदेखा कर सकते हैं जब तक कि आप पुराने एकीकरण को बनाए नहीं रख रहे
+कोड:
+
+- अंतर्निहित `AGENT_MODE` env var, `/_agent-native/agent-chat/mode`
+  एंडपॉइंट (जिसकी पेलोड कुंजी अभी भी `devMode` है), और `agent-chat.mode`
+  सेटिंग्स कुंजी अपरिवर्तित हैं।
+- `useDevMode()`, `useCodeMode()` के लिए एक अप्रचलित उपनाम के रूप में बना हुआ है।