@agent-native/core 0.84.35 → 0.84.36

package/docs/content/locales/fr-FR/getting-started.mdx

@@ -1,259 +1,193 @@
 ---
 title: "Démarrage"
-description: "Créez une application d'agent, comprenez les instructions, skills et actions, puis regardez l'agent appeler sa première action."
+description: "Créez une app agentic centrée sur le chat, ajoutez une action, rendez des résultats structurés en ligne, puis ajoutez une page persistante que l'agent peut ouvrir."
 ---
 
 # Démarrage
 
-Les applications Agent-Native donnent à un agent IA et à votre UI les mêmes actions, données et
-état. Un agent de base est constitué d'instructions qui le guident, de skills qui lui enseignent
-comportement reproductible et actions qui lui permettent de faire un vrai travail.
-
-**Vous voulez commencer par une application complète ?** Clonez l'un de nos modèles riches –
-[Chat](/docs/template-chat), [Mail](/docs/template-mail),
-[Calendar](/docs/template-calendar), [Content](/docs/template-content),
-[Analytics](/docs/template-analytics) et [many more](/docs/cloneable-saas) —
-chacune une application complète que vous personnalisez.
-
-Construire à partir de zéro ? Le seul choix dès le départ est de savoir si vous voulez un UI —
-tout après (écrire les instructions, ajouter skills, définir actions, exécuter
-l'agent) est le même dans les deux cas.
-
-<FileTree
-  id="doc-block-13buza2"
-  title="Un agent Agent-Native de base"
-  entries={[
-    {
-      path: "AGENTS.md",
-      note: "Instructions toujours actives : objectif, règles, ton et carte de ce que l'agent peut faire",
-    },
-    {
-      path: ".agents/skills/customer-research/SKILL.md",
-      note: "Un playbook réutilisable que l'agent charge quand la tâche correspond",
-    },
-    {
-      path: "actions/summarize-week.ts",
-      note: "Code typé que l'agent, UI, CLI, HTTP, MCP, A2A, jobs et webhooks peuvent exécuter",
-    },
-  ]}
-/>
-
-Cela est vrai que vous commenciez avec un chat UI, un agent sans tête ou une application complète.
-Le UI change la surface ; instructions, skills et actions donnent à l'agent son
-conseils et comportement.
-
-## 1. Créez votre application
-
-Vous aurez besoin de [Node.js 22+](https://nodejs.org) et [pnpm](https://pnpm.io).
-
-Exécutez `create` sans indicateur et il vous demande comment vous souhaitez démarrer (un modèle complet,
-Chat ou Headless) avant toute chose :
+Agent-Native sert à créer des agentic applications : l'AI agent et l'UI partagent les mêmes [actions](/docs/actions), les mêmes données SQL et le même application state. Le chemin principal commence par Chat, afin que les utilisateurs puissent parler à l'agent immédiatement, puis ajoute les surfaces produit nécessaires.
 
-```bash
-npx @agent-native/core@latest create my-app
-```
+Le parcours utile :
 
-Ou transmettez un indicateur pour ignorer l'invite :
+1. Créer une Chat app.
+2. Ajouter une action.
+3. Rendre le résultat de l'action directement dans le chat.
+4. Persister les données dans SQL.
+5. Ajouter une page que l'agent peut ouvrir lorsqu'une inspection visuelle est préférable.
 
-**Vous voulez un UI ?** Commencez à partir du modèle de chat. Vous obtenez un agent actif plus un
-chat personnalisable UI, et chaque action que vous ajoutez y apparaît automatiquement :
+## 1. Créer une Chat app {#create-your-app}
+
+Vous avez besoin de [Node.js 22+](https://nodejs.org) et de [pnpm](https://pnpm.io).
 
 ```bash
 npx @agent-native/core@latest create my-app --template chat
+cd my-app
+pnpm install
+pnpm dev
 ```
 
-**Juste la primitive sans tête ?** Démarrer sans tête – les mêmes actions et le même agent
-boucle, pas de shell UI :
-
-```bash
-npx @agent-native/core@latest create my-agent --headless
+Le template inclut durable chat threads, auth, live sync, un dossier `actions/`, les actions standard `view-screen` et `navigate`, et une app React prête à évoluer.
+
+## 2. Ajouter une action {#add-an-action}
+
+Une action est une opération typée appelée par l'agent et par l'UI. Pour ce guide, créez `actions/analyze-responses.ts` : elle analyse des réponses de formulaire et renvoie une forme validée pour un graphique de chat personnalisé.
+
+{/* 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: "Graphique des réponses" 
+  },
+  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 }],
+  }),
+});
 ```
 
-Installez ensuite à partir du dossier que vous avez créé :
+Exécutez-la directement :
 
 ```bash
-cd my-agent # ou my-app si vous avez choisi le modèle Chat
-pnpm install
+pnpm action analyze-responses --formId demo
 ```
 
-À partir de maintenant, les deux sont identiques.
-
-## 2. Ajouter une action
-
-Une action est une opération que votre agent (et votre UI) peut appeler. Les deux échafaudages
-livré avec cet exemple :
-
-<AnnotatedCode
-  id="doc-block-hmo7e9"
-  title={"Votre première 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: "Dites bonjour depuis l’agent local.",\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: "Description de l’outil",
-      note: "L’agent lit `description` pour décider quand appeler ceci comme outil.",
-    },
-    {
-      lines: "6-8",
-      label: "Contrat typé",
-      note: "Un `schema` zod valide les entrées depuis chaque surface: agent, UI, HTTP, MCP et A2A.",
-    },
-    {
-      lines: "9",
-      label: "Verbe HTTP",
-      note: "Exposez cette action sur un endpoint HTTP monté automatiquement.",
-    },
-    {
-      lines: "10",
-      label: "Lecture seule",
-      note: "`readOnly` indique que l’action peut être appelée sans approbation et mise en cache pour les requêtes.",
-    },
-    {
-      lines: "11-13",
-      label: "Une seule implémentation",
-      note: "Le corps de `run` est la source de vérité unique exécutée par toutes les surfaces.",
-    },
-  ]}
-/>
-
-Remplacez `hello` par la première opération réelle dans votre domaine. Vous le définissez une fois ;
-chaque surface le capte.
-
-Utilisez `AGENTS.md` pour obtenir des conseils qui doivent s'appliquer à chaque virage. Utilisez une compétence lorsque le
-l'agent a besoin d'un workflow ou d'une procédure de domaine réutilisable. Utilisez une action lorsque
-l'agent a besoin d'un moyen typé et testable pour lire des données, écrire des données, appeler un API ou
-effectuer une approbation.
-
-## 3. Exécutez-le
-
-Appelez l'action directement :
+Ou demandez à l'agent dans le navigateur :
 
-```bash
-pnpm action hello --name Steve
-```
+> Analyse les réponses récentes du formulaire de démonstration.
 
-Ou demandez à l'agent de l'appeler pour vous :
+## 3. Rendre le résultat dans le chat {#render-inline}
 
-```bash
-pnpm agent "Call the hello action for Steve and explain what happened."
-```
+Comme l'action déclare `outputSchema` et un `chatUI.renderer` propre au produit, le transcript ne transforme pas les données structurées en simple texte. Enregistrez un composant React pour cet id exact au démarrage de l'app, par exemple en important `app/chat-renderers.tsx` une fois depuis `app/root.tsx` :
 
-Si vous avez démarré à partir du modèle Chat, exécutez l'application et utilisez le même agent dans le
-navigateur : il peut déjà appeler toutes les actions que vous définissez :
+{/* 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,
+});
 ```
 
-Cette action est désormais accessible depuis le chat UI, les CLI, HTTP, MCP, A2A,
-tâches planifiées et webhooks. Définissez une fois, appelez de n'importe où.
-
-<Diagram id="doc-block-114sbvf" title="Une action, chaque surface" summary={"Un seul fichier defineAction est distribué à chaque consommateur sans câblage supplémentaire."}>
-
-```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">Interface de chat</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">Tâches planifiées</span
-    ><span class="diagram-pill">Webhooks</span>
-  </div>
-</div>
-```
+Pour les sorties génériques réutilisables, le framework fournit aussi les renderers intégrés `data-chart` et `data-table`, ainsi que `data-insights` pour les cartes combinant résumé, graphique et tableau. Voir [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-fr">
+  <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'>Analyse les réponses de démo.</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'>Rendu avec responses.response-chart.</p><section class='wf-card' data-rough style='padding:14px'><h3 style='margin:0 0 12px;font-size:14px'>Graphique des réponses</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'>Lun</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'>Mar</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'>Mer</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'>Jeu</span></div></div></section></div></div></div>"
+    }
+  />
+</WireframeBlock>
 
-</Diagram>
+## 4. Persister les données dans SQL {#persist-data}
 
-## L'État est intégré
+Quand le résultat doit être revu, comparé ou mis à jour, stockez-le dans SQL et gardez les lectures/écritures derrière des actions :
 
-Sans tête ne signifie pas apatride. Actions, sessions, état de l'application, threads,
-l'historique d'exécution et les informations d'identification se trouvent tous dans SQL. Localement, c'est SQLite à
-`data/app.db` ; en production, vous définissez `DATABASE_URL`. Voir
-[Deployment](/docs/deployment).
+Définissez la table avec les helpers portables du framework, pas avec des imports de `drizzle-orm/sqlite-core` ou `drizzle-orm/pg-core` :
 
-<Callout id="doc-block-6fcpg4" tone="info">
+```ts
+// server/db/schema.ts
+import { integer, now, table, text } from "@agent-native/core/db/schema";
 
-**Headless est toujours une véritable application.** La boucle app-agent conserve les sessions, les threads, les exécutions, les paramètres et les informations d'identification dans SQL — ce n'est pas une invite sans état. Vous pouvez ajouter une interface utilisateur ultérieurement sans toucher à vos actions ou à votre état.
+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>
+Ces helpers choisissent le backend SQL configuré, donc le même schéma peut fonctionner avec SQLite en local et avec Postgres, Turso/libSQL, D1 ou un autre fournisseur SQL pris en charge en production.
 
-## Personnalisez le UI
+- `create-response-insight` écrit un nouvel insight.
+- `list-response-insights` lit les données de la page.
+- `update-response-insight` met à jour un enregistrement.
+- `analyze-responses` continue de renvoyer le widget natif du chat.
 
-Si vous avez démarré à partir du modèle Chat, vous pouvez modifier le UI. Le chat lui-même
-est un petit itinéraire construit sur le composant `<AgentChatSurface>` :
+N'ajoutez pas de REST route en double pour le navigateur ; l'UI et l'agent doivent partager les actions.
 
-```tsx
-// app/routes/_index.tsx
-import { AgentChatSurface } from "@agent-native/core/client";
+## 5. Ajouter une page que l'agent peut ouvrir {#add-a-page}
 
-export default function ChatRoute() {
-  return <AgentChatSurface mode="page" className="h-full" />;
-}
-```
+Ajoutez une route `/response-insights` avec `useActionQuery("list-response-insights")` et `useActionMutation("create-response-insight")`. La page est une projection du SQL state ; les données restent écrites par les mêmes actions.
 
-- **`app/routes/_index.tsx`** — la page de discussion. Modifier les suggestions, vide
-  état et disposition.
-- **`app/root.tsx`** — le shell de l'application. Ajoutez vos propres itinéraires et écrans autour du
-  agent.
-- Déposez l'agent sur n'importe quel écran avec `<AgentSidebar>`, travaillez-y manuellement à partir d'un
-  bouton avec `sendToAgentChat()`, ou exécuter une action directement avec
-  `useActionMutation()`.
+<WireframeBlock id="doc-block-response-insights-page-wireframe-fr">
+  <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 de réponses</h2><p class='wf-muted' style='margin:0'>Insights créés par l'agent à partir des réponses du formulaire.</p></header><button class='primary' data-rough style='align-self:flex-start'>Analyser le formulaire de démonstration</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>Thème de tarification</strong><p class='wf-muted' style='margin:8px 0 0'>Les utilisateurs demandent un forfait équipe.</p></article><article class='wf-box' data-rough style='padding:12px'><strong>Abandon d'onboarding</strong><p class='wf-muted' style='margin:8px 0 0'>Trois étapes demandent un texte plus clair.</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>Formulaire de démonstration</strong><span class='wf-muted'>42 réponses analysées</span></div><div class='wf-row wf-box' data-rough style='padding:10px 12px;gap:12px;justify-content:space-between'><strong>Étape suivante</strong><span class='wf-muted'>Relire deux brouillons d'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>Chat</strong><div class='wf-box' data-rough style='align-self:flex-end;max-width:210px;padding:10px 12px'><span class='wf-muted'>Vous</span><p style='margin:4px 0 0'>Ouvrez les insights de réponses.</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 de réponses ouverts.</p></div></aside></section></main>"
+    }
+  />
+</WireframeBlock>
 
-Voir [Drop-in Agent](/docs/drop-in-agent) pour l'ensemble complet des composants, et
-[Native Interface de chat](/docs/native-chat-ui) pour afficher les résultats des actions sous forme de tableaux,
-des graphiques et des cartes dactylographiées au lieu de texte brut.
+Étendez `view-screen` et `navigate` pour que l'agent connaisse la route active et puisse ouvrir `/response-insights`. Les résultats peuvent aussi contenir `href: "/response-insights"` pour afficher un bouton "Ouvrir les insights de réponses".
 
-**Vous avez commencé sans tête et vous voulez un UI plus tard ?** Le modèle Chat _est_ la rampe d'accès au UI —
-sa couche `app/` (routeur React + Vite) correspond exactement à l'échafaudage sans tête
-laisse de côté. Le geste le plus simple consiste à démarrer (ou à ré-échafauder) à partir du chat
-modèle ; vos états `actions/`, agent et SQL restent inchangés. Voir
-[Agent Surfaces](/docs/agent-surfaces) pour chaque surface intermédiaire.
+Quand le chat pleine page ouvre une page d'app, utilisez `AgentChatSurface`, `AgentSidebar`, `useAgentChatHomeHandoff`, `useAgentChatHomeHandoffLinks` et `chatViewTransition` depuis [Agent Surfaces](/docs/agent-surfaces#rich-chat) pour glisser le chat dans le panneau latéral sans perdre le thread.
 
-## Structure du projet
+## Structure du projet {#project-structure}
 
 ```text
 my-app/
-  actions/         # Actions appelables par l’agent
-  app/             # Frontend React (modèles UI uniquement ; omis en headless)
-  server/          # Serveur API Nitro (routes, plugins)
-  AGENTS.md        # Instructions permanentes de l’agent
-  .agents/         # Skills que l’agent peut charger au besoin
-  data/app.db      # État SQLite local quand DATABASE_URL n’est pas défini
+  actions/         # Opérations appelables par l'agent et l'interface
+  app/             # Routes, pages et surfaces de chat React
+  server/          # Serveur Nitro et schéma SQL
+  AGENTS.md        # Instructions permanentes pour l'agent de l'app
+  .agents/         # Skills que l'agent charge quand c'est pertinent
+  data/app.db      # État SQLite local quand DATABASE_URL n'est pas défini
 ```
 
-## Où aller ensuite
-
-- **[Key Concepts](/docs/key-concepts)** — l'architecture de base : SQL, actions,
-  synchronisation et prise en compte du contexte.
-- **[Actions](/docs/actions)** — l'action complète API : schémas, HTTP, authentification et
-  approbation.
-- **[Agent Surfaces](/docs/agent-surfaces)** – sans tête, chat, side-car intégré,
-  et application complète.
-- **[Drop-in Agent](/docs/drop-in-agent)** — ajoutez le chat d'agent à n'importe quelle application React.
-- **[Deployment](/docs/deployment)** : placez votre application sur votre propre domaine.
-- **[FAQ](/docs/faq)** — questions sur la configuration et le produit.
+## Vous voulez un vrai point de départ analytics ? {#analytics-starting-point}
+
+L'exemple Insights de réponses ci-dessus est volontairement petit pour montrer les pièces du framework. Si vous construisez un vrai produit analytics, commencez plutôt avec [Analytics](/docs/template-analytics). C'est le point de départ robuste : connectez vos providers, utilisez les dashboards et agent actions existants, puis personnalisez à partir de là.
+
+## Suite {#next}
+
+- **[Actions](/docs/actions)** — schemas, auth, approvals, hooks et transport.
+- **[Native Chat UI](/docs/native-chat-ui)** — tableaux, graphiques et typed cards pour les résultats d'actions.
+- **[Chat Template](/docs/template-chat)** — l'app minimale chat-first.
+- **[Analytics Template](/docs/template-analytics)** — une base analytics robuste ; connectez vos providers puis personnalisez.
+- **[Context Awareness](/docs/context-awareness)** — `view-screen`, `navigate`, route state et objets sélectionnés.
+- **[Agent Surfaces](/docs/agent-surfaces)** — chat, inline UI, app pages, embedded sidecars, automation et agents externes.

package/docs/content/locales/fr-FR/pure-agent-apps.mdx

@@ -1,16 +1,11 @@
 ---
-title: "Applications Pure-Agent"
-description: "Applications dans lesquelles l'agent représente l'ensemble du produit : la boucle application-agent est la porte d'entrée et UI n'est ajouté que lorsque les humains en ont besoin."
+title: "Automation-First Apps"
+description: "Apps Agent-Native sans navigateur pour scheduled jobs, files, scripts, integration workers et agents externes."
 ---
 
-# Applications Pure-Agent
+# Automation-First Apps
 
-Une application purement agent est la fin minimale de l'agent natif : la boucle application-agent est la
-produit, pas un tableau de bord. Vous envoyez une requête depuis le terminal, Slack, email, un
-tâche planifiée, un autre agent ou Chat – "résumer mes e-mails non lus", "publier le
-mesures quotidiennes vers Slack" — et l'agent agit et renvoie le résultat où qu'il soit
-appartient. C'est toujours une vraie application : actions, sessions, état de l'application, historique,
-les paramètres, les informations d'identification et les enregistrements de partage sont tous présents dans SQL.
+Une automation-first app est une app Agent-Native sans navigateur pour scheduled jobs, files, scripts, integration workers et agents externes. Ce n'est pas le chemin par défaut de Getting Started, mais c'est utile lorsque le workflow n'a pas encore besoin d'une page. C'est toujours une vraie app : actions, sessions, application state, run history, settings, credentials et enregistrements de partage vivent dans SQL.
 
 <Diagram id="doc-block-bmd6at" title={"La boucle app-agent est la porte d’entrée"} summary={"De nombreux points d'entrée atteignent une boucle d'agent via les actions et l'état SQL-backed ; les résultats reviennent d'où que vient la demande. L'interface utilisateur est ajoutée uniquement lorsque des humains doivent superviser."}>
 

package/docs/content/locales/fr-FR/template-chat.mdx

@@ -7,7 +7,7 @@ description: "Une application native d'agent minimale axée sur le chat : fils
 
 Chat est le point de départ de base d'une application native pour agent. Il vous offre un shell propre de style ChatGPT avec une discussion au centre, une liste de fils de discussion à gauche, une navigation d'application standard, une authentification, une synchronisation en direct, actions et un exemple d'action. Commencez ici lorsque vous souhaitez une véritable application de navigateur sur laquelle vous pouvez créer sans vous engager dans un modèle de domaine.
 
-Si vous souhaitez le plus petit environnement d'exécution d'action uniquement sans navigateur UI, commencez par [Pure-Agent Apps](/docs/pure-agent-apps). Si vous souhaitez une forme de produit de domaine fini, commencez par [Calendar](/docs/template-calendar), [Mail](/docs/template-mail), [Content](/docs/template-content), [Forms](/docs/template-forms), [Analytics](/docs/template-analytics) ou un autre modèle de domaine.
+Si vous souhaitez un runtime automation-first sans UI navigateur, commencez par [Automation-First Apps](/docs/pure-agent-apps). Si vous souhaitez une forme de produit de domaine fini, commencez par [Calendar](/docs/template-calendar), [Mail](/docs/template-mail), [Content](/docs/template-content), [Forms](/docs/template-forms), [Analytics](/docs/template-analytics) ou un autre modèle de domaine.
 
 <WireframeBlock id="doc-block-19iybib">
   <Screen
@@ -200,4 +200,4 @@ L'agent doit ajouter un schéma Drizzle, un actions, un itinéraire, une navigat
 - [**Agent Surfaces**](/docs/agent-surfaces) – modèles sans tête, de chat, intégrés et d'application complète
 - [**Actions**](/docs/actions) — le chat du système d'action et UI appellent tous deux
 - [**Native Interface de chat**](/docs/native-chat-ui) – primitives de la surface de discussion et options d'exécution
-- [**Pure-Agent Apps**](/docs/pure-agent-apps) : applications d'action uniquement pouvant évoluer vers Chat ultérieurement
+- [**Automation-First Apps**](/docs/pure-agent-apps) : automatisations, files, scripts et workflows d'agents externes sans UI navigateur

package/docs/content/locales/fr-FR/using-your-agent.mdx

@@ -99,7 +99,7 @@ L'agent n'est pas une application distincte vers laquelle vous accédez. Il est
 
 Toutes les applications n'ont pas besoin d'un tableau de bord complet. Lorsque l'agent _est_ le produit, vous pouvez ignorer la plupart des UI personnalisés : ouvrez l'application, demandez ce que vous voulez et laissez l'agent faire le reste. L'agent dispose toujours de sa surface de gestion (historique, espace de travail, paramètres), mais l'interaction principale est la conversation plutôt que les clics.
 
-→ [**Pure-Agent Apps**](/docs/pure-agent-apps) — applications où l'agent est l'ensemble du produit.
+→ [**Automation-First Apps**](/docs/pure-agent-apps) — apps sans navigateur pour jobs, files, scripts et agents externes.
 
 ## Vous co-éditez avec lui {#you-co-edit}
 
@@ -113,5 +113,5 @@ Lorsque vous et l'agent travaillez sur le même document, vous ne vous relayez p
 - [**Agent Mentions**](/docs/agent-mentions) — dirigez-le avec les mentions `@`
 - [**Voice Input**](/docs/voice-input) — dirigez-le en parlant
 - [**Drop-in Agent**](/docs/drop-in-agent) : intégrez-le dans n'importe quelle application React
-- [**Pure-Agent Apps**](/docs/pure-agent-apps) — passez à UI légère lorsque l'agent est le produit
+- [**Automation-First Apps**](/docs/pure-agent-apps) — apps sans navigateur pour jobs, files, scripts et agents externes
 - [**Real-Time Collaboration**](/docs/real-time-collaboration) — co-éditez ensemble le même document

package/docs/content/locales/hi-IN/cloneable-saas.mdx

@@ -30,7 +30,7 @@ description: "एक कार्यशील SaaS उत्पाद को फ
 | [**Plan**](/docs/template-plan)           | चित्र, वायरफ्रेम और एनोटेशन के साथ विज़ुअल योजनाएं और पीआर पुनर्कथन।                                                 |
 | [**Dispatch**](/docs/template-dispatch)   | कार्यस्थान नियंत्रण विमान: साझा रहस्य, पुन: प्रयोज्य एकीकरण, Slack/टेलीग्राम, निर्धारित कार्य।                       |
 
-डोमेन ऐप नहीं चाहिए? जब आप एक बुनियादी ऐप चाहते हैं जिससे उपयोगकर्ता तुरंत बात कर सकें तो [Chat](/docs/template-chat) का उपयोग करें, या [Pure-Agent Apps](/docs/pure-agent-apps) में एक action से शुरू करें।
+डोमेन ऐप नहीं चाहिए? जब आप ऐसा बुनियादी ऐप चाहते हैं जिससे उपयोगकर्ता तुरंत बात कर सकें और जिसे actions, native results और screens के साथ बढ़ाया जा सके, तो [Chat](/docs/template-chat) का उपयोग करें. [Automation-First Apps](/docs/pure-agent-apps) केवल तब उपयोग करें जब workflow को अभी browser UI की ज़रूरत न हो.
 
 [Apps](/apps) के अंतर्गत पूरा कैटलॉग देखें, या सीधे एक पर जाएं - उदाहरण के लिए, यदि आप वर्कस्पेस-शैली ऐप चाहते हैं तो [Dispatch](/docs/template-dispatch) शुरू करने के लिए एक शानदार जगह है।
 
@@ -168,7 +168,7 @@ description: "एक कार्यशील SaaS उत्पाद को फ
 
 ## इस पर निर्माण
 
-- [**Getting Started**](/docs/getting-started) - एक न्यूनतम चैट ऐप या हेडलेस एजेंट बनाएं
+- [**Getting Started**](/docs/getting-started) - chat-first app बनाएं, action जोड़ें, structured result render करें और page तक बढ़ाएं
 - [**Messaging the agent**](/docs/messaging) - उपयोगकर्ता (और आप) प्रत्येक टेम्पलेट के साथ शिप करने वाले एजेंट से कैसे बात करते हैं
 - [**Multi-App Workspace**](/docs/multi-app-workspace) - कई टेम्पलेट्स को एक कार्यक्षेत्र में बंडल करें जो ऑथ, ब्रांड और एजेंट को साझा करता है
 - [**Dispatch**](/docs/template-dispatch) - कार्यक्षेत्र नियंत्रण विमान टेम्पलेट
@@ -182,7 +182,7 @@ description: "एक कार्यशील SaaS उत्पाद को फ
 npx @agent-native/core@latest create my-platform
 ```
 
-आपको एक बहु-चयन पिकर मिलेगा। एक ऐप (स्टैंडअलोन) या कई (वर्कस्पेस - ऐप्स शेयर ऑथ, ब्रांड, एजेंट कॉन्फ़िगरेशन और डेटाबेस) चुनें। प्रत्येक चयनित टेम्प्लेट को आपकी आवश्यक प्रत्येक फ़ाइल के साथ `apps/<name>/` में रखा गया है। टेम्पलेट UI के बजाय केवल एक्शन ऐप के लिए, `npx @agent-native/core@latest create my-agent --headless` का उपयोग करें।
+आपको एक बहु-चयन पिकर मिलेगा। एक ऐप (स्टैंडअलोन) या कई (वर्कस्पेस - ऐप्स शेयर ऑथ, ब्रांड, एजेंट कॉन्फ़िगरेशन और डेटाबेस) चुनें। प्रत्येक चयनित टेम्प्लेट को आपकी आवश्यक प्रत्येक फ़ाइल के साथ `apps/<name>/` में रखा गया है। टेम्पलेट UI के बजाय बिना browser 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/hi-IN/faq.mdx

@@ -11,15 +11,15 @@ description: "एजेंट-नेटिव के बारे में स
 
 ### एजेंट-नेटिव क्या है? {#what-is-agent-native}
 
-एजेंट-नेटिव ऐप्स बनाने के लिए एक ढांचा है जहां एआई एजेंट और उसके आसपास की उत्पाद सतह समान भागीदार हैं। वह सतह एक कस्टम कार्रवाई के साथ एक हेडलेस एजेंट के रूप में शुरू हो सकती है, समृद्ध चैट में विकसित हो सकती है, या पूर्ण UI बन सकती है। अपरिवर्तनीय यह है कि एजेंट और मनुष्य समान actions, डेटाबेस और स्थिति साझा करते हैं। संपूर्ण स्पष्टीकरण के लिए [What Is Agent-Native?](/docs/what-is-agent-native) देखें।
+Agent-native ऐप्स बनाने के लिए एक framework है जहां AI agent और उसके आसपास की product surface समान भागीदार हैं. सामान्य रास्ता chat से शुरू होता है, typed actions जोड़ता है, structured results inline render करता है, और उसी SQL state के ऊपर durable pages तक बढ़ता है. अपरिवर्तनीय यह है कि agent और मनुष्य समान actions, database और state साझा करते हैं. संपूर्ण स्पष्टीकरण के लिए [What Is Agent-Native?](/docs/what-is-agent-native) देखें।
 
 ### यह किसके लिए है? {#who-is-this-for}
 
 एजेंट-नेटिव उन लोगों के लिए है जो एक ही डेटा और actions से काम करने के लिए एक वास्तविक ऐप और एक AI एजेंट चाहते हैं। सामान्य पथ हैं:
 
 - **अगर आप मेल, कैलेंडर, फॉर्म, प्लान या बिना किसी सेटअप वाला कोई अन्य तैयार टेम्पलेट चाहते हैं तो होस्टेड ऐप का उपयोग करें** - [template gallery](/templates) से शुरू करें।
-- **चैट से शुरू करें** यदि आप चाहते हैं कि एक बुनियादी ऐप उपयोगकर्ता तुरंत बात कर सके, तो actions और स्क्रीन के साथ विस्तार करें - [Getting Started](/docs/getting-started) या [Chat](/docs/template-chat) से शुरू करें।
-- **यदि आप UI पर प्रतिबद्ध होने से पहले एक क्रिया और एक हेडलेस ऐप-एजेंट लूप चाहते हैं तो आदिम-पहले शुरू करें** - [Getting Started](/docs/getting-started) से शुरू करें।
+- **Chat से शुरू करें** यदि आप default from-scratch path चाहते हैं: users तुरंत agent से बात करें और आप actions, native results और screens से विस्तार करें - [Getting Started](/docs/getting-started) या [Chat](/docs/template-chat) से शुरू करें।
+- **automation-first से शुरू करें** यदि आप scheduled jobs, queues, scripts, integration workers या external agent workflows बना रहे हैं जिन्हें अभी browser UI नहीं चाहिए - [Automation-First Apps](/docs/pure-agent-apps) से शुरू करें।
 - \*\*यदि आप अपना स्वयं का SaaS उत्पाद ऑथ, डेटाबेस, UI और एजेंट actions के साथ पहले से ही वायर्ड चाहते हैं, तो टेम्पलेट को फोर्क और कस्टमाइज़ करें - [Templates](/docs/cloneable-saas) देखें।
 - **शुरुआत से निर्माण** यदि आप नए एजेंट-संचालित उत्पाद के लिए फ्रेमवर्क प्रिमिटिव चाहते हैं - [Getting Started](/docs/getting-started) से शुरू करें।
 - \*\*यदि आप एजेंट-नेटिव ऐप का उपयोग करने के लिए Claude, ChatGPT, Codex, कर्सर, या GitHub कोपायलट / VS कोड चाहते हैं तो किसी अन्य एजेंट या कोड टूल को कनेक्ट करें - [External Agents](/docs/external-agents) और [Skills Guide](/docs/skills-guide) देखें।
@@ -128,7 +128,7 @@ description: "एजेंट-नेटिव के बारे में स
 
 ### क्या मैं कुछ ऐसा बना सकता हूं जो टेम्पलेट्स में शामिल न हो? {#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) देखें।
+हां. यदि आप basic agentic app चाहते हैं, तो `npx @agent-native/core@latest create my-chat-app --template chat` चलाएँ; आपको durable chat threads, actions, auth, SQL-backed runtime state, native inline rendering और अपनी screens जोड़ने की जगह मिलती है. यदि आप no-browser 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}