@promptbook/cli 0.114.0-3 → 0.114.0-31

package/src/commitments/WALLET/parseWalletToolArgs.ts

@@ -1,231 +0,0 @@
-import type {
-    DeleteWalletRecordToolArgs,
-    RequestWalletRecordToolArgs,
-    RetrieveWalletRecordsToolArgs,
-    StoreWalletRecordToolArgs,
-    UpdateWalletRecordToolArgs,
-    WalletRecordType,
-    WalletRequestRecord,
-    WalletToolRecord,
-} from './WalletToolRuntimeAdapter';
-
-/**
- * Parsed payload for retrieving wallet records.
- *
- * @private type of WalletCommitmentDefinition
- */
-type ParsedRetrieveWalletRecordsArgs = {
-    query?: string;
-    recordType?: WalletRecordType;
-    service?: string;
-    key?: string;
-    limit?: number;
-};
-
-/**
- * Parsed payload for updating an existing wallet record.
- *
- * @private type of WalletCommitmentDefinition
- */
-type ParsedUpdateWalletRecordArgs = WalletToolRecord & {
-    walletId: string;
-};
-
-/**
- * Parses store/update wallet payload.
- *
- * @private function of WalletCommitmentDefinition
- */
-function parseWalletPayload(args: StoreWalletRecordToolArgs): WalletToolRecord {
-    const recordType = parseWalletRecordType(args.recordType);
-    return {
-        recordType,
-        service: parseWalletService(args.service),
-        key: parseWalletKey(args.key),
-        isUserScoped: args.isUserScoped === true,
-        isGlobal: args.isGlobal === true,
-        ...parseWalletSecrets({
-            recordType,
-            username: args.username,
-            password: args.password,
-            secret: args.secret,
-            cookies: args.cookies,
-        }),
-    };
-}
-
-/**
- * Parses text argument and returns trimmed text when available.
- *
- * @private function of WalletCommitmentDefinition
- */
-function normalizeOptionalText(value: unknown): string | undefined {
-    if (typeof value !== 'string') {
-        return undefined;
-    }
-
-    const trimmed = value.trim();
-    return trimmed || undefined;
-}
-
-/**
- * Parses wallet service argument.
- *
- * @private function of WalletCommitmentDefinition
- */
-function parseWalletService(value: unknown): string {
-    return (normalizeOptionalText(value) || 'generic').toLowerCase();
-}
-
-/**
- * Parses wallet key argument.
- *
- * @private function of WalletCommitmentDefinition
- */
-function parseWalletKey(value: unknown): string {
-    return normalizeOptionalText(value) || 'default';
-}
-
-/**
- * Parses one wallet record id argument.
- *
- * @private function of WalletCommitmentDefinition
- */
-function parseWalletId(value: unknown): string {
-    const walletId = normalizeOptionalText(value);
-    if (!walletId) {
-        throw new Error('Wallet id is required.');
-    }
-    return walletId;
-}
-
-/**
- * Parses wallet record type.
- *
- * @private function of WalletCommitmentDefinition
- */
-function parseWalletRecordType(value: unknown, fallback?: WalletRecordType): WalletRecordType {
-    const normalizedType = normalizeOptionalText(value)?.toUpperCase();
-
-    if (normalizedType === 'USERNAME_PASSWORD') {
-        return 'USERNAME_PASSWORD';
-    }
-    if (normalizedType === 'SESSION_COOKIE') {
-        return 'SESSION_COOKIE';
-    }
-    if (normalizedType === 'ACCESS_TOKEN') {
-        return 'ACCESS_TOKEN';
-    }
-    if (fallback) {
-        return fallback;
-    }
-
-    throw new Error('Unsupported wallet recordType. Expected one of: USERNAME_PASSWORD, SESSION_COOKIE, ACCESS_TOKEN.');
-}
-
-/**
- * Parses wallet secret fields according to record type.
- *
- * @private function of WalletCommitmentDefinition
- */
-function parseWalletSecrets(args: {
-    recordType: WalletRecordType;
-    username?: unknown;
-    password?: unknown;
-    secret?: unknown;
-    cookies?: unknown;
-}): {
-    username?: string;
-    password?: string;
-    secret?: string;
-    cookies?: string;
-} {
-    const username = normalizeOptionalText(args.username);
-    const password = normalizeOptionalText(args.password);
-    const secret = normalizeOptionalText(args.secret);
-    const cookies = normalizeOptionalText(args.cookies);
-
-    if (args.recordType === 'USERNAME_PASSWORD') {
-        if (!username || !password) {
-            throw new Error('Both username and password are required for USERNAME_PASSWORD.');
-        }
-        return { username, password };
-    }
-
-    if (args.recordType === 'SESSION_COOKIE') {
-        if (!cookies) {
-            throw new Error('Cookies are required for SESSION_COOKIE.');
-        }
-        return { cookies };
-    }
-
-    if (!secret) {
-        throw new Error('Secret is required for ACCESS_TOKEN.');
-    }
-
-    return { secret };
-}
-
-/**
- * Collection of WALLET tool argument parsers.
- *
- * @private function of WalletCommitmentDefinition
- */
-export const parseWalletToolArgs = {
-    /**
-     * Parses retrieve arguments.
-     */
-    retrieve(args: RetrieveWalletRecordsToolArgs): ParsedRetrieveWalletRecordsArgs {
-        const limit =
-            typeof args.limit === 'number' && Number.isFinite(args.limit) ? Math.floor(args.limit) : undefined;
-
-        return {
-            query: normalizeOptionalText(args.query),
-            recordType: normalizeOptionalText(args.recordType) ? parseWalletRecordType(args.recordType) : undefined,
-            service: normalizeOptionalText(args.service) ? parseWalletService(args.service) : undefined,
-            key: normalizeOptionalText(args.key) ? parseWalletKey(args.key) : undefined,
-            limit: limit && limit > 0 ? Math.min(limit, 20) : undefined,
-        };
-    },
-
-    /**
-     * Parses store payload.
-     */
-    store(args: StoreWalletRecordToolArgs): WalletToolRecord {
-        return parseWalletPayload(args);
-    },
-
-    /**
-     * Parses update payload.
-     */
-    update(args: UpdateWalletRecordToolArgs): ParsedUpdateWalletRecordArgs {
-        const walletId = parseWalletId(args.walletId);
-        const record = parseWalletPayload(args);
-
-        return {
-            ...record,
-            walletId,
-        };
-    },
-
-    /**
-     * Parses delete payload.
-     */
-    delete(args: DeleteWalletRecordToolArgs): { walletId: string } {
-        return { walletId: parseWalletId(args.walletId) };
-    },
-
-    /**
-     * Parses request payload for user wallet input prompt.
-     */
-    request(args: RequestWalletRecordToolArgs): WalletRequestRecord {
-        return {
-            recordType: parseWalletRecordType(args.recordType, 'ACCESS_TOKEN'),
-            service: parseWalletService(args.service),
-            key: parseWalletKey(args.key),
-            message: normalizeOptionalText(args.message),
-            isUserScoped: args.isUserScoped === true,
-            isGlobal: args.isGlobal === true,
-        };
-    },
-};

package/src/commitments/WALLET/resolveWalletRuntimeContext.ts

@@ -1,23 +0,0 @@
-import type { TODO_any } from '../../utils/organization/TODO_any';
-import { readToolRuntimeContextFromToolArgs } from '../_common/toolRuntimeContext';
-import type { WalletToolRuntimeContext } from './WalletToolRuntimeAdapter';
-
-/**
- * Resolves runtime context from hidden tool arguments.
- *
- * @private function of WalletCommitmentDefinition
- */
-export function resolveWalletRuntimeContext(args: Record<string, TODO_any>): WalletToolRuntimeContext {
-    const runtimeContext = readToolRuntimeContextFromToolArgs(args);
-    const memoryContext = runtimeContext?.memory;
-
-    return {
-        enabled: memoryContext?.enabled === true,
-        userId: memoryContext?.userId,
-        username: memoryContext?.username,
-        agentId: memoryContext?.agentId,
-        agentName: memoryContext?.agentName,
-        isTeamConversation: memoryContext?.isTeamConversation === true,
-        isPrivateMode: memoryContext?.isPrivateMode === true,
-    };
-}

package/src/commitments/WALLET/setWalletToolRuntimeAdapter.ts

@@ -1,26 +0,0 @@
-import type { WalletToolRuntimeAdapter } from './WalletToolRuntimeAdapter';
-
-/**
- * Process-wide runtime adapter reference used by wallet tools.
- *
- * @private state of WalletCommitmentDefinition
- */
-let walletToolRuntimeAdapter: WalletToolRuntimeAdapter | null = null;
-
-/**
- * Sets runtime adapter used by WALLET tools.
- *
- * @private function of WalletCommitmentDefinition
- */
-export function setWalletToolRuntimeAdapter(adapter: WalletToolRuntimeAdapter | null): void {
-    walletToolRuntimeAdapter = adapter;
-}
-
-/**
- * Gets runtime adapter used by WALLET tools.
- *
- * @private function of WalletCommitmentDefinition
- */
-export function getWalletToolRuntimeAdapter(): WalletToolRuntimeAdapter | null {
-    return walletToolRuntimeAdapter;
-}

package/src/commitments/_common/createSerpSearchToolFunction.ts

@@ -1,46 +0,0 @@
-import { spaceTrim } from 'spacetrim';
-import type { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
-import { SerpSearchEngine } from '../../search-engines/serp/SerpSearchEngine';
-import type { string_javascript_name } from '../../types/string_person_fullname';
-
-/**
- * Creates one SERP-backed tool function used as a local fallback for search-like commitments.
- *
- * @param toolName - Technical tool name used for validation messages.
- * @param resultLabel - Human-readable label used in formatted results.
- * @returns Async tool function compatible with commitment tool registration.
- *
- * @private internal helper for search-like commitments
- */
-export function createSerpSearchToolFunction(toolName: string_javascript_name, resultLabel: string): ToolFunction {
-    return async (rawArgs: Record<string, unknown>): Promise<string> => {
-        const { query, ...searchOptions } = rawArgs;
-
-        if (typeof query !== 'string' || !query.trim()) {
-            throw new Error(`${toolName} query is required`);
-        }
-
-        const searchEngine = new SerpSearchEngine();
-        const results = await searchEngine.search(query, searchOptions);
-
-        return spaceTrim(
-            (block) => `
-                ${resultLabel} results for "${query}"${
-                Object.keys(searchOptions).length === 0 ? '' : ` with options ${JSON.stringify(searchOptions)}`
-            }:
-
-                ${block(
-                    results
-                        .map((result) =>
-                            spaceTrim(`
-                                - **${result.title}**
-                                  ${result.url}
-                                  ${result.snippet}
-                            `),
-                        )
-                        .join('\n\n'),
-                )}
-            `,
-        );
-    };
-}

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;

package/umd/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/scripts/find-fresh-emoji-tags/utils/emojis.d.ts

@@ -1,16 +0,0 @@
-import type { string_char_emoji } from '../../../src/types/typeAliasEmoji';
-/**
- * All possible emoji chars like "🍆", "🍡", "🍤"...
- * Note: this will be needed to update annually - now updated at 2022-01-19
- *
- * @see https://getemoji.com/
- */
-export declare const EMOJIS_IN_CATEGORIES: Record<string, ReadonlyArray<string_char_emoji>>;
-/**
- * All possible emoji chars like "🍆", "🍡", "🍤", "🇨🇼", "🧑🏿‍❤️‍💋‍🧑🏻"...
- */
-export declare const EMOJIS: Set<string_char_emoji>;
-/**
- * Emojis which are single pictograms like "🍆", "🍡", "🍤"...
- */
-export declare const EMOJIS_OF_SINGLE_PICTOGRAM: Set<string_char_emoji>;

package/umd/scripts/run-codex-prompts/prompts/replacePromptTodoStatusLine.d.ts

@@ -1,7 +0,0 @@
-/**
- * Replaces the complete todo status line while preserving its indentation.
- *
- * The complete line is replaced because a todo status can contain a required
- * model/harness token in addition to priority markers.
- */
-export declare function replacePromptTodoStatusLine(line: string, replacementStatusLine: string): string;