@promptbook/cli 0.112.0-104 → 0.112.0-106

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

@@ -3,15 +3,22 @@ import { NextRequest, NextResponse } from 'next/server';
 import { spaceTrim } from 'spacetrim';
 import { assertsError } from '../../../../../../src/errors/assertsError';
 import { LimitReachedError } from '../../../../../../src/errors/LimitReachedError';
+import { NotAllowed } from '../../../../../../src/errors/NotAllowed';
 import { UnexpectedError } from '../../../../../../src/errors/UnexpectedError';
 import { $getTableName } from '../../../database/$getTableName';
 import { $provideSupabase } from '../../../database/$provideSupabase';
 import type { AgentsServerDatabase } from '../../../database/schema';
-import { $provideCdnForServer } from '../../../tools/$provideCdnForServer';
+import {
+    $provideCdnForServer,
+    isSelfContainedS3StorageSelected,
+    resolveCdnPublicUrlForServer,
+} from '../../../tools/$provideCdnForServer';
+import { $provideServer } from '../../../tools/$provideServer';
 import { getSafeCdnPath } from '../../../utils/cdn/utils/getSafeCdnPath';
 import { FILE_SECURITY_CHECKERS } from '../../../file-security-checkers';
 import { getUserIdFromRequest } from '../../../utils/getUserIdFromRequest';
 import { getMaxFileUploadSizeBytes } from '../../../utils/serverLimits';
+import { resolveFileUploadAvailability } from '../../../utils/upload/fileUploadAvailability';
 import { validateMimeType } from '../../../utils/validators/validateMimeType';
 
 /**
@@ -47,6 +54,13 @@ type ParsedUploadRequest = {
     contentType: string;
 };
 
+/**
+ * Server context returned by `$provideServer`.
+ *
+ * @private
+ */
+type ProvidedServer = Awaited<ReturnType<typeof $provideServer>>;
+
 /**
  * Normalizes upload purpose to a non-empty string.
  *
@@ -182,11 +196,33 @@ async function updateUploadedFileSecurityResult(
     }
 }
 
+/**
+ * Ensures the current server/domain can accept file uploads.
+ *
+ * @param providedServer - Current server routing context.
+ * @throws `NotAllowed` when uploads would be published without a server domain.
+ * @private
+ */
+function assertFileUploadAvailable(providedServer: ProvidedServer): void {
+    const fileUploadAvailability = resolveFileUploadAvailability({
+        serverId: providedServer.id,
+        serverPublicUrl: providedServer.publicUrl,
+        isSelfContainedS3StorageSelected: isSelfContainedS3StorageSelected(),
+    });
+
+    if (!fileUploadAvailability.isUploadAvailable) {
+        throw new NotAllowed(fileUploadAvailability.message || 'File uploads are not available for this server.');
+    }
+}
+
 /**
  * Handles file upload requests.
  */
 export async function POST(request: NextRequest) {
     try {
+        const providedServer = await $provideServer();
+        assertFileUploadAvailable(providedServer);
+
         const { file, pathname, purpose, contentType } = await parseUploadRequest(request);
         const fileBuffer = Buffer.from(await file.arrayBuffer());
         const maxFileSize = await getMaxFileUploadSizeBytes();
@@ -201,7 +237,9 @@ export async function POST(request: NextRequest) {
             );
         }
 
-        const cdn = $provideCdnForServer();
+        const cdn = $provideCdnForServer({
+            cdnPublicUrl: resolveCdnPublicUrlForServer(providedServer.publicUrl),
+        });
         const storageUrl = cdn.getItemUrl(pathname).href;
         const userId = await getUserIdFromRequest(request);
 
@@ -227,17 +265,15 @@ export async function POST(request: NextRequest) {
 
         console.error('Upload failed:', error);
 
-        return new Response(
-            JSON.stringify(
-                serializeError(error),
-                // <- TODO: [🐱‍🚀] Rename `serializeError` to `errorToJson`
-                null,
-                4,
-                // <- TODO: [🐱‍🚀] Allow to configure pretty print for agent server
-            ),
+        const serializedError = serializeError(error);
+
+        return NextResponse.json(
+            {
+                ...serializedError,
+                error: serializedError.message,
+            },
             {
-                status: 400, // <- TODO: [🐱‍🚀] Make `errorToHttpStatusCode`
-                headers: { 'Content-Type': 'application/json' },
+                status: error instanceof NotAllowed ? 403 : 400, // <- TODO: [🐱‍🚀] Make `errorToHttpStatusCode`
             },
         );
     }

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

@@ -16,6 +16,7 @@ import {
     SERVER_LANGUAGE_METADATA_KEY,
 } from '../languages/ServerLanguageRegistry';
 import { $provideServer } from '../tools/$provideServer';
+import { isSelfContainedS3StorageSelected } from '../tools/$provideCdnForServer';
 import { loadAgentOrganizationState } from '../utils/agentOrganization/loadAgentOrganizationState';
 import type { AgentOrganizationAgent, AgentOrganizationFolder } from '../utils/agentOrganization/types';
 import { getAgentNaming } from '../utils/getAgentNaming';
@@ -50,6 +51,7 @@ import {
     SHIBBOLETH_AUTHENTICATION_METADATA_KEYS,
     resolveShibbolethAuthenticationMenuStatus,
 } from '../constants/shibbolethAuth';
+import { resolveFileUploadAvailability } from '../utils/upload/fileUploadAvailability';
 import '@prisma/studio-core/ui/index.css';
 import './globals.css';
 
@@ -267,6 +269,7 @@ export default async function RootLayout({
     const currentUserPromise = getCurrentUser();
     const isAdminPromise = isUserAdmin();
     const isGlobalAdminPromise = isUserGlobalAdmin();
+    const providedServerPromise = $provideServer();
     const serverVisibilityPromise = getServerVisibility();
     const agentNamingPromise = getAgentNaming();
     const organizationStatePromise = isAdminPromise.then((isAdmin) =>
@@ -274,6 +277,13 @@ export default async function RootLayout({
     );
     const chatPreferencesPromise = getDefaultChatPreferences();
     const defaultIsNotificationsOnPromise = getDefaultIsNotificationsOn();
+    const fileUploadAvailabilityPromise = providedServerPromise.then((providedServer) =>
+        resolveFileUploadAvailability({
+            serverId: providedServer.id,
+            serverPublicUrl: providedServer.publicUrl,
+            isSelfContainedS3StorageSelected: isSelfContainedS3StorageSelected(),
+        }),
+    );
     const customStylesheetCssPromise = resolveOptionalLayoutText(
         'custom stylesheet CSS',
         getAggregatedCustomStylesheetCss,
@@ -340,6 +350,7 @@ export default async function RootLayout({
         federatedServers,
         footerLinks,
         serverVisibility,
+        fileUploadAvailability,
     ] = await Promise.all([
         isAdminPromise,
         isGlobalAdminPromise,
@@ -356,6 +367,7 @@ export default async function RootLayout({
         federatedServersPromise,
         footerLinksPromise,
         serverVisibilityPromise,
+        fileUploadAvailabilityPromise,
     ]);
 
     const serverName = layoutMetadata.SERVER_NAME || 'Promptbook Agents Server';
@@ -429,6 +441,7 @@ export default async function RootLayout({
                     defaultChatVisualMode={defaultChatVisualMode}
                     defaultAgentAvatarVisualId={defaultAgentAvatarVisualId}
                     webPushPublicKey={webPushPublicKey}
+                    fileUploadAvailability={fileUploadAvailability}
                 >
                     {children}
                 </LayoutWrapper>

package/apps/agents-server/src/components/FileUploadAvailability/FileUploadAvailabilityContext.tsx

@@ -0,0 +1,50 @@
+'use client';
+
+import { createContext, useContext, type ReactNode } from 'react';
+import {
+    AVAILABLE_FILE_UPLOAD,
+    type FileUploadAvailability,
+} from '../../utils/upload/fileUploadAvailability';
+
+/**
+ * Context carrying file upload availability for the current server/domain.
+ */
+const FileUploadAvailabilityContext = createContext<FileUploadAvailability>(AVAILABLE_FILE_UPLOAD);
+
+/**
+ * Props consumed by `FileUploadAvailabilityProvider`.
+ */
+type FileUploadAvailabilityProviderProps = {
+    /**
+     * Current upload availability state.
+     */
+    readonly value: FileUploadAvailability;
+
+    /**
+     * Nested app content.
+     */
+    readonly children: ReactNode;
+};
+
+/**
+ * Provides file upload availability to upload controls.
+ *
+ * @param props - Provider props.
+ * @returns Provider-wrapped children.
+ */
+export function FileUploadAvailabilityProvider(props: FileUploadAvailabilityProviderProps) {
+    return (
+        <FileUploadAvailabilityContext.Provider value={props.value}>
+            {props.children}
+        </FileUploadAvailabilityContext.Provider>
+    );
+}
+
+/**
+ * Reads the current file upload availability state.
+ *
+ * @returns Current upload availability state.
+ */
+export function useFileUploadAvailability(): FileUploadAvailability {
+    return useContext(FileUploadAvailabilityContext);
+}

package/apps/agents-server/src/components/FileUploadAvailability/FileUploadUnavailableNotice.tsx

@@ -0,0 +1,45 @@
+'use client';
+
+import { AlertTriangle } from 'lucide-react';
+import Link from 'next/link';
+import { useFileUploadAvailability } from './FileUploadAvailabilityContext';
+
+/**
+ * Props consumed by `FileUploadUnavailableNotice`.
+ */
+type FileUploadUnavailableNoticeProps = {
+    /**
+     * Optional classes appended to the notice root.
+     */
+    readonly className?: string;
+};
+
+/**
+ * Shows a shared notice when file uploads are disabled for the current server.
+ *
+ * @param props - Notice props.
+ * @returns Upload notice or `null` when uploads are available.
+ */
+export function FileUploadUnavailableNotice({ className }: FileUploadUnavailableNoticeProps) {
+    const fileUploadAvailability = useFileUploadAvailability();
+
+    if (fileUploadAvailability.isUploadAvailable || !fileUploadAvailability.message) {
+        return null;
+    }
+
+    return (
+        <div
+            className={`flex items-start gap-3 rounded-lg border border-amber-200 bg-amber-50 px-4 py-3 text-sm text-amber-900 ${
+                className || ''
+            }`}
+        >
+            <AlertTriangle className="mt-0.5 h-4 w-4 flex-shrink-0" aria-hidden="true" />
+            <div className="space-y-1">
+                <p className="font-medium">{fileUploadAvailability.message}</p>
+                <Link href="/admin/servers" className="inline-flex font-semibold underline underline-offset-2">
+                    Open server/domain settings
+                </Link>
+            </div>
+        </div>
+    );
+}

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

@@ -16,6 +16,7 @@ import { ChatVisualModeProvider } from '../ChatVisualMode/ChatVisualModeProvider
 import { ClientVersionMismatchListener } from '../ClientVersion/ClientVersionMismatchListener';
 import { ChatEnterBehaviorPreferencesProvider } from '../ChatEnterBehavior/ChatEnterBehaviorPreferencesProvider';
 import { HomepageOptimisticNavigation } from '../Homepage/HomepageOptimisticNavigation';
+import { FileUploadAvailabilityProvider } from '../FileUploadAvailability/FileUploadAvailabilityContext';
 import { Footer, type FooterLink } from '../Footer/Footer';
 import { Header } from '../Header/Header';
 import { MobileMenuHoistingProvider } from '../Header/MobileMenuHoistingContext';
@@ -30,6 +31,7 @@ import { SoundSystemProvider } from '../SoundSystemProvider/SoundSystemProvider'
 import { ThemeModeProvider } from '../ThemeMode/ThemeModeProvider';
 import { ViewportHeightController } from '../ViewportHeightController/ViewportHeightController';
 import type { ControlPanelOptionAvailability } from '../../utils/getControlPanelOptionAvailability';
+import type { FileUploadAvailability } from '../../utils/upload/fileUploadAvailability';
 
 /**
  * Props for layout wrapper.
@@ -73,6 +75,10 @@ type LayoutWrapperProps = {
     defaultChatVisualMode: string;
     defaultAgentAvatarVisualId: AvatarVisualId;
     webPushPublicKey: string | null;
+    /**
+     * Current file upload availability for the active server/domain.
+     */
+    fileUploadAvailability: FileUploadAvailability;
 };
 
 /**
@@ -105,6 +111,7 @@ export function LayoutWrapper({
     defaultChatVisualMode,
     defaultAgentAvatarVisualId,
     webPushPublicKey,
+    fileUploadAvailability,
 }: LayoutWrapperProps) {
     const pathname = usePathname();
     const searchParams = useSearchParams();
@@ -127,83 +134,85 @@ export function LayoutWrapper({
             defaultLanguage={defaultServerLanguage}
             isServerLanguageEnforced={isServerLanguageEnforced}
         >
-            <DefaultAgentAvatarVisualProvider defaultAgentAvatarVisualId={defaultAgentAvatarVisualId}>
-                <ThemeModeProvider defaultThemeMode={defaultThemeMode}>
-                    <ChatVisualModeProvider defaultChatVisualMode={defaultChatVisualMode}>
-                        <AsyncDialogsProvider>
-                            <AgentNamingProvider naming={agentNaming}>
-                                <LegacyUiAutoTranslator />
-                                <PrivateModePreferencesProvider>
-                                    <SelfLearningPreferencesProvider>
-                                        <SoundSystemProvider
-                                            initialIsSoundsOn={defaultIsSoundsOn}
-                                            initialIsVibrationOn={defaultIsVibrationOn}
-                                        >
-                                            <NotificationsProvider>
-                                                <BrowserPushNotificationsProvider
-                                                    defaultEnabled={defaultIsNotificationsOn}
-                                                    pushPublicKey={webPushPublicKey}
-                                                    isMetadataAvailable={controlPanelOptionAvailability.notifications}
-                                                >
-                                                    <ChatEnterBehaviorPreferencesProvider>
-                                                        <ClientVersionMismatchListener />
-                                                        <ViewportHeightController />
-                                                        <NavigationProgressBar />
-                                                        <MenuHoistingProvider>
-                                                            <MobileMenuHoistingProvider>
-                                                                <MetadataFlagsProvider
-                                                                    value={{
-                                                                        isExperimentalPwaAppEnabled,
-                                                                        controlPanelOptionAvailability,
-                                                                    }}
-                                                                >
-                                                                    {shouldRenderMinimalShell ? (
-                                                                        <main className={minimalMainClassName}>
-                                                                            {children}
-                                                                        </main>
-                                                                    ) : (
-                                                                        <div className="agents-server-app-shell flex flex-col">
-                                                                            <Header
-                                                                                isAdmin={isAdmin}
-                                                                                isGlobalAdmin={isGlobalAdmin}
-                                                                                currentUser={currentUser}
-                                                                                serverName={serverName}
-                                                                                serverLogoUrl={serverLogoUrl}
-                                                                                agents={agents}
-                                                                                agentFolders={agentFolders}
-                                                                                federatedServers={federatedServers}
-                                                                                isExperimental={isExperimental}
-                                                                                feedbackMode={feedbackMode}
-                                                                                shibbolethAuthenticationStatus={
-                                                                                    shibbolethAuthenticationStatus
-                                                                                }
-                                                                            />
-                                                                            <main className={mainClassName}>
-                                                                                <HomepageOptimisticNavigation
-                                                                                    pathname={pathname}
-                                                                                >
-                                                                                    {children}
-                                                                                </HomepageOptimisticNavigation>
+            <FileUploadAvailabilityProvider value={fileUploadAvailability}>
+                <DefaultAgentAvatarVisualProvider defaultAgentAvatarVisualId={defaultAgentAvatarVisualId}>
+                    <ThemeModeProvider defaultThemeMode={defaultThemeMode}>
+                        <ChatVisualModeProvider defaultChatVisualMode={defaultChatVisualMode}>
+                            <AsyncDialogsProvider>
+                                <AgentNamingProvider naming={agentNaming}>
+                                    <LegacyUiAutoTranslator />
+                                    <PrivateModePreferencesProvider>
+                                        <SelfLearningPreferencesProvider>
+                                            <SoundSystemProvider
+                                                initialIsSoundsOn={defaultIsSoundsOn}
+                                                initialIsVibrationOn={defaultIsVibrationOn}
+                                            >
+                                                <NotificationsProvider>
+                                                    <BrowserPushNotificationsProvider
+                                                        defaultEnabled={defaultIsNotificationsOn}
+                                                        pushPublicKey={webPushPublicKey}
+                                                        isMetadataAvailable={controlPanelOptionAvailability.notifications}
+                                                    >
+                                                        <ChatEnterBehaviorPreferencesProvider>
+                                                            <ClientVersionMismatchListener />
+                                                            <ViewportHeightController />
+                                                            <NavigationProgressBar />
+                                                            <MenuHoistingProvider>
+                                                                <MobileMenuHoistingProvider>
+                                                                    <MetadataFlagsProvider
+                                                                        value={{
+                                                                            isExperimentalPwaAppEnabled,
+                                                                            controlPanelOptionAvailability,
+                                                                        }}
+                                                                    >
+                                                                        {shouldRenderMinimalShell ? (
+                                                                            <main className={minimalMainClassName}>
+                                                                                {children}
                                                                             </main>
-                                                                            {isFooterShown && !isFooterHiddenOnPage && (
-                                                                                <Footer extraLinks={footerLinks} />
-                                                                            )}
-                                                                        </div>
-                                                                    )}
-                                                                </MetadataFlagsProvider>
-                                                            </MobileMenuHoistingProvider>
-                                                        </MenuHoistingProvider>
-                                                    </ChatEnterBehaviorPreferencesProvider>
-                                                </BrowserPushNotificationsProvider>
-                                            </NotificationsProvider>
-                                        </SoundSystemProvider>
-                                    </SelfLearningPreferencesProvider>
-                                </PrivateModePreferencesProvider>
-                            </AgentNamingProvider>
-                        </AsyncDialogsProvider>
-                    </ChatVisualModeProvider>
-                </ThemeModeProvider>
-            </DefaultAgentAvatarVisualProvider>
+                                                                        ) : (
+                                                                            <div className="agents-server-app-shell flex flex-col">
+                                                                                <Header
+                                                                                    isAdmin={isAdmin}
+                                                                                    isGlobalAdmin={isGlobalAdmin}
+                                                                                    currentUser={currentUser}
+                                                                                    serverName={serverName}
+                                                                                    serverLogoUrl={serverLogoUrl}
+                                                                                    agents={agents}
+                                                                                    agentFolders={agentFolders}
+                                                                                    federatedServers={federatedServers}
+                                                                                    isExperimental={isExperimental}
+                                                                                    feedbackMode={feedbackMode}
+                                                                                    shibbolethAuthenticationStatus={
+                                                                                        shibbolethAuthenticationStatus
+                                                                                    }
+                                                                                />
+                                                                                <main className={mainClassName}>
+                                                                                    <HomepageOptimisticNavigation
+                                                                                        pathname={pathname}
+                                                                                    >
+                                                                                        {children}
+                                                                                    </HomepageOptimisticNavigation>
+                                                                                </main>
+                                                                                {isFooterShown && !isFooterHiddenOnPage && (
+                                                                                    <Footer extraLinks={footerLinks} />
+                                                                                )}
+                                                                            </div>
+                                                                        )}
+                                                                    </MetadataFlagsProvider>
+                                                                </MobileMenuHoistingProvider>
+                                                            </MenuHoistingProvider>
+                                                        </ChatEnterBehaviorPreferencesProvider>
+                                                    </BrowserPushNotificationsProvider>
+                                                </NotificationsProvider>
+                                            </SoundSystemProvider>
+                                        </SelfLearningPreferencesProvider>
+                                    </PrivateModePreferencesProvider>
+                                </AgentNamingProvider>
+                            </AsyncDialogsProvider>
+                        </ChatVisualModeProvider>
+                    </ThemeModeProvider>
+                </DefaultAgentAvatarVisualProvider>
+            </FileUploadAvailabilityProvider>
         </ServerLanguageProvider>
     );
 }

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

@@ -6,6 +6,8 @@ import { useCallback, useState } from 'react';
 import { BookEditor } from '../../../../../src/book-components/BookEditor/BookEditor';
 import { bookEditorUploadHandler } from '../../utils/upload/createBookEditorUploadHandler';
 import { useAgentNaming } from '../AgentNaming/AgentNamingContext';
+import { FileUploadUnavailableNotice } from '../FileUploadAvailability/FileUploadUnavailableNotice';
+import { useFileUploadAvailability } from '../FileUploadAvailability/FileUploadAvailabilityContext';
 import { Dialog } from '../Portal/Dialog';
 import { useServerLanguage } from '../ServerLanguage/ServerLanguageProvider';
 import { usePromptbookTheme } from '../ThemeMode/usePromptbookTheme';
@@ -29,6 +31,7 @@ export function NewAgentDialog(props: NewAgentDialogProps) {
     const [isCreating, setIsCreating] = useState(false);
     const { formatText } = useAgentNaming();
     const { t } = useServerLanguage();
+    const fileUploadAvailability = useFileUploadAvailability();
     const { promptbookTheme } = usePromptbookTheme();
     const { requestClose } = useDirtyModalGuard({
         hasUnsavedChanges: agentSource !== initialAgentSource,
@@ -79,9 +82,10 @@ export function NewAgentDialog(props: NewAgentDialogProps) {
             </div>
 
             <div
-                className="relative flex-1 overflow-hidden bg-slate-50/60 p-4 dark:bg-slate-950/55" /* [✨🧬] onDragEnter={() => setIsInteracted(true)} */
+                className="relative flex flex-1 flex-col overflow-hidden bg-slate-50/60 p-4 dark:bg-slate-950/55" /* [✨🧬] onDragEnter={() => setIsInteracted(true)} */
             >
-                <div className="h-full overflow-hidden rounded-2xl border border-slate-200/80 shadow-inner dark:border-slate-800/80">
+                {!fileUploadAvailability.isUploadAvailable && <FileUploadUnavailableNotice className="mb-3" />}
+                <div className="min-h-0 flex-1 overflow-hidden rounded-2xl border border-slate-200/80 shadow-inner dark:border-slate-800/80">
                     <BookEditor
                         className="h-full w-full"
                         agentSource={agentSource}
@@ -92,7 +96,7 @@ export function NewAgentDialog(props: NewAgentDialogProps) {
                         height="100%"
                         isBorderRadiusDisabled
                         isVerbose={false}
-                        onFileUpload={bookEditorUploadHandler}
+                        onFileUpload={fileUploadAvailability.isUploadAvailable ? bookEditorUploadHandler : undefined}
                         theme={promptbookTheme}
                     />
                 </div>

package/apps/agents-server/src/components/NewAgentDialog/NewAgentWizardKnowledgeStep.tsx

@@ -1,5 +1,7 @@
 import { Upload } from 'lucide-react';
 import type { ChangeEvent, Dispatch, KeyboardEvent, RefObject, SetStateAction } from 'react';
+import { FileUploadUnavailableNotice } from '../FileUploadAvailability/FileUploadUnavailableNotice';
+import { useFileUploadAvailability } from '../FileUploadAvailability/FileUploadAvailabilityContext';
 import { NewAgentWizardClassNames } from './NewAgentWizardClassNames';
 import type { NewAgentWizardState } from './NewAgentWizardState';
 import type { NewAgentWizardTranslate } from './NewAgentWizardTranslate';
@@ -58,6 +60,7 @@ type NewAgentWizardKnowledgeStepProps = {
  * @private internal component of <NewAgentWizard/>.
  */
 export function NewAgentWizardKnowledgeStep(props: NewAgentWizardKnowledgeStepProps) {
+    const fileUploadAvailability = useFileUploadAvailability();
     const {
         state,
         setState,
@@ -80,18 +83,21 @@ export function NewAgentWizardKnowledgeStep(props: NewAgentWizardKnowledgeStepPr
                     <button
                         type="button"
                         onClick={() => fileInputRef.current?.click()}
+                        disabled={!fileUploadAvailability.isUploadAvailable}
                         className={NewAgentWizardClassNames.primaryButton}
                     >
                         <Upload className="h-4 w-4" />
                         {t('agentCreation.wizard.uploadAction')}
                     </button>
                 </div>
+                {!fileUploadAvailability.isUploadAvailable && <FileUploadUnavailableNotice className="mt-3" />}
                 <input
                     ref={fileInputRef}
                     type="file"
                     multiple
                     className="hidden"
                     onChange={handleKnowledgeFileSelection}
+                    disabled={!fileUploadAvailability.isUploadAvailable}
                 />
             </div>
 

package/apps/agents-server/src/components/NewAgentDialog/useNewAgentWizardKnowledgeState.ts

@@ -9,6 +9,7 @@ import {
     type KeyboardEvent,
     type SetStateAction,
 } from 'react';
+import { useFileUploadAvailability } from '../FileUploadAvailability/FileUploadAvailabilityContext';
 import { simplifyKnowledgeLabel } from '../../utils/knowledge/simplifyKnowledgeLabel';
 import { bookEditorUploadHandler } from '../../utils/upload/createBookEditorUploadHandler';
 import {
@@ -144,6 +145,7 @@ function updateKnowledgeItem(
  */
 export function useNewAgentWizardKnowledgeState(options: UseNewAgentWizardKnowledgeStateOptions) {
     const { state, setState, setStep, knowledgeStepIndex, t } = options;
+    const fileUploadAvailability = useFileUploadAvailability();
     const fileInputRef = useRef<HTMLInputElement | null>(null);
     const dragDepthRef = useRef(0);
     const [knowledgeFeedback, setKnowledgeFeedback] = useState<string | null>(null);
@@ -160,6 +162,11 @@ export function useNewAgentWizardKnowledgeState(options: UseNewAgentWizardKnowle
             return;
         }
 
+        if (!fileUploadAvailability.isUploadAvailable) {
+            setKnowledgeFeedback(fileUploadAvailability.message || t('agentCreation.wizard.uploadFailed'));
+            return;
+        }
+
         setKnowledgeFeedback(null);
 
         for (const file of files) {
@@ -297,7 +304,7 @@ export function useNewAgentWizardKnowledgeState(options: UseNewAgentWizardKnowle
         }
 
         event.preventDefault();
-        event.dataTransfer.dropEffect = 'copy';
+        event.dataTransfer.dropEffect = fileUploadAvailability.isUploadAvailable ? 'copy' : 'none';
         setIsDragOverDialog(true);
     }
 

package/apps/agents-server/src/constants/serverLimits.ts

@@ -32,6 +32,13 @@ export const DEFAULT_SPAWN_AGENT_RATE_LIMIT_MAX = 5;
  */
 export const DEFAULT_SPAWN_AGENT_RATE_LIMIT_WINDOW_MS = 10 * 60 * 1000;
 
+/**
+ * Default maximum number of failed local runner attempts before a queued message is moved to `messages/failed`.
+ *
+ * @private shared Agents Server constant
+ */
+export const DEFAULT_LOCAL_AGENT_RUNNER_MAX_FAILED_ATTEMPTS = 3;
+
 /**
  * Stable keys used by the dedicated server-limits table.
  *
@@ -45,6 +52,7 @@ export const SERVER_LIMIT_KEYS = {
     SPAWN_AGENT_MAX_DEPTH: 'SPAWN_AGENT_MAX_DEPTH',
     SPAWN_AGENT_RATE_LIMIT_MAX: 'SPAWN_AGENT_RATE_LIMIT_MAX',
     SPAWN_AGENT_RATE_LIMIT_WINDOW_MS: 'SPAWN_AGENT_RATE_LIMIT_WINDOW_MS',
+    LOCAL_AGENT_RUNNER_MAX_FAILED_ATTEMPTS: 'LOCAL_AGENT_RUNNER_MAX_FAILED_ATTEMPTS',
 } as const;
 
 /**
@@ -68,7 +76,7 @@ export type ServerLimitUnit = 'count' | 'MB' | 'ms';
  */
 export type ServerLimitDefinition = {
     readonly key: ServerLimitKey;
-    readonly category: 'Timeout tools' | 'Files' | 'Federation' | 'Agent spawning';
+    readonly category: 'Timeout tools' | 'Files' | 'Federation' | 'Agent spawning' | 'Local agent runner';
     readonly title: string;
     readonly description: string;
     readonly unit: ServerLimitUnit;
@@ -143,7 +151,8 @@ export const SERVER_LIMIT_DEFINITIONS = [
         key: SERVER_LIMIT_KEYS.SPAWN_AGENT_RATE_LIMIT_MAX,
         category: 'Agent spawning',
         title: 'Max spawned agents per window',
-        description: 'Limits how many persistent agents one actor can create through `spawn_agent` inside one rate-limit window.',
+        description:
+            'Limits how many persistent agents one actor can create through `spawn_agent` inside one rate-limit window.',
         unit: 'count',
         defaultValue: DEFAULT_SPAWN_AGENT_RATE_LIMIT_MAX,
         minimumValue: 1,
@@ -161,6 +170,17 @@ export const SERVER_LIMIT_DEFINITIONS = [
         step: 1_000,
         legacyMetadataKeys: [],
     },
+    {
+        key: SERVER_LIMIT_KEYS.LOCAL_AGENT_RUNNER_MAX_FAILED_ATTEMPTS,
+        category: 'Local agent runner',
+        title: 'Max failed message attempts',
+        description: 'Stops the local coding-agent watcher from retrying the same queued chat message forever.',
+        unit: 'count',
+        defaultValue: DEFAULT_LOCAL_AGENT_RUNNER_MAX_FAILED_ATTEMPTS,
+        minimumValue: 1,
+        step: 1,
+        legacyMetadataKeys: [],
+    },
 ] satisfies ReadonlyArray<ServerLimitDefinition>;
 
 /**