@memberjunction/ng-conversations 6.2.0-edge.3 → 6.2.0-edge.5

package/dist/lib/services/conversation-naming.js

@@ -4,16 +4,15 @@ import { GraphQLAIClient } from '@memberjunction/graphql-dataprovider';
 import { ConversationEngine } from '@memberjunction/core-entities';
 /** The seeded name of the AI prompt that generates conversation names. */
 export const NAME_CONVERSATION_PROMPT = 'Name Conversation';
+/** Longest fork name the `MJ: Conversation Branches` Name field holds. */
+export const MAX_FORK_NAME_LENGTH = 255;
 /**
- * Generates a name + description for a conversation from its first message and SAVES it
- * (DB + engine cache) — the single naming implementation shared by the regular composer
- * and the realtime session path.
+ * Runs the `Name Conversation` prompt on a message and parses its `{ name, description }`. Saves nothing.
  *
- * @returns The applied `{ Name, Description }`, or `null` when naming was skipped/failed
- * (missing prompt, provider unavailable, timeout, unparseable output, save failure) —
- * the conversation keeps its current name in every null case.
+ * @returns The generated `{ Name, Description }`, or `null` when the prompt is missing, the provider is
+ * unavailable, the run fails or times out, or the output has no name. Failures are logged.
  */
-export async function GenerateAndApplyConversationName(options) {
+export async function GenerateConversationName(options) {
     try {
         await AIEngineBase.Instance.Config(false);
         const prompt = AIEngineBase.Instance.Prompts.find(pr => pr.Name === NAME_CONVERSATION_PROMPT);
@@ -31,28 +30,110 @@ export async function GenerateAndApplyConversationName(options) {
                 messages: [{ role: 'user', content: messageText }]
             }));
         const timeoutMs = options.TimeoutMs ?? 30000;
+        let timeoutHandle;
         const timeoutPromise = new Promise((_, reject) => {
-            setTimeout(() => reject(new Error(`Conversation naming timed out after ${Math.round(timeoutMs / 1000)} seconds`)), timeoutMs);
+            timeoutHandle = setTimeout(() => reject(new Error(`Conversation naming timed out after ${Math.round(timeoutMs / 1000)} seconds`)), timeoutMs);
         });
-        const result = await Promise.race([run(prompt.ID, options.MessageText), timeoutPromise]);
+        let result;
+        try {
+            result = await Promise.race([run(prompt.ID, options.MessageText), timeoutPromise]);
+        }
+        finally {
+            clearTimeout(timeoutHandle);
+        }
         if (!result || !result.success || (!result.parsedResult && !result.output)) {
             return null;
         }
         // parsedResult preferred; CleanAndParseJSON tolerates ```json fences in raw output.
         const parsed = (result.parsedResult ?? (result.output ? CleanAndParseJSON(result.output) : null));
-        if (!parsed?.name) {
+        const name = typeof parsed?.name === 'string' ? parsed.name.trim() : '';
+        if (!name) {
             return null;
         }
-        const saved = await ConversationEngine.Instance.SaveConversation(options.ConversationId, { Name: parsed.name, Description: parsed.description || '' }, options.CurrentUser);
+        return { Name: name, Description: parsed?.description || '' };
+    }
+    catch (error) {
+        console.warn('⚠️ Conversation naming failed (the current name stays):', error);
+        return null;
+    }
+}
+/**
+ * Generates a name + description for a conversation from its first message and SAVES it
+ * (DB + engine cache) — the single naming implementation shared by the regular composer
+ * and the realtime session path.
+ *
+ * @returns The applied `{ Name, Description }`, or `null` when naming was skipped/failed
+ * (missing prompt, provider unavailable, timeout, unparseable output, save failure) —
+ * the conversation keeps its current name in every null case.
+ */
+export async function GenerateAndApplyConversationName(options) {
+    const generated = await GenerateConversationName(options);
+    if (!generated) {
+        return null;
+    }
+    try {
+        const saved = await ConversationEngine.Instance.SaveConversation(options.ConversationId, { Name: generated.Name, Description: generated.Description }, options.CurrentUser);
         if (!saved) {
             console.warn('⚠️ Conversation naming generated a name but the save failed');
             return null;
         }
-        return { Name: parsed.name, Description: parsed.description || '' };
+        return generated;
     }
     catch (error) {
         console.warn('⚠️ Conversation naming failed (conversation keeps its default name):', error);
         return null;
     }
 }
+/**
+ * Saves a fork's Name through the `MJ: Conversation Branches` entity, after reading the row fresh.
+ *
+ * @returns true when the name was saved; false when the row cannot be read, when `OnlyIfUnnamed` is
+ * set and the row has a name, or when the save fails (logged).
+ * @throws when the entity read or save throws
+ */
+export async function SaveForkName(options) {
+    const fork = await options.Provider.GetEntityObject('MJ: Conversation Branches', options.CurrentUser);
+    if (!(await fork.Load(options.ForkId))) {
+        console.warn(`⚠️ Could not read fork ${options.ForkId} to save its name`);
+        return false;
+    }
+    if (options.OnlyIfUnnamed && fork.Name?.trim()) {
+        return false;
+    }
+    const name = options.Name?.trim().slice(0, MAX_FORK_NAME_LENGTH).trim();
+    fork.Name = name ? name : null;
+    if (!(await fork.Save())) {
+        console.warn(`⚠️ Could not save the name of fork ${options.ForkId}: ${fork.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+        return false;
+    }
+    return true;
+}
+/**
+ * Names a fork from its first message: runs the `Name Conversation` prompt ({@link GenerateConversationName})
+ * and saves the name as the fork's Name only when the fork, read fresh right before the save, still has
+ * no name, so a person's rename wins.
+ *
+ * @returns The saved name, or `null` when naming failed, the fork already has a name, or the save failed.
+ * Failures are logged.
+ */
+export async function GenerateAndApplyForkName(options) {
+    const generated = await GenerateConversationName(options);
+    if (!generated) {
+        return null;
+    }
+    try {
+        const saved = await SaveForkName({
+            ForkId: options.ForkId,
+            Name: generated.Name,
+            Provider: options.Provider,
+            CurrentUser: options.CurrentUser,
+            OnlyIfUnnamed: true,
+        });
+        return saved ? generated.Name.slice(0, MAX_FORK_NAME_LENGTH).trim() : null;
+    }
+    catch (error) {
+        console.warn(`⚠️ Fork naming failed (fork ${options.ForkId} keeps its current name):`, error);
+        return null;
+    }
+}
 //# sourceMappingURL=conversation-naming.js.map

package/dist/lib/services/conversation-naming.js.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-naming.js","sourceRoot":"","sources":["../../../src/lib/services/conversation-naming.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview Shared conversation auto-naming helper — extracted from the message\n * input's first-message naming flow so BOTH chat paths use one implementation:\n *\n *  - **Regular chat**: the composer names a brand-new conversation from its first\n *    user message (the original behavior, now delegated here).\n *  - **Realtime sessions**: a voice call that created a fresh conversation names it\n *    from the first user utterance when the call ends.\n *\n * The naming itself is DB-driven: the `Name Conversation` AI prompt runs through the\n * GraphQL AI client (same path agents use) with a timeout guard; the parsed\n * `{ name, description }` is saved through {@link ConversationEngine.SaveConversation},\n * which updates the engine's cached conversation list in place (the sidebar reacts\n * through the engine's observables). Failures are logged and return `null` — naming is\n * always best-effort background work that must never affect the user experience.\n */\nimport { UserInfo } from '@memberjunction/core';\nimport { CleanAndParseJSON } from '@memberjunction/global';\nimport { AIEngineBase } from '@memberjunction/ai-engine-base';\nimport { GraphQLDataProvider, GraphQLAIClient } from '@memberjunction/graphql-dataprovider';\nimport { ConversationEngine } from '@memberjunction/core-entities';\n\n/** The applied result of a successful auto-naming run. */\nexport interface ConversationNameResult {\n  /** The generated conversation name (already saved). */\n  Name: string;\n  /** The generated description (already saved; empty string when the prompt omitted it). */\n  Description: string;\n}\n\n/** Options for {@link GenerateAndApplyConversationName}. */\nexport interface GenerateConversationNameOptions {\n  /** The conversation to name (must exist; the caller owns membership checks). */\n  ConversationId: string;\n  /**\n   * The text the name is derived from — the first user message (regular chat) or the\n   * first spoken user utterance (realtime). Callers strip mentions/markup first.\n   */\n  MessageText: string;\n  /** The GraphQL provider the AI client runs over. */\n  Provider: GraphQLDataProvider;\n  /** The acting user (threaded into the conversation save). */\n  CurrentUser: UserInfo;\n  /** Abort guard for the prompt run. Default 30s — the conversation keeps its default name on timeout. */\n  TimeoutMs?: number;\n  /**\n   * Test seam: overrides the prompt execution. Production leaves this undefined and the\n   * helper runs the `Name Conversation` prompt via {@link GraphQLAIClient.RunAIPrompt}.\n   */\n  RunPrompt?: (promptId: string, messageText: string) => Promise<{ success: boolean; parsedResult?: unknown; output?: string } | null>;\n}\n\n/** The seeded name of the AI prompt that generates conversation names. */\nexport const NAME_CONVERSATION_PROMPT = 'Name Conversation';\n\n/**\n * Generates a name + description for a conversation from its first message and SAVES it\n * (DB + engine cache) — the single naming implementation shared by the regular composer\n * and the realtime session path.\n *\n * @returns The applied `{ Name, Description }`, or `null` when naming was skipped/failed\n * (missing prompt, provider unavailable, timeout, unparseable output, save failure) —\n * the conversation keeps its current name in every null case.\n */\nexport async function GenerateAndApplyConversationName(\n  options: GenerateConversationNameOptions\n): Promise<ConversationNameResult | null> {\n  try {\n    await AIEngineBase.Instance.Config(false);\n    const prompt = AIEngineBase.Instance.Prompts.find(pr => pr.Name === NAME_CONVERSATION_PROMPT);\n    if (!prompt) {\n      console.warn(`⚠️ ${NAME_CONVERSATION_PROMPT} prompt not found`);\n      return null;\n    }\n    if (!options.Provider) {\n      console.warn('⚠️ GraphQLDataProvider not available for conversation naming');\n      return null;\n    }\n\n    const run = options.RunPrompt\n      ?? ((promptId: string, messageText: string) =>\n        new GraphQLAIClient(options.Provider).RunAIPrompt({\n          promptId,\n          messages: [{ role: 'user', content: messageText }]\n        }));\n\n    const timeoutMs = options.TimeoutMs ?? 30000;\n    const timeoutPromise = new Promise<never>((_, reject) => {\n      setTimeout(() => reject(new Error(`Conversation naming timed out after ${Math.round(timeoutMs / 1000)} seconds`)), timeoutMs);\n    });\n\n    const result = await Promise.race([run(prompt.ID, options.MessageText), timeoutPromise]);\n    if (!result || !result.success || (!result.parsedResult && !result.output)) {\n      return null;\n    }\n\n    // parsedResult preferred; CleanAndParseJSON tolerates ```json fences in raw output.\n    const parsed = (result.parsedResult ?? (result.output ? CleanAndParseJSON(result.output) : null)) as\n      | { name?: string; description?: string }\n      | null;\n    if (!parsed?.name) {\n      return null;\n    }\n\n    const saved = await ConversationEngine.Instance.SaveConversation(\n      options.ConversationId,\n      { Name: parsed.name, Description: parsed.description || '' },\n      options.CurrentUser\n    );\n    if (!saved) {\n      console.warn('⚠️ Conversation naming generated a name but the save failed');\n      return null;\n    }\n    return { Name: parsed.name, Description: parsed.description || '' };\n  } catch (error) {\n    console.warn('⚠️ Conversation naming failed (conversation keeps its default name):', error);\n    return null;\n  }\n}\n"]}
+{"version":3,"file":"conversation-naming.js","sourceRoot":"","sources":["../../../src/lib/services/conversation-naming.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview Shared conversation auto-naming helper — extracted from the message\n * input's first-message naming flow so BOTH chat paths use one implementation:\n *\n *  - **Regular chat**: the composer names a brand-new conversation from its first\n *    user message (the original behavior, now delegated here).\n *  - **Realtime sessions**: a voice call that created a fresh conversation names it\n *    from the first user utterance when the call ends.\n *  - **Forks**: a Fork or Edit fork is named from the first message sent into it, when it\n *    still has no name ({@link GenerateAndApplyForkName}).\n *\n * The naming itself is DB-driven: the `Name Conversation` AI prompt runs through the\n * GraphQL AI client (same path agents use) with a timeout guard ({@link GenerateConversationName}).\n * A conversation's parsed `{ name, description }` is saved through\n * {@link ConversationEngine.SaveConversation}, which updates the engine's cached conversation\n * list in place (the sidebar reacts through the engine's observables); a fork's name is saved\n * on its `MJ: Conversation Branches` row. Failures are logged and return `null` — naming is\n * always best-effort background work that must never affect the user experience.\n */\nimport { IMetadataProvider, UserInfo } from '@memberjunction/core';\nimport { CleanAndParseJSON } from '@memberjunction/global';\nimport { AIEngineBase } from '@memberjunction/ai-engine-base';\nimport { GraphQLDataProvider, GraphQLAIClient, type RunAIPromptResult } from '@memberjunction/graphql-dataprovider';\nimport { ConversationEngine, type MJConversationBranchEntity } from '@memberjunction/core-entities';\n\n/** The result of a successful naming run. */\nexport interface ConversationNameResult {\n  /** The generated name, trimmed. */\n  Name: string;\n  /** The generated description; empty string when the prompt omitted it. */\n  Description: string;\n}\n\n/** The prompt runner {@link GenerateConversationName} calls; a test seam for the GraphQL AI client. */\nexport type NamePromptRunner = (\n  promptId: string,\n  messageText: string\n) => Promise<Pick<RunAIPromptResult, 'success' | 'parsedResult' | 'output'> | null>;\n\n/** Options for {@link GenerateConversationName}. */\nexport interface GenerateNameOptions {\n  /**\n   * The text the name is derived from — the first user message (regular chat and forks) or the\n   * first spoken user utterance (realtime). Callers strip mentions/markup first.\n   */\n  MessageText: string;\n  /** The GraphQL provider the AI client runs over. */\n  Provider: GraphQLDataProvider;\n  /** Abort guard for the prompt run. Default 30s — the target keeps its current name on timeout. */\n  TimeoutMs?: number;\n  /**\n   * Test seam: overrides the prompt execution. Production leaves this undefined and the\n   * helper runs the `Name Conversation` prompt via {@link GraphQLAIClient.RunAIPrompt}.\n   */\n  RunPrompt?: NamePromptRunner;\n}\n\n/** Options for {@link GenerateAndApplyConversationName}. */\nexport interface GenerateConversationNameOptions extends GenerateNameOptions {\n  /** The conversation to name (must exist; the caller owns membership checks). */\n  ConversationId: string;\n  /** The acting user (threaded into the conversation save). */\n  CurrentUser: UserInfo;\n}\n\n/** Options for {@link GenerateAndApplyForkName}. */\nexport interface GenerateForkNameOptions extends GenerateNameOptions {\n  /** The fork (`MJ: Conversation Branches` row) to name. */\n  ForkId: string;\n  /** The acting user; the branch entity's write rule applies to the save. */\n  CurrentUser: UserInfo;\n}\n\n/** The seeded name of the AI prompt that generates conversation names. */\nexport const NAME_CONVERSATION_PROMPT = 'Name Conversation';\n\n/** Longest fork name the `MJ: Conversation Branches` Name field holds. */\nexport const MAX_FORK_NAME_LENGTH = 255;\n\n/**\n * Runs the `Name Conversation` prompt on a message and parses its `{ name, description }`. Saves nothing.\n *\n * @returns The generated `{ Name, Description }`, or `null` when the prompt is missing, the provider is\n * unavailable, the run fails or times out, or the output has no name. Failures are logged.\n */\nexport async function GenerateConversationName(options: GenerateNameOptions): Promise<ConversationNameResult | null> {\n  try {\n    await AIEngineBase.Instance.Config(false);\n    const prompt = AIEngineBase.Instance.Prompts.find(pr => pr.Name === NAME_CONVERSATION_PROMPT);\n    if (!prompt) {\n      console.warn(`⚠️ ${NAME_CONVERSATION_PROMPT} prompt not found`);\n      return null;\n    }\n    if (!options.Provider) {\n      console.warn('⚠️ GraphQLDataProvider not available for conversation naming');\n      return null;\n    }\n\n    const run: NamePromptRunner = options.RunPrompt\n      ?? ((promptId: string, messageText: string) =>\n        new GraphQLAIClient(options.Provider).RunAIPrompt({\n          promptId,\n          messages: [{ role: 'user', content: messageText }]\n        }));\n\n    const timeoutMs = options.TimeoutMs ?? 30000;\n    let timeoutHandle: ReturnType<typeof setTimeout> | undefined;\n    const timeoutPromise = new Promise<never>((_, reject) => {\n      timeoutHandle = setTimeout(() => reject(new Error(`Conversation naming timed out after ${Math.round(timeoutMs / 1000)} seconds`)), timeoutMs);\n    });\n\n    let result: Awaited<ReturnType<NamePromptRunner>>;\n    try {\n      result = await Promise.race([run(prompt.ID, options.MessageText), timeoutPromise]);\n    } finally {\n      clearTimeout(timeoutHandle);\n    }\n    if (!result || !result.success || (!result.parsedResult && !result.output)) {\n      return null;\n    }\n\n    // parsedResult preferred; CleanAndParseJSON tolerates ```json fences in raw output.\n    const parsed = (result.parsedResult ?? (result.output ? CleanAndParseJSON(result.output) : null)) as\n      | { name?: string; description?: string }\n      | null;\n    const name = typeof parsed?.name === 'string' ? parsed.name.trim() : '';\n    if (!name) {\n      return null;\n    }\n    return { Name: name, Description: parsed?.description || '' };\n  } catch (error) {\n    console.warn('⚠️ Conversation naming failed (the current name stays):', error);\n    return null;\n  }\n}\n\n/**\n * Generates a name + description for a conversation from its first message and SAVES it\n * (DB + engine cache) — the single naming implementation shared by the regular composer\n * and the realtime session path.\n *\n * @returns The applied `{ Name, Description }`, or `null` when naming was skipped/failed\n * (missing prompt, provider unavailable, timeout, unparseable output, save failure) —\n * the conversation keeps its current name in every null case.\n */\nexport async function GenerateAndApplyConversationName(\n  options: GenerateConversationNameOptions\n): Promise<ConversationNameResult | null> {\n  const generated = await GenerateConversationName(options);\n  if (!generated) {\n    return null;\n  }\n  try {\n    const saved = await ConversationEngine.Instance.SaveConversation(\n      options.ConversationId,\n      { Name: generated.Name, Description: generated.Description },\n      options.CurrentUser\n    );\n    if (!saved) {\n      console.warn('⚠️ Conversation naming generated a name but the save failed');\n      return null;\n    }\n    return generated;\n  } catch (error) {\n    console.warn('⚠️ Conversation naming failed (conversation keeps its default name):', error);\n    return null;\n  }\n}\n\n/** Options for {@link SaveForkName}. */\nexport interface SaveForkNameOptions {\n  /** The fork (`MJ: Conversation Branches` row) to name. */\n  ForkId: string;\n  /** The new name; null or blank clears it, so the default label shows. Cut to {@link MAX_FORK_NAME_LENGTH}. */\n  Name: string | null;\n  /** The provider the branch entity is read and saved through. */\n  Provider: IMetadataProvider;\n  /** The acting user; the branch entity's write rule applies. */\n  CurrentUser: UserInfo;\n  /** When true, saves nothing if the row read fresh already has a name. */\n  OnlyIfUnnamed?: boolean;\n}\n\n/**\n * Saves a fork's Name through the `MJ: Conversation Branches` entity, after reading the row fresh.\n *\n * @returns true when the name was saved; false when the row cannot be read, when `OnlyIfUnnamed` is\n * set and the row has a name, or when the save fails (logged).\n * @throws when the entity read or save throws\n */\nexport async function SaveForkName(options: SaveForkNameOptions): Promise<boolean> {\n  const fork = await options.Provider.GetEntityObject<MJConversationBranchEntity>('MJ: Conversation Branches', options.CurrentUser);\n  if (!(await fork.Load(options.ForkId))) {\n    console.warn(`⚠️ Could not read fork ${options.ForkId} to save its name`);\n    return false;\n  }\n  if (options.OnlyIfUnnamed && fork.Name?.trim()) {\n    return false;\n  }\n  const name = options.Name?.trim().slice(0, MAX_FORK_NAME_LENGTH).trim();\n  fork.Name = name ? name : null;\n  if (!(await fork.Save())) {\n    console.warn(`⚠️ Could not save the name of fork ${options.ForkId}: ${fork.LatestResult?.CompleteMessage ?? 'unknown error'}`);\n    return false;\n  }\n  return true;\n}\n\n/**\n * Names a fork from its first message: runs the `Name Conversation` prompt ({@link GenerateConversationName})\n * and saves the name as the fork's Name only when the fork, read fresh right before the save, still has\n * no name, so a person's rename wins.\n *\n * @returns The saved name, or `null` when naming failed, the fork already has a name, or the save failed.\n * Failures are logged.\n */\nexport async function GenerateAndApplyForkName(options: GenerateForkNameOptions): Promise<string | null> {\n  const generated = await GenerateConversationName(options);\n  if (!generated) {\n    return null;\n  }\n  try {\n    const saved = await SaveForkName({\n      ForkId: options.ForkId,\n      Name: generated.Name,\n      Provider: options.Provider,\n      CurrentUser: options.CurrentUser,\n      OnlyIfUnnamed: true,\n    });\n    return saved ? generated.Name.slice(0, MAX_FORK_NAME_LENGTH).trim() : null;\n  } catch (error) {\n    console.warn(`⚠️ Fork naming failed (fork ${options.ForkId} keeps its current name):`, error);\n    return null;\n  }\n}\n"]}

package/dist/lib/services/conversation-tasks-filter.d.ts

@@ -0,0 +1,15 @@
+import { type IMetadataProvider, type UserInfo } from '@memberjunction/core';
+/** The ExtraFilter for the top-level tasks a user owns. */
+export declare function OwnTasksFilter(user: UserInfo): string;
+/**
+ * The ExtraFilter for the top-level tasks the conversations UI shows a user: the tasks the user
+ * owns, and the tasks linked to a message the user wrote or that is in a conversation the user
+ * owns.
+ *
+ * The conversation and message IDs are read with their own RunView, so the row-level security on
+ * those entities applies. A subquery over their views would skip it, and the server refuses one
+ * for a user whose read of them is row-filtered. When a read fails, the result is the user's own
+ * tasks.
+ */
+export declare function BuildConversationTasksFilter(provider: IMetadataProvider, user: UserInfo): Promise<string>;
+//# sourceMappingURL=conversation-tasks-filter.d.ts.map

package/dist/lib/services/conversation-tasks-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-tasks-filter.d.ts","sourceRoot":"","sources":["../../../src/lib/services/conversation-tasks-filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,KAAK,iBAAiB,EAAsB,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAG3H,2DAA2D;AAC3D,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAErD;AAED;;;;;;;;;GASG;AACH,wBAAsB,4BAA4B,CAAC,QAAQ,EAAE,iBAAiB,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAwB/G"}

package/dist/lib/services/conversation-tasks-filter.js

@@ -0,0 +1,69 @@
+import { RunView } from '@memberjunction/core';
+import { EscapeSQLString } from '@memberjunction/global';
+/** The ExtraFilter for the top-level tasks a user owns. */
+export function OwnTasksFilter(user) {
+    return `ParentID IS NULL AND UserID = '${EscapeSQLString(user.ID)}'`;
+}
+/**
+ * The ExtraFilter for the top-level tasks the conversations UI shows a user: the tasks the user
+ * owns, and the tasks linked to a message the user wrote or that is in a conversation the user
+ * owns.
+ *
+ * The conversation and message IDs are read with their own RunView, so the row-level security on
+ * those entities applies. A subquery over their views would skip it, and the server refuses one
+ * for a user whose read of them is row-filtered. When a read fails, the result is the user's own
+ * tasks.
+ */
+export async function BuildConversationTasksFilter(provider, user) {
+    const ownTasks = OwnTasksFilter(user);
+    const tasks = provider.EntityByName('MJ: Tasks');
+    if (!tasks) {
+        return ownTasks;
+    }
+    const rv = RunView.FromMetadataProvider(provider);
+    const conversationIds = await readIds(rv, user, {
+        EntityName: 'MJ: Conversations',
+        ExtraFilter: `UserID = '${EscapeSQLString(user.ID)}'`,
+        Fields: ['ID'],
+    });
+    if (conversationIds == null) {
+        return ownTasks;
+    }
+    const messageIds = await readIds(rv, user, {
+        EntityName: 'MJ: Conversation Details',
+        ExtraFilter: taskMessagesFilter(user, conversationIds, tasks),
+        Fields: ['ID'],
+    });
+    if (messageIds == null || messageIds.length === 0) {
+        return ownTasks;
+    }
+    return `ParentID IS NULL AND (UserID = '${EscapeSQLString(user.ID)}' OR ConversationDetailID IN (${sqlInList(messageIds)}))`;
+}
+/**
+ * The messages that have a top-level task and that the user wrote or that are in one of the
+ * user's conversations. The task subquery reads Tasks, which has no row filter in a default
+ * install. Its identifiers are bracketed so the PostgreSQL provider quotes them.
+ */
+function taskMessagesFilter(user, conversationIds, tasks) {
+    const inConversations = conversationIds.length > 0 ? ` OR ConversationID IN (${sqlInList(conversationIds)})` : '';
+    const taskView = `[${tasks.SchemaName}].[${tasks.BaseView}]`;
+    return (`(UserID = '${EscapeSQLString(user.ID)}'${inConversations}) AND ID IN ` +
+        `(SELECT [ConversationDetailID] FROM ${taskView} WHERE [ParentID] IS NULL AND [ConversationDetailID] IS NOT NULL)`);
+}
+/**
+ * The IDs of the rows `read` selects, with no row cap; null when the read fails. Each caller names
+ * an MJ core entity in `read`, so its key column is `ID`.
+ */
+async function readIds(rv, user, read) {
+    const result = await rv.RunView({ ...read, ResultType: 'simple', IgnoreMaxRows: true }, user);
+    if (!result.Success) {
+        console.error(`Failed to read ${read.EntityName} for the tasks filter:`, result.ErrorMessage);
+        return null;
+    }
+    return (result.Results ?? []).map(row => row.ID);
+}
+/** A quoted, comma-separated list of IDs for an IN clause. */
+function sqlInList(ids) {
+    return ids.map(id => `'${EscapeSQLString(id)}'`).join(',');
+}
+//# sourceMappingURL=conversation-tasks-filter.js.map

package/dist/lib/services/conversation-tasks-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-tasks-filter.js","sourceRoot":"","sources":["../../../src/lib/services/conversation-tasks-filter.ts"],"names":[],"mappings":"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","sourcesContent":["import { RunView, type EntityInfo, type IMetadataProvider, type RunViewParams, type UserInfo } from '@memberjunction/core';\nimport { EscapeSQLString } from '@memberjunction/global';\n\n/** The ExtraFilter for the top-level tasks a user owns. */\nexport function OwnTasksFilter(user: UserInfo): string {\n  return `ParentID IS NULL AND UserID = '${EscapeSQLString(user.ID)}'`;\n}\n\n/**\n * The ExtraFilter for the top-level tasks the conversations UI shows a user: the tasks the user\n * owns, and the tasks linked to a message the user wrote or that is in a conversation the user\n * owns.\n *\n * The conversation and message IDs are read with their own RunView, so the row-level security on\n * those entities applies. A subquery over their views would skip it, and the server refuses one\n * for a user whose read of them is row-filtered. When a read fails, the result is the user's own\n * tasks.\n */\nexport async function BuildConversationTasksFilter(provider: IMetadataProvider, user: UserInfo): Promise<string> {\n  const ownTasks = OwnTasksFilter(user);\n  const tasks = provider.EntityByName('MJ: Tasks');\n  if (!tasks) {\n    return ownTasks;\n  }\n  const rv = RunView.FromMetadataProvider(provider);\n  const conversationIds = await readIds(rv, user, {\n    EntityName: 'MJ: Conversations',\n    ExtraFilter: `UserID = '${EscapeSQLString(user.ID)}'`,\n    Fields: ['ID'],\n  });\n  if (conversationIds == null) {\n    return ownTasks;\n  }\n  const messageIds = await readIds(rv, user, {\n    EntityName: 'MJ: Conversation Details',\n    ExtraFilter: taskMessagesFilter(user, conversationIds, tasks),\n    Fields: ['ID'],\n  });\n  if (messageIds == null || messageIds.length === 0) {\n    return ownTasks;\n  }\n  return `ParentID IS NULL AND (UserID = '${EscapeSQLString(user.ID)}' OR ConversationDetailID IN (${sqlInList(messageIds)}))`;\n}\n\n/**\n * The messages that have a top-level task and that the user wrote or that are in one of the\n * user's conversations. The task subquery reads Tasks, which has no row filter in a default\n * install. Its identifiers are bracketed so the PostgreSQL provider quotes them.\n */\nfunction taskMessagesFilter(user: UserInfo, conversationIds: readonly string[], tasks: EntityInfo): string {\n  const inConversations = conversationIds.length > 0 ? ` OR ConversationID IN (${sqlInList(conversationIds)})` : '';\n  const taskView = `[${tasks.SchemaName}].[${tasks.BaseView}]`;\n  return (\n    `(UserID = '${EscapeSQLString(user.ID)}'${inConversations}) AND ID IN ` +\n    `(SELECT [ConversationDetailID] FROM ${taskView} WHERE [ParentID] IS NULL AND [ConversationDetailID] IS NOT NULL)`\n  );\n}\n\n/**\n * The IDs of the rows `read` selects, with no row cap; null when the read fails. Each caller names\n * an MJ core entity in `read`, so its key column is `ID`.\n */\nasync function readIds(rv: RunView, user: UserInfo, read: Pick<RunViewParams, 'EntityName' | 'ExtraFilter' | 'Fields'>): Promise<string[] | null> {\n  const result = await rv.RunView<{ ID: string }>({ ...read, ResultType: 'simple', IgnoreMaxRows: true }, user);\n  if (!result.Success) {\n    console.error(`Failed to read ${read.EntityName} for the tasks filter:`, result.ErrorMessage);\n    return null;\n  }\n  return (result.Results ?? []).map(row => row.ID);\n}\n\n/** A quoted, comma-separated list of IDs for an IN clause. */\nfunction sqlInList(ids: readonly string[]): string {\n  return ids.map(id => `'${EscapeSQLString(id)}'`).join(',');\n}\n"]}

package/dist/lib/services/data-cache.service.d.ts

@@ -1,4 +1,4 @@
-import { MJConversationEntity, MJConversationDetailEntity } from '@memberjunction/core-entities';
+import { ConversationScope, MJConversationEntity, MJConversationDetailEntity } from '@memberjunction/core-entities';
 import { UserInfo, IMetadataProvider } from '@memberjunction/core';
 import * as i0 from "@angular/core";
 /**
@@ -72,15 +72,23 @@ export declare class DataCacheService {
     /** @deprecated Use {@link CreateConversationDetail}. */
     createConversationDetail(currentUser: UserInfo): Promise<MJConversationDetailEntity>;
     /**
-     * Load all ConversationDetail entities for a conversation and cache them
-     * Used when loading a conversation's message history
+     * Load the ConversationDetail entities of one scope of a conversation (Main, or one fork's
+     * path) that no rerun replaced, and cache them
      * @param conversationId The conversation ID
      * @param currentUser User context
+     * @param scope The rows to read; Main when omitted
      * @returns Array of MJConversationDetailEntity objects
+     * @throws when the scope belongs to another conversation
      */
-    LoadConversationDetails(conversationId: string, currentUser: UserInfo): Promise<MJConversationDetailEntity[]>;
+    LoadConversationDetails(conversationId: string, currentUser: UserInfo, scope?: ConversationScope): Promise<MJConversationDetailEntity[]>;
+    /**
+     * Adds loaded details to the cache, replacing any cached detail with the same ID in place.
+     * Positions are indexed once up front: the cache spans every loaded conversation, so searching
+     * it for each loaded detail grew with both.
+     */
+    private upsertCachedDetails;
     /** @deprecated Use {@link LoadConversationDetails}. */
-    loadConversationDetails(conversationId: string, currentUser: UserInfo): Promise<MJConversationDetailEntity[]>;
+    loadConversationDetails(conversationId: string, currentUser: UserInfo, scope?: ConversationScope): Promise<MJConversationDetailEntity[]>;
     /**
      * Get all cached ConversationDetail entities for a conversation (no DB call)
      * @param conversationId The conversation ID

package/dist/lib/services/data-cache.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-cache.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/data-cache.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"data-cache.service.d.ts","sourceRoot":"","sources":["../../../src/lib/services/data-cache.service.ts"],"names":[],"mappings":"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"}

package/dist/lib/services/data-cache.service.js

@@ -1,6 +1,7 @@
 import { Injectable } from '@angular/core';
+import { ConversationEngine } from '@memberjunction/core-entities';
 import { Metadata, RunView } from '@memberjunction/core';
-import { UUIDsEqual } from '@memberjunction/global';
+import { UUIDMap, UUIDsEqual } from '@memberjunction/global';
 import * as i0 from "@angular/core";
 /**
  * Global singleton cache for conversation-related entities.
@@ -148,46 +149,65 @@ export class DataCacheService {
         return this.CreateConversationDetail(currentUser);
     }
     /**
-     * Load all ConversationDetail entities for a conversation and cache them
-     * Used when loading a conversation's message history
+     * Load the ConversationDetail entities of one scope of a conversation (Main, or one fork's
+     * path) that no rerun replaced, and cache them
      * @param conversationId The conversation ID
      * @param currentUser User context
+     * @param scope The rows to read; Main when omitted
      * @returns Array of MJConversationDetailEntity objects
+     * @throws when the scope belongs to another conversation
      */
-    async LoadConversationDetails(conversationId, currentUser) {
+    async LoadConversationDetails(conversationId, currentUser, scope) {
+        if (scope && !UUIDsEqual(scope.ConversationID, conversationId)) {
+            throw new Error(`Conversation ${conversationId} cannot be read with the scope of conversation ${scope.ConversationID}`);
+        }
+        const resolved = scope ?? ConversationEngine.TrunkScope(conversationId);
         const timestamp = new Date().toISOString();
         console.log(`[${timestamp}] 💾 DataCacheService.loadConversationDetails - Loading messages for conversation ${conversationId}`);
         const rv = RunView.FromMetadataProvider(this.Provider);
         console.log(`[${timestamp}] 💾 DataCacheService - Executing RunView for Conversation Details`);
         const result = await rv.RunView({
             EntityName: 'MJ: Conversation Details',
-            ExtraFilter: `ConversationID='${conversationId}'`,
+            ExtraFilter: ConversationEngine.LiveRowsFilter(ConversationEngine.ScopeFilter(resolved)),
             OrderBy: '__mj_CreatedAt ASC',
             ResultType: 'entity_object'
         }, currentUser);
         if (result.Success) {
             const details = result.Results || [];
             console.log(`[${timestamp}] 💾 DataCacheService - Loaded ${details.length} message(s) for conversation ${conversationId}`);
-            // Add all to cache (avoid duplicates by checking ID)
-            for (const detail of details) {
-                const existingIndex = this.conversationDetails.findIndex(d => UUIDsEqual(d.ID, detail.ID));
-                if (existingIndex >= 0) {
-                    // Replace existing (ensures we keep the same object reference)
-                    this.conversationDetails[existingIndex] = detail;
-                }
-                else {
-                    // Add new
-                    this.conversationDetails.push(detail);
-                }
-            }
+            this.upsertCachedDetails(details);
             return details;
         }
         console.log(`[${timestamp}] 💾 DataCacheService - Failed to load messages for conversation ${conversationId}`);
         return [];
     }
+    /**
+     * Adds loaded details to the cache, replacing any cached detail with the same ID in place.
+     * Positions are indexed once up front: the cache spans every loaded conversation, so searching
+     * it for each loaded detail grew with both.
+     */
+    upsertCachedDetails(details) {
+        const positionByID = new UUIDMap();
+        this.conversationDetails.forEach((d, i) => {
+            if (!positionByID.Has(d.ID))
+                positionByID.Set(d.ID, i);
+        });
+        for (const detail of details) {
+            const existingIndex = positionByID.Get(detail.ID);
+            if (existingIndex !== undefined) {
+                // Replace existing (ensures we keep the same object reference)
+                this.conversationDetails[existingIndex] = detail;
+            }
+            else {
+                // Add new
+                positionByID.Set(detail.ID, this.conversationDetails.length);
+                this.conversationDetails.push(detail);
+            }
+        }
+    }
     /** @deprecated Use {@link LoadConversationDetails}. */
-    async loadConversationDetails(conversationId, currentUser) {
-        return this.LoadConversationDetails(conversationId, currentUser);
+    async loadConversationDetails(conversationId, currentUser, scope) {
+        return this.LoadConversationDetails(conversationId, currentUser, scope);
     }
     /**
      * Get all cached ConversationDetail entities for a conversation (no DB call)

package/dist/lib/services/data-cache.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"data-cache.service.js","sourceRoot":"","sources":["../../../src/lib/services/data-cache.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { Injectable } from '@angular/core';\nimport { MJConversationEntity, MJConversationDetailEntity } from '@memberjunction/core-entities';\nimport { Metadata, UserInfo, BaseEntity, RunView, IMetadataProvider } from '@memberjunction/core';\nimport { UUIDsEqual } from '@memberjunction/global';\n\n/**\n * Global singleton cache for conversation-related entities.\n * Maintains single instances of entities to prevent race conditions and ensure\n * all components see the same object state.\n *\n * Pattern: Instead of creating new entity instances with GetEntityObject() everywhere,\n * request entities from this cache. The cache returns the same instance each time,\n * so when one component updates entity.Status = 'Complete', all other components\n * see that change immediately without needing to reload from the database.\n */\n@Injectable({\n  providedIn: 'root'\n})\nexport class DataCacheService {\n  // Separate arrays for each entity type\n  private conversations: MJConversationEntity[] = [];\n  private conversationDetails: MJConversationDetailEntity[] = [];\n\n  private _provider: IMetadataProvider | null = null;\n\n  constructor() {}\n\n  /**\n   * Set the metadata provider this service should use. When unset, falls back to Metadata.Provider.\n   */\n  public set Provider(value: IMetadataProvider | null) {\n      this._provider = value;\n  }\n\n  public get Provider(): IMetadataProvider {\n      return this._provider ?? Metadata.Provider;\n  }\n\n  // =============================================================================\n  // MJConversationEntity Methods\n  // =============================================================================\n\n  /**\n   * Get a MJConversationEntity by ID from cache, or load it if not cached\n   * @param id The conversation ID\n   * @param currentUser User context for loading\n   * @returns The cached or loaded MJConversationEntity, or null if not found\n   */\n  async GetConversation(id: string, currentUser: UserInfo): Promise<MJConversationEntity | null> {\n    // Check cache first\n    const cached = this.conversations.find(c => UUIDsEqual(c.ID, id));\n    if (cached) {\n      return cached;\n    }\n\n    // Not in cache - load from DB\n    const md = this.Provider;\n    const conversation = await md.GetEntityObject<MJConversationEntity>('MJ: Conversations', currentUser);\n    const loaded = await conversation.Load(id);\n\n    if (loaded) {\n      // Add to cache\n      this.conversations.push(conversation);\n      return conversation;\n    }\n\n    return null;\n  }\n\n  /** @deprecated Use {@link GetConversation}. */\n  async getConversation(id: string, currentUser: UserInfo): Promise<MJConversationEntity | null> {\n    return this.GetConversation(id, currentUser);\n  }\n\n  /**\n   * Create a new MJConversationEntity and automatically cache it\n   * The cache is the ONLY place GetEntityObject() should be called\n   * @param currentUser User context\n   * @returns New MJConversationEntity instance (already cached)\n   */\n  async CreateConversation(currentUser: UserInfo): Promise<MJConversationEntity> {\n    const md = this.Provider;\n    const conversation = await md.GetEntityObject<MJConversationEntity>('MJ: Conversations', currentUser);\n\n    // Automatically add to cache - user code doesn't need to do anything\n    // Note: Conversation has no ID yet (not saved), so we can't deduplicate\n    // After Save(), the ID will be populated and future getConversation() calls will find it\n    this.conversations.push(conversation);\n\n    return conversation;\n  }\n\n  /** @deprecated Use {@link CreateConversation}. */\n  async createConversation(currentUser: UserInfo): Promise<MJConversationEntity> {\n    return this.CreateConversation(currentUser);\n  }\n\n  /**\n   * Remove a MJConversationEntity from the cache\n   * @param id The conversation ID to remove\n   */\n  RemoveConversation(id: string): void {\n    this.conversations = this.conversations.filter(c => !UUIDsEqual(c.ID, id));\n  }\n\n  /** @deprecated Use {@link RemoveConversation}. */\n  removeConversation(id: string): void {\n    return this.RemoveConversation(id);\n  }\n\n  /**\n   * Get all cached MJConversationEntity objects (no DB call)\n   * @returns Array of cached conversations\n   */\n  GetCachedConversations(): MJConversationEntity[] {\n    return this.conversations;\n  }\n\n  /** @deprecated Use {@link GetCachedConversations}. */\n  getCachedConversations(): MJConversationEntity[] {\n    return this.GetCachedConversations();\n  }\n\n  // =============================================================================\n  // MJConversationDetailEntity Methods\n  // =============================================================================\n\n  /**\n   * Get a MJConversationDetailEntity by ID from cache, or load it if not cached\n   * @param id The conversation detail ID\n   * @param currentUser User context for loading\n   * @returns The cached or loaded MJConversationDetailEntity, or null if not found\n   */\n  async GetConversationDetail(id: string, currentUser: UserInfo): Promise<MJConversationDetailEntity | null> {\n    // Check cache first\n    const cached = this.conversationDetails.find(d => UUIDsEqual(d.ID, id));\n    if (cached) {\n      return cached;\n    }\n\n    // Not in cache - load from DB\n    const md = this.Provider;\n    const detail = await md.GetEntityObject<MJConversationDetailEntity>('MJ: Conversation Details', currentUser);\n    const loaded = await detail.Load(id);\n\n    if (loaded) {\n      // Add to cache\n      this.conversationDetails.push(detail);\n      return detail;\n    }\n\n    return null;\n  }\n\n  /** @deprecated Use {@link GetConversationDetail}. */\n  async getConversationDetail(id: string, currentUser: UserInfo): Promise<MJConversationDetailEntity | null> {\n    return this.GetConversationDetail(id, currentUser);\n  }\n\n  /**\n   * Create a new MJConversationDetailEntity and automatically cache it\n   * The cache is the ONLY place GetEntityObject() should be called\n   * @param currentUser User context\n   * @returns New MJConversationDetailEntity instance (already cached)\n   */\n  async CreateConversationDetail(currentUser: UserInfo): Promise<MJConversationDetailEntity> {\n    const md = this.Provider;\n    const detail = await md.GetEntityObject<MJConversationDetailEntity>('MJ: Conversation Details', currentUser);\n\n    // Automatically add to cache - user code doesn't need to do anything\n    // Note: Detail has no ID yet (not saved), so we can't deduplicate\n    // After Save(), the ID will be populated and future getConversationDetail() calls will find it\n\n    this.conversationDetails.push(detail);\n\n    return detail;\n  }\n\n  /** @deprecated Use {@link CreateConversationDetail}. */\n  async createConversationDetail(currentUser: UserInfo): Promise<MJConversationDetailEntity> {\n    return this.CreateConversationDetail(currentUser);\n  }\n\n  /**\n   * Load all ConversationDetail entities for a conversation and cache them\n   * Used when loading a conversation's message history\n   * @param conversationId The conversation ID\n   * @param currentUser User context\n   * @returns Array of MJConversationDetailEntity objects\n   */\n  async LoadConversationDetails(conversationId: string, currentUser: UserInfo): Promise<MJConversationDetailEntity[]> {\n    const timestamp = new Date().toISOString();\n    console.log(`[${timestamp}] 💾 DataCacheService.loadConversationDetails - Loading messages for conversation ${conversationId}`);\n\n    const rv = RunView.FromMetadataProvider(this.Provider);\n\n    console.log(`[${timestamp}] 💾 DataCacheService - Executing RunView for Conversation Details`);\n    const result = await rv.RunView<MJConversationDetailEntity>(\n      {\n        EntityName: 'MJ: Conversation Details',\n        ExtraFilter: `ConversationID='${conversationId}'`,\n        OrderBy: '__mj_CreatedAt ASC',\n        ResultType: 'entity_object'\n      },\n      currentUser\n    );\n\n    if (result.Success) {\n      const details = result.Results || [];\n      console.log(`[${timestamp}] 💾 DataCacheService - Loaded ${details.length} message(s) for conversation ${conversationId}`);\n\n      // Add all to cache (avoid duplicates by checking ID)\n      for (const detail of details) {\n        const existingIndex = this.conversationDetails.findIndex(d => UUIDsEqual(d.ID, detail.ID));\n        if (existingIndex >= 0) {\n          // Replace existing (ensures we keep the same object reference)\n          this.conversationDetails[existingIndex] = detail;\n        } else {\n          // Add new\n          this.conversationDetails.push(detail);\n        }\n      }\n\n      return details;\n    }\n\n    console.log(`[${timestamp}] 💾 DataCacheService - Failed to load messages for conversation ${conversationId}`);\n    return [];\n  }\n\n  /** @deprecated Use {@link LoadConversationDetails}. */\n  async loadConversationDetails(conversationId: string, currentUser: UserInfo): Promise<MJConversationDetailEntity[]> {\n    return this.LoadConversationDetails(conversationId, currentUser);\n  }\n\n  /**\n   * Get all cached ConversationDetail entities for a conversation (no DB call)\n   * @param conversationId The conversation ID\n   * @returns Array of cached conversation details\n   */\n  GetCachedConversationDetails(conversationId: string): MJConversationDetailEntity[] {\n    return this.conversationDetails.filter(d => UUIDsEqual(d.ConversationID, conversationId));\n  }\n\n  /** @deprecated Use {@link GetCachedConversationDetails}. */\n  getCachedConversationDetails(conversationId: string): MJConversationDetailEntity[] {\n    return this.GetCachedConversationDetails(conversationId);\n  }\n\n  /**\n   * Remove a MJConversationDetailEntity from the cache\n   * @param id The conversation detail ID to remove\n   */\n  RemoveConversationDetail(id: string): void {\n    this.conversationDetails = this.conversationDetails.filter(d => !UUIDsEqual(d.ID, id));\n  }\n\n  /** @deprecated Use {@link RemoveConversationDetail}. */\n  removeConversationDetail(id: string): void {\n    return this.RemoveConversationDetail(id);\n  }\n\n  // =============================================================================\n  // Cache Management\n  // =============================================================================\n\n  /**\n   * Refresh entity data by clearing cached entities of a specific type\n   * This forces a reload from the database on next access\n   * @param entityName The entity name to refresh (e.g., 'Conversations', 'MJ: Conversation Details')\n   */\n  async RefreshEntity(entityName: string): Promise<void> {\n    switch (entityName) {\n      case 'Conversations':\n        this.conversations = [];\n        break;\n      case 'MJ: Conversation Details':\n        this.conversationDetails = [];\n        break;\n      default:\n        console.warn('Unknown entity name for refresh:', entityName);\n    }\n  }\n\n  /** @deprecated Use {@link RefreshEntity}. */\n  async refreshEntity(entityName: string): Promise<void> {\n    return this.RefreshEntity(entityName);\n  }\n\n  /**\n   * Refresh a specific cache by name\n   * This method can be extended to handle different cache types\n   * @param cacheName The cache name ('Core', 'AI', 'Actions')\n   */\n  async RefreshCache(cacheName: 'Core' | 'AI' | 'Actions'): Promise<void> {\n    switch (cacheName) {\n      case 'Core':\n        // Clear core entity caches\n        this.Clear();\n        break;\n      case 'AI':\n        // AI-specific cache refresh would go here\n        // For now, just log it\n        console.log('AI cache refresh requested (not yet implemented)');\n        break;\n      case 'Actions':\n        // Actions-specific cache refresh would go here\n        console.log('Actions cache refresh requested (not yet implemented)');\n        break;\n      default:\n        console.warn('Unknown cache name for refresh:', cacheName);\n    }\n  }\n\n  /** @deprecated Use {@link RefreshCache}. */\n  async refreshCache(cacheName: 'Core' | 'AI' | 'Actions'): Promise<void> {\n    return this.RefreshCache(cacheName);\n  }\n\n  /**\n   * Clear all cached entities\n   * Call when switching environments, users, or when needed\n   */\n  Clear(): void {\n    this.conversations = [];\n    this.conversationDetails = [];\n  }\n\n  /** @deprecated Use {@link Clear}. */\n  clear(): void {\n    return this.Clear();\n  }\n\n  /**\n   * Clear cached entities for a specific conversation\n   * @param conversationId The conversation ID\n   */\n  ClearConversation(conversationId: string): void {\n    this.conversations = this.conversations.filter(c => !UUIDsEqual(c.ID, conversationId));\n    this.conversationDetails = this.conversationDetails.filter(d => !UUIDsEqual(d.ConversationID, conversationId));\n  }\n\n  /** @deprecated Use {@link ClearConversation}. */\n  clearConversation(conversationId: string): void {\n    return this.ClearConversation(conversationId);\n  }\n\n  /**\n   * Get cache statistics for debugging\n   * @returns Object with cache sizes\n   */\n  GetStats(): { conversations: number; conversationDetails: number } {\n    return {\n      conversations: this.conversations.length,\n      conversationDetails: this.conversationDetails.length\n    };\n  }\n\n  /** @deprecated Use {@link GetStats}. */\n  getStats(): { conversations: number; conversationDetails: number } {\n    return this.GetStats();\n  }\n}\n"]}
+{"version":3,"file":"data-cache.service.js","sourceRoot":"","sources":["../../../src/lib/services/data-cache.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { Injectable } from '@angular/core';\nimport { ConversationEngine, ConversationScope, MJConversationEntity, MJConversationDetailEntity } from '@memberjunction/core-entities';\nimport { Metadata, UserInfo, BaseEntity, RunView, IMetadataProvider } from '@memberjunction/core';\nimport { UUIDMap, UUIDsEqual } from '@memberjunction/global';\n\n/**\n * Global singleton cache for conversation-related entities.\n * Maintains single instances of entities to prevent race conditions and ensure\n * all components see the same object state.\n *\n * Pattern: Instead of creating new entity instances with GetEntityObject() everywhere,\n * request entities from this cache. The cache returns the same instance each time,\n * so when one component updates entity.Status = 'Complete', all other components\n * see that change immediately without needing to reload from the database.\n */\n@Injectable({\n  providedIn: 'root'\n})\nexport class DataCacheService {\n  // Separate arrays for each entity type\n  private conversations: MJConversationEntity[] = [];\n  private conversationDetails: MJConversationDetailEntity[] = [];\n\n  private _provider: IMetadataProvider | null = null;\n\n  constructor() {}\n\n  /**\n   * Set the metadata provider this service should use. When unset, falls back to Metadata.Provider.\n   */\n  public set Provider(value: IMetadataProvider | null) {\n      this._provider = value;\n  }\n\n  public get Provider(): IMetadataProvider {\n      return this._provider ?? Metadata.Provider;\n  }\n\n  // =============================================================================\n  // MJConversationEntity Methods\n  // =============================================================================\n\n  /**\n   * Get a MJConversationEntity by ID from cache, or load it if not cached\n   * @param id The conversation ID\n   * @param currentUser User context for loading\n   * @returns The cached or loaded MJConversationEntity, or null if not found\n   */\n  async GetConversation(id: string, currentUser: UserInfo): Promise<MJConversationEntity | null> {\n    // Check cache first\n    const cached = this.conversations.find(c => UUIDsEqual(c.ID, id));\n    if (cached) {\n      return cached;\n    }\n\n    // Not in cache - load from DB\n    const md = this.Provider;\n    const conversation = await md.GetEntityObject<MJConversationEntity>('MJ: Conversations', currentUser);\n    const loaded = await conversation.Load(id);\n\n    if (loaded) {\n      // Add to cache\n      this.conversations.push(conversation);\n      return conversation;\n    }\n\n    return null;\n  }\n\n  /** @deprecated Use {@link GetConversation}. */\n  async getConversation(id: string, currentUser: UserInfo): Promise<MJConversationEntity | null> {\n    return this.GetConversation(id, currentUser);\n  }\n\n  /**\n   * Create a new MJConversationEntity and automatically cache it\n   * The cache is the ONLY place GetEntityObject() should be called\n   * @param currentUser User context\n   * @returns New MJConversationEntity instance (already cached)\n   */\n  async CreateConversation(currentUser: UserInfo): Promise<MJConversationEntity> {\n    const md = this.Provider;\n    const conversation = await md.GetEntityObject<MJConversationEntity>('MJ: Conversations', currentUser);\n\n    // Automatically add to cache - user code doesn't need to do anything\n    // Note: Conversation has no ID yet (not saved), so we can't deduplicate\n    // After Save(), the ID will be populated and future getConversation() calls will find it\n    this.conversations.push(conversation);\n\n    return conversation;\n  }\n\n  /** @deprecated Use {@link CreateConversation}. */\n  async createConversation(currentUser: UserInfo): Promise<MJConversationEntity> {\n    return this.CreateConversation(currentUser);\n  }\n\n  /**\n   * Remove a MJConversationEntity from the cache\n   * @param id The conversation ID to remove\n   */\n  RemoveConversation(id: string): void {\n    this.conversations = this.conversations.filter(c => !UUIDsEqual(c.ID, id));\n  }\n\n  /** @deprecated Use {@link RemoveConversation}. */\n  removeConversation(id: string): void {\n    return this.RemoveConversation(id);\n  }\n\n  /**\n   * Get all cached MJConversationEntity objects (no DB call)\n   * @returns Array of cached conversations\n   */\n  GetCachedConversations(): MJConversationEntity[] {\n    return this.conversations;\n  }\n\n  /** @deprecated Use {@link GetCachedConversations}. */\n  getCachedConversations(): MJConversationEntity[] {\n    return this.GetCachedConversations();\n  }\n\n  // =============================================================================\n  // MJConversationDetailEntity Methods\n  // =============================================================================\n\n  /**\n   * Get a MJConversationDetailEntity by ID from cache, or load it if not cached\n   * @param id The conversation detail ID\n   * @param currentUser User context for loading\n   * @returns The cached or loaded MJConversationDetailEntity, or null if not found\n   */\n  async GetConversationDetail(id: string, currentUser: UserInfo): Promise<MJConversationDetailEntity | null> {\n    // Check cache first\n    const cached = this.conversationDetails.find(d => UUIDsEqual(d.ID, id));\n    if (cached) {\n      return cached;\n    }\n\n    // Not in cache - load from DB\n    const md = this.Provider;\n    const detail = await md.GetEntityObject<MJConversationDetailEntity>('MJ: Conversation Details', currentUser);\n    const loaded = await detail.Load(id);\n\n    if (loaded) {\n      // Add to cache\n      this.conversationDetails.push(detail);\n      return detail;\n    }\n\n    return null;\n  }\n\n  /** @deprecated Use {@link GetConversationDetail}. */\n  async getConversationDetail(id: string, currentUser: UserInfo): Promise<MJConversationDetailEntity | null> {\n    return this.GetConversationDetail(id, currentUser);\n  }\n\n  /**\n   * Create a new MJConversationDetailEntity and automatically cache it\n   * The cache is the ONLY place GetEntityObject() should be called\n   * @param currentUser User context\n   * @returns New MJConversationDetailEntity instance (already cached)\n   */\n  async CreateConversationDetail(currentUser: UserInfo): Promise<MJConversationDetailEntity> {\n    const md = this.Provider;\n    const detail = await md.GetEntityObject<MJConversationDetailEntity>('MJ: Conversation Details', currentUser);\n\n    // Automatically add to cache - user code doesn't need to do anything\n    // Note: Detail has no ID yet (not saved), so we can't deduplicate\n    // After Save(), the ID will be populated and future getConversationDetail() calls will find it\n\n    this.conversationDetails.push(detail);\n\n    return detail;\n  }\n\n  /** @deprecated Use {@link CreateConversationDetail}. */\n  async createConversationDetail(currentUser: UserInfo): Promise<MJConversationDetailEntity> {\n    return this.CreateConversationDetail(currentUser);\n  }\n\n  /**\n   * Load the ConversationDetail entities of one scope of a conversation (Main, or one fork's\n   * path) that no rerun replaced, and cache them\n   * @param conversationId The conversation ID\n   * @param currentUser User context\n   * @param scope The rows to read; Main when omitted\n   * @returns Array of MJConversationDetailEntity objects\n   * @throws when the scope belongs to another conversation\n   */\n  async LoadConversationDetails(conversationId: string, currentUser: UserInfo, scope?: ConversationScope): Promise<MJConversationDetailEntity[]> {\n    if (scope && !UUIDsEqual(scope.ConversationID, conversationId)) {\n      throw new Error(`Conversation ${conversationId} cannot be read with the scope of conversation ${scope.ConversationID}`);\n    }\n    const resolved = scope ?? ConversationEngine.TrunkScope(conversationId);\n    const timestamp = new Date().toISOString();\n    console.log(`[${timestamp}] 💾 DataCacheService.loadConversationDetails - Loading messages for conversation ${conversationId}`);\n\n    const rv = RunView.FromMetadataProvider(this.Provider);\n\n    console.log(`[${timestamp}] 💾 DataCacheService - Executing RunView for Conversation Details`);\n    const result = await rv.RunView<MJConversationDetailEntity>(\n      {\n        EntityName: 'MJ: Conversation Details',\n        ExtraFilter: ConversationEngine.LiveRowsFilter(ConversationEngine.ScopeFilter(resolved)),\n        OrderBy: '__mj_CreatedAt ASC',\n        ResultType: 'entity_object'\n      },\n      currentUser\n    );\n\n    if (result.Success) {\n      const details = result.Results || [];\n      console.log(`[${timestamp}] 💾 DataCacheService - Loaded ${details.length} message(s) for conversation ${conversationId}`);\n\n      this.upsertCachedDetails(details);\n      return details;\n    }\n\n    console.log(`[${timestamp}] 💾 DataCacheService - Failed to load messages for conversation ${conversationId}`);\n    return [];\n  }\n\n  /**\n   * Adds loaded details to the cache, replacing any cached detail with the same ID in place.\n   * Positions are indexed once up front: the cache spans every loaded conversation, so searching\n   * it for each loaded detail grew with both.\n   */\n  private upsertCachedDetails(details: MJConversationDetailEntity[]): void {\n    const positionByID = new UUIDMap<number>();\n    this.conversationDetails.forEach((d, i) => {\n      if (!positionByID.Has(d.ID)) positionByID.Set(d.ID, i);\n    });\n    for (const detail of details) {\n      const existingIndex = positionByID.Get(detail.ID);\n      if (existingIndex !== undefined) {\n        // Replace existing (ensures we keep the same object reference)\n        this.conversationDetails[existingIndex] = detail;\n      } else {\n        // Add new\n        positionByID.Set(detail.ID, this.conversationDetails.length);\n        this.conversationDetails.push(detail);\n      }\n    }\n  }\n\n  /** @deprecated Use {@link LoadConversationDetails}. */\n  async loadConversationDetails(conversationId: string, currentUser: UserInfo, scope?: ConversationScope): Promise<MJConversationDetailEntity[]> {\n    return this.LoadConversationDetails(conversationId, currentUser, scope);\n  }\n\n  /**\n   * Get all cached ConversationDetail entities for a conversation (no DB call)\n   * @param conversationId The conversation ID\n   * @returns Array of cached conversation details\n   */\n  GetCachedConversationDetails(conversationId: string): MJConversationDetailEntity[] {\n    return this.conversationDetails.filter(d => UUIDsEqual(d.ConversationID, conversationId));\n  }\n\n  /** @deprecated Use {@link GetCachedConversationDetails}. */\n  getCachedConversationDetails(conversationId: string): MJConversationDetailEntity[] {\n    return this.GetCachedConversationDetails(conversationId);\n  }\n\n  /**\n   * Remove a MJConversationDetailEntity from the cache\n   * @param id The conversation detail ID to remove\n   */\n  RemoveConversationDetail(id: string): void {\n    this.conversationDetails = this.conversationDetails.filter(d => !UUIDsEqual(d.ID, id));\n  }\n\n  /** @deprecated Use {@link RemoveConversationDetail}. */\n  removeConversationDetail(id: string): void {\n    return this.RemoveConversationDetail(id);\n  }\n\n  // =============================================================================\n  // Cache Management\n  // =============================================================================\n\n  /**\n   * Refresh entity data by clearing cached entities of a specific type\n   * This forces a reload from the database on next access\n   * @param entityName The entity name to refresh (e.g., 'Conversations', 'MJ: Conversation Details')\n   */\n  async RefreshEntity(entityName: string): Promise<void> {\n    switch (entityName) {\n      case 'Conversations':\n        this.conversations = [];\n        break;\n      case 'MJ: Conversation Details':\n        this.conversationDetails = [];\n        break;\n      default:\n        console.warn('Unknown entity name for refresh:', entityName);\n    }\n  }\n\n  /** @deprecated Use {@link RefreshEntity}. */\n  async refreshEntity(entityName: string): Promise<void> {\n    return this.RefreshEntity(entityName);\n  }\n\n  /**\n   * Refresh a specific cache by name\n   * This method can be extended to handle different cache types\n   * @param cacheName The cache name ('Core', 'AI', 'Actions')\n   */\n  async RefreshCache(cacheName: 'Core' | 'AI' | 'Actions'): Promise<void> {\n    switch (cacheName) {\n      case 'Core':\n        // Clear core entity caches\n        this.Clear();\n        break;\n      case 'AI':\n        // AI-specific cache refresh would go here\n        // For now, just log it\n        console.log('AI cache refresh requested (not yet implemented)');\n        break;\n      case 'Actions':\n        // Actions-specific cache refresh would go here\n        console.log('Actions cache refresh requested (not yet implemented)');\n        break;\n      default:\n        console.warn('Unknown cache name for refresh:', cacheName);\n    }\n  }\n\n  /** @deprecated Use {@link RefreshCache}. */\n  async refreshCache(cacheName: 'Core' | 'AI' | 'Actions'): Promise<void> {\n    return this.RefreshCache(cacheName);\n  }\n\n  /**\n   * Clear all cached entities\n   * Call when switching environments, users, or when needed\n   */\n  Clear(): void {\n    this.conversations = [];\n    this.conversationDetails = [];\n  }\n\n  /** @deprecated Use {@link Clear}. */\n  clear(): void {\n    return this.Clear();\n  }\n\n  /**\n   * Clear cached entities for a specific conversation\n   * @param conversationId The conversation ID\n   */\n  ClearConversation(conversationId: string): void {\n    this.conversations = this.conversations.filter(c => !UUIDsEqual(c.ID, conversationId));\n    this.conversationDetails = this.conversationDetails.filter(d => !UUIDsEqual(d.ConversationID, conversationId));\n  }\n\n  /** @deprecated Use {@link ClearConversation}. */\n  clearConversation(conversationId: string): void {\n    return this.ClearConversation(conversationId);\n  }\n\n  /**\n   * Get cache statistics for debugging\n   * @returns Object with cache sizes\n   */\n  GetStats(): { conversations: number; conversationDetails: number } {\n    return {\n      conversations: this.conversations.length,\n      conversationDetails: this.conversationDetails.length\n    };\n  }\n\n  /** @deprecated Use {@link GetStats}. */\n  getStats(): { conversations: number; conversationDetails: number } {\n    return this.GetStats();\n  }\n}\n"]}

package/dist/lib/services/export.service.d.ts

@@ -1,4 +1,4 @@
-import { MJConversationEntity, MJConversationDetailEntity } from '@memberjunction/core-entities';
+import { ConversationScope, MJConversationEntity, MJConversationDetailEntity } from '@memberjunction/core-entities';
 import { UserInfo, IMetadataProvider } from '@memberjunction/core';
 import * as i0 from "@angular/core";
 export type ExportFormat = 'json' | 'markdown' | 'html' | 'text';
@@ -88,6 +88,16 @@ export interface ExportOptions {
  * map via {@link ExportBranding.brandTokens} instead.
  */
 export declare const DEFAULT_EXPORT_THEME_TOKENS: readonly string[];
+/** The conversation and the messages one export writes. */
+export interface ExportConversationData {
+    conversation: MJConversationEntity;
+    details: MJConversationDetailEntity[];
+    /**
+     * The fork the messages come from, as the header names it (its display name). Absent or null
+     * in Main.
+     */
+    fork?: string | null;
+}
 export declare class ExportService {
     private _provider;
     /**
@@ -95,19 +105,23 @@ export declare class ExportService {
      */
     set Provider(value: IMetadataProvider | null);
     get Provider(): IMetadataProvider;
-    ExportConversation(conversationId: string, format: ExportFormat, currentUser: UserInfo, options?: ExportOptions): Promise<void>;
-    /** @deprecated Use {@link ExportConversation}. */
-    exportConversation(conversationId: string, format: ExportFormat, currentUser: UserInfo, options?: ExportOptions): Promise<void>;
+    /**
+     * Exports the messages of one scope of a conversation (Main, or one fork's path) and
+     * downloads the file. In a fork the export header names the fork.
+     * @throws when the scope belongs to another conversation, or the conversation is not found.
+     */
+    ExportConversation(conversationId: string, scope: ConversationScope, format: ExportFormat, currentUser: UserInfo, options?: ExportOptions): Promise<void>;
+    /**
+     * @deprecated Use {@link ExportConversation}. Without `scope`, exports Main.
+     */
+    exportConversation(conversationId: string, format: ExportFormat, currentUser: UserInfo, options?: ExportOptions, scope?: ConversationScope): Promise<void>;
     /**
      * Build the export document for already-loaded conversation data — the
-     * download-free seam of {@link exportConversation}. Async because HTML-format
+     * download-free seam of {@link ExportConversation}. Async because HTML-format
      * branding may inline a logo. Exposed publicly so hosts (and tests) can build
      * export content without triggering a browser download.
      */
-    BuildExportContent(data: {
-        conversation: MJConversationEntity;
-        details: MJConversationDetailEntity[];
-    }, format: ExportFormat, options?: ExportOptions): Promise<{
+    BuildExportContent(data: ExportConversationData, format: ExportFormat, options?: ExportOptions): Promise<{
         content: string;
         filename: string;
         mimeType: string;
@@ -164,7 +178,10 @@ export declare class ExportService {
      *  (or when the response isn't actually an image — don't inline HTML/other as
      *  a bogus `data:` image). */
     private inlineLogo;
+    /** Loads the conversation and the messages in the scope that no rerun replaced, in Sequence order. */
     private loadConversationData;
+    /** The header name of the scope's fork: its display name; null in Main. */
+    private forkLabel;
     private exportAsJSON;
     private exportAsMarkdown;
     private exportAsHTML;