@promptbook/cli 0.113.0-1 → 0.113.0-11

package/apps/agents-server/src/app/admin/task-manager/TaskManagerTaskRow.tsx

@@ -1,6 +1,12 @@
+'use client';
+
+import { useState } from 'react';
+import { SquareTerminal } from 'lucide-react';
 import type { AdminChatTaskRecord } from '@/src/utils/chatTasksAdmin';
 import type { ServerLanguageCode } from '@/src/languages/ServerLanguageRegistry';
 import { formatServerLanguageHumanReadableDate } from '@/src/utils/localization/formatServerLanguageHumanReadableDate';
+import { TaskManagerTaskLogActions } from './TaskManagerTaskLogActions';
+import { TaskManagerTaskTerminalDialog } from './TaskManagerTaskTerminalDialog';
 import type { useTaskManagerState } from './useTaskManagerState';
 
 /**
@@ -11,6 +17,7 @@ import type { useTaskManagerState } from './useTaskManagerState';
 type TaskManagerTaskRowProps = {
     busyAction: ReturnType<typeof useTaskManagerState>['busyAction'];
     busyTaskId: ReturnType<typeof useTaskManagerState>['busyTaskId'];
+    isSuperAdmin: boolean;
     language: ServerLanguageCode;
     onRunTaskAction: ReturnType<typeof useTaskManagerState>['runTaskAction'];
     stuckThresholdMinutes: ReturnType<typeof useTaskManagerState>['stuckThresholdMinutes'];
@@ -54,6 +61,8 @@ type TaskInfoBlockProps = {
  */
 type TaskManagerTaskActionsProps = Pick<TaskManagerTaskRowProps, 'busyAction' | 'onRunTaskAction' | 'task'> & {
     isBusy: boolean;
+    isSuperAdmin: boolean;
+    onOpenTerminal: () => void;
 };
 
 /**
@@ -134,6 +143,10 @@ function formatTaskKind(kind: AdminChatTaskRecord['kind']): string {
         return 'Self-update';
     }
 
+    if (kind === 'BROWSER_PREVIEW') {
+        return 'Browser preview';
+    }
+
     return kind;
 }
 
@@ -263,13 +276,32 @@ function resolveTaskRowClassName(task: AdminChatTaskRecord, isStuck: boolean): s
  *
  * @private function of TaskManagerTaskRow
  */
-function TaskManagerTaskActions({ busyAction, isBusy, onRunTaskAction, task }: TaskManagerTaskActionsProps) {
+function TaskManagerTaskActions({
+    busyAction,
+    isBusy,
+    isSuperAdmin,
+    onOpenTerminal,
+    onRunTaskAction,
+    task,
+}: TaskManagerTaskActionsProps) {
     const isDurableChatTask = task.kind === 'CHAT_COMPLETION' || task.kind === 'CHAT_TIMEOUT';
     const isCancelable = isDurableChatTask && (task.status === 'QUEUED' || task.status === 'RUNNING');
     const isRetryable = isDurableChatTask && task.status === 'FAILED';
 
     return (
-        <div className="flex justify-end gap-2">
+        <div className="flex flex-wrap justify-end gap-2">
+            {isSuperAdmin ? (
+                <button
+                    type="button"
+                    onClick={onOpenTerminal}
+                    className="inline-flex items-center gap-1 rounded-md border border-slate-300 bg-slate-900 px-3 py-1.5 font-semibold text-white hover:bg-slate-800"
+                    title="Open the read-only live CLI terminal of this task"
+                >
+                    <SquareTerminal className="h-3.5 w-3.5" />
+                    Terminal
+                </button>
+            ) : null}
+
             {isCancelable ? (
                 <button
                     type="button"
@@ -292,7 +324,7 @@ function TaskManagerTaskActions({ busyAction, isBusy, onRunTaskAction, task }: T
                 </button>
             ) : null}
 
-            {!isCancelable && !isRetryable ? (
+            {!isCancelable && !isRetryable && !isSuperAdmin ? (
                 <span className="rounded-md border border-gray-200 bg-gray-50 px-3 py-1.5 font-medium text-gray-500">
                     -
                 </span>
@@ -309,11 +341,13 @@ function TaskManagerTaskActions({ busyAction, isBusy, onRunTaskAction, task }: T
 export function TaskManagerTaskRow({
     busyAction,
     busyTaskId,
+    isSuperAdmin,
     language,
     onRunTaskAction,
     stuckThresholdMinutes,
     task,
 }: TaskManagerTaskRowProps) {
+    const [isTerminalDialogOpen, setIsTerminalDialogOpen] = useState(false);
     const isStuck = isTaskStuck(task, stuckThresholdMinutes);
     const isBusy = busyTaskId === task.id;
 
@@ -402,21 +436,26 @@ export function TaskManagerTaskRow({
             </td>
 
             <td className="max-w-xs px-4 py-3 align-top text-[11px] leading-relaxed text-gray-600">
-                {task.lastErrorSummary || task.lastErrorDetails ? (
-                    <div className="space-y-2">
-                        {task.lastErrorSummary ? <div>{truncateText(task.lastErrorSummary, 220)}</div> : null}
-                        {task.lastErrorDetails ? (
-                            <details className="rounded-md border border-gray-200 bg-gray-50 p-2">
-                                <summary className="cursor-pointer font-medium text-gray-700">Show details</summary>
-                                <pre className="mt-2 overflow-x-auto whitespace-pre-wrap break-words text-[10px] leading-relaxed text-gray-600">
-                                    {task.lastErrorDetails}
-                                </pre>
-                            </details>
-                        ) : null}
-                    </div>
-                ) : (
-                    '-'
-                )}
+                <div className="space-y-2">
+                    {task.lastErrorSummary || task.lastErrorDetails ? (
+                        <>
+                            {task.lastErrorSummary ? <div>{truncateText(task.lastErrorSummary, 220)}</div> : null}
+                            {task.lastErrorDetails ? (
+                                <details className="rounded-md border border-gray-200 bg-gray-50 p-2">
+                                    <summary className="cursor-pointer font-medium text-gray-700">
+                                        Show details
+                                    </summary>
+                                    <pre className="mt-2 overflow-x-auto whitespace-pre-wrap break-words text-[10px] leading-relaxed text-gray-600">
+                                        {task.lastErrorDetails}
+                                    </pre>
+                                </details>
+                            ) : null}
+                        </>
+                    ) : (
+                        '-'
+                    )}
+                    <TaskManagerTaskLogActions task={task} />
+                </div>
             </td>
 
             <td className="px-4 py-3 align-top">
@@ -424,8 +463,13 @@ export function TaskManagerTaskRow({
                     task={task}
                     busyAction={busyAction}
                     isBusy={isBusy}
+                    isSuperAdmin={isSuperAdmin}
+                    onOpenTerminal={() => setIsTerminalDialogOpen(true)}
                     onRunTaskAction={onRunTaskAction}
                 />
+                {isTerminalDialogOpen ? (
+                    <TaskManagerTaskTerminalDialog task={task} onClose={() => setIsTerminalDialogOpen(false)} />
+                ) : null}
             </td>
         </tr>
     );

package/apps/agents-server/src/app/admin/task-manager/TaskManagerTaskTerminalDialog.tsx

@@ -0,0 +1,125 @@
+'use client';
+
+import { Loader2, X } from 'lucide-react';
+import { AdminXtermTerminal } from '@/src/components/AdminTerminal/AdminXtermTerminal';
+import {
+    useAdminTerminalSession,
+    type AdminTerminalSession,
+} from '@/src/components/AdminTerminal/useAdminTerminalSession';
+import { Dialog } from '@/src/components/Portal/Dialog';
+import type { AdminChatTaskRecord } from '@/src/utils/chatTasksAdmin';
+
+/**
+ * Props for the read-only live terminal dialog of one background task.
+ *
+ * @private function of TaskManagerTaskRow
+ */
+type TaskManagerTaskTerminalDialogProps = {
+    task: AdminChatTaskRecord;
+    onClose: () => void;
+};
+
+/**
+ * Resolves the compact status label shown next to the terminal.
+ *
+ * @private function of TaskManagerTaskTerminalDialog
+ */
+function resolveTerminalStatusLabel(session: AdminTerminalSession | null, isLoading: boolean): string {
+    if (isLoading && !session) {
+        return 'Connecting…';
+    }
+
+    if (!session) {
+        return 'Terminal unavailable';
+    }
+
+    if (session.isRunning) {
+        return 'Live';
+    }
+
+    if (session.exitCode === 0) {
+        return 'Finished successfully';
+    }
+
+    if (session.exitCode !== null) {
+        return 'Finished with an error or cancelled';
+    }
+
+    return 'Not running';
+}
+
+/**
+ * Super-admin dialog streaming the read-only CLI terminal of one background task in real time.
+ *
+ * @private function of TaskManagerTaskRow
+ */
+export function TaskManagerTaskTerminalDialog({ task, onClose }: TaskManagerTaskTerminalDialogProps) {
+    const terminal = useAdminTerminalSession({
+        basePath: `/api/admin/chat-tasks/${encodeURIComponent(task.id)}/terminal`,
+        loadErrorMessage: 'Failed to load the task terminal.',
+        startErrorMessage: 'Failed to open the task terminal.',
+        sendErrorMessage: 'The task terminal is read-only.',
+        stopErrorMessage: 'The task terminal cannot be stopped from here.',
+        startSuccessMessage: 'Task terminal opened.',
+        finishSuccessMessage: 'The task finished successfully.',
+        finishErrorMessage: 'The task finished with an error or was cancelled.',
+    });
+
+    return (
+        <Dialog onClose={onClose} className="w-[min(70rem,95vw)] p-6" ariaLabel={`Task terminal ${task.id}`}>
+            <div className="space-y-4">
+                <div className="flex items-start justify-between gap-4">
+                    <div className="min-w-0">
+                        <h2 className="text-lg font-semibold text-slate-900">Task terminal</h2>
+                        <p className="mt-1 break-all font-mono text-xs text-slate-500">{task.id}</p>
+                        <p className="mt-1 text-sm text-slate-600">
+                            Read-only live view of everything this task prints while it runs — the output of the
+                            whole Agents Server is not shown here, only this task&apos;s own terminal.
+                        </p>
+                    </div>
+                    <button
+                        type="button"
+                        onClick={onClose}
+                        className="shrink-0 rounded-md border border-slate-200 bg-white p-2 text-slate-500 hover:bg-slate-50"
+                        aria-label="Close task terminal"
+                    >
+                        <X className="h-4 w-4" />
+                    </button>
+                </div>
+
+                {terminal.errorMessage ? (
+                    <div className="rounded-xl border border-rose-200 bg-rose-50 px-4 py-3 text-sm text-rose-700">
+                        {terminal.errorMessage}
+                    </div>
+                ) : null}
+
+                <div className="flex flex-wrap items-center justify-between gap-3">
+                    <h3 className="text-sm font-semibold text-slate-700">Terminal output</h3>
+                    <span className="inline-flex items-center gap-2 text-xs text-slate-500">
+                        {terminal.isLoadingSession ? <Loader2 className="h-3.5 w-3.5 animate-spin" /> : null}
+                        {resolveTerminalStatusLabel(terminal.session, terminal.isLoadingSession)}
+                    </span>
+                </div>
+
+                <AdminXtermTerminal
+                    terminalId={terminal.session?.id || task.id}
+                    output={terminal.session?.output || ''}
+                    emptyState={
+                        terminal.isLoadingSession
+                            ? 'Connecting to the task terminal…'
+                            : 'No terminal output has been captured for this task on this server instance yet.'
+                    }
+                    isRunning={Boolean(terminal.session?.isRunning)}
+                    isReadOnly
+                    isPlainTextOutput
+                    ariaLabel={`Read-only terminal of task ${task.id}`}
+                />
+
+                <p className="text-xs text-slate-500">
+                    The terminal shows output captured while the task is processed by this server instance; output
+                    produced before the last server restart is not available.
+                </p>
+            </div>
+        </Dialog>
+    );
+}

package/apps/agents-server/src/app/admin/task-manager/TaskManagerTasksCard.tsx

@@ -9,6 +9,7 @@ import { TaskManagerTaskRow } from './TaskManagerTaskRow';
  * @private function of TaskManagerClient
  */
 type TaskManagerTasksCardProps = {
+    isSuperAdmin: boolean;
     language: ServerLanguageCode;
     state: ReturnType<typeof useTaskManagerState>;
 };
@@ -20,13 +21,13 @@ type TaskManagerTasksCardProps = {
  */
 function resolveEmptyStateMessage(view: ReturnType<typeof useTaskManagerState>['view'], search: string): string {
     if (search) {
-        return 'No background chat tasks matched the current search.';
+        return 'No background tasks matched the current search.';
     }
     if (view === 'running') {
-        return 'No running background chat tasks right now.';
+        return 'No running background tasks right now.';
     }
     if (view === 'queued') {
-        return 'No queued background chat tasks right now.';
+        return 'No queued background tasks right now.';
     }
     if (view === 'failed') {
         return 'No failed background chat tasks were recorded in the last 24 hours.';
@@ -35,7 +36,7 @@ function resolveEmptyStateMessage(view: ReturnType<typeof useTaskManagerState>['
         return 'No background chat tasks matched the selected time window.';
     }
 
-    return 'No active background chat tasks right now.';
+    return 'No active background tasks right now.';
 }
 
 /**
@@ -43,7 +44,7 @@ function resolveEmptyStateMessage(view: ReturnType<typeof useTaskManagerState>['
  *
  * @private function of TaskManagerClient
  */
-export function TaskManagerTasksCard({ language, state }: TaskManagerTasksCardProps) {
+export function TaskManagerTasksCard({ isSuperAdmin, language, state }: TaskManagerTasksCardProps) {
     const firstVisibleTaskIndex = Math.min((state.page - 1) * state.pageSize + 1, state.total);
     const lastVisibleTaskIndex = Math.min(state.page * state.pageSize, state.total);
 
@@ -51,7 +52,7 @@ export function TaskManagerTasksCard({ language, state }: TaskManagerTasksCardPr
         <Card className="hover:border-gray-200 hover:shadow-md">
             <div className="flex items-center justify-between gap-4">
                 <div>
-                    <h2 className="text-lg font-medium text-gray-900">Background chat tasks ({state.total.toLocaleString()})</h2>
+                    <h2 className="text-lg font-medium text-gray-900">Background tasks ({state.total.toLocaleString()})</h2>
                     <p className="mt-1 text-sm text-gray-500">
                         Sorted by started time for running work and creation time for queued work.
                     </p>
@@ -87,6 +88,7 @@ export function TaskManagerTasksCard({ language, state }: TaskManagerTasksCardPr
                                     language={language}
                                     busyAction={state.busyAction}
                                     busyTaskId={state.busyTaskId}
+                                    isSuperAdmin={isSuperAdmin}
                                     onRunTaskAction={state.runTaskAction}
                                     stuckThresholdMinutes={state.stuckThresholdMinutes}
                                 />

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

@@ -1,16 +1,17 @@
 import { ForbiddenPage } from '../../../components/ForbiddenPage/ForbiddenPage';
 import { isUserAdmin } from '../../../utils/isUserAdmin';
+import { isUserGlobalAdmin } from '../../../utils/isUserGlobalAdmin';
 import { TaskManagerClient } from './TaskManagerClient';
 
 /**
  * Admin task-manager page showing durable background chat work across the server.
  */
 export default async function AdminTaskManagerPage() {
-    const isAdmin = await isUserAdmin();
+    const [isAdmin, isSuperAdmin] = await Promise.all([isUserAdmin(), isUserGlobalAdmin()]);
 
     if (!isAdmin) {
         return <ForbiddenPage />;
     }
 
-    return <TaskManagerClient />;
+    return <TaskManagerClient isSuperAdmin={isSuperAdmin} />;
 }

package/apps/agents-server/src/app/admin/update/AdvancedOriginRepositoryPanel.tsx

@@ -0,0 +1,81 @@
+'use client';
+
+import { ChevronDown, ChevronUp, Settings2 } from 'lucide-react';
+import type { UpdateOverview } from './UpdateOverview';
+
+/**
+ * Props for the advanced upstream repository settings panel.
+ *
+ * @private type of `<AdvancedOriginRepositoryPanel/>`
+ */
+type AdvancedOriginRepositoryPanelProps = {
+    readonly originRepositoryUrlOverride: string;
+    readonly onChange: (nextValue: string) => void;
+    readonly overview: UpdateOverview | null;
+    readonly isExpanded: boolean;
+    readonly onToggleExpanded: () => void;
+    readonly isDisabled: boolean;
+};
+
+/**
+ * Collapsible advanced panel for overriding the upstream repository URL.
+ *
+ * @private internal component of `<UpdateClient/>`
+ */
+export function AdvancedOriginRepositoryPanel({
+    originRepositoryUrlOverride,
+    onChange,
+    overview,
+    isExpanded,
+    onToggleExpanded,
+    isDisabled,
+}: AdvancedOriginRepositoryPanelProps) {
+    return (
+        <div className="min-w-0 rounded-xl border border-slate-200 bg-white">
+            <button
+                type="button"
+                onClick={onToggleExpanded}
+                className="flex w-full items-center justify-between gap-3 px-4 py-3 text-sm font-semibold text-slate-700"
+            >
+                <span className="inline-flex min-w-0 items-center gap-2">
+                    <Settings2 className="h-4 w-4 shrink-0" />
+                    Advanced
+                </span>
+                {isExpanded ? (
+                    <ChevronUp className="h-4 w-4 shrink-0" />
+                ) : (
+                    <ChevronDown className="h-4 w-4 shrink-0" />
+                )}
+            </button>
+            {isExpanded && (
+                <div className="min-w-0 space-y-3 border-t border-slate-100 px-4 py-3 text-sm text-slate-600">
+                    <label className="block">
+                        <span className="text-xs font-semibold uppercase tracking-wide text-slate-500">
+                            Upstream repository URL
+                        </span>
+                        <input
+                            type="url"
+                            value={originRepositoryUrlOverride}
+                            onChange={(event) => onChange(event.target.value)}
+                            disabled={isDisabled}
+                            placeholder={overview?.defaultOriginRepositoryUrl || ''}
+                            className="mt-1 w-full rounded-md border border-slate-300 bg-white px-3 py-2 font-mono text-sm focus:border-blue-500 focus:outline-none focus:ring-1 focus:ring-blue-500 disabled:cursor-not-allowed disabled:opacity-60"
+                        />
+                    </label>
+                    <p className="break-words text-xs text-slate-500">
+                        Defaults to{' '}
+                        <span className="break-all font-mono">{overview?.defaultOriginRepositoryUrl}</span>. Only
+                        change this if you self-host a fork of the original Promptbook repository — the new value is
+                        persisted in the standalone VPS <code>.env</code>.
+                    </p>
+                    {overview && !overview.isOriginRepositoryDefault && (
+                        <div className="break-words rounded-md border border-amber-200 bg-amber-50 px-3 py-2 text-xs text-amber-800">
+                            <strong>Custom origin active:</strong> updates currently pull from{' '}
+                            <span className="break-all font-mono">{overview.originRepositoryUrl}</span>.
+                        </div>
+                    )}
+                </div>
+            )}
+        </div>
+    );
+}

package/apps/agents-server/src/app/admin/update/AutomaticSelfUpdateConfigurationCard.tsx

@@ -0,0 +1,90 @@
+'use client';
+
+import { CalendarClock, Loader2, Save } from 'lucide-react';
+import { CronJobConfiguration } from '../../../components/CronJobConfiguration/CronJobConfiguration';
+import type { UpdateClientState } from './useUpdateClientState';
+
+/**
+ * Props for the automatic self-update configuration card.
+ *
+ * @private type of `<AutomaticSelfUpdateConfigurationCard/>`
+ */
+type AutomaticSelfUpdateConfigurationCardProps = {
+    readonly state: UpdateClientState;
+};
+
+/**
+ * Branch-aware automatic self-update configuration persisted into the VPS `.env` file.
+ *
+ * @private internal component of `<UpdateClient/>`
+ */
+export function AutomaticSelfUpdateConfigurationCard({ state }: AutomaticSelfUpdateConfigurationCardProps) {
+    const isDisabled = state.isLoading || state.isSavingAutomaticConfiguration || state.isUpdateRunning;
+    const environments = (state.overview?.environments ?? []).filter((environment) => !environment.isCustom);
+
+    return (
+        <div className="min-w-0 space-y-4">
+            <div className="flex min-w-0 items-start justify-between gap-3">
+                <div className="min-w-0">
+                    <h2 className="text-lg font-semibold text-slate-900">Automatic self-update</h2>
+                    <p className="mt-1 text-sm text-slate-500">
+                        Scheduled checks use the selected branch and the cron interval stored in the VPS{' '}
+                        <code>.env</code>.
+                    </p>
+                </div>
+                <CalendarClock className="mt-1 h-5 w-5 shrink-0 text-slate-400" />
+            </div>
+
+            <label className="flex items-center gap-3 rounded-xl border border-slate-200 bg-slate-50 px-4 py-3 text-sm font-medium text-slate-800">
+                <input
+                    type="checkbox"
+                    checked={state.automaticConfigurationDraft.isEnabled}
+                    onChange={(event) => state.changeAutomaticUpdateEnabled(event.target.checked)}
+                    disabled={isDisabled}
+                    className="h-4 w-4 rounded border-slate-300 text-blue-600 focus:ring-blue-500 disabled:cursor-not-allowed disabled:opacity-60"
+                />
+                Enable automatic updates
+            </label>
+
+            <div className="grid min-w-0 gap-3">
+                <label className="block min-w-0 text-sm font-medium text-slate-700">
+                    Branch
+                    <select
+                        value={state.automaticConfigurationDraft.environmentId}
+                        onChange={(event) => state.selectAutomaticUpdateEnvironment(event.target.value)}
+                        disabled={isDisabled}
+                        className="mt-1 w-full rounded-md border border-slate-300 bg-white px-3 py-2 text-sm text-slate-900 shadow-sm focus:border-blue-500 focus:outline-none focus:ring-2 focus:ring-blue-200 disabled:cursor-not-allowed disabled:bg-slate-50 disabled:text-slate-500"
+                    >
+                        {environments.map((environment) => (
+                            <option key={environment.id} value={environment.id}>
+                                {environment.label} ({environment.branch})
+                            </option>
+                        ))}
+                    </select>
+                </label>
+
+                <CronJobConfiguration
+                    label="Cron interval"
+                    value={state.automaticConfigurationDraft.cronExpression}
+                    onChange={state.changeAutomaticUpdateCronExpression}
+                    isDisabled={isDisabled}
+                    helperText="Pick a common schedule or edit the cron expression directly."
+                />
+            </div>
+
+            <button
+                type="button"
+                onClick={() => void state.saveAutomaticConfiguration()}
+                disabled={isDisabled || !state.isAutomaticConfigurationChanged}
+                className="inline-flex w-full items-center justify-center gap-2 rounded-md border border-slate-300 bg-white px-4 py-2 text-sm font-semibold text-slate-700 hover:bg-slate-50 disabled:cursor-not-allowed disabled:opacity-60"
+            >
+                {state.isSavingAutomaticConfiguration ? (
+                    <Loader2 className="h-4 w-4 animate-spin" />
+                ) : (
+                    <Save className="h-4 w-4" />
+                )}
+                Save automatic configuration
+            </button>
+        </div>
+    );
+}