@promptbook/cli 0.113.0-1 → 0.113.0-11

package/apps/agents-server/src/components/Homepage/useAgentsGraphCanvasState.ts

@@ -197,12 +197,13 @@ export function useAgentsGraphCanvasState(props: UseAgentsGraphCanvasStateProps)
         () =>
             buildGraphLayoutNodes({
                 serverGroups,
+                links: graphData.links,
                 orderIndexByNodeId: graphData.orderIndexByNodeId,
                 publicUrl: normalizedPublicUrl,
                 storedPositions: storedPositionsRef.current,
                 onNodeOpen: onOpenGraphNode,
             }),
-        [serverGroups, graphData.orderIndexByNodeId, normalizedPublicUrl, onOpenGraphNode],
+        [serverGroups, graphData.links, graphData.orderIndexByNodeId, normalizedPublicUrl, onOpenGraphNode],
     );
 
     const [nodes, setNodes, onNodesChange] = useNodesState(layoutNodes);

package/apps/agents-server/src/components/Homepage/useAgentsListState.ts

@@ -3,9 +3,9 @@
 import type { string_url } from '@promptbook-local/types';
 import { useMemo } from 'react';
 import type { AgentOrganizationAgent, AgentOrganizationFolder } from '../../utils/agentOrganization/types';
+import { filterHiddenFolderTree } from '../../utils/agentOrganization/hiddenFolders';
 import { useAgentNaming } from '../AgentNaming/AgentNamingContext';
 import { getAgentIdentifier } from './agentOrganizationUtils';
-import { filterHiddenFolderTree } from './hiddenFolders';
 import { useAgentsListAgentState } from './useAgentsListAgentState';
 import { useAgentsListDerivedState } from './useAgentsListDerivedState';
 import {

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

@@ -8,6 +8,7 @@ import type { AgentOrganizationAgent, AgentOrganizationFolder } from '../../util
 import type { ChatFeedbackMode } from '../../utils/chatFeedbackMode';
 import type { UserInfo } from '../../utils/getCurrentUser';
 import type { ShibbolethAuthenticationMenuStatus } from '../../constants/shibbolethAuth';
+import type { ServerResourceWarningStatus } from '../../utils/resourceMonitor/resourceMonitorTypes';
 import { AgentNamingProvider } from '../AgentNaming/AgentNamingContext';
 import { DefaultAgentAvatarVisualProvider } from '../AgentAvatar/DefaultAgentAvatarVisualProvider';
 import { LegacyUiAutoTranslator } from '../AgentNaming/LegacyUiAutoTranslator';
@@ -17,7 +18,7 @@ import { ClientVersionMismatchListener } from '../ClientVersion/ClientVersionMis
 import { ChatEnterBehaviorPreferencesProvider } from '../ChatEnterBehavior/ChatEnterBehaviorPreferencesProvider';
 import { HomepageOptimisticNavigation } from '../Homepage/HomepageOptimisticNavigation';
 import { FileUploadAvailabilityProvider } from '../FileUploadAvailability/FileUploadAvailabilityContext';
-import { Footer, type FooterLink } from '../Footer/Footer';
+import { Footer, type FooterLink, type FooterVersionInfo } from '../Footer/Footer';
 import { ActiveAgentBreadcrumbProvider } from '../Header/ActiveAgentBreadcrumbContext';
 import { Header } from '../Header/Header';
 import { MobileMenuHoistingProvider } from '../Header/MobileMenuHoistingContext';
@@ -49,6 +50,7 @@ type LayoutWrapperProps = {
     agentNaming: AgentNaming;
     isFooterShown: boolean;
     footerLinks: Array<FooterLink>;
+    footerVersion: FooterVersionInfo;
     federatedServers: Array<{ url: string; title: string }>;
     isExperimental: boolean;
     feedbackMode: ChatFeedbackMode;
@@ -56,6 +58,10 @@ type LayoutWrapperProps = {
      * Shibboleth authentication status used by the header menu.
      */
     readonly shibbolethAuthenticationStatus: ShibbolethAuthenticationMenuStatus;
+    /**
+     * Resource monitor status used by the header menu.
+     */
+    readonly resourceMonitorWarningStatus: ServerResourceWarningStatus;
     /**
      * Indicates if the install-as-app option should be shown in agent menus.
      */
@@ -97,10 +103,12 @@ export function LayoutWrapper({
     agentNaming,
     isFooterShown,
     footerLinks,
+    footerVersion,
     federatedServers,
     isExperimental,
     feedbackMode,
     shibbolethAuthenticationStatus,
+    resourceMonitorWarningStatus,
     isExperimentalPwaAppEnabled,
     controlPanelOptionAvailability,
     defaultIsSoundsOn,
@@ -152,7 +160,9 @@ export function LayoutWrapper({
                                                     <BrowserPushNotificationsProvider
                                                         defaultEnabled={defaultIsNotificationsOn}
                                                         pushPublicKey={webPushPublicKey}
-                                                        isMetadataAvailable={controlPanelOptionAvailability.notifications}
+                                                        isMetadataAvailable={
+                                                            controlPanelOptionAvailability.notifications
+                                                        }
                                                     >
                                                         <ChatEnterBehaviorPreferencesProvider>
                                                             <ClientVersionMismatchListener />
@@ -181,12 +191,17 @@ export function LayoutWrapper({
                                                                                         serverLogoUrl={serverLogoUrl}
                                                                                         agents={agents}
                                                                                         agentFolders={agentFolders}
-                                                                                        federatedServers={federatedServers}
+                                                                                        federatedServers={
+                                                                                            federatedServers
+                                                                                        }
                                                                                         isExperimental={isExperimental}
                                                                                         feedbackMode={feedbackMode}
                                                                                         shibbolethAuthenticationStatus={
                                                                                             shibbolethAuthenticationStatus
                                                                                         }
+                                                                                        resourceMonitorWarningStatus={
+                                                                                            resourceMonitorWarningStatus
+                                                                                        }
                                                                                     />
                                                                                     <main className={mainClassName}>
                                                                                         <HomepageOptimisticNavigation
@@ -195,9 +210,13 @@ export function LayoutWrapper({
                                                                                             {children}
                                                                                         </HomepageOptimisticNavigation>
                                                                                     </main>
-                                                                                    {isFooterShown && !isFooterHiddenOnPage && (
-                                                                                        <Footer extraLinks={footerLinks} />
-                                                                                    )}
+                                                                                    {isFooterShown &&
+                                                                                        !isFooterHiddenOnPage && (
+                                                                                            <Footer
+                                                                                                extraLinks={footerLinks}
+                                                                                                version={footerVersion}
+                                                                                            />
+                                                                                        )}
                                                                                 </div>
                                                                             )}
                                                                         </ActiveAgentBreadcrumbProvider>

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

@@ -3,7 +3,8 @@ import { AVATAR_VISUALS, resolveAvatarVisualId } from '../../../../src/avatars/v
 import { DEFAULT_AGENT_AVATAR_VISUAL_ID as SHARED_DEFAULT_AGENT_AVATAR_VISUAL_ID } from '../../../../src/utils/agents/resolveAgentAvatarImageUrl';
 
 /**
- * Metadata key controlling the built-in avatar visual used for agents without `META IMAGE` or `META AVATAR`.
+ * Metadata key controlling the built-in avatar visual used for agents without `META IMAGE`, `META AVATAR`,
+ * or `META VISUAL`.
  */
 export const DEFAULT_AGENT_AVATAR_VISUAL_METADATA_KEY = 'DEFAULT_AGENT_AVATAR_VISUAL';
 
@@ -58,8 +59,8 @@ export const DEFAULT_AGENT_AVATAR_VISUAL_METADATA_VALUE =
 /**
  * Resolves one raw metadata value to a supported built-in avatar visual id.
  *
- * The same separator-insensitive lookup is shared with `META AVATAR`, so both
- * `PIXEL_ART` and `pixel art` resolve to the same built-in visual.
+ * The same separator-insensitive lookup is shared with `META AVATAR` / `META VISUAL`,
+ * so both `PIXEL_ART` and `pixel art` resolve to the same built-in visual.
  *
  * @param value - Raw metadata value stored in `Metadata`.
  * @returns Safe supported visual id.

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

@@ -0,0 +1,20 @@
+/**
+ * Admin page path for configuring standalone harness authentication.
+ *
+ * @private internal route constant for Agents Server Harness Auth UI
+ */
+export const HARNESS_AUTH_ADMIN_PATH = '/admin/harness-auth';
+
+/**
+ * Admin API path for configuring standalone harness authentication.
+ *
+ * @private internal route constant for Agents Server Harness Auth UI
+ */
+export const HARNESS_AUTH_API_PATH = '/api/admin/harness-auth';
+
+/**
+ * Admin API path for the interactive harness authentication terminal.
+ *
+ * @private internal route constant for Agents Server Harness Auth UI
+ */
+export const HARNESS_AUTHENTICATION_API_PATH = `${HARNESS_AUTH_API_PATH}/authentication`;

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

@@ -407,7 +407,7 @@ export const metadataDefaults: ReadonlyArray<MetadataDefinition> = [
     {
         key: DEFAULT_AGENT_AVATAR_VISUAL_METADATA_KEY,
         value: DEFAULT_AGENT_AVATAR_VISUAL_METADATA_VALUE,
-        note: `Default built-in avatar visual used for agents without \`META IMAGE\` or \`META AVATAR\`. Allowed values: ${formatMetadataOptionValues(
+        note: `Default built-in avatar visual used for agents without \`META IMAGE\`, \`META AVATAR\`, or \`META VISUAL\`. Allowed values: ${formatMetadataOptionValues(
             DEFAULT_AGENT_AVATAR_VISUAL_METADATA_OPTIONS.map(({ metadataValue, title }) => ({
                 value: metadataValue,
                 label: title,

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

@@ -1,14 +1,22 @@
+import { mkdir, writeFile } from 'fs/promises';
+import { dirname } from 'path';
 import colors from 'colors';
 import {
     DATABASE_MIGRATION_APPLIED_BY,
     resolveDatabaseMigrationRuntimeConfiguration,
     runDatabaseMigrations,
+    type RunDatabaseMigrationsResult,
 } from './runDatabaseMigrations';
 import { isAgentsServerSqliteMode } from './agentsServerDatabaseMode';
 import { loadAgentsServerEnvFile } from './loadAgentsServerEnvFile';
 
 loadAgentsServerEnvFile();
 
+/**
+ * Optional output path for a machine-readable migration summary used by standalone VPS self-update.
+ */
+const DATABASE_MIGRATION_SUMMARY_FILE_ENV_NAME = 'PTBK_DATABASE_MIGRATION_SUMMARY_FILE';
+
 /**
  * Runs manual migration command from CLI arguments.
  */
@@ -31,7 +39,7 @@ async function migrate(): Promise<void> {
     }
 
     try {
-        await runDatabaseMigrations({
+        const migrationResult = await runDatabaseMigrations({
             prefixes: runtimeConfiguration.prefixes,
             registeredServers: runtimeConfiguration.registeredServers,
             connectionString: runtimeConfiguration.connectionString,
@@ -40,6 +48,7 @@ async function migrate(): Promise<void> {
             logger: console,
             logSqlStatements: true,
         });
+        await writeDatabaseMigrationSummaryFile(migrationResult);
         console.info(colors.bgGreen('\n🎉 All migrations completed successfully'));
     } catch (error) {
         console.error(colors.bgRed('\n❌ Migration failed:'));
@@ -52,6 +61,21 @@ async function migrate(): Promise<void> {
     }
 }
 
+/**
+ * Writes machine-readable migration summary when the caller provides an output path.
+ *
+ * @param migrationResult - Result returned by the shared migration runner.
+ */
+async function writeDatabaseMigrationSummaryFile(migrationResult: RunDatabaseMigrationsResult): Promise<void> {
+    const summaryFilePath = process.env[DATABASE_MIGRATION_SUMMARY_FILE_ENV_NAME]?.trim();
+    if (!summaryFilePath) {
+        return;
+    }
+
+    await mkdir(dirname(summaryFilePath), { recursive: true });
+    await writeFile(summaryFilePath, `${JSON.stringify(migrationResult, null, 2)}\n`, 'utf-8');
+}
+
 /**
  * Parses optional `--only` flag from CLI arguments.
  *

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

@@ -44,6 +44,10 @@ export type MigratePrefixOptions = {
      * Optional observer notified about the current prefix migration sub-step.
      */
     readonly onProgress?: (progress: MigratePrefixProgress) => void;
+    /**
+     * Optional observer notified after one migration file has been applied and recorded.
+     */
+    readonly onMigrationApplied?: (appliedMigration: MigratePrefixAppliedMigration) => void;
 };
 
 /**
@@ -77,6 +81,22 @@ export type MigratePrefixProgress = {
     readonly migrationFile?: string;
 };
 
+/**
+ * Snapshot emitted after one migration file has been successfully applied for one prefix.
+ *
+ * @private function of runDatabaseMigrations
+ */
+export type MigratePrefixAppliedMigration = {
+    /**
+     * Prefix currently being migrated.
+     */
+    readonly prefix: string;
+    /**
+     * Migration file that has been applied and recorded.
+     */
+    readonly migrationFile: string;
+};
+
 /**
  * Context for migrations-table schema synchronization.
  *
@@ -159,6 +179,10 @@ export async function applyPendingMigrationsForPrefix(options: MigratePrefixOpti
             [migrationFile, options.appliedBy],
         );
         appliedCount++;
+        options.onMigrationApplied?.({
+            prefix: options.prefix,
+            migrationFile,
+        });
         options.logger.info(`  ✅ Applied ${migrationFile}`);
     }
 

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

@@ -109,6 +109,10 @@ export type DatabaseMigrationPrefixResult = {
      * Number of newly applied migration files.
      */
     readonly appliedCount: number;
+    /**
+     * Migration filenames newly applied for this prefix.
+     */
+    readonly appliedMigrationFiles: ReadonlyArray<string>;
 };
 
 /**
@@ -270,6 +274,7 @@ export async function runDatabaseMigrations(
         }
 
         for (const prefix of selectedPrefixes) {
+            const appliedMigrationFiles: Array<string> = [];
             failureContext.stage = 'migrate-prefix';
             failureContext.currentPrefix = prefix;
             failureContext.currentPrefixStage = undefined;
@@ -289,8 +294,11 @@ export async function runDatabaseMigrations(
                     failureContext.currentPrefixStage = stage;
                     failureContext.currentMigrationFile = migrationFile;
                 },
+                onMigrationApplied: ({ migrationFile }) => {
+                    appliedMigrationFiles.push(migrationFile);
+                },
             });
-            perPrefix.push({ prefix, appliedCount });
+            perPrefix.push({ prefix, appliedCount, appliedMigrationFiles });
         }
 
         return {