dsh-github-copilot 0.4.0-alpha.30 → 0.4.0-alpha.32

package/lib/remote.js

@@ -43,7 +43,7 @@ const DualModelCreateSchema = z.object({
 	expectedRevision: revision
 }).strict();
 const DualModelCreateResultSchema = z.object({ sessionId: id }).strict();
-const contribution$2 = {
+const contribution$3 = {
 	package: "dsh-github-copilot",
 	descriptors: [
 		{
@@ -85,7 +85,7 @@ const contribution$2 = {
 		}
 	]
 };
-const contribution$1 = {
+const contribution$2 = {
 	package: "dsh-github-copilot",
 	descriptors: [{
 		id: "dsh-github-copilot:githubCopilotSearchRouting.providers",
@@ -101,6 +101,97 @@ const contribution$1 = {
 	}]
 };
 //#endregion
+//#region lib/types/copilot-usage-types.js
+const COPILOT_USAGE_MAX_AMOUNT = 0xe8d4a51000;
+const COPILOT_USAGE_MAX_TIMESTAMP = 0xe677d21fdbff;
+const COPILOT_USAGE_DIAGNOSTICS = [
+	"COPILOT_USAGE_SIGNED_OUT",
+	"COPILOT_USAGE_INVALID_GRANT",
+	"COPILOT_USAGE_CREDENTIALS_UNAVAILABLE",
+	"COPILOT_USAGE_ENTERPRISE_UNSUPPORTED",
+	"COPILOT_USAGE_ACCOUNT_CHANGED",
+	"COPILOT_USAGE_DISPOSED",
+	"COPILOT_USAGE_BILLING_UNKNOWN",
+	"COPILOT_USAGE_SNAPSHOT_MISSING",
+	"COPILOT_USAGE_INVALID_RESPONSE",
+	"COPILOT_USAGE_POOLED_UNAVAILABLE",
+	"COPILOT_USAGE_POOLED_EXHAUSTED",
+	"COPILOT_USAGE_NO_ALLOCATION",
+	"COPILOT_USAGE_NETWORK",
+	"COPILOT_USAGE_TIMEOUT",
+	"COPILOT_USAGE_BODY_TOO_LARGE",
+	"COPILOT_USAGE_REDIRECT",
+	"COPILOT_USAGE_AUTH_REJECTED",
+	"COPILOT_USAGE_HTTP_ERROR",
+	"COPILOT_USAGE_RATE_LIMITED"
+];
+//#endregion
+//#region lib/types/copilot-usage-remote.js
+const amount = z.number().finite().nonnegative().max(COPILOT_USAGE_MAX_AMOUNT);
+const timestamp = z.number().int().nonnegative().max(COPILOT_USAGE_MAX_TIMESTAMP);
+const CopilotUsageViewSchema = z.object({
+	state: z.enum([
+		"ready",
+		"stale",
+		"unavailable",
+		"signed-out"
+	]),
+	billing: z.enum([
+		"credits",
+		"requests",
+		"unknown"
+	]),
+	budget: z.enum([
+		"individual",
+		"pooled",
+		"unknown"
+	]),
+	used: amount.optional(),
+	remaining: amount.optional(),
+	limit: amount.positive().optional(),
+	percentUsed: z.number().finite().min(0).max(100).optional(),
+	resetAt: timestamp.optional(),
+	observedAt: timestamp.optional(),
+	diagnostic: z.enum(COPILOT_USAGE_DIAGNOSTICS).optional()
+}).strict().superRefine((view, ctx) => {
+	const invalid = () => ctx.addIssue({
+		code: "custom",
+		message: "Invalid account quota snapshot"
+	});
+	const hasAmounts = [
+		view.used,
+		view.remaining,
+		view.limit,
+		view.percentUsed
+	].some((value) => value !== void 0);
+	if (view.state === "unavailable" || view.state === "signed-out") {
+		if (hasAmounts || view.observedAt !== void 0 || view.resetAt !== void 0 || view.diagnostic === void 0) invalid();
+		if (view.state === "signed-out" && (view.billing !== "unknown" || view.budget !== "unknown")) invalid();
+		return;
+	}
+	if (!hasAmounts || view.observedAt === void 0 || view.billing === "unknown" || view.budget === "unknown") invalid();
+	if (view.state === "stale" && view.diagnostic === void 0) invalid();
+	if (view.state === "ready" && view.diagnostic !== void 0) invalid();
+	if (view.budget === "pooled" && (view.billing !== "credits" || view.used === void 0 || view.remaining !== void 0 || view.limit !== void 0 || view.percentUsed !== void 0)) invalid();
+	if (view.limit !== void 0) {
+		if (view.used !== void 0 && view.used > view.limit || view.remaining !== void 0 && view.remaining > view.limit) invalid();
+		if (view.used !== void 0 && view.remaining !== void 0 && Math.abs(view.used + view.remaining - view.limit) > Math.max(1e-8, view.limit * 1e-12)) invalid();
+		if (view.remaining !== void 0 && view.percentUsed !== void 0 && Math.abs((1 - view.remaining / view.limit) * 100 - view.percentUsed) > 1) invalid();
+	}
+});
+const contribution$1 = {
+	package: "dsh-github-copilot",
+	descriptors: ["get", "refresh"].map((method) => ({
+		id: `dsh-github-copilot:githubCopilotUsage.${method}`,
+		namespace: "githubCopilotUsage",
+		service: "githubCopilotUsage",
+		method,
+		invocation: { kind: "direct" },
+		parameters: [],
+		result: strictRemoteCodec("dsh-github-copilot#CopilotUsageView", CopilotUsageViewSchema)
+	}))
+};
+//#endregion
 //#region lib/types/remote.js
 /**
 * Client-safe Remote contribution for the plugin-owned authorization bridge.
@@ -253,6 +344,7 @@ const contribution = {
 			parameters: [],
 			result: strictRemoteCodec(GITHUB_COPILOT_MIGRATION_STATUS_TYPE_SYMBOL, GitHubCopilotMigrationStatusSchema)
 		},
+		...contribution$3.descriptors,
 		...contribution$2.descriptors,
 		...contribution$1.descriptors
 	]

package/lib/routed-web.js

@@ -1,4 +1,4 @@
-import { C as currentSearchInitiator, T as isPluginPreviewProvider, t as isCopilotSearchSelection, w as currentSearchSelection } from "./search-routing-pFLux0W7.js";
+import { C as currentSearchInitiator, T as isPluginPreviewProvider, t as isCopilotSearchSelection, w as currentSearchSelection } from "./search-routing-DqLKem1c.js";
 import { WebError, WebRuntime } from "@deepseek-ai/dsh-web";
 //#region lib/types/routed-web.js
 /**

package/lib/types/account-model-auth.d.ts

@@ -11,5 +11,5 @@ export declare function copilotEntitlementKey(grant: Pick<GitHubCopilotOAuthCred
  * Bind model discovery to the existing native OAuth lifecycle. No model catalog,
  * login, environment fallback or separate credential record is introduced here.
  */
-export declare function createAccountModelAuth(credentials: CredentialStore): Pick<AccountModelSourceDependencies, 'resolveAuth' | 'assertAuthCurrent'>;
+export declare function createAccountModelAuth(credentials: CredentialStore, renewRejectedCredential?: (grant: GitHubCopilotOAuthCredential) => boolean): Pick<AccountModelSourceDependencies, 'resolveAuth' | 'assertAuthCurrent'>;
 //# sourceMappingURL=account-model-auth.d.ts.map

package/lib/types/client.d.ts

@@ -9,6 +9,7 @@ import type { GitHubCopilotAuthorizationView } from './authorization-controller.
 import type { ProviderCardExtrasOwnerProps, SettingsSectionOwnerProps } from './dsh-supported-types.ts';
 export { WebSearchRoutingCard } from './web-search-routing-card.ts';
 export { DualModelCard } from './dual-model-card.ts';
+export { CopilotUsageCard } from './copilot-usage-card.ts';
 export declare const inject: string[];
 interface GitHubCopilotProviderCardProps extends ProviderCardExtrasOwnerProps {
     readonly remote: ClientContext['remote']['githubCopilot'];

package/lib/types/copilot-usage-card.d.ts

@@ -0,0 +1,28 @@
+import type { ReactElement } from 'react';
+import type { CopilotUsageView } from './copilot-usage-types.ts';
+/** Client-only face: no credentials, provider transport or billing arithmetic. */
+export interface CopilotUsageRemote {
+    get(): Promise<{
+        ok: true;
+        value: CopilotUsageView;
+    } | {
+        ok: false;
+        error: unknown;
+    }>;
+    refresh(): Promise<{
+        ok: true;
+        value: CopilotUsageView;
+    } | {
+        ok: false;
+        error: unknown;
+    }>;
+}
+export interface CopilotUsageCardProps {
+    remote?: CopilotUsageRemote;
+    /** Changes revoke every in-flight read, including switches between Copilot routes. */
+    contextKey: string;
+    locale?: string;
+}
+/** Mounted only for a proven effective Copilot selection in the owning Session. */
+export declare function CopilotUsageCard(props: CopilotUsageCardProps): ReactElement;
+//# sourceMappingURL=copilot-usage-card.d.ts.map

package/lib/types/copilot-usage-host.d.ts

@@ -0,0 +1,48 @@
+import { Context } from '@deepseek-ai/cordis';
+import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
+import type { CopilotUsageView } from './copilot-usage-types.ts';
+export declare const COPILOT_USAGE_ENDPOINT = "https://api.github.com/copilot_internal/user";
+interface Dependencies {
+    readCredential(): Promise<unknown>;
+    fetch?: typeof globalThis.fetch;
+    now?: () => number;
+}
+/** One Host-owned, memory-only account cache. No auth renewal, persistence or model transport. */
+export declare class CopilotUsageSource {
+    private readonly dependencies;
+    private readonly fetcher;
+    private readonly now;
+    private generation;
+    private disposed;
+    private key;
+    private cached;
+    private last;
+    private nextRefreshAt;
+    private failureUntil;
+    private flight;
+    constructor(dependencies: Dependencies);
+    invalidate(): void;
+    dispose(): void;
+    get(): Promise<CopilotUsageView>;
+    refresh(): Promise<CopilotUsageView>;
+    private active;
+    private readAuth;
+    private assertCurrent;
+    private diagnostic;
+    private load;
+    private fetchQuota;
+    private request;
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        githubCopilotUsage: GitHubCopilotUsageController;
+    }
+}
+export default class GitHubCopilotUsageController extends TypertRemoteService {
+    private readonly source;
+    constructor(ctx: Context);
+    get(): Promise<CopilotUsageView>;
+    refresh(): Promise<CopilotUsageView>;
+}
+export {};
+//# sourceMappingURL=copilot-usage-host.d.ts.map

package/lib/types/copilot-usage-normalize.d.ts

@@ -0,0 +1,9 @@
+import type { CopilotUsageView, CopilotUsageDiagnostic } from './copilot-usage-types.ts';
+export declare function unavailableCopilotUsage(diagnostic: CopilotUsageDiagnostic, billing?: CopilotUsageView['billing'], budget?: CopilotUsageView['budget']): CopilotUsageView;
+/**
+ * Pinned VS Code 44825207: parseQuotas/getQuotaUsage and chatStatusDashboard
+ * display account amounts directly. Only per-turn nano-AIU uses /1e9; it is
+ * intentionally absent here. Pooled credits_used never shares an entitlement.
+ */
+export declare function normalizeCopilotUsage(input: unknown, observedAt: number): CopilotUsageView;
+//# sourceMappingURL=copilot-usage-normalize.d.ts.map

package/lib/types/copilot-usage-remote.d.ts

@@ -0,0 +1,60 @@
+import type { RemoteResult, TypertRemoteContribution } from '@deepseek-ai/dsh-typert-protocol';
+import { z } from 'zod';
+import type { CopilotUsageView } from './copilot-usage-types.ts';
+export type { CopilotUsageView } from './copilot-usage-types.ts';
+declare module '@deepseek-ai/dsh-typert-protocol' {
+    interface TypertRemoteNamespaceMap {
+        githubCopilotUsage: {
+            get(): Promise<RemoteResult<CopilotUsageView>>;
+            refresh(): Promise<RemoteResult<CopilotUsageView>>;
+        };
+    }
+}
+export declare const CopilotUsageViewSchema: z.ZodObject<{
+    state: z.ZodEnum<{
+        ready: "ready";
+        stale: "stale";
+        "signed-out": "signed-out";
+        unavailable: "unavailable";
+    }>;
+    billing: z.ZodEnum<{
+        unknown: "unknown";
+        credits: "credits";
+        requests: "requests";
+    }>;
+    budget: z.ZodEnum<{
+        unknown: "unknown";
+        individual: "individual";
+        pooled: "pooled";
+    }>;
+    used: z.ZodOptional<z.ZodNumber>;
+    remaining: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    percentUsed: z.ZodOptional<z.ZodNumber>;
+    resetAt: z.ZodOptional<z.ZodNumber>;
+    observedAt: z.ZodOptional<z.ZodNumber>;
+    diagnostic: z.ZodOptional<z.ZodEnum<{
+        COPILOT_USAGE_SIGNED_OUT: "COPILOT_USAGE_SIGNED_OUT";
+        COPILOT_USAGE_INVALID_GRANT: "COPILOT_USAGE_INVALID_GRANT";
+        COPILOT_USAGE_CREDENTIALS_UNAVAILABLE: "COPILOT_USAGE_CREDENTIALS_UNAVAILABLE";
+        COPILOT_USAGE_ENTERPRISE_UNSUPPORTED: "COPILOT_USAGE_ENTERPRISE_UNSUPPORTED";
+        COPILOT_USAGE_ACCOUNT_CHANGED: "COPILOT_USAGE_ACCOUNT_CHANGED";
+        COPILOT_USAGE_DISPOSED: "COPILOT_USAGE_DISPOSED";
+        COPILOT_USAGE_BILLING_UNKNOWN: "COPILOT_USAGE_BILLING_UNKNOWN";
+        COPILOT_USAGE_SNAPSHOT_MISSING: "COPILOT_USAGE_SNAPSHOT_MISSING";
+        COPILOT_USAGE_INVALID_RESPONSE: "COPILOT_USAGE_INVALID_RESPONSE";
+        COPILOT_USAGE_POOLED_UNAVAILABLE: "COPILOT_USAGE_POOLED_UNAVAILABLE";
+        COPILOT_USAGE_POOLED_EXHAUSTED: "COPILOT_USAGE_POOLED_EXHAUSTED";
+        COPILOT_USAGE_NO_ALLOCATION: "COPILOT_USAGE_NO_ALLOCATION";
+        COPILOT_USAGE_NETWORK: "COPILOT_USAGE_NETWORK";
+        COPILOT_USAGE_TIMEOUT: "COPILOT_USAGE_TIMEOUT";
+        COPILOT_USAGE_BODY_TOO_LARGE: "COPILOT_USAGE_BODY_TOO_LARGE";
+        COPILOT_USAGE_REDIRECT: "COPILOT_USAGE_REDIRECT";
+        COPILOT_USAGE_AUTH_REJECTED: "COPILOT_USAGE_AUTH_REJECTED";
+        COPILOT_USAGE_HTTP_ERROR: "COPILOT_USAGE_HTTP_ERROR";
+        COPILOT_USAGE_RATE_LIMITED: "COPILOT_USAGE_RATE_LIMITED";
+    }>>;
+}, z.core.$strict>;
+declare const contribution: TypertRemoteContribution;
+export default contribution;
+//# sourceMappingURL=copilot-usage-remote.d.ts.map

package/lib/types/copilot-usage-types.d.ts

@@ -0,0 +1,19 @@
+/** Client-safe account snapshot. Amounts are credits or requests, never token estimates. */
+export interface CopilotUsageView {
+    readonly state: 'ready' | 'stale' | 'unavailable' | 'signed-out';
+    readonly billing: 'credits' | 'requests' | 'unknown';
+    readonly budget: 'individual' | 'pooled' | 'unknown';
+    readonly used?: number;
+    readonly remaining?: number;
+    readonly limit?: number;
+    readonly percentUsed?: number;
+    /** Unix epoch milliseconds, only when explicitly reported by the supplier. */
+    readonly resetAt?: number;
+    readonly observedAt?: number;
+    readonly diagnostic?: string;
+}
+export declare const COPILOT_USAGE_MAX_AMOUNT = 1000000000000;
+export declare const COPILOT_USAGE_MAX_TIMESTAMP = 253402300799999;
+export declare const COPILOT_USAGE_DIAGNOSTICS: readonly ["COPILOT_USAGE_SIGNED_OUT", "COPILOT_USAGE_INVALID_GRANT", "COPILOT_USAGE_CREDENTIALS_UNAVAILABLE", "COPILOT_USAGE_ENTERPRISE_UNSUPPORTED", "COPILOT_USAGE_ACCOUNT_CHANGED", "COPILOT_USAGE_DISPOSED", "COPILOT_USAGE_BILLING_UNKNOWN", "COPILOT_USAGE_SNAPSHOT_MISSING", "COPILOT_USAGE_INVALID_RESPONSE", "COPILOT_USAGE_POOLED_UNAVAILABLE", "COPILOT_USAGE_POOLED_EXHAUSTED", "COPILOT_USAGE_NO_ALLOCATION", "COPILOT_USAGE_NETWORK", "COPILOT_USAGE_TIMEOUT", "COPILOT_USAGE_BODY_TOO_LARGE", "COPILOT_USAGE_REDIRECT", "COPILOT_USAGE_AUTH_REJECTED", "COPILOT_USAGE_HTTP_ERROR", "COPILOT_USAGE_RATE_LIMITED"];
+export type CopilotUsageDiagnostic = typeof COPILOT_USAGE_DIAGNOSTICS[number];
+//# sourceMappingURL=copilot-usage-types.d.ts.map

package/lib/types/copilot-usage-ui.d.ts

@@ -0,0 +1,4 @@
+import type { Context } from '@deepseek-ai/cordis';
+/** Public additive dock only; native composer, ContextMeter and other features stay owned by Core. */
+export declare function registerCopilotUsageUi(ctx: Context): () => void;
+//# sourceMappingURL=copilot-usage-ui.d.ts.map

package/lib/types/external-link.d.ts

@@ -0,0 +1,3 @@
+/** Use Desktop's public v1 navigation handoff instead of WebView popup creation. */
+export declare function externalLinkTarget(): '_self' | '_blank';
+//# sourceMappingURL=external-link.d.ts.map

package/lib/types/preview-provider.d.ts

@@ -11,6 +11,8 @@ export interface PreviewProviderGuard {
         signal: AbortSignal;
         release(): void;
     }>;
+    /** Actual model HTTP 401 only; called after release, without replaying the request. */
+    onUnauthorized?(): void;
 }
 /** Guard for one selected model in an account-bound descriptor snapshot. */
 export interface AccountProviderGuard extends PreviewProviderGuard {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-github-copilot",
   "description": "DSH companion for GitHub Copilot sign-in, account-aware model profiles, tool compatibility, and provider-hosted search.",
-  "version": "0.4.0-alpha.30",
+  "version": "0.4.0-alpha.32",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/",
@@ -56,6 +56,7 @@
     "docs/dual-model.md",
     "docs/official-first-016-alpha2.md",
     "docs/copilot-compaction.md",
+    "docs/copilot-usage.md",
     "docs/images/dual-model-provenance.json",
     "scripts/check-search-composition.mjs",
     "docs/images/"

package/lib/{search-routing-pFLux0W7.js → search-routing-DqLKem1c.js}

@@ -1,7 +1,7 @@
+import { getSupportedThinkingLevels } from "@earendil-works/pi-ai";
+import { builtinProviders, getBuiltinModels } from "@earendil-works/pi-ai/providers/all";
 import { attributionHeaders } from "@deepseek-ai/dsh-llm";
 import { WebError } from "@deepseek-ai/dsh-web";
-import { builtinProviders, getBuiltinModels } from "@earendil-works/pi-ai/providers/all";
-import { getSupportedThinkingLevels } from "@earendil-works/pi-ai";
 //#region lib/types/copilot-identity.js
 /** Native OAuth ownership and the sole plugin-owned, account-discovered route. */
 const GITHUB_COPILOT_CREDENTIAL_KEY$1 = "llm-pi-ai/github-copilot";