@agent-native/core 0.84.35 → 0.84.37

package/docs/content/locales/es-ES/getting-started.mdx

@@ -1,259 +1,193 @@
 ---
-title: "Cómo empezar"
-description: "Cree una aplicación de agente, comprenda las instrucciones skills y actions y luego observe cómo el agente ejecuta su primera acción."
+title: "Primeros pasos"
+description: "Crea una app agentic empezando por chat, añade una action, renderiza resultados estructurados en línea y crece hacia una página persistente que el agent puede abrir."
 ---
 
-# Cómo empezar
-
-Las aplicaciones Agent-Native brindan a un agente de IA y a su UI el mismo actions, datos y
-estado. Un agente básico se hace a partir de instrucciones que lo guían, skills que enseñan
-comportamiento repetible y actions que le permiten hacer un trabajo real.
-
-**¿Quieres una aplicación completa para empezar?** Clona una de nuestras plantillas enriquecidas:
-[Chat](/docs/template-chat), [Mail](/docs/template-mail),
-[Calendar](/docs/template-calendar), [Content](/docs/template-content),
-[Analytics](/docs/template-analytics) y [many more](/docs/cloneable-saas) —
-cada una de ellas es una aplicación con todas las funciones que puedes personalizar.
-
-¿Construir desde cero? La única opción desde el principio es si quieres un UI —
-todo lo posterior (escribir instrucciones, agregar skills, definir actions, ejecutar
-el agente) es el mismo en ambos sentidos.
-
-<FileTree
-  id="doc-block-1525m3a"
-  title={"Un agente Agent-Native básico"}
-  entries={[
-    {
-      path: "AGENTS.md",
-      note: "Instrucciones siempre activas: propósito, reglas, tono y mapa de lo que el agente puede hacer",
-    },
-    {
-      path: ".agents/skills/customer-research/SKILL.md",
-      note: "Un playbook reutilizable que el agente carga cuando la tarea coincide",
-    },
-    {
-      path: "actions/summarize-week.ts",
-      note: "Código tipado que el agente, la UI, CLI, HTTP, MCP, A2A, jobs y webhooks pueden ejecutar",
-    },
-  ]}
-/>
-
-Esto es cierto ya sea que comiences con un chat UI, un agente sin cabeza o una aplicación completa.
-El UI cambia la superficie; instrucciones, skills y actions le dan al agente su
-orientación y comportamiento.
-
-## 1. Crea tu aplicación
-
-Necesitarás [Node.js 22+](https://nodejs.org) y [pnpm](https://pnpm.io).
-
-Ejecute `create` sin indicadores y le preguntará cómo desea comenzar (una plantilla completa,
-Chat o Headless) antes que nada:
+# Primeros pasos
 
-```bash
-npx @agent-native/core@latest create my-app
-```
+Agent-Native sirve para crear agentic applications: el AI agent y la UI comparten las mismas [actions](/docs/actions), datos SQL y application state. El camino principal empieza con Chat para que los usuarios puedan hablar con el agent de inmediato, y después añade las superficies de producto que el flujo necesita.
+
+El recorrido útil es:
+
+1. Crear una Chat app.
+2. Añadir una action.
+3. Renderizar el resultado de la action dentro del chat.
+4. Persistir datos en SQL.
+5. Añadir una página que el agent pueda abrir cuando conviene inspeccionar el resultado visualmente.
 
-O pase una marca para omitir el mensaje:
+## 1. Crea una Chat app {#create-your-app}
 
-**¿Quieres un UI?** Comience desde la plantilla de Chat. Obtienes un agente de trabajo más un
-Chat personalizable UI, y cada acción que agregas se muestra automáticamente en él:
+Necesitas [Node.js 22+](https://nodejs.org) y [pnpm](https://pnpm.io).
 
 ```bash
 npx @agent-native/core@latest create my-app --template chat
+cd my-app
+pnpm install
+pnpm dev
 ```
 
-**¿Solo la primitiva sin cabeza?** Comience sin cabeza: el mismo actions y agente
-bucle, sin shell UI:
-
-```bash
-npx @agent-native/core@latest create my-agent --headless
+El template incluye durable chat threads, auth, live sync, un directorio `actions/`, las actions estándar `view-screen` y `navigate`, y una app React lista para extender.
+
+## 2. Añade una action {#add-an-action}
+
+Una action es una operación tipada que comparten el agent y la UI. Para este flujo, crea `actions/analyze-responses.ts`: analiza respuestas de formularios y devuelve una forma validada para un gráfico de chat propio.
+
+<!-- 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: "Gráfico de respuestas" 
+  },
+  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 }],
+  }),
+});
 ```
 
-Luego instálelo desde la carpeta que creó:
+Pruébala directamente:
 
 ```bash
-cd my-agent # o my-app si elegiste la plantilla Chat
-pnpm install
+pnpm action analyze-responses --formId demo
 ```
 
-A partir de ahora, los dos son idénticos.
-
-## 2. Añadir una acción
-
-Una acción es una operación que su agente (y su UI) pueden realizar. Ambos andamios
-envío con este ejemplo:
-
-<AnnotatedCode
-  id="doc-block-h1yk8m"
-  title="Tu primera 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: "Saluda desde el agente 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: "Descripción de herramienta",
-      note: "El agente lee `description` para decidir cuándo llamarla como herramienta.",
-    },
-    {
-      lines: "6-8",
-      label: "Contrato tipado",
-      note: "Un `schema` de zod valida entradas desde cada superficie: agente, UI, HTTP, MCP y A2A.",
-    },
-    {
-      lines: "9",
-      label: "Verbo HTTP",
-      note: "Expón esta acción como un endpoint HTTP montado automáticamente.",
-    },
-    {
-      lines: "10",
-      label: "Solo lectura",
-      note: "`readOnly` marca la acción como segura para llamar sin aprobación y cacheable para consultas.",
-    },
-    {
-      lines: "11-13",
-      label: "Una implementación",
-      note: "El cuerpo de `run` es la única fuente de verdad que ejecutan todas las superficies.",
-    },
-  ]}
-/>
-
-Reemplace `hello` con la primera operación real en su dominio. Lo defines una vez;
-todas las superficies lo recogen.
-
-Utilice `AGENTS.md` como guía que debe aplicarse en cada giro. Usa una habilidad cuando
-el agente necesita un flujo de trabajo o un procedimiento de dominio reutilizable. Utilice una acción cuando
-el agente necesita una forma escrita y comprobable de leer datos, escribir datos, llamar a un API o
-realizar una aprobación.
-
-## 3. Ejecútelo
-
-Llame a la acción directamente:
+O pídeselo al agent en el navegador:
 
-```bash
-pnpm action hello --name Steve
-```
+> Analiza las respuestas recientes del formulario de demo.
 
-O pídale al agente que lo llame por usted:
+## 3. Renderiza el resultado en chat {#render-inline}
 
-```bash
-pnpm agent "Call the hello action for Steve and explain what happened."
-```
+Como la action declara `outputSchema` y una `chatUI.renderer` específica del producto, el transcript no convierte los datos en texto plano. Registra un componente React para ese id exacto desde el arranque de la app, por ejemplo importando `app/chat-renderers.tsx` una vez desde `app/root.tsx`:
 
-Si comenzó desde la plantilla de Chat, ejecute la aplicación y use el mismo agente en
-navegador: ya puede llamar a cada acción que definas:
+<!-- 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,
+});
 ```
 
-Ahora se puede acceder a esa acción desde el chat UI, CLI, HTTP, MCP, A2A,
-trabajos programados y webhooks. Defina una vez y llame desde cualquier lugar.
-
-<Diagram id="doc-block-xk8dna" title={"Una acción, cada superficie"} summary={"Un único archivo defineAction se distribuye a cada consumidor sin cableado adicional."}>
-
-```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">Interfaz 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">Trabajos programados</span
-    ><span class="diagram-pill">Webhooks</span>
-  </div>
-</div>
-```
+Para salidas genéricas reutilizables, el framework también incluye renderers integrados `data-chart` y `data-table`, además de `data-insights` para tarjetas combinadas de resumen/gráfico/tabla. Consulta [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-es">
+  <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'>Analiza respuestas de demo.</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'>Renderizado con responses.response-chart.</p><section class='wf-card' data-rough style='padding:14px'><h3 style='margin:0 0 12px;font-size:14px'>Gráfico de respuestas</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'>Mié</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'>Jue</span></div></div></section></div></div></div>"
+    }
+  />
+</WireframeBlock>
 
-</Diagram>
+## 4. Persiste datos en SQL {#persist-data}
 
-## El estado está integrado
+Cuando el resultado debe revisarse, compararse o actualizarse, guárdalo en SQL y mantén las lecturas/escrituras detrás de actions:
 
-Sin cabeza no significa apátrida. Actions, sesiones, estado de la aplicación, subprocesos,
-el historial de ejecución y las credenciales se encuentran en SQL. A nivel local es SQLite en
-`data/app.db`; en producción se configura `DATABASE_URL`. Ver
-[Deployment](/docs/deployment).
+Define la tabla con los helpers portables del framework, no con imports de `drizzle-orm/sqlite-core` o `drizzle-orm/pg-core`:
 
-<Callout id="doc-block-1a7o3u1" tone="info">
+```ts
+// server/db/schema.ts
+import { integer, now, table, text } from "@agent-native/core/db/schema";
 
-**Headless sigue siendo una aplicación real.** El bucle aplicación-agente persiste sesiones, subprocesos, ejecuciones, configuraciones y credenciales en SQL; no es un mensaje sin estado. Puede agregar una interfaz de usuario más tarde sin tocar sus acciones o estado.
+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>
+Estos helpers eligen el backend SQL configurado, así que el mismo schema puede correr en SQLite local y en producción con Postgres, Turso/libSQL, D1 u otro provider SQL soportado.
 
-## Personaliza el UI
+- `create-response-insight` escribe un insight nuevo.
+- `list-response-insights` lee los datos para la página.
+- `update-response-insight` actualiza un registro.
+- `analyze-responses` sigue devolviendo el widget nativo del chat.
 
-Si comenzó desde la plantilla de Chat, el UI es suyo para editarlo. El chat en sí
-es una pequeña ruta construida sobre el componente `<AgentChatSurface>`:
+No crees una REST route duplicada solo para el navegador; la UI y el agent deben compartir actions.
 
-```tsx
-// app/routes/_index.tsx
-import { AgentChatSurface } from "@agent-native/core/client";
+## 5. Añade una página que el agent pueda abrir {#add-a-page}
 
-export default function ChatRoute() {
-  return <AgentChatSurface mode="page" className="h-full" />;
-}
-```
+Añade una route `/response-insights` con `useActionQuery("list-response-insights")` y `useActionMutation("create-response-insight")`. La página es una proyección del SQL state; los datos siguen escribiéndose por las mismas actions.
 
-- **`app/routes/_index.tsx`**: la página de chat. Cambiar las sugerencias, vacía
-  estado y diseño.
-- **`app/root.tsx`**: el shell de la aplicación. Añade tus propias rutas y pantallas alrededor del
-  agente.
-- Suelte el agente en cualquier pantalla con `<AgentSidebar>`, trabaje manualmente desde un
-  botón con `sendToAgentChat()`, o ejecuta una acción directamente con
-  `useActionMutation()`.
+<WireframeBlock id="doc-block-response-insights-page-wireframe-es">
+  <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 respuestas</h2><p class='wf-muted' style='margin:0'>Insights que el agente creó a partir de respuestas del formulario.</p></header><button class='primary' data-rough style='align-self:flex-start'>Analizar formulario demo</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>Tema de precios</strong><p class='wf-muted' style='margin:8px 0 0'>Los usuarios piden un plan de equipo.</p></article><article class='wf-box' data-rough style='padding:12px'><strong>Abandono en onboarding</strong><p class='wf-muted' style='margin:8px 0 0'>Tres pasos necesitan textos más claros.</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>Formulario de demo</strong><span class='wf-muted'>42 respuestas analizadas</span></div><div class='wf-row wf-box' data-rough style='padding:10px 12px;gap:12px;justify-content:space-between'><strong>Siguiente paso</strong><span class='wf-muted'>Revisar dos borradores de 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'>Tú</span><p style='margin:4px 0 0'>Abre insights de respuestas.</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 respuestas abiertos.</p></div></aside></section></main>"
+    }
+  />
+</WireframeBlock>
 
-Consulte [Drop-in Agent](/docs/drop-in-agent) para conocer el conjunto completo de componentes y
-[Native Interfaz de chat](/docs/native-chat-ui) para representar los resultados de la acción como tablas,
-gráficos y tarjetas mecanografiadas en lugar de texto sin formato.
+Extiende `view-screen` y `navigate` para que el agent conozca la route actual y pueda abrir `/response-insights`. Los resultados también pueden incluir `href: "/response-insights"` para mostrar un botón "Abrir insights de respuestas".
 
-**¿Empezaste sin cabeza y quieres un UI más tarde?** La plantilla de chat _es_ la rampa de acceso a UI —
-su capa `app/` (React Router + Vite) es exactamente lo que el andamio sin cabeza
-se va. El movimiento más limpio es comenzar (o reestructurar) desde el Chat
-plantilla; su estado `actions/`, agente y SQL se mantienen sin cambios. Ver
-[Agent Surfaces](/docs/agent-surfaces) para cada superficie intermedia.
+Cuando el chat de página completa abra una página de app, usa `AgentChatSurface`, `AgentSidebar`, `useAgentChatHomeHandoff`, `useAgentChatHomeHandoffLinks` y `chatViewTransition` desde [Agent Surfaces](/docs/agent-surfaces#rich-chat) para deslizar el chat al panel lateral sin perder el thread.
 
-## Estructura del proyecto
+## Estructura del proyecto {#project-structure}
 
 ```text
 my-app/
-  actions/         # Acciones que puede llamar el agente
-  app/             # Frontend React (solo plantillas UI; se omite en headless)
-  server/          # Servidor API Nitro (rutas, plugins)
-  AGENTS.md        # Instrucciones permanentes para el agente
-  .agents/         # Skills que el agente puede cargar cuando sean relevantes
+  actions/         # Operaciones invocables por el agente y la interfaz
+  app/             # Rutas, páginas y superficies de chat de React
+  server/          # Servidor Nitro y esquema SQL
+  AGENTS.md        # Instrucciones siempre activas para el agente de la app
+  .agents/         # Skills que el agente carga cuando corresponde
   data/app.db      # Estado SQLite local cuando DATABASE_URL no está definido
 ```
 
-## Adónde ir a continuación
-
-- **[Key Concepts](/docs/key-concepts)**: la arquitectura principal: SQL, actions,
-  sincronización y reconocimiento del contexto.
-- **[Actions](/docs/actions)**: la acción completa API: esquemas, HTTP, autenticación y
-  aprobación.
-- **[Agent Surfaces](/docs/agent-surfaces)**: sin cabeza, chat, sidecar integrado,
-  y aplicación completa.
-- **[Drop-in Agent](/docs/drop-in-agent)**: agrega el chat del agente a cualquier aplicación React.
-- **[Deployment](/docs/deployment)**: coloca tu aplicación en tu propio dominio.
-- **[FAQ](/docs/faq)**: preguntas sobre configuración y productos.
+## ¿Quieres un punto de partida completo para analytics? {#analytics-starting-point}
+
+El ejemplo de Insights de respuestas anterior es pequeño a propósito para mostrar las piezas del framework. Si vas a crear un producto real de analytics, empieza con [Analytics](/docs/template-analytics). Es el punto de partida robusto: conecta tus providers, usa los dashboards y agent actions existentes, y personaliza desde ahí.
+
+## Siguientes pasos {#next}
+
+- **[Actions](/docs/actions)** — schemas, auth, approvals, hooks y transport.
+- **[Native Chat UI](/docs/native-chat-ui)** — tablas, gráficos y typed cards para resultados de actions.
+- **[Chat Template](/docs/template-chat)** — la app mínima chat-first.
+- **[Analytics Template](/docs/template-analytics)** — una base robusta para analytics; conecta providers y personaliza desde ahí.
+- **[Context Awareness](/docs/context-awareness)** — `view-screen`, `navigate`, route state y objetos seleccionados.
+- **[Agent Surfaces](/docs/agent-surfaces)** — chat, inline UI, app pages, embedded sidecars, automation y agents externos.

package/docs/content/locales/es-ES/pure-agent-apps.mdx

@@ -1,16 +1,11 @@
 ---
-title: "Aplicaciones de agente puro"
-description: "Aplicaciones donde el agente es el producto completo: el bucle aplicación-agente es la puerta de entrada y UI se agrega solo cuando los humanos lo necesitan."
+title: "Automation-First Apps"
+description: "Apps Agent-Native sin navegador para scheduled jobs, colas, scripts, integration workers y agents externos."
 ---
 
-# Aplicaciones de agente puro
+# Automation-First Apps
 
-Una aplicación de agente puro es el extremo mínimo de un agente nativo: el bucle aplicación-agente es el
-producto, no un tablero. Envías una solicitud desde la terminal, Slack, correo electrónico, a
-trabajo programado, otro agente o Chat: "resumir mis correos electrónicos no leídos", "publicar el
-métricas diarias a Slack" — y el agente actúa y devuelve el resultado dondequiera que esté
-pertenece. Sigue siendo una aplicación real: actions, sesiones, estado de la aplicación, historial,
-La configuración, las credenciales y los registros compartidos se encuentran todos en SQL.
+Una automation-first app es una app Agent-Native sin navegador para scheduled jobs, colas, scripts, integration workers y agents externos. No es el camino predeterminado de Getting Started, pero es útil cuando el workflow todavía no necesita una página. Sigue siendo una app real: actions, sessions, application state, run history, settings, credentials y registros compartidos viven en SQL.
 
 <Diagram id="doc-block-16rgm92" title={"El bucle aplicación-agente es la puerta de entrada"} summary={"Muchos puntos de entrada llegan a un bucle de agente sobre SQL-backed acciones y estado; los resultados regresan al lugar de donde vino la solicitud. La interfaz de usuario se agrega solo cuando los humanos necesitan supervisar."}>
 

package/docs/content/locales/es-ES/template-chat.mdx

@@ -7,7 +7,7 @@ description: "Una aplicación nativa de agente mínima que prioriza el chat: hil
 
 El chat es el punto de partida básico de la aplicación nativa del agente. Le brinda un shell limpio estilo ChatGPT con chat en el centro, una lista de hilos a la izquierda, navegación de aplicaciones estándar, autenticación, sincronización en vivo, actions y una acción de ejemplo. Comience aquí cuando desee una aplicación de navegador real que pueda desarrollar sin comprometerse con una plantilla de dominio.
 
-Si desea el tiempo de ejecución más pequeño de solo acciones sin navegador UI, comience con [Pure-Agent Apps](/docs/pure-agent-apps). Si desea una forma de producto de dominio terminada, comience con [Calendar](/docs/template-calendar), [Mail](/docs/template-mail), [Content](/docs/template-content), [Forms](/docs/template-forms), [Analytics](/docs/template-analytics) u otra plantilla de dominio.
+Si desea un runtime automation-first sin navegador UI, comience con [Automation-First Apps](/docs/pure-agent-apps). Si desea una forma de producto de dominio terminada, comience con [Calendar](/docs/template-calendar), [Mail](/docs/template-mail), [Content](/docs/template-content), [Forms](/docs/template-forms), [Analytics](/docs/template-analytics) u otra plantilla de dominio.
 
 <WireframeBlock id="doc-block-1yw4lnu">
   <Screen
@@ -200,4 +200,4 @@ El agente debe agregar un esquema Drizzle, actions, ruta, navegación e instrucc
 - [**Agent Surfaces**](/docs/agent-surfaces): patrones headless, chat, integrados y de aplicación completa
 - [**Actions**](/docs/actions): el chat del sistema de acción y UI llaman
 - [**Native Interfaz de chat**](/docs/native-chat-ui): primitivas de la superficie de chat y opciones de tiempo de ejecución
-- [**Pure-Agent Apps**](/docs/pure-agent-apps): aplicaciones de solo acción que pueden convertirse en Chat más adelante
+- [**Automation-First Apps**](/docs/pure-agent-apps): automatizaciones, colas, scripts y workflows de agents externos sin UI de navegador

package/docs/content/locales/es-ES/using-your-agent.mdx

@@ -99,7 +99,7 @@ El agente no es una aplicación independiente a la que puedes acceder. Se envía
 
 No todas las aplicaciones necesitan un panel completo. Cuando el agente _es_ el producto, puede omitir la mayor parte del UI personalizado: abra la aplicación, solicite lo que desee y deje que el agente haga el resto. El agente todavía tiene su superficie de administración (historial, espacio de trabajo, configuración), pero la interacción principal es la conversación en lugar de los clics.
 
-→ [**Pure-Agent Apps**](/docs/pure-agent-apps): aplicaciones donde el agente es el producto completo.
+→ [**Automation-First Apps**](/docs/pure-agent-apps): apps sin navegador para jobs, colas, scripts y agents externos.
 
 ## Coeditas con él {#you-co-edit}
 
@@ -113,5 +113,5 @@ Cuando usted y el agente trabajan en el mismo documento, no se turnan. Con la co
 - [**Agent Mentions**](/docs/agent-mentions): dirígelo con menciones `@`
 - [**Voice Input**](/docs/voice-input): dirígelo hablando
 - [**Drop-in Agent**](/docs/drop-in-agent): incrustarlo en cualquier aplicación React
-- [**Pure-Agent Apps**](/docs/pure-agent-apps): pasa a UI ligera cuando el agente es el producto
+- [**Automation-First Apps**](/docs/pure-agent-apps): apps sin navegador para jobs, colas, scripts y agents externos
 - [**Real-Time Collaboration**](/docs/real-time-collaboration): coeditar el mismo documento juntos

package/docs/content/locales/fr-FR/cloneable-saas.mdx

@@ -30,7 +30,7 @@ Chacune est une véritable application que vous pouvez utiliser aujourd'hui, et
 | [**Plan**](/docs/template-plan)           | Plans visuels et récapitulatifs des relations publiques avec diagrammes, wireframes et annotations.                                                            |
 | [**Dispatch**](/docs/template-dispatch)   | Le plan de contrôle de l'espace de travail : secrets partagés, intégrations réutilisables, Slack/Telegram, tâches planifiées.                                  |
 
-Vous ne voulez pas d'application de domaine ? Utilisez [Chat](/docs/template-chat) lorsque vous souhaitez une application de base avec laquelle les utilisateurs peuvent parler immédiatement, ou commencez par une action dans [Pure-Agent Apps](/docs/pure-agent-apps).
+Vous ne voulez pas d'application de domaine ? Utilisez [Chat](/docs/template-chat) lorsque vous souhaitez une application de base avec laquelle les utilisateurs peuvent parler immédiatement et que vous pouvez étendre avec des actions, des résultats natifs et des écrans. Utilisez [Automation-First Apps](/docs/pure-agent-apps) seulement lorsque le workflow n'a pas encore besoin d'UI navigateur.
 
 Consultez le catalogue complet sous [Apps](/apps) ou passez directement à l'un d'entre eux. Par exemple, [Dispatch](/docs/template-dispatch) est un excellent point de départ si vous souhaitez une application de style espace de travail.
 
@@ -182,7 +182,7 @@ Si vous créez un échafaudage maintenant, la commande CLI est :
 npx @agent-native/core@latest create my-platform
 ```
 
-Vous obtiendrez un sélecteur à sélection multiple. Choisissez une application (autonome) ou plusieurs (espace de travail : les applications partagent l'authentification, la marque, la configuration de l'agent et la base de données). Chaque modèle sélectionné est intégré dans `apps/<name>/` avec chaque fichier dont vous avez besoin. Pour une application d'action uniquement au lieu d'un modèle UI, utilisez `npx @agent-native/core@latest create my-agent --headless`.
+Vous obtiendrez un sélecteur à sélection multiple. Choisissez une application (autonome) ou plusieurs (espace de travail : les applications partagent l'authentification, la marque, la configuration de l'agent et la base de données). Chaque modèle sélectionné est intégré dans `apps/<name>/` avec chaque fichier dont vous avez besoin. Pour une automation sans UI navigateur au lieu d'un modèle UI, utilisez `npx @agent-native/core@latest create my-agent --headless`.
 
 Remplissez `.env` (principalement `ANTHROPIC_API_KEY` et `DATABASE_URL`), `pnpm install`, `pnpm dev`, et cela fonctionne. Pas de "TODO : implémenter la connexion", pas de routes d'espace réservé.
 

package/docs/content/locales/fr-FR/faq.mdx

@@ -11,15 +11,15 @@ Questions courantes sur les agents natifs, organisées de "Je cherche juste" à
 
 ### Qu'est-ce que l'agent natif ? {#what-is-agent-native}
 
-Agent-native est un cadre permettant de créer des applications dans lesquelles l'agent IA et le produit qui l'entoure sont des partenaires égaux. Cette surface peut commencer comme un agent sans tête avec une action personnalisée, se transformer en un chat riche ou devenir un UI complet. L'invariant est que les agents et les humains partagent le même actions, la même base de données et le même état. Voir [What Is Agent-Native?](/docs/what-is-agent-native) pour l'explication complète.
+Agent-native est un cadre permettant de créer des applications dans lesquelles l'agent IA et le produit qui l'entoure sont des partenaires égaux. Le chemin courant commence par le chat, ajoute des actions typées, rend des résultats structurés en ligne, puis grandit vers des pages durables autour du même état SQL. L'invariant est que les agents et les humains partagent le même actions, la même base de données et le même état. Voir [What Is Agent-Native?](/docs/what-is-agent-native) pour l'explication complète.
 
 ### À qui est-ce destiné ? {#who-is-this-for}
 
 Agent-native est destiné aux personnes qui souhaitent qu'une véritable application et un agent IA fonctionnent à partir des mêmes données et actions. Les chemins courants sont :
 
 - **Utilisez une application hébergée** si vous souhaitez recevoir un courrier, un calendrier, des formulaires, un plan ou un autre modèle fini sans configuration – commencez par le [template gallery](/templates).
-- **Commencez avec Chat** si vous souhaitez une application de base avec laquelle les utilisateurs peuvent parler immédiatement, puis étendez-la avec actions et les écrans – commencez par [Getting Started](/docs/getting-started) ou [Chat](/docs/template-chat).
-- **Démarrez d'abord les primitives** si vous souhaitez une action et une boucle d'agent d'application sans tête avant de vous engager dans UI — commencez par [Getting Started](/docs/getting-started).
+- **Commencez avec Chat** si vous souhaitez le chemin par défaut depuis zéro : les utilisateurs parlent immédiatement à l'agent, puis vous étendez avec actions, résultats natifs et écrans – commencez par [Getting Started](/docs/getting-started) ou [Chat](/docs/template-chat).
+- **Commencez automation-first** si vous créez des tâches planifiées, files, scripts, integration workers ou workflows d'agents externes sans UI navigateur pour le moment — commencez par [Automation-First Apps](/docs/pure-agent-apps).
 - ** Créez et personnalisez un modèle ** si vous souhaitez créer votre propre produit SaaS avec authentification, base de données, UI et agent actions déjà câblés – voir [Templates](/docs/cloneable-saas).
 - **Construisez à partir de zéro** si vous souhaitez les primitives de structure pour un nouveau produit piloté par agent : commencez par [Getting Started](/docs/getting-started).
 - **Connectez un autre agent ou un autre outil de code** si vous souhaitez que Claude, ChatGPT, Codex, Cursor ou GitHub Copilot / VS Code utilisent une application native d'agent – voir [External Agents](/docs/external-agents) et [Skills Guide](/docs/skills-guide).
@@ -130,7 +130,7 @@ C'est là tout l'intérêt. Créez un modèle et personnalisez-le en le demandan
 
 ### Puis-je créer quelque chose que les modèles ne couvrent pas ? {#build-from-scratch}
 
-Oui. Si vous souhaitez une application de chat de base, exécutez `npx @agent-native/core@latest create my-chat-app --template chat` ; vous bénéficiez de fils de discussion durables, de actions, d'une authentification, d'un état d'exécution soutenu par SQL et d'un espace pour ajouter vos propres écrans. Si vous souhaitez la plus petite application axée sur l'action sans UI, exécutez `npx @agent-native/core@latest create my-agent --headless`. Voir [Getting Started](/docs/getting-started), [Pure-Agent Apps](/docs/pure-agent-apps) et [Chat](/docs/template-chat).
+Oui. Si vous souhaitez une app agentic de base, exécutez `npx @agent-native/core@latest create my-chat-app --template chat` ; vous bénéficiez de fils de discussion durables, de actions, d'une authentification, d'un état d'exécution soutenu par SQL, d'un rendu natif en ligne et d'un espace pour ajouter vos propres écrans. Si vous créez une automation sans navigateur, exécutez `npx @agent-native/core@latest create my-agent --headless`. Voir [Getting Started](/docs/getting-started), [Automation-First Apps](/docs/pure-agent-apps) et [Chat](/docs/template-chat).
 
 ### Puis-je l'essayer sans créer de modèle ? {#try-with-a-skill}