@flighthq/shell 0.5.1-next.1069.554a2ac → 0.5.1-next.1201.9b49dee

package/README.md

@@ -13,5 +13,5 @@ Import the supported application-facing API from `@flighthq/shell`. The `@flight
 This package is part of the locked-version Flight SDK graph. Applications may instead install and import `@flighthq/sdk` when package-level tree shaking is sufficient.
 
 - [Flight project](https://github.com/flighthq/flight)
-- [Source for @flighthq/shell@0.5.1-next.1069.554a2ac](https://github.com/flighthq/flight/tree/554a2acc3fecf189b89b0729308ff890a15c21cc/packages/shell)
-- [License](https://github.com/flighthq/flight/blob/554a2acc3fecf189b89b0729308ff890a15c21cc/LICENSE.md)
+- [Source for @flighthq/shell@0.5.1-next.1201.9b49dee](https://github.com/flighthq/flight/tree/9b49dee3f22f6b2838c3d237edcc77bca65734f2/packages/shell)
+- [License](https://github.com/flighthq/flight/blob/9b49dee3f22f6b2838c3d237edcc77bca65734f2/LICENSE.md)

package/dist/shell.d.ts

@@ -1,12 +1,12 @@
-import type { HasShellBeep, HasShellExternal, HasShellPathOpen, HasShellPathReveal, HasShellShortcutLink, HasShellTrash, ShellExternalOutcome, ShellExternalUrlPolicy, ShellPathOpenOutcome, ShellPathRevealOutcome, ShellProcess, ShellProcessHost, ShellProcessOptions, ShellShortcutLink, ShellShortcutLinkReadOutcome, ShellShortcutLinkWriteOutcome, ShellShortcutWriteOperation, ShellTrashOutcome } from '@flighthq/types/contract';
+import type { HostShellBeepProvider, HostShellExternalProvider, HostShellPathOpenProvider, HostShellPathRevealProvider, HostShellProcessProvider, HostShellShortcutLinkProvider, HostShellTrashProvider, ShellExternalOutcome, ShellExternalUrlPolicy, ShellPathOpenOutcome, ShellPathRevealOutcome, ShellProcess, ShellProcessOptions, ShellShortcutLink, ShellShortcutLinkReadOutcome, ShellShortcutLinkWriteOutcome, ShellShortcutWriteOperation, ShellTrashOutcome } from '@flighthq/types/contract';
 export declare function isShellUrlAllowed(url: string, policy: Readonly<ShellExternalUrlPolicy>): boolean;
-export declare function moveShellItemsToTrash(host: HasShellTrash, paths: readonly string[]): Promise<readonly ShellTrashOutcome[]>;
-export declare function moveShellItemToTrash(host: HasShellTrash, path: string): Promise<ShellTrashOutcome>;
-export declare function openShellExternalUrl(host: HasShellExternal, url: string, policy: Readonly<ShellExternalUrlPolicy>): Promise<ShellExternalOutcome>;
-export declare function openShellPath(host: HasShellPathOpen, path: string): Promise<ShellPathOpenOutcome>;
-export declare function readShellShortcutLink(host: HasShellShortcutLink, shortcutPath: string): Promise<ShellShortcutLinkReadOutcome>;
-export declare function revealShellPath(host: HasShellPathReveal, path: string): Promise<ShellPathRevealOutcome>;
-export declare function shellBeep(host: HasShellBeep): void;
-export declare function spawnShellProcess(host: ShellProcessHost, command: string, args: readonly string[], options?: Readonly<ShellProcessOptions>): ShellProcess | null;
-export declare function writeShellShortcutLink(host: HasShellShortcutLink, shortcutPath: string, link: Readonly<ShellShortcutLink>, operation: ShellShortcutWriteOperation): Promise<ShellShortcutLinkWriteOutcome>;
+export declare function moveShellItemsToTrash(hostShellTrash: Readonly<HostShellTrashProvider>, paths: readonly string[]): Promise<readonly ShellTrashOutcome[]>;
+export declare function moveShellItemToTrash(hostShellTrash: Readonly<HostShellTrashProvider>, path: string): Promise<ShellTrashOutcome>;
+export declare function openShellExternalUrl(hostShellExternal: Readonly<HostShellExternalProvider>, url: string, policy: Readonly<ShellExternalUrlPolicy>): Promise<ShellExternalOutcome>;
+export declare function openShellPath(hostShellPathOpen: Readonly<HostShellPathOpenProvider>, path: string): Promise<ShellPathOpenOutcome>;
+export declare function readShellShortcutLink(hostShellShortcutLink: Readonly<HostShellShortcutLinkProvider>, shortcutPath: string): Promise<ShellShortcutLinkReadOutcome>;
+export declare function revealShellPath(hostShellPathReveal: Readonly<HostShellPathRevealProvider>, path: string): Promise<ShellPathRevealOutcome>;
+export declare function shellBeep(hostShellBeep: Readonly<HostShellBeepProvider>): void;
+export declare function spawnShellProcess(hostShellProcess: Readonly<HostShellProcessProvider>, command: string, args: readonly string[], options?: Readonly<ShellProcessOptions>): ShellProcess;
+export declare function writeShellShortcutLink(hostShellShortcutLink: Readonly<HostShellShortcutLinkProvider>, shortcutPath: string, link: Readonly<ShellShortcutLink>, operation: ShellShortcutWriteOperation): Promise<ShellShortcutLinkWriteOutcome>;
 //# sourceMappingURL=shell.d.ts.map

package/dist/shell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../src/shell.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,4BAA4B,EAC5B,6BAA6B,EAC7B,2BAA2B,EAC3B,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAIlC,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,sBAAsB,CAAC,GAAG,OAAO,CAOhG;AAID,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,aAAa,EACnB,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAEvC;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAElG;AAKD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,gBAAgB,EACtB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,QAAQ,CAAC,sBAAsB,CAAC,GACvC,OAAO,CAAC,oBAAoB,CAAC,CAG/B;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAEjG;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,oBAAoB,EAC1B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,4BAA4B,CAAC,CAEvC;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAEvG;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAElD;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,CAAC,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GACtC,YAAY,GAAG,IAAI,CAErB;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,oBAAoB,EAC1B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACjC,SAAS,EAAE,2BAA2B,GACrC,OAAO,CAAC,6BAA6B,CAAC,CAExC"}
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../src/shell.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,wBAAwB,EACxB,6BAA6B,EAC7B,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,sBAAsB,EACtB,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,4BAA4B,EAC5B,6BAA6B,EAC7B,2BAA2B,EAC3B,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAIlC,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,sBAAsB,CAAC,GAAG,OAAO,CAOhG;AAID,wBAAgB,qBAAqB,CACnC,cAAc,EAAE,QAAQ,CAAC,sBAAsB,CAAC,EAChD,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAEvC;AAED,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,QAAQ,CAAC,sBAAsB,CAAC,EAChD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,iBAAiB,CAAC,CAE5B;AAKD,wBAAgB,oBAAoB,CAClC,iBAAiB,EAAE,QAAQ,CAAC,yBAAyB,CAAC,EACtD,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,QAAQ,CAAC,sBAAsB,CAAC,GACvC,OAAO,CAAC,oBAAoB,CAAC,CAG/B;AAED,wBAAgB,aAAa,CAC3B,iBAAiB,EAAE,QAAQ,CAAC,yBAAyB,CAAC,EACtD,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,oBAAoB,CAAC,CAE/B;AAED,wBAAgB,qBAAqB,CACnC,qBAAqB,EAAE,QAAQ,CAAC,6BAA6B,CAAC,EAC9D,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,4BAA4B,CAAC,CAEvC;AAED,wBAAgB,eAAe,CAC7B,mBAAmB,EAAE,QAAQ,CAAC,2BAA2B,CAAC,EAC1D,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,sBAAsB,CAAC,CAEjC;AAED,wBAAgB,SAAS,CAAC,aAAa,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GAAG,IAAI,CAE9E;AAED,wBAAgB,iBAAiB,CAC/B,gBAAgB,EAAE,QAAQ,CAAC,wBAAwB,CAAC,EACpD,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,CAAC,EAAE,QAAQ,CAAC,mBAAmB,CAAC,GACtC,YAAY,CAEd;AAED,wBAAgB,sBAAsB,CACpC,qBAAqB,EAAE,QAAQ,CAAC,6BAA6B,CAAC,EAC9D,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACjC,SAAS,EAAE,2BAA2B,GACrC,OAAO,CAAC,6BAA6B,CAAC,CAExC"}

package/dist/shell.js

@@ -11,36 +11,36 @@ export function isShellUrlAllowed(url, policy) {
 }
 // Projects the one-path provider operation across the batch. Promise.all starts every operation,
 // awaits every settlement, and returns outcomes in the same order as paths.
-export function moveShellItemsToTrash(host, paths) {
-    return Promise.all(paths.map((path) => host.shell.trash.moveToTrash(path)));
+export function moveShellItemsToTrash(hostShellTrash, paths) {
+    return Promise.all(paths.map((path) => hostShellTrash.moveToTrash(path)));
 }
-export function moveShellItemToTrash(host, path) {
-    return host.shell.trash.moveToTrash(path);
+export function moveShellItemToTrash(hostShellTrash, path) {
+    return hostShellTrash.moveToTrash(path);
 }
 // Handing a URL to an OS handler can launch a local application or registered protocol. The required
 // per-call policy is validated before dispatch, so a blocked or malformed scheme never reaches the
 // host. There is intentionally no policy default, ambient allowlist, or allow-all path.
-export function openShellExternalUrl(host, url, policy) {
+export function openShellExternalUrl(hostShellExternal, url, policy) {
     if (!isShellUrlAllowed(url, policy))
         return Promise.resolve({ reason: 'blocked-scheme' });
-    return host.shell.external.open(url);
+    return hostShellExternal.open(url);
 }
-export function openShellPath(host, path) {
-    return host.shell.pathOpen.open(path);
+export function openShellPath(hostShellPathOpen, path) {
+    return hostShellPathOpen.open(path);
 }
-export function readShellShortcutLink(host, shortcutPath) {
-    return host.shell.shortcutLink.read(shortcutPath);
+export function readShellShortcutLink(hostShellShortcutLink, shortcutPath) {
+    return hostShellShortcutLink.read(shortcutPath);
 }
-export function revealShellPath(host, path) {
-    return host.shell.pathReveal.reveal(path);
+export function revealShellPath(hostShellPathReveal, path) {
+    return hostShellPathReveal.reveal(path);
 }
-export function shellBeep(host) {
-    host.shell.beep.beep();
+export function shellBeep(hostShellBeep) {
+    hostShellBeep.beep();
 }
-export function spawnShellProcess(host, command, args, options) {
-    return host.shell.process?.spawn(command, args, options) ?? null;
+export function spawnShellProcess(hostShellProcess, command, args, options) {
+    return hostShellProcess.spawn(command, args, options);
 }
-export function writeShellShortcutLink(host, shortcutPath, link, operation) {
-    return host.shell.shortcutLink.write(shortcutPath, link, operation);
+export function writeShellShortcutLink(hostShellShortcutLink, shortcutPath, link, operation) {
+    return hostShellShortcutLink.write(shortcutPath, link, operation);
 }
 //# sourceMappingURL=shell.js.map

package/dist/shell.js.map

@@ -1 +1 @@
-{"version":3,"file":"shell.js","sourceRoot":"","sources":["../src/shell.ts"],"names":[],"mappings":"AAqBA,sGAAsG;AACtG,4FAA4F;AAC5F,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,MAAwC;IACrF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACrE,OAAO,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC;IACnF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,iGAAiG;AACjG,4EAA4E;AAC5E,MAAM,UAAU,qBAAqB,CACnC,IAAmB,EACnB,KAAwB;IAExB,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAmB,EAAE,IAAY;IACpE,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,qGAAqG;AACrG,mGAAmG;AACnG,wFAAwF;AACxF,MAAM,UAAU,oBAAoB,CAClC,IAAsB,EACtB,GAAW,EACX,MAAwC;IAExC,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAC1F,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAsB,EAAE,IAAY;IAChE,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,IAA0B,EAC1B,YAAoB;IAEpB,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAwB,EAAE,IAAY;IACpE,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAkB;IAC1C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,IAAsB,EACtB,OAAe,EACf,IAAuB,EACvB,OAAuC;IAEvC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,IAA0B,EAC1B,YAAoB,EACpB,IAAiC,EACjC,SAAsC;IAEtC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,YAAY,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AACtE,CAAC"}
+{"version":3,"file":"shell.js","sourceRoot":"","sources":["../src/shell.ts"],"names":[],"mappings":"AAqBA,sGAAsG;AACtG,4FAA4F;AAC5F,MAAM,UAAU,iBAAiB,CAAC,GAAW,EAAE,MAAwC;IACrF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QACrE,OAAO,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC;IACnF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,iGAAiG;AACjG,4EAA4E;AAC5E,MAAM,UAAU,qBAAqB,CACnC,cAAgD,EAChD,KAAwB;IAExB,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,cAAgD,EAChD,IAAY;IAEZ,OAAO,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED,qGAAqG;AACrG,mGAAmG;AACnG,wFAAwF;AACxF,MAAM,UAAU,oBAAoB,CAClC,iBAAsD,EACtD,GAAW,EACX,MAAwC;IAExC,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAC1F,OAAO,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,iBAAsD,EACtD,IAAY;IAEZ,OAAO,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,qBAA8D,EAC9D,YAAoB;IAEpB,OAAO,qBAAqB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,mBAA0D,EAC1D,IAAY;IAEZ,OAAO,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,aAA8C;IACtE,aAAa,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,gBAAoD,EACpD,OAAe,EACf,IAAuB,EACvB,OAAuC;IAEvC,OAAO,gBAAgB,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,qBAA8D,EAC9D,YAAoB,EACpB,IAAiC,EACjC,SAAsC;IAEtC,OAAO,qBAAqB,CAAC,KAAK,CAAC,YAAY,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AACpE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/shell",
-  "version": "0.5.1-next.1069.554a2ac",
+  "version": "0.5.1-next.1201.9b49dee",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,7 +38,7 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/types": "0.5.1-next.1069.554a2ac"
+    "@flighthq/types": "0.5.1-next.1201.9b49dee"
   },
   "devDependencies": {
     "@flighthq/entity": "*",

package/src/shell.test.ts

@@ -1,23 +1,16 @@
 import { allocateEntity, finishEntity } from '@flighthq/entity/contract';
 import type {
   EntityRuntimeKey,
-  HasShellBeep,
-  HasShellExternal,
-  HasShellPathOpen,
-  HasShellPathReveal,
-  HasShellShortcutLink,
-  HasShellTrash,
-  ShellBeepBackend,
-  ShellExternalBackend,
+  HostShellBeepProvider,
+  HostShellExternalProvider,
+  HostShellPathOpenProvider,
+  HostShellPathRevealProvider,
+  HostShellShortcutLinkProvider,
+  HostShellTrashProvider,
   ShellExternalUrlPolicy,
-  ShellPathOpenBackend,
-  ShellPathRevealBackend,
   ShellProcess,
-  ShellProcessBackend,
-  ShellProcessHost,
+  HostShellProcessProvider,
   ShellProcessOptions,
-  ShellShortcutLinkBackend,
-  ShellTrashBackend,
 } from '@flighthq/types/contract';
 
 import {
@@ -60,7 +53,7 @@ describe('moveShellItemsToTrash', () => {
       })(),
     );
 
-    const outcomes = moveShellItemsToTrash(host, ['/first', '/second']);
+    const outcomes = moveShellItemsToTrash(host.shell.trash, ['/first', '/second']);
     expect(paths).toEqual(['/first', '/second']);
     resolvers[1]?.({ reason: 'operation-failed' });
     let settled = false;
@@ -85,7 +78,7 @@ describe('moveShellItemToTrash', () => {
             out.moveToTrash = moveToTrash;
             return finishEntity(out);
           })(),
-        ),
+        ).shell.trash,
         '/item',
       ),
     ).resolves.toEqual({
@@ -98,7 +91,7 @@ describe('moveShellItemToTrash', () => {
 describe('openShellExternalUrl', () => {
   it('requires policy as the third parameter at the type boundary', () => {
     expectTypeOf(openShellExternalUrl).parameters.toEqualTypeOf<
-      [HasShellExternal, string, Readonly<ShellExternalUrlPolicy>]
+      [Readonly<HostShellExternalProvider>, string, Readonly<ShellExternalUrlPolicy>]
     >();
   });
 
@@ -111,7 +104,9 @@ describe('openShellExternalUrl', () => {
         return finishEntity(out);
       })(),
     );
-    await expect(openShellExternalUrl(host, 'file:///etc/passwd', { allowedSchemes: ['https'] })).resolves.toEqual({
+    await expect(
+      openShellExternalUrl(host.shell.external, 'file:///etc/passwd', { allowedSchemes: ['https'] }),
+    ).resolves.toEqual({
       reason: 'blocked-scheme',
     });
     expect(open).not.toHaveBeenCalled();
@@ -139,8 +134,10 @@ describe('openShellExternalUrl', () => {
         return finishEntity(out);
       })(),
     );
-    await expect(openShellExternalUrl(first, 'https://one.test', HTTPS_ONLY)).resolves.toEqual({ reason: 'ok' });
-    await expect(openShellExternalUrl(second, 'https://two.test', HTTPS_ONLY)).resolves.toEqual({
+    await expect(openShellExternalUrl(first.shell.external, 'https://one.test', HTTPS_ONLY)).resolves.toEqual({
+      reason: 'ok',
+    });
+    await expect(openShellExternalUrl(second.shell.external, 'https://two.test', HTTPS_ONLY)).resolves.toEqual({
       reason: 'operation-failed',
     });
     expect(calls).toEqual(['first:https://one.test', 'second:https://two.test']);
@@ -149,11 +146,11 @@ describe('openShellExternalUrl', () => {
 
 describe('openShellPath', () => {
   it('preserves a provider failure and its message', async () => {
-    const provider = allocateEntity<ShellPathOpenBackend>();
+    const provider = allocateEntity<HostShellPathOpenProvider>();
     provider.open = async () => {
       return { message: '', reason: 'operation-failed' as const };
     };
-    await expect(openShellPath(pathOpenHost(finishEntity(provider)), '/missing')).resolves.toEqual({
+    await expect(openShellPath(pathOpenHost(finishEntity(provider)).shell.pathOpen, '/missing')).resolves.toEqual({
       message: '',
       reason: 'operation-failed',
     });
@@ -163,7 +160,7 @@ describe('openShellPath', () => {
 describe('readShellShortcutLink', () => {
   it('returns the read-specific outcome', async () => {
     const provider = shortcutLinkProvider();
-    await expect(readShellShortcutLink(shortcutLinkHost(provider), '/app.lnk')).resolves.toEqual({
+    await expect(readShellShortcutLink(shortcutLinkHost(provider).shell.shortcutLink, '/app.lnk')).resolves.toEqual({
       link: { target: '/app' },
       reason: 'ok',
     });
@@ -181,7 +178,7 @@ describe('revealShellPath', () => {
             out.reveal = reveal;
             return finishEntity(out);
           })(),
-        ),
+        ).shell.pathReveal,
         '/item',
       ),
     ).resolves.toEqual({
@@ -200,7 +197,7 @@ describe('shellBeep', () => {
           out.beep = beep;
           return finishEntity(out);
         })(),
-      ),
+      ).shell.beep,
     );
     expect(beep).toHaveBeenCalledOnce();
   });
@@ -209,9 +206,9 @@ describe('shellBeep', () => {
 describe('spawnShellProcess', () => {
   it('exposes the explicit host, command, argument-vector, and optional-options API', () => {
     expectTypeOf(spawnShellProcess).parameters.toEqualTypeOf<
-      [ShellProcessHost, string, readonly string[], Readonly<ShellProcessOptions>?]
+      [Readonly<HostShellProcessProvider>, string, readonly string[], Readonly<ShellProcessOptions>?]
     >();
-    expectTypeOf(spawnShellProcess).returns.toEqualTypeOf<ShellProcess | null>();
+    expectTypeOf(spawnShellProcess).returns.toEqualTypeOf<ShellProcess>();
   });
 
   it('forwards the command, argument vector, and options to the host backend unchanged', () => {
@@ -227,20 +224,16 @@ describe('spawnShellProcess', () => {
     const args = ['--flag', 'value'] as const;
     const options = { cwd: '/work', environment: { MODE: 'test' } } as const;
 
-    expect(spawnShellProcess(host, '/bin/tool', args, options)).toBe(process);
+    expect(spawnShellProcess(host.shell.process, '/bin/tool', args, options)).toBe(process);
     expect(spawn).toHaveBeenCalledWith('/bin/tool', args, options);
   });
-
-  it('returns null when the host does not expose child-process support', () => {
-    expect(spawnShellProcess({ shell: {} }, '/bin/tool', [])).toBeNull();
-  });
 });
 
 describe('writeShellShortcutLink', () => {
   it('requires an explicit write operation and returns the write-specific outcome', async () => {
     const provider = shortcutLinkProvider();
     await expect(
-      writeShellShortcutLink(shortcutLinkHost(provider), '/app.lnk', { target: '/app' }, 'replace'),
+      writeShellShortcutLink(shortcutLinkHost(provider).shell.shortcutLink, '/app.lnk', { target: '/app' }, 'replace'),
     ).resolves.toEqual({ reason: 'ok' });
     expect(provider.write).toHaveBeenCalledWith('/app.lnk', { target: '/app' }, 'replace');
   });
@@ -248,23 +241,31 @@ describe('writeShellShortcutLink', () => {
 
 const HTTPS_ONLY: ShellExternalUrlPolicy = { allowedSchemes: ['https'] };
 
-function beepHost(beep: ShellBeepBackend): HasShellBeep {
+function beepHost(beep: HostShellBeepProvider): { readonly shell: { readonly beep: HostShellBeepProvider } } {
   return { shell: { beep } };
 }
 
-function externalHost(external: ShellExternalBackend): HasShellExternal {
+function externalHost(external: HostShellExternalProvider): {
+  readonly shell: { readonly external: HostShellExternalProvider };
+} {
   return { shell: { external } };
 }
 
-function pathOpenHost(pathOpen: ShellPathOpenBackend): HasShellPathOpen {
+function pathOpenHost(pathOpen: HostShellPathOpenProvider): {
+  readonly shell: { readonly pathOpen: HostShellPathOpenProvider };
+} {
   return { shell: { pathOpen } };
 }
 
-function pathRevealHost(pathReveal: ShellPathRevealBackend): HasShellPathReveal {
+function pathRevealHost(pathReveal: HostShellPathRevealProvider): {
+  readonly shell: { readonly pathReveal: HostShellPathRevealProvider };
+} {
   return { shell: { pathReveal } };
 }
 
-function processHost(process: ShellProcessBackend): ShellProcessHost {
+function processHost(process: HostShellProcessProvider): {
+  readonly shell: { readonly process: HostShellProcessProvider };
+} {
   return { shell: { process } };
 }
 
@@ -278,11 +279,13 @@ function shellProcess(): ShellProcess {
   return finishEntity(out);
 }
 
-function shortcutLinkHost(shortcutLink: ShellShortcutLinkBackend): HasShellShortcutLink {
+function shortcutLinkHost(shortcutLink: HostShellShortcutLinkProvider): {
+  readonly shell: { readonly shortcutLink: HostShellShortcutLinkProvider };
+} {
   return { shell: { shortcutLink } };
 }
 
-function shortcutLinkProvider(): ShellShortcutLinkBackend & { write: ReturnType<typeof vi.fn> } {
+function shortcutLinkProvider(): HostShellShortcutLinkProvider & { write: ReturnType<typeof vi.fn> } {
   const out = allocateEntity<any>();
   out.read = async () => {
     return { link: { target: '/app' }, reason: 'ok' };
@@ -291,6 +294,6 @@ function shortcutLinkProvider(): ShellShortcutLinkBackend & { write: ReturnType<
   return finishEntity(out);
 }
 
-function trashHost(trash: ShellTrashBackend): HasShellTrash {
+function trashHost(trash: HostShellTrashProvider): { readonly shell: { readonly trash: HostShellTrashProvider } } {
   return { shell: { trash } };
 }