@promptbook/cli 0.112.0-132 → 0.112.0-134

package/apps/agents-server/src/app/api/agents/[agentName]/route.ts

@@ -12,6 +12,7 @@ import { NextResponse } from 'next/server';
 import { buildAgentNameOrIdFilter } from '@/src/utils/agentIdentifier';
 import { getCurrentUser } from '@/src/utils/getCurrentUser';
 import { resolveServerAgentContext } from '@/src/utils/resolveServerAgentContext';
+import { invalidateCachedActiveOrganizationSnapshots } from '@/src/utils/agentOrganization/loadAgentOrganizationState';
 
 /**
  * Handles patch.
@@ -45,6 +46,7 @@ export async function PATCH(request: Request, { params }: { params: Promise<{ ag
                 localServerUrl: new URL(request.url).origin,
                 fallbackResolver: baseAgentReferenceResolver,
             });
+            invalidateCachedActiveOrganizationSnapshots();
 
             return NextResponse.json({
                 success: true,
@@ -74,6 +76,8 @@ export async function PATCH(request: Request, { params }: { params: Promise<{ ag
             return NextResponse.json({ success: false, error: updateResult.error.message }, { status: 500 });
         }
 
+        invalidateCachedActiveOrganizationSnapshots();
+
         return NextResponse.json({ success: true });
     } catch (error) {
         return NextResponse.json(
@@ -97,6 +101,7 @@ export async function DELETE(request: Request, { params }: { params: Promise<{ a
 
         const agentId = await collection.getAgentPermanentId(agentName);
         await collection.deleteAgent(agentId);
+        invalidateCachedActiveOrganizationSnapshots();
         return NextResponse.json({ success: true });
     } catch (error) {
         return NextResponse.json(

package/apps/agents-server/src/app/api/internal/user-chat-jobs/run/route.ts

@@ -1,4 +1,4 @@
-import { processNextLocalUserChatJob } from '@/src/utils/localChatRunner';
+import { processNextLocalUserChatJob, type ProcessLocalUserChatJobResult } from '@/src/utils/localChatRunner';
 import {
     recoverExpiredRunningUserChatJobs,
     resolveUserChatWorkerInternalToken,
@@ -51,7 +51,7 @@ async function handleUserChatJobWorkerRequest(request: Request) {
         await recoverExpiredRunningUserChatJobs();
 
         const processedJob = await processNextLocalUserChatJob({ preferredJobId });
-        if (!processedJob) {
+        if (!processedJob || !shouldRequeueUserChatJobWorker(processedJob)) {
             return new Response(null, { status: 204 });
         }
 
@@ -73,6 +73,18 @@ async function handleUserChatJobWorkerRequest(request: Request) {
     }
 }
 
+/**
+ * Decides whether one worker outcome should immediately schedule another worker tick.
+ *
+ * Mutating outcomes may have exposed more queued work, while non-mutating `waiting`
+ * outcomes need the foreground fallback poll instead of a tight self-requeue loop.
+ *
+ * @private route helper
+ */
+function shouldRequeueUserChatJobWorker(processedJob: ProcessLocalUserChatJobResult): boolean {
+    return processedJob.didMutate;
+}
+
 /**
  * Validates the internal worker token.
  *

package/apps/agents-server/src/app/api/v1/agents/[agentId]/route.ts

@@ -6,6 +6,7 @@ import { $getTableName } from '@/src/database/$getTableName';
 import { $provideSupabaseForServer } from '@/src/database/$provideSupabaseForServer';
 import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
 import { $provideServer } from '@/src/tools/$provideServer';
+import { invalidateCachedActiveOrganizationSnapshots } from '@/src/utils/agentOrganization/loadAgentOrganizationState';
 import { findOwnedAgentByIdentifier, findOwnedFolderById, type OwnedAgentRow } from '@/src/utils/agentOwnership';
 import {
     getNextOwnedAgentSortOrder,
@@ -155,6 +156,8 @@ export async function PATCH(request: NextRequest, { params }: { params: Promise<
             return metadataUpdateResponse;
         }
 
+        invalidateCachedActiveOrganizationSnapshots();
+
         return createUpdatedOwnedAgentResponse(request, identityResult.identity.userId, existingAgent);
     } catch (error) {
         return mapOwnedAgentLookupErrorToResponse(request, error);
@@ -192,6 +195,7 @@ export async function DELETE(request: NextRequest, { params }: { params: Promise
 
         const collection = await $provideAgentCollectionForServer();
         await collection.deleteAgent(existingAgent.permanentId || existingAgent.agentName);
+        invalidateCachedActiveOrganizationSnapshots();
 
         return createManagementApiJsonResponse(request, { success: true });
     } catch (error) {

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

@@ -4,6 +4,7 @@ import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentColle
 import { $provideServer } from '@/src/tools/$provideServer';
 import { findOwnedFolderById, findOwnedAgentByIdentifier } from '@/src/utils/agentOwnership';
 import { createAgentWithDefaultVisibility } from '@/src/utils/createAgentWithDefaultVisibility';
+import { invalidateCachedActiveOrganizationSnapshots } from '@/src/utils/agentOrganization/loadAgentOrganizationState';
 import {
     searchOwnedAgents,
     getNextOwnedAgentSortOrder,
@@ -141,6 +142,7 @@ export async function POST(request: NextRequest) {
             sortOrder,
             userId: identityResult.identity.userId,
         });
+        invalidateCachedActiveOrganizationSnapshots();
         const persistedRow = await findOwnedAgentByIdentifier(identityResult.identity.userId, createdAgent.permanentId);
 
         if (!persistedRow) {

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/recycle-bin/actions.ts

@@ -4,6 +4,7 @@ import { restoreAgentAndFolders } from '@/src/utils/agentOrganization/restoreAge
 import { revalidatePath } from 'next/cache';
 import { isUserAdmin } from '../../utils/isUserAdmin';
 import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
+import { invalidateCachedActiveOrganizationSnapshots } from '@/src/utils/agentOrganization/loadAgentOrganizationState';
 
 /**
  * Restores a deleted agent from the recycle bin.
@@ -16,6 +17,7 @@ export async function restoreDeletedAgent(agentName: string) {
     }
 
     await restoreAgentAndFolders(agentName);
+    invalidateCachedActiveOrganizationSnapshots();
 
     revalidatePath('/recycle-bin');
     revalidatePath(`/agents/${agentName}`);
@@ -35,6 +37,7 @@ export async function deleteAgent(agentName: string) {
     const collection = await $provideAgentCollectionForServer();
 
     await collection.deleteAgent(agentName);
+    invalidateCachedActiveOrganizationSnapshots();
 
     revalidatePath('/recycle-bin');
     revalidatePath(`/agents/${agentName}`);

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/database/migrations/2026-06-2600-agent-directory-performance-indexes.sql

@@ -0,0 +1,14 @@
+CREATE INDEX IF NOT EXISTS "prefix_Agent_deletedAt_sortOrder_agentName_idx"
+    ON "prefix_Agent" ("deletedAt", "sortOrder", "agentName");
+
+CREATE INDEX IF NOT EXISTS "prefix_Agent_visibility_deletedAt_sortOrder_agentName_idx"
+    ON "prefix_Agent" ("visibility", "deletedAt", "sortOrder", "agentName");
+
+CREATE INDEX IF NOT EXISTS "prefix_AgentFolder_deletedAt_parentId_sortOrder_name_idx"
+    ON "prefix_AgentFolder" ("deletedAt", "parentId", "sortOrder", "name");
+
+CREATE INDEX IF NOT EXISTS "prefix_UserChat_userId_agentPermanentId_source_createdAt_idx"
+    ON "prefix_UserChat" ("userId", "agentPermanentId", "source", "createdAt" DESC);
+
+CREATE INDEX IF NOT EXISTS "prefix_UserChat_agentPermanentId_source_userId_createdAt_idx"
+    ON "prefix_UserChat" ("agentPermanentId", "source", "userId", "createdAt" DESC);

package/apps/agents-server/src/database/sqlite/$provideLocalSqliteSupabase.ts

@@ -65,6 +65,14 @@ type LocalSqliteUpsertOptions = {
     readonly onConflict?: string;
 };
 
+/**
+ * Read index definition for hot SQLite queries.
+ */
+type LocalSqliteReadIndex = {
+    readonly name: string;
+    readonly columns: ReadonlyArray<string>;
+};
+
 /**
  * Columns whose values are persisted as JSON text in local SQLite.
  */
@@ -141,6 +149,51 @@ const UNIQUE_INDEX_COLUMNS_BY_TABLE = new Map<string, ReadonlyArray<ReadonlyArra
     ['UserPushSubscription', [['endpoint']]],
 ]);
 
+/**
+ * Non-unique indexes for frequent standalone VPS reads.
+ */
+const READ_INDEXES_BY_TABLE = new Map<string, ReadonlyArray<LocalSqliteReadIndex>>([
+    [
+        'Agent',
+        [
+            { name: 'agentName_lookup', columns: ['agentName'] },
+            { name: 'active_directory', columns: ['deletedAt', 'sortOrder', 'agentName'] },
+            { name: 'public_active_directory', columns: ['visibility', 'deletedAt', 'sortOrder', 'agentName'] },
+        ],
+    ],
+    [
+        'AgentFolder',
+        [{ name: 'active_directory', columns: ['deletedAt', 'parentId', 'sortOrder', 'name'] }],
+    ],
+    [
+        'UserChat',
+        [
+            { name: 'user_agent_source_createdAt', columns: ['userId', 'agentPermanentId', 'source', 'createdAt'] },
+            { name: 'agent_source_user_createdAt', columns: ['agentPermanentId', 'source', 'userId', 'createdAt'] },
+        ],
+    ],
+    [
+        'UserChatJob',
+        [
+            { name: 'ready_queue', columns: ['status', 'cancelRequestedAt', 'queuedAt', 'createdAt'] },
+            { name: 'active_chat_scope', columns: ['chatId', 'userId', 'agentPermanentId', 'status', 'createdAt'] },
+            { name: 'agent_chat_status', columns: ['agentPermanentId', 'chatId', 'status'] },
+            { name: 'running_lease', columns: ['status', 'leaseExpiresAt'] },
+        ],
+    ],
+    [
+        'UserChatTimeout',
+        [
+            { name: 'ready_due', columns: ['status', 'cancelRequestedAt', 'pausedAt', 'dueAt', 'createdAt'] },
+            {
+                name: 'active_chat_scope',
+                columns: ['chatId', 'userId', 'agentPermanentId', 'status', 'pausedAt', 'dueAt', 'createdAt'],
+            },
+            { name: 'running_lease', columns: ['status', 'leaseExpiresAt'] },
+        ],
+    ],
+]);
+
 /**
  * Known unique conflict columns used when `.upsert` omits `onConflict`.
  */
@@ -179,6 +232,20 @@ export function $resetLocalSqliteSupabaseForTests(): void {
     localSqliteSupabase = null;
 }
 
+/**
+ * Ensures read indexes for a table that is queried through direct SQLite SQL.
+ *
+ * @param tableName - Actual table name, including any server prefix.
+ *
+ * @private internal SQLite utility of Agents Server
+ */
+export function ensureLocalSqliteTableReadIndexes(tableName: string): void {
+    const database = $provideAgentsServerSqliteDatabase();
+    const tableBaseName = resolveTableBaseName(tableName);
+
+    ensureTable(database, tableName, resolveReadIndexColumns(tableBaseName));
+}
+
 /**
  * Supabase-shaped client with only the table query surface used by Agents Server.
  */
@@ -836,8 +903,9 @@ function ensureTable(
     const columnsToEnsure = uniqueStrings([...requiredColumns, ...resolveUniqueIndexColumns(tableBaseName)]).filter(
         (column) => column !== '*' && column !== 'id',
     );
+    const columnsToEnsureWithIndexes = uniqueStrings([...columnsToEnsure, ...resolveReadIndexColumns(tableBaseName)]);
 
-    for (const column of columnsToEnsure) {
+    for (const column of columnsToEnsureWithIndexes) {
         if (existingColumns.has(column)) {
             continue;
         }
@@ -852,6 +920,7 @@ function ensureTable(
     }
 
     ensureUniqueIndexes(database, tableName, tableBaseName);
+    ensureReadIndexes(database, tableName, tableBaseName);
 }
 
 /**
@@ -871,6 +940,21 @@ function ensureUniqueIndexes(database: AgentsServerSqliteDatabase, tableName: st
     }
 }
 
+/**
+ * Creates known read indexes after required columns exist.
+ */
+function ensureReadIndexes(database: AgentsServerSqliteDatabase, tableName: string, tableBaseName: string): void {
+    const readIndexes = READ_INDEXES_BY_TABLE.get(tableBaseName) || [];
+
+    for (const readIndex of readIndexes) {
+        const indexName = `index_${sanitizeSqlIdentifier(tableName)}_${sanitizeSqlIdentifier(readIndex.name)}`;
+        const columnSql = readIndex.columns.map(quoteIdentifier).join(', ');
+        database.exec(
+            `CREATE INDEX IF NOT EXISTS ${quoteIdentifier(indexName)} ON ${quoteIdentifier(tableName)} (${columnSql})`,
+        );
+    }
+}
+
 /**
  * Inserts one row into the table.
  */
@@ -1441,6 +1525,13 @@ function resolveUniqueIndexColumns(tableBaseName: string): Array<string> {
     return (UNIQUE_INDEX_COLUMNS_BY_TABLE.get(tableBaseName) || []).flatMap((columns) => [...columns]);
 }
 
+/**
+ * Resolves columns participating in known read indexes.
+ */
+function resolveReadIndexColumns(tableBaseName: string): Array<string> {
+    return (READ_INDEXES_BY_TABLE.get(tableBaseName) || []).flatMap((readIndex) => [...readIndex.columns]);
+}
+
 /**
  * Resolves upsert conflict columns.
  */

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',