creatixchu
f0f897ef02
- resolve.ts: gate the display branch on linux (the native backend drives exactly darwin/win32/linux) and require a zenity/kdialog binary on PATH, probed once at boot (new probe.ts, injected predicate for tests); type bindHost as the webserver schema's closed union. - index.ts: the disposer now joins the removed entry's fiber teardown so unloading the chooser settles only after the backend quiesced; export BACKEND_PACKAGES as the runtime-string source of truth. - verify-cordis-config: a composition mounting -auto must declare both backends as dependencies (negative-tested), since keyless Linux CI only ever resolves browse and would hide a dropped -native dep. - apps/web scaffold: pin -browse via disable+insert (goldens are interaction-specific); fix the stale workspace-flow comment. - docs/module-graph.md regenerated; README + Agent Note document the ssh -L shape, the PATH-only probe, and the new gate (zh pairs re-paired). - composition spec: assert teardown quiescence without a loader await, cover external entry removal, and await the loader's self-dispose disabled-persist so it cannot race temp-dir teardown.
54 lines
2.7 KiB
TypeScript
54 lines
2.7 KiB
TypeScript
/**
|
|
* Boot-time backend resolution for the adaptive directory-picker composition:
|
|
* one pure decision from sampled host facts to a concrete backend kind. The
|
|
* caller samples exactly once per boot, so the mounted capability stays
|
|
* stable for the service lifetime as the seam requires.
|
|
* @module @deepseek-ai/dsh-host-directory-picker-auto/resolve
|
|
*/
|
|
|
|
import type { Config as HttpServerConfig } from '@deepseek-ai/dsh-host-webserver'
|
|
|
|
/** Concrete interaction backend the resolver chooses between. */
|
|
export type DirectoryPickerBackendKind = 'native' | 'browse'
|
|
|
|
/** Environment keys the resolution reads (a `process.env` subset). */
|
|
export type DirectoryPickerEnv = Readonly<
|
|
Partial<Record<'SSH_CONNECTION' | 'SSH_TTY' | 'DISPLAY' | 'WAYLAND_DISPLAY', string>>
|
|
>
|
|
|
|
/** Host facts the backend choice is a pure function of, sampled once at boot. */
|
|
export interface DirectoryPickerHostFacts {
|
|
/** Effective webserver bind host (the schema's closed loopback/all-interfaces union). */
|
|
bindHost: HttpServerConfig['host']
|
|
/** Host process platform. */
|
|
platform: NodeJS.Platform
|
|
/** Environment sample; SSH marks a remote operator, DISPLAY/WAYLAND_DISPLAY a Linux display. */
|
|
env: DirectoryPickerEnv
|
|
/** Whether a Linux chooser binary the native backend can drive (zenity/kdialog) is on PATH; consulted only when `platform` is linux. */
|
|
linuxChooser: boolean
|
|
}
|
|
|
|
/** An env value counts only when set and non-blank (an empty export is "unset" by shell convention). */
|
|
const present = (value: string | undefined): boolean => value !== undefined && value !== ''
|
|
|
|
/**
|
|
* Resolve which backend serves this boot. `native` requires every signal that
|
|
* the operator can see the host display and the native backend can serve it:
|
|
* a loopback-only bind (an all-interfaces bind admits remote browsers no OS
|
|
* chooser can reach), no SSH launch (under SSH port-forwarding the chooser
|
|
* would open on the unattended server), and a servable display session —
|
|
* assumed on darwin/win32, requiring `DISPLAY`/`WAYLAND_DISPLAY` plus a
|
|
* chooser binary on linux, and never true elsewhere (the native backend
|
|
* drives exactly darwin/win32/linux). Anything ambiguous resolves to
|
|
* `browse`, which works everywhere.
|
|
* @param facts - the sampled host facts.
|
|
* @returns the backend kind to mount.
|
|
*/
|
|
export function resolveDirectoryPickerBackend(facts: DirectoryPickerHostFacts): DirectoryPickerBackendKind {
|
|
if (facts.bindHost !== '127.0.0.1') return 'browse'
|
|
if (present(facts.env.SSH_CONNECTION) || present(facts.env.SSH_TTY)) return 'browse'
|
|
if (facts.platform === 'darwin' || facts.platform === 'win32') return 'native'
|
|
if (facts.platform !== 'linux' || !facts.linuxChooser) return 'browse'
|
|
return present(facts.env.DISPLAY) || present(facts.env.WAYLAND_DISPLAY) ? 'native' : 'browse'
|
|
}
|