@northflare/runner 0.0.13 → 0.0.16

package/README.md

@@ -66,7 +66,7 @@ Options:
   --retry-strategy <strategy>            registration retry strategy (none, interval, exponential) (default: "exponential")
   --retry-interval-secs <seconds>        retry interval in seconds for interval strategy (default: "60")
   --retry-duration-secs <seconds>        max retry duration in seconds for exponential strategy (default: "900")
-  --data-dir <path>                      data directory path (default: "./data")
+  --data-dir <path>                      data directory path (default: env-paths app data dir)
   --heartbeat-interval <ms>              heartbeat interval in milliseconds (default: "120000")
   -h, --help                             display help for command
 ```
@@ -75,11 +75,14 @@ Options:
 
 ### Configuration File (optional)
 
-Create a `runner-config.json` file:
+Create a `runner-config.json` file (optional). By default data is stored in
+the OS-specific application data directory provided by [`env-paths`](https://www.npmjs.com/package/env-paths)
+under the `northflare-runner` app name. Override it only if you need the data
+somewhere else:
 
 ```json
 {
-  "dataDir": "./data"
+  "dataDir": "/custom/path/to/northflare-runner-data"
 }
 ```
 
@@ -88,9 +91,9 @@ Create a `runner-config.json` file:
 | Variable                      | Required | Description                                            |
 | ----------------------------- | -------- | ------------------------------------------------------ |
 | `NORTHFLARE_RUNNER_TOKEN`     | Yes      | Authentication token from server                       |
-| `NORTHFLARE_WORKSPACE_DIR`    | No       | Root directory for Git checkouts (default: /workspace) |
+| `NORTHFLARE_WORKSPACE_DIR`    | No       | Root directory for Git checkouts (default: env-paths app data dir) |
 | `NORTHFLARE_ORCHESTRATOR_URL` | Yes      | Orchestrator API endpoint                              |
-| `NORTHFLARE_DATA_DIR`         | No       | Override data directory                                |
+| `NORTHFLARE_DATA_DIR`         | No       | Override data directory (default: env-paths app data dir) |
 | `DEBUG`                       | No       | Enable debug logging                                   |
 
 ### Programmatic

package/bin/northflare-runner

@@ -4,9 +4,33 @@
  * CLI executable for Northflare Runner
  */
 
-const { program, Command } = require("commander");
+import { program, Command } from "commander";
+import path from "path";
+import { fileURLToPath } from "url";
+import { createRequire } from "module";
+import fs from "fs/promises";
+import crypto from "crypto";
+import envPaths from "env-paths";
+
+// For reading package.json
+const require = createRequire(import.meta.url);
 const pkg = require("../package.json");
 
+const ENV_PATHS_APP_NAME = "northflare-runner";
+const ENV_PATHS_OPTIONS = { suffix: "" };
+
+let DEFAULT_DATA_DIR;
+try {
+  DEFAULT_DATA_DIR = envPaths(ENV_PATHS_APP_NAME, ENV_PATHS_OPTIONS).data;
+} catch (error) {
+  console.warn(
+    "env-paths lookup failed, falling back to ./data for data directory",
+    error
+  );
+  const __dirname = path.dirname(fileURLToPath(import.meta.url));
+  DEFAULT_DATA_DIR = path.resolve(__dirname, "../data");
+}
+
 /**
  * Helper function to fetch runner ID from orchestrator
  */
@@ -44,12 +68,16 @@ const startCommand = new Command("start")
   .description("start the runner")
   .option("-c, --config <path>", "path to configuration file")
   .option("-d, --debug", "enable debug logging")
-  .option("--data-dir <path>", "override data directory")
+  .option("--data-dir <path>", "override data directory", DEFAULT_DATA_DIR)
   .option(
     "--workspace-dir <path>",
     "workspace directory for Git checkouts (default: uses env-paths data directory)"
   )
   .option("--token <token>", "authentication token")
+  .option(
+    "--inactivity-timeout <duration>",
+    "exit the runner after this much idle time (e.g. 30s, 5m, 1h)"
+  )
   .action(async (options, command) => {
     // Set environment variables from CLI options
     if (options.debug) {
@@ -65,6 +93,11 @@ const startCommand = new Command("start")
     if (token) {
       process.env.NORTHFLARE_RUNNER_TOKEN = token;
     }
+    const inactivityTimeout =
+      options.inactivityTimeout || command.parent?.opts().inactivityTimeout;
+    if (inactivityTimeout) {
+      process.env.NORTHFLARE_RUNNER_INACTIVITY_TIMEOUT = inactivityTimeout;
+    }
 
     // Load the main module with config path if provided
     // Clear argv[2] since it contains 'start' command
@@ -74,8 +107,8 @@ const startCommand = new Command("start")
       process.argv[2] = configPath;
     }
 
-    // Manually call the main function since require.main won't match
-    const { main } = require("../dist");
+    // Dynamically import the main module
+    const { main } = await import("../dist/index.js");
     await main().catch((error) => {
       console.error("Fatal error:", error.message);
       process.exit(1);
@@ -87,7 +120,7 @@ const validateCommand = new Command("validate")
   .description("validate configuration without starting")
   .option("-c, --config <path>", "path to configuration file")
   .option("--token <token>", "authentication token")
-  .option("--data-dir <path>", "override data directory")
+  .option("--data-dir <path>", "override data directory", DEFAULT_DATA_DIR)
   .option(
     "--workspace-dir <path>",
     "workspace directory for Git checkouts (default: uses env-paths data directory)"
@@ -106,7 +139,7 @@ const validateCommand = new Command("validate")
         process.env.NORTHFLARE_WORKSPACE_DIR = options.workspaceDir;
       }
 
-      const { ConfigManager } = require("../dist/utils/config.js");
+      const { ConfigManager } = await import("../dist/utils/config.js");
       const configPath = options.config || command.parent?.opts().config;
       const config = await ConfigManager.loadConfig(configPath);
       console.log("Configuration is valid");
@@ -131,10 +164,6 @@ const listReposCommand = new Command("list-repos")
   .option("--token <token>", "authentication token")
   .action(async (options, command) => {
     try {
-      const fs = require("fs").promises;
-      const path = require("path");
-      const envPaths = require("env-paths").default || require("env-paths");
-
       // Get token from command options, parent options, or environment
       const token =
         options.token ||
@@ -238,11 +267,6 @@ const addRepoCommand = new Command("add-repo")
   .option("--token <token>", "authentication token")
   .action(async (repoPath, options, command) => {
     try {
-      const fs = require("fs").promises;
-      const path = require("path");
-      const envPaths = require("env-paths").default || require("env-paths");
-      const crypto = require("crypto");
-
       // Get token from command options, parent options, or environment
       const token =
         options.token ||
@@ -361,7 +385,7 @@ const addRepoCommand = new Command("add-repo")
       config.runnerRepos[runnerId].push(newRepo);
 
       // Save updated config
-      const { ConfigManager } = require("../dist/utils/config.js");
+      const { ConfigManager } = await import("../dist/utils/config.js");
       await ConfigManager.saveConfigFile(configPath, config);
 
       console.log(
@@ -429,6 +453,10 @@ program
     "--token <token>",
     "authentication token (can be used with any command)"
   )
+  .option(
+    "--inactivity-timeout <duration>",
+    "exit the runner after this much idle time (e.g. 30s, 5m, 1h)"
+  )
   .option(
     "-c, --config <path>",
     "path to configuration file (can be used with any command)"

package/dist/components/claude-sdk-manager.d.ts

@@ -13,9 +13,9 @@
  * - SDK's onProcessComplete() for proper cleanup
  * - Simplified error handling while maintaining compatibility
  */
-import { IRunnerApp } from "../types/runner-interface";
-import { EnhancedRepositoryManager } from "./enhanced-repository-manager";
-import { ConversationContext, ConversationConfig, Message } from "../types";
+import { IRunnerApp } from '../types/runner-interface.js';
+import { EnhancedRepositoryManager } from './enhanced-repository-manager.js';
+import { ConversationContext, ConversationConfig, Message } from '../types/index.js';
 export declare class ClaudeManager {
     private runner;
     private repositoryManager;

package/dist/components/claude-sdk-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"claude-sdk-manager.d.ts","sourceRoot":"","sources":["../../src/components/claude-sdk-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAO5E,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,iBAAiB,CAA4B;gBAGnD,MAAM,EAAE,UAAU,EAClB,iBAAiB,EAAE,yBAAyB;IAiB9C,OAAO,CAAC,sBAAsB;IAKxB,iBAAiB,CACrB,sBAAsB,EAAE,MAAM,GAAG,UAAU,EAC3C,oBAAoB,EAAE,MAAM,EAC5B,MAAM,EAAE,kBAAkB,EAC1B,eAAe,EAAE,OAAO,EAAE,EAC1B,gBAAgB,CAAC,EAAE;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,kBAAkB,EAAE,MAAM,CAAC;QAC3B,qBAAqB,EAAE,MAAM,CAAC;QAC9B,eAAe,EAAE,MAAM,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;KACxB,GACA,OAAO,CAAC,mBAAmB,CAAC;IA6XzB,gBAAgB,CACpB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,mBAAmB,EAC5B,gBAAgB,GAAE,OAAe,EACjC,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAmCV,kBAAkB,CACtB,sBAAsB,EAAE,MAAM,GAAG,UAAU,EAC3C,oBAAoB,EAAE,MAAM,EAC5B,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,kBAAkB,EAC1B,gBAAgB,CAAC,EAAE,GAAG,EACtB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC;YAuCJ,qBAAqB;IAsC7B,eAAe,CACnB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,GAAG,EACZ,MAAM,CAAC,EAAE,kBAAkB,EAC3B,sBAAsB,CAAC,EAAE,MAAM,GAAG,UAAU,EAC5C,oBAAoB,CAAC,EAAE,MAAM,EAC7B,YAAY,CAAC,EAAE,GAAG,EAClB,uBAAuB,CAAC,EAAE,MAAM,GAC/B,OAAO,CAAC,IAAI,CAAC;YA6HF,iBAAiB;YA2BjB,wBAAwB;IA2BtC,OAAO,CAAC,aAAa;IAerB;;OAEG;IACH,OAAO,CAAC,eAAe;YA2CT,qBAAqB;CA0dpC"}
+{"version":3,"file":"claude-sdk-manager.d.ts","sourceRoot":"","sources":["../../src/components/claude-sdk-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAOrF,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,iBAAiB,CAA4B;gBAGnD,MAAM,EAAE,UAAU,EAClB,iBAAiB,EAAE,yBAAyB;IAiB9C,OAAO,CAAC,sBAAsB;IAKxB,iBAAiB,CACrB,sBAAsB,EAAE,MAAM,GAAG,UAAU,EAC3C,oBAAoB,EAAE,MAAM,EAC5B,MAAM,EAAE,kBAAkB,EAC1B,eAAe,EAAE,OAAO,EAAE,EAC1B,gBAAgB,CAAC,EAAE;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,kBAAkB,EAAE,MAAM,CAAC;QAC3B,qBAAqB,EAAE,MAAM,CAAC;QAC9B,eAAe,EAAE,MAAM,CAAC;QACxB,cAAc,EAAE,MAAM,CAAC;KACxB,GACA,OAAO,CAAC,mBAAmB,CAAC;IA4XzB,gBAAgB,CACpB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,mBAAmB,EAC5B,gBAAgB,GAAE,OAAe,EACjC,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAmCV,kBAAkB,CACtB,sBAAsB,EAAE,MAAM,GAAG,UAAU,EAC3C,oBAAoB,EAAE,MAAM,EAC5B,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,kBAAkB,EAC1B,gBAAgB,CAAC,EAAE,GAAG,EACtB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC;YAuCJ,qBAAqB;IA2C7B,eAAe,CACnB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,GAAG,EACZ,MAAM,CAAC,EAAE,kBAAkB,EAC3B,sBAAsB,CAAC,EAAE,MAAM,GAAG,UAAU,EAC5C,oBAAoB,CAAC,EAAE,MAAM,EAC7B,YAAY,CAAC,EAAE,GAAG,EAClB,uBAAuB,CAAC,EAAE,MAAM,GAC/B,OAAO,CAAC,IAAI,CAAC;YAgIF,iBAAiB;YA2BjB,wBAAwB;IA2BtC,OAAO,CAAC,aAAa;IAerB;;OAEG;IACH,OAAO,CAAC,eAAe;YA2CT,qBAAqB;CA0dpC"}