@promptbook/cli 0.112.0-104 → 0.112.0-105

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

@@ -16,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';
@@ -283,6 +285,7 @@ export function AgentProfileChat({
     const { language, t } = useServerLanguage();
     const { chatVisualMode } = useChatVisualMode();
     const { enterBehavior, resolveEnterBehavior } = useChatEnterBehaviorPreferences();
+    const fileUploadAvailability = useFileUploadAvailability();
     const { isPrivateModeEnabled } = usePrivateModePreferences();
     const { promptbookTheme } = usePromptbookTheme();
 
@@ -484,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' : ''
@@ -508,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/images/[filename]/route.ts

@@ -5,8 +5,9 @@ import type { LlmExecutionTools } from '../../../../../../../src/execution/LlmEx
 import { getSingleLlmExecutionTools } from '../../../../../../../src/llm-providers/_multiple/getSingleLlmExecutionTools';
 import type { ImageGenerationModelRequirements } from '../../../../../../../src/types/ModelRequirements';
 import { string_url } from '../../../../../../../src/types/typeAliases';
-import { $provideCdnForServer } from '../../../../tools/$provideCdnForServer';
+import { $provideCdnForServer, resolveCdnPublicUrlForServer } from '../../../../tools/$provideCdnForServer';
 import { $provideExecutionToolsForServer } from '../../../../tools/$provideExecutionToolsForServer';
+import { $provideServer } from '../../../../tools/$provideServer';
 import { getGeneratedImageCdnKey } from '../../../../utils/cdn/utils/getGeneratedImageCdnKey';
 import { ensureGeneratedImage } from '../../../../utils/imageGeneration/ensureGeneratedImage';
 import { filenameToPrompt } from '../../../../utils/normalization/filenameToPrompt';
@@ -47,6 +48,7 @@ export async function GET(request: NextRequest, { params }: { params: Promise<{
 
         const prompt = filenameToPrompt(filename);
         const executionTools = await $provideExecutionToolsForServer();
+        const providedServer = await $provideServer();
         const llmTools = getSingleLlmExecutionTools(executionTools.llm) as LlmExecutionTools;
 
         if (!llmTools.callImageGenerationModel) {
@@ -89,7 +91,9 @@ export async function GET(request: NextRequest, { params }: { params: Promise<{
                 const imageBuffer = await imageResponse.arrayBuffer();
                 const buffer = Buffer.from(imageBuffer);
 
-                const cdn = $provideCdnForServer();
+                const cdn = $provideCdnForServer({
+                    cdnPublicUrl: resolveCdnPublicUrlForServer(providedServer.publicUrl),
+                });
                 const cdnKey = getGeneratedImageCdnKey({ filename, pathPrefix: cdn.pathPrefix });
                 await cdn.setItem(cdnKey, {
                     type: 'image/png',

package/apps/agents-server/src/app/api/internal/agent-runner-limits/route.ts

@@ -0,0 +1,51 @@
+import { NextResponse } from 'next/server';
+import { resolveUserChatWorkerInternalToken } from '@/src/utils/userChat';
+import { getLocalAgentRunnerLimits } from '@/src/utils/serverLimits';
+
+/**
+ * Loads local agent-runner limits for the foreground CLI worker.
+ */
+export async function GET(request: Request) {
+    return handleAgentRunnerLimitsRequest(request);
+}
+
+/**
+ * Loads local agent-runner limits for the foreground CLI worker.
+ */
+export async function POST(request: Request) {
+    return handleAgentRunnerLimitsRequest(request);
+}
+
+/**
+ * Validates authorization and returns the current local runner retry limits.
+ *
+ * @param request - Incoming route request.
+ * @returns Local runner limits response.
+ */
+async function handleAgentRunnerLimitsRequest(request: Request) {
+    if (!isAuthorizedInternalWorkerRequest(request)) {
+        return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+    }
+
+    try {
+        return NextResponse.json(await getLocalAgentRunnerLimits());
+    } catch (error) {
+        return NextResponse.json(
+            {
+                error: error instanceof Error ? error.message : 'Failed to load local agent runner limits.',
+            },
+            { status: 500 },
+        );
+    }
+}
+
+/**
+ * Validates the shared internal worker token.
+ *
+ * @param request - Incoming route request.
+ * @returns `true` when the internal worker token matches.
+ */
+function isAuthorizedInternalWorkerRequest(request: Request): boolean {
+    const token = request.headers.get('x-user-chat-worker-token');
+    return token === resolveUserChatWorkerInternalToken();
+}