@redigg/redigg 0.1.0

package/dist/src/storage/sqlite.js

@@ -0,0 +1,73 @@
+import Database from 'better-sqlite3';
+import path from 'path';
+import fs from 'fs';
+export class SQLiteStorage {
+    db;
+    constructor(dbPath) {
+        const defaultPath = path.join(process.cwd(), 'data', 'redigg.db');
+        const finalPath = dbPath || defaultPath;
+        // Ensure directory exists
+        const dir = path.dirname(finalPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        this.db = new Database(finalPath);
+        this.init();
+    }
+    init() {
+        // Initialize Memory Table
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS memories (
+        id TEXT PRIMARY KEY,
+        user_id TEXT NOT NULL,
+        type TEXT NOT NULL, -- 'preference', 'fact', 'context', 'paper', 'experiment'
+        content TEXT NOT NULL,
+        metadata TEXT, -- JSON string for structured data (e.g. paper details, URLs)
+        weight REAL DEFAULT 1.0,
+        created_at TEXT DEFAULT (datetime('now')),
+        updated_at TEXT DEFAULT (datetime('now'))
+      );
+      
+      CREATE INDEX IF NOT EXISTS idx_memories_user ON memories(user_id);
+      CREATE INDEX IF NOT EXISTS idx_memories_type ON memories(type);
+
+      -- Sessions Table
+      CREATE TABLE IF NOT EXISTS sessions (
+        id TEXT PRIMARY KEY,
+        user_id TEXT NOT NULL,
+        title TEXT,
+        created_at TEXT DEFAULT (datetime('now')),
+        updated_at TEXT DEFAULT (datetime('now')),
+        metadata TEXT
+      );
+      CREATE INDEX IF NOT EXISTS idx_sessions_user ON sessions(user_id);
+
+      -- Messages Table
+      CREATE TABLE IF NOT EXISTS messages (
+        id TEXT PRIMARY KEY,
+        session_id TEXT NOT NULL,
+        role TEXT NOT NULL, -- 'system', 'user', 'assistant'
+        content TEXT NOT NULL,
+        timestamp TEXT DEFAULT (datetime('now')),
+        metadata TEXT,
+        FOREIGN KEY(session_id) REFERENCES sessions(id) ON DELETE CASCADE
+      );
+      CREATE INDEX IF NOT EXISTS idx_messages_session ON messages(session_id);
+    `);
+        // Simple migration for existing tables (if any)
+        try {
+            this.db.exec(`ALTER TABLE memories ADD COLUMN metadata TEXT`);
+        }
+        catch (e) {
+            // Ignore error if column already exists
+        }
+        console.log('SQLite Storage initialized.');
+    }
+    getDb() {
+        return this.db;
+    }
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/src/storage/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../../../src/storage/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,MAAM,OAAO,aAAa;IAChB,EAAE,CAAoB;IAE9B,YAAY,MAAe;QACzB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAClE,MAAM,SAAS,GAAG,MAAM,IAAI,WAAW,CAAC;QAExC,0BAA0B;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAEO,IAAI;QACV,0BAA0B;QAC1B,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAqCZ,CAAC,CAAC;QAEH,gDAAgD;QAChD,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,wCAAwC;QAC1C,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;IAC7C,CAAC;IAEM,KAAK;QACV,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAEM,KAAK;QACV,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/src/utils/logger.d.ts

@@ -0,0 +1,12 @@
+declare class Logger {
+    private scope;
+    constructor(scope: string);
+    private formatMessage;
+    info(message: string, meta?: any): void;
+    warn(message: string, meta?: any): void;
+    error(message: string, meta?: any): void;
+    debug(message: string, meta?: any): void;
+    success(message: string, meta?: any): void;
+}
+export declare const createLogger: (scope: string) => Logger;
+export {};

package/dist/src/utils/logger.js

@@ -0,0 +1,53 @@
+import chalk from 'chalk';
+class Logger {
+    scope;
+    constructor(scope) {
+        this.scope = scope;
+    }
+    formatMessage(level, message, meta) {
+        const timestamp = new Date().toISOString();
+        const scopeStr = chalk.gray(`[${this.scope}]`);
+        let levelStr = '';
+        switch (level) {
+            case 'info':
+                levelStr = chalk.blue('INFO');
+                break;
+            case 'warn':
+                levelStr = chalk.yellow('WARN');
+                break;
+            case 'error':
+                levelStr = chalk.red('ERROR');
+                break;
+            case 'debug':
+                levelStr = chalk.magenta('DEBUG');
+                break;
+            case 'success':
+                levelStr = chalk.green('SUCCESS');
+                break;
+        }
+        let log = `${chalk.dim(timestamp)} ${levelStr} ${scopeStr} ${message}`;
+        if (meta) {
+            log += `\n${JSON.stringify(meta, null, 2)}`;
+        }
+        return log;
+    }
+    info(message, meta) {
+        console.log(this.formatMessage('info', message, meta));
+    }
+    warn(message, meta) {
+        console.warn(this.formatMessage('warn', message, meta));
+    }
+    error(message, meta) {
+        console.error(this.formatMessage('error', message, meta));
+    }
+    debug(message, meta) {
+        if (process.env.DEBUG) {
+            console.debug(this.formatMessage('debug', message, meta));
+        }
+    }
+    success(message, meta) {
+        console.log(this.formatMessage('success', message, meta));
+    }
+}
+export const createLogger = (scope) => new Logger(scope);
+//# sourceMappingURL=logger.js.map

package/dist/src/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,MAAM,MAAM;IACF,KAAK,CAAS;IAEtB,YAAY,KAAa;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAEO,aAAa,CAAC,KAAe,EAAE,OAAe,EAAE,IAAU;QAChE,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;QAE/C,IAAI,QAAQ,GAAG,EAAE,CAAC;QAClB,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,MAAM;gBACT,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC9B,MAAM;YACR,KAAK,MAAM;gBACT,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAChC,MAAM;YACR,KAAK,OAAO;gBACV,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC9B,MAAM;YACR,KAAK,OAAO;gBACV,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBAClC,MAAM;YACR,KAAK,SAAS;gBACZ,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBAClC,MAAM;QACV,CAAC;QAED,IAAI,GAAG,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,QAAQ,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;QACvE,IAAI,IAAI,EAAE,CAAC;YACT,GAAG,IAAI,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QAC9C,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAEM,IAAI,CAAC,OAAe,EAAE,IAAU;QACrC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IACzD,CAAC;IAEM,IAAI,CAAC,OAAe,EAAE,IAAU;QACrC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAC1D,CAAC;IAEM,KAAK,CAAC,OAAe,EAAE,IAAU;QACtC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAC5D,CAAC;IAEM,KAAK,CAAC,OAAe,EAAE,IAAU;QACtC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAEM,OAAO,CAAC,OAAe,EAAE,IAAU;QACxC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAC5D,CAAC;CACF;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC"}

package/dist/storage/sqlite.d.ts

@@ -0,0 +1,8 @@
+import Database from 'better-sqlite3';
+export declare class SQLiteStorage {
+    private db;
+    constructor(dbPath?: string);
+    private init;
+    getDb(): Database.Database;
+    close(): void;
+}

package/dist/storage/sqlite.js

@@ -0,0 +1,73 @@
+import Database from 'better-sqlite3';
+import path from 'path';
+import fs from 'fs';
+export class SQLiteStorage {
+    db;
+    constructor(dbPath) {
+        const defaultPath = path.join(process.cwd(), 'data', 'redigg.db');
+        const finalPath = dbPath || defaultPath;
+        // Ensure directory exists
+        const dir = path.dirname(finalPath);
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        this.db = new Database(finalPath);
+        this.init();
+    }
+    init() {
+        // Initialize Memory Table
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS memories (
+        id TEXT PRIMARY KEY,
+        user_id TEXT NOT NULL,
+        type TEXT NOT NULL, -- 'preference', 'fact', 'context', 'paper', 'experiment'
+        content TEXT NOT NULL,
+        metadata TEXT, -- JSON string for structured data (e.g. paper details, URLs)
+        weight REAL DEFAULT 1.0,
+        created_at TEXT DEFAULT (datetime('now')),
+        updated_at TEXT DEFAULT (datetime('now'))
+      );
+      
+      CREATE INDEX IF NOT EXISTS idx_memories_user ON memories(user_id);
+      CREATE INDEX IF NOT EXISTS idx_memories_type ON memories(type);
+
+      -- Sessions Table
+      CREATE TABLE IF NOT EXISTS sessions (
+        id TEXT PRIMARY KEY,
+        user_id TEXT NOT NULL,
+        title TEXT,
+        created_at TEXT DEFAULT (datetime('now')),
+        updated_at TEXT DEFAULT (datetime('now')),
+        metadata TEXT
+      );
+      CREATE INDEX IF NOT EXISTS idx_sessions_user ON sessions(user_id);
+
+      -- Messages Table
+      CREATE TABLE IF NOT EXISTS messages (
+        id TEXT PRIMARY KEY,
+        session_id TEXT NOT NULL,
+        role TEXT NOT NULL, -- 'system', 'user', 'assistant'
+        content TEXT NOT NULL,
+        timestamp TEXT DEFAULT (datetime('now')),
+        metadata TEXT,
+        FOREIGN KEY(session_id) REFERENCES sessions(id) ON DELETE CASCADE
+      );
+      CREATE INDEX IF NOT EXISTS idx_messages_session ON messages(session_id);
+    `);
+        // Simple migration for existing tables (if any)
+        try {
+            this.db.exec(`ALTER TABLE memories ADD COLUMN metadata TEXT`);
+        }
+        catch (e) {
+            // Ignore error if column already exists
+        }
+        console.log('SQLite Storage initialized.');
+    }
+    getDb() {
+        return this.db;
+    }
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/storage/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../../src/storage/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,MAAM,OAAO,aAAa;IAChB,EAAE,CAAoB;IAE9B,YAAY,MAAe;QACzB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAClE,MAAM,SAAS,GAAG,MAAM,IAAI,WAAW,CAAC;QAExC,0BAA0B;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAEO,IAAI;QACV,0BAA0B;QAC1B,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAqCZ,CAAC,CAAC;QAEH,gDAAgD;QAChD,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,wCAAwC;QAC1C,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;IAC7C,CAAC;IAEM,KAAK;QACV,OAAO,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC;IAEM,KAAK;QACV,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,12 @@
+declare class Logger {
+    private scope;
+    constructor(scope: string);
+    private formatMessage;
+    info(message: string, meta?: any): void;
+    warn(message: string, meta?: any): void;
+    error(message: string, meta?: any): void;
+    debug(message: string, meta?: any): void;
+    success(message: string, meta?: any): void;
+}
+export declare const createLogger: (scope: string) => Logger;
+export {};

package/dist/utils/logger.js

@@ -0,0 +1,53 @@
+import chalk from 'chalk';
+class Logger {
+    scope;
+    constructor(scope) {
+        this.scope = scope;
+    }
+    formatMessage(level, message, meta) {
+        const timestamp = new Date().toISOString();
+        const scopeStr = chalk.gray(`[${this.scope}]`);
+        let levelStr = '';
+        switch (level) {
+            case 'info':
+                levelStr = chalk.blue('INFO');
+                break;
+            case 'warn':
+                levelStr = chalk.yellow('WARN');
+                break;
+            case 'error':
+                levelStr = chalk.red('ERROR');
+                break;
+            case 'debug':
+                levelStr = chalk.magenta('DEBUG');
+                break;
+            case 'success':
+                levelStr = chalk.green('SUCCESS');
+                break;
+        }
+        let log = `${chalk.dim(timestamp)} ${levelStr} ${scopeStr} ${message}`;
+        if (meta) {
+            log += `\n${JSON.stringify(meta, null, 2)}`;
+        }
+        return log;
+    }
+    info(message, meta) {
+        console.log(this.formatMessage('info', message, meta));
+    }
+    warn(message, meta) {
+        console.warn(this.formatMessage('warn', message, meta));
+    }
+    error(message, meta) {
+        console.error(this.formatMessage('error', message, meta));
+    }
+    debug(message, meta) {
+        if (process.env.DEBUG) {
+            console.debug(this.formatMessage('debug', message, meta));
+        }
+    }
+    success(message, meta) {
+        console.log(this.formatMessage('success', message, meta));
+    }
+}
+export const createLogger = (scope) => new Logger(scope);
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,MAAM,MAAM;IACF,KAAK,CAAS;IAEtB,YAAY,KAAa;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAEO,aAAa,CAAC,KAAe,EAAE,OAAe,EAAE,IAAU;QAChE,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;QAE/C,IAAI,QAAQ,GAAG,EAAE,CAAC;QAClB,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,MAAM;gBACT,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC9B,MAAM;YACR,KAAK,MAAM;gBACT,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAChC,MAAM;YACR,KAAK,OAAO;gBACV,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC9B,MAAM;YACR,KAAK,OAAO;gBACV,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;gBAClC,MAAM;YACR,KAAK,SAAS;gBACZ,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;gBAClC,MAAM;QACV,CAAC;QAED,IAAI,GAAG,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,QAAQ,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;QACvE,IAAI,IAAI,EAAE,CAAC;YACT,GAAG,IAAI,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QAC9C,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAEM,IAAI,CAAC,OAAe,EAAE,IAAU;QACrC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IACzD,CAAC;IAEM,IAAI,CAAC,OAAe,EAAE,IAAU;QACrC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAC1D,CAAC;IAEM,KAAK,CAAC,OAAe,EAAE,IAAU;QACtC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAC5D,CAAC;IAEM,KAAK,CAAC,OAAe,EAAE,IAAU;QACtC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAEM,OAAO,CAAC,OAAe,EAAE,IAAU;QACxC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAC5D,CAAC;CACF;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@redigg/redigg",
+  "version": "0.1.0",
+  "description": "Autonomous Research Agent for Scientific Discovery",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/src/index.js",
+  "bin": {
+    "redigg": "./dist/src/bin.js"
+  },
+  "files": [
+    "dist",
+    "web/dist",
+    "skills",
+    "README.md",
+    "package.json"
+  ],
+  "scripts": {
+    "build": "tsc && rsync -avm --include='*.md' --include='*/' --exclude='*' skills/ dist/skills/ && npm run build --prefix web",
+    "start": "node dist/src/index.js",
+    "dev": "concurrently \"npm run dev:backend\" \"npm run dev:frontend\" --names \"gateway,ui\" --prefix-colors \"blue,magenta\" --kill-others",
+    "dev:backend": "tsx watch src/index.ts",
+    "dev:frontend": "npm run dev --prefix web",
+    "test": "vitest run",
+    "lint": "oxlint",
+    "postinstall": "npm install --prefix web",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@a2a-js/sdk": "^0.3.10",
+    "@agentclientprotocol/sdk": "^0.15.0",
+    "@types/node-cron": "^3.0.11",
+    "better-sqlite3": "^11.0.0",
+    "chalk": "^5.3.0",
+    "commander": "^14.0.3",
+    "dotenv": "^16.4.5",
+    "eventemitter3": "^5.0.4",
+    "express": "^4.22.1",
+    "fast-xml-parser": "^5.4.2",
+    "multer": "^2.1.1",
+    "node-cron": "^4.2.1",
+    "openai": "^4.28.0",
+    "ora": "^9.3.0",
+    "pdfkit": "^0.17.2",
+    "sqlite-vec": "^0.1.0",
+    "tiktoken": "^1.0.22",
+    "uuid": "^13.0.0",
+    "ws": "^8.16.0",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.9",
+    "@types/express": "^4.17.25",
+    "@types/multer": "^2.1.0",
+    "@types/node": "^22.0.0",
+    "@types/pdfkit": "^0.17.5",
+    "@types/uuid": "^10.0.0",
+    "@types/ws": "^8.5.10",
+    "@vitest/coverage-v8": "^1.6.1",
+    "concurrently": "^9.2.1",
+    "oxlint": "^0.2.10",
+    "tsx": "^4.7.1",
+    "typescript": "^5.3.3",
+    "vitest": "^1.3.1"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  }
+}

package/skills/agent/PACK.md

@@ -0,0 +1,13 @@
+# Agent Skills Pack
+
+Core agent capabilities and meta-skills.
+
+## Skills
+
+- `agent-orchestration`: Managing sub-agents and task delegation
+- `evolution`: Self-improvement and skill acquisition
+- `memory-management`: Storage and retrieval of information
+- `scheduling`: Task timing and cron jobs
+- `session-management`: User interaction context
+- `skill-management`: Loading and executing other skills
+- `heartbeat`: System pulse and recurring checks

package/skills/agent/agent-orchestration/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: agent-orchestration
+description: Create and manage sub-agents to perform tasks in parallel
+tags: [system, agent, orchestration]
+---
+
+# Agent Orchestration
+
+This skill allows the main agent to spawn sub-agents and delegate tasks to them.
+
+## Actions
+
+### create_agent
+Create a new sub-agent.
+
+**Parameters:**
+- `name` (required): Name of the sub-agent.
+- `role` (required): Role description (e.g. "Researcher", "Coder").
+
+### list_agents
+List all active sub-agents.
+
+### delegate
+Delegate a task to a specific sub-agent.
+
+**Parameters:**
+- `agentId` (required): The ID of the sub-agent.
+- `task` (required): Task description.
+- `skills` (optional): Array of skill IDs the sub-agent should use.
+
+### parallel_execution
+Execute multiple tasks in parallel using different agents. (Advanced)
+
+## Examples
+
+- "Create a research assistant" -> `create_agent(name="Alice", role="Researcher")`
+- "Ask Alice to search for papers" -> `delegate(agentId="<alice_id>", task="Search for LLM papers", skills=["literature_review"])`

package/skills/agent/agent-orchestration/index.ts

@@ -0,0 +1,84 @@
+import { Skill, SkillContext, SkillParams, SkillResult } from '../../../src/skills/types.js';
+import { SubAgentManager } from '../../../src/agent/subagent/SubAgentManager.js';
+import { SubAgentTask } from '../../../src/agent/subagent/SubAgent.js';
+import { SkillManager } from '../../../src/skills/SkillManager.js';
+import path from 'path';
+
+export default class AgentOrchestrationSkill implements Skill {
+  id = 'agent_orchestration';
+  name = 'Agent Orchestration';
+  description = 'Create and manage sub-agents';
+  tags = ['system', 'agent', 'orchestration'];
+
+  // Static instance to persist agents across skill executions in the same process
+  private static manager: SubAgentManager | null = null;
+
+  async execute(ctx: SkillContext, params: SkillParams): Promise<SkillResult> {
+    const operation = params.operation || 'list_agents';
+
+    if (!AgentOrchestrationSkill.manager) {
+        // Initialize manager
+        // We need a SkillManager instance. We can create a new one sharing the same config.
+        const projectRoot = process.cwd();
+        const skillManager = new SkillManager(ctx.llm, ctx.memory, projectRoot);
+        await skillManager.loadSkillsFromDisk();
+        
+        AgentOrchestrationSkill.manager = new SubAgentManager(ctx.llm, ctx.memory, skillManager);
+    }
+
+    const manager = AgentOrchestrationSkill.manager;
+
+    ctx.log('thinking', `Performing agent orchestration: ${operation}`);
+
+    try {
+      switch (operation) {
+        case 'create_agent':
+          const name = params.name;
+          const role = params.role;
+          if (!name || !role) throw new Error('Name and role are required');
+          
+          const agent = manager.createSubAgent(name, role);
+          ctx.log('tool_result', `Created agent ${name} (${agent.id})`);
+          return { success: true, agentId: agent.id, name: agent.name };
+
+        case 'list_agents':
+          const agents = manager.getAllSubAgents();
+          return { 
+              agents: agents.map(a => ({ id: a.id, name: a.name, role: a.role })) 
+          };
+
+        case 'delegate':
+          const agentId = params.agentId;
+          const taskDesc = params.task;
+          const skills = params.skills || [];
+          
+          if (!agentId || !taskDesc) throw new Error('AgentId and task are required');
+          
+          const subAgent = manager.getSubAgent(agentId);
+          if (!subAgent) throw new Error(`Agent ${agentId} not found`);
+          
+          const task: SubAgentTask = {
+              id: Date.now().toString(),
+              description: taskDesc,
+              status: 'pending',
+              requiredSkills: skills
+          };
+          
+          const result = await subAgent.executeTask(task);
+          return { success: true, result: result };
+
+        case 'remove_agent':
+          const removeId = params.agentId;
+          if (!removeId) throw new Error('AgentId is required');
+          manager.terminateSubAgent(removeId);
+          return { success: true, message: 'Agent removed' };
+
+        default:
+          throw new Error(`Unknown operation: ${operation}`);
+      }
+    } catch (error) {
+      ctx.log('error', `Orchestration failed: ${error}`);
+      throw error;
+    }
+  }
+}

package/skills/agent/evolution/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: evolution
+description: Self-evolve by creating or improving skills
+tags: [system, evolution, meta]
+---
+
+# Evolution
+
+This skill allows the agent to modify its own capabilities by generating new skills or updating existing ones.
+
+## Actions
+
+### create_skill
+Generates a new skill based on a description or intent.
+
+**Parameters:**
+- `intent` (required): Description of what the new skill should do.
+- `feedback` (optional): Additional context or constraints.
+
+### improve_skill
+Updates an existing skill based on feedback. (Future)
+
+## Examples
+
+- "Create a skill to fetch weather data" -> `create_skill(intent="fetch weather data")`

package/skills/agent/evolution/index.ts

@@ -0,0 +1,67 @@
+import { Skill, SkillContext, SkillParams, SkillResult } from '../../../src/skills/types.js';
+import { SkillEvolutionSystem } from '../../../src/skills/evolution/SkillEvolutionSystem.js';
+import path from 'path';
+
+export default class EvolutionSkill implements Skill {
+  id = 'evolution';
+  name = 'Evolution';
+  description = 'Self-evolve by creating or improving skills';
+  tags = ['system', 'evolution', 'meta'];
+
+  private evoSystem: SkillEvolutionSystem | null = null;
+
+  async execute(ctx: SkillContext, params: SkillParams): Promise<SkillResult> {
+    const operation = params.operation || 'create_skill';
+    
+    // Lazy init of the evolution system to avoid circular dependency issues at startup if possible
+    if (!this.evoSystem) {
+        // Dynamic import to avoid circular dependency
+        const { SkillManager } = await import('../../../src/skills/SkillManager.js');
+        
+        // We need to point to the correct skills directory
+        // Assuming current file is in skills/evolution/index.ts, we want to go up to skills/
+        const skillsDir = path.resolve(path.dirname(new URL(import.meta.url).pathname), '..'); 
+        // Or just use process.cwd()/skills which is safer for now
+        const projectRoot = process.cwd();
+        
+        const tempSkillManager = new SkillManager(ctx.llm, ctx.memory, projectRoot);
+        // Load existing skills so the EvoSystem knows what exists
+        await tempSkillManager.loadSkillsFromDisk();
+        
+        // Point EvoSystem to the 'skills' directory, NOT 'src/skills/impl/generated'
+        // This is crucial: we want new skills to land in the main skills folder
+        const targetSkillsDir = path.join(projectRoot, 'skills');
+        
+        this.evoSystem = new SkillEvolutionSystem(tempSkillManager, ctx.llm, targetSkillsDir);
+    }
+
+    ctx.log('thinking', `Performing evolution operation: ${operation}`);
+
+    try {
+      switch (operation) {
+        case 'create_skill':
+          const intent = params.intent;
+          if (!intent) throw new Error('Intent is required for creation');
+          
+          const result = await this.evoSystem.evolveSkill(intent, params.feedback);
+          
+          if (result) {
+            ctx.log('tool_result', `Successfully evolved skill: ${result.skillId}`);
+            return { 
+                success: true, 
+                skillId: result.skillId,
+                message: 'New skill created. It will be available after reload or dynamic registration.' 
+            };
+          } else {
+            return { success: false, message: 'No new skill was generated (maybe not needed).' };
+          }
+
+        default:
+          throw new Error(`Unknown operation: ${operation}`);
+      }
+    } catch (error) {
+      ctx.log('error', `Evolution failed: ${error}`);
+      throw error;
+    }
+  }
+}

package/skills/agent/heartbeat/index.ts

@@ -0,0 +1,48 @@
+import { Skill, SkillContext, SkillParams, SkillResult } from '../../../src/skills/types.js';
+
+export default class HeartbeatSkill implements Skill {
+  id = 'heartbeat';
+  name = 'System Heartbeat';
+  description = 'Performs periodic system maintenance and checks';
+  tags = ['system', 'maintenance', 'heartbeat'];
+
+  async execute(ctx: SkillContext, params: SkillParams): Promise<SkillResult> {
+    const userId = ctx.userId || 'web-user'; // Default user for system tasks
+    
+    ctx.log('action', 'Executing heartbeat...');
+    
+    // 1. Memory Consolidation
+    let memoryStats = { moved: 0, promoted: 0, pruned: 0 };
+    try {
+        if (ctx.memory) {
+            // ctx.log('action', 'Consolidating memories...');
+            memoryStats = await ctx.memory.consolidateMemories(userId);
+            if (memoryStats.moved > 0 || memoryStats.promoted > 0 || memoryStats.pruned > 0) {
+                ctx.log('result', `Memory consolidation: Moved ${memoryStats.moved}, Promoted ${memoryStats.promoted}, Pruned ${memoryStats.pruned}`);
+            }
+        }
+    } catch (e) {
+        ctx.log('error', `Memory consolidation failed: ${e}`);
+    }
+
+    // 2. Skill Evolution Check (Proactive)
+    let skillStats = null;
+    try {
+        if (ctx.managers?.skill) {
+             skillStats = (ctx.managers.skill as any).getSkillStats();
+             if (skillStats && skillStats.totalSkills > 0) {
+                 ctx.log('result', `[Evolution] Active Skills: ${skillStats.totalSkills} (${skillStats.totalPacks} packs)`);
+             }
+        }
+    } catch (e) {
+        ctx.log('error', `Skill evolution check failed: ${e}`);
+    }
+
+    return {
+        status: 'completed',
+        timestamp: Date.now(),
+        memory: memoryStats,
+        skills: skillStats
+    };
+  }
+}