opencode-graphiti 0.1.4 → 0.1.6

package/script/src/services/client.js

@@ -1,8 +1,12 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GraphitiClient = void 0;
 const index_js_1 = require("@modelcontextprotocol/sdk/client/index.js");
 const streamableHttp_js_1 = require("@modelcontextprotocol/sdk/client/streamableHttp.js");
+const deno_js_1 = __importDefault(require("../../deno.js"));
 const logger_js_1 = require("./logger.js");
 /**
  * Graphiti MCP client wrapper for connecting, querying,
@@ -38,12 +42,18 @@ class GraphitiClient {
             value: void 0
         });
         this.endpoint = endpoint;
-        this.client = new index_js_1.Client({ name: "opencode-graphiti", version: "0.1.4" });
+        this.client = new index_js_1.Client({
+            name: deno_js_1.default.name,
+            version: deno_js_1.default.version,
+        });
         this.transport = new streamableHttp_js_1.StreamableHTTPClientTransport(new URL(endpoint));
     }
     /** Create a fresh MCP Client and Transport pair. */
     createClientAndTransport() {
-        this.client = new index_js_1.Client({ name: "opencode-graphiti", version: "0.1.4" });
+        this.client = new index_js_1.Client({
+            name: deno_js_1.default.name,
+            version: deno_js_1.default.version,
+        });
         this.transport = new streamableHttp_js_1.StreamableHTTPClientTransport(new URL(this.endpoint));
     }
     /**
@@ -211,6 +221,29 @@ class GraphitiClient {
             return [];
         }
     }
+    /**
+     * Retrieve recent episodes for a group.
+     */
+    async getEpisodes(params) {
+        try {
+            const result = await this.callTool("get_episodes", {
+                group_id: params.groupId,
+                last_n: params.lastN,
+            });
+            if (Array.isArray(result))
+                return result;
+            if (result &&
+                typeof result === "object" &&
+                Array.isArray(result.episodes)) {
+                return result.episodes;
+            }
+            return [];
+        }
+        catch (err) {
+            logger_js_1.logger.error("getEpisodes error:", err);
+            return [];
+        }
+    }
     /**
      * Check whether the Graphiti MCP server is reachable.
      */

package/script/src/services/compaction.d.ts

@@ -1,4 +1,13 @@
 import type { GraphitiFact, GraphitiNode } from "../types/index.js";
+export declare const classifyFacts: (facts: GraphitiFact[], now: Date) => {
+    decisions: GraphitiFact[];
+    active: GraphitiFact[];
+    background: GraphitiFact[];
+};
+export declare const takeFactsWithinBudget: (facts: GraphitiFact[], budget: number, formatOptions: {
+    factStaleDays: number;
+    now: Date;
+}) => GraphitiFact[];
 /**
  * Persist a compaction summary episode when enabled.
  */
@@ -38,5 +47,6 @@ export declare function getCompactionContext(params: {
         user?: string;
     };
     contextStrings: string[];
+    factStaleDays?: number;
 }): Promise<string[]>;
 //# sourceMappingURL=compaction.d.ts.map

package/script/src/services/compaction.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../../src/src/services/compaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAIpE;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,MAAM,EAAE;QACN,UAAU,EAAE,CAAC,IAAI,EAAE;YACjB,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,EAAE,MAAM,CAAC;YACpB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;YACrC,iBAAiB,CAAC,EAAE,MAAM,CAAC;SAC5B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KACrB,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBhB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,MAAM,EAAE;QACN,WAAW,EAAE,CAAC,IAAI,EAAE;YAClB,KAAK,EAAE,MAAM,CAAC;YACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;YACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;SACnB,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QAC9B,WAAW,EAAE,CAAC,IAAI,EAAE;YAClB,KAAK,EAAE,MAAM,CAAC;YACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;YACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;SACnB,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;KAC/B,CAAC;IACF,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAgIpB"}
+{"version":3,"file":"compaction.d.ts","sourceRoot":"","sources":["../../../src/src/services/compaction.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AA0BpE,eAAO,MAAM,aAAa,GACxB,OAAO,YAAY,EAAE,EACrB,KAAK,IAAI,KACR;IACD,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,UAAU,EAAE,YAAY,EAAE,CAAC;CA4B5B,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,OAAO,YAAY,EAAE,EACrB,QAAQ,MAAM,EACd,eAAe;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,IAAI,CAAA;CAAE,KAClD,YAAY,EAoBd,CAAC;AAEF;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,MAAM,EAAE;QACN,UAAU,EAAE,CAAC,IAAI,EAAE;YACjB,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,EAAE,MAAM,CAAC;YACpB,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;YACrC,iBAAiB,CAAC,EAAE,MAAM,CAAC;SAC5B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;KACrB,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBhB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE;IACjD,MAAM,EAAE;QACN,WAAW,EAAE,CAAC,IAAI,EAAE;YAClB,KAAK,EAAE,MAAM,CAAC;YACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;YACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;SACnB,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;QAC9B,WAAW,EAAE,CAAC,IAAI,EAAE;YAClB,KAAK,EAAE,MAAM,CAAC;YACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;YACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;SACnB,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;KAC/B,CAAC;IACF,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA0KpB"}

package/script/src/services/compaction.js

@@ -1,9 +1,76 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.takeFactsWithinBudget = exports.classifyFacts = void 0;
 exports.handleCompaction = handleCompaction;
 exports.getCompactionContext = getCompactionContext;
 const context_js_1 = require("./context.js");
 const logger_js_1 = require("./logger.js");
+const DAY_MS = 24 * 60 * 60 * 1000;
+const DECISION_KEYWORDS = [
+    "decided",
+    "must",
+    "should",
+    "prefer",
+    "constraint",
+    "require",
+    "chose",
+    "always",
+    "never",
+    "schema",
+    "architecture",
+    "agreed",
+    "design",
+    "selected",
+];
+const classifyFacts = (facts, now) => {
+    const decisions = [];
+    const active = [];
+    const background = [];
+    const cutoff = now.getTime() - 7 * DAY_MS;
+    for (const fact of facts) {
+        const text = fact.fact.toLowerCase();
+        // Use word boundary regex to match whole words only
+        const hasDecisionKeyword = DECISION_KEYWORDS.some((keyword) => {
+            const regex = new RegExp(`\\b${keyword}\\b`, "i");
+            return regex.test(text);
+        });
+        if (hasDecisionKeyword) {
+            decisions.push(fact);
+            continue;
+        }
+        const validAt = fact.valid_at ? Date.parse(fact.valid_at) : NaN;
+        if (!Number.isNaN(validAt) && validAt >= cutoff) {
+            active.push(fact);
+            continue;
+        }
+        background.push(fact);
+    }
+    return { decisions, active, background };
+};
+exports.classifyFacts = classifyFacts;
+const takeFactsWithinBudget = (facts, budget, formatOptions) => {
+    if (budget <= 0 || facts.length === 0)
+        return [];
+    const classified = (0, exports.classifyFacts)(facts, formatOptions.now);
+    const prioritized = [
+        ...classified.decisions,
+        ...classified.active,
+        ...classified.background,
+    ];
+    const lines = (0, context_js_1.formatFactLines)(prioritized, formatOptions);
+    const selected = [];
+    let remaining = budget;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const length = line.length + 1;
+        if (remaining - length < 0)
+            continue;
+        selected.push(prioritized[i]);
+        remaining -= length;
+    }
+    return selected;
+};
+exports.takeFactsWithinBudget = takeFactsWithinBudget;
 /**
  * Persist a compaction summary episode when enabled.
  */
@@ -30,6 +97,8 @@ async function handleCompaction(params) {
  */
 async function getCompactionContext(params) {
     const { client, characterBudget, groupIds, contextStrings } = params;
+    const now = new Date();
+    const factStaleDays = params.factStaleDays ?? 30;
     try {
         const queryText = contextStrings.slice(0, 3).join(" ").slice(0, 500);
         if (!queryText.trim())
@@ -70,14 +139,40 @@ async function getCompactionContext(params) {
             userFacts.length === 0 && userNodes.length === 0) {
             return [];
         }
-        const buildSection = (header, facts, nodes) => {
+        const formatOptions = { factStaleDays, now };
+        const projectContext = (0, context_js_1.deduplicateContext)({
+            facts: projectFacts,
+            nodes: projectNodes,
+        });
+        const userContext = (0, context_js_1.deduplicateContext)({
+            facts: userFacts,
+            nodes: userNodes,
+        });
+        const buildSection = (header, facts, nodes, budget) => {
             const lines = [];
             lines.push(header);
             lines.push("<instruction>Background context only; do not reference in titles, summaries, or opening responses unless directly relevant.</instruction>");
-            if (facts.length > 0) {
-                lines.push("<facts>");
-                lines.push(...(0, context_js_1.formatFactLines)(facts));
-                lines.push("</facts>");
+            const classified = (0, exports.classifyFacts)(facts, now);
+            const decisionBudget = Math.floor(budget * 0.4);
+            const activeBudget = Math.floor(budget * 0.35);
+            const backgroundBudget = budget - decisionBudget - activeBudget;
+            const selectedDecisions = (0, exports.takeFactsWithinBudget)(classified.decisions, decisionBudget, formatOptions);
+            const selectedActive = (0, exports.takeFactsWithinBudget)(classified.active, activeBudget, formatOptions);
+            const selectedBackground = (0, exports.takeFactsWithinBudget)(classified.background, backgroundBudget, formatOptions);
+            if (selectedDecisions.length > 0) {
+                lines.push("<decisions>");
+                lines.push(...(0, context_js_1.formatFactLines)(selectedDecisions, formatOptions));
+                lines.push("</decisions>");
+            }
+            if (selectedActive.length > 0) {
+                lines.push("<active_context>");
+                lines.push(...(0, context_js_1.formatFactLines)(selectedActive, formatOptions));
+                lines.push("</active_context>");
+            }
+            if (selectedBackground.length > 0) {
+                lines.push("<background>");
+                lines.push(...(0, context_js_1.formatFactLines)(selectedBackground, formatOptions));
+                lines.push("</background>");
             }
             if (nodes.length > 0) {
                 lines.push("<nodes>");
@@ -86,25 +181,19 @@ async function getCompactionContext(params) {
             }
             return lines.join("\n");
         };
-        const projectSection = buildSection('<memory source="project">', projectFacts, projectNodes);
-        const userSection = buildSection('<memory source="user">', userFacts, userNodes);
         const headerLines = [
             "<summary>",
-            "<current_goal>",
-            "- ",
-            "</current_goal>",
-            "",
-            "<work_completed>",
+            "<decisions>",
             "- ",
-            "</work_completed>",
+            "</decisions>",
             "",
-            "<remaining_tasks>",
+            "<active_context>",
             "- ",
-            "</remaining_tasks>",
+            "</active_context>",
             "",
-            "<constraints_decisions>",
+            "<background>",
             "- ",
-            "</constraints_decisions>",
+            "</background>",
             "",
             "<persistent_memory>",
         ];
@@ -113,6 +202,8 @@ async function getCompactionContext(params) {
         const remainingBudget = Math.max(characterBudget - base.length, 0);
         const projectBudget = Math.floor(remainingBudget * 0.7);
         const userBudget = remainingBudget - projectBudget;
+        const projectSection = buildSection('<memory source="project">', projectContext.facts, projectContext.nodes, projectBudget);
+        const userSection = buildSection('<memory source="user">', userContext.facts, userContext.nodes, userBudget);
         const truncatedProject = projectSection.slice(0, projectBudget);
         const truncatedUser = userSection.slice(0, userBudget);
         const sections = [header];

package/script/src/services/context-limit.d.ts

@@ -1,11 +1,5 @@
-export interface ProviderListClient {
-    provider: {
-        list: (options?: {
-            directory?: string;
-        }) => Promise<unknown>;
-    };
-}
-export declare function resolveContextLimit(providerID: string, modelID: string, client: ProviderListClient, directory: string): Promise<number>;
+import type { OpencodeClient } from "@opencode-ai/sdk";
+export declare function resolveContextLimit(providerID: string, modelID: string, client: OpencodeClient, directory: string): Promise<number>;
 /**
  * Calculate the character budget for memory injection
  * (5% of context limit * 4 chars/token).

package/script/src/services/context-limit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-limit.d.ts","sourceRoot":"","sources":["../../../src/src/services/context-limit.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE;QACR,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE;YAAE,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KAC9D,CAAC;CACH;AAID,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CA+BjB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAErE"}
+{"version":3,"file":"context-limit.d.ts","sourceRoot":"","sources":["../../../src/src/services/context-limit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAOvD,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CAiCjB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAErE"}

package/script/src/services/context-limit.js

@@ -11,7 +11,9 @@ async function resolveContextLimit(providerID, modelID, client, directory) {
     if (cached)
         return cached;
     try {
-        const providers = await client.provider.list({ directory });
+        const providers = await client.provider.list({
+            query: { directory },
+        });
         const list = providers.providers ?? [];
         for (const provider of list) {
             const providerInfo = provider;

package/script/src/services/context.d.ts

@@ -1,8 +1,33 @@
 import type { GraphitiFact, GraphitiNode } from "../types/index.js";
-export declare const formatFactLines: (facts: GraphitiFact[]) => string[];
+export declare const parseDate: (value?: string) => Date | null;
+export declare const isFactInvalid: (fact: GraphitiFact, now: Date) => boolean;
+export declare const annotateStaleFact: (fact: GraphitiFact, now: Date, factStaleDays: number) => GraphitiFact;
+export declare const sortFactsByRecency: (facts: GraphitiFact[]) => GraphitiFact[];
+export declare const filterAndAnnotateFacts: (facts: GraphitiFact[], options?: {
+    factStaleDays?: number;
+    now?: Date;
+}) => GraphitiFact[];
+export declare const formatFactLine: (fact: GraphitiFact) => string;
+export declare const formatFactLines: (facts: GraphitiFact[], options?: {
+    factStaleDays?: number;
+    now?: Date;
+}) => string[];
 export declare const formatNodeLines: (nodes: GraphitiNode[]) => string[];
+export declare const deduplicateFactsByUuid: (facts: GraphitiFact[]) => GraphitiFact[];
+export declare const deduplicateNodesByUuid: (nodes: GraphitiNode[]) => GraphitiNode[];
+export declare const removeNodesReferencedByFacts: (facts: GraphitiFact[], nodes: GraphitiNode[]) => GraphitiNode[];
+export declare const deduplicateContext: (params: {
+    facts: GraphitiFact[];
+    nodes: GraphitiNode[];
+}) => {
+    facts: GraphitiFact[];
+    nodes: GraphitiNode[];
+};
 /**
  * Format Graphiti facts and nodes into a user-facing context block.
  */
-export declare function formatMemoryContext(facts: GraphitiFact[], nodes: GraphitiNode[]): string;
+export declare function formatMemoryContext(facts: GraphitiFact[], nodes: GraphitiNode[], options?: {
+    factStaleDays?: number;
+    now?: Date;
+}): string;
 //# sourceMappingURL=context.d.ts.map

package/script/src/services/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/src/services/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEpE,eAAO,MAAM,eAAe,GAAI,OAAO,YAAY,EAAE,KAAG,MAAM,EAO1D,CAAC;AAEL,eAAO,MAAM,eAAe,GAAI,OAAO,YAAY,EAAE,KAAG,MAAM,EAK1D,CAAC;AAEL;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,YAAY,EAAE,EACrB,KAAK,EAAE,YAAY,EAAE,GACpB,MAAM,CA0BR"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/src/services/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAIpE,eAAO,MAAM,SAAS,GAAI,QAAQ,MAAM,KAAG,IAAI,GAAG,IAKjD,CAAC;AAEF,eAAO,MAAM,aAAa,GAAI,MAAM,YAAY,EAAE,KAAK,IAAI,KAAG,OAQ7D,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC5B,MAAM,YAAY,EAClB,KAAK,IAAI,EACT,eAAe,MAAM,KACpB,YAUF,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,OAAO,YAAY,EAAE,KAAG,YAAY,EAWtE,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,OAAO,YAAY,EAAE,EACrB,UAAU;IACR,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,KACA,YAAY,EAMd,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,MAAM,YAAY,KAAG,MAMnD,CAAC;AAEF,eAAO,MAAM,eAAe,GAC1B,OAAO,YAAY,EAAE,EACrB,UAAU;IACR,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,KACA,MAAM,EAGR,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,OAAO,YAAY,EAAE,KAAG,MAAM,EAK1D,CAAC;AAEL,eAAO,MAAM,sBAAsB,GACjC,OAAO,YAAY,EAAE,KACpB,YAAY,EASd,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,OAAO,YAAY,EAAE,KACpB,YAAY,EASd,CAAC;AAEF,eAAO,MAAM,4BAA4B,GACvC,OAAO,YAAY,EAAE,EACrB,OAAO,YAAY,EAAE,KACpB,YAAY,EAOd,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,QAAQ;IACzC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB,KAAG;IAAE,KAAK,EAAE,YAAY,EAAE,CAAC;IAAC,KAAK,EAAE,YAAY,EAAE,CAAA;CAQjD,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,YAAY,EAAE,EACrB,KAAK,EAAE,YAAY,EAAE,EACrB,OAAO,CAAC,EAAE;IACR,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,GACA,MAAM,CA6BR"}

package/script/src/services/context.js

@@ -1,43 +1,147 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.formatNodeLines = exports.formatFactLines = void 0;
+exports.deduplicateContext = exports.removeNodesReferencedByFacts = exports.deduplicateNodesByUuid = exports.deduplicateFactsByUuid = exports.formatNodeLines = exports.formatFactLines = exports.formatFactLine = exports.filterAndAnnotateFacts = exports.sortFactsByRecency = exports.annotateStaleFact = exports.isFactInvalid = exports.parseDate = void 0;
 exports.formatMemoryContext = formatMemoryContext;
-const formatFactLines = (facts) => facts.map((fact) => {
+const DAY_MS = 24 * 60 * 60 * 1000;
+const parseDate = (value) => {
+    if (!value)
+        return null;
+    const parsed = Date.parse(value);
+    if (Number.isNaN(parsed))
+        return null;
+    return new Date(parsed);
+};
+exports.parseDate = parseDate;
+const isFactInvalid = (fact, now) => {
+    const invalidAt = (0, exports.parseDate)(fact.invalid_at);
+    if (invalidAt && invalidAt.getTime() < now.getTime())
+        return true;
+    const validAt = (0, exports.parseDate)(fact.valid_at);
+    if (validAt && validAt.getTime() > now.getTime())
+        return true;
+    return false;
+};
+exports.isFactInvalid = isFactInvalid;
+const annotateStaleFact = (fact, now, factStaleDays) => {
+    const validAt = (0, exports.parseDate)(fact.valid_at);
+    if (!validAt)
+        return fact;
+    const ageDays = Math.floor((now.getTime() - validAt.getTime()) / DAY_MS);
+    if (ageDays < 0)
+        return fact;
+    if (ageDays < factStaleDays)
+        return fact;
+    return {
+        ...fact,
+        fact: `[stale: ${ageDays} days ago] ${fact.fact}`,
+    };
+};
+exports.annotateStaleFact = annotateStaleFact;
+const sortFactsByRecency = (facts) => {
+    const indexed = facts.map((fact, index) => ({
+        fact,
+        index,
+        time: (0, exports.parseDate)(fact.valid_at)?.getTime() ?? -Infinity,
+    }));
+    indexed.sort((a, b) => {
+        if (a.time !== b.time)
+            return b.time - a.time;
+        return a.index - b.index;
+    });
+    return indexed.map((entry) => entry.fact);
+};
+exports.sortFactsByRecency = sortFactsByRecency;
+const filterAndAnnotateFacts = (facts, options) => {
+    const now = options?.now ?? new Date();
+    const factStaleDays = options?.factStaleDays ?? 30;
+    const filtered = facts.filter((fact) => !(0, exports.isFactInvalid)(fact, now));
+    const sorted = (0, exports.sortFactsByRecency)(filtered);
+    return sorted.map((fact) => (0, exports.annotateStaleFact)(fact, now, factStaleDays));
+};
+exports.filterAndAnnotateFacts = filterAndAnnotateFacts;
+const formatFactLine = (fact) => {
     const entities = [];
     if (fact.source_node?.name)
         entities.push(fact.source_node.name);
     if (fact.target_node?.name)
         entities.push(fact.target_node.name);
     const entityStr = entities.length > 0 ? ` [${entities.join(" -> ")}]` : "";
-    return `<fact>${fact.fact}${entityStr}</fact>`;
-});
+    return `- ${fact.fact}${entityStr}`;
+};
+exports.formatFactLine = formatFactLine;
+const formatFactLines = (facts, options) => {
+    const annotated = (0, exports.filterAndAnnotateFacts)(facts, options);
+    return annotated.map((fact) => (0, exports.formatFactLine)(fact));
+};
 exports.formatFactLines = formatFactLines;
 const formatNodeLines = (nodes) => nodes.map((node) => {
     const labels = node.labels?.length ? ` (${node.labels.join(", ")})` : "";
     const summary = node.summary ? `: ${node.summary}` : "";
-    return `<node>${node.name}${labels}${summary}</node>`;
+    return `- **${node.name}**${labels}${summary}`;
 });
 exports.formatNodeLines = formatNodeLines;
+const deduplicateFactsByUuid = (facts) => {
+    const seen = new Set();
+    const deduped = [];
+    for (const fact of facts) {
+        if (seen.has(fact.uuid))
+            continue;
+        seen.add(fact.uuid);
+        deduped.push(fact);
+    }
+    return deduped;
+};
+exports.deduplicateFactsByUuid = deduplicateFactsByUuid;
+const deduplicateNodesByUuid = (nodes) => {
+    const seen = new Set();
+    const deduped = [];
+    for (const node of nodes) {
+        if (seen.has(node.uuid))
+            continue;
+        seen.add(node.uuid);
+        deduped.push(node);
+    }
+    return deduped;
+};
+exports.deduplicateNodesByUuid = deduplicateNodesByUuid;
+const removeNodesReferencedByFacts = (facts, nodes) => {
+    const factNodeUuids = new Set();
+    for (const fact of facts) {
+        if (fact.source_node?.uuid)
+            factNodeUuids.add(fact.source_node.uuid);
+        if (fact.target_node?.uuid)
+            factNodeUuids.add(fact.target_node.uuid);
+    }
+    return nodes.filter((node) => !factNodeUuids.has(node.uuid));
+};
+exports.removeNodesReferencedByFacts = removeNodesReferencedByFacts;
+const deduplicateContext = (params) => {
+    const dedupedFacts = (0, exports.deduplicateFactsByUuid)(params.facts);
+    const dedupedNodes = (0, exports.deduplicateNodesByUuid)(params.nodes);
+    const filteredNodes = (0, exports.removeNodesReferencedByFacts)(dedupedFacts, dedupedNodes);
+    return { facts: dedupedFacts, nodes: filteredNodes };
+};
+exports.deduplicateContext = deduplicateContext;
 /**
  * Format Graphiti facts and nodes into a user-facing context block.
  */
-function formatMemoryContext(facts, nodes) {
+function formatMemoryContext(facts, nodes, options) {
     if (facts.length === 0 && nodes.length === 0) {
         return "";
     }
     const sections = [];
-    sections.push("<memory>");
-    sections.push("<instruction>Background context only; do not reference in titles, summaries, or opening responses unless directly relevant.</instruction>");
+    sections.push("# Persistent Memory (from Graphiti Knowledge Graph)");
+    sections.push("The following information was retrieved from your persistent memory.");
+    sections.push("Use this context to inform your responses, but do not mention it unless asked.");
     if (facts.length > 0) {
-        sections.push("<facts>");
-        sections.push(...(0, exports.formatFactLines)(facts));
-        sections.push("</facts>");
+        sections.push("");
+        sections.push("## Known Facts");
+        sections.push(...(0, exports.formatFactLines)(facts, options));
     }
     if (nodes.length > 0) {
-        sections.push("<nodes>");
+        sections.push("");
+        sections.push("## Known Entities");
         sections.push(...(0, exports.formatNodeLines)(nodes));
-        sections.push("</nodes>");
     }
-    sections.push("</memory>");
     return sections.join("\n");
 }

package/script/src/services/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/src/services/logger.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,MAAM;oBACD,OAAO,EAAE;oBAGT,OAAO,EAAE;qBAGR,OAAO,EAAE;qBAGT,OAAO,EAAE;CAG3B,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/src/services/logger.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,MAAM;oBACD,OAAO,EAAE;oBAGT,OAAO,EAAE;qBAGR,OAAO,EAAE;qBAGT,OAAO,EAAE;CAG3B,CAAC"}

package/script/src/services/logger.js

@@ -1,45 +1,11 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.logger = void 0;
-const dntShim = __importStar(require("../../_dnt.shims.js"));
 const node_process_1 = __importDefault(require("node:process"));
-const console = dntShim.dntGlobalThis.console;
+const console = globalThis.console;
 const PREFIX = "[graphiti]";
 exports.logger = {
     info: (...args) => {

package/script/src/session.d.ts

@@ -1,3 +1,4 @@
+import type { OpencodeClient } from "@opencode-ai/sdk";
 import type { GraphitiClient } from "./services/client.js";
 /**
  * Per-session state tracked by the plugin.
@@ -9,8 +10,10 @@ export type SessionState = {
     userGroupId: string;
     /** Whether memories have been injected into this session yet. */
     injectedMemories: boolean;
-    /** Message count at last memory injection. */
-    lastInjectionMessageCount: number;
+    /** Fact UUIDs included in the last memory injection. */
+    lastInjectionFactUuids: Set<string>;
+    /** Cached formatted memory context for system prompt injection. */
+    cachedMemoryContext?: string;
     /** Count of messages observed in this session. */
     messageCount: number;
     /** Buffered message strings awaiting flush. */
@@ -20,28 +23,6 @@ export type SessionState = {
     /** True when this session is the primary (non-subagent) session. */
     isMain: boolean;
 };
-/**
- * Minimal SDK client interface needed for session operations.
- */
-export interface SdkSessionClient {
-    session: {
-        /** Retrieve session metadata by ID. */
-        get: (args: {
-            path: {
-                id: string;
-            };
-        }) => Promise<unknown>;
-        /** List recent messages for a session. */
-        messages: (args: {
-            sessionID: string;
-            limit?: number;
-        }) => Promise<unknown>;
-    };
-}
-/**
- * Manages session lifecycle, parent ID resolution, message buffering,
- * and flushing of pending messages to Graphiti.
- */
 /**
  * Tracks per-session state, parent resolution, message buffering,
  * and flushing pending messages to Graphiti.
@@ -55,7 +36,7 @@ export declare class SessionManager {
     private parentIdCache;
     private pendingAssistantMessages;
     private bufferedAssistantMessageIds;
-    constructor(defaultGroupId: string, defaultUserGroupId: string, sdkClient: SdkSessionClient, graphitiClient: GraphitiClient);
+    constructor(defaultGroupId: string, defaultUserGroupId: string, sdkClient: OpencodeClient, graphitiClient: GraphitiClient);
     /** Get the current session state, if present. */
     getState(sessionId: string): SessionState | undefined;
     /** Persist session state for the given session ID. */

package/script/src/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/src/session.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/src/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAGf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAI3D;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,wDAAwD;IACxD,sBAAsB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,mEAAmE;IACnE,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,qBAAa,cAAc;IAUvB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,kBAAkB;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,cAAc;IAZjC,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,wBAAwB,CAG5B;IACJ,OAAO,CAAC,2BAA2B,CAAqB;gBAGrC,cAAc,EAAE,MAAM,EACtB,kBAAkB,EAAE,MAAM,EAC1B,SAAS,EAAE,cAAc,EACzB,cAAc,EAAE,cAAc;IAGjD,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIrD,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI;IAItD,gDAAgD;IAChD,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAI7D,qDAAqD;IAC/C,eAAe,CACnB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAsBrC,yDAAyD;IACnD,mBAAmB,CACvB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IA0B7D,yDAAyD;IACnD,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAK5D,6DAA6D;IAC7D,mBAAmB,CACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,IAAI;IAKP,gEAAgE;IAChE,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAKlE;;OAEG;IACH,wBAAwB,CACtB,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,IAAI;IAwCP,+EAA+E;IACzE,oBAAoB,CACxB,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,MAAM,EACzB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC;IAgFhB,iDAAiD;IACjD,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAKlE,uCAAuC;IACvC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;YAexB,2BAA2B;CAiC1C"}

package/script/src/session.js

@@ -3,10 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SessionManager = void 0;
 const logger_js_1 = require("./services/logger.js");
 const utils_js_1 = require("./utils.js");
-/**
- * Manages session lifecycle, parent ID resolution, message buffering,
- * and flushing of pending messages to Graphiti.
- */
 /**
  * Tracks per-session state, parent resolution, message buffering,
  * and flushing pending messages to Graphiti.
@@ -113,7 +109,8 @@ class SessionManager {
                 groupId: this.defaultGroupId,
                 userGroupId: this.defaultUserGroupId,
                 injectedMemories: false,
-                lastInjectionMessageCount: 0,
+                lastInjectionFactUuids: new Set(),
+                cachedMemoryContext: undefined,
                 messageCount: 0,
                 pendingMessages: [],
                 contextLimit: 200_000,
@@ -274,8 +271,8 @@ class SessionManager {
     async fetchLatestAssistantMessage(sessionId) {
         try {
             const response = await this.sdkClient.session.messages({
-                sessionID: sessionId,
-                limit: 20,
+                path: { id: sessionId },
+                query: { limit: 20 },
             });
             const payload = response && typeof response === "object" &&
                 "data" in response