@promptbook/cli 0.113.0-8 → 0.114.0-0

package/apps/agents-server/src/components/Homepage/useAgentsGraphDownloadState.ts

@@ -1,214 +0,0 @@
-'use client';
-
-import { toPng, toSvg } from 'html-to-image';
-import { useCallback, type MutableRefObject } from 'react';
-import { showAlert } from '../AsyncDialogs/asyncDialogs';
-import { buildAsciiGraph, type GraphData, type ServerGroup } from './buildGraphData';
-
-/**
- * Prefix used in graph export filenames.
- *
- * @private function of AgentsGraph
- */
-const GRAPH_DOWNLOAD_PREFIX = 'agents-graph';
-
-/**
- * Canvas background color used in PNG/SVG exports.
- *
- * @private function of AgentsGraph
- */
-const GRAPH_EXPORT_BACKGROUND = '#f8fafc';
-
-/**
- * Arguments required to export a rendered graph image.
- *
- * @private function of AgentsGraph
- */
-type ExportGraphImageProps = {
-    extension: 'png' | 'svg';
-    graphWrapperElement: HTMLDivElement;
-    createDataUrl: (graphWrapperElement: HTMLDivElement) => Promise<string>;
-    failureMessage: string;
-};
-
-/**
- * Inputs consumed by the private graph-download hook.
- *
- * @private function of AgentsGraph
- */
-type UseAgentsGraphDownloadStateProps = {
-    readonly graphData: GraphData;
-    readonly graphWrapperRef: MutableRefObject<HTMLDivElement | null>;
-    readonly serverGroups: ServerGroup[];
-};
-
-/**
- * Download handlers returned to the private graph facade.
- *
- * @private function of AgentsGraph
- */
-type UseAgentsGraphDownloadStateResult = {
-    readonly isDownloadAvailable: boolean;
-    readonly handleDownloadPng: () => Promise<void>;
-    readonly handleDownloadSvg: () => Promise<void>;
-    readonly handleDownloadAscii: () => void;
-};
-
-/**
- * Build a timestamped filename for graph downloads.
- *
- * @private function of AgentsGraph
- */
-function buildGraphFilename(extension: string): string {
-    const timestamp = new Date().toISOString().replace(/[:]/g, '-');
-    return `${GRAPH_DOWNLOAD_PREFIX}-${timestamp}.${extension}`;
-}
-
-/**
- * Trigger a browser download for the provided blob payload.
- *
- * @private function of AgentsGraph
- */
-function triggerBlobDownload(blob: Blob, filename: string): void {
-    const url = URL.createObjectURL(blob);
-    const link = document.createElement('a');
-    link.href = url;
-    link.download = filename;
-    link.rel = 'noopener';
-    document.body.appendChild(link);
-    link.click();
-    link.remove();
-    URL.revokeObjectURL(url);
-}
-
-/**
- * Convert a data URL into a blob.
- *
- * @private function of AgentsGraph
- */
-async function dataUrlToBlob(dataUrl: string): Promise<Blob> {
-    const response = await fetch(dataUrl);
-    return response.blob();
-}
-
-/**
- * Determine whether a DOM node should be included in image exports.
- *
- * @private function of AgentsGraph
- */
-function shouldExportNode(node: HTMLElement): boolean {
-    if (node.dataset?.exportExclude === 'true') {
-        return false;
-    }
-
-    if (node.classList?.contains('react-flow__panel')) {
-        return false;
-    }
-
-    return true;
-}
-
-/**
- * Build the PNG data URL for the rendered graph.
- *
- * @private function of AgentsGraph
- */
-function buildPngGraphDataUrl(graphWrapperElement: HTMLDivElement): Promise<string> {
-    return toPng(graphWrapperElement, {
-        backgroundColor: GRAPH_EXPORT_BACKGROUND,
-        filter: (node) => shouldExportNode(node as HTMLElement),
-        pixelRatio: Math.max(window.devicePixelRatio || 1, 2),
-    });
-}
-
-/**
- * Build the SVG data URL for the rendered graph.
- *
- * @private function of AgentsGraph
- */
-function buildSvgGraphDataUrl(graphWrapperElement: HTMLDivElement): Promise<string> {
-    return toSvg(graphWrapperElement, {
-        backgroundColor: GRAPH_EXPORT_BACKGROUND,
-        filter: (node) => shouldExportNode(node as HTMLElement),
-    });
-}
-
-/**
- * Export the current graph image and surface a targeted error when it fails.
- *
- * @private function of AgentsGraph
- */
-async function exportGraphImage({
-    extension,
-    graphWrapperElement,
-    createDataUrl,
-    failureMessage,
-}: ExportGraphImageProps): Promise<void> {
-    try {
-        const dataUrl = await createDataUrl(graphWrapperElement);
-        const blob = await dataUrlToBlob(dataUrl);
-        triggerBlobDownload(blob, buildGraphFilename(extension));
-    } catch (error) {
-        console.error(`Failed to export graph as ${extension.toUpperCase()}.`, error);
-        await showAlert({
-            title: 'Export failed',
-            message: failureMessage,
-        }).catch(() => undefined);
-    }
-}
-
-/**
- * Compose download/export handlers so graph exporting stays separate from graph layout state.
- *
- * @param props - Current graph data, grouping, and canvas ref.
- * @returns Download availability and file-export handlers for the graph toolbar.
- *
- * @private function of AgentsGraph
- */
-export function useAgentsGraphDownloadState(
-    props: UseAgentsGraphDownloadStateProps,
-): UseAgentsGraphDownloadStateResult {
-    const { graphData, graphWrapperRef, serverGroups } = props;
-    const isDownloadAvailable = graphData.nodes.length > 0;
-
-    const handleDownloadPng = useCallback(async () => {
-        const graphWrapperElement = graphWrapperRef.current;
-        if (!graphWrapperElement) {
-            return;
-        }
-
-        await exportGraphImage({
-            extension: 'png',
-            graphWrapperElement,
-            createDataUrl: buildPngGraphDataUrl,
-            failureMessage: 'Failed to export PNG. Try downloading the SVG instead.',
-        });
-    }, [graphWrapperRef]);
-
-    const handleDownloadSvg = useCallback(async () => {
-        const graphWrapperElement = graphWrapperRef.current;
-        if (!graphWrapperElement) {
-            return;
-        }
-
-        await exportGraphImage({
-            extension: 'svg',
-            graphWrapperElement,
-            createDataUrl: buildSvgGraphDataUrl,
-            failureMessage: 'Failed to export SVG. Try downloading the PNG instead.',
-        });
-    }, [graphWrapperRef]);
-
-    const handleDownloadAscii = useCallback(() => {
-        const ascii = buildAsciiGraph(graphData, serverGroups);
-        const blob = new Blob([ascii], { type: 'text/plain;charset=utf-8' });
-        triggerBlobDownload(blob, buildGraphFilename('txt'));
-    }, [graphData, serverGroups]);
-
-    return {
-        isDownloadAvailable,
-        handleDownloadPng,
-        handleDownloadSvg,
-        handleDownloadAscii,
-    };
-}

package/apps/agents-server/src/components/Homepage/useAgentsGraphQueryState.ts

@@ -1,214 +0,0 @@
-'use client';
-
-import { useSearchParams } from 'next/navigation';
-import { useCallback, useState } from 'react';
-import { useCurrentPathQueryNavigation } from '../_utils/useCurrentPathQueryNavigation';
-import { CONNECTION_TYPES, normalizeServerUrl, parseConnectionTypes, type ConnectionType } from './buildGraphData';
-
-/**
- * Fixed view query parameter for the graph tab.
- *
- * @private function of AgentsGraph
- */
-const GRAPH_VIEW_MODE = 'graph';
-
-/**
- * Minimal search params interface used by graph URL helpers.
- *
- * @private function of AgentsGraph
- */
-type SearchParamsSnapshot = Pick<URLSearchParams, 'get' | 'toString'>;
-
-/**
- * Server/agent selection encoded in the graph URL and `<select>` control.
- *
- * @private function of AgentsGraph
- */
-type AgentsGraphSelection = {
-    selectedServerUrl: string | null;
-    selectedAgentName: string | null;
-};
-
-/**
- * Query-backed filter and focus state used by the private graph facade.
- *
- * @private function of AgentsGraph
- */
-type UseAgentsGraphQueryStateResult = {
-    readonly filterType: ConnectionType[];
-    readonly selectedServerUrl: string | null;
-    readonly selectedAgentName: string | null;
-    readonly toggleFilter: (type: ConnectionType) => void;
-    readonly selectServerAndAgent: (value: string) => void;
-};
-
-/**
- * Read the initial selected server from the current URL query params.
- *
- * @private function of AgentsGraph
- */
-function readInitialSelectedServerUrl(searchParams: SearchParamsSnapshot): string | null {
-    const selectedServer = searchParams.get('selectedServer');
-
-    if (!selectedServer) {
-        return null;
-    }
-
-    if (selectedServer === 'ALL') {
-        return 'ALL';
-    }
-
-    return normalizeServerUrl(selectedServer);
-}
-
-/**
- * Build the next graph search params from the current query string and selection state.
- *
- * @private function of AgentsGraph
- */
-function buildUpdatedGraphSearchParams(
-    searchParamsString: string,
-    connectionTypes: ReadonlyArray<ConnectionType>,
-    selectedServerUrl: string | null,
-    selectedAgentName: string | null,
-): URLSearchParams {
-    const params = new URLSearchParams(searchParamsString);
-
-    if (connectionTypes.length === CONNECTION_TYPES.length) {
-        params.delete('connectionTypes');
-    } else {
-        params.set('connectionTypes', connectionTypes.join(','));
-    }
-
-    if (selectedServerUrl) {
-        params.set('selectedServer', selectedServerUrl);
-    } else {
-        params.delete('selectedServer');
-    }
-
-    if (selectedAgentName) {
-        params.set('selectedAgent', selectedAgentName);
-    } else {
-        params.delete('selectedAgent');
-    }
-
-    params.set('view', GRAPH_VIEW_MODE);
-
-    return params;
-}
-
-/**
- * Decode the select-control value into a server/agent selection.
- *
- * @private function of AgentsGraph
- */
-function resolveGraphSelection(value: string): AgentsGraphSelection {
-    if (value === '') {
-        return {
-            selectedServerUrl: null,
-            selectedAgentName: null,
-        };
-    }
-
-    if (value === 'ALL') {
-        return {
-            selectedServerUrl: 'ALL',
-            selectedAgentName: null,
-        };
-    }
-
-    if (value.startsWith('SERVER:')) {
-        return {
-            selectedServerUrl: normalizeServerUrl(value.replace('SERVER:', '')),
-            selectedAgentName: null,
-        };
-    }
-
-    const [serverUrl, agentName] = value.split('|');
-
-    return {
-        selectedServerUrl: normalizeServerUrl(serverUrl || ''),
-        selectedAgentName: agentName || null,
-    };
-}
-
-/**
- * Toggle one connection type while preserving the current filter order.
- *
- * @private function of AgentsGraph
- */
-function toggleConnectionType(
-    connectionTypes: ReadonlyArray<ConnectionType>,
-    toggledType: ConnectionType,
-): ConnectionType[] {
-    if (connectionTypes.includes(toggledType)) {
-        return connectionTypes.filter((connectionType) => connectionType !== toggledType);
-    }
-
-    return [...connectionTypes, toggledType];
-}
-
-/**
- * Own the graph filter/query state so the public graph hook can stay focused on composition.
- *
- * @returns Query-backed filter state and update handlers for the graph toolbar.
- *
- * @private function of AgentsGraph
- */
-export function useAgentsGraphQueryState(): UseAgentsGraphQueryStateResult {
-    const searchParams = useSearchParams();
-    const updateCurrentPathQuery = useCurrentPathQueryNavigation();
-    const [filterType, setFilterType] = useState<ConnectionType[]>(
-        parseConnectionTypes(searchParams?.get('connectionTypes') ?? null),
-    );
-    const [selectedServerUrl, setSelectedServerUrl] = useState<string | null>(() =>
-        readInitialSelectedServerUrl(searchParams ?? new URLSearchParams()),
-    );
-    const [selectedAgentName, setSelectedAgentName] = useState<string | null>(
-        searchParams?.get('selectedAgent') || null,
-    );
-
-    const updateUrl = useCallback(
-        (
-            nextFilterType: ConnectionType[],
-            nextSelectedServerUrl: string | null,
-            nextSelectedAgentName: string | null,
-        ) => {
-            const params = buildUpdatedGraphSearchParams(
-                searchParams?.toString() ?? '',
-                nextFilterType,
-                nextSelectedServerUrl,
-                nextSelectedAgentName,
-            );
-            updateCurrentPathQuery(params, 'replace');
-        },
-        [searchParams, updateCurrentPathQuery],
-    );
-
-    const toggleFilter = useCallback(
-        (type: ConnectionType) => {
-            const nextFilterType = toggleConnectionType(filterType, type);
-            setFilterType(nextFilterType);
-            updateUrl(nextFilterType, selectedServerUrl, selectedAgentName);
-        },
-        [filterType, selectedAgentName, selectedServerUrl, updateUrl],
-    );
-
-    const selectServerAndAgent = useCallback(
-        (value: string) => {
-            const nextSelection = resolveGraphSelection(value);
-            setSelectedServerUrl(nextSelection.selectedServerUrl);
-            setSelectedAgentName(nextSelection.selectedAgentName);
-            updateUrl(filterType, nextSelection.selectedServerUrl, nextSelection.selectedAgentName);
-        },
-        [filterType, updateUrl],
-    );
-
-    return {
-        filterType,
-        selectedServerUrl,
-        selectedAgentName,
-        toggleFilter,
-        selectServerAndAgent,
-    };
-}

package/apps/agents-server/src/components/Homepage/useAgentsGraphState.ts

@@ -1,137 +0,0 @@
-'use client';
-
-import type { string_url } from '@promptbook-local/types';
-import { useRouter } from 'next/navigation';
-import { useCallback, useMemo } from 'react';
-import type { AgentOrganizationFolder } from '../../utils/agentOrganization/types';
-import {
-    buildFreshAgentChatHref,
-    buildFreshAgentChatHrefFromAgentUrl,
-} from '../../utils/agentRouting/agentRouteHrefs';
-import { useAgentNaming } from '../AgentNaming/AgentNamingContext';
-import {
-    buildGraphData,
-    buildGraphSummaryInfo,
-    buildServerGroups,
-    normalizeServerUrl,
-    type AgentWithVisibility,
-    type GraphNode,
-} from './buildGraphData';
-import { useAgentsGraphCanvasState } from './useAgentsGraphCanvasState';
-import { useAgentsGraphDownloadState } from './useAgentsGraphDownloadState';
-import { useAgentsGraphQueryState } from './useAgentsGraphQueryState';
-
-/**
- * Props consumed by `useAgentsGraphState`.
- *
- * @private function of AgentsGraph
- */
-type UseAgentsGraphStateProps = {
-    readonly agents: AgentWithVisibility[];
-    readonly federatedAgents: AgentWithVisibility[];
-    readonly federatedServersStatus: Record<string, { status: 'loading' | 'success' | 'error'; error?: string }>;
-    readonly publicUrl: string_url;
-    readonly folders: AgentOrganizationFolder[];
-};
-
-/**
- * Derive AgentsGraph state by composing focused private graph helpers.
- *
- * @private function of AgentsGraph
- */
-export function useAgentsGraphState(props: UseAgentsGraphStateProps) {
-    const { agents, federatedAgents, federatedServersStatus, publicUrl, folders } = props;
-    const router = useRouter();
-    const { formatText } = useAgentNaming();
-    const normalizedPublicUrl = useMemo(() => normalizeServerUrl(publicUrl), [publicUrl]);
-    const { filterType, selectedServerUrl, selectedAgentName, toggleFilter, selectServerAndAgent } =
-        useAgentsGraphQueryState();
-
-    const graphData = useMemo(
-        () =>
-            buildGraphData({
-                agents,
-                federatedAgents,
-                filterType,
-                selectedServerUrl,
-                selectedAgentName,
-                publicUrl: normalizedPublicUrl,
-            }),
-        [agents, federatedAgents, filterType, selectedServerUrl, selectedAgentName, normalizedPublicUrl],
-    );
-
-    const serverGroups = useMemo(() => {
-        const rootLabel = formatText('Agents');
-        return buildServerGroups(graphData.nodes, folders, normalizedPublicUrl, rootLabel);
-    }, [graphData.nodes, folders, normalizedPublicUrl, formatText]);
-    const graphSummary = useMemo(() => buildGraphSummaryInfo(graphData, serverGroups), [graphData, serverGroups]);
-
-    /**
-     * Opens the generic agent entry point as a fresh new chat.
-     */
-    const openGraphNode = useCallback(
-        (node: GraphNode) => {
-            const agent = node.agent;
-            if (agent.serverUrl && normalizeServerUrl(agent.serverUrl) !== normalizedPublicUrl) {
-                const remoteAgentUrl =
-                    agent.url || `${agent.serverUrl}/agents/${encodeURIComponent(agent.permanentId || agent.agentName)}`;
-                window.open(buildFreshAgentChatHrefFromAgentUrl(remoteAgentUrl), '_blank');
-                return;
-            }
-
-            router.push(buildFreshAgentChatHref(agent.permanentId || agent.agentName));
-        },
-        [router, normalizedPublicUrl],
-    );
-
-    const canvasState = useAgentsGraphCanvasState({
-        graphData,
-        normalizedPublicUrl,
-        onOpenGraphNode: openGraphNode,
-        serverGroups,
-    });
-    const downloadState = useAgentsGraphDownloadState({
-        graphData,
-        graphWrapperRef: canvasState.graphWrapperRef,
-        serverGroups,
-    });
-
-    const emptyMessage = formatText('No agents to show in graph.');
-    const hasAnyAgents = agents.length > 0 || federatedAgents.length > 0;
-
-    return {
-        emptyMessage,
-        graphSummary,
-        hasAnyAgents,
-        toolbar: {
-            agents,
-            federatedAgents,
-            federatedServersStatus,
-            filterType,
-            selectedServerUrl,
-            selectedAgentName,
-            normalizedPublicUrl,
-            isDownloadAvailable: downloadState.isDownloadAvailable,
-            formatText,
-            onToggleFilter: toggleFilter,
-            onSelectServerAndAgent: selectServerAndAgent,
-            onDownloadPng: downloadState.handleDownloadPng,
-            onDownloadSvg: downloadState.handleDownloadSvg,
-            onDownloadAscii: downloadState.handleDownloadAscii,
-        },
-        canvas: {
-            emptyMessage,
-            graphHeight: canvasState.graphHeight,
-            graphNodeCount: graphData.nodes.length,
-            graphWrapperRef: canvasState.graphWrapperRef,
-            isGraphCanvasReady: canvasState.isGraphCanvasReady,
-            displayedNodes: canvasState.displayedNodes,
-            displayedEdges: canvasState.displayedEdges,
-            onNodesChange: canvasState.onNodesChange,
-            onFlowNodeClick: canvasState.onFlowNodeClick,
-            onNodeHover: canvasState.onNodeHover,
-            onNodeDragStop: canvasState.onNodeDragStop,
-            onGraphInit: canvasState.onGraphInit,
-        },
-    };
-}

package/apps/agents-server/src/components/Skeleton/GraphLoadingSkeleton.tsx

@@ -1,50 +0,0 @@
-import { Skeleton } from './Skeleton';
-
-/**
- * Props for graph-surface placeholder rendering.
- */
-type GraphLoadingSkeletonProps = {
-    /**
-     * Height of the graph placeholder container.
-     */
-    readonly height?: number;
-    /**
-     * Whether the skeleton should fill an existing parent container.
-     */
-    readonly isInset?: boolean;
-};
-
-/**
- * Stable placeholder used while graph canvas initializes.
- */
-export function GraphLoadingSkeleton({ height = 480, isInset = false }: GraphLoadingSkeletonProps) {
-    const containerClassName = isInset
-        ? 'relative h-full w-full overflow-hidden p-4'
-        : 'relative overflow-hidden rounded-2xl border border-slate-200/80 bg-white/70 p-4 shadow-inner';
-
-    return (
-        <div
-            className={containerClassName}
-            style={isInset ? undefined : { height }}
-            role="status"
-            aria-live="polite"
-            aria-busy="true"
-            aria-label="Loading graph"
-        >
-            <div className="absolute inset-0 bg-gradient-to-br from-sky-100/40 via-transparent to-amber-100/30 blur-2xl" />
-            <div className="relative z-10 flex h-full flex-col">
-                <div className="grid grid-cols-3 gap-4">
-                    <Skeleton className="h-16 rounded-xl" />
-                    <Skeleton className="h-16 rounded-xl" />
-                    <Skeleton className="h-16 rounded-xl" />
-                </div>
-                <div className="relative mt-6 flex-1 rounded-2xl border border-slate-200/70 bg-slate-50/80">
-                    <Skeleton className="absolute left-[14%] top-[22%] h-20 w-28 rounded-2xl" />
-                    <Skeleton className="absolute left-[42%] top-[34%] h-24 w-36 rounded-2xl" />
-                    <Skeleton className="absolute left-[70%] top-[18%] h-20 w-32 rounded-2xl" />
-                    <Skeleton className="absolute left-[58%] top-[62%] h-16 w-24 rounded-2xl" />
-                </div>
-            </div>
-        </div>
-    );
-}

package/apps/agents-server/src/utils/codeRunnerConfiguration.ts

@@ -1,67 +0,0 @@
-import { execFile } from 'child_process';
-import { promisify } from 'util';
-import { listVpsEnvironmentVariables } from './vpsConfiguration';
-
-const execFileAsync = promisify(execFile);
-
-/**
- * Saved standalone VPS code-runner configuration exposed to the admin UI.
- */
-export type ConfiguredCodeRunner = {
-    /**
-     * Runner identifier persisted in `.env`.
-     */
-    readonly agent: string;
-
-    /**
-     * Model identifier persisted in `.env`.
-     */
-    readonly model: string;
-
-    /**
-     * Thinking level persisted in `.env`.
-     */
-    readonly thinkingLevel: string;
-};
-
-/**
- * Reads the currently configured standalone VPS code runner from managed environment variables.
- *
- * @returns Saved code-runner settings with fallback defaults.
- */
-export async function readConfiguredCodeRunner(): Promise<ConfiguredCodeRunner> {
-    const snapshot = await listVpsEnvironmentVariables();
-    const environmentByKey = Object.fromEntries(snapshot.variables.map((variable) => [variable.key, variable.value])) as Record<
-        string,
-        string
-    >;
-
-    return {
-        agent: environmentByKey.PTBK_HARNESS || process.env.PTBK_HARNESS || process.env.PTBK_AGENT || 'github-copilot',
-        model: environmentByKey.PTBK_MODEL || process.env.PTBK_MODEL || 'gpt-5.4',
-        thinkingLevel: environmentByKey.PTBK_THINKING_LEVEL || process.env.PTBK_THINKING_LEVEL || 'xhigh',
-    };
-}
-
-/**
- * Resolves a short runner-authentication status for the configured runner.
- *
- * @param agent - Runner id.
- * @returns Human-readable status.
- */
-export async function resolveCodeRunnerStatus(agent: string): Promise<string> {
-    if (agent !== 'github-copilot') {
-        return 'Status check is currently available for GitHub Copilot CLI only.';
-    }
-
-    try {
-        const { stdout, stderr } = await execFileAsync('copilot', ['auth', 'status'], {
-            timeout: 10_000,
-            maxBuffer: 128 * 1024,
-        });
-
-        return [stdout, stderr].filter(Boolean).join('\n').trim() || 'GitHub Copilot CLI returned no status output.';
-    } catch (error) {
-        return error instanceof Error ? error.message : 'GitHub Copilot CLI status check failed.';
-    }
-}