@aigne/afs-aws-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/_virtual/rolldown_runtime.mjs

@@ -0,0 +1,7 @@
+import { createRequire } from "node:module";
+
+//#region rolldown:runtime
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+
+//#endregion
+export { __require };

package/dist/adapter.cjs

@@ -0,0 +1,158 @@
+
+//#region src/adapter.ts
+const SERVICE_NAME_MAP = {
+	"Amazon Elastic Compute Cloud - Compute": "ec2",
+	"Amazon Elastic Compute Cloud": "ec2",
+	"Amazon Simple Storage Service": "s3",
+	"AWS Lambda": "lambda",
+	"Amazon Relational Database Service": "rds",
+	"Amazon DynamoDB": "dynamodb",
+	"Amazon CloudFront": "cloudfront",
+	"Amazon Elastic Container Service": "ecs",
+	"Amazon Elastic Kubernetes Service": "eks",
+	"Amazon ElastiCache": "elasticache",
+	"Amazon Elastic Load Balancing": "elb",
+	"Amazon Route 53": "route53",
+	"Amazon Simple Notification Service": "sns",
+	"Amazon Simple Queue Service": "sqs",
+	"Amazon CloudWatch": "cloudwatch",
+	"AWS Key Management Service": "kms",
+	"Amazon Kinesis": "kinesis",
+	"Amazon Redshift": "redshift",
+	"AWS CodeBuild": "codebuild",
+	"Amazon API Gateway": "api-gateway",
+	"AWS Secrets Manager": "secrets-manager",
+	"Amazon Elastic File System": "efs",
+	"AWS Step Functions": "step-functions",
+	"AWS Fargate": "fargate",
+	"Amazon SageMaker": "sagemaker",
+	Tax: "tax"
+};
+function normalizeServiceName(awsName) {
+	if (!awsName) return "unknown";
+	if (SERVICE_NAME_MAP[awsName]) return SERVICE_NAME_MAP[awsName];
+	return awsName.replace(/^(Amazon|AWS)\s+/i, "").replace(/\s*-\s*/g, "-").replace(/\s+/g, "-").toLowerCase();
+}
+var AWSCostAdapter = class {
+	cloud = "aws";
+	config;
+	client;
+	commandClass;
+	cachedServices = null;
+	constructor(config = {}, client) {
+		this.config = config;
+		this.client = client;
+	}
+	async isAvailable() {
+		try {
+			const client = this.getClient();
+			if (!client) return false;
+			await client.send(this.buildCommand({
+				startDate: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
+				endDate: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10)
+			}));
+			return true;
+		} catch {
+			return false;
+		}
+	}
+	async fetchCosts(options) {
+		const client = this.getClient();
+		if (!client) throw new Error("AWS Cost Explorer client not available");
+		const records = [];
+		let nextToken;
+		do {
+			const command = this.buildCommand(options, nextToken);
+			const response = await client.send(command);
+			if (response.ResultsByTime) for (const period of response.ResultsByTime) {
+				const date = period.TimePeriod?.Start ?? options.startDate;
+				if (period.Groups) for (const group of period.Groups) {
+					const serviceName = group.Keys?.[0] ?? "";
+					const metrics = group.Metrics ?? {};
+					records.push(this.parseRecord(date, serviceName, metrics));
+				}
+				else if (period.Total) records.push(this.parseRecord(date, "total", period.Total));
+			}
+			nextToken = response.NextPageToken;
+		} while (nextToken);
+		this.cachedServices = [...new Set(records.map((r) => r.service))];
+		return records;
+	}
+	async listServices() {
+		if (this.cachedServices) return this.cachedServices;
+		const end = /* @__PURE__ */ new Date();
+		const start = /* @__PURE__ */ new Date();
+		start.setDate(start.getDate() - 30);
+		const records = await this.fetchCosts({
+			startDate: start.toISOString().slice(0, 10),
+			endDate: end.toISOString().slice(0, 10)
+		});
+		return [...new Set(records.map((r) => r.service))];
+	}
+	capabilities() {
+		return {
+			supportsAmount: true,
+			supportsUsage: true,
+			supportsTags: true,
+			supportsRegion: true,
+			supportsAccount: true,
+			supportsForecast: false
+		};
+	}
+	getClient() {
+		if (this.client) return this.client;
+		try {
+			const sdk = require("@aws-sdk/client-cost-explorer");
+			const clientConfig = {};
+			if (this.config.region) clientConfig.region = this.config.region;
+			if (this.config.accessKeyId && this.config.secretAccessKey) clientConfig.credentials = {
+				accessKeyId: this.config.accessKeyId,
+				secretAccessKey: this.config.secretAccessKey
+			};
+			this.client = new sdk.CostExplorerClient(clientConfig);
+			this.commandClass = sdk.GetCostAndUsageCommand;
+			return this.client;
+		} catch {
+			return;
+		}
+	}
+	buildCommand(options, nextPageToken) {
+		const input = {
+			TimePeriod: {
+				Start: options.startDate,
+				End: options.endDate
+			},
+			Granularity: "DAILY",
+			Metrics: ["UnblendedCost", "UsageQuantity"],
+			GroupBy: [{
+				Type: "DIMENSION",
+				Key: "SERVICE"
+			}],
+			...nextPageToken ? { NextPageToken: nextPageToken } : {}
+		};
+		return this.commandClass ? new this.commandClass(input) : input;
+	}
+	parseRecord(date, rawServiceName, metrics) {
+		const cost = metrics.UnblendedCost;
+		const usage = metrics.UsageQuantity;
+		const amount = cost?.Amount ? Number.parseFloat(cost.Amount) : 0;
+		const currency = cost?.Unit ?? "USD";
+		const usageValue = usage?.Amount ? Number.parseFloat(usage.Amount) : void 0;
+		const usageUnit = usage?.Unit ?? "N/A";
+		const record = {
+			cloud: "aws",
+			service: normalizeServiceName(rawServiceName),
+			date,
+			amount,
+			currency
+		};
+		if (usageValue !== void 0) record.usage = {
+			value: usageValue,
+			unit: usageUnit
+		};
+		return record;
+	}
+};
+
+//#endregion
+exports.AWSCostAdapter = AWSCostAdapter;

package/dist/adapter.d.cts

@@ -0,0 +1,55 @@
+import { AdapterCapabilities, CostAdapter, CostRecord } from "@aigne/afs-cost-base";
+
+//#region src/adapter.d.ts
+/** Minimal Cost Explorer client interface for dependency injection */
+interface CostExplorerClient {
+  send(command: unknown): Promise<GetCostAndUsageResponse>;
+}
+interface GetCostAndUsageResponse {
+  ResultsByTime?: ResultByTime[];
+  NextPageToken?: string;
+}
+interface ResultByTime {
+  TimePeriod?: {
+    Start?: string;
+    End?: string;
+  };
+  Groups?: Group[];
+  Total?: MetricValues;
+}
+interface Group {
+  Keys?: string[];
+  Metrics?: MetricValues;
+}
+interface MetricValues {
+  [key: string]: {
+    Amount?: string;
+    Unit?: string;
+  };
+}
+interface AWSCostConfig {
+  accessKeyId?: string;
+  secretAccessKey?: string;
+  region?: string;
+}
+declare class AWSCostAdapter implements CostAdapter {
+  readonly cloud = "aws";
+  private config;
+  private client?;
+  private commandClass?;
+  private cachedServices;
+  constructor(config?: AWSCostConfig, client?: CostExplorerClient);
+  isAvailable(): Promise<boolean>;
+  fetchCosts(options: {
+    startDate: string;
+    endDate: string;
+  }): Promise<CostRecord[]>;
+  listServices(): Promise<string[]>;
+  capabilities(): AdapterCapabilities;
+  private getClient;
+  private buildCommand;
+  private parseRecord;
+}
+//#endregion
+export { AWSCostAdapter, AWSCostConfig, CostExplorerClient, GetCostAndUsageResponse };
+//# 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,kBAAA;EACf,IAAA,CAAK,OAAA,YAAmB,OAAA,CAAQ,uBAAA;AAAA;AAAA,UAGjB,uBAAA;EACf,aAAA,GAAgB,YAAA;EAChB,aAAA;AAAA;AAAA,UAGQ,YAAA;EACR,UAAA;IAAe,KAAA;IAAgB,GAAA;EAAA;EAC/B,MAAA,GAAS,KAAA;EACT,KAAA,GAAQ,YAAA;AAAA;AAAA,UAGA,KAAA;EACR,IAAA;EACA,OAAA,GAAU,YAAA;AAAA;AAAA,UAGF,YAAA;EAAA,CACP,GAAA;IAAgB,MAAA;IAAiB,IAAA;EAAA;AAAA;AAAA,UAmDnB,aAAA;EACf,WAAA;EACA,eAAA;EACA,MAAA;AAAA;AAAA,cAGW,cAAA,YAA0B,WAAA;EAAA,SAC5B,KAAA;EAAA,QACD,MAAA;EAAA,QACA,MAAA;EAAA,QACA,YAAA;EAAA,QAGA,cAAA;cAEI,MAAA,GAAQ,aAAA,EAAoB,MAAA,GAAS,kBAAA;EAK3C,WAAA,CAAA,GAAe,OAAA;EAiBf,UAAA,CAAW,OAAA;IAAW,SAAA;IAAmB,OAAA;EAAA,IAAoB,OAAA,CAAQ,UAAA;EAmCrE,YAAA,CAAA,GAAgB,OAAA;EAatB,YAAA,CAAA,GAAgB,mBAAA;EAAA,QAWR,SAAA;EAAA,QAsBA,YAAA;EAAA,QAgBA,WAAA;AAAA"}

package/dist/adapter.d.mts

@@ -0,0 +1,55 @@
+import { AdapterCapabilities, CostAdapter, CostRecord } from "@aigne/afs-cost-base";
+
+//#region src/adapter.d.ts
+/** Minimal Cost Explorer client interface for dependency injection */
+interface CostExplorerClient {
+  send(command: unknown): Promise<GetCostAndUsageResponse>;
+}
+interface GetCostAndUsageResponse {
+  ResultsByTime?: ResultByTime[];
+  NextPageToken?: string;
+}
+interface ResultByTime {
+  TimePeriod?: {
+    Start?: string;
+    End?: string;
+  };
+  Groups?: Group[];
+  Total?: MetricValues;
+}
+interface Group {
+  Keys?: string[];
+  Metrics?: MetricValues;
+}
+interface MetricValues {
+  [key: string]: {
+    Amount?: string;
+    Unit?: string;
+  };
+}
+interface AWSCostConfig {
+  accessKeyId?: string;
+  secretAccessKey?: string;
+  region?: string;
+}
+declare class AWSCostAdapter implements CostAdapter {
+  readonly cloud = "aws";
+  private config;
+  private client?;
+  private commandClass?;
+  private cachedServices;
+  constructor(config?: AWSCostConfig, client?: CostExplorerClient);
+  isAvailable(): Promise<boolean>;
+  fetchCosts(options: {
+    startDate: string;
+    endDate: string;
+  }): Promise<CostRecord[]>;
+  listServices(): Promise<string[]>;
+  capabilities(): AdapterCapabilities;
+  private getClient;
+  private buildCommand;
+  private parseRecord;
+}
+//#endregion
+export { AWSCostAdapter, AWSCostConfig, CostExplorerClient, GetCostAndUsageResponse };
+//# 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,kBAAA;EACf,IAAA,CAAK,OAAA,YAAmB,OAAA,CAAQ,uBAAA;AAAA;AAAA,UAGjB,uBAAA;EACf,aAAA,GAAgB,YAAA;EAChB,aAAA;AAAA;AAAA,UAGQ,YAAA;EACR,UAAA;IAAe,KAAA;IAAgB,GAAA;EAAA;EAC/B,MAAA,GAAS,KAAA;EACT,KAAA,GAAQ,YAAA;AAAA;AAAA,UAGA,KAAA;EACR,IAAA;EACA,OAAA,GAAU,YAAA;AAAA;AAAA,UAGF,YAAA;EAAA,CACP,GAAA;IAAgB,MAAA;IAAiB,IAAA;EAAA;AAAA;AAAA,UAmDnB,aAAA;EACf,WAAA;EACA,eAAA;EACA,MAAA;AAAA;AAAA,cAGW,cAAA,YAA0B,WAAA;EAAA,SAC5B,KAAA;EAAA,QACD,MAAA;EAAA,QACA,MAAA;EAAA,QACA,YAAA;EAAA,QAGA,cAAA;cAEI,MAAA,GAAQ,aAAA,EAAoB,MAAA,GAAS,kBAAA;EAK3C,WAAA,CAAA,GAAe,OAAA;EAiBf,UAAA,CAAW,OAAA;IAAW,SAAA;IAAmB,OAAA;EAAA,IAAoB,OAAA,CAAQ,UAAA;EAmCrE,YAAA,CAAA,GAAgB,OAAA;EAatB,YAAA,CAAA,GAAgB,mBAAA;EAAA,QAWR,SAAA;EAAA,QAsBA,YAAA;EAAA,QAgBA,WAAA;AAAA"}

package/dist/adapter.mjs

@@ -0,0 +1,160 @@
+import { __require } from "./_virtual/rolldown_runtime.mjs";
+
+//#region src/adapter.ts
+const SERVICE_NAME_MAP = {
+	"Amazon Elastic Compute Cloud - Compute": "ec2",
+	"Amazon Elastic Compute Cloud": "ec2",
+	"Amazon Simple Storage Service": "s3",
+	"AWS Lambda": "lambda",
+	"Amazon Relational Database Service": "rds",
+	"Amazon DynamoDB": "dynamodb",
+	"Amazon CloudFront": "cloudfront",
+	"Amazon Elastic Container Service": "ecs",
+	"Amazon Elastic Kubernetes Service": "eks",
+	"Amazon ElastiCache": "elasticache",
+	"Amazon Elastic Load Balancing": "elb",
+	"Amazon Route 53": "route53",
+	"Amazon Simple Notification Service": "sns",
+	"Amazon Simple Queue Service": "sqs",
+	"Amazon CloudWatch": "cloudwatch",
+	"AWS Key Management Service": "kms",
+	"Amazon Kinesis": "kinesis",
+	"Amazon Redshift": "redshift",
+	"AWS CodeBuild": "codebuild",
+	"Amazon API Gateway": "api-gateway",
+	"AWS Secrets Manager": "secrets-manager",
+	"Amazon Elastic File System": "efs",
+	"AWS Step Functions": "step-functions",
+	"AWS Fargate": "fargate",
+	"Amazon SageMaker": "sagemaker",
+	Tax: "tax"
+};
+function normalizeServiceName(awsName) {
+	if (!awsName) return "unknown";
+	if (SERVICE_NAME_MAP[awsName]) return SERVICE_NAME_MAP[awsName];
+	return awsName.replace(/^(Amazon|AWS)\s+/i, "").replace(/\s*-\s*/g, "-").replace(/\s+/g, "-").toLowerCase();
+}
+var AWSCostAdapter = class {
+	cloud = "aws";
+	config;
+	client;
+	commandClass;
+	cachedServices = null;
+	constructor(config = {}, client) {
+		this.config = config;
+		this.client = client;
+	}
+	async isAvailable() {
+		try {
+			const client = this.getClient();
+			if (!client) return false;
+			await client.send(this.buildCommand({
+				startDate: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
+				endDate: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10)
+			}));
+			return true;
+		} catch {
+			return false;
+		}
+	}
+	async fetchCosts(options) {
+		const client = this.getClient();
+		if (!client) throw new Error("AWS Cost Explorer client not available");
+		const records = [];
+		let nextToken;
+		do {
+			const command = this.buildCommand(options, nextToken);
+			const response = await client.send(command);
+			if (response.ResultsByTime) for (const period of response.ResultsByTime) {
+				const date = period.TimePeriod?.Start ?? options.startDate;
+				if (period.Groups) for (const group of period.Groups) {
+					const serviceName = group.Keys?.[0] ?? "";
+					const metrics = group.Metrics ?? {};
+					records.push(this.parseRecord(date, serviceName, metrics));
+				}
+				else if (period.Total) records.push(this.parseRecord(date, "total", period.Total));
+			}
+			nextToken = response.NextPageToken;
+		} while (nextToken);
+		this.cachedServices = [...new Set(records.map((r) => r.service))];
+		return records;
+	}
+	async listServices() {
+		if (this.cachedServices) return this.cachedServices;
+		const end = /* @__PURE__ */ new Date();
+		const start = /* @__PURE__ */ new Date();
+		start.setDate(start.getDate() - 30);
+		const records = await this.fetchCosts({
+			startDate: start.toISOString().slice(0, 10),
+			endDate: end.toISOString().slice(0, 10)
+		});
+		return [...new Set(records.map((r) => r.service))];
+	}
+	capabilities() {
+		return {
+			supportsAmount: true,
+			supportsUsage: true,
+			supportsTags: true,
+			supportsRegion: true,
+			supportsAccount: true,
+			supportsForecast: false
+		};
+	}
+	getClient() {
+		if (this.client) return this.client;
+		try {
+			const sdk = __require("@aws-sdk/client-cost-explorer");
+			const clientConfig = {};
+			if (this.config.region) clientConfig.region = this.config.region;
+			if (this.config.accessKeyId && this.config.secretAccessKey) clientConfig.credentials = {
+				accessKeyId: this.config.accessKeyId,
+				secretAccessKey: this.config.secretAccessKey
+			};
+			this.client = new sdk.CostExplorerClient(clientConfig);
+			this.commandClass = sdk.GetCostAndUsageCommand;
+			return this.client;
+		} catch {
+			return;
+		}
+	}
+	buildCommand(options, nextPageToken) {
+		const input = {
+			TimePeriod: {
+				Start: options.startDate,
+				End: options.endDate
+			},
+			Granularity: "DAILY",
+			Metrics: ["UnblendedCost", "UsageQuantity"],
+			GroupBy: [{
+				Type: "DIMENSION",
+				Key: "SERVICE"
+			}],
+			...nextPageToken ? { NextPageToken: nextPageToken } : {}
+		};
+		return this.commandClass ? new this.commandClass(input) : input;
+	}
+	parseRecord(date, rawServiceName, metrics) {
+		const cost = metrics.UnblendedCost;
+		const usage = metrics.UsageQuantity;
+		const amount = cost?.Amount ? Number.parseFloat(cost.Amount) : 0;
+		const currency = cost?.Unit ?? "USD";
+		const usageValue = usage?.Amount ? Number.parseFloat(usage.Amount) : void 0;
+		const usageUnit = usage?.Unit ?? "N/A";
+		const record = {
+			cloud: "aws",
+			service: normalizeServiceName(rawServiceName),
+			date,
+			amount,
+			currency
+		};
+		if (usageValue !== void 0) record.usage = {
+			value: usageValue,
+			unit: usageUnit
+		};
+		return record;
+	}
+};
+
+//#endregion
+export { AWSCostAdapter };
+//# sourceMappingURL=adapter.mjs.map

package/dist/adapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.mjs","names":[],"sources":["../src/adapter.ts"],"sourcesContent":["import type { AdapterCapabilities, CostAdapter, CostRecord } from \"@aigne/afs-cost-base\";\n\n// ---------------------------------------------------------------------------\n// AWS SDK types (minimal subset to avoid hard dependency)\n// ---------------------------------------------------------------------------\n\n/** Minimal Cost Explorer client interface for dependency injection */\nexport interface CostExplorerClient {\n  send(command: unknown): Promise<GetCostAndUsageResponse>;\n}\n\nexport interface GetCostAndUsageResponse {\n  ResultsByTime?: ResultByTime[];\n  NextPageToken?: string;\n}\n\ninterface ResultByTime {\n  TimePeriod?: { Start?: string; End?: string };\n  Groups?: Group[];\n  Total?: MetricValues;\n}\n\ninterface Group {\n  Keys?: string[];\n  Metrics?: MetricValues;\n}\n\ninterface MetricValues {\n  [key: string]: { Amount?: string; Unit?: string };\n}\n\n// ---------------------------------------------------------------------------\n// Service name normalization\n// ---------------------------------------------------------------------------\n\nconst SERVICE_NAME_MAP: Record<string, string> = {\n  \"Amazon Elastic Compute Cloud - Compute\": \"ec2\",\n  \"Amazon Elastic Compute Cloud\": \"ec2\",\n  \"Amazon Simple Storage Service\": \"s3\",\n  \"AWS Lambda\": \"lambda\",\n  \"Amazon Relational Database Service\": \"rds\",\n  \"Amazon DynamoDB\": \"dynamodb\",\n  \"Amazon CloudFront\": \"cloudfront\",\n  \"Amazon Elastic Container Service\": \"ecs\",\n  \"Amazon Elastic Kubernetes Service\": \"eks\",\n  \"Amazon ElastiCache\": \"elasticache\",\n  \"Amazon Elastic Load Balancing\": \"elb\",\n  \"Amazon Route 53\": \"route53\",\n  \"Amazon Simple Notification Service\": \"sns\",\n  \"Amazon Simple Queue Service\": \"sqs\",\n  \"Amazon CloudWatch\": \"cloudwatch\",\n  \"AWS Key Management Service\": \"kms\",\n  \"Amazon Kinesis\": \"kinesis\",\n  \"Amazon Redshift\": \"redshift\",\n  \"AWS CodeBuild\": \"codebuild\",\n  \"Amazon API Gateway\": \"api-gateway\",\n  \"AWS Secrets Manager\": \"secrets-manager\",\n  \"Amazon Elastic File System\": \"efs\",\n  \"AWS Step Functions\": \"step-functions\",\n  \"AWS Fargate\": \"fargate\",\n  \"Amazon SageMaker\": \"sagemaker\",\n  Tax: \"tax\",\n};\n\nfunction normalizeServiceName(awsName: string): string {\n  if (!awsName) return \"unknown\";\n  if (SERVICE_NAME_MAP[awsName]) return SERVICE_NAME_MAP[awsName];\n  // Fallback: kebab-case the full name\n  return awsName\n    .replace(/^(Amazon|AWS)\\s+/i, \"\")\n    .replace(/\\s*-\\s*/g, \"-\")\n    .replace(/\\s+/g, \"-\")\n    .toLowerCase();\n}\n\n// ---------------------------------------------------------------------------\n// AWSCostAdapter\n// ---------------------------------------------------------------------------\n\nexport interface AWSCostConfig {\n  accessKeyId?: string;\n  secretAccessKey?: string;\n  region?: string;\n}\n\nexport class AWSCostAdapter implements CostAdapter {\n  readonly cloud = \"aws\";\n  private config: AWSCostConfig;\n  private client?: CostExplorerClient;\n  private commandClass?: new (\n    input: unknown,\n  ) => unknown;\n  private cachedServices: string[] | null = null;\n\n  constructor(config: AWSCostConfig = {}, client?: CostExplorerClient) {\n    this.config = config;\n    this.client = client;\n  }\n\n  async isAvailable(): Promise<boolean> {\n    try {\n      const client = this.getClient();\n      if (!client) return false;\n      // Try a lightweight API call to check credentials\n      await client.send(\n        this.buildCommand({\n          startDate: new Date().toISOString().slice(0, 10),\n          endDate: new Date().toISOString().slice(0, 10),\n        }),\n      );\n      return true;\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(\"AWS Cost Explorer client not available\");\n\n    const records: CostRecord[] = [];\n    let nextToken: string | undefined;\n\n    do {\n      const command = this.buildCommand(options, nextToken);\n      const response = await client.send(command);\n\n      if (response.ResultsByTime) {\n        for (const period of response.ResultsByTime) {\n          const date = period.TimePeriod?.Start ?? options.startDate;\n\n          if (period.Groups) {\n            for (const group of period.Groups) {\n              const serviceName = group.Keys?.[0] ?? \"\";\n              const metrics = group.Metrics ?? {};\n              records.push(this.parseRecord(date, serviceName, metrics));\n            }\n          } else if (period.Total) {\n            // Ungrouped response — single total per time period\n            records.push(this.parseRecord(date, \"total\", period.Total));\n          }\n        }\n      }\n\n      nextToken = response.NextPageToken;\n    } while (nextToken);\n\n    this.cachedServices = [...new Set(records.map((r) => r.service))];\n    return records;\n  }\n\n  async listServices(): Promise<string[]> {\n    if (this.cachedServices) return this.cachedServices;\n    // If no cached data, do a fetch for last 30 days\n    const end = new Date();\n    const start = new Date();\n    start.setDate(start.getDate() - 30);\n    const records = await this.fetchCosts({\n      startDate: start.toISOString().slice(0, 10),\n      endDate: end.toISOString().slice(0, 10),\n    });\n    return [...new Set(records.map((r) => r.service))];\n  }\n\n  capabilities(): AdapterCapabilities {\n    return {\n      supportsAmount: true,\n      supportsUsage: true,\n      supportsTags: true,\n      supportsRegion: true,\n      supportsAccount: true,\n      supportsForecast: false,\n    };\n  }\n\n  private getClient(): CostExplorerClient | undefined {\n    if (this.client) return this.client;\n\n    try {\n      // @aws-sdk/client-cost-explorer is an optional peer dependency\n      const sdk = require(\"@aws-sdk/client-cost-explorer\");\n      const clientConfig: Record<string, unknown> = {};\n      if (this.config.region) clientConfig.region = this.config.region;\n      if (this.config.accessKeyId && this.config.secretAccessKey) {\n        clientConfig.credentials = {\n          accessKeyId: this.config.accessKeyId,\n          secretAccessKey: this.config.secretAccessKey,\n        };\n      }\n      this.client = new sdk.CostExplorerClient(clientConfig) as CostExplorerClient;\n      this.commandClass = sdk.GetCostAndUsageCommand;\n      return this.client;\n    } catch {\n      return undefined;\n    }\n  }\n\n  private buildCommand(\n    options: { startDate: string; endDate: string },\n    nextPageToken?: string,\n  ): unknown {\n    const input = {\n      TimePeriod: { Start: options.startDate, End: options.endDate },\n      Granularity: \"DAILY\",\n      Metrics: [\"UnblendedCost\", \"UsageQuantity\"],\n      GroupBy: [{ Type: \"DIMENSION\", Key: \"SERVICE\" }],\n      ...(nextPageToken ? { NextPageToken: nextPageToken } : {}),\n    };\n    // When using real AWS SDK, wrap in GetCostAndUsageCommand\n    // When using DI mock, pass plain object (mock client accepts anything)\n    return this.commandClass ? new this.commandClass(input) : input;\n  }\n\n  private parseRecord(date: string, rawServiceName: string, metrics: MetricValues): CostRecord {\n    const cost = metrics.UnblendedCost;\n    const usage = metrics.UsageQuantity;\n\n    const amount = cost?.Amount ? Number.parseFloat(cost.Amount) : 0;\n    const currency = cost?.Unit ?? \"USD\";\n    const usageValue = usage?.Amount ? Number.parseFloat(usage.Amount) : undefined;\n    const usageUnit = usage?.Unit ?? \"N/A\";\n\n    const record: CostRecord = {\n      cloud: \"aws\",\n      service: normalizeServiceName(rawServiceName),\n      date,\n      amount,\n      currency,\n    };\n\n    if (usageValue !== undefined) {\n      record.usage = { value: usageValue, unit: usageUnit };\n    }\n\n    return record;\n  }\n}\n"],"mappings":"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"}

package/dist/index.cjs

@@ -0,0 +1,102 @@
+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 AFSAwsCost = class AFSAwsCost extends _aigne_afs_cost_base.AFSCostBaseProvider {
+	cloudName = "aws";
+	static schema() {
+		return zod.z.object({
+			accessKeyId: zod.z.string().optional(),
+			secretAccessKey: zod.z.string().optional(),
+			region: 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: "aws-cost",
+			description: "AWS Cost Explorer billing data with by-service and by-date views.",
+			uriTemplate: "aws-cost://{label+}",
+			category: "cloud",
+			schema: zod.z.object({ label: zod.z.string().optional() }),
+			tags: [
+				"cost",
+				"billing",
+				"aws"
+			],
+			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: "aws-cost:root" },
+				"/by-service": { kind: "aws-cost:view" },
+				"/by-service/{service}": { kind: "aws-cost:service-summary" },
+				"/by-date": { kind: "aws-cost:view" },
+				"/by-date/{date}": { kind: "aws-cost:date-summary" }
+			},
+			auth: {
+				type: "custom",
+				env: ["AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY"]
+			},
+			bestFor: [
+				"cost visibility",
+				"spend tracking",
+				"aws billing"
+			],
+			notFor: ["real-time data", "budget alerts"]
+		};
+	}
+	static async load({ basePath, config } = {}) {
+		const camelized = (0, _aigne_afs_utils_camelize.camelize)(config ?? {});
+		return new AFSAwsCost({
+			...await AFSAwsCost.schema().parseAsync(camelized),
+			cwd: basePath
+		});
+	}
+	createAdapter(config) {
+		return new require_adapter.AWSCostAdapter({
+			accessKeyId: config.accessKeyId,
+			secretAccessKey: config.secretAccessKey,
+			region: config.region
+		});
+	}
+};
+
+//#endregion
+exports.AFSAwsCost = AFSAwsCost;
+exports.AWSCostAdapter = require_adapter.AWSCostAdapter;
+Object.defineProperty(exports, 'MockCostAdapter', {
+  enumerable: true,
+  get: function () {
+    return _aigne_afs_cost_base.MockCostAdapter;
+  }
+});

package/dist/index.d.cts

@@ -0,0 +1,34 @@
+import { AWSCostAdapter, AWSCostConfig, CostExplorerClient, GetCostAndUsageResponse } 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 AFSAwsCost extends AFSCostBaseProvider {
+  readonly cloudName = "aws";
+  static schema(): z.ZodObject<{
+    accessKeyId: z.ZodOptional<z.ZodString>;
+    secretAccessKey: z.ZodOptional<z.ZodString>;
+    region: 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<AFSAwsCost>;
+  protected createAdapter(config: Record<string, unknown>): CostAdapter$1;
+}
+//#endregion
+export { AFSAwsCost, AWSCostAdapter, type AWSCostConfig, type AdapterCapabilities, type CostAdapter, type CostExplorerClient, type CostRecord, type GetCostAndUsageResponse, 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":";;;;;;cAoBa,UAAA,SAAmB,mBAAA;EAAA,SACrB,SAAA;EAAA,OAEF,MAAA,CAAA,GAAM,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;SAeN,QAAA,CAAA,GAAY,gBAAA;EAAA,OAkBZ,UAAA,CAAA,GAAc,kBAAA;EAAA,OAgBR,IAAA,CAAA;IAAO,QAAA;IAAU;EAAA,IAAU,mBAAA,GAAwB,OAAA,CAAA,UAAA;EAAA,UAOtD,aAAA,CAAc,MAAA,EAAQ,MAAA,oBAA0B,aAAA;AAAA"}

package/dist/index.d.mts

@@ -0,0 +1,34 @@
+import { AWSCostAdapter, AWSCostConfig, CostExplorerClient, GetCostAndUsageResponse } 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 AFSAwsCost extends AFSCostBaseProvider {
+  readonly cloudName = "aws";
+  static schema(): z.ZodObject<{
+    accessKeyId: z.ZodOptional<z.ZodString>;
+    secretAccessKey: z.ZodOptional<z.ZodString>;
+    region: 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<AFSAwsCost>;
+  protected createAdapter(config: Record<string, unknown>): CostAdapter$1;
+}
+//#endregion
+export { AFSAwsCost, AWSCostAdapter, type AWSCostConfig, type AdapterCapabilities, type CostAdapter, type CostExplorerClient, type CostRecord, type GetCostAndUsageResponse, 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":";;;;;;cAoBa,UAAA,SAAmB,mBAAA;EAAA,SACrB,SAAA;EAAA,OAEF,MAAA,CAAA,GAAM,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;SAeN,QAAA,CAAA,GAAY,gBAAA;EAAA,OAkBZ,UAAA,CAAA,GAAc,kBAAA;EAAA,OAgBR,IAAA,CAAA;IAAO,QAAA;IAAU;EAAA,IAAU,mBAAA,GAAwB,OAAA,CAAA,UAAA;EAAA,UAOtD,aAAA,CAAc,MAAA,EAAQ,MAAA,oBAA0B,aAAA;AAAA"}

package/dist/index.mjs

@@ -0,0 +1,96 @@
+import { AWSCostAdapter } 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 AFSAwsCost = class AFSAwsCost extends AFSCostBaseProvider {
+	cloudName = "aws";
+	static schema() {
+		return z.object({
+			accessKeyId: z.string().optional(),
+			secretAccessKey: z.string().optional(),
+			region: 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: "aws-cost",
+			description: "AWS Cost Explorer billing data with by-service and by-date views.",
+			uriTemplate: "aws-cost://{label+}",
+			category: "cloud",
+			schema: z.object({ label: z.string().optional() }),
+			tags: [
+				"cost",
+				"billing",
+				"aws"
+			],
+			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: "aws-cost:root" },
+				"/by-service": { kind: "aws-cost:view" },
+				"/by-service/{service}": { kind: "aws-cost:service-summary" },
+				"/by-date": { kind: "aws-cost:view" },
+				"/by-date/{date}": { kind: "aws-cost:date-summary" }
+			},
+			auth: {
+				type: "custom",
+				env: ["AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY"]
+			},
+			bestFor: [
+				"cost visibility",
+				"spend tracking",
+				"aws billing"
+			],
+			notFor: ["real-time data", "budget alerts"]
+		};
+	}
+	static async load({ basePath, config } = {}) {
+		const camelized = camelize(config ?? {});
+		return new AFSAwsCost({
+			...await AFSAwsCost.schema().parseAsync(camelized),
+			cwd: basePath
+		});
+	}
+	createAdapter(config) {
+		return new AWSCostAdapter({
+			accessKeyId: config.accessKeyId,
+			secretAccessKey: config.secretAccessKey,
+			region: config.region
+		});
+	}
+};
+
+//#endregion
+export { AFSAwsCost, AWSCostAdapter, 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 { AWSCostAdapter, type AWSCostConfig } from \"./adapter.js\";\n\nexport type { AdapterCapabilities, CostAdapter, CostRecord } from \"@aigne/afs-cost-base\";\nexport { MockCostAdapter } from \"@aigne/afs-cost-base\";\nexport type { AWSCostConfig, CostExplorerClient, GetCostAndUsageResponse } from \"./adapter.js\";\nexport { AWSCostAdapter } from \"./adapter.js\";\n\n// =============================================================================\n// AFSAwsCost Provider\n// =============================================================================\n\nexport class AFSAwsCost extends AFSCostBaseProvider {\n  readonly cloudName = \"aws\";\n\n  static schema() {\n    return z.object({\n      accessKeyId: z.string().optional(),\n      secretAccessKey: z.string().optional(),\n      region: 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: \"aws-cost\",\n      description: \"AWS Cost Explorer billing data with by-service and by-date views.\",\n      uriTemplate: \"aws-cost://{label+}\",\n      category: \"cloud\",\n      schema: z.object({ label: z.string().optional() }),\n      tags: [\"cost\", \"billing\", \"aws\"],\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: \"aws-cost:root\" },\n        \"/by-service\": { kind: \"aws-cost:view\" },\n        \"/by-service/{service}\": { kind: \"aws-cost:service-summary\" },\n        \"/by-date\": { kind: \"aws-cost:view\" },\n        \"/by-date/{date}\": { kind: \"aws-cost:date-summary\" },\n      },\n      auth: { type: \"custom\", env: [\"AWS_ACCESS_KEY_ID\", \"AWS_SECRET_ACCESS_KEY\"] },\n      bestFor: [\"cost visibility\", \"spend tracking\", \"aws billing\"],\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 AFSAwsCost.schema().parseAsync(camelized);\n    return new AFSAwsCost({ ...valid, cwd: basePath } as AFSCostBaseOptions &\n      Record<string, unknown>);\n  }\n\n  protected createAdapter(config: Record<string, unknown>): CostAdapter {\n    const adapterConfig: AWSCostConfig = {\n      accessKeyId: config.accessKeyId as string | undefined,\n      secretAccessKey: config.secretAccessKey as string | undefined,\n      region: config.region as string | undefined,\n    };\n    return new AWSCostAdapter(adapterConfig);\n  }\n}\n"],"mappings":";;;;;;AAoBA,IAAa,aAAb,MAAa,mBAAmB,oBAAoB;CAClD,AAAS,YAAY;CAErB,OAAO,SAAS;AACd,SAAO,EAAE,OAAO;GACd,aAAa,EAAE,QAAQ,CAAC,UAAU;GAClC,iBAAiB,EAAE,QAAQ,CAAC,UAAU;GACtC,QAAQ,EAAE,QAAQ,CAAC,UAAU;GAC7B,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;IAAM;GAChC,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,iBAAiB;IAC9B,eAAe,EAAE,MAAM,iBAAiB;IACxC,yBAAyB,EAAE,MAAM,4BAA4B;IAC7D,YAAY,EAAE,MAAM,iBAAiB;IACrC,mBAAmB,EAAE,MAAM,yBAAyB;IACrD;GACD,MAAM;IAAE,MAAM;IAAU,KAAK,CAAC,qBAAqB,wBAAwB;IAAE;GAC7E,SAAS;IAAC;IAAmB;IAAkB;IAAc;GAC7D,QAAQ,CAAC,kBAAkB,gBAAgB;GAC5C;;CAGH,aAAa,KAAK,EAAE,UAAU,WAAgC,EAAE,EAAE;EAChE,MAAM,YAAY,SAAS,UAAU,EAAE,CAAC;AAExC,SAAO,IAAI,WAAW;GAAE,GADV,MAAM,WAAW,QAAQ,CAAC,WAAW,UAAU;GAC3B,KAAK;GAAU,CACvB;;CAG5B,AAAU,cAAc,QAA8C;AAMpE,SAAO,IAAI,eAL0B;GACnC,aAAa,OAAO;GACpB,iBAAiB,OAAO;GACxB,QAAQ,OAAO;GAChB,CACuC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@aigne/afs-aws-cost",
+  "version": "1.11.0-beta.12",
+  "description": "AIGNE AFS provider for AWS Cost Explorer billing data",
+  "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": {
+    "@aws-sdk/client-cost-explorer": "^3.0.0",
+    "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"
+  }
+}