mem-os-python 1.6.27__py3-none-any.whl

memos/_js/timestamp-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamp-format.d.ts","sourceRoot":"","sources":["../src/timestamp-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,GAAG,GAAE,MAAmB,GACvB,MAAM,CA+BR"}

memos/_js/timestamp-format.js

@@ -0,0 +1,52 @@
+/**
+ * Human-readable timestamp formatting for recalled memories.
+ *
+ * From Honcho: LLMs reason better about time when they see explicit
+ * absolute + relative timestamps ("2026-09-28 — 6 days ago") instead
+ * of raw epoch milliseconds. The TimeQA step-back paper showed +12pts
+ * from better temporal grounding.
+ *
+ * Pure rendering helper — does not affect retrieval scoring.
+ */
+/**
+ * Format an epoch-ms timestamp as "YYYY-MM-DD — N days ago".
+ *
+ * @param epochMs - Timestamp in epoch milliseconds
+ * @param now - Reference time (defaults to Date.now())
+ */
+export function formatMemoryTimestamp(epochMs, now = Date.now()) {
+    const date = new Date(epochMs);
+    const iso = date.toISOString().slice(0, 10); // YYYY-MM-DD
+    const diffMs = now - epochMs;
+    const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));
+    let relative;
+    if (diffDays < 0) {
+        relative = "in the future";
+    }
+    else if (diffDays === 0) {
+        const diffHours = Math.floor(diffMs / (1000 * 60 * 60));
+        if (diffHours === 0) {
+            const diffMins = Math.floor(diffMs / (1000 * 60));
+            relative = diffMins <= 1 ? "just now" : `${diffMins} minutes ago`;
+        }
+        else {
+            relative = diffHours === 1 ? "1 hour ago" : `${diffHours} hours ago`;
+        }
+    }
+    else if (diffDays === 1) {
+        relative = "yesterday";
+    }
+    else if (diffDays < 30) {
+        relative = `${diffDays} days ago`;
+    }
+    else if (diffDays < 365) {
+        const months = Math.floor(diffDays / 30);
+        relative = months === 1 ? "1 month ago" : `${months} months ago`;
+    }
+    else {
+        const years = Math.floor(diffDays / 365);
+        relative = years === 1 ? "1 year ago" : `${years} years ago`;
+    }
+    return `${iso} — ${relative}`;
+}
+//# sourceMappingURL=timestamp-format.js.map

memos/_js/timestamp-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamp-format.js","sourceRoot":"","sources":["../src/timestamp-format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAe,EACf,GAAG,GAAW,IAAI,CAAC,GAAG,EAAE;IAExB,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa;IAE1D,MAAM,MAAM,GAAG,GAAG,GAAG,OAAO,CAAC;IAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAE5D,IAAI,QAAgB,CAAC;IACrB,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACjB,QAAQ,GAAG,eAAe,CAAC;IAC7B,CAAC;SAAM,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QACxD,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;YAClD,QAAQ,GAAG,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,QAAQ,cAAc,CAAC;QACpE,CAAC;aAAM,CAAC;YACN,QAAQ,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,YAAY,CAAC;QACvE,CAAC;IACH,CAAC;SAAM,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QAC1B,QAAQ,GAAG,WAAW,CAAC;IACzB,CAAC;SAAM,IAAI,QAAQ,GAAG,EAAE,EAAE,CAAC;QACzB,QAAQ,GAAG,GAAG,QAAQ,WAAW,CAAC;IACpC,CAAC;SAAM,IAAI,QAAQ,GAAG,GAAG,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC;QACzC,QAAQ,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,MAAM,aAAa,CAAC;IACnE,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC;QACzC,QAAQ,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,KAAK,YAAY,CAAC;IAC/D,CAAC;IAED,OAAO,GAAG,GAAG,MAAM,QAAQ,EAAE,CAAC;AAChC,CAAC"}

memos/_js/triple-extraction.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Rule-based semantic triple extraction for write-time structuring.
+ *
+ * Extracts (subject, predicate, object) triples from memory content at
+ * store time. Inspired by Memori's "Advanced Augmentation" pipeline, which
+ * converts unstructured dialogue into semantic triples for precise
+ * retrieval — but rule-based and local-first (no LLM needed).
+ *
+ * This is experimental and opt-in. Triples are stored in node metadata
+ * (`metadata.triples`) and can boost retrieval when the query's triples
+ * match stored triples.
+ *
+ * The extractor uses simple SVO patterns. It's heuristic, not perfect —
+ * but it's fast, deterministic, and testable through the accuracy gate.
+ */
+export interface SemanticTriple {
+    subject: string;
+    predicate: string;
+    object: string;
+}
+/**
+ * Extract semantic triples from text.
+ * Returns array of {subject, predicate, object}.
+ */
+export declare function extractTriples(text: string): SemanticTriple[];
+/**
+ * Check if a query triple matches a stored triple.
+ * Matches on subject+predicate, or subject+object overlap.
+ */
+export declare function triplesMatch(queryTriples: SemanticTriple[], storedTriples: SemanticTriple[]): boolean;
+//# sourceMappingURL=triple-extraction.d.ts.map

memos/_js/triple-extraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triple-extraction.d.ts","sourceRoot":"","sources":["../src/triple-extraction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAiCD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CAgD7D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,YAAY,EAAE,cAAc,EAAE,EAC9B,aAAa,EAAE,cAAc,EAAE,GAC9B,OAAO,CAiBT"}

memos/_js/triple-extraction.js

@@ -0,0 +1,116 @@
+/**
+ * Rule-based semantic triple extraction for write-time structuring.
+ *
+ * Extracts (subject, predicate, object) triples from memory content at
+ * store time. Inspired by Memori's "Advanced Augmentation" pipeline, which
+ * converts unstructured dialogue into semantic triples for precise
+ * retrieval — but rule-based and local-first (no LLM needed).
+ *
+ * This is experimental and opt-in. Triples are stored in node metadata
+ * (`metadata.triples`) and can boost retrieval when the query's triples
+ * match stored triples.
+ *
+ * The extractor uses simple SVO patterns. It's heuristic, not perfect —
+ * but it's fast, deterministic, and testable through the accuracy gate.
+ */
+// Common copular/linking verbs that form "X is Y" triples.
+const COPULAR = new Set([
+    "is",
+    "are",
+    "was",
+    "were",
+    "be",
+    "been",
+    "become",
+    "became",
+]);
+// Common possession/relation verbs for "X has Y" triples.
+const POSSESSIVE = new Set(["has", "have", "had", "owns", "owned", "contains"]);
+// Preference verbs for "X prefers/likes Y" triples.
+const PREFERENCE = new Set([
+    "prefers",
+    "prefer",
+    "likes",
+    "like",
+    "loves",
+    "love",
+    "hates",
+    "hate",
+    "dislikes",
+    "dislike",
+    "enjoys",
+    "enjoy",
+]);
+/**
+ * Extract semantic triples from text.
+ * Returns array of {subject, predicate, object}.
+ */
+export function extractTriples(text) {
+    if (!text || text.length < 10)
+        return [];
+    const triples = [];
+    const seen = new Set();
+    // Split into sentences (simple).
+    const sentences = text.split(/[.!?]+/).filter((s) => s.trim().length > 5);
+    for (const sentence of sentences) {
+        const words = sentence.trim().split(/\s+/);
+        if (words.length < 3 || words.length > 40)
+            continue;
+        // Pattern 1: "X is Y" / "X are Y" (copular)
+        // Pattern 2: "X has Y" (possessive)
+        // Pattern 3: "X prefers Y" (preference)
+        for (let i = 1; i < words.length - 1; i++) {
+            const verb = words[i].toLowerCase().replace(/[^a-z]/g, "");
+            const subject = words.slice(0, i).join(" ").trim();
+            const object = words
+                .slice(i + 1)
+                .join(" ")
+                .trim();
+            if (subject.length < 2 || object.length < 2)
+                continue;
+            if (subject.length > 60 || object.length > 60)
+                continue;
+            let predicate = null;
+            if (COPULAR.has(verb))
+                predicate = "is";
+            else if (POSSESSIVE.has(verb))
+                predicate = "has";
+            else if (PREFERENCE.has(verb))
+                predicate = verb;
+            if (predicate) {
+                const key = `${subject}|${predicate}|${object}`.toLowerCase();
+                if (!seen.has(key)) {
+                    seen.add(key);
+                    triples.push({
+                        subject: subject.toLowerCase(),
+                        predicate,
+                        object: object.toLowerCase(),
+                    });
+                }
+                break; // One triple per sentence (the main clause)
+            }
+        }
+    }
+    return triples.slice(0, 10); // Cap at 10 per memory
+}
+/**
+ * Check if a query triple matches a stored triple.
+ * Matches on subject+predicate, or subject+object overlap.
+ */
+export function triplesMatch(queryTriples, storedTriples) {
+    for (const qt of queryTriples) {
+        for (const st of storedTriples) {
+            // Subject + predicate match (e.g., "user prefers" matches)
+            if (qt.subject === st.subject && qt.predicate === st.predicate) {
+                return true;
+            }
+            // Subject + object overlap
+            if (qt.subject === st.subject &&
+                (qt.object.includes(st.object) || st.object.includes(qt.object))) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=triple-extraction.js.map

memos/_js/triple-extraction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triple-extraction.js","sourceRoot":"","sources":["../src/triple-extraction.ts"],"names":[],"mappings":"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"}