@agent-native/core 0.76.5 → 0.76.6

package/corpus/core/docs/content/locales/hi-IN/agent-mentions.md

@@ -0,0 +1,164 @@
+---
+title: "एजेंट उल्लेख"
+description: "कस्टम एजेंटों, कनेक्टेड एजेंटों और चैट में फ़ाइलों को @-उल्लेख के साथ टैग करें।"
+---
+
+# एजेंट उल्लेख
+
+कस्टम एजेंटों, कनेक्टेड एजेंटों, फ़ाइलों और संसाधनों का उल्लेख करने के लिए चैट कंपोज़र में `@` टाइप करें।
+
+## अवलोकन {#overview}
+
+`@`-उल्लेख प्रणाली चैट कंपोजर को व्यापक एजेंट पारिस्थितिकी तंत्र से जोड़ती है। जब आप `@` टाइप करते हैं, तो एक पॉपओवर उपलब्ध कस्टम एजेंटों, कनेक्टेड एजेंटों, कोडबेस फ़ाइलों और संसाधनों को सूचीबद्ध करता हुआ दिखाई देता है।
+
+इस तरह आप एक ही चैट से मल्टी-एजेंट वर्कफ़्लो को व्यवस्थित करते हैं। अपने स्थानीय `@design` एजेंट से किसी लेआउट की समीक्षा करने के लिए कहें, `@analytics` से किसी अन्य ऐप से नवीनतम नंबर खींचने के लिए कहें, और मुख्य एजेंट दोनों को एक वार्तालाप में शामिल कर सकता है।
+
+## एजेंटों का उल्लेख {#mentioning-agents}
+
+चैट कंपोज़र में किसी एजेंट का उल्लेख करने के लिए:
+
+1. उल्लेख पॉपओवर खोलने के लिए `@` टाइप करें
+2. उपलब्ध एजेंटों की सूची ब्राउज़ करें या खोजें
+3. एक एजेंट का चयन करें - यह आपके संदेश में एक टैग के रूप में दिखाई देता है
+4. संदेश भेजें - सर्वर उल्लेख का समाधान करता है और बातचीत के संदर्भ में उस एजेंट की प्रतिक्रिया को शामिल करता है
+
+दो एजेंट पथ हैं:
+
+- **कस्टम एजेंट** - `agents/*.md` में स्थानीय कार्यस्थान एजेंट प्रोफाइल। ये एजेंट प्रोफ़ाइल के निर्देशों और वैकल्पिक मॉडल ओवरराइड का उपयोग करके वर्तमान ऐप/रनटाइम के अंदर चलते हैं।
+- **कनेक्टेड एजेंट** - दूरस्थ A2A सहकर्मी। इन्हें [A2A protocol](/docs/a2a-protocol) के नाम से जाना जाता है।
+
+दोनों ही मामलों में, आपका मुख्य एजेंट प्रतिक्रिया देखता है और उसका संदर्भ दे सकता है या उस पर निर्माण कर सकता है।
+
+```an-diagram title="Where an @-mention routes" summary="The server splits each mention by type: custom agents run locally, connected agents go over A2A — both responses fold back into the main agent's context."
+{
+  "html": "<div class=\"diagram-mention\"><div class=\"diagram-node\">@-mention<br><small class=\"diagram-muted\">in the composer</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">Server resolves</span><small class=\"diagram-muted\">extract refs by type</small></div><div class=\"diagram-col\"><div class=\"row\"><span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box\">Custom agent<br><small class=\"diagram-muted\">agents/*.md &middot; runs local</small></div></div><div class=\"row\"><span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</span><div class=\"diagram-box\">Connected agent<br><small class=\"diagram-muted\">A2A peer &middot; remote call</small></div></div></div><div class=\"diagram-arrow diagram-accent\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box diagram-accent\">&lt;agent-response&gt;<br><small class=\"diagram-muted\">injected into main agent</small></div></div>",
+  "css": ".diagram-mention{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-mention .center{display:flex;flex-direction:column;align-items:center;gap:4px;padding:14px}.diagram-mention .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-mention .row{display:flex;align-items:center;gap:8px}.diagram-mention .diagram-arrow{font-size:22px;line-height:1}"
+}
+```
+
+## यह कैसे काम करता है {#how-it-works}
+
+जब `@`-उल्लेख वाला एक संदेश भेजा जाता है, तो सर्वर पर निम्नलिखित होता है:
+
+1. सर्वर संदेश से उल्लेखित संदर्भ निकालता है
+2. प्रत्येक उल्लिखित एजेंट के लिए:
+   - कस्टम एजेंट अपने प्रोफ़ाइल निर्देशों के साथ स्थानीय रूप से चलते हैं
+   - जुड़े एजेंटों को A2A के माध्यम से कॉल किया जाता है
+3. एजेंट की प्रतिक्रिया को `<agent-response>` XML ब्लॉक में लपेटा गया है और बातचीत के संदर्भ में इंजेक्ट किया गया है
+4. मुख्य एजेंट उपयोगकर्ता के पाठ और उल्लिखित एजेंट की प्रतिक्रिया दोनों को देखकर समृद्ध संदेश को संसाधित करता है
+
+मुख्य एजेंट इसके संदर्भ में क्या देखता है:
+
+```text
+User: Draft an email with the latest signup numbers. @analytics
+
+<agent-response agent="analytics">
+Last week's signups: 1,247 total
+  - Organic: 623
+  - Paid: 412
+  - Referral: 212
+</agent-response>
+```
+
+मुख्य एजेंट इस डेटा का उपयोग अपनी प्रतिक्रिया में स्वाभाविक रूप से कर सकता है - उदाहरण के लिए, संख्याओं को ईमेल ड्राफ्ट में शामिल करना।
+
+```an-callout
+{
+  "tone": "info",
+  "body": "Mentioned-agent output arrives as an `<agent-response agent=\"…\">` block in the **main agent's** context — not as separate chat bubbles. The main agent decides how to weave it into the reply."
+}
+```
+
+## एजेंट जोड़ना {#adding-agents}
+
+एजेंट कई तंत्रों के माध्यम से उल्लेख के लिए उपलब्ध होते हैं:
+
+- **कस्टम वर्कस्पेस एजेंट** - वर्कस्पेस टैब में `agents/*.md` के रूप में एजेंट प्रोफाइल बनाएं
+- **ऑटो-डिस्कवरी** - फ्रेमवर्क स्वचालित रूप से ज्ञात पोर्ट या कॉन्फ़िगर किए गए URLs पर चलने वाले कनेक्टेड एजेंटों का पता लगाता है
+- **रिमोट मैनिफ़ेस्ट** — कनेक्टेड-एजेंट मैनिफ़ेस्ट को `remote-agents/*.json` के रूप में जोड़ें
+
+### कस्टम कार्यस्थान एजेंट
+
+कस्टम एजेंट कार्यस्थल में संग्रहीत Markdown फ़ाइलें हैं:
+
+```markdown
+---
+name: Design
+description: Reviews layouts, product UX, and visual direction.
+model: inherit
+---
+
+You are a focused design agent.
+```
+
+पूर्ण प्रारूप के लिए [Workspace — Custom Agents](/docs/workspace#custom-agents) देखें (`tools`, `delegate-default` और मॉडल ओवरराइड सहित)।
+
+आप इन्हें निम्न का उपयोग करके वर्कस्पेस टैब से बना सकते हैं:
+
+- `Create Agent` -> `Describe It`
+- `Create Agent` -> `Fill Form`
+
+### कनेक्टेड-एजेंट मैनिफ़ेस्ट
+
+दूरस्थ A2A एजेंट अभी भी JSON मैनिफ़ेस्ट का उपयोग करते हैं:
+
+```json
+// remote-agents/analytics.json
+{
+  "name": "Analytics Agent",
+  "url": "https://analytics.example.com",
+  "apiKey": "env:ANALYTICS_A2A_KEY",
+  "description": "Runs analytics queries and returns data",
+  "skills": ["run-query", "generate-chart"]
+}
+```
+
+---
+
+## डेवलपर्स के लिए: विस्तृत उल्लेख {#extending-mentions}
+
+टेम्पलेट्स एजेंटों और फ़ाइलों से परे डोमेन-विशिष्ट उल्लेख योग्य आइटम जोड़ने के लिए कस्टम उल्लेख प्रदाताओं को पंजीकृत कर सकते हैं। एक उल्लेख प्रदाता `MentionProvider` इंटरफ़ेस लागू करता है:
+
+```an-annotated-code title="A custom MentionProvider"
+{
+  "filename": "server/mentions/contacts.ts",
+  "language": "ts",
+  "code": "import type { MentionProvider } from \"@agent-native/core/server\";\n\nconst contactsProvider: MentionProvider = {\n  id: \"contacts\",\n  label: \"Contacts\",\n\n  // Search for mentionable items\n  async search(query: string) {\n    const contacts = await db.query.contacts.findMany({\n      where: like(contacts.name, `%${query}%`),\n      limit: 10,\n    });\n    return contacts.map((c) => ({\n      id: c.id,\n      label: c.name,\n      description: c.email,\n      type: \"contact\",\n    }));\n  },\n\n  // Resolve a mention into context for the agent\n  async resolve(id: string) {\n    const contact = await db.query.contacts.findFirst({\n      where: eq(contacts.id, id),\n    });\n    return {\n      type: \"context\",\n      text: `Contact: ${contact.name} (${contact.email})`,\n    };\n  },\n};",
+  "annotations": [
+    { "lines": "4-5", "label": "Identity", "note": "`id` namespaces the provider; `label` is the section heading shown in the `@` popover." },
+    { "lines": "8-9", "label": "search", "note": "Runs as the user types after `@`. Return up to a handful of matches as `{ id, label, description, type }`." },
+    { "lines": "23-24", "label": "resolve", "note": "Called when the message is sent. Turns a picked id into `{ type: \"context\", text }` that is injected into the agent's context." }
+  ]
+}
+```
+
+एजेंट-चैट प्लगइन कॉन्फ़िगरेशन में प्रदाताओं को पंजीकृत करें:
+
+```ts
+// server/plugins/agent-chat.ts
+import { createAgentChatPlugin } from "@agent-native/core/server";
+
+export default createAgentChatPlugin({
+  actions: scriptRegistry,
+  systemPrompt: "You are a helpful assistant...",
+  mentionProviders: { contacts: contactsProvider },
+});
+```
+
+कस्टम उल्लेख प्रदाता उल्लेख पॉपओवर में अंतर्निहित एजेंट और फ़ाइल प्रदाताओं के साथ दिखाई देते हैं।
+
+## संदर्भित फ़ाइलें {#referencing-files}
+
+`@` पॉपओवर एजेंटों तक सीमित नहीं है। आप इसका संदर्भ भी दे सकते हैं:
+
+- **कोडबेस फ़ाइलें** — `@` टाइप करें और फ़ाइल नाम खोजें। फ़ाइल सामग्री को एजेंट के संदर्भ में शामिल किया गया है ताकि वह फ़ाइल को पढ़ सके, उसका विश्लेषण कर सके या उसे संशोधित कर सके।
+- **कार्यस्थान संसाधन** — कार्यस्थान टैब में परिभाषित संदर्भ फ़ाइलें। ये डेटा फ़ाइलें, कॉन्फ़िगरेशन, या कोई अन्य संरचित सामग्री हो सकती हैं।
+- **Skills** — किसी कौशल का संदर्भ देने के लिए `/` टाइप करें। Skills संरचित निर्देश प्रदान करता है जो मार्गदर्शन करता है कि एजेंट किसी कार्य को कैसे पूरा करता है।
+
+सभी संदर्भ प्रकार एक ही पैटर्न का पालन करते हैं: पॉपओवर से चयन करें, और संदर्भित सामग्री को हल किया जाता है और संदेश भेजे जाने पर एजेंट के संदर्भ में इंजेक्ट किया जाता है।
+
+## उप-एजेंट चयन {#sub-agent-selection}
+
+`agent-teams` (क्रिया: "स्पॉन") के साथ उप-एजेंटों को उत्पन्न करते समय मुख्य एजेंट कस्टम एजेंटों का भी उपयोग कर सकता है।
+
+`agents/*.md` से प्रोफ़ाइल चुनने के लिए `agent` पैरामीटर पास करें। उस प्रोफ़ाइल के निर्देश प्रत्यायोजित रन में जोड़े जाते हैं, और इसका `model` फ्रंटमैटर उस उप-एजेंट के लिए डिफ़ॉल्ट मॉडल को ओवरराइड कर सकता है।

package/corpus/core/docs/content/locales/hi-IN/agent-surfaces.md

@@ -0,0 +1,397 @@
+---
+title: "एजेंट सतह"
+description: "Agent-Native का उपयोग बिना सोचे-समझे, रिच चैट के रूप में, किसी मौजूदा ऐप के अंदर, या पूर्ण एजेंट-नेटिव एप्लिकेशन के रूप में करें।"
+search: "हेडलेस एजेंट रिच चैट पूर्ण ऐप BYO एजेंट रनटाइम एजेंटचैटरनटाइम एम्बेड actions MCP A2A HTTP CLI"
+---
+
+# एजेंट सतहें
+
+Agent-Native जानबूझकर रचना योग्य है। आप एजेंट का उपयोग बहुत अधिक UI के बिना कर सकते हैं,
+अंतर्निहित एजेंट रनटाइम के बिना UI का उपयोग करें, या दोनों को पूर्ण रूप में एक साथ उपयोग करें
+आवेदन.
+
+चुनने का उपयोगी तरीका पहले प्रोटोकॉल नहीं है। उत्पाद की सतह चुनें
+आप चाहें, तो मेल खाने वाले प्रिमिटिव का उपयोग करें।
+
+| सतह                          | इसका उपयोग तब करें जब                                                                                     | से प्रारंभ करें                                                                             |
+| ---------------------------- | --------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- |
+| **नेतृत्वहीन एजेंट**         | कोड, जॉब, स्क्रिप्ट, अन्य ऐप, या किसी अन्य एजेंट को कार्य को सीधे कॉल करना चाहिए।                         | `agent-native create --headless`, `defineAction`, `agent-native agent`, HTTP, CLI, MCP, A2A |
+| **Agent-Native पर रिच चैट**  | आप अंतर्निहित एजेंट लूप द्वारा समर्थित एक स्टैंडअलोन या एम्बेडेड चैट चाहते हैं।                           | [Chat template](/docs/template-chat), `<AgentChatSurface>`, `<AssistantChat>`               |
+| **आपके एजेंट पर समृद्ध चैट** | आपने एजेंट कहीं और बनाया है और Agent-Native का कंपोजर, ट्रांसक्रिप्ट, टूल कार्ड और नेटिव विजेट चाहते हैं। | `AgentChatRuntime`, `<AssistantChat runtime={runtime}>`                                     |
+| **एंबेडेड साइडकार**          | आपके पास पहले से ही एक SaaS ऐप है और आप उसके पास पेज संदर्भ और होस्ट कमांड के साथ एक एजेंट चाहते हैं।     | `createAgentNativeEmbeddedPlugin()`, `AgentNativeEmbedded`                                  |
+| **पूर्ण आवेदन**              | मनुष्यों और एजेंटों को टिकाऊ स्क्रीन, डेटा, नेविगेशन और सहयोग साझा करना चाहिए।                            | टेम्पलेट्स, actions, SQL स्थिति, संदर्भ जागरूकता                                            |
+
+वे चरण हैं, अलग-अलग उत्पाद नहीं। एक वर्कफ़्लो बिना नेतृत्व
+एक कार्रवाई के साथ एजेंट, चैट में एक तालिका या चार्ट के रूप में दिखाई देता है, और बाद में एक बन जाता है
+एजेंट द्वारा कॉल किए जाने वाले ऑपरेशन को बदले बिना किसी ऐप में पूर्ण स्क्रीन।
+
+```an-diagram title="The surface spectrum" summary="One action surface, four product shapes — each adds UI without changing the operation underneath."
+{
+  "html": "<div class=\"diagram-spectrum\"><div class=\"diagram-card\"><strong>Headless</strong><small class=\"diagram-muted\">actions, jobs, scripts, other agents</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>Rich chat</strong><small class=\"diagram-muted\">composer, transcript, tool cards</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>Embedded sidecar</strong><small class=\"diagram-muted\">agent beside an existing app</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card accent-card\"><span class=\"diagram-pill accent\">most UI</span><strong>Full application</strong><small class=\"diagram-muted\">durable screens, data, collaboration</small></div></div><div class=\"diagram-base\" data-rough><span class=\"diagram-muted\">same actions · same SQL · same agent loop</span></div>",
+  "css": ".diagram-spectrum{display:flex;align-items:stretch;gap:10px;flex-wrap:wrap}.diagram-spectrum .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;min-width:150px;flex:1}.diagram-spectrum .diagram-arrow{align-self:center;font-size:22px;line-height:1}.diagram-base{margin-top:12px;padding:10px 14px;text-align:center}"
+}
+```
+
+## नेतृत्वहीन एजेंट {#headless}
+
+जब किसी को कस्टम ऐप स्क्रीन को घूरने की आवश्यकता न हो तो हेडलेस पथ का उपयोग करें
+कार्य चलता है: निर्धारित कार्य, एकीकरण, बैकएंड वर्कफ़्लो, CLI लूप,
+कोई अन्य एजेंट, या कोई मौजूदा उत्पाद जो Agent-Native पर कॉल कर रहा है।
+
+जब **एजेंट *उत्पाद*है** - तब तक पहुंचने के लिए यह आकार भी है -
+ऐप-एजेंट लूप सामने का दरवाजा है, डैशबोर्ड नहीं। आप
+टर्मिनल, Slack, ईमेल, एक निर्धारित नौकरी, अन्य एजेंट, या चैट - "मेरा सारांश प्रस्तुत करें
+अपठित ईमेल," "दैनिक मेट्रिक्स को Slack पर पोस्ट करें," "उन उम्मीदवारों को ढूंढें जो
+पिछले सप्ताह उत्तर दिया गया" - और एजेंट कार्य करता है और जहां कहीं भी परिणाम देता है
+के अंतर्गत आता है। यह अभी भी एक वास्तविक ऐप है, कोई स्टेटलेस प्रॉम्प्ट नहीं: actions, प्रमाणीकरण सत्र,
+ऐप स्थिति, थ्रेड/रन इतिहास, सेटिंग्स, क्रेडेंशियल और शेयर रिकॉर्ड सभी लाइव
+SQL में।
+
+यह पैटर्न तब चुनें जब:
+
+- **कार्य पृष्ठभूमि में होता है।** अधिकांश मान तब निर्मित होता है जब उपयोगकर्ता नहीं देख रहा होता है - ट्राइएज एजेंट, दैनिक-रिपोर्ट एजेंट, ऑन-कॉल उत्तरदाता।
+- **आउटपुट ऐप छोड़ देता है।** एजेंट Slack पर पोस्ट करता है, ईमेल भेजता है, या तीसरे पक्ष के सिस्टम को अपडेट करता है; ऐप में ब्राउज़ करने के लिए कुछ भी नहीं है।
+- **डोमेन एक-शॉट है।** अनुसंधान बॉट, सारांश जनरेटर, रिपोर्ट लेखक - कोई स्थायी वस्तु नहीं है जिसके लिए सूची दृश्य की आवश्यकता हो।
+- **आप प्रोटोटाइप कर रहे हैं।** एजेंट को अभी भेजें; यदि उपयोगकर्ता चाहें तो बाद में अधिक समृद्ध UI जोड़ें।
+
+यदि आपका उत्पाद उपयोगकर्ताओं द्वारा ब्राउज़, पिवोट और लगातार उपयोग की जाने वाली वस्तुओं के आधार पर बनाया गया है
+साझा करें - ईमेल, ईवेंट, दस्तावेज़, चार्ट - एक [full application](#full-application) चुनें
+या इसके बजाय एक [template](/docs/cloneable-saas); वे एक पूर्ण UI _प्लस_ एजेंट जोड़ते हैं।
+
+### बॉक्स में क्या भेजा जाता है {#in-the-box}
+
+एक हेडलेस ऐप कई हफ्तों तक डैशबोर्ड पर काम नहीं करता है, और यह दिन से चैनल-अज्ञेयवादी हो जाता है
+एक - एक ही एजेंट वेब, Slack, टेलीग्राम, ईमेल और अन्य एजेंटों से चलता है
+क्योंकि सब कुछ एजेंट के माध्यम से जाता है, UI के माध्यम से नहीं। समझौता वहीं है
+कोई "हर चीज़-एक-नज़र में ब्राउज़ करें" दृश्य नहीं; यदि उपयोगकर्ताओं को इसकी आवश्यकता है, तो पैटर्न मिलाएं और
+एक छोटा स्थिति पृष्ठ या सूची दृश्य जोड़ें।
+
+जब आप अंतर्निहित चैट शेल जोड़ते हैं, तो फ्रेमवर्क पांच प्रबंधन प्रदान करता है
+ऐसी सतहें जिन्हें आपको बनाने की ज़रूरत नहीं है: **चैट** (मुख्य इनपुट), **कार्यस्थान**
+(skills, मेमोरी, निर्देश, उप-एजेंट, कनेक्टेड MCP सर्वर, शेड्यूल किया गया
+नौकरियाँ), **कार्य इतिहास**, **थ्रेड इतिहास**, और **सेटिंग्स**। वे आमतौर पर
+पर्याप्त - उससे बात करें, देखें कि उसने क्या किया है, कॉन्फ़िगर करें कि वह कैसा व्यवहार करता है। के लिए पहुंचें
+[Chat](/docs/template-chat) जब आप उस ब्राउज़र को जोड़ने के लिए तैयार हों UI, या
+कार्यस्थान-शैली की शुरुआत के लिए [Dispatch template](/docs/template-dispatch)
+Slack/टेलीग्राम, निर्धारित नौकरियों और बॉक्स से बाहर साझा रहस्यों के साथ बिंदु।
+
+सबसे छोटा स्थानीय पथ एक हेडलेस एजेंट मचान और एक क्रिया है:
+
+```bash
+npx @agent-native/core@latest create my-agent --headless
+cd my-agent
+pnpm install
+```
+
+फिर टिकाऊ संचालन को परिभाषित करें:
+
+```ts
+// actions/summarize-week.ts
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+export default defineAction({
+  description: "Summarize this week's submissions.",
+  readOnly: true,
+  schema: z.object({ formId: z.string() }),
+  run: async ({ formId }) => {
+    return { formId, summary: "34 submissions, up 18% from last week." };
+  },
+});
+```
+
+तब एक क्रिया को इस प्रकार कॉल किया जा सकता है:
+
+- **HTTP** — `POST /_agent-native/actions/summarize-week`
+- **CLI** — `pnpm action summarize-week --formId form_123`
+- **ऐप-एजेंट CLI** — `pnpm agent "Summarize form_123"`
+- **MCP** - Claude, ChatGPT, Codex, कर्सर, ओपनकोड, कोपायलट और अन्य MCP होस्ट से
+- **A2A** - किसी अन्य एजेंट-मूल ऐप या एजेंट सहकर्मी से
+- **UI** — `useActionQuery`, `useActionMutation`, या `callAction` के माध्यम से
+- **एजेंट टूल** - अंतर्निहित चैट लूप से
+
+```an-api title="Calling an action over HTTP"
+{
+  "method": "POST",
+  "path": "/_agent-native/actions/summarize-week",
+  "summary": "Invoke any action by name over HTTP",
+  "description": "Every `defineAction` is auto-mounted at `/_agent-native/actions/<name>`. The JSON body is validated against the action's zod schema before `run` executes.",
+  "request": {
+    "contentType": "application/json",
+    "example": "{ \"formId\": \"form_123\" }"
+  },
+  "responses": [
+    { "status": "200", "description": "The action's return value as JSON", "example": "{ \"formId\": \"form_123\", \"summary\": \"34 submissions, up 18% from last week.\" }" },
+    { "status": "400", "description": "Input failed schema validation" }
+  ]
+}
+```
+
+यह नो-डेटाबेस या स्टेटलेस मोड नहीं है। ऐप-एजेंट लूप सत्र संग्रहीत करता है,
+थ्रेड्स, रन, सेटिंग्स, क्रेडेंशियल्स, एप्लिकेशन स्थिति और शेयर रिकॉर्ड
+SQL. स्थानीय विकास SQLite पर डिफ़ॉल्ट होता है; होस्ट किए गए हेडलेस ऐप्स को a
+लगातार SQL डेटाबेस।
+
+यदि आपको प्रोजेक्ट फ़ोल्डर से संपूर्ण एजेंट लूप को बिना किसी प्रयास के चाहिए, तो इसका उपयोग करें:
+
+```bash
+pnpm agent "Summarize this week's forms."
+```
+
+यदि किसी अन्य ऐप या स्क्रिप्ट को पूरे एजेंट को कॉल करने की आवश्यकता है, तो इसका उपयोग करें
+`agentNative.invoke("analytics", "...")` या `agent-native invoke` CLI। वह
+क्रॉस-ऐप कार्य को A2A पथ पर रखता है जबकि स्थानीय कार्य actions पर रहता है।
+
+कर्मचारी, नौकरियां, एकीकरण webhooks और कस्टम होस्ट एजेंट लूप चला सकते हैं
+सीधे सर्वर API के माध्यम से। यह actions से निम्न-स्तर है - आप प्रदान करते हैं
+इंजन, मॉडल, संदेश, actions, और ईवेंट स्वयं सिंक हो जाते हैं:
+
+```ts
+import { runAgentLoop } from "@agent-native/core/server";
+
+await runAgentLoop({ engine, model, systemPrompt, actions, messages, send });
+```
+
+अधिकांश ऐप्स के लिए, निर्धारित संकेत और एकीकरण webhooks पहले से ही इस लूप को कॉल करते हैं
+आपके लिए। कस्टम हेडलेस होस्ट बनाते समय ही सीधे उस तक पहुंचें, eval
+रनर, या सर्वर-साइड ऑर्केस्ट्रेशन सतह - [सर्वर - प्रोडक्शन एजेंट
+हैंडलर](/docs/server#agent-handler) पूर्ण हस्ताक्षर के लिए।
+
+### फ़ोल्डर के विरुद्ध चल रहा है {#folder-loop}
+
+यदि आपका लक्ष्य "इस फ़ोल्डर के विरुद्ध एक एजेंट चलाना" है, तो ऐप-एजेंट से शुरुआत करें
+उस फ़ोल्डर में लूप करें: हेडलेस ऐप को स्कैफोल्ड करें, actions/निर्देश जोड़ें, चलाएं
+`pnpm agent "..."`. यह कार्य को उसी क्रिया/रनटाइम/स्थिति में रखता है
+ऐप अनुबंध का उपयोग उत्पादन में करेगा।
+
+बाहरी कोडिंग हार्नेस Claude को एम्बेड करने के लिए एक अलग उत्पाद सतह है
+कोड, Codex, Pi, कर्सर, मास्ट्रा, या Agent-Native ऐप के अंदर समान रनटाइम।
+जब आप कोडिंग-एजेंट उत्पाद बना रहे हों तो उनका उपयोग करें, डिफ़ॉल्ट तरीके के रूप में नहीं
+एक स्थानीय एजेंट-मूल वर्कफ़्लो प्रारंभ करें।
+
+### क्लाउड रेपो एक्सेस {#cloud-repo-access}
+
+क्लाउड हेडलेस ऐप्स के लिए जिन्हें रिपॉजिटरी एक्सेस की आवश्यकता है, GitHub कनेक्टर का उपयोग करें
+प्लस टोकन CRUD मॉडल: रिपॉजिटरी की सूची बनाएं, फ़ाइलें खोजें, फ़ाइलें पढ़ें, बनाएं या
+फ़ाइलें संपादित करें, फ़ाइलें हटाएं, और प्रदाता-दायरे के माध्यम से पहुंच रद्द करें
+प्रमाणपत्र. स्थानीय विकास में, लक्ष्य भंडार को स्पष्ट रूप से सेट करें:
+
+```bash
+GITHUB_REPOSITORY=owner/repo pnpm agent "Read README.md and suggest the next action."
+```
+
+VM क्लोन या लंबे समय तक चलने वाले सैंडबॉक्स चेकआउट को प्राथमिक क्लाउड न मानें
+रेपो-एक्सेस मॉडल। पृथक कोड निष्पादन के लिए सैंडबॉक्स अभी भी मायने रखते हैं, लेकिन
+रिपोजिटरी पहुंच स्पष्ट, अनुमति प्राप्त, ऑडिट योग्य और प्रतिसंहरणीय होनी चाहिए
+कनेक्टर परत के माध्यम से।
+
+### सत्र और रन साझा करना {#sharing-runs}
+
+बिना सोचे-समझे सत्र और रन टिकाऊ वस्तुएं हैं। साझाकरण को चरणबद्ध किया जाना चाहिए:
+पहले लिंक पढ़ें/साझा करें, ताकि टीम के साथी स्वच्छ संकेतों, आउटपुट का निरीक्षण कर सकें
+और रन स्थिति; बाद में लिखने योग्य सहयोग की अनुमति दी गई, इसलिए एक रन जारी रखें,
+actions को मंजूरी देना, शेड्यूल संपादित करना, या कॉन्फ़िगरेशन बदलना
+स्पष्ट पहुंच जांच।
+
+## Agent-Native पर रिच चैट {#rich-chat}
+
+जब उपयोगकर्ता को एजेंट से बात करनी हो, टूल कॉल देखें, तो अंतर्निहित चैट का उपयोग करें
+कार्य को मंजूरी दें, मूल परिणामों का निरीक्षण करें, और एक टिकाऊ थ्रेड इतिहास रखें।
+
+पूर्ण ऐप शुरुआती बिंदु के लिए, [Chat template](/docs/template-chat) का उपयोग करें:
+
+```bash
+npx @agent-native/core@latest create my-chat-app --template chat
+```
+
+सबसे सरल पूर्ण-पृष्ठ चैट:
+
+```tsx
+import { AgentChatSurface } from "@agent-native/core/client/chat";
+
+export default function ChatRoute() {
+  return <AgentChatSurface mode="page" className="h-screen" />;
+}
+```
+
+जब किसी ऐप में पूर्ण-पृष्ठ चैट टैब और `AgentSidebar` दोनों हों, तो इसका उपयोग करें
+दोनों सतहों पर `storageKey`, `chatViewTransition` सक्षम करें, और इंस्टॉल करें
+लेआउट में चैट-होम हैंडऑफ़ हेल्पर्स। सामान्य इन-ऐप लिंक चैट से बाहर
+पेज फिर सक्रिय रहते हुए पूरी चैट को साइडबार में रूपांतरित कर सकता है
+थ्रेड:
+
+```tsx
+import {
+  AgentChatSurface,
+  AgentSidebar,
+  useAgentChatHomeHandoff,
+  useAgentChatHomeHandoffLinks,
+} from "@agent-native/core/client/chat";
+import { useLocation } from "react-router";
+
+function ChatRoute() {
+  return (
+    <AgentChatSurface mode="page" storageKey="my-app" chatViewTransition />
+  );
+}
+
+function AppLayout({ children }: { children: React.ReactNode }) {
+  const location = useLocation();
+  const handoffActive = useAgentChatHomeHandoff({
+    storageKey: "my-app",
+    activePath: location.pathname,
+    enabled: location.pathname !== "/chat",
+  });
+  useAgentChatHomeHandoffLinks({ storageKey: "my-app", chatPath: "/chat" });
+
+  return (
+    <AgentSidebar
+      storageKey="my-app"
+      chatViewTransition
+      openOnChatRunning={handoffActive}
+    >
+      {children}
+    </AgentSidebar>
+  );
+}
+```
+
+आपके अपने क्रोम के साथ सबसे सरल एम्बेडेड चैट:
+
+```tsx
+import { AssistantChat } from "@agent-native/core/client/chat";
+
+export function ProjectChat({ threadId }: { threadId: string }) {
+  return <AssistantChat threadId={threadId} />;
+}
+```
+
+Actions स्पष्ट देशी विजेट परिणाम लौटा सकता है इसलिए चैट आउटपुट सिर्फ
+पाठ. तालिकाएँ, चार्ट और टाइप किए गए उत्पाद कार्ड प्रथम-पक्ष React
+चैट में घटक, आईफ्रेम के बिना। [Native Chat UI](/docs/native-chat-ui) देखें.
+
+## अपने एजेंट पर रिच चैट {#byo-agent}
+
+इस पथ का उपयोग तब करें जब आपका एजेंट पहले से ही किसी अन्य ढांचे के साथ बना हो या
+रनटाइम और आप इसके आसपास Agent-Native की चैट UI चाहते हैं। `AgentChatRuntime` है
+सीमा: आपका रनटाइम सामान्यीकृत घटनाओं को स्ट्रीम करता है, और Agent-Native रेंडर करता है
+कंपोजर, ट्रांसक्रिप्ट, टूल कॉल, अनुमोदन, मूल विजेट और ऐप लेआउट।
+
+```tsx
+import {
+  AssistantChat,
+  createHttpAgentChatRuntime,
+} from "@agent-native/core/client/chat";
+
+const runtime = createHttpAgentChatRuntime({
+  endpoint: "/api/support-agent/chat",
+});
+
+export function SupportAgentChat() {
+  return <AssistantChat runtime={runtime} threadId="support" />;
+}
+```
+
+OpenAI एजेंटों, OpenAI प्रतिक्रियाओं, Claude के लिए तैयार रनटाइम सहायक मौजूद हैं
+एजेंट SDK, वर्सेल AI SDK, और AG-UI, साथ ही उपरोक्त सामान्यीकृत HTTP रनटाइम
+किसी अन्य एजेंट के लिए (मास्ट्रा, फ़्लू, ईव, लैंगग्राफ, या एक कस्टम सेवा)। ACP है
+अंतिम-उपयोगकर्ता ऐप चैट या A2A ट्रांसपोर्ट नहीं, और Agent-Native वर्तमान में नहीं है
+A2UI समर्थन का दावा करें। ACP एक विशिष्ट स्थान पर समर्थित है - लोकल ड्राइविंग
+कोडिंग एजेंट (मिथुन CLI, Claude कोड,…) के माध्यम से
+[harness layer](/docs/harness-agents#acp), यहां चैट रनटाइम के रूप में नहीं।
+
+[Native Chat UI — BYO agent runtimes](/docs/native-chat-ui#byo-agent-runtimes)
+इवेंट आकृतियों, रनटाइम हेल्पर्स और `chatUI` के लिए विहित घर है
+टूल-परिणाम मेटाडेटा। किसी बाहरी एजेंट को चैट में शामिल करते समय वहीं से शुरुआत करें।
+
+## एंबेडेड साइडकार {#embedded-sidecar}
+
+जब मुख्य उत्पाद पहले से मौजूद हो और आप चाहते हों तो एम्बेडेड साइडकार का उपयोग करें
+इसके बगल में एजेंट।
+
+सर्वर प्लगइन आपके होस्ट ऐप में Agent-Native रूट्स को माउंट करता है और हल करता है
+होस्ट पहचान सर्वर-साइड:
+
+```ts
+import { createAgentNativeEmbeddedPlugin } from "@agent-native/core/server";
+
+export default createAgentNativeEmbeddedPlugin({
+  databaseUrl: process.env.AGENT_NATIVE_DATABASE_URL,
+  auth: getHostSession,
+  actions: hostActions,
+});
+```
+
+React साइडकार पेज संदर्भ और होस्ट कमांड पास करता है:
+
+```tsx
+import { AgentNativeEmbedded } from "@agent-native/core/client";
+
+export function AppShell({ children }) {
+  return (
+    <AgentNativeEmbedded
+      getContext={() => ({
+        route: { pathname: window.location.pathname },
+        selection: { text: window.getSelection()?.toString() || undefined },
+      })}
+      onNavigate={(payload) =>
+        router.navigate((payload as { path: string }).path)
+      }
+      onRefresh={() => queryClient.invalidateQueries()}
+    >
+      {children}
+    </AgentNativeEmbedded>
+  );
+}
+```
+
+```an-diagram title="How the sidecar bridges to a host app" summary="The plugin mounts Agent-Native routes server-side; the React sidecar streams page context in and host commands out."
+{
+  "html": "<div class=\"diagram-sidecar\"><div class=\"diagram-panel\"><strong>Host app</strong><small class=\"diagram-muted\">your existing SaaS</small><div class=\"diagram-node\">getContext()<br><small class=\"diagram-muted\">route · selection</small></div><div class=\"diagram-node\">onNavigate / onRefresh<br><small class=\"diagram-muted\">host commands</small></div></div><div class=\"diagram-col-arrows\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&larr;</div></div><div class=\"diagram-panel accent-panel\"><span class=\"diagram-pill accent\">AgentNativeEmbedded</span><small class=\"diagram-muted\">agent + workspace</small><div class=\"diagram-box\" data-rough>Agent-Native routes<br><small class=\"diagram-muted\">mounted by the server plugin</small></div></div></div>",
+  "css": ".diagram-sidecar{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-sidecar .diagram-panel{display:flex;flex-direction:column;gap:8px;padding:14px 16px;min-width:200px}.diagram-sidecar .diagram-col-arrows{display:flex;flex-direction:column;gap:6px}.diagram-sidecar .diagram-arrow{font-size:22px;line-height:1}"
+}
+```
+
+होस्ट ऑथ, डेटाबेस आइसोलेशन के लिए [Embedding SDK](/docs/embedding-sdk) देखें
+आईफ्रेम/पिकर मोड, और निचले स्तर का ब्रिज APIs।
+
+## पूर्ण आवेदन {#full-application}
+
+जब उपयोगकर्ताओं को टिकाऊ ऑब्जेक्ट और वर्कफ़्लो की आवश्यकता हो तो पूर्ण ऐप पथ का उपयोग करें: फ़ॉर्म,
+डैशबोर्ड, कैलेंडर, इनबॉक्स, संपादक, दस्तावेज़, संपत्ति, या रिपोर्ट।
+
+पूर्ण ऐप्स समान क्रिया और एजेंट अनुबंध के आसपास उत्पाद UI जोड़ते हैं:
+
+- **SQL स्थिति** — ऐप डेटा, नेविगेशन, सेटिंग्स और चैट इतिहास टिकाऊ हैं।
+- **संदर्भ जागरूकता** - एजेंट वर्तमान मार्ग, चयन और केंद्रित वस्तु को जानता है।
+- **लाइव सिंक** - एजेंट परिवर्तन UI को अपडेट करते हैं, और UI परिवर्तन एजेंट के संदर्भ को अपडेट करते हैं।
+- **डीप लिंक** — कार्रवाई के परिणाम सही ऐप दृश्य खोल सकते हैं।
+- **मूल चैट विजेट** — टेबल, चार्ट, कार्ड, अनुमोदन और टाइप किए गए परिणाम इनलाइन दिखाई देते हैं।
+
+जब आपको न्यूनतम ऐप चाहिए तो [Chat template](/docs/template-chat) से प्रारंभ करें
+आपके actions के आसपास, या किसी डोमेन [template](/docs/cloneable-saas) से जब आप
+एक संपूर्ण उत्पाद आकार चाहते हैं।
+
+## कैसे चुनें {#how-to-choose}
+
+| अगर आप सोच रहे हैं...                                                            | चुनें                   |
+| -------------------------------------------------------------------------------- | ----------------------- |
+| "मुझे बस एक कॉल करने योग्य टूल या वर्कफ़्लो की आवश्यकता है।"                     | नेतृत्वहीन एजेंट        |
+| "मुझे फ़्रेमवर्क का एजेंट चाहिए, लेकिन चैट मुख्य UI होनी चाहिए।"                 | Agent-Native पर रिच चैट |
+| "मेरे पास पहले से ही एक एजेंट है; मुझे इसके लिए एक बेहतर चैट UI की आवश्यकता है।" | अपने एजेंट पर रिच चैट   |
+| "मेरे पास पहले से ही एक SaaS ऐप है; इसके बगल में एक एजेंट जोड़ें।"               | एम्बेडेड साइडकार        |
+| "एजेंट और UI को उत्पाद के रूप में एक साथ विकसित होना चाहिए।"                     | पूर्ण आवेदन             |
+
+अनुबंध को छोटा रखें: टिकाऊ संचालन को actions के रूप में परिभाषित करें, स्पष्ट वापसी करें
+विजेट परिणाम जब चैट को समृद्ध UI की आवश्यकता होती है, और पूर्ण स्क्रीन केवल तभी जोड़ते हैं जब उपयोगकर्ता
+लगातार वस्तुओं को ब्राउज़ करने, तुलना करने, कॉन्फ़िगर करने या सहयोग करने की आवश्यकता है।
+
+## संबंधित दस्तावेज़ {#related-docs}
+
+- [Actions](/docs/actions) - हेडलेस ऑपरेशन को एक बार परिभाषित करें।
+- [Native Chat UI](/docs/native-chat-ui) - चैट में टाइप किए गए कार्रवाई परिणाम प्रस्तुत करें।
+- [Drop-in Agent](/docs/drop-in-agent) - चैट, साइडबार या पैनल सतहों को माउंट करें।
+- [Component API](/docs/components) - निचले स्तर के React चैट/संगीतकार टुकड़े।
+- [Embedding SDK](/docs/embedding-sdk) - किसी मौजूदा ऐप में Agent-Native जोड़ें।
+- [External Agents](/docs/external-agents) - MCP-संगत होस्ट को एक ऐप से कनेक्ट करें।
+- [A2A Protocol](/docs/a2a-protocol) - अन्य एजेंटों से कॉल एजेंट।