npm - @aigne/afs-gce - Versions diffs - 1.11.0-beta.11 → 1.11.0-beta.12 - Mend

@aigne/afs-gce 1.11.0-beta.11 → 1.11.0-beta.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/dist/index.d.mts CHANGED Viewed

@@ -1,4 +1,4 @@
-import { AFSAccessMode, AFSBaseProvider, AFSDeleteResult, AFSEntry, AFSExecResult, AFSExplainResult, AFSListResult, AFSModuleLoadParams, AFSStatResult, AFSWriteEntryPayload, AFSWriteResult, ProviderManifest, RouteContext } from "@aigne/afs";
+import { AFSAccessMode, AFSBaseProvider, AFSDeleteResult, AFSEntry, AFSExecResult, AFSExplainResult, AFSListResult, AFSModuleLoadParams, AFSStatResult, AFSWriteEntryPayload, AFSWriteResult, ProviderManifest, ProviderTreeSchema, RouteContext } from "@aigne/afs";
 import { z } from "zod";
 //#region src/types.d.ts
@@ -29,31 +29,7 @@ interface AFSGCEOptions {
 /**
  * Zod schema for options validation
  */
-declare const afsgceOptionsSchema: z.ZodType<{
-  name: string | undefined;
-  description: string | undefined;
-  projectId: string;
-  zone: string;
-  accessMode: "readonly" | "readwrite" | undefined;
-  keyFilename: string | undefined;
-  credentials: {
-    clientEmail: string;
-    privateKey: string;
-  } | undefined;
-  cacheTtl: number | undefined;
-}, unknown, z.core.$ZodTypeInternals<{
-  name: string | undefined;
-  description: string | undefined;
-  projectId: string;
-  zone: string;
-  accessMode: "readonly" | "readwrite" | undefined;
-  keyFilename: string | undefined;
-  credentials: {
-    clientEmail: string;
-    privateKey: string;
-  } | undefined;
-  cacheTtl: number | undefined;
-}, unknown>>;
+declare const afsgceOptionsSchema: z.ZodType<AFSGCEOptions>;
 //#endregion
 //#region src/index.d.ts
 /**
@@ -91,35 +67,15 @@ declare class AFSGCE extends AFSBaseProvider {
     token?: string;
     auth?: unknown;
   });
-  static schema(): z.ZodType<{
-    name: string | undefined;
-    description: string | undefined;
-    projectId: string;
-    zone: string;
-    accessMode: "readonly" | "readwrite" | undefined;
-    keyFilename: string | undefined;
-    credentials: {
-      clientEmail: string;
-      privateKey: string;
-    } | undefined;
-    cacheTtl: number | undefined;
-  }, unknown, z.core.$ZodTypeInternals<{
-    name: string | undefined;
-    description: string | undefined;
-    projectId: string;
-    zone: string;
-    accessMode: "readonly" | "readwrite" | undefined;
-    keyFilename: string | undefined;
-    credentials: {
-      clientEmail: string;
-      privateKey: string;
-    } | undefined;
-    cacheTtl: number | undefined;
-  }, unknown>>;
+  static schema(): z.ZodType<AFSGCEOptions, unknown, z.core.$ZodTypeInternals<AFSGCEOptions, unknown>>;
   /**
    * Provider manifest for URI-based discovery
    */
   static manifest(): ProviderManifest;
+  /**
+   * Tree schema for progressive disclosure
+   */
+  static treeSchema(): ProviderTreeSchema;
   static load({
     basePath,
     config

package/dist/index.d.mts.map CHANGED Viewed

	@@ -1 +1 @@
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;~~EAgB4B~~;~~EAZ9B~~,QAAA;AAAA;;;;cAYW,mBAAA,~~EAAmB~~,CAAA,~~CAAA~~,OAAA~~;;;;;;;;;;;;YAkB/B~~,~~CAAA~~,~~CAAA,IAAA,CAAA,iBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;AAlBD~~;;;;;;;;;;;;~~cC2Ca~~,MAAA,SAAe,eAAA;EAAA,SACR,IAAA;EAAA,SACA,WAAA;EAAA,SACA,UAAA,EAAY,aAAA;EAAA,iBAEb,MAAA;EAAA,iBACA,SAAA;EAAA,iBACA,IAAA;cAEL,OAAA,EAAS,aAAA;IAAkB,GAAA;IAAc,KAAA;IAAgB,IAAA;EAAA;EAAA,OAyB9D,MAAA,CAAA,GAAM,CAAA,CAAA,OAAA~~;;;;;;;;;;;;;;;;;;;;;;;;;EA6EuB~~;;;EAAA,~~OAtE7B~~,QAAA,CAAA,GAAY,gBAAA;EAAA,~~OAgBN~~,IAAA,CAAA;IAAO,QAAA;IAAU;EAAA,IAAU,mBAAA,GAA2B,OAAA,CAAQ,MAAA;EAAA,QAO7D,WAAA;EAAA,QAaA,gBAAA;EAAA,QASN,kBAAA;EAyBF,QAAA,CAAS,IAAA,EAAM,YAAA,GAAe,OAAA,CAAQ,aAAA;EA6BtC,aAAA,CAAc,IAAA,EAAM,YAAA,GAAe,OAAA,CAAQ,aAAA;EAc3C,oBAAA,CACJ,GAAA,EAAK,YAAA;IAAe,UAAA;IAAoB,MAAA;EAAA,KACvC,OAAA,CAAQ,aAAA;EA8BL,kBAAA,CACJ,GAAA,EAAK,YAAA;IAAe,UAAA;IAAoB,MAAA;EAAA,KACvC,OAAA,CAAQ,aAAA;EAiBL,YAAA,CAAa,IAAA,EAAM,YAAA,GAAe,OAAA,CAAQ,aAAA;EAgB1C,kBAAA,CAAmB,GAAA,EAAK,YAAA;IAAe,MAAA;EAAA,KAAoB,OAAA,CAAQ,aAAA;EAmBnE,gBAAA,CAAiB,IAAA,EAAM,YAAA,GAAe,OAAA,CAAQ,QAAA;EAqE9C,oBAAA,CACJ,GAAA,EAAK,YAAA;IAAe,UAAA;IAAoB,MAAA;EAAA,KACvC,OAAA,CAAQ,QAAA;EAqBL,iBAAA,CACJ,GAAA,EAAK,YAAA;IAAe,UAAA;IAAoB,QAAA;IAAkB,MAAA;EAAA,KACzD,OAAA,CAAQ,QAAA;EAoBL,QAAA,CAAS,GAAA,EAAK,YAAA,GAAe,OAAA,CAAQ,QAAA;EAcrC,aAAA,CAAc,GAAA,EAAK,YAAA,GAAe,OAAA,CAAQ,QAAA;EAgB1C,YAAA,CACJ,GAAA,EAAK,YAAA;IAAe,UAAA;IAAoB,MAAA;EAAA,KACvC,OAAA,CAAQ,QAAA;EAiCL,QAAA,CAAS,GAAA,EAAK,YAAA,GAAe,OAAA,CAAQ,aAAA;EAMrC,aAAA,CAAc,GAAA,EAAK,YAAA,GAAe,OAAA,CAAQ,aAAA;EAO1C,YAAA,CACJ,GAAA,EAAK,YAAA;IAAe,UAAA;IAAoB,MAAA;EAAA,KACvC,OAAA,CAAQ,aAAA;EASL,kBAAA,CACJ,GAAA,EAAK,YAAA;IAAe,UAAA;IAAoB,QAAA;IAAkB,MAAA;EAAA,IAC1D,OAAA,EAAS,oBAAA,GACR,OAAA,CAAQ,cAAA;EAsCL,mBAAA,CACJ,GAAA,EAAK,YAAA;IAAe,UAAA;IAAoB,QAAA;IAAkB,MAAA;EAAA,KACzD,OAAA,CAAQ,eAAA;EAwCL,iBAAA,CAAkB,GAAA,EAAK,YAAA,GAAe,OAAA,CAAQ,aAAA;EAkB9C,aAAA,CAAc,IAAA,EAAM,YAAA,EAAc,KAAA,EAAO,MAAA,oBAA0B,OAAA,CAAQ,aAAA;EAM3E,mBAAA,CACJ,GAAA,EAAK,YAAA;IAAe,UAAA;IAAoB,MAAA;EAAA,KACvC,OAAA,CAAQ,aAAA;EAsCL,mBAAA,CACJ,GAAA,EAAK,YAAA;IAAe,UAAA;IAAoB,MAAA;EAAA,IACxC,KAAA,EAAO,MAAA,oBACN,OAAA,CAAQ,aAAA;EAgCL,kBAAA,CACJ,GAAA,EAAK,YAAA;IAAe,UAAA;IAAoB,MAAA;EAAA,IACxC,KAAA,EAAO,MAAA,oBACN,OAAA,CAAQ,aAAA;EAgCL,mBAAA,CACJ,GAAA,EAAK,YAAA;IAAe,UAAA;IAAoB,MAAA;EAAA,IACxC,KAAA,EAAO,MAAA,oBACN,OAAA,CAAQ,aAAA;EAiCL,WAAA,CAAY,IAAA,EAAM,YAAA,GAAe,OAAA,CAAQ,gBAAA;EAwCzC,eAAA,CACJ,GAAA,EAAK,YAAA;IAAe,UAAA;IAAoB,MAAA;EAAA,KACvC,OAAA,CAAQ,gBAAA;AAAA"}
1	+ {"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/index.ts"],"mappings":"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"}

package/dist/index.mjs CHANGED Viewed

@@ -39,7 +39,17 @@ const ZONE_REGEX = /^[a-z]+-[a-z]+\d+-[a-z]$/;
 /**
 * Zod schema for options validation
 */
-const afsgceOptionsSchema = camelize(z.object({
+const afsgceOptionsSchema = z.preprocess((v) => {
+	if (v && typeof v === "object" && !Array.isArray(v)) {
+		const obj = { ...v };
+		if (obj.project && !obj.projectId) {
+			obj.projectId = obj.project;
+			delete obj.project;
+		}
+		return obj;
+	}
+	return v;
+}, camelize(z.object({
 	name: optionalize(z.string()),
 	description: optionalize(z.string()),
 	projectId: z.string().min(1),
@@ -51,7 +61,7 @@ const afsgceOptionsSchema = camelize(z.object({
 		privateKey: z.string()
 	})),
 	cacheTtl: optionalize(z.number().int().min(0))
-}).strict());
+}).strict()));
 /**
 * GCE instance states
 */
@@ -163,7 +173,7 @@ var AFSGCE = class AFSGCE extends AFSBaseProvider {
 			name: "gce",
 			description: "Google Compute Engine VM instances in a project/zone.\n- List and inspect instances, view metadata, labels, and network config\n- Exec actions: `start`, `stop`, `restart`, `delete`\n- Path structure: `/instances/{instance-name}`",
 			uriTemplate: "gce://{project}/{zone}",
-			category: "cloud-compute",
+			category: "compute",
 			schema: z.object({
 				project: z.string(),
 				zone: z.string(),
@@ -174,7 +184,100 @@ var AFSGCE = class AFSGCE extends AFSBaseProvider {
 				"gce",
 				"cloud",
 				"compute"
-			]
+			],
+			capabilityTags: [
+				"read-write",
+				"search",
+				"destructive",
+				"auth:gcp",
+				"remote",
+				"cloud",
+				"http"
+			],
+			security: {
+				riskLevel: "external",
+				resourceAccess: ["cloud-api"],
+				requires: ["cloud-credentials"],
+				dataSensitivity: ["system-config"],
+				notes: ["Can start, stop, restart, and delete GCE instances"]
+			},
+			capabilities: {
+				network: {
+					egress: true,
+					allowedDomains: ["*.googleapis.com"]
+				},
+				secrets: ["gcp/credentials"]
+			}
+		};
+	}
+	/**
+	* Tree schema for progressive disclosure
+	*/
+	static treeSchema() {
+		return {
+			operations: [
+				"list",
+				"read",
+				"write",
+				"delete",
+				"exec",
+				"stat",
+				"explain"
+			],
+			tree: {
+				"/": {
+					kind: "compute:root",
+					operations: [
+						"list",
+						"read",
+						"exec"
+					],
+					actions: ["refresh"]
+				},
+				"/instances": {
+					kind: "compute:collection",
+					operations: ["list", "read"]
+				},
+				"/instances/{instanceName}": {
+					kind: "compute:instance",
+					operations: [
+						"list",
+						"read",
+						"exec"
+					],
+					actions: [
+						"start",
+						"stop",
+						"reset"
+					]
+				},
+				"/instances/{instanceName}/metadata.json": {
+					kind: "compute:metadata",
+					operations: ["read"]
+				},
+				"/instances/{instanceName}/labels/{labelKey}": {
+					kind: "compute:label",
+					operations: [
+						"read",
+						"write",
+						"delete"
+					]
+				},
+				"/by-status/{status}": {
+					kind: "compute:status-filter",
+					operations: ["list", "read"]
+				}
+			},
+			auth: {
+				type: "gcp",
+				env: ["GOOGLE_APPLICATION_CREDENTIALS"]
+			},
+			bestFor: [
+				"VM management",
+				"instance lifecycle",
+				"cloud inventory"
+			],
+			notFor: ["file storage", "databases"]
 		};
 	}
 	static async load({ basePath, config } = {}) {

package/dist/index.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.mjs","names":[],"sources":["../src/platform-ref.ts","../src/types.ts","../src/index.ts"],"sourcesContent":["/*\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 AFS GCE Provider\n \n GCE provider using AFSBaseProvider decorator routing pattern.\n * Provides file-system-like access to Google Compute Engine instances.\n /\n\nimport {\n type ActionCatalog,\n type ActionDefinition,\n Actions,\n type AFSAccessMode,\n AFSBaseProvider,\n type AFSDeleteResult,\n type AFSEntry,\n type AFSExecResult,\n type AFSExplainResult,\n type AFSListResult,\n type AFSModuleClass,\n type AFSModuleLoadParams,\n AFSNotFoundError,\n AFSReadonlyError,\n type AFSStatResult,\n type AFSWriteEntryPayload,\n type AFSWriteResult,\n type CapabilitiesManifest,\n Delete,\n Explain,\n List,\n Meta,\n type ProviderManifest,\n Read,\n type RouteContext,\n Stat,\n Write,\n} from \"@aigne/afs\";\nimport { zodParse } from \"@aigne/afs/utils/zod\";\nimport { InstancesClient } from \"@google-cloud/compute\";\nimport { joinURL } from \"ufo\";\nimport { z } from \"zod\";\nimport { generateInstancePlatformRef, generateInstancesListPlatformRef } from \"./platform-ref.js\";\nimport {\n type AFSGCEOptions,\n afsgceOptionsSchema,\n GCE_INSTANCE_STATES,\n type GCEInstanceState,\n KINDS,\n} from \"./types.js\";\n\n/\n Map GCE SDK errors to appropriate AFS errors\n /\nfunction mapGCEError(error: unknown, path?: string): Error {\n if (error instanceof AFSNotFoundError \|\| error instanceof AFSReadonlyError) {\n return error;\n }\n if (typeof error === \"object\" && error !== null && \"code\" in error) {\n const err = error as { code: number; message?: string };\n if (err.code === 404) {\n return new AFSNotFoundError(path ?? \"/\", err.message);\n }\n }\n if (error instanceof Error) {\n return error;\n }\n return new Error(String(error));\n}\n\n/\n AFSGCE Provider using AFSBaseProvider pattern\n \n Provides file-system-like access to GCE instances.\n * Uses decorator routing (@List, @Read, @Write, @Delete, @Meta, @Actions, @Explain).\n \n @example\n * ```typescript\n * const gce = new AFSGCE({\n * projectId: \"my-project\",\n * zone: \"us-central1-a\",\n * });\n \n // Mount to AFS\n * afs.mount(gce);\n \n // List instances\n * const result = await afs.list(\"/modules/gce/instances\");\n \n // Read instance metadata\n * const meta = await afs.read(\"/modules/gce/instances/my-vm/metadata.json\");\n * ```\n /\nexport class AFSGCE extends AFSBaseProvider {\n override readonly name: string;\n override readonly description?: string;\n override readonly accessMode: AFSAccessMode;\n\n private readonly client: InstancesClient;\n private readonly projectId: string;\n private readonly zone: string;\n\n constructor(options: AFSGCEOptions & { uri?: string; token?: string; auth?: unknown }) {\n super();\n\n // Strip registry-injected keys before strict schema validation\n const { uri: _uri, token: _token, auth: _auth, ...cleanOptions } = options as any;\n\n const validated = afsgceOptionsSchema.parse(cleanOptions);\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 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 static schema() {\n return afsgceOptionsSchema;\n }\n\n /\n Provider manifest for URI-based discovery\n /\n static manifest(): ProviderManifest {\n return {\n name: \"gce\",\n description:\n \"Google Compute Engine VM instances in a project/zone.\\n- List and inspect instances, view metadata, labels, and network config\\n- Exec actions: `start`, `stop`, `restart`, `delete`\\n- Path structure: `/instances/{instance-name}`\",\n uriTemplate: \"gce://{project}/{zone}\",\n category: \"cloud-compute\",\n schema: z.object({\n project: z.string(),\n zone: z.string(),\n keyFilename: z.string().optional(),\n }),\n tags: [\"gcp\", \"gce\", \"cloud\", \"compute\"],\n };\n }\n\n static async load({ basePath, config }: AFSModuleLoadParams = {}): Promise<AFSGCE> {\n const options = zodParse(afsgceOptionsSchema, config, { prefix: basePath });\n return new AFSGCE(options);\n }\n\n // ========== Helper Methods ==========\n\n private async getInstance(instanceName: string) {\n try {\n const [instance] = await this.client.get({\n project: this.projectId,\n zone: this.zone,\n instance: instanceName,\n });\n return instance;\n } catch (error) {\n throw mapGCEError(error, joinURL(\"/instances\", instanceName));\n }\n }\n\n private async listAllInstances(maxResults?: number) {\n const [instances] = await this.client.list({\n project: this.projectId,\n zone: this.zone,\n maxResults: maxResults ?? 1000,\n });\n return instances \|\| [];\n }\n\n private buildInstanceEntry(instance: any, basePath: string): AFSEntry {\n const name = instance.name!;\n const machineType = instance.machineType?.split(\"/\").pop() \|\| \"unknown\";\n\n return {\n id: `gce://${this.projectId}/${this.zone}/${name}`,\n path: joinURL(basePath, name),\n meta: {\n kind: KINDS.INSTANCE,\n kinds: [KINDS.INSTANCE, KINDS.GCP_RESOURCE, KINDS.NODE],\n childrenCount: -1,\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(this.projectId, this.zone, name),\n },\n };\n }\n\n // ========== List Operations ==========\n\n @List(\"/\")\n async listRoot(_ctx: RouteContext): Promise<AFSListResult> {\n return {\n data: [\n {\n id: `gce://${this.projectId}/instances`,\n path: \"/instances\",\n meta: {\n kind: KINDS.NODE,\n kinds: [KINDS.NODE],\n childrenCount: -1,\n description: \"GCE Instances\",\n platformRef: generateInstancesListPlatformRef(this.projectId),\n },\n },\n {\n id: `gce://${this.projectId}/by-status`,\n path: \"/by-status\",\n meta: {\n kind: KINDS.NODE,\n kinds: [KINDS.NODE],\n childrenCount: GCE_INSTANCE_STATES.length,\n description: \"Instances grouped by status\",\n },\n },\n ],\n };\n }\n\n @List(\"/instances\")\n async listInstances(_ctx: RouteContext): Promise<AFSListResult> {\n try {\n const instances = await this.listAllInstances();\n const entries = instances.map((instance: any) =>\n this.buildInstanceEntry(instance, \"/instances\"),\n );\n return { data: entries };\n } catch (error) {\n throw mapGCEError(error, \"/instances\");\n }\n }\n\n @List(\"/instances/:instanceId\")\n @List(\"/by-status/:status/:instanceId\")\n async listInstanceChildren(\n ctx: RouteContext<{ instanceId: string; status?: string }>,\n ): Promise<AFSListResult> {\n await this.getInstance(ctx.params.instanceId);\n\n return {\n data: [\n {\n id: `gce://${this.projectId}/${this.zone}/${ctx.params.instanceId}/metadata.json`,\n path: joinURL(ctx.path, \"metadata.json\"),\n meta: {\n kind: KINDS.NODE,\n kinds: [KINDS.NODE],\n description: \"Instance metadata\",\n },\n },\n {\n id: `gce://${this.projectId}/${this.zone}/${ctx.params.instanceId}/labels`,\n path: joinURL(ctx.path, \"labels\"),\n meta: {\n kind: KINDS.NODE,\n kinds: [KINDS.NODE],\n childrenCount: -1,\n description: \"Instance labels\",\n },\n },\n ],\n };\n }\n\n @List(\"/instances/:instanceId/labels\")\n @List(\"/by-status/:status/:instanceId/labels\")\n async listInstanceLabels(\n ctx: RouteContext<{ instanceId: string; status?: string }>,\n ): Promise<AFSListResult> {\n const instance = await this.getInstance(ctx.params.instanceId);\n const labels = instance.labels \|\| {};\n\n const entries: AFSEntry[] = Object.entries(labels).map(([key, value]) => ({\n id: `gce://${this.projectId}/${this.zone}/${ctx.params.instanceId}/labels/${key}`,\n path: joinURL(ctx.path, encodeURIComponent(key)),\n content: value,\n meta: {\n kind: \"gce:label\",\n },\n }));\n\n return { data: entries };\n }\n\n @List(\"/by-status\")\n async listByStatus(_ctx: RouteContext): Promise<AFSListResult> {\n const entries: AFSEntry[] = GCE_INSTANCE_STATES.map((status) => ({\n id: `gce://${this.projectId}/by-status/${status.toLowerCase()}`,\n path: joinURL(\"/by-status\", status.toLowerCase()),\n meta: {\n kind: KINDS.NODE,\n kinds: [KINDS.NODE],\n childrenCount: -1,\n description: `Instances in ${status} state`,\n },\n }));\n\n return { data: entries };\n }\n\n @List(\"/by-status/:status\")\n async listByStatusFilter(ctx: RouteContext<{ status: string }>): Promise<AFSListResult> {\n try {\n const statusUpper = ctx.params.status.toUpperCase();\n const instances = await this.listAllInstances();\n const filtered = instances.filter(\n (inst: any) => (inst.status as string)?.toUpperCase() === statusUpper,\n );\n\n const entries = filtered.map((instance: any) => this.buildInstanceEntry(instance, ctx.path));\n\n return { data: entries };\n } catch (error) {\n throw mapGCEError(error, ctx.path);\n }\n }\n\n // ========== Read Operations ==========\n\n @Read(\"/.meta/.capabilities\")\n async readCapabilities(_ctx: RouteContext): Promise<AFSEntry> {\n const actionCatalogs: ActionCatalog[] = [];\n\n const instanceActions: ActionDefinition[] = [\n {\n name: \"start\",\n description: \"Start a stopped or terminated instance\",\n inputSchema: { type: \"object\", properties: {} },\n },\n {\n name: \"stop\",\n description: \"Stop a running instance\",\n inputSchema: { type: \"object\", properties: {} },\n },\n {\n name: \"reset\",\n description: \"Reset (hard reboot) a running instance\",\n inputSchema: { type: \"object\", properties: {} },\n },\n ];\n\n actionCatalogs.push({\n kind: \"gce:instance\",\n description: \"Instance lifecycle operations\",\n catalog: instanceActions,\n discovery: {\n pathTemplate: \"/instances/:instanceName/.actions\",\n note: \"Replace :instanceName with actual instance name\",\n },\n });\n\n if (this.accessMode === \"readwrite\") {\n actionCatalogs.push({\n kind: \"gce:global\",\n description: \"Global GCE operations\",\n catalog: [\n {\n name: \"refresh\",\n description: \"Refresh cached instance data\",\n inputSchema: { type: \"object\", properties: {} },\n },\n ],\n discovery: {\n pathTemplate: \"/.actions\",\n note: \"Available at provider root\",\n },\n });\n }\n\n const manifest: CapabilitiesManifest = {\n schemaVersion: 1,\n provider: this.name,\n version: \"1.0.0\",\n description: this.description,\n tools: [],\n actions: actionCatalogs,\n operations: this.getOperationsDeclaration(),\n };\n\n return {\n id: \"/.meta/.capabilities\",\n path: \"/.meta/.capabilities\",\n content: manifest,\n meta: { kind: \"afs:capabilities\" },\n };\n }\n\n @Read(\"/instances/:instanceId/metadata.json\")\n @Read(\"/by-status/:status/:instanceId/metadata.json\")\n async readInstanceMetadata(\n ctx: RouteContext<{ instanceId: string; status?: string }>,\n ): Promise<AFSEntry> {\n try {\n const instance = await this.getInstance(ctx.params.instanceId);\n\n return {\n id: `gce://${this.projectId}/${this.zone}/${ctx.params.instanceId}/metadata.json`,\n path: ctx.path,\n meta: {\n kind: KINDS.NODE,\n kinds: [KINDS.NODE],\n description: \"Instance metadata\",\n },\n content: JSON.stringify(instance, null, 2),\n };\n } catch (error) {\n throw mapGCEError(error, ctx.path);\n }\n }\n\n @Read(\"/instances/:instanceId/labels/:labelKey\")\n @Read(\"/by-status/:status/:instanceId/labels/:labelKey\")\n async readInstanceLabel(\n ctx: RouteContext<{ instanceId: string; labelKey: string; status?: string }>,\n ): Promise<AFSEntry> {\n const instance = await this.getInstance(ctx.params.instanceId);\n const labels = instance.labels \|\| {};\n const value = labels[ctx.params.labelKey];\n\n if (value === undefined) {\n throw new AFSNotFoundError(ctx.path);\n }\n\n return {\n id: `gce://${this.projectId}/${this.zone}/${ctx.params.instanceId}/labels/${ctx.params.labelKey}`,\n path: ctx.path,\n content: value,\n meta: { kind: \"gce:label\" },\n };\n }\n\n // ========== Meta Operations ==========\n\n @Meta(\"/\")\n async metaRoot(ctx: RouteContext): Promise<AFSEntry> {\n return {\n id: `gce://${this.projectId}/`,\n path: ctx.path,\n meta: {\n kind: KINDS.NODE,\n kinds: [KINDS.NODE],\n childrenCount: 2,\n description: \"GCE Root\",\n },\n };\n }\n\n @Meta(\"/instances\")\n async metaInstances(ctx: RouteContext): Promise<AFSEntry> {\n return {\n id: `gce://${this.projectId}/instances`,\n path: ctx.path,\n meta: {\n kind: KINDS.NODE,\n kinds: [KINDS.NODE],\n childrenCount: -1,\n description: \"GCE Instances\",\n platformRef: generateInstancesListPlatformRef(this.projectId),\n },\n };\n }\n\n @Meta(\"/instances/:instanceId\")\n @Meta(\"/by-status/:status/:instanceId\")\n async metaInstance(\n ctx: RouteContext<{ instanceId: string; status?: string }>,\n ): Promise<AFSEntry> {\n try {\n const instance = await this.getInstance(ctx.params.instanceId);\n const machineType = instance.machineType?.split(\"/\").pop() \|\| \"unknown\";\n\n return {\n id: `gce://${this.projectId}/${this.zone}/${ctx.params.instanceId}`,\n path: ctx.path,\n meta: {\n kind: KINDS.INSTANCE,\n kinds: [KINDS.INSTANCE, KINDS.GCP_RESOURCE, KINDS.NODE],\n childrenCount: -1,\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(\n this.projectId,\n this.zone,\n ctx.params.instanceId,\n ),\n },\n };\n } catch (error) {\n throw mapGCEError(error, ctx.path);\n }\n }\n\n // ========== Stat Operations ==========\n\n @Stat(\"/\")\n async statRoot(ctx: RouteContext): Promise<AFSStatResult> {\n const meta = await this.metaRoot(ctx);\n return { data: { id: meta.id, path: ctx.path, meta: meta.meta as Record<string, unknown> } };\n }\n\n @Stat(\"/instances\")\n async statInstances(ctx: RouteContext): Promise<AFSStatResult> {\n const meta = await this.metaInstances(ctx);\n return { data: { id: meta.id, path: ctx.path, meta: meta.meta as Record<string, unknown> } };\n }\n\n @Stat(\"/instances/:instanceId\")\n @Stat(\"/by-status/:status/:instanceId\")\n async statInstance(\n ctx: RouteContext<{ instanceId: string; status?: string }>,\n ): Promise<AFSStatResult> {\n const meta = await this.metaInstance(ctx);\n return { data: { id: meta.id, path: ctx.path, meta: meta.meta as Record<string, unknown> } };\n }\n\n // ========== Write Operations ==========\n\n @Write(\"/instances/:instanceId/labels/:labelKey\")\n @Write(\"/by-status/:status/:instanceId/labels/:labelKey\")\n async writeInstanceLabel(\n ctx: RouteContext<{ instanceId: string; labelKey: string; status?: string }>,\n payload: AFSWriteEntryPayload,\n ): Promise<AFSWriteResult> {\n if (this.accessMode !== \"readwrite\") {\n throw new AFSReadonlyError(\"Write operations require readwrite access mode\");\n }\n\n try {\n const instance = await this.getInstance(ctx.params.instanceId);\n const labels = { ...(instance.labels \|\| {}) };\n labels[ctx.params.labelKey] = String(payload.content ?? \"\");\n\n await this.client.setLabels({\n project: this.projectId,\n zone: this.zone,\n instance: ctx.params.instanceId,\n instancesSetLabelsRequestResource: {\n labels,\n labelFingerprint: instance.labelFingerprint,\n },\n });\n\n return {\n data: {\n id: `gce://${this.projectId}/${this.zone}/${ctx.params.instanceId}/labels/${ctx.params.labelKey}`,\n path: ctx.path,\n content: payload.content,\n meta: { kind: \"gce:label\" },\n },\n message: `Label '${ctx.params.labelKey}' set on instance '${ctx.params.instanceId}'`,\n };\n } catch (error) {\n throw mapGCEError(error, ctx.path);\n }\n }\n\n // ========== Delete Operations ==========\n\n @Delete(\"/instances/:instanceId/labels/:labelKey\")\n @Delete(\"/by-status/:status/:instanceId/labels/:labelKey\")\n async deleteInstanceLabel(\n ctx: RouteContext<{ instanceId: string; labelKey: string; status?: string }>,\n ): Promise<AFSDeleteResult> {\n if (this.accessMode !== \"readwrite\") {\n throw new AFSReadonlyError(\"Delete operations require readwrite access mode\");\n }\n\n try {\n const instance = await this.getInstance(ctx.params.instanceId);\n const labels = { ...(instance.labels \|\| {}) };\n\n if (!(ctx.params.labelKey in labels)) {\n throw new AFSNotFoundError(\n ctx.path,\n `Label '${ctx.params.labelKey}' not found on instance '${ctx.params.instanceId}'`,\n );\n }\n\n delete labels[ctx.params.labelKey];\n\n await this.client.setLabels({\n project: this.projectId,\n zone: this.zone,\n instance: ctx.params.instanceId,\n instancesSetLabelsRequestResource: {\n labels,\n labelFingerprint: instance.labelFingerprint,\n },\n });\n\n return {\n message: `Label '${ctx.params.labelKey}' removed from instance '${ctx.params.instanceId}'`,\n };\n } catch (error) {\n if (error instanceof AFSNotFoundError) throw error;\n throw mapGCEError(error, ctx.path);\n }\n }\n\n // ========== Actions ==========\n\n @Actions(\"/\")\n async listGlobalActions(ctx: RouteContext): Promise<AFSListResult> {\n return {\n data: [\n {\n id: \"refresh\",\n path: joinURL(ctx.path, \"refresh\"),\n summary: \"Refresh instance cache\",\n meta: {\n kind: \"afs:executable\",\n kinds: [\"afs:executable\", \"afs:node\"],\n inputSchema: { type: \"object\", properties: {} },\n },\n },\n ],\n };\n }\n\n @Actions.Exec(\"/\", \"refresh\")\n async refreshAction(_ctx: RouteContext, _args: Record<string, unknown>): Promise<AFSExecResult> {\n return { success: true, data: { message: \"Cache refreshed\" } };\n }\n\n @Actions(\"/instances/:instanceId\")\n @Actions(\"/by-status/:status/:instanceId\")\n async listInstanceActions(\n ctx: RouteContext<{ instanceId: string; status?: string }>,\n ): Promise<AFSListResult> {\n const instance = await this.getInstance(ctx.params.instanceId);\n const status = instance.status as GCEInstanceState;\n\n const actions: Array<{ name: string; summary: string }> = [];\n\n switch (status) {\n case \"RUNNING\":\n actions.push(\n { name: \"stop\", summary: \"Stop the instance\" },\n { name: \"reset\", summary: \"Reset (hard reboot) the instance\" },\n );\n break;\n case \"STOPPED\":\n case \"TERMINATED\":\n actions.push({ name: \"start\", summary: \"Start the instance\" });\n break;\n case \"SUSPENDED\":\n actions.push({ name: \"start\", summary: \"Resume the instance\" });\n break;\n }\n\n return {\n data: actions.map((action) => ({\n id: action.name,\n path: joinURL(ctx.path, action.name),\n summary: action.summary,\n meta: {\n kind: \"afs:executable\",\n kinds: [\"afs:executable\", \"afs:node\"],\n inputSchema: { type: \"object\", properties: {} },\n },\n })),\n };\n }\n\n @Actions.Exec(\"/instances/:instanceId\", \"start\")\n @Actions.Exec(\"/by-status/:status/:instanceId\", \"start\")\n async startInstanceAction(\n ctx: RouteContext<{ instanceId: string; status?: string }>,\n _args: Record<string, unknown>,\n ): Promise<AFSExecResult> {\n try {\n const instance = await this.getInstance(ctx.params.instanceId);\n const status = instance.status as GCEInstanceState;\n\n if (status !== \"STOPPED\" && status !== \"TERMINATED\") {\n return {\n success: false,\n error: {\n code: \"INVALID_STATE\",\n message: `Cannot start instance in ${status} state. Instance must be STOPPED or TERMINATED.`,\n },\n };\n }\n\n const [operation] = await this.client.start({\n project: this.projectId,\n zone: this.zone,\n instance: ctx.params.instanceId,\n });\n\n return {\n success: true,\n data: { operationName: (operation as any).latestResponse?.name \|\| \"unknown\" },\n };\n } catch (error) {\n throw mapGCEError(error, ctx.path);\n }\n }\n\n @Actions.Exec(\"/instances/:instanceId\", \"stop\")\n @Actions.Exec(\"/by-status/:status/:instanceId\", \"stop\")\n async stopInstanceAction(\n ctx: RouteContext<{ instanceId: string; status?: string }>,\n _args: Record<string, unknown>,\n ): Promise<AFSExecResult> {\n try {\n const instance = await this.getInstance(ctx.params.instanceId);\n const status = instance.status as GCEInstanceState;\n\n if (status !== \"RUNNING\") {\n return {\n success: false,\n error: {\n code: \"INVALID_STATE\",\n message: `Cannot stop instance in ${status} state. Instance must be RUNNING.`,\n },\n };\n }\n\n const [operation] = await this.client.stop({\n project: this.projectId,\n zone: this.zone,\n instance: ctx.params.instanceId,\n });\n\n return {\n success: true,\n data: { operationName: (operation as any).latestResponse?.name \|\| \"unknown\" },\n };\n } catch (error) {\n throw mapGCEError(error, ctx.path);\n }\n }\n\n @Actions.Exec(\"/instances/:instanceId\", \"reset\")\n @Actions.Exec(\"/by-status/:status/:instanceId\", \"reset\")\n async resetInstanceAction(\n ctx: RouteContext<{ instanceId: string; status?: string }>,\n _args: Record<string, unknown>,\n ): Promise<AFSExecResult> {\n try {\n const instance = await this.getInstance(ctx.params.instanceId);\n const status = instance.status as GCEInstanceState;\n\n if (status !== \"RUNNING\") {\n return {\n success: false,\n error: {\n code: \"INVALID_STATE\",\n message: `Cannot reset instance in ${status} state. Instance must be RUNNING.`,\n },\n };\n }\n\n const [operation] = await this.client.reset({\n project: this.projectId,\n zone: this.zone,\n instance: ctx.params.instanceId,\n });\n\n return {\n success: true,\n data: { operationName: (operation as any).latestResponse?.name \|\| \"unknown\" },\n };\n } catch (error) {\n throw mapGCEError(error, ctx.path);\n }\n }\n\n // ========== Explain ==========\n\n @Explain(\"/\")\n async explainRoot(_ctx: RouteContext): Promise<AFSExplainResult> {\n try {\n const instances = await this.listAllInstances();\n const byStatus: Record<string, number> = {};\n\n for (const inst of instances) {\n const status = (inst.status as string) \|\| \"UNKNOWN\";\n byStatus[status] = (byStatus[status] \|\| 0) + 1;\n }\n\n const statusLines = Object.entries(byStatus)\n .map(([status, count]) => `- ${status}: ${count}`)\n .join(\"\\n\");\n\n const content = `# GCE Provider\n\n- Project: ${this.projectId}\n- Zone: ${this.zone}\n- Access Mode: ${this.accessMode}\n- Total Instances: ${instances.length}\n\n## Instances by Status\n\n${statusLines \|\| \"- No instances found\"}\n\n## Navigation\n\n- \\`/instances/\\` — list all instances\n- \\`/by-status/\\` — instances grouped by status\n- \\`/.actions/\\` — global actions\n`;\n\n return { format: \"markdown\", content };\n } catch (error) {\n throw mapGCEError(error);\n }\n }\n\n @Explain(\"/instances/:instanceId\")\n @Explain(\"/by-status/:status/:instanceId\")\n async explainInstance(\n ctx: RouteContext<{ instanceId: string; status?: string }>,\n ): Promise<AFSExplainResult> {\n try {\n const instance = await this.getInstance(ctx.params.instanceId);\n const machineType = instance.machineType?.split(\"/\").pop() \|\| \"unknown\";\n const privateIp = instance.networkInterfaces?.[0]?.networkIP \|\| \"none\";\n const publicIp = instance.networkInterfaces?.[0]?.accessConfigs?.[0]?.natIP \|\| \"none\";\n const labels = instance.labels \|\| {};\n const labelLines = Object.entries(labels)\n .map(([k, v]) => `- \\`${k}\\`: ${v}`)\n .join(\"\\n\");\n\n const content = `# Instance: ${ctx.params.instanceId}\n\n- Status: ${instance.status}\n- Machine Type: ${machineType}\n- Zone: ${this.zone}\n- Created: ${instance.creationTimestamp \|\| \"unknown\"}\n\n## Network\n\n- Private IP: ${privateIp}\n- Public IP*: ${publicIp}\n\n## Labels\n\n${labelLines \|\| \"- No labels\"}\n`;\n\n return { format: \"markdown\", content };\n } catch (error) {\n throw mapGCEError(error, ctx.path);\n }\n }\n}\n\n// Type check: AFSGCE should implement AFSModuleClass\nconst _typeCheck: AFSModuleClass<AFSGCE, AFSGCEOptions> = AFSGCE;\n\n// Re-export types\nexport type { AFSGCEOptions } from \"./types.js\";\nexport { afsgceOptionsSchema } from \"./types.js\";\n"],"mappings":"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"}
1	+ {"version":3,"file":"index.mjs","names":[],"sources":["../src/platform-ref.ts","../src/types.ts","../src/index.ts"],"sourcesContent":["/*\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 = z.preprocess(\n (v) => {\n if (v && typeof v === \"object\" && !Array.isArray(v)) {\n const obj = { ...(v as Record<string, unknown>) };\n // Map URI template var 'project' to 'projectId'\n if (obj.project && !obj.projectId) {\n obj.projectId = obj.project;\n delete obj.project;\n }\n return obj;\n }\n return v;\n },\n 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) as z.ZodType<AFSGCEOptions>;\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 AFS GCE Provider\n \n GCE provider using AFSBaseProvider decorator routing pattern.\n * Provides file-system-like access to Google Compute Engine instances.\n /\n\nimport {\n type ActionCatalog,\n type ActionDefinition,\n Actions,\n type AFSAccessMode,\n AFSBaseProvider,\n type AFSDeleteResult,\n type AFSEntry,\n type AFSExecResult,\n type AFSExplainResult,\n type AFSListResult,\n type AFSModuleClass,\n type AFSModuleLoadParams,\n AFSNotFoundError,\n AFSReadonlyError,\n type AFSStatResult,\n type AFSWriteEntryPayload,\n type AFSWriteResult,\n type CapabilitiesManifest,\n Delete,\n Explain,\n List,\n Meta,\n type ProviderManifest,\n type ProviderTreeSchema,\n Read,\n type RouteContext,\n Stat,\n Write,\n} from \"@aigne/afs\";\nimport { zodParse } from \"@aigne/afs/utils/zod\";\nimport { InstancesClient } from \"@google-cloud/compute\";\nimport { joinURL } from \"ufo\";\nimport { z } from \"zod\";\nimport { generateInstancePlatformRef, generateInstancesListPlatformRef } from \"./platform-ref.js\";\nimport {\n type AFSGCEOptions,\n afsgceOptionsSchema,\n GCE_INSTANCE_STATES,\n type GCEInstanceState,\n KINDS,\n} from \"./types.js\";\n\n/\n Map GCE SDK errors to appropriate AFS errors\n /\nfunction mapGCEError(error: unknown, path?: string): Error {\n if (error instanceof AFSNotFoundError \|\| error instanceof AFSReadonlyError) {\n return error;\n }\n if (typeof error === \"object\" && error !== null && \"code\" in error) {\n const err = error as { code: number; message?: string };\n if (err.code === 404) {\n return new AFSNotFoundError(path ?? \"/\", err.message);\n }\n }\n if (error instanceof Error) {\n return error;\n }\n return new Error(String(error));\n}\n\n/\n AFSGCE Provider using AFSBaseProvider pattern\n \n Provides file-system-like access to GCE instances.\n * Uses decorator routing (@List, @Read, @Write, @Delete, @Meta, @Actions, @Explain).\n \n @example\n * ```typescript\n * const gce = new AFSGCE({\n * projectId: \"my-project\",\n * zone: \"us-central1-a\",\n * });\n \n // Mount to AFS\n * afs.mount(gce);\n \n // List instances\n * const result = await afs.list(\"/modules/gce/instances\");\n \n // Read instance metadata\n * const meta = await afs.read(\"/modules/gce/instances/my-vm/metadata.json\");\n * ```\n /\nexport class AFSGCE extends AFSBaseProvider {\n override readonly name: string;\n override readonly description?: string;\n override readonly accessMode: AFSAccessMode;\n\n private readonly client: InstancesClient;\n private readonly projectId: string;\n private readonly zone: string;\n\n constructor(options: AFSGCEOptions & { uri?: string; token?: string; auth?: unknown }) {\n super();\n\n // Strip registry-injected keys before strict schema validation\n const { uri: _uri, token: _token, auth: _auth, ...cleanOptions } = options as any;\n\n const validated = afsgceOptionsSchema.parse(cleanOptions);\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 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 static schema() {\n return afsgceOptionsSchema;\n }\n\n /\n Provider manifest for URI-based discovery\n /\n static manifest(): ProviderManifest {\n return {\n name: \"gce\",\n description:\n \"Google Compute Engine VM instances in a project/zone.\\n- List and inspect instances, view metadata, labels, and network config\\n- Exec actions: `start`, `stop`, `restart`, `delete`\\n- Path structure: `/instances/{instance-name}`\",\n uriTemplate: \"gce://{project}/{zone}\",\n category: \"compute\",\n schema: z.object({\n project: z.string(),\n zone: z.string(),\n keyFilename: z.string().optional(),\n }),\n tags: [\"gcp\", \"gce\", \"cloud\", \"compute\"],\n capabilityTags: [\n \"read-write\",\n \"search\",\n \"destructive\",\n \"auth:gcp\",\n \"remote\",\n \"cloud\",\n \"http\",\n ],\n security: {\n riskLevel: \"external\",\n resourceAccess: [\"cloud-api\"],\n requires: [\"cloud-credentials\"],\n dataSensitivity: [\"system-config\"],\n notes: [\"Can start, stop, restart, and delete GCE instances\"],\n },\n capabilities: {\n network: { egress: true, allowedDomains: [\".googleapis.com\"] },\n secrets: [\"gcp/credentials\"],\n },\n };\n }\n\n /*\n Tree schema for progressive disclosure\n /\n static treeSchema(): ProviderTreeSchema {\n return {\n operations: [\"list\", \"read\", \"write\", \"delete\", \"exec\", \"stat\", \"explain\"],\n tree: {\n \"/\": { kind: \"compute:root\", operations: [\"list\", \"read\", \"exec\"], actions: [\"refresh\"] },\n \"/instances\": { kind: \"compute:collection\", operations: [\"list\", \"read\"] },\n \"/instances/{instanceName}\": {\n kind: \"compute:instance\",\n operations: [\"list\", \"read\", \"exec\"],\n actions: [\"start\", \"stop\", \"reset\"],\n },\n \"/instances/{instanceName}/metadata.json\": {\n kind: \"compute:metadata\",\n operations: [\"read\"],\n },\n \"/instances/{instanceName}/labels/{labelKey}\": {\n kind: \"compute:label\",\n operations: [\"read\", \"write\", \"delete\"],\n },\n \"/by-status/{status}\": { kind: \"compute:status-filter\", operations: [\"list\", \"read\"] },\n },\n auth: {\n type: \"gcp\",\n env: [\"GOOGLE_APPLICATION_CREDENTIALS\"],\n },\n bestFor: [\"VM management\", \"instance lifecycle\", \"cloud inventory\"],\n notFor: [\"file storage\", \"databases\"],\n };\n }\n\n static async load({ basePath, config }: AFSModuleLoadParams = {}): Promise<AFSGCE> {\n const options = zodParse(afsgceOptionsSchema, config, { prefix: basePath });\n return new AFSGCE(options);\n }\n\n // ========== Helper Methods ==========\n\n private async getInstance(instanceName: string) {\n try {\n const [instance] = await this.client.get({\n project: this.projectId,\n zone: this.zone,\n instance: instanceName,\n });\n return instance;\n } catch (error) {\n throw mapGCEError(error, joinURL(\"/instances\", instanceName));\n }\n }\n\n private async listAllInstances(maxResults?: number) {\n const [instances] = await this.client.list({\n project: this.projectId,\n zone: this.zone,\n maxResults: maxResults ?? 1000,\n });\n return instances \|\| [];\n }\n\n private buildInstanceEntry(instance: any, basePath: string): AFSEntry {\n const name = instance.name!;\n const machineType = instance.machineType?.split(\"/\").pop() \|\| \"unknown\";\n\n return {\n id: `gce://${this.projectId}/${this.zone}/${name}`,\n path: joinURL(basePath, name),\n meta: {\n kind: KINDS.INSTANCE,\n kinds: [KINDS.INSTANCE, KINDS.GCP_RESOURCE, KINDS.NODE],\n childrenCount: -1,\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(this.projectId, this.zone, name),\n },\n };\n }\n\n // ========== List Operations ==========\n\n @List(\"/\")\n async listRoot(_ctx: RouteContext): Promise<AFSListResult> {\n return {\n data: [\n {\n id: `gce://${this.projectId}/instances`,\n path: \"/instances\",\n meta: {\n kind: KINDS.NODE,\n kinds: [KINDS.NODE],\n childrenCount: -1,\n description: \"GCE Instances\",\n platformRef: generateInstancesListPlatformRef(this.projectId),\n },\n },\n {\n id: `gce://${this.projectId}/by-status`,\n path: \"/by-status\",\n meta: {\n kind: KINDS.NODE,\n kinds: [KINDS.NODE],\n childrenCount: GCE_INSTANCE_STATES.length,\n description: \"Instances grouped by status\",\n },\n },\n ],\n };\n }\n\n @List(\"/instances\")\n async listInstances(_ctx: RouteContext): Promise<AFSListResult> {\n try {\n const instances = await this.listAllInstances();\n const entries = instances.map((instance: any) =>\n this.buildInstanceEntry(instance, \"/instances\"),\n );\n return { data: entries };\n } catch (error) {\n throw mapGCEError(error, \"/instances\");\n }\n }\n\n @List(\"/instances/:instanceId\")\n @List(\"/by-status/:status/:instanceId\")\n async listInstanceChildren(\n ctx: RouteContext<{ instanceId: string; status?: string }>,\n ): Promise<AFSListResult> {\n await this.getInstance(ctx.params.instanceId);\n\n return {\n data: [\n {\n id: `gce://${this.projectId}/${this.zone}/${ctx.params.instanceId}/metadata.json`,\n path: joinURL(ctx.path, \"metadata.json\"),\n meta: {\n kind: KINDS.NODE,\n kinds: [KINDS.NODE],\n description: \"Instance metadata\",\n },\n },\n {\n id: `gce://${this.projectId}/${this.zone}/${ctx.params.instanceId}/labels`,\n path: joinURL(ctx.path, \"labels\"),\n meta: {\n kind: KINDS.NODE,\n kinds: [KINDS.NODE],\n childrenCount: -1,\n description: \"Instance labels\",\n },\n },\n ],\n };\n }\n\n @List(\"/instances/:instanceId/labels\")\n @List(\"/by-status/:status/:instanceId/labels\")\n async listInstanceLabels(\n ctx: RouteContext<{ instanceId: string; status?: string }>,\n ): Promise<AFSListResult> {\n const instance = await this.getInstance(ctx.params.instanceId);\n const labels = instance.labels \|\| {};\n\n const entries: AFSEntry[] = Object.entries(labels).map(([key, value]) => ({\n id: `gce://${this.projectId}/${this.zone}/${ctx.params.instanceId}/labels/${key}`,\n path: joinURL(ctx.path, encodeURIComponent(key)),\n content: value,\n meta: {\n kind: \"gce:label\",\n },\n }));\n\n return { data: entries };\n }\n\n @List(\"/by-status\")\n async listByStatus(_ctx: RouteContext): Promise<AFSListResult> {\n const entries: AFSEntry[] = GCE_INSTANCE_STATES.map((status) => ({\n id: `gce://${this.projectId}/by-status/${status.toLowerCase()}`,\n path: joinURL(\"/by-status\", status.toLowerCase()),\n meta: {\n kind: KINDS.NODE,\n kinds: [KINDS.NODE],\n childrenCount: -1,\n description: `Instances in ${status} state`,\n },\n }));\n\n return { data: entries };\n }\n\n @List(\"/by-status/:status\")\n async listByStatusFilter(ctx: RouteContext<{ status: string }>): Promise<AFSListResult> {\n try {\n const statusUpper = ctx.params.status.toUpperCase();\n const instances = await this.listAllInstances();\n const filtered = instances.filter(\n (inst: any) => (inst.status as string)?.toUpperCase() === statusUpper,\n );\n\n const entries = filtered.map((instance: any) => this.buildInstanceEntry(instance, ctx.path));\n\n return { data: entries };\n } catch (error) {\n throw mapGCEError(error, ctx.path);\n }\n }\n\n // ========== Read Operations ==========\n\n @Read(\"/.meta/.capabilities\")\n async readCapabilities(_ctx: RouteContext): Promise<AFSEntry> {\n const actionCatalogs: ActionCatalog[] = [];\n\n const instanceActions: ActionDefinition[] = [\n {\n name: \"start\",\n description: \"Start a stopped or terminated instance\",\n inputSchema: { type: \"object\", properties: {} },\n },\n {\n name: \"stop\",\n description: \"Stop a running instance\",\n inputSchema: { type: \"object\", properties: {} },\n },\n {\n name: \"reset\",\n description: \"Reset (hard reboot) a running instance\",\n inputSchema: { type: \"object\", properties: {} },\n },\n ];\n\n actionCatalogs.push({\n kind: \"gce:instance\",\n description: \"Instance lifecycle operations\",\n catalog: instanceActions,\n discovery: {\n pathTemplate: \"/instances/:instanceName/.actions\",\n note: \"Replace :instanceName with actual instance name\",\n },\n });\n\n if (this.accessMode === \"readwrite\") {\n actionCatalogs.push({\n kind: \"gce:global\",\n description: \"Global GCE operations\",\n catalog: [\n {\n name: \"refresh\",\n description: \"Refresh cached instance data\",\n inputSchema: { type: \"object\", properties: {} },\n },\n ],\n discovery: {\n pathTemplate: \"/.actions\",\n note: \"Available at provider root\",\n },\n });\n }\n\n const manifest: CapabilitiesManifest = {\n schemaVersion: 1,\n provider: this.name,\n version: \"1.0.0\",\n description: this.description,\n tools: [],\n actions: actionCatalogs,\n operations: this.getOperationsDeclaration(),\n };\n\n return {\n id: \"/.meta/.capabilities\",\n path: \"/.meta/.capabilities\",\n content: manifest,\n meta: { kind: \"afs:capabilities\" },\n };\n }\n\n @Read(\"/instances/:instanceId/metadata.json\")\n @Read(\"/by-status/:status/:instanceId/metadata.json\")\n async readInstanceMetadata(\n ctx: RouteContext<{ instanceId: string; status?: string }>,\n ): Promise<AFSEntry> {\n try {\n const instance = await this.getInstance(ctx.params.instanceId);\n\n return {\n id: `gce://${this.projectId}/${this.zone}/${ctx.params.instanceId}/metadata.json`,\n path: ctx.path,\n meta: {\n kind: KINDS.NODE,\n kinds: [KINDS.NODE],\n description: \"Instance metadata\",\n },\n content: JSON.stringify(instance, null, 2),\n };\n } catch (error) {\n throw mapGCEError(error, ctx.path);\n }\n }\n\n @Read(\"/instances/:instanceId/labels/:labelKey\")\n @Read(\"/by-status/:status/:instanceId/labels/:labelKey\")\n async readInstanceLabel(\n ctx: RouteContext<{ instanceId: string; labelKey: string; status?: string }>,\n ): Promise<AFSEntry> {\n const instance = await this.getInstance(ctx.params.instanceId);\n const labels = instance.labels \|\| {};\n const value = labels[ctx.params.labelKey];\n\n if (value === undefined) {\n throw new AFSNotFoundError(ctx.path);\n }\n\n return {\n id: `gce://${this.projectId}/${this.zone}/${ctx.params.instanceId}/labels/${ctx.params.labelKey}`,\n path: ctx.path,\n content: value,\n meta: { kind: \"gce:label\" },\n };\n }\n\n // ========== Meta Operations ==========\n\n @Meta(\"/\")\n async metaRoot(ctx: RouteContext): Promise<AFSEntry> {\n return {\n id: `gce://${this.projectId}/`,\n path: ctx.path,\n meta: {\n kind: KINDS.NODE,\n kinds: [KINDS.NODE],\n childrenCount: 2,\n description: \"GCE Root\",\n },\n };\n }\n\n @Meta(\"/instances\")\n async metaInstances(ctx: RouteContext): Promise<AFSEntry> {\n return {\n id: `gce://${this.projectId}/instances`,\n path: ctx.path,\n meta: {\n kind: KINDS.NODE,\n kinds: [KINDS.NODE],\n childrenCount: -1,\n description: \"GCE Instances\",\n platformRef: generateInstancesListPlatformRef(this.projectId),\n },\n };\n }\n\n @Meta(\"/instances/:instanceId\")\n @Meta(\"/by-status/:status/:instanceId\")\n async metaInstance(\n ctx: RouteContext<{ instanceId: string; status?: string }>,\n ): Promise<AFSEntry> {\n try {\n const instance = await this.getInstance(ctx.params.instanceId);\n const machineType = instance.machineType?.split(\"/\").pop() \|\| \"unknown\";\n\n return {\n id: `gce://${this.projectId}/${this.zone}/${ctx.params.instanceId}`,\n path: ctx.path,\n meta: {\n kind: KINDS.INSTANCE,\n kinds: [KINDS.INSTANCE, KINDS.GCP_RESOURCE, KINDS.NODE],\n childrenCount: -1,\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(\n this.projectId,\n this.zone,\n ctx.params.instanceId,\n ),\n },\n };\n } catch (error) {\n throw mapGCEError(error, ctx.path);\n }\n }\n\n // ========== Stat Operations ==========\n\n @Stat(\"/\")\n async statRoot(ctx: RouteContext): Promise<AFSStatResult> {\n const meta = await this.metaRoot(ctx);\n return { data: { id: meta.id, path: ctx.path, meta: meta.meta as Record<string, unknown> } };\n }\n\n @Stat(\"/instances\")\n async statInstances(ctx: RouteContext): Promise<AFSStatResult> {\n const meta = await this.metaInstances(ctx);\n return { data: { id: meta.id, path: ctx.path, meta: meta.meta as Record<string, unknown> } };\n }\n\n @Stat(\"/instances/:instanceId\")\n @Stat(\"/by-status/:status/:instanceId\")\n async statInstance(\n ctx: RouteContext<{ instanceId: string; status?: string }>,\n ): Promise<AFSStatResult> {\n const meta = await this.metaInstance(ctx);\n return { data: { id: meta.id, path: ctx.path, meta: meta.meta as Record<string, unknown> } };\n }\n\n // ========== Write Operations ==========\n\n @Write(\"/instances/:instanceId/labels/:labelKey\")\n @Write(\"/by-status/:status/:instanceId/labels/:labelKey\")\n async writeInstanceLabel(\n ctx: RouteContext<{ instanceId: string; labelKey: string; status?: string }>,\n payload: AFSWriteEntryPayload,\n ): Promise<AFSWriteResult> {\n if (this.accessMode !== \"readwrite\") {\n throw new AFSReadonlyError(\"Write operations require readwrite access mode\");\n }\n\n try {\n const instance = await this.getInstance(ctx.params.instanceId);\n const labels = { ...(instance.labels \|\| {}) };\n labels[ctx.params.labelKey] = String(payload.content ?? \"\");\n\n await this.client.setLabels({\n project: this.projectId,\n zone: this.zone,\n instance: ctx.params.instanceId,\n instancesSetLabelsRequestResource: {\n labels,\n labelFingerprint: instance.labelFingerprint,\n },\n });\n\n return {\n data: {\n id: `gce://${this.projectId}/${this.zone}/${ctx.params.instanceId}/labels/${ctx.params.labelKey}`,\n path: ctx.path,\n content: payload.content,\n meta: { kind: \"gce:label\" },\n },\n message: `Label '${ctx.params.labelKey}' set on instance '${ctx.params.instanceId}'`,\n };\n } catch (error) {\n throw mapGCEError(error, ctx.path);\n }\n }\n\n // ========== Delete Operations ==========\n\n @Delete(\"/instances/:instanceId/labels/:labelKey\")\n @Delete(\"/by-status/:status/:instanceId/labels/:labelKey\")\n async deleteInstanceLabel(\n ctx: RouteContext<{ instanceId: string; labelKey: string; status?: string }>,\n ): Promise<AFSDeleteResult> {\n if (this.accessMode !== \"readwrite\") {\n throw new AFSReadonlyError(\"Delete operations require readwrite access mode\");\n }\n\n try {\n const instance = await this.getInstance(ctx.params.instanceId);\n const labels = { ...(instance.labels \|\| {}) };\n\n if (!(ctx.params.labelKey in labels)) {\n throw new AFSNotFoundError(\n ctx.path,\n `Label '${ctx.params.labelKey}' not found on instance '${ctx.params.instanceId}'`,\n );\n }\n\n delete labels[ctx.params.labelKey];\n\n await this.client.setLabels({\n project: this.projectId,\n zone: this.zone,\n instance: ctx.params.instanceId,\n instancesSetLabelsRequestResource: {\n labels,\n labelFingerprint: instance.labelFingerprint,\n },\n });\n\n return {\n message: `Label '${ctx.params.labelKey}' removed from instance '${ctx.params.instanceId}'`,\n };\n } catch (error) {\n if (error instanceof AFSNotFoundError) throw error;\n throw mapGCEError(error, ctx.path);\n }\n }\n\n // ========== Actions ==========\n\n @Actions(\"/\")\n async listGlobalActions(ctx: RouteContext): Promise<AFSListResult> {\n return {\n data: [\n {\n id: \"refresh\",\n path: joinURL(ctx.path, \"refresh\"),\n summary: \"Refresh instance cache\",\n meta: {\n kind: \"afs:executable\",\n kinds: [\"afs:executable\", \"afs:node\"],\n inputSchema: { type: \"object\", properties: {} },\n },\n },\n ],\n };\n }\n\n @Actions.Exec(\"/\", \"refresh\")\n async refreshAction(_ctx: RouteContext, _args: Record<string, unknown>): Promise<AFSExecResult> {\n return { success: true, data: { message: \"Cache refreshed\" } };\n }\n\n @Actions(\"/instances/:instanceId\")\n @Actions(\"/by-status/:status/:instanceId\")\n async listInstanceActions(\n ctx: RouteContext<{ instanceId: string; status?: string }>,\n ): Promise<AFSListResult> {\n const instance = await this.getInstance(ctx.params.instanceId);\n const status = instance.status as GCEInstanceState;\n\n const actions: Array<{ name: string; summary: string }> = [];\n\n switch (status) {\n case \"RUNNING\":\n actions.push(\n { name: \"stop\", summary: \"Stop the instance\" },\n { name: \"reset\", summary: \"Reset (hard reboot) the instance\" },\n );\n break;\n case \"STOPPED\":\n case \"TERMINATED\":\n actions.push({ name: \"start\", summary: \"Start the instance\" });\n break;\n case \"SUSPENDED\":\n actions.push({ name: \"start\", summary: \"Resume the instance\" });\n break;\n }\n\n return {\n data: actions.map((action) => ({\n id: action.name,\n path: joinURL(ctx.path, action.name),\n summary: action.summary,\n meta: {\n kind: \"afs:executable\",\n kinds: [\"afs:executable\", \"afs:node\"],\n inputSchema: { type: \"object\", properties: {} },\n },\n })),\n };\n }\n\n @Actions.Exec(\"/instances/:instanceId\", \"start\")\n @Actions.Exec(\"/by-status/:status/:instanceId\", \"start\")\n async startInstanceAction(\n ctx: RouteContext<{ instanceId: string; status?: string }>,\n _args: Record<string, unknown>,\n ): Promise<AFSExecResult> {\n try {\n const instance = await this.getInstance(ctx.params.instanceId);\n const status = instance.status as GCEInstanceState;\n\n if (status !== \"STOPPED\" && status !== \"TERMINATED\") {\n return {\n success: false,\n error: {\n code: \"INVALID_STATE\",\n message: `Cannot start instance in ${status} state. Instance must be STOPPED or TERMINATED.`,\n },\n };\n }\n\n const [operation] = await this.client.start({\n project: this.projectId,\n zone: this.zone,\n instance: ctx.params.instanceId,\n });\n\n return {\n success: true,\n data: { operationName: (operation as any).latestResponse?.name \|\| \"unknown\" },\n };\n } catch (error) {\n throw mapGCEError(error, ctx.path);\n }\n }\n\n @Actions.Exec(\"/instances/:instanceId\", \"stop\")\n @Actions.Exec(\"/by-status/:status/:instanceId\", \"stop\")\n async stopInstanceAction(\n ctx: RouteContext<{ instanceId: string; status?: string }>,\n _args: Record<string, unknown>,\n ): Promise<AFSExecResult> {\n try {\n const instance = await this.getInstance(ctx.params.instanceId);\n const status = instance.status as GCEInstanceState;\n\n if (status !== \"RUNNING\") {\n return {\n success: false,\n error: {\n code: \"INVALID_STATE\",\n message: `Cannot stop instance in ${status} state. Instance must be RUNNING.`,\n },\n };\n }\n\n const [operation] = await this.client.stop({\n project: this.projectId,\n zone: this.zone,\n instance: ctx.params.instanceId,\n });\n\n return {\n success: true,\n data: { operationName: (operation as any).latestResponse?.name \|\| \"unknown\" },\n };\n } catch (error) {\n throw mapGCEError(error, ctx.path);\n }\n }\n\n @Actions.Exec(\"/instances/:instanceId\", \"reset\")\n @Actions.Exec(\"/by-status/:status/:instanceId\", \"reset\")\n async resetInstanceAction(\n ctx: RouteContext<{ instanceId: string; status?: string }>,\n _args: Record<string, unknown>,\n ): Promise<AFSExecResult> {\n try {\n const instance = await this.getInstance(ctx.params.instanceId);\n const status = instance.status as GCEInstanceState;\n\n if (status !== \"RUNNING\") {\n return {\n success: false,\n error: {\n code: \"INVALID_STATE\",\n message: `Cannot reset instance in ${status} state. Instance must be RUNNING.`,\n },\n };\n }\n\n const [operation] = await this.client.reset({\n project: this.projectId,\n zone: this.zone,\n instance: ctx.params.instanceId,\n });\n\n return {\n success: true,\n data: { operationName: (operation as any).latestResponse?.name \|\| \"unknown\" },\n };\n } catch (error) {\n throw mapGCEError(error, ctx.path);\n }\n }\n\n // ========== Explain ==========\n\n @Explain(\"/\")\n async explainRoot(_ctx: RouteContext): Promise<AFSExplainResult> {\n try {\n const instances = await this.listAllInstances();\n const byStatus: Record<string, number> = {};\n\n for (const inst of instances) {\n const status = (inst.status as string) \|\| \"UNKNOWN\";\n byStatus[status] = (byStatus[status] \|\| 0) + 1;\n }\n\n const statusLines = Object.entries(byStatus)\n .map(([status, count]) => `- ${status}: ${count}`)\n .join(\"\\n\");\n\n const content = `# GCE Provider\n\n- Project: ${this.projectId}\n- Zone: ${this.zone}\n- Access Mode: ${this.accessMode}\n- Total Instances: ${instances.length}\n\n## Instances by Status\n\n${statusLines \|\| \"- No instances found\"}\n\n## Navigation\n\n- \\`/instances/\\` — list all instances\n- \\`/by-status/\\` — instances grouped by status\n- \\`/.actions/\\` — global actions\n`;\n\n return { format: \"markdown\", content };\n } catch (error) {\n throw mapGCEError(error);\n }\n }\n\n @Explain(\"/instances/:instanceId\")\n @Explain(\"/by-status/:status/:instanceId\")\n async explainInstance(\n ctx: RouteContext<{ instanceId: string; status?: string }>,\n ): Promise<AFSExplainResult> {\n try {\n const instance = await this.getInstance(ctx.params.instanceId);\n const machineType = instance.machineType?.split(\"/\").pop() \|\| \"unknown\";\n const privateIp = instance.networkInterfaces?.[0]?.networkIP \|\| \"none\";\n const publicIp = instance.networkInterfaces?.[0]?.accessConfigs?.[0]?.natIP \|\| \"none\";\n const labels = instance.labels \|\| {};\n const labelLines = Object.entries(labels)\n .map(([k, v]) => `- \\`${k}\\`: ${v}`)\n .join(\"\\n\");\n\n const content = `# Instance: ${ctx.params.instanceId}\n\n- Status: ${instance.status}\n- Machine Type: ${machineType}\n- Zone: ${this.zone}\n- Created: ${instance.creationTimestamp \|\| \"unknown\"}\n\n## Network\n\n- Private IP: ${privateIp}\n- Public IP*: ${publicIp}\n\n## Labels\n\n${labelLines \|\| \"- No labels\"}\n`;\n\n return { format: \"markdown\", content };\n } catch (error) {\n throw mapGCEError(error, ctx.path);\n }\n }\n}\n\n// Type check: AFSGCE should implement AFSModuleClass\nconst _typeCheck: AFSModuleClass<AFSGCE, AFSGCEOptions> = AFSGCE;\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 CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@aigne/afs-gce",
-  "version": "1.11.0-beta.11",
+  "version": "1.11.0-beta.12",
   "description": "AIGNE AFS module for Google Compute Engine resources",
   "license": "UNLICENSED",
   "publishConfig": {
@@ -36,7 +36,7 @@
     "@google-cloud/compute": "^4.10.0",
     "ufo": "^1.6.3",
     "zod": "^4.0.0",
-    "@aigne/afs": "^1.11.0-beta.11"
+    "@aigne/afs": "^1.11.0-beta.12"
   },
   "devDependencies": {
     "@types/bun": "^1.3.6",
@@ -44,8 +44,9 @@
     "rimraf": "^6.1.2",
     "tsdown": "0.20.0-beta.3",
     "typescript": "5.9.2",
-    "@aigne/typescript-config": "0.0.0",
-    "@aigne/scripts": "0.0.0"
+    "@aigne/scripts": "0.0.0",
+    "@aigne/afs-testing": "1.11.0-beta.12",
+    "@aigne/typescript-config": "0.0.0"
   },
   "scripts": {
     "build": "tsdown",