@mars-sea/dsh-commandcode-provider 0.2.4 → 0.4.0

package/lib/index.js

@@ -9,6 +9,7 @@ import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-sett
 import { existsSync, readFileSync } from "node:fs";
 import { mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
 import { randomUUID } from "node:crypto";
+import { TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
 //#region src/adapter.ts
 /**
 * DeepSeek Harness LLM adapter for the Command Code Provider API.
@@ -359,11 +360,90 @@ function compareByPlan(a, b) {
 	if (nameDiff !== 0) return nameDiff;
 	return a.id.localeCompare(b.id);
 }
-const KNOWN_DEALS = {
-	"deepseek/deepseek-v4-pro": {
-		label: "75% off",
-		expiresAt: "2026-08-16T15:59:59.999Z"
+/**
+* Subscription plan table, synced from the official CLI bundle's plan maps
+* (`Nn`/`$n` in command-code@1.26.0 `dist/cli.mjs`): subscription `planId`
+* prefix → display name and the plan's monthly credit total. This is the
+* account's own subscription (from `/alpha/billing/subscriptions`) — distinct
+* from {@link KNOWN_PLANS}, which maps catalog models to their minimum tier.
+*
+* `tierWeight` is plugin-added (not from the CLI maps): the plan's rank on
+* the {@link PLAN_ORDER} scale, used by the picker's plan filter
+* ({@link modelVisibleInPlan}) to hide models above the account's tier.
+*/
+const KNOWN_SUBSCRIPTION_PLANS = {
+	"individual-go": {
+		name: "Go",
+		monthlyCredits: 10,
+		tierWeight: 0
+	},
+	"individual-goat": {
+		name: "GOAT",
+		monthlyCredits: 70,
+		tierWeight: 1
+	},
+	"individual-pro": {
+		name: "Pro",
+		monthlyCredits: 30,
+		tierWeight: 2
+	},
+	"individual-pro-v1": {
+		name: "Pro",
+		monthlyCredits: 80,
+		tierWeight: 2
 	},
+	"individual-provider": {
+		name: "Provider",
+		monthlyCredits: 15,
+		tierWeight: 3
+	},
+	"individual-max": {
+		name: "Max",
+		monthlyCredits: 150,
+		tierWeight: 4
+	},
+	"individual-ultra": {
+		name: "Ultra",
+		monthlyCredits: 300,
+		tierWeight: 4
+	},
+	"teams-pro": {
+		name: "Teams Pro",
+		monthlyCredits: 40,
+		tierWeight: 2
+	}
+};
+/** Plan-id prefixes, longest first — the CLI's prefix-match order. */
+const SUBSCRIPTION_PLAN_PREFIXES = Object.keys(KNOWN_SUBSCRIPTION_PLANS).sort((a, b) => b.length - a.length);
+/**
+* Resolve a subscription `planId` (e.g. `individual-pro-v1`) to its display
+* name and monthly credit total, mirroring the CLI's `getPlanInfo`:
+* normalize (lowercase, `_` → `-`), then longest-prefix match so
+* `individual-pro-v1` wins over `individual-pro`. Unknown ids return
+* `undefined`.
+*/
+function subscriptionPlanInfo(planId) {
+	const normalized = planId.toLowerCase().replace(/_/g, "-");
+	const prefix = SUBSCRIPTION_PLAN_PREFIXES.find((candidate) => normalized.startsWith(candidate));
+	return prefix === void 0 ? void 0 : KNOWN_SUBSCRIPTION_PLANS[prefix];
+}
+/**
+* Whether the picker lists `modelId` for an account with the given billing
+* access. Fails open at every uncertainty: no billing data, an unknown plan,
+* or a model outside {@link KNOWN_PLANS} all keep the model visible — the
+* server remains the final gate (`403 MODEL_NOT_IN_PLAN`).
+*/
+function modelVisibleInPlan(modelId, access) {
+	if (access === void 0) return true;
+	if (access.onDemandCredits > 0) return true;
+	if (access.tierWeight === void 0) return true;
+	const tier = KNOWN_PLANS[modelId];
+	if (tier === void 0) return true;
+	const weight = PLAN_ORDER[tier];
+	if (weight === void 0) return true;
+	return weight <= access.tierWeight;
+}
+const KNOWN_DEALS = {
 	"google/gemini-3.7-flash": {
 		label: "50% off",
 		expiresAt: "2026-12-31T23:59:59Z"
@@ -376,10 +456,58 @@ const KNOWN_DEALS = {
 		free: true
 	}
 };
+/**
+* Models with time-of-day (peak/off-peak) pricing, per the official pricing
+* page (`/docs/resources/pricing-limits`). Since 2026-08-16 16:00 UTC, DeepSeek
+* charges by the hour: peak hours are 01:00–04:00 and 06:00–10:00 UTC (7h/day,
+* full price); the other 17 hours are off-peak at half price. The picker shows
+* the *current* state as a compact label (`Peak`/`Half`) matching the English
+* noun style of the other markers (`Image`, `FREE`), so a developer can tell at
+* a glance whether calling the model right now is cheap or expensive.
+*
+* Keep in sync with the official pricing page when the model set or the peak
+* windows change (see the dsh-commandcode-upstream skill).
+*/
+const KNOWN_PEAK_PRICING = /* @__PURE__ */ new Set(["deepseek/deepseek-v4-pro", "deepseek/deepseek-v4-flash"]);
+/** Peak hours (UTC, hour-of-day range end-exclusive): 01–03 and 06–09. */
+const PEAK_HOUR_RANGES = [[1, 4], [6, 10]];
+/**
+* Whether `now` (defaults to `Date.now()`) falls in a peak-pricing hour for
+* time-of-day-priced models. `undefined` for models outside the snapshot.
+*/
+function peakPricingState(modelId, now = Date.now()) {
+	if (!KNOWN_PEAK_PRICING.has(modelId)) return void 0;
+	const hour = new Date(now).getUTCHours();
+	return PEAK_HOUR_RANGES.some(([start, end]) => hour >= start && hour < end) ? "peak" : "off-peak";
+}
+/**
+* Compact label for the current peak/off-peak state: `Peak` (full price) or
+* `Half` (off-peak, half price). These English nouns match the picker's other
+* markers (`Go`, `Image`, `FREE`), and since they appear only on time-of-day
+* priced models they double as a "priced by the hour" signal. Returns undefined
+* for models without time-of-day pricing.
+*/
+function peakPricingLabel(modelId, now = Date.now()) {
+	const state = peakPricingState(modelId, now);
+	if (state === void 0) return void 0;
+	return state === "peak" ? "Peak" : "Half";
+}
 const COMMAND_CODE_CLI_VERSION = "1.26.0";
 const DEFAULT_API_BASE = "https://api.commandcode.ai";
 const DEFAULT_GENERATE_MAX_TOKENS = 64e3;
 const DEFAULT_MAX_OUTPUT_TOKENS = 65536;
+const MODELS_TIMEOUT_MS = 1e4;
+/** How long the picker's plan-filter billing facts stay cached before refetching. */
+const BILLING_ACCESS_TTL_MS = 3e5;
+/**
+* Subscription statuses the CLI treats as live (`Mr` in command-code's
+* cli.mjs): the plan gate applies only under one of these.
+*/
+const ACTIVE_SUBSCRIPTION_STATUSES = /* @__PURE__ */ new Set([
+	"active",
+	"trialing",
+	"past_due"
+]);
 /** Head-of-request timeout: how long to wait for the first response byte. */
 const DEFAULT_REQUEST_TIMEOUT_MS = 6e4;
 /** Stream idle timeout: a generation that stalls this long is a dead connection. */
@@ -425,9 +553,10 @@ function formatContext(contextWindow) {
 }
 /**
 * Compact one-line summary for the model picker: plan tier, then any active
-* deal (discount or FREE), then `Image` for Vision-capable models, then the
-* context window. Text-only models simply omit the Image marker — "Text only"
-* adds nothing the picker needs to show.
+* deal (discount or FREE), then the current peak/off-peak state (`Peak`/`Half`)
+* for time-of-day-priced models, then `Image` for Vision-capable models, then
+* the context window. Text-only models simply omit the Image marker — "Text
+* only" adds nothing the picker needs to show.
 */
 function capabilityDescription(modelId, contextWindow, now = Date.now()) {
 	const parts = [];
@@ -435,6 +564,8 @@ function capabilityDescription(modelId, contextWindow, now = Date.now()) {
 	if (plan !== void 0) parts.push(plan);
 	const deal = dealLabel(modelId, now);
 	if (deal !== void 0) parts.push(deal);
+	const peak = peakPricingLabel(modelId, now);
+	if (peak !== void 0) parts.push(peak);
 	if (KNOWN_IMAGE_MODELS.has(modelId)) parts.push("Image");
 	const ctx = formatContext(contextWindow);
 	if (ctx !== void 0) parts.push(ctx);
@@ -449,6 +580,15 @@ function numberValue(value) {
 function booleanValue(value) {
 	return typeof value === "boolean" ? value : void 0;
 }
+/** Parse a billing-period timestamp (ISO string or millis) into millis; 0 when absent/invalid. */
+function periodEndValue(value) {
+	const asNumber = numberValue(value);
+	if (asNumber !== void 0) return asNumber;
+	const asString = stringValue(value);
+	if (asString === void 0) return 0;
+	const parsed = Date.parse(asString);
+	return Number.isNaN(parsed) ? 0 : parsed;
+}
 /**
 * Terminal stream-error markers from the official CLI (`Xw` in command-code's
 * cli.mjs): these always mean "retrying cannot succeed", so the adapter must
@@ -472,7 +612,7 @@ function recordOrEmpty(value) {
 	return {};
 }
 function projectSlugFromPath(pathName) {
-	return pathName.toLowerCase().replace(/^[a-z]:/i, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "project";
+	return pathName.toLowerCase().replace(/^[a-z]:/i, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|(?<!-)-+$/g, "") || "project";
 }
 function parseStreamEventLine(line) {
 	let trimmed = line.trim();
@@ -649,6 +789,8 @@ var CommandCodeAdapter = class extends LlmAdapter {
 	catalog = [];
 	fetchImpl;
 	resolveAttachments;
+	billingAccess;
+	billingAccessInflight;
 	constructor(deps) {
 		super();
 		this.deps = deps;
@@ -687,7 +829,9 @@ var CommandCodeAdapter = class extends LlmAdapter {
 		return this.catalog;
 	}
 	async listModels(provider) {
-		return (await this.loadCatalog()).map((model) => {
+		const catalog = await this.loadCatalog();
+		const access = this.deps.options().filterModelsByPlan === false ? void 0 : await this.loadBillingAccess();
+		return catalog.filter((model) => modelVisibleInPlan(model.id, access)).map((model) => {
 			const vision = KNOWN_IMAGE_MODELS.has(model.id);
 			return {
 				provider,
@@ -718,27 +862,96 @@ var CommandCodeAdapter = class extends LlmAdapter {
 			})) } } : {}
 		};
 	}
+	/** The headers every authenticated account endpoint shares. */
+	async accountHeaders() {
+		const connection = this.deps.options();
+		return {
+			Authorization: `Bearer ${await this.deps.resolveApiKey(connection)}`,
+			"x-command-code-version": COMMAND_CODE_CLI_VERSION,
+			"x-cli-environment": "production",
+			...attributionHeaders()
+		};
+	}
 	/**
-	* Fetch account, usage, and credit state from the Command Code account
-	* endpoints (`/alpha/whoami`, `/alpha/usage/summary`, `/alpha/billing/credits`).
+	* The billing facts behind the picker's plan filter, cached for
+	* {@link BILLING_ACCESS_TTL_MS} and shared across concurrent callers.
+	* `undefined` means "unknown — show everything" (fail-open).
+	*/
+	async loadBillingAccess() {
+		const cached = this.billingAccess;
+		if (cached !== void 0 && Date.now() - cached.at < 3e5) return cached.value;
+		this.billingAccessInflight ??= this.fetchBillingAccess().then((value) => {
+			this.billingAccess = {
+				value,
+				at: Date.now()
+			};
+			return value;
+		}).finally(() => {
+			this.billingAccessInflight = void 0;
+		});
+		return this.billingAccessInflight;
+	}
+	/**
+	* The billing facts behind the picker's plan filter, mirroring the CLI's
+	* `createBilling` flow: whoami yields the org id, then the subscriptions
+	* and credits endpoints answer in parallel. The plan id is honored only
+	* when the subscription reports an active-ish status (the CLI's rule); when
+	* the subscriptions endpoint fails entirely, `credits.planId` is the
+	* fallback (the CLI stamps plan identity from it too). Any failure resolves
+	* to `undefined` (fail-open) rather than breaking the picker.
+	*/
+	async fetchBillingAccess() {
+		try {
+			const connection = this.deps.options();
+			const headers = await this.accountHeaders();
+			const base = connection.apiBase;
+			const getJson = async (path) => {
+				const response = await this.fetchImpl(`${base}${path}`, {
+					headers,
+					signal: AbortSignal.timeout(MODELS_TIMEOUT_MS)
+				});
+				if (!response.ok) return void 0;
+				const parsed = await response.json();
+				return isRecord(parsed) ? parsed : void 0;
+			};
+			const whoami = await getJson("/alpha/whoami");
+			const orgData = whoami && isRecord(whoami.org) ? whoami.org : void 0;
+			const orgId = orgData === void 0 ? void 0 : stringValue(orgData.id);
+			const [subscription, credits] = await Promise.all([getJson(orgId === void 0 ? "/alpha/billing/subscriptions" : `/alpha/billing/subscriptions?orgId=${encodeURIComponent(orgId)}`), getJson("/alpha/billing/credits")]);
+			const subData = subscription && isRecord(subscription.data) ? subscription.data : void 0;
+			const creditsData = credits && isRecord(credits.credits) ? credits.credits : void 0;
+			if (subData === void 0 && creditsData === void 0) return void 0;
+			let planId;
+			if (subData !== void 0) {
+				const status = stringValue(subData.status);
+				if (status !== void 0 && ACTIVE_SUBSCRIPTION_STATUSES.has(status)) planId = stringValue(subData.planId);
+			} else planId = stringValue(creditsData?.planId);
+			return {
+				tierWeight: planId === void 0 ? void 0 : subscriptionPlanInfo(planId)?.tierWeight,
+				onDemandCredits: (numberValue(creditsData?.purchasedCredits) ?? 0) + (numberValue(creditsData?.freeCredits) ?? 0)
+			};
+		} catch {
+			return;
+		}
+	}
+	/**
+	* Fetch account, usage, credit, and subscription state from the Command
+	* Code account endpoints (`/alpha/whoami`, `/alpha/usage/summary`,
+	* `/alpha/billing/credits`, `/alpha/billing/subscriptions`).
 	* Each endpoint degrades independently: a failed one lands in `failures`
 	* while the rest still report, so a transient outage never blanks the whole
 	* view. Requires a usable API key (throws `MISSING_CREDENTIAL` otherwise).
 	*/
 	async getUsage() {
-		const connection = this.deps.options();
-		const apiKey = await this.deps.resolveApiKey(connection);
-		const base = connection.apiBase;
-		const headers = {
-			Authorization: `Bearer ${apiKey}`,
-			"x-command-code-version": COMMAND_CODE_CLI_VERSION,
-			"x-cli-environment": "production",
-			...attributionHeaders()
-		};
+		const base = this.deps.options().apiBase;
+		const headers = await this.accountHeaders();
 		const failures = [];
 		const getJson = async (path) => {
 			try {
-				const response = await this.fetchImpl(`${base}${path}`, { headers });
+				const response = await this.fetchImpl(`${base}${path}`, {
+					headers,
+					signal: AbortSignal.timeout(MODELS_TIMEOUT_MS)
+				});
 				if (!response.ok) {
 					failures.push(`${path}: HTTP ${response.status}`);
 					return;
@@ -758,6 +971,8 @@ var CommandCodeAdapter = class extends LlmAdapter {
 			name: stringValue(whoamiData.name) ?? "",
 			userName: stringValue(whoamiData.userName) ?? ""
 		};
+		const orgData = whoami && isRecord(whoami.org) ? whoami.org : void 0;
+		const orgId = orgData === void 0 ? void 0 : stringValue(orgData.id);
 		const usage = await getJson("/alpha/usage/summary");
 		if (usage) report.usage = {
 			totalCount: numberValue(usage.totalCount) ?? 0,
@@ -792,6 +1007,19 @@ var CommandCodeAdapter = class extends LlmAdapter {
 				resetAt: numberValue(weekly?.resetAt) ?? 0
 			}
 		};
+		const subscription = await getJson(orgId === void 0 ? "/alpha/billing/subscriptions" : `/alpha/billing/subscriptions?orgId=${encodeURIComponent(orgId)}`);
+		const subData = subscription && isRecord(subscription.data) ? subscription.data : void 0;
+		const planId = stringValue(subData?.planId) ?? stringValue(creditsData?.planId);
+		if (subData !== void 0 || planId !== void 0) {
+			const info = planId === void 0 ? void 0 : subscriptionPlanInfo(planId);
+			report.plan = {
+				planId: planId ?? "",
+				name: info?.name ?? planId ?? "",
+				status: stringValue(subData?.status) ?? "",
+				monthlyCredits: info?.monthlyCredits ?? null,
+				currentPeriodEnd: periodEndValue(subData?.currentPeriodEnd)
+			};
+		}
 		return report;
 	}
 	async *stream(options) {
@@ -1155,6 +1383,12 @@ function renderReport(report) {
 	const lines = [];
 	const account = report.account ? ` (${report.account.userName || report.account.name})` : "";
 	lines.push(`📊 Command Code 用量${account}`, "");
+	if (report.plan && report.plan.name !== "") {
+		const p = report.plan;
+		const status = p.status !== "" && p.status !== "active" ? ` (${p.status})` : "";
+		const period = p.currentPeriodEnd > 0 ? ` · 账期截止 ${new Date(p.currentPeriodEnd).toLocaleDateString()}` : "";
+		lines.push(`  📦 套餐    ${p.name}${status}${period}`, "");
+	}
 	if (report.usage) {
 		const u = report.usage;
 		lines.push("── 请求 ──────────────────────────────", `  💬 请求    ${u.completedCount} 次 / 失败 ${u.failedCount}  成功率 ${u.successRate}%`, `  💰 花费    ${money(u.totalCost)}  (${moneyShort(u.totalCredits)} credits)`, `  🔤 Token   ${tokensCompact(u.totalTokensIn)} 入 / ${tokensCompact(u.totalTokensOut)} 出`, "");
@@ -1195,6 +1429,167 @@ function applyCommands(ctx, deps) {
 	ctx.commands.register(commandDefinition(deps));
 }
 //#endregion
+//#region src/usage-wire.ts
+/** The npm package identity both contribution registrations claim. */
+const USAGE_REMOTE_PACKAGE = "@mars-sea/dsh-commandcode-provider";
+/** Canonical `<namespace>/<method>` endpoint of the usage report Remote. */
+const USAGE_REPORT_ENDPOINT = "commandcode/report";
+/** Reject one boundary value with a field-naming error. */
+function reject(field) {
+	throw new TypeError(`commandcode/report result: invalid ${field}`);
+}
+/** Read one required finite number field (`field` is the dotted error label). */
+function numberField(source, key, field) {
+	const value = source[key];
+	if (typeof value !== "number" || !Number.isFinite(value)) reject(field);
+	return value;
+}
+/** Read one required string field (`field` is the dotted error label). */
+function stringField(source, key, field) {
+	const value = source[key];
+	if (typeof value !== "string") reject(field);
+	return value;
+}
+/** Read one required boolean field (`field` is the dotted error label). */
+function booleanField(source, key, field) {
+	const value = source[key];
+	if (typeof value !== "boolean") reject(field);
+	return value;
+}
+/** Narrow an unknown value to a plain record, or reject. */
+function record(value, field) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) reject(field);
+	return value;
+}
+/** Validate one window-limit block (`fiveHour` / `weekly`). */
+function windowLimit(value, field) {
+	const source = record(value, field);
+	return {
+		used: numberField(source, "used", `${field}.used`),
+		cap: numberField(source, "cap", `${field}.cap`),
+		exceeded: booleanField(source, "exceeded", `${field}.exceeded`),
+		resetAt: numberField(source, "resetAt", `${field}.resetAt`)
+	};
+}
+/**
+* Parse one untrusted boundary value into a {@link CommandCodeUsageReport}.
+* Optional sections stay optional; every present field is shape-checked so a
+* malformed frame fails the boundary instead of rendering garbage.
+*/
+function parseUsageReport(value) {
+	const source = record(value, "report");
+	const failures = source.failures;
+	if (!Array.isArray(failures) || failures.some((entry) => typeof entry !== "string")) reject("failures");
+	const report = { failures };
+	if (source.account !== void 0) {
+		const account = record(source.account, "account");
+		report.account = {
+			id: stringField(account, "id", "account.id"),
+			name: stringField(account, "name", "account.name"),
+			userName: stringField(account, "userName", "account.userName")
+		};
+	}
+	if (source.usage !== void 0) {
+		const usage = record(source.usage, "usage");
+		report.usage = {
+			totalCount: numberField(usage, "totalCount", "usage.totalCount"),
+			totalCost: numberField(usage, "totalCost", "usage.totalCost"),
+			successRate: numberField(usage, "successRate", "usage.successRate"),
+			completedCount: numberField(usage, "completedCount", "usage.completedCount"),
+			failedCount: numberField(usage, "failedCount", "usage.failedCount"),
+			totalTokensIn: numberField(usage, "totalTokensIn", "usage.totalTokensIn"),
+			totalTokensOut: numberField(usage, "totalTokensOut", "usage.totalTokensOut"),
+			totalCredits: numberField(usage, "totalCredits", "usage.totalCredits"),
+			periodBasis: stringField(usage, "periodBasis", "usage.periodBasis")
+		};
+	}
+	if (source.credits !== void 0) {
+		const credits = record(source.credits, "credits");
+		report.credits = {
+			monthlyCredits: numberField(credits, "monthlyCredits", "credits.monthlyCredits"),
+			purchasedCredits: numberField(credits, "purchasedCredits", "credits.purchasedCredits"),
+			freeCredits: numberField(credits, "freeCredits", "credits.freeCredits"),
+			fiveHour: windowLimit(credits.fiveHour, "credits.fiveHour"),
+			weekly: windowLimit(credits.weekly, "credits.weekly")
+		};
+	}
+	if (source.plan !== void 0) {
+		const plan = record(source.plan, "plan");
+		const monthly = plan.monthlyCredits;
+		if (monthly !== null && (typeof monthly !== "number" || !Number.isFinite(monthly))) reject("plan.monthlyCredits");
+		report.plan = {
+			planId: stringField(plan, "planId", "plan.planId"),
+			name: stringField(plan, "name", "plan.name"),
+			status: stringField(plan, "status", "plan.status"),
+			monthlyCredits: monthly,
+			currentPeriodEnd: numberField(plan, "currentPeriodEnd", "plan.currentPeriodEnd")
+		};
+	}
+	return report;
+}
+/**
+* The strict result codec both halves attach to the descriptor. Hand-rolled:
+* the client bundle may not require a schema library, and `TypertSchema` is
+* deliberately minimal so one `parse` function satisfies it.
+*/
+const usageReportSchema = { parse: parseUsageReport };
+/** The Host-face contribution registered on `ctx.typert`. */
+const USAGE_HOST_CONTRIBUTION = {
+	package: USAGE_REMOTE_PACKAGE,
+	face: "host",
+	schemas: [],
+	invocations: [{
+		id: `${USAGE_REMOTE_PACKAGE}#${USAGE_REPORT_ENDPOINT}`,
+		service: "commandcodeUsage",
+		namespace: "commandcode",
+		method: "report",
+		invocation: { kind: "direct" },
+		parameters: [],
+		result: {
+			mode: "strict",
+			typeSymbol: `${USAGE_REMOTE_PACKAGE}#CommandCodeUsageReport`,
+			schema: usageReportSchema
+		}
+	}]
+};
+//#endregion
+//#region src/usage-remote.ts
+/**
+* The Remote receiver: a Cordis service the Gateway resolves by key
+* (`commandcodeUsage`) and binds to the wire namespace (`commandcode`). The
+* base class stamps the `typertRemote` binding the Gateway validates on every
+* dispatch; no decorators are needed because the descriptor is registered
+* explicitly (strict path) rather than discovered from source markers.
+*/
+var CommandCodeUsageService = class extends TypertRemoteService {
+	deps;
+	constructor(ctx, deps) {
+		super(ctx, "commandcodeUsage", { namespace: "commandcode" });
+		this.deps = deps;
+	}
+	/**
+	* Account, usage, and credit state for the settings page's account card.
+	* Degrades per endpoint like the `/commandcode` command (failures land in
+	* `report.failures`); throws `MISSING_CREDENTIAL` when no key resolves, which
+	* the Gateway folds into the failure branch the page renders as a hint.
+	*/
+	async report() {
+		return this.deps.adapter.getUsage();
+	}
+};
+/**
+* Provide the usage service and register its Remote descriptor. The registry
+* contribution is tied to this fiber's lifetime: the registry's own
+* `register()` effect would otherwise outlive the plugin.
+*/
+function applyUsageRemote(ctx, deps) {
+	ctx.inject(["typert"], (remoteCtx) => {
+		new CommandCodeUsageService(remoteCtx, deps);
+		const unregister = remoteCtx.typert.register(USAGE_HOST_CONTRIBUTION);
+		remoteCtx.effect(() => () => void unregister(), "dsh-commandcode-provider: usage remote");
+	});
+}
+//#endregion
 //#region src/index.ts
 /**
 * dsh-commandcode-provider — DeepSeek Harness LLM provider plugin for Command
@@ -1238,7 +1633,8 @@ const Config = z.object({
 	workingDir: z.string(),
 	modelsCachePath: z.string(),
 	requestTimeoutMs: z.number().min(1).max(MAX_TIMER_DELAY_MS),
-	streamIdleTimeoutMs: z.number().min(1).max(MAX_TIMER_DELAY_MS)
+	streamIdleTimeoutMs: z.number().min(1).max(MAX_TIMER_DELAY_MS),
+	filterModelsByPlan: z.boolean()
 });
 /**
 * The one explicit resolve step from raw config to validated connection
@@ -1253,7 +1649,8 @@ function resolveAdapterOptions(config) {
 		workingDir: config.workingDir ?? process.cwd(),
 		modelsCachePath: config.modelsCachePath ?? DEFAULT_MODELS_CACHE_PATH,
 		requestTimeoutMs: config.requestTimeoutMs ?? 6e4,
-		streamIdleTimeoutMs: config.streamIdleTimeoutMs ?? 3e5
+		streamIdleTimeoutMs: config.streamIdleTimeoutMs ?? 3e5,
+		filterModelsByPlan: config.filterModelsByPlan ?? true
 	};
 }
 function apply(ctx, config) {
@@ -1303,6 +1700,7 @@ function apply(ctx, config) {
 	ctx.inject(["commands"], (commandCtx) => {
 		applyCommands(commandCtx, { adapter });
 	});
+	applyUsageRemote(ctx, { adapter });
 	installSettingsSection(ctx, NS, Config, config, {
 		setSource: (source) => {
 			current = source;
@@ -1311,6 +1709,6 @@ function apply(ctx, config) {
 	});
 }
 //#endregion
-export { COMMAND_CODE_CLI_VERSION, CommandCodeAdapter, Config, DEFAULT_API_BASE, DEFAULT_GENERATE_MAX_TOKENS, DEFAULT_MAX_OUTPUT_TOKENS, DEFAULT_MODELS_CACHE_PATH, DEFAULT_REQUEST_TIMEOUT_MS, DEFAULT_STREAM_IDLE_TIMEOUT_MS, KNOWN_DEALS, KNOWN_EFFORTS, KNOWN_IMAGE_MODELS, KNOWN_PLANS, KNOWN_THINKING_MODELS, PLAN_LABELS, PLAN_ORDER, PROVIDER, apply, applyCommands, capabilityDescription, commandDefinition, compareByPlan, dealLabel, formatContext, inject, name, planLabel, projectSlugFromPath, resolveAdapterOptions, resolveAuthFileApiKey };
+export { BILLING_ACCESS_TTL_MS, COMMAND_CODE_CLI_VERSION, CommandCodeAdapter, CommandCodeUsageService, Config, DEFAULT_API_BASE, DEFAULT_GENERATE_MAX_TOKENS, DEFAULT_MAX_OUTPUT_TOKENS, DEFAULT_MODELS_CACHE_PATH, DEFAULT_REQUEST_TIMEOUT_MS, DEFAULT_STREAM_IDLE_TIMEOUT_MS, KNOWN_DEALS, KNOWN_EFFORTS, KNOWN_IMAGE_MODELS, KNOWN_PEAK_PRICING, KNOWN_PLANS, KNOWN_SUBSCRIPTION_PLANS, KNOWN_THINKING_MODELS, PLAN_LABELS, PLAN_ORDER, PROVIDER, USAGE_REPORT_ENDPOINT, apply, applyCommands, applyUsageRemote, capabilityDescription, commandDefinition, compareByPlan, dealLabel, formatContext, inject, modelVisibleInPlan, name, peakPricingLabel, peakPricingState, planLabel, projectSlugFromPath, resolveAdapterOptions, resolveAuthFileApiKey, subscriptionPlanInfo, usageReportSchema };
 
 //# sourceMappingURL=index.js.map