@promptbook/cli 0.112.0-103 → 0.112.0-105

package/apps/agents-server/src/app/AddAgentButton.tsx

@@ -1,6 +1,5 @@
 'use client';
 
-import { useRouter } from 'next/navigation';
 import { FileCard } from '../components/Homepage/FileCard';
 import { useAgentNaming } from '../components/AgentNaming/AgentNamingContext';
 import { showAlert } from '../components/AsyncDialogs/asyncDialogs';
@@ -21,15 +20,11 @@ type AddAgentButtonProps = {
  * Renders the add-agent card and creation dialog workflow.
  */
 export function AddAgentButton({ currentFolderId }: AddAgentButtonProps) {
-    const router = useRouter();
     const { formatText } = useAgentNaming();
     const { t } = useServerLanguage();
     const addButtonLabel = formatText(t('agentCreation.addButtonLabel'));
 
     const { isPreparingDialog, openNewAgentDialog, dialog } = useNewAgentDialog({
-        onCreated: ({ targetPath }) => {
-            router.push(targetPath);
-        },
         onCreateFailed: async (error) => {
             console.error('Failed to create agent:', error);
             await showAlert({

package/apps/agents-server/src/app/actions.ts

@@ -8,6 +8,9 @@ import { DEFAULT_NAME_POOL, NAME_POOL_METADATA_KEY, parseNamePool } from '../con
 import { NEW_AGENT_WIZZARD_METADATA_KEY, parseNewAgentWizardMode } from '../constants/newAgentWizard';
 import { getMetadata } from '../database/getMetadata';
 import { $provideAgentCollectionForServer } from '../tools/$provideAgentCollectionForServer';
+import { invalidateCachedActiveOrganizationSnapshots } from '../utils/agentOrganization/loadAgentOrganizationState';
+import { resolveAgentRouteTarget } from '../utils/agentRouting/resolveAgentRouteTarget';
+import { buildAgentChatHref, buildAgentProfileHref } from '../utils/agentRouting/agentRouteHrefs';
 import { type AgentVisibility, parseAgentVisibility } from '../utils/agentVisibility';
 import { authenticateUser } from '../utils/authenticateUser';
 import { createAgentWithDefaultVisibility } from '../utils/createAgentWithDefaultVisibility';
@@ -15,6 +18,16 @@ import { resolveCurrentUserIdentity } from '../utils/currentUserIdentity';
 import { isUserAdmin } from '../utils/isUserAdmin';
 import { clearSession, setSession } from '../utils/session';
 
+/**
+ * Maximum attempts used to confirm a freshly created agent route resolves before navigation starts.
+ */
+const CREATED_AGENT_ROUTE_READY_ATTEMPTS = 20;
+
+/**
+ * Delay between created-agent route-resolution retries.
+ */
+const CREATED_AGENT_ROUTE_READY_DELAY_MS = 100;
+
 /**
  * Creates a new agent from the generated boilerplate template.
  *
@@ -34,6 +47,8 @@ export async function $createAgentAction(): Promise<{ agentName: string_agent_na
     const { agentName, permanentId } = await createAgentWithDefaultVisibility(collection, agentSource, {
         userId: currentUserIdentity?.userId,
     });
+    revalidateCreatedAgentPaths(permanentId);
+    await waitForCreatedAgentRoute(permanentId);
 
     return { agentName, permanentId };
 }
@@ -63,6 +78,39 @@ export async function $getNewAgentCreationSettingsAction(): Promise<{
     };
 }
 
+/**
+ * Clears cached organization snapshots and route payloads after a new agent is created.
+ *
+ * @param permanentId - Canonical identifier of the newly created agent.
+ */
+function revalidateCreatedAgentPaths(permanentId: string_agent_permanent_id): void {
+    invalidateCachedActiveOrganizationSnapshots();
+    revalidatePath('/', 'layout');
+    revalidatePath('/');
+    revalidatePath('/agents');
+    revalidatePath('/dashboard');
+    revalidatePath(buildAgentProfileHref(permanentId));
+    revalidatePath(buildAgentChatHref(permanentId));
+}
+
+/**
+ * Waits until the new agent can be resolved by the same routing helper the chat page uses.
+ *
+ * @param permanentId - Canonical identifier of the newly created agent.
+ */
+async function waitForCreatedAgentRoute(permanentId: string_agent_permanent_id): Promise<void> {
+    for (let attempt = 0; attempt < CREATED_AGENT_ROUTE_READY_ATTEMPTS; attempt++) {
+        const routeTarget = await resolveAgentRouteTarget(permanentId, { forceRefresh: true });
+        if (routeTarget?.kind === 'local' && routeTarget.canonicalAgentId === permanentId) {
+            return;
+        }
+
+        await new Promise((resolve) => setTimeout(resolve, CREATED_AGENT_ROUTE_READY_DELAY_MS));
+    }
+
+    throw new Error(`Created agent "${permanentId}" could not be resolved for routing immediately after creation.`);
+}
+
 /**
  * Creates a new agent using provided book content.
  *
@@ -89,6 +137,8 @@ export async function $createAgentFromBookAction(
         visibility: visibility ?? undefined,
         userId: currentUserIdentity?.userId,
     });
+    revalidateCreatedAgentPaths(permanentId);
+    await waitForCreatedAgentRoute(permanentId);
 
     return { agentName, permanentId };
 }

package/apps/agents-server/src/app/admin/image-generator-test/ImageAttachmentsEditor.tsx

@@ -1,5 +1,7 @@
 import { useCallback, useRef, useState, type ChangeEvent } from 'react';
 import { showAlert } from '../../../components/AsyncDialogs/asyncDialogs';
+import { FileUploadUnavailableNotice } from '../../../components/FileUploadAvailability/FileUploadUnavailableNotice';
+import { useFileUploadAvailability } from '../../../components/FileUploadAvailability/FileUploadAvailabilityContext';
 import { getSafeCdnPath } from '../../../utils/cdn/utils/getSafeCdnPath';
 import { normalizeUploadFilename } from '../../../utils/normalization/normalizeUploadFilename';
 import { uploadFileToServer } from '../../../utils/upload/uploadFileToServer';
@@ -128,6 +130,7 @@ function CloseIcon({ size = 24, color = 'currentColor' }: IconProps) {
  */
 export function ImageAttachmentsEditor({ attachments, onChange, disabled }: ImageAttachmentsEditorProps) {
     const fileInputRef = useRef<HTMLInputElement>(null);
+    const fileUploadAvailability = useFileUploadAvailability();
     const [isUploading, setIsUploading] = useState(false);
 
     const handleFileUpload = useCallback(
@@ -138,6 +141,18 @@ export function ImageAttachmentsEditor({ attachments, onChange, disabled }: Imag
                 return;
             }
 
+            if (!fileUploadAvailability.isUploadAvailable) {
+                await showAlert({
+                    title: 'Upload unavailable',
+                    message: fileUploadAvailability.message || 'File uploads are not available for this server.',
+                }).catch(() => undefined);
+
+                if (fileInputRef.current) {
+                    fileInputRef.current.value = '';
+                }
+                return;
+            }
+
             setIsUploading(true);
 
             try {
@@ -158,7 +173,7 @@ export function ImageAttachmentsEditor({ attachments, onChange, disabled }: Imag
                 }
             }
         },
-        [attachments, onChange],
+        [attachments, fileUploadAvailability, onChange],
     );
 
     const handleRemoveAttachment = useCallback(
@@ -202,11 +217,11 @@ export function ImageAttachmentsEditor({ attachments, onChange, disabled }: Imag
                     accept="image/*"
                     multiple
                     className="hidden"
-                    disabled={disabled || isUploading}
+                    disabled={disabled || isUploading || !fileUploadAvailability.isUploadAvailable}
                 />
                 <button
                     onClick={() => fileInputRef.current?.click()}
-                    disabled={disabled || isUploading}
+                    disabled={disabled || isUploading || !fileUploadAvailability.isUploadAvailable}
                     className="text-xs flex items-center gap-1 px-2 py-1 border border-gray-300 rounded hover:bg-gray-50 disabled:opacity-50"
                     type="button"
                 >
@@ -214,6 +229,7 @@ export function ImageAttachmentsEditor({ attachments, onChange, disabled }: Imag
                     {isUploading ? 'Uploading...' : 'Add Image'}
                 </button>
             </div>
+            {!disabled && !fileUploadAvailability.isUploadAvailable && <FileUploadUnavailableNotice />}
         </div>
     );
 }

package/apps/agents-server/src/app/admin/limits/LimitsClient.tsx

@@ -25,17 +25,14 @@ const LIMIT_INPUT_CLASS_NAME =
  *
  * @private client-side admin limits constant
  */
-const LIMIT_DEFINITIONS_BY_CATEGORY = SERVER_LIMIT_DEFINITIONS.reduce(
-    (categories, definition) => {
-        if (!categories[definition.category]) {
-            categories[definition.category] = [];
-        }
+const LIMIT_DEFINITIONS_BY_CATEGORY = SERVER_LIMIT_DEFINITIONS.reduce((categories, definition) => {
+    if (!categories[definition.category]) {
+        categories[definition.category] = [];
+    }
 
-        categories[definition.category]!.push(definition);
-        return categories;
-    },
-    {} as Record<ServerLimitDefinition['category'], Array<ServerLimitDefinition>>,
-);
+    categories[definition.category]!.push(definition);
+    return categories;
+}, {} as Record<ServerLimitDefinition['category'], Array<ServerLimitDefinition>>);
 
 /**
  * Dedicated admin page for configuring runtime server limits.
@@ -152,8 +149,8 @@ export function LimitsClient() {
                     </p>
                     <p>
                         Missing dedicated rows automatically fall back to the legacy metadata values and then to the
-                        repository defaults, so existing installations keep their current behavior until limits are saved
-                        here.
+                        repository defaults, so existing installations keep their current behavior until limits are
+                        saved here.
                     </p>
                 </div>
             </Card>
@@ -172,6 +169,8 @@ export function LimitsClient() {
                                     'Limits used while retrying federated server agent-book imports.'}
                                 {category === 'Agent spawning' &&
                                     'Limits protecting the persistent `spawn_agent` tool from accidental or abusive overuse.'}
+                                {category === 'Local agent runner' &&
+                                    'Limits controlling local coding-agent retries for durable chat messages.'}
                             </p>
                         </div>
 

package/apps/agents-server/src/app/admin/metadata/MetadataClient.tsx

@@ -4,6 +4,7 @@ import { FileTextIcon, HashIcon, ImageIcon, ListIcon, ShieldIcon, ToggleLeftIcon
 import Link from 'next/link';
 import { Fragment, useEffect, useRef, useState } from 'react';
 import { showConfirm } from '../../../components/AsyncDialogs/asyncDialogs';
+import { useFileUploadAvailability } from '../../../components/FileUploadAvailability/FileUploadAvailabilityContext';
 import { getMetadataDefinition, metadataDefaults, type MetadataDefinition } from '../../../database/metadataDefaults';
 import { getSafeCdnPath } from '../../../utils/cdn/utils/getSafeCdnPath';
 import { normalizeUploadFilename } from '../../../utils/normalization/normalizeUploadFilename';
@@ -99,6 +100,8 @@ type MetadataValueFieldProps = {
     value: string;
     onValueChange: (value: string) => void;
     isUploading: boolean;
+    isUploadAvailable: boolean;
+    uploadUnavailableMessage: string | null;
     fileInputRef: React.RefObject<HTMLInputElement | null>;
     onFileUpload: (event: React.ChangeEvent<HTMLInputElement>) => Promise<void> | void;
     fieldId: string;
@@ -117,6 +120,8 @@ const MetadataValueField = ({
     value,
     onValueChange,
     isUploading,
+    isUploadAvailable,
+    uploadUnavailableMessage,
     fileInputRef,
     onFileUpload,
     fieldId,
@@ -166,17 +171,27 @@ const MetadataValueField = ({
                         className={METADATA_INPUT_CLASS_NAME}
                         placeholder="Image URL..."
                     />
-                    <input type="file" accept="image/*" className="hidden" ref={fileInputRef} onChange={onFileUpload} />
+                    <input
+                        type="file"
+                        accept="image/*"
+                        className="hidden"
+                        ref={fileInputRef}
+                        onChange={onFileUpload}
+                        disabled={!isUploadAvailable}
+                    />
                     <button
                         type="button"
                         onClick={() => fileInputRef.current?.click()}
-                        disabled={isUploading}
+                        disabled={isUploading || !isUploadAvailable}
                         className="bg-gray-100 text-gray-700 px-3 py-2 rounded-md border border-gray-300 hover:bg-gray-200 flex items-center space-x-2 min-w-max"
                     >
                         <Upload className="w-4 h-4" />
                         <span>{isUploading ? 'Uploading...' : 'Upload Image'}</span>
                     </button>
                 </div>
+                {!isUploadAvailable && uploadUnavailableMessage && (
+                    <p className="text-sm text-amber-700">{uploadUnavailableMessage}</p>
+                )}
                 {value && (
                     <div className="mt-2 p-2 border border-gray-200 rounded-md bg-gray-50 inline-block">
                         {/* eslint-disable-next-line @next/next/no-img-element */}
@@ -326,6 +341,7 @@ function mergeMetadataWithDefaults(data: MetadataEntry[]): MetadataEntry[] {
  * @private @@@
  */
 export function MetadataClient() {
+    const fileUploadAvailability = useFileUploadAvailability();
     const [metadata, setMetadata] = useState<MetadataEntry[]>([]);
     const [loading, setLoading] = useState(true);
     const [error, setError] = useState<string | null>(null);
@@ -499,6 +515,14 @@ export function MetadataClient() {
         const file = event.target.files?.[0];
         if (!file) return;
 
+        if (!fileUploadAvailability.isUploadAvailable) {
+            setError(fileUploadAvailability.message || 'File uploads are not available for this server.');
+            if (fileInputRef.current) {
+                fileInputRef.current.value = '';
+            }
+            return;
+        }
+
         try {
             setUploading(true);
 
@@ -599,6 +623,8 @@ export function MetadataClient() {
                             value={addFormState.value}
                             onValueChange={(value) => setAddFormState((prev) => ({ ...prev, value }))}
                             isUploading={isAddUploading}
+                            isUploadAvailable={fileUploadAvailability.isUploadAvailable}
+                            uploadUnavailableMessage={fileUploadAvailability.message}
                             fileInputRef={addFileInputRef}
                             onFileUpload={handleAddFileUpload}
                         />
@@ -767,6 +793,12 @@ export function MetadataClient() {
                                                                         setEditingFormState((prev) => ({ ...prev, value }))
                                                                     }
                                                                     isUploading={isEditUploading}
+                                                                    isUploadAvailable={
+                                                                        fileUploadAvailability.isUploadAvailable
+                                                                    }
+                                                                    uploadUnavailableMessage={
+                                                                        fileUploadAvailability.message
+                                                                    }
                                                                     fileInputRef={editFileInputRef}
                                                                     onFileUpload={handleEditFileUpload}
                                                                 />

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

@@ -2,6 +2,8 @@
 
 import { Loader2, Plus, Upload, X } from 'lucide-react';
 import type { ChangeEvent, RefObject } from 'react';
+import { FileUploadUnavailableNotice } from '../../../components/FileUploadAvailability/FileUploadUnavailableNotice';
+import { useFileUploadAvailability } from '../../../components/FileUploadAvailability/FileUploadAvailabilityContext';
 import { Dialog } from '../../../components/Portal/Dialog';
 import {
     type CreateServerWizardError,
@@ -125,6 +127,7 @@ function CreateServerForm(props: {
     readonly wizardState: CreateServerWizardState;
 }) {
     const { handleIconUpload, iconInputRef, isUploadingIcon, updateWizardField, wizardState } = props;
+    const fileUploadAvailability = useFileUploadAvailability();
 
     return (
         <div className="space-y-5">
@@ -175,17 +178,19 @@ function CreateServerForm(props: {
                         accept="image/*"
                         className="hidden"
                         onChange={handleIconUpload}
+                        disabled={!fileUploadAvailability.isUploadAvailable}
                     />
                     <button
                         type="button"
                         onClick={() => iconInputRef.current?.click()}
-                        disabled={isUploadingIcon}
+                        disabled={isUploadingIcon || !fileUploadAvailability.isUploadAvailable}
                         className={SECONDARY_BUTTON_CLASS_NAME}
                     >
                         {isUploadingIcon ? <Loader2 className="h-4 w-4 animate-spin" /> : <Upload className="h-4 w-4" />}
                         Upload
                     </button>
                 </div>
+                {!fileUploadAvailability.isUploadAvailable && <FileUploadUnavailableNotice className="mt-3" />}
                 {wizardState.iconUrl ? (
                     <div className="mt-3 inline-flex rounded-lg border border-gray-200 bg-gray-50 p-3">
                         {/* eslint-disable-next-line @next/next/no-img-element */}

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

@@ -2,6 +2,7 @@
 
 import { useCallback, useMemo, useRef, useState, type ChangeEvent, type RefObject } from 'react';
 import { showAlert } from '../../../components/AsyncDialogs/asyncDialogs';
+import { useFileUploadAvailability } from '../../../components/FileUploadAvailability/FileUploadAvailabilityContext';
 import { useDirtyModalGuard } from '../../../components/utils/useDirtyModalGuard';
 import { buildServerTablePrefix } from '../../../utils/buildServerTablePrefix';
 import type { ChatFeedbackMode } from '../../../utils/chatFeedbackMode';
@@ -358,6 +359,7 @@ function hasCreateServerWizardChanges(wizardState: CreateServerWizardState): boo
  */
 export function useCreateServerWizard(options: UseCreateServerWizardOptions): UseCreateServerWizardResult {
     const { onServerCreated } = options;
+    const fileUploadAvailability = useFileUploadAvailability();
     const [isDialogOpen, setIsDialogOpen] = useState(false);
     const [wizardState, setWizardState] = useState<CreateServerWizardState>(createInitialWizardState);
     const [isCreatingServer, setIsCreatingServer] = useState(false);
@@ -421,6 +423,16 @@ export function useCreateServerWizard(options: UseCreateServerWizardOptions): Us
                 return;
             }
 
+            if (!fileUploadAvailability.isUploadAvailable) {
+                setWizardError({
+                    message: fileUploadAvailability.message || 'File uploads are not available for this server.',
+                    sqlDump: null,
+                    sqlFilename: null,
+                });
+                event.target.value = '';
+                return;
+            }
+
             try {
                 setIsUploadingIcon(true);
                 setWizardError(null);
@@ -453,7 +465,7 @@ export function useCreateServerWizard(options: UseCreateServerWizardOptions): Us
                 }
             }
         },
-        [updateWizardField],
+        [fileUploadAvailability, updateWizardField],
     );
 
     const handleCreateServer = useCallback(async () => {

package/apps/agents-server/src/app/agents/[agentName]/AgentChatWrapper.tsx

@@ -11,6 +11,8 @@ import { useAgentBackground } from '../../../components/AgentProfile/useAgentBac
 import { useChatEnterBehaviorPreferences } from '../../../components/ChatEnterBehavior/ChatEnterBehaviorPreferencesProvider';
 import { ChatErrorDialog } from '../../../components/ChatErrorDialog';
 import { useChatVisualMode } from '../../../components/ChatVisualMode/ChatVisualModeProvider';
+import { FileUploadUnavailableNotice } from '../../../components/FileUploadAvailability/FileUploadUnavailableNotice';
+import { useFileUploadAvailability } from '../../../components/FileUploadAvailability/FileUploadAvailabilityContext';
 import { usePrivateModePreferences } from '../../../components/PrivateModePreferences/PrivateModePreferencesProvider';
 import { useSelfLearningPreferences } from '../../../components/SelfLearningPreferences/SelfLearningPreferencesProvider';
 import { useServerLanguage } from '../../../components/ServerLanguage/ServerLanguageProvider';
@@ -110,6 +112,7 @@ export function AgentChatWrapper(props: AgentChatWrapperProps) {
 
     const shouldEnableFeedback = isChatFeedbackEnabled(feedbackMode);
     const { backgroundImage, brandColorHex, brandColorLightHex, brandColorDarkHex } = useAgentBackground(brandColor);
+    const fileUploadAvailability = useFileUploadAvailability();
     const allowFileAttachments = areFileAttachmentsEnabled ?? true;
 
     const chatBackgroundStyle: CSSProperties & Record<string, string> = {
@@ -427,7 +430,9 @@ export function AgentChatWrapper(props: AgentChatWrapperProps) {
             }}
             feedbackMode={toChatComponentFeedbackMode(feedbackMode)}
             onFeedback={shouldEnableFeedback ? handleFeedback : undefined}
-            onFileUpload={allowFileAttachments ? handleFileUpload : undefined}
+            onFileUpload={
+                allowFileAttachments && fileUploadAvailability.isUploadAvailable ? handleFileUpload : undefined
+            }
             onError={handleError}
             defaultMessage={defaultMessage}
             autoExecuteMessage={effectiveAutoExecuteMessage}
@@ -453,7 +458,11 @@ export function AgentChatWrapper(props: AgentChatWrapperProps) {
             onReset={onStartNewChat}
             resetMode={onStartNewChat ? 'delegate' : undefined}
             teamAgentProfiles={teamAgentProfiles}
-        />
+        >
+            {allowFileAttachments && !fileUploadAvailability.isUploadAvailable && (
+                <FileUploadUnavailableNotice className="mx-4 mt-4" />
+            )}
+        </AgentChat>
     );
 
     return (

package/apps/agents-server/src/app/agents/[agentName]/AgentProfileChat.tsx

@@ -4,7 +4,6 @@ import { usePromise } from '@common/hooks/usePromise';
 import { Chat } from '@promptbook-local/components';
 import { RemoteAgent } from '@promptbook-local/core';
 import { string_book, type ChatMessage } from '@promptbook-local/types';
-import { useRouter } from 'next/navigation';
 import { useCallback, useMemo, useState, type MouseEvent as ReactMouseEvent } from 'react';
 import { spaceTrim } from 'spacetrim';
 import { string_agent_url, string_color } from '../../../../../../src/types/typeAliases';
@@ -17,6 +16,8 @@ import { showAlert } from '../../../components/AsyncDialogs/asyncDialogs';
 import { useChatEnterBehaviorPreferences } from '../../../components/ChatEnterBehavior/ChatEnterBehaviorPreferencesProvider';
 import { useChatVisualMode } from '../../../components/ChatVisualMode/ChatVisualModeProvider';
 import { DeletedAgentBanner } from '../../../components/DeletedAgentBanner';
+import { FileUploadUnavailableNotice } from '../../../components/FileUploadAvailability/FileUploadUnavailableNotice';
+import { useFileUploadAvailability } from '../../../components/FileUploadAvailability/FileUploadAvailabilityContext';
 import { createMyChatsMobileMenuItem } from '../../../components/Header/createMyChatsMobileMenuItem';
 import { useHoistedMobileMenuItems } from '../../../components/Header/MobileMenuHoistingContext';
 import { usePrivateModePreferences } from '../../../components/PrivateModePreferences/PrivateModePreferencesProvider';
@@ -24,6 +25,7 @@ import { useServerLanguage } from '../../../components/ServerLanguage/ServerLang
 import { ChatThreadLoadingSkeleton } from '../../../components/Skeleton/ChatThreadLoadingSkeleton';
 import { usePromptbookTheme } from '../../../components/ThemeMode/usePromptbookTheme';
 import type { ServerLanguageCode } from '../../../languages/ServerLanguageRegistry';
+import { buildFreshAgentChatHref } from '../../../utils/agentRouting/agentRouteHrefs';
 import { executeQuickActionButton } from '../../../utils/chat/executeQuickActionButton';
 import { resolveChatMessageValidationIssue } from '../../../utils/chat/validateChatMessageContent';
 import { createServerLanguageMoment } from '../../../utils/localization/createServerLanguageMoment';
@@ -277,13 +279,13 @@ export function AgentProfileChat({
     isHistoryEnabled = false,
     areFileAttachmentsEnabled = true,
 }: AgentProfileChatProps) {
-    const router = useRouter();
     const [isCreatingAgent, setIsCreatingAgent] = useState(false);
     const [optimisticNavigationState, setOptimisticNavigationState] = useState<OptimisticChatNavigationState | null>(null);
     const { formatText } = useAgentNaming();
     const { language, t } = useServerLanguage();
     const { chatVisualMode } = useChatVisualMode();
     const { enterBehavior, resolveEnterBehavior } = useChatEnterBehaviorPreferences();
+    const fileUploadAvailability = useFileUploadAvailability();
     const { isPrivateModeEnabled } = usePrivateModePreferences();
     const { promptbookTheme } = usePromptbookTheme();
 
@@ -409,7 +411,7 @@ export function AgentProfileChat({
             try {
                 const { permanentId } = await $createAgentFromBookAction(bookContent as string_book);
                 if (permanentId) {
-                    router.push(`/agents/${permanentId}`);
+                    window.location.assign(buildFreshAgentChatHref(permanentId));
                 }
             } catch (error) {
                 console.error('Failed to create agent:', error);
@@ -421,7 +423,7 @@ export function AgentProfileChat({
                 setIsCreatingAgent(false);
             }
         },
-        [formatText, router],
+        [formatText],
     );
     const handleFileUpload = useCallback(async (file: File) => chatFileUploadHandler(file), []);
     const fallbackInitialMessage = useMemo(() => {
@@ -485,6 +487,9 @@ export function AgentProfileChat({
                         />
                     )
                 )}
+                {areFileAttachmentsEnabled && !fileUploadAvailability.isUploadAvailable && (
+                    <FileUploadUnavailableNotice />
+                )}
                 <div
                     className={`relative w-full h-[calc(100dvh-300px)] min-h-[350px] md:min-h-[420px] md:h-[500px] agent-chat-route-surface ${
                         isNavigatingToChat ? 'agent-chat-profile-transitioning' : ''
@@ -509,7 +514,11 @@ export function AgentProfileChat({
                                 onMessage={handleMessage}
                                 onActionButton={executeQuickActionButton}
                                 onCreateAgent={handleCreateAgent}
-                                onFileUpload={areFileAttachmentsEnabled ? handleFileUpload : undefined}
+                                onFileUpload={
+                                    areFileAttachmentsEnabled && fileUploadAvailability.isUploadAvailable
+                                        ? handleFileUpload
+                                        : undefined
+                                }
                                 isSaveButtonEnabled={false}
                                 isCopyButtonEnabled={false}
                                 className="h-full w-full rounded-[28px] bg-transparent"

package/apps/agents-server/src/app/agents/[agentName]/book/BookEditorWrapper.tsx

@@ -3,6 +3,8 @@
 import { BookEditor } from '@promptbook-local/components';
 import type { string_book } from '@promptbook-local/types';
 import { bookEditorUploadHandler } from '../../../../utils/upload/createBookEditorUploadHandler';
+import { FileUploadUnavailableNotice } from '../../../../components/FileUploadAvailability/FileUploadUnavailableNotice';
+import { useFileUploadAvailability } from '../../../../components/FileUploadAvailability/FileUploadAvailabilityContext';
 import { SaveFailureNotice } from '../../../../components/SaveFailureNotice/SaveFailureNotice';
 import { usePromptbookTheme } from '../../../../components/ThemeMode/usePromptbookTheme';
 import { BookEditorHistoryPanel } from './BookEditorHistoryPanel';
@@ -24,6 +26,7 @@ type BookEditorWrapperProps = {
  */
 export function BookEditorWrapper({ agentName, initialAgentSource }: BookEditorWrapperProps) {
     const { promptbookTheme } = usePromptbookTheme();
+    const fileUploadAvailability = useFileUploadAvailability();
     const {
         agentSource,
         monacoModelPath,
@@ -48,6 +51,7 @@ export function BookEditorWrapper({ agentName, initialAgentSource }: BookEditorW
                     onRetry={retrySaveNow}
                 />
             )}
+            {!fileUploadAvailability.isUploadAvailable && <FileUploadUnavailableNotice className="mb-3" />}
 
             <div className="flex min-h-0 flex-1 gap-4">
                 <div className="flex min-h-0 min-w-0 flex-1 gap-6">
@@ -59,7 +63,9 @@ export function BookEditorWrapper({ agentName, initialAgentSource }: BookEditorW
                             value={agentSource}
                             monacoModelPath={monacoModelPath}
                             onChange={handleChange}
-                            onFileUpload={bookEditorUploadHandler}
+                            onFileUpload={
+                                fileUploadAvailability.isUploadAvailable ? bookEditorUploadHandler : undefined
+                            }
                             diagnostics={diagnostics}
                             hoistedMenuItems={hoistedMenuItems}
                             theme={promptbookTheme}

package/apps/agents-server/src/app/agents/[agentName]/chat/CanonicalAgentChatSurface.tsx

@@ -8,6 +8,8 @@ import { useAgentBackground } from '../../../../components/AgentProfile/useAgent
 import { useChatEnterBehaviorPreferences } from '../../../../components/ChatEnterBehavior/ChatEnterBehaviorPreferencesProvider';
 import { notifyError } from '../../../../components/Notifications/notifications';
 import { useChatVisualMode } from '../../../../components/ChatVisualMode/ChatVisualModeProvider';
+import { FileUploadUnavailableNotice } from '../../../../components/FileUploadAvailability/FileUploadUnavailableNotice';
+import { useFileUploadAvailability } from '../../../../components/FileUploadAvailability/FileUploadAvailabilityContext';
 import { useServerLanguage } from '../../../../components/ServerLanguage/ServerLanguageProvider';
 import { ChatThreadLoadingSkeleton } from '../../../../components/Skeleton/ChatThreadLoadingSkeleton';
 import { useSoundSystem } from '../../../../components/SoundSystemProvider/SoundSystemProvider';
@@ -145,6 +147,7 @@ export function CanonicalAgentChatSurface({
     const cancellableJob = useMemo(() => resolveCancellableJob(activeJobs), [activeJobs]);
     const { chatVisualMode } = useChatVisualMode();
     const { enterBehavior, resolveEnterBehavior } = useChatEnterBehaviorPreferences();
+    const fileUploadAvailability = useFileUploadAvailability();
     const { soundSystem } = useSoundSystem();
     const { promptbookTheme } = usePromptbookTheme();
     const effectConfigs = useMemo(() => createDefaultChatEffects(), []);
@@ -240,7 +243,11 @@ export function CanonicalAgentChatSurface({
             newChatButtonHref={isReadOnly ? undefined : newChatButtonHref}
             feedbackMode={toChatComponentFeedbackMode(feedbackMode)}
             onFeedback={!isReadOnly && feedbackEnabled ? state.onFeedback : undefined}
-            onFileUpload={!isReadOnly && areFileAttachmentsEnabled ? handleFileUpload : undefined}
+            onFileUpload={
+                !isReadOnly && areFileAttachmentsEnabled && fileUploadAvailability.isUploadAvailable
+                    ? handleFileUpload
+                    : undefined
+            }
             participants={participants}
             chatLocale={language}
             timingTranslations={translations.timingTranslations}
@@ -261,6 +268,9 @@ export function CanonicalAgentChatSurface({
             saveFormatHandlers={saveFormatHandlers}
             theme={promptbookTheme}
         >
+            {!isReadOnly && areFileAttachmentsEnabled && !fileUploadAvailability.isUploadAvailable && (
+                <FileUploadUnavailableNotice className="mx-4 mt-4" />
+            )}
             {isReadOnly && frozenChatBannerLabel && (
                 <div className="mx-4 mt-4 rounded-2xl border border-amber-200 bg-amber-50/95 px-4 py-3 text-sm font-medium text-amber-900 shadow-sm dark:border-amber-500/30 dark:bg-amber-500/10 dark:text-amber-100">
                     {translateText('chat.frozenBannerLabel', { source: frozenChatBannerLabel })}

package/apps/agents-server/src/app/agents/[agentName]/images/default-avatar.png/route.ts

@@ -4,8 +4,9 @@ import {
     resolveDefaultAgentAvatarVisualId,
 } from '@/src/constants/defaultAgentAvatarVisual';
 import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
-import { $provideCdnForServer } from '@/src/tools/$provideCdnForServer';
+import { $provideCdnForServer, resolveCdnPublicUrlForServer } from '@/src/tools/$provideCdnForServer';
 import { $provideExecutionToolsForServer } from '@/src/tools/$provideExecutionToolsForServer';
+import { $provideServer } from '@/src/tools/$provideServer';
 import { $provideAgentReferenceResolver } from '@/src/utils/agentReferenceResolver/$provideAgentReferenceResolver';
 import { resolveServerAgentContext } from '@/src/utils/resolveServerAgentContext';
 import { computeHash, serializeError } from '@promptbook-local/utils';
@@ -71,6 +72,7 @@ async function renderGeneratedDefaultAvatar(
     agentProfile: Awaited<ReturnType<typeof resolveAgentProfileForDefaultAvatar>>,
 ) {
     const prompt = getAgentDefaultAvatarPrompt(agentProfile);
+    const providedServer = await $provideServer();
 
     // Use hash of the prompt as cache key - this ensures regeneration when prompt changes
     const promptHash = computeHash(prompt);
@@ -112,7 +114,9 @@ async function renderGeneratedDefaultAvatar(
 
             const imageBuffer = await imageResponse.arrayBuffer();
             const buffer = Buffer.from(imageBuffer);
-            const cdn = $provideCdnForServer();
+            const cdn = $provideCdnForServer({
+                cdnPublicUrl: resolveCdnPublicUrlForServer(providedServer.publicUrl),
+            });
             const cdnKey = getGeneratedImageCdnKey({
                 filename: internalFilename,
                 pathPrefix: cdn.pathPrefix,

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

@@ -0,0 +1,18 @@
+import { NextResponse } from 'next/server';
+
+/**
+ * Ensures the readiness route runs in the same runtime as the standalone server.
+ */
+export const runtime = 'nodejs';
+
+/**
+ * Prevents a cached response from hiding readiness failures during deployment handoff.
+ */
+export const dynamic = 'force-dynamic';
+
+/**
+ * Lightweight readiness endpoint used by standalone VPS pm2/nginx handoffs.
+ */
+export async function GET() {
+    return NextResponse.json({ status: 'ok' });
+}