@promptbook/cli 0.113.0-0 → 0.113.0-10

package/apps/agents-server/src/app/system/utilities/mocked-chats/createDraftWithUpdatedSettings.ts

@@ -0,0 +1,19 @@
+import type { MockedChatPreset, MockedChatSettings } from '@/src/utils/mockedChatsSchema';
+
+/**
+ * Applies one settings patch to the draft.
+ *
+ * @private function of <MockedChatsEditorClient/>
+ */
+export function createDraftWithUpdatedSettings(
+    previousDraft: MockedChatPreset,
+    settingsPatch: Partial<MockedChatSettings>,
+): MockedChatPreset {
+    return {
+        ...previousDraft,
+        settings: {
+            ...previousDraft.settings,
+            ...settingsPatch,
+        },
+    };
+}

package/apps/agents-server/src/app/system/utilities/mocked-chats/createDuplicatedDraft.ts

@@ -0,0 +1,66 @@
+import { createMockedChatId, type MockedChatPreset } from '@/src/utils/mockedChatsSchema';
+import { cloneMockedChatPreset } from './cloneMockedChatPreset';
+
+/**
+ * Creates a local duplicate draft from the current editor content.
+ *
+ * @private function of <MockedChatsEditorClient/>
+ */
+export function createDuplicatedDraft(draftChat: MockedChatPreset): MockedChatPreset {
+    const duplicatedDraft = cloneMockedChatPreset(draftChat);
+    duplicatedDraft.id = createMockedChatId();
+    duplicatedDraft.name = buildCopyName(draftChat.name);
+    duplicatedDraft.createdAt = new Date().toISOString();
+    duplicatedDraft.updatedAt = duplicatedDraft.createdAt;
+    return duplicatedDraft;
+}
+
+/**
+ * Normalizes the draft before saving it over its current id.
+ *
+ * @private function of <MockedChatsEditorClient/>
+ */
+export function createNormalizedDraftForSave(
+    draftChat: MockedChatPreset,
+    selectedSavedChat: MockedChatPreset | null,
+): MockedChatPreset {
+    const nowIso = new Date().toISOString();
+
+    return {
+        ...cloneMockedChatPreset(draftChat),
+        name: draftChat.name.trim() || 'Untitled mocked chat',
+        updatedAt: nowIso,
+        createdAt: selectedSavedChat?.createdAt || draftChat.createdAt || nowIso,
+    };
+}
+
+/**
+ * Creates the saved-copy payload used by "Save as New".
+ *
+ * @private function of <MockedChatsEditorClient/>
+ */
+export function createDraftForSaveAsNew(draftChat: MockedChatPreset): MockedChatPreset {
+    const nowIso = new Date().toISOString();
+
+    return {
+        ...cloneMockedChatPreset(draftChat),
+        id: createMockedChatId(),
+        name: buildCopyName(draftChat.name),
+        createdAt: nowIso,
+        updatedAt: nowIso,
+    };
+}
+
+/**
+ * Builds a user-friendly duplicate name.
+ *
+ * @private function of <MockedChatsEditorClient/>
+ */
+function buildCopyName(name: string): string {
+    const trimmedName = name.trim();
+    if (!trimmedName) {
+        return 'Untitled mocked chat copy';
+    }
+
+    return trimmedName.toLowerCase().endsWith('copy') ? trimmedName : `${trimmedName} copy`;
+}

package/apps/agents-server/src/app/system/utilities/mocked-chats/findMockedChatById.ts

@@ -0,0 +1,51 @@
+import type { MockedChatPreset } from '@/src/utils/mockedChatsSchema';
+
+/**
+ * Finds one mocked chat by id.
+ *
+ * @private function of <MockedChatsEditorClient/>
+ */
+export function findMockedChatById(
+    mockedChats: ReadonlyArray<MockedChatPreset>,
+    mockedChatId: string | null,
+): MockedChatPreset | null {
+    if (!mockedChatId) {
+        return null;
+    }
+
+    return mockedChats.find((mockedChat) => mockedChat.id === mockedChatId) || null;
+}
+
+/**
+ * Checks whether the draft differs from the selected saved chat.
+ *
+ * @private function of <MockedChatsEditorClient/>
+ */
+export function isMockedChatDraftDirty(selectedSavedChat: MockedChatPreset | null, draftChat: MockedChatPreset): boolean {
+    if (!selectedSavedChat) {
+        return true;
+    }
+
+    return JSON.stringify(selectedSavedChat) !== JSON.stringify(draftChat);
+}
+
+/**
+ * Upserts one mocked-chat preset by id while preserving list order by updated date.
+ *
+ * @private function of <MockedChatsEditorClient/>
+ */
+export function upsertMockedChatPreset(
+    presets: ReadonlyArray<MockedChatPreset>,
+    incomingPreset: MockedChatPreset,
+): Array<MockedChatPreset> {
+    const existingIndex = presets.findIndex((preset) => preset.id === incomingPreset.id);
+    const nextPresets = [...presets];
+
+    if (existingIndex === -1) {
+        nextPresets.push(incomingPreset);
+    } else {
+        nextPresets[existingIndex] = incomingPreset;
+    }
+
+    return nextPresets.sort((leftPreset, rightPreset) => Date.parse(rightPreset.updatedAt) - Date.parse(leftPreset.updatedAt));
+}

package/apps/agents-server/src/app/system/utilities/mocked-chats/persistMockedChats.ts

@@ -0,0 +1,51 @@
+import type { MockedChatPreset } from '@/src/utils/mockedChatsSchema';
+
+/**
+ * API endpoint used by the mocked-chat editor.
+ *
+ * @private constant of <MockedChatsEditorClient/>
+ */
+const MOCKED_CHATS_API_ENDPOINT = '/api/system/mocked-chats';
+
+/**
+ * API payload returned by mocked-chat routes.
+ *
+ * @private type of <MockedChatsEditorClient/>
+ */
+type MockedChatsApiPayload = {
+    mockedChats: Array<MockedChatPreset>;
+};
+
+/**
+ * Persists one full mocked-chat list and returns server-normalized records.
+ *
+ * @private function of <MockedChatsEditorClient/>
+ */
+export async function persistMockedChats(nextMockedChats: Array<MockedChatPreset>): Promise<Array<MockedChatPreset>> {
+    const response = await fetch(MOCKED_CHATS_API_ENDPOINT, {
+        method: 'PUT',
+        headers: {
+            'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({ mockedChats: nextMockedChats }),
+    });
+
+    const payload = (await response.json().catch(() => ({}))) as Partial<MockedChatsApiPayload> & {
+        error?: string;
+    };
+
+    if (!response.ok || !Array.isArray(payload.mockedChats)) {
+        throw new Error(payload.error || 'Failed to save mocked chats.');
+    }
+
+    return payload.mockedChats;
+}
+
+/**
+ * Resolves the user-facing error message for one mocked-chat action.
+ *
+ * @private function of <MockedChatsEditorClient/>
+ */
+export function resolveMockedChatsActionErrorMessage(error: unknown, fallbackMessage: string): string {
+    return error instanceof Error ? error.message : fallbackMessage;
+}

package/apps/agents-server/src/app/system/utilities/mocked-chats/useMockedChatsEditorState.ts

@@ -1,27 +1,28 @@
 import { useMemo, useState } from 'react';
-import { showConfirm } from '@/src/components/AsyncDialogs/asyncDialogs';
 import {
     createDefaultMockedChatPreset,
-    createMockedChatId,
-    createMockedChatMessageId,
-    createMockedChatParticipantId,
     type MockedChatParticipant,
     type MockedChatPreset,
     type MockedChatScriptedMessage,
-    type MockedChatSettings,
     type MockedChatTimingPreset,
     type MockedChatViewportPreset,
 } from '@/src/utils/mockedChatsSchema';
-
-/**
- * API endpoint used by the mocked-chat editor.
- */
-const MOCKED_CHATS_API_ENDPOINT = '/api/system/mocked-chats';
-
-/**
- * Fallback offset distance when adding new scripted messages.
- */
-const DEFAULT_NEW_MESSAGE_OFFSET_STEP_MS = 1_200;
+import { cloneMockedChatPreset } from './cloneMockedChatPreset';
+import { confirmDeleteMockedChat } from './confirmDeleteMockedChat';
+import { createDraftForSaveAsNew, createDuplicatedDraft, createNormalizedDraftForSave } from './createDuplicatedDraft';
+import {
+    createDraftWithAddedMessage,
+    createDraftWithRemovedMessage,
+    createDraftWithUpdatedMessage,
+} from './createDraftWithUpdatedMessage';
+import {
+    createDraftWithAddedParticipant,
+    createDraftWithRemovedParticipant,
+    createDraftWithUpdatedParticipant,
+} from './createDraftWithUpdatedParticipant';
+import { createDraftWithUpdatedSettings } from './createDraftWithUpdatedSettings';
+import { findMockedChatById, isMockedChatDraftDirty, upsertMockedChatPreset } from './findMockedChatById';
+import { persistMockedChats, resolveMockedChatsActionErrorMessage } from './persistMockedChats';
 
 /**
  * Props for `useMockedChatsEditorState`.
@@ -30,13 +31,6 @@ type UseMockedChatsEditorStateProps = {
     initialMockedChats: Array<MockedChatPreset>;
 };
 
-/**
- * API payload returned by mocked-chat routes.
- */
-type MockedChatsApiPayload = {
-    mockedChats: Array<MockedChatPreset>;
-};
-
 /**
  * Shared state contract used by the private mocked-chat editor modules.
  *
@@ -92,410 +86,6 @@ type PersistedChatsMutation = {
     applyPersistedChats: (persistedChats: Array<MockedChatPreset>) => void;
 };
 
-/**
- * Clones one mocked-chat preset so editor state does not mutate saved references.
- *
- * @private function of <MockedChatsEditorClient/>
- */
-function cloneMockedChatPreset(preset: MockedChatPreset): MockedChatPreset {
-    return {
-        ...preset,
-        participants: preset.participants.map((participant) => ({ ...participant })),
-        messages: preset.messages.map((message) => ({ ...message })),
-        settings: {
-            ...preset.settings,
-        },
-    };
-}
-
-/**
- * Finds one mocked chat by id.
- *
- * @private function of <MockedChatsEditorClient/>
- */
-function findMockedChatById(
-    mockedChats: ReadonlyArray<MockedChatPreset>,
-    mockedChatId: string | null,
-): MockedChatPreset | null {
-    if (!mockedChatId) {
-        return null;
-    }
-
-    return mockedChats.find((mockedChat) => mockedChat.id === mockedChatId) || null;
-}
-
-/**
- * Checks whether the draft differs from the selected saved chat.
- *
- * @private function of <MockedChatsEditorClient/>
- */
-function isMockedChatDraftDirty(selectedSavedChat: MockedChatPreset | null, draftChat: MockedChatPreset): boolean {
-    if (!selectedSavedChat) {
-        return true;
-    }
-
-    return JSON.stringify(selectedSavedChat) !== JSON.stringify(draftChat);
-}
-
-/**
- * Persists one full mocked-chat list and returns server-normalized records.
- *
- * @private function of <MockedChatsEditorClient/>
- */
-async function persistMockedChats(nextMockedChats: Array<MockedChatPreset>): Promise<Array<MockedChatPreset>> {
-    const response = await fetch(MOCKED_CHATS_API_ENDPOINT, {
-        method: 'PUT',
-        headers: {
-            'Content-Type': 'application/json',
-        },
-        body: JSON.stringify({ mockedChats: nextMockedChats }),
-    });
-
-    const payload = (await response.json().catch(() => ({}))) as Partial<MockedChatsApiPayload> & {
-        error?: string;
-    };
-
-    if (!response.ok || !Array.isArray(payload.mockedChats)) {
-        throw new Error(payload.error || 'Failed to save mocked chats.');
-    }
-
-    return payload.mockedChats;
-}
-
-/**
- * Resolves the user-facing error message for one mocked-chat action.
- *
- * @private function of <MockedChatsEditorClient/>
- */
-function resolveMockedChatsActionErrorMessage(error: unknown, fallbackMessage: string): string {
-    return error instanceof Error ? error.message : fallbackMessage;
-}
-
-/**
- * Requests confirmation before deleting one mocked chat.
- *
- * @private function of <MockedChatsEditorClient/>
- */
-async function confirmDeleteMockedChat(targetChat: MockedChatPreset): Promise<boolean> {
-    return showConfirm({
-        title: 'Delete mocked chat',
-        message: `Delete "${targetChat.name}"? This cannot be undone.`,
-        confirmLabel: 'Delete mocked chat',
-        cancelLabel: 'Cancel',
-    }).catch(() => false);
-}
-
-/**
- * Builds a user-friendly duplicate name.
- *
- * @private function of <MockedChatsEditorClient/>
- */
-function buildCopyName(name: string): string {
-    const trimmedName = name.trim();
-    if (!trimmedName) {
-        return 'Untitled mocked chat copy';
-    }
-
-    return trimmedName.toLowerCase().endsWith('copy') ? trimmedName : `${trimmedName} copy`;
-}
-
-/**
- * Creates a local duplicate draft from the current editor content.
- *
- * @private function of <MockedChatsEditorClient/>
- */
-function createDuplicatedDraft(draftChat: MockedChatPreset): MockedChatPreset {
-    const duplicatedDraft = cloneMockedChatPreset(draftChat);
-    duplicatedDraft.id = createMockedChatId();
-    duplicatedDraft.name = buildCopyName(draftChat.name);
-    duplicatedDraft.createdAt = new Date().toISOString();
-    duplicatedDraft.updatedAt = duplicatedDraft.createdAt;
-    return duplicatedDraft;
-}
-
-/**
- * Normalizes the draft before saving it over its current id.
- *
- * @private function of <MockedChatsEditorClient/>
- */
-function createNormalizedDraftForSave(
-    draftChat: MockedChatPreset,
-    selectedSavedChat: MockedChatPreset | null,
-): MockedChatPreset {
-    const nowIso = new Date().toISOString();
-
-    return {
-        ...cloneMockedChatPreset(draftChat),
-        name: draftChat.name.trim() || 'Untitled mocked chat',
-        updatedAt: nowIso,
-        createdAt: selectedSavedChat?.createdAt || draftChat.createdAt || nowIso,
-    };
-}
-
-/**
- * Creates the saved-copy payload used by "Save as New".
- *
- * @private function of <MockedChatsEditorClient/>
- */
-function createDraftForSaveAsNew(draftChat: MockedChatPreset): MockedChatPreset {
-    const nowIso = new Date().toISOString();
-
-    return {
-        ...cloneMockedChatPreset(draftChat),
-        id: createMockedChatId(),
-        name: buildCopyName(draftChat.name),
-        createdAt: nowIso,
-        updatedAt: nowIso,
-    };
-}
-
-/**
- * Upserts one mocked-chat preset by id while preserving list order by updated date.
- *
- * @private function of <MockedChatsEditorClient/>
- */
-function upsertMockedChatPreset(
-    presets: ReadonlyArray<MockedChatPreset>,
-    incomingPreset: MockedChatPreset,
-): Array<MockedChatPreset> {
-    const existingIndex = presets.findIndex((preset) => preset.id === incomingPreset.id);
-    const nextPresets = [...presets];
-
-    if (existingIndex === -1) {
-        nextPresets.push(incomingPreset);
-    } else {
-        nextPresets[existingIndex] = incomingPreset;
-    }
-
-    return nextPresets.sort((leftPreset, rightPreset) => Date.parse(rightPreset.updatedAt) - Date.parse(leftPreset.updatedAt));
-}
-
-/**
- * Creates one participant draft with deterministic defaults.
- *
- * @private function of <MockedChatsEditorClient/>
- */
-function createDraftParticipant(participantCount: number): MockedChatParticipant {
-    return {
-        id: createMockedChatParticipantId(),
-        name: `Participant ${participantCount + 1}`,
-        isMe: participantCount === 0,
-        bubbleColor: '#2563eb',
-        avatarUrl: null,
-        typingAvatarUrl: null,
-    };
-}
-
-/**
- * Ensures at least one participant remains marked as `isMe`.
- *
- * @private function of <MockedChatsEditorClient/>
- */
-function ensureParticipantMarkedAsMe(participants: Array<MockedChatParticipant>): Array<MockedChatParticipant> {
-    if (participants.some((participant) => participant.isMe) || participants.length === 0) {
-        return participants;
-    }
-
-    const nextParticipants = [...participants];
-    nextParticipants[0] = {
-        ...nextParticipants[0],
-        isMe: true,
-    };
-    return nextParticipants;
-}
-
-/**
- * Reconciles message sender ids after participant changes.
- *
- * @private function of <MockedChatsEditorClient/>
- */
-function reconcileMessageSenderIds(
-    messages: ReadonlyArray<MockedChatScriptedMessage>,
-    participants: ReadonlyArray<MockedChatParticipant>,
-    fallbackSenderId: string,
-): Array<MockedChatScriptedMessage> {
-    return messages.map((message) => ({
-        ...message,
-        senderId: participants.some((participant) => participant.id === message.senderId)
-            ? message.senderId
-            : fallbackSenderId,
-    }));
-}
-
-/**
- * Applies one participant field update and keeps the "me" invariant.
- *
- * @private function of <MockedChatsEditorClient/>
- */
-function updateParticipantsAfterFieldChange<TField extends keyof MockedChatParticipant>(
-    participants: ReadonlyArray<MockedChatParticipant>,
-    participantId: string,
-    field: TField,
-    value: MockedChatParticipant[TField],
-): Array<MockedChatParticipant> {
-    let nextParticipants = participants.map((participant) => {
-        if (participant.id !== participantId) {
-            return participant;
-        }
-
-        return {
-            ...participant,
-            [field]: value,
-        };
-    });
-
-    if (field === 'isMe' && value === true) {
-        nextParticipants = nextParticipants.map((participant) => ({
-            ...participant,
-            isMe: participant.id === participantId,
-        }));
-    }
-
-    return nextParticipants;
-}
-
-/**
- * Resolves the participant used for newly added scripted messages.
- *
- * @private function of <MockedChatsEditorClient/>
- */
-function resolveDefaultMessageSenderId(participants: ReadonlyArray<MockedChatParticipant>): string {
-    return participants.find((participant) => participant.isMe)?.id || participants[0]?.id || 'USER';
-}
-
-/**
- * Adds one participant to the current draft.
- *
- * @private function of <MockedChatsEditorClient/>
- */
-function createDraftWithAddedParticipant(previousDraft: MockedChatPreset): MockedChatPreset {
-    const nextParticipants = [...previousDraft.participants, createDraftParticipant(previousDraft.participants.length)];
-
-    return {
-        ...previousDraft,
-        participants: nextParticipants,
-    };
-}
-
-/**
- * Updates one participant field in the draft.
- *
- * @private function of <MockedChatsEditorClient/>
- */
-function createDraftWithUpdatedParticipant<TField extends keyof MockedChatParticipant>(
-    previousDraft: MockedChatPreset,
-    participantId: string,
-    field: TField,
-    value: MockedChatParticipant[TField],
-): MockedChatPreset {
-    const nextParticipants = updateParticipantsAfterFieldChange(previousDraft.participants, participantId, field, value);
-    const fallbackSenderId = nextParticipants[0]?.id || previousDraft.messages[0]?.senderId || 'USER';
-
-    return {
-        ...previousDraft,
-        participants: nextParticipants,
-        messages: reconcileMessageSenderIds(previousDraft.messages, nextParticipants, fallbackSenderId),
-    };
-}
-
-/**
- * Removes one participant from the draft.
- *
- * @private function of <MockedChatsEditorClient/>
- */
-function createDraftWithRemovedParticipant(previousDraft: MockedChatPreset, participantId: string): MockedChatPreset {
-    const remainingParticipants = previousDraft.participants.filter((participant) => participant.id !== participantId);
-    if (remainingParticipants.length === 0) {
-        return previousDraft;
-    }
-
-    const nextParticipants = ensureParticipantMarkedAsMe(remainingParticipants);
-    const fallbackSenderId = nextParticipants[0]?.id || 'USER';
-
-    return {
-        ...previousDraft,
-        participants: nextParticipants,
-        messages: reconcileMessageSenderIds(previousDraft.messages, nextParticipants, fallbackSenderId),
-    };
-}
-
-/**
- * Adds one scripted message at the end of the sequence.
- *
- * @private function of <MockedChatsEditorClient/>
- */
-function createDraftWithAddedMessage(previousDraft: MockedChatPreset): MockedChatPreset {
-    const previousOffset = previousDraft.messages[previousDraft.messages.length - 1]?.offsetMs || 0;
-
-    const nextMessage: MockedChatScriptedMessage = {
-        id: createMockedChatMessageId(),
-        senderId: resolveDefaultMessageSenderId(previousDraft.participants),
-        content: 'New scripted message',
-        offsetMs: previousOffset + DEFAULT_NEW_MESSAGE_OFFSET_STEP_MS,
-    };
-
-    return {
-        ...previousDraft,
-        messages: [...previousDraft.messages, nextMessage],
-    };
-}
-
-/**
- * Updates one scripted message field.
- *
- * @private function of <MockedChatsEditorClient/>
- */
-function createDraftWithUpdatedMessage<TField extends keyof MockedChatScriptedMessage>(
-    previousDraft: MockedChatPreset,
-    messageId: string,
-    field: TField,
-    value: MockedChatScriptedMessage[TField],
-): MockedChatPreset {
-    return {
-        ...previousDraft,
-        messages: previousDraft.messages.map((message) => {
-            if (message.id !== messageId) {
-                return message;
-            }
-
-            return {
-                ...message,
-                [field]: value,
-            };
-        }),
-    };
-}
-
-/**
- * Removes one scripted message.
- *
- * @private function of <MockedChatsEditorClient/>
- */
-function createDraftWithRemovedMessage(previousDraft: MockedChatPreset, messageId: string): MockedChatPreset {
-    return {
-        ...previousDraft,
-        messages: previousDraft.messages.filter((message) => message.id !== messageId),
-    };
-}
-
-/**
- * Applies one settings patch to the draft.
- *
- * @private function of <MockedChatsEditorClient/>
- */
-function createDraftWithUpdatedSettings(
-    previousDraft: MockedChatPreset,
-    settingsPatch: Partial<MockedChatSettings>,
-): MockedChatPreset {
-    return {
-        ...previousDraft,
-        settings: {
-            ...previousDraft.settings,
-            ...settingsPatch,
-        },
-    };
-}
-
 /**
  * Manages mocked-chat editor state, persistence, and draft mutations.
  *

package/apps/agents-server/src/components/AgentAvatar/AgentAvatar.tsx

@@ -78,7 +78,7 @@ type AgentAvatarProps = {
 
 /**
  * Renders either the explicit agent image or the shared animated default avatar visual.
- * Agent-level `META AVATAR` values are resolved before the federated server default and the
+ * Agent-level `META AVATAR` / `META VISUAL` values are resolved before the federated server default and the
  * local server metadata default.
  *
  * @private shared component of Agents Server

package/apps/agents-server/src/components/AgentAvatar/DefaultAgentAvatarVisualProvider.tsx

@@ -14,7 +14,7 @@ type DefaultAgentAvatarVisualProviderProps = {
     readonly children: ReactNode;
 
     /**
-     * Metadata-resolved built-in visual id used when an agent has no `META IMAGE` or `META AVATAR`.
+     * Metadata-resolved built-in visual id used when an agent has no `META IMAGE`, `META AVATAR`, or `META VISUAL`.
      */
     readonly defaultAgentAvatarVisualId: AvatarVisualId;
 };