@visorcraft/idlehands 2.0.0 → 2.0.2

package/dist/bot/upgrade-command.js

@@ -0,0 +1,398 @@
+/**
+ * Bot /upgrade command — self-upgrade and restart service.
+ *
+ * Provides same functionality as `idlehands upgrade` CLI but with
+ * user feedback and automatic service restart for bots.
+ */
+import { execFileSync, execSync, spawn } from 'node:child_process';
+import { accessSync, constants as fsConstants, readFileSync } from 'node:fs';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { fetchWithTimeout as fetchWithTimeoutStrict, stateDir, PKG_VERSION } from '../utils.js';
+const NPM_SCOPED_PACKAGE = '@visorcraft/idlehands';
+const GITHUB_OWNER = 'visorcraft';
+const GITHUB_REPO = 'idlehands';
+const STATE_DIR = stateDir();
+const ROLLBACK_DIR = path.join(STATE_DIR, 'rollback');
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function isUsableCommand(cmd) {
+    try {
+        execFileSync(cmd, ['--version'], { stdio: 'ignore', timeout: 5000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function resolveInstallPaths() {
+    try {
+        const binPath = execSync('command -v idlehands 2>/dev/null || echo ""', {
+            encoding: 'utf8',
+        }).trim();
+        if (!binPath)
+            return null;
+        const prefix = path.resolve(path.dirname(binPath), '..');
+        const installDir = path.join(prefix, 'lib', 'node_modules', NPM_SCOPED_PACKAGE);
+        const npmByPrefix = path.join(prefix, 'bin', 'npm');
+        const npmByNodeDir = path.join(path.dirname(process.execPath), 'npm');
+        const npmBin = isUsableCommand(npmByPrefix)
+            ? npmByPrefix
+            : isUsableCommand(npmByNodeDir)
+                ? npmByNodeDir
+                : 'npm';
+        return { binPath, prefix, installDir, npmBin };
+    }
+    catch {
+        return null;
+    }
+}
+function needsElevation(prefix) {
+    if (process.getuid?.() === 0)
+        return false;
+    try {
+        const target = path.join(prefix, 'lib', 'node_modules');
+        accessSync(target, fsConstants.W_OK);
+        return false;
+    }
+    catch {
+        return true;
+    }
+}
+function hasSudo() {
+    try {
+        execFileSync('which', ['sudo'], { stdio: 'ignore', timeout: 3000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function fetchWithTimeout(url, init, timeoutMs) {
+    try {
+        return await fetchWithTimeoutStrict(url, init, timeoutMs);
+    }
+    catch {
+        return null;
+    }
+}
+function compareSemver(a, b) {
+    const pa = a.replace(/^v/, '').split('.').map(Number);
+    const pb = b.replace(/^v/, '').split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        const va = pa[i] ?? 0;
+        const vb = pb[i] ?? 0;
+        if (va < vb)
+            return -1;
+        if (va > vb)
+            return 1;
+    }
+    return 0;
+}
+function detectInstallSource() {
+    const target = resolveInstallPaths();
+    if (!target)
+        return 'unknown';
+    if (target.installDir.includes('node_modules'))
+        return 'npm';
+    return 'github';
+}
+function resolveGitHubToken() {
+    const envToken = process.env.GITHUB_TOKEN || process.env.GH_TOKEN;
+    if (envToken)
+        return envToken;
+    try {
+        const ghConfigPath = path.join(os.homedir(), '.config', 'gh', 'hosts.yml');
+        const raw = readFileSync(ghConfigPath, 'utf8');
+        const lines = raw.split('\n');
+        let inGithub = false;
+        for (const line of lines) {
+            if (line.match(/^github\.com:/)) {
+                inGithub = true;
+                continue;
+            }
+            if (inGithub && line.match(/^\S/))
+                break;
+            if (inGithub) {
+                const m = line.match(/oauth_token:\s*(.+)/);
+                if (m)
+                    return m[1].trim();
+            }
+        }
+    }
+    catch { }
+    return null;
+}
+async function getLatestNpm(timeoutMs = 5000) {
+    try {
+        const pkg = encodeURIComponent(NPM_SCOPED_PACKAGE);
+        const res = await fetchWithTimeout(`https://registry.npmjs.org/${pkg}/latest`, {
+            headers: { Accept: 'application/json', 'User-Agent': 'idlehands-bot' },
+        }, timeoutMs);
+        if (!res || !res.ok)
+            return null;
+        const data = (await res.json());
+        return data?.version ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+async function getLatestGitHub(timeoutMs = 5000) {
+    try {
+        const url = `https://api.github.com/repos/${GITHUB_OWNER}/${GITHUB_REPO}/releases/latest`;
+        const headers = {
+            Accept: 'application/vnd.github+json',
+            'User-Agent': 'idlehands-bot',
+        };
+        const token = resolveGitHubToken();
+        if (token)
+            headers['Authorization'] = `token ${token}`;
+        const res = await fetchWithTimeout(url, { headers }, timeoutMs);
+        if (!res || !res.ok)
+            return null;
+        const data = (await res.json());
+        return data?.tag_name?.replace(/^v/, '') ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+async function checkForUpdate(source) {
+    const currentVersion = PKG_VERSION;
+    let latest = null;
+    let finalSource = source;
+    if (source === 'npm') {
+        latest = await getLatestNpm();
+        if (!latest) {
+            latest = await getLatestGitHub();
+            if (latest)
+                finalSource = 'github';
+        }
+    }
+    else {
+        latest = await getLatestGitHub();
+        if (!latest) {
+            latest = await getLatestNpm();
+            if (latest)
+                finalSource = 'npm';
+        }
+    }
+    if (!latest)
+        return null;
+    return {
+        current: currentVersion,
+        latest,
+        source: finalSource,
+        updateAvailable: compareSemver(currentVersion, latest) < 0,
+    };
+}
+function npmInstallGlobal(spec, onProgress) {
+    const target = resolveInstallPaths();
+    if (target) {
+        const args = ['install', '-g', '--prefix', target.prefix, spec];
+        const env = { ...process.env, npm_config_prefix: target.prefix };
+        if (needsElevation(target.prefix)) {
+            if (!hasSudo()) {
+                throw new Error(`Permission denied: ${target.prefix} requires elevated permissions.`);
+            }
+            execFileSync('sudo', [target.npmBin, ...args], {
+                stdio: 'pipe',
+                timeout: 120_000,
+                env,
+            });
+            return;
+        }
+        execFileSync(target.npmBin, args, {
+            stdio: 'pipe',
+            timeout: 120_000,
+            env,
+        });
+        return;
+    }
+    execFileSync('npm', ['install', '-g', spec], { stdio: 'pipe', timeout: 120_000 });
+}
+async function backupForRollback(currentVersion) {
+    try {
+        const installDir = resolveInstallPaths()?.installDir;
+        if (!installDir)
+            return false;
+        try {
+            await fs.access(installDir);
+        }
+        catch {
+            return false;
+        }
+        await fs.rm(ROLLBACK_DIR, { recursive: true, force: true });
+        await fs.mkdir(ROLLBACK_DIR, { recursive: true });
+        execSync(`npm pack --pack-destination "${ROLLBACK_DIR}" 2>/dev/null`, {
+            cwd: installDir,
+            encoding: 'utf8',
+            timeout: 30_000,
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ─── Service Restart ────────────────────────────────────────────────────────
+function detectServiceManager() {
+    // Check for systemd user service
+    try {
+        const result = execSync('systemctl --user is-active idlehands-bot 2>/dev/null || true', {
+            encoding: 'utf8',
+            timeout: 5000,
+        }).trim();
+        if (result === 'active' || result === 'inactive') {
+            return 'systemd-user';
+        }
+    }
+    catch { }
+    // Check for system service
+    try {
+        const result = execSync('systemctl is-active idlehands-bot 2>/dev/null || true', {
+            encoding: 'utf8',
+            timeout: 5000,
+        }).trim();
+        if (result === 'active' || result === 'inactive') {
+            return 'systemd-system';
+        }
+    }
+    catch { }
+    return 'none';
+}
+function scheduleServiceRestart(serviceManager) {
+    // Schedule restart in background after a short delay to allow response to be sent
+    const restartCmd = serviceManager === 'systemd-user'
+        ? 'sleep 2 && systemctl --user restart idlehands-bot'
+        : 'sleep 2 && sudo systemctl restart idlehands-bot';
+    spawn('bash', ['-c', restartCmd], {
+        detached: true,
+        stdio: 'ignore',
+    }).unref();
+}
+// ─── Main Upgrade Function ──────────────────────────────────────────────────
+/**
+ * Perform the upgrade with progress callbacks for bot feedback.
+ */
+export async function performBotUpgrade(onProgress) {
+    const currentVersion = PKG_VERSION;
+    const source = detectInstallSource();
+    await onProgress(`🔍 Current version: **v${currentVersion}**`);
+    await onProgress(`📦 Install source: ${source}`);
+    await onProgress('🔄 Checking for updates...');
+    const info = await checkForUpdate(source);
+    if (!info) {
+        return {
+            success: false,
+            message: '❌ Could not check for updates. Network issue or no releases published.',
+            fromVersion: currentVersion,
+        };
+    }
+    if (!info.updateAvailable) {
+        return {
+            success: true,
+            message: `✅ Already on the latest version (**v${currentVersion}**).`,
+            fromVersion: currentVersion,
+            toVersion: currentVersion,
+            needsRestart: false,
+        };
+    }
+    await onProgress(`📥 Update available: **v${info.current}** → **v${info.latest}** (from ${info.source})`);
+    await onProgress('💾 Creating backup for rollback...');
+    const backed = await backupForRollback(currentVersion);
+    if (backed) {
+        await onProgress('✅ Backup created');
+    }
+    else {
+        await onProgress('⚠️ Backup skipped (non-fatal)');
+    }
+    await onProgress('⬇️ Downloading and installing update...');
+    try {
+        if (info.source === 'npm') {
+            npmInstallGlobal(`${NPM_SCOPED_PACKAGE}@latest`);
+        }
+        else {
+            // GitHub release download
+            const token = resolveGitHubToken();
+            const releaseUrl = `https://api.github.com/repos/${GITHUB_OWNER}/${GITHUB_REPO}/releases/tags/v${info.latest}`;
+            const headers = {
+                Accept: 'application/vnd.github+json',
+                'User-Agent': 'idlehands-bot',
+            };
+            if (token)
+                headers['Authorization'] = `token ${token}`;
+            const releaseRes = await fetch(releaseUrl, { headers });
+            if (!releaseRes.ok) {
+                throw new Error(`Failed to fetch release v${info.latest}`);
+            }
+            const releaseData = (await releaseRes.json());
+            const tgzName = `idlehands-${info.latest}.tgz`;
+            const asset = (releaseData.assets ?? []).find((a) => a.name === tgzName);
+            if (!asset)
+                throw new Error(`Release has no asset named ${tgzName}`);
+            await onProgress(`📦 Downloading ${tgzName}...`);
+            const dlHeaders = {
+                Accept: 'application/octet-stream',
+                'User-Agent': 'idlehands-bot',
+            };
+            if (token)
+                dlHeaders['Authorization'] = `token ${token}`;
+            const dlRes = await fetch(asset.url, { headers: dlHeaders });
+            if (!dlRes.ok)
+                throw new Error('Failed to download asset');
+            const tmpPath = path.join(os.tmpdir(), tgzName);
+            const buf = Buffer.from(await dlRes.arrayBuffer());
+            await fs.writeFile(tmpPath, buf);
+            npmInstallGlobal(tmpPath);
+            await fs.unlink(tmpPath).catch(() => { });
+        }
+        await onProgress(`✅ Upgraded to **v${info.latest}**`);
+        // Detect and schedule service restart
+        const serviceManager = detectServiceManager();
+        if (serviceManager !== 'none') {
+            await onProgress(`🔄 Scheduling service restart (${serviceManager})...`);
+            scheduleServiceRestart(serviceManager);
+            return {
+                success: true,
+                message: `✅ Upgraded from **v${info.current}** to **v${info.latest}**\n🔄 Service restarting in 2 seconds...`,
+                fromVersion: info.current,
+                toVersion: info.latest,
+                needsRestart: true,
+            };
+        }
+        return {
+            success: true,
+            message: `✅ Upgraded from **v${info.current}** to **v${info.latest}**\n⚠️ No service manager detected. Please restart manually.`,
+            fromVersion: info.current,
+            toVersion: info.latest,
+            needsRestart: true,
+        };
+    }
+    catch (e) {
+        return {
+            success: false,
+            message: `❌ Upgrade failed: ${e?.message ?? String(e)}`,
+            fromVersion: currentVersion,
+            error: e?.message ?? String(e),
+        };
+    }
+}
+/**
+ * Check for available updates without performing upgrade.
+ */
+export async function checkBotUpdate() {
+    const source = detectInstallSource();
+    const info = await checkForUpdate(source);
+    if (!info) {
+        return { available: false, current: PKG_VERSION };
+    }
+    return {
+        available: info.updateAvailable,
+        current: info.current,
+        latest: info.latest,
+        source: info.source,
+    };
+}
+//# sourceMappingURL=upgrade-command.js.map

package/dist/bot/upgrade-command.js.map

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

package/dist/bot/ux/shared-formatter.js

@@ -0,0 +1,43 @@
+/**
+ * Shared formatter utilities for platform-specific renderers.
+ *
+ * Provides common truncation logic to prevent duplication across platforms
+ * (Discord, Telegram, etc.) while allowing platform-specific formatting.
+ */
+/**
+ * Truncates formatted content from UX blocks to fit within maxLen.
+ *
+ * This function implements the common truncation algorithm used across
+ * all platform renderers, allowing them to share logic while using
+ * platform-specific formatting functions.
+ *
+ * @param blocks - Array of UX blocks to format and truncate
+ * @param blockToFormatted - Function that converts a single UX block to formatted string
+ * @param opts - Truncation options including max length and optional fallback
+ * @returns Formatted and truncated string, or fallback if empty
+ */
+export function truncateBlocks(blocks, blockToFormatted, opts) {
+    const maxLen = Math.max(256, Math.floor(opts?.maxLen ?? 1900));
+    const fallback = opts?.fallback ?? '⏳ Thinking...';
+    const parts = [];
+    let used = 0;
+    let truncated = false;
+    for (const block of blocks) {
+        const piece = blockToFormatted(block, opts);
+        const sep = parts.length ? '\n\n' : '';
+        const add = sep + piece;
+        if (used + add.length > maxLen) {
+            truncated = true;
+            break;
+        }
+        parts.push(add);
+        used += add.length;
+    }
+    let out = parts.join('');
+    if (truncated && out.length + 2 <= maxLen)
+        out += '\n…';
+    if (!out.trim())
+        out = fallback;
+    return out;
+}
+//# sourceMappingURL=shared-formatter.js.map

package/dist/bot/ux/shared-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-formatter.js","sourceRoot":"","sources":["../../../src/bot/ux/shared-formatter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAiB,EACjB,gBAAwD,EACxD,IAAwB;IAExB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,eAAe,CAAC;IAEnD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,SAAS,GAAG,KAAK,CAAC;IAEtB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC5C,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,GAAG,GAAG,KAAK,CAAC;QAExB,IAAI,IAAI,GAAG,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;YAC/B,SAAS,GAAG,IAAI,CAAC;YACjB,MAAM;QACR,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChB,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,IAAI,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzB,IAAI,SAAS,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM;QAAE,GAAG,IAAI,KAAK,CAAC;IACxD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;QAAE,GAAG,GAAG,QAAQ,CAAC;IAEhC,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/cli/commands/upgrade.js

@@ -0,0 +1,27 @@
+/**
+ * TUI /upgrade command — self-upgrade IdleHands.
+ */
+export const upgradeCommands = [
+    {
+        name: '/upgrade',
+        description: 'Upgrade IdleHands to the latest version',
+        async execute(ctx) {
+            const { performBotUpgrade } = await import('../../bot/upgrade-command.js');
+            console.log('🔄 Starting upgrade...\n');
+            const result = await performBotUpgrade(async (message) => {
+                // Strip markdown bold for terminal output
+                const plain = message.replace(/\*\*/g, '');
+                console.log(plain);
+            });
+            // Print final result
+            const finalMessage = result.message.replace(/\*\*/g, '');
+            console.log('\n' + finalMessage);
+            if (result.needsRestart && result.success) {
+                console.log('\n⚠️  Please restart idlehands to use the new version.');
+                console.log('   Run: idlehands (or restart your bot service)');
+            }
+            return true;
+        },
+    },
+];
+//# sourceMappingURL=upgrade.js.map

package/dist/cli/commands/upgrade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../../../src/cli/commands/upgrade.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,CAAC,MAAM,eAAe,GAAmB;IAC7C;QACE,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,yCAAyC;QACtD,KAAK,CAAC,OAAO,CAAC,GAAG;YACf,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,8BAA8B,CAAC,CAAC;YAE3E,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;YAExC,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;gBACvD,0CAA0C;gBAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC,CAAC,CAAC;YAEH,qBAAqB;YACrB,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YACzD,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,YAAY,CAAC,CAAC;YAEjC,IAAI,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC1C,OAAO,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC;gBACtE,OAAO,CAAC,GAAG,CAAC,iDAAiD,CAAC,CAAC;YACjE,CAAC;YAED,OAAO,IAAI,CAAC;QACd,CAAC;KACF;CACF,CAAC"}