@gitkraken/core-gitlens 0.6.0 → 0.7.0

package/dist/ipc/ipcServer.js

@@ -1,162 +1,141 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-import { createServer } from 'http';
-import { uuid } from '../utils/crypto.js';
-import { debug } from '../utils/decorators/log.js';
-import { createDisposable } from '../utils/disposable.js';
-import { Logger } from '../utils/logger.js';
-import { getScopedLogger } from '../utils/logger.scoped.js';
-export async function createIpcServer() {
-    const server = createServer();
-    const token = uuid();
-    return new Promise((resolve, reject) => {
-        try {
-            server.on('error', ex => {
-                Logger.error(ex, 'IPC server error');
-                reject(ex);
-            });
-            // Let the OS assign an available port by listening on port 0
-            server.listen(0, '127.0.0.1', () => {
-                const address = server.address();
-                if (address == null || typeof address === 'string') {
-                    reject(new Error('Failed to get server address'));
-                    return;
-                }
-                const port = address.port;
-                const serverUrl = `http://127.0.0.1:${port}`;
-                resolve(new IpcServer(serverUrl, port, token, server));
-            });
-        }
-        catch (ex) {
-            // oxlint-disable-next-line typescript/prefer-promise-reject-errors
-            reject(ex);
-        }
-    });
-}
-export class IpcServer {
-    ipcAddress;
-    ipcPort;
-    ipcToken;
-    server;
-    handlers = new Map();
-    constructor(ipcAddress, ipcPort, ipcToken, server) {
-        this.ipcAddress = ipcAddress;
-        this.ipcPort = ipcPort;
-        this.ipcToken = ipcToken;
-        this.server = server;
-        server
-            .on('listening', () => {
-            Logger.trace(`IPC server listening on ${this.ipcAddress}`);
-        })
-            .on('request', this.onRequest.bind(this));
-    }
-    dispose() {
-        this.handlers.clear();
-        this.server.close();
-    }
-    [Symbol.dispose]() {
-        this.dispose();
-    }
-    // Awaits server close; use only when deterministic teardown is required (e.g., tests).
-    // Production callers should use dispose() — UnifiedDisposable contract is sync.
-    shutdown() {
-        this.handlers.clear();
-        return new Promise(resolve => {
-            this.server.close(() => resolve());
-        });
-    }
-    registerHandler(name, handler) {
-        const path = `/${name}`;
-        if (this.handlers.has(path)) {
-            throw new Error(`IPC handler '${name}' is already registered`);
-        }
-        this.handlers.set(path, handler);
-        return createDisposable(() => this.handlers.delete(path));
-    }
-    onRequest(req, res) {
-        const scope = getScopedLogger();
-        // Parse URL to extract pathname for routing and query parameters
-        let pathname;
-        let searchParams = new URLSearchParams();
-        try {
-            const url = new URL(req.url ?? '', this.ipcAddress);
-            pathname = url.pathname;
-            searchParams = url.searchParams;
-        }
-        catch {
-            pathname = req.url;
-        }
-        const handler = this.handlers.get(pathname);
-        if (handler == null) {
-            scope?.warn(`IPC handler for ${pathname} not found`);
-            res.writeHead(404);
-            res.end();
-            return;
-        }
-        // Add bearer token authorization
-        const authHeader = req.headers['authorization'];
-        if (authHeader !== `Bearer ${this.ipcToken}`) {
-            Logger.warn(scope, `IPC handler for ${req.url} unauthorized`);
-            res.writeHead(401);
-            res.end();
-            return;
-        }
-        const maxBodySize = 10_485_760; // 10 MB
-        let bodySize = 0;
-        const chunks = [];
-        req.on('data', (d) => {
-            bodySize += d.length;
-            if (bodySize > maxBodySize) {
-                res.writeHead(413);
-                res.end();
-                req.destroy();
-                return;
-            }
-            chunks.push(d);
-        });
-        req.on('end', async () => {
-            if (bodySize > maxBodySize)
-                return;
-            const body = Buffer.concat(chunks).toString('utf8');
-            let data;
-            try {
-                data = body ? JSON.parse(body) : undefined;
-            }
-            catch (ex) {
-                scope?.error(ex, 'Invalid JSON in IPC request body', { body: body });
-                res.writeHead(400);
-                res.end('Invalid JSON');
-                return;
-            }
-            try {
-                const result = await handler(data, searchParams);
-                if (result == null) {
-                    res.writeHead(200);
-                    res.end();
-                    return;
-                }
-                if (typeof result === 'string') {
-                    res.writeHead(200);
-                    res.end(result);
-                }
-                else {
-                    res.writeHead(200);
-                    res.end(JSON.stringify(result));
-                }
-            }
-            catch (ex) {
-                scope?.error(ex, 'IPC handler error', data);
-                res.writeHead(500);
-                res.end();
-            }
-        });
-    }
+import { Logger as _logger } from "../utils/logger.js";
+import { getScopedLogger } from "../utils/logger.scoped.js";
+import { debug } from "../utils/decorators/log.js";
+import __decorate from "../_virtual/@oxc-project+runtime/helpers/esm/decorate.js";
+import { createDisposable } from "../utils/disposable.js";
+import { uuid } from "../utils/crypto.js";
+import { createServer } from "http";
+//#region ../ipc/src/ipcServer.ts
+async function createIpcServer() {
+	const server = createServer();
+	const token = uuid();
+	return new Promise((resolve, reject) => {
+		try {
+			server.on("error", (ex) => {
+				_logger.error(ex, "IPC server error");
+				reject(ex);
+			});
+			server.listen(0, "127.0.0.1", () => {
+				const address = server.address();
+				if (address == null || typeof address === "string") {
+					reject(/* @__PURE__ */ new Error("Failed to get server address"));
+					return;
+				}
+				const port = address.port;
+				resolve(new IpcServer(`http://127.0.0.1:${port}`, port, token, server));
+			});
+		} catch (ex) {
+			reject(ex);
+		}
+	});
 }
-__decorate([
-    debug({ args: false })
-], IpcServer.prototype, "onRequest", null);
+var IpcServer = class {
+	ipcAddress;
+	ipcPort;
+	ipcToken;
+	server;
+	handlers = /* @__PURE__ */ new Map();
+	constructor(ipcAddress, ipcPort, ipcToken, server) {
+		this.ipcAddress = ipcAddress;
+		this.ipcPort = ipcPort;
+		this.ipcToken = ipcToken;
+		this.server = server;
+		server.on("listening", () => {
+			_logger.trace(`IPC server listening on ${this.ipcAddress}`);
+		}).on("request", this.onRequest.bind(this));
+	}
+	dispose() {
+		this.handlers.clear();
+		this.server.close();
+	}
+	[Symbol.dispose]() {
+		this.dispose();
+	}
+	shutdown() {
+		this.handlers.clear();
+		return new Promise((resolve) => {
+			this.server.close(() => resolve());
+		});
+	}
+	registerHandler(name, handler) {
+		const path = `/${name}`;
+		if (this.handlers.has(path)) throw new Error(`IPC handler '${name}' is already registered`);
+		this.handlers.set(path, handler);
+		return createDisposable(() => this.handlers.delete(path));
+	}
+	onRequest(req, res) {
+		const scope = getScopedLogger();
+		let pathname;
+		let searchParams = new URLSearchParams();
+		try {
+			const url = new URL(req.url ?? "", this.ipcAddress);
+			pathname = url.pathname;
+			searchParams = url.searchParams;
+		} catch {
+			pathname = req.url;
+		}
+		const handler = this.handlers.get(pathname);
+		if (handler == null) {
+			scope?.warn(`IPC handler for ${pathname} not found`);
+			res.writeHead(404);
+			res.end();
+			return;
+		}
+		if (req.headers["authorization"] !== `Bearer ${this.ipcToken}`) {
+			_logger.warn(scope, `IPC handler for ${req.url} unauthorized`);
+			res.writeHead(401);
+			res.end();
+			return;
+		}
+		const maxBodySize = 10485760;
+		let bodySize = 0;
+		const chunks = [];
+		req.on("data", (d) => {
+			bodySize += d.length;
+			if (bodySize > maxBodySize) {
+				res.writeHead(413);
+				res.end();
+				req.destroy();
+				return;
+			}
+			chunks.push(d);
+		});
+		req.on("end", async () => {
+			if (bodySize > maxBodySize) return;
+			const body = Buffer.concat(chunks).toString("utf8");
+			let data;
+			try {
+				data = body ? JSON.parse(body) : void 0;
+			} catch (ex) {
+				scope?.error(ex, "Invalid JSON in IPC request body", { body });
+				res.writeHead(400);
+				res.end("Invalid JSON");
+				return;
+			}
+			try {
+				const result = await handler(data, searchParams);
+				if (result == null) {
+					res.writeHead(200);
+					res.end();
+					return;
+				}
+				if (typeof result === "string") {
+					res.writeHead(200);
+					res.end(result);
+				} else {
+					res.writeHead(200);
+					res.end(JSON.stringify(result));
+				}
+			} catch (ex) {
+				scope?.error(ex, "IPC handler error", data);
+				res.writeHead(500);
+				res.end();
+			}
+		});
+	}
+};
+__decorate([debug({ args: false })], IpcServer.prototype, "onRequest", null);
+//#endregion
+export { IpcServer, createIpcServer };
+
 //# sourceMappingURL=ipcServer.js.map

package/dist/ipc/ipcServer.js.map

@@ -1 +1 @@
-{"version":3,"file":"ipcServer.js","sourceRoot":"","sources":["../../src/ipc/ipcServer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ipcServer.js","names":[],"sources":["../../../ipc/src/ipcServer.ts"],"sourcesContent":["import type { IncomingMessage, Server, ServerResponse } from 'http';\nimport { createServer } from 'http';\nimport { uuid } from '@gitlens/utils/crypto.js';\nimport { debug } from '@gitlens/utils/decorators/log.js';\nimport type { UnifiedDisposable } from '@gitlens/utils/disposable.js';\nimport { createDisposable } from '@gitlens/utils/disposable.js';\nimport { Logger } from '@gitlens/utils/logger.js';\nimport { getScopedLogger } from '@gitlens/utils/logger.scoped.js';\n\nexport interface IpcHandler<Request = unknown, Response = void> {\n\t(request: Request | undefined, searchParams: URLSearchParams): Promise<Response>;\n}\n\nexport async function createIpcServer<Request = unknown, Response = void>(): Promise<IpcServer<Request, Response>> {\n\tconst server = createServer();\n\tconst token = uuid();\n\n\treturn new Promise<IpcServer<Request, Response>>((resolve, reject) => {\n\t\ttry {\n\t\t\tserver.on('error', ex => {\n\t\t\t\tLogger.error(ex, 'IPC server error');\n\t\t\t\treject(ex);\n\t\t\t});\n\n\t\t\t// Let the OS assign an available port by listening on port 0\n\t\t\tserver.listen(0, '127.0.0.1', () => {\n\t\t\t\tconst address = server.address();\n\t\t\t\tif (address == null || typeof address === 'string') {\n\t\t\t\t\treject(new Error('Failed to get server address'));\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tconst port = address.port;\n\t\t\t\tconst serverUrl = `http://127.0.0.1:${port}`;\n\t\t\t\tresolve(new IpcServer(serverUrl, port, token, server));\n\t\t\t});\n\t\t} catch (ex) {\n\t\t\t// oxlint-disable-next-line typescript/prefer-promise-reject-errors\n\t\t\treject(ex);\n\t\t}\n\t});\n}\n\nexport class IpcServer<Request = unknown, Response = void> implements UnifiedDisposable {\n\tprivate readonly handlers = new Map<string | undefined, IpcHandler<Request, Response>>();\n\n\tconstructor(\n\t\treadonly ipcAddress: string,\n\t\treadonly ipcPort: number,\n\t\treadonly ipcToken: string,\n\t\tprivate server: Server,\n\t) {\n\t\tserver\n\t\t\t.on('listening', () => {\n\t\t\t\tLogger.trace(`IPC server listening on ${this.ipcAddress}`);\n\t\t\t})\n\t\t\t.on('request', this.onRequest.bind(this));\n\t}\n\n\tdispose(): void {\n\t\tthis.handlers.clear();\n\t\tthis.server.close();\n\t}\n\n\t[Symbol.dispose](): void {\n\t\tthis.dispose();\n\t}\n\n\t// Awaits server close; use only when deterministic teardown is required (e.g., tests).\n\t// Production callers should use dispose() — UnifiedDisposable contract is sync.\n\tshutdown(): Promise<void> {\n\t\tthis.handlers.clear();\n\t\treturn new Promise<void>(resolve => {\n\t\t\tthis.server.close(() => resolve());\n\t\t});\n\t}\n\n\tregisterHandler(name: string, handler: IpcHandler<Request, Response>): UnifiedDisposable {\n\t\tconst path = `/${name}`;\n\t\tif (this.handlers.has(path)) {\n\t\t\tthrow new Error(`IPC handler '${name}' is already registered`);\n\t\t}\n\n\t\tthis.handlers.set(path, handler);\n\t\treturn createDisposable(() => this.handlers.delete(path));\n\t}\n\n\t@debug({ args: false })\n\tprivate onRequest(req: IncomingMessage, res: ServerResponse): void {\n\t\tconst scope = getScopedLogger();\n\n\t\t// Parse URL to extract pathname for routing and query parameters\n\t\tlet pathname: string | undefined;\n\t\tlet searchParams = new URLSearchParams();\n\t\ttry {\n\t\t\tconst url = new URL(req.url ?? '', this.ipcAddress);\n\t\t\tpathname = url.pathname;\n\t\t\tsearchParams = url.searchParams;\n\t\t} catch {\n\t\t\tpathname = req.url;\n\t\t}\n\n\t\tconst handler = this.handlers.get(pathname);\n\t\tif (handler == null) {\n\t\t\tscope?.warn(`IPC handler for ${pathname} not found`);\n\t\t\tres.writeHead(404);\n\t\t\tres.end();\n\t\t\treturn;\n\t\t}\n\n\t\t// Add bearer token authorization\n\t\tconst authHeader = req.headers['authorization'];\n\t\tif (authHeader !== `Bearer ${this.ipcToken}`) {\n\t\t\tLogger.warn(scope, `IPC handler for ${req.url} unauthorized`);\n\t\t\tres.writeHead(401);\n\t\t\tres.end();\n\t\t\treturn;\n\t\t}\n\n\t\tconst maxBodySize = 10_485_760; // 10 MB\n\t\tlet bodySize = 0;\n\t\tconst chunks: Uint8Array[] = [];\n\t\treq.on('data', (d: Uint8Array) => {\n\t\t\tbodySize += d.length;\n\t\t\tif (bodySize > maxBodySize) {\n\t\t\t\tres.writeHead(413);\n\t\t\t\tres.end();\n\t\t\t\treq.destroy();\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tchunks.push(d);\n\t\t});\n\t\treq.on('end', async () => {\n\t\t\tif (bodySize > maxBodySize) return;\n\n\t\t\tconst body = Buffer.concat(chunks).toString('utf8');\n\n\t\t\tlet data: Request | undefined;\n\t\t\ttry {\n\t\t\t\tdata = body ? (JSON.parse(body) as Request) : undefined;\n\t\t\t} catch (ex) {\n\t\t\t\tscope?.error(ex, 'Invalid JSON in IPC request body', { body: body });\n\t\t\t\tres.writeHead(400);\n\t\t\t\tres.end('Invalid JSON');\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\ttry {\n\t\t\t\tconst result = await handler(data, searchParams);\n\t\t\t\tif (result == null) {\n\t\t\t\t\tres.writeHead(200);\n\t\t\t\t\tres.end();\n\t\t\t\t\treturn;\n\t\t\t\t}\n\n\t\t\t\tif (typeof result === 'string') {\n\t\t\t\t\tres.writeHead(200);\n\t\t\t\t\tres.end(result);\n\t\t\t\t} else {\n\t\t\t\t\tres.writeHead(200);\n\t\t\t\t\tres.end(JSON.stringify(result));\n\t\t\t\t}\n\t\t\t} catch (ex) {\n\t\t\t\tscope?.error(ex, 'IPC handler error', data);\n\t\t\t\tres.writeHead(500);\n\t\t\t\tres.end();\n\t\t\t}\n\t\t});\n\t}\n}\n"],"mappings":"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"}

package/dist/plus/agents/agentCapabilities.d.ts

@@ -1,4 +1,5 @@
-import type { AgentHookEvent } from './types.js';
+import { AgentHookEvent } from "./types.js";
+//#region ../plus/agents/src/agentCapabilities.d.ts
 /** `gk ai hook` client id — the id the GitKraken CLI stamps onto every relayed hook event. NOT
  *  the same namespace as {@link AgentProviderId}. */
 export type AgentHookClientId = 'claude-code' | 'codex' | 'copilot' | 'opencode';
@@ -11,6 +12,15 @@ export type AgentProviderId = 'claudeCode' | 'codex' | 'copilot' | 'opencode';
  *  font, built from SVGs in `images/icons/`. An agent with no mark of its own uses `robot` — a name
  *  with no glyph renders as tofu, it does not fall back. */
 export type AgentIconName = 'claude' | 'openai' | 'copilot' | 'gitlens-provider-opencode' | 'robot';
+/** How to reach an agent from a terminal, and which arguments reattach it to a past session. */
+export interface AgentCliCapabilities {
+  /** The agent's name in `gk agents list`, where the detected executable path comes from. */
+  readonly agentName: string;
+  /** Bare command to run when gkcli reports no usable executable. */
+  readonly command: string;
+  /** Arguments that reattach the agent to a past session by id. */
+  readonly resumeArgs: (sessionId: string) => readonly string[];
+}
 /**
  * Flat, data-only description of one supported `gk ai hook` client. Mirrors how the GitKraken CLI
  * models its own clients (`internal/actions/aihook/events.json` + `registry.go`) so the two stay
@@ -18,42 +28,44 @@ export type AgentIconName = 'claude' | 'openai' | 'copilot' | 'gitlens-provider-
  * what translates them into the canonical (Claude Code) vocabulary.
  */
 export interface AgentCapabilities {
-    /** The `gk ai hook` client id events arrive stamped with. */
-    readonly hookClientId: AgentHookClientId;
-    /** The GitLens session provider id — see {@link AgentProviderId}. */
-    readonly providerId: AgentProviderId;
-    readonly displayName: string;
-    readonly icon: AgentIconName;
-    /** Native event name → canonical event. Omitted when the agent's native names are already
-     *  canonical. */
-    readonly eventMap?: Readonly<Record<string, AgentHookEvent>>;
-    /** Escape hatch for the cases where the native event name alone can't determine the canonical
-     *  event and the payload has to be consulted. Tried BEFORE {@link eventMap}; returning
-     *  `undefined` falls through to it. `hookInput` is the ROOT of the JSON the agent piped to
-     *  `gk ai hook run` (what the CLI relays verbatim as `hookInput`), not a pre-unwrapped payload —
-     *  navigate the agent's own nesting from there. */
-    readonly resolveEvent?: (nativeEvent: string, hookInput: Record<string, unknown> | undefined) => AgentHookEvent | undefined;
-    /** Native tool name → canonical (Claude Code) tool name. Omitted when already canonical. */
-    readonly toolNameMap?: Readonly<Record<string, string>>;
-    /** Native event names to register as non-blocking hooks at install time. `undefined` means
-     *  "pass no event flags and let `gk` apply its own per-client defaults". */
-    readonly installEvents?: readonly string[];
-    /** Native event names to register as blocking hooks at install time. `undefined` means
-     *  "pass no event flags and let `gk` apply its own per-client defaults". */
-    readonly installBlockingEvents?: readonly string[];
-    /** The agent can be installed with blocking hooks, so GitLens can answer a permission ask. */
-    readonly supportsBlockingPermissions: boolean;
-    /** The agent writes an on-disk transcript GitLens can tail for titles/prompts. */
-    readonly supportsTranscripts: boolean;
-    /** A past session can be resumed from its cwd. */
-    readonly supportsResume: boolean;
-    /** The agent multiplexes concurrent sessions in one process, so a pid does not identify a
-     *  session (matches the CLI's `pidSharingClients`). */
-    readonly sharesPids: boolean;
-    /** Extra step the agent's own host requires before installed hooks will actually fire. Undefined
-     *  when installing is sufficient. Not a computed state — we cannot detect whether the step has been
-     *  done, so consumers surface this unconditionally whenever hooks are installed. */
-    readonly manualActivation?: string;
+  /** The `gk ai hook` client id events arrive stamped with. */
+  readonly hookClientId: AgentHookClientId;
+  /** The GitLens session provider id — see {@link AgentProviderId}. */
+  readonly providerId: AgentProviderId;
+  readonly displayName: string;
+  readonly icon: AgentIconName;
+  /** Native event name → canonical event. Omitted when the agent's native names are already
+   *  canonical. */
+  readonly eventMap?: Readonly<Record<string, AgentHookEvent>>;
+  /** Escape hatch for the cases where the native event name alone can't determine the canonical
+   *  event and the payload has to be consulted. Tried BEFORE {@link eventMap}; returning
+   *  `undefined` falls through to it. `hookInput` is the ROOT of the JSON the agent piped to
+   *  `gk ai hook run` (what the CLI relays verbatim as `hookInput`), not a pre-unwrapped payload —
+   *  navigate the agent's own nesting from there. */
+  readonly resolveEvent?: (nativeEvent: string, hookInput: Record<string, unknown> | undefined) => AgentHookEvent | undefined;
+  /** Native tool name → canonical (Claude Code) tool name. Omitted when already canonical. */
+  readonly toolNameMap?: Readonly<Record<string, string>>;
+  /** Native event names to register as non-blocking hooks at install time. `undefined` means
+   *  "pass no event flags and let `gk` apply its own per-client defaults". */
+  readonly installEvents?: readonly string[];
+  /** Native event names to register as blocking hooks at install time. `undefined` means
+   *  "pass no event flags and let `gk` apply its own per-client defaults". */
+  readonly installBlockingEvents?: readonly string[];
+  /** The agent can be installed with blocking hooks, so GitLens can answer a permission ask. */
+  readonly supportsBlockingPermissions: boolean;
+  /** The agent writes an on-disk transcript GitLens can tail for titles/prompts. */
+  readonly supportsTranscripts: boolean;
+  /** A past session can be resumed from its cwd via {@link cli}. */
+  readonly supportsResume: boolean;
+  /** The agent multiplexes concurrent sessions in one process, so a pid does not identify a
+   *  session (matches the CLI's `pidSharingClients`). */
+  readonly sharesPids: boolean;
+  /** How to reach the agent from a terminal. Omitted when GitLens cannot launch the agent itself. */
+  readonly cli?: AgentCliCapabilities;
+  /** Extra step the agent's own host requires before installed hooks will actually fire. Undefined
+   *  when installing is sufficient. Not a computed state — we cannot detect whether the step has been
+   *  done, so consumers surface this unconditionally whenever hooks are installed. */
+  readonly manualActivation?: string;
 }
 /** Exported because Claude Code is the wire default: an event with no `providerId` comes from a CLI
  *  too old to stamp one, which predates every other client. */
@@ -74,4 +86,5 @@ export declare function resolveCanonicalHookEvent(capabilities: AgentCapabilitie
 /** Translates an agent's native tool name into the canonical (Claude Code) tool name, falling back
  *  to the input unchanged when the agent has no alias for it. */
 export declare function resolveCanonicalToolName(capabilities: AgentCapabilities, nativeToolName: string): string;
+//#endregion
 //# sourceMappingURL=agentCapabilities.d.ts.map