@promptbook/cli 0.114.0-2 → 0.114.0-4

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/scripts/run-agent-chat/runCoderPing.d.ts

@@ -1,48 +0,0 @@
-import type { ThinkingLevel } from '../../src/cli/cli-commands/coder/ThinkingLevel';
-import type { PromptRunnerHarnessName } from '../../src/cli/cli-commands/common/promptRunnerCliOptions';
-/**
- * Options for one `ptbk coder ping` execution.
- */
-export type RunCoderPingOptions = {
-    /**
-     * Harness used for the disposable turn.
-     */
-    readonly agentName: PromptRunnerHarnessName;
-    /**
-     * Optional model passed to the harness.
-     */
-    readonly model?: string;
-    /**
-     * Optional reasoning effort passed to the harness.
-     */
-    readonly thinkingLevel?: ThinkingLevel;
-    /**
-     * Whether the harness should receive the shared no-UI option.
-     */
-    readonly isUiDisabled: boolean;
-    /**
-     * Whether the harness may spend credits when its quota is exhausted.
-     */
-    readonly isCreditsAllowed: boolean;
-};
-/**
- * Result of one `ptbk coder ping` execution.
- */
-export type CoderPingResult = {
-    /**
-     * Text returned by the harness after the dummy task.
-     */
-    readonly result: string;
-    /**
-     * Time spent executing the disposable harness turn in milliseconds.
-     */
-    readonly elapsedTimeMs: number;
-};
-/**
- * Runs one small harness/model turn in a disposable temporary project.
- *
- * The temporary project is outside the caller's repository, so even a harness
- * that writes files cannot change the project from which `ptbk coder ping` was
- * started.
- */
-export declare function runCoderPing(options: RunCoderPingOptions): Promise<CoderPingResult>;

package/umd/src/book-2.0/agent-source/createAgentModelRequirements.useCommitmentAggregation.test.d.ts

@@ -1 +0,0 @@
-export {};

package/umd/src/commitments/MEMORY/MEMORY.d.ts

@@ -1,48 +0,0 @@
-import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
-import type { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
-import type { string_javascript_name } from '../../types/string_person_fullname';
-import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
-export type { MemoryToolRecord, MemoryToolRuntimeAdapter, MemoryToolRuntimeContext } from './MemoryToolRuntimeAdapter';
-export { setMemoryToolRuntimeAdapter } from './setMemoryToolRuntimeAdapter';
-/**
- * MEMORY commitment definition
- *
- * The MEMORY commitment is similar to KNOWLEDGE but has a focus on remembering past
- * interactions and user preferences. It helps the agent maintain context about the
- * user's history, preferences, and previous conversations.
- *
- * Example usage in agent source:
- *
- * ```book
- * MEMORY User prefers detailed technical explanations
- * MEMORY Previously worked on React projects
- * MEMORY Timezone: UTC-5 (Eastern Time)
- * ```
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare class MemoryCommitmentDefinition extends BaseCommitmentDefinition<'MEMORY' | 'MEMORIES'> {
-    constructor(type?: 'MEMORY' | 'MEMORIES');
-    get requiresContent(): boolean;
-    /**
-     * Short one-line description of MEMORY.
-     */
-    get description(): string;
-    /**
-     * Icon for this commitment.
-     */
-    get icon(): string;
-    /**
-     * Markdown documentation for MEMORY commitment.
-     */
-    get documentation(): string;
-    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
-    /**
-     * Gets human-readable titles for MEMORY tool functions.
-     */
-    getToolTitles(): Record<string_javascript_name, string>;
-    /**
-     * Gets MEMORY tool function implementations.
-     */
-    getToolFunctions(): Record<string_javascript_name, ToolFunction>;
-}

package/umd/src/commitments/MEMORY/MEMORY.test.d.ts

@@ -1 +0,0 @@
-export {};

package/umd/src/commitments/MEMORY/MemoryToolNames.d.ts

@@ -1,11 +0,0 @@
-/**
- * Names of tools used by the MEMORY commitment.
- *
- * @private function of MemoryCommitmentDefinition
- */
-export declare const MemoryToolNames: {
-    readonly retrieve: string;
-    readonly store: string;
-    readonly update: string;
-    readonly delete: string;
-};

package/umd/src/commitments/MEMORY/MemoryToolRuntimeAdapter.d.ts

@@ -1,149 +0,0 @@
-import type { TODO_any } from '../../utils/organization/TODO_any';
-/**
- * Tool arguments for retrieving memory.
- *
- * @private type of MemoryCommitmentDefinition
- */
-export type RetrieveMemoryToolArgs = {
-    query?: string;
-    limit?: number;
-    [key: string]: TODO_any;
-};
-/**
- * Tool arguments for storing memory.
- *
- * @private type of MemoryCommitmentDefinition
- */
-export type StoreMemoryToolArgs = {
-    content?: string;
-    isGlobal?: boolean;
-    [key: string]: TODO_any;
-};
-/**
- * Tool arguments for updating memory.
- *
- * @private type of MemoryCommitmentDefinition
- */
-export type UpdateMemoryToolArgs = {
-    memoryId?: string;
-    content?: string;
-    isGlobal?: boolean;
-    [key: string]: TODO_any;
-};
-/**
- * Tool arguments for deleting memory.
- *
- * @private type of MemoryCommitmentDefinition
- */
-export type DeleteMemoryToolArgs = {
-    memoryId?: string;
-    [key: string]: TODO_any;
-};
-/**
- * Memory record returned by runtime adapters.
- *
- * @private type of MemoryCommitmentDefinition
- */
-export type MemoryToolRecord = {
-    id?: string;
-    content: string;
-    isGlobal: boolean;
-    createdAt?: string;
-    updatedAt?: string;
-};
-/**
- * Runtime context for MEMORY tools resolved from hidden tool arguments.
- *
- * @private type of MemoryCommitmentDefinition
- */
-export type MemoryToolRuntimeContext = {
-    readonly enabled: boolean;
-    readonly userId?: number;
-    readonly username?: string;
-    readonly agentId?: string;
-    readonly agentName?: string;
-    readonly isTeamConversation: boolean;
-    readonly isPrivateMode: boolean;
-};
-/**
- * Result payload returned by retrieve memory tool.
- *
- * @private type of MemoryCommitmentDefinition
- */
-export type RetrieveMemoryToolResult = {
-    action: 'retrieve';
-    status: 'ok' | 'disabled' | 'error';
-    query?: string;
-    memories: MemoryToolRecord[];
-    message?: string;
-};
-/**
- * Result payload returned by store memory tool.
- *
- * @private type of MemoryCommitmentDefinition
- */
-export type StoreMemoryToolResult = {
-    action: 'store';
-    status: 'stored' | 'disabled' | 'error';
-    memory?: MemoryToolRecord;
-    message?: string;
-};
-/**
- * Result payload returned by update memory tool.
- *
- * @private type of MemoryCommitmentDefinition
- */
-export type UpdateMemoryToolResult = {
-    action: 'update';
-    status: 'updated' | 'disabled' | 'error';
-    memory?: MemoryToolRecord;
-    message?: string;
-};
-/**
- * Result payload returned by delete memory tool.
- *
- * @private type of MemoryCommitmentDefinition
- */
-export type DeleteMemoryToolResult = {
-    action: 'delete';
-    status: 'deleted' | 'disabled' | 'error';
-    memoryId?: string;
-    message?: string;
-};
-/**
- * Union of all MEMORY tool actions.
- *
- * @private type of MemoryCommitmentDefinition
- */
-export type MemoryToolAction = RetrieveMemoryToolResult['action'] | StoreMemoryToolResult['action'] | UpdateMemoryToolResult['action'] | DeleteMemoryToolResult['action'];
-/**
- * Union of all MEMORY tool result payloads.
- *
- * @private type of MemoryCommitmentDefinition
- */
-export type MemoryToolResult = RetrieveMemoryToolResult | StoreMemoryToolResult | UpdateMemoryToolResult | DeleteMemoryToolResult;
-/**
- * Runtime adapter interface used by MEMORY tools.
- *
- * @private type of MemoryCommitmentDefinition
- */
-export type MemoryToolRuntimeAdapter = {
-    retrieveMemories(args: {
-        query?: string;
-        limit?: number;
-    }, runtimeContext: MemoryToolRuntimeContext): Promise<MemoryToolRecord[]>;
-    storeMemory(args: {
-        content: string;
-        isGlobal: boolean;
-    }, runtimeContext: MemoryToolRuntimeContext): Promise<MemoryToolRecord>;
-    updateMemory(args: {
-        memoryId: string;
-        content: string;
-        isGlobal?: boolean;
-    }, runtimeContext: MemoryToolRuntimeContext): Promise<MemoryToolRecord>;
-    deleteMemory(args: {
-        memoryId: string;
-    }, runtimeContext: MemoryToolRuntimeContext): Promise<{
-        id?: string;
-    }>;
-};

package/umd/src/commitments/MEMORY/createMemorySystemMessage.d.ts

@@ -1,6 +0,0 @@
-/**
- * Builds the MEMORY instruction block appended to the system message.
- *
- * @private function of MemoryCommitmentDefinition
- */
-export declare function createMemorySystemMessage(extraInstructions: string): string;

package/umd/src/commitments/MEMORY/createMemoryToolFunctions.d.ts

@@ -1,8 +0,0 @@
-import type { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
-import type { string_javascript_name } from '../../types/string_person_fullname';
-/**
- * Gets MEMORY tool function implementations.
- *
- * @private function of MemoryCommitmentDefinition
- */
-export declare function createMemoryToolFunctions(): Record<string_javascript_name, ToolFunction>;

package/umd/src/commitments/MEMORY/createMemoryTools.d.ts

@@ -1,14 +0,0 @@
-import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
-/**
- * Concrete type of tool definitions in `AgentModelRequirements`.
- *
- * @private type of MemoryCommitmentDefinition
- */
-type AgentModelTools = NonNullable<AgentModelRequirements['tools']>;
-/**
- * Creates MEMORY tool definitions while preserving already-registered tools.
- *
- * @private function of MemoryCommitmentDefinition
- */
-export declare function createMemoryTools(existingTools: AgentModelRequirements['tools']): AgentModelTools;
-export {};

package/umd/src/commitments/MEMORY/getMemoryCommitmentDocumentation.d.ts

@@ -1,6 +0,0 @@
-/**
- * Markdown documentation for MEMORY commitment.
- *
- * @private function of MemoryCommitmentDefinition
- */
-export declare function getMemoryCommitmentDocumentation(type: 'MEMORY' | 'MEMORIES'): string;

package/umd/src/commitments/MEMORY/getMemoryToolRuntimeAdapterOrDisabledResult.d.ts

@@ -1,17 +0,0 @@
-import type { DeleteMemoryToolResult, MemoryToolAction, MemoryToolRuntimeAdapter, MemoryToolRuntimeContext, RetrieveMemoryToolResult, StoreMemoryToolResult, UpdateMemoryToolResult } from './MemoryToolRuntimeAdapter';
-/**
- * Return type of MEMORY adapter resolution helper.
- *
- * @private type of MemoryCommitmentDefinition
- */
-type MemoryToolRuntimeAdapterResolution = {
-    adapter: MemoryToolRuntimeAdapter | null;
-    disabledResult: RetrieveMemoryToolResult | StoreMemoryToolResult | UpdateMemoryToolResult | DeleteMemoryToolResult | null;
-};
-/**
- * Gets the runtime adapter and returns a disabled result when unavailable.
- *
- * @private function of MemoryCommitmentDefinition
- */
-export declare function getMemoryToolRuntimeAdapterOrDisabledResult(action: MemoryToolAction, runtimeContext: MemoryToolRuntimeContext): MemoryToolRuntimeAdapterResolution;
-export {};

package/umd/src/commitments/MEMORY/getMemoryToolTitles.d.ts

@@ -1,7 +0,0 @@
-import type { string_javascript_name } from '../../types/string_person_fullname';
-/**
- * Gets human-readable titles for MEMORY tool functions.
- *
- * @private function of MemoryCommitmentDefinition
- */
-export declare function getMemoryToolTitles(): Record<string_javascript_name, string>;