@woosau/dsh-custom-env 0.0.0-stage → 0.1.1

package/lib/typert.host.d.ts

@@ -0,0 +1,5 @@
+/* Generated by @deepseek-ai/dsh-typert-generator from FaceModel — do not edit. */
+export declare const TYPERT: {
+  readonly package: '@woosau/dsh-custom-env'
+  readonly face: 'host'
+}

package/lib/typert.host.js

@@ -0,0 +1,295 @@
+/* Generated by @deepseek-ai/dsh-typert-generator from FaceModel — do not edit. */
+import { z } from 'zod'
+
+import { createTypertRemoteInfo } from '@deepseek-ai/dsh-typert-protocol/remote-info'
+
+let list$result$schema$value
+const list$result$schema = () => (list$result$schema$value ??= z.object({
+  path: z.string().readonly(),
+  exists: z.boolean().readonly(),
+  entries: z.array(z.object({
+    id: z.string().readonly(),
+    name: z.string().readonly(),
+    value: z.string().readonly(),
+    kind: z.enum(['unchanged', 'modified', 'added']).readonly(),
+    previous: z.string().nullable().readonly(),
+  }).readonly()).readonly(),
+}))
+
+let cliStatus$result$schema$value
+const cliStatus$result$schema = () => (cliStatus$result$schema$value ??= z.object({
+  platform: z.string().readonly(),
+  activePath: z.string().nullable().readonly(),
+  expectedPath: z.string().nullable().readonly(),
+  expectedDirectory: z.string().nullable().readonly(),
+  matches: z.boolean().readonly(),
+  canInstall: z.boolean().readonly(),
+  reason: z.string().nullable().readonly(),
+}))
+
+let upsert$parameter$0$schema$value
+const upsert$parameter$0$schema = () => (upsert$parameter$0$schema$value ??= z.string())
+let upsert$parameter$1$schema$value
+const upsert$parameter$1$schema = () => (upsert$parameter$1$schema$value ??= z.string())
+let upsert$parameter$2$schema$value
+const upsert$parameter$2$schema = () => (upsert$parameter$2$schema$value ??= z.string())
+
+let remove$parameter$0$schema$value
+const remove$parameter$0$schema = () => (remove$parameter$0$schema$value ??= z.string())
+
+let restore$parameter$0$schema$value
+const restore$parameter$0$schema = () => (restore$parameter$0$schema$value ??= z.string())
+
+const cliStatusJsonSchema = {
+  type: 'object',
+  properties: {
+    platform: { type: 'string' },
+    activePath: { type: ['string', 'null'] },
+    expectedPath: { type: ['string', 'null'] },
+    expectedDirectory: { type: ['string', 'null'] },
+    matches: { type: 'boolean' },
+    canInstall: { type: 'boolean' },
+    reason: { type: ['string', 'null'] },
+  },
+  required: ['platform', 'activePath', 'expectedPath', 'expectedDirectory', 'matches', 'canInstall', 'reason'],
+  additionalProperties: true,
+}
+
+const envSnapshotJsonSchema = {
+  type: 'object',
+  properties: {
+    path: { type: 'string' },
+    exists: { type: 'boolean' },
+    entries: {
+      type: 'array',
+      items: {
+        type: 'object',
+        properties: {
+          id: { type: 'string' },
+          name: { type: 'string' },
+          value: { type: 'string' },
+          kind: { type: 'string', enum: ['unchanged', 'modified', 'added'] },
+          previous: { type: ['string', 'null'] },
+        },
+        required: ['id', 'name', 'value', 'kind', 'previous'],
+        additionalProperties: true,
+      },
+    },
+  },
+  required: ['path', 'exists', 'entries'],
+  additionalProperties: true,
+}
+
+const $remote = createTypertRemoteInfo({
+  package: '@woosau/dsh-custom-env',
+  methods: {
+    'customEnv/list': {
+      service: 'customEnv',
+      description: 'List current $DSH_HOME/.env entries with pending classification.',
+      invocation: { kind: 'direct' },
+      parameters: [],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@woosau/dsh-custom-env/types#EnvSnapshot',
+        create: list$result$schema,
+        description: 'path, existence, and sorted entries.',
+        jsonSchema: envSnapshotJsonSchema,
+      },
+      sourceLocation: { file: 'src/index.ts', line: 1, column: 1 },
+    },
+    'customEnv/upsert': {
+      service: 'customEnv',
+      description: 'Create or update one row. Empty id creates a new row; otherwise keeps that baseline id across renames.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'id',
+          description: 'stable row id from list(), or empty string for a new row.',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: 'string',
+            create: upsert$parameter$0$schema,
+            jsonSchema: { type: 'string' },
+          },
+        },
+        {
+          name: 'name',
+          description: 'writable variable name.',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: 'string',
+            create: upsert$parameter$1$schema,
+            jsonSchema: { type: 'string' },
+          },
+        },
+        {
+          name: 'value',
+          description: 'non-empty value.',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: 'string',
+            create: upsert$parameter$2$schema,
+            jsonSchema: { type: 'string' },
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@woosau/dsh-custom-env/types#EnvSnapshot',
+        create: list$result$schema,
+        description: 'updated snapshot.',
+        jsonSchema: envSnapshotJsonSchema,
+      },
+      sourceLocation: { file: 'src/index.ts', line: 1, column: 1 },
+    },
+    'customEnv/deleteEntry': {
+      service: 'customEnv',
+      description: 'Delete one entry from the file, Host, and OS user environment.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'id',
+          description: 'stable row id from list().',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: 'string',
+            create: remove$parameter$0$schema,
+            jsonSchema: { type: 'string' },
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@woosau/dsh-custom-env/types#EnvSnapshot',
+        create: list$result$schema,
+        description: 'updated snapshot.',
+        jsonSchema: envSnapshotJsonSchema,
+      },
+      sourceLocation: { file: 'src/index.ts', line: 1, column: 1 },
+    },
+    'customEnv/restore': {
+      service: 'customEnv',
+      description: 'Restore Host-start original name+value for this id, or delete if added after start.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'id',
+          description: 'stable row id from list().',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: 'string',
+            create: restore$parameter$0$schema,
+            jsonSchema: { type: 'string' },
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@woosau/dsh-custom-env/types#EnvSnapshot',
+        create: list$result$schema,
+        description: 'updated snapshot.',
+        jsonSchema: envSnapshotJsonSchema,
+      },
+      sourceLocation: { file: 'src/index.ts', line: 1, column: 1 },
+    },
+    'customEnv/cliStatus': {
+      service: 'customEnv',
+      description: 'Compare the user-environment dsh with the launcher expected for this Host.',
+      invocation: { kind: 'direct' },
+      parameters: [],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@woosau/dsh-custom-env/types#CliStatus',
+        create: cliStatus$result$schema,
+        description: 'active path, expected path, and whether Install should be offered.',
+        jsonSchema: cliStatusJsonSchema,
+      },
+      sourceLocation: { file: 'src/index.ts', line: 1, column: 1 },
+    },
+    'customEnv/cliInstall': {
+      service: 'customEnv',
+      description: 'Install the expected CLI onto the Windows user PATH or as /usr/local/bin/dsh on macOS.',
+      invocation: { kind: 'direct' },
+      parameters: [],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@woosau/dsh-custom-env/types#CliStatus',
+        create: cliStatus$result$schema,
+        description: 'refreshed status after install.',
+        jsonSchema: cliStatusJsonSchema,
+      },
+      sourceLocation: { file: 'src/index.ts', line: 1, column: 1 },
+    },
+  },
+}, z)
+
+export const TYPERT = {
+  package: '@woosau/dsh-custom-env',
+  face: 'host',
+  schemas: [],
+  get invocations() { return $remote.descriptors },
+  model: {
+    services: [
+      {
+        description: 'Host remote for $DSH_HOME/.env CRUD with live Host/OS sync.',
+        summary: 'Host remote for $DSH_HOME/.env CRUD with live Host/OS sync.',
+        tags: [],
+        jsDoc: '/** Host remote for `$DSH_HOME/.env` CRUD with live Host/OS sync. */',
+        key: 'customEnv',
+        exportName: 'default',
+        members: [
+          {
+            kind: 'method',
+            name: 'list',
+            signature: "@Remote('list') async list(): Promise<EnvSnapshot>",
+            summary: 'List current $DSH_HOME/.env entries.',
+            jsDoc: '/** List current `$DSH_HOME/.env` entries. */',
+          },
+          {
+            kind: 'method',
+            name: 'upsert',
+            signature: "@Remote('upsert') async upsert(id: string, name: string, value: string): Promise<EnvSnapshot>",
+            summary: 'Create or update one row by id.',
+            jsDoc: '/** Create (`id === ""`) or update/rename one row. */',
+          },
+          {
+            kind: 'method',
+            name: 'deleteEntry',
+            signature: "@Remote('deleteEntry') async deleteEntry(id: string): Promise<EnvSnapshot>",
+            summary: 'Delete one row by stable id.',
+            jsDoc: '/** Delete one entry by id. */',
+          },
+          {
+            kind: 'method',
+            name: 'restore',
+            signature: "@Remote('restore') async restore(id: string): Promise<EnvSnapshot>",
+            summary: 'Restore Host-start original name+value for this id.',
+            jsDoc: '/** Restore Host-start original name+value for this id. */',
+          },
+          {
+            kind: 'method',
+            name: 'cliStatus',
+            signature: "@Remote('cliStatus') async cliStatus(): Promise<CliStatus>",
+            summary: 'Compare user-environment dsh with this Host launcher.',
+            jsDoc: '/** Compare the user-environment `dsh` with the launcher expected for this Host. */',
+          },
+          {
+            kind: 'method',
+            name: 'cliInstall',
+            signature: "@Remote('cliInstall') async cliInstall(): Promise<CliStatus>",
+            summary: 'Install expected CLI onto PATH or /usr/local/bin/dsh.',
+            jsDoc: '/** Install the expected CLI onto the Windows user PATH or as `/usr/local/bin/dsh` on macOS. */',
+          },
+        ],
+        types: [],
+      },
+    ],
+    events: [],
+    objects: [],
+  },
+}

package/lib/typert.remote-client.d.ts

@@ -0,0 +1,15 @@
+/* Generated by @deepseek-ai/dsh-typert-generator from the Host FaceModel — do not edit. */
+import type { TypertRemoteContribution } from '@deepseek-ai/dsh-typert-protocol'
+
+declare const TYPERT_REMOTE: TypertRemoteContribution
+export { TYPERT_REMOTE }
+export default TYPERT_REMOTE
+
+declare module '@deepseek-ai/dsh-typert-protocol' {
+  interface RemoteErrorDetailsMap {
+    'custom-env/invalid-name': { readonly name: string }
+    'custom-env/invalid-value': { readonly name: string }
+    'custom-env/cli-install-failed': { readonly code: string }
+    'custom-env/restore-failed': { readonly name: string }
+  }
+}

package/lib/typert.remote-client.js

@@ -0,0 +1,231 @@
+/* Generated by @deepseek-ai/dsh-typert-generator from the Host FaceModel — do not edit. */
+import { z } from 'zod'
+
+import { createTypertRemoteInfo } from '@deepseek-ai/dsh-typert-protocol/remote-info'
+
+let list$result$schema$value
+const list$result$schema = () => (list$result$schema$value ??= z.object({
+  path: z.string().readonly(),
+  exists: z.boolean().readonly(),
+  entries: z.array(z.object({
+    id: z.string().readonly(),
+    name: z.string().readonly(),
+    value: z.string().readonly(),
+    kind: z.enum(['unchanged', 'modified', 'added']).readonly(),
+    previous: z.string().nullable().readonly(),
+  }).readonly()).readonly(),
+}))
+
+let cliStatus$result$schema$value
+const cliStatus$result$schema = () => (cliStatus$result$schema$value ??= z.object({
+  platform: z.string().readonly(),
+  activePath: z.string().nullable().readonly(),
+  expectedPath: z.string().nullable().readonly(),
+  expectedDirectory: z.string().nullable().readonly(),
+  matches: z.boolean().readonly(),
+  canInstall: z.boolean().readonly(),
+  reason: z.string().nullable().readonly(),
+}))
+
+let upsert$parameter$0$schema$value
+const upsert$parameter$0$schema = () => (upsert$parameter$0$schema$value ??= z.string())
+let upsert$parameter$1$schema$value
+const upsert$parameter$1$schema = () => (upsert$parameter$1$schema$value ??= z.string())
+let upsert$parameter$2$schema$value
+const upsert$parameter$2$schema = () => (upsert$parameter$2$schema$value ??= z.string())
+
+let remove$parameter$0$schema$value
+const remove$parameter$0$schema = () => (remove$parameter$0$schema$value ??= z.string())
+
+let restore$parameter$0$schema$value
+const restore$parameter$0$schema = () => (restore$parameter$0$schema$value ??= z.string())
+
+const cliStatusJsonSchema = {
+  type: 'object',
+  properties: {
+    platform: { type: 'string' },
+    activePath: { type: ['string', 'null'] },
+    expectedPath: { type: ['string', 'null'] },
+    expectedDirectory: { type: ['string', 'null'] },
+    matches: { type: 'boolean' },
+    canInstall: { type: 'boolean' },
+    reason: { type: ['string', 'null'] },
+  },
+  required: ['platform', 'activePath', 'expectedPath', 'expectedDirectory', 'matches', 'canInstall', 'reason'],
+  additionalProperties: true,
+}
+
+const envSnapshotJsonSchema = {
+  type: 'object',
+  properties: {
+    path: { type: 'string' },
+    exists: { type: 'boolean' },
+    entries: {
+      type: 'array',
+      items: {
+        type: 'object',
+        properties: {
+          id: { type: 'string' },
+          name: { type: 'string' },
+          value: { type: 'string' },
+          kind: { type: 'string', enum: ['unchanged', 'modified', 'added'] },
+          previous: { type: ['string', 'null'] },
+        },
+        required: ['id', 'name', 'value', 'kind', 'previous'],
+        additionalProperties: true,
+      },
+    },
+  },
+  required: ['path', 'exists', 'entries'],
+  additionalProperties: true,
+}
+
+export const TYPERT_REMOTE = createTypertRemoteInfo({
+  package: '@woosau/dsh-custom-env',
+  methods: {
+    'customEnv/list': {
+      service: 'customEnv',
+      description: 'List current $DSH_HOME/.env entries with pending classification.',
+      invocation: { kind: 'direct' },
+      parameters: [],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@woosau/dsh-custom-env/types#EnvSnapshot',
+        create: list$result$schema,
+        description: 'path, existence, and sorted entries.',
+        jsonSchema: envSnapshotJsonSchema,
+      },
+      sourceLocation: { file: 'src/index.ts', line: 1, column: 1 },
+    },
+    'customEnv/upsert': {
+      service: 'customEnv',
+      description: 'Create or update one row. Empty id creates a new row; otherwise keeps that baseline id across renames.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'id',
+          description: 'stable row id from list(), or empty string for a new row.',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: 'string',
+            create: upsert$parameter$0$schema,
+            jsonSchema: { type: 'string' },
+          },
+        },
+        {
+          name: 'name',
+          description: 'writable variable name.',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: 'string',
+            create: upsert$parameter$1$schema,
+            jsonSchema: { type: 'string' },
+          },
+        },
+        {
+          name: 'value',
+          description: 'non-empty value.',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: 'string',
+            create: upsert$parameter$2$schema,
+            jsonSchema: { type: 'string' },
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@woosau/dsh-custom-env/types#EnvSnapshot',
+        create: list$result$schema,
+        description: 'updated snapshot.',
+        jsonSchema: envSnapshotJsonSchema,
+      },
+      sourceLocation: { file: 'src/index.ts', line: 1, column: 1 },
+    },
+    'customEnv/deleteEntry': {
+      service: 'customEnv',
+      description: 'Delete one entry from the file, Host, and OS user environment.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'id',
+          description: 'stable row id from list().',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: 'string',
+            create: remove$parameter$0$schema,
+            jsonSchema: { type: 'string' },
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@woosau/dsh-custom-env/types#EnvSnapshot',
+        create: list$result$schema,
+        description: 'updated snapshot.',
+        jsonSchema: envSnapshotJsonSchema,
+      },
+      sourceLocation: { file: 'src/index.ts', line: 1, column: 1 },
+    },
+    'customEnv/restore': {
+      service: 'customEnv',
+      description: 'Restore Host-start original name+value for this id, or delete if added after start.',
+      invocation: { kind: 'direct' },
+      parameters: [
+        {
+          name: 'id',
+          description: 'stable row id from list().',
+          source: 'json',
+          codec: {
+            mode: 'strict',
+            typeSymbol: 'string',
+            create: restore$parameter$0$schema,
+            jsonSchema: { type: 'string' },
+          },
+        },
+      ],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@woosau/dsh-custom-env/types#EnvSnapshot',
+        create: list$result$schema,
+        description: 'updated snapshot.',
+        jsonSchema: envSnapshotJsonSchema,
+      },
+      sourceLocation: { file: 'src/index.ts', line: 1, column: 1 },
+    },
+    'customEnv/cliStatus': {
+      service: 'customEnv',
+      description: 'Compare the user-environment dsh with the launcher expected for this Host.',
+      invocation: { kind: 'direct' },
+      parameters: [],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@woosau/dsh-custom-env/types#CliStatus',
+        create: cliStatus$result$schema,
+        description: 'active path, expected path, and whether Install should be offered.',
+        jsonSchema: cliStatusJsonSchema,
+      },
+      sourceLocation: { file: 'src/index.ts', line: 1, column: 1 },
+    },
+    'customEnv/cliInstall': {
+      service: 'customEnv',
+      description: 'Install the expected CLI onto the Windows user PATH or as /usr/local/bin/dsh on macOS.',
+      invocation: { kind: 'direct' },
+      parameters: [],
+      result: {
+        mode: 'strict',
+        typeSymbol: '@woosau/dsh-custom-env/types#CliStatus',
+        create: cliStatus$result$schema,
+        description: 'refreshed status after install.',
+        jsonSchema: cliStatusJsonSchema,
+      },
+      sourceLocation: { file: 'src/index.ts', line: 1, column: 1 },
+    },
+  },
+}, z)
+
+export default TYPERT_REMOTE

package/lib/types/cli-path/index.d.ts

@@ -0,0 +1,12 @@
+/** CLI PATH status and install entry points for the Host remote. */
+import { type CliStatus } from './status.ts';
+export type { CliStatus } from './status.ts';
+/**
+ * Report whether the user-environment `dsh` matches this Host's expected launcher.
+ */
+export declare function cliStatus(): Promise<CliStatus>;
+/**
+ * Install the expected CLI into the user environment (Windows PATH / macOS symlink).
+ * @returns refreshed status after install.
+ */
+export declare function cliInstall(): Promise<CliStatus>;

package/lib/types/cli-path/inspect-active.d.ts

@@ -0,0 +1,33 @@
+/** Locate the first `dsh` visible on the user + machine PATH. */
+declare const MAC_DESTINATION = "/usr/local/bin/dsh";
+/** Result of scanning PATH for an active dsh command. */
+export interface ActiveCli {
+    /** Absolute path of the first matching launcher, if any. */
+    readonly path: string | undefined;
+    /** When `path` is a symlink, its resolved target (macOS / POSIX). */
+    readonly symlinkTarget: string | undefined;
+}
+/** Inputs for tests. */
+export interface InspectActiveOptions {
+    readonly platform?: NodeJS.Platform;
+    readonly pathEnv?: string | undefined;
+    readonly machinePath?: string | undefined;
+    readonly pathext?: string | undefined;
+    readonly exists?: (path: string) => boolean;
+    readonly isExecutable?: (path: string) => boolean;
+    readonly readLink?: (path: string) => string | undefined;
+}
+/**
+ * Find the first `dsh` on PATH (machine then user on Windows).
+ * @param options - optional env overrides for tests.
+ */
+export declare function inspectActiveCli(options?: InspectActiveOptions): ActiveCli;
+/**
+ * Whether the active CLI matches the expected launcher.
+ * On macOS, prefer symlink target comparison when active is `/usr/local/bin/dsh`.
+ * @param active - PATH scan result.
+ * @param expectedLauncher - expected absolute launcher.
+ * @param platform - override for tests.
+ */
+export declare function activeMatchesExpected(active: ActiveCli, expectedLauncher: string, platform?: NodeJS.Platform): boolean;
+export { MAC_DESTINATION };

package/lib/types/cli-path/macos.d.ts

@@ -0,0 +1,21 @@
+/** macOS: install `/usr/local/bin/dsh` → expected launcher (may conflict with Desktop). */
+/** Fixed public command path used by Desktop and this plugin. */
+export declare const MAC_CLI_DESTINATION = "/usr/local/bin/dsh";
+/** Receipt owned by this plugin (never `.dsh-desktop-command.json`). */
+export declare const MAC_CLI_RECEIPT = "/usr/local/bin/.dsh-custom-env-command.json";
+declare class MacosCommandError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+/**
+ * Read the current symlink target at the public destination, if any.
+ * @param destination - absolute path (default `/usr/local/bin/dsh`).
+ */
+export declare function readMacosCliLink(destination?: string): string | undefined;
+/**
+ * Install or repair the `/usr/local/bin/dsh` symlink to `launcher`.
+ * Elevates with osascript when the first attempt hits EACCES.
+ * @param launcher - absolute path of the expected `dsh` script.
+ */
+export declare function installMacosCliLink(launcher: string): Promise<void>;
+export { MacosCommandError };

package/lib/types/cli-path/paths.d.ts

@@ -0,0 +1,46 @@
+/** Shared path helpers for CLI install status. */
+import { existsSync } from 'node:fs';
+import { basename, dirname, isAbsolute, join, normalize, resolve, sep } from 'node:path';
+/** Launcher file name for the current platform. */
+export declare function launcherName(platform?: NodeJS.Platform): string;
+/**
+ * Compare two absolute paths for equality.
+ * @param left - first path.
+ * @param right - second path.
+ * @param platform - override for tests.
+ */
+export declare function samePath(left: string, right: string, platform?: NodeJS.Platform): boolean;
+/**
+ * Normalize a path for comparison (absolute, trimmed separators; lower-case on Windows).
+ * @param path - input path.
+ * @param platform - override for tests.
+ */
+export declare function normalizeComparable(path: string, platform?: NodeJS.Platform): string;
+/**
+ * Resolve `…/resources` next to an Electron executable when present.
+ * @param execPath - `process.execPath`.
+ * @param platform - override for tests.
+ * @param exists - filesystem probe.
+ * @returns resources directory or `undefined`.
+ */
+export declare function findElectronResources(execPath: string, platform?: NodeJS.Platform, exists?: (path: string) => boolean): string | undefined;
+/**
+ * Walk parents of `start` looking for a directory that contains the launcher.
+ * @param start - file or directory to start from.
+ * @param platform - override for tests.
+ * @param maxHops - parent hops.
+ * @param exists - filesystem probe.
+ */
+export declare function findLauncherDirectory(start: string, platform?: NodeJS.Platform, maxHops?: number, exists?: (path: string) => boolean): string | undefined;
+/**
+ * Whether `argv1` looks like a DSH CLI entry script.
+ * @param argv1 - `process.argv[1]`.
+ */
+export declare function looksLikeCliEntry(argv1: string | undefined): boolean;
+/**
+ * Join PATH-like segments with the platform separator.
+ * @param parts - path segments (may be empty).
+ * @param platform - override for tests.
+ */
+export declare function joinPathEnv(parts: readonly string[], platform?: NodeJS.Platform): string;
+export { dirname, existsSync, isAbsolute, join, normalize, resolve, sep, basename };