@promptbook/cli 0.112.0-111 → 0.112.0-112

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

@@ -203,6 +203,22 @@ function CreateServerForm(props: {
                 ) : null}
             </div>
 
+            <div className="rounded-lg border border-gray-200 bg-gray-50 p-4 text-sm text-gray-600">
+                <label htmlFor="create-server-default-agents" className="flex items-start gap-3">
+                    <input
+                        id="create-server-default-agents"
+                        type="checkbox"
+                        checked={wizardState.isDefaultAgentsInstalled}
+                        onChange={(event) => updateWizardField('isDefaultAgentsInstalled', event.target.checked)}
+                        className="mt-0.5 h-4 w-4 rounded border-gray-300 text-blue-600 focus:ring-blue-500"
+                    />
+                    <span>
+                        <span className="block font-semibold text-gray-900">Install default agents</span>
+                        <span className="mt-1 block">Create bundled starter agents from agents/default.</span>
+                    </span>
+                </label>
+            </div>
+
             <div className="rounded-lg border border-gray-200 bg-gray-50 p-4 text-sm text-gray-600">
                 <p className="font-semibold text-gray-900">Admin user exists</p>
                 <p className="mt-1">

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

@@ -121,6 +121,11 @@ export type CreateServerWizardState = {
      */
     additionalUsers: WizardUser[];
 
+    /**
+     * Whether bundled default agents should be installed during server creation.
+     */
+    isDefaultAgentsInstalled: boolean;
+
     /**
      * Initial metadata values.
      */
@@ -155,7 +160,10 @@ export type CreateServerWizardError = {
  * @private function of <ServersClient/>
  */
 export type UpdateCreateServerWizardField = <
-    TFieldName extends keyof Pick<CreateServerWizardState, 'name' | 'domain' | 'iconUrl'>,
+    TFieldName extends keyof Pick<
+        CreateServerWizardState,
+        'name' | 'domain' | 'iconUrl' | 'isDefaultAgentsInstalled'
+    >,
 >(
     fieldName: TFieldName,
     value: CreateServerWizardState[TFieldName],
@@ -262,6 +270,7 @@ function createInitialWizardState(): CreateServerWizardState {
             password: '',
         },
         additionalUsers: [],
+        isDefaultAgentsInstalled: true,
         initialSettings: {
             language: 'en',
             homepageMessage: '',
@@ -345,7 +354,8 @@ function hasCreateServerWizardChanges(wizardState: CreateServerWizardState): boo
         wizardState.name !== initialWizardState.name ||
         wizardState.identifier !== initialWizardState.identifier ||
         wizardState.domain !== initialWizardState.domain ||
-        wizardState.iconUrl !== initialWizardState.iconUrl
+        wizardState.iconUrl !== initialWizardState.iconUrl ||
+        wizardState.isDefaultAgentsInstalled !== initialWizardState.isDefaultAgentsInstalled
     );
 }
 
@@ -402,16 +412,32 @@ export function useCreateServerWizard(options: UseCreateServerWizardOptions): Us
     const updateWizardField = useCallback<UpdateCreateServerWizardField>((fieldName, value) => {
         setWizardState((previous) => {
             if (fieldName === 'name') {
+                const name = value as CreateServerWizardState['name'];
+
+                return {
+                    ...previous,
+                    name,
+                    identifier: createServerIdentifierFromName(name),
+                };
+            }
+
+            if (fieldName === 'domain') {
+                return {
+                    ...previous,
+                    domain: value as CreateServerWizardState['domain'],
+                };
+            }
+
+            if (fieldName === 'iconUrl') {
                 return {
                     ...previous,
-                    name: value,
-                    identifier: createServerIdentifierFromName(value),
+                    iconUrl: value as CreateServerWizardState['iconUrl'],
                 };
             }
 
             return {
                 ...previous,
-                [fieldName]: value,
+                isDefaultAgentsInstalled: value as CreateServerWizardState['isDefaultAgentsInstalled'],
             };
         });
     }, []);

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

@@ -2,6 +2,7 @@ import { NextResponse } from 'next/server';
 import { spaceTrim } from 'spacetrim';
 import { DatabaseError } from '../../../../../../../src/errors/DatabaseError';
 import { isAgentsServerSqliteMode } from '../../../../database/agentsServerDatabaseMode';
+import { seedDefaultAgents } from '../../../../database/seedDefaultAgents';
 import { resolveCurrentServerRegistryContext } from '../../../../utils/currentServerRegistryContext';
 import { isUserAdmin } from '../../../../utils/isUserAdmin';
 import { isUserGlobalAdmin } from '../../../../utils/isUserGlobalAdmin';
@@ -97,6 +98,7 @@ export async function POST(request: Request) {
 
         const body = withEnvironmentAdminUser((await request.json()) as CreateServerInput);
         if (isAgentsServerSqliteMode()) {
+            const isDefaultAgentsInstalled = body.isDefaultAgentsInstalled !== false;
             const normalizedDomain = normalizeServerDomain(body.domain);
             if (!normalizedDomain) {
                 return NextResponse.json({ error: 'A valid domain is required.' }, { status: 400 });
@@ -114,6 +116,9 @@ export async function POST(request: Request) {
                     iconUrl: body.iconUrl,
                 });
             }
+            if (isDefaultAgentsInstalled) {
+                await seedDefaultAgents({ tablePrefix });
+            }
 
             return NextResponse.json(
                 {

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

@@ -2,6 +2,7 @@ import { NextRequest, NextResponse } from 'next/server';
 import { keepUnused } from '../../../../../../src/utils/organization/keepUnused';
 import { $getTableName } from '../../../database/$getTableName';
 import { $provideSupabase } from '../../../database/$provideSupabase';
+import { invalidateMetadataCache } from '../../../database/getMetadata';
 import { validateMetadataValue } from '../../../database/metadataDefaults';
 import { isUserAdmin } from '../../../utils/isUserAdmin';
 
@@ -121,6 +122,7 @@ export async function POST(request: NextRequest) {
         return NextResponse.json({ error: error.message }, { status: 500 });
     }
 
+    invalidateMetadataCache();
     return NextResponse.json(data);
 }
 
@@ -152,6 +154,7 @@ export async function PUT(request: NextRequest) {
         return NextResponse.json({ error: error.message }, { status: 500 });
     }
 
+    invalidateMetadataCache();
     return NextResponse.json(data);
 }
 
@@ -179,5 +182,6 @@ export async function DELETE(request: NextRequest) {
         return NextResponse.json({ error: error.message }, { status: 500 });
     }
 
+    invalidateMetadataCache();
     return NextResponse.json({ success: true });
 }

package/apps/agents-server/src/database/customJavascript.ts

@@ -14,6 +14,13 @@ export const MAX_CUSTOM_JAVASCRIPT_LENGTH = 100_000;
  */
 const CUSTOM_JAVASCRIPT_TABLE_BASENAME = 'CustomJavascript';
 
+/**
+ * Process-level cache lifetime for custom JavaScript rows.
+ *
+ * @private
+ */
+const CUSTOM_JAVASCRIPT_CACHE_TTL_MS = 30_000;
+
 /**
  * Stored `CustomJavascript` row shape.
  *
@@ -90,6 +97,28 @@ type DynamicSupabaseClient = {
     from: (tableName: string) => DynamicCustomJavascriptTableQuery;
 };
 
+/**
+ * Cached custom JavaScript rows keyed by the resolved table name.
+ *
+ * @private
+ */
+const cachedCustomJavascriptByTableName = new Map<
+    string,
+    {
+        readonly loadedAt: number;
+        readonly rowsPromise: Promise<CustomJavascriptRow[]>;
+    }
+>();
+
+/**
+ * Clears process-level custom JavaScript cache after admin writes.
+ *
+ * @private
+ */
+export function invalidateCustomJavascriptCache(): void {
+    cachedCustomJavascriptByTableName.clear();
+}
+
 /**
  * Resolves the prefixed table name for `CustomJavascript`.
  *
@@ -137,8 +166,37 @@ function getCustomJavascriptClient() {
  */
 export async function getCustomJavascriptFiles(): Promise<CustomJavascriptRow[]> {
     const table = await getCustomJavascriptTableName();
-    const supabase = getCustomJavascriptClient();
+    const cachedJavascript = cachedCustomJavascriptByTableName.get(table);
+    if (cachedJavascript && Date.now() - cachedJavascript.loadedAt < CUSTOM_JAVASCRIPT_CACHE_TTL_MS) {
+        return cachedJavascript.rowsPromise;
+    }
+
+    const rowsPromise = loadCustomJavascriptFilesFromDatabase(table);
+    cachedCustomJavascriptByTableName.set(table, {
+        loadedAt: Date.now(),
+        rowsPromise,
+    });
+
+    try {
+        return await rowsPromise;
+    } catch (error) {
+        if (cachedCustomJavascriptByTableName.get(table)?.rowsPromise === rowsPromise) {
+            cachedCustomJavascriptByTableName.delete(table);
+        }
+        throw error;
+    }
+}
 
+/**
+ * Reads custom JavaScript rows from the database.
+ *
+ * @param table - Resolved CustomJavascript table name.
+ * @returns Stored JavaScript rows.
+ *
+ * @private
+ */
+async function loadCustomJavascriptFilesFromDatabase(table: string): Promise<CustomJavascriptRow[]> {
+    const supabase = getCustomJavascriptClient();
     const { data, error } = await supabase.from(table).select('*').order('scope', { ascending: true });
 
     if (error) {
@@ -234,6 +292,7 @@ export async function saveCustomJavascriptFile({
         throw new Error(`Failed to save custom JavaScript: ${error.message || String(error)}`);
     }
 
+    invalidateCustomJavascriptCache();
     return data as CustomJavascriptRow;
 }
 
@@ -255,4 +314,6 @@ export async function deleteCustomJavascriptFile(id: number): Promise<void> {
 
         throw new Error(`Failed to delete custom JavaScript: ${error.message || String(error)}`);
     }
+
+    invalidateCustomJavascriptCache();
 }

package/apps/agents-server/src/database/customStylesheet.ts

@@ -7,6 +7,11 @@ import { $provideSupabase } from './$provideSupabase';
  */
 const CUSTOM_STYLESHEET_TABLE_BASENAME = 'CustomStylesheet';
 
+/**
+ * Process-level cache lifetime for custom stylesheet rows.
+ */
+const CUSTOM_STYLESHEET_CACHE_TTL_MS = 30_000;
+
 /**
  * Stored CustomStylesheet row shape.
  *
@@ -82,6 +87,28 @@ type DynamicSupabaseClient = {
     from: (tableName: string) => DynamicCustomStylesheetTableQuery;
 };
 
+/**
+ * Cached custom stylesheet rows keyed by the resolved table name.
+ *
+ * @private
+ */
+const cachedCustomStylesheetsByTableName = new Map<
+    string,
+    {
+        readonly loadedAt: number;
+        readonly rowsPromise: Promise<CustomStylesheetRow[]>;
+    }
+>();
+
+/**
+ * Clears process-level stylesheet cache after admin writes.
+ *
+ * @public
+ */
+export function invalidateCustomStylesheetCache(): void {
+    cachedCustomStylesheetsByTableName.clear();
+}
+
 /**
  * Resolves the prefixed table name for CustomStylesheet.
  *
@@ -127,8 +154,37 @@ function getCustomStylesheetClient(): DynamicSupabaseClient {
  */
 export async function listCustomStylesheets(): Promise<CustomStylesheetRow[]> {
     const table = await getCustomStylesheetTableName();
-    const supabase = getCustomStylesheetClient();
+    const cachedStylesheets = cachedCustomStylesheetsByTableName.get(table);
+    if (cachedStylesheets && Date.now() - cachedStylesheets.loadedAt < CUSTOM_STYLESHEET_CACHE_TTL_MS) {
+        return cachedStylesheets.rowsPromise;
+    }
+
+    const rowsPromise = loadCustomStylesheetsFromDatabase(table);
+    cachedCustomStylesheetsByTableName.set(table, {
+        loadedAt: Date.now(),
+        rowsPromise,
+    });
+
+    try {
+        return await rowsPromise;
+    } catch (error) {
+        if (cachedCustomStylesheetsByTableName.get(table)?.rowsPromise === rowsPromise) {
+            cachedCustomStylesheetsByTableName.delete(table);
+        }
+        throw error;
+    }
+}
 
+/**
+ * Reads custom stylesheet rows from the database.
+ *
+ * @param table - Resolved CustomStylesheet table name.
+ * @returns Stored stylesheet rows.
+ *
+ * @private
+ */
+async function loadCustomStylesheetsFromDatabase(table: string): Promise<CustomStylesheetRow[]> {
+    const supabase = getCustomStylesheetClient();
     const { data, error } = await supabase.from(table).select('*').order('createdAt', { ascending: true });
 
     if (error) {
@@ -206,6 +262,7 @@ export async function saveCustomStylesheetFile({
         throw new Error(`Failed to save custom stylesheet: ${error.message || String(error)}`);
     }
 
+    invalidateCustomStylesheetCache();
     return data as CustomStylesheetRow;
 }
 
@@ -229,4 +286,6 @@ export async function deleteCustomStylesheetFile(id: number): Promise<void> {
 
         throw new Error(`Failed to delete custom stylesheet: ${error.message || String(error)}`);
     }
+
+    invalidateCustomStylesheetCache();
 }

package/apps/agents-server/src/database/getMetadata.ts

@@ -10,6 +10,45 @@ import { cache } from 'react';
  */
 const metadataDefaultsMap = new Map<string, string>(metadataDefaults.map((metadata) => [metadata.key, metadata.value]));
 
+/**
+ * Process-level cache lifetime for metadata reads.
+ *
+ * @private Internal helper for metadata lookups in `apps/agents-server`.
+ */
+const METADATA_CACHE_TTL_MS = 30_000;
+
+/**
+ * Cached metadata table payload keyed by the resolved table name.
+ *
+ * @private Internal helper for metadata lookups in `apps/agents-server`.
+ */
+const cachedMetadataValuesByTableName = new Map<
+    string,
+    {
+        readonly loadedAt: number;
+        readonly valuesPromise: Promise<Map<string, string | null>>;
+    }
+>();
+
+/**
+ * Metadata row shape loaded by the lightweight metadata select.
+ *
+ * @private Internal helper for metadata lookups in `apps/agents-server`.
+ */
+type MetadataValueRow = {
+    readonly key: string;
+    readonly value: string | null;
+};
+
+/**
+ * Clears process-level metadata cache after admin metadata writes.
+ *
+ * @public exported from `apps/agents-server`
+ */
+export function invalidateMetadataCache(): void {
+    cachedMetadataValuesByTableName.clear();
+}
+
 /**
  * Loads the full metadata table once per request so callers can cheaply project subsets.
  *
@@ -18,17 +57,59 @@ const metadataDefaultsMap = new Map<string, string>(metadataDefaults.map((metada
  * @private Internal helper for batched metadata lookups in `apps/agents-server`.
  */
 const loadAllMetadataValues = cache(async (): Promise<Map<string, string | null>> => {
-    const supabase = $provideSupabase();
     const table = await $getTableName('Metadata');
+    return loadCachedMetadataValues(table);
+});
+
+/**
+ * Loads metadata values using a short process-level cache shared by consecutive requests.
+ *
+ * @param table - Resolved metadata table name.
+ * @returns Metadata values keyed by metadata key.
+ *
+ * @private Internal helper for metadata lookups in `apps/agents-server`.
+ */
+async function loadCachedMetadataValues(table: string): Promise<Map<string, string | null>> {
+    const cachedMetadataValues = cachedMetadataValuesByTableName.get(table);
+    if (cachedMetadataValues && Date.now() - cachedMetadataValues.loadedAt < METADATA_CACHE_TTL_MS) {
+        return cachedMetadataValues.valuesPromise;
+    }
+
+    const valuesPromise = loadMetadataValuesFromDatabase(table);
+    cachedMetadataValuesByTableName.set(table, {
+        loadedAt: Date.now(),
+        valuesPromise,
+    });
+
+    try {
+        return await valuesPromise;
+    } catch (error) {
+        if (cachedMetadataValuesByTableName.get(table)?.valuesPromise === valuesPromise) {
+            cachedMetadataValuesByTableName.delete(table);
+        }
+        throw error;
+    }
+}
+
+/**
+ * Reads all persisted metadata values from the database.
+ *
+ * @param table - Resolved metadata table name.
+ * @returns Metadata values keyed by metadata key.
+ *
+ * @private Internal helper for metadata lookups in `apps/agents-server`.
+ */
+async function loadMetadataValuesFromDatabase(table: string): Promise<Map<string, string | null>> {
+    const supabase = $provideSupabase();
     const { data } = await supabase.from(table).select('key, value');
 
     const loadedMap = new Map<string, string | null>();
-    for (const row of data ?? []) {
+    for (const row of (data ?? []) as Array<MetadataValueRow>) {
         loadedMap.set(row.key, row.value);
     }
 
     return loadedMap;
-});
+}
 
 /**
  * Get metadata value by key

package/apps/agents-server/src/instrumentation.ts

@@ -10,6 +10,9 @@ export async function register(): Promise<void> {
     }
 
     try {
+        const { registerServerErrorSentryLogging } = await import('./utils/errorReporting/registerServerErrorSentryLogging');
+        registerServerErrorSentryLogging();
+
         const { registerNodeRuntimeInstrumentation } = await import('./instrumentation-node');
         await registerNodeRuntimeInstrumentation();
     } catch (error) {