@aigne/afs-github-cost 1.11.0-beta.12

package/LICENSE.md

@@ -0,0 +1,26 @@
+# Proprietary License
+
+Copyright (c) 2024-2025 ArcBlock, Inc. All Rights Reserved.
+
+This software and associated documentation files (the "Software") are proprietary
+and confidential. Unauthorized copying, modification, distribution, or use of
+this Software, via any medium, is strictly prohibited.
+
+The Software is provided for internal use only within ArcBlock, Inc. and its
+authorized affiliates.
+
+## No License Granted
+
+No license, express or implied, is granted to any party for any purpose.
+All rights are reserved by ArcBlock, Inc.
+
+## Public Artifact Distribution
+
+Portions of this Software may be released publicly under separate open-source
+licenses (such as MIT License) through designated public repositories. Such
+public releases are governed by their respective licenses and do not affect
+the proprietary nature of this repository.
+
+## Contact
+
+For licensing inquiries, contact: legal@arcblock.io

package/dist/adapter.cjs

@@ -0,0 +1,215 @@
+
+//#region src/adapter.ts
+const SERVICE_NAME_MAP = {
+	actions: "actions",
+	packages: "packages",
+	codespaces: "codespaces",
+	copilot: "copilot",
+	"shared-storage": "shared-storage",
+	"git-lfs-data": "git-lfs",
+	"actions-minutes": "actions",
+	"actions-storage": "actions-storage",
+	"codespaces-compute": "codespaces-compute",
+	"codespaces-prebuild": "codespaces-prebuild",
+	"copilot-business": "copilot",
+	"copilot-enterprise": "copilot"
+};
+function normalizeServiceName(product) {
+	if (!product) return "unknown";
+	const lower = product.toLowerCase();
+	if (SERVICE_NAME_MAP[lower]) return SERVICE_NAME_MAP[lower];
+	return lower.replace(/\s+/g, "-");
+}
+const PLAN_PRICE_MAP = {
+	free: 0,
+	team: 4,
+	"business-plus": 21,
+	enterprise: 21
+};
+function planPricePerSeat(planName) {
+	return PLAN_PRICE_MAP[planName.toLowerCase()] ?? 0;
+}
+/** Number of days in the month that contains `dateStr` (YYYY-MM-DD). */
+function daysInMonth(dateStr) {
+	const { year, month } = parseDateParts(dateStr);
+	return new Date(year, month, 0).getDate();
+}
+/** Parse "YYYY-MM-DD" into { year, month, day } */
+function parseDateParts(dateStr) {
+	const parts = dateStr.split("-").map(Number);
+	return {
+		year: parts[0] ?? 0,
+		month: parts[1] ?? 0,
+		day: parts[2] ?? 0
+	};
+}
+/** Iterate over each day in [startDate, endDate) */
+function* eachDay(startDate, endDate) {
+	const start = /* @__PURE__ */ new Date(`${startDate}T00:00:00Z`);
+	const end = /* @__PURE__ */ new Date(`${endDate}T00:00:00Z`);
+	const current = new Date(start);
+	while (current < end) {
+		yield current.toISOString().slice(0, 10);
+		current.setUTCDate(current.getUTCDate() + 1);
+	}
+}
+/** Map over items with bounded concurrency. No external dependencies. */
+async function pMap(items, fn, concurrency) {
+	const results = new Array(items.length);
+	let index = 0;
+	async function next() {
+		const i = index++;
+		if (i >= items.length) return;
+		results[i] = await fn(items[i]);
+		return next();
+	}
+	await Promise.all(Array.from({ length: Math.min(concurrency, items.length) }, () => next()));
+	return results;
+}
+const BILLING_API_BASE = "https://api.github.com/orgs";
+var GitHubCostAdapter = class {
+	cloud = "github";
+	config;
+	client;
+	cachedServices = null;
+	constructor(config = {}, client) {
+		this.config = config;
+		this.client = client;
+	}
+	async isAvailable() {
+		if (!this.config.token || !this.config.org) return false;
+		try {
+			const client = this.getClient();
+			if (!client) return false;
+			const { year, month, day } = parseDateParts((/* @__PURE__ */ new Date()).toISOString().slice(0, 10));
+			const url = `${BILLING_API_BASE}/${this.config.org}/settings/billing/usage?year=${year}&month=${month}&day=${day}`;
+			return (await client.get(url, { headers: this.buildHeaders() })).status === 200;
+		} catch {
+			return false;
+		}
+	}
+	async fetchCosts(options) {
+		const client = this.getClient();
+		if (!client) throw new Error("GitHub HTTP client not available");
+		const org = this.config.org;
+		if (!org) throw new Error("Missing org in GitHub config");
+		const headers = this.buildHeaders();
+		const days = [...eachDay(options.startDate, options.endDate)];
+		const orgPlan = await this.fetchOrgPlan(client, org, headers);
+		const records = (await pMap(days, async (day) => {
+			const { year, month, day: d } = parseDateParts(day);
+			const url = `${BILLING_API_BASE}/${org}/settings/billing/usage?year=${year}&month=${month}&day=${d}`;
+			const response = await client.get(url, { headers });
+			if (response.status === 403) {
+				const msg = response.data?.message ?? "";
+				if (typeof msg === "string" && msg.toLowerCase().includes("rate limit")) throw new Error(`GitHub API rate limit exceeded. Retry after a few minutes.`);
+				throw new Error("Insufficient permissions: requires read:billing scope");
+			}
+			if (response.status === 404) throw new Error("Organization not found or not on Enhanced Billing Platform");
+			if (response.status !== 200) throw new Error(`GitHub API error: status ${response.status}`);
+			const items = response.data.usageItems ?? [];
+			const records$1 = [];
+			for (const item of items) {
+				const netAmount = item.netAmount ?? item.grossAmount - (item.discountAmount ?? 0);
+				const record = {
+					cloud: "github",
+					service: normalizeServiceName(item.product),
+					date: day,
+					amount: netAmount,
+					currency: "USD"
+				};
+				if (item.quantity != null) record.usage = {
+					value: item.quantity,
+					unit: item.unitType ?? "units"
+				};
+				records$1.push(record);
+			}
+			if (orgPlan) {
+				const pricePerSeat = planPricePerSeat(orgPlan.planName);
+				if (pricePerSeat > 0 && orgPlan.seats > 0) {
+					const dim = daysInMonth(day);
+					const dailyAmount = orgPlan.seats * pricePerSeat / dim;
+					records$1.push({
+						cloud: "github",
+						service: "seats",
+						date: day,
+						amount: Math.round(dailyAmount * 1e6) / 1e6,
+						currency: "USD",
+						usage: {
+							value: orgPlan.seats,
+							unit: "seats"
+						}
+					});
+				}
+			}
+			return records$1;
+		}, 5)).flat();
+		this.cachedServices = [...new Set(records.map((r) => r.service))];
+		return records;
+	}
+	/** Fetch org plan info (plan name + seat count). Returns null on failure. */
+	async fetchOrgPlan(client, org, headers) {
+		try {
+			if (client.getOrgPlan) {
+				const resp = await client.getOrgPlan(`https://api.github.com/orgs/${org}`, { headers });
+				if (resp.status === 200 && resp.data.plan) return {
+					planName: resp.data.plan.name,
+					seats: resp.data.plan.seats
+				};
+			}
+		} catch {}
+		return null;
+	}
+	async listServices() {
+		if (this.cachedServices) return this.cachedServices;
+		return [];
+	}
+	capabilities() {
+		return {
+			supportsAmount: true,
+			supportsUsage: true,
+			supportsTags: false,
+			supportsRegion: false,
+			supportsAccount: false,
+			supportsForecast: false
+		};
+	}
+	getClient() {
+		if (this.client) return this.client;
+		this.client = {
+			async get(url, options) {
+				const resp = await fetch(url, {
+					method: "GET",
+					headers: options.headers
+				});
+				const data = await resp.json();
+				return {
+					status: resp.status,
+					data
+				};
+			},
+			async getOrgPlan(url, options) {
+				const resp = await fetch(url, {
+					method: "GET",
+					headers: options.headers
+				});
+				const data = await resp.json();
+				return {
+					status: resp.status,
+					data
+				};
+			}
+		};
+		return this.client;
+	}
+	buildHeaders() {
+		return {
+			Authorization: `Bearer ${this.config.token}`,
+			Accept: "application/json",
+			"X-GitHub-Api-Version": "2022-11-28"
+		};
+	}
+};
+
+//#endregion
+exports.GitHubCostAdapter = GitHubCostAdapter;

package/dist/adapter.d.cts

@@ -0,0 +1,66 @@
+import { AdapterCapabilities, CostAdapter, CostRecord } from "@aigne/afs-cost-base";
+
+//#region src/adapter.d.ts
+/** Minimal HTTP client for GitHub Enhanced Billing Platform REST API */
+interface GitHubHTTPClient {
+  get(url: string, options: {
+    headers: Record<string, string>;
+  }): Promise<GitHubBillingResponse>;
+  /** Fetch org plan/seat info. Optional — when absent, seat costs are not reported. */
+  getOrgPlan?(url: string, options: {
+    headers: Record<string, string>;
+  }): Promise<GitHubOrgPlanResponse>;
+}
+interface GitHubBillingResponse {
+  status: number;
+  data: {
+    usageItems?: GitHubUsageItem[];
+  };
+}
+interface GitHubOrgPlanResponse {
+  status: number;
+  data: {
+    plan?: {
+      name: string;
+      seats: number;
+      filled_seats: number;
+    };
+  };
+}
+interface GitHubUsageItem {
+  date: string;
+  product: string;
+  sku: string;
+  quantity: number;
+  unitType: string;
+  pricePerUnit: number;
+  grossAmount: number;
+  discountAmount?: number;
+  netAmount: number;
+  organizationName?: string;
+}
+interface GitHubCostConfig {
+  token?: string;
+  org?: string;
+}
+declare class GitHubCostAdapter implements CostAdapter {
+  readonly cloud = "github";
+  private config;
+  private client?;
+  private cachedServices;
+  constructor(config?: GitHubCostConfig, client?: GitHubHTTPClient);
+  isAvailable(): Promise<boolean>;
+  fetchCosts(options: {
+    startDate: string;
+    endDate: string;
+  }): Promise<CostRecord[]>;
+  /** Fetch org plan info (plan name + seat count). Returns null on failure. */
+  private fetchOrgPlan;
+  listServices(): Promise<string[]>;
+  capabilities(): AdapterCapabilities;
+  private getClient;
+  private buildHeaders;
+}
+//#endregion
+export { GitHubBillingResponse, GitHubCostAdapter, GitHubCostConfig, GitHubHTTPClient, GitHubOrgPlanResponse, GitHubUsageItem };
+//# sourceMappingURL=adapter.d.cts.map

package/dist/adapter.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.cts","names":[],"sources":["../src/adapter.ts"],"mappings":";;;;UAOiB,gBAAA;EACf,GAAA,CAAI,GAAA,UAAa,OAAA;IAAW,OAAA,EAAS,MAAA;EAAA,IAA2B,OAAA,CAAQ,qBAAA;EAAnC;EAErC,UAAA,EACE,GAAA,UACA,OAAA;IAAW,OAAA,EAAS,MAAA;EAAA,IACnB,OAAA,CAAQ,qBAAA;AAAA;AAAA,UAGI,qBAAA;EACf,MAAA;EACA,IAAA;IACE,UAAA,GAAa,eAAA;EAAA;AAAA;AAAA,UAIA,qBAAA;EACf,MAAA;EACA,IAAA;IACE,IAAA;MACE,IAAA;MACA,KAAA;MACA,YAAA;IAAA;EAAA;AAAA;AAAA,UAKW,eAAA;EACf,IAAA;EACA,OAAA;EACA,GAAA;EACA,QAAA;EACA,QAAA;EACA,YAAA;EACA,WAAA;EACA,cAAA;EACA,SAAA;EACA,gBAAA;AAAA;AAAA,UAkGe,gBAAA;EACf,KAAA;EACA,GAAA;AAAA;AAAA,cAKW,iBAAA,YAA6B,WAAA;EAAA,SAC/B,KAAA;EAAA,QACD,MAAA;EAAA,QACA,MAAA;EAAA,QACA,cAAA;cAEI,MAAA,GAAQ,gBAAA,EAAuB,MAAA,GAAS,gBAAA;EAK9C,WAAA,CAAA,GAAe,OAAA;EAsBf,UAAA,CAAW,OAAA;IAAW,SAAA;IAAmB,OAAA;EAAA,IAAoB,OAAA,CAAQ,UAAA;;UAwF7D,YAAA;EAkBR,YAAA,CAAA,GAAgB,OAAA;EAKtB,YAAA,CAAA,GAAgB,mBAAA;EAAA,QAWR,SAAA;EAAA,QA8BA,YAAA;AAAA"}

package/dist/adapter.d.mts

@@ -0,0 +1,66 @@
+import { AdapterCapabilities, CostAdapter, CostRecord } from "@aigne/afs-cost-base";
+
+//#region src/adapter.d.ts
+/** Minimal HTTP client for GitHub Enhanced Billing Platform REST API */
+interface GitHubHTTPClient {
+  get(url: string, options: {
+    headers: Record<string, string>;
+  }): Promise<GitHubBillingResponse>;
+  /** Fetch org plan/seat info. Optional — when absent, seat costs are not reported. */
+  getOrgPlan?(url: string, options: {
+    headers: Record<string, string>;
+  }): Promise<GitHubOrgPlanResponse>;
+}
+interface GitHubBillingResponse {
+  status: number;
+  data: {
+    usageItems?: GitHubUsageItem[];
+  };
+}
+interface GitHubOrgPlanResponse {
+  status: number;
+  data: {
+    plan?: {
+      name: string;
+      seats: number;
+      filled_seats: number;
+    };
+  };
+}
+interface GitHubUsageItem {
+  date: string;
+  product: string;
+  sku: string;
+  quantity: number;
+  unitType: string;
+  pricePerUnit: number;
+  grossAmount: number;
+  discountAmount?: number;
+  netAmount: number;
+  organizationName?: string;
+}
+interface GitHubCostConfig {
+  token?: string;
+  org?: string;
+}
+declare class GitHubCostAdapter implements CostAdapter {
+  readonly cloud = "github";
+  private config;
+  private client?;
+  private cachedServices;
+  constructor(config?: GitHubCostConfig, client?: GitHubHTTPClient);
+  isAvailable(): Promise<boolean>;
+  fetchCosts(options: {
+    startDate: string;
+    endDate: string;
+  }): Promise<CostRecord[]>;
+  /** Fetch org plan info (plan name + seat count). Returns null on failure. */
+  private fetchOrgPlan;
+  listServices(): Promise<string[]>;
+  capabilities(): AdapterCapabilities;
+  private getClient;
+  private buildHeaders;
+}
+//#endregion
+export { GitHubBillingResponse, GitHubCostAdapter, GitHubCostConfig, GitHubHTTPClient, GitHubOrgPlanResponse, GitHubUsageItem };
+//# sourceMappingURL=adapter.d.mts.map

package/dist/adapter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.mts","names":[],"sources":["../src/adapter.ts"],"mappings":";;;;UAOiB,gBAAA;EACf,GAAA,CAAI,GAAA,UAAa,OAAA;IAAW,OAAA,EAAS,MAAA;EAAA,IAA2B,OAAA,CAAQ,qBAAA;EAAnC;EAErC,UAAA,EACE,GAAA,UACA,OAAA;IAAW,OAAA,EAAS,MAAA;EAAA,IACnB,OAAA,CAAQ,qBAAA;AAAA;AAAA,UAGI,qBAAA;EACf,MAAA;EACA,IAAA;IACE,UAAA,GAAa,eAAA;EAAA;AAAA;AAAA,UAIA,qBAAA;EACf,MAAA;EACA,IAAA;IACE,IAAA;MACE,IAAA;MACA,KAAA;MACA,YAAA;IAAA;EAAA;AAAA;AAAA,UAKW,eAAA;EACf,IAAA;EACA,OAAA;EACA,GAAA;EACA,QAAA;EACA,QAAA;EACA,YAAA;EACA,WAAA;EACA,cAAA;EACA,SAAA;EACA,gBAAA;AAAA;AAAA,UAkGe,gBAAA;EACf,KAAA;EACA,GAAA;AAAA;AAAA,cAKW,iBAAA,YAA6B,WAAA;EAAA,SAC/B,KAAA;EAAA,QACD,MAAA;EAAA,QACA,MAAA;EAAA,QACA,cAAA;cAEI,MAAA,GAAQ,gBAAA,EAAuB,MAAA,GAAS,gBAAA;EAK9C,WAAA,CAAA,GAAe,OAAA;EAsBf,UAAA,CAAW,OAAA;IAAW,SAAA;IAAmB,OAAA;EAAA,IAAoB,OAAA,CAAQ,UAAA;;UAwF7D,YAAA;EAkBR,YAAA,CAAA,GAAgB,OAAA;EAKtB,YAAA,CAAA,GAAgB,mBAAA;EAAA,QAWR,SAAA;EAAA,QA8BA,YAAA;AAAA"}

package/dist/adapter.mjs

@@ -0,0 +1,215 @@
+//#region src/adapter.ts
+const SERVICE_NAME_MAP = {
+	actions: "actions",
+	packages: "packages",
+	codespaces: "codespaces",
+	copilot: "copilot",
+	"shared-storage": "shared-storage",
+	"git-lfs-data": "git-lfs",
+	"actions-minutes": "actions",
+	"actions-storage": "actions-storage",
+	"codespaces-compute": "codespaces-compute",
+	"codespaces-prebuild": "codespaces-prebuild",
+	"copilot-business": "copilot",
+	"copilot-enterprise": "copilot"
+};
+function normalizeServiceName(product) {
+	if (!product) return "unknown";
+	const lower = product.toLowerCase();
+	if (SERVICE_NAME_MAP[lower]) return SERVICE_NAME_MAP[lower];
+	return lower.replace(/\s+/g, "-");
+}
+const PLAN_PRICE_MAP = {
+	free: 0,
+	team: 4,
+	"business-plus": 21,
+	enterprise: 21
+};
+function planPricePerSeat(planName) {
+	return PLAN_PRICE_MAP[planName.toLowerCase()] ?? 0;
+}
+/** Number of days in the month that contains `dateStr` (YYYY-MM-DD). */
+function daysInMonth(dateStr) {
+	const { year, month } = parseDateParts(dateStr);
+	return new Date(year, month, 0).getDate();
+}
+/** Parse "YYYY-MM-DD" into { year, month, day } */
+function parseDateParts(dateStr) {
+	const parts = dateStr.split("-").map(Number);
+	return {
+		year: parts[0] ?? 0,
+		month: parts[1] ?? 0,
+		day: parts[2] ?? 0
+	};
+}
+/** Iterate over each day in [startDate, endDate) */
+function* eachDay(startDate, endDate) {
+	const start = /* @__PURE__ */ new Date(`${startDate}T00:00:00Z`);
+	const end = /* @__PURE__ */ new Date(`${endDate}T00:00:00Z`);
+	const current = new Date(start);
+	while (current < end) {
+		yield current.toISOString().slice(0, 10);
+		current.setUTCDate(current.getUTCDate() + 1);
+	}
+}
+/** Map over items with bounded concurrency. No external dependencies. */
+async function pMap(items, fn, concurrency) {
+	const results = new Array(items.length);
+	let index = 0;
+	async function next() {
+		const i = index++;
+		if (i >= items.length) return;
+		results[i] = await fn(items[i]);
+		return next();
+	}
+	await Promise.all(Array.from({ length: Math.min(concurrency, items.length) }, () => next()));
+	return results;
+}
+const BILLING_API_BASE = "https://api.github.com/orgs";
+var GitHubCostAdapter = class {
+	cloud = "github";
+	config;
+	client;
+	cachedServices = null;
+	constructor(config = {}, client) {
+		this.config = config;
+		this.client = client;
+	}
+	async isAvailable() {
+		if (!this.config.token || !this.config.org) return false;
+		try {
+			const client = this.getClient();
+			if (!client) return false;
+			const { year, month, day } = parseDateParts((/* @__PURE__ */ new Date()).toISOString().slice(0, 10));
+			const url = `${BILLING_API_BASE}/${this.config.org}/settings/billing/usage?year=${year}&month=${month}&day=${day}`;
+			return (await client.get(url, { headers: this.buildHeaders() })).status === 200;
+		} catch {
+			return false;
+		}
+	}
+	async fetchCosts(options) {
+		const client = this.getClient();
+		if (!client) throw new Error("GitHub HTTP client not available");
+		const org = this.config.org;
+		if (!org) throw new Error("Missing org in GitHub config");
+		const headers = this.buildHeaders();
+		const days = [...eachDay(options.startDate, options.endDate)];
+		const orgPlan = await this.fetchOrgPlan(client, org, headers);
+		const records = (await pMap(days, async (day) => {
+			const { year, month, day: d } = parseDateParts(day);
+			const url = `${BILLING_API_BASE}/${org}/settings/billing/usage?year=${year}&month=${month}&day=${d}`;
+			const response = await client.get(url, { headers });
+			if (response.status === 403) {
+				const msg = response.data?.message ?? "";
+				if (typeof msg === "string" && msg.toLowerCase().includes("rate limit")) throw new Error(`GitHub API rate limit exceeded. Retry after a few minutes.`);
+				throw new Error("Insufficient permissions: requires read:billing scope");
+			}
+			if (response.status === 404) throw new Error("Organization not found or not on Enhanced Billing Platform");
+			if (response.status !== 200) throw new Error(`GitHub API error: status ${response.status}`);
+			const items = response.data.usageItems ?? [];
+			const records$1 = [];
+			for (const item of items) {
+				const netAmount = item.netAmount ?? item.grossAmount - (item.discountAmount ?? 0);
+				const record = {
+					cloud: "github",
+					service: normalizeServiceName(item.product),
+					date: day,
+					amount: netAmount,
+					currency: "USD"
+				};
+				if (item.quantity != null) record.usage = {
+					value: item.quantity,
+					unit: item.unitType ?? "units"
+				};
+				records$1.push(record);
+			}
+			if (orgPlan) {
+				const pricePerSeat = planPricePerSeat(orgPlan.planName);
+				if (pricePerSeat > 0 && orgPlan.seats > 0) {
+					const dim = daysInMonth(day);
+					const dailyAmount = orgPlan.seats * pricePerSeat / dim;
+					records$1.push({
+						cloud: "github",
+						service: "seats",
+						date: day,
+						amount: Math.round(dailyAmount * 1e6) / 1e6,
+						currency: "USD",
+						usage: {
+							value: orgPlan.seats,
+							unit: "seats"
+						}
+					});
+				}
+			}
+			return records$1;
+		}, 5)).flat();
+		this.cachedServices = [...new Set(records.map((r) => r.service))];
+		return records;
+	}
+	/** Fetch org plan info (plan name + seat count). Returns null on failure. */
+	async fetchOrgPlan(client, org, headers) {
+		try {
+			if (client.getOrgPlan) {
+				const resp = await client.getOrgPlan(`https://api.github.com/orgs/${org}`, { headers });
+				if (resp.status === 200 && resp.data.plan) return {
+					planName: resp.data.plan.name,
+					seats: resp.data.plan.seats
+				};
+			}
+		} catch {}
+		return null;
+	}
+	async listServices() {
+		if (this.cachedServices) return this.cachedServices;
+		return [];
+	}
+	capabilities() {
+		return {
+			supportsAmount: true,
+			supportsUsage: true,
+			supportsTags: false,
+			supportsRegion: false,
+			supportsAccount: false,
+			supportsForecast: false
+		};
+	}
+	getClient() {
+		if (this.client) return this.client;
+		this.client = {
+			async get(url, options) {
+				const resp = await fetch(url, {
+					method: "GET",
+					headers: options.headers
+				});
+				const data = await resp.json();
+				return {
+					status: resp.status,
+					data
+				};
+			},
+			async getOrgPlan(url, options) {
+				const resp = await fetch(url, {
+					method: "GET",
+					headers: options.headers
+				});
+				const data = await resp.json();
+				return {
+					status: resp.status,
+					data
+				};
+			}
+		};
+		return this.client;
+	}
+	buildHeaders() {
+		return {
+			Authorization: `Bearer ${this.config.token}`,
+			Accept: "application/json",
+			"X-GitHub-Api-Version": "2022-11-28"
+		};
+	}
+};
+
+//#endregion
+export { GitHubCostAdapter };
+//# sourceMappingURL=adapter.mjs.map

package/dist/adapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.mjs","names":["records"],"sources":["../src/adapter.ts"],"sourcesContent":["import type { AdapterCapabilities, CostAdapter, CostRecord } from \"@aigne/afs-cost-base\";\n\n// ---------------------------------------------------------------------------\n// HTTP client interface (minimal subset for DI)\n// ---------------------------------------------------------------------------\n\n/** Minimal HTTP client for GitHub Enhanced Billing Platform REST API */\nexport interface GitHubHTTPClient {\n  get(url: string, options: { headers: Record<string, string> }): Promise<GitHubBillingResponse>;\n  /** Fetch org plan/seat info. Optional — when absent, seat costs are not reported. */\n  getOrgPlan?(\n    url: string,\n    options: { headers: Record<string, string> },\n  ): Promise<GitHubOrgPlanResponse>;\n}\n\nexport interface GitHubBillingResponse {\n  status: number;\n  data: {\n    usageItems?: GitHubUsageItem[];\n  };\n}\n\nexport interface GitHubOrgPlanResponse {\n  status: number;\n  data: {\n    plan?: {\n      name: string;\n      seats: number;\n      filled_seats: number;\n    };\n  };\n}\n\nexport interface GitHubUsageItem {\n  date: string;\n  product: string;\n  sku: string;\n  quantity: number;\n  unitType: string;\n  pricePerUnit: number;\n  grossAmount: number;\n  discountAmount?: number;\n  netAmount: number;\n  organizationName?: string;\n}\n\n// ---------------------------------------------------------------------------\n// Service name normalization\n// ---------------------------------------------------------------------------\n\nconst SERVICE_NAME_MAP: Record<string, string> = {\n  actions: \"actions\",\n  packages: \"packages\",\n  codespaces: \"codespaces\",\n  copilot: \"copilot\",\n  \"shared-storage\": \"shared-storage\",\n  \"git-lfs-data\": \"git-lfs\",\n  \"actions-minutes\": \"actions\",\n  \"actions-storage\": \"actions-storage\",\n  \"codespaces-compute\": \"codespaces-compute\",\n  \"codespaces-prebuild\": \"codespaces-prebuild\",\n  \"copilot-business\": \"copilot\",\n  \"copilot-enterprise\": \"copilot\",\n};\n\nfunction normalizeServiceName(product: string): string {\n  if (!product) return \"unknown\";\n  const lower = product.toLowerCase();\n  if (SERVICE_NAME_MAP[lower]) return SERVICE_NAME_MAP[lower];\n  // Fallback: kebab-case\n  return lower.replace(/\\s+/g, \"-\");\n}\n\n// ---------------------------------------------------------------------------\n// Plan pricing (USD per seat per month)\n// ---------------------------------------------------------------------------\n\nconst PLAN_PRICE_MAP: Record<string, number> = {\n  free: 0,\n  team: 4,\n  \"business-plus\": 21,\n  enterprise: 21,\n};\n\nfunction planPricePerSeat(planName: string): number {\n  return PLAN_PRICE_MAP[planName.toLowerCase()] ?? 0;\n}\n\n/** Number of days in the month that contains `dateStr` (YYYY-MM-DD). */\nfunction daysInMonth(dateStr: string): number {\n  const { year, month } = parseDateParts(dateStr);\n  return new Date(year, month, 0).getDate(); // month is 1-based here, Date(y,m,0) gives last day of prev month\n}\n\n// ---------------------------------------------------------------------------\n// Date helpers\n// ---------------------------------------------------------------------------\n\n/** Parse \"YYYY-MM-DD\" into { year, month, day } */\nfunction parseDateParts(dateStr: string): { year: number; month: number; day: number } {\n  const parts = dateStr.split(\"-\").map(Number);\n  return { year: parts[0] ?? 0, month: parts[1] ?? 0, day: parts[2] ?? 0 };\n}\n\n/** Iterate over each day in [startDate, endDate) */\nfunction* eachDay(startDate: string, endDate: string): Generator<string> {\n  const start = new Date(`${startDate}T00:00:00Z`);\n  const end = new Date(`${endDate}T00:00:00Z`);\n  const current = new Date(start);\n  while (current < end) {\n    yield current.toISOString().slice(0, 10);\n    current.setUTCDate(current.getUTCDate() + 1);\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Concurrency helper\n// ---------------------------------------------------------------------------\n\n/** Map over items with bounded concurrency. No external dependencies. */\nasync function pMap<T, R>(\n  items: T[],\n  fn: (item: T) => Promise<R>,\n  concurrency: number,\n): Promise<R[]> {\n  const results: R[] = new Array(items.length);\n  let index = 0;\n  async function next(): Promise<void> {\n    const i = index++;\n    if (i >= items.length) return;\n    results[i] = await fn(items[i]!);\n    return next();\n  }\n  await Promise.all(Array.from({ length: Math.min(concurrency, items.length) }, () => next()));\n  return results;\n}\n\n// ---------------------------------------------------------------------------\n// GitHubCostAdapter\n// ---------------------------------------------------------------------------\n\nexport interface GitHubCostConfig {\n  token?: string;\n  org?: string;\n}\n\nconst BILLING_API_BASE = \"https://api.github.com/orgs\";\n\nexport class GitHubCostAdapter implements CostAdapter {\n  readonly cloud = \"github\";\n  private config: GitHubCostConfig;\n  private client?: GitHubHTTPClient;\n  private cachedServices: string[] | null = null;\n\n  constructor(config: GitHubCostConfig = {}, client?: GitHubHTTPClient) {\n    this.config = config;\n    this.client = client;\n  }\n\n  async isAvailable(): Promise<boolean> {\n    if (!this.config.token || !this.config.org) return false;\n\n    try {\n      const client = this.getClient();\n      if (!client) return false;\n\n      // Check org billing access with today's date\n      const today = new Date().toISOString().slice(0, 10);\n      const { year, month, day } = parseDateParts(today);\n      const url = `${BILLING_API_BASE}/${this.config.org}/settings/billing/usage?year=${year}&month=${month}&day=${day}`;\n\n      const response = await client.get(url, {\n        headers: this.buildHeaders(),\n      });\n\n      return response.status === 200;\n    } catch {\n      return false;\n    }\n  }\n\n  async fetchCosts(options: { startDate: string; endDate: string }): Promise<CostRecord[]> {\n    const client = this.getClient();\n    if (!client) throw new Error(\"GitHub HTTP client not available\");\n\n    const org = this.config.org;\n    if (!org) throw new Error(\"Missing org in GitHub config\");\n\n    const headers = this.buildHeaders();\n    const days = [...eachDay(options.startDate, options.endDate)];\n\n    // Fetch org plan info for seat costs (non-blocking — skip on failure)\n    const orgPlan = await this.fetchOrgPlan(client, org, headers);\n\n    const dayResults = await pMap(\n      days,\n      async (day) => {\n        const { year, month, day: d } = parseDateParts(day);\n        const url = `${BILLING_API_BASE}/${org}/settings/billing/usage?year=${year}&month=${month}&day=${d}`;\n\n        const response = await client.get(url, { headers });\n\n        if (response.status === 403) {\n          const msg = (response.data as Record<string, unknown>)?.message ?? \"\";\n          if (typeof msg === \"string\" && msg.toLowerCase().includes(\"rate limit\")) {\n            throw new Error(`GitHub API rate limit exceeded. Retry after a few minutes.`);\n          }\n          throw new Error(\"Insufficient permissions: requires read:billing scope\");\n        }\n\n        if (response.status === 404) {\n          throw new Error(\"Organization not found or not on Enhanced Billing Platform\");\n        }\n\n        if (response.status !== 200) {\n          throw new Error(`GitHub API error: status ${response.status}`);\n        }\n\n        const items = response.data.usageItems ?? [];\n        const records: CostRecord[] = [];\n        for (const item of items) {\n          const netAmount = item.netAmount ?? item.grossAmount - (item.discountAmount ?? 0);\n\n          const record: CostRecord = {\n            cloud: \"github\",\n            service: normalizeServiceName(item.product),\n            date: day,\n            amount: netAmount,\n            currency: \"USD\",\n          };\n\n          if (item.quantity != null) {\n            record.usage = {\n              value: item.quantity,\n              unit: item.unitType ?? \"units\",\n            };\n          }\n\n          records.push(record);\n        }\n\n        // Add seat cost record for this day\n        if (orgPlan) {\n          const pricePerSeat = planPricePerSeat(orgPlan.planName);\n          if (pricePerSeat > 0 && orgPlan.seats > 0) {\n            const dim = daysInMonth(day);\n            const dailyAmount = (orgPlan.seats * pricePerSeat) / dim;\n            records.push({\n              cloud: \"github\",\n              service: \"seats\",\n              date: day,\n              amount: Math.round(dailyAmount * 1e6) / 1e6, // avoid floating-point noise\n              currency: \"USD\",\n              usage: { value: orgPlan.seats, unit: \"seats\" },\n            });\n          }\n        }\n\n        return records;\n      },\n      5,\n    );\n\n    const records = dayResults.flat();\n    this.cachedServices = [...new Set(records.map((r) => r.service))];\n    return records;\n  }\n\n  /** Fetch org plan info (plan name + seat count). Returns null on failure. */\n  private async fetchOrgPlan(\n    client: GitHubHTTPClient,\n    org: string,\n    headers: Record<string, string>,\n  ): Promise<{ planName: string; seats: number } | null> {\n    try {\n      if (client.getOrgPlan) {\n        const resp = await client.getOrgPlan(`https://api.github.com/orgs/${org}`, { headers });\n        if (resp.status === 200 && resp.data.plan) {\n          return { planName: resp.data.plan.name, seats: resp.data.plan.seats };\n        }\n      }\n    } catch {\n      // Seat cost is best-effort; don't fail the entire fetch\n    }\n    return null;\n  }\n\n  async listServices(): Promise<string[]> {\n    if (this.cachedServices) return this.cachedServices;\n    return [];\n  }\n\n  capabilities(): AdapterCapabilities {\n    return {\n      supportsAmount: true,\n      supportsUsage: true,\n      supportsTags: false,\n      supportsRegion: false,\n      supportsAccount: false,\n      supportsForecast: false,\n    };\n  }\n\n  private getClient(): GitHubHTTPClient | undefined {\n    if (this.client) return this.client;\n    // Create a fetch-based client for production use\n    this.client = {\n      async get(\n        url: string,\n        options: { headers: Record<string, string> },\n      ): Promise<GitHubBillingResponse> {\n        const resp = await fetch(url, {\n          method: \"GET\",\n          headers: options.headers,\n        });\n        const data = (await resp.json()) as GitHubBillingResponse[\"data\"];\n        return { status: resp.status, data };\n      },\n      async getOrgPlan(\n        url: string,\n        options: { headers: Record<string, string> },\n      ): Promise<GitHubOrgPlanResponse> {\n        const resp = await fetch(url, {\n          method: \"GET\",\n          headers: options.headers,\n        });\n        const data = (await resp.json()) as GitHubOrgPlanResponse[\"data\"];\n        return { status: resp.status, data };\n      },\n    };\n    return this.client;\n  }\n\n  private buildHeaders(): Record<string, string> {\n    return {\n      Authorization: `Bearer ${this.config.token}`,\n      Accept: \"application/json\",\n      \"X-GitHub-Api-Version\": \"2022-11-28\",\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/index.cjs

@@ -0,0 +1,101 @@
+const require_adapter = require('./adapter.cjs');
+let _aigne_afs_utils_camelize = require("@aigne/afs/utils/camelize");
+let _aigne_afs_cost_base = require("@aigne/afs-cost-base");
+let zod = require("zod");
+
+//#region src/index.ts
+var AFSGithubCost = class AFSGithubCost extends _aigne_afs_cost_base.AFSCostBaseProvider {
+	cloudName = "github";
+	static schema() {
+		return zod.z.object({
+			token: zod.z.string().optional(),
+			org: zod.z.string().optional(),
+			name: zod.z.string().optional(),
+			description: zod.z.string().optional(),
+			accessMode: zod.z.enum(["readonly", "readwrite"]).optional(),
+			startDate: zod.z.string().optional(),
+			endDate: zod.z.string().optional(),
+			cacheTTL: zod.z.number().optional(),
+			dataDir: zod.z.string().optional()
+		});
+	}
+	static manifest() {
+		return {
+			name: "github-cost",
+			description: "GitHub billing data with by-service and by-date views, including seat costs.",
+			uriTemplate: "github-cost://{label+}",
+			category: "cloud",
+			schema: zod.z.object({ label: zod.z.string().optional() }),
+			tags: [
+				"cost",
+				"billing",
+				"github"
+			],
+			capabilityTags: [
+				"read-write",
+				"search",
+				"auth:token",
+				"remote"
+			],
+			security: {
+				riskLevel: "external",
+				resourceAccess: ["cloud-api", "internet"],
+				dataSensitivity: ["credentials"],
+				requires: ["cloud-credentials"]
+			}
+		};
+	}
+	static treeSchema() {
+		return {
+			operations: [
+				"list",
+				"read",
+				"write",
+				"search",
+				"stat",
+				"explain"
+			],
+			tree: {
+				"/": { kind: "github-cost:root" },
+				"/by-service": { kind: "github-cost:view" },
+				"/by-service/{service}": { kind: "github-cost:service-summary" },
+				"/by-date": { kind: "github-cost:view" },
+				"/by-date/{date}": { kind: "github-cost:date-summary" }
+			},
+			auth: {
+				type: "custom",
+				env: ["GITHUB_TOKEN"]
+			},
+			bestFor: [
+				"cost visibility",
+				"spend tracking",
+				"github billing",
+				"seat costs"
+			],
+			notFor: ["real-time data", "budget alerts"]
+		};
+	}
+	static async load({ basePath, config } = {}) {
+		const camelized = (0, _aigne_afs_utils_camelize.camelize)(config ?? {});
+		return new AFSGithubCost({
+			...await AFSGithubCost.schema().parseAsync(camelized),
+			cwd: basePath
+		});
+	}
+	createAdapter(config) {
+		return new require_adapter.GitHubCostAdapter({
+			token: config.token,
+			org: config.org
+		});
+	}
+};
+
+//#endregion
+exports.AFSGithubCost = AFSGithubCost;
+exports.GitHubCostAdapter = require_adapter.GitHubCostAdapter;
+Object.defineProperty(exports, 'MockCostAdapter', {
+  enumerable: true,
+  get: function () {
+    return _aigne_afs_cost_base.MockCostAdapter;
+  }
+});

package/dist/index.d.cts

@@ -0,0 +1,33 @@
+import { GitHubBillingResponse, GitHubCostAdapter, GitHubCostConfig, GitHubHTTPClient, GitHubOrgPlanResponse, GitHubUsageItem } from "./adapter.cjs";
+import { AFSModuleLoadParams, ProviderManifest, ProviderTreeSchema } from "@aigne/afs";
+import { AFSCostBaseProvider, AdapterCapabilities, CostAdapter, CostAdapter as CostAdapter$1, CostRecord, MockCostAdapter } from "@aigne/afs-cost-base";
+import { z } from "zod";
+
+//#region src/index.d.ts
+declare class AFSGithubCost extends AFSCostBaseProvider {
+  readonly cloudName = "github";
+  static schema(): z.ZodObject<{
+    token: z.ZodOptional<z.ZodString>;
+    org: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    accessMode: z.ZodOptional<z.ZodEnum<{
+      readonly: "readonly";
+      readwrite: "readwrite";
+    }>>;
+    startDate: z.ZodOptional<z.ZodString>;
+    endDate: z.ZodOptional<z.ZodString>;
+    cacheTTL: z.ZodOptional<z.ZodNumber>;
+    dataDir: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>;
+  static manifest(): ProviderManifest;
+  static treeSchema(): ProviderTreeSchema;
+  static load({
+    basePath,
+    config
+  }?: AFSModuleLoadParams): Promise<AFSGithubCost>;
+  protected createAdapter(config: Record<string, unknown>): CostAdapter$1;
+}
+//#endregion
+export { AFSGithubCost, type AdapterCapabilities, type CostAdapter, type CostRecord, type GitHubBillingResponse, GitHubCostAdapter, type GitHubCostConfig, type GitHubHTTPClient, type GitHubOrgPlanResponse, type GitHubUsageItem, MockCostAdapter };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;cA0Ba,aAAA,SAAsB,mBAAA;EAAA,SACxB,SAAA;EAAA,OAEF,MAAA,CAAA,GAAM,CAAA,CAAA,SAAA;;;;;;;;;;;;;;SAcN,QAAA,CAAA,GAAY,gBAAA;EAAA,OAkBZ,UAAA,CAAA,GAAc,kBAAA;EAAA,OAgBR,IAAA,CAAA;IAAO,QAAA;IAAU;EAAA,IAAU,mBAAA,GAAwB,OAAA,CAAA,aAAA;EAAA,UAOtD,aAAA,CAAc,MAAA,EAAQ,MAAA,oBAA0B,aAAA;AAAA"}

package/dist/index.d.mts

@@ -0,0 +1,33 @@
+import { GitHubBillingResponse, GitHubCostAdapter, GitHubCostConfig, GitHubHTTPClient, GitHubOrgPlanResponse, GitHubUsageItem } from "./adapter.mjs";
+import { AFSCostBaseProvider, AdapterCapabilities, CostAdapter, CostAdapter as CostAdapter$1, CostRecord, MockCostAdapter } from "@aigne/afs-cost-base";
+import { z } from "zod";
+import { AFSModuleLoadParams, ProviderManifest, ProviderTreeSchema } from "@aigne/afs";
+
+//#region src/index.d.ts
+declare class AFSGithubCost extends AFSCostBaseProvider {
+  readonly cloudName = "github";
+  static schema(): z.ZodObject<{
+    token: z.ZodOptional<z.ZodString>;
+    org: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    accessMode: z.ZodOptional<z.ZodEnum<{
+      readonly: "readonly";
+      readwrite: "readwrite";
+    }>>;
+    startDate: z.ZodOptional<z.ZodString>;
+    endDate: z.ZodOptional<z.ZodString>;
+    cacheTTL: z.ZodOptional<z.ZodNumber>;
+    dataDir: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>;
+  static manifest(): ProviderManifest;
+  static treeSchema(): ProviderTreeSchema;
+  static load({
+    basePath,
+    config
+  }?: AFSModuleLoadParams): Promise<AFSGithubCost>;
+  protected createAdapter(config: Record<string, unknown>): CostAdapter$1;
+}
+//#endregion
+export { AFSGithubCost, type AdapterCapabilities, type CostAdapter, type CostRecord, type GitHubBillingResponse, GitHubCostAdapter, type GitHubCostConfig, type GitHubHTTPClient, type GitHubOrgPlanResponse, type GitHubUsageItem, MockCostAdapter };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;cA0Ba,aAAA,SAAsB,mBAAA;EAAA,SACxB,SAAA;EAAA,OAEF,MAAA,CAAA,GAAM,CAAA,CAAA,SAAA;;;;;;;;;;;;;;SAcN,QAAA,CAAA,GAAY,gBAAA;EAAA,OAkBZ,UAAA,CAAA,GAAc,kBAAA;EAAA,OAgBR,IAAA,CAAA;IAAO,QAAA;IAAU;EAAA,IAAU,mBAAA,GAAwB,OAAA,CAAA,aAAA;EAAA,UAOtD,aAAA,CAAc,MAAA,EAAQ,MAAA,oBAA0B,aAAA;AAAA"}

package/dist/index.mjs

@@ -0,0 +1,95 @@
+import { GitHubCostAdapter } from "./adapter.mjs";
+import { camelize } from "@aigne/afs/utils/camelize";
+import { AFSCostBaseProvider, MockCostAdapter } from "@aigne/afs-cost-base";
+import { z } from "zod";
+
+//#region src/index.ts
+var AFSGithubCost = class AFSGithubCost extends AFSCostBaseProvider {
+	cloudName = "github";
+	static schema() {
+		return z.object({
+			token: z.string().optional(),
+			org: z.string().optional(),
+			name: z.string().optional(),
+			description: z.string().optional(),
+			accessMode: z.enum(["readonly", "readwrite"]).optional(),
+			startDate: z.string().optional(),
+			endDate: z.string().optional(),
+			cacheTTL: z.number().optional(),
+			dataDir: z.string().optional()
+		});
+	}
+	static manifest() {
+		return {
+			name: "github-cost",
+			description: "GitHub billing data with by-service and by-date views, including seat costs.",
+			uriTemplate: "github-cost://{label+}",
+			category: "cloud",
+			schema: z.object({ label: z.string().optional() }),
+			tags: [
+				"cost",
+				"billing",
+				"github"
+			],
+			capabilityTags: [
+				"read-write",
+				"search",
+				"auth:token",
+				"remote"
+			],
+			security: {
+				riskLevel: "external",
+				resourceAccess: ["cloud-api", "internet"],
+				dataSensitivity: ["credentials"],
+				requires: ["cloud-credentials"]
+			}
+		};
+	}
+	static treeSchema() {
+		return {
+			operations: [
+				"list",
+				"read",
+				"write",
+				"search",
+				"stat",
+				"explain"
+			],
+			tree: {
+				"/": { kind: "github-cost:root" },
+				"/by-service": { kind: "github-cost:view" },
+				"/by-service/{service}": { kind: "github-cost:service-summary" },
+				"/by-date": { kind: "github-cost:view" },
+				"/by-date/{date}": { kind: "github-cost:date-summary" }
+			},
+			auth: {
+				type: "custom",
+				env: ["GITHUB_TOKEN"]
+			},
+			bestFor: [
+				"cost visibility",
+				"spend tracking",
+				"github billing",
+				"seat costs"
+			],
+			notFor: ["real-time data", "budget alerts"]
+		};
+	}
+	static async load({ basePath, config } = {}) {
+		const camelized = camelize(config ?? {});
+		return new AFSGithubCost({
+			...await AFSGithubCost.schema().parseAsync(camelized),
+			cwd: basePath
+		});
+	}
+	createAdapter(config) {
+		return new GitHubCostAdapter({
+			token: config.token,
+			org: config.org
+		});
+	}
+};
+
+//#endregion
+export { AFSGithubCost, GitHubCostAdapter, MockCostAdapter };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type { AFSModuleLoadParams, ProviderManifest, ProviderTreeSchema } from \"@aigne/afs\";\nimport { camelize } from \"@aigne/afs/utils/camelize\";\nimport {\n  type AFSCostBaseOptions,\n  AFSCostBaseProvider,\n  type CostAdapter,\n} from \"@aigne/afs-cost-base\";\nimport { z } from \"zod\";\n\nimport { GitHubCostAdapter, type GitHubCostConfig } from \"./adapter.js\";\n\nexport type { AdapterCapabilities, CostAdapter, CostRecord } from \"@aigne/afs-cost-base\";\nexport { MockCostAdapter } from \"@aigne/afs-cost-base\";\nexport type {\n  GitHubBillingResponse,\n  GitHubCostConfig,\n  GitHubHTTPClient,\n  GitHubOrgPlanResponse,\n  GitHubUsageItem,\n} from \"./adapter.js\";\nexport { GitHubCostAdapter } from \"./adapter.js\";\n\n// =============================================================================\n// AFSGithubCost Provider\n// =============================================================================\n\nexport class AFSGithubCost extends AFSCostBaseProvider {\n  readonly cloudName = \"github\";\n\n  static schema() {\n    return z.object({\n      token: z.string().optional(),\n      org: z.string().optional(),\n      name: z.string().optional(),\n      description: z.string().optional(),\n      accessMode: z.enum([\"readonly\", \"readwrite\"]).optional(),\n      startDate: z.string().optional(),\n      endDate: z.string().optional(),\n      cacheTTL: z.number().optional(),\n      dataDir: z.string().optional(),\n    });\n  }\n\n  static manifest(): ProviderManifest {\n    return {\n      name: \"github-cost\",\n      description: \"GitHub billing data with by-service and by-date views, including seat costs.\",\n      uriTemplate: \"github-cost://{label+}\",\n      category: \"cloud\",\n      schema: z.object({ label: z.string().optional() }),\n      tags: [\"cost\", \"billing\", \"github\"],\n      capabilityTags: [\"read-write\", \"search\", \"auth:token\", \"remote\"],\n      security: {\n        riskLevel: \"external\",\n        resourceAccess: [\"cloud-api\", \"internet\"],\n        dataSensitivity: [\"credentials\"],\n        requires: [\"cloud-credentials\"],\n      },\n    };\n  }\n\n  static treeSchema(): ProviderTreeSchema {\n    return {\n      operations: [\"list\", \"read\", \"write\", \"search\", \"stat\", \"explain\"],\n      tree: {\n        \"/\": { kind: \"github-cost:root\" },\n        \"/by-service\": { kind: \"github-cost:view\" },\n        \"/by-service/{service}\": { kind: \"github-cost:service-summary\" },\n        \"/by-date\": { kind: \"github-cost:view\" },\n        \"/by-date/{date}\": { kind: \"github-cost:date-summary\" },\n      },\n      auth: { type: \"custom\", env: [\"GITHUB_TOKEN\"] },\n      bestFor: [\"cost visibility\", \"spend tracking\", \"github billing\", \"seat costs\"],\n      notFor: [\"real-time data\", \"budget alerts\"],\n    };\n  }\n\n  static async load({ basePath, config }: AFSModuleLoadParams = {}) {\n    const camelized = camelize(config ?? {});\n    const valid = await AFSGithubCost.schema().parseAsync(camelized);\n    return new AFSGithubCost({ ...valid, cwd: basePath } as AFSCostBaseOptions &\n      Record<string, unknown>);\n  }\n\n  protected createAdapter(config: Record<string, unknown>): CostAdapter {\n    const adapterConfig: GitHubCostConfig = {\n      token: config.token as string | undefined,\n      org: config.org as string | undefined,\n    };\n    return new GitHubCostAdapter(adapterConfig);\n  }\n}\n"],"mappings":";;;;;;AA0BA,IAAa,gBAAb,MAAa,sBAAsB,oBAAoB;CACrD,AAAS,YAAY;CAErB,OAAO,SAAS;AACd,SAAO,EAAE,OAAO;GACd,OAAO,EAAE,QAAQ,CAAC,UAAU;GAC5B,KAAK,EAAE,QAAQ,CAAC,UAAU;GAC1B,MAAM,EAAE,QAAQ,CAAC,UAAU;GAC3B,aAAa,EAAE,QAAQ,CAAC,UAAU;GAClC,YAAY,EAAE,KAAK,CAAC,YAAY,YAAY,CAAC,CAAC,UAAU;GACxD,WAAW,EAAE,QAAQ,CAAC,UAAU;GAChC,SAAS,EAAE,QAAQ,CAAC,UAAU;GAC9B,UAAU,EAAE,QAAQ,CAAC,UAAU;GAC/B,SAAS,EAAE,QAAQ,CAAC,UAAU;GAC/B,CAAC;;CAGJ,OAAO,WAA6B;AAClC,SAAO;GACL,MAAM;GACN,aAAa;GACb,aAAa;GACb,UAAU;GACV,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC;GAClD,MAAM;IAAC;IAAQ;IAAW;IAAS;GACnC,gBAAgB;IAAC;IAAc;IAAU;IAAc;IAAS;GAChE,UAAU;IACR,WAAW;IACX,gBAAgB,CAAC,aAAa,WAAW;IACzC,iBAAiB,CAAC,cAAc;IAChC,UAAU,CAAC,oBAAoB;IAChC;GACF;;CAGH,OAAO,aAAiC;AACtC,SAAO;GACL,YAAY;IAAC;IAAQ;IAAQ;IAAS;IAAU;IAAQ;IAAU;GAClE,MAAM;IACJ,KAAK,EAAE,MAAM,oBAAoB;IACjC,eAAe,EAAE,MAAM,oBAAoB;IAC3C,yBAAyB,EAAE,MAAM,+BAA+B;IAChE,YAAY,EAAE,MAAM,oBAAoB;IACxC,mBAAmB,EAAE,MAAM,4BAA4B;IACxD;GACD,MAAM;IAAE,MAAM;IAAU,KAAK,CAAC,eAAe;IAAE;GAC/C,SAAS;IAAC;IAAmB;IAAkB;IAAkB;IAAa;GAC9E,QAAQ,CAAC,kBAAkB,gBAAgB;GAC5C;;CAGH,aAAa,KAAK,EAAE,UAAU,WAAgC,EAAE,EAAE;EAChE,MAAM,YAAY,SAAS,UAAU,EAAE,CAAC;AAExC,SAAO,IAAI,cAAc;GAAE,GADb,MAAM,cAAc,QAAQ,CAAC,WAAW,UAAU;GAC3B,KAAK;GAAU,CAC1B;;CAG5B,AAAU,cAAc,QAA8C;AAKpE,SAAO,IAAI,kBAJ6B;GACtC,OAAO,OAAO;GACd,KAAK,OAAO;GACb,CAC0C"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@aigne/afs-github-cost",
+  "version": "1.11.0-beta.12",
+  "description": "AIGNE AFS provider for GitHub billing data with seat costs",
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "Arcblock <blocklet@arcblock.io> https://github.com/arcblock",
+  "homepage": "https://github.com/arcblock/afs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/arcblock/afs"
+  },
+  "bugs": {
+    "url": "https://github.com/arcblock/afs/issues"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.cts",
+  "exports": {
+    ".": {
+      "require": "./dist/index.cjs",
+      "import": "./dist/index.mjs"
+    },
+    "./*": "./*"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "dependencies": {
+    "ufo": "^1.6.3",
+    "zod": "^4.0.0",
+    "@aigne/afs": "^1.11.0-beta.12",
+    "@aigne/afs-cost-base": "^1.11.0-beta.12"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "npm-run-all": "^4.1.5",
+    "rimraf": "^6.1.2",
+    "tsdown": "0.20.0-beta.3",
+    "typescript": "5.9.2",
+    "@aigne/afs-testing": "1.11.0-beta.12",
+    "@aigne/scripts": "0.0.0",
+    "@aigne/typescript-config": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "check-types": "tsc --noEmit",
+    "clean": "rimraf dist coverage",
+    "test": "bun test",
+    "test:coverage": "bun test --coverage --coverage-reporter=lcov --coverage-reporter=text"
+  }
+}