opencode-graphiti 0.1.0 → 0.1.2

package/script/src/session.d.ts

@@ -0,0 +1,90 @@
+import type { GraphitiClient } from "./services/client.js";
+/**
+ * Per-session state tracked by the plugin.
+ */
+export type SessionState = {
+    /** Graphiti group ID for this session. */
+    groupId: string;
+    /** Graphiti group ID for user-scoped memories. */
+    userGroupId: string;
+    /** Whether memories have been injected into this session yet. */
+    injectedMemories: boolean;
+    /** Message count at last memory injection. */
+    lastInjectionMessageCount: number;
+    /** Count of messages observed in this session. */
+    messageCount: number;
+    /** Buffered message strings awaiting flush. */
+    pendingMessages: string[];
+    /** Context window limit in tokens. */
+    contextLimit: number;
+    /** 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.
+ */
+export declare class SessionManager {
+    private readonly defaultGroupId;
+    private readonly defaultUserGroupId;
+    private readonly sdkClient;
+    private readonly graphitiClient;
+    private sessions;
+    private parentIdCache;
+    private pendingAssistantMessages;
+    private bufferedAssistantMessageIds;
+    constructor(defaultGroupId: string, defaultUserGroupId: string, sdkClient: SdkSessionClient, graphitiClient: GraphitiClient);
+    /** Get the current session state, if present. */
+    getState(sessionId: string): SessionState | undefined;
+    /** Persist session state for the given session ID. */
+    setState(sessionId: string, state: SessionState): void;
+    /** Cache a resolved parent ID for a session. */
+    setParentId(sessionId: string, parentId: string | null): void;
+    /** Resolve and cache the parent ID for a session. */
+    resolveParentId(sessionId: string): Promise<string | null | undefined>;
+    /** Resolve the session state, initializing if needed. */
+    resolveSessionState(sessionId: string): Promise<{
+        state: SessionState | null;
+        resolved: boolean;
+    }>;
+    /** Determine whether a session is a subagent session. */
+    isSubagentSession(sessionId: string): Promise<boolean>;
+    /** Buffer partial assistant text for a streaming message. */
+    bufferAssistantPart(sessionId: string, messageId: string, text: string): void;
+    /** Check if an assistant message has already been finalized. */
+    isAssistantBuffered(sessionId: string, messageId: string): boolean;
+    /**
+     * Finalize a buffered assistant message and append it to pending messages.
+     */
+    finalizeAssistantMessage(state: SessionState, sessionId: string, messageId: string, source: string): void;
+    /** Flush pending buffered messages to Graphiti when size thresholds permit. */
+    flushPendingMessages(sessionId: string, sourceDescription: string, minBytes: number): Promise<void>;
+    /** Remove a pending assistant message by key. */
+    deletePendingAssistant(sessionId: string, messageId: string): void;
+    /** Clear cached data for a session. */
+    deleteSession(sessionId: string): void;
+    private fetchLatestAssistantMessage;
+}
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/src/session.ts"],"names":[],"mappings":"AACA,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,8CAA8C;IAC9C,yBAAyB,EAAE,MAAM,CAAC;IAClC,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;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE;QACP,uCAAuC;QACvC,GAAG,EAAE,CAAC,IAAI,EAAE;YAAE,IAAI,EAAE;gBAAE,EAAE,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1D,0CAA0C;QAC1C,QAAQ,EAAE,CAAC,IAAI,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KAC7E,CAAC;CACH;AAED;;;GAGG;AACH;;;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,gBAAgB,EAC3B,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;IAyB7D,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

@@ -0,0 +1,308 @@
+"use strict";
+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.
+ */
+class SessionManager {
+    constructor(defaultGroupId, defaultUserGroupId, sdkClient, graphitiClient) {
+        Object.defineProperty(this, "defaultGroupId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: defaultGroupId
+        });
+        Object.defineProperty(this, "defaultUserGroupId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: defaultUserGroupId
+        });
+        Object.defineProperty(this, "sdkClient", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: sdkClient
+        });
+        Object.defineProperty(this, "graphitiClient", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: graphitiClient
+        });
+        Object.defineProperty(this, "sessions", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        Object.defineProperty(this, "parentIdCache", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        Object.defineProperty(this, "pendingAssistantMessages", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Map()
+        });
+        Object.defineProperty(this, "bufferedAssistantMessageIds", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new Set()
+        });
+    }
+    /** Get the current session state, if present. */
+    getState(sessionId) {
+        return this.sessions.get(sessionId);
+    }
+    /** Persist session state for the given session ID. */
+    setState(sessionId, state) {
+        this.sessions.set(sessionId, state);
+    }
+    /** Cache a resolved parent ID for a session. */
+    setParentId(sessionId, parentId) {
+        this.parentIdCache.set(sessionId, parentId);
+    }
+    /** Resolve and cache the parent ID for a session. */
+    async resolveParentId(sessionId) {
+        if (this.parentIdCache.has(sessionId)) {
+            return this.parentIdCache.get(sessionId) ?? null;
+        }
+        try {
+            const response = await this.sdkClient.session.get({
+                path: { id: sessionId },
+            });
+            const sessionInfo = typeof response === "object" && response !== null &&
+                "data" in response
+                ? response.data
+                : response;
+            if (!sessionInfo)
+                return undefined;
+            const parentId = sessionInfo.parentID ?? null;
+            this.parentIdCache.set(sessionId, parentId);
+            return parentId;
+        }
+        catch (err) {
+            logger_js_1.logger.debug("Failed to resolve session parentID", { sessionId, err });
+            return undefined;
+        }
+    }
+    /** Resolve the session state, initializing if needed. */
+    async resolveSessionState(sessionId) {
+        const parentId = await this.resolveParentId(sessionId);
+        if (parentId === undefined)
+            return { state: null, resolved: false };
+        if (parentId) {
+            this.sessions.delete(sessionId);
+            return { state: null, resolved: true };
+        }
+        let state = this.sessions.get(sessionId);
+        if (!state) {
+            state = {
+                groupId: this.defaultGroupId,
+                userGroupId: this.defaultUserGroupId,
+                injectedMemories: false,
+                lastInjectionMessageCount: 0,
+                messageCount: 0,
+                pendingMessages: [],
+                contextLimit: 200_000,
+                isMain: true,
+            };
+            this.sessions.set(sessionId, state);
+        }
+        return { state, resolved: true };
+    }
+    /** Determine whether a session is a subagent session. */
+    async isSubagentSession(sessionId) {
+        const parentId = await this.resolveParentId(sessionId);
+        return !!parentId;
+    }
+    /** Buffer partial assistant text for a streaming message. */
+    bufferAssistantPart(sessionId, messageId, text) {
+        const key = `${sessionId}:${messageId}`;
+        this.pendingAssistantMessages.set(key, { sessionId, text });
+    }
+    /** Check if an assistant message has already been finalized. */
+    isAssistantBuffered(sessionId, messageId) {
+        const key = `${sessionId}:${messageId}`;
+        return this.bufferedAssistantMessageIds.has(key);
+    }
+    /**
+     * Finalize a buffered assistant message and append it to pending messages.
+     */
+    finalizeAssistantMessage(state, sessionId, messageId, source) {
+        const key = `${sessionId}:${messageId}`;
+        if (this.bufferedAssistantMessageIds.has(key))
+            return;
+        const buffered = this.pendingAssistantMessages.get(key);
+        this.pendingAssistantMessages.delete(key);
+        this.bufferedAssistantMessageIds.add(key);
+        const messageText = buffered?.text?.trim() ?? "";
+        const messagePreview = messageText.slice(0, 120);
+        logger_js_1.logger.info("Assistant message completed", {
+            hook: source,
+            sessionId,
+            messageID: messageId,
+            source,
+            messageLength: messageText.length,
+            preview: messagePreview,
+        });
+        if (!messageText) {
+            logger_js_1.logger.debug("Assistant message completed without buffered text", {
+                hook: source,
+                sessionId,
+                messageID: messageId,
+                source,
+            });
+            return;
+        }
+        state.pendingMessages.push(`Assistant: ${messageText}`);
+        logger_js_1.logger.info("Buffered assistant reply", {
+            hook: source,
+            sessionId,
+            messageID: messageId,
+            source,
+            messageLength: messageText.length,
+            preview: messagePreview,
+        });
+    }
+    /** Flush pending buffered messages to Graphiti when size thresholds permit. */
+    async flushPendingMessages(sessionId, sourceDescription, minBytes) {
+        const state = this.sessions.get(sessionId);
+        if (!state || state.pendingMessages.length === 0)
+            return;
+        const lastMessage = state.pendingMessages.at(-1);
+        if (lastMessage) {
+            const separatorIndex = lastMessage.indexOf(":");
+            const role = separatorIndex === -1
+                ? lastMessage.trim().toLowerCase()
+                : lastMessage.slice(0, separatorIndex).trim().toLowerCase();
+            if (role === "user") {
+                const fallback = await this.fetchLatestAssistantMessage(sessionId);
+                if (fallback?.text) {
+                    const fallbackKey = fallback.id
+                        ? `${sessionId}:${fallback.id}`
+                        : undefined;
+                    const alreadyBuffered = fallbackKey
+                        ? this.bufferedAssistantMessageIds.has(fallbackKey)
+                        : state.pendingMessages.some((message) => message.startsWith("Assistant:") &&
+                            message.includes(fallback.text));
+                    if (!alreadyBuffered) {
+                        state.pendingMessages.push(`Assistant: ${fallback.text}`);
+                        if (fallbackKey) {
+                            this.bufferedAssistantMessageIds.add(fallbackKey);
+                        }
+                        logger_js_1.logger.info("Fallback assistant fetch used", {
+                            sessionId,
+                            messageID: fallback.id,
+                            messageLength: fallback.text.length,
+                        });
+                    }
+                }
+            }
+        }
+        const combined = state.pendingMessages.join("\n\n");
+        if (combined.length < minBytes)
+            return;
+        const messagesToFlush = [...state.pendingMessages];
+        state.pendingMessages = [];
+        const messageLines = messagesToFlush.map((message) => {
+            const separatorIndex = message.indexOf(":");
+            const role = separatorIndex === -1
+                ? "Unknown"
+                : message.slice(0, separatorIndex).trim();
+            const text = separatorIndex === -1
+                ? message
+                : message.slice(separatorIndex + 1).trim();
+            return `${role}: ${text}`;
+        });
+        try {
+            const name = combined.slice(0, 80).replace(/\n/g, " ");
+            logger_js_1.logger.info(`Flushing ${messagesToFlush.length} buffered message(s).`);
+            logger_js_1.logger.info(`Buffered message contents:\n${messageLines.join("\n")}`, { sessionId });
+            await this.graphitiClient.addEpisode({
+                name: `Buffered messages: ${name}`,
+                episodeBody: combined,
+                groupId: state.groupId,
+                source: "text",
+                sourceDescription,
+            });
+            logger_js_1.logger.info("Flushed buffered messages to Graphiti");
+        }
+        catch (err) {
+            logger_js_1.logger.error(`Failed to flush messages for ${sessionId}:`, err);
+            const currentState = this.sessions.get(sessionId);
+            if (currentState) {
+                currentState.pendingMessages = [
+                    ...messagesToFlush,
+                    ...currentState.pendingMessages,
+                ];
+            }
+        }
+    }
+    /** Remove a pending assistant message by key. */
+    deletePendingAssistant(sessionId, messageId) {
+        const key = `${sessionId}:${messageId}`;
+        this.pendingAssistantMessages.delete(key);
+    }
+    /** Clear cached data for a session. */
+    deleteSession(sessionId) {
+        this.sessions.delete(sessionId);
+        this.parentIdCache.delete(sessionId);
+        for (const key of this.pendingAssistantMessages.keys()) {
+            if (key.startsWith(`${sessionId}:`)) {
+                this.pendingAssistantMessages.delete(key);
+            }
+        }
+        for (const key of this.bufferedAssistantMessageIds) {
+            if (key.startsWith(`${sessionId}:`)) {
+                this.bufferedAssistantMessageIds.delete(key);
+            }
+        }
+    }
+    async fetchLatestAssistantMessage(sessionId) {
+        try {
+            const response = await this.sdkClient.session.messages({
+                sessionID: sessionId,
+                limit: 20,
+            });
+            const payload = response && typeof response === "object" &&
+                "data" in response
+                ? response.data
+                : response;
+            const messages = Array.isArray(payload)
+                ? payload
+                : [];
+            if (messages.length === 0)
+                return null;
+            const lastAssistant = [...messages]
+                .reverse()
+                .find((message) => message.info?.role === "assistant");
+            if (!lastAssistant)
+                return null;
+            const text = (0, utils_js_1.extractTextFromParts)(lastAssistant.parts);
+            if (!text)
+                return null;
+            return { id: lastAssistant.info?.id, text };
+        }
+        catch (err) {
+            logger_js_1.logger.debug("Failed to list session messages for fallback", {
+                sessionId,
+                err,
+            });
+            return null;
+        }
+    }
+}
+exports.SessionManager = SessionManager;

package/script/src/types/index.d.ts

@@ -1,48 +1,67 @@
+/** Plugin configuration for Graphiti memory integration. */
 export interface GraphitiConfig {
+    /** URL of the Graphiti MCP server endpoint. */
     endpoint: string;
+    /** Prefix for group IDs to namespace project memories. */
     groupIdPrefix: string;
-    maxFacts: number;
-    maxNodes: number;
-    maxEpisodes: number;
-    injectOnFirstMessage: boolean;
-    enableCompactionSave: boolean;
-    compactionThreshold?: number;
-    minTokensForCompaction?: number;
-    compactionCooldownMs?: number;
-    autoResumeAfterCompaction?: boolean;
+    /** Number of user messages between reinjections (0 disables). */
+    injectionInterval: number;
 }
+/** A fact retrieved from the Graphiti knowledge graph. */
 export interface GraphitiFact {
+    /** Unique identifier for the fact. */
     uuid: string;
+    /** Human-readable fact content. */
     fact: string;
+    /** Timestamp when the fact becomes valid. */
     valid_at?: string;
+    /** Timestamp when the fact becomes invalid. */
     invalid_at?: string;
+    /** Source entity for the fact edge. */
     source_node?: {
         name: string;
         uuid: string;
     };
+    /** Target entity for the fact edge. */
     target_node?: {
         name: string;
         uuid: string;
     };
 }
+/** Response payload containing Graphiti facts. */
 export interface GraphitiFactsResponse {
+    /** List of facts from Graphiti. */
     facts: GraphitiFact[];
 }
+/** A node retrieved from the Graphiti knowledge graph. */
 export interface GraphitiNode {
+    /** Unique identifier for the node. */
     uuid: string;
+    /** Display name of the node. */
     name: string;
+    /** Optional summary describing the node. */
     summary?: string;
+    /** Optional labels associated with the node. */
     labels?: string[];
 }
+/** Response payload containing Graphiti nodes. */
 export interface GraphitiNodesResponse {
+    /** List of nodes from Graphiti. */
     nodes: GraphitiNode[];
 }
+/** An episode retrieved from Graphiti memory. */
 export interface GraphitiEpisode {
+    /** Unique identifier for the episode. */
     uuid: string;
+    /** Episode title or name. */
     name: string;
+    /** Episode content body. */
     content: string;
+    /** Optional episode source type. */
     source?: string;
+    /** Optional episode creation timestamp. */
     created_at?: string;
+    /** Optional labels associated with the episode. */
     labels?: string[];
 }
 //# sourceMappingURL=index.d.ts.map

package/script/src/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,oBAAoB,EAAE,OAAO,CAAC;IAE9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/types/index.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,uCAAuC;IACvC,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C;AAED,kDAAkD;AAClD,MAAM,WAAW,qBAAqB;IACpC,mCAAmC;IACnC,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,kDAAkD;AAClD,MAAM,WAAW,qBAAqB;IACpC,mCAAmC;IACnC,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/script/src/utils.d.ts

@@ -0,0 +1,21 @@
+import type { Part } from "@opencode-ai/sdk";
+/**
+ * Build a sanitized Graphiti group ID from a prefix and project directory.
+ */
+export declare const makeGroupId: (prefix: string, directory?: string) => string;
+/**
+ * Build a sanitized Graphiti group ID from a prefix and user home directory.
+ */
+export declare const makeUserGroupId: (prefix: string) => string;
+/**
+ * Narrow an OpenCode Part to a non-synthetic text part.
+ */
+export declare const isTextPart: (value: unknown) => value is Part & {
+    type: "text";
+    text: string;
+};
+/**
+ * Extract and join text from OpenCode message parts.
+ */
+export declare const extractTextFromParts: (parts: Part[]) => string;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAG7C;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,EAAE,YAAY,MAAM,KAAG,MAKhE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,MAMhD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,IAAI,GAAG;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CAMd,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAI,OAAO,IAAI,EAAE,KAAG,MACe,CAAC"}

package/script/src/utils.js

@@ -0,0 +1,44 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractTextFromParts = exports.isTextPart = exports.makeUserGroupId = exports.makeGroupId = void 0;
+const node_os_1 = __importDefault(require("node:os"));
+/**
+ * Build a sanitized Graphiti group ID from a prefix and project directory.
+ */
+const makeGroupId = (prefix, directory) => {
+    const parts = directory?.split("/").filter(Boolean) ?? [];
+    const projectName = parts[parts.length - 1] || "default";
+    const rawGroupId = `${prefix}_${projectName}`;
+    return rawGroupId.replace(/[^A-Za-z0-9_-]/g, "_");
+};
+exports.makeGroupId = makeGroupId;
+/**
+ * Build a sanitized Graphiti group ID from a prefix and user home directory.
+ */
+const makeUserGroupId = (prefix) => {
+    const homeDir = node_os_1.default.homedir() || "user";
+    const parts = homeDir.split("/").filter(Boolean);
+    const userName = parts[parts.length - 1] || "user";
+    const rawGroupId = `${prefix}_user_${userName}`;
+    return rawGroupId.replace(/[^A-Za-z0-9_-]/g, "_");
+};
+exports.makeUserGroupId = makeUserGroupId;
+/**
+ * Narrow an OpenCode Part to a non-synthetic text part.
+ */
+const isTextPart = (value) => {
+    if (!value || typeof value !== "object")
+        return false;
+    const part = value;
+    return part.type === "text" && typeof part.text === "string" &&
+        !part.synthetic;
+};
+exports.isTextPart = isTextPart;
+/**
+ * Extract and join text from OpenCode message parts.
+ */
+const extractTextFromParts = (parts) => parts.filter(exports.isTextPart).map((part) => part.text).join(" ").trim();
+exports.extractTextFromParts = extractTextFromParts;