@buyi1net/pi-toolkit 0.0.1

package/modules/tui/kernel/pkg/shared/provider-contracts.ts

@@ -0,0 +1,150 @@
+export type BillingMode = 'subscription' | 'api' | 'hybrid' | 'unknown';
+
+export interface QuotaWindow {
+  label: string;
+  remainingPercent: number;
+  resetMs: number | null;
+}
+
+export interface QuotaInfo {
+  provider: string;
+  windows: QuotaWindow[];
+}
+
+export interface BalanceValue {
+  amount: number;
+  currency: 'CNY' | 'USD';
+}
+
+export interface ProviderUsage {
+  mode: Exclude<BillingMode, 'unknown'>;
+  balance?: BalanceValue;
+  quota?: QuotaInfo;
+}
+
+const QUERY_PROTOCOLS = ['sub2api', 'new-api', 'generic-balance', 'zenmux'] as const;
+export type RelayQueryProtocol = (typeof QUERY_PROTOCOLS)[number];
+
+/** 不猜中转接口；查询与推理地址不同源时须显式提供查询凭据，避免跨域复用推理 Key。 */
+export interface ProviderQueryConfig {
+  id: string;
+  displayName?: string;
+  matchHosts: string[];
+  protocol: RelayQueryProtocol;
+  baseUrl?: string;
+  path?: string;
+  apiKey?: string;
+  accessToken?: string;
+  userId?: string;
+  currency?: 'CNY' | 'USD';
+}
+
+export interface ProviderCredentials {
+  volcengine?: {
+    accessKeyId: string;
+    secretAccessKey: string;
+  };
+  zhipuTeam?: {
+    organizationId: string;
+    projectId: string;
+  };
+  openrouter?: {
+    managementKey: string;
+  };
+}
+
+type ProviderConfigRule = 'object' | 'array' | 'nonEmptyArray' | 'nonEmptyString' | 'choice';
+
+/** 不携带输入原文，避免宿主输出诊断时泄露凭据；宿主按规则码选择自己的文案。 */
+export class ProviderConfigValidationError extends Error {
+	readonly field: string;
+	readonly rule: ProviderConfigRule;
+
+	constructor(field: string, rule: ProviderConfigRule) {
+		super(`${field}: ${rule}`);
+		this.name = 'ProviderConfigValidationError';
+		this.field = field;
+		this.rule = rule;
+	}
+}
+
+function requireRecord(value: unknown, field: string): Record<string, unknown> {
+	if (value === null || typeof value !== 'object' || Array.isArray(value)) {
+		throw new ProviderConfigValidationError(field, 'object');
+	}
+	return value as Record<string, unknown>;
+}
+
+function optionalString(value: unknown, field: string, secret = false): string | undefined {
+	if (value === undefined) return undefined;
+	if (typeof value !== 'string' || !(secret ? value : value.trim())) {
+		throw new ProviderConfigValidationError(field, 'nonEmptyString');
+	}
+	return secret ? value : value.trim();
+}
+
+function requiredString(value: unknown, field: string, secret = false): string {
+	const parsed = optionalString(value, field, secret);
+	if (parsed === undefined) throw new ProviderConfigValidationError(field, 'nonEmptyString');
+	return parsed;
+}
+
+/** 缺省保留 undefined；普通字符串裁边，凭据原样保留，未知字段丢弃，以兼容既有配置。 */
+export function parseProviderQueries(value: unknown, field: string): ProviderQueryConfig[] | undefined {
+	if (value === undefined) return undefined;
+	if (!Array.isArray(value)) throw new ProviderConfigValidationError(field, 'array');
+	return value.map((item, index) => {
+		const path = `${field}[${index}]`;
+		const query = requireRecord(item, path);
+		const id = requiredString(query.id, `${path}.id`);
+		if (!Array.isArray(query.matchHosts) || query.matchHosts.length === 0) {
+			throw new ProviderConfigValidationError(`${path}.matchHosts`, 'nonEmptyArray');
+		}
+		const matchHosts = query.matchHosts.map((host, hostIndex) => requiredString(host, `${path}.matchHosts[${hostIndex}]`));
+		if (typeof query.protocol !== 'string' || !QUERY_PROTOCOLS.includes(query.protocol as RelayQueryProtocol)) {
+			throw new ProviderConfigValidationError(`${path}.protocol`, 'choice');
+		}
+		if (query.currency !== undefined && query.currency !== 'CNY' && query.currency !== 'USD') {
+			throw new ProviderConfigValidationError(`${path}.currency`, 'choice');
+		}
+		const result: ProviderQueryConfig = { id, matchHosts, protocol: query.protocol as RelayQueryProtocol };
+		for (const key of ['displayName', 'baseUrl', 'path', 'apiKey', 'accessToken', 'userId'] as const) {
+			const parsed = optionalString(query[key], `${path}.${key}`, key === 'apiKey' || key === 'accessToken');
+			if (parsed !== undefined) result[key] = parsed;
+		}
+		if (query.currency !== undefined) result.currency = query.currency;
+		return result;
+	});
+}
+
+/** 缺省视为空凭据；仅校验显式配置的已知供应商，不要求同时配置所有供应商。 */
+export function parseProviderCredentials(value: unknown, field: string): ProviderCredentials {
+	const credentials = value === undefined ? {} : requireRecord(value, field);
+	const volcengine = credentials.volcengine === undefined
+		? undefined : requireRecord(credentials.volcengine, `${field}.volcengine`);
+	const zhipuTeam = credentials.zhipuTeam === undefined
+		? undefined : requireRecord(credentials.zhipuTeam, `${field}.zhipuTeam`);
+	const openrouter = credentials.openrouter === undefined
+		? undefined : requireRecord(credentials.openrouter, `${field}.openrouter`);
+	return {
+		...(volcengine ? { volcengine: {
+			accessKeyId: requiredString(volcengine.accessKeyId, `${field}.volcengine.accessKeyId`, true),
+			secretAccessKey: requiredString(volcengine.secretAccessKey, `${field}.volcengine.secretAccessKey`, true),
+		} } : {}),
+		...(zhipuTeam ? { zhipuTeam: {
+			organizationId: requiredString(zhipuTeam.organizationId, `${field}.zhipuTeam.organizationId`),
+			projectId: requiredString(zhipuTeam.projectId, `${field}.zhipuTeam.projectId`),
+		} } : {}),
+		...(openrouter ? { openrouter: {
+			managementKey: requiredString(openrouter.managementKey, `${field}.openrouter.managementKey`, true),
+		} } : {}),
+	};
+}
+
+/** 查询入口的唯一凭据通道：调用方只交凭据，具体字段用不用由路由表按供应商决定。 */
+export interface ProviderQueryCredentials extends ProviderCredentials {
+  /** 主凭据：API Key 或 OAuth Access Token，按供应商协议充当对应角色 */
+  token: string;
+  accountId?: string;
+  githubDomain?: string;
+}

package/modules/tui/kernel/pkg/shared/provider-display.ts

@@ -0,0 +1,55 @@
+import { findProviderById } from './provider-catalog.ts';
+
+const MODEL_PROVIDER_PATTERNS: readonly [RegExp, string][] = [
+  [/^deepseek(?:[-_/]|$)/, 'deepseek'],
+  [/^(?:kimi|moonshot)(?:[-_/]|$)/, 'kimi'],
+  [/^(?:glm|chatglm|zhipu)(?:[-_/]|$)/, 'zhipu'],
+  [/^(?:qwen|qwq)(?:[-_/]|$)/, 'qwen'],
+  [/^(?:minimax|abab)(?:[-_/]|$)/, 'minimax'],
+  [/^(?:doubao|seed)(?:[-_/]|$)/, 'doubao'],
+  [/^(?:gemini|gemma)(?:[-_/]|$)/, 'gemini'],
+  [/^(?:claude|anthropic)(?:[-_/]|$)/, 'anthropic'],
+  [/^(?:gpt|o[1-4])(?:[-_/]|$)/, 'openai'],
+  [/^(?:grok|xai)(?:[-_/]|$)/, 'xai'],
+  [/^(?:llama)(?:[-_/]|$)/, 'meta'],
+  [/^(?:mistral|codestral)(?:[-_/]|$)/, 'mistral'],
+];
+
+const QUERY_DISPLAY_NAMES: Readonly<Record<string, string>> = {
+  zhipu: 'Zhipu',
+  'z.ai': 'Zhipu',
+  kimi: 'Kimi',
+  qwen: 'Qwen',
+  doubao: 'Doubao',
+  gemini: 'Google',
+  anthropic: 'Anthropic',
+  openai: 'OpenAI',
+  xai: 'xAI',
+  meta: 'Meta',
+  mistral: 'Mistral',
+  minimax: 'MiniMax',
+  'minimax-cn': 'MiniMax',
+  'minimax-en': 'MiniMax',
+  zenmux: 'ZenMux',
+  deepseek: 'DeepSeek',
+  stepfun: 'StepFun',
+  siliconflow: 'SiliconFlow',
+  'siliconflow-cn': 'SiliconFlow',
+  'siliconflow-en': 'SiliconFlow',
+  openrouter: 'OpenRouter',
+  novita: 'Novita',
+  sub2api: 'Sub2API',
+  'apikey.fun': 'ApiKey',
+};
+
+/** 仅用于未知中转的界面标注，不能用于选择查询端点或发送凭据。 */
+export function inferModelProviderName(modelId: string): string | undefined {
+  const normalized = modelId.trim().toLowerCase().split('/').pop() ?? '';
+  return MODEL_PROVIDER_PATTERNS.find(([pattern]) => pattern.test(normalized))?.[1];
+}
+
+/** 内部标识只用于逻辑；状态栏显示官方拉丁品牌名，未知值保留宿主原文。 */
+export function displayProviderName(providerId: string): string {
+  const normalized = providerId.toLowerCase();
+  return QUERY_DISPLAY_NAMES[normalized] ?? findProviderById(normalized)?.displayName ?? providerId;
+}

package/modules/tui/kernel/pkg/shared/provider-parsers.ts

@@ -0,0 +1,171 @@
+// 供应商响应解析（纯函数，零 IO）。字段口径以 cc-switch 0b5da51 为基准，
+// Sub2API /v1/usage 另按 ApiKey 现场响应与 Sub2API 上游实现适配。
+// 解析器只由查询运行层按路由表绑定消费，不从 usage-core / usage-node 出口导出。
+
+import type { BalanceValue, ProviderUsage, QuotaInfo, QuotaWindow } from './provider-contracts.ts';
+
+export function numberValue(value: unknown): number | null {
+  const parsed = typeof value === 'number' ? value : typeof value === 'string' ? Number(value) : NaN;
+  return Number.isFinite(parsed) ? parsed : null;
+}
+
+function currencyValue(value: unknown, fallback: 'CNY' | 'USD'): 'CNY' | 'USD' {
+  const currency = String(value).toUpperCase();
+  if (currency === 'USD' || currency === 'CNY') return currency;
+  return fallback;
+}
+
+function clampPercent(value: number): number {
+  return Math.max(0, Math.min(100, value));
+}
+
+function resetTime(value: unknown): number | null {
+  const numeric = numberValue(value);
+  if (numeric != null) {
+    if (numeric <= 0) return null;
+    return numeric < 1_000_000_000_000 ? numeric * 1000 : numeric;
+  }
+  if (typeof value !== 'string') return null;
+  const parsed = Date.parse(value);
+  return Number.isFinite(parsed) ? parsed : null;
+}
+
+function remainingWindow(label: string, remainingPercent: number, reset: unknown): QuotaWindow {
+  return { label, remainingPercent: clampPercent(remainingPercent), resetMs: resetTime(reset) };
+}
+
+function usageWindow(label: string, used: unknown, limit: unknown, reset: unknown): QuotaWindow | null {
+  const usedValue = numberValue(used);
+  const limitValue = numberValue(limit);
+  if (usedValue == null || limitValue == null || limitValue <= 0) return null;
+  return remainingWindow(label, 100 - (usedValue / limitValue) * 100, reset);
+}
+
+export function parseStepFunBalance(json: any): BalanceValue | null {
+  const amount = numberValue(json?.balance);
+  return amount == null ? null : { amount, currency: 'CNY' };
+}
+
+export function parseSiliconFlowBalance(json: any, international: boolean): BalanceValue | null {
+  const amount = numberValue(json?.data?.totalBalance);
+  if (amount == null) return null;
+  return { amount, currency: international ? 'USD' : 'CNY' };
+}
+
+export function parseOpenRouterBalance(json: any): BalanceValue | null {
+  const data = json?.data ?? json;
+  const total = numberValue(data?.total_credits);
+  const used = numberValue(data?.total_usage);
+  if (total == null || used == null) return null;
+  return { amount: total - used, currency: 'USD' };
+}
+
+export function parseNovitaBalance(json: any): BalanceValue | null {
+  const units = numberValue(json?.availableBalance);
+  return units == null ? null : { amount: units / 10_000, currency: 'USD' };
+}
+
+export function parseKimiBalance(json: any, international = false): BalanceValue | null {
+  if ((json?.code !== 0 && json?.code !== '0') || !json?.data) return null;
+  const amount = numberValue(json.data.available_balance);
+  return amount == null
+    ? null
+    : { amount, currency: international ? 'USD' : 'CNY' };
+}
+
+export function parseKimiQuota(json: any): QuotaInfo | null {
+  // 官方接口当前返回裸对象；兼容网关包裹在 data 下的同一响应，
+  // 但不把普通余额响应误认为套餐额度。
+  const payload = json?.data && (json.data.usage || json.data.limits) ? json.data : json;
+  const windows: QuotaWindow[] = [];
+  const detail = Array.isArray(payload?.limits)
+    ? payload.limits.map((item: any) => item?.detail).find((item: any) => item && numberValue(item.limit) != null)
+    : null;
+  if (detail) {
+    const limit = numberValue(detail.limit);
+    const remaining = numberValue(detail.remaining);
+    if (limit != null && limit > 0 && remaining != null) {
+      windows.push(remainingWindow('5h', (remaining / limit) * 100, detail.resetTime));
+    }
+  }
+  const weeklyLimit = numberValue(payload?.usage?.limit);
+  const weeklyRemaining = numberValue(payload?.usage?.remaining);
+  if (weeklyLimit != null && weeklyLimit > 0 && weeklyRemaining != null) {
+    windows.push(remainingWindow('7d', (weeklyRemaining / weeklyLimit) * 100, payload.usage.resetTime));
+  }
+  return windows.length > 0 ? { provider: 'kimi', windows } : null;
+}
+
+export function parseMiniMaxQuota(json: any): QuotaInfo | null {
+  if (numberValue(json?.base_resp?.status_code) != null && numberValue(json.base_resp.status_code) !== 0) {
+    return null;
+  }
+  const item = Array.isArray(json?.model_remains)
+    ? json.model_remains.find((entry: any) => entry?.model_name === 'general')
+    : null;
+  if (!item) return null;
+
+  const windows: QuotaWindow[] = [];
+  const interval = numberValue(item.current_interval_remaining_percent);
+  if (interval != null) windows.push(remainingWindow('5h', interval, item.end_time));
+  if (numberValue(item.current_weekly_status) === 1) {
+    const weekly = numberValue(item.current_weekly_remaining_percent);
+    if (weekly != null) windows.push(remainingWindow('7d', weekly, item.weekly_end_time));
+  }
+  return windows.length > 0 ? { provider: 'minimax', windows } : null;
+}
+
+export function parseZenMuxQuota(json: any): QuotaInfo | null {
+  if (json?.success !== true || !json?.data) return null;
+  const windows: QuotaWindow[] = [];
+  for (const [field, label] of [
+    ['quota_5_hour', '5h'],
+    ['quota_7_day', '7d'],
+  ] as const) {
+    const item = json.data[field];
+    const usedRatio = numberValue(item?.usage_percentage);
+    if (usedRatio != null) windows.push(remainingWindow(label, 100 - usedRatio * 100, item.resets_at));
+  }
+  return windows.length > 0 ? { provider: 'zenmux', windows } : null;
+}
+
+function sub2ApiSubscriptionWindows(subscription: any): QuotaWindow[] {
+  const weeklyStart = resetTime(subscription?.weekly_window_start);
+  const weeklyReset = weeklyStart == null ? null : weeklyStart + 7 * 86_400_000;
+  return [
+    usageWindow('1d', subscription?.daily_usage_usd, subscription?.daily_limit_usd, null),
+    usageWindow('7d', subscription?.weekly_usage_usd, subscription?.weekly_limit_usd, weeklyReset),
+    usageWindow('30d', subscription?.monthly_usage_usd, subscription?.monthly_limit_usd, subscription?.expires_at),
+  ].filter((window): window is QuotaWindow => window != null);
+}
+
+function sub2ApiRateWindows(rateLimits: any): QuotaWindow[] {
+  if (!Array.isArray(rateLimits)) return [];
+  return rateLimits
+    .map((item: any) => usageWindow(String(item?.window ?? ''), item?.used, item?.limit, item?.reset_at))
+    .filter((window): window is QuotaWindow => window != null && window.label.length > 0);
+}
+
+export function parseSub2ApiUsage(json: any, provider: string): ProviderUsage | null {
+  if (!json || json.isValid === false || json.error) return null;
+
+  const subscriptionWindows = sub2ApiSubscriptionWindows(json.subscription);
+  const rateWindows = sub2ApiRateWindows(json.rate_limits);
+  const windows = [...subscriptionWindows, ...rateWindows];
+  const quotaRemaining = numberValue(json?.quota?.remaining);
+  const walletRemaining = numberValue(json?.remaining) ?? numberValue(json?.balance);
+  const amount = quotaRemaining ?? walletRemaining;
+  const balance =
+    amount == null
+      ? undefined
+      : { amount, currency: currencyValue(json?.quota?.unit ?? json?.unit, 'USD') };
+
+  if (windows.length > 0) {
+    return {
+      mode: balance ? 'hybrid' : 'subscription',
+      balance,
+      quota: { provider, windows },
+    };
+  }
+  return balance ? { mode: 'api', balance } : null;
+}

package/modules/tui/kernel/pkg/shared/volcengine.ts

@@ -0,0 +1,191 @@
+// 火山方舟 Agent Plan / Coding Plan 控制面查询。
+// 协议与签名规则移植自 cc-switch 0b5da51 coding_plan.rs；它使用 AK/SK，
+// 不能复用推理接口的 Bearer Key。
+
+import { createHash, createHmac } from 'node:crypto';
+import type { QuotaInfo, QuotaWindow } from './provider-contracts.ts';
+
+const HOST = 'open.volcengineapi.com';
+const VERSION = '2024-01-01';
+const SERVICE = 'ark';
+const CONTENT_TYPE = 'application/json; charset=utf-8';
+const SIGNED_HEADERS = 'host;x-date;x-content-sha256;content-type';
+
+function sha256Hex(value: string): string {
+  return createHash('sha256').update(value).digest('hex');
+}
+
+function hmac(key: string | Buffer, value: string): Buffer {
+  return createHmac('sha256', key).update(value).digest();
+}
+
+function isoBasic(date: Date): string {
+  return date.toISOString().replace(/[-:]/g, '').replace(/\.\d{3}Z$/, 'Z');
+}
+
+function shortDate(date: Date): string {
+  return isoBasic(date).slice(0, 8);
+}
+
+function encodeRfc3986(value: string): string {
+  return encodeURIComponent(value).replace(/[!'()*]/g, (char) => `%${char.charCodeAt(0).toString(16).toUpperCase()}`);
+}
+
+export function volcengineRegion(baseUrl: string): string {
+  try {
+    return new URL(baseUrl).hostname.split('.').find((part) => /^(?:cn|ap)-/.test(part)) ?? 'cn-beijing';
+  } catch {
+    return 'cn-beijing';
+  }
+}
+
+export function volcengineCanonicalQuery(action: string, region: string): string {
+  return [
+    ['Action', action],
+    ['Region', region],
+    ['Version', VERSION],
+  ]
+    .sort(([left], [right]) => left.localeCompare(right))
+    .map(([key, value]) => `${encodeRfc3986(key)}=${encodeRfc3986(value)}`)
+    .join('&');
+}
+
+export function signVolcengineRequest(
+  accessKeyId: string,
+  secretAccessKey: string,
+  region: string,
+  canonicalQuery: string,
+  now: Date,
+): { authorization: string; xDate: string; contentSha256: string } {
+  const xDate = isoBasic(now);
+  const date = shortDate(now);
+  const contentSha256 = sha256Hex('');
+  const canonicalHeaders =
+    `host:${HOST}\n` +
+    `x-date:${xDate}\n` +
+    `x-content-sha256:${contentSha256}\n` +
+    `content-type:${CONTENT_TYPE}\n`;
+  const canonicalRequest =
+    `POST\n/\n${canonicalQuery}\n${canonicalHeaders}\n${SIGNED_HEADERS}\n${contentSha256}`;
+  const scope = `${date}/${region}/${SERVICE}/request`;
+  const stringToSign = `HMAC-SHA256\n${xDate}\n${scope}\n${sha256Hex(canonicalRequest)}`;
+  const kDate = hmac(secretAccessKey, date);
+  const kRegion = hmac(kDate, region);
+  const kService = hmac(kRegion, SERVICE);
+  const kSigning = hmac(kService, 'request');
+  const signature = hmac(kSigning, stringToSign).toString('hex');
+  return {
+    authorization:
+      `HMAC-SHA256 Credential=${accessKeyId}/${scope}, ` +
+      `SignedHeaders=${SIGNED_HEADERS}, Signature=${signature}`,
+    xDate,
+    contentSha256,
+  };
+}
+
+function numberValue(value: unknown): number | null {
+  const parsed = typeof value === 'number' ? value : typeof value === 'string' ? Number(value) : NaN;
+  return Number.isFinite(parsed) ? parsed : null;
+}
+
+function resetMs(value: unknown): number | null {
+  const numeric = numberValue(value);
+  if (numeric != null) return numeric <= 0 ? null : numeric < 1_000_000_000_000 ? numeric * 1000 : numeric;
+  if (typeof value !== 'string') return null;
+  const parsed = Date.parse(value);
+  return Number.isFinite(parsed) ? parsed : null;
+}
+
+function window(label: string, usedPercent: number, reset: unknown): QuotaWindow {
+  return {
+    label,
+    remainingPercent: Math.max(0, Math.min(100, 100 - usedPercent)),
+    resetMs: resetMs(reset),
+  };
+}
+
+export function parseVolcengineAgentPlan(json: any): QuotaInfo | null {
+  const result = json?.Result ?? json;
+  const windows: QuotaWindow[] = [];
+  for (const [field, label] of [
+    ['AFPFiveHour', '5h'],
+    ['AFPWeekly', '7d'],
+    ['AFPMonthly', '30d'],
+  ] as const) {
+    const item = result?.[field];
+    const quota = numberValue(item?.Quota);
+    const used = numberValue(item?.Used);
+    if (quota != null && quota > 0 && used != null) {
+      windows.push(window(label, (used / quota) * 100, item?.ResetTime));
+    }
+  }
+  return windows.length ? { provider: 'volcengine', windows } : null;
+}
+
+function codingWindow(value: unknown): string | null {
+  const label = String(value ?? '').toLowerCase();
+  if (['session', '5h', 'fivehour', 'five_hour', 'rolling_5h'].includes(label)) return '5h';
+  if (['weekly', 'week', '7d'].includes(label)) return '7d';
+  if (['monthly', 'month'].includes(label)) return '30d';
+  return null;
+}
+
+export function parseVolcengineCodingPlan(json: any): QuotaInfo | null {
+  const result = json?.Result ?? json;
+  const items = result?.QuotaUsage ?? result?.Usages ?? result?.Details;
+  if (!Array.isArray(items)) return null;
+  const windows = items.flatMap((item: any): QuotaWindow[] => {
+    const label = codingWindow(item?.Level ?? item?.Type ?? item?.Period ?? item?.Label ?? item?.Window);
+    const used = numberValue(item?.Percent ?? item?.UsedPercent ?? item?.UsagePercent);
+    return label && used != null
+      ? [window(label, used, item?.ResetTime ?? item?.ResetTimestamp)]
+      : [];
+  });
+  return windows.length ? { provider: 'volcengine', windows } : null;
+}
+
+function hasResponseError(json: any): boolean {
+  const error = json?.ResponseMetadata?.Error ?? json?.Error;
+  return Boolean(error?.Code || error?.Message);
+}
+
+async function callVolcengine(
+  action: string,
+  region: string,
+  accessKeyId: string,
+  secretAccessKey: string,
+  request: typeof fetch,
+): Promise<any | null> {
+  const canonicalQuery = volcengineCanonicalQuery(action, region);
+  const signed = signVolcengineRequest(accessKeyId, secretAccessKey, region, canonicalQuery, new Date());
+  const response = await request(`https://${HOST}/?${canonicalQuery}`, {
+    method: 'POST',
+    headers: {
+      Authorization: signed.authorization,
+      'Content-Type': CONTENT_TYPE,
+      'X-Date': signed.xDate,
+      'X-Content-Sha256': signed.contentSha256,
+    },
+    body: '',
+    signal: AbortSignal.timeout(15_000),
+  });
+  const json = await response.json().catch(() => null);
+  return response.ok && json && !hasResponseError(json) ? json : null;
+}
+
+export async function fetchVolcengineQuota(
+  baseUrl: string,
+  accessKeyId: string,
+  secretAccessKey: string,
+  request: typeof fetch = fetch,
+  plan: 'agent' | 'coding' = 'agent',
+): Promise<QuotaInfo | null> {
+  if (!accessKeyId || !secretAccessKey) return null;
+  const region = volcengineRegion(baseUrl);
+  if (plan === 'coding') {
+    const coding = await callVolcengine('GetCodingPlanUsage', region, accessKeyId, secretAccessKey, request);
+    return parseVolcengineCodingPlan(coding);
+  }
+  const agent = await callVolcengine('GetAFPUsage', region, accessKeyId, secretAccessKey, request);
+  return parseVolcengineAgentPlan(agent);
+}