@slkiser/opencode-quota 1.2.0 → 1.4.0

package/README.md

@@ -1,4 +1,4 @@
-# opencode-quota
+# Opencode Quota
 
 Quota and token tracking for OpenCode providers via Toasts and Commands with no LLM calls.
 
@@ -10,7 +10,7 @@ Quota and token tracking for OpenCode providers via Toasts and Commands with no
 
 **Token Report Commands** - Track token usage and estimated costs across sessions.
 
-![Image of /quota and /quota_daily outputs](https://github.com/slkiser/opencode-quota/blob/main/quota.png)
+![Image of /quota and /tokens_daily outputs](https://github.com/slkiser/opencode-quota/blob/main/quota.png)
 
 ## Installation
 
@@ -22,9 +22,7 @@ Add to your `opencode.json`:
 }
 ```
 
-## Quick Start
-
-Enable the providers you use:
+Then enable the providers you use:
 
 ```jsonc
 {
@@ -36,54 +34,72 @@ Enable the providers you use:
 }
 ```
 
-That's it. Toasts appear automatically after main agent responses.
+That's it. Toasts appear automatically after assistant responses.
+
+> **LLM Agents:** Ask your agent to install `https://github.com/slkiser/opencode-quota` with the providers you have enabled. See [LLM Agent Installation Instructions](#llm-agent-installation-instructions) for details.
 
 ## Commands
 
-### Token Reports
+| Command                  | Description                                      |
+| ------------------------ | ------------------------------------------------ |
+| `/quota`                 | Show quota toast (verbose)                       |
+| `/quota_status`          | Show diagnostics (config, providers, accounts)   |
+|                          |                                                  |
+| `/tokens_today`          | Tokens used today (calendar day)                 |
+| `/tokens_daily`          | Tokens used in last 24 hours                     |
+| `/tokens_weekly`         | Tokens used in last 7 days                       |
+| `/tokens_monthly`        | Tokens used in last 30 days                      |
+| `/tokens_all`            | Tokens used all time                             |
+| `/tokens_session`        | Tokens used in current session                   |
+| `/tokens_between`        | Tokens between two dates (YYYY-MM-DD)            |
+|                          |                                                  |
+| `/firmware_reset_window` | Resets Firmware 5-hour window (requires confirm) |
 
-| Command           | Title                                                    |
-| ----------------- | -------------------------------------------------------- |
-| `/tokens_today`   | Tokens used (Today) (/tokens_today)                      |
-| `/tokens_daily`   | Tokens used (Last 24 Hours) (/tokens_daily)              |
-| `/tokens_weekly`  | Tokens used (Last 7 Days) (/tokens_weekly)               |
-| `/tokens_monthly` | Tokens used (Last 30 Days) (/tokens_monthly)             |
-| `/tokens_all`     | Tokens used (All Time) (/tokens_all)                     |
-| `/tokens_session` | Tokens used (Current Session) (/tokens_session)          |
-| `/tokens_between` | Tokens used (YYYY-MM-DD .. YYYY-MM-DD) (/tokens_between) |
+## Supported Providers
 
-### Quota Toast & Diagnostics
+| Provider           | Config ID            | Auth Source                                   |
+| ------------------ | -------------------- | --------------------------------------------- |
+| GitHub Copilot     | `copilot`            | OpenCode auth (automatic)                     |
+| OpenAI (Plus/Pro)  | `openai`             | OpenCode auth (automatic)                     |
+| Firmware AI        | `firmware`           | OpenCode auth or API key                      |
+| Chutes AI          | `chutes`             | OpenCode auth or API key                      |
+| Google Antigravity | `google-antigravity` | Multi-account via `opencode-antigravity-auth` |
 
-| Command         | Title                             |
-| --------------- | --------------------------------- |
-| `/quota`        | Quota Toast (Verbose) (/quota)    |
-| `/quota_status` | Quota Diagnostics (/quota_status) |
+### Provider-Specific Setup
 
-### Legacy Aliases
+<details>
+<summary><strong>GitHub Copilot</strong> (usually no setup needed)</summary>
 
-The following `/quota_*` commands remain as backwards-compatible aliases:
+Copilot works automatically if OpenCode has Copilot configured and logged in.
 
-- `/quota_today` -> `/tokens_today`
-- `/quota_daily` -> `/tokens_daily`
-- `/quota_weekly` -> `/tokens_weekly`
-- `/quota_monthly` -> `/tokens_monthly`
-- `/quota_all` -> `/tokens_all`
-- `/quota_session` -> `/tokens_session`
-- `/quota_between` -> `/tokens_between`
+**Optional:** For more reliable quota reporting, provide a fine-grained PAT:
 
-## Supported Providers
+1. Create a fine-grained PAT at GitHub with **Account permissions > Plan > Read**
+2. Create `~/.config/opencode/copilot-quota-token.json`:
 
-| Provider           | Config id            | Notes                                         |
-| ------------------ | -------------------- | --------------------------------------------- |
-| GitHub Copilot     | `copilot`            | Uses OpenCode auth\*                          |
-| OpenAI (Plus/Pro)  | `openai`             | Uses OpenCode auth                            |
-| Firmware AI        | `firmware`           | Uses OpenCode auth or API key                 |
-| Chutes AI          | `chutes`             | Uses OpenCode auth or API key                 |
-| Google Antigravity | `google-antigravity` | Multi-account via `opencode-antigravity-auth` |
+```json
+{
+  "token": "github_pat_...",
+  "username": "your-username",
+  "tier": "pro"
+}
+```
+
+Tier options: `free`, `pro`, `pro+`, `business`, `enterprise`
+
+</details>
+
+<details>
+<summary><strong>OpenAI</strong> (no setup needed)</summary>
+
+OpenAI works automatically if OpenCode has OpenAI/ChatGPT configured.
+
+</details>
 
-### Firmware AI Setup
+<details>
+<summary><strong>Firmware AI</strong></summary>
 
-Firmware works automatically if OpenCode has Firmware configured. Alternatively, you can provide an API key in your `opencode.json`:
+Works automatically if OpenCode has Firmware configured. Alternatively, provide an API key:
 
 ```jsonc
 {
@@ -102,11 +118,16 @@ Firmware works automatically if OpenCode has Firmware configured. Alternatively,
 }
 ```
 
-The `apiKey` field supports the `{env:VAR_NAME}` syntax to reference environment variables, or you can provide the key directly.
+The `apiKey` field supports `{env:VAR_NAME}` syntax or a direct key.
 
-### Chutes AI Setup
+**Firmware-specific command:** Use `/firmware_reset_window confirm` to reset your 5-hour spending window (consumes 1 of 2 weekly resets). Running without `confirm` shows a warning first.
 
-Chutes works automatically if OpenCode has Chutes configured. Alternatively, you can provide an API key in your `opencode.json`:
+</details>
+
+<details>
+<summary><strong>Chutes AI</strong></summary>
+
+Works automatically if OpenCode has Chutes configured. Alternatively, provide an API key:
 
 ```jsonc
 {
@@ -125,64 +146,140 @@ Chutes works automatically if OpenCode has Chutes configured. Alternatively, you
 }
 ```
 
-### GitHub Copilot Setup (optional)
+</details>
 
-Copilot works with no extra setup as long as OpenCode already has Copilot configured and logged in.
+<details>
+<summary><strong>Google Antigravity</strong></summary>
 
-_Optional:_ if Copilot quota does not show up (or you want more reliable quota reporting), you can provide a fine-grained PAT so the plugin can use GitHub's public billing API:
-
-1. Create a fine-grained PAT at GitHub with **Account permissions > Plan > Read**
-2. Create `~/.config/opencode/copilot-quota-token.json`:
+Requires the `opencode-antigravity-auth` plugin for multi-account support:
 
 ```json
 {
-  "token": "github_pat_...",
-  "username": "your-username",
-  "tier": "pro"
+  "plugin": ["opencode-antigravity-auth", "@slkiser/opencode-quota"]
 }
 ```
 
-Tier options: `free`, `pro`, `pro+`, `business`, `enterprise`
+Account credentials are stored in `~/.config/opencode/antigravity-accounts.json`.
 
-\* The plugin reads Copilot auth from OpenCode. The PAT file is only a fallback for reliability.
+</details>
 
 ## Configuration Reference
 
 All options go under `experimental.quotaToast` in `opencode.json`:
 
-| Option              | Default      | Description                                 |
-| ------------------- | ------------ | ------------------------------------------- |
-| `enabled`           | `true`       | Enable/disable plugin                       |
-| `enableToast`       | `true`       | Show popup toasts                           |
-| `enabledProviders`  | `[]`         | Provider ids to query                       |
-| `minIntervalMs`     | `300000`     | Min ms between fetches (5 min)              |
-| `toastDurationMs`   | `9000`       | Toast display time                          |
-| `onlyCurrentModel`  | `false`      | Only show current model's quota             |
-| `showSessionTokens` | `true`       | Show per-model input/output tokens in toast |
-| `googleModels`      | `["CLAUDE"]` | Google models: `CLAUDE`, `G3PRO`, `G3FLASH` |
-| `debug`             | `false`      | Show debug info in toasts                   |
+| Option              | Default      | Description                                     |
+| ------------------- | ------------ | ----------------------------------------------- |
+| `enabled`           | `true`       | Enable/disable plugin                           |
+| `enableToast`       | `true`       | Show popup toasts                               |
+| `enabledProviders`  | `[]`         | Provider IDs to query (see table above)         |
+| `minIntervalMs`     | `300000`     | Minimum ms between API fetches (default: 5 min) |
+| `toastDurationMs`   | `9000`       | How long toasts display (ms)                    |
+| `onlyCurrentModel`  | `false`      | Only show quota for the current model           |
+| `showSessionTokens` | `true`       | Show per-model input/output tokens in toast     |
+| `googleModels`      | `["CLAUDE"]` | Google models: `CLAUDE`, `G3PRO`, `G3FLASH`     |
+| `debug`             | `false`      | Show debug info in toasts                       |
+
+## Troubleshooting
+
+Toast not appearing? Run `/quota_status` to check config and provider availability.
 
-### Example Configuration
+---
 
-Here's a complete example `opencode.json` with all common options:
+<details id="llm-agent-installation-instructions">
+<summary><strong>LLM Agent Installation Instructions</strong></summary>
+
+### For LLM Agents: How to Install and Configure
+
+This section provides instructions for LLM agents to install and configure `opencode-quota` based on the user's current OpenCode setup.
+
+#### Step 1: Check Current Configuration
+
+First, determine what providers the user has connected. You can:
+
+1. Read the user's `opencode.json` (typically at `~/.config/opencode/opencode.json`)
+2. Run `/connected` in OpenCode to see active providers
+3. Ask the user which providers they use
+
+#### Step 2: Install the Plugin
+
+Add the plugin to the user's `opencode.json`:
+
+```json
+{
+  "plugin": ["@slkiser/opencode-quota"]
+}
+```
+
+If the user already has plugins, append to the existing array.
+
+#### Step 3: Configure Providers
+
+Based on the user's connected providers, add the appropriate `enabledProviders`:
 
 ```jsonc
 {
-  "plugin": ["@slkiser/opencode-quota"],
   "experimental": {
     "quotaToast": {
-      "enabledProviders": ["copilot", "openai"],
-      "showSessionTokens": true,
-      "minIntervalMs": 300000,
-      "toastDurationMs": 9000,
+      "enabledProviders": [
+        // Add only the providers the user has configured:
+        // "copilot"            - if using GitHub Copilot
+        // "openai"             - if using OpenAI/ChatGPT
+        // "firmware"           - if using Firmware AI
+        // "chutes"             - if using Chutes AI
+        // "google-antigravity" - if using Google Antigravity (requires opencode-antigravity-auth)
+      ],
     },
   },
 }
 ```
 
-## Troubleshooting
+#### Provider Detection Guide
 
-Toast not appearing? Run `/quota_status` to check config and provider availability.
+| If user's config has...                     | Add to enabledProviders |
+| ------------------------------------------- | ----------------------- |
+| `github-copilot` provider or Copilot models | `"copilot"`             |
+| `openai` / `chatgpt` provider               | `"openai"`              |
+| `firmware` / `firmware-ai` provider         | `"firmware"`            |
+| `chutes` provider                           | `"chutes"`              |
+| `google` provider with antigravity models   | `"google-antigravity"`  |
+| `opencode-antigravity-auth` in plugins      | `"google-antigravity"`  |
+
+#### Example: Full Configuration
+
+For a user with Copilot and Google Antigravity:
+
+```jsonc
+{
+  "plugin": [
+    "opencode-antigravity-auth", // Required for google-antigravity
+    "@slkiser/opencode-quota",
+  ],
+  "experimental": {
+    "quotaToast": {
+      "enabledProviders": ["copilot", "google-antigravity"],
+      "googleModels": ["CLAUDE"], // Options: CLAUDE, G3PRO, G3FLASH
+      "minIntervalMs": 300000, // 5 minutes between fetches
+      "toastDurationMs": 9000, // Toast shows for 9 seconds
+    },
+  },
+}
+```
+
+#### Step 4: Verify Installation
+
+After configuration, instruct the user to:
+
+1. Restart OpenCode (or reload the window)
+2. Run `/quota_status` to verify providers are detected
+3. Run `/quota` to manually trigger a toast
+
+#### Common Issues
+
+- **Toast not showing**: Run `/quota_status` to diagnose
+- **Google Antigravity not working**: Ensure `opencode-antigravity-auth` plugin is installed and accounts are configured
+- **Copilot quota unreliable**: Consider setting up a fine-grained PAT (see Provider-Specific Setup above)
+
+</details>
 
 ## License
 

package/dist/lib/api-key-resolver.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Generic API key resolution from env vars, config files, and auth.json.
+ *
+ * Used by provider-specific config modules (firmware-config, chutes-config)
+ * to resolve API keys with consistent priority and behavior.
+ */
+/** A candidate config file path with its format */
+export interface ConfigCandidate {
+    path: string;
+    isJsonc: boolean;
+}
+/**
+ * Get candidate paths for opencode.json/opencode.jsonc files.
+ *
+ * Order: local (cwd) first, then global (~/.config/opencode).
+ * Within each location, .jsonc takes precedence over .json.
+ */
+export declare function getOpencodeConfigCandidatePaths(): ConfigCandidate[];
+/**
+ * Read and parse an opencode config file.
+ *
+ * @returns Parsed config with metadata, or null if file doesn't exist or is invalid
+ */
+export declare function readOpencodeConfig(filePath: string, isJsonc: boolean): Promise<{
+    config: unknown;
+    path: string;
+    isJsonc: boolean;
+} | null>;
+/** Result of API key resolution */
+export interface ApiKeyResult<Source extends string> {
+    key: string;
+    source: Source;
+}
+/** Environment variable definition for key resolution */
+export interface EnvVarDef<Source extends string> {
+    name: string;
+    source: Source;
+}
+/** Configuration for resolving an API key from multiple sources */
+export interface ResolveApiKeyConfig<Source extends string> {
+    /** Environment variables to check (in order) */
+    envVars: EnvVarDef<Source>[];
+    /** Extract API key from parsed config object. Returns null if not found. */
+    extractFromConfig: (config: unknown) => string | null;
+    /** Source label for opencode.json */
+    configJsonSource: Source;
+    /** Source label for opencode.jsonc */
+    configJsoncSource: Source;
+    /** Extract API key from auth.json data. Returns null if not found. */
+    extractFromAuth: (auth: unknown) => string | null;
+    /** Source label for auth.json */
+    authSource: Source;
+}
+/**
+ * Resolve an API key from multiple sources with consistent priority.
+ *
+ * Priority (first wins):
+ * 1. Environment variables (in order specified)
+ * 2. opencode.json/opencode.jsonc (local first, then global)
+ * 3. auth.json
+ *
+ * @returns API key and source, or null if not found
+ */
+export declare function resolveApiKey<Source extends string>(config: ResolveApiKeyConfig<Source>, readAuth: () => Promise<unknown | null>): Promise<ApiKeyResult<Source> | null>;
+/** Configuration for API key diagnostics */
+export interface DiagnosticsConfig<Source extends string> {
+    /** Environment variable names to check */
+    envVarNames: string[];
+    /** Resolver function to get the current key result */
+    resolve: () => Promise<ApiKeyResult<Source> | null>;
+}
+/**
+ * Get diagnostic info about API key configuration.
+ *
+ * Reports which sources were checked (env vars that exist, config files that exist)
+ * and whether a key was found.
+ */
+export declare function getApiKeyDiagnostics<Source extends string>(config: DiagnosticsConfig<Source>): Promise<{
+    configured: boolean;
+    source: Source | null;
+    checkedPaths: string[];
+}>;
+//# sourceMappingURL=api-key-resolver.d.ts.map

package/dist/lib/api-key-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-key-resolver.d.ts","sourceRoot":"","sources":["../../src/lib/api-key-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,IAAI,eAAe,EAAE,CAUnE;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,GACf,OAAO,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAAC,CASrE;AAED,mCAAmC;AACnC,MAAM,WAAW,YAAY,CAAC,MAAM,SAAS,MAAM;IACjD,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,yDAAyD;AACzD,MAAM,WAAW,SAAS,CAAC,MAAM,SAAS,MAAM;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,mEAAmE;AACnE,MAAM,WAAW,mBAAmB,CAAC,MAAM,SAAS,MAAM;IACxD,gDAAgD;IAChD,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;IAE7B,4EAA4E;IAC5E,iBAAiB,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAC;IAEtD,qCAAqC;IACrC,gBAAgB,EAAE,MAAM,CAAC;IAEzB,sCAAsC;IACtC,iBAAiB,EAAE,MAAM,CAAC;IAE1B,sEAAsE;IACtE,eAAe,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,CAAC;IAElD,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,MAAM,SAAS,MAAM,EACvD,MAAM,EAAE,mBAAmB,CAAC,MAAM,CAAC,EACnC,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,GACtC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAgCtC;AAED,4CAA4C;AAC5C,MAAM,WAAW,iBAAiB,CAAC,MAAM,SAAS,MAAM;IACtD,0CAA0C;IAC1C,WAAW,EAAE,MAAM,EAAE,CAAC;IAEtB,sDAAsD;IACtD,OAAO,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;CACrD;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,SAAS,MAAM,EAC9D,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC,GAChC,OAAO,CAAC;IACT,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC,CAyBD"}

package/dist/lib/api-key-resolver.js

@@ -0,0 +1,113 @@
+/**
+ * Generic API key resolution from env vars, config files, and auth.json.
+ *
+ * Used by provider-specific config modules (firmware-config, chutes-config)
+ * to resolve API keys with consistent priority and behavior.
+ */
+import { existsSync } from "fs";
+import { readFile } from "fs/promises";
+import { homedir } from "os";
+import { join } from "path";
+import { parseJsonOrJsonc } from "./jsonc.js";
+/**
+ * Get candidate paths for opencode.json/opencode.jsonc files.
+ *
+ * Order: local (cwd) first, then global (~/.config/opencode).
+ * Within each location, .jsonc takes precedence over .json.
+ */
+export function getOpencodeConfigCandidatePaths() {
+    const cwd = process.cwd();
+    const configBaseDir = process.env.XDG_CONFIG_HOME || join(homedir(), ".config");
+    return [
+        { path: join(cwd, "opencode.jsonc"), isJsonc: true },
+        { path: join(cwd, "opencode.json"), isJsonc: false },
+        { path: join(configBaseDir, "opencode", "opencode.jsonc"), isJsonc: true },
+        { path: join(configBaseDir, "opencode", "opencode.json"), isJsonc: false },
+    ];
+}
+/**
+ * Read and parse an opencode config file.
+ *
+ * @returns Parsed config with metadata, or null if file doesn't exist or is invalid
+ */
+export async function readOpencodeConfig(filePath, isJsonc) {
+    try {
+        if (!existsSync(filePath))
+            return null;
+        const content = await readFile(filePath, "utf-8");
+        const config = parseJsonOrJsonc(content, isJsonc);
+        return { config, path: filePath, isJsonc };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve an API key from multiple sources with consistent priority.
+ *
+ * Priority (first wins):
+ * 1. Environment variables (in order specified)
+ * 2. opencode.json/opencode.jsonc (local first, then global)
+ * 3. auth.json
+ *
+ * @returns API key and source, or null if not found
+ */
+export async function resolveApiKey(config, readAuth) {
+    // 1. Check environment variables (highest priority)
+    for (const envVar of config.envVars) {
+        const value = process.env[envVar.name]?.trim();
+        if (value && value.length > 0) {
+            return { key: value, source: envVar.source };
+        }
+    }
+    // 2. Check opencode.json/opencode.jsonc files
+    const candidates = getOpencodeConfigCandidatePaths();
+    for (const candidate of candidates) {
+        const result = await readOpencodeConfig(candidate.path, candidate.isJsonc);
+        if (!result)
+            continue;
+        const key = config.extractFromConfig(result.config);
+        if (key) {
+            return {
+                key,
+                source: result.isJsonc ? config.configJsoncSource : config.configJsonSource,
+            };
+        }
+    }
+    // 3. Fallback to auth.json
+    const auth = await readAuth();
+    const key = config.extractFromAuth(auth);
+    if (key) {
+        return { key, source: config.authSource };
+    }
+    return null;
+}
+/**
+ * Get diagnostic info about API key configuration.
+ *
+ * Reports which sources were checked (env vars that exist, config files that exist)
+ * and whether a key was found.
+ */
+export async function getApiKeyDiagnostics(config) {
+    const checkedPaths = [];
+    // Track env vars checked (only if they exist, even if empty)
+    for (const envVarName of config.envVarNames) {
+        if (process.env[envVarName] !== undefined) {
+            checkedPaths.push(`env:${envVarName}`);
+        }
+    }
+    // Track config files checked (only if they exist)
+    const candidates = getOpencodeConfigCandidatePaths();
+    for (const candidate of candidates) {
+        if (existsSync(candidate.path)) {
+            checkedPaths.push(candidate.path);
+        }
+    }
+    const result = await config.resolve();
+    return {
+        configured: result !== null,
+        source: result?.source ?? null,
+        checkedPaths,
+    };
+}
+//# sourceMappingURL=api-key-resolver.js.map

package/dist/lib/api-key-resolver.js.map

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

package/dist/lib/chutes-config.d.ts

@@ -14,15 +14,16 @@ export interface ChutesApiKeyResult {
 }
 /** Source of the resolved API key */
 export type ChutesKeySource = "env:CHUTES_API_KEY" | "opencode.json" | "opencode.jsonc" | "auth.json";
-/**
- * Get candidate paths for opencode.json/opencode.jsonc files
- */
-export declare function getOpencodeConfigCandidatePaths(): Array<{
-    path: string;
-    isJsonc: boolean;
-}>;
+export { getOpencodeConfigCandidatePaths } from "./api-key-resolver.js";
 /**
  * Resolve Chutes API key from all available sources.
+ *
+ * Priority (first wins):
+ * 1. Environment variable: CHUTES_API_KEY
+ * 2. opencode.json/opencode.jsonc: provider.chutes.options.apiKey
+ * 3. auth.json: chutes.key
+ *
+ * @returns API key and source, or null if not found
  */
 export declare function resolveChutesApiKey(): Promise<ChutesApiKeyResult | null>;
 /**

package/dist/lib/chutes-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chutes-config.d.ts","sourceRoot":"","sources":["../../src/lib/chutes-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,0CAA0C;AAC1C,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,eAAe,CAAC;CACzB;AAED,qCAAqC;AACrC,MAAM,MAAM,eAAe,GACvB,oBAAoB,GACpB,eAAe,GACf,gBAAgB,GAChB,WAAW,CAAC;AA8FhB;;GAEG;AACH,wBAAgB,+BAA+B,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAU3F;AAmBD;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CA2B9E;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAGxD;AAED;;GAEG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC;IACvD,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC,CAqBD"}
+{"version":3,"file":"chutes-config.d.ts","sourceRoot":"","sources":["../../src/lib/chutes-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAWH,0CAA0C;AAC1C,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,eAAe,CAAC;CACzB;AAED,qCAAqC;AACrC,MAAM,MAAM,eAAe,GACvB,oBAAoB,GACpB,eAAe,GACf,gBAAgB,GAChB,WAAW,CAAC;AAyChB,OAAO,EAAE,+BAA+B,EAAE,MAAM,uBAAuB,CAAC;AAExE;;;;;;;;;GASG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAY9E;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAGxD;AAED;;GAEG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC;IACvD,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC,CAKD"}