@songsid/agend 0.0.1

package/dist/tmux-manager.js

@@ -0,0 +1,218 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const exec = promisify(execFile);
+export class TmuxManager {
+    sessionName;
+    windowId;
+    // Socket isolation: null = use tmux default socket (backward compatible).
+    // Set to a name to use `-L <name>` for custom AGEND_HOME isolation.
+    static socketName = null;
+    static setSocketName(name) {
+        TmuxManager.socketName = name;
+    }
+    /** Prefix tmux args with -L when socket isolation is active. */
+    static tmuxArgs(args) {
+        if (!TmuxManager.socketName)
+            return args;
+        return ["-L", TmuxManager.socketName, ...args];
+    }
+    constructor(sessionName, windowId) {
+        this.sessionName = sessionName;
+        this.windowId = windowId;
+    }
+    // === Static session-level methods ===
+    static async ensureSession(name) {
+        if (await TmuxManager.sessionExists(name))
+            return;
+        try {
+            await exec("tmux", TmuxManager.tmuxArgs(["new-session", "-d", "-s", name]));
+        }
+        catch (err) {
+            if (String(err).includes("duplicate session"))
+                return;
+            throw err;
+        }
+    }
+    static async sessionExists(name) {
+        try {
+            await exec("tmux", TmuxManager.tmuxArgs(["has-session", "-t", name]));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    static async killSession(name) {
+        try {
+            await exec("tmux", TmuxManager.tmuxArgs(["kill-session", "-t", name]));
+        }
+        catch {
+            // Expected if session doesn't exist
+        }
+    }
+    static async listWindows(sessionName) {
+        try {
+            const { stdout } = await exec("tmux", TmuxManager.tmuxArgs([
+                "list-windows", "-t", sessionName, "-F", "#{window_id}|||#{window_name}"
+            ]));
+            return stdout.trim().split("\n").filter(Boolean).map(line => {
+                const [id, name] = line.split("|||");
+                return { id, name };
+            });
+        }
+        catch {
+            return [];
+        }
+    }
+    static async getPanePid(sessionName, windowId) {
+        try {
+            const { stdout } = await exec("tmux", TmuxManager.tmuxArgs([
+                "list-panes", "-t", `${sessionName}:${windowId}`, "-F", "#{pane_pid}",
+            ]));
+            const pid = parseInt(stdout.trim(), 10);
+            return isNaN(pid) ? null : pid;
+        }
+        catch {
+            return null;
+        }
+    }
+    // === Instance window methods ===
+    async createWindow(command, cwd, windowName) {
+        const args = ["new-window", "-a", "-t", this.sessionName, "-c", cwd];
+        if (windowName)
+            args.push("-n", windowName);
+        args.push("-P", "-F", "#{window_id}", command);
+        const { stdout } = await exec("tmux", TmuxManager.tmuxArgs(args));
+        this.windowId = stdout.trim();
+        if (windowName) {
+            await exec("tmux", TmuxManager.tmuxArgs(["set-window-option", "-t", `${this.sessionName}:${this.windowId}`, "allow-rename", "off"])).catch(() => { });
+        }
+        return this.windowId;
+    }
+    async killWindow() {
+        if (!this.windowId)
+            return;
+        try {
+            await exec("tmux", TmuxManager.tmuxArgs(["kill-window", "-t", `${this.sessionName}:${this.windowId}`]));
+        }
+        catch {
+            // Expected if window already exited
+        }
+    }
+    /**
+     * Check if the tmux window still exists in the session.
+     * Note: with remain-on-exit enabled, a window with a dead pane still
+     * returns true. Use getPaneStatus() to distinguish alive vs dead pane.
+     */
+    async isWindowAlive() {
+        if (!this.windowId)
+            return false;
+        try {
+            const windows = await TmuxManager.listWindows(this.sessionName);
+            return windows.some(w => w.id === this.windowId);
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Enable remain-on-exit so dead panes are preserved for exit code capture. */
+    async setRemainOnExit() {
+        await exec("tmux", TmuxManager.tmuxArgs([
+            "set-option", "-t", `${this.sessionName}:${this.windowId}`,
+            "remain-on-exit", "on",
+        ]));
+    }
+    /**
+     * Get pane status. Returns null if the window doesn't exist.
+     * When remain-on-exit is enabled, a dead pane has alive=false with exitCode.
+     * exitCode is undefined if tmux version doesn't support pane_dead_status (< 3.1).
+     */
+    async getPaneStatus() {
+        if (!this.windowId)
+            return null;
+        try {
+            const { stdout } = await exec("tmux", TmuxManager.tmuxArgs([
+                "list-panes", "-t", `${this.sessionName}:${this.windowId}`,
+                "-F", "#{pane_dead} #{pane_dead_status}",
+            ]));
+            const line = stdout.trim().split("\n")[0];
+            if (!line)
+                return null;
+            const parts = line.split(" ");
+            const dead = parts[0];
+            if (dead === "1") {
+                const code = parseInt(parts[1], 10);
+                return { alive: false, exitCode: Number.isNaN(code) ? undefined : code };
+            }
+            return { alive: true };
+        }
+        catch {
+            return null;
+        }
+    }
+    async sendKeys(text) {
+        try {
+            await exec("tmux", TmuxManager.tmuxArgs(["send-keys", "-l", "-t", `${this.sessionName}:${this.windowId}`, text]));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async sendSpecialKey(key) {
+        try {
+            await exec("tmux", TmuxManager.tmuxArgs(["send-keys", "-t", `${this.sessionName}:${this.windowId}`, key]));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async pasteText(text) {
+        try {
+            const target = `${this.sessionName}:${this.windowId}`;
+            const bufName = `paste-${this.windowId}-${Date.now()}`;
+            await exec("tmux", TmuxManager.tmuxArgs(["set-buffer", "-b", bufName, "--", text]));
+            await exec("tmux", TmuxManager.tmuxArgs(["paste-buffer", "-d", "-b", bufName, "-t", target, "-p"]));
+            await new Promise(r => setTimeout(r, 500));
+            await exec("tmux", TmuxManager.tmuxArgs(["send-keys", "-t", target, "Enter"]));
+            // Retry Enter: if TUI was busy outputting, the first Enter may be swallowed.
+            // A second Enter on an empty input is a no-op for all supported CLIs.
+            await new Promise(r => setTimeout(r, 1000));
+            await exec("tmux", TmuxManager.tmuxArgs(["send-keys", "-t", target, "Enter"]));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async pipeOutput(logPath) {
+        // pipe-pane's shell command runs via /bin/sh -c. Reject control characters
+        // that would break out of the single-quote escape (newlines, NULs, etc.);
+        // only expect absolute paths produced by getAgendHome() / instanceDir.
+        if (/[\x00-\x1f]/.test(logPath)) {
+            throw new Error(`Invalid log path (contains control characters): ${JSON.stringify(logPath)}`);
+        }
+        const escaped = logPath.replace(/'/g, "'\\''");
+        await exec("tmux", TmuxManager.tmuxArgs([
+            "pipe-pane", "-t", `${this.sessionName}:${this.windowId}`,
+            `cat >> '${escaped}'`,
+        ]));
+    }
+    async capturePane() {
+        const { stdout } = await exec("tmux", TmuxManager.tmuxArgs([
+            "capture-pane", "-t", `${this.sessionName}:${this.windowId}`, "-p",
+        ]));
+        return stdout;
+    }
+    /** Capture pane content including scrollback history (last N lines). */
+    async capturePaneWithHistory(lines = 50) {
+        const { stdout } = await exec("tmux", TmuxManager.tmuxArgs([
+            "capture-pane", "-t", `${this.sessionName}:${this.windowId}`,
+            "-p", "-S", `-${lines}`,
+        ]));
+        return stdout;
+    }
+    getWindowId() { return this.windowId; }
+}
+//# sourceMappingURL=tmux-manager.js.map

package/dist/tmux-manager.js.map

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

package/dist/topic-archiver.d.ts

@@ -0,0 +1,40 @@
+import type { FleetConfig } from "./types.js";
+import type { ChannelAdapter } from "./channel/types.js";
+import type { Logger } from "./logger.js";
+export interface ArchiverContext {
+    readonly fleetConfig: FleetConfig | null;
+    readonly adapter: ChannelAdapter | null;
+    readonly logger: Logger;
+    readonly dataDir: string;
+    getInstanceStatus(name: string): "running" | "stopped" | "crashed";
+    lastActivityMs(name: string): number;
+    setTopicIcon(name: string, state: "green" | "blue" | "red" | "remove"): void;
+    touchActivity(name: string): void;
+}
+/**
+ * Manages automatic archival (close) and reopening of idle forum topics.
+ *
+ * Archived state is persisted to `<dataDir>/archived-topics.json` so a daemon
+ * restart does not re-archive (or re-message) topics that were already closed.
+ */
+export declare class TopicArchiver {
+    private ctx;
+    private archived;
+    private timer;
+    private readonly statePath;
+    static readonly IDLE_MS: number;
+    private static readonly POLL_MS;
+    constructor(ctx: ArchiverContext);
+    private load;
+    private save;
+    /** Is this topic currently archived? */
+    isArchived(topicId: string): boolean;
+    /** Start periodic idle check. */
+    startPoller(): void;
+    /** Stop the poller and clean up. */
+    stop(): void;
+    /** Close topics that have been idle beyond threshold. */
+    archiveIdle(): Promise<void>;
+    /** Reopen an archived topic and restore icon. */
+    reopen(topicId: string, instanceName: string): Promise<void>;
+}

package/dist/topic-archiver.js

@@ -0,0 +1,103 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+/**
+ * Manages automatic archival (close) and reopening of idle forum topics.
+ *
+ * Archived state is persisted to `<dataDir>/archived-topics.json` so a daemon
+ * restart does not re-archive (or re-message) topics that were already closed.
+ */
+export class TopicArchiver {
+    ctx;
+    archived = new Set();
+    timer = null;
+    statePath;
+    static IDLE_MS = 24 * 60 * 60 * 1000; // 24 hours
+    static POLL_MS = 30 * 60_000; // check every 30 minutes
+    constructor(ctx) {
+        this.ctx = ctx;
+        this.statePath = join(ctx.dataDir, "archived-topics.json");
+        this.load();
+    }
+    load() {
+        if (!existsSync(this.statePath))
+            return;
+        try {
+            const arr = JSON.parse(readFileSync(this.statePath, "utf-8"));
+            if (!Array.isArray(arr))
+                return;
+            for (const id of arr) {
+                if (typeof id === "string")
+                    this.archived.add(id);
+            }
+        }
+        catch (err) {
+            this.ctx.logger.warn({ err, path: this.statePath }, "Failed to load archived-topics state");
+        }
+    }
+    save() {
+        try {
+            writeFileSync(this.statePath, JSON.stringify([...this.archived]));
+        }
+        catch (err) {
+            this.ctx.logger.warn({ err, path: this.statePath }, "Failed to save archived-topics state");
+        }
+    }
+    /** Is this topic currently archived? */
+    isArchived(topicId) {
+        return this.archived.has(topicId);
+    }
+    /** Start periodic idle check. */
+    startPoller() {
+        this.timer = setInterval(() => {
+            this.archiveIdle().catch((err) => this.ctx.logger.debug({ err }, "Archive idle check failed"));
+        }, TopicArchiver.POLL_MS);
+    }
+    /** Stop the poller and clean up. */
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    /** Close topics that have been idle beyond threshold. */
+    async archiveIdle() {
+        if (!this.ctx.adapter?.closeForumTopic || !this.ctx.fleetConfig)
+            return;
+        const now = Date.now();
+        for (const [name, config] of Object.entries(this.ctx.fleetConfig.instances)) {
+            const topicId = config.topic_id;
+            if (topicId == null || config.general_topic)
+                continue;
+            const topicIdStr = String(topicId);
+            if (this.archived.has(topicIdStr))
+                continue;
+            const status = this.ctx.getInstanceStatus(name);
+            if (status !== "running")
+                continue;
+            const last = this.ctx.lastActivityMs(name);
+            if (last === 0)
+                continue; // never active → skip
+            if (now - last < TopicArchiver.IDLE_MS)
+                continue;
+            this.ctx.logger.info({ name, topicId, idleHours: Math.round((now - last) / 3600000) }, "Archiving idle topic");
+            this.archived.add(topicIdStr);
+            this.save();
+            this.ctx.setTopicIcon(name, "remove");
+            await this.ctx.adapter.closeForumTopic(topicId);
+        }
+    }
+    /** Reopen an archived topic and restore icon. */
+    async reopen(topicId, instanceName) {
+        if (!this.archived.has(topicId))
+            return;
+        this.archived.delete(topicId);
+        this.save();
+        if (this.ctx.adapter?.reopenForumTopic) {
+            await this.ctx.adapter.reopenForumTopic(topicId);
+        }
+        this.ctx.setTopicIcon(instanceName, "green");
+        this.ctx.touchActivity(instanceName);
+        this.ctx.logger.info({ instanceName, topicId }, "Reopened archived topic");
+    }
+}
+//# sourceMappingURL=topic-archiver.js.map

package/dist/topic-archiver.js.map

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

package/dist/topic-commands.d.ts

@@ -0,0 +1,28 @@
+import type { FleetContext } from "./fleet-context.js";
+import type { InboundMessage } from "./channel/types.js";
+/** Sanitize a directory name into a valid instance name. Keeps Unicode letters (incl. CJK). */
+export declare function sanitizeInstanceName(name: string): string;
+export declare class TopicCommands {
+    private ctx;
+    constructor(ctx: FleetContext);
+    /** Get the adapter that should reply to a given inbound message */
+    private getReplyAdapter;
+    /** Parse and dispatch commands from the General topic */
+    handleGeneralCommand(msg: InboundMessage): Promise<boolean>;
+    /** Handle /ctx in any instance topic — returns true if handled */
+    handleInstanceCommand(msg: InboundMessage, instanceName: string): Promise<boolean>;
+    private handleRestartCommand;
+    private handleStatusCommand;
+    private handleSysInfoCommand;
+    private handleUpdateCommand;
+    /** Reply with redirect when message arrives in an unbound topic */
+    handleUnboundTopic(msg: InboundMessage): Promise<void>;
+    /** Handle topic deletion — stop daemon and remove from config */
+    handleTopicDeleted(threadId: string): Promise<void>;
+    /** Create instance config, save fleet.yaml, start daemon, connect IPC. */
+    bindAndStart(dirPath: string, topicId: number | string): Promise<string>;
+    /** Create Telegram topics for instances that don't have topic_id */
+    autoCreateTopics(): Promise<void>;
+    /** Register bot commands in Telegram command menu */
+    registerBotCommands(): Promise<void>;
+}