conversationalist 0.0.4 → 0.0.6

package/README.md

@@ -511,14 +511,11 @@ const conversation = pipeConversation(
 
 Use the `ConversationHistory` class to manage a stack of conversation states. Because every change returns a new immutable object, supporting undo/redo is built into the architecture.
 
-````ts
-import {
-  ConversationHistory,
-  createConversation,
-  appendUserMessage,
-} from 'conversationalist';
+```ts
+import { ConversationHistory } from 'conversationalist';
 
-const history = new ConversationHistory(createConversation());
+// Create a new history (defaults to an empty conversation)
+const history = new ConversationHistory();
 
 // You can use convenience methods that automatically track state
 history.appendUserMessage('Hello!');
@@ -545,7 +542,7 @@ const tokens = history.estimateTokens();
 #### Using DOM Events
 
 ```ts
-const history = new ConversationHistory(createConversation());
+const history = new ConversationHistory();
 
 // addEventListener returns a convenient unsubscribe function
 const unsubscribe = history.addEventListener('change', (event) => {
@@ -582,12 +579,12 @@ controller.abort();
 The `ConversationHistory` class supports branching. When you undo to a previous state and push a new update, it creates an alternate path instead of deleting the old history.
 
 ```ts
-const history = new ConversationHistory(createConversation());
+const history = new ConversationHistory();
 
-history.push(appendUserMessage(history.current, 'Path A'));
+history.appendUserMessage('Path A');
 history.undo();
 
-history.push(appendUserMessage(history.current, 'Path B'));
+history.appendUserMessage('Path B');
 
 console.log(history.branchCount); // 2
 console.log(history.current.messages[0].content); // "Path B"
@@ -614,6 +611,28 @@ const restoredWithEnv = ConversationHistory.from(json, {
 });
 ```
 
+### Markdown Serialization
+
+You can also convert a conversation to Markdown format for human-readable storage or export, and restore it later.
+
+```ts
+// Export to clean, readable Markdown
+const markdown = history.toMarkdown();
+// ### User
+//
+// Hello!
+//
+// ### Assistant
+//
+// Hi there!
+
+// Export with full metadata (lossless round-trip)
+const markdownWithMetadata = history.toMarkdown({ includeMetadata: true });
+
+// Restore from Markdown
+const restored = ConversationHistory.fromMarkdown(markdownWithMetadata);
+```
+
 ## Integration
 
 ### Using with React
@@ -649,16 +668,14 @@ For more complex applications, you can wrap the logic into a custom hook. This e
 
 ```tsx
 import { useState, useCallback, useEffect } from 'react';
-import {
-  createConversation,
-  ConversationHistory,
-  toChatMessages,
-} from 'conversationalist';
+import { createConversation, ConversationHistory } from 'conversationalist';
 
 export function useChat(initialTitle?: string) {
   // 1. Initialize history (this could also come from context or props)
-  const [history] = useState(
-    () => new ConversationHistory(createConversation({ title: initialTitle })),
+  const [history] = useState(() =>
+    initialTitle
+      ? new ConversationHistory(createConversation({ title: initialTitle }))
+      : new ConversationHistory(),
   );
 
   // 2. Sync history with local state for reactivity
@@ -762,10 +779,10 @@ Svelte 5's runes pair perfectly with **Conversationalist**. You can use the `Con
 
 ```svelte
 <script lang="ts">
-  import { ConversationHistory, createConversation } from 'conversationalist';
+  import { ConversationHistory } from 'conversationalist';
 
   // history implements the Svelte store contract
-  const history = new ConversationHistory(createConversation());
+  const history = new ConversationHistory();
 </script>
 
 <div>
@@ -813,4 +830,3 @@ bun install
 bun test
 bun run build
 ```
-````

package/dist/history.d.ts

@@ -1,6 +1,7 @@
 import { type TruncateOptions } from './context';
 import { type ConversationEnvironment } from './environment';
 import type { Conversation, ConversationHistoryJSON, Message, MessageInput, TokenUsage } from './types';
+import { type ToMarkdownOptions } from './utilities';
 /**
  * Event detail for conversation history changes.
  */
@@ -20,7 +21,7 @@ export declare class ConversationHistoryEvent extends CustomEvent<ConversationHi
 export declare class ConversationHistory extends EventTarget {
     private currentNode;
     private environment;
-    constructor(initial: Conversation, environment?: Partial<ConversationEnvironment>);
+    constructor(initial?: Conversation, environment?: Partial<ConversationEnvironment>);
     /**
      * Dispatches a change event.
      */
@@ -113,6 +114,7 @@ export declare class ConversationHistory extends EventTarget {
     getSystemMessages(): ReadonlyArray<Message>;
     serialize(): import("./types").ConversationJSON;
     toChatMessages(): import("@lasercat/homogenaize").Message[];
+    toMarkdown(options?: ToMarkdownOptions): string;
     estimateTokens(estimator?: (message: Message) => number): number;
     getRecentMessages(count: number, options?: {
         includeHidden?: boolean;
@@ -146,6 +148,10 @@ export declare class ConversationHistory extends EventTarget {
      * Reconstructs a ConversationHistory instance from JSON.
      */
     static from(json: ConversationHistoryJSON, environment?: Partial<ConversationEnvironment>): ConversationHistory;
+    /**
+     * Creates a ConversationHistory instance from a Markdown string.
+     */
+    static fromMarkdown(markdown: string, environment?: Partial<ConversationEnvironment>): ConversationHistory;
     /**
      * Binds a function to this history instance.
      * The first argument of the function must be a Conversation.

package/dist/history.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,eAAe,EAErB,MAAM,WAAW,CAAC;AAuBnB,OAAO,EACL,KAAK,uBAAuB,EAE7B,MAAM,eAAe,CAAC;AAQvB,OAAO,KAAK,EACV,YAAY,EACZ,uBAAuB,EAEvB,OAAO,EACP,YAAY,EACZ,UAAU,EACX,MAAM,SAAS,CAAC;AACjB,OAAO,EAA4B,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE/E;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,WAAW,CAAC,8BAA8B,CAAC;gBAC3E,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,8BAA8B;CAGjE;AAQD;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;IAClD,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,WAAW,CAA0B;gBAG3C,OAAO,GAAE,YAAmC,EAC5C,WAAW,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC;IAWhD;;OAEG;IACH,OAAO,CAAC,YAAY;IASpB;;;OAGG;IACM,gBAAgB,CACvB,IAAI,EAAE,MAAM,EACZ,QAAQ,EACJ,CAAC,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,CAAC,GAC3C,kCAAkC,GAClC,IAAI,EACR,OAAO,CAAC,EAAE,OAAO,GAAG,uBAAuB,GAC1C,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC;IAYtB;;;;;OAKG;IACH,SAAS,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,GAAG,MAAM,IAAI;IAiBzD;;;OAGG;IACH,WAAW,IAAI,YAAY;IAI3B;;OAEG;IACH,IAAI,OAAO,IAAI,YAAY,CAE1B;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;OAEG;IACH,IAAI,GAAG,IAAI,uBAAuB,CAEjC;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,MAAM,CAGxB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAW9B;;;OAGG;IACH,IAAI,IAAI,YAAY,GAAG,SAAS;IAShC;;;;OAIG;IACH,IAAI,CAAC,UAAU,GAAE,MAAU,GAAG,YAAY,GAAG,SAAS;IAUtD;;;;OAIG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAYvD;;OAEG;IACH,OAAO,IAAI,YAAY,EAAE;IAYzB,WAAW,CAAC,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,aAAa,CAAC,OAAO,CAAC;IAI1E,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAI3D,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIvD,cAAc,CAAC,SAAS,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,EAAE;IAI7D,aAAa;;;;;;IAIb,gBAAgB,IAAI,OAAO;IAI3B,qBAAqB,IAAI,OAAO,GAAG,SAAS;IAI5C,iBAAiB,IAAI,aAAa,CAAC,OAAO,CAAC;IAI3C,SAAS;IAIT,cAAc;IAId,UAAU,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM;IAI/C,cAAc,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,GAAG,MAAM;IAIhE,iBAAiB,CACf,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAC;QAAC,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7D,aAAa,CAAC,OAAO,CAAC;IAIzB,mBAAmB,IAAI,OAAO,GAAG,SAAS;IAM1C,cAAc,CAAC,GAAG,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI;IAI/C,iBAAiB,CACf,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,EAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI;IAIP,sBAAsB,CACpB,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,EAChC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,IAAI;IAIP,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9E,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/E,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/E,sBAAsB,IAAI,IAAI;IAI9B,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAIrE,oBAAoB,CAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;QAAE,sBAAsB,CAAC,EAAE,OAAO,CAAA;KAAE,GAC7C,IAAI;IAIP,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI;IAIxE,sBAAsB,CACpB,IAAI,EAAE,WAAW,GAAG,MAAM,EAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,MAAM;IAWT,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAIhE,wBAAwB,CACtB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,UAAU,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GACxE,IAAI;IAIP,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI/C;;OAEG;IACH,MAAM,IAAI,uBAAuB;IA2BjC;;OAEG;IACH,MAAM,CAAC,IAAI,CACT,IAAI,EAAE,uBAAuB,EAC7B,WAAW,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC7C,mBAAmB;IA0CtB;;OAEG;IACH,MAAM,CAAC,YAAY,CACjB,QAAQ,EAAE,MAAM,EAChB,WAAW,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAC7C,mBAAmB;IAKtB;;;;OAIG;IACH,IAAI,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EACzB,EAAE,EAAE,CACF,YAAY,EAAE,YAAY,EAC1B,GAAG,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC,CAAC,KAC/C,CAAC,GACL,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC;IAIpB;;OAEG;IACH,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAsBzB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,OAAO,EAAE,EAAE,CAAC,EAC9D,OAAO,EAAE,mBAAmB,EAC5B,EAAE,EAAE,CACF,YAAY,EAAE,YAAY,EAC1B,GAAG,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC,CAAC,KAC/C,CAAC,GACL,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC,CAYnB"}

package/dist/index.js

@@ -3588,29 +3588,28 @@ 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);
-    }
-  }
-  for (const msg of messages) {
-    if (msg.toolCall) {
-      pairs.push({
-        call: msg.toolCall,
-        result: resultsMap.get(msg.toolCall.id)
-      });
-    }
-  }
-  return pairs;
+// 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/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 +3627,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,6 +3643,8 @@ function messageText(message, joiner = `
 function messageHasImages(message) {
   return messageParts(message).some((p) => p.type === "image");
 }
+
+// src/utilities/markdown.ts
 var ROLE_DISPLAY_NAMES = {
   user: "User",
   assistant: "Assistant",
@@ -3876,7 +3865,25 @@ 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/environment.ts
 function simpleTokenEstimator(message) {
   const text = messageText(message);
@@ -4651,7 +4658,7 @@ class ConversationHistoryEvent extends CustomEvent {
 class ConversationHistory extends EventTarget {
   currentNode;
   environment;
-  constructor(initial, environment) {
+  constructor(initial = createConversation(), environment) {
     super();
     this.environment = resolveConversationEnvironment(environment);
     this.currentNode = {
@@ -4788,6 +4795,9 @@ class ConversationHistory extends EventTarget {
   toChatMessages() {
     return toChatMessages(this.current);
   }
+  toMarkdown(options2) {
+    return toMarkdown(this.current, options2);
+  }
   estimateTokens(estimator) {
     return estimateConversationTokens(this.current, estimator, this.env);
   }
@@ -4890,6 +4900,10 @@ class ConversationHistory extends EventTarget {
     h.currentNode = current;
     return history;
   }
+  static fromMarkdown(markdown, environment) {
+    const conversation = fromMarkdown(markdown);
+    return new ConversationHistory(conversation, environment);
+  }
   bind(fn) {
     return bindToConversationHistory(this, fn);
   }
@@ -4990,4 +5004,4 @@ export {
   ConversationHistory
 };
 
-//# debugId=50FF32F5809AA07D64756E2164756E21
+//# debugId=5ABC5C6EA1F008F764756E2164756E21