mindcache 3.7.0 → 3.8.1

package/README.md

@@ -5,7 +5,7 @@ A TypeScript library for managing short-term memory in AI agents through an LLM-
 ## Documentation
 
 *   **[API Reference](./docs/mindcache-api.md)**: Detailed method signatures and type definitions. Optimized for AI agents (like Cursor, Claude, etc.) to understand the library's capabilities.
-*   **[Full Documentation](https://mindcache.dev/llms-full.md)**: Comprehensive guide with examples and deep dives.
+*   **[Full Documentation](https://mindcache.dev/llms-full.txt)**: Comprehensive guide with examples and deep dives.
 
 ## Quick Start
 

package/dist/{CloudAdapter-PLGvGjoA.d.mts → CloudAdapter-D6hoG13x.d.mts}

@@ -193,7 +193,7 @@ declare class MindCache {
     rootMap: Y.Map<Y.Map<any>>;
     private listeners;
     private globalListeners;
-    readonly version = "3.6.0";
+    readonly version = "3.8.0";
     normalizeSystemTags(tags: SystemTag[]): SystemTag[];
     private _cloudAdapter;
     private _connectionState;
@@ -503,8 +503,12 @@ declare class MindCache {
     fromJSON(jsonString: string): void;
     /**
      * Export to Markdown format.
+     * @param options Optional name and description for the export
      */
-    toMarkdown(): string;
+    toMarkdown(options?: {
+        name?: string;
+        description?: string;
+    }): string;
     /**
      * Import from Markdown format.
      * @param markdown The markdown string to import

package/dist/{CloudAdapter-PLGvGjoA.d.ts → CloudAdapter-D6hoG13x.d.ts}

@@ -193,7 +193,7 @@ declare class MindCache {
     rootMap: Y.Map<Y.Map<any>>;
     private listeners;
     private globalListeners;
-    readonly version = "3.6.0";
+    readonly version = "3.8.0";
     normalizeSystemTags(tags: SystemTag[]): SystemTag[];
     private _cloudAdapter;
     private _connectionState;
@@ -503,8 +503,12 @@ declare class MindCache {
     fromJSON(jsonString: string): void;
     /**
      * Export to Markdown format.
+     * @param options Optional name and description for the export
      */
-    toMarkdown(): string;
+    toMarkdown(options?: {
+        name?: string;
+        description?: string;
+    }): string;
     /**
      * Import from Markdown format.
      * @param markdown The markdown string to import

package/dist/cloud/index.d.mts

@@ -1,5 +1,5 @@
-import { M as MindCache, C as CloudConfig, a as CloudAdapter } from '../CloudAdapter-PLGvGjoA.mjs';
-export { d as ClearOperation, c as CloudAdapterEvents, b as ConnectionState, D as DeleteOperation, O as Operation, S as SetOperation } from '../CloudAdapter-PLGvGjoA.mjs';
+import { M as MindCache, C as CloudConfig, a as CloudAdapter } from '../CloudAdapter-D6hoG13x.mjs';
+export { d as ClearOperation, c as CloudAdapterEvents, b as ConnectionState, D as DeleteOperation, O as Operation, S as SetOperation } from '../CloudAdapter-D6hoG13x.mjs';
 import 'yjs';
 
 /**

package/dist/cloud/index.d.ts

@@ -1,5 +1,5 @@
-import { M as MindCache, C as CloudConfig, a as CloudAdapter } from '../CloudAdapter-PLGvGjoA.js';
-export { d as ClearOperation, c as CloudAdapterEvents, b as ConnectionState, D as DeleteOperation, O as Operation, S as SetOperation } from '../CloudAdapter-PLGvGjoA.js';
+import { M as MindCache, C as CloudConfig, a as CloudAdapter } from '../CloudAdapter-D6hoG13x.js';
+export { d as ClearOperation, c as CloudAdapterEvents, b as ConnectionState, D as DeleteOperation, O as Operation, S as SetOperation } from '../CloudAdapter-D6hoG13x.js';
 import 'yjs';
 
 /**

package/dist/cloud/index.js

@@ -545,18 +545,23 @@ var MarkdownSerializer = class {
   /**
      * Export MindCache data to Markdown format.
      */
-  static toMarkdown(mc) {
+  static toMarkdown(mc, options) {
     const now = /* @__PURE__ */ new Date();
     const lines = [];
     const appendixEntries = [];
     let appendixCounter = 0;
-    lines.push("# MindCache STM Export");
+    const name = options?.name || "MindCache Export";
+    lines.push(`# ${name}`);
     lines.push("");
+    if (options?.description) {
+      lines.push(options.description);
+      lines.push("");
+    }
     lines.push(`Export Date: ${now.toISOString().split("T")[0]}`);
     lines.push("");
     lines.push("---");
     lines.push("");
-    lines.push("## STM Entries");
+    lines.push("## Keys & Values");
     lines.push("");
     const sortedKeys = mc.getSortedKeys();
     sortedKeys.forEach((key) => {
@@ -564,9 +569,17 @@ var MarkdownSerializer = class {
       const value = mc.get_value(key);
       lines.push(`### ${key}`);
       const entryType = attributes?.type || "text";
-      lines.push(`- **Type**: \`${entryType}\``);
-      lines.push(`- **System Tags**: \`${attributes?.systemTags?.join(", ") || "none"}\``);
-      lines.push(`- **Z-Index**: \`${attributes?.zIndex ?? 0}\``);
+      if (entryType !== "text") {
+        lines.push(`- **Type**: \`${entryType}\``);
+      }
+      const systemTags = attributes?.systemTags;
+      if (systemTags && systemTags.length > 0) {
+        lines.push(`- **System Tags**: \`${systemTags.join(", ")}\``);
+      }
+      const zIndex = attributes?.zIndex ?? 0;
+      if (zIndex !== 0) {
+        lines.push(`- **Z-Index**: \`${zIndex}\``);
+      }
       if (attributes?.contentTags && attributes.contentTags.length > 0) {
         lines.push(`- **Tags**: \`${attributes.contentTags.join("`, `")}\``);
       }
@@ -745,7 +758,7 @@ var MarkdownSerializer = class {
       mc.set_value(currentKey, currentValue.trim(), currentAttributes);
     }
     const hasParsedKeys = lines.some((line) => line.startsWith("### ") && !line.startsWith("### Appendix"));
-    const isSTMExport = markdown.includes("# MindCache STM Export") || markdown.includes("## STM Entries");
+    const isSTMExport = markdown.includes("# MindCache STM Export") || markdown.includes("## STM Entries") || markdown.includes("## Keys & Values") || markdown.includes("# MindCache Export");
     if (!hasParsedKeys && !isSTMExport && markdown.trim().length > 0) {
       mc.set_value("imported_content", markdown.trim(), {
         type: "text",
@@ -873,7 +886,7 @@ var MarkdownSerializer = class {
     }
     saveEntry();
     const hasParsedKeys = lines.some((line) => line.startsWith("### ") && !line.startsWith("### Appendix"));
-    const isSTMExport = markdown.includes("# MindCache STM Export") || markdown.includes("## STM Entries");
+    const isSTMExport = markdown.includes("# MindCache STM Export") || markdown.includes("## STM Entries") || markdown.includes("## Keys & Values") || markdown.includes("# MindCache Export");
     if (!hasParsedKeys && !isSTMExport && markdown.trim().length > 0) {
       result["imported_content"] = {
         value: markdown.trim(),
@@ -1604,7 +1617,7 @@ var MindCache = class {
   listeners = {};
   globalListeners = [];
   // Metadata
-  version = "3.6.0";
+  version = "3.8.0";
   // Internal flag to prevent sync loops when receiving remote updates
   // (Less critical with Yjs but kept for API compat)
   normalizeSystemTags(tags) {
@@ -2699,9 +2712,10 @@ var MindCache = class {
   }
   /**
    * Export to Markdown format.
+   * @param options Optional name and description for the export
    */
-  toMarkdown() {
-    return MarkdownSerializer.toMarkdown(this);
+  toMarkdown(options) {
+    return MarkdownSerializer.toMarkdown(this, options);
   }
   /**
    * Import from Markdown format.