@ludeo/cloud-common 1.2.262-ygbeta1 → 1.2.262

package/src/v4/contexts/cloud-session-context.ts

@@ -99,8 +99,4 @@ export class CloudSessionContext {
   @IsOptional()
   @IsString()
   machineClass?: string;
-
-  @IsOptional()
-  @IsString()
-  instanceType: string;
 }

package/src/v4/events/ludeocast-agent/detect-artifacts-ended.ts

@@ -0,0 +1,48 @@
+import { IsBoolean, IsEnum, IsObject, IsOptional, IsString, IsUUID } from 'class-validator';
+import { ValidateNestedType } from '../../../decorators';
+import { ArtifactKeyParts } from '../../types/site-controller/types';
+import { BaseCommandPayload } from '../base/base';
+import { AGENT_STRING, WILDCARD_MQTT_STRING } from '../base/constants';
+import { SiteOperationStatus } from '../../types/site-controller';
+
+const DETECT_ARTIFACTS_ENDED = 'detect-artifacts-ended';
+
+/** Agent → site-controller: scan finished after `detect-artifacts` (machine-scoped topic; game-scoped correlation). */
+export class DetectArtifactsEndedPayload extends BaseCommandPayload {
+  @IsUUID()
+  gameResourceId: string;
+
+  @IsEnum(SiteOperationStatus)
+  status: SiteOperationStatus;
+
+  @IsOptional()
+  @IsString()
+  reason?: string;
+
+  /** Parent prefix under cache root (echo of `detect-artifacts` command). */
+  @IsString()
+  artifactPrefix: string;
+
+  /** Bundle version scanned (echo of `detect-artifacts` command `latestVersion`). */
+  @IsString()
+  latestVersion: string;
+
+  /** Echo of `detect-artifacts` `forceReport`. Auto-upload only when true. */
+  @IsOptional()
+  @IsBoolean()
+  forceReport?: boolean;
+
+  /** Echo of `detect-artifacts.artifactKeyParts`. */
+  @ValidateNestedType(() => ArtifactKeyParts)
+  artifactKeyParts: ArtifactKeyParts;
+
+  @IsOptional()
+  @IsObject()
+  artifacts?: Record<string, number>;
+}
+
+export function getDetectArtifactsEndedTopic(machineResourceId: string): string {
+  return `${AGENT_STRING}/${DETECT_ARTIFACTS_ENDED}/${machineResourceId}`;
+}
+
+export const DETECT_ARTIFACTS_ENDED_SUBSCRIBE_PATTERN = `$share/site-controller-group/${AGENT_STRING}/${DETECT_ARTIFACTS_ENDED}/${WILDCARD_MQTT_STRING}`;

package/src/v4/events/ludeocast-agent/index.ts

@@ -1,2 +1,4 @@
 export * from './resource-update';
-export * from './export-logs-ended';
+export * from './export-logs-ended';
+export * from './detect-artifacts-ended';
+export * from './save-artifacts-ended';

package/src/v4/events/ludeocast-agent/save-artifacts-ended.ts

@@ -0,0 +1,38 @@
+import { IsEnum, IsOptional, IsString, IsUUID } from 'class-validator';
+import { ValidateNestedType } from '../../../decorators';
+import { ArtifactKeyParts } from '../../types/site-controller/types';
+import { BaseCommandPayload } from '../base/base';
+import { AGENT_STRING, WILDCARD_MQTT_STRING } from '../base/constants';
+import { SiteOperationStatus } from '../../types/site-controller';
+
+const SAVE_ARTIFACTS_ENDED = 'save-artifacts-ended';
+
+/** Agent → site-controller: result of presigned PUT uploads after `save-artifacts` (machine-scoped topic; game-scoped correlation). */
+export class SaveArtifactsEndedPayload extends BaseCommandPayload {
+  @IsUUID()
+  gameResourceId: string;
+
+  @IsEnum(SiteOperationStatus)
+  status: SiteOperationStatus;
+
+  @IsOptional()
+  @IsString()
+  reason?: string;
+
+  @IsString()
+  artifactPrefix: string;
+
+  /** Echo of `save-artifacts.targetVersion` — server-minted publish destination the agent uploaded to. */
+  @IsString()
+  targetVersion: string;
+
+  /** Echo of `save-artifacts.artifactKeyParts`; site-controller persists registry row with `latestVersion` = `targetVersion` on success. */
+  @ValidateNestedType(() => ArtifactKeyParts)
+  artifactKeyParts: ArtifactKeyParts;
+}
+
+export function getSaveArtifactsEndedTopic(machineResourceId: string): string {
+  return `${AGENT_STRING}/${SAVE_ARTIFACTS_ENDED}/${machineResourceId}`;
+}
+
+export const SAVE_ARTIFACTS_ENDED_SUBSCRIBE_PATTERN = `$share/site-controller-group/${AGENT_STRING}/${SAVE_ARTIFACTS_ENDED}/${WILDCARD_MQTT_STRING}`;

package/src/v4/events/site-controller/detect-artifacts.command.ts

@@ -0,0 +1,50 @@
+import { IsBoolean, IsOptional, IsString, IsUUID } from 'class-validator';
+import { ValidateNestedType } from '../../../decorators';
+import { ArtifactKeyParts } from '../../types/site-controller/types';
+import { BaseCommand, BaseCommandPayload } from '../base/base';
+
+/**
+ * MQTT `detect-artifacts` payload. Must include the registry **`artifactKeyParts`** triple (same Redis row as
+ * start-game resolution). `gameResourceId` correlates `detect-artifacts-ended`; `machineResourceId` is on
+ * {@link BaseCommandPayload}.
+ */
+export class DetectArtifactsCommandPayload extends BaseCommandPayload {
+  /** Game session this detect pass belongs to (same role as {@link ExportLogsEndedPayload.gameResourceId}). */
+  @IsUUID()
+  gameResourceId: string;
+
+  /**
+   * Parent prefix under artifact root (excludes `latestVersion`; may include folder segment e.g. `shader-cache/...`
+   * — same shape as `{@link RuntimeArtifactsPayload.artifactPrefix}` / adapter responses).
+   */
+  @IsString()
+  artifactPrefix: string;
+
+  /** Current bundle version segment to list on disk. */
+  @IsString()
+  latestVersion: string;
+
+  /**
+   * Registry row triple; must match game + machine resources. Echoed on `detect-artifacts-ended` so site-controller
+   * can gate auto-save without re-deriving segments.
+   */
+  @ValidateNestedType(() => ArtifactKeyParts)
+  artifactKeyParts: ArtifactKeyParts;
+
+  /**
+   * When true, agent scans `{artifactPrefix}/{latestVersion}` under its artifact cache root and returns keys→sizes on `detect-artifacts-ended`.
+   * Use for manual inventory before issuing `save-artifacts`. Default false keeps detect cheap (empty inventory).
+   */
+  @IsOptional()
+  @IsBoolean()
+  forceReport?: boolean;
+}
+
+export class DetectArtifactsCommand extends BaseCommand<DetectArtifactsCommandPayload> {
+  @ValidateNestedType(() => DetectArtifactsCommandPayload)
+  payload: DetectArtifactsCommandPayload;
+
+  constructor(payload: DetectArtifactsCommandPayload) {
+    super(payload.machineResourceId, 'detect-artifacts', payload);
+  }
+}

package/src/v4/events/site-controller/index.ts

@@ -19,3 +19,5 @@ export * from "./terminate-game.command";
 export * from "./start-game.command";
 export * from "./shutdown.command";
 export * from "./export-logs.command";
+export * from "./detect-artifacts.command";
+export * from "./save-artifacts.command";

package/src/v4/events/site-controller/save-artifacts.command.ts

@@ -0,0 +1,39 @@
+import { IsArray, IsString, IsUUID } from 'class-validator';
+import { ValidateNestedType } from '../../../decorators';
+import { BaseCommand, BaseCommandPayload } from '../base/base';
+import { RuntimeArtifactPresignedUploadDto } from '../../types/site-controller/runtime-artifacts.dto';
+import { ArtifactKeyParts } from '../../types/site-controller/types';
+
+/** Machine-scoped PUT pass: `artifactPrefix` + **`targetVersion`** + presigned **`uploads`** per object key. */
+export class SaveArtifactsCommandPayload extends BaseCommandPayload {
+  /** Game session this upload pass belongs to (parity with `{@link DetectArtifactsCommandPayload.gameResourceId}`). */
+  @IsUUID()
+  gameResourceId: string;
+
+  @IsString()
+  artifactPrefix: string;
+
+  /**
+   * Server-minted publish target (semver bump destination). Distinct from on-disk **`latestVersion`** in
+   * `detect-artifacts`. Agent must echo this in `save-artifacts-ended.targetVersion`.
+   */
+  @IsString()
+  targetVersion: string;
+
+  /** Registry triple this publish belongs to. Agent echoes back so site-controller can persist on success. */
+  @ValidateNestedType(() => ArtifactKeyParts)
+  artifactKeyParts: ArtifactKeyParts;
+
+  @IsArray()
+  @ValidateNestedType(() => RuntimeArtifactPresignedUploadDto)
+  uploads: RuntimeArtifactPresignedUploadDto[];
+}
+
+export class SaveArtifactsCommand extends BaseCommand<SaveArtifactsCommandPayload> {
+  @ValidateNestedType(() => SaveArtifactsCommandPayload)
+  payload: SaveArtifactsCommandPayload;
+
+  constructor(payload: SaveArtifactsCommandPayload) {
+    super(payload.machineResourceId, 'save-artifacts', payload);
+  }
+}

package/src/v4/types/cloud/allocation-data.ts

@@ -10,7 +10,7 @@ export type CloudProviderAllocationData =
   | MockAllocationData
   | LudeoCastAllocationData
   | LudeoCastV2AllocationData;
-
+  
 export const getAllocationDataType = ({
   object,
   property,
@@ -21,7 +21,7 @@ export const getAllocationDataType = ({
   }
 
   if ("signalingURI" in allocationData) {
-    return LudeoCastV2AllocationData;
+    return LudeoCastAllocationData;
   }
 
   return MockAllocationData;

package/src/v4/types/site-controller/runtime-artifacts.dto.ts

@@ -1,16 +1,26 @@
-import { IsArray, IsOptional, IsString } from 'class-validator';
+import { IsArray, IsObject, IsOptional, IsString } from 'class-validator';
 import { ValidateNestedType } from '../../../decorators/validate-nested-type.decorator';
 
-export class RuntimeArtifactUploadObjectDto {
+/**
+ * Single object the client wants PUT URLs for (site-controller → site-adapter HTTP).
+ * No URL yet — only key + headers the signer may bind into the signature.
+ */
+export class RuntimeArtifactUploadPresignSpecDto {
   @IsString()
   key: string;
 
+  /** If set, adapters typically bind this into the presigned PUT; client must repeat on upload. Agent can infer (e.g. `mime`/extension). */
   @IsOptional()
   @IsString()
   contentType?: string;
+
+  /** Optional custom metadata echoed back when adapters sign with it (S3 / GCS). */
+  @IsOptional()
+  @IsObject()
+  metadata?: Record<string, string>;
 }
 
-/** Full bucket object key paired with a presigned URL (adapter responses and MQTT `runtimeArtifacts.downloads`). */
+/** Full bucket object key paired with a presigned GET URL (`runtimeArtifacts.downloads`). */
 export class ObjectKeyUrlPair {
   @IsString()
   key: string;
@@ -19,6 +29,35 @@ export class ObjectKeyUrlPair {
   url: string;
 }
 
+/**
+ * Presigned PUT target (adapter reply, MQTT `save-artifacts.uploads`): full key, URL, echoed header binding.
+ *
+ * `key` is the **destination** object key (bound into the signed PUT URL). When `sourceKey` is set, the
+ * agent reads the file body from that cache-root-relative path instead of `key` — used by site-controller
+ * when destination version (`{prefix}/{targetVersion}/...`) differs from the agent's on-disk version.
+ */
+export class RuntimeArtifactPresignedUploadDto {
+  @IsString()
+  key: string;
+
+  @IsString()
+  url: string;
+
+  /** Optional cache-root-relative read path for the agent (defaults to `key` when omitted). */
+  @IsOptional()
+  @IsString()
+  sourceKey?: string;
+
+  /** Echo of spec / signer — agent MUST send matching `Content-Type` on PUT when present. */
+  @IsOptional()
+  @IsString()
+  contentType?: string;
+
+  @IsOptional()
+  @IsObject()
+  metadata?: Record<string, string>;
+}
+
 export class RuntimeArtifactsDownloadUrlsRequestDto {
   /** Client-relative parent path inside the artifact root (no trailing `latestVersion`; no artifact-folder prefix — adapters add RUNTIME_ARTIFACTS_FOLDER). */
   @IsString()
@@ -30,8 +69,8 @@ export class RuntimeArtifactsDownloadUrlsRequestDto {
 
 export class RuntimeArtifactsUploadUrlsRequestDto {
   @IsArray()
-  @ValidateNestedType(() => RuntimeArtifactUploadObjectDto)
-  objects: RuntimeArtifactUploadObjectDto[];
+  @ValidateNestedType(() => RuntimeArtifactUploadPresignSpecDto)
+  objects: RuntimeArtifactUploadPresignSpecDto[];
 }
 
 export class RuntimeArtifactsDownloadUrlsResponseDto {
@@ -44,8 +83,8 @@ export class RuntimeArtifactsDownloadUrlsResponseDto {
   artifactPrefix: string;
 }
 
-export class RuntimeArtifactsUploadUrlsResponseDto {
+export class RuntimeArtifactsUploadsResponseDto {
   @IsArray()
-  @ValidateNestedType(() => ObjectKeyUrlPair)
-  urls: ObjectKeyUrlPair[];
+  @ValidateNestedType(() => RuntimeArtifactPresignedUploadDto)
+  uploads: RuntimeArtifactPresignedUploadDto[];
 }

package/src/v4/types/site-controller/types.ts

@@ -11,6 +11,18 @@ export enum MachineMode {
   PROTON_V2 = "proton-v2",
 }
 
+/** Segments for Redis / storage artifact row: `{gameVersionId}#{gpuType}#{driverVersion}`. */
+export class ArtifactKeyParts {
+  @IsString()
+  gameVersionId: string;
+
+  @IsString()
+  gpuType: string;
+
+  @IsString()
+  driverVersion: string;
+}
+
 /** Shader / runtime artifact bundle (site-controller may fill when ENABLE_RUNTIME_ARTIFACTS is true). */
 export class RuntimeArtifactsPayload {
   @IsString()
@@ -26,6 +38,14 @@ export class RuntimeArtifactsPayload {
    */
   @IsString()
   artifactPrefix: string;
+
+  /**
+   * Registry row key (`ArtifactKeyParts`). Site-controller sets this when resolving artifacts for start-game
+   * so the agent can echo it on `detect-artifacts-ended` without recomputing segments.
+   */
+  @IsOptional()
+  @ValidateNestedType(() => ArtifactKeyParts)
+  artifactKeyParts?: ArtifactKeyParts;
 }
 
 export class ProtonGameCreationPayload {