@herdctl/core 0.0.1

package/dist/runner/job-executor.js

@@ -0,0 +1,333 @@
+/**
+ * Job executor for running agents with streaming output to job logs
+ *
+ * Manages the lifecycle of agent execution including:
+ * - Creating job records before execution
+ * - Streaming all SDK messages to job output in real-time
+ * - Updating job status and metadata on completion
+ */
+import { join } from "node:path";
+import { SDKInitializationError, SDKStreamingError, MalformedResponseError, wrapError, classifyError, buildErrorMessage, } from "./errors.js";
+import { toSDKOptions } from "./sdk-adapter.js";
+import { processSDKMessage, isTerminalMessage, extractSummary, } from "./message-processor.js";
+import { createJob, updateJob, appendJobOutput, getJobOutputPath, updateSessionInfo, getSessionInfo, } from "../state/index.js";
+// =============================================================================
+// Default Logger
+// =============================================================================
+const defaultLogger = {
+    warn: (message) => console.warn(`[herdctl] ${message}`),
+    error: (message) => console.error(`[herdctl] ${message}`),
+    info: (message) => console.info(`[herdctl] ${message}`),
+};
+// =============================================================================
+// Job Executor Class
+// =============================================================================
+/**
+ * Executes agents with streaming output to job logs
+ *
+ * This class manages the complete lifecycle of agent execution:
+ * 1. Creates a job record before starting
+ * 2. Updates job status to 'running'
+ * 3. Streams all SDK messages to job output in real-time
+ * 4. Updates job with final status on completion
+ *
+ * @example
+ * ```typescript
+ * const executor = new JobExecutor(sdkQuery);
+ *
+ * const result = await executor.execute({
+ *   agent: resolvedAgent,
+ *   prompt: "Fix the bug in auth.ts",
+ *   stateDir: "/path/to/.herdctl",
+ *   triggerType: "manual",
+ * });
+ *
+ * console.log(`Job ${result.jobId} completed: ${result.success}`);
+ * ```
+ */
+export class JobExecutor {
+    sdkQuery;
+    logger;
+    /**
+     * Create a new job executor
+     *
+     * @param sdkQuery - The SDK query function to use for agent execution
+     * @param options - Optional configuration
+     */
+    constructor(sdkQuery, options = {}) {
+        this.sdkQuery = sdkQuery;
+        this.logger = options.logger ?? defaultLogger;
+    }
+    /**
+     * Execute an agent and stream output to job log
+     *
+     * @param options - Runner options including agent config and prompt
+     * @returns Result of the execution including job ID and status
+     */
+    async execute(options) {
+        const { agent, prompt, stateDir, triggerType, schedule, onMessage } = options;
+        const jobsDir = join(stateDir, "jobs");
+        let job;
+        let sessionId;
+        let summary;
+        let lastError;
+        let errorDetails;
+        let messagesReceived = 0;
+        // Determine trigger type: use 'fork' if forking, otherwise use provided or default to 'manual'
+        const effectiveTriggerType = options.fork
+            ? "fork"
+            : (triggerType ?? "manual");
+        // Step 1: Create job record
+        try {
+            job = await createJob(jobsDir, {
+                agent: agent.name,
+                trigger_type: effectiveTriggerType,
+                prompt,
+                schedule,
+                forked_from: options.fork ? options.forkedFrom : undefined,
+            });
+            this.logger.info?.(`Created job ${job.id} for agent ${agent.name}`);
+        }
+        catch (error) {
+            this.logger.error(`Failed to create job: ${error.message}`);
+            throw error;
+        }
+        // Step 2: Update job status to 'running'
+        try {
+            await updateJob(jobsDir, job.id, {
+                status: "running",
+            });
+        }
+        catch (error) {
+            this.logger.warn(`Failed to update job status to running: ${error.message}`);
+            // Continue execution - job was created
+        }
+        // Step 3: Build SDK options
+        const sdkOptions = toSDKOptions(agent, {
+            resume: options.resume,
+            fork: options.fork ? true : undefined,
+        });
+        // Step 4: Execute agent and stream output
+        try {
+            let messages;
+            // Catch SDK initialization errors (e.g., missing API key)
+            try {
+                messages = this.sdkQuery({
+                    prompt,
+                    options: sdkOptions,
+                });
+            }
+            catch (initError) {
+                // Wrap initialization errors with context
+                throw new SDKInitializationError(buildErrorMessage(initError.message, {
+                    jobId: job.id,
+                    agentName: agent.name,
+                }), {
+                    jobId: job.id,
+                    agentName: agent.name,
+                    cause: initError,
+                });
+            }
+            for await (const sdkMessage of messages) {
+                messagesReceived++;
+                // Process the message safely (handles malformed responses)
+                let processed;
+                try {
+                    processed = processSDKMessage(sdkMessage);
+                }
+                catch (processError) {
+                    // Log but don't crash on malformed messages
+                    this.logger.warn(`Malformed SDK message received: ${processError.message}`);
+                    // Write a warning to job output
+                    try {
+                        await appendJobOutput(jobsDir, job.id, {
+                            type: "error",
+                            message: `Malformed SDK message: ${processError.message}`,
+                            code: "MALFORMED_MESSAGE",
+                        });
+                    }
+                    catch {
+                        // Ignore output write failures for malformed message warnings
+                    }
+                    // Continue processing other messages
+                    continue;
+                }
+                // Write to job output immediately (no buffering)
+                try {
+                    await appendJobOutput(jobsDir, job.id, processed.output);
+                }
+                catch (outputError) {
+                    this.logger.warn(`Failed to write job output: ${outputError.message}`);
+                    // Continue processing - don't fail execution due to logging issues
+                }
+                // Extract session ID if present
+                if (processed.sessionId) {
+                    sessionId = processed.sessionId;
+                }
+                // Extract summary if present
+                const messageSummary = extractSummary(sdkMessage);
+                if (messageSummary) {
+                    summary = messageSummary;
+                }
+                // Call user's onMessage callback if provided
+                if (onMessage) {
+                    try {
+                        await onMessage(sdkMessage);
+                    }
+                    catch (callbackError) {
+                        this.logger.warn(`onMessage callback error: ${callbackError.message}`);
+                    }
+                }
+                // Check for terminal messages
+                if (isTerminalMessage(sdkMessage)) {
+                    if (sdkMessage.type === "error") {
+                        const errorMessage = sdkMessage.message ?? "Agent execution failed";
+                        lastError = new SDKStreamingError(buildErrorMessage(errorMessage, {
+                            jobId: job.id,
+                            agentName: agent.name,
+                        }), {
+                            jobId: job.id,
+                            agentName: agent.name,
+                            code: sdkMessage.code,
+                            messagesReceived,
+                        });
+                    }
+                    break;
+                }
+            }
+        }
+        catch (error) {
+            // Wrap the error with context if not already a RunnerError
+            lastError = wrapError(error, {
+                jobId: job.id,
+                agentName: agent.name,
+                phase: messagesReceived === 0 ? "init" : "streaming",
+            });
+            // Add messages received count for streaming errors
+            if (lastError instanceof SDKStreamingError && messagesReceived > 0) {
+                lastError.messagesReceived = messagesReceived;
+            }
+            // Log the error with context
+            this.logger.error(`${lastError.name}: ${lastError.message}`);
+            // Write error to job output with full context
+            try {
+                await appendJobOutput(jobsDir, job.id, {
+                    type: "error",
+                    message: lastError.message,
+                    code: lastError.code ?? lastError.cause?.code,
+                    stack: lastError.stack,
+                });
+            }
+            catch (outputError) {
+                this.logger.warn(`Failed to write error to job output: ${outputError.message}`);
+            }
+        }
+        // Build error details for programmatic access
+        if (lastError) {
+            errorDetails = {
+                message: lastError.message,
+                code: lastError.code ??
+                    lastError.cause?.code,
+                stack: lastError.stack,
+            };
+            // Determine error type
+            if (lastError instanceof SDKInitializationError) {
+                errorDetails.type = "initialization";
+                errorDetails.recoverable = lastError.isNetworkError();
+            }
+            else if (lastError instanceof SDKStreamingError) {
+                errorDetails.type = "streaming";
+                errorDetails.recoverable = lastError.isRecoverable();
+                errorDetails.messagesReceived = lastError.messagesReceived;
+            }
+            else if (lastError instanceof MalformedResponseError) {
+                errorDetails.type = "malformed_response";
+                errorDetails.recoverable = false;
+            }
+            else {
+                errorDetails.type = "unknown";
+                errorDetails.recoverable = false;
+            }
+        }
+        // Step 5: Update job with final status
+        const success = !lastError;
+        const finishedAt = new Date().toISOString();
+        // Determine exit reason based on error classification
+        const exitReason = success ? "success" : classifyError(lastError);
+        try {
+            await updateJob(jobsDir, job.id, {
+                status: success ? "completed" : "failed",
+                finished_at: finishedAt,
+                session_id: sessionId,
+                summary,
+                exit_reason: exitReason,
+                output_file: getJobOutputPath(jobsDir, job.id),
+            });
+        }
+        catch (error) {
+            this.logger.warn(`Failed to update job final status: ${error.message}`);
+        }
+        // Step 6: Persist session info for resume capability
+        if (sessionId) {
+            try {
+                const sessionsDir = join(stateDir, "sessions");
+                // Get existing session to determine if updating or creating
+                const existingSession = await getSessionInfo(sessionsDir, agent.name);
+                await updateSessionInfo(sessionsDir, agent.name, {
+                    session_id: sessionId,
+                    job_count: (existingSession?.job_count ?? 0) + 1,
+                    mode: existingSession?.mode ?? "autonomous",
+                });
+                this.logger.info?.(`Persisted session ${sessionId} for agent ${agent.name}`);
+            }
+            catch (sessionError) {
+                this.logger.warn(`Failed to persist session info: ${sessionError.message}`);
+                // Continue - session persistence is non-fatal
+            }
+        }
+        // Calculate duration
+        const startTime = new Date(job.started_at).getTime();
+        const endTime = new Date(finishedAt).getTime();
+        const durationSeconds = Math.round((endTime - startTime) / 1000);
+        return {
+            success,
+            jobId: job.id,
+            sessionId,
+            summary,
+            error: lastError,
+            errorDetails,
+            durationSeconds,
+        };
+    }
+}
+// =============================================================================
+// Convenience Function
+// =============================================================================
+/**
+ * Execute an agent with streaming output to job log
+ *
+ * This is a convenience function that creates a JobExecutor and runs
+ * a single execution. For multiple executions, prefer creating a
+ * JobExecutor instance directly.
+ *
+ * @param sdkQuery - The SDK query function
+ * @param options - Runner options including agent config and prompt
+ * @param executorOptions - Optional executor configuration
+ * @returns Result of the execution
+ *
+ * @example
+ * ```typescript
+ * import { query } from "@anthropic-ai/claude-agent-sdk";
+ *
+ * const result = await executeJob(query, {
+ *   agent: resolvedAgent,
+ *   prompt: "Fix the bug",
+ *   stateDir: "/path/to/.herdctl",
+ * });
+ * ```
+ */
+export async function executeJob(sdkQuery, options, executorOptions = {}) {
+    const executor = new JobExecutor(sdkQuery, executorOptions);
+    return executor.execute(options);
+}
+//# sourceMappingURL=job-executor.js.map

package/dist/runner/job-executor.js.map

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

package/dist/runner/message-processor.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Message processor for transforming SDK messages to job output format
+ *
+ * Handles all Claude SDK message types and converts them to the format
+ * expected by the job output logging system. Includes robust handling
+ * of malformed or unexpected SDK responses.
+ */
+import type { SDKMessage, ProcessedMessage } from "./types.js";
+/**
+ * Process an SDK message into job output format
+ *
+ * Takes a message from the Claude Agent SDK and transforms it into
+ * the format expected by the job output logging system. This function
+ * handles malformed responses gracefully without crashing.
+ *
+ * @param message - The SDK message to process
+ * @returns Processed message with output and optional metadata
+ *
+ * @example
+ * ```typescript
+ * const sdkMessage = { type: "assistant", content: "Hello!" };
+ * const { output, sessionId } = processSDKMessage(sdkMessage);
+ * await appendJobOutput(jobsDir, jobId, output);
+ * ```
+ */
+export declare function processSDKMessage(message: SDKMessage): ProcessedMessage;
+/**
+ * Check if a message indicates the end of execution
+ *
+ * @param message - The SDK message to check
+ * @returns true if this is a terminal message
+ */
+export declare function isTerminalMessage(message: SDKMessage): boolean;
+/**
+ * Extract the final summary from a message if present
+ *
+ * Looks for summaries in the following order:
+ * 1. Explicit `summary` field on the message (truncated to 500 chars)
+ * 2. Short assistant message content (≤500 chars, non-partial)
+ *
+ * @param message - The SDK message to extract summary from
+ * @returns Summary string if present, undefined otherwise
+ */
+export declare function extractSummary(message: SDKMessage): string | undefined;
+//# sourceMappingURL=message-processor.d.ts.map

package/dist/runner/message-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-processor.d.ts","sourceRoot":"","sources":["../../src/runner/message-processor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAmM/D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,gBAAgB,CAwDvE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAwB9D;AAeD;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAqBtE"}

package/dist/runner/message-processor.js

@@ -0,0 +1,294 @@
+/**
+ * Message processor for transforming SDK messages to job output format
+ *
+ * Handles all Claude SDK message types and converts them to the format
+ * expected by the job output logging system. Includes robust handling
+ * of malformed or unexpected SDK responses.
+ */
+// =============================================================================
+// Validation Helpers
+// =============================================================================
+/**
+ * Safely extract a string value from an unknown field
+ */
+function safeString(value) {
+    if (typeof value === "string") {
+        return value;
+    }
+    if (value === null || value === undefined) {
+        return undefined;
+    }
+    // Convert other types to string for safety
+    try {
+        return String(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Safely extract a boolean value from an unknown field
+ */
+function safeBoolean(value) {
+    if (typeof value === "boolean") {
+        return value;
+    }
+    return undefined;
+}
+/**
+ * Check if a value is a valid SDK message type
+ */
+function isValidMessageType(type) {
+    return (type === "system" ||
+        type === "assistant" ||
+        type === "tool_use" ||
+        type === "tool_result" ||
+        type === "error");
+}
+// =============================================================================
+// Message Type Handlers
+// =============================================================================
+/**
+ * Process a system message from the SDK
+ *
+ * Session ID is specifically extracted from messages with subtype "init",
+ * as this is when the Claude SDK provides the session identifier.
+ */
+function processSystemMessage(message) {
+    const output = {
+        type: "system",
+    };
+    if (message.content) {
+        output.content = message.content;
+    }
+    if (message.subtype) {
+        output.subtype = message.subtype;
+    }
+    // Extract session ID specifically from init messages
+    // The Claude SDK provides session_id in the system message with subtype "init"
+    const sessionId = message.subtype === "init" ? message.session_id : undefined;
+    return {
+        output,
+        sessionId,
+    };
+}
+/**
+ * Process an assistant message from the SDK
+ */
+function processAssistantMessage(message) {
+    const output = {
+        type: "assistant",
+    };
+    if (message.content !== undefined) {
+        output.content = message.content;
+    }
+    if (message.partial !== undefined) {
+        output.partial = message.partial;
+    }
+    // Handle usage statistics
+    if (message.usage) {
+        const usage = message.usage;
+        output.usage = {};
+        if (usage.input_tokens !== undefined) {
+            output.usage.input_tokens = usage.input_tokens;
+        }
+        if (usage.output_tokens !== undefined) {
+            output.usage.output_tokens = usage.output_tokens;
+        }
+    }
+    return { output };
+}
+/**
+ * Process a tool use message from the SDK
+ */
+function processToolUseMessage(message) {
+    // Tool name is required - try multiple possible field names
+    const toolName = message.tool_name ?? message.name ?? "unknown";
+    const output = {
+        type: "tool_use",
+        tool_name: toolName,
+    };
+    if (message.tool_use_id) {
+        output.tool_use_id = message.tool_use_id;
+    }
+    if (message.input !== undefined) {
+        output.input = message.input;
+    }
+    return { output };
+}
+/**
+ * Process a tool result message from the SDK
+ */
+function processToolResultMessage(message) {
+    const output = {
+        type: "tool_result",
+    };
+    if (message.tool_use_id) {
+        output.tool_use_id = message.tool_use_id;
+    }
+    if (message.result !== undefined) {
+        output.result = message.result;
+    }
+    if (message.success !== undefined) {
+        output.success = message.success;
+    }
+    if (message.error !== undefined) {
+        output.error = message.error;
+    }
+    return { output };
+}
+/**
+ * Process an error message from the SDK
+ */
+function processErrorMessage(message) {
+    const output = {
+        type: "error",
+        message: message.message ?? "Unknown error",
+    };
+    if (message.code) {
+        output.code = message.code;
+    }
+    if (message.stack) {
+        output.stack = message.stack;
+    }
+    return {
+        output,
+        isFinal: true,
+    };
+}
+// =============================================================================
+// Main Processing Function
+// =============================================================================
+/**
+ * Process an SDK message into job output format
+ *
+ * Takes a message from the Claude Agent SDK and transforms it into
+ * the format expected by the job output logging system. This function
+ * handles malformed responses gracefully without crashing.
+ *
+ * @param message - The SDK message to process
+ * @returns Processed message with output and optional metadata
+ *
+ * @example
+ * ```typescript
+ * const sdkMessage = { type: "assistant", content: "Hello!" };
+ * const { output, sessionId } = processSDKMessage(sdkMessage);
+ * await appendJobOutput(jobsDir, jobId, output);
+ * ```
+ */
+export function processSDKMessage(message) {
+    // Handle null/undefined messages - log as system warning, not error
+    // to avoid terminating execution due to malformed SDK responses
+    if (message === null || message === undefined) {
+        return {
+            output: {
+                type: "system",
+                content: "Received null or undefined SDK message",
+                subtype: "malformed_message",
+            },
+        };
+    }
+    // Handle non-object messages - log as system warning
+    if (typeof message !== "object") {
+        return {
+            output: {
+                type: "system",
+                content: `Expected object message, received ${typeof message}`,
+                subtype: "malformed_message",
+            },
+        };
+    }
+    // Validate message type
+    const messageType = message.type;
+    if (!isValidMessageType(messageType)) {
+        // Handle unknown or missing message types gracefully
+        const unknownType = safeString(messageType) ?? "undefined";
+        return {
+            output: {
+                type: "system",
+                content: `Unknown message type: ${unknownType}`,
+                subtype: "unknown_type",
+            },
+        };
+    }
+    // Process known message types
+    switch (messageType) {
+        case "system":
+            return processSystemMessage(message);
+        case "assistant":
+            return processAssistantMessage(message);
+        case "tool_use":
+            return processToolUseMessage(message);
+        case "tool_result":
+            return processToolResultMessage(message);
+        case "error":
+            return processErrorMessage(message);
+    }
+}
+/**
+ * Check if a message indicates the end of execution
+ *
+ * @param message - The SDK message to check
+ * @returns true if this is a terminal message
+ */
+export function isTerminalMessage(message) {
+    // Handle null/undefined/non-object messages - these are not terminal
+    if (message === null || message === undefined || typeof message !== "object") {
+        return false;
+    }
+    // Error messages are terminal
+    if (message.type === "error") {
+        return true;
+    }
+    // System messages with certain subtypes indicate completion
+    if (message.type === "system") {
+        const subtype = message.subtype;
+        if (subtype === "end" ||
+            subtype === "complete" ||
+            subtype === "session_end") {
+            return true;
+        }
+    }
+    return false;
+}
+/** Maximum summary length in characters */
+const MAX_SUMMARY_LENGTH = 500;
+/**
+ * Truncate a string to maximum length, adding ellipsis if truncated
+ */
+function truncateSummary(text) {
+    if (text.length <= MAX_SUMMARY_LENGTH) {
+        return text;
+    }
+    return text.slice(0, MAX_SUMMARY_LENGTH - 3) + "...";
+}
+/**
+ * Extract the final summary from a message if present
+ *
+ * Looks for summaries in the following order:
+ * 1. Explicit `summary` field on the message (truncated to 500 chars)
+ * 2. Short assistant message content (≤500 chars, non-partial)
+ *
+ * @param message - The SDK message to extract summary from
+ * @returns Summary string if present, undefined otherwise
+ */
+export function extractSummary(message) {
+    // Handle null/undefined/non-object messages
+    if (message === null || message === undefined || typeof message !== "object") {
+        return undefined;
+    }
+    // Check for explicit summary field (truncate if too long)
+    if (message.summary) {
+        const summaryStr = String(message.summary);
+        return truncateSummary(summaryStr);
+    }
+    // For assistant messages, use content as potential summary
+    if (message.type === "assistant" && message.content && !message.partial) {
+        // Only use if it looks like a conclusion (short enough)
+        if (message.content.length <= MAX_SUMMARY_LENGTH) {
+            return message.content;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=message-processor.js.map