@promptbook/cli 0.112.0-81 → 0.112.0-84

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/cli",
-    "version": "0.112.0-81",
+    "version": "0.112.0-84",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,
@@ -155,6 +155,7 @@
         "@types/swagger-ui-react": "5.18.0",
         "@types/turndown": "5.0.6",
         "@vercel/blob": "1.1.1",
+        "better-sqlite3": "^11.10.0",
         "configchecker": "1.5.132",
         "cross-fetch": "4.0.0",
         "destroyable": "0.12.145",

package/src/book-components/Chat/save/pdf/buildChatPdf.ts

@@ -164,16 +164,7 @@ function appendCanvasPagesToPdf(pdf: jsPDF, canvas: HTMLCanvasElement): void {
             pdf.addPage();
         }
 
-        pdf.addImage(
-            pageCanvas,
-            PDF_PAGE_IMAGE_FORMAT,
-            0,
-            0,
-            pageWidth,
-            sliceHeight * imageScale,
-            undefined,
-            'FAST',
-        );
+        pdf.addImage(pageCanvas, PDF_PAGE_IMAGE_FORMAT, 0, 0, pageWidth, sliceHeight * imageScale, undefined, 'FAST');
     }
 }
 
@@ -182,11 +173,7 @@ function appendCanvasPagesToPdf(pdf: jsPDF, canvas: HTMLCanvasElement): void {
  *
  * @private Internal helper of `buildChatPdf`.
  */
-function createCanvasPageSlice(
-    canvas: HTMLCanvasElement,
-    sourceY: number,
-    sliceHeight: number,
-): HTMLCanvasElement {
+function createCanvasPageSlice(canvas: HTMLCanvasElement, sourceY: number, sliceHeight: number): HTMLCanvasElement {
     const pageCanvas = document.createElement('canvas');
     const pageCanvasContext = pageCanvas.getContext('2d');
 
@@ -204,17 +191,7 @@ function createCanvasPageSlice(
     pageCanvas.height = sliceHeight;
     pageCanvasContext.fillStyle = '#ffffff';
     pageCanvasContext.fillRect(0, 0, pageCanvas.width, pageCanvas.height);
-    pageCanvasContext.drawImage(
-        canvas,
-        0,
-        sourceY,
-        canvas.width,
-        sliceHeight,
-        0,
-        0,
-        canvas.width,
-        sliceHeight,
-    );
+    pageCanvasContext.drawImage(canvas, 0, sourceY, canvas.width, sliceHeight, 0, 0, canvas.width, sliceHeight);
 
     return pageCanvas;
 }

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

@@ -26,9 +26,11 @@ const AGENTS_SERVER_ENV_DOCUMENTATION_BASE_URL =
 const AGENTS_SERVER_ENV_CREATED_COMMENT = '# Created by `ptbk agents-server init` command';
 
 /**
- * Variables required for a local Agents Server backed by a Supabase project.
+ * Variables required for a local Agents Server backed by Supabase or standalone SQLite.
  */
 const REQUIRED_AGENTS_SERVER_ENV_VARIABLES: ReadonlyArray<RequiredAgentsServerEnvVariable> = [
+    createAgentsServerEnvVariable('PTBK_AGENTS_SERVER_DATABASE', 'supabase'),
+    createAgentsServerEnvVariable('PTBK_AGENTS_SERVER_SQLITE_PATH', '.promptbook/agents-server.sqlite'),
     createAgentsServerEnvVariable('OPENAI_API_KEY', ''),
     createAgentsServerEnvVariable('POSTGRES_URL', ''),
     createAgentsServerEnvVariable('NEXT_PUBLIC_SUPABASE_URL', ''),

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

@@ -23,6 +23,20 @@ import { ensureAgentsServerBuild, resolveAgentsServerAppPath } from './buildAgen
  */
 const USER_CHAT_JOB_WORKER_POLL_INTERVAL_MS = 2_000;
 
+/**
+ * Number of identical worker failures suppressed before logging a repeated summary.
+ *
+ * @private internal constant of `ptbk agents-server`
+ */
+const USER_CHAT_JOB_WORKER_REPEATED_ERROR_LOG_INTERVAL = 10;
+
+/**
+ * Maximum worker response body length shown in foreground diagnostics.
+ *
+ * @private internal constant of `ptbk agents-server`
+ */
+const USER_CHAT_JOB_WORKER_ERROR_BODY_MAX_LENGTH = 2_000;
+
 /**
  * HTTP status used by an idle internal worker tick with no job to process.
  *
@@ -51,6 +65,20 @@ const AGENTS_SERVER_PROJECT_ENV_FILE_NAME = '.env';
  */
 const PTBK_AGENTS_SERVER_AGENT_ROOT_ENV = 'PTBK_AGENTS_SERVER_AGENT_ROOT';
 
+/**
+ * Public database mode environment name consumed by the Agents Server app.
+ *
+ * @private internal constant of `ptbk agents-server`
+ */
+const PTBK_AGENTS_SERVER_DATABASE_ENV = 'PTBK_AGENTS_SERVER_DATABASE';
+
+/**
+ * Local SQLite file environment name consumed by the Agents Server app.
+ *
+ * @private internal constant of `ptbk agents-server`
+ */
+const PTBK_AGENTS_SERVER_SQLITE_PATH_ENV = 'PTBK_AGENTS_SERVER_SQLITE_PATH';
+
 /**
  * Entropy size for the local-only token shared by the CLI pump and the Next app.
  *
@@ -114,6 +142,10 @@ type AgentsServerChildEnvironment = NodeJS.ProcessEnv & {
 type AgentsServerSupervisorState = {
     isContinuing: boolean;
     uiHandle?: CoderRunUiHandle;
+    lastUserChatJobWorkerError?: {
+        message: string;
+        repeatCount: number;
+    };
     nextExit?: {
         code: number | null;
         signal: NodeJS.Signals | null;
@@ -332,11 +364,17 @@ function forwardChildOutput(
  * Creates the subprocess environment for Next and its internal local runner bridge.
  */
 function createAgentsServerChildEnvironment(port: number_port, agentRootPath: string): AgentsServerChildEnvironment {
+    const launchWorkingDirectory = process.cwd();
+
     return {
         ...process.env,
         PORT: String(port),
         NEXT_PUBLIC_SITE_URL: process.env.NEXT_PUBLIC_SITE_URL || `http://localhost:${port}`,
         [PTBK_AGENTS_SERVER_AGENT_ROOT_ENV]: agentRootPath,
+        [PTBK_AGENTS_SERVER_SQLITE_PATH_ENV]:
+            process.env[PTBK_AGENTS_SERVER_SQLITE_PATH_ENV] ||
+            join(launchWorkingDirectory, '.promptbook', 'agents-server.sqlite'),
+        [PTBK_AGENTS_SERVER_DATABASE_ENV]: process.env[PTBK_AGENTS_SERVER_DATABASE_ENV] || 'supabase',
         // Next loads app-local `.env` values after the CLI has prepared this bridge environment.
         PTBK_AGENTS_SERVER_USER_CHAT_WORKER_TOKEN:
             process.env.PTBK_AGENTS_SERVER_USER_CHAT_WORKER_TOKEN ||
@@ -380,10 +418,16 @@ function startUserChatJobWorkerPump(options: {
 
         isTickRunning = true;
         triggerUserChatJobWorkerTick(options)
+            .then(() => {
+                clearUserChatJobWorkerError(options.state);
+            })
             .catch((error) => {
                 const message = error instanceof Error ? error.message : String(error);
-                logRunnerEvent(options.logStreams.runner, `User chat worker tick failed: ${message}`);
-                addUiError(options.state, message);
+                reportUserChatJobWorkerError({
+                    logStream: options.logStreams.runner,
+                    message,
+                    state: options.state,
+                });
             })
             .finally(() => {
                 isTickRunning = false;
@@ -411,10 +455,111 @@ async function triggerUserChatJobWorkerTick(options: {
     });
 
     if (!response.ok && response.status !== HTTP_NO_CONTENT_STATUS_CODE) {
-        throw new Error(`Internal user chat worker returned ${response.status} ${response.statusText}.`);
+        const details = await readUserChatJobWorkerErrorDetails(response);
+        throw new Error(createUserChatJobWorkerErrorMessage(response, details));
     }
 }
 
+/**
+ * Reports worker failures while suppressing identical repeated foreground noise.
+ */
+function reportUserChatJobWorkerError(options: {
+    readonly logStream: WriteStream;
+    readonly message: string;
+    readonly state: AgentsServerSupervisorState;
+}): void {
+    const previousError = options.state.lastUserChatJobWorkerError;
+
+    if (previousError?.message === options.message) {
+        const repeatCount = previousError.repeatCount + 1;
+        options.state.lastUserChatJobWorkerError = {
+            message: options.message,
+            repeatCount,
+        };
+
+        if (repeatCount % USER_CHAT_JOB_WORKER_REPEATED_ERROR_LOG_INTERVAL !== 0) {
+            return;
+        }
+
+        const repeatedMessage = `User chat worker tick is still failing after ${repeatCount} attempts: ${options.message}`;
+        logRunnerEvent(options.logStream, repeatedMessage);
+        addUiError(options.state, repeatedMessage);
+        return;
+    }
+
+    options.state.lastUserChatJobWorkerError = {
+        message: options.message,
+        repeatCount: 1,
+    };
+    logRunnerEvent(options.logStream, `User chat worker tick failed: ${options.message}`);
+    addUiError(options.state, options.message);
+}
+
+/**
+ * Resets repeated-error suppression after a successful worker tick.
+ */
+function clearUserChatJobWorkerError(state: AgentsServerSupervisorState): void {
+    state.lastUserChatJobWorkerError = undefined;
+}
+
+/**
+ * Reads a worker error payload so foreground logs show the route-level reason.
+ */
+async function readUserChatJobWorkerErrorDetails(response: Response): Promise<string | null> {
+    const body = await response.text().catch(() => '');
+    const trimmedBody = body.trim();
+
+    if (!trimmedBody) {
+        return null;
+    }
+
+    const parsedMessage = parseUserChatJobWorkerErrorMessage(trimmedBody);
+    return truncateUserChatJobWorkerErrorDetails(parsedMessage || trimmedBody);
+}
+
+/**
+ * Extracts a readable error message from the worker route JSON response.
+ */
+function parseUserChatJobWorkerErrorMessage(body: string): string | null {
+    try {
+        const parsedBody = JSON.parse(body) as {
+            error?: unknown;
+            message?: unknown;
+        };
+        const errorMessage = typeof parsedBody.error === 'string' ? parsedBody.error : undefined;
+        const fallbackMessage = typeof parsedBody.message === 'string' ? parsedBody.message : undefined;
+
+        return errorMessage || fallbackMessage || null;
+    } catch {
+        return null;
+    }
+}
+
+/**
+ * Builds the foreground worker failure message from HTTP status and route details.
+ */
+function createUserChatJobWorkerErrorMessage(response: Response, details: string | null): string {
+    const statusText = response.statusText ? ` ${response.statusText}` : '';
+    const statusMessage = `${response.status}${statusText}`;
+
+    if (!details) {
+        return `Internal user chat worker returned ${statusMessage}.`;
+    }
+
+    return `Internal user chat worker returned ${statusMessage}: ${details}`;
+}
+
+/**
+ * Keeps foreground worker diagnostics bounded when a route returns a large payload.
+ */
+function truncateUserChatJobWorkerErrorDetails(details: string): string {
+    if (details.length <= USER_CHAT_JOB_WORKER_ERROR_BODY_MAX_LENGTH) {
+        return details;
+    }
+
+    return `${details.slice(0, USER_CHAT_JOB_WORKER_ERROR_BODY_MAX_LENGTH)}...`;
+}
+
 /**
  * Creates file streams for service output persisted below `./logs`.
  */