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

memos/_js/importance.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Effective importance model for MemOS memory nodes.
+ *
+ * The stored `importance` field is the *base* score assigned at write time
+ * (or manually via `update`). It never changes on its own. This module
+ * derives an *effective* importance at read time by combining:
+ *
+ *   1. Recency decay — memories not accessed recently slide toward a
+ *      configurable floor (never below `decayFloor` × the boosted base,
+ *      so a memory can't vanish by aging alone). The age is measured
+ *      from the first available of `lastAccessed` → `createdAt` →
+ *      `updatedAt`, so imported rows that never recorded an access are
+ *      not mistaken for ancient ones.
+ *   2. Access reinforcement — each retrieval adds a small, logarithmic
+ *      boost (capped), so frequently-used memories outrank equally-aged
+ *      ones that are never touched. The boost itself also decays, so a
+ *      memory does not stay permanently fresh on reinforcement alone.
+ *
+ * The model is pure computation over node fields — it performs no writes.
+ * This deliberately keeps it compatible with the access-count debounce:
+ * effective importance is recomputed whenever eviction, archival, or
+ * ranking needs it, instead of being materialised back into the row.
+ *
+ * @module @memos/importance
+ */
+import type { MemoryNode } from "./types.js";
+/** Tuning knobs for the effective importance model. */
+export interface ImportanceConfig {
+    /**
+     * Half-life (in days) of the recency decay applied to the base
+     * importance. `0` disables decay. Default 30.
+     */
+    halfLifeDays?: number;
+    /**
+     * Floor for the decay factor — the multiplicative decay never drops
+     * the base importance below `decayFloor` × base. Default 0.5.
+     */
+    decayFloor?: number;
+    /**
+     * Reinforcement gained per `log2(1 + accessCount)` unit. Default 0.1.
+     */
+    accessGain?: number;
+    /**
+     * Upper bound on the total access boost. Default 0.3.
+     */
+    accessCap?: number;
+    /**
+     * Weight of EFFECTIVE importance in hybrid-search ranking (see
+     * {@link importanceRankFactor}). `0` keeps ranking on raw relevance
+     * and leaves the effective model to eviction/archival decisions only.
+     *
+     * Only consulted when the `importance` block itself is configured:
+     * an unset `importance` keeps ranking byte-identical to the
+     * pre-wiring pipeline. Default 0.25.
+     */
+    rankingWeight?: number;
+}
+/**
+ * Default weight of effective importance in hybrid-search ranking.
+ *
+ * 0.25 maps effective importance 0.5 (neutral) to a ×1.0 multiplier and
+ * the full [0,1] range to [0.75, 1.25] — strong enough to reorder
+ * near-tied candidates, never enough to beat a genuine relevance gap.
+ */
+export declare const DEFAULT_IMPORTANCE_RANK_WEIGHT = 0.25;
+/** Resolved defaults for {@link ImportanceConfig}. */
+export declare const DEFAULT_IMPORTANCE_CONFIG: Required<ImportanceConfig>;
+/**
+ * Compute the effective importance of a node at a point in time.
+ *
+ * Formula:
+ *   decay       = decayFloor + (1 - decayFloor) · e^(−ageDays / halfLifeDays)
+ *   accessBoost = min(accessCap, accessGain · log2(1 + accessCount))
+ *   effective   = clamp01((importance + accessBoost) · decay)
+ *
+ * `ageDays` is measured from the {@link recencyAnchor} chain
+ * (`lastAccessed` → `createdAt` → `updatedAt` → `now`), so a row whose
+ * `lastAccessed` was never set — imported, migrated, or externally
+ * supplied — decays from its write time instead of from the epoch.
+ *
+ * The decay multiplies the *boosted* total, so access reinforcement is
+ * no longer immune to aging: a heavily-read memory still outranks an
+ * equally-scored untouched one, but both slide toward the floor together.
+ *
+ * @param node — The memory node.
+ * @param now  — Current time (Unix ms).
+ * @param cfg  — Optional tuning overrides.
+ * @returns Effective importance in [0, 1].
+ */
+export declare function computeEffectiveImportance(node: Pick<MemoryNode, "importance" | "accessCount" | "lastAccessed" | "createdAt" | "updatedAt">, now: number, cfg?: ImportanceConfig): number;
+/**
+ * Recency score for ranking boosts — pure exponential decay from the
+ * last access, in [0, 1] (1 = touched right now).
+ *
+ * The age anchor follows the same {@link recencyAnchor} fallback chain as
+ * {@link computeEffectiveImportance}, so a row that never recorded an
+ * access scores as fresh rather than as a zero.
+ *
+ * @param node — The memory node.
+ * @param now  — Current time (Unix ms).
+ * @param halfLifeDays — Days for the score to halve. `0` returns 1 (disabled).
+ * @returns Recency score in [0, 1].
+ */
+export declare function recencyScore(node: Pick<MemoryNode, "lastAccessed" | "createdAt" | "updatedAt">, now: number, halfLifeDays?: number): number;
+/**
+ * Multiplicative ranking factor derived from an effective-importance
+ * value.
+ *
+ * Maps `effective = 0.5` (neutral) to `1.0`, the full [0,1] range to
+ * `[1 - w, 1 + w]`, and clamps `weight` to [0,1]. Used by
+ * `hybridSearch`'s post-fusion chain so effective importance nudges the
+ * ranking without ever dominating pure relevance.
+ *
+ * @param effective — Output of {@link computeEffectiveImportance}.
+ * @param weight — `ImportanceConfig.rankingWeight` (default 0.25).
+ */
+export declare function importanceRankFactor(effective: number, weight?: number): number;
+//# sourceMappingURL=importance.d.ts.map

memos/_js/importance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importance.d.ts","sourceRoot":"","sources":["../src/importance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,uDAAuD;AACvD,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,8BAA8B,OAAO,CAAC;AAEnD,sDAAsD;AACtD,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,gBAAgB,CAMhE,CAAC;AAyCF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,IAAI,CACR,UAAU,EACV,YAAY,GAAG,aAAa,GAAG,cAAc,GAAG,WAAW,GAAG,WAAW,CAC1E,EACD,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,gBAAqB,GACzB,MAAM,CAiBR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,cAAc,GAAG,WAAW,GAAG,WAAW,CAAC,EAClE,GAAG,EAAE,MAAM,EACX,YAAY,SAAK,GAChB,MAAM,CAKR;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,MAAuC,GAC9C,MAAM,CAGR"}

memos/_js/importance.js

@@ -0,0 +1,144 @@
+/**
+ * Effective importance model for MemOS memory nodes.
+ *
+ * The stored `importance` field is the *base* score assigned at write time
+ * (or manually via `update`). It never changes on its own. This module
+ * derives an *effective* importance at read time by combining:
+ *
+ *   1. Recency decay — memories not accessed recently slide toward a
+ *      configurable floor (never below `decayFloor` × the boosted base,
+ *      so a memory can't vanish by aging alone). The age is measured
+ *      from the first available of `lastAccessed` → `createdAt` →
+ *      `updatedAt`, so imported rows that never recorded an access are
+ *      not mistaken for ancient ones.
+ *   2. Access reinforcement — each retrieval adds a small, logarithmic
+ *      boost (capped), so frequently-used memories outrank equally-aged
+ *      ones that are never touched. The boost itself also decays, so a
+ *      memory does not stay permanently fresh on reinforcement alone.
+ *
+ * The model is pure computation over node fields — it performs no writes.
+ * This deliberately keeps it compatible with the access-count debounce:
+ * effective importance is recomputed whenever eviction, archival, or
+ * ranking needs it, instead of being materialised back into the row.
+ *
+ * @module @memos/importance
+ */
+/**
+ * Default weight of effective importance in hybrid-search ranking.
+ *
+ * 0.25 maps effective importance 0.5 (neutral) to a ×1.0 multiplier and
+ * the full [0,1] range to [0.75, 1.25] — strong enough to reorder
+ * near-tied candidates, never enough to beat a genuine relevance gap.
+ */
+export const DEFAULT_IMPORTANCE_RANK_WEIGHT = 0.25;
+/** Resolved defaults for {@link ImportanceConfig}. */
+export const DEFAULT_IMPORTANCE_CONFIG = {
+    halfLifeDays: 30,
+    decayFloor: 0.5,
+    accessGain: 0.1,
+    accessCap: 0.3,
+    rankingWeight: DEFAULT_IMPORTANCE_RANK_WEIGHT,
+};
+const MS_PER_DAY = 86_400_000;
+function clamp01(value) {
+    return Math.min(1, Math.max(0, value));
+}
+/**
+ * Resolve the timestamp that recency decay is measured from.
+ *
+ * `lastAccessed` is optional on imported, migrated, and externally-supplied
+ * rows (`UpdateMemoryInput.lastAccessed?`, `src/types.ts:339`), and such rows
+ * commonly arrive with it unset or 0. Anchoring decay on it then makes
+ * `ageDays` explode to decades and halves every such memory. The anchor
+ * therefore falls back through the write-time fields:
+ *
+ *   1. `lastAccessed` — set by the normal write/read paths.
+ *   2. `createdAt`    — when MemOS learned the fact.
+ *   3. `updatedAt`    — last content modification.
+ *   4. `now`          — nothing usable on the row: treat it as brand new
+ *                       rather than as ancient.
+ *
+ * Non-finite and non-positive values are skipped at every step.
+ */
+function recencyAnchor(node, now) {
+    for (const candidate of [node.lastAccessed, node.createdAt, node.updatedAt]) {
+        if (typeof candidate === "number" &&
+            Number.isFinite(candidate) &&
+            candidate > 0) {
+            return candidate;
+        }
+    }
+    return now;
+}
+/**
+ * Compute the effective importance of a node at a point in time.
+ *
+ * Formula:
+ *   decay       = decayFloor + (1 - decayFloor) · e^(−ageDays / halfLifeDays)
+ *   accessBoost = min(accessCap, accessGain · log2(1 + accessCount))
+ *   effective   = clamp01((importance + accessBoost) · decay)
+ *
+ * `ageDays` is measured from the {@link recencyAnchor} chain
+ * (`lastAccessed` → `createdAt` → `updatedAt` → `now`), so a row whose
+ * `lastAccessed` was never set — imported, migrated, or externally
+ * supplied — decays from its write time instead of from the epoch.
+ *
+ * The decay multiplies the *boosted* total, so access reinforcement is
+ * no longer immune to aging: a heavily-read memory still outranks an
+ * equally-scored untouched one, but both slide toward the floor together.
+ *
+ * @param node — The memory node.
+ * @param now  — Current time (Unix ms).
+ * @param cfg  — Optional tuning overrides.
+ * @returns Effective importance in [0, 1].
+ */
+export function computeEffectiveImportance(node, now, cfg = {}) {
+    const { halfLifeDays, decayFloor, accessGain, accessCap } = {
+        ...DEFAULT_IMPORTANCE_CONFIG,
+        ...cfg,
+    };
+    const anchor = recencyAnchor(node, now);
+    const ageDays = Math.max(0, (now - anchor) / MS_PER_DAY);
+    const decay = halfLifeDays <= 0
+        ? 1
+        : decayFloor + (1 - decayFloor) * Math.exp(-ageDays / halfLifeDays);
+    const accessBoost = Math.min(accessCap, accessGain * Math.log2(1 + node.accessCount));
+    return clamp01((node.importance + accessBoost) * decay);
+}
+/**
+ * Recency score for ranking boosts — pure exponential decay from the
+ * last access, in [0, 1] (1 = touched right now).
+ *
+ * The age anchor follows the same {@link recencyAnchor} fallback chain as
+ * {@link computeEffectiveImportance}, so a row that never recorded an
+ * access scores as fresh rather than as a zero.
+ *
+ * @param node — The memory node.
+ * @param now  — Current time (Unix ms).
+ * @param halfLifeDays — Days for the score to halve. `0` returns 1 (disabled).
+ * @returns Recency score in [0, 1].
+ */
+export function recencyScore(node, now, halfLifeDays = 14) {
+    if (halfLifeDays <= 0)
+        return 1;
+    const anchor = recencyAnchor(node, now);
+    const ageDays = Math.max(0, (now - anchor) / MS_PER_DAY);
+    return Math.exp(-ageDays / halfLifeDays);
+}
+/**
+ * Multiplicative ranking factor derived from an effective-importance
+ * value.
+ *
+ * Maps `effective = 0.5` (neutral) to `1.0`, the full [0,1] range to
+ * `[1 - w, 1 + w]`, and clamps `weight` to [0,1]. Used by
+ * `hybridSearch`'s post-fusion chain so effective importance nudges the
+ * ranking without ever dominating pure relevance.
+ *
+ * @param effective — Output of {@link computeEffectiveImportance}.
+ * @param weight — `ImportanceConfig.rankingWeight` (default 0.25).
+ */
+export function importanceRankFactor(effective, weight = DEFAULT_IMPORTANCE_RANK_WEIGHT) {
+    const w = Math.min(1, Math.max(0, weight));
+    return 1 - w + 2 * w * clamp01(effective);
+}
+//# sourceMappingURL=importance.js.map

memos/_js/importance.js.map

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

memos/_js/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * MemOS — Universal memory layer for AI agents, LLM apps, and chatbots.
+ *
+ * This is the package entry point. Import `MemOS` to get started:
+ *
+ * ```ts
+ * import { MemOS } from "@mem-os/sdk";
+ *
+ * const memos = new MemOS();
+ * await memos.init();
+ *
+ * await memos.store("User likes dark mode", { type: "preference" });
+ * const results = await memos.search("dark mode");
+ * ```
+ *
+ * @packageDocumentation
+ * @module @mem-os/sdk
+ */
+export { MemOS, MemorySkippedError } from "./memory.js";
+export { decideRetain, shouldRetain, scoreRetain, setRetainClassifier, type RetainInput, type RetainDecision, } from "./retain-filter.js";
+export { getMcpTools, runMcpServer } from "./mcp.js";
+export { detectRevertIntent, normalizeRevertTarget, parseRevertCliArgs, type RevertIntent, type RevertScopeKind, type RevertScopeInput, type ParsedRevertArgs, } from "./revert.js";
+export { parseTemporal, parseDuration, addDuration, type ParsedTemporal, type TemporalDuration, type TemporalGrain, } from "./temporal.js";
+export { detectEvent, detectEventUpdate, extractEventKind, splitRemindText, isScheduledEventNode, listReminders, type DetectedEvent, type EventMetadata, type EventStatus, type EventUpdate, type ReminderEntry, type ListRemindersOptions, type ReminderSource, } from "./event-memory.js";
+export { GraphEngine, textSimilarity, generateId } from "./graph.js";
+export { FIDELITY_LEVELS, FIDELITY_LEVEL_LABELS, FIDELITY_LEVEL_DESCRIPTIONS, hasFidelityCache, stampFidelityCache, levelText, fidelityL0, fidelityL1, fidelityL2, splitSentences, nodeEntities, rankSentencesByCentrality, nextFidelityLevel, clampFidelityLevel, parseFidelityLevel, routeFidelity, routerEntities, scoreLevelCorpus, resolveRecallLevels, fidelityStats, isInformationDense, queryDecisiveTokens, textHasDecisiveToken, fidelityLevelSufficient, shouldCompressFidelityItem, DEFAULT_MIN_FIDELITY_LEVEL, type FidelityLevel, type FidelitySignals, type FidelityRoute, type FidelityRecallOptions, type FidelityRecallResult, type CompactOptions, type CompactResult, type FidelityLevelStats, } from "./fidelity.js";
+export { LocalHashEmbeddingProvider, OllamaEmbeddingProvider, OpenAICompatibleEmbeddingProvider, VoyageAIEmbeddingProvider, CohereEmbeddingProvider, FastEmbedEmbeddingProvider, cosineSimilarity, createEmbeddingProvider, normalizeVector, } from "./embeddings.js";
+export { SQLiteStorage } from "./storage/sqlite.js";
+export type { SemanticScanMode, SemanticScanStats } from "./storage/sqlite.js";
+export { ClipEmbeddingProvider, ClipUnavailableError, DEFAULT_CLIP_MODEL, DEFAULT_CLIP_DIMENSIONS, FakeClipProvider, ClipQueryCache, DEFAULT_CLIP_QUERY_CACHE_MAX, } from "./vision/index.js";
+export type { ClipEmbeddingProviderOptions } from "./vision/clip.js";
+export type { FakeClipProviderOptions } from "./vision/fake-clip.js";
+export { blobRoot, deleteRef, ImageRejectedError, kindFromMime, normalizeImageInput, purgeOrphanImages, readDimensions, readImage, refFor, resolveRef, sniffMime, writeImage, type StoredImage, } from "./vision/store.js";
+export { imageAttachmentOf } from "./context-pack.js";
+export { EmbeddingQueue, type EmbeddingJob, type EmbeddingJobStatus, type EmbeddingQueueConfig, type PersistEmbeddingFn, type EmbeddingStatusChangeFn, } from "./embedding-queue.js";
+export { buildContextPack, CONTEXT_PACK_SCHEMA, packToToon, packToToonCompact, searchResultsToToon, searchResultsToToonCompact, serializeContextPack, parseToonCompact, encodeCompactId, decodeCompactId, type ContextPack, type ContextPackItem, type BuildContextPackOptions, type ContextPackFidelityMeta, } from "./context-pack.js";
+export type { MemoryNode, MemoryEdge, MemoryType, MemorySource, ProvenanceTier, EdgeRelation, CreateMemoryInput, UpdateMemoryInput, CreateEdgeInput, SearchFilter, SemanticSearchOptions, ScoredMemory, GraphSnapshot, StorageAdapter, MemOSConfig, MemOSEvent, MemOSEventListener, ExportFormat, ExportOptions, ExportResult, ImportFormat, ImportOptions, ImportResult, HarnessCount, HarnessMergeNode, HarnessMergeOptions, HarnessMergeResult, ExperimentalConfig, EmbeddingProvider, EmbeddingVector, EmbeddingRuntimeInfo, EmbeddingRecordInfo, EmbeddingNodeStatus, EmbeddingNodeStatusInfo, EmbeddingQueueStatus, EmbeddingProviderKind, DedupeOptions, DedupeMerge, DedupeResult, ArchiveOptions, ArchiveMove, ArchiveResult, ConsolidateOptions, ConsolidateResult, ConversationMessage, ExtractedFact, ExtractFactsOptions, ExtractFactsResult, DiagnosticsResult, LessonOutcome, NewProceduralLesson, ProceduralLesson, RevertOptions, RevertResult, RevertTargetResolution, ImageKind, ImageSource, ImageAttachment, ImageMemoryMeta, ImageInput, AddImageMemoryOptions, AddImageMemoryResult, SearchImagesOptions, ListImagesOptions, ImageSearchResult, EmbedImageProvider, ClipStatus, ClipMeta, VisionConfig, } from "./types.js";
+export { DEFAULT_TRUST_SCORES } from "./types.js";
+export { applyEvidence, classifyEvidence, confidenceWeight, INITIAL_CONFIDENCE, CONFIDENCE_FLOOR, CONFIDENCE_CAP, } from "./confidence-machine.js";
+export type { EvidenceOutcome, ConfidenceUpdate, } from "./confidence-machine.js";
+export { fuseResults, DEFAULT_RRF_K, DEFAULT_KEYWORD_WEIGHT, DEFAULT_SEMANTIC_WEIGHT, DEFAULT_TRUST_FLOOR, DEFAULT_ENTITY_LEG_WEIGHT, } from "./retrieval.js";
+export type { FusionOptions } from "./retrieval.js";
+export { personalizedPageRank, type PersonalizedPageRankOptions, DEFAULT_PPR_DAMPING, DEFAULT_PPR_MAX_HOPS, DEFAULT_PPR_MAX_FANOUT, DEFAULT_PPR_MAX_NODES, DEFAULT_PPR_MAX_ITERATIONS, DEFAULT_PPR_TOLERANCE, DEFAULT_GRAPH_EXPANSION_ALPHA, DEFAULT_GRAPH_EXPANSION_SEEDS, DEFAULT_GRAPH_EXPANSION_HOPS, DEFAULT_PPR_MAX_INJECTED, DEFAULT_PPR_MIN_INJECT_SCORE, } from "./graph-expansion.js";
+export { applyLessonOutcome, clampLessonScore, effectiveLessonScore, lessonCitationToken, lessonShortId, rankProceduralLessons, DEFAULT_LESSON_PACK_K, LESSON_DECAY_HALF_LIFE_DAYS, LESSON_FAILURE_STEP, LESSON_INITIAL_SCORE, LESSON_RELEVANCE_WEIGHT, LESSON_SCORE_CAP, LESSON_SCORE_FLOOR, LESSON_SCORE_WEIGHT, LESSON_SUCCESS_STEP, type RankedProceduralLesson, } from "./procedural.js";
+export { assignCitationTokens, citationToken, citationTokenForHex, formatCitationResolution, parseCitationToken, shortCitationId, CITATION_MAX_HEX, CITATION_MIN_HEX, type CitationResolution, } from "./citations.js";
+export { detectHarness, normalizeHarness, UNKNOWN_HARNESS, MEMOS_HARNESS_ENV, HARNESS_MARKERS, } from "./harness.js";
+export { contentHash, parseExportDirectory, parseExternalMemoryExport, parseSlackExportDirectory, synthesizeImportInsights, type DetectedExportSource, type ExternalImportSource, type ExternalMemoryItem, type ParsedExternalExport, type SynthesizedInsight, type SynthesizedKind, } from "./external-import.js";
+export { PROVENANCE_TIER_ORDER, LOW_TRUST_TIERS, PROVENANCE_TRUST, DEFAULT_PROVENANCE_WEIGHT_STRENGTH, QUARANTINE_RELEASED_METADATA_KEY, isProvenanceTier, defaultProvenanceForSource, resolveProvenance, compareProvenanceTier, isUntrustedForAgent, quarantineVisible, provenanceMultiplier, decorateTrustFlags, } from "./provenance.js";
+export { screenWrite, QUARANTINE_FLAG_THRESHOLD, type QuarantineSignal, type QuarantineVerdict, } from "./quarantine.js";
+export { EXPLORER_APP_URI, EXPLORER_URI_TEMPLATE, EXPLORER_NODE_CAP, EXPLORER_EDGE_CAP, EXPLORER_PROTOCOL, PROVENANCE_TIER_COLORS, EDGE_RELATION_COLORS, SUPPORTED_INTENTS, buildExplorerSnapshot, filterSnapshotAsOf, isNodeValidAt, isEdgeValidAt, resolveExplorerMode, probeHostAppsSupport, intentToToolCall, buildExplorerHtml, buildExplorerFallbackMarkdown, ExplorerUriTemplate, type ExplorerIntentName, type ExplorerMode, type ExplorerNode, type ExplorerEdge, type ExplorerSnapshot, type IntentToolCall, type IntentTranslation, } from "./apps/explorer.js";
+//# sourceMappingURL=index.d.ts.map

memos/_js/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,mBAAmB,EACnB,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,aAAa,EACb,aAAa,EACb,WAAW,EACX,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,oBAAoB,EACpB,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,oBAAoB,EACzB,KAAK,cAAc,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAGL,eAAe,EACf,qBAAqB,EACrB,2BAA2B,EAC3B,gBAAgB,EAChB,kBAAkB,EAClB,SAAS,EACT,UAAU,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,YAAY,EACZ,yBAAyB,EACzB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,0BAA0B,EAC1B,0BAA0B,EAC1B,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,iCAAiC,EACjC,yBAAyB,EACzB,uBAAuB,EACvB,0BAA0B,EAC1B,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,gBAAgB,EAChB,cAAc,EACd,4BAA4B,GAC7B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AACrE,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAIrE,OAAO,EACL,QAAQ,EACR,SAAS,EACT,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,iBAAiB,EACjB,cAAc,EACd,SAAS,EACT,MAAM,EACN,UAAU,EACV,SAAS,EACT,UAAU,EACV,KAAK,WAAW,GACjB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EACL,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,GAC7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,0BAA0B,EAC1B,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,GAC7B,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,qBAAqB,EACrB,aAAa,EACb,WAAW,EACX,YAAY,EACZ,cAAc,EACd,WAAW,EACX,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,sBAAsB,EAEtB,SAAS,EACT,WAAW,EACX,eAAe,EACf,eAAe,EACf,UAAU,EACV,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,QAAQ,EACR,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,GACf,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,eAAe,EACf,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,WAAW,EACX,aAAa,EACb,sBAAsB,EACtB,uBAAuB,EACvB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EACL,oBAAoB,EACpB,KAAK,2BAA2B,EAChC,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,EAC1B,qBAAqB,EACrB,6BAA6B,EAC7B,6BAA6B,EAC7B,4BAA4B,EAC5B,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,sBAAsB,GAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,wBAAwB,EACxB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,eAAe,GACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,qBAAqB,EACrB,eAAe,EACf,gBAAgB,EAChB,kCAAkC,EAClC,gCAAgC,EAChC,gBAAgB,EAChB,0BAA0B,EAC1B,iBAAiB,EACjB,qBAAqB,EACrB,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,WAAW,EACX,yBAAyB,EACzB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,EACjB,6BAA6B,EAC7B,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,iBAAiB,GACvB,MAAM,oBAAoB,CAAC"}

memos/_js/index.js

@@ -0,0 +1,53 @@
+/**
+ * MemOS — Universal memory layer for AI agents, LLM apps, and chatbots.
+ *
+ * This is the package entry point. Import `MemOS` to get started:
+ *
+ * ```ts
+ * import { MemOS } from "@mem-os/sdk";
+ *
+ * const memos = new MemOS();
+ * await memos.init();
+ *
+ * await memos.store("User likes dark mode", { type: "preference" });
+ * const results = await memos.search("dark mode");
+ * ```
+ *
+ * @packageDocumentation
+ * @module @mem-os/sdk
+ */
+export { MemOS, MemorySkippedError } from "./memory.js";
+export { decideRetain, shouldRetain, scoreRetain, setRetainClassifier, } from "./retain-filter.js";
+export { getMcpTools, runMcpServer } from "./mcp.js";
+export { detectRevertIntent, normalizeRevertTarget, parseRevertCliArgs, } from "./revert.js";
+export { parseTemporal, parseDuration, addDuration, } from "./temporal.js";
+export { detectEvent, detectEventUpdate, extractEventKind, splitRemindText, isScheduledEventNode, listReminders, } from "./event-memory.js";
+export { GraphEngine, textSimilarity, generateId } from "./graph.js";
+export { 
+// Fidelity-level compaction (L0–L3): cheap representations of every
+// memory, a query-adaptive router, and in-call escalation.
+FIDELITY_LEVELS, FIDELITY_LEVEL_LABELS, FIDELITY_LEVEL_DESCRIPTIONS, hasFidelityCache, stampFidelityCache, levelText, fidelityL0, fidelityL1, fidelityL2, splitSentences, nodeEntities, rankSentencesByCentrality, nextFidelityLevel, clampFidelityLevel, parseFidelityLevel, routeFidelity, routerEntities, scoreLevelCorpus, resolveRecallLevels, fidelityStats, isInformationDense, queryDecisiveTokens, textHasDecisiveToken, fidelityLevelSufficient, shouldCompressFidelityItem, DEFAULT_MIN_FIDELITY_LEVEL, } from "./fidelity.js";
+export { LocalHashEmbeddingProvider, OllamaEmbeddingProvider, OpenAICompatibleEmbeddingProvider, VoyageAIEmbeddingProvider, CohereEmbeddingProvider, FastEmbedEmbeddingProvider, cosineSimilarity, createEmbeddingProvider, normalizeVector, } from "./embeddings.js";
+export { SQLiteStorage } from "./storage/sqlite.js";
+export { ClipEmbeddingProvider, ClipUnavailableError, DEFAULT_CLIP_MODEL, DEFAULT_CLIP_DIMENSIONS, FakeClipProvider, ClipQueryCache, DEFAULT_CLIP_QUERY_CACHE_MAX, } from "./vision/index.js";
+// Blob store + input normalization: exported so a host model can
+// resolve an `[img:…]` ref from a context pack without going through
+// a MemOS instance.
+export { blobRoot, deleteRef, ImageRejectedError, kindFromMime, normalizeImageInput, purgeOrphanImages, readDimensions, readImage, refFor, resolveRef, sniffMime, writeImage, } from "./vision/store.js";
+// The node-level image discriminator, shared by the pack builder and
+// the fidelity renderer.
+export { imageAttachmentOf } from "./context-pack.js";
+export { EmbeddingQueue, } from "./embedding-queue.js";
+export { buildContextPack, CONTEXT_PACK_SCHEMA, packToToon, packToToonCompact, searchResultsToToon, searchResultsToToonCompact, serializeContextPack, parseToonCompact, encodeCompactId, decodeCompactId, } from "./context-pack.js";
+export { DEFAULT_TRUST_SCORES } from "./types.js";
+export { applyEvidence, classifyEvidence, confidenceWeight, INITIAL_CONFIDENCE, CONFIDENCE_FLOOR, CONFIDENCE_CAP, } from "./confidence-machine.js";
+export { fuseResults, DEFAULT_RRF_K, DEFAULT_KEYWORD_WEIGHT, DEFAULT_SEMANTIC_WEIGHT, DEFAULT_TRUST_FLOOR, DEFAULT_ENTITY_LEG_WEIGHT, } from "./retrieval.js";
+export { personalizedPageRank, DEFAULT_PPR_DAMPING, DEFAULT_PPR_MAX_HOPS, DEFAULT_PPR_MAX_FANOUT, DEFAULT_PPR_MAX_NODES, DEFAULT_PPR_MAX_ITERATIONS, DEFAULT_PPR_TOLERANCE, DEFAULT_GRAPH_EXPANSION_ALPHA, DEFAULT_GRAPH_EXPANSION_SEEDS, DEFAULT_GRAPH_EXPANSION_HOPS, DEFAULT_PPR_MAX_INJECTED, DEFAULT_PPR_MIN_INJECT_SCORE, } from "./graph-expansion.js";
+export { applyLessonOutcome, clampLessonScore, effectiveLessonScore, lessonCitationToken, lessonShortId, rankProceduralLessons, DEFAULT_LESSON_PACK_K, LESSON_DECAY_HALF_LIFE_DAYS, LESSON_FAILURE_STEP, LESSON_INITIAL_SCORE, LESSON_RELEVANCE_WEIGHT, LESSON_SCORE_CAP, LESSON_SCORE_FLOOR, LESSON_SCORE_WEIGHT, LESSON_SUCCESS_STEP, } from "./procedural.js";
+export { assignCitationTokens, citationToken, citationTokenForHex, formatCitationResolution, parseCitationToken, shortCitationId, CITATION_MAX_HEX, CITATION_MIN_HEX, } from "./citations.js";
+export { detectHarness, normalizeHarness, UNKNOWN_HARNESS, MEMOS_HARNESS_ENV, HARNESS_MARKERS, } from "./harness.js";
+export { contentHash, parseExportDirectory, parseExternalMemoryExport, parseSlackExportDirectory, synthesizeImportInsights, } from "./external-import.js";
+export { PROVENANCE_TIER_ORDER, LOW_TRUST_TIERS, PROVENANCE_TRUST, DEFAULT_PROVENANCE_WEIGHT_STRENGTH, QUARANTINE_RELEASED_METADATA_KEY, isProvenanceTier, defaultProvenanceForSource, resolveProvenance, compareProvenanceTier, isUntrustedForAgent, quarantineVisible, provenanceMultiplier, decorateTrustFlags, } from "./provenance.js";
+export { screenWrite, QUARANTINE_FLAG_THRESHOLD, } from "./quarantine.js";
+export { EXPLORER_APP_URI, EXPLORER_URI_TEMPLATE, EXPLORER_NODE_CAP, EXPLORER_EDGE_CAP, EXPLORER_PROTOCOL, PROVENANCE_TIER_COLORS, EDGE_RELATION_COLORS, SUPPORTED_INTENTS, buildExplorerSnapshot, filterSnapshotAsOf, isNodeValidAt, isEdgeValidAt, resolveExplorerMode, probeHostAppsSupport, intentToToolCall, buildExplorerHtml, buildExplorerFallbackMarkdown, ExplorerUriTemplate, } from "./apps/explorer.js";
+//# sourceMappingURL=index.js.map

memos/_js/index.js.map

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

memos/_js/mcp.d.ts

@@ -0,0 +1,58 @@
+/**
+ * MCP server for MemOS — Model Context Protocol 2026-07-28.
+ *
+ * Built on the official `@modelcontextprotocol/server` v2 SDK, which
+ * implements the 2026-07-28 spec (stateless core, `server/discover`,
+ * per-request `_meta` envelope, `ttlMs`/`cacheScope` on list results,
+ * `outputSchema` on tools). The SDK's `serveStdio` entry is dual-era:
+ * it speaks the modern 2026-07-28 protocol AND falls back to the legacy
+ * 2025-era `initialize` handshake for older clients.
+ *
+ * Transport: stdio only (the shipped transport). HTTP/SSE is deferred.
+ */
+import { McpServer } from "@modelcontextprotocol/server";
+import { MemOS } from "./memory.js";
+import type { MemOSConfig } from "./types.js";
+export interface McpToolAnnotations {
+    readOnlyHint: boolean;
+    destructiveHint: boolean;
+    idempotentHint: boolean;
+    openWorldHint: boolean;
+}
+/**
+ * Per-tool annotations, keyed by tool name. Shared by the live server
+ * registration (the wire path) and the static TOOL_METADATA below so the
+ * two can never disagree.
+ */
+export declare const TOOL_ANNOTATIONS: Record<string, McpToolAnnotations>;
+/**
+ * Create a fully-configured McpServer instance for MemOS.
+ * Exported for testing and advanced use cases.
+ */
+export declare function createMcpServer(memos: MemOS): McpServer;
+/**
+ * Run the MemOS MCP server over stdio.
+ *
+ * Speaks MCP protocol revision 2026-07-28 (modern stateless core with
+ * `server/discover`) and falls back to the legacy 2025-era `initialize`
+ * handshake for older clients. Blocks until the connection closes.
+ */
+export declare function runMcpServer(config?: MemOSConfig): Promise<void>;
+export interface McpToolInfo {
+    name: string;
+    description: string;
+    annotations: McpToolAnnotations;
+    inputSchema: Record<string, unknown>;
+    outputSchema: Record<string, unknown>;
+}
+/**
+ * Return static metadata about the MCP tools exposed by MemOS.
+ * Useful for programmatic consumers and tests that need tool definitions
+ * without spinning up a live server connection.
+ *
+ * Kept in the SAME ORDER as the live `registerTools` registrations —
+ * the annotations test asserts the two surfaces match exactly, so a
+ * reorder here must be mirrored there.
+ */
+export declare function getMcpTools(): readonly McpToolInfo[];
+//# sourceMappingURL=mcp.d.ts.map

memos/_js/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,SAAS,EAAoB,MAAM,8BAA8B,CAAC;AAI3E,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAUpC,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,YAAY,CAAC;AA8G5D,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;CACxB;AAkBD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAuE/D,CAAC;AAq/CF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CA0BvD;AAMD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,MAAM,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqC1E;AAMD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,kBAAkB,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AA+cD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,IAAI,SAAS,WAAW,EAAE,CAEpD"}