@promptbook/node 0.101.0-12 → 0.101.0-14

package/esm/typings/src/_packages/core.index.d.ts

@@ -121,6 +121,10 @@ import { countUsage } from '../llm-providers/_common/utils/count-total-usage/cou
 import { limitTotalUsage } from '../llm-providers/_common/utils/count-total-usage/limitTotalUsage';
 import { joinLlmExecutionTools } from '../llm-providers/_multiple/joinLlmExecutionTools';
 import { MultipleLlmExecutionTools } from '../llm-providers/_multiple/MultipleLlmExecutionTools';
+import { AgentLlmExecutionTools } from '../llm-providers/agent/AgentLlmExecutionTools';
+import { createAgentLlmExecutionTools } from '../llm-providers/agent/createAgentLlmExecutionTools';
+import { _AgentMetadata } from '../llm-providers/agent/register-configuration';
+import { _AgentRegistration } from '../llm-providers/agent/register-constructor';
 import { _AnthropicClaudeMetadataRegistration } from '../llm-providers/anthropic-claude/register-configuration';
 import { _AzureOpenAiMetadataRegistration } from '../llm-providers/azure-openai/register-configuration';
 import { _DeepseekMetadataRegistration } from '../llm-providers/deepseek/register-configuration';
@@ -287,6 +291,10 @@ export { countUsage };
 export { limitTotalUsage };
 export { joinLlmExecutionTools };
 export { MultipleLlmExecutionTools };
+export { AgentLlmExecutionTools };
+export { createAgentLlmExecutionTools };
+export { _AgentMetadata };
+export { _AgentRegistration };
 export { _AnthropicClaudeMetadataRegistration };
 export { _AzureOpenAiMetadataRegistration };
 export { _DeepseekMetadataRegistration };

package/esm/typings/src/_packages/types.index.d.ts

@@ -93,6 +93,7 @@ import type { LlmToolsOptions } from '../llm-providers/_common/register/LlmTools
 import type { CacheItem } from '../llm-providers/_common/utils/cache/CacheItem';
 import type { CacheLlmToolsOptions } from '../llm-providers/_common/utils/cache/CacheLlmToolsOptions';
 import type { LlmExecutionToolsWithTotalUsage } from '../llm-providers/_common/utils/count-total-usage/LlmExecutionToolsWithTotalUsage';
+import type { CreateAgentLlmExecutionToolsOptions } from '../llm-providers/agent/createAgentLlmExecutionTools';
 import type { AnthropicClaudeExecutionToolsOptions } from '../llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions';
 import type { AnthropicClaudeExecutionToolsNonProxiedOptions } from '../llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions';
 import type { AnthropicClaudeExecutionToolsProxiedOptions } from '../llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions';
@@ -418,6 +419,7 @@ export type { LlmToolsOptions };
 export type { CacheItem };
 export type { CacheLlmToolsOptions };
 export type { LlmExecutionToolsWithTotalUsage };
+export type { CreateAgentLlmExecutionToolsOptions };
 export type { AnthropicClaudeExecutionToolsOptions };
 export type { AnthropicClaudeExecutionToolsNonProxiedOptions };
 export type { AnthropicClaudeExecutionToolsProxiedOptions };

package/esm/typings/src/book-2.0/agent-source/createAgentModelRequirements.d.ts

@@ -1,3 +1,4 @@
+import type { AvailableModel } from '../../execution/AvailableModel';
 import type { string_model_name } from '../../types/typeAliases';
 import type { AgentModelRequirements } from './AgentModelRequirements';
 import type { string_book } from './string_book';
@@ -11,7 +12,7 @@ import type { string_book } from './string_book';
  *
  * @public exported from `@promptbook/core`
  */
-export declare function createAgentModelRequirements(agentSource: string_book, modelName?: string_model_name): Promise<AgentModelRequirements>;
+export declare function createAgentModelRequirements(agentSource: string_book, modelName?: string_model_name, availableModels?: readonly AvailableModel[]): Promise<AgentModelRequirements>;
 /**
  * Clears the cache for createAgentModelRequirements
  * Useful when agent sources are updated and cached results should be invalidated
@@ -60,3 +61,6 @@ export declare function extractAgentName(agentSource: string_book): string;
  * @private
  */
 export declare function extractAgentProfileImage(agentSource: string_book): string;
+/**
+ * TODO: [😩] DRY `preparePersona` and `selectBestModelFromAvailable`
+ */

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

@@ -0,0 +1,54 @@
+import type { Promisable } from 'type-fest';
+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';
+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';
+/**
+ * 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
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare class AgentLlmExecutionTools implements LlmExecutionTools {
+    private readonly llmTools;
+    private readonly agentSource;
+    /**
+     * Cached model requirements to avoid re-parsing the agent source
+     */
+    private _cachedModelRequirements;
+    /**
+     * Cached parsed agent information
+     */
+    private _cachedAgentInfo;
+    /**
+     * Creates new AgentLlmExecutionTools
+     *
+     * @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);
+    /**
+     * Get cached or parse agent information
+     */
+    private getAgentInfo;
+    /**
+     * Get cached or create agent model requirements
+     */
+    private getAgentModelRequirements;
+    get title(): string_title & string_markdown_text;
+    get description(): string_markdown;
+    get profile(): ChatParticipant | undefined;
+    checkConfiguration(): Promisable<void>;
+    listModels(): Promisable<ReadonlyArray<AvailableModel>>;
+    /**
+     * Calls the chat model with agent-specific system prompt and requirements
+     */
+    callChatModel(prompt: Prompt): Promise<ChatPromptResult>;
+}
+/**
+ * TODO: [🍚] Implement Destroyable pattern to free resources
+ * TODO: !!!! adding parameter substitution support
+ */

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

@@ -0,0 +1,29 @@
+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;
+};
+/**
+ * Creates new AgentLlmExecutionTools that wrap underlying LLM tools with agent-specific behavior
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const createAgentLlmExecutionTools: ((options: CreateAgentLlmExecutionToolsOptions) => AgentLlmExecutionTools) & {
+    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/agent/playground/playground.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env ts-node
+export {};
+/**
+ * TODO: [🧠] Add more complex agent scenarios
+ * TODO: [🧠] Add parameter substitution demo
+ * TODO: [🧠] Add multi-turn conversation demo
+ * Note: [⚫] Code in this file should never be published in any package
+ */

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

@@ -0,0 +1,11 @@
+/**
+ * Metadata for Agent LLM execution tools
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const _AgentMetadata: import("../../utils/$Register").Registration;
+/**
+ * TODO: [🧠] Consider adding a special trust level for AgentLlmExecutionTools
+ * TODO: [🎶] Naming "constructor" vs "creator" vs "factory"
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

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

@@ -0,0 +1,13 @@
+import type { Registration } from '../../utils/$Register';
+/**
+ * Registration of Agent LLM provider
+ *
+ * Warning: This is not useful for the end user, it is just a side effect of the mechanism that handles all available LLM tools
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const _AgentRegistration: Registration;
+/**
+ * TODO: [🎶] Naming "constructor" vs "creator" vs "factory"
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/personas/preparePersona.d.ts

@@ -10,6 +10,7 @@ import type { string_persona_description } from '../types/typeAliases';
  */
 export declare function preparePersona(personaDescription: string_persona_description, tools: Pick<ExecutionTools, 'llm'>, options: PrepareAndScrapeOptions): Promise<Pick<PersonaPreparedJson, 'modelsRequirements'>>;
 /**
+ * TODO: [😩] DRY `preparePersona` and `selectBestModelFromAvailable`
  * TODO: [🔃][main] If the persona was prepared with different version or different set of models, prepare it once again
  * TODO: [🏢] Check validity of `modelName` in pipeline
  * TODO: [🏢] Check validity of `systemMessage` in pipeline

package/esm/typings/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.101.0-11`).
+ * It follows semantic versioning (e.g., `0.101.0-13`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/node",
-    "version": "0.101.0-12",
+    "version": "0.101.0-14",
     "description": "Promptbook: Run AI apps in plain human language across multiple models and platforms",
     "private": false,
     "sideEffects": false,
@@ -93,7 +93,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/node.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.101.0-12"
+        "@promptbook/core": "0.101.0-14"
     },
     "dependencies": {
         "colors": "1.4.0",

package/umd/index.umd.js

@@ -45,7 +45,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.101.0-12';
+    const PROMPTBOOK_ENGINE_VERSION = '0.101.0-14';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -5369,6 +5369,7 @@
         };
     }
     /**
+     * TODO: [😩] DRY `preparePersona` and `selectBestModelFromAvailable`
      * TODO: [🔃][main] If the persona was prepared with different version or different set of models, prepare it once again
      * TODO: [🏢] Check validity of `modelName` in pipeline
      * TODO: [🏢] Check validity of `systemMessage` in pipeline