@promptbook/cli 0.112.0-99 → 0.113.0-0

package/apps/agents-server/src/message-providers/email/_common/utils/parseEmailAddresses.test.ts.todo

@@ -1,117 +0,0 @@
-import { describe, expect, it } from '@jest/globals';
-import { parseEmailAddresses } from './parseEmailAddresses';
-
-describe('how parseEmailAddresses works', () => {
-    it('should work with single email', () => {
-        expect(parseEmailAddresses('pavol@webgpt.cz')).toEqual([
-            {
-                fullName: null,
-                baseEmail: 'pavol@webgpt.cz',
-                fullEmail: 'pavol@webgpt.cz',
-                plus: [],
-            },
-        ]);
-    });
-
-    it('should work with simple emails', () => {
-        expect(parseEmailAddresses('pavol@webgpt.cz, jirka@webgpt.cz, tomas@webgpt.cz')).toEqual([
-            {
-                fullName: null,
-                baseEmail: 'pavol@webgpt.cz',
-                fullEmail: 'pavol@webgpt.cz',
-                plus: [],
-            },
-            {
-                fullName: null,
-                baseEmail: 'jirka@webgpt.cz',
-                fullEmail: 'jirka@webgpt.cz',
-                plus: [],
-            },
-            {
-                fullName: null,
-                baseEmail: 'tomas@webgpt.cz',
-                fullEmail: 'tomas@webgpt.cz',
-                plus: [],
-            },
-        ]);
-    });
-
-    it('should work with fullname', () => {
-        expect(
-            parseEmailAddresses(
-                'Pavol Hejný <pavol@webgpt.cz>, Jirka <jirka@webgpt.cz>, "Tomáš Studeník" <tomas@webgpt.cz>',
-            ),
-        ).toEqual([
-            {
-                fullName: 'Pavol Hejný',
-                baseEmail: 'pavol@webgpt.cz',
-                fullEmail: 'pavol@webgpt.cz',
-                plus: [],
-            },
-            {
-                fullName: 'Jirka',
-                baseEmail: 'jirka@webgpt.cz',
-                fullEmail: 'jirka@webgpt.cz',
-                plus: [],
-            },
-            {
-                fullName: 'Tomáš Studeník',
-                baseEmail: 'tomas@webgpt.cz',
-                fullEmail: 'tomas@webgpt.cz',
-                plus: [],
-            },
-        ]);
-    });
-
-    it('not confused by comma', () => {
-        expect(parseEmailAddresses(', pavol@webgpt.cz, ')).toEqual([
-            {
-                fullName: null,
-                fullEmail: 'pavol@webgpt.cz',
-                baseEmail: 'pavol@webgpt.cz',
-                plus: [],
-            },
-        ]);
-    });
-
-    it('works on real-life example', () => {
-        expect(
-            parseEmailAddresses(
-                '"bob" <bob@bot.webgpt.cz>, "pavolto" <pavol+to@ptbk.io>, "Pavol" <pavol@collboard.com>',
-            ),
-        ).toEqual([
-            {
-                fullName: 'bob',
-                fullEmail: 'bob@bot.webgpt.cz',
-                baseEmail: 'bob@bot.webgpt.cz',
-                plus: [],
-            },
-            {
-                fullName: 'pavolto',
-                fullEmail: 'pavol+to@ptbk.io',
-                baseEmail: 'pavol@ptbk.io',
-                plus: ['to'],
-            },
-            {
-                fullName: 'Pavol',
-                fullEmail: 'pavol@collboard.com',
-                baseEmail: 'pavol@collboard.com',
-                plus: [],
-            },
-        ]);
-    });
-
-    it('throws on invalid email adresses', () => {
-        expect(() => parseEmailAddresses('Pavol, Hejný')).toThrowError(/Invalid email address/);
-        expect(() => parseEmailAddresses('Pavol Hejný <>')).toThrowError(/Invalid email address/);
-        expect(() => parseEmailAddresses('Pavol Hejný, <@webgpt.cz>')).toThrowError(/Invalid email address/);
-        expect(() => parseEmailAddresses('Pavol Hejný <webgpt.cz>')).toThrowError(/Invalid email address/);
-        expect(() => parseEmailAddresses('Pavol Hejný <pavol@>')).toThrowError(/Invalid email address/);
-        expect(() => parseEmailAddresses('Pavol Hejný <a@b>,')).toThrowError(/Invalid email address/);
-    });
-});
-
-
-/**
- * TODO: [🐫] This test fails because of aliased imports `import type { string_emails } from '@promptbook-local/types';`, fix it
- */

package/apps/agents-server/src/message-providers/email/_common/utils/stringifyEmailAddress.test.ts.todo

@@ -1,119 +0,0 @@
-import { describe, expect, it } from '@jest/globals';
-import { stringifyEmailAddress } from './stringifyEmailAddress';
-
-describe('how stringifyEmailAddress works', () => {
-    it('should work with simple email', () => {
-        expect(
-            stringifyEmailAddress({
-                fullName: null,
-                baseEmail: 'pavol@webgpt.cz',
-                fullEmail: 'pavol@webgpt.cz',
-                plus: [],
-            }),
-        ).toBe('pavol@webgpt.cz');
-        expect(
-            stringifyEmailAddress({
-                fullName: null,
-                baseEmail: 'jirka@webgpt.cz',
-                fullEmail: 'jirka@webgpt.cz',
-                plus: [],
-            }),
-        ).toBe('jirka@webgpt.cz');
-        expect(
-            stringifyEmailAddress({
-                fullName: null,
-                baseEmail: 'tomas@webgpt.cz',
-                fullEmail: 'tomas@webgpt.cz',
-                plus: [],
-            }),
-        ).toBe('tomas@webgpt.cz');
-    });
-
-    it('should work with fullname', () => {
-        expect(
-            stringifyEmailAddress({
-                fullName: 'Pavol Hejný',
-                baseEmail: 'pavol@webgpt.cz',
-                fullEmail: 'pavol@webgpt.cz',
-                plus: [],
-            }),
-        ).toBe('"Pavol Hejný" <pavol@webgpt.cz>');
-        expect(
-            stringifyEmailAddress({
-                fullName: 'Jirka',
-                baseEmail: 'jirka@webgpt.cz',
-                fullEmail: 'jirka@webgpt.cz',
-                plus: [],
-            }),
-        ).toBe('"Jirka" <jirka@webgpt.cz>');
-        expect(
-            stringifyEmailAddress({
-                fullName: 'Tomáš Studeník',
-                baseEmail: 'tomas@webgpt.cz',
-                fullEmail: 'tomas@webgpt.cz',
-                plus: [],
-            }),
-        ).toBe('"Tomáš Studeník" <tomas@webgpt.cz>');
-    });
-
-    it('should work with plus', () => {
-        expect(
-            stringifyEmailAddress({
-                fullName: null,
-                baseEmail: 'pavol@webgpt.cz',
-                fullEmail: 'pavol+test@webgpt.cz',
-                plus: ['test'],
-            }),
-        ).toBe('pavol+test@webgpt.cz');
-        expect(
-            stringifyEmailAddress({
-                fullName: null,
-                baseEmail: 'jirka@webgpt.cz',
-                fullEmail: 'jirka+test@webgpt.cz',
-                plus: ['test'],
-            }),
-        ).toBe('jirka+test@webgpt.cz');
-        expect(
-            stringifyEmailAddress({
-                fullName: null,
-                baseEmail: 'tomas@webgpt.cz',
-                fullEmail: 'tomas+test+ainautes@webgpt.cz',
-                plus: ['test', 'ainautes'],
-            }),
-        ).toBe('tomas+test+ainautes@webgpt.cz');
-    });
-
-    it('should work with both fullname and plus', () => {
-        expect(
-            stringifyEmailAddress({
-                fullName: 'Pavol Hejný',
-                baseEmail: 'pavol@webgpt.cz',
-                fullEmail: 'pavol+test@webgpt.cz',
-                plus: ['test'],
-            }),
-        ).toBe('"Pavol Hejný" <pavol+test@webgpt.cz>');
-        expect(
-            stringifyEmailAddress({
-                fullName: 'Jirka',
-                baseEmail: 'jirka@webgpt.cz',
-                fullEmail: 'jirka+test@webgpt.cz',
-                plus: ['test'],
-            }),
-        ).toBe('"Jirka" <jirka+test@webgpt.cz>');
-        expect(
-            stringifyEmailAddress({
-                fullName: 'Tomáš Studeník',
-                baseEmail: 'tomas@webgpt.cz',
-                fullEmail: 'tomas+test+ainautes@webgpt.cz',
-                plus: ['test', 'ainautes'],
-            }),
-        ).toBe('"Tomáš Studeník" <tomas+test+ainautes@webgpt.cz>');
-    });
-
-    // TODO: [🎾] Implement and test here escaping
-});
-
-
-/**
- * TODO: [🐫] This test fails because of aliased imports `import type { string_emails } from '@promptbook-local/types';`, fix it
- */

package/apps/agents-server/src/message-providers/email/_common/utils/stringifyEmailAddresses.test.ts.todo

@@ -1,74 +0,0 @@
-import { describe, expect, it } from '@jest/globals';
-import { stringifyEmailAddresses } from './stringifyEmailAddresses';
-
-describe('how stringifyEmailAddresses works', () => {
-    it('should work with single email', () => {
-        expect(
-            stringifyEmailAddresses([
-                {
-                    fullName: null,
-                    baseEmail: 'pavol@webgpt.cz',
-                    fullEmail: 'pavol@webgpt.cz',
-                    plus: [],
-                },
-            ]),
-        ).toEqual('pavol@webgpt.cz');
-    });
-
-    it('should work with simple emails', () => {
-        expect(
-            stringifyEmailAddresses([
-                {
-                    fullName: null,
-                    baseEmail: 'pavol@webgpt.cz',
-                    fullEmail: 'pavol@webgpt.cz',
-                    plus: [],
-                },
-                {
-                    fullName: null,
-                    baseEmail: 'jirka@webgpt.cz',
-                    fullEmail: 'jirka@webgpt.cz',
-                    plus: [],
-                },
-                {
-                    fullName: null,
-                    baseEmail: 'tomas@webgpt.cz',
-                    fullEmail: 'tomas@webgpt.cz',
-                    plus: [],
-                },
-            ]),
-        ).toEqual('pavol@webgpt.cz, jirka@webgpt.cz, tomas@webgpt.cz');
-    });
-
-    it('should work with fullname', () => {
-        expect(
-            stringifyEmailAddresses([
-                {
-                    fullName: 'Pavol Hejný',
-                    baseEmail: 'pavol@webgpt.cz',
-                    fullEmail: 'pavol@webgpt.cz',
-                    plus: [],
-                },
-                {
-                    fullName: 'Jiří Jahn',
-                    baseEmail: 'jirka@webgpt.cz',
-                    fullEmail: 'jirka@webgpt.cz',
-                    plus: [],
-                },
-                {
-                    fullName: 'Tomáš Studeník',
-                    baseEmail: 'tomas@webgpt.cz',
-                    fullEmail: 'tomas@webgpt.cz',
-                    plus: [],
-                },
-            ]),
-        ).toEqual('"Pavol Hejný" <pavol@webgpt.cz>, "Jiří Jahn" <jirka@webgpt.cz>, "Tomáš Studeník" <tomas@webgpt.cz>');
-    });
-
-    // TODO: [🎾] Implement and test here escaping
-});
-
-
-/**
- * TODO: [🐫] This test fails because of aliased imports `import type { string_emails } from '@promptbook-local/types';`, fix it
- */

package/apps/agents-server/src/utils/defaultFederatedAgents/DefaultFederatedAgentsSyncOptions.ts

@@ -1,9 +0,0 @@
-/**
- * Minimal context needed to schedule or execute one default federated-agent sync pass.
- *
- * @private shared type for `scheduleDefaultFederatedAgentsSync`
- */
-export type DefaultFederatedAgentsSyncOptions = {
-    readonly tablePrefix: string;
-    readonly localServerUrl: string;
-};

package/apps/agents-server/src/utils/defaultFederatedAgents/ensureDefaultFederatedAgentExists.ts

@@ -1,277 +0,0 @@
-import { type Pool, type PoolClient } from 'pg';
-import { prepareAgentSourceForPersistence } from '../../../../../src/collection/agent-collection/constructors/agent-collection-in-supabase/prepareAgentSourceForPersistence';
-import type { string_book } from '../../../../../src/book-2.0/agent-source/string_book';
-import { normalizeAgentName } from '../../../../../src/book-2.0/agent-source/normalizeAgentName';
-import { ZERO_USAGE } from '../../../../../src/execution/utils/usage-constants';
-import { $randomBase58 } from '../../../../../src/utils/random/$randomBase58';
-import { PROMPTBOOK_ENGINE_VERSION } from '../../../../../src/version';
-import type { AgentVisibility } from '../agentVisibility';
-import type { DefaultFederatedAgentCandidate } from './selectDefaultFederatedAgentsFromOrganizationPayload';
-import { quoteIdentifier } from './quoteIdentifier';
-
-/**
- * Table basename storing per-server sync state and locking rows.
- */
-const DEFAULT_FEDERATED_AGENT_TABLE_BASENAME = 'DefaultFederatedAgent';
-
-/**
- * Length of generated local permanent ids for cloned default agents.
- */
-const DEFAULT_FEDERATED_AGENT_PERMANENT_ID_LENGTH = 14;
-
-/**
- * Ensures one Core default agent exists locally while serializing writes through a DB row lock.
- *
- * @param options - Current sync inputs.
- * @returns Existing or newly created local permanent id.
- *
- * @private internal utility of `scheduleDefaultFederatedAgentsSync`
- */
-export async function ensureDefaultFederatedAgentExists(options: {
-    readonly pool: Pool;
-    readonly tablePrefix: string;
-    readonly defaultVisibility: AgentVisibility;
-    readonly candidate: DefaultFederatedAgentCandidate;
-    readonly remoteAgentSource: string_book;
-}): Promise<string> {
-    const client = await options.pool.connect();
-
-    try {
-        await client.query('BEGIN');
-        await upsertDefaultFederatedAgentSyncRow(client, options.tablePrefix, options.candidate);
-        await lockAgentWrites(client, options.tablePrefix);
-
-        const existingPermanentId = await findActiveLocalPermanentIdByNormalizedName(
-            client,
-            options.tablePrefix,
-            options.candidate.normalizedName,
-        );
-
-        if (existingPermanentId) {
-            await updateDefaultFederatedAgentLocalPermanentId(
-                client,
-                options.tablePrefix,
-                options.candidate.normalizedName,
-                existingPermanentId,
-            );
-            await client.query('COMMIT');
-            return existingPermanentId;
-        }
-
-        const newPermanentId = await insertClonedDefaultFederatedAgent(client, {
-            tablePrefix: options.tablePrefix,
-            defaultVisibility: options.defaultVisibility,
-            remoteAgentSource: options.remoteAgentSource,
-        });
-
-        await updateDefaultFederatedAgentLocalPermanentId(
-            client,
-            options.tablePrefix,
-            options.candidate.normalizedName,
-            newPermanentId,
-        );
-
-        await client.query('COMMIT');
-        return newPermanentId;
-    } catch (error) {
-        try {
-            await client.query('ROLLBACK');
-        } catch {
-            // Keep the original error visible.
-        }
-        throw error;
-    } finally {
-        client.release();
-    }
-}
-
-/**
- * Inserts or updates the sync-state row for one normalized default agent name.
- *
- * The `ON CONFLICT ... DO UPDATE` path keeps the row locked for the current transaction.
- *
- * @param client - Transaction-bound PostgreSQL client.
- * @param tablePrefix - Current server table prefix.
- * @param candidate - Candidate being synchronized.
- */
-async function upsertDefaultFederatedAgentSyncRow(
-    client: PoolClient,
-    tablePrefix: string,
-    candidate: DefaultFederatedAgentCandidate,
-): Promise<void> {
-    const syncTableName = quoteIdentifier(`${tablePrefix}${DEFAULT_FEDERATED_AGENT_TABLE_BASENAME}`);
-
-    await client.query(
-        `
-            INSERT INTO ${syncTableName} (
-                "normalizedName",
-                "sourceServerUrl",
-                "sourceAgentIdentifier",
-                "updatedAt"
-            )
-            VALUES ($1, $2, $3, now())
-            ON CONFLICT ("normalizedName")
-            DO UPDATE
-            SET
-                "sourceServerUrl" = EXCLUDED."sourceServerUrl",
-                "sourceAgentIdentifier" = EXCLUDED."sourceAgentIdentifier",
-                "updatedAt" = now()
-        `,
-        [candidate.normalizedName, new URL(candidate.sourceAgentUrl).origin, candidate.sourceAgentIdentifier],
-    );
-}
-
-/**
- * Blocks concurrent writes to the current server's agent table during the critical recheck/create section.
- *
- * @param client - Transaction-bound PostgreSQL client.
- * @param tablePrefix - Current server table prefix.
- */
-async function lockAgentWrites(client: PoolClient, tablePrefix: string): Promise<void> {
-    const agentTableName = quoteIdentifier(`${tablePrefix}Agent`);
-    await client.query(`LOCK TABLE ${agentTableName} IN SHARE ROW EXCLUSIVE MODE`);
-}
-
-/**
- * Finds the oldest active local agent whose normalized name matches the requested value.
- *
- * @param client - Transaction-bound PostgreSQL client.
- * @param tablePrefix - Current server table prefix.
- * @param normalizedName - Stable normalized lookup key.
- * @returns Matching permanent id or `null`.
- */
-async function findActiveLocalPermanentIdByNormalizedName(
-    client: PoolClient,
-    tablePrefix: string,
-    normalizedName: string,
-): Promise<string | null> {
-    const agentTableName = quoteIdentifier(`${tablePrefix}Agent`);
-    const result = await client.query<{ agentName: string; permanentId: string | null }>(
-        `
-            SELECT "agentName", "permanentId"
-            FROM ${agentTableName}
-            WHERE "deletedAt" IS NULL
-            ORDER BY "createdAt" ASC
-        `,
-    );
-
-    for (const row of result.rows) {
-        if (!row.permanentId) {
-            continue;
-        }
-
-        if (normalizeAgentName(row.agentName) === normalizedName) {
-            return row.permanentId;
-        }
-    }
-
-    return null;
-}
-
-/**
- * Persists a freshly cloned default agent together with its initial history snapshot.
- *
- * @param client - Transaction-bound PostgreSQL client.
- * @param options - Insert inputs.
- * @returns Permanent id of the stored local agent.
- */
-async function insertClonedDefaultFederatedAgent(
-    client: PoolClient,
-    options: {
-        readonly tablePrefix: string;
-        readonly defaultVisibility: AgentVisibility;
-        readonly remoteAgentSource: string_book;
-    },
-): Promise<string> {
-    const preparedAgentSource = prepareAgentSourceForPersistence(options.remoteAgentSource);
-    const permanentId = preparedAgentSource.permanentId || $randomBase58(DEFAULT_FEDERATED_AGENT_PERMANENT_ID_LENGTH);
-    const createdAt = new Date().toISOString();
-    const agentTableName = quoteIdentifier(`${options.tablePrefix}Agent`);
-    const agentHistoryTableName = quoteIdentifier(`${options.tablePrefix}AgentHistory`);
-
-    await client.query(
-        `
-            INSERT INTO ${agentTableName} (
-                "agentName",
-                "createdAt",
-                "updatedAt",
-                "permanentId",
-                "agentHash",
-                "agentSource",
-                "agentProfile",
-                "promptbookEngineVersion",
-                "usage",
-                "visibility"
-            )
-            VALUES ($1, $2, $3, $4, $5, $6, $7::jsonb, $8, $9::jsonb, $10)
-        `,
-        [
-            preparedAgentSource.agentProfile.agentName,
-            createdAt,
-            null,
-            permanentId,
-            preparedAgentSource.agentProfile.agentHash,
-            preparedAgentSource.agentSource,
-            JSON.stringify(preparedAgentSource.agentProfile),
-            PROMPTBOOK_ENGINE_VERSION,
-            JSON.stringify(ZERO_USAGE),
-            options.defaultVisibility,
-        ],
-    );
-
-    await client.query(
-        `
-            INSERT INTO ${agentHistoryTableName} (
-                "createdAt",
-                "agentName",
-                "permanentId",
-                "agentHash",
-                "previousAgentHash",
-                "agentSource",
-                "promptbookEngineVersion",
-                "versionName"
-            )
-            VALUES ($1, $2, $3, $4, $5, $6, $7, $8)
-        `,
-        [
-            createdAt,
-            preparedAgentSource.agentProfile.agentName,
-            permanentId,
-            preparedAgentSource.agentProfile.agentHash,
-            null,
-            preparedAgentSource.agentSource,
-            PROMPTBOOK_ENGINE_VERSION,
-            null,
-        ],
-    );
-
-    return permanentId;
-}
-
-/**
- * Stores the resolved local permanent id back into the sync-state table.
- *
- * @param client - Transaction-bound PostgreSQL client.
- * @param tablePrefix - Current server table prefix.
- * @param normalizedName - Stable normalized lookup key.
- * @param localPermanentId - Local permanent id to store.
- */
-async function updateDefaultFederatedAgentLocalPermanentId(
-    client: PoolClient,
-    tablePrefix: string,
-    normalizedName: string,
-    localPermanentId: string,
-): Promise<void> {
-    const syncTableName = quoteIdentifier(`${tablePrefix}${DEFAULT_FEDERATED_AGENT_TABLE_BASENAME}`);
-
-    await client.query(
-        `
-            UPDATE ${syncTableName}
-            SET
-                "localPermanentId" = $2,
-                "updatedAt" = now()
-            WHERE "normalizedName" = $1
-        `,
-        [normalizedName, localPermanentId],
-    );
-}

package/apps/agents-server/src/utils/defaultFederatedAgents/fetchCoreOrganizationPayload.ts

@@ -1,39 +0,0 @@
-import { spaceTrim } from '@promptbook-local/utils';
-import { DatabaseError } from '../../../../../src/errors/DatabaseError';
-import type { FederatedOrganizationPayload } from './selectDefaultFederatedAgentsFromOrganizationPayload';
-import { fetchWithDefaultFederatedAgentTimeout } from './fetchWithDefaultFederatedAgentTimeout';
-
-/**
- * Fetches the Core public organization snapshot.
- *
- * @param coreServerUrl - Base URL of the Core server.
- * @returns Parsed organization payload.
- *
- * @private internal utility of `scheduleDefaultFederatedAgentsSync`
- */
-export async function fetchCoreOrganizationPayload(coreServerUrl: string): Promise<FederatedOrganizationPayload> {
-    const endpoint = new URL('/api/agent-organization', ensureTrailingSlash(coreServerUrl)).href;
-    const response = await fetchWithDefaultFederatedAgentTimeout(endpoint);
-
-    if (!response.ok) {
-        throw new DatabaseError(
-            spaceTrim(`
-                Failed to fetch default federated agents metadata from \`${endpoint}\`.
-
-                Received \`${response.status} ${response.statusText}\`.
-            `),
-        );
-    }
-
-    return (await response.json()) as FederatedOrganizationPayload;
-}
-
-/**
- * Normalizes a server base URL so relative `URL` construction stays predictable.
- *
- * @param value - Raw base URL.
- * @returns Base URL with exactly one trailing slash.
- */
-function ensureTrailingSlash(value: string): string {
-    return `${value.replace(/\/+$/g, '')}/`;
-}

package/apps/agents-server/src/utils/defaultFederatedAgents/fetchFederatedAgentBook.ts

@@ -1,43 +0,0 @@
-import { spaceTrim } from '@promptbook-local/utils';
-import type { string_book } from '../../../../../src/book-2.0/agent-source/string_book';
-import { DatabaseError } from '../../../../../src/errors/DatabaseError';
-import { fetchWithDefaultFederatedAgentTimeout } from './fetchWithDefaultFederatedAgentTimeout';
-
-/**
- * Fetches the effective book source of one remote public agent.
- *
- * @param agentRouteUrl - Canonical remote agent route.
- * @returns Remote book content as plain text.
- *
- * @private internal utility of `scheduleDefaultFederatedAgentsSync`
- */
-export async function fetchFederatedAgentBook(agentRouteUrl: string): Promise<string_book> {
-    const endpoint = buildFederatedAgentBookUrl(agentRouteUrl);
-    const response = await fetchWithDefaultFederatedAgentTimeout(endpoint);
-
-    if (!response.ok) {
-        throw new DatabaseError(
-            spaceTrim(`
-                Failed to fetch default federated agent source from \`${endpoint}\`.
-
-                Received \`${response.status} ${response.statusText}\`.
-            `),
-        );
-    }
-
-    return (await response.text()) as string_book;
-}
-
-/**
- * Builds the public book endpoint URL for one remote agent route.
- *
- * @param agentRouteUrl - Canonical remote agent route.
- * @returns Absolute remote `/api/book` URL.
- */
-function buildFederatedAgentBookUrl(agentRouteUrl: string): string {
-    const routeUrl = new URL(agentRouteUrl);
-    routeUrl.search = '';
-    routeUrl.hash = '';
-    routeUrl.pathname = `${routeUrl.pathname.replace(/\/+$/g, '')}/api/book`;
-    return routeUrl.href;
-}