opencode-graphiti 0.0.0-development

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

@@ -0,0 +1,120 @@
+/** Redis hot-tier configuration. */
+export interface RedisConfig {
+    endpoint: string;
+    batchSize: number;
+    batchMaxBytes: number;
+    sessionTtlSeconds: number;
+    cacheTtlSeconds: number;
+    drainRetryMax: number;
+}
+/** Legacy nested FalkorDB compatibility config. */
+export interface FalkorDbConfig {
+    redisEndpoint?: string;
+    batchSize?: number;
+    batchMaxBytes?: number;
+    sessionTtlSeconds?: number;
+    cacheTtlSeconds?: number;
+    drainRetryMax?: number;
+}
+/** Graphiti async-tier configuration. */
+export interface GraphitiServiceConfig {
+    endpoint: string;
+    groupIdPrefix: string;
+    driftThreshold: number;
+}
+/** Plugin configuration for hot-tier + Graphiti async integration. */
+export interface GraphitiConfig {
+    redis: RedisConfig;
+    graphiti: GraphitiServiceConfig;
+    falkordb?: FalkorDbConfig;
+    endpoint?: string;
+    groupIdPrefix?: string;
+    driftThreshold?: number;
+}
+/** A fact retrieved from the Graphiti knowledge graph. */
+export interface GraphitiFact {
+    uuid: string;
+    fact: string;
+    valid_at?: string;
+    invalid_at?: string;
+    source_node?: {
+        name: string;
+        uuid: string;
+    };
+    target_node?: {
+        name: string;
+        uuid: string;
+    };
+}
+/** A node retrieved from the Graphiti knowledge graph. */
+export interface GraphitiNode {
+    uuid: string;
+    name: string;
+    summary?: string;
+    labels?: string[];
+}
+/** A recent episode retrieved from Graphiti memory. */
+export interface GraphitiEpisode {
+    uuid: string;
+    name: string;
+    content: string;
+    source?: string;
+    sourceDescription?: string;
+    created_at?: string;
+    labels?: string[];
+}
+export type EventCategory = "task.create" | "task.update" | "task.complete" | "decision" | "preference" | "rule.load" | "file.read" | "file.write" | "file.edit" | "file.search" | "cwd.change" | "env.change" | "git.activity" | "error" | "subagent.start" | "subagent.finish" | "integration.call" | "intent" | "data.import" | "discovery" | "message" | "session.meta";
+export type SessionEventSourceKind = "user-request" | "assistant-response" | "tool-activity" | "system-state";
+export interface SessionEvent {
+    id: string;
+    ts: number;
+    category: EventCategory;
+    priority: 0 | 1 | 2 | 3 | 4;
+    role: "user" | "assistant" | "tool" | "system";
+    summary: string;
+    body?: string;
+    detail?: string;
+    continuityText?: string;
+    keywords?: string[];
+    sourceKind?: SessionEventSourceKind;
+    refs?: string[];
+    metadata?: Record<string, unknown>;
+}
+export declare const getSessionEventPrimaryText: (event: SessionEvent, fallback?: string) => string;
+export declare const getSessionEventRecallText: (event: SessionEvent) => string;
+export interface PersistentMemoryCacheEntry {
+    query: string;
+    refreshedAt: number;
+    nodes: GraphitiNode[];
+    episodeSummaries?: string[];
+    nodeRefs: string[];
+}
+export interface PersistentMemoryCacheMeta {
+    lastQuery?: string;
+    lastRefresh?: number;
+}
+export type CacheRefreshClassification = "miss" | "stale" | "primer-only" | "aligned" | "drifted";
+export interface CacheRefreshDecision {
+    classification: CacheRefreshClassification;
+    shouldRefresh: boolean;
+    similarity: number;
+    threshold: number;
+    cachedQuery: string | null;
+}
+export interface DrainQueueEntry {
+    sessionId: string;
+    groupId: string;
+    event: SessionEvent;
+}
+export interface ClaimedDrainBatch {
+    claimToken: string;
+    claimKey: string;
+    lockTtlSeconds: number;
+    entries: DrainQueueEntry[];
+}
+export interface PreparedSessionMemory {
+    envelope: string;
+    nodeRefs: string[];
+    refreshDecision: CacheRefreshDecision;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/script/src/types/index.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSessionEventRecallText = exports.getSessionEventPrimaryText = void 0;
+const compactEventText = (values) => [...new Set(values.map((value) => value?.trim()).filter(Boolean))]
+    .join(" ")
+    .trim();
+const metadataRecallText = (metadata) => {
+    if (!metadata)
+        return "";
+    const values = [];
+    for (const [key, value] of Object.entries(metadata).filter(([, value]) => typeof value === "string" || typeof value === "number" ||
+        typeof value === "boolean")) {
+        if (/^(eventType|tool|integration|cwd|status|result|reason)$/i.test(key)) {
+            values.push(String(value));
+        }
+    }
+    return values.join(" ");
+};
+const getSessionEventPrimaryText = (event, fallback) => event.continuityText?.trim() || event.detail?.trim() ||
+    event.summary.trim() ||
+    event.body?.trim() || fallback || "";
+exports.getSessionEventPrimaryText = getSessionEventPrimaryText;
+const getSessionEventRecallText = (event) => compactEventText([
+    event.summary,
+    event.continuityText,
+    event.detail,
+    event.refs?.join(" "),
+    event.keywords?.join(" "),
+    metadataRecallText(event.metadata),
+    event.category,
+    event.sourceKind,
+]);
+exports.getSessionEventRecallText = getSessionEventRecallText;

package/script/src/utils.d.ts

@@ -0,0 +1,27 @@
+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, directory?: 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;
+/**
+ * Truncate `text` to at most `budget` characters without cutting mid-line.
+ * Prefers to break at the last newline within the budget window; falls back
+ * to a raw slice only when the candidate contains no newline.
+ */
+export declare const truncateAtLineBoundary: (text: string, budget: number) => 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;AA0C7C;;GAEG;AACH,eAAO,MAAM,WAAW,GACtB,SAAS,MAAM,EACf,YAAW,MAAsB,KAChC,MAMF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAC1B,SAAS,MAAM,EACf,YAAW,MAAsB,KAChC,MAQF,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;AAErE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GACjC,MAAM,MAAM,EACZ,QAAQ,MAAM,KACb,MAKF,CAAC"}

package/script/src/utils.js

@@ -0,0 +1,87 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.truncateAtLineBoundary = exports.extractTextFromParts = exports.isTextPart = exports.makeUserGroupId = exports.makeGroupId = void 0;
+const node_os_1 = __importDefault(require("node:os"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_process_1 = __importDefault(require("node:process"));
+const getPathBasename = (value) => {
+    const trimmed = value.trim();
+    if (!trimmed)
+        return "";
+    const normalized = trimmed.replaceAll("\\", "/");
+    return node_path_1.default.posix.basename(normalized);
+};
+const getProjectName = (directory) => getPathBasename(directory) || "default";
+const toPascalCaseSegment = (value) => {
+    const words = value.match(/[\p{L}\p{N}]+/gu) ?? [];
+    const pascal = words.map((word) => {
+        if (!word)
+            return "";
+        const [first = "", ...rest] = Array.from(word);
+        return first.toLocaleUpperCase() + rest.join("").toLocaleLowerCase();
+    }).join("");
+    return pascal || "Default";
+};
+const sanitizeGroupSegment = (value) => value.replace(/[^A-Za-z0-9_]/g, "_");
+const sanitizeProjectSegment = (value) => value.replace(/[^\p{L}\p{N}_]/gu, "_");
+const getHomeDirectory = () => {
+    try {
+        return node_os_1.default.homedir();
+    }
+    catch {
+        return undefined;
+    }
+};
+const getUserName = () => getPathBasename(getHomeDirectory() ?? "") || undefined;
+/**
+ * Build a sanitized Graphiti group ID from a prefix and project directory.
+ */
+const makeGroupId = (prefix, directory = node_process_1.default.cwd()) => {
+    const projectName = sanitizeProjectSegment(toPascalCaseSegment(getProjectName(directory)));
+    const prefixPart = prefix ? `${sanitizeGroupSegment(prefix)}_` : "";
+    return `${prefixPart}${projectName}__main`;
+};
+exports.makeGroupId = makeGroupId;
+/**
+ * Build a sanitized Graphiti group ID from a prefix and user home directory.
+ */
+const makeUserGroupId = (prefix, directory = node_process_1.default.cwd()) => {
+    const projectName = sanitizeProjectSegment(toPascalCaseSegment(getProjectName(directory)));
+    const userName = getUserName() ?? "unknown";
+    const prefixPart = prefix ? `${sanitizeGroupSegment(prefix)}_` : "";
+    const userSegment = sanitizeGroupSegment(userName);
+    return `${prefixPart}${projectName}__user_${userSegment}`;
+};
+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;
+/**
+ * Truncate `text` to at most `budget` characters without cutting mid-line.
+ * Prefers to break at the last newline within the budget window; falls back
+ * to a raw slice only when the candidate contains no newline.
+ */
+const truncateAtLineBoundary = (text, budget) => {
+    if (text.length <= budget)
+        return text;
+    const candidate = text.slice(0, budget);
+    const lastNl = candidate.lastIndexOf("\n");
+    return lastNl > 0 ? candidate.slice(0, lastNl) : candidate;
+};
+exports.truncateAtLineBoundary = truncateAtLineBoundary;