@promptbook/cli 0.112.0-99 → 0.113.0-0

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

@@ -1,28 +0,0 @@
-/**
- * Timeout used for remote Core HTTP requests.
- */
-const DEFAULT_FEDERATED_AGENT_FETCH_TIMEOUT_MS = 10_000;
-
-/**
- * Executes one HTTP request with a fixed abort timeout.
- *
- * @param url - Absolute request URL.
- * @returns Successful or unsuccessful fetch response.
- *
- * @private internal utility of `scheduleDefaultFederatedAgentsSync`
- */
-export async function fetchWithDefaultFederatedAgentTimeout(url: string): Promise<Response> {
-    const abortController = new AbortController();
-    const timeout = setTimeout(() => abortController.abort(), DEFAULT_FEDERATED_AGENT_FETCH_TIMEOUT_MS);
-
-    try {
-        return await fetch(url, {
-            method: 'GET',
-            cache: 'no-store',
-            headers: { Accept: 'application/json, text/plain;q=0.9, */*;q=0.1' },
-            signal: abortController.signal,
-        });
-    } finally {
-        clearTimeout(timeout);
-    }
-}

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

@@ -1,38 +0,0 @@
-import { spaceTrim } from '@promptbook-local/utils';
-import { Pool } from 'pg';
-import { DatabaseError } from '../../../../../src/errors/DatabaseError';
-import { resolveDatabaseMigrationConnectionStringFromEnvironment } from '../../database/runDatabaseMigrations';
-
-/**
- * Shared PostgreSQL pool reused by default-agent sync helpers.
- */
-let defaultFederatedAgentSyncPool: Pool | null = null;
-
-/**
- * Resolves the shared PostgreSQL pool used by this feature.
- *
- * @returns Shared PostgreSQL pool.
- *
- * @private internal utility of `scheduleDefaultFederatedAgentsSync`
- */
-export function getDefaultFederatedAgentSyncPool(): Pool {
-    if (defaultFederatedAgentSyncPool) {
-        return defaultFederatedAgentSyncPool;
-    }
-
-    const connectionString = resolveDatabaseMigrationConnectionStringFromEnvironment();
-    if (!connectionString) {
-        throw new DatabaseError(
-            spaceTrim(`
-                Cannot synchronize default federated agents because \`POSTGRES_URL\` or \`DATABASE_URL\` is missing.
-            `),
-        );
-    }
-
-    defaultFederatedAgentSyncPool = new Pool({
-        connectionString,
-        ssl: { rejectUnauthorized: false },
-    });
-
-    return defaultFederatedAgentSyncPool;
-}

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

@@ -1,41 +0,0 @@
-import type { Pool } from 'pg';
-import { normalizeAgentName } from '../../../../../src/book-2.0/agent-source/normalizeAgentName';
-import { quoteIdentifier } from './quoteIdentifier';
-
-/**
- * Loads active local agents and indexes them by normalized name.
- *
- * @param pool - Shared PostgreSQL pool.
- * @param tablePrefix - Current server table prefix.
- * @returns Normalized-name lookup of active local permanent ids.
- *
- * @private internal utility of `scheduleDefaultFederatedAgentsSync`
- */
-export async function loadActiveLocalAgentIdsByNormalizedName(
-    pool: Pool,
-    tablePrefix: string,
-): Promise<Map<string, string>> {
-    const agentTableName = quoteIdentifier(`${tablePrefix}Agent`);
-    const result = await pool.query<{ agentName: string; permanentId: string | null }>(
-        `
-            SELECT "agentName", "permanentId"
-            FROM ${agentTableName}
-            WHERE "deletedAt" IS NULL
-            ORDER BY "createdAt" ASC
-        `,
-    );
-
-    const activeAgentsByNormalizedName = new Map<string, string>();
-    for (const row of result.rows) {
-        if (!row.permanentId) {
-            continue;
-        }
-
-        const normalizedName = normalizeAgentName(row.agentName);
-        if (!activeAgentsByNormalizedName.has(normalizedName)) {
-            activeAgentsByNormalizedName.set(normalizedName, row.permanentId);
-        }
-    }
-
-    return activeAgentsByNormalizedName;
-}

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

@@ -1,76 +0,0 @@
-import type { Pool } from 'pg';
-import {
-    DEFAULT_AGENT_VISIBILITY,
-    DEFAULT_VISIBILITY_METADATA_KEY,
-    LEGACY_DEFAULT_VISIBILITY_METADATA_KEY,
-    parseAgentVisibility,
-    type AgentVisibility,
-} from '../agentVisibility';
-import { quoteIdentifier } from './quoteIdentifier';
-
-/**
- * Metadata key storing the canonical Core server URL.
- */
-const CORE_SERVER_METADATA_KEY = 'CORE_SERVER';
-
-/**
- * Loads the small metadata subset needed by the sync logic.
- *
- * @param pool - Shared PostgreSQL pool.
- * @param tablePrefix - Current server table prefix.
- * @returns Core server URL and effective default visibility.
- *
- * @private internal utility of `scheduleDefaultFederatedAgentsSync`
- */
-export async function loadDefaultFederatedAgentSyncMetadata(
-    pool: Pool,
-    tablePrefix: string,
-): Promise<{ coreServerUrl: string | null; defaultVisibility: AgentVisibility }> {
-    const metadataTableName = quoteIdentifier(`${tablePrefix}Metadata`);
-    const result = await pool.query<{ key: string; value: string | null }>(
-        `
-            SELECT "key", "value"
-            FROM ${metadataTableName}
-            WHERE "key" = ANY($1)
-        `,
-        [[CORE_SERVER_METADATA_KEY, DEFAULT_VISIBILITY_METADATA_KEY, LEGACY_DEFAULT_VISIBILITY_METADATA_KEY]],
-    );
-
-    const metadataByKey = new Map<string, string | null>();
-    for (const row of result.rows) {
-        metadataByKey.set(row.key, row.value);
-    }
-
-    return {
-        coreServerUrl: normalizeOptionalServerUrl(metadataByKey.get(CORE_SERVER_METADATA_KEY) || null),
-        defaultVisibility: parseAgentVisibility(
-            metadataByKey.get(DEFAULT_VISIBILITY_METADATA_KEY) || metadataByKey.get(LEGACY_DEFAULT_VISIBILITY_METADATA_KEY),
-            DEFAULT_AGENT_VISIBILITY,
-        ),
-    };
-}
-
-/**
- * Normalizes an optional server URL so equality checks ignore trailing slashes.
- *
- * @param value - Raw server URL.
- * @returns Normalized URL or `null`.
- */
-function normalizeOptionalServerUrl(value: string | null): string | null {
-    if (!value) {
-        return null;
-    }
-
-    const normalizedValue = value.trim();
-    return normalizedValue === '' ? null : ensureTrailingSlash(normalizedValue);
-}
-
-/**
- * Ensures a server base URL always ends with a single slash.
- *
- * @param value - Raw server URL.
- * @returns Base URL with one trailing slash.
- */
-function ensureTrailingSlash(value: string): string {
-    return `${value.replace(/\/+$/g, '')}/`;
-}

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

@@ -1,11 +0,0 @@
-/**
- * Quotes one PostgreSQL identifier safely.
- *
- * @param identifier - Raw SQL identifier.
- * @returns Quoted identifier.
- *
- * @private internal utility of `scheduleDefaultFederatedAgentsSync`
- */
-export function quoteIdentifier(identifier: string): string {
-    return `"${identifier.replace(/"/g, '""')}"`;
-}

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

@@ -1,88 +0,0 @@
-import type { DefaultFederatedAgentsSyncOptions } from './DefaultFederatedAgentsSyncOptions';
-import { synchronizeDefaultFederatedAgents } from './synchronizeDefaultFederatedAgents';
-
-/**
- * Interval between best-effort background sync attempts for one server prefix.
- */
-const DEFAULT_FEDERATED_AGENT_SYNC_INTERVAL_MS = 5 * 60_000;
-
-/**
- * In-memory scheduling state for one server prefix.
- */
-type DefaultFederatedAgentSyncState = {
-    /**
-     * Currently running sync promise, if any.
-     */
-    runningPromise: Promise<void> | null;
-    /**
-     * Timestamp of the most recent sync attempt.
-     */
-    lastAttemptAt: number | null;
-};
-
-/**
- * Active best-effort sync scheduling state keyed by server table prefix.
- */
-const defaultFederatedAgentSyncStateByTablePrefix = new Map<string, DefaultFederatedAgentSyncState>();
-
-/**
- * Schedules a best-effort background synchronization of default Core boilerplate agents.
- *
- * The task is throttled per server prefix and intentionally never throws to callers.
- *
- * @param options - Current server context needed for background sync.
- *
- * @private shared utility for Agents Server
- */
-export function scheduleDefaultFederatedAgentsSync(options: DefaultFederatedAgentsSyncOptions): void {
-    if (shouldDisableDefaultFederatedAgentsSync()) {
-        return;
-    }
-
-    const state = getDefaultFederatedAgentSyncState(options.tablePrefix);
-    if (state.runningPromise) {
-        return;
-    }
-
-    if (state.lastAttemptAt !== null && Date.now() - state.lastAttemptAt < DEFAULT_FEDERATED_AGENT_SYNC_INTERVAL_MS) {
-        return;
-    }
-
-    state.lastAttemptAt = Date.now();
-    state.runningPromise = synchronizeDefaultFederatedAgents(options)
-        .catch((error) => {
-            console.error('[default-federated-agents] Sync failed:', error);
-        })
-        .finally(() => {
-            state.runningPromise = null;
-        });
-}
-
-/**
- * Reads or creates the in-memory scheduling state for one server prefix.
- *
- * @param tablePrefix - Current server table prefix.
- * @returns Mutable scheduling state.
- */
-function getDefaultFederatedAgentSyncState(tablePrefix: string): DefaultFederatedAgentSyncState {
-    let state = defaultFederatedAgentSyncStateByTablePrefix.get(tablePrefix);
-
-    if (!state) {
-        state = {
-            runningPromise: null,
-            lastAttemptAt: null,
-        };
-        defaultFederatedAgentSyncStateByTablePrefix.set(tablePrefix, state);
-    }
-
-    return state;
-}
-
-/**
- * Returns `true` when background sync should stay disabled in the current runtime.
- *
- * @returns Whether background sync should be skipped.
- */
-function shouldDisableDefaultFederatedAgentsSync(): boolean {
-    return process.env.NODE_ENV === 'test' || typeof process.env.JEST_WORKER_ID !== 'undefined';
-}

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

@@ -1,181 +0,0 @@
-import { buildFolderTree, collectDescendantFolderIds } from '../agentOrganization/folderTree';
-import { normalizeAgentName } from '../../../../../src/book-2.0/agent-source/normalizeAgentName';
-
-/**
- * Normalized name of the Core folder that defines canonical boilerplate agents.
- */
-const DEFAULT_CORE_BOILERPLATE_FOLDER_NAME = 'default';
-
-/**
- * Minimal agent shape returned by the public organization snapshot.
- */
-export type FederatedOrganizationAgentSnapshot = {
-    /**
-     * Agent name shown by the remote server.
-     */
-    readonly agentName: string;
-    /**
-     * Stable remote permanent id, when available.
-     */
-    readonly permanentId?: string | null;
-    /**
-     * Public route URL of the remote agent, when provided by the source server.
-     */
-    readonly url?: string;
-    /**
-     * Folder placement on the remote server.
-     */
-    readonly folderId: number | null;
-};
-
-/**
- * Minimal folder shape returned by the public organization snapshot.
- */
-export type FederatedOrganizationFolderSnapshot = {
-    /**
-     * Folder identifier on the remote server.
-     */
-    readonly id: number;
-    /**
-     * Folder label.
-     */
-    readonly name: string;
-    /**
-     * Parent folder identifier, or `null` for root.
-     */
-    readonly parentId: number | null;
-};
-
-/**
- * Public organization payload shape consumed from Core.
- */
-export type FederatedOrganizationPayload = {
-    /**
-     * Whether the remote endpoint reported success.
-     */
-    readonly success?: boolean;
-    /**
-     * Public agents visible in the organization snapshot.
-     */
-    readonly agents?: ReadonlyArray<FederatedOrganizationAgentSnapshot>;
-    /**
-     * Public folders visible in the organization snapshot.
-     */
-    readonly folders?: ReadonlyArray<FederatedOrganizationFolderSnapshot>;
-};
-
-/**
- * Normalized remote default-agent candidate resolved from the Core organization snapshot.
- */
-export type DefaultFederatedAgentCandidate = {
-    /**
-     * Stable normalized name used for cross-server matching.
-     */
-    readonly normalizedName: string;
-    /**
-     * Human-readable name exposed by the Core server.
-     */
-    readonly sourceAgentName: string;
-    /**
-     * Remote canonical identifier (`permanentId` when available, otherwise `agentName`).
-     */
-    readonly sourceAgentIdentifier: string;
-    /**
-     * Remote canonical route URL of the agent.
-     */
-    readonly sourceAgentUrl: string;
-};
-
-/**
- * Selects agents that belong to the Core `default` folder subtree.
- *
- * The result is deduplicated by normalized name so matching stays stable across servers
- * even when the remote payload contains aliases or repeated entries.
- *
- * @param payload - Public organization payload fetched from Core.
- * @param coreServerUrl - Base URL of the Core server.
- * @returns Canonical default-agent candidates keyed by normalized name.
- */
-export function selectDefaultFederatedAgentsFromOrganizationPayload(
-    payload: FederatedOrganizationPayload,
-    coreServerUrl: string,
-): Array<DefaultFederatedAgentCandidate> {
-    const folders = Array.isArray(payload.folders) ? payload.folders : [];
-    const agents = Array.isArray(payload.agents) ? payload.agents : [];
-    const defaultFolderIds = resolveDefaultFolderIds(folders);
-    const candidatesByNormalizedName = new Map<string, DefaultFederatedAgentCandidate>();
-
-    for (const agent of agents) {
-        if (agent.folderId === null || !defaultFolderIds.has(agent.folderId)) {
-            continue;
-        }
-
-        const normalizedName = normalizeAgentName(agent.agentName);
-        if (candidatesByNormalizedName.has(normalizedName)) {
-            continue;
-        }
-
-        const sourceAgentIdentifier = agent.permanentId || agent.agentName;
-        candidatesByNormalizedName.set(normalizedName, {
-            normalizedName,
-            sourceAgentName: agent.agentName,
-            sourceAgentIdentifier,
-            sourceAgentUrl: resolveFederatedAgentRouteUrl(coreServerUrl, sourceAgentIdentifier, agent.url),
-        });
-    }
-
-    return Array.from(candidatesByNormalizedName.values());
-}
-
-/**
- * Resolves the full set of folder ids that belong to the remote `default` subtree.
- *
- * @param folders - Public folders exposed by the remote server.
- * @returns Folder ids of all matching `default` roots plus their descendants.
- */
-function resolveDefaultFolderIds(folders: ReadonlyArray<FederatedOrganizationFolderSnapshot>): Set<number> {
-    const { childrenByParentId } = buildFolderTree([...folders]);
-    const defaultFolderIds = new Set<number>();
-
-    for (const folder of folders) {
-        if (normalizeAgentName(folder.name) !== DEFAULT_CORE_BOILERPLATE_FOLDER_NAME) {
-            continue;
-        }
-
-        for (const descendantId of collectDescendantFolderIds(folder.id, childrenByParentId)) {
-            defaultFolderIds.add(descendantId);
-        }
-    }
-
-    return defaultFolderIds;
-}
-
-/**
- * Builds a stable public route URL for one remote agent.
- *
- * @param coreServerUrl - Base URL of the Core server.
- * @param sourceAgentIdentifier - Canonical remote identifier.
- * @param sourceAgentUrl - Optional URL already provided by the remote payload.
- * @returns Absolute agent route URL.
- */
-function resolveFederatedAgentRouteUrl(
-    coreServerUrl: string,
-    sourceAgentIdentifier: string,
-    sourceAgentUrl?: string,
-): string {
-    if (typeof sourceAgentUrl === 'string' && sourceAgentUrl.trim() !== '') {
-        return sourceAgentUrl;
-    }
-
-    return new URL(`/agents/${encodeURIComponent(sourceAgentIdentifier)}`, ensureTrailingSlash(coreServerUrl)).href;
-}
-
-/**
- * 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/synchronizeDefaultFederatedAgents.ts

@@ -1,77 +0,0 @@
-import type { DefaultFederatedAgentsSyncOptions } from './DefaultFederatedAgentsSyncOptions';
-import { ensureDefaultFederatedAgentExists } from './ensureDefaultFederatedAgentExists';
-import { fetchCoreOrganizationPayload } from './fetchCoreOrganizationPayload';
-import { fetchFederatedAgentBook } from './fetchFederatedAgentBook';
-import { getDefaultFederatedAgentSyncPool } from './getDefaultFederatedAgentSyncPool';
-import { loadActiveLocalAgentIdsByNormalizedName } from './loadActiveLocalAgentIdsByNormalizedName';
-import { loadDefaultFederatedAgentSyncMetadata } from './loadDefaultFederatedAgentSyncMetadata';
-import { selectDefaultFederatedAgentsFromOrganizationPayload } from './selectDefaultFederatedAgentsFromOrganizationPayload';
-
-/**
- * Runs one synchronization pass for the given server prefix.
- *
- * @param options - Current server context.
- *
- * @private internal utility of `scheduleDefaultFederatedAgentsSync`
- */
-export async function synchronizeDefaultFederatedAgents(
-    options: DefaultFederatedAgentsSyncOptions,
-): Promise<void> {
-    const pool = getDefaultFederatedAgentSyncPool();
-    const syncMetadata = await loadDefaultFederatedAgentSyncMetadata(pool, options.tablePrefix);
-    const coreServerUrl = syncMetadata.coreServerUrl;
-
-    if (!coreServerUrl) {
-        return;
-    }
-
-    if (normalizeServerUrl(coreServerUrl) === normalizeServerUrl(options.localServerUrl)) {
-        return;
-    }
-
-    const organizationPayload = await fetchCoreOrganizationPayload(coreServerUrl);
-    const defaultAgentCandidates = selectDefaultFederatedAgentsFromOrganizationPayload(organizationPayload, coreServerUrl);
-    if (defaultAgentCandidates.length === 0) {
-        return;
-    }
-
-    const activeLocalAgentIdsByNormalizedName = await loadActiveLocalAgentIdsByNormalizedName(pool, options.tablePrefix);
-
-    for (const candidate of defaultAgentCandidates) {
-        if (activeLocalAgentIdsByNormalizedName.has(candidate.normalizedName)) {
-            continue;
-        }
-
-        const remoteAgentSource = await fetchFederatedAgentBook(candidate.sourceAgentUrl);
-        const createdAgentPermanentId = await ensureDefaultFederatedAgentExists({
-            pool,
-            tablePrefix: options.tablePrefix,
-            defaultVisibility: syncMetadata.defaultVisibility,
-            candidate,
-            remoteAgentSource,
-        });
-
-        activeLocalAgentIdsByNormalizedName.set(candidate.normalizedName, createdAgentPermanentId);
-    }
-}
-
-/**
- * Normalizes a server URL for equality checks.
- *
- * @param value - Raw server URL.
- * @returns Stable URL string without a trailing slash.
- */
-function normalizeServerUrl(value: string): string {
-    const parsedUrl = new URL(ensureTrailingSlash(value));
-    return parsedUrl.href.replace(/\/+$/g, '');
-}
-
-/**
- * Ensures a server base URL always ends with a single slash.
- *
- * @param value - Raw server URL.
- * @returns Base URL with one trailing slash.
- */
-function ensureTrailingSlash(value: string): string {
-    return `${value.replace(/\/+$/g, '')}/`;
-}