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

package/lib/client.js

@@ -5410,7 +5410,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			expectedRevision: revision
 		}).strict();
 		const DualModelCreateResultSchema = object$1({ sessionId: id }).strict();
-		const contribution$2 = {
+		const contribution$3 = {
 			package: "dsh-github-copilot",
 			descriptors: [
 				{
@@ -5458,7 +5458,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			supported: boolean(),
 			providers: array(object$1({ id: string().min(1).max(512) }).strict()).max(512)
 		}).strict();
-		const contribution$1 = {
+		const contribution$2 = {
 			package: "dsh-github-copilot",
 			descriptors: [{
 				id: "dsh-github-copilot:githubCopilotSearchRouting.providers",
@@ -5471,6 +5471,97 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			}]
 		};
 		//#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$1 = number().finite().nonnegative().max(COPILOT_USAGE_MAX_AMOUNT);
+		const timestamp = number().int().nonnegative().max(COPILOT_USAGE_MAX_TIMESTAMP);
+		const CopilotUsageViewSchema = object$1({
+			state: _enum([
+				"ready",
+				"stale",
+				"unavailable",
+				"signed-out"
+			]),
+			billing: _enum([
+				"credits",
+				"requests",
+				"unknown"
+			]),
+			budget: _enum([
+				"individual",
+				"pooled",
+				"unknown"
+			]),
+			used: amount$1.optional(),
+			remaining: amount$1.optional(),
+			limit: amount$1.positive().optional(),
+			percentUsed: number().finite().min(0).max(100).optional(),
+			resetAt: timestamp.optional(),
+			observedAt: timestamp.optional(),
+			diagnostic: _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.
@@ -5623,6 +5714,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					parameters: [],
 					result: strictRemoteCodec(GITHUB_COPILOT_MIGRATION_STATUS_TYPE_SYMBOL, GitHubCopilotMigrationStatusSchema)
 				},
+				...contribution$3.descriptors,
 				...contribution$2.descriptors,
 				...contribution$1.descriptors
 			]
@@ -5634,15 +5726,15 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		const ASSISTANT_ORIGIN_KEY = "github-copilot-assistant-origin";
 		const CHAT_NODE_SLOT = "conversation.chat.node";
 		const ASSISTANT_KEY = "assistant-step";
-		const noop = () => {};
-		function record$1(value) {
+		const noop$1 = () => {};
+		function record$2(value) {
 			return typeof value === "object" && value !== null;
 		}
 		function sequence(value) {
 			return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
 		}
 		function eventLocation(event) {
-			if (!record$1(event) || !record$1(event.data)) return void 0;
+			if (!record$2(event) || !record$2(event.data)) return void 0;
 			const { turn, step } = event.data;
 			return sequence(turn) && sequence(step) ? {
 				turn,
@@ -5650,9 +5742,9 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			} : void 0;
 		}
 		function messageOrigin(event) {
-			if (!record$1(event) || event.type !== "assistant/message" || event.surfaceOp !== "append" || !sequence(event.seq) || !record$1(event.data) || !record$1(event.data.message)) return void 0;
+			if (!record$2(event) || event.type !== "assistant/message" || event.surfaceOp !== "append" || !sequence(event.seq) || !record$2(event.data) || !record$2(event.data.message)) return void 0;
 			const source = event.data.message.source;
-			if (!record$1(source) || typeof source.provider !== "string" || source.provider.trim() === "" || typeof source.model !== "string" || source.model.trim() === "") return void 0;
+			if (!record$2(source) || typeof source.provider !== "string" || source.provider.trim() === "" || typeof source.model !== "string" || source.model.trim() === "") return void 0;
 			return {
 				seq: event.seq,
 				provider: source.provider,
@@ -5663,7 +5755,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		const assistantOriginDefinition = {
 			kind: ASSISTANT_ORIGIN_KEY,
 			match(event) {
-				if (!record$1(event)) return null;
+				if (!record$2(event)) return null;
 				const location = eventLocation(event);
 				if (location === void 0) return null;
 				if (event.type === "step/start") return {
@@ -5678,14 +5770,14 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			},
 			start(_context, match) {
 				const location = eventLocation(match.event);
-				if (location === void 0 || !record$1(match.event) || match.event.type !== "step/start") throw new Error("COPILOT_REASONING_ORIGIN_START: expected step/start");
+				if (location === void 0 || !record$2(match.event) || match.event.type !== "step/start") throw new Error("COPILOT_REASONING_ORIGIN_START: expected step/start");
 				return {
 					...location,
 					origin: void 0
 				};
 			},
 			update(context, match) {
-				if (!record$1(match.event) || match.event.type !== "assistant/message" || match.event.surfaceOp !== "append") return context.state;
+				if (!record$2(match.event) || match.event.type !== "assistant/message" || match.event.surfaceOp !== "append") return context.state;
 				return {
 					...context.state,
 					origin: messageOrigin(match.event)
@@ -5696,7 +5788,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				let state = context.state;
 				if (state === void 0) for (const match of context.matches) {
 					const event = match.event;
-					if (!record$1(event) || event.type !== "assistant/message" || event.surfaceOp !== "append") continue;
+					if (!record$2(event) || event.type !== "assistant/message" || event.surfaceOp !== "append") continue;
 					const location = eventLocation(event);
 					if (location !== void 0) state = {
 						...location,
@@ -5717,12 +5809,12 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		};
 		/** Shallow UI-only projection. Unchanged input retains its exact props identity. */
 		function projectReasoningPresentation(props, origin) {
-			if (!record$1(props) || !record$1(props.node) || props.node.kind !== ASSISTANT_KEY || !record$1(props.node.data) || !record$1(origin)) return props;
+			if (!record$2(props) || !record$2(props.node) || props.node.kind !== ASSISTANT_KEY || !record$2(props.node.data) || !record$2(origin)) return props;
 			const node = props.node;
 			const data = node.data;
-			if (data.status !== "settled" || !record$1(data.finalNode) || !sequence(data.finalNode.seq) || origin.seq !== data.finalNode.seq) return props;
+			if (data.status !== "settled" || !record$2(data.finalNode) || !sequence(data.finalNode.seq) || origin.seq !== data.finalNode.seq) return props;
 			if (!(origin.provider === "github-copilot" || origin.provider === "github-copilot-preview") || typeof origin.model !== "string" || origin.model.trim() === "" || !Array.isArray(data.blocks)) return props;
-			const blocks = data.blocks.filter((block) => !(record$1(block) && block.kind === "reasoning" && typeof block.text === "string" && block.text.trim() === ""));
+			const blocks = data.blocks.filter((block) => !(record$2(block) && block.kind === "reasoning" && typeof block.text === "string" && block.text.trim() === ""));
 			if (blocks.length === data.blocks.length) return props;
 			return {
 				...props,
@@ -5737,16 +5829,16 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		}
 		const missingOriginSource = {
 			getSnapshot: () => void 0,
-			subscribe: () => noop
+			subscribe: () => noop$1
 		};
 		function originSource(props) {
 			const node = props.node;
-			if (!record$1(node) || !record$1(node.location) || node.location.kind !== "step" || !record$1(node.location.step) || !record$1(node.location.step.data)) return missingOriginSource;
+			if (!record$2(node) || !record$2(node.location) || node.location.kind !== "step" || !record$2(node.location.step) || !record$2(node.location.step.data)) return missingOriginSource;
 			const store = node.location.step.data;
 			if (typeof store.source !== "function") return missingOriginSource;
 			try {
 				const source = store.source(ASSISTANT_ORIGIN_KEY);
-				if (!record$1(source) || typeof source.getSnapshot !== "function" || typeof source.subscribe !== "function") return missingOriginSource;
+				if (!record$2(source) || typeof source.getSnapshot !== "function" || typeof source.subscribe !== "function") return missingOriginSource;
 				return source;
 			} catch {
 				return missingOriginSource;
@@ -5760,7 +5852,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		*/
 		function supportedNative(entry) {
 			const component = entry.component;
-			return (entry.options.priority ?? 0) === 0 && entry.locale === "chat" && entry.options.id === void 0 && entry.options.order === void 0 && entry.options.label === void 0 && entry.inject === void 0 && entry.store === void 0 && entry.children === void 0 && entry.select === void 0 && record$1(component) && component.$$typeof === Symbol.for("react.memo") && typeof component.type === "function" && component.type.name === "AssistantNodeView";
+			return (entry.options.priority ?? 0) === 0 && entry.locale === "chat" && entry.options.id === void 0 && entry.options.order === void 0 && entry.options.label === void 0 && entry.inject === void 0 && entry.store === void 0 && entry.children === void 0 && entry.select === void 0 && record$2(component) && component.$$typeof === Symbol.for("react.memo") && typeof component.type === "function" && component.type.name === "AssistantNodeView";
 		}
 		/**
 		* Optional Client enhancement. The caller owns the returned disposer in its
@@ -5770,20 +5862,20 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			const { diagnostic } = capabilities;
 			const slotsCandidate = capabilities.slots;
 			const conversation = capabilities.uiConversation;
-			if (!record$1(slotsCandidate) || ![
+			if (!record$2(slotsCandidate) || ![
 				"entries",
 				"spec",
 				"subscribe",
 				"inject",
 				"register"
-			].every((key) => typeof slotsCandidate[key] === "function") || !record$1(conversation) || !record$1(conversation.events) || typeof conversation.events.register !== "function") {
+			].every((key) => typeof slotsCandidate[key] === "function") || !record$2(conversation) || !record$2(conversation.events) || typeof conversation.events.register !== "function") {
 				diagnostic("COPILOT_REASONING_PRESENTATION_UNAVAILABLE");
-				return noop;
+				return noop$1;
 			}
 			const slots = slotsCandidate;
 			const events = conversation.events;
-			let removeOrigin = noop;
-			let removeInjection = noop;
+			let removeOrigin = noop$1;
+			let removeInjection = noop$1;
 			let disposed = false;
 			try {
 				removeOrigin = events.register(assistantOriginDefinition);
@@ -5791,7 +5883,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					const spec = slots.spec(CHAT_NODE_SLOT);
 					if (spec?.kind !== "keyed" || spec.scope !== "session") {
 						diagnostic("COPILOT_REASONING_SLOT_UNSUPPORTED");
-						return noop;
+						return noop$1;
 					}
 					let active = true;
 					let reconciling = false;
@@ -5799,7 +5891,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					let native;
 					let failedNative;
 					let wrapper;
-					let unregister = noop;
+					let unregister = noop$1;
 					let lastDiagnostic;
 					const report = (code) => {
 						if (lastDiagnostic !== code) diagnostic(code);
@@ -5807,7 +5899,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					};
 					const retire = () => {
 						const remove = unregister;
-						unregister = noop;
+						unregister = noop$1;
 						native = void 0;
 						remove();
 						wrapper = void 0;
@@ -5869,7 +5961,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				removeInjection();
 				removeOrigin();
 				diagnostic("COPILOT_REASONING_REGISTRATION_FAILED");
-				return noop;
+				return noop$1;
 			}
 			return () => {
 				if (disposed) return;
@@ -5958,7 +6050,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			overflowWrap: "anywhere",
 			margin: 0
 		};
-		function record(value) {
+		function record$1(value) {
 			return typeof value === "object" && value !== null && !Array.isArray(value) ? value : {};
 		}
 		function revisionOf(value) {
@@ -5968,7 +6060,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			return id === GITHUB_COPILOT_SEARCH_PROVIDER ? "GitHub Copilot" : id === DEEPSEEK_SEARCH_PROVIDER ? "DeepSeek" : id;
 		}
 		function saveFailure(error) {
-			const code = record(error).code;
+			const code = record$1(error).code;
 			if (code === "settings-conflict") return "Search settings changed since you opened this page. Reload settings, then review and save your choices again.";
 			if (code === "settings-rejected") return "The settings service rejected this change. Reload settings to check whether editing is available, then try again.";
 			return "Could not confirm the save. Reload settings to check saved values before retrying. Your current choices have been kept.";
@@ -6013,7 +6105,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 					}
 					const routing = result.value.namespaces.find((entry) => entry.ns === WEB_SEARCH_ROUTING_SETTINGS_NAMESPACE);
 					const copilot = result.value.namespaces.find((entry) => entry.ns === GITHUB_COPILOT_SETTINGS_NAMESPACE);
-					const routingValue = record(routing?.value), copilotValue = record(copilot?.value);
+					const routingValue = record$1(routing?.value), copilotValue = record$1(copilot?.value);
 					const normalized = normalizeWebSearchRouting({
 						searchProvider: typeof routingValue.searchProvider === "string" ? routingValue.searchProvider : void 0,
 						searchMode: routingValue.searchMode === "fixed" ? "fixed" : "auto",
@@ -6284,7 +6376,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			plannerModel: "",
 			executorModel: ""
 		};
-		const copy = {
+		const copy$1 = {
 			en: {
 				title: "Model roles",
 				description: "The planning model plans and reviews acceptance. The execution model changes code and runs tests.",
@@ -6449,7 +6541,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		});
 		/** Additive Models settings card. All mutations belong to the injected scoped Remote. */
 		function DualModelCard(props) {
-			const t = props.locale?.toLowerCase().startsWith("zh") ? copy.zh : copy.en;
+			const t = props.locale?.toLowerCase().startsWith("zh") ? copy$1.zh : copy$1.en;
 			const id = (0, react.useId)();
 			const [view, setView] = (0, react.useState)();
 			const [draft, setDraft] = (0, react.useState)(off);
@@ -6771,6 +6863,406 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			}, status));
 		}
 		//#endregion
+		//#region lib/types/external-link.js
+		/** Use Desktop's public v1 navigation handoff instead of WebView popup creation. */
+		function externalLinkTarget() {
+			if (typeof window !== "undefined" && "dshDesktop" in window) {
+				const desktop = window.dshDesktop;
+				if (typeof desktop === "object" && desktop !== null && "protocolVersion" in desktop && desktop.protocolVersion === 1) return "_self";
+			}
+			return "_blank";
+		}
+		//#endregion
+		//#region lib/types/copilot-usage-card.js
+		const copy = {
+			en: {
+				credits: "Credits",
+				requests: "Premium requests",
+				unknown: "Copilot usage",
+				title: "Copilot credits",
+				account: "Account-wide · across Copilot apps",
+				used: "used",
+				left: "left",
+				usedLabel: "Used this cycle",
+				remaining: "Remaining",
+				unavailable: "Not available",
+				loading: "Loading…",
+				stale: "Last known",
+				individual: "Cycle budget",
+				pooled: "Shared budget · no personal balance available",
+				budgetUnknown: "Budget unavailable",
+				session: "This session",
+				sessionExplanation: "The native adapter does not expose per-session billing usage. Token counts are not billing amounts.",
+				close: "Close usage details",
+				refresh: "Refresh",
+				refreshing: "Refreshing…",
+				error: "Could not refresh usage. Try again.",
+				unavailableExplanation: "Account usage is currently unavailable.",
+				signedOut: "Sign in to Copilot in Models to view account usage.",
+				lastUpdated: "Last updated",
+				reset: "Resets",
+				progress: "Cycle budget used",
+				plan: "View usage and plan",
+				manual: "If the browser does not open, copy this address:",
+				rounding: "Amounts rounded for display. GitHub billing is authoritative.",
+				low: "Low remaining budget",
+				missing: "COPILOT_USAGE_REMOTE_UNAVAILABLE · Account usage is unavailable in this deployment."
+			},
+			zh: {
+				credits: "额度",
+				requests: "高级请求",
+				unknown: "Copilot 用量",
+				title: "Copilot 额度",
+				account: "账号范围 · 所有 Copilot 应用",
+				used: "已用",
+				left: "剩余",
+				usedLabel: "本周期已用",
+				remaining: "剩余",
+				unavailable: "暂不可用",
+				loading: "正在加载…",
+				stale: "上次已知数据",
+				individual: "周期额度",
+				pooled: "共享额度 · 无个人余额信息",
+				budgetUnknown: "额度上限暂不可用",
+				session: "本会话",
+				sessionExplanation: "原生适配器未提供单个会话的计费用量。Token 数量不等于计费额度。",
+				close: "关闭用量详情",
+				refresh: "刷新",
+				refreshing: "正在刷新…",
+				error: "无法刷新用量，请重试。",
+				unavailableExplanation: "当前无法获取账号用量。",
+				signedOut: "请在模型设置中登录 Copilot，以查看账号用量。",
+				lastUpdated: "更新于",
+				reset: "重置时间",
+				progress: "本周期已用比例",
+				plan: "查看用量与套餐",
+				manual: "若浏览器未打开，请复制此地址：",
+				rounding: "显示数值经过四舍五入，账单以 GitHub 为准。",
+				low: "剩余额度较低",
+				missing: "COPILOT_USAGE_REMOTE_UNAVAILABLE · 当前部署无法提供账号用量。"
+			}
+		};
+		const secondary = "var(--dsw-alias-label-secondary, GrayText)";
+		const border = "1px solid var(--dsw-alias-border-main, color-mix(in srgb, currentColor 20%, transparent))";
+		const button = {
+			font: "inherit",
+			color: "inherit",
+			cursor: "pointer",
+			border,
+			borderRadius: 8,
+			background: "var(--dsw-alias-bg-layer-1, Canvas)",
+			padding: "5px 9px"
+		};
+		const muted = {
+			color: secondary,
+			fontSize: 12,
+			lineHeight: 1.5,
+			margin: 0
+		};
+		const row = {
+			display: "flex",
+			justifyContent: "space-between",
+			alignItems: "center",
+			gap: 12
+		};
+		const separator = {
+			borderTop: border,
+			paddingTop: 12
+		};
+		function amount(value) {
+			return typeof value === "number" && Number.isFinite(value) && value >= 0;
+		}
+		function dateLabel(value, locale) {
+			if (!amount(value)) return void 0;
+			const date = new Date(value);
+			if (!Number.isFinite(date.getTime())) return void 0;
+			return date.toLocaleString(locale);
+		}
+		/** Mounted only for a proven effective Copilot selection in the owning Session. */
+		function CopilotUsageCard(props) {
+			const language = props.locale?.toLowerCase().startsWith("zh") ? "zh-CN" : "en-US";
+			const t = language === "zh-CN" ? copy.zh : copy.en;
+			const id = (0, react.useId)();
+			const [view, setView] = (0, react.useState)();
+			const [busy, setBusy] = (0, react.useState)(false);
+			const [failed, setFailed] = (0, react.useState)(false);
+			const [open, setOpen] = (0, react.useState)(false);
+			const [position, setPosition] = (0, react.useState)({
+				left: 12,
+				bottom: 12
+			});
+			const trigger = (0, react.useRef)(null);
+			const panel = (0, react.useRef)(null);
+			const closeButton = (0, react.useRef)(null);
+			const lifecycle = (0, react.useRef)({
+				active: false,
+				generation: 0,
+				busy: false
+			});
+			const close = (0, react.useCallback)((restore = false) => {
+				setOpen(false);
+				if (restore) trigger.current?.focus();
+			}, []);
+			const load = (0, react.useCallback)(async (force) => {
+				const owner = lifecycle.current;
+				if (!owner.active || owner.busy || props.remote === void 0 || document.visibilityState === "hidden") return;
+				owner.busy = true;
+				const generation = ++owner.generation;
+				const current = () => owner.active && owner.generation === generation;
+				setBusy(true);
+				setFailed(false);
+				try {
+					const result = await (force ? props.remote.refresh() : props.remote.get());
+					if (!current()) return;
+					const parsed = result.ok ? CopilotUsageViewSchema.safeParse(result.value) : void 0;
+					if (parsed?.success !== true) {
+						setView(void 0);
+						setFailed(true);
+					} else setView(parsed.data);
+				} catch {
+					if (current()) {
+						setView(void 0);
+						setFailed(true);
+					}
+				} finally {
+					if (current()) {
+						owner.busy = false;
+						setBusy(false);
+					}
+				}
+			}, [props.remote, props.contextKey]);
+			(0, react.useEffect)(() => {
+				const owner = lifecycle.current;
+				owner.active = true;
+				setView(void 0);
+				setFailed(false);
+				setBusy(false);
+				setOpen(false);
+				load(false);
+				const timer = props.remote === void 0 ? void 0 : window.setInterval(() => {
+					load(false);
+				}, 6e4);
+				const visible = () => {
+					if (document.visibilityState === "visible") load(false);
+				};
+				document.addEventListener("visibilitychange", visible);
+				return () => {
+					owner.active = false;
+					owner.generation++;
+					owner.busy = false;
+					if (timer !== void 0) window.clearInterval(timer);
+					document.removeEventListener("visibilitychange", visible);
+				};
+			}, [load, props.remote]);
+			(0, react.useLayoutEffect)(() => {
+				if (!open) return;
+				panel.current?.showPopover?.();
+				const place = () => {
+					const anchor = trigger.current?.getBoundingClientRect();
+					if (!anchor) return;
+					const width = panel.current?.getBoundingClientRect().width || 336;
+					setPosition({
+						left: Math.max(12, Math.min(anchor.right - width, window.innerWidth - width - 12)),
+						bottom: Math.max(12, Math.min(window.innerHeight - anchor.top + 8, window.innerHeight - 40))
+					});
+				};
+				place();
+				closeButton.current?.focus();
+				window.addEventListener("resize", place);
+				window.addEventListener("scroll", place, true);
+				return () => {
+					window.removeEventListener("resize", place);
+					window.removeEventListener("scroll", place, true);
+				};
+			}, [open]);
+			(0, react.useEffect)(() => {
+				if (!open) return;
+				const outside = (event) => {
+					const target = event.target;
+					if (target instanceof Node && !panel.current?.contains(target) && !trigger.current?.contains(target)) close();
+				};
+				const key = (event) => {
+					if (event.key === "Escape") {
+						event.preventDefault();
+						close(true);
+					}
+					if (event.key === "Tab" && panel.current?.contains(document.activeElement)) {
+						const buttons = Array.from(panel.current.querySelectorAll("button:not(:disabled),a[href],summary"));
+						const target = event.shiftKey ? buttons.at(-1) : buttons[0];
+						const edge = event.shiftKey ? buttons[0] : buttons.at(-1);
+						if (document.activeElement === edge) {
+							event.preventDefault();
+							target?.focus();
+						}
+					}
+				};
+				document.addEventListener("pointerdown", outside);
+				document.addEventListener("keydown", key);
+				return () => {
+					document.removeEventListener("pointerdown", outside);
+					document.removeEventListener("keydown", key);
+				};
+			}, [open, close]);
+			const available = view?.state === "ready" || view?.state === "stale";
+			const knownUnits = view?.billing === "credits" || view?.billing === "requests";
+			const numbers = available && knownUnits;
+			const used = numbers && amount(view.used) ? view.used : void 0;
+			const remaining = numbers && view.budget !== "pooled" && amount(view.remaining) ? view.remaining : void 0;
+			const limit = numbers && view.budget === "individual" && amount(view.limit) ? view.limit : void 0;
+			const percent = numbers && view.budget === "individual" && amount(view.percentUsed) ? view.percentUsed : void 0;
+			const unit = view?.billing === "credits" ? t.credits : view?.billing === "requests" ? t.requests : t.unknown;
+			const format = (value) => value === void 0 ? t.unavailable : value > 0 && value < .01 ? "<0.01" : new Intl.NumberFormat(language, { maximumFractionDigits: 2 }).format(value);
+			const compact = (value) => value > 0 && value < .01 ? "<0.01" : new Intl.NumberFormat(language, {
+				notation: "compact",
+				maximumFractionDigits: 2
+			}).format(value);
+			const reading = [
+				unit,
+				...view?.state === "stale" ? [t.stale] : [],
+				used === void 0 ? void 0 : `${compact(used)} ${t.used}`,
+				remaining === void 0 ? void 0 : `${compact(remaining)} ${t.left}`
+			].filter(Boolean).join(" · ");
+			const noAmount = used === void 0 && remaining === void 0;
+			const observed = available ? dateLabel(view.observedAt, language) : void 0;
+			const reset = available ? dateLabel(view.resetAt, language) : void 0;
+			return (0, react.createElement)("span", { style: {
+				display: "inline-flex",
+				minWidth: 0,
+				maxWidth: "100%",
+				fontFamily: "var(--dsw-font-family, inherit)"
+			} }, (0, react.createElement)("button", {
+				ref: trigger,
+				type: "button",
+				"data-copilot-usage-trigger": "",
+				"aria-haspopup": "dialog",
+				"aria-expanded": open,
+				"aria-controls": open ? id : void 0,
+				onClick: () => {
+					setOpen((value) => !value);
+				},
+				style: {
+					...button,
+					border: "none",
+					background: "transparent",
+					borderRadius: 16,
+					padding: "3px 5px",
+					fontSize: 11,
+					minWidth: 0,
+					lineHeight: 1.5,
+					textAlign: "center",
+					overflowWrap: "anywhere",
+					color: secondary,
+					fontVariantNumeric: "tabular-nums"
+				}
+			}, `${reading}${noAmount ? ` · ${busy ? t.loading : t.unavailable}` : ""}`), open ? (0, react.createElement)("div", {
+				id,
+				ref: panel,
+				role: "dialog",
+				"aria-labelledby": `${id}-title`,
+				"aria-describedby": `${id}-scope`,
+				popover: "manual",
+				style: {
+					position: "fixed",
+					inset: "auto",
+					margin: 0,
+					...position,
+					width: 336,
+					maxWidth: "calc(100vw - 24px)",
+					maxHeight: `calc(100vh - ${position.bottom + 12}px)`,
+					overflowY: "auto",
+					boxSizing: "border-box",
+					zIndex: 1e3,
+					padding: 16,
+					display: "grid",
+					gap: 14,
+					border,
+					borderRadius: 14,
+					color: "var(--dsw-alias-label-primary, CanvasText)",
+					background: "var(--dsw-specific-menu, Canvas)",
+					fontFamily: "var(--dsw-font-family, inherit)",
+					fontSize: 13,
+					boxShadow: "0 8px 32px color-mix(in srgb, CanvasText 16%, transparent)",
+					overflowWrap: "anywhere"
+				}
+			}, (0, react.createElement)("div", { style: row }, (0, react.createElement)("div", null, (0, react.createElement)("strong", { id: `${id}-title` }, view?.billing === "credits" ? t.title : unit), (0, react.createElement)("p", {
+				id: `${id}-scope`,
+				style: muted
+			}, t.account)), (0, react.createElement)("button", {
+				ref: closeButton,
+				type: "button",
+				"aria-label": t.close,
+				style: button,
+				onClick: () => {
+					close(true);
+				}
+			}, "×")), view?.state === "stale" ? (0, react.createElement)("p", {
+				role: "status",
+				style: muted
+			}, t.stale) : null, view?.diagnostic === void 0 ? null : (0, react.createElement)("code", { style: muted }, view.diagnostic), props.remote === void 0 ? (0, react.createElement)("p", {
+				role: "status",
+				style: muted
+			}, t.missing) : null, failed ? (0, react.createElement)("p", {
+				role: "alert",
+				style: muted
+			}, t.error) : null, view?.state === "signed-out" ? (0, react.createElement)("p", { style: muted }, t.signedOut) : !available && !busy && props.remote !== void 0 ? (0, react.createElement)("p", { style: muted }, t.unavailableExplanation) : null, (0, react.createElement)("div", { style: {
+				display: "grid",
+				gridTemplateColumns: "minmax(0, 1fr) minmax(0, 1fr)",
+				gap: 12
+			} }, (0, react.createElement)("div", null, (0, react.createElement)("p", { style: muted }, t.usedLabel), (0, react.createElement)("strong", { style: {
+				fontSize: 22,
+				fontVariantNumeric: "tabular-nums"
+			} }, format(used)), (0, react.createElement)("p", { style: muted }, unit)), (0, react.createElement)("div", null, (0, react.createElement)("p", { style: muted }, t.remaining), (0, react.createElement)("strong", { style: {
+				fontSize: 22,
+				fontVariantNumeric: "tabular-nums"
+			} }, format(remaining)), (0, react.createElement)("p", { style: muted }, unit))), percent === void 0 ? null : (0, react.createElement)("div", {
+				role: "progressbar",
+				"aria-label": t.progress,
+				"aria-valuemin": 0,
+				"aria-valuemax": 100,
+				"aria-valuenow": percent,
+				style: {
+					height: 5,
+					background: "var(--dsw-alias-bg-layer-2, ButtonFace)",
+					borderRadius: 8,
+					overflow: "hidden"
+				}
+			}, (0, react.createElement)("div", { style: {
+				height: "100%",
+				width: `${percent}%`,
+				background: percent >= 90 ? "#d9a441" : "var(--dsw-alias-label-primary, CanvasText)"
+			} })), view?.state === "ready" && percent !== void 0 && percent >= 90 ? (0, react.createElement)("p", {
+				role: "status",
+				style: muted
+			}, t.low) : null, (0, react.createElement)("p", { style: muted }, available && view.budget === "pooled" ? t.pooled : limit === void 0 ? t.budgetUnknown : `${t.individual}: ${format(limit)} ${unit}`), numbers ? (0, react.createElement)("p", { style: muted }, t.rounding) : null, reset === void 0 ? null : (0, react.createElement)("p", { style: muted }, `${t.reset}: ${reset}`), (0, react.createElement)("div", { style: separator }, (0, react.createElement)("div", { style: row }, (0, react.createElement)("strong", null, t.session), (0, react.createElement)("span", null, t.unavailable)), (0, react.createElement)("p", { style: {
+				...muted,
+				marginTop: 4
+			} }, t.sessionExplanation)), (0, react.createElement)("div", { style: {
+				...row,
+				...separator
+			} }, (0, react.createElement)("span", { style: muted }, observed === void 0 ? null : `${t.lastUpdated}: ${observed}`), (0, react.createElement)("button", {
+				type: "button",
+				style: {
+					...button,
+					flexShrink: 0
+				},
+				disabled: busy || props.remote === void 0,
+				onClick: () => {
+					load(true);
+				}
+			}, busy ? t.refreshing : t.refresh)), (0, react.createElement)("a", {
+				href: "https://github.com/settings/copilot",
+				target: externalLinkTarget(),
+				rel: "noreferrer",
+				style: {
+					color: "inherit",
+					fontSize: 12
+				}
+			}, t.plan), (0, react.createElement)("details", { style: muted }, (0, react.createElement)("summary", { style: { cursor: "pointer" } }, t.manual), (0, react.createElement)("code", { style: {
+				userSelect: "all",
+				overflowWrap: "anywhere"
+			} }, "https://github.com/settings/copilot"))) : null);
+		}
+		//#endregion
 		//#region lib/types/current-workspace.js
 		const object = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 		function listOf(value) {
@@ -6864,11 +7356,11 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 		}
 		//#endregion
 		//#region lib/types/dual-model-ui.js
-		const emptySubscribe = () => () => {};
+		const emptySubscribe$1 = () => () => {};
 		function DualModelSurface({ ctx, remote, workspaceSource, close }) {
 			const locale = ctx.get("locale");
 			const navigation = ctx.get("uiWorkspace");
-			const language = (0, react.useSyncExternalStore)(locale === void 0 ? emptySubscribe : (listener) => locale.subscribe(listener), () => locale?.getLocale().active ?? "en", () => "en");
+			const language = (0, react.useSyncExternalStore)(locale === void 0 ? emptySubscribe$1 : (listener) => locale.subscribe(listener), () => locale?.getLocale().active ?? "en", () => "en");
 			const currentWorkspaceId = (0, react.useSyncExternalStore)(workspaceSource.subscribe, workspaceSource.getSnapshot, () => void 0);
 			return (0, react.createElement)(DualModelCard, {
 				remote,
@@ -6955,6 +7447,141 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			};
 		}
 		//#endregion
+		//#region lib/types/copilot-usage-ui.js
+		const slot = "conversation.composer.dock";
+		const noop = () => {};
+		const emptySubscribe = () => noop;
+		function record(value) {
+			return typeof value === "object" && value !== null;
+		}
+		function isSlots(value) {
+			return record(value) && typeof value.spec === "function" && typeof value.inject === "function" && typeof value.register === "function";
+		}
+		function isRemote(value) {
+			return record(value) && typeof value.get === "function" && typeof value.refresh === "function";
+		}
+		function isLocale(value) {
+			return record(value) && typeof value.getLocale === "function" && typeof value.subscribe === "function";
+		}
+		function isRuntime(value) {
+			return record(value) && typeof value.sessionId === "string" && value.sessionId !== "" && typeof value.useSession === "function" && typeof value.useProjection === "function";
+		}
+		function selection(value) {
+			return record(value) && typeof value.provider === "string" && value.provider.trim() !== "" && typeof value.model === "string" && value.model.trim() !== "";
+		}
+		/**
+		* Verified alpha.2 wire projection: next = pending ?? lastUsed; lastUsed is
+		* request/header.config. Never consult the future global default or the model
+		* catalog. A blank Session without explicit selection waits for that evidence.
+		*/
+		function effectiveCopilot(projection) {
+			if (!record(projection) || !(projection.lastUsed === null || selection(projection.lastUsed)) || !(projection.next === null || selection(projection.next))) return void 0;
+			const next = projection.next;
+			if (!selection(next)) return void 0;
+			return next.provider === "github-copilot" || next.provider === "github-copilot-preview" ? next : void 0;
+		}
+		function Surface({ runtime, remote, locale, diagnostic }) {
+			const session = runtime.useSession();
+			const projection = runtime.useProjection("modelSelection");
+			const language = (0, react.useSyncExternalStore)(locale === void 0 ? emptySubscribe : (listener) => locale.subscribe(listener), () => locale?.getLocale().active ?? "en", () => "en");
+			const current = effectiveCopilot(projection);
+			const valid = record(session) && session.sessionId === runtime.sessionId && session.removed === false && session.openState === "open";
+			(0, react.useEffect)(() => {
+				if (projection === void 0) diagnostic("COPILOT_USAGE_MODEL_PROJECTION_UNAVAILABLE");
+			}, [projection, diagnostic]);
+			if (!valid || current === void 0) return null;
+			const contextKey = JSON.stringify([
+				runtime.sessionId,
+				current.provider,
+				current.model
+			]);
+			return (0, react.createElement)(CopilotUsageCard, {
+				key: contextKey,
+				contextKey,
+				remote,
+				locale: language
+			});
+		}
+		/** Public additive dock only; native composer, ContextMeter and other features stay owned by Core. */
+		function registerCopilotUsageUi(ctx) {
+			const diagnosed = /* @__PURE__ */ new Set();
+			const diagnostic = (code) => {
+				if (!diagnosed.has(code)) {
+					diagnosed.add(code);
+					ctx.logger.warn(`[github-copilot] ${code}`);
+				}
+			};
+			const candidate = ctx.slots;
+			if (!isSlots(candidate)) {
+				diagnostic("COPILOT_USAGE_SLOT_UNAVAILABLE");
+				return noop;
+			}
+			const slots = candidate;
+			let remote;
+			try {
+				const namespaces = ctx.remote;
+				const face = record(namespaces) ? namespaces.githubCopilotUsage : void 0;
+				if (isRemote(face)) remote = face;
+				else diagnostic("COPILOT_USAGE_REMOTE_UNAVAILABLE");
+			} catch {
+				diagnostic("COPILOT_USAGE_REMOTE_UNAVAILABLE");
+			}
+			const localeCandidate = ctx.get("locale");
+			const locale = isLocale(localeCandidate) ? localeCandidate : void 0;
+			let active = true;
+			let remove;
+			let injection = noop;
+			try {
+				if (slots.spec(slot) === void 0) diagnostic("COPILOT_USAGE_SLOT_UNAVAILABLE");
+				injection = slots.inject(slot, () => {
+					if (!active) return noop;
+					const spec = slots.spec(slot);
+					if (spec?.kind !== "list" || spec.scope !== "session") {
+						diagnostic("COPILOT_USAGE_SLOT_UNAVAILABLE");
+						return noop;
+					}
+					try {
+						const dispose = slots.register({
+							name: slot,
+							id: "github-copilot-usage",
+							order: 20
+						}, (props) => {
+							if (!isRuntime(props)) {
+								diagnostic("COPILOT_USAGE_SESSION_RUNTIME_UNAVAILABLE");
+								return null;
+							}
+							return (0, react.createElement)(Surface, {
+								runtime: props,
+								remote,
+								locale,
+								diagnostic
+							});
+						});
+						let removed = false;
+						const cleanup = () => {
+							if (!removed) {
+								removed = true;
+								dispose();
+							}
+						};
+						remove = cleanup;
+						return cleanup;
+					} catch {
+						diagnostic("COPILOT_USAGE_SLOT_UNAVAILABLE");
+						return noop;
+					}
+				});
+			} catch {
+				diagnostic("COPILOT_USAGE_SLOT_UNAVAILABLE");
+			}
+			return () => {
+				if (!active) return;
+				active = false;
+				injection();
+				remove?.();
+			};
+		}
+		//#endregion
 		//#region lib/types/client.js
 		/**
 		* Browser companion for the Models provider-card slot.
@@ -7105,13 +7732,6 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			if (writer === void 0) throw new Error("Clipboard access is unavailable");
 			await writer.writeText(code);
 		}
-		function verificationLinkTarget() {
-			if (typeof window !== "undefined" && "dshDesktop" in window) {
-				const desktop = window.dshDesktop;
-				if (typeof desktop === "object" && desktop !== null && "protocolVersion" in desktop && desktop.protocolVersion === 1) return "_self";
-			}
-			return "_blank";
-		}
 		/** Pure presentation for the in-flight GitHub device-code handoff. */
 		function GitHubCopilotAuthorizationNotice(props) {
 			const feedback = props.copyState === "copying" ? "Copying code…" : props.copyState === "copied" ? "Code copied to clipboard." : props.copyState === "failed" ? "Copy failed. Select the code and copy it manually." : "";
@@ -7120,7 +7740,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				style: noticePanelStyle
 			}, (0, react.createElement)("div", null, props.message), props.url === void 0 ? null : (0, react.createElement)("a", {
 				href: props.url,
-				target: verificationLinkTarget(),
+				target: externalLinkTarget(),
 				rel: "noreferrer"
 			}, "Open GitHub verification page"), props.url === void 0 ? null : (0, react.createElement)("div", null, "If the browser does not open, copy this address into your browser:", (0, react.createElement)("code", {
 				"data-dsh-github-copilot-verification-url": true,
@@ -7965,12 +8585,14 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 				"slots"
 			], registerSearchUi);
 			const dualModelUi = ctx.inject(["remote.githubCopilotDualModel", "slots"], registerDualModelUi);
+			const usageUi = ctx.inject(["remote.githubCopilotUsage", "slots"], registerCopilotUsageUi);
 			const presentation = ctx.inject(["uiConversation", "slots"], (scope) => installReasoningPresentation({
 				slots: scope.slots,
 				uiConversation: scope.get("uiConversation"),
 				diagnostic: (code) => scope.logger.warn(`[github-copilot] ${code}`)
 			}));
 			return async () => {
+				await usageUi.dispose();
 				await presentation.dispose();
 				await dualModelUi.dispose();
 				await searchUi.dispose();
@@ -7979,6 +8601,7 @@ Set the \`cycles\` parameter to \`"ref"\` to resolve cyclical schemas with defs.
 			};
 		}
 		//#endregion
+		exports.CopilotUsageCard = CopilotUsageCard;
 		exports.DualModelCard = DualModelCard;
 		exports.GitHubCopilotAccountModelsPanel = GitHubCopilotAccountModelsPanel;
 		exports.GitHubCopilotAccountModelsSummary = GitHubCopilotAccountModelsSummary;