@agent-native/core 0.84.35 → 0.84.36

package/docs/content/locales/ja-JP/getting-started.mdx

@@ -1,259 +1,193 @@
 ---
 title: "はじめに"
-description: "エージェント アプリを作成し、命令、skills、actions を理解してから、エージェントが最初のアクションを呼び出す様子を観察します。"
+description: "チャットから始まる agentic app を作成し、action を追加し、構造化結果をインライン表示して、agent が開ける永続ページへ広げます。"
 ---
 
 # はじめに
 
-Agent-Native アプリは、AI エージェントと UI に同じ actions、データ、および
-状態。基本的なエージェントは、それをガイドする命令 (skills) から作成されます。
-再現可能な動作と、実際の作業を可能にする actions。
-
-**完全なアプリから開始したいですか?** 豊富なテンプレートの 1 つを複製します —
-[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-10kfbl8"
-  title={"基本的な Agent-Native エージェント"}
-  entries={[
-    {
-      path: "AGENTS.md",
-      note: "常時有効な指示: 目的、ルール、トーン、エージェントができることのマップ",
-    },
-    {
-      path: ".agents/skills/customer-research/SKILL.md",
-      note: "タスクが一致したときにエージェントが読み込む再利用可能な playbook",
-    },
-    {
-      path: "actions/summarize-week.ts",
-      note: "エージェント、UI、CLI、HTTP、MCP、A2A、jobs、webhooks が実行できる型付きコード",
-    },
-  ]}
-/>
-
-これは、チャット UI、ヘッドレス エージェント、または完全なアプリから開始するかどうかに当てはまります。
-UI は表面を変更します。命令、skills、および actions はエージェントに
-指導と行動。
-
-## 1.アプリを作成します
+Agent-Native は agentic applications を作るためのフレームワークです。AI agent と UI は同じ [actions](/docs/actions)、SQL データ、application state を共有します。最初に headless agent を作るのではなく、ユーザーがすぐ会話できる Chat app から始め、必要なアプリ画面を足していきます。
 
-[Node.js 22+](https://nodejs.org) と [pnpm](https://pnpm.io) が必要です。
-
-フラグなしで `create` を実行すると、どのように開始するかを尋ねられます (完全なテンプレート、
-チャット、またはヘッドレス) 他の何よりも前に:
+基本の流れ:
 
-```bash
-npx @agent-native/core@latest create my-app
-```
+1. Chat app を作成する。
+2. action を追加する。
+3. action の結果をチャット内のネイティブ UI として表示する。
+4. データを SQL に永続化する。
+5. 視覚的に確認したいときに 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
+このテンプレートには durable chat threads、auth、live sync、`actions/` ディレクトリ、標準の `view-screen` / `navigate` actions、拡張できる React app が含まれます。
+
+## 2. action を追加する {#add-an-action}
+
+action は agent と UI が共有する typed operation です。この流れでは `actions/analyze-responses.ts` を作成し、フォーム回答を分析してカスタムチャットグラフ用の検証済み形状を返します。
+
+{/* 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 つは同じです。
-
-## 2.アクションを追加
-
-アクションとは、エージェント (および UI) が呼び出すことができる 1 つの操作です。両方の足場
-このサンプルが同梱されています:
-
-<AnnotatedCode
-  id="doc-block-7yg0w9"
-  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: "ローカルエージェントから挨拶します。",\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: "エージェントは `description` を読み、いつツールとして呼び出すかを判断します。",
-    },
-    {
-      lines: "6-8",
-      label: "型付き契約",
-      note: "1 つの zod `schema` が、エージェント、UI、HTTP、MCP、A2A のすべての入力を検証します。",
-    },
-    {
-      lines: "9",
-      label: "HTTP 動詞",
-      note: "このアクションを自動マウントされる HTTP エンドポイントとして公開します。",
-    },
-    {
-      lines: "10",
-      label: "読み取り専用",
-      note: "`readOnly` は、このアクションが承認なしで安全に呼び出せ、クエリとしてキャッシュ可能であることを示します。",
-    },
-    {
-      lines: "11-13",
-      label: "単一の実装",
-      note: "`run` 本体は、すべてのサーフェスが実行する唯一の信頼できる実装です。",
-    },
-  ]}
-/>
-
-`hello` をドメイン内の最初の実際の操作に置き換えます。一度定義すれば、
-あらゆる表面がそれを拾います。
-
-毎ターン適用されるガイダンスとして `AGENTS.md` を使用してください。
-エージェントには、再利用可能なワークフローまたはドメイン プロシージャが必要です。
-エージェントには、データの読み取り、書き込み、API の呼び出しなどを行うための、型指定されたテスト可能な方法が必要です。
-承認を実行します。
-
-## 3.実行してください
-
-アクションを直接呼び出します:
+またはブラウザーで agent に依頼します:
 
-```bash
-pnpm action hello --name Steve
-```
+> デモフォームの最近の回答を分析して。
 
-または、エージェントに電話してもらうよう依頼してください。
+## 3. チャット内に結果を表示する {#render-inline}
 
-```bash
-pnpm agent "Call the hello action for Steve and explain what happened."
-```
+action が `outputSchema` とプロダクト固有の `chatUI.renderer` を宣言しているため、チャットは構造化データを長い文章に潰しません。次に、app の起動時にその正確な renderer id に対応する React コンポーネントを登録します。たとえば `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,
+});
 ```
 
-その 1 つのアクションは、チャット UI、CLI、HTTP、MCP、A2A からアクセスできるようになりました。
-スケジュールされたジョブ、および webhooks。一度定義すれば、どこからでも呼び出すことができます。
-
-<Diagram id="doc-block-1e9l236" title={"1 つのアクションであらゆる面に対応"} 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>
-```
+再利用できる汎用出力には、framework 組み込みの `data-chart` と `data-table` renderers も使えます。`data-insights` は summary/chart/table を組み合わせたカード向けです。詳しくは [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-ja">
+  <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 に永続化する {#persist-data}
 
-## 状態は組み込まれています
+結果を後で見返す、比較する、更新する必要があるなら SQL に保存し、読み書きは actions の後ろに置きます。
 
-ヘッドレスはステートレスを意味するものではありません。 Actions、セッション、アプリケーションの状態、スレッド、
-実行履歴と資格情報はすべて SQL に存在します。ローカルでは、
-`data/app.db`;運用環境では、`DATABASE_URL` を設定します。参照
-[Deployment](/docs/deployment).
+テーブルは `drizzle-orm/sqlite-core` や `drizzle-orm/pg-core` から import するのではなく、framework のポータブルな helper で定義します。
 
-<Callout id="doc-block-1st025c" 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>
+これらの helper は設定された SQL backend を選ぶため、同じ schema がローカルの SQLite と、production の Postgres、Turso/libSQL、D1、その他の対応 SQL provider で動きます。
 
-## UI をカスタマイズ
+- `create-response-insight` は新しい insight を書き込みます。
+- `list-response-insights` はページ用のデータを読みます。
+- `update-response-insight` はレコードを更新します。
+- `analyze-responses` はチャット用のネイティブ widget を返し続けます。
 
-チャット テンプレートから開始した場合は、UI を編集できます。チャット自体
-`<AgentChatSurface>` コンポーネント上に構築された 1 つの小さなルートです:
+ブラウザー専用の重複 REST route は作らず、UI と agent が actions を共有します。
 
-```tsx
-// app/routes/_index.tsx
-import { AgentChatSurface } from "@agent-native/core/client";
+## 5. agent が開けるページを追加する {#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")` を使います。このページは SQL state の表示であり、データは同じ actions で書き込まれます。
 
-- **`app/routes/_index.tsx`** — チャット ページ。提案を変更します。空白
-  状態、レイアウト。
-- **`app/root.tsx`** — アプリシェル。
-  エージェント。
-- `<AgentSidebar>` を使用してエージェントを任意の画面にドロップし、手動で操作します
-  `sendToAgentChat()` でボタンを押すか、
-  `useActionMutation()`.
+<WireframeBlock id="doc-block-response-insights-page-wireframe-ja">
+  <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'>回答インサイト</h2><p class='wf-muted' style='margin:0'>エージェントがフォーム回答から作成したインサイト。</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'>3つのステップにより明確な文言が必要です。</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'>2件のインサイト下書きを確認</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'>回答インサイトを開く。</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'>回答インサイトを開きました。</p></div></aside></section></main>"
+    }
+  />
+</WireframeBlock>
 
-完全なコンポーネント セットについては、[Drop-in Agent](/docs/drop-in-agent) を参照してください。
-[Native チャット UI](/docs/native-chat-ui) はアクションの結果をテーブルとしてレンダリングします。
-プレーンテキストの代わりにグラフと入力されたカード。
+`view-screen` と `navigate` を拡張し、agent が現在の route を理解して `/response-insights` を開けるようにします。結果に `href: "/response-insights"` を含めれば、チャットに "回答インサイトを開く" ボタンを表示できます。
 
-**ヘッドレスで始めましたが、後で UI が必要ですか?** チャット テンプレートは UI オンランプです —
-その `app/` レイヤー (React ルーター + Vite) はまさにヘッドレス足場です
-は除外されます。最もクリーンな方法は、チャットから開始 (または再スキャフォールディング) することです
-テンプレート; `actions/`、エージェント、および SQL の状態は変更されずに引き継がれます。参照
-間にあるすべてのサーフェスに対して [Agent Surfaces](/docs/agent-surfaces)。
+フルページ chat から app ページを開くときは、[Agent Surfaces](/docs/agent-surfaces#rich-chat) の `AgentChatSurface`、`AgentSidebar`、`useAgentChatHomeHandoff`、`useAgentChatHomeHandoffLinks`、`chatViewTransition` を使い、同じ thread のままチャットをサイドバーへ移動します。
 
-## プロジェクトの構造
+## プロジェクト構成 {#project-structure}
 
 ```text
 my-app/
-  actions/         # エージェントが呼び出せるアクション
-  app/             # React フロントエンド（UI テンプレートのみ。headless では省略）
-  server/          # Nitro API サーバー（ルート、プラグイン）
-  AGENTS.md        # 常に適用されるエージェント指示
+  actions/         # エージェントとUIから呼び出せる操作
+  app/             # Reactのルート、ページ、チャット画面
+  server/          # NitroサーバーとSQLスキーマ
+  AGENTS.md        # アプリアージェントの常時有効な指示
   .agents/         # 必要に応じてエージェントが読み込むスキル
-  data/app.db      # DATABASE_URL 未設定時のローカル SQLite 状態
+  data/app.db      # DATABASE_URL未設定時のローカルSQLite状態
 ```
 
-## 次にどこに行くか
-
-- **[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 の出発点が必要な場合 {#analytics-starting-point}
+
+上の 回答インサイト 例は、framework の部品を見やすくするために小さくしています。実際の analytics product を作るなら、[Analytics](/docs/template-analytics) から始めてください。providers を接続し、既存の dashboards と agent actions を使い、そこからカスタマイズできる堅牢な出発点です。
+
+## 次のステップ {#next}
+
+- **[Actions](/docs/actions)** — schemas、auth、approvals、hooks、transport。
+- **[Native Chat UI](/docs/native-chat-ui)** — action 結果をテーブル、グラフ、typed cards として表示。
+- **[Chat Template](/docs/template-chat)** — 最小の chat-first app。
+- **[Analytics Template](/docs/template-analytics)** — 堅牢な analytics app の出発点。providers を接続してカスタマイズできます。
+- **[Context Awareness](/docs/context-awareness)** — `view-screen`、`navigate`、route state、選択中のオブジェクト。
+- **[Agent Surfaces](/docs/agent-surfaces)** — chat、inline UI、app pages、embedded sidecars、automation、外部 agent。

package/docs/content/locales/ja-JP/pure-agent-apps.mdx

@@ -1,16 +1,11 @@
 ---
-title: "純粋なエージェント アプリ"
-description: "エージェントが製品全体であるアプリ: アプリとエージェントのループが玄関口であり、UI は人間が必要とする場合にのみ追加されます。"
+title: "Automation-First Apps"
+description: "scheduled jobs、queues、scripts、integration workers、external agents 向けのブラウザーなし Agent-Native apps。"
 ---
 
-# 純粋なエージェント アプリ
+# Automation-First Apps
 
-純粋なエージェント アプリは、エージェント ネイティブの最小限の終端です。アプリとエージェントのループは、
-製品であり、ダッシュボードではありません。端末 Slack、電子メール、
-スケジュールされたジョブ、別のエージェント、またはチャット — 「未読メールの要約」、「投稿」
-毎日のメトリクスを Slack に送信します。エージェントはどこにいても動作し、結果を返します。
-に属します。これはまだ実際のアプリです: actions、セッション、アプリの状態、履歴
-設定、認証情報、共有レコードはすべて SQL に保存されます。
+Automation-first app は、scheduled jobs、queues、scripts、integration workers、external agents 向けのブラウザーなし Agent-Native app です。Getting Started の既定ルートではありませんが、workflow がまだページを必要としない場合に有用です。これはまだ実際の app です: actions、sessions、application state、run history、settings、credentials、共有レコードはすべて SQL に保存されます。
 
 <Diagram id="doc-block-1evvzm8" title={"アプリとエージェントのループが玄関口です"} summary={"多くのエントリ ポイントは、SQL-backed アクションと状態を介して 1 つのエージェント ループに到達します。結果はリクエストの送信元に返されます。 UIは人間が監視する必要がある場合にのみ追加されます。"}>
 
@@ -66,7 +61,7 @@ description: "エージェントが製品全体であるアプリ: アプリと
 作業がバックグラウンドで実行されているときにこの形状に到達すると、出力が残ります
 アプリ、ドメインはワンショットであるか、プロトタイピング中です。エージェントには依然として UI が必要です —
 ダッシュボードではなく、人間が管理、設定、操作するための場所です —
-これが、純粋なエージェント アプリでも通常、組み込みのチャット シェルをマウントする理由です。
+これが、automation-first apps でも通常、組み込みのチャット シェルをマウントする理由です。
 
 これは **ヘッドレス** 製品形状です。完全な意思決定ガイド、同梱物
 ボックス、スキャフォールド、リポジトリへのアクセス、および実行共有が 1 か所に存在するようになりました:
@@ -76,8 +71,8 @@ description: "エージェントが製品全体であるアプリ: アプリと
 ## 次は何ですか
 
 - [**Agent Surfaces — Headless**](/docs/agent-surfaces#headless) — 完全なヘッドレス意思決定ガイドと API
-- [**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) — automation-first app が呼び出すツール

package/docs/content/locales/ja-JP/template-chat.mdx

@@ -7,7 +7,7 @@ description: "最小限のチャットファーストのエージェントネイ
 
 チャットは、エージェントネイティブ アプリの基本的な開始点です。中央にチャット、左側にスレッド リスト、標準のアプリ ナビゲーション、認証、ライブ同期、actions、および 1 つのサンプル アクションを備えたクリーンな ChatGPT スタイルのシェルが提供されます。ドメイン テンプレートにコミットせずに構築できる実際のブラウザ アプリが必要な場合は、ここから始めてください。
 
-ブラウザー 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)、または別のドメイン テンプレートから開始してください。
+ブラウザー UI を使用しない automation-first runtime が必要な場合は、[Automation-First 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)、または別のドメイン テンプレートから開始してください。
 
 <WireframeBlock id="doc-block-12k6jf8">
   <Screen
@@ -200,4 +200,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) — ブラウザー UI のない automations、queues、scripts、external agent workflows

package/docs/content/locales/ja-JP/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 向けのブラウザーなしアプリ。
 
 ## あなたはそれを共同編集します {#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 向けのブラウザーなしアプリ
 - [**Real-Time Collaboration**](/docs/real-time-collaboration) — 同じドキュメントを一緒に共同編集します

package/docs/content/locales/ko-KR/cloneable-saas.mdx

@@ -30,7 +30,7 @@ description: "작동하는 SaaS 제품을 포크하여 귀하의 것으로 만
 | [**Plan**](/docs/template-plan)           | 다이어그램, 와이어프레임 및 주석을 포함한 시각적 계획 및 PR 요약                                                       |
 | [**Dispatch**](/docs/template-dispatch)   | 작업 공간 제어 플레인: 공유 비밀, 재사용 가능한 통합, Slack/Telegram, 예약된 작업.                                     |
 
-도메인 앱을 원하지 않습니까? 사용자가 즉시 대화할 수 있는 기본 앱을 원할 때 [Chat](/docs/template-chat)를 사용하거나 [Pure-Agent Apps](/docs/pure-agent-apps)에서 작업부터 시작할 수 있습니다.
+도메인 앱을 원하지 않습니까? 사용자가 즉시 대화할 수 있고 actions, native results, screens로 확장할 수 있는 기본 앱을 원한다면 [Chat](/docs/template-chat)를 사용하세요. 아직 브라우저 UI가 필요 없는 workflow에만 [Automation-First Apps](/docs/pure-agent-apps)를 사용하세요.
 
 [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를 렌더링한 뒤 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 대신 브라우저 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/ko-KR/faq.mdx

@@ -11,15 +11,15 @@ description: "에이전트 네이티브에 대한 일반적인 질문 - 그것
 
 ### 에이전트 네이티브란 무엇인가요? {#what-is-agent-native}
 
-에이전트 네이티브는 AI 에이전트와 그 주변의 제품 표면이 동등한 파트너인 앱을 구축하기 위한 프레임워크입니다. 해당 표면은 하나의 사용자 지정 작업을 통해 헤드리스 에이전트로 시작하여 풍부한 채팅으로 성장하거나 완전한 UI가 될 수 있습니다. 변하지 않는 점은 에이전트와 인간이 동일한 actions, 데이터베이스 및 상태를 공유한다는 것입니다. 전체 설명은 [What Is Agent-Native?](/docs/what-is-agent-native)를 참조하세요.
+에이전트 네이티브는 AI 에이전트와 그 주변의 제품 표면이 동등한 파트너인 앱을 구축하기 위한 프레임워크입니다. 일반적인 경로는 chat에서 시작해 typed actions를 추가하고, structured results를 inline으로 렌더링한 뒤, 같은 SQL state 위에 durable pages를 확장하는 것입니다. 변하지 않는 점은 에이전트와 인간이 동일한 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에 커밋하기 전에 하나의 작업과 헤드리스 앱 에이전트 루프를 원하는 경우 기본 우선 시작** - [Getting Started](/docs/getting-started)로 시작하세요.
+- **채팅으로 시작** 사용자가 즉시 agent와 대화하고 actions, native results, screens로 확장하는 기본 경로를 원한다면 [Getting Started](/docs/getting-started) 또는 [Chat](/docs/template-chat)로 시작하세요.
+- **automation-first로 시작** 예약 작업, queues, scripts, integration workers 또는 아직 브라우저 UI가 필요 없는 외부 agent workflows를 만든다면 [Automation-First Apps](/docs/pure-agent-apps)로 시작하세요.
 - **인증, 데이터베이스, UI 및 에이전트 actions가 이미 연결되어 있는 자체 SaaS 제품을 원하는 경우 템플릿을 포크하고 사용자 정의**하세요. [Templates](/docs/cloneable-saas)를 참조하세요.
 - **처음부터 빌드** 새로운 에이전트 기반 제품을 위한 프레임워크 기본 요소를 원한다면 [Getting Started](/docs/getting-started)로 시작하세요.
 - **다른 에이전트 또는 코드 도구 연결** Claude, ChatGPT, Codex, Cursor 또는 GitHub Copilot/VS Code를 사용하여 에이전트 기본 앱을 사용하려면 — [External Agents](/docs/external-agents) 및 [Skills Guide](/docs/skills-guide)를 참조하세요.
@@ -128,7 +128,7 @@ Anthropic Claude, OpenAI(GPT-5 제품군), Google Gemini 및 OpenAI API 형태
 
 ### 템플릿에서 다루지 않는 것을 만들 수 있나요? {#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 지원 런타임 상태, native inline rendering 및 자신만의 화면을 추가할 수 있는 공간이 제공됩니다. 브라우저 없는 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}