@promptbook/cli 0.114.0-2 → 0.114.0-4

package/src/cli/common/$provideLlmToolsForCli.ts

@@ -1,5 +1,4 @@
 import colors from 'colors';
-import prompts from 'prompts';
 import { spaceTrim } from 'spacetrim';
 import { CLI_APP_ID } from '../../config';
 import { UnexpectedError } from '../../errors/UnexpectedError';
@@ -14,6 +13,7 @@ import type { really_unknown } from '../../utils/organization/really_unknown';
 import { TODO_USE } from '../../utils/organization/TODO_USE';
 import { isValidEmail } from '../../utils/validators/email/isValidEmail';
 import { isValidUrl } from '../../utils/validators/url/isValidUrl';
+import { loadPromptsModule } from './loadPromptsModule';
 
 /**
  * Options for provide Llm tools for Cli.
@@ -110,6 +110,7 @@ export async function $provideLlmToolsForCli(options: ProvideLlmToolsForCliOptio
                     ),
                 );
 
+                const { default: prompts } = await loadPromptsModule();
                 const { username, password } = await prompts([
                     {
                         type: 'text',

package/src/cli/common/loadPromptsModule.ts

@@ -0,0 +1,13 @@
+import { createLazyModuleLoader } from '../../utils/misc/createLazyModuleLoader';
+
+/**
+ * Loads the interactive terminal prompt library (`prompts`) on demand
+ *
+ * Note: [🐌] Loaded lazily to keep the startup of the `ptbk` CLI utility fast - most commands never ask the user
+ *       anything interactively
+ *
+ * @private internal utility of Promptbook CLI
+ */
+export const loadPromptsModule = createLazyModuleLoader(() => import('prompts'));
+
+// Note: [🟡] Code for CLI prompt loading [loadPromptsModule](src/cli/common/loadPromptsModule.ts) should never be published outside of `@promptbook/cli`

package/src/commitments/ACTION/ACTION.ts

@@ -66,7 +66,7 @@ export class ActionCommitmentDefinition extends BaseCommitmentDefinition<'ACTION
             Research Assistant
 
             PERSONA You are a helpful research assistant
-            USE SEARCH ENGINE
+            USE MCP https://mcp.example.com/server
             RULE Always cite your sources when providing information from the web
             \`\`\`
 
@@ -86,8 +86,8 @@ export class ActionCommitmentDefinition extends BaseCommitmentDefinition<'ACTION
             Code Assistant
 
             PERSONA You are a programming assistant
-            USE BROWSER
-            USE SEARCH ENGINE
+            USE PROJECT https://github.com/example/project
+            USE MCP https://mcp.example.com/server
             RULE Prefer the narrowest useful capability for the task.
             \`\`\`
         `);

package/src/commitments/{META → META_DESCRIPTION}/META_DESCRIPTION.ts

@@ -20,7 +20,7 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  */
 export class MetaDescriptionCommitmentDefinition extends BaseCommitmentDefinition<'META DESCRIPTION'> {
     public constructor() {
-        super('META DESCRIPTION', ['DESCRIPTION']);
+        super('META DESCRIPTION');
     }
 
     /**

package/src/commitments/META_FULLNAME/META_FULLNAME.ts

@@ -0,0 +1,70 @@
+import { spaceTrim } from 'spacetrim';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import { TODO_USE } from '../../utils/organization/TODO_USE';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+
+/**
+ * META FULLNAME commitment definition
+ *
+ * The `META FULLNAME` commitment sets the full display name of the agent, which can differ
+ * from the agent name on the first line of the agent source, for example when the agent
+ * should be presented with academic titles.
+ * This commitment is metadata-only and does not modify model requirements.
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export class MetaFullnameCommitmentDefinition extends BaseCommitmentDefinition<'META FULLNAME'> {
+    public constructor() {
+        super('META FULLNAME');
+    }
+
+    /**
+     * Short one-line description of META FULLNAME.
+     */
+    get description(): string {
+        return "Set the agent's full display name.";
+    }
+
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string {
+        return '🪪';
+    }
+
+    /**
+     * Markdown documentation for META FULLNAME commitment.
+     */
+    get documentation(): string {
+        return spaceTrim(`
+            # META FULLNAME
+
+            Sets the full display name of the agent shown in profiles, chats, and exports.
+
+            ## Key aspects
+
+            - Does not modify the agent's behavior or responses.
+            - If not present, the agent name from the first line of the agent source is used.
+            - If multiple \`META FULLNAME\` commitments are specified, the last one takes precedence.
+
+            ## Examples
+
+            \`\`\`book
+            Pavol Hejný
+
+            META FULLNAME Dr. Ing. Pavol Hejný, PhD.
+            PERSONA Developer with 10 years of experience in building AI applications.
+            \`\`\`
+        `);
+    }
+
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements {
+        TODO_USE(content);
+
+        // META FULLNAME does not modify the model requirements.
+        // It is consumed by profile parsing.
+        return requirements;
+    }
+}
+
+// Note: [💞] Ignore a discrepancy between file name and entity name

package/src/commitments/META_ID/META_ID.ts

@@ -0,0 +1,78 @@
+import { spaceTrim } from 'spacetrim';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import { TODO_USE } from '../../utils/organization/TODO_USE';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+
+/**
+ * META ID commitment definition
+ *
+ * The `META ID` commitment carries the permanent id of the agent when an agent source is moved
+ * between systems. It is a low-level commitment which is normally written and stripped by the
+ * persistence layer instead of being written by hand.
+ * This commitment is metadata-only and does not modify model requirements.
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export class MetaIdCommitmentDefinition extends BaseCommitmentDefinition<'META ID'> {
+    public constructor() {
+        super('META ID');
+    }
+
+    /**
+     * Short one-line description of META ID.
+     */
+    get description(): string {
+        return "Set the agent's permanent id.";
+    }
+
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string {
+        return '🔖';
+    }
+
+    /**
+     * `META ID` is written by the persistence layer, not by agent authors.
+     */
+    override get isLowLevel(): boolean {
+        return true;
+    }
+
+    /**
+     * Markdown documentation for META ID commitment.
+     */
+    get documentation(): string {
+        return spaceTrim(`
+            # META ID
+
+            Carries the permanent id of the agent inside the agent source.
+
+            ## Key aspects
+
+            - Does not modify the agent's behavior or responses.
+            - Written and stripped by the persistence layer, it should not be written by hand.
+            - When an agent source without \`META ID\` is stored, a fresh permanent id is assigned.
+            - If multiple \`META ID\` commitments are specified, the last one takes precedence.
+
+            ## Examples
+
+            \`\`\`book
+            My agent
+
+            META ID doQMRg82izNfJa
+            PERSONA My agent is an expert in something.
+            \`\`\`
+        `);
+    }
+
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements {
+        TODO_USE(content);
+
+        // META ID does not modify the model requirements.
+        // It is consumed by profile parsing and agent persistence.
+        return requirements;
+    }
+}
+
+// Note: [💞] Ignore a discrepancy between file name and entity name

package/src/commitments/_common/getAllCommitmentsToolFunctionsForNode.ts

@@ -1,61 +1,13 @@
 import { EnvironmentMismatchError } from '../../errors/EnvironmentMismatchError';
 import { $isRunningInNode } from '../../utils/environment/$isRunningInNode';
 import { spaceTrim } from '../../utils/organization/spaceTrim';
-import { fetchUrlContent } from '../USE_BROWSER/fetchUrlContent';
-import { resolveRunBrowserToolForNode } from '../USE_BROWSER/resolveRunBrowserToolForNode';
-import { resolveSendEmailToolForNode } from '../USE_EMAIL/resolveSendEmailToolForNode';
-import { resolveSpawnAgentToolForNode } from '../USE_SPAWN/resolveSpawnAgentToolForNode';
 import type { CommitmentToolFunctions } from './commitmentToolFunctions';
 import { collectCommitmentToolFunctions, createToolFunctionsProxy } from './commitmentToolFunctions';
 
-/**
- * Map of node tool functions.
- */
-const nodeToolFunctions: CommitmentToolFunctions = {
-    /**
-     * @@@
-     *
-     * Note: [??] This function has implementation both for browser and node, this is the full one for node
-     */
-    async fetch_url_content(args: { url: string }): Promise<string> {
-        console.log('!!!! [Tool] fetch_url_content called', { args });
-
-        const { url } = args;
-
-        return await fetchUrlContent(url);
-    },
-
-    /**
-     * @@@
-     *
-     * Note: [??] This function has implementation both for browser and node, this is the server one for node
-     */
-    run_browser: resolveRunBrowserToolForNode(),
-
-    /**
-     * @@@
-     *
-     * Note: [??] This function has implementation both for browser and node, this is the server one for node
-     */
-    send_email: resolveSendEmailToolForNode(),
-
-    /**
-     * @@@
-     *
-     * Note: [??] This function has implementation both for browser and node, this is the server one for node
-     */
-    spawn_agent: resolveSpawnAgentToolForNode(),
-
-    // TODO: !!!! Unhardcode, make proper server function register from definitions
-};
-
 /**
  * Constant for node tool functions proxy.
  */
-const nodeToolFunctionsProxy = createToolFunctionsProxy(() => ({
-    ...collectCommitmentToolFunctions(),
-    ...nodeToolFunctions,
-}));
+const nodeToolFunctionsProxy = createToolFunctionsProxy(collectCommitmentToolFunctions);
 
 /**
  * Gets all function implementations provided by all commitments

package/src/commitments/index.ts

@@ -3,7 +3,6 @@ import type { CommitmentDefinition } from './_base/CommitmentDefinition';
 // Import all commitment definition classes
 import { ActionCommitmentDefinition } from './ACTION/ACTION';
 import { ClosedCommitmentDefinition } from './CLOSED/CLOSED';
-import { ComponentCommitmentDefinition } from './COMPONENT/COMPONENT';
 import { DeleteCommitmentDefinition } from './DELETE/DELETE';
 import { DictionaryCommitmentDefinition } from './DICTIONARY/DICTIONARY';
 import { FormatCommitmentDefinition } from './FORMAT/FORMAT';
@@ -12,19 +11,20 @@ import { GoalCommitmentDefinition } from './GOAL/GOAL';
 import { ImportCommitmentDefinition } from './IMPORT/IMPORT';
 import { KnowledgeCommitmentDefinition } from './KNOWLEDGE/KNOWLEDGE';
 import { LanguageCommitmentDefinition } from './LANGUAGE/LANGUAGE';
-import { MemoryCommitmentDefinition } from './MEMORY/MEMORY';
 import { AgentMessageCommitmentDefinition } from './MESSAGE/AgentMessageCommitmentDefinition';
 import { InitialMessageCommitmentDefinition } from './MESSAGE/InitialMessageCommitmentDefinition';
 import { InternalMessageCommitmentDefinition } from './MESSAGE/InternalMessageCommitmentDefinition';
 import { MessageCommitmentDefinition } from './MESSAGE/MESSAGE';
 import { UserMessageCommitmentDefinition } from './MESSAGE/UserMessageCommitmentDefinition';
 import { MessageSuffixCommitmentDefinition } from './MESSAGE_SUFFIX/MESSAGE_SUFFIX';
-import { MetaCommitmentDefinition } from './META/META';
 import { MetaAvatarCommitmentDefinition } from './META_AVATAR/META_AVATAR';
 import { MetaColorCommitmentDefinition } from './META_COLOR/META_COLOR';
+import { MetaDescriptionCommitmentDefinition } from './META_DESCRIPTION/META_DESCRIPTION';
 import { MetaDomainCommitmentDefinition } from './META_DOMAIN/META_DOMAIN';
 import { MetaDisclaimerCommitmentDefinition } from './META_DISCLAIMER/META_DISCLAIMER';
 import { MetaFontCommitmentDefinition } from './META_FONT/META_FONT';
+import { MetaFullnameCommitmentDefinition } from './META_FULLNAME/META_FULLNAME';
+import { MetaIdCommitmentDefinition } from './META_ID/META_ID';
 import { MetaImageCommitmentDefinition } from './META_IMAGE/META_IMAGE';
 import { MetaInputPlaceholderCommitmentDefinition } from './META_INPUT_PLACEHOLDER/META_INPUT_PLACEHOLDER';
 import { MetaLinkCommitmentDefinition } from './META_LINK/META_LINK';
@@ -41,21 +41,13 @@ import { ScenarioCommitmentDefinition } from './SCENARIO/SCENARIO';
 import { StyleCommitmentDefinition } from './STYLE/STYLE';
 import { TeamCommitmentDefinition } from './TEAM/TEAM';
 import { TemplateCommitmentDefinition } from './TEMPLATE/TEMPLATE';
-import { UseBrowserCommitmentDefinition } from './USE_BROWSER/USE_BROWSER';
 import { UseCalendarCommitmentDefinition } from './USE_CALENDAR/USE_CALENDAR';
-import { UseDeepSearchCommitmentDefinition } from './USE_DEEPSEARCH/USE_DEEPSEARCH';
-import { UseEmailCommitmentDefinition } from './USE_EMAIL/USE_EMAIL';
 import { UseImageGeneratorCommitmentDefinition } from './USE_IMAGE_GENERATOR/USE_IMAGE_GENERATOR';
 import { UseMcpCommitmentDefinition } from './USE_MCP/USE_MCP';
 import { UsePopupCommitmentDefinition } from './USE_POPUP/USE_POPUP';
 import { UsePrivacyCommitmentDefinition } from './USE_PRIVACY/USE_PRIVACY';
 import { UseProjectCommitmentDefinition } from './USE_PROJECT/USE_PROJECT';
-import { UseSearchEngineCommitmentDefinition } from './USE_SEARCH_ENGINE/USE_SEARCH_ENGINE';
-import { UseSpawnCommitmentDefinition } from './USE_SPAWN/USE_SPAWN';
-import { UseTimeoutCommitmentDefinition } from './USE_TIMEOUT/USE_TIMEOUT';
-import { UseTimeCommitmentDefinition } from './USE_TIME/USE_TIME';
 import { UseUserLocationCommitmentDefinition } from './USE_USER_LOCATION/USE_USER_LOCATION';
-import { WalletCommitmentDefinition } from './WALLET/WALLET';
 import { WritingRulesCommitmentDefinition } from './WRITING_RULES/WRITING_RULES';
 import { WritingSampleCommitmentDefinition } from './WRITING_SAMPLE/WRITING_SAMPLE';
 import { NotYetImplementedCommitmentDefinition } from './_base/NotYetImplementedCommitmentDefinition';
@@ -72,8 +64,6 @@ export const COMMITMENT_REGISTRY = [
     new PersonaCommitmentDefinition('PERSONA'),
     new PersonaCommitmentDefinition('PERSONAE'),
     new KnowledgeCommitmentDefinition(),
-    new MemoryCommitmentDefinition('MEMORY'),
-    new MemoryCommitmentDefinition('MEMORIES'),
     new StyleCommitmentDefinition('STYLE'),
     new StyleCommitmentDefinition('STYLES'),
     new RuleCommitmentDefinition('RULE'),
@@ -95,7 +85,6 @@ export const COMMITMENT_REGISTRY = [
     new ModelCommitmentDefinition('MODELS'),
     new ActionCommitmentDefinition('ACTION'),
     new ActionCommitmentDefinition('ACTIONS'),
-    new ComponentCommitmentDefinition(),
     new MetaAvatarCommitmentDefinition(),
     new MetaAvatarCommitmentDefinition('META VISUAL'),
     new MetaImageCommitmentDefinition(),
@@ -103,11 +92,13 @@ export const COMMITMENT_REGISTRY = [
     new MetaFontCommitmentDefinition(),
     new MetaLinkCommitmentDefinition(),
     new MetaDomainCommitmentDefinition(),
+    new MetaDescriptionCommitmentDefinition(),
     new MetaDisclaimerCommitmentDefinition(),
+    new MetaFullnameCommitmentDefinition(),
+    new MetaIdCommitmentDefinition(),
     new MetaInputPlaceholderCommitmentDefinition(),
     new MetaThinkingMessageCommitmentDefinition(),
     new MetaVisibilityCommitmentDefinition(),
-    new MetaCommitmentDefinition(),
     new MetaVoiceCommitmentDefinition(),
     new NoteCommitmentDefinition('NOTE'),
     new NoteCommitmentDefinition('NOTES'),
@@ -123,8 +114,6 @@ export const COMMITMENT_REGISTRY = [
     new MessageSuffixCommitmentDefinition(),
     new MessageCommitmentDefinition('MESSAGE'),
     new MessageCommitmentDefinition('MESSAGES'),
-    new WalletCommitmentDefinition('WALLET'),
-    new WalletCommitmentDefinition('WALLETS'),
     new ScenarioCommitmentDefinition('SCENARIO'),
     new ScenarioCommitmentDefinition('SCENARIOS'),
     new DeleteCommitmentDefinition('DELETE'),
@@ -135,15 +124,8 @@ export const COMMITMENT_REGISTRY = [
     new OpenCommitmentDefinition(),
     new ClosedCommitmentDefinition(),
     new TeamCommitmentDefinition(),
-    new UseBrowserCommitmentDefinition(),
-    new UseDeepSearchCommitmentDefinition(),
-    new UseSearchEngineCommitmentDefinition(),
-    new UseSpawnCommitmentDefinition(),
-    new UseTimeoutCommitmentDefinition(),
-    new UseTimeCommitmentDefinition(),
     new UseUserLocationCommitmentDefinition(),
     new UseCalendarCommitmentDefinition(),
-    new UseEmailCommitmentDefinition(),
     new UsePopupCommitmentDefinition(),
     new UseImageGeneratorCommitmentDefinition('USE IMAGE GENERATOR'),
     new UseMcpCommitmentDefinition(),

package/src/conversion/archive/loadArchive.ts

@@ -1,10 +1,10 @@
-import JSZip from 'jszip';
 import { UnexpectedError } from '../../errors/UnexpectedError';
 import type { FilesystemTools } from '../../execution/FilesystemTools';
 import { jsonParse } from '../../formats/json/utils/jsonParse';
 import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
 import type { string_filename } from '../../types/string_filename';
 import { validatePipeline } from '../validation/validatePipeline';
+import { loadJsZipModule } from './loadJsZipModule';
 
 /**
  * Loads the books from the archive file with `.bookc` extension
@@ -24,6 +24,7 @@ export async function loadArchive(
     }
 
     const data = await fs.readFile(filePath);
+    const { default: JSZip } = await loadJsZipModule();
     const archive = await JSZip.loadAsync(data);
 
     const indexFile = archive.file('index.book.json');

package/src/conversion/archive/loadJsZipModule.ts

@@ -0,0 +1,10 @@
+import { createLazyModuleLoader } from '../../utils/misc/createLazyModuleLoader';
+
+/**
+ * Loads the ZIP archive library (`jszip`) on demand
+ *
+ * Note: [🐌] Loaded lazily to keep the startup of the `ptbk` CLI utility fast
+ *
+ * @private internal utility of `loadArchive` and `saveArchive`
+ */
+export const loadJsZipModule = createLazyModuleLoader(() => import('jszip'));

package/src/conversion/archive/saveArchive.ts

@@ -1,10 +1,10 @@
-import JSZip from 'jszip';
 import { UnexpectedError } from '../../errors/UnexpectedError';
 import type { FilesystemTools } from '../../execution/FilesystemTools';
 import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
 import type { string_filename } from '../../types/string_filename';
 import { stringifyPipelineJson } from '../../utils/editable/utils/stringifyPipelineJson';
 import { validatePipeline } from '../validation/validatePipeline';
+import { loadJsZipModule } from './loadJsZipModule';
 
 /**
  * Saves the given books into an archive file with `.bookc` extension
@@ -29,6 +29,7 @@ export async function saveArchive(
         validatePipeline(pipelineJson);
     }
 
+    const { default: JSZip } = await loadJsZipModule();
     const archive = new JSZip();
 
     const collectionJsonString = stringifyPipelineJson(collectionJson);

package/src/llm-providers/agent/Agent.ts

@@ -101,7 +101,7 @@ export class Agent extends AgentLlmExecutionTools implements LlmExecutionTools,
 
     /**
      * Capabilities of the agent
-     * This is parsed from commitments like USE BROWSER, USE SEARCH ENGINE, KNOWLEDGE, etc.
+     * This is parsed from commitments like USE CALENDAR, USE PROJECT, KNOWLEDGE, etc.
      */
     public capabilities: Array<AgentCapability> = [];
 

package/src/llm-providers/anthropic-claude/AnthropicClaudeExecutionTools.ts

@@ -1,5 +1,5 @@
 import type { ClientOptions } from '@anthropic-ai/sdk';
-import Anthropic from '@anthropic-ai/sdk';
+import type Anthropic from '@anthropic-ai/sdk';
 import type { MessageCreateParamsNonStreaming } from '@anthropic-ai/sdk/resources';
 import Bottleneck from 'bottleneck';
 import colors from 'colors'; // <- TODO: [🔶] Make system to put color and style to both node and browser
@@ -19,6 +19,7 @@ import type { string_name } from '../../types/string_name';
 import type { string_title } from '../../types/string_title';
 import type { string_date_iso8601 } from '../../types/string_token';
 import { $getCurrentDate } from '../../utils/misc/$getCurrentDate';
+import { createLazyModuleLoader } from '../../utils/misc/createLazyModuleLoader';
 import type { chococake } from '../../utils/organization/really_any';
 import type { TODO_any } from '../../utils/organization/TODO_any';
 import { templateParameters } from '../../utils/parameters/templateParameters';
@@ -36,6 +37,15 @@ const ANTHROPIC_PROVIDER_PROFILE: ChatParticipant = {
     color: '#d97706',
 } as const;
 
+/**
+ * Loads the Anthropic Claude SDK (`@anthropic-ai/sdk`) on demand
+ *
+ * Note: [🐌] Loaded lazily to keep the startup of the `ptbk` CLI utility fast
+ *
+ * @private internal utility of `AnthropicClaudeExecutionTools`
+ */
+const loadAnthropicClaudeModule = createLazyModuleLoader(() => import('@anthropic-ai/sdk'));
+
 /**
  * Execution Tools for calling Anthropic Claude API.
  *
@@ -80,6 +90,8 @@ export class AnthropicClaudeExecutionTools implements LlmExecutionTools /* <- TO
             const anthropicOptions: ClientOptions = { ...this.options };
             delete (anthropicOptions as chococake).isVerbose;
             delete (anthropicOptions as chococake).isProxied;
+
+            const { Anthropic } = await loadAnthropicClaudeModule();
             this.client = new Anthropic(anthropicOptions);
         }
 

package/src/llm-providers/azure-openai/AzureOpenAiExecutionTools.ts

@@ -1,4 +1,4 @@
-import { AzureKeyCredential, OpenAIClient } from '@azure/openai';
+import type { OpenAIClient } from '@azure/openai';
 import Bottleneck from 'bottleneck';
 import colors from 'colors'; // <- TODO: [🔶] Make system to put color and style to both node and browser
 import type { ChatParticipant } from '../../book-components/Chat/types/ChatParticipant';
@@ -18,6 +18,7 @@ import type { string_completion_prompt } from '../../types/string_prompt';
 import type { string_title } from '../../types/string_title';
 import type { string_date_iso8601 } from '../../types/string_token';
 import { $getCurrentDate } from '../../utils/misc/$getCurrentDate';
+import { createLazyModuleLoader } from '../../utils/misc/createLazyModuleLoader';
 import { keepTypeImported } from '../../utils/organization/keepTypeImported';
 import { templateParameters } from '../../utils/parameters/templateParameters';
 import { exportJson } from '../../utils/serialization/exportJson';
@@ -35,6 +36,15 @@ const AZURE_OPENAI_PROVIDER_PROFILE: ChatParticipant = {
 
 keepTypeImported<Usage>();
 
+/**
+ * Loads the Azure OpenAI SDK (`@azure/openai`) on demand
+ *
+ * Note: [🐌] Loaded lazily to keep the startup of the `ptbk` CLI utility fast
+ *
+ * @private internal utility of `AzureOpenAiExecutionTools`
+ */
+const loadAzureOpenAiModule = createLazyModuleLoader(() => import('@azure/openai'));
+
 /**
  * Execution Tools for calling Azure OpenAI API.
  *
@@ -77,6 +87,8 @@ export class AzureOpenAiExecutionTools implements LlmExecutionTools /* <- TODO:
 
     public async getClient(): Promise<OpenAIClient> {
         if (this.client === null) {
+            const { AzureKeyCredential, OpenAIClient } = await loadAzureOpenAiModule();
+
             this.client = new OpenAIClient(
                 `https://${this.options.resourceName}.openai.azure.com/`,
                 new AzureKeyCredential(this.options.apiKey),

package/src/llm-providers/openai/OpenAiAgentKitExecutionTools.ts

@@ -1,4 +1,4 @@
-import { Agent as AgentFromKit, run, setDefaultOpenAIClient, setDefaultOpenAIKey } from '@openai/agents';
+import type { Agent as AgentFromKit } from '@openai/agents';
 import { NotYetImplementedError } from '../../errors/NotYetImplementedError';
 import { PipelineExecutionError } from '../../errors/PipelineExecutionError';
 import type { CallChatModelStreamOptions, LlmExecutionTools } from '../../execution/LlmExecutionTools';
@@ -23,6 +23,7 @@ import { OpenAiAgentKitExecutionToolsOutputTypeMapper } from './OpenAiAgentKitEx
 import { OpenAiAgentKitExecutionToolsToolBuilder } from './OpenAiAgentKitExecutionToolsToolBuilder';
 import type { OpenAiCompatibleExecutionToolsNonProxiedOptions } from './OpenAiCompatibleExecutionToolsOptions';
 import { OpenAiVectorStoreHandler } from './OpenAiVectorStoreHandler';
+import { loadOpenAiAgentsModule } from './utils/loadOpenAiAgentsModule';
 
 /**
  * Constant for default agent kit model name.
@@ -211,7 +212,8 @@ export class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandler imple
             });
         }
 
-        const agentKitTools = this.buildAgentKitTools({ tools, vectorStoreId });
+        const { Agent: AgentFromKit } = await loadOpenAiAgentsModule();
+        const agentKitTools = await this.buildAgentKitTools({ tools, vectorStoreId });
         const openAiAgentKitAgent = new AgentFromKit({
             name,
             model: this.agentKitModelName,
@@ -275,6 +277,7 @@ export class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandler imple
             agentName: agentForRun.name,
             input: inputItems,
         };
+        const { run } = await loadOpenAiAgentsModule();
         const streamResult = await run(agentForRun, inputItems, {
             stream: true,
             maxTurns: 200,
@@ -433,6 +436,7 @@ export class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandler imple
      * Ensures the AgentKit SDK is wired to the OpenAI client and API key.
      */
     private async ensureAgentKitDefaults(): Promise<void> {
+        const { setDefaultOpenAIClient, setDefaultOpenAIKey } = await loadOpenAiAgentsModule();
         const client = await this.getClient();
         setDefaultOpenAIClient(client as TODO_any);
 

package/src/llm-providers/openai/OpenAiAgentKitExecutionToolsToolBuilder.ts

@@ -1,5 +1,4 @@
 import type { Tool as AgentKitTool } from '@openai/agents';
-import { Agent as AgentFromKit, fileSearchTool, tool as agentKitTool, webSearchTool } from '@openai/agents';
 import { spaceTrim } from 'spacetrim';
 import { parseToolExecutionEnvelope } from '../../commitments/_common/toolExecutionEnvelope';
 import type { ToolCallProgressUpdate } from '../../commitments/_common/toolRuntimeContext';
@@ -26,6 +25,7 @@ import type { TODO_any } from '../../utils/organization/TODO_any';
 import type { OpenAiAgentKitExecutionToolsOptions } from './OpenAiAgentKitExecutionToolsOptions';
 import type { OpenAiCompatibleExecutionToolsNonProxiedOptions } from './OpenAiCompatibleExecutionToolsOptions';
 import { buildToolInvocationScript } from './utils/buildToolInvocationScript';
+import { loadOpenAiAgentsModule } from './utils/loadOpenAiAgentsModule';
 
 /**
  * Constant for default model used for nested DeepSearch tool invocations.
@@ -33,7 +33,7 @@ import { buildToolInvocationScript } from './utils/buildToolInvocationScript';
 const DEFAULT_DEEP_SEARCH_MODEL_NAME = 'o4-mini-deep-research';
 
 /**
- * Tool name used by the Book commitment-backed DeepSearch capability.
+ * Tool name used by the DeepSearch capability.
  */
 const DEEP_SEARCH_TOOL_NAME = 'deep_search' as string_javascript_name;
 
@@ -98,11 +98,12 @@ export class OpenAiAgentKitExecutionToolsToolBuilder {
     /**
      * Builds the tool list for AgentKit, including hosted file search when applicable.
      */
-    public buildAgentKitTools(options: {
+    public async buildAgentKitTools(options: {
         readonly tools?: ModelRequirements['tools'];
         readonly vectorStoreId?: string;
-    }): Array<AgentKitTool> {
+    }): Promise<Array<AgentKitTool>> {
         const { tools, vectorStoreId } = options;
+        const { fileSearchTool, tool: agentKitTool } = await loadOpenAiAgentsModule();
         const agentKitTools: Array<AgentKitTool> = [];
 
         if (vectorStoreId) {
@@ -117,7 +118,7 @@ export class OpenAiAgentKitExecutionToolsToolBuilder {
 
         for (const toolDefinition of tools) {
             if (this.isDeepSearchToolDefinition(toolDefinition)) {
-                agentKitTools.push(this.createDeepSearchAgentKitTool(toolDefinition));
+                agentKitTools.push(await this.createDeepSearchAgentKitTool(toolDefinition));
                 continue;
             }
 
@@ -374,9 +375,10 @@ export class OpenAiAgentKitExecutionToolsToolBuilder {
     }
 
     /**
-     * Creates the native Agent SDK tool used for `USE DEEPSEARCH`.
+     * Creates the native Agent SDK tool used for the DeepSearch capability.
      */
-    private createDeepSearchAgentKitTool(toolDefinition: AgentKitToolDefinition): AgentKitTool {
+    private async createDeepSearchAgentKitTool(toolDefinition: AgentKitToolDefinition): Promise<AgentKitTool> {
+        const { Agent: AgentFromKit, webSearchTool } = await loadOpenAiAgentsModule();
         const deepSearchAgent = new AgentFromKit({
             name: 'DeepSearch',
             model: DEFAULT_DEEP_SEARCH_MODEL_NAME,

package/src/llm-providers/openai/OpenAiAssistantExecutionTools.ts

@@ -1,4 +1,4 @@
-import OpenAI from 'openai';
+import type OpenAI from 'openai';
 import { NotAllowed } from '../../errors/NotAllowed';
 import { NotYetImplementedError } from '../../errors/NotYetImplementedError';
 import { PipelineExecutionError } from '../../errors/PipelineExecutionError';

package/src/llm-providers/openai/OpenAiAssistantExecutionToolsStreamRunner.ts

@@ -1,5 +1,5 @@
 import colors from 'colors'; // <- TODO: [🔶] Make system to put color and style to both node and browser
-import OpenAI from 'openai';
+import type OpenAI from 'openai';
 import { PipelineExecutionError } from '../../errors/PipelineExecutionError';
 import type { ChatPromptResult } from '../../execution/PromptResult';
 import type { Prompt } from '../../types/Prompt';

package/src/llm-providers/openai/OpenAiAssistantExecutionToolsToolRunner.ts

@@ -1,5 +1,5 @@
 import colors from 'colors'; // <- TODO: [🔶] Make system to put color and style to both node and browser
-import OpenAI from 'openai';
+import type OpenAI from 'openai';
 import { spaceTrim } from 'spacetrim';
 import { parseToolExecutionEnvelope } from '../../commitments/_common/toolExecutionEnvelope';
 import type { ToolCallProgressUpdate } from '../../commitments/_common/toolRuntimeContext';