@promptbook/cli 0.112.0-104 → 0.112.0-105

package/src/collection/agent-collection/constructors/agent-collection-in-directory/AgentCollectionInDirectory.test.ts.todo

@@ -1,131 +0,0 @@
-import { describe } from '@jest/globals';
-
-describe('AgentCollectionInDirectory', () => {
-
-    it('--- IGNORE ---', () => {
-        // Placeholder test to avoid Jest error about no tests found
-    });
-
-    
-    /*
-    TODO: [🐱‍🚀] ENOENT: no such file or directory, open 'C:\Users\me\work\ai\promptbook\agents\examples\Asistent pro LŠVP.book
-    
-    import { describe, expect, it } from '@jest/globals';
-    import { $provideFilesystemForNode } from '../../../scrapers/_common/register/$provideFilesystemForNode';
-    import { AgentCollectionInDirectory } from './AgentCollectionInDirectory';
-    
-    it('should get agent by name from collection', async () => {
-        // [🐱‍🚀] expect.assertions(1);
-        const collection = new AgentCollectionInDirectory(
-            './agents/examples',
-            {
-                fs: $provideFilesystemForNode(),
-            },
-            {
-                isVerbose: true,
-                isRecursive: false,
-                isLazyLoaded: false,
-            },
-        );
-        const agent = await collection.getAgentByName('Asistent pro LŠVP');
-
-        expect(agent.agentName).toBe('Asistent pro LŠVP');
-        expect(agent.agentSource).toContain('Rámcový vzdělávací program');
-    });
-    */
-    /*
-    TODO: [🐱‍🚀]
-    it('should get lazy-loaded pipeline by url from collection', async () => {
-        expect.assertions(1);
-
-        const collection = new AgentCollectionInDirectory(
-            './agents/examples',
-            { fs: $provideFilesystemForNode() },
-            {
-                isVerbose: true,
-                isRecursive: false,
-                isLazyLoaded: true,
-            },
-        );
-        let pipelineFromCollection = await collection.getPipelineByUrl(
-            'https://promptbook.studio/examples/simple.book',
-        );
-
-        pipelineFromCollection = unpreparePipeline(pipelineFromCollection);
-        pipelineFromCollection = { ...pipelineFromCollection, sourceFile: undefined };
-
-        expect(pipelineFromCollection).toMatchObject({ title: `✨ Example prompt with URL` });
-    });
-
-    it('should get different pipeline by url from collection', async () => {
-        expect.assertions(1);
-
-        const collection = new AgentCollectionInDirectory(
-            './agents/examples',
-            { fs: $provideFilesystemForNode() },
-            {
-                isVerbose: true,
-                isRecursive: false,
-            },
-        );
-        let pipelineFromCollection = await collection.getPipelineByUrl(
-            'https://promptbook.studio/examples/jokers.book',
-        );
-
-        pipelineFromCollection = unpreparePipeline(pipelineFromCollection);
-        pipelineFromCollection = { ...pipelineFromCollection, sourceFile: undefined };
-
-        expect(pipelineFromCollection).not.toMatchObject({ title: `✨ Example prompt with URL` });
-    });
-
-    it('should NOT crash when include error pipelines but lazy-loaded', () =>
-        expect(
-            (async () => {
-                const collection = new AgentCollectionInDirectory(
-                    './agents/examples',
-                    { fs: $provideFilesystemForNode() },
-                    {
-                        isVerbose: true,
-                        // Note: Including subdirectories BUT lazy-loaded so it should not crash even if there are errors
-                        isRecursive: true,
-                        isLazyLoaded: true,
-                    },
-                );
-                keepUnused(collection);
-            })(),
-        ).resolves.not.toThrow());
-
-    it('should crash when include error pipelines', () =>
-        expect(
-            (async () => {
-                const collection = new AgentCollectionInDirectory(
-                    './agents/examples',
-                    { fs: $provideFilesystemForNode() },
-                    {
-                        isVerbose: true,
-                        // Note: Including subdirectories BUT lazy-loaded so it should not crash even if there are errors
-                        isRecursive: true,
-                        isLazyLoaded: false,
-                    },
-                );
-                keepUnused(collection);
-            })(),
-        ).rejects.toThrowError(/^ParseError in pipeline examples.* /i));
-    */
-    /*
-    TODO: Make separate folder for errors and enable this test
-    it('should find pipeline in subdirectory', () =>
-        expect(
-            (async () => {
-              const collection = await   createAgentCollectionFromDirectory('./agents/examples',{}, {
-                    isVerbose: true,
-                    isRecursive: false,
-                });
-                const pipelineFromCollection = await collection.getPipelineByUrl(
-                    'https://promptbook.studio/webgpt/write-website-content.book',
-                );
-                return pipelineFromCollection.title;
-            })(),
-        ).resolves.toBe('🌍 Create website content'));
-    */
-});

package/src/commands/_common/parseCommand.test.ts.todo

@@ -1,48 +0,0 @@
-import { describe, expect, it } from '@jest/globals';
-import { just } from '../../utils/organization/just';
-import { keepUnused } from '../../utils/organization/keepUnused';
-import { COMMANDS } from '../index';
-import { parseCommand } from './parseCommand';
-import { CommandUsagePlaces } from './types/CommandUsagePlaces';
-
-// TODO: !!! Make this test work
-
-describe('parsing the commands', () => {
-    // Note: Other working cases and better tests for each command is in the corresponding command test file
-
-    for (const { name, isUsedInPipelineHead, isUsedInPipelineTask, examples } of COMMANDS) {
-        for (const usagePlace of CommandUsagePlaces) {
-            if (just(false)) {
-                keepUnused(/* for better indentation */);
-            } else if (usagePlace === 'PIPELINE_HEAD' && !isUsedInPipelineHead) {
-                continue;
-            } else if (usagePlace === 'PIPELINE_TASK' && !isUsedInPipelineTask) {
-                continue;
-            }
-
-            it(`should parse command ${name} in ${usagePlace} without errors`, () => {
-                for (const example of examples) {
-                    expect(() => parseCommand(example, usagePlace)).not.toThrowError();
-                }
-            });
-
-            it(`should parse command ${name} in ${usagePlace} and return parsed command \`{"type": "${name}"}\``, () => {
-                for (const example of examples) {
-                    expect(parseCommand(example, usagePlace).type).toBe(name);
-                }
-            });
-        }
-    }
-
-    it('should fail parsing multi-line command', () => {
-        expect(() => parseCommand('\nprompt section', 'PIPELINE_HEAD')).toThrowError(/Can not contain new line/i);
-        expect(() => parseCommand('prompt section\n', 'PIPELINE_HEAD')).toThrowError(/Can not contain new line/i);
-    });
-
-    it('should fail parsing unknown command', () => {
-        expect(() => parseCommand('', 'PIPELINE_HEAD')).toThrowError(/Malformed command/i);
-        expect(() => parseCommand('afasf ddd', 'PIPELINE_HEAD')).toThrowError(/Malformed or unknown command/i);
-        expect(() => parseCommand('nothing to get', 'PIPELINE_HEAD')).toThrowError(/Malformed or unknown command/i);
-        expect(() => parseCommand('prameter {name}', 'PIPELINE_HEAD')).toThrowError(/Malformed or unknown command/i);
-    });
-});

package/src/commitments/META_LINK/META_LINK.test.ts.todo

@@ -1,75 +0,0 @@
-// TODO: Uncomment the test
-
-import { describe, expect, it } from '@jest/globals';
-import { MetaLinkCommitmentDefinition } from './META_LINK';
-
-describe('MetaLinkCommitmentDefinition', () => {
-    let commitment: MetaLinkCommitmentDefinition;
-
-    beforeEach(() => {
-        commitment = new MetaLinkCommitmentDefinition();
-    });
-
-    it('should have correct type', () => {
-        expect(commitment.type).toBe('META LINK');
-    });
-
-    it('should create correct regex pattern', () => {
-        const regex = commitment.createRegex();
-
-        // Test valid META LINK patterns
-        expect(regex.test('META LINK https://twitter.com/username')).toBe(true);
-        expect(regex.test('META LINK https://linkedin.com/in/profile')).toBe(true);
-        expect(regex.test('META LINK https://github.com/username')).toBe(true);
-
-        // Test invalid patterns
-        expect(regex.test('METALINK https://twitter.com/username')).toBe(false);
-        expect(regex.test('META_LINK https://twitter.com/username')).toBe(false);
-        expect(regex.test('META IMAGE https://twitter.com/username')).toBe(false);
-    });
-
-    it('should create correct type regex pattern', () => {
-        const typeRegex = commitment.createTypeRegex();
-
-        // Test valid type patterns
-        expect(typeRegex.test('META LINK')).toBe(true);
-        expect(typeRegex.test('META LINK https://twitter.com/username')).toBe(true);
-
-        // Test invalid patterns
-        expect(typeRegex.test('METALINK')).toBe(false);
-        expect(typeRegex.test('META_LINK')).toBe(false);
-        expect(typeRegex.test('META IMAGE')).toBe(false);
-    });
-
-    it('should not modify agent model requirements', () => {
-        const requirements = {
-            systemMessage: 'Test system message',
-            modelName: 'test-model',
-        };
-
-        const result = commitment.applyToAgentModelRequirements(requirements, 'https://twitter.com/username');
-
-        // META LINK should not modify the system message
-        expect(result).toEqual(requirements);
-        expect(result.systemMessage).toBe('Test system message');
-    });
-
-    it('should extract profile link URL correctly', () => {
-        expect(commitment.extractProfileLinkUrl('https://twitter.com/username')).toBe('https://twitter.com/username');
-        expect(commitment.extractProfileLinkUrl('  https://linkedin.com/in/profile  ')).toBe(
-            'https://linkedin.com/in/profile',
-        );
-        expect(commitment.extractProfileLinkUrl('')).toBe('');
-        expect(commitment.extractProfileLinkUrl('   ')).toBe('');
-    });
-
-    it('should validate URLs correctly', () => {
-        expect(commitment.isValidUrl('https://twitter.com/username')).toBe(true);
-        expect(commitment.isValidUrl('http://example.com')).toBe(true);
-        expect(commitment.isValidUrl('https://linkedin.com/in/profile')).toBe(true);
-
-        expect(commitment.isValidUrl('not-a-url')).toBe(false);
-        expect(commitment.isValidUrl('')).toBe(false);
-        expect(commitment.isValidUrl('twitter.com/username')).toBe(false); // Missing protocol
-    });
-});

package/src/conversion/validation/pipelineStringToJson-errors.test.ts.todo

@@ -1,33 +0,0 @@
-import { describe, expect, it } from '@jest/globals';
-import { readdirSync } from 'fs';
-import { join } from 'path';
-import { compilePipeline } from '../compilePipeline';
-import { importPipelineWithoutPreparation } from './_importPipeline';
-import { validatePipeline } from './validatePipeline';
-
-// TODO: Change the code such as `importPipelineWithoutPreparation` is now async
-
-describe('validatePipeline with errors', () => {
-    const examplesDir = '../../../examples/pipelines/'; // <- TODO: [🚏] DRY, to config
-    const examples = readdirSync(join(__dirname, examplesDir, 'errors'), { withFileTypes: true, recursive: true })
-        //                         <- Note: In production it is not good practice to use synchronous functions
-        //                                  But this is only a test before the build, so it is okay
-        .filter((dirent) => dirent.isFile())
-        .filter(({ name }) => name.endsWith('.book'));
-
-    for (const { name, path } of examples) {
-        it(`should check ${name}`, () => {
-            expect(async () => {
-                const pipelineString = importPipelineWithoutPreparation(path as `${string}.book`);
-                const pipelineJson = await compilePipeline(pipelineString);
-                validatePipeline(pipelineJson);
-
-                console.error('Pipeline should have error BUT it does not:\n', name);
-            }).rejects.toThrowError();
-        });
-    }
-});
-
-/**
- * TODO: [🚏] DRY
- */

package/src/dialogs/simple-prompt/SimplePromptInterfaceTools.ts

@@ -1,51 +0,0 @@
-import { spaceTrim } from 'spacetrim';
-import { PipelineExecutionError } from '../../errors/PipelineExecutionError';
-import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
-import type { UserInterfaceTools } from '../../execution/UserInterfaceTools';
-import type { UserInterfaceToolsPromptDialogOptions } from '../../execution/UserInterfaceTools';
-
-/**
- * Wrapper around `window.prompt` synchronous function that interacts with the user via browser prompt
- *
- * Warning: It is used for testing and mocking
- * **NOT intended to use in the production** due to its synchronous nature.
- *
- * @public exported from `@promptbook/browser`
- */
-export class SimplePromptInterfaceTools implements UserInterfaceTools {
-    public constructor(protected readonly options: CommonToolsOptions = {}) {}
-
-    /**
-     * Trigger window.prompt dialog
-     */
-    public async promptDialog(options: UserInterfaceToolsPromptDialogOptions): Promise<string> {
-        const answer = window.prompt(
-            spaceTrim(
-                (block) => `
-                    ${block(options.promptTitle)}
-
-                    ${block(options.promptMessage)}
-                `,
-            ),
-        );
-
-        if (this.options.isVerbose) {
-            console.info(
-                spaceTrim(
-                    (block) => `
-                        📖 ${block(options.promptTitle)}
-                        👤 ${block(answer || '🚫 User cancelled prompt')}
-                    `,
-                ),
-            );
-        }
-
-        if (answer === null) {
-            throw new PipelineExecutionError('User cancelled prompt');
-        }
-
-        return answer;
-    }
-}
-
-// Note: [🔵] Code for browser dialog helper [SimplePromptInterfaceTools](src/dialogs/simple-prompt/SimplePromptInterfaceTools.ts) should never be published outside of `@promptbook/browser`

package/src/executables/browsers/locateSafari.test.ts.tmp

@@ -1,15 +0,0 @@
-import { describe, expect, it } from '@jest/globals';
-import { locateSafari } from './locateSafari';
-
-// Note: [🚽] Commenting the test out
-
-describe('locating the Safari browser', () => {
-    it('should locate Safari browser', async () => {
-        if (process.platform === 'darwin') {
-            await expect(locateSafari()).resolves.toMatch(/safari/i);
-        } else {
-            await expect(locateSafari()).rejects.toThrow();
-        }
-        expect.assertions(1);
-    });
-});

package/src/execution/PromptbookFetch.test-type.ts

@@ -1,14 +0,0 @@
-import { keepUnused } from '../utils/organization/keepUnused';
-import type { PromptbookFetch } from './PromptbookFetch';
-
-// Note: Checking that `fetch` is implementing `PromptbookFetch`
-/**
- * Constant for compatible fetch.
- */
-let compatibleFetch: PromptbookFetch | null;
-compatibleFetch = null;
-compatibleFetch = fetch;
-keepUnused(compatibleFetch);
-
-// Note: [⚪] This should never be in any released package
-// TODO: Is this a good pattern to do type testing?

package/src/execution/execution-report/executionReportJsonToString.test.ts.todo

@@ -1,83 +0,0 @@
-import { describe, expect, it } from '@jest/globals';
-import { readFileSync, readdirSync } from 'fs';
-import { join } from 'path';
-import { executionReportJsonToString } from './executionReportJsonToString';
-
-/*
-TODO: Allow back after fixing this annoying error:
-      Error is superstrange because all functions are deterministic BUT sometimes it makes  and sometimes 0.0000278 🤯
-
-Summary of all failing tests
- FAIL  src/types/execution-report/executionReportJsonToString.test.ts
-  ● executionReportJsonToString.test › should generate report for 50-advanced.report.json
-
-    expect(received).toEqual(expected) // deep equality
-
-    - Expected  - 4
-    + Received  + 4
-
-    @@ -14,15 +14,15 @@
-
-      -   [�� Prompt](#-prompt)
-
-      ## ⌚ Time chart
-
-    - | Task | Timeline |
-    - | -------- | -------- |
-    - | Prompt   |          |
-    + | Task     | Timeline                             |
-    + | -------- | ------------------------------------ |
-    + | Prompt   | ████████████████████████████████████ |
-
-    - _Note: Each █ represents 0 seconds, width of timeline is 0 seconds = 36 squares_
-    + _Note: Each █ represents 0.0000278 seconds, width of timeline is 0.001 seconds = 36 squares_
-
-      ## �� Cost chart
-
-      | Task | Cost |
-      | -------- | ---- |
-
-      22 |                     ),
-      23 |                 ),
-    > 24 |             ).toEqual(readFileSync(join(__dirname, examplesDir, name).replace('.report.json', '.report.md'), 'utf-8'));
-         |               ^
-      25 |         });
-      26 |     }
-      27 | });
-
-      at Object.<anonymous> (src/types/execution-report/executionReportJsonToString.test.ts:24:15)
-
-
-Test Suites: 1 failed, 83 passed, 84 total
-Tests:       1 failed, 394 passed, 395 total
-Snapshots:   0 total
-Time:        30.388 s, estimated 74 s
-Ran all test suites.
-
-
-*/
-
-describe('executionReportJsonToString.test', () => {
-    const examplesDir = '../../../examples/pipelines'; // <- TODO: [🚏] DRY, to config
-    const examples = readdirSync(join(__dirname, examplesDir), { withFileTypes: true, recursive: false })
-        //                         <- Note: In production it is not good practice to use synchronous functions
-        //                                  But this is only a test before the build, so it is okay
-        .filter((dirent) => dirent.isFile())
-        .filter(({ name }) => name.endsWith('.report.json'));
-
-    for (const { name } of examples) {
-        it(`should generate report for ${name}`, () => {
-            expect(
-                executionReportJsonToString(
-                    jsonParse(
-                        readFileSync(join(__dirname, examplesDir, name), 'utf-8'),
-                        //          <- Note: In production it is not good practice to use synchronous functions
-                        //                   But this is only a test before the build, so it is okay
-                    ),
-                ),
-            ).toEqual(readFileSync(join(__dirname, examplesDir, name).replace('.report.json', '.report.md'), 'utf-8'));
-        });
-    }
-});
-
-

package/src/execution/utils/usageToHuman.test.ts.todo

@@ -1,80 +0,0 @@
-// TODO: [🍓][🧞‍♂️] Uncomment this test after `usageToHuman` is working
-
-import { describe, expect, it } from '@jest/globals';
-import { spaceTrim } from 'spacetrim';
-import { ZERO_USAGE } from './usage-constants';
-import { usageToHuman } from './usageToHuman';
-
-describe('how usageToHuman works', () => {
-    it('no use should return a meaningful report', () =>
-        expect(usageToHuman(ZERO_USAGE)).toEqual(
-            spaceTrim(`
-                Usage:
-                - Cost 0 USD
-                - Saved 0 hours of human time
-            `),
-        ));
-
-    it('should make report', () =>
-        expect(
-            usageToHuman({
-                price: { value: 1 },
-                input: {
-                    tokensCount: ZERO_VALUE,
-                    charactersCount: { value: 1 },
-                    wordsCount: { value: 20 },
-                    sentencesCount: { value: 3 },
-                    linesCount: { value: 4 },
-                    paragraphsCount: { value: 5 },
-                    pagesCount: { value: 6 },
-                },
-                output: {
-                    tokensCount: { value: 3000 },
-                    charactersCount: { value: 1 },
-                    wordsCount: { value: 20 },
-                    sentencesCount: { value: 3 },
-                    linesCount: { value: 4 },
-                    paragraphsCount: { value: 5 },
-                    pagesCount: { value: 6 },
-                },
-            }),
-        ).toEqual(
-            spaceTrim(`
-                Usage:
-                - Cost 1 USD
-                - Saved 0.01 hours of human time
-            `),
-        ));
-
-    it('should make report from uncertain usage', () =>
-        expect(
-            usageToHuman({
-                price: { value: 1, isUncertain: true },
-                input: {
-                    tokensCount: UNCERTAIN_ZERO_VALUE,
-                    charactersCount: { value: 1, isUncertain: true },
-                    wordsCount: { value: 3000, isUncertain: true },
-                    sentencesCount: { value: 3, isUncertain: true },
-                    linesCount: { value: 4, isUncertain: true },
-                    paragraphsCount: { value: 5, isUncertain: true },
-                    pagesCount: { value: 6, isUncertain: true },
-                },
-                output: {
-                    tokensCount: { value: 300, isUncertain: true },
-                    charactersCount: { value: 1, isUncertain: true },
-                    wordsCount: { value: 80000, isUncertain: true },
-                    sentencesCount: { value: 3, isUncertain: true },
-                    linesCount: { value: 4, isUncertain: true },
-                    paragraphsCount: { value: 5, isUncertain: true },
-                    pagesCount: { value: 6, isUncertain: true },
-                },
-            }),
-        ).toEqual(
-            spaceTrim(`
-                Usage:
-                - Cost approximately 1 USD
-                - Saved approximately 33.58 hours of human time
-
-            `),
-        ));
-});

package/src/llm-providers/_common/register/$provideLlmToolsForTestingAndScriptsAndPlayground.ts

@@ -1,76 +0,0 @@
-import { join } from 'path';
-import { DEFAULT_EXECUTION_CACHE_DIRNAME, IS_COST_PREVENTED } from '../../../config';
-import { EnvironmentMismatchError } from '../../../errors/EnvironmentMismatchError';
-import type { LlmExecutionTools } from '../../../execution/LlmExecutionTools';
-import { $provideFilesystemForNode } from '../../../scrapers/_common/register/$provideFilesystemForNode';
-import { FileCacheStorage } from '../../../storage/file-cache-storage/FileCacheStorage';
-import { $isRunningInNode } from '../../../utils/environment/$isRunningInNode';
-import '../../../_packages/cli.index'; // <- Note: Really importing core index to register all the LLM providers
-import { cacheLlmTools } from '../utils/cache/cacheLlmTools';
-import { countUsage } from '../utils/count-total-usage/countUsage';
-import { limitTotalUsage } from '../utils/count-total-usage/limitTotalUsage';
-import type { LlmExecutionToolsWithTotalUsage } from '../utils/count-total-usage/LlmExecutionToolsWithTotalUsage';
-import { $provideLlmToolsFromEnv } from './$provideLlmToolsFromEnv';
-import type { CreateLlmToolsFromConfigurationOptions } from './createLlmToolsFromConfiguration';
-
-/**
- * Options for get Llm tools for testing and scripts and playground.
- */
-type GetLlmToolsForTestingAndScriptsAndPlaygroundOptions = CreateLlmToolsFromConfigurationOptions & {
-    /**
-     * Flag indicating whether the cache should be reloaded or reused
-     * When set to true, the existing cache will not be used but thinks will be still saved to the cache
-     *
-     * @default false
-     */
-    isCacheReloaded?: boolean;
-};
-
-/**
- * Returns LLM tools for testing purposes
- *
- * Note: `$` is used to indicate that this function is not a pure function - it uses filesystem to access `.env` file
- *
- * @private within the repository - JUST FOR TESTS, SCRIPTS AND PLAYGROUND
- */
-export async function $provideLlmToolsForTestingAndScriptsAndPlayground(
-    options?: GetLlmToolsForTestingAndScriptsAndPlaygroundOptions,
-): Promise<LlmExecutionToolsWithTotalUsage> {
-    if (!$isRunningInNode()) {
-        throw new EnvironmentMismatchError(
-            'Function `$provideLlmToolsForTestingAndScriptsAndPlayground` works only in Node.js environment',
-        );
-    }
-
-    const { isCacheReloaded = false, ...restOptions } = options ?? {};
-
-    const llmTools: LlmExecutionTools = await $provideLlmToolsFromEnv({
-        title: 'LLM Tools for testing, scripts and playground',
-        ...restOptions,
-    });
-    const llmToolsWithUsage = !IS_COST_PREVENTED
-        ? countUsage(llmTools)
-        : //    <- Note: for example here we don`t want the [🌯]
-          limitTotalUsage(llmTools);
-    //          <- Note: `limitTotalUsage` will do everything as `countTotalUsage` and adds usage limit
-    //          <- Note: for example here we don`t want the [🌯]
-
-    return cacheLlmTools(llmToolsWithUsage, {
-        storage: new FileCacheStorage(
-            { fs: $provideFilesystemForNode() },
-            {
-                rootFolderPath: join(
-                    process.cwd(),
-                    DEFAULT_EXECUTION_CACHE_DIRNAME,
-                    // <- TODO: [🦒] Allow to override (pass different value into the function)
-                ),
-            },
-        ),
-        isCacheReloaded: isCacheReloaded,
-    });
-}
-
-// Note: [⚪] This should never be in any released package
-// TODO: [👷‍♂️] Write a comprehensive manual about the construction of LLM tools
-// TODO: This should be maybe not under `_common` but under `utils-internal` / `utils/internal`
-// TODO: [®] DRY Register logi

package/src/llm-providers/_common/utils/assertUniqueModels.ts

@@ -1,27 +0,0 @@
-import type { AvailableModel } from '../../../execution/AvailableModel';
-
-/**
- * Utility to assert that all models in the provided array have unique `modelName` values.
- *
- * This is internal utility for unit tests to ensure no duplicate model names exist.
- *
- * @private internal utility of unit tests
- */
-export function assertUniqueModels(models: ReadonlyArray<AvailableModel>) {
-    const seen = new Map<string, boolean>();
-    const duplicates: string[] = [];
-    for (const model of models) {
-        const value = model.modelName;
-        if (typeof value !== 'string') continue;
-        if (seen.has(value)) {
-            duplicates.push(value);
-        } else {
-            seen.set(value, true);
-        }
-    }
-    if (duplicates.length > 0) {
-        throw new Error(`Duplicate model names found: ${duplicates.join(', ')}`);
-    }
-}
-
-// Note: [⚪] This should never be in any released package