@xtruder/opencode-claude-max-plugin 0.1.17 → 0.2.0

package/build/usage.d.ts

@@ -17,12 +17,79 @@ export interface UsageData {
     } | null;
 }
 /**
- * Fetch current Claude subscription usage.
- * Returns null if not using OAuth credentials.
+ * Lightweight usage from response headers (5h/7d only).
+ * Updated by the server plugin's wrappedFetch on every inference call.
  */
-export declare function fetchUsage(credentialsPath?: string): Promise<UsageData | null>;
+export interface HeaderUsage {
+    fiveHourUtil?: number;
+    sevenDayUtil?: number;
+    fiveHourReset?: number;
+    sevenDayReset?: number;
+    overageStatus?: string;
+}
+/**
+ * Shared cache file format. Contains the best available data from
+ * both the API and response headers, plus metadata for rate-limit-aware polling.
+ */
+export interface UsageCache {
+    /** Full API response (null if never fetched or no credentials) */
+    api: UsageData | null;
+    /** Lightweight header data (null if no inference has run yet) */
+    headers: HeaderUsage | null;
+    /** When the cache was last written (epoch ms) */
+    updatedAt: number;
+    /** When the API was last successfully fetched (epoch ms, 0 = never) */
+    apiFetchedAt: number;
+    /** When the API rate limit expires (epoch ms, 0 = not rate limited) */
+    apiRateLimitUntil: number;
+}
+/**
+ * In-memory header usage, updated on every inference call.
+ * Only meaningful in the server/worker process.
+ */
+export declare const cachedUsage: HeaderUsage;
+/**
+ * Read the shared cache file. Returns empty cache if not found.
+ */
+export declare function readUsageCache(): UsageCache;
+/**
+ * Transactional read-modify-write of the cache file.
+ * Uses a lockfile for mutual exclusion and write-to-tmp+rename for atomicity.
+ */
+export declare function writeUsageCache(update: Partial<UsageCache>): void;
+/**
+ * Persist current in-memory header usage to the cache file.
+ * Called from the server plugin's wrappedFetch after parsing response headers.
+ */
+export declare function persistCachedUsage(): void;
+/**
+ * Fetch current Claude subscription usage from the API.
+ * Returns { data, retryAfterMs } so callers can track rate limit state.
+ * retryAfterMs > 0 means the API returned 429 with a Retry-After header.
+ */
+export declare function fetchUsage(credentialsPath?: string): Promise<{
+    data: UsageData | null;
+    retryAfterMs: number;
+}>;
+/**
+ * Convert HeaderUsage (from response headers) to UsageData (API format).
+ * Provides a partial view — only 5h and 7d windows are available.
+ */
+export declare function headerUsageToUsageData(h: HeaderUsage): UsageData;
+/**
+ * Get the best available UsageData from the cache by merging both sources.
+ * - Headers provide the freshest 5h/7d numbers (updated every inference call)
+ * - API provides per-model breakdown and extra usage (updated less frequently)
+ * When both exist, header 5h/7d values override API values since they're fresher.
+ */
+export declare function bestUsageFromCache(cache: UsageCache): UsageData | null;
+/**
+ * Check if the API should be called.
+ * Returns true when not rate limited AND either never fetched or TTL expired.
+ */
+export declare function shouldFetchApi(cache: UsageCache): boolean;
 /**
- * Format usage data as a display string matching Claude Code's /usage output.
+ * Format a reset timestamp as relative time.
  */
-export declare function formatUsage(data: UsageData): string;
+export declare function formatReset(resetsAt: string | null): string;
 //# sourceMappingURL=usage.d.ts.map

package/build/usage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,WAAW,GAAG,IAAI,CAAA;IAC7B,SAAS,EAAE,WAAW,GAAG,IAAI,CAAA;IAC7B,gBAAgB,EAAE,WAAW,GAAG,IAAI,CAAA;IACpC,cAAc,EAAE,WAAW,GAAG,IAAI,CAAA;IAClC,oBAAoB,EAAE,WAAW,GAAG,IAAI,CAAA;IACxC,gBAAgB,EAAE,WAAW,GAAG,IAAI,CAAA;IACpC,WAAW,EAAE;QACX,UAAU,EAAE,OAAO,CAAA;QACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;QAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;QAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAC3B,GAAG,IAAI,CAAA;CACT;AAID;;;GAGG;AACH,wBAAsB,UAAU,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAuBpF;AA0CD;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAwDnD"}
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"AA0BA,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;CACzB;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,WAAW,GAAG,IAAI,CAAA;IAC7B,SAAS,EAAE,WAAW,GAAG,IAAI,CAAA;IAC7B,gBAAgB,EAAE,WAAW,GAAG,IAAI,CAAA;IACpC,cAAc,EAAE,WAAW,GAAG,IAAI,CAAA;IAClC,oBAAoB,EAAE,WAAW,GAAG,IAAI,CAAA;IACxC,gBAAgB,EAAE,WAAW,GAAG,IAAI,CAAA;IACpC,WAAW,EAAE;QACX,UAAU,EAAE,OAAO,CAAA;QACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;QAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;QAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAC3B,GAAG,IAAI,CAAA;CACT;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,kEAAkE;IAClE,GAAG,EAAE,SAAS,GAAG,IAAI,CAAA;IACrB,iEAAiE;IACjE,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;IAC3B,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAA;IACjB,uEAAuE;IACvE,YAAY,EAAE,MAAM,CAAA;IACpB,uEAAuE;IACvE,iBAAiB,EAAE,MAAM,CAAA;CAC1B;AAID;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,WAAgB,CAAA;AA8D1C;;GAEG;AACH,wBAAgB,cAAc,IAAI,UAAU,CAS3C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAoBjE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC;AAMD;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC;IAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CA0B3D;AAID;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,WAAW,GAAG,SAAS,CAsBhE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,IAAI,CAmBtE;AAKD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAMzD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAwB3D"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xtruder/opencode-claude-max-plugin",
-  "version": "0.1.17",
+  "version": "0.2.0",
   "description": "OpenCode plugin for Claude Max/Pro subscription via @anthropic-ai/sdk - uses Claude Code OAuth credentials",
   "keywords": [
     "ai-sdk",
@@ -11,7 +11,10 @@
   ],
   "license": "MIT",
   "files": [
-    "build"
+    "build",
+    "src/tui.tsx",
+    "src/usage.ts",
+    "src/credentials.ts"
   ],
   "type": "module",
   "main": "build/index.js",
@@ -20,10 +23,22 @@
     ".": {
       "import": "./build/index.js",
       "types": "./build/index.d.ts"
+    },
+    "./server": {
+      "import": "./build/server.js",
+      "config": {}
+    },
+    "./tui": {
+      "import": "./src/tui.tsx",
+      "config": {
+        "enabled": true,
+        "sidebar": true,
+        "poll_interval": 60
+      }
     }
   },
   "scripts": {
-    "build": "bun build ./src/index.ts --outdir ./build --target node --format esm --packages external && bun x tsc --emitDeclarationOnly --declaration --outDir build",
+    "build": "bun build ./src/index.ts ./src/server.ts --outdir ./build --target node --format esm --packages external && bun x tsc --emitDeclarationOnly --declaration --outDir build",
     "dev": "bun run dev:config && bun build ./src/index.ts --outdir ./build --target node --format esm --packages external --watch",
     "dev:config": "bun scripts/dev-config.ts",
     "test": "bun test --concurrency 1 src/*.test.ts",
@@ -49,9 +64,30 @@
     "typescript": "^5.7.0"
   },
   "peerDependencies": {
-    "@ai-sdk/provider": ">=2.0.0"
+    "@ai-sdk/provider": ">=2.0.0",
+    "@opencode-ai/plugin": "*",
+    "@opentui/core": "*",
+    "@opentui/solid": "*",
+    "solid-js": "*"
+  },
+  "peerDependenciesMeta": {
+    "@opencode-ai/plugin": {
+      "optional": true
+    },
+    "@opentui/core": {
+      "optional": true
+    },
+    "@opentui/solid": {
+      "optional": true
+    },
+    "solid-js": {
+      "optional": true
+    }
   },
   "simple-git-hooks": {
     "pre-commit": "bun run lint && bun run format:check"
+  },
+  "engines": {
+    "opencode": ">=1.3.13"
   }
 }

package/src/credentials.ts

@@ -0,0 +1,156 @@
+import { readFileSync, existsSync } from "node:fs"
+import { execSync } from "node:child_process"
+import { join } from "node:path"
+import { homedir } from "node:os"
+
+export interface ClaudeOAuthCredentials {
+  accessToken: string
+  refreshToken: string
+  expiresAt: number
+  scopes: string[]
+  subscriptionType: string | null
+}
+
+interface CredentialsFile {
+  claudeAiOauth?: ClaudeOAuthCredentials
+}
+
+/**
+ * How long to cache credentials in memory before re-reading from disk.
+ */
+const CREDENTIAL_CACHE_TTL_MS = 30_000
+
+/**
+ * Buffer before expiry at which we consider the token "near expiry"
+ * and trigger a CLI refresh. 60 seconds matches opencode-claude-auth.
+ */
+const EXPIRY_BUFFER_MS = 60_000
+
+let cachedCreds: ClaudeOAuthCredentials | null = null
+let cachedAt = 0
+let cachedPath: string | undefined
+
+/**
+ * Default path to Claude Code credentials file.
+ */
+export function getCredentialsPath(): string {
+  return join(homedir(), ".claude", ".credentials.json")
+}
+
+/**
+ * Read OAuth credentials from Claude Code's credentials file.
+ * Returns null if the file doesn't exist or can't be parsed.
+ */
+export function readClaudeCredentials(path?: string): ClaudeOAuthCredentials | null {
+  const credPath = path ?? getCredentialsPath()
+
+  if (!existsSync(credPath)) return null
+
+  try {
+    const raw = readFileSync(credPath, "utf-8")
+    const parsed: CredentialsFile = JSON.parse(raw)
+    if (!parsed.claudeAiOauth?.accessToken) return null
+    return parsed.claudeAiOauth
+  } catch {
+    return null
+  }
+}
+
+/**
+ * Check if credentials are expired (with 60s buffer).
+ */
+export function isExpired(creds: ClaudeOAuthCredentials): boolean {
+  return Date.now() > creds.expiresAt - EXPIRY_BUFFER_MS
+}
+
+/**
+ * Run the Claude CLI to trigger an OAuth token refresh.
+ * The CLI writes refreshed credentials to ~/.claude/.credentials.json.
+ * Retries once on failure (matching opencode-claude-auth behavior).
+ */
+export function refreshViaCli(): boolean {
+  const maxAttempts = 2
+  for (let i = 0; i < maxAttempts; i++) {
+    try {
+      execSync("claude -p . --model haiku", {
+        timeout: 60_000,
+        encoding: "utf-8",
+        env: { ...process.env, TERM: "dumb" },
+        stdio: "ignore",
+      })
+      return true
+    } catch {
+      // Non-fatal: retry once, then give up
+    }
+  }
+  return false
+}
+
+/**
+ * Read credentials, refreshing via Claude CLI if the token is near expiry.
+ * Returns null only if credentials are completely unavailable.
+ */
+export function refreshIfNeeded(path?: string): ClaudeOAuthCredentials | null {
+  const creds = readClaudeCredentials(path)
+  if (!creds) return null
+
+  // Token still fresh
+  if (!isExpired(creds)) return creds
+
+  // Token near expiry — run Claude CLI to refresh
+  console.warn("[anthropic-sdk-provider] OAuth token near expiry, refreshing via Claude CLI...")
+  const refreshed = refreshViaCli()
+  if (!refreshed) {
+    console.warn("[anthropic-sdk-provider] CLI refresh failed. Token may be expired.")
+    // Return the existing creds anyway — they might still work for a bit
+    return creds
+  }
+
+  // Re-read from disk after CLI refresh
+  const fresh = readClaudeCredentials(path)
+  if (fresh && !isExpired(fresh)) {
+    console.warn("[anthropic-sdk-provider] Token refreshed successfully.")
+    return fresh
+  }
+
+  // CLI ran but didn't produce a fresh token — return what we have
+  return fresh ?? creds
+}
+
+/**
+ * Get cached credentials with automatic refresh.
+ * Uses in-memory caching with a 30-second TTL to avoid
+ * hitting the filesystem on every request.
+ * When the cached token is near expiry, triggers a CLI refresh.
+ */
+export function getCachedCredentials(path?: string): ClaudeOAuthCredentials | null {
+  const now = Date.now()
+  const resolvedPath = path ?? cachedPath
+
+  // Return cached if still fresh and not near expiry
+  if (cachedCreds && now - cachedAt < CREDENTIAL_CACHE_TTL_MS && !isExpired(cachedCreds)) {
+    return cachedCreds
+  }
+
+  // Read and potentially refresh
+  const fresh = refreshIfNeeded(resolvedPath)
+  if (fresh) {
+    cachedCreds = fresh
+    cachedAt = now
+    cachedPath = resolvedPath
+  } else {
+    cachedCreds = null
+  }
+
+  return cachedCreds
+}
+
+/**
+ * Clear the in-memory credential cache.
+ * Forces the next getCachedCredentials() call to re-read from disk.
+ */
+export function clearCredentialCache(): void {
+  cachedCreds = null
+  cachedAt = 0
+  cachedPath = undefined
+}