@promptbook/cli 0.113.0-10 → 0.113.0-11

package/apps/agents-server/src/components/Footer/Footer.tsx

@@ -1,7 +1,6 @@
 'use client';
 
-import { NEXT_PUBLIC_VERCEL_GIT_COMMIT_REF, NEXT_PUBLIC_VERCEL_GIT_COMMIT_SHA } from '@/config';
-import { CLAIM, NAME, PROMPTBOOK_ENGINE_VERSION } from '@promptbook-local/core';
+import { CLAIM, NAME } from '@promptbook-local/core';
 import { useServerLanguage } from '../ServerLanguage/ServerLanguageProvider';
 import { HeadlessLink } from '../_utils/headlessParam';
 import { getCommitFooterEmoji } from './getCommitFooterEmoji';
@@ -16,6 +15,18 @@ export type FooterLink = {
     url: string;
 };
 
+/**
+ * Lightweight precomputed version metadata rendered in the footer.
+ *
+ * @private Internal to `apps/agents-server`
+ */
+export type FooterVersionInfo = {
+    label: string;
+    url: string;
+    commitSha: string | null;
+    releasedAtLabel: string | null;
+};
+
 /**
  * Configuration passed to `Footer` from the layout container.
  *
@@ -23,6 +34,7 @@ export type FooterLink = {
  */
 type FooterProps = {
     extraLinks?: FooterLink[];
+    version: FooterVersionInfo;
 };
 
 /**
@@ -31,8 +43,9 @@ type FooterProps = {
  * @private Internal to `apps/agents-server`
  */
 export function Footer(props: FooterProps) {
-    const { extraLinks = [] } = props;
+    const { extraLinks = [], version } = props;
     const { t } = useServerLanguage();
+    const versionText = version.releasedAtLabel ? `${version.label}, ${version.releasedAtLabel}` : version.label;
 
     return (
         <footer className="border-t border-gray-200 bg-white dark:border-slate-700 dark:bg-slate-950">
@@ -46,7 +59,9 @@ export function Footer(props: FooterProps) {
 
                     {/* Products */}
                     <div className="space-y-4">
-                        <h3 className="font-bold text-gray-900 dark:text-slate-100">{t('footer.productSectionTitle')}</h3>
+                        <h3 className="font-bold text-gray-900 dark:text-slate-100">
+                            {t('footer.productSectionTitle')}
+                        </h3>
                         <ul className="space-y-2 text-sm">
                             <li>
                                 <HeadlessLink href="/get-started" className="text-gray-500 hover:text-gray-900">
@@ -81,7 +96,9 @@ export function Footer(props: FooterProps) {
 
                     {/* Company */}
                     <div className="space-y-4">
-                        <h3 className="font-bold text-gray-900 dark:text-slate-100">{t('footer.companySectionTitle')}</h3>
+                        <h3 className="font-bold text-gray-900 dark:text-slate-100">
+                            {t('footer.companySectionTitle')}
+                        </h3>
                         <ul className="space-y-2 text-sm">
                             <li>
                                 <a
@@ -111,7 +128,9 @@ export function Footer(props: FooterProps) {
 
                     {/* Social */}
                     <div className="space-y-4">
-                        <h3 className="font-bold text-gray-900 dark:text-slate-100">{t('footer.connectSectionTitle')}</h3>
+                        <h3 className="font-bold text-gray-900 dark:text-slate-100">
+                            {t('footer.connectSectionTitle')}
+                        </h3>
                         <ul className="space-y-2 text-sm">
                             <li>
                                 <a
@@ -145,7 +164,9 @@ export function Footer(props: FooterProps) {
                     {/* Extra Links from Metadata */}
                     {extraLinks.length > 0 && (
                         <div className="space-y-4">
-                            <h3 className="font-bold text-gray-900 dark:text-slate-100">{t('footer.linksSectionTitle')}</h3>
+                            <h3 className="font-bold text-gray-900 dark:text-slate-100">
+                                {t('footer.linksSectionTitle')}
+                            </h3>
                             <ul className="space-y-2 text-sm">
                                 {extraLinks.map((link, index) => (
                                     <li key={index}>
@@ -168,16 +189,18 @@ export function Footer(props: FooterProps) {
                     <p>
                         &copy; {new Date().getFullYear()} Promptbook
                         <br />
-                        {t('footer.allRightsReserved')}
-                        <br />
-                        {t('footer.madeInCzechRepublic', { emoji: getCommitFooterEmoji(NEXT_PUBLIC_VERCEL_GIT_COMMIT_SHA) })}
+                        {t('footer.madeInCzechRepublic', { emoji: getCommitFooterEmoji(version.commitSha) })}
                         {/* <- TODO: !!!!!!!! Put here Prague outline */}
                     </p>
-                    <p className="mt-2 text-xs text-gray-400">
-                        {t('footer.engineVersion')} {PROMPTBOOK_ENGINE_VERSION}{' '}
-                        {{ main: 'live', preview: 'preview', production: 'prod', lts: 'lts' }[
-                            NEXT_PUBLIC_VERCEL_GIT_COMMIT_REF!
-                        ] || NEXT_PUBLIC_VERCEL_GIT_COMMIT_REF}
+                    <p className="mt-2 text-xs text-gray-400 dark:text-slate-500">
+                        <a
+                            href={version.url}
+                            className="hover:text-gray-600 dark:hover:text-slate-300"
+                            target="_blank"
+                            rel="noopener noreferrer"
+                        >
+                            {versionText}
+                        </a>
                     </p>
                 </div>
                 {/*

package/apps/agents-server/src/components/Header/buildHeaderSystemMenuItems.ts

@@ -52,6 +52,7 @@ import {
     type LucideIcon,
 } from 'lucide-react';
 import { createElement } from 'react';
+import { HARNESS_AUTH_ADMIN_PATH } from '../../constants/harnessAuthRoutes';
 import type { ServerTranslationKey } from '../../languages/ServerTranslationKeys';
 import type { ShibbolethAuthenticationMenuStatus } from '../../constants/shibbolethAuth';
 import type { ChatFeedbackMode } from '../../utils/chatFeedbackMode';
@@ -102,7 +103,7 @@ type SystemMenuItemHref =
     | '/admin/update'
     | '/admin/database'
     | '/admin/logs'
-    | '/admin/code-runners'
+    | typeof HARNESS_AUTH_ADMIN_PATH
     | '/admin/cli-access'
     | '/admin/models'
     | '/admin/metadata'
@@ -178,7 +179,7 @@ const SYSTEM_MENU_ICON_BY_HREF: Record<SystemMenuItemHref, LucideIcon> = {
     '/admin/update': RefreshCw,
     '/admin/database': Database,
     '/admin/logs': ScrollText,
-    '/admin/code-runners': TerminalSquare,
+    [HARNESS_AUTH_ADMIN_PATH]: TerminalSquare,
     '/admin/cli-access': Terminal,
     '/admin/models': Bot,
     '/admin/metadata': FileJson,
@@ -411,8 +412,8 @@ export function buildHeaderSystemMenuItems({
                       href: '/admin/logs',
                   } as SubMenuItem,
                   {
-                      label: translate('header.codeRunners'),
-                      href: '/admin/code-runners',
+                      label: translate('header.harnessAuth'),
+                      href: HARNESS_AUTH_ADMIN_PATH,
                   } as SubMenuItem,
                   {
                       label: translate('header.cliAccess'),

package/apps/agents-server/src/components/LayoutWrapper/LayoutWrapper.tsx

@@ -18,7 +18,7 @@ import { ClientVersionMismatchListener } from '../ClientVersion/ClientVersionMis
 import { ChatEnterBehaviorPreferencesProvider } from '../ChatEnterBehavior/ChatEnterBehaviorPreferencesProvider';
 import { HomepageOptimisticNavigation } from '../Homepage/HomepageOptimisticNavigation';
 import { FileUploadAvailabilityProvider } from '../FileUploadAvailability/FileUploadAvailabilityContext';
-import { Footer, type FooterLink } from '../Footer/Footer';
+import { Footer, type FooterLink, type FooterVersionInfo } from '../Footer/Footer';
 import { ActiveAgentBreadcrumbProvider } from '../Header/ActiveAgentBreadcrumbContext';
 import { Header } from '../Header/Header';
 import { MobileMenuHoistingProvider } from '../Header/MobileMenuHoistingContext';
@@ -50,6 +50,7 @@ type LayoutWrapperProps = {
     agentNaming: AgentNaming;
     isFooterShown: boolean;
     footerLinks: Array<FooterLink>;
+    footerVersion: FooterVersionInfo;
     federatedServers: Array<{ url: string; title: string }>;
     isExperimental: boolean;
     feedbackMode: ChatFeedbackMode;
@@ -102,6 +103,7 @@ export function LayoutWrapper({
     agentNaming,
     isFooterShown,
     footerLinks,
+    footerVersion,
     federatedServers,
     isExperimental,
     feedbackMode,
@@ -212,6 +214,7 @@ export function LayoutWrapper({
                                                                                         !isFooterHiddenOnPage && (
                                                                                             <Footer
                                                                                                 extraLinks={footerLinks}
+                                                                                                version={footerVersion}
                                                                                             />
                                                                                         )}
                                                                                 </div>

package/apps/agents-server/src/constants/harnessAuthRoutes.ts

@@ -0,0 +1,20 @@
+/**
+ * Admin page path for configuring standalone harness authentication.
+ *
+ * @private internal route constant for Agents Server Harness Auth UI
+ */
+export const HARNESS_AUTH_ADMIN_PATH = '/admin/harness-auth';
+
+/**
+ * Admin API path for configuring standalone harness authentication.
+ *
+ * @private internal route constant for Agents Server Harness Auth UI
+ */
+export const HARNESS_AUTH_API_PATH = '/api/admin/harness-auth';
+
+/**
+ * Admin API path for the interactive harness authentication terminal.
+ *
+ * @private internal route constant for Agents Server Harness Auth UI
+ */
+export const HARNESS_AUTHENTICATION_API_PATH = `${HARNESS_AUTH_API_PATH}/authentication`;

package/apps/agents-server/src/languages/ServerTranslationKeys.ts

@@ -147,7 +147,7 @@ export const SERVER_TRANSLATION_KEYS = [
     'header.update',
     'header.database',
     'header.logs',
-    'header.codeRunners',
+    'header.harnessAuth',
     'header.cliAccess',
     'header.models',
     'header.openApiDocumentation',

package/apps/agents-server/src/languages/translations/czech.yaml

@@ -141,7 +141,7 @@ header.resourceMonitor: Monitoring zdrojů
 header.update: Aktualizace
 header.database: Databáze
 header.logs: Logy
-header.codeRunners: Code runnery
+header.harnessAuth: Přihlášení harnessu
 header.cliAccess: CLI přístup
 header.models: Modely
 header.openApiDocumentation: Dokumentace OpenAPI
@@ -381,7 +381,7 @@ footer.logosAndBranding: Loga a vizuální identita
 footer.connectSectionTitle: Spojte se s námi
 footer.linksSectionTitle: Odkazy
 footer.allRightsReserved: Všechna práva vyhrazena.
-footer.madeInCzechRepublic: Vytvořeno s {emoji} v České republice.
+footer.madeInCzechRepublic: Vytvořeno s {emoji} v Evropě.
 footer.engineVersion: Verze jádra Promptbooku
 forbidden.title: 403 Zakázáno
 forbidden.message: Nemáte oprávnění k přístupu na tuto stránku.

package/apps/agents-server/src/languages/translations/english.yaml

@@ -143,7 +143,7 @@ header.resourceMonitor: Resource monitor
 header.update: Update
 header.database: Database
 header.logs: Logs
-header.codeRunners: Code runners
+header.harnessAuth: Harness Auth
 header.cliAccess: CLI Access
 header.models: Models
 header.openApiDocumentation: OpenAPI Documentation

package/apps/agents-server/src/utils/{codeRunnerAuthentication.ts → harnessAuthentication.ts}

@@ -11,21 +11,23 @@ import {
 } from './interactiveTerminalSession';
 
 /**
- * Serializable snapshot of one interactive code-runner authentication session.
+ * Serializable snapshot of one interactive harness authentication session.
+ *
+ * @private internal utility of Agents Server Harness Auth
  */
-export type CodeRunnerAuthenticationSessionSnapshot = {
+export type HarnessAuthenticationSessionSnapshot = {
     /**
      * Session identifier used by the browser UI.
      */
     readonly id: string;
 
     /**
-     * Runner being authenticated.
+     * Harness being authenticated.
      */
-    readonly agent: string;
+    readonly harness: string;
 
     /**
-     * Whether the interactive runner process is still active.
+     * Whether the interactive harness process is still active.
      */
     readonly isRunning: boolean;
 
@@ -57,8 +59,10 @@ export type CodeRunnerAuthenticationSessionSnapshot = {
 
 /**
  * Browser stream callbacks used by one subscribed UI client.
+ *
+ * @private internal utility of Agents Server Harness Auth
  */
-export type CodeRunnerAuthenticationSessionSubscriber = {
+export type HarnessAuthenticationSessionSubscriber = {
     /**
      * Called whenever new terminal output arrives.
      */
@@ -67,27 +71,29 @@ export type CodeRunnerAuthenticationSessionSubscriber = {
     /**
      * Called once the session exits.
      */
-    readonly onExit: (event: { readonly type: 'exit'; readonly snapshot: CodeRunnerAuthenticationSessionSnapshot }) => void;
+    readonly onExit: (event: { readonly type: 'exit'; readonly snapshot: HarnessAuthenticationSessionSnapshot }) => void;
 };
 
 /**
- * Starts a streamed authentication session for the currently configured standalone runner.
+ * Starts a streamed authentication session for the currently configured standalone harness.
  *
- * @param agent - Runner identifier stored in `.env`.
- * @returns Existing running session for the same runner or a new one.
+ * @param harness - Harness identifier stored in `.env`.
+ * @returns Existing running session for the same harness or a new one.
+ *
+ * @private internal utility of Agents Server Harness Auth
  */
-export async function startCodeRunnerAuthenticationSession(
-    agent: string,
-): Promise<CodeRunnerAuthenticationSessionSnapshot> {
+export async function startHarnessAuthenticationSession(
+    harness: string,
+): Promise<HarnessAuthenticationSessionSnapshot> {
     const scriptPath = await resolveVpsInstallerScriptPath();
     if (!scriptPath) {
         throw new Error('The VPS installer script could not be found on this server.');
     }
 
-    return toRequiredCodeRunnerAuthenticationSessionSnapshot(
+    return toRequiredHarnessAuthenticationSessionSnapshot(
         startInteractiveTerminalSession({
-            sessionKey: buildCodeRunnerAuthenticationSessionKey(agent),
-            title: `${agent} authentication`,
+            sessionKey: buildHarnessAuthenticationSessionKey(harness),
+            title: `${harness} authentication`,
             command: 'bash',
             arguments: [scriptPath, 'authenticate-runner'],
             env: createVpsInstallerCommandEnvironment({
@@ -95,26 +101,28 @@ export async function startCodeRunnerAuthenticationSession(
                 isProcessRestartEnabled: false,
             }),
             metadata: {
-                agent,
+                harness,
             },
-            unavailableErrorMessage: 'Interactive code-runner authentication is available only on the Linux VPS runtime.',
+            unavailableErrorMessage: 'Interactive harness authentication is available only on the Linux VPS runtime.',
         }),
-        agent,
+        harness,
     );
 }
 
 /**
- * Returns the latest known authentication session for a runner.
+ * Returns the latest known authentication session for a harness.
  *
- * @param agent - Runner identifier.
+ * @param harness - Harness identifier.
  * @returns Serializable session snapshot or `null`.
+ *
+ * @private internal utility of Agents Server Harness Auth
  */
-export function getLatestCodeRunnerAuthenticationSession(
-    agent: string,
-): CodeRunnerAuthenticationSessionSnapshot | null {
-    return toCodeRunnerAuthenticationSessionSnapshot(
-        getLatestInteractiveTerminalSession(buildCodeRunnerAuthenticationSessionKey(agent)),
-        agent,
+export function getLatestHarnessAuthenticationSession(
+    harness: string,
+): HarnessAuthenticationSessionSnapshot | null {
+    return toHarnessAuthenticationSessionSnapshot(
+        getLatestInteractiveTerminalSession(buildHarnessAuthenticationSessionKey(harness)),
+        harness,
     );
 }
 
@@ -123,11 +131,13 @@ export function getLatestCodeRunnerAuthenticationSession(
  *
  * @param sessionId - Session identifier.
  * @returns Serializable session snapshot or `null`.
+ *
+ * @private internal utility of Agents Server Harness Auth
  */
-export function getCodeRunnerAuthenticationSession(
+export function getHarnessAuthenticationSession(
     sessionId: string,
-): CodeRunnerAuthenticationSessionSnapshot | null {
-    return toCodeRunnerAuthenticationSessionSnapshot(getInteractiveTerminalSession(sessionId));
+): HarnessAuthenticationSessionSnapshot | null {
+    return toHarnessAuthenticationSessionSnapshot(getInteractiveTerminalSession(sessionId));
 }
 
 /**
@@ -136,17 +146,19 @@ export function getCodeRunnerAuthenticationSession(
  * @param sessionId - Session identifier.
  * @param subscriber - Stream callbacks.
  * @returns Cleanup callback.
+ *
+ * @private internal utility of Agents Server Harness Auth
  */
-export function subscribeToCodeRunnerAuthenticationSession(
+export function subscribeToHarnessAuthenticationSession(
     sessionId: string,
-    subscriber: CodeRunnerAuthenticationSessionSubscriber,
+    subscriber: HarnessAuthenticationSessionSubscriber,
 ): (() => void) | null {
     return subscribeToInteractiveTerminalSession(sessionId, {
         onOutput: subscriber.onOutput,
         onExit: ({ snapshot }) =>
             subscriber.onExit({
                 type: 'exit',
-                snapshot: toRequiredCodeRunnerAuthenticationSessionSnapshot(snapshot),
+                snapshot: toRequiredHarnessAuthenticationSessionSnapshot(snapshot),
             }),
     });
 }
@@ -157,12 +169,14 @@ export function subscribeToCodeRunnerAuthenticationSession(
  * @param sessionId - Session identifier.
  * @param input - Raw text to write to stdin.
  * @returns Updated session snapshot.
+ *
+ * @private internal utility of Agents Server Harness Auth
  */
-export function writeCodeRunnerAuthenticationSessionInput(
+export function writeHarnessAuthenticationSessionInput(
     sessionId: string,
     input: string,
-): CodeRunnerAuthenticationSessionSnapshot {
-    return toRequiredCodeRunnerAuthenticationSessionSnapshot(writeInteractiveTerminalSessionInput(sessionId, input));
+): HarnessAuthenticationSessionSnapshot {
+    return toRequiredHarnessAuthenticationSessionSnapshot(writeInteractiveTerminalSessionInput(sessionId, input));
 }
 
 /**
@@ -170,41 +184,43 @@ export function writeCodeRunnerAuthenticationSessionInput(
  *
  * @param sessionId - Session identifier.
  * @returns Updated session snapshot.
+ *
+ * @private internal utility of Agents Server Harness Auth
  */
-export function stopCodeRunnerAuthenticationSession(
+export function stopHarnessAuthenticationSession(
     sessionId: string,
-): CodeRunnerAuthenticationSessionSnapshot {
-    return toRequiredCodeRunnerAuthenticationSessionSnapshot(stopInteractiveTerminalSession(sessionId));
+): HarnessAuthenticationSessionSnapshot {
+    return toRequiredHarnessAuthenticationSessionSnapshot(stopInteractiveTerminalSession(sessionId));
 }
 
 /**
- * Builds the stable logical session key for one runner authentication terminal.
+ * Builds the stable logical session key for one harness authentication terminal.
  *
- * @param agent - Runner identifier.
+ * @param harness - Harness identifier.
  * @returns Stable session key.
  */
-function buildCodeRunnerAuthenticationSessionKey(agent: string): string {
-    return `code-runner-authentication:${agent}`;
+function buildHarnessAuthenticationSessionKey(harness: string): string {
+    return `harness-authentication:${harness}`;
 }
 
 /**
- * Converts one generic terminal snapshot into the runner-specific browser shape.
+ * Converts one generic terminal snapshot into the harness-specific browser shape.
  *
  * @param session - Generic terminal snapshot.
- * @param fallbackAgent - Agent name used when older sessions miss metadata.
- * @returns Runner-specific snapshot or `null`.
+ * @param fallbackHarness - Harness name used when older sessions miss metadata.
+ * @returns Harness-specific snapshot or `null`.
  */
-function toCodeRunnerAuthenticationSessionSnapshot(
+function toHarnessAuthenticationSessionSnapshot(
     session: InteractiveTerminalSessionSnapshot | null,
-    fallbackAgent = '',
-): CodeRunnerAuthenticationSessionSnapshot | null {
+    fallbackHarness = '',
+): HarnessAuthenticationSessionSnapshot | null {
     if (!session) {
         return null;
     }
 
     return {
         id: session.id,
-        agent: session.metadata.agent || fallbackAgent,
+        harness: session.metadata.harness || session.metadata.agent || fallbackHarness,
         isRunning: session.isRunning,
         output: session.output,
         startedAt: session.startedAt,
@@ -215,16 +231,16 @@ function toCodeRunnerAuthenticationSessionSnapshot(
 }
 
 /**
- * Converts one generic terminal snapshot into a required runner-specific snapshot.
+ * Converts one generic terminal snapshot into a required harness-specific snapshot.
  *
  * @param session - Generic terminal snapshot.
- * @returns Runner-specific snapshot.
+ * @returns Harness-specific snapshot.
  */
-function toRequiredCodeRunnerAuthenticationSessionSnapshot(
+function toRequiredHarnessAuthenticationSessionSnapshot(
     session: InteractiveTerminalSessionSnapshot | null,
-    fallbackAgent = '',
-): CodeRunnerAuthenticationSessionSnapshot {
-    const mappedSession = toCodeRunnerAuthenticationSessionSnapshot(session, fallbackAgent);
+    fallbackHarness = '',
+): HarnessAuthenticationSessionSnapshot {
+    const mappedSession = toHarnessAuthenticationSessionSnapshot(session, fallbackHarness);
 
     if (!mappedSession) {
         throw new Error('Authentication session was not found.');

package/apps/agents-server/src/utils/{codeRunnerConfiguration.ts → harnessConfiguration.ts}

@@ -5,13 +5,15 @@ import { listVpsEnvironmentVariables } from './vpsConfiguration';
 const execFileAsync = promisify(execFile);
 
 /**
- * Saved standalone VPS code-runner configuration exposed to the admin UI.
+ * Saved standalone VPS harness configuration exposed to the admin UI.
+ *
+ * @private internal utility of Agents Server Harness Auth
  */
-export type ConfiguredCodeRunner = {
+export type ConfiguredHarness = {
     /**
-     * Runner identifier persisted in `.env`.
+     * Harness identifier persisted in `.env`.
      */
-    readonly agent: string;
+    readonly harness: string;
 
     /**
      * Model identifier persisted in `.env`.
@@ -25,11 +27,13 @@ export type ConfiguredCodeRunner = {
 };
 
 /**
- * Reads the currently configured standalone VPS code runner from managed environment variables.
+ * Reads the currently configured standalone VPS harness from managed environment variables.
+ *
+ * @returns Saved harness settings with fallback defaults.
  *
- * @returns Saved code-runner settings with fallback defaults.
+ * @private internal utility of Agents Server Harness Auth
  */
-export async function readConfiguredCodeRunner(): Promise<ConfiguredCodeRunner> {
+export async function readConfiguredHarness(): Promise<ConfiguredHarness> {
     const snapshot = await listVpsEnvironmentVariables();
     const environmentByKey = Object.fromEntries(snapshot.variables.map((variable) => [variable.key, variable.value])) as Record<
         string,
@@ -37,20 +41,22 @@ export async function readConfiguredCodeRunner(): Promise<ConfiguredCodeRunner>
     >;
 
     return {
-        agent: environmentByKey.PTBK_HARNESS || process.env.PTBK_HARNESS || process.env.PTBK_AGENT || 'github-copilot',
+        harness: environmentByKey.PTBK_HARNESS || process.env.PTBK_HARNESS || 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',
     };
 }
 
 /**
- * Resolves a short runner-authentication status for the configured runner.
+ * Resolves a short authentication status for the configured harness.
  *
- * @param agent - Runner id.
+ * @param harness - Harness id.
  * @returns Human-readable status.
+ *
+ * @private internal utility of Agents Server Harness Auth
  */
-export async function resolveCodeRunnerStatus(agent: string): Promise<string> {
-    if (agent !== 'github-copilot') {
+export async function resolveHarnessStatus(harness: string): Promise<string> {
+    if (harness !== 'github-copilot') {
         return 'Status check is currently available for GitHub Copilot CLI only.';
     }
 

package/apps/agents-server/src/utils/taskTerminal/resolveAdminTaskTerminalSession.ts

@@ -9,7 +9,6 @@ import { getLocalUserChatJobMetadata } from '../localChatRunner/LocalUserChatJob
 import { resolveLocalAgentRootPath } from '../localChatRunner/ensureLocalAgentFolder';
 import { listPagePreviewBrowserAdminTasks } from '../pagePreviewBrowserSessions';
 import {
-    readVpsSelfUpdateJobSnapshot,
     readVpsSelfUpdateJobTaskSnapshots,
     readVpsSelfUpdateLogFileContent,
 } from '../vpsSelfUpdate';
@@ -308,8 +307,8 @@ async function resolveVpsSelfUpdateTaskTerminalSession(taskId: string): Promise<
         return null;
     }
 
-    const latestJob = await readVpsSelfUpdateJobSnapshot();
-    const isLatestJob = resolveVpsSelfUpdateJobIdentity(latestJob) === jobIdentity;
+    const latestJob = jobSnapshots[0] ?? null;
+    const isLatestJob = latestJob !== null && resolveVpsSelfUpdateJobIdentity(latestJob) === jobIdentity;
     const output = isLatestJob
         ? (await readVpsSelfUpdateLogFileContent()) || ''
         : createArchivedVpsSelfUpdateLogPlaceholder(job);
@@ -330,13 +329,27 @@ async function resolveVpsSelfUpdateTaskTerminalSession(taskId: string): Promise<
         subscribe: createPolledTaskTerminalLogFileSubscribe({
             session,
             readOutput: async () => {
-                const latestJobSnapshot = await readVpsSelfUpdateJobSnapshot();
+                const latestJobSnapshot = await readLatestVpsSelfUpdateTaskSnapshot();
+                if (!latestJobSnapshot) {
+                    return null;
+                }
+
                 const isStillLatestJob = resolveVpsSelfUpdateJobIdentity(latestJobSnapshot) === jobIdentity;
 
                 return isStillLatestJob ? (await readVpsSelfUpdateLogFileContent()) || '' : null;
             },
             resolveExitSnapshot: async (knownOutput) => {
-                const latestJobSnapshot = await readVpsSelfUpdateJobSnapshot();
+                const latestJobSnapshot = await readLatestVpsSelfUpdateTaskSnapshot();
+                if (!latestJobSnapshot) {
+                    return {
+                        ...session,
+                        isRunning: false,
+                        output: knownOutput,
+                        finishedAt: new Date().toISOString(),
+                        exitCode: 1,
+                    };
+                }
+
                 const isStillLatestJob = resolveVpsSelfUpdateJobIdentity(latestJobSnapshot) === jobIdentity;
 
                 if (isStillLatestJob && latestJobSnapshot.status === 'running') {
@@ -355,6 +368,16 @@ async function resolveVpsSelfUpdateTaskTerminalSession(taskId: string): Promise<
     };
 }
 
+/**
+ * Reads the latest restart-aware standalone VPS self-update task snapshot.
+ *
+ * @returns Latest self-update task snapshot or `null` when no task snapshot is persisted.
+ */
+async function readLatestVpsSelfUpdateTaskSnapshot(): Promise<VpsSelfUpdateJobSnapshot | null> {
+    const jobSnapshots = await readVpsSelfUpdateJobTaskSnapshots();
+    return jobSnapshots[0] ?? null;
+}
+
 /**
  * Explains why an archived self-update run has no full installer log anymore.
  *

package/apps/agents-server/src/utils/vpsConfiguration.ts

@@ -284,12 +284,12 @@ export async function applyVpsRuntimeConfiguration(
 }
 
 /**
- * Installs/configures the selected local code runner through the shared VPS installer script.
+ * Installs/configures the selected local harness through the shared VPS installer script.
  *
  * @returns Command output or a skipped reason when not running on a Linux VPS.
  */
-export async function applyVpsCodeRunnerConfiguration(): Promise<VpsCommandResult> {
-    return runVpsInstallerCommand('apply-runner', 'VPS code-runner configuration can only be applied on Linux.');
+export async function applyVpsHarnessConfiguration(): Promise<VpsCommandResult> {
+    return runVpsInstallerCommand('apply-runner', 'VPS harness configuration can only be applied on Linux.');
 }
 
 /**