@promptbook/legacy-documents 0.104.0 → 0.105.0-1

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

@@ -47,6 +47,7 @@ import { PENDING_VALUE_PLACEHOLDER } from '../config';
 import { MAX_FILENAME_LENGTH } from '../config';
 import { DEFAULT_INTERMEDIATE_FILES_STRATEGY } from '../config';
 import { DEFAULT_MAX_PARALLEL_COUNT } from '../config';
+import { DEFAULT_MAX_RECURSION } from '../config';
 import { DEFAULT_MAX_EXECUTION_ATTEMPTS } from '../config';
 import { DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH } from '../config';
 import { DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL } from '../config';
@@ -244,6 +245,7 @@ export { PENDING_VALUE_PLACEHOLDER };
 export { MAX_FILENAME_LENGTH };
 export { DEFAULT_INTERMEDIATE_FILES_STRATEGY };
 export { DEFAULT_MAX_PARALLEL_COUNT };
+export { DEFAULT_MAX_RECURSION };
 export { DEFAULT_MAX_EXECUTION_ATTEMPTS };
 export { DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_DEPTH };
 export { DEFAULT_MAX_KNOWLEDGE_SOURCES_SCRAPING_TOTAL };

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

@@ -28,6 +28,10 @@ export type AgentModelRequirements = {
      * -  3) `parentAgentUrl` is not defined `undefined`,  the default ancestor agent, Adam,  will be used
      */
     readonly parentAgentUrl?: string_agent_url | null;
+    /**
+     * List of imported agent URLs
+     */
+    readonly importedAgentUrls?: ReadonlyArray<string_agent_url>;
     /**
      * Optional list of knowledge source links that the agent can use
      */

package/esm/typings/src/book-components/Chat/types/ChatMessage.d.ts

@@ -33,6 +33,23 @@ export type ChatMessage = Omit<Message<id>, 'direction' | 'recipients' | 'thread
      * Indicates if the message was sent via a voice call
      */
     isVoiceCall?: boolean;
+    /**
+     * Optional file attachments
+     */
+    attachments?: Array<{
+        /**
+         * The name of the file
+         */
+        name: string;
+        /**
+         * The type of the file
+         */
+        type: string;
+        /**
+         * The URL where the file is stored
+         */
+        url: string;
+    }>;
 };
 /**
  * TODO: Make all fields readonly

package/esm/typings/src/commitments/IMPORT/IMPORT.d.ts

@@ -0,0 +1,34 @@
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * IMPORT commitment definition
+ *
+ * The IMPORT commitment tells the agent to import content from another agent at the current location.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * IMPORT https://s6.ptbk.io/benjamin-white
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class ImportCommitmentDefinition extends BaseCommitmentDefinition<'IMPORT' | 'IMPORTS'> {
+    constructor(type?: 'IMPORT' | 'IMPORTS');
+    /**
+     * Short one-line description of IMPORT.
+     */
+    get description(): string;
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string;
+    /**
+     * Markdown documentation for IMPORT commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/commitments/index.d.ts

@@ -7,6 +7,7 @@ import { DeleteCommitmentDefinition } from './DELETE/DELETE';
 import { DictionaryCommitmentDefinition } from './DICTIONARY/DICTIONARY';
 import { FormatCommitmentDefinition } from './FORMAT/FORMAT';
 import { FromCommitmentDefinition } from './FROM/FROM';
+import { ImportCommitmentDefinition } from './IMPORT/IMPORT';
 import { GoalCommitmentDefinition } from './GOAL/GOAL';
 import { KnowledgeCommitmentDefinition } from './KNOWLEDGE/KNOWLEDGE';
 import { LanguageCommitmentDefinition } from './LANGUAGE/LANGUAGE';
@@ -40,7 +41,7 @@ import { NotYetImplementedCommitmentDefinition } from './_base/NotYetImplemented
  *
  * @private Use functions to access commitments instead of this array directly
  */
-export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, LanguageCommitmentDefinition, LanguageCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, FromCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, UseBrowserCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseMcpCommitmentDefinition, UseCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
+export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, LanguageCommitmentDefinition, LanguageCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, UseBrowserCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseMcpCommitmentDefinition, UseCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
 /**
  * Gets a commitment definition by its type
  * @param type The commitment type to look up

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

@@ -213,6 +213,12 @@ export declare const DEFAULT_INTERMEDIATE_FILES_STRATEGY: IntermediateFilesStrat
  * @public exported from `@promptbook/core`
  */
 export declare const DEFAULT_MAX_PARALLEL_COUNT = 5;
+/**
+ * The maximum depth to which recursion can occur
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const DEFAULT_MAX_RECURSION = 10;
 /**
  * The maximum number of attempts to execute LLM task before giving up
  *

package/esm/typings/src/errors/utils/deserializeError.d.ts

@@ -4,4 +4,4 @@ import type { ErrorJson } from './ErrorJson';
  *
  * @public exported from `@promptbook/utils`
  */
-export declare function deserializeError(error: ErrorJson): Error;
+export declare function deserializeError(error: ErrorJson, isStackAddedToMessage?: boolean): Error;

package/esm/typings/src/execution/PromptResult.d.ts

@@ -1,4 +1,5 @@
 import type { string_date_iso8601, string_model_name, string_prompt } from '../types/typeAliases';
+import type { TODO_any } from '../utils/organization/TODO_any';
 import type { TODO_object } from '../utils/organization/TODO_object';
 import type { EmbeddingVector } from './EmbeddingVector';
 import type { Usage } from './Usage';
@@ -21,7 +22,29 @@ export type CompletionPromptResult = CommonPromptResult;
  *
  * Note: [🚉] This is fully serializable as JSON
  */
-export type ChatPromptResult = CommonPromptResult & {};
+export type ChatPromptResult = CommonPromptResult & {
+    /**
+     * Optional tool calls made during the execution
+     */
+    readonly toolCalls?: ReadonlyArray<{
+        /**
+         * Name of the tool
+         */
+        readonly name: string;
+        /**
+         * Arguments of the tool call
+         */
+        readonly arguments: string;
+        /**
+         * Result of the tool call
+         */
+        readonly result: string;
+        /**
+         * Raw tool call from the model
+         */
+        readonly rawToolCall: TODO_any;
+    }>;
+};
 /**
  * Image prompt result
  *

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

@@ -1,5 +1,6 @@
 import type { ClientOptions } from 'openai';
 import type { CommonToolsOptions } from '../../execution/CommonToolsOptions';
+import type { ExecutionTools } from '../../execution/ExecutionTools';
 import type { RemoteClientOptions } from '../../remote-server/types/RemoteClientOptions';
 /**
  * Options for `createOpenAiCompatibleExecutionTools` and `OpenAiCompatibleExecutionTools`
@@ -28,6 +29,10 @@ export type OpenAiCompatibleExecutionToolsNonProxiedOptions = CommonToolsOptions
      * @example 'https://api.deepseek.com/v1' (DeepSeek)
      */
     baseURL?: string;
+    /**
+     * Tools for executing the scripts
+     */
+    readonly executionTools?: Pick<ExecutionTools, 'script'>;
     isProxied?: false;
 };
 /**

package/esm/typings/src/types/LlmToolDefinition.d.ts

@@ -16,5 +16,12 @@ export type LlmToolDefinition = {
     /**
      * Parameters of the tool in JSON Schema format
      */
-    readonly parameters: Record<string, unknown>;
+    readonly parameters: {
+        readonly type: 'object';
+        readonly properties: Record<string, {
+            type: string;
+            description?: string;
+        }>;
+        readonly required?: string[];
+    };
 };

package/esm/typings/src/types/Prompt.d.ts

@@ -1,6 +1,7 @@
 import type { FormatCommand } from '../commands/FORMAT/FormatCommand';
 import type { ChatMessage } from '../book-components/Chat/types/ChatMessage';
 import type { Expectations } from '../pipeline/PipelineJson/Expectations';
+import type { LlmToolDefinition } from './LlmToolDefinition';
 import type { ChatModelRequirements } from './ModelRequirements';
 import type { CompletionModelRequirements } from './ModelRequirements';
 import type { EmbeddingModelRequirements } from './ModelRequirements';
@@ -44,6 +45,18 @@ export type ChatPrompt = CommonPrompt & {
      * Optional chat thread (history of previous messages)
      */
     thread?: ChatMessage[];
+    /**
+     * Optional file attachments
+     */
+    attachments?: Array<{
+        name: string;
+        type: string;
+        url: string;
+    }>;
+    /**
+     * Optional tools that can be called by the model
+     */
+    tools?: Array<LlmToolDefinition>;
 };
 /**
  * Image prompt

package/esm/typings/src/utils/misc/parseNumber.d.ts

@@ -10,7 +10,7 @@
  *
  * @public exported from `@promptbook/utils`
  */
-export declare function parseNumber(value: string | number): number;
+export declare function parseNumber(value: string | number | null | undefined): number;
 /**
  * TODO: Maybe use sth. like safe-eval in fraction/calculation case @see https://www.npmjs.com/package/safe-eval
  * TODO: [🧠][🌻] Maybe export through `@promptbook/markdown-utils` not `@promptbook/utils`

package/esm/typings/src/utils/random/$generateBookBoilerplate.d.ts

@@ -15,6 +15,10 @@ type GenerateBookBoilerplateOptions = PartialDeep<Omit<AgentBasicInformation, 'p
      * @default 'ENGLISH'
      */
     namePool?: string;
+    /**
+     * Initial rules for the agent
+     */
+    initialRules?: Array<string>;
 };
 /**
  * Generates boilerplate for a new agent book

package/esm/typings/src/utils/random/$randomAgentPersona.d.ts

@@ -5,10 +5,11 @@ import type { string_persona_description } from '../../types/typeAliases';
  * This function selects a random personality profile from a predefined pool
  * of common AI agent characteristics (e.g., friendly, professional, creative).
  *
+ * @param language - The language code (e.g. 'ENGLISH', 'CZECH')
  * @returns A string describing the agent's persona
  * @private internal helper function
  */
-export declare function $randomAgentPersona(): string_persona_description;
+export declare function $randomAgentPersona(language?: string): string_persona_description;
 /**
  * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
  */

package/esm/typings/src/utils/random/$randomAgentRule.d.ts

@@ -0,0 +1,14 @@
+import type { string_persona_description } from '../../types/typeAliases';
+/**
+ * Generates a random agent rule description.
+ *
+ * This function selects a random rule
+ *
+ * @param language - The language code (e.g. 'ENGLISH', 'CZECH')
+ * @returns A string describing the agent's rule
+ * @private internal helper function
+ */
+export declare function $randomAgentRule(language?: string): string_persona_description;
+/**
+ * TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
+ */

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.104.0-19`).
+ * It follows semantic versioning (e.g., `0.105.0-0`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/legacy-documents",
-    "version": "0.104.0",
+    "version": "0.105.0-1",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,
@@ -95,7 +95,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/legacy-documents.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.104.0"
+        "@promptbook/core": "0.105.0-1"
     },
     "dependencies": {
         "colors": "1.4.0",

package/umd/index.umd.js

@@ -25,7 +25,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.104.0';
+    const PROMPTBOOK_ENGINE_VERSION = '0.105.0-1';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -3585,7 +3585,7 @@
      *
      * @public exported from `@promptbook/utils`
      */
-    function deserializeError(error) {
+    function deserializeError(error, isStackAddedToMessage = true) {
         const { name, stack, id } = error; // Added id
         let { message } = error;
         let ErrorClass = ALL_ERRORS[error.name];
@@ -3593,7 +3593,7 @@
             ErrorClass = Error;
             message = `${name}: ${message}`;
         }
-        if (stack !== undefined && stack !== '') {
+        if (isStackAddedToMessage && stack !== undefined && stack !== '') {
             message = spaceTrim__default["default"]((block) => `
                 ${block(message)}