feat: allow disabling auto-update via config env.USE_AGENTLY_AUTO_UPDATE

Co-authored-by: fuxingloh <4266087+fuxingloh@users.noreply.github.com>

Author: Copilot

packages/use-agently/src/commands/update.test.ts

@@ -3,12 +3,22 @@ import { captureOutput } from "../testing";
 
 const mockLoadState = mock(async () => ({}));
 const mockSaveState = mock(async (_state: unknown) => {});
+const mockLoadConfig = mock(async () => undefined as unknown);
 
 mock.module("../state", () => ({
   loadState: mockLoadState,
   saveState: mockSaveState,
 }));
 
+mock.module("../config", () => ({
+  loadConfig: mockLoadConfig,
+  saveConfig: async () => {},
+  backupConfig: async () => "",
+  getConfigOrThrow: async () => {
+    throw new Error("No wallet configured.");
+  },
+}));
+
 mock.module("node:child_process", () => ({
   execSync: mock(() => {}),
 }));
@@ -121,6 +131,7 @@ describe("checkAutoUpdate", () => {
   beforeEach(() => {
     mockLoadState.mockClear();
     mockSaveState.mockClear();
+    mockLoadConfig.mockImplementation(async () => undefined);
     fetchSpy = spyOn(globalThis, "fetch").mockResolvedValue({
       ok: true,
       json: async () => ({ version: "9.9.9" }),
@@ -158,6 +169,23 @@ describe("checkAutoUpdate", () => {
     expect(mockSaveState).toHaveBeenCalledTimes(1);
   });
 
+  test("skips when USE_AGENTLY_AUTO_UPDATE is 0 in config", async () => {
+    mockLoadConfig.mockImplementation(async () => ({ env: { USE_AGENTLY_AUTO_UPDATE: 0 } }));
+
+    await checkAutoUpdate();
+
+    expect(mockSaveState).not.toHaveBeenCalled();
+    expect(fetchSpy).not.toHaveBeenCalled();
+  });
+
+  test("runs when USE_AGENTLY_AUTO_UPDATE is 1 in config", async () => {
+    mockLoadConfig.mockImplementation(async () => ({ env: { USE_AGENTLY_AUTO_UPDATE: 1 } }));
+
+    await checkAutoUpdate();
+
+    expect(mockSaveState).toHaveBeenCalledTimes(1);
+  });
+
   test("silently swallows errors", async () => {
     fetchSpy.mockResolvedValue({ ok: false, status: 500 } as Response);
     mockLoadState.mockImplementation(async () => ({}));

packages/use-agently/src/commands/update.ts

@@ -2,6 +2,7 @@ import { Command } from "commander";
 import { execSync } from "node:child_process";
 import { output } from "../output.js";
 import { loadState, saveState } from "../state.js";
+import { loadConfig } from "../config.js";
 import pkg from "../../package.json" with { type: "json" };
 
 const PACKAGE_NAME = "use-agently";
@@ -50,6 +51,9 @@ export async function checkAndUpdate(): Promise<{ current: string; latest: strin
 
 export async function checkAutoUpdate(): Promise<void> {
   try {
+    const config = await loadConfig();
+    if ((config?.env?.USE_AGENTLY_AUTO_UPDATE ?? 1) === 0) return;
+
     const state = await loadState();
     const lastCheck = state.lastUpdateCheck ? new Date(state.lastUpdateCheck).getTime() : 0;
     const hoursSinceLastCheck = (Date.now() - lastCheck) / (1000 * 60 * 60);

packages/use-agently/src/config.ts

@@ -11,6 +11,7 @@ export interface WalletConfig {
 
 export interface Config {
   wallet: WalletConfig;
+  env?: Record<string, number | string>;
 }
 
 function getConfigDir(scope: ConfigScope): string {