statecli-mcp-server 0.1.2 → 0.2.0

package/dist/git-integration.js

@@ -0,0 +1,219 @@
+"use strict";
+/**
+ * Git Integration - Track changes between commits
+ *
+ * Integrates with git to provide commit-level state tracking
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitIntegration = void 0;
+const child_process_1 = require("child_process");
+const path = __importStar(require("path"));
+class GitIntegration {
+    statecli;
+    repoPath;
+    constructor(statecli, repoPath = '.') {
+        this.statecli = statecli;
+        this.repoPath = path.resolve(repoPath);
+    }
+    /**
+     * Check if current directory is a git repository
+     */
+    isGitRepo() {
+        try {
+            this.execGit('rev-parse --git-dir');
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get current branch name
+     */
+    getCurrentBranch() {
+        return this.execGit('rev-parse --abbrev-ref HEAD').trim();
+    }
+    /**
+     * Get current commit hash
+     */
+    getCurrentCommit() {
+        return this.execGit('rev-parse HEAD').trim();
+    }
+    /**
+     * Get recent commits
+     */
+    getRecentCommits(count = 10) {
+        const format = '%H|%h|%s|%an|%ai';
+        const log = this.execGit(`log -${count} --pretty=format:"${format}"`);
+        return log.split('\n').filter(line => line.trim()).map(line => {
+            const [hash, shortHash, message, author, date] = line.split('|');
+            const files = this.getCommitFiles(hash);
+            return { hash, shortHash, message, author, date, files };
+        });
+    }
+    /**
+     * Get files changed in a commit
+     */
+    getCommitFiles(commitHash) {
+        try {
+            const output = this.execGit(`diff-tree --no-commit-id --name-only -r ${commitHash}`);
+            return output.split('\n').filter(f => f.trim());
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Compare two commits
+     */
+    compareCommits(fromCommit, toCommit) {
+        const diffOutput = this.execGit(`diff --stat ${fromCommit}..${toCommit}`);
+        const files = [];
+        // Parse diff stat output
+        const lines = diffOutput.split('\n');
+        for (const line of lines) {
+            const match = line.match(/^\s*(.+?)\s+\|\s+(\d+)\s+(\++)?(-+)?/);
+            if (match) {
+                const [, file, total, additions, deletions] = match;
+                files.push({
+                    file: file.trim(),
+                    additions: (additions || '').length,
+                    deletions: (deletions || '').length,
+                    changes: this.getFileDiff(fromCommit, toCommit, file.trim())
+                });
+            }
+        }
+        const summary = `Comparing ${fromCommit.substring(0, 7)} to ${toCommit.substring(0, 7)}: ${files.length} files changed`;
+        return { fromCommit, toCommit, files, summary };
+    }
+    /**
+     * Get diff for a specific file between commits
+     */
+    getFileDiff(fromCommit, toCommit, filePath) {
+        try {
+            const diff = this.execGit(`diff ${fromCommit}..${toCommit} -- "${filePath}"`);
+            return diff.split('\n').slice(0, 100); // Limit to 100 lines
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Track current git state in StateCLI
+     */
+    trackGitState(actor = 'git-integration') {
+        const branch = this.getCurrentBranch();
+        const commit = this.getCurrentCommit();
+        const recentCommits = this.getRecentCommits(5);
+        this.statecli.track('git', 'state', {
+            branch,
+            commit,
+            shortCommit: commit.substring(0, 7),
+            recentCommits: recentCommits.map(c => ({
+                hash: c.shortHash,
+                message: c.message
+            })),
+            timestamp: new Date().toISOString()
+        }, actor);
+    }
+    /**
+     * Create a checkpoint at current git state
+     */
+    createGitCheckpoint(name) {
+        const commit = this.getCurrentCommit();
+        const checkpointName = name || `git-${commit.substring(0, 7)}`;
+        const result = this.statecli.checkpoint('git:state', checkpointName);
+        return {
+            checkpointId: result.id,
+            commit
+        };
+    }
+    /**
+     * Get what happened between two commits in StateCLI format
+     */
+    getCommitHistory(fromCommit, toCommit) {
+        // Get commits between the two
+        const commits = this.getCommitsBetween(fromCommit, toCommit);
+        // Get comparison
+        const comparison = this.compareCommits(fromCommit, toCommit);
+        // Get StateCLI state changes during this period
+        const stateChanges = this.statecli.replay('git:state');
+        return { commits, comparison, stateChanges };
+    }
+    /**
+     * Get commits between two commit hashes
+     */
+    getCommitsBetween(fromCommit, toCommit) {
+        const format = '%H|%h|%s|%an|%ai';
+        try {
+            const log = this.execGit(`log ${fromCommit}..${toCommit} --pretty=format:"${format}"`);
+            return log.split('\n').filter(line => line.trim()).map(line => {
+                const [hash, shortHash, message, author, date] = line.split('|');
+                const files = this.getCommitFiles(hash);
+                return { hash, shortHash, message, author, date, files };
+            });
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Get uncommitted changes
+     */
+    getUncommittedChanges() {
+        const staged = this.execGit('diff --cached --name-only').split('\n').filter(f => f.trim());
+        const unstaged = this.execGit('diff --name-only').split('\n').filter(f => f.trim());
+        const untracked = this.execGit('ls-files --others --exclude-standard').split('\n').filter(f => f.trim());
+        return { staged, unstaged, untracked };
+    }
+    /**
+     * Execute a git command
+     */
+    execGit(command) {
+        try {
+            return (0, child_process_1.execSync)(`git ${command}`, {
+                cwd: this.repoPath,
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'pipe']
+            });
+        }
+        catch (error) {
+            throw new Error(`Git command failed: ${error.message}`);
+        }
+    }
+}
+exports.GitIntegration = GitIntegration;
+//# sourceMappingURL=git-integration.js.map

package/dist/git-integration.js.map

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

package/dist/index-enhanced.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * StateCLI Enhanced MCP Server Entry Point
+ *
+ * Includes all advanced features:
+ * - File tracking with diffs
+ * - Error recovery and auto-rollback
+ * - Session memory and cross-session queries
+ * - Git integration
+ */
+export {};
+//# sourceMappingURL=index-enhanced.d.ts.map

package/dist/index-enhanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-enhanced.d.ts","sourceRoot":"","sources":["../src/index-enhanced.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG"}

package/dist/index-enhanced.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * StateCLI Enhanced MCP Server Entry Point
+ *
+ * Includes all advanced features:
+ * - File tracking with diffs
+ * - Error recovery and auto-rollback
+ * - Session memory and cross-session queries
+ * - Git integration
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const enhanced_mcp_server_1 = require("./enhanced-mcp-server");
+const server = new enhanced_mcp_server_1.EnhancedStateCLIMCPServer();
+process.on('SIGINT', () => {
+    server.close();
+    process.exit(0);
+});
+process.on('SIGTERM', () => {
+    server.close();
+    process.exit(0);
+});
+server.run().catch((error) => {
+    console.error('Failed to start enhanced server:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index-enhanced.js.map

package/dist/index-enhanced.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-enhanced.js","sourceRoot":"","sources":["../src/index-enhanced.ts"],"names":[],"mappings":";;AACA;;;;;;;;GAQG;;AAEH,+DAAkE;AAElE,MAAM,MAAM,GAAG,IAAI,+CAAyB,EAAE,CAAC;AAE/C,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;IACzB,MAAM,CAAC,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC3B,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;IACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/session-memory.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Session Memory - Cross-session persistence and memory
+ *
+ * Remembers what happened across sessions and provides memory queries
+ */
+import { StateCLI } from './statecli';
+import { StateChange } from './types';
+export interface SessionInfo {
+    id: string;
+    startTime: string;
+    endTime?: string;
+    summary: string;
+    changesCount: number;
+    entities: string[];
+}
+export interface MemoryQuery {
+    entity?: string;
+    entityPattern?: string;
+    timeRange?: {
+        start: string;
+        end: string;
+    };
+    actor?: string;
+    keyword?: string;
+}
+export interface MemoryResult {
+    query: MemoryQuery;
+    sessions: SessionInfo[];
+    changes: StateChange[];
+    summary: string;
+}
+export declare class SessionMemory {
+    private statecli;
+    private sessionId;
+    private sessionStartTime;
+    private memoryDir;
+    constructor(statecli: StateCLI, memoryDir?: string);
+    /**
+     * Get current session ID
+     */
+    getSessionId(): string;
+    /**
+     * Query memory across sessions
+     */
+    queryMemory(query: MemoryQuery): MemoryResult;
+    /**
+     * Ask a natural language question about past actions
+     */
+    ask(question: string): MemoryResult;
+    /**
+     * Get all recorded sessions
+     */
+    getSessions(): SessionInfo[];
+    /**
+     * Get session data by ID
+     */
+    getSession(sessionId: string): {
+        info: SessionInfo;
+        changes: StateChange[];
+    } | null;
+    /**
+     * Save current session data
+     */
+    saveSession(): void;
+    /**
+     * End current session
+     */
+    endSession(): SessionInfo;
+    /**
+     * Get recent activity summary
+     */
+    getRecentActivity(hours?: number): MemoryResult;
+    /**
+     * Get activity for a specific entity across all sessions
+     */
+    getEntityHistory(entityPattern: string): MemoryResult;
+    private generateSessionId;
+    private ensureMemoryDir;
+    private recordSessionStart;
+    private loadSessionData;
+    private changeMatchesQuery;
+    private parseQuestion;
+    private createQuerySummary;
+}
+//# sourceMappingURL=session-memory.d.ts.map

package/dist/session-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-memory.d.ts","sourceRoot":"","sources":["../src/session-memory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAgB,MAAM,SAAS,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE;QACV,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,SAAS,CAAS;gBAEd,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,MAAM;IAUlD;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY;IAkC7C;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IAMnC;;OAEG;IACH,WAAW,IAAI,WAAW,EAAE;IAqB5B;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,OAAO,EAAE,WAAW,EAAE,CAAA;KAAE,GAAG,IAAI;IAInF;;OAEG;IACH,WAAW,IAAI,IAAI;IA0CnB;;OAEG;IACH,UAAU,IAAI,WAAW;IAczB;;OAEG;IACH,iBAAiB,CAAC,KAAK,GAAE,MAAW,GAAG,YAAY;IAWnD;;OAEG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,YAAY;IAIrD,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,kBAAkB;IA0C1B,OAAO,CAAC,aAAa;IA0CrB,OAAO,CAAC,kBAAkB;CA6B3B"}

package/dist/session-memory.js

@@ -0,0 +1,325 @@
+"use strict";
+/**
+ * Session Memory - Cross-session persistence and memory
+ *
+ * Remembers what happened across sessions and provides memory queries
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionMemory = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+class SessionMemory {
+    statecli;
+    sessionId;
+    sessionStartTime;
+    memoryDir;
+    constructor(statecli, memoryDir) {
+        this.statecli = statecli;
+        this.sessionId = this.generateSessionId();
+        this.sessionStartTime = new Date().toISOString();
+        this.memoryDir = memoryDir || path.join(process.cwd(), '.statecli', 'memory');
+        this.ensureMemoryDir();
+        this.recordSessionStart();
+    }
+    /**
+     * Get current session ID
+     */
+    getSessionId() {
+        return this.sessionId;
+    }
+    /**
+     * Query memory across sessions
+     */
+    queryMemory(query) {
+        const sessions = this.getSessions();
+        const matchingSessions = [];
+        const matchingChanges = [];
+        for (const session of sessions) {
+            // Load session data
+            const sessionData = this.loadSessionData(session.id);
+            if (!sessionData)
+                continue;
+            let sessionMatches = false;
+            for (const change of sessionData.changes) {
+                if (this.changeMatchesQuery(change, query)) {
+                    matchingChanges.push(change);
+                    sessionMatches = true;
+                }
+            }
+            if (sessionMatches) {
+                matchingSessions.push(session);
+            }
+        }
+        const summary = this.createQuerySummary(query, matchingSessions, matchingChanges);
+        return {
+            query,
+            sessions: matchingSessions,
+            changes: matchingChanges,
+            summary
+        };
+    }
+    /**
+     * Ask a natural language question about past actions
+     */
+    ask(question) {
+        // Parse question into query
+        const query = this.parseQuestion(question);
+        return this.queryMemory(query);
+    }
+    /**
+     * Get all recorded sessions
+     */
+    getSessions() {
+        const sessions = [];
+        try {
+            const files = fs.readdirSync(this.memoryDir);
+            for (const file of files) {
+                if (file.endsWith('.session.json')) {
+                    const sessionPath = path.join(this.memoryDir, file);
+                    const data = JSON.parse(fs.readFileSync(sessionPath, 'utf-8'));
+                    sessions.push(data.info);
+                }
+            }
+        }
+        catch {
+            // Memory dir might not exist yet
+        }
+        return sessions.sort((a, b) => new Date(b.startTime).getTime() - new Date(a.startTime).getTime());
+    }
+    /**
+     * Get session data by ID
+     */
+    getSession(sessionId) {
+        return this.loadSessionData(sessionId);
+    }
+    /**
+     * Save current session data
+     */
+    saveSession() {
+        // Get all changes from current session
+        const allEntities = this.statecli.listEntities();
+        const allChanges = [];
+        for (const entity of allEntities) {
+            const replay = this.statecli.replay(entity);
+            for (const change of replay.changes) {
+                // Only include changes from current session
+                if (change.timestamp >= this.sessionStartTime) {
+                    allChanges.push({
+                        id: change.id || `${entity}-${change.step}`,
+                        entity,
+                        entityType: entity.split(':')[0],
+                        entityId: entity.split(':')[1] || '',
+                        timestamp: change.timestamp,
+                        before: change.before,
+                        after: change.after,
+                        actor: change.actor
+                    });
+                }
+            }
+        }
+        const sessionInfo = {
+            id: this.sessionId,
+            startTime: this.sessionStartTime,
+            endTime: new Date().toISOString(),
+            summary: `Session with ${allChanges.length} changes across ${allEntities.length} entities`,
+            changesCount: allChanges.length,
+            entities: allEntities
+        };
+        const sessionData = {
+            info: sessionInfo,
+            changes: allChanges
+        };
+        const sessionPath = path.join(this.memoryDir, `${this.sessionId}.session.json`);
+        fs.writeFileSync(sessionPath, JSON.stringify(sessionData, null, 2));
+    }
+    /**
+     * End current session
+     */
+    endSession() {
+        this.saveSession();
+        const sessions = this.getSessions();
+        return sessions.find(s => s.id === this.sessionId) || {
+            id: this.sessionId,
+            startTime: this.sessionStartTime,
+            endTime: new Date().toISOString(),
+            summary: 'Session ended',
+            changesCount: 0,
+            entities: []
+        };
+    }
+    /**
+     * Get recent activity summary
+     */
+    getRecentActivity(hours = 24) {
+        const cutoff = new Date(Date.now() - hours * 60 * 60 * 1000).toISOString();
+        return this.queryMemory({
+            timeRange: {
+                start: cutoff,
+                end: new Date().toISOString()
+            }
+        });
+    }
+    /**
+     * Get activity for a specific entity across all sessions
+     */
+    getEntityHistory(entityPattern) {
+        return this.queryMemory({ entityPattern });
+    }
+    generateSessionId() {
+        const timestamp = Date.now().toString(36);
+        const random = Math.random().toString(36).substring(2, 8);
+        return `session-${timestamp}-${random}`;
+    }
+    ensureMemoryDir() {
+        if (!fs.existsSync(this.memoryDir)) {
+            fs.mkdirSync(this.memoryDir, { recursive: true });
+        }
+    }
+    recordSessionStart() {
+        this.statecli.track('session', this.sessionId, {
+            event: 'start',
+            startTime: this.sessionStartTime
+        }, 'session-memory');
+    }
+    loadSessionData(sessionId) {
+        const sessionPath = path.join(this.memoryDir, `${sessionId}.session.json`);
+        try {
+            if (fs.existsSync(sessionPath)) {
+                return JSON.parse(fs.readFileSync(sessionPath, 'utf-8'));
+            }
+        }
+        catch {
+            // File might be corrupted
+        }
+        return null;
+    }
+    changeMatchesQuery(change, query) {
+        // Entity filter
+        if (query.entity && change.entity !== query.entity) {
+            return false;
+        }
+        // Entity pattern filter
+        if (query.entityPattern) {
+            const pattern = query.entityPattern.replace('*', '.*');
+            const regex = new RegExp(pattern);
+            if (!regex.test(change.entity)) {
+                return false;
+            }
+        }
+        // Time range filter
+        if (query.timeRange) {
+            const changeTime = new Date(change.timestamp).getTime();
+            const startTime = new Date(query.timeRange.start).getTime();
+            const endTime = new Date(query.timeRange.end).getTime();
+            if (changeTime < startTime || changeTime > endTime) {
+                return false;
+            }
+        }
+        // Actor filter
+        if (query.actor && change.actor !== query.actor) {
+            return false;
+        }
+        // Keyword filter (search in state values)
+        if (query.keyword) {
+            const stateStr = JSON.stringify(change.after).toLowerCase();
+            if (!stateStr.includes(query.keyword.toLowerCase())) {
+                return false;
+            }
+        }
+        return true;
+    }
+    parseQuestion(question) {
+        const query = {};
+        const lowerQ = question.toLowerCase();
+        // Parse time references
+        if (lowerQ.includes('yesterday')) {
+            const yesterday = new Date(Date.now() - 24 * 60 * 60 * 1000);
+            query.timeRange = {
+                start: yesterday.toISOString(),
+                end: new Date().toISOString()
+            };
+        }
+        else if (lowerQ.includes('last week')) {
+            const lastWeek = new Date(Date.now() - 7 * 24 * 60 * 60 * 1000);
+            query.timeRange = {
+                start: lastWeek.toISOString(),
+                end: new Date().toISOString()
+            };
+        }
+        else if (lowerQ.includes('today')) {
+            const today = new Date();
+            today.setHours(0, 0, 0, 0);
+            query.timeRange = {
+                start: today.toISOString(),
+                end: new Date().toISOString()
+            };
+        }
+        // Parse entity references
+        const entityMatch = question.match(/(?:to|on|for|in)\s+(\w+[:\w]*)/i);
+        if (entityMatch) {
+            query.entityPattern = entityMatch[1].includes(':')
+                ? entityMatch[1]
+                : `${entityMatch[1]}:*`;
+        }
+        // Parse actor references
+        if (lowerQ.includes('i did') || lowerQ.includes('my ')) {
+            query.actor = 'ai-agent';
+        }
+        return query;
+    }
+    createQuerySummary(query, sessions, changes) {
+        const lines = [];
+        lines.push(`Memory Query Results`);
+        lines.push(`====================`);
+        lines.push(`Found ${changes.length} changes across ${sessions.length} sessions`);
+        if (query.timeRange) {
+            lines.push(`Time range: ${query.timeRange.start} to ${query.timeRange.end}`);
+        }
+        if (query.entityPattern) {
+            lines.push(`Entity pattern: ${query.entityPattern}`);
+        }
+        if (changes.length > 0) {
+            lines.push(``);
+            lines.push(`Recent changes:`);
+            for (const change of changes.slice(-5)) {
+                lines.push(`  - ${change.timestamp}: ${change.entity} (${change.actor})`);
+            }
+        }
+        return lines.join('\n');
+    }
+}
+exports.SessionMemory = SessionMemory;
+//# sourceMappingURL=session-memory.js.map