Add SCUM file management workbench

platform_web/api/client.ts

@@ -36,6 +36,7 @@ import type {
   CurrentUserResponse,
   DependencyCatalogResponse,
   DependencyJobRequest,
+  DeclaredFileReadSnapshotResponse,
   FileOperationDispatchRequest,
   FileOperationDispatchResponse,
   GameClientBridgeCancelRequest,
@@ -627,6 +628,11 @@ export class PlatformApiClient {
     });
   }
 
+  async getDeclaredFileReadSnapshot(serverInstanceId: string, fileKey: string): Promise<DeclaredFileReadSnapshotResponse> {
+    const query = new URLSearchParams({ key: fileKey });
+    return this.request<DeclaredFileReadSnapshotResponse>(`/server-instances/${encodeURIComponent(serverInstanceId)}/files/read-snapshot?${query.toString()}`);
+  }
+
   async listLogStreams(): Promise<LogStreamListResponse> {
     return this.request<LogStreamListResponse>("/log-streams");
   }

platform_web/api/types.ts

@@ -1455,6 +1455,20 @@ export interface FileOperationDispatchResponse {
   job: JobResponse;
 }
 
+export interface DeclaredFileReadSnapshotResponse {
+  serverInstanceId: string;
+  pluginId: string;
+  key: string;
+  state: "ready" | "pending" | "not-read" | string;
+  content?: string;
+  version?: number;
+  checksum?: string;
+  sizeBytes?: number;
+  jobId?: string;
+  readAt?: string;
+  reason?: string;
+}
+
 export interface LogStreamResponse {
   id: string;
   serverInstanceId: string;