From e234a3a27483ea5b1a1ac26aab61e0c31113488a Mon Sep 17 00:00:00 2001 From: Huanqi Cao Date: Mon, 3 Aug 2026 23:19:17 +0800 Subject: [PATCH] docs(host-directory-picker-native): describe the in-process IFileOpenDialog primary in the module header The @module header still described the Windows adapter as the pre-PR 'STA PowerShell FolderBrowserDialog' while the README and Agent Notes document the koffi IFileOpenDialog primary with the PowerShell chain as fallback; mirror the README's platform summary. --- packages/host/directory-picker-native/src/index.ts | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/packages/host/directory-picker-native/src/index.ts b/packages/host/directory-picker-native/src/index.ts index f131c8bb0c..7e253ee634 100644 --- a/packages/host/directory-picker-native/src/index.ts +++ b/packages/host/directory-picker-native/src/index.ts @@ -1,10 +1,12 @@ /** * Native backend of the directory-picker seam: registers `ctx.directoryPicker` * with the `native` capability, opening one native OS chooser on the host - * display per pick (macOS `osascript`, Windows STA PowerShell - * `FolderBrowserDialog`, Linux Zenity with a KDialog fallback). Only viable - * when the operator sits at the host's screen; remote deployments compose the - * browse backend instead. + * display per pick (macOS `osascript`, Linux Zenity with a KDialog fallback; + * Windows opens the modern `IFileOpenDialog` in-process — a koffi-driven COM + * conversation on a worker thread — and falls back to a PowerShell-hosted + * dialog (`pwsh`, then Windows PowerShell 5.1) when that native surface is + * unavailable). Only viable when the operator sits at the host's screen; + * remote deployments compose the browse backend instead. * @module @deepseek-ai/dsh-host-directory-picker-native */