opencode-memory-plugin 0.1.0

package/dist/hooks/events.d.ts

@@ -0,0 +1,52 @@
+import type { Hooks } from "@opencode-ai/plugin";
+import type { Event } from "@opencode-ai/sdk";
+import type { CompressionPipeline } from "../compression/pipeline";
+import type { MemoryLogger } from "../logger";
+import type { PluginConfig, RuntimeState } from "../types";
+/**
+ * Creates the event hook that manages session lifecycle and queue recovery.
+ *
+ * @param pipeline - Compression pipeline.
+ * @param config - Plugin configuration.
+ * @param state - Runtime state.
+ * @param logger - Structured logger.
+ * @returns Hook implementation.
+ */
+export declare function createEventHook(pipeline: CompressionPipeline, config: PluginConfig, state: RuntimeState, logger: MemoryLogger): NonNullable<Hooks["event"]>;
+/**
+ * Registers a graceful shutdown handler once for the plugin process.
+ *
+ * @param pipeline - Compression pipeline.
+ * @param state - Runtime state.
+ * @param logger - Structured logger.
+ * @returns Nothing.
+ */
+export declare function registerShutdown(pipeline: CompressionPipeline, state: RuntimeState, logger: MemoryLogger): void;
+/**
+ * Schedules summary generation after a debounce interval.
+ *
+ * @param sessionId - OpenCode session identifier.
+ * @param pipeline - Compression pipeline.
+ * @param config - Plugin configuration.
+ * @param state - Runtime state.
+ * @param logger - Structured logger.
+ * @returns Nothing.
+ */
+export declare function scheduleSummary(sessionId: string, pipeline: CompressionPipeline, config: PluginConfig, state: RuntimeState, logger: MemoryLogger): void;
+/**
+ * Clears a scheduled summary timer.
+ *
+ * @param sessionId - OpenCode session identifier.
+ * @param state - Runtime state.
+ * @returns Nothing.
+ */
+export declare function clearSummaryTimer(sessionId: string, state: RuntimeState): void;
+/**
+ * Checks whether an event belongs to an internal compressor session.
+ *
+ * @param event - OpenCode event.
+ * @param state - Runtime state.
+ * @returns True when the event should be ignored.
+ */
+export declare function isInternalEvent(event: Event, state: RuntimeState): boolean;
+//# sourceMappingURL=events.d.ts.map

package/dist/hooks/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/hooks/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAE1D;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,YAAY,GACnB,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAiC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,mBAAmB,EAC7B,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,YAAY,GACnB,IAAI,CA0BN;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,YAAY,GACnB,IAAI,CAoBN;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAQ9E;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAa1E"}

package/dist/hooks/events.js

@@ -0,0 +1,138 @@
+/**
+ * Creates the event hook that manages session lifecycle and queue recovery.
+ *
+ * @param pipeline - Compression pipeline.
+ * @param config - Plugin configuration.
+ * @param state - Runtime state.
+ * @param logger - Structured logger.
+ * @returns Hook implementation.
+ */
+export function createEventHook(pipeline, config, state, logger) {
+    return async ({ event }) => {
+        if (isInternalEvent(event, state)) {
+            return;
+        }
+        switch (event.type) {
+            case "session.created": {
+                state.knownSessionIds.add(event.properties.info.id);
+                break;
+            }
+            case "session.idle": {
+                scheduleSummary(event.properties.sessionID, pipeline, config, state, logger);
+                break;
+            }
+            case "session.deleted": {
+                clearSummaryTimer(event.properties.info.id, state);
+                state.injectedSessionIds.delete(event.properties.info.id);
+                state.knownSessionIds.delete(event.properties.info.id);
+                break;
+            }
+            case "session.compacted": {
+                scheduleSummary(event.properties.sessionID, pipeline, config, state, logger);
+                break;
+            }
+            default:
+                break;
+        }
+    };
+}
+/**
+ * Registers a graceful shutdown handler once for the plugin process.
+ *
+ * @param pipeline - Compression pipeline.
+ * @param state - Runtime state.
+ * @param logger - Structured logger.
+ * @returns Nothing.
+ */
+export function registerShutdown(pipeline, state, logger) {
+    if (state.shutdownRegistered) {
+        return;
+    }
+    state.shutdownRegistered = true;
+    const shutdown = async () => {
+        if (state.disposed) {
+            return;
+        }
+        state.disposed = true;
+        try {
+            await pipeline.processQueue();
+            await logger.info("Memory plugin shutdown complete");
+        }
+        catch (error) {
+            await logger.error("Memory plugin shutdown failed", {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    };
+    process.on("SIGTERM", () => void shutdown());
+    process.on("SIGINT", () => void shutdown());
+    process.on("beforeExit", () => void shutdown());
+}
+/**
+ * Schedules summary generation after a debounce interval.
+ *
+ * @param sessionId - OpenCode session identifier.
+ * @param pipeline - Compression pipeline.
+ * @param config - Plugin configuration.
+ * @param state - Runtime state.
+ * @param logger - Structured logger.
+ * @returns Nothing.
+ */
+export function scheduleSummary(sessionId, pipeline, config, state, logger) {
+    clearSummaryTimer(sessionId, state);
+    const timer = setTimeout(() => {
+        void (async () => {
+            try {
+                await pipeline.flushSession(sessionId, 30_000);
+                await pipeline.generateSessionSummary(sessionId);
+            }
+            catch (error) {
+                await logger.warn("Failed to generate session summary", {
+                    sessionId,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+            finally {
+                clearSummaryTimer(sessionId, state);
+            }
+        })();
+    }, config.sessionSummaryDebounceMs);
+    state.summaryTimers.set(sessionId, timer);
+}
+/**
+ * Clears a scheduled summary timer.
+ *
+ * @param sessionId - OpenCode session identifier.
+ * @param state - Runtime state.
+ * @returns Nothing.
+ */
+export function clearSummaryTimer(sessionId, state) {
+    const timer = state.summaryTimers.get(sessionId);
+    if (!timer) {
+        return;
+    }
+    clearTimeout(timer);
+    state.summaryTimers.delete(sessionId);
+}
+/**
+ * Checks whether an event belongs to an internal compressor session.
+ *
+ * @param event - OpenCode event.
+ * @param state - Runtime state.
+ * @returns True when the event should be ignored.
+ */
+export function isInternalEvent(event, state) {
+    switch (event.type) {
+        case "session.created":
+        case "session.updated":
+        case "session.deleted":
+            return state.internalSessionIds.has(event.properties.info.id);
+        case "session.idle":
+        case "session.compacted":
+        case "session.status":
+            return state.internalSessionIds.has(event.properties.sessionID);
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/hooks/events.js.map

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

package/dist/hooks/system-transform.d.ts

@@ -0,0 +1,14 @@
+import type { Hooks } from "@opencode-ai/plugin";
+import { MemoryStore } from "../storage/store";
+import type { PluginConfig, RuntimeState } from "../types";
+/**
+ * Creates the system prompt transform that injects memory context once per session.
+ *
+ * @param store - Memory store.
+ * @param config - Plugin configuration.
+ * @param state - Runtime state.
+ * @param now - Clock function.
+ * @returns Hook implementation.
+ */
+export declare function createSystemTransformHook(store: MemoryStore, config: PluginConfig, state: RuntimeState, now: () => number): NonNullable<Hooks["experimental.chat.system.transform"]>;
+//# sourceMappingURL=system-transform.d.ts.map

package/dist/hooks/system-transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-transform.d.ts","sourceRoot":"","sources":["../../src/hooks/system-transform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAEhD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAE1D;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,MAAM,MAAM,GAChB,WAAW,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC,CAe1D"}

package/dist/hooks/system-transform.js

@@ -0,0 +1,26 @@
+import { generateSessionContext } from "../context/generator";
+import { MemoryStore } from "../storage/store";
+/**
+ * Creates the system prompt transform that injects memory context once per session.
+ *
+ * @param store - Memory store.
+ * @param config - Plugin configuration.
+ * @param state - Runtime state.
+ * @param now - Clock function.
+ * @returns Hook implementation.
+ */
+export function createSystemTransformHook(store, config, state, now) {
+    return async (input, output) => {
+        const sessionId = input.sessionID;
+        if (!sessionId || state.internalSessionIds.has(sessionId) || state.injectedSessionIds.has(sessionId)) {
+            return;
+        }
+        const context = await generateSessionContext(store, config, now);
+        if (!context) {
+            return;
+        }
+        output.system.unshift(context);
+        state.injectedSessionIds.add(sessionId);
+    };
+}
+//# sourceMappingURL=system-transform.js.map

package/dist/hooks/system-transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-transform.js","sourceRoot":"","sources":["../../src/hooks/system-transform.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAG9C;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CACvC,KAAkB,EAClB,MAAoB,EACpB,KAAmB,EACnB,GAAiB;IAEjB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC7B,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAA;QACjC,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACrG,OAAM;QACR,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,CAAA;QAChE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAM;QACR,CAAC;QAED,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QAC9B,KAAK,CAAC,kBAAkB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IACzC,CAAC,CAAA;AACH,CAAC"}

package/dist/hooks/tool-after.d.ts

@@ -0,0 +1,26 @@
+import type { Hooks } from "@opencode-ai/plugin";
+import { MemoryStore } from "../storage/store";
+import type { MemoryLogger } from "../logger";
+import type { CompressionPipeline } from "../compression/pipeline";
+import type { PluginConfig, ProjectScope, RuntimeState } from "../types";
+/**
+ * Creates the hook that captures tool outputs and enqueues them for compression.
+ *
+ * @param store - Memory store.
+ * @param pipeline - Compression pipeline.
+ * @param scope - Project scope.
+ * @param config - Plugin configuration.
+ * @param state - Runtime state.
+ * @param logger - Structured logger.
+ * @param now - Clock function.
+ * @returns Hook implementation.
+ */
+export declare function createToolExecuteAfterHook(store: MemoryStore, pipeline: CompressionPipeline, scope: ProjectScope, config: PluginConfig, state: RuntimeState, logger: MemoryLogger, now: () => number): NonNullable<Hooks["tool.execute.after"]>;
+/**
+ * Checks whether a tool output should be skipped from persistent memory capture.
+ *
+ * @param toolName - Executed tool name.
+ * @returns True when the tool is intentionally ignored.
+ */
+export declare function shouldIgnoreTool(toolName: string): boolean;
+//# sourceMappingURL=tool-after.d.ts.map

package/dist/hooks/tool-after.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-after.d.ts","sourceRoot":"","sources":["../../src/hooks/tool-after.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAOxE;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,mBAAmB,EAC7B,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,YAAY,EACpB,GAAG,EAAE,MAAM,MAAM,GAChB,WAAW,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,CA8D1C;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAM1D"}

package/dist/hooks/tool-after.js

@@ -0,0 +1,88 @@
+import { MemoryStore } from "../storage/store";
+import { isProbablyBinary, normalizeWhitespace } from "../utils";
+import { stripSensitiveTokens } from "../compression/privacy";
+const IGNORED_TOOL_PREFIXES = ["memory_"];
+const IGNORED_TOOL_NAMES = new Set(["todowrite"]);
+/**
+ * Creates the hook that captures tool outputs and enqueues them for compression.
+ *
+ * @param store - Memory store.
+ * @param pipeline - Compression pipeline.
+ * @param scope - Project scope.
+ * @param config - Plugin configuration.
+ * @param state - Runtime state.
+ * @param logger - Structured logger.
+ * @param now - Clock function.
+ * @returns Hook implementation.
+ */
+export function createToolExecuteAfterHook(store, pipeline, scope, config, state, logger, now) {
+    return async (input, output) => {
+        if (state.internalSessionIds.has(input.sessionID)) {
+            return;
+        }
+        if (shouldIgnoreTool(input.tool)) {
+            return;
+        }
+        const rawOutput = output.output ?? "";
+        if (!rawOutput || rawOutput.length < config.minContentLength) {
+            return;
+        }
+        if (isProbablyBinary(rawOutput)) {
+            await logger.warn("Skipped binary-like tool output", {
+                tool: input.tool,
+                sessionId: input.sessionID,
+            });
+            return;
+        }
+        const content = config.privacyStrip ? stripSensitiveTokens(rawOutput) : rawOutput;
+        const truncated = content.slice(0, config.maxRawContentSize);
+        if (!normalizeWhitespace(truncated)) {
+            return;
+        }
+        try {
+            await store.enqueuePending({
+                id: store.createId(),
+                projectId: scope.projectId,
+                projectRoot: scope.projectRoot,
+                sessionId: input.sessionID,
+                toolName: input.tool,
+                title: output.title || null,
+                rawContent: truncated,
+                rawMetadata: {
+                    callID: input.callID,
+                    args: input.args,
+                    metadata: output.metadata,
+                    title: output.title,
+                },
+                status: "pending",
+                retryCount: 0,
+                errorMessage: null,
+                createdAt: now(),
+                processedAt: null,
+            });
+            queueMicrotask(() => {
+                void pipeline.processQueue();
+            });
+        }
+        catch (error) {
+            await logger.error("Failed to enqueue tool output", {
+                tool: input.tool,
+                sessionId: input.sessionID,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    };
+}
+/**
+ * Checks whether a tool output should be skipped from persistent memory capture.
+ *
+ * @param toolName - Executed tool name.
+ * @returns True when the tool is intentionally ignored.
+ */
+export function shouldIgnoreTool(toolName) {
+    if (IGNORED_TOOL_NAMES.has(toolName)) {
+        return true;
+    }
+    return IGNORED_TOOL_PREFIXES.some((prefix) => toolName.startsWith(prefix));
+}
+//# sourceMappingURL=tool-after.js.map

package/dist/hooks/tool-after.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import type { Plugin } from "@opencode-ai/plugin";
+import type { MemoryPluginOptions } from "./types";
+/**
+ * Creates the OpenCode persistent memory plugin.
+ *
+ * @param options - Optional advanced overrides for testing or custom models.
+ * @returns A plugin function compatible with OpenCode.
+ */
+export declare function createMemoryPlugin(options?: MemoryPluginOptions): Plugin;
+export declare const MemoryPlugin: Plugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,qBAAqB,CAAA;AAiB9D,OAAO,KAAK,EAAE,mBAAmB,EAAgB,MAAM,SAAS,CAAA;AAEhE;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,CA6E5E;AAED,eAAO,MAAM,YAAY,EAAE,MAA6B,CAAA"}

package/dist/index.js

@@ -0,0 +1,79 @@
+import { loadConfig } from "./config";
+import { LanguageModelObservationCompressor, SessionPromptObservationCompressor } from "./compression/compressor";
+import { CompressionPipeline } from "./compression/pipeline";
+import { createCompactionHook } from "./hooks/compaction";
+import { createEventHook, registerShutdown } from "./hooks/events";
+import { createChatMessageHook } from "./hooks/chat-message";
+import { createSystemTransformHook } from "./hooks/system-transform";
+import { createToolExecuteAfterHook } from "./hooks/tool-after";
+import { MemoryLogger } from "./logger";
+import { createMemoryDatabase } from "./storage/db";
+import { MemoryStore } from "./storage/store";
+import { createMemoryGetTool } from "./tools/memory-get";
+import { createMemoryForgetTool } from "./tools/memory-forget";
+import { createMemorySearchTool } from "./tools/memory-search";
+import { createMemoryStatsTool } from "./tools/memory-stats";
+import { createMemoryTimelineTool } from "./tools/memory-timeline";
+/**
+ * Creates the OpenCode persistent memory plugin.
+ *
+ * @param options - Optional advanced overrides for testing or custom models.
+ * @returns A plugin function compatible with OpenCode.
+ */
+export function createMemoryPlugin(options = {}) {
+    return async (input) => {
+        const now = options.now ?? Date.now;
+        const pluginConfig = await loadConfig({
+            directory: input.directory,
+            worktree: input.worktree,
+        });
+        const scope = {
+            projectId: input.project.id,
+            projectRoot: input.worktree,
+            directory: input.directory,
+        };
+        const database = await createMemoryDatabase(pluginConfig.dbPath);
+        const store = new MemoryStore(database, scope, now);
+        const logger = new MemoryLogger(input.client, input.directory, pluginConfig.logLevel);
+        const state = {
+            internalSessionIds: new Set(),
+            injectedSessionIds: new Set(),
+            knownSessionIds: new Set(),
+            summaryTimers: new Map(),
+            shutdownRegistered: false,
+            disposed: false,
+        };
+        const compressor = options.compressor ??
+            (options.languageModel
+                ? new LanguageModelObservationCompressor(options.languageModel)
+                : new SessionPromptObservationCompressor(input, state));
+        const pipeline = new CompressionPipeline(store, compressor, input.client, input.directory, pluginConfig, logger, now);
+        await pipeline.recoverOrphans();
+        await store.cleanupOldData(pluginConfig.retentionDays);
+        queueMicrotask(() => {
+            void pipeline.processQueue();
+        });
+        registerShutdown(pipeline, state, logger);
+        void logger.info("Persistent memory plugin initialized", {
+            dbPath: pluginConfig.dbPath,
+            compressionModel: pluginConfig.compressionModel,
+            configPaths: pluginConfig.configPaths,
+        });
+        return {
+            tool: {
+                memory_search: createMemorySearchTool(store, now),
+                memory_timeline: createMemoryTimelineTool(store),
+                memory_get: createMemoryGetTool(store),
+                memory_forget: createMemoryForgetTool(store, now),
+                memory_stats: createMemoryStatsTool(store, now),
+            },
+            event: createEventHook(pipeline, pluginConfig, state, logger),
+            "chat.message": createChatMessageHook(store, scope, state, now),
+            "tool.execute.after": createToolExecuteAfterHook(store, pipeline, scope, pluginConfig, state, logger, now),
+            "experimental.chat.system.transform": createSystemTransformHook(store, pluginConfig, state, now),
+            "experimental.session.compacting": createCompactionHook(store, state, now),
+        };
+    };
+}
+export const MemoryPlugin = createMemoryPlugin();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,60 @@
+import type { OpencodeClient } from "@opencode-ai/sdk";
+import type { LogLevel } from "./types";
+/**
+ * Writes structured log entries through the OpenCode SDK client.
+ */
+export declare class MemoryLogger {
+    private readonly client;
+    private readonly directory;
+    private readonly level;
+    constructor(client: OpencodeClient, directory: string, level: LogLevel);
+    /**
+     * Writes a debug log entry.
+     *
+     * @param message - Human readable message.
+     * @param extra - Additional structured metadata.
+     * @returns A promise that resolves when the log attempt completes.
+     */
+    debug(message: string, extra?: Record<string, unknown>): Promise<void>;
+    /**
+     * Writes an info log entry.
+     *
+     * @param message - Human readable message.
+     * @param extra - Additional structured metadata.
+     * @returns A promise that resolves when the log attempt completes.
+     */
+    info(message: string, extra?: Record<string, unknown>): Promise<void>;
+    /**
+     * Writes a warning log entry.
+     *
+     * @param message - Human readable message.
+     * @param extra - Additional structured metadata.
+     * @returns A promise that resolves when the log attempt completes.
+     */
+    warn(message: string, extra?: Record<string, unknown>): Promise<void>;
+    /**
+     * Writes an error log entry.
+     *
+     * @param message - Human readable message.
+     * @param extra - Additional structured metadata.
+     * @returns A promise that resolves when the log attempt completes.
+     */
+    error(message: string, extra?: Record<string, unknown>): Promise<void>;
+    /**
+     * Writes a log entry if the requested level is enabled.
+     *
+     * @param level - Log level for the entry.
+     * @param message - Human readable message.
+     * @param extra - Additional structured metadata.
+     * @returns A promise that resolves when the log attempt completes.
+     */
+    write(level: LogLevel, message: string, extra?: Record<string, unknown>): Promise<void>;
+    /**
+     * Checks whether a log level should be emitted.
+     *
+     * @param level - Candidate log level.
+     * @returns True when the entry should be logged.
+     */
+    shouldLog(level: LogLevel): boolean;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AASvC;;GAEG;AACH,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAFL,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,QAAQ;IAGlC;;;;;;OAMG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5E;;;;;;OAMG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3E;;;;;;OAMG;IACG,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3E;;;;;;OAMG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5E;;;;;;;OAOG;IACG,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB7F;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;CAGpC"}

package/dist/logger.js

@@ -0,0 +1,91 @@
+const LEVEL_ORDER = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+};
+/**
+ * Writes structured log entries through the OpenCode SDK client.
+ */
+export class MemoryLogger {
+    client;
+    directory;
+    level;
+    constructor(client, directory, level) {
+        this.client = client;
+        this.directory = directory;
+        this.level = level;
+    }
+    /**
+     * Writes a debug log entry.
+     *
+     * @param message - Human readable message.
+     * @param extra - Additional structured metadata.
+     * @returns A promise that resolves when the log attempt completes.
+     */
+    async debug(message, extra) {
+        await this.write("debug", message, extra);
+    }
+    /**
+     * Writes an info log entry.
+     *
+     * @param message - Human readable message.
+     * @param extra - Additional structured metadata.
+     * @returns A promise that resolves when the log attempt completes.
+     */
+    async info(message, extra) {
+        await this.write("info", message, extra);
+    }
+    /**
+     * Writes a warning log entry.
+     *
+     * @param message - Human readable message.
+     * @param extra - Additional structured metadata.
+     * @returns A promise that resolves when the log attempt completes.
+     */
+    async warn(message, extra) {
+        await this.write("warn", message, extra);
+    }
+    /**
+     * Writes an error log entry.
+     *
+     * @param message - Human readable message.
+     * @param extra - Additional structured metadata.
+     * @returns A promise that resolves when the log attempt completes.
+     */
+    async error(message, extra) {
+        await this.write("error", message, extra);
+    }
+    /**
+     * Writes a log entry if the requested level is enabled.
+     *
+     * @param level - Log level for the entry.
+     * @param message - Human readable message.
+     * @param extra - Additional structured metadata.
+     * @returns A promise that resolves when the log attempt completes.
+     */
+    async write(level, message, extra) {
+        if (!this.shouldLog(level)) {
+            return;
+        }
+        await this.client.app.log({
+            query: { directory: this.directory },
+            body: {
+                service: "plugin-memory",
+                level,
+                message,
+                extra,
+            },
+        });
+    }
+    /**
+     * Checks whether a log level should be emitted.
+     *
+     * @param level - Candidate log level.
+     * @returns True when the entry should be logged.
+     */
+    shouldLog(level) {
+        return LEVEL_ORDER[level] >= LEVEL_ORDER[this.level];
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,GAA6B;IAC5C,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;CACV,CAAA;AAED;;GAEG;AACH,MAAM,OAAO,YAAY;IAEJ;IACA;IACA;IAHnB,YACmB,MAAsB,EACtB,SAAiB,EACjB,KAAe;QAFf,WAAM,GAAN,MAAM,CAAgB;QACtB,cAAS,GAAT,SAAS,CAAQ;QACjB,UAAK,GAAL,KAAK,CAAU;IAC/B,CAAC;IAEJ;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,CAAC,OAAe,EAAE,KAA+B;QAC1D,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;IAC3C,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CAAC,OAAe,EAAE,KAA+B;QACzD,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;IAC1C,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CAAC,OAAe,EAAE,KAA+B;QACzD,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;IAC1C,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,CAAC,OAAe,EAAE,KAA+B;QAC1D,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAA;IAC3C,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,KAAK,CAAC,KAAe,EAAE,OAAe,EAAE,KAA+B;QAC3E,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAM;QACR,CAAC;QAED,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;YACxB,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE;YACpC,IAAI,EAAE;gBACJ,OAAO,EAAE,eAAe;gBACxB,KAAK;gBACL,OAAO;gBACP,KAAK;aACN;SACF,CAAC,CAAA;IACJ,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,KAAe;QACvB,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACtD,CAAC;CACF"}