@redigg/redigg 0.1.0

package/dist/skills/SkillManager.d.ts

@@ -0,0 +1,31 @@
+import { Skill, SkillContext, SkillParams, SkillResult, SkillPack } from './types.js';
+import { LLMClient } from '../llm/LLMClient.js';
+import { MemoryManager } from '../memory/MemoryManager.js';
+export declare class SkillManager {
+    private managers?;
+    private skills;
+    private packs;
+    private llm;
+    private memoryManager;
+    private workspace;
+    private skillsDir;
+    constructor(llm: LLMClient, memoryManager: MemoryManager, workspace?: string, managers?: SkillContext['managers']);
+    setManagers(managers: SkillContext['managers']): void;
+    registerSkill(skill: Skill): void;
+    registerPack(pack: SkillPack): void;
+    unloadPack(packId: string): void;
+    loadSkillsFromDisk(): Promise<void>;
+    private loadSkill;
+    private parseFrontmatter;
+    private loadPack;
+    getSkill(id: string): Skill | undefined;
+    getPack(id: string): SkillPack | undefined;
+    getAllSkills(): Skill[];
+    getAllPacks(): SkillPack[];
+    getSkillStats(): any;
+    executeSkill(skillId: string, userId: string, params: SkillParams, handlers?: {
+        onLog?: SkillContext['log'];
+        onProgress?: SkillContext['updateProgress'];
+        onTodo?: SkillContext['addTodo'];
+    } | SkillContext['log']): Promise<SkillResult>;
+}

package/dist/skills/SkillManager.js

@@ -0,0 +1,254 @@
+import { createLogger } from '../utils/logger.js';
+import path from 'path';
+import fs from 'fs/promises';
+const logger = createLogger('SkillManager');
+export class SkillManager {
+    managers;
+    skills = new Map();
+    packs = new Map();
+    llm;
+    memoryManager;
+    workspace;
+    skillsDir;
+    constructor(llm, memoryManager, workspace = process.cwd(), managers) {
+        this.managers = managers;
+        this.llm = llm;
+        this.memoryManager = memoryManager;
+        this.workspace = workspace;
+        this.skillsDir = path.join(workspace, 'skills');
+        // this.registerSkill(new PdfGeneratorSkill());
+    }
+    setManagers(managers) {
+        this.managers = managers;
+    }
+    registerSkill(skill) {
+        this.skills.set(skill.id, skill);
+    }
+    registerPack(pack) {
+        this.packs.set(pack.id, pack);
+        for (const skill of pack.skills) {
+            this.registerSkill(skill);
+        }
+    }
+    unloadPack(packId) {
+        const pack = this.packs.get(packId);
+        if (pack) {
+            for (const skill of pack.skills) {
+                this.skills.delete(skill.id);
+            }
+            this.packs.delete(packId);
+        }
+    }
+    async loadSkillsFromDisk() {
+        try {
+            const entries = await fs.readdir(this.skillsDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isDirectory()) {
+                    const itemPath = path.join(this.skillsDir, entry.name);
+                    // Check if it's a Pack (has PACK.md)
+                    const packMdPath = path.join(itemPath, 'PACK.md');
+                    try {
+                        await fs.access(packMdPath);
+                        // It's a Pack
+                        await this.loadPack(itemPath, entry.name);
+                        continue;
+                    }
+                    catch (e) {
+                        // Not a pack
+                    }
+                    // Check if it's a Skill (has SKILL.md or just index.ts?)
+                    const skillMdPath = path.join(itemPath, 'SKILL.md');
+                    const indexTsPath = path.join(itemPath, 'index.ts');
+                    try {
+                        await fs.access(skillMdPath);
+                        // It's a Skill with metadata
+                        await this.loadSkill(itemPath);
+                    }
+                    catch (e) {
+                        // Maybe it's a skill without metadata?
+                        try {
+                            await fs.access(indexTsPath);
+                            await this.loadSkill(itemPath);
+                        }
+                        catch (e2) {
+                            // Not a skill
+                        }
+                    }
+                }
+            }
+        }
+        catch (e) {
+            logger.warn(`Failed to load skills from disk: ${e}`);
+        }
+    }
+    async loadSkill(skillPath) {
+        const implPath = path.join(skillPath, 'index.ts');
+        const skillId = path.basename(skillPath);
+        // 1. Try loading executable skill (index.ts)
+        try {
+            await fs.access(implPath);
+            // Use pathToFileURL to handle ESM import properly on all platforms
+            const { pathToFileURL } = await import('url');
+            // Add a timestamp query param to bust the cache when reloading
+            const moduleUrl = `${pathToFileURL(implPath).href}?t=${Date.now()}`;
+            const module = await import(moduleUrl);
+            if (module.default) {
+                const skillInstance = new module.default();
+                // Check if it's a valid skill
+                if (skillInstance.id && skillInstance.execute) {
+                    // Check for duplicates
+                    if (this.skills.has(skillInstance.id)) {
+                        logger.debug(`Overwriting existing skill: ${skillInstance.id}`);
+                    }
+                    this.skills.set(skillInstance.id, skillInstance);
+                    logger.info(`Registered skill: ${skillInstance.id}`);
+                    return skillInstance;
+                }
+            }
+        }
+        catch (e) {
+            // If index.ts missing or load failed, fall through to check SKILL.md
+            // But only log error if it existed but failed to load
+            if (e.code !== 'ENOENT') {
+                logger.error(`Failed to load skill from ${implPath}: ${e}`);
+            }
+        }
+        // 2. Try loading declarative skill (SKILL.md)
+        const skillMdPath = path.join(skillPath, 'SKILL.md');
+        try {
+            const content = await fs.readFile(skillMdPath, 'utf-8');
+            const frontmatter = this.parseFrontmatter(content);
+            if (frontmatter.name) {
+                const skill = {
+                    id: skillId,
+                    name: frontmatter.name,
+                    description: frontmatter.description || 'No description provided.',
+                    tags: ['vendor', 'declarative'],
+                    execute: async (ctx, params) => {
+                        return {
+                            success: true,
+                            message: `This is a declarative skill (${frontmatter.name}). It provides tools or capabilities but cannot be executed directly.`
+                        };
+                    }
+                };
+                this.skills.set(skill.id, skill);
+                logger.info(`Registered declarative skill: ${skill.id}`);
+                return skill;
+            }
+        }
+        catch (e) {
+            // Ignore if SKILL.md missing
+        }
+        return null;
+    }
+    parseFrontmatter(content) {
+        const match = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!match)
+            return {};
+        const yaml = match[1];
+        const result = {};
+        const nameMatch = yaml.match(/^name:\s*(.*)$/m);
+        if (nameMatch)
+            result.name = nameMatch[1].trim();
+        const descMatch = yaml.match(/^description:\s*(.*)$/m);
+        if (descMatch)
+            result.description = descMatch[1].trim();
+        return result;
+    }
+    async loadPack(packPath, packId) {
+        logger.info(`Loading skill pack: ${packId}`);
+        const pack = {
+            id: packId,
+            name: packId, // TODO: Parse from PACK.md
+            description: '',
+            skills: [],
+            path: packPath
+        };
+        // Scan for sub-directories which are skills
+        const entries = await fs.readdir(packPath, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                const skillPath = path.join(packPath, entry.name);
+                // Wait, if it's 'heartbeat' (no SKILL.md), loadSkill should still work because it looks for index.ts
+                // But verify loadSkill logic
+                const skill = await this.loadSkill(skillPath);
+                if (skill) {
+                    // Assign packId to skill for organization
+                    skill.packId = packId;
+                    pack.skills.push(skill);
+                }
+            }
+        }
+        this.packs.set(pack.id, pack);
+        logger.info(`Registered pack: ${packId} with ${pack.skills.length} skills`);
+    }
+    getSkill(id) {
+        return this.skills.get(id);
+    }
+    getPack(id) {
+        return this.packs.get(id);
+    }
+    getAllSkills() {
+        return Array.from(this.skills.values());
+    }
+    getAllPacks() {
+        return Array.from(this.packs.values());
+    }
+    getSkillStats() {
+        return {
+            totalSkills: this.skills.size,
+            totalPacks: this.packs.size,
+            skills: Array.from(this.skills.values()).map(s => ({
+                id: s.id,
+                name: s.name,
+                packId: s.packId
+            })),
+            packs: Array.from(this.packs.values()).map(p => ({ id: p.id, skillsCount: p.skills.length }))
+        };
+    }
+    async executeSkill(skillId, userId, params, handlers) {
+        const skill = this.skills.get(skillId);
+        if (!skill) {
+            throw new Error(`Skill ${skillId} not found`);
+        }
+        // Handle legacy signature where 4th arg was just onLog function
+        let onLog = handlers;
+        let onProgress = undefined;
+        let onTodo = undefined;
+        if (typeof handlers === 'object' && handlers !== null && !('apply' in handlers)) {
+            onLog = handlers.onLog;
+            onProgress = handlers.onProgress;
+            onTodo = handlers.onTodo;
+        }
+        else if (typeof handlers === 'function') {
+            onLog = handlers;
+        }
+        const context = {
+            llm: this.llm,
+            memory: this.memoryManager,
+            workspace: this.workspace,
+            userId,
+            managers: this.managers,
+            log: onLog || ((type, content, metadata) => {
+                logger.info(`[Skill:${skillId}] [${type}] ${content}`, metadata || '');
+            }),
+            updateProgress: onProgress || (async (progress, description, metadata) => {
+                logger.info(`[Skill:${skillId}] [PROGRESS] ${progress}% - ${description}`, metadata);
+            }),
+            addTodo: onTodo || (async (content, priority, step_number) => {
+                logger.info(`[Skill:${skillId}] [TODO] [${priority}] ${content} (step ${step_number})`);
+            }),
+            updateTodo: async (todoId, status, content) => {
+                logger.info(`[Skill:${skillId}] [TODO_UPDATE] ${todoId} -> ${status}`);
+            }
+        };
+        try {
+            return await skill.execute(context, params);
+        }
+        catch (error) {
+            context.log('error', `Execution failed: ${error}`);
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=SkillManager.js.map

package/dist/skills/SkillManager.js.map

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

package/dist/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/dist/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/dist/skills/agent/agent-orchestration/index.d.ts

@@ -0,0 +1,9 @@
+import { Skill, SkillContext, SkillParams, SkillResult } from '../../../src/skills/types.js';
+export default class AgentOrchestrationSkill implements Skill {
+    id: string;
+    name: string;
+    description: string;
+    tags: string[];
+    private static manager;
+    execute(ctx: SkillContext, params: SkillParams): Promise<SkillResult>;
+}

package/dist/skills/agent/agent-orchestration/index.js

@@ -0,0 +1,70 @@
+import { SubAgentManager } from '../../../src/agent/subagent/SubAgentManager.js';
+import { SkillManager } from '../../../src/skills/SkillManager.js';
+export default class AgentOrchestrationSkill {
+    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
+    static manager = null;
+    async execute(ctx, params) {
+        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 = {
+                        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;
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/skills/agent/agent-orchestration/index.js.map

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

package/dist/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/dist/skills/agent/evolution/index.d.ts

@@ -0,0 +1,9 @@
+import { Skill, SkillContext, SkillParams, SkillResult } from '../../../src/skills/types.js';
+export default class EvolutionSkill implements Skill {
+    id: string;
+    name: string;
+    description: string;
+    tags: string[];
+    private evoSystem;
+    execute(ctx: SkillContext, params: SkillParams): Promise<SkillResult>;
+}

package/dist/skills/agent/evolution/index.js

@@ -0,0 +1,57 @@
+import { SkillEvolutionSystem } from '../../../src/skills/evolution/SkillEvolutionSystem.js';
+import path from 'path';
+export default class EvolutionSkill {
+    id = 'evolution';
+    name = 'Evolution';
+    description = 'Self-evolve by creating or improving skills';
+    tags = ['system', 'evolution', 'meta'];
+    evoSystem = null;
+    async execute(ctx, params) {
+        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;
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/skills/agent/evolution/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../skills/agent/evolution/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uDAAuD,CAAC;AAC7F,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,CAAC,OAAO,OAAO,cAAc;IACjC,EAAE,GAAG,WAAW,CAAC;IACjB,IAAI,GAAG,WAAW,CAAC;IACnB,WAAW,GAAG,6CAA6C,CAAC;IAC5D,IAAI,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;IAE/B,SAAS,GAAgC,IAAI,CAAC;IAEtD,KAAK,CAAC,OAAO,CAAC,GAAiB,EAAE,MAAmB;QAClD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,cAAc,CAAC;QAErD,+FAA+F;QAC/F,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YAClB,8CAA8C;YAC9C,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,qCAAqC,CAAC,CAAC;YAE7E,mDAAmD;YACnD,qFAAqF;YACrF,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC;YACtF,0DAA0D;YAC1D,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;YAElC,MAAM,gBAAgB,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YAC5E,0DAA0D;YAC1D,MAAM,gBAAgB,CAAC,kBAAkB,EAAE,CAAC;YAE5C,6EAA6E;YAC7E,wEAAwE;YACxE,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YAEzD,IAAI,CAAC,SAAS,GAAG,IAAI,oBAAoB,CAAC,gBAAgB,EAAE,GAAG,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;QAC1F,CAAC;QAED,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,mCAAmC,SAAS,EAAE,CAAC,CAAC;QAEpE,IAAI,CAAC;YACH,QAAQ,SAAS,EAAE,CAAC;gBAClB,KAAK,cAAc;oBACjB,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;oBAC7B,IAAI,CAAC,MAAM;wBAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;oBAEhE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;oBAEzE,IAAI,MAAM,EAAE,CAAC;wBACX,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,+BAA+B,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;wBACxE,OAAO;4BACH,OAAO,EAAE,IAAI;4BACb,OAAO,EAAE,MAAM,CAAC,OAAO;4BACvB,OAAO,EAAE,+EAA+E;yBAC3F,CAAC;oBACJ,CAAC;yBAAM,CAAC;wBACN,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC;oBACvF,CAAC;gBAEH;oBACE,MAAM,IAAI,KAAK,CAAC,sBAAsB,SAAS,EAAE,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,qBAAqB,KAAK,EAAE,CAAC,CAAC;YAC/C,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/skills/agent/heartbeat/index.d.ts

@@ -0,0 +1,8 @@
+import { Skill, SkillContext, SkillParams, SkillResult } from '../../../src/skills/types.js';
+export default class HeartbeatSkill implements Skill {
+    id: string;
+    name: string;
+    description: string;
+    tags: string[];
+    execute(ctx: SkillContext, params: SkillParams): Promise<SkillResult>;
+}

package/dist/skills/agent/heartbeat/index.js

@@ -0,0 +1,44 @@
+export default class HeartbeatSkill {
+    id = 'heartbeat';
+    name = 'System Heartbeat';
+    description = 'Performs periodic system maintenance and checks';
+    tags = ['system', 'maintenance', 'heartbeat'];
+    async execute(ctx, params) {
+        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.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
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/skills/agent/heartbeat/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../skills/agent/heartbeat/index.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,OAAO,OAAO,cAAc;IACjC,EAAE,GAAG,WAAW,CAAC;IACjB,IAAI,GAAG,kBAAkB,CAAC;IAC1B,WAAW,GAAG,iDAAiD,CAAC;IAChE,IAAI,GAAG,CAAC,QAAQ,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;IAE9C,KAAK,CAAC,OAAO,CAAC,GAAiB,EAAE,MAAmB;QAClD,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,UAAU,CAAC,CAAC,gCAAgC;QAEzE,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,wBAAwB,CAAC,CAAC;QAE5C,0BAA0B;QAC1B,IAAI,WAAW,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC;YACD,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;gBACb,kDAAkD;gBAClD,WAAW,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;gBAC3D,IAAI,WAAW,CAAC,KAAK,GAAG,CAAC,IAAI,WAAW,CAAC,QAAQ,GAAG,CAAC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC9E,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,+BAA+B,WAAW,CAAC,KAAK,cAAc,WAAW,CAAC,QAAQ,YAAY,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC1I,CAAC;YACL,CAAC;QACL,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,gCAAgC,CAAC,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,uCAAuC;QACvC,IAAI,UAAU,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC;YACD,IAAI,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC;gBACrB,UAAU,GAAI,GAAG,CAAC,QAAQ,CAAC,KAAa,CAAC,aAAa,EAAE,CAAC;gBACzD,IAAI,UAAU,IAAI,UAAU,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;oBAC3C,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,8BAA8B,UAAU,CAAC,WAAW,KAAK,UAAU,CAAC,UAAU,SAAS,CAAC,CAAC;gBAC/G,CAAC;YACN,CAAC;QACL,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACT,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,iCAAiC,CAAC,EAAE,CAAC,CAAC;QAC3D,CAAC;QAED,OAAO;YACH,MAAM,EAAE,WAAW;YACnB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,MAAM,EAAE,WAAW;YACnB,MAAM,EAAE,UAAU;SACrB,CAAC;IACJ,CAAC;CACF"}

package/dist/skills/agent/memory-management/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: memory-management
+description: Manage and consolidate agent memories (Working, Short-term, Long-term)
+tags: [memory, system, consolidation]
+---
+
+# Memory Management
+
+This skill allows the agent to actively manage its own memory system.
+
+## Actions
+
+### consolidate
+Triggers the memory consolidation process.
+- Moves old working memories to short-term.
+- Promotes high-value short-term memories to long-term.
+- Prunes low-value, old memories.
+
+**Parameters:**
+- `userId` (optional): The user ID to consolidate memories for. Defaults to current user.
+
+### search
+Search through the agent's memories.
+
+**Parameters:**
+- `query` (required): The search term.
+- `limit` (optional): Max results (default 5).
+- `type` (optional): Filter by type (preference, fact, context, paper, experiment).
+- `tier` (optional): Filter by tier (working, short_term, long_term).
+
+### retrieve
+Retrieve all memories of a specific tier (e.g. "show me long term memories").
+
+**Parameters:**
+- `tier` (required): working, short_term, or long_term.
+
+
+## Examples
+
+- "Consolidate my memories" -> `consolidate`

package/dist/skills/agent/memory-management/index.d.ts

@@ -0,0 +1,8 @@
+import { Skill, SkillContext, SkillParams, SkillResult } from '../../../src/skills/types.js';
+export default class MemoryManagementSkill implements Skill {
+    id: string;
+    name: string;
+    description: string;
+    tags: string[];
+    execute(ctx: SkillContext, params: SkillParams): Promise<SkillResult>;
+}