@herdctl/core 3.0.2 → 4.1.0

package/dist/hooks/index.d.ts

@@ -7,9 +7,10 @@
  *
  * @module hooks
  */
-export type { HookContext, HookResult, BaseHookConfig, AgentHooksConfig, HookRunner, ShellHookConfigInput, WebhookHookConfigInput, DiscordHookConfigInput, HookConfigInput, } from "./types.js";
+export type { HookContext, HookResult, BaseHookConfig, AgentHooksConfig, HookRunner, ShellHookConfigInput, WebhookHookConfigInput, DiscordHookConfigInput, SlackHookConfigInput, HookConfigInput, } from "./types.js";
 export { HookExecutor, type HookExecutorOptions, type HookExecutorLogger, type HookExecutionResult, } from "./hook-executor.js";
 export { ShellHookRunner, type ShellHookRunnerOptions, type ShellHookRunnerLogger, } from "./runners/shell.js";
 export { WebhookHookRunner, type WebhookHookRunnerOptions, type WebhookHookRunnerLogger, } from "./runners/webhook.js";
 export { DiscordHookRunner, type DiscordHookRunnerOptions, type DiscordHookRunnerLogger, } from "./runners/discord.js";
+export { SlackHookRunner, type SlackHookRunnerOptions, type SlackHookRunnerLogger, } from "./runners/slack.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,YAAY,EACV,WAAW,EACX,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,UAAU,EAEV,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,YAAY,EACV,WAAW,EACX,UAAU,EACV,cAAc,EACd,gBAAgB,EAChB,UAAU,EAEV,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,GAC7B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,eAAe,EACf,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,GAC3B,MAAM,oBAAoB,CAAC"}

package/dist/hooks/index.js

@@ -15,4 +15,6 @@ export { ShellHookRunner, } from "./runners/shell.js";
 export { WebhookHookRunner, } from "./runners/webhook.js";
 // Discord Hook Runner
 export { DiscordHookRunner, } from "./runners/discord.js";
+// Slack Hook Runner
+export { SlackHookRunner, } from "./runners/slack.js";
 //# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAkBH,gBAAgB;AAChB,OAAO,EACL,YAAY,GAIb,MAAM,oBAAoB,CAAC;AAE5B,oBAAoB;AACpB,OAAO,EACL,eAAe,GAGhB,MAAM,oBAAoB,CAAC;AAE5B,sBAAsB;AACtB,OAAO,EACL,iBAAiB,GAGlB,MAAM,sBAAsB,CAAC;AAE9B,sBAAsB;AACtB,OAAO,EACL,iBAAiB,GAGlB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAmBH,gBAAgB;AAChB,OAAO,EACL,YAAY,GAIb,MAAM,oBAAoB,CAAC;AAE5B,oBAAoB;AACpB,OAAO,EACL,eAAe,GAGhB,MAAM,oBAAoB,CAAC;AAE5B,sBAAsB;AACtB,OAAO,EACL,iBAAiB,GAGlB,MAAM,sBAAsB,CAAC;AAE9B,sBAAsB;AACtB,OAAO,EACL,iBAAiB,GAGlB,MAAM,sBAAsB,CAAC;AAE9B,oBAAoB;AACpB,OAAO,EACL,eAAe,GAGhB,MAAM,oBAAoB,CAAC"}

package/dist/hooks/runners/slack.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Slack Hook Runner
+ *
+ * Posts job notifications to a Slack channel using rich message formatting.
+ * Used for team visibility into fleet activity.
+ */
+import type { HookContext, HookResult, SlackHookConfigInput } from "../types.js";
+/**
+ * Logger interface for SlackHookRunner
+ */
+export interface SlackHookRunnerLogger {
+    debug: (message: string) => void;
+    info: (message: string) => void;
+    warn: (message: string) => void;
+    error: (message: string) => void;
+}
+/**
+ * Options for SlackHookRunner
+ */
+export interface SlackHookRunnerOptions {
+    /**
+     * Logger for hook execution output
+     */
+    logger?: SlackHookRunnerLogger;
+    /**
+     * Custom fetch implementation (for testing)
+     */
+    fetch?: typeof globalThis.fetch;
+}
+/**
+ * SlackHookRunner posts job notifications to a Slack channel
+ *
+ * Uses the Slack Web API (chat.postMessage) with attachments for rich formatting.
+ *
+ * @example
+ * ```typescript
+ * const runner = new SlackHookRunner({ logger: console });
+ *
+ * const result = await runner.execute(
+ *   {
+ *     type: 'slack',
+ *     channel_id: 'C1234567890',
+ *     bot_token_env: 'SLACK_BOT_TOKEN'
+ *   },
+ *   hookContext
+ * );
+ * ```
+ */
+export declare class SlackHookRunner {
+    private logger;
+    private fetchFn;
+    constructor(options?: SlackHookRunnerOptions);
+    /**
+     * Execute a Slack hook with the given context
+     *
+     * @param config - Slack hook configuration
+     * @param context - Hook context to send in the notification
+     * @returns Promise resolving to the hook result
+     */
+    execute(config: SlackHookConfigInput, context: HookContext): Promise<HookResult>;
+}
+//# sourceMappingURL=slack.d.ts.map

package/dist/hooks/runners/slack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.d.ts","sourceRoot":"","sources":["../../../src/hooks/runners/slack.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AA2BjF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,MAAM,CAAC,EAAE,qBAAqB,CAAC;IAE/B;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACjC;AAwKD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,OAAO,CAA0B;gBAE7B,OAAO,GAAE,sBAA2B;IAUhD;;;;;;OAMG;IACG,OAAO,CAAC,MAAM,EAAE,oBAAoB,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAoJvF"}

package/dist/hooks/runners/slack.js

@@ -0,0 +1,329 @@
+/**
+ * Slack Hook Runner
+ *
+ * Posts job notifications to a Slack channel using rich message formatting.
+ * Used for team visibility into fleet activity.
+ */
+/**
+ * Default timeout for Slack API requests in milliseconds
+ */
+const DEFAULT_TIMEOUT = 10000;
+/**
+ * Maximum output length for message text (Slack limit: ~40K, practical: 4000)
+ */
+const MAX_TEXT_LENGTH = 3500;
+/**
+ * Maximum length for attachment fields
+ */
+const MAX_FIELD_LENGTH = 900;
+/**
+ * Colors for different event types
+ */
+const EVENT_COLORS = {
+    completed: "#22c55e", // green
+    failed: "#ef4444", // red
+    timeout: "#f59e0b", // amber
+    cancelled: "#6b7280", // gray
+};
+/**
+ * Truncates a string to a maximum length, adding ellipsis if truncated
+ */
+function truncateOutput(output, maxLength) {
+    if (output.length <= maxLength) {
+        return output;
+    }
+    return output.slice(0, maxLength - 3) + "...";
+}
+/**
+ * Formats duration in milliseconds to a human-readable string
+ */
+function formatDuration(ms) {
+    if (ms < 1000) {
+        return `${ms}ms`;
+    }
+    const seconds = Math.floor(ms / 1000);
+    if (seconds < 60) {
+        return `${seconds}s`;
+    }
+    const minutes = Math.floor(seconds / 60);
+    const remainingSeconds = seconds % 60;
+    if (minutes < 60) {
+        return remainingSeconds > 0 ? `${minutes}m ${remainingSeconds}s` : `${minutes}m`;
+    }
+    const hours = Math.floor(minutes / 60);
+    const remainingMinutes = minutes % 60;
+    return remainingMinutes > 0 ? `${hours}h ${remainingMinutes}m` : `${hours}h`;
+}
+/**
+ * Gets the title for the event
+ */
+function getEventTitle(event) {
+    switch (event) {
+        case "completed":
+            return "Job Completed";
+        case "failed":
+            return "Job Failed";
+        case "timeout":
+            return "Job Timed Out";
+        case "cancelled":
+            return "Job Cancelled";
+        default:
+            return "Job Event";
+    }
+}
+/**
+ * Gets the fallback text for the event (plain text for notifications)
+ */
+function getEventFallback(event, agentName) {
+    switch (event) {
+        case "completed":
+            return `Job completed for ${agentName}`;
+        case "failed":
+            return `Job failed for ${agentName}`;
+        case "timeout":
+            return `Job timed out for ${agentName}`;
+        case "cancelled":
+            return `Job cancelled for ${agentName}`;
+        default:
+            return `Job event for ${agentName}`;
+    }
+}
+/**
+ * Builds a Slack attachment from the hook context
+ */
+function buildAttachment(context) {
+    const agentName = context.agent.name || context.agent.id;
+    const fields = [
+        {
+            title: "Agent",
+            value: agentName,
+            short: true,
+        },
+        {
+            title: "Job ID",
+            value: `\`${context.job.id}\``,
+            short: true,
+        },
+        {
+            title: "Duration",
+            value: formatDuration(context.job.durationMs),
+            short: true,
+        },
+    ];
+    // Add schedule name if present
+    if (context.job.scheduleName) {
+        fields.push({
+            title: "Schedule",
+            value: context.job.scheduleName,
+            short: true,
+        });
+    }
+    // Add error message if present
+    if (context.result.error) {
+        fields.push({
+            title: "Error",
+            value: `\`\`\`${truncateOutput(context.result.error, MAX_FIELD_LENGTH)}\`\`\``,
+            short: false,
+        });
+    }
+    // Add metadata JSON if present
+    if (context.metadata && Object.keys(context.metadata).length > 0) {
+        fields.push({
+            title: "Metadata",
+            value: `\`\`\`${truncateOutput(JSON.stringify(context.metadata, null, 2), MAX_FIELD_LENGTH)}\`\`\``,
+            short: false,
+        });
+    }
+    // Build the attachment with output in text field
+    const output = context.result.output.trim();
+    let text;
+    if (output && output.length > 0) {
+        text = truncateOutput(output, MAX_TEXT_LENGTH);
+    }
+    return {
+        color: EVENT_COLORS[context.event] ?? EVENT_COLORS.completed,
+        fallback: getEventFallback(context.event, agentName),
+        title: getEventTitle(context.event),
+        text,
+        fields,
+        footer: "herdctl",
+        ts: Math.floor(new Date(context.job.completedAt).getTime() / 1000),
+    };
+}
+/**
+ * SlackHookRunner posts job notifications to a Slack channel
+ *
+ * Uses the Slack Web API (chat.postMessage) with attachments for rich formatting.
+ *
+ * @example
+ * ```typescript
+ * const runner = new SlackHookRunner({ logger: console });
+ *
+ * const result = await runner.execute(
+ *   {
+ *     type: 'slack',
+ *     channel_id: 'C1234567890',
+ *     bot_token_env: 'SLACK_BOT_TOKEN'
+ *   },
+ *   hookContext
+ * );
+ * ```
+ */
+export class SlackHookRunner {
+    logger;
+    fetchFn;
+    constructor(options = {}) {
+        this.logger = options.logger ?? {
+            debug: () => { },
+            info: () => { },
+            warn: () => { },
+            error: () => { },
+        };
+        this.fetchFn = options.fetch ?? globalThis.fetch;
+    }
+    /**
+     * Execute a Slack hook with the given context
+     *
+     * @param config - Slack hook configuration
+     * @param context - Hook context to send in the notification
+     * @returns Promise resolving to the hook result
+     */
+    async execute(config, context) {
+        const startTime = Date.now();
+        this.logger.debug(`Executing Slack hook for channel: ${config.channel_id}`);
+        // Read bot token from environment variable
+        const tokenEnv = config.bot_token_env ?? "SLACK_BOT_TOKEN";
+        const botToken = process.env[tokenEnv];
+        if (!botToken) {
+            const durationMs = Date.now() - startTime;
+            const errorMessage = `Slack bot token not found in environment variable: ${tokenEnv}`;
+            this.logger.error(errorMessage);
+            return {
+                success: false,
+                hookType: "slack",
+                durationMs,
+                error: errorMessage,
+            };
+        }
+        try {
+            // Build the Slack attachment
+            const attachment = buildAttachment(context);
+            const payload = {
+                channel: config.channel_id,
+                attachments: [attachment],
+            };
+            // Slack Web API endpoint for posting messages
+            const url = "https://slack.com/api/chat.postMessage";
+            // Create abort controller for timeout
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT);
+            try {
+                const response = await this.fetchFn(url, {
+                    method: "POST",
+                    headers: {
+                        "Content-Type": "application/json; charset=utf-8",
+                        Authorization: `Bearer ${botToken}`,
+                    },
+                    body: JSON.stringify(payload),
+                    signal: controller.signal,
+                });
+                clearTimeout(timeoutId);
+                const durationMs = Date.now() - startTime;
+                // Read response body
+                let responseBody;
+                try {
+                    responseBody = await response.text();
+                }
+                catch {
+                    // Ignore response body read errors
+                }
+                // Slack API always returns 200 with ok: true/false in body
+                if (response.ok && responseBody) {
+                    try {
+                        const json = JSON.parse(responseBody);
+                        if (json.ok) {
+                            this.logger.info(`Slack hook completed successfully in ${durationMs}ms: channel ${config.channel_id}`);
+                            return {
+                                success: true,
+                                hookType: "slack",
+                                durationMs,
+                                output: responseBody,
+                            };
+                        }
+                        else {
+                            // Slack API error (ok: false)
+                            const errorDetail = `Slack API error: ${json.error || "unknown"}`;
+                            this.logger.warn(`Slack hook failed: ${errorDetail}`);
+                            return {
+                                success: false,
+                                hookType: "slack",
+                                durationMs,
+                                error: errorDetail,
+                                output: responseBody,
+                            };
+                        }
+                    }
+                    catch {
+                        // JSON parse error
+                        const errorDetail = `Failed to parse Slack API response`;
+                        this.logger.warn(`Slack hook failed: ${errorDetail}`);
+                        return {
+                            success: false,
+                            hookType: "slack",
+                            durationMs,
+                            error: errorDetail,
+                            output: responseBody,
+                        };
+                    }
+                }
+                else {
+                    // HTTP error
+                    const errorDetail = `HTTP ${response.status}: ${response.statusText}`;
+                    this.logger.warn(`Slack hook failed with status ${response.status}: ${errorDetail}`);
+                    return {
+                        success: false,
+                        hookType: "slack",
+                        durationMs,
+                        error: errorDetail,
+                        output: responseBody,
+                    };
+                }
+            }
+            catch (fetchError) {
+                clearTimeout(timeoutId);
+                const durationMs = Date.now() - startTime;
+                // Handle abort (timeout)
+                if (fetchError instanceof Error && fetchError.name === "AbortError") {
+                    this.logger.error(`Slack hook timed out after ${DEFAULT_TIMEOUT}ms`);
+                    return {
+                        success: false,
+                        hookType: "slack",
+                        durationMs,
+                        error: `Slack hook timed out after ${DEFAULT_TIMEOUT}ms`,
+                    };
+                }
+                // Handle other fetch errors (network errors, etc.)
+                const errorMessage = fetchError instanceof Error ? fetchError.message : String(fetchError);
+                this.logger.error(`Slack hook error: ${errorMessage}`);
+                return {
+                    success: false,
+                    hookType: "slack",
+                    durationMs,
+                    error: errorMessage,
+                };
+            }
+        }
+        catch (error) {
+            const durationMs = Date.now() - startTime;
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.logger.error(`Slack hook error: ${errorMessage}`);
+            return {
+                success: false,
+                hookType: "slack",
+                durationMs,
+                error: errorMessage,
+            };
+        }
+    }
+}
+//# sourceMappingURL=slack.js.map

package/dist/hooks/runners/slack.js.map

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

package/dist/hooks/types.d.ts

@@ -8,9 +8,9 @@
  * are defined in config/schema.ts and exported from config/index.ts.
  * This file contains only runtime types not derived from Zod schemas.
  */
-import type { HookEvent, HookConfig, ShellHookConfig, WebhookHookConfig, DiscordHookConfig, AgentHooks, ShellHookConfigInput, WebhookHookConfigInput, DiscordHookConfigInput, HookConfigInput } from "../config/schema.js";
-export type { HookEvent, HookConfig, ShellHookConfig, WebhookHookConfig, DiscordHookConfig };
-export type { ShellHookConfigInput, WebhookHookConfigInput, DiscordHookConfigInput, HookConfigInput };
+import type { HookEvent, HookConfig, ShellHookConfig, WebhookHookConfig, DiscordHookConfig, SlackHookConfig, AgentHooks, ShellHookConfigInput, WebhookHookConfigInput, DiscordHookConfigInput, SlackHookConfigInput, HookConfigInput } from "../config/schema.js";
+export type { HookEvent, HookConfig, ShellHookConfig, WebhookHookConfig, DiscordHookConfig, SlackHookConfig };
+export type { ShellHookConfigInput, WebhookHookConfigInput, DiscordHookConfigInput, SlackHookConfigInput, HookConfigInput };
 /**
  * Context payload passed to all hooks
  *
@@ -136,7 +136,7 @@ export interface HookResult {
     /**
      * Hook type that was executed
      */
-    hookType: "shell" | "webhook" | "discord";
+    hookType: "shell" | "webhook" | "discord" | "slack";
     /**
      * Duration of hook execution in milliseconds
      */

package/dist/hooks/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/hooks/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EAEV,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EAChB,MAAM,qBAAqB,CAAC;AAI7B,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,CAAC;AAC7F,YAAY,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,eAAe,EAAE,CAAC;AAMtG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IAEjB;;OAEG;IACH,GAAG,EAAE;QACH;;WAEG;QACH,EAAE,EAAE,MAAM,CAAC;QAEX;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,YAAY,CAAC,EAAE,MAAM,CAAC;QAEtB;;WAEG;QACH,SAAS,EAAE,MAAM,CAAC;QAElB;;WAEG;QACH,WAAW,EAAE,MAAM,CAAC;QAEpB;;WAEG;QACH,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF;;OAEG;IACH,MAAM,EAAE;QACN;;WAEG;QACH,OAAO,EAAE,OAAO,CAAC;QAEjB;;WAEG;QACH,MAAM,EAAE,MAAM,CAAC;QAEf;;WAEG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF;;OAEG;IACH,KAAK,EAAE;QACL;;WAEG;QACH,EAAE,EAAE,MAAM,CAAC;QAEX;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IAEF;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAMD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IAE1C;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC;CACzB;AAMD;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC;AAM1C;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACxE"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/hooks/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,UAAU,EAEV,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EAChB,MAAM,qBAAqB,CAAC;AAI7B,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,CAAC;AAC9G,YAAY,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,eAAe,EAAE,CAAC;AAM5H;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IAEjB;;OAEG;IACH,GAAG,EAAE;QACH;;WAEG;QACH,EAAE,EAAE,MAAM,CAAC;QAEX;;WAEG;QACH,OAAO,EAAE,MAAM,CAAC;QAEhB;;WAEG;QACH,YAAY,CAAC,EAAE,MAAM,CAAC;QAEtB;;WAEG;QACH,SAAS,EAAE,MAAM,CAAC;QAElB;;WAEG;QACH,WAAW,EAAE,MAAM,CAAC;QAEpB;;WAEG;QACH,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IAEF;;OAEG;IACH,MAAM,EAAE;QACN;;WAEG;QACH,OAAO,EAAE,OAAO,CAAC;QAEjB;;WAEG;QACH,MAAM,EAAE,MAAM,CAAC;QAEf;;WAEG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF;;OAEG;IACH,KAAK,EAAE;QACL;;WAEG;QACH,EAAE,EAAE,MAAM,CAAC;QAEX;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IAEF;;;;;;;;;;;;;;;;;OAiBG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAMD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IAEpD;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,EAAE,CAAC;CACzB;AAMD;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC;AAM1C;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACxE"}

package/dist/runner/__tests__/file-sender-mcp.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=file-sender-mcp.test.d.ts.map

package/dist/runner/__tests__/file-sender-mcp.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-sender-mcp.test.d.ts","sourceRoot":"","sources":["../../../src/runner/__tests__/file-sender-mcp.test.ts"],"names":[],"mappings":""}

package/dist/runner/__tests__/file-sender-mcp.test.js

@@ -0,0 +1,177 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { resolve, join } from "node:path";
+// Mock node:fs/promises
+vi.mock("node:fs/promises", () => ({
+    readFile: vi.fn(),
+    realpath: vi.fn(),
+}));
+import { createFileSenderDef } from "../file-sender-mcp.js";
+import { readFile, realpath } from "node:fs/promises";
+// =============================================================================
+// Helpers
+// =============================================================================
+function createTestContext(overrides = {}) {
+    return {
+        workingDirectory: "/workspace",
+        uploadFile: vi.fn().mockResolvedValue({ fileId: "F12345" }),
+        ...overrides,
+    };
+}
+/**
+ * Extract the tool handler from the def's first tool.
+ */
+function getToolHandler(context) {
+    const def = createFileSenderDef(context);
+    return def.tools[0].handler;
+}
+// =============================================================================
+// Tests
+// =============================================================================
+describe("createFileSenderDef", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it("returns a def with the correct server name", () => {
+        const context = createTestContext();
+        const def = createFileSenderDef(context);
+        expect(def.name).toBe("herdctl-file-sender");
+    });
+    it("defines a single herdctl_send_file tool", () => {
+        const context = createTestContext();
+        const def = createFileSenderDef(context);
+        expect(def.tools).toHaveLength(1);
+        expect(def.tools[0].name).toBe("herdctl_send_file");
+    });
+    it("includes file_path as a required property in the input schema", () => {
+        const context = createTestContext();
+        const def = createFileSenderDef(context);
+        const schema = def.tools[0].inputSchema;
+        expect(schema.required).toContain("file_path");
+        expect(schema.properties).toHaveProperty("file_path");
+    });
+});
+describe("herdctl_send_file tool handler", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        // By default, realpath acts as identity (no symlinks)
+        vi.mocked(realpath).mockImplementation(async (p) => String(p));
+    });
+    it("uploads a file within the working directory", async () => {
+        const context = createTestContext();
+        const handler = getToolHandler(context);
+        const mockBuffer = Buffer.from("test content");
+        vi.mocked(readFile).mockResolvedValue(mockBuffer);
+        const result = await handler({ file_path: "report.pdf" });
+        expect(readFile).toHaveBeenCalledWith(resolve("/workspace", "report.pdf"));
+        expect(context.uploadFile).toHaveBeenCalledWith({
+            fileBuffer: mockBuffer,
+            filename: "report.pdf",
+            message: undefined,
+        });
+        expect(result.isError).toBeUndefined();
+        expect(result.content[0].text).toContain("uploaded successfully");
+        expect(result.content[0].text).toContain("F12345");
+    });
+    it("passes optional message to uploadFile", async () => {
+        const context = createTestContext();
+        const handler = getToolHandler(context);
+        vi.mocked(readFile).mockResolvedValue(Buffer.from("data"));
+        await handler({
+            file_path: "output.csv",
+            message: "Here is the CSV export",
+        });
+        expect(context.uploadFile).toHaveBeenCalledWith(expect.objectContaining({
+            message: "Here is the CSV export",
+        }));
+    });
+    it("uses filename override when provided", async () => {
+        const context = createTestContext();
+        const handler = getToolHandler(context);
+        vi.mocked(readFile).mockResolvedValue(Buffer.from("data"));
+        await handler({
+            file_path: "tmp/abc123.pdf",
+            filename: "quarterly-report.pdf",
+        });
+        expect(context.uploadFile).toHaveBeenCalledWith(expect.objectContaining({
+            filename: "quarterly-report.pdf",
+        }));
+    });
+    it("rejects paths that escape the working directory with ../", async () => {
+        const context = createTestContext();
+        const handler = getToolHandler(context);
+        const result = await handler({
+            file_path: "../../../etc/passwd",
+        });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain("escapes working directory");
+        expect(context.uploadFile).not.toHaveBeenCalled();
+        expect(readFile).not.toHaveBeenCalled();
+    });
+    it("rejects absolute paths outside working directory", async () => {
+        const context = createTestContext();
+        const handler = getToolHandler(context);
+        const result = await handler({
+            file_path: "/etc/passwd",
+        });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain("escapes working directory");
+        expect(context.uploadFile).not.toHaveBeenCalled();
+    });
+    it("rejects symlinks that resolve outside the working directory", async () => {
+        const context = createTestContext();
+        const handler = getToolHandler(context);
+        // Simulate a symlink: /workspace/link.txt -> /etc/passwd
+        vi.mocked(realpath).mockImplementation(async (p) => {
+            const s = String(p);
+            if (s === resolve("/workspace", "link.txt"))
+                return "/etc/passwd";
+            return s;
+        });
+        const result = await handler({ file_path: "link.txt" });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain("escapes working directory");
+        expect(context.uploadFile).not.toHaveBeenCalled();
+        expect(readFile).not.toHaveBeenCalled();
+    });
+    it("allows absolute paths within the working directory", async () => {
+        const context = createTestContext();
+        const handler = getToolHandler(context);
+        vi.mocked(readFile).mockResolvedValue(Buffer.from("data"));
+        const result = await handler({
+            file_path: "/workspace/subdir/file.txt",
+        });
+        expect(result.isError).toBeUndefined();
+        expect(context.uploadFile).toHaveBeenCalled();
+    });
+    it("allows nested relative paths within working directory", async () => {
+        const context = createTestContext();
+        const handler = getToolHandler(context);
+        vi.mocked(readFile).mockResolvedValue(Buffer.from("data"));
+        const result = await handler({
+            file_path: "subdir/deep/file.txt",
+        });
+        expect(result.isError).toBeUndefined();
+        expect(readFile).toHaveBeenCalledWith(join("/workspace", "subdir/deep/file.txt"));
+    });
+    it("returns error when file does not exist (realpath ENOENT)", async () => {
+        const context = createTestContext();
+        const handler = getToolHandler(context);
+        vi.mocked(realpath).mockRejectedValue(new Error("ENOENT: no such file or directory"));
+        const result = await handler({ file_path: "nonexistent.pdf" });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain("file not found");
+        expect(readFile).not.toHaveBeenCalled();
+    });
+    it("returns error when upload fails", async () => {
+        const uploadFile = vi
+            .fn()
+            .mockRejectedValue(new Error("Slack API error: file_too_large"));
+        const context = createTestContext({ uploadFile });
+        const handler = getToolHandler(context);
+        vi.mocked(readFile).mockResolvedValue(Buffer.from("data"));
+        const result = await handler({ file_path: "huge-file.zip" });
+        expect(result.isError).toBe(true);
+        expect(result.content[0].text).toContain("file_too_large");
+    });
+});
+//# sourceMappingURL=file-sender-mcp.test.js.map