openclaw-telegram-manager 1.0.0

package/dist/setup.js

@@ -0,0 +1,333 @@
+#!/usr/bin/env node
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as crypto from 'node:crypto';
+import { execSync } from 'node:child_process';
+import * as readline from 'node:readline';
+// ── Constants ──────────────────────────────────────────────────────────
+const MIN_OPENCLAW_VERSION = '2026.1.0';
+const INCLUDE_FILENAME = 'telegram-manager.generated.groups.json5';
+const REGISTRY_FILENAME = 'topics.json';
+// ── Main ──────────────────────────────────────────────────────────────
+async function main() {
+    console.log('openclaw-telegram-manager setup');
+    console.log('================================\n');
+    // Step 1: Check OpenClaw version
+    const version = checkOpenClawVersion();
+    console.log(`[1/11] OpenClaw version: ${version}`);
+    // Step 2: Locate config directory
+    const configDir = locateConfigDir();
+    console.log(`[2/11] Config directory: ${configDir}`);
+    // Step 3: Check directory permissions
+    checkDirPermissions(configDir);
+    console.log('[3/11] Directory permissions checked');
+    // Step 4: Install plugin
+    installPlugin();
+    console.log('[4/11] Plugin installation checked');
+    // Step 5: Patch openclaw.json with $include reference
+    patchConfig(configDir);
+    console.log('[5/11] Config patched with $include reference');
+    // Step 6: Create workspace directory structure
+    const workspaceDir = path.join(configDir, 'workspace');
+    const projectsDir = path.join(workspaceDir, 'projects');
+    ensureDir(projectsDir);
+    console.log(`[6/11] Workspace directory: ${projectsDir}`);
+    // Step 7: Initialize empty registry
+    initRegistry(projectsDir);
+    console.log('[7/11] Registry initialized');
+    // Step 8: Create empty generated include
+    createEmptyInclude(configDir);
+    console.log('[8/11] Empty include file created');
+    // Step 9: Optional cron setup
+    const isInteractive = process.stdin.isTTY === true;
+    const setupCron = isInteractive ? await promptYesNo('Set up daily doctor cron job? [Y/n] ') : true;
+    if (setupCron) {
+        const groupId = isInteractive
+            ? await promptInput('Enter your Telegram group ID (e.g., -1003731538650): ')
+            : '';
+        setupDoctorCron(configDir, groupId);
+        console.log('[9/11] Doctor cron job configured');
+    }
+    else {
+        console.log('[9/11] Skipped cron setup');
+    }
+    // Step 10: Trigger gateway restart
+    triggerRestart(configDir);
+    console.log('[10/11] Gateway restart triggered');
+    // Step 11: Print summary
+    printSummary(configDir, projectsDir);
+    console.log('[11/11] Setup complete!\n');
+}
+// ── Step implementations ──────────────────────────────────────────────
+function checkOpenClawVersion() {
+    let version;
+    try {
+        version = execSync('openclaw --version', { encoding: 'utf-8' }).trim();
+    }
+    catch {
+        console.error('Error: OpenClaw not found. Please install OpenClaw (>=2026.1.0) first.');
+        process.exit(1);
+    }
+    // Extract version number (e.g., "openclaw 2026.2.0" -> "2026.2.0")
+    const match = version.match(/(\d+\.\d+\.\d+)/);
+    if (!match) {
+        console.warn(`Warning: Could not parse OpenClaw version from "${version}". Proceeding anyway.`);
+        return version;
+    }
+    const versionStr = match[1];
+    if (compareVersions(versionStr, MIN_OPENCLAW_VERSION) < 0) {
+        console.error(`Error: OpenClaw ${versionStr} found, but openclaw-telegram-manager requires >=${MIN_OPENCLAW_VERSION}. Please upgrade.`);
+        process.exit(1);
+    }
+    return versionStr;
+}
+function locateConfigDir() {
+    // Check environment variable
+    const envDir = process.env['OPENCLAW_CONFIG_DIR'];
+    if (envDir && fs.existsSync(envDir)) {
+        return path.resolve(envDir);
+    }
+    // Check default location
+    const homeDir = process.env['HOME'] ?? process.env['USERPROFILE'] ?? '';
+    const defaultDir = path.join(homeDir, '.openclaw');
+    if (fs.existsSync(defaultDir)) {
+        return defaultDir;
+    }
+    // Walk up from cwd looking for openclaw.json
+    let dir = process.cwd();
+    while (dir !== path.dirname(dir)) {
+        if (fs.existsSync(path.join(dir, 'openclaw.json'))) {
+            return dir;
+        }
+        dir = path.dirname(dir);
+    }
+    console.error('Error: Could not find OpenClaw config directory. Set $OPENCLAW_CONFIG_DIR or ensure ~/.openclaw/ exists.');
+    process.exit(1);
+}
+function checkDirPermissions(dir) {
+    try {
+        const stat = fs.statSync(dir);
+        const mode = stat.mode;
+        const permissions = (mode & 0o777).toString(8);
+        // Check for world-writable or group-writable
+        if (mode & 0o002) {
+            console.warn(`Warning: ${dir} is world-writable (${permissions}). Consider restricting to owner-only (chmod 700).`);
+        }
+        else if (mode & 0o020) {
+            console.warn(`Warning: ${dir} is group-writable (${permissions}). Consider restricting to owner-only (chmod 700).`);
+        }
+    }
+    catch {
+        console.warn(`Warning: Could not check permissions for ${dir}.`);
+    }
+}
+function installPlugin() {
+    try {
+        // Check if already installed
+        const result = execSync('openclaw plugins list', { encoding: 'utf-8' });
+        if (result.includes('openclaw-telegram-manager')) {
+            console.log('  Plugin already installed, skipping.');
+            return;
+        }
+    }
+    catch {
+        // plugins list might not be available, try installing anyway
+    }
+    try {
+        execSync('openclaw plugins install openclaw-telegram-manager', {
+            encoding: 'utf-8',
+            stdio: 'inherit',
+        });
+    }
+    catch {
+        console.warn('  Warning: Could not install plugin via `openclaw plugins install`. You may need to install manually.');
+    }
+}
+function patchConfig(configDir) {
+    const configPath = path.join(configDir, 'openclaw.json');
+    if (!fs.existsSync(configPath)) {
+        console.warn(`  Warning: ${configPath} not found. Skipping config patch.`);
+        return;
+    }
+    let content;
+    try {
+        content = fs.readFileSync(configPath, 'utf-8');
+    }
+    catch (err) {
+        console.warn(`  Warning: Could not read ${configPath}. Skipping config patch.`);
+        return;
+    }
+    // Check if $include reference already exists
+    if (content.includes(INCLUDE_FILENAME)) {
+        console.log('  $include reference already present, skipping.');
+        return;
+    }
+    // Parse as JSON (OpenClaw config may be JSON or JSON5)
+    let config;
+    try {
+        config = JSON.parse(content);
+    }
+    catch {
+        // Try a more lenient approach: just check for the string and warn
+        console.warn('  Warning: Could not parse openclaw.json as JSON. Please manually add the $include reference.');
+        console.warn(`  Add to channels.telegram.groups: { "$include": "./${INCLUDE_FILENAME}" }`);
+        return;
+    }
+    // Ensure path exists: channels.telegram.groups
+    if (!config['channels'])
+        config['channels'] = {};
+    const channels = config['channels'];
+    if (!channels['telegram'])
+        channels['telegram'] = {};
+    const telegram = channels['telegram'];
+    // Set groups to $include
+    telegram['groups'] = { $include: `./${INCLUDE_FILENAME}` };
+    // Backup and write
+    const bakPath = configPath + '.bak';
+    fs.copyFileSync(configPath, bakPath);
+    const newContent = JSON.stringify(config, null, 2) + '\n';
+    fs.writeFileSync(configPath, newContent, { mode: 0o600 });
+}
+function ensureDir(dir) {
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+}
+function initRegistry(projectsDir) {
+    const registryPath = path.join(projectsDir, REGISTRY_FILENAME);
+    if (fs.existsSync(registryPath)) {
+        console.log('  Registry already exists, skipping initialization.');
+        return;
+    }
+    const callbackSecret = crypto.randomBytes(32).toString('hex');
+    const registry = {
+        version: 1,
+        topicManagerAdmins: [],
+        callbackSecret,
+        lastDoctorAllRunAt: null,
+        maxTopics: 100,
+        topics: {},
+    };
+    fs.writeFileSync(registryPath, JSON.stringify(registry, null, 2) + '\n', {
+        mode: 0o600,
+    });
+}
+function createEmptyInclude(configDir) {
+    const includePath = path.join(configDir, INCLUDE_FILENAME);
+    if (fs.existsSync(includePath)) {
+        console.log('  Include file already exists, skipping.');
+        return;
+    }
+    const content = [
+        '// This file is generated by telegram-manager. Do not hand-edit.',
+        '{}',
+        '',
+    ].join('\n');
+    fs.writeFileSync(includePath, content, { mode: 0o600 });
+}
+function setupDoctorCron(configDir, groupId) {
+    const cronDir = path.join(configDir, 'cron');
+    ensureDir(cronDir);
+    const cronJobPath = path.join(cronDir, 'topic-doctor-daily.json');
+    if (fs.existsSync(cronJobPath)) {
+        console.log('  Cron job already exists, skipping.');
+        return;
+    }
+    const target = groupId
+        ? `${groupId}:topic:1`
+        : '-100XXXXXXXXXX:topic:1';
+    const cronJob = {
+        name: 'topic-doctor-daily',
+        schedule: { kind: 'cron', expr: '0 9 * * *', tz: 'UTC' },
+        sessionTarget: 'isolated',
+        payload: {
+            kind: 'agentTurn',
+            message: 'Run topic doctor health checks on all registered topics. Check the registry at projects/topics.json and evaluate each eligible topic. Post per-topic reports with inline keyboards. If any topic\'s thread returns an API error (deleted/migrated), log it and continue to the next topic.',
+            timeoutSeconds: 300,
+        },
+        delivery: {
+            mode: 'announce',
+            channel: 'telegram',
+            to: target,
+            bestEffort: true,
+        },
+        enabled: true,
+        deleteAfterRun: false,
+    };
+    fs.writeFileSync(cronJobPath, JSON.stringify(cronJob, null, 2) + '\n', {
+        mode: 0o600,
+    });
+    if (!groupId) {
+        console.warn('  Warning: No group ID provided. Edit the cron job at:');
+        console.warn(`  ${cronJobPath}`);
+        console.warn('  Replace -100XXXXXXXXXX with your actual group ID.');
+    }
+}
+function triggerRestart(configDir) {
+    try {
+        execSync('openclaw gateway restart', {
+            encoding: 'utf-8',
+            timeout: 10_000,
+        });
+    }
+    catch {
+        console.warn('  Warning: Could not restart gateway. Run `openclaw gateway restart` manually.');
+    }
+}
+function printSummary(configDir, projectsDir) {
+    console.log('\n================================');
+    console.log('Setup complete!\n');
+    console.log('What was done:');
+    console.log(`  - Config directory: ${configDir}`);
+    console.log(`  - Projects directory: ${projectsDir}`);
+    console.log(`  - Registry: ${path.join(projectsDir, REGISTRY_FILENAME)}`);
+    console.log(`  - Include: ${path.join(configDir, INCLUDE_FILENAME)}`);
+    console.log('\nNext steps:');
+    console.log('  1. Go to any Telegram forum topic');
+    console.log('  2. Type /topic init');
+    console.log('  3. The topic will be registered and a capsule created');
+    console.log('\nFor help: /topic help');
+}
+// ── Helpers ───────────────────────────────────────────────────────────
+function compareVersions(a, b) {
+    const aParts = a.split('.').map(Number);
+    const bParts = b.split('.').map(Number);
+    for (let i = 0; i < Math.max(aParts.length, bParts.length); i++) {
+        const aVal = aParts[i] ?? 0;
+        const bVal = bParts[i] ?? 0;
+        if (aVal !== bVal)
+            return aVal - bVal;
+    }
+    return 0;
+}
+function promptYesNo(question) {
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        rl.question(question, (answer) => {
+            rl.close();
+            const normalized = answer.trim().toLowerCase();
+            resolve(normalized === '' || normalized === 'y' || normalized === 'yes');
+        });
+    });
+}
+function promptInput(question) {
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+// ── Entry point ───────────────────────────────────────────────────────
+main().catch((err) => {
+    console.error('Setup failed:', err instanceof Error ? err.message : String(err));
+    process.exit(1);
+});
+//# sourceMappingURL=setup.js.map

package/dist/setup.js.map

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

package/dist/tool.d.ts

@@ -0,0 +1,15 @@
+import type { CommandResult } from './commands/help.js';
+import type { Logger, RpcInterface } from './lib/config-restart.js';
+export interface ToolDeps {
+    logger: Logger;
+    configDir: string;
+    workspaceDir: string;
+    rpc?: RpcInterface | null;
+}
+export interface TopicManagerTool {
+    execute(_id: string, params: {
+        command: string;
+    }, execContext?: Record<string, unknown>): Promise<CommandResult>;
+}
+export declare function createTopicManagerTool(deps: ToolDeps): TopicManagerTool;
+//# sourceMappingURL=tool.d.ts.map

package/dist/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAkB,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxE,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAIpE,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CAC3B;AAID,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CACL,GAAG,EAAE,MAAM,EACX,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,EAC3B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACpC,OAAO,CAAC,aAAa,CAAC,CAAC;CAC3B;AAID,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,QAAQ,GAAG,gBAAgB,CAiFvE"}

package/dist/tool.js

@@ -0,0 +1,201 @@
+import { readRegistry, withRegistry } from './lib/registry.js';
+import { parseAndVerifyCallback, htmlEscape } from './lib/security.js';
+import { topicKey } from './lib/types.js';
+import { appendAudit, buildAuditEntry } from './lib/audit.js';
+import { handleInitInteractive, handleInitSlugConfirm, handleInitTypeSelect } from './commands/init.js';
+import { handleDoctor } from './commands/doctor.js';
+import { handleDoctorAll } from './commands/doctor-all.js';
+import { handleList } from './commands/list.js';
+import { handleStatus } from './commands/status.js';
+import { handleSync } from './commands/sync.js';
+import { handleRename } from './commands/rename.js';
+import { handleUpgrade } from './commands/upgrade.js';
+import { handleSnooze } from './commands/snooze.js';
+import { handleArchive, handleUnarchive } from './commands/archive.js';
+import { handleHelp } from './commands/help.js';
+// ── Factory ───────────────────────────────────────────────────────────
+export function createTopicManagerTool(deps) {
+    const { logger, configDir, workspaceDir, rpc } = deps;
+    return {
+        async execute(_id, params, execContext) {
+            const commandStr = (params.command ?? '').trim();
+            if (!commandStr) {
+                return { text: 'No command provided. Try /topic help for available commands.' };
+            }
+            // Extract context from execution params
+            const ctx = buildContext(deps, execContext);
+            // Handle tm: callback routing
+            if (commandStr.startsWith('tm:')) {
+                return handleCallback(commandStr, ctx);
+            }
+            // Parse sub-command and args
+            const { subCommand, args, flags } = parseCommand(commandStr);
+            try {
+                switch (subCommand) {
+                    case 'init':
+                        return await handleInitInteractive(ctx, args);
+                    case 'doctor':
+                        if (flags.has('--all') || flags.has('all')) {
+                            return await handleDoctorAll(ctx);
+                        }
+                        return await handleDoctor(ctx);
+                    case 'doctor-all':
+                        return await handleDoctorAll(ctx);
+                    case 'list':
+                        return await handleList(ctx);
+                    case 'status':
+                        return await handleStatus(ctx);
+                    case 'sync':
+                        return await handleSync(ctx);
+                    case 'rename':
+                        return await handleRename(ctx, args);
+                    case 'upgrade':
+                        return await handleUpgrade(ctx);
+                    case 'snooze':
+                        return await handleSnooze(ctx, args);
+                    case 'archive':
+                        return await handleArchive(ctx);
+                    case 'unarchive':
+                        return await handleUnarchive(ctx);
+                    case 'help':
+                        return await handleHelp(ctx);
+                    default:
+                        return {
+                            text: `Unknown command: "${htmlEscape(subCommand)}". Try /topic help for available commands.`,
+                        };
+                }
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                logger.error(`[topic_manager] Command "${subCommand}" failed: ${msg}`);
+                return {
+                    text: `Command failed: ${htmlEscape(msg)}`,
+                };
+            }
+        },
+    };
+}
+function parseCommand(commandStr) {
+    const parts = commandStr.split(/\s+/);
+    const subCommand = (parts[0] ?? '').toLowerCase();
+    const remaining = parts.slice(1);
+    const flags = new Set();
+    const argParts = [];
+    for (const part of remaining) {
+        if (part.startsWith('--')) {
+            flags.add(part);
+        }
+        else {
+            argParts.push(part);
+        }
+    }
+    return {
+        subCommand,
+        args: argParts.join(' '),
+        flags,
+    };
+}
+// ── Context building ────────────────────────────────────────────────
+function buildContext(deps, execContext) {
+    // Extract IDs from the execution context provided by the tool framework
+    const groupId = extractString(execContext, 'groupId')
+        ?? extractString(execContext, 'chatId')
+        ?? extractNestedString(execContext, 'message', 'chat', 'id');
+    const threadId = extractString(execContext, 'threadId')
+        ?? extractString(execContext, 'messageThreadId')
+        ?? extractNestedString(execContext, 'message', 'message_thread_id');
+    const userId = extractString(execContext, 'userId')
+        ?? extractNestedString(execContext, 'message', 'from', 'id');
+    return {
+        workspaceDir: deps.workspaceDir,
+        configDir: deps.configDir,
+        rpc: deps.rpc,
+        logger: deps.logger,
+        groupId: groupId ?? undefined,
+        threadId: threadId ?? undefined,
+        userId: userId ?? undefined,
+        messageContext: execContext,
+    };
+}
+function extractString(obj, key) {
+    if (!obj)
+        return null;
+    const val = obj[key];
+    if (val === undefined || val === null)
+        return null;
+    return String(val);
+}
+function extractNestedString(obj, ...keys) {
+    if (!obj)
+        return null;
+    let current = obj;
+    for (const key of keys) {
+        if (current === null || current === undefined || typeof current !== 'object')
+            return null;
+        current = current[key];
+    }
+    if (current === undefined || current === null)
+        return null;
+    return String(current);
+}
+// ── Callback handling ───────────────────────────────────────────────
+async function handleCallback(data, ctx) {
+    const { workspaceDir, groupId, threadId, userId } = ctx;
+    if (!groupId || !threadId || !userId) {
+        return { text: 'Cannot verify callback: missing context.' };
+    }
+    const registry = readRegistry(workspaceDir);
+    const parsed = parseAndVerifyCallback(data, registry.callbackSecret, groupId, threadId);
+    if (!parsed) {
+        return { text: 'Invalid or expired callback.' };
+    }
+    const { action, slug } = parsed;
+    // Init callbacks: topic doesn't exist in registry yet
+    const initTypeMap = {
+        ic: 'coding',
+        ir: 'research',
+        im: 'marketing',
+        ix: 'custom',
+    };
+    if (action === 'is') {
+        return handleInitSlugConfirm(ctx, slug);
+    }
+    if (action in initTypeMap) {
+        return handleInitTypeSelect(ctx, slug, initTypeMap[action]);
+    }
+    // Find the topic entry by slug
+    const key = topicKey(groupId, threadId);
+    const entry = registry.topics[key];
+    if (!entry || entry.slug !== slug) {
+        return { text: 'Topic not found or slug mismatch.' };
+    }
+    switch (action) {
+        case 'fix':
+            return handleCallbackFix(ctx);
+        case 'snooze7d':
+            return handleSnooze(ctx, '7d');
+        case 'snooze30d':
+            return handleSnooze(ctx, '30d');
+        case 'archive':
+            return handleArchive(ctx);
+        case 'ignore': {
+            // Add the most recent failing check to ignoreChecks
+            // For simplicity, we acknowledge the action; the user should specify which check
+            return {
+                text: `To ignore a specific check, use: /topic snooze or contact an admin. The "Ignore" action requires specifying a check ID.`,
+            };
+        }
+        default:
+            return { text: `Unknown callback action: ${htmlEscape(action)}` };
+    }
+}
+async function handleCallbackFix(ctx) {
+    // "Fix" re-runs doctor, which auto-fixes fixable issues
+    // For now, doctor itself identifies fixable issues
+    const { userId, workspaceDir } = ctx;
+    if (userId) {
+        appendAudit(workspaceDir, buildAuditEntry(userId, 'doctor fix', 'callback', 'Fix callback triggered'));
+    }
+    return handleDoctor(ctx);
+}
+//# sourceMappingURL=tool.js.map

package/dist/tool.js.map

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

package/openclaw.plugin.json

@@ -0,0 +1,9 @@
+{
+  "id": "openclaw-telegram-manager",
+  "name": "Telegram Topic Manager",
+  "version": "1.0.0",
+  "description": "Deterministic Telegram forum topic management for OpenClaw",
+  "license": "MIT",
+  "slotType": "tool",
+  "entry": "./src/index.ts"
+}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "openclaw-telegram-manager",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Deterministic Telegram forum topic management for OpenClaw",
+  "license": "MIT",
+  "repository": "github:jcoulaud/openclaw-telegram-manager",
+  "exports": {
+    ".": "./src/index.ts",
+    "./setup": "./src/setup.ts"
+  },
+  "bin": {
+    "openclaw-telegram-manager": "./dist/setup.js"
+  },
+  "files": [
+    "src/",
+    "dist/",
+    "skills/",
+    "openclaw.plugin.json"
+  ],
+  "openclaw": {
+    "extensions": [
+      "./src/index.ts"
+    ]
+  },
+  "peerDependencies": {
+    "openclaw": ">=2026.1.0"
+  },
+  "dependencies": {
+    "@sinclair/typebox": "^0.34.48",
+    "json5": "^2.2.3",
+    "proper-lockfile": "^4.1.2"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.3",
+    "@types/proper-lockfile": "^4.1.4",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run",
+    "lint": "tsc --noEmit",
+    "audit:deps": "npm audit",
+    "postversion": "git push origin main --tags"
+  }
+}