devchain-cli 0.24.2 → 0.26.0

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

@@ -1,516 +1,28 @@
-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 DockerOwnerOptions, type DockerImageLoadResult, type DockerImageMatchResult, type DockerNetworkCreate, type DockerScanResult, type DockerVolumeCreate, type DockerVolumeHolder } from '../host/host-docker.dto';
+import type { HostProviderCliSettings, HostProviderCliSettingsStatus, HostSkillSettings, HostSkillSettingsStatus, ProjectReplicaChanges, ProjectReplicaOfScope, ProjectReplicaV1 } from '@devchain/shared';
+import type { FrozenProject, RemoteStorage } from '../../storage/interfaces/storage.interface';
+import type { DockerVersion } from '../../core/controllers/docker-engine.client';
+import type { DockerArchiveRequest, DockerArchiveWriteResult, DockerBindPrepare, DockerCapacityResult, DockerContainerCreate, DockerHostOptions, DockerOwnerOptions, DockerImageLoadResult, DockerImageMatchResult, DockerNetworkCreate, DockerScanResult, DockerVolumeCreate, 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 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 { TranscriptFile, TranscriptRef, TranscriptListing } from '../transcripts/transcript-transfer.dto';
+import type { RemoteSession } from './git-owner.dto';
+import type { ProjectTimeSettlement } from '../time/project-time-settler.dto';
+import type { FolderSyncStatus, RemoteNeed, SyncDevice, SyncFolder, SyncFolderConfiguration, SyncFolderPatch, SyncFolderRequest, SyncStatusOptions, ForceCopyBackupRequest, ForceCopyBackup, ReceiveOnlyChanges } from '../../file-sync/file-sync.dto';
+import type { SyncInspectRequest, SyncPathInspection } from '../../file-sync/sync-path-inspection.dto';
+import type { GitGuardRemoveResult, 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<{
-    state: z.ZodOptional<z.ZodString>;
-    bootId: z.ZodOptional<z.ZodString>;
-    docker: z.ZodOptional<z.ZodObject<{
-        installed: z.ZodBoolean;
-        engineVersion: z.ZodNullable<z.ZodString>;
-        composeVersion: z.ZodNullable<z.ZodString>;
-        userInGroup: z.ZodBoolean;
-        dataRootFreeBytes: z.ZodNullable<z.ZodNumber>;
-        capacity: z.ZodOptional<z.ZodObject<{
-            dockerRoot: z.ZodNullable<z.ZodObject<{
-                path: z.ZodString;
-                filesystemId: z.ZodString;
-                freeBytes: z.ZodNumber;
-            }, "strip", z.ZodTypeAny, {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            }, {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            }>>;
-            imageStore: z.ZodNullable<z.ZodObject<{
-                path: z.ZodString;
-                filesystemId: z.ZodString;
-                freeBytes: z.ZodNumber;
-            }, "strip", z.ZodTypeAny, {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            }, {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            }>>;
-            home: z.ZodNullable<z.ZodObject<{
-                path: z.ZodString;
-                filesystemId: z.ZodString;
-                freeBytes: z.ZodNumber;
-            }, "strip", z.ZodTypeAny, {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            }, {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            }>>;
-        }, "strip", z.ZodTypeAny, {
-            dockerRoot: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-            imageStore: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-            home: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-        }, {
-            dockerRoot: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-            imageStore: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-            home: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        installed: boolean;
-        engineVersion: string | null;
-        composeVersion: string | null;
-        userInGroup: boolean;
-        dataRootFreeBytes: number | null;
-        capacity?: {
-            dockerRoot: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-            imageStore: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-            home: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-        } | undefined;
-    }, {
-        installed: boolean;
-        engineVersion: string | null;
-        composeVersion: string | null;
-        userInGroup: boolean;
-        dataRootFreeBytes: number | null;
-        capacity?: {
-            dockerRoot: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-            imageStore: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-            home: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-        } | undefined;
-    }>>;
-    version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    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<{
-    state: z.ZodOptional<z.ZodString>;
-    bootId: z.ZodOptional<z.ZodString>;
-    docker: z.ZodOptional<z.ZodObject<{
-        installed: z.ZodBoolean;
-        engineVersion: z.ZodNullable<z.ZodString>;
-        composeVersion: z.ZodNullable<z.ZodString>;
-        userInGroup: z.ZodBoolean;
-        dataRootFreeBytes: z.ZodNullable<z.ZodNumber>;
-        capacity: z.ZodOptional<z.ZodObject<{
-            dockerRoot: z.ZodNullable<z.ZodObject<{
-                path: z.ZodString;
-                filesystemId: z.ZodString;
-                freeBytes: z.ZodNumber;
-            }, "strip", z.ZodTypeAny, {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            }, {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            }>>;
-            imageStore: z.ZodNullable<z.ZodObject<{
-                path: z.ZodString;
-                filesystemId: z.ZodString;
-                freeBytes: z.ZodNumber;
-            }, "strip", z.ZodTypeAny, {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            }, {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            }>>;
-            home: z.ZodNullable<z.ZodObject<{
-                path: z.ZodString;
-                filesystemId: z.ZodString;
-                freeBytes: z.ZodNumber;
-            }, "strip", z.ZodTypeAny, {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            }, {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            }>>;
-        }, "strip", z.ZodTypeAny, {
-            dockerRoot: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-            imageStore: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-            home: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-        }, {
-            dockerRoot: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-            imageStore: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-            home: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        installed: boolean;
-        engineVersion: string | null;
-        composeVersion: string | null;
-        userInGroup: boolean;
-        dataRootFreeBytes: number | null;
-        capacity?: {
-            dockerRoot: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-            imageStore: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-            home: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-        } | undefined;
-    }, {
-        installed: boolean;
-        engineVersion: string | null;
-        composeVersion: string | null;
-        userInGroup: boolean;
-        dataRootFreeBytes: number | null;
-        capacity?: {
-            dockerRoot: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-            imageStore: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-            home: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-        } | undefined;
-    }>>;
-    version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    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<{
-    state: z.ZodOptional<z.ZodString>;
-    bootId: z.ZodOptional<z.ZodString>;
-    docker: z.ZodOptional<z.ZodObject<{
-        installed: z.ZodBoolean;
-        engineVersion: z.ZodNullable<z.ZodString>;
-        composeVersion: z.ZodNullable<z.ZodString>;
-        userInGroup: z.ZodBoolean;
-        dataRootFreeBytes: z.ZodNullable<z.ZodNumber>;
-        capacity: z.ZodOptional<z.ZodObject<{
-            dockerRoot: z.ZodNullable<z.ZodObject<{
-                path: z.ZodString;
-                filesystemId: z.ZodString;
-                freeBytes: z.ZodNumber;
-            }, "strip", z.ZodTypeAny, {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            }, {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            }>>;
-            imageStore: z.ZodNullable<z.ZodObject<{
-                path: z.ZodString;
-                filesystemId: z.ZodString;
-                freeBytes: z.ZodNumber;
-            }, "strip", z.ZodTypeAny, {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            }, {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            }>>;
-            home: z.ZodNullable<z.ZodObject<{
-                path: z.ZodString;
-                filesystemId: z.ZodString;
-                freeBytes: z.ZodNumber;
-            }, "strip", z.ZodTypeAny, {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            }, {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            }>>;
-        }, "strip", z.ZodTypeAny, {
-            dockerRoot: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-            imageStore: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-            home: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-        }, {
-            dockerRoot: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-            imageStore: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-            home: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-        }>>;
-    }, "strip", z.ZodTypeAny, {
-        installed: boolean;
-        engineVersion: string | null;
-        composeVersion: string | null;
-        userInGroup: boolean;
-        dataRootFreeBytes: number | null;
-        capacity?: {
-            dockerRoot: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-            imageStore: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-            home: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-        } | undefined;
-    }, {
-        installed: boolean;
-        engineVersion: string | null;
-        composeVersion: string | null;
-        userInGroup: boolean;
-        dataRootFreeBytes: number | null;
-        capacity?: {
-            dockerRoot: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-            imageStore: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-            home: {
-                path: string;
-                filesystemId: string;
-                freeBytes: number;
-            } | null;
-        } | undefined;
-    }>>;
-    version: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    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">>;
-export type HostRuntime = z.infer<typeof HostRuntimeSchema>;
-declare const HostProviderVerifySchema: z.ZodObject<{
-    ok: z.ZodBoolean;
-    summary: z.ZodString;
-    hint: z.ZodNullable<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    ok: boolean;
-    summary: string;
-    hint: string | null;
-}, {
-    ok: boolean;
-    summary: string;
-    hint: string | null;
-}>;
-export type HostProviderVerify = z.infer<typeof HostProviderVerifySchema>;
-declare const HostUpdateStatusBodySchema: z.ZodObject<{
-    status: z.ZodNullable<z.ZodObject<Omit<{
-        state: z.ZodEnum<["pending", "installing", "installing_clis", "restarting", "done", "failed"]>;
-        version: z.ZodString;
-        error: z.ZodOptional<z.ZodString>;
-        at: z.ZodString;
-    }, "at">, "passthrough", z.ZodTypeAny, z.objectOutputType<Omit<{
-        state: z.ZodEnum<["pending", "installing", "installing_clis", "restarting", "done", "failed"]>;
-        version: z.ZodString;
-        error: z.ZodOptional<z.ZodString>;
-        at: z.ZodString;
-    }, "at">, z.ZodTypeAny, "passthrough">, z.objectInputType<Omit<{
-        state: z.ZodEnum<["pending", "installing", "installing_clis", "restarting", "done", "failed"]>;
-        version: z.ZodString;
-        error: z.ZodOptional<z.ZodString>;
-        at: z.ZodString;
-    }, "at">, z.ZodTypeAny, "passthrough">>>;
-}, "strip", z.ZodTypeAny, {
-    status: z.objectOutputType<Omit<{
-        state: z.ZodEnum<["pending", "installing", "installing_clis", "restarting", "done", "failed"]>;
-        version: z.ZodString;
-        error: z.ZodOptional<z.ZodString>;
-        at: z.ZodString;
-    }, "at">, z.ZodTypeAny, "passthrough"> | null;
-}, {
-    status: z.objectInputType<Omit<{
-        state: z.ZodEnum<["pending", "installing", "installing_clis", "restarting", "done", "failed"]>;
-        version: z.ZodString;
-        error: z.ZodOptional<z.ZodString>;
-        at: z.ZodString;
-    }, "at">, z.ZodTypeAny, "passthrough"> | null;
-}>;
-export type HostUpdateProgress = NonNullable<z.infer<typeof HostUpdateStatusBodySchema>['status']>;
+import type { HostProviderApplyInput } from '../host/host-provider-auth.dto';
+import { RemoteApiKeyService } from '../auth/remote-api-key.service';
+import { hostRoutes } from '../contract/host-routes';
+import type { HostProviderUsageSettings, HostProviderUsageSettingsStatus, HostProviderVerify, HostRouteBody, HostRouteResult, HostRuntime, HostUpdateProgress } from '../contract/host-routes';
+import type { SharedVmRoster } from '../dtos/shared-vm.dto';
+import type { VmDestroyFence } from '../../../common/config/vm-destroy-fence';
+import type { SharedVmNotifyResult } from '../host/shared-vm.contract';
+import type { GitCoordinatorRecord, GitCoordinatorStatus, GitFence } from '../git-coordinator/git-coordinator.dto';
+export type { HostRuntime, HostProviderVerify } from '../contract/host-routes';
+export { RemoteHostRequestError } from '../transport/host-transport';
 export interface HostClaimRequest {
+    nonce?: string;
     userName: string;
     homePath: string;
     uid?: number;
@@ -520,22 +32,7 @@ export interface HostClaimRequest {
     providerAuth: ProviderAuthClaimBundle;
 }
 export type HostClaimOutcome = 'claimed' | 'starting' | 'already_claimed';
-export interface HostEpicCreate {
-    projectId: string;
-    statusId: string;
-    title: string;
-    description: string | null;
-    data: Record<string, unknown> | null;
-}
-export declare class RemoteHostRequestError extends AppError {
-    constructor(message: string, details: {
-        remoteId: string;
-        path: string;
-        status: number | null;
-        hostCode: string | null;
-    });
-    get status(): number | null;
-}
+export type HostEpicCreate = HostRouteBody<typeof hostRoutes.createEpic>;
 export type HostImportOutcome = {
     imported: true;
     cursor: string;
@@ -548,6 +45,16 @@ export declare class RemoteHostClient {
     private readonly apiKeys;
     private readonly runtimeTimeoutMs;
     constructor(storage: RemoteStorage, apiKeys: RemoteApiKeyService, runtimeTimeoutMs?: number);
+    private target;
+    private call;
+    sharedVmNotices(remoteId: string): Promise<HostRouteResult<typeof hostRoutes.sharedVmNotices>['body']['notices']>;
+    sharedVmDismiss(remoteId: string, id: string): Promise<void>;
+    sharedVmAbandon(remoteId: string, projectId: string): Promise<void>;
+    sharedVmRoster(remoteId: string): Promise<SharedVmRoster>;
+    sharedVmNotify(remoteId: string, body: HostRouteBody<typeof hostRoutes.sharedVmNotify>): Promise<SharedVmNotifyResult>;
+    sharedVmFence(remoteId: string, body: HostRouteBody<typeof hostRoutes.sharedVmFence>): Promise<{
+        fence: VmDestroyFence | null;
+    }>;
     private dockerClient;
     private dockerCall;
     private dockerJson;
@@ -598,14 +105,33 @@ export declare class RemoteHostClient {
         since: string | null;
         full: boolean;
     }): Promise<ProjectReplicaChanges>;
+    listWorktrees(remoteId: string, projectId: string): Promise<{
+        lanes: {
+            dirty: boolean;
+            path: string;
+            name: string;
+            branch: string;
+        }[];
+    }>;
+    setLaneAdmission(remoteId: string, projectId: string, frozen: boolean): Promise<void>;
     freeze(remoteId: string, projectId: string): Promise<FrozenProject>;
-    installGitGuard(remoteId: string, projectId: string, request: VmGitGuardRequest): Promise<{
+    gitCoordinatorStatus(remoteId: string, projectId: string): Promise<GitCoordinatorStatus>;
+    gitCoordinatorIndex(remoteId: string, projectId: string): Promise<Buffer>;
+    homeWriteBegin(remoteId: string, projectId: string, body: HostRouteBody<typeof hostRoutes.homeWriteBegin>): Promise<GitCoordinatorRecord>;
+    homeWriteEnd(remoteId: string, projectId: string, body: HostRouteBody<typeof hostRoutes.homeWriteEnd>): Promise<GitCoordinatorRecord>;
+    handoverBegin(remoteId: string, projectId: string, body: HostRouteBody<typeof hostRoutes.handoverBegin>): Promise<GitCoordinatorRecord>;
+    handoverRenew(remoteId: string, projectId: string, body: GitFence): Promise<GitCoordinatorRecord>;
+    handoverAbort(remoteId: string, projectId: string, body: GitFence): Promise<GitCoordinatorRecord>;
+    handoverPhase(remoteId: string, projectId: string, body: HostRouteBody<typeof hostRoutes.handoverPhase>): Promise<GitCoordinatorRecord>;
+    handoverComplete(remoteId: string, projectId: string, body: GitFence): Promise<GitCoordinatorRecord>;
+    gitCoordinatorClose(remoteId: string, projectId: string): Promise<GitCoordinatorRecord>;
+    gitCoordinatorReopen(remoteId: string, projectId: string): Promise<GitCoordinatorRecord>;
+    installGitGuard(remoteId: string, projectId: string, request: VmGitGuardRequest, fence?: GitFence): Promise<{
         warning: string | null;
     }>;
     removeGitGuard(remoteId: string, projectId: string, options?: {
         refreshIndex?: boolean;
-    }): Promise<GitGuardRemoveResult>;
-    refreshGitIndex(remoteId: string, projectId: string, since: string | null): Promise<GitIndexResult>;
+    }, fence?: GitFence): Promise<GitGuardRemoveResult>;
     thaw(remoteId: string, projectId: string): Promise<void>;
     listSessions(remoteId: string, projectId?: string, options?: {
         timeoutMs?: number;
@@ -619,20 +145,23 @@ export declare class RemoteHostClient {
     }>;
     syncDevice(remoteId: string): Promise<SyncDevice>;
     syncPeer(remoteId: string, peer: SyncDevice): Promise<void>;
-    syncFolders(remoteId: string, folder: SyncFolderRequest): Promise<SyncFolder>;
+    syncFolders(remoteId: string, folder: SyncFolderRequest, gitFence?: GitFence): Promise<SyncFolder>;
     syncForceCopyBackup(remoteId: string, request: ForceCopyBackupRequest): Promise<ForceCopyBackup>;
-    syncFolderType(remoteId: string, folderId: string, patch: SyncFolderPatch): Promise<void>;
+    syncFolderType(remoteId: string, folderId: string, patch: SyncFolderPatch, gitFence?: GitFence): 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>;
-    syncOverride(remoteId: string, folderId: string): Promise<void>;
+    syncFolderIgnores(remoteId: string, folderId: string): Promise<{
+        ignore: string[];
+    }>;
+    syncRemoveFolder(remoteId: string, folderId: string, gitFence?: GitFence): Promise<void>;
+    syncScan(remoteId: string, folderId: string, gitFence?: GitFence): Promise<void>;
+    syncRevert(remoteId: string, folderId: string, gitFence?: GitFence): Promise<void>;
+    syncOverride(remoteId: string, folderId: string, gitFence?: GitFence): 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>;
+    syncRemoteNeedThrough(remoteId: string, folderId: string, deviceId: string, sequence: number): Promise<string[]>;
     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>;
@@ -645,7 +174,11 @@ export declare class RemoteHostClient {
     verifyProviderAuth(remoteId: string, provider: string, opencodeProviderIds: string[]): Promise<HostProviderVerify>;
     applyProviderAuth(remoteId: string, bundle: HostProviderApplyInput): Promise<void>;
     applySshKeys(remoteId: string, keys: string[]): Promise<void>;
-    requestHostUpdate(remoteId: string, version: string): Promise<'started' | 'in_progress'>;
+    requestHostUpdate(remoteId: string, version: string, npmRegistry?: string): Promise<{
+        outcome: 'started' | 'in_progress';
+        registryIgnored: boolean;
+    }>;
+    private sendHostUpdate;
     hostUpdateStatus(remoteId: string): Promise<HostUpdateProgress | null>;
     requestDocker(remoteId: string): Promise<{
         jobId: string | null;
@@ -660,12 +193,10 @@ export declare class RemoteHostClient {
     getProviderCliSettingsStatus(remoteId: string): Promise<HostProviderCliSettingsStatus>;
     putProviderCliSettings(remoteId: string, body: HostProviderCliSettings): Promise<void>;
     checkProviderClis(remoteId: string): Promise<void>;
+    getProviderUsageSettingsStatus(remoteId: string): Promise<HostProviderUsageSettingsStatus>;
+    putProviderUsageSettings(remoteId: string, body: HostProviderUsageSettings): Promise<void>;
     getSkillSettingsStatus(remoteId: string): Promise<HostSkillSettingsStatus>;
     putSkillSettings(remoteId: string, body: HostSkillSettings): Promise<void>;
     uploadSkillSourceContent(remoteId: string, name: string, contentHash: string, stream: Readable, signal?: AbortSignal): Promise<void>;
-    private hostSettingsRequest;
-    private request;
-    private fetchUrl;
 }
 export declare function dialAddress(address: string, baseUrl: string): string;
-export {};