@scitrera/memorylayer-opencode-plugin 0.1.22

package/dist/src/hooks/tool.js

@@ -0,0 +1,168 @@
+/**
+ * Tool execution hooks for MemoryLayer OpenCode plugin.
+ *
+ * Before-tool: Injects relevant memory context for write/delegation tools.
+ * After-tool: Silently captures tool observations as working memory.
+ */
+import { getClient, checkHealth } from "../shared/client.js";
+import { formatRecallResult, formatStorageGuidance } from "../shared/formatters.js";
+import { shouldSkipTool, buildObservation, } from "../shared/observation.js";
+import { wasQueryRecalledThisTurn, markRecallDone, getCurrentTopic, getCurrentPrompt, } from "../shared/state.js";
+// ---------------------------------------------------------------------------
+// Before-tool hook
+// ---------------------------------------------------------------------------
+/**
+ * Handle pre-tool execution for task/delegation tools.
+ * Returns context text to prepend to tool description, or null.
+ */
+async function handleTaskTool(toolArgs) {
+    const taskPrompt = (toolArgs.prompt || toolArgs.description || "");
+    if (!taskPrompt) {
+        return "RECALL-FIRST RULE: Consider using `memory_recall` before delegating to subagent. Subagents cannot access MemoryLayer.";
+    }
+    const query = taskPrompt.substring(0, 100);
+    if (wasQueryRecalledThisTurn(query)) {
+        return "Recall already done for this topic. Include relevant memories in subagent prompt.";
+    }
+    const healthy = await checkHealth();
+    if (!healthy)
+        return null;
+    try {
+        const client = getClient();
+        const result = await client.recall({ query, limit: 5 });
+        markRecallDone(query);
+        if (result.memories.length === 0) {
+            return "No relevant memories found for this task. Proceeding with delegation.";
+        }
+        const recallOutput = formatRecallResult(result, query);
+        return `INCLUDE IN SUBAGENT PROMPT - Relevant context from memory:\n\n${recallOutput}`;
+    }
+    catch {
+        return "Memory recall failed. Consider manual recall before delegation.";
+    }
+}
+/**
+ * Handle pre-tool execution for edit/write tools.
+ * Returns context text, or null.
+ */
+async function handleEditWriteTool(toolArgs) {
+    const filePath = (toolArgs.file_path || toolArgs.path || toolArgs.file || "");
+    if (!filePath)
+        return null;
+    const filename = filePath.split("/").pop() || filePath;
+    const topic = getCurrentTopic();
+    const query = topic ? `${filename} ${topic}` : `${filename} patterns solutions`;
+    if (wasQueryRecalledThisTurn(query))
+        return null;
+    const healthy = await checkHealth();
+    if (!healthy)
+        return null;
+    try {
+        const client = getClient();
+        const result = await client.recall({ query, limit: 3 });
+        if (result.memories.length === 0)
+            return null;
+        markRecallDone(query);
+        return `Relevant context for ${filename}:\n\n${formatRecallResult(result, filename)}`;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Handle before-tool execution.
+ *
+ * In OpenCode's hook system, this is called via "tool.execute.before" with
+ * (input, output) where we can mutate output.args. We use the return value
+ * pattern here and let the entry point handle injection.
+ *
+ * Returns additional context text, or null.
+ */
+export async function handleToolBefore(toolName, toolArgs) {
+    switch (toolName) {
+        case "task":
+            return handleTaskTool(toolArgs);
+        case "edit":
+        case "write":
+        case "multiedit":
+        case "apply_patch":
+            return handleEditWriteTool(toolArgs);
+        default:
+            return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// After-tool hook
+// ---------------------------------------------------------------------------
+/**
+ * Store observation asynchronously (fire-and-forget)
+ */
+async function storeObservationAsync(obs) {
+    const client = getClient();
+    const sessionId = client.getSessionId();
+    if (!sessionId)
+        return;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 3000);
+    try {
+        await client.setWorkingMemory(sessionId, `obs_${obs.contentHash}`, {
+            type: obs.type,
+            title: obs.title,
+            tool: obs.toolName,
+            files_read: obs.filesRead,
+            files_modified: obs.filesModified,
+            facts: obs.facts,
+            concepts: obs.concepts,
+            intent: obs.intent,
+            summary: obs.summary,
+            captured_at: new Date().toISOString(),
+        });
+    }
+    catch {
+        // Silent failure — never block tool execution
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+/**
+ * Check if bash output indicates a significant action
+ */
+function isSignificantBashOutput(toolArgs, toolOutput) {
+    const command = (toolArgs.command || "");
+    // Git commits
+    if (/git\s+commit/i.test(command))
+        return true;
+    // Build commands with errors
+    if (/npm\s+run\s+build|cargo\s+build|make\b|tsc\b|bun\s+build/i.test(command)) {
+        return /error|fail/i.test(toolOutput);
+    }
+    return false;
+}
+/**
+ * Handle after-tool execution — capture observations as working memory.
+ *
+ * Returns additional context guidance for significant events, or null.
+ */
+export async function handleToolAfter(toolName, toolArgs, toolOutput) {
+    if (shouldSkipTool(toolName))
+        return null;
+    const currentPrompt = getCurrentPrompt();
+    const obs = buildObservation(toolName, toolArgs, toolOutput, currentPrompt);
+    if (!obs)
+        return null;
+    // Fire-and-forget storage
+    storeObservationAsync(obs).catch(() => { });
+    // Return guidance for significant events
+    if (toolName === "bash" && isSignificantBashOutput(toolArgs, toolOutput)) {
+        const command = (toolArgs.command || "");
+        if (/git\s+commit/i.test(command)) {
+            return formatStorageGuidance("bash", true);
+        }
+        if (/build|tsc|make|bun\s+build/i.test(command)) {
+            return "Build had errors. Consider storing the issue with `memory_remember` (subtype: error) for future reference.";
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=tool.js.map

package/dist/src/hooks/tool.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * MemoryLayer OpenCode Plugin
+ *
+ * Provides persistent memory for OpenCode sessions via hooks that:
+ * - Inject workspace briefing and directives at session start
+ * - Recall relevant memories when users ask questions
+ * - Capture tool observations as working memory
+ * - Commit working memory before context compaction
+ * - Clean up sessions on exit
+ *
+ * The plugin works alongside the MemoryLayer MCP server which provides
+ * the full suite of 21+ memory tools to the LLM.
+ *
+ * @module @scitrera/memorylayer-opencode-plugin
+ */
+import type { MemoryLayerHooks, PluginInput, PluginOptions } from "./shared/types.js";
+export type { MemoryLayerHooks, PluginInput, PluginOptions, Part, Model, HookState } from "./shared/types.js";
+/**
+ * MemoryLayer plugin for OpenCode.
+ *
+ * Usage in opencode.json:
+ * ```json
+ * {
+ *   "plugin": ["@scitrera/memorylayer-opencode-plugin"]
+ * }
+ * ```
+ */
+export default function memorylayerPlugin(ctx: PluginInput, _options?: PluginOptions): Promise<MemoryLayerHooks>;
+export declare const id = "memorylayer";
+export declare const server: typeof memorylayerPlugin;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAQtF,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,aAAa,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAK9G;;;;;;;;;GASG;AACH,wBAA8B,iBAAiB,CAC7C,GAAG,EAAE,WAAW,EAChB,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAsJ3B;AAGD,eAAO,MAAM,EAAE,gBAAgB,CAAC;AAChC,eAAO,MAAM,MAAM,0BAAoB,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,176 @@
+/**
+ * MemoryLayer OpenCode Plugin
+ *
+ * Provides persistent memory for OpenCode sessions via hooks that:
+ * - Inject workspace briefing and directives at session start
+ * - Recall relevant memories when users ask questions
+ * - Capture tool observations as working memory
+ * - Commit working memory before context compaction
+ * - Clean up sessions on exit
+ *
+ * The plugin works alongside the MemoryLayer MCP server which provides
+ * the full suite of 21+ memory tools to the LLM.
+ *
+ * @module @scitrera/memorylayer-opencode-plugin
+ */
+import { setPluginDirectory } from "./shared/client.js";
+import { initializeSession, finalizeSession } from "./hooks/session.js";
+import { handleUserMessage, extractMessageText } from "./hooks/message.js";
+import { handleToolBefore, handleToolAfter } from "./hooks/tool.js";
+import { handleCompacting } from "./hooks/event.js";
+/** Track whether session has been initialized */
+let sessionInitialized = false;
+/**
+ * MemoryLayer plugin for OpenCode.
+ *
+ * Usage in opencode.json:
+ * ```json
+ * {
+ *   "plugin": ["@scitrera/memorylayer-opencode-plugin"]
+ * }
+ * ```
+ */
+export default async function memorylayerPlugin(ctx, _options) {
+    // Initialize client with workspace detection from plugin context
+    setPluginDirectory(ctx.worktree || ctx.directory);
+    const hooks = {
+        /**
+         * System prompt transform — inject MemoryLayer context on first interaction.
+         *
+         * This hook modifies the system prompt to include workspace briefing,
+         * directives, and session guidance. It runs once per session (on first call)
+         * and injects the formatted context into the system prompt array.
+         */
+        "experimental.chat.system.transform": async (_input, output) => {
+            if (!sessionInitialized) {
+                sessionInitialized = true;
+                const context = await initializeSession();
+                if (context) {
+                    output.system.push(context);
+                }
+            }
+        },
+        /**
+         * User message hook — detect patterns and recall relevant memories.
+         *
+         * When a user sends a message matching known patterns (preference questions,
+         * recall requests, implementation tasks, error reports), this hook performs
+         * a targeted recall and injects the results as additional message parts.
+         */
+        "chat.message": async (_input, output) => {
+            const messageText = extractMessageText(output.parts);
+            if (!messageText)
+                return;
+            const context = await handleUserMessage(messageText);
+            if (context) {
+                output.parts.push({
+                    type: "text",
+                    text: `\n\n<memory-context>\n${context}\n</memory-context>`,
+                });
+            }
+        },
+        /**
+         * Pre-tool hook — inject relevant context before tool execution.
+         *
+         * For write/edit tools: recalls context relevant to the file being modified.
+         * For task/delegation tools: recalls and suggests including context in subagent prompts.
+         */
+        "tool.execute.before": async (input, output) => {
+            const context = await handleToolBefore(input.tool, output.args);
+            if (context) {
+                // Inject context as metadata that the LLM can see
+                // OpenCode passes args to the tool — we add a _memorylayer_context field
+                // that tools can optionally use, and it appears in the tool call metadata
+                output.args._memorylayer_context = context;
+            }
+        },
+        /**
+         * Post-tool hook — capture tool observations as working memory.
+         *
+         * Silently captures structured observations (files read/modified, facts,
+         * concepts, intent) and stores them as working memory. Fire-and-forget
+         * to avoid blocking tool execution.
+         *
+         * For significant events (git commits, build errors), injects guidance
+         * suggesting the user store important information.
+         */
+        "tool.execute.after": async (input, output) => {
+            const guidance = await handleToolAfter(input.tool, input.args, output.output);
+            if (guidance) {
+                // Append guidance to tool output so the LLM sees it
+                output.output = output.output + `\n\n${guidance}`;
+            }
+        },
+        /**
+         * Compaction hook — preserve memory state before context window is trimmed.
+         *
+         * Commits working memory to long-term storage and checkpoints the
+         * server-side sandbox so state survives context compaction.
+         */
+        "experimental.session.compacting": async (input, output) => {
+            const context = await handleCompacting(input.sessionID);
+            output.context.push(...context);
+        },
+        /**
+         * Shell environment hook — inject MemoryLayer env vars into shell commands.
+         */
+        "shell.env": async (_input, output) => {
+            if (process.env.MEMORYLAYER_URL) {
+                output.env.MEMORYLAYER_URL = process.env.MEMORYLAYER_URL;
+            }
+            if (process.env.MEMORYLAYER_API_KEY) {
+                output.env.MEMORYLAYER_API_KEY = process.env.MEMORYLAYER_API_KEY;
+            }
+        },
+        /**
+         * Command hook — handle memorylayer slash commands.
+         */
+        "command.execute.before": async (input, output) => {
+            const cmd = input.command;
+            if (cmd === "memorylayer-remember") {
+                output.parts.push({
+                    type: "text",
+                    text: `Use the \`memory_remember\` tool to store the following: ${input.arguments}\n\nAuto-detect appropriate type, subtype, importance, and tags from the content.`,
+                });
+            }
+            else if (cmd === "memorylayer-recall") {
+                output.parts.push({
+                    type: "text",
+                    text: `Use the \`memory_recall\` tool to search for: ${input.arguments}\n\nDisplay results with relevance scores and key metadata.`,
+                });
+            }
+            else if (cmd === "memorylayer-status") {
+                output.parts.push({
+                    type: "text",
+                    text: "Check MemoryLayer connection status: use `memory_briefing` to verify the MCP server is connected, then report server URL, workspace, memory statistics, and active session info.",
+                });
+            }
+            else if (cmd === "memorylayer-setup") {
+                output.parts.push({
+                    type: "text",
+                    text: [
+                        "Run MemoryLayer setup verification:",
+                        "1. Check server health (curl http://localhost:61001/health)",
+                        "2. Verify MCP tools are connected (call memory_briefing)",
+                        "3. Smoke test: store a test memory, recall it, then forget it",
+                        "4. Report: server URL, workspace, tool count, connection status",
+                        "",
+                        "If server is not running, suggest: pip install memorylayer-server && memorylayer serve",
+                    ].join("\n"),
+                });
+            }
+        },
+    };
+    // Register cleanup on process exit
+    const cleanup = () => {
+        finalizeSession().catch(() => { });
+    };
+    process.on("beforeExit", cleanup);
+    process.on("SIGTERM", cleanup);
+    process.on("SIGINT", cleanup);
+    return hooks;
+}
+// Also export the plugin as a PluginModule shape
+export const id = "memorylayer";
+export const server = memorylayerPlugin;
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAKpD,iDAAiD;AACjD,IAAI,kBAAkB,GAAG,KAAK,CAAC;AAE/B;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,CAAC,KAAK,UAAU,iBAAiB,CAC7C,GAAgB,EAChB,QAAwB;IAExB,iEAAiE;IACjE,kBAAkB,CAAC,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IAElD,MAAM,KAAK,GAAqB;QAC9B;;;;;;WAMG;QACH,oCAAoC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YAC7D,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBACxB,kBAAkB,GAAG,IAAI,CAAC;gBAC1B,MAAM,OAAO,GAAG,MAAM,iBAAiB,EAAE,CAAC;gBAC1C,IAAI,OAAO,EAAE,CAAC;oBACZ,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;QACH,CAAC;QAED;;;;;;WAMG;QACH,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YACvC,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACrD,IAAI,CAAC,WAAW;gBAAE,OAAO;YAEzB,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAAC;YACrD,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;oBAChB,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,yBAAyB,OAAO,qBAAqB;iBAC5D,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED;;;;;WAKG;QACH,qBAAqB,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YAC7C,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YAChE,IAAI,OAAO,EAAE,CAAC;gBACZ,kDAAkD;gBAClD,yEAAyE;gBACzE,0EAA0E;gBACzE,MAAM,CAAC,IAAgC,CAAC,oBAAoB,GAAG,OAAO,CAAC;YAC1E,CAAC;QACH,CAAC;QAED;;;;;;;;;WASG;QACH,oBAAoB,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YAC5C,MAAM,QAAQ,GAAG,MAAM,eAAe,CACpC,KAAK,CAAC,IAAI,EACV,KAAK,CAAC,IAAI,EACV,MAAM,CAAC,MAAM,CACd,CAAC;YACF,IAAI,QAAQ,EAAE,CAAC;gBACb,oDAAoD;gBACpD,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,GAAG,OAAO,QAAQ,EAAE,CAAC;YACpD,CAAC;QACH,CAAC;QAED;;;;;WAKG;QACH,iCAAiC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACzD,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACxD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;QAClC,CAAC;QAED;;WAEG;QACH,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YACpC,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;gBAChC,MAAM,CAAC,GAAG,CAAC,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;YAC3D,CAAC;YACD,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC;gBACpC,MAAM,CAAC,GAAG,CAAC,mBAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;YACnE,CAAC;QACH,CAAC;QAED;;WAEG;QACH,wBAAwB,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YAChD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC;YAE1B,IAAI,GAAG,KAAK,sBAAsB,EAAE,CAAC;gBACnC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;oBAChB,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,4DAA4D,KAAK,CAAC,SAAS,mFAAmF;iBACrK,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,GAAG,KAAK,oBAAoB,EAAE,CAAC;gBACxC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;oBAChB,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,iDAAiD,KAAK,CAAC,SAAS,6DAA6D;iBACpI,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,GAAG,KAAK,oBAAoB,EAAE,CAAC;gBACxC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;oBAChB,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,kLAAkL;iBACzL,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,GAAG,KAAK,mBAAmB,EAAE,CAAC;gBACvC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;oBAChB,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;wBACJ,qCAAqC;wBACrC,6DAA6D;wBAC7D,0DAA0D;wBAC1D,+DAA+D;wBAC/D,iEAAiE;wBACjE,EAAE;wBACF,wFAAwF;qBACzF,CAAC,IAAI,CAAC,IAAI,CAAC;iBACb,CAAC,CAAC;YACL,CAAC;QACH,CAAC;KACF,CAAC;IAEF,mCAAmC;IACnC,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,eAAe,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACpC,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAE9B,OAAO,KAAK,CAAC;AACf,CAAC;AAED,iDAAiD;AACjD,MAAM,CAAC,MAAM,EAAE,GAAG,aAAa,CAAC;AAChC,MAAM,CAAC,MAAM,MAAM,GAAG,iBAAiB,CAAC"}

package/dist/src/shared/client.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Hook client - provides access to the MemoryLayerClient for hook operations.
+ *
+ * Hooks use the exact same MemoryLayerClient as MCP tools, just with a shorter
+ * timeout since hooks need to respond quickly.
+ */
+import { MemoryLayerClient } from "@scitrera/memorylayer-mcp-server";
+/**
+ * Set the plugin directory for workspace auto-detection.
+ * Called once during plugin initialization. Sets CWD so that
+ * detectWorkspaceId() (which reads git config) resolves correctly.
+ */
+export declare function setPluginDirectory(directory: string): void;
+/**
+ * Get or create the singleton MemoryLayerClient instance.
+ * This is the same client class used by MCP tools.
+ *
+ * On each call, syncs the session ID via resolveSessionId() so that
+ * hooks running after session start send the X-Session-ID header for
+ * correct workspace resolution on the server.
+ */
+export declare function getClient(): MemoryLayerClient;
+/**
+ * Check if the MemoryLayer server is reachable
+ */
+export declare function checkHealth(): Promise<boolean>;
+//# sourceMappingURL=client.d.ts.map

package/dist/src/shared/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/shared/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAqB,MAAM,kCAAkC,CAAC;AAMxF;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAM1D;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,IAAI,iBAAiB,CA0B7C;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAOpD"}

package/dist/src/shared/client.js

@@ -0,0 +1,69 @@
+/**
+ * Hook client - provides access to the MemoryLayerClient for hook operations.
+ *
+ * Hooks use the exact same MemoryLayerClient as MCP tools, just with a shorter
+ * timeout since hooks need to respond quickly.
+ */
+import { MemoryLayerClient, detectWorkspaceId } from "@scitrera/memorylayer-mcp-server";
+import { resolveSessionId } from "./state.js";
+/** Singleton client instance for hooks */
+let clientInstance = null;
+/**
+ * Set the plugin directory for workspace auto-detection.
+ * Called once during plugin initialization. Sets CWD so that
+ * detectWorkspaceId() (which reads git config) resolves correctly.
+ */
+export function setPluginDirectory(directory) {
+    try {
+        process.chdir(directory);
+    }
+    catch {
+        // Ignore if directory doesn't exist
+    }
+}
+/**
+ * Get or create the singleton MemoryLayerClient instance.
+ * This is the same client class used by MCP tools.
+ *
+ * On each call, syncs the session ID via resolveSessionId() so that
+ * hooks running after session start send the X-Session-ID header for
+ * correct workspace resolution on the server.
+ */
+export function getClient() {
+    if (!clientInstance) {
+        let workspaceId = process.env.MEMORYLAYER_WORKSPACE_ID;
+        if (!workspaceId) {
+            try {
+                workspaceId = detectWorkspaceId();
+            }
+            catch {
+                workspaceId = "_default";
+            }
+        }
+        clientInstance = new MemoryLayerClient({
+            baseUrl: process.env.MEMORYLAYER_URL,
+            apiKey: process.env.MEMORYLAYER_API_KEY,
+            workspaceId,
+            timeout: 5000, // Shorter timeout for hooks
+        });
+    }
+    // Sync session ID on every call
+    const sessionId = resolveSessionId("client");
+    if (sessionId && clientInstance.getSessionId() !== sessionId) {
+        clientInstance.setSessionId(sessionId);
+    }
+    return clientInstance;
+}
+/**
+ * Check if the MemoryLayer server is reachable
+ */
+export async function checkHealth() {
+    try {
+        await getClient().getBriefing({ limit: 1, includeMemories: false });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/src/shared/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/shared/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACxF,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,0CAA0C;AAC1C,IAAI,cAAc,GAA6B,IAAI,CAAC;AAEpD;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,IAAI,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,oCAAoC;IACtC,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS;IACvB,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,IAAI,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC;QACvD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,IAAI,CAAC;gBACH,WAAW,GAAG,iBAAiB,EAAE,CAAC;YACpC,CAAC;YAAC,MAAM,CAAC;gBACP,WAAW,GAAG,UAAU,CAAC;YAC3B,CAAC;QACH,CAAC;QAED,cAAc,GAAG,IAAI,iBAAiB,CAAC;YACrC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe;YACpC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB;YACvC,WAAW;YACX,OAAO,EAAE,IAAI,EAAE,4BAA4B;SAC5C,CAAC,CAAC;IACL,CAAC;IAED,gCAAgC;IAChC,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,SAAS,IAAI,cAAc,CAAC,YAAY,EAAE,KAAK,SAAS,EAAE,CAAC;QAC7D,cAAc,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,IAAI,CAAC;QACH,MAAM,SAAS,EAAE,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/src/shared/formatters.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Format API responses for injection into OpenCode's context.
+ *
+ * Uses the same types returned by MemoryLayerClient (the MCP adapter),
+ * so hooks and MCP tools share the same data contracts.
+ */
+import type { Memory, RecallResult, ToolResponse } from "@scitrera/memorylayer-mcp-server";
+/**
+ * Format recall results for context injection
+ */
+export declare function formatRecallResult(result: RecallResult, query: string): string;
+/**
+ * Format briefing for context injection.
+ * Accepts the ToolResponse from MemoryLayerClient.getBriefing().
+ */
+export declare function formatBriefing(briefing: ToolResponse): string;
+/**
+ * Format directive memories specially (high importance user instructions)
+ */
+export declare function formatDirectives(memories: Memory[]): string;
+/**
+ * Format sandbox state for context injection (post-compaction recovery)
+ */
+export declare function formatSandboxState(inspectResult: Record<string, unknown>): string;
+/**
+ * Format combined session start output
+ */
+export declare function formatSessionStart(briefing: ToolResponse | null, directives: Memory[], topicRecall: RecallResult | null, topic?: string, sandboxState?: Record<string, unknown> | null): string;
+/**
+ * Format guidance for storing memories after tool use
+ */
+export declare function formatStorageGuidance(toolName: string, isSignificant: boolean): string;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/src/shared/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../../src/shared/formatters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AA0B3F;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAmB9E;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CA6C7D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAmB3D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAoBjF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,YAAY,GAAG,IAAI,EAC7B,UAAU,EAAE,MAAM,EAAE,EACpB,WAAW,EAAE,YAAY,GAAG,IAAI,EAChC,KAAK,CAAC,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAC5C,MAAM,CAoDR;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,GAAG,MAAM,CAatF"}