@promptbook/cli 0.113.0-9 → 0.114.0-0

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.113.0-9';
+export const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version = '0.114.0-0';
 
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.113.0-8`).
+ * It follows semantic versioning (e.g., `0.113.1-0`).
  *
  * @generated
  */

package/src/versions.txt

@@ -1173,3 +1173,10 @@
 0.113.0-5
 0.113.0-8
 0.113.0-9
+0.113.0-10
+0.113.0-11
+0.113.0-12
+0.113.0-14
+0.113.0
+0.113.1-0
+0.114.0-0

package/umd/apps/agents-server/src/constants/serverLimits.d.ts

@@ -27,7 +27,7 @@ export declare const DEFAULT_SPAWN_AGENT_RATE_LIMIT_WINDOW_MS: number;
  *
  * @private shared Agents Server constant
  */
-export declare const DEFAULT_LOCAL_AGENT_RUNNER_MAX_FAILED_ATTEMPTS = 3;
+export declare const DEFAULT_LOCAL_AGENT_RUNNER_MAX_FAILED_ATTEMPTS = 1;
 /**
  * Default maximum number of local runner harness instances allowed to answer queued messages at once.
  *

package/umd/apps/agents-server/src/database/sqlite/$provideAgentsServerSqliteDatabase.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Shape of the `better-sqlite3` module constructor loaded at runtime.
+ *
+ * @private internal SQLite utility of Agents Server
+ */
+export type BetterSqliteConstructor = new (path: string) => AgentsServerSqliteDatabase;
+/**
+ * Minimal `better-sqlite3` database surface shared by Agents Server SQLite utilities.
+ *
+ * @private internal SQLite utility of Agents Server
+ */
+export type AgentsServerSqliteDatabase = {
+    readonly pragma: (source: string) => unknown;
+    readonly exec: (source: string) => void;
+    readonly prepare: (source: string) => AgentsServerSqliteStatement;
+    readonly transaction: <TArguments extends ReadonlyArray<unknown>, TResult>(fn: (...args: TArguments) => TResult) => (...args: TArguments) => TResult;
+    readonly close?: () => void;
+};
+/**
+ * Minimal `better-sqlite3` prepared statement surface shared by Agents Server SQLite utilities.
+ *
+ * @private internal SQLite utility of Agents Server
+ */
+export type AgentsServerSqliteStatement = {
+    readonly reader?: boolean;
+    readonly all: (...values: ReadonlyArray<unknown>) => Array<Record<string, unknown>>;
+    readonly get: (...values: ReadonlyArray<unknown>) => Record<string, unknown> | undefined;
+    readonly run: (...values: ReadonlyArray<unknown>) => {
+        readonly changes: number;
+        readonly lastInsertRowid: number | bigint;
+    };
+};
+/**
+ * Opens and initializes one SQLite database file, caching the connection per path.
+ *
+ * @param databasePath - Absolute path of the SQLite database file.
+ * @returns Cached SQLite database connection.
+ *
+ * @private exported from Agents Server SQLite utilities
+ */
+export declare function $provideSqliteDatabaseAtPath(databasePath: string): AgentsServerSqliteDatabase;
+/**
+ * Opens the VPS-wide SQLite registry database.
+ *
+ * This database is owned by the super-admin and holds only VPS-level data,
+ * most importantly the `_Server` table listing all servers running on this VPS.
+ * Server-scoped data (agents, projects, metadata, users, ...) lives in isolated
+ * per-server databases provided by `$provideServerSqliteDatabase`.
+ *
+ * @returns Shared VPS registry SQLite database connection.
+ *
+ * @private exported from Agents Server SQLite utilities
+ */
+export declare function $provideVpsRegistrySqliteDatabase(): AgentsServerSqliteDatabase;
+/**
+ * Opens the isolated SQLite database of one server namespace.
+ *
+ * @param tablePrefix - Stable server namespace key, or an empty string for the default server.
+ * @returns Per-server SQLite database connection.
+ *
+ * @private exported from Agents Server SQLite utilities
+ */
+export declare function $provideServerSqliteDatabase(tablePrefix: string): AgentsServerSqliteDatabase;
+/**
+ * Closes all cached SQLite connections and resets adapter state for isolated tests.
+ *
+ * @private exported from Agents Server SQLite utilities
+ */
+export declare function $resetAgentsServerSqliteDatabaseForTests(): void;

package/umd/apps/agents-server/src/database/sqlite/localSqliteSupabase/ensureTable.d.ts

@@ -0,0 +1,7 @@
+import type { AgentsServerSqliteDatabase } from '../$provideAgentsServerSqliteDatabase';
+/**
+ * Ensures a table and all required columns exist.
+ *
+ * @private function of `$provideLocalSqliteSupabase`
+ */
+export declare function ensureTable(database: AgentsServerSqliteDatabase, tableName: string, requiredColumns: ReadonlyArray<string>): void;

package/umd/apps/agents-server/src/database/sqlite/localSqliteSupabase/localSqliteSql.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Quotes one SQLite identifier.
+ *
+ * @private function of `$provideLocalSqliteSupabase`
+ */
+export declare function quoteIdentifier(identifier: string): string;
+/**
+ * Creates a safe identifier suffix for generated index names.
+ *
+ * @private function of `$provideLocalSqliteSupabase`
+ */
+export declare function sanitizeSqlIdentifier(identifier: string): string;
+/**
+ * Creates a select expression from parsed columns.
+ *
+ * @private function of `$provideLocalSqliteSupabase`
+ */
+export declare function createSelectExpression(columns: ReadonlyArray<string>): string;
+/**
+ * Parses a simple Supabase select column list.
+ *
+ * @private function of `$provideLocalSqliteSupabase`
+ */
+export declare function parseSelectedColumns(columns: string): Array<string>;
+/**
+ * Deduplicates strings while preserving order.
+ *
+ * @private function of `$provideLocalSqliteSupabase`
+ */
+export declare function uniqueStrings(values: ReadonlyArray<string>): Array<string>;

package/umd/apps/agents-server/src/database/sqlite/localSqliteSupabase/localSqliteTableSchema.d.ts

@@ -0,0 +1,76 @@
+import type { LocalSqliteUpsertOptions } from './localSqliteTypes';
+/**
+ * Read index definition for hot SQLite queries.
+ *
+ * @private type of `$provideLocalSqliteSupabase`
+ */
+export type LocalSqliteReadIndex = {
+    readonly name: string;
+    readonly columns: ReadonlyArray<string>;
+};
+/**
+ * Resolves a table base name from the actual prefixed table name.
+ *
+ * @private function of `$provideLocalSqliteSupabase`
+ */
+export declare function resolveTableBaseName(tableName: string): string;
+/**
+ * Resolves columns participating in known unique indexes.
+ *
+ * @private function of `$provideLocalSqliteSupabase`
+ */
+export declare function resolveUniqueIndexColumns(tableBaseName: string): Array<string>;
+/**
+ * Resolves columns participating in known read indexes.
+ *
+ * @private function of `$provideLocalSqliteSupabase`
+ */
+export declare function resolveReadIndexColumns(tableBaseName: string): Array<string>;
+/**
+ * Resolves upsert conflict columns.
+ *
+ * @private function of `$provideLocalSqliteSupabase`
+ */
+export declare function resolveUpsertConflictColumns(tableBaseName: string, options: LocalSqliteUpsertOptions): ReadonlyArray<string>;
+/**
+ * Resolves the unique index definitions declared for a table base name.
+ *
+ * @private function of `$provideLocalSqliteSupabase`
+ */
+export declare function resolveUniqueIndexes(tableBaseName: string): ReadonlyArray<ReadonlyArray<string>>;
+/**
+ * Resolves the read index definitions declared for a table base name.
+ *
+ * @private function of `$provideLocalSqliteSupabase`
+ */
+export declare function resolveReadIndexes(tableBaseName: string): ReadonlyArray<LocalSqliteReadIndex>;
+/**
+ * Resolves whether a column is JSON for a specific table.
+ *
+ * @private function of `$provideLocalSqliteSupabase`
+ */
+export declare function isJsonColumn(tableName: string, column: string): boolean;
+/**
+ * Resolves whether a column should be forced to a string for a specific table.
+ *
+ * @private function of `$provideLocalSqliteSupabase`
+ */
+export declare function isTextColumn(tableName: string, column: string): boolean;
+/**
+ * Resolves whether a column is a boolean stored as an integer.
+ *
+ * @private function of `$provideLocalSqliteSupabase`
+ */
+export declare function isBooleanColumn(column: string): boolean;
+/**
+ * Resolves whether a table base name uses a text primary key.
+ *
+ * @private function of `$provideLocalSqliteSupabase`
+ */
+export declare function isTextPrimaryKeyTable(tableBaseName: string): boolean;
+/**
+ * Resolves SQLite column affinity for dynamically added columns.
+ *
+ * @private function of `$provideLocalSqliteSupabase`
+ */
+export declare function resolveSqliteColumnType(tableBaseName: string, column: string): string;

package/umd/apps/agents-server/src/database/sqlite/resolveAgentsServerSqliteDatabasePath.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Resolves the SQLite database path used by the standalone backend.
+ */
+export declare function resolveAgentsServerSqliteDatabasePath(): string;

package/umd/apps/agents-server/src/database/sqlite/resolveServerSqliteDatabasePath.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Database key used for requests that do not belong to any registered server,
+ * for example localhost development traffic before any server is registered.
+ *
+ * @private internal SQLite utility of Agents Server
+ */
+export declare const DEFAULT_SERVER_SQLITE_DATABASE_KEY = "default";
+/**
+ * Resolves the isolated SQLite database file path for one server namespace.
+ *
+ * Each registered server has its own SQLite database file so servers on one VPS
+ * cannot leak agents, projects, metadata or any other data into each other.
+ *
+ * @param tablePrefix - Stable server namespace key such as `server_ClientA_`, or an empty string for the default server.
+ * @returns Absolute path of the per-server SQLite database file.
+ *
+ * @private internal SQLite utility of Agents Server
+ */
+export declare function resolveServerSqliteDatabasePath(tablePrefix: string): string;
+/**
+ * Converts one server table prefix into a safe database file key.
+ *
+ * @param tablePrefix - Stable server namespace key, or an empty string for the default server.
+ * @returns Validated file-name-safe database key.
+ *
+ * @private internal SQLite utility of Agents Server
+ */
+export declare function resolveServerSqliteDatabaseKey(tablePrefix: string): string;

package/umd/apps/agents-server/src/database/sqlite/standaloneServerRegistryStore.d.ts

@@ -0,0 +1,110 @@
+import { type ServerEnvironment, type ServerRecord } from '../../utils/serverRegistry';
+/**
+ * Input accepted when registering one new standalone server.
+ */
+export type CreateStandaloneServerInput = {
+    /**
+     * Human-facing server name.
+     */
+    readonly name: string;
+    /**
+     * Environment group of the server.
+     */
+    readonly environment: ServerEnvironment;
+    /**
+     * Public domain of the server.
+     */
+    readonly domain: string;
+    /**
+     * Stable namespace key selecting the isolated per-server SQLite database.
+     */
+    readonly tablePrefix: string;
+};
+/**
+ * Editable fields of one standalone server registration.
+ */
+export type UpdateStandaloneServerInput = {
+    /**
+     * Replacement public domain.
+     */
+    readonly domain?: string;
+    /**
+     * Replacement human-facing name.
+     */
+    readonly name?: string;
+};
+/**
+ * Clears in-process registry caches so following reads hit the registry database.
+ *
+ * @private exported from the standalone server registry store
+ */
+export declare function invalidateStandaloneServerRegistryCache(): void;
+/**
+ * Lists all servers registered in the VPS registry database.
+ *
+ * Domains configured in the `SERVERS` environment variable that are not yet
+ * registered are automatically registered first, so a freshly installed VPS
+ * bootstraps its registry from the installer-provided domain list.
+ *
+ * @returns Registered servers ordered by name.
+ *
+ * @private exported from the standalone server registry store
+ */
+export declare function listStandaloneRegisteredServers(): Array<ServerRecord>;
+/**
+ * Lists the table prefixes of all registered servers using the short-lived cache.
+ *
+ * Used on the hot per-query path that routes prefixed table names to isolated
+ * per-server SQLite database files. Missing `SERVERS` domains are registered
+ * first (memoized on the raw environment value), so even standalone CLI
+ * processes — for example the installer's default-agent seeding — route into
+ * the correct per-server database before the web server ever booted.
+ *
+ * @returns Known non-empty server table prefixes.
+ *
+ * @private exported from the standalone server registry store
+ */
+export declare function listStandaloneServerTablePrefixes(): Array<string>;
+/**
+ * Finds one registered standalone server by its registry id.
+ *
+ * @param serverId - Registry row id.
+ * @returns Matching server or `null`.
+ *
+ * @private exported from the standalone server registry store
+ */
+export declare function getStandaloneServerById(serverId: number): ServerRecord | null;
+/**
+ * Registers one new standalone server in the VPS registry database.
+ *
+ * @param input - New server registration values.
+ * @returns Created registry row.
+ *
+ * @private exported from the standalone server registry store
+ */
+export declare function createStandaloneServer(input: CreateStandaloneServerInput): ServerRecord;
+/**
+ * Updates the editable fields of one registered standalone server.
+ *
+ * The server keeps its id and table prefix, so its isolated per-server database
+ * (agents, projects, metadata, users, ...) survives domain and name changes.
+ *
+ * @param serverId - Registry row id.
+ * @param input - Replacement values.
+ * @returns Updated registry row.
+ *
+ * @private exported from the standalone server registry store
+ */
+export declare function updateStandaloneServer(serverId: number, input: UpdateStandaloneServerInput): ServerRecord;
+/**
+ * Removes one standalone server registration from the VPS registry database.
+ *
+ * Note: The isolated per-server SQLite database file is intentionally kept on
+ * disk so deleting a registration never silently destroys server data.
+ *
+ * @param serverId - Registry row id.
+ * @returns Removed registry row.
+ *
+ * @private exported from the standalone server registry store
+ */
+export declare function deleteStandaloneServer(serverId: number): ServerRecord;

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

@@ -0,0 +1,40 @@
+/**
+ * Host used for local project runtimes.
+ */
+export declare const AGENT_PROJECT_RUNTIME_HOST = "127.0.0.1";
+/**
+ * Command used to run a project that declares an npm `dev` script.
+ */
+export declare const AGENT_PROJECT_RUNTIME_DEFAULT_DEV_COMMAND = "npm run dev";
+/**
+ * Time spent waiting for a freshly spawned dev command to start listening.
+ */
+export declare const AGENT_PROJECT_RUNTIME_START_TIMEOUT_MS = 15000;
+/**
+ * Polling interval while waiting for a freshly spawned dev command to bind its port.
+ */
+export declare const AGENT_PROJECT_RUNTIME_START_POLL_INTERVAL_MS = 250;
+/**
+ * Maximum time spent waiting for a terminated runtime port to close.
+ */
+export declare const AGENT_PROJECT_RUNTIME_STOP_TIMEOUT_MS = 5000;
+/**
+ * Polling interval while waiting for a terminated runtime port to close.
+ */
+export declare const AGENT_PROJECT_RUNTIME_STOP_POLL_INTERVAL_MS = 100;
+/**
+ * Environment variable containing the local Agents Server origin for local agent runners.
+ */
+export declare const PTBK_AGENTS_SERVER_URL_ENV = "PTBK_AGENTS_SERVER_URL";
+/**
+ * Environment variable containing the internal worker token for local agent runners.
+ */
+export declare const PTBK_AGENTS_SERVER_USER_CHAT_WORKER_TOKEN_ENV = "PTBK_AGENTS_SERVER_USER_CHAT_WORKER_TOKEN";
+/**
+ * Header used by internal local-runner routes.
+ */
+export declare const USER_CHAT_WORKER_TOKEN_HEADER = "x-user-chat-worker-token";
+/**
+ * Header emitted by the project-runtime auth route with the approved local runtime port.
+ */
+export declare const AGENT_PROJECT_RUNTIME_AUTH_RESPONSE_PORT_HEADER = "X-Promptbook-Agent-Project-Port";

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

@@ -0,0 +1,13 @@
+/**
+ * Builds the deterministic per-server table prefix from a normalized domain.
+ *
+ * The prefix doubles as the stable namespace key of one server:
+ * - In Supabase mode it prefixes the server tables inside the shared database.
+ * - In standalone SQLite mode it selects the isolated per-server database file.
+ *
+ * Note: Keep in sync with `build_domain_table_prefix` in `install.sh`.
+ *
+ * @param domain - Normalized server domain such as `client.example.com`.
+ * @returns Prefix such as `server_client_example_com_`.
+ */
+export declare function buildDomainTablePrefix(domain: string): string;

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

@@ -68,7 +68,11 @@ export declare function listRegisteredServersUsingServiceRole(options?: {
 /**
  * Loads virtual server records from the comma-separated `SERVERS` environment variable.
  *
- * @returns Server records with deterministic table prefixes from the configured server prefix or normalized domains.
+ * Every domain gets its own deterministic domain-derived table prefix so servers can
+ * never share one namespace. The configured `SUPABASE_TABLE_PREFIX` is honored only
+ * for a single-domain setup where no ambiguity exists.
+ *
+ * @returns Server records with per-domain deterministic table prefixes.
  */
 export declare function listEnvironmentRegisteredServers(): Array<ServerRecord>;
 /**