@scitrera/memorylayer-opencode-plugin 0.1.22

package/README.md

@@ -0,0 +1,178 @@
+# MemoryLayer OpenCode Plugin
+
+Persistent memory for [OpenCode](https://github.com/sst/opencode) sessions. Gives your AI coding agent long-term memory that survives context compaction and persists across sessions.
+
+## What It Does
+
+This plugin integrates [MemoryLayer](https://memorylayer.ai) into OpenCode via two mechanisms:
+
+1. **MCP Tools** (25 default / 38 in `full`) — The MemoryLayer MCP server gives the LLM direct access to remember, recall, reflect, manage sessions, drive the context sandbox / RLM, and work with chat threads, skills, and MCP-server registry entries.
+
+2. **Proactive Hooks** — The plugin automatically:
+   - Injects workspace briefing and user directives at session start
+   - Recalls relevant memories when you ask preference/convention questions
+   - Captures tool observations (file edits, searches, commands) as working memory
+   - Commits working memory before context compaction
+   - Cleans up sessions on exit
+
+## Quick Start
+
+### 1. Install the MemoryLayer server
+
+```bash
+pip install memorylayer-server
+memorylayer serve
+```
+
+Or with Docker:
+
+```bash
+docker run -d -p 61001:61001 -v memorylayer-data:/data scitrera/memorylayer-server
+```
+
+### 2. Configure OpenCode
+
+Add to your `opencode.json`:
+
+```json
+{
+  "mcp": {
+    "memorylayer": {
+      "type": "local",
+      "command": ["npx", "@scitrera/memorylayer-mcp-server"],
+      "environment": {
+        "MEMORYLAYER_URL": "{env:MEMORYLAYER_URL}",
+        "MEMORYLAYER_API_KEY": "{env:MEMORYLAYER_API_KEY}"
+      },
+      "enabled": true
+    }
+  },
+  "plugin": ["@scitrera/memorylayer-opencode-plugin"]
+}
+```
+
+### 3. Set environment variables (optional)
+
+```bash
+export MEMORYLAYER_URL=http://localhost:61001  # default
+export MEMORYLAYER_API_KEY=your-key            # optional, for authenticated servers
+```
+
+### 4. Verify
+
+Start OpenCode and run `/memorylayer-status` to check the connection.
+
+## Slash Commands
+
+| Command | Description |
+|---------|-------------|
+| `/memorylayer-remember <content>` | Store a memory with auto-detected type and importance |
+| `/memorylayer-recall <query>` | Search memories by semantic query |
+| `/memorylayer-status` | Check connection status and workspace info |
+| `/memorylayer-setup` | Guided setup and verification |
+
+## How Hooks Work
+
+### Session Start (`experimental.chat.system.transform`)
+On first interaction, loads workspace briefing, user directives, and any existing sandbox state into the system prompt.
+
+### User Messages (`chat.message`)
+Detects 5 pattern categories in user messages and performs targeted recall:
+- **Preference**: "which X should we use", "what's our convention"
+- **Recall**: "remember", "what did we", "remind me"
+- **Analysis**: "review", "analyze", "status"
+- **Implementation**: "implement", "build", "fix"
+- **Error**: "error", "bug", "broken"
+
+### Tool Execution (`tool.execute.before` / `tool.execute.after`)
+- **Before**: Injects recalled context for edit/write and task/delegation tools
+- **After**: Silently captures observations (files, facts, concepts, intent) as working memory
+
+### Context Compaction (`experimental.session.compacting`)
+Commits working memory to long-term storage and checkpoints server-side sandbox state before the context window is trimmed.
+
+### Shell Environment (`shell.env`)
+Propagates `MEMORYLAYER_URL` and `MEMORYLAYER_API_KEY` to shell commands.
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `MEMORYLAYER_URL` | `http://localhost:61001` | MemoryLayer server URL |
+| `MEMORYLAYER_API_KEY` | — | API key (optional for local servers) |
+| `MEMORYLAYER_WORKSPACE_ID` | auto-detected | Workspace identifier (auto-detected from git repo name) |
+
+### Workspace Auto-Detection
+
+The workspace ID is automatically detected from:
+1. Git remote origin repository name
+2. Git root directory name
+3. Current working directory name
+
+Override with the `MEMORYLAYER_WORKSPACE_ID` environment variable.
+
+## Memory Types
+
+| Type | Description | Importance |
+|------|-------------|------------|
+| `semantic` | Facts, concepts, knowledge | 0.5-0.9 |
+| `procedural` | How-to, solutions, patterns | 0.5-0.8 |
+| `episodic` | Events, what happened | 0.5-0.7 |
+| `working` | Current task context (auto-expires) | 0.3-0.6 |
+
+### Common Subtypes
+
+`directive`, `decision`, `fix`, `solution`, `code_pattern`, `error`, `workflow`, `preference`, `problem`
+
+## Architecture
+
+```
+OpenCode
+├── MCP Server (@scitrera/memorylayer-mcp-server)
+│   └── 25 memory tools by default (38 in `full` profile)
+│
+├── Plugin Hooks (@scitrera/memorylayer-opencode-plugin)
+│   ├── system.transform  → session briefing injection
+│   ├── chat.message      → pattern-based recall
+│   ├── tool.before       → pre-tool context injection
+│   ├── tool.after        → observation capture
+│   ├── session.compacting → working memory commit
+│   └── shell.env         → env var propagation
+│
+└── MemoryLayer Server (memorylayer-server)
+    ├── Memory storage (SQLite + vector search)
+    ├── Knowledge graph (associations)
+    ├── Working memory (sessions)
+    └── Context sandbox (Python execution)
+```
+
+## Troubleshooting
+
+### Server not reachable
+```bash
+# Check if server is running
+curl http://localhost:61001/health
+
+# Start the server
+memorylayer serve
+
+# Or with Docker
+docker run -d -p 61001:61001 -v memorylayer-data:/data scitrera/memorylayer-server
+```
+
+### MCP tools not available
+Verify `opencode.json` has the `mcp.memorylayer` configuration. Restart OpenCode after configuration changes.
+
+### Plugin not loading
+Ensure the plugin is listed in `opencode.json`:
+```json
+{
+  "plugin": ["@scitrera/memorylayer-opencode-plugin"]
+}
+```
+
+## License
+
+Apache-2.0

package/dist/src/hooks/event.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Event hook for MemoryLayer OpenCode plugin.
+ *
+ * Handles context compaction by preserving critical memory state
+ * and committing working memory before context is lost.
+ */
+/**
+ * Handle session compacting — commit working memory and checkpoint sandbox.
+ *
+ * OpenCode's `experimental.session.compacting` hook is the equivalent
+ * of Claude Code's PreCompact. We commit working memory and return
+ * context strings that survive the compaction.
+ */
+export declare function handleCompacting(_sessionID: string): Promise<string[]>;
+//# sourceMappingURL=event.d.ts.map

package/dist/src/hooks/event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../../src/hooks/event.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA8C5E"}

package/dist/src/hooks/event.js

@@ -0,0 +1,53 @@
+/**
+ * Event hook for MemoryLayer OpenCode plugin.
+ *
+ * Handles context compaction by preserving critical memory state
+ * and committing working memory before context is lost.
+ */
+import { getClient, checkHealth } from "../shared/client.js";
+/**
+ * Handle session compacting — commit working memory and checkpoint sandbox.
+ *
+ * OpenCode's `experimental.session.compacting` hook is the equivalent
+ * of Claude Code's PreCompact. We commit working memory and return
+ * context strings that survive the compaction.
+ */
+export async function handleCompacting(_sessionID) {
+    const context = [];
+    const healthy = await checkHealth();
+    if (!healthy)
+        return context;
+    const client = getClient();
+    const clientSessionId = client.getSessionId();
+    if (clientSessionId) {
+        // Commit working memory to long-term storage before compaction
+        try {
+            await client.commitSession(clientSessionId, { importance_threshold: 0.3 });
+            context.push("[MemoryLayer] Working memory committed to long-term storage before compaction. " +
+                "Use `memory_recall` to retrieve prior context. " +
+                "Use `memory_context_inspect` to check server-side sandbox variables.");
+        }
+        catch {
+            // Commit may fail, but we should still try to preserve context
+        }
+        // Checkpoint sandbox state if active
+        try {
+            const status = await client.contextStatus();
+            if (status.exists && (status.variable_count ?? 0) > 0) {
+                await client.contextCheckpoint();
+                context.push("[MemoryLayer] Server-side sandbox state checkpointed. " +
+                    "Variables persist across compaction — use `memory_context_inspect` to re-orient.");
+            }
+        }
+        catch {
+            // Sandbox checkpoint is best-effort
+        }
+    }
+    // Always include recovery instructions
+    if (context.length === 0) {
+        context.push("[MemoryLayer] Context compaction occurred. Use `memory_recall` to retrieve " +
+            "prior context and `memory_context_inspect` to check sandbox state.");
+    }
+    return context;
+}
+//# sourceMappingURL=event.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../../src/hooks/event.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,UAAkB;IACvD,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,MAAM,OAAO,GAAG,MAAM,WAAW,EAAE,CAAC;IACpC,IAAI,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC;IAE7B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,eAAe,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC;IAE9C,IAAI,eAAe,EAAE,CAAC;QACpB,+DAA+D;QAC/D,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,aAAa,CAAC,eAAe,EAAE,EAAE,oBAAoB,EAAE,GAAG,EAAE,CAAC,CAAC;YAC3E,OAAO,CAAC,IAAI,CACV,iFAAiF;gBACjF,iDAAiD;gBACjD,sEAAsE,CACvE,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,+DAA+D;QACjE,CAAC;QAED,qCAAqC;QACrC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,EAAmD,CAAC;YAC7F,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtD,MAAM,MAAM,CAAC,iBAAiB,EAAE,CAAC;gBACjC,OAAO,CAAC,IAAI,CACV,wDAAwD;oBACxD,kFAAkF,CACnF,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,oCAAoC;QACtC,CAAC;IACH,CAAC;IAED,uCAAuC;IACvC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,IAAI,CACV,6EAA6E;YAC7E,oEAAoE,CACrE,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/hooks/message.d.ts

@@ -0,0 +1,20 @@
+/**
+ * User message hook for MemoryLayer OpenCode plugin.
+ *
+ * Detects patterns in user messages and performs intelligent recall
+ * to inject relevant memories into the conversation context.
+ */
+/**
+ * Extract user message text from message parts.
+ */
+export declare function extractMessageText(parts: Array<{
+    type: string;
+    text?: string;
+}>): string;
+/**
+ * Handle a new user message — detect patterns and recall relevant memories.
+ *
+ * Returns additional context text to inject, or null if no recall needed.
+ */
+export declare function handleUserMessage(messageText: string): Promise<string | null>;
+//# sourceMappingURL=message.d.ts.map

package/dist/src/hooks/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../src/hooks/message.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmFH;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,CAKxF;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA2CnF"}

package/dist/src/hooks/message.js

@@ -0,0 +1,128 @@
+/**
+ * User message hook for MemoryLayer OpenCode plugin.
+ *
+ * Detects patterns in user messages and performs intelligent recall
+ * to inject relevant memories into the conversation context.
+ */
+import { getClient, checkHealth } from "../shared/client.js";
+import { formatRecallResult } from "../shared/formatters.js";
+import { wasRecallDoneThisTurn, markRecallDone, resetRecallStatus, setCurrentTopic, setCurrentPrompt, } from "../shared/state.js";
+/** Pattern categories and their recall queries */
+const PATTERNS = {
+    preference: {
+        regex: /\b(which\s+\w+\s+should|should\s+we\s+use|what\s+do\s+we\s+use|how\s+do\s+we|what'?s\s+our|preferred|convention|do\s+we\s+have\s+a|what'?s\s+the\s+(default|standard|preferred))\b/i,
+        queries: ["directive", "preference", "convention"],
+    },
+    recall: {
+        regex: /\b(remember|recall|what did we|how did we|remind me|what was the|what were the|what do you (know|remember))\b/i,
+        queries: ["context", "history", "decision"],
+    },
+    analysis: {
+        regex: /\b(review|assess|analyze|evaluate|audit|investigate|explore|research|compare|status|state of|readiness|gap analysis)\b/i,
+        queries: ["status", "assessment", "gaps", "problems"],
+    },
+    implementation: {
+        regex: /\b(implement|build|create|add|fix|refactor|update|change|modify)\b/i,
+        queries: ["patterns", "solutions", "issues"],
+    },
+    error: {
+        regex: /\b(error|bug|issue|broken|failing|crash|exception|doesn't work|not working)\b/i,
+        queries: ["fix", "error", "solution"],
+    },
+};
+/**
+ * Detect which pattern category matches the prompt
+ */
+function detectPattern(prompt) {
+    for (const [category, config] of Object.entries(PATTERNS)) {
+        if (config.regex.test(prompt)) {
+            return category;
+        }
+    }
+    return null;
+}
+/**
+ * Extract key terms from the prompt for recall query
+ */
+function extractKeyTerms(prompt) {
+    const stopWords = new Set([
+        "the", "a", "an", "is", "are", "was", "were", "be", "been",
+        "have", "has", "had", "do", "does", "did", "will", "would",
+        "could", "should", "may", "might", "must", "can", "this",
+        "that", "these", "those", "i", "you", "we", "they", "it",
+        "my", "your", "our", "their", "its", "please", "help", "me",
+        "want", "need", "like", "to", "for", "with", "on", "in", "at",
+    ]);
+    const words = prompt.toLowerCase()
+        .replace(/[^\w\s]/g, " ")
+        .split(/\s+/)
+        .filter(w => w.length > 2 && !stopWords.has(w));
+    return words.slice(0, 5).join(" ");
+}
+/**
+ * Get guidance text for each pattern type
+ */
+function getPatternGuidance(pattern) {
+    const guidance = {
+        preference: "This is a preference/convention question. Relevant directives and decisions found:",
+        recall: "Recalled memories matching this request:",
+        analysis: "This request involves analysis/research. Relevant prior context found:",
+        implementation: "This request involves implementation. Relevant patterns/solutions found:",
+        error: "This request mentions an error/bug. Relevant prior fixes found:",
+    };
+    return guidance[pattern] || "Relevant memories found:";
+}
+/**
+ * Extract user message text from message parts.
+ */
+export function extractMessageText(parts) {
+    return parts
+        .filter(p => p.type === "text" && p.text)
+        .map(p => p.text)
+        .join("\n");
+}
+/**
+ * Handle a new user message — detect patterns and recall relevant memories.
+ *
+ * Returns additional context text to inject, or null if no recall needed.
+ */
+export async function handleUserMessage(messageText) {
+    if (!messageText)
+        return null;
+    // Reset recall status for new user turn
+    resetRecallStatus();
+    // Persist the user's prompt for intent detection in tool hooks
+    setCurrentPrompt(messageText);
+    // Skip if recall was already done this turn
+    if (wasRecallDoneThisTurn())
+        return null;
+    // Check server health
+    const healthy = await checkHealth();
+    if (!healthy)
+        return null;
+    // Store the user's topic for cross-hook context
+    const keyTerms = extractKeyTerms(messageText);
+    if (keyTerms) {
+        setCurrentTopic(keyTerms);
+    }
+    // Detect pattern category
+    const pattern = detectPattern(messageText);
+    if (!pattern)
+        return null;
+    try {
+        const patternQueries = PATTERNS[pattern].queries;
+        const query = `${keyTerms} ${patternQueries[0]}`.trim();
+        const client = getClient();
+        const result = await client.recall({ query, limit: 10 });
+        markRecallDone(query);
+        if (result.memories.length === 0)
+            return null;
+        const guidance = getPatternGuidance(pattern);
+        const recallOutput = formatRecallResult(result, query);
+        return `${guidance}\n\n${recallOutput}`;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=message.js.map

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

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

package/dist/src/hooks/session.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Session lifecycle hooks for MemoryLayer OpenCode plugin.
+ *
+ * Handles session initialization (briefing, directives, sandbox state)
+ * and session teardown (commit working memory, end session).
+ */
+/**
+ * Initialize a MemoryLayer session and return formatted context for system prompt injection.
+ *
+ * Called from the `experimental.chat.system.transform` hook on the first message
+ * of a session, or from the `event` hook on session start.
+ */
+export declare function initializeSession(topic?: string): Promise<string | null>;
+/**
+ * Finalize the MemoryLayer session — commit working memory and end session.
+ *
+ * Called when the OpenCode session ends. Best-effort: never throws.
+ */
+export declare function finalizeSession(): Promise<void>;
+//# sourceMappingURL=session.d.ts.map

package/dist/src/hooks/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/hooks/session.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsBH;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA0D9E;AAED;;;;GAIG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CA4BrD"}

package/dist/src/hooks/session.js

@@ -0,0 +1,121 @@
+/**
+ * Session lifecycle hooks for MemoryLayer OpenCode plugin.
+ *
+ * Handles session initialization (briefing, directives, sandbox state)
+ * and session teardown (commit working memory, end session).
+ */
+import { getClient, checkHealth } from "../shared/client.js";
+import { formatSessionStart } from "../shared/formatters.js";
+import { markRecallDone, resetRecallStatus, updateSessionInfo } from "../shared/state.js";
+/**
+ * Check for existing sandbox state from a prior session or pre-compaction.
+ */
+async function checkSandboxState(client) {
+    try {
+        const status = await client.contextStatus();
+        if (status.exists && (status.variable_count ?? 0) > 0) {
+            return await client.contextInspect({});
+        }
+    }
+    catch {
+        // Context environment may not be available
+    }
+    return null;
+}
+/**
+ * Initialize a MemoryLayer session and return formatted context for system prompt injection.
+ *
+ * Called from the `experimental.chat.system.transform` hook on the first message
+ * of a session, or from the `event` hook on session start.
+ */
+export async function initializeSession(topic) {
+    const healthy = await checkHealth();
+    if (!healthy) {
+        return "MemoryLayer server not reachable. Memory features unavailable this session.";
+    }
+    try {
+        const client = getClient();
+        // Start server session
+        let sessionId;
+        try {
+            const sessionResult = await client.startSession({ ttl_seconds: 3600 });
+            sessionId = sessionResult.session_id;
+            const workspaceId = client.getWorkspaceId();
+            if (workspaceId) {
+                updateSessionInfo(workspaceId, sessionId);
+            }
+        }
+        catch {
+            // Session start failed, continue without session management
+        }
+        // Reset recall status for new session
+        resetRecallStatus();
+        // Run briefing, directive recall, and sandbox check in parallel
+        const [briefingResult, directiveResult, sandboxResult] = await Promise.allSettled([
+            client.getBriefing({ limit: 10, includeMemories: false }),
+            client.recall({
+                query: "user directives and preferences",
+                subtypes: ["directive", "preference"],
+                limit: 10,
+            }),
+            checkSandboxState(client),
+        ]);
+        const briefing = briefingResult.status === "fulfilled" ? briefingResult.value : null;
+        const directives = directiveResult.status === "fulfilled"
+            ? directiveResult.value.memories
+            : [];
+        const sandboxState = sandboxResult.status === "fulfilled" ? sandboxResult.value : null;
+        // If there's a topic, recall for it too
+        let topicRecall = null;
+        if (topic) {
+            try {
+                topicRecall = await client.recall({ query: topic, limit: 10, detail_level: "abstract" });
+                markRecallDone(topic);
+            }
+            catch {
+                // Topic recall is optional
+            }
+        }
+        return formatSessionStart(briefing, directives, topicRecall, topic, sandboxState);
+    }
+    catch (error) {
+        return `MemoryLayer session error: ${error instanceof Error ? error.message : error}`;
+    }
+}
+/**
+ * Finalize the MemoryLayer session — commit working memory and end session.
+ *
+ * Called when the OpenCode session ends. Best-effort: never throws.
+ */
+export async function finalizeSession() {
+    const healthy = await checkHealth();
+    if (!healthy)
+        return;
+    const client = getClient();
+    const sessionId = client.getSessionId();
+    if (!sessionId)
+        return;
+    try {
+        // Commit working memory to long-term storage
+        try {
+            await client.commitSession(sessionId, { importance_threshold: 0.5 });
+        }
+        catch {
+            // Commit may fail if session expired
+        }
+        // End the server session
+        try {
+            await client.endSession(sessionId, {
+                commit: true,
+                importance_threshold: 0.5,
+            });
+        }
+        catch {
+            // Session may already be ended
+        }
+    }
+    catch {
+        // Best-effort — don't fail on shutdown
+    }
+}
+//# sourceMappingURL=session.js.map

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

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

package/dist/src/hooks/tool.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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.
+ */
+/**
+ * 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 declare function handleToolBefore(toolName: string, toolArgs: Record<string, unknown>): Promise<string | null>;
+/**
+ * Handle after-tool execution — capture observations as working memory.
+ *
+ * Returns additional context guidance for significant events, or null.
+ */
+export declare function handleToolAfter(toolName: string, toolArgs: Record<string, unknown>, toolOutput: string): Promise<string | null>;
+//# sourceMappingURL=tool.d.ts.map

package/dist/src/hooks/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../../src/hooks/tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoFH;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAcxB;AAyDD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAyBxB"}