devchain-cli 0.24.1 → 0.24.2

package/dist/server/modules/remotes/operations/git-owner.operation.js

@@ -0,0 +1,216 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GitOwnerOperation = void 0;
+const common_1 = require("@nestjs/common");
+const node_os_1 = require("node:os");
+const home_git_guard_service_1 = require("../../file-sync/home-git-guard.service");
+const file_sync_service_1 = require("../../file-sync/file-sync.service");
+const git_owner_store_1 = require("../git-owner.store");
+const remote_health_port_1 = require("../ports/remote-health.port");
+const remote_bindings_service_1 = require("../services/remote-bindings.service");
+const remote_live_sync_service_1 = require("../sync/remote-live-sync.service");
+const file_sync_handoff_1 = require("./file-sync-handoff");
+const git_owner_dto_1 = require("./git-owner.dto");
+const host_api_key_1 = require("../host-api-key");
+const remote_host_client_1 = require("./remote-host.client");
+const remote_operation_errors_1 = require("./remote-operation.errors");
+const remote_operation_types_1 = require("./remote-operation.types");
+let GitOwnerOperation = class GitOwnerOperation {
+    health;
+    bindings;
+    host;
+    files;
+    handoff;
+    live;
+    owners;
+    guard;
+    kind = 'git_owner';
+    steps;
+    constructor(health, bindings, host, files, handoff, live, owners, guard) {
+        this.health = health;
+        this.bindings = bindings;
+        this.host = host;
+        this.files = files;
+        this.handoff = handoff;
+        this.live = live;
+        this.owners = owners;
+        this.guard = guard;
+        this.steps = [
+            {
+                id: 'preflight',
+                label: 'Check the VM and Git',
+                run: (run) => this.validate(run.operation.remoteId, (0, remote_operation_types_1.requireProjectId)(run.operation), run.operation),
+            },
+            {
+                id: 'freeze_host',
+                label: 'Block new agents on the VM',
+                run: ({ operation }) => this.host.freeze(operation.remoteId, (0, remote_operation_types_1.requireProjectId)(operation)).then(() => undefined),
+            },
+            {
+                id: 'stop_host_sessions',
+                label: 'Stop agent sessions on the VM',
+                run: ({ operation }) => this.host.stopSessions(operation.remoteId, (0, remote_operation_types_1.requireProjectId)(operation)),
+            },
+            { id: 'vm_guard', label: 'Block Git on the VM', run: (run) => this.vmGuard(run) },
+            {
+                id: 'thaw_host',
+                label: 'Allow new agents on the VM',
+                run: ({ operation }) => this.host.thaw(operation.remoteId, (0, remote_operation_types_1.requireProjectId)(operation)),
+            },
+            { id: 'pc_guard', label: 'Block Git on this PC', run: (run) => this.pcGuard(run) },
+            {
+                id: 'git_settle',
+                label: 'Wait for Git changes to sync',
+                run: (run) => this.handoff.settleGit(run, (0, remote_operation_types_1.requireProjectId)(run.operation), run.details.owner === 'home' ? 'vm' : 'home'),
+            },
+            {
+                id: 'git_flip',
+                label: 'Move Git control',
+                run: (run) => this.live.runExclusive((0, remote_operation_types_1.requireProjectId)(run.operation), () => this.handoff.flipGit(run, (0, remote_operation_types_1.requireProjectId)(run.operation), this.details(run).owner)),
+            },
+            {
+                id: 'pc_guard_remove',
+                label: 'Enable Git and rebuild the index on this PC',
+                run: (run) => this.pcGuardRemove(run),
+            },
+            {
+                id: 'vm_guard_remove',
+                label: 'Enable Git and rebuild the index on the VM',
+                run: (run) => this.vmGuardRemove(run),
+            },
+        ];
+    }
+    stepsFor(details) {
+        const take = details.owner === 'home';
+        const excluded = new Set(take
+            ? ['pc_guard', 'vm_guard_remove']
+            : ['freeze_host', 'stop_host_sessions', 'vm_guard', 'thaw_host', 'pc_guard_remove']);
+        if (take && details.force !== true)
+            for (const id of ['freeze_host', 'stop_host_sessions', 'thaw_host'])
+                excluded.add(id);
+        return this.steps.filter((step) => !excluded.has(step.id));
+    }
+    async validate(remoteId, projectId, operation) {
+        const refuse = (code, message) => {
+            throw new remote_operation_errors_1.RemoteOperationStepRefusedError(code, message, { projectId, remoteId });
+        };
+        const binding = await this.bindings.get(projectId);
+        if (binding?.state !== 'remote' || binding.remoteId !== remoteId)
+            refuse('GIT_PROJECT_NOT_CONNECTED', 'The project must be connected to this VM to move Git.');
+        const unavailable = () => refuse('GIT_SYNC_UNAVAILABLE', 'The VM Git sync state could not be checked. Restore the VM connection and try again.');
+        const health = await this.health.refresh(remoteId).catch(unavailable);
+        if (!health.online)
+            refuse('GIT_REMOTE_OFFLINE', 'The VM must be online to move Git.');
+        if (health.apiKeyRejected)
+            refuse(host_api_key_1.HOST_API_KEY_REJECTED, host_api_key_1.HOST_API_KEY_REJECTED_MESSAGE);
+        if (!health.versionMatches)
+            refuse('GIT_REMOTE_VERSION_MISMATCH', 'The VM runs a different DevChain version.');
+        const device = await this.host.syncDevice(remoteId).catch(unavailable);
+        if (!(await this.files.isConnected(device.deviceId).catch(unavailable)))
+            refuse('GIT_SYNC_DISCONNECTED', 'There is no file sync connection to the VM.');
+        if (!(await this.files.projectFolders(projectId).catch(unavailable)).some((folder) => folder.kind === 'git'))
+            refuse('GIT_SYNC_FOLDER_MISSING', 'Git sync is not ready for this project. Wait for Connect to finish.');
+        if (!operation || !(0, remote_operation_types_1.stepStarted)(operation, 'git_flip')) {
+            const id = (0, file_sync_service_1.projectFolderId)(projectId, 'git');
+            const [home, vm] = await Promise.all([
+                this.files.folderConfiguration(id).catch(unavailable),
+                this.host.syncFolderConfiguration(remoteId, id).catch(unavailable),
+            ]);
+            const owner = this.owners.get(projectId);
+            if (home.paused ||
+                vm.paused ||
+                home.type !== (owner === 'home' ? 'sendonly' : 'receiveonly') ||
+                vm.type !== (owner === 'vm' ? 'sendonly' : 'receiveonly'))
+                refuse('GIT_SYNC_NOT_READY', 'Git sync is not ready. Let file sync finish its setup, then run the command again.');
+        }
+        if (operation &&
+            !(0, remote_operation_types_1.stepStarted)(operation, 'git_flip') &&
+            this.owners.get(projectId) === operation.details.owner)
+            refuse('GIT_OWNER_CHANGED', 'The Git owner changed before this switch began. Cancel it and run the command again.');
+    }
+    assertCancellable(operation) {
+        if ((0, remote_operation_types_1.stepStarted)(operation, 'git_flip')) {
+            const details = operation.details;
+            throw new remote_operation_errors_1.RemoteOperationStepRefusedError('GIT_SWITCH_UNFINISHED', `Git control is already moving. Repeat \`${(0, git_owner_dto_1.gitOwnerCommand)(details.owner, details.force)}\` to finish.`, { operationId: operation.id });
+        }
+    }
+    retryFrom(operation) {
+        if ((0, remote_operation_types_1.stepStarted)(operation, 'git_flip'))
+            return null;
+        return operation.details.owner === 'home' ? 'vm_guard' : 'pc_guard';
+    }
+    resumeFrom(operation) {
+        return this.retryFrom(operation);
+    }
+    async interrupt(operationId) {
+        this.handoff.interrupt(operationId, 'The Git switch was cancelled.');
+    }
+    async rollback(operation) {
+        this.assertCancellable(operation);
+        const projectId = (0, remote_operation_types_1.requireProjectId)(operation);
+        const details = operation.details;
+        if (details.vmGuardInstalled)
+            await this.host.removeGitGuard(operation.remoteId, projectId);
+        if (details.pcGuardInstalled)
+            await this.guard.remove(projectId, { refreshIndex: false, failOnReadError: true });
+        if ((0, remote_operation_types_1.stepStarted)(operation, 'freeze_host'))
+            await this.host.thaw(operation.remoteId, projectId);
+    }
+    details(run) {
+        return run.details;
+    }
+    async vmGuard(run) {
+        await run.progress({ vmGuardInstalled: true }, { durable: true });
+        const { warning } = await this.host.installGitGuard(run.operation.remoteId, (0, remote_operation_types_1.requireProjectId)(run.operation), { homeName: (0, node_os_1.hostname)(), reason: 'pc-git' });
+        await run.progress({ vmGuardInstalled: warning === null, vmGuardWarning: warning }, { durable: true });
+        if (warning)
+            throw new remote_operation_errors_1.RemoteOperationStepRefusedError('GIT_SWITCH_GUARD_WARNING', warning);
+    }
+    async pcGuard(run) {
+        await run.progress({ pcGuardInstalled: true }, { durable: true });
+        const warning = await this.guard.install((0, remote_operation_types_1.requireProjectId)(run.operation), run.operation.remoteId);
+        await run.progress({ pcGuardInstalled: warning === null, guardWarning: warning }, { durable: true });
+        if (warning)
+            throw new remote_operation_errors_1.RemoteOperationStepRefusedError('GIT_SWITCH_GUARD_WARNING', warning);
+    }
+    async pcGuardRemove(run) {
+        const result = await this.guard.remove((0, remote_operation_types_1.requireProjectId)(run.operation), {
+            refreshIndex: true,
+            failOnReadError: true,
+        });
+        await run.progress({ pcGuardRemove: result }, { durable: true });
+        if (result.warning || result.indexRefreshed !== true)
+            throw new remote_operation_errors_1.RemoteOperationStepRefusedError('GIT_SWITCH_INDEX_REFRESH_FAILED', result.warning ?? 'The PC Git index was not rebuilt. Retry the switch.');
+    }
+    async vmGuardRemove(run) {
+        const result = await this.host.removeGitGuard(run.operation.remoteId, (0, remote_operation_types_1.requireProjectId)(run.operation), { refreshIndex: true });
+        await run.progress({ vmGuardRemove: result }, { durable: true });
+        if (result.warning || result.indexRefreshed !== true)
+            throw new remote_operation_errors_1.RemoteOperationStepRefusedError('GIT_SWITCH_INDEX_REFRESH_FAILED', result.warning ?? 'The VM Git index was not rebuilt. Retry the switch.');
+    }
+};
+exports.GitOwnerOperation = GitOwnerOperation;
+exports.GitOwnerOperation = GitOwnerOperation = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(remote_health_port_1.REMOTE_HEALTH_PORT)),
+    __metadata("design:paramtypes", [Object, remote_bindings_service_1.RemoteBindingsService,
+        remote_host_client_1.RemoteHostClient,
+        file_sync_service_1.FileSyncService,
+        file_sync_handoff_1.FileSyncHandoff,
+        remote_live_sync_service_1.RemoteLiveSyncService,
+        git_owner_store_1.GitOwnerStore,
+        home_git_guard_service_1.HomeGitGuardService])
+], GitOwnerOperation);
+//# sourceMappingURL=git-owner.operation.js.map

package/dist/server/modules/remotes/operations/git-owner.operation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-owner.operation.js","sourceRoot":"","sources":["../../../../src/modules/remotes/operations/git-owner.operation.ts"],"names":[],"mappings":"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"}

package/dist/server/modules/remotes/operations/remote-host.client.d.ts

@@ -2,15 +2,19 @@ import { RemoteApiKeyService } from '../auth/remote-api-key.service';
 import { type HostProviderCliSettings, type HostProviderCliSettingsStatus } from '@devchain/shared';
 import { Readable } from 'node:stream';
 import { DockerVersion } from '../../core/controllers/docker-engine.client';
-import { type DockerArchiveRequest, type DockerArchiveWriteResult, type DockerBindPrepare, type DockerCapacityResult, type DockerContainerCreate, type DockerHostOptions, type DockerImageLoadResult, type DockerNetworkCreate, type DockerScanResult, type DockerVolumeCreate, type DockerVolumeHolder } from '../host/host-docker.dto';
+import { type DockerArchiveRequest, type DockerArchiveWriteResult, type DockerBindPrepare, type DockerCapacityResult, type DockerContainerCreate, type DockerHostOptions, type DockerOwnerOptions, type DockerImageLoadResult, type DockerImageMatchResult, type DockerNetworkCreate, type DockerScanResult, type DockerVolumeCreate, type DockerVolumeHolder } from '../host/host-docker.dto';
 import { TranscriptFilesService } from '../transcripts/transcript-files.service';
 import { type TranscriptFile, type TranscriptRef, type TranscriptListing } from '../transcripts/transcript-transfer.dto';
 import { z } from 'zod';
+import { type RemoteSession } from './git-owner.dto';
 import { type HostSkillSettings, type HostSkillSettingsStatus, type ProjectReplicaChanges, type ProjectReplicaOfScope, type ProjectReplicaV1 } from '@devchain/shared';
 import { AppError } from '../../../common/errors/error-types';
 import { type FrozenProject, type RemoteStorage } from '../../storage/interfaces/storage.interface';
 import { type ProjectTimeSettlement } from '../time/project-time-settler.service';
-import { type FolderSyncStatus, type SyncDevice, type SyncFolder, type SyncFolderPatch, type SyncFolderRequest } from '../../file-sync/file-sync.dto';
+import { type FolderSyncStatus, type RemoteNeed, type SyncDevice, type SyncFolder, type SyncFolderConfiguration, type SyncFolderPatch, type SyncFolderRequest, type SyncStatusOptions, type ForceCopyBackupRequest, type ForceCopyBackup, type ReceiveOnlyChanges } from '../../file-sync/file-sync.dto';
+import { type SyncChownRequest, type SyncChownResult } from '../../file-sync/sync-chown.dto';
+import { type SyncInspectRequest, type SyncPathInspection } from '../../file-sync/sync-path-inspection.dto';
+import { type GitGuardRemoveResult, type GitIndexResult, type VmGitGuardRequest } from '../../file-sync/git-guard.dto';
 import type { ProviderAuthClaimBundle } from '../../provider-auth/provider-auth-adapters';
 import type { HostProviderApplyInput } from '../host/host-provider-auth.service';
 declare const HostRuntimeSchema: z.ZodObject<{
@@ -146,6 +150,19 @@ declare const HostRuntimeSchema: z.ZodObject<{
     homePath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     uid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     gid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    requestedUid: z.ZodOptional<z.ZodNumber>;
+    requestedGid: z.ZodOptional<z.ZodNumber>;
+    primaryGroup: z.ZodOptional<z.ZodString>;
+    uidConflict: z.ZodOptional<z.ZodObject<{
+        requestedUid: z.ZodNumber;
+        holder: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        requestedUid: number;
+        holder: string | null;
+    }, {
+        requestedUid: number;
+        holder: string | null;
+    }>>;
     imageVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     cliVersions: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
 }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
@@ -281,6 +298,19 @@ declare const HostRuntimeSchema: z.ZodObject<{
     homePath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     uid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     gid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    requestedUid: z.ZodOptional<z.ZodNumber>;
+    requestedGid: z.ZodOptional<z.ZodNumber>;
+    primaryGroup: z.ZodOptional<z.ZodString>;
+    uidConflict: z.ZodOptional<z.ZodObject<{
+        requestedUid: z.ZodNumber;
+        holder: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        requestedUid: number;
+        holder: string | null;
+    }, {
+        requestedUid: number;
+        holder: string | null;
+    }>>;
     imageVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     cliVersions: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
 }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
@@ -416,6 +446,19 @@ declare const HostRuntimeSchema: z.ZodObject<{
     homePath: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     uid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     gid: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    requestedUid: z.ZodOptional<z.ZodNumber>;
+    requestedGid: z.ZodOptional<z.ZodNumber>;
+    primaryGroup: z.ZodOptional<z.ZodString>;
+    uidConflict: z.ZodOptional<z.ZodObject<{
+        requestedUid: z.ZodNumber;
+        holder: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        requestedUid: number;
+        holder: string | null;
+    }, {
+        requestedUid: number;
+        holder: string | null;
+    }>>;
     imageVersion: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     cliVersions: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodString>>>;
 }, z.ZodTypeAny, "passthrough">>;
@@ -471,6 +514,7 @@ export interface HostClaimRequest {
     userName: string;
     homePath: string;
     uid?: number;
+    gid?: number;
     version: string;
     port: number;
     providerAuth: ProviderAuthClaimBundle;
@@ -502,15 +546,17 @@ export type HostImportOutcome = {
 export declare class RemoteHostClient {
     private readonly storage;
     private readonly apiKeys;
-    constructor(storage: RemoteStorage, apiKeys: RemoteApiKeyService);
+    private readonly runtimeTimeoutMs;
+    constructor(storage: RemoteStorage, apiKeys: RemoteApiKeyService, runtimeTimeoutMs?: number);
     private dockerClient;
     private dockerCall;
     private dockerJson;
-    dockerScan(remoteId: string, paths: string[], options?: DockerHostOptions, volumes?: string[]): Promise<DockerScanResult>;
+    dockerScan(remoteId: string, paths: string[], options?: DockerHostOptions, volumes?: string[], networks?: string[]): Promise<DockerScanResult>;
     dockerCapacity(remoteId: string, paths: string[], options?: DockerHostOptions): Promise<DockerCapacityResult>;
     dockerImagesPresent(remoteId: string, ids: string[], options?: DockerHostOptions): Promise<{
         ids: string[];
     }>;
+    dockerMatchImages(remoteId: string, refs: string[], options?: DockerHostOptions): Promise<DockerImageMatchResult>;
     dockerCreateVolume(remoteId: string, input: DockerVolumeCreate, options?: DockerHostOptions): Promise<{
         Name: string;
         Labels?: Record<string, string>;
@@ -525,13 +571,13 @@ export declare class RemoteHostClient {
     dockerVolumeHolders(remoteId: string, name: string, options?: DockerHostOptions): Promise<{
         holders: DockerVolumeHolder[];
     }>;
-    dockerDelete(remoteId: string, kind: 'volumes' | 'containers' | 'networks', id: string, projectId: string, options?: DockerHostOptions): Promise<void>;
+    dockerDelete(remoteId: string, kind: 'volumes' | 'containers' | 'networks', id: string, projectId: string, options?: DockerOwnerOptions): Promise<void>;
     dockerSaveImage(remoteId: string, id: string, options?: DockerHostOptions): Promise<Readable>;
     dockerReadArchive(remoteId: string, input: DockerArchiveRequest, options?: DockerHostOptions): Promise<{
         archive: Readable;
         sha256: () => string | null;
     }>;
-    dockerStopContainer(remoteId: string, id: string, projectId: string, options?: DockerHostOptions): Promise<void>;
+    dockerStopContainer(remoteId: string, id: string, projectId: string, options?: DockerOwnerOptions): Promise<void>;
     dockerLoadImage(remoteId: string, body: Readable, options?: DockerHostOptions): Promise<DockerImageLoadResult>;
     dockerWriteArchive(remoteId: string, input: DockerArchiveRequest, body: Readable, options?: DockerHostOptions): Promise<DockerArchiveWriteResult>;
     dockerPrepareBinds(remoteId: string, input: DockerBindPrepare, options?: DockerHostOptions): Promise<void>;
@@ -553,7 +599,17 @@ export declare class RemoteHostClient {
         full: boolean;
     }): Promise<ProjectReplicaChanges>;
     freeze(remoteId: string, projectId: string): Promise<FrozenProject>;
+    installGitGuard(remoteId: string, projectId: string, request: VmGitGuardRequest): Promise<{
+        warning: string | null;
+    }>;
+    removeGitGuard(remoteId: string, projectId: string, options?: {
+        refreshIndex?: boolean;
+    }): Promise<GitGuardRemoveResult>;
+    refreshGitIndex(remoteId: string, projectId: string, since: string | null): Promise<GitIndexResult>;
     thaw(remoteId: string, projectId: string): Promise<void>;
+    listSessions(remoteId: string, projectId?: string, options?: {
+        timeoutMs?: number;
+    }): Promise<RemoteSession[]>;
     stopSessions(remoteId: string, projectId: string): Promise<void>;
     settleTime(remoteId: string, projectId: string): Promise<ProjectTimeSettlement>;
     release(remoteId: string, projectId: string): Promise<void>;
@@ -564,11 +620,19 @@ export declare class RemoteHostClient {
     syncDevice(remoteId: string): Promise<SyncDevice>;
     syncPeer(remoteId: string, peer: SyncDevice): Promise<void>;
     syncFolders(remoteId: string, folder: SyncFolderRequest): Promise<SyncFolder>;
+    syncForceCopyBackup(remoteId: string, request: ForceCopyBackupRequest): Promise<ForceCopyBackup>;
     syncFolderType(remoteId: string, folderId: string, patch: SyncFolderPatch): Promise<void>;
+    syncFolderConfiguration(remoteId: string, folderId: string): Promise<SyncFolderConfiguration>;
     syncRemoveFolder(remoteId: string, folderId: string): Promise<void>;
     syncScan(remoteId: string, folderId: string): Promise<void>;
     syncRevert(remoteId: string, folderId: string): Promise<void>;
-    syncStatus(remoteId: string, folderId: string, deviceId?: string): Promise<FolderSyncStatus>;
+    syncOverride(remoteId: string, folderId: string): Promise<void>;
+    syncLocalChanges(remoteId: string, folderId: string): Promise<ReceiveOnlyChanges>;
+    syncStatus(remoteId: string, folderId: string, deviceId?: string, options?: SyncStatusOptions): Promise<FolderSyncStatus>;
+    syncFolderExists(remoteId: string, folderId: string): Promise<boolean>;
+    syncRemoteNeed(remoteId: string, folderId: string, deviceId: string): Promise<RemoteNeed>;
+    syncInspect(remoteId: string, input: SyncInspectRequest): Promise<SyncPathInspection>;
+    syncChown(remoteId: string, input: SyncChownRequest): Promise<SyncChownResult>;
     setInstanceLabel(remoteId: string, label: string): Promise<void>;
     remoteRuntime(remoteId: string): Promise<HostRuntime>;
     certificateOf(remoteId: string): Promise<string>;