From a5849d4f671e9edf682d488a1478d02dd7718f6e Mon Sep 17 00:00:00 2001 From: QQ Date: Wed, 11 Nov 2026 22:32:19 +0800 Subject: [PATCH] Import src/client/open-folder.ts --- src/client/open-folder.ts | 79 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 79 insertions(+) create mode 100644 src/client/open-folder.ts diff --git a/src/client/open-folder.ts b/src/client/open-folder.ts new file mode 100644 index 0000000..e216506 --- /dev/null +++ b/src/client/open-folder.ts @@ -0,0 +1,79 @@ +/** + * Transport for the official open-in-app host routes served by + * `@deepseek-ai/dsh-host-open-in-app`. The project row offers "open this + * project's folder" by asking that host half for the applications it verified + * as installed, then POSTing the launcher it already resolved — this plugin + * never probes or spawns a launcher itself, and a host without the capability + * (no resolved application, e.g. an SSH launch) simply yields no menu entry. + */ + +/** GET route serving the probed application ids (host-owned constant). */ +export const OPEN_IN_APP_APPS_ROUTE = '/open-in-app/apps' + +/** POST route launching one resolved application on one absolute directory. */ +export const OPEN_IN_APP_OPEN_ROUTE = '/open-in-app/open' + +/** + * Catalog ids that open a directory in the platform file manager, most + * specific first (the official catalog names one per platform: `explorer` on + * Windows, `finder` on macOS, `filemanager` on Linux). + */ +const FOLDER_APP_IDS = ['explorer', 'finder', 'filemanager'] as const + +/** + * The installed file-manager id for this host, or undefined when the host + * resolved none (the row then offers no "open in folder" entry). + * @param apps - installed catalog ids from the apps route. + * @returns the preferred available id. + */ +export function folderAppId(apps: readonly string[]): string | undefined { + for (const id of FOLDER_APP_IDS) { + if (apps.includes(id)) return id + } + return undefined +} + +/** + * Resolve the browser's Host base with the connection carrier's null-origin + * fallback (same rule the official button uses): a sandboxed document reports + * the literal origin "null", which cannot address the host. + * @returns the absolute base URL of the current Host. + */ +function hostBase(): string { + const origin = globalThis.location?.origin + return origin !== undefined && origin !== 'null' ? origin : 'http://dsh.internal' +} + +/** + * Read the host's installed-application ids. A host without the capability + * (or one that refuses) reads as an empty list rather than an error, so the + * caller can treat "no apps" and "no route" identically. + * @param signal - aborts the read when the browser half unmounts. + * @returns installed catalog ids, in host menu order. + */ +export async function fetchOpenInApps(signal?: AbortSignal): Promise { + const response = await fetch(new URL(OPEN_IN_APP_APPS_ROUTE, hostBase()), { + headers: { accept: 'application/json' }, + cache: 'no-store', + ...(signal === undefined ? {} : { signal }), + }) + if (!response.ok) throw new Error(`open-in-app apps request failed: ${response.status}`) + const payload: unknown = await response.json() + const apps = (payload as { apps?: unknown }).apps + return Array.isArray(apps) ? apps.filter((id): id is string => typeof id === 'string') : [] +} + +/** + * Launch one installed application on one absolute directory. + * @param appId - catalog id from the apps route. + * @param path - the project's absolute directory. + * @returns after the host acknowledged the launch; rejects on any refusal. + */ +export async function openPathInApp(appId: string, path: string): Promise { + const response = await fetch(new URL(OPEN_IN_APP_OPEN_ROUTE, hostBase()), { + method: 'POST', + headers: { 'Content-Type': 'application/json' }, + body: JSON.stringify({ app: appId, path }), + }) + if (!response.ok) throw new Error(`open-in-app launch failed: ${response.status}`) +}