@promptbook/cli 0.112.0-93 → 0.112.0-95

package/apps/agents-server/src/app/admin/servers/ServersClient.tsx

@@ -1,7 +1,8 @@
 'use client';
 
 import { Plus } from 'lucide-react';
-import { useCallback } from 'react';
+import { useSearchParams } from 'next/navigation';
+import { useCallback, useEffect } from 'react';
 import { Card } from '../../../components/Homepage/Card';
 import { Section } from '../../../components/Homepage/Section';
 import { useUnsavedChangesGuard } from '../../../components/utils/useUnsavedChangesGuard';
@@ -25,7 +26,9 @@ const PRIMARY_BUTTON_CLASS_NAME =
  * @private route component of AdminServersPage
  */
 export function ServersClient() {
+    const searchParams = useSearchParams();
     const {
+        canEdit,
         currentServer,
         currentServerId,
         deleteCurrentServer,
@@ -75,16 +78,39 @@ export function ServersClient() {
         });
     }, [allowNextNavigation, deleteCurrentServer]);
 
+    useEffect(() => {
+        if (
+            canEdit &&
+            !loading &&
+            servers.length === 0 &&
+            searchParams?.get('setup') === '1' &&
+            !createServerWizard.isDialogOpen
+        ) {
+            createServerWizard.openDialog();
+        }
+    }, [canEdit, createServerWizard, loading, searchParams, servers.length]);
+
     return (
         <div className="container mx-auto space-y-8 px-4 py-8">
             <div className="mt-20 flex flex-col gap-4 sm:flex-row sm:items-center sm:justify-between">
                 <h1 className="text-3xl font-light text-gray-900">Servers</h1>
-                <button type="button" onClick={createServerWizard.openDialog} className={PRIMARY_BUTTON_CLASS_NAME}>
-                    <Plus className="h-4 w-4" />
-                    Create new server
-                </button>
+                {canEdit ? (
+                    <button type="button" onClick={createServerWizard.openDialog} className={PRIMARY_BUTTON_CLASS_NAME}>
+                        <Plus className="h-4 w-4" />
+                        Create new server
+                    </button>
+                ) : null}
             </div>
 
+            {!canEdit ? (
+                <Card className="border-amber-200 bg-amber-50 hover:border-amber-200 hover:shadow-md">
+                    <p className="text-sm text-amber-800">
+                        You can view servers as an administrator. Editing domains, migrations, and deletion is restricted
+                        to the super admin authenticated with <span className="font-mono">ADMIN_PASSWORD</span>.
+                    </p>
+                </Card>
+            ) : null}
+
             {error ? (
                 <Card className="border-red-200 bg-red-50 hover:border-red-200 hover:shadow-md">
                     <p className="text-sm text-red-700">{error}</p>
@@ -95,6 +121,7 @@ export function ServersClient() {
                 <Card className="hover:border-gray-200 hover:shadow-md">
                     <ServersRegistryTable
                         currentServerId={currentServerId}
+                        canEdit={canEdit}
                         loading={loading}
                         migratingServerId={migratingServerId}
                         navigatingServerId={navigatingServerId}
@@ -110,35 +137,39 @@ export function ServersClient() {
                 </Card>
             </Section>
 
-            <CreateServerDialog
-                addAdditionalUser={createServerWizard.addAdditionalUser}
-                derivedWizardTablePrefix={createServerWizard.derivedWizardTablePrefix}
-                handleCreateServer={createServerWizard.handleCreateServer}
-                handleIconUpload={createServerWizard.handleIconUpload}
-                handleWizardBack={createServerWizard.handleWizardBack}
-                handleWizardNext={createServerWizard.handleWizardNext}
-                handleWizardStepSelection={createServerWizard.handleWizardStepSelection}
-                iconInputRef={createServerWizard.iconInputRef}
-                isCreatingServer={createServerWizard.isCreatingServer}
-                isOpen={createServerWizard.isDialogOpen}
-                isUploadingIcon={createServerWizard.isUploadingIcon}
-                removeAdditionalUser={createServerWizard.removeAdditionalUser}
-                requestClose={createServerWizard.requestClose}
-                resetWizard={createServerWizard.resetWizard}
-                updateAdditionalUser={createServerWizard.updateAdditionalUser}
-                updateAdminUser={createServerWizard.updateAdminUser}
-                updateInitialSetting={createServerWizard.updateInitialSetting}
-                updateWizardField={createServerWizard.updateWizardField}
-                wizardError={createServerWizard.wizardError}
-                wizardState={createServerWizard.wizardState}
-                wizardStep={createServerWizard.wizardStep}
-            />
+            {canEdit ? (
+                <CreateServerDialog
+                    addAdditionalUser={createServerWizard.addAdditionalUser}
+                    derivedWizardTablePrefix={createServerWizard.derivedWizardTablePrefix}
+                    handleCreateServer={createServerWizard.handleCreateServer}
+                    handleIconUpload={createServerWizard.handleIconUpload}
+                    handleWizardBack={createServerWizard.handleWizardBack}
+                    handleWizardNext={createServerWizard.handleWizardNext}
+                    handleWizardStepSelection={createServerWizard.handleWizardStepSelection}
+                    iconInputRef={createServerWizard.iconInputRef}
+                    isCreatingServer={createServerWizard.isCreatingServer}
+                    isOpen={createServerWizard.isDialogOpen}
+                    isUploadingIcon={createServerWizard.isUploadingIcon}
+                    removeAdditionalUser={createServerWizard.removeAdditionalUser}
+                    requestClose={createServerWizard.requestClose}
+                    resetWizard={createServerWizard.resetWizard}
+                    updateAdditionalUser={createServerWizard.updateAdditionalUser}
+                    updateAdminUser={createServerWizard.updateAdminUser}
+                    updateInitialSetting={createServerWizard.updateInitialSetting}
+                    updateWizardField={createServerWizard.updateWizardField}
+                    wizardError={createServerWizard.wizardError}
+                    wizardState={createServerWizard.wizardState}
+                    wizardStep={createServerWizard.wizardStep}
+                />
+            ) : null}
 
-            <DeleteCurrentServerSection
-                currentServer={currentServer}
-                deletingServerId={deletingServerId}
-                onDeleteCurrentServer={handleDeleteCurrentServer}
-            />
+            {canEdit ? (
+                <DeleteCurrentServerSection
+                    currentServer={currentServer}
+                    deletingServerId={deletingServerId}
+                    onDeleteCurrentServer={handleDeleteCurrentServer}
+                />
+            ) : null}
         </div>
     );
 }

package/apps/agents-server/src/app/admin/servers/ServersRegistryApi.ts

@@ -17,6 +17,11 @@ type ManagedServersReadResponse = {
      */
     readonly currentServerId: number | null;
 
+    /**
+     * Whether the current viewer can mutate server rows.
+     */
+    readonly canEdit: boolean;
+
     /**
      * Optional failure message returned by the API.
      */

package/apps/agents-server/src/app/admin/servers/ServersRegistryTable.tsx

@@ -40,6 +40,11 @@ const PRIMARY_BUTTON_CLASS_NAME =
  * @private function of <ServersClient/>
  */
 type ServersRegistryTableProps = {
+    /**
+     * Whether the viewer can edit server rows.
+     */
+    readonly canEdit: boolean;
+
     /**
      * Identifier of the server resolved from the current request domain.
      */
@@ -107,6 +112,7 @@ type ServersRegistryTableProps = {
  * @private function of <ServersClient/>
  */
 type ServersRegistryTableRowProps = {
+    readonly canEdit: boolean;
     readonly currentServerId: number | null;
     readonly draft: ServerDraft | undefined;
     readonly isDirty: boolean;
@@ -163,6 +169,7 @@ function ServerStatusBadge(props: { readonly label: string; readonly tone: 'blue
 function ServersRegistryTableRow(props: ServersRegistryTableRowProps) {
     const {
         currentServerId,
+        canEdit,
         draft,
         isDirty,
         isMigrating,
@@ -184,6 +191,7 @@ function ServersRegistryTableRow(props: ServersRegistryTableRowProps) {
                     value={draft?.name || ''}
                     onChange={(event) => onUpdateServerDraft(server.id, 'name', event.target.value)}
                     className={INPUT_CLASS_NAME}
+                    disabled={!canEdit}
                     aria-label={`Server name for ${server.name}`}
                 />
             </td>
@@ -194,6 +202,7 @@ function ServersRegistryTableRow(props: ServersRegistryTableRowProps) {
                         onUpdateServerDraft(server.id, 'environment', event.target.value as ManagedServerEnvironment)
                     }
                     className={INPUT_CLASS_NAME}
+                    disabled={!canEdit}
                     aria-label={`Environment for ${server.name}`}
                 >
                     {MANAGED_SERVER_ENVIRONMENT_OPTIONS.map((environment) => (
@@ -209,6 +218,7 @@ function ServersRegistryTableRow(props: ServersRegistryTableRowProps) {
                     value={draft?.domain || ''}
                     onChange={(event) => onUpdateServerDraft(server.id, 'domain', event.target.value)}
                     className={INPUT_CLASS_NAME}
+                    disabled={!canEdit}
                     aria-label={`Domain for ${server.name}`}
                 />
             </td>
@@ -218,6 +228,7 @@ function ServersRegistryTableRow(props: ServersRegistryTableRowProps) {
                     value={draft?.tablePrefix || ''}
                     onChange={(event) => onUpdateServerDraft(server.id, 'tablePrefix', event.target.value)}
                     className={`${INPUT_CLASS_NAME} font-mono`}
+                    disabled={!canEdit}
                     aria-label={`Table prefix for ${server.name}`}
                 />
             </td>
@@ -239,7 +250,7 @@ function ServersRegistryTableRow(props: ServersRegistryTableRowProps) {
                     <button
                         type="button"
                         onClick={() => void onSaveServer(server.id)}
-                        disabled={!isDirty || isSaving}
+                        disabled={!canEdit || !isDirty || isSaving}
                         className={`${PRIMARY_BUTTON_CLASS_NAME} px-2 py-1 text-xs`}
                     >
                         {isSaving ? <Loader2 className="h-3.5 w-3.5 animate-spin" /> : <Save className="h-3.5 w-3.5" />}
@@ -248,7 +259,7 @@ function ServersRegistryTableRow(props: ServersRegistryTableRowProps) {
                     <button
                         type="button"
                         onClick={() => void onMigrateServer(server.id)}
-                        disabled={isMigrating}
+                        disabled={!canEdit || isMigrating}
                         className={`${SECONDARY_BUTTON_CLASS_NAME} px-2 py-1 text-xs`}
                     >
                         {isMigrating ? (
@@ -288,6 +299,7 @@ function ServersRegistryTableRow(props: ServersRegistryTableRowProps) {
 export function ServersRegistryTable(props: ServersRegistryTableProps) {
     const {
         currentServerId,
+        canEdit,
         isServerDraftDirty,
         loading,
         migratingServerId,
@@ -344,6 +356,7 @@ export function ServersRegistryTable(props: ServersRegistryTableProps) {
                                 <ServersRegistryTableRow
                                     key={server.id}
                                     currentServerId={currentServerId}
+                                    canEdit={canEdit}
                                     draft={serverDrafts[server.id]}
                                     isDirty={isServerDraftDirty(server)}
                                     isMigrating={migratingServerId === server.id}

package/apps/agents-server/src/app/admin/servers/page.tsx

@@ -1,12 +1,12 @@
 import { ForbiddenPage } from '../../../components/ForbiddenPage/ForbiddenPage';
-import { isUserGlobalAdmin } from '../../../utils/isUserGlobalAdmin';
+import { isUserAdmin } from '../../../utils/isUserAdmin';
 import { ServersClient } from './ServersClient';
 
 /**
- * Global-admin page for managing same-instance registered servers.
+ * Admin page for viewing same-instance registered servers.
  */
 export default async function AdminServersPage() {
-    if (!(await isUserGlobalAdmin())) {
+    if (!(await isUserAdmin())) {
         return <ForbiddenPage />;
     }
 

package/apps/agents-server/src/app/admin/servers/useServersRegistryState.ts

@@ -138,6 +138,11 @@ type DeleteCurrentServerConfirmationResult = {
  * @private function of <ServersClient/>
  */
 type UseServersRegistryStateResult = {
+    /**
+     * Whether the current viewer can mutate server rows.
+     */
+    readonly canEdit: boolean;
+
     /**
      * Server resolved from the current request domain.
      */
@@ -429,12 +434,13 @@ function useServersRegistryDraftState(servers: ReadonlyArray<ManagedServerRow>)
  */
 function useServersRegistryReloadAction(options: {
     readonly replaceServerDrafts: (servers: ReadonlyArray<ManagedServerRow>) => void;
+    readonly setCanEdit: (canEdit: boolean) => void;
     readonly setCurrentServerId: (currentServerId: number | null) => void;
     readonly setError: (error: string | null) => void;
     readonly setLoading: (isLoading: boolean) => void;
     readonly setServers: (servers: ManagedServerRow[]) => void;
 }) {
-    const { replaceServerDrafts, setCurrentServerId, setError, setLoading, setServers } = options;
+    const { replaceServerDrafts, setCanEdit, setCurrentServerId, setError, setLoading, setServers } = options;
 
     return useCallback(async () => {
         setLoading(true);
@@ -444,13 +450,14 @@ function useServersRegistryReloadAction(options: {
             const payload = await ServersRegistryApi.fetchServers();
             setServers([...payload.servers]);
             setCurrentServerId(payload.currentServerId);
+            setCanEdit(payload.canEdit);
             replaceServerDrafts(payload.servers);
         } catch (loadError) {
             setError(resolveServersRegistryActionErrorMessage(loadError, 'Failed to load servers.'));
         } finally {
             setLoading(false);
         }
-    }, [replaceServerDrafts, setCurrentServerId, setError, setLoading, setServers]);
+    }, [replaceServerDrafts, setCanEdit, setCurrentServerId, setError, setLoading, setServers]);
 }
 
 /**
@@ -618,6 +625,7 @@ function useDeleteCurrentServerAction(options: {
  */
 export function useServersRegistryState(): UseServersRegistryStateResult {
     const [servers, setServers] = useState<ManagedServerRow[]>([]);
+    const [canEdit, setCanEdit] = useState(false);
     const [loading, setLoading] = useState(true);
     const [error, setError] = useState<string | null>(null);
     const [currentServerId, setCurrentServerId] = useState<number | null>(null);
@@ -635,6 +643,7 @@ export function useServersRegistryState(): UseServersRegistryStateResult {
 
     const reloadServers = useServersRegistryReloadAction({
         replaceServerDrafts,
+        setCanEdit,
         setCurrentServerId,
         setError,
         setLoading,
@@ -671,6 +680,7 @@ export function useServersRegistryState(): UseServersRegistryStateResult {
     });
 
     return {
+        canEdit,
         currentServer,
         currentServerId,
         deletingServerId,

package/apps/agents-server/src/app/api/admin/code-runners/route.ts

@@ -0,0 +1,104 @@
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+import { NextResponse } from 'next/server';
+import { isUserGlobalAdmin } from '@/src/utils/isUserGlobalAdmin';
+import {
+    applyVpsCodeRunnerConfiguration,
+    listVpsEnvironmentVariables,
+    updateVpsEnvironmentVariables,
+} from '@/src/utils/vpsConfiguration';
+
+const execFileAsync = promisify(execFile);
+
+/**
+ * Loads configured code-runner settings from the editable VPS environment.
+ */
+export async function GET() {
+    if (!(await isUserGlobalAdmin())) {
+        return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+    }
+
+    try {
+        const snapshot = await listVpsEnvironmentVariables();
+        const environmentByKey = Object.fromEntries(
+            snapshot.variables.map((variable) => [variable.key, variable.value]),
+        ) as Record<string, string>;
+
+        return NextResponse.json({
+            agent: environmentByKey.PTBK_AGENT || process.env.PTBK_AGENT || 'github-copilot',
+            model: environmentByKey.PTBK_MODEL || process.env.PTBK_MODEL || 'gpt-5.4',
+            thinkingLevel: environmentByKey.PTBK_THINKING_LEVEL || process.env.PTBK_THINKING_LEVEL || 'xhigh',
+            status: await resolveRunnerStatus(environmentByKey.PTBK_AGENT || process.env.PTBK_AGENT || 'github-copilot'),
+        });
+    } catch (error) {
+        return NextResponse.json(
+            { error: error instanceof Error ? error.message : 'Failed to load code-runner configuration.' },
+            { status: 500 },
+        );
+    }
+}
+
+/**
+ * Updates code-runner environment variables.
+ */
+export async function PATCH(request: Request) {
+    if (!(await isUserGlobalAdmin())) {
+        return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+    }
+
+    try {
+        const body = (await request.json().catch(() => null)) as
+            | {
+                  readonly agent?: string;
+                  readonly model?: string;
+                  readonly thinkingLevel?: string;
+                  readonly applyRuntimeConfiguration?: boolean;
+              }
+            | null;
+
+        if (!body) {
+            return NextResponse.json({ error: 'Code-runner payload is required.' }, { status: 400 });
+        }
+
+        await updateVpsEnvironmentVariables({
+            PTBK_AGENT: body.agent || '',
+            PTBK_MODEL: body.model || '',
+            PTBK_THINKING_LEVEL: body.thinkingLevel || '',
+        });
+
+        const response = await GET();
+        const payload = (await response.json()) as Record<string, unknown>;
+
+        return NextResponse.json({
+            ...payload,
+            applyResult: body.applyRuntimeConfiguration ? await applyVpsCodeRunnerConfiguration() : null,
+        });
+    } catch (error) {
+        return NextResponse.json(
+            { error: error instanceof Error ? error.message : 'Failed to update code-runner configuration.' },
+            { status: 500 },
+        );
+    }
+}
+
+/**
+ * Resolves a short runner-authentication status for the configured runner.
+ *
+ * @param agent - Runner id.
+ * @returns Human-readable status.
+ */
+async function resolveRunnerStatus(agent: string): Promise<string> {
+    if (agent !== 'github-copilot') {
+        return 'Status check is currently available for GitHub Copilot CLI only.';
+    }
+
+    try {
+        const { stdout, stderr } = await execFileAsync('copilot', ['auth', 'status'], {
+            timeout: 10_000,
+            maxBuffer: 128 * 1024,
+        });
+        return [stdout, stderr].filter(Boolean).join('\n').trim() || 'GitHub Copilot CLI returned no status output.';
+    } catch (error) {
+        return error instanceof Error ? error.message : 'GitHub Copilot CLI status check failed.';
+    }
+}

package/apps/agents-server/src/app/api/admin/environment/route.ts

@@ -0,0 +1,65 @@
+import { NextResponse } from 'next/server';
+import {
+    applyVpsRuntimeConfiguration,
+    listVpsEnvironmentVariables,
+    updateVpsEnvironmentVariables,
+} from '@/src/utils/vpsConfiguration';
+import { isUserAdmin } from '@/src/utils/isUserAdmin';
+import { isUserGlobalAdmin } from '@/src/utils/isUserGlobalAdmin';
+
+/**
+ * Loads `.env` variables visible in the admin UI.
+ */
+export async function GET() {
+    if (!(await isUserAdmin())) {
+        return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+    }
+
+    try {
+        return NextResponse.json({
+            ...(await listVpsEnvironmentVariables()),
+            canEdit: await isUserGlobalAdmin(),
+        });
+    } catch (error) {
+        return NextResponse.json(
+            { error: error instanceof Error ? error.message : 'Failed to load environment variables.' },
+            { status: 500 },
+        );
+    }
+}
+
+/**
+ * Persists editable `.env` variables and optionally reapplies VPS runtime configuration.
+ */
+export async function PATCH(request: Request) {
+    if (!(await isUserGlobalAdmin())) {
+        return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+    }
+
+    try {
+        const body = (await request.json().catch(() => null)) as
+            | {
+                  readonly variables?: Record<string, string>;
+                  readonly applyRuntimeConfiguration?: boolean;
+              }
+            | null;
+
+        if (!body || typeof body.variables !== 'object' || body.variables === null) {
+            return NextResponse.json({ error: 'Variables payload is required.' }, { status: 400 });
+        }
+
+        const snapshot = await updateVpsEnvironmentVariables(body.variables);
+        const applyResult = body.applyRuntimeConfiguration ? await applyVpsRuntimeConfiguration() : null;
+
+        return NextResponse.json({
+            ...snapshot,
+            canEdit: true,
+            applyResult,
+        });
+    } catch (error) {
+        return NextResponse.json(
+            { error: error instanceof Error ? error.message : 'Failed to update environment variables.' },
+            { status: 500 },
+        );
+    }
+}

package/apps/agents-server/src/app/api/admin/logs/route.ts

@@ -0,0 +1,24 @@
+import { NextResponse } from 'next/server';
+import { isUserGlobalAdmin } from '@/src/utils/isUserGlobalAdmin';
+import { readVpsPm2Logs } from '@/src/utils/vpsConfiguration';
+
+/**
+ * Loads recent pm2 logs for the standalone Agents Server process.
+ */
+export async function GET(request: Request) {
+    if (!(await isUserGlobalAdmin())) {
+        return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+    }
+
+    try {
+        const url = new URL(request.url);
+        const rawLines = Number.parseInt(url.searchParams.get('lines') || '200', 10);
+        const lineCount = Number.isFinite(rawLines) ? Math.min(Math.max(rawLines, 20), 1000) : 200;
+        return NextResponse.json(await readVpsPm2Logs(lineCount));
+    } catch (error) {
+        return NextResponse.json(
+            { error: error instanceof Error ? error.message : 'Failed to load pm2 logs.' },
+            { status: 500 },
+        );
+    }
+}

package/apps/agents-server/src/app/api/admin/servers/[serverId]/route.ts

@@ -1,7 +1,12 @@
 import { NextResponse } from 'next/server';
+import { isAgentsServerSqliteMode } from '../../../../../database/agentsServerDatabaseMode';
 import { resolveCurrentServerRegistryContext } from '../../../../../utils/currentServerRegistryContext';
 import { isUserGlobalAdmin } from '../../../../../utils/isUserGlobalAdmin';
-import { createServerPublicUrl } from '../../../../../utils/serverRegistry';
+import {
+    createServerPublicUrl,
+    listEnvironmentRegisteredServers,
+    normalizeServerDomain,
+} from '../../../../../utils/serverRegistry';
 import {
     assertGlobalAdminAccess,
     deleteManagedServer,
@@ -10,6 +15,11 @@ import {
     updateManagedServer,
     type UpdateServerInput,
 } from '../../../../../utils/serverManagement';
+import {
+    applyVpsRuntimeConfiguration,
+    listConfiguredVpsDomains,
+    updateConfiguredVpsDomains,
+} from '../../../../../utils/vpsConfiguration';
 
 /**
  * Updates editable `_Server` fields for one registered server.
@@ -24,8 +34,15 @@ export async function PATCH(request: Request, context: { params: Promise<{ serve
 
         const { serverId } = await context.params;
         const body = (await request.json()) as Omit<UpdateServerInput, 'id'>;
+        const parsedServerId = parseManagedServerId(serverId);
+
+        if (isAgentsServerSqliteMode()) {
+            const updatedServer = await updateStandaloneVpsServerDomain(parsedServerId, body.domain);
+            return NextResponse.json({ server: updatedServer });
+        }
+
         const updatedServer = await updateManagedServer({
-            id: parseManagedServerId(serverId),
+            id: parsedServerId,
             ...body,
         });
 
@@ -52,9 +69,19 @@ export async function DELETE(_request: Request, context: { params: Promise<{ ser
         assertGlobalAdminAccess(await isUserGlobalAdmin());
 
         const { serverId } = await context.params;
+        const parsedServerId = parseManagedServerId(serverId);
+
+        if (isAgentsServerSqliteMode()) {
+            await deleteStandaloneVpsServerDomain(parsedServerId);
+            return NextResponse.json({
+                success: true,
+                redirectUrl: null,
+            });
+        }
+
         const currentContext = await resolveCurrentServerRegistryContext();
         const nextServerId = await deleteManagedServer({
-            serverId: parseManagedServerId(serverId),
+            serverId: parsedServerId,
             currentServerId: currentContext.currentServer?.id ?? null,
         });
         const nextServer =
@@ -76,3 +103,52 @@ export async function DELETE(_request: Request, context: { params: Promise<{ ser
         );
     }
 }
+
+/**
+ * Updates a virtual standalone VPS server by replacing its domain in `SERVERS`.
+ *
+ * @param serverId - Virtual server id.
+ * @param rawDomain - Replacement domain.
+ * @returns Updated virtual server row.
+ */
+async function updateStandaloneVpsServerDomain(serverId: number, rawDomain: string) {
+    const normalizedDomain = normalizeServerDomain(rawDomain);
+    if (!normalizedDomain) {
+        throw new Error('A valid domain is required.');
+    }
+
+    const servers = listEnvironmentRegisteredServers();
+    const serverIndex = servers.findIndex((server) => server.id === serverId);
+    if (serverIndex === -1) {
+        throw new Error(`Standalone VPS server ${serverId} was not found.`);
+    }
+
+    const domains = await listConfiguredVpsDomains();
+    const nextDomains = domains.map((domain, index) => (index === serverIndex ? normalizedDomain : domain));
+    await updateConfiguredVpsDomains(nextDomains);
+    await applyVpsRuntimeConfiguration();
+
+    const updatedServer = listEnvironmentRegisteredServers().find((server) => server.domain === normalizedDomain);
+    if (!updatedServer) {
+        throw new Error(`Standalone VPS server ${normalizedDomain} was not persisted.`);
+    }
+
+    return updatedServer;
+}
+
+/**
+ * Deletes a virtual standalone VPS server by removing its domain from `SERVERS`.
+ *
+ * @param serverId - Virtual server id.
+ */
+async function deleteStandaloneVpsServerDomain(serverId: number): Promise<void> {
+    const servers = listEnvironmentRegisteredServers();
+    const serverIndex = servers.findIndex((server) => server.id === serverId);
+    if (serverIndex === -1) {
+        throw new Error(`Standalone VPS server ${serverId} was not found.`);
+    }
+
+    const domains = await listConfiguredVpsDomains();
+    await updateConfiguredVpsDomains(domains.filter((_domain, index) => index !== serverIndex));
+    await applyVpsRuntimeConfiguration();
+}