helixmind 0.5.4

package/dist/cli/jarvis/skills.js

@@ -0,0 +1,367 @@
+/**
+ * Jarvis Skill Manager — Discover, install, activate, and create modular skills.
+ *
+ * Skills live in .helixmind/jarvis/skills/<name>/ with a skill.json manifest.
+ * They register tools into the agent loop at runtime.
+ * Jarvis can create new skills autonomously (through the Proposal system).
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { execSync } from 'node:child_process';
+const EMPTY_REGISTRY = { version: 1, skills: [] };
+export class SkillManager {
+    registry;
+    registryPath;
+    skillsDir;
+    activeHandlers = new Map();
+    toolRegistry = new Map();
+    onChange;
+    constructor(projectRoot, onChange) {
+        this.skillsDir = join(projectRoot, '.helixmind', 'jarvis', 'skills');
+        this.registryPath = join(projectRoot, '.helixmind', 'jarvis', 'skill-registry.json');
+        this.onChange = onChange;
+        this.registry = this.load();
+    }
+    // ─── Persistence ─────────────────────────────────────────────────────
+    load() {
+        try {
+            if (existsSync(this.registryPath)) {
+                const raw = readFileSync(this.registryPath, 'utf-8');
+                const parsed = JSON.parse(raw);
+                if (parsed.version === 1 && Array.isArray(parsed.skills))
+                    return parsed;
+            }
+        }
+        catch { /* corrupted — start fresh */ }
+        return { ...EMPTY_REGISTRY, skills: [] };
+    }
+    save() {
+        const dir = dirname(this.registryPath);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        writeFileSync(this.registryPath, JSON.stringify(this.registry, null, 2), 'utf-8');
+    }
+    // ─── Discovery ───────────────────────────────────────────────────────
+    /**
+     * Scan the skills directory for skill.json manifests.
+     * Returns manifests of discovered (but not necessarily installed) skills.
+     */
+    discoverSkills() {
+        if (!existsSync(this.skillsDir))
+            return [];
+        const manifests = [];
+        try {
+            const dirs = readdirSync(this.skillsDir, { withFileTypes: true })
+                .filter(d => d.isDirectory());
+            for (const dir of dirs) {
+                const manifestPath = join(this.skillsDir, dir.name, 'skill.json');
+                if (existsSync(manifestPath)) {
+                    try {
+                        const raw = readFileSync(manifestPath, 'utf-8');
+                        const manifest = JSON.parse(raw);
+                        if (manifest.name && manifest.main) {
+                            manifests.push(manifest);
+                        }
+                    }
+                    catch { /* skip malformed manifests */ }
+                }
+            }
+        }
+        catch { /* skills dir unreadable */ }
+        return manifests;
+    }
+    /**
+     * Sync discovered skills with registry.
+     * Adds new skills as 'available', keeps existing status.
+     */
+    syncRegistry() {
+        const discovered = this.discoverSkills();
+        for (const manifest of discovered) {
+            const existing = this.registry.skills.find(s => s.manifest.name === manifest.name);
+            if (!existing) {
+                this.registry.skills.push({
+                    manifest,
+                    status: 'available',
+                    installedAt: Date.now(),
+                    usageCount: 0,
+                    errors: [],
+                    path: join(this.skillsDir, manifest.name),
+                });
+            }
+            else {
+                // Update manifest if version changed
+                if (existing.manifest.version !== manifest.version) {
+                    existing.manifest = manifest;
+                }
+            }
+        }
+        this.save();
+    }
+    // ─── Install / Activate ──────────────────────────────────────────────
+    /**
+     * Install a skill's npm dependencies (if any).
+     */
+    async installSkill(name) {
+        const entry = this.getSkill(name);
+        if (!entry)
+            return { success: false, error: `Skill "${name}" not found` };
+        const deps = entry.manifest.dependencies;
+        if (!deps || Object.keys(deps).length === 0) {
+            entry.status = 'installed';
+            this.save();
+            return { success: true };
+        }
+        const skillDir = join(this.skillsDir, name);
+        const pkgJsonPath = join(skillDir, 'package.json');
+        // Create package.json if it doesn't exist
+        if (!existsSync(pkgJsonPath)) {
+            writeFileSync(pkgJsonPath, JSON.stringify({
+                name: `helixmind-skill-${name}`,
+                version: entry.manifest.version,
+                private: true,
+                type: 'module',
+                dependencies: deps,
+            }, null, 2), 'utf-8');
+        }
+        try {
+            execSync('npm install --production', {
+                cwd: skillDir,
+                stdio: 'pipe',
+                timeout: 120_000,
+            });
+            entry.status = 'installed';
+            this.save();
+            this.onChange?.('skill_installed', entry);
+            return { success: true };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            entry.status = 'error';
+            entry.errors.push(`Install failed: ${msg.slice(0, 200)}`);
+            this.save();
+            return { success: false, error: msg };
+        }
+    }
+    /**
+     * Activate a skill — load its code and register tools.
+     */
+    async activateSkill(name, ctx) {
+        const entry = this.getSkill(name);
+        if (!entry)
+            return { success: false, error: `Skill "${name}" not found` };
+        // Install first if needed
+        if (entry.status === 'available') {
+            const installResult = await this.installSkill(name);
+            if (!installResult.success)
+                return installResult;
+        }
+        const entryPoint = join(this.skillsDir, name, entry.manifest.main);
+        if (!existsSync(entryPoint)) {
+            return { success: false, error: `Entry point not found: ${entry.manifest.main}` };
+        }
+        try {
+            // Dynamic import of the skill module
+            const mod = await import(`file://${entryPoint.replace(/\\/g, '/')}`);
+            const skill = mod.default || mod;
+            if (typeof skill.activate === 'function') {
+                await skill.activate(ctx);
+            }
+            // Register declared tools
+            if (entry.manifest.tools) {
+                for (const toolDef of entry.manifest.tools) {
+                    if (typeof skill[toolDef.name] === 'function') {
+                        this.toolRegistry.set(toolDef.name, {
+                            def: toolDef,
+                            handler: skill[toolDef.name].bind(skill),
+                            skillName: name,
+                        });
+                    }
+                }
+            }
+            this.activeHandlers.set(name, {
+                deactivate: typeof skill.deactivate === 'function' ? skill.deactivate.bind(skill) : undefined,
+            });
+            entry.status = 'active';
+            this.save();
+            this.onChange?.('skill_activated', entry);
+            return { success: true };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            entry.status = 'error';
+            entry.errors.push(`Activation failed: ${msg.slice(0, 200)}`);
+            this.save();
+            return { success: false, error: msg };
+        }
+    }
+    /**
+     * Deactivate a skill — unregister tools and call deactivate().
+     */
+    async deactivateSkill(name) {
+        const handler = this.activeHandlers.get(name);
+        if (handler?.deactivate) {
+            try {
+                await handler.deactivate();
+            }
+            catch { /* non-critical */ }
+        }
+        this.activeHandlers.delete(name);
+        // Unregister tools from this skill
+        for (const [toolName, reg] of this.toolRegistry) {
+            if (reg.skillName === name) {
+                this.toolRegistry.delete(toolName);
+            }
+        }
+        const entry = this.getSkill(name);
+        if (entry) {
+            entry.status = 'disabled';
+            this.save();
+            this.onChange?.('skill_deactivated', entry);
+        }
+    }
+    // ─── Create (Jarvis Self-Building) ───────────────────────────────────
+    /**
+     * Create a new skill from manifest + code.
+     * Used when Jarvis builds a new skill after proposal approval.
+     */
+    async createSkill(manifest, code, origin = 'jarvis_created') {
+        const skillDir = join(this.skillsDir, manifest.name);
+        if (existsSync(skillDir)) {
+            return { success: false, error: `Skill "${manifest.name}" already exists` };
+        }
+        try {
+            mkdirSync(skillDir, { recursive: true });
+            // Write manifest
+            const fullManifest = { ...manifest, origin };
+            writeFileSync(join(skillDir, 'skill.json'), JSON.stringify(fullManifest, null, 2), 'utf-8');
+            // Write code
+            writeFileSync(join(skillDir, manifest.main), code, 'utf-8');
+            // Register in registry
+            const entry = {
+                manifest: fullManifest,
+                status: 'available',
+                installedAt: Date.now(),
+                usageCount: 0,
+                errors: [],
+                path: skillDir,
+            };
+            this.registry.skills.push(entry);
+            this.save();
+            this.onChange?.('skill_created', entry);
+            return { success: true, path: skillDir };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { success: false, error: msg };
+        }
+    }
+    // ─── Query ───────────────────────────────────────────────────────────
+    getSkill(name) {
+        return this.registry.skills.find(s => s.manifest.name === name);
+    }
+    listSkills() {
+        return [...this.registry.skills];
+    }
+    getActiveSkills() {
+        return this.registry.skills.filter(s => s.status === 'active');
+    }
+    getSkillTool(toolName) {
+        return this.toolRegistry.get(toolName);
+    }
+    getAllSkillTools() {
+        return new Map(this.toolRegistry);
+    }
+    /**
+     * Record outcome (success/failure) for a skill, updating effectiveness data.
+     */
+    recordOutcome(name, success, qualityDelta = 0) {
+        const entry = this.getSkill(name);
+        if (!entry)
+            return;
+        if (!entry.effectiveness) {
+            entry.effectiveness = {
+                skillName: name,
+                timesUsed: 0,
+                timesSuccessful: 0,
+                avgQualityDelta: 0,
+                lastUsedAt: Date.now(),
+            };
+        }
+        entry.effectiveness.timesUsed++;
+        if (success)
+            entry.effectiveness.timesSuccessful++;
+        const prev = entry.effectiveness.avgQualityDelta;
+        entry.effectiveness.avgQualityDelta =
+            (prev * (entry.effectiveness.timesUsed - 1) + qualityDelta) / entry.effectiveness.timesUsed;
+        entry.effectiveness.lastUsedAt = Date.now();
+        this.save();
+    }
+    /**
+     * Record a tool usage for a skill.
+     */
+    recordUsage(skillName) {
+        const entry = this.getSkill(skillName);
+        if (entry) {
+            entry.usageCount++;
+            entry.lastUsedAt = Date.now();
+            this.save();
+        }
+    }
+    /**
+     * Remove a skill completely.
+     */
+    removeSkill(name) {
+        const idx = this.registry.skills.findIndex(s => s.manifest.name === name);
+        if (idx === -1)
+            return false;
+        // Deactivate if active
+        if (this.activeHandlers.has(name)) {
+            this.deactivateSkill(name).catch(() => { });
+        }
+        this.registry.skills.splice(idx, 1);
+        this.save();
+        return true;
+    }
+    // ─── Prompt Injection ────────────────────────────────────────────────
+    /**
+     * Build a skill summary for the system prompt.
+     */
+    getSkillsPrompt() {
+        const active = this.getActiveSkills();
+        const available = this.registry.skills.filter(s => s.status === 'available' || s.status === 'installed');
+        if (active.length === 0 && available.length === 0)
+            return null;
+        const lines = ['## Installed Skills'];
+        if (active.length > 0) {
+            lines.push('\nActive:');
+            for (const s of active) {
+                const tools = s.manifest.tools?.map(t => t.name).join(', ') || 'none';
+                lines.push(`- ${s.manifest.name} v${s.manifest.version}: ${s.manifest.description} [tools: ${tools}]`);
+            }
+        }
+        if (available.length > 0) {
+            lines.push(`\nAvailable (${available.length} not activated):`);
+            for (const s of available.slice(0, 5)) {
+                lines.push(`- ${s.manifest.name}: ${s.manifest.description}`);
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Get short status line.
+     */
+    getStatusLine() {
+        const active = this.getActiveSkills().length;
+        const total = this.registry.skills.length;
+        if (total === 0)
+            return '';
+        return `${active}/${total} skills active`;
+    }
+    /**
+     * Set onChange callback.
+     */
+    setOnChange(handler) {
+        this.onChange = handler;
+    }
+}
+//# sourceMappingURL=skills.js.map

package/dist/cli/jarvis/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../../src/cli/jarvis/skills.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAO9C,MAAM,cAAc,GAAsB,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAErE,MAAM,OAAO,YAAY;IACf,QAAQ,CAAoB;IAC5B,YAAY,CAAS;IACrB,SAAS,CAAS;IAClB,cAAc,GAA6D,IAAI,GAAG,EAAE,CAAC;IACrF,YAAY,GAAqF,IAAI,GAAG,EAAE,CAAC;IAC3G,QAAQ,CAA8C;IAE9D,YAAY,WAAmB,EAAE,QAAqD;QACpF,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACrE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC;QACrF,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IAED,wEAAwE;IAEhE,IAAI;QACV,IAAI,CAAC;YACH,IAAI,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;gBAClC,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;gBACrD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAC;gBACpD,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;oBAAE,OAAO,MAAM,CAAC;YAC1E,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,6BAA6B,CAAC,CAAC;QACzC,OAAO,EAAE,GAAG,cAAc,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC3C,CAAC;IAEO,IAAI;QACV,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACvC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,aAAa,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACpF,CAAC;IAED,wEAAwE;IAExE;;;OAGG;IACH,cAAc;QACZ,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC;YAAE,OAAO,EAAE,CAAC;QAE3C,MAAM,SAAS,GAAoB,EAAE,CAAC;QAEtC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;iBAC9D,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;YAEhC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;gBAClE,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;oBAC7B,IAAI,CAAC;wBACH,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;wBAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;wBAClD,IAAI,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;4BACnC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;wBAC3B,CAAC;oBACH,CAAC;oBAAC,MAAM,CAAC,CAAC,8BAA8B,CAAC,CAAC;gBAC5C,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC,CAAC,2BAA2B,CAAC,CAAC;QAEvC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,YAAY;QACV,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QAEzC,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;YAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC;YACnF,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC;oBACxB,QAAQ;oBACR,MAAM,EAAE,WAAW;oBACnB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;oBACvB,UAAU,EAAE,CAAC;oBACb,MAAM,EAAE,EAAE;oBACV,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC;iBAC1C,CAAC,CAAC;YACL,CAAC;iBAAM,CAAC;gBACN,qCAAqC;gBACrC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC;oBACnD,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC;gBAC/B,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAED,wEAAwE;IAExE;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,IAAY;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,IAAI,aAAa,EAAE,CAAC;QAE1E,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,YAAY,CAAC;QACzC,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5C,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC;YAC3B,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC5C,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QAEnD,0CAA0C;QAC1C,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7B,aAAa,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC;gBACxC,IAAI,EAAE,mBAAmB,IAAI,EAAE;gBAC/B,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,OAAO;gBAC/B,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,QAAQ;gBACd,YAAY,EAAE,IAAI;aACnB,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACxB,CAAC;QAED,IAAI,CAAC;YACH,QAAQ,CAAC,0BAA0B,EAAE;gBACnC,GAAG,EAAE,QAAQ;gBACb,KAAK,EAAE,MAAM;gBACb,OAAO,EAAE,OAAO;aACjB,CAAC,CAAC;YACH,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC;YAC3B,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,IAAI,CAAC,QAAQ,EAAE,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;YAC1C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC;YACvB,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmB,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAC1D,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QACxC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,IAAY,EAAE,GAAiB;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,IAAI,aAAa,EAAE,CAAC;QAE1E,0BAA0B;QAC1B,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW,EAAE,CAAC;YACjC,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;YACpD,IAAI,CAAC,aAAa,CAAC,OAAO;gBAAE,OAAO,aAAa,CAAC;QACnD,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACnE,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,0BAA0B,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;QACpF,CAAC;QAED,IAAI,CAAC;YACH,qCAAqC;YACrC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,UAAU,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACrE,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC;YAEjC,IAAI,OAAO,KAAK,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;gBACzC,MAAM,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC5B,CAAC;YAED,0BAA0B;YAC1B,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACzB,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;oBAC3C,IAAI,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,UAAU,EAAE,CAAC;wBAC9C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE;4BAClC,GAAG,EAAE,OAAO;4BACZ,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;4BACxC,SAAS,EAAE,IAAI;yBAChB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;YAED,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE;gBAC5B,UAAU,EAAE,OAAO,KAAK,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;aAC9F,CAAC,CAAC;YAEH,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC;YACxB,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,IAAI,CAAC,QAAQ,EAAE,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;YAC1C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC;YACvB,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsB,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAC7D,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QACxC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,IAAY;QAChC,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,OAAO,EAAE,UAAU,EAAE,CAAC;YACxB,IAAI,CAAC;gBAAC,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAEjC,mCAAmC;QACnC,KAAK,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAChD,IAAI,GAAG,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;gBAC3B,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC;YAC1B,IAAI,CAAC,IAAI,EAAE,CAAC;YACZ,IAAI,CAAC,QAAQ,EAAE,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,wEAAwE;IAExE;;;OAGG;IACH,KAAK,CAAC,WAAW,CACf,QAAuB,EACvB,IAAY,EACZ,SAAsB,gBAAgB;QAEtC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QAErD,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,QAAQ,CAAC,IAAI,kBAAkB,EAAE,CAAC;QAC9E,CAAC;QAED,IAAI,CAAC;YACH,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAEzC,iBAAiB;YACjB,MAAM,YAAY,GAAkB,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,CAAC;YAC5D,aAAa,CACX,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,EAC5B,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,EACrC,OAAO,CACR,CAAC;YAEF,aAAa;YACb,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YAE5D,uBAAuB;YACvB,MAAM,KAAK,GAAe;gBACxB,QAAQ,EAAE,YAAY;gBACtB,MAAM,EAAE,WAAW;gBACnB,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;gBACvB,UAAU,EAAE,CAAC;gBACb,MAAM,EAAE,EAAE;gBACV,IAAI,EAAE,QAAQ;aACf,CAAC;YACF,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjC,IAAI,CAAC,IAAI,EAAE,CAAC;YAEZ,IAAI,CAAC,QAAQ,EAAE,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;YACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC3C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QACxC,CAAC;IACH,CAAC;IAED,wEAAwE;IAExE,QAAQ,CAAC,IAAY;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IAClE,CAAC;IAED,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;IACjE,CAAC;IAED,YAAY,CAAC,QAAgB;QAC3B,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,gBAAgB;QACd,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,IAAY,EAAE,OAAgB,EAAE,eAAuB,CAAC;QACpE,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;YACzB,KAAK,CAAC,aAAa,GAAG;gBACpB,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,CAAC;gBACZ,eAAe,EAAE,CAAC;gBAClB,eAAe,EAAE,CAAC;gBAClB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;aACvB,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,aAAa,CAAC,SAAS,EAAE,CAAC;QAChC,IAAI,OAAO;YAAE,KAAK,CAAC,aAAa,CAAC,eAAe,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,KAAK,CAAC,aAAa,CAAC,eAAe,CAAC;QACjD,KAAK,CAAC,aAAa,CAAC,eAAe;YACjC,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,SAAS,GAAG,CAAC,CAAC,GAAG,YAAY,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,SAAS,CAAC;QAC9F,KAAK,CAAC,aAAa,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5C,IAAI,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,SAAiB;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,UAAU,EAAE,CAAC;YACnB,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC9B,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,IAAY;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAC1E,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QAE7B,uBAAuB;QACvB,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IAED,wEAAwE;IAExE;;OAEG;IACH,eAAe;QACb,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACtC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC;QAEzG,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAE/D,MAAM,KAAK,GAAa,CAAC,qBAAqB,CAAC,CAAC;QAEhD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACxB,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;gBACvB,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC;gBACtE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,CAAC,OAAO,KAAK,CAAC,CAAC,QAAQ,CAAC,WAAW,YAAY,KAAK,GAAG,CAAC,CAAC;YACzG,CAAC;QACH,CAAC;QAED,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,gBAAgB,SAAS,CAAC,MAAM,kBAAkB,CAAC,CAAC;YAC/D,KAAK,MAAM,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBACtC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,aAAa;QACX,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC,MAAM,CAAC;QAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;QAC1C,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAC3B,OAAO,GAAG,MAAM,IAAI,KAAK,gBAAgB,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,OAAmD;QAC7D,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;CACF"}

package/dist/cli/jarvis/telegram-bot.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Jarvis Telegram Bot — Bidirectional messaging via Telegram Bot API.
+ * Uses native fetch() (Node 18+), no external dependencies.
+ * Long-polling mode — no webhook server needed.
+ */
+export interface InlineButton {
+    text: string;
+    callback_data: string;
+}
+export type TelegramMessageHandler = (text: string, chatId: string, username?: string) => void;
+export type TelegramCallbackHandler = (data: string, chatId: string, queryId: string) => void;
+export declare class JarvisTelegramBot {
+    private token;
+    private allowedChatId;
+    private polling;
+    private offset;
+    private onMessage?;
+    private onCallback?;
+    private pollTimer?;
+    private abortController?;
+    private botUsername?;
+    constructor(token: string, chatId: string);
+    /**
+     * Start long-polling for incoming messages.
+     * Fetches bot username for @mention detection and requests all relevant update types.
+     */
+    start(onMessage: TelegramMessageHandler, onCallback?: TelegramCallbackHandler): void;
+    /**
+     * Stop polling.
+     */
+    stop(): void;
+    /**
+     * Send a text message (with optional inline keyboard).
+     */
+    send(text: string, opts?: {
+        chatId?: string;
+        buttons?: InlineButton[][];
+        parseMode?: 'Markdown' | 'HTML';
+    }): Promise<void>;
+    /**
+     * Answer a callback query (dismiss button loading state).
+     */
+    answerCallback(queryId: string, text?: string): Promise<void>;
+    /**
+     * Check if bot token is valid.
+     */
+    verify(): Promise<{
+        ok: boolean;
+        botName?: string;
+    }>;
+    get isRunning(): boolean;
+    private poll;
+    private handleUpdate;
+    /**
+     * Check if the bot is @mentioned in a message.
+     */
+    private isMentionedInMessage;
+    /**
+     * Check if a /command is directed at this bot (e.g. /status@botname).
+     */
+    private isCommandForBot;
+    /**
+     * Strip the @botname mention from the text so handlers get clean input.
+     * Also strips @botname suffix from /commands (e.g. /task@mybot → /task).
+     */
+    private stripBotMention;
+    private apiCall;
+}
+/**
+ * Built-in command handler for the Telegram bot.
+ * Parses /commands and dispatches to Jarvis actions.
+ */
+export declare function parseTelegramCommand(text: string): {
+    command: string | null;
+    args: string;
+};
+//# sourceMappingURL=telegram-bot.d.ts.map

package/dist/cli/jarvis/telegram-bot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-bot.d.ts","sourceRoot":"","sources":["../../../src/cli/jarvis/telegram-bot.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACvB;AAyCD,MAAM,MAAM,sBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAC/F,MAAM,MAAM,uBAAuB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAE9F,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,SAAS,CAAC,CAAyB;IAC3C,OAAO,CAAC,UAAU,CAAC,CAA0B;IAC7C,OAAO,CAAC,SAAS,CAAC,CAAgC;IAClD,OAAO,CAAC,eAAe,CAAC,CAAkB;IAC1C,OAAO,CAAC,WAAW,CAAC,CAAS;gBAEjB,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAKzC;;;OAGG;IACH,KAAK,CACH,SAAS,EAAE,sBAAsB,EACjC,UAAU,CAAC,EAAE,uBAAuB,GACnC,IAAI;IAgBP;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ;;OAEG;IACG,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;QACL,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,YAAY,EAAE,EAAE,CAAC;QAC3B,SAAS,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;KACjC,GACA,OAAO,CAAC,IAAI,CAAC;IAkBhB;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnE;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAe1D,IAAI,SAAS,IAAI,OAAO,CAEvB;YAIa,IAAI;IAyClB,OAAO,CAAC,YAAY;IA2DpB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAevB;;;OAGG;IACH,OAAO,CAAC,eAAe;YAYT,OAAO;CAStB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG;IAClD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd,CAeA"}