@agent-vm/agent-vm 0.0.20

package/dist/cli/commands/controller-definition.js

@@ -0,0 +1,211 @@
+// oxlint-disable typescript-eslint/explicit-function-return-type
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { command, positional, string, subcommands } from 'cmd-ts';
+import { computeFingerprintFromConfigPath } from '../../build/gondolin-image-builder.js';
+import { requireZone } from '../agent-vm-cli-support.js';
+import { runControllerOperationCommand } from '../controller-operation-commands.js';
+import { runLeaseCommand } from '../lease-commands.js';
+import { createRunTask } from '../run-task.js';
+import { runSshCommand } from '../ssh-commands.js';
+import { appendZoneArgument, createConfigOption, createPurgeFlag, createPrintFlag, createRemoteCommandArguments, createZoneOption, loadSystemConfigFromOption, } from './command-definition-support.js';
+function createControllerOperationSubcommand(io, dependencies, options) {
+    return command({
+        name: options.name,
+        description: options.description,
+        args: {
+            config: createConfigOption(),
+            ...(options.supportsZone ? { zone: createZoneOption() } : {}),
+            ...(options.supportsPurge ? { purge: createPurgeFlag() } : {}),
+        },
+        handler: async ({ config, ...rest }) => {
+            const systemConfig = await loadSystemConfigFromOption(config, dependencies);
+            const zoneFlag = options.supportsZone && 'zone' in rest ? rest.zone : undefined;
+            const selectedZone = options.supportsZone ? requireZone(systemConfig, zoneFlag) : undefined;
+            const argumentPrefix = options.supportsPurge && 'purge' in rest && rest.purge ? ['--purge'] : [];
+            const restArguments = selectedZone
+                ? appendZoneArgument(argumentPrefix, selectedZone.id)
+                : argumentPrefix;
+            await runControllerOperationCommand({
+                dependencies,
+                io,
+                restArguments,
+                subcommand: options.name,
+                systemConfig,
+            });
+        },
+    });
+}
+export async function isGatewayImageCached(systemConfig, zoneId) {
+    const zone = requireZone(systemConfig, zoneId);
+    const gatewayImageProfile = systemConfig.imageProfiles.gateways[zone.gateway.imageProfile];
+    if (!gatewayImageProfile) {
+        throw new Error(`Gateway image profile '${zone.gateway.imageProfile}' is not configured.`);
+    }
+    const gatewayFingerprint = await computeFingerprintFromConfigPath(gatewayImageProfile.buildConfig, systemConfig.systemCacheIdentifierPath);
+    const gatewayCachePath = path.join(systemConfig.cacheDir, 'gateway-images', zone.gateway.imageProfile, gatewayFingerprint);
+    try {
+        await fs.access(path.join(gatewayCachePath, 'manifest.json'));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function requireGatewayImageCache(systemConfig, zoneId, dependencies) {
+    const cacheIsWarm = (await dependencies.isGatewayImageCached?.(systemConfig, zoneId)) ??
+        (await isGatewayImageCached(systemConfig, zoneId));
+    if (cacheIsWarm) {
+        return;
+    }
+    throw new Error(`[start] Gateway image not cached. Run \`agent-vm build\` first, then retry \`agent-vm controller start --zone ${zoneId}\`.`);
+}
+export function createControllerSubcommands(io, dependencies) {
+    return subcommands({
+        name: 'controller',
+        description: 'Manage the VM controller',
+        cmds: {
+            start: command({
+                name: 'start',
+                description: 'Boot the controller and gateway',
+                args: {
+                    config: createConfigOption(),
+                    zone: createZoneOption(),
+                },
+                handler: async ({ config, zone }) => {
+                    const systemConfig = await loadSystemConfigFromOption(config, dependencies);
+                    const selectedZone = requireZone(systemConfig, zone);
+                    await requireGatewayImageCache(systemConfig, selectedZone.id, dependencies);
+                    const runTask = await createRunTask(io);
+                    const runtime = await dependencies.startControllerRuntime({
+                        systemConfig,
+                        zoneId: selectedZone.id,
+                    }, { runTask });
+                    io.stdout.write(`${JSON.stringify({
+                        controllerPort: runtime.controllerPort,
+                        ingress: runtime.gateway?.ingress ?? null,
+                        vmId: runtime.gateway?.vm.id ?? null,
+                        zoneId: selectedZone.id,
+                    }, null, 2)}\n`);
+                },
+            }),
+            stop: createControllerOperationSubcommand(io, dependencies, {
+                description: 'Stop the controller',
+                name: 'stop',
+            }),
+            status: createControllerOperationSubcommand(io, dependencies, {
+                description: 'Show controller status',
+                name: 'status',
+            }),
+            ssh: command({
+                name: 'ssh',
+                description: 'Open an SSH session into the gateway VM',
+                args: {
+                    config: createConfigOption(),
+                    print: createPrintFlag(),
+                    remoteCommandArguments: createRemoteCommandArguments(),
+                    zone: createZoneOption(),
+                },
+                handler: async ({ config, print, remoteCommandArguments, zone }) => {
+                    const systemConfig = await loadSystemConfigFromOption(config, dependencies);
+                    const selectedZone = requireZone(systemConfig, zone);
+                    const restArguments = [
+                        '--zone',
+                        selectedZone.id,
+                        ...(print ? ['--print'] : []),
+                        ...(remoteCommandArguments.length > 0 ? ['--', ...remoteCommandArguments] : []),
+                    ];
+                    await runSshCommand({
+                        dependencies,
+                        io,
+                        restArguments,
+                        systemConfig,
+                    });
+                },
+            }),
+            destroy: createControllerOperationSubcommand(io, dependencies, {
+                description: 'Destroy a zone runtime',
+                name: 'destroy',
+                supportsPurge: true,
+                supportsZone: true,
+            }),
+            upgrade: createControllerOperationSubcommand(io, dependencies, {
+                description: 'Upgrade a zone runtime',
+                name: 'upgrade',
+                supportsZone: true,
+            }),
+            logs: createControllerOperationSubcommand(io, dependencies, {
+                description: 'Show gateway logs',
+                name: 'logs',
+                supportsZone: true,
+            }),
+            credentials: subcommands({
+                name: 'credentials',
+                description: 'Manage credentials',
+                cmds: {
+                    refresh: command({
+                        name: 'refresh',
+                        description: 'Refresh zone credentials',
+                        args: {
+                            config: createConfigOption(),
+                            zone: createZoneOption(),
+                        },
+                        handler: async ({ config, zone }) => {
+                            const systemConfig = await loadSystemConfigFromOption(config, dependencies);
+                            const selectedZone = requireZone(systemConfig, zone);
+                            await runControllerOperationCommand({
+                                dependencies,
+                                io,
+                                restArguments: appendZoneArgument(['refresh'], selectedZone.id),
+                                subcommand: 'credentials',
+                                systemConfig,
+                            });
+                        },
+                    }),
+                },
+            }),
+            lease: subcommands({
+                name: 'lease',
+                description: 'Manage tool VM leases',
+                cmds: {
+                    list: command({
+                        name: 'list',
+                        description: 'List active leases',
+                        args: {
+                            config: createConfigOption(),
+                        },
+                        handler: async ({ config }) => {
+                            await runLeaseCommand({
+                                dependencies,
+                                io,
+                                restArguments: ['list'],
+                                systemConfig: await loadSystemConfigFromOption(config, dependencies),
+                            });
+                        },
+                    }),
+                    release: command({
+                        name: 'release',
+                        description: 'Release a lease',
+                        args: {
+                            config: createConfigOption(),
+                            leaseId: positional({
+                                displayName: 'lease-id',
+                                type: string,
+                                description: 'Lease identifier to release',
+                            }),
+                        },
+                        handler: async ({ config, leaseId }) => {
+                            await runLeaseCommand({
+                                dependencies,
+                                io,
+                                restArguments: ['release', leaseId],
+                                systemConfig: await loadSystemConfigFromOption(config, dependencies),
+                            });
+                        },
+                    }),
+                },
+            }),
+        },
+    });
+}
+//# sourceMappingURL=controller-definition.js.map

package/dist/cli/commands/controller-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controller-definition.js","sourceRoot":"","sources":["../../../src/cli/commands/controller-definition.ts"],"names":[],"mappings":"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"}