@promptbook/cli 0.112.0-133 → 0.112.0-134

package/apps/agents-server/src/app/agents/[agentName]/api/book/route.ts

@@ -1,5 +1,6 @@
 import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
 import { $provideAgentReferenceResolver } from '@/src/utils/agentReferenceResolver/$provideAgentReferenceResolver';
+import { invalidateCachedActiveOrganizationSnapshots } from '@/src/utils/agentOrganization/loadAgentOrganizationState';
 import {
     parseBookScopedAgentIdentifier,
     resolveBookScopedAgentContext,
@@ -172,6 +173,7 @@ export async function PUT(request: Request, { params }: { params: Promise<{ agen
 
         const agentId = await collection.getAgentPermanentId(agentName);
         await collection.updateAgentSource(agentId, agentSource, { versionName });
+        invalidateCachedActiveOrganizationSnapshots();
         // <- TODO: [🐱‍🚀] Properly type as string_book
 
         return new Response(

package/apps/agents-server/src/app/api/agents/[agentName]/route.ts

@@ -12,6 +12,7 @@ import { NextResponse } from 'next/server';
 import { buildAgentNameOrIdFilter } from '@/src/utils/agentIdentifier';
 import { getCurrentUser } from '@/src/utils/getCurrentUser';
 import { resolveServerAgentContext } from '@/src/utils/resolveServerAgentContext';
+import { invalidateCachedActiveOrganizationSnapshots } from '@/src/utils/agentOrganization/loadAgentOrganizationState';
 
 /**
  * Handles patch.
@@ -45,6 +46,7 @@ export async function PATCH(request: Request, { params }: { params: Promise<{ ag
                 localServerUrl: new URL(request.url).origin,
                 fallbackResolver: baseAgentReferenceResolver,
             });
+            invalidateCachedActiveOrganizationSnapshots();
 
             return NextResponse.json({
                 success: true,
@@ -74,6 +76,8 @@ export async function PATCH(request: Request, { params }: { params: Promise<{ ag
             return NextResponse.json({ success: false, error: updateResult.error.message }, { status: 500 });
         }
 
+        invalidateCachedActiveOrganizationSnapshots();
+
         return NextResponse.json({ success: true });
     } catch (error) {
         return NextResponse.json(
@@ -97,6 +101,7 @@ export async function DELETE(request: Request, { params }: { params: Promise<{ a
 
         const agentId = await collection.getAgentPermanentId(agentName);
         await collection.deleteAgent(agentId);
+        invalidateCachedActiveOrganizationSnapshots();
         return NextResponse.json({ success: true });
     } catch (error) {
         return NextResponse.json(

package/apps/agents-server/src/app/api/v1/agents/[agentId]/route.ts

@@ -6,6 +6,7 @@ import { $getTableName } from '@/src/database/$getTableName';
 import { $provideSupabaseForServer } from '@/src/database/$provideSupabaseForServer';
 import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
 import { $provideServer } from '@/src/tools/$provideServer';
+import { invalidateCachedActiveOrganizationSnapshots } from '@/src/utils/agentOrganization/loadAgentOrganizationState';
 import { findOwnedAgentByIdentifier, findOwnedFolderById, type OwnedAgentRow } from '@/src/utils/agentOwnership';
 import {
     getNextOwnedAgentSortOrder,
@@ -155,6 +156,8 @@ export async function PATCH(request: NextRequest, { params }: { params: Promise<
             return metadataUpdateResponse;
         }
 
+        invalidateCachedActiveOrganizationSnapshots();
+
         return createUpdatedOwnedAgentResponse(request, identityResult.identity.userId, existingAgent);
     } catch (error) {
         return mapOwnedAgentLookupErrorToResponse(request, error);
@@ -192,6 +195,7 @@ export async function DELETE(request: NextRequest, { params }: { params: Promise
 
         const collection = await $provideAgentCollectionForServer();
         await collection.deleteAgent(existingAgent.permanentId || existingAgent.agentName);
+        invalidateCachedActiveOrganizationSnapshots();
 
         return createManagementApiJsonResponse(request, { success: true });
     } catch (error) {

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

@@ -4,6 +4,7 @@ import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentColle
 import { $provideServer } from '@/src/tools/$provideServer';
 import { findOwnedFolderById, findOwnedAgentByIdentifier } from '@/src/utils/agentOwnership';
 import { createAgentWithDefaultVisibility } from '@/src/utils/createAgentWithDefaultVisibility';
+import { invalidateCachedActiveOrganizationSnapshots } from '@/src/utils/agentOrganization/loadAgentOrganizationState';
 import {
     searchOwnedAgents,
     getNextOwnedAgentSortOrder,
@@ -141,6 +142,7 @@ export async function POST(request: NextRequest) {
             sortOrder,
             userId: identityResult.identity.userId,
         });
+        invalidateCachedActiveOrganizationSnapshots();
         const persistedRow = await findOwnedAgentByIdentifier(identityResult.identity.userId, createdAgent.permanentId);
 
         if (!persistedRow) {

package/apps/agents-server/src/app/recycle-bin/actions.ts

@@ -4,6 +4,7 @@ import { restoreAgentAndFolders } from '@/src/utils/agentOrganization/restoreAge
 import { revalidatePath } from 'next/cache';
 import { isUserAdmin } from '../../utils/isUserAdmin';
 import { $provideAgentCollectionForServer } from '@/src/tools/$provideAgentCollectionForServer';
+import { invalidateCachedActiveOrganizationSnapshots } from '@/src/utils/agentOrganization/loadAgentOrganizationState';
 
 /**
  * Restores a deleted agent from the recycle bin.
@@ -16,6 +17,7 @@ export async function restoreDeletedAgent(agentName: string) {
     }
 
     await restoreAgentAndFolders(agentName);
+    invalidateCachedActiveOrganizationSnapshots();
 
     revalidatePath('/recycle-bin');
     revalidatePath(`/agents/${agentName}`);
@@ -35,6 +37,7 @@ export async function deleteAgent(agentName: string) {
     const collection = await $provideAgentCollectionForServer();
 
     await collection.deleteAgent(agentName);
+    invalidateCachedActiveOrganizationSnapshots();
 
     revalidatePath('/recycle-bin');
     revalidatePath(`/agents/${agentName}`);

package/apps/agents-server/src/database/migrations/2026-06-2600-agent-directory-performance-indexes.sql

@@ -0,0 +1,14 @@
+CREATE INDEX IF NOT EXISTS "prefix_Agent_deletedAt_sortOrder_agentName_idx"
+    ON "prefix_Agent" ("deletedAt", "sortOrder", "agentName");
+
+CREATE INDEX IF NOT EXISTS "prefix_Agent_visibility_deletedAt_sortOrder_agentName_idx"
+    ON "prefix_Agent" ("visibility", "deletedAt", "sortOrder", "agentName");
+
+CREATE INDEX IF NOT EXISTS "prefix_AgentFolder_deletedAt_parentId_sortOrder_name_idx"
+    ON "prefix_AgentFolder" ("deletedAt", "parentId", "sortOrder", "name");
+
+CREATE INDEX IF NOT EXISTS "prefix_UserChat_userId_agentPermanentId_source_createdAt_idx"
+    ON "prefix_UserChat" ("userId", "agentPermanentId", "source", "createdAt" DESC);
+
+CREATE INDEX IF NOT EXISTS "prefix_UserChat_agentPermanentId_source_userId_createdAt_idx"
+    ON "prefix_UserChat" ("agentPermanentId", "source", "userId", "createdAt" DESC);

package/apps/agents-server/src/database/sqlite/$provideLocalSqliteSupabase.ts

@@ -65,6 +65,14 @@ type LocalSqliteUpsertOptions = {
     readonly onConflict?: string;
 };
 
+/**
+ * Read index definition for hot SQLite queries.
+ */
+type LocalSqliteReadIndex = {
+    readonly name: string;
+    readonly columns: ReadonlyArray<string>;
+};
+
 /**
  * Columns whose values are persisted as JSON text in local SQLite.
  */
@@ -141,6 +149,51 @@ const UNIQUE_INDEX_COLUMNS_BY_TABLE = new Map<string, ReadonlyArray<ReadonlyArra
     ['UserPushSubscription', [['endpoint']]],
 ]);
 
+/**
+ * Non-unique indexes for frequent standalone VPS reads.
+ */
+const READ_INDEXES_BY_TABLE = new Map<string, ReadonlyArray<LocalSqliteReadIndex>>([
+    [
+        'Agent',
+        [
+            { name: 'agentName_lookup', columns: ['agentName'] },
+            { name: 'active_directory', columns: ['deletedAt', 'sortOrder', 'agentName'] },
+            { name: 'public_active_directory', columns: ['visibility', 'deletedAt', 'sortOrder', 'agentName'] },
+        ],
+    ],
+    [
+        'AgentFolder',
+        [{ name: 'active_directory', columns: ['deletedAt', 'parentId', 'sortOrder', 'name'] }],
+    ],
+    [
+        'UserChat',
+        [
+            { name: 'user_agent_source_createdAt', columns: ['userId', 'agentPermanentId', 'source', 'createdAt'] },
+            { name: 'agent_source_user_createdAt', columns: ['agentPermanentId', 'source', 'userId', 'createdAt'] },
+        ],
+    ],
+    [
+        'UserChatJob',
+        [
+            { name: 'ready_queue', columns: ['status', 'cancelRequestedAt', 'queuedAt', 'createdAt'] },
+            { name: 'active_chat_scope', columns: ['chatId', 'userId', 'agentPermanentId', 'status', 'createdAt'] },
+            { name: 'agent_chat_status', columns: ['agentPermanentId', 'chatId', 'status'] },
+            { name: 'running_lease', columns: ['status', 'leaseExpiresAt'] },
+        ],
+    ],
+    [
+        'UserChatTimeout',
+        [
+            { name: 'ready_due', columns: ['status', 'cancelRequestedAt', 'pausedAt', 'dueAt', 'createdAt'] },
+            {
+                name: 'active_chat_scope',
+                columns: ['chatId', 'userId', 'agentPermanentId', 'status', 'pausedAt', 'dueAt', 'createdAt'],
+            },
+            { name: 'running_lease', columns: ['status', 'leaseExpiresAt'] },
+        ],
+    ],
+]);
+
 /**
  * Known unique conflict columns used when `.upsert` omits `onConflict`.
  */
@@ -179,6 +232,20 @@ export function $resetLocalSqliteSupabaseForTests(): void {
     localSqliteSupabase = null;
 }
 
+/**
+ * Ensures read indexes for a table that is queried through direct SQLite SQL.
+ *
+ * @param tableName - Actual table name, including any server prefix.
+ *
+ * @private internal SQLite utility of Agents Server
+ */
+export function ensureLocalSqliteTableReadIndexes(tableName: string): void {
+    const database = $provideAgentsServerSqliteDatabase();
+    const tableBaseName = resolveTableBaseName(tableName);
+
+    ensureTable(database, tableName, resolveReadIndexColumns(tableBaseName));
+}
+
 /**
  * Supabase-shaped client with only the table query surface used by Agents Server.
  */
@@ -836,8 +903,9 @@ function ensureTable(
     const columnsToEnsure = uniqueStrings([...requiredColumns, ...resolveUniqueIndexColumns(tableBaseName)]).filter(
         (column) => column !== '*' && column !== 'id',
     );
+    const columnsToEnsureWithIndexes = uniqueStrings([...columnsToEnsure, ...resolveReadIndexColumns(tableBaseName)]);
 
-    for (const column of columnsToEnsure) {
+    for (const column of columnsToEnsureWithIndexes) {
         if (existingColumns.has(column)) {
             continue;
         }
@@ -852,6 +920,7 @@ function ensureTable(
     }
 
     ensureUniqueIndexes(database, tableName, tableBaseName);
+    ensureReadIndexes(database, tableName, tableBaseName);
 }
 
 /**
@@ -871,6 +940,21 @@ function ensureUniqueIndexes(database: AgentsServerSqliteDatabase, tableName: st
     }
 }
 
+/**
+ * Creates known read indexes after required columns exist.
+ */
+function ensureReadIndexes(database: AgentsServerSqliteDatabase, tableName: string, tableBaseName: string): void {
+    const readIndexes = READ_INDEXES_BY_TABLE.get(tableBaseName) || [];
+
+    for (const readIndex of readIndexes) {
+        const indexName = `index_${sanitizeSqlIdentifier(tableName)}_${sanitizeSqlIdentifier(readIndex.name)}`;
+        const columnSql = readIndex.columns.map(quoteIdentifier).join(', ');
+        database.exec(
+            `CREATE INDEX IF NOT EXISTS ${quoteIdentifier(indexName)} ON ${quoteIdentifier(tableName)} (${columnSql})`,
+        );
+    }
+}
+
 /**
  * Inserts one row into the table.
  */
@@ -1441,6 +1525,13 @@ function resolveUniqueIndexColumns(tableBaseName: string): Array<string> {
     return (UNIQUE_INDEX_COLUMNS_BY_TABLE.get(tableBaseName) || []).flatMap((columns) => [...columns]);
 }
 
+/**
+ * Resolves columns participating in known read indexes.
+ */
+function resolveReadIndexColumns(tableBaseName: string): Array<string> {
+    return (READ_INDEXES_BY_TABLE.get(tableBaseName) || []).flatMap((readIndex) => [...readIndex.columns]);
+}
+
 /**
  * Resolves upsert conflict columns.
  */

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

@@ -2,6 +2,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 { ensureLocalSqliteTableReadIndexes } from '@/src/database/sqlite/$provideLocalSqliteSupabase';
 import type { ListUserChatsOptions, UserChatRecord } from './UserChatRecord';
 import type { UserChatSource } from './UserChatSource';
 import type { UserChatRow } from './UserChatRow';
@@ -168,7 +169,10 @@ export async function listUserChatSummarySeeds(options: ListUserChatsOptions): P
  * @private function of `userChat`
  */
 async function listUserChatSummarySeedsViaSqlite(options: ListUserChatsOptions): Promise<Array<UserChatSummarySeed>> {
-    const userChatTableName = quoteIdentifier(await $getTableName('UserChat'));
+    const rawUserChatTableName = await $getTableName('UserChat');
+    ensureLocalSqliteTableReadIndexes(rawUserChatTableName);
+
+    const userChatTableName = quoteIdentifier(rawUserChatTableName);
     const shouldLoadExternalChats = options.viewerIsAdmin && options.includeExternalChats;
     const whereClause = shouldLoadExternalChats
         ? `

package/esm/index.es.js

@@ -59,7 +59,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-133';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-134';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/esm/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.112.0-132`).
+ * It follows semantic versioning (e.g., `0.112.0-133`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/cli",
-    "version": "0.112.0-133",
+    "version": "0.112.0-134",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,