@songsid/agend 2.0.11-beta.9 → 2.0.11

package/dist/config-validator.js

@@ -0,0 +1,154 @@
+/**
+ * Shared config validation for fleet.yaml and classicBot.yaml.
+ *
+ * Pure functions with no fleet-manager / filesystem dependencies so both the
+ * CLI (`agend validate`) and the Settings API can import them. `errors` block a
+ * write (they break the fleet); `warnings` are advisory (write is allowed).
+ */
+/** Backends the factory can instantiate (keep in sync with backend/factory.ts). */
+export const KNOWN_BACKENDS = ["claude-code", "gemini-cli", "codex", "opencode", "kiro-cli", "antigravity", "mock"];
+const isObj = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+/** Every value is a non-empty string or a number (Telegram/Discord ids). */
+function isIdArray(v) {
+    return Array.isArray(v) && v.every(x => (typeof x === "string" && x.length > 0) || typeof x === "number");
+}
+/** The adapter id used to bind instances: explicit `id`, else `type`. */
+function channelIdOf(ch) {
+    const id = ch.id ?? ch.type;
+    return typeof id === "string" && id ? id : undefined;
+}
+export function validateFleetConfig(config) {
+    const errors = [];
+    const warnings = [];
+    const err = (path, message) => errors.push({ path, message });
+    const warn = (path, message) => warnings.push({ path, message });
+    if (!isObj(config)) {
+        return { valid: false, errors: [{ path: "", message: "config must be a mapping" }], warnings: [] };
+    }
+    // ── Channels ──────────────────────────────────────────────
+    // `channels: []` (multi) takes precedence; the legacy singular `channel:` is
+    // used ONLY when `channels` is absent (matching fleet-manager's
+    // `channels ?? [channel]`). Counting both would double-count a shared id and
+    // wrongly flag a "duplicate channel id".
+    const channelList = [];
+    const usingChannels = Array.isArray(config.channels);
+    if (usingChannels) {
+        config.channels.forEach((ch, i) => {
+            if (!isObj(ch)) {
+                err(`channels[${i}]`, "must be a mapping");
+                return;
+            }
+            channelList.push(ch);
+        });
+        if (config.channel !== undefined)
+            warn("channel", "both `channel` (deprecated) and `channels` are set — `channel` is ignored");
+    }
+    else if (config.channels !== undefined) {
+        err("channels", "must be a list");
+    }
+    else if (isObj(config.channel)) {
+        channelList.push(config.channel);
+    }
+    else if (config.channel !== undefined) {
+        err("channel", "must be a mapping");
+    }
+    if (channelList.length === 0) {
+        warn("channels", "no channel configured — the fleet has no Telegram/Discord adapter");
+    }
+    const channelIds = new Set();
+    const multi = channelList.length > 1;
+    channelList.forEach((ch, i) => {
+        const at = Array.isArray(config.channels) && i < config.channels.length ? `channels[${i}]` : "channel";
+        if (typeof ch.type !== "string" || !ch.type)
+            err(`${at}.type`, "required (e.g. \"telegram\" or \"discord\")");
+        if (typeof ch.bot_token_env !== "string" || !ch.bot_token_env)
+            err(`${at}.bot_token_env`, "required — the env var holding the bot token");
+        // With multiple channels an explicit id is needed to disambiguate bindings.
+        if (multi && (ch.id === undefined || ch.id === null || ch.id === "")) {
+            warn(`${at}.id`, "multiple channels present — set a unique `id` so instances can bind to this adapter");
+        }
+        const cid = channelIdOf(ch);
+        if (cid) {
+            if (channelIds.has(cid))
+                err(`${at}.id`, `duplicate channel id "${cid}"`);
+            channelIds.add(cid);
+        }
+        if (isObj(ch.access) && ch.access.allowed_users !== undefined && !isIdArray(ch.access.allowed_users)) {
+            err(`${at}.access.allowed_users`, "must be an array of strings/numbers");
+        }
+    });
+    // ── Defaults ──────────────────────────────────────────────
+    if (config.defaults !== undefined && !isObj(config.defaults)) {
+        err("defaults", "must be a mapping");
+    }
+    else if (isObj(config.defaults)) {
+        const b = config.defaults.backend;
+        if (b !== undefined && (typeof b !== "string" || !KNOWN_BACKENDS.includes(b))) {
+            err("defaults.backend", `unknown backend "${String(b)}" (known: ${KNOWN_BACKENDS.join(", ")})`);
+        }
+    }
+    // ── Instances ─────────────────────────────────────────────
+    let generalCount = 0;
+    if (config.instances !== undefined && !isObj(config.instances)) {
+        err("instances", "must be a mapping");
+    }
+    else if (isObj(config.instances)) {
+        for (const [name, inst] of Object.entries(config.instances)) {
+            if (!isObj(inst)) {
+                err(`instances.${name}`, "must be a mapping");
+                continue;
+            }
+            if (inst.general_topic === true)
+                generalCount++;
+            // channel_id must reference a real channel id.
+            if (inst.channel_id !== undefined && inst.channel_id !== null && inst.channel_id !== "") {
+                const ref = String(inst.channel_id);
+                if (!channelIds.has(ref)) {
+                    err(`instances.${name}.channel_id`, `references unknown channel "${ref}" (known: ${[...channelIds].join(", ") || "none"})`);
+                }
+            }
+            const b = inst.backend;
+            if (b !== undefined && (typeof b !== "string" || !KNOWN_BACKENDS.includes(b))) {
+                err(`instances.${name}.backend`, `unknown backend "${String(b)}" (known: ${KNOWN_BACKENDS.join(", ")})`);
+            }
+            if (inst.working_directory !== undefined && typeof inst.working_directory !== "string") {
+                err(`instances.${name}.working_directory`, "must be a string path");
+            }
+        }
+    }
+    if (generalCount === 0) {
+        warn("instances", "no general_topic instance — there is no general dispatcher to receive un-topic'd messages");
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+export function validateClassicBotConfig(config) {
+    const errors = [];
+    const warnings = [];
+    const err = (path, message) => errors.push({ path, message });
+    // An empty / absent classicBot.yaml is valid (classic bot is optional).
+    if (config === null || config === undefined)
+        return { valid: true, errors, warnings };
+    if (!isObj(config)) {
+        return { valid: false, errors: [{ path: "", message: "config must be a mapping" }], warnings: [] };
+    }
+    if (config.defaults !== undefined && !isObj(config.defaults)) {
+        err("defaults", "must be a mapping");
+    }
+    else if (isObj(config.defaults)) {
+        const d = config.defaults;
+        const b = d.backend;
+        if (b !== undefined && (typeof b !== "string" || !KNOWN_BACKENDS.includes(b))) {
+            err("defaults.backend", `unknown backend "${String(b)}" (known: ${KNOWN_BACKENDS.join(", ")})`);
+        }
+        for (const key of ["allowed_guilds", "admin_users", "allowed_groups", "allowed_users"]) {
+            if (d[key] !== undefined && !isIdArray(d[key])) {
+                err(`defaults.${key}`, "must be an array of strings/numbers");
+            }
+        }
+    }
+    if (config.channels !== undefined && !isObj(config.channels)) {
+        err("channels", "must be a mapping (keyed by channelId or channelId#adapterId)");
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+//# sourceMappingURL=config-validator.js.map

package/dist/config-validator.js.map

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

package/dist/fleet-manager.d.ts

@@ -77,9 +77,25 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     loadConfig(configPath: string): FleetConfig;
     /** Build topic routing table: { topicId -> RouteTarget } */
     buildRoutingTable(): Map<string, RouteTarget>;
-    /** Re-register classic channels after routing rebuild (rebuild clears the table) */
+    /**
+     * Refresh each adapter's open-channel whitelist after a classic change.
+     * Classic channels are NOT registered in the routing engine (it's single-key
+     * per channel — can't represent two bots in one channel); routing resolves
+     * per-bot via ClassicChannelManager.getInstanceByChannel. Each adapter only
+     * opens the channels IT owns so a sibling bot doesn't process another's cross-
+     * guild channel.
+     */
     private reregisterClassicChannels;
     getInstanceDir(name: string): string;
+    /** AgEnD package version (for the Settings "current version" / What's New). */
+    get currentVersion(): string;
+    /**
+     * Resolve a slash-command target in a channel. Classic channels are looked up
+     * per-bot (same-channel multi-bot); a fleet-topic instance is found via the
+     * routing engine. Used by commands that work in BOTH contexts (/ctx, /compact,
+     * /cancel). Classic-only commands (/chat, /load) must NOT use this.
+     */
+    private resolveSlashTarget;
     /** Get the adapter bound to an instance, falling back to primary adapter */
     getAdapterForInstance(name: string): ChannelAdapter | null;
     /** Get the world for an instance */
@@ -171,12 +187,12 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     saveFleetConfig(): void;
     removeInstance(name: string): Promise<void>;
     startStatuslineWatcher(name: string): void;
-    reactMessageStatus(chatId: string, messageId: string, emoji: string): void;
+    reactMessageStatus(instanceName: string, chatId: string, messageId: string, emoji: string): void;
     private static FAILOVER_TRIGGER_PCT;
     private static FAILOVER_RECOVER_PCT;
     checkModelFailover(name: string, fiveHourPct: number): void;
     toggleFleetCollab(instanceName: string): boolean;
-    notifyInstanceTopic(instanceName: string, text: string): void;
+    notifyInstanceTopic(instanceName: string, text: string, extraOpts?: import("./channel/types.js").SendOpts): void;
     /** Send a "🛑 Cancel" button to the instance's topic/channel after delivery. */
     /**
      * Handle the DC `/save` slash command for both classic AND fleet-topic targets.
@@ -257,9 +273,9 @@ export declare class FleetManager implements FleetContext, LifecycleContext, Arc
     /** Start a classic channel instance with lightweight config */
     private startClassicInstance;
     /** Handle /start slash command — register classic channel */
-    handleClassicStart(channelId: string, channelName: string, userId: string, guildId?: string): Promise<string>;
+    handleClassicStart(channelId: string, channelName: string, userId: string, guildId?: string, adapterId?: string): Promise<string>;
     /** Handle /stop slash command — unregister classic channel */
-    handleClassicStop(channelId: string): Promise<string>;
+    handleClassicStop(channelId: string, adapterId?: string): Promise<string>;
     stopAll(): Promise<void>;
     /**
      * Prune stale external sessions by re-querying each daemon for live sessions.