feat: Add Usage Status panel with alert threshold to the preferences.

Author: ethanyhou

com.microsoft.copilot.eclipse.core/src/com/microsoft/copilot/eclipse/core/Constants.java

@@ -18,6 +18,7 @@ private Constants() {
 
   public static final String PLUGIN_ID = "com.microsoft.copilot.eclipse";
   public static final String AUTO_SHOW_COMPLETION = "enableAutoCompletions";
+  public static final String USAGE_ALERT_THRESHOLD = "usageAlertThreshold";
   public static final String ENABLE_NEXT_EDIT_SUGGESTION = "enableNextEditSuggestion";
   public static final String ENABLE_STRICT_SSL = "enableStrictSsl";
   public static final String PROXY_KERBEROS_SP = "proxyKerberosSp";
@@ -35,6 +36,8 @@ private Constants() {
   public static final String CUSTOM_INSTRUCTIONS_WORKSPACE_ENABLED = "customInstructionsWorkspaceEnabled";
   public static final String CUSTOM_INSTRUCTIONS_GIT_COMMIT = "customInstructionsGitCommit";
   public static final String GITHUB_COPILOT_URL = "http://github.com";
+  public static final String GITHUB_COPILOT_SETTINGS_URL = "https://github.com/settings/copilot";
+  public static final String GITHUB_COPILOT_INDIVIDUAL_UPGRADE_URL = "https://gh.io/ghcp-individual-upgrade";
   @Deprecated
   public static final String QUICK_START_VERSION = "quickStartVersion";
   public static final String COPILOT_QUICK_START_VERSION = "copilotQuickStartVersion";

com.microsoft.copilot.eclipse.core/src/com/microsoft/copilot/eclipse/core/lsp/protocol/CopilotLanguageServerSettings.java

@@ -278,6 +278,8 @@ public static class CopilotSettings {
 
     private CopilotAgentSettings agent;
 
+    private int usageAlertThreshold;
+
     /**
      * Constructor.
      */
@@ -320,19 +322,29 @@ public void setAgent(CopilotAgentSettings agent) {
       this.agent = agent;
     }
 
+    public int getUsageAlertThreshold() {
+      return usageAlertThreshold;
+    }
+
+    public void setUsageAlertThreshold(int usageAlertThreshold) {
+      this.usageAlertThreshold = usageAlertThreshold;
+    }
+
     @Override
     public String toString() {
       ToStringBuilder builder = new ToStringBuilder(this);
       builder.append("mcpServers", mcpServers);
       builder.append("workspaceCopilotInstructions", workspaceCopilotInstructions);
       builder.append("gitCommitCopilotInstructions", gitCommitCopilotInstructions);
       builder.append("agent", agent);
+      builder.append("usageAlertThreshold", usageAlertThreshold);
       return builder.toString();
     }
 
     @Override
     public int hashCode() {
-      return Objects.hash(agent, gitCommitCopilotInstructions, mcpServers, workspaceCopilotInstructions);
+      return Objects.hash(agent, gitCommitCopilotInstructions, mcpServers, usageAlertThreshold,
+          workspaceCopilotInstructions);
     }
 
     @Override
@@ -346,7 +358,7 @@ public boolean equals(Object obj) {
       CopilotSettings other = (CopilotSettings) obj;
       return Objects.equals(agent, other.agent)
           && Objects.equals(gitCommitCopilotInstructions, other.gitCommitCopilotInstructions)
-          && Objects.equals(mcpServers, other.mcpServers)
+          && Objects.equals(mcpServers, other.mcpServers) && usageAlertThreshold == other.usageAlertThreshold
           && Objects.equals(workspaceCopilotInstructions, other.workspaceCopilotInstructions);
     }
   }

com.microsoft.copilot.eclipse.core/src/com/microsoft/copilot/eclipse/core/lsp/protocol/quota/CheckQuotaResult.java

@@ -11,9 +11,10 @@ public class CheckQuotaResult {
   private Quota chat;
   private Quota completions;
   private Quota premiumInteractions;
-  private IntervalQuota immediateUsageInterval;
-  private IntervalQuota extendedUsageInterval;
+  private TbbQuota immediateUsageInterval;
+  private TbbQuota extendedUsageInterval;
   private String resetDate;
+  private String resetDateUtc;
   private CopilotPlan copilotPlan;
 
   public Quota getChatQuota() {
@@ -40,28 +41,6 @@ public void setPremiumInteractionsQuota(Quota premiumInteractions) {
     this.premiumInteractions = premiumInteractions;
   }
 
-  /**
-   * Gets the immediate usage interval quota (for individual plans).
-   */
-  public IntervalQuota getImmediateUsageInterval() {
-    return immediateUsageInterval;
-  }
-
-  public void setImmediateUsageInterval(IntervalQuota immediateUsageInterval) {
-    this.immediateUsageInterval = immediateUsageInterval;
-  }
-
-  /**
-   * Gets the extended usage interval quota (for individual plans).
-   */
-  public IntervalQuota getExtendedUsageInterval() {
-    return extendedUsageInterval;
-  }
-
-  public void setExtendedUsageInterval(IntervalQuota extendedUsageInterval) {
-    this.extendedUsageInterval = extendedUsageInterval;
-  }
-
   public String getResetDate() {
     return resetDate;
   }
@@ -70,6 +49,14 @@ public void setResetDate(String resetDate) {
     this.resetDate = resetDate;
   }
 
+  public String getResetDateUtc() {
+    return resetDateUtc;
+  }
+
+  public void setResetDateUtc(String resetDateUtc) {
+    this.resetDateUtc = resetDateUtc;
+  }
+
   public CopilotPlan getCopilotPlan() {
     return copilotPlan;
   }
@@ -78,10 +65,26 @@ public void setCopilotPlan(CopilotPlan copilotPlan) {
     this.copilotPlan = copilotPlan;
   }
 
+  public TbbQuota getImmediateUsageInterval() {
+    return immediateUsageInterval;
+  }
+
+  public void setImmediateUsageInterval(TbbQuota immediateUsageInterval) {
+    this.immediateUsageInterval = immediateUsageInterval;
+  }
+
+  public TbbQuota getExtendedUsageInterval() {
+    return extendedUsageInterval;
+  }
+
+  public void setExtendedUsageInterval(TbbQuota extendedUsageInterval) {
+    this.extendedUsageInterval = extendedUsageInterval;
+  }
+
   @Override
   public int hashCode() {
-    return Objects.hash(chat, completions, copilotPlan, extendedUsageInterval,
-        immediateUsageInterval, premiumInteractions, resetDate);
+    return Objects.hash(chat, completions, copilotPlan, extendedUsageInterval, immediateUsageInterval,
+        premiumInteractions, resetDate, resetDateUtc);
   }
 
   @Override
@@ -97,11 +100,11 @@ public boolean equals(Object obj) {
     }
     CheckQuotaResult other = (CheckQuotaResult) obj;
     return Objects.equals(chat, other.chat) && Objects.equals(completions, other.completions)
-        && copilotPlan == other.copilotPlan
-        && Objects.equals(extendedUsageInterval, other.extendedUsageInterval)
+        && copilotPlan == other.copilotPlan && Objects.equals(premiumInteractions, other.premiumInteractions)
+        && Objects.equals(resetDate, other.resetDate)
+        && Objects.equals(resetDateUtc, other.resetDateUtc)
         && Objects.equals(immediateUsageInterval, other.immediateUsageInterval)
-        && Objects.equals(premiumInteractions, other.premiumInteractions)
-        && Objects.equals(resetDate, other.resetDate);
+        && Objects.equals(extendedUsageInterval, other.extendedUsageInterval);
   }
 
   @Override
@@ -110,10 +113,11 @@ public String toString() {
     builder.append("chat", chat);
     builder.append("completions", completions);
     builder.append("premiumInteractions", premiumInteractions);
-    builder.append("immediateUsageInterval", immediateUsageInterval);
-    builder.append("extendedUsageInterval", extendedUsageInterval);
     builder.append("resetDate", resetDate);
+    builder.append("resetDateUtc", resetDateUtc);
     builder.append("copilotPlan", copilotPlan);
+    builder.append("immediateUsageInterval", immediateUsageInterval);
+    builder.append("extendedUsageInterval", extendedUsageInterval);
     return builder.toString();
   }
 }

com.microsoft.copilot.eclipse.core/src/com/microsoft/copilot/eclipse/core/lsp/protocol/quota/IntervalQuota.java

@@ -2,30 +2,23 @@
 
 import java.util.Objects;
 
+import com.google.gson.annotations.SerializedName;
 import org.apache.commons.lang3.builder.ToStringBuilder;
 
 /**
- * Completions quota information.
+ * Quota information for Copilot usage (completions, chat, premium interactions, etc.).
  */
 public class Quota {
   private double percentRemaining;
   private boolean unlimited;
   private boolean overagePermitted;
-  private Integer entitlement;
-  private Integer quotaRemaining;
-  private String timeStamp;
+  private int entitlement;
+  private int quotaRemaining;
+  @SerializedName("timeStamp")
+  private String timestamp;
 
   /**
-   * Creates a new CompletionsQuota quota information with default values.
-   */
-  public Quota() {
-    this.percentRemaining = 0.0;
-    this.unlimited = false;
-    this.overagePermitted = false;
-  }
-
-  /**
-   * Gets the percentage of the quota remaining within the range of 0.0 to 100.0.
+   * Gets the percentage of the quota remaining, clamped to [0.0, 100.0].
    */
   public double getPercentRemaining() {
     if (percentRemaining < 0.0) {
@@ -56,60 +49,48 @@ public void setOveragePermitted(boolean overagePermitted) {
     this.overagePermitted = overagePermitted;
   }
 
-  /**
-   * Gets the total entitlement (quota limit).
-   */
-  public Integer getEntitlement() {
+  public int getEntitlement() {
     return entitlement;
   }
 
-  public void setEntitlement(Integer entitlement) {
+  public void setEntitlement(int entitlement) {
     this.entitlement = entitlement;
   }
 
-  /**
-   * Gets the remaining quota count.
-   */
-  public Integer getQuotaRemaining() {
+  public int getQuotaRemaining() {
     return quotaRemaining;
   }
 
-  public void setQuotaRemaining(Integer quotaRemaining) {
+  public void setQuotaRemaining(int quotaRemaining) {
     this.quotaRemaining = quotaRemaining;
   }
 
-  /**
-   * Gets the timestamp of the quota snapshot.
-   */
-  public String getTimeStamp() {
-    return timeStamp;
+  public String getTimestamp() {
+    return timestamp;
   }
 
-  public void setTimeStamp(String timeStamp) {
-    this.timeStamp = timeStamp;
+  public void setTimestamp(String timestamp) {
+    this.timestamp = timestamp;
   }
 
   @Override
   public int hashCode() {
-    return Objects.hash(entitlement, overagePermitted, percentRemaining, quotaRemaining, timeStamp, unlimited);
+    return Objects.hash(entitlement, overagePermitted, percentRemaining, quotaRemaining, timestamp, unlimited);
   }
 
   @Override
   public boolean equals(Object obj) {
     if (this == obj) {
       return true;
     }
-    if (obj == null) {
-      return false;
-    }
-    if (getClass() != obj.getClass()) {
+    if (obj == null || getClass() != obj.getClass()) {
       return false;
     }
     Quota other = (Quota) obj;
-    return Objects.equals(entitlement, other.entitlement) && overagePermitted == other.overagePermitted
-        && Double.doubleToLongBits(percentRemaining) == Double.doubleToLongBits(other.percentRemaining)
-        && Objects.equals(quotaRemaining, other.quotaRemaining) && Objects.equals(timeStamp, other.timeStamp)
-        && unlimited == other.unlimited;
+    return Double.doubleToLongBits(percentRemaining) == Double.doubleToLongBits(other.percentRemaining)
+        && unlimited == other.unlimited && overagePermitted == other.overagePermitted
+        && entitlement == other.entitlement && quotaRemaining == other.quotaRemaining
+        && Objects.equals(timestamp, other.timestamp);
   }
 
   @Override
@@ -120,7 +101,7 @@ public String toString() {
     builder.append("overagePermitted", overagePermitted);
     builder.append("entitlement", entitlement);
     builder.append("quotaRemaining", quotaRemaining);
-    builder.append("timeStamp", timeStamp);
+    builder.append("timestamp", timestamp);
     return builder.toString();
   }
 }

com.microsoft.copilot.eclipse.core/src/com/microsoft/copilot/eclipse/core/lsp/protocol/quota/Quota.java

@@ -0,0 +1,48 @@
+package com.microsoft.copilot.eclipse.core.lsp.protocol.quota;
+
+import java.util.Objects;
+
+import org.apache.commons.lang3.builder.ToStringBuilder;
+
+/**
+ * Token based billing quota information with a reset timestamp.
+ */
+public class TbbQuota extends Quota {
+  private String resetAt;
+
+  public String getResetAt() {
+    return resetAt;
+  }
+
+  public void setResetAt(String resetAt) {
+    this.resetAt = resetAt;
+  }
+
+  @Override
+  public int hashCode() {
+    return Objects.hash(super.hashCode(), resetAt);
+  }
+
+  @Override
+  public boolean equals(Object obj) {
+    if (this == obj) {
+      return true;
+    }
+    if (!(obj instanceof TbbQuota)) {
+      return false;
+    }
+    if (!super.equals(obj)) {
+      return false;
+    }
+    TbbQuota other = (TbbQuota) obj;
+    return Objects.equals(resetAt, other.resetAt);
+  }
+
+  @Override
+  public String toString() {
+    ToStringBuilder builder = new ToStringBuilder(this);
+    builder.appendSuper(super.toString());
+    builder.append("resetAt", resetAt);
+    return builder.toString();
+  }
+}

com.microsoft.copilot.eclipse.core/src/com/microsoft/copilot/eclipse/core/lsp/protocol/quota/TbbQuota.java

@@ -38,6 +38,7 @@ page.preferencesPage.mcp.name=Model Context Protocol (MCP)
 page.preferencesPage.customInstructions.name=Custom Instructions
 page.preferencesPage.byok.name=Model Management
 page.preferencesPage.customAgents.name=Custom Agents
+page.preferencesPage.usageStatus.name=Usage Status
 page.showViewPage.name=GitHub Copilot
 page.showViewPageShowChatView.name=Chat
 

com.microsoft.copilot.eclipse.ui/plugin.properties

@@ -175,6 +175,12 @@
 			category="com.microsoft.copilot.eclipse.ui.preferences.CopilotPreferencesPage"
 			class="com.microsoft.copilot.eclipse.ui.preferences.CustomModesPreferencePage">
 		</page>
+		<page
+			id="com.microsoft.copilot.eclipse.ui.preferences.UsageStatusPreferencePage"
+			name="%page.preferencesPage.usageStatus.name"
+			category="com.microsoft.copilot.eclipse.ui.preferences.CopilotPreferencesPage"
+			class="com.microsoft.copilot.eclipse.ui.preferences.UsageStatusPreferencePage">
+		</page>
 	</extension>
 	<!-- Content type for agent.md files
 	     Matches *.md files but the describer validates only *.agent.md -->

com.microsoft.copilot.eclipse.ui/plugin.xml

@@ -234,6 +234,10 @@ private void addCopilotUsageAction(MenuManager menuManager) {
       percentRemaining = Math.min(quotaStatus.getCompletionsQuota().getPercentRemaining(),
           quotaStatus.getChatQuota().getPercentRemaining());
     } else {
+      if (quotaStatus.getPremiumInteractionsQuota() == null
+          || quotaStatus.getCompletionsQuota() == null || quotaStatus.getChatQuota() == null) {
+        return;
+      }
       // For paid plans, also consider premium interactions quota
       percentRemaining = Math.min(quotaStatus.getCompletionsQuota().getPercentRemaining(),
           Math.min(quotaStatus.getChatQuota().getPercentRemaining(),