offrouter-cli 0.0.0 → 0.2.0

package/dist/commands/status.js.map

@@ -1 +1 @@
-{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "offrouter-cli",
-  "version": "0.0.0",
+  "version": "0.2.0",
   "type": "module",
   "bin": {
     "offrouter": "dist/index.js"
@@ -12,13 +12,13 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "offrouter-adapter-claude": "*",
-    "offrouter-adapter-codex": "*",
-    "offrouter-adapter-gemini": "*",
-    "offrouter-adapter-grok": "*",
-    "offrouter-core": "*",
-    "offrouter-mcp": "*",
-    "commander": "^12.0.0",
-    "zod": "^3.23.0"
+    "offrouter-adapter-claude": "0.0.0",
+    "offrouter-adapter-codex": "0.0.0",
+    "offrouter-adapter-gemini": "0.0.0",
+    "offrouter-adapter-grok": "0.0.0",
+    "offrouter-core": "0.0.0",
+    "offrouter-mcp": "0.0.0",
+    "commander": "0.0.0",
+    "zod": "0.0.0"
   }
 }

package/src/cli.test.ts

@@ -3,6 +3,7 @@ import { chmod, mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { fileURLToPath } from "node:url";
+import { FileUsageStore } from "offrouter-core";
 import { createProgram, runCli } from "./index.js";
 
 async function capture(
@@ -1574,4 +1575,131 @@ describe("offrouter CLI", () => {
     const program = createProgram();
     expect(program.name()).toBe("offrouter");
   });
+
+  it("offrouter status --providers --json shows real quotaRemaining from FileUsageStore", async () => {
+    const home = await mkdtemp(join(tmpdir(), "offrouter-cli-status-usage-"));
+    try {
+      await writeFile(
+        join(home, "config.toml"),
+        [
+          'allowlisted_profiles = ["claude-personal"]',
+          "",
+          "[providers.anthropic]",
+          "enabled = true",
+          'accounts = [{ id = "my-account" }]',
+          "",
+        ].join("\n"),
+        "utf8",
+      );
+      const usageStore = new FileUsageStore({
+        filePath: join(home, "state", "usage.json"),
+      });
+      await usageStore.recordUsage("anthropic", "my-account", {
+        used: 85,
+        limit: 100,
+      });
+
+      const { code, stdout } = await capture(
+        ["status", "--providers", "--json"],
+        { ...process.env, OFFROUTER_HOME: home },
+      );
+      expect(code).toBe(0);
+      const json = JSON.parse(stdout) as {
+        providers: Array<{ accounts: Array<{ quotaRemaining: number | null }> }>;
+      };
+      const account = json.providers?.[0]?.accounts?.[0];
+      expect(account).toBeDefined();
+      expect(account!.quotaRemaining).toBe(15);
+    } finally {
+      await rm(home, { recursive: true, force: true });
+    }
+  });
+
+  it("offrouter doctor --json includes nearLimitWarnings when accounts are near-limit", async () => {
+    const home = await mkdtemp(join(tmpdir(), "offrouter-cli-doctor-near-"));
+    try {
+      await writeFile(
+        join(home, "config.toml"),
+        [
+          'allowlisted_profiles = ["claude-personal"]',
+          "",
+          "[providers.anthropic]",
+          "enabled = true",
+          'accounts = [{ id = "my-account" }]',
+          "",
+        ].join("\n"),
+        "utf8",
+      );
+      const usageStore = new FileUsageStore({
+        filePath: join(home, "state", "usage.json"),
+      });
+      await usageStore.recordUsage("anthropic", "my-account", {
+        used: 90,
+        limit: 100,
+      });
+
+      const { code, stdout } = await capture(
+        ["doctor", "--profile", "claude-personal", "--json"],
+        { ...process.env, OFFROUTER_HOME: home },
+      );
+      expect(code).toBe(0);
+      const json = JSON.parse(stdout) as {
+        nearLimitWarnings?: string[];
+        accounts: Array<{ nearLimit: boolean | null }>;
+      };
+      expect(json.nearLimitWarnings).toBeDefined();
+      expect(json.nearLimitWarnings!.length).toBeGreaterThan(0);
+      expect(json.nearLimitWarnings![0]).toMatch(/near its limit/i);
+      expect(json.accounts?.[0]?.nearLimit).toBe(true);
+    } finally {
+      await rm(home, { recursive: true, force: true });
+    }
+  });
+
+  it("offrouter route explain --json includes nearLimitWarning when an account is near-limit", async () => {
+    const home = await mkdtemp(join(tmpdir(), "offrouter-cli-route-near-"));
+    try {
+      await writeFile(
+        join(home, "config.toml"),
+        [
+          'allowlisted_profiles = ["claude-personal"]',
+          "",
+          "[providers.anthropic]",
+          "enabled = true",
+          'accounts = [{ id = "my-account" }]',
+          "",
+        ].join("\n"),
+        "utf8",
+      );
+      const usageStore = new FileUsageStore({
+        filePath: join(home, "state", "usage.json"),
+      });
+      await usageStore.recordUsage("anthropic", "my-account", {
+        used: 95,
+        limit: 100,
+      });
+
+      const { code, stdout } = await capture(
+        [
+          "route",
+          "explain",
+          "explain this repo",
+          "--profile",
+          "claude-personal",
+          "--json",
+        ],
+        { ...process.env, OFFROUTER_HOME: home },
+      );
+      expect(code).toBe(0);
+      const json = JSON.parse(stdout) as {
+        nearLimitWarning?: string;
+        blocked: boolean;
+      };
+      // The route is blocked (no candidates), but the warning should be present.
+      expect(json.nearLimitWarning).toBeDefined();
+      expect(json.nearLimitWarning).toMatch(/near its limit/i);
+    } finally {
+      await rm(home, { recursive: true, force: true });
+    }
+  });
 });

package/src/commands/doctor.ts

@@ -4,8 +4,10 @@ import { delimiter } from "node:path";
 import { dirname, join, normalize } from "node:path";
 import {
   evaluatePolicy,
+  FileUsageStore,
   loadConfig,
   redact,
+  resolveOffRouterHome,
   routeRequest,
   type ConfigWarning,
   type HarnessKind,
@@ -329,6 +331,13 @@ export function registerDoctorCommand(
       };
       let configError: CliConfigError | null = null;
       let policyConfig: PolicyConfig;
+      let accountReadiness: {
+        providerId: string;
+        accountId: string;
+        label: string;
+        nearLimit: boolean | null;
+      }[] = [];
+      const nearLimitWarnings: string[] = [];
       try {
         const config = await loadConfig({ env, workspaceDir: cwd });
         policyConfig = config.policy;
@@ -343,6 +352,35 @@ export function registerDoctorCommand(
           warnings: config.warnings.length,
           warningDetails: redactConfigWarnings(config.warnings, env),
         };
+
+        // Read persistent usage data for near-limit detection.
+        const usageStore = new FileUsageStore({
+          filePath: join(resolveOffRouterHome({ env }), "state", "usage.json"),
+        });
+        const allUsage = await usageStore.listAccountUsage();
+        const usageByKey = new Map(
+          allUsage.map((u) => [`${u.providerId}:${u.accountId}`, u]),
+        );
+
+        accountReadiness = Object.values(config.providers).flatMap((p) =>
+          p.accounts.map((a) => {
+            const snap = usageByKey.get(`${p.id}:${a.id}`);
+            return {
+              providerId: p.id,
+              accountId: a.id,
+              label: a.label ?? a.id,
+              nearLimit: snap?.nearLimit ?? null,
+            };
+          }),
+        );
+
+        for (const a of accountReadiness) {
+          if (a.nearLimit) {
+            nearLimitWarnings.push(
+              `Account ${a.providerId}/${a.accountId} is near its limit (${a.label})`,
+            );
+          }
+        }
       } catch (err) {
         configError = formatConfigError(err);
         const safeConfigError = redactConfigError(configError, env);
@@ -421,6 +459,8 @@ export function registerDoctorCommand(
         lastProviderError: detection.lastProviderError,
         config: configSummary,
         configError,
+        accounts: accountReadiness,
+        ...(nearLimitWarnings.length > 0 ? { nearLimitWarnings } : {}),
       };
 
       if (opts.json) {
@@ -443,6 +483,18 @@ export function registerDoctorCommand(
           `- Config warning [${warning.path}]: ${warning.message}`,
         );
       }
+      writeText(
+        stdout,
+        `Accounts: ${accountReadiness.length} configured${accountReadiness.length > 0 ? "" : " (none)"}`,
+      );
+      for (const a of accountReadiness) {
+        writeText(stdout, `  account ${a.providerId}/${a.accountId}: ${a.label}`);
+      }
+      if (nearLimitWarnings.length > 0) {
+        for (const warning of nearLimitWarnings) {
+          writeText(stdout, `  ! ${warning}`);
+        }
+      }
       writeText(
         stdout,
         `Selected profile: ${profile.profile} - ${profile.status}`,

package/src/commands/login.test.ts

@@ -0,0 +1,247 @@
+/**
+ * Tests for the `offrouter login` command.
+ *
+ * Mocks `offrouter-core` functions so the login command runs without real OAuth.
+ * FileSecretStore is NOT mocked; it runs against a real temp directory.
+ */
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { mkdtempSync, rmSync, existsSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+
+// ---------------------------------------------------------------------------
+// Mock offrouter-core for login tests
+// ---------------------------------------------------------------------------
+const mocks = vi.hoisted(() => ({
+  mockRunOAuthLogin: vi.fn(),
+  mockGetOAuthTokens: vi.fn(),
+  mockIsOAuthTokenExpired: vi.fn(),
+  mockRefreshTokens: vi.fn(),
+  mockResolveClientId: vi.fn(),
+  mockResolveOffRouterHome: vi.fn(),
+}));
+
+// Keep FileSecretStore real but mock the core functions.
+vi.mock("offrouter-core", async () => {
+  const actual = await vi.importActual<typeof import("offrouter-core")>("offrouter-core");
+  return {
+    ...actual,
+    runOAuthLogin: mocks.mockRunOAuthLogin,
+    getOAuthTokens: mocks.mockGetOAuthTokens,
+    isOAuthTokenExpired: mocks.mockIsOAuthTokenExpired,
+    refreshTokens: mocks.mockRefreshTokens,
+    resolveClientId: mocks.mockResolveClientId,
+    resolveOffRouterHome: mocks.mockResolveOffRouterHome,
+  };
+});
+
+import { createProgram } from "../index.js";
+
+function capture(
+  argv: string[],
+  env: NodeJS.ProcessEnv = { ...process.env },
+): Promise<{ code: number; stdout: string; stderr: string }> {
+  return new Promise((resolve) => {
+    let stdout = "";
+    let stderr = "";
+    const program = createProgram({
+      env,
+      stdout: {
+        write(chunk: string) {
+          stdout += chunk;
+          return true;
+        },
+      },
+      stderr: {
+        write(chunk: string) {
+          stderr += chunk;
+          return true;
+        },
+      },
+    });
+
+    program
+      .parseAsync(argv, { from: "user" })
+      .then(() => {
+        resolve({ code: 0, stdout, stderr });
+      })
+      .catch((err) => {
+        const code = err?.exitCode ?? 1;
+        resolve({ code, stdout, stderr });
+      });
+  });
+}
+
+describe("offrouter login command", () => {
+  let tmpHome: string;
+
+  beforeEach(() => {
+    vi.resetAllMocks();
+    tmpHome = mkdtempSync(join(tmpdir(), "offrouter-login-test-"));
+    mocks.mockResolveOffRouterHome.mockReturnValue(tmpHome);
+  });
+
+  afterEach(() => {
+    if (tmpHome && existsSync(tmpHome)) {
+      rmSync(tmpHome, { recursive: true, force: true });
+    }
+  });
+
+  describe("help", () => {
+    it("offrouter login --help shows login command", async () => {
+      const { code, stdout, stderr } = await capture(["login", "--help"]);
+      expect(code).toBe(0);
+      const output = stdout + stderr;
+      expect(output).toMatch(/login/i);
+      expect(output).toMatch(/provider/i);
+      expect(output).toMatch(/anthropic/i);
+      expect(output).toMatch(/openai/i);
+    });
+  });
+
+  describe("login <provider>", () => {
+    it("calls runOAuthLogin with the provider and stores tokens", async () => {
+      mocks.mockResolveClientId.mockReturnValue("test-client-id");
+      mocks.mockRunOAuthLogin.mockResolvedValue({
+        provider: "anthropic",
+        redirectUri: "http://127.0.0.1:1456/callback",
+        expiresAt: Date.now() + 3600_000,
+        scope: "api offline_access",
+      });
+
+      const { code, stdout, stderr } = await capture(
+        ["login", "anthropic"],
+        {
+          ...process.env,
+          OFFROUTER_HOME: tmpHome,
+        },
+      );
+
+      expect(code).toBe(0);
+      expect(stderr).toBe("");
+
+      expect(mocks.mockRunOAuthLogin).toHaveBeenCalledWith(
+        expect.objectContaining({
+          provider: "anthropic",
+          clientId: "test-client-id",
+        }),
+      );
+
+      expect(stdout).toMatch(/successful|Login/);
+      expect(stdout).toContain("anthropic");
+    });
+
+    it("prints error for unsupported provider", async () => {
+      const { code, stdout } = await capture(["login", "gemini"]);
+      expect(code).toBe(0);
+      expect(stdout).toMatch(/not supported/i);
+      expect(mocks.mockRunOAuthLogin).not.toHaveBeenCalled();
+    });
+
+    it("prints error when no client id is configured", async () => {
+      const { code, stdout } = await capture(
+        ["login", "anthropic"],
+        { ...process.env, OFFROUTER_HOME: tmpHome },
+      );
+      expect(code).toBe(0);
+      expect(stdout).toMatch(/client id required|client.*id/i);
+      expect(mocks.mockRunOAuthLogin).not.toHaveBeenCalled();
+    });
+  });
+
+  describe("login --list", () => {
+    it("shows providers with no tokens when none stored", async () => {
+      mocks.mockGetOAuthTokens.mockResolvedValue(undefined);
+
+      const { code, stdout } = await capture(
+        ["login", "--list"],
+        { ...process.env, OFFROUTER_HOME: tmpHome },
+      );
+      expect(code).toBe(0);
+      expect(stdout).toMatch(/OAuth providers/i);
+      expect(stdout).toContain("anthropic");
+      expect(stdout).toContain("openai");
+    });
+
+    it("shows active token status", async () => {
+      mocks.mockGetOAuthTokens.mockResolvedValue({
+        accessToken: "tok",
+        refreshToken: "refresh",
+        expiresAt: Date.now() + 3600_000,
+        obtainedAt: Date.now(),
+      });
+      mocks.mockIsOAuthTokenExpired.mockReturnValue(false);
+
+      const { code, stdout } = await capture(
+        ["login", "--list"],
+        { ...process.env, OFFROUTER_HOME: tmpHome },
+      );
+      expect(code).toBe(0);
+      expect(stdout).toContain("active");
+    });
+
+    it("shows expired token status", async () => {
+      mocks.mockGetOAuthTokens.mockResolvedValue({
+        accessToken: "tok",
+        refreshToken: "refresh",
+        expiresAt: Date.now() - 1000,
+        obtainedAt: Date.now() - 7200_000,
+      });
+      mocks.mockIsOAuthTokenExpired.mockReturnValue(true);
+
+      const { code, stdout } = await capture(
+        ["login", "--list"],
+        { ...process.env, OFFROUTER_HOME: tmpHome },
+      );
+      expect(code).toBe(0);
+      expect(stdout).toContain("expired");
+    });
+  });
+
+  describe("login --status <provider>", () => {
+    it("shows status for unsupported provider", async () => {
+      const { code, stdout } = await capture(
+        ["login", "--status", "gemini"],
+      );
+      expect(code).toBe(0);
+      expect(stdout).toMatch(/not supported/i);
+    });
+  });
+
+  describe("login --json", () => {
+    it("returns JSON for successful login", async () => {
+      mocks.mockResolveClientId.mockReturnValue("test-oa-id");
+      mocks.mockRunOAuthLogin.mockResolvedValue({
+        provider: "openai",
+        redirectUri: "http://127.0.0.1:1455/callback",
+        expiresAt: 9999999999000,
+        scope: "offline_access",
+      });
+
+      const { code, stdout } = await capture(
+        ["login", "openai", "--json"],
+        {
+          ...process.env,
+          OFFROUTER_HOME: tmpHome,
+        },
+      );
+
+      expect(code).toBe(0);
+      const json = JSON.parse(stdout) as Record<string, unknown>;
+      expect(json.ok).toBe(true);
+      expect(json.provider).toBe("openai");
+      expect(json.redirectUri).toContain("127.0.0.1");
+    });
+
+    it("returns JSON error for unsupported provider", async () => {
+      const { code, stdout } = await capture(
+        ["login", "gemini", "--json"],
+        { ...process.env, OFFROUTER_HOME: tmpHome },
+      );
+
+      expect(code).toBe(0);
+      const json = JSON.parse(stdout) as Record<string, unknown>;
+      expect(json.error).toMatch(/not supported/i);
+    });
+  });
+});