@jcmrs/opencode-vmem 1.0.0

package/dist/store/tombstone.d.ts

@@ -0,0 +1,27 @@
+import { TombstoneEntry, TombstoneReason, TombstoneSource } from '../types.js';
+export declare class TombstoneManager {
+    private projectDir;
+    private index;
+    constructor(projectDir: string);
+    private load;
+    private save;
+    add(frameId: string, reason: TombstoneReason, source?: TombstoneSource, confidence?: number, replacedBy?: string): Promise<void>;
+    confirm(frameId: string, notes?: string): Promise<void>;
+    revert(frameId: string): Promise<void>;
+    remove(frameId: string): Promise<void>;
+    isTombstoned(frameId: string): boolean;
+    getTombstonedFrameIds(): Set<string>;
+    reload(): Promise<void>;
+    filterTombstoned<T extends {
+        frameId: string;
+    }>(items: T[]): T[];
+    getPendingReviews(): Promise<TombstoneEntry[]>;
+    getStats(): Promise<{
+        total: number;
+        pending: number;
+        confirmed: number;
+        reverted: number;
+        byReason: Record<TombstoneReason, number>;
+    }>;
+}
+//# sourceMappingURL=tombstone.d.ts.map

package/dist/store/tombstone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tombstone.d.ts","sourceRoot":"","sources":["../../src/store/tombstone.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,cAAc,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAI/F,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAA+B;gBAEhC,UAAU,EAAE,MAAM;YAIhB,IAAI;YAoBJ,IAAI;IASZ,GAAG,CACP,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,eAAe,EACvB,MAAM,GAAE,eAAwB,EAChC,UAAU,CAAC,EAAE,MAAM,EACnB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAkBV,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYvD,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAStC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5C,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAQtC,qBAAqB,IAAI,GAAG,CAAC,MAAM,CAAC;IAa9B,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAK7B,gBAAgB,CAAC,CAAC,SAAS;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IAK1D,iBAAiB,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAQ9C,QAAQ,IAAI,OAAO,CAAC;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;KAC3C,CAAC;CAgCH"}

package/dist/store/tombstone.js

@@ -0,0 +1,136 @@
+import { readFile, writeFile, access } from 'fs/promises';
+import { join } from 'path';
+const TOMBSTONE_FILE = 'tombstones.json';
+export class TombstoneManager {
+    projectDir;
+    index = null;
+    constructor(projectDir) {
+        this.projectDir = projectDir;
+    }
+    async load() {
+        if (this.index)
+            return this.index;
+        const filePath = join(this.projectDir, '.opencode', 'memory', TOMBSTONE_FILE);
+        try {
+            await access(filePath);
+            const raw = await readFile(filePath, 'utf-8');
+            this.index = JSON.parse(raw);
+        }
+        catch {
+            this.index = {
+                version: 1,
+                entries: {},
+                lastUpdated: Date.now()
+            };
+        }
+        return this.index;
+    }
+    async save() {
+        if (!this.index)
+            return;
+        const filePath = join(this.projectDir, '.opencode', 'memory', TOMBSTONE_FILE);
+        this.index.lastUpdated = Date.now();
+        await writeFile(filePath, JSON.stringify(this.index, null, 2), 'utf-8');
+    }
+    async add(frameId, reason, source = 'user', confidence, replacedBy) {
+        const index = await this.load();
+        const entry = {
+            frameId,
+            reason,
+            source,
+            confidence,
+            replacedBy,
+            createdAt: Date.now(),
+            status: 'pending'
+        };
+        index.entries[frameId] = entry;
+        await this.save();
+    }
+    async confirm(frameId, notes) {
+        const index = await this.load();
+        if (index.entries[frameId]) {
+            index.entries[frameId].status = 'confirmed';
+            if (notes) {
+                index.entries[frameId].notes = notes;
+            }
+            await this.save();
+        }
+    }
+    async revert(frameId) {
+        const index = await this.load();
+        if (index.entries[frameId]) {
+            index.entries[frameId].status = 'reverted';
+            await this.save();
+        }
+    }
+    async remove(frameId) {
+        const index = await this.load();
+        delete index.entries[frameId];
+        await this.save();
+    }
+    isTombstoned(frameId) {
+        const index = this.index;
+        if (!index)
+            return false;
+        const entry = index.entries[frameId];
+        return entry?.status !== 'reverted';
+    }
+    getTombstonedFrameIds() {
+        const index = this.index;
+        if (!index)
+            return new Set();
+        const ids = new Set();
+        for (const [frameId, entry] of Object.entries(index.entries)) {
+            if (entry.status !== 'reverted') {
+                ids.add(frameId);
+            }
+        }
+        return ids;
+    }
+    async reload() {
+        this.index = null;
+        await this.load();
+    }
+    filterTombstoned(items) {
+        const tombstonedIds = this.getTombstonedFrameIds();
+        return items.filter(item => !tombstonedIds.has(item.frameId));
+    }
+    async getPendingReviews() {
+        const index = await this.load();
+        return Object.values(index.entries)
+            .filter(entry => entry.status === 'pending')
+            .sort((a, b) => b.createdAt - a.createdAt);
+    }
+    async getStats() {
+        const index = await this.load();
+        const entries = Object.values(index.entries);
+        const byReason = {
+            user_request: 0,
+            low_confidence: 0,
+            contradicted: 0,
+            outdated: 0,
+            duplicate: 0,
+            error: 0
+        };
+        let pending = 0;
+        let confirmed = 0;
+        let reverted = 0;
+        for (const entry of entries) {
+            byReason[entry.reason]++;
+            if (entry.status === 'pending')
+                pending++;
+            else if (entry.status === 'confirmed')
+                confirmed++;
+            else if (entry.status === 'reverted')
+                reverted++;
+        }
+        return {
+            total: entries.length,
+            pending,
+            confirmed,
+            reverted,
+            byReason
+        };
+    }
+}
+//# sourceMappingURL=tombstone.js.map

package/dist/store/tombstone.js.map

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

package/dist/tools/index.d.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import { Mind } from '../mind.js';
+export interface ToolContext {
+    mind: Mind;
+    sessionId: string;
+}
+export interface ToolResult {
+    success: boolean;
+    message?: string;
+    data?: unknown;
+}
+export interface Tool {
+    name: string;
+    description: string;
+    parameters: z.ZodType<any>;
+    execute: (params: any, ctx: ToolContext) => Promise<ToolResult>;
+}
+export declare function defineTool(config: {
+    name: string;
+    description: string;
+    parameters: z.ZodType<any>;
+    execute: (params: any, ctx: ToolContext) => Promise<ToolResult>;
+}): Tool;
+export declare const mindSearchTool: Tool;
+export declare const mindStateTool: Tool;
+export declare const mindForgetTool: Tool;
+export declare const mindAddCardTool: Tool;
+export declare const mindContextTool: Tool;
+export declare const mindSuggestTool: Tool;
+export declare const allTools: Tool[];
+export declare function getTool(name: string): Tool | undefined;
+export declare function getToolDescriptions(): Array<{
+    name: string;
+    description: string;
+}>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CACjE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;CACjE,GAAG,IAAI,CAEP;AAED,eAAO,MAAM,cAAc,MA+CzB,CAAC;AAEH,eAAO,MAAM,aAAa,MAsCxB,CAAC;AAEH,eAAO,MAAM,cAAc,MA2BzB,CAAC;AAEH,eAAO,MAAM,eAAe,MAiC1B,CAAC;AAEH,eAAO,MAAM,eAAe,MAyB1B,CAAC;AAEH,eAAO,MAAM,eAAe,MAgD1B,CAAC;AAEH,eAAO,MAAM,QAAQ,EAAE,IAAI,EAO1B,CAAC;AAEF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAEtD;AAED,wBAAgB,mBAAmB,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAElF"}

package/dist/tools/index.js

@@ -0,0 +1,236 @@
+import { z } from 'zod';
+export function defineTool(config) {
+    return config;
+}
+export const mindSearchTool = defineTool({
+    name: 'mind_search',
+    description: `Search the project memory for relevant information.
+
+Use this tool when you need to find:
+- Past decisions or discussions
+- User preferences or profile information
+- Project context and history
+- Previous solutions to problems
+
+Returns matching observations and memory cards.`,
+    parameters: z.object({
+        query: z.string().min(3).max(200).describe('Search query (3-200 characters)'),
+        limit: z.number().min(1).max(50).default(10).describe('Maximum results to return')
+    }),
+    execute: async (params, ctx) => {
+        try {
+            const results = await ctx.mind.search(params.query, params.limit);
+            if (results.length === 0) {
+                return {
+                    success: true,
+                    message: `No memories found matching "${params.query}"`,
+                    data: { found: false, count: 0, results: [] }
+                };
+            }
+            return {
+                success: true,
+                data: {
+                    found: true,
+                    count: results.length,
+                    results: results.map(r => ({
+                        type: r.type,
+                        content: r.content.slice(0, 200),
+                        timestamp: new Date(r.timestamp).toISOString(),
+                        tool: r.tool
+                    }))
+                }
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: `Search failed: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+});
+export const mindStateTool = defineTool({
+    name: 'mind_state',
+    description: 'Get current memory system state and statistics.',
+    parameters: z.object({
+        detailed: z.boolean().default(false).describe('Include detailed statistics')
+    }),
+    execute: async (params, ctx) => {
+        try {
+            const state = await ctx.mind.getState();
+            const cards = await ctx.mind.getMemoryCards();
+            const result = {
+                frameCount: state.frameCount,
+                activeFrameCount: state.activeFrameCount,
+                memoryCardsCount: cards.length
+            };
+            if (params.detailed) {
+                const byEntity = {};
+                const byKind = {};
+                for (const card of cards) {
+                    byEntity[card.entity] = (byEntity[card.entity] || 0) + 1;
+                    byKind[card.kind] = (byKind[card.kind] || 0) + 1;
+                }
+                result.byEntity = byEntity;
+                result.byKind = byKind;
+            }
+            return { success: true, data: result };
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: `Failed to get state: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+});
+export const mindForgetTool = defineTool({
+    name: 'mind_forget',
+    description: `Mark a memory for deletion (tombstone).
+
+The memory will be excluded from future context but retained in history.
+Use this to remove incorrect or outdated information.`,
+    parameters: z.object({
+        frameId: z.string().describe('Frame ID to forget'),
+        reason: z.enum(['user_request', 'low_confidence', 'contradicted', 'outdated', 'duplicate', 'error'])
+            .default('user_request')
+            .describe('Reason for forgetting')
+    }),
+    execute: async (params, ctx) => {
+        try {
+            await ctx.mind.tombstone(params.frameId, params.reason, 'user');
+            return {
+                success: true,
+                message: `Memory ${params.frameId} has been tombstoned (${params.reason})`
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: `Failed to forget: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+});
+export const mindAddCardTool = defineTool({
+    name: 'mind_add_card',
+    description: `Manually add a memory card.
+
+Use this to store extracted knowledge that should persist across sessions.`,
+    parameters: z.object({
+        entity: z.string().describe('Entity (e.g., "user", "project")'),
+        slot: z.string().describe('Slot/attribute (e.g., "employer", "framework")'),
+        value: z.string().describe('Value to store'),
+        kind: z.enum(['fact', 'preference', 'profile', 'goal']).describe('Memory kind')
+    }),
+    execute: async (params, ctx) => {
+        try {
+            const id = await ctx.mind.addMemoryCard({
+                entity: params.entity,
+                slot: params.slot,
+                value: params.value,
+                kind: params.kind,
+                confidence: 1.0
+            });
+            return {
+                success: true,
+                message: `Memory card added: ${params.entity}.${params.slot} = ${params.value}`,
+                data: { id }
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: `Failed to add card: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+});
+export const mindContextTool = defineTool({
+    name: 'mind_context',
+    description: 'Build and return the current memory context block.',
+    parameters: z.object({
+        maxTokens: z.number().min(500).max(8000).default(3000).describe('Maximum tokens')
+    }),
+    execute: async (params, ctx) => {
+        try {
+            const block = await ctx.mind.buildContext({ maxTokens: params.maxTokens });
+            return {
+                success: true,
+                data: {
+                    content: block.content,
+                    tokenCount: block.tokenCount,
+                    included: block.included
+                }
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: `Failed to build context: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+});
+export const mindSuggestTool = defineTool({
+    name: 'mind_suggest',
+    description: `Get procedure suggestions for the current context.
+
+Returns relevant workflows based on problem type, goals, or file patterns.`,
+    parameters: z.object({
+        problemType: z.string().optional().describe('Current problem type'),
+        goal: z.string().optional().describe('Current goal'),
+        files: z.array(z.string()).optional().describe('Relevant files')
+    }),
+    execute: async (params, ctx) => {
+        try {
+            const suggester = ctx.mind.getProcedureSuggester();
+            const suggestions = await suggester.suggest({
+                problemType: params.problemType,
+                goal: params.goal,
+                files: params.files
+            });
+            if (suggestions.length === 0) {
+                return {
+                    success: true,
+                    message: 'No matching procedures found for the current context',
+                    data: { procedures: [], count: 0 }
+                };
+            }
+            const procedures = suggestions.slice(0, 5).map(s => ({
+                id: s.procedure.id,
+                name: s.procedure.name,
+                description: s.procedure.description,
+                relevanceScore: s.relevanceScore.toFixed(2),
+                successRate: (s.procedure.successRate * 100).toFixed(0) + '%',
+                steps: s.procedure.steps.length
+            }));
+            return {
+                success: true,
+                message: `Found ${suggestions.length} matching procedure(s)`,
+                data: { procedures, count: suggestions.length }
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                message: `Failed to get suggestions: ${error instanceof Error ? error.message : String(error)}`
+            };
+        }
+    }
+});
+export const allTools = [
+    mindSearchTool,
+    mindStateTool,
+    mindForgetTool,
+    mindAddCardTool,
+    mindContextTool,
+    mindSuggestTool
+];
+export function getTool(name) {
+    return allTools.find(t => t.name === name);
+}
+export function getToolDescriptions() {
+    return allTools.map(t => ({ name: t.name, description: t.description }));
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

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