@agent-native/core 0.84.35 → 0.84.37

package/docs/content/locales/hi-IN/getting-started.mdx

@@ -1,259 +1,193 @@
 ---
-title: "आरंभ करना"
-description: "एक एजेंट ऐप बनाएं, निर्देशों, skills और actions को समझें, फिर एजेंट को उसकी पहली कार्रवाई को कॉल करते हुए देखें।"
+title: "शुरुआत"
+description: "Chat से शुरू होने वाली agentic app बनाएं, action जोड़ें, structured results inline render करें, और फिर agent के खोलने योग्य persistent page तक बढ़ाएं."
 ---
 
-# आरंभ करना
-
-Agent-Native ऐप्स एक AI एजेंट और आपके UI को समान actions, डेटा और देते हैं
-स्थिति. एक बुनियादी एजेंट उन निर्देशों से बनता है जो उसे निर्देशित करते हैं, skills जो सिखाते हैं
-दोहराने योग्य व्यवहार, और actions जो इसे वास्तविक कार्य करने देता है।
-
-**शुरू करने के लिए एक संपूर्ण ऐप चाहते हैं?** हमारे समृद्ध टेम्पलेट्स में से एक को क्लोन करें -
-[Chat](/docs/template-chat), [Mail](/docs/template-mail),
-[Calendar](/docs/template-calendar), [Content](/docs/template-content),
-[Analytics](/docs/template-analytics), और [many more](/docs/cloneable-saas) —
-प्रत्येक पूर्ण-विशेषताओं वाला ऐप जिसे आप अनुकूलित करते हैं।
-
-शुरुआत से निर्माण? सामने एकमात्र विकल्प यह है कि क्या आप UI —
-इसके बाद सब कुछ (निर्देश लिखना, skills जोड़ना, actions को परिभाषित करना, चलाना
-एजेंट) किसी भी तरह से एक ही है।
-
-<FileTree
-  id="doc-block-s0hkyy"
-  title={"एक बुनियादी Agent-Native agent"}
-  entries={[
-    {
-      path: "AGENTS.md",
-      note: "always-on instructions: purpose, rules, tone, और agent क्या कर सकता है उसका map",
-    },
-    {
-      path: ".agents/skills/customer-research/SKILL.md",
-      note: "task match होने पर agent जो reusable playbook load करता है",
-    },
-    {
-      path: "actions/summarize-week.ts",
-      note: "typed code जिसे agent, UI, CLI, HTTP, MCP, A2A, jobs, और webhooks चला सकते हैं",
-    },
-  ]}
-/>
-
-यह सच है चाहे आप चैट UI से शुरू करें, एक हेडलेस एजेंट से, या एक पूर्ण ऐप से।
-UI सतह को बदलता है; निर्देश, skills, और actions एजेंट को इसका
-मार्गदर्शन और व्यवहार.
-
-## 1. अपना ऐप बनाएं
-
-आपको [Node.js 22+](https://nodejs.org) और [pnpm](https://pnpm.io) की आवश्यकता होगी।
-
-बिना किसी झंडे के `create` चलाएं और यह पूछता है कि आप कैसे शुरू करना चाहते हैं (एक पूर्ण टेम्पलेट,
-चैट, या हेडलेस) किसी भी अन्य चीज़ से पहले:
+# शुरुआत
 
-```bash
-npx @agent-native/core@latest create my-app
-```
+Agent-Native agentic applications बनाने के लिए है: AI agent और UI वही [actions](/docs/actions), SQL data और application state साझा करते हैं. मुख्य रास्ता headless agent से नहीं, बल्कि Chat app से शुरू होता है ताकि उपयोगकर्ता agent से तुरंत बात कर सकें.
+
+काम का क्रम:
+
+1. Chat app बनाएं.
+2. एक action जोड़ें.
+3. action result को chat में native inline UI के रूप में render करें.
+4. data को SQL में persist करें.
+5. ऐसा page जोड़ें जिसे visual inspection ज़रूरी होने पर agent खोल सके.
 
-या प्रॉम्प्ट को छोड़ने के लिए फ़्लैग पास करें:
+## 1. Chat app बनाएं {#create-your-app}
 
-**UI चाहते हैं?** चैट टेम्पलेट से प्रारंभ करें। आपको एक वर्किंग एजेंट और एक
-अनुकूलन योग्य चैट UI, और आपके द्वारा जोड़ी गई प्रत्येक क्रिया स्वचालित रूप से इसमें दिखाई देती है:
+[Node.js 22+](https://nodejs.org) और [pnpm](https://pnpm.io) चाहिए.
 
 ```bash
 npx @agent-native/core@latest create my-app --template chat
+cd my-app
+pnpm install
+pnpm dev
 ```
 
-**सिर्फ बिना सिर वाला आदिम?** बिना सिर के शुरू करें - वही actions और एजेंट
-लूप, कोई UI शेल नहीं:
-
-```bash
-npx @agent-native/core@latest create my-agent --headless
+इस template में durable chat threads, auth, live sync, `actions/` directory, standard `view-screen` और `navigate` actions, और extend करने योग्य React app शामिल है.
+
+## 2. action जोड़ें {#add-an-action}
+
+Action वह typed operation है जिसे agent और UI दोनों call करते हैं. इस flow के लिए `actions/analyze-responses.ts` बनाएं: यह form responses analyze करता है और custom chat chart के लिए validated shape लौटाता है.
+
+<!-- prettier-ignore -->
+```ts
+// actions/analyze-responses.ts
+import { defineAction } from "@agent-native/core/action";
+import { z } from "zod";
+
+const responseChartResultSchema = z.object({
+  title: z.string(),
+  points: z.array(z.object({ day: z.string(), responses: z.number() })),
+});
+
+export default defineAction({
+  description: "Analyze recent form responses and render a custom chart.",
+  schema: z.object({ 
+    formId: z.string().default("demo") 
+  }),
+  outputSchema: responseChartResultSchema,
+  chatUI: { 
+    renderer: "responses.response-chart", 
+    title: "प्रतिक्रिया चार्ट" 
+  },
+  readOnly: true,
+  run: async ({ formId }) => ({
+    title: `Responses for ${formId}`,
+    points: [{ day: "Mon", responses: 12 }, { day: "Tue", responses: 18 }, { day: "Wed", responses: 24 }, { day: "Thu", responses: 21 }],
+  }),
+});
 ```
 
-फिर आपके द्वारा बनाए गए फ़ोल्डर से इंस्टॉल करें:
+इसे सीधे चलाएं:
 
 ```bash
-cd my-agent # या my-app यदि आपने चैट टेम्पलेट चुना है
-pnpm install
+pnpm action analyze-responses --formId demo
 ```
 
-यहाँ से, दोनों समान हैं।
-
-## 2. एक क्रिया जोड़ें
-
-एक कार्रवाई एक ऐसा ऑपरेशन है जिसे आपका एजेंट - और आपका UI - कॉल कर सकता है। दोनों मचान
-इस उदाहरण के साथ शिप करें:
-
-<AnnotatedCode
-  id="doc-block-it13k1"
-  title={"आपका पहला action"}
-  filename="actions/hello.ts"
-  language="ts"
-  code={
-    'import { defineAction } from "@agent-native/core/action";\nimport { z } from "zod";\n\nexport default defineAction({\n  description: "Local agent से hello कहें।",\n  schema: z.object({\n    name: z.string().default("world"),\n  }),\n  http: { method: "GET" },\n  readOnly: true,\n  run: async ({ name }) => {\n    return { message: `Hello, ${name}!` };\n  },\n});'
-  }
-  annotations={[
-    {
-      lines: "5",
-      label: "टूल विवरण",
-      note: "Agent `description` पढ़कर तय करता है कि इसे tool के रूप में कब call करना है।",
-    },
-    {
-      lines: "6-8",
-      label: "टाइप किया हुआ अनुबंध",
-      note: "एक zod `schema` हर surface से input validate करता है: agent, UI, HTTP, MCP और A2A।",
-    },
-    {
-      lines: "9",
-      label: "HTTP क्रिया",
-      note: "इस action को अपने-आप mount होने वाले HTTP endpoint में शामिल करें।",
-    },
-    {
-      lines: "10",
-      label: "केवल पढ़ने योग्य",
-      note: "`readOnly` action को बिना approval सुरक्षित रूप से call करने योग्य और queries के लिए cacheable बताता है।",
-    },
-    {
-      lines: "11-13",
-      label: "एक implementation",
-      note: "`run` body वही single source of truth है जिसे हर surface चलाता है।",
-    },
-  ]}
-/>
-
-`hello` को अपने डोमेन में पहले वास्तविक ऑपरेशन से बदलें। आप इसे एक बार परिभाषित करें;
-हर सतह इसे उठाती है।
-
-निर्देशन के लिए `AGENTS.md` का उपयोग करें जो हर मोड़ पर लागू होना चाहिए। एक कौशल का प्रयोग करें जब
-एजेंट को पुन: प्रयोज्य वर्कफ़्लो या डोमेन प्रक्रिया की आवश्यकता होती है। किसी क्रिया का उपयोग करें जब
-एजेंट को डेटा पढ़ने, डेटा लिखने, API पर कॉल करने, या
-अनुमोदन करें।
-
-## 3. इसे चलाएं
-
-कार्रवाई को सीधे कॉल करें:
+या browser में agent से पूछें:
 
-```bash
-pnpm action hello --name Steve
-```
+> डेमो फ़ॉर्म की हाल की प्रतिक्रियाओं का विश्लेषण करें.
 
-या एजेंट से इसे आपके लिए कॉल करने के लिए कहें:
+## 3. result को chat में render करें {#render-inline}
 
-```bash
-pnpm agent "Call the hello action for Steve and explain what happened."
-```
+क्योंकि action `outputSchema` और product-specific `chatUI.renderer` declare करता है, transcript structured data को plain text में नहीं बदलता. फिर app startup से उसी exact renderer id के लिए React component register करें, जैसे `app/root.tsx` से `app/chat-renderers.tsx` को एक बार import करके:
 
-यदि आपने चैट टेम्पलेट से शुरुआत की है, तो ऐप चलाएं और उसी एजेंट का उपयोग करें
-ब्राउज़र - यह आपके द्वारा परिभाषित प्रत्येक क्रिया को पहले से ही कॉल कर सकता है:
+<!-- prettier-ignore -->
+```tsx
+import { registerActionChatRenderer, type ToolRendererProps,} from "@agent-native/core/client/chat";
+
+type ResponseChartResult = {
+  title: string;
+  points: Array<{ day: string; responses: number }>;
+};
+
+function ResponseChart({ context }: ToolRendererProps) {
+  const result = context.resultJson as ResponseChartResult;
+  const max = Math.max(...result.points.map((point) => point.responses), 1);
+  return (
+    <section className="rounded-lg border bg-card p-4">
+      <h3 className="text-sm font-medium">{result.title}</h3>
+      <div className="mt-4 flex h-32 items-end gap-2">
+        {result.points.map((point) => (
+          <div key={point.day} className="flex flex-1 flex-col items-center gap-2">
+            <div className="w-full rounded-t bg-primary" style={{ height: `${(point.responses / max) * 100}%` }} />
+            <span className="text-xs text-muted-foreground">{point.day}</span>
+          </div>
+        ))}
+      </div>
+    </section>
+  );
+}
 
-```bash
-pnpm dev
+registerActionChatRenderer({
+  id: "responses.response-chart",
+  renderer: "responses.response-chart",
+  Component: ResponseChart,
+});
 ```
 
-वह एक क्रिया अब चैट UI, CLI, HTTP, MCP, A2A, से उपलब्ध है
-अनुसूचित नौकरियां, और webhooks। एक बार परिभाषित करें, कहीं से भी कॉल करें।
-
-<Diagram id="doc-block-1odbgvm" title={"एक क्रिया, हर सतह"} summary={"एक defineAction फ़ाइल प्रत्येक उपभोक्ता को बिना किसी अतिरिक्त वायरिंग के प्रदान करती है।"}>
-
-```html
-<div class="diagram-fan">
-  <div class="diagram-box" data-rough>defineAction</div>
-  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
-  <div class="diagram-surfaces">
-    <span class="diagram-pill">चैट UI</span><span class="diagram-pill">CLI</span
-    ><span class="diagram-pill">HTTP</span><span class="diagram-pill">MCP</span
-    ><span class="diagram-pill">A2A</span
-    ><span class="diagram-pill">शेड्यूल किए गए जॉब</span
-    ><span class="diagram-pill">Webhooks</span>
-  </div>
-</div>
-```
+Reusable generic outputs के लिए framework built-in `data-chart` और `data-table` renderers भी देता है, साथ ही combined summary/chart/table cards के लिए `data-insights`. देखें [Native Chat UI](/docs/native-chat-ui).
 
-```css
-.diagram-fan {
-  display: flex;
-  align-items: center;
-  gap: 14px;
-  flex-wrap: wrap;
-}
-.diagram-fan .diagram-surfaces {
-  display: flex;
-  flex-wrap: wrap;
-  gap: 8px;
-  max-width: 420px;
-}
-.diagram-fan .diagram-arrow {
-  font-size: 22px;
-  line-height: 1;
-}
-```
+<WireframeBlock id="doc-block-inline-result-wireframe-hi">
+  <Screen
+    surface="desktop"
+    html={
+      "<div style='min-height:340px;box-sizing:border-box;padding:24px;display:flex;justify-content:center;align-items:center;background:var(--wf-bg)'><div style='width:min(530px,100%);display:flex;flex-direction:column;gap:14px'><div class='wf-card' data-rough style='align-self:flex-end;max-width:70%;padding:12px 14px'><strong>User</strong><p style='margin:6px 0 0'>डेमो प्रतिक्रियाओं का विश्लेषण करें.</p></div><div class='wf-card' data-rough style='align-self:flex-start;width:min(370px,100%);padding:14px'><strong>Agent</strong><p class='wf-muted' style='margin:6px 0 12px'>responses.response-chart से रेंडर किया गया.</p><section class='wf-card' data-rough style='padding:14px'><h3 style='margin:0 0 12px;font-size:14px'>प्रतिक्रिया चार्ट</h3><div data-rough='line:bottom' style='height:104px;display:flex;align-items:end;gap:8px;border-bottom:1.4px solid var(--wf-line);padding-bottom:4px'><div style='flex:1;display:flex;flex-direction:column;align-items:center;gap:6px'><div data-rough style='height:38px;width:100%;background:color-mix(in srgb, var(--wf-accent) 24%, transparent);border:1.4px solid var(--wf-accent);border-radius:8px 8px 3px 3px'></div><span class='wf-muted'>सोम</span></div><div style='flex:1;display:flex;flex-direction:column;align-items:center;gap:6px'><div data-rough style='height:62px;width:100%;background:color-mix(in srgb, var(--wf-accent) 30%, transparent);border:1.4px solid var(--wf-accent);border-radius:8px 8px 3px 3px'></div><span class='wf-muted'>मंगल</span></div><div style='flex:1;display:flex;flex-direction:column;align-items:center;gap:6px'><div data-rough style='height:86px;width:100%;background:color-mix(in srgb, var(--wf-accent) 36%, transparent);border:1.4px solid var(--wf-accent);border-radius:8px 8px 3px 3px'></div><span class='wf-muted'>बुध</span></div><div style='flex:1;display:flex;flex-direction:column;align-items:center;gap:6px'><div data-rough style='height:54px;width:100%;background:color-mix(in srgb, var(--wf-accent) 42%, transparent);border:1.4px solid var(--wf-accent);border-radius:8px 8px 3px 3px'></div><span class='wf-muted'>गुरु</span></div></div></section></div></div></div>"
+    }
+  />
+</WireframeBlock>
 
-</Diagram>
+## 4. SQL में data persist करें {#persist-data}
 
-## राज्य का निर्माण हुआ है
+जब result को दोबारा देखना, compare करना या update करना हो, उसे SQL में रखें और reads/writes को actions के पीछे रखें:
 
-हेडलेस का मतलब स्टेटलेस नहीं है। Actions, सत्र, एप्लिकेशन स्थिति, थ्रेड्स,
-रन इतिहास, और क्रेडेंशियल सभी SQL में रहते हैं। स्थानीय रूप से यह SQLite है
-`data/app.db`; उत्पादन में आपने `DATABASE_URL` सेट किया है। देखें
-[Deployment](/docs/deployment).
+Table को framework के portable helpers से define करें, `drizzle-orm/sqlite-core` या `drizzle-orm/pg-core` imports से नहीं:
 
-<Callout id="doc-block-1peunl" tone="info">
+```ts
+// server/db/schema.ts
+import { integer, now, table, text } from "@agent-native/core/db/schema";
 
-**हेडलेस अभी भी एक वास्तविक ऐप है।** ऐप-एजेंट लूप SQL में सत्र, थ्रेड, रन, सेटिंग्स और क्रेडेंशियल्स को बनाए रखता है - यह एक स्टेटलेस प्रॉम्प्ट नहीं है। आप बाद में अपने कार्यों या स्थिति को छुए बिना UI जोड़ सकते हैं।
+export const responseInsights = table("response_insights", {
+  id: text("id").primaryKey(),
+  formId: text("form_id").notNull(),
+  title: text("title").notNull(),
+  summary: text("summary").notNull(),
+  responseCount: integer("response_count").notNull(),
+  createdAt: text("created_at").notNull().default(now()),
+  updatedAt: text("updated_at").notNull().default(now()),
+});
+```
 
-</Callout>
+ये helpers configured SQL backend चुनते हैं, इसलिए वही schema local SQLite और production में Postgres, Turso/libSQL, D1 या किसी supported SQL provider पर चल सकता है.
 
-## UI को अनुकूलित करें
+- `create-response-insight` नया insight लिखता है.
+- `list-response-insights` page के लिए data पढ़ता है.
+- `update-response-insight` record update करता है.
+- `analyze-responses` chat का native widget लौटाता रहता है.
 
-यदि आपने चैट टेम्पलेट से शुरुआत की है, तो संपादित करने के लिए UI आपका है। चैट ही
-`<AgentChatSurface>` घटक पर निर्मित एक छोटा मार्ग है:
+Browser के लिए अलग duplicate REST route न बनाएं; UI और agent को actions साझा करने चाहिए.
 
-```tsx
-// app/routes/_index.tsx
-import { AgentChatSurface } from "@agent-native/core/client";
+## 5. agent के खोलने योग्य page जोड़ें {#add-a-page}
 
-export default function ChatRoute() {
-  return <AgentChatSurface mode="page" className="h-full" />;
-}
-```
+`/response-insights` route जोड़ें और `useActionQuery("list-response-insights")`, `useActionMutation("create-response-insight")` इस्तेमाल करें. यह page SQL state का projection है; data वही actions लिखते हैं.
 
-- **`app/routes/_index.tsx`** — चैट पेज। सुझाव बदलें, रिक्त
-  स्थिति, और लेआउट.
-- **`app/root.tsx`** - ऐप शेल।
-  एजेंट.
-- एजेंट को `<AgentSidebar>` के साथ किसी भी स्क्रीन पर छोड़ें, उस पर हाथ से काम करें
-  `sendToAgentChat()` के साथ बटन, या सीधे
-  `useActionMutation()`.
+<WireframeBlock id="doc-block-response-insights-page-wireframe-hi">
+  <Screen
+    surface="desktop"
+    html={
+      "<main style='min-height:440px;box-sizing:border-box;padding:28px;background:var(--wf-bg)'><section style='max-width:960px;margin:0 auto;display:grid;grid-template-columns:minmax(0,1fr) 260px;gap:16px;align-items:stretch'><section class='wf-card' data-rough style='display:flex;flex-direction:column;gap:16px'><header><h2 style='margin:0 0 4px;font-size:28px'>प्रतिक्रिया insights</h2><p class='wf-muted' style='margin:0'>फ़ॉर्म प्रतिक्रियाओं से agent ने बनाए insights.</p></header><button class='primary' data-rough style='align-self:flex-start'>डेमो फ़ॉर्म विश्लेषित करें</button><section style='display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:12px'><article class='wf-box' data-rough style='padding:12px'><strong>मूल्य निर्धारण थीम</strong><p class='wf-muted' style='margin:8px 0 0'>यूज़र टीम प्लान मांगते हैं.</p></article><article class='wf-box' data-rough style='padding:12px'><strong>ऑनबोर्डिंग ड्रॉप-ऑफ़</strong><p class='wf-muted' style='margin:8px 0 0'>तीन चरणों को ज्यादा स्पष्ट copy चाहिए.</p></article></section><section class='wf-card' data-rough style='display:flex;flex-direction:column;gap:10px'><div class='wf-row wf-box' data-rough style='padding:10px 12px;gap:12px;justify-content:space-between'><strong>डेमो फ़ॉर्म</strong><span class='wf-muted'>42 प्रतिक्रियाओं का विश्लेषण हुआ</span></div><div class='wf-row wf-box' data-rough style='padding:10px 12px;gap:12px;justify-content:space-between'><strong>अगला चरण</strong><span class='wf-muted'>दो draft insights देखें</span></div></section></section><aside class='wf-card' data-rough style='height:100%;box-sizing:border-box;display:flex;flex-direction:column;gap:12px'><strong>चैट</strong><div class='wf-box' data-rough style='align-self:flex-end;max-width:210px;padding:10px 12px'><span class='wf-muted'>आप</span><p style='margin:4px 0 0'>प्रतिक्रिया insights खोलें.</p></div><div class='wf-box' data-rough style='align-self:flex-start;max-width:210px;padding:10px 12px'><span class='wf-muted'>Agent</span><p style='margin:4px 0 0'>प्रतिक्रिया insights खोल दिए.</p></div></aside></section></main>"
+    }
+  />
+</WireframeBlock>
 
-पूर्ण घटक सेट के लिए [Drop-in Agent](/docs/drop-in-agent) देखें, और
-[Native चैट UI](/docs/native-chat-ui) क्रिया परिणामों को तालिकाओं के रूप में प्रस्तुत करने के लिए,
-चार्ट, और सादे पाठ के बजाय टाइप किए गए कार्ड।
+`view-screen` और `navigate` को extend करें ताकि agent current route जान सके और `/response-insights` खोल सके. Results में `href: "/response-insights"` भी हो सकता है, जिससे chat में "प्रतिक्रिया insights खोलें" button दिखे.
 
-**बिना सोचे-समझे शुरू कर दिया और बाद में UI चाहिए?** चैट टेम्पलेट UI ऑन-रैंप है -
-इसकी `app/` परत (React राउटर + Vite) बिल्कुल बिना सिर वाले मचान के समान है
-बाहर निकल जाता है। सबसे साफ कदम चैट
-टेम्पलेट; आपकी `actions/`, एजेंट और SQL स्थिति अपरिवर्तित बनी रहेगी। देखें
-बीच में प्रत्येक सतह के लिए [Agent Surfaces](/docs/agent-surfaces)।
+जब full-page chat app page खोलता है, तो [Agent Surfaces](/docs/agent-surfaces#rich-chat) से `AgentChatSurface`, `AgentSidebar`, `useAgentChatHomeHandoff`, `useAgentChatHomeHandoffLinks` और `chatViewTransition` इस्तेमाल करें ताकि वही thread रखते हुए chat side panel में slide हो जाए.
 
-## परियोजना संरचना
+## Project structure {#project-structure}
 
 ```text
 my-app/
-  actions/         # Agent द्वारा call की जा सकने वाली actions
-  app/             # React फ्रंटएंड (केवल UI templates; headless में हटाया जाता है)
-  server/          # Nitro API सर्वर (routes, plugins)
-  AGENTS.md        # हमेशा लागू रहने वाले agent instructions
-  .agents/         # ज़रूरत पड़ने पर agent द्वारा लाए जा सकने वाले skills
-  data/app.db      # DATABASE_URL न होने पर local SQLite state
+  actions/         # Agent और UI से कॉल किए जा सकने वाले operations
+  app/             # React routes, pages, और chat surfaces
+  server/          # Nitro server और SQL schema
+  AGENTS.md        # App agent के लिए हमेशा सक्रिय instructions
+  .agents/         # ज़रूरत पड़ने पर agent जिन skills को लोड करता है
+  data/app.db      # DATABASE_URL सेट न होने पर local SQLite state
 ```
 
-## आगे कहां जाना है
-
-- **[Key Concepts](/docs/key-concepts)** - मुख्य वास्तुकला: SQL, actions,
-  सिंक, और संदर्भ जागरूकता।
-- **[Actions](/docs/actions)** - पूर्ण क्रिया API: स्कीमा, HTTP, प्रमाणीकरण, और
-  अनुमोदन.
-- **[Agent Surfaces](/docs/agent-surfaces)** - हेडलेस, चैट, एंबेडेड साइडकार,
-  और पूरा ऐप।
-- **[Drop-in Agent](/docs/drop-in-agent)** - एजेंट चैट को किसी भी React ऐप में जोड़ें।
-- **[Deployment](/docs/deployment)** — अपने ऐप को अपने डोमेन पर रखें।
-- **[FAQ](/docs/faq)** — सेटअप और उत्पाद प्रश्न।
+## Analytics के लिए मजबूत starting point चाहिए? {#analytics-starting-point}
+
+ऊपर वाला प्रतिक्रिया insights example जानबूझकर छोटा है ताकि framework की pieces साफ दिखें. अगर आप वास्तविक analytics product बना रहे हैं, तो [Analytics](/docs/template-analytics) से शुरू करें. यह robust starting point है: अपने providers connect करें, existing dashboards और agent actions इस्तेमाल करें, फिर वहीं से customize करें.
+
+## आगे क्या {#next}
+
+- **[Actions](/docs/actions)** — schemas, auth, approvals, hooks और transport.
+- **[Native Chat UI](/docs/native-chat-ui)** — action results को tables, charts और typed cards के रूप में render करें.
+- **[Chat Template](/docs/template-chat)** — न्यूनतम chat-first app.
+- **[Analytics Template](/docs/template-analytics)** — robust analytics app starting point; providers connect करें और customize करें.
+- **[Context Awareness](/docs/context-awareness)** — `view-screen`, `navigate`, route state और selected objects.
+- **[Agent Surfaces](/docs/agent-surfaces)** — chat, inline UI, app pages, embedded sidecars, automation और external agents.

package/docs/content/locales/hi-IN/pure-agent-apps.mdx

@@ -1,16 +1,11 @@
 ---
-title: "प्योर-एजेंट ऐप्स"
-description: "ऐप्स जहां एजेंट संपूर्ण उत्पाद है: ऐप-एजेंट लूप सामने का दरवाजा है, और UI केवल तब जोड़ा जाता है जब मनुष्यों को इसकी आवश्यकता होती है।"
+title: "Automation-First Apps"
+description: "scheduled jobs, queues, scripts, integration workers और external agents के लिए no-browser Agent-Native apps."
 ---
 
-# प्योर-एजेंट ऐप्स
+# Automation-First Apps
 
-एक प्योर-एजेंट ऐप एजेंट-नेटिव का न्यूनतम अंत है: ऐप-एजेंट लूप
-उत्पाद, डैशबोर्ड नहीं। आप टर्मिनल, Slack, ईमेल, a
-निर्धारित नौकरी, अन्य एजेंट, या चैट - "मेरे अपठित ईमेल को संक्षेप में प्रस्तुत करें," "पोस्ट करें
-दैनिक मेट्रिक्स Slack के लिए" - और एजेंट कार्य करता है और जहां कहीं भी परिणाम लौटाता है
-के अंतर्गत आता है। यह अभी भी एक वास्तविक ऐप है: actions, सत्र, ऐप स्थिति, इतिहास,
-सेटिंग्स, क्रेडेंशियल और शेयर रिकॉर्ड सभी SQL में रहते हैं।
+Automation-first app scheduled jobs, queues, scripts, integration workers और external agents के लिए no-browser Agent-Native app है. यह Getting Started का default path नहीं है, लेकिन जब workflow को अभी page की ज़रूरत नहीं होती तब उपयोगी है. यह अभी भी एक वास्तविक app है: actions, sessions, application state, run history, settings, credentials और share records सभी SQL में रहते हैं.
 
 <Diagram id="doc-block-pwjkyy" title={"ऐप-एजेंट लूप सामने का दरवाजा है"} summary={"कई प्रवेश बिंदु SQL-backed क्रियाओं और स्थिति पर एक एजेंट लूप तक पहुंचते हैं; जहां से अनुरोध आया वहां परिणाम वापस आ जाते हैं। यूआई केवल तभी जोड़ा जाता है जब इंसानों को पर्यवेक्षण की आवश्यकता होती है।"}>
 
@@ -66,7 +61,7 @@ description: "ऐप्स जहां एजेंट संपूर्ण
 जब कार्य पृष्ठभूमि में चलता है, तो इस आकृति तक पहुंचें, आउटपुट निकल जाता है
 ऐप, डोमेन वन-शॉट है, या आप प्रोटोटाइप कर रहे हैं। एजेंट को अभी भी UI —
 एक डैशबोर्ड नहीं, बल्कि मनुष्यों के लिए इसकी देखरेख, कॉन्फ़िगर और संचालन करने के लिए एक जगह -
-यही कारण है कि प्योर-एजेंट ऐप्स भी आमतौर पर अंतर्निहित चैट शेल को माउंट करते हैं।
+यही कारण है कि automation-first apps भी आमतौर पर built-in chat shell mount करते हैं.
 
 यह **बिना सिर** उत्पाद का आकार है। संपूर्ण निर्णय मार्गदर्शिका, क्या भेजा जाता है
 बॉक्स, मचान, रेपो एक्सेस और रन शेयरिंग अब एक ही स्थान पर रहते हैं:
@@ -76,8 +71,8 @@ description: "ऐप्स जहां एजेंट संपूर्ण
 ## आगे क्या है
 
 - [**Agent Surfaces — Headless**](/docs/agent-surfaces#headless) - पूर्ण नेतृत्वहीन निर्णय मार्गदर्शिका और APIs
-- [**Getting Started**](/docs/getting-started) - पहले एक चैट ऐप या हेडलेस एजेंट बनाएं
-- [**Dispatch**](/docs/template-dispatch) - वर्कस्पेस टेम्पलेट जो एक बेहतरीन प्योर-एजेंट शुरुआती बिंदु है
+- [**Getting Started**](/docs/getting-started) - पहले chat-first app बनाएं, फिर actions, inline results और pages तक बढ़ाएं
+- [**Dispatch**](/docs/template-dispatch) - automation-first workflows के लिए उपयोगी workspace template
 - [**Messaging the agent**](/docs/messaging) - उपयोगकर्ता वेब, Slack, टेलीग्राम, ईमेल पर एजेंट से कैसे बात करते हैं
 - [**Recurring Jobs**](/docs/recurring-jobs) - निर्धारित संकेत एजेंट अपने आप चलता है
-- [**Actions**](/docs/actions) - वे उपकरण जिन्हें आपका प्योर-एजेंट कॉल करेगा
+- [**Actions**](/docs/actions) - वे tools जिन्हें आपकी automation-first app call करेगी

package/docs/content/locales/hi-IN/template-chat.mdx

@@ -7,7 +7,7 @@ description: "एक न्यूनतम चैट-फर्स्ट एज
 
 चैट मूल एजेंट-नेटिव ऐप शुरुआती बिंदु है। यह आपको केंद्र में चैट के साथ एक साफ ChatGPT-शैली शेल, बाईं ओर एक थ्रेड सूची, मानक ऐप नेविगेशन, ऑथ, लाइव सिंक, actions और एक उदाहरण कार्रवाई देता है। जब आप एक वास्तविक ब्राउज़र ऐप चाहते हैं तो यहां से प्रारंभ करें जिसे आप डोमेन टेम्पलेट से जुड़े बिना बना सकते हैं।
 
-यदि आप बिना ब्राउज़र UI के सबसे छोटा एक्शन-ओनली रनटाइम चाहते हैं, तो [Pure-Agent Apps](/docs/pure-agent-apps) से शुरू करें। यदि आप एक तैयार डोमेन उत्पाद आकार चाहते हैं, तो [Calendar](/docs/template-calendar), [Mail](/docs/template-mail), [Content](/docs/template-content), [Forms](/docs/template-forms), [Analytics](/docs/template-analytics), या किसी अन्य डोमेन टेम्पलेट से प्रारंभ करें।
+यदि आप बिना browser UI वाला automation-first runtime चाहते हैं, तो [Automation-First Apps](/docs/pure-agent-apps) से शुरू करें. यदि आप एक तैयार domain product shape चाहते हैं, तो [Calendar](/docs/template-calendar), [Mail](/docs/template-mail), [Content](/docs/template-content), [Forms](/docs/template-forms), [Analytics](/docs/template-analytics), या किसी अन्य domain template से प्रारंभ करें।
 
 <WireframeBlock id="doc-block-7fjxec">
   <Screen
@@ -198,4 +198,4 @@ export default function ChatRoute() {
 - [**Agent Surfaces**](/docs/agent-surfaces) - हेडलेस, चैट, एंबेडेड और फुल-ऐप पैटर्न
 - [**Actions**](/docs/actions) - एक्शन सिस्टम चैट और UI दोनों कॉल
 - [**Native चैट UI**](/docs/native-chat-ui) - चैट सतह आदिम और रनटाइम विकल्प
-- [**Pure-Agent Apps**](/docs/pure-agent-apps) - केवल एक्शन ऐप्स जो बाद में चैट में विकसित हो सकते हैं
+- [**Automation-First Apps**](/docs/pure-agent-apps) - बिना browser UI वाली automations, queues, scripts और external agent workflows

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

@@ -99,7 +99,7 @@ description: "एजेंट के साथ काम करने का द
 
 हर ऐप को पूर्ण डैशबोर्ड की आवश्यकता नहीं होती है। जब एजेंट *उत्पाद*है, तो आप अधिकांश कस्टम UI को छोड़ सकते हैं: ऐप खोलें, जो आप चाहते हैं उसके लिए पूछें, और एजेंट को बाकी काम करने दें। एजेंट के पास अभी भी प्रबंधन सतह है - इतिहास, कार्यक्षेत्र, सेटिंग्स - लेकिन प्राथमिक इंटरैक्शन क्लिक के बजाय बातचीत है।
 
-→ [**Pure-Agent Apps**](/docs/pure-agent-apps) - ऐसे ऐप्स जहां एजेंट ही संपूर्ण उत्पाद है।
+→ [**Automation-First Apps**](/docs/pure-agent-apps) - jobs, queues, scripts और external agents के लिए no-browser apps।
 
 ## आप इसके साथ सह-संपादन करें {#you-co-edit}
 
@@ -113,5 +113,5 @@ description: "एजेंट के साथ काम करने का द
 - [**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-लाइट करें
+- [**Automation-First Apps**](/docs/pure-agent-apps) - jobs, queues, scripts और external agents के लिए no-browser apps
 - [**Real-Time Collaboration**](/docs/real-time-collaboration) — एक ही दस्तावेज़ को एक साथ सह-संपादित करें

package/docs/content/locales/ja-JP/cloneable-saas.mdx

@@ -30,7 +30,7 @@ description: "動作する SaaS 製品をフォークして、エージェント
 | [**Plan**](/docs/template-plan)           | 図、ワイヤーフレーム、注釈を使用した視覚的な計画と PR の要約。                                                                          |
 | [**Dispatch**](/docs/template-dispatch)   | ワークスペース コントロール プレーン: 共有シークレット、再利用可能な統合、Slack/テレグラム、スケジュールされたジョブ。                  |
 
-ドメイン アプリが不要ですか?ユーザーがすぐに会話できる基本的なアプリが必要な場合は、[Chat](/docs/template-chat) を使用するか、[Pure-Agent Apps](/docs/pure-agent-apps) でアクションから始めてください。
+ドメイン アプリが不要ですか? ユーザーがすぐに会話でき、actions、ネイティブ結果、画面へ拡張できる基本アプリが必要な場合は、[Chat](/docs/template-chat) を使用してください。まだブラウザー UI が不要な workflow の場合だけ [Automation-First Apps](/docs/pure-agent-apps) を使用します。
 
 [Apps](/apps) で完全なカタログを参照するか、カタログに直接ジャンプしてください。たとえば、ワークスペース スタイルのアプリが必要な場合は、[Dispatch](/docs/template-dispatch) から始めるのが最適です。
 
@@ -182,7 +182,7 @@ description: "動作する SaaS 製品をフォークして、エージェント
 npx @agent-native/core@latest create my-platform
 ```
 
-複数選択ピッカーが表示されます。 1 つのアプリ (スタンドアロン) または複数のアプリ (ワークスペース - アプリは認証、ブランド、エージェント構成、データベースを共有) を選択します。選択した各テンプレートは、必要なすべてのファイルとともに `apps/<name>/` にスキャフォールディングされます。テンプレート UI の代わりにアクション専用アプリの場合は、`npx @agent-native/core@latest create my-agent --headless` を使用します。
+複数選択ピッカーが表示されます。 1 つのアプリ (スタンドアロン) または複数のアプリ (ワークスペース - アプリは認証、ブランド、エージェント構成、データベースを共有) を選択します。選択した各テンプレートは、必要なすべてのファイルとともに `apps/<name>/` にスキャフォールディングされます。テンプレート UI の代わりにブラウザー UI のない automation を作る場合は、`npx @agent-native/core@latest create my-agent --headless` を使用します。
 
 `.env` (主に `ANTHROPIC_API_KEY` と `DATABASE_URL`)、`pnpm install`、`pnpm dev` を入力すると機能します。 「TODO: ログインの実装」、プレースホルダー ルートはありません。
 

package/docs/content/locales/ja-JP/faq.mdx

@@ -11,15 +11,15 @@ description: "エージェント ネイティブについてよくある質問
 
 ### エージェントネイティブとは何ですか? {#what-is-agent-native}
 
-エージェントネイティブは、AI エージェントとその周囲の製品表面が対等なパートナーとなるアプリを構築するためのフレームワークです。そのサーフェスは、1 つのカスタム アクションを備えたヘッドレス エージェントとして開始し、リッチ チャットに成長したり、完全な UI になることができます。不変条件は、エージェントと人間が同じ actions、データベース、状態を共有することです。完全な説明については、[What Is Agent-Native?](/docs/what-is-agent-native) を参照してください。
+エージェントネイティブは、AI エージェントとその周囲の製品表面が対等なパートナーとなるアプリを構築するためのフレームワークです。通常の流れは chat から始まり、typed actions を追加し、構造化結果をインライン表示し、同じ SQL state の上に永続ページを増やします。不変条件は、エージェントと人間が同じ actions、データベース、状態を共有することです。完全な説明については、[What Is Agent-Native?](/docs/what-is-agent-native) を参照してください。
 
 ### これは誰のためのものですか? {#who-is-this-for}
 
 エージェント ネイティブは、実際のアプリと AI エージェントが同じデータと actions から動作することを望む人向けです。一般的なパスは次のとおりです。
 
 - メール、カレンダー、フォーム、プラン、または設定なしで完成した別のテンプレートが必要な場合は、**ホストされたアプリを使用します**。[template gallery](/templates) から始めてください。
-- ユーザーがすぐに会話できる基本的なアプリが必要な場合は、**チャットから始めます**。次に、actions と画面で拡張します。[Getting Started](/docs/getting-started) または [Chat](/docs/template-chat) から始めます。
-- **プリミティブファーストで開始** UI にコミットする前に 1 つのアクションとヘッドレスアプリエージェントループが必要な場合は、[Getting Started](/docs/getting-started) から開始します。
+- ユーザーがすぐに agent と会話でき、actions、ネイティブ結果、画面へ拡張する既定のゼロからの道が必要な場合は、**チャットから始めます**。[Getting Started](/docs/getting-started) または [Chat](/docs/template-chat) から始めます。
+- 予定タスク、queues、scripts、integration workers、またはまだブラウザー UI が不要な外部 agent workflows を作る場合は、**automation-first で開始**します。[Automation-First Apps](/docs/pure-agent-apps) から始めます。
 - 認証、データベース、UI、エージェント actions がすでに接続されている独自の SaaS 製品が必要な場合は、**テンプレートをフォークしてカスタマイズします**。[Templates](/docs/cloneable-saas) を参照してください。
 - **最初から構築** 新しいエージェント駆動製品のフレームワーク プリミティブが必要な場合は、[Getting Started](/docs/getting-started) から始めます。
 - **別のエージェントまたはコード ツールを接続します** Claude、ChatGPT、Codex、カーソル、または GitHub Copilot / VS Code でエージェント ネイティブ アプリを使用する場合は、「[External Agents](/docs/external-agents) および [Skills Guide](/docs/skills-guide)」を参照してください。
@@ -130,7 +130,7 @@ Anthropic Claude、OpenAI (GPT-5 ファミリー)、Google Gemini、および Op
 
 ### テンプレートでカバーされていないものを構築できますか? {#build-from-scratch}
 
-はい。基本的なチャット アプリが必要な場合は、`npx @agent-native/core@latest create my-chat-app --template chat` を実行します。耐久性のあるチャット スレッド、actions、認証、SQL に基づくランタイム状態、および独自の画面を追加する余地が得られます。 UI を持たない最小のアクション優先アプリが必要な場合は、`npx @agent-native/core@latest create my-agent --headless` を実行します。 [Getting Started](/docs/getting-started)、[Pure-Agent Apps](/docs/pure-agent-apps)、および [Chat](/docs/template-chat) を参照してください。
+はい。基本的な agentic app が必要な場合は、`npx @agent-native/core@latest create my-chat-app --template chat` を実行します。耐久性のあるチャット スレッド、actions、認証、SQL に基づくランタイム状態、ネイティブ インライン表示、および独自の画面を追加する余地が得られます。ブラウザーなしの automation を作る場合は、`npx @agent-native/core@latest create my-agent --headless` を実行します。[Getting Started](/docs/getting-started)、[Automation-First Apps](/docs/pure-agent-apps)、および [Chat](/docs/template-chat) を参照してください。
 
 ### テンプレートをフォークせずに試してみることはできますか? {#try-with-a-skill}