refactor(host): rename the directory-picker dialog backend and kind to native

The browse interaction also presents a dialog (the in-app modal), so 'dialog'
failed to discriminate the two capability kinds; 'native' names where the
chooser runs. Package directory-picker-dialog -> directory-picker-native, kind
'dialog' -> 'native', with every seam/gateway/client/doc reference updated and
the seam Agent Note's naming rationale rewritten to match.

packages/client/connection/tests/fake-api.ts

@@ -62,7 +62,7 @@ export class FakeApiClient implements IApiClient {
     payload => Promise.resolve(ok({ selected: { provider: payload.provider, model: payload.model } }))
   onPrompt: (payload: unknown) => Promise<RpcResponse<{ accepted: true }>> = () => Promise.resolve(ok({ accepted: true as const }))
   onCancel: (payload: unknown) => Promise<RpcResponse<{ accepted: true }>> = () => Promise.resolve(ok({ accepted: true as const }))
-  onDescribe: (payload: unknown) => Promise<RpcResponse<{ version: string; cwd: string; attachedSessions: number; directoryPicker: 'dialog' | 'browse' }>> =
+  onDescribe: (payload: unknown) => Promise<RpcResponse<{ version: string; cwd: string; attachedSessions: number; directoryPicker: 'native' | 'browse' }>> =
     () => Promise.resolve(ok({ version: '0-fake', cwd: '/f', attachedSessions: 0, directoryPicker: 'browse' as const }))
   onPickDirectory: (payload: unknown) => Promise<RpcResponse<{ path: string | null }>> =
     () => Promise.resolve(ok({ path: null }))

packages/client/runtime/src/client/workspaces/service.ts

@@ -180,7 +180,7 @@ export class WorkspacesService {
   }
 
   /**
-   * Open the Host's native directory picker (the `dialog` capability).
+   * Open the Host's native directory picker (the `native` capability).
    * @returns the selected path, or null when the user cancelled.
    */
   async pickDirectory(): Promise<string | null> {
@@ -193,7 +193,7 @@ export class WorkspacesService {
 
   /**
    * The directory-picking interaction the Host composed — the fact the picker
-   * UI branches on (`dialog` opens the native chooser; `browse` opens the
+   * UI branches on (`native` opens the native chooser; `browse` opens the
    * in-app browser). Read per flow open: one describe round trip, no cache to
    * go stale across reconnects.
    * @returns the Host's advertised picker kind.

packages/client/runtime/tests/fake-api.ts

@@ -80,7 +80,7 @@ export class FakeApiClient implements IApiClient {
     payload => Promise.resolve(ok({ selected: { provider: payload.provider, model: payload.model } }))
   onPrompt: (payload: unknown) => Promise<RpcResponse<{ accepted: true }>> = () => Promise.resolve(ok({ accepted: true as const }))
   onCancel: (payload: unknown) => Promise<RpcResponse<{ accepted: true }>> = () => Promise.resolve(ok({ accepted: true as const }))
-  onDescribe: (payload: unknown) => Promise<RpcResponse<{ version: string; cwd: string; attachedSessions: number; directoryPicker: 'dialog' | 'browse' }>> =
+  onDescribe: (payload: unknown) => Promise<RpcResponse<{ version: string; cwd: string; attachedSessions: number; directoryPicker: 'native' | 'browse' }>> =
     () => Promise.resolve(ok({ version: '0-fake', cwd: '/f', attachedSessions: 0, directoryPicker: 'browse' as const }))
   onPickDirectory: (payload: unknown) => Promise<RpcResponse<{ path: string | null }>> =
     () => Promise.resolve(ok({ path: null }))

packages/client/ui-workspace/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/client/ui-workspace/README.md
-README.md: 58aaf56e1953f00417492d766d8f4ae4a0081c81
-README.zh.md: 7c7b33e0ea68fefee8f857cb5e67a36ec5a854f5
+README.md: deaa25184f5ddbfc5980033ce60cef43577ff33c
+README.zh.md: e14e8ca6a2e3d65ce5fc403291e45ebc03598e04

packages/client/ui-workspace/README.md

@@ -4,7 +4,7 @@ English | [中文](README.zh.md)
 
 Shared Workspace picker plugin. `WorkspaceBrowser` is registered into the sidebar's `sidebar.workspaces` slot and `WorkspacePicker` into the page-local Session Intent hero's `conversation.hero.workspace` slot, so both surfaces use the same menu and creation flow.
 
-The picker lists real Host Workspace entities through the global `useWorkspaces` hook. Selecting a Workspace invokes the slot owner's `onPick` callback to retarget the frontend Session object. The flat **Open local folder...** action renders only when the Host advertises the `dialog` picker interaction (read per flow open through `host.describe`); `browse` — until its in-app browser UI lands — and unknown kinds hide the entry, the seam's documented default. When shown, it delegates to the Host's native single-directory picker, adopts a returned path through the object layer, and selects the committed Workspace only after its list projection has refreshed; cancellation is silent, and errors remain retryable. **Create a new workspace** retains the name dialog and disables names already present in that list, while the Host remains authoritative for concurrent or non-UI callers. The runtime Session and Workspace services own materialization. The Workspace row's Delete action opens a confirmation that states the retention boundary, blocks duplicate submission, and keeps failures open; success removes the group while its Sessions remain under Ungrouped.
+The picker lists real Host Workspace entities through the global `useWorkspaces` hook. Selecting a Workspace invokes the slot owner's `onPick` callback to retarget the frontend Session object. The flat **Open local folder...** action renders only when the Host advertises the `native` picker interaction (read per flow open through `host.describe`); `browse` — until its in-app browser UI lands — and unknown kinds hide the entry, the seam's documented default. When shown, it delegates to the Host's native single-directory picker, adopts a returned path through the object layer, and selects the committed Workspace only after its list projection has refreshed; cancellation is silent, and errors remain retryable. **Create a new workspace** retains the name dialog and disables names already present in that list, while the Host remains authoritative for concurrent or non-UI callers. The runtime Session and Workspace services own materialization. The Workspace row's Delete action opens a confirmation that states the retention boundary, blocks duplicate submission, and keeps failures open; success removes the group while its Sessions remain under Ungrouped.
 
 Both target slots are declared by other plugins, so `apply` registers through declaration-aware deferral and re-registers after a declaring slot is restored.
 

packages/client/ui-workspace/README.zh.md

@@ -4,7 +4,7 @@
 
 共享 Workspace 选择器插件。`WorkspaceBrowser` 注册到侧边栏的 `sidebar.workspaces` slot，`WorkspacePicker` 注册到页面局部 Session Intent 主视觉区的 `conversation.hero.workspace` slot，因此两个表层使用同一菜单和创建流程。
 
-该选择器通过全局 `useWorkspaces` hook 列出真实的 Host Workspace 实体。选择 Workspace 会调用 slot owner 的 `onPick` 回调，重新定位前端 Session 对象。平铺显示的 **打开本地文件夹…** 操作仅在 Host 广播 `dialog` 选择交互时渲染（每次流程打开时通过 `host.describe` 读取）；`browse`（在其应用内浏览器 UI 落地之前）以及未知 kind 都会隐藏该入口，即 seam 文档化的默认行为。显示时它会委托 Host 的原生单目录选择器，通过对象层接纳返回的路径，并等待 Workspace 列表投影刷新后才选中已提交的 Workspace；取消操作不会显示提示，发生错误后仍可重试。**创建新工作区** 操作保留名称对话框，并禁用列表中已有的名称，而 Host 对并发或非 UI 调用方仍具有最终决定权。运行时 Session 与 Workspace 服务负责物化。Workspace 行内的 Delete 操作会打开确认框，说明保留边界、阻止重复提交，并在失败时保持打开；成功后，该分组会被移除，其 Session 则留在 Ungrouped 下。
+该选择器通过全局 `useWorkspaces` hook 列出真实的 Host Workspace 实体。选择 Workspace 会调用 slot owner 的 `onPick` 回调，重新定位前端 Session 对象。平铺显示的 **打开本地文件夹…** 操作仅在 Host 广播 `native` 选择交互时渲染（每次流程打开时通过 `host.describe` 读取）；`browse`（在其应用内浏览器 UI 落地之前）以及未知 kind 都会隐藏该入口，即 seam 文档化的默认行为。显示时它会委托 Host 的原生单目录选择器，通过对象层接纳返回的路径，并等待 Workspace 列表投影刷新后才选中已提交的 Workspace；取消操作不会显示提示，发生错误后仍可重试。**创建新工作区** 操作保留名称对话框，并禁用列表中已有的名称，而 Host 对并发或非 UI 调用方仍具有最终决定权。运行时 Session 与 Workspace 服务负责物化。Workspace 行内的 Delete 操作会打开确认框，说明保留边界、阻止重复提交，并在失败时保持打开；成功后，该分组会被移除，其 Session 则留在 Ungrouped 下。
 
 两个目标 slot 都由其他插件声明，因此 `apply` 通过声明感知的延迟机制完成注册，并在声明该 slot 的插件恢复后重新注册。
 

packages/client/ui-workspace/src/client/WorkspacePicker.tsx

@@ -72,31 +72,31 @@ export function WorkspaceCreateFlow({
   const duplicateWorkspaceName = !creating && normalizedWorkspaceName !== ''
     && workspaces.some(workspace => workspace.title === normalizedWorkspaceName)
 
-  // The advertised interaction gates the picking affordance: 'dialog' is the
+  // The advertised interaction gates the picking affordance: 'native' is the
   // only kind pickDirectory() can serve, so its entry renders under that kind
   // alone; 'browse' (until the in-app browser UI lands) and unknown kinds
   // hide the entry, the seam's documented unknown-kind default. Re-read per
   // flow open — no cache to go stale across reconnects.
-  const [dialogPicker, setDialogPicker] = useState(false)
+  const [nativePicker, setNativePicker] = useState(false)
   useEffect(() => {
     if (!open) {
       // Close discards the answer: a reconnect or HMR can swap the composed
       // backend while the menu is closed, and the reopened menu must never
       // paint the previous host's entry before the fresh read lands.
-      setDialogPicker(false)
+      setNativePicker(false)
       return
     }
     // Reset before each read: the injected reader can also change identity
     // while the flow stays open, and that prior answer must not leak either;
     // a settlement from a superseded read is discarded via the
     // cleanup-toggled flag.
-    setDialogPicker(false)
+    setNativePicker(false)
     let stale = false
     void directoryPickerKind()
-      .then((kind) => { if (!stale) setDialogPicker(kind === 'dialog') })
+      .then((kind) => { if (!stale) setNativePicker(kind === 'native') })
       // A failed describe hides the entry too: the same Host that cannot
       // answer describe cannot serve pickDirectory.
-      .catch(() => { if (!stale) setDialogPicker(false) })
+      .catch(() => { if (!stale) setNativePicker(false) })
     return () => { stale = true }
   }, [open, directoryPickerKind])
 
@@ -108,7 +108,7 @@ export function WorkspaceCreateFlow({
       disabled: pickingFolder,
     })),
     ...(workspaces.length > 0 ? [{ type: 'separator' as const, id: 'sep-create' }] : []),
-    ...(dialogPicker
+    ...(nativePicker
       ? [{ id: OPEN_LOCAL_FOLDER, label: 'Open local folder…', icon: <IconFolderClose16 size={16} />, disabled: pickingFolder }]
       : []),
     { id: CREATE_NEW, label: 'Create a new workspace', icon: <IconPlusOutline16 size={16} />, disabled: pickingFolder },

packages/client/ui-workspace/tests/apply.spec.ts

@@ -15,7 +15,7 @@ async function bench() {
     title: 'new', sessionIds: [], createdAt: '0', updatedAt: '0',
   }))
   const pickDirectory = vi.fn(async () => '/tmp/picked')
-  const directoryPickerKind = vi.fn(async () => 'dialog' as const)
+  const directoryPickerKind = vi.fn(async () => 'native' as const)
   const startSession = vi.fn()
   const rename = vi.fn(async () => ({}))
   const insertSessionBefore = vi.fn(async () => ({}))

packages/client/ui-workspace/tests/workspace-browser.spec.tsx

@@ -60,7 +60,7 @@ function mount(overrides: Partial<WorkspaceBrowserProps> = {}) {
     insertSessionBefore: vi.fn(async () => {}),
     createWorkspace: vi.fn(async () => workspace('created', [])),
     pickDirectory: vi.fn(async () => null),
-    directoryPickerKind: vi.fn(async () => 'dialog' as const),
+    directoryPickerKind: vi.fn(async () => 'native' as const),
     ...overrides,
   }
   const view = render(<WorkspaceBrowser {...props} />)

packages/client/ui-workspace/tests/workspace-picker.spec.tsx

@@ -39,7 +39,7 @@ function mount(
   items: readonly WorkspaceView[] = [workspace('alpha', 'Alpha')],
   createWorkspace = vi.fn(),
   pickDirectory = vi.fn(async () => null as string | null),
-  directoryPickerKind = vi.fn(async () => 'dialog'),
+  directoryPickerKind = vi.fn(async () => 'native'),
 ) {
   const onPick = vi.fn()
   const onClose = vi.fn()
@@ -221,7 +221,7 @@ describe('WorkspacePicker', () => {
       <WorkspacePicker
         open useSessions={hook(sessions)} useWorkspaces={hook(workspaceState([]))}
         onPick={vi.fn()} onClose={vi.fn()} createWorkspace={vi.fn()} pickDirectory={vi.fn()}
-        directoryPickerKind={vi.fn(async () => 'dialog')}
+        directoryPickerKind={vi.fn(async () => 'native')}
       />,
     )
     expect(screen.queryByRole('menu')).toBeNull()
@@ -235,7 +235,7 @@ describe('WorkspacePicker', () => {
       <WorkspacePicker
         open anchorRef={anchor()} useSessions={hook(sessions)} useWorkspaces={hook(state)}
         onPick={vi.fn()} onClose={vi.fn()} createWorkspace={vi.fn()} pickDirectory={vi.fn()}
-        directoryPickerKind={vi.fn(async () => 'dialog')}
+        directoryPickerKind={vi.fn(async () => 'native')}
       />,
     )
     expect(screen.getByRole('status').textContent).toBe('Loading workspaces…')
@@ -258,7 +258,7 @@ describe('WorkspacePicker', () => {
   })
 
   it('does not read the picker kind while the flow is closed', () => {
-    const directoryPickerKind = vi.fn(async () => 'dialog')
+    const directoryPickerKind = vi.fn(async () => 'native')
     render(
       <WorkspacePicker
         open={false} anchorRef={anchor()} useSessions={hook(sessions)} useWorkspaces={hook(workspaceState([]))}
@@ -290,10 +290,10 @@ describe('WorkspacePicker', () => {
       .mockImplementationOnce(() => first)
       .mockImplementation(async () => 'browse')
     const t = togglable(directoryPickerKind)
-    // Close while the first read is in flight, then let it answer 'dialog':
+    // Close while the first read is in flight, then let it answer 'native':
     // the settlement is stale and must not leak into the next open.
     t.setOpen(false)
-    await act(async () => { resolveFirst('dialog') })
+    await act(async () => { resolveFirst('native') })
     t.setOpen(true)
     await screen.findByRole('menuitem', { name: 'Create a new workspace' })
     await waitFor(() => { expect(directoryPickerKind).toHaveBeenCalledTimes(2) })
@@ -302,7 +302,7 @@ describe('WorkspacePicker', () => {
 
   it('clears the advertised kind on close so a reopen cannot paint the previous host entry', async () => {
     const directoryPickerKind = vi.fn<() => Promise<string>>()
-      .mockImplementationOnce(async () => 'dialog')
+      .mockImplementationOnce(async () => 'native')
       // The reopened read never settles: the assertion below sees the paint
       // that precedes any fresh answer.
       .mockImplementation(() => new Promise<string>(() => {}))
@@ -319,7 +319,7 @@ describe('WorkspacePicker', () => {
     const first = new Promise<string>((_settle, reject) => { rejectFirst = reject })
     const directoryPickerKind = vi.fn<() => Promise<string>>()
       .mockImplementationOnce(() => first)
-      .mockImplementation(async () => 'dialog')
+      .mockImplementation(async () => 'native')
     const t = togglable(directoryPickerKind)
     t.setOpen(false)
     t.setOpen(true)