@herdctl/core 0.0.1 → 0.1.0

package/dist/config/schema.d.ts

@@ -679,8 +679,13 @@ export declare const ScheduleSchema: z.ZodObject<{
         } | undefined;
         cleanup_in_progress?: boolean | undefined;
     }>]>>;
+    /** When true, job output is also written to .herdctl/jobs/{jobId}/output.log (default: false) */
+    outputToFile: z.ZodOptional<z.ZodBoolean>;
+    /** When false, schedule will not auto-trigger but can still be manually triggered (default: true) */
+    enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 }, "strip", z.ZodTypeAny, {
     type: "interval" | "cron" | "webhook" | "chat";
+    enabled: boolean;
     work_source?: {
         type: "github";
         repo: string;
@@ -705,8 +710,10 @@ export declare const ScheduleSchema: z.ZodObject<{
     interval?: string | undefined;
     expression?: string | undefined;
     prompt?: string | undefined;
+    outputToFile?: boolean | undefined;
 }, {
     type: "interval" | "cron" | "webhook" | "chat";
+    enabled?: boolean | undefined;
     work_source?: {
         type: "github";
         repo: string;
@@ -731,6 +738,7 @@ export declare const ScheduleSchema: z.ZodObject<{
     interval?: string | undefined;
     expression?: string | undefined;
     prompt?: string | undefined;
+    outputToFile?: boolean | undefined;
 }>;
 export declare const McpServerSchema: z.ZodObject<{
     command: z.ZodOptional<z.ZodString>;
@@ -748,26 +756,563 @@ export declare const McpServerSchema: z.ZodObject<{
     url?: string | undefined;
     env?: Record<string, string> | undefined;
 }>;
+/**
+ * Discord bot presence/activity configuration
+ *
+ * @example
+ * ```yaml
+ * presence:
+ *   activity_type: watching
+ *   activity_message: "for support requests"
+ * ```
+ */
+export declare const DiscordPresenceSchema: z.ZodObject<{
+    activity_type: z.ZodOptional<z.ZodEnum<["playing", "watching", "listening", "competing"]>>;
+    activity_message: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    activity_type?: "playing" | "watching" | "listening" | "competing" | undefined;
+    activity_message?: string | undefined;
+}, {
+    activity_type?: "playing" | "watching" | "listening" | "competing" | undefined;
+    activity_message?: string | undefined;
+}>;
+/**
+ * Discord DM (direct message) configuration for an agent's bot
+ *
+ * @example
+ * ```yaml
+ * dm:
+ *   enabled: true
+ *   mode: auto
+ *   allowlist: ["123456789012345678"]
+ *   blocklist: []
+ * ```
+ */
+export declare const DiscordDMSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    mode: z.ZodDefault<z.ZodEnum<["mention", "auto"]>>;
+    allowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    blocklist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    mode: "mention" | "auto";
+    enabled: boolean;
+    allowlist?: string[] | undefined;
+    blocklist?: string[] | undefined;
+}, {
+    mode?: "mention" | "auto" | undefined;
+    enabled?: boolean | undefined;
+    allowlist?: string[] | undefined;
+    blocklist?: string[] | undefined;
+}>;
+/**
+ * Discord channel configuration for an agent's bot
+ *
+ * @example
+ * ```yaml
+ * channels:
+ *   - id: "987654321098765432"
+ *     name: "#support"
+ *     mode: mention
+ *     context_messages: 10
+ * ```
+ */
+export declare const DiscordChannelSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    mode: z.ZodDefault<z.ZodEnum<["mention", "auto"]>>;
+    context_messages: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    mode: "mention" | "auto";
+    id: string;
+    context_messages: number;
+    name?: string | undefined;
+}, {
+    id: string;
+    mode?: "mention" | "auto" | undefined;
+    name?: string | undefined;
+    context_messages?: number | undefined;
+}>;
+/**
+ * Discord guild (server) configuration for an agent's bot
+ *
+ * @example
+ * ```yaml
+ * guilds:
+ *   - id: "123456789012345678"
+ *     channels:
+ *       - id: "987654321098765432"
+ *         name: "#support"
+ *         mode: mention
+ *     dm:
+ *       enabled: true
+ *       mode: auto
+ * ```
+ */
+export declare const DiscordGuildSchema: z.ZodObject<{
+    id: z.ZodString;
+    channels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        mode: z.ZodDefault<z.ZodEnum<["mention", "auto"]>>;
+        context_messages: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "mention" | "auto";
+        id: string;
+        context_messages: number;
+        name?: string | undefined;
+    }, {
+        id: string;
+        mode?: "mention" | "auto" | undefined;
+        name?: string | undefined;
+        context_messages?: number | undefined;
+    }>, "many">>;
+    dm: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        mode: z.ZodDefault<z.ZodEnum<["mention", "auto"]>>;
+        allowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        blocklist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "mention" | "auto";
+        enabled: boolean;
+        allowlist?: string[] | undefined;
+        blocklist?: string[] | undefined;
+    }, {
+        mode?: "mention" | "auto" | undefined;
+        enabled?: boolean | undefined;
+        allowlist?: string[] | undefined;
+        blocklist?: string[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    channels?: {
+        mode: "mention" | "auto";
+        id: string;
+        context_messages: number;
+        name?: string | undefined;
+    }[] | undefined;
+    dm?: {
+        mode: "mention" | "auto";
+        enabled: boolean;
+        allowlist?: string[] | undefined;
+        blocklist?: string[] | undefined;
+    } | undefined;
+}, {
+    id: string;
+    channels?: {
+        id: string;
+        mode?: "mention" | "auto" | undefined;
+        name?: string | undefined;
+        context_messages?: number | undefined;
+    }[] | undefined;
+    dm?: {
+        mode?: "mention" | "auto" | undefined;
+        enabled?: boolean | undefined;
+        allowlist?: string[] | undefined;
+        blocklist?: string[] | undefined;
+    } | undefined;
+}>;
+/**
+ * Per-agent Discord bot configuration schema
+ *
+ * Each agent can have its own Discord bot with independent identity,
+ * presence, and channel/guild configuration.
+ *
+ * @example
+ * ```yaml
+ * chat:
+ *   discord:
+ *     bot_token_env: SUPPORT_DISCORD_TOKEN
+ *     session_expiry_hours: 24
+ *     log_level: standard
+ *     presence:
+ *       activity_type: watching
+ *       activity_message: "for support requests"
+ *     guilds:
+ *       - id: "123456789012345678"
+ *         channels:
+ *           - id: "987654321098765432"
+ *             name: "#support"
+ *             mode: mention
+ * ```
+ */
+export declare const AgentChatDiscordSchema: z.ZodObject<{
+    /** Environment variable name containing the bot token (never store tokens in config) */
+    bot_token_env: z.ZodString;
+    /** Session expiry in hours (default: 24) */
+    session_expiry_hours: z.ZodDefault<z.ZodNumber>;
+    /** Log level for this agent's Discord connector */
+    log_level: z.ZodDefault<z.ZodEnum<["minimal", "standard", "verbose"]>>;
+    /** Bot presence/activity configuration */
+    presence: z.ZodOptional<z.ZodObject<{
+        activity_type: z.ZodOptional<z.ZodEnum<["playing", "watching", "listening", "competing"]>>;
+        activity_message: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        activity_type?: "playing" | "watching" | "listening" | "competing" | undefined;
+        activity_message?: string | undefined;
+    }, {
+        activity_type?: "playing" | "watching" | "listening" | "competing" | undefined;
+        activity_message?: string | undefined;
+    }>>;
+    /** Guilds (servers) this bot participates in */
+    guilds: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        channels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            mode: z.ZodDefault<z.ZodEnum<["mention", "auto"]>>;
+            context_messages: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            mode: "mention" | "auto";
+            id: string;
+            context_messages: number;
+            name?: string | undefined;
+        }, {
+            id: string;
+            mode?: "mention" | "auto" | undefined;
+            name?: string | undefined;
+            context_messages?: number | undefined;
+        }>, "many">>;
+        dm: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            mode: z.ZodDefault<z.ZodEnum<["mention", "auto"]>>;
+            allowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            blocklist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            mode: "mention" | "auto";
+            enabled: boolean;
+            allowlist?: string[] | undefined;
+            blocklist?: string[] | undefined;
+        }, {
+            mode?: "mention" | "auto" | undefined;
+            enabled?: boolean | undefined;
+            allowlist?: string[] | undefined;
+            blocklist?: string[] | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        channels?: {
+            mode: "mention" | "auto";
+            id: string;
+            context_messages: number;
+            name?: string | undefined;
+        }[] | undefined;
+        dm?: {
+            mode: "mention" | "auto";
+            enabled: boolean;
+            allowlist?: string[] | undefined;
+            blocklist?: string[] | undefined;
+        } | undefined;
+    }, {
+        id: string;
+        channels?: {
+            id: string;
+            mode?: "mention" | "auto" | undefined;
+            name?: string | undefined;
+            context_messages?: number | undefined;
+        }[] | undefined;
+        dm?: {
+            mode?: "mention" | "auto" | undefined;
+            enabled?: boolean | undefined;
+            allowlist?: string[] | undefined;
+            blocklist?: string[] | undefined;
+        } | undefined;
+    }>, "many">;
+    /** Global DM (direct message) configuration - applies to all DMs regardless of guild */
+    dm: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        mode: z.ZodDefault<z.ZodEnum<["mention", "auto"]>>;
+        allowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        blocklist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "mention" | "auto";
+        enabled: boolean;
+        allowlist?: string[] | undefined;
+        blocklist?: string[] | undefined;
+    }, {
+        mode?: "mention" | "auto" | undefined;
+        enabled?: boolean | undefined;
+        allowlist?: string[] | undefined;
+        blocklist?: string[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    bot_token_env: string;
+    session_expiry_hours: number;
+    log_level: "minimal" | "standard" | "verbose";
+    guilds: {
+        id: string;
+        channels?: {
+            mode: "mention" | "auto";
+            id: string;
+            context_messages: number;
+            name?: string | undefined;
+        }[] | undefined;
+        dm?: {
+            mode: "mention" | "auto";
+            enabled: boolean;
+            allowlist?: string[] | undefined;
+            blocklist?: string[] | undefined;
+        } | undefined;
+    }[];
+    dm?: {
+        mode: "mention" | "auto";
+        enabled: boolean;
+        allowlist?: string[] | undefined;
+        blocklist?: string[] | undefined;
+    } | undefined;
+    presence?: {
+        activity_type?: "playing" | "watching" | "listening" | "competing" | undefined;
+        activity_message?: string | undefined;
+    } | undefined;
+}, {
+    bot_token_env: string;
+    guilds: {
+        id: string;
+        channels?: {
+            id: string;
+            mode?: "mention" | "auto" | undefined;
+            name?: string | undefined;
+            context_messages?: number | undefined;
+        }[] | undefined;
+        dm?: {
+            mode?: "mention" | "auto" | undefined;
+            enabled?: boolean | undefined;
+            allowlist?: string[] | undefined;
+            blocklist?: string[] | undefined;
+        } | undefined;
+    }[];
+    dm?: {
+        mode?: "mention" | "auto" | undefined;
+        enabled?: boolean | undefined;
+        allowlist?: string[] | undefined;
+        blocklist?: string[] | undefined;
+    } | undefined;
+    session_expiry_hours?: number | undefined;
+    log_level?: "minimal" | "standard" | "verbose" | undefined;
+    presence?: {
+        activity_type?: "playing" | "watching" | "listening" | "competing" | undefined;
+        activity_message?: string | undefined;
+    } | undefined;
+}>;
 export declare const AgentChatSchema: z.ZodObject<{
     discord: z.ZodOptional<z.ZodObject<{
-        channel_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-        respond_to_mentions: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** Environment variable name containing the bot token (never store tokens in config) */
+        bot_token_env: z.ZodString;
+        /** Session expiry in hours (default: 24) */
+        session_expiry_hours: z.ZodDefault<z.ZodNumber>;
+        /** Log level for this agent's Discord connector */
+        log_level: z.ZodDefault<z.ZodEnum<["minimal", "standard", "verbose"]>>;
+        /** Bot presence/activity configuration */
+        presence: z.ZodOptional<z.ZodObject<{
+            activity_type: z.ZodOptional<z.ZodEnum<["playing", "watching", "listening", "competing"]>>;
+            activity_message: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            activity_type?: "playing" | "watching" | "listening" | "competing" | undefined;
+            activity_message?: string | undefined;
+        }, {
+            activity_type?: "playing" | "watching" | "listening" | "competing" | undefined;
+            activity_message?: string | undefined;
+        }>>;
+        /** Guilds (servers) this bot participates in */
+        guilds: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            channels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodOptional<z.ZodString>;
+                mode: z.ZodDefault<z.ZodEnum<["mention", "auto"]>>;
+                context_messages: z.ZodDefault<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                mode: "mention" | "auto";
+                id: string;
+                context_messages: number;
+                name?: string | undefined;
+            }, {
+                id: string;
+                mode?: "mention" | "auto" | undefined;
+                name?: string | undefined;
+                context_messages?: number | undefined;
+            }>, "many">>;
+            dm: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                mode: z.ZodDefault<z.ZodEnum<["mention", "auto"]>>;
+                allowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                blocklist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                mode: "mention" | "auto";
+                enabled: boolean;
+                allowlist?: string[] | undefined;
+                blocklist?: string[] | undefined;
+            }, {
+                mode?: "mention" | "auto" | undefined;
+                enabled?: boolean | undefined;
+                allowlist?: string[] | undefined;
+                blocklist?: string[] | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            channels?: {
+                mode: "mention" | "auto";
+                id: string;
+                context_messages: number;
+                name?: string | undefined;
+            }[] | undefined;
+            dm?: {
+                mode: "mention" | "auto";
+                enabled: boolean;
+                allowlist?: string[] | undefined;
+                blocklist?: string[] | undefined;
+            } | undefined;
+        }, {
+            id: string;
+            channels?: {
+                id: string;
+                mode?: "mention" | "auto" | undefined;
+                name?: string | undefined;
+                context_messages?: number | undefined;
+            }[] | undefined;
+            dm?: {
+                mode?: "mention" | "auto" | undefined;
+                enabled?: boolean | undefined;
+                allowlist?: string[] | undefined;
+                blocklist?: string[] | undefined;
+            } | undefined;
+        }>, "many">;
+        /** Global DM (direct message) configuration - applies to all DMs regardless of guild */
+        dm: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodDefault<z.ZodBoolean>;
+            mode: z.ZodDefault<z.ZodEnum<["mention", "auto"]>>;
+            allowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            blocklist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            mode: "mention" | "auto";
+            enabled: boolean;
+            allowlist?: string[] | undefined;
+            blocklist?: string[] | undefined;
+        }, {
+            mode?: "mention" | "auto" | undefined;
+            enabled?: boolean | undefined;
+            allowlist?: string[] | undefined;
+            blocklist?: string[] | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
-        respond_to_mentions: boolean;
-        channel_ids?: string[] | undefined;
+        bot_token_env: string;
+        session_expiry_hours: number;
+        log_level: "minimal" | "standard" | "verbose";
+        guilds: {
+            id: string;
+            channels?: {
+                mode: "mention" | "auto";
+                id: string;
+                context_messages: number;
+                name?: string | undefined;
+            }[] | undefined;
+            dm?: {
+                mode: "mention" | "auto";
+                enabled: boolean;
+                allowlist?: string[] | undefined;
+                blocklist?: string[] | undefined;
+            } | undefined;
+        }[];
+        dm?: {
+            mode: "mention" | "auto";
+            enabled: boolean;
+            allowlist?: string[] | undefined;
+            blocklist?: string[] | undefined;
+        } | undefined;
+        presence?: {
+            activity_type?: "playing" | "watching" | "listening" | "competing" | undefined;
+            activity_message?: string | undefined;
+        } | undefined;
     }, {
-        channel_ids?: string[] | undefined;
-        respond_to_mentions?: boolean | undefined;
+        bot_token_env: string;
+        guilds: {
+            id: string;
+            channels?: {
+                id: string;
+                mode?: "mention" | "auto" | undefined;
+                name?: string | undefined;
+                context_messages?: number | undefined;
+            }[] | undefined;
+            dm?: {
+                mode?: "mention" | "auto" | undefined;
+                enabled?: boolean | undefined;
+                allowlist?: string[] | undefined;
+                blocklist?: string[] | undefined;
+            } | undefined;
+        }[];
+        dm?: {
+            mode?: "mention" | "auto" | undefined;
+            enabled?: boolean | undefined;
+            allowlist?: string[] | undefined;
+            blocklist?: string[] | undefined;
+        } | undefined;
+        session_expiry_hours?: number | undefined;
+        log_level?: "minimal" | "standard" | "verbose" | undefined;
+        presence?: {
+            activity_type?: "playing" | "watching" | "listening" | "competing" | undefined;
+            activity_message?: string | undefined;
+        } | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     discord?: {
-        respond_to_mentions: boolean;
-        channel_ids?: string[] | undefined;
+        bot_token_env: string;
+        session_expiry_hours: number;
+        log_level: "minimal" | "standard" | "verbose";
+        guilds: {
+            id: string;
+            channels?: {
+                mode: "mention" | "auto";
+                id: string;
+                context_messages: number;
+                name?: string | undefined;
+            }[] | undefined;
+            dm?: {
+                mode: "mention" | "auto";
+                enabled: boolean;
+                allowlist?: string[] | undefined;
+                blocklist?: string[] | undefined;
+            } | undefined;
+        }[];
+        dm?: {
+            mode: "mention" | "auto";
+            enabled: boolean;
+            allowlist?: string[] | undefined;
+            blocklist?: string[] | undefined;
+        } | undefined;
+        presence?: {
+            activity_type?: "playing" | "watching" | "listening" | "competing" | undefined;
+            activity_message?: string | undefined;
+        } | undefined;
     } | undefined;
 }, {
     discord?: {
-        channel_ids?: string[] | undefined;
-        respond_to_mentions?: boolean | undefined;
+        bot_token_env: string;
+        guilds: {
+            id: string;
+            channels?: {
+                id: string;
+                mode?: "mention" | "auto" | undefined;
+                name?: string | undefined;
+                context_messages?: number | undefined;
+            }[] | undefined;
+            dm?: {
+                mode?: "mention" | "auto" | undefined;
+                enabled?: boolean | undefined;
+                allowlist?: string[] | undefined;
+                blocklist?: string[] | undefined;
+            } | undefined;
+        }[];
+        dm?: {
+            mode?: "mention" | "auto" | undefined;
+            enabled?: boolean | undefined;
+            allowlist?: string[] | undefined;
+            blocklist?: string[] | undefined;
+        } | undefined;
+        session_expiry_hours?: number | undefined;
+        log_level?: "minimal" | "standard" | "verbose" | undefined;
+        presence?: {
+            activity_type?: "playing" | "watching" | "listening" | "competing" | undefined;
+            activity_message?: string | undefined;
+        } | undefined;
     } | undefined;
 }>;
 export declare const AgentWorkspaceSchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
@@ -997,8 +1542,13 @@ export declare const AgentConfigSchema: z.ZodObject<{
             } | undefined;
             cleanup_in_progress?: boolean | undefined;
         }>]>>;
+        /** When true, job output is also written to .herdctl/jobs/{jobId}/output.log (default: false) */
+        outputToFile: z.ZodOptional<z.ZodBoolean>;
+        /** When false, schedule will not auto-trigger but can still be manually triggered (default: true) */
+        enabled: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     }, "strip", z.ZodTypeAny, {
         type: "interval" | "cron" | "webhook" | "chat";
+        enabled: boolean;
         work_source?: {
             type: "github";
             repo: string;
@@ -1023,8 +1573,10 @@ export declare const AgentConfigSchema: z.ZodObject<{
         interval?: string | undefined;
         expression?: string | undefined;
         prompt?: string | undefined;
+        outputToFile?: boolean | undefined;
     }, {
         type: "interval" | "cron" | "webhook" | "chat";
+        enabled?: boolean | undefined;
         work_source?: {
             type: "github";
             repo: string;
@@ -1049,6 +1601,7 @@ export declare const AgentConfigSchema: z.ZodObject<{
         interval?: string | undefined;
         expression?: string | undefined;
         prompt?: string | undefined;
+        outputToFile?: boolean | undefined;
     }>>>;
     session: z.ZodOptional<z.ZodObject<{
         max_turns: z.ZodOptional<z.ZodNumber>;
@@ -1112,24 +1665,224 @@ export declare const AgentConfigSchema: z.ZodObject<{
     }>>>;
     chat: z.ZodOptional<z.ZodObject<{
         discord: z.ZodOptional<z.ZodObject<{
-            channel_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-            respond_to_mentions: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            /** Environment variable name containing the bot token (never store tokens in config) */
+            bot_token_env: z.ZodString;
+            /** Session expiry in hours (default: 24) */
+            session_expiry_hours: z.ZodDefault<z.ZodNumber>;
+            /** Log level for this agent's Discord connector */
+            log_level: z.ZodDefault<z.ZodEnum<["minimal", "standard", "verbose"]>>;
+            /** Bot presence/activity configuration */
+            presence: z.ZodOptional<z.ZodObject<{
+                activity_type: z.ZodOptional<z.ZodEnum<["playing", "watching", "listening", "competing"]>>;
+                activity_message: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                activity_type?: "playing" | "watching" | "listening" | "competing" | undefined;
+                activity_message?: string | undefined;
+            }, {
+                activity_type?: "playing" | "watching" | "listening" | "competing" | undefined;
+                activity_message?: string | undefined;
+            }>>;
+            /** Guilds (servers) this bot participates in */
+            guilds: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                channels: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    name: z.ZodOptional<z.ZodString>;
+                    mode: z.ZodDefault<z.ZodEnum<["mention", "auto"]>>;
+                    context_messages: z.ZodDefault<z.ZodNumber>;
+                }, "strip", z.ZodTypeAny, {
+                    mode: "mention" | "auto";
+                    id: string;
+                    context_messages: number;
+                    name?: string | undefined;
+                }, {
+                    id: string;
+                    mode?: "mention" | "auto" | undefined;
+                    name?: string | undefined;
+                    context_messages?: number | undefined;
+                }>, "many">>;
+                dm: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodDefault<z.ZodBoolean>;
+                    mode: z.ZodDefault<z.ZodEnum<["mention", "auto"]>>;
+                    allowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                    blocklist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                }, "strip", z.ZodTypeAny, {
+                    mode: "mention" | "auto";
+                    enabled: boolean;
+                    allowlist?: string[] | undefined;
+                    blocklist?: string[] | undefined;
+                }, {
+                    mode?: "mention" | "auto" | undefined;
+                    enabled?: boolean | undefined;
+                    allowlist?: string[] | undefined;
+                    blocklist?: string[] | undefined;
+                }>>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                channels?: {
+                    mode: "mention" | "auto";
+                    id: string;
+                    context_messages: number;
+                    name?: string | undefined;
+                }[] | undefined;
+                dm?: {
+                    mode: "mention" | "auto";
+                    enabled: boolean;
+                    allowlist?: string[] | undefined;
+                    blocklist?: string[] | undefined;
+                } | undefined;
+            }, {
+                id: string;
+                channels?: {
+                    id: string;
+                    mode?: "mention" | "auto" | undefined;
+                    name?: string | undefined;
+                    context_messages?: number | undefined;
+                }[] | undefined;
+                dm?: {
+                    mode?: "mention" | "auto" | undefined;
+                    enabled?: boolean | undefined;
+                    allowlist?: string[] | undefined;
+                    blocklist?: string[] | undefined;
+                } | undefined;
+            }>, "many">;
+            /** Global DM (direct message) configuration - applies to all DMs regardless of guild */
+            dm: z.ZodOptional<z.ZodObject<{
+                enabled: z.ZodDefault<z.ZodBoolean>;
+                mode: z.ZodDefault<z.ZodEnum<["mention", "auto"]>>;
+                allowlist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                blocklist: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                mode: "mention" | "auto";
+                enabled: boolean;
+                allowlist?: string[] | undefined;
+                blocklist?: string[] | undefined;
+            }, {
+                mode?: "mention" | "auto" | undefined;
+                enabled?: boolean | undefined;
+                allowlist?: string[] | undefined;
+                blocklist?: string[] | undefined;
+            }>>;
         }, "strip", z.ZodTypeAny, {
-            respond_to_mentions: boolean;
-            channel_ids?: string[] | undefined;
+            bot_token_env: string;
+            session_expiry_hours: number;
+            log_level: "minimal" | "standard" | "verbose";
+            guilds: {
+                id: string;
+                channels?: {
+                    mode: "mention" | "auto";
+                    id: string;
+                    context_messages: number;
+                    name?: string | undefined;
+                }[] | undefined;
+                dm?: {
+                    mode: "mention" | "auto";
+                    enabled: boolean;
+                    allowlist?: string[] | undefined;
+                    blocklist?: string[] | undefined;
+                } | undefined;
+            }[];
+            dm?: {
+                mode: "mention" | "auto";
+                enabled: boolean;
+                allowlist?: string[] | undefined;
+                blocklist?: string[] | undefined;
+            } | undefined;
+            presence?: {
+                activity_type?: "playing" | "watching" | "listening" | "competing" | undefined;
+                activity_message?: string | undefined;
+            } | undefined;
         }, {
-            channel_ids?: string[] | undefined;
-            respond_to_mentions?: boolean | undefined;
+            bot_token_env: string;
+            guilds: {
+                id: string;
+                channels?: {
+                    id: string;
+                    mode?: "mention" | "auto" | undefined;
+                    name?: string | undefined;
+                    context_messages?: number | undefined;
+                }[] | undefined;
+                dm?: {
+                    mode?: "mention" | "auto" | undefined;
+                    enabled?: boolean | undefined;
+                    allowlist?: string[] | undefined;
+                    blocklist?: string[] | undefined;
+                } | undefined;
+            }[];
+            dm?: {
+                mode?: "mention" | "auto" | undefined;
+                enabled?: boolean | undefined;
+                allowlist?: string[] | undefined;
+                blocklist?: string[] | undefined;
+            } | undefined;
+            session_expiry_hours?: number | undefined;
+            log_level?: "minimal" | "standard" | "verbose" | undefined;
+            presence?: {
+                activity_type?: "playing" | "watching" | "listening" | "competing" | undefined;
+                activity_message?: string | undefined;
+            } | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
         discord?: {
-            respond_to_mentions: boolean;
-            channel_ids?: string[] | undefined;
+            bot_token_env: string;
+            session_expiry_hours: number;
+            log_level: "minimal" | "standard" | "verbose";
+            guilds: {
+                id: string;
+                channels?: {
+                    mode: "mention" | "auto";
+                    id: string;
+                    context_messages: number;
+                    name?: string | undefined;
+                }[] | undefined;
+                dm?: {
+                    mode: "mention" | "auto";
+                    enabled: boolean;
+                    allowlist?: string[] | undefined;
+                    blocklist?: string[] | undefined;
+                } | undefined;
+            }[];
+            dm?: {
+                mode: "mention" | "auto";
+                enabled: boolean;
+                allowlist?: string[] | undefined;
+                blocklist?: string[] | undefined;
+            } | undefined;
+            presence?: {
+                activity_type?: "playing" | "watching" | "listening" | "competing" | undefined;
+                activity_message?: string | undefined;
+            } | undefined;
         } | undefined;
     }, {
         discord?: {
-            channel_ids?: string[] | undefined;
-            respond_to_mentions?: boolean | undefined;
+            bot_token_env: string;
+            guilds: {
+                id: string;
+                channels?: {
+                    id: string;
+                    mode?: "mention" | "auto" | undefined;
+                    name?: string | undefined;
+                    context_messages?: number | undefined;
+                }[] | undefined;
+                dm?: {
+                    mode?: "mention" | "auto" | undefined;
+                    enabled?: boolean | undefined;
+                    allowlist?: string[] | undefined;
+                    blocklist?: string[] | undefined;
+                } | undefined;
+            }[];
+            dm?: {
+                mode?: "mention" | "auto" | undefined;
+                enabled?: boolean | undefined;
+                allowlist?: string[] | undefined;
+                blocklist?: string[] | undefined;
+            } | undefined;
+            session_expiry_hours?: number | undefined;
+            log_level?: "minimal" | "standard" | "verbose" | undefined;
+            presence?: {
+                activity_type?: "playing" | "watching" | "listening" | "competing" | undefined;
+                activity_message?: string | undefined;
+            } | undefined;
         } | undefined;
     }>>;
     docker: z.ZodOptional<z.ZodObject<{
@@ -1152,7 +1905,7 @@ export declare const AgentConfigSchema: z.ZodObject<{
     model: z.ZodOptional<z.ZodString>;
     max_turns: z.ZodOptional<z.ZodNumber>;
     permission_mode: z.ZodOptional<z.ZodEnum<["default", "acceptEdits", "bypassPermissions", "plan"]>>;
-}, "strip", z.ZodTypeAny, {
+}, "strict", z.ZodTypeAny, {
     name: string;
     repo?: string | undefined;
     max_turns?: number | undefined;
@@ -1202,8 +1955,34 @@ export declare const AgentConfigSchema: z.ZodObject<{
     permission_mode?: "default" | "acceptEdits" | "bypassPermissions" | "plan" | undefined;
     chat?: {
         discord?: {
-            respond_to_mentions: boolean;
-            channel_ids?: string[] | undefined;
+            bot_token_env: string;
+            session_expiry_hours: number;
+            log_level: "minimal" | "standard" | "verbose";
+            guilds: {
+                id: string;
+                channels?: {
+                    mode: "mention" | "auto";
+                    id: string;
+                    context_messages: number;
+                    name?: string | undefined;
+                }[] | undefined;
+                dm?: {
+                    mode: "mention" | "auto";
+                    enabled: boolean;
+                    allowlist?: string[] | undefined;
+                    blocklist?: string[] | undefined;
+                } | undefined;
+            }[];
+            dm?: {
+                mode: "mention" | "auto";
+                enabled: boolean;
+                allowlist?: string[] | undefined;
+                blocklist?: string[] | undefined;
+            } | undefined;
+            presence?: {
+                activity_type?: "playing" | "watching" | "listening" | "competing" | undefined;
+                activity_message?: string | undefined;
+            } | undefined;
         } | undefined;
     } | undefined;
     description?: string | undefined;
@@ -1221,6 +2000,7 @@ export declare const AgentConfigSchema: z.ZodObject<{
     system_prompt?: string | undefined;
     schedules?: Record<string, {
         type: "interval" | "cron" | "webhook" | "chat";
+        enabled: boolean;
         work_source?: {
             type: "github";
             repo: string;
@@ -1245,6 +2025,7 @@ export declare const AgentConfigSchema: z.ZodObject<{
         interval?: string | undefined;
         expression?: string | undefined;
         prompt?: string | undefined;
+        outputToFile?: boolean | undefined;
     }> | undefined;
     mcp_servers?: Record<string, {
         command?: string | undefined;
@@ -1302,8 +2083,34 @@ export declare const AgentConfigSchema: z.ZodObject<{
     permission_mode?: "default" | "acceptEdits" | "bypassPermissions" | "plan" | undefined;
     chat?: {
         discord?: {
-            channel_ids?: string[] | undefined;
-            respond_to_mentions?: boolean | undefined;
+            bot_token_env: string;
+            guilds: {
+                id: string;
+                channels?: {
+                    id: string;
+                    mode?: "mention" | "auto" | undefined;
+                    name?: string | undefined;
+                    context_messages?: number | undefined;
+                }[] | undefined;
+                dm?: {
+                    mode?: "mention" | "auto" | undefined;
+                    enabled?: boolean | undefined;
+                    allowlist?: string[] | undefined;
+                    blocklist?: string[] | undefined;
+                } | undefined;
+            }[];
+            dm?: {
+                mode?: "mention" | "auto" | undefined;
+                enabled?: boolean | undefined;
+                allowlist?: string[] | undefined;
+                blocklist?: string[] | undefined;
+            } | undefined;
+            session_expiry_hours?: number | undefined;
+            log_level?: "minimal" | "standard" | "verbose" | undefined;
+            presence?: {
+                activity_type?: "playing" | "watching" | "listening" | "competing" | undefined;
+                activity_message?: string | undefined;
+            } | undefined;
         } | undefined;
     } | undefined;
     description?: string | undefined;
@@ -1321,6 +2128,7 @@ export declare const AgentConfigSchema: z.ZodObject<{
     system_prompt?: string | undefined;
     schedules?: Record<string, {
         type: "interval" | "cron" | "webhook" | "chat";
+        enabled?: boolean | undefined;
         work_source?: {
             type: "github";
             repo: string;
@@ -1345,6 +2153,7 @@ export declare const AgentConfigSchema: z.ZodObject<{
         interval?: string | undefined;
         expression?: string | undefined;
         prompt?: string | undefined;
+        outputToFile?: boolean | undefined;
     }> | undefined;
     mcp_servers?: Record<string, {
         command?: string | undefined;
@@ -1403,7 +2212,7 @@ export declare const FleetConfigSchema: z.ZodObject<{
     fleet: z.ZodOptional<z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         description: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
+    }, "strict", z.ZodTypeAny, {
         name?: string | undefined;
         description?: string | undefined;
     }, {
@@ -1722,7 +2531,7 @@ export declare const FleetConfigSchema: z.ZodObject<{
         enabled?: boolean | undefined;
         base_image?: string | undefined;
     }>>;
-}, "strip", z.ZodTypeAny, {
+}, "strict", z.ZodTypeAny, {
     version: number;
     agents: {
         path: string;
@@ -1900,6 +2709,11 @@ export type Session = z.infer<typeof SessionSchema>;
 export type ScheduleType = z.infer<typeof ScheduleTypeSchema>;
 export type Schedule = z.infer<typeof ScheduleSchema>;
 export type McpServer = z.infer<typeof McpServerSchema>;
+export type DiscordPresence = z.infer<typeof DiscordPresenceSchema>;
+export type DiscordDM = z.infer<typeof DiscordDMSchema>;
+export type DiscordChannel = z.infer<typeof DiscordChannelSchema>;
+export type DiscordGuild = z.infer<typeof DiscordGuildSchema>;
+export type AgentChatDiscord = z.infer<typeof AgentChatDiscordSchema>;
 export type AgentChat = z.infer<typeof AgentChatSchema>;
 export type AgentWorkspace = z.infer<typeof AgentWorkspaceSchema>;
 export type AgentConfig = z.infer<typeof AgentConfigSchema>;