@agent-native/core 0.76.5 → 0.76.6

package/docs/content/locales/hi-IN/template-forms.md

@@ -0,0 +1,178 @@
+---
+title: "फ़ॉर्म"
+description: "एजेंट-नेटिव फॉर्म बिल्डर - प्राकृतिक भाषा और एक विज़ुअल संपादक के माध्यम से फॉर्म सबमिशन बनाएं, संपादित करें, प्रकाशित करें और रूट करें।"
+---
+
+# फॉर्म
+
+फॉर्म एक एजेंट-नेटिव फॉर्म बिल्डर है। अपने इच्छित फॉर्म का वर्णन करें, इसे संपादक में परिष्कृत करें, और एक सार्वजनिक फॉर्म प्रकाशित करें जो आपके अपने SQL डेटाबेस में सबमिशन संग्रहीत करता है।
+
+```an-wireframe
+{
+  "surface": "desktop",
+  "html": "<div style='display:flex;flex-direction:column;min-height:520px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:10px;padding:14px 16px;border-bottom:1.4px solid var(--wf-line)'><strong>Beta signup</strong><span class='wf-pill accent'>published</span><div style='flex:1'></div><button>Share</button><button class='primary'>Unpublish</button></div><div style='display:flex;gap:8px;padding:12px 16px;border-bottom:1.4px solid var(--wf-line)'><span class='wf-pill accent'>Edit</span><span class='wf-pill'>Results 187</span><span class='wf-pill'>Settings</span><span class='wf-pill'>Integrations</span></div><div style='display:flex;flex-direction:column;gap:12px;padding:30px 78px;overflow:hidden'><h2 style='margin:0'>Beta signup</h2><p class='wf-muted' style='margin:0'>Reserve a spot in the upcoming private beta cohort.</p><div class='wf-card'><strong>Full name</strong><input value='Ada Lovelace'/></div><div class='wf-card'><strong>Work email</strong><input value='you@company.com'/></div><div class='wf-card'><strong>Your role</strong><input value='Select...'/></div><div class='wf-card'><strong>Team size</strong><input value='Select...'/></div></div></div>"
+}
+```
+
+जब आप ऐप खोलते हैं, तो आपको अपने फॉर्म, वर्तमान संपादक और एक लाइव पूर्वावलोकन दिखाई देता है। एजेंट प्रॉम्प्ट से एक फॉर्म बना सकता है, फ़ील्ड लेबल और विकल्प अपडेट कर सकता है, सत्यापन बदल सकता है, और UI द्वारा उपयोग किए जाने वाले समान actions का उपयोग करके सबमिशन गंतव्यों को कनेक्ट कर सकता है।
+
+```an-diagram title="Build, publish, collect" summary="The agent and the visual editor edit one SQL-backed form definition. The public fill page is unauthenticated, and submissions route server-side to your destinations."
+{
+  "html": "<div class=\"diagram-flow\"><div class=\"diagram-col\"><div class=\"diagram-node\">Agent prompt<br><small class=\"diagram-muted\">\"add an NPS question\"</small></div><div class=\"diagram-node\">Visual editor<br><small class=\"diagram-muted\">labels, validation, order</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">create-form · update-form</span><small class=\"diagram-muted\">fields JSON, settings JSON</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">forms table<br><small class=\"diagram-muted\">SQL via Drizzle</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">Public fill page<br><small class=\"diagram-muted\">unauthenticated</small></div><div class=\"diagram-box\">responses<br><small class=\"diagram-muted\">+ Slack / webhook / Sheets</small></div></div></div>",
+  "css": ".diagram-flow{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-flow .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-flow .diagram-arrow{font-size:22px;line-height:1}.diagram-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+}
+```
+
+## आप इसके साथ क्या कर सकते हैं
+
+- **संवादात्मक रूप से फॉर्म बनाएं।** "एक संपर्क फ़ॉर्म बनाएं," "एक NPS स्कोर प्रश्न जोड़ें," "ईमेल फ़ील्ड को आवश्यक बनाएं।" एजेंट SQL-समर्थित स्थिति से फॉर्म स्कीमा और पूर्वावलोकन अपडेट अपडेट करता है।
+- **विज़ुअली फाइन-ट्यून करें।** जब आप सीधे नियंत्रण चाहते हैं तो बिल्डर UI से लेबल, प्लेसहोल्डर, आवश्यक स्थिति, विकल्प और फ़ील्ड ऑर्डर संपादित करें।
+- **शिप किए गए फ़ील्ड प्रकारों का उपयोग करें।** टेक्स्ट, ईमेल, संख्या, लंबा टेक्स्ट, चयन, बहु-चयन, चेकबॉक्स, रेडियो, दिनांक, रेटिंग और स्केल फ़ील्ड बॉक्स से बाहर समर्थित हैं।
+- **प्रतिक्रियाएँ एकत्र करें।** प्रत्येक सबमिशन SQL में प्रति-प्रतिक्रिया विवरण दृश्य और प्रविष्टियों की समीक्षा के लिए एक डैशबोर्ड के साथ संग्रहीत किया जाता है।
+- **रूट सबमिशन।** बिल्ट-इन इंटीग्रेशन का उपयोग करके webhooks, Slack, Discord, या Google शीट्स पर सबमिशन पेलोड भेजें।
+- **सार्वजनिक फ़ॉर्म प्रकाशित करें।** एक सार्वजनिक फ़ॉर्म URL साझा करें और सबमिट करने के बाद एक धन्यवाद संदेश दिखाएं।
+
+## आरंभ करना
+
+लाइव डेमो: [forms.agent-native.com](https://forms.agent-native.com).
+
+1. **प्रॉम्प्ट से एक फॉर्म बनाएं।** आप जो फॉर्म चाहते हैं, उसके लिए पूछें
+   दर्शक और सबमिशन के बाद क्या होना चाहिए।
+2. **संपादक में परिष्कृत करें।** लेबल, सत्यापन, विकल्प और क्रम समायोजित करें
+   प्रत्यक्ष संपादन तेज होने पर विज़ुअल बिल्डर।
+3. **प्रकाशित करें और साझा करें।** उत्तरदाताओं के लिए सार्वजनिक फॉर्म URL का उपयोग करें, फिर देखें
+   परिणाम प्रतिक्रिया दृश्य में आते हैं।
+4. **गंतव्यों को कनेक्ट करें।** नए सबमिशन को Slack, Discord, Google पर रूट करें
+   शीट्स, webhooks, या आपका अपना एक्सटेंशन बिंदु।
+
+### उपयोगी संकेत
+
+- "भूमिका, टीम आकार और प्राथमिकता उपयोग के मामले के साथ एक बीटा साइनअप फॉर्म बनाएं।"
+- "एक आवश्यक NPS प्रश्न और एक निःशुल्क-पाठ अनुवर्ती जोड़ें।"
+- "उत्पाद Slack चैनल पर प्रत्येक नई प्रतिक्रिया पोस्ट करें।"
+- "इस सप्ताह के सबमिशन को सारांशित करें और उन्हें ग्राहक खंड के अनुसार समूहित करें।"
+- "रूटिंग के लिए आवश्यक फ़ील्ड खोए बिना इस फॉर्म को छोटा करें।"
+
+## डेवलपर्स के लिए
+
+इस दस्तावेज़ का शेष भाग फ़ॉर्म टेम्प्लेट की खोज करने वाले या उसका विस्तार करने वाले किसी भी व्यक्ति के लिए है।
+
+### त्वरित शुरुआत
+
+```bash
+npx @agent-native/core@latest create my-forms --standalone --template forms
+cd my-forms
+pnpm install
+pnpm dev
+```
+
+अन्य ऐप्स के साथ-साथ फ़ॉर्म वाले कार्यक्षेत्र के लिए:
+
+```bash
+npx @agent-native/core@latest create my-platform
+```
+
+कार्यस्थान सेटअप के दौरान इच्छित फ़ॉर्म और कोई अन्य टेम्पलेट चुनें।
+
+### मुख्य विशेषताएं {#key-features}
+
+**JSON फॉर्म परिभाषाएँ।** फ़ील्ड एक `fields` JSON कॉलम में रहते हैं, इसलिए एजेंट प्रत्येक फ़ील्ड प्रकार के लिए स्कीमा परिवर्तन के बिना सर्जिकल संपादन कर सकता है।
+
+**सार्वजनिक रूप से पेज भरें।** उत्तरदाता अप्रमाणित फॉर्म जमा कर सकते हैं, जबकि डेटा ब्राउज़र तक पहुंचने से पहले निजी सेटिंग्स हटा दी जाती हैं।
+
+**सर्वर-साइड गंतव्य।** Slack, डिस्कॉर्ड, Google शीट्स और वेबहुक एकीकरण फॉर्म सेटिंग्स में रहते हैं और सबमिशन के बाद चलते हैं।
+
+### डेटा मॉडल
+
+सभी डेटा Drizzle ORM के माध्यम से SQL में रहता है। स्कीमा: `templates/forms/server/db/schema.ts`. फॉर्म में मानक `ownableColumns` और एक मेल खाता फ्रेमवर्क शेयर तालिका होती है, इसलिए वे प्रति-उपयोगकर्ता/प्रति-संगठन साझाकरण मॉडल में फिट हो जाते हैं।
+
+| तालिका        | इसमें क्या है                                                                                                                                                                                                  |
+| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `forms`       | एक फॉर्म परिभाषा - `title`, `description`, अद्वितीय `slug`, `fields` (`FormField` की JSON सरणी), `settings` (JSON `FormSettings`), `status` (`draft` / `published` / `closed`), और एक सॉफ्ट-डिलीट `deleted_at` |
+| `responses`   | प्रति पंक्ति एक सबमिशन - `form_id`, `data` (JSON `{ fieldId: value }`), `submitted_at`, वैकल्पिक `ip` और `submitter_email`                                                                                     |
+| `form_shares` | फ्रेमवर्क टेबल मैपिंग प्रिंसिपलों (उपयोगकर्ताओं या संगठनों) को प्रति फॉर्म भूमिकाओं (दर्शक, संपादक, व्यवस्थापक) के साथ साझा करता है                                                                            |
+
+`fields` और `settings` JSON आकृतियों को `templates/forms/shared/types.ts` (`FormField`, `FormSettings`) में परिभाषित किया गया है। किसी भी डेटा को `toPublicFormSettings` के माध्यम से सार्वजनिक भरण पृष्ठ तक पहुंचने से पहले मालिक-निजी सेटिंग्स जैसे एकीकरण वेबहुक URLs और अनुमत मूल हटा दिए जाते हैं।
+
+```an-schema title="Forms data model" summary="Three tables. Fields and integrations are JSON columns on forms, so the agent's edits are surgical patches rather than cross-table row changes."
+{
+  "entities": [
+    {
+      "id": "forms",
+      "name": "forms",
+      "note": "A form definition (ownable)",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "title", "type": "string" },
+        { "name": "description", "type": "string", "nullable": true },
+        { "name": "slug", "type": "string", "note": "unique; public URL" },
+        { "name": "fields", "type": "json", "note": "FormField[] — all field types" },
+        { "name": "settings", "type": "json", "note": "FormSettings — integrations, etc." },
+        { "name": "status", "type": "enum", "note": "draft | published | closed" },
+        { "name": "deleted_at", "type": "datetime", "nullable": true, "note": "soft delete" },
+        { "name": "owner_email", "type": "string" },
+        { "name": "org_id", "type": "id", "nullable": true }
+      ]
+    },
+    {
+      "id": "responses",
+      "name": "responses",
+      "note": "One submission per row",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "form_id", "type": "id", "fk": "forms.id" },
+        { "name": "data", "type": "json", "note": "{ fieldId: value }" },
+        { "name": "submitted_at", "type": "datetime" },
+        { "name": "ip", "type": "string", "nullable": true },
+        { "name": "submitter_email", "type": "string", "nullable": true }
+      ]
+    },
+    {
+      "id": "form_shares",
+      "name": "form_shares",
+      "note": "Framework shares table — principals to roles per form",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "form_id", "type": "id", "fk": "forms.id" },
+        { "name": "principal", "type": "string", "note": "user or org" },
+        { "name": "role", "type": "enum", "note": "viewer | editor | admin" }
+      ]
+    }
+  ],
+  "relations": [
+    { "from": "forms", "to": "responses", "kind": "1-n", "label": "has responses" },
+    { "from": "forms", "to": "form_shares", "kind": "1-n", "label": "has share grants" }
+  ]
+}
+```
+
+### कुंजी actions
+
+प्रत्येक ऑपरेशन `templates/forms/actions/` में एक TypeScript फ़ाइल है, जो `POST /_agent-native/actions/:name` पर ऑटो-माउंटेड है:
+
+- `create-form` - एक नया फॉर्म बनाएं (शीर्षक, विवरण, फ़ील्ड, सेटिंग्स)
+- `update-form` - फ़ील्ड, सेटिंग्स या स्थिति अपडेट करें
+- `get-form` - आईडी या स्लग द्वारा एक फॉर्म पुनर्प्राप्त करें
+- `list-forms` - सुलभ प्रपत्रों की सूची
+- `delete-form` - सॉफ्ट-डिलीट (`deleted_at` सेट करता है)
+- `restore-form` - सॉफ़्ट-डिलीट किए गए फ़ॉर्म को पुनर्स्थापित करें
+- `list-responses` - वैकल्पिक फ़िल्टर के साथ एक फॉर्म के लिए सबमिशन की सूची
+- `export-responses` - प्रतिक्रियाओं को CSV या JSON के रूप में निर्यात करें
+
+### इसे अनुकूलित करना
+
+पहले एजेंट से शिप किए गए व्यवहार के बारे में पूछें:
+
+- "पसंदीदा संपर्क विधि के लिए एक आवश्यक रेडियो फ़ील्ड जोड़ें।"
+- "हर नए सबमिशन को Slack पर पोस्ट करें।" पहले [Messaging](/docs/messaging) के माध्यम से Slack को कनेक्ट करें।
+- "हमारे CRM के लिए एक वेबहुक गंतव्य जोड़ें।"
+- "1-10 पैमाने और एक लंबे पाठ अनुवर्ती के साथ एक ग्राहक फीडबैक फॉर्म बनाएं।"
+- "कुछ फॉर्म सार्वजनिक करें और अन्य केवल लॉगिन के लिए।"
+
+यदि आपको फ़ाइल अपलोड, हस्ताक्षर, या कस्टम फ़ील्ड विजेट जैसी नई क्षमताओं की आवश्यकता है, तो उन्हें टेम्पलेट एक्सटेंशन के रूप में मानें: SQL आकार, actions, UI संपादक नियंत्रण, सार्वजनिक रेंडरर समर्थन और एजेंट निर्देश एक साथ जोड़ें। मौजूदा बिल्ड पैटर्न के लिए [Creating Templates](/docs/creating-templates) देखें।
+
+## आगे क्या
+
+- [**Templates**](/docs/cloneable-saas) - क्लोन-एंड-ओन मॉडल
+- [**Actions**](/docs/actions) - बिल्डर को शक्ति प्रदान करने वाली क्रिया प्रणाली
+- [**Messaging**](/docs/messaging) - Slack और अन्य सबमिशन गंतव्य

package/docs/content/locales/hi-IN/template-mail.md

@@ -0,0 +1,239 @@
+---
+title: "मेल"
+description: "एक एजेंट-संचालित ईमेल क्लाइंट। अपना Gmail कनेक्ट करें और एजेंट आपके लिए ईमेल पढ़ सकता है, ड्राफ्ट कर सकता है, भेज सकता है और व्यवस्थित कर सकता है।"
+---
+
+# मेल
+
+एजेंट-संचालित ईमेल क्लाइंट। अपने Gmail खाते को कनेक्ट करें और एजेंट आपके लिए ईमेल पढ़ सकता है, ड्राफ्ट कर सकता है, भेज सकता है और व्यवस्थित कर सकता है - एक तेज़, कीबोर्ड-फर्स्ट इनबॉक्स के साथ जिसे आप स्वयं चला सकते हैं। सुपरह्यूमन के बारे में सोचें, लेकिन एजेंट प्रथम श्रेणी का नागरिक है और कोडबेस आपका है।
+
+```an-wireframe
+{
+  "surface": "desktop",
+  "html": "<div style='display:flex;flex-direction:column;min-height:500px;box-sizing:border-box'><div style='display:flex;align-items:center;gap:12px;padding:12px 16px;border-bottom:1.4px solid var(--wf-line)'><strong>Inbox 16</strong><div style='flex:1'></div><span data-icon='search' aria-label='Search'></span><span data-icon='edit' aria-label='Compose'></span><span data-icon='bell' aria-label='Notify'></span></div><div style='display:flex;flex-direction:column;padding:8px 14px;gap:6px'><div class='wf-box' style='display:grid;grid-template-columns:155px 1fr auto;gap:12px;align-items:center'><strong>Priya Mehta</strong><span><strong>Q3 launch</strong> — final assets ready for review</span><span>★</span></div><div class='wf-box' style='display:grid;grid-template-columns:155px 1fr auto;gap:12px;align-items:center'><strong>Acme Billing</strong><span>Your monthly invoice is ready</span><span>11:10 AM</span></div><div class='wf-box' style='display:grid;grid-template-columns:155px 1fr auto;gap:12px;align-items:center'><span>Marcus Tang</span><span>Onboarding flow research findings</span><span>Yesterday</span></div><div class='wf-box' style='display:grid;grid-template-columns:155px 1fr auto;gap:12px;align-items:center'><span>GitHub</span><span>[framework] PR ready for review</span><span>Yesterday</span></div><div class='wf-box' style='display:grid;grid-template-columns:155px 1fr auto;gap:12px;align-items:center'><span>Linear</span><span>Issue ENG-1287 assigned to you</span><span>May 2</span></div><div class='wf-box' style='display:grid;grid-template-columns:155px 1fr auto;gap:12px;align-items:center'><span>Stripe</span><span>Weekly payments summary</span><span>Apr 29</span></div><div class='wf-box' style='display:grid;grid-template-columns:155px 1fr auto;gap:12px;align-items:center'><span>Calendly</span><span>New booking confirmed</span><span>Apr 28</span></div></div></div>"
+}
+```
+
+जब आप ऐप खोलते हैं, तो कीबोर्ड-फर्स्ट इनबॉक्स और थ्रेड व्यू मेल पर ही केंद्रित रहता है। एजेंट को हमेशा पता होता है कि आप किस दृश्य में हैं और आपने कौन सा थ्रेड खोला है, इसलिए आप "यह" क्या है, यह बताए बिना "इसे संग्रहीत करें" या "दोस्ताना गिरावट का मसौदा तैयार करें" कह सकते हैं।
+
+```an-diagram title="How a mail request flows" summary="Keyboard shortcuts and agent prompts run the same actions. Email lives in Gmail; drafts, automations, and tracking live in SQL and application_state."
+{
+  "html": "<div class=\"diagram-flow\"><div class=\"diagram-col\"><div class=\"diagram-node\">You drive<br><small class=\"diagram-muted\">J/K/E/R shortcuts</small></div><div class=\"diagram-node\">You ask the agent<br><small class=\"diagram-muted\">\"draft a friendly decline\"</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\">list-emails · get-thread · manage-draft · send</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">Gmail<br><small class=\"diagram-muted\">multi-account, via OAuth</small></div><div class=\"diagram-box\">SQL + application_state<br><small class=\"diagram-muted\">drafts · automations · tracking</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</div><div class=\"diagram-box\">Inbox refreshes live</div></div>",
+  "css": ".diagram-flow{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-flow .diagram-col{display:flex;flex-direction:column;gap:10px}.diagram-flow .diagram-arrow{font-size:22px;line-height:1}.diagram-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+}
+```
+
+## आप इसके साथ क्या कर सकते हैं
+
+- **ईमेल पढ़ें और ट्राइएज करें** कीबोर्ड शॉर्टकट के साथ (स्थानांतरित करने के लिए `J`/`K`, संग्रह करने के लिए `E`, उत्तर देने के लिए `R`, लिखने के लिए `C`)।
+- **एकाधिक Gmail खाते कनेक्ट करें** — व्यक्तिगत और एक इनबॉक्स में काम करें।
+- **एजेंट से वह सब कुछ करने के लिए कहें जो आप कर सकते हैं।** "मेरे अपठित ईमेल का सारांश प्रस्तुत करें।" "ऐसा उत्तर लिखें जो विनम्रतापूर्वक अस्वीकार कर दे।" "एक सप्ताह से अधिक पुराने सभी Netlify बॉट ईमेल संग्रहीत करें।"
+- **समीक्षा के लिए ड्राफ्ट कतारबद्ध करें।** टीम के साथी और Slack उपयोगकर्ता एजेंट से किसी संगठन सदस्य के लिए एक ईमेल तैयार करने के लिए कह सकते हैं; स्वामी इसकी समीक्षा करता है, संपादन करता है और मेल से भेजता है।
+- **नियमों के साथ ऑटो-ट्राइएज।** actions (लेबल, संग्रह, मार्क रीड, स्टार, ट्रैश) के साथ सादे अंग्रेजी ("न्यूज़लेटर से") में स्वचालन नियम सेट करें।
+- \*\*ट्रैक खुलता है और आपके द्वारा भेजे गए ईमेल पर क्लिक करता है।
+- **प्रत्येक कनेक्टेड इनबॉक्स में खोजें** एक प्रश्न के साथ।
+- **बल्क संग्रह, निर्यात और लेबल** — इनबॉक्स क्लीनअप के लिए उपयोगी।
+
+## आरंभ करना
+
+लाइव डेमो: [mail.agent-native.com](https://mail.agent-native.com).
+
+> **Google एक चेतावनी दिखा सकता है:** होस्ट किया गया डेमो Gmail एक्सेस के लिए Agent-Native के साझा Google ऐप का उपयोग करता है, इसलिए Google आपको जारी रखने से पहले पुष्टि करने के लिए कह सकता है। अपने स्वयं के Google OAuth क्लाइंट का उपयोग करने के लिए स्थानीय रूप से चलाएं।
+
+जब आप पहली बार ऐप खोलते हैं:
+
+1. साइडबार में **सेटिंग्स** पर क्लिक करें।
+2. **Google खाता कनेक्ट करें** पर क्लिक करें, Gmail में साइन इन करें और स्वीकृत करें।
+3. (वैकल्पिक) कार्य + व्यक्तिगत के लिए दूसरा Google खाता कनेक्ट करें।
+4. इनबॉक्स पर वापस जाएं - आपका वास्तविक Gmail सिंक हो जाएगा।
+
+Google खाता कनेक्ट किए बिना, ऐप एक खाली स्थानीय मेलबॉक्स पर चलता है (स्क्रीनशॉट और डेमो के लिए उपयोगी, और कुछ नहीं)।
+
+## एजेंट से बात हो रही है
+
+एजेंट हर मोड़ पर `application_state.navigation` पढ़ता है, इसलिए यह पहले से ही जानता है कि आप किस दृश्य में हैं, कौन सा थ्रेड खुला है, और कौन सा संदेश केंद्रित है - आपको यह बताने की ज़रूरत नहीं है। आप बस ऐसी बातें कह सकते हैं:
+
+- "मेरे अपठित ईमेल को संक्षेप में प्रस्तुत करें।"
+- "बजट के बारे में ऐलिस से नवीनतम सूत्र ढूंढें।"
+- "ऐसा उत्तर लिखें जो विनम्रतापूर्वक अस्वीकार कर दे।"
+- "एक सप्ताह से अधिक पुराने सभी Netlify बॉट ईमेल को संग्रहीत करें।"
+- "मेरे तारांकित ईमेल खोलें।"
+- "इस मसौदे को और अधिक औपचारिक बनाएं।"
+- "क्या उन्होंने मेरा ईमेल खोला?"
+
+यदि आप टेक्स्ट का चयन करते हैं और Cmd+I दबाते हैं, तो वह चयन आपके अगले संदेश के साथ चला जाता है - इसलिए "इसे अधिक प्रभावी बनाएं" ठीक उसी पर काम करता है जिसे आपने हाइलाइट किया है।
+
+## कीबोर्ड शॉर्टकट
+
+| कुंजी     | कार्रवाई                        |
+| --------- | ------------------------------- |
+| `J`       | अगला ईमेल                       |
+| `K`       | पिछला ईमेल                      |
+| `Up/Down` | जे/के के समान                   |
+| `Enter`   | केंद्रित ईमेल खोलें             |
+| `E`       | ईमेल या थ्रेड को संग्रहीत करें  |
+| `D`       | ट्रैश ईमेल या थ्रेड             |
+| `S`       | तारांकित करें या अतारांकित करें |
+| `R`       | उत्तर दें                       |
+| `U`       | पठित/अपठित टॉगल करें            |
+| `C`       | नया ईमेल लिखें                  |
+| `/`       | फोकस सर्च बार                   |
+| `Cmd+K`   | कमांड पैलेट खोलें               |
+| `G I`     | इनबॉक्स पर जाएं                 |
+| `G S`     | तारांकित पर जाएं                |
+| `G T`     | भेजे गए पर जाएं                 |
+| `G D`     | ड्राफ्ट पर जाएं                 |
+| `G A`     | संग्रह पर जाएं                  |
+| `Esc`     | थ्रेड बंद करें / खोज साफ़ करें  |
+
+## डेवलपर्स के लिए
+
+इस दस्तावेज़ का शेष भाग मेल टेम्पलेट को फोर्क करने वाले या इसे विस्तारित करने वाले किसी भी व्यक्ति के लिए है।
+
+### त्वरित शुरुआत
+
+मेल टेम्पलेट के साथ एक नया कार्यक्षेत्र बनाएं:
+
+```bash
+npx @agent-native/core@latest create my-mail --standalone --template mail
+cd my-mail
+pnpm install
+pnpm dev
+```
+
+या किसी मौजूदा एजेंट-मूल कार्यस्थान में मेल जोड़ें:
+
+```bash
+npx @agent-native/core@latest add-app
+```
+
+Gmail को डेव में कनेक्ट करने के लिए, आपको एक Google OAuth क्लाइंट की आवश्यकता है:
+
+1. [Google Cloud Console](https://console.cloud.google.com/) खोलें और एक प्रोजेक्ट बनाएं।
+2. APIs और सेवाओं → लाइब्रेरी के अंतर्गत **Gmail API** को सक्षम करें।
+3. OAuth 2.0 क्रेडेंशियल बनाएं (प्रकार: वेब एप्लिकेशन)। `http://localhost:8085/_agent-native/google/callback` को अधिकृत रीडायरेक्ट URI के रूप में जोड़ें।
+4. क्लाइंट आईडी और क्लाइंट सीक्रेट को रनिंग ऐप के सेटिंग पेज में कॉपी करें, फिर **Google अकाउंट कनेक्ट करें** पर क्लिक करें।
+
+टोकन `oauth_tokens` SQL तालिका में संग्रहीत होते हैं और स्वचालित रूप से ताज़ा होते हैं। पहला सेट अप होने के बाद आप एकाधिक Gmail खाते कनेक्ट कर सकते हैं।
+
+### मुख्य विशेषताएं
+
+**मल्टी-अकाउंट Gmail.** एक या अधिक Google खातों को कनेक्ट करें, फिर कनेक्टेड इनबॉक्स में सूचीबद्ध करें, खोजें, ड्राफ्ट करें, भेजें, लेबल करें, संग्रहित करें, स्टार बनाएं या ट्रैश करें।
+
+**ड्राफ्ट वर्कफ़्लोज़।** एकाधिक कंपोज़ ड्राफ्ट एप्लिकेशन स्थिति के माध्यम से सिंक होते हैं, और कतारबद्ध SQL ड्राफ्ट टीम के साथियों या Slack उपयोगकर्ताओं को समीक्षा करने और भेजने के लिए मालिक के लिए मेल का अनुरोध करने देते हैं।
+
+**स्वचालन और ट्रैकिंग।** प्राकृतिक-भाषा ट्राइएज नियम लेबल, संग्रह, मार्क रीड, स्टार, ट्रैश या मैन्युअल रूप से ट्रिगर कर सकते हैं; भेजे गए संदेश ओपन और क्लिक को ट्रैक कर सकते हैं।
+
+**खोज, बल्क actions, और पूर्वावलोकन।** साझा actions पावर इनबॉक्स खोज, बल्क संग्रह/निर्यात, और इनलाइन थ्रेड पूर्वावलोकन एजेंट चैट में एम्बेड कर सकते हैं।
+
+### एजेंट आपके संदर्भ को कैसे देखता है
+
+- **वर्तमान दृश्य और थ्रेड** - जब भी आप नेविगेट करते हैं तो UI `navigation` (देखें, थ्रेडआईडी, फोकस्डईमेलआईडी, खोज, लेबल) लिखता है। एजेंट इसे `readAppState("navigation")` या `pnpm action view-screen` के माध्यम से पढ़ता है।
+- **ड्राफ्ट खोलें** - यदि आप एक उत्तर लिख रहे हैं और पूछते हैं "इसे कहने में मेरी मदद करें", तो एजेंट आपके वर्तमान विषय और मुख्य भाग को देखने के लिए मिलान करने वाली `compose-{id}` प्रविष्टि को पढ़ता है, फिर एक अद्यतन ड्राफ्ट वापस लिखता है। UI संपादन को लाइव शुरू करता है।
+- **थ्रेड इतिहास** - संदर्भ मध्य-उत्तर के लिए, एजेंट `pnpm action get-thread --id=<threadId>` के साथ पूरा थ्रेड लाता है।
+
+### एजेंट कैसे कार्रवाई करता है
+
+- **मेल संचालन** - संग्रह, ट्रैश, स्टार, मार्क रीड, सेंड, ड्राफ्ट - सभी `templates/mail/actions/` के तहत `pnpm action <name>` स्क्रिप्ट के रूप में चलते हैं।
+- **नेविगेशन** - आपके लिए थ्रेड खोलने या दृश्य स्विच करने के लिए, एजेंट `application_state.navigate` लिखता है, जिसे UI उपभोग करता है और हटा देता है। `pnpm action navigate` स्क्रिप्ट इसे लपेटती है।
+- **रीफ्रेश** - किसी भी बदलाव के बाद, एजेंट `pnpm action refresh-list` चलाता है ताकि UI पुनः प्राप्त हो।
+
+### डेटा मॉडल
+
+जब कोई Google खाता कनेक्ट होता है, तो ईमेल Gmail में रहता है - ऐप शीर्ष पर एक दृश्य है। जब कोई खाता कनेक्ट नहीं होता है, तो ईमेल `getSetting("local-emails")` (डिफ़ॉल्ट रूप से खाली) के तहत SQL सेटिंग स्टोर में रहते हैं।
+
+| स्टोर/टेबल                    | इसमें क्या है                                                                     |
+| ----------------------------- | --------------------------------------------------------------------------------- |
+| `getSetting("local-emails")`  | कोई Google खाता कनेक्ट न होने पर स्थानीय ईमेल फ़ॉलबैक                             |
+| `getSetting("labels")`        | सिस्टम और उपयोगकर्ता लेबल, अपठित गणनाओं के साथ                                    |
+| `getSetting("mail-settings")` | उपयोगकर्ता प्रोफ़ाइल, ट्रैकिंग प्राथमिकताएं, हस्ताक्षर, उपनाम                     |
+| `getSetting("aliases")`       | ईमेल उपनाम                                                                        |
+| `queued_email_drafts` तालिका  | टीम-साथी द्वारा अनुरोधित ड्राफ्ट स्वामी की समीक्षा/भेजे जाने की प्रतीक्षा में हैं |
+| `email_tracking` तालिका       | भेजे गए संदेशों के लिए ओपन-पिक्सेल ईवेंट                                          |
+| `email_link_tracking` तालिका  | भेजे गए संदेशों के लिए लिंक-क्लिक इवेंट                                           |
+| `application_state` तालिका    | `navigation`, `navigate`, `compose-{id}` प्रविष्टियाँ (अल्पकालिक)                 |
+| `oauth_tokens` तालिका         | Google OAuth टोकन (प्रदाता `"google"`, प्रति खाता एक पंक्ति)                      |
+
+API के माध्यम से आने वाले ईमेल का आकार `{ id, threadId, from, to, cc, subject, snippet, body, date, isRead, isStarred, isArchived, isTrashed, labelIds, accountEmail, attachments }` होता है।
+
+```an-schema title="Mail SQL tables" summary="Email itself lives in Gmail. The SQL tables hold what Gmail doesn't: queued drafts, send-tracking events, and OAuth tokens. Settings and ephemeral state live in the settings and application_state stores."
+{
+  "entities": [
+    {
+      "id": "queued_email_drafts",
+      "name": "queued_email_drafts",
+      "note": "Teammate/Slack-requested drafts awaiting owner review",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "assignedTo", "type": "string", "note": "org member who reviews/sends" },
+        { "name": "subject", "type": "string" },
+        { "name": "body", "type": "markdown" },
+        { "name": "status", "type": "enum", "note": "review at /draft-queue/<id>" }
+      ]
+    },
+    {
+      "id": "email_tracking",
+      "name": "email_tracking",
+      "note": "Open-pixel events for sent messages",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "messageId", "type": "string" },
+        { "name": "openedAt", "type": "datetime" }
+      ]
+    },
+    {
+      "id": "email_link_tracking",
+      "name": "email_link_tracking",
+      "note": "Link-click events for sent messages",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "messageId", "type": "string", "fk": "email_tracking.messageId" },
+        { "name": "url", "type": "string" },
+        { "name": "clickedAt", "type": "datetime" }
+      ]
+    },
+    {
+      "id": "oauth_tokens",
+      "name": "oauth_tokens",
+      "note": "Framework table — one row per connected Google account",
+      "fields": [
+        { "name": "id", "type": "id", "pk": true },
+        { "name": "provider", "type": "string", "note": "\"google\"" },
+        { "name": "accountEmail", "type": "string" },
+        { "name": "accessToken", "type": "string" },
+        { "name": "refreshToken", "type": "string" }
+      ]
+    }
+  ],
+  "relations": [
+    { "from": "email_tracking", "to": "email_link_tracking", "kind": "1-n", "label": "click events" }
+  ]
+}
+```
+
+UI में रूट:
+
+- `/_index.tsx` - डिफ़ॉल्ट इनबॉक्स दृश्य पर रीडायरेक्ट करता है।
+- `/$view.tsx` - एक सूची दृश्य (`inbox`, `starred`, `sent`, `drafts`, `archive`, `trash`, आदि)।
+- `/$view.$threadId.tsx` - एक सूची दृश्य जिसमें एक विशिष्ट थ्रेड खुला हो।
+- `/email` - एजेंट चैट में उपयोग किया जाने वाला एम्बेडेड थ्रेड पूर्वावलोकन।
+- `/settings` - खाता कनेक्शन, ट्रैकिंग, ऑटोमेशन।
+- `/team` - टीम के सदस्य और साझा संसाधन।
+
+### इसे अनुकूलित करना
+
+मेल बदलना आपका है। हर महत्वपूर्ण चीज़ कुछ स्थानों पर रहती है - वहीं से शुरू करें।
+
+**एक एजेंट क्षमता जोड़ना।** `defineAction` का उपयोग करके `templates/mail/actions/` के अंतर्गत एक नई फ़ाइल जोड़ें। आपकी कार्रवाई एक एजेंट टूल, एक CLI कमांड (`pnpm action <name>`), और `useActionQuery` / `useActionMutation` के माध्यम से एक टाइप की गई फ्रंटएंड हुक सतह बन जाती है। एक संक्षिप्त उदाहरण के लिए `templates/mail/actions/star-email.ts` या एकाधिक उप-actions वाले एक के लिए `templates/mail/actions/manage-automations.ts` देखें। पूर्ण पैटर्न के लिए [actions](/docs/actions) दस्तावेज़ देखें।
+
+**UI को बदलना।** रूट `templates/mail/app/routes/` में हैं और घटक `templates/mail/app/components/email/` और `templates/mail/app/components/layout/` में हैं। ऐप `app/components/ui/` और टेबलर आइकॉन से shadcn/ui प्रिमिटिव का उपयोग करता है - उन्हीं पर कायम रहें।
+
+**एजेंट के व्यवहार को बदलना।** एजेंट मार्गदर्शन `templates/mail/AGENTS.md` में रहता है और skills `templates/mail/.agents/skills/` (`email-drafts`, `real-time-sync`, `security`, `self-modifying-code`, और अन्य) में रहता है। एजेंट का व्यवहार मार्कडाउन संपादित करके बदला जाता है - कोड नहीं।
+
+**डेटा या सेटिंग्स बदलना।** ट्रैकिंग तालिकाओं और संबंधित संरचनाओं के लिए स्कीमा `templates/mail/server/db/` में हैं। पढ़ने और लिखने की सेटिंग्स `@agent-native/core/settings` से `readSetting` / `writeSetting` के माध्यम से जाती हैं। एप्लिकेशन स्थिति (नेविगेशन, ड्राफ्ट, वन-शॉट कमांड) `@agent-native/core/application-state` से `readAppState` / `writeAppState` का उपयोग करती है।
+
+**एक नया स्वचालन क्रिया प्रकार जोड़ना।** `templates/mail/actions/manage-automations.ts` में क्रिया स्कीमा और `templates/mail/actions/trigger-automations.ts` में निष्पादक का विस्तार करें।
+
+**कीबोर्ड शॉर्टकट बदलना।** कीबाइंड हैंडलर `templates/mail/app/components/email/` में रहते हैं - प्रत्येक कुंजी कहां वायर्ड है यह जानने के लिए `useHotkeys` या `addEventListener("keydown"` खोजें।
+
+एजेंट से आपके लिए इनमें से कोई भी बदलाव करने के लिए कहें। एजेंट अपने स्वयं के स्रोत को संपादित कर सकता है - [Self-Modifying Code](/docs/key-concepts#agent-modifies-code) देखें।