@aigne/afs-gce 1.11.0-beta.6

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/index.d.mts

@@ -0,0 +1,137 @@
+import { z } from "zod";
+import { AFSListOptions, AFSListResult, AFSModule, AFSReadOptions, AFSReadResult, AFSStatResult, AFSWriteEntryPayload, AFSWriteOptions, AFSWriteResult } from "@aigne/afs";
+
+//#region src/types.d.ts
+/**
+ * Configuration options for AFSGCE
+ */
+interface AFSGCEOptions {
+  /** Module name (used as mount path segment) */
+  name?: string;
+  /** Module description */
+  description?: string;
+  /** GCP project ID */
+  projectId: string;
+  /** GCE zone (e.g., us-central1-a) */
+  zone: string;
+  /** Access mode */
+  accessMode?: "readonly" | "readwrite";
+  /** Path to service account key file */
+  keyFilename?: string;
+  /** Explicit credentials (for programmatic access) */
+  credentials?: {
+    clientEmail: string;
+    privateKey: string;
+  };
+  /** Cache TTL in seconds (0 = no cache) */
+  cacheTtl?: number;
+}
+/**
+ * Zod schema for options validation
+ */
+declare const afsgceOptionsSchema: z.ZodEffects<z.ZodObject<{
+  name: z.ZodType<string | undefined, z.ZodTypeDef, string | undefined>;
+  description: z.ZodType<string | undefined, z.ZodTypeDef, string | undefined>;
+  projectId: z.ZodString;
+  zone: z.ZodString;
+  accessMode: z.ZodType<"readonly" | "readwrite" | undefined, z.ZodTypeDef, "readonly" | "readwrite" | undefined>;
+  keyFilename: z.ZodType<string | undefined, z.ZodTypeDef, string | undefined>;
+  credentials: z.ZodType<{
+    clientEmail: string;
+    privateKey: string;
+  } | undefined, z.ZodTypeDef, {
+    clientEmail: string;
+    privateKey: string;
+  } | undefined>;
+  cacheTtl: z.ZodType<number | undefined, z.ZodTypeDef, number | undefined>;
+}, "strict", z.ZodTypeAny, {
+  projectId: string;
+  zone: string;
+  name?: string | undefined;
+  description?: string | undefined;
+  accessMode?: "readonly" | "readwrite" | undefined;
+  keyFilename?: string | undefined;
+  credentials?: {
+    clientEmail: string;
+    privateKey: string;
+  } | undefined;
+  cacheTtl?: number | undefined;
+}, {
+  projectId: string;
+  zone: string;
+  name?: string | undefined;
+  description?: string | undefined;
+  accessMode?: "readonly" | "readwrite" | undefined;
+  keyFilename?: string | undefined;
+  credentials?: {
+    clientEmail: string;
+    privateKey: string;
+  } | undefined;
+  cacheTtl?: number | undefined;
+}>, {
+  projectId: string;
+  zone: string;
+  name?: string | undefined;
+  description?: string | undefined;
+  accessMode?: "readonly" | "readwrite" | undefined;
+  keyFilename?: string | undefined;
+  credentials?: {
+    clientEmail: string;
+    privateKey: string;
+  } | undefined;
+  cacheTtl?: number | undefined;
+}, any>;
+//#endregion
+//#region src/index.d.ts
+/**
+ * AFS GCE Provider
+ *
+ * Provides a file-system-like interface to GCE instances.
+ *
+ * @example
+ * ```typescript
+ * const provider = new AFSGCE({
+ *   projectId: 'my-project',
+ *   zone: 'us-central1-a',
+ * });
+ *
+ * // List instances
+ * const instances = await provider.list('/instances');
+ *
+ * // Get instance metadata
+ * const metadata = await provider.read('/instances/my-vm/metadata.json');
+ *
+ * // Start an instance (requires readwrite mode)
+ * await provider.write('/instances/my-vm/actions/start', {});
+ * ```
+ */
+declare class AFSGCE implements AFSModule {
+  readonly name: string;
+  readonly description?: string;
+  readonly accessMode: "readonly" | "readwrite";
+  private readonly client;
+  private readonly projectId;
+  private readonly zone;
+  constructor(options: AFSGCEOptions);
+  /**
+   * List GCE resources
+   */
+  list(path: string, options?: AFSListOptions): Promise<AFSListResult>;
+  /**
+   * Get metadata for a GCE resource
+   */
+  stat(path: string): Promise<AFSStatResult>;
+  /**
+   * Read GCE resource data
+   */
+  read(path: string, options?: AFSReadOptions): Promise<AFSReadResult>;
+  /**
+   * Write/execute action on GCE resource
+   *
+   * In GCE, write is used to execute actions (start, stop, reset)
+   */
+  write(path: string, _content: AFSWriteEntryPayload, _options?: AFSWriteOptions): Promise<AFSWriteResult>;
+}
+//#endregion
+export { AFSGCE, type AFSGCEOptions, afsgceOptionsSchema };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/index.ts"],"mappings":";;;;AAUA;;;AAAA,UAAiB,aAAA;EAEf;EAAA,IAAA;EAMA;EAHA,WAAA;EASA;EANA,SAAA;EAYA;EATA,IAAA;EAWE;EARF,UAAA;EAYQ;EATR,WAAA;EAqBW;EAlBX,WAAA;IACE,WAAA;IACA,UAAA;EAAA;;EAIF,QAAA;AAAA;;;;cAYW,mBAAA,EAAmB,CAAA,CAAA,UAAA,CAAA,CAAA,CAAA,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAhC;;;;;;;;;cCAa,MAAA,YAAkB,SAAA;EAAA,SACpB,IAAA;EAAA,SACA,WAAA;EAAA,SACA,UAAA;EAAA,iBAEQ,MAAA;EAAA,iBACA,SAAA;EAAA,iBACA,IAAA;cAEL,OAAA,EAAS,aAAA;;;;EAyBf,IAAA,CAAK,IAAA,UAAc,OAAA,GAAU,cAAA,GAAiB,OAAA,CAAQ,aAAA;EDlC9B;;;ECyCxB,IAAA,CAAK,IAAA,WAAe,OAAA,CAAQ,aAAA;EDzCJ;;;ECuDxB,IAAA,CAAK,IAAA,UAAc,OAAA,GAAU,cAAA,GAAiB,OAAA,CAAQ,aAAA;;;;;;EAStD,KAAA,CACJ,IAAA,UACA,QAAA,EAAU,oBAAA,EACV,QAAA,GAAW,eAAA,GACV,OAAA,CAAQ,cAAA;AAAA"}

package/dist/index.mjs

@@ -0,0 +1,837 @@
+import { InstancesClient } from "@google-cloud/compute";
+import { camelize, optionalize } from "@aigne/afs/utils/zod";
+import { z } from "zod";
+
+//#region src/errors.ts
+/**
+* GCE Provider Error Handling
+*
+* Maps GCE SDK errors to AFS error types.
+*/
+/**
+* AFS error codes
+*/
+const AFSErrorCode = {
+	ENTRY_NOT_FOUND: "ENTRY_NOT_FOUND",
+	MODULE_NOT_FOUND: "MODULE_NOT_FOUND",
+	PERMISSION_DENIED: "PERMISSION_DENIED",
+	AUTH_ERROR: "AUTH_ERROR",
+	RATE_LIMIT_EXCEEDED: "RATE_LIMIT_EXCEEDED",
+	INVALID_OPERATION: "INVALID_OPERATION",
+	ALREADY_EXISTS: "ALREADY_EXISTS",
+	SERVICE_UNAVAILABLE: "SERVICE_UNAVAILABLE",
+	UNKNOWN: "UNKNOWN"
+};
+/**
+* AFS Error class
+*/
+var AFSError = class extends Error {
+	code;
+	retryAfter;
+	constructor(code, message, options) {
+		super(message);
+		this.name = "AFSError";
+		this.code = code;
+		this.retryAfter = options?.retryAfter;
+	}
+};
+/**
+* Map GCE HTTP status codes to AFS error codes
+*/
+const STATUS_TO_AFS_ERROR = {
+	400: AFSErrorCode.INVALID_OPERATION,
+	401: AFSErrorCode.AUTH_ERROR,
+	403: AFSErrorCode.PERMISSION_DENIED,
+	404: AFSErrorCode.ENTRY_NOT_FOUND,
+	409: AFSErrorCode.ALREADY_EXISTS,
+	429: AFSErrorCode.RATE_LIMIT_EXCEEDED,
+	503: AFSErrorCode.SERVICE_UNAVAILABLE
+};
+/**
+* Map GCE error to AFS error
+*
+* @param error - GCE SDK error or generic error
+* @returns AFSError with appropriate error code
+*/
+function mapGCEError(error) {
+	if (typeof error === "object" && error !== null && "code" in error) {
+		const err = error;
+		const statusCode = typeof err.code === "number" ? err.code : 500;
+		const message = err.message ?? "Unknown GCE error";
+		return new AFSError(STATUS_TO_AFS_ERROR[statusCode] ?? AFSErrorCode.UNKNOWN, message);
+	}
+	if (error instanceof Error) return new AFSError(AFSErrorCode.UNKNOWN, error.message);
+	return new AFSError(AFSErrorCode.UNKNOWN, String(error));
+}
+
+//#endregion
+//#region src/path-resolver.ts
+/**
+* Parse an AFS path into GCE resource identifiers
+*
+* Path structure:
+* / - root
+* /instances - list all instances
+* /instances/{name} - specific instance
+* /instances/{name}/metadata.json - instance metadata
+* /instances/{name}/actions - list available actions
+* /instances/{name}/actions/{action} - specific action
+* /actions - global actions list
+* /actions/{action} - global action
+*
+* @param path - AFS path
+* @returns Parsed path with type and identifiers
+*/
+function parsePath(path) {
+	const segments = path.replace(/^\/+/, "").replace(/\/+$/, "").split("/").filter(Boolean);
+	if (segments.length === 0) return {
+		type: "root",
+		raw: path
+	};
+	const [first, second, third, fourth] = segments;
+	if (first === "instances") {
+		if (!second) return {
+			type: "instances",
+			raw: path
+		};
+		if (!third) return {
+			type: "instance",
+			instanceName: second,
+			raw: path
+		};
+		if (third === "metadata.json") return {
+			type: "instance-metadata",
+			instanceName: second,
+			fileName: third,
+			raw: path
+		};
+		if (third === "actions") {
+			if (!fourth) return {
+				type: "instance-actions",
+				instanceName: second,
+				raw: path
+			};
+			return {
+				type: "instance-action",
+				instanceName: second,
+				action: fourth,
+				raw: path
+			};
+		}
+		return {
+			type: "unknown",
+			raw: path
+		};
+	}
+	if (first === "actions") {
+		if (!second) return {
+			type: "actions",
+			raw: path
+		};
+		return {
+			type: "global-action",
+			action: second,
+			raw: path
+		};
+	}
+	return {
+		type: "unknown",
+		raw: path
+	};
+}
+/**
+* Build an AFS path from components
+*/
+function buildPath(...segments) {
+	return `/${segments.filter(Boolean).join("/")}`;
+}
+
+//#endregion
+//#region src/operations/actions.ts
+/**
+* Execute an action on a GCE resource
+*
+* @param client - GCE InstancesClient
+* @param projectId - GCP project ID
+* @param zone - GCE zone
+* @param path - AFS path to the action
+* @returns Action result
+*/
+async function executeAction(client, projectId, zone, path) {
+	try {
+		const parsed = parsePath(path);
+		switch (parsed.type) {
+			case "instance-action": return executeInstanceAction(client, projectId, zone, parsed.instanceName, parsed.action);
+			case "global-action": return executeGlobalAction(parsed.action);
+			default: throw new Error(`Cannot execute action on path: ${path}`);
+		}
+	} catch (error) {
+		throw mapGCEError(error);
+	}
+}
+/**
+* Execute an action on a specific instance
+*/
+async function executeInstanceAction(client, projectId, zone, instanceName, action) {
+	const [instance] = await client.get({
+		project: projectId,
+		zone,
+		instance: instanceName
+	});
+	const status = instance.status;
+	switch (action) {
+		case "start": return startInstance(client, projectId, zone, instanceName, status);
+		case "stop": return stopInstance(client, projectId, zone, instanceName, status);
+		case "reset": return resetInstance(client, projectId, zone, instanceName, status);
+		default: return {
+			success: false,
+			action,
+			error: `Unknown action: ${action}`
+		};
+	}
+}
+/**
+* Start an instance
+*/
+async function startInstance(client, projectId, zone, instanceName, currentStatus) {
+	if (currentStatus !== "STOPPED" && currentStatus !== "TERMINATED") return {
+		success: false,
+		action: "start",
+		error: `Cannot start instance in ${currentStatus} state. Instance must be STOPPED or TERMINATED.`
+	};
+	const [operation] = await client.start({
+		project: projectId,
+		zone,
+		instance: instanceName
+	});
+	return {
+		success: true,
+		action: "start",
+		operationName: operation.latestResponse?.name || "unknown"
+	};
+}
+/**
+* Stop an instance
+*/
+async function stopInstance(client, projectId, zone, instanceName, currentStatus) {
+	if (currentStatus !== "RUNNING") return {
+		success: false,
+		action: "stop",
+		error: `Cannot stop instance in ${currentStatus} state. Instance must be RUNNING.`
+	};
+	const [operation] = await client.stop({
+		project: projectId,
+		zone,
+		instance: instanceName
+	});
+	return {
+		success: true,
+		action: "stop",
+		operationName: operation.latestResponse?.name || "unknown"
+	};
+}
+/**
+* Reset an instance
+*/
+async function resetInstance(client, projectId, zone, instanceName, currentStatus) {
+	if (currentStatus !== "RUNNING") return {
+		success: false,
+		action: "reset",
+		error: `Cannot reset instance in ${currentStatus} state. Instance must be RUNNING.`
+	};
+	const [operation] = await client.reset({
+		project: projectId,
+		zone,
+		instance: instanceName
+	});
+	return {
+		success: true,
+		action: "reset",
+		operationName: operation.latestResponse?.name || "unknown"
+	};
+}
+/**
+* Execute a global action
+*/
+function executeGlobalAction(action) {
+	switch (action) {
+		case "refresh": return {
+			success: true,
+			action: "refresh"
+		};
+		default: return {
+			success: false,
+			action,
+			error: `Unknown global action: ${action}`
+		};
+	}
+}
+
+//#endregion
+//#region src/platform-ref.ts
+/**
+* Generate platform reference with GCP Console URL for an instance
+*
+* @param projectId - GCP project ID
+* @param zone - GCE zone
+* @param instanceName - Instance name
+* @returns Platform reference with console URL
+*/
+function generateInstancePlatformRef(projectId, zone, instanceName) {
+	return { consoleUrl: `https://console.cloud.google.com/compute/instancesDetail/zones/${zone}/instances/${instanceName}?project=${projectId}` };
+}
+/**
+* Generate platform reference with GCP Console URL for instances list
+*
+* @param projectId - GCP project ID
+* @returns Platform reference with console URL
+*/
+function generateInstancesListPlatformRef(projectId) {
+	return { consoleUrl: `https://console.cloud.google.com/compute/instances?project=${projectId}` };
+}
+
+//#endregion
+//#region src/types.ts
+/**
+* AFS GCE Provider Types
+*/
+/**
+* GCE zone validation regex
+* Format: region-zone (e.g., us-central1-a, europe-west1-b)
+*/
+const ZONE_REGEX = /^[a-z]+-[a-z]+\d+-[a-z]$/;
+/**
+* Zod schema for options validation
+*/
+const afsgceOptionsSchema = camelize(z.object({
+	name: optionalize(z.string()),
+	description: optionalize(z.string()),
+	projectId: z.string().min(1),
+	zone: z.string().regex(ZONE_REGEX, "Invalid GCE zone format (e.g., us-central1-a)"),
+	accessMode: optionalize(z.enum(["readonly", "readwrite"])),
+	keyFilename: optionalize(z.string()),
+	credentials: optionalize(z.object({
+		clientEmail: z.string(),
+		privateKey: z.string()
+	})),
+	cacheTtl: optionalize(z.number().int().min(0))
+}).strict());
+/**
+* Kind constants for GCE resources
+*/
+const KINDS = {
+	INSTANCE: "gce:instance",
+	ACTION: "gce:action",
+	EXECUTABLE: "afs:executable",
+	NODE: "afs:node",
+	GCP_RESOURCE: "gcp:resource"
+};
+
+//#endregion
+//#region src/operations/list.ts
+/**
+* List GCE resources
+*
+* @param client - GCE InstancesClient
+* @param projectId - GCP project ID
+* @param zone - GCE zone
+* @param path - AFS path
+* @param options - List options
+* @returns List result with entries
+*/
+async function list(client, projectId, zone, path, options) {
+	try {
+		const parsed = parsePath(path);
+		switch (parsed.type) {
+			case "root": return listRoot(projectId);
+			case "instances": return listInstances(client, projectId, zone, options);
+			case "instance": return listInstanceChildren(client, projectId, zone, parsed.instanceName);
+			case "instance-actions": return listInstanceActions(client, projectId, zone, parsed.instanceName);
+			case "actions": return listGlobalActions(projectId);
+			default: return { data: [] };
+		}
+	} catch (error) {
+		throw mapGCEError(error);
+	}
+}
+/**
+* List root directory
+*/
+function listRoot(projectId) {
+	return { data: [{
+		id: `gce://${projectId}/instances`,
+		path: "/instances",
+		metadata: {
+			kind: KINDS.NODE,
+			kinds: [KINDS.NODE],
+			childrenCount: 0,
+			description: "GCE Instances",
+			platformRef: generateInstancesListPlatformRef(projectId)
+		}
+	}, {
+		id: `gce://${projectId}/actions`,
+		path: "/actions",
+		metadata: {
+			kind: KINDS.NODE,
+			kinds: [KINDS.NODE],
+			childrenCount: 0,
+			description: "Global Actions"
+		}
+	}] };
+}
+/**
+* List all instances
+*/
+async function listInstances(client, projectId, zone, options) {
+	const maxChildren = options?.maxChildren ?? 1e3;
+	const [instances] = await client.list({
+		project: projectId,
+		zone,
+		maxResults: maxChildren
+	});
+	return { data: (instances || []).map((instance) => {
+		const name = instance.name;
+		const machineType = instance.machineType?.split("/").pop() || "unknown";
+		return {
+			id: `gce://${projectId}/${zone}/${name}`,
+			path: buildPath("instances", name),
+			metadata: {
+				kind: KINDS.INSTANCE,
+				kinds: [
+					KINDS.INSTANCE,
+					KINDS.GCP_RESOURCE,
+					KINDS.NODE
+				],
+				childrenCount: 2,
+				status: instance.status,
+				machineType,
+				privateIp: instance.networkInterfaces?.[0]?.networkIP,
+				publicIp: instance.networkInterfaces?.[0]?.accessConfigs?.[0]?.natIP,
+				createdAt: instance.creationTimestamp,
+				labels: instance.labels,
+				platformRef: generateInstancePlatformRef(projectId, zone, name)
+			}
+		};
+	}) };
+}
+/**
+* List instance children (metadata.json, actions)
+*/
+async function listInstanceChildren(client, projectId, zone, instanceName) {
+	await client.get({
+		project: projectId,
+		zone,
+		instance: instanceName
+	});
+	return { data: [{
+		id: `gce://${projectId}/${zone}/${instanceName}/metadata.json`,
+		path: buildPath("instances", instanceName, "metadata.json"),
+		metadata: {
+			kind: KINDS.NODE,
+			kinds: [KINDS.NODE],
+			description: "Instance metadata"
+		}
+	}, {
+		id: `gce://${projectId}/${zone}/${instanceName}/actions`,
+		path: buildPath("instances", instanceName, "actions"),
+		metadata: {
+			kind: KINDS.NODE,
+			kinds: [KINDS.NODE],
+			childrenCount: 0,
+			description: "Instance actions"
+		}
+	}] };
+}
+/**
+* List available actions for an instance
+*/
+async function listInstanceActions(client, projectId, zone, instanceName) {
+	const [instance] = await client.get({
+		project: projectId,
+		zone,
+		instance: instanceName
+	});
+	const status = instance.status;
+	const actions = [];
+	switch (status) {
+		case "RUNNING":
+			actions.push("stop", "reset");
+			break;
+		case "STOPPED":
+		case "TERMINATED":
+			actions.push("start");
+			break;
+		case "SUSPENDED":
+			actions.push("resume");
+			break;
+		default: break;
+	}
+	return { data: actions.map((action) => ({
+		id: `gce://${projectId}/${zone}/${instanceName}/actions/${action}`,
+		path: buildPath("instances", instanceName, "actions", action),
+		metadata: {
+			kind: KINDS.ACTION,
+			kinds: [
+				KINDS.ACTION,
+				KINDS.EXECUTABLE,
+				KINDS.NODE
+			],
+			description: `${action.charAt(0).toUpperCase() + action.slice(1)} the instance`
+		}
+	})) };
+}
+/**
+* List global actions
+*/
+function listGlobalActions(projectId) {
+	return { data: [{
+		id: `gce://${projectId}/actions/refresh`,
+		path: "/actions/refresh",
+		metadata: {
+			kind: KINDS.ACTION,
+			kinds: [
+				KINDS.ACTION,
+				KINDS.EXECUTABLE,
+				KINDS.NODE
+			],
+			description: "Refresh instance cache"
+		}
+	}] };
+}
+
+//#endregion
+//#region src/operations/read.ts
+/**
+* Read GCE resource data
+*
+* @param client - GCE InstancesClient
+* @param projectId - GCP project ID
+* @param zone - GCE zone
+* @param path - AFS path
+* @param options - Read options
+* @returns Read result with content
+*/
+async function read(client, projectId, zone, path, _options) {
+	try {
+		const parsed = parsePath(path);
+		switch (parsed.type) {
+			case "instance-metadata": return readInstanceMetadata(client, projectId, zone, parsed.instanceName);
+			default: throw new Error(`Cannot read path: ${path}`);
+		}
+	} catch (error) {
+		throw mapGCEError(error);
+	}
+}
+/**
+* Read instance metadata as JSON
+*/
+async function readInstanceMetadata(client, projectId, zone, instanceName) {
+	const [instance] = await client.get({
+		project: projectId,
+		zone,
+		instance: instanceName
+	});
+	return { data: {
+		id: `gce://${projectId}/${zone}/${instanceName}/metadata.json`,
+		path: buildPath("instances", instanceName, "metadata.json"),
+		metadata: {
+			kind: KINDS.NODE,
+			kinds: [KINDS.NODE],
+			description: "Instance metadata"
+		},
+		content: JSON.stringify(instance, null, 2)
+	} };
+}
+
+//#endregion
+//#region src/operations/stat.ts
+/**
+* Get metadata for a GCE resource
+*
+* @param client - GCE InstancesClient
+* @param projectId - GCP project ID
+* @param zone - GCE zone
+* @param path - AFS path
+* @returns Entry with metadata
+*/
+async function stat(client, projectId, zone, path) {
+	try {
+		const parsed = parsePath(path);
+		switch (parsed.type) {
+			case "root": return statRoot(projectId);
+			case "instances": return statInstances(projectId);
+			case "instance": return statInstance(client, projectId, zone, parsed.instanceName);
+			case "instance-metadata": return statInstanceMetadata(client, projectId, zone, parsed.instanceName);
+			case "instance-actions": return statInstanceActions(client, projectId, zone, parsed.instanceName);
+			case "instance-action": return statInstanceAction(client, projectId, zone, parsed.instanceName, parsed.action);
+			case "actions": return statGlobalActions(projectId);
+			case "global-action": return statGlobalAction(projectId, parsed.action);
+			default: throw new Error(`Path not found: ${path}`);
+		}
+	} catch (error) {
+		throw mapGCEError(error);
+	}
+}
+/**
+* Stat root directory
+*/
+function statRoot(projectId) {
+	return {
+		id: `gce://${projectId}/`,
+		path: "/",
+		metadata: {
+			kind: KINDS.NODE,
+			kinds: [KINDS.NODE],
+			childrenCount: 2,
+			description: "GCE Root"
+		}
+	};
+}
+/**
+* Stat instances directory
+*/
+function statInstances(projectId) {
+	return {
+		id: `gce://${projectId}/instances`,
+		path: "/instances",
+		metadata: {
+			kind: KINDS.NODE,
+			kinds: [KINDS.NODE],
+			childrenCount: 0,
+			description: "GCE Instances",
+			platformRef: generateInstancesListPlatformRef(projectId)
+		}
+	};
+}
+/**
+* Stat a specific instance
+*/
+async function statInstance(client, projectId, zone, instanceName) {
+	const [instance] = await client.get({
+		project: projectId,
+		zone,
+		instance: instanceName
+	});
+	const machineType = instance.machineType?.split("/").pop() || "unknown";
+	return {
+		id: `gce://${projectId}/${zone}/${instanceName}`,
+		path: buildPath("instances", instanceName),
+		metadata: {
+			kind: KINDS.INSTANCE,
+			kinds: [
+				KINDS.INSTANCE,
+				KINDS.GCP_RESOURCE,
+				KINDS.NODE
+			],
+			childrenCount: 2,
+			status: instance.status,
+			machineType,
+			privateIp: instance.networkInterfaces?.[0]?.networkIP,
+			publicIp: instance.networkInterfaces?.[0]?.accessConfigs?.[0]?.natIP,
+			createdAt: instance.creationTimestamp,
+			labels: instance.labels,
+			platformRef: generateInstancePlatformRef(projectId, zone, instanceName)
+		}
+	};
+}
+/**
+* Stat instance metadata.json file
+*/
+async function statInstanceMetadata(client, projectId, zone, instanceName) {
+	await client.get({
+		project: projectId,
+		zone,
+		instance: instanceName
+	});
+	return {
+		id: `gce://${projectId}/${zone}/${instanceName}/metadata.json`,
+		path: buildPath("instances", instanceName, "metadata.json"),
+		metadata: {
+			kind: KINDS.NODE,
+			kinds: [KINDS.NODE],
+			description: "Instance metadata"
+		}
+	};
+}
+/**
+* Stat instance actions directory
+*/
+async function statInstanceActions(client, projectId, zone, instanceName) {
+	await client.get({
+		project: projectId,
+		zone,
+		instance: instanceName
+	});
+	return {
+		id: `gce://${projectId}/${zone}/${instanceName}/actions`,
+		path: buildPath("instances", instanceName, "actions"),
+		metadata: {
+			kind: KINDS.NODE,
+			kinds: [KINDS.NODE],
+			childrenCount: 0,
+			description: "Instance actions"
+		}
+	};
+}
+/**
+* Stat a specific instance action
+*/
+async function statInstanceAction(client, projectId, zone, instanceName, action) {
+	await client.get({
+		project: projectId,
+		zone,
+		instance: instanceName
+	});
+	return {
+		id: `gce://${projectId}/${zone}/${instanceName}/actions/${action}`,
+		path: buildPath("instances", instanceName, "actions", action),
+		metadata: {
+			kind: KINDS.ACTION,
+			kinds: [
+				KINDS.ACTION,
+				KINDS.EXECUTABLE,
+				KINDS.NODE
+			],
+			description: `${action.charAt(0).toUpperCase() + action.slice(1)} the instance`
+		}
+	};
+}
+/**
+* Stat global actions directory
+*/
+function statGlobalActions(projectId) {
+	return {
+		id: `gce://${projectId}/actions`,
+		path: "/actions",
+		metadata: {
+			kind: KINDS.NODE,
+			kinds: [KINDS.NODE],
+			childrenCount: 1,
+			description: "Global Actions"
+		}
+	};
+}
+/**
+* Stat a specific global action
+*/
+function statGlobalAction(projectId, action) {
+	return {
+		id: `gce://${projectId}/actions/${action}`,
+		path: buildPath("actions", action),
+		metadata: {
+			kind: KINDS.ACTION,
+			kinds: [
+				KINDS.ACTION,
+				KINDS.EXECUTABLE,
+				KINDS.NODE
+			],
+			description: `${action.charAt(0).toUpperCase() + action.slice(1)} action`
+		}
+	};
+}
+
+//#endregion
+//#region src/index.ts
+/**
+* AFS GCE Provider
+*
+* Provides a file-system-like interface to GCE instances.
+*
+* @example
+* ```typescript
+* const provider = new AFSGCE({
+*   projectId: 'my-project',
+*   zone: 'us-central1-a',
+* });
+*
+* // List instances
+* const instances = await provider.list('/instances');
+*
+* // Get instance metadata
+* const metadata = await provider.read('/instances/my-vm/metadata.json');
+*
+* // Start an instance (requires readwrite mode)
+* await provider.write('/instances/my-vm/actions/start', {});
+* ```
+*/
+var AFSGCE = class {
+	name;
+	description;
+	accessMode;
+	client;
+	projectId;
+	zone;
+	constructor(options) {
+		const validated = afsgceOptionsSchema.parse(options);
+		this.name = validated.name || "gce";
+		this.description = validated.description;
+		this.accessMode = validated.accessMode || "readonly";
+		this.projectId = validated.projectId;
+		this.zone = validated.zone;
+		this.client = new InstancesClient({
+			keyFilename: validated.keyFilename,
+			credentials: validated.credentials ? {
+				client_email: validated.credentials.clientEmail,
+				private_key: validated.credentials.privateKey
+			} : void 0
+		});
+	}
+	/**
+	* List GCE resources
+	*/
+	async list(path, options) {
+		return list(this.client, this.projectId, this.zone, path, options);
+	}
+	/**
+	* Get metadata for a GCE resource
+	*/
+	async stat(path) {
+		const entry = await stat(this.client, this.projectId, this.zone, path);
+		return { data: {
+			path: entry.path,
+			childrenCount: entry.metadata?.childrenCount,
+			meta: entry.metadata
+		} };
+	}
+	/**
+	* Read GCE resource data
+	*/
+	async read(path, options) {
+		return read(this.client, this.projectId, this.zone, path, options);
+	}
+	/**
+	* Write/execute action on GCE resource
+	*
+	* In GCE, write is used to execute actions (start, stop, reset)
+	*/
+	async write(path, _content, _options) {
+		if (this.accessMode !== "readwrite") throw mapGCEError(/* @__PURE__ */ new Error("Write operations require readwrite access mode"));
+		const parsed = parsePath(path);
+		if (parsed.type === "instance-action" || parsed.type === "global-action") {
+			const result = await executeAction(this.client, this.projectId, this.zone, path);
+			return {
+				data: {
+					id: `gce://${this.projectId}/${this.zone}/${path}`,
+					path,
+					metadata: {
+						kind: KINDS.ACTION,
+						kinds: [
+							KINDS.ACTION,
+							KINDS.EXECUTABLE,
+							KINDS.NODE
+						],
+						success: result.success,
+						operationName: result.operationName,
+						error: result.error
+					}
+				},
+				message: result.success ? `Action ${result.action} executed successfully` : `Action ${result.action} failed: ${result.error}`
+			};
+		}
+		throw mapGCEError(/* @__PURE__ */ new Error(`Cannot write to path: ${path}`));
+	}
+};
+
+//#endregion
+export { AFSGCE, afsgceOptionsSchema };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/errors.ts","../src/path-resolver.ts","../src/operations/actions.ts","../src/platform-ref.ts","../src/types.ts","../src/operations/list.ts","../src/operations/read.ts","../src/operations/stat.ts","../src/index.ts"],"sourcesContent":["/**\n * GCE Provider Error Handling\n *\n * Maps GCE SDK errors to AFS error types.\n */\n\n/**\n * AFS error codes\n */\nexport const AFSErrorCode = {\n  ENTRY_NOT_FOUND: \"ENTRY_NOT_FOUND\",\n  MODULE_NOT_FOUND: \"MODULE_NOT_FOUND\",\n  PERMISSION_DENIED: \"PERMISSION_DENIED\",\n  AUTH_ERROR: \"AUTH_ERROR\",\n  RATE_LIMIT_EXCEEDED: \"RATE_LIMIT_EXCEEDED\",\n  INVALID_OPERATION: \"INVALID_OPERATION\",\n  ALREADY_EXISTS: \"ALREADY_EXISTS\",\n  SERVICE_UNAVAILABLE: \"SERVICE_UNAVAILABLE\",\n  UNKNOWN: \"UNKNOWN\",\n} as const;\n\nexport type AFSErrorCode = (typeof AFSErrorCode)[keyof typeof AFSErrorCode];\n\n/**\n * AFS Error class\n */\nexport class AFSError extends Error {\n  readonly code: AFSErrorCode;\n  readonly retryAfter?: number;\n\n  constructor(code: AFSErrorCode, message: string, options?: { retryAfter?: number }) {\n    super(message);\n    this.name = \"AFSError\";\n    this.code = code;\n    this.retryAfter = options?.retryAfter;\n  }\n}\n\n/**\n * Map GCE HTTP status codes to AFS error codes\n */\nconst STATUS_TO_AFS_ERROR: Record<number, AFSErrorCode> = {\n  400: AFSErrorCode.INVALID_OPERATION,\n  401: AFSErrorCode.AUTH_ERROR,\n  403: AFSErrorCode.PERMISSION_DENIED,\n  404: AFSErrorCode.ENTRY_NOT_FOUND,\n  409: AFSErrorCode.ALREADY_EXISTS,\n  429: AFSErrorCode.RATE_LIMIT_EXCEEDED,\n  503: AFSErrorCode.SERVICE_UNAVAILABLE,\n};\n\n/**\n * Map GCE error to AFS error\n *\n * @param error - GCE SDK error or generic error\n * @returns AFSError with appropriate error code\n */\nexport function mapGCEError(error: unknown): AFSError {\n  // Handle GCE SDK errors (they have code property)\n  if (typeof error === \"object\" && error !== null && \"code\" in error) {\n    const err = error as { code: number; message?: string };\n    const statusCode = typeof err.code === \"number\" ? err.code : 500;\n    const message = err.message ?? \"Unknown GCE error\";\n    const afsCode = STATUS_TO_AFS_ERROR[statusCode] ?? AFSErrorCode.UNKNOWN;\n    return new AFSError(afsCode, message);\n  }\n\n  // Handle generic Error\n  if (error instanceof Error) {\n    return new AFSError(AFSErrorCode.UNKNOWN, error.message);\n  }\n\n  // Unknown error type\n  return new AFSError(AFSErrorCode.UNKNOWN, String(error));\n}\n","/**\n * GCE Path Resolver\n *\n * Parses AFS paths into GCE resource identifiers.\n */\n\nimport type { ParsedPath } from \"./types.js\";\n\n/**\n * Parse an AFS path into GCE resource identifiers\n *\n * Path structure:\n * / - root\n * /instances - list all instances\n * /instances/{name} - specific instance\n * /instances/{name}/metadata.json - instance metadata\n * /instances/{name}/actions - list available actions\n * /instances/{name}/actions/{action} - specific action\n * /actions - global actions list\n * /actions/{action} - global action\n *\n * @param path - AFS path\n * @returns Parsed path with type and identifiers\n */\nexport function parsePath(path: string): ParsedPath {\n  const normalizedPath = path.replace(/^\\/+/, \"\").replace(/\\/+$/, \"\");\n  const segments = normalizedPath.split(\"/\").filter(Boolean);\n\n  if (segments.length === 0) {\n    return { type: \"root\", raw: path };\n  }\n\n  const [first, second, third, fourth] = segments;\n\n  // /instances\n  if (first === \"instances\") {\n    if (!second) {\n      return { type: \"instances\", raw: path };\n    }\n\n    // /instances/{name}\n    if (!third) {\n      return { type: \"instance\", instanceName: second, raw: path };\n    }\n\n    // /instances/{name}/metadata.json\n    if (third === \"metadata.json\") {\n      return { type: \"instance-metadata\", instanceName: second, fileName: third, raw: path };\n    }\n\n    // /instances/{name}/actions\n    if (third === \"actions\") {\n      if (!fourth) {\n        return { type: \"instance-actions\", instanceName: second, raw: path };\n      }\n      // /instances/{name}/actions/{action}\n      return { type: \"instance-action\", instanceName: second, action: fourth, raw: path };\n    }\n\n    return { type: \"unknown\", raw: path };\n  }\n\n  // /actions\n  if (first === \"actions\") {\n    if (!second) {\n      return { type: \"actions\", raw: path };\n    }\n    // /actions/{action}\n    return { type: \"global-action\", action: second, raw: path };\n  }\n\n  return { type: \"unknown\", raw: path };\n}\n\n/**\n * Build an AFS path from components\n */\nexport function buildPath(...segments: (string | undefined)[]): string {\n  return `/${segments.filter(Boolean).join(\"/\")}`;\n}\n","/**\n * GCE Actions\n *\n * Executes actions on GCE resources (start, stop, reset, etc.)\n */\n\nimport type { InstancesClient } from \"@google-cloud/compute\";\nimport { mapGCEError } from \"../errors.js\";\nimport { parsePath } from \"../path-resolver.js\";\nimport type { GCEInstanceState } from \"../types.js\";\n\n/**\n * Action result\n */\nexport interface ActionResult {\n  success: boolean;\n  action: string;\n  operationName?: string;\n  error?: string;\n}\n\n/**\n * Execute an action on a GCE resource\n *\n * @param client - GCE InstancesClient\n * @param projectId - GCP project ID\n * @param zone - GCE zone\n * @param path - AFS path to the action\n * @returns Action result\n */\nexport async function executeAction(\n  client: InstancesClient,\n  projectId: string,\n  zone: string,\n  path: string,\n): Promise<ActionResult> {\n  try {\n    const parsed = parsePath(path);\n\n    switch (parsed.type) {\n      case \"instance-action\":\n        return executeInstanceAction(client, projectId, zone, parsed.instanceName!, parsed.action!);\n\n      case \"global-action\":\n        return executeGlobalAction(parsed.action!);\n\n      default:\n        throw new Error(`Cannot execute action on path: ${path}`);\n    }\n  } catch (error) {\n    throw mapGCEError(error);\n  }\n}\n\n/**\n * Execute an action on a specific instance\n */\nasync function executeInstanceAction(\n  client: InstancesClient,\n  projectId: string,\n  zone: string,\n  instanceName: string,\n  action: string,\n): Promise<ActionResult> {\n  // Get current instance state\n  const [instance] = await client.get({\n    project: projectId,\n    zone,\n    instance: instanceName,\n  });\n\n  const status = instance.status as GCEInstanceState;\n\n  switch (action) {\n    case \"start\":\n      return startInstance(client, projectId, zone, instanceName, status);\n\n    case \"stop\":\n      return stopInstance(client, projectId, zone, instanceName, status);\n\n    case \"reset\":\n      return resetInstance(client, projectId, zone, instanceName, status);\n\n    default:\n      return {\n        success: false,\n        action,\n        error: `Unknown action: ${action}`,\n      };\n  }\n}\n\n/**\n * Start an instance\n */\nasync function startInstance(\n  client: InstancesClient,\n  projectId: string,\n  zone: string,\n  instanceName: string,\n  currentStatus: GCEInstanceState,\n): Promise<ActionResult> {\n  // Can only start stopped or terminated instances\n  if (currentStatus !== \"STOPPED\" && currentStatus !== \"TERMINATED\") {\n    return {\n      success: false,\n      action: \"start\",\n      error: `Cannot start instance in ${currentStatus} state. Instance must be STOPPED or TERMINATED.`,\n    };\n  }\n\n  const [operation] = await client.start({\n    project: projectId,\n    zone,\n    instance: instanceName,\n  });\n\n  return {\n    success: true,\n    action: \"start\",\n    operationName: (operation as any).latestResponse?.name || \"unknown\",\n  };\n}\n\n/**\n * Stop an instance\n */\nasync function stopInstance(\n  client: InstancesClient,\n  projectId: string,\n  zone: string,\n  instanceName: string,\n  currentStatus: GCEInstanceState,\n): Promise<ActionResult> {\n  // Can only stop running instances\n  if (currentStatus !== \"RUNNING\") {\n    return {\n      success: false,\n      action: \"stop\",\n      error: `Cannot stop instance in ${currentStatus} state. Instance must be RUNNING.`,\n    };\n  }\n\n  const [operation] = await client.stop({\n    project: projectId,\n    zone,\n    instance: instanceName,\n  });\n\n  return {\n    success: true,\n    action: \"stop\",\n    operationName: (operation as any).latestResponse?.name || \"unknown\",\n  };\n}\n\n/**\n * Reset an instance\n */\nasync function resetInstance(\n  client: InstancesClient,\n  projectId: string,\n  zone: string,\n  instanceName: string,\n  currentStatus: GCEInstanceState,\n): Promise<ActionResult> {\n  // Can only reset running instances\n  if (currentStatus !== \"RUNNING\") {\n    return {\n      success: false,\n      action: \"reset\",\n      error: `Cannot reset instance in ${currentStatus} state. Instance must be RUNNING.`,\n    };\n  }\n\n  const [operation] = await client.reset({\n    project: projectId,\n    zone,\n    instance: instanceName,\n  });\n\n  return {\n    success: true,\n    action: \"reset\",\n    operationName: (operation as any).latestResponse?.name || \"unknown\",\n  };\n}\n\n/**\n * Execute a global action\n */\nfunction executeGlobalAction(action: string): ActionResult {\n  switch (action) {\n    case \"refresh\":\n      // Refresh is a no-op for now - cache clearing would happen at provider level\n      return {\n        success: true,\n        action: \"refresh\",\n      };\n\n    default:\n      return {\n        success: false,\n        action,\n        error: `Unknown global action: ${action}`,\n      };\n  }\n}\n","/**\n * GCE Platform Reference\n *\n * Generates Google Cloud Console URLs for GCE resources.\n */\n\n/**\n * Platform reference containing console URL\n */\nexport interface GCEPlatformRef {\n  consoleUrl: string;\n}\n\n/**\n * Generate platform reference with GCP Console URL for an instance\n *\n * @param projectId - GCP project ID\n * @param zone - GCE zone\n * @param instanceName - Instance name\n * @returns Platform reference with console URL\n */\nexport function generateInstancePlatformRef(\n  projectId: string,\n  zone: string,\n  instanceName: string,\n): GCEPlatformRef {\n  return {\n    consoleUrl: `https://console.cloud.google.com/compute/instancesDetail/zones/${zone}/instances/${instanceName}?project=${projectId}`,\n  };\n}\n\n/**\n * Generate platform reference with GCP Console URL for instances list\n *\n * @param projectId - GCP project ID\n * @returns Platform reference with console URL\n */\nexport function generateInstancesListPlatformRef(projectId: string): GCEPlatformRef {\n  return {\n    consoleUrl: `https://console.cloud.google.com/compute/instances?project=${projectId}`,\n  };\n}\n","/**\n * AFS GCE Provider Types\n */\n\nimport { camelize, optionalize } from \"@aigne/afs/utils/zod\";\nimport { z } from \"zod\";\n\n/**\n * Configuration options for AFSGCE\n */\nexport interface AFSGCEOptions {\n  /** Module name (used as mount path segment) */\n  name?: string;\n\n  /** Module description */\n  description?: string;\n\n  /** GCP project ID */\n  projectId: string;\n\n  /** GCE zone (e.g., us-central1-a) */\n  zone: string;\n\n  /** Access mode */\n  accessMode?: \"readonly\" | \"readwrite\";\n\n  /** Path to service account key file */\n  keyFilename?: string;\n\n  /** Explicit credentials (for programmatic access) */\n  credentials?: {\n    clientEmail: string;\n    privateKey: string;\n  };\n\n  /** Cache TTL in seconds (0 = no cache) */\n  cacheTtl?: number;\n}\n\n/**\n * GCE zone validation regex\n * Format: region-zone (e.g., us-central1-a, europe-west1-b)\n */\nconst ZONE_REGEX = /^[a-z]+-[a-z]+\\d+-[a-z]$/;\n\n/**\n * Zod schema for options validation\n */\nexport const afsgceOptionsSchema = camelize(\n  z\n    .object({\n      name: optionalize(z.string()),\n      description: optionalize(z.string()),\n      projectId: z.string().min(1),\n      zone: z.string().regex(ZONE_REGEX, \"Invalid GCE zone format (e.g., us-central1-a)\"),\n      accessMode: optionalize(z.enum([\"readonly\", \"readwrite\"])),\n      keyFilename: optionalize(z.string()),\n      credentials: optionalize(\n        z.object({\n          clientEmail: z.string(),\n          privateKey: z.string(),\n        }),\n      ),\n      cacheTtl: optionalize(z.number().int().min(0)),\n    })\n    .strict(),\n);\n\n/**\n * GCE instance states\n */\nexport const GCE_INSTANCE_STATES = [\n  \"PROVISIONING\",\n  \"STAGING\",\n  \"RUNNING\",\n  \"STOPPING\",\n  \"STOPPED\",\n  \"SUSPENDING\",\n  \"SUSPENDED\",\n  \"TERMINATED\",\n] as const;\n\nexport type GCEInstanceState = (typeof GCE_INSTANCE_STATES)[number];\n\n/**\n * Path types for GCE resources\n */\nexport type PathType =\n  | \"root\"\n  | \"instances\"\n  | \"instance\"\n  | \"instance-metadata\"\n  | \"instance-actions\"\n  | \"instance-action\"\n  | \"actions\"\n  | \"global-action\"\n  | \"unknown\";\n\nexport interface ParsedPath {\n  type: PathType;\n  instanceName?: string;\n  action?: string;\n  fileName?: string;\n  raw: string;\n}\n\n/**\n * Kind constants for GCE resources\n */\nexport const KINDS = {\n  INSTANCE: \"gce:instance\",\n  ACTION: \"gce:action\",\n  EXECUTABLE: \"afs:executable\",\n  NODE: \"afs:node\",\n  GCP_RESOURCE: \"gcp:resource\",\n} as const;\n","/**\n * GCE List Operation\n *\n * Lists GCE resources.\n */\n\nimport type { AFSEntry, AFSListOptions, AFSListResult } from \"@aigne/afs\";\nimport type { InstancesClient } from \"@google-cloud/compute\";\nimport { mapGCEError } from \"../errors.js\";\nimport { buildPath, parsePath } from \"../path-resolver.js\";\nimport { generateInstancePlatformRef, generateInstancesListPlatformRef } from \"../platform-ref.js\";\nimport { type GCEInstanceState, KINDS } from \"../types.js\";\n\n/**\n * List GCE resources\n *\n * @param client - GCE InstancesClient\n * @param projectId - GCP project ID\n * @param zone - GCE zone\n * @param path - AFS path\n * @param options - List options\n * @returns List result with entries\n */\nexport async function list(\n  client: InstancesClient,\n  projectId: string,\n  zone: string,\n  path: string,\n  options?: AFSListOptions,\n): Promise<AFSListResult> {\n  try {\n    const parsed = parsePath(path);\n\n    switch (parsed.type) {\n      case \"root\":\n        return listRoot(projectId);\n\n      case \"instances\":\n        return listInstances(client, projectId, zone, options);\n\n      case \"instance\":\n        return listInstanceChildren(client, projectId, zone, parsed.instanceName!);\n\n      case \"instance-actions\":\n        return listInstanceActions(client, projectId, zone, parsed.instanceName!);\n\n      case \"actions\":\n        return listGlobalActions(projectId);\n\n      default:\n        return { data: [] };\n    }\n  } catch (error) {\n    throw mapGCEError(error);\n  }\n}\n\n/**\n * List root directory\n */\nfunction listRoot(projectId: string): AFSListResult {\n  const entries: AFSEntry[] = [\n    {\n      id: `gce://${projectId}/instances`,\n      path: \"/instances\",\n      metadata: {\n        kind: KINDS.NODE,\n        kinds: [KINDS.NODE],\n        childrenCount: 0,\n        description: \"GCE Instances\",\n        platformRef: generateInstancesListPlatformRef(projectId),\n      },\n    },\n    {\n      id: `gce://${projectId}/actions`,\n      path: \"/actions\",\n      metadata: {\n        kind: KINDS.NODE,\n        kinds: [KINDS.NODE],\n        childrenCount: 0,\n        description: \"Global Actions\",\n      },\n    },\n  ];\n\n  return { data: entries };\n}\n\n/**\n * List all instances\n */\nasync function listInstances(\n  client: InstancesClient,\n  projectId: string,\n  zone: string,\n  options?: AFSListOptions,\n): Promise<AFSListResult> {\n  const maxChildren = options?.maxChildren ?? 1000;\n\n  const [instances] = await client.list({\n    project: projectId,\n    zone,\n    maxResults: maxChildren,\n  });\n\n  const entries: AFSEntry[] = (instances || []).map((instance) => {\n    const name = instance.name!;\n    const machineType = instance.machineType?.split(\"/\").pop() || \"unknown\";\n\n    return {\n      id: `gce://${projectId}/${zone}/${name}`,\n      path: buildPath(\"instances\", name),\n      metadata: {\n        kind: KINDS.INSTANCE,\n        kinds: [KINDS.INSTANCE, KINDS.GCP_RESOURCE, KINDS.NODE],\n        childrenCount: 2, // metadata.json and actions\n        status: instance.status as GCEInstanceState,\n        machineType,\n        privateIp: instance.networkInterfaces?.[0]?.networkIP,\n        publicIp: instance.networkInterfaces?.[0]?.accessConfigs?.[0]?.natIP,\n        createdAt: instance.creationTimestamp,\n        labels: instance.labels,\n        platformRef: generateInstancePlatformRef(projectId, zone, name),\n      },\n    };\n  });\n\n  return { data: entries };\n}\n\n/**\n * List instance children (metadata.json, actions)\n */\nasync function listInstanceChildren(\n  client: InstancesClient,\n  projectId: string,\n  zone: string,\n  instanceName: string,\n): Promise<AFSListResult> {\n  // Verify instance exists\n  await client.get({\n    project: projectId,\n    zone,\n    instance: instanceName,\n  });\n\n  const entries: AFSEntry[] = [\n    {\n      id: `gce://${projectId}/${zone}/${instanceName}/metadata.json`,\n      path: buildPath(\"instances\", instanceName, \"metadata.json\"),\n      metadata: {\n        kind: KINDS.NODE,\n        kinds: [KINDS.NODE],\n        description: \"Instance metadata\",\n      },\n    },\n    {\n      id: `gce://${projectId}/${zone}/${instanceName}/actions`,\n      path: buildPath(\"instances\", instanceName, \"actions\"),\n      metadata: {\n        kind: KINDS.NODE,\n        kinds: [KINDS.NODE],\n        childrenCount: 0,\n        description: \"Instance actions\",\n      },\n    },\n  ];\n\n  return { data: entries };\n}\n\n/**\n * List available actions for an instance\n */\nasync function listInstanceActions(\n  client: InstancesClient,\n  projectId: string,\n  zone: string,\n  instanceName: string,\n): Promise<AFSListResult> {\n  const [instance] = await client.get({\n    project: projectId,\n    zone,\n    instance: instanceName,\n  });\n\n  const status = instance.status as GCEInstanceState;\n  const actions: string[] = [];\n\n  // Available actions depend on instance state\n  switch (status) {\n    case \"RUNNING\":\n      actions.push(\"stop\", \"reset\");\n      break;\n    case \"STOPPED\":\n    case \"TERMINATED\":\n      actions.push(\"start\");\n      break;\n    case \"SUSPENDED\":\n      actions.push(\"resume\");\n      break;\n    default:\n      // No actions available during transitional states\n      break;\n  }\n\n  const entries: AFSEntry[] = actions.map((action) => ({\n    id: `gce://${projectId}/${zone}/${instanceName}/actions/${action}`,\n    path: buildPath(\"instances\", instanceName, \"actions\", action),\n    metadata: {\n      kind: KINDS.ACTION,\n      kinds: [KINDS.ACTION, KINDS.EXECUTABLE, KINDS.NODE],\n      description: `${action.charAt(0).toUpperCase() + action.slice(1)} the instance`,\n    },\n  }));\n\n  return { data: entries };\n}\n\n/**\n * List global actions\n */\nfunction listGlobalActions(projectId: string): AFSListResult {\n  const entries: AFSEntry[] = [\n    {\n      id: `gce://${projectId}/actions/refresh`,\n      path: \"/actions/refresh\",\n      metadata: {\n        kind: KINDS.ACTION,\n        kinds: [KINDS.ACTION, KINDS.EXECUTABLE, KINDS.NODE],\n        description: \"Refresh instance cache\",\n      },\n    },\n  ];\n\n  return { data: entries };\n}\n","/**\n * GCE Read Operation\n *\n * Reads GCE resource data.\n */\n\nimport type { AFSReadOptions, AFSReadResult } from \"@aigne/afs\";\nimport type { InstancesClient } from \"@google-cloud/compute\";\nimport { mapGCEError } from \"../errors.js\";\nimport { buildPath, parsePath } from \"../path-resolver.js\";\nimport { KINDS } from \"../types.js\";\n\n/**\n * Read GCE resource data\n *\n * @param client - GCE InstancesClient\n * @param projectId - GCP project ID\n * @param zone - GCE zone\n * @param path - AFS path\n * @param options - Read options\n * @returns Read result with content\n */\nexport async function read(\n  client: InstancesClient,\n  projectId: string,\n  zone: string,\n  path: string,\n  _options?: AFSReadOptions,\n): Promise<AFSReadResult> {\n  try {\n    const parsed = parsePath(path);\n\n    switch (parsed.type) {\n      case \"instance-metadata\":\n        return readInstanceMetadata(client, projectId, zone, parsed.instanceName!);\n\n      default:\n        throw new Error(`Cannot read path: ${path}`);\n    }\n  } catch (error) {\n    throw mapGCEError(error);\n  }\n}\n\n/**\n * Read instance metadata as JSON\n */\nasync function readInstanceMetadata(\n  client: InstancesClient,\n  projectId: string,\n  zone: string,\n  instanceName: string,\n): Promise<AFSReadResult> {\n  const [instance] = await client.get({\n    project: projectId,\n    zone,\n    instance: instanceName,\n  });\n\n  // Return full instance data as JSON content\n  return {\n    data: {\n      id: `gce://${projectId}/${zone}/${instanceName}/metadata.json`,\n      path: buildPath(\"instances\", instanceName, \"metadata.json\"),\n      metadata: {\n        kind: KINDS.NODE,\n        kinds: [KINDS.NODE],\n        description: \"Instance metadata\",\n      },\n      content: JSON.stringify(instance, null, 2),\n    },\n  };\n}\n","/**\n * GCE Stat Operation\n *\n * Returns metadata for GCE resources.\n */\n\nimport type { AFSEntry } from \"@aigne/afs\";\nimport type { InstancesClient } from \"@google-cloud/compute\";\nimport { mapGCEError } from \"../errors.js\";\nimport { buildPath, parsePath } from \"../path-resolver.js\";\nimport { generateInstancePlatformRef, generateInstancesListPlatformRef } from \"../platform-ref.js\";\nimport { type GCEInstanceState, KINDS } from \"../types.js\";\n\n/**\n * Get metadata for a GCE resource\n *\n * @param client - GCE InstancesClient\n * @param projectId - GCP project ID\n * @param zone - GCE zone\n * @param path - AFS path\n * @returns Entry with metadata\n */\nexport async function stat(\n  client: InstancesClient,\n  projectId: string,\n  zone: string,\n  path: string,\n): Promise<AFSEntry> {\n  try {\n    const parsed = parsePath(path);\n\n    switch (parsed.type) {\n      case \"root\":\n        return statRoot(projectId);\n\n      case \"instances\":\n        return statInstances(projectId);\n\n      case \"instance\":\n        return statInstance(client, projectId, zone, parsed.instanceName!);\n\n      case \"instance-metadata\":\n        return statInstanceMetadata(client, projectId, zone, parsed.instanceName!);\n\n      case \"instance-actions\":\n        return statInstanceActions(client, projectId, zone, parsed.instanceName!);\n\n      case \"instance-action\":\n        return statInstanceAction(client, projectId, zone, parsed.instanceName!, parsed.action!);\n\n      case \"actions\":\n        return statGlobalActions(projectId);\n\n      case \"global-action\":\n        return statGlobalAction(projectId, parsed.action!);\n\n      default:\n        throw new Error(`Path not found: ${path}`);\n    }\n  } catch (error) {\n    throw mapGCEError(error);\n  }\n}\n\n/**\n * Stat root directory\n */\nfunction statRoot(projectId: string): AFSEntry {\n  return {\n    id: `gce://${projectId}/`,\n    path: \"/\",\n    metadata: {\n      kind: KINDS.NODE,\n      kinds: [KINDS.NODE],\n      childrenCount: 2,\n      description: \"GCE Root\",\n    },\n  };\n}\n\n/**\n * Stat instances directory\n */\nfunction statInstances(projectId: string): AFSEntry {\n  return {\n    id: `gce://${projectId}/instances`,\n    path: \"/instances\",\n    metadata: {\n      kind: KINDS.NODE,\n      kinds: [KINDS.NODE],\n      childrenCount: 0, // Dynamic\n      description: \"GCE Instances\",\n      platformRef: generateInstancesListPlatformRef(projectId),\n    },\n  };\n}\n\n/**\n * Stat a specific instance\n */\nasync function statInstance(\n  client: InstancesClient,\n  projectId: string,\n  zone: string,\n  instanceName: string,\n): Promise<AFSEntry> {\n  const [instance] = await client.get({\n    project: projectId,\n    zone,\n    instance: instanceName,\n  });\n\n  const machineType = instance.machineType?.split(\"/\").pop() || \"unknown\";\n\n  return {\n    id: `gce://${projectId}/${zone}/${instanceName}`,\n    path: buildPath(\"instances\", instanceName),\n    metadata: {\n      kind: KINDS.INSTANCE,\n      kinds: [KINDS.INSTANCE, KINDS.GCP_RESOURCE, KINDS.NODE],\n      childrenCount: 2, // metadata.json and actions\n      status: instance.status as GCEInstanceState,\n      machineType,\n      privateIp: instance.networkInterfaces?.[0]?.networkIP,\n      publicIp: instance.networkInterfaces?.[0]?.accessConfigs?.[0]?.natIP,\n      createdAt: instance.creationTimestamp,\n      labels: instance.labels,\n      platformRef: generateInstancePlatformRef(projectId, zone, instanceName),\n    },\n  };\n}\n\n/**\n * Stat instance metadata.json file\n */\nasync function statInstanceMetadata(\n  client: InstancesClient,\n  projectId: string,\n  zone: string,\n  instanceName: string,\n): Promise<AFSEntry> {\n  // Verify instance exists\n  await client.get({\n    project: projectId,\n    zone,\n    instance: instanceName,\n  });\n\n  return {\n    id: `gce://${projectId}/${zone}/${instanceName}/metadata.json`,\n    path: buildPath(\"instances\", instanceName, \"metadata.json\"),\n    metadata: {\n      kind: KINDS.NODE,\n      kinds: [KINDS.NODE],\n      description: \"Instance metadata\",\n    },\n  };\n}\n\n/**\n * Stat instance actions directory\n */\nasync function statInstanceActions(\n  client: InstancesClient,\n  projectId: string,\n  zone: string,\n  instanceName: string,\n): Promise<AFSEntry> {\n  // Verify instance exists\n  await client.get({\n    project: projectId,\n    zone,\n    instance: instanceName,\n  });\n\n  return {\n    id: `gce://${projectId}/${zone}/${instanceName}/actions`,\n    path: buildPath(\"instances\", instanceName, \"actions\"),\n    metadata: {\n      kind: KINDS.NODE,\n      kinds: [KINDS.NODE],\n      childrenCount: 0, // Dynamic based on state\n      description: \"Instance actions\",\n    },\n  };\n}\n\n/**\n * Stat a specific instance action\n */\nasync function statInstanceAction(\n  client: InstancesClient,\n  projectId: string,\n  zone: string,\n  instanceName: string,\n  action: string,\n): Promise<AFSEntry> {\n  // Verify instance exists\n  await client.get({\n    project: projectId,\n    zone,\n    instance: instanceName,\n  });\n\n  return {\n    id: `gce://${projectId}/${zone}/${instanceName}/actions/${action}`,\n    path: buildPath(\"instances\", instanceName, \"actions\", action),\n    metadata: {\n      kind: KINDS.ACTION,\n      kinds: [KINDS.ACTION, KINDS.EXECUTABLE, KINDS.NODE],\n      description: `${action.charAt(0).toUpperCase() + action.slice(1)} the instance`,\n    },\n  };\n}\n\n/**\n * Stat global actions directory\n */\nfunction statGlobalActions(projectId: string): AFSEntry {\n  return {\n    id: `gce://${projectId}/actions`,\n    path: \"/actions\",\n    metadata: {\n      kind: KINDS.NODE,\n      kinds: [KINDS.NODE],\n      childrenCount: 1,\n      description: \"Global Actions\",\n    },\n  };\n}\n\n/**\n * Stat a specific global action\n */\nfunction statGlobalAction(projectId: string, action: string): AFSEntry {\n  return {\n    id: `gce://${projectId}/actions/${action}`,\n    path: buildPath(\"actions\", action),\n    metadata: {\n      kind: KINDS.ACTION,\n      kinds: [KINDS.ACTION, KINDS.EXECUTABLE, KINDS.NODE],\n      description: `${action.charAt(0).toUpperCase() + action.slice(1)} action`,\n    },\n  };\n}\n","/**\n * AFS GCE Provider\n *\n * Provides AFS access to Google Compute Engine instances.\n */\n\nimport type {\n  AFSListOptions,\n  AFSListResult,\n  AFSModule,\n  AFSReadOptions,\n  AFSReadResult,\n  AFSStatResult,\n  AFSWriteEntryPayload,\n  AFSWriteOptions,\n  AFSWriteResult,\n} from \"@aigne/afs\";\nimport { InstancesClient } from \"@google-cloud/compute\";\nimport { mapGCEError } from \"./errors.js\";\nimport { executeAction } from \"./operations/actions.js\";\nimport { list } from \"./operations/list.js\";\nimport { read } from \"./operations/read.js\";\nimport { stat } from \"./operations/stat.js\";\nimport { parsePath } from \"./path-resolver.js\";\nimport { type AFSGCEOptions, afsgceOptionsSchema, KINDS } from \"./types.js\";\n\n/**\n * AFS GCE Provider\n *\n * Provides a file-system-like interface to GCE instances.\n *\n * @example\n * ```typescript\n * const provider = new AFSGCE({\n *   projectId: 'my-project',\n *   zone: 'us-central1-a',\n * });\n *\n * // List instances\n * const instances = await provider.list('/instances');\n *\n * // Get instance metadata\n * const metadata = await provider.read('/instances/my-vm/metadata.json');\n *\n * // Start an instance (requires readwrite mode)\n * await provider.write('/instances/my-vm/actions/start', {});\n * ```\n */\nexport class AFSGCE implements AFSModule {\n  readonly name: string;\n  readonly description?: string;\n  readonly accessMode: \"readonly\" | \"readwrite\";\n\n  private readonly client: InstancesClient;\n  private readonly projectId: string;\n  private readonly zone: string;\n\n  constructor(options: AFSGCEOptions) {\n    // Validate options\n    const validated = afsgceOptionsSchema.parse(options);\n\n    this.name = validated.name || \"gce\";\n    this.description = validated.description;\n    this.accessMode = validated.accessMode || \"readonly\";\n    this.projectId = validated.projectId;\n    this.zone = validated.zone;\n\n    // Create compute client\n    this.client = new InstancesClient({\n      keyFilename: validated.keyFilename,\n      credentials: validated.credentials\n        ? {\n            client_email: validated.credentials.clientEmail,\n            private_key: validated.credentials.privateKey,\n          }\n        : undefined,\n    });\n  }\n\n  /**\n   * List GCE resources\n   */\n  async list(path: string, options?: AFSListOptions): Promise<AFSListResult> {\n    return list(this.client, this.projectId, this.zone, path, options);\n  }\n\n  /**\n   * Get metadata for a GCE resource\n   */\n  async stat(path: string): Promise<AFSStatResult> {\n    const entry = await stat(this.client, this.projectId, this.zone, path);\n    return {\n      data: {\n        path: entry.path,\n        childrenCount: entry.metadata?.childrenCount as number | undefined,\n        meta: entry.metadata as Record<string, unknown>,\n      },\n    };\n  }\n\n  /**\n   * Read GCE resource data\n   */\n  async read(path: string, options?: AFSReadOptions): Promise<AFSReadResult> {\n    return read(this.client, this.projectId, this.zone, path, options);\n  }\n\n  /**\n   * Write/execute action on GCE resource\n   *\n   * In GCE, write is used to execute actions (start, stop, reset)\n   */\n  async write(\n    path: string,\n    _content: AFSWriteEntryPayload,\n    _options?: AFSWriteOptions,\n  ): Promise<AFSWriteResult> {\n    if (this.accessMode !== \"readwrite\") {\n      throw mapGCEError(new Error(\"Write operations require readwrite access mode\"));\n    }\n\n    const parsed = parsePath(path);\n\n    if (parsed.type === \"instance-action\" || parsed.type === \"global-action\") {\n      const result = await executeAction(this.client, this.projectId, this.zone, path);\n\n      // Convert ActionResult to AFSWriteResult\n      return {\n        data: {\n          id: `gce://${this.projectId}/${this.zone}/${path}`,\n          path,\n          metadata: {\n            kind: KINDS.ACTION,\n            kinds: [KINDS.ACTION, KINDS.EXECUTABLE, KINDS.NODE],\n            success: result.success,\n            operationName: result.operationName,\n            error: result.error,\n          },\n        },\n        message: result.success\n          ? `Action ${result.action} executed successfully`\n          : `Action ${result.action} failed: ${result.error}`,\n      };\n    }\n\n    throw mapGCEError(new Error(`Cannot write to path: ${path}`));\n  }\n}\n\n// Re-export types\nexport type { AFSGCEOptions } from \"./types.js\";\nexport { afsgceOptionsSchema } from \"./types.js\";\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@aigne/afs-gce",
+  "version": "1.11.0-beta.6",
+  "description": "AIGNE AFS module for Google Compute Engine resources",
+  "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": {
+    "@google-cloud/compute": "^4.10.0",
+    "zod": "^3.25.67",
+    "@aigne/afs": "^1.11.0-beta.6"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.6",
+    "npm-run-all": "^4.1.5",
+    "rimraf": "^6.1.2",
+    "tsdown": "0.20.0-beta.3",
+    "typescript": "5.9.2",
+    "@aigne/scripts": "0.0.0",
+    "@aigne/typescript-config": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "check-types": "tsc --noEmit",
+    "clean": "rimraf dist coverage",
+    "test": "SKIP_E2E=1 bun test",
+    "test:e2e": "GOOGLE_APPLICATION_CREDENTIALS=${GOOGLE_APPLICATION_CREDENTIALS:-} bun test test/e2e.test.ts",
+    "test:all": "bun test",
+    "test:coverage": "bun test --coverage --coverage-reporter=lcov --coverage-reporter=text"
+  }
+}