@promptbook/cli 0.114.0-29 → 0.114.0-30

package/umd/scripts/run-codex-prompts/runners/openai-codex/buildCodexUsageFromOutput.d.ts

@@ -6,5 +6,8 @@ import type { Usage } from '../../../../src/execution/Usage';
 export declare const DEFAULT_CODEX_COMPLETION_SHARE = 0.1;
 /**
  * Builds usage stats from Codex CLI output.
+ *
+ * The `modelName` is omitted when Codex ran without a model override, in which case only Codex knows which
+ * model it picked and the price can be estimated from the fallback pricing alone.
  */
-export declare function buildCodexUsageFromOutput(output: string, modelName: string): Usage;
+export declare function buildCodexUsageFromOutput(output: string, modelName: string | undefined): Usage;

package/umd/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.114.0-28`).
+ * It follows semantic versioning (e.g., `0.114.0-29`).
  *
  * @generated
  */

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

@@ -1,69 +0,0 @@
-/**
- * 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/esm/apps/agents-server/src/database/sqlite/localSqliteSupabase/ensureTable.d.ts

@@ -1,7 +0,0 @@
-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/esm/apps/agents-server/src/database/sqlite/localSqliteSupabase/localSqliteSql.d.ts

@@ -1,30 +0,0 @@
-/**
- * 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/esm/apps/agents-server/src/database/sqlite/localSqliteSupabase/localSqliteTableSchema.d.ts

@@ -1,76 +0,0 @@
-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/esm/apps/agents-server/src/database/sqlite/resolveAgentsServerSqliteDatabasePath.d.ts

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

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

@@ -1,28 +0,0 @@
-/**
- * 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/esm/apps/agents-server/src/database/sqlite/standaloneServerRegistryStore.d.ts

@@ -1,110 +0,0 @@
-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/database/sqlite/$provideAgentsServerSqliteDatabase.d.ts

@@ -1,69 +0,0 @@
-/**
- * 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

@@ -1,7 +0,0 @@
-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

@@ -1,30 +0,0 @@
-/**
- * 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

@@ -1,76 +0,0 @@
-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

@@ -1,4 +0,0 @@
-/**
- * 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

@@ -1,28 +0,0 @@
-/**
- * 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;