@promptbook/cli 0.113.0-1 → 0.113.0-10

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

@@ -0,0 +1,146 @@
+import {
+    createMockedChatParticipantId,
+    type MockedChatParticipant,
+    type MockedChatPreset,
+    type MockedChatScriptedMessage,
+} from '@/src/utils/mockedChatsSchema';
+
+/**
+ * Adds one participant to the current draft.
+ *
+ * @private function of <MockedChatsEditorClient/>
+ */
+export 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/>
+ */
+export 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/>
+ */
+export 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),
+    };
+}
+
+/**
+ * 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;
+}

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;
+}