mnueron 0.4.0 → 0.6.0

package/dist/lib/date-anchors.js

@@ -0,0 +1,351 @@
+/**
+ * Date-anchor extraction from natural-language text.
+ *
+ * Used by:
+ *   - LocalProvider.save() — Tier 3: stamps extracted anchors as
+ *     metadata.temporal_anchors at ingestion time, so retrieval can
+ *     answer "when did X happen" without LLM-side date arithmetic.
+ *   - Benchmark adapter — Tier 4: extracts anchor from the QUERY,
+ *     re-ranks retrieved memories by proximity to it.
+ *   - LocalProvider.search() (future) — Tier 2: temporal-intent boost.
+ *
+ * Scope (intentional limits):
+ *   - English-only patterns. The LoCoMo benchmark + Claude/ChatGPT
+ *     dialogs are overwhelmingly English; non-English support is a
+ *     separate hard problem and not on the roadmap.
+ *   - Regex-only (no LLM call). Tradeoff: lower recall on weird
+ *     phrasings like "the spring before last", but ~5 ms per extraction
+ *     vs $0.0001 per LLM call. For a 700-memory session that's the
+ *     difference between 3.5s of CPU and $0.07.
+ *   - Year-disambiguation uses the anchor date as "now". A phrase like
+ *     "last March" resolves relative to when the memory was saved.
+ *
+ * Returns absolute epoch-ms timestamps per anchor so downstream code
+ * doesn't have to re-parse anything. Each anchor preserves the original
+ * phrase for explainability ("matched 'last March' in memory X").
+ */
+// ─── Month + day vocabulary ───────────────────────────────────────────────
+const MONTHS = {
+    january: 0, jan: 0,
+    february: 1, feb: 1,
+    march: 2, mar: 2,
+    april: 3, apr: 3,
+    may: 4,
+    june: 5, jun: 5,
+    july: 6, jul: 6,
+    august: 7, aug: 7,
+    september: 8, sep: 8, sept: 8,
+    october: 9, oct: 9,
+    november: 10, nov: 10,
+    december: 11, dec: 11,
+};
+const WEEKDAYS = {
+    sunday: 0, sun: 0,
+    monday: 1, mon: 1,
+    tuesday: 2, tue: 2, tues: 2,
+    wednesday: 3, wed: 3,
+    thursday: 4, thu: 4, thur: 4, thurs: 4,
+    friday: 5, fri: 5,
+    saturday: 6, sat: 6,
+};
+const RELATIVE_UNIT_MS = {
+    second: 1000, seconds: 1000, sec: 1000, secs: 1000,
+    minute: 60_000, minutes: 60_000, min: 60_000, mins: 60_000,
+    hour: 3_600_000, hours: 3_600_000, hr: 3_600_000, hrs: 3_600_000,
+    day: 86_400_000, days: 86_400_000,
+    week: 604_800_000, weeks: 604_800_000, wk: 604_800_000, wks: 604_800_000,
+    month: 2_629_800_000, months: 2_629_800_000, // ~30.44 days
+    year: 31_557_600_000, years: 31_557_600_000, // 365.25 days
+};
+const NUMBER_WORDS = {
+    one: 1, two: 2, three: 3, four: 4, five: 5,
+    six: 6, seven: 7, eight: 8, nine: 9, ten: 10,
+    eleven: 11, twelve: 12, dozen: 12,
+    a: 1, an: 1, // "a week ago" = 1 week
+};
+// ─── Public API ───────────────────────────────────────────────────────────
+/**
+ * Extract every date phrase from `text` and resolve to absolute epoch-ms.
+ *
+ * `anchor` is the reference time for relative phrases. If a memory was
+ * saved on 2024-05-15 and contains "last March", anchor=2024-05-15 →
+ * resolved="2024-03 (i.e. 3 months ago)". If anchor is omitted, defaults
+ * to Date.now().
+ *
+ * Returns anchors sorted by resolved_ms ascending. Empty array if none found.
+ */
+export function extractDateAnchors(text, anchor) {
+    if (!text)
+        return [];
+    const anchorDate = anchor instanceof Date
+        ? anchor
+        : new Date(typeof anchor === 'number' ? anchor : Date.now());
+    const out = [];
+    const seenSpans = new Set(); // dedup by exact-phrase span
+    for (const fn of [
+        extractIsoDates,
+        extractNumericDates,
+        extractWrittenDates,
+        extractAbsoluteMonths,
+        extractQuarters,
+        extractRelativeNAgo,
+        extractRelativeUnit,
+        extractWeekdays,
+    ]) {
+        for (const anch of fn(text, anchorDate)) {
+            const key = `${anch.phrase}@${anch.resolved_ms}`;
+            if (seenSpans.has(key))
+                continue;
+            seenSpans.add(key);
+            out.push(anch);
+        }
+    }
+    out.sort((a, b) => a.resolved_ms - b.resolved_ms);
+    return out;
+}
+// ─── Extractors ───────────────────────────────────────────────────────────
+/** ISO 8601: 2024-03-15 or 2024-03-15T10:30:00Z. */
+function extractIsoDates(text, _anchor) {
+    const out = [];
+    const re = /\b(\d{4})-(\d{2})-(\d{2})(?:T(\d{2}):(\d{2})(?::(\d{2}))?(?:Z|[+-]\d{2}:?\d{2})?)?\b/g;
+    let m;
+    while ((m = re.exec(text))) {
+        const [, y, mo, d, hh, mm, ss] = m;
+        const ms = Date.UTC(+y, +mo - 1, +d, +(hh ?? 0), +(mm ?? 0), +(ss ?? 0));
+        if (!Number.isFinite(ms))
+            continue;
+        out.push({
+            phrase: m[0],
+            resolved_ms: ms,
+            kind: 'absolute-date',
+            confidence: 0.99,
+        });
+    }
+    return out;
+}
+/** MM/DD/YYYY or M/D/YY (US-style; ambiguous DD/MM/YY accepted with lower conf). */
+function extractNumericDates(text, _anchor) {
+    const out = [];
+    // 5/15/24, 05/15/2024
+    const re = /\b(\d{1,2})\/(\d{1,2})\/(\d{2,4})\b/g;
+    let m;
+    while ((m = re.exec(text))) {
+        let [, a, b, y] = m;
+        let yy = +y;
+        if (yy < 100)
+            yy += yy >= 50 ? 1900 : 2000;
+        // Assume US MM/DD ordering. If first part > 12, assume DD/MM (less common).
+        let month = +a - 1;
+        let day = +b;
+        if (+a > 12) {
+            month = +b - 1;
+            day = +a;
+        }
+        if (month < 0 || month > 11 || day < 1 || day > 31)
+            continue;
+        const ms = Date.UTC(yy, month, day);
+        out.push({
+            phrase: m[0],
+            resolved_ms: ms,
+            kind: 'absolute-date',
+            confidence: +a > 12 ? 0.7 : 0.85,
+        });
+    }
+    return out;
+}
+/** "March 15, 2024", "Mar 15 2024", "15 March 2024", "15th of March 2024". */
+function extractWrittenDates(text, _anchor) {
+    const out = [];
+    const monthAlt = Object.keys(MONTHS).join('|');
+    // "March 15, 2024" / "March 15 2024" / "Mar 15th, 2024"
+    const re1 = new RegExp(`\\b(${monthAlt})\\s+(\\d{1,2})(?:st|nd|rd|th)?,?\\s+(\\d{4})\\b`, 'gi');
+    for (let m; (m = re1.exec(text));) {
+        const mo = MONTHS[m[1].toLowerCase()];
+        const d = +m[2];
+        const y = +m[3];
+        if (mo == null || d < 1 || d > 31)
+            continue;
+        out.push({
+            phrase: m[0],
+            resolved_ms: Date.UTC(y, mo, d),
+            kind: 'absolute-date',
+            confidence: 0.95,
+        });
+    }
+    // "15 March 2024" / "15th of March, 2024"
+    const re2 = new RegExp(`\\b(\\d{1,2})(?:st|nd|rd|th)?\\s+(?:of\\s+)?(${monthAlt})(?:,?\\s+(\\d{4}))?\\b`, 'gi');
+    for (let m; (m = re2.exec(text));) {
+        const d = +m[1];
+        const mo = MONTHS[m[2].toLowerCase()];
+        const y = m[3] ? +m[3] : new Date().getUTCFullYear();
+        if (mo == null || d < 1 || d > 31)
+            continue;
+        out.push({
+            phrase: m[0],
+            resolved_ms: Date.UTC(y, mo, d),
+            kind: 'absolute-date',
+            confidence: m[3] ? 0.92 : 0.7,
+        });
+    }
+    return out;
+}
+/** "March 2024", "in March 2024", "March of 2024". */
+function extractAbsoluteMonths(text, _anchor) {
+    const out = [];
+    const monthAlt = Object.keys(MONTHS).join('|');
+    const re = new RegExp(`\\b(?:in\\s+|of\\s+)?(${monthAlt})(?:\\s+of)?\\s+(\\d{4})\\b`, 'gi');
+    for (let m; (m = re.exec(text));) {
+        const mo = MONTHS[m[1].toLowerCase()];
+        const y = +m[2];
+        out.push({
+            phrase: m[0],
+            resolved_ms: Date.UTC(y, mo, 1),
+            kind: 'absolute-month',
+            confidence: 0.9,
+        });
+    }
+    return out;
+}
+/** "Q1 2024", "Q2 of 2024". */
+function extractQuarters(text, _anchor) {
+    const out = [];
+    const re = /\bq([1-4])(?:\s+(?:of\s+)?(\d{4}))?\b/gi;
+    for (let m; (m = re.exec(text));) {
+        const q = +m[1];
+        const y = m[2] ? +m[2] : new Date().getUTCFullYear();
+        const month = (q - 1) * 3;
+        out.push({
+            phrase: m[0],
+            resolved_ms: Date.UTC(y, month, 1),
+            kind: 'quarter',
+            confidence: m[2] ? 0.9 : 0.65,
+        });
+    }
+    return out;
+}
+/** "two weeks ago", "3 days ago", "a month ago". */
+function extractRelativeNAgo(text, anchor) {
+    const out = [];
+    const unitAlt = Object.keys(RELATIVE_UNIT_MS).join('|');
+    const numAlt = Object.keys(NUMBER_WORDS).join('|');
+    const re = new RegExp(`\\b(\\d+|${numAlt})\\s+(${unitAlt})\\s+ago\\b`, 'gi');
+    for (let m; (m = re.exec(text));) {
+        const numStr = m[1].toLowerCase();
+        const n = NUMBER_WORDS[numStr] ?? +numStr;
+        if (!Number.isFinite(n))
+            continue;
+        const unitMs = RELATIVE_UNIT_MS[m[2].toLowerCase()];
+        if (unitMs == null)
+            continue;
+        const ms = anchor.getTime() - n * unitMs;
+        out.push({
+            phrase: m[0],
+            resolved_ms: ms,
+            kind: 'relative',
+            confidence: 0.85,
+        });
+    }
+    return out;
+}
+/** "yesterday", "today", "tomorrow", "last week", "last month", "last March". */
+function extractRelativeUnit(text, anchor) {
+    const out = [];
+    // yesterday / today / tomorrow
+    for (const m of text.matchAll(/\b(yesterday|today|tomorrow|tonight)\b/gi)) {
+        const word = m[1].toLowerCase();
+        const offset = word === 'yesterday' ? -1 : word === 'tomorrow' ? +1 : 0;
+        const d = new Date(anchor);
+        d.setUTCDate(d.getUTCDate() + offset);
+        d.setUTCHours(word === 'tonight' ? 20 : 12, 0, 0, 0);
+        out.push({
+            phrase: m[0],
+            resolved_ms: d.getTime(),
+            kind: 'relative',
+            confidence: 0.9,
+        });
+    }
+    // last week / last month / last year / next week / etc.
+    for (const m of text.matchAll(/\b(last|next|this|previous|past)\s+(week|month|year)\b/gi)) {
+        const dir = m[1].toLowerCase();
+        const unit = m[2].toLowerCase();
+        const sign = dir === 'next' ? +1 : dir === 'this' ? 0 : -1;
+        const ms = RELATIVE_UNIT_MS[unit] ?? 0;
+        out.push({
+            phrase: m[0],
+            resolved_ms: anchor.getTime() + sign * ms,
+            kind: 'relative',
+            confidence: 0.8,
+        });
+    }
+    // last March / next March / etc. — resolves to nearest March in that direction
+    const monthAlt = Object.keys(MONTHS).join('|');
+    const reMonth = new RegExp(`\\b(last|next|this|previous)\\s+(${monthAlt})\\b`, 'gi');
+    for (let m; (m = reMonth.exec(text));) {
+        const dir = m[1].toLowerCase();
+        const mo = MONTHS[m[2].toLowerCase()];
+        const y = anchor.getUTCFullYear();
+        const curMo = anchor.getUTCMonth();
+        let resolvedYear = y;
+        if (dir === 'last' || dir === 'previous') {
+            resolvedYear = mo < curMo ? y : y - 1;
+        }
+        else if (dir === 'next') {
+            resolvedYear = mo > curMo ? y : y + 1;
+        } // this March → current year
+        out.push({
+            phrase: m[0],
+            resolved_ms: Date.UTC(resolvedYear, mo, 1),
+            kind: 'relative',
+            confidence: 0.85,
+        });
+    }
+    return out;
+}
+/** "Monday", "last Monday", "Tuesday" — anchored against `anchor`. */
+function extractWeekdays(text, anchor) {
+    const out = [];
+    const dayAlt = Object.keys(WEEKDAYS).join('|');
+    // Only match standalone weekdays preceded by "last", "next", "this", or "on"
+    // to avoid false positives on every "Monday" mention.
+    const re = new RegExp(`\\b(?:(last|next|this|on)\\s+)?(${dayAlt})\\b`, 'gi');
+    for (let m; (m = re.exec(text));) {
+        const dir = (m[1] ?? '').toLowerCase();
+        if (!dir)
+            continue; // skip standalone "Monday" without context
+        const targetDay = WEEKDAYS[m[2].toLowerCase()];
+        const curDay = anchor.getUTCDay();
+        const diff = targetDay - curDay;
+        let offsetDays = dir === 'next' ? (diff <= 0 ? diff + 7 : diff) :
+            dir === 'last' ? (diff >= 0 ? diff - 7 : diff) :
+                diff; // "this Monday" / "on Monday"
+        const d = new Date(anchor);
+        d.setUTCDate(d.getUTCDate() + offsetDays);
+        d.setUTCHours(12, 0, 0, 0);
+        out.push({
+            phrase: m[0],
+            resolved_ms: d.getTime(),
+            kind: 'day-of-week',
+            confidence: 0.75,
+        });
+    }
+    return out;
+}
+// ─── Query-side helpers ───────────────────────────────────────────────────
+/**
+ * Returns the single most-likely time anchor from a question.
+ *
+ * "When did Sarah change jobs last March?" → the "last March" anchor.
+ * "How long ago did the meeting happen?" → null (no anchor present).
+ *
+ * Used by the benchmark adapter to bias retrieval toward memories near
+ * the query's time reference. If multiple anchors are present, prefers
+ * the most specific (highest confidence).
+ */
+export function extractQueryAnchor(query, now) {
+    const anchors = extractDateAnchors(query, now);
+    if (anchors.length === 0)
+        return null;
+    // Prefer highest confidence; break ties by latest in text.
+    return anchors.slice().sort((a, b) => b.confidence - a.confidence)[0];
+}
+//# sourceMappingURL=date-anchors.js.map

package/dist/lib/date-anchors.js.map

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

package/dist/lib/temporal-intent.js

@@ -0,0 +1,98 @@
+/**
+ * Temporal-intent classifier for queries.
+ *
+ * A query is "temporal" if answering it requires reasoning about WHEN
+ * something happened, not just WHAT. Examples:
+ *
+ *   "When did Sarah change jobs?"         ← yes (explicit "when")
+ *   "How long ago was the meeting?"       ← yes (duration)
+ *   "What did Sarah do in March?"         ← yes (month anchor)
+ *   "Before or after Tuesday?"            ← yes (relational)
+ *   "What did Sarah say about hiking?"    ← no (purely semantic)
+ *
+ * Temporal queries benefit from:
+ *   - Tier 2: timestamp-aware retrieval ranking (boost time-proximate memories)
+ *   - Tier 4: chronological re-sort + anchor-proximity re-rank
+ *
+ * Non-temporal queries skip the temporal machinery entirely.
+ *
+ * Returns a structured TemporalIntent with:
+ *   - `isTemporal`: boolean gate
+ *   - `kind`: what KIND of temporal (when / duration / ordering / range)
+ *   - `anchor`: extracted query time reference, if any (via date-anchors.ts)
+ *
+ * Pure module — no I/O, no DB. Trivially unit-testable.
+ */
+import { extractQueryAnchor } from './date-anchors.js';
+// Strong markers — presence flips isTemporal=true with high confidence.
+const TRIGGER_PATTERNS = [
+    // "when did X happen", "when was Y"
+    { re: /\bwhen\b/i, kind: 'when' },
+    // "how long ago", "how many days/weeks/months/years"
+    { re: /\bhow\s+long\b/i, kind: 'duration' },
+    { re: /\bhow\s+many\s+(?:days|weeks|months|years|hours|minutes)\b/i, kind: 'duration' },
+    { re: /\bago\b/i, kind: 'duration' },
+    // ordering
+    { re: /\bbefore\b/i, kind: 'ordering' },
+    { re: /\bafter\b/i, kind: 'ordering' },
+    { re: /\bprior\s+to\b/i, kind: 'ordering' },
+    { re: /\bfirst\s+(?:time|did|was|met|said|asked)\b/i, kind: 'ordering' },
+    { re: /\blast\s+(?:time|did|was|met|said|asked)\b/i, kind: 'ordering' },
+    { re: /\bearliest\b/i, kind: 'ordering' },
+    { re: /\blatest\b/i, kind: 'ordering' },
+    // range
+    { re: /\bbetween\s+\w+\s+and\s+\w+\b/i, kind: 'range' },
+    { re: /\bsince\s+(?:\w+|the)\b/i, kind: 'range' },
+    // explicit date/month mentions — weaker, only counts if no other signal yet
+    { re: /\b(?:january|february|march|april|may|june|july|august|september|october|november|december)\b/i, kind: 'date-mention' },
+    { re: /\b(?:monday|tuesday|wednesday|thursday|friday|saturday|sunday)\b/i, kind: 'date-mention' },
+    { re: /\b(?:yesterday|today|tomorrow|tonight)\b/i, kind: 'date-mention' },
+];
+export function classifyTemporal(query, now) {
+    if (!query) {
+        return { isTemporal: false, kind: null, anchor: null, triggers: [] };
+    }
+    const triggers = [];
+    let strongestKind = null;
+    for (const { re, kind } of TRIGGER_PATTERNS) {
+        const m = re.exec(query);
+        if (!m)
+            continue;
+        triggers.push(m[0].toLowerCase());
+        // Priority: when > ordering > duration > range > date-mention.
+        // Use first-match-wins by priority order in the array.
+        if (strongestKind === null)
+            strongestKind = kind;
+    }
+    const anchor = extractQueryAnchor(query, now);
+    return {
+        isTemporal: strongestKind !== null,
+        kind: strongestKind,
+        anchor,
+        triggers,
+    };
+}
+/**
+ * Convenience: just the boolean gate, for places that don't need
+ * the full classifier output.
+ */
+export function isTemporalQuery(query) {
+    return classifyTemporal(query).isTemporal;
+}
+/**
+ * Compute a proximity score [0..1] between a memory and a query anchor.
+ * 1.0 = same timestamp; decays with distance using a half-life schedule.
+ *
+ * Half-life is 30 days by default — most LoCoMo conversations span weeks,
+ * so memories within ~1 month of the query anchor get strong boosts.
+ *
+ * Used by Tier 4 re-rank.
+ */
+export function temporalProximityScore(memoryTs, queryAnchor, halfLifeMs = 30 * 24 * 60 * 60 * 1000) {
+    if (!memoryTs || !queryAnchor)
+        return 0;
+    const distMs = Math.abs(memoryTs - queryAnchor.resolved_ms);
+    // Exponential decay: score = 0.5^(dist/halfLife)
+    return Math.pow(0.5, distMs / halfLifeMs);
+}
+//# sourceMappingURL=temporal-intent.js.map

package/dist/lib/temporal-intent.js.map

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