statecli-mcp-server 0.1.0

package/dist/storage.js

@@ -0,0 +1,306 @@
+"use strict";
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StateStorage = void 0;
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const uuid_1 = require("uuid");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const types_1 = require("./types");
+class StateStorage {
+    db;
+    config;
+    constructor(config = {}) {
+        this.config = { ...types_1.DEFAULT_CONFIG, ...config };
+        const dbPath = this.config.storage.path;
+        const dbDir = path.dirname(dbPath);
+        if (!fs.existsSync(dbDir)) {
+            fs.mkdirSync(dbDir, { recursive: true });
+        }
+        this.db = new better_sqlite3_1.default(dbPath);
+        this.initializeSchema();
+    }
+    initializeSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS state_changes (
+        id TEXT PRIMARY KEY,
+        entity TEXT NOT NULL,
+        entity_type TEXT NOT NULL,
+        entity_id TEXT NOT NULL,
+        timestamp TEXT NOT NULL,
+        before_state TEXT,
+        after_state TEXT NOT NULL,
+        actor TEXT DEFAULT 'system',
+        checkpoint_name TEXT,
+        created_at INTEGER DEFAULT (strftime('%s', 'now'))
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_entity ON state_changes(entity);
+      CREATE INDEX IF NOT EXISTS idx_entity_type ON state_changes(entity_type);
+      CREATE INDEX IF NOT EXISTS idx_timestamp ON state_changes(timestamp);
+      CREATE INDEX IF NOT EXISTS idx_actor ON state_changes(actor);
+
+      CREATE TABLE IF NOT EXISTS checkpoints (
+        id TEXT PRIMARY KEY,
+        entity TEXT NOT NULL,
+        name TEXT NOT NULL,
+        timestamp TEXT NOT NULL,
+        state TEXT NOT NULL,
+        created_at INTEGER DEFAULT (strftime('%s', 'now'))
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_checkpoint_entity ON checkpoints(entity);
+      CREATE INDEX IF NOT EXISTS idx_checkpoint_name ON checkpoints(name);
+    `);
+    }
+    track(entityType, entityId, state, actor = 'system', checkpointName) {
+        const entity = `${entityType}:${entityId}`;
+        const id = (0, uuid_1.v4)();
+        const timestamp = new Date().toISOString();
+        const lastChange = this.getLastChange(entity);
+        const before = lastChange?.after || null;
+        const stmt = this.db.prepare(`
+      INSERT INTO state_changes (id, entity, entity_type, entity_id, timestamp, before_state, after_state, actor, checkpoint_name)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        stmt.run(id, entity, entityType, entityId, timestamp, before ? JSON.stringify(before) : null, JSON.stringify(state), actor, checkpointName || null);
+        this.enforceRetention(entity);
+        return {
+            id,
+            entity,
+            entityType,
+            entityId,
+            timestamp,
+            before,
+            after: state,
+            actor,
+            checkpointName
+        };
+    }
+    getLastChange(entity) {
+        const stmt = this.db.prepare(`
+      SELECT * FROM state_changes 
+      WHERE entity = ? 
+      ORDER BY timestamp DESC 
+      LIMIT 1
+    `);
+        const row = stmt.get(entity);
+        if (!row)
+            return null;
+        return this.rowToStateChange(row);
+    }
+    rowToStateChange(row) {
+        return {
+            id: row.id,
+            entity: row.entity,
+            entityType: row.entity_type,
+            entityId: row.entity_id,
+            timestamp: row.timestamp,
+            before: row.before_state ? JSON.parse(row.before_state) : null,
+            after: JSON.parse(row.after_state),
+            actor: row.actor,
+            checkpointName: row.checkpoint_name || undefined
+        };
+    }
+    getChanges(entity, options = {}) {
+        let query = 'SELECT * FROM state_changes WHERE entity = ?';
+        const params = [entity];
+        if (options.actor) {
+            query += ' AND actor = ?';
+            params.push(options.actor);
+        }
+        if (options.since) {
+            const sinceDate = this.parseSince(options.since);
+            query += ' AND timestamp >= ?';
+            params.push(sinceDate.toISOString());
+        }
+        query += ' ORDER BY timestamp ASC';
+        if (options.limit) {
+            query += ' LIMIT ?';
+            params.push(options.limit);
+        }
+        const stmt = this.db.prepare(query);
+        const rows = stmt.all(...params);
+        return rows.map(row => this.rowToStateChange(row));
+    }
+    getChangesByPattern(pattern, options = {}) {
+        const sqlPattern = pattern.replace(/\*/g, '%');
+        let query = 'SELECT * FROM state_changes WHERE entity LIKE ?';
+        const params = [sqlPattern];
+        if (options.actor) {
+            query += ' AND actor = ?';
+            params.push(options.actor);
+        }
+        if (options.since) {
+            const sinceDate = this.parseSince(options.since);
+            query += ' AND timestamp >= ?';
+            params.push(sinceDate.toISOString());
+        }
+        query += ' ORDER BY timestamp ASC';
+        if (options.limit) {
+            query += ' LIMIT ?';
+            params.push(options.limit);
+        }
+        const stmt = this.db.prepare(query);
+        const rows = stmt.all(...params);
+        return rows.map(row => this.rowToStateChange(row));
+    }
+    parseSince(since) {
+        const now = new Date();
+        const match = since.match(/^(\d+)\s*(h|hour|hours|d|day|days|m|min|minutes?|s|sec|seconds?)\s*ago$/i);
+        if (match) {
+            const value = parseInt(match[1], 10);
+            const unit = match[2].toLowerCase();
+            if (unit.startsWith('h')) {
+                now.setHours(now.getHours() - value);
+            }
+            else if (unit.startsWith('d')) {
+                now.setDate(now.getDate() - value);
+            }
+            else if (unit.startsWith('m')) {
+                now.setMinutes(now.getMinutes() - value);
+            }
+            else if (unit.startsWith('s')) {
+                now.setSeconds(now.getSeconds() - value);
+            }
+            return now;
+        }
+        return new Date(since);
+    }
+    undo(entity, steps = 1) {
+        const changes = this.getChanges(entity);
+        if (changes.length === 0) {
+            return { undone: [], restoredState: null };
+        }
+        const toUndo = changes.slice(-steps);
+        const ids = toUndo.map(c => c.id);
+        const deleteStmt = this.db.prepare(`
+      DELETE FROM state_changes WHERE id IN (${ids.map(() => '?').join(',')})
+    `);
+        deleteStmt.run(...ids);
+        const lastRemaining = this.getLastChange(entity);
+        const restoredState = lastRemaining?.after || null;
+        return { undone: toUndo, restoredState };
+    }
+    createCheckpoint(entity, name) {
+        const id = (0, uuid_1.v4)();
+        const timestamp = new Date().toISOString();
+        const lastChange = this.getLastChange(entity);
+        const state = lastChange?.after || {};
+        const stmt = this.db.prepare(`
+      INSERT INTO checkpoints (id, entity, name, timestamp, state)
+      VALUES (?, ?, ?, ?, ?)
+    `);
+        stmt.run(id, entity, name, timestamp, JSON.stringify(state));
+        return { id, entity, name, timestamp, state };
+    }
+    getCheckpoint(entity, name) {
+        const stmt = this.db.prepare(`
+      SELECT * FROM checkpoints 
+      WHERE entity = ? AND name = ? 
+      ORDER BY timestamp DESC 
+      LIMIT 1
+    `);
+        const row = stmt.get(entity, name);
+        if (!row)
+            return null;
+        return {
+            id: row.id,
+            entity: row.entity,
+            name: row.name,
+            timestamp: row.timestamp,
+            state: JSON.parse(row.state)
+        };
+    }
+    restoreCheckpoint(entity, name) {
+        const checkpoint = this.getCheckpoint(entity, name);
+        if (!checkpoint) {
+            return { restored: false, checkpoint: null };
+        }
+        const deleteStmt = this.db.prepare(`
+      DELETE FROM state_changes 
+      WHERE entity = ? AND timestamp > ?
+    `);
+        deleteStmt.run(entity, checkpoint.timestamp);
+        return { restored: true, checkpoint };
+    }
+    listEntities() {
+        const stmt = this.db.prepare(`
+      SELECT DISTINCT entity FROM state_changes ORDER BY entity
+    `);
+        const rows = stmt.all();
+        return rows.map(row => row.entity);
+    }
+    enforceRetention(entity) {
+        const maxChanges = this.config.retention.maxChangesPerEntity;
+        const countStmt = this.db.prepare(`
+      SELECT COUNT(*) as count FROM state_changes WHERE entity = ?
+    `);
+        const { count } = countStmt.get(entity);
+        if (count > maxChanges) {
+            const deleteCount = count - maxChanges;
+            const deleteStmt = this.db.prepare(`
+        DELETE FROM state_changes 
+        WHERE id IN (
+          SELECT id FROM state_changes 
+          WHERE entity = ? 
+          ORDER BY timestamp ASC 
+          LIMIT ?
+        )
+      `);
+            deleteStmt.run(entity, deleteCount);
+        }
+        const retentionDays = this.config.retention.days;
+        const cutoffDate = new Date();
+        cutoffDate.setDate(cutoffDate.getDate() - retentionDays);
+        const cleanupStmt = this.db.prepare(`
+      DELETE FROM state_changes 
+      WHERE timestamp < ?
+    `);
+        cleanupStmt.run(cutoffDate.toISOString());
+    }
+    getCurrentState(entity) {
+        const lastChange = this.getLastChange(entity);
+        return lastChange?.after || null;
+    }
+    close() {
+        this.db.close();
+    }
+}
+exports.StateStorage = StateStorage;
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,71 @@
+export interface StateChange {
+    id: string;
+    entity: string;
+    entityType: string;
+    entityId: string;
+    timestamp: string;
+    before: Record<string, unknown> | null;
+    after: Record<string, unknown>;
+    actor: string;
+    checkpointName?: string;
+}
+export interface Checkpoint {
+    id: string;
+    entity: string;
+    name: string;
+    timestamp: string;
+    state: Record<string, unknown>;
+}
+export interface ReplayResult {
+    entity: string;
+    changes: Array<{
+        timestamp: string;
+        step: number;
+        before: Record<string, unknown> | null;
+        after: Record<string, unknown>;
+        actor: string;
+        checkpointName?: string;
+    }>;
+    summary: string;
+    suggestedNextActions: string[];
+}
+export interface UndoResult {
+    entity: string;
+    stepsUndone: number;
+    restoredState: Record<string, unknown> | null;
+    summary: string;
+}
+export interface CheckpointResult {
+    id: string;
+    entity: string;
+    name: string;
+    timestamp: string;
+    summary: string;
+}
+export interface LogResult {
+    entity: string;
+    changes: StateChange[];
+    summary: string;
+}
+export interface TrackResult {
+    id: string;
+    entity: string;
+    timestamp: string;
+    summary: string;
+}
+export interface StateCLIConfig {
+    storage: {
+        type: 'local';
+        path: string;
+    };
+    autoTrack: {
+        enabled: boolean;
+        patterns: string[];
+    };
+    retention: {
+        days: number;
+        maxChangesPerEntity: number;
+    };
+}
+export declare const DEFAULT_CONFIG: StateCLIConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;QACvC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/B,KAAK,EAAE,MAAM,CAAC;QACd,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC,CAAC;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE;QACP,IAAI,EAAE,OAAO,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,SAAS,EAAE;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;IACF,SAAS,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;CACH;AAED,eAAO,MAAM,cAAc,EAAE,cAa5B,CAAC"}

package/dist/types.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONFIG = void 0;
+exports.DEFAULT_CONFIG = {
+    storage: {
+        type: 'local',
+        path: '.statecli/state.db'
+    },
+    autoTrack: {
+        enabled: true,
+        patterns: ['*']
+    },
+    retention: {
+        days: 30,
+        maxChangesPerEntity: 1000
+    }
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AA6Ea,QAAA,cAAc,GAAmB;IAC5C,OAAO,EAAE;QACP,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,oBAAoB;KAC3B;IACD,SAAS,EAAE;QACT,OAAO,EAAE,IAAI;QACb,QAAQ,EAAE,CAAC,GAAG,CAAC;KAChB;IACD,SAAS,EAAE;QACT,IAAI,EAAE,EAAE;QACR,mBAAmB,EAAE,IAAI;KAC1B;CACF,CAAC"}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "statecli-mcp-server",
+  "version": "0.1.0",
+  "description": "MCP Server for State Replay & Self-Debugging - Memory, replay, and undo capability for AI agents",
+  "main": "./dist/index.js",
+  "bin": {
+    "statecli": "./dist/cli.js",
+    "statecli-mcp-server": "./dist/index.js"
+  },
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts",
+    "cli": "ts-node src/cli.ts",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "state-management",
+    "state-replay",
+    "time-travel-debugging",
+    "undo",
+    "rollback",
+    "checkpoint",
+    "agent-memory",
+    "agent-introspection",
+    "self-debugging",
+    "ai-agent-tools",
+    "mcp-server",
+    "model-context-protocol",
+    "autonomous-agents",
+    "agent-observability",
+    "state-tracking",
+    "langchain-tools",
+    "autogpt-plugins",
+    "crewai-tools"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "better-sqlite3": "^11.0.0",
+    "commander": "^12.0.0",
+    "uuid": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.8",
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.11.0",
+    "@types/uuid": "^9.0.7",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.2",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.3.3"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/statecli/mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/statecli/mcp-server/issues"
+  },
+  "homepage": "https://github.com/statecli/mcp-server#readme",
+  "publishConfig": {
+    "access": "public"
+  }
+}