@promptbook/cli 0.113.0-8 → 0.114.0-0

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

@@ -1,61 +0,0 @@
-import { createLocalRoomGroups, createRemoteRoomGroups } from './buildOfficeLayoutGroups';
-import { createCorridorHub, createOfficeWorldBounds, placeRoomGroups } from './buildOfficeLayoutRooms';
-import { normalizeBaseUrl } from './buildOfficeLayoutShared';
-import type { BuildOfficeLayoutOptions, OfficeAgentVisual, OfficeDesk, OfficeLayout } from './buildOfficeLayoutTypes';
-import { buildOfficeRoomVisuals, countStates } from './buildOfficeLayoutVisuals';
-
-export type {
-    BuildOfficeLayoutOptions,
-    OfficeAgentPath,
-    OfficeAgentState,
-    OfficeAgentVisual,
-    OfficeDesk,
-    OfficeLayout,
-    OfficePoint,
-    OfficeRoom,
-    OfficeRoomKind,
-} from './buildOfficeLayoutTypes';
-
-/**
- * Builds the client-side office view model from the existing homepage agent datasets.
- *
- * @param options - Local agents, federated agents, folders, and public URL.
- * @returns Deterministic office layout ready for rendering.
- *
- * @private function of <AgentsOffice/> and <AgentsPixelOffice/>
- */
-export function buildOfficeLayout(options: BuildOfficeLayoutOptions): OfficeLayout {
-    const normalizedPublicUrl = normalizeBaseUrl(options.publicUrl);
-    const localGroups = createLocalRoomGroups(options.agents, options.folders);
-    const remoteGroups = createRemoteRoomGroups(options.federatedAgents);
-    const roomGroups = [...localGroups, ...remoteGroups];
-    const roomGroupById = new Map(roomGroups.map((roomGroup) => [roomGroup.id, roomGroup]));
-    const rooms = placeRoomGroups(localGroups, remoteGroups);
-    const corridorHub = createCorridorHub(localGroups.length);
-    const desks: Array<OfficeDesk> = [];
-    const agents: Array<OfficeAgentVisual> = [];
-
-    for (const room of rooms) {
-        const roomGroup = roomGroupById.get(room.id);
-        if (!roomGroup) {
-            continue;
-        }
-
-        const roomVisuals = buildOfficeRoomVisuals(room, roomGroup, corridorHub, normalizedPublicUrl);
-        desks.push(...roomVisuals.desks);
-        agents.push(...roomVisuals.agents);
-    }
-
-    const stateCounts = countStates(agents);
-    const { worldWidth, worldHeight } = createOfficeWorldBounds(rooms, corridorHub);
-
-    return {
-        rooms,
-        desks,
-        agents,
-        corridorHub,
-        worldWidth,
-        worldHeight,
-        stateCounts,
-    };
-}

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

@@ -1,94 +0,0 @@
-import type { AgentOrganizationAgent, AgentOrganizationFolder } from '../../utils/agentOrganization/types';
-import type { AgentWithVisibility } from './useFederatedAgents';
-import type { OfficeRoomGroup } from './buildOfficeLayoutTypes';
-import {
-    getAgentIdentifier,
-    isHeadOfficeServer,
-    normalizeBaseUrl,
-    pickPaletteColor,
-    resolveServerLabel,
-} from './buildOfficeLayoutShared';
-
-/**
- * Creates room groups for local folders/root agents.
- *
- * @param agents - Local agents in the current homepage scope.
- * @param folders - Folder metadata used for room labels/colors.
- * @returns Ordered room groups for local agents.
- *
- * @private function of buildOfficeLayout
- */
-export function createLocalRoomGroups(
-    agents: ReadonlyArray<AgentOrganizationAgent>,
-    folders: ReadonlyArray<AgentOrganizationFolder>,
-): Array<OfficeRoomGroup> {
-    const folderById = new Map(folders.map((folder) => [folder.id, folder]));
-    const grouped = new Map<string, OfficeRoomGroup>();
-    const orderedAgents = [...agents].sort((left, right) => left.sortOrder - right.sortOrder || left.agentName.localeCompare(right.agentName));
-
-    orderedAgents.forEach((agent, index) => {
-        const folder = agent.folderId === null ? null : folderById.get(agent.folderId) || null;
-        const groupId = folder ? `folder:${folder.id}` : 'root';
-        const currentGroup = grouped.get(groupId);
-
-        if (currentGroup) {
-            currentGroup.agents.push(agent);
-            return;
-        }
-
-        grouped.set(groupId, {
-            id: groupId,
-            label: folder?.name || 'Core Floor',
-            subtitle: folder ? 'Project room' : 'Shared desks',
-            kind: folder ? 'folder' : 'root',
-            color: folder?.color || pickPaletteColor(index),
-            agents: [agent],
-        });
-    });
-
-    return [...grouped.values()];
-}
-
-/**
- * Creates room groups for federated servers.
- *
- * @param federatedAgents - Federated agents loaded for the office scene.
- * @returns Ordered room groups for remote servers.
- *
- * @private function of buildOfficeLayout
- */
-export function createRemoteRoomGroups(federatedAgents: ReadonlyArray<AgentWithVisibility>): Array<OfficeRoomGroup> {
-    const grouped = new Map<string, OfficeRoomGroup>();
-
-    [...federatedAgents]
-        .sort((left, right) => getAgentIdentifier(left).localeCompare(getAgentIdentifier(right)))
-        .forEach((agent, index) => {
-            const serverUrl = normalizeBaseUrl(agent.serverUrl || '');
-            const serverLabel = resolveServerLabel(serverUrl) || 'Remote server';
-            const currentGroup = grouped.get(serverUrl);
-
-            if (currentGroup) {
-                currentGroup.agents.push(agent);
-                if (currentGroup.kind !== 'head-office' && isHeadOfficeServer(serverLabel, currentGroup.agents)) {
-                    currentGroup.label = 'Head Office';
-                    currentGroup.subtitle = 'Core federation';
-                    currentGroup.kind = 'head-office';
-                    currentGroup.color = '#2563eb';
-                }
-                return;
-            }
-
-            const headOffice = isHeadOfficeServer(serverLabel, [agent]);
-            grouped.set(serverUrl, {
-                id: `remote:${serverLabel}`,
-                label: headOffice ? 'Head Office' : serverLabel,
-                subtitle: headOffice ? 'Core federation' : 'Remote colleagues',
-                kind: headOffice ? 'head-office' : 'remote',
-                color: headOffice ? '#2563eb' : pickPaletteColor(index + 2),
-                agents: [agent],
-            });
-        });
-
-    return [...grouped.values()];
-}
-

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

@@ -1,287 +0,0 @@
-import type { OfficeAgentAssignment, OfficeAgentPath, OfficeDesk, OfficePoint, OfficeRoom, OfficeRoomGroup } from './buildOfficeLayoutTypes';
-import { isRemoteAgent } from './buildOfficeLayoutShared';
-
-/**
- * Width of one office room in world units.
- */
-const ROOM_WIDTH = 260;
-
-/**
- * Depth of one office room in world units.
- */
-const ROOM_DEPTH = 170;
-
-/**
- * Horizontal spacing between adjacent rooms.
- */
-const ROOM_GAP_X = 110;
-
-/**
- * Vertical spacing between adjacent room rows.
- */
-const ROOM_GAP_Y = 120;
-
-/**
- * Width reserved for the central corridor spine.
- */
-const CORRIDOR_WIDTH = 210;
-
-/**
- * Width of one rendered desk.
- */
-const DESK_WIDTH = 54;
-
-/**
- * Depth of one rendered desk.
- */
-const DESK_DEPTH = 30;
-
-/**
- * Extra world padding to keep the scene comfortably framed.
- */
-const WORLD_PADDING = 220;
-
-/**
- * Computed world bounds for the office scene.
- */
-type OfficeWorldBounds = {
-    worldWidth: number;
-    worldHeight: number;
-};
-
-/**
- * Computes screen-independent room positions in the office world.
- *
- * @param localGroups - Local room groups.
- * @param remoteGroups - Remote server groups.
- * @returns Positioned rooms with desk/meeting slots.
- *
- * @private function of buildOfficeLayout
- */
-export function placeRoomGroups(localGroups: Array<OfficeRoomGroup>, remoteGroups: Array<OfficeRoomGroup>): Array<OfficeRoom> {
-    const rooms: Array<OfficeRoom> = [];
-    const localColumns = localGroups.length > 1 ? 2 : 1;
-    const remoteStartX = localColumns * (ROOM_WIDTH + ROOM_GAP_X) + CORRIDOR_WIDTH;
-
-    localGroups.forEach((group, index) => {
-        const column = index % localColumns;
-        const row = Math.floor(index / localColumns);
-        const x = column * (ROOM_WIDTH + ROOM_GAP_X);
-        const y = row * (ROOM_DEPTH + ROOM_GAP_Y);
-
-        rooms.push(createRoom(group, x, y, false));
-    });
-
-    remoteGroups.forEach((group, index) => {
-        const x = remoteStartX;
-        const y = index * (ROOM_DEPTH + ROOM_GAP_Y * 0.9) + 40;
-
-        rooms.push(createRoom(group, x, y, true));
-    });
-
-    return rooms;
-}
-
-/**
- * Creates the shared corridor hub used by walking agents.
- *
- * @param localGroupCount - Number of local rooms in the scene.
- * @returns Corridor hub point.
- *
- * @private function of buildOfficeLayout
- */
-export function createCorridorHub(localGroupCount: number): OfficePoint {
-    const localColumns = localGroupCount > 1 ? 2 : 1;
-
-    return {
-        x: localColumns * (ROOM_WIDTH + ROOM_GAP_X) - ROOM_GAP_X / 2 + CORRIDOR_WIDTH / 2,
-        y: ROOM_DEPTH + ROOM_GAP_Y / 2,
-    };
-}
-
-/**
- * Creates desk models for all desk-based agents in a room.
- *
- * @param room - Room to populate.
- * @param assignments - Agent assignments for the room.
- * @returns Desk definitions used by the renderer.
- *
- * @private function of buildOfficeLayout
- */
-export function createRoomDesks(room: OfficeRoom, assignments: Array<OfficeAgentAssignment>): Array<OfficeDesk> {
-    return assignments
-        .filter(({ state }) => state !== 'meeting' && state !== 'moving')
-        .slice(0, room.deskSlots.length)
-        .map((assignment, index) => {
-            const slot = room.deskSlots[index];
-
-            if (!slot) {
-                throw new Error(`Missing desk slot ${index} for room ${room.id}.`);
-            }
-
-            return {
-                id: `${room.id}:desk:${index}`,
-                roomId: room.id,
-                x: slot.x,
-                y: slot.y,
-                width: DESK_WIDTH,
-                depth: DESK_DEPTH,
-                color: room.color,
-                isRemote: isRemoteAgent(assignment.agent),
-            };
-        });
-}
-
-/**
- * Creates a walking path from a room toward the corridor hub.
- *
- * @param room - Room the agent belongs to.
- * @param corridorHub - Shared corridor target point.
- * @param seed - Deterministic animation seed.
- * @param index - Agent index inside the room.
- * @returns Animated path configuration.
- *
- * @private function of buildOfficeLayout
- */
-export function createWalkingPath(
-    room: OfficeRoom,
-    corridorHub: OfficePoint,
-    seed: number,
-    index: number,
-): OfficeAgentPath {
-    const offset = (seed % 26) - 13;
-
-    return {
-        from: {
-            x: room.corridorAnchor.x,
-            y: room.corridorAnchor.y + index * 6,
-        },
-        to: {
-            x: corridorHub.x + offset,
-            y: corridorHub.y + offset / 2,
-        },
-        durationMs: 3000 + (seed % 2400),
-        delayMs: (seed % 900) + index * 140,
-    };
-}
-
-/**
- * Resolves the avatar anchor point for a desk-based agent.
- *
- * @param desk - Desk assigned to the agent.
- * @returns Agent anchor point, or null when no desk exists.
- *
- * @private function of buildOfficeLayout
- */
-export function deskPositionToAgentPosition(desk: OfficeDesk | null): OfficePoint | null {
-    if (!desk) {
-        return null;
-    }
-
-    return {
-        x: desk.x + desk.width * 0.32,
-        y: desk.y + desk.depth * 0.7,
-    };
-}
-
-/**
- * Resolves a fallback position when no desk or meeting slot is available.
- *
- * @param room - Room that hosts the agent.
- * @param index - Stable index of the agent in the room.
- * @returns Fallback anchor point inside the room.
- *
- * @private function of buildOfficeLayout
- */
-export function fallbackAgentPosition(room: OfficeRoom, index: number): OfficePoint {
-    return {
-        x: room.x + 42 + (index % 3) * 46,
-        y: room.y + room.depth - 26 - Math.floor(index / 3) * 18,
-    };
-}
-
-/**
- * Computes the overall office-world bounds.
- *
- * @param rooms - Rooms included in the layout.
- * @param corridorHub - Corridor center point.
- * @returns World width and height including framing padding.
- *
- * @private function of buildOfficeLayout
- */
-export function createOfficeWorldBounds(rooms: ReadonlyArray<OfficeRoom>, corridorHub: OfficePoint): OfficeWorldBounds {
-    const maxRoomX = Math.max(0, ...rooms.map((room) => room.x + room.width), corridorHub.x);
-    const maxRoomY = Math.max(0, ...rooms.map((room) => room.y + room.depth), corridorHub.y);
-
-    return {
-        worldWidth: maxRoomX + WORLD_PADDING,
-        worldHeight: maxRoomY + WORLD_PADDING,
-    };
-}
-
-/**
- * Creates one positioned room model.
- *
- * @param group - Source room group.
- * @param x - Room origin on the office world plane.
- * @param y - Room origin on the office world plane.
- * @param isRemoteRoom - Whether the room sits on the remote wing side.
- * @returns Positioned room.
- */
-function createRoom(group: OfficeRoomGroup, x: number, y: number, isRemoteRoom: boolean): OfficeRoom {
-    return {
-        id: group.id,
-        label: group.label,
-        subtitle: group.subtitle,
-        kind: group.kind,
-        color: group.color,
-        x,
-        y,
-        width: ROOM_WIDTH,
-        depth: ROOM_DEPTH,
-        deskSlots: createDeskSlots(x, y),
-        meetingSlots: createMeetingSlots(x, y),
-        corridorAnchor: {
-            x: isRemoteRoom ? x - 30 : x + ROOM_WIDTH + 30,
-            y: y + ROOM_DEPTH / 2,
-        },
-    };
-}
-
-/**
- * Creates the room's desk anchor positions.
- *
- * @param roomX - Room world X coordinate.
- * @param roomY - Room world Y coordinate.
- * @returns Desk slot anchor points.
- */
-function createDeskSlots(roomX: number, roomY: number): Array<OfficePoint> {
-    return [
-        { x: roomX + 46, y: roomY + 38 },
-        { x: roomX + 116, y: roomY + 38 },
-        { x: roomX + 186, y: roomY + 38 },
-        { x: roomX + 46, y: roomY + 102 },
-        { x: roomX + 116, y: roomY + 102 },
-        { x: roomX + 186, y: roomY + 102 },
-    ];
-}
-
-/**
- * Creates the room's meeting-seat anchor positions.
- *
- * @param roomX - Room world X coordinate.
- * @param roomY - Room world Y coordinate.
- * @returns Meeting slot anchor points.
- */
-function createMeetingSlots(roomX: number, roomY: number): Array<OfficePoint> {
-    const centerX = roomX + ROOM_WIDTH / 2;
-    const centerY = roomY + ROOM_DEPTH / 2 + 10;
-
-    return [
-        { x: centerX - 44, y: centerY - 16 },
-        { x: centerX + 44, y: centerY - 16 },
-        { x: centerX - 44, y: centerY + 28 },
-        { x: centerX + 44, y: centerY + 28 },
-    ];
-}
-

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

@@ -1,209 +0,0 @@
-import { buildFreshAgentChatHrefFromAgentUrl } from '../../utils/agentRouting/agentRouteHrefs';
-import type { AgentWithVisibility } from './useFederatedAgents';
-
-/**
- * Color palette used when folders do not provide a custom color.
- */
-const ROOM_COLOR_PALETTE = ['#d97706', '#0f766e', '#2563eb', '#be123c', '#7c3aed', '#0891b2'];
-
-/**
- * Capability types that imply screen-focused work.
- */
-const WORKING_CAPABILITY_TYPES = new Set([
-    'browser',
-    'search-engine',
-    'knowledge',
-    'image-generator',
-    'project',
-    'email',
-    'wallet',
-    'timeout',
-    'time',
-    'user-location',
-]);
-
-/**
- * Returns a deterministic fallback palette color by index.
- *
- * @param index - Index to map onto the fallback palette.
- * @returns Resolved fallback room color.
- *
- * @private function of buildOfficeLayout
- */
-export function pickPaletteColor(index: number): string {
-    return ROOM_COLOR_PALETTE[index % ROOM_COLOR_PALETTE.length] || ROOM_COLOR_PALETTE[0] || '#2563eb';
-}
-
-/**
- * Normalizes a possibly-missing base URL into a slash-terminated string.
- *
- * @param value - URL-like value to normalize.
- * @returns Normalized slash-terminated URL.
- *
- * @private function of buildOfficeLayout
- */
-export function normalizeBaseUrl(value: string): string {
-    if (!value) {
-        return '';
-    }
-
-    return value.endsWith('/') ? value : `${value}/`;
-}
-
-/**
- * Builds a stable identifier for one agent.
- *
- * @param agent - Agent to identify.
- * @returns Stable local/federated agent identifier.
- *
- * @private function of buildOfficeLayout
- */
-export function getAgentIdentifier(agent: AgentWithVisibility): string {
-    return agent.permanentId || agent.agentName;
-}
-
-/**
- * Resolves a readable hostname label from a server URL.
- *
- * @param serverUrl - Optional server URL.
- * @returns Hostname label or null for local agents.
- *
- * @private function of buildOfficeLayout
- */
-export function resolveServerLabel(serverUrl: string | undefined): string | null {
-    if (!serverUrl) {
-        return null;
-    }
-
-    try {
-        return new URL(serverUrl).hostname;
-    } catch {
-        return serverUrl;
-    }
-}
-
-/**
- * Returns true when the agent originates from a federated server.
- *
- * @param agent - Agent to inspect.
- * @returns True for remote colleagues.
- *
- * @private function of buildOfficeLayout
- */
-export function isRemoteAgent(agent: AgentWithVisibility): boolean {
-    return typeof agent.serverUrl === 'string' && agent.serverUrl.trim().length > 0;
-}
-
-/**
- * Returns true when the agent exposes a TEAM capability.
- *
- * @param agent - Agent to inspect.
- * @returns True when the agent references teammates.
- *
- * @private function of buildOfficeLayout
- */
-export function hasTeamCapability(agent: AgentWithVisibility): boolean {
-    return agent.capabilities.some((capability) => capability.type === 'team');
-}
-
-/**
- * Returns true when the agent has capabilities associated with active desk work.
- *
- * @param agent - Agent to inspect.
- * @returns True when the agent likely shows a live desk preview.
- *
- * @private function of buildOfficeLayout
- */
-export function hasWorkingCapability(agent: AgentWithVisibility): boolean {
-    return agent.capabilities.some((capability) => WORKING_CAPABILITY_TYPES.has(capability.type));
-}
-
-/**
- * Returns true when the capability type implies active desk work.
- *
- * @param capabilityType - Capability type to inspect.
- * @returns True when the type should surface as desk activity.
- *
- * @private function of buildOfficeLayout
- */
-export function isWorkingCapabilityType(capabilityType: string): boolean {
-    return WORKING_CAPABILITY_TYPES.has(capabilityType);
-}
-
-/**
- * Detects whether a federated server should be rendered as the head office.
- *
- * @param serverLabel - Normalized hostname label.
- * @param agents - Agents originating from the server.
- * @returns True when the room should use the head-office visual treatment.
- *
- * @private function of buildOfficeLayout
- */
-export function isHeadOfficeServer(serverLabel: string, agents: ReadonlyArray<AgentWithVisibility>): boolean {
-    const normalizedServerLabel = serverLabel.toLowerCase();
-
-    if (
-        normalizedServerLabel.includes('ptbk') ||
-        normalizedServerLabel.includes('promptbook') ||
-        normalizedServerLabel.includes('core')
-    ) {
-        return true;
-    }
-
-    return agents.some((agent) => {
-        const name = `${agent.agentName} ${agent.meta.fullname || ''}`.toLowerCase();
-        return name.includes('adam') || name.includes('teacher');
-    });
-}
-
-/**
- * Creates a deterministic numeric seed from a string identifier.
- *
- * @param value - Input string.
- * @returns Positive integer seed.
- *
- * @private function of buildOfficeLayout
- */
-export function hashString(value: string): number {
-    let hash = 0;
-
-    for (let index = 0; index < value.length; index++) {
-        hash = (hash * 31 + value.charCodeAt(index)) >>> 0;
-    }
-
-    return hash;
-}
-
-/**
- * Builds one agent-relative path for profile/chat/book navigation.
- *
- * @param agent - Agent to link to.
- * @param publicUrl - Base URL of the current server.
- * @param suffix - Optional agent sub-route suffix.
- * @returns URL path or absolute URL.
- *
- * @private function of buildOfficeLayout
- */
-export function buildAgentPath(agent: AgentWithVisibility, publicUrl: string, suffix: '' | '/chat' | '/book'): string {
-    const identifier = encodeURIComponent(agent.permanentId || agent.agentName);
-    const remoteBase = isRemoteAgent(agent) ? normalizeBaseUrl(agent.serverUrl || publicUrl) : null;
-
-    if (remoteBase) {
-        return `${remoteBase}agents/${identifier}${suffix}`;
-    }
-
-    return `/agents/${identifier}${suffix}`;
-}
-
-/**
- * Builds the generic agent-entry href used by homepage visualizations.
- *
- * @param agent - Agent to link to.
- * @param publicUrl - Base URL of the current server.
- * @returns Relative or absolute href that starts a fresh chat.
- *
- * @private function of buildOfficeLayout
- */
-export function buildAgentFreshChatPath(agent: AgentWithVisibility, publicUrl: string): string {
-    return buildFreshAgentChatHrefFromAgentUrl(buildAgentPath(agent, publicUrl, ''));
-}