opencode-graphiti 0.1.4 → 0.1.6

package/README.md

@@ -101,7 +101,7 @@ Create a config file at `~/.config/opencode/graphiti.jsonc`:
   // Graphiti MCP server endpoint
   "endpoint": "http://localhost:8000/mcp",
 
-  // Prefix for project group IDs (e.g. "opencode_my-project")
+  // Prefix for project group IDs (e.g. "opencode-my-project")
   "groupIdPrefix": "opencode",
 
   // Number of user messages between memory re-injections (0 = disabled)
@@ -118,8 +118,12 @@ values.
 
 On the first user message in a session, the plugin searches Graphiti for facts
 and entities relevant to the message content. Results are split into project and
-user scopes (70% / 30% budget split), formatted, and prepended to the
-conversation as a synthetic context block.
+user scopes (70% / 30% budget split), formatted in XML-style `<memory>` blocks
+with explicit de-emphasis instructions, and injected into the conversation.
+
+Memory is injected via `output.message.system` (system-level instruction) when
+available, which prevents memory from influencing session titles. If the system
+field is unavailable, the plugin falls back to prepending synthetic parts.
 
 The injection budget is calculated dynamically: 5% of the model's context limit
 (resolved from the provider list) multiplied by 4 characters per token.
@@ -167,21 +171,10 @@ Each project gets a unique `group_id` derived from its directory name (e.g.
 underscores (colons are not allowed). This ensures memories from different
 projects stay isolated.
 
-## Development
-
-```bash
-# Format
-deno fmt
-
-# Lint
-deno lint
+## Contributing
 
-# Type check
-deno check src/index.ts
-
-# Build
-deno task build
-```
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and release
+process.
 
 ## License
 

package/esm/deno.d.ts

@@ -0,0 +1,47 @@
+declare namespace _default {
+    export let name: string;
+    export let description: string;
+    export let version: string;
+    export let license: string;
+    export namespace tasks {
+        let build: string;
+        namespace deploy {
+            let command: string;
+            let dependencies: string[];
+        }
+        let dev: string;
+        let check: string;
+        let lint: string;
+        let fmt: string;
+    }
+    export namespace lint_1 {
+        let exclude: string[];
+        namespace rules {
+            let exclude_1: string[];
+            export { exclude_1 as exclude };
+        }
+    }
+    export { lint_1 as lint };
+    export namespace fmt_1 {
+        let exclude_2: string[];
+        export { exclude_2 as exclude };
+    }
+    export { fmt_1 as fmt };
+    export namespace compilerOptions {
+        let strict: boolean;
+        let lib: string[];
+    }
+    export let nodeModulesDir: string;
+    export let imports: {
+        "@modelcontextprotocol/sdk": string;
+        "@opencode-ai/plugin": string;
+        "@opencode-ai/sdk": string;
+        cosmiconfig: string;
+        zod: string;
+    };
+    export let exports: {
+        ".": string;
+    };
+}
+export default _default;
+//# sourceMappingURL=deno.d.ts.map

package/esm/deno.d.ts.map

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

package/esm/deno.js

@@ -0,0 +1,41 @@
+export default {
+    "name": "opencode-graphiti",
+    "description": "OpenCode plugin for persistent memory via Graphiti knowledge graph",
+    "version": "0.0.0-development",
+    "license": "MIT",
+    "tasks": {
+        "build": "deno run -A dnt.ts",
+        "deploy": {
+            "command": "cd dist/ && npm publish",
+            "dependencies": ["build"]
+        },
+        "dev": "deno run --allow-all src/index.ts",
+        "check": "deno check src/index.ts",
+        "lint": "deno lint",
+        "fmt": "deno fmt"
+    },
+    "lint": {
+        "exclude": ["dist/"],
+        "rules": {
+            "exclude": ["no-import-prefix"]
+        }
+    },
+    "fmt": {
+        "exclude": ["dist/"]
+    },
+    "compilerOptions": {
+        "strict": true,
+        "lib": ["deno.ns", "dom", "esnext"]
+    },
+    "nodeModulesDir": "auto",
+    "imports": {
+        "@modelcontextprotocol/sdk": "npm:@modelcontextprotocol/sdk@^1.25.2",
+        "@opencode-ai/plugin": "npm:@opencode-ai/plugin@^1.1.53",
+        "@opencode-ai/sdk": "npm:@opencode-ai/sdk@^1.1.53",
+        "cosmiconfig": "npm:cosmiconfig@9.0.0",
+        "zod": "npm:zod@4.3.6"
+    },
+    "exports": {
+        ".": "./mod.ts"
+    }
+};

package/esm/src/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAcvD;;GAEG;AACH,wBAAgB,UAAU,IAAI,cAAc,CAc3C"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAgBvD;;GAEG;AACH,wBAAgB,UAAU,IAAI,cAAc,CAc3C"}

package/esm/src/config.js

@@ -3,12 +3,14 @@ import * as z from "zod/mini";
 const DEFAULT_CONFIG = {
     endpoint: "http://localhost:8000/mcp",
     groupIdPrefix: "opencode",
-    injectionInterval: 10,
+    driftThreshold: 0.5,
+    factStaleDays: 30,
 };
 const GraphitiConfigSchema = z.object({
     endpoint: z.string(),
     groupIdPrefix: z.string(),
-    injectionInterval: z.number(),
+    driftThreshold: z.number(),
+    factStaleDays: z.number(),
 });
 /**
  * Load Graphiti configuration from JSONC files with defaults applied.

package/esm/src/handlers/chat.d.ts

@@ -7,7 +7,8 @@ type ChatMessageOutput = Parameters<ChatMessageHook>[1];
 /** Dependencies for the chat message handler. */
 export interface ChatHandlerDeps {
     sessionManager: SessionManager;
-    injectionInterval: number;
+    driftThreshold: number;
+    factStaleDays: number;
     client: GraphitiClient;
 }
 /** Creates the `chat.message` hook handler. */

package/esm/src/handlers/chat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../src/src/handlers/chat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,KAAK,eAAe,GAAG,WAAW,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;AAC1D,KAAK,gBAAgB,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AACvD,KAAK,iBAAiB,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AAExD,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,cAAc,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,+CAA+C;AAC/C,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,IAyGvC,eAAe,gBAAgB,EAAE,QAAQ,iBAAiB,mBAuDzE"}
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../src/src/handlers/chat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAO5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,KAAK,eAAe,GAAG,WAAW,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC;AAC1D,KAAK,gBAAgB,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AACvD,KAAK,iBAAiB,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AAExD,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,cAAc,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,+CAA+C;AAC/C,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,IA+IvC,eAAe,gBAAgB,EAAE,QAAQ,iBAAiB,mBAqEzE"}

package/esm/src/handlers/chat.js

@@ -1,20 +1,11 @@
 import { calculateInjectionBudget } from "../services/context-limit.js";
-import { formatMemoryContext } from "../services/context.js";
+import { deduplicateContext, formatMemoryContext, } from "../services/context.js";
 import { logger } from "../services/logger.js";
 import { extractTextFromParts } from "../utils.js";
 /** Creates the `chat.message` hook handler. */
 export function createChatHandler(deps) {
-    const { sessionManager, injectionInterval, client } = deps;
-    const removeSyntheticMemoryParts = (parts) => parts.filter((part) => {
-        if (part.type !== "text")
-            return true;
-        if (part.id?.startsWith("graphiti-memory-"))
-            return false;
-        if (part.id?.startsWith("graphiti-refresh-"))
-            return false;
-        return true;
-    });
-    const injectMemoryContext = async (state, messageText, output, prefix, useUserScope, characterBudget, shouldReinject) => {
+    const { sessionManager, driftThreshold, factStaleDays, client } = deps;
+    const searchAndCacheMemoryContext = async (state, messageText, useUserScope, characterBudget, seedFactUuids) => {
         const userGroupId = state.userGroupId;
         const projectFactsPromise = client.searchFacts({
             query: messageText,
@@ -47,45 +38,83 @@ export function createChatHandler(deps) {
             userFactsPromise,
             userNodesPromise,
         ]);
-        const projectContext = formatMemoryContext(projectFacts, projectNodes);
-        const userContext = formatMemoryContext(userFacts, userNodes);
-        if (!projectContext && !userContext)
+        const projectContext = deduplicateContext({
+            facts: projectFacts,
+            nodes: projectNodes,
+        });
+        const userContext = deduplicateContext({
+            facts: userFacts,
+            nodes: userNodes,
+        });
+        const projectContextString = formatMemoryContext(projectContext.facts, projectContext.nodes, { factStaleDays });
+        const userContextString = formatMemoryContext(userContext.facts, userContext.nodes, { factStaleDays });
+        if (!projectContextString && !userContextString)
             return;
+        let snapshotPrimer = "";
+        if (useUserScope && characterBudget > 0) {
+            try {
+                const episodes = await client.getEpisodes({
+                    groupId: state.groupId,
+                    lastN: 10,
+                });
+                const snapshot = episodes
+                    .filter((episode) => {
+                    const description = episode.sourceDescription ??
+                        episode.source_description ?? "";
+                    return description === "session-snapshot";
+                })
+                    .sort((a, b) => {
+                    const aTime = a.created_at ? Date.parse(a.created_at) : 0;
+                    const bTime = b.created_at ? Date.parse(b.created_at) : 0;
+                    return bTime - aTime;
+                })[0];
+                if (snapshot?.content) {
+                    const snapshotBudget = Math.min(characterBudget, 1200);
+                    snapshotPrimer = [
+                        "## Session Snapshot",
+                        "> Most recent session snapshot; use to restore active strategy and open questions.",
+                        "",
+                        snapshot.content.slice(0, snapshotBudget),
+                    ].join("\n");
+                }
+            }
+            catch (err) {
+                logger.error("Failed to load session snapshot", { err });
+            }
+        }
         const projectBudget = useUserScope
             ? Math.floor(characterBudget * 0.7)
             : characterBudget;
         const userBudget = characterBudget - projectBudget;
-        const truncatedProject = projectContext.slice(0, projectBudget);
-        const truncatedUser = useUserScope ? userContext.slice(0, userBudget) : "";
-        const memoryContext = [truncatedProject, truncatedUser]
+        const truncatedProject = projectContextString.slice(0, projectBudget);
+        const truncatedUser = useUserScope
+            ? userContextString.slice(0, userBudget)
+            : "";
+        const memoryContext = [snapshotPrimer, truncatedProject, truncatedUser]
             .filter((section) => section.trim().length > 0)
             .join("\n\n")
             .slice(0, characterBudget);
         if (!memoryContext)
             return;
-        if ("system" in output.message) {
-            try {
-                output.message.system = memoryContext;
-                return;
-            }
-            catch (_err) {
-                // Fall through to synthetic injection.
-            }
-        }
-        if (shouldReinject) {
-            output.parts = removeSyntheticMemoryParts(output.parts);
-        }
-        {
-            output.parts.unshift({
-                type: "text",
-                text: memoryContext,
-                id: `${prefix}${Date.now()}`,
-                sessionID: output.message.sessionID,
-                messageID: output.message.id,
-                synthetic: true,
-            });
+        const factUuids = seedFactUuids ??
+            new Set([
+                ...projectContext.facts.map((fact) => fact.uuid),
+                ...userContext.facts.map((fact) => fact.uuid),
+            ]);
+        state.cachedMemoryContext = memoryContext;
+        logger.info(`Cached ${projectFacts.length + userFacts.length} facts and ${projectNodes.length + userNodes.length} nodes for system prompt injection`);
+        state.lastInjectionFactUuids = factUuids;
+    };
+    const computeJaccardSimilarity = (left, right) => {
+        if (left.size === 0 && right.size === 0)
+            return 1;
+        let intersection = 0;
+        for (const value of left) {
+            if (right.has(value))
+                intersection += 1;
         }
-        logger.info(`Injected ${projectFacts.length + userFacts.length} facts and ${projectNodes.length + userNodes.length} nodes`);
+        const union = left.size + right.size - intersection;
+        return union === 0 ? 1 : intersection / union;
     };
     return async ({ sessionID }, output) => {
         if (await sessionManager.isSubagentSession(sessionID)) {
@@ -112,19 +141,30 @@ export function createChatHandler(deps) {
             messageLength: messageText.length,
         });
         const shouldInjectOnFirst = !state.injectedMemories;
-        const shouldReinject = !shouldInjectOnFirst &&
-            injectionInterval > 0 &&
-            (state.messageCount - state.lastInjectionMessageCount) >=
-                injectionInterval;
-        if (!shouldInjectOnFirst && !shouldReinject)
-            return;
+        let shouldReinject = false;
+        let currentFactUuids = null;
+        if (!shouldInjectOnFirst) {
+            const driftFacts = await client.searchFacts({
+                query: messageText,
+                groupIds: [state.groupId],
+                maxFacts: 20,
+            });
+            currentFactUuids = new Set(driftFacts.map((fact) => fact.uuid));
+            const similarity = computeJaccardSimilarity(currentFactUuids, state.lastInjectionFactUuids);
+            shouldReinject = similarity < driftThreshold;
+            if (!shouldReinject) {
+                logger.debug("Skipping reinjection; drift above threshold", {
+                    sessionID,
+                    similarity,
+                });
+                return;
+            }
+        }
         try {
-            const prefix = shouldReinject ? "graphiti-refresh-" : "graphiti-memory-";
             const useUserScope = shouldInjectOnFirst;
             const characterBudget = calculateInjectionBudget(state.contextLimit);
-            await injectMemoryContext(state, messageText, output, prefix, useUserScope, characterBudget, shouldReinject);
+            await searchAndCacheMemoryContext(state, messageText, useUserScope, characterBudget, currentFactUuids);
             state.injectedMemories = true;
-            state.lastInjectionMessageCount = state.messageCount;
         }
         catch (err) {
             logger.error("Failed to inject memories:", err);

package/esm/src/handlers/compacting.d.ts

@@ -9,6 +9,7 @@ export interface CompactingHandlerDeps {
     sessionManager: SessionManager;
     client: GraphitiClient;
     defaultGroupId: string;
+    factStaleDays: number;
 }
 /** Creates the `experimental.session.compacting` hook handler. */
 export declare function createCompactingHandler(deps: CompactingHandlerDeps): ({ sessionID }: CompactingInput, output: CompactingOutput) => Promise<void>;

package/esm/src/handlers/compacting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compacting.d.ts","sourceRoot":"","sources":["../../../src/src/handlers/compacting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,KAAK,cAAc,GAAG,WAAW,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC,CAAC;AAC5E,KAAK,eAAe,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;AACrD,KAAK,gBAAgB,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;AAEtD,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,cAAc,CAAC;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,kEAAkE;AAClE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,IAI/D,eAAe,eAAe,EAC9B,QAAQ,gBAAgB,mBAyB3B"}
+{"version":3,"file":"compacting.d.ts","sourceRoot":"","sources":["../../../src/src/handlers/compacting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,KAAK,cAAc,GAAG,WAAW,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC,CAAC;AAC5E,KAAK,eAAe,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;AACrD,KAAK,gBAAgB,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;AAEtD,+CAA+C;AAC/C,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,cAAc,CAAC;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,kEAAkE;AAClE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,IAI/D,eAAe,eAAe,EAC9B,QAAQ,gBAAgB,mBA0B3B"}

package/esm/src/handlers/compacting.js

@@ -3,7 +3,7 @@ import { calculateInjectionBudget } from "../services/context-limit.js";
 import { logger } from "../services/logger.js";
 /** Creates the `experimental.session.compacting` hook handler. */
 export function createCompactingHandler(deps) {
-    const { sessionManager, client, defaultGroupId } = deps;
+    const { sessionManager, client, defaultGroupId, factStaleDays } = deps;
     return async ({ sessionID }, output) => {
         const state = sessionManager.getState(sessionID);
         if (!state?.isMain) {
@@ -20,6 +20,7 @@ export function createCompactingHandler(deps) {
                 user: state.userGroupId,
             },
             contextStrings: output.context,
+            factStaleDays,
         });
         if (additionalContext.length > 0) {
             output.context.push(...additionalContext);

package/esm/src/handlers/event.d.ts

@@ -1,6 +1,6 @@
 import type { Hooks } from "@opencode-ai/plugin";
+import type { OpencodeClient } from "@opencode-ai/sdk";
 import type { GraphitiClient } from "../services/client.js";
-import type { ProviderListClient } from "../services/context-limit.js";
 import type { SessionManager } from "../session.js";
 type EventHook = NonNullable<Hooks["event"]>;
 type EventInput = Parameters<EventHook>[0];
@@ -9,7 +9,7 @@ export interface EventHandlerDeps {
     sessionManager: SessionManager;
     client: GraphitiClient;
     defaultGroupId: string;
-    sdkClient: ProviderListClient;
+    sdkClient: OpencodeClient;
     directory: string;
     groupIdPrefix: string;
 }

package/esm/src/handlers/event.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../../src/src/handlers/event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,KAAK,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;AAC7C,KAAK,UAAU,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AAE3C,0CAA0C;AAC1C,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,cAAc,CAAC;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wCAAwC;AACxC,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,IAWzC,WAAW,UAAU,mBA+JpC"}
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../../src/src/handlers/event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAI5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,KAAK,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;AAC7C,KAAK,UAAU,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;AAE3C,0CAA0C;AAC1C,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,cAAc,CAAC;IAC/B,MAAM,EAAE,cAAc,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wCAAwC;AACxC,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,IAkDzC,WAAW,UAAU,mBAkLpC"}

package/esm/src/handlers/event.js

@@ -6,6 +6,41 @@ import { isTextPart, makeUserGroupId } from "../utils.js";
 export function createEventHandler(deps) {
     const { sessionManager, client, defaultGroupId, sdkClient, directory, groupIdPrefix, } = deps;
     const defaultUserGroupId = makeUserGroupId(groupIdPrefix);
+    const buildSessionSnapshot = (sessionId, messages) => {
+        const recentMessages = messages.slice(-12);
+        const recentAssistant = [...recentMessages]
+            .reverse()
+            .find((message) => message.startsWith("Assistant:"))
+            ?.replace(/^Assistant:\s*/, "")
+            .trim();
+        const recentUser = [...recentMessages]
+            .reverse()
+            .find((message) => message.startsWith("User:"))
+            ?.replace(/^User:\s*/, "")
+            .trim();
+        const questionRegex = /[^\n\r?]{3,200}\?/g;
+        const questions = recentMessages
+            .flatMap((message) => {
+            const text = message.replace(/^(User|Assistant):\s*/, "");
+            return text.match(questionRegex) ?? [];
+        })
+            .map((question) => question.trim());
+        const uniqueQuestions = Array.from(new Set(questions)).slice(0, 6);
+        const lines = [];
+        lines.push(`Session ${sessionId} working snapshot`);
+        if (recentUser)
+            lines.push(`Recent user focus: ${recentUser}`);
+        if (recentAssistant) {
+            lines.push(`Recent assistant focus: ${recentAssistant}`);
+        }
+        if (uniqueQuestions.length > 0) {
+            lines.push("Open questions:");
+            for (const question of uniqueQuestions) {
+                lines.push(`- ${question}`);
+            }
+        }
+        return lines.join("\n");
+    };
     return async ({ event }) => {
         try {
             if (event.type === "session.created") {
@@ -24,7 +59,7 @@ export function createEventHandler(deps) {
                         groupId: defaultGroupId,
                         userGroupId: defaultUserGroupId,
                         injectedMemories: false,
-                        lastInjectionMessageCount: 0,
+                        lastInjectionFactUuids: new Set(),
                         messageCount: 0,
                         pendingMessages: [],
                         contextLimit: 200_000,
@@ -71,6 +106,22 @@ export function createEventHandler(deps) {
                     logger.debug("Ignoring non-main idle session:", sessionId);
                     return;
                 }
+                try {
+                    const snapshotContent = buildSessionSnapshot(sessionId, state.pendingMessages);
+                    if (snapshotContent.trim()) {
+                        await client.addEpisode({
+                            name: `Snapshot: ${sessionId}`,
+                            episodeBody: snapshotContent,
+                            groupId: state.groupId,
+                            source: "text",
+                            sourceDescription: "session-snapshot",
+                        });
+                        logger.info("Saved session snapshot", { sessionId });
+                    }
+                }
+                catch (err) {
+                    logger.error("Failed to save session snapshot", { sessionId, err });
+                }
                 await sessionManager.flushPendingMessages(sessionId, "Buffered messages from OpenCode session", 50);
                 return;
             }

package/esm/src/handlers/system.d.ts

@@ -0,0 +1,11 @@
+import type { Hooks } from "@opencode-ai/plugin";
+import type { SessionManager } from "../session.js";
+type SystemTransformHook = NonNullable<Hooks["experimental.chat.system.transform"]>;
+type SystemTransformInput = Parameters<SystemTransformHook>[0];
+type SystemTransformOutput = Parameters<SystemTransformHook>[1];
+export interface SystemHandlerDeps {
+    sessionManager: SessionManager;
+}
+export declare function createSystemHandler(deps: SystemHandlerDeps): ({ sessionID }: SystemTransformInput, output: SystemTransformOutput) => Promise<void>;
+export {};
+//# sourceMappingURL=system.d.ts.map

package/esm/src/handlers/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../src/src/handlers/system.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,KAAK,mBAAmB,GAAG,WAAW,CACpC,KAAK,CAAC,oCAAoC,CAAC,CAC5C,CAAC;AACF,KAAK,oBAAoB,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/D,KAAK,qBAAqB,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;AAEhE,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,cAAc,CAAC;CAChC;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,IAMvD,eAAe,oBAAoB,EACnC,QAAQ,qBAAqB,mBAYhC"}

package/esm/src/handlers/system.js

@@ -0,0 +1,18 @@
+import { logger } from "../services/logger.js";
+export function createSystemHandler(deps) {
+    const { sessionManager } = deps;
+    // Assumes chat.message hook completes before system.transform fires for the same turn.
+    // deno-lint-ignore require-await
+    return async ({ sessionID }, output) => {
+        if (!sessionID)
+            return;
+        const state = sessionManager.getState(sessionID);
+        if (!state?.isMain)
+            return;
+        if (!state.cachedMemoryContext)
+            return;
+        output.system.push(state.cachedMemoryContext);
+        state.cachedMemoryContext = undefined;
+        logger.info("Injected memory context into system prompt");
+    };
+}

package/esm/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,qBAAqB,CAAC;AAW/D;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,MAkDtB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,qBAAqB,CAAC;AAW/D;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,MAuDtB,CAAC"}

package/esm/src/index.js

@@ -2,6 +2,7 @@ import { loadConfig } from "./config.js";
 import { createChatHandler } from "./handlers/chat.js";
 import { createCompactingHandler } from "./handlers/compacting.js";
 import { createEventHandler } from "./handlers/event.js";
+import { createSystemHandler } from "./handlers/system.js";
 import { GraphitiClient } from "./services/client.js";
 import { logger } from "./services/logger.js";
 import { SessionManager } from "./session.js";
@@ -27,19 +28,24 @@ export const graphiti = async (input) => {
             sessionManager,
             client,
             defaultGroupId,
-            sdkClient: sdkClient,
+            sdkClient,
             directory: input.directory,
             groupIdPrefix: config.groupIdPrefix,
         }),
         "chat.message": createChatHandler({
             sessionManager,
-            injectionInterval: config.injectionInterval,
+            driftThreshold: config.driftThreshold,
+            factStaleDays: config.factStaleDays,
             client,
         }),
         "experimental.session.compacting": createCompactingHandler({
             sessionManager,
             client,
             defaultGroupId,
+            factStaleDays: config.factStaleDays,
+        }),
+        "experimental.chat.system.transform": createSystemHandler({
+            sessionManager,
         }),
     };
 };

package/esm/src/services/client.d.ts

@@ -1,4 +1,4 @@
-import type { GraphitiFact, GraphitiNode } from "../types/index.js";
+import type { GraphitiEpisode, GraphitiFact, GraphitiNode } from "../types/index.js";
 /**
  * Graphiti MCP client wrapper for connecting, querying,
  * and persisting episodes with basic reconnection handling.
@@ -57,6 +57,13 @@ export declare class GraphitiClient {
         groupIds?: string[];
         maxNodes?: number;
     }): Promise<GraphitiNode[]>;
+    /**
+     * Retrieve recent episodes for a group.
+     */
+    getEpisodes(params: {
+        groupId?: string;
+        lastN?: number;
+    }): Promise<GraphitiEpisode[]>;
     /**
      * Check whether the Graphiti MCP server is reachable.
      */

package/esm/src/services/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/src/services/client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EAEZ,YAAY,EAEb,MAAM,mBAAmB,CAAC;AAG3B;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;IAEzB;;OAEG;gBACS,QAAQ,EAAE,MAAM;IAM5B,oDAAoD;IACpD,OAAO,CAAC,wBAAwB;IAOhC;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBjC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAOnB,QAAQ;IAkCtB,OAAO,CAAC,gBAAgB;YASV,SAAS;IAavB;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO;IAyBzC;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;QACrC,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjB;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAsB3B;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAsB3B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;CAQpC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/src/services/client.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EAEZ,YAAY,EAEb,MAAM,mBAAmB,CAAC;AAG3B;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;IAEzB;;OAEG;gBACS,QAAQ,EAAE,MAAM;IAS5B,oDAAoD;IACpD,OAAO,CAAC,wBAAwB;IAUhC;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAgBjC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;YAOnB,QAAQ;IAkCtB,OAAO,CAAC,gBAAgB;YASV,SAAS;IAavB;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO;IAyBzC;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;QACrC,iBAAiB,CAAC,EAAE,MAAM,CAAC;KAC5B,GAAG,OAAO,CAAC,IAAI,CAAC;IAWjB;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAsB3B;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAsB3B;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE;QACxB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAqB9B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;CAQpC"}