@promptbook/cli 0.112.0-111 → 0.112.0-112

package/esm/src/cli/cli-commands/agents-server/startAgentsServer.d.ts

@@ -29,7 +29,8 @@ export type StartAgentsServerOptions = {
  */
 export declare function startAgentsServer(options: StartAgentsServerOptions): Promise<void>;
 /**
- * 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`
  */

package/esm/src/cli/cli-commands/agents-server/startAgentsServer.test.d.ts

@@ -0,0 +1 @@
+export {};

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-110`).
+ * It follows semantic versioning (e.g., `0.112.0-111`).
  *
  * @generated
  */

package/package.json

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

package/src/cli/cli-commands/agents-server/startAgentsServer.ts

@@ -107,6 +107,13 @@ const PTBK_AGENTS_SERVER_SQLITE_PATH_ENV = 'PTBK_AGENTS_SERVER_SQLITE_PATH';
  */
 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.
  *
@@ -355,11 +362,20 @@ async function prepareAgentsServerDevelopmentRuntime(
 }
 
 /**
- * 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`
  */
 export function loadAgentsServerProjectEnvironment(launchWorkingDirectory: string): void {
+    const explicitEnvFilePath = process.env[PTBK_AGENTS_SERVER_ENV_FILE_ENV]?.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) });
 }