@sovara/runner 0.4.7 → 0.4.8

package/README.md

@@ -316,6 +316,10 @@ for await (const message of handle.query("What did I install last?")) {
 | `SOVARA_AGENT_TOKEN`         | Project-scoped token for a remote/headless agent                           | unset                   |
 | `SOVARA_CLAUDE_PROXY_ACTIVE` | Set automatically by `@sovara/runner/claude` to prevent nested proxy loops | unset                   |
 
+`SOVARA_EXEC_SERVER_PORT` must be an integer between `1` and `65535`. If it is
+set to a blank or invalid value, the runner fails during startup instead of
+silently using the default.
+
 ### Server URL
 
 The TypeScript runner uses the local exec server by default. Pass `url` when

package/dist/constants.d.ts

@@ -1,3 +1,7 @@
+export declare function readPositiveIntegerEnv(name: string, defaultValue: number, options?: {
+    maximum?: number;
+}): number;
+export declare function readHttpUrlEnv(name: string, defaultValue: string): string;
 export declare const PORT: number;
 export declare const DEFAULT_SERVER_URL: string;
 export declare const SERVER_BOOT_TIMEOUT_MS = 15000;

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,IAAI,QAA0D,CAAC;AAE5E,eAAO,MAAM,kBAAkB,QAAmE,CAAC;AACnG,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAC7C,eAAO,MAAM,4BAA4B,MAAM,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACjC,MAAM,CAoBR;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAczE;AAED,eAAO,MAAM,IAAI,QAIhB,CAAC;AAEF,eAAO,MAAM,kBAAkB,QAG9B,CAAC;AACF,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAC7C,eAAO,MAAM,4BAA4B,MAAM,CAAC"}

package/dist/constants.js

@@ -1,6 +1,37 @@
-const parsedExecPort = Number(process.env.SOVARA_EXEC_SERVER_PORT ?? "5960");
-export const PORT = Number.isFinite(parsedExecPort) ? parsedExecPort : 5960;
-export const DEFAULT_SERVER_URL = process.env.SOVARA_EXEC_SERVER_URL ?? `http://127.0.0.1:${PORT}`;
+export function readPositiveIntegerEnv(name, defaultValue, options = {}) {
+    const raw = process.env[name];
+    if (raw === undefined) {
+        return defaultValue;
+    }
+    const valueText = raw.trim();
+    const value = /^[+]?\d+$/.test(valueText) ? Number(valueText) : Number.NaN;
+    const { maximum } = options;
+    if (!Number.isSafeInteger(value)
+        || value <= 0
+        || (maximum !== undefined && value > maximum)) {
+        const constraint = maximum === undefined
+            ? "a positive integer"
+            : `a positive integer no greater than ${maximum}`;
+        throw new Error(`${name} must be ${constraint}; got ${JSON.stringify(raw)}.`);
+    }
+    return value;
+}
+export function readHttpUrlEnv(name, defaultValue) {
+    const raw = process.env[name];
+    const value = (raw ?? defaultValue).trim();
+    try {
+        const parsed = new URL(value);
+        if (!["http:", "https:"].includes(parsed.protocol) || !parsed.hostname) {
+            throw new Error("unsupported URL");
+        }
+    }
+    catch {
+        throw new Error(`${name} must be an absolute HTTP(S) URL.`);
+    }
+    return value.replace(/\/+$/, "");
+}
+export const PORT = readPositiveIntegerEnv("SOVARA_EXEC_SERVER_PORT", 5960, { maximum: 65_535 });
+export const DEFAULT_SERVER_URL = readHttpUrlEnv("SOVARA_EXEC_SERVER_URL", `http://127.0.0.1:${PORT}`);
 export const SERVER_BOOT_TIMEOUT_MS = 15_000;
 export const SERVER_BOOT_POLL_INTERVAL_MS = 500;
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,IAAI,MAAM,CAAC,CAAC;AAC7E,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC;AAE5E,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,oBAAoB,IAAI,EAAE,CAAC;AACnG,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAC7C,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,sBAAsB,CACpC,IAAY,EACZ,YAAoB,EACpB,UAAgC,EAAE;IAElC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC7B,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;IAC3E,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAC5B,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC;WACzB,KAAK,IAAI,CAAC;WACV,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,GAAG,OAAO,CAAC,EAC7C,CAAC;QACD,MAAM,UAAU,GAAG,OAAO,KAAK,SAAS;YACtC,CAAC,CAAC,oBAAoB;YACtB,CAAC,CAAC,sCAAsC,OAAO,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,YAAY,UAAU,SAAS,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,YAAoB;IAC/D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC;IAE3C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,mCAAmC,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,sBAAsB,CACxC,yBAAyB,EACzB,IAAI,EACJ,EAAE,OAAO,EAAE,MAAM,EAAE,CACpB,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAC9C,wBAAwB,EACxB,oBAAoB,IAAI,EAAE,CAC3B,CAAC;AACF,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAC7C,MAAM,CAAC,MAAM,4BAA4B,GAAG,GAAG,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sovara/runner",
-  "version": "0.4.7",
+  "version": "0.4.8",
   "description": "TypeScript runner for Sovara — wrap a script in a single function to record every LLM call, tool invocation, and log line into a structured run graph.",
   "license": "Apache-2.0",
   "author": "SovaraLabs",