Add workspace runtime controls

Expose project and execution workspace runtime defaults, control endpoints, startup recovery, and operator UI for start/stop/restart flows.

Co-Authored-By: Paperclip <noreply@paperclip.ing>

server/src/services/project-workspace-runtime-config.ts

@@ -0,0 +1,59 @@
+import type { ProjectWorkspaceRuntimeConfig } from "@paperclipai/shared";
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+function cloneRecord(value: unknown): Record<string, unknown> | null {
+  return isRecord(value) ? { ...value } : null;
+}
+
+function readDesiredState(value: unknown): ProjectWorkspaceRuntimeConfig["desiredState"] {
+  return value === "running" || value === "stopped" ? value : null;
+}
+
+export function readProjectWorkspaceRuntimeConfig(
+  metadata: Record<string, unknown> | null | undefined,
+): ProjectWorkspaceRuntimeConfig | null {
+  const raw = isRecord(metadata?.runtimeConfig) ? metadata.runtimeConfig : null;
+  if (!raw) return null;
+
+  const config: ProjectWorkspaceRuntimeConfig = {
+    workspaceRuntime: cloneRecord(raw.workspaceRuntime),
+    desiredState: readDesiredState(raw.desiredState),
+  };
+
+  const hasConfig = config.workspaceRuntime !== null || config.desiredState !== null;
+  return hasConfig ? config : null;
+}
+
+export function mergeProjectWorkspaceRuntimeConfig(
+  metadata: Record<string, unknown> | null | undefined,
+  patch: Partial<ProjectWorkspaceRuntimeConfig> | null,
+): Record<string, unknown> | null {
+  const nextMetadata = isRecord(metadata) ? { ...metadata } : {};
+  const current = readProjectWorkspaceRuntimeConfig(metadata) ?? {
+    workspaceRuntime: null,
+    desiredState: null,
+  };
+
+  if (patch === null) {
+    delete nextMetadata.runtimeConfig;
+    return Object.keys(nextMetadata).length > 0 ? nextMetadata : null;
+  }
+
+  const nextConfig: ProjectWorkspaceRuntimeConfig = {
+    workspaceRuntime:
+      patch.workspaceRuntime !== undefined ? cloneRecord(patch.workspaceRuntime) : current.workspaceRuntime,
+    desiredState:
+      patch.desiredState !== undefined ? readDesiredState(patch.desiredState) : current.desiredState,
+  };
+
+  if (nextConfig.workspaceRuntime === null && nextConfig.desiredState === null) {
+    delete nextMetadata.runtimeConfig;
+  } else {
+    nextMetadata.runtimeConfig = nextConfig;
+  }
+
+  return Object.keys(nextMetadata).length > 0 ? nextMetadata : null;
+}