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
  */