@aigne/afs-cost-base 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/_@oxc-project_runtime@0.108.0/helpers/decorate.cjs

@@ -0,0 +1,11 @@
+
+//#region \0@oxc-project+runtime@0.108.0/helpers/decorate.js
+function __decorate(decorators, target, key, desc) {
+	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+	return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+
+//#endregion
+exports.__decorate = __decorate;

package/dist/_virtual/_@oxc-project_runtime@0.108.0/helpers/decorate.mjs

@@ -0,0 +1,10 @@
+//#region \0@oxc-project+runtime@0.108.0/helpers/decorate.js
+function __decorate(decorators, target, key, desc) {
+	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+	return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+
+//#endregion
+export { __decorate };

package/dist/annotations.cjs

@@ -0,0 +1,61 @@
+let node_fs = require("node:fs");
+let node_path = require("node:path");
+
+//#region src/annotations.ts
+/**
+* In-memory annotation store with optional file persistence.
+* Keys are formatted as `{cloud}:{service?}:{date?}`.
+*/
+var AnnotationStore = class {
+	data = /* @__PURE__ */ new Map();
+	dataDir;
+	filePath;
+	constructor(options) {
+		if (options?.dataDir) {
+			this.dataDir = options.dataDir;
+			this.filePath = (0, node_path.join)(options.dataDir, "annotations.json");
+			this.loadFromFile();
+		}
+	}
+	get(key) {
+		return this.data.get(key);
+	}
+	set(key, value) {
+		const existing = this.data.get(key) ?? {};
+		this.data.set(key, {
+			...existing,
+			...value
+		});
+		this.persistToFile();
+	}
+	/** Build annotation key from cloud + optional service/date. */
+	static key(cloud, service, date) {
+		return [
+			cloud,
+			service,
+			date
+		].filter(Boolean).join(":");
+	}
+	loadFromFile() {
+		if (!this.filePath || !(0, node_fs.existsSync)(this.filePath)) return;
+		try {
+			const raw = (0, node_fs.readFileSync)(this.filePath, "utf-8");
+			const parsed = JSON.parse(raw);
+			if (parsed && typeof parsed === "object") {
+				for (const [k, v] of Object.entries(parsed)) if (v && typeof v === "object" && !Array.isArray(v)) this.data.set(k, v);
+			}
+		} catch {}
+	}
+	persistToFile() {
+		if (!this.filePath || !this.dataDir) return;
+		try {
+			(0, node_fs.mkdirSync)(this.dataDir, { recursive: true });
+			const obj = {};
+			for (const [k, v] of this.data) obj[k] = v;
+			(0, node_fs.writeFileSync)(this.filePath, JSON.stringify(obj, null, 2), "utf-8");
+		} catch {}
+	}
+};
+
+//#endregion
+exports.AnnotationStore = AnnotationStore;

package/dist/annotations.d.cts

@@ -0,0 +1,22 @@
+//#region src/annotations.d.ts
+/**
+ * In-memory annotation store with optional file persistence.
+ * Keys are formatted as `{cloud}:{service?}:{date?}`.
+ */
+declare class AnnotationStore {
+  private data;
+  private dataDir?;
+  private filePath?;
+  constructor(options?: {
+    dataDir?: string;
+  });
+  get(key: string): Record<string, unknown> | undefined;
+  set(key: string, value: Record<string, unknown>): void;
+  /** Build annotation key from cloud + optional service/date. */
+  static key(cloud: string, service?: string, date?: string): string;
+  private loadFromFile;
+  private persistToFile;
+}
+//#endregion
+export { AnnotationStore };
+//# sourceMappingURL=annotations.d.cts.map

package/dist/annotations.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.d.cts","names":[],"sources":["../src/annotations.ts"],"mappings":";;AAOA;;;cAAa,eAAA;EAAA,QACH,IAAA;EAAA,QACA,OAAA;EAAA,QACA,QAAA;cAEI,OAAA;IAAY,OAAA;EAAA;EAQxB,GAAA,CAAI,GAAA,WAAc,MAAA;EAIlB,GAAA,CAAI,GAAA,UAAa,KAAA,EAAO,MAAA;EAJN;EAAA,OAWX,GAAA,CAAI,KAAA,UAAe,OAAA,WAAkB,IAAA;EAAA,QAIpC,YAAA;EAAA,QAiBA,aAAA;AAAA"}

package/dist/annotations.d.mts

@@ -0,0 +1,22 @@
+//#region src/annotations.d.ts
+/**
+ * In-memory annotation store with optional file persistence.
+ * Keys are formatted as `{cloud}:{service?}:{date?}`.
+ */
+declare class AnnotationStore {
+  private data;
+  private dataDir?;
+  private filePath?;
+  constructor(options?: {
+    dataDir?: string;
+  });
+  get(key: string): Record<string, unknown> | undefined;
+  set(key: string, value: Record<string, unknown>): void;
+  /** Build annotation key from cloud + optional service/date. */
+  static key(cloud: string, service?: string, date?: string): string;
+  private loadFromFile;
+  private persistToFile;
+}
+//#endregion
+export { AnnotationStore };
+//# sourceMappingURL=annotations.d.mts.map

package/dist/annotations.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.d.mts","names":[],"sources":["../src/annotations.ts"],"mappings":";;AAOA;;;cAAa,eAAA;EAAA,QACH,IAAA;EAAA,QACA,OAAA;EAAA,QACA,QAAA;cAEI,OAAA;IAAY,OAAA;EAAA;EAQxB,GAAA,CAAI,GAAA,WAAc,MAAA;EAIlB,GAAA,CAAI,GAAA,UAAa,KAAA,EAAO,MAAA;EAJN;EAAA,OAWX,GAAA,CAAI,KAAA,UAAe,OAAA,WAAkB,IAAA;EAAA,QAIpC,YAAA;EAAA,QAiBA,aAAA;AAAA"}

package/dist/annotations.mjs

@@ -0,0 +1,62 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+
+//#region src/annotations.ts
+/**
+* In-memory annotation store with optional file persistence.
+* Keys are formatted as `{cloud}:{service?}:{date?}`.
+*/
+var AnnotationStore = class {
+	data = /* @__PURE__ */ new Map();
+	dataDir;
+	filePath;
+	constructor(options) {
+		if (options?.dataDir) {
+			this.dataDir = options.dataDir;
+			this.filePath = join(options.dataDir, "annotations.json");
+			this.loadFromFile();
+		}
+	}
+	get(key) {
+		return this.data.get(key);
+	}
+	set(key, value) {
+		const existing = this.data.get(key) ?? {};
+		this.data.set(key, {
+			...existing,
+			...value
+		});
+		this.persistToFile();
+	}
+	/** Build annotation key from cloud + optional service/date. */
+	static key(cloud, service, date) {
+		return [
+			cloud,
+			service,
+			date
+		].filter(Boolean).join(":");
+	}
+	loadFromFile() {
+		if (!this.filePath || !existsSync(this.filePath)) return;
+		try {
+			const raw = readFileSync(this.filePath, "utf-8");
+			const parsed = JSON.parse(raw);
+			if (parsed && typeof parsed === "object") {
+				for (const [k, v] of Object.entries(parsed)) if (v && typeof v === "object" && !Array.isArray(v)) this.data.set(k, v);
+			}
+		} catch {}
+	}
+	persistToFile() {
+		if (!this.filePath || !this.dataDir) return;
+		try {
+			mkdirSync(this.dataDir, { recursive: true });
+			const obj = {};
+			for (const [k, v] of this.data) obj[k] = v;
+			writeFileSync(this.filePath, JSON.stringify(obj, null, 2), "utf-8");
+		} catch {}
+	}
+};
+
+//#endregion
+export { AnnotationStore };
+//# sourceMappingURL=annotations.mjs.map

package/dist/annotations.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"annotations.mjs","names":[],"sources":["../src/annotations.ts"],"sourcesContent":["import { existsSync, mkdirSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\n/**\n * In-memory annotation store with optional file persistence.\n * Keys are formatted as `{cloud}:{service?}:{date?}`.\n */\nexport class AnnotationStore {\n  private data = new Map<string, Record<string, unknown>>();\n  private dataDir?: string;\n  private filePath?: string;\n\n  constructor(options?: { dataDir?: string }) {\n    if (options?.dataDir) {\n      this.dataDir = options.dataDir;\n      this.filePath = join(options.dataDir, \"annotations.json\");\n      this.loadFromFile();\n    }\n  }\n\n  get(key: string): Record<string, unknown> | undefined {\n    return this.data.get(key);\n  }\n\n  set(key: string, value: Record<string, unknown>): void {\n    const existing = this.data.get(key) ?? {};\n    this.data.set(key, { ...existing, ...value });\n    this.persistToFile();\n  }\n\n  /** Build annotation key from cloud + optional service/date. */\n  static key(cloud: string, service?: string, date?: string): string {\n    return [cloud, service, date].filter(Boolean).join(\":\");\n  }\n\n  private loadFromFile(): void {\n    if (!this.filePath || !existsSync(this.filePath)) return;\n    try {\n      const raw = readFileSync(this.filePath, \"utf-8\");\n      const parsed = JSON.parse(raw);\n      if (parsed && typeof parsed === \"object\") {\n        for (const [k, v] of Object.entries(parsed)) {\n          if (v && typeof v === \"object\" && !Array.isArray(v)) {\n            this.data.set(k, v as Record<string, unknown>);\n          }\n        }\n      }\n    } catch {\n      // Corrupted file — start fresh\n    }\n  }\n\n  private persistToFile(): void {\n    if (!this.filePath || !this.dataDir) return;\n    try {\n      mkdirSync(this.dataDir, { recursive: true });\n      const obj: Record<string, Record<string, unknown>> = {};\n      for (const [k, v] of this.data) {\n        obj[k] = v;\n      }\n      writeFileSync(this.filePath, JSON.stringify(obj, null, 2), \"utf-8\");\n    } catch {\n      // Best-effort persistence — don't crash on write failure\n    }\n  }\n}\n"],"mappings":";;;;;;;;AAOA,IAAa,kBAAb,MAA6B;CAC3B,AAAQ,uBAAO,IAAI,KAAsC;CACzD,AAAQ;CACR,AAAQ;CAER,YAAY,SAAgC;AAC1C,MAAI,SAAS,SAAS;AACpB,QAAK,UAAU,QAAQ;AACvB,QAAK,WAAW,KAAK,QAAQ,SAAS,mBAAmB;AACzD,QAAK,cAAc;;;CAIvB,IAAI,KAAkD;AACpD,SAAO,KAAK,KAAK,IAAI,IAAI;;CAG3B,IAAI,KAAa,OAAsC;EACrD,MAAM,WAAW,KAAK,KAAK,IAAI,IAAI,IAAI,EAAE;AACzC,OAAK,KAAK,IAAI,KAAK;GAAE,GAAG;GAAU,GAAG;GAAO,CAAC;AAC7C,OAAK,eAAe;;;CAItB,OAAO,IAAI,OAAe,SAAkB,MAAuB;AACjE,SAAO;GAAC;GAAO;GAAS;GAAK,CAAC,OAAO,QAAQ,CAAC,KAAK,IAAI;;CAGzD,AAAQ,eAAqB;AAC3B,MAAI,CAAC,KAAK,YAAY,CAAC,WAAW,KAAK,SAAS,CAAE;AAClD,MAAI;GACF,MAAM,MAAM,aAAa,KAAK,UAAU,QAAQ;GAChD,MAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,OAAI,UAAU,OAAO,WAAW,UAC9B;SAAK,MAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,OAAO,CACzC,KAAI,KAAK,OAAO,MAAM,YAAY,CAAC,MAAM,QAAQ,EAAE,CACjD,MAAK,KAAK,IAAI,GAAG,EAA6B;;UAI9C;;CAKV,AAAQ,gBAAsB;AAC5B,MAAI,CAAC,KAAK,YAAY,CAAC,KAAK,QAAS;AACrC,MAAI;AACF,aAAU,KAAK,SAAS,EAAE,WAAW,MAAM,CAAC;GAC5C,MAAM,MAA+C,EAAE;AACvD,QAAK,MAAM,CAAC,GAAG,MAAM,KAAK,KACxB,KAAI,KAAK;AAEX,iBAAc,KAAK,UAAU,KAAK,UAAU,KAAK,MAAM,EAAE,EAAE,QAAQ;UAC7D"}

package/dist/base-provider.cjs

@@ -0,0 +1,431 @@
+const require_annotations = require('./annotations.cjs');
+const require_cache = require('./cache.cjs');
+const require_decorate = require('./_virtual/_@oxc-project_runtime@0.108.0/helpers/decorate.cjs');
+let _aigne_afs = require("@aigne/afs");
+let _aigne_afs_provider = require("@aigne/afs/provider");
+let _aigne_afs_utils_camelize = require("@aigne/afs/utils/camelize");
+let ufo = require("ufo");
+
+//#region src/base-provider.ts
+/** Get date string N days ago from today */
+function daysAgo(n) {
+	const d = /* @__PURE__ */ new Date();
+	d.setDate(d.getDate() - n);
+	return d.toISOString().slice(0, 10);
+}
+/** Today's date string */
+function today() {
+	return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+}
+/**
+* Parse the path into its logical segments.
+* No /{cloud} level — root is the cloud itself.
+* Returns { view, key } where view is "by-service" or "by-date" and key is the leaf.
+*/
+function parseCostPath(path) {
+	const segments = path.split("/").filter(Boolean);
+	return {
+		view: segments[0],
+		key: segments[1]
+	};
+}
+var AFSCostBaseProvider = class extends _aigne_afs_provider.AFSBaseProvider {
+	name;
+	description;
+	accessMode;
+	timeout;
+	adapter;
+	startDate;
+	endDate;
+	cache;
+	annotationStore;
+	constructor(rawOptions) {
+		super();
+		const injectedAdapter = rawOptions._adapter;
+		const options = (0, _aigne_afs_utils_camelize.camelize)(rawOptions);
+		this.name = options.name ?? `${this.cloudName}-cost`;
+		this.description = options.description;
+		this.accessMode = options.accessMode ?? "readwrite";
+		this.timeout = options.timeout ?? 3e4;
+		this.startDate = options.startDate ?? daysAgo(30);
+		this.endDate = options.endDate ?? today();
+		this.cache = new require_cache.CostCache(options.cacheTTL ?? 36e5);
+		this.annotationStore = new require_annotations.AnnotationStore(options.dataDir ? { dataDir: options.dataDir } : void 0);
+		if (injectedAdapter) this.adapter = injectedAdapter;
+		else this.adapter = this.createAdapter(options);
+	}
+	kindRoot() {
+		return `${this.cloudName}-cost:root`;
+	}
+	kindView() {
+		return `${this.cloudName}-cost:view`;
+	}
+	kindServiceSummary() {
+		return `${this.cloudName}-cost:service-summary`;
+	}
+	kindDateSummary() {
+		return `${this.cloudName}-cost:date-summary`;
+	}
+	async getRecords() {
+		const cacheKey = require_cache.CostCache.key(this.cloudName, this.startDate, this.endDate);
+		const cached = this.cache.get(cacheKey);
+		if (cached) return cached;
+		const records = await this.adapter.fetchCosts({
+			startDate: this.startDate,
+			endDate: this.endDate
+		});
+		this.cache.set(cacheKey, records);
+		return records;
+	}
+	aggregateByService(records) {
+		const map = /* @__PURE__ */ new Map();
+		for (const r of records) {
+			const arr = map.get(r.service) ?? [];
+			arr.push(r);
+			map.set(r.service, arr);
+		}
+		return map;
+	}
+	aggregateByDate(records) {
+		const map = /* @__PURE__ */ new Map();
+		for (const r of records) {
+			const arr = map.get(r.date) ?? [];
+			arr.push(r);
+			map.set(r.date, arr);
+		}
+		return map;
+	}
+	sumAmount(records) {
+		return records.reduce((acc, r) => acc + (r.amount ?? 0), 0);
+	}
+	annotationKey(service, date) {
+		return require_annotations.AnnotationStore.key(this.cloudName, service, date);
+	}
+	buildByServiceViewEntry(records, byService) {
+		const caps = this.adapter.capabilities();
+		const total = Math.round(this.sumAmount(records) * 100) / 100;
+		const rows = [];
+		for (const [service, recs] of byService) {
+			const serviceAmount = Math.round(this.sumAmount(recs) * 100) / 100;
+			const row = { service };
+			if (caps.supportsAmount) {
+				row.amount = serviceAmount;
+				row.currency = recs.find((r) => r.currency)?.currency ?? "USD";
+				row.pct = total > 0 ? Math.round(serviceAmount / total * 1e4) / 100 : 0;
+			}
+			rows.push(row);
+		}
+		const content = {
+			cloud: this.cloudName,
+			view: "by-service",
+			rows
+		};
+		if (caps.supportsAmount) {
+			content.total = total;
+			content.currency = records.find((r) => r.currency)?.currency ?? "USD";
+		}
+		return this.buildEntry("/by-service", {
+			content,
+			meta: {
+				kind: this.kindView(),
+				childrenCount: byService.size
+			}
+		});
+	}
+	buildByDateViewEntry(records, byDate) {
+		const caps = this.adapter.capabilities();
+		const total = Math.round(this.sumAmount(records) * 100) / 100;
+		const rows = [];
+		for (const [date, recs] of byDate) {
+			const dateAmount = Math.round(this.sumAmount(recs) * 100) / 100;
+			const row = {
+				date,
+				serviceCount: new Set(recs.map((r) => r.service)).size
+			};
+			if (caps.supportsAmount) {
+				row.amount = dateAmount;
+				row.currency = recs.find((r) => r.currency)?.currency ?? "USD";
+			}
+			rows.push(row);
+		}
+		const content = {
+			cloud: this.cloudName,
+			view: "by-date",
+			rows
+		};
+		if (caps.supportsAmount) {
+			content.total = total;
+			content.currency = records.find((r) => r.currency)?.currency ?? "USD";
+		}
+		return this.buildEntry("/by-date", {
+			content,
+			meta: {
+				kind: this.kindView(),
+				childrenCount: byDate.size
+			}
+		});
+	}
+	buildServiceSummaryEntry(service, records) {
+		const caps = this.adapter.capabilities();
+		const path = (0, ufo.joinURL)("/by-service", service);
+		const annKey = this.annotationKey(service);
+		const annotation = this.annotationStore.get(annKey);
+		const content = {
+			service,
+			cloud: this.cloudName,
+			startDate: this.startDate,
+			endDate: this.endDate
+		};
+		if (caps.supportsAmount) {
+			content.amount = Math.round(this.sumAmount(records) * 100) / 100;
+			content.currency = records.find((r) => r.currency)?.currency ?? "USD";
+		}
+		const byDate = this.aggregateByDate(records);
+		const daily = [];
+		for (const [d, dateRecs] of byDate) {
+			const entry = { date: d };
+			if (caps.supportsAmount) entry.amount = Math.round(this.sumAmount(dateRecs) * 100) / 100;
+			daily.push(entry);
+		}
+		content.daily = daily;
+		const meta = { kind: this.kindServiceSummary() };
+		if (annotation) Object.assign(meta, annotation);
+		return this.buildEntry(path, {
+			content,
+			meta
+		});
+	}
+	buildDateSummaryEntry(date, records) {
+		const caps = this.adapter.capabilities();
+		const path = (0, ufo.joinURL)("/by-date", date);
+		const annKey = this.annotationKey(void 0, date);
+		const annotation = this.annotationStore.get(annKey);
+		const content = {
+			date,
+			cloud: this.cloudName,
+			serviceCount: new Set(records.map((r) => r.service)).size
+		};
+		if (caps.supportsAmount) {
+			content.totalAmount = Math.round(this.sumAmount(records) * 100) / 100;
+			content.currency = records.find((r) => r.currency)?.currency ?? "USD";
+		}
+		const byService = this.aggregateByService(records);
+		const services = [];
+		for (const [svc, svcRecs] of byService) {
+			const entry = { service: svc };
+			if (caps.supportsAmount) entry.amount = Math.round(this.sumAmount(svcRecs) * 100) / 100;
+			services.push(entry);
+		}
+		content.services = services;
+		const meta = { kind: this.kindDateSummary() };
+		if (annotation) Object.assign(meta, annotation);
+		return this.buildEntry(path, {
+			content,
+			meta
+		});
+	}
+	async handleList(ctx) {
+		const path = ctx.path || "/";
+		const parsed = parseCostPath(path);
+		const maxDepth = ctx.options?.maxDepth ?? 1;
+		if (!parsed.view) {
+			const records = await this.getRecords();
+			const byService = this.aggregateByService(records);
+			const byDate = this.aggregateByDate(records);
+			const entries = [this.buildByServiceViewEntry(records, byService), this.buildByDateViewEntry(records, byDate)];
+			if (maxDepth > 1) {
+				for (const [service, recs] of byService) entries.push(this.buildServiceSummaryEntry(service, recs));
+				for (const [date, recs] of byDate) entries.push(this.buildDateSummaryEntry(date, recs));
+			}
+			return { data: entries };
+		}
+		if (parsed.view === "by-service" && !parsed.key) {
+			const records = await this.getRecords();
+			const byService = this.aggregateByService(records);
+			const entries = [];
+			for (const [service, recs] of byService) entries.push(this.buildServiceSummaryEntry(service, recs));
+			return { data: entries };
+		}
+		if (parsed.view === "by-date" && !parsed.key) {
+			const records = await this.getRecords();
+			const byDate = this.aggregateByDate(records);
+			const entries = [];
+			for (const [date, recs] of byDate) entries.push(this.buildDateSummaryEntry(date, recs));
+			return { data: entries };
+		}
+		if ((parsed.view === "by-service" || parsed.view === "by-date") && parsed.key) return { data: [] };
+		throw new _aigne_afs.AFSNotFoundError(path);
+	}
+	async handleCapabilities(_ctx) {
+		const ops = this.getOperationsDeclaration();
+		return {
+			id: "/.meta/.capabilities",
+			path: "/.meta/.capabilities",
+			content: {
+				schemaVersion: 1,
+				provider: this.name,
+				description: this.description,
+				tools: [],
+				actions: [],
+				operations: ops
+			},
+			meta: { kind: "afs:capabilities" }
+		};
+	}
+	async handleRead(ctx) {
+		const path = ctx.path || "/";
+		const parsed = parseCostPath(path);
+		if (!parsed.view) return this.buildEntry("/", {
+			content: {
+				cloud: this.cloudName,
+				startDate: this.startDate,
+				endDate: this.endDate
+			},
+			meta: {
+				kind: this.kindRoot(),
+				childrenCount: 2
+			}
+		});
+		const records = await this.getRecords();
+		if (parsed.view === "by-service" && !parsed.key) {
+			const byService = this.aggregateByService(records);
+			return this.buildByServiceViewEntry(records, byService);
+		}
+		if (parsed.view === "by-date" && !parsed.key) {
+			const byDate = this.aggregateByDate(records);
+			return this.buildByDateViewEntry(records, byDate);
+		}
+		if (parsed.view === "by-service" && parsed.key) {
+			const recs = this.aggregateByService(records).get(parsed.key);
+			if (!recs) throw new _aigne_afs.AFSNotFoundError(path);
+			return this.buildServiceSummaryEntry(parsed.key, recs);
+		}
+		if (parsed.view === "by-date" && parsed.key) {
+			const recs = this.aggregateByDate(records).get(parsed.key);
+			if (!recs) throw new _aigne_afs.AFSNotFoundError(path);
+			return this.buildDateSummaryEntry(parsed.key, recs);
+		}
+		throw new _aigne_afs.AFSNotFoundError(path);
+	}
+	async handleMeta(ctx) {
+		const metaPath = ctx.path || "/";
+		const resourcePath = metaPath.replace(/\/?\.meta$/, "") || "/";
+		const fakeCtx = {
+			...ctx,
+			path: resourcePath,
+			params: { path: resourcePath === "/" ? void 0 : resourcePath.slice(1) }
+		};
+		const entry = await this.handleRead(fakeCtx);
+		if (!entry) return void 0;
+		return this.buildEntry(metaPath, {
+			content: entry.meta ?? {},
+			meta: entry.meta ?? void 0
+		});
+	}
+	async handleStat(ctx) {
+		const entry = await this.handleRead(ctx);
+		if (!entry) return {};
+		const { content: _, ...rest } = entry;
+		return { data: rest };
+	}
+	async handleExplain(ctx) {
+		const path = ctx.path || "/";
+		const parsed = parseCostPath(path);
+		const cloud = this.cloudName;
+		if (!parsed.view) return {
+			content: `Root of the ${cloud} cost provider. Contains two views: by-service (cost/usage per service) and by-date (cost/usage per day).`,
+			format: "text"
+		};
+		if (parsed.view === "by-service" && !parsed.key) return {
+			content: `Complete table of all ${cloud} services with amounts, currency, and percentage. Reading returns all rows in one request — suitable for AUP table binding.`,
+			format: "text"
+		};
+		if (parsed.view === "by-date" && !parsed.key) return {
+			content: `Complete time series of daily cost/usage for ${cloud}. Reading returns all date rows in one request — suitable for AUP chart binding.`,
+			format: "text"
+		};
+		if (parsed.view === "by-service" && parsed.key) return {
+			content: `Cost/usage summary for ${cloud} service "${parsed.key}" with daily breakdown over the configured date range.`,
+			format: "text"
+		};
+		if (parsed.view === "by-date" && parsed.key) return {
+			content: `Cost/usage breakdown for ${cloud} on ${parsed.key}, with per-service detail.`,
+			format: "text"
+		};
+		return {
+			content: `Cloud cost data at path: ${path}`,
+			format: "text"
+		};
+	}
+	async handleSearch(ctx, query, options) {
+		if (!query) return { data: [] };
+		if (query.length > 1e3) return { data: [] };
+		const parsed = parseCostPath(ctx.path || "/");
+		const lowerQuery = query.toLowerCase();
+		const limit = options?.limit;
+		if (parsed.view && parsed.key) return { data: [] };
+		const records = await this.getRecords();
+		const byService = this.aggregateByService(records);
+		const results = [];
+		const matched = /* @__PURE__ */ new Set();
+		for (const r of records) {
+			if (limit !== void 0 && results.length >= limit) break;
+			if (matched.has(r.service)) continue;
+			if (r.service.toLowerCase().includes(lowerQuery) || r.tags && (Object.keys(r.tags).some((k) => k.toLowerCase().includes(lowerQuery)) || Object.values(r.tags).some((v) => v.toLowerCase().includes(lowerQuery)))) {
+				matched.add(r.service);
+				const recs = byService.get(r.service);
+				if (recs) results.push(this.buildServiceSummaryEntry(r.service, recs));
+			}
+		}
+		return { data: limit !== void 0 ? results.slice(0, limit) : results };
+	}
+	async handleWrite(ctx, payload) {
+		if (payload.content !== void 0) throw new _aigne_afs.AFSReadonlyError("Cost data is read-only. Use meta field for annotations.");
+		const path = ctx.path || "/";
+		const parsed = parseCostPath(path);
+		const records = await this.getRecords();
+		if (parsed.view === "by-service" && parsed.key) {
+			if (!this.aggregateByService(records).has(parsed.key)) throw new _aigne_afs.AFSNotFoundError(path);
+		} else if (parsed.view === "by-date" && parsed.key) {
+			if (!this.aggregateByDate(records).has(parsed.key)) throw new _aigne_afs.AFSNotFoundError(path);
+		}
+		if (payload.meta) {
+			const annKey = this.annotationKey(parsed.view === "by-service" ? parsed.key : void 0, parsed.view === "by-date" ? parsed.key : void 0);
+			this.annotationStore.set(annKey, payload.meta);
+		}
+		return { data: await this.handleRead(ctx) };
+	}
+	async handleRootActions(_ctx) {
+		return { data: [this.buildEntry("/.actions/refresh", {
+			content: {
+				name: "refresh",
+				description: "Invalidate cache and re-fetch",
+				inputSchema: {}
+			},
+			meta: {
+				kind: "action",
+				description: "Invalidate cache and re-fetch"
+			}
+		})] };
+	}
+	async handleRefresh(_ctx, _args) {
+		this.cache.invalidate();
+		return {
+			success: true,
+			data: { message: "Cache invalidated" }
+		};
+	}
+};
+require_decorate.__decorate([(0, _aigne_afs_provider.List)("/:path*", { handleDepth: true })], AFSCostBaseProvider.prototype, "handleList", null);
+require_decorate.__decorate([(0, _aigne_afs_provider.Read)("/.meta/.capabilities")], AFSCostBaseProvider.prototype, "handleCapabilities", null);
+require_decorate.__decorate([(0, _aigne_afs_provider.Read)("/:path*")], AFSCostBaseProvider.prototype, "handleRead", null);
+require_decorate.__decorate([(0, _aigne_afs_provider.Meta)("/:path*")], AFSCostBaseProvider.prototype, "handleMeta", null);
+require_decorate.__decorate([(0, _aigne_afs_provider.Stat)("/:path*")], AFSCostBaseProvider.prototype, "handleStat", null);
+require_decorate.__decorate([(0, _aigne_afs_provider.Explain)("/:path*")], AFSCostBaseProvider.prototype, "handleExplain", null);
+require_decorate.__decorate([(0, _aigne_afs_provider.Search)("/:path*")], AFSCostBaseProvider.prototype, "handleSearch", null);
+require_decorate.__decorate([(0, _aigne_afs_provider.Write)("/:path*")], AFSCostBaseProvider.prototype, "handleWrite", null);
+require_decorate.__decorate([(0, _aigne_afs_provider.Actions)("/")], AFSCostBaseProvider.prototype, "handleRootActions", null);
+require_decorate.__decorate([_aigne_afs_provider.Actions.Exec("/", "refresh")], AFSCostBaseProvider.prototype, "handleRefresh", null);
+
+//#endregion
+exports.AFSCostBaseProvider = AFSCostBaseProvider;