@promptbook/cli 0.112.0-132 → 0.112.0-133

package/apps/agents-server/src/app/dashboard/page.tsx

@@ -4,7 +4,6 @@
 export const dynamic = 'force-dynamic';
 
 import { getSingleLlmExecutionTools } from '@promptbook-local/core';
-import moment from 'moment';
 import { headers } from 'next/headers';
 import { AboutPromptbookInformation } from '../../../../../src/utils/misc/xAboutPromptbookInformation';
 import { HomepagePrimarySections } from '../../components/Homepage/HomepagePrimarySections';
@@ -17,21 +16,10 @@ import { getLongRunningTask } from '../../deamons/longRunningTask';
 import { $provideExecutionToolsForServer } from '../../tools/$provideExecutionToolsForServer';
 import { $provideServer } from '../../tools/$provideServer';
 import { isUserAdmin } from '../../utils/isUserAdmin';
+import { formatServerLanguageHumanReadableDate } from '../../utils/localization/formatServerLanguageHumanReadableDate';
+import { getRequestServerLanguage } from '../../utils/localization/getRequestServerLanguage';
 import { getHomePageAgents } from '../_data/getHomePageAgents';
 
-// Add calendar formats that include seconds
-/**
- * Map of calendar with seconds.
- */
-const calendarWithSeconds = {
-    sameDay: '[Today at] LTS',
-    nextDay: '[Tomorrow at] LTS',
-    nextWeek: 'dddd [at] LTS',
-    lastDay: '[Yesterday at] LTS',
-    lastWeek: '[Last] dddd [at] LTS',
-    sameElse: 'L [at] LTS',
-};
-
 /**
  * Renders the legacy dashboard with system and admin details.
  */
@@ -40,6 +28,7 @@ export default async function DashboardPage() {
     const { publicUrl } = server;
     const isAdmin = await isUserAdmin(); /* <- TODO: [??] Here should be user permissions */
     const { agents, folders, homepageMessage, currentUser } = await getHomePageAgents();
+    const language = await getRequestServerLanguage();
 
     const longRunningTask = getLongRunningTask();
 
@@ -92,10 +81,16 @@ export default async function DashboardPage() {
                         <TechInfoCard title={`Long running task ${longRunningTask.taskId}`}>
                             <p className="text-gray-600">Tick: {longRunningTask.tick}</p>
                             <p className="text-gray-600">
-                                Created At: {moment(longRunningTask.createdAt).calendar(undefined, calendarWithSeconds)}
+                                Created At:{' '}
+                                {formatServerLanguageHumanReadableDate(longRunningTask.createdAt, language, {
+                                    isExactDateIncluded: true,
+                                })}
                             </p>
                             <p className="text-gray-600">
-                                Updated At: {moment(longRunningTask.updatedAt).calendar(undefined, calendarWithSeconds)}
+                                Updated At:{' '}
+                                {formatServerLanguageHumanReadableDate(longRunningTask.updatedAt, language, {
+                                    isExactDateIncluded: true,
+                                })}
                             </p>
                         </TechInfoCard>
 

package/apps/agents-server/src/app/swagger/SwaggerApiKeysPanel.tsx

@@ -3,9 +3,11 @@
 import Link from 'next/link';
 import { Plus } from 'lucide-react';
 import { useEffect, useState } from 'react';
+import { useServerLanguage } from '@/src/components/ServerLanguage/ServerLanguageProvider';
 import { SecretInput } from '@/src/components/SecretInput/SecretInput';
 import type { ApiTokenEntry } from '@/src/utils/apiTokensClient';
 import { createApiToken, fetchApiTokens } from '@/src/utils/apiTokensClient';
+import { formatServerLanguageHumanReadableDate } from '@/src/utils/localization/formatServerLanguageHumanReadableDate';
 
 /**
  * Props for the compact Swagger API-key panel.
@@ -21,6 +23,7 @@ type SwaggerApiKeysPanelProps = {
  * Compact API-key panel shown above Swagger UI.
  */
 export function SwaggerApiKeysPanel({ isAdmin }: SwaggerApiKeysPanelProps) {
+    const { language } = useServerLanguage();
     const [tokens, setTokens] = useState<ApiTokenEntry[]>([]);
     const [isLoading, setIsLoading] = useState(isAdmin);
     const [isCreating, setIsCreating] = useState(false);
@@ -110,7 +113,7 @@ export function SwaggerApiKeysPanel({ isAdmin }: SwaggerApiKeysPanelProps) {
                                                 {token.note || `API key #${token.id}`}
                                             </span>
                                             <span className="text-xs text-slate-400">
-                                                {new Date(token.createdAt).toLocaleString()}
+                                                {formatServerLanguageHumanReadableDate(token.createdAt, language)}
                                             </span>
                                         </div>
                                         <SecretInput value={token.token} readOnly aria-label={`API key ${token.id}`} />

package/apps/agents-server/src/app/system/user-memory/UserMemoryClient.tsx

@@ -1,6 +1,8 @@
 'use client';
 
 import { showConfirm } from '@/src/components/AsyncDialogs/asyncDialogs';
+import { useServerLanguage } from '@/src/components/ServerLanguage/ServerLanguageProvider';
+import { formatServerLanguageHumanReadableDate } from '@/src/utils/localization/formatServerLanguageHumanReadableDate';
 import { useEffect, useMemo, useState } from 'react';
 
 /**
@@ -42,6 +44,7 @@ type UserMemoryClientProps = {
  */
 export function UserMemoryClient(props: UserMemoryClientProps) {
     const { agents } = props;
+    const { language } = useServerLanguage();
     const [memories, setMemories] = useState<UserMemoryEntry[]>([]);
     const [loading, setLoading] = useState<boolean>(true);
     const [saving, setSaving] = useState<boolean>(false);
@@ -445,7 +448,7 @@ export function UserMemoryClient(props: UserMemoryClientProps) {
                                             )}
                                         </td>
                                         <td className="px-4 py-3 text-xs text-gray-500">
-                                            {new Date(memory.updatedAt).toLocaleString()}
+                                            {formatServerLanguageHumanReadableDate(memory.updatedAt, language)}
                                         </td>
                                         <td className="px-4 py-3 text-right text-sm">
                                             {isEditing ? (
@@ -491,4 +494,3 @@ export function UserMemoryClient(props: UserMemoryClientProps) {
         </div>
     );
 }
-

package/apps/agents-server/src/app/system/user-wallet/UserWalletClient.tsx

@@ -1,6 +1,7 @@
 'use client';
 
 import { WalletRecordDialog } from '@/src/components/WalletRecordDialog/WalletRecordDialog';
+import { useServerLanguage } from '@/src/components/ServerLanguage/ServerLanguageProvider';
 import type { GithubAppStatusResponse } from '@/src/utils/githubAppClient';
 import { UserWalletCreateCard } from './UserWalletCreateCard';
 import type { UserWalletAgentOption } from './UserWalletAgentOption';
@@ -34,6 +35,7 @@ function resolveGithubAppStatusDescription(status: GithubAppStatusResponse | nul
  */
 export function UserWalletClient(props: UserWalletClientProps) {
     const { agents } = props;
+    const { language } = useServerLanguage();
     const state = useUserWalletClientState({ agents });
 
     return (
@@ -118,6 +120,7 @@ export function UserWalletClient(props: UserWalletClientProps) {
 
             <UserWalletRecordsTable
                 agents={agents}
+                language={language}
                 editingDraft={state.editingDraft}
                 isEditingSmtpRecord={state.isEditingSmtpRecord}
                 isLoading={state.loading}

package/apps/agents-server/src/app/system/user-wallet/UserWalletRecordsTable.tsx

@@ -1,6 +1,8 @@
 'use client';
 
 import type { UserWalletRecord } from '@/src/utils/userWallet';
+import type { ServerLanguageCode } from '@/src/languages/ServerLanguageRegistry';
+import { formatServerLanguageHumanReadableDate } from '@/src/utils/localization/formatServerLanguageHumanReadableDate';
 import type { UserWalletAgentOption } from './UserWalletAgentOption';
 import { formatWalletJsonSchemaForTextarea, type EditingUserWalletDraft, type UpdateUserWalletDraft } from './UserWalletDraft';
 import { UserWalletRecordFormFields } from './UserWalletRecordFormFields';
@@ -11,6 +13,7 @@ import { UserWalletRecordValue } from './UserWalletRecordValue';
  */
 type UserWalletRecordsTableProps = {
     agents: ReadonlyArray<UserWalletAgentOption>;
+    language: ServerLanguageCode;
     editingDraft: EditingUserWalletDraft | null;
     isEditingSmtpRecord: boolean;
     isLoading: boolean;
@@ -31,6 +34,7 @@ type UserWalletRecordsTableProps = {
  */
 export function UserWalletRecordsTable({
     agents,
+    language,
     editingDraft,
     isEditingSmtpRecord,
     isLoading,
@@ -118,7 +122,7 @@ export function UserWalletRecordsTable({
                                         )}
                                     </td>
                                     <td className="px-4 py-3 text-xs text-gray-500">
-                                        {new Date(record.updatedAt).toLocaleString()}
+                                        {formatServerLanguageHumanReadableDate(record.updatedAt, language)}
                                     </td>
                                     <td className="px-4 py-3 text-right text-sm">
                                         {isEditing ? (

package/apps/agents-server/src/app/system/utilities/mocked-chats/MockedChatsEditorClient.tsx

@@ -1,6 +1,7 @@
 'use client';
 
 import { useEffect, useMemo, useState } from 'react';
+import { useServerLanguage } from '@/src/components/ServerLanguage/ServerLanguageProvider';
 import type { MockedChatPreset } from '@/src/utils/mockedChatsSchema';
 import { MockedChatsEditorForm } from './MockedChatsEditorForm';
 import { MockedChatsEditorSidebar } from './MockedChatsEditorSidebar';
@@ -17,6 +18,7 @@ type MockedChatsEditorClientProps = {
  * Mocked chat editor under `System -> Utilities`.
  */
 export function MockedChatsEditorClient({ initialMockedChats }: MockedChatsEditorClientProps) {
+    const { language } = useServerLanguage();
     const mockedChatsEditorState = useMockedChatsEditorState({ initialMockedChats });
     const viewerHref = useMemo(
         () => buildMockedChatViewerHref(mockedChatsEditorState.draftChat.id),
@@ -47,6 +49,7 @@ export function MockedChatsEditorClient({ initialMockedChats }: MockedChatsEdito
 
                 <div className="grid gap-6 lg:grid-cols-[340px_minmax(0,1fr)]">
                     <MockedChatsEditorSidebar
+                        language={language}
                         savedChats={mockedChatsEditorState.savedChats}
                         selectedChatId={mockedChatsEditorState.selectedChatId}
                         createNewDraft={mockedChatsEditorState.createNewDraft}

package/apps/agents-server/src/app/system/utilities/mocked-chats/MockedChatsEditorSidebar.tsx

@@ -1,4 +1,6 @@
 import Link from 'next/link';
+import type { ServerLanguageCode } from '@/src/languages/ServerLanguageRegistry';
+import { formatServerLanguageHumanReadableDate } from '@/src/utils/localization/formatServerLanguageHumanReadableDate';
 import type { UseMockedChatsEditorState } from './useMockedChatsEditorState';
 
 /**
@@ -8,6 +10,7 @@ type MockedChatsEditorSidebarProps = Pick<
     UseMockedChatsEditorState,
     'savedChats' | 'selectedChatId' | 'createNewDraft' | 'selectSavedChat'
 > & {
+    language: ServerLanguageCode;
     buildViewerHref: (mockedChatId: string) => string;
 };
 
@@ -16,13 +19,8 @@ type MockedChatsEditorSidebarProps = Pick<
  *
  * @private function of <MockedChatsEditorClient/>
  */
-function formatMockedChatUpdatedAt(updatedAt: string): string {
-    const date = new Date(updatedAt);
-    if (Number.isNaN(date.getTime())) {
-        return 'just now';
-    }
-
-    return date.toLocaleString();
+function formatMockedChatUpdatedAt(updatedAt: string, language: ServerLanguageCode): string {
+    return formatServerLanguageHumanReadableDate(updatedAt, language, { fallbackLabel: 'just now' });
 }
 
 /**
@@ -31,6 +29,7 @@ function formatMockedChatUpdatedAt(updatedAt: string): string {
  * @private function of <MockedChatsEditorClient/>
  */
 export function MockedChatsEditorSidebar({
+    language,
     savedChats,
     selectedChatId,
     createNewDraft,
@@ -74,7 +73,7 @@ export function MockedChatsEditorSidebar({
                                         <div className="min-w-0">
                                             <p className="truncate text-sm font-semibold text-slate-900">{chat.name}</p>
                                             <p className="mt-1 text-xs text-slate-500">
-                                                Updated {formatMockedChatUpdatedAt(chat.updatedAt)}
+                                                Updated {formatMockedChatUpdatedAt(chat.updatedAt, language)}
                                             </p>
                                         </div>
                                         <Link

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

@@ -1,5 +1,7 @@
 import { formatAgentNamingText } from '../../utils/agentNaming';
 import { getAgentNaming } from '../../utils/getAgentNaming';
+import { formatServerLanguageHumanReadableDate } from '../../utils/localization/formatServerLanguageHumanReadableDate';
+import { getRequestServerLanguage } from '../../utils/localization/getRequestServerLanguage';
 
 /**
  * Renders a print-only header with server branding.
@@ -8,7 +10,7 @@ import { getAgentNaming } from '../../utils/getAgentNaming';
  * @returns Print header markup.
  */
 export async function PrintHeader({ title }: { title?: string }) {
-    const agentNaming = await getAgentNaming();
+    const [agentNaming, language] = await Promise.all([getAgentNaming(), getRequestServerLanguage()]);
     return (
         <div className="hidden print:block mb-6 border-b-2 border-blue-600 pb-2">
             <div className="flex justify-between items-end">
@@ -23,7 +25,7 @@ export async function PrintHeader({ title }: { title?: string }) {
                 {title && <h2 className="text-lg font-semibold text-gray-700">{title}</h2>}
             </div>
             <div className="text-xs text-gray-400 mt-1 text-right">
-                {new Date().toLocaleDateString()}
+                {formatServerLanguageHumanReadableDate(new Date(), language, { isExactDateIncluded: true })}
             </div>
         </div>
     );

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

@@ -6,6 +6,7 @@ import { Card } from '../Homepage/Card';
 import { Section } from '../Homepage/Section';
 import { useServerLanguage } from '../ServerLanguage/ServerLanguageProvider';
 import { SecretInput } from '@/src/components/SecretInput/SecretInput';
+import { formatServerLanguageHumanReadableDate } from '@/src/utils/localization/formatServerLanguageHumanReadableDate';
 import { useUsersAdmin } from './useUsersAdmin';
 
 /**
@@ -26,7 +27,7 @@ type UsersListProps = {
  */
 export function UsersList({ allowCreate = true }: UsersListProps) {
     const { users, loading, error, createUser, deleteUser, toggleAdmin } = useUsersAdmin();
-    const { t } = useServerLanguage();
+    const { language, t } = useServerLanguage();
 
     const [newUsername, setNewUsername] = useState('');
     const [newPassword, setNewPassword] = useState('');
@@ -91,7 +92,8 @@ export function UsersList({ allowCreate = true }: UsersListProps) {
                                     </p>
                                 )}
                                 <p className="text-gray-500 text-sm mt-2">
-                                    {t('users.createdLabel')}: {new Date(user.createdAt).toLocaleDateString()}
+                                    {t('users.createdLabel')}:{' '}
+                                    {formatServerLanguageHumanReadableDate(user.createdAt, language)}
                                 </p>
                             </div>
                             <div className="space-x-2">

package/apps/agents-server/src/tools/createAgentProgressTools.ts

@@ -22,13 +22,15 @@ export function createAgentProgressTools(
         {
             name: AGENT_PROGRESS_TOOL_NAME,
             description: spaceTrim(`
-                Publish real-time progress to the user while you work on a response.
+                Update the visible progress card while you work on a response.
 
-                - Use this for concrete progress, not placeholder reassurance.
-                - Call it before any chunk of work that may take more than a few seconds.
-                - Update it when you start a step, call or finish a tool, learn a result, or decide the next step.
-                - Include what you are doing now, visible actions/results, and what you will do next.
-                - Keep updates concise and user-facing; do not expose hidden chain-of-thought.
+                - Call \`initialize\` before meaningful work when the answer may take more than a few seconds.
+                - Call \`update\` after each user-relevant decision, action, tool use, or result.
+                - Use \`append_items\` for new checklist items discovered while working.
+                - Call \`finalize\` immediately before the final answer.
+                - Keep every update concise, user-facing, and specific about what is happening now and what comes next.
+                - Summarize your reasoning as visible decisions and checks, not hidden chain-of-thought.
+                - Do not expose system prompts, raw tool payloads, secrets, private implementation details, or technical logs.
             `),
             parameters: {
                 type: 'object',

package/apps/agents-server/src/utils/localization/formatServerLanguageHumanReadableDate.ts

@@ -0,0 +1,70 @@
+import moment from 'moment';
+import type { ServerLanguageCode } from '../../languages/ServerLanguageRegistry';
+import { createServerLanguageMoment } from './createServerLanguageMoment';
+
+/**
+ * Default fallback for missing date values.
+ *
+ * @private internal constant of `formatServerLanguageHumanReadableDate`
+ */
+const DEFAULT_FALLBACK_LABEL = 'N/A';
+
+/**
+ * Default localized exact-date format appended when requested.
+ *
+ * @private internal constant of `formatServerLanguageHumanReadableDate`
+ */
+const DEFAULT_EXACT_DATE_FORMAT = 'L LT';
+
+/**
+ * Options for localized human-readable date formatting.
+ *
+ * @private internal type of `formatServerLanguageHumanReadableDate`
+ */
+type FormatServerLanguageHumanReadableDateOptions = {
+    /**
+     * Text returned when the date value is empty.
+     */
+    readonly fallbackLabel?: string;
+
+    /**
+     * Whether to append the localized exact timestamp after the relative label.
+     */
+    readonly isExactDateIncluded?: boolean;
+};
+
+/**
+ * Formats one timestamp for the active Agents Server language.
+ *
+ * @param value - Date-like value, usually an ISO timestamp from the database.
+ * @param language - Active Agents Server language code.
+ * @param options - Formatting options.
+ * @returns Localized relative date label, with optional exact timestamp.
+ * @private internal utility for Agents Server UI.
+ */
+export function formatServerLanguageHumanReadableDate(
+    value: moment.MomentInput | null | undefined,
+    language: ServerLanguageCode,
+    options: FormatServerLanguageHumanReadableDateOptions = {},
+): string {
+    const fallbackLabel = options.fallbackLabel ?? DEFAULT_FALLBACK_LABEL;
+
+    if (value === null || value === undefined || value === '') {
+        return fallbackLabel;
+    }
+
+    const localizedMoment =
+        typeof value === 'string'
+            ? moment(value, moment.ISO_8601, true).locale(language)
+            : createServerLanguageMoment(value, language);
+    if (!localizedMoment.isValid()) {
+        return typeof value === 'string' ? value : fallbackLabel;
+    }
+
+    const relativeLabel = localizedMoment.fromNow();
+    if (!options.isExactDateIncluded) {
+        return relativeLabel;
+    }
+
+    return `${relativeLabel} (${localizedMoment.format(DEFAULT_EXACT_DATE_FORMAT)})`;
+}

package/apps/agents-server/src/utils/localization/getRequestServerLanguage.ts

@@ -0,0 +1,32 @@
+import { cookies } from 'next/headers';
+import { getMetadataMap } from '../../database/getMetadata';
+import {
+    IS_SERVER_LANGUAGE_ENFORCED_METADATA_KEY,
+    parseServerLanguageEnforcedMetadata,
+    resolveServerLanguageCode,
+    SERVER_LANGUAGE_COOKIE_NAME,
+    SERVER_LANGUAGE_METADATA_KEY,
+    type ServerLanguageCode,
+} from '../../languages/ServerLanguageRegistry';
+
+/**
+ * Resolves the active Agents Server UI language for the current server-rendered request.
+ *
+ * @returns Active server language code derived from metadata and the language override cookie.
+ * @private internal utility for server-rendered Agents Server UI.
+ */
+export async function getRequestServerLanguage(): Promise<ServerLanguageCode> {
+    const [metadata, cookieStore] = await Promise.all([
+        getMetadataMap([SERVER_LANGUAGE_METADATA_KEY, IS_SERVER_LANGUAGE_ENFORCED_METADATA_KEY]),
+        cookies(),
+    ]);
+
+    const cookieLanguage = cookieStore.get(SERVER_LANGUAGE_COOKIE_NAME)?.value || null;
+    const rawServerLanguage = metadata[SERVER_LANGUAGE_METADATA_KEY];
+    const isServerLanguageEnforced = parseServerLanguageEnforcedMetadata(
+        metadata[IS_SERVER_LANGUAGE_ENFORCED_METADATA_KEY],
+    );
+    const preferredLanguageSource = isServerLanguageEnforced ? rawServerLanguage : cookieLanguage || rawServerLanguage;
+
+    return resolveServerLanguageCode(preferredLanguageSource);
+}

package/apps/agents-server/src/utils/userChat/createRunUserChatJobExecutionContext.ts

@@ -27,6 +27,7 @@ import type { ChatMessage, ChatPrompt, LlmToolDefinition, ToolCall } from '@prom
 import { resolveTeamInternalAgentAccessToken } from '../../../../../src/commitments/_common/teamInternalAgentAccess';
 import type { ChatPromptResult } from '../../../../../src/execution/PromptResult';
 import { createUserChatMessagePrompt } from './createUserChatMessagePrompt';
+import type { UserChatProgressPhase } from './userChatProgressCard';
 import type { UserChatJobRecord } from './UserChatJobRecord';
 
 /**
@@ -53,6 +54,11 @@ type RunUserChatJobPromptSnapshotFactory = (
     },
 ) => NonNullable<ChatMessage['prompt']>;
 
+/**
+ * Reports one user-facing durable chat progress phase.
+ */
+type RunUserChatJobProgressReporter = (phase: UserChatProgressPhase) => Promise<void>;
+
 /**
  * Prepares the full agent/runtime context required to execute one durable user chat job.
  *
@@ -67,12 +73,18 @@ export async function createRunUserChatJobExecutionContext(options: {
     userMessageAttachments: ChatMessage['attachments'];
     thread: NonNullable<ChatPrompt['thread']>;
     promptContent: ChatPrompt['content'];
+    reportProgress?: RunUserChatJobProgressReporter;
 }) {
+    await options.reportProgress?.('reading_context');
+
     const [localServerUrl, collection, baseAgentReferenceResolver] = await Promise.all([
         resolveCurrentOrInternalServerOrigin(),
         $provideAgentCollectionForServer(),
         $provideAgentReferenceResolver(),
     ]);
+
+    await options.reportProgress?.('preparing_agent');
+
     const resolvedAgentContext = await resolveCachedServerAgentContext({
         collection,
         agentIdentifier: options.job.agentPermanentId,
@@ -91,6 +103,9 @@ export async function createRunUserChatJobExecutionContext(options: {
     const projectRepositories = extractProjectRepositoriesFromAgentSource(agentSource);
     const calendarConnections = extractUseCalendarConnectionsFromAgentSource(agentSource);
     const useEmailConfiguration = extractUseEmailConfigurationFromAgentSource(agentSource);
+
+    await options.reportProgress?.('checking_capabilities');
+
     const { projectGithubToken, calendarGoogleAccessToken, emailSmtpCredential } =
         await resolveRunUserChatJobCredentials({
             userId: options.job.userId,
@@ -164,6 +179,8 @@ export async function createRunUserChatJobExecutionContext(options: {
         });
     }
 
+    await options.reportProgress?.('starting_response');
+
     const agentKitResult = await agentKitCacheManager.getOrCreateAgentKitAgent(
         agentSource,
         resolvedAgentName,

package/apps/agents-server/src/utils/userChat/createRunUserChatJobPersistenceController.ts

@@ -4,7 +4,6 @@ import type { ChatPromptResult } from '../../../../../src/execution/PromptResult
 import { mergeToolCalls } from '../../../../../src/utils/toolCalls/mergeToolCalls';
 import { persistUserChatJobTerminalState } from './persistUserChatJobTerminalState';
 import { updateUserChatAssistantMessage } from './updateUserChatAssistantMessage';
-import { createRunningUserChatProgressCard } from './userChatProgressCard';
 import { USER_CHAT_JOB_ASSISTANT_MESSAGE_PERSIST_INTERVAL_MS } from './userChatJobRuntimeConstants';
 import type { UserChatJobRecord } from './UserChatJobRecord';
 
@@ -45,14 +44,6 @@ export function createRunUserChatJobPersistenceController(options: {
     let hasPendingAssistantMessageUpdate = false;
     let assistantMessageUpdateTimeout: ReturnType<typeof setTimeout> | null = null;
 
-    /**
-     * Creates a typed ISO timestamp for progress-card updates.
-     *
-     * @private function of `createRunUserChatJobPersistenceController`
-     */
-    const createProgressUpdatedAt = (): NonNullable<ChatMessage['progressCard']>['updatedAt'] =>
-        new Date().toISOString() as NonNullable<ChatMessage['progressCard']>['updatedAt'];
-
     /**
      * Queues one assistant-message mutation behind any earlier persistence work.
      *
@@ -141,12 +132,6 @@ export function createRunUserChatJobPersistenceController(options: {
                 lifecycleState: 'running',
                 lifecycleError: undefined,
                 isComplete: false,
-                progressCard: createRunningUserChatProgressCard({
-                    currentProgressCard: message.progressCard,
-                    content: latestContent,
-                    toolCalls: latestToolCalls,
-                    updatedAt: createProgressUpdatedAt(),
-                }),
                 prompt: options.createPromptSnapshot({
                     toolCalls: latestToolCalls,
                 }),
@@ -201,12 +186,6 @@ export function createRunUserChatJobPersistenceController(options: {
                     lifecycleState: 'running',
                     lifecycleError: undefined,
                     isComplete: false,
-                    progressCard: createRunningUserChatProgressCard({
-                        currentProgressCard: message.progressCard,
-                        content: latestContent,
-                        toolCalls: latestToolCalls,
-                        updatedAt: createProgressUpdatedAt(),
-                    }),
                     availableTools: options.availableTools,
                     prompt: options.createPromptSnapshot(),
                 }),

package/apps/agents-server/src/utils/userChat/persistUserChatJobProgressCard.ts

@@ -0,0 +1,31 @@
+import { createUserChatProgressCard, type UserChatProgressPhase } from './userChatProgressCard';
+import { updateUserChatAssistantMessage } from './updateUserChatAssistantMessage';
+
+/**
+ * Persists one durable chat progress phase onto the active assistant placeholder.
+ */
+export async function persistUserChatJobProgressCard(options: {
+    readonly userId: number;
+    readonly agentPermanentId: string;
+    readonly chatId: string;
+    readonly assistantMessageId: string;
+    readonly phase: UserChatProgressPhase;
+}): Promise<void> {
+    await updateUserChatAssistantMessage({
+        userId: options.userId,
+        agentPermanentId: options.agentPermanentId,
+        chatId: options.chatId,
+        assistantMessageId: options.assistantMessageId,
+        mutateMessage: (message) => {
+            const lifecycleState = options.phase === 'queued' ? 'queued' : 'running';
+
+            return {
+                ...message,
+                lifecycleState,
+                lifecycleError: undefined,
+                isComplete: false,
+                progressCard: createUserChatProgressCard(options.phase),
+            };
+        },
+    });
+}

package/apps/agents-server/src/utils/userChat/retryUserChatJob.ts

@@ -1,13 +1,11 @@
 import type { UserChatJobRecord } from './UserChatJobRecord';
 import type { UserChatJobRow } from './UserChatJobRow';
 import type { Json } from '@/src/database/schema';
-import type { ChatMessage } from '@promptbook-local/types';
 import { withoutLocalUserChatJobMetadata } from '../localChatRunner/LocalUserChatJobMetadata';
 import { getUserChatJobById } from './getUserChatJobById';
 import { mapUserChatJobRow } from './mapUserChatJobRow';
 import { provideUserChatJobTable } from './provideUserChatJobTable';
 import { updateUserChatAssistantMessage } from './updateUserChatAssistantMessage';
-import { createQueuedUserChatProgressCard } from './userChatProgressCard';
 
 /**
  * Requeues one failed durable chat job and resets its assistant placeholder.
@@ -25,7 +23,6 @@ export async function retryUserChatJob(jobId: string): Promise<UserChatJobRecord
     }
 
     const nowIso = new Date().toISOString();
-    const progressUpdatedAt = nowIso as NonNullable<ChatMessage['progressCard']>['updatedAt'];
     const userChatJobTable = await provideUserChatJobTable();
     const { data, error } = await userChatJobTable
         .update({
@@ -70,7 +67,6 @@ export async function retryUserChatJob(jobId: string): Promise<UserChatJobRecord
             completedToolCalls: undefined,
             prompt: undefined,
             generationDurationMs: undefined,
-            progressCard: createQueuedUserChatProgressCard(progressUpdatedAt),
         }),
     });
 

package/apps/agents-server/src/utils/userChat/runUserChatJob.ts

@@ -20,7 +20,9 @@ import { finalizeUserChatJob } from './finalizeUserChatJob';
 import { getUserChat } from './getUserChat';
 import { heartbeatUserChatJob } from './heartbeatUserChatJob';
 import { persistUserChatJobTerminalState } from './persistUserChatJobTerminalState';
+import { persistUserChatJobProgressCard } from './persistUserChatJobProgressCard';
 import type { UserChatJobRecord } from './UserChatJobRecord';
+import type { UserChatProgressPhase } from './userChatProgressCard';
 import { createReplyAwareUserChatPromptContent, createReplyAwareUserChatPromptMessage } from './userChatReplies';
 import { resolvePromptThreadBeforeUserMessage } from './userChatMessageLifecycle';
 import { isUserChatNotFoundScopeError } from './UserChatScopeError';
@@ -107,6 +109,7 @@ export async function runUserChatJob(job: UserChatJobRecord): Promise<RunUserCha
         const executionContext = await createRunUserChatJobExecutionContext({
             job,
             ...startContext,
+            reportProgress: createRunUserChatJobProgressReporter(job),
         });
 
         return await executeRunUserChatJob({
@@ -122,6 +125,32 @@ export async function runUserChatJob(job: UserChatJobRecord): Promise<RunUserCha
     }
 }
 
+/**
+ * Creates a non-critical progress reporter for one durable chat job.
+ *
+ * @private function of `runUserChatJob`
+ */
+function createRunUserChatJobProgressReporter(
+    job: Pick<UserChatJobRecord, 'userId' | 'agentPermanentId' | 'chatId' | 'assistantMessageId' | 'id'>,
+): (phase: UserChatProgressPhase) => Promise<void> {
+    return async (phase) => {
+        await persistUserChatJobProgressCard({
+            userId: job.userId,
+            agentPermanentId: job.agentPermanentId,
+            chatId: job.chatId,
+            assistantMessageId: job.assistantMessageId,
+            phase,
+        }).catch((error) => {
+            console.warn('[user-chat-job] progress_update_failed', {
+                chatId: job.chatId,
+                jobId: job.id,
+                phase,
+                error,
+            });
+        });
+    };
+}
+
 /**
  * Loads and validates the chat/user/message snapshot required before one job can start.
  *