@agent-native/core 0.76.5 → 0.76.6

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

@@ -0,0 +1,236 @@
+---
+title: "ट्रैकिंग और एनालिटिक्स"
+description: "प्लग करने योग्य प्रदाताओं के साथ सर्वर-साइड एनालिटिक्स - पोस्टहॉग, मिक्सपैनल, एम्प्लिट्यूड, या कस्टम वेबहुक"
+---
+
+# एनालिटिक्स ट्रैकिंग
+
+एक फ़ंक्शन, एकाधिक गंतव्य। किसी भी सर्वर-साइड कोड से `track()` पर कॉल करें - actions, प्लगइन्स, सर्वर रूट - और प्रत्येक पंजीकृत एनालिटिक्स प्रदाता के लिए ईवेंट प्रशंसक। कोई SDK निर्भरता नहीं, कोई क्लाइंट-साइड स्क्रिप्ट नहीं, कोई अवरोधन नहीं। वही `track()` [browser/app code](#client) में भी उपलब्ध है और समान प्रदाताओं के लिए रूट है।
+
+यह _उत्पाद_ एनालिटिक्स है - आपके ऐप के इवेंट पोस्टहॉग/मिक्सपैनल/एम्प्लीट्यूड पर प्रवाहित हो रहे हैं। आपके अपने डेटाबेस में संग्रहीत _एजेंट गुणवत्ता_ मेट्रिक्स (निशान, लागत, मूल्यांकन, फीडबैक) के लिए, [Observability](/docs/observability) देखें।
+
+```ts
+import { track } from "@agent-native/core/tracking";
+
+track(
+  "order.completed",
+  { total: 49.99, items: 3 },
+  { userId: "steve@builder.io" },
+);
+```
+
+```an-diagram title="One track() call, every provider" summary="Server and client callers hit the same registry, which fans every event out to all active providers in parallel."
+{
+  "html": "<div class=\"trk\"><div class=\"diagram-col\"><div class=\"diagram-node\">Server code<br><small class=\"diagram-muted\">actions &middot; plugins &middot; routes</small></div><div class=\"diagram-node\">Browser code<br><small class=\"diagram-muted\">POST /_agent-native/track</small></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">Provider registry</span><small class=\"diagram-muted\">fan-out, fire-and-forget</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col\"><div class=\"diagram-box\">PostHog</div><div class=\"diagram-box\">Mixpanel</div><div class=\"diagram-box\">Amplitude</div><div class=\"diagram-box\">Webhook</div></div></div>",
+  "css": ".trk{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.trk .diagram-col{display:flex;flex-direction:column;gap:8px}.trk .diagram-arrow{font-size:22px;line-height:1}.trk .center{display:flex;flex-direction:column;align-items:center;gap:4px}"
+}
+```
+
+## अंतर्निहित प्रदाता {#built-in}
+
+एक env var सेट करें और प्रदाता सर्वर स्टार्टअप पर ऑटो-रजिस्टर करें। किसी कोड परिवर्तन की आवश्यकता नहीं है.
+
+| प्रदाता   | पर्यावरण संस्करण                                                                           |
+| --------- | ------------------------------------------------------------------------------------------ |
+| पोस्टहॉग  | `POSTHOG_API_KEY` (आवश्यक), `POSTHOG_HOST` (वैकल्पिक, डिफ़ॉल्ट `https://us.i.posthog.com`) |
+| मिक्सपैनल | `MIXPANEL_TOKEN`                                                                           |
+| आयाम      | `AMPLITUDE_API_KEY`                                                                        |
+| वेबहुक    | `TRACKING_WEBHOOK_URL` (आवश्यक), `TRACKING_WEBHOOK_AUTH` (वैकल्पिक `Authorization` हेडर)   |
+
+एकाधिक प्रदाता एक साथ सक्रिय हो सकते हैं। प्रत्येक घटना उन सभी को जाती है।
+
+## API {#api}
+
+### `track(name, properties?, meta?)` {#track}
+
+एक एनालिटिक्स इवेंट सक्रिय करें। सभी पंजीकृत प्रदाताओं के प्रशंसक।
+
+```ts
+import { track } from "@agent-native/core/tracking";
+
+track(
+  "meal.logged",
+  { mealName: "Salad", calories: 350 },
+  { userId: "steve@builder.io" },
+);
+```
+
+### `identify(userId, traits?)` {#identify}
+
+किसी उपयोगकर्ता को उसके गुणों से पहचानें. उन प्रदाताओं को अग्रेषित किया जाता है जो इसका समर्थन करते हैं (पोस्टहॉग, मिक्सपैनल, एम्प्लिट्यूड, वेबहुक)।
+
+```ts
+import { identify } from "@agent-native/core/tracking";
+
+identify("steve@builder.io", { plan: "pro", company: "Builder.io" });
+```
+
+कस्टम बैकएंड, प्रदाता-रजिस्ट्री API, या बैचिंग/सिंगलटन इंटरनल्स की आवश्यकता है? अंत में [Advanced: custom providers & internals](#advanced) देखें।
+
+## टेम्प्लेट में ट्रैक() का उपयोग करना {#templates}
+
+उपयोगकर्ता या एजेंट गतिविधि को रिकॉर्ड करने के लिए एक्शन हैंडलर से `track()` पर कॉल करें:
+
+```ts
+// actions/create-project.ts
+import { defineAction } from "@agent-native/core/action";
+import { track } from "@agent-native/core/tracking";
+import { z } from "zod";
+
+export default defineAction({
+  description: "Create a new project.",
+  schema: z.object({
+    name: z.string(),
+    template: z.string().optional(),
+  }),
+  run: async ({ name, template }, ctx) => {
+    const project = await db
+      .insert(projects)
+      .values({ name, template })
+      .returning();
+
+    track("project.created", { name, template }, { userId: ctx.userEmail });
+
+    return { ok: true, projectId: project[0].id };
+  },
+});
+```
+
+ट्रैक कॉल आग लगाओ और भूल जाओ - वे तुरंत वापस आते हैं और कभी भी कार्रवाई प्रतिक्रिया को अवरुद्ध नहीं करते हैं।
+
+## क्लाइंट-साइड ट्रैकिंग {#client}
+
+`track()` ब्राउज़र/ऐप कोड से भी काम करता है। क्लाइंट ट्विन को `@agent-native/core/client` से आयात करें और इसे उसी तरह से कॉल करें - यह ईवेंट को `POST /_agent-native/track` पर फ्रेमवर्क रूट पर पोस्ट करता है, जो इसे **समान** पंजीकृत सर्वर-साइड प्रदाताओं (पोस्टहॉग, मिक्सपैनल, एम्प्लिट्यूड, वेबहुक) को अग्रेषित करता है। कोई भी एनालिटिक्स SDK ब्राउज़र पर नहीं भेजा जाता है और कोई भी प्रदाता कुंजी क्लाइंट-साइड पर प्रदर्शित नहीं होती है।
+
+```an-api title="The client tracking route"
+{
+  "method": "POST",
+  "path": "/_agent-native/track",
+  "summary": "Forward a browser event to the registered server-side providers",
+  "auth": "Session required + same-origin/CSRF marker (set automatically by the client helper). Not an open analytics relay.",
+  "params": [
+    { "name": "name", "in": "body", "type": "string", "required": true, "description": "Event name. Capped at 200 characters." },
+    { "name": "properties", "in": "body", "type": "object", "description": "Event properties (~16KB cap). `source: \"client\"` and the active `org_id` are added server-side." }
+  ],
+  "description": "Identity is resolved **server-side** from the session — browser code never passes a `userId`. Fire-and-forget: never blocks the UI, never throws, swallows network errors. Oversized or malformed payloads are rejected."
+}
+```
+
+```ts
+import { track } from "@agent-native/core/client";
+
+// e.g. inside a click handler or effect
+track("checkout.completed", { total: 49.99, items: 3 });
+```
+
+[server `track()`](#track) से मुख्य अंतर:
+
+- **कोई पहचान तर्क नहीं।** ईवेंट को सर्वर-साइड पर साइन-इन उपयोगकर्ता (और सक्रिय संगठन, `properties` में `org_id` के रूप में) के लिए जिम्मेदार ठहराया गया है। ब्राउज़र कोड कभी भी `userId` पास नहीं करता.
+- **`source: "client"`** को प्रत्येक ईवेंट के गुणों में जोड़ा जाता है ताकि आप क्लाइंट-उत्पन्न ईवेंट को सर्वर से अलग बता सकें।
+- **फ़ायर-एंड-फ़ॉरगेट।** यह कभी भी UI को ब्लॉक नहीं करता, कभी फेंकता नहीं और नेटवर्क त्रुटियों को निगल जाता है।
+- **प्रमाणित, केवल प्रथम-पक्ष।** रूट के लिए एक सत्र और एक समान-मूल/CSRF मार्कर (सहायक द्वारा स्वचालित रूप से सेट) की आवश्यकता होती है, इसलिए इसे एक ओपन एनालिटिक्स रिले के रूप में उपयोग नहीं किया जा सकता है। `name` की सीमा 200 अक्षर और `properties` की अधिकतम सीमा ~16KB है; अधिक आकार वाले या विकृत पेलोड अस्वीकार कर दिए जाते हैं।
+
+यह फ्रेमवर्क के आंतरिक ब्राउज़र टेलीमेट्री (`trackEvent()` / स्वचालित पेजव्यू - नीचे [Browser defaults](#browser-defaults) देखें) से अलग है, जो Agent Native के स्वयं के उत्पाद विश्लेषण को शक्ति प्रदान करता है। अपने ऐप के स्वयं के एनालिटिक्स इवेंट के लिए `track()` का उपयोग करें जो आपके कॉन्फ़िगर किए गए प्रदाताओं तक पहुंचना चाहिए।
+
+## उन्नत: कस्टम प्रदाता और आंतरिक {#advanced}
+
+अधिकांश ऐप्स को केवल `track()` / `identify()` और एक अंतर्निहित प्रदाता की आवश्यकता होती है। शेष सतह - कस्टम प्रदाताओं का पंजीकरण, `TrackingProvider` इंटरफ़ेस, बैचिंग आंतरिक, और फ्रेमवर्क का अपना ब्राउज़र टेलीमेट्री - नीचे है।
+
+<details>
+<summary><strong>प्रदाता-रजिस्ट्री API, इंटरफ़ेस, आंतरिक और ब्राउज़र डिफ़ॉल्ट</strong></summary>
+
+### `registerTrackingProvider(provider)` {#register}
+
+किसी भी एनालिटिक्स बैकएंड के लिए एक कस्टम प्रदाता पंजीकृत करें।
+
+```ts
+import { registerTrackingProvider } from "@agent-native/core/tracking";
+
+registerTrackingProvider({
+  name: "my-analytics",
+  track(event) {
+    // Send event to your backend
+    fetch("https://analytics.example.com/events", {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(event),
+    }).catch(() => {});
+  },
+  identify(userId, traits) {
+    // Optional — link user identity to future events
+  },
+  flush() {
+    // Optional — called on graceful shutdown
+  },
+});
+```
+
+### `flushTracking()` {#flush}
+
+सभी प्रदाताओं को फ्लश करें. लंबित घटनाओं को भेजने को सुनिश्चित करने के लिए प्रक्रिया से बाहर निकलने से पहले कॉल करें।
+
+```ts
+import { flushTracking } from "@agent-native/core/tracking";
+
+await flushTracking();
+```
+
+### `unregisterTrackingProvider(name)` {#unregister}
+
+किसी प्रदाता को नाम से हटाएं। यदि प्रदाता मिल गया और हटा दिया गया तो `true` लौटाता है।
+
+### `listTrackingProviders()` {#list}
+
+सभी पंजीकृत प्रदाताओं के नाम लौटाता है।
+
+### ट्रैकिंगप्रदाता इंटरफ़ेस {#provider-interface}
+
+```ts
+interface TrackingProvider {
+  name: string;
+  track(event: TrackingEvent): void | Promise<void>;
+  identify?(
+    userId: string,
+    traits?: Record<string, unknown>,
+  ): void | Promise<void>;
+  flush?(): void | Promise<void>;
+}
+
+interface TrackingEvent {
+  name: string;
+  properties?: Record<string, unknown>;
+  timestamp?: string;
+  userId?: string;
+}
+```
+
+केवल `name` और `track` आवश्यक हैं। `identify` और `flush` वैकल्पिक हैं - यदि आपका बैकएंड उपयोगकर्ता पहचान और बैच डिलीवरी का समर्थन करता है तो उन्हें लागू करें।
+
+### यह कैसे काम करता है {#internals}
+
+- **बैच HTTP** - अंतर्निहित प्रदाता घटनाओं को सूचीबद्ध करते हैं और हर 10 सेकंड में या जब 50 घटनाएं जमा हो जाती हैं, जो भी पहले हो, फ्लश करते हैं। यह डेटा खोए बिना आउटबाउंड अनुरोधों को न्यूनतम करता है।
+- **कोई SDK निर्भरता नहीं** - सभी अंतर्निहित प्रदाता कच्चे `fetch()` का उपयोग करते हैं। कोई पोस्टहॉग SDK नहीं, कोई मिक्सपैनल SDK नहीं, कोई आयाम SDK नहीं। फ्रेमवर्क को हल्का रखता है।
+- **सर्वोत्तम प्रयास डिलीवरी** — प्रदाता की त्रुटियां पकड़ी जाती हैं और लॉग की जाती हैं। विफल एनालिटिक्स एकीकरण कभी भी कॉलर को क्रैश नहीं करता है या अनुरोध प्रबंधन को अवरुद्ध नहीं करता है।
+- **वैश्विक सिंगलटन** - रजिस्ट्री `globalThis` पर एक `Symbol.for` कुंजी का उपयोग करती है इसलिए एकाधिक ESM ग्राफ इंस्टेंसेस (डेव-मोड Vite + Nitro, सिम्लिंक) एक प्रदाता सेट साझा करते हैं।
+
+### ब्राउज़र डिफ़ॉल्ट {#browser-defaults}
+
+यह फ्रेमवर्क की अपनी आंतरिक टेलीमेट्री को कवर करता है - जो ज्यादातर फ्रेमवर्क योगदानकर्ताओं और उन्नत टेम्पलेट लेखकों के लिए प्रासंगिक है।
+
+टेम्पलेट रूट्स स्टार्टअप पर एक बार `configureTracking()` को कॉल करते हैं। `trackEvent()` के साथ भेजे गए ब्राउज़र ईवेंट में स्वचालित रूप से ऐप/टेम्पलेट संदर्भ और वर्तमान LLM कनेक्शन शामिल होता है जब ऐप इसे हल कर सकता है:
+
+- `llm_connection` - सामान्यीकृत प्रदाता लेबल जैसे `builder`, `anthropic`, `openai`, `google`, या `none`
+- `llm_engine` - इंजन आईडी, उदाहरण के लिए `builder` या `ai-sdk:openai`
+- `llm_model` - ज्ञात होने पर चयनित/डिफ़ॉल्ट मॉडल
+- `llm_connection_source` - `app_secrets`, `settings`, या `env`
+- `llm_connection_configured` - क्या LLM कनेक्शन उपलब्ध है
+
+फ्रेमवर्क कनेक्ट Builder CTAs से `builder connect clicked` को भी ट्रैक करता है, और सर्वर-साइड Builder कनेक्ट रूट प्रारंभ/सफल/असफल जीवनचक्र घटनाओं को ट्रैक करता है। `configureTracking()` को फ्रेमवर्क द्वारा स्वचालित रूप से कॉल किया जाता है; आपको इसे अपने टेम्पलेट कोड में कॉल करने की आवश्यकता नहीं है।
+
+</details>
+
+## आगे क्या है
+
+- [**Actions**](/docs/actions) - जहां अधिकांश ट्रैकिंग कॉल शुरू होती हैं
+- [**Server Plugins**](/docs/server) - `registerBuiltinProviders()` स्टार्टअप पर कोर-रूट्स प्लगइन में चलता है
+- [**Secrets**](/docs/security) - ट्रैकिंग प्रदाताओं के लिए API कुंजी प्रबंधित करें

package/docs/content/locales/hi-IN/using-your-agent.md

@@ -0,0 +1,71 @@
+---
+title: "अपने एजेंट का उपयोग करना"
+description: "एजेंट के साथ काम करने का दैनिक चक्र: यह देखता है कि आप क्या देख रहे हैं, आप इसे निर्देशित करते हैं, इसे एम्बेड करते हैं, UI-लाइट पर जाते हैं, और इसके साथ सह-संपादन करते हैं।"
+---
+
+# अपने एजेंट का उपयोग करना
+
+एजेंट-नेटिव के पीछे परिभाषित विचार यह है कि एजेंट और UI **समान भागीदार** हैं - क्यों के लिए [What Is Agent-Native?](/docs/what-is-agent-native) देखें। यह अनुभाग उस वादे के दूसरे भाग के बारे में है: आपके ऐप के बगल में डॉक होने के बाद एजेंट के साथ वास्तव में काम करना कैसा लगता है।
+
+एक सरल थ्रू-लाइन है। एजेंट **देखता** है कि आप क्या देख रहे हैं, आप उसे **निर्देशित** करते हैं जो आप चाहते हैं, आप उसे **एम्बेड** कहीं भी कर सकते हैं, आप पूरी तरह से **UI-लाइट** में जा सकते हैं जब यह बेहतर हो, और आप एक ही समय में समान दस्तावेज़ों को **सह-संपादित** कर सकते हैं। उनमें से प्रत्येक इस अनुभाग में एक पृष्ठ है।
+
+```an-diagram title="The day-to-day loop" summary="Five ways of working with a docked agent — each is a page in this section."
+{
+  "html": "<div class=\"diagram-loop\"><div class=\"diagram-card\"><strong>Sees</strong><small class=\"diagram-muted\">your view &amp; selection</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>Direct</strong><small class=\"diagram-muted\">@-mentions &amp; voice</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>Embed</strong><small class=\"diagram-muted\">drop into any app</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><strong>UI-light</strong><small class=\"diagram-muted\">chat is the product</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card accent-card\"><span class=\"diagram-pill accent\">Co-edit</span><small class=\"diagram-muted\">live, side by side</small></div></div>",
+  "css": ".diagram-loop{display:flex;align-items:stretch;gap:10px;flex-wrap:wrap}.diagram-loop .diagram-card{display:flex;flex-direction:column;gap:6px;padding:14px 16px;min-width:130px;flex:1}.diagram-loop .diagram-arrow{align-self:center;font-size:22px;line-height:1}"
+}
+```
+
+## यह वही देखता है जो आप देख रहे हैं {#it-sees}
+
+एजेंट आपकी स्क्रीन से अनजान नहीं है। एक ईमेल खोलें और यह जानता है कि कौन सा थ्रेड है। एक चार्ट चुनें और यह जानता है कि कौन सा चार्ट है। किसी अनुच्छेद को हाइलाइट करें और यह उसी सीमा पर कार्य कर सकता है। वह साझा जागरूकता ही आपको हर बार संदर्भ बताए बिना "इसका उत्तर दें" या "चयन को सारांशित करें" कहने की सुविधा देती है।
+
+यह काम करता है क्योंकि वर्तमान नेविगेशन और चयन `application_state` SQL में रहते हैं, जिसे एजेंट अपने संदर्भ के हिस्से के रूप में पढ़ता है। एजेंट उसी स्थिति को वापस भी चला सकता है - एक दृश्य खोलना, एक पंक्ति का चयन करना - ताकि आप इसे प्रतिलेख के बजाय वास्तविक UI में काम करते हुए देख सकें।
+
+```an-callout
+{
+  "tone": "info",
+  "body": "**Shared awareness is two-way.** You and the agent both read and write `application_state`, so \"reply to this\" or \"summarize the selection\" just works — and when the agent navigates, the real UI moves with it."
+}
+```
+
+→ [**Context Awareness**](/docs/context-awareness) - नेविगेशन स्थिति, व्यू-स्क्रीन, नेविगेट कमांड, और एजेंट आपकी स्क्रीन के साथ कैसे समन्वयित रहता है।
+
+## आप इसे निर्देशित करें {#you-direct-it}
+
+ज्यादातर समय आप चैट में टाइप करके एजेंट को संचालित करते हैं। दो चीज़ें इसे तेज़ बनाती हैं।
+
+**उल्लेख।** किसी कस्टम एजेंट, कनेक्टेड एजेंट या `@` वाली फ़ाइल को बातचीत में शामिल करने के लिए उसे टैग करें - "`@analytics` को पिछले सप्ताह के नंबर खींचने दें, फिर सारांश का मसौदा तैयार करें।" उल्लेख यह है कि आप सही विशेषज्ञ तक कैसे पहुंचते हैं या संगीतकार को छोड़े बिना सही संदर्भ कैसे जोड़ते हैं।
+
+**आवाज़.** संगीतकार के पास एक माइक्रोफ़ोन है. किसी अनुरोध को टाइप करने के बजाय उसे निर्देशित करें, जिसमें Builder के होस्ट किए गए ट्रांसक्रिप्शन से लेकर ब्राउज़र फ़ॉलबैक में अपनी-अपनी कुंजी लाने तक के प्रदाता विकल्प शामिल हैं।
+
+→ [**Agent Mentions**](/docs/agent-mentions) - `@`-चैट में कस्टम एजेंटों, कनेक्टेड एजेंटों और फ़ाइलों का उल्लेख करता है।
+→ [**Voice Input**](/docs/voice-input) - चैट कंपोजर में श्रुतलेख और प्रतिलेखन कैसे रूट किया जाता है।
+
+## आप इसे एम्बेड करें {#you-embed-it}
+
+एजेंट कोई अलग ऐप नहीं है जिस पर आप टैब करते हैं। यह मुट्ठी भर React घटकों - एक साइडबार, एक कच्चा पैनल और एक `sendToAgentChat()` कॉल - के रूप में शिप करता है जिसे आप किसी भी ऐप में डाल सकते हैं। प्रत्येक स्क्रीन को एक टॉगल करने योग्य एजेंट देने के लिए `<AgentSidebar>` रेंडर करें, या एक-शॉट LLM कॉल चलाने के बजाय चैट को एक विशिष्ट कार्य सौंपने के लिए एक बटन वायर करें।
+
+→ [**Drop-in Agent**](/docs/drop-in-agent) - `<AgentPanel>`, `<AgentSidebar>`, और `sendToAgentChat()` को किसी भी React ऐप में माउंट करें।
+→ [**Agent Surfaces**](/docs/agent-surfaces) - चुनें कि क्या वर्कफ़्लो हेडलेस, चैट-फर्स्ट, एम्बेडेड या पूर्ण ऐप होना चाहिए।
+
+## आप UI-लाइट पर जा सकते हैं {#ui-light}
+
+हर ऐप को पूर्ण डैशबोर्ड की आवश्यकता नहीं होती है। जब एजेंट *उत्पाद*है, तो आप अधिकांश कस्टम UI को छोड़ सकते हैं: ऐप खोलें, जो आप चाहते हैं उसके लिए पूछें, और एजेंट को बाकी काम करने दें। एजेंट के पास अभी भी प्रबंधन सतह है - इतिहास, कार्यक्षेत्र, सेटिंग्स - लेकिन प्राथमिक इंटरैक्शन क्लिक के बजाय बातचीत है।
+
+→ [**Pure-Agent Apps**](/docs/pure-agent-apps) - ऐसे ऐप्स जहां एजेंट ही संपूर्ण उत्पाद है।
+
+## आप इसके साथ सह-संपादन करें {#you-co-edit}
+
+जब आप और एजेंट एक ही दस्तावेज़ पर काम कर रहे होते हैं, तो आप बारी-बारी से काम नहीं करते हैं। वास्तविक समय सहयोग के साथ, एजेंट के संपादन आपके साथ स्ट्रीम होते हैं - लाइव कर्सर, कोई ओवरराइट नहीं - उसी तरह जैसे एक टीम के साथी का होता है। जब तक यह काम करता है तब तक आप टाइप करना जारी रख सकते हैं और यह आपके बदलावों को वैसे ही देखता है जैसे वे होते हैं।
+
+→ [**Real-Time Collaboration**](/docs/real-time-collaboration) - एक ही दस्तावेज़ में लाइव कर्सर और एजेंट संपादन के साथ बहु-उपयोगकर्ता सहयोगात्मक संपादन।
+
+## आगे क्या है {#whats-next}
+
+- [**Context Awareness**](/docs/context-awareness) - एजेंट जानता है कि आप क्या देख रहे हैं
+- [**Agent Mentions**](/docs/agent-mentions) — इसे `@`-उल्लेखों के साथ निर्देशित करें
+- [**Voice Input**](/docs/voice-input) - इसे बोलकर निर्देशित करें
+- [**Drop-in Agent**](/docs/drop-in-agent) — इसे किसी भी React ऐप में एम्बेड करें
+- [**Pure-Agent Apps**](/docs/pure-agent-apps) - जब एजेंट उत्पाद हो तो UI-लाइट करें
+- [**Real-Time Collaboration**](/docs/real-time-collaboration) — एक ही दस्तावेज़ को एक साथ सह-संपादित करें

package/docs/content/locales/hi-IN/voice-input.md

@@ -0,0 +1,81 @@
+---
+title: "वॉइस इनपुट"
+description: "एजेंट चैट कंपोजर में वॉयस डिक्टेशन - Builder जेमिनी, BYOK प्रदाता, और ब्राउज़र वेब स्पीच फ़ॉलबैक।"
+---
+
+# ध्वनि इनपुट
+
+प्रत्येक एजेंट-नेटिव ऐप में चैट कंपोज़र में एक माइक्रोफ़ोन होता है। इसे क्लिक करें, बात करें और आपके शब्द प्रॉम्प्ट में ट्रांसक्रिप्ट हो जाएंगे। मोबाइल पर उपयोगी, लंबे संकेतों के लिए उपयोगी, तब उपयोगी जब आपका हाथ किसी और चीज़ पर हो।
+
+फ्रेमवर्क यह सब स्वचालित रूप से संभालता है। Builder-कनेक्टेड उपयोगकर्ताओं को डिफ़ॉल्ट रूप से Builder-होस्टेड जेमिनी फ्लैश-लाइट मिलता है; अन्यथा उपयोगकर्ता अपनी स्वयं की प्रदाता कुंजी ला सकते हैं या ब्राउज़र वाक् पहचान पर वापस आ सकते हैं।
+
+## यह कैसे काम करता है {#how-it-works}
+
+संगीतकार का आवाज बटन ब्राउज़र में ऑडियो रिकॉर्ड करता है, फिर एक प्रदाता चुनता है:
+
+1. **Builder जेमिनी फ्लैश-लाइट (Builder कनेक्ट होने पर डिफ़ॉल्ट)।** ब्राउज़र `/_agent-native/transcribe-voice` पर ऑडियो पोस्ट करता है, जो जेमिनी फ्लैश-लाइट का उपयोग करके Builder.io के माध्यम से प्रॉक्सी करता है। किसी Google API कुंजी की आवश्यकता नहीं है।
+2. **BYOK क्लाउड प्रदाता।** उपयोगकर्ता सेटिंग्स से Google जेमिनी, ग्रोक व्हिस्पर, या OpenAI व्हिस्पर चुन सकते हैं। मार्ग साझा परिनियोजन क्रेडेंशियल से पहले उपयोगकर्ता-स्कोप वाले एन्क्रिप्टेड रहस्यों को हल करता है।
+3. **ब्राउज़र वेब स्पीच API (फ़ॉलबैक)।** यदि कोई सर्वर प्रदाता उपलब्ध नहीं है, तो कंपोज़र ब्राउज़र की अंतर्निहित वाक् पहचान का उपयोग कर सकता है। क्रोमियम-आधारित ब्राउज़र (क्रोम, एज, आर्क) और सफारी में काम करता है। कम सटीक; स्ट्रीम लाइव.
+
+प्रदाता की पसंद को `voice-transcription-prefs` के तहत एप्लिकेशन स्थिति में संग्रहीत किया जाता है ताकि उपयोगकर्ता साइडबार सेटिंग्स में `"auto"` (डिफ़ॉल्ट - सर्वोत्तम उपलब्ध प्रदाता चुनता है), `"builder-gemini"`, `"builder"`, `"gemini"`, `"groq"`, `"openai"`, या `"browser"` को बाध्य कर सके।
+
+```an-diagram title="Voice transcription provider fallback" summary="The composer records audio, then walks server providers in order, dropping to the browser Web Speech API only when no server provider is available."
+{
+  "html": "<div class=\"diagram-voice\"><div class=\"diagram-node\">Mic button<br><small class=\"diagram-muted\">records webm/opus</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card col\"><div class=\"diagram-pill accent\">1 &middot; Builder Gemini</div><small class=\"diagram-muted\">default when Builder connected</small><div class=\"diagram-pill\">2 &middot; BYOK cloud</div><small class=\"diagram-muted\">Gemini &middot; Groq &middot; OpenAI Whisper</small></div><div class=\"diagram-arrow diagram-warn\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-box diagram-warn\" data-rough>3 &middot; Browser Web Speech<br><small class=\"diagram-muted\">fallback on 400 &middot; streams live</small></div></div>",
+  "css": ".diagram-voice{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-voice .col{display:flex;flex-direction:column;gap:6px;padding:14px}.diagram-voice .diagram-arrow{font-size:22px;line-height:1}"
+}
+```
+
+मार्ग **केवल समान-मूल** है - क्रॉस-साइट पोस्ट अस्वीकार कर दिए जाते हैं ताकि कोई हमलावर किसी बाहरी पृष्ठ से ट्रांसक्रिप्शन क्रेडिट को बर्न न कर सके।
+
+## प्रदाताओं को सक्षम करना {#enabling-providers}
+
+Builder सबसे आसान रास्ता है: सेटिंग्स से Builder.io कनेक्ट करें और डिफ़ॉल्ट प्रदाता Builder जेमिनी फ्लैश-लाइट बन जाता है। BYOK प्रदाताओं के लिए, सेटिंग्स → API कुंजी में मिलान कुंजी जोड़ें।
+
+### प्रति-उपयोगकर्ता (सास के लिए अनुशंसित)
+
+उपयोगकर्ता एजेंट साइडबार सेटिंग्स UI के माध्यम से अपनी स्वयं की कुंजी सेट करता है। इसे उपयोगकर्ता-स्कोप्ड एन्क्रिप्टेड रहस्य (`readAppSecret` के माध्यम से) के रूप में संग्रहीत किया जाता है। प्रत्येक उपयोगकर्ता अपने स्वयं के प्रतिलेखन के लिए भुगतान करता है; मेज़बान के लिए शून्य लागत.
+
+### साझा (आंतरिक टूल के लिए)
+
+`GEMINI_API_KEY`, `GROQ_API_KEY`, या `OPENAI_API_KEY` को एक पर्यावरण चर के रूप में या `settings` तालिका में सेट करें। प्रत्येक उपयोगकर्ता का प्रतिलेखन साझा कुंजी को हिट करता है।
+
+```an-callout
+{
+  "tone": "info",
+  "body": "**Credential resolution order:** the route checks the user's own encrypted secret first, then the shared deployment key. A power user with their own key always overrides the shared one. If neither exists, the route returns a 400 the composer recognizes and silently falls back to browser Web Speech."
+}
+```
+
+## रास्ता {#route}
+
+```an-api title="Voice transcription route"
+{
+  "method": "POST",
+  "path": "/_agent-native/transcribe-voice",
+  "summary": "Transcribe a recorded audio clip into prompt text",
+  "auth": "Active session (Better Auth cookie). Same-origin only.",
+  "description": "The composer POSTs the recorded clip here; the route resolves a provider and returns the transcribed text. You should not call this directly.",
+  "params": [
+    { "name": "audio", "in": "body", "type": "file", "required": true, "description": "The recorded clip, webm/opus by default. Max 25 MB." },
+    { "name": "provider", "in": "body", "type": "string", "required": false, "description": "Optional override, e.g. gemini, groq, openai, builder." }
+  ],
+  "request": { "contentType": "multipart/form-data" },
+  "responses": [
+    { "status": "200", "description": "Transcription succeeded", "example": "{ \"text\": \"reply to Sara that I'll be there by 3\" }" },
+    { "status": "400", "description": "No server provider configured — the composer recognizes this and falls back to Web Speech", "example": "{ \"error\": \"no_provider\" }" }
+  ]
+}
+```
+
+आपको इसे सीधे कॉल करने की आवश्यकता नहीं है - संगीतकार करता है। यदि आप एक कस्टम इनपुट सतह बना रहे हैं, तो पहले `@agent-native/core/client` से साझा कंपोजर/वॉयस क्लाइंट टुकड़ों का पुन: उपयोग करें। इस मार्ग को उन कस्टम सहायकों के लिए निम्न-स्तरीय परिवहन सीमा के रूप में मानें जिन्हें मल्टीपार्ट ऑडियो भेजने की आवश्यकता है।
+
+## प्रदाता को अनुकूलित करना {#customizing}
+
+प्रदाता फ़ील्ड एक सादा एप्लिकेशन-स्टेट कुंजी है, इसलिए एजेंट अनुरोध पर इसे बदल सकता है (`"use the browser speech recognizer instead"`)। यदि आप विभिन्न आवश्यकताओं के साथ एक टेम्पलेट बना रहे हैं - मान लीजिए, एक ऑन-प्रिमाइसेस व्हिस्पर परिनियोजन - फ्रेमवर्क के डिफ़ॉल्ट माउंट होने से पहले अपना खुद का `transcribe-voice` रूट पंजीकृत करके रूट हैंडलर को स्वैप करें।
+
+## आगे क्या है
+
+- [**Drop-in Agent**](/docs/drop-in-agent) - कंपोजर जो वॉयस बटन को उजागर करता है
+- [**Onboarding**](/docs/onboarding) - प्रदाता कुंजियों को सेटअप चरणों के रूप में पंजीकृत करना
+- [**Security & Data Scoping**](/docs/security) - प्रति उपयोगकर्ता एन्क्रिप्टेड रहस्य कैसे संग्रहीत किए जाते हैं