@agent-native/core 0.76.5 → 0.76.6

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

@@ -0,0 +1,349 @@
+---
+title: "तैनाती"
+description: "Nitro प्रीसेट के साथ किसी भी प्लेटफ़ॉर्म पर एजेंट-नेटिव ऐप्स तैनात करें - Node.js, Vercel, Netlify, Cloudflare, AWS, और बहुत कुछ।"
+---
+
+# तैनाती
+
+एजेंट-नेटिव ऐप्स हुड के तहत [Nitro](https://nitro.build) का उपयोग करते हैं, जिसका अर्थ है कि आप शून्य कॉन्फ़िगरेशन परिवर्तनों के साथ किसी भी प्लेटफ़ॉर्म पर तैनात कर सकते हैं - बस एक प्रीसेट सेट करें।
+
+## तैनाती करने से पहले: एक स्थायी डेटाबेस चुनें {#persistent-database}
+
+प्रत्येक तैनात ऐप को एक सतत SQL डेटाबेस की आवश्यकता होती है। स्थानीय विकास में, एजेंट-नेटिव `data/app.db` पर SQLite फ़ाइल पर वापस आ जाता है; यह आपकी मशीन पर सुविधाजनक है, लेकिन यह कंटेनर, पूर्वावलोकन, या सर्वर रहित वातावरण में टिकाऊ नहीं है जहां फ़ाइल सिस्टम को रीसेट किया जा सकता है।
+
+किसी ऐप को उत्पादन के लिए प्रचारित करने से पहले अपने परिनियोजन प्रदाता में `DATABASE_URL` सेट करें। एजेंट-नेटिव स्कीमा और प्रश्नों के लिए Drizzle का उपयोग करता है, इसलिए डेटा परत Drizzle-संगत SQL बैकएंड में पोर्टेबल है और फ्रेमवर्क URL से बोली का स्वतः पता लगाता है। एडॉप्टर सूची और बोली विवरण के लिए [Database](/docs/database#production) देखें।
+
+`DATABASE_AUTH_TOKEN` का उपयोग केवल तभी करें जब आपके डेटाबेस प्रदाता को एक अलग टोकन की आवश्यकता हो, जैसे Turso/libSQL। कार्यस्थानों के लिए, सभी ऐप्स को डिफ़ॉल्ट रूप से रूट `DATABASE_URL` प्राप्त होता है; जब एक ऐप को अलग डेटाबेस का उपयोग करना चाहिए तो `<APP_NAME>_DATABASE_URL` सेट करें।
+
+## कार्यस्थान परिनियोजन: एक उत्पत्ति, अनेक ऐप्स {#workspace-deploy}
+
+यदि आपका प्रोजेक्ट [workspace](/docs/multi-app-workspace) है, तो आप इसमें प्रत्येक ऐप को एक कमांड के साथ एक ही मूल में भेज सकते हैं:
+
+```bash
+npx @agent-native/core@latest deploy
+# https://your-agents.com/mail/*       → apps/mail
+# https://your-agents.com/calendar/*   → apps/calendar
+# https://your-agents.com/forms/*      → apps/forms
+```
+
+प्रत्येक ऐप को `APP_BASE_PATH=/<name>` और `VITE_APP_BASE_PATH=/<name>` के साथ बनाया गया है, फिर लक्ष्य Nitro प्रीसेट के लिए पैक किया गया है। क्लाउडफ्लेयर पेज डिफ़ॉल्ट प्रीसेट है और `dist/_worker.js` पर जेनरेटेड डिस्पैचर वर्कर का उपयोग करता है; Netlify `.netlify/functions-internal/<app>-server` प्लस जेनरेटेड रीडायरेक्ट में प्रति ऐप एक फ़ंक्शन का उपयोग करता है; वर्सेल बिल्ड आउटपुट API का उपयोग करके एक कार्यक्षेत्र-स्तर `.vercel/output` लिखता है।
+
+```an-diagram title="One origin, many apps" summary="Each workspace app is built with its own base path and mounted under a path prefix on a single origin — so login and cross-app A2A are same-origin and free."
+{
+  "html": "<div class=\"diagram-ws\"><div class=\"diagram-panel\" data-rough><strong>https://your-agents.com</strong><div class=\"diagram-row\"><span class=\"diagram-pill accent\">/mail/*</span><small class=\"diagram-muted\">apps/mail</small></div><div class=\"diagram-row\"><span class=\"diagram-pill accent\">/calendar/*</span><small class=\"diagram-muted\">apps/calendar</small></div><div class=\"diagram-row\"><span class=\"diagram-pill accent\">/forms/*</span><small class=\"diagram-muted\">apps/forms</small></div></div><div class=\"diagram-col wins\"><span class=\"diagram-pill ok\">shared login session</span><span class=\"diagram-pill ok\">zero-config cross-app A2A</span></div></div>",
+  "css": ".diagram-ws{display:flex;align-items:center;gap:16px;flex-wrap:wrap}.diagram-ws .diagram-panel{display:flex;flex-direction:column;gap:6px;padding:14px 16px}.diagram-ws .diagram-row{display:flex;align-items:center;gap:8px}.diagram-ws .wins{display:flex;flex-direction:column;gap:8px;align-items:flex-start}"
+}
+```
+
+समान-मूल परिनियोजन आपको निःशुल्क दो बड़ी जीत प्रदान करता है:
+
+- **साझा लॉगिन सत्र** - किसी भी ऐप में लॉग इन करें, हर ऐप लॉग इन है।
+- **ज़ीरो-कॉन्फिग क्रॉस-ऐप A2A** — मेल से `@calendar` को टैग करना एक समान-मूल फ़ेच है; कोई CORS नहीं, कोई JWT भाई-बहनों के बीच हस्ताक्षर नहीं।
+
+आउटपुट को इसके साथ प्रकाशित करें:
+
+```bash
+wrangler pages deploy dist
+```
+
+Netlify एकीकृत परिनियोजन के लिए, Netlify प्रीसेट का उपयोग करें:
+
+```bash
+npx @agent-native/core@latest deploy --preset netlify
+```
+
+वर्सेल एकीकृत परिनियोजन के लिए, वर्सेल प्रीसेट का उपयोग करें:
+
+```bash
+npx @agent-native/core@latest deploy --preset vercel
+```
+
+प्रदाता बिल्ड कमांड को कॉन्फ़िगर करते समय, `--build-only` के साथ उसी कमांड का उपयोग करें। वर्सेल को `npx @agent-native/core@latest deploy --preset vercel --build-only` चलाना चाहिए; कमांड सीधे `.vercel/output` लिखता है, इसलिए कार्यक्षेत्र रूटिंग के लिए कोई `vercel.json` आवश्यक नहीं है।
+
+होस्ट किए गए कार्यस्थान निर्माण के लिए परिनियोजन प्रदाता परिवेश में `A2A_SECRET` की आवश्यकता होती है।
+इससे Slack, इनबाउंड webhooks और क्रॉस-ऐप A2A हस्ताक्षरित होकर काम फिर से शुरू कर देते हैं
+बैकग्राउंड प्रोसेसर। स्थानीय `--build-only` आर्टिफैक्ट जांच अभी भी इसके बिना चलती है।
+
+प्रति-ऐप स्वतंत्र तैनाती अभी भी समर्थित है - बस एक स्टैंडअलोन मचान की तरह `cd apps/<name> && npx @agent-native/core@latest build`।
+
+## यह कैसे काम करता है {#how-it-works}
+
+जब आप `npx @agent-native/core@latest build` चलाते हैं, तो Nitro क्लाइंट SPA और सर्वर API दोनों को `.output/` में बनाता है:
+
+```an-file-tree title="Build output"
+{
+  "entries": [
+    { "path": ".output/", "note": "self-contained — copy to any environment and run" },
+    { "path": ".output/public/", "note": "built SPA (static assets)" },
+    { "path": ".output/server/index.mjs", "note": "server entry point" },
+    { "path": ".output/server/chunks/", "note": "server code chunks" }
+  ]
+}
+```
+
+आउटपुट स्व-निहित है - `.output/` को किसी भी वातावरण में कॉपी करें और इसे चलाएं।
+
+```an-diagram title="Build to deploy" summary="One source tree builds to a Nitro preset; the same self-contained output runs on Node, Vercel, Netlify, Cloudflare, AWS, or Deno. Every instance points at the same persistent DATABASE_URL."
+{
+  "html": "<div class=\"diagram-deploy\"><div class=\"diagram-box\" data-rough>App source</div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\" data-rough><span class=\"diagram-pill accent\">build</span><small class=\"diagram-muted\">Nitro preset</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-grid\"><span class=\"diagram-pill\">Node.js</span><span class=\"diagram-pill\">Vercel</span><span class=\"diagram-pill\">Netlify</span><span class=\"diagram-pill\">Cloudflare</span><span class=\"diagram-pill\">AWS Lambda</span><span class=\"diagram-pill\">Deno</span></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough>Persistent DATABASE_URL<br><small class=\"diagram-muted\">shared by every instance</small></div></div>",
+  "css": ".diagram-deploy{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-deploy .center{display:flex;flex-direction:column;align-items:center;gap:4px;padding:14px 16px}.diagram-deploy .diagram-arrow{font-size:22px;line-height:1}.diagram-deploy .diagram-grid{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:8px}"
+}
+```
+
+## प्रीसेट सेट करना {#setting-the-preset}
+
+डिफ़ॉल्ट रूप से, Nitro Node.js के लिए बनता है। किसी भिन्न प्लेटफ़ॉर्म को लक्षित करने के लिए, अपने `vite.config.ts` में प्रीसेट सेट करें:
+
+```ts
+import { defineConfig } from "@agent-native/core/vite";
+
+export default defineConfig({
+  nitro: {
+    preset: "vercel",
+  },
+});
+```
+
+या निर्माण समय पर `NITRO_PRESET` पर्यावरण चर का उपयोग करें:
+
+```bash
+NITRO_PRESET=netlify npx @agent-native/core@latest build
+```
+
+## Node.js (डिफ़ॉल्ट) {#nodejs}
+
+डिफ़ॉल्ट प्रीसेट. बनाएं और चलाएं:
+
+```bash
+npx @agent-native/core@latest build
+node .output/server/index.mjs
+```
+
+श्रवण पोर्ट को कॉन्फ़िगर करने के लिए `PORT` सेट करें (डिफ़ॉल्ट: `3000`)।
+
+उत्पादन परिनियोजन के लिए वर्तमान Node.js LTS लाइन का उपयोग करें। मई 2026 तक, वह
+Node.js 24 है; Node.js 20 का जीवन 30 अप्रैल, 2026 को समाप्त हो गया और अब नहीं
+अपस्ट्रीम सुरक्षा अद्यतन प्राप्त करता है।
+
+### डॉकर {#docker}
+
+```dockerfile
+FROM node:24-slim AS build
+WORKDIR /app
+COPY package.json pnpm-lock.yaml ./
+RUN corepack enable && pnpm install --frozen-lockfile
+COPY . .
+RUN pnpm build
+
+FROM node:24-slim
+WORKDIR /app
+COPY --from=build /app/.output .output
+# data/ is a runtime-created SQLite directory — do not copy a dev DB into prod.
+# For production, set DATABASE_URL to a hosted Postgres or Turso instance.
+RUN mkdir -p /app/data
+ENV PORT=3000
+EXPOSE 3000
+CMD ["node", ".output/server/index.mjs"]
+```
+
+## वर्सेल {#vercel}
+
+```ts
+// vite.config.ts
+export default defineConfig({
+  nitro: { preset: "vercel" },
+});
+```
+
+Vercel CLI या git पुश के माध्यम से परिनियोजन करें:
+
+```bash
+vercel deploy
+```
+
+कार्यक्षेत्र के लिए, प्रत्येक ऐप को एक वर्सेल बिल्ड आउटपुट API बंडल में बनाएं:
+
+```bash
+npx @agent-native/core@latest deploy --preset vercel
+```
+
+वर्सेल गिट परिनियोजन के लिए, बिल्ड कमांड को यहां सेट करें:
+
+```bash
+npx @agent-native/core@latest deploy --preset vercel --build-only
+```
+
+वर्कस्पेस बिल्ड प्रत्येक ऐप के Nitro `vercel` आउटपुट को रूट `.vercel/output` में कॉपी करता है, प्रत्येक फ़ंक्शन को अपना माउंट-पाथ वातावरण देता है, और रूट कॉन्फिगरेशन लिखता है जो `/<app-id>` पर ऐप्स को सर्व करता है।
+
+## नेटलिफाई {#netlify}
+
+Nitro `netlify` प्रीसेट अच्छी तरह से काम करता है और, व्यवहार में, हमें बाहरी Postgres (नियॉन) से बात करने वाले टेम्पलेट्स के लिए क्लाउडफ्लेयर पेज (~ 200ms TTFB बनाम ~ 9s) की तुलना में बहुत तेज शुरुआत दी है। या तो प्रीसेट को `vite.config.ts`:
+
+```ts
+// vite.config.ts
+export default defineConfig({
+  nitro: { preset: "netlify" },
+});
+```
+
+…या निर्माण समय पर `NITRO_PRESET=netlify` सेट करें।
+
+कार्यस्थान के लिए, प्रत्येक ऐप को एक Netlify साइट से चलाकर तैनात करें:
+
+```bash
+npx @agent-native/core@latest deploy --preset netlify
+```
+
+वर्कस्पेस बिल्ड `dist/_workspace_static/` के तहत स्टैटिक एसेट लिखता है और प्रत्येक ऐप को बिना किसी एसेट रीडायरेक्ट के अपने स्वयं के नेटलाइज़ फ़ंक्शन पर रूट करता है, इसलिए सर्वर फ़ंक्शन ऐप रूट को संभालने से पहले `/mail/assets/...` जैसी फ़ाइलों को स्टेटिक रूप से परोसा जाता है।
+
+## क्लाउडफ्लेयर पेज {#cloudflare-pages}
+
+```ts
+// vite.config.ts
+export default defineConfig({
+  nitro: { preset: "cloudflare_pages" },
+});
+```
+
+## AWS लैम्ब्डा {#aws-lambda}
+
+```ts
+// vite.config.ts
+export default defineConfig({
+  nitro: { preset: "aws_lambda" },
+});
+```
+
+## डेनो तैनाती {#deno-deploy}
+
+```ts
+// vite.config.ts
+export default defineConfig({
+  nitro: { preset: "deno_deploy" },
+});
+```
+
+## पर्यावरण चर {#environment-variables}
+
+### बिल्ड/रनटाइम {#env-runtime}
+
+| वेरिएबल                     | विवरण                                                                                                                                                                    |
+| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `PORT`                      | सर्वर पोर्ट (केवल Node.js)                                                                                                                                               |
+| `NITRO_PRESET`              | बिल्ड समय पर बिल्ड प्रीसेट को ओवरराइड करें                                                                                                                               |
+| `APP_BASE_PATH`             | एप्लिकेशन को किसी उपसर्ग के अंतर्गत माउंट करें (उदा. `/mail`)। `npx @agent-native/core@latest deploy` द्वारा स्वचालित रूप से सेट करें; स्टैंडअलोन के लिए अनसेट छोड़ दें। |
+| `AGENT_PROD_CODE_EXECUTION` | वैकल्पिक उत्पादन कोड-निष्पादन मोड: `off` (डिफ़ॉल्ट), `sandboxed`, या `trusted`। [Production Code Execution](#production-code-execution) देखें.                           |
+
+डेटाबेस कनेक्शन वेरिएबल (`DATABASE_URL`, `DATABASE_AUTH_TOKEN`, प्रति-ऐप `<APP_NAME>_DATABASE_URL`) [Database](/docs/database#production) में रहते हैं।
+
+### उत्पादन में आवश्यक {#env-required-prod}
+
+किसी ऐप को वास्तविक उत्पाद परिनियोजन के लिए प्रचारित करने से पहले इन्हें सेट किया जाना चाहिए। गुम मान या तो विफल-बंद हो जाते हैं (फ़्रेमवर्क प्रारंभ करने से इंकार कर देता है/अनुरोधों को संभालने से इंकार कर देता है) या ज़ोर से चेतावनी के साथ कमजोर व्यवहार पर वापस आ जाता है।
+
+| वेरिएबल                  | विवरण                                                                                                                                                                                                                                                                                                             |
+| ------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `BETTER_AUTH_SECRET`     | 32+ चार यादृच्छिक स्ट्रिंग। साइन्स सत्र कुकीज़ AND, `OAUTH_STATE_SECRET` और `SECRETS_ENCRYPTION_KEY` के लिए फ़ॉलबैक HMAC है। हार्ड-आवश्यक: उत्पादन में कमी होने पर फ्रेमवर्क स्टार्टअप पर फेंकता है।                                                                                                              |
+| `BETTER_AUTH_URL`        | इस ऐप का सार्वजनिक मूल (उदा. `https://mail.example.com`)। कुकी डोमेन और OAuth रीडायरेक्ट निर्माण के लिए उपयोग किया जाता है।                                                                                                                                                                                       |
+| `ANTHROPIC_API_KEY`      | एम्बेडेड उत्पादन एजेंट के लिए API कुंजी। **बहु-किरायेदार तैनाती में**, जब उपयोगकर्ता के पास प्रति-उपयोगकर्ता कुंजी नहीं होती है तो फ्रेमवर्क इस पर वापस आने से इंकार कर देता है - अपनी खुद की कुंजी लाने की आवश्यकता होती है। एकल-किरायेदार स्व-होस्ट किए गए इंस्टॉल इसे वैश्विक कुंजी के रूप में उपयोग करते हैं। |
+| `OAUTH_STATE_SECRET`     | OAuth राज्य लिफाफे के लिए समर्पित HMAC कुंजी (Google, एटलसियन, ज़ूम)। अनसेट होने पर वापस `BETTER_AUTH_SECRET` पर आ जाता है, लेकिन एक समर्पित मान की अनुशंसा की जाती है ताकि एक को घुमाने से दूसरा अमान्य न हो। `openssl rand -hex 32` के माध्यम से उत्पन्न करें।                                                  |
+| `A2A_SECRET`             | इंटर-ऐप A2A JSON-RPC के लिए साझा HMAC। इसके बिना, प्रत्येक A2A एंडपॉइंट और `/_agent-native/integrations/process-task` सेल्फ-फायर एंडपॉइंट उत्पादन में 503 लौटाता है।                                                                                                                                              |
+| `SECRETS_ENCRYPTION_KEY` | एन्क्रिप्टेड-एट-रेस्ट सीक्रेट्स वॉल्ट के लिए AES-256-GCM कुंजी। `BETTER_AUTH_SECRET` पर वापस आ जाता है। दोनों के असंतुलित होने पर उत्पादन में कठिनाई होती है।                                                                                                                                                     |
+
+### प्रामाणिक एवं पहचान {#env-auth}
+
+OAuth प्रदाता क्रेडेंशियल (Google, GitHub), स्थिर MCP बियरर फ़ॉलबैक (`ACCESS_TOKEN` / `ACCESS_TOKENS`), और ईमेल-सत्यापन टॉगल [Authentication](/docs/authentication) में प्रलेखित हैं। उन्हें आपके द्वारा चुने गए प्रमाणीकरण मोड के अनुसार वहां सेट करें।
+
+### इनबाउंड Webhooks {#env-webhooks}
+
+प्रत्येक मैसेजिंग एकीकरण के लिए उत्पादन में अपने स्वयं के हस्ताक्षर रहस्य की आवश्यकता होती है (रहस्य गायब होने पर जाली अनुरोधों पर हैंडलर विफल हो जाते हैं)। प्रति-एकीकरण चर [Messaging](/docs/messaging) और [Security](/docs/security) में सूचीबद्ध हैं। केवल स्थानीय विकास के लिए, `AGENT_NATIVE_ALLOW_UNVERIFIED_WEBHOOKS=1` "चेतावनी दें और स्वीकार करें" का विकल्प चुनता है - इसे कभी भी उत्पाद में सेट न करें।
+
+### सुरक्षा कॉन्फ़िगरेशन (ऑप्ट-इन) {#security-config}
+
+डिफ़ॉल्ट सख्त हैं। मुट्ठी भर ऑप्ट-इन फ़्लैग व्यवहार को शिथिल करते हैं (डीबग स्टैक ट्रेस, असत्यापित webhooks, वर्कस्पेस-स्कोप्ड कुंजी फ़ॉलबैक, MCP हब मल्टी-ऑर्ग स्विच, रनटाइम एनवी-वर राइट्स)। उन्हें [Security](/docs/security) में उनके सुरक्षा ट्रेड-ऑफ़ के साथ प्रलेखित किया गया है। जब तक आप विशेष रूप से आरामदायक मार्ग नहीं चाहते, उन्हें सेट न करें।
+
+### कार्यस्थान .env वंशानुक्रम {#env-inheritance}
+
+कार्यस्थान के अंदर, रूट `.env` स्वचालित रूप से प्रत्येक ऐप में लोड हो जाता है, इसलिए `ANTHROPIC_API_KEY`, `A2A_SECRET`, `BETTER_AUTH_SECRET`, और `OAUTH_STATE_SECRET` जैसी साझा कुंजियों को केवल एक बार सेट करने की आवश्यकता होती है। प्रति-ऐप `apps/<name>/.env` संघर्ष पर जीतता है।
+
+### मजबूत रहस्य उत्पन्न करना {#env-generate-secrets}
+
+"32+ चार यादृच्छिक" (`BETTER_AUTH_SECRET`, `OAUTH_STATE_SECRET`, `A2A_SECRET`, `SECRETS_ENCRYPTION_KEY`) चिह्नित किसी भी रहस्य के लिए, इसके साथ नए मान उत्पन्न करें:
+
+```bash
+openssl rand -hex 32
+```
+
+प्रत्येक उदाहरण पर env var को प्रतिस्थापित करके और पुनः तैनात करके उन्हें घुमाएं - पुरानी कुंजी के तहत हस्ताक्षरित सत्र / OAuth राज्य लिफाफे अमान्य हो जाते हैं, इसलिए उपयोगकर्ताओं को फिर से साइन इन करने की आवश्यकता हो सकती है।
+
+## उत्पादन एजेंट उपकरण {#production-agent-tools}
+
+प्रोडक्शन एजेंटों को ऐप के पंजीकृत actions प्लस फ्रेमवर्क टूल मिलते हैं
+एजेंट चैट प्लगइन. कच्चे DB
+टूल्स का दायरा प्रमाणित उपयोगकर्ता/संगठन तक होता है, लेकिन ऐप मालिक इसे सीमित कर सकते हैं
+सतह जब तैनाती अधिक विचारशील होनी चाहिए:
+
+```ts
+// server/plugins/agent-chat.ts
+export default createAgentChatPlugin({
+  // Default: "write" (also true)
+  databaseTools: "read", // "write" | "read" | "off"
+  extensionTools: false,
+});
+```
+
+- `databaseTools: "write"` - डिफ़ॉल्ट। रजिस्टर `db-schema`, `db-query`,
+  `db-exec`, और `db-patch`। लेखन का दायरा मौजूदा उपयोगकर्ता/संगठन और
+  स्कीमा परिवर्तन अवरुद्ध हैं।
+- `databaseTools: "read"` - केवल `db-schema` और `db-query` पंजीकृत करता है; एजेंट
+  SQL के साथ डेटा का निरीक्षण करें लेकिन लिखने के लिए टाइप किए गए ऐप actions का उपयोग करना होगा।
+- `databaseTools: "off"` या `false` - कच्चे डेटाबेस टूल को हटा देता है
+  एजेंट सतह इसलिए ऐप का actions ही एकमात्र डेटा एक्सेस पथ है।
+- `extensionTools: false` - फ्रेमवर्क एक्सटेंशन-प्रबंधन actions को हटा देता है और
+  ऐप्स के लिए त्वरित मार्गदर्शन (`create-extension`, `update-extension`, आदि)
+  नहीं चाहते कि एजेंट सैंडबॉक्स वाले मिनी-ऐप बनाएं।
+
+## उत्पादन कोड निष्पादन {#production-code-execution}
+
+डिफ़ॉल्ट रूप से, उत्पादन एजेंट कोड-निष्पादन उपकरण के बिना चलते हैं। वे ऐप actions, डेटाबेस टूल्स, MCP टूल्स, ब्राउज़र/सेशन टूल्स और अन्य पंजीकृत फ्रेमवर्क टूल्स को कॉल कर सकते हैं, लेकिन उन्हें शेल या फ़ाइल सिस्टम एक्सेस नहीं मिलता है।
+
+नोड-संगत परिनियोजन एजेंट चैट प्लगइन या पर्यावरण ओवरराइड के माध्यम से उत्पादन कोड निष्पादन का विकल्प चुन सकते हैं:
+
+```ts
+// server/plugins/agent-chat.ts
+export default createAgentChatPlugin({
+  codeExecution: { production: "sandboxed" },
+});
+```
+
+उपलब्ध मोड हैं:
+
+- `off` - डिफ़ॉल्ट। कोई भी कोड-निष्पादन उपकरण उत्पादन में पंजीकृत नहीं है।
+- `sandboxed` - `run-code` को पंजीकृत करता है, एक पृथक Node.js JavaScript धावक, एक साफ़ वातावरण के साथ, एक ताज़ा अस्थायी निर्देशिका, आउटपुट / समय सीमा, और `provider-api-request`, `provider-api-docs`, `provider-api-catalog`, `web-request`, और प्रयुक्त संसाधन-समर्थित कार्यक्षेत्र फ़ाइल ब्रिज जैसे सूचीबद्ध पंजीकृत टूल के लिए एक लोकलहोस्ट ब्रिज। `workspaceRead` / `workspaceWrite` द्वारा.
+- `trusted` - `run-code` प्लस पूर्ण कोडिंग टूल रजिस्ट्री (`bash`, `read`, `edit`, `write`) को पंजीकृत करता है। इसका उपयोग केवल एकल-किरायेदार या ऑपरेटर-नियंत्रित तैनाती के लिए करें जहां होस्ट तक पूर्ण शेल पहुंच जानबूझकर है।
+
+कोड परिवर्तन के बिना किसी विशिष्ट परिनियोजन के लिए प्लगइन विकल्प को ओवरराइड करने के लिए `AGENT_PROD_CODE_EXECUTION=sandboxed` या `AGENT_PROD_CODE_EXECUTION=trusted` सेट करें। `AGENT_PROD_CODE_EXECUTION=off` प्लगइन विकल्प सक्षम होने पर भी कोड निष्पादन को बंद कर देता है।
+
+`run-code` सैंडबॉक्स प्रक्रिया-स्तरीय अलगाव है, ओएस कंटेनर नहीं। यह चाइल्ड प्रोसेस वातावरण से ऐप रहस्यों को हटा देता है और उपलब्ध होने पर नोड अनुमति मॉडल का उपयोग करता है, लेकिन आउटबाउंड नेटवर्क को नोड द्वारा अवरुद्ध नहीं किया जाता है; प्रमाणित कॉल को टूल द्वारा उजागर किए गए ब्रिज हेल्पर्स के माध्यम से जाना चाहिए।
+
+## उत्पादन में UI को अद्यतन करना {#updating-ui-in-production}
+
+एजेंट-नेटिव की मुख्य विशेषताओं में से एक यह है कि एजेंट आपके ऐप के स्रोत कोड - घटकों, मार्गों, शैलियों, actions को संशोधित कर सकता है। स्थानीय विकास के दौरान यह निर्बाध रूप से काम करता है क्योंकि एजेंट के पास पूर्ण फ़ाइल सिस्टम पहुंच होती है।
+
+[production code execution](#production-code-execution) को छोड़कर एक मानक उत्पादन परिनियोजन में, एजेंट के पास ऐप टूल्स (actions, डेटाबेस, MCP) तक पहुंच होती है, लेकिन फ़ाइल सिस्टम तक नहीं। इसका मतलब है कि एजेंट डेटा पढ़ और लिख सकता है, actions चला सकता है, और बाहरी सेवाओं के साथ बातचीत कर सकता है - लेकिन यह आपके React घटकों को संपादित नहीं कर सकता है या तैनात उदाहरण पर नए मार्ग नहीं जोड़ सकता है।
+
+### Builder.io: प्रोडक्शन में विजुअल एडिटिंग {#builderio}
+
+[Builder.io](https://www.builder.io) एक प्रबंधित क्लाउड वातावरण प्रदान करके इसे हल करता है जहां एजेंट उत्पादन में आपके ऐप के UI को संशोधित करने की क्षमता रखता है। अपने रेपो को Builder.io से कनेक्ट करें और सीधे UI परिवर्तनों के लिए संकेत दें - किसी पुनः तैनाती की आवश्यकता नहीं है।
+
+**यह कैसे काम करता है:**
+
+1. अपने एजेंट-मूल रेपो को Builder.io से कनेक्ट करें
+2. Builder.io एजेंट, विज़ुअल संपादन और वास्तविक समय सहयोग के साथ एक क्लाउड फ्रेम प्रदान करता है
+3. एजेंट को UI परिवर्तन करने के लिए कहें - यह आपके घटकों, मार्गों और शैलियों को लाइव संपादित करता है
+4. परिवर्तन आपके रेपो में वापस कर दिए जाते हैं
+
+एम्बेडेड एजेंट पैनल बनाम क्लाउड फ़्रेम विकल्पों पर अधिक जानकारी के लिए [Frames](/docs/frames) देखें।
+
+## मल्टी-इंस्टेंस परिनियोजन {#multi-instance}
+
+एजेंट-नेटिव ऐप्स सभी स्थिति को Drizzle के माध्यम से SQL में संग्रहीत करते हैं और UI को [polling](/docs/key-concepts#polling-sync) के माध्यम से डेटाबेस के विरुद्ध सिंक करते हैं - कोई फ़ाइल-सिस्टम स्थिति नहीं, कोई चिपचिपा सत्र नहीं, कोई इन-मेमोरी कैश नहीं। इसका मतलब है कि मल्टी-इंस्टेंस और सर्वर रहित परिनियोजन बॉक्स से बाहर काम करते हैं: प्रत्येक इंस्टेंस को एक ही `DATABASE_URL` पर इंगित करें और वे स्वचालित रूप से परिवर्तित हो जाते हैं। [Key Concepts — Data in SQL](/docs/key-concepts#data-in-sql) और [Portability](/docs/key-concepts#hosting-agnostic) देखें।

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

@@ -0,0 +1,146 @@
+---
+title: "प्रेषण"
+description: "कार्यस्थान नियंत्रण विमान: सीक्रेट वॉल्ट, इंटीग्रेशन हब, क्रॉस-ऐप प्रतिनिधि, और Slack, ईमेल, टेलीग्राम, व्हाट्सएप के लिए सेंट्रल इनबॉक्स।"
+---
+
+# प्रेषण
+
+डिस्पैच एक केंद्रीय ऐप है जो आपके कार्यक्षेत्र में हर दूसरे ऐप के सामने बैठता है और रहस्य, एकीकरण, मैसेजिंग और क्रॉस-ऐप प्रतिनिधिमंडल को संभालता है। यह **कार्यक्षेत्र नियंत्रण विमान** है - एक एजेंट जिससे आपकी टीम बात करती है, एक ही स्थान के क्रेडेंशियल लाइव होते हैं, और एक राउटर जो यह तय करता है कि किस विशेषज्ञ ऐप को किसी दिए गए अनुरोध को संभालना चाहिए।
+
+> **टेम्पलेट बनाम पैकेज `@agent-native/dispatch` डिस्पैच करें।** यह पृष्ठ डिस्पैच ऐप/टेम्पलेट अवधारणा को कवर करता है - यह क्या करता है और आप इसे क्यों चाहते हैं। `@agent-native/dispatch` npm पैकेज अलग से प्रकाशित रनटाइम है जो डिस्पैच टेम्पलेट के सर्वर लॉजिक (वॉल्ट, इंटीग्रेशन, डेस्टिनेशन, शेड्यूल्ड जॉब और क्रॉस-ऐप डेलिगेशन) को उन वर्कस्पेस के लिए ड्रॉप-इन पैकेज के रूप में बंडल करता है जो इसे विस्तारित करते हैं। स्वयं मचान ऐप (मार्ग, स्क्रीन, एजेंट गाइड) के लिए, [Dispatch template](/docs/template-dispatch) देखें।
+
+डिस्पैच के बिना, मल्टी-ऐप वर्कस्पेस में प्रत्येक ऐप एक ही प्लंबिंग को फिर से कार्यान्वित करता है: इसका अपना Slack बॉट, अपना स्वयं का गुप्त स्टोर, अपनी स्वयं की निर्धारित नौकरियां, वर्कस्पेस के निर्देशों की अपनी प्रति। एक API कुंजी को घुमाने से दस पुनर्नियोजन हो जाते हैं। एक नई नीति जोड़ने पर दस कॉपी-पेस्ट हो जाते हैं। डिस्पैच उन सभी को एक ऐप में केंद्रीकृत करता है ताकि अन्य लोग अपने डोमेन पर केंद्रित रहें।
+
+```an-diagram title="Dispatch as the workspace control plane" summary="One inbox, one vault, one MCP gateway, and shared resources sit in front of the domain apps, which Dispatch reaches as A2A peers."
+{
+  "html": "<div class=\"dsp-hub\"><div class=\"diagram-node\">Users &amp; external agents<br><small class=\"diagram-muted\">Slack · email · Telegram · WhatsApp · MCP</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-panel dsp-control\" data-rough><span class=\"diagram-pill accent\">Dispatch &mdash; control plane</span><div class=\"dsp-caps\"><span class=\"diagram-pill\">Central inbox</span><span class=\"diagram-pill\">Secret vault</span><span class=\"diagram-pill\">Cross-app delegation</span><span class=\"diagram-pill\">MCP gateway</span><span class=\"diagram-pill\">Workspace resources</span></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"dsp-peers\"><div class=\"diagram-box\" data-rough>Mail</div><div class=\"diagram-box\" data-rough>Calendar</div><div class=\"diagram-box\" data-rough>Analytics</div></div><small class=\"diagram-muted\">domain apps &mdash; A2A peers</small></div>",
+  "css": ".dsp-hub{display:flex;flex-direction:column;align-items:center;gap:10px}.dsp-hub .dsp-control{display:flex;flex-direction:column;align-items:center;gap:10px;width:100%}.dsp-hub .dsp-caps{display:flex;gap:8px;flex-wrap:wrap;justify-content:center}.dsp-hub .dsp-peers{display:flex;gap:10px;flex-wrap:wrap;justify-content:center}"
+}
+```
+
+## जब आप प्रेषण चाहते हैं {#when}
+
+इनमें से कोई भी सत्य होने पर प्रेषण के लिए पहुंचें:
+
+- आप एक [multi-app workspace](/docs/multi-app-workspace) चला रहे हैं - मेल, कैलेंडर, विश्लेषण, सामग्री - और आप प्रति ऐप एक Slack बॉट नहीं चाहते हैं।
+- आप "एजेंट" के लिए **एक इनबॉक्स चाहते हैं** ताकि उपयोगकर्ता एक ही बॉट को डीएम कर सकें और सही विशेषज्ञ ऐप पर्दे के पीछे का काम कर सके।
+- आपके पास **कार्यक्षेत्र-व्यापी रहस्य** (स्ट्राइप कुंजी, OpenAI कुंजी, तृतीय-पक्ष API टोकन) हैं जिनकी कई ऐप्स को आवश्यकता है और आप प्रत्येक `.env` में मानों की प्रतिलिपि बनाने के बजाय एक वॉल्ट चाहते हैं।
+- आप संवेदनशील परिवर्तनों (सहेजे गए गंतव्य, नीति संपादन) के सामने **रनटाइम अनुमोदन प्रवाह** चाहते हैं ताकि गैर-व्यवस्थापक अनुरोध कर सकें और व्यवस्थापक बिना कोड परिनियोजन के साइन ऑफ कर सकें।
+- आप चाहते हैं **साझा skills, निर्देश, एजेंट प्रोफाइल और MCP सर्वर** जो कार्यक्षेत्र में ऐप्स को विरासत में मिले - एक बार बदलें, सभी तक पहुंचें।
+
+यदि आप एकल टेम्प्लेट स्टैंडअलोन चला रहे हैं, तो आपको डिस्पैच की आवश्यकता नहीं है - प्रत्येक टेम्प्लेट सीधे अपने स्वयं के मैसेजिंग एकीकरण को तार कर सकता है। स्टैंडअलोन सेटअप के लिए [Messaging](/docs/messaging) देखें।
+
+## डिस्पैच क्या करता है {#what-it-does}
+
+सात क्षमताएं, सभी समान कार्यक्षेत्र डेटाबेस के शीर्ष पर स्थित हैं जिसका उपयोग अन्य ऐप्स करते हैं:
+
+| क्षमता                | यह आपको क्या देता है                                                                        | इसे सेट करें                                               |
+| --------------------- | ------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
+| **सेंट्रल इनबॉक्स**   | Slack, ईमेल, टेलीग्राम, व्हाट्सएप सभी साझा मेमोरी + टूल के साथ एक एजेंट तक पहुंचते हैं      | **सेटिंग्स → मैसेजिंग** ([Messaging](/docs/messaging))     |
+| **गुप्त तिजोरी**      | प्रत्येक क्रेडेंशियल को एक बार संग्रहीत करें; प्रत्येक ऐप पर एक ही स्थान पर घुमाएँ          | **वॉल्ट** + एक्सेस मोड (सभी-ऐप्स या मैनुअल)                |
+| **क्रॉस-ऐप डेलिगेशन** | A2A पर सही विशेषज्ञ ऐप के लिए अनुरोध रूट करता है और थ्रेड में उत्तर देता है                 | स्वचालित ([A2A](/docs/a2a-protocol))                       |
+| **एकीकृत MCP गेटवे**  | बाहरी एजेंटों के लिए एक MCP कनेक्टर प्रत्येक स्वीकृत कार्यक्षेत्र ऐप तक पहुंचता है          | [External Agents](/docs/external-agents)                   |
+| **कार्यस्थान संसाधन** | लेखक skills/निर्देश/प्रोफ़ाइल एक बार; ऐप्स उन्हें रनटाइम पर इनहेरिट करते हैं                | **संसाधन** ([Workspace](/docs/workspace#global-resources)) |
+| **सपने**              | पिछले रन/फीडबैक की समीक्षा करता है और आपके अनुमोदन के लिए टिकाऊ सुधारों का प्रस्ताव करता है | **सपने** टैब                                               |
+| **अनुमोदन प्रवाह**    | इनलाइन व्यवस्थापक समीक्षा के पीछे गेट संवेदनशील रनटाइम परिवर्तन                             | **प्रेषण अनुमोदन नीति**                                    |
+
+प्रत्येक का विवरण नीचे दिया गया है।
+
+### सेंट्रल इनबॉक्स
+
+Slack, ईमेल, टेलीग्राम और व्हाट्सएप सभी डिस्पैच के एजेंट लूप में प्रवाहित होते हैं। प्रत्येक प्लेटफ़ॉर्म को **सेटिंग्स → मैसेजिंग** में एक बार कनेक्ट करें और प्रत्येक चैनल समान मेमोरी और टूल के साथ एक ही एजेंट तक पहुंच जाता है। एक Slack DM और `agent@yourcompany.com` को एक ईमेल एक वार्तालाप इतिहास पर दो सतहों के रूप में समाप्त होते हैं, न कि दो डिस्कनेक्ट किए गए बॉट के रूप में। क्रेडेंशियल्स और वेबहुक URLs के लिए [Messaging](/docs/messaging) देखें।
+
+### गुप्त तिजोरी
+
+डिस्पैच के वॉल्ट में एक बार क्रेडेंशियल संग्रहीत करें। डिफ़ॉल्ट रूप से, वॉल्ट एक्सेस **सभी ऐप्स** है: प्रत्येक सहेजी गई कुंजी प्रत्येक वर्कस्पेस ऐप के लिए उपलब्ध है, और `sync-vault-to-app` पूरे वॉल्ट को लक्ष्य ऐप पर भेजता है। जिन कार्यस्थानों को सख्त पृथक्करण की आवश्यकता है, वे वॉल्ट को **मैन्युअल** मोड में स्विच कर सकते हैं, जहां सिंक से पहले स्पष्ट प्रति-ऐप अनुदान की आवश्यकता होती है। गैर-व्यवस्थापक किसी ऐप के लिए एक रहस्य का **अनुरोध** कर सकते हैं; व्यवस्थापक **अनुमोदन** करते हैं, जो रहस्य बनाता है और, मैन्युअल वर्कफ़्लो में, अनुदान देता है। प्रत्येक रीड, अनुदान, सिंक और रोटेशन को ऑडिट लॉग में कैप्चर किया जाता है। यही वह चीज़ है जो "OpenAI कुंजी को घुमाएं" को दस पीआर के बजाय दस ऐप्स पर एक-क्लिक ऑपरेशन बनाती है।
+
+### क्रॉस-ऐप डेलिगेशन
+
+डिस्पैच आपके कार्यक्षेत्र में A2A साथियों के रूप में अन्य ऐप्स को स्वतः खोजता है - कोई मैन्युअल पंजीकरण नहीं, कोई प्रति-ऐप कॉन्फ़िगरेशन नहीं। जब कोई उपयोगकर्ता Slack में "पिछले सप्ताह के साइनअप को सारांशित करें" पूछता है, तो डिस्पैच इसे एक एनालिटिक्स अनुरोध के रूप में पहचानता है और [A2A](/docs/a2a-protocol) पर एनालिटिक्स ऐप को कॉल करता है। जब वे "ऐलिस को उत्तर का मसौदा तैयार करने" के लिए कहते हैं, तो यह मेल ऐप पर चला जाता है। डिस्पैच अंतिम उत्तर को मूल थ्रेड में वापस पोस्ट करता है। व्यवहार नियम प्रेषण एजेंट के निर्देशों में रहता है: डोमेन कार्य डोमेन ऐप से संबंधित है। डिस्पैच ऑर्केस्ट्रेटर है, विशेषज्ञ नहीं।
+
+### एकीकृत MCP गेटवे
+
+डिस्पैच बाहरी एजेंटों के लिए एकल MCP कनेक्टर हो सकता है: Claude, ChatGPT, Codex, या कर्सर में एक बार `https://dispatch.agent-native.com/_agent-native/mcp` जोड़ें, और प्रति ऐप एक कनेक्टर के बजाय एक प्राधिकरण प्रत्येक स्वीकृत कार्यक्षेत्र ऐप तक पहुंचता है। संपूर्ण कनेक्ट फ़्लो, ऐप अनुदान, OAuth और इनलाइन MCP ऐप पूर्वावलोकन के लिए [External Agents](/docs/external-agents) देखें।
+
+```an-api
+{
+  "method": "POST",
+  "path": "/_agent-native/mcp",
+  "summary": "Unified MCP gateway endpoint",
+  "description": "The single MCP connector URL external agents add (e.g. `https://dispatch.agent-native.com/_agent-native/mcp`). One authorization here reaches every **granted** workspace app instead of wiring one connector per app. App grants, OAuth, and inline MCP App previews are covered in [External Agents](/docs/external-agents).",
+  "auth": "Standard remote MCP OAuth, handled by the framework. The granted-app set scopes which workspace apps the connector can reach.",
+  "responses": [
+    { "status": "200", "description": "MCP JSON-RPC response — tools, resources, and MCP App UI resources aggregated across granted workspace apps." }
+  ]
+}
+```
+
+### कार्यस्थान संसाधन
+
+Skills, रेलिंग निर्देश, एजेंट प्रोफाइल और संदर्भ संसाधन डिस्पैच में एक बार लिखे जा सकते हैं और बाकी कार्यक्षेत्र द्वारा विरासत में प्राप्त किए जा सकते हैं। **सभी ऐप्स** दायरे वाले संसाधन वैश्विक हैं: डिस्पैच उन्हें कार्यक्षेत्र के दायरे में एक बार संग्रहीत करता है, और प्रत्येक ऐप एजेंट उन्हें रनटाइम पर पढ़ता है। उन्हें प्रत्येक ऐप में कॉपी नहीं किया जाता है, और कोई मैन्युअल वर्कस्पेस-संसाधन सिंक चरण नहीं है। ऐप साझा संसाधन और व्यक्तिगत संसाधन स्थानीय रूप से कार्यक्षेत्र डिफ़ॉल्ट को ओवरराइड या संकीर्ण कर सकते हैं।
+
+कैनोनिकल पथ तालिका, स्टार्टर पैक और ओवरराइड मॉडल के लिए [Workspace — Global resources](/docs/workspace#global-resources) देखें।
+
+MCP सर्वर संसाधन JSON का उपयोग करते हैं और जानबूझकर केवल HTTP हैं। टोकन को
+वॉल्ट भेजें, उन कुंजियों को लक्ष्य ऐप्स को प्रदान करें या सिंक करें, और उनका संदर्भ लें
+`${keys.NAME}` वाले हेडर से ताकि कच्चा क्रेडेंशियल कभी भी इसमें न रहे
+संसाधन निकाय.
+
+**संसाधन** पृष्ठ अनुशंसित स्टार्टर पैक पर प्रकाश डालता है ताकि व्यवस्थापक तुरंत देख सकें कि कौन सी फ़ाइलें मौजूद हैं, मौजूदा फ़ाइलों को अधिलेखित किए बिना लापता स्टार्टर फ़ाइलों को पुनर्स्थापित करें, और उनकी सामग्री को संपादित करें। किसी चयनित ऐप/उपयोगकर्ता के लिए उसके प्रभावी रनटाइम स्टैक का पूर्वावलोकन करने के लिए किसी भी संसाधन का विस्तार करें। प्रत्येक ऐप कार्ड में एक **संदर्भ** दृश्य भी होता है जो दिखाता है कि उस ऐप को वास्तव में क्या प्राप्त होता है।
+
+### सपने
+
+डिस्पैच ड्रीम्स पूर्व एजेंट रन, फीडबैक, मूल्यांकन और टिकाऊ सुधारों का प्रस्ताव देने में बार-बार विफलताओं की समीक्षा करता है। एक स्वप्न रिपोर्ट एक समीक्षा सतह है, न कि एक मूक पुनर्लेखन: यह व्यक्तिगत मेमोरी अपडेट, बासी-मेमोरी क्लीनअप, साझा `LEARNINGS.md` संपादन, कार्यक्षेत्र निर्देश/कौशल/ज्ञान/एजेंट संसाधन, या आवर्ती नौकरियों का सुझाव दे सकता है, और प्रत्येक प्रस्ताव उन रनों से लिंक करता है जो इसे उचित ठहराते हैं। साझा निर्देशों और टीम-व्यापी संसाधनों को लागू करने से पहले समीक्षा की आवश्यकता होती है, खासकर जब सबूत इनबाउंड Slack, ईमेल, टेलीग्राम, व्हाट्सएप या वेब सामग्री से आए हों।
+
+लिखने का प्रस्ताव देने से पहले, ड्रीम्स व्यक्तिगत मेमोरी इंडेक्स, मौजूदा `memory/*.md` नोट्स और साझा किए गए `LEARNINGS.md` के विरुद्ध साक्ष्य की तुलना करते हैं। यदि कोई पाठ पहले ही पकड़ लिया गया है, तो रिपोर्ट में दर्ज किया गया है कि इसे छोड़ दिया गया था; यदि कोई संबंधित व्यक्तिगत मेमोरी पुरानी दिखती है, तो प्रस्ताव डुप्लिकेट बनाने के बजाय उस मौजूदा नोट को लक्षित करता है।
+
+डिस्पैच में **सपने** टैब से प्रारंभ करें। पहले एक मैन्युअल पास चलाएँ, प्रस्तावित सामग्री और स्रोत साक्ष्य के साथ वर्तमान लक्ष्य की तुलना करने के लिए एक प्रस्ताव समीक्षा शीट खोलें, फिर केवल वे परिवर्तन लागू करें जिन्हें आप रखना चाहते हैं। एक बार जब रिपोर्टें लगातार उपयोगी हो जाती हैं, तो डिस्पैच एक आवर्ती ड्रीम जॉब बना सकता है जो साझा या निर्देश-स्तरीय परिवर्तनों को स्वचालित रूप से लागू किए बिना प्रस्ताव तैयार करता रहता है।
+
+### अनुमोदन प्रवाह
+
+डिस्पैच व्यवस्थापक समीक्षा के पीछे संवेदनशील रनटाइम परिवर्तनों को गेट कर सकता है। आज इसमें **सहेजे गए गंतव्य** (Slack चैनल और ईमेल पते जिन्हें एजेंट सक्रिय रूप से भेज सकता है), साझा/टीम **स्वप्न प्रस्ताव**, ऑल-ऐप **वर्कस्पेस संसाधन** बनाता/अपडेट/हटाता है, और **प्रेषण अनुमोदन नीति** शामिल है। जब नीति सक्षम हो जाती है, तो परिवर्तन कतारबद्ध हो जाता है और एजेंट सीधे चैट में एक इनलाइन अनुमोदन पूर्वावलोकन पेश करता है - व्यवस्थापक बातचीत को छोड़े बिना स्वीकृत या अस्वीकार करते हैं।
+
+## एक Slack संदेश डिस्पैच के माध्यम से कैसे प्रवाहित होता है {#flow}
+
+एक उदाहरण को शुरू से अंत तक पढ़ें। एक उपयोगकर्ता बॉट को डीएम करता है: _"पिछले सप्ताह के साइनअप को सारांशित करें।"_
+
+1. **Slack → वेबहुक।** डिस्पैच ऐप पर Slack `POST`s से `/_agent-native/integrations/slack/webhook`। हैंडलर हस्ताक्षर को सत्यापित करता है और **`integration_pending_tasks`** में एक पंक्ति डालता है, फिर एक स्व-लक्षित `POST` को अपने स्वयं के प्रोसेसर पर सक्रिय करता है और तुरंत `200` लौटाता है ताकि Slack पुनः प्रयास न करे।
+2. **ताजा प्रोसेसर निष्पादन।** प्रोसेसर एंडपॉइंट अपने स्वयं के पूर्ण टाइमआउट के साथ बिल्कुल नए फ़ंक्शन निष्पादन में चलता है। यह परमाणु रूप से कार्य का दावा करता है और एजेंट लूप शुरू करता है।
+3. **डिस्पैच एजेंट निर्णय लेता है।** एजेंट संदेश पढ़ता है, "साइनअप" को एक एनालिटिक्स इरादे के रूप में पहचानता है, और एनालिटिक्स ऐप के [A2A endpoint](/docs/a2a-protocol) के खिलाफ `call-agent` को आमंत्रित करता है। वास्तविक SQL कार्य वहां चलता है।
+4. **उत्तर थ्रेड में पोस्ट किया गया।** एनालिटिक्स एजेंट एक परिणाम देता है। डिस्पैच इसे प्रारूपित करता है और उसी Slack थ्रेड में वापस पोस्ट करता है जिसमें उपयोगकर्ता ने लिंक की गई पहचान का उपयोग करके लिखा है (इसलिए एजेंट अनुरोधकर्ता की अनुमतियों के साथ कार्य करता है, न कि कार्यस्थल स्वामी की)।
+5. **यदि कुछ भी नष्ट हो जाता है तो पुनर्प्राप्ति।** यदि प्रोसेसर मध्य-उड़ान में क्रैश हो जाता है - A2A टाइमआउट, डाउनस्ट्रीम एजेंट त्रुटि, फ़ंक्शन फ़्रीज़ - एक पुनः प्रयास कार्य हर 60 सेकंड में अटके हुए कार्यों को साफ़ करता है और प्रोसेसर को फिर से सक्रिय करता है। कार्य को `failed` चिह्नित करने से पहले तीन प्रयासों तक।
+
+```an-diagram title="A Slack message through Dispatch" summary="Slack enqueues into SQL, a fresh execution drains it, the Dispatch agent delegates the domain work over A2A, and the reply lands back in the originating thread. A 60s retry job recovers anything that dies mid-flight."
+{
+  "html": "<div class=\"dsp-flow\"><div class=\"dsp-row\"><div class=\"diagram-node\">Slack DM<br><small class=\"diagram-muted\">\"summarize last week's signups\"</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\" data-rough><strong>/slack/webhook</strong><br><small class=\"diagram-muted\">verify + INSERT pending task</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill ok\">200</div></div><div class=\"dsp-row\"><div class=\"diagram-box\" data-rough><strong>fresh processor</strong><br><small class=\"diagram-muted\">claim task · start agent loop</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\">Dispatch agent decides</span><small class=\"diagram-muted\">analytics intent &rarr; call-agent</small></div></div><div class=\"dsp-row\"><div class=\"diagram-box\" data-rough>Analytics app<br><small class=\"diagram-muted\">A2A peer · runs the SQL work</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-pill ok\">reply posted in thread</div></div><div class=\"diagram-panel dsp-retry\" data-rough><span class=\"diagram-pill warn\">recovery</span> <span class=\"diagram-muted\">if the processor crashes &mdash; A2A timeout, downstream error, freeze &mdash; the 60s retry job re-fires it (&le;3 attempts) so the Slack reply still arrives</span> <span class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&#8635;</span></div></div>",
+  "css": ".dsp-flow{display:flex;flex-direction:column;gap:12px}.dsp-flow .dsp-row{display:flex;align-items:center;gap:10px;flex-wrap:wrap}.dsp-flow .center{display:flex;flex-direction:column;align-items:center;gap:4px}.dsp-flow .dsp-retry{display:flex;align-items:center;gap:8px;flex-wrap:wrap}"
+}
+```
+
+ईमेल, टेलीग्राम और व्हाट्सएप के लिए भी यही प्रवाह लागू होता है - केवल एडॉप्टर बदलता है।
+
+## विश्वसनीयता की कहानी {#reliability}
+
+प्लेटफ़ॉर्म-विशिष्ट पृष्ठभूमि-निष्पादन APIs पर निर्भर किए बिना पूरी पाइपलाइन प्रत्येक सर्वर रहित होस्ट (नेटलिफाई, वर्सेल, क्लाउडफ्लेयर वर्कर्स) पर जीवित रहने के लिए बनाई गई है।
+
+- **वेबहुक → SQL कतार → ताज़ा-निष्पादन प्रोसेसर।** एजेंट लूप कभी भी वेबहुक हैंडलर के अंदर नहीं चलता है। हैंडलर का एकमात्र काम सत्यापित करना, कतारबद्ध करना और 200 लौटाना है। एक अलग ताजा निष्पादन कतार को खत्म कर देता है, इसलिए धीमी गति से चलने वाला एजेंट कभी भी इनबाउंड वेबहुक को बांध नहीं सकता है या प्लेटफ़ॉर्म को पुनः प्रयास करने का कारण नहीं बन सकता है।
+- **A2A निरंतरता मतदान।** जब डिस्पैच किसी अन्य ऐप को सौंपता है, तो यह एक सीमित टाइमआउट के साथ डाउनस्ट्रीम कार्य को मतदान करता है। यदि डाउनस्ट्रीम एजेंट बहुत अधिक समय लेता है या क्रैश हो जाता है, तो डिस्पैच निरंतरता को रिकॉर्ड करता है और पुनः प्रयास कार्य इसे उठाता है - उपयोगकर्ता का Slack उत्तर अभी भी आता है।
+- **ऑटो-हस्ताक्षरित क्रॉस-ऐप A2A।** होस्ट किए गए मल्टी-ऐप वर्कस्पेस तैनाती के समय प्रति-ऐप A2A क्रेडेंशियल्स को स्वचालित रूप से जेनरेट करते हैं, इसलिए एक ही वर्कस्पेस में ऐप्स आपके द्वारा कभी भी JWT सीक्रेट चिपकाए बिना एक-दूसरे को कॉल कर सकते हैं। डिस्पैच की एजेंट-डिस्कवरी परत वर्कस्पेस डेटाबेस से उन क्रेडिट्स को पढ़ती है ताकि नए जोड़े गए ऐप्स स्वचालित रूप से कॉल करने योग्य साथियों के रूप में दिखाई दें।
+
+## सेटअप {#setup}
+
+तीन छोटे चरण:
+
+1. **एक कार्यक्षेत्र बनाएं जिसमें डिस्पैच शामिल हो।** `npx @agent-native/core@latest create my-company-platform` चलाएं और जो भी डोमेन टेम्पलेट आप चाहते हैं उसके साथ `dispatch` चुनें। डिस्पैच `apps/dispatch` पर रहता है और बाकी ऐप्स इसके पास बैठते हैं। [Multi-App Workspace](/docs/multi-app-workspace) देखें.
+2. **मैसेजिंग कनेक्ट करें।** डिस्पैच में **सेटिंग्स → मैसेजिंग** खोलें और Slack, ईमेल, टेलीग्राम या व्हाट्सएप के लिए कनेक्ट पर क्लिक करें। प्रपत्र फ़ील्ड [Messaging](/docs/messaging) दस्तावेज़ में env vars से मेल खाते हैं - प्रत्येक प्लेटफ़ॉर्म की आवश्यकता के लिए वहां देखें।
+3. **अन्य ऐप्स जोड़ें।** प्रत्येक डोमेन ऐप के लिए कार्यक्षेत्र रूट से `npx @agent-native/core@latest add-app` चलाएँ। वे डिस्पैच के `list-workspace-apps` में A2A साथियों के रूप में स्वतः दिखाई देते हैं - कोई मैन्युअल पंजीकरण नहीं, कोई एजेंट-कार्ड संपादन नहीं। जैसे ही उनके एजेंट कार्ड उपलब्ध होंगे, डिस्पैच उन्हें सौंपना शुरू कर दिया जाएगा।
+
+फिर वॉल्ट में क्रेडेंशियल जोड़ें और (वैकल्पिक रूप से) **संसाधन** के अंतर्गत वैश्विक कार्यक्षेत्र संसाधनों को लिखें। एक्सेस मोड के आधार पर वॉल्ट कुंजियाँ अभी भी सिंक या दी जा सकती हैं; सभी-ऐप कार्यक्षेत्र संसाधन स्वचालित रूप से इनहेरिट हो जाते हैं। यदि आपको प्रति-ऐप गुप्त अलगाव की आवश्यकता है, तो अलग-अलग ऐप्स को अनुमति देने से पहले वॉल्ट एक्सेस सेटिंग को मैन्युअल पर स्विच करें।
+
+## यह भी देखें {#see-also}
+
+- [Dispatch template](/docs/template-dispatch) - वास्तविक मचान वाला ऐप, इसकी पूरी कार्रवाई सूची और एजेंट गाइड के साथ
+- [Messaging](/docs/messaging) - Slack, ईमेल, टेलीग्राम, व्हाट्सएप को कनेक्ट करना
+- [A2A Protocol](/docs/a2a-protocol) - हुड के तहत क्रॉस-ऐप डेलिगेशन कैसे काम करता है
+- [Multi-App Workspace](/docs/multi-app-workspace) - परिनियोजन आकार डिस्पैच
+- [Workspace Governance](/docs/workspace-management) - git/GitHub गवर्नेंस जो डिस्पैच के रनटाइम गवर्नेंस के साथ जुड़ता है