@promptbook/cli 0.112.0-134 → 0.112.0-136

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, '')}/`;
-}