@northflare/runner 0.0.1

package/dist/utils/expand-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand-env.js","sourceRoot":"","sources":["../../src/utils/expand-env.ts"],"names":[],"mappings":";;AAAA,8BAqBC;AArBD,SAAgB,SAAS,CACvB,GAAQ,EACR,MAA0C,OAAO,CAAC,GAAG;IAErD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,MAAM,GAAwB,EAAE,CAAC;QACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/C,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Logger configuration using Winston
+ */
+import winston from "winston";
+export declare const logger: winston.Logger;
+export declare function configureFileLogging(logDir: string): void;
+export declare function createLogger(component: string): winston.Logger;
+export default logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAwD9B,eAAO,MAAM,MAAM,gBAUjB,CAAC;AAGH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAkCzD;AAGD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAE9D;AAkBD,eAAe,MAAM,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,108 @@
+"use strict";
+/**
+ * Logger configuration using Winston
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+exports.configureFileLogging = configureFileLogging;
+exports.createLogger = createLogger;
+const winston_1 = __importDefault(require("winston"));
+const path_1 = __importDefault(require("path"));
+// Custom log levels
+const levels = {
+    error: 0,
+    warn: 1,
+    info: 2,
+    http: 3,
+    verbose: 4,
+    debug: 5,
+    silly: 6,
+};
+// Log colors
+const colors = {
+    error: "red",
+    warn: "yellow",
+    info: "green",
+    http: "magenta",
+    verbose: "cyan",
+    debug: "blue",
+    silly: "gray",
+};
+winston_1.default.addColors(colors);
+// Format for console output
+const consoleFormat = winston_1.default.format.combine(winston_1.default.format.colorize({ all: true }), winston_1.default.format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), winston_1.default.format.printf(({ timestamp, level, message, stack, ...metadata }) => {
+    let msg = `${timestamp} [${level}]: ${message}`;
+    // Only show stack traces and metadata in debug mode
+    if (process.env["DEBUG"] === "true") {
+        if (stack) {
+            msg += `\n${stack}`;
+        }
+        const filteredMetadata = { ...metadata };
+        delete filteredMetadata["component"]; // Keep component info
+        if (Object.keys(filteredMetadata).length > 0) {
+            msg += ` ${JSON.stringify(filteredMetadata)}`;
+        }
+    }
+    return msg;
+}));
+// Format for file output
+const fileFormat = winston_1.default.format.combine(winston_1.default.format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), winston_1.default.format.errors({ stack: true }), winston_1.default.format.json());
+// Create logger instance
+exports.logger = winston_1.default.createLogger({
+    level: process.env["DEBUG"] === "true" ? "debug" : "info",
+    levels,
+    transports: [
+        // Always include console transport for errors
+        new winston_1.default.transports.Console({
+            format: consoleFormat,
+            level: process.env["DEBUG"] === "true" ? "debug" : "error",
+        }),
+    ],
+});
+// Add file transports if log directory is configured
+function configureFileLogging(logDir) {
+    // Error log file
+    exports.logger.add(new winston_1.default.transports.File({
+        filename: path_1.default.join(logDir, "error.log"),
+        level: "error",
+        format: fileFormat,
+        maxsize: 10 * 1024 * 1024, // 10MB
+        maxFiles: 5,
+    }));
+    // Combined log file
+    exports.logger.add(new winston_1.default.transports.File({
+        filename: path_1.default.join(logDir, "combined.log"),
+        format: fileFormat,
+        maxsize: 50 * 1024 * 1024, // 50MB
+        maxFiles: 10,
+    }));
+    // Debug log file (only in debug mode)
+    if (process.env["DEBUG"] === "true") {
+        exports.logger.add(new winston_1.default.transports.File({
+            filename: path_1.default.join(logDir, "debug.log"),
+            level: "debug",
+            format: fileFormat,
+            maxsize: 100 * 1024 * 1024, // 100MB
+            maxFiles: 3,
+        }));
+    }
+}
+// Create child logger for specific components
+function createLogger(component) {
+    return exports.logger.child({ component });
+}
+// Log unhandled errors
+exports.logger.exceptions.handle(new winston_1.default.transports.File({
+    filename: "exceptions.log",
+    format: fileFormat,
+}));
+exports.logger.rejections.handle(new winston_1.default.transports.File({
+    filename: "rejections.log",
+    format: fileFormat,
+}));
+// Export default logger
+exports.default = exports.logger;
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/dist/utils/status-line.d.ts

@@ -0,0 +1,37 @@
+/**
+ * StatusLineManager - Manages persistent status line output for active Claude Code processes
+ *
+ * This component maintains a single-line status output that updates every minute to show
+ * the count of active Claude Code processes. It prevents the machine from entering idle
+ * state while processes are running and provides clear visual feedback without cluttering
+ * the terminal with multiple log lines.
+ */
+export declare class StatusLineManager {
+    private intervalId?;
+    private activeCount;
+    private lastLine;
+    private isEnabled;
+    constructor();
+    /**
+     * Updates the count of active conversations
+     */
+    updateActiveCount(count: number): void;
+    /**
+     * Starts the status line interval
+     */
+    private startInterval;
+    /**
+     * Stops the status line interval
+     */
+    private stopInterval;
+    /**
+     * Shows the current status
+     */
+    private showStatus;
+    /**
+     * Cleans up the status line manager
+     */
+    dispose(): void;
+}
+export declare const statusLineManager: StatusLineManager;
+//# sourceMappingURL=status-line.d.ts.map

package/dist/utils/status-line.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-line.d.ts","sourceRoot":"","sources":["../../src/utils/status-line.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,UAAU,CAAC,CAAiB;IACpC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,SAAS,CAAiB;;IAOlC;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAetC;;OAEG;IACH,OAAO,CAAC,aAAa;IAqBrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAUpB;;OAEG;IACH,OAAO,CAAC,UAAU;IA6BlB;;OAEG;IACH,OAAO,IAAI,IAAI;CAOhB;AAGD,eAAO,MAAM,iBAAiB,mBAA0B,CAAC"}

package/dist/utils/status-line.js

@@ -0,0 +1,113 @@
+"use strict";
+/**
+ * StatusLineManager - Manages persistent status line output for active Claude Code processes
+ *
+ * This component maintains a single-line status output that updates every minute to show
+ * the count of active Claude Code processes. It prevents the machine from entering idle
+ * state while processes are running and provides clear visual feedback without cluttering
+ * the terminal with multiple log lines.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.statusLineManager = exports.StatusLineManager = void 0;
+class StatusLineManager {
+    intervalId;
+    activeCount = 0;
+    lastLine = "";
+    isEnabled = true;
+    constructor() {
+        // Only enable status line when not in debug mode
+        this.isEnabled = process.env["DEBUG"] !== "true";
+    }
+    /**
+     * Updates the count of active conversations
+     */
+    updateActiveCount(count) {
+        const wasZero = this.activeCount === 0;
+        const isZero = count === 0;
+        this.activeCount = count;
+        // Start interval when transitioning from 0 to active
+        if (wasZero && !isZero) {
+            this.startInterval();
+        }
+        // Stop interval when transitioning to 0
+        else if (!wasZero && isZero) {
+            this.stopInterval();
+        }
+    }
+    /**
+     * Starts the status line interval
+     */
+    startInterval() {
+        if (!this.isEnabled || this.intervalId)
+            return;
+        // Show initial status immediately
+        this.showStatus();
+        // Update every minute on the minute
+        const now = new Date();
+        const msUntilNextMinute = (60 - now.getSeconds()) * 1000 - now.getMilliseconds();
+        // First timeout to align with the minute
+        setTimeout(() => {
+            this.showStatus();
+            // Then set up regular interval
+            this.intervalId = setInterval(() => {
+                this.showStatus();
+            }, 60000); // Every 60 seconds
+        }, msUntilNextMinute);
+    }
+    /**
+     * Stops the status line interval
+     */
+    stopInterval() {
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = undefined;
+        }
+        // Show final "No active" message
+        this.showStatus();
+    }
+    /**
+     * Shows the current status
+     */
+    showStatus() {
+        if (!this.isEnabled)
+            return;
+        const now = new Date();
+        const timeStr = now.toTimeString().slice(0, 5); // HH:MM format
+        let newLine;
+        if (this.activeCount === 0) {
+            newLine = "No active Claude Code processes";
+        }
+        else if (this.activeCount === 1) {
+            newLine = `${timeStr} 1 active Claude Code process`;
+        }
+        else {
+            newLine = `${timeStr} ${this.activeCount} active Claude Code processes`;
+        }
+        // If this is the first status line, position it
+        if (!this.lastLine) {
+            // Move to start of line and save cursor position
+            process.stdout.write('\r');
+        }
+        else {
+            // Clear the current line
+            process.stdout.write('\r' + ' '.repeat(this.lastLine.length) + '\r');
+        }
+        // Write the new status without newline
+        process.stdout.write(newLine);
+        this.lastLine = newLine;
+    }
+    /**
+     * Cleans up the status line manager
+     */
+    dispose() {
+        this.stopInterval();
+        // Add a newline to ensure next output starts on a new line
+        if (this.lastLine) {
+            process.stdout.write('\n');
+        }
+    }
+}
+exports.StatusLineManager = StatusLineManager;
+// Singleton instance
+exports.statusLineManager = new StatusLineManager();
+//# sourceMappingURL=status-line.js.map

package/dist/utils/status-line.js.map

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

package/docs/claude-manager.md

@@ -0,0 +1,91 @@
+# ClaudeManager Implementation
+
+## Overview
+
+The `ClaudeManager` class is responsible for managing Claude conversations using the `claude-code-sdk-ts`. It provides stateful conversation lifecycle management, with conversations indexed by `taskId` for efficient routing and management.
+
+## Key Features
+
+### 1. Stateful Conversation Management
+
+- Maintains persistent `Conversation` objects indexed by `taskId`
+- Each task has its own conversation instance that lives for the entire task lifetime
+- Supports starting, stopping, resuming, and sending messages to conversations
+
+### 2. Session ID Handling
+
+- Automatically captures session IDs from the Claude SDK via callbacks
+- Notifies the orchestrator when session IDs change
+- Uses `taskId` as the primary key, not `sessionId`
+
+### 3. MCP Server Configuration
+
+- Accepts MCP server configurations from the orchestrator
+- Passes configurations directly to the Claude SDK without modification
+- Runner does not define its own MCP tools
+
+### 4. GitHub Token Integration
+
+- Fetches GitHub tokens from the orchestrator API endpoint
+- Automatically includes tokens in the Claude environment configuration
+- Handles token fetch failures gracefully
+
+### 5. Error Handling
+
+- Monitors process exits via the SDK's `onProcessComplete` callback
+- Reports errors to the orchestrator with detailed classification
+- Continues conversation on error (no automatic cleanup)
+
+## Architecture
+
+```typescript
+class ClaudeManager {
+  // Core responsibilities:
+  // 1. Create and manage Claude conversation instances
+  // 2. Handle session lifecycle events
+  // 3. Route messages to active conversations
+  // 4. Integrate with repository manager for workspace paths
+  // 5. Fetch authentication tokens from orchestrator
+}
+```
+
+## Usage
+
+```typescript
+// Start a conversation
+await claudeManager.startConversation(taskId, config, initialMessages);
+
+// Send a message to an active conversation
+await claudeManager.sendUserMessage(taskId, sessionId, content);
+
+// Resume an existing conversation
+await claudeManager.resumeConversation(taskId, sessionId, config);
+
+// Stop a conversation
+await claudeManager.stopConversation(taskId, sessionId);
+```
+
+## Error Types
+
+The ClaudeManager classifies errors into the following types:
+
+- `process_exit`: Claude process exited unexpectedly
+- `model_error`: Model-related errors
+- `tool_error`: Tool execution errors
+- `permission_error`: Permission-related errors
+- `timeout_error`: Operation timeouts
+- `unknown_error`: Unclassified errors
+
+## Integration Points
+
+1. **RunnerApp**: Accesses configuration and sends notifications
+2. **RepositoryManager**: Gets workspace paths and manages Git checkouts
+3. **Orchestrator API**: Fetches GitHub tokens and sends notifications
+4. **Claude SDK**: Creates and manages conversation instances
+
+## Environment Requirements
+
+- `ANTHROPIC_API_KEY`: Required for Claude API access
+- `NORTHFLARE_RUNNER_TOKEN`: Required for orchestrator API authentication
+- `NORTHFLARE_WORKSPACE_DIR`: Base directory for Git checkouts
+- `DEBUG` (optional): Enable debug logging