@promptbook/cli 0.103.0-10 → 0.103.0-100

package/esm/typings/src/execution/utils/usage-constants.d.ts

@@ -3,145 +3,25 @@
  *
  * @public exported from `@promptbook/core`
  */
-export declare const ZERO_VALUE: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-    readonly value: 0;
-}>;
+export declare const ZERO_VALUE: any;
 /**
  * Represents the uncertain value
  *
  * @public exported from `@promptbook/core`
  */
-export declare const UNCERTAIN_ZERO_VALUE: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-    readonly value: 0;
-    readonly isUncertain: true;
-}>;
+export declare const UNCERTAIN_ZERO_VALUE: any;
 /**
  * Represents the usage with no resources consumed
  *
  * @public exported from `@promptbook/core`
  */
-export declare const ZERO_USAGE: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-    readonly price: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-        readonly value: 0;
-    }>;
-    readonly input: {
-        readonly tokensCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-        }>;
-        readonly charactersCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-        }>;
-        readonly wordsCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-        }>;
-        readonly sentencesCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-        }>;
-        readonly linesCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-        }>;
-        readonly paragraphsCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-        }>;
-        readonly pagesCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-        }>;
-    };
-    readonly output: {
-        readonly tokensCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-        }>;
-        readonly charactersCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-        }>;
-        readonly wordsCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-        }>;
-        readonly sentencesCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-        }>;
-        readonly linesCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-        }>;
-        readonly paragraphsCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-        }>;
-        readonly pagesCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-        }>;
-    };
-}>;
+export declare const ZERO_USAGE: any;
 /**
  * Represents the usage with unknown resources consumed
  *
  * @public exported from `@promptbook/core`
  */
-export declare const UNCERTAIN_USAGE: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-    readonly price: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-        readonly value: 0;
-        readonly isUncertain: true;
-    }>;
-    readonly input: {
-        readonly tokensCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-            readonly isUncertain: true;
-        }>;
-        readonly charactersCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-            readonly isUncertain: true;
-        }>;
-        readonly wordsCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-            readonly isUncertain: true;
-        }>;
-        readonly sentencesCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-            readonly isUncertain: true;
-        }>;
-        readonly linesCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-            readonly isUncertain: true;
-        }>;
-        readonly paragraphsCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-            readonly isUncertain: true;
-        }>;
-        readonly pagesCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-            readonly isUncertain: true;
-        }>;
-    };
-    readonly output: {
-        readonly tokensCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-            readonly isUncertain: true;
-        }>;
-        readonly charactersCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-            readonly isUncertain: true;
-        }>;
-        readonly wordsCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-            readonly isUncertain: true;
-        }>;
-        readonly sentencesCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-            readonly isUncertain: true;
-        }>;
-        readonly linesCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-            readonly isUncertain: true;
-        }>;
-        readonly paragraphsCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-            readonly isUncertain: true;
-        }>;
-        readonly pagesCount: import("type-fest/source/readonly-deep").ReadonlyObjectDeep<{
-            readonly value: 0;
-            readonly isUncertain: true;
-        }>;
-    };
-}>;
+export declare const UNCERTAIN_USAGE: any;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/execution/utils/validatePromptResult.d.ts

@@ -46,6 +46,8 @@ export type ValidatePromptResultResult = {
  * This function provides a common abstraction for result validation that can be used
  * by both execution logic and caching logic to ensure consistency.
  *
+ * Note: [🔂] This function is idempotent.
+ *
  * @param options - The validation options including result string, expectations, and format
  * @returns Validation result with processed string and validity status
  * @private internal function of `createPipelineExecutor` and `cacheLlmTools`

package/esm/typings/src/high-level-abstractions/_common/HighLevelAbstraction.d.ts

@@ -1,4 +1,5 @@
 import type { $PipelineJson } from '../../commands/_common/types/CommandParser';
+import type { $side_effect } from '../../utils/organization/$side_effect';
 /**
  * Used in `parsePipeline`
  *
@@ -11,7 +12,7 @@ export type SyncHighLevelAbstraction = {
      *
      * Note: `$` is used to indicate that this function mutates given `pipelineJson`
      */
-    $applyToPipelineJson($pipelineJson: $PipelineJson): void;
+    $applyToPipelineJson($pipelineJson: $PipelineJson): $side_effect;
 };
 /**
  * TODO: [♓️] Add order here

package/esm/typings/src/llm-providers/_common/register/$provideLlmToolsForWizardOrCli.d.ts

@@ -1,7 +1,7 @@
 import { Promisable } from 'type-fest';
 import type { Identification } from '../../../remote-server/socket-types/_subtypes/Identification';
 import type { string_app_id, string_url } from '../../../types/typeAliases';
-import type { really_any } from '../../../utils/organization/really_any';
+import type { chococake } from '../../../utils/organization/really_any';
 import type { CacheLlmToolsOptions } from '../utils/cache/CacheLlmToolsOptions';
 import type { LlmExecutionToolsWithTotalUsage } from '../utils/count-total-usage/LlmExecutionToolsWithTotalUsage';
 type ProvideLlmToolsForWizardOrCliOptions = {
@@ -38,7 +38,7 @@ type ProvideLlmToolsForWizardOrCliOptions = {
      *
      * Note: When login prompt fails, `process.exit(1)` is called
      */
-    loginPrompt(): Promisable<Identification<really_any>>;
+    loginPrompt(): Promisable<Identification<chococake>>;
 });
 /**
  * Returns LLM tools for CLI

package/esm/typings/src/llm-providers/_common/register/$registeredLlmToolsMessage.d.ts

@@ -1,4 +1,5 @@
 import type { string_filename, string_markdown } from '../../../types/typeAliases';
+import type { $side_effect } from '../../../utils/organization/$side_effect';
 /**
  * Pass the `.env` file which was used to configure LLM tools
  *
@@ -6,7 +7,7 @@ import type { string_filename, string_markdown } from '../../../types/typeAliase
  *
  * @private internal log of `$provideLlmToolsConfigurationFromEnv` and `$registeredLlmToolsMessage`
  */
-export declare function $setUsedEnvFilename(filepath: string_filename): void;
+export declare function $setUsedEnvFilename(filepath: string_filename): $side_effect;
 /**
  * Creates a message with all registered LLM tools
  *

package/esm/typings/src/llm-providers/_common/register/LlmToolsMetadata.d.ts

@@ -26,7 +26,7 @@ export type LlmToolsMetadata = Registered & {
     /**
      * How is the model provider important and should be sorted in the list of available providers?
      */
-    readonly order: typeof MODEL_ORDERS[keyof typeof MODEL_ORDERS] | number;
+    readonly order: (typeof MODEL_ORDERS)[keyof typeof MODEL_ORDERS] | number;
     /**
      * List of environment variables that can be used to configure the provider
      *

package/esm/typings/src/llm-providers/_common/utils/assertUniqueModels.d.ts

@@ -0,0 +1,12 @@
+import { AvailableModel } from '../../../execution/AvailableModel';
+/**
+ * Utility to assert that all models in the provided array have unique `modelName` values.
+ *
+ * This is internal utility for unit tests to ensure no duplicate model names exist.
+ *
+ * @private internal utility of unit tests
+ */
+export declare function assertUniqueModels(models: ReadonlyArray<AvailableModel>): void;
+/**
+ * Note: [⚪] This should never be in any released package
+ */

package/esm/typings/src/llm-providers/_multiple/getSingleLlmExecutionTools.d.ts

@@ -7,5 +7,6 @@ import { MultipleLlmExecutionTools } from './MultipleLlmExecutionTools';
  */
 export declare function getSingleLlmExecutionTools(oneOrMoreLlmExecutionTools: undefined | LlmExecutionTools | ReadonlyArray<LlmExecutionTools>): LlmExecutionTools | MultipleLlmExecutionTools;
 /**
+ * TODO: [🙆] `getSingleLlmExecutionTools` vs `joinLlmExecutionTools` - explain difference or pick one
  * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
  */

package/esm/typings/src/llm-providers/_multiple/joinLlmExecutionTools.d.ts

@@ -18,5 +18,6 @@ import { MultipleLlmExecutionTools } from './MultipleLlmExecutionTools';
  */
 export declare function joinLlmExecutionTools(title: string_title & string_markdown_text, ...llmExecutionTools: ReadonlyArray<LlmExecutionTools>): MultipleLlmExecutionTools;
 /**
+ * TODO: [🙆] `getSingleLlmExecutionTools` vs `joinLlmExecutionTools` - explain difference or pick one
  * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
  */

package/esm/typings/src/llm-providers/agent/Agent.d.ts

@@ -0,0 +1,70 @@
+import { BehaviorSubject } from 'rxjs';
+import type { AgentBasicInformation, BookParameter } from '../../book-2.0/agent-source/AgentBasicInformation';
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { ChatPromptResult } from '../../execution/PromptResult';
+import type { Prompt } from '../../types/Prompt';
+import type { string_agent_hash, string_agent_name, string_agent_url, string_url_image } from '../../types/typeAliases';
+import { AgentLlmExecutionTools } from './AgentLlmExecutionTools';
+import type { AgentOptions } from './AgentOptions';
+/**
+ * Represents one AI Agent
+ *
+ * Note: [🦖] There are several different things in Promptbook:
+ * - `Agent` - which represents an AI Agent with its source, memories, actions, etc. Agent is a higher-level abstraction which is internally using:
+ * - `LlmExecutionTools` - which wraps one or more LLM models and provides an interface to execute them
+ * - `AgentLlmExecutionTools` - which is a specific implementation of `LlmExecutionTools` that wraps another LlmExecutionTools and applies agent-specific system prompts and requirements
+ * - `OpenAiAssistantExecutionTools` - which is a specific implementation of `LlmExecutionTools` for OpenAI models with assistant capabilities, recommended for usage in `Agent` or `AgentLlmExecutionTools`
+ * - `RemoteAgent` - which is an `Agent` that connects to a Promptbook Agents Server
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare class Agent extends AgentLlmExecutionTools implements LlmExecutionTools, AgentBasicInformation {
+    private _agentName;
+    /**
+     * Name of the agent
+     */
+    get agentName(): string_agent_name;
+    /**
+     * Description of the agent
+     */
+    personaDescription: string | null;
+    /**
+     * The initial message shown to the user when the chat starts
+     */
+    initialMessage: string | null;
+    /**
+     * Links found in the agent source
+     */
+    links: Array<string_agent_url>;
+    /**
+     * Computed hash of the agent source for integrity verification
+     */
+    get agentHash(): string_agent_hash;
+    /**
+     * Metadata like image or color
+     */
+    meta: {
+        fullname?: string;
+        image?: string_url_image;
+        link?: string;
+        title?: string;
+        description?: string;
+        [key: string]: string | undefined;
+    };
+    /**
+     * Not used in Agent, always returns empty array
+     */
+    get parameters(): BookParameter[];
+    readonly agentSource: BehaviorSubject<string_book>;
+    constructor(options: AgentOptions);
+    /**
+     * Calls the chat model with agent-specific system prompt and requirements with streaming
+     *
+     * Note: This method also implements the learning mechanism
+     */
+    callChatModelStream(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void): Promise<ChatPromptResult>;
+}
+/**
+ * TODO: [🧠][😰]Agent is not working with the parameters, should it be?
+ */

package/esm/typings/src/llm-providers/agent/AgentLlmExecutionTools.d.ts

@@ -1,4 +1,5 @@
 import type { Promisable } from 'type-fest';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
 import type { string_book } from '../../book-2.0/agent-source/string_book';
 import type { ChatParticipant } from '../../book-components/Chat/types/ChatParticipant';
 import type { AvailableModel } from '../../execution/AvailableModel';
@@ -6,15 +7,26 @@ import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import type { ChatPromptResult } from '../../execution/PromptResult';
 import type { Prompt } from '../../types/Prompt';
 import type { string_markdown, string_markdown_text, string_model_name, string_title } from '../../types/typeAliases';
+import type { CreateAgentLlmExecutionToolsOptions } from './CreateAgentLlmExecutionToolsOptions';
 /**
  * Execution Tools for calling LLM models with a predefined agent "soul"
  * This wraps underlying LLM execution tools and applies agent-specific system prompts and requirements
  *
+ * Note: [🦖] There are several different things in Promptbook:
+ * - `Agent` - which represents an AI Agent with its source, memories, actions, etc. Agent is a higher-level abstraction which is internally using:
+ * - `LlmExecutionTools` - which wraps one or more LLM models and provides an interface to execute them
+ * - `AgentLlmExecutionTools` - which is a specific implementation of `LlmExecutionTools` that wraps another LlmExecutionTools and applies agent-specific system prompts and requirements
+ * - `OpenAiAssistantExecutionTools` - which is a specific implementation of `LlmExecutionTools` for OpenAI models with assistant capabilities, recommended for usage in `Agent` or `AgentLlmExecutionTools`
+ * - `RemoteAgent` - which is an `Agent` that connects to a Promptbook Agents Server
+ *
  * @public exported from `@promptbook/core`
  */
 export declare class AgentLlmExecutionTools implements LlmExecutionTools {
-    private readonly llmTools;
-    private readonly agentSource;
+    private readonly options;
+    /**
+     * Cache of OpenAI assistants to avoid creating duplicates
+     */
+    private static assistantCache;
     /**
      * Cached model requirements to avoid re-parsing the agent source
      */
@@ -29,7 +41,13 @@ export declare class AgentLlmExecutionTools implements LlmExecutionTools {
      * @param llmTools The underlying LLM execution tools to wrap
      * @param agentSource The agent source string that defines the agent's behavior
      */
-    constructor(llmTools: LlmExecutionTools, agentSource: string_book);
+    constructor(options: CreateAgentLlmExecutionToolsOptions);
+    /**
+     * Updates the agent source and clears the cache
+     *
+     * @param agentSource The new agent source string
+     */
+    protected updateAgentSource(agentSource: string_book): void;
     /**
      * Get cached or parse agent information
      */
@@ -37,7 +55,7 @@ export declare class AgentLlmExecutionTools implements LlmExecutionTools {
     /**
      * Get cached or create agent model requirements
      */
-    private getAgentModelRequirements;
+    protected getAgentModelRequirements(): Promise<AgentModelRequirements>;
     get title(): string_title & string_markdown_text;
     get description(): string_markdown;
     get profile(): ChatParticipant | undefined;
@@ -51,6 +69,10 @@ export declare class AgentLlmExecutionTools implements LlmExecutionTools {
      * Calls the chat model with agent-specific system prompt and requirements
      */
     callChatModel(prompt: Prompt): Promise<ChatPromptResult>;
+    /**
+     * Calls the chat model with agent-specific system prompt and requirements with streaming
+     */
+    callChatModelStream(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void): Promise<ChatPromptResult>;
 }
 /**
  * TODO: [🍚] Implement Destroyable pattern to free resources

package/esm/typings/src/llm-providers/agent/AgentOptions.d.ts

@@ -0,0 +1,19 @@
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
+import type { ExecutionTools } from '../../execution/ExecutionTools';
+import type { Updatable } from '../../types/Updatable';
+/**
+ * Options for creating an Agent
+ */
+export type AgentOptions = CommonToolsOptions & {
+    /**
+     * The execution tools available to the agent
+     *
+     * Here the agent has access to various LLM models, browser, scrapers, LibreOffice, tools, etc.
+     */
+    executionTools: ExecutionTools;
+    /**
+     * The source of the agent
+     */
+    agentSource: Updatable<string_book>;
+};

package/esm/typings/src/llm-providers/agent/CreateAgentLlmExecutionToolsOptions.d.ts

@@ -0,0 +1,17 @@
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
+import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import { OpenAiAssistantExecutionTools } from '../openai/OpenAiAssistantExecutionTools';
+/**
+ * Options for creating AgentLlmExecutionTools
+ */
+export type CreateAgentLlmExecutionToolsOptions = CommonToolsOptions & {
+    /**
+     * The underlying LLM execution tools to wrap
+     */
+    llmTools: LlmExecutionTools | OpenAiAssistantExecutionTools;
+    /**
+     * The agent source string that defines the agent's behavior
+     */
+    agentSource: string_book;
+};

package/esm/typings/src/llm-providers/agent/RemoteAgent.d.ts

@@ -0,0 +1,50 @@
+import type { ChatPromptResult } from '../../execution/PromptResult';
+import type { Prompt } from '../../types/Prompt';
+import type { string_agent_hash, string_agent_name } from '../../types/typeAliases';
+import { Agent } from './Agent';
+import type { RemoteAgentOptions } from './RemoteAgentOptions';
+/**
+ * Represents one AI Agent
+ *
+ * Note: [🦖] There are several different things in Promptbook:
+ * - `Agent` - which represents an AI Agent with its source, memories, actions, etc. Agent is a higher-level abstraction which is internally using:
+ * - `LlmExecutionTools` - which wraps one or more LLM models and provides an interface to execute them
+ * - `AgentLlmExecutionTools` - which is a specific implementation of `LlmExecutionTools` that wraps another LlmExecutionTools and applies agent-specific system prompts and requirements
+ * - `OpenAiAssistantExecutionTools` - which is a specific implementation of `LlmExecutionTools` for OpenAI models with assistant capabilities, recommended for usage in `Agent` or `AgentLlmExecutionTools`
+ * - `RemoteAgent` - which is an `Agent` that connects to a Promptbook Agents Server
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare class RemoteAgent extends Agent {
+    static connect(options: RemoteAgentOptions): Promise<RemoteAgent>;
+    /**
+     * The source of the agent
+     */
+    private agentUrl;
+    private _remoteAgentName;
+    private _remoteAgentHash;
+    private _isVoiceCallingEnabled;
+    private constructor();
+    get agentName(): string_agent_name;
+    get agentHash(): string_agent_hash;
+    /**
+     * Calls the agent on agents remote server
+     */
+    callChatModel(prompt: Prompt): Promise<ChatPromptResult>;
+    /**
+     * Calls the agent on agents remote server with voice
+     * [✨✷] Only available when voice calling is enabled on the server
+     * Returns undefined if voice calling is disabled
+     */
+    get callVoiceChatModel(): ((audio: Blob, prompt: Prompt) => Promise<{
+        text: string;
+        audio: Blob;
+        userMessage?: string;
+        agentMessage?: string;
+    }>) | undefined;
+    callChatModelStream(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void): Promise<ChatPromptResult>;
+}
+/**
+ * TODO: [🧠][😰]Agent is not working with the parameters, should it be?
+ * TODO: !!! Agent on remote server
+ */

package/esm/typings/src/llm-providers/agent/RemoteAgentOptions.d.ts

@@ -0,0 +1,11 @@
+import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
+import type { string_agent_url } from '../../types/typeAliases';
+/**
+ * Options for creating a Remote Agent
+ */
+export type RemoteAgentOptions = CommonToolsOptions & {
+    /**
+     * Url of the remote agent
+     */
+    agentUrl: string_agent_url;
+};

package/esm/typings/src/llm-providers/agent/createAgentLlmExecutionTools.d.ts

@@ -1,19 +1,5 @@
-import type { string_book } from '../../book-2.0/agent-source/string_book';
-import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import { AgentLlmExecutionTools } from './AgentLlmExecutionTools';
-/**
- * Options for creating AgentLlmExecutionTools
- */
-export type CreateAgentLlmExecutionToolsOptions = {
-    /**
-     * The underlying LLM execution tools to wrap
-     */
-    llmTools: LlmExecutionTools;
-    /**
-     * The agent source string that defines the agent's behavior
-     */
-    agentSource: string_book;
-};
+import type { CreateAgentLlmExecutionToolsOptions } from './CreateAgentLlmExecutionToolsOptions';
 /**
  * Creates new AgentLlmExecutionTools that wrap underlying LLM tools with agent-specific behavior
  *
@@ -23,7 +9,3 @@ export declare const createAgentLlmExecutionTools: ((options: CreateAgentLlmExec
     packageName: string;
     className: string;
 };
-/**
- * TODO: [🧠] Consider adding validation for agent source format
- * TODO: [🧠] Consider adding options for caching behavior
- */

package/esm/typings/src/llm-providers/anthropic-claude/anthropic-claude-models.d.ts

@@ -3,7 +3,7 @@ import type { number_usd } from '../../types/typeAliases';
 /**
  * List of available Anthropic Claude models with pricing
  *
- * Note: Synced with official API docs at 2025-08-20
+ * Note: Synced with official API docs at 2025-11-19
  *
  * @see https://docs.anthropic.com/en/docs/models-overview
  * @public exported from `@promptbook/anthropic-claude`

package/esm/typings/src/llm-providers/google/google-models.d.ts

@@ -3,7 +3,7 @@ import type { number_usd } from '../../types/typeAliases';
 /**
  * List of available Google models with descriptions
  *
- * Note: Synced with official API docs at 2025-08-20
+ * Note: Synced with official API docs at 2025-11-19
  *
  * @see https://ai.google.dev/models/gemini
  * @public exported from `@promptbook/google`

package/esm/typings/src/llm-providers/openai/OpenAiAssistantExecutionTools.d.ts

@@ -1,7 +1,7 @@
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import type { ChatPromptResult } from '../../execution/PromptResult';
 import type { Prompt } from '../../types/Prompt';
-import type { string_markdown, string_markdown_text, string_title } from '../../types/typeAliases';
+import type { string_markdown, string_markdown_text, string_title, string_token } from '../../types/typeAliases';
 import type { OpenAiAssistantExecutionToolsOptions } from './OpenAiAssistantExecutionToolsOptions';
 import { OpenAiExecutionTools } from './OpenAiExecutionTools';
 /**
@@ -9,10 +9,18 @@ import { OpenAiExecutionTools } from './OpenAiExecutionTools';
  *
  * This is useful for calling OpenAI API with a single assistant, for more wide usage use `OpenAiExecutionTools`.
  *
+ * Note: [🦖] There are several different things in Promptbook:
+ * - `Agent` - which represents an AI Agent with its source, memories, actions, etc. Agent is a higher-level abstraction which is internally using:
+ * - `LlmExecutionTools` - which wraps one or more LLM models and provides an interface to execute them
+ * - `AgentLlmExecutionTools` - which is a specific implementation of `LlmExecutionTools` that wraps another LlmExecutionTools and applies agent-specific system prompts and requirements
+ * - `OpenAiAssistantExecutionTools` - which is a specific implementation of `LlmExecutionTools` for OpenAI models with assistant capabilities, recommended for usage in `Agent` or `AgentLlmExecutionTools`
+ * - `RemoteAgent` - which is an `Agent` that connects to a Promptbook Agents Server
+ *
  * @public exported from `@promptbook/openai`
  */
 export declare class OpenAiAssistantExecutionTools extends OpenAiExecutionTools implements LlmExecutionTools {
-    private readonly assistantId;
+    readonly assistantId: string_token;
+    private readonly isCreatingNewAssistantsAllowed;
     /**
      * Creates OpenAI Execution Tools.
      *
@@ -25,6 +33,56 @@ export declare class OpenAiAssistantExecutionTools extends OpenAiExecutionTools
      * Calls OpenAI API to use a chat model.
      */
     callChatModel(prompt: Pick<Prompt, 'content' | 'parameters' | 'modelRequirements' | 'format'>): Promise<ChatPromptResult>;
+    /**
+     * Calls OpenAI API to use a chat model with streaming.
+     */
+    callChatModelStream(prompt: Pick<Prompt, 'content' | 'parameters' | 'modelRequirements' | 'format'>, onProgress: (chunk: ChatPromptResult) => void): Promise<ChatPromptResult>;
+    /**
+     * Get an existing assistant tool wrapper
+     */
+    getAssistant(assistantId: string_token): OpenAiAssistantExecutionTools;
+    createNewAssistant(options: {
+        /**
+         * Name of the new assistant
+         */
+        readonly name: string_title;
+        /**
+         * Instructions for the new assistant
+         */
+        readonly instructions: string_markdown;
+        /**
+         * Optional list of knowledge source links (URLs or file paths) to attach to the assistant via vector store
+         */
+        readonly knowledgeSources?: ReadonlyArray<string>;
+    }): Promise<OpenAiAssistantExecutionTools>;
+    updateAssistant(options: {
+        /**
+         * ID of the assistant to update
+         */
+        readonly assistantId: string_token;
+        /**
+         * Name of the assistant
+         */
+        readonly name?: string_title;
+        /**
+         * Instructions for the assistant
+         */
+        readonly instructions?: string_markdown;
+        /**
+         * Optional list of knowledge source links (URLs or file paths) to attach to the assistant via vector store
+         */
+        readonly knowledgeSources?: ReadonlyArray<string>;
+    }): Promise<OpenAiAssistantExecutionTools>;
+    /**
+     * Discriminant for type guards
+     */
+    protected get discriminant(): string;
+    /**
+     * Type guard to check if given `LlmExecutionTools` are instanceof `OpenAiAssistantExecutionTools`
+     *
+     * Note: This is useful when you can possibly have multiple versions of `@promptbook/openai` installed
+     */
+    static isOpenAiAssistantExecutionTools(llmExecutionTools: LlmExecutionTools): llmExecutionTools is OpenAiAssistantExecutionTools;
 }
 /**
  * TODO: [🧠][🧙‍♂️] Maybe there can be some wizard for those who want to use just OpenAI

package/esm/typings/src/llm-providers/openai/OpenAiAssistantExecutionToolsOptions.d.ts

@@ -7,8 +7,14 @@ import type { OpenAiCompatibleExecutionToolsOptions } from './OpenAiCompatibleEx
  * @public exported from `@promptbook/openai`
  */
 export type OpenAiAssistantExecutionToolsOptions = OpenAiCompatibleExecutionToolsOptions & ClientOptions & {
+    /**
+     * Whether creating new assistants is allowed
+     *
+     * @default false
+     */
+    readonly isCreatingNewAssistantsAllowed?: boolean;
     /**
      * Which assistant to use
      */
-    assistantId: string_token;
+    readonly assistantId: string_token;
 };

package/esm/typings/src/llm-providers/openai/openai-models.d.ts

@@ -2,7 +2,7 @@ import type { AvailableModel } from '../../execution/AvailableModel';
 /**
  * List of available OpenAI models with pricing
  *
- * Note: Synced with official API docs at 2025-08-20
+ * Note: Synced with official API docs at 2025-11-19
  *
  * @see https://platform.openai.com/docs/models/
  * @see https://openai.com/api/pricing/