@promptbook/cli 0.112.0-91 → 0.112.0-93

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

@@ -30,7 +30,11 @@ import {
     DEFAULT_AGENT_AVATAR_VISUAL_METADATA_KEY,
     resolveDefaultAgentAvatarVisualId,
 } from '../constants/defaultAgentAvatarVisual';
-import { THEME_MODE_COOKIE_NAME, resolveThemeMode } from '../constants/themeMode';
+import {
+    DEFAULT_THEME_METADATA_KEY,
+    THEME_MODE_COOKIE_NAME,
+    resolveThemeMode,
+} from '../constants/themeMode';
 import { parseChatFeedbackMode } from '../utils/chatFeedbackMode';
 import { getFederatedServers } from '../utils/getFederatedServers';
 import { isUserAdmin } from '../utils/isUserAdmin';
@@ -249,6 +253,7 @@ export default async function RootLayout({
         'IS_EXPERIMENTAL_PWA_APP_ENABLED',
         CHAT_VISUAL_MODE_METADATA_KEY,
         DEFAULT_AGENT_AVATAR_VISUAL_METADATA_KEY,
+        DEFAULT_THEME_METADATA_KEY,
         SERVER_LANGUAGE_METADATA_KEY,
         IS_SERVER_LANGUAGE_ENFORCED_METADATA_KEY,
         ...CONTROL_PANEL_OPTION_AVAILABILITY_METADATA_KEYS,
@@ -272,19 +277,20 @@ export default async function RootLayout({
         getCustomJavascriptWithIntegrations,
     );
     const cookieStorePromise = cookies();
-    const defaultThemeModePromise = Promise.all([currentUserPromise, cookieStorePromise]).then(
-        async ([currentUser, cookieStore]) => {
+    const defaultThemeModePromise = Promise.all([currentUserPromise, cookieStorePromise, layoutMetadataPromise]).then(
+        async ([currentUser, cookieStore, layoutMetadata]) => {
             const cookieThemeMode = cookieStore.get(THEME_MODE_COOKIE_NAME)?.value || null;
+            const metadataDefaultThemeMode = resolveThemeMode(layoutMetadata[DEFAULT_THEME_METADATA_KEY]);
             if (cookieThemeMode) {
                 return resolveThemeMode(cookieThemeMode);
             }
 
             if (!currentUser?.id) {
-                return resolveThemeMode(null);
+                return metadataDefaultThemeMode;
             }
 
             const storedThemeSettings = await getUserThemeModeSettingsForUser(currentUser.id);
-            return storedThemeSettings?.themeMode || resolveThemeMode(null);
+            return storedThemeSettings?.themeMode || metadataDefaultThemeMode;
         },
     );
     const federatedServersPromise = Promise.all([layoutMetadataPromise, currentUserPromise]).then(

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

@@ -18,7 +18,33 @@ export type ThemeMode = (typeof THEME_MODES)[keyof typeof THEME_MODES];
 export type ResolvedThemeMode = Exclude<ThemeMode, 'SYSTEM'>;
 
 /**
- * Default theme mode applied when no user preference has been saved yet.
+ * Metadata key controlling the default theme mode for new browser sessions.
+ */
+export const DEFAULT_THEME_METADATA_KEY = 'DEFAULT_THEME';
+
+/**
+ * Shared select options for default theme configuration.
+ */
+export const THEME_MODE_OPTIONS: ReadonlyArray<{
+    readonly value: ThemeMode;
+    readonly label: string;
+}> = [
+    {
+        value: THEME_MODES.SYSTEM,
+        label: 'System',
+    },
+    {
+        value: THEME_MODES.LIGHT,
+        label: 'Light',
+    },
+    {
+        value: THEME_MODES.DARK,
+        label: 'Dark',
+    },
+] as const;
+
+/**
+ * Built-in fallback theme mode applied when metadata/browser values are missing or invalid.
  */
 export const DEFAULT_THEME_MODE: ThemeMode = THEME_MODES.SYSTEM;
 

package/apps/agents-server/src/database/$provideClientSql.ts

@@ -65,7 +65,7 @@ export async function $provideClientSql(): Promise<ClientSqlExecutor> {
     ): Promise<TRow> => {
         const textChunks: Array<string> = [];
         for (let index = 0; index < templateStrings.length; index++) {
-            textChunks.push(templateStrings[index]);
+            textChunks.push(templateStrings[index]!);
             if (index < templateValues.length) {
                 textChunks.push(`$${index + 1}`);
             }

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

@@ -13,6 +13,7 @@ import {
     DEFAULT_AGENT_AVATAR_VISUAL_METADATA_OPTIONS,
     DEFAULT_AGENT_AVATAR_VISUAL_METADATA_VALUE,
 } from '../constants/defaultAgentAvatarVisual';
+import { DEFAULT_THEME_METADATA_KEY, DEFAULT_THEME_MODE, THEME_MODE_OPTIONS } from '../constants/themeMode';
 import { DEFAULT_NAME_POOL, NAME_POOL_METADATA_KEY, NAME_POOL_OPTIONS } from '../constants/namePool';
 import { NEW_AGENT_WIZZARD_METADATA_KEY, NEW_AGENT_WIZZARD_OPTIONS } from '../constants/newAgentWizard';
 import {
@@ -336,6 +337,15 @@ export const metadataDefaults = [
         note: 'Default state for browser push notifications when a user has no saved preference. When false, users must opt in before agent replies can trigger notifications.',
         type: 'BOOLEAN',
     },
+    {
+        key: DEFAULT_THEME_METADATA_KEY,
+        value: DEFAULT_THEME_MODE,
+        note: `Default theme mode for browsers without a saved preference. Allowed values: ${formatMetadataOptionValues(
+            THEME_MODE_OPTIONS,
+        )}.`,
+        type: 'TEXT_SINGLE_LINE',
+        options: THEME_MODE_OPTIONS,
+    },
     {
         key: CHAT_VISUAL_MODE_METADATA_KEY,
         value: DEFAULT_CHAT_VISUAL_MODE,

package/apps/agents-server/src/database/migrations/2026-05-2600-default-theme.sql

@@ -0,0 +1,16 @@
+INSERT INTO "prefix_Metadata" ("key", "value", "note", "createdAt", "updatedAt")
+SELECT 'DEFAULT_THEME',
+       'SYSTEM',
+       'Default theme mode for browsers without a saved preference. Allowed values: SYSTEM, LIGHT, DARK.',
+       NOW(),
+       NOW()
+WHERE NOT EXISTS (SELECT 1 FROM "prefix_Metadata" WHERE "key" = 'DEFAULT_THEME');
+
+UPDATE "prefix_Metadata"
+SET "value" = CASE
+                  WHEN UPPER(COALESCE("value", '')) IN ('SYSTEM', 'LIGHT', 'DARK') THEN UPPER("value")
+                  ELSE 'SYSTEM'
+              END,
+    "note" = 'Default theme mode for browsers without a saved preference. Allowed values: SYSTEM, LIGHT, DARK.',
+    "updatedAt" = NOW()
+WHERE "key" = 'DEFAULT_THEME';

package/apps/agents-server/src/utils/externalChatRunner/createExternalAgentRepositoryFiles.ts

@@ -53,9 +53,9 @@ function createExternalAgentRepositoryPackageJson(): string {
             scripts: {
                 start: 'npm run agent:run',
                 'agent:run':
-                    'npx ptbk agent run-agent --agent github-copilot --model gpt-5.4 --thinking-level high --auto-pull --auto-push',
+                    'npx ptbk agent-folder run-agent --agent github-copilot --model gpt-5.4 --thinking-level high --auto-pull --auto-push',
                 'agent-local:run':
-                    'ts-node  ../../promptbook/src/cli/test/ptbk.ts agent run-agent --agent github-copilot --model gpt-5.4 --auto-pull --auto-push',
+                    'ts-node  ../../promptbook/src/cli/test/ptbk.ts agent-folder run-agent --agent github-copilot --model gpt-5.4 --auto-pull --auto-push',
             },
         },
         null,