@agent-native/core 0.76.5 → 0.76.6

package/docs/content/locales/hi-IN/agent-teams.md

@@ -0,0 +1,171 @@
+---
+title: "एजेंट टीमें"
+description: "मुख्य एजेंट उप-एजेंटों को काम सौंपता है जो अपने स्वयं के थ्रेड में चलते हैं और चैट में लाइव पूर्वावलोकन चिप्स इनलाइन के रूप में दिखाई देते हैं।"
+---
+
+# एजेंट टीमें
+
+एजेंट चैट एक **ऑर्केस्ट्रेटर** है, मोनोलिथ नहीं। जब मुख्य एजेंट किसी विशेषज्ञ के स्वामित्व वाले कार्य को पूरा करता है - "इस ईमेल को मेरी आवाज़ में लिखें," "बिगक्वेरी विश्लेषण चलाएं," "इस पीआर की समीक्षा करें" - यह अपने स्वयं के थ्रेड, टूल और संदर्भ में एक उप-एजेंट को जन्म देता है। उप-एजेंट मुख्य चैट में लाइव पूर्वावलोकन **चिप** इनलाइन के रूप में दिखाई देता है; पूरी बातचीत को एक टैब के रूप में खोलने के लिए इसे क्लिक करें।
+
+यह मुख्य थ्रेड को केंद्रित रखता है, उप-एजेंटों को समानांतर में चलने देता है, और आपको किसी भी सौंपे गए कार्य के लिए एक साफ़ ऑडिट ट्रेल देता है।
+
+एजेंट टीमें कोर रन-मैनेजर पर चलती हैं: इवेंट स्ट्रीम और जारी रहते हैं, निरस्त SQL के माध्यम से प्रसारित होते हैं, और कार्य सर्वर रहित कोल्ड स्टार्ट से बचे रहते हैं।
+
+## मानसिक मॉडल {#mental-model}
+
+- **मुख्य चैट** — ऑर्केस्ट्रेटर। प्रतिनिधि, आपका अनुरोध पढ़ता है। भारी काम शायद ही कभी करता है।
+- **उप-एजेंट** - अपने स्वयं के थ्रेड, अपने स्वयं के सिस्टम प्रॉम्प्ट, अपने स्वयं के टूल सेट के साथ चलते हैं। प्रत्येक [workspace](/docs/workspace) में एक "कस्टम एजेंट" प्रोफ़ाइल पर मैप होता है।
+- **चिप्स** - रिच प्रीव्यू कार्ड जो मुख्य चैट में इनलाइन दिखाई देता है, जो उप-एजेंट के वर्तमान चरण, स्ट्रीमिंग आउटपुट और अंतिम सारांश दिखाता है। डिफ़ॉल्ट रूप से संक्षिप्त किया गया; क्लिक करने पर पूरी बातचीत का विस्तार होता है।
+- **द्विदिशात्मक संदेश** - मुख्य एजेंट चल रहे उप-एजेंट को फॉलो-अप भेज सकता है; एक उप-एजेंट किसी अस्पष्ट बिंदु पर पहुंचने पर वापस संदेश भेज सकता है।
+
+उप-एजेंट स्थिति `application_state` SQL तालिका (`agent-task:<taskId>` के तहत) में बनी रहती है, इसलिए कार्य सर्वर रहित कोल्ड स्टार्ट से बचे रहते हैं और कई प्रक्रियाओं में काम करते हैं।
+
+```an-diagram title="Orchestrator and specialists" summary="The main chat delegates to sub-agents that run in their own threads and report back as inline chips."
+{
+  "html": "<div class=\"at-orc\"><div class=\"diagram-card main\"><span class=\"diagram-pill accent\">Main chat</span><small class=\"diagram-muted\">orchestrator &mdash; reads your request, delegates</small></div><div class=\"at-fan\"><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"at-subs\"><div class=\"diagram-box\">Code review<br><small class=\"diagram-muted\">own thread &amp; prompt</small></div><div class=\"diagram-box\">BigQuery analysis<br><small class=\"diagram-muted\">own tools</small></div><div class=\"diagram-box\">Email in voice<br><small class=\"diagram-muted\">own context</small></div></div></div><div class=\"diagram-pill\">each appears inline as a live chip &#8635;</div></div>",
+  "css": ".at-orc{display:flex;flex-direction:column;align-items:center;gap:12px}.at-orc .diagram-card{padding:14px 18px;display:flex;flex-direction:column;gap:4px;align-items:center}.at-orc .at-fan{display:flex;flex-direction:column;align-items:center;gap:8px}.at-orc .diagram-arrow{font-size:22px}.at-orc .at-subs{display:flex;gap:12px;flex-wrap:wrap;justify-content:center}.at-orc .diagram-box{text-align:center}"
+}
+```
+
+## उप-एजेंट को कब तैयार किया जाए {#when-to-spawn}
+
+कार्य के समय स्पॉन करें:
+
+- एक अलग **सिस्टम प्रॉम्प्ट** की आवश्यकता है (एक विशेषज्ञ आवाज या टोन, उदाहरण के लिए, "कोड समीक्षा")।
+- इसमें **लंबे समय तक चलने वाली** टूल श्रृंखला है जो मुख्य संदर्भ को प्रदूषित करेगी।
+- मुख्य एजेंट द्वारा किए जा रहे अन्य कार्यों के साथ **समानांतर** में चल सकता है।
+- इसका स्वामित्व **अलग-अलग टीम** के पास है जिसके पास पहले से ही एक कस्टम एजेंट प्रोफ़ाइल है।
+
+महत्वपूर्ण एक-शॉट कार्य के लिए प्रेरित न हों - सीधे कार्रवाई को कॉल करें।
+
+## एक उप-एजेंट को आमंत्रित करना {#invoking}
+
+किसी उप-एजेंट को हटाने के तीन तरीके, कम से कम से लेकर सबसे स्पष्ट तक:
+
+### 1. `@mention` एक कस्टम एजेंट {#mention}
+
+उपयोगकर्ता चैट कंपोजर में `@agent-name` टाइप करता है। कार्यस्थान उप-एजेंटों का एक ड्रॉपडाउन प्रकट होता है। एक का चयन करने पर एक चिप सम्मिलित होती है; सबमिट करने पर मुख्य एजेंट उस उप-एजेंट को संदेश सौंपता है।
+
+कस्टम एजेंट `agents/<slug>.md` के कार्यस्थल में रहते हैं - YAML फ्रंटमैटर के साथ एक Markdown फ़ाइल। प्रारूप के लिए [Custom Agents](/docs/workspace#custom-agents) देखें।
+
+### 2. मुख्य एजेंट स्वचालित रूप से प्रत्यायोजित करता है {#auto-delegate}
+
+फ्रेमवर्क मुख्य एजेंट को एक `agent-teams` टूल देता है। जब मॉडल तय करता है कि कोई कार्य एक पंजीकृत उप-एजेंट प्रोफ़ाइल में फिट बैठता है, तो यह टूल को `action: "spawn"` और एक वैकल्पिक `agent` पैरामीटर के साथ कॉल करता है जो `agents/*.md` से प्रोफ़ाइल का नामकरण करता है। एक चिप प्रकट होती है; उप-एजेंट चलता है. मुख्य एजेंट प्रतीक्षा करता है (या समानांतर में आगे बढ़ता है) और उप-एजेंट के समाप्त होने पर परिणाम शामिल करता है।
+
+पूर्ण `agent-teams` क्रिया सेट है:
+
+| कार्रवाई      | उद्देश्य                                  |
+| ------------- | ----------------------------------------- |
+| `spawn`       | एक नया उप-एजेंट कार्य प्रारंभ करें        |
+| `status`      | चल रहे उप-एजेंट की प्रगति की जाँच करें    |
+| `read-result` | एक तैयार उप-एजेंट का आउटपुट प्राप्त करें  |
+| `send`        | चल रहे उप-एजेंट को संदेश भेजें            |
+| `list`        | वर्तमान उपयोगकर्ता के लिए सभी कार्य देखें |
+
+### 3. प्रोग्रामेटिक स्पॉन {#programmatic-spawn}
+
+फ्रेमवर्क-स्तरीय एकीकरण के लिए, `@agent-native/core/server` से `spawnTask()` का उपयोग करें:
+
+```ts
+import { spawnTask } from "@agent-native/core/server";
+
+const task = await spawnTask({
+  description: "Draft an outreach email to this lead",
+  instructions: "Match Steve's voice from memory/MEMORY.md.",
+  ownerEmail: user.email,
+  systemPrompt: mailAgentSystemPrompt,
+  actions: mailActions,
+  // Pass either apiKey or engine — engine takes precedence.
+  apiKey: process.env.ANTHROPIC_API_KEY, // optional if engine is provided
+  parentSend: emit, // streaming sender for the parent chat response
+});
+```
+
+अधिकांश ऐप कोड इसे सीधे कॉल नहीं करेंगे - फ्रेमवर्क इसे `@mentions` और `agent-teams` टूल के हुड के तहत करता है। `spawnTask()` तक तभी पहुंचें जब आप एक नया प्रवेश बिंदु वायरिंग कर रहे हों (उदाहरण के लिए, एक बटन जो पृष्ठभूमि कार्य को शुरू करता है जो उप-एजेंट के रूप में चलता है)।
+
+## कार्य जीवनचक्र {#lifecycle}
+
+```an-diagram title="What spawnTask() does" summary="Each spawn creates a thread, persists state to SQL, and streams chip events through to completion."
+{
+  "html": "<div class=\"at-life\"><div class=\"diagram-box\"><code>spawnTask()</code></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">create thread</span><small class=\"diagram-muted\">new row in <code>chat_threads</code>, description as first message</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill\">persist state</span><small class=\"diagram-muted\"><code>agent-task:&lt;id&gt;</code> &rarr; <code>application_state</code>, status=running</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card\"><span class=\"diagram-pill accent\">stream</span><small class=\"diagram-muted\"><code>agent_task_started</code> &rarr; chip appears; <code>agent_task_step</code> &rarr; chip updates live</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&darr;</div><div class=\"diagram-card ok\"><span class=\"diagram-pill ok\">complete</span><small class=\"diagram-muted\">status=completed, write summary + preview, emit <code>agent_task_done</code></small></div></div>",
+  "css": ".at-life{display:flex;flex-direction:column;align-items:stretch;gap:6px;max-width:560px}.at-life .diagram-card{display:flex;flex-direction:column;gap:3px;padding:10px 14px}.at-life .diagram-box{align-self:flex-start}.at-life .diagram-arrow{font-size:18px;align-self:center}"
+}
+```
+
+किसी भी बिंदु पर मूल एजेंट `sendToTask(taskId, message)` के माध्यम से फॉलो-अप के साथ उप-एजेंट को फिर से शुरू कर सकता है। यदि उप-एजेंट त्रुटियां करता है, तो `markTaskErrored(taskId, reason)` विफलता को रिकॉर्ड करता है और इसे उपयोगकर्ता को दिखाता है।
+
+दोतरफा संदेश टिकाऊ होता है। चल रहे उप-एजेंटों के लिए अभिभावक अनुवर्ती हैं
+कार्य जीवनचक्र के माध्यम से वितरित; यदि उप-एजेंट उन्हें
+वर्तमान चरण में, उन्हें कतारबद्ध रहना चाहिए और सुरक्षित स्थान पर लागू किया जाना चाहिए
+निरंतरता बिंदु। स्पष्टीकरण की आवश्यकता होने पर उप-एजेंट भी वापस संदेश भेज सकते हैं
+अदृश्य रूप से अवरुद्ध करने के बजाय।
+
+## कार्य स्थिति पढ़ना {#reading-state}
+
+सर्वर कोड या अन्य actions से:
+
+```ts
+import { getTask, listTasks } from "@agent-native/core/server";
+
+const task = await getTask(taskId); // single task
+const tasks = await listTasks(); // all tasks for the user (sorted newest first)
+```
+
+`AgentTask` प्रमुख क्षेत्र:
+
+```ts
+interface AgentTask {
+  taskId: string;
+  threadId: string;
+  description: string;
+  status: "running" | "completed" | "errored";
+  preview: string; // short one-liner for the chip
+  summary: string; // full summary once completed
+  currentStep: string; // latest step label (updated while running)
+  createdAt: number;
+  // Additional fields: parentThreadId, name, updatedAt, startedAt,
+  // completedAt, runId, error
+}
+```
+
+## कस्टम एजेंट प्रोफ़ाइल {#profiles}
+
+उप-एजेंट कस्टम एजेंट प्रोफाइल पर मैप करते हैं - कार्यस्थल में `agents/<slug>.md` पर Markdown फ़ाइलें जो `@mention` ड्रॉपडाउन में दिखाई देती हैं और प्रतिनिधिमंडल लक्ष्य के रूप में काम करती हैं। [Workspace — Custom Agents](/docs/workspace#custom-agents) पूर्ण प्रारूप (फ्रंटमैटर, `tools`, `delegate-default`, मॉडल ओवरराइड्स) का मालिक है।
+
+## प्रतिनिधिमंडल गहराई गार्ड {#depth-guard}
+
+उप-एजेंट उप-एजेंटों को जन्म दे सकते हैं, जो एक भगोड़ा/लागत जोखिम है: प्रतिनिधिमंडलों की एक असीमित श्रृंखला अनिश्चित काल तक चल सकती है। फ्रेमवर्क **डेलीगेशन गहराई पर सख्त सीमा** लागू करता है, सर्वर-साइड, किसी भी टूल-स्तरीय गार्ड से स्वतंत्र।
+
+शीर्ष-स्तरीय चैट गहराई `0` है। इसके द्वारा उत्पन्न एक उप-एजेंट गहराई `1` है; वह उप-एजेंट एक बार फिर से पैदा हो सकता है (गहराई `2`); एक स्पॉन जो एक गहराई-`3` उप-एजेंट बनाएगा **अस्वीकार** है। डिफ़ॉल्ट सीमा **2** है।
+
+```an-diagram title="Delegation depth guard (default cap 2)" summary="Each level may spawn one deeper until the cap; a spawn past it is refused server-side."
+{
+  "html": "<div class=\"at-depth\"><div class=\"diagram-card ok\"><span class=\"diagram-pill\">depth 0</span><strong>Top-level chat</strong><small class=\"diagram-muted ok\">may spawn &darr;</small></div><div class=\"diagram-card ok\"><span class=\"diagram-pill\">depth 1</span><strong>Sub-agent</strong><small class=\"diagram-muted ok\">may spawn &darr;</small></div><div class=\"diagram-card warn\"><span class=\"diagram-pill warn\">depth 2</span><strong>Sub-agent's sub-agent</strong><small class=\"diagram-muted\">at the cap &mdash; may NOT spawn</small></div><div class=\"diagram-card\"><span class=\"diagram-pill warn\">depth 3</span><strong>Refused</strong><small class=\"diagram-muted\">server-side error</small></div></div>",
+  "css": ".at-depth{display:flex;flex-direction:column;gap:8px}.at-depth .diagram-card{display:flex;flex-direction:column;gap:2px;padding:10px 14px}.at-depth .rung-1,.at-depth .diagram-card:nth-child(2){margin-inline-start:24px}.at-depth .diagram-card:nth-child(3){margin-inline-start:48px}.at-depth .diagram-card:nth-child(4){margin-inline-start:72px}"
+}
+```
+
+प्रवर्तन परिवेशीय है: प्रत्येक उप-एजेंट एक `AsyncLocalStorage` के अंदर चलता है जो अपनी गहराई को रिकॉर्ड करता है, इसलिए उस रन से सकर्मक रूप से पहुंचा कोई भी `spawnTask` अपने मूल की गहराई को पढ़ता है और कैप हिट होने के बाद मना कर देता है - भले ही `agent-teams` उपकरण एक ऐसे उप-एजेंट को सौंप दिया गया हो जिसके पास यह नहीं होना चाहिए था। निर्णय शुद्ध, इकाई-परीक्षण योग्य `evaluateSubagentDepth(parentDepth)` के रूप में सामने आया है। एक अस्वीकृत स्पॉन एक स्पष्ट त्रुटि देता है: _"प्रतिनिधिमंडल की गहराई सीमा (अधिकतम एन) तक पहुंच गई है; किसी अन्य उप-एजेंट को स्पॉन नहीं किया जा सकता है।"_
+
+### कैप को कॉन्फ़िगर करना {#depth-guard-config}
+
+`AGENT_NATIVE_MAX_SUBAGENT_DEPTH` के साथ परिनियोजन समय पर डिफ़ॉल्ट को ओवरराइड करें:
+
+| मान            | प्रभाव                                                                                                                                                           |
+| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| _(अनसेट)_      | `2` की डिफ़ॉल्ट कैप।                                                                                                                                             |
+| `0`            | **कोई उप-एजेंट नहीं बनाया जा सकता** - शीर्ष-स्तरीय एजेंट सभी काम करता है।                                                                                        |
+| `1`…`16`       | प्रतिनिधिमंडल के इतने सारे स्तर।                                                                                                                                 |
+| अमान्य / `>16` | एक गैर-पूर्णांक/नकारात्मक/NaN मान वापस `2` पर आ जाता है; `16` से ऊपर की कोई भी चीज़ `16` से जुड़ी होती है, इसलिए टाइप त्रुटि कभी भी गार्ड को अक्षम नहीं कर सकती। |
+
+```bash
+AGENT_NATIVE_MAX_SUBAGENT_DEPTH=1   # sub-agents allowed, but they can't sub-delegate
+```
+
+जब कोई उप-एजेंट सीमा पर या उससे नीचे होता है, तो फ्रेमवर्क उसके रनटाइम संदर्भ में एक लाइन इंजेक्ट करता है जो बताता है कि यह कितनी गहराई तक बैठता है और क्या यह आगे सौंप सकता है, इसलिए मॉडल अपना बजट उचित रूप से खर्च करता है।
+
+## आगे क्या
+
+- [**Workspace — Custom Agents**](/docs/workspace#custom-agents) - प्रोफ़ाइल प्रारूप
+- [**A2A Protocol**](/docs/a2a-protocol) - जब "उप-एजेंट" पूरी तरह से एक अलग ऐप में रहता है
+- [**Actions**](/docs/actions) - वे उपकरण जिन्हें उप-एजेंट कॉल करता है

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

@@ -0,0 +1,161 @@
+---
+title: "सार्वजनिक एजेंट वेब"
+description: "सार्वजनिक मार्गों को एजेंटों द्वारा क्रॉल करने योग्य, पढ़ने योग्य, उद्धृत करने योग्य और वैकल्पिक रूप से कॉल करने योग्य बनाएं - robots.txt, llms.txt, मार्कडाउन मिरर, JSON-LD, और एक सार्वजनिक MCP सतह।"
+---
+
+# सार्वजनिक एजेंट वेब
+
+सार्वजनिक एजेंट वेब एजेंटों के लिए सार्वजनिक Agent-Native मार्गों को क्रॉल करना, पढ़ना, उद्धृत करना और कॉल करना आसान बनाता है। लक्ष्य प्रत्येक ऐप एंडपॉइंट को सार्वजनिक करना नहीं है। लक्ष्य उन पृष्ठों के लिए एक स्वच्छ सार्वजनिक सतह प्रकाशित करना है जो पहले से ही सार्वजनिक हैं, जबकि निजी डेटा और टूल एक्सेस को स्पष्ट नियंत्रण के पीछे रखना है।
+
+दस्तावेज़ साइट संदर्भ कार्यान्वयन है। आज यह शिप करता है:
+
+- `/robots.txt` एक क्रॉलर नीति के साथ जो पुनर्प्राप्ति की अनुमति देता है लेकिन डिफ़ॉल्ट रूप से प्रशिक्षण की अनुमति नहीं देता है।
+- `/sitemap.xml` पूर्ण विहित URLs और `lastmod` के साथ जब स्रोत फ़ाइल इसे उजागर करती है।
+- एजेंट-अनुकूल सामग्री खोज के लिए `/llms.txt` और `/llms-full.txt`।
+- Markdown दर्पण जैसे `/docs/getting-started.md`।
+- उत्पादन निर्माण के बाद सार्वजनिक दस्तावेज़ पृष्ठों के लिए `Accept: text/markdown` प्रतिक्रियाएँ।
+- आधार संगठन, वेबसाइट और पेज मेटाडेटा के लिए JSON-LD।
+- एक ऑडिट CLI (`npx @agent-native/core@latest audit-agent-web`) जो उपरोक्त सभी की जांच करता है।
+
+`publicMcp: true` को सेट करने से ऑप्ट-इन actions एक सार्वजनिक MCP एंडपॉइंट के रूप में सामने आता है, जिससे बाहरी एजेंट उन्हें सीधे कॉल कर सकते हैं ([MCP Protocol](/docs/mcp-protocol) देखें)।
+
+```an-diagram title="What a public route publishes" summary="A public route fans out into agent-friendly representations. Reading the route is separate from calling tools — tool access stays opt-in."
+{
+  "html": "<div class=\"diagram-web\"><div class=\"diagram-box\" data-rough>Public route<br><small class=\"diagram-muted\">derived from route access settings</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-grid\"><span class=\"diagram-pill\">robots.txt</span><span class=\"diagram-pill\">sitemap.xml</span><span class=\"diagram-pill\">llms.txt</span><span class=\"diagram-pill\">.md mirror</span><span class=\"diagram-pill\">JSON-LD</span><span class=\"diagram-pill\">text/markdown</span></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-col gate\"><span class=\"diagram-pill warn\">Tools stay private</span><small class=\"diagram-muted\">publicMcp + publicAgent.expose required</small></div></div>",
+  "css": ".diagram-web{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-web .diagram-arrow{font-size:22px;line-height:1}.diagram-web .diagram-grid{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:8px}.diagram-web .gate{display:flex;flex-direction:column;gap:4px;align-items:flex-start}"
+}
+```
+
+## कॉन्फ़िगरेशन {#config}
+
+मौजूदा वर्कस्पेस ऐप कॉन्फ़िगरेशन के तहत `agentWeb` जोड़ें (अपने ऐप के `package.json` में `agent-native` कुंजी के तहत - या समकक्ष `workspace.agentWeb`, `agentWeb`, या `root.agentWeb`)। सार्वजनिक रूट सूची अभी भी ऐप की रूट एक्सेस सेटिंग्स से ली गई है; `agentWeb` नियंत्रित करता है कि उस सार्वजनिक सतह को एजेंटों के सामने कैसे प्रस्तुत किया जाए।
+
+```json
+{
+  "agent-native": {
+    "workspaceApp": {
+      "audience": "public",
+      "protectedPaths": ["/admin/*"],
+      "agentWeb": {
+        "discoverable": true,
+        "markdownTwins": true,
+        "llmsTxt": true,
+        "jsonLd": true,
+        "publicAgentCard": true,
+        "publicMcp": false,
+        "crawlerPolicy": "discoverable-no-training",
+        "crawlers": {
+          "training": "disallow",
+          "search": "allow",
+          "userTriggered": "allow",
+          "codingAgents": "allow",
+          "autonomousAgents": "allow"
+        }
+      }
+    }
+  }
+}
+```
+
+अधिकांश ऐप्स के लिए, डिफ़ॉल्ट को अकेला छोड़ दें। यदि किसी ऐप में कोई सार्वजनिक रूट है, तो `discoverable` डिफ़ॉल्ट रूप से चालू हो जाता है। डिफ़ॉल्ट क्रॉलर नीति "खोजने योग्य है, प्रशिक्षित करने योग्य नहीं": खोज, उपयोगकर्ता-ट्रिगर पुनर्प्राप्ति, कोडिंग एजेंट और स्वायत्त ब्राउज़िंग एजेंटों की अनुमति है; क्रॉलर को प्रशिक्षण देने की अनुमति नहीं है.
+
+## सत्य का मार्ग स्रोत {#route-source}
+
+एजेंट वेब डिस्कवरी रूट एक्सेस मॉडल का अनुसरण करती है:
+
+- सार्वजनिक ऐप्स `protectedPaths` को छोड़कर हर मार्ग को उजागर करते हैं।
+- आंतरिक ऐप्स केवल `publicPaths` को उजागर करते हैं।
+- सार्वजनिक शेयर और फॉर्म पेज एजेंटों द्वारा पढ़ने योग्य हो सकते हैं।
+- प्रस्तुत निजी डेटा, प्रमाणित डैशबोर्ड और उपयोगकर्ता/संगठन स्थिति को कभी भी शामिल नहीं किया जाता है क्योंकि पास का पृष्ठ सार्वजनिक है।
+
+यह मिश्रित ऐप्स को स्वाभाविक रखता है। एक फॉर्म ऐप एक सार्वजनिक फॉर्म पेज को उजागर कर सकता है और सबमिशन को निजी रख सकता है। एक सामग्री ऐप प्रकाशित पोस्ट को उजागर कर सकता है और संपादक को निजी रख सकता है। एक डॉक्स साइट एडमिन टूल्स को छोड़कर बाकी सब कुछ उजागर कर सकती है।
+
+## सार्वजनिक पृष्ठ सार्वजनिक उपकरण नहीं हैं {#public-tools}
+
+सार्वजनिक पेज एक्सेस और सार्वजनिक टूल एक्सेस अलग-अलग हैं। किसी रूट के सार्वजनिक होने का मतलब केवल यह है कि एजेंट उस रूट को HTML, Markdown, साइटमैप प्रविष्टियों, एलएलएमएस प्रविष्टियों और संरचित डेटा के रूप में पढ़ सकते हैं।
+
+```an-callout
+{
+  "tone": "warning",
+  "body": "**A public page is not a public tool.** Making a route crawlable never exposes an action. Tool access requires an explicit `publicAgent.expose` opt-in on the action *and* `publicMcp: true` on the app."
+}
+```
+
+सार्वजनिक एजेंट प्रोटोकॉल के माध्यम से किसी कार्रवाई को उजागर करने के लिए, कार्रवाई को इसमें शामिल होना होगा:
+
+```an-annotated-code title="Opting one safe action onto the public surface"
+{
+  "filename": "actions/search-docs.ts",
+  "language": "ts",
+  "code": "export default defineAction({\n  description: \"Search published docs\",\n  readOnly: true,\n  publicAgent: {\n    expose: true,\n    readOnly: true,\n    requiresAuth: false,\n    isConsequential: false,\n    title: \"Search published docs\",\n  },\n  run: async (args) => {\n    // ...\n  },\n});",
+  "annotations": [
+    { "lines": "4", "label": "Explicit opt-in", "note": "Without `publicAgent.expose === true`, the action never appears on any public agent surface — no matter how public its routes are." },
+    { "lines": "5-7", "label": "Self-describe safety", "note": "Mark it read-only, declare whether it needs auth, and flag whether it is consequential. Public MCP excludes consequential/write actions unless policy explicitly allows them." }
+  ]
+}
+```
+
+`agentWeb.publicMcp` डिफ़ॉल्ट रूप से `false` रहता है। जब सार्वजनिक MCP सक्षम होता है, तो सर्वर को `publicAgent.expose === true` के साथ केवल actions को उजागर करना चाहिए, और तब भी परिणामी को बाहर करना चाहिए या actions लिखना चाहिए जब तक कि कार्रवाई और प्राधिकरण नीति स्पष्ट रूप से उन्हें अनुमति न दे।
+
+## बिल्ड-टाइम फ़ाइलें {#build-time}
+
+`@agent-native/core/agent-web` में फ्रेमवर्क उपयोगिताएँ एक पृष्ठ सूची से सामान्य फ़ाइलें उत्पन्न करती हैं:
+
+```ts
+import {
+  buildAgentWebStaticFiles,
+  normalizeAgentWebConfig,
+} from "@agent-native/core/agent-web";
+
+const config = normalizeAgentWebConfig(
+  { crawlerPolicy: "discoverable-no-training" },
+  { hasPublicRoutes: true },
+);
+
+const files = buildAgentWebStaticFiles({
+  siteName: "My Agent-Native App",
+  siteUrl: "https://example.com",
+  description: "Public docs for my app.",
+  config,
+  pages: [
+    {
+      path: "/docs",
+      title: "Docs",
+      description: "Start here.",
+      markdown: "# Docs\n\nStart here.\n",
+      markdownPath: "/docs/getting-started.md",
+      lastmod: new Date(),
+    },
+  ],
+});
+```
+
+Vite ऐप्स उत्पादन निर्माण के दौरान उन फ़ाइलों को `public`, `dist`, `dist/client`, `dist/server/public`, या `build/client` में लिखने के लिए `@agent-native/core/vite` से `createAgentWebVitePlugin` का उपयोग कर सकते हैं।
+
+## किसी साइट का ऑडिट करें {#audit}
+
+किसी तैनात साइट या स्थानीय उत्पादन सर्वर के विरुद्ध CLI ऑडिट का उपयोग करें:
+
+```bash
+npx @agent-native/core@latest audit-agent-web --url https://www.agent-native.com
+```
+
+ऑडिट इसकी जाँच करता है:
+
+- SSR-दृश्यमान HTML.
+- कैनोनिकल URLs.
+- JSON-LD.
+- `robots.txt` नीति और संपूर्ण साइटमैप URL.
+- पूर्ण साइटमैप प्रविष्टियाँ।
+- `/llms.txt` और `/llms-full.txt`.
+- Markdown दर्पण।
+- `Accept: text/markdown`.
+- सामान्य एजेंट पुनर्प्राप्ति उपयोगकर्ता एजेंटों के लिए कोई आकस्मिक 401/403 ब्लॉक नहीं।
+
+यदि आवश्यक सार्वजनिक सतह गायब है तो ऑडिट गैर-शून्य से बाहर हो जाता है।
+
+## आगे क्या
+
+- [**Actions**](/docs/actions) - सार्वजनिक एजेंट प्रोटोकॉल में actions को कैसे चुनें
+- [**MCP Protocol**](/docs/mcp-protocol) - MCP सतह जो `publicMcp: true` सक्षम करती है
+- [**Deployment**](/docs/deployment) - जहां ये स्थिर फ़ाइलें बिल्ड के दौरान लिखी जाती हैं

package/docs/content/locales/hi-IN/audit-log.md

@@ -0,0 +1,111 @@
+---
+title: "ऑडिट लॉग"
+description: "एक टिकाऊ, केवल संलग्न रिकॉर्ड, जिसने कौन सा ऐप डेटा बदला, कब और क्या वह आप थे या एजेंट - एक्शन सीम पर स्वचालित रूप से कैप्चर किया गया।"
+---
+
+# ऑडिट लॉग
+
+प्रत्येक एजेंट-नेटिव ऐप को बॉक्स से एक ऑडिट लॉग मिलता है: एक टिकाऊ, पूर्ण, एक्सेस-स्कोप्ड, एपेंड-ओनली रिकॉर्ड **किसने किस ऐप डेटा को म्यूट किया, कब, कहाँ से, और - जब वह एजेंट था - किस रन में।** एक्शन सीम पर कैप्चर स्वचालित है; आप इसके लिए कोई कोड नहीं लिखते.
+
+चूंकि एजेंट आपकी ओर से डेटा बदल सकता है, यहां ऑडिट लॉग के जवाब का शीर्षक सिर्फ "इस रिकॉर्ड को किसने संपादित किया" नहीं है - बल्कि **"वह मैं था या एजेंट, और किस कारण से यह हुआ?"** फ्रेमवर्क में कोई अन्य सिस्टम इसका उत्तर नहीं दे सकता।
+
+## ऑडिट बनाम अवलोकनशीलता बनाम ट्रैकिंग {#which}
+
+तीन सिस्टम तीन अलग-अलग कारणों से "क्या हुआ" रिकॉर्ड करते हैं। आप जो प्रश्न पूछ रहे हैं उसके अनुसार चुनें:
+
+| प्रणाली                                  | यह जिस प्रश्न का उत्तर देता है                      | निष्ठा                           | दर्शक                               |
+| ---------------------------------------- | --------------------------------------------------- | -------------------------------- | ----------------------------------- |
+| **ऑडिट लॉग** (यह पेज)                    | "इस रिकॉर्ड को किसने, कब बदला और क्या वह एजेंट था?" | **पूर्ण, टिकाऊ, दायरायुक्त**     | उपयोगकर्ता, व्यवस्थापक, स्वयं एजेंट |
+| **[Observability](/docs/observability)** | "एजेंट ने ऐसा क्यों किया, और इसकी कीमत क्या थी?"    | नमूना स्पैन टेलीमेट्री           | डेवलपर                              |
+| **[Tracking](/docs/tracking)**           | "लोग उत्पाद का उपयोग कैसे कर रहे हैं?"              | बाहरी SaaS को आग लगाओ और भूल जाओ | पीएम/विकास                          |
+
+एक ऑडिट लॉग जिसका नमूना लिया गया है या किसी एनालिटिक्स प्रदाता को भेज दिया गया है वह बेकार है - मुख्य बात यह है कि यह पूर्ण, स्थानीय और क्वेरी करने योग्य है। तो यह इसका अपना सबसिस्टम है, अन्य दो का एक मोड नहीं।
+
+## क्या स्वचालित रूप से कैप्चर किया जाता है {#captured}
+
+जब कोई **उत्परिवर्तित** क्रिया चलती है (कुछ भी जो केवल पढ़ने योग्य `GET` नहीं है), तो फ्रेमवर्क `agent_audit_log` में एक पंक्ति जोड़ता है:
+
+- **कार्रवाई** - कार्रवाई का नाम (उदाहरण के लिए `delete-recording`)।
+- **अभिनेता** - `agent`, `human`, या `system`, साथ ही अभिनेता का ईमेल - **एजेंट कॉल के लिए भी भरा हुआ**, इसलिए आपको "एजेंट, alice@ के लिए अभिनय, ..." मिलता है।
+- **लिंकेज चलाएँ** - एजेंट `threadId` / `turnId` जिसने कॉल (एक टूल कॉल) को ट्रिगर किया, इसलिए एक उत्परिवर्तन सटीक एजेंट मोड़ पर वापस आ जाता है।
+- **सतह** - `tool` (एजेंट), `frontend`, `http`, `cli`, `mcp`, या `a2a`।
+- **परिणाम** - `success`, `error` (त्रुटि कोड के साथ), या `denied` (मानव-अनुमोदन द्वार द्वारा अवरुद्ध)।
+- **इनपुट** - कॉल तर्क, क्रेडेंशियल-आकार वाले मान [redacted](#privacy) के साथ।
+- **लक्ष्य और स्वामी** - कार्रवाई में बदला गया संसाधन, [scope reads](#reading) के लिए उपयोग किया जाता है।
+
+किसी वायरिंग की आवश्यकता नहीं - कैप्चर पारदर्शी रूप से `defineAction` में जुड़ जाता है। केवल पढ़ने योग्य actions को छोड़ दिया जाता है, और कुछ उच्च-आवृत्ति फ्रेमवर्क actions (ऐप-स्टेट सिंक, संदर्भ-एक्सरे, नेविगेशन) को लॉग में बाढ़ से बचने के लिए डिफ़ॉल्ट रूप से छोड़ दिया जाता है।
+
+## घोषणा करें कि किसी कार्रवाई में क्या परिवर्तन हुआ {#target}
+
+डिफ़ॉल्ट रूप से एक ईवेंट का दायरा **अभिनेता** तक होता है - आप अपने स्वयं के परिवर्तन और अपनी ओर से एजेंट के परिवर्तन देखते हैं। _shared_ संसाधन में परिवर्तन करने के लिए **मालिक** ट्रेल में भी दिखाई दें, और संसाधन द्वारा घटनाओं को लेबल करने के लिए, एक `target` घोषित करें:
+
+```ts
+export default defineAction({
+  description: "Delete a recording.",
+  schema: z.object({ id: z.string() }),
+  audit: {
+    target: (args, result) => ({
+      type: "recording",
+      id: args.id,
+      // Optional — defaults to the actor. Set when editing someone else's resource.
+      ownerEmail: result?.ownerEmail,
+      visibility: "org",
+    }),
+    summary: (args) => `Deleted recording ${args.id}`,
+  },
+  run: async (args, ctx) => {
+    /* ...delete... */
+  },
+});
+```
+
+`audit` में सब कुछ वैकल्पिक है। न्यूनतम उपयोगी जोड़ `target: () => ({ type, id })` है।
+
+### ट्यूनिंग कैप्चर {#tuning}
+
+| विकल्प               | प्रभाव                                                                            |
+| -------------------- | --------------------------------------------------------------------------------- |
+| `audit.target`       | ईवेंट को संसाधन और दायरे के साथ लेबल करें और उसके मालिक को पढ़ें।                 |
+| `audit.summary`      | घटना के लिए एक छोटी मानव-पठनीय पंक्ति।                                            |
+| `audit.onRead`       | एक संवेदनशील **रीड** (गुप्त पहुंच, थोक निर्यात) का ऑडिट करें।                     |
+| `audit.enabled`      | `true` बलपूर्वक कब्ज़ा कर लेता है; `false` एक शोर उत्परिवर्तन का विकल्प चुनता है। |
+| `audit.recordInputs` | `false` (पहले से संशोधित) तर्कों को कैप्चर करना छोड़ देता है।                     |
+
+## ट्रेल पढ़ना {#reading}
+
+दो रीड actions एजेंट के लिए उपलब्ध हैं **और** हर ऐप में फ्रंटएंड, SQL में कॉल करने वाले के दायरे में आता है - वे कभी भी किसी अन्य किरायेदार की पंक्तियाँ नहीं लौटाते हैं:
+
+- **`list-audit-events`** - `targetType` / `targetId`, `actorKind` (`agent` | `human` | `system`), `status`, `threadId` / `turnId`, `action` द्वारा फ़िल्टर करें। `sinceMs`, और `limit`.
+- **`get-audit-event`** - आईडी के अनुसार एक ईवेंट, जिसमें इसका संशोधित इनपुट पेलोड भी शामिल है।
+
+`useActionQuery` के साथ UI से `list-audit-events` को कॉल करके एक गतिविधि फ़ीड या "यह किसने बदला" लाइन बनाएं - कभी भी ऑडिट टेबल पर हाथ से न लिखें:
+
+```tsx
+import { useActionQuery } from "@agent-native/core/client";
+
+const { data } = useActionQuery("list-audit-events", {
+  targetType: "recording",
+  targetId: recordingId,
+});
+// data.events → [{ action, actorKind, actorEmail, turnId, status, summary, createdAt }, …]
+```
+
+एजेंट उसी कार्रवाई को कॉल कर सकता है - उससे पूछें "आपने इस रिकॉर्डिंग में क्या बदलाव किया?" और यह निशान से उत्तर देता है।
+
+## गोपनीयता एवं अवधारण {#privacy}
+
+- **रिडक्शन** - किसी भी इनपुट को संग्रहीत करने से पहले, क्रेडेंशियल-आकार की कुंजी और मान (टोकन, रहस्य, पासवर्ड, बियरर स्ट्रिंग) छीन लिए जाते हैं और बड़े आकार के पेलोड को छोटा कर दिया जाता है। ऑडिट लॉग कभी भी रहस्यों का द्वितीयक भंडार नहीं बनता है। `summary` टेक्स्ट को संवेदनशील डेटा से भी मुक्त रखें।
+- **केवल जोड़ें** — ऑडिट पंक्तियों के लिए कोई अद्यतन या हटाने की कार्रवाई नहीं है। एकमात्र विलोपन अवधारण पर्ज है, जो लॉग को ऑडिट ट्रेल के रूप में भरोसेमंद बनाता है।
+- **किरायेदार अलगाव** - रीड्स को कॉल करने वाले की पहचान और संगठन तक सीमित किया जाता है; बिना किसी पहचान के, कुछ भी मेल नहीं खाता।
+
+पर्यावरण के माध्यम से कॉन्फ़िगर करें:
+
+- `AGENT_NATIVE_AUDIT_RETENTION_DAYS` - कितनी लंबी पंक्तियाँ रखी जाती हैं (डिफ़ॉल्ट `365`; `0` = हमेशा के लिए रखें)।
+- `AGENT_NATIVE_AUDIT_ENABLED=false` - वैश्विक किल स्विच।
+
+## आगे क्या है
+
+- [**Actions**](/docs/actions) - `defineAction` सीम जहां कैप्चर होता है
+- [**Human-in-the-Loop Approvals**](/docs/human-approval) - गेटेड actions, `denied` के रूप में रिकॉर्ड किया गया
+- [**Security & Data Scoping**](/docs/security) - स्वामित्व मॉडल ऑडिट पुन: उपयोग पढ़ता है
+- [**Observability**](/docs/observability) - एजेंट द्वारा संचालित टेलीमेट्री (अन्य "क्या हुआ")