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

memos/_js/event-memory.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Deterministic temporal event memory: extraction, update/cancel
+ * resolution, and reminder listing. No LLM on any path — regex intent
+ * detection plus the deterministic parser in `./temporal.js`, mirroring
+ * the `src/revert.ts` pattern.
+ *
+ * Cross-harness continuity: every harness (any model, any process) shares
+ * the same DB file and runs the same parsing/resolution rules, so an
+ * event stored by model A is updatable by model B. The update path reads
+ * the event's CURRENT row from the store (not from conversation state),
+ * so there is no per-harness state to drift.
+ *
+ * @module @memos/event-memory
+ */
+import { type TemporalDuration, type TemporalGrain } from "./temporal.js";
+import type { MemoryNode, ScoredMemory, SearchFilter } from "./types.js";
+/** Event status lifecycle. */
+export type EventStatus = "scheduled" | "recurring" | "cancelled";
+/**
+ * Structured event payload stored in `metadata.event`.
+ *
+ * - `kind`: canonical event noun ("meeting", "appointment", "reminder").
+ * - `label`: human noun phrase ("meeting", "dentist appointment").
+ * - `at`: ISO-8601 datetime of the event.
+ * - `grain`: temporal resolution of the parse.
+ * - `status`: "scheduled" events feed reminders; "recurring" (year-less
+ *   or every-X references) and "cancelled" never do.
+ * - `reminder_at`: ISO-8601; when the reminder fires (defaults to `at`).
+ */
+export interface EventMetadata {
+    kind: string;
+    label: string;
+    at: string;
+    grain: TemporalGrain;
+    status: EventStatus;
+    reminder_at: string;
+}
+/** Result of `detectEvent`. */
+export interface DetectedEvent extends EventMetadata {
+}
+/** A natural-language event update or cancellation. */
+export interface EventUpdate {
+    intent: "update" | "cancel";
+    /** Named event kind ("meeting"), absent for bare "it". */
+    kind?: string;
+    /** New absolute-ish time (parsed against `now`), for updates. */
+    newTime?: {
+        at: string;
+        grain: TemporalGrain;
+    };
+    /** Bare relative offset ("3 days later") — anchored to the EVENT's
+     *  current datetime, not to now. */
+    duration?: TemporalDuration;
+    /** Name of the pattern that fired (debugging / docs). */
+    pattern: string;
+}
+/**
+ * Detect a schedulable event in free text: an event noun co-occurring
+ * with a temporal expression.
+ *
+ * Guard (deterministic): dates without a year ("my birthday is June 1")
+ * or recurring references ("every Monday") yield `status: "recurring"` —
+ * they are stored as structured events but NEVER produce reminders.
+ *
+ * @param content — The memory text.
+ * @param now     — Reference time for temporal parsing.
+ * @returns The detected event, or null when no event noun + temporal
+ *   expression co-occur.
+ */
+export declare function detectEvent(content: string, now: Date): DetectedEvent | null;
+/**
+ * Detect an event update/cancellation command in free text.
+ *
+ * Returns null when: no update/cancel intent; intent present but no
+ * resolvable new time (fail safe — the write proceeds as a normal
+ * memory); or the text names no actionable target. An update intent
+ * WITHOUT a new time or duration is not an update — e.g. "we moved the
+ * meeting" (no when) must not touch the stored event.
+ *
+ * @param content — The memory text.
+ * @param now     — Reference time for absolute-ish new times.
+ */
+export declare function detectEventUpdate(content: string, now: Date): EventUpdate | null;
+/**
+ * Extract the named event kind from an update/cancel utterance.
+ * "that meeting" → "meeting"; "the dentist appointment" → "appointment";
+ * bare "it" → undefined.
+ */
+export declare function extractEventKind(content: string): string | undefined;
+/**
+ * Split a `memos remind "<text>" at <temporal-expression>` command.
+ * The temporal expression is the text after the LAST " at " whose suffix
+ * parses as a temporal expression (deterministic).
+ *
+ * @returns `{ text, temporal }`, or null when no trailing temporal
+ *   expression is found.
+ */
+export declare function splitRemindText(input: string): {
+    text: string;
+    temporal: string;
+} | null;
+/** True when the node is a currently-open scheduled event. */
+export declare function isScheduledEventNode(node: MemoryNode): boolean;
+/** Minimal read surface `listReminders` needs (MemOS satisfies it). */
+export interface ReminderSource {
+    search(filter: SearchFilter): Promise<ScoredMemory[]>;
+}
+export interface ListRemindersOptions {
+    /** Reference time ("now"); Date or Unix ms. */
+    now: Date | number;
+    /** When true, only reminders with reminder_at <= now. */
+    dueOnly?: boolean;
+    /** Namespace to scan (default: all namespaces). */
+    namespace?: string;
+    /** Scan cap (default 10_000 — same local-scan approach as other
+     *  maintenance passes in the codebase; v1 simplicity over an index). */
+    limit?: number;
+}
+export interface ReminderEntry {
+    id: string;
+    kind: string;
+    label: string;
+    at: string;
+    grain: TemporalGrain;
+    reminderAt: string;
+    content: string;
+    createdAt: number;
+    /** True when reminderAt <= now at listing time. */
+    due: boolean;
+}
+/**
+ * List scheduled event reminders.
+ *
+ * Scans currently-valid (valid_to null), non-quarantined nodes carrying
+ * `metadata.event.status === "scheduled"`. Deterministic ordering:
+ * reminder_at ascending, then createdAt ascending, then id ascending.
+ *
+ * v1 note: this is a full local scan (like the decay/consolidation
+ * passes), not an index lookup — fine for a local-first store, revisit
+ * with a metadata index if reminder volume grows.
+ *
+ * Honest scope: MemOS SURFACES due reminders; it does not push-notify.
+ * Delivery/notification is the harness's job — poll `memos_reminders`
+ * (or `memos reminders --due`) on the harness's own schedule.
+ */
+export declare function listReminders(source: ReminderSource, opts: ListRemindersOptions): Promise<ReminderEntry[]>;
+//# sourceMappingURL=event-memory.d.ts.map

memos/_js/event-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-memory.d.ts","sourceRoot":"","sources":["../src/event-memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAEzE,8BAA8B;AAC9B,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,CAAC;AAElE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,+BAA+B;AAC/B,MAAM,WAAW,aAAc,SAAQ,aAAa;CAAG;AAEvD,uDAAuD;AACvD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,OAAO,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,aAAa,CAAA;KAAE,CAAC;IAC/C;wCACoC;IACpC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;CACjB;AA0DD;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,aAAa,GAAG,IAAI,CA4B5E;AA6BD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,IAAI,GACR,WAAW,GAAG,IAAI,CAuCpB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWpE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAmBP;AAED,8DAA8D;AAC9D,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAW9D;AAED,uEAAuE;AACvE,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,GAAG,EAAE,IAAI,GAAG,MAAM,CAAC;IACnB,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;4EACwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,aAAa,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,aAAa,EAAE,CAAC,CAiC1B"}

memos/_js/event-memory.js

@@ -0,0 +1,290 @@
+/**
+ * Deterministic temporal event memory: extraction, update/cancel
+ * resolution, and reminder listing. No LLM on any path — regex intent
+ * detection plus the deterministic parser in `./temporal.js`, mirroring
+ * the `src/revert.ts` pattern.
+ *
+ * Cross-harness continuity: every harness (any model, any process) shares
+ * the same DB file and runs the same parsing/resolution rules, so an
+ * event stored by model A is updatable by model B. The update path reads
+ * the event's CURRENT row from the store (not from conversation state),
+ * so there is no per-harness state to drift.
+ *
+ * @module @memos/event-memory
+ */
+import { parseTemporal, parseDuration, } from "./temporal.js";
+// Event nouns that make a memory an event when co-occurring with a
+// temporal expression. Kept to concrete, schedulable nouns — notably NOT
+// "birthday" (year-less by nature; see the recurring rule below).
+const EVENT_NOUNS = [
+    "meeting",
+    "call",
+    "appointment",
+    "deadline",
+    "flight",
+    "interview",
+    "dinner",
+    "lunch",
+    "breakfast",
+    "brunch",
+    "coffee",
+    "standup",
+    "review",
+    "doctor",
+    "dentist",
+    "party",
+    "class",
+    "lesson",
+    "exam",
+    "presentation",
+    "demo",
+    "sync",
+    "workshop",
+    "conference",
+    "webinar",
+    "session",
+    "trip",
+    "wedding",
+    "checkup",
+    "reminder",
+    "1:1",
+];
+const EVENT_NOUN_SET = new Set(EVENT_NOUNS);
+// "dentist appointment" / "team meeting" style compounds: the modifier is
+// kept in the label, the head noun is the kind.
+const COMPOUND_RE = new RegExp(String.raw `\b(dentist|doctor|team|standup|project|client)\s+(appointment|meeting|call|review|sync|session)\b`, "i");
+const NOUN_RE = new RegExp(String.raw `\b(${EVENT_NOUNS.map((n) => n.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|")})\b`, "i");
+// Year-less / repeating references never become scheduled reminders.
+const RECURRING_RE = /\b(every|each)\b|\b(daily|weekly|monthly|yearly|annually)\b/i;
+/**
+ * Detect a schedulable event in free text: an event noun co-occurring
+ * with a temporal expression.
+ *
+ * Guard (deterministic): dates without a year ("my birthday is June 1")
+ * or recurring references ("every Monday") yield `status: "recurring"` —
+ * they are stored as structured events but NEVER produce reminders.
+ *
+ * @param content — The memory text.
+ * @param now     — Reference time for temporal parsing.
+ * @returns The detected event, or null when no event noun + temporal
+ *   expression co-occur.
+ */
+export function detectEvent(content, now) {
+    if (!content || typeof content !== "string")
+        return null;
+    const compound = COMPOUND_RE.exec(content);
+    const nounMatch = compound ?? NOUN_RE.exec(content);
+    if (!nounMatch)
+        return null;
+    const parsed = parseTemporal(content, now);
+    if (!parsed)
+        return null;
+    let kind;
+    let label;
+    if (compound) {
+        kind = compound[2].toLowerCase();
+        label = `${compound[1].toLowerCase()} ${kind}`;
+    }
+    else {
+        kind = nounMatch[1].toLowerCase();
+        label = kind;
+    }
+    const recurring = RECURRING_RE.test(content) || !parsed.yearCertain;
+    const at = parsed.at.toISOString();
+    return {
+        kind,
+        label,
+        at,
+        grain: parsed.grain,
+        status: recurring ? "recurring" : "scheduled",
+        reminder_at: at,
+    };
+}
+// Update-intent verbs. Evaluation order: cancel patterns run BEFORE
+// update patterns (a cancellation is terminal — "moved then cancelled"
+// must cancel, never reschedule).
+const CANCEL_PATTERNS = [
+    { name: "cancelled", regex: /\b(cancelled|canceled|cancel)\b/i },
+    { name: "called-off", regex: /\bcalled\s+off\b/i },
+    // "never mind, forget about that meeting" — cancel-scoped "never mind".
+    // (Bare "never mind that" without a cancel verb is NOT a cancel; the
+    // revert module owns that phrasing.)
+    { name: "never-mind-cancel", regex: /\bnever\s+mind\b.{0,40}\bcancel\b/i },
+];
+const UPDATE_PATTERNS = [
+    { name: "rescheduled", regex: /\breschedul(?:ed|e|ing)\b/i },
+    { name: "postponed", regex: /\bpostponed?\b/i },
+    { name: "moved", regex: /\bmoved?\b/i },
+    { name: "pushed", regex: /\bpushed?\s+(?:back|forward|up|to)?\b/i },
+    { name: "changed-to", regex: /\bchanged?\s+to\b/i },
+    // "actually the meeting is at 3pm now" — explicit new time.
+    { name: "actually-at", regex: /\bactually\b.{0,60}\bat\s+\d/i },
+];
+// Target extraction: "that meeting", "the dentist appointment", "my call".
+// "it" alone carries no kind (falls back to the single-open-event rule).
+const KIND_TARGET_RE = /\b(?:that|the|this|my|our|your)\s+([a-z][a-z0-9]*(?:\s+[a-z][a-z0-9]*)?)\b/i;
+/**
+ * Detect an event update/cancellation command in free text.
+ *
+ * Returns null when: no update/cancel intent; intent present but no
+ * resolvable new time (fail safe — the write proceeds as a normal
+ * memory); or the text names no actionable target. An update intent
+ * WITHOUT a new time or duration is not an update — e.g. "we moved the
+ * meeting" (no when) must not touch the stored event.
+ *
+ * @param content — The memory text.
+ * @param now     — Reference time for absolute-ish new times.
+ */
+export function detectEventUpdate(content, now) {
+    if (!content || typeof content !== "string")
+        return null;
+    const kind = extractEventKind(content);
+    for (const pattern of CANCEL_PATTERNS) {
+        if (pattern.regex.test(content)) {
+            const update = { intent: "cancel", pattern: pattern.name };
+            if (kind)
+                update.kind = kind;
+            return update;
+        }
+    }
+    for (const pattern of UPDATE_PATTERNS) {
+        if (pattern.regex.test(content)) {
+            // Bare relative offset anchors to the EVENT's datetime, not now.
+            const duration = parseDuration(content);
+            if (duration) {
+                const update = {
+                    intent: "update",
+                    duration,
+                    pattern: `${pattern.name}+duration`,
+                };
+                if (kind)
+                    update.kind = kind;
+                return update;
+            }
+            // Otherwise parse absolute-ish against now ("moved to Friday").
+            const parsed = parseTemporal(content, now);
+            if (!parsed)
+                return null; // intent but no time → fail safe
+            const update = {
+                intent: "update",
+                newTime: { at: parsed.at.toISOString(), grain: parsed.grain },
+                pattern: pattern.name,
+            };
+            if (kind)
+                update.kind = kind;
+            return update;
+        }
+    }
+    return null;
+}
+/**
+ * Extract the named event kind from an update/cancel utterance.
+ * "that meeting" → "meeting"; "the dentist appointment" → "appointment";
+ * bare "it" → undefined.
+ */
+export function extractEventKind(content) {
+    const m = KIND_TARGET_RE.exec(content);
+    if (!m?.[1])
+        return undefined;
+    const phrase = m[1].toLowerCase().trim();
+    const words = phrase.split(/\s+/);
+    const head = words[words.length - 1];
+    if (EVENT_NOUN_SET.has(head))
+        return head;
+    // Modifier-first phrasing ("that dentist") — accept the modifier when
+    // it is itself an event noun.
+    if (words.length > 1 && EVENT_NOUN_SET.has(words[0]))
+        return words[0];
+    return undefined;
+}
+/**
+ * Split a `memos remind "<text>" at <temporal-expression>` command.
+ * The temporal expression is the text after the LAST " at " whose suffix
+ * parses as a temporal expression (deterministic).
+ *
+ * @returns `{ text, temporal }`, or null when no trailing temporal
+ *   expression is found.
+ */
+export function splitRemindText(input) {
+    if (!input || typeof input !== "string")
+        return null;
+    // Walk " at " occurrences right-to-left; the first (rightmost) suffix
+    // that parses wins.
+    const lower = input.toLowerCase();
+    let idx = lower.lastIndexOf(" at ");
+    while (idx !== -1) {
+        const text = input.slice(0, idx).trim();
+        const temporal = input.slice(idx + 4).trim();
+        if (text.length > 0 && temporal.length > 0) {
+            // Suffix must parse against an arbitrary fixed reference — the
+            // parse here only validates shape, not the resolved datetime.
+            if (parseTemporal(temporal, new Date(2026, 0, 1, 12, 0, 0))) {
+                return { text, temporal };
+            }
+        }
+        idx = lower.lastIndexOf(" at ", idx - 1);
+    }
+    return null;
+}
+/** True when the node is a currently-open scheduled event. */
+export function isScheduledEventNode(node) {
+    const event = node.metadata
+        ?.event;
+    return (node.validTo === null &&
+        node.quarantined === false &&
+        typeof event === "object" &&
+        event !== null &&
+        event.status === "scheduled" &&
+        typeof event.reminder_at === "string");
+}
+/**
+ * List scheduled event reminders.
+ *
+ * Scans currently-valid (valid_to null), non-quarantined nodes carrying
+ * `metadata.event.status === "scheduled"`. Deterministic ordering:
+ * reminder_at ascending, then createdAt ascending, then id ascending.
+ *
+ * v1 note: this is a full local scan (like the decay/consolidation
+ * passes), not an index lookup — fine for a local-first store, revisit
+ * with a metadata index if reminder volume grows.
+ *
+ * Honest scope: MemOS SURFACES due reminders; it does not push-notify.
+ * Delivery/notification is the harness's job — poll `memos_reminders`
+ * (or `memos reminders --due`) on the harness's own schedule.
+ */
+export async function listReminders(source, opts) {
+    const nowMs = opts.now instanceof Date ? opts.now.getTime() : opts.now;
+    const filter = { limit: opts.limit ?? 10_000 };
+    if (opts.namespace !== undefined)
+        filter.namespace = opts.namespace;
+    const rows = await source.search(filter);
+    const entries = [];
+    for (const { node } of rows) {
+        if (!isScheduledEventNode(node))
+            continue;
+        const event = node.metadata.event;
+        const reminderMs = new Date(event.reminder_at).getTime();
+        if (Number.isNaN(reminderMs))
+            continue;
+        const due = reminderMs <= nowMs;
+        if (opts.dueOnly && !due)
+            continue;
+        entries.push({
+            id: node.id,
+            kind: event.kind,
+            label: event.label,
+            at: event.at,
+            grain: event.grain,
+            reminderAt: event.reminder_at,
+            content: node.content,
+            createdAt: node.createdAt,
+            due,
+        });
+    }
+    // Deterministic order: reminder time, then creation time, then id.
+    entries.sort((a, b) => new Date(a.reminderAt).getTime() - new Date(b.reminderAt).getTime() ||
+        a.createdAt - b.createdAt ||
+        (a.id < b.id ? -1 : a.id > b.id ? 1 : 0));
+    return entries;
+}
+//# sourceMappingURL=event-memory.js.map

memos/_js/event-memory.js.map

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

memos/_js/external-import.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Parser for third-party AI memory exports — ChatGPT data exports and
+ * Claude data exports — feeding `MemOS.importExternal`.
+ *
+ * The design goal is tolerance: vendor export shapes change without
+ * notice, so the parser sniffs each item rather than trusting a fixed
+ * schema, extracts whatever text fields exist, and reports what it
+ * skipped. Recognized shapes:
+ *
+ * - ChatGPT data export (`conversations.json`): an array of
+ *   `{ title, mapping: { <id>: { message: { author: { role }, content:
+ *   { parts: string[] } } } } }` trees — user turns are extracted.
+ * - Claude data export (`conversations.json`): an array of
+ *   `{ name, chat_messages: [{ sender: "human", text, created_at }] }` —
+ *   human turns are extracted. A directory export is scanned for every
+ *   `*.json` / `*.jsonl` file and each candidate is sniffed.
+ * - Slack export (directory): `channels.json` + `users.json` plus one
+ *   folder per channel with per-day message files
+ *   (`{ user, text, ts }`) — all messages are extracted with author and
+ *   channel attribution.
+ * - Flat memory lists: an array of strings or of objects with
+ *   `content` / `text` / `title` / `memory` string fields (covers
+ *   `memories.json`-style exports from both vendors).
+ * - Wrapper objects: `{ conversations: [...] }` or `{ memories: [...] }`.
+ *
+ * Dedupe is by SHA-256 of the normalized content (whitespace-collapsed,
+ * lowercased), so the same message appearing in several files — or twice
+ * in one export — is imported once.
+ *
+ * @module @mem-os/external-import
+ */
+export type ExternalImportSource = "auto" | "chatgpt" | "claude" | "slack" | "generic";
+export type DetectedExportSource = "chatgpt" | "claude" | "slack" | "generic";
+export interface ExternalMemoryItem {
+    content: string;
+    /** Creation timestamp in Unix ms, when the export carried one. */
+    createdAt?: number;
+    /** Human-readable author name, when the export carried one. */
+    author?: string;
+    /** Channel / conversation label, when the export carried one. */
+    channel?: string;
+    /** Conversation title, when the export carried one. */
+    conversation?: string;
+}
+export interface ParsedExternalExport {
+    items: ExternalMemoryItem[];
+    detected: DetectedExportSource;
+    /** Items recognized structurally but yielding no usable text. */
+    skipped: number;
+}
+/**
+ * Parse a parsed-JSON export payload into memory items.
+ *
+ * @param raw — The decoded JSON value (or a JSON string).
+ * @param source — `"auto"` sniffs the shape; explicit values force a
+ *   parser (useful when auto-detection misreads a custom format).
+ */
+export declare function parseExternalMemoryExport(raw: unknown, source?: ExternalImportSource, maxItems?: number): ParsedExternalExport;
+/**
+ * SHA-256 of the normalized content (whitespace-collapsed, lowercased).
+ * The dedupe key for imports.
+ */
+export declare function contentHash(content: string): string;
+/**
+ * Scan an export directory for a vendor source and parse everything
+ * found, with content-hash dedupe across files.
+ *
+ * - `slack`: reads the official Slack export layout (`channels.json`,
+ *   `users.json`, per-channel per-day message files).
+ * - `chatgpt` / `claude`: walks the directory for `*.json` files
+ *   (each sniffed as a conversation export) and `*.jsonl` files
+ *   (each line sniffed as a message).
+ */
+export declare function parseExportDirectory(dir: string, source: "chatgpt" | "claude" | "slack", maxItems?: number): Promise<ParsedExternalExport>;
+/**
+ * Parse an official Slack export directory:
+ * `channels.json` + `users.json` at the root, one folder per channel
+ * with per-day message files (`[{ user, text, ts }]`).
+ */
+export declare function parseSlackExportDirectory(dir: string, maxItems?: number): Promise<ParsedExternalExport>;
+/** Structured insight extracted from imported text. */
+export type SynthesizedKind = "decision" | "preference" | "milestone";
+export interface SynthesizedInsight {
+    kind: SynthesizedKind;
+    /** The source sentence, trimmed (max 400 chars). */
+    text: string;
+}
+/**
+ * Rule-based post-import pass: pull structured decisions, preferences,
+ * and milestones out of imported messages. Each match is the source
+ * *sentence* (not the whole message), classified by the first matching
+ * rule (decision > preference > milestone). No LLM — pure regex over
+ * sentence-split text.
+ */
+export declare function synthesizeImportInsights(items: ReadonlyArray<{
+    content: string;
+}>): SynthesizedInsight[];
+//# sourceMappingURL=external-import.d.ts.map

memos/_js/external-import.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external-import.d.ts","sourceRoot":"","sources":["../src/external-import.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,MAAM,MAAM,oBAAoB,GAC9B,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AACtD,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;AAE9E,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;CACjB;AAgID;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,OAAO,EACZ,MAAM,GAAE,oBAA6B,EACrC,QAAQ,SAAoB,GAC3B,oBAAoB,CAwFtB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGnD;AAQD;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,EACtC,QAAQ,SAAoB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CA4F/B;AAkED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,MAAM,EACX,QAAQ,SAAoB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CAmI/B;AA6BD,uDAAuD;AACvD,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,YAAY,GAAG,WAAW,CAAC;AAEtE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,eAAe,CAAC;IACtB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;CACd;AAwDD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,aAAa,CAAC;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GACxC,kBAAkB,EAAE,CAgBtB"}