memo-grafter 0.2.8 → 0.3.0

package/dist/core/MemoGrafter.d.ts

@@ -0,0 +1,46 @@
+import { Redis } from "ioredis";
+import { MemoGrafterFleet } from "../agents/fleet/MemoGrafterFleet.js";
+import type { MemoGrafterFleetOptions } from "../agents/fleet/types.js";
+import type { GraphStore } from "../store/index.js";
+import type { AbsorbFromAgentOptions, EmbedAdapter, GraftByRelevanceOptions, IngestOptions, IngestTextOptions, InjectionResult, LLMAdapter, MemoryDiff, MemoryHistoryOptions, MemoryHistoryResult, MemoGrafterConfig, Message, TagFilterOptions, TopicNode, TopicSegment } from "./types.js";
+export declare class MemoGrafter {
+    readonly llm: LLMAdapter;
+    readonly embedder: EmbedAdapter;
+    readonly store: GraphStore;
+    readonly recallCache: Redis | null;
+    private readonly ingestPipeline;
+    private readonly grafterPipeline;
+    private readonly ingestQueue;
+    private readonly graphTopK;
+    private readonly graphHopDepth;
+    constructor(config: MemoGrafterConfig);
+    initialize(): Promise<void>;
+    ingest(messages: Message[], sessionId: string, options?: IngestOptions): Promise<TopicNode[]>;
+    ingestNow(messages: Message[], sessionId: string, options?: IngestOptions): Promise<TopicNode[]>;
+    enqueueIngest(messages: Message[], sessionId: string, options?: IngestOptions): Promise<void>;
+    ingestText(text: string, sessionId: string, options?: IngestTextOptions & IngestOptions): Promise<TopicNode[]>;
+    enqueueTextIngest(text: string, sessionId: string, options?: IngestTextOptions & IngestOptions): Promise<void>;
+    getTopics(sessionId: string, options?: TagFilterOptions): Promise<{
+        nodes: TopicNode[];
+        segments: TopicSegment[];
+    }>;
+    inject(sessionId: string, topicIds: string[]): Promise<InjectionResult>;
+    forget(memoryId: string): Promise<boolean>;
+    forgetMany(memoryIds: string[]): Promise<number>;
+    suppressTopic(topicId: string): Promise<boolean>;
+    restoreTopic(topicId: string): Promise<boolean>;
+    getMemoryHistory(memoryId: string, options?: MemoryHistoryOptions): Promise<MemoryHistoryResult>;
+    getMemoryHistory(subject: string, predicate: string, options?: MemoryHistoryOptions): Promise<MemoryHistoryResult>;
+    getMemoryDiff(fromMemoryId: string, toMemoryId: string): Promise<MemoryDiff>;
+    graftByRelevance(sessionId: string, query: string, options?: GraftByRelevanceOptions): Promise<InjectionResult>;
+    ingestGraftedNodes(nodes: TopicNode[], targetSessionId: string): Promise<TopicNode[]>;
+    selectNodesForAbsorb(sourceSessionId: string, options: AbsorbFromAgentOptions): Promise<TopicNode[]>;
+    absorbNodes(nodes: TopicNode[], targetSessionId: string): Promise<TopicNode[]>;
+    createFleet(options?: MemoGrafterFleetOptions): MemoGrafterFleet;
+    close(): Promise<void>;
+    private assertServerEnvironment;
+    private toTextPipelineOptions;
+    private clearRecallCache;
+    private resolveSessionIds;
+}
+//# sourceMappingURL=MemoGrafter.d.ts.map

package/dist/core/MemoGrafter.d.ts.map

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

package/dist/core/MemoGrafter.js

@@ -0,0 +1,236 @@
+import { Redis } from "ioredis";
+import { GrafterPipeline } from "../retrieval/GrafterPipeline.js";
+import { IngestPipeline } from "../ingestion/conversation/IngestPipeline.js";
+import { IngestQueue } from "../ingestion/IngestQueue.js";
+import { PostgresGraphStore } from "../store/index.js";
+import { MemoGrafterFleet } from "../agents/fleet/MemoGrafterFleet.js";
+export class MemoGrafter {
+    llm;
+    embedder;
+    store;
+    recallCache;
+    ingestPipeline;
+    grafterPipeline;
+    ingestQueue;
+    graphTopK;
+    graphHopDepth;
+    constructor(config) {
+        this.assertServerEnvironment();
+        const windowSize = config.drift?.windowSize ?? 5;
+        const mode = config.drift?.mode ?? "intent";
+        const threshold = config.drift?.threshold;
+        const driftSensitivity = config.drift?.driftSensitivity;
+        const minSegmentMessages = config.drift?.minSegmentMessages ?? 3;
+        const llmAmbiguityDetection = config.drift?.llmAmbiguityDetection;
+        const reentryDetection = config.drift?.reentryDetection;
+        const reentryThreshold = config.drift?.reentryThreshold;
+        const adaptiveSensitivity = config.drift?.adaptiveSensitivity;
+        const topK = config.graph?.topK ?? 5;
+        const hopDepth = config.graph?.hopDepth ?? 1;
+        const bufferSize = config.inject?.bufferSize ?? 1;
+        const tokenBudget = config.inject?.tokenBudget ?? 4000;
+        this.llm = config.llm;
+        this.embedder = config.embedder;
+        this.store = new PostgresGraphStore(config.db.connectionString);
+        this.graphTopK = topK;
+        this.graphHopDepth = hopDepth;
+        this.recallCache = config.cache
+            ? new Redis(config.cache.connectionString, {
+                enableOfflineQueue: false,
+                maxRetriesPerRequest: 1,
+            })
+            : null;
+        this.recallCache?.on("error", (error) => {
+            console.warn("MemoGrafter recall cache Redis warning:", error.message);
+        });
+        const ingestConfig = {
+            windowSize,
+            topK,
+            mode,
+            minSegmentMessages,
+        };
+        this.ingestPipeline = new IngestPipeline(this.store, config.llm, config.embedder, {
+            ...ingestConfig,
+            ...(threshold !== undefined ? { threshold } : {}),
+            ...(driftSensitivity !== undefined ? { driftSensitivity } : {}),
+            ...(llmAmbiguityDetection !== undefined ? { llmAmbiguityDetection } : {}),
+            ...(reentryDetection !== undefined ? { reentryDetection } : {}),
+            ...(reentryThreshold !== undefined ? { reentryThreshold } : {}),
+            ...(adaptiveSensitivity !== undefined ? { adaptiveSensitivity } : {}),
+        });
+        this.grafterPipeline = new GrafterPipeline(this.store, {
+            hopDepth,
+            bufferSize,
+            tokenBudget,
+        });
+        this.ingestQueue = config.queue ? new IngestQueue(this.ingestPipeline, config.queue) : null;
+    }
+    initialize() {
+        return this.store.initialize();
+    }
+    ingest(messages, sessionId, options = {}) {
+        if (this.ingestQueue) {
+            return this.enqueueIngest(messages, sessionId, options).then(() => []);
+        }
+        return this.ingestPipeline.run(messages, sessionId, options);
+    }
+    ingestNow(messages, sessionId, options = {}) {
+        return this.ingestPipeline.run(messages, sessionId, options);
+    }
+    async enqueueIngest(messages, sessionId, options = {}) {
+        if (this.ingestQueue) {
+            await this.ingestQueue.enqueue(messages, sessionId, options);
+            return;
+        }
+        await this.ingestPipeline.run(messages, sessionId, options);
+    }
+    ingestText(text, sessionId, options = {}) {
+        const pipelineOptions = this.toTextPipelineOptions(options);
+        if (this.ingestQueue) {
+            return this.enqueueTextIngest(text, sessionId, options).then(() => []);
+        }
+        return this.ingestPipeline.runText(text, sessionId, pipelineOptions);
+    }
+    async enqueueTextIngest(text, sessionId, options = {}) {
+        const pipelineOptions = this.toTextPipelineOptions(options);
+        if (this.ingestQueue) {
+            await this.ingestQueue.enqueueText(text, sessionId, pipelineOptions);
+            return;
+        }
+        await this.ingestPipeline.runText(text, sessionId, pipelineOptions);
+    }
+    async getTopics(sessionId, options = {}) {
+        const nodes = await this.store.getNodesBySession(sessionId, options);
+        const segments = await this.store.getSegmentsBySession(sessionId);
+        return { nodes, segments };
+    }
+    inject(sessionId, topicIds) {
+        return this.grafterPipeline.run(sessionId, topicIds);
+    }
+    async forget(memoryId) {
+        const changed = await this.store.forgetMemory(memoryId);
+        if (changed)
+            await this.clearRecallCache();
+        return changed;
+    }
+    async forgetMany(memoryIds) {
+        const changed = await this.store.forgetMemories(memoryIds);
+        if (changed > 0)
+            await this.clearRecallCache();
+        return changed;
+    }
+    async suppressTopic(topicId) {
+        const changed = await this.store.suppressTopic(topicId);
+        if (changed)
+            await this.clearRecallCache();
+        return changed;
+    }
+    async restoreTopic(topicId) {
+        const changed = await this.store.restoreTopic(topicId);
+        if (changed)
+            await this.clearRecallCache();
+        return changed;
+    }
+    getMemoryHistory(memoryIdOrSubject, predicateOrOptions, options = {}) {
+        if (typeof predicateOrOptions === "string") {
+            return this.store.getMemoryHistoryByFact(memoryIdOrSubject, predicateOrOptions, options);
+        }
+        return this.store.getMemoryHistoryById(memoryIdOrSubject, predicateOrOptions ?? {});
+    }
+    getMemoryDiff(fromMemoryId, toMemoryId) {
+        return this.store.getMemoryDiff(fromMemoryId, toMemoryId);
+    }
+    async graftByRelevance(sessionId, query, options = {}) {
+        const embedding = await this.embedder.embed(query);
+        const configuredSessionIds = options.sessionIds?.filter(Boolean) ?? [];
+        const sessionIds = this.resolveSessionIds(sessionId, configuredSessionIds);
+        const useConfiguredSessions = configuredSessionIds.length > 0
+            && (sessionIds.length > 1 || sessionIds[0] !== sessionId);
+        const seedNodes = useConfiguredSessions
+            ? await this.store.getSimilarNodesAcrossSessions(embedding, sessionIds, {
+                k: options.topK ?? this.graphTopK,
+                minSimilarity: options.minSimilarity ?? 0.6,
+            })
+            : await this.store.getSimilarNodes(embedding, sessionId, {
+                k: options.topK ?? this.graphTopK,
+                minSimilarity: options.minSimilarity ?? 0.6,
+            });
+        if (seedNodes.length === 0) {
+            return { systemPrompt: "", nodes: [], tokenCount: 0 };
+        }
+        return this.grafterPipeline.run(sessionId, seedNodes.map((node) => node.id), {
+            hopDepth: options.hopDepth ?? this.graphHopDepth,
+            expansionStrategy: options.expansionStrategy ?? "graph",
+            ...(configuredSessionIds.length > 0 ? { sessionIds } : {}),
+        });
+    }
+    async ingestGraftedNodes(nodes, targetSessionId) {
+        const copiedNodes = await this.store.absorbNodes(nodes, targetSessionId);
+        await this.store.rebuildEdgesForSession(targetSessionId);
+        return copiedNodes;
+    }
+    async selectNodesForAbsorb(sourceSessionId, options) {
+        const sourceNodes = await this.store.getNodesBySession(sourceSessionId);
+        if (options.topicIds && options.topicIds.length > 0) {
+            const topicIds = new Set(options.topicIds);
+            return sourceNodes.filter((node) => topicIds.has(node.id));
+        }
+        if (options.prompt) {
+            const embedding = await this.embedder.embed(options.prompt);
+            return this.store.getSimilarNodes(embedding, sourceSessionId, {
+                k: options.limit ?? 5,
+                minSimilarity: options.minSimilarity ?? 0.6,
+            });
+        }
+        return sourceNodes;
+    }
+    async absorbNodes(nodes, targetSessionId) {
+        const copiedNodes = await this.store.absorbNodes(nodes, targetSessionId);
+        await this.store.rebuildEdgesForSession(targetSessionId);
+        return copiedNodes;
+    }
+    createFleet(options = {}) {
+        return new MemoGrafterFleet(this, options);
+    }
+    async close() {
+        await this.ingestQueue?.close();
+        await this.recallCache?.quit().catch((error) => {
+            console.warn("MemoGrafter recall cache close warning:", error);
+            this.recallCache?.disconnect();
+        });
+        await this.store.close();
+    }
+    assertServerEnvironment() {
+        const globalScope = globalThis;
+        if (typeof globalScope.window !== "undefined" && typeof globalScope.document !== "undefined") {
+            throw new Error("MemoGrafter requires a Node.js server environment and cannot run in the browser.");
+        }
+    }
+    toTextPipelineOptions(options) {
+        return {
+            ...(options.replace ? { replace: true } : {}),
+            ...(options.label ? { label: options.label } : {}),
+            ...(options.source ? { source: options.source } : {}),
+            ...(options.tags ? { tags: options.tags } : {}),
+            sourceType: "document",
+        };
+    }
+    async clearRecallCache() {
+        if (!this.recallCache)
+            return;
+        try {
+            const keys = await this.recallCache.keys("mg:recall:*");
+            if (keys.length > 0) {
+                await this.recallCache.del(...keys);
+            }
+        }
+        catch (error) {
+            console.warn("MemoGrafter recall cache invalidation warning:", error);
+        }
+    }
+    resolveSessionIds(sessionId, configured) {
+        const sessionIds = configured && configured.length > 0 ? configured : [sessionId];
+        return [...new Set(sessionIds)];
+    }
+}
+//# sourceMappingURL=MemoGrafter.js.map

package/dist/core/MemoGrafter.js.map

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

package/dist/core/types.d.ts

@@ -0,0 +1,319 @@
+export interface Message {
+    role: "system" | "user" | "assistant";
+    content: string;
+}
+export type DriftMode = "window" | "intent";
+export type DriftSensitivity = "low" | "medium" | "high";
+export interface TopicNode {
+    id: string;
+    sessionId: string;
+    segmentId: string;
+    label: string;
+    summary: string;
+    embedding: number[];
+    tags?: string[];
+    source?: string;
+    messageRange: [number, number];
+    topicOrder: number;
+    driftScore: number;
+    agentColor: string | null;
+    fleetId: string | null;
+    agentId: string | null;
+    suppressed?: boolean;
+    suppressedAt?: Date | null;
+    createdAt: Date;
+}
+export interface TopicEdge {
+    srcId: string;
+    dstId: string;
+    weight: number;
+    type: string;
+}
+export interface TopicSegment {
+    id: string;
+    sessionId: string;
+    startIndex: number;
+    endIndex: number;
+    topicOrder: number;
+    driftScore: number;
+    createdAt: Date;
+}
+export type MemoryType = "fact" | "insight" | "question" | "task" | "reference";
+export type MemorySourceType = "conversation" | "note" | "document" | "code";
+export interface MemoryNode {
+    id: string;
+    segmentId: string;
+    topicNodeId: string;
+    agentId: string | null;
+    sessionId: string;
+    memoryType: MemoryType;
+    sourceType: MemorySourceType;
+    subject: string;
+    predicate: string;
+    value: string;
+    confidence: number;
+    embedding: number[];
+    tags?: string[];
+    source?: string;
+    sourceUrl: string | null;
+    sourceTitle: string | null;
+    supersededBy: string | null;
+    decayed: boolean;
+    forgotten?: boolean;
+    forgottenAt?: Date | null;
+    hasConflict?: boolean;
+    agentColor: string | null;
+    fleetId: string | null;
+    createdAt: Date;
+}
+export type MemoryNodeInsert = Omit<MemoryNode, "createdAt">;
+export interface MemoryEdge {
+    id: string;
+    sourceId: string;
+    targetId: string;
+    edgeType: "semantic" | "conflicts" | "updates" | "related";
+    weight: number;
+    createdAt: Date;
+}
+export type MemoryHistoryStatus = "active" | "superseded" | "conflicting" | "decayed" | "forgotten";
+export interface MemoryHistoryEntry {
+    memory: MemoryNode;
+    versionIndex: number;
+    status: MemoryHistoryStatus;
+    supersedes: string[];
+    supersededBy: string | null;
+    conflictsWith: string[];
+    updateEdges: MemoryEdge[];
+    conflictEdges: MemoryEdge[];
+    createdAt: Date;
+}
+export interface MemoryHistoryResult {
+    anchorMemoryId?: string;
+    subject?: string;
+    predicate?: string;
+    sessionId?: string;
+    entries: MemoryHistoryEntry[];
+    edges: MemoryEdge[];
+    currentMemory: MemoryNode | null;
+}
+export interface MemoryHistoryOptions {
+    sessionId?: string;
+}
+export interface MemoryDiffField {
+    field: keyof MemoryNode;
+    from: unknown;
+    to: unknown;
+    changed: boolean;
+}
+export interface MemoryDiff {
+    from: MemoryNode;
+    to: MemoryNode;
+    fields: MemoryDiffField[];
+    changedFields: MemoryDiffField[];
+    relationship: {
+        supersedes: boolean;
+        supersededBy: boolean;
+        conflicts: boolean;
+        updateEdges: MemoryEdge[];
+        conflictEdges: MemoryEdge[];
+    };
+}
+export interface ExtractedMemory {
+    memoryType: MemoryType;
+    subject: string;
+    predicate: string;
+    value: string;
+    confidence: number;
+}
+export interface SegmentExtractionResult {
+    label: string;
+    userIntent: string;
+    outcome: string;
+    open: string | null;
+    memories: ExtractedMemory[];
+}
+export interface InjectionResult {
+    systemPrompt: string;
+    nodes: TopicNode[];
+    memories?: MemoryNode[];
+    tokenCount: number;
+}
+export interface GraftRegistryEntry {
+    id: string;
+    sessionId: string;
+    nodeId: string;
+    sourceSessionId: string;
+    sourceNodeId: string;
+    graftedAt: Date;
+}
+export interface GraftOrigin {
+    sourceSessionId: string;
+    sourceNodeId: string;
+    graftedAt: Date;
+}
+export interface GraphSnapshotNode {
+    node: TopicNode;
+    lifecycle: {
+        suppressed: boolean;
+        suppressedAt: Date | null;
+    };
+    graftOrigin?: GraftOrigin;
+}
+export interface GraphSnapshotMemory {
+    memory: MemoryNode;
+    lifecycle: {
+        forgotten: boolean;
+        forgottenAt: Date | null;
+        decayed: boolean;
+        supersededBy: string | null;
+        hasConflict: boolean;
+    };
+}
+export interface GraphSnapshot {
+    sessionId: string;
+    nodes: TopicNode[];
+    snapshotNodes: GraphSnapshotNode[];
+    edges: TopicEdge[];
+    memories: MemoryNode[];
+    snapshotMemories: GraphSnapshotMemory[];
+    memoryEdges: MemoryEdge[];
+    capturedAt: string;
+}
+export interface SessionIngestState {
+    sessionId: string;
+    lastIngestedMessageIndex: number;
+    updatedAt: Date;
+}
+export interface RetrieverConfig {
+    limit?: number;
+    minSimilarity?: number;
+    tokenBudget?: number;
+    tags?: string[];
+    tagMode?: "all" | "any";
+    scope?: "session" | "session-and-tags" | "tagged";
+    sessionIds?: string[];
+    scoring?: {
+        /** Default 0.7. Weight applied to semantic similarity when ranking retrieved facts. */
+        similarityWeight?: number;
+        /** Default 0.3. Weight applied to memory confidence when ranking retrieved facts. */
+        confidenceWeight?: number;
+    };
+    cache?: {
+        ttlSeconds?: number;
+    };
+}
+export interface TagFilterOptions {
+    tags?: string[];
+    tagMode?: "all" | "any";
+    scope?: "session" | "session-and-tags" | "tagged";
+    sessionIds?: string[];
+    includeSuppressed?: boolean;
+    includeForgotten?: boolean;
+}
+export interface IngestOptions {
+    tags?: string[];
+}
+export interface IngestTextOptions {
+    replace?: boolean;
+    label?: string;
+    source?: string;
+}
+export type RememberOptions = IngestTextOptions;
+/** @internal */
+export interface IngestPipelineOptions extends IngestOptions {
+    replace?: boolean;
+    label?: string;
+    source?: string;
+    sourceType?: MemorySourceType;
+    minSegmentMessages?: number;
+}
+export interface RetrievalResult {
+    facts: (MemoryNode & {
+        similarity: number;
+    })[];
+    nodes: TopicNode[];
+    systemPrompt: string;
+    tokenCount: number;
+}
+export interface AbsorbFromAgentOptions {
+    topicIds?: string[];
+    prompt?: string;
+    minSimilarity?: number;
+    limit?: number;
+}
+export type GraftExpansionStrategy = "none" | "graph";
+export type FleetMemoryMode = "local" | "fleet" | "both";
+export interface GraftByRelevanceOptions {
+    topK?: number;
+    minSimilarity?: number;
+    hopDepth?: number;
+    expansionStrategy?: GraftExpansionStrategy;
+    sessionIds?: string[];
+}
+export interface LLMAdapter {
+    complete(messages: Message[], system?: string): Promise<string>;
+}
+export interface EmbedAdapter {
+    embed(text: string): Promise<number[]>;
+}
+export interface MemoGrafterDriftConfig {
+    mode?: DriftMode;
+    windowSize?: number;
+    driftSensitivity?: DriftSensitivity;
+    adaptiveSensitivity?: {
+        enabled?: boolean;
+        minSegments?: number;
+        lookbackSegments?: number;
+        targetSegmentMessages?: {
+            min?: number;
+            max?: number;
+        };
+        adjustmentStep?: number;
+        maxAdjustment?: number;
+        maxVarianceRatio?: number;
+    };
+    /** @deprecated Use driftSensitivity instead. */
+    threshold?: number;
+    minSegmentMessages?: number;
+    llmAmbiguityDetection?: boolean;
+    reentryDetection?: boolean;
+    reentryThreshold?: number;
+}
+export interface MemoGrafterGraphConfig {
+    topK?: number;
+    hopDepth?: number;
+}
+export interface MemoGrafterInjectConfig {
+    bufferSize?: number;
+    tokenBudget?: number;
+    /** Default 20. How many raw messages to keep after the pinned recall block. */
+    recentWindowSize?: number;
+    /** Default 6. How many recalled facts to inject before each invoke. */
+    recallLimit?: number;
+    /** Default 0.55. Minimum similarity for recalled facts injected before each invoke. */
+    recallMinSimilarity?: number;
+}
+export interface MemoGrafterQueueConfig {
+    redisUrl: string;
+    queueName?: string;
+    removeOnComplete?: boolean | number;
+    removeOnFail?: boolean | number;
+}
+export interface MemoGrafterCacheConfig {
+    connectionString: string;
+    ttlSeconds?: number;
+}
+export interface MemoGrafterConfig {
+    db: {
+        connectionString: string;
+    };
+    llm: LLMAdapter;
+    embedder: EmbedAdapter;
+    systemPrompt?: string;
+    drift?: MemoGrafterDriftConfig;
+    graph?: MemoGrafterGraphConfig;
+    inject?: MemoGrafterInjectConfig;
+    queue?: MemoGrafterQueueConfig;
+    cache?: MemoGrafterCacheConfig;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}