devchain-cli 0.24.2 → 0.25.0

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

@@ -1,515 +1,22 @@
-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, GitIndexResult, 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 { HostProviderVerify, HostRouteBody, HostRuntime, HostUpdateProgress } from '../contract/host-routes';
+export type { HostRuntime, HostProviderVerify } from '../contract/host-routes';
+export { RemoteHostRequestError } from '../transport/host-transport';
 export interface HostClaimRequest {
     userName: string;
     homePath: string;
@@ -520,22 +27,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 +40,8 @@ export declare class RemoteHostClient {
     private readonly apiKeys;
     private readonly runtimeTimeoutMs;
     constructor(storage: RemoteStorage, apiKeys: RemoteApiKeyService, runtimeTimeoutMs?: number);
+    private target;
+    private call;
     private dockerClient;
     private dockerCall;
     private dockerJson;
@@ -623,6 +117,9 @@ export declare class RemoteHostClient {
     syncForceCopyBackup(remoteId: string, request: ForceCopyBackupRequest): Promise<ForceCopyBackup>;
     syncFolderType(remoteId: string, folderId: string, patch: SyncFolderPatch): Promise<void>;
     syncFolderConfiguration(remoteId: string, folderId: string): Promise<SyncFolderConfiguration>;
+    syncFolderIgnores(remoteId: string, folderId: string): Promise<{
+        ignore: string[];
+    }>;
     syncRemoveFolder(remoteId: string, folderId: string): Promise<void>;
     syncScan(remoteId: string, folderId: string): Promise<void>;
     syncRevert(remoteId: string, folderId: string): Promise<void>;
@@ -632,7 +129,6 @@ export declare class RemoteHostClient {
     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>;
@@ -663,9 +159,5 @@ export declare class RemoteHostClient {
     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 {};