conversationalist 0.0.5 → 0.0.7

package/dist/index.js

@@ -3514,6 +3514,8 @@ function copyContent(content) {
   }
   return content.map(copyMultiModalContent);
 }
+// src/types.ts
+var CURRENT_SCHEMA_VERSION = 1;
 // src/schemas.ts
 import { z } from "zod";
 var multiModalContentSchema = z.discriminatedUnion("type", [
@@ -3578,6 +3580,7 @@ var conversationStatusSchema = z.enum([
   "deleted"
 ]);
 var conversationShape = {
+  schemaVersion: z.number().int().min(1),
   id: z.string(),
   title: z.string().optional(),
   status: conversationStatusSchema,
@@ -3588,29 +3591,54 @@ var conversationShape = {
   updatedAt: z.string()
 };
 var conversationSchema = z.object(conversationShape);
-// src/utilities.ts
-var import_gray_matter = __toESM(require_gray_matter(), 1);
-function pairToolCallsWithResults(messages) {
-  const pairs = [];
-  const resultsMap = new Map;
-  for (const msg of messages) {
-    if (msg.toolResult) {
-      resultsMap.set(msg.toolResult.callId, msg.toolResult);
-    }
+// src/utilities/content.ts
+function toMultiModalArray(input) {
+  if (typeof input === "string")
+    return [{ type: "text", text: input }];
+  return Array.isArray(input) ? input : [input];
+}
+function normalizeContent(content) {
+  if (content === undefined)
+    return;
+  if (typeof content === "string")
+    return content;
+  return Array.isArray(content) ? content : [content];
+}
+// src/utilities/deterministic.ts
+function sortObjectKeys(obj) {
+  if (obj === null || typeof obj !== "object") {
+    return obj;
   }
-  for (const msg of messages) {
-    if (msg.toolCall) {
-      pairs.push({
-        call: msg.toolCall,
-        result: resultsMap.get(msg.toolCall.id)
-      });
-    }
+  if (Array.isArray(obj)) {
+    return obj.map(sortObjectKeys);
   }
-  return pairs;
+  const sorted = {};
+  const keys = Object.keys(obj).sort();
+  for (const key of keys) {
+    sorted[key] = sortObjectKeys(obj[key]);
+  }
+  return sorted;
 }
+function sortMessagesByPosition(messages) {
+  return [...messages].sort((a, b) => {
+    if (a.position !== b.position) {
+      return a.position - b.position;
+    }
+    if (a.createdAt !== b.createdAt) {
+      return a.createdAt.localeCompare(b.createdAt);
+    }
+    return a.id.localeCompare(b.id);
+  });
+}
+// src/utilities/markdown.ts
+var import_gray_matter = __toESM(require_gray_matter(), 1);
+
+// src/utilities/type-helpers.ts
 function toReadonly(value) {
   return value;
 }
+
+// src/utilities/message.ts
 function createMessage(props) {
   const content = Array.isArray(props.content) ? toReadonly([...props.content]) : props.content;
   const message = {
@@ -3628,18 +3656,6 @@ function createMessage(props) {
   };
   return toReadonly(message);
 }
-function toMultiModalArray(input) {
-  if (typeof input === "string")
-    return [{ type: "text", text: input }];
-  return Array.isArray(input) ? input : [input];
-}
-function normalizeContent(content) {
-  if (content === undefined)
-    return;
-  if (typeof content === "string")
-    return content;
-  return Array.isArray(content) ? content : [content];
-}
 function messageParts(message) {
   if (typeof message.content === "string") {
     return message.content ? [{ type: "text", text: message.content }] : [];
@@ -3656,7 +3672,9 @@ function messageText(message, joiner = `
 function messageHasImages(message) {
   return messageParts(message).some((p) => p.type === "image");
 }
-var ROLE_DISPLAY_NAMES = {
+
+// src/utilities/markdown.ts
+var ROLE_LABELS = {
   user: "User",
   assistant: "Assistant",
   system: "System",
@@ -3665,7 +3683,8 @@ var ROLE_DISPLAY_NAMES = {
   "tool-result": "Tool Result",
   snapshot: "Snapshot"
 };
-var DISPLAY_NAME_TO_ROLE = {
+var ROLE_DISPLAY_NAMES = ROLE_LABELS;
+var LABEL_TO_ROLE = {
   User: "user",
   Assistant: "assistant",
   System: "system",
@@ -3674,6 +3693,13 @@ var DISPLAY_NAME_TO_ROLE = {
   "Tool Result": "tool-result",
   Snapshot: "snapshot"
 };
+var DISPLAY_NAME_TO_ROLE = LABEL_TO_ROLE;
+function getRoleLabel(role) {
+  return ROLE_LABELS[role];
+}
+function getRoleFromLabel(label) {
+  return LABEL_TO_ROLE[label];
+}
 function formatMessageContent(message) {
   if (typeof message.content === "string")
     return message.content;
@@ -3876,7 +3902,63 @@ function parseMarkdownSimple(body) {
   };
   return toReadonly(conversation);
 }
-
+// src/utilities/tool-calls.ts
+function pairToolCallsWithResults(messages) {
+  const pairs = [];
+  const resultsMap = new Map;
+  for (const msg of messages) {
+    if (msg.toolResult) {
+      resultsMap.set(msg.toolResult.callId, msg.toolResult);
+    }
+  }
+  for (const msg of messages) {
+    if (msg.toolCall) {
+      pairs.push({
+        call: msg.toolCall,
+        result: resultsMap.get(msg.toolCall.id)
+      });
+    }
+  }
+  return pairs;
+}
+// src/utilities/transient.ts
+function isTransientKey(key) {
+  return key.startsWith("_");
+}
+function stripTransientFromRecord(metadata) {
+  const result = {};
+  for (const [key, value] of Object.entries(metadata)) {
+    if (!isTransientKey(key)) {
+      result[key] = value;
+    }
+  }
+  return result;
+}
+function stripTransientMetadata(conversation) {
+  const strippedMessages = conversation.messages.map((message) => toReadonly({
+    id: message.id,
+    role: message.role,
+    content: message.content,
+    position: message.position,
+    createdAt: message.createdAt,
+    metadata: toReadonly(stripTransientFromRecord({ ...message.metadata })),
+    hidden: message.hidden,
+    toolCall: message.toolCall,
+    toolResult: message.toolResult,
+    tokenUsage: message.tokenUsage,
+    goalCompleted: message.goalCompleted
+  }));
+  return toReadonly({
+    id: conversation.id,
+    title: conversation.title,
+    status: conversation.status,
+    metadata: toReadonly(stripTransientFromRecord({ ...conversation.metadata })),
+    tags: conversation.tags,
+    messages: strippedMessages,
+    createdAt: conversation.createdAt,
+    updatedAt: conversation.updatedAt
+  });
+}
 // src/environment.ts
 function simpleTokenEstimator(message) {
   const text = messageText(message);
@@ -4230,33 +4312,88 @@ function redactMessageAtPosition(conversation, position, placeholder = "[REDACTE
   const next = { ...conversation, messages, updatedAt: now };
   return toReadonly(next);
 }
-function serializeConversation(conversation) {
-  return {
-    id: conversation.id,
-    title: conversation.title,
-    status: conversation.status,
-    metadata: { ...conversation.metadata },
-    tags: [...conversation.tags],
-    messages: conversation.messages.map((m) => ({
+var REDACTED = "[REDACTED]";
+function migrateConversationJSON(json) {
+  if (typeof json !== "object" || json === null || Array.isArray(json)) {
+    return {
+      schemaVersion: CURRENT_SCHEMA_VERSION,
+      id: "",
+      status: "active",
+      metadata: {},
+      tags: [],
+      messages: [],
+      createdAt: new Date().toISOString(),
+      updatedAt: new Date().toISOString()
+    };
+  }
+  const data = json;
+  if (!("schemaVersion" in json)) {
+    return {
+      ...data,
+      schemaVersion: CURRENT_SCHEMA_VERSION
+    };
+  }
+  return data;
+}
+function serializeConversation(conversation, options2 = {}) {
+  const {
+    deterministic = false,
+    stripTransient = false,
+    redactToolArguments = false,
+    redactToolResults = false
+  } = options2;
+  let metadata = { ...conversation.metadata };
+  if (stripTransient) {
+    metadata = stripTransientFromRecord(metadata);
+  }
+  let messages = conversation.messages.map((m) => {
+    let msgMetadata = { ...m.metadata };
+    if (stripTransient) {
+      msgMetadata = stripTransientFromRecord(msgMetadata);
+    }
+    return {
       id: m.id,
       role: m.role,
       content: copyContent(m.content),
       position: m.position,
       createdAt: m.createdAt,
-      metadata: { ...m.metadata },
+      metadata: msgMetadata,
       hidden: m.hidden,
-      toolCall: m.toolCall ? { ...m.toolCall } : undefined,
-      toolResult: m.toolResult ? { ...m.toolResult } : undefined,
+      toolCall: m.toolCall ? {
+        ...m.toolCall,
+        arguments: redactToolArguments ? REDACTED : m.toolCall.arguments
+      } : undefined,
+      toolResult: m.toolResult ? {
+        ...m.toolResult,
+        content: redactToolResults ? REDACTED : m.toolResult.content
+      } : undefined,
       tokenUsage: m.tokenUsage ? { ...m.tokenUsage } : undefined,
       goalCompleted: m.goalCompleted
-    })),
+    };
+  });
+  if (deterministic) {
+    messages = sortMessagesByPosition(messages);
+  }
+  let result = {
+    schemaVersion: CURRENT_SCHEMA_VERSION,
+    id: conversation.id,
+    title: conversation.title,
+    status: conversation.status,
+    metadata,
+    tags: [...conversation.tags],
+    messages,
     createdAt: conversation.createdAt,
     updatedAt: conversation.updatedAt
   };
+  if (deterministic) {
+    result = sortObjectKeys(result);
+  }
+  return result;
 }
 function deserializeConversation(json) {
+  const migrated = migrateConversationJSON(json);
   try {
-    json.messages.reduce((state, message, index) => {
+    migrated.messages.reduce((state, message, index) => {
       if (message.position !== index) {
         throw createInvalidPositionError(index, message.position);
       }
@@ -4270,16 +4407,16 @@ function deserializeConversation(json) {
       }
       return state;
     }, { toolUses: new Map });
-    const messages = json.messages.map((m) => createMessage(m));
+    const messages = migrated.messages.map((m) => createMessage(m));
     const conv = {
-      id: json.id,
-      title: json.title,
-      status: json.status,
-      metadata: { ...json.metadata },
-      tags: [...json.tags],
+      id: migrated.id,
+      title: migrated.title,
+      status: migrated.status,
+      metadata: { ...migrated.metadata },
+      tags: [...migrated.tags],
       messages,
-      createdAt: json.createdAt,
-      updatedAt: json.updatedAt
+      createdAt: migrated.createdAt,
+      updatedAt: migrated.updatedAt
     };
     return toReadonly(conv);
   } catch (error) {
@@ -4943,6 +5080,10 @@ export {
   toMultiModalArray,
   toMarkdown,
   toChatMessages,
+  stripTransientMetadata,
+  stripTransientFromRecord,
+  sortObjectKeys,
+  sortMessagesByPosition,
   simpleTokenEstimator,
   serializeConversation,
   searchConversationMessages,
@@ -4953,13 +5094,17 @@ export {
   pairToolCallsWithResults,
   normalizeContent,
   multiModalContentSchema,
+  migrateConversationJSON,
   messageRoleSchema,
   messageJSONSchema,
   messageInputSchema,
+  isTransientKey,
   isStreamingMessage,
   hasSystemMessage,
   getSystemMessages,
   getStreamingMessage,
+  getRoleLabel,
+  getRoleFromLabel,
   getRecentMessages,
   getMessageByIdentifier,
   getMessageAtPosition,
@@ -4992,9 +5137,12 @@ export {
   appendStreamingMessage,
   appendMessages,
   appendAssistantMessage,
+  ROLE_LABELS,
   MarkdownParseError,
+  LABEL_TO_ROLE,
   ConversationalistError,
-  ConversationHistory
+  ConversationHistory,
+  CURRENT_SCHEMA_VERSION
 };
 
-//# debugId=57E19802F1DD380C64756E2164756E21
+//# debugId=5DC3B590F98C078D64756E2164756E21