openclaw-telegram-manager 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OpenClaw Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,110 @@
+# openclaw-telegram-manager
+
+[![CI](https://github.com/jcoulaud/openclaw-telegram-manager/actions/workflows/ci.yml/badge.svg)](https://github.com/jcoulaud/openclaw-telegram-manager/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/openclaw-telegram-manager)](https://www.npmjs.com/package/openclaw-telegram-manager)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+An [OpenClaw](https://openclaw.ai) plugin that gives each Telegram forum topic its own persistent workspace — status, todos, commands, links, notes — so nothing gets lost when the agent resets or context gets compacted.
+
+## The problem
+
+When OpenClaw manages a Telegram group with forum topics, each topic is basically a separate project. But after a reset or context compaction, the agent forgets everything: what it was working on, what's left to do, what commands matter.
+
+This plugin fixes that. Each topic gets a folder of markdown files (a "capsule") that the agent reads on startup. It picks up right where it left off.
+
+## Getting started
+
+Requires OpenClaw `>=2026.1.0`.
+
+```bash
+npx openclaw-telegram-manager setup
+```
+
+That's it. The setup script installs the plugin, patches your config, creates the workspace, and restarts the Gateway. It's idempotent — running it twice won't break anything.
+
+Once that's done:
+
+1. Open any topic in your OpenClaw-managed Telegram group
+2. Type `/topic init`
+3. Confirm the suggested slug, then pick a topic type
+4. The plugin creates a capsule folder and confirms in chat
+5. From now on, the agent reads the capsule on every session start — no context lost
+
+You can also skip the interactive flow: `/topic init my-project coding`
+
+## Usage
+
+| Command | What it does |
+|---------|-------------|
+| `/topic init` | Interactive setup — confirm slug, pick type |
+| `/topic init <slug> [type]` | One-step setup. Types: `coding`, `research`, `marketing`, `custom` |
+| `/topic status` | Show the current STATUS.md |
+| `/topic list` | List all topics, grouped by status |
+| `/topic doctor` | Run health checks on the current topic |
+| `/topic doctor --all` | Health check all active topics at once |
+| `/topic sync` | Regenerate the include file from the registry |
+| `/topic rename <new-slug>` | Rename a topic |
+| `/topic upgrade` | Upgrade the capsule to the latest template version |
+| `/topic snooze <duration>` | Snooze a topic (e.g. `7d`, `30d`) |
+| `/topic archive` | Archive a topic |
+| `/topic unarchive` | Bring back an archived topic |
+| `/topic help` | Show this command list in Telegram |
+
+## What's in a capsule
+
+Each topic gets a folder at `~/.openclaw/workspace/projects/<slug>/` with these files:
+
+**Always included:**
+- `STATUS.md` — what's happening, last activity, next 3 actions
+- `TODO.md` — task backlog
+- `COMMANDS.md` — build/deploy/test commands worth remembering
+- `LINKS.md` — URLs and endpoints
+- `CRON.md` — scheduled jobs
+- `NOTES.md` — anything else worth keeping
+- `README.md` — what this topic is about
+
+**Extra files by type:**
+- `coding` adds `ARCHITECTURE.md` and `DEPLOY.md`
+- `research` adds `SOURCES.md` and `FINDINGS.md`
+- `marketing` adds `CAMPAIGNS.md` and `METRICS.md`
+- `custom` adds nothing — bring your own
+
+## Permissions
+
+Two roles:
+- **User** — can manage topics they have access to
+- **Admin** — can run `doctor --all` and manage anyone's topics
+
+The first person to run `/topic init` automatically becomes admin.
+
+## Project layout
+
+```
+src/
+  index.ts          — plugin entry point
+  tool.ts           — routes /topic subcommands
+  setup.ts          — the setup CLI
+  commands/         — one file per command
+  lib/              — core logic (registry, capsules, security, auth, etc.)
+  templates/        — markdown templates for new capsules
+skills/
+  topic/SKILL.md    — skill definition with rehydration behavior
+```
+
+## Security
+
+- Path traversal protection (jail checks + symlink rejection)
+- HMAC-signed inline keyboard callbacks
+- HTML escaping on all Telegram output
+- Schema validation on every registry read (bad entries get quarantined)
+- File locking to prevent concurrent write corruption
+
+See [SECURITY.md](SECURITY.md) for reporting vulnerabilities.
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+[MIT](LICENSE)

package/dist/commands/archive.d.ts

@@ -0,0 +1,4 @@
+import type { CommandContext, CommandResult } from './help.js';
+export declare function handleArchive(ctx: CommandContext): Promise<CommandResult>;
+export declare function handleUnarchive(ctx: CommandContext): Promise<CommandResult>;
+//# sourceMappingURL=archive.d.ts.map

package/dist/commands/archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/commands/archive.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/D,wBAAsB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAE/E;AAED,wBAAsB,eAAe,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAEjF"}

package/dist/commands/archive.js

@@ -0,0 +1,71 @@
+import { withRegistry, readRegistry } from '../lib/registry.js';
+import { checkAuthorization } from '../lib/auth.js';
+import { topicKey } from '../lib/types.js';
+import { htmlEscape } from '../lib/security.js';
+import { appendAudit, buildAuditEntry } from '../lib/audit.js';
+import { generateInclude } from '../lib/include-generator.js';
+import { triggerRestart, getConfigWrites } from '../lib/config-restart.js';
+export async function handleArchive(ctx) {
+    return handleArchiveToggle(ctx, true);
+}
+export async function handleUnarchive(ctx) {
+    return handleArchiveToggle(ctx, false);
+}
+async function handleArchiveToggle(ctx, archive) {
+    const { workspaceDir, configDir, userId, groupId, threadId, rpc, logger } = ctx;
+    const command = archive ? 'archive' : 'unarchive';
+    if (!userId || !groupId || !threadId) {
+        return { text: 'Missing context: userId, groupId, or threadId not available.' };
+    }
+    const registry = readRegistry(workspaceDir);
+    // Auth check (admin tier)
+    const auth = checkAuthorization(userId, command, registry);
+    if (!auth.authorized) {
+        return { text: auth.message ?? 'Not authorized.' };
+    }
+    const key = topicKey(groupId, threadId);
+    const entry = registry.topics[key];
+    if (!entry) {
+        return { text: 'This topic is not registered. Run /topic init first.' };
+    }
+    if (archive && entry.status === 'archived') {
+        return { text: `Topic <code>${htmlEscape(entry.slug)}</code> is already archived.` };
+    }
+    if (!archive && entry.status !== 'archived') {
+        return { text: `Topic <code>${htmlEscape(entry.slug)}</code> is not archived.` };
+    }
+    const newStatus = archive ? 'archived' : 'active';
+    await withRegistry(workspaceDir, (data) => {
+        const topic = data.topics[key];
+        if (topic) {
+            topic.status = newStatus;
+            if (!archive) {
+                topic.snoozeUntil = null;
+            }
+        }
+    });
+    // Regenerate include if configWrites enabled
+    let restartMsg = '';
+    const configWritesEnabled = await getConfigWrites(ctx.rpc);
+    if (configWritesEnabled) {
+        try {
+            const updatedRegistry = readRegistry(workspaceDir);
+            generateInclude(workspaceDir, updatedRegistry, configDir);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            restartMsg = `\nWarning: include generation failed: ${htmlEscape(msg)}`;
+        }
+        const result = await triggerRestart(rpc, logger);
+        if (!result.success && result.fallbackMessage) {
+            restartMsg += '\n' + result.fallbackMessage;
+        }
+    }
+    appendAudit(workspaceDir, buildAuditEntry(userId, command, entry.slug, `Status changed to ${newStatus}`));
+    const action = archive ? 'archived' : 'unarchived';
+    return {
+        text: `Topic <code>${htmlEscape(entry.slug)}</code> ${action}.${restartMsg}`,
+        parseMode: 'HTML',
+    };
+}
+//# sourceMappingURL=archive.js.map

package/dist/commands/archive.js.map

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

package/dist/commands/doctor-all.d.ts

@@ -0,0 +1,3 @@
+import type { CommandContext, CommandResult } from './help.js';
+export declare function handleDoctorAll(ctx: CommandContext): Promise<CommandResult>;
+//# sourceMappingURL=doctor-all.d.ts.map

package/dist/commands/doctor-all.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-all.d.ts","sourceRoot":"","sources":["../../src/commands/doctor-all.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAW/D,wBAAsB,eAAe,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAiMjF"}

package/dist/commands/doctor-all.js

@@ -0,0 +1,193 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { readRegistry, withRegistry } from '../lib/registry.js';
+import { checkAuthorization } from '../lib/auth.js';
+import { DOCTOR_ALL_COOLDOWN_MS, DOCTOR_PER_TOPIC_CAP_MS, INACTIVE_AFTER_DAYS, SPAM_THRESHOLD, } from '../lib/types.js';
+import { htmlEscape } from '../lib/security.js';
+import { buildDoctorReport, buildDoctorButtons } from '../lib/telegram.js';
+import { runAllChecksForTopic } from '../lib/doctor-checks.js';
+import { includePath } from '../lib/include-generator.js';
+export async function handleDoctorAll(ctx) {
+    const { workspaceDir, configDir, userId, logger } = ctx;
+    if (!userId) {
+        return { text: 'Missing context: userId not available.' };
+    }
+    const registry = readRegistry(workspaceDir);
+    // Auth check (admin tier)
+    const auth = checkAuthorization(userId, 'doctor-all', registry);
+    if (!auth.authorized) {
+        return { text: auth.message ?? 'Not authorized.' };
+    }
+    // Global cooldown check
+    if (registry.lastDoctorAllRunAt) {
+        const lastRun = new Date(registry.lastDoctorAllRunAt).getTime();
+        const elapsed = Date.now() - lastRun;
+        if (elapsed < DOCTOR_ALL_COOLDOWN_MS) {
+            const remainingMin = Math.ceil((DOCTOR_ALL_COOLDOWN_MS - elapsed) / 60_000);
+            return {
+                text: `Doctor-all was run ${Math.floor(elapsed / 60_000)} minutes ago. Try again in ${remainingMin} minute(s).`,
+            };
+        }
+    }
+    const now = new Date();
+    const projectsBase = path.join(workspaceDir, 'projects');
+    // Read include content for config checks (optional)
+    let includeContent;
+    const incPath = includePath(configDir);
+    try {
+        if (fs.existsSync(incPath)) {
+            includeContent = fs.readFileSync(incPath, 'utf-8');
+        }
+    }
+    catch {
+        // Not critical
+    }
+    const cronJobsPath = path.join(configDir, 'cron', 'jobs.json');
+    const allEntries = Object.entries(registry.topics);
+    const reports = [];
+    const errors = [];
+    let processed = 0;
+    let skipped = 0;
+    // Group tracking for migration detection
+    const groupPostResults = new Map();
+    for (const [_key, entry] of allEntries) {
+        // Eligibility gating
+        if (!isEligible(entry, now)) {
+            skipped++;
+            continue;
+        }
+        try {
+            const results = runAllChecksForTopic(entry, projectsBase, includeContent, registry, cronJobsPath);
+            // Spam control: auto-snooze if threshold reached
+            const isSpam = entry.consecutiveSilentDoctors >= SPAM_THRESHOLD;
+            if (isSpam) {
+                // Auto-snooze is handled via the check result; we just note it
+                logger.info(`[doctor-all] Auto-snoozing ${entry.slug} (${entry.consecutiveSilentDoctors} silent runs)`);
+            }
+            const reportText = buildDoctorReport(entry.slug, results);
+            const keyboard = buildDoctorButtons(entry.slug, entry.groupId, entry.threadId, registry.callbackSecret);
+            reports.push({
+                slug: entry.slug,
+                groupId: entry.groupId,
+                threadId: entry.threadId,
+                text: reportText,
+                keyboard,
+            });
+            // Track group post results for migration detection
+            const gk = entry.groupId;
+            if (!groupPostResults.has(gk)) {
+                groupPostResults.set(gk, { total: 0, failed: 0 });
+            }
+            const group = groupPostResults.get(gk);
+            group.total++;
+            processed++;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            errors.push(`${entry.slug}: ${msg}`);
+            logger.error(`[doctor-all] Error processing ${entry.slug}: ${msg}`);
+            // Track failures for migration detection
+            const gk = entry.groupId;
+            if (!groupPostResults.has(gk)) {
+                groupPostResults.set(gk, { total: 0, failed: 0 });
+            }
+            const group = groupPostResults.get(gk);
+            group.total++;
+            group.failed++;
+        }
+    }
+    // Migration detection: all topics in a group failed
+    const migrationGroups = [];
+    for (const [gid, stats] of groupPostResults) {
+        if (stats.total > 0 && stats.failed === stats.total) {
+            migrationGroups.push(gid);
+        }
+    }
+    // Update registry: lastDoctorAllRunAt and per-topic timestamps
+    await withRegistry(workspaceDir, (data) => {
+        data.lastDoctorAllRunAt = now.toISOString();
+        for (const [_key, entry] of Object.entries(data.topics)) {
+            if (!isEligible(entry, now))
+                continue;
+            // Update consecutiveSilentDoctors (compare against old lastDoctorRunAt before overwriting)
+            if (entry.lastMessageAt) {
+                const lastMsg = new Date(entry.lastMessageAt).getTime();
+                const lastDoctor = entry.lastDoctorRunAt
+                    ? new Date(entry.lastDoctorRunAt).getTime()
+                    : 0;
+                if (lastMsg > lastDoctor) {
+                    // User interacted since last doctor run — reset counter
+                    entry.consecutiveSilentDoctors = 0;
+                }
+                else {
+                    entry.consecutiveSilentDoctors++;
+                }
+            }
+            else {
+                entry.consecutiveSilentDoctors++;
+            }
+            entry.lastDoctorRunAt = now.toISOString();
+            // Auto-snooze for spam control
+            if (entry.consecutiveSilentDoctors >= SPAM_THRESHOLD) {
+                entry.snoozeUntil = new Date(Date.now() + 30 * 24 * 60 * 60 * 1000).toISOString();
+                entry.status = 'snoozed';
+                entry.consecutiveSilentDoctors = 0;
+            }
+        }
+    });
+    // Build summary
+    const lines = [
+        `<b>Doctor All Summary</b>`,
+        '',
+        `Processed: ${processed}`,
+        `Skipped (ineligible): ${skipped}`,
+        `Total: ${allEntries.length}`,
+    ];
+    if (errors.length > 0) {
+        lines.push('');
+        lines.push(`<b>Errors (${errors.length}):</b>`);
+        for (const e of errors.slice(0, 10)) {
+            lines.push(`- ${htmlEscape(e)}`);
+        }
+        if (errors.length > 10) {
+            lines.push(`... and ${errors.length - 10} more`);
+        }
+    }
+    if (migrationGroups.length > 0) {
+        lines.push('');
+        lines.push('<b>Possible group migrations detected:</b>');
+        for (const gid of migrationGroups) {
+            lines.push(`- Group ${htmlEscape(gid)}: all topics failed. Check for group migration.`);
+        }
+    }
+    // Per-topic reports are returned as a summary for the calling context.
+    // The tool router is responsible for posting individual reports to each topic.
+    // Here we return the summary to the current thread.
+    return {
+        text: lines.join('\n'),
+        parseMode: 'HTML',
+    };
+}
+function isEligible(entry, now) {
+    // Skip archived
+    if (entry.status === 'archived')
+        return false;
+    // Skip snoozed
+    if (entry.snoozeUntil && new Date(entry.snoozeUntil).getTime() > now.getTime())
+        return false;
+    // Skip inactive (no activity for INACTIVE_AFTER_DAYS)
+    if (entry.lastMessageAt) {
+        const lastActive = new Date(entry.lastMessageAt).getTime();
+        const inactiveMs = INACTIVE_AFTER_DAYS * 24 * 60 * 60 * 1000;
+        if (now.getTime() - lastActive > inactiveMs)
+            return false;
+    }
+    // Skip if reported in last 24 hours
+    if (entry.lastDoctorReportAt) {
+        const lastReport = new Date(entry.lastDoctorReportAt).getTime();
+        if (now.getTime() - lastReport < DOCTOR_PER_TOPIC_CAP_MS)
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=doctor-all.js.map

package/dist/commands/doctor-all.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,3 @@
+import type { CommandContext, CommandResult } from './help.js';
+export declare function handleDoctor(ctx: CommandContext): Promise<CommandResult>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/D,wBAAsB,YAAY,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAwF9E"}

package/dist/commands/doctor.js

@@ -0,0 +1,74 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { readRegistry, withRegistry } from '../lib/registry.js';
+import { checkAuthorization } from '../lib/auth.js';
+import { topicKey } from '../lib/types.js';
+import { jailCheck, rejectSymlink } from '../lib/security.js';
+import { buildDoctorReport, buildDoctorButtons } from '../lib/telegram.js';
+import { runAllChecksForTopic } from '../lib/doctor-checks.js';
+import { includePath } from '../lib/include-generator.js';
+export async function handleDoctor(ctx) {
+    const { workspaceDir, configDir, userId, groupId, threadId } = ctx;
+    if (!userId || !groupId || !threadId) {
+        return { text: 'Missing context: userId, groupId, or threadId not available.' };
+    }
+    const registry = readRegistry(workspaceDir);
+    // Auth check (user tier)
+    const auth = checkAuthorization(userId, 'doctor', registry);
+    if (!auth.authorized) {
+        return { text: auth.message ?? 'Not authorized.' };
+    }
+    const key = topicKey(groupId, threadId);
+    const entry = registry.topics[key];
+    if (!entry) {
+        return { text: 'This topic is not registered. Run /topic init first.' };
+    }
+    const projectsBase = path.join(workspaceDir, 'projects');
+    // Path safety
+    if (!jailCheck(projectsBase, entry.slug)) {
+        return { text: 'Path safety check failed.' };
+    }
+    const capsuleDir = path.join(projectsBase, entry.slug);
+    if (rejectSymlink(capsuleDir)) {
+        return { text: 'Capsule directory is a symlink. Aborting for security.' };
+    }
+    // Read include content for config checks (optional)
+    let includeContent;
+    const incPath = includePath(configDir);
+    try {
+        if (fs.existsSync(incPath)) {
+            includeContent = fs.readFileSync(incPath, 'utf-8');
+        }
+    }
+    catch {
+        // Not critical
+    }
+    // Run all checks
+    const cronJobsPath = path.join(configDir, 'cron', 'jobs.json');
+    const results = runAllChecksForTopic(entry, projectsBase, includeContent, registry, cronJobsPath);
+    // Build report
+    const reportText = buildDoctorReport(entry.slug, results);
+    // Build inline keyboard with HMAC-signed callbacks
+    const keyboard = buildDoctorButtons(entry.slug, groupId, threadId, registry.callbackSecret);
+    // Append text command equivalents
+    const textCommands = [
+        '',
+        'Or use text commands:',
+        '/topic snooze 7d',
+        '/topic snooze 30d',
+        '/topic archive',
+    ].join('\n');
+    // Update lastDoctorReportAt
+    await withRegistry(workspaceDir, (data) => {
+        const topic = data.topics[key];
+        if (topic) {
+            topic.lastDoctorReportAt = new Date().toISOString();
+        }
+    });
+    return {
+        text: reportText + textCommands,
+        parseMode: 'HTML',
+        inlineKeyboard: keyboard,
+    };
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG1D,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAmB;IACpD,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,GAAG,CAAC;IAEnE,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;QACrC,OAAO,EAAE,IAAI,EAAE,8DAA8D,EAAE,CAAC;IAClF,CAAC;IAED,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAE5C,yBAAyB;IACzB,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC5D,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACrB,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,IAAI,iBAAiB,EAAE,CAAC;IACrD,CAAC;IAED,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAEnC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,IAAI,EAAE,sDAAsD,EAAE,CAAC;IAC1E,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAEzD,cAAc;IACd,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,OAAO,EAAE,IAAI,EAAE,2BAA2B,EAAE,CAAC;IAC/C,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,wDAAwD,EAAE,CAAC;IAC5E,CAAC;IAED,oDAAoD;IACpD,IAAI,cAAkC,CAAC;IACvC,MAAM,OAAO,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IACvC,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,cAAc,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IAED,iBAAiB;IACjB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC/D,MAAM,OAAO,GAAG,oBAAoB,CAClC,KAAK,EACL,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,YAAY,CACb,CAAC;IAEF,eAAe;IACf,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAE1D,mDAAmD;IACnD,MAAM,QAAQ,GAAG,kBAAkB,CACjC,KAAK,CAAC,IAAI,EACV,OAAO,EACP,QAAQ,EACR,QAAQ,CAAC,cAAc,CACxB,CAAC;IAEF,kCAAkC;IAClC,MAAM,YAAY,GAAG;QACnB,EAAE;QACF,uBAAuB;QACvB,kBAAkB;QAClB,mBAAmB;QACnB,gBAAgB;KACjB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,4BAA4B;IAC5B,MAAM,YAAY,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE;QACxC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,kBAAkB,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACtD,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,IAAI,EAAE,UAAU,GAAG,YAAY;QAC/B,SAAS,EAAE,MAAM;QACjB,cAAc,EAAE,QAAQ;KACzB,CAAC;AACJ,CAAC"}

package/dist/commands/help.d.ts

@@ -0,0 +1,4 @@
+import type { CommandContext, CommandResult } from '../lib/types.js';
+export type { CommandContext, CommandResult };
+export declare function handleHelp(_ctx: CommandContext): CommandResult;
+//# sourceMappingURL=help.d.ts.map

package/dist/commands/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC;AAE9C,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,aAAa,CAK9D"}

package/dist/commands/help.js

@@ -0,0 +1,8 @@
+import { buildHelpCard } from '../lib/telegram.js';
+export function handleHelp(_ctx) {
+    return {
+        text: buildHelpCard(),
+        parseMode: 'HTML',
+    };
+}
+//# sourceMappingURL=help.js.map

package/dist/commands/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAKnD,MAAM,UAAU,UAAU,CAAC,IAAoB;IAC7C,OAAO;QACL,IAAI,EAAE,aAAa,EAAE;QACrB,SAAS,EAAE,MAAM;KAClB,CAAC;AACJ,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,17 @@
+import type { TopicType } from '../lib/types.js';
+import type { CommandContext, CommandResult } from './help.js';
+export declare function handleInit(ctx: CommandContext, args: string): Promise<CommandResult>;
+/**
+ * Entry point for `/topic init`. If args are provided, delegates straight
+ * to `handleInit`. Otherwise starts the interactive two-step flow.
+ */
+export declare function handleInitInteractive(ctx: CommandContext, args: string): Promise<CommandResult>;
+/**
+ * Step 2 (callback `is`): re-validate, then show the type picker.
+ */
+export declare function handleInitSlugConfirm(ctx: CommandContext, slug: string): Promise<CommandResult>;
+/**
+ * Step 3 (callbacks `ic`/`ir`/`im`/`ix`): complete init with chosen type.
+ */
+export declare function handleInitTypeSelect(ctx: CommandContext, slug: string, type: TopicType): Promise<CommandResult>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,iBAAiB,CAAC;AAgB7D,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAI/D,wBAAsB,UAAU,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAwM1F;AAwBD;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAKrG;AA0ED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA6BrG;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,CAErH"}