@agent-native/core 0.76.5 → 0.76.6

package/corpus/core/docs/content/locales/hi-IN/native-chat-ui.md

@@ -0,0 +1,321 @@
+---
+title: "मूल चैट UI"
+description: "एक्शन-घोषित देशी चैट रेंडरर्स, पुन: प्रयोज्य डेटाटेबल/डेटाचार्ट आउटपुट, और BYO एजेंट रनटाइम को Agent-Native चैट से कैसे कनेक्ट होना चाहिए।"
+---
+
+# मूल चैट UI
+
+नेटिव चैट UI प्रथम-पक्ष एजेंट आउटपुट के लिए इन-ऐप रेंडरिंग पथ है। एक
+एक्शन रिटर्न संरचित JSON, चैट रनटाइम एक स्पष्ट विजेट को पहचानता है
+विभेदक, और `<AssistantChat>` एक वास्तविक React घटक प्रस्तुत करता है
+बातचीत। आप
+सामान्य ऐप चैट।
+
+जब उपयोगकर्ता को आउटपुट का निरीक्षण करना चाहिए कि एजेंट कहां है तो मूल चैट UI का उपयोग करें
+पहले से ही बोल रहा हूँ: क्वेरी परिणाम, प्रतिक्रिया अंतर्दृष्टि, सेटअप सारांश,
+अनुमोदन/अस्वीकृति नियंत्रण, या ऐप दृश्यों में लिंक। [MCP Apps](/docs/mcp-apps)
+जब किसी बाहरी होस्ट जैसे Claude, ChatGPT, Copilot, या कर्सर को रेंडर करना चाहिए
+आपके ऐप से एक इनलाइन रूट।
+
+```an-diagram title="The native render path" summary="An action returns JSON; the runtime matches an explicit widget discriminant or chatUI.renderer; AssistantChat mounts a real React component. No iframe, no HTML execution."
+{
+  "html": "<div class=\"diagram-render\"><div class=\"diagram-node\">Action runs<br><small class=\"diagram-muted\">returns structured JSON</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\">Match</span><small class=\"diagram-muted\">explicit widget &middot; chatUI.renderer</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-box\">&lt;AssistantChat&gt;<br><small class=\"diagram-muted\">mounts a React widget</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card col\"><div class=\"diagram-pill ok\">DataTable</div><div class=\"diagram-pill ok\">DataChart</div><div class=\"diagram-pill ok\">DataInsights</div></div></div>",
+  "css": ".diagram-render{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-render .center{display:flex;flex-direction:column;align-items:center;gap:4px;padding:14px}.diagram-render .col{display:flex;flex-direction:column;gap:6px;padding:12px}.diagram-render .diagram-arrow{font-size:22px;line-height:1}"
+}
+```
+
+## कार्रवाई-घोषित विजेट {#action-declared-widgets}
+
+मूल पथ के दो स्पष्ट भाग हैं:
+
+- `outputSchema` क्रिया की प्रतिक्रिया आकृति को मान्य करता है।
+- `chatUI.renderer` मान्य परिणाम के लिए मूल React रेंडरर का चयन करता है।
+
+अंतर्निहित डेटा रेंडरर्स `widget` प्लस के साथ एक सादे JSON परिणाम का उपयोग करते हैं
+मिलान पेलोड:
+
+| विजेट             | आवश्यक पेलोड                | के रूप में प्रस्तुत करता है                           |
+| ----------------- | --------------------------- | ----------------------------------------------------- |
+| `"data-table"`    | `table`                     | एक मूल, पुन: प्रयोज्य डेटा तालिका                     |
+| `"data-chart"`    | `chartSeries`               | एक मूल बार, रेखा, या क्षेत्र चार्ट                    |
+| `"data-insights"` | `table` और/या `chartSeries` | चार्ट/टेबल आउटपुट के साथ एक संयुक्त अंतर्दृष्टि कार्ड |
+
+सर्वर actions को सर्वर-सुरक्षित सहायक और स्कीमा आयात करना चाहिए
+`@agent-native/core/data-widgets`; क्लाइंट कोड
+`@agent-native/core/client/chat` या `@agent-native/core/client`.
+
+```ts
+import { defineAction } from "@agent-native/core/action";
+import { ACTION_CHAT_UI_DATA_INSIGHTS_RENDERER } from "@agent-native/core/action-ui";
+import {
+  createDataInsightsWidgetResult,
+  dataInsightsWidgetResultSchema,
+} from "@agent-native/core/data-widgets";
+
+export default defineAction({
+  description: "Analyze form responses.",
+  readOnly: true,
+  outputSchema: dataInsightsWidgetResultSchema,
+  chatUI: {
+    renderer: ACTION_CHAT_UI_DATA_INSIGHTS_RENDERER,
+    title: "Response insights",
+  },
+  run: async () =>
+    createDataInsightsWidgetResult({
+      title: "Response insights",
+      display: {
+        title: "42 responses",
+        description: "Completion rate rose this week.",
+        primaryAction: {
+          label: "Open response insights",
+          href: "/response-insights",
+        },
+      },
+      chartSeries: {
+        type: "bar",
+        title: "Responses by day",
+        xKey: "day",
+        series: [{ key: "responses", label: "Responses" }],
+        data: [
+          { day: "Mon", responses: 8 },
+          { day: "Tue", responses: 13 },
+        ],
+      },
+      table: {
+        title: "Top answers",
+        columns: [
+          { key: "answer", label: "Answer" },
+          { key: "count", label: "Count", align: "right" },
+        ],
+        rows: [
+          { answer: "Yes", count: 31 },
+          { answer: "No", count: 11 },
+        ],
+        totalRows: 2,
+      },
+    }),
+});
+```
+
+```an-callout
+{
+  "tone": "success",
+  "body": "The renderer only takes over when the action declares `chatUI` **or** the result carries an explicit known `widget` discriminant. It never shape-infers arbitrary objects and never executes HTML or JavaScript from tool results — so a native widget can't become an injection vector."
+}
+```
+
+जब कोई उपयोगकर्ता चार्ट, ग्राफ़, तालिका, प्रवृत्ति, या कॉम्पैक्ट रिपोर्ट, ऐप एजेंट मांगता है
+ऐसी कार्रवाई को प्राथमिकता देनी चाहिए जो इन मूल रेंडरर्स में से किसी एक को घोषित करती हो। अंतिम
+सहायक पाठ संक्षिप्त रहना चाहिए और विजेट को डेटा ले जाने देना चाहिए; कॉपी न करें
+मार्कडाउन तालिका में समान पंक्तियाँ, जब तक कि उपयोगकर्ता स्पष्ट रूप से पाठ न माँगे
+निर्यात.
+
+जब कोई डोमेन कार्रवाई मौजूद नहीं है लेकिन एजेंट ने पहले ही कॉम्पैक्ट पुनर्प्राप्त कर लिया है,
+सच्चा डेटा, यह फ्रेमवर्क को `render-data-widget` एक्शन के साथ कॉल कर सकता है
+वही `data-table`, `data-chart`, या `data-insights` JSON आकार। यह क्रिया केवल
+विजेट को सत्यापित और प्रस्तुत करता है; यह एक डेटा स्रोत नहीं है और इसका उपयोग नहीं किया जाना चाहिए
+प्लेसहोल्डर मेट्रिक्स का आविष्कार करने के लिए।
+
+## डेटाटेबल आउटपुट {#data-table}
+
+`table` जानबूझकर सरल है इसलिए सूची, SQL, विश्लेषण और सेटअप actions कर सकते हैं
+इसे पुन: उपयोग करें:
+
+```ts
+{
+  title?: string;
+  columns: Array<{ key: string; label: string; align?: "left" | "right" }>;
+  rows: Array<Record<string, unknown>>;
+  totalRows?: number;
+  sampledRows?: number;
+  truncated?: boolean;
+}
+```
+
+स्थिर कॉलम कुंजियाँ और JSON-सुरक्षित पंक्ति मान को प्राथमिकता दें। `totalRows` का प्रयोग करें,
+`sampledRows`, और `truncated` जब क्रिया एक बड़े टुकड़े को दिखा रही हो
+परिणाम सेट.
+
+## डेटाचार्ट आउटपुट {#data-chart}
+
+`chartSeries` बिना एजेंट उत्तरों में उपयोग किए जाने वाले सामान्य चार्ट आकारों का समर्थन करता है
+प्रत्येक टेम्प्लेट को अपना स्वयं का चैट रेंडरर भेजना आवश्यक है:
+
+```ts
+{
+  type: "bar" | "line" | "area";
+  title?: string;
+  xKey: string;
+  series: Array<{ key: string; label: string; color?: string }>;
+  data: Array<Record<string, unknown>>;
+  sampled?: boolean;
+}
+```
+
+चार्ट डेटा को संक्षिप्त रखें। बड़े डेटासेट के लिए, क्रिया और लिंक में एकत्र करें
+`display.primaryAction` या कार्रवाई `link` मेटाडेटा के साथ पूर्ण ऐप दृश्य के लिए।
+
+## नेटिव विजेट बनाम MCP ऐप्स {#native-vs-mcp-apps}
+
+नेटिव चैट विजेट और MCP ऐप्स पूरक हैं:
+
+- **नेटिव विजेट** ऐप के अपने चैट रनटाइम के लिए हैं। कार्रवाई का परिणाम है
+  JSON, और फ्रेमवर्क अंतर्निहित React विजेट प्रस्तुत करता है।
+- **MCP ऐप्स** बाहरी होस्ट के लिए हैं। क्रिया `mcpApp` घोषित करती है और आमतौर पर
+  `link`, और होस्ट समर्थित होने पर एक वास्तविक ऐप रूट इनलाइन प्रस्तुत करता है।
+- **गहरे लिंक** सार्वभौमिक फ़ॉलबैक बने हुए हैं। क्रिया `link` या
+  `display.primaryAction` इसलिए CLI क्लाइंट, पुराने MCP होस्ट और सादा ट्रांसक्रिप्ट
+  पाठक संपूर्ण ऐप दृश्य खोल सकते हैं।
+
+जब एक देशी विजेट पेलोड और MCP ऐप्स मेटाडेटा दोनों मौजूद हों, तो इन-ऐप
+चैट मूल विजेट को प्राथमिकता देता है। बाहरी होस्ट MCP ऐप्स संसाधन या
+डीप लिंक फ़ॉलबैक.
+
+## कस्टम देशी रेंडरर्स {#custom-native-renderers}
+
+सटीक रेंडरर आईडी द्वारा उत्पाद-विशिष्ट घटकों को पंजीकृत करें, फिर उस आईडी को घोषित करें
+कार्रवाई पर:
+
+```tsx
+import { registerActionChatRenderer } from "@agent-native/core/client/chat";
+
+registerActionChatRenderer({
+  id: "crm.deal-card",
+  renderer: "crm.deal-card",
+  Component: ({ context }) => <DealCard result={context.resultJson} />,
+});
+```
+
+```ts
+export default defineAction({
+  description: "Show a deal card.",
+  outputSchema: dealCardSchema,
+  chatUI: { renderer: "crm.deal-card" },
+  run: async () => ({ dealId: "deal_123", amount: 42000 }),
+});
+```
+
+प्रथम-पक्ष ऐप UI के लिए इसका उपयोग करें। `mcpApp` में क्रॉस-होस्ट iframe UI रखें, और
+चैट में कच्चे SQL के बजाय टाइप किए गए actions को पढ़ने के पीछे मनमाना क्वेरी निष्पादन।
+
+## BYO एजेंट रनटाइम {#byo-agent-runtimes}
+
+`AgentChatRuntime` चैट शेल के लिए अपना एजेंट लाने का अनुबंध है, और
+यह अनुभाग इसका विहित संदर्भ है। यह आपको एक एजेंट देता है जिसे आपने कहीं और बनाया है
+रखते हुए सामान्यीकृत घटनाओं को Agent-Native की बातचीत UI में स्ट्रीम करें
+साझा कंपोजर, ट्रांसक्रिप्ट रेंडरिंग, टूल कार्ड, अनुमोदन, मूल विजेट,
+और आसपास का ऐप लेआउट। [Drop-in Agent](/docs/drop-in-agent#custom-chat-ui)
+रनटाइम कहानी के लिए यहां ट्यूटोरियल बिंदु, और [Component API](/docs/components#agent-chat-ui)
+प्रत्येक कनेक्टर और एडाप्टर को उसके आयात पथ के साथ सूचीबद्ध करता है; अनुबंध स्वयं
+नीचे वर्णित है।
+
+```an-diagram title="BYO runtime keeps the Agent-Native chat shell" summary="Your external agent streams normalized events through a connector; Agent-Native keeps the composer, transcript, tool cards, approvals, and native widgets."
+{
+  "html": "<div class=\"diagram-byo\"><div class=\"diagram-box\" data-rough>Your agent<br><small class=\"diagram-muted\">OpenAI &middot; Claude &middot; Vercel AI &middot; AG-UI &middot; HTTP</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel center\"><span class=\"diagram-pill accent\">connector</span><small class=\"diagram-muted\">normalized message-* / tool-* events</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card col\"><div class=\"diagram-pill\">&lt;AssistantChat runtime=&hellip; /&gt;</div><small class=\"diagram-muted\">composer &middot; transcript &middot; tool cards</small><small class=\"diagram-muted\">approvals &middot; native widgets</small></div></div>",
+  "css": ".diagram-byo{display:flex;align-items:center;gap:12px;flex-wrap:wrap}.diagram-byo .center{display:flex;flex-direction:column;align-items:center;gap:4px;padding:14px}.diagram-byo .col{display:flex;flex-direction:column;gap:6px;padding:14px}.diagram-byo .diagram-arrow{font-size:22px;line-height:1}"
+}
+```
+
+सभी कनेक्टर `@agent-native/core/client/chat` (और रूट
+`@agent-native/core/client` प्रविष्टि)। जब आपका एजेंट
+एक POST एंडपॉइंट को उजागर कर सकता है जो SSE या NDJSON रनटाइम इवेंट लौटाता है:
+
+```tsx
+import {
+  AssistantChat,
+  createHttpAgentChatRuntime,
+} from "@agent-native/core/client/chat";
+
+const runtime = createHttpAgentChatRuntime({
+  id: "external:mastra",
+  label: "Mastra",
+  endpoint: "/api/mastra/chat",
+  headers: async () => ({
+    Authorization: `Bearer ${await getAgentToken()}`,
+  }),
+});
+
+export function SupportChat() {
+  return <AssistantChat runtime={runtime} threadId="support" />;
+}
+```
+
+यदि आपका एंडपॉइंट पहले से ही एक सामान्य एजेंट प्रोटोकॉल स्ट्रीम करता है, तो मिलान का उपयोग करें
+कनेक्टर और एक कस्टम मैपर लिखना छोड़ें:
+
+```ts
+import {
+  createAgUiChatRuntime,
+  createClaudeAgentChatRuntime,
+  createOpenAIAgentsChatRuntime,
+  createOpenAIResponsesChatRuntime,
+  createVercelAiChatRuntime,
+} from "@agent-native/core/client/chat";
+
+const openAiAgentsRuntime = createOpenAIAgentsChatRuntime({
+  endpoint: "/api/openai-agents/chat",
+});
+
+const openAiResponsesRuntime = createOpenAIResponsesChatRuntime({
+  endpoint: "/api/openai-responses/chat",
+});
+
+const claudeAgentRuntime = createClaudeAgentChatRuntime({
+  endpoint: "/api/claude-agent/chat",
+});
+
+const vercelAiRuntime = createVercelAiChatRuntime({
+  endpoint: "/api/vercel-ai/chat",
+});
+
+const agUiRuntime = createAgUiChatRuntime({
+  endpoint: "/api/ag-ui/chat",
+});
+```
+
+समापन बिंदु सामान्यीकृत घटना आकार को सीधे स्ट्रीम कर सकता है:
+
+```text
+data: {"type":"message-start","message":{"id":"m1","role":"assistant","content":[]}}
+data: {"type":"message-delta","messageId":"m1","delta":{"type":"text","text":"Hello"}}
+data: {"type":"tool-start","toolCall":{"id":"t1","name":"query","input":{"q":"forms"}}}
+data: {"type":"tool-done","toolCallId":"t1","toolName":"query","status":"completed","resultText":"34 rows"}
+data: {"type":"done","reason":"complete"}
+```
+
+बहुत सरल एजेंटों के लिए, एक JSON प्रतिक्रिया `{ "text": "..." }` स्वीकार की जाती है और
+एकल सहायक संदेश में परिवर्तित। अमीर एजेंटों के लिए, स्ट्रीम करें
+`message-*`, `tool-*`, `approval-request`, `status`, `artifact`, `file`,
+`usage`, `error`, और `done` इवेंट। टूल परिणाम `mcpApp` या
+`chatUI` मेटाडेटा, इसलिए एक्शन-घोषित देशी विजेट अभी भी बिना प्रस्तुत होते हैं
+iframes.
+
+जब आप रनटाइम ऑब्जेक्ट के रूप में अंतर्निहित Agent-Native ट्रांसपोर्ट चाहते हैं, तो इसका उपयोग करें:
+
+```ts
+import { createAgentNativeChatRuntime } from "@agent-native/core/client/chat";
+
+const runtime = createAgentNativeChatRuntime({
+  threadId: "forms-chat",
+  mode: "act",
+});
+```
+
+`<AssistantChat createAdapter={...} />` का उपयोग केवल तभी करें जब आपको पूर्ण की आवश्यकता हो
+assistant-ui adapter control. Use `PromptComposer` by itself when your product
+संपूर्ण बाहरी प्रतिलेख का स्वामी है और केवल Agent-Native का कंपोजर चाहता है
+फ़ील्ड.
+
+OpenAI, AG-UI, Claude एजेंट SDK, और वर्सेल AI SDK स्ट्रीम मानक का उपयोग कर सकते हैं
+कनेक्टर सहायक। ACP कोडिंग-एजेंट/एडिटर इंटरऑपरेबिलिटी बनी हुई है,
+अंतिम उपयोगकर्ताओं के लिए सामान्य ऐप-चैट रनटाइम। यहां A2UI के समर्थित होने का दावा नहीं किया गया है;
+यदि यह परिपक्व हो जाता है, तो इसे इसी स्पष्ट रनटाइम/विजेट अनुबंध में अनुकूलित होना चाहिए।
+
+## संबंधित दस्तावेज़ {#related-docs}
+
+- [Actions](/docs/actions) - उन ऑपरेशनों को परिभाषित करें जो मूल विजेट डेटा लौटाते हैं।
+- [Agent Surfaces](/docs/agent-surfaces) - तय करें कि आपको हेडलेस, चैट, साइडकार या पूर्ण ऐप की आवश्यकता है या नहीं।
+- [Drop-in Agent](/docs/drop-in-agent) - मानक चैट रनटाइम को माउंट करने के लिए ट्यूटोरियल।
+- [Component API](/docs/components) - चैट लेयर्स, रनटाइम और टूल रेंडरर्स के लिए प्रति-निर्यात API मानचित्र।
+- [MCP Apps](/docs/mcp-apps) - बाहरी MCP होस्ट के लिए इनलाइन UI।
+- [Key Concepts](/docs/key-concepts#protocols) - प्रोटोकॉल स्थिति और स्थिति।

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

@@ -0,0 +1,231 @@
+---
+title: "सूचनाएं"
+description: "प्लग करने योग्य चैनलों के साथ इन-ऐप सूचनाएं - इनबॉक्स, वेबहुक, या कस्टम"
+---
+
+# सूचनाएँ
+
+एक कार्य, अनेक गंतव्य। किसी भी सर्वर-साइड कोड से `notify()` पर कॉल करें - एक एक्शन, एक ऑटोमेशन, एक प्लगइन - और ईवेंट उपयोगकर्ता के इन-ऐप इनबॉक्स में आ जाता है और प्रत्येक पंजीकृत चैनल पर पहुंच जाता है। एक बेल-एंड-ड्रॉपडाउन UI घटक के साथ भेजा जाता है जिसे होस्ट टेम्पलेट अपने हेडर में छोड़ देता है।
+
+सूचनाएं ऐप के बेल इनबॉक्स (प्लस वेबहुक फैन-आउट) में एकतरफा अलर्ट हैं। Slack/ईमेल/टेलीग्राम/व्हाट्सएप से अपने एजेंट के साथ बातचीत करने के लिए, [Messaging](/docs/messaging) देखें।
+
+```ts
+import { notify } from "@agent-native/core/notifications";
+
+await notify(
+  { severity: "info", title: "Booking confirmed", body: "Jane at 3pm" },
+  { owner: "steve@builder.io" },
+);
+```
+
+```an-diagram title="One call, many destinations" summary="notify() always writes the owner-scoped inbox row, fans out to every registered channel in parallel (best-effort), then emits notification.sent on the event bus."
+{
+  "html": "<div class=\"diagram-notify\"><div class=\"diagram-node\">notify(input, { owner })<br><small class=\"diagram-muted\">any server code &middot; action, automation, plugin</small></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-panel fan\" data-rough><div class=\"fan-row\"><span class=\"diagram-pill accent\">inbox</span><div class=\"diagram-box\" data-rough>notifications table &rarr; bell UI<br><small class=\"diagram-muted\">always on &middot; owner-scoped</small></div></div><div class=\"fan-row\"><span class=\"diagram-pill\">webhook</span><div class=\"diagram-box\" data-rough>POST JSON to NOTIFICATIONS_WEBHOOK_URL<br><small class=\"diagram-muted\">best-effort</small></div></div><div class=\"fan-row\"><span class=\"diagram-pill\">custom</span><div class=\"diagram-box\" data-rough>registerNotificationChannel(...)<br><small class=\"diagram-muted\">best-effort &middot; runs in parallel</small></div></div></div><div class=\"diagram-arrow diagram-muted\" aria-hidden=\"true\">&rarr;</div><div class=\"diagram-card\"><span class=\"diagram-pill ok\">notification.sent</span><small class=\"diagram-muted\">event bus &middot; automations can chain</small></div></div>",
+  "css": ".diagram-notify{display:flex;align-items:center;gap:14px;flex-wrap:wrap}.diagram-notify .fan{display:flex;flex-direction:column;gap:10px;padding:14px}.diagram-notify .fan-row{display:flex;align-items:center;gap:10px}.diagram-notify .diagram-card{display:flex;flex-direction:column;gap:6px;padding:12px 14px}.diagram-notify .diagram-arrow{font-size:22px;line-height:1}"
+}
+```
+
+## गंभीरताएं {#severities}
+
+| गंभीरता    | के लिए उपयोग करें                              |
+| ---------- | ---------------------------------------------- |
+| `info`     | पुष्टि, प्रगति मील के पत्थर, FYI               |
+| `warning`  | कुछ ऐसा जिसे उपयोगकर्ता को जल्द ही देखना चाहिए |
+| `critical` | तत्काल ध्यान देने की आवश्यकता है               |
+
+गंभीरता ड्रॉपडाउन में बैज स्टाइल को चलाती है और चैनलों के माध्यम से पारित की जाती है ताकि वे तात्कालिकता पर शाखा लगा सकें।
+
+## अंतर्निहित चैनल {#channels}
+
+| चैनल      | डिलीवरी                                         | आवश्यकता है                                           |
+| --------- | ----------------------------------------------- | ----------------------------------------------------- |
+| `inbox`   | `notifications` तालिका पर कायम रहता है; घंटी UI | हमेशा चालू - आदिम का हिस्सा।                          |
+| `webhook` | POST JSON से कॉन्फ़िगर URL                      | `NOTIFICATIONS_WEBHOOK_URL` env var स्टार्टअप पर सेट। |
+
+वेबहुक चैनल मालिक के तदर्थ [secrets](/docs/security) के विरुद्ध URL और `NOTIFICATIONS_WEBHOOK_AUTH` दोनों में `${keys.NAME}` संदर्भों का समाधान करता है, इसलिए कच्चा मान कभी भी एजेंट के संदर्भ में प्रवेश नहीं करता है। प्रति-कुंजी URL अनुमति सूचियाँ लागू की जाती हैं - वही नियम जो ऑटोमेशन `web-request` टूल उपयोग करता है।
+
+```an-diagram title="Channels and severity" summary="inbox is always on; webhook needs an env var; custom channels register at startup. Severity drives badge styling and is passed through to every channel."
+{
+  "html": "<div class=\"diagram-channels\"><div class=\"diagram-panel col\" data-rough><strong>Channels</strong><div class=\"diagram-box\" data-rough>inbox<br><small class=\"diagram-muted\">always on &mdash; part of the primitive</small></div><div class=\"diagram-box\" data-rough>webhook<br><small class=\"diagram-muted\">needs NOTIFICATIONS_WEBHOOK_URL</small></div><div class=\"diagram-box\" data-rough>custom<br><small class=\"diagram-muted\">registerNotificationChannel()</small></div></div><div class=\"diagram-panel col\" data-rough><strong>Severity drives the badge</strong><div class=\"sev-row\"><span class=\"diagram-pill\">info</span><span class=\"diagram-muted\">confirmations, FYI</span></div><div class=\"sev-row\"><span class=\"diagram-pill warn\">warning</span><span class=\"diagram-muted\">look at soon</span></div><div class=\"sev-row\"><span class=\"diagram-pill accent\">critical</span><span class=\"diagram-muted\">needs immediate attention</span></div></div></div>",
+  "css": ".diagram-channels{display:flex;gap:16px;flex-wrap:wrap;align-items:flex-start}.diagram-channels .col{display:flex;flex-direction:column;gap:10px;padding:14px;min-width:240px}.diagram-channels .sev-row{display:flex;align-items:center;gap:10px}"
+}
+```
+
+## API {#api}
+
+### `notify(input, meta)` {#notify}
+
+एक सूचना वितरित करें. जब तक स्पष्ट रूप से बाहर न किया जाए, यह हमेशा इनबॉक्स में बना रहता है; अतिरिक्त पंजीकृत चैनल समानांतर, सर्वोत्तम प्रयास में चलते हैं।
+
+```ts
+await notify(
+  {
+    severity: "critical",
+    title: "Database offline",
+    body: "Primary dropped connections",
+    metadata: { runbookUrl: "https://runbooks/db-offline" },
+    channels: ["inbox", "webhook"], // optional allowlist; omit to run all
+  },
+  { owner: "ops@company.com" },
+);
+```
+
+`meta.owner` आवश्यक है - अधिसूचना को सीमित करता है ताकि केवल वह उपयोगकर्ता ही इसे घंटी में देख सके।
+
+### `registerNotificationChannel(channel)` {#register}
+
+किसी भी सर्वर प्लगइन से एक कस्टम चैनल पंजीकृत करें।
+
+```ts
+import { registerNotificationChannel } from "@agent-native/core/notifications";
+
+registerNotificationChannel({
+  name: "slack-ops",
+  async deliver(input, meta) {
+    await fetch(process.env.OPS_SLACK_WEBHOOK!, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        text: `*${input.severity.toUpperCase()}* — ${input.title}\n${input.body ?? ""}`,
+        owner: meta.owner,
+      }),
+    });
+  },
+});
+```
+
+चैनल के नाम अद्वितीय हैं - पुनः पंजीकरण करने से पिछला चैनल बदल जाता है। `deliver()` सर्वोत्तम प्रयास है; लॉग फेंकने से त्रुटि उत्पन्न होती है लेकिन अन्य चैनल या इनबॉक्स पंक्ति अवरुद्ध नहीं होती है।
+
+### सूचीबद्ध करना और पढ़ना {#read}
+
+```ts
+import {
+  listNotifications,
+  countUnread,
+  markNotificationRead,
+  markAllNotificationsRead,
+  deleteNotification,
+} from "@agent-native/core/notifications";
+
+const rows = await listNotifications("steve@builder.io", {
+  unreadOnly: true,
+  limit: 50,
+});
+const unread = await countUnread("steve@builder.io");
+await markNotificationRead(rows[0].id, "steve@builder.io");
+await markAllNotificationsRead("steve@builder.io");
+await deleteNotification(rows[0].id, "steve@builder.io");
+```
+
+प्रत्येक फ़ंक्शन मालिक के दायरे वाला है - कोई क्रॉस-यूज़र नहीं पढ़ता है, कोई क्रॉस-यूज़र लिखता नहीं है।
+
+## नोटिफ़िकेशनचैनल इंटरफ़ेस {#channel-interface}
+
+```ts
+interface NotificationChannel {
+  name: string;
+  deliver(
+    input: NotificationInput,
+    meta: NotificationMeta,
+  ): void | Promise<void>;
+}
+
+interface NotificationInput {
+  severity: "info" | "warning" | "critical";
+  title: string;
+  body?: string;
+  metadata?: Record<string, unknown>;
+  channels?: string[];
+}
+
+interface NotificationMeta {
+  owner: string;
+}
+```
+
+## HTTP API {#http}
+
+कोर-रूट्स प्लगइन द्वारा `/_agent-native/notifications/*` पर माउंट किया गया। सभी रूट प्रमाणित सत्र के ईमेल के दायरे में हैं।
+
+| विधि     | पथ                                                  |
+| -------- | --------------------------------------------------- |
+| `GET`    | `/_agent-native/notifications?unread=true&limit=50` |
+| `GET`    | `/_agent-native/notifications/count`                |
+| `POST`   | `/_agent-native/notifications/:id/read`             |
+| `POST`   | `/_agent-native/notifications/read-all`             |
+| `DELETE` | `/_agent-native/notifications/:id`                  |
+
+```an-api title="List notifications" summary="The route behind listNotifications() — scoped to the authenticated session's email."
+{
+  "method": "GET",
+  "path": "/_agent-native/notifications?unread=true&limit=50",
+  "summary": "List recent notifications for the current user",
+  "auth": "Authenticated session; results are scoped to the session's email.",
+  "params": [
+    { "name": "unread", "in": "query", "type": "boolean", "required": false, "description": "When true, returns only unread notifications." },
+    { "name": "limit", "in": "query", "type": "number", "required": false, "description": "Max rows to return." }
+  ],
+  "responses": [
+    { "status": "200", "description": "Owner-scoped notification rows, newest first." }
+  ]
+}
+```
+
+## UI घटक {#ui}
+
+```tsx
+import { NotificationsBell } from "@agent-native/core/client/notifications";
+
+export function HeaderBar() {
+  return (
+    <header className="flex items-center gap-2">
+      {/* … */}
+      <NotificationsBell browserNotifications />
+    </header>
+  );
+}
+```
+
+अपठित बैज के साथ बेल आइकन। क्लिक करने से हाल की सूचनाओं का एक ड्रॉपडाउन खुल जाता है। शेडसीएन सिमेंटिक टोकन का उपयोग करता है, होस्ट टेम्पलेट की लाइट/डार्क थीम के अनुकूल होता है।
+
+प्रत्येक नए अपठित आइटम के लिए सिस्टम `new Notification(...)` पॉपअप को फायर करने के लिए `browserNotifications` पास करें - यह तब उपयोगी होता है जब उपयोगकर्ता का टैब पृष्ठभूमि में होता है। जब तक उपयोगकर्ता अनुमति नहीं देता तब तक ड्रॉपडाउन एक "सक्षम करें" संकेत प्रस्तुत करता है; अधिसूचना `tag` फ़ील्ड के माध्यम से प्रति-आईडी डुप्लिकेट को रोका जाता है।
+
+## एजेंट उपकरण {#agent-tools}
+
+प्रत्येक टेम्पलेट में एक एकल `manage-notifications` टूल पंजीकृत है। `action` पैरामीटर ऑपरेशन का चयन करता है:
+
+| कार्रवाई | पैरामीटर                                                                  | उद्देश्य                                                     |
+| -------- | ------------------------------------------------------------------------- | ------------------------------------------------------------ |
+| `send`   | `severity` (आवश्यक), `title` (आवश्यक), `body`, `metadataJson`, `channels` | उपयोगकर्ता के इनबॉक्स और पंजीकृत चैनलों पर एक अधिसूचना भेजें |
+| `list`   | `unreadOnly`, `limit` (अधिकतम 200, डिफ़ॉल्ट 20)                           | संदर्भ के लिए हाल की सूचनाओं की सूची बनाएं                   |
+
+ऑटोमेशन ([Automations](/docs/automations) देखें) अपने शरीर में `action=send` के साथ `manage-notifications` को कॉल कर सकते हैं - यह किसी बाहरी घटना को उपयोगकर्ता-दृश्य चेतावनी में बदलने के लिए विहित पैटर्न है।
+
+## इवेंट बस {#event-bus}
+
+प्रत्येक सफल डिलीवरी [event bus](/docs/automations#event-bus) पर `notification.sent` उत्सर्जित करती है:
+
+```json
+{
+  "notificationId": "n-123",
+  "severity": "critical",
+  "title": "DB offline",
+  "body": "Primary dropped connections",
+  "deliveredChannels": ["inbox", "webhook"]
+}
+```
+
+ऑटोमेशन इसे बंद कर सकता है - उदाहरण के लिए _"यदि कोई महत्वपूर्ण अधिसूचना सक्रिय होती है, तो पेज ऑन-कॉल भी करें।"_
+
+## यह कैसे काम करता है {#internals}
+
+- **मालिक का दायरा** - प्रत्येक पंक्ति में एक `owner` कॉलम होता है; प्रत्येक क्वेरी इस पर फ़िल्टर होती है; प्रत्येक मार्ग प्रमाणित सत्र के ईमेल का उपयोग करता है। उपयोगकर्ता कभी भी एक-दूसरे की सूचनाएं नहीं देखते हैं।
+- **पोल एकीकरण** - प्रत्येक उत्परिवर्तन `recordChange()` को कॉल करता है इसलिए [`useDbSync`](/docs/client) का उपयोग करने वाले टेम्पलेट बिना किसी अतिरिक्त वायरिंग के स्वतः-अमान्य हो जाते हैं।
+- **सर्वोत्तम प्रयास फैन-आउट** - चैनल त्रुटियां पकड़ी जाती हैं और लॉग की जाती हैं; एक असफल चैनल दूसरों को या इनबॉक्स लिखने को ब्लॉक नहीं करता है।
+- **आग लगाओ और भूल जाओ** - `notify()` इनबॉक्स लेखन पूरा होने के बाद वापस आता है; कस्टम चैनल पृष्ठभूमि में चलते हैं।
+
+## आगे क्या है
+
+- [**Automations**](/docs/automations) - `notify()` का सबसे आम कॉलर
+- [**Security**](/docs/security) - `${keys.NAME}` प्रतिस्थापन जो वेबहुक चैनल को शक्ति प्रदान करता है
+- [**Server plugins**](/docs/server) - जहां कस्टम चैनल स्टार्टअप पर पंजीकृत होते हैं