@promptbook/cli 0.114.0-3 → 0.114.0-5

package/src/commitments/USE_BROWSER/fetchUrlContentViaBrowser.ts

@@ -1,45 +0,0 @@
-/**
- * Client-side safe wrapper for fetching URL content
- *
- * This function proxies requests to the Agents Server API endpoint for scraping,
- * making it safe to use in browser environments.
- *
- * @param url The URL to fetch and scrape
- * @param agentsServerUrl The base URL of the agents server (defaults to current origin)
- * @returns Markdown content from the URL
- *
- * @private internal utility for USE BROWSER commitment
- */
-export async function fetchUrlContentViaBrowser(url: string, agentsServerUrl?: string): Promise<string> {
-    try {
-        // Determine the agents server URL
-        const baseUrl = agentsServerUrl || (typeof window !== 'undefined' ? window.location.origin : '');
-
-        if (!baseUrl) {
-            throw new Error('Agents server URL is required in non-browser environments');
-        }
-
-        // Build the API endpoint URL
-        const apiUrl = new URL('/api/scrape', baseUrl);
-        apiUrl.searchParams.set('url', url);
-
-        // Fetch from the API endpoint
-        const response = await fetch(apiUrl.toString());
-
-        if (!response.ok) {
-            const errorData = await response.json().catch(() => ({ error: 'Unknown error' }));
-            throw new Error(`Failed to scrape URL: ${errorData.error || response.statusText}`);
-        }
-
-        const data = await response.json();
-
-        if (!data.success || !data.content) {
-            throw new Error(`Scraping failed: ${data.error || 'No content returned'}`);
-        }
-
-        return data.content;
-    } catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        throw new Error(`Error fetching URL content via browser: ${errorMessage}`);
-    }
-}

package/src/commitments/USE_BROWSER/resolveRunBrowserToolForNode.ts

@@ -1,83 +0,0 @@
-import { spaceTrim } from 'spacetrim';
-import { assertsError } from '../../errors/assertsError';
-import { EnvironmentMismatchError } from '../../errors/EnvironmentMismatchError';
-import type { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
-
-/**
- * Cached implementation of `run_browser` when it can be resolved.
- *
- * @private internal utility for USE BROWSER commitment
- */
-let cachedRunBrowserTool: ToolFunction | null = null;
-
-/**
- * Cached loading error to avoid repeating expensive resolution attempts.
- *
- * @private internal utility for USE BROWSER commitment
- */
-let cachedRunBrowserToolError: Error | null = null;
-
-/**
- * Attempts to load the server-side `run_browser` tool lazily.
- *
- * @returns Loaded `run_browser` implementation
- *
- * @private internal utility for USE BROWSER commitment
- */
-function loadRunBrowserToolForNode(): ToolFunction {
-    if (cachedRunBrowserTool !== null) {
-        return cachedRunBrowserTool;
-    }
-
-    if (cachedRunBrowserToolError !== null) {
-        throw cachedRunBrowserToolError;
-    }
-
-    try {
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        const runBrowserModule = require('../../../apps/agents-server/src/tools/run_browser') as {
-            run_browser?: unknown;
-        };
-
-        if (typeof runBrowserModule.run_browser !== 'function') {
-            throw new Error('run_browser value is not a function but ' + typeof runBrowserModule.run_browser);
-        }
-
-        cachedRunBrowserTool = runBrowserModule.run_browser as ToolFunction;
-        return cachedRunBrowserTool;
-    } catch (error) {
-        assertsError(error);
-        cachedRunBrowserToolError = error;
-        throw error;
-    }
-}
-
-/**
- * Resolves the server-side implementation of the `run_browser` tool for Node.js environments.
- *
- * This uses fully lazy resolution to keep CLI startup independent from optional browser tooling.
- * When the server tool cannot be resolved, the fallback implementation throws a helpful error.
- *
- * @private internal utility for USE BROWSER commitment
- */
-export function resolveRunBrowserToolForNode(): ToolFunction {
-    return async (args) => {
-        try {
-            const runBrowserTool = loadRunBrowserToolForNode();
-            return await runBrowserTool(args);
-        } catch (error) {
-            assertsError(error);
-            throw new EnvironmentMismatchError(
-                spaceTrim(
-                    (block) => `
-                        \`run_browser\` tool is not available in this environment.
-                        This commitment requires the Agents Server browser runtime with Playwright CLI.
-
-                        ${(error as Error).name}:
-                        ${block((error as Error).message)}
-                    `,
-                ),
-            );
-        }
-    };
-}

package/src/commitments/USE_DEEPSEARCH/USE_DEEPSEARCH.ts

@@ -1,146 +0,0 @@
-import { spaceTrim } from 'spacetrim';
-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 type { TODO_any } from '../../utils/organization/TODO_any';
-import { appendAggregatedUseCommitmentPlaceholder } from '../USE/aggregateUseCommitmentSystemMessages';
-import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
-import { createSerpSearchToolFunction } from '../_common/createSerpSearchToolFunction';
-
-/**
- * USE DEEPSEARCH commitment definition
- *
- * The `USE DEEPSEARCH` commitment indicates that the agent should use a deeper research-oriented
- * search workflow instead of lightweight web search when it needs fresh information from the internet.
- *
- * The content following `USE DEEPSEARCH` is an arbitrary text that the agent should know
- * (e.g. search scope or research instructions).
- *
- * Example usage in agent source:
- *
- * ```book
- * USE DEEPSEARCH
- * USE DEEPSEARCH Compare official vendor documentation with independent benchmarks.
- * ```
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export class UseDeepSearchCommitmentDefinition extends BaseCommitmentDefinition<'USE DEEPSEARCH'> {
-    public constructor() {
-        super('USE DEEPSEARCH');
-    }
-
-    override get requiresContent(): boolean {
-        return false;
-    }
-
-    /**
-     * Short one-line description of USE DEEPSEARCH.
-     */
-    get description(): string {
-        return 'Enable the agent to use DeepSearch for more thorough internet research.';
-    }
-
-    /**
-     * Icon for this commitment.
-     */
-    get icon(): string {
-        return '🔬';
-    }
-
-    /**
-     * Markdown documentation for USE DEEPSEARCH commitment.
-     */
-    get documentation(): string {
-        return spaceTrim(`
-            # USE DEEPSEARCH
-
-            Enables the agent to use DeepSearch for broader, more thorough internet research than lightweight web search.
-
-            ## Key aspects
-
-            - The content following \`USE DEEPSEARCH\` is arbitrary guidance for the research workflow.
-            - In Agents Server, the OpenAI Agents SDK runtime uses a nested deep-research agent for this tool.
-            - Use this for investigations, comparisons, market scans, or other tasks that benefit from deeper synthesis.
-            - Prefer regular \`USE SEARCH ENGINE\` when a quick factual lookup is enough.
-
-            ## Examples
-
-            \`\`\`book
-            Due Diligence Researcher
-
-            GOAL Investigate vendors thoroughly before making recommendations.
-            USE DEEPSEARCH Compare official sources with credible third-party analysis.
-            RULE Cite the strongest supporting sources in the final answer.
-            \`\`\`
-
-            \`\`\`book
-            Market Analyst
-
-            GOAL Build concise but well-grounded research briefs.
-            USE DEEPSEARCH Focus on recent public information and competing viewpoints.
-            CLOSED
-            \`\`\`
-        `);
-    }
-
-    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements {
-        const existingTools = requirements.tools || [];
-
-        const updatedTools = existingTools.some((tool) => tool.name === 'deep_search')
-            ? existingTools
-            : [
-                  ...existingTools,
-                  {
-                      name: 'deep_search',
-                      description: spaceTrim(`
-                          Research the internet deeply and synthesize a grounded answer.
-                          Use this tool for broader investigations, comparisons, and requests that need more than a quick search.
-                      `),
-                      parameters: {
-                          type: 'object',
-                          properties: {
-                              query: {
-                                  type: 'string',
-                                  description: 'The research question or investigation request.',
-                              },
-                          },
-                          required: ['query'],
-                          additionalProperties: false,
-                      },
-                  } as TODO_any,
-              ];
-
-        return appendAggregatedUseCommitmentPlaceholder(
-            {
-                ...requirements,
-                tools: updatedTools,
-                _metadata: {
-                    ...requirements._metadata,
-                    useDeepSearch: content || true,
-                },
-            },
-            this.type,
-        );
-    }
-
-    /**
-     * Gets human-readable titles for tool functions provided by this commitment.
-     */
-    getToolTitles(): Record<string_javascript_name, string> {
-        return {
-            deep_search: 'DeepSearch',
-        };
-    }
-
-    /**
-     * Gets the local fallback implementation for the `deep_search` tool.
-     */
-    getToolFunctions(): Record<string_javascript_name, ToolFunction> {
-        return {
-            deep_search: createSerpSearchToolFunction('deep_search', 'DeepSearch'),
-        };
-    }
-}
-
-// Note: [💞] Ignore a discrepancy between file name and entity name

package/src/commitments/USE_EMAIL/USE_EMAIL.ts

@@ -1,201 +0,0 @@
-import { spaceTrim } from 'spacetrim';
-import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
-import type { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
-import type { LlmToolDefinition } from '../../types/LlmToolDefinition';
-import type { string_javascript_name } from '../../types/string_person_fullname';
-import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
-import { formatOptionalInstructionBlock } from '../_base/formatOptionalInstructionBlock';
-import { parseUseEmailCommitmentContent } from './parseUseEmailCommitmentContent';
-import { sendEmailViaBrowser } from './sendEmailViaBrowser';
-
-/**
- * Tool name used by USE EMAIL.
- *
- * @private internal USE EMAIL constant
- */
-const SEND_EMAIL_TOOL_NAME = 'send_email' as string_javascript_name;
-
-/**
- * USE EMAIL commitment definition.
- *
- * The `USE EMAIL` commitment enables outbound email sending through the `send_email` tool.
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export class UseEmailCommitmentDefinition extends BaseCommitmentDefinition<'USE EMAIL'> {
-    public constructor() {
-        super('USE EMAIL', ['EMAIL', 'MAIL']);
-    }
-
-    override get requiresContent(): boolean {
-        return false;
-    }
-
-    /**
-     * Short one-line description of USE EMAIL.
-     */
-    get description(): string {
-        return 'Enable outbound email sending through a wallet-backed SMTP configuration.';
-    }
-
-    /**
-     * Icon for this commitment.
-     */
-    get icon(): string {
-        return '📧';
-    }
-
-    /**
-     * Markdown documentation for USE EMAIL commitment.
-     */
-    get documentation(): string {
-        return spaceTrim(`
-            # USE EMAIL
-
-            Enables the agent to send outbound emails through SMTP.
-
-            ## Key aspects
-
-            - The agent sends email via the \`send_email\` tool.
-            - SMTP credentials are expected from wallet records (\`ACCESS_TOKEN\`, service \`smtp\`, key \`use-email-smtp-credentials\`).
-            - Commitment content can optionally begin with a default sender email address:
-              - \`USE EMAIL agent@example.com\`
-            - Remaining commitment content is treated as optional email-writing instructions.
-
-            ## Examples
-
-            \`\`\`book
-            Writing Agent
-            USE EMAIL agent@example.com
-            RULE Write emails to customers according to the instructions from user.
-            \`\`\`
-
-            \`\`\`book
-            Formal Email Assistant
-            USE EMAIL agent@example.com Keep emails concise and formal.
-            \`\`\`
-        `);
-    }
-
-    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements {
-        const parsedCommitment = parseUseEmailCommitmentContent(content);
-        const updatedTools = addUseEmailTools(requirements.tools || []);
-
-        // Collect all configured sender emails across multiple USE EMAIL commitments
-        const existingSenders: string[] = Array.isArray(requirements._metadata?.useEmailSenders)
-            ? [...(requirements._metadata!.useEmailSenders as string[])]
-            : [];
-        if (parsedCommitment.senderEmail && !existingSenders.includes(parsedCommitment.senderEmail)) {
-            existingSenders.push(parsedCommitment.senderEmail);
-        }
-
-        const senderBullets =
-            existingSenders.length > 0
-                ? existingSenders
-                      .map((email, index) =>
-                          index === 0
-                              ? `-   Default sender address: "${email}".`
-                              : `-   Additional sender address: "${email}".`,
-                      )
-                      .join('\n')
-                : '';
-
-        const extraInstructions = formatOptionalInstructionBlock('Email instructions', parsedCommitment.instructions);
-
-        const emailSectionContent = spaceTrim(
-            (block) => `
-                ## Emails
-
-                -   Use \`${SEND_EMAIL_TOOL_NAME}\` to send outbound emails.
-                ${block(senderBullets)}
-                ${block(extraInstructions)}
-            `,
-        );
-
-        return this.replaceOrCreateSection(
-            {
-                ...requirements,
-                tools: updatedTools,
-                _metadata: {
-                    ...requirements._metadata,
-                    useEmail: true,
-                    ...(parsedCommitment.senderEmail ? { useEmailSender: parsedCommitment.senderEmail } : {}),
-                    useEmailSenders: existingSenders,
-                },
-            },
-            'Emails',
-            emailSectionContent,
-        );
-    }
-
-    /**
-     * Gets human-readable titles for tool functions provided by this commitment.
-     */
-    getToolTitles(): Record<string_javascript_name, string> {
-        return {
-            [SEND_EMAIL_TOOL_NAME]: 'Send email',
-        };
-    }
-
-    /**
-     * Gets the browser-safe `send_email` implementation.
-     *
-     * Node.js runtime overrides this via `getAllCommitmentsToolFunctionsForNode`.
-     */
-    getToolFunctions(): Record<string_javascript_name, ToolFunction> {
-        return {
-            async [SEND_EMAIL_TOOL_NAME](args: unknown): Promise<string> {
-                return sendEmailViaBrowser(args as Record<string, unknown>);
-            },
-        };
-    }
-}
-
-/**
- * Adds USE EMAIL tool definition while keeping already registered tools untouched.
- *
- * @private utility of USE EMAIL commitment
- */
-function addUseEmailTools(existingTools: ReadonlyArray<LlmToolDefinition>): Array<LlmToolDefinition> {
-    if (existingTools.some((tool) => tool.name === SEND_EMAIL_TOOL_NAME)) {
-        return [...existingTools];
-    }
-
-    return [
-        ...existingTools,
-        {
-            name: SEND_EMAIL_TOOL_NAME,
-            description: 'Send an outbound email.',
-            parameters: {
-                type: 'object',
-                properties: {
-                    message: {
-                        type: 'object',
-                        description: 'Email payload. Use metadata.subject for the subject line.',
-                    },
-                    to: {
-                        type: 'string',
-                        description:
-                            'Legacy alias for recipients (use comma-separated emails or JSON array encoded as string).',
-                    },
-                    cc: {
-                        type: 'string',
-                        description:
-                            'Optional CC recipients (use comma-separated emails or JSON array encoded as string).',
-                    },
-                    subject: {
-                        type: 'string',
-                        description: 'Legacy alias for subject.',
-                    },
-                    body: {
-                        type: 'string',
-                        description: 'Legacy alias for markdown body content.',
-                    },
-                },
-                required: [],
-            },
-        },
-    ];
-}
-
-// Note: [💞] Ignore a discrepancy between file name and entity name

package/src/commitments/USE_EMAIL/parseUseEmailCommitmentContent.ts

@@ -1,75 +0,0 @@
-import { spaceTrim } from 'spacetrim';
-import { isValidEmail } from '../../utils/validators/email/isValidEmail';
-
-/**
- * Lightweight email token matcher used for `USE EMAIL` first-line parsing.
- *
- * @private internal USE EMAIL constant
- */
-const EMAIL_TOKEN_PATTERN = /[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/;
-
-/**
- * Parsed payload of one `USE EMAIL` commitment.
- *
- * @private internal USE EMAIL type
- */
-export type ParsedUseEmailCommitmentContent = {
-    senderEmail: string | null;
-    senderEmailRaw: string | null;
-    instructions: string;
-};
-
-/**
- * Parses `USE EMAIL` commitment content into optional sender email + additional instructions.
- *
- * Examples:
- * - `agent@example.com`
- * - `agent@example.com Keep emails concise`
- * - `Keep emails concise`
- *
- * @private internal utility of USE EMAIL commitment
- */
-export function parseUseEmailCommitmentContent(content: string): ParsedUseEmailCommitmentContent {
-    const trimmedContent = spaceTrim(content);
-    if (!trimmedContent) {
-        return {
-            senderEmail: null,
-            senderEmailRaw: null,
-            instructions: '',
-        };
-    }
-
-    const lines = trimmedContent
-        .split(/\r?\n/)
-        .map((line) => line.trim())
-        .filter(Boolean);
-    if (lines.length === 0) {
-        return {
-            senderEmail: null,
-            senderEmailRaw: null,
-            instructions: '',
-        };
-    }
-
-    const firstLine = lines[0] || '';
-    const senderMatch = firstLine.match(EMAIL_TOKEN_PATTERN);
-    const senderEmailRaw = senderMatch?.[0] || null;
-    const senderEmail = senderEmailRaw && isValidEmail(senderEmailRaw) ? senderEmailRaw : null;
-
-    let firstLineWithoutSender = firstLine;
-    if (senderEmailRaw) {
-        const matchIndex = firstLine.indexOf(senderEmailRaw);
-        const prefix = firstLine.slice(0, matchIndex).trim();
-        const suffix = firstLine.slice(matchIndex + senderEmailRaw.length).trim();
-        firstLineWithoutSender = [prefix, suffix].filter(Boolean).join(' ').trim();
-    }
-
-    const instructionLines = [firstLineWithoutSender, ...lines.slice(1)].filter(Boolean);
-    const instructions = instructionLines.join('\n').trim();
-
-    return {
-        senderEmail,
-        senderEmailRaw,
-        instructions,
-    };
-}

package/src/commitments/USE_EMAIL/resolveSendEmailToolForNode.ts

@@ -1,44 +0,0 @@
-import { spaceTrim } from 'spacetrim';
-import { EnvironmentMismatchError } from '../../errors/EnvironmentMismatchError';
-import type { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
-
-/**
- * Resolves the server-side implementation of the send_email tool for Node.js environments.
- *
- * This uses a lazy require so the core package can still load even if the Agents Server
- * module is unavailable. When the server tool cannot be resolved, a fallback implementation
- * throws a helpful error message.
- *
- * @private internal utility for USE EMAIL commitment
- */
-export function resolveSendEmailToolForNode(): ToolFunction {
-    try {
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        const { send_email } = require('../../../apps/agents-server/src/tools/send_email');
-
-        if (typeof send_email !== 'function') {
-            throw new Error('send_email value is not a function but ' + typeof send_email);
-        }
-
-        return send_email as ToolFunction;
-    } catch (error) {
-        const normalizedError =
-            error instanceof Error
-                ? error
-                : new Error(typeof error === 'string' ? error : JSON.stringify(error ?? 'Unknown error'));
-
-        return async () => {
-            throw new EnvironmentMismatchError(
-                spaceTrim(
-                    (block) => `
-                        \`send_email\` tool is not available in this environment.
-                        This commitment requires Agents Server runtime with wallet-backed SMTP sending.
-
-                        ${normalizedError.name}:
-                        ${block(normalizedError.message)}
-                    `,
-                ),
-            );
-        };
-    }
-}

package/src/commitments/USE_EMAIL/sendEmailViaBrowser.ts

@@ -1,47 +0,0 @@
-/**
- * Client-side safe wrapper for sending emails.
- *
- * This function proxies requests to the Agents Server API endpoint for email queuing,
- * making it safe to use in browser environments.
- *
- * @param args Email payload forwarded to the server-side `send_email` tool
- * @param agentsServerUrl The base URL of the agents server (defaults to current origin)
- * @returns Result string from the server-side send_email tool
- *
- * @private internal utility for USE EMAIL commitment
- */
-export async function sendEmailViaBrowser(args: Record<string, unknown>, agentsServerUrl?: string): Promise<string> {
-    try {
-        const baseUrl = agentsServerUrl || (typeof window !== 'undefined' ? window.location.origin : '');
-
-        if (!baseUrl) {
-            throw new Error('Agents server URL is required in non-browser environments');
-        }
-
-        const apiUrl = new URL('/api/send-email', baseUrl);
-
-        const response = await fetch(apiUrl.toString(), {
-            method: 'POST',
-            headers: {
-                'Content-Type': 'application/json',
-            },
-            body: JSON.stringify(args),
-        });
-
-        if (!response.ok) {
-            const errorData = await response.json().catch(() => ({ error: 'Unknown error' }));
-            throw new Error(`Failed to send email: ${errorData.error || response.statusText}`);
-        }
-
-        const data = await response.json();
-
-        if (!data.success) {
-            throw new Error(`Email sending failed: ${data.error || 'Unknown error'}`);
-        }
-
-        return typeof data.result === 'string' ? data.result : JSON.stringify(data.result);
-    } catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        throw new Error(`Error sending email via browser: ${errorMessage}`);
-    }
-}

package/src/commitments/USE_SEARCH_ENGINE/TODO.txt

@@ -1 +0,0 @@
-TODO: [🔰] USE SEARCH is working only in demo mode only. Need to implement full functionality via MCP server and Search engines