@gitkraken/core-gitlens 0.6.0 → 0.7.1

package/dist/git-cli/service.js

@@ -1,43 +1,41 @@
-import { GitService } from '../git/service.js';
-import { CliGitProvider } from './cliGitProvider.js';
-import { findGitPath } from './exec/locator.js';
+import { GitService } from "../git/service.js";
+import { CliGitProvider } from "./cliGitProvider.js";
+import { findGitPath } from "./exec/locator.js";
+//#region ../git-cli/src/service.ts
 /**
- * Creates a ready-to-use {@link GitService} backed by the CLI git provider.
- *
- * This is the primary entry point for standalone (non-VS Code) consumers
- * of the `@gitkraken/core-gitlens/git-cli` library. It creates a singleton {@link GitService},
- * wires up a {@link CliGitProvider}, and registers it for all repository paths.
- *
- * @example
- * ```typescript
- * const git = createCliGitService({ context: {} });
- *
- * const repo = git.forRepo('/path/to/repo')!;
- * const branches = await repo.branches.getBranches();
- * const status = await repo.status.getStatus();
- * await repo.ops!.fetch({ remote: 'origin' });
- *
- * git.dispose(); // cleans up provider, cache, and module-level state
- * ```
- */
-export function createCliGitService(options) {
-    const service = GitService.createSingleton(options.watchingProvider);
-    const locator = options.locator ?? (() => findGitPath(options.gitPath ?? null));
-    const provider = new CliGitProvider({
-        context: options.context,
-        locator: locator,
-        gitOptions: options.gitOptions,
-        cache: options.cache,
-    });
-    service.register(provider, () => true);
-    // Advance the provider cache's status generation clock from the watch session's global events — the standalone
-    // analogue of what the VS Code host wires in `GitProviderService`. Without this, a consumer that passes a
-    // `watchingProvider` and drives watch sessions gets FS events but a FROZEN clock, so `dedupeByStatusGeneration`
-    // degrades to the pre-change/post-change stale-join this branch exists to fix. Standalone has no `Repository`
-    // models, so there are no force-fired `closed`/`lastFetched` bypassing the session for the global repo event to
-    // miss. Subscriptions are torn down with the service (its `watchService`'s emitters are disposed on dispose).
-    service.watchService?.onDidChangeWorkingTree(repoPath => provider.cache.onWorkingTreeChanged(repoPath));
-    service.watchService?.onDidChangeRepository(e => provider.cache.onRepositoryChanged(e.repoPath, e.changes));
-    return service;
+* Creates a ready-to-use {@link GitService} backed by the CLI git provider.
+*
+* This is the primary entry point for standalone (non-VS Code) consumers
+* of the `@gitkraken/core-gitlens/git-cli` library. It creates a singleton {@link GitService},
+* wires up a {@link CliGitProvider}, and registers it for all repository paths.
+*
+* @example
+* ```typescript
+* const git = createCliGitService({ context: {} });
+*
+* const repo = git.forRepo('/path/to/repo')!;
+* const branches = await repo.branches.getBranches();
+* const status = await repo.status.getStatus();
+* await repo.ops!.fetch({ remote: 'origin' });
+*
+* git.dispose(); // cleans up provider, cache, and module-level state
+* ```
+*/
+function createCliGitService(options) {
+	const service = GitService.createSingleton(options.watchingProvider);
+	const locator = options.locator ?? (() => findGitPath(options.gitPath ?? null));
+	const provider = new CliGitProvider({
+		context: options.context,
+		locator,
+		gitOptions: options.gitOptions,
+		cache: options.cache
+	});
+	service.register(provider, () => true);
+	service.watchService?.onDidChangeWorkingTree((repoPath) => provider.cache.onWorkingTreeChanged(repoPath));
+	service.watchService?.onDidChangeRepository((e) => provider.cache.onRepositoryChanged(e.repoPath, e.changes));
+	return service;
 }
+//#endregion
+export { createCliGitService };
+
 //# sourceMappingURL=service.js.map

package/dist/git-cli/service.js.map

@@ -1 +1 @@
-{"version":3,"file":"service.js","sourceRoot":"","sources":["../../src/git-cli/service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAGrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAmChD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA6B;IAChE,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAErE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC;IAChF,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC;QACnC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,OAAO,EAAE,OAAO;QAChB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;KACpB,CAAC,CAAC;IAEH,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAEvC,+GAA+G;IAC/G,0GAA0G;IAC1G,gHAAgH;IAChH,8GAA8G;IAC9G,gHAAgH;IAChH,8GAA8G;IAC9G,OAAO,CAAC,YAAY,EAAE,sBAAsB,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxG,OAAO,CAAC,YAAY,EAAE,qBAAqB,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5G,OAAO,OAAO,CAAC;AAChB,CAAC"}
+{"version":3,"file":"service.js","names":[],"sources":["../../../git-cli/src/service.ts"],"sourcesContent":["import { GitService } from '@gitlens/git/service.js';\nimport type { FileWatchingProvider } from '@gitlens/git/watching/provider.js';\nimport type { CliGitProviderOptions } from './cliGitProvider.js';\nimport { CliGitProvider } from './cliGitProvider.js';\nimport type { GitLocation } from './exec/locator.js';\nimport { findGitPath } from './exec/locator.js';\n\n/**\n * Options for {@link createCliGitService}.\n */\nexport interface CliGitServiceOptions {\n\t/**\n\t * Path(s) to the git binary.\n\t * Auto-detected if omitted (searches PATH, platform-specific locations).\n\t * Ignored when {@link locator} is provided.\n\t */\n\tgitPath?: string | string[];\n\n\t/**\n\t * Custom git binary resolver. When provided, used instead of the\n\t * default `findGitPath(gitPath)` lookup.\n\t */\n\tlocator?: () => Promise<GitLocation>;\n\n\t/** Host-provided context hooks (cache events, workspace, integrations, telemetry, fs) */\n\tcontext: CliGitProviderOptions['context'];\n\n\t/** Git execution options passed through to the underlying Git executor */\n\tgitOptions?: CliGitProviderOptions['gitOptions'];\n\n\t/** Use an existing Cache instance, or one will be created */\n\tcache?: CliGitProviderOptions['cache'];\n\n\t/**\n\t * Filesystem watching provider. When provided, the {@link GitService}\n\t * will watch repositories for changes (file creates, edits, deletes).\n\t */\n\twatchingProvider?: FileWatchingProvider;\n}\n\n/**\n * Creates a ready-to-use {@link GitService} backed by the CLI git provider.\n *\n * This is the primary entry point for standalone (non-VS Code) consumers\n * of the `@gitlens/git-cli` library. It creates a singleton {@link GitService},\n * wires up a {@link CliGitProvider}, and registers it for all repository paths.\n *\n * @example\n * ```typescript\n * const git = createCliGitService({ context: {} });\n *\n * const repo = git.forRepo('/path/to/repo')!;\n * const branches = await repo.branches.getBranches();\n * const status = await repo.status.getStatus();\n * await repo.ops!.fetch({ remote: 'origin' });\n *\n * git.dispose(); // cleans up provider, cache, and module-level state\n * ```\n */\nexport function createCliGitService(options: CliGitServiceOptions): GitService {\n\tconst service = GitService.createSingleton(options.watchingProvider);\n\n\tconst locator = options.locator ?? (() => findGitPath(options.gitPath ?? null));\n\tconst provider = new CliGitProvider({\n\t\tcontext: options.context,\n\t\tlocator: locator,\n\t\tgitOptions: options.gitOptions,\n\t\tcache: options.cache,\n\t});\n\n\tservice.register(provider, () => true);\n\n\t// Advance the provider cache's status generation clock from the watch session's global events — the standalone\n\t// analogue of what the VS Code host wires in `GitProviderService`. Without this, a consumer that passes a\n\t// `watchingProvider` and drives watch sessions gets FS events but a FROZEN clock, so `dedupeByStatusGeneration`\n\t// degrades to the pre-change/post-change stale-join this branch exists to fix. Standalone has no `Repository`\n\t// models, so there are no force-fired `closed`/`lastFetched` bypassing the session for the global repo event to\n\t// miss. Subscriptions are torn down with the service (its `watchService`'s emitters are disposed on dispose).\n\tservice.watchService?.onDidChangeWorkingTree(repoPath => provider.cache.onWorkingTreeChanged(repoPath));\n\tservice.watchService?.onDidChangeRepository(e => provider.cache.onRepositoryChanged(e.repoPath, e.changes));\n\treturn service;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA2DA,SAAgB,oBAAoB,SAA2C;CAC9E,MAAM,UAAU,WAAW,gBAAgB,QAAQ,gBAAgB;CAEnE,MAAM,UAAU,QAAQ,kBAAkB,YAAY,QAAQ,WAAW,IAAI;CAC7E,MAAM,WAAW,IAAI,eAAe;EACnC,SAAS,QAAQ;EACR;EACT,YAAY,QAAQ;EACpB,OAAO,QAAQ;CAChB,CAAC;CAED,QAAQ,SAAS,gBAAgB,IAAI;CAQrC,QAAQ,cAAc,wBAAuB,aAAY,SAAS,MAAM,qBAAqB,QAAQ,CAAC;CACtG,QAAQ,cAAc,uBAAsB,MAAK,SAAS,MAAM,oBAAoB,EAAE,UAAU,EAAE,OAAO,CAAC;CAC1G,OAAO;AACR"}

package/dist/ipc/discovery.d.ts

@@ -1,3 +1,4 @@
+//#region ../ipc/src/discovery.d.ts
 /**
  * Directory scanned by `gk` binaries (and `@gitkraken/core-gitlens` consumers) for the
  * extension's CLI-capable IPC server discovery file. Anything written here is assumed
@@ -10,30 +11,30 @@ export declare const cliDiscoveryDir: string;
  */
 export declare const agentDiscoveryDir: string;
 export interface IpcDiscoveryData {
-    token: string;
-    address: string;
-    port: number;
-    workspacePaths: string[];
-    ideName?: string;
-    ideDisplayName?: string;
-    scheme?: string;
-    pid?: number;
-    createdAt: string;
+  token: string;
+  address: string;
+  port: number;
+  workspacePaths: string[];
+  ideName?: string;
+  ideDisplayName?: string;
+  scheme?: string;
+  pid?: number;
+  createdAt: string;
 }
 export declare function getDiscoveryFileName(port: number): string;
 /** Parses a discovery file name back into its `ppid`/`port` parts; returns `undefined` if it doesn't match. */
 export declare function parseDiscoveryFileName(name: string): {
-    ppid: number;
-    port: number;
+  ppid: number;
+  port: number;
 } | undefined;
 export declare function getDiscoveryFilePath(dir: string, port: number): string;
 export declare function writeDiscoveryFile(dir: string, data: IpcDiscoveryData): Promise<string>;
 export declare function cleanupDiscoveryFile(filePath: string | undefined): Promise<void>;
 export interface SweepDiscoveryFilesOptions {
-    /** Ports to never touch (e.g. our own live server). */
-    excludePorts?: number[];
-    /** Absolute file paths to never touch (e.g. our own files). */
-    excludePaths?: string[];
+  /** Ports to never touch (e.g. our own live server). */
+  excludePorts?: number[];
+  /** Absolute file paths to never touch (e.g. our own files). */
+  excludePaths?: string[];
 }
 /**
  * Best-effort sweep of orphaned discovery files left by processes that crashed or were
@@ -43,7 +44,8 @@ export interface SweepDiscoveryFilesOptions {
  * ambiguous (timeouts, parse errors) — is kept, so a live peer's file is never deleted.
  */
 export declare function sweepStaleDiscoveryFiles(dirs: string[], options?: SweepDiscoveryFilesOptions): Promise<{
-    scanned: number;
-    pruned: number;
+  scanned: number;
+  pruned: number;
 }>;
+//#endregion
 //# sourceMappingURL=discovery.d.ts.map

package/dist/ipc/discovery.js

@@ -1,147 +1,123 @@
-import { mkdir, readdir, readFile, unlink, writeFile } from 'fs/promises';
-import { tmpdir } from 'os';
-import { join } from 'path';
-import { kill, ppid } from 'process';
+import { join } from "path";
+import { mkdir, readFile, readdir, unlink, writeFile } from "fs/promises";
+import { tmpdir } from "os";
+import { kill, ppid } from "process";
+//#region ../ipc/src/discovery.ts
 /**
- * Directory scanned by `gk` binaries (and `@gitkraken/core-gitlens` consumers) for the
- * extension's CLI-capable IPC server discovery file. Anything written here is assumed
- * by older `gk` versions to be a CLI server — do NOT write agent-only files here.
- */
-export const cliDiscoveryDir = join(tmpdir(), 'gitkraken', 'gitlens');
+* Directory scanned by `gk` binaries (and `@gitkraken/core-gitlens` consumers) for the
+* extension's CLI-capable IPC server discovery file. Anything written here is assumed
+* by older `gk` versions to be a CLI server — do NOT write agent-only files here.
+*/
+const cliDiscoveryDir = join(tmpdir(), "gitkraken", "gitlens");
 /**
- * Directory scanned by peer GitLens windows for agent-session-capable IPC servers.
- * Stable across GitLens versions; older windows still scan it, so don't move it.
- */
-export const agentDiscoveryDir = join(tmpdir(), 'gitkraken', 'gitlens', 'agents');
-export function getDiscoveryFileName(port) {
-    return `gitlens-ipc-server-${ppid}-${port}.json`;
+* Directory scanned by peer GitLens windows for agent-session-capable IPC servers.
+* Stable across GitLens versions; older windows still scan it, so don't move it.
+*/
+const agentDiscoveryDir = join(tmpdir(), "gitkraken", "gitlens", "agents");
+function getDiscoveryFileName(port) {
+	return `gitlens-ipc-server-${ppid}-${port}.json`;
 }
 const discoveryFileNameRegex = /^gitlens-ipc-server-(\d+)-(\d+)\.json$/;
 /** Parses a discovery file name back into its `ppid`/`port` parts; returns `undefined` if it doesn't match. */
-export function parseDiscoveryFileName(name) {
-    const match = discoveryFileNameRegex.exec(name);
-    if (match == null)
-        return undefined;
-    return { ppid: Number(match[1]), port: Number(match[2]) };
+function parseDiscoveryFileName(name) {
+	const match = discoveryFileNameRegex.exec(name);
+	if (match == null) return void 0;
+	return {
+		ppid: Number(match[1]),
+		port: Number(match[2])
+	};
 }
-export function getDiscoveryFilePath(dir, port) {
-    return join(dir, getDiscoveryFileName(port));
+function getDiscoveryFilePath(dir, port) {
+	return join(dir, getDiscoveryFileName(port));
 }
-export async function writeDiscoveryFile(dir, data) {
-    const filePath = getDiscoveryFilePath(dir, data.port);
-    await mkdir(dir, { recursive: true, mode: 0o700 });
-    await writeFile(filePath, JSON.stringify(data, null, 2), { mode: 0o600 });
-    return filePath;
+async function writeDiscoveryFile(dir, data) {
+	const filePath = getDiscoveryFilePath(dir, data.port);
+	await mkdir(dir, {
+		recursive: true,
+		mode: 448
+	});
+	await writeFile(filePath, JSON.stringify(data, null, 2), { mode: 384 });
+	return filePath;
 }
-export async function cleanupDiscoveryFile(filePath) {
-    if (filePath == null)
-        return;
-    try {
-        await unlink(filePath);
-    }
-    catch {
-        // Ignore cleanup errors
-    }
+async function cleanupDiscoveryFile(filePath) {
+	if (filePath == null) return;
+	try {
+		await unlink(filePath);
+	} catch {}
 }
 /**
- * Best-effort sweep of orphaned discovery files left by processes that crashed or were
- * hard-killed without cleaning up. Reachability is the source of truth: a file is removed
- * only when its owning process is provably gone (pid reports `ESRCH`) or its server is
- * unreachable (the probe fails with anything other than a timeout). Anything reachable — or
- * ambiguous (timeouts, parse errors) — is kept, so a live peer's file is never deleted.
- */
-export async function sweepStaleDiscoveryFiles(dirs, options) {
-    const excludePorts = options?.excludePorts;
-    const excludePaths = options?.excludePaths;
-    let scanned = 0;
-    let pruned = 0;
-    for (const dir of dirs) {
-        let names;
-        try {
-            names = await readdir(dir);
-        }
-        catch {
-            // Dir doesn't exist yet (nothing ever published here) — nothing to sweep.
-            continue;
-        }
-        const candidates = [];
-        for (const name of names) {
-            const parsed = parseDiscoveryFileName(name);
-            if (parsed == null)
-                continue;
-            if (excludePorts?.includes(parsed.port))
-                continue;
-            const filePath = join(dir, name);
-            if (excludePaths?.includes(filePath))
-                continue;
-            candidates.push(filePath);
-        }
-        scanned += candidates.length;
-        const results = await Promise.allSettled(candidates.map(async (filePath) => {
-            if (await isDiscoveryFileStale(filePath)) {
-                await cleanupDiscoveryFile(filePath);
-                return true;
-            }
-            return false;
-        }));
-        for (const r of results) {
-            if (r.status === 'fulfilled' && r.value) {
-                pruned++;
-            }
-        }
-    }
-    return { scanned: scanned, pruned: pruned };
+* Best-effort sweep of orphaned discovery files left by processes that crashed or were
+* hard-killed without cleaning up. Reachability is the source of truth: a file is removed
+* only when its owning process is provably gone (pid reports `ESRCH`) or its server is
+* unreachable (the probe fails with anything other than a timeout). Anything reachable — or
+* ambiguous (timeouts, parse errors) — is kept, so a live peer's file is never deleted.
+*/
+async function sweepStaleDiscoveryFiles(dirs, options) {
+	const excludePorts = options?.excludePorts;
+	const excludePaths = options?.excludePaths;
+	let scanned = 0;
+	let pruned = 0;
+	for (const dir of dirs) {
+		let names;
+		try {
+			names = await readdir(dir);
+		} catch {
+			continue;
+		}
+		const candidates = [];
+		for (const name of names) {
+			const parsed = parseDiscoveryFileName(name);
+			if (parsed == null) continue;
+			if (excludePorts?.includes(parsed.port)) continue;
+			const filePath = join(dir, name);
+			if (excludePaths?.includes(filePath)) continue;
+			candidates.push(filePath);
+		}
+		scanned += candidates.length;
+		const results = await Promise.allSettled(candidates.map(async (filePath) => {
+			if (await isDiscoveryFileStale(filePath)) {
+				await cleanupDiscoveryFile(filePath);
+				return true;
+			}
+			return false;
+		}));
+		for (const r of results) if (r.status === "fulfilled" && r.value) pruned++;
+	}
+	return {
+		scanned,
+		pruned
+	};
 }
 /** Returns true only when the file's server is provably gone (dead pid or unreachable server). */
 async function isDiscoveryFileStale(filePath) {
-    let data;
-    try {
-        data = JSON.parse(await readFile(filePath, 'utf8'));
-    }
-    catch {
-        // Can't read/parse — don't delete files we don't understand.
-        return false;
-    }
-    // Cheap short-circuit: if the owning process is gone, the file is orphaned.
-    if (data.pid != null && !isProcessAlive(data.pid))
-        return true;
-    // Otherwise reachability is the source of truth.
-    if (!data.address)
-        return false;
-    try {
-        await fetch(`${data.address}/ping`, { signal: AbortSignal.timeout(1000) });
-        // Any HTTP response (even 401/404) means a server is listening — keep.
-        return false;
-    }
-    catch (ex) {
-        // A timeout is ambiguous — the server may be alive but slow to answer — so keep. Any other
-        // failure (connection refused, reset, host unreachable, bad address) means nothing is
-        // serving on that localhost port, so the file is stale. A healthy local server always
-        // answers near-instantly, so this never deletes a reachable peer.
-        return !isTimeoutError(ex);
-    }
+	let data;
+	try {
+		data = JSON.parse(await readFile(filePath, "utf8"));
+	} catch {
+		return false;
+	}
+	if (data.pid != null && !isProcessAlive(data.pid)) return true;
+	if (!data.address) return false;
+	try {
+		await fetch(`${data.address}/ping`, { signal: AbortSignal.timeout(1e3) });
+		return false;
+	} catch (ex) {
+		return !isTimeoutError(ex);
+	}
 }
 function isProcessAlive(pid) {
-    // `kill(0, ...)` / `kill(<negative>, ...)` have process-group semantics and don't probe a
-    // specific pid, so a malformed pid (from a foreign or corrupt file) can't prove death — treat
-    // it as inconclusive so the sweep falls through to the reachability probe rather than deleting
-    // on a bad pid. (Note: the agents session-card tracker's `isProcessAlive` biases the opposite
-    // way — toward dead — because expiring a live card there is harmless; deleting a live file is
-    // not, so this copy intentionally keeps on uncertainty.)
-    if (!Number.isInteger(pid) || pid <= 0)
-        return true;
-    try {
-        kill(pid, 0);
-        return true;
-    }
-    catch (ex) {
-        // ESRCH → no such process (dead). EPERM/EACCES → exists but not ours (alive). Anything
-        // else is inconclusive → treat as alive so we never delete a file on uncertainty.
-        return ex?.code !== 'ESRCH';
-    }
+	if (!Number.isInteger(pid) || pid <= 0) return true;
+	try {
+		kill(pid, 0);
+		return true;
+	} catch (ex) {
+		return ex?.code !== "ESRCH";
+	}
 }
 function isTimeoutError(ex) {
-    // `AbortSignal.timeout` rejects with a `TimeoutError`; a bare abort yields an `AbortError`.
-    return ex instanceof Error && (ex.name === 'TimeoutError' || ex.name === 'AbortError');
+	return ex instanceof Error && (ex.name === "TimeoutError" || ex.name === "AbortError");
 }
+//#endregion
+export { agentDiscoveryDir, cleanupDiscoveryFile, cliDiscoveryDir, getDiscoveryFileName, getDiscoveryFilePath, parseDiscoveryFileName, sweepStaleDiscoveryFiles, writeDiscoveryFile };
+
 //# sourceMappingURL=discovery.js.map

package/dist/ipc/discovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../src/ipc/discovery.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"discovery.js","names":[],"sources":["../../../ipc/src/discovery.ts"],"sourcesContent":["import { mkdir, readdir, readFile, unlink, writeFile } from 'fs/promises';\nimport { tmpdir } from 'os';\nimport { join } from 'path';\nimport { kill, ppid } from 'process';\n\n/**\n * Directory scanned by `gk` binaries (and `@gitkraken/core-gitlens` consumers) for the\n * extension's CLI-capable IPC server discovery file. Anything written here is assumed\n * by older `gk` versions to be a CLI server — do NOT write agent-only files here.\n */\nexport const cliDiscoveryDir = join(tmpdir(), 'gitkraken', 'gitlens');\n\n/**\n * Directory scanned by peer GitLens windows for agent-session-capable IPC servers.\n * Stable across GitLens versions; older windows still scan it, so don't move it.\n */\nexport const agentDiscoveryDir = join(tmpdir(), 'gitkraken', 'gitlens', 'agents');\n\nexport interface IpcDiscoveryData {\n\ttoken: string;\n\taddress: string;\n\tport: number;\n\tworkspacePaths: string[];\n\t// Optional fields — present when the writing capability needs them.\n\t// Old gk binaries ignore unknown fields, so this stays back-compat.\n\tideName?: string;\n\tideDisplayName?: string;\n\tscheme?: string;\n\tpid?: number;\n\tcreatedAt: string;\n}\n\nexport function getDiscoveryFileName(port: number): string {\n\treturn `gitlens-ipc-server-${ppid}-${port}.json`;\n}\n\nconst discoveryFileNameRegex = /^gitlens-ipc-server-(\\d+)-(\\d+)\\.json$/;\n\n/** Parses a discovery file name back into its `ppid`/`port` parts; returns `undefined` if it doesn't match. */\nexport function parseDiscoveryFileName(name: string): { ppid: number; port: number } | undefined {\n\tconst match = discoveryFileNameRegex.exec(name);\n\tif (match == null) return undefined;\n\n\treturn { ppid: Number(match[1]), port: Number(match[2]) };\n}\n\nexport function getDiscoveryFilePath(dir: string, port: number): string {\n\treturn join(dir, getDiscoveryFileName(port));\n}\n\nexport async function writeDiscoveryFile(dir: string, data: IpcDiscoveryData): Promise<string> {\n\tconst filePath = getDiscoveryFilePath(dir, data.port);\n\tawait mkdir(dir, { recursive: true, mode: 0o700 });\n\tawait writeFile(filePath, JSON.stringify(data, null, 2), { mode: 0o600 });\n\treturn filePath;\n}\n\nexport async function cleanupDiscoveryFile(filePath: string | undefined): Promise<void> {\n\tif (filePath == null) return;\n\n\ttry {\n\t\tawait unlink(filePath);\n\t} catch {\n\t\t// Ignore cleanup errors\n\t}\n}\n\nexport interface SweepDiscoveryFilesOptions {\n\t/** Ports to never touch (e.g. our own live server). */\n\texcludePorts?: number[];\n\t/** Absolute file paths to never touch (e.g. our own files). */\n\texcludePaths?: string[];\n}\n\n/**\n * Best-effort sweep of orphaned discovery files left by processes that crashed or were\n * hard-killed without cleaning up. Reachability is the source of truth: a file is removed\n * only when its owning process is provably gone (pid reports `ESRCH`) or its server is\n * unreachable (the probe fails with anything other than a timeout). Anything reachable — or\n * ambiguous (timeouts, parse errors) — is kept, so a live peer's file is never deleted.\n */\nexport async function sweepStaleDiscoveryFiles(\n\tdirs: string[],\n\toptions?: SweepDiscoveryFilesOptions,\n): Promise<{ scanned: number; pruned: number }> {\n\tconst excludePorts = options?.excludePorts;\n\tconst excludePaths = options?.excludePaths;\n\n\tlet scanned = 0;\n\tlet pruned = 0;\n\n\tfor (const dir of dirs) {\n\t\tlet names: string[];\n\t\ttry {\n\t\t\tnames = await readdir(dir);\n\t\t} catch {\n\t\t\t// Dir doesn't exist yet (nothing ever published here) — nothing to sweep.\n\t\t\tcontinue;\n\t\t}\n\n\t\tconst candidates: string[] = [];\n\t\tfor (const name of names) {\n\t\t\tconst parsed = parseDiscoveryFileName(name);\n\t\t\tif (parsed == null) continue;\n\t\t\tif (excludePorts?.includes(parsed.port)) continue;\n\n\t\t\tconst filePath = join(dir, name);\n\t\t\tif (excludePaths?.includes(filePath)) continue;\n\n\t\t\tcandidates.push(filePath);\n\t\t}\n\n\t\tscanned += candidates.length;\n\n\t\tconst results = await Promise.allSettled(\n\t\t\tcandidates.map(async filePath => {\n\t\t\t\tif (await isDiscoveryFileStale(filePath)) {\n\t\t\t\t\tawait cleanupDiscoveryFile(filePath);\n\t\t\t\t\treturn true;\n\t\t\t\t}\n\t\t\t\treturn false;\n\t\t\t}),\n\t\t);\n\n\t\tfor (const r of results) {\n\t\t\tif (r.status === 'fulfilled' && r.value) {\n\t\t\t\tpruned++;\n\t\t\t}\n\t\t}\n\t}\n\n\treturn { scanned: scanned, pruned: pruned };\n}\n\n/** Returns true only when the file's server is provably gone (dead pid or unreachable server). */\nasync function isDiscoveryFileStale(filePath: string): Promise<boolean> {\n\tlet data: IpcDiscoveryData;\n\ttry {\n\t\tdata = JSON.parse(await readFile(filePath, 'utf8')) as IpcDiscoveryData;\n\t} catch {\n\t\t// Can't read/parse — don't delete files we don't understand.\n\t\treturn false;\n\t}\n\n\t// Cheap short-circuit: if the owning process is gone, the file is orphaned.\n\tif (data.pid != null && !isProcessAlive(data.pid)) return true;\n\n\t// Otherwise reachability is the source of truth.\n\tif (!data.address) return false;\n\n\ttry {\n\t\tawait fetch(`${data.address}/ping`, { signal: AbortSignal.timeout(1000) });\n\t\t// Any HTTP response (even 401/404) means a server is listening — keep.\n\t\treturn false;\n\t} catch (ex) {\n\t\t// A timeout is ambiguous — the server may be alive but slow to answer — so keep. Any other\n\t\t// failure (connection refused, reset, host unreachable, bad address) means nothing is\n\t\t// serving on that localhost port, so the file is stale. A healthy local server always\n\t\t// answers near-instantly, so this never deletes a reachable peer.\n\t\treturn !isTimeoutError(ex);\n\t}\n}\n\nfunction isProcessAlive(pid: number): boolean {\n\t// `kill(0, ...)` / `kill(<negative>, ...)` have process-group semantics and don't probe a\n\t// specific pid, so a malformed pid (from a foreign or corrupt file) can't prove death — treat\n\t// it as inconclusive so the sweep falls through to the reachability probe rather than deleting\n\t// on a bad pid. (Note: the agents session-card tracker's `isProcessAlive` biases the opposite\n\t// way — toward dead — because expiring a live card there is harmless; deleting a live file is\n\t// not, so this copy intentionally keeps on uncertainty.)\n\tif (!Number.isInteger(pid) || pid <= 0) return true;\n\n\ttry {\n\t\tkill(pid, 0);\n\t\treturn true;\n\t} catch (ex) {\n\t\t// ESRCH → no such process (dead). EPERM/EACCES → exists but not ours (alive). Anything\n\t\t// else is inconclusive → treat as alive so we never delete a file on uncertainty.\n\t\treturn (ex as NodeJS.ErrnoException | null)?.code !== 'ESRCH';\n\t}\n}\n\nfunction isTimeoutError(ex: unknown): boolean {\n\t// `AbortSignal.timeout` rejects with a `TimeoutError`; a bare abort yields an `AbortError`.\n\treturn ex instanceof Error && (ex.name === 'TimeoutError' || ex.name === 'AbortError');\n}\n"],"mappings":";;;;;;;;;;AAUA,MAAa,kBAAkB,KAAK,OAAO,GAAG,aAAa,SAAS;;;;;AAMpE,MAAa,oBAAoB,KAAK,OAAO,GAAG,aAAa,WAAW,QAAQ;AAgBhF,SAAgB,qBAAqB,MAAsB;CAC1D,OAAO,sBAAsB,KAAK,GAAG,KAAK;AAC3C;AAEA,MAAM,yBAAyB;;AAG/B,SAAgB,uBAAuB,MAA0D;CAChG,MAAM,QAAQ,uBAAuB,KAAK,IAAI;CAC9C,IAAI,SAAS,MAAM,OAAO,KAAA;CAE1B,OAAO;EAAE,MAAM,OAAO,MAAM,EAAE;EAAG,MAAM,OAAO,MAAM,EAAE;CAAE;AACzD;AAEA,SAAgB,qBAAqB,KAAa,MAAsB;CACvE,OAAO,KAAK,KAAK,qBAAqB,IAAI,CAAC;AAC5C;AAEA,eAAsB,mBAAmB,KAAa,MAAyC;CAC9F,MAAM,WAAW,qBAAqB,KAAK,KAAK,IAAI;CACpD,MAAM,MAAM,KAAK;EAAE,WAAW;EAAM,MAAM;CAAM,CAAC;CACjD,MAAM,UAAU,UAAU,KAAK,UAAU,MAAM,MAAM,CAAC,GAAG,EAAE,MAAM,IAAM,CAAC;CACxE,OAAO;AACR;AAEA,eAAsB,qBAAqB,UAA6C;CACvF,IAAI,YAAY,MAAM;CAEtB,IAAI;EACH,MAAM,OAAO,QAAQ;CACtB,QAAQ,CAER;AACD;;;;;;;;AAgBA,eAAsB,yBACrB,MACA,SAC+C;CAC/C,MAAM,eAAe,SAAS;CAC9B,MAAM,eAAe,SAAS;CAE9B,IAAI,UAAU;CACd,IAAI,SAAS;CAEb,KAAK,MAAM,OAAO,MAAM;EACvB,IAAI;EACJ,IAAI;GACH,QAAQ,MAAM,QAAQ,GAAG;EAC1B,QAAQ;GAEP;EACD;EAEA,MAAM,aAAuB,CAAC;EAC9B,KAAK,MAAM,QAAQ,OAAO;GACzB,MAAM,SAAS,uBAAuB,IAAI;GAC1C,IAAI,UAAU,MAAM;GACpB,IAAI,cAAc,SAAS,OAAO,IAAI,GAAG;GAEzC,MAAM,WAAW,KAAK,KAAK,IAAI;GAC/B,IAAI,cAAc,SAAS,QAAQ,GAAG;GAEtC,WAAW,KAAK,QAAQ;EACzB;EAEA,WAAW,WAAW;EAEtB,MAAM,UAAU,MAAM,QAAQ,WAC7B,WAAW,IAAI,OAAM,aAAY;GAChC,IAAI,MAAM,qBAAqB,QAAQ,GAAG;IACzC,MAAM,qBAAqB,QAAQ;IACnC,OAAO;GACR;GACA,OAAO;EACR,CAAC,CACF;EAEA,KAAK,MAAM,KAAK,SACf,IAAI,EAAE,WAAW,eAAe,EAAE,OACjC;CAGH;CAEA,OAAO;EAAW;EAAiB;CAAO;AAC3C;;AAGA,eAAe,qBAAqB,UAAoC;CACvE,IAAI;CACJ,IAAI;EACH,OAAO,KAAK,MAAM,MAAM,SAAS,UAAU,MAAM,CAAC;CACnD,QAAQ;EAEP,OAAO;CACR;CAGA,IAAI,KAAK,OAAO,QAAQ,CAAC,eAAe,KAAK,GAAG,GAAG,OAAO;CAG1D,IAAI,CAAC,KAAK,SAAS,OAAO;CAE1B,IAAI;EACH,MAAM,MAAM,GAAG,KAAK,QAAQ,QAAQ,EAAE,QAAQ,YAAY,QAAQ,GAAI,EAAE,CAAC;EAEzE,OAAO;CACR,SAAS,IAAI;EAKZ,OAAO,CAAC,eAAe,EAAE;CAC1B;AACD;AAEA,SAAS,eAAe,KAAsB;CAO7C,IAAI,CAAC,OAAO,UAAU,GAAG,KAAK,OAAO,GAAG,OAAO;CAE/C,IAAI;EACH,KAAK,KAAK,CAAC;EACX,OAAO;CACR,SAAS,IAAI;EAGZ,OAAQ,IAAqC,SAAS;CACvD;AACD;AAEA,SAAS,eAAe,IAAsB;CAE7C,OAAO,cAAc,UAAU,GAAG,SAAS,kBAAkB,GAAG,SAAS;AAC1E"}

package/dist/ipc/ipcServer.d.ts

@@ -1,20 +1,22 @@
-import type { Server } from 'http';
-import type { UnifiedDisposable } from '../utils/disposable.js';
+import { UnifiedDisposable } from "../utils/disposable.js";
+import { Server } from "http";
+//#region ../ipc/src/ipcServer.d.ts
 export interface IpcHandler<Request = unknown, Response = void> {
-    (request: Request | undefined, searchParams: URLSearchParams): Promise<Response>;
+  (request: Request | undefined, searchParams: URLSearchParams): Promise<Response>;
 }
 export declare function createIpcServer<Request = unknown, Response = void>(): Promise<IpcServer<Request, Response>>;
 export declare class IpcServer<Request = unknown, Response = void> implements UnifiedDisposable {
-    readonly ipcAddress: string;
-    readonly ipcPort: number;
-    readonly ipcToken: string;
-    private server;
-    private readonly handlers;
-    constructor(ipcAddress: string, ipcPort: number, ipcToken: string, server: Server);
-    dispose(): void;
-    [Symbol.dispose](): void;
-    shutdown(): Promise<void>;
-    registerHandler(name: string, handler: IpcHandler<Request, Response>): UnifiedDisposable;
-    private onRequest;
+  readonly ipcAddress: string;
+  readonly ipcPort: number;
+  readonly ipcToken: string;
+  private server;
+  private readonly handlers;
+  constructor(ipcAddress: string, ipcPort: number, ipcToken: string, server: Server);
+  dispose(): void;
+  [Symbol.dispose](): void;
+  shutdown(): Promise<void>;
+  registerHandler(name: string, handler: IpcHandler<Request, Response>): UnifiedDisposable;
+  private onRequest;
 }
+//#endregion
 //# sourceMappingURL=ipcServer.d.ts.map