@tonycasey/lisa 2.2.0 → 2.11.5

package/dist/lib/infrastructure/github/types.d.ts

@@ -0,0 +1,145 @@
+/**
+ * GitHub API Response Types
+ *
+ * These types represent the raw responses from the GitHub API via `gh` CLI.
+ * They are transformed into domain types (IPullRequest, etc.) by the GithubClient.
+ *
+ * @see .dev/features/github-pr.md for full specification
+ */
+/**
+ * Raw PR data from `gh pr view --json`.
+ */
+export interface IGhPrResponse {
+    readonly number: number;
+    readonly title: string;
+    readonly state: 'OPEN' | 'CLOSED' | 'MERGED';
+    readonly body: string;
+    readonly headRefName: string;
+    readonly baseRefName: string;
+    readonly url: string;
+    readonly isDraft: boolean;
+    readonly mergeable: 'MERGEABLE' | 'CONFLICTING' | 'UNKNOWN';
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly closingIssuesReferences?: readonly {
+        readonly number: number;
+        readonly title: string;
+        readonly url: string;
+    }[];
+    readonly author: {
+        readonly login: string;
+    };
+    readonly headRepository: {
+        readonly nameWithOwner: string;
+    };
+}
+/**
+ * Raw check data from `gh pr checks --json`.
+ */
+export interface IGhCheckResponse {
+    readonly name: string;
+    readonly state: 'PENDING' | 'SUCCESS' | 'FAILURE' | 'SKIPPED' | 'CANCELLED' | 'QUEUED' | 'IN_PROGRESS';
+    readonly conclusion?: string;
+    readonly detailsUrl?: string;
+    readonly startedAt?: string;
+    readonly completedAt?: string;
+}
+/**
+ * Raw review data from `gh api repos/{owner}/{repo}/pulls/{pr}/reviews`.
+ */
+export interface IGhReviewResponse {
+    readonly id: number;
+    readonly user: {
+        readonly login: string;
+    };
+    readonly body: string;
+    readonly state: 'PENDING' | 'APPROVED' | 'CHANGES_REQUESTED' | 'COMMENTED' | 'DISMISSED';
+    readonly submitted_at: string;
+    readonly html_url: string;
+}
+/**
+ * Raw review comment from `gh api repos/{owner}/{repo}/pulls/{pr}/comments`.
+ */
+export interface IGhReviewCommentResponse {
+    readonly id: number;
+    readonly user: {
+        readonly login: string;
+    };
+    readonly body: string;
+    readonly path: string;
+    readonly line?: number;
+    readonly original_line?: number;
+    readonly position?: number;
+    readonly diff_hunk: string;
+    readonly created_at: string;
+    readonly updated_at: string;
+    readonly html_url: string;
+    readonly in_reply_to_id?: number;
+}
+/**
+ * Raw issue data from `gh issue view --json`.
+ */
+export interface IGhIssueResponse {
+    readonly number: number;
+    readonly title: string;
+    readonly state: 'OPEN' | 'CLOSED';
+    readonly body: string;
+    readonly url: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly labels: readonly {
+        readonly name: string;
+    }[];
+    readonly author: {
+        readonly login: string;
+    };
+}
+/**
+ * Raw user data from `gh api user`.
+ */
+export interface IGhUserResponse {
+    readonly login: string;
+    readonly id: number;
+    readonly name?: string;
+    readonly email?: string;
+}
+/**
+ * Review thread with resolution status from GraphQL API.
+ */
+export interface IGhReviewThreadResponse {
+    readonly id: string;
+    readonly isResolved: boolean;
+    readonly isOutdated: boolean;
+    readonly comments: {
+        readonly nodes: readonly {
+            readonly id: string;
+            readonly databaseId: number;
+            readonly body: string;
+            readonly author: {
+                readonly login: string;
+            } | null;
+            readonly path: string;
+            readonly line: number | null;
+        }[];
+    };
+}
+/**
+ * Error thrown when gh CLI is not installed or not authenticated.
+ */
+export declare class GithubClientError extends Error {
+    readonly code: 'NOT_INSTALLED' | 'NOT_AUTHENTICATED' | 'RATE_LIMITED' | 'NOT_FOUND' | 'API_ERROR' | 'UNKNOWN';
+    readonly originalError?: Error | undefined;
+    constructor(message: string, code: 'NOT_INSTALLED' | 'NOT_AUTHENTICATED' | 'RATE_LIMITED' | 'NOT_FOUND' | 'API_ERROR' | 'UNKNOWN', originalError?: Error | undefined);
+}
+/**
+ * Options for GithubClient methods.
+ */
+export interface IGithubClientOptions {
+    /** Maximum number of retries for transient failures */
+    readonly maxRetries?: number;
+    /** Delay between retries in milliseconds */
+    readonly retryDelayMs?: number;
+    /** Timeout for each command in milliseconds */
+    readonly timeoutMs?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/infrastructure/github/types.d.ts.map

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

package/dist/lib/infrastructure/github/types.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * GitHub API Response Types
+ *
+ * These types represent the raw responses from the GitHub API via `gh` CLI.
+ * They are transformed into domain types (IPullRequest, etc.) by the GithubClient.
+ *
+ * @see .dev/features/github-pr.md for full specification
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GithubClientError = void 0;
+/**
+ * Error thrown when gh CLI is not installed or not authenticated.
+ */
+class GithubClientError extends Error {
+    constructor(message, code, originalError) {
+        super(message);
+        this.code = code;
+        this.originalError = originalError;
+        this.name = 'GithubClientError';
+        Error.captureStackTrace?.(this, this.constructor);
+    }
+}
+exports.GithubClientError = GithubClientError;
+//# sourceMappingURL=types.js.map

package/dist/lib/infrastructure/github/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/lib/infrastructure/github/types.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AA8HH;;GAEG;AACH,MAAa,iBAAkB,SAAQ,KAAK;IAC1C,YACE,OAAe,EACC,IAAoG,EACpG,aAAqB;QAErC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAgG;QACpG,kBAAa,GAAb,aAAa,CAAQ;QAGrC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,KAAK,CAAC,iBAAiB,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC;CACF;AAVD,8CAUC"}

package/dist/lib/infrastructure/index.d.ts

@@ -14,4 +14,8 @@ export * from './services';
 export * from './di';
 export * from './dal';
 export * from './logging';
+export * from './utils';
+export * from './github';
+export * from './notifications';
+export * from './cron';
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/infrastructure/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/infrastructure/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,cAAc,WAAW,CAAC;AAG1B,cAAc,OAAO,CAAC;AAGtB,cAAc,YAAY,CAAC;AAG3B,cAAc,MAAM,CAAC;AAGrB,cAAc,OAAO,CAAC;AAGtB,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/infrastructure/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,cAAc,WAAW,CAAC;AAG1B,cAAc,OAAO,CAAC;AAGtB,cAAc,YAAY,CAAC;AAG3B,cAAc,MAAM,CAAC;AAGrB,cAAc,OAAO,CAAC;AAGtB,cAAc,WAAW,CAAC;AAG1B,cAAc,SAAS,CAAC;AAGxB,cAAc,UAAU,CAAC;AAGzB,cAAc,iBAAiB,CAAC;AAGhC,cAAc,QAAQ,CAAC"}

package/dist/lib/infrastructure/index.js

@@ -36,6 +36,14 @@ __exportStar(require("./di"), exports);
 __exportStar(require("./dal"), exports);
 // Logging infrastructure
 __exportStar(require("./logging"), exports);
+// Utilities (cancellation, etc.)
+__exportStar(require("./utils"), exports);
+// GitHub CLI wrapper
+__exportStar(require("./github"), exports);
+// Notifications
+__exportStar(require("./notifications"), exports);
+// Cron service for scheduled tasks
+__exportStar(require("./cron"), exports);
 // Note: CLI adapters (./adapters/claude/, ./adapters/opencode/)
 // are entry points, not exported from here.
 //# sourceMappingURL=index.js.map

package/dist/lib/infrastructure/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/infrastructure/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;;;;;;;;;;;;AAEH,oBAAoB;AACpB,4CAA0B;AAE1B,aAAa;AACb,wCAAsB;AAEtB,0BAA0B;AAC1B,6CAA2B;AAE3B,uBAAuB;AACvB,uCAAqB;AAErB,oDAAoD;AACpD,wCAAsB;AAEtB,yBAAyB;AACzB,4CAA0B;AAE1B,gEAAgE;AAChE,4CAA4C"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/infrastructure/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;;;;;;;;;;;;;;AAEH,oBAAoB;AACpB,4CAA0B;AAE1B,aAAa;AACb,wCAAsB;AAEtB,0BAA0B;AAC1B,6CAA2B;AAE3B,uBAAuB;AACvB,uCAAqB;AAErB,oDAAoD;AACpD,wCAAsB;AAEtB,yBAAyB;AACzB,4CAA0B;AAE1B,iCAAiC;AACjC,0CAAwB;AAExB,qBAAqB;AACrB,2CAAyB;AAEzB,gBAAgB;AAChB,kDAAgC;AAEhC,mCAAmC;AACnC,yCAAuB;AAEvB,gEAAgE;AAChE,4CAA4C"}

package/dist/lib/infrastructure/logging/Logger.d.ts

@@ -1,4 +1,4 @@
-import type { ILogger, ILoggerOptions, LogLevel } from '../../domain/interfaces';
+import type { ILogger, ILoggerOptions, LogLevel, IStructuredLog, IStructuredLogger, ILogContext, LogEvent } from '../../domain/interfaces';
 /**
  * Default logger configuration.
  */
@@ -6,14 +6,16 @@ export declare const DEFAULT_LOGGER_OPTIONS: ILoggerOptions;
 /**
  * Simple file-based logger implementation.
  * Writes single-line formatted logs with optional colorized console output.
+ * Also implements IStructuredLogger for standardized event logging.
  */
-export declare class Logger implements ILogger {
+export declare class Logger implements ILogger, IStructuredLogger {
     private readonly options;
     private readonly getCorrelationId;
     private readonly logFile;
     private readonly bindings;
+    private readonly boundContext;
     constructor(options: ILoggerOptions, _pinoInstance?: unknown, // Kept for API compatibility
-    getCorrelationId?: () => string | undefined, bindings?: Record<string, unknown>);
+    getCorrelationId?: () => string | undefined, bindings?: Record<string, unknown>, boundContext?: ILogContext);
     /**
      * Ensure log directory exists.
      */
@@ -37,12 +39,48 @@ export declare class Logger implements ILogger {
     error(message: string, context?: Record<string, unknown>): void;
     fatal(message: string, context?: Record<string, unknown>): void;
     child(bindings: Record<string, unknown>): ILogger;
+    /**
+     * Format a structured log entry into message and context.
+     *
+     * Note: log.data is flattened into the context object intentionally for better
+     * compatibility with log aggregation tools (Elasticsearch, Datadog, etc.) that
+     * prefer flat structures. Callers should avoid using keys in log.data that
+     * conflict with reserved context fields (event, sessionId, groupId, etc.).
+     */
+    private formatStructuredLog;
+    /**
+     * Log a structured event at info level.
+     */
+    logEvent(log: IStructuredLog): void;
+    /**
+     * Log a structured event at debug level.
+     */
+    logEventDebug(log: IStructuredLog): void;
+    /**
+     * Log a structured event at warn level.
+     */
+    logEventWarn(log: IStructuredLog): void;
+    /**
+     * Log a structured event at error level.
+     */
+    logEventError(log: IStructuredLog): void;
+    /**
+     * Create a child logger with bound context.
+     */
+    withContext(context: ILogContext): IStructuredLogger;
+    /**
+     * Start a timed operation and return a function to complete it.
+     */
+    startOperation(event: LogEvent | string, context?: ILogContext): (result?: {
+        data?: Record<string, unknown>;
+        error?: string;
+    }) => void;
     isLevelEnabled(level: LogLevel): boolean;
 }
 /**
  * No-op logger for testing or when logging is disabled.
  */
-export declare class NullLogger implements ILogger {
+export declare class NullLogger implements ILogger, IStructuredLogger {
     trace(_message: string, _context?: Record<string, unknown>): void;
     debug(_message: string, _context?: Record<string, unknown>): void;
     info(_message: string, _context?: Record<string, unknown>): void;
@@ -51,5 +89,14 @@ export declare class NullLogger implements ILogger {
     fatal(_message: string, _context?: Record<string, unknown>): void;
     child(_bindings: Record<string, unknown>): ILogger;
     isLevelEnabled(_level: LogLevel): boolean;
+    logEvent(_log: IStructuredLog): void;
+    logEventDebug(_log: IStructuredLog): void;
+    logEventWarn(_log: IStructuredLog): void;
+    logEventError(_log: IStructuredLog): void;
+    withContext(_context: ILogContext): IStructuredLogger;
+    startOperation(_event: LogEvent | string, _context?: ILogContext): (result?: {
+        data?: Record<string, unknown>;
+        error?: string;
+    }) => void;
 }
 //# sourceMappingURL=Logger.d.ts.map

package/dist/lib/infrastructure/logging/Logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../../../src/lib/infrastructure/logging/Logger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEjF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,cAMpC,CAAC;AA4DF;;;GAGG;AACH,qBAAa,MAAO,YAAW,OAAO;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA2B;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA0B;gBAGjD,OAAO,EAAE,cAAc,EACvB,aAAa,CAAC,EAAE,OAAO,EAAE,6BAA6B;IACtD,gBAAgB,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,EAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAYpC;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,QAAQ;IA6BhB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IASjD,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;CAGzC;AAED;;GAEG;AACH,qBAAa,UAAW,YAAW,OAAO;IACxC,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIjE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIjE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIhE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIhE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIjE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAIjE,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAIlD,cAAc,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;CAG1C"}
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../../../src/lib/infrastructure/logging/Logger.ts"],"names":[],"mappings":"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"}

package/dist/lib/infrastructure/logging/Logger.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.NullLogger = exports.Logger = exports.DEFAULT_LOGGER_OPTIONS = void 0;
 const path_1 = __importDefault(require("path"));
 const fs_1 = __importDefault(require("fs"));
+const interfaces_1 = require("../../domain/interfaces");
 /**
  * Default logger configuration.
  */
@@ -72,13 +73,15 @@ function getDateString() {
 /**
  * Simple file-based logger implementation.
  * Writes single-line formatted logs with optional colorized console output.
+ * Also implements IStructuredLogger for standardized event logging.
  */
 class Logger {
     constructor(options, _pinoInstance, // Kept for API compatibility
-    getCorrelationId, bindings) {
+    getCorrelationId, bindings, boundContext) {
         this.options = options;
         this.getCorrelationId = getCorrelationId ?? (() => undefined);
         this.bindings = bindings ?? {};
+        this.boundContext = boundContext ?? {};
         // Ensure log directory exists
         const logDir = path_1.default.resolve(options.logDir);
         this.ensureLogDir(logDir);
@@ -160,7 +163,108 @@ class Logger {
         this.writeLog('fatal', 'FATAL', message, context);
     }
     child(bindings) {
-        return new Logger(this.options, undefined, this.getCorrelationId, { ...this.bindings, ...bindings });
+        return new Logger(this.options, undefined, this.getCorrelationId, { ...this.bindings, ...bindings }, this.boundContext);
+    }
+    // ============================================================================
+    // IStructuredLogger Implementation
+    // ============================================================================
+    /**
+     * Format a structured log entry into message and context.
+     *
+     * Note: log.data is flattened into the context object intentionally for better
+     * compatibility with log aggregation tools (Elasticsearch, Datadog, etc.) that
+     * prefer flat structures. Callers should avoid using keys in log.data that
+     * conflict with reserved context fields (event, sessionId, groupId, etc.).
+     */
+    formatStructuredLog(log) {
+        const context = {
+            event: log.event,
+            ...this.boundContext,
+            ...log.context,
+        };
+        // Flatten data into context for log aggregation compatibility
+        if (log.data) {
+            Object.assign(context, log.data);
+        }
+        if (log.durationMs !== undefined) {
+            context.durationMs = log.durationMs;
+        }
+        if (log.error) {
+            context.error = log.error;
+        }
+        // Use event name as the message for consistency
+        const message = `[${log.event}]`;
+        return { message, context };
+    }
+    /**
+     * Log a structured event at info level.
+     */
+    logEvent(log) {
+        const { message, context } = this.formatStructuredLog(log);
+        this.info(message, context);
+    }
+    /**
+     * Log a structured event at debug level.
+     */
+    logEventDebug(log) {
+        const { message, context } = this.formatStructuredLog(log);
+        this.debug(message, context);
+    }
+    /**
+     * Log a structured event at warn level.
+     */
+    logEventWarn(log) {
+        const { message, context } = this.formatStructuredLog(log);
+        this.warn(message, context);
+    }
+    /**
+     * Log a structured event at error level.
+     */
+    logEventError(log) {
+        const { message, context } = this.formatStructuredLog(log);
+        this.error(message, context);
+    }
+    /**
+     * Create a child logger with bound context.
+     */
+    withContext(context) {
+        return new Logger(this.options, undefined, this.getCorrelationId, this.bindings, { ...this.boundContext, ...context });
+    }
+    /**
+     * Start a timed operation and return a function to complete it.
+     */
+    startOperation(event, context) {
+        const startTime = Date.now();
+        const mergedContext = { ...this.boundContext, ...context };
+        // Log the start event at debug level
+        this.logEventDebug({
+            event,
+            context: mergedContext,
+        });
+        // Return a function to complete the operation
+        return (result) => {
+            const durationMs = Date.now() - startTime;
+            const completeEvent = result?.error
+                ? (0, interfaces_1.deriveErrorEvent)(event)
+                : (0, interfaces_1.deriveCompleteEvent)(event);
+            if (result?.error) {
+                this.logEventError({
+                    event: completeEvent,
+                    context: mergedContext,
+                    data: result?.data,
+                    durationMs,
+                    error: result.error,
+                });
+            }
+            else {
+                this.logEvent({
+                    event: completeEvent,
+                    context: mergedContext,
+                    data: result?.data,
+                    durationMs,
+                });
+            }
+        };
     }
     isLevelEnabled(level) {
         return LEVEL_PRIORITY[level] >= LEVEL_PRIORITY[this.options.level];
@@ -195,6 +299,27 @@ class NullLogger {
     isLevelEnabled(_level) {
         return false;
     }
+    // IStructuredLogger no-op implementations
+    logEvent(_log) {
+        // No-op
+    }
+    logEventDebug(_log) {
+        // No-op
+    }
+    logEventWarn(_log) {
+        // No-op
+    }
+    logEventError(_log) {
+        // No-op
+    }
+    withContext(_context) {
+        return this;
+    }
+    startOperation(_event, _context) {
+        return () => {
+            // No-op
+        };
+    }
 }
 exports.NullLogger = NullLogger;
 //# sourceMappingURL=Logger.js.map

package/dist/lib/infrastructure/logging/Logger.js.map

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

package/dist/lib/infrastructure/mcp/McpClient.d.ts

@@ -2,11 +2,21 @@ import type { IMcpClient } from '../../domain/interfaces';
 /**
  * MCP Client implementation.
  * Communicates with Graphiti MCP server or Zep Cloud.
+ *
+ * Session Management:
+ * This client manages MCP sessions internally. It:
+ * - Automatically initializes a session on first call
+ * - Updates session ID when server returns a new one in response headers
+ * - Re-initializes session if a request fails with 401/403 (expired session)
+ * - Thread-safe for concurrent requests (all share the same session)
+ *
+ * Callers should NOT track session IDs manually - the client handles this.
  */
 export declare class McpClient implements IMcpClient {
     private readonly endpoint;
     private readonly apiKey?;
     private sessionId;
+    private initializePromise;
     constructor(endpoint: string, apiKey?: string | undefined);
     /**
      * Get headers for MCP requests.
@@ -18,12 +28,37 @@ export declare class McpClient implements IMcpClient {
     private extractEventStreamData;
     /**
      * Initialize the MCP session.
+     * Uses a promise cache to prevent concurrent initialization requests.
      */
     initialize(timeoutMs?: number): Promise<string>;
+    /**
+     * Internal initialization logic.
+     */
+    private doInitialize;
+    /**
+     * Force re-initialization of the session.
+     * Called when a request fails with session-related errors.
+     */
+    private reinitialize;
     /**
      * Make an RPC call to the MCP server.
+     *
+     * Session management is handled internally:
+     * - Session is initialized automatically on first call
+     * - Session ID from response headers updates the internal state
+     * - On 401/403, session is re-initialized and request retried once
+     *
+     * @param method - Method name
+     * @param params - Method parameters
+     * @param _sessionId - DEPRECATED: Ignored. Session managed internally.
+     * @param timeoutMs - Timeout in milliseconds
+     */
+    call<T = unknown>(method: string, params?: Record<string, unknown>, _sessionId?: string | null, // Ignored - session managed internally
+    timeoutMs?: number): Promise<[T, string]>;
+    /**
+     * Internal call implementation with retry logic for session expiry.
      */
-    call<T = unknown>(method: string, params?: Record<string, unknown>, sessionId?: string | null, timeoutMs?: number): Promise<[T, string]>;
+    private doCall;
     /**
      * Check if the MCP server is reachable.
      */

package/dist/lib/infrastructure/mcp/McpClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"McpClient.d.ts","sourceRoot":"","sources":["../../../../src/lib/infrastructure/mcp/McpClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AA8B1D;;;GAGG;AACH,qBAAa,SAAU,YAAW,UAAU;IAIxC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAJ1B,OAAO,CAAC,SAAS,CAAuB;gBAGrB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,YAAA;IAGlC;;OAEG;IACH,OAAO,CAAC,UAAU;IAclB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;OAEG;IACG,UAAU,CAAC,SAAS,GAAE,MAA2B,GAAG,OAAO,CAAC,MAAM,CAAC;IA4BzE;;OAEG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACpC,SAAS,GAAE,MAAM,GAAG,IAAW,EAC/B,SAAS,GAAE,MAA2B,GACrC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAsDvB;;OAEG;IACG,IAAI,CAAC,SAAS,GAAE,MAA2B,GAAG,OAAO,CAAC,OAAO,CAAC;IASpE;;OAEG;IACH,YAAY,IAAI,MAAM,GAAG,IAAI;CAG9B"}
+{"version":3,"file":"McpClient.d.ts","sourceRoot":"","sources":["../../../../src/lib/infrastructure/mcp/McpClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AA8B1D;;;;;;;;;;;;GAYG;AACH,qBAAa,SAAU,YAAW,UAAU;IAKxC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAL1B,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,iBAAiB,CAAgC;gBAGtC,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,YAAA;IAGlC;;OAEG;IACH,OAAO,CAAC,UAAU;IAclB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;;OAGG;IACG,UAAU,CAAC,SAAS,GAAE,MAA2B,GAAG,OAAO,CAAC,MAAM,CAAC;IAsBzE;;OAEG;YACW,YAAY;IA4B1B;;;OAGG;YACW,YAAY;IAM1B;;;;;;;;;;;;OAYG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACpC,UAAU,GAAE,MAAM,GAAG,IAAW,EAAE,uCAAuC;IACzE,SAAS,GAAE,MAA2B,GACrC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAIvB;;OAEG;YACW,MAAM;IAmEpB;;OAEG;IACG,IAAI,CAAC,SAAS,GAAE,MAA2B,GAAG,OAAO,CAAC,OAAO,CAAC;IASpE;;OAEG;IACH,YAAY,IAAI,MAAM,GAAG,IAAI;CAG9B"}