@promptbook/cli 0.112.0-111 → 0.112.0-112

package/apps/agents-server/src/utils/serverManagement/createManagedServer/normalizeCreateServerInput.ts

@@ -51,6 +51,11 @@ export type NormalizedCreateServerInput = {
      * Initial metadata rows inserted during bootstrap.
      */
     readonly metadataEntries: ReadonlyArray<ServerMetadataSeedEntry>;
+
+    /**
+     * Whether bundled default agents from `agents/default` should be created during bootstrap.
+     */
+    readonly isDefaultAgentsInstalled: boolean;
 };
 
 /**
@@ -103,5 +108,6 @@ export function normalizeCreateServerInput(input: CreateServerInput): Normalized
             iconUrl,
             initialSettings: input.initialSettings,
         }),
+        isDefaultAgentsInstalled: input.isDefaultAgentsInstalled !== false,
     };
 }

package/apps/agents-server/src/utils/serverManagement/createManagedServer/seedServerDefaultAgents.ts

@@ -1,5 +1,6 @@
 import { createAgentPersistenceRecords } from '../../../../../../src/collection/agent-collection/constructors/agent-collection-in-supabase/createAgentPersistenceRecords';
 import type { Client } from 'pg';
+import { DEFAULT_AGENT_VISIBILITY } from '../../agentVisibility';
 import { loadDefaultAgentBooks } from '../../defaultAgents/loadDefaultAgentBooks';
 import { createInsertStatement, quoteIdentifier, type SqlRecorder } from './createSqlRecorder';
 import type { NormalizedCreateServerInput } from './normalizeCreateServerInput';
@@ -28,7 +29,7 @@ export async function seedServerDefaultAgents(
         const createdAt = new Date().toISOString();
         const { agentInsertRecord, agentHistoryInsertRecord } = createAgentPersistenceRecords(
             defaultAgentBook,
-            { sortOrder: index },
+            { sortOrder: index, visibility: DEFAULT_AGENT_VISIBILITY },
             createdAt,
         );
 
@@ -45,9 +46,10 @@ export async function seedServerDefaultAgents(
                     "promptbookEngineVersion",
                     "usage",
                     "folderId",
-                    "sortOrder"
+                    "sortOrder",
+                    "visibility"
                 )
-                VALUES ($1, $2, $3, $4, $5, $6, $7::jsonb, $8, $9::jsonb, $10, $11)
+                VALUES ($1, $2, $3, $4, $5, $6, $7::jsonb, $8, $9::jsonb, $10, $11, $12)
             `,
             [
                 agentInsertRecord.agentName,
@@ -61,6 +63,7 @@ export async function seedServerDefaultAgents(
                 JSON.stringify(agentInsertRecord.usage),
                 agentInsertRecord.folderId ?? null,
                 agentInsertRecord.sortOrder ?? index,
+                agentInsertRecord.visibility ?? DEFAULT_AGENT_VISIBILITY,
             ],
         );
         sqlRecorder.addStatement(
@@ -70,6 +73,7 @@ export async function seedServerDefaultAgents(
                 usage: JSON.stringify(agentInsertRecord.usage),
                 folderId: agentInsertRecord.folderId ?? null,
                 sortOrder: agentInsertRecord.sortOrder ?? index,
+                visibility: agentInsertRecord.visibility ?? DEFAULT_AGENT_VISIBILITY,
             }),
         );
 

package/apps/agents-server/src/utils/serverManagement/createManagedServer.ts

@@ -108,6 +108,11 @@ export type CreateServerInput = {
      */
     readonly additionalUsers?: ReadonlyArray<ServerSeedUserInput>;
 
+    /**
+     * Whether bundled default agents from `agents/default` should be created during bootstrap.
+     */
+    readonly isDefaultAgentsInstalled?: boolean;
+
     /**
      * Initial metadata values for the new server.
      */

package/apps/agents-server/src/utils/userChat/listUserChats.ts

@@ -1,5 +1,7 @@
 import { $getTableName } from '@/src/database/$getTableName';
 import { $provideClientSql } from '@/src/database/$provideClientSql';
+import { isAgentsServerSqliteMode } from '@/src/database/agentsServerDatabaseMode';
+import { $provideAgentsServerSqliteDatabase } from '@/src/database/sqlite/$provideAgentsServerSqliteDatabase';
 import type { ListUserChatsOptions, UserChatRecord } from './UserChatRecord';
 import type { UserChatSource } from './UserChatSource';
 import type { UserChatRow } from './UserChatRow';
@@ -30,6 +32,13 @@ const POSTGRES_UNDEFINED_COLUMN_ERROR_CODE = '42703';
 const CLIENT_SQL_MISSING_CONNECTION_MESSAGE_FRAGMENT =
     'Environment variable `POSTGRES_URL` or `DATABASE_URL` must be defined.';
 
+/**
+ * SQLite expression that safely exposes chat messages as a JSON array.
+ *
+ * @private function of `userChat`
+ */
+const SQLITE_CHAT_MESSAGES_JSON_EXPRESSION = `CASE WHEN json_valid(chat."messages") THEN chat."messages" ELSE '[]' END`;
+
 /**
  * Lists all user chats for one agent ordered by last activity.
  */
@@ -69,6 +78,10 @@ export async function listUserChats(options: ListUserChatsOptions): Promise<Arra
  * @private function of `userChat`
  */
 export async function listUserChatSummarySeeds(options: ListUserChatsOptions): Promise<Array<UserChatSummarySeed>> {
+    if (isAgentsServerSqliteMode()) {
+        return listUserChatSummarySeedsViaSqlite(options);
+    }
+
     if (!isDirectSqlConnectionConfigured()) {
         return listUserChatSummarySeedsViaSupabase(options);
     }
@@ -151,6 +164,92 @@ export async function listUserChatSummarySeeds(options: ListUserChatsOptions): P
     }
 }
 
+/**
+ * Lists lightweight chat-summary seeds through direct SQLite JSON queries.
+ *
+ * @private function of `userChat`
+ */
+async function listUserChatSummarySeedsViaSqlite(options: ListUserChatsOptions): Promise<Array<UserChatSummarySeed>> {
+    const userChatTableName = quoteIdentifier(await $getTableName('UserChat'));
+    const shouldLoadExternalChats = options.viewerIsAdmin && options.includeExternalChats;
+    const whereClause = shouldLoadExternalChats
+        ? `
+            chat."agentPermanentId" = ?
+            AND (chat."source" <> ? OR chat."userId" = ?)
+        `
+        : `
+            chat."userId" = ?
+            AND chat."agentPermanentId" = ?
+            AND chat."source" = ?
+        `;
+    const queryValues = shouldLoadExternalChats
+        ? [options.agentPermanentId, USER_CHAT_SOURCES.WEB_UI, options.userId]
+        : [options.userId, options.agentPermanentId, USER_CHAT_SOURCES.WEB_UI];
+
+    try {
+        const database = $provideAgentsServerSqliteDatabase();
+        const summaryRows = database
+            .prepare(
+                `
+                    SELECT
+                        chat."id",
+                        chat."createdAt",
+                        chat."updatedAt",
+                        chat."lastMessageAt",
+                        chat."title",
+                        chat."source",
+                        COALESCE(json_array_length(${SQLITE_CHAT_MESSAGES_JSON_EXPRESSION}), 0) AS "messagesCount",
+                        COALESCE(
+                            (
+                                SELECT CAST(json_extract(message.value, '$.content') AS TEXT)
+                                FROM json_each(${SQLITE_CHAT_MESSAGES_JSON_EXPRESSION}) AS message
+                                WHERE UPPER(CAST(COALESCE(json_extract(message.value, '$.sender'), '') AS TEXT)) = 'USER'
+                                ORDER BY CAST(message.key AS INTEGER) ASC
+                                LIMIT 1
+                            ),
+                            ''
+                        ) AS "firstUserMessageContent",
+                        COALESCE(
+                            (
+                                SELECT CAST(json_extract(message.value, '$.content') AS TEXT)
+                                FROM json_each(${SQLITE_CHAT_MESSAGES_JSON_EXPRESSION}) AS message
+                                WHERE LENGTH(TRIM(CAST(COALESCE(json_extract(message.value, '$.content'), '') AS TEXT))) > 0
+                                ORDER BY CAST(message.key AS INTEGER) DESC
+                                LIMIT 1
+                            ),
+                            ''
+                        ) AS "lastPreviewMessageContent",
+                        COALESCE(
+                            (
+                                SELECT COUNT(*)
+                                FROM json_each(${SQLITE_CHAT_MESSAGES_JSON_EXPRESSION}) AS message
+                                WHERE
+                                    UPPER(CAST(COALESCE(json_extract(message.value, '$.sender'), '') AS TEXT)) IN ('AGENT', 'MODEL')
+                                    AND (
+                                        json_extract(message.value, '$.isComplete') = 0
+                                        OR LOWER(CAST(COALESCE(json_extract(message.value, '$.isComplete'), '') AS TEXT)) = 'false'
+                                        OR LOWER(CAST(COALESCE(json_extract(message.value, '$.lifecycleState'), '') AS TEXT)) IN ('queued', 'running')
+                                    )
+                            ),
+                            0
+                        ) AS "pendingAssistantMessageCount"
+                    FROM ${userChatTableName} AS chat
+                    WHERE ${whereClause}
+                    ORDER BY chat."lastMessageAt" IS NULL ASC, chat."lastMessageAt" DESC, chat."updatedAt" DESC
+                `,
+            )
+            .all(...queryValues) as Array<UserChatSummarySeedSqlRow>;
+
+        return summaryRows.map(mapUserChatSummarySeedSqlRow);
+    } catch (error) {
+        if (!isUserChatSummarySeedSqliteFallbackError(error)) {
+            throw error;
+        }
+
+        return listUserChatSummarySeedsViaSupabase(options);
+    }
+}
+
 /**
  * Raw SQL row shape loaded for lightweight chat summary seeds.
  *
@@ -260,6 +359,16 @@ function isUserChatSummarySeedSqlFallbackError(error: unknown): boolean {
     return /relation .* does not exist|column .* does not exist/i.test(errorMessage);
 }
 
+/**
+ * Returns true when SQLite summary optimization should gracefully fallback to Supabase-shaped reads.
+ *
+ * @private function of `userChat`
+ */
+function isUserChatSummarySeedSqliteFallbackError(error: unknown): boolean {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    return /no such table|no such column|no such function: json_|malformed JSON/i.test(errorMessage);
+}
+
 /**
  * Loads chat-summary seeds using standard Supabase reads when SQL optimization is unavailable.
  *

package/esm/index.es.js

@@ -58,7 +58,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-111';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-112';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -34202,7 +34202,11 @@ function buildCodexScript(options) {
     const projectPath = toPosixPath(options.projectPath);
     const loginMethodConfig = spaceTrim(`
         ${options.allowCredits ? 'CODEX_LOGIN_METHOD_ARGUMENTS=()' : 'CODEX_LOGIN_METHOD_ARGUMENTS=(-c forced_login_method=chatgpt)'}
-        if [ "\${PTBK_OPENAI_CODEX_USE_API_KEY:-0}" = "1" ] && [ -n "\${OPENAI_API_KEY:-}" ]; then
+        CODEX_USE_API_KEY="\${PTBK_OPENAI_CODEX_USE_API_KEY:-}"
+        if [ -z "\$CODEX_USE_API_KEY" ] && [ -n "\${OPENAI_API_KEY:-}" ]; then
+            CODEX_USE_API_KEY=1
+        fi
+        if [ "\$CODEX_USE_API_KEY" = "1" ] && [ -n "\${OPENAI_API_KEY:-}" ]; then
             CODEX_LOGIN_METHOD_ARGUMENTS=(-c forced_login_method=api)
         fi
     `);
@@ -34220,7 +34224,7 @@ function buildCodexScript(options) {
         '',
         loginMethodConfig,
         '',
-        'if [ "${PTBK_OPENAI_CODEX_USE_API_KEY:-0}" != "1" ] || [ -z "${OPENAI_API_KEY:-}" ]; then',
+        'if [ "${CODEX_USE_API_KEY:-0}" != "1" ] || [ -z "${OPENAI_API_KEY:-}" ]; then',
         'unset OPENAI_API_KEY',
         'unset OPENAI_BASE_URL',
         'fi',
@@ -37274,6 +37278,12 @@ const PTBK_AGENTS_SERVER_SQLITE_PATH_ENV = 'PTBK_AGENTS_SERVER_SQLITE_PATH';
  * @private internal constant of `ptbk agents-server`
  */
 const PTBK_HOSTNAME_ENV = 'PTBK_HOSTNAME';
+/**
+ * Explicit installed `.env` file passed by standalone VPS pm2/runtime launchers.
+ *
+ * @private internal constant of `ptbk agents-server`
+ */
+const PTBK_AGENTS_SERVER_ENV_FILE_ENV = 'PTBK_AGENTS_SERVER_ENV_FILE';
 /**
  * Entropy size for the local-only token shared by the CLI pump and the Next app.
  *
@@ -37399,11 +37409,20 @@ async function prepareAgentsServerDevelopmentRuntime(appPath, runnerLogStream) {
     });
 }
 /**
- * Loads launch-directory `.env` values without overriding explicit process environment.
+ * Loads Agents Server runtime environment from the installed `.env` file when explicitly configured and falls back
+ * to the launch-directory `.env`.
  *
  * @private internal utility of `ptbk agents-server`
  */
 function loadAgentsServerProjectEnvironment(launchWorkingDirectory) {
+    var _a;
+    const explicitEnvFilePath = (_a = process.env[PTBK_AGENTS_SERVER_ENV_FILE_ENV]) === null || _a === void 0 ? void 0 : _a.trim();
+    if (explicitEnvFilePath) {
+        const explicitLoadResult = dotenv.config({ path: explicitEnvFilePath, override: true });
+        if (!explicitLoadResult.error) {
+            return;
+        }
+    }
     dotenv.config({ path: join(launchWorkingDirectory, AGENTS_SERVER_PROJECT_ENV_FILE_NAME) });
 }
 /**