feat: added Neuralwatt provider usage to providers-quota extension

Author: wladimiiir

packages/extensions/extensions/providers-quota-extension/.env.template

@@ -1,3 +1,4 @@
-# Set your API keys here for the providers you want to monitor
+# Set your API keys here to override the ones from AiderDesk provider settings (optional)
 SYNTHETIC_API_KEY=
 ZAI_API_KEY=
+NEURALWATT_API_KEY=

packages/extensions/extensions/providers-quota-extension/README.md

@@ -1,11 +1,16 @@
 # Providers Quota Extension
 
-Displays API quota information for **Synthetic** and **Z.AI** providers in the AiderDesk task status bar. The extension automatically shows the relevant quota based on the active agent profile's provider.
+Displays API quota information for **Synthetic**, **Z.AI**, and **Neuralwatt** providers in the AiderDesk task status bar. The extension automatically shows the relevant quota based on the active agent profile's provider.
 
 ## Features
 
 - **Synthetic Provider**: Shows used/limit with percentage and progress bar
 - **Z.AI Provider**: Shows 5-hour and weekly usage percentages with progress bars
+- **Neuralwatt Provider**: Shows quota based on account type:
+  - **Subscription**: kWh used/included with percentage and renewal date
+  - **Pay-as-you-go**: Credits remaining/total with percentage
+- API keys are automatically loaded from AiderDesk provider settings
+- Optional `.env` file to override API keys
 - Automatic provider detection based on active agent profile
 - Quota data cached for 1 minute to minimize API calls
 
@@ -16,46 +21,42 @@ Displays API quota information for **Synthetic** and **Z.AI** providers in the A
    cp -r providers-quota-extension ~/.aider-desk/extensions/
    ```
 
-2. Create a `.env` file in the extension folder with your API key(s):
-   ```bash
-   cd ~/.aider-desk/extensions/providers-quota-extension
-   echo "SYNTHETIC_API_KEY=your_synthetic_key_here" > .env
-   echo "ZAI_API_KEY=your_zai_key_here" >> .env
-   ```
-
-3. Install the dotenv dependency:
+2. Install the dotenv dependency:
    ```bash
    npm install
    ```
 
-4. Restart AiderDesk
+3. Restart AiderDesk
 
 ## Usage
 
 The extension automatically displays quota information based on the active agent profile:
 
 | Provider | Display Format |
 |----------|---------------|
-| `synthetic` | `Quota: 54/100 (54%)` with progress bar |
-| `zai-plan` | `Z.AI: 5h: 12% Weekly: 45%` with two progress bars |
+| `synthetic` | `Synthetic: 54/100 (54%)` |
+| `zai-plan` | `Z.ai: 5 Hours: 12% \| Weekly: 45%` |
+| `neuralwatt` (subscription) | `Neuralwatt: 13.90/20.0 kWh (70%)` |
+| `neuralwatt` (pay-as-you-go) | `Neuralwatt: $32.68/$52.34 (62%)` |
 
 If the agent profile's provider doesn't match a configured provider, no quota is displayed.
 
 ## Configuration
 
-### Environment Variables
+### API Keys
 
-Create a `.env` file in the extension folder (`~/.aider-desk/extensions/providers-quota-extension/.env`):
+API keys are **automatically loaded from AiderDesk provider settings** — no manual configuration required. Simply ensure your API keys are set in the AiderDesk Providers settings page.
+
+To override the API keys from AiderDesk settings, create a `.env` file in the extension folder (`~/.aider-desk/extensions/providers-quota-extension/.env`):
 
 ```env
-# For Synthetic provider (optional)
+# Override API keys (optional — only needed to override AiderDesk settings)
 SYNTHETIC_API_KEY=your_synthetic_api_key
-
-# For Z.AI provider (optional)
 ZAI_API_KEY=your_zai_api_key
+NEURALWATT_API_KEY=your_neuralwatt_api_key
 ```
 
-You can configure either or both providers. Only configure the ones you use.
+You can configure any combination of providers. Only configure the ones you use.
 
 ### Multiple Environment Files
 
@@ -112,12 +113,53 @@ The extension supports multiple `.env` files loaded in priority order (later fil
   }
   ```
 
+### Neuralwatt API
+
+- **Endpoint**: `https://api.neuralwatt.com/v1/quota`
+- **Response Format** (subscription):
+  ```json
+  {
+    "snapshot_at": "2026-04-16T18:30:00Z",
+    "balance": {
+      "credits_remaining_usd": 32.6774,
+      "total_credits_usd": 52.34,
+      "credits_used_usd": 19.6626,
+      "accounting_method": "energy"
+    },
+    "subscription": {
+      "plan": "standard",
+      "status": "active",
+      "billing_interval": "month",
+      "current_period_start": "2026-04-11T05:05:25Z",
+      "current_period_end": "2026-05-11T05:05:25Z",
+      "auto_renew": true,
+      "kwh_included": 20.0,
+      "kwh_used": 13.9023,
+      "kwh_remaining": 6.0977,
+      "in_overage": false
+    }
+  }
+  ```
+- **Response Format** (pay-as-you-go — `subscription` is `null`):
+  ```json
+  {
+    "snapshot_at": "2026-04-16T18:30:00Z",
+    "balance": {
+      "credits_remaining_usd": 32.6774,
+      "total_credits_usd": 52.34,
+      "credits_used_usd": 19.6626,
+      "accounting_method": "energy"
+    },
+    "subscription": null
+  }
+  ```
+
 ## Troubleshooting
 
 ### Quota not displayed
 
-1. Verify that the correct API key is set in `.env`
-2. Ensure the agent profile's provider matches (`synthetic` or `zai-plan`)
+1. Verify that the API key is set in AiderDesk Providers settings or `.env`
+2. Ensure the agent profile's provider matches (`synthetic`, `zai-plan`, or `neuralwatt`)
 3. Check AiderDesk logs for error messages
 4. Verify network connectivity to the API endpoints
 
@@ -149,7 +191,7 @@ providers-quota-extension/
 ├── index.ts              # Main extension logic
 ├── StatusBarComponent.jsx # React JSX for UI rendering
 ├── package.json          # Dependencies
-├── .env                  # API keys (create this)
+├── .env.template         # Template for API key overrides (create .env from this)
 └── README.md             # This file
 ```
 
@@ -173,10 +215,28 @@ The `getUIExtensionData` method returns:
   } | null,
   zai: {
     hourlyPercentage: number,
-    weeklyPercentage: number
+    weeklyPercentage: number,
+    hourlyNextResetTime?: number,
+    weeklyNextResetTime?: number
+  } | null,
+  neuralwatt: {
+    isSubscription: boolean,
+    // Subscription fields
+    kwhUsed?: number,
+    kwhIncluded?: number,
+    kwhPercentage?: number,
+    currentPeriodEnd?: string,
+    plan?: string,
+    inOverage?: boolean,
+    // Pay-as-you-go fields
+    creditsRemaining?: number,
+    creditsTotal?: number,
+    creditsPercentage?: number,
+    accountingMethod?: string
   } | null,
   hasSynthetic: boolean,
-  hasZai: boolean
+  hasZai: boolean,
+  hasNeuralwatt: boolean
 }
 ```
 

packages/extensions/extensions/providers-quota-extension/StatusBarComponent.jsx

@@ -11,30 +11,76 @@
     });
   };
 
-  return agentProfile?.provider === 'synthetic' && data?.synthetic ? (
-    data.synthetic.error ? (
+  if (agentProfile?.provider === 'synthetic' && data?.synthetic) {
+    return data.synthetic.error ? (
       <span className="pt-1">Quota unavailable</span>
     ) : (
       <div className="flex items-center gap-2 pt-1 justify-between w-full">
-        <span>Synthetic:</span>
+        <span>Usage:</span>
         <div className="flex items-center gap-2">
           <span>{data.synthetic.used}/{data.synthetic.limit}</span>
           <span>({data.synthetic.percentage}%)</span>
         </div>
       </div>
-    )
-  ) : agentProfile?.provider === 'zai-plan' && data?.zai ? (
-    <div className="flex items-center gap-2 pt-1 justify-between w-full">
-      <span>Z.ai:</span>
-      <div className="flex items-center gap-2">
-        <ui.Tooltip content={data.zai.hourlyNextResetTime ? `Resets at ${formatResetTime(data.zai.hourlyNextResetTime)}` : ''}>
-          <span>5 Hours: {data.zai.hourlyPercentage}%</span>
-        </ui.Tooltip>
-        <span>|</span>
-        <ui.Tooltip content={data.zai.weeklyNextResetTime ? `Resets at ${formatResetTime(data.zai.weeklyNextResetTime)}` : ''}>
-          <span>Weekly: {data.zai.weeklyPercentage}%</span>
-        </ui.Tooltip>
+    );
+  }
+
+  if (agentProfile?.provider === 'zai-plan' && data?.zai) {
+    return (
+      <div className="flex items-center gap-2 pt-1 justify-between w-full">
+        <span>Usage:</span>
+        <div className="flex items-center gap-2">
+          <ui.Tooltip content={data.zai.hourlyNextResetTime ? `Resets at ${formatResetTime(data.zai.hourlyNextResetTime)}` : ''}>
+            <span>5 Hours: {data.zai.hourlyPercentage}%</span>
+          </ui.Tooltip>
+          <span>|</span>
+          <ui.Tooltip content={data.zai.weeklyNextResetTime ? `Resets at ${formatResetTime(data.zai.weeklyNextResetTime)}` : ''}>
+            <span>Weekly: {data.zai.weeklyPercentage}%</span>
+          </ui.Tooltip>
+        </div>
       </div>
-    </div>
-  ) : null;
+    );
+  }
+
+  if (agentProfile?.provider === 'neuralwatt' && data?.neuralwatt) {
+    const nw = data.neuralwatt;
+
+    if (nw.isSubscription) {
+      const kwhUsed = nw.kwhUsed?.toFixed(2) ?? '0.00';
+      const kwhIncluded = nw.kwhIncluded?.toFixed(1) ?? '0.0';
+      const periodEnd = nw.currentPeriodEnd ? formatResetTime(nw.currentPeriodEnd) : null;
+
+      return (
+        <div className="flex items-center gap-2 pt-1 justify-between w-full">
+          <span>Usage:</span>
+          <div className="flex items-center gap-2">
+            <ui.Tooltip content={periodEnd ? `Renews at ${periodEnd}` : ''}>
+              <span>{kwhUsed}/{kwhIncluded} kWh</span>
+            </ui.Tooltip>
+            <span>({nw.kwhPercentage}%)</span>
+            {nw.inOverage && (
+              <span className="text-red-400 text-xs">overage</span>
+            )}
+          </div>
+        </div>
+      );
+    }
+
+    const creditsRemaining = nw.creditsRemaining?.toFixed(2) ?? '0.00';
+    const creditsTotal = nw.creditsTotal?.toFixed(2) ?? '0.00';
+
+    return (
+      <div className="flex items-center gap-2 pt-1 justify-between w-full">
+        <span>Neuralwatt:</span>
+        <div className="flex items-center gap-2">
+          <ui.Tooltip content={`Accounting: ${nw.accountingMethod || 'energy'}`}>
+            <span>${creditsRemaining}/${creditsTotal}</span>
+          </ui.Tooltip>
+          <span>({nw.creditsPercentage}%)</span>
+        </div>
+      </div>
+    );
+  }
+
+  return null;
 }