@google/gemini-cli-core 0.0.1

package/dist/src/routing/strategies/defaultStrategy.js

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DEFAULT_GEMINI_MODEL } from '../../config/models.js';
+export class DefaultStrategy {
+    name = 'default';
+    async route(_context, _config, _baseLlmClient) {
+        return {
+            model: DEFAULT_GEMINI_MODEL,
+            metadata: {
+                source: this.name,
+                latencyMs: 0,
+                reasoning: `Routing to default model: ${DEFAULT_GEMINI_MODEL}`,
+            },
+        };
+    }
+}
+//# sourceMappingURL=defaultStrategy.js.map

package/dist/src/routing/strategies/defaultStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultStrategy.js","sourceRoot":"","sources":["../../../../src/routing/strategies/defaultStrategy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,MAAM,OAAO,eAAe;IACjB,IAAI,GAAG,SAAS,CAAC;IAE1B,KAAK,CAAC,KAAK,CACT,QAAwB,EACxB,OAAe,EACf,cAA6B;QAE7B,OAAO;YACL,KAAK,EAAE,oBAAoB;YAC3B,QAAQ,EAAE;gBACR,MAAM,EAAE,IAAI,CAAC,IAAI;gBACjB,SAAS,EAAE,CAAC;gBACZ,SAAS,EAAE,6BAA6B,oBAAoB,EAAE;aAC/D;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/src/routing/strategies/defaultStrategy.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/routing/strategies/defaultStrategy.test.js

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { DefaultStrategy } from './defaultStrategy.js';
+import { DEFAULT_GEMINI_MODEL } from '../../config/models.js';
+describe('DefaultStrategy', () => {
+    it('should always route to the default Gemini model', async () => {
+        const strategy = new DefaultStrategy();
+        const mockContext = {};
+        const mockConfig = {};
+        const mockClient = {};
+        const decision = await strategy.route(mockContext, mockConfig, mockClient);
+        expect(decision).toEqual({
+            model: DEFAULT_GEMINI_MODEL,
+            metadata: {
+                source: 'default',
+                latencyMs: 0,
+                reasoning: `Routing to default model: ${DEFAULT_GEMINI_MODEL}`,
+            },
+        });
+    });
+});
+//# sourceMappingURL=defaultStrategy.test.js.map

package/dist/src/routing/strategies/defaultStrategy.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaultStrategy.test.js","sourceRoot":"","sources":["../../../../src/routing/strategies/defaultStrategy.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAG9D,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;QACvC,MAAM,WAAW,GAAG,EAAoB,CAAC;QACzC,MAAM,UAAU,GAAG,EAAY,CAAC;QAChC,MAAM,UAAU,GAAG,EAAmB,CAAC;QAEvC,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QAE3E,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YACvB,KAAK,EAAE,oBAAoB;YAC3B,QAAQ,EAAE;gBACR,MAAM,EAAE,SAAS;gBACjB,SAAS,EAAE,CAAC;gBACZ,SAAS,EAAE,6BAA6B,oBAAoB,EAAE;aAC/D;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/routing/strategies/fallbackStrategy.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../../config/config.js';
+import type { BaseLlmClient } from '../../core/baseLlmClient.js';
+import type { RoutingContext, RoutingDecision, RoutingStrategy } from '../routingStrategy.js';
+export declare class FallbackStrategy implements RoutingStrategy {
+    readonly name = "fallback";
+    route(_context: RoutingContext, config: Config, _baseLlmClient: BaseLlmClient): Promise<RoutingDecision | null>;
+}

package/dist/src/routing/strategies/fallbackStrategy.js

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { getEffectiveModel } from '../../config/models.js';
+export class FallbackStrategy {
+    name = 'fallback';
+    async route(_context, config, _baseLlmClient) {
+        const isInFallbackMode = config.isInFallbackMode();
+        if (!isInFallbackMode) {
+            return null;
+        }
+        const effectiveModel = getEffectiveModel(isInFallbackMode, config.getModel());
+        return {
+            model: effectiveModel,
+            metadata: {
+                source: this.name,
+                latencyMs: 0,
+                reasoning: `In fallback mode. Using: ${effectiveModel}`,
+            },
+        };
+    }
+}
+//# sourceMappingURL=fallbackStrategy.js.map

package/dist/src/routing/strategies/fallbackStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallbackStrategy.js","sourceRoot":"","sources":["../../../../src/routing/strategies/fallbackStrategy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAQ3D,MAAM,OAAO,gBAAgB;IAClB,IAAI,GAAG,UAAU,CAAC;IAE3B,KAAK,CAAC,KAAK,CACT,QAAwB,EACxB,MAAc,EACd,cAA6B;QAE7B,MAAM,gBAAgB,GAAY,MAAM,CAAC,gBAAgB,EAAE,CAAC;QAE5D,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,cAAc,GAAG,iBAAiB,CACtC,gBAAgB,EAChB,MAAM,CAAC,QAAQ,EAAE,CAClB,CAAC;QACF,OAAO;YACL,KAAK,EAAE,cAAc;YACrB,QAAQ,EAAE;gBACR,MAAM,EAAE,IAAI,CAAC,IAAI;gBACjB,SAAS,EAAE,CAAC;gBACZ,SAAS,EAAE,4BAA4B,cAAc,EAAE;aACxD;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/src/routing/strategies/fallbackStrategy.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/routing/strategies/fallbackStrategy.test.js

@@ -0,0 +1,55 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { FallbackStrategy } from './fallbackStrategy.js';
+import { DEFAULT_GEMINI_MODEL, DEFAULT_GEMINI_FLASH_MODEL, DEFAULT_GEMINI_FLASH_LITE_MODEL, } from '../../config/models.js';
+describe('FallbackStrategy', () => {
+    const strategy = new FallbackStrategy();
+    const mockContext = {};
+    const mockClient = {};
+    it('should return null when not in fallback mode', async () => {
+        const mockConfig = {
+            isInFallbackMode: () => false,
+            getModel: () => DEFAULT_GEMINI_MODEL,
+        };
+        const decision = await strategy.route(mockContext, mockConfig, mockClient);
+        expect(decision).toBeNull();
+    });
+    describe('when in fallback mode', () => {
+        it('should downgrade a pro model to the flash model', async () => {
+            const mockConfig = {
+                isInFallbackMode: () => true,
+                getModel: () => DEFAULT_GEMINI_MODEL,
+            };
+            const decision = await strategy.route(mockContext, mockConfig, mockClient);
+            expect(decision).not.toBeNull();
+            expect(decision?.model).toBe(DEFAULT_GEMINI_FLASH_MODEL);
+            expect(decision?.metadata.source).toBe('fallback');
+            expect(decision?.metadata.reasoning).toContain('In fallback mode');
+        });
+        it('should honor a lite model request', async () => {
+            const mockConfig = {
+                isInFallbackMode: () => true,
+                getModel: () => DEFAULT_GEMINI_FLASH_LITE_MODEL,
+            };
+            const decision = await strategy.route(mockContext, mockConfig, mockClient);
+            expect(decision).not.toBeNull();
+            expect(decision?.model).toBe(DEFAULT_GEMINI_FLASH_LITE_MODEL);
+            expect(decision?.metadata.source).toBe('fallback');
+        });
+        it('should use the flash model if flash is requested', async () => {
+            const mockConfig = {
+                isInFallbackMode: () => true,
+                getModel: () => DEFAULT_GEMINI_FLASH_MODEL,
+            };
+            const decision = await strategy.route(mockContext, mockConfig, mockClient);
+            expect(decision).not.toBeNull();
+            expect(decision?.model).toBe(DEFAULT_GEMINI_FLASH_MODEL);
+            expect(decision?.metadata.source).toBe('fallback');
+        });
+    });
+});
+//# sourceMappingURL=fallbackStrategy.test.js.map

package/dist/src/routing/strategies/fallbackStrategy.test.js.map

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

package/dist/src/routing/strategies/overrideStrategy.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Config } from '../../config/config.js';
+import type { BaseLlmClient } from '../../core/baseLlmClient.js';
+import type { RoutingContext, RoutingDecision, RoutingStrategy } from '../routingStrategy.js';
+/**
+ * Handles cases where the user explicitly specifies a model (override).
+ */
+export declare class OverrideStrategy implements RoutingStrategy {
+    readonly name = "override";
+    route(_context: RoutingContext, config: Config, _baseLlmClient: BaseLlmClient): Promise<RoutingDecision | null>;
+}

package/dist/src/routing/strategies/overrideStrategy.js

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DEFAULT_GEMINI_MODEL_AUTO } from '../../config/models.js';
+/**
+ * Handles cases where the user explicitly specifies a model (override).
+ */
+export class OverrideStrategy {
+    name = 'override';
+    async route(_context, config, _baseLlmClient) {
+        const overrideModel = config.getModel();
+        // If the model is 'auto' we should pass to the next strategy.
+        if (overrideModel === DEFAULT_GEMINI_MODEL_AUTO)
+            return null;
+        // Return the overridden model name.
+        return {
+            model: overrideModel,
+            metadata: {
+                source: this.name,
+                latencyMs: 0,
+                reasoning: `Routing bypassed by forced model directive. Using: ${overrideModel}`,
+            },
+        };
+    }
+}
+//# sourceMappingURL=overrideStrategy.js.map

package/dist/src/routing/strategies/overrideStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrideStrategy.js","sourceRoot":"","sources":["../../../../src/routing/strategies/overrideStrategy.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAQnE;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAClB,IAAI,GAAG,UAAU,CAAC;IAE3B,KAAK,CAAC,KAAK,CACT,QAAwB,EACxB,MAAc,EACd,cAA6B;QAE7B,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QAExC,8DAA8D;QAC9D,IAAI,aAAa,KAAK,yBAAyB;YAAE,OAAO,IAAI,CAAC;QAE7D,oCAAoC;QACpC,OAAO;YACL,KAAK,EAAE,aAAa;YACpB,QAAQ,EAAE;gBACR,MAAM,EAAE,IAAI,CAAC,IAAI;gBACjB,SAAS,EAAE,CAAC;gBACZ,SAAS,EAAE,sDAAsD,aAAa,EAAE;aACjF;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/src/routing/strategies/overrideStrategy.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};

package/dist/src/routing/strategies/overrideStrategy.test.js

@@ -0,0 +1,42 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { describe, it, expect } from 'vitest';
+import { OverrideStrategy } from './overrideStrategy.js';
+import { DEFAULT_GEMINI_MODEL_AUTO } from '../../config/models.js';
+describe('OverrideStrategy', () => {
+    const strategy = new OverrideStrategy();
+    const mockContext = {};
+    const mockClient = {};
+    it('should return null when the override model is auto', async () => {
+        const mockConfig = {
+            getModel: () => DEFAULT_GEMINI_MODEL_AUTO,
+        };
+        const decision = await strategy.route(mockContext, mockConfig, mockClient);
+        expect(decision).toBeNull();
+    });
+    it('should return a decision with the override model when one is specified', async () => {
+        const overrideModel = 'gemini-2.5-pro-custom';
+        const mockConfig = {
+            getModel: () => overrideModel,
+        };
+        const decision = await strategy.route(mockContext, mockConfig, mockClient);
+        expect(decision).not.toBeNull();
+        expect(decision?.model).toBe(overrideModel);
+        expect(decision?.metadata.source).toBe('override');
+        expect(decision?.metadata.reasoning).toContain('Routing bypassed by forced model directive');
+        expect(decision?.metadata.reasoning).toContain(overrideModel);
+    });
+    it('should handle different override model names', async () => {
+        const overrideModel = 'gemini-2.5-flash-experimental';
+        const mockConfig = {
+            getModel: () => overrideModel,
+        };
+        const decision = await strategy.route(mockContext, mockConfig, mockClient);
+        expect(decision).not.toBeNull();
+        expect(decision?.model).toBe(overrideModel);
+    });
+});
+//# sourceMappingURL=overrideStrategy.test.js.map

package/dist/src/routing/strategies/overrideStrategy.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrideStrategy.test.js","sourceRoot":"","sources":["../../../../src/routing/strategies/overrideStrategy.test.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAIzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AAEnE,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,MAAM,QAAQ,GAAG,IAAI,gBAAgB,EAAE,CAAC;IACxC,MAAM,WAAW,GAAG,EAAoB,CAAC;IACzC,MAAM,UAAU,GAAG,EAAmB,CAAC;IAEvC,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,UAAU,GAAG;YACjB,QAAQ,EAAE,GAAG,EAAE,CAAC,yBAAyB;SAChC,CAAC;QAEZ,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QAC3E,MAAM,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,KAAK,IAAI,EAAE;QACtF,MAAM,aAAa,GAAG,uBAAuB,CAAC;QAC9C,MAAM,UAAU,GAAG;YACjB,QAAQ,EAAE,GAAG,EAAE,CAAC,aAAa;SACpB,CAAC;QAEZ,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QAE3E,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAChC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC5C,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACnD,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,SAAS,CAC5C,4CAA4C,CAC7C,CAAC;QACF,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;QAC5D,MAAM,aAAa,GAAG,+BAA+B,CAAC;QACtD,MAAM,UAAU,GAAG;YACjB,QAAQ,EAAE,GAAG,EAAE,CAAC,aAAa;SACpB,CAAC;QAEZ,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QAE3E,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAChC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/services/chatRecordingService.d.ts

@@ -0,0 +1,144 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { type Config } from '../config/config.js';
+import { type Status } from '../core/coreToolScheduler.js';
+import { type ThoughtSummary } from '../core/turn.js';
+import type { PartListUnion, GenerateContentResponseUsageMetadata } from '@google/genai';
+/**
+ * Token usage summary for a message or conversation.
+ */
+export interface TokensSummary {
+    input: number;
+    output: number;
+    cached: number;
+    thoughts?: number;
+    tool?: number;
+    total: number;
+}
+/**
+ * Base fields common to all messages.
+ */
+export interface BaseMessageRecord {
+    id: string;
+    timestamp: string;
+    content: PartListUnion;
+}
+/**
+ * Record of a tool call execution within a conversation.
+ */
+export interface ToolCallRecord {
+    id: string;
+    name: string;
+    args: Record<string, unknown>;
+    result?: PartListUnion | null;
+    status: Status;
+    timestamp: string;
+    displayName?: string;
+    description?: string;
+    resultDisplay?: string;
+    renderOutputAsMarkdown?: boolean;
+}
+/**
+ * Message type and message type-specific fields.
+ */
+export type ConversationRecordExtra = {
+    type: 'user';
+} | {
+    type: 'gemini';
+    toolCalls?: ToolCallRecord[];
+    thoughts?: Array<ThoughtSummary & {
+        timestamp: string;
+    }>;
+    tokens?: TokensSummary | null;
+    model?: string;
+};
+/**
+ * A single message record in a conversation.
+ */
+export type MessageRecord = BaseMessageRecord & ConversationRecordExtra;
+/**
+ * Complete conversation record stored in session files.
+ */
+export interface ConversationRecord {
+    sessionId: string;
+    projectHash: string;
+    startTime: string;
+    lastUpdated: string;
+    messages: MessageRecord[];
+}
+/**
+ * Data structure for resuming an existing session.
+ */
+export interface ResumedSessionData {
+    conversation: ConversationRecord;
+    filePath: string;
+}
+/**
+ * Service for automatically recording chat conversations to disk.
+ *
+ * This service provides comprehensive conversation recording that captures:
+ * - All user and assistant messages
+ * - Tool calls and their execution results
+ * - Token usage statistics
+ * - Assistant thoughts and reasoning
+ *
+ * Sessions are stored as JSON files in ~/.gemini/tmp/<project_hash>/chats/
+ */
+export declare class ChatRecordingService {
+    private conversationFile;
+    private cachedLastConvData;
+    private sessionId;
+    private projectHash;
+    private queuedThoughts;
+    private queuedTokens;
+    private config;
+    constructor(config: Config);
+    /**
+     * Initializes the chat recording service: creates a new conversation file and associates it with
+     * this service instance, or resumes from an existing session if resumedSessionData is provided.
+     */
+    initialize(resumedSessionData?: ResumedSessionData): void;
+    private getLastMessage;
+    private newMessage;
+    /**
+     * Records a message in the conversation.
+     */
+    recordMessage(message: {
+        model: string;
+        type: ConversationRecordExtra['type'];
+        content: PartListUnion;
+    }): void;
+    /**
+     * Records a thought from the assistant's reasoning process.
+     */
+    recordThought(thought: ThoughtSummary): void;
+    /**
+     * Updates the tokens for the last message in the conversation (which should be by Gemini).
+     */
+    recordMessageTokens(respUsageMetadata: GenerateContentResponseUsageMetadata): void;
+    /**
+     * Adds tool calls to the last message in the conversation (which should be by Gemini).
+     * This method enriches tool calls with metadata from the ToolRegistry.
+     */
+    recordToolCalls(model: string, toolCalls: ToolCallRecord[]): void;
+    /**
+     * Loads up the conversation record from disk.
+     */
+    private readConversation;
+    /**
+     * Saves the conversation record; overwrites the file.
+     */
+    private writeConversation;
+    /**
+     * Convenient helper for updating the conversation without file reading and writing and time
+     * updating boilerplate.
+     */
+    private updateConversation;
+    /**
+     * Deletes a session file by session ID.
+     */
+    deleteSession(sessionId: string): void;
+}