@promptbook/cli 0.113.0-9 → 0.114.0-1

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

@@ -1,152 +0,0 @@
-import type { AgentOrganizationAgent, AgentOrganizationFolder } from '../../utils/agentOrganization/types';
-import type { AgentWithVisibility } from './useFederatedAgents';
-
-/**
- * Agent movement/activity states rendered by the office scene.
- *
- * @private function of buildOfficeLayout
- */
-export type OfficeAgentState = 'idle' | 'working' | 'meeting' | 'moving';
-
-/**
- * Room categories rendered in the office scene.
- *
- * @private function of buildOfficeLayout
- */
-export type OfficeRoomKind = 'root' | 'folder' | 'remote' | 'head-office';
-
-/**
- * Two-dimensional world coordinate.
- *
- * @private function of buildOfficeLayout
- */
-export type OfficePoint = {
-    x: number;
-    y: number;
-};
-
-/**
- * One room in the computed office layout.
- *
- * @private function of buildOfficeLayout
- */
-export type OfficeRoom = {
-    id: string;
-    label: string;
-    subtitle: string;
-    kind: OfficeRoomKind;
-    color: string;
-    x: number;
-    y: number;
-    width: number;
-    depth: number;
-    deskSlots: Array<OfficePoint>;
-    meetingSlots: Array<OfficePoint>;
-    corridorAnchor: OfficePoint;
-};
-
-/**
- * One desk rendered inside a room.
- *
- * @private function of buildOfficeLayout
- */
-export type OfficeDesk = {
-    id: string;
-    roomId: string;
-    x: number;
-    y: number;
-    width: number;
-    depth: number;
-    color: string;
-    isRemote: boolean;
-};
-
-/**
- * Animated corridor path used by walking agents.
- *
- * @private function of buildOfficeLayout
- */
-export type OfficeAgentPath = {
-    from: OfficePoint;
-    to: OfficePoint;
-    durationMs: number;
-    delayMs: number;
-};
-
-/**
- * One agent visualized in the office scene.
- *
- * @private function of buildOfficeLayout
- */
-export type OfficeAgentVisual = {
-    id: string;
-    agent: AgentWithVisibility;
-    state: OfficeAgentState;
-    roomId: string;
-    roomLabel: string;
-    serverLabel: string | null;
-    position: OfficePoint;
-    deskId: string | null;
-    path: OfficeAgentPath | null;
-    previewText: string;
-    summaryText: string;
-    capabilityBadges: Array<string>;
-    isRemote: boolean;
-    defaultHref: string;
-    profileHref: string;
-    chatHref: string;
-    bookHref: string;
-    seed: number;
-};
-
-/**
- * View-model payload consumed by the Office homepage component.
- *
- * @private function of buildOfficeLayout
- */
-export type OfficeLayout = {
-    rooms: Array<OfficeRoom>;
-    desks: Array<OfficeDesk>;
-    agents: Array<OfficeAgentVisual>;
-    corridorHub: OfficePoint;
-    worldWidth: number;
-    worldHeight: number;
-    stateCounts: Record<OfficeAgentState, number>;
-};
-
-/**
- * Parameters used when computing the office visualization.
- *
- * @private function of buildOfficeLayout
- */
-export type BuildOfficeLayoutOptions = {
-    agents: ReadonlyArray<AgentOrganizationAgent>;
-    federatedAgents: ReadonlyArray<AgentWithVisibility>;
-    folders: ReadonlyArray<AgentOrganizationFolder>;
-    publicUrl: string;
-};
-
-/**
- * Lightweight room grouping before screen coordinates are assigned.
- *
- * @private function of buildOfficeLayout
- */
-export type OfficeRoomGroup = {
-    id: string;
-    label: string;
-    subtitle: string;
-    kind: OfficeRoomKind;
-    color: string;
-    agents: Array<AgentWithVisibility>;
-};
-
-/**
- * Group-local state assignment before positions are generated.
- *
- * @private function of buildOfficeLayout
- */
-export type OfficeAgentAssignment = {
-    agent: AgentWithVisibility;
-    state: OfficeAgentState;
-    seed: number;
-};

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

@@ -1,233 +0,0 @@
-import type { AgentWithVisibility } from './useFederatedAgents';
-import {
-    buildAgentFreshChatPath,
-    buildAgentPath,
-    getAgentIdentifier,
-    hashString,
-    hasTeamCapability,
-    hasWorkingCapability,
-    isWorkingCapabilityType,
-    isRemoteAgent,
-    resolveServerLabel,
-} from './buildOfficeLayoutShared';
-import {
-    createRoomDesks,
-    createWalkingPath,
-    deskPositionToAgentPosition,
-    fallbackAgentPosition,
-} from './buildOfficeLayoutRooms';
-import type {
-    OfficeAgentAssignment,
-    OfficeAgentState,
-    OfficeAgentVisual,
-    OfficeDesk,
-    OfficePoint,
-    OfficeRoom,
-    OfficeRoomGroup,
-} from './buildOfficeLayoutTypes';
-
-/**
- * Output generated for one room while building the office scene.
- *
- * @private function of buildOfficeLayout
- */
-type OfficeRoomVisuals = {
-    desks: Array<OfficeDesk>;
-    agents: Array<OfficeAgentVisual>;
-};
-
-/**
- * Creates room-level desks and agent visuals for one positioned room.
- *
- * @param room - Positioned room currently being rendered.
- * @param roomGroup - Source group assigned to the room.
- * @param corridorHub - Shared corridor waypoint.
- * @param normalizedPublicUrl - Slash-normalized local server URL.
- * @returns Visual records for the room.
- *
- * @private function of buildOfficeLayout
- */
-export function buildOfficeRoomVisuals(
-    room: OfficeRoom,
-    roomGroup: OfficeRoomGroup,
-    corridorHub: OfficePoint,
-    normalizedPublicUrl: string,
-): OfficeRoomVisuals {
-    const assignments = assignOfficeStates(roomGroup.agents);
-    const desks = createRoomDesks(room, assignments);
-    const roomDeskQueue = [...desks];
-    const roomMeetingQueue = [...room.meetingSlots];
-
-    const agents = assignments.map((assignment, index) => {
-        const desk = assignment.state === 'meeting' || assignment.state === 'moving' ? null : roomDeskQueue.shift() || null;
-        const meetingPosition = assignment.state === 'meeting' ? roomMeetingQueue.shift() || room.meetingSlots[0] : null;
-        const path = assignment.state === 'moving' ? createWalkingPath(room, corridorHub, assignment.seed, index) : null;
-        const position =
-            assignment.state === 'moving'
-                ? path?.from || room.corridorAnchor
-                : meetingPosition || deskPositionToAgentPosition(desk) || fallbackAgentPosition(room, index);
-
-        return createOfficeAgentVisual(assignment, room, position, desk, path, normalizedPublicUrl);
-    });
-
-    return { desks, agents };
-}
-
-/**
- * Counts how many agents were assigned to each office state.
- *
- * @param agents - Agent visuals in the computed layout.
- * @returns State counts keyed by state name.
- *
- * @private function of buildOfficeLayout
- */
-export function countStates(agents: Array<OfficeAgentVisual>): Record<OfficeAgentState, number> {
-    return agents.reduce<Record<OfficeAgentState, number>>(
-        (counts, agent) => {
-            counts[agent.state] += 1;
-            return counts;
-        },
-        { idle: 0, working: 0, meeting: 0, moving: 0 },
-    );
-}
-
-/**
- * Assigns office activity states to one room's agents.
- *
- * @param agents - Agents assigned to a single room.
- * @returns Deterministic state assignments for rendering.
- *
- * @private function of buildOfficeLayout
- */
-export function assignOfficeStates(agents: Array<AgentWithVisibility>): Array<OfficeAgentAssignment> {
-    const assignments = [...agents]
-        .sort((left, right) => getAgentIdentifier(left).localeCompare(getAgentIdentifier(right)))
-        .map((agent) => ({
-            agent,
-            state: inferBaseState(agent),
-            seed: hashString(getAgentIdentifier(agent)),
-        }));
-
-    const teamCandidates = assignments.filter(({ agent }) => hasTeamCapability(agent));
-    const meetingCount = assignments.length >= 4 ? Math.min(4, Math.max(2, teamCandidates.length || 2)) : Math.min(2, teamCandidates.length);
-
-    if (meetingCount > 0) {
-        const prioritizedMeetingCandidates = (teamCandidates.length > 0 ? teamCandidates : assignments).slice(0, meetingCount);
-        prioritizedMeetingCandidates.forEach((candidate) => {
-            candidate.state = 'meeting';
-        });
-    }
-
-    const movingCandidates = assignments.filter(({ state }) => state === 'moving');
-    if (movingCandidates.length === 0 && assignments.length >= 3) {
-        const movable = assignments.find(({ state }) => state !== 'meeting');
-        if (movable) {
-            movable.state = 'moving';
-        }
-    }
-
-    const workingCandidates = assignments.filter(({ state }) => state === 'working');
-    if (workingCandidates.length === 0) {
-        const worker = assignments.find(({ state }) => state === 'idle');
-        if (worker) {
-            worker.state = 'working';
-        }
-    }
-
-    return assignments;
-}
-
-/**
- * Infers a base office state from the available agent metadata.
- *
- * @param agent - Agent to classify.
- * @returns Base activity state before room-level balancing.
- */
-function inferBaseState(agent: AgentWithVisibility): OfficeAgentState {
-    if (isRemoteAgent(agent)) {
-        return 'moving';
-    }
-
-    if (hasTeamCapability(agent)) {
-        return 'meeting';
-    }
-
-    if (hasWorkingCapability(agent)) {
-        return 'working';
-    }
-
-    return 'idle';
-}
-
-/**
- * Creates one rendered agent record from an assignment and positioned room.
- *
- * @param assignment - Deterministic room-level agent assignment.
- * @param room - Room the agent belongs to.
- * @param position - Final rendered anchor position.
- * @param desk - Optional desk assigned to the agent.
- * @param path - Optional walking path assigned to the agent.
- * @param normalizedPublicUrl - Slash-normalized local server URL.
- * @returns Fully prepared room agent visual.
- */
-function createOfficeAgentVisual(
-    assignment: OfficeAgentAssignment,
-    room: OfficeRoom,
-    position: OfficePoint,
-    desk: OfficeDesk | null,
-    path: ReturnType<typeof createWalkingPath> | null,
-    normalizedPublicUrl: string,
-): OfficeAgentVisual {
-    return {
-        id: getAgentIdentifier(assignment.agent),
-        agent: assignment.agent,
-        state: assignment.state,
-        roomId: room.id,
-        roomLabel: room.label,
-        serverLabel: resolveServerLabel(assignment.agent.serverUrl),
-        position,
-        deskId: desk?.id || null,
-        path,
-        previewText: createPreviewText(assignment.agent, assignment.state),
-        summaryText: assignment.agent.personaDescription || assignment.agent.meta.description || room.subtitle,
-        capabilityBadges: (assignment.agent.capabilities || []).slice(0, 3).map((capability) => capability.label),
-        isRemote: isRemoteAgent(assignment.agent),
-        defaultHref: buildAgentFreshChatPath(assignment.agent, normalizedPublicUrl),
-        profileHref: buildAgentPath(assignment.agent, normalizedPublicUrl, ''),
-        chatHref: buildAgentFreshChatPath(assignment.agent, normalizedPublicUrl),
-        bookHref: buildAgentPath(assignment.agent, normalizedPublicUrl, '/book'),
-        seed: assignment.seed,
-    };
-}
-
-/**
- * Creates compact screen-preview text shown in the office UI.
- *
- * @param agent - Agent being visualized.
- * @param state - Inferred office state.
- * @returns Short preview string for the desk screen/tooltip.
- */
-function createPreviewText(agent: AgentWithVisibility, state: OfficeAgentState): string {
-    if (state === 'meeting') {
-        return 'Team sync';
-    }
-
-    if (state === 'moving') {
-        return 'Walking the corridor';
-    }
-
-    const capabilityLabel = agent.capabilities.find((capability) => isWorkingCapabilityType(capability.type))?.label;
-    if (capabilityLabel) {
-        return capabilityLabel;
-    }
-
-    const description = agent.meta.description || agent.personaDescription || '';
-    if (description) {
-        const firstSentence = description.split(/[.!?]/)[0];
-        if (firstSentence) {
-            return firstSentence.trim().slice(0, 48);
-        }
-    }
-
-    return state === 'working' ? 'Focused work' : 'Available at desk';
-}

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

@@ -1,148 +0,0 @@
-import type { AgentOrganizationFolder } from '../../utils/agentOrganization/types';
-import { buildFolderMaps, getFolderPathSegments, sortBySortOrder } from './agentOrganizationUtils';
-import type { FolderGroup, GraphNode, ServerGroup } from './buildGraphDataTypes';
-import { normalizeServerUrl } from './normalizeServerUrl';
-
-/**
- * Build a path label for a folder id.
- */
-const buildFolderLabel = (folderId: number | null, folderMaps: ReturnType<typeof buildFolderMaps>): string => {
-    if (folderId === null) {
-        return 'Root';
-    }
-
-    const segments = getFolderPathSegments(folderId, folderMaps.folderById);
-    if (segments.length === 0) {
-        return `Folder ${folderId}`;
-    }
-
-    return segments.map((segment) => segment.name).join(' / ');
-};
-
-/**
- * Build ordered folder ids by traversing the folder tree.
- */
-const buildOrderedFolderIds = (
-    agentsByFolderId: Map<number | null, GraphNode[]>,
-    folderMaps: ReturnType<typeof buildFolderMaps>,
-): number[] => {
-    const ordered: number[] = [];
-
-    const visitFolder = (parentId: number | null) => {
-        const childIds = folderMaps.childrenByParentId.get(parentId) || [];
-        const childFolders = childIds
-            .map((childId) => folderMaps.folderById.get(childId))
-            .filter((folder): folder is AgentOrganizationFolder => Boolean(folder));
-        const sortedFolders = sortBySortOrder(childFolders, (folder) => folder.name);
-
-        sortedFolders.forEach((folder) => {
-            if (agentsByFolderId.has(folder.id)) {
-                ordered.push(folder.id);
-            }
-            visitFolder(folder.id);
-        });
-    };
-
-    visitFolder(null);
-
-    return ordered;
-};
-
-/**
- * Group visible graph nodes by server and folder for graph layout and summary views.
- *
- * @private function of AgentsGraph
- */
-export const buildServerGroups = (
-    nodes: GraphNode[],
-    folders: AgentOrganizationFolder[],
-    publicUrl: string,
-    rootLabel: string,
-): ServerGroup[] => {
-    const normalizedPublicUrl = normalizeServerUrl(publicUrl);
-    const nodesByServer = new Map<string, GraphNode[]>();
-
-    nodes.forEach((node) => {
-        const bucket = nodesByServer.get(node.serverUrl) || [];
-        bucket.push(node);
-        nodesByServer.set(node.serverUrl, bucket);
-    });
-
-    const serverUrls = Array.from(nodesByServer.keys()).sort((left, right) => {
-        if (left === normalizedPublicUrl) {
-            return -1;
-        }
-        if (right === normalizedPublicUrl) {
-            return 1;
-        }
-        return left.localeCompare(right);
-    });
-
-    return serverUrls.map((serverUrl) => {
-        const serverNodes = nodesByServer.get(serverUrl) || [];
-        const isLocal = serverUrl === normalizedPublicUrl;
-        const serverLabel = serverUrl.replace(/^https?:\/\//, '');
-
-        if (!isLocal || folders.length === 0) {
-            return {
-                serverUrl,
-                label: serverLabel,
-                isLocal,
-                folders: [
-                    {
-                        id: null,
-                        label: rootLabel,
-                        agents: sortBySortOrder(serverNodes, (node) => node.name),
-                    },
-                ],
-            };
-        }
-
-        const folderMaps = buildFolderMaps(folders);
-        const agentsByFolderId = new Map<number | null, GraphNode[]>();
-        serverNodes.forEach((node) => {
-            const folderId = node.folderId ?? null;
-            const bucket = agentsByFolderId.get(folderId) || [];
-            bucket.push(node);
-            agentsByFolderId.set(folderId, bucket);
-        });
-
-        const folderGroups: FolderGroup[] = [];
-        if (agentsByFolderId.has(null)) {
-            folderGroups.push({
-                id: null,
-                label: buildFolderLabel(null, folderMaps),
-                agents: sortBySortOrder(agentsByFolderId.get(null) || [], (node) => node.name),
-            });
-        }
-
-        const orderedFolderIds = buildOrderedFolderIds(agentsByFolderId, folderMaps);
-        orderedFolderIds.forEach((folderId) => {
-            const agentsInFolder = agentsByFolderId.get(folderId);
-            if (!agentsInFolder) {
-                return;
-            }
-
-            folderGroups.push({
-                id: folderId,
-                label: buildFolderLabel(folderId, folderMaps),
-                agents: sortBySortOrder(agentsInFolder, (node) => node.name),
-            });
-        });
-
-        if (folderGroups.length === 0) {
-            folderGroups.push({
-                id: null,
-                label: rootLabel,
-                agents: sortBySortOrder(serverNodes, (node) => node.name),
-            });
-        }
-
-        return {
-            serverUrl,
-            label: serverLabel,
-            isLocal,
-            folders: folderGroups,
-        };
-    });
-};

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

@@ -1,22 +0,0 @@
-import type { GraphLink } from './buildGraphDataTypes';
-
-/**
- * Collect node ids connected to any focused node via graph links.
- *
- * @private function of AgentsGraph
- */
-export const collectRelatedNodeIds = (links: GraphLink[], focusedNodeIds: Set<string>): Set<string> => {
-    const relatedNodeIds = new Set(focusedNodeIds);
-
-    links.forEach((link) => {
-        if (focusedNodeIds.has(link.source)) {
-            relatedNodeIds.add(link.target);
-        }
-
-        if (focusedNodeIds.has(link.target)) {
-            relatedNodeIds.add(link.source);
-        }
-    });
-
-    return relatedNodeIds;
-};

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

@@ -1,127 +0,0 @@
-import { collectRelatedNodeIds } from './collectRelatedNodeIds';
-import { normalizeServerUrl } from './normalizeServerUrl';
-import type { AgentWithVisibility, GraphLink, GraphNode } from './buildGraphDataTypes';
-
-/**
- * Normalize a selected agent identifier by stripping agent URL prefixes.
- */
-const normalizeSelectedAgentIdentifier = (value: string): string => {
-    const trimmed = value.trim();
-    if (!trimmed) {
-        return '';
-    }
-
-    const withoutHash = trimmed.split('#')[0] ?? trimmed;
-    const withoutQuery = withoutHash.split('?')[0] ?? withoutHash;
-    const normalized = withoutQuery.replace(/\/$/, '');
-    const agentsIndex = normalized.lastIndexOf('/agents/');
-    if (agentsIndex >= 0) {
-        return normalized.slice(agentsIndex + '/agents/'.length);
-    }
-
-    return normalized.replace(/^\/agents\//, '');
-};
-
-/**
- * Parse the selected agent input into identifier and optional server URL.
- */
-const parseSelectedAgentInput = (value: string): { identifier: string; serverUrl: string | null } => {
-    const trimmed = value.trim();
-    if (!trimmed) {
-        return { identifier: '', serverUrl: null };
-    }
-
-    if (trimmed.includes('://') && trimmed.includes('/agents/')) {
-        const [serverPart] = trimmed.split('/agents/');
-        return {
-            identifier: normalizeSelectedAgentIdentifier(trimmed),
-            serverUrl: normalizeServerUrl(serverPart),
-        };
-    }
-
-    return { identifier: normalizeSelectedAgentIdentifier(trimmed), serverUrl: null };
-};
-
-/**
- * Check whether the agent matches the selected identifier.
- */
-const matchesSelectedAgentIdentifier = (agent: AgentWithVisibility, identifier: string): boolean => {
-    if (!identifier) {
-        return false;
-    }
-
-    return agent.agentName === identifier || agent.permanentId === identifier;
-};
-
-/**
- * Resolve focused node ids based on server and agent selection.
- */
-const resolveFocusedNodeIds = (
-    nodes: GraphNode[],
-    selectedServerUrl: string | null,
-    selectedAgentName: string | null,
-): Set<string> => {
-    if (!selectedAgentName) {
-        return new Set();
-    }
-
-    const parsedSelection = parseSelectedAgentInput(selectedAgentName);
-    if (!parsedSelection.identifier) {
-        return new Set();
-    }
-
-    const serverFilter =
-        parsedSelection.serverUrl && parsedSelection.serverUrl !== 'ALL'
-            ? parsedSelection.serverUrl
-            : selectedServerUrl && selectedServerUrl !== 'ALL'
-            ? selectedServerUrl
-            : null;
-
-    const focusedNodes = nodes.filter((node) => {
-        if (serverFilter && node.serverUrl !== serverFilter) {
-            return false;
-        }
-
-        return matchesSelectedAgentIdentifier(node.agent, parsedSelection.identifier);
-    });
-
-    return new Set(focusedNodes.map((node) => node.id));
-};
-
-/**
- * Filter graph nodes and links by the current server or agent selection.
- *
- * @private function of buildGraphData
- */
-export const filterGraphData = (
-    nodes: GraphNode[],
-    links: GraphLink[],
-    selectedServerUrl: string | null,
-    selectedAgentName: string | null,
-): { nodes: GraphNode[]; links: GraphLink[] } => {
-    const focusedNodeIds = resolveFocusedNodeIds(nodes, selectedServerUrl, selectedAgentName);
-
-    if (focusedNodeIds.size > 0) {
-        const relatedNodeIds = collectRelatedNodeIds(links, focusedNodeIds);
-        return {
-            nodes: nodes.filter((node) => relatedNodeIds.has(node.id)),
-            links: links.filter((link) => relatedNodeIds.has(link.source) && relatedNodeIds.has(link.target)),
-        };
-    }
-
-    if (selectedServerUrl && selectedServerUrl !== 'ALL') {
-        const serverNodes = nodes.filter((node) => node.serverUrl === selectedServerUrl);
-        const serverNodeIds = new Set(serverNodes.map((node) => node.id));
-
-        return {
-            nodes: serverNodes,
-            links: links.filter((link) => serverNodeIds.has(link.source) && serverNodeIds.has(link.target)),
-        };
-    }
-
-    if (selectedAgentName) {
-        return { nodes: [], links: [] };
-    }
-
-    return { nodes, links };
-};