@herdctl/core 3.0.2 → 4.1.0

package/dist/config/schema.d.ts

@@ -1883,6 +1883,43 @@ export declare const DiscordGuildSchema: z.ZodObject<{
         blocklist?: string[] | undefined;
     } | undefined;
 }>;
+/**
+ * Discord output configuration for controlling what gets shown during conversations
+ *
+ * @example
+ * ```yaml
+ * output:
+ *   tool_results: true
+ *   tool_result_max_length: 900
+ *   system_status: true
+ *   result_summary: false
+ *   errors: true
+ * ```
+ */
+export declare const DiscordOutputSchema: z.ZodObject<{
+    /** Show tool results as embeds (default: true) */
+    tool_results: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /** Max chars of tool output to include in embeds (default: 900, max: 1000) */
+    tool_result_max_length: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    /** Show system status messages like "compacting context..." (default: true) */
+    system_status: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /** Show a summary embed when the agent finishes a turn (cost, tokens, turns) (default: false) */
+    result_summary: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /** Show error messages from the SDK (default: true) */
+    errors: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    tool_results: boolean;
+    tool_result_max_length: number;
+    system_status: boolean;
+    result_summary: boolean;
+    errors: boolean;
+}, {
+    tool_results?: boolean | undefined;
+    tool_result_max_length?: number | undefined;
+    system_status?: boolean | undefined;
+    result_summary?: boolean | undefined;
+    errors?: boolean | undefined;
+}>;
 /**
  * Per-agent Discord bot configuration schema
  *
@@ -1896,6 +1933,12 @@ export declare const DiscordGuildSchema: z.ZodObject<{
  *     bot_token_env: SUPPORT_DISCORD_TOKEN
  *     session_expiry_hours: 24
  *     log_level: standard
+ *     output:
+ *       tool_results: true
+ *       tool_result_max_length: 900
+ *       system_status: true
+ *       result_summary: false
+ *       errors: true
  *     presence:
  *       activity_type: watching
  *       activity_message: "for support requests"
@@ -1914,6 +1957,31 @@ export declare const AgentChatDiscordSchema: z.ZodObject<{
     session_expiry_hours: z.ZodDefault<z.ZodNumber>;
     /** Log level for this agent's Discord connector */
     log_level: z.ZodDefault<z.ZodEnum<["minimal", "standard", "verbose"]>>;
+    /** Output configuration for controlling what gets shown during conversations */
+    output: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        /** Show tool results as embeds (default: true) */
+        tool_results: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** Max chars of tool output to include in embeds (default: 900, max: 1000) */
+        tool_result_max_length: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        /** Show system status messages like "compacting context..." (default: true) */
+        system_status: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** Show a summary embed when the agent finishes a turn (cost, tokens, turns) (default: false) */
+        result_summary: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** Show error messages from the SDK (default: true) */
+        errors: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    }, "strip", z.ZodTypeAny, {
+        tool_results: boolean;
+        tool_result_max_length: number;
+        system_status: boolean;
+        result_summary: boolean;
+        errors: boolean;
+    }, {
+        tool_results?: boolean | undefined;
+        tool_result_max_length?: number | undefined;
+        system_status?: boolean | undefined;
+        result_summary?: boolean | undefined;
+        errors?: boolean | undefined;
+    }>>>;
     /** Bot presence/activity configuration */
     presence: z.ZodOptional<z.ZodObject<{
         activity_type: z.ZodOptional<z.ZodEnum<["playing", "watching", "listening", "competing"]>>;
@@ -2010,6 +2078,13 @@ export declare const AgentChatDiscordSchema: z.ZodObject<{
     bot_token_env: string;
     session_expiry_hours: number;
     log_level: "minimal" | "standard" | "verbose";
+    output: {
+        tool_results: boolean;
+        tool_result_max_length: number;
+        system_status: boolean;
+        result_summary: boolean;
+        errors: boolean;
+    };
     guilds: {
         id: string;
         channels?: {
@@ -2060,11 +2135,121 @@ export declare const AgentChatDiscordSchema: z.ZodObject<{
     } | undefined;
     session_expiry_hours?: number | undefined;
     log_level?: "minimal" | "standard" | "verbose" | undefined;
+    output?: {
+        tool_results?: boolean | undefined;
+        tool_result_max_length?: number | undefined;
+        system_status?: boolean | undefined;
+        result_summary?: boolean | undefined;
+        errors?: boolean | undefined;
+    } | undefined;
     presence?: {
         activity_type?: "playing" | "watching" | "listening" | "competing" | undefined;
         activity_message?: string | undefined;
     } | undefined;
 }>;
+/**
+ * Slack channel configuration for an agent's bot
+ *
+ * @example
+ * ```yaml
+ * channels:
+ *   - id: "C0123456789"
+ *     name: "#support"
+ * ```
+ */
+export declare const SlackChannelSchema: z.ZodObject<{
+    /** Slack channel ID */
+    id: z.ZodString;
+    /** Human-readable channel name (for documentation) */
+    name: z.ZodOptional<z.ZodString>;
+    /** Channel message mode: "mention" = only respond to @mentions, "auto" = respond to all messages */
+    mode: z.ZodDefault<z.ZodEnum<["mention", "auto"]>>;
+    /** Number of context messages to include (future use) */
+    context_messages: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    mode: "mention" | "auto";
+    id: string;
+    context_messages: number;
+    name?: string | undefined;
+}, {
+    id: string;
+    name?: string | undefined;
+    mode?: "mention" | "auto" | undefined;
+    context_messages?: number | undefined;
+}>;
+/**
+ * Per-agent Slack bot configuration schema
+ *
+ * Unlike Discord where each agent has its own bot token,
+ * Slack uses a single app with one bot token per workspace.
+ * All agents share the same bot + app token pair.
+ *
+ * @example
+ * ```yaml
+ * chat:
+ *   slack:
+ *     bot_token_env: SLACK_BOT_TOKEN
+ *     app_token_env: SLACK_APP_TOKEN
+ *     session_expiry_hours: 24
+ *     log_level: standard
+ *     channels:
+ *       - id: "C0123456789"
+ *         name: "#support"
+ * ```
+ */
+export declare const AgentChatSlackSchema: z.ZodObject<{
+    /** Environment variable name containing the bot token (xoxb-...) */
+    bot_token_env: z.ZodDefault<z.ZodString>;
+    /** Environment variable name containing the app token for Socket Mode (xapp-...) */
+    app_token_env: z.ZodDefault<z.ZodString>;
+    /** Session expiry in hours (default: 24) */
+    session_expiry_hours: z.ZodDefault<z.ZodNumber>;
+    /** Log level for this agent's Slack connector */
+    log_level: z.ZodDefault<z.ZodEnum<["minimal", "standard", "verbose"]>>;
+    /** Channels this agent listens in */
+    channels: z.ZodArray<z.ZodObject<{
+        /** Slack channel ID */
+        id: z.ZodString;
+        /** Human-readable channel name (for documentation) */
+        name: z.ZodOptional<z.ZodString>;
+        /** Channel message mode: "mention" = only respond to @mentions, "auto" = respond to all messages */
+        mode: z.ZodDefault<z.ZodEnum<["mention", "auto"]>>;
+        /** Number of context messages to include (future use) */
+        context_messages: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        mode: "mention" | "auto";
+        id: string;
+        context_messages: number;
+        name?: string | undefined;
+    }, {
+        id: string;
+        name?: string | undefined;
+        mode?: "mention" | "auto" | undefined;
+        context_messages?: number | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    channels: {
+        mode: "mention" | "auto";
+        id: string;
+        context_messages: number;
+        name?: string | undefined;
+    }[];
+    bot_token_env: string;
+    session_expiry_hours: number;
+    log_level: "minimal" | "standard" | "verbose";
+    app_token_env: string;
+}, {
+    channels: {
+        id: string;
+        name?: string | undefined;
+        mode?: "mention" | "auto" | undefined;
+        context_messages?: number | undefined;
+    }[];
+    bot_token_env?: string | undefined;
+    session_expiry_hours?: number | undefined;
+    log_level?: "minimal" | "standard" | "verbose" | undefined;
+    app_token_env?: string | undefined;
+}>;
 export declare const AgentChatSchema: z.ZodObject<{
     discord: z.ZodOptional<z.ZodObject<{
         /** Environment variable name containing the bot token (never store tokens in config) */
@@ -2073,6 +2258,31 @@ export declare const AgentChatSchema: z.ZodObject<{
         session_expiry_hours: z.ZodDefault<z.ZodNumber>;
         /** Log level for this agent's Discord connector */
         log_level: z.ZodDefault<z.ZodEnum<["minimal", "standard", "verbose"]>>;
+        /** Output configuration for controlling what gets shown during conversations */
+        output: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            /** Show tool results as embeds (default: true) */
+            tool_results: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            /** Max chars of tool output to include in embeds (default: 900, max: 1000) */
+            tool_result_max_length: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+            /** Show system status messages like "compacting context..." (default: true) */
+            system_status: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            /** Show a summary embed when the agent finishes a turn (cost, tokens, turns) (default: false) */
+            result_summary: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            /** Show error messages from the SDK (default: true) */
+            errors: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        }, "strip", z.ZodTypeAny, {
+            tool_results: boolean;
+            tool_result_max_length: number;
+            system_status: boolean;
+            result_summary: boolean;
+            errors: boolean;
+        }, {
+            tool_results?: boolean | undefined;
+            tool_result_max_length?: number | undefined;
+            system_status?: boolean | undefined;
+            result_summary?: boolean | undefined;
+            errors?: boolean | undefined;
+        }>>>;
         /** Bot presence/activity configuration */
         presence: z.ZodOptional<z.ZodObject<{
             activity_type: z.ZodOptional<z.ZodEnum<["playing", "watching", "listening", "competing"]>>;
@@ -2169,6 +2379,13 @@ export declare const AgentChatSchema: z.ZodObject<{
         bot_token_env: string;
         session_expiry_hours: number;
         log_level: "minimal" | "standard" | "verbose";
+        output: {
+            tool_results: boolean;
+            tool_result_max_length: number;
+            system_status: boolean;
+            result_summary: boolean;
+            errors: boolean;
+        };
         guilds: {
             id: string;
             channels?: {
@@ -2219,16 +2436,83 @@ export declare const AgentChatSchema: z.ZodObject<{
         } | undefined;
         session_expiry_hours?: number | undefined;
         log_level?: "minimal" | "standard" | "verbose" | undefined;
+        output?: {
+            tool_results?: boolean | undefined;
+            tool_result_max_length?: number | undefined;
+            system_status?: boolean | undefined;
+            result_summary?: boolean | undefined;
+            errors?: boolean | undefined;
+        } | undefined;
         presence?: {
             activity_type?: "playing" | "watching" | "listening" | "competing" | undefined;
             activity_message?: string | undefined;
         } | undefined;
     }>>;
+    slack: z.ZodOptional<z.ZodObject<{
+        /** Environment variable name containing the bot token (xoxb-...) */
+        bot_token_env: z.ZodDefault<z.ZodString>;
+        /** Environment variable name containing the app token for Socket Mode (xapp-...) */
+        app_token_env: z.ZodDefault<z.ZodString>;
+        /** Session expiry in hours (default: 24) */
+        session_expiry_hours: z.ZodDefault<z.ZodNumber>;
+        /** Log level for this agent's Slack connector */
+        log_level: z.ZodDefault<z.ZodEnum<["minimal", "standard", "verbose"]>>;
+        /** Channels this agent listens in */
+        channels: z.ZodArray<z.ZodObject<{
+            /** Slack channel ID */
+            id: z.ZodString;
+            /** Human-readable channel name (for documentation) */
+            name: z.ZodOptional<z.ZodString>;
+            /** Channel message mode: "mention" = only respond to @mentions, "auto" = respond to all messages */
+            mode: z.ZodDefault<z.ZodEnum<["mention", "auto"]>>;
+            /** Number of context messages to include (future use) */
+            context_messages: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            mode: "mention" | "auto";
+            id: string;
+            context_messages: number;
+            name?: string | undefined;
+        }, {
+            id: string;
+            name?: string | undefined;
+            mode?: "mention" | "auto" | undefined;
+            context_messages?: number | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        channels: {
+            mode: "mention" | "auto";
+            id: string;
+            context_messages: number;
+            name?: string | undefined;
+        }[];
+        bot_token_env: string;
+        session_expiry_hours: number;
+        log_level: "minimal" | "standard" | "verbose";
+        app_token_env: string;
+    }, {
+        channels: {
+            id: string;
+            name?: string | undefined;
+            mode?: "mention" | "auto" | undefined;
+            context_messages?: number | undefined;
+        }[];
+        bot_token_env?: string | undefined;
+        session_expiry_hours?: number | undefined;
+        log_level?: "minimal" | "standard" | "verbose" | undefined;
+        app_token_env?: string | undefined;
+    }>>;
 }, "strip", z.ZodTypeAny, {
     discord?: {
         bot_token_env: string;
         session_expiry_hours: number;
         log_level: "minimal" | "standard" | "verbose";
+        output: {
+            tool_results: boolean;
+            tool_result_max_length: number;
+            system_status: boolean;
+            result_summary: boolean;
+            errors: boolean;
+        };
         guilds: {
             id: string;
             channels?: {
@@ -2255,6 +2539,18 @@ export declare const AgentChatSchema: z.ZodObject<{
             activity_message?: string | undefined;
         } | undefined;
     } | undefined;
+    slack?: {
+        channels: {
+            mode: "mention" | "auto";
+            id: string;
+            context_messages: number;
+            name?: string | undefined;
+        }[];
+        bot_token_env: string;
+        session_expiry_hours: number;
+        log_level: "minimal" | "standard" | "verbose";
+        app_token_env: string;
+    } | undefined;
 }, {
     discord?: {
         bot_token_env: string;
@@ -2281,11 +2577,30 @@ export declare const AgentChatSchema: z.ZodObject<{
         } | undefined;
         session_expiry_hours?: number | undefined;
         log_level?: "minimal" | "standard" | "verbose" | undefined;
+        output?: {
+            tool_results?: boolean | undefined;
+            tool_result_max_length?: number | undefined;
+            system_status?: boolean | undefined;
+            result_summary?: boolean | undefined;
+            errors?: boolean | undefined;
+        } | undefined;
         presence?: {
             activity_type?: "playing" | "watching" | "listening" | "competing" | undefined;
             activity_message?: string | undefined;
         } | undefined;
     } | undefined;
+    slack?: {
+        channels: {
+            id: string;
+            name?: string | undefined;
+            mode?: "mention" | "auto" | undefined;
+            context_messages?: number | undefined;
+        }[];
+        bot_token_env?: string | undefined;
+        session_expiry_hours?: number | undefined;
+        log_level?: "minimal" | "standard" | "verbose" | undefined;
+        app_token_env?: string | undefined;
+    } | undefined;
 }>;
 /**
  * Hook events that can trigger hooks
@@ -2404,6 +2719,41 @@ export declare const DiscordHookConfigSchema: z.ZodObject<{
     on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
     when?: string | undefined;
 }>;
+/**
+ * Slack hook configuration - sends notification to a Slack channel
+ */
+export declare const SlackHookConfigSchema: z.ZodObject<{
+    /** Human-readable name for this hook (used in logs) */
+    name: z.ZodOptional<z.ZodString>;
+    /** Whether to continue with subsequent hooks if this hook fails (default: true) */
+    continue_on_error: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /** Filter which events trigger this hook (default: all events) */
+    on_events: z.ZodOptional<z.ZodArray<z.ZodEnum<["completed", "failed", "timeout", "cancelled"]>, "many">>;
+    /** Conditional execution: dot-notation path to a boolean field in the hook context (e.g., "metadata.shouldNotify") */
+    when: z.ZodOptional<z.ZodString>;
+} & {
+    type: z.ZodLiteral<"slack">;
+    /** Slack channel ID to post to */
+    channel_id: z.ZodString;
+    /** Environment variable name containing the bot token */
+    bot_token_env: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "slack";
+    bot_token_env: string;
+    continue_on_error: boolean;
+    channel_id: string;
+    name?: string | undefined;
+    on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+    when?: string | undefined;
+}, {
+    type: "slack";
+    channel_id: string;
+    name?: string | undefined;
+    bot_token_env?: string | undefined;
+    continue_on_error?: boolean | undefined;
+    on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+    when?: string | undefined;
+}>;
 /**
  * Union of all hook configuration types
  */
@@ -2508,6 +2858,37 @@ export declare const HookConfigSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObj
     continue_on_error?: boolean | undefined;
     on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
     when?: string | undefined;
+}>, z.ZodObject<{
+    /** Human-readable name for this hook (used in logs) */
+    name: z.ZodOptional<z.ZodString>;
+    /** Whether to continue with subsequent hooks if this hook fails (default: true) */
+    continue_on_error: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    /** Filter which events trigger this hook (default: all events) */
+    on_events: z.ZodOptional<z.ZodArray<z.ZodEnum<["completed", "failed", "timeout", "cancelled"]>, "many">>;
+    /** Conditional execution: dot-notation path to a boolean field in the hook context (e.g., "metadata.shouldNotify") */
+    when: z.ZodOptional<z.ZodString>;
+} & {
+    type: z.ZodLiteral<"slack">;
+    /** Slack channel ID to post to */
+    channel_id: z.ZodString;
+    /** Environment variable name containing the bot token */
+    bot_token_env: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "slack";
+    bot_token_env: string;
+    continue_on_error: boolean;
+    channel_id: string;
+    name?: string | undefined;
+    on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+    when?: string | undefined;
+}, {
+    type: "slack";
+    channel_id: string;
+    name?: string | undefined;
+    bot_token_env?: string | undefined;
+    continue_on_error?: boolean | undefined;
+    on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+    when?: string | undefined;
 }>]>;
 /**
  * Agent hooks configuration
@@ -2615,6 +2996,37 @@ export declare const AgentHooksSchema: z.ZodObject<{
         continue_on_error?: boolean | undefined;
         on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
         when?: string | undefined;
+    }>, z.ZodObject<{
+        /** Human-readable name for this hook (used in logs) */
+        name: z.ZodOptional<z.ZodString>;
+        /** Whether to continue with subsequent hooks if this hook fails (default: true) */
+        continue_on_error: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** Filter which events trigger this hook (default: all events) */
+        on_events: z.ZodOptional<z.ZodArray<z.ZodEnum<["completed", "failed", "timeout", "cancelled"]>, "many">>;
+        /** Conditional execution: dot-notation path to a boolean field in the hook context (e.g., "metadata.shouldNotify") */
+        when: z.ZodOptional<z.ZodString>;
+    } & {
+        type: z.ZodLiteral<"slack">;
+        /** Slack channel ID to post to */
+        channel_id: z.ZodString;
+        /** Environment variable name containing the bot token */
+        bot_token_env: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "slack";
+        bot_token_env: string;
+        continue_on_error: boolean;
+        channel_id: string;
+        name?: string | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
+    }, {
+        type: "slack";
+        channel_id: string;
+        name?: string | undefined;
+        bot_token_env?: string | undefined;
+        continue_on_error?: boolean | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
     }>]>, "many">>;
     /** Hooks to run only when a job fails */
     on_error: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
@@ -2718,6 +3130,37 @@ export declare const AgentHooksSchema: z.ZodObject<{
         continue_on_error?: boolean | undefined;
         on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
         when?: string | undefined;
+    }>, z.ZodObject<{
+        /** Human-readable name for this hook (used in logs) */
+        name: z.ZodOptional<z.ZodString>;
+        /** Whether to continue with subsequent hooks if this hook fails (default: true) */
+        continue_on_error: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        /** Filter which events trigger this hook (default: all events) */
+        on_events: z.ZodOptional<z.ZodArray<z.ZodEnum<["completed", "failed", "timeout", "cancelled"]>, "many">>;
+        /** Conditional execution: dot-notation path to a boolean field in the hook context (e.g., "metadata.shouldNotify") */
+        when: z.ZodOptional<z.ZodString>;
+    } & {
+        type: z.ZodLiteral<"slack">;
+        /** Slack channel ID to post to */
+        channel_id: z.ZodString;
+        /** Environment variable name containing the bot token */
+        bot_token_env: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "slack";
+        bot_token_env: string;
+        continue_on_error: boolean;
+        channel_id: string;
+        name?: string | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
+    }, {
+        type: "slack";
+        channel_id: string;
+        name?: string | undefined;
+        bot_token_env?: string | undefined;
+        continue_on_error?: boolean | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
     }>]>, "many">>;
 }, "strip", z.ZodTypeAny, {
     after_run?: ({
@@ -2746,6 +3189,14 @@ export declare const AgentHooksSchema: z.ZodObject<{
         name?: string | undefined;
         on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
         when?: string | undefined;
+    } | {
+        type: "slack";
+        bot_token_env: string;
+        continue_on_error: boolean;
+        channel_id: string;
+        name?: string | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
     })[] | undefined;
     on_error?: ({
         type: "shell";
@@ -2773,6 +3224,14 @@ export declare const AgentHooksSchema: z.ZodObject<{
         name?: string | undefined;
         on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
         when?: string | undefined;
+    } | {
+        type: "slack";
+        bot_token_env: string;
+        continue_on_error: boolean;
+        channel_id: string;
+        name?: string | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
     })[] | undefined;
 }, {
     after_run?: ({
@@ -2801,6 +3260,14 @@ export declare const AgentHooksSchema: z.ZodObject<{
         continue_on_error?: boolean | undefined;
         on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
         when?: string | undefined;
+    } | {
+        type: "slack";
+        channel_id: string;
+        name?: string | undefined;
+        bot_token_env?: string | undefined;
+        continue_on_error?: boolean | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
     })[] | undefined;
     on_error?: ({
         type: "shell";
@@ -2828,6 +3295,14 @@ export declare const AgentHooksSchema: z.ZodObject<{
         continue_on_error?: boolean | undefined;
         on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
         when?: string | undefined;
+    } | {
+        type: "slack";
+        channel_id: string;
+        name?: string | undefined;
+        bot_token_env?: string | undefined;
+        continue_on_error?: boolean | undefined;
+        on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+        when?: string | undefined;
     })[] | undefined;
 }>;
 export declare const AgentWorkingDirectorySchema: z.ZodUnion<[z.ZodString, z.ZodObject<{
@@ -3167,6 +3642,31 @@ export declare const AgentConfigSchema: z.ZodObject<{
             session_expiry_hours: z.ZodDefault<z.ZodNumber>;
             /** Log level for this agent's Discord connector */
             log_level: z.ZodDefault<z.ZodEnum<["minimal", "standard", "verbose"]>>;
+            /** Output configuration for controlling what gets shown during conversations */
+            output: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+                /** Show tool results as embeds (default: true) */
+                tool_results: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                /** Max chars of tool output to include in embeds (default: 900, max: 1000) */
+                tool_result_max_length: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+                /** Show system status messages like "compacting context..." (default: true) */
+                system_status: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                /** Show a summary embed when the agent finishes a turn (cost, tokens, turns) (default: false) */
+                result_summary: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+                /** Show error messages from the SDK (default: true) */
+                errors: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            }, "strip", z.ZodTypeAny, {
+                tool_results: boolean;
+                tool_result_max_length: number;
+                system_status: boolean;
+                result_summary: boolean;
+                errors: boolean;
+            }, {
+                tool_results?: boolean | undefined;
+                tool_result_max_length?: number | undefined;
+                system_status?: boolean | undefined;
+                result_summary?: boolean | undefined;
+                errors?: boolean | undefined;
+            }>>>;
             /** Bot presence/activity configuration */
             presence: z.ZodOptional<z.ZodObject<{
                 activity_type: z.ZodOptional<z.ZodEnum<["playing", "watching", "listening", "competing"]>>;
@@ -3263,6 +3763,13 @@ export declare const AgentConfigSchema: z.ZodObject<{
             bot_token_env: string;
             session_expiry_hours: number;
             log_level: "minimal" | "standard" | "verbose";
+            output: {
+                tool_results: boolean;
+                tool_result_max_length: number;
+                system_status: boolean;
+                result_summary: boolean;
+                errors: boolean;
+            };
             guilds: {
                 id: string;
                 channels?: {
@@ -3313,16 +3820,83 @@ export declare const AgentConfigSchema: z.ZodObject<{
             } | undefined;
             session_expiry_hours?: number | undefined;
             log_level?: "minimal" | "standard" | "verbose" | undefined;
+            output?: {
+                tool_results?: boolean | undefined;
+                tool_result_max_length?: number | undefined;
+                system_status?: boolean | undefined;
+                result_summary?: boolean | undefined;
+                errors?: boolean | undefined;
+            } | undefined;
             presence?: {
                 activity_type?: "playing" | "watching" | "listening" | "competing" | undefined;
                 activity_message?: string | undefined;
             } | undefined;
         }>>;
+        slack: z.ZodOptional<z.ZodObject<{
+            /** Environment variable name containing the bot token (xoxb-...) */
+            bot_token_env: z.ZodDefault<z.ZodString>;
+            /** Environment variable name containing the app token for Socket Mode (xapp-...) */
+            app_token_env: z.ZodDefault<z.ZodString>;
+            /** Session expiry in hours (default: 24) */
+            session_expiry_hours: z.ZodDefault<z.ZodNumber>;
+            /** Log level for this agent's Slack connector */
+            log_level: z.ZodDefault<z.ZodEnum<["minimal", "standard", "verbose"]>>;
+            /** Channels this agent listens in */
+            channels: z.ZodArray<z.ZodObject<{
+                /** Slack channel ID */
+                id: z.ZodString;
+                /** Human-readable channel name (for documentation) */
+                name: z.ZodOptional<z.ZodString>;
+                /** Channel message mode: "mention" = only respond to @mentions, "auto" = respond to all messages */
+                mode: z.ZodDefault<z.ZodEnum<["mention", "auto"]>>;
+                /** Number of context messages to include (future use) */
+                context_messages: z.ZodDefault<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                mode: "mention" | "auto";
+                id: string;
+                context_messages: number;
+                name?: string | undefined;
+            }, {
+                id: string;
+                name?: string | undefined;
+                mode?: "mention" | "auto" | undefined;
+                context_messages?: number | undefined;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            channels: {
+                mode: "mention" | "auto";
+                id: string;
+                context_messages: number;
+                name?: string | undefined;
+            }[];
+            bot_token_env: string;
+            session_expiry_hours: number;
+            log_level: "minimal" | "standard" | "verbose";
+            app_token_env: string;
+        }, {
+            channels: {
+                id: string;
+                name?: string | undefined;
+                mode?: "mention" | "auto" | undefined;
+                context_messages?: number | undefined;
+            }[];
+            bot_token_env?: string | undefined;
+            session_expiry_hours?: number | undefined;
+            log_level?: "minimal" | "standard" | "verbose" | undefined;
+            app_token_env?: string | undefined;
+        }>>;
     }, "strip", z.ZodTypeAny, {
         discord?: {
             bot_token_env: string;
             session_expiry_hours: number;
             log_level: "minimal" | "standard" | "verbose";
+            output: {
+                tool_results: boolean;
+                tool_result_max_length: number;
+                system_status: boolean;
+                result_summary: boolean;
+                errors: boolean;
+            };
             guilds: {
                 id: string;
                 channels?: {
@@ -3349,6 +3923,18 @@ export declare const AgentConfigSchema: z.ZodObject<{
                 activity_message?: string | undefined;
             } | undefined;
         } | undefined;
+        slack?: {
+            channels: {
+                mode: "mention" | "auto";
+                id: string;
+                context_messages: number;
+                name?: string | undefined;
+            }[];
+            bot_token_env: string;
+            session_expiry_hours: number;
+            log_level: "minimal" | "standard" | "verbose";
+            app_token_env: string;
+        } | undefined;
     }, {
         discord?: {
             bot_token_env: string;
@@ -3375,11 +3961,30 @@ export declare const AgentConfigSchema: z.ZodObject<{
             } | undefined;
             session_expiry_hours?: number | undefined;
             log_level?: "minimal" | "standard" | "verbose" | undefined;
+            output?: {
+                tool_results?: boolean | undefined;
+                tool_result_max_length?: number | undefined;
+                system_status?: boolean | undefined;
+                result_summary?: boolean | undefined;
+                errors?: boolean | undefined;
+            } | undefined;
             presence?: {
                 activity_type?: "playing" | "watching" | "listening" | "competing" | undefined;
                 activity_message?: string | undefined;
             } | undefined;
         } | undefined;
+        slack?: {
+            channels: {
+                id: string;
+                name?: string | undefined;
+                mode?: "mention" | "auto" | undefined;
+                context_messages?: number | undefined;
+            }[];
+            bot_token_env?: string | undefined;
+            session_expiry_hours?: number | undefined;
+            log_level?: "minimal" | "standard" | "verbose" | undefined;
+            app_token_env?: string | undefined;
+        } | undefined;
     }>>;
     hooks: z.ZodOptional<z.ZodObject<{
         /** Hooks to run after every job (success or failure) */
@@ -3484,6 +4089,37 @@ export declare const AgentConfigSchema: z.ZodObject<{
             continue_on_error?: boolean | undefined;
             on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
             when?: string | undefined;
+        }>, z.ZodObject<{
+            /** Human-readable name for this hook (used in logs) */
+            name: z.ZodOptional<z.ZodString>;
+            /** Whether to continue with subsequent hooks if this hook fails (default: true) */
+            continue_on_error: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            /** Filter which events trigger this hook (default: all events) */
+            on_events: z.ZodOptional<z.ZodArray<z.ZodEnum<["completed", "failed", "timeout", "cancelled"]>, "many">>;
+            /** Conditional execution: dot-notation path to a boolean field in the hook context (e.g., "metadata.shouldNotify") */
+            when: z.ZodOptional<z.ZodString>;
+        } & {
+            type: z.ZodLiteral<"slack">;
+            /** Slack channel ID to post to */
+            channel_id: z.ZodString;
+            /** Environment variable name containing the bot token */
+            bot_token_env: z.ZodDefault<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "slack";
+            bot_token_env: string;
+            continue_on_error: boolean;
+            channel_id: string;
+            name?: string | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+        }, {
+            type: "slack";
+            channel_id: string;
+            name?: string | undefined;
+            bot_token_env?: string | undefined;
+            continue_on_error?: boolean | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
         }>]>, "many">>;
         /** Hooks to run only when a job fails */
         on_error: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
@@ -3587,6 +4223,37 @@ export declare const AgentConfigSchema: z.ZodObject<{
             continue_on_error?: boolean | undefined;
             on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
             when?: string | undefined;
+        }>, z.ZodObject<{
+            /** Human-readable name for this hook (used in logs) */
+            name: z.ZodOptional<z.ZodString>;
+            /** Whether to continue with subsequent hooks if this hook fails (default: true) */
+            continue_on_error: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            /** Filter which events trigger this hook (default: all events) */
+            on_events: z.ZodOptional<z.ZodArray<z.ZodEnum<["completed", "failed", "timeout", "cancelled"]>, "many">>;
+            /** Conditional execution: dot-notation path to a boolean field in the hook context (e.g., "metadata.shouldNotify") */
+            when: z.ZodOptional<z.ZodString>;
+        } & {
+            type: z.ZodLiteral<"slack">;
+            /** Slack channel ID to post to */
+            channel_id: z.ZodString;
+            /** Environment variable name containing the bot token */
+            bot_token_env: z.ZodDefault<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "slack";
+            bot_token_env: string;
+            continue_on_error: boolean;
+            channel_id: string;
+            name?: string | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
+        }, {
+            type: "slack";
+            channel_id: string;
+            name?: string | undefined;
+            bot_token_env?: string | undefined;
+            continue_on_error?: boolean | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
         }>]>, "many">>;
     }, "strip", z.ZodTypeAny, {
         after_run?: ({
@@ -3615,6 +4282,14 @@ export declare const AgentConfigSchema: z.ZodObject<{
             name?: string | undefined;
             on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
             when?: string | undefined;
+        } | {
+            type: "slack";
+            bot_token_env: string;
+            continue_on_error: boolean;
+            channel_id: string;
+            name?: string | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
         })[] | undefined;
         on_error?: ({
             type: "shell";
@@ -3642,6 +4317,14 @@ export declare const AgentConfigSchema: z.ZodObject<{
             name?: string | undefined;
             on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
             when?: string | undefined;
+        } | {
+            type: "slack";
+            bot_token_env: string;
+            continue_on_error: boolean;
+            channel_id: string;
+            name?: string | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
         })[] | undefined;
     }, {
         after_run?: ({
@@ -3670,6 +4353,14 @@ export declare const AgentConfigSchema: z.ZodObject<{
             continue_on_error?: boolean | undefined;
             on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
             when?: string | undefined;
+        } | {
+            type: "slack";
+            channel_id: string;
+            name?: string | undefined;
+            bot_token_env?: string | undefined;
+            continue_on_error?: boolean | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
         })[] | undefined;
         on_error?: ({
             type: "shell";
@@ -3697,6 +4388,14 @@ export declare const AgentConfigSchema: z.ZodObject<{
             continue_on_error?: boolean | undefined;
             on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
             when?: string | undefined;
+        } | {
+            type: "slack";
+            channel_id: string;
+            name?: string | undefined;
+            bot_token_env?: string | undefined;
+            continue_on_error?: boolean | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
         })[] | undefined;
     }>>;
     docker: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodObject<{
@@ -3888,6 +4587,13 @@ export declare const AgentConfigSchema: z.ZodObject<{
             bot_token_env: string;
             session_expiry_hours: number;
             log_level: "minimal" | "standard" | "verbose";
+            output: {
+                tool_results: boolean;
+                tool_result_max_length: number;
+                system_status: boolean;
+                result_summary: boolean;
+                errors: boolean;
+            };
             guilds: {
                 id: string;
                 channels?: {
@@ -3914,6 +4620,18 @@ export declare const AgentConfigSchema: z.ZodObject<{
                 activity_message?: string | undefined;
             } | undefined;
         } | undefined;
+        slack?: {
+            channels: {
+                mode: "mention" | "auto";
+                id: string;
+                context_messages: number;
+                name?: string | undefined;
+            }[];
+            bot_token_env: string;
+            session_expiry_hours: number;
+            log_level: "minimal" | "standard" | "verbose";
+            app_token_env: string;
+        } | undefined;
     } | undefined;
     description?: string | undefined;
     identity?: {
@@ -3986,6 +4704,14 @@ export declare const AgentConfigSchema: z.ZodObject<{
             name?: string | undefined;
             on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
             when?: string | undefined;
+        } | {
+            type: "slack";
+            bot_token_env: string;
+            continue_on_error: boolean;
+            channel_id: string;
+            name?: string | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
         })[] | undefined;
         on_error?: ({
             type: "shell";
@@ -4013,6 +4739,14 @@ export declare const AgentConfigSchema: z.ZodObject<{
             name?: string | undefined;
             on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
             when?: string | undefined;
+        } | {
+            type: "slack";
+            bot_token_env: string;
+            continue_on_error: boolean;
+            channel_id: string;
+            name?: string | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
         })[] | undefined;
     } | undefined;
     metadata_file?: string | undefined;
@@ -4100,11 +4834,30 @@ export declare const AgentConfigSchema: z.ZodObject<{
             } | undefined;
             session_expiry_hours?: number | undefined;
             log_level?: "minimal" | "standard" | "verbose" | undefined;
+            output?: {
+                tool_results?: boolean | undefined;
+                tool_result_max_length?: number | undefined;
+                system_status?: boolean | undefined;
+                result_summary?: boolean | undefined;
+                errors?: boolean | undefined;
+            } | undefined;
             presence?: {
                 activity_type?: "playing" | "watching" | "listening" | "competing" | undefined;
                 activity_message?: string | undefined;
             } | undefined;
         } | undefined;
+        slack?: {
+            channels: {
+                id: string;
+                name?: string | undefined;
+                mode?: "mention" | "auto" | undefined;
+                context_messages?: number | undefined;
+            }[];
+            bot_token_env?: string | undefined;
+            session_expiry_hours?: number | undefined;
+            log_level?: "minimal" | "standard" | "verbose" | undefined;
+            app_token_env?: string | undefined;
+        } | undefined;
     } | undefined;
     description?: string | undefined;
     identity?: {
@@ -4177,6 +4930,14 @@ export declare const AgentConfigSchema: z.ZodObject<{
             continue_on_error?: boolean | undefined;
             on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
             when?: string | undefined;
+        } | {
+            type: "slack";
+            channel_id: string;
+            name?: string | undefined;
+            bot_token_env?: string | undefined;
+            continue_on_error?: boolean | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
         })[] | undefined;
         on_error?: ({
             type: "shell";
@@ -4204,6 +4965,14 @@ export declare const AgentConfigSchema: z.ZodObject<{
             continue_on_error?: boolean | undefined;
             on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
             when?: string | undefined;
+        } | {
+            type: "slack";
+            channel_id: string;
+            name?: string | undefined;
+            bot_token_env?: string | undefined;
+            continue_on_error?: boolean | undefined;
+            on_events?: ("timeout" | "completed" | "failed" | "cancelled")[] | undefined;
+            when?: string | undefined;
         })[] | undefined;
     } | undefined;
     metadata_file?: string | undefined;
@@ -5420,19 +6189,24 @@ 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 DiscordOutput = z.infer<typeof DiscordOutputSchema>;
 export type AgentChatDiscord = z.infer<typeof AgentChatDiscordSchema>;
 export type AgentChat = z.infer<typeof AgentChatSchema>;
+export type SlackChannel = z.infer<typeof SlackChannelSchema>;
+export type AgentChatSlack = z.infer<typeof AgentChatSlackSchema>;
 export type AgentWorkingDirectory = z.infer<typeof AgentWorkingDirectorySchema>;
 export type AgentConfig = z.infer<typeof AgentConfigSchema>;
 export type HookEvent = z.infer<typeof HookEventSchema>;
 export type ShellHookConfig = z.infer<typeof ShellHookConfigSchema>;
 export type WebhookHookConfig = z.infer<typeof WebhookHookConfigSchema>;
 export type DiscordHookConfig = z.infer<typeof DiscordHookConfigSchema>;
+export type SlackHookConfig = z.infer<typeof SlackHookConfigSchema>;
 export type HookConfig = z.infer<typeof HookConfigSchema>;
 export type AgentHooks = z.infer<typeof AgentHooksSchema>;
 export type ShellHookConfigInput = z.input<typeof ShellHookConfigSchema>;
 export type WebhookHookConfigInput = z.input<typeof WebhookHookConfigSchema>;
 export type DiscordHookConfigInput = z.input<typeof DiscordHookConfigSchema>;
+export type SlackHookConfigInput = z.input<typeof SlackHookConfigSchema>;
 export type HookConfigInput = z.input<typeof HookConfigSchema>;
 export type AgentHooksInput = z.input<typeof AgentHooksSchema>;
 //# sourceMappingURL=schema.d.ts.map