@theia/ai-core 1.46.0-next.241

package/src/browser/theia-variable-contribution.ts

@@ -0,0 +1,58 @@
+// *****************************************************************************
+// Copyright (C) 2024 EclipseSource GmbH.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+import { FrontendApplicationStateService } from '@theia/core/lib/browser/frontend-application-state';
+import { inject, injectable } from '@theia/core/shared/inversify';
+import { VariableRegistry, VariableResolverService } from '@theia/variable-resolver/lib/browser';
+import { AIVariableContribution, AIVariableResolver, AIVariableService, AIVariableResolutionRequest, AIVariableContext, ResolvedAIVariable } from '../common';
+
+@injectable()
+export class TheiaVariableContribution implements AIVariableContribution, AIVariableResolver {
+    @inject(VariableResolverService)
+    protected readonly variableResolverService: VariableResolverService;
+
+    @inject(VariableRegistry)
+    protected readonly variableRegistry: VariableRegistry;
+
+    @inject(FrontendApplicationStateService)
+    protected readonly stateService: FrontendApplicationStateService;
+
+    registerVariables(service: AIVariableService): void {
+        this.stateService.reachedState('initialized_layout').then(() => {
+            // some variable contributions in Theia are done as part of the onStart, same as our AI variable contributions
+            // we therefore wait for all of them to be registered before we register we map them to our own
+            this.variableRegistry.getVariables().forEach(variable => {
+                service.registerResolver({ id: `theia-${variable.name}`, name: variable.name, description: variable.description ?? 'Theia Built-in Variable' }, this);
+            });
+        });
+    }
+
+    protected toTheiaVariable(request: AIVariableResolutionRequest): string {
+        return `$\{${request.variable.name}${request.arg ? ':' + request.arg : ''}}`;
+    }
+
+    async canResolve(request: AIVariableResolutionRequest, context: AIVariableContext): Promise<number> {
+        // some variables are not resolvable without providing a specific context
+        // this may be expensive but was not a problem for Theia's built-in variables
+        const resolved = await this.variableResolverService.resolve(this.toTheiaVariable(request), context);
+        return !resolved ? 0 : 1;
+    }
+
+    async resolve(request: AIVariableResolutionRequest, context: AIVariableContext): Promise<ResolvedAIVariable | undefined> {
+        const resolved = await this.variableResolverService.resolve(this.toTheiaVariable(request), context);
+        return resolved ? { value: resolved, variable: request.variable } : undefined;
+    }
+}
+

package/src/common/agent-service.ts

@@ -0,0 +1,137 @@
+// *****************************************************************************
+// Copyright (C) 2024 EclipseSource GmbH.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+import { inject, injectable, optional, postConstruct } from '@theia/core/shared/inversify';
+import { Emitter, Event } from '@theia/core';
+import { Agent } from './agent';
+import { AISettingsService } from './settings-service';
+import { PromptService } from './prompt-service';
+
+export const AgentService = Symbol('AgentService');
+
+/**
+ * Service to access the list of known Agents.
+ */
+export interface AgentService {
+    /**
+     * Retrieves a list of all available agents, i.e. agents which are not disabled
+     */
+    getAgents(): Agent[];
+    /**
+     * Retrieves a list of all agents, including disabled ones.
+     */
+    getAllAgents(): Agent[];
+    /**
+     * Enable the agent with the specified id.
+     * @param agentId the agent id.
+     */
+    enableAgent(agentId: string): void;
+    /**
+     * disable the agent with the specified id.
+     * @param agentId the agent id.
+     */
+    disableAgent(agentId: string): void;
+    /**
+     * query whether this agent is currently enabled or disabled.
+     * @param agentId the agent id.
+     * @return true if the agent is enabled, false otherwise.
+     */
+    isEnabled(agentId: string): boolean;
+
+    /**
+     * Allows to register an agent programmatically.
+     * @param agent the agent to register
+     */
+    registerAgent(agent: Agent): void;
+
+    /**
+     * Allows to unregister an agent programmatically.
+     * @param agentId the agent id to unregister
+     */
+    unregisterAgent(agentId: string): void;
+
+    /**
+     * Emitted when the list of agents changes.
+     * This can be used to update the UI when agents are added or removed.
+     */
+    onDidChangeAgents: Event<void>;
+}
+
+@injectable()
+export class AgentServiceImpl implements AgentService {
+
+    @inject(AISettingsService) @optional()
+    protected readonly aiSettingsService: AISettingsService | undefined;
+
+    @inject(PromptService)
+    protected readonly promptService: PromptService;
+
+    protected disabledAgents = new Set<string>();
+
+    protected _agents: Agent[] = [];
+
+    private readonly onDidChangeAgentsEmitter = new Emitter<void>();
+    readonly onDidChangeAgents = this.onDidChangeAgentsEmitter.event;
+
+    @postConstruct()
+    protected init(): void {
+        this.aiSettingsService?.getSettings().then(settings => {
+            Object.entries(settings).forEach(([agentId, agentSettings]) => {
+                if (agentSettings.enable === false) {
+                    this.disabledAgents.add(agentId);
+                }
+            });
+        });
+    }
+
+    registerAgent(agent: Agent): void {
+        this._agents.push(agent);
+        agent.promptTemplates.forEach(
+            template => this.promptService.storePromptTemplate(template)
+        );
+        this.onDidChangeAgentsEmitter.fire();
+    }
+
+    unregisterAgent(agentId: string): void {
+        const agent = this._agents.find(a => a.id === agentId);
+        this._agents = this._agents.filter(a => a.id !== agentId);
+        this.onDidChangeAgentsEmitter.fire();
+        agent?.promptTemplates.forEach(
+            template => this.promptService.removePrompt(template.id)
+        );
+    }
+
+    getAgents(): Agent[] {
+        return this._agents.filter(agent => this.isEnabled(agent.id));
+    }
+
+    getAllAgents(): Agent[] {
+        return this._agents;
+    }
+
+    enableAgent(agentId: string): void {
+        this.disabledAgents.delete(agentId);
+        this.aiSettingsService?.updateAgentSettings(agentId, { enable: true });
+    }
+
+    disableAgent(agentId: string): void {
+        this.disabledAgents.add(agentId);
+        this.aiSettingsService?.updateAgentSettings(agentId, { enable: false });
+    }
+
+    isEnabled(agentId: string): boolean {
+        return !this.disabledAgents.has(agentId);
+    }
+}

package/src/common/agent.ts

@@ -0,0 +1,70 @@
+// *****************************************************************************
+// Copyright (C) 2024 EclipseSource GmbH.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+
+import { LanguageModelRequirement } from './language-model';
+import { PromptTemplate } from './prompt-service';
+
+export interface AgentSpecificVariables {
+    name: string;
+    description: string;
+    usedInPrompt: boolean;
+}
+
+export const Agent = Symbol('Agent');
+/**
+ * Agents represent the main functionality of the AI system. They are responsible for processing user input, collecting information from the environment,
+ * invoking and processing LLM responses, and providing the final response to the user while recording their actions in the AI history.
+ *
+ * Agents are meant to cover all use cases, from specialized scenarios to general purpose chat bots.
+ *
+ * Agents are encouraged to provide a detailed description of their functionality and their processed inputs.
+ * They can also declare their used prompt templates, which makes them configurable for the user.
+ */
+export interface Agent {
+    /**
+     * Used to identify an agent, e.g. when it is requesting language models, etc.
+     *
+     * @note This parameter might be removed in favor of `name`. Therefore, it is recommended to set `id` to the same value as `name` for now.
+     */
+    readonly id: string;
+
+    /**
+     * Human-readable name shown to users to identify the agent. Must be unique.
+     * Use short names without "Agent" or "Chat" (see `tags` for adding further properties).
+     */
+    readonly name: string;
+
+    /** A markdown description of its functionality and its privacy-relevant requirements, including function call handlers that access some data autonomously. */
+    readonly description: string;
+
+    /** The list of global variable identifiers this agent needs to clarify its context requirements. See #39. */
+    readonly variables: string[];
+
+    /** The prompt templates introduced and used by this agent. */
+    readonly promptTemplates: PromptTemplate[];
+
+    /** Required language models. This includes the purpose and optional language model selector arguments. See #47. */
+    readonly languageModelRequirements: LanguageModelRequirement[];
+
+    /** A list of tags to filter agents and to display capabilities in the UI */
+    readonly tags?: string[];
+
+    /** The list of local variable identifiers this agent needs to clarify its context requirements. */
+    readonly agentSpecificVariables: AgentSpecificVariables[];
+
+    /** The list of global function identifiers this agent needs to clarify its context requirements. */
+    readonly functions: string[];
+}

package/src/common/agents-variable-contribution.ts

@@ -0,0 +1,64 @@
+// *****************************************************************************
+// Copyright (C) 2024 EclipseSource GmbH.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+import { inject, injectable } from '@theia/core/shared/inversify';
+import { AIVariable, AIVariableContext, AIVariableContribution, AIVariableResolutionRequest, AIVariableResolver, AIVariableService, ResolvedAIVariable } from './variable-service';
+import { MaybePromise } from '@theia/core';
+import { AgentService } from './agent-service';
+
+export const AGENTS_VARIABLE: AIVariable = {
+    id: 'agents',
+    name: 'agents',
+    description: 'Returns the list of agents available in the system'
+};
+
+export interface ResolvedAgentsVariable extends ResolvedAIVariable {
+    agents: AgentDescriptor[];
+}
+
+export interface AgentDescriptor {
+    id: string;
+    name: string;
+    description: string;
+}
+
+@injectable()
+export class AgentsVariableContribution implements AIVariableContribution, AIVariableResolver {
+
+    @inject(AgentService)
+    protected readonly agentService: AgentService;
+
+    registerVariables(service: AIVariableService): void {
+        service.registerResolver(AGENTS_VARIABLE, this);
+    }
+
+    canResolve(request: AIVariableResolutionRequest, _context: AIVariableContext): MaybePromise<number> {
+        if (request.variable.name === AGENTS_VARIABLE.name) {
+            return 1;
+        }
+        return -1;
+    }
+
+    async resolve(request: AIVariableResolutionRequest, context: AIVariableContext): Promise<ResolvedAgentsVariable | undefined> {
+        if (request.variable.name === AGENTS_VARIABLE.name) {
+            const agents = this.agentService.getAgents().map(agent => ({
+                id: agent.id,
+                name: agent.name,
+                description: agent.description
+            }));
+            return { variable: AGENTS_VARIABLE, agents, value: JSON.stringify(agents) };
+        }
+    }
+}

package/src/common/communication-recording-service.ts

@@ -0,0 +1,53 @@
+// *****************************************************************************
+// Copyright (C) 2024 EclipseSource GmbH.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+
+import { Event } from '@theia/core';
+
+export type CommunicationHistory = CommunicationHistoryEntry[];
+
+export interface CommunicationHistoryEntry {
+    agentId: string;
+    sessionId: string;
+    timestamp: number;
+    requestId: string;
+    request?: string;
+    response?: string;
+    responseTime?: number;
+    systemMessage?: string;
+    messages?: unknown[];
+}
+
+export type CommunicationRequestEntry = Omit<CommunicationHistoryEntry, 'response' | 'responseTime'>;
+export type CommunicationResponseEntry = Omit<CommunicationHistoryEntry, 'request'>;
+
+export type CommunicationRequestEntryParam = Omit<CommunicationRequestEntry, 'timestamp'> & Partial<Pick<CommunicationHistoryEntry, 'timestamp'>>;
+export type CommunicationResponseEntryParam = Omit<CommunicationResponseEntry, 'timestamp'> & Partial<Pick<CommunicationHistoryEntry, 'timestamp'>>;
+
+export const CommunicationRecordingService = Symbol('CommunicationRecordingService');
+export interface CommunicationRecordingService {
+    recordRequest(requestEntry: CommunicationRequestEntryParam): void;
+    readonly onDidRecordRequest: Event<CommunicationRequestEntry>;
+
+    recordResponse(responseEntry: CommunicationResponseEntryParam): void;
+    readonly onDidRecordResponse: Event<CommunicationResponseEntry>;
+
+    getHistory(agentId: string): CommunicationHistory;
+
+    getSessionHistory(sessionId: string): CommunicationHistory;
+
+    clearHistory(): void;
+    readonly onStructuralChange: Event<void>;
+}

package/src/common/index.ts

@@ -0,0 +1,30 @@
+// *****************************************************************************
+// Copyright (C) 2024 EclipseSource GmbH.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+export * from './agent-service';
+export * from './agent';
+export * from './agents-variable-contribution';
+export * from './communication-recording-service';
+export * from './tool-invocation-registry';
+export * from './language-model-delegate';
+export * from './language-model-util';
+export * from './language-model';
+export * from './prompt-service';
+export * from './prompt-service-util';
+export * from './protocol';
+export * from './today-variable-contribution';
+export * from './tomorrow-variable-contribution';
+export * from './variable-service';
+export * from './settings-service';

package/src/common/language-model-delegate.ts

@@ -0,0 +1,45 @@
+// *****************************************************************************
+// Copyright (C) 2024 EclipseSource GmbH.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+
+import { CancellationToken } from '@theia/core';
+import { LanguageModelMetaData, LanguageModelParsedResponse, LanguageModelRequest, LanguageModelStreamResponsePart, LanguageModelTextResponse } from './language-model';
+
+export const LanguageModelDelegateClient = Symbol('LanguageModelDelegateClient');
+export interface LanguageModelDelegateClient {
+    toolCall(requestId: string, toolId: string, args_string: string): Promise<unknown>;
+    send(id: string, token: LanguageModelStreamResponsePart | undefined): void;
+}
+export const LanguageModelRegistryFrontendDelegate = Symbol('LanguageModelRegistryFrontendDelegate');
+export interface LanguageModelRegistryFrontendDelegate {
+    getLanguageModelDescriptions(): Promise<LanguageModelMetaData[]>;
+}
+
+export interface LanguageModelStreamResponseDelegate {
+    streamId: string;
+}
+export const isLanguageModelStreamResponseDelegate = (obj: unknown): obj is LanguageModelStreamResponseDelegate =>
+    !!(obj && typeof obj === 'object' && 'streamId' in obj && typeof (obj as { streamId: unknown }).streamId === 'string');
+
+export type LanguageModelResponseDelegate = LanguageModelTextResponse | LanguageModelParsedResponse | LanguageModelStreamResponseDelegate;
+
+export const LanguageModelFrontendDelegate = Symbol('LanguageModelFrontendDelegate');
+export interface LanguageModelFrontendDelegate {
+    cancel(requestId: string): void;
+    request(modelId: string, request: LanguageModelRequest, requestId: string, cancellationToken?: CancellationToken): Promise<LanguageModelResponseDelegate>;
+}
+
+export const languageModelRegistryDelegatePath = '/services/languageModelRegistryDelegatePath';
+export const languageModelDelegatePath = '/services/languageModelDelegatePath';

package/src/common/language-model-util.ts

@@ -0,0 +1,84 @@
+// *****************************************************************************
+// Copyright (C) 2024 EclipseSource GmbH.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+
+import { isLanguageModelParsedResponse, isLanguageModelStreamResponse, isLanguageModelTextResponse, LanguageModelResponse, ToolRequest } from './language-model';
+
+/**
+ * Retrieves the text content from a `LanguageModelResponse` object.
+ *
+ * **Important:** For stream responses, the stream can only be consumed once. Calling this function multiple times on the same stream response will return an empty string (`''`)
+ * on subsequent calls, as the stream will have already been consumed.
+ *
+ * @param {LanguageModelResponse} response - The response object, which may contain a text, stream, or parsed response.
+ * @returns {Promise<string>} - A promise that resolves to the text content of the response.
+ * @throws {Error} - Throws an error if the response type is not supported or does not contain valid text content.
+ */
+export const getTextOfResponse = async (response: LanguageModelResponse): Promise<string> => {
+    if (isLanguageModelTextResponse(response)) {
+        return response.text;
+    } else if (isLanguageModelStreamResponse(response)) {
+        let result = '';
+        for await (const chunk of response.stream) {
+            result += chunk.content ?? '';
+        }
+        return result;
+    } else if (isLanguageModelParsedResponse(response)) {
+        return response.content;
+    }
+    throw new Error(`Invalid response type ${response}`);
+};
+
+export const getJsonOfResponse = async (response: LanguageModelResponse): Promise<unknown> => {
+    const text = await getTextOfResponse(response);
+    return getJsonOfText(text);
+};
+
+export const getJsonOfText = (text: string): unknown => {
+    if (text.startsWith('```json')) {
+        const regex = /```json\s*([\s\S]*?)\s*```/g;
+        let match;
+        // eslint-disable-next-line no-null/no-null
+        while ((match = regex.exec(text)) !== null) {
+            try {
+                return JSON.parse(match[1]);
+            } catch (error) {
+                console.error('Failed to parse JSON:', error);
+            }
+        }
+    } else if (text.startsWith('{') || text.startsWith('[')) {
+        return JSON.parse(text);
+    }
+    throw new Error('Invalid response format');
+};
+
+export const toolRequestToPromptText = (toolRequest: ToolRequest): string => {
+    const parameters = toolRequest.parameters;
+    let paramsText = '';
+    // parameters are supposed to be as a JSON schema. Thus, derive the parameters from its properties definition
+    if (parameters) {
+        const properties = parameters.properties;
+        paramsText = Object.keys(properties)
+            .map(key => {
+                const param = properties[key];
+                return `${key}: ${param.type}`;
+            })
+            .join(', ');
+    }
+    const descriptionText = toolRequest.description
+        ? `: ${toolRequest.description}`
+        : '';
+    return `You can call function: ${toolRequest.id}(${paramsText})${descriptionText}`;
+};

package/src/common/language-model.spec.ts

@@ -0,0 +1,86 @@
+// *****************************************************************************
+// Copyright (C) 2024 EclipseSource GmbH.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+
+import { isModelMatching, LanguageModel, LanguageModelSelector } from './language-model';
+import { expect } from 'chai';
+
+describe('isModelMatching', () => {
+    it('returns false with one of two parameter mismatches', () => {
+        expect(
+            isModelMatching(
+                <LanguageModelSelector>{
+                    name: 'XXX',
+                    family: 'YYY',
+                },
+                <LanguageModel>{
+                    name: 'gpt-4o',
+                    family: 'YYY',
+                }
+            )
+        ).eql(false);
+    });
+    it('returns false with two parameter mismatches', () => {
+        expect(
+            isModelMatching(
+                <LanguageModelSelector>{
+                    name: 'XXX',
+                    family: 'YYY',
+                },
+                <LanguageModel>{
+                    name: 'gpt-4o',
+                    family: 'ZZZ',
+                }
+            )
+        ).eql(false);
+    });
+    it('returns true with one parameter match', () => {
+        expect(
+            isModelMatching(
+                <LanguageModelSelector>{
+                    name: 'gpt-4o',
+                },
+                <LanguageModel>{
+                    name: 'gpt-4o',
+                }
+            )
+        ).eql(true);
+    });
+    it('returns true with two parameter matches', () => {
+        expect(
+            isModelMatching(
+                <LanguageModelSelector>{
+                    name: 'gpt-4o',
+                    family: 'YYY',
+                },
+                <LanguageModel>{
+                    name: 'gpt-4o',
+                    family: 'YYY',
+                }
+            )
+        ).eql(true);
+    });
+    it('returns true if there are no parameters in selector', () => {
+        expect(
+            isModelMatching(
+                <LanguageModelSelector>{},
+                <LanguageModel>{
+                    name: 'gpt-4o',
+                    family: 'YYY',
+                }
+            )
+        ).eql(true);
+    });
+});