@promptbook/cli 0.112.0-89 → 0.112.0-91

package/src/version.ts

@@ -16,11 +16,11 @@ export const BOOK_LANGUAGE_VERSION: string_semantic_version = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-export const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version = '0.112.0-89';
+export const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version = '0.112.0-91';
 
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.112.0-88`).
+ * It follows semantic versioning (e.g., `0.112.0-90`).
  *
  * @generated
  */

package/src/versions.txt

@@ -1126,3 +1126,5 @@
 0.112.0-82
 0.112.0-88
 0.112.0-89
+0.112.0-90
+0.112.0-91

package/umd/apps/agents-server/src/utils/serverRegistry.d.ts

@@ -65,6 +65,12 @@ export declare function listRegisteredServers(supabase: Pick<SupabaseClient, 'fr
 export declare function listRegisteredServersUsingServiceRole(options?: {
     readonly forceRefresh?: boolean;
 }): Promise<Array<ServerRecord>>;
+/**
+ * Loads virtual server records from the comma-separated `SERVERS` environment variable.
+ *
+ * @returns Server records with deterministic table prefixes derived from normalized domains.
+ */
+export declare function listEnvironmentRegisteredServers(): Array<ServerRecord>;
 /**
  * Finds one registered server by incoming host header.
  *

package/umd/index.umd.js

@@ -60,7 +60,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-89';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-91';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -36108,6 +36108,12 @@
      * @private internal constant of `ptbk agents-server`
      */
     const PTBK_AGENTS_SERVER_SQLITE_PATH_ENV = 'PTBK_AGENTS_SERVER_SQLITE_PATH';
+    /**
+     * Optional hostname used by the internal Next server.
+     *
+     * @private internal constant of `ptbk agents-server`
+     */
+    const PTBK_HOSTNAME_ENV = 'PTBK_HOSTNAME';
     /**
      * Entropy size for the local-only token shared by the CLI pump and the Next app.
      *
@@ -36226,8 +36232,15 @@
      * Starts the production Next server and wires its logs into the foreground dashboard.
      */
     function startNextServer(options) {
+        var _a;
         logRunnerEvent(options.logStreams.runner, 'Starting the Agents Server Next process.');
-        const commandProcess = child_process.spawn(process.execPath, [options.nextCliPath, 'start', '--port', String(options.options.port)], {
+        const nextArguments = [options.nextCliPath, 'start', '--port', String(options.options.port)];
+        const hostname = (_a = options.childEnvironment[PTBK_HOSTNAME_ENV]) === null || _a === void 0 ? void 0 : _a.trim();
+        if (hostname) {
+            nextArguments.push('--hostname', hostname);
+            logRunnerEvent(options.logStreams.runner, `Binding Agents Server Next process to ${hostname}.`);
+        }
+        const commandProcess = child_process.spawn(process.execPath, nextArguments, {
             cwd: options.runtimePaths.appPath,
             env: options.childEnvironment,
             stdio: ['ignore', 'pipe', 'pipe'],
@@ -67592,6 +67605,38 @@
      * Global source-of-truth table for server routing and migration targeting.
      */
     const SERVER_REGISTRY_TABLE_NAME = '_Server';
+    /**
+     * Environment variable with comma-separated standalone server domains.
+     */
+    const SERVERS_ENV_NAME = 'SERVERS';
+    /**
+     * Stable timestamp used by virtual server records derived from environment variables.
+     */
+    const ENVIRONMENT_SERVER_TIMESTAMP = '1970-01-01T00:00:00.000Z';
+    /**
+     * Loads virtual server records from the comma-separated `SERVERS` environment variable.
+     *
+     * @returns Server records with deterministic table prefixes derived from normalized domains.
+     */
+    function listEnvironmentRegisteredServers() {
+        const rawServers = process.env[SERVERS_ENV_NAME];
+        if (!rawServers) {
+            return [];
+        }
+        const normalizedDomains = uniqueStrings$1(rawServers
+            .split(',')
+            .map((server) => normalizeServerDomain(server))
+            .filter((server) => Boolean(server)));
+        return normalizedDomains.map((domain, index) => ({
+            id: -(index + 1),
+            name: domain,
+            environment: SERVER_ENVIRONMENT.PRODUCTION,
+            domain,
+            tablePrefix: buildEnvironmentServerTablePrefix(domain),
+            createdAt: ENVIRONMENT_SERVER_TIMESTAMP,
+            updatedAt: ENVIRONMENT_SERVER_TIMESTAMP,
+        }));
+    }
     /**
      * Normalizes one raw `_Server` row and validates required fields.
      *
@@ -67712,6 +67757,39 @@
     function isDefaultPortForProtocol(protocol, port) {
         return (protocol === 'http:' && port === '80') || (protocol === 'https:' && port === '443');
     }
+    /**
+     * Builds a deterministic table prefix from a normalized domain.
+     *
+     * @param domain - Normalized server domain.
+     * @returns Prefix such as `server_www_example_com_`.
+     */
+    function buildEnvironmentServerTablePrefix(domain) {
+        const prefixSuffix = domain
+            .toLowerCase()
+            .replace(/-/gu, '_dash_')
+            .replace(/\./gu, '_')
+            .replace(/:/gu, '_port_')
+            .replace(/[^a-z0-9_]/gu, '_')
+            .replace(/_+/gu, '_')
+            .replace(/^_+|_+$/gu, '');
+        return `server_${prefixSuffix}_`;
+    }
+    /**
+     * Deduplicates non-empty strings while preserving input order.
+     *
+     * @param values - Raw string values.
+     * @returns Unique non-empty strings.
+     */
+    function uniqueStrings$1(values) {
+        const uniqueValues = [];
+        for (const value of values) {
+            if (!value || uniqueValues.includes(value)) {
+                continue;
+            }
+            uniqueValues.push(value);
+        }
+        return uniqueValues;
+    }
 
     /**
      * SQL query used to load all registered servers in a deterministic order.
@@ -68070,7 +68148,7 @@
         const client = await createPostgresClient(connectionString);
         try {
             await client.connect();
-            const registeredServers = await listRegisteredServersFromDatabase(client);
+            const registeredServers = mergeRegisteredServers(await listRegisteredServersFromDatabase(client), listEnvironmentRegisteredServers());
             const hasExplicitDefaultPrefix = process.env[SUPABASE_TABLE_PREFIX_ENV_NAME] !== undefined;
             const configuredPrefixes = uniquePrefixes([
                 ...(hasExplicitDefaultPrefix
@@ -68231,6 +68309,25 @@
         }
         return result;
     }
+    /**
+     * Combines database and environment registry rows, keeping database rows authoritative.
+     *
+     * @param databaseServers - Persistent `_Server` rows.
+     * @param environmentServers - Virtual rows derived from `SERVERS`.
+     * @returns Merged rows without duplicate domains.
+     */
+    function mergeRegisteredServers(databaseServers, environmentServers) {
+        const seenDomains = new Set(databaseServers.map((server) => server.domain));
+        const mergedServers = [...databaseServers];
+        for (const environmentServer of environmentServers) {
+            if (seenDomains.has(environmentServer.domain)) {
+                continue;
+            }
+            mergedServers.push(environmentServer);
+            seenDomains.add(environmentServer.domain);
+        }
+        return mergedServers;
+    }
     /**
      * Creates one PostgreSQL client using the lazily loaded `pg` package.
      *