@voxli/cli 0.5.1 → 0.6.1

package/dist/cli.js

@@ -20,5 +20,6 @@ program
     .command("listen")
     .description("Poll for pending test work and run it locally")
     .requiredOption("--command <cmd>", "Shell command to run per batch")
+    .option("--name <name>", "Display name for this agent (defaults to hostname)")
     .action(listenCommand);
 program.parse();

package/dist/commands/listen.d.ts

@@ -1,3 +1,4 @@
 export declare function listenCommand(options: {
     command: string;
+    name?: string;
 }): Promise<void>;

package/dist/commands/listen.js

@@ -1,9 +1,11 @@
 import { join } from "node:path";
 import { spawn } from "node:child_process";
 import { resolveApiKey, resolveConfig, attemptTokenRefresh, } from "../lib/config.js";
-import { getStableHostname } from "../lib/hostname.js";
+import { buildAgentIdentifier, getStableHostname } from "../lib/hostname.js";
 import { register, ApiError } from "../lib/api.js";
+import { getJwtExpiry } from "../lib/oauth.js";
 const POLL_INTERVAL = 5_000;
+const REFRESH_BUFFER_SECONDS = 30 * 60;
 export async function listenCommand(options) {
     const isEnvToken = !!resolveApiKey();
     let apiKey = null;
@@ -24,7 +26,8 @@ export async function listenCommand(options) {
         console.error("Error: No API key found. Set VOXLI_API_TOKEN or run `voxli auth`.");
         process.exit(1);
     }
-    const hostname = getStableHostname();
+    const displayName = options.name ?? getStableHostname();
+    const uniqueIdentifier = buildAgentIdentifier(options.name);
     const children = new Set();
     // Graceful shutdown
     const shutdown = () => {
@@ -36,12 +39,25 @@ export async function listenCommand(options) {
     };
     process.on("SIGINT", shutdown);
     process.on("SIGTERM", shutdown);
-    console.log(`Listening as ${hostname} using credentials from ${credentialSource}`);
+    console.log(`Listening as ${displayName} (${uniqueIdentifier}) using credentials from ${credentialSource}`);
     while (true) {
         try {
+            // Proactively refresh if the token expires within the buffer window so
+            // newly-spawned subprocesses inherit a token that will outlast the test.
+            if (!isEnvToken) {
+                const exp = getJwtExpiry(apiKey);
+                const nowSec = Math.floor(Date.now() / 1000);
+                if (exp !== null && exp - nowSec < REFRESH_BUFFER_SECONDS) {
+                    const newToken = await attemptTokenRefresh(apiKey);
+                    if (newToken && newToken !== apiKey) {
+                        apiKey = newToken;
+                        console.log("Access token refreshed proactively.");
+                    }
+                }
+            }
             const data = await register(apiKey, {
-                name: hostname,
-                unique_identifier: hostname,
+                name: displayName,
+                unique_identifier: uniqueIdentifier,
             });
             const testResultIds = data.test_result_ids ?? [];
             if (testResultIds.length > 0) {
@@ -86,7 +102,7 @@ export async function listenCommand(options) {
                     process.exit(1);
                 }
                 console.log("Access token expired, attempting refresh...");
-                const newToken = await attemptTokenRefresh();
+                const newToken = await attemptTokenRefresh(apiKey ?? undefined);
                 if (newToken) {
                     apiKey = newToken;
                     console.log("Token refreshed successfully.");

package/dist/lib/config.d.ts

@@ -23,4 +23,4 @@ export declare function writeConfig(config: {
 }): Promise<string>;
 export declare function resolveApiKey(): string | null;
 export declare function resolveApiKeyAsync(): Promise<string | null>;
-export declare function attemptTokenRefresh(): Promise<string | null>;
+export declare function attemptTokenRefresh(expiredToken?: string): Promise<string | null>;

package/dist/lib/config.js

@@ -98,22 +98,45 @@ export async function resolveApiKeyAsync() {
     const config = resolved?.config;
     return config?.accessToken ?? config?.apiKey ?? null;
 }
-export async function attemptTokenRefresh() {
+export async function attemptTokenRefresh(expiredToken) {
     try {
         const resolved = await resolveConfig();
         if (!resolved)
             return null;
         const { config, configDir } = resolved;
+        // Another listener may have already refreshed — adopt that token.
+        if (expiredToken &&
+            config.accessToken &&
+            config.accessToken !== expiredToken) {
+            return config.accessToken;
+        }
         if (!config.refreshToken || !config.clientId)
             return null;
         const baseUrl = getApiBaseUrl();
-        const result = await refreshAccessToken(baseUrl, config.refreshToken, config.clientId);
-        await writeConfig({
-            accessToken: result.accessToken,
-            refreshToken: result.refreshToken ?? config.refreshToken,
-            clientId: config.clientId,
-        }, { configDir });
-        return result.accessToken;
+        try {
+            const result = await refreshAccessToken(baseUrl, config.refreshToken, config.clientId);
+            await writeConfig({
+                accessToken: result.accessToken,
+                refreshToken: result.refreshToken ?? config.refreshToken,
+                clientId: config.clientId,
+            }, { configDir });
+            return result.accessToken;
+        }
+        catch {
+            // Refresh failed (likely because a sibling listener already used the
+            // refresh token). Retry-read the config briefly in case the winner is
+            // still flushing its write to disk.
+            if (!expiredToken)
+                return null;
+            for (let i = 0; i < 5; i++) {
+                await new Promise((r) => setTimeout(r, 100));
+                const recheck = await resolveConfig();
+                const fresh = recheck?.config.accessToken;
+                if (fresh && fresh !== expiredToken)
+                    return fresh;
+            }
+            return null;
+        }
     }
     catch {
         return null;

package/dist/lib/hostname.d.ts

@@ -1 +1,2 @@
 export declare function getStableHostname(): string;
+export declare function buildAgentIdentifier(name: string | undefined): string;

package/dist/lib/hostname.js

@@ -14,3 +14,10 @@ export function getStableHostname() {
     }
     return hostname();
 }
+export function buildAgentIdentifier(name) {
+    const host = getStableHostname();
+    if (!name)
+        return host;
+    const trimmed = name.replace(/\s+/g, "");
+    return trimmed ? `${trimmed}-${host}` : host;
+}

package/dist/lib/oauth.d.ts

@@ -13,6 +13,11 @@ export declare function refreshAccessToken(baseUrl: string, refreshToken: string
     accessToken: string;
     refreshToken?: string;
 }>;
+/**
+ * Read the `exp` claim (seconds since epoch) from a JWT access token.
+ * Returns null if the token isn't a parseable JWT or has no `exp`.
+ */
+export declare function getJwtExpiry(token: string): number | null;
 export declare function buildAuthorizeUrl(baseUrl: string, params: {
     clientId: string;
     redirectUri: string;

package/dist/lib/oauth.js

@@ -66,6 +66,22 @@ export async function refreshAccessToken(baseUrl, refreshToken, clientId) {
         refreshToken: data.refresh_token,
     };
 }
+/**
+ * Read the `exp` claim (seconds since epoch) from a JWT access token.
+ * Returns null if the token isn't a parseable JWT or has no `exp`.
+ */
+export function getJwtExpiry(token) {
+    const parts = token.split(".");
+    if (parts.length !== 3)
+        return null;
+    try {
+        const payload = JSON.parse(Buffer.from(parts[1], "base64url").toString("utf-8"));
+        return typeof payload.exp === "number" ? payload.exp : null;
+    }
+    catch {
+        return null;
+    }
+}
 export function buildAuthorizeUrl(baseUrl, params) {
     const url = new URL("/oauth/authorize", baseUrl);
     url.searchParams.set("response_type", "code");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voxli/cli",
-  "version": "0.5.1",
+  "version": "0.6.1",
   "description": "CLI agent for running Voxli test scenarios locally",
   "type": "module",
   "bin": {