byterover-cli 2.3.4 → 2.4.1

package/dist/server/constants.d.ts

@@ -55,7 +55,7 @@ export declare const SHUTDOWN_FORCE_EXIT_MS = 5000;
 export declare const AUTH_STATE_POLL_INTERVAL_MS = 5000;
 export declare const AGENT_MAX_CONCURRENT_TASKS = 5;
 export declare const AGENT_POOL_MAX_SIZE = 10;
-export declare const AGENT_PROCESS_READY_TIMEOUT_MS = 15000;
+export declare const AGENT_PROCESS_READY_TIMEOUT_MS = 30000;
 export declare const AGENT_PROCESS_STOP_TIMEOUT_MS = 5000;
 export declare const CURATE_LOG_DIR = "curate-log";
 export declare const CURATE_LOG_ID_PREFIX = "cur";

package/dist/server/constants.js

@@ -75,7 +75,7 @@ export const AUTH_STATE_POLL_INTERVAL_MS = 5000; // Poll token store every 5s
 // Agent Pool (T6)
 export const AGENT_MAX_CONCURRENT_TASKS = 5; // Max parallel curate/query tasks per agent process
 export const AGENT_POOL_MAX_SIZE = 10;
-export const AGENT_PROCESS_READY_TIMEOUT_MS = 15_000; // 15s max wait for child process to register
+export const AGENT_PROCESS_READY_TIMEOUT_MS = 30_000; // 30s max wait for child process to register
 export const AGENT_PROCESS_STOP_TIMEOUT_MS = 5000; // 5s max wait for child process to stop gracefully
 // Curate log
 export const CURATE_LOG_DIR = 'curate-log';

package/dist/server/infra/auth/oauth-service.js

@@ -3,6 +3,7 @@ import axios, { isAxiosError } from 'axios';
 import crypto from 'node:crypto';
 import { OAuthTokenData } from '../../core/domain/entities/oauth-token-data.js';
 import { AuthenticationError } from '../../core/domain/errors/auth-error.js';
+import { ProxyConfig } from '../http/proxy-config.js';
 export const NETWORK_ERROR_CODE = {
     EAI_AGAIN: 'EAI_AGAIN',
     ECONNABORTED: 'ECONNABORTED',
@@ -49,6 +50,8 @@ export class OAuthService {
                 headers: {
                     'Content-Type': 'application/x-www-form-urlencoded',
                 },
+                httpAgent: ProxyConfig.getProxyAgent(),
+                httpsAgent: ProxyConfig.getProxyAgent(),
             });
             return this.parseTokenResponse(response.data);
         }
@@ -91,6 +94,9 @@ export class OAuthService {
                 client_secret: this.config.clientSecret,
                 grant_type: 'refresh_token',
                 refresh_token: refreshToken,
+            }, {
+                httpAgent: ProxyConfig.getProxyAgent(),
+                httpsAgent: ProxyConfig.getProxyAgent(),
             });
             return this.parseTokenResponse(response.data);
         }

package/dist/server/infra/auth/oidc-discovery-service.js

@@ -1,5 +1,6 @@
 import axios, { isAxiosError } from 'axios';
 import { DiscoveryError, DiscoveryNetworkError, DiscoveryTimeoutError } from '../../core/domain/errors/discovery-error.js';
+import { ProxyConfig } from '../http/proxy-config.js';
 /**
  * OIDC discovery service implementation.
  * Fetches OIDC configuration from the well-known endpoint with in-memory caching.
@@ -76,6 +77,8 @@ export class OidcDiscoveryService {
         try {
             const wellKnownUrl = `${issuerUrl}/.well-known/openid-configuration`;
             const response = await axios.get(wellKnownUrl, {
+                httpAgent: ProxyConfig.getProxyAgent(),
+                httpsAgent: ProxyConfig.getProxyAgent(),
                 timeout: this.timeoutMs,
             });
             // Validate required fields

package/dist/server/infra/cogit/http-cogit-push-service.js

@@ -2,6 +2,7 @@
 import axios from 'axios';
 import { CogitPushResponse } from '../../core/domain/entities/cogit-push-response.js';
 import { getErrorMessage } from '../../utils/error-helpers.js';
+import { ProxyConfig } from '../http/proxy-config.js';
 /**
  * Extracts the current SHA from an error response details field.
  * Error format: "...Expected SHA 'xxx' but current SHA is 'yyy'..."
@@ -96,6 +97,8 @@ export class HttpCogitPushService {
             headers: {
                 'x-byterover-session-id': params.sessionKey,
             },
+            httpAgent: ProxyConfig.getProxyAgent(),
+            httpsAgent: ProxyConfig.getProxyAgent(),
             timeout: this.config.timeout,
         });
         return CogitPushResponse.fromJson(response.data);

package/dist/server/infra/daemon/brv-server.js

@@ -204,7 +204,11 @@ async function main() {
         agentPool = new AgentPool({
             agentIdleTimeoutPolicy,
             agentProcessFactory(projectPath) {
-                return fork(agentProcessPath, [], {
+                // Prevent console window flash on Windows when forking agent processes.
+                // windowsHide is supported at runtime (fork delegates to spawn) but not in ForkOptions types,
+                // so we extract the options to a variable to bypass excess property checking.
+                const e2eStdio = ['ignore', 'inherit', 'inherit', 'ipc'];
+                const forkOptions = {
                     cwd: projectPath,
                     env: {
                         ...process.env,
@@ -212,8 +216,10 @@ async function main() {
                         BRV_AGENT_PROJECT_PATH: projectPath,
                     },
                     // In E2E mode, inherit stderr to see agent errors
-                    stdio: process.env.BRV_E2E_MODE === 'true' ? ['ignore', 'inherit', 'inherit', 'ipc'] : undefined,
-                });
+                    stdio: process.env.BRV_E2E_MODE === 'true' ? e2eStdio : undefined,
+                    windowsHide: true,
+                };
+                return fork(agentProcessPath, [], forkOptions);
             },
             log,
             transportServer,

package/dist/server/infra/http/authenticated-http-client.js

@@ -1,4 +1,5 @@
 import axios, { isAxiosError } from 'axios';
+import { ProxyConfig } from './proxy-config.js';
 /**
  * HTTP client implementation that automatically adds authentication headers to all requests.
  *
@@ -27,6 +28,8 @@ export class AuthenticatedHttpClient {
         try {
             const axiosConfig = {
                 headers: this.buildHeaders(config?.headers),
+                httpAgent: ProxyConfig.getProxyAgent(),
+                httpsAgent: ProxyConfig.getProxyAgent(),
                 timeout: config?.timeout,
             };
             const response = await axios.get(url, axiosConfig);
@@ -48,6 +51,8 @@ export class AuthenticatedHttpClient {
         try {
             const axiosConfig = {
                 headers: this.buildHeaders(config?.headers),
+                httpAgent: ProxyConfig.getProxyAgent(),
+                httpsAgent: ProxyConfig.getProxyAgent(),
                 timeout: config?.timeout,
             };
             const response = await axios.post(url, data, axiosConfig);
@@ -69,6 +74,8 @@ export class AuthenticatedHttpClient {
         try {
             const axiosConfig = {
                 headers: this.buildHeaders(config?.headers),
+                httpAgent: ProxyConfig.getProxyAgent(),
+                httpsAgent: ProxyConfig.getProxyAgent(),
                 timeout: config?.timeout,
             };
             const response = await axios.put(url, data, axiosConfig);
@@ -107,13 +114,21 @@ export class AuthenticatedHttpClient {
                 // Server responded with error status
                 return new Error(`HTTP ${error.response.status}: ${error.response.statusText}`);
             }
-            if (error.code === 'ECONNABORTED' || error.message.includes('timeout')) {
-                // Request timeout
-                return new Error(`Request timeout: ${error.message}`);
+            // Enterprise Proxy / SSL Checks
+            if (error.code === 'SELF_SIGNED_CERT_IN_CHAIN' || error.code === 'UNABLE_TO_VERIFY_LEAF_SIGNATURE' || error.code === 'CERT_HAS_EXPIRED') {
+                return new Error(`SSL Certificate Validation Failed (${error.code}). Your company may be using SSL Inspection.\n` +
+                    `Solution: Set the NODE_EXTRA_CA_CERTS environment variable to your corporate CA certificate path.\n` +
+                    `Example: export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.pem`);
+            }
+            const isTimeout = error.code === 'ECONNABORTED' || error.code === 'ETIMEDOUT' || error.message.includes('timeout');
+            const isRefused = error.code === 'ECONNREFUSED';
+            if (isTimeout || isRefused) {
+                return new Error(`Connection Failed (${error.code || 'TIMEOUT'}). If you are behind a corporate firewall, configure your proxy:\n` +
+                    `  export HTTPS_PROXY=http://proxy-host:port`);
             }
             if (error.request) {
                 // Request was made but no response received
-                return new Error('Network error: No response received from server');
+                return new Error('Network error: No response received from server. Check your proxy or internet connection.');
             }
         }
         // Generic error

package/dist/server/infra/http/models-dev-client.js

@@ -10,6 +10,7 @@ import { mkdir, readFile, writeFile } from 'node:fs/promises';
 import { dirname, join } from 'node:path';
 import { z } from 'zod';
 import { getGlobalDataDir } from '../../utils/global-data-path.js';
+import { ProxyConfig } from './proxy-config.js';
 const CacheEnvelopeSchema = z.object({
     data: z.record(z.unknown()),
     timestamp: z.number(),
@@ -57,6 +58,8 @@ export class ModelsDevClient {
     }
     async fetchAndCache() {
         const response = await axios.get(MODELS_DEV_URL, {
+            httpAgent: ProxyConfig.getProxyAgent(),
+            httpsAgent: ProxyConfig.getProxyAgent(),
             timeout: FETCH_TIMEOUT_MS,
         });
         const { data } = response;

package/dist/server/infra/http/openrouter-api-client.js

@@ -8,6 +8,7 @@
  * Uses the OpenRouter REST API: https://openrouter.ai/api/v1
  */
 import axios, { isAxiosError } from 'axios';
+import { ProxyConfig } from './proxy-config.js';
 const DEFAULT_BASE_URL = 'https://openrouter.ai/api/v1';
 const DEFAULT_CACHE_TTL = 60 * 60 * 1000; // 1 hour
 /**
@@ -100,6 +101,8 @@ export class OpenRouterApiClient {
                 'HTTP-Referer': this.httpReferer,
                 'X-Title': this.xTitle,
             },
+            httpAgent: ProxyConfig.getProxyAgent(),
+            httpsAgent: ProxyConfig.getProxyAgent(),
             timeout: 30_000,
         });
         return response.data.data.map((model) => this.normalizeModel(model));

package/dist/server/infra/http/provider-model-fetchers.js

@@ -16,6 +16,7 @@ import { APICallError, generateText } from 'ai';
 import axios, { isAxiosError } from 'axios';
 import OpenAI from 'openai';
 import { getModelsDevClient as getModelsDevClientDefault } from './models-dev-client.js';
+import { ProxyConfig } from './proxy-config.js';
 const DEFAULT_CACHE_TTL = 60 * 60 * 1000; // 1 hour
 const ANTHROPIC_KNOWN_MODELS = {
     'claude-3-5-haiku-20241022': { contextLength: 200_000, inputPerM: 0.8, outputPerM: 4 },
@@ -346,6 +347,8 @@ export class OpenAICompatibleModelFetcher {
         }
         const response = await axios.get(`${this.baseUrl}/models`, {
             headers: { Authorization: `Bearer ${apiKey}` },
+            httpAgent: ProxyConfig.getProxyAgent(),
+            httpsAgent: ProxyConfig.getProxyAgent(),
             timeout: 30_000,
         });
         // Handle different response formats:
@@ -376,6 +379,8 @@ export class OpenAICompatibleModelFetcher {
         try {
             await axios.get(`${this.baseUrl}/models`, {
                 headers: { Authorization: `Bearer ${apiKey}` },
+                httpAgent: ProxyConfig.getProxyAgent(),
+                httpsAgent: ProxyConfig.getProxyAgent(),
                 timeout: 15_000,
             });
             return { isValid: true };
@@ -431,6 +436,8 @@ export class ChatBasedModelFetcher {
                     Authorization: `Bearer ${apiKey}`,
                     'Content-Type': 'application/json',
                 },
+                httpAgent: ProxyConfig.getProxyAgent(),
+                httpsAgent: ProxyConfig.getProxyAgent(),
                 timeout: 15_000,
             });
             return { isValid: true };

package/dist/server/infra/http/proxy-config.d.ts

@@ -0,0 +1,5 @@
+import { ProxyAgent } from 'proxy-agent';
+export declare class ProxyConfig {
+    private static agent;
+    static getProxyAgent(): ProxyAgent;
+}

package/dist/server/infra/http/proxy-config.js

@@ -0,0 +1,10 @@
+import { ProxyAgent } from 'proxy-agent';
+export class ProxyConfig {
+    static agent;
+    static getProxyAgent() {
+        if (!this.agent) {
+            this.agent = new ProxyAgent();
+        }
+        return this.agent;
+    }
+}

package/dist/server/infra/hub/hub-install-service.js

@@ -1,6 +1,7 @@
 import axios, { isAxiosError } from 'axios';
 import { join } from 'node:path';
 import { BRV_DIR, CONTEXT_TREE_DIR } from '../../constants.js';
+import { ProxyConfig } from '../http/proxy-config.js';
 import { buildAuthHeaders } from './hub-auth-headers.js';
 export class HubInstallService {
     fileService;
@@ -30,6 +31,8 @@ export class HubInstallService {
             const headers = buildAuthHeaders(auth ?? {});
             const response = await axios.get(url, {
                 headers,
+                httpAgent: ProxyConfig.getProxyAgent(),
+                httpsAgent: ProxyConfig.getProxyAgent(),
                 responseType: 'text',
                 timeout: 15_000,
             });

package/dist/server/infra/hub/hub-registry-service.js

@@ -1,6 +1,7 @@
 /* eslint-disable camelcase */
 import axios, { isAxiosError } from 'axios';
 import { z } from 'zod';
+import { ProxyConfig } from '../http/proxy-config.js';
 import { buildAuthHeaders } from './hub-auth-headers.js';
 const CACHE_TTL_MS = 5 * 60 * 1000; // 5 minutes
 const HubEntrySchema = z.object({
@@ -69,6 +70,8 @@ export class HubRegistryService {
             });
             const response = await axios.get(this.registryUrl, {
                 headers,
+                httpAgent: ProxyConfig.getProxyAgent(),
+                httpsAgent: ProxyConfig.getProxyAgent(),
                 timeout: this.timeoutMs,
             });
             const validated = this.parseRegistryResponse(response.data);

package/dist/server/infra/memory/http-memory-storage-service.js

@@ -4,6 +4,7 @@ import { PresignedUrl } from '../../core/domain/entities/presigned-url.js';
 import { PresignedUrlsResponse } from '../../core/domain/entities/presigned-urls-response.js';
 import { getErrorMessage } from '../../utils/error-helpers.js';
 import { AuthenticatedHttpClient } from '../http/authenticated-http-client.js';
+import { ProxyConfig } from '../http/proxy-config.js';
 /**
  * HTTP implementation of IMemoryStorageService for ByteRover CoGit service.
  * Handles uploading playbooks to blob storage.
@@ -55,6 +56,8 @@ export class HttpMemoryStorageService {
                 headers: {
                     'Content-Type': 'application/json',
                 },
+                httpAgent: ProxyConfig.getProxyAgent(),
+                httpsAgent: ProxyConfig.getProxyAgent(),
                 timeout: this.config.timeout,
             });
         }

package/dist/server/infra/provider-oauth/refresh-token-exchange.js

@@ -1,5 +1,6 @@
 /* eslint-disable camelcase */
 import axios, { isAxiosError } from 'axios';
+import { ProxyConfig } from '../http/proxy-config.js';
 import { extractOAuthErrorFields, ProviderTokenExchangeError } from './errors.js';
 import { ProviderTokenResponseSchema } from './types.js';
 /**
@@ -20,6 +21,8 @@ export async function exchangeRefreshToken(params) {
             headers: {
                 'Content-Type': params.contentType,
             },
+            httpAgent: ProxyConfig.getProxyAgent(),
+            httpsAgent: ProxyConfig.getProxyAgent(),
             timeout: 30_000,
         });
     }

package/dist/server/infra/provider-oauth/token-exchange.js

@@ -1,5 +1,6 @@
 /* eslint-disable camelcase */
 import axios, { isAxiosError } from 'axios';
+import { ProxyConfig } from '../http/proxy-config.js';
 import { extractOAuthErrorFields, ProviderTokenExchangeError } from './errors.js';
 import { ProviderTokenResponseSchema } from './types.js';
 /**
@@ -25,6 +26,8 @@ export async function exchangeCodeForTokens(params) {
             headers: {
                 'Content-Type': params.contentType,
             },
+            httpAgent: ProxyConfig.getProxyAgent(),
+            httpsAgent: ProxyConfig.getProxyAgent(),
             timeout: 30_000,
         });
     }

package/oclif.manifest.json

@@ -1083,6 +1083,104 @@
         "switch.js"
       ]
     },
+    "space:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List all teams and spaces",
+      "examples": [
+        "<%= config.bin %> space list",
+        "<%= config.bin %> space list --format json"
+      ],
+      "flags": {
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "space:list",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "space",
+        "list.js"
+      ]
+    },
+    "space:switch": {
+      "aliases": [],
+      "args": {},
+      "description": "Switch to a different space",
+      "examples": [
+        "<%= config.bin %> space switch --team acme --name my-space",
+        "<%= config.bin %> space switch --team acme --name my-space --format json"
+      ],
+      "flags": {
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        },
+        "name": {
+          "char": "n",
+          "description": "Name of the space to switch to",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "team": {
+          "char": "t",
+          "description": "Team name",
+          "name": "team",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "space:switch",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "space",
+        "switch.js"
+      ]
+    },
     "providers:connect": {
       "aliases": [],
       "args": {
@@ -1339,104 +1437,6 @@
         "switch.js"
       ]
     },
-    "space:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List all teams and spaces",
-      "examples": [
-        "<%= config.bin %> space list",
-        "<%= config.bin %> space list --format json"
-      ],
-      "flags": {
-        "format": {
-          "char": "f",
-          "description": "Output format",
-          "name": "format",
-          "default": "text",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "space:list",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "space",
-        "list.js"
-      ]
-    },
-    "space:switch": {
-      "aliases": [],
-      "args": {},
-      "description": "Switch to a different space",
-      "examples": [
-        "<%= config.bin %> space switch --team acme --name my-space",
-        "<%= config.bin %> space switch --team acme --name my-space --format json"
-      ],
-      "flags": {
-        "format": {
-          "char": "f",
-          "description": "Output format",
-          "name": "format",
-          "default": "text",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
-          "type": "option"
-        },
-        "name": {
-          "char": "n",
-          "description": "Name of the space to switch to",
-          "name": "name",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "team": {
-          "char": "t",
-          "description": "Team name",
-          "name": "team",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "space:switch",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "space",
-        "switch.js"
-      ]
-    },
     "hub:registry:add": {
       "aliases": [],
       "args": {
@@ -1636,5 +1636,5 @@
       ]
     }
   },
-  "version": "2.3.4"
+  "version": "2.4.1"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "byterover-cli",
   "description": "ByteRover's CLI",
-  "version": "2.3.4",
+  "version": "2.4.1",
   "author": "ByteRover",
   "bin": {
     "brv": "./bin/run.js"
@@ -55,6 +55,7 @@
     "officeparser": "^6.0.4",
     "open": "^10.2.0",
     "openai": "^6.9.1",
+    "proxy-agent": "^7.0.0",
     "react": "^19.2.1",
     "react-router-dom": "^7.13.0",
     "remark-parse": "^11.0.0",