opencode-memory-plugin 0.1.0

package/dist/tools/memory-timeline.d.ts

@@ -0,0 +1,10 @@
+import { type ToolDefinition } from "@opencode-ai/plugin";
+import { MemoryStore } from "../storage/store";
+/**
+ * Creates the chronological memory timeline tool.
+ *
+ * @param store - Memory store.
+ * @returns Tool definition.
+ */
+export declare function createMemoryTimelineTool(store: MemoryStore): ToolDefinition;
+//# sourceMappingURL=memory-timeline.d.ts.map

package/dist/tools/memory-timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-timeline.d.ts","sourceRoot":"","sources":["../../src/tools/memory-timeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAG9C;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,CA+C3E"}

package/dist/tools/memory-timeline.js

@@ -0,0 +1,49 @@
+import { tool } from "@opencode-ai/plugin";
+import { MemoryStore } from "../storage/store";
+import { formatTimestamp } from "../utils";
+/**
+ * Creates the chronological memory timeline tool.
+ *
+ * @param store - Memory store.
+ * @returns Tool definition.
+ */
+export function createMemoryTimelineTool(store) {
+    return tool({
+        description: "Browse persistent project memory chronologically. Useful for understanding the sequence of prior work and narrowing by time range.",
+        args: {
+            limit: tool.schema.number().int().min(1).max(100).optional(),
+            before: tool.schema.string().datetime().optional(),
+            after: tool.schema.string().datetime().optional(),
+            sessionId: tool.schema.string().optional(),
+        },
+        async execute(args, context) {
+            await store.incrementToolUsage(context.sessionID, "memory_timeline");
+            const before = args.before ? Date.parse(args.before) : undefined;
+            const after = args.after ? Date.parse(args.after) : undefined;
+            if ((args.before && Number.isNaN(before)) || (args.after && Number.isNaN(after))) {
+                return "Invalid ISO datetime provided to memory_timeline.";
+            }
+            const page = await store.getTimeline({
+                limit: args.limit ?? 20,
+                before,
+                after,
+                sessionId: args.sessionId,
+            });
+            if (!page.observations.length) {
+                return "No memories found for the requested timeline filters.";
+            }
+            const sections = new Map();
+            for (const observation of page.observations) {
+                const date = new Date(observation.createdAt).toISOString().slice(0, 10);
+                const lines = sections.get(date) ?? [];
+                lines.push(`[${observation.id}] ${formatTimestamp(observation.createdAt)} — ${observation.title} (${observation.type}) — ${observation.subtitle ?? "No subtitle"}`);
+                sections.set(date, lines);
+            }
+            const body = [...sections.entries()]
+                .map(([date, lines]) => `=== ${date} ===\n${lines.join("\n")}`)
+                .join("\n\n");
+            return page.nextCursor ? `${body}\n\nNext cursor: ${page.nextCursor}` : body;
+        },
+    });
+}
+//# sourceMappingURL=memory-timeline.js.map

package/dist/tools/memory-timeline.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,178 @@
+import type { OpencodeClient } from "@opencode-ai/sdk";
+import type { LanguageModel } from "ai";
+export declare const OBSERVATION_TYPES: readonly ["tool_output", "file_change", "error", "decision"];
+export declare const PENDING_STATUSES: readonly ["pending", "processing", "processed", "failed"];
+export declare const OBSERVATION_QUALITIES: readonly ["high", "medium", "low"];
+export type ObservationType = (typeof OBSERVATION_TYPES)[number];
+export type PendingStatus = (typeof PENDING_STATUSES)[number];
+export type ObservationQuality = (typeof OBSERVATION_QUALITIES)[number];
+export type DeletionInitiator = "user" | "retention_cleanup";
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export interface ProjectScope {
+    projectId: string;
+    projectRoot: string;
+    directory: string;
+}
+export interface PluginConfig {
+    dbPath: string;
+    indexSize: number;
+    sampleSize: number;
+    maxPendingRetries: number;
+    compressionModel: string | null;
+    maxRawContentSize: number;
+    enableSemanticSearch: boolean;
+    privacyStrip: boolean;
+    minContentLength: number;
+    compressionBatchSize: number;
+    retentionDays: number;
+    contextMaxTokens: number;
+    summaryLookback: number;
+    orphanThresholdMs: number;
+    queuePollIntervalMs: number;
+    sessionSummaryDebounceMs: number;
+    logLevel: LogLevel;
+    configPaths: string[];
+}
+export interface ModelSelection {
+    raw: string;
+    providerID: string;
+    modelID: string;
+}
+export interface Observation {
+    id: string;
+    projectId: string;
+    projectRoot: string;
+    sessionId: string;
+    type: ObservationType;
+    title: string;
+    subtitle: string | null;
+    narrative: string;
+    facts: string[];
+    concepts: string[];
+    filesInvolved: string[];
+    rawTokenCount: number;
+    compressedTokenCount: number;
+    toolName: string | null;
+    modelUsed: string | null;
+    quality: ObservationQuality;
+    rawFallback: string | null;
+    createdAt: number;
+}
+export interface QualityResult {
+    quality: ObservationQuality;
+    flags: string[];
+}
+export interface PendingMessage {
+    id: string;
+    projectId: string;
+    projectRoot: string;
+    sessionId: string;
+    toolName: string;
+    title: string | null;
+    rawContent: string;
+    rawMetadata: Record<string, unknown> | null;
+    status: PendingStatus;
+    retryCount: number;
+    errorMessage: string | null;
+    createdAt: number;
+    processedAt: number | null;
+}
+export interface SessionSummary {
+    id: string;
+    projectId: string;
+    projectRoot: string;
+    sessionId: string;
+    requested: string | null;
+    investigated: string | null;
+    learned: string | null;
+    completed: string | null;
+    nextSteps: string | null;
+    observationCount: number;
+    modelUsed: string | null;
+    createdAt: number;
+}
+export interface UserPromptRecord {
+    id: string;
+    projectId: string;
+    projectRoot: string;
+    sessionId: string;
+    messageId: string;
+    content: string;
+    createdAt: number;
+}
+export interface DeletionLogEntry {
+    id: string;
+    projectId: string;
+    projectRoot: string;
+    timestamp: number;
+    criteria: string;
+    count: number;
+    initiator: DeletionInitiator;
+}
+export interface ToolUsageStat {
+    id: string;
+    projectId: string;
+    projectRoot: string;
+    sessionId: string;
+    toolName: string;
+    callCount: number;
+    createdAt: number;
+}
+export interface MemorySearchResult {
+    id: string;
+    title: string;
+    subtitle: string | null;
+    type: ObservationType;
+    createdAt: number;
+    toolName: string | null;
+    quality: ObservationQuality;
+}
+export interface TimelineQuery {
+    limit: number;
+    before?: number;
+    after?: number;
+    sessionId?: string;
+}
+export interface TimelinePage {
+    observations: Observation[];
+    nextCursor: string | null;
+}
+export interface CompressionResult {
+    text: string;
+    modelUsed: string | null;
+}
+export interface ObservationCompressor {
+    compressObservation(input: {
+        pendingMessage: PendingMessage;
+        prompt: string;
+        model: ModelSelection | null;
+        abortSignal?: AbortSignal;
+    }): Promise<CompressionResult>;
+    summarizeSession(input: {
+        sessionId: string;
+        prompt: string;
+        model: ModelSelection | null;
+        abortSignal?: AbortSignal;
+    }): Promise<CompressionResult>;
+}
+export interface MemoryPluginOptions {
+    compressor?: ObservationCompressor;
+    languageModel?: LanguageModel;
+    now?: () => number;
+}
+export interface RuntimeState {
+    internalSessionIds: Set<string>;
+    injectedSessionIds: Set<string>;
+    knownSessionIds: Set<string>;
+    summaryTimers: Map<string, ReturnType<typeof setTimeout>>;
+    shutdownRegistered: boolean;
+    disposed: boolean;
+}
+export interface PluginBootstrapContext {
+    client: OpencodeClient;
+    directory: string;
+    worktree: string;
+    projectId: string;
+    now: () => number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,4 @@
+export const OBSERVATION_TYPES = ["tool_output", "file_change", "error", "decision"];
+export const PENDING_STATUSES = ["pending", "processing", "processed", "failed"];
+export const OBSERVATION_QUALITIES = ["high", "medium", "low"];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,aAAa,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,CAAU,CAAA;AAE7F,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,CAAU,CAAA;AAEzF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAU,CAAA"}

package/dist/utils.d.ts

@@ -0,0 +1,130 @@
+import type { ModelSelection } from "./types";
+/**
+ * Creates a sortable identifier using the current timestamp and a UUID.
+ *
+ * @param now - Function that returns the current epoch time in milliseconds.
+ * @returns A lexicographically sortable identifier.
+ */
+export declare function createSortableId(now: () => number): string;
+/**
+ * Estimates token usage using a simple character-based heuristic.
+ *
+ * @param value - Text that should be converted into an estimated token count.
+ * @returns The estimated token count.
+ */
+export declare function estimateTokenCount(value: string): number;
+/**
+ * Resolves a path that may start with `~` into an absolute filesystem path.
+ *
+ * @param value - Path to resolve.
+ * @returns The resolved absolute or original path.
+ */
+export declare function resolveHomePath(value: string): string;
+/**
+ * Returns the default OpenCode config directory using XDG semantics.
+ *
+ * @returns The resolved OpenCode config directory.
+ */
+export declare function getOpenCodeConfigDirectory(): string;
+/**
+ * Ensures that the parent directory of a file path exists.
+ *
+ * @param filePath - File path whose parent should be created.
+ * @returns A promise that resolves after the directory exists.
+ */
+export declare function ensureParentDirectory(filePath: string): Promise<void>;
+/**
+ * Parses a JSON or JSONC file into a typed object.
+ *
+ * @param filePath - File path to read.
+ * @returns The parsed object.
+ */
+export declare function readJsonFile<T>(filePath: string): Promise<T>;
+/**
+ * Removes JSONC line and block comments while preserving string contents.
+ *
+ * @param value - Raw JSONC string.
+ * @returns A JSON string without comments.
+ */
+export declare function stripJsonComments(value: string): string;
+/**
+ * Parses a JSON value with a typed fallback.
+ *
+ * @param value - JSON text or nullish value.
+ * @param fallback - Fallback value when parsing fails.
+ * @returns The parsed value or the fallback.
+ */
+export declare function parseJsonValue<T>(value: string | null | undefined, fallback: T): T;
+/**
+ * Serializes any JSON-compatible value.
+ *
+ * @param value - Value to serialize.
+ * @returns A JSON string.
+ */
+export declare function serializeJson(value: unknown): string;
+/**
+ * Strips markdown code fences from an LLM response.
+ *
+ * @param value - Raw model output.
+ * @returns The unfenced content.
+ */
+export declare function stripMarkdownFences(value: string): string;
+/**
+ * Collapses repeated whitespace for more compact storage and prompts.
+ *
+ * @param value - Raw string.
+ * @returns Normalized text.
+ */
+export declare function normalizeWhitespace(value: string): string;
+/**
+ * Delays execution for a fixed number of milliseconds.
+ *
+ * @param milliseconds - Delay duration.
+ * @returns A promise that resolves after the delay.
+ */
+export declare function delay(milliseconds: number): Promise<void>;
+/**
+ * Formats a relative time label from a timestamp.
+ *
+ * @param value - Epoch time in milliseconds.
+ * @param now - Reference clock.
+ * @returns A relative time label.
+ */
+export declare function formatRelativeTime(value: number, now: () => number): string;
+/**
+ * Formats a timestamp as a local ISO-like date time string.
+ *
+ * @param value - Epoch time in milliseconds.
+ * @returns A formatted date time string.
+ */
+export declare function formatTimestamp(value: number): string;
+/**
+ * Builds a safe FTS5 MATCH query from arbitrary user text.
+ *
+ * @param value - Raw user query.
+ * @returns A sanitized FTS5 query string.
+ */
+export declare function sanitizeFtsQuery(value: string): string;
+/**
+ * Parses a `provider/model` string into the model object expected by the SDK.
+ *
+ * @param value - Model string from configuration.
+ * @returns A parsed model selection or null when invalid.
+ */
+export declare function parseModelString(value: string | null | undefined): ModelSelection | null;
+/**
+ * Converts an absolute path into a worktree-relative path when possible.
+ *
+ * @param value - Path to normalize.
+ * @param worktree - Project root.
+ * @returns A relative or original path.
+ */
+export declare function normalizeProjectPath(value: string, worktree: string): string;
+/**
+ * Checks whether a string likely contains binary-like output.
+ *
+ * @param value - Output text to inspect.
+ * @returns True when the content should be skipped.
+ */
+export declare function isProbablyBinary(value: string): boolean;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAM7C;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,MAAM,GAAG,MAAM,CAG1D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUrD;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAOnD;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3E;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAGlE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAmEvD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAUlF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOzD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;;GAKG;AACH,wBAAsB,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,MAAM,GAAG,MAAM,CAmB3E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQrD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUtD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,cAAc,GAAG,IAAI,CAexF;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAc5E;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAgBvD"}