@promptbook/cli 0.114.0-2 → 0.114.0-20

package/src/commitments/WALLET/WalletToolRuntimeAdapter.ts

@@ -1,180 +0,0 @@
-import type { TODO_any } from '../../utils/organization/TODO_any';
-
-/**
- * Supported wallet record types.
- *
- * @private type of WalletCommitmentDefinition
- */
-export type WalletRecordType = 'USERNAME_PASSWORD' | 'SESSION_COOKIE' | 'ACCESS_TOKEN';
-
-/**
- * Normalized wallet record payload used by runtime adapters.
- *
- * @private type of WalletCommitmentDefinition
- */
-export type WalletToolRecord = {
-    id?: string;
-    recordType: WalletRecordType;
-    service: string;
-    key: string;
-    username?: string | null;
-    password?: string | null;
-    secret?: string | null;
-    cookies?: string | null;
-    isUserScoped: boolean;
-    isGlobal: boolean;
-    createdAt?: string;
-    updatedAt?: string;
-};
-
-/**
- * Runtime context for wallet operations.
- *
- * @private type of WalletCommitmentDefinition
- */
-export type WalletToolRuntimeContext = {
-    readonly enabled: boolean;
-    readonly userId?: number;
-    readonly username?: string;
-    readonly agentId?: string;
-    readonly agentName?: string;
-    readonly isTeamConversation: boolean;
-    readonly isPrivateMode: boolean;
-};
-
-/**
- * Runtime adapter interface used by wallet tools.
- *
- * @private type of WalletCommitmentDefinition
- */
-export type WalletToolRuntimeAdapter = {
-    retrieveWalletRecords(
-        args: {
-            query?: string;
-            recordType?: WalletRecordType;
-            service?: string;
-            key?: string;
-            limit?: number;
-        },
-        runtimeContext: WalletToolRuntimeContext,
-    ): Promise<WalletToolRecord[]>;
-    storeWalletRecord(
-        args: WalletToolRecord & {
-            username?: string | null;
-            password?: string | null;
-            secret?: string | null;
-            cookies?: string | null;
-        },
-        runtimeContext: WalletToolRuntimeContext,
-    ): Promise<WalletToolRecord>;
-    updateWalletRecord(
-        args: WalletToolRecord & {
-            walletId: string;
-            username?: string | null;
-            password?: string | null;
-            secret?: string | null;
-            cookies?: string | null;
-        },
-        runtimeContext: WalletToolRuntimeContext,
-    ): Promise<WalletToolRecord>;
-    deleteWalletRecord(args: { walletId: string }, runtimeContext: WalletToolRuntimeContext): Promise<{ id?: string }>;
-};
-
-/**
- * Arguments accepted by `retrieve_wallet_records`.
- *
- * @private type of WalletCommitmentDefinition
- */
-export type RetrieveWalletRecordsToolArgs = {
-    query?: string;
-    recordType?: WalletRecordType;
-    service?: string;
-    key?: string;
-    limit?: number;
-    [key: string]: TODO_any;
-};
-
-/**
- * Arguments accepted by `store_wallet_record`.
- *
- * @private type of WalletCommitmentDefinition
- */
-export type StoreWalletRecordToolArgs = {
-    recordType?: WalletRecordType;
-    service?: string;
-    key?: string;
-    username?: string;
-    password?: string;
-    secret?: string;
-    cookies?: string;
-    isUserScoped?: boolean;
-    isGlobal?: boolean;
-    [key: string]: TODO_any;
-};
-
-/**
- * Arguments accepted by `update_wallet_record`.
- *
- * @private type of WalletCommitmentDefinition
- */
-export type UpdateWalletRecordToolArgs = StoreWalletRecordToolArgs & {
-    walletId?: string;
-};
-
-/**
- * Arguments accepted by `delete_wallet_record`.
- *
- * @private type of WalletCommitmentDefinition
- */
-export type DeleteWalletRecordToolArgs = {
-    walletId?: string;
-    [key: string]: TODO_any;
-};
-
-/**
- * Arguments accepted by `request_wallet_record`.
- *
- * @private type of WalletCommitmentDefinition
- */
-export type RequestWalletRecordToolArgs = {
-    recordType?: WalletRecordType;
-    service?: string;
-    key?: string;
-    message?: string;
-    isUserScoped?: boolean;
-    isGlobal?: boolean;
-    [key: string]: TODO_any;
-};
-
-/**
- * Parsed request payload for `request_wallet_record`.
- *
- * @private type of WalletCommitmentDefinition
- */
-export type WalletRequestRecord = {
-    recordType: WalletRecordType;
-    service: string;
-    key: string;
-    message?: string;
-    isUserScoped: boolean;
-    isGlobal: boolean;
-};
-
-/**
- * Runtime wallet-tool action name.
- *
- * @private type of WalletCommitmentDefinition
- */
-export type WalletRuntimeToolAction = 'retrieve' | 'store' | 'update' | 'delete';
-
-/**
- * Result payload returned when a runtime wallet action is disabled.
- *
- * @private type of WalletCommitmentDefinition
- */
-export type WalletDisabledToolResult = {
-    action: WalletRuntimeToolAction;
-    status: 'disabled';
-    records?: Array<never>;
-    message: string;
-};

package/src/commitments/WALLET/createWalletSystemMessage.ts

@@ -1,22 +0,0 @@
-import { spaceTrim } from 'spacetrim';
-import { WalletToolNames } from './WalletToolNames';
-
-/**
- * Creates WALLET system-message instructions.
- *
- * @private function of WalletCommitmentDefinition
- */
-export function createWalletSystemMessage(extraInstructions: string): string {
-    return spaceTrim(
-        (block) => `
-            Wallet:
-            - Use "${WalletToolNames.retrieve}" before authenticated operations.
-            - Use "${WalletToolNames.store}" and "${WalletToolNames.update}" to maintain credentials.
-            - Use "${WalletToolNames.delete}" to remove invalid credentials.
-            - Use "${WalletToolNames.request}" to request missing credentials via UI popup.
-            - Scope records by user (\`isUserScoped\`) and/or by agent (\`isGlobal=false\`) as needed.
-            - Never expose raw credentials in chat responses.
-            ${block(extraInstructions)}
-        `,
-    );
-}

package/src/commitments/WALLET/createWalletToolFunctions.ts

@@ -1,145 +0,0 @@
-import type { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
-import type { string_javascript_name } from '../../types/string_person_fullname';
-import {
-    getWalletToolRuntimeAdapterOrDisabledResult,
-    resolveWalletDisabledMessage,
-} from './getWalletToolRuntimeAdapterOrDisabledResult';
-import { parseWalletToolArgs } from './parseWalletToolArgs';
-import { resolveWalletRuntimeContext } from './resolveWalletRuntimeContext';
-import { WalletToolNames } from './WalletToolNames';
-import type {
-    DeleteWalletRecordToolArgs,
-    RequestWalletRecordToolArgs,
-    RetrieveWalletRecordsToolArgs,
-    StoreWalletRecordToolArgs,
-    UpdateWalletRecordToolArgs,
-} from './WalletToolRuntimeAdapter';
-
-/**
- * Creates runtime wallet tool function implementations.
- *
- * @private function of WalletCommitmentDefinition
- */
-export function createWalletToolFunctions(): Record<string_javascript_name, ToolFunction> {
-    return {
-        async [WalletToolNames.retrieve](args: RetrieveWalletRecordsToolArgs): Promise<string> {
-            const runtimeContext = resolveWalletRuntimeContext(args);
-            const { adapter, disabledResult } = getWalletToolRuntimeAdapterOrDisabledResult('retrieve', runtimeContext);
-
-            if (!adapter || disabledResult) {
-                return JSON.stringify(disabledResult);
-            }
-
-            try {
-                const parsedArgs = parseWalletToolArgs.retrieve(args);
-                const records = await adapter.retrieveWalletRecords(parsedArgs, runtimeContext);
-                return JSON.stringify({
-                    action: 'retrieve',
-                    status: 'ok',
-                    query: parsedArgs.query,
-                    records,
-                });
-            } catch (error) {
-                return JSON.stringify({
-                    action: 'retrieve',
-                    status: 'error',
-                    records: [],
-                    message: error instanceof Error ? error.message : String(error),
-                });
-            }
-        },
-        async [WalletToolNames.store](args: StoreWalletRecordToolArgs): Promise<string> {
-            const runtimeContext = resolveWalletRuntimeContext(args);
-            const { adapter, disabledResult } = getWalletToolRuntimeAdapterOrDisabledResult('store', runtimeContext);
-
-            if (!adapter || disabledResult) {
-                return JSON.stringify(disabledResult);
-            }
-
-            try {
-                const parsedArgs = parseWalletToolArgs.store(args);
-                const record = await adapter.storeWalletRecord(parsedArgs, runtimeContext);
-                return JSON.stringify({
-                    action: 'store',
-                    status: 'stored',
-                    record,
-                });
-            } catch (error) {
-                return JSON.stringify({
-                    action: 'store',
-                    status: 'error',
-                    message: error instanceof Error ? error.message : String(error),
-                });
-            }
-        },
-        async [WalletToolNames.update](args: UpdateWalletRecordToolArgs): Promise<string> {
-            const runtimeContext = resolveWalletRuntimeContext(args);
-            const { adapter, disabledResult } = getWalletToolRuntimeAdapterOrDisabledResult('update', runtimeContext);
-
-            if (!adapter || disabledResult) {
-                return JSON.stringify(disabledResult);
-            }
-
-            try {
-                const parsedArgs = parseWalletToolArgs.update(args);
-                const record = await adapter.updateWalletRecord(parsedArgs, runtimeContext);
-                return JSON.stringify({
-                    action: 'update',
-                    status: 'updated',
-                    record,
-                });
-            } catch (error) {
-                return JSON.stringify({
-                    action: 'update',
-                    status: 'error',
-                    message: error instanceof Error ? error.message : String(error),
-                });
-            }
-        },
-        async [WalletToolNames.delete](args: DeleteWalletRecordToolArgs): Promise<string> {
-            const runtimeContext = resolveWalletRuntimeContext(args);
-            const { adapter, disabledResult } = getWalletToolRuntimeAdapterOrDisabledResult('delete', runtimeContext);
-
-            if (!adapter || disabledResult) {
-                return JSON.stringify(disabledResult);
-            }
-
-            try {
-                const parsedArgs = parseWalletToolArgs.delete(args);
-                const deleted = await adapter.deleteWalletRecord(parsedArgs, runtimeContext);
-                return JSON.stringify({
-                    action: 'delete',
-                    status: 'deleted',
-                    walletId: deleted.id,
-                });
-            } catch (error) {
-                return JSON.stringify({
-                    action: 'delete',
-                    status: 'error',
-                    message: error instanceof Error ? error.message : String(error),
-                });
-            }
-        },
-        async [WalletToolNames.request](args: RequestWalletRecordToolArgs): Promise<string> {
-            const runtimeContext = resolveWalletRuntimeContext(args);
-            const disabledMessage = resolveWalletDisabledMessage(runtimeContext);
-            if (disabledMessage) {
-                return JSON.stringify({
-                    action: 'request',
-                    status: 'disabled',
-                    message: disabledMessage,
-                });
-            }
-
-            const request = parseWalletToolArgs.request(args);
-            return JSON.stringify({
-                action: 'request',
-                status: 'requested',
-                request,
-                message:
-                    request.message ||
-                    `Request user to provide ${request.recordType} credentials for service "${request.service}".`,
-            });
-        },
-    };
-}

package/src/commitments/WALLET/createWalletTools.ts

@@ -1,129 +0,0 @@
-import type { LlmToolDefinition } from '../../types/LlmToolDefinition';
-import type { TODO_any } from '../../utils/organization/TODO_any';
-import { WalletToolNames } from './WalletToolNames';
-
-/**
- * Creates tool definitions required by WALLET commitment.
- *
- * @private function of WalletCommitmentDefinition
- */
-export function createWalletTools(existingTools: ReadonlyArray<LlmToolDefinition> | undefined): LlmToolDefinition[] {
-    const tools: LlmToolDefinition[] = [...(existingTools || [])];
-
-    addWalletToolIfMissing(tools, {
-        name: WalletToolNames.retrieve,
-        description: 'Retrieve wallet records relevant to the current task.',
-        parameters: {
-            type: 'object',
-            properties: {
-                query: { type: 'string', description: 'Optional text query used to filter wallet records.' },
-                recordType: {
-                    type: 'string',
-                    description: 'Optional record type filter (USERNAME_PASSWORD, SESSION_COOKIE, ACCESS_TOKEN).',
-                },
-                service: { type: 'string', description: 'Optional service filter, for example github.' },
-                key: { type: 'string', description: 'Optional wallet key filter.' },
-                limit: { type: 'integer', description: 'Optional maximum number of records (default 5, max 20).' },
-            },
-            required: [],
-        },
-    });
-
-    addWalletToolIfMissing(tools, {
-        name: WalletToolNames.store,
-        description: 'Store one wallet record.',
-        parameters: {
-            type: 'object',
-            properties: {
-                recordType: {
-                    type: 'string',
-                    description: 'Record type: USERNAME_PASSWORD, SESSION_COOKIE, ACCESS_TOKEN.',
-                },
-                service: { type: 'string', description: 'Service identifier, for example github.' },
-                key: { type: 'string', description: 'Logical credential key.' },
-                username: { type: 'string', description: 'Username for USERNAME_PASSWORD.' },
-                password: { type: 'string', description: 'Password for USERNAME_PASSWORD.' },
-                secret: { type: 'string', description: 'Token/API key for ACCESS_TOKEN.' },
-                cookies: { type: 'string', description: 'Cookie header/json for SESSION_COOKIE.' },
-                isUserScoped: { type: 'boolean', description: 'Set true to scope this record to current user.' },
-                isGlobal: { type: 'boolean', description: 'Set true to make this record global.' },
-            },
-            required: ['recordType', 'service'],
-        },
-    });
-
-    addWalletToolIfMissing(tools, {
-        name: WalletToolNames.update,
-        description: 'Update one existing wallet record.',
-        parameters: {
-            type: 'object',
-            properties: {
-                walletId: { type: 'string', description: 'Wallet record id to update.' },
-                recordType: {
-                    type: 'string',
-                    description: 'Record type: USERNAME_PASSWORD, SESSION_COOKIE, ACCESS_TOKEN.',
-                },
-                service: { type: 'string', description: 'Service identifier, for example github.' },
-                key: { type: 'string', description: 'Logical credential key.' },
-                username: { type: 'string', description: 'Username for USERNAME_PASSWORD.' },
-                password: { type: 'string', description: 'Password for USERNAME_PASSWORD.' },
-                secret: { type: 'string', description: 'Token/API key for ACCESS_TOKEN.' },
-                cookies: { type: 'string', description: 'Cookie header/json for SESSION_COOKIE.' },
-                isUserScoped: { type: 'boolean', description: 'Set true to scope this record to current user.' },
-                isGlobal: { type: 'boolean', description: 'Set true to make this record global.' },
-            },
-            required: ['walletId', 'recordType', 'service'],
-        },
-    });
-
-    addWalletToolIfMissing(tools, {
-        name: WalletToolNames.delete,
-        description: 'Delete one wallet record.',
-        parameters: {
-            type: 'object',
-            properties: {
-                walletId: { type: 'string', description: 'Wallet record id to delete.' },
-            },
-            required: ['walletId'],
-        },
-    });
-
-    addWalletToolIfMissing(tools, {
-        name: WalletToolNames.request,
-        description: 'Request missing credential from user via popup.',
-        parameters: {
-            type: 'object',
-            properties: {
-                recordType: {
-                    type: 'string',
-                    description: 'Requested record type: USERNAME_PASSWORD, SESSION_COOKIE, ACCESS_TOKEN.',
-                },
-                service: { type: 'string', description: 'Service identifier.' },
-                key: { type: 'string', description: 'Logical credential key.' },
-                message: { type: 'string', description: 'Optional UI message for user.' },
-                isUserScoped: {
-                    type: 'boolean',
-                    description: 'Set true when record should be scoped to current user.',
-                },
-                isGlobal: { type: 'boolean', description: 'Set true when record should be global.' },
-            },
-            required: [],
-        },
-    });
-
-    return tools;
-}
-
-/**
- * Registers one wallet tool when missing in current tool list.
- *
- * @private function of WalletCommitmentDefinition
- */
-function addWalletToolIfMissing(
-    tools: Array<{ name: string } & Record<string, TODO_any>>,
-    tool: { name: string } & Record<string, TODO_any>,
-): void {
-    if (!tools.some((existingTool) => existingTool.name === tool.name)) {
-        tools.push(tool);
-    }
-}

package/src/commitments/WALLET/getWalletCommitmentDocumentation.ts

@@ -1,14 +0,0 @@
-import { spaceTrim } from 'spacetrim';
-
-/**
- * Gets markdown documentation for WALLET commitment.
- *
- * @private function of WalletCommitmentDefinition
- */
-export function getWalletCommitmentDocumentation(type: 'WALLET' | 'WALLETS'): string {
-    return spaceTrim(`
-        # ${type}
-
-        Enables private credential storage for tokens, usernames/passwords, and session cookies.
-    `);
-}

package/src/commitments/WALLET/getWalletToolRuntimeAdapterOrDisabledResult.ts

@@ -1,64 +0,0 @@
-import { getWalletToolRuntimeAdapter } from './setWalletToolRuntimeAdapter';
-import type {
-    WalletDisabledToolResult,
-    WalletRuntimeToolAction,
-    WalletToolRuntimeAdapter,
-    WalletToolRuntimeContext,
-} from './WalletToolRuntimeAdapter';
-
-/**
- * Resolves disabled message for wallet runtime context.
- *
- * @private function of WalletCommitmentDefinition
- */
-export function resolveWalletDisabledMessage(runtimeContext: WalletToolRuntimeContext): string | null {
-    if (runtimeContext.isPrivateMode) {
-        return 'Wallet is disabled because private mode is active.';
-    }
-    if (runtimeContext.isTeamConversation) {
-        return 'Wallet is disabled for TEAM conversations.';
-    }
-    if (!runtimeContext.enabled) {
-        return 'Wallet is disabled for unauthenticated users.';
-    }
-
-    return null;
-}
-
-/**
- * Resolves runtime adapter for wallet tools or returns disabled payload when unavailable.
- *
- * @private function of WalletCommitmentDefinition
- */
-export function getWalletToolRuntimeAdapterOrDisabledResult(
-    action: WalletRuntimeToolAction,
-    runtimeContext: WalletToolRuntimeContext,
-): { adapter: WalletToolRuntimeAdapter | null; disabledResult?: WalletDisabledToolResult } {
-    const disabledMessage = resolveWalletDisabledMessage(runtimeContext);
-    if (disabledMessage) {
-        return {
-            adapter: null,
-            disabledResult: {
-                action,
-                status: 'disabled',
-                records: action === 'retrieve' ? [] : undefined,
-                message: disabledMessage,
-            },
-        };
-    }
-
-    const adapter = getWalletToolRuntimeAdapter();
-    if (!adapter) {
-        return {
-            adapter: null,
-            disabledResult: {
-                action,
-                status: 'disabled',
-                records: action === 'retrieve' ? [] : undefined,
-                message: 'Wallet runtime is not available in this environment.',
-            },
-        };
-    }
-
-    return { adapter };
-}

package/src/commitments/WALLET/getWalletToolTitles.ts

@@ -1,17 +0,0 @@
-import type { string_javascript_name } from '../../types/string_person_fullname';
-import { WalletToolNames } from './WalletToolNames';
-
-/**
- * Gets human-readable titles for WALLET tool functions.
- *
- * @private function of WalletCommitmentDefinition
- */
-export function getWalletToolTitles(): Record<string_javascript_name, string> {
-    return {
-        [WalletToolNames.retrieve]: 'Wallet',
-        [WalletToolNames.store]: 'Store wallet record',
-        [WalletToolNames.update]: 'Update wallet record',
-        [WalletToolNames.delete]: 'Delete wallet record',
-        [WalletToolNames.request]: 'Request wallet record',
-    };
-}