@songsid/agend 2.0.11-beta.9 → 2.0.12-beta.1

package/dist/settings-api.js

@@ -0,0 +1,283 @@
+import { readFileSync, writeFileSync, existsSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import yaml from "js-yaml";
+import { validateFleetConfig, validateClassicBotConfig } from "./config-validator.js";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+function json(res, code, body) {
+    res.writeHead(code, { "Content-Type": "application/json" });
+    res.end(JSON.stringify(body));
+}
+function readBody(req, maxBytes) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let size = 0;
+        req.on("data", (c) => {
+            size += c.length;
+            if (size > maxBytes) {
+                reject(new Error("payload too large"));
+                req.destroy();
+                return;
+            }
+            chunks.push(c);
+        });
+        req.on("end", () => resolve(Buffer.concat(chunks)));
+        req.on("error", reject);
+    });
+}
+export function isSettingsPath(path) {
+    return path === "/settings" || path.startsWith("/api/settings/");
+}
+const classicPath = (ctx) => join(ctx.dataDir, "classicBot.yaml");
+function readClassic(ctx) {
+    const p = classicPath(ctx);
+    if (!existsSync(p))
+        return {};
+    try {
+        return yaml.load(readFileSync(p, "utf-8")) ?? {};
+    }
+    catch (err) {
+        ctx.logger.warn({ err }, "settings: failed to parse classicBot.yaml");
+        return {};
+    }
+}
+const issueKey = (i) => i.path + "\u0000" + i.message;
+/**
+ * Reject a write only if it INTRODUCES new validation errors. Pre-existing
+ * errors elsewhere in the config (common while a fleet is being assembled)
+ * must not block an unrelated edit — otherwise one bad channel would lock the
+ * user out of saving anything, which reads as "save didn't persist".
+ * Returns true (and responds 400) when the edit adds errors.
+ */
+function rejectIfWorse(res, before, after) {
+    const had = new Set(before.errors.map(issueKey));
+    const introduced = after.errors.filter(e => !had.has(issueKey(e)));
+    if (introduced.length) {
+        json(res, 400, { ok: false, errors: introduced, warnings: after.warnings });
+        return true;
+    }
+    return false;
+}
+/** Warnings to surface on a successful save: new warnings + any pre-existing errors (informational). */
+function saveWarnings(before, after) {
+    const had = new Set(before.errors.map(issueKey));
+    const preExisting = after.errors.filter(e => had.has(issueKey(e))).map(e => ({ path: e.path, message: "pre-existing: " + e.message }));
+    return [...after.warnings, ...preExisting];
+}
+export function handleSettingsRequest(req, res, url, ctx) {
+    const path = url.pathname;
+    if (!isSettingsPath(path))
+        return false;
+    const method = req.method ?? "GET";
+    // ── Static page ──
+    if (method === "GET" && path === "/settings") {
+        try {
+            const html = readFileSync(join(__dirname, "ui", "settings.html"), "utf-8");
+            res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+            res.end(html);
+        }
+        catch {
+            json(res, 500, { error: "settings.html not found" });
+        }
+        return true;
+    }
+    // ── Reads ──
+    if (method === "GET" && path === "/api/settings/fleet") {
+        json(res, 200, ctx.fleetConfig ?? {});
+        return true;
+    }
+    if (method === "GET" && path === "/api/settings/classic") {
+        json(res, 200, readClassic(ctx));
+        return true;
+    }
+    // Everything below mutates — needs an in-memory fleet config.
+    const cfg = ctx.fleetConfig;
+    // ── Fleet defaults ──
+    if (method === "PUT" && path === "/api/settings/fleet/defaults") {
+        if (!cfg) {
+            json(res, 503, { error: "fleet not loaded" });
+            return true;
+        }
+        readBody(req, 512 * 1024).then(buf => {
+            let body;
+            try {
+                body = JSON.parse(buf.toString("utf-8") || "{}");
+            }
+            catch {
+                return json(res, 400, { error: "invalid JSON" });
+            }
+            if (typeof body !== "object" || body === null || Array.isArray(body))
+                return json(res, 400, { error: "expected an object" });
+            const merged = { ...cfg.defaults, ...body };
+            const before = validateFleetConfig(cfg);
+            const after = validateFleetConfig({ ...cfg, defaults: merged });
+            if (rejectIfWorse(res, before, after))
+                return;
+            cfg.defaults = merged;
+            ctx.saveFleetConfig();
+            json(res, 200, { ok: true, warnings: saveWarnings(before, after) });
+        }).catch(() => json(res, 400, { error: "bad request" }));
+        return true;
+    }
+    // ── Fleet channels (full replace) ──
+    if (method === "PUT" && path === "/api/settings/fleet/channels") {
+        if (!cfg) {
+            json(res, 503, { error: "fleet not loaded" });
+            return true;
+        }
+        readBody(req, 512 * 1024).then(buf => {
+            let body;
+            try {
+                body = JSON.parse(buf.toString("utf-8") || "[]");
+            }
+            catch {
+                return json(res, 400, { error: "invalid JSON" });
+            }
+            if (!Array.isArray(body))
+                return json(res, 400, { error: "expected an array of channels" });
+            const next = { ...cfg, channels: body };
+            delete next.channel; // channels[] supersedes the legacy single channel
+            const before = validateFleetConfig(cfg);
+            const after = validateFleetConfig(next);
+            if (rejectIfWorse(res, before, after))
+                return;
+            cfg.channels = body;
+            delete cfg.channel;
+            ctx.saveFleetConfig();
+            json(res, 200, { ok: true, warnings: saveWarnings(before, after) });
+        }).catch(() => json(res, 400, { error: "bad request" }));
+        return true;
+    }
+    // ── Classic defaults ──
+    if (method === "PUT" && path === "/api/settings/classic/defaults") {
+        readBody(req, 512 * 1024).then(buf => {
+            let body;
+            try {
+                body = JSON.parse(buf.toString("utf-8") || "{}");
+            }
+            catch {
+                return json(res, 400, { error: "invalid JSON" });
+            }
+            if (typeof body !== "object" || body === null || Array.isArray(body))
+                return json(res, 400, { error: "expected an object" });
+            const classic = readClassic(ctx);
+            const merged = { ...(classic.defaults ?? {}), ...body };
+            const before = validateClassicBotConfig(classic);
+            const after = validateClassicBotConfig({ ...classic, defaults: merged });
+            if (rejectIfWorse(res, before, after))
+                return;
+            classic.defaults = merged;
+            writeFileSync(classicPath(ctx), yaml.dump(classic, { lineWidth: -1 }));
+            ctx.logger.info("settings: updated classicBot defaults");
+            json(res, 200, { ok: true, warnings: saveWarnings(before, after) });
+        }).catch(() => json(res, 400, { error: "bad request" }));
+        return true;
+    }
+    // ── Reload (SIGHUP) ──
+    if (method === "POST" && path === "/api/settings/reload") {
+        ctx.logger.info("settings: reload requested — sending SIGHUP");
+        try {
+            process.kill(process.pid, "SIGHUP");
+        }
+        catch (err) {
+            ctx.logger.warn({ err }, "settings: SIGHUP failed");
+        }
+        json(res, 200, { ok: true });
+        return true;
+    }
+    // ── Instances (create / patch / delete) ──
+    const validName = (n) => !!n && /^[^\\/\x00]+$/.test(n);
+    // Create-or-merge an instance, blocking only on newly-introduced errors.
+    const commitInstance = (name, exists, body) => {
+        if (typeof body !== "object" || body === null || Array.isArray(body)) {
+            json(res, 400, { error: "expected an object" });
+            return;
+        }
+        const base = (exists ? cfg.instances[name] : {});
+        const mergedInst = { ...base, ...body };
+        const before = validateFleetConfig(cfg);
+        const after = validateFleetConfig({ ...cfg, instances: { ...cfg.instances, [name]: mergedInst } });
+        if (rejectIfWorse(res, before, after))
+            return;
+        cfg.instances[name] = mergedInst;
+        ctx.saveFleetConfig();
+        json(res, 200, { ok: true, warnings: saveWarnings(before, after) });
+    };
+    // POST /api/settings/fleet/instances  — create, name taken from the body.
+    if (method === "POST" && path === "/api/settings/fleet/instances") {
+        if (!cfg) {
+            json(res, 503, { error: "fleet not loaded" });
+            return true;
+        }
+        readBody(req, 512 * 1024).then(buf => {
+            let body;
+            try {
+                body = JSON.parse(buf.toString("utf-8") || "{}");
+            }
+            catch {
+                return json(res, 400, { error: "invalid JSON" });
+            }
+            if (typeof body !== "object" || body === null || Array.isArray(body))
+                return json(res, 400, { error: "expected an object" });
+            const name = typeof body.name === "string" ? body.name.trim() : "";
+            if (!validName(name))
+                return json(res, 400, { error: "missing or invalid instance name (provide `name` in the body)" });
+            if (cfg.instances[name])
+                return json(res, 409, { error: "instance already exists" });
+            const { name: _n, ...instBody } = body;
+            commitInstance(name, false, instBody);
+        }).catch(() => json(res, 400, { error: "bad request" }));
+        return true;
+    }
+    // /api/settings/fleet/instances/:name  — create / patch / delete.
+    const instPrefix = "/api/settings/fleet/instances/";
+    if (path.startsWith(instPrefix)) {
+        if (!cfg) {
+            json(res, 503, { error: "fleet not loaded" });
+            return true;
+        }
+        const name = decodeURIComponent(path.slice(instPrefix.length));
+        if (!validName(name)) {
+            json(res, 400, { error: "invalid instance name" });
+            return true;
+        }
+        if (method === "DELETE") {
+            if (!cfg.instances[name]) {
+                json(res, 404, { error: "instance not found" });
+                return true;
+            }
+            // DELETE never blocks on validation; surface any resulting warnings.
+            delete cfg.instances[name];
+            ctx.saveFleetConfig();
+            json(res, 200, { ok: true, warnings: validateFleetConfig(cfg).warnings });
+            return true;
+        }
+        if (method === "POST" || method === "PATCH") {
+            const exists = !!cfg.instances[name];
+            if (method === "POST" && exists) {
+                json(res, 409, { error: "instance already exists" });
+                return true;
+            }
+            if (method === "PATCH" && !exists) {
+                json(res, 404, { error: "instance not found" });
+                return true;
+            }
+            readBody(req, 512 * 1024).then(buf => {
+                let body;
+                try {
+                    body = JSON.parse(buf.toString("utf-8") || "{}");
+                }
+                catch {
+                    return json(res, 400, { error: "invalid JSON" });
+                }
+                commitInstance(name, exists, body);
+            }).catch(() => json(res, 400, { error: "bad request" }));
+            return true;
+        }
+        json(res, 405, { error: "method not allowed" });
+        return true;
+    }
+    json(res, 404, { error: "not found" });
+    return true;
+}
+//# sourceMappingURL=settings-api.js.map

package/dist/settings-api.js.map

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

package/dist/topic-commands.d.ts

@@ -13,12 +13,25 @@ export declare function saveCommandForBackend(backend: string, filename: string,
 export declare function parseSaveFilename(text: string): string;
 /** Shared message when a backend doesn't support /save. */
 export declare const SAVE_UNSUPPORTED_MSG = "\u26A0\uFE0F /save is not supported for this backend (only kiro-cli and claude-code)";
+/**
+ * The in-session compact/context-reset command for a backend NAME (the fleet
+ * process routes /compact via IPC and only has the backend string, not a
+ * CliBackend instance). Keep in sync with each backend's getCompactCommand().
+ * Most CLIs (claude-code, kiro-cli, codex, opencode, gemini-cli) use "/compact".
+ * Antigravity (agy) has NO summarizing compact — its only manual context-reset
+ * is "/clear" (a full reset; it also auto-summarizes at a token threshold).
+ */
+export declare function compactCommandForBackend(backend: string): string;
 /**
  * Extract context-usage % from a captured CLI pane. Scans bottom-up so the
  * MOST RECENT prompt wins (a captured scrollback may hold several). Covers the
  * common CLI prompt formats:
  *   kiro-cli classic:  "6% !>"        kiro-cli TUI: "◔ 6%"
  *   bracketed:         "[6%]"         claude/others prompt: "6% ❯" / "6% >"
+ *   codex TUI footer:  "Context 94% left" (remaining) or "Context 6% used"
+ *   opencode footer:   "1.2K (6%)"   (token count then parenthesized %)
+ * All values returned are context USED (low % = fresh session); codex's
+ * "N% left" is remaining, so it's inverted to 100 - N.
  */
 export declare function parseContextPercent(pane: string): number | null;
 export declare class TopicCommands {
@@ -28,11 +41,25 @@ export declare class TopicCommands {
     private getReplyAdapter;
     /** Parse and dispatch commands from the General topic */
     handleGeneralCommand(msg: InboundMessage): Promise<boolean>;
+    /**
+     * Build the dashboard URL text (View / Settings / Web UI). The Settings/Web UI
+     * URLs carry the web token; when `htmlSpoiler` is set they're wrapped in a
+     * Telegram HTML spoiler (`<tg-spoiler>`) so the token isn't shown in the clear
+     * in a shared topic (the caller must send with format: "html"). /view is
+     * public, so it's never spoilered. DC uses the plain form (ephemeral reply).
+     */
+    getDashboardText(htmlSpoiler?: boolean): string;
+    /**
+     * /dashboard (TG): admin-only. Replies directly in the topic; the token-
+     * bearing URLs are wrapped in a Telegram HTML spoiler so they aren't shown in
+     * the clear (the adapter supports plain/HTML, not MarkdownV2's `||…||`).
+     */
+    private handleDashboardCommand;
     /** Handle /ctx or /compact in any instance topic — returns true if handled */
     handleInstanceCommand(msg: InboundMessage, instanceName: string): Promise<boolean>;
     /** Get context usage text for an instance (shared by TG + DC) */
     getCtxText(instanceName: string): Promise<string>;
-    /** Send /compact to an instance's tmux pane */
+    /** Send the backend-appropriate compact command to an instance's tmux pane */
     sendCompact(instanceName: string): Promise<string>;
     /** Send a backend-appropriate session-save command to a fleet-topic instance. */
     sendSave(instanceName: string, filename: string): Promise<string>;

package/dist/topic-commands.js

@@ -6,6 +6,8 @@ import { createRequire } from "node:module";
 const execAsync = promisify(exec);
 import { DEFAULT_INSTANCE_CONFIG } from "./config.js";
 import { formatCents } from "./cost-guard.js";
+import { getAgendHome } from "./paths.js";
+import { t } from "./locale.js";
 /** Sanitize a directory name into a valid instance name. Keeps Unicode letters (incl. CJK). */
 export function sanitizeInstanceName(name) {
     const sanitized = name.toLowerCase().replace(/[^\p{L}\d-]/gu, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
@@ -31,18 +33,43 @@ export function parseSaveFilename(text) {
 }
 /** Shared message when a backend doesn't support /save. */
 export const SAVE_UNSUPPORTED_MSG = "⚠️ /save is not supported for this backend (only kiro-cli and claude-code)";
+/**
+ * The in-session compact/context-reset command for a backend NAME (the fleet
+ * process routes /compact via IPC and only has the backend string, not a
+ * CliBackend instance). Keep in sync with each backend's getCompactCommand().
+ * Most CLIs (claude-code, kiro-cli, codex, opencode, gemini-cli) use "/compact".
+ * Antigravity (agy) has NO summarizing compact — its only manual context-reset
+ * is "/clear" (a full reset; it also auto-summarizes at a token threshold).
+ */
+export function compactCommandForBackend(backend) {
+    if (backend === "antigravity")
+        return "/clear";
+    return "/compact";
+}
 /**
  * Extract context-usage % from a captured CLI pane. Scans bottom-up so the
  * MOST RECENT prompt wins (a captured scrollback may hold several). Covers the
  * common CLI prompt formats:
  *   kiro-cli classic:  "6% !>"        kiro-cli TUI: "◔ 6%"
  *   bracketed:         "[6%]"         claude/others prompt: "6% ❯" / "6% >"
+ *   codex TUI footer:  "Context 94% left" (remaining) or "Context 6% used"
+ *   opencode footer:   "1.2K (6%)"   (token count then parenthesized %)
+ * All values returned are context USED (low % = fresh session); codex's
+ * "N% left" is remaining, so it's inverted to 100 - N.
  */
 export function parseContextPercent(pane) {
     const lines = pane.split("\n");
     for (let i = lines.length - 1; i >= 0; i--) {
         const line = lines[i];
-        const m = line.match(/(\d+)%.*[!❯>]/) || line.match(/◔\s*(\d+)%/) || line.match(/\[(\d+)%\]/);
+        // codex "context-remaining" item shows "Context N% left" (REMAINING) → used = 100 - N
+        const left = line.match(/Context\s+(\d+)%\s+left/i);
+        if (left)
+            return 100 - parseInt(left[1], 10);
+        const m = line.match(/(\d+)%.*[!❯>]/)
+            || line.match(/◔\s*(\d+)%/)
+            || line.match(/\[(\d+)%\]/)
+            || line.match(/Context\s+(\d+)%\s+used/i) // codex "context-used" variant
+            || line.match(/\d+(?:\.\d+)?[KM]?\s*\((\d+)%\)/); // opencode "1.2K (6%)"
         if (m)
             return parseInt(m[1], 10);
     }
@@ -86,8 +113,60 @@ export class TopicCommands {
             await this.handleUpdateCommand(msg);
             return true;
         }
+        if (text === "/dashboard" || text.startsWith("/dashboard@")) {
+            await this.handleDashboardCommand(msg);
+            return true;
+        }
         return false;
     }
+    /**
+     * Build the dashboard URL text (View / Settings / Web UI). The Settings/Web UI
+     * URLs carry the web token; when `htmlSpoiler` is set they're wrapped in a
+     * Telegram HTML spoiler (`<tg-spoiler>`) so the token isn't shown in the clear
+     * in a shared topic (the caller must send with format: "html"). /view is
+     * public, so it's never spoilered. DC uses the plain form (ephemeral reply).
+     */
+    getDashboardText(htmlSpoiler = false) {
+        const port = this.ctx.fleetConfig?.health_port ?? 19280;
+        const host = this.ctx.fleetConfig?.hostname || "localhost";
+        let token = "";
+        try {
+            token = readFileSync(join(getAgendHome(), "web.token"), "utf-8").trim();
+        }
+        catch { /* not started yet */ }
+        const base = `http://${host}:${port}`;
+        const hide = (u) => htmlSpoiler ? `<tg-spoiler>${u}</tg-spoiler>` : u;
+        return [
+            t("dashboard.title"),
+            "",
+            `• View:     ${base}/view`,
+            `• View (edit): ${hide(`${base}/view?token=${token}`)}`,
+            `• Settings: ${hide(`${base}/settings?token=${token}`)}`,
+            `• Web UI:   ${hide(`${base}/ui?token=${token}`)}`,
+        ].join("\n");
+    }
+    /**
+     * /dashboard (TG): admin-only. Replies directly in the topic; the token-
+     * bearing URLs are wrapped in a Telegram HTML spoiler so they aren't shown in
+     * the clear (the adapter supports plain/HTML, not MarkdownV2's `||…||`).
+     */
+    async handleDashboardCommand(msg) {
+        const adapter = this.getReplyAdapter(msg);
+        if (!adapter)
+            return;
+        const chatId = msg.chatId;
+        const threadId = msg.threadId;
+        const allowed = this.ctx.fleetConfig?.channel?.access?.allowed_users ?? [];
+        if (allowed.length === 0) {
+            await adapter.sendText(chatId, t("dashboard.disabled"), { threadId });
+            return;
+        }
+        if (!allowed.some(u => String(u) === String(msg.userId))) {
+            await adapter.sendText(chatId, t("not_authorized"), { threadId });
+            return;
+        }
+        await adapter.sendText(chatId, this.getDashboardText(true), { threadId, format: "html" });
+    }
     /** Handle /ctx or /compact in any instance topic — returns true if handled */
     async handleInstanceCommand(msg, instanceName) {
         const text = msg.text?.trim();
@@ -99,8 +178,8 @@ export class TopicCommands {
                 return false;
             const isCollab = this.ctx.toggleFleetCollab(instanceName);
             await adapter.sendText(msg.chatId, isCollab
-                ? "🤝 Collaboration mode **ON** — bot/webhook messages to this topic will reach the agent."
-                : "💬 Collaboration mode **OFF** — only user messages trigger the agent.", { threadId: msg.threadId });
+                ? t("collab.on")
+                : t("collab.off"), { threadId: msg.threadId });
             return true;
         }
         if (text === "/compact" || text.startsWith("/compact@")) {
@@ -116,7 +195,7 @@ export class TopicCommands {
             if (!adapter)
                 return false;
             const ok = this.ctx.cancelInstance(instanceName);
-            await adapter.sendText(msg.chatId, ok ? `🛑 已送出取消給 ${instanceName}。` : `❌ ${instanceName} 未在執行。`, { threadId: msg.threadId });
+            await adapter.sendText(msg.chatId, ok ? t("cancel.sent", instanceName) : t("cancel.not_running", instanceName), { threadId: msg.threadId });
             return true;
         }
         if (text === "/save" || text.startsWith("/save ") || text.startsWith("/save@")) {
@@ -125,11 +204,11 @@ export class TopicCommands {
                 return false;
             const filename = parseSaveFilename(text);
             if (!filename) {
-                await adapter.sendText(msg.chatId, "Usage: /save <filename>", { threadId: msg.threadId });
+                await adapter.sendText(msg.chatId, t("save.usage"), { threadId: msg.threadId });
                 return true;
             }
             if (!SAVE_FILENAME_RE.test(filename)) {
-                await adapter.sendText(msg.chatId, "⛔ Invalid filename — only letters, numbers, dots, hyphens, underscores allowed.", { threadId: msg.threadId });
+                await adapter.sendText(msg.chatId, t("filename.invalid"), { threadId: msg.threadId });
                 return true;
             }
             const result = await this.sendSave(instanceName, filename);
@@ -173,15 +252,18 @@ export class TopicCommands {
             catch { /* ignore */ }
         }
         return context != null
-            ? `📊 Context: ${context}% used\nBackend: ${backend}\nInstance: ${instanceName}`
-            : `Context info not available yet.\nBackend: ${backend}\nInstance: ${instanceName}`;
+            ? `${t("ctx.used", context)}\n${t("ctx.backend", backend)}\n${t("ctx.instance", instanceName)}`
+            : `${t("ctx.unavailable")}\n${t("ctx.backend", backend)}\n${t("ctx.instance", instanceName)}`;
     }
-    /** Send /compact to an instance's tmux pane */
+    /** Send the backend-appropriate compact command to an instance's tmux pane */
     async sendCompact(instanceName) {
         const ipc = this.ctx.instanceIpcClients.get(instanceName);
         if (ipc?.connected) {
-            ipc.send({ type: "raw_paste", content: "/compact" });
-            return "🗜️ Compact command sent.";
+            const backend = this.ctx.fleetConfig?.instances[instanceName]?.backend
+                ?? this.ctx.fleetConfig?.defaults?.backend ?? "claude-code";
+            const cmd = compactCommandForBackend(backend);
+            ipc.send({ type: "raw_paste", content: cmd });
+            return `🗜️ Compact command sent (\`${cmd}\`).`;
         }
         return "❌ Instance not connected (IPC unavailable)";
     }
@@ -207,10 +289,10 @@ export class TopicCommands {
         const threadId = msg.threadId;
         const allowed = this.ctx.fleetConfig?.channel?.access?.allowed_users ?? [];
         if (allowed.length > 0 && !allowed.some(u => String(u) === String(msg.userId))) {
-            await adapter.sendText(chatId, "⛔ Not authorized", { threadId });
+            await adapter.sendText(chatId, t("not_authorized"), { threadId });
             return;
         }
-        await adapter.sendText(chatId, "🔄 Graceful restart — waiting for instances to idle...", { threadId });
+        await adapter.sendText(chatId, t("restart.graceful"), { threadId });
         process.kill(process.pid, "SIGUSR2");
     }
     async handleStatusCommand(msg) {
@@ -314,14 +396,14 @@ export class TopicCommands {
         // Access control — only allowed users can trigger update; empty = disabled
         const allowed = this.ctx.fleetConfig?.channel?.access?.allowed_users ?? [];
         if (allowed.length === 0) {
-            await adapter.sendText(chatId, "⛔ /update disabled — no allowed_users configured", { threadId });
+            await adapter.sendText(chatId, t("update.disabled"), { threadId });
             return;
         }
         if (!allowed.some(u => String(u) === String(msg.userId))) {
-            await adapter.sendText(chatId, "⛔ Not authorized", { threadId });
+            await adapter.sendText(chatId, t("not_authorized"), { threadId });
             return;
         }
-        await adapter.sendText(chatId, "📦 Updating AgEnD... Fleet will restart automatically.", { threadId });
+        await adapter.sendText(chatId, t("update.running"), { threadId });
         const currentVersion = createRequire(import.meta.url)("../package.json").version ?? "";
         const updateCmd = currentVersion.includes("beta") ? "agend update --beta" : "agend update";
         const { spawn } = await import("node:child_process");
@@ -336,10 +418,10 @@ export class TopicCommands {
         const threadId = msg.threadId;
         const allowed = this.ctx.fleetConfig?.channel?.access?.allowed_users ?? [];
         if (allowed.length > 0 && !allowed.some(u => String(u) === String(msg.userId))) {
-            await adapter.sendText(chatId, "⛔ Not authorized", { threadId });
+            await adapter.sendText(chatId, t("not_authorized"), { threadId });
             return;
         }
-        await adapter.sendText(chatId, "🩺 Running diagnostics...", { threadId });
+        await adapter.sendText(chatId, t("doctor.running"), { threadId });
         try {
             const { execSync } = await import("node:child_process");
             const backend = this.ctx.fleetConfig?.defaults?.backend || "claude-code";
@@ -419,7 +501,15 @@ export class TopicCommands {
                 }
                 if (platformType === "discord") {
                     const ch = channels.find(c => c.type === "discord");
-                    config.topic_id = ch?.options?.general_channel_id ?? 1;
+                    const gcid = ch?.options?.general_channel_id;
+                    // A Discord general needs a real channel id — NOT the TG-convention
+                    // "1", which makes the DC adapter throw fetching channel "1". Skip
+                    // (leave unbound) if there's no valid channel to bind to.
+                    if (gcid == null || !/^\d{17,}$/.test(String(gcid))) {
+                        this.ctx.logger.warn({ name }, "Discord general has no valid general_channel_id — skipping topic bind (set channel.options.general_channel_id)");
+                        continue;
+                    }
+                    config.topic_id = gcid;
                 }
                 else {
                     config.topic_id = 1;
@@ -463,6 +553,7 @@ export class TopicCommands {
                         commands: [
                             { command: "status", description: "Show fleet status and costs" },
                             { command: "sysinfo", description: "System diagnostics" },
+                            { command: "dashboard", description: "🔒 Get dashboard URLs" },
                             { command: "ctx", description: "Show context usage" },
                             { command: "compact", description: "Compact agent context" },
                             { command: "restart", description: "🔒 Graceful restart all instances" },