@promptbook/cli 0.112.0-82 → 0.112.0-85

package/apps/agents-server/README.md

@@ -12,7 +12,13 @@ ptbk agents-server init
 ptbk agents-server start --agent github-copilot --model gpt-5.4 --thinking-level xhigh
 ```
 
-`ptbk agents-server init` adds missing placeholders to `.env` and local runtime exclusions to `.gitignore` without deleting existing configuration. Fill the initialized Supabase values from your project before starting the server. The Supabase project URL and API keys are available in the [Supabase project API settings](https://supabase.com/docs/guides/api/api-keys), and the PostgreSQL connection string is available from the [Supabase database connection guide](https://supabase.com/docs/guides/database/connecting-to-postgres).
+`ptbk agents-server init` adds missing placeholders to `.env` and local runtime exclusions to `.gitignore` without deleting existing configuration. Use `PTBK_AGENTS_SERVER_DATABASE=supabase` for a Supabase-backed server or `PTBK_AGENTS_SERVER_DATABASE=sqlite` for a standalone local database in `.promptbook`. When using Supabase, fill the initialized values from your project before starting the server. The Supabase project URL and API keys are available in the [Supabase project API settings](https://supabase.com/docs/guides/api/api-keys), and the PostgreSQL connection string is available from the [Supabase database connection guide](https://supabase.com/docs/guides/database/connecting-to-postgres).
+
+<a id="agents-server-env-ptbk-agents-server-database"></a>
+-   `PTBK_AGENTS_SERVER_DATABASE`: Database backend used by Agents Server. Use `supabase` for the current hosted setup or `sqlite` for a standalone local database.
+
+<a id="agents-server-env-ptbk-agents-server-sqlite-path"></a>
+-   `PTBK_AGENTS_SERVER_SQLITE_PATH`: SQLite database file used when `PTBK_AGENTS_SERVER_DATABASE=sqlite`. Defaults to `.promptbook/agents-server.sqlite` in the launch directory.
 
 <a id="agents-server-env-openai-api-key"></a>
 -   `OPENAI_API_KEY`: OpenAI API key used for Agents Server chat and agent execution. Create one in the [OpenAI API key settings](https://platform.openai.com/api-keys).

package/apps/agents-server/src/database/$provideSupabaseForServer.ts

@@ -1,5 +1,7 @@
 import { $isRunningInNode } from '@promptbook-local/utils';
 import { createClient, SupabaseClient } from '@supabase/supabase-js';
+import { isAgentsServerSqliteMode } from './agentsServerDatabaseMode';
+import { $provideLocalSqliteSupabase } from './sqlite/$provideLocalSqliteSupabase';
 import { AgentsServerDatabase } from './schema';
 
 /**
@@ -26,6 +28,10 @@ export function $provideSupabaseForServer(): SupabaseClient<AgentsServerDatabase
         );
     }
 
+    if (isAgentsServerSqliteMode()) {
+        return $provideLocalSqliteSupabase() as SupabaseClient<AgentsServerDatabase>;
+    }
+
     if (!supabase) {
         // Create a single supabase client for interacting with your database
         supabase = createClient<AgentsServerDatabase>(

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

@@ -0,0 +1,34 @@
+/**
+ * Environment variable selecting the Agents Server database backend.
+ */
+export const AGENTS_SERVER_DATABASE_ENV_NAME = 'PTBK_AGENTS_SERVER_DATABASE';
+
+/**
+ * Environment variable pointing to the standalone SQLite database file.
+ */
+export const AGENTS_SERVER_SQLITE_PATH_ENV_NAME = 'PTBK_AGENTS_SERVER_SQLITE_PATH';
+
+/**
+ * Supported Agents Server database backends.
+ */
+export type AgentsServerDatabaseMode = 'supabase' | 'sqlite';
+
+/**
+ * Resolves the configured Agents Server database backend.
+ */
+export function resolveAgentsServerDatabaseMode(): AgentsServerDatabaseMode {
+    const rawMode = process.env[AGENTS_SERVER_DATABASE_ENV_NAME]?.trim().toLowerCase();
+
+    if (rawMode === 'sqlite' || rawMode === 'local') {
+        return 'sqlite';
+    }
+
+    return 'supabase';
+}
+
+/**
+ * Returns whether the Agents Server is using the local SQLite backend.
+ */
+export function isAgentsServerSqliteMode(): boolean {
+    return resolveAgentsServerDatabaseMode() === 'sqlite';
+}