@gitkraken/core-gitlens 0.2.0 → 0.3.1

package/dist/ipc/ipcServer.js

@@ -0,0 +1,162 @@
+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) {
+            // eslint-disable-next-line @typescript-eslint/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();
+            }
+        });
+    }
+}
+__decorate([
+    debug({ args: false })
+], IpcServer.prototype, "onRequest", null);
+//# sourceMappingURL=ipcServer.js.map

package/dist/ipc/ipcServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ipcServer.js","sourceRoot":"","sources":["../../src/ipc/ipcServer.ts"],"names":[],"mappings":"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"}

package/dist/plus/agents/providers/claudeCodeProvider.d.ts

@@ -0,0 +1,167 @@
+import type { AgentProviderCallbacks, AgentSession, AgentSessionProvider, PermissionDecision, PermissionSuggestion } from '../types.js';
+import { ClaudeCodeTranscriptReader } from './claudeCodeTranscript.js';
+export declare class ClaudeCodeProvider implements AgentSessionProvider {
+    private readonly callbacks;
+    readonly id = "claudeCode";
+    readonly name = "Claude Code";
+    readonly icon = "robot";
+    private readonly _onDidChangeSessions;
+    readonly onDidChangeSessions: import("../../../utils/event.js").Event<void>;
+    private _sessions;
+    private _ipcStarted;
+    private _disposed;
+    private _handlerDisposables;
+    private readonly _pendingPermissions;
+    private readonly _resolveGitInfoInFlight;
+    private readonly _sessionBookkeeping;
+    /** Per-session timers for the deferred `Stop → idle` commit. The handle is cleared (and the
+     *  transition cancelled) by any non-idle status update arriving before the timer fires. */
+    private readonly _pendingIdleTimers;
+    private _workspacePaths;
+    private _staleCheckTimer;
+    /** Whether Claude hooks are installed, pushed by the host via {@link setClaudeHooksInstalled}.
+     *  Fail-open (`true`) until the first push lands so a fresh window with real hooks isn't
+     *  suppressed on its first ticks. Gates the reconciliation poll in {@link syncSessions}. */
+    private _claudeHooksInstalled;
+    protected _transcriptReader: ClaudeCodeTranscriptReader;
+    constructor(callbacks: AgentProviderCallbacks);
+    get sessions(): readonly AgentSession[];
+    start(workspacePaths: string[]): void;
+    stop(): void;
+    updateWorkspacePaths(workspacePaths: string[]): void;
+    setClaudeHooksInstalled(installed: boolean): void;
+    dispose(): void;
+    [Symbol.dispose](): void;
+    private ensureIpcServer;
+    private handleSessionEvent;
+    private sessionTag;
+    private getBookkeeping;
+    /** Returns the active decay window in milliseconds — the cooldown between PostToolUse and
+     *  dropping the path from the bookkeeping. Reads through the host callback every time so a
+     *  setting change takes effect on the next Pre/Post pair without re-wiring (existing timers
+     *  keep their original timeout — acceptable since they're short-lived relative to the setting). */
+    private get activityDecayMs();
+    /** Locates the *parent* session id that owns the given session id — returns the id itself when
+     *  it matches a top-level session, otherwise the `id` of the parent that holds it under
+     *  `subagents[]`. Returns `undefined` when neither match (session no longer exists). Used to
+     *  route per-session bookkeeping changes to the right top-level `syncSessionFileActivity` call.
+     *  Tool events are parent-keyed (the CLI sends a sub-agent's tool events under the parent id),
+     *  so the `subagents[]` branch is a defensive fallback for any other-keyed caller. */
+    private findOwningParentId;
+    private resetBookkeeping;
+    /** Turn-end settle (Stop): the agent finished its turn, so nothing is "live" anymore — but
+     *  the per-operation decay tail must survive. Heat fades over {@link activityDecayMs} measured
+     *  from when each *tool* finished (the PostToolUse cooldown), NOT from when the turn ends, so a
+     *  Stop must not cancel those cooldowns or clear `lastTouchedAt`. We only reset turn-scoped
+     *  state and force-finish any path whose PostToolUse never arrived before Stop: drop its
+     *  refcount to 0 (flipping `editing`/`reading` off so the pulse stops) and schedule the same
+     *  decay eviction a normal completion would. Contrast {@link resetBookkeeping}, which hard-
+     *  wipes everything for SessionStart/SessionEnd (the agent is gone, not merely between turns). */
+    private settleBookkeeping;
+    private cancelPendingFileClears;
+    private cancelPendingReadClears;
+    /** Extracts the targeted file path from a PreToolUse/PostToolUse event. Tries the raw
+     *  `hookInput.tool_input` passthrough first, falls back to the projected `event.toolInput`
+     *  for older CLI versions that only fill the top-level fields. Treats an empty-object
+     *  `hookInput.tool_input` as missing — `??` would have kept it (truthy) and shadowed a
+     *  populated `event.toolInput`. */
+    private getEventFilePath;
+    /** Stamps the per-path/per-kind `lastTouchedAt[kind]` to the current epoch ms. Stamped on every
+     *  PreToolUse for the matching kind so `serializeFileActivity` can emit `readAt`/`editedAt` as
+     *  a relative `now - timestamp` delta. */
+    private stampLastTouched;
+    /** Drops the `lastTouchedAt[kind]` slot for `filePath`, and the whole entry when neither kind
+     *  remains. Mirrors the cooldown-timer eviction in `scheduleClear*` — once the path is gone
+     *  from the count map for that kind, its timestamp is no longer load-bearing. */
+    private clearLastTouched;
+    /** Records that a file-mutating tool call is in flight against `filePath` so consumers can
+     *  highlight the path. Refcounts per path — keyed by path (not `tool_use_id`, which the GK CLI
+     *  doesn't reliably surface) so parallel calls bump the count and Post/Pre order doesn't matter.
+     *  Returns whether the parent's published `fileActivity` actually changed so callers can fire
+     *  when the surrounding {@link updateSessionStatus} short-circuits. */
+    private trackToolUseFile;
+    /** Decrements the in-flight refcount for a finished tool call's file. While the count stays
+     *  above zero (overlapping parallel calls) the path remains marked. When the count drops to
+     *  zero, leaves the entry in place at count `0` and schedules a {@link activityDecayMs}
+     *  cooldown before actually dropping it — so a recently-edited file lingers as a decay tail
+     *  on the treemap. A Pre arriving during cooldown cancels the timer and bumps the count back
+     *  above zero. Returns whether the parent's published `fileActivity` changed (i.e. `editing`
+     *  flipped off) so the PostToolUse caller can fire when its `updateSessionStatus` short-
+     *  circuits (a parallel tool still in flight keeps activeToolCount > 0). */
+    private scheduleClearToolUseFile;
+    /** Schedules (replacing any prior timer) the {@link activityDecayMs} cooldown that finally
+     *  drops `filePath` from the edit bookkeeping once it has fully decayed. Shared by the
+     *  PostToolUse cooldown path and the Stop settle ({@link settleBookkeeping}); the path stays
+     *  in `currentFileCounts` at count 0 meanwhile so its `editedAt` keeps aging on the client. */
+    private scheduleFileDecayEviction;
+    /** Drops a tracked tool call's file immediately (no cooldown). Used for PermissionDenied,
+     *  where the tool never ran — keeping the "live" badge would be misleading.
+     *  Returns whether the published list changed. */
+    private untrackToolUseFile;
+    /** Mirror of {@link getEventFilePath} for read-only file tools. */
+    private getEventReadPath;
+    /** Refcount mirror of {@link trackToolUseFile} for read-only file tools. */
+    private trackToolUseRead;
+    /** Cooldown mirror of {@link scheduleClearToolUseFile} for read-only file tools. Returns
+     *  whether the parent's published `fileActivity` changed (i.e. `reading` flipped off). */
+    private scheduleClearToolUseRead;
+    /** Read-class mirror of {@link scheduleFileDecayEviction}. */
+    private scheduleReadDecayEviction;
+    /** Immediate-drop mirror of {@link untrackToolUseFile} for read-only file tools. */
+    private untrackToolUseRead;
+    /** Convenience wrapper that resolves the parent for a possibly-sub-agent session id, then calls
+     *  {@link syncSessionFileActivity}. Tool-call handlers call this without knowing whether the
+     *  session is a top-level or sub-agent session. Returns `false` when the session isn't found
+     *  (already pruned / unknown peer id). */
+    private syncSessionFileActivityForChild;
+    /** Rebuilds the parent session's `fileActivity` array from its bookkeeping and writes it onto
+     *  the session in place. Returns whether the *structural* shape changed (paths/kinds/flags) —
+     *  timestamps are always refreshed regardless, but a fire is gated on structural change so
+     *  non-meaningful drift doesn't churn the wire.
+     *
+     *  No separate sub-agent rollup is needed: the GK CLI keys a sub-agent's tool events under its
+     *  PARENT session id (with `agentId` set), so they accumulate in the parent's own bookkeeping
+     *  directly and are already reflected here. Sub-agent serialized objects carry no `fileActivity`. */
+    private syncSessionFileActivity;
+    /** Defer the `Stop → idle` commit. If the agent produces a non-idle event within
+     *  `stopToIdleDebounceMs`, `cancelPendingIdleTransition` (called from `updateSessionStatus`)
+     *  cancels this and the session stays in its prior phase — no working → idle → working flicker.
+     *
+     *  Intentionally takes no context: the caller is expected to apply any event metadata
+     *  synchronously before scheduling. Carrying Stop-time context into the timer would let
+     *  in-window metadata mutations (e.g. `CwdChanged` updating `_sessions[i].cwd` directly)
+     *  get reverted when the deferred commit replays the stale context through `ensureSession`. */
+    private scheduleIdleTransition;
+    private cancelPendingIdleTransition;
+    /** Stable phase-since: if we're oscillating back into the phase we were just in (within a
+     *  short window), restore its original timestamp so the displayed elapsed time doesn't snap
+     *  to 0. Otherwise records the current phase as the new "prior" and returns `now`. */
+    private resolvePhaseSince;
+    private clearStalePermission;
+    resolvePermission(sessionId: string, decision: PermissionDecision, updatedPermissions?: PermissionSuggestion[]): boolean;
+    private matchesWorkspace;
+    private resolveWorkspacePath;
+    private updateSessionWithPermission;
+    private updateSessionStatus;
+    private ensureSession;
+    private resolveGitInfo;
+    private resolveTranscriptTitles;
+    private pruneDeadSessions;
+    protected syncSessions(options?: {
+        gate?: boolean;
+    }): Promise<void>;
+    private querySiblingWindowSessions;
+    private fetchPeerSessions;
+    /** Find the peer GitLens window whose discovery file claims `workspacePath`, and POST to its
+     *  `/agents/sessions/open` route to ask its Claude Code extension to open the session.
+     *
+     *  Resolves to `true` when at least one peer claimed the workspace AND was reachable (the POST
+     *  completed with any HTTP status). The peer's response shape (`{ opened: boolean }`) is logged
+     *  for diagnostics but does NOT affect the return value — an `opened: false` peer is still the
+     *  right window for the caller to focus, since it's the window that owns the session. Resolves
+     *  to `false` when no peer claimed the workspace OR every claimer was unreachable; the caller
+     *  treats that as "no peer to focus" and opens a new window instead of replacing the current
+     *  one. Best-effort: swallows scan, JSON-parse errors. */
+    notifyPeerOpenSession(workspacePath: string, sessionId: string): Promise<boolean>;
+}
+//# sourceMappingURL=claudeCodeProvider.d.ts.map

package/dist/plus/agents/providers/claudeCodeProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claudeCodeProvider.d.ts","sourceRoot":"","sources":["../../src/providers/claudeCodeProvider.ts"],"names":[],"mappings":"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"}