@agent-native/core 0.93.0 → 0.94.0

package/docs/content/locales/pt-BR/migration-workbench.mdx

@@ -1,76 +0,0 @@
----
-title: "Migrando para Agent-Native (/migrate)"
-description: "A migração é uma meta integrada de /migração no espaço de trabalho do Código Agent-Native, e não um aplicativo separado. Consulte o código Agent-Native UI para obter o guia completo."
----
-
-# Migrando para Agent-Native (/migrate)
-
-A migração **não é um produto ou modelo separado** — é o produto integrado
-Objetivo `/migrate` dentro do espaço de trabalho [Agent-Native Code](/docs/code-agents-ui).
-Ele é executado como uma sessão normal de código que você pode retomar, anexar, inspecionar e interromper.
-
-<Diagram id="doc-block-1d1h1x6" title={"/migrate é uma sessão de código, não um aplicativo separado"} summary={"Um caminho, URL, ou descrição entra; a execução compartilha o mesmo armazenamento, transcrição e controles que qualquer outra sessão de código e pode emitir um dossiê portátil."}>
-
-```html
-<div class="diagram-migrate">
-  <div class="diagram-col">
-    <div class="diagram-pill">./local-app</div>
-    <div class="diagram-pill">https://example.com</div>
-    <div class="diagram-pill">--describe \"...\"</div>
-  </div>
-  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
-  <div class="diagram-panel center" data-rough>
-    <span class="diagram-pill accent">/migrate goal</span
-    ><small class="diagram-muted"
-      >mesmo store · transcrição · controles de execução</small
-    >
-  </div>
-  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
-  <div class="diagram-col">
-    <div class="diagram-box" data-rough>App migrado</div>
-    <div class="diagram-pill ok">--emit dossier</div>
-  </div>
-</div>
-```
-
-```css
-.diagram-migrate {
-  display: flex;
-  align-items: center;
-  gap: 12px;
-  flex-wrap: wrap;
-}
-.diagram-migrate .diagram-col {
-  display: flex;
-  flex-direction: column;
-  gap: 8px;
-}
-.diagram-migrate .diagram-arrow {
-  font-size: 22px;
-  line-height: 1;
-}
-.diagram-migrate .center {
-  display: flex;
-  flex-direction: column;
-  align-items: center;
-  gap: 4px;
-}
-```
-
-</Diagram>
-
-```bash
-npx @agent-native/core@latest code /migrate ./my-next-app --out ../migrated-app
-npx @agent-native/core@latest code /migrate https://example.com --describe "marketing site plus dashboard"
-npx @agent-native/core@latest migrate ./my-next-app --out ../migrated-app   # shortcut into the same goal
-```
-
-O guia completo — formas de entrada (caminho / URL / descrição), dossiês `--emit`,
-Modo Planejar versus Modo Automático, controles de execução, credenciais, links diretos para desktop e
-Exportações de pacotes `@agent-native/migrate` — residem em
-[Agent-Native Code UI → Migrating to Agent-Native](/docs/code-agents-ui#migrate).
-
-> [!NOTE]
-> O aplicativo de detalhes `migration` oculto herdado foi removido. Use o código
-> espaço de trabalho, a guia Desktop Code ou um dossiê emitido conforme suportado
-> superfícies.

package/docs/content/locales/zh-CN/migration-workbench.mdx

@@ -1,74 +0,0 @@
----
-title: "迁移到 Agent-Native (/migrate)"
-description: "迁移是 Agent-Native 代码工作区中的内置 /migrate 目标，而不是单独的应用程序。请参阅 Agent-Native 代码 UI 获取完整指南。"
----
-
-# 迁移到 Agent-Native (/migrate)
-
-迁移**不是单独的产品或模板** - 它是内置的
-[Agent-Native Code](/docs/code-agents-ui) 工作空间内的 `/migrate` 目标。
-它作为正常的代码会话运行，您可以恢复、附加、检查和停止。
-
-<Diagram id="doc-block-1gu3xoo" title={"/migrate 是一个代码会话，而不是一个单独的应用程序"} summary={"路径、URL 或描述进入；该运行与其他所有代码会话共享相同的存储、脚本和控件，并且可以生成可移植的档案。"}>
-
-```html
-<div class="diagram-migrate">
-  <div class="diagram-col">
-    <div class="diagram-pill">./local-app</div>
-    <div class="diagram-pill">https://example.com</div>
-    <div class="diagram-pill">--describe \"...\"</div>
-  </div>
-  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
-  <div class="diagram-panel center" data-rough>
-    <span class="diagram-pill accent">/migrate goal</span
-    ><small class="diagram-muted">同一存储 · 转录 · 运行控制</small>
-  </div>
-  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
-  <div class="diagram-col">
-    <div class="diagram-box" data-rough>已迁移应用</div>
-    <div class="diagram-pill ok">--emit dossier</div>
-  </div>
-</div>
-```
-
-```css
-.diagram-migrate {
-  display: flex;
-  align-items: center;
-  gap: 12px;
-  flex-wrap: wrap;
-}
-.diagram-migrate .diagram-col {
-  display: flex;
-  flex-direction: column;
-  gap: 8px;
-}
-.diagram-migrate .diagram-arrow {
-  font-size: 22px;
-  line-height: 1;
-}
-.diagram-migrate .center {
-  display: flex;
-  flex-direction: column;
-  align-items: center;
-  gap: 4px;
-}
-```
-
-</Diagram>
-
-```bash
-npx @agent-native/core@latest code /migrate ./my-next-app --out ../migrated-app
-npx @agent-native/core@latest code /migrate https://example.com --describe "marketing site plus dashboard"
-npx @agent-native/core@latest migrate ./my-next-app --out ../migrated-app   # shortcut into the same goal
-```
-
-完整指南 - 输入形状（路径/URL/描述）、`--emit` 档案，
-计划与自动模式、运行控件、凭据、桌面深层链接以及
-`@agent-native/migrate` 包导出 — 位于
-[Agent-Native Code UI → Migrating to Agent-Native](/docs/code-agents-ui#migrate).
-
-> [!NOTE]
-> 旧版隐藏的 `migration` 详细信息应用程序已被删除。使用代码
-> 工作区、桌面代码选项卡或发出的达析报告作为受支持
-> 表面。

package/docs/content/locales/zh-TW/migration-workbench.mdx

@@ -1,74 +0,0 @@
----
-title: "遷移到 Agent-Native (/migrate)"
-description: "遷移是 Agent-Native 程式碼工作區中的內建 /migrate 目標，而不是單獨的應用程式。請參閱 Agent-Native 程式碼 UI 取得完整指南。"
----
-
-# 遷移到 Agent-Native (/migrate)
-
-遷移**不是單獨的產品或範本** - 它是內建的
-[Agent-Native Code](/docs/code-agents-ui) 工作空間內的 `/migrate` 目標。
-它作為正常的程式碼工作階段執行，您可以恢復、附加、檢查和停止。
-
-<Diagram id="doc-block-4y19o7" title={"/migrate 是一個程式碼工作階段，而不是一個單獨的應用程式"} summary={"路徑、URL 或描述進入；該執行與其他所有程式碼工作階段共用相同的儲存、指令碼和控制項，並且可以生成可移植的檔案。"}>
-
-```html
-<div class="diagram-migrate">
-  <div class="diagram-col">
-    <div class="diagram-pill">./local-app</div>
-    <div class="diagram-pill">https://example.com</div>
-    <div class="diagram-pill">--describe \"...\"</div>
-  </div>
-  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
-  <div class="diagram-panel center" data-rough>
-    <span class="diagram-pill accent">/migrate goal</span
-    ><small class="diagram-muted">同一儲存 · 轉錄 · 執行控制</small>
-  </div>
-  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
-  <div class="diagram-col">
-    <div class="diagram-box" data-rough>已遷移應用</div>
-    <div class="diagram-pill ok">--emit dossier</div>
-  </div>
-</div>
-```
-
-```css
-.diagram-migrate {
-  display: flex;
-  align-items: center;
-  gap: 12px;
-  flex-wrap: wrap;
-}
-.diagram-migrate .diagram-col {
-  display: flex;
-  flex-direction: column;
-  gap: 8px;
-}
-.diagram-migrate .diagram-arrow {
-  font-size: 22px;
-  line-height: 1;
-}
-.diagram-migrate .center {
-  display: flex;
-  flex-direction: column;
-  align-items: center;
-  gap: 4px;
-}
-```
-
-</Diagram>
-
-```bash
-npx @agent-native/core@latest code /migrate ./my-next-app --out ../migrated-app
-npx @agent-native/core@latest code /migrate https://example.com --describe "marketing site plus dashboard"
-npx @agent-native/core@latest migrate ./my-next-app --out ../migrated-app   # shortcut into the same goal
-```
-
-完整指南 - 輸入形狀（路徑/URL/描述）、`--emit` 檔案，
-計畫與自動模式、執行控制項、憑證、桌面深層連結以及
-`@agent-native/migrate` 包匯出 — 位於
-[Agent-Native Code UI → Migrating to Agent-Native](/docs/code-agents-ui#migrate).
-
-> [!NOTE]
-> 舊版隱藏的 `migration` 詳細資訊應用程式已被刪除。使用程式碼
-> 工作區、桌面程式碼分頁或發出的達析報告作為受支援
-> 表面。

package/docs/content/migration-workbench.mdx

@@ -1,74 +0,0 @@
----
-title: "Migrating to Agent-Native (/migrate)"
-description: "Migration is a built-in /migrate goal in the Agent-Native Code workspace — not a separate app. See Agent-Native Code UI for the full guide."
----
-
-# Migrating to Agent-Native (/migrate)
-
-Migration is **not a separate product or template** — it is the built-in
-`/migrate` goal inside the [Agent-Native Code](/docs/code-agents-ui) workspace.
-It runs as a normal Code session you can resume, attach to, inspect, and stop.
-
-<Diagram id="doc-block-1lox5dw" title="/migrate is a Code session, not a separate app" summary={"A path, URL, or description goes in; the run shares the same store, transcript, and controls as every other Code session, and can emit a portable dossier."}>
-
-```html
-<div class="diagram-migrate">
-  <div class="diagram-col">
-    <div class="diagram-pill">./local-app</div>
-    <div class="diagram-pill">https://example.com</div>
-    <div class="diagram-pill">--describe \"...\"</div>
-  </div>
-  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
-  <div class="diagram-panel center" data-rough>
-    <span class="diagram-pill accent">/migrate goal</span
-    ><small class="diagram-muted">same store · transcript · run controls</small>
-  </div>
-  <div class="diagram-arrow diagram-muted" aria-hidden="true">&rarr;</div>
-  <div class="diagram-col">
-    <div class="diagram-box" data-rough>Migrated app</div>
-    <div class="diagram-pill ok">--emit dossier</div>
-  </div>
-</div>
-```
-
-```css
-.diagram-migrate {
-  display: flex;
-  align-items: center;
-  gap: 12px;
-  flex-wrap: wrap;
-}
-.diagram-migrate .diagram-col {
-  display: flex;
-  flex-direction: column;
-  gap: 8px;
-}
-.diagram-migrate .diagram-arrow {
-  font-size: 22px;
-  line-height: 1;
-}
-.diagram-migrate .center {
-  display: flex;
-  flex-direction: column;
-  align-items: center;
-  gap: 4px;
-}
-```
-
-</Diagram>
-
-```bash
-npx @agent-native/core@latest code /migrate ./my-next-app --out ../migrated-app
-npx @agent-native/core@latest code /migrate https://example.com --describe "marketing site plus dashboard"
-npx @agent-native/core@latest migrate ./my-next-app --out ../migrated-app   # shortcut into the same goal
-```
-
-The full guide — input shapes (path / URL / description), `--emit` dossiers,
-Plan vs Auto mode, run controls, credentials, Desktop deep links, and the
-`@agent-native/migrate` package exports — lives in
-[Agent-Native Code UI → Migrating to Agent-Native](/docs/code-agents-ui#migrate).
-
-> [!NOTE]
-> The legacy hidden `migration` detail app has been removed. Use the Code
-> workspace, the Desktop Code tab, or an emitted dossier as the supported
-> surfaces.

package/docs/content/toolkit-app-adapters.mdx

@@ -1,55 +0,0 @@
----
-title: "Toolkit App Adapters"
-description: "Use app-local wrappers so Toolkit components are reusable without forcing one visual system."
----
-
-# Toolkit App Adapters
-
-Every template can expose local UI adapters under `@/components/ui/*` and local
-hook adapters under `@/hooks/*`. Most adapters are intentionally tiny:
-
-<WireframeBlock id="doc-block-toolkit-app-adapters">
-  <Screen
-    surface="desktop"
-    html={
-      "<div style='min-height:460px;box-sizing:border-box;padding:28px;display:flex;flex-direction:column;gap:16px'><h2 style='margin:0'>One stable import path</h2><div style='display:grid;grid-template-columns:1fr auto 1fr auto 1fr;align-items:center;gap:12px'><div class='wf-card' style='display:flex;flex-direction:column;gap:8px'><span class='wf-pill'>Toolkit</span><strong>@agent-native/toolkit/ui/button</strong><small class='wf-muted'>Default behavior and accessibility</small></div><span data-icon='chevronRight' style='justify-self:center'></span><div class='wf-card' style='display:flex;flex-direction:column;gap:8px;border:1.6px solid var(--wf-accent);background:var(--wf-accent-soft)'><span class='wf-pill accent'>App adapter</span><strong>@/components/ui/button</strong><small class='wf-muted'>Re-export, swap once to restyle</small></div><span data-icon='chevronRight' style='justify-self:center'></span><div class='wf-card' style='display:flex;flex-direction:column;gap:8px'><span class='wf-pill'>App screens</span><div style='display:flex;align-items:center;gap:8px'><span data-icon='settings'></span> Settings</div><div style='display:flex;align-items:center;gap:8px'><span data-icon='user'></span> Share dialog</div><div style='display:flex;align-items:center;gap:8px'><span data-icon='search'></span> Command menu</div></div></div></div>"
-    }
-  />
-</WireframeBlock>
-
-```tsx
-export * from "@agent-native/toolkit/ui/button";
-```
-
-This pattern gives apps a stable customization point. Reusable Toolkit code can
-ship once, while app owners can replace `Button`, `Input`, or `Dialog` locally
-without rewriting every callsite.
-
-## Import Rule {#import-rule}
-
-Inside an app, prefer:
-
-```tsx
-import { Button } from "@/components/ui/button";
-```
-
-Inside Toolkit or other reusable packages, use:
-
-```tsx
-import { Button } from "@agent-native/toolkit/ui/button";
-```
-
-For reusable kit components that render app chrome, prefer `ToolkitProvider`
-over direct imports for primitives that apps commonly customize.
-
-Provider wiring can import from the focused provider subpath:
-
-```tsx
-import { ToolkitProvider } from "@agent-native/toolkit/provider";
-```
-
-## Compatibility {#compatibility}
-
-Existing template code that used direct Toolkit imports has been migrated to
-local adapters. Existing external apps can keep their old imports while they
-migrate, because the Toolkit package still exports every primitive directly.

package/docs/content/toolkit-collaboration-ui.mdx

@@ -1,60 +0,0 @@
----
-title: "Toolkit Collaboration UI"
-description: "Reusable presence, cursor, selection, and recent-edit UI for collaborative Agent-Native apps."
----
-
-# Toolkit Collaboration UI
-
-`@agent-native/toolkit/collab-ui` contains the presentational collaboration
-pieces that do not own transport or storage:
-
-<WireframeBlock id="doc-block-toolkit-collaboration-ui">
-  <Screen
-    surface="desktop"
-    html={
-      "<div style='min-height:500px;box-sizing:border-box;padding:26px;display:flex;flex-direction:column;gap:14px'><div class='wf-card' style='position:relative;display:flex;flex-direction:column;gap:14px'><div style='display:flex;align-items:center;gap:8px'><h2 style='margin:0'>Editor canvas</h2><div style='flex:1'></div><div style='display:flex;align-items:center'><div style='width:26px;height:26px;border-radius:999px;background:var(--wf-accent-soft);border:2px solid var(--wf-card);flex:none'></div><div style='width:26px;height:26px;border-radius:999px;background:var(--wf-accent-soft);border:2px solid var(--wf-card);margin-left:-8px;flex:none'></div></div><span class='wf-pill accent'>Agent editing</span></div><div style='position:relative;border:1.6px solid var(--wf-accent);border-radius:var(--wf-radius);padding:14px;display:flex;flex-direction:column;gap:8px;margin-top:6px'><span class='wf-pill accent' style='position:absolute;left:12px;top:-12px'>Ava</span><div style='height:11px;width:80%;background:var(--wf-line);border-radius:4px'></div><div style='height:11px;width:65%;background:var(--wf-line);border-radius:4px'></div></div><div style='background:var(--wf-accent-soft);border-radius:var(--wf-radius);padding:14px;display:flex;flex-direction:column;gap:8px'><small class='wf-muted'>Sam edited moments ago</small><div style='height:11px;width:90%;background:var(--wf-line);border-radius:4px'></div><div style='height:11px;width:70%;background:var(--wf-line);border-radius:4px'></div></div><span class='wf-pill' style='position:absolute;right:70px;top:210px'>Sam</span></div></div>"
-    }
-  />
-</WireframeBlock>
-
-```tsx
-import {
-  AgentPresenceChip,
-  LiveCursorOverlay,
-  PresenceBar,
-  RecentEditHighlights,
-  RemoteSelectionRings,
-} from "@agent-native/toolkit/collab-ui";
-```
-
-Core still owns the live collaboration runtime: Yjs documents, awareness sync,
-presence hooks, recent edit publication, undo grouping, and server plugins. Use
-core for data and Toolkit for rendering.
-
-```tsx
-import { useCollaborativeDoc, usePresence } from "@agent-native/core/client";
-import { PresenceBar } from "@agent-native/toolkit/collab-ui";
-```
-
-Existing imports from `@agent-native/core/client` still work because core
-re-exports these Toolkit components as compatibility shims.
-
-See the [Collaboration Kit](/docs/toolkit-collaboration) for the full runtime,
-presence, and undo contract.
-
-## Responsibilities {#responsibilities}
-
-Toolkit owns:
-
-- Presence avatars and agent editing chips.
-- Live cursor overlays.
-- Remote selection rings.
-- Recent edit highlight overlays.
-- Display helpers such as collaborator color and display-name derivation.
-
-Core owns:
-
-- Yjs document creation and sync.
-- Awareness polling and SSE fast-path transport.
-- Collaboration server plugins and actions.
-- Recent edit publication and collection from awareness.

package/docs/content/toolkit-sharing-ui.mdx

@@ -1,45 +0,0 @@
----
-title: "Toolkit Sharing UI"
-description: "Reusable sharing display components with core-owned sharing runtime compatibility."
----
-
-# Toolkit Sharing UI
-
-`@agent-native/toolkit/sharing` contains presentational sharing UI for badges,
-share rows, role pickers, and base dialogs. It does not perform access checks or
-mutations; core and app wrappers inject data and callbacks.
-
-<WireframeBlock id="doc-block-toolkit-sharing-ui">
-  <Screen
-    surface="desktop"
-    html={
-      "<div style='min-height:480px;box-sizing:border-box;padding:26px;display:grid;grid-template-columns:1fr 300px;gap:16px'><main class='wf-card' style='display:flex;flex-direction:column;gap:14px'><div style='display:flex;align-items:center;gap:10px'><h2 style='margin:0'>Roadmap</h2><span class='wf-pill accent'>Org visible</span><div style='flex:1'></div><button><span data-icon='user'></span> Share</button></div><small class='wf-muted'>Visibility badges</small><div style='display:flex;gap:6px'><span class='wf-pill'><span data-icon='lock'></span> Private</span><span class='wf-pill'>Shared</span><span class='wf-pill accent'>Org</span><span class='wf-pill'>Public</span></div><div style='display:flex;flex-direction:column;gap:8px'><div style='height:11px;width:88%;background:var(--wf-line);border-radius:4px'></div><div style='height:11px;width:72%;background:var(--wf-line);border-radius:4px'></div></div></main><aside class='wf-card' style='display:flex;flex-direction:column;gap:10px'><strong>Share</strong><div style='display:flex;align-items:center;gap:10px'><div style='width:28px;height:28px;border-radius:999px;background:var(--wf-accent-soft);flex:none'></div><div style='flex:1;min-width:0'><strong>Maya Chen</strong><br/><small class='wf-muted'>maya@acme.com</small></div><span class='wf-pill'>Editor <span data-icon='chevronDown'></span></span></div><div class='wf-card' style='display:flex;flex-direction:column;gap:2px;padding:6px'><div style='padding:6px 8px;border-radius:6px;background:var(--wf-accent-soft);display:flex;align-items:center;gap:8px'><span data-icon='check'></span> Editor</div><div style='padding:6px 8px'>Viewer</div><div style='padding:6px 8px'>Remove</div></div><div style='display:flex;align-items:center;gap:8px'><span data-icon='lock'></span><small class='wf-muted'>Public links disabled by policy</small></div></aside></div>"
-    }
-  />
-</WireframeBlock>
-
-The most common low-level import is:
-
-```tsx
-import { VisibilityBadge } from "@agent-native/toolkit/sharing";
-```
-
-Core still owns the sharing runtime: share tables, resource registration, access
-filters, visibility changes, invites, roles, and private access tokens for
-agent-readable public surfaces. See the [Sharing Kit](/docs/toolkit-sharing) for
-the full behaviorful contract.
-
-Use core wrappers when a component needs to call sharing actions:
-
-```tsx
-import { ShareButton, ShareDialog } from "@agent-native/core/client";
-```
-
-Those imports remain compatible. Core wrappers keep doing the runtime work and
-pass data and callbacks into Toolkit-owned UI.
-
-## Boundary {#boundary}
-
-Toolkit sharing UI can render badges, rows, base dialogs, and role pickers when
-data and callbacks are injected. Core sharing code should own SQL, permissions,
-request context, org membership lookups, and share-token minting.

package/docs/content/toolkit-shell-hooks.mdx

@@ -1,36 +0,0 @@
----
-title: "Toolkit Shell & Hooks"
-description: "Shared shell helpers and hooks that templates can compose through local adapters."
----
-
-# Toolkit Shell & Hooks
-
-Toolkit includes small shell helpers and hooks that are useful across apps:
-
-<WireframeBlock id="doc-block-toolkit-shell-hooks">
-  <Screen
-    surface="desktop"
-    html={
-      "<div style='min-height:460px;box-sizing:border-box;padding:24px;display:grid;grid-template-columns:200px 1fr;gap:16px'><aside class='wf-card' style='display:flex;flex-direction:column;gap:6px'><strong style='margin-bottom:4px'>Analytics</strong><div style='padding:6px 9px;border-radius:8px;background:var(--wf-accent-soft)'>Dashboards</div><div style='padding:6px 9px;border-radius:8px'>Reports</div><div style='padding:6px 9px;border-radius:8px'>Settings</div></aside><main style='position:relative;display:flex;flex-direction:column;gap:14px'><div class='wf-card' style='display:flex;align-items:center;gap:10px'><h2 style='margin:0'>Dashboards</h2><div style='flex:1'></div><button><span data-icon='send'></span> Export</button><button class='primary'><span data-icon='plus'></span> Create</button></div><div class='wf-card' style='flex:1;display:flex;flex-direction:column;gap:8px'><div style='height:11px;width:70%;background:var(--wf-line);border-radius:4px'></div><div style='height:11px;width:90%;background:var(--wf-line);border-radius:4px'></div><div style='height:11px;width:80%;background:var(--wf-line);border-radius:4px'></div></div><div class='wf-card' style='display:flex;align-items:center;gap:8px;border-color:var(--wf-accent);position:absolute;right:0;bottom:0;width:230px'><span data-icon='check'></span><div style='flex:1'>Saved changes</div><span data-icon='x'></span></div></main></div>"
-    }
-  />
-</WireframeBlock>
-
-```tsx
-import { useSetHeaderActions } from "@agent-native/toolkit/app-shell";
-import { useIsMobile } from "@agent-native/toolkit/hooks/use-mobile";
-import { useToast } from "@agent-native/toolkit/hooks/use-toast";
-```
-
-Apps can wrap these through local adapters when they want the same customization
-point as UI primitives:
-
-```tsx
-export * from "@agent-native/toolkit/hooks/use-mobile";
-```
-
-Keep shell helpers in Toolkit when they are reusable and do not own app data.
-Keep app-specific navigation, command entries, and domain state in the template.
-
-Core remains responsible for framework-wide shell behavior such as app providers,
-agent chat, app state, auth, and runtime sync.