@promptbook/core 0.106.0-0 → 0.107.0-0

package/esm/index.es.js

@@ -27,7 +27,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.106.0-0';
+const PROMPTBOOK_ENGINE_VERSION = '0.107.0-0';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -8822,115 +8822,564 @@ function $detectRuntimeEnvironment() {
  * TODO: [🎺] Also detect and report node version here
  */
 
+// spell-checker: disable
 /**
- * Simple wrapper `new Date().toISOString()`
- *
- * Note: `$` is used to indicate that this function is not a pure function - it is not deterministic because it depends on the current time
- *
- * @returns string_date branded type
- * @public exported from `@promptbook/utils`
- */
-function $getCurrentDate() {
-    return new Date().toISOString();
-}
-
-/**
- * Creates a human-readable hash as a short story sentence.
+ * @@@
  *
- * @public exported from `@promptbook/utils`
- */
-async function linguisticHash(input) {
-    const hash = computeHash(input);
-    return capitalize(createStorySentence(hash));
-}
-const HASH_SEGMENT_LENGTH = 8;
-const STORY_OPENERS = [
-    'once',
-    'long ago',
-    'at dawn',
-    'at dusk',
-    'suddenly',
-    'quietly',
-    'meanwhile',
-    'today',
-    'tonight',
-    'in the end',
-    'before long',
-    'for a moment',
+ * @private utility of `linguisticHash`
+ */
+const ADJECTIVES$1 = [
+    'červený',
+    'modrý',
+    'zelený',
+    'žlutý',
+    'rychlý',
+    'pomalý',
+    'jasný',
+    'temný',
+    'veselý',
+    'smutný',
+    'statečný',
+    'klidný',
+    'chytrý',
+    'bystrý',
+    'dychtivý',
+    'honosný',
+    'velkolepý',
+    'hravý',
+    'laskavý',
+    'šťastný',
+    'hrdý',
+    'pošetilý',
+    'moudrý',
+    'mladý',
+    'starý',
+    'veliký',
+    'malý',
+    'drobný',
+    'obrovský',
+    'krátký',
+    'dlouhý',
+    'blízký',
+    'vzdálený',
+    'vnitřní',
+    'vnější',
+    'trpělivý',
+    'stálý',
+    'ušlechtilý',
+    'čistý',
+    'špinavý',
+    'čerstvý',
+    'zvětralý',
+    'ostrý',
+    'tupý',
+    'tlustý',
+    'tenký',
+    'široký',
+    'úzký',
+    'hluboký',
+    'mělký',
+    'mocný',
+    'jemný',
+    'divoký',
+    'tichý',
+    'hlučný',
+    'pokojný',
+    'rušný',
+    'prázdný',
+    'plný',
+    'kulatý',
+    'hranatý',
+    'plochý',
+    'křivý',
+    'tvrdý',
+    'měkký',
+    'teplý',
+    'chladný',
+    'sladký',
+    'kyselý',
+    'hořký',
+    'slaný',
+    'silný',
+    'slabý',
+    'pevný',
+    'pružný',
+    'křehký',
+    'houževnatý',
+    'lesklý',
+    'matný',
+    'kluzký',
+    'lepkavý',
+    'svěží',
+    'vybledlý',
+    'mlhavý',
+    'bouřlivý',
+    'slunný',
+    'větrný',
+    'deštivý',
+    'mrazivý',
+    'zlatý',
+    'stříbrný',
+    'ledový',
+    'žhavý',
+    'prastarý',
+    'moderní',
+    'skrytý',
+    'ztracený',
+    'nalezený',
+    'magický',
+    'tajemný',
+    'kosmický',
+    'hvězdný',
+    'měsíční',
+    'sluneční',
+    'mlžný',
+    'ranní',
+    'večerní',
+    'noční',
+    'denní',
+    'osamělý',
+    'společenský',
+    'soukromý',
+    'veřejný',
+    'tajný',
+    'slavný',
+    'jistý',
+    'neurčitý',
+    'prostý',
+    'snadný',
+    'krotký',
+    'mírný',
+    'horký',
+    'suchý',
+    'mokrý',
+    'vlhký',
+    'promočený',
+    'vyprahlý',
+    'hladový',
+    'žíznivý',
+    'ospalý',
+    'bdělý',
+    'unavený',
+    'líný',
+    'neklidný',
+    'nestálý',
+    'odvážný',
+    'bázlivý',
+    'upřímný',
+    'věrný',
+    'pravý',
+    'falešný',
+    'spravedlivý',
+    'jednoduchý',
+    'složitý',
+    'přirozený',
+    'umělý',
+    'živý',
+    'mrtvý',
+    'zvídavý',
+    'zvláštní',
+    'běžný',
+    'vzácný',
+    'jedinečný',
+    'základní',
+    'prvotní',
+    'hbitý',
 ];
-const STORY_CONNECTORS = ['while', 'as', 'when', 'because', 'and', 'just as', 'after', 'before'];
-const STORY_PREPOSITIONS = [
-    'near',
-    'beside',
-    'under',
-    'within',
-    'beyond',
-    'around',
-    'behind',
-    'across',
-    'above',
-    'beneath',
-    'over',
-    'inside',
-    'outside',
-    'along',
+const NOUNS$1 = [
+    'jablko',
+    'nebe',
+    'strom',
+    'liška',
+    'kočka',
+    'pták',
+    'pes',
+    'řeka',
+    'hora',
+    'les',
+    'oceán',
+    'hvězda',
+    'měsíc',
+    'slunce',
+    'mrak',
+    'květ',
+    'list',
+    'kámen',
+    'vítr',
+    'déšť',
+    'oheň',
+    'led',
+    'kniha',
+    'sen',
+    'píseň',
+    'cesta',
+    'brána',
+    'klíč',
+    'lampa',
+    'mapa',
+    'dům',
+    'město',
+    'most',
+    'pole',
+    'zahrada',
+    'jezero',
+    'pláž',
+    'ostrov',
+    'údolí',
+    'poušť',
+    'svět',
+    'duch',
+    'srdce',
+    'mysl',
+    'duše',
+    'život',
+    'čas',
+    'prostor',
+    'světlo',
+    'stín',
+    'zvuk',
+    'hudba',
+    'hlas',
+    'slovo',
+    'stránka',
+    'příběh',
+    'perla',
+    'zlato',
+    'stříbro',
+    'krystal',
+    'diamant',
+    'smaragd',
+    'rubín',
+    'stezka',
+    'vrchol',
+    'břeh',
+    'vlna',
+    'příliv',
+    'plamen',
+    'jiskra',
+    'paprsek',
+    'semínko',
+    'kořen',
+    'větev',
+    'pupen',
+    'trn',
+    'kůra',
+    'skořápka',
+    'pírko',
+    'křídlo',
+    'dráp',
+    'tlapa',
+    'hnízdo',
+    'jeskyně',
+    'hájek',
+    'věž',
+    'hrad',
+    'koruna',
+    'meč',
+    'štít',
+    'mince',
+    'drahokam',
+    'prsten',
+    'zvonek',
+    'hodiny',
+    'kompas',
+    'kotva',
+    'pochodeň',
+    'flétna',
+    'harfa',
+    'buben',
+    'čočka',
+    'sklo',
+    'písek',
+    'prach',
+    'mlha',
+    'rosa',
+    'svítání',
+    'soumrak',
+    'noc',
+    'den',
+    'rok',
+    'věk',
+    'blesk',
+    'kapka',
+    'bouře',
+    'sníh',
+    'kroupa',
+    'kouř',
+    'pára',
+    'plyn',
+    'kov',
+    'skála',
+    'hlína',
+    'sůl',
+    'cukr',
+    'dřevo',
+    'kost',
+    'kůže',
+    'tělo',
+    'krev',
+    'buňka',
+    'atom',
+    'tep',
+    'dech',
+    'vzdech',
+    'jméno',
+    'ozvěna',
+    'obraz',
+    'vize',
+    'myšlenka',
+    'nápad',
+    'plán',
+    'cíl',
+    'přání',
+    'naděje',
+    'strach',
+    'radost',
+    'láska',
+    'nenávist',
+    'vůle',
+    'síla',
+    'energie',
+    'pohyb',
+    'rychlost',
+    'místo',
+    'bod',
+    'linie',
+    'tvar',
+    'forma',
+    'velikost',
+    'hmota',
+    'váha',
+    'teplo',
+    'chlad',
+    'barva',
+    'tón',
+    'rytmus',
+    'nálada',
+    'stav',
+    'krok',
+    'pád',
+    'skok',
+    'běh',
+    'let',
+    'klid',
+    'úkol',
+    'práce',
+    'hra',
+    'sport',
+    'umění',
+    'řemeslo',
+    'nástroj',
+    'loď',
+    'člun',
+    'auto',
+    'kolo',
+    'vlak',
+    'letadlo',
+    'uzel',
+    'síť',
+    'krabice',
+    'taška',
+    'dóza',
+    'hrnek',
+    'miska',
+    'talíř',
+    'lžíce',
+    'vidlička',
+    'nůž',
+    'pánev',
+    'hrnec',
+    'postel',
+    'stůl',
+    'židle',
+    'dveře',
+    'stěna',
+    'střecha',
+    'podlaha',
+    'okno',
+    'chodba',
 ];
-const STORY_TEMPLATES = [
-    (parts) => `${parts.opener}, the ${parts.adjective1} ${parts.noun1} was ${parts.verb1} ${parts.connector} the ${parts.adjective2} ${parts.noun2} was ${parts.verb2} ${parts.preposition} the ${parts.adjective3} ${parts.noun3}.`,
-    (parts) => `${parts.opener}, the ${parts.adjective1} ${parts.noun1} was ${parts.verb1} ${parts.preposition} the ${parts.adjective2} ${parts.noun2}, and the ${parts.adjective3} ${parts.noun3} was ${parts.verb2}.`,
-    (parts) => `${parts.opener}, the ${parts.adjective1} ${parts.noun1} was ${parts.verb1}, and the ${parts.adjective2} ${parts.noun2} was ${parts.verb2} ${parts.preposition} the ${parts.adjective3} ${parts.noun3}.`,
-    (parts) => `${parts.opener}, the ${parts.adjective1} ${parts.noun1} was ${parts.verb1} ${parts.connector} the ${parts.adjective2} ${parts.noun2} was ${parts.verb2}, ${parts.preposition} the ${parts.adjective3} ${parts.noun3}.`,
+const VERBS$1 = [
+    'skáče',
+    'tančí',
+    'letí',
+    'běží',
+    'zpívá',
+    'svítí',
+    'roste',
+    'plyne',
+    'padá',
+    'stoupá',
+    'spí',
+    'kráčí',
+    'mluví',
+    'myslí',
+    'sní',
+    'hledá',
+    'nachází',
+    'dává',
+    'bere',
+    'tvoří',
+    'hoří',
+    'mrzne',
+    'taje',
+    'dýchá',
+    'pulzuje',
+    'bije',
+    'žije',
+    'učí',
+    'ví',
+    'skrývá',
+    'ukazuje',
+    'láme',
+    'opravuje',
+    'ztrácí',
+    'nalézá',
+    'začíná',
+    'končí',
+    'plave',
+    'pluje',
+    'klouže',
+    'točí',
+    'mění',
+    'bledne',
+    'mizí',
+    'rodí',
+    'hučí',
+    'pláče',
+    'závodí',
+    'plíží',
+    'sleduje',
+    'slyší',
+    'cítí',
+    'touží',
+    'doufá',
+    'miluje',
+    'bloudí',
+    'putuje',
+    'cestuje',
+    'překračuje',
+    'potkává',
+    'drží',
+    'sdílí',
+    'jiskří',
+    'plápolá',
+    'léčí',
+    'řeší',
+    'otevírá',
+    'zavírá',
+    'zvedá',
+    'táhne',
+    'tlačí',
+    'hází',
+    'chytá',
+    'dělá',
+    'vidí',
+    'chutná',
+    'voní',
+    'spěchá',
+    'zastaví',
+    'jde',
+    'přichází',
+    'odchází',
+    'jedná',
+    'existuje',
+    'zmenšuje',
+    'rozšiřuje',
+    'zužuje',
+    'hřeje',
+    'chladí',
+    'suší',
+    'máčí',
+    'plní',
+    'vyprazdňuje',
+    'pouští',
+    'získává',
+    'vítězí',
+    'selhává',
+    'zkouší',
+    'používá',
+    'dostává',
+    'měří',
+    'stojí',
+    'dosahuje',
+    'míjí',
+    'udeří',
+    'vede',
+    'následuje',
+    'pomáhá',
+    'slouží',
+    'trénuje',
+    'kóduje',
+    'píše',
+    'čte',
+    'kreslí',
+    'maluje',
+    'tvaruje',
+    'spojuje',
+    'dělí',
+    'váže',
+    'zraňuje',
+    'chrání',
+    'bojuje',
+    'brání',
+    'útočí',
+    'uniká',
+    'lapá',
+    'osvobozuje',
+    'poutá',
+    'spřádá',
+    'tká',
+    'vrhá',
+    'nese',
+    'přenáší',
+    'vrací',
+    'zrychluje',
+    'zpomaluje',
+    'probouzí',
+    'uspává',
+    'šeptá',
+    'volá',
+    'hledí',
+    'čeká',
+    'bdí',
+    'rozkvétá',
+    'klíčí',
+    'zraje',
+    'chvěje',
+    'třpytí',
+    'shromažďuje',
+    'rozhazuje',
+    'tápe',
+    'žhne',
+    'vibruje',
+    'šumí',
+    'stéká',
+    'vypráví',
+    'plánuje',
+    'počítá',
+    'váhá',
+    'riskuje',
 ];
 /**
- * Extracts a deterministic numeric seed from a SHA-256 hash.
- */
-function getHashSeed(hash, segmentIndex) {
-    const expandedHash = `${hash}${hash}`;
-    const start = (segmentIndex * HASH_SEGMENT_LENGTH + segmentIndex) % hash.length;
-    return parseInt(expandedHash.substring(start, start + HASH_SEGMENT_LENGTH), 16);
-}
-/**
- * Picks a deterministic item from a list based on the hash seed.
- */
-function pickFromHash(hash, segmentIndex, list) {
-    const seed = getHashSeed(hash, segmentIndex);
-    return list[seed % list.length];
-}
-/**
- * Index constants for story part selection to avoid magic numbers.
- */
-const ADJECTIVE3_INDEX = 9;
-const NOUN3_INDEX = 10;
-/**
- * Creates the deterministic story parts used by the sentence templates.
+ * Czech word lists used by the linguistic hash.
+ *
+ * @private utility of `linguisticHash`
  */
-function createStoryParts(hash) {
-    return {
-        opener: pickFromHash(hash, 0, STORY_OPENERS),
-        connector: pickFromHash(hash, 1, STORY_CONNECTORS),
-        preposition: pickFromHash(hash, 2, STORY_PREPOSITIONS),
-        adjective1: pickFromHash(hash, 3, ADJECTIVES),
-        noun1: pickFromHash(hash, 4, NOUNS),
-        verb1: pickFromHash(hash, 5, VERBS),
-        adjective2: pickFromHash(hash, 6, ADJECTIVES),
-        noun2: pickFromHash(hash, 7, NOUNS),
-        verb2: pickFromHash(hash, 8, VERBS),
-        adjective3: pickFromHash(hash, ADJECTIVE3_INDEX, ADJECTIVES),
-        noun3: pickFromHash(hash, NOUN3_INDEX, NOUNS),
-    };
-}
+const LINGUISTIC_HASH_WORD_LISTS_CS = {
+    adjective: ADJECTIVES$1,
+    noun: NOUNS$1,
+    verb: VERBS$1,
+};
 /**
- * Index constant for story template selection to avoid magic numbers.
+ * Note: [💞] Ignore a discrepancy between file name and entity name
  */
-const STORY_TEMPLATE_INDEX = 11;
+
 /**
- * Builds a short, memorable story sentence from the hash.
+ * @@@
+ *
+ * @private utility of `linguisticHash`
  */
-function createStorySentence(hash) {
-    const parts = createStoryParts(hash);
-    const template = pickFromHash(hash, STORY_TEMPLATE_INDEX, STORY_TEMPLATES);
-    return template(parts).trim();
-}
 const ADJECTIVES = [
     'red',
     'blue',
@@ -9605,8 +10054,215 @@ const VERBS = [
     'spinning',
 ];
 /**
- * TODO: Prompt: Extract number constants and word list to a separate file for reuse.
+ * English word lists used by the linguistic hash.
+ *
+ * @private utility of `linguisticHash`
+ */
+const LINGUISTIC_HASH_WORD_LISTS_EN = {
+    adjective: ADJECTIVES,
+    noun: NOUNS,
+    verb: VERBS,
+};
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */
+
+/**
+ * Default language used for linguistic hashes.
+ *
+ * @private utility of `linguisticHash`
+ */
+const DEFAULT_LINGUISTIC_HASH_LANGUAGE = 'en';
+/**
+ * @@@
+ *
+ * @private utility of `linguisticHash`
+ */
+const LANGUAGE_CONFIGS = {
+    en: {
+        language: 'en',
+        label: 'English',
+        wordLists: LINGUISTIC_HASH_WORD_LISTS_EN,
+    },
+    cs: {
+        language: 'cs',
+        label: 'Czech',
+        wordLists: LINGUISTIC_HASH_WORD_LISTS_CS,
+    },
+};
+/**
+ * Normalizes a requested language to a supported linguistic hash language.
+ *
+ * @private utility of `linguisticHash`
+ */
+function normalizeLinguisticHashLanguage(language) {
+    if (typeof language !== 'string') {
+        return DEFAULT_LINGUISTIC_HASH_LANGUAGE;
+    }
+    const normalized = language.trim().toLowerCase();
+    if (normalized === 'cs') {
+        return 'cs';
+    }
+    if (normalized === 'en') {
+        return 'en';
+    }
+    return DEFAULT_LINGUISTIC_HASH_LANGUAGE;
+}
+/**
+ * Returns the language configuration for linguistic hash generation.
+ *
+ * @private utility of `linguisticHash`
+ */
+function getLinguisticHashLanguageConfig(language) {
+    const normalized = normalizeLinguisticHashLanguage(language);
+    return LANGUAGE_CONFIGS[normalized];
+}
+
+// <- TODO: !!!! Remove re-exports
+/**
+ * Creates a human-readable hash as a short, story-like phrase.
+ *
+ * @param wordCount how many words to include (defaults to {@link DEFAULT_LINGUISTIC_HASH_WORD_COUNT}, clamped to
+ * {@link MIN_LINGUISTIC_HASH_WORD_COUNT}..{@link MAX_LINGUISTIC_HASH_WORD_COUNT})
+ * @param language optional language code (defaults to {@link DEFAULT_LINGUISTIC_HASH_LANGUAGE})
+ *
+ * @public exported from `@promptbook/utils`
+ */
+async function linguisticHash(input, wordCount, language) {
+    const hash = computeHash(input);
+    const normalizedWordCount = normalizeLinguisticHashWordCount(wordCount);
+    const languageConfig = getLinguisticHashLanguageConfig(language);
+    const words = createLinguisticHashWords(hash, normalizedWordCount, languageConfig.wordLists);
+    return capitalize(words.join(' '));
+}
+/**
+ * @@@
+ *
+ * @private utility of `linguisticHash`
+ */
+const HASH_SEGMENT_LENGTH = 8;
+/**
+ * The minimum number of words for a linguistic hash.
+ *
+ * @private utility of `linguisticHash`
+ */
+const MIN_LINGUISTIC_HASH_WORD_COUNT = 1;
+/**
+ * The default number of words for a linguistic hash.
+ *
+ * @private utility of `linguisticHash`
+ */
+const DEFAULT_LINGUISTIC_HASH_WORD_COUNT = 7;
+/**
+ * Extracts a deterministic numeric seed from a SHA-256 hash.
+ *
+ * @private utility of `linguisticHash`
+ */
+function getHashSeed(hash, segmentIndex) {
+    const expandedHash = `${hash}${hash}`;
+    const start = (segmentIndex * HASH_SEGMENT_LENGTH + segmentIndex) % hash.length;
+    return parseInt(expandedHash.substring(start, start + HASH_SEGMENT_LENGTH), 16);
+}
+/**
+ * Picks a deterministic item from a list based on the hash seed.
+ *
+ * @private utility of `linguisticHash`
+ */
+function pickFromHash(hash, segmentIndex, list) {
+    const seed = getHashSeed(hash, segmentIndex);
+    return list[seed % list.length];
+}
+/**
+ * Ordered word kinds used to build the linguistic hash output.
+ *
+ * @private utility of `linguisticHash`
+ */
+const WORD_SEQUENCE = [
+    'adjective',
+    'noun',
+    'verb',
+    'adjective',
+    'noun',
+    'verb',
+    'adjective',
+    'noun',
+    'verb',
+    'adjective',
+    'noun',
+    'verb',
+    'adjective',
+    'noun',
+    'verb',
+    'adjective',
+    'noun',
+    'verb',
+    'adjective',
+    'noun',
+];
+/**
+ * The maximum number of words for a linguistic hash.
+ *
+ * @private utility of `linguisticHash`
+ */
+const MAX_LINGUISTIC_HASH_WORD_COUNT = WORD_SEQUENCE.length;
+/**
+ * Index of the noun used for single-word hashes.
+ *
+ * @private utility of `linguisticHash`
+ */
+const SINGLE_WORD_INDEX = 1;
+/**
+ * Normalizes the word count to a supported integer range.
+ *
+ * @private utility of `linguisticHash`
+ */
+function normalizeLinguisticHashWordCount(wordCount) {
+    if (typeof wordCount !== 'number' || !Number.isFinite(wordCount)) {
+        return DEFAULT_LINGUISTIC_HASH_WORD_COUNT;
+    }
+    const rounded = Math.round(wordCount);
+    return Math.min(MAX_LINGUISTIC_HASH_WORD_COUNT, Math.max(MIN_LINGUISTIC_HASH_WORD_COUNT, rounded));
+}
+/**
+ * Picks a deterministic word from the hash by kind.
+ *
+ * @private utility of `linguisticHash`
+ */
+function pickWordFromHash(hash, segmentIndex, wordKind, wordLists) {
+    return pickFromHash(hash, segmentIndex, wordLists[wordKind]);
+}
+/**
+ * Creates the deterministic word sequence used for the linguistic hash output.
+ *
+ * @private utility of `linguisticHash`
+ */
+function createLinguisticHashWordSequence(hash, wordLists) {
+    return WORD_SEQUENCE.map((wordKind, index) => pickWordFromHash(hash, index, wordKind, wordLists));
+}
+/**
+ * Selects the requested number of words from the hash output.
+ *
+ * @private utility of `linguisticHash`
+ */
+function createLinguisticHashWords(hash, wordCount, wordLists) {
+    const words = createLinguisticHashWordSequence(hash, wordLists);
+    if (wordCount === 1) {
+        return [words[SINGLE_WORD_INDEX]];
+    }
+    return words.slice(0, wordCount);
+}
+
+/**
+ * Simple wrapper `new Date().toISOString()`
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it is not deterministic because it depends on the current time
+ *
+ * @returns string_date branded type
+ * @public exported from `@promptbook/utils`
  */
+function $getCurrentDate() {
+    return new Date().toISOString();
+}
 
 /**
  * Function parseNumber will parse number from string
@@ -20265,6 +20921,21 @@ function asUpdatableSubject(value) {
  * TODO: [🧠] Maybe `BehaviorSubject` is too heavy for this use case, maybe just tuple `[value,setValue]` is enough
  */
 
+/**
+ * Tool call name emitted while preparing a GPT assistant for an agent.
+ *
+ * @public exported from `@promptbook/types`
+ */
+const ASSISTANT_PREPARATION_TOOL_CALL_NAME = 'assistant_preparation';
+/**
+ * Checks whether a tool call is the assistant preparation marker.
+ *
+ * @public exported from `@promptbook/types`
+ */
+function isAssistantPreparationToolCall(toolCall) {
+    return toolCall.name === ASSISTANT_PREPARATION_TOOL_CALL_NAME;
+}
+
 /**
  * Change ellipsis characters and dot leaders to three dots `…` -> `...`
  *
@@ -23072,6 +23743,33 @@ const DISCRIMINANT = 'OPEN_AI_ASSISTANT_V1';
  * TODO: [🧠][🌰] Allow to pass `title` for tracking purposes
  */
 
+/**
+ * Emits a progress update to signal assistant preparation before long setup work.
+ */
+function emitAssistantPreparationProgress(options) {
+    const startedAt = $getCurrentDate();
+    options.onProgress({
+        content: '',
+        modelName: options.modelName,
+        timing: {
+            start: startedAt,
+            complete: startedAt,
+        },
+        usage: UNCERTAIN_USAGE,
+        rawPromptContent: options.prompt.content,
+        rawRequest: null,
+        rawResponse: {
+            status: 'assistant_preparation',
+        },
+        toolCalls: [
+            {
+                name: ASSISTANT_PREPARATION_TOOL_CALL_NAME,
+                arguments: {},
+                createdAt: startedAt,
+            },
+        ],
+    });
+}
 /**
  * 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
@@ -23295,6 +23993,11 @@ class AgentLlmExecutionTools {
                     if (this.options.isVerbose) {
                         console.log(`1️⃣ Updating OpenAI Assistant for agent ${this.title}...`);
                     }
+                    emitAssistantPreparationProgress({
+                        onProgress,
+                        prompt,
+                        modelName: this.modelName,
+                    });
                     assistant = await this.options.llmTools.updateAssistant({
                         assistantId: cached.assistantId,
                         name: this.title,
@@ -23313,6 +24016,11 @@ class AgentLlmExecutionTools {
                     console.log(`1️⃣ Creating new OpenAI Assistant for agent ${this.title}...`);
                 }
                 // <- TODO: [🐱‍🚀] Check also `isCreatingNewAssistantsAllowed` and warn about it
+                emitAssistantPreparationProgress({
+                    onProgress,
+                    prompt,
+                    modelName: this.modelName,
+                });
                 assistant = await this.options.llmTools.createNewAssistant({
                     name: this.title,
                     instructions: modelRequirements.systemMessage,
@@ -23967,6 +24675,8 @@ class RemoteAgent extends Agent {
         // <- TODO: [🐱‍🚀] Maybe use promptbookFetch
         let content = '';
         const toolCalls = [];
+        const preparationToolCalls = [];
+        let hasReceivedModelOutput = false;
         const normalizeToolCall = (toolCall) => {
             if (toolCall.createdAt) {
                 return toolCall;
@@ -24013,6 +24723,17 @@ class RemoteAgent extends Agent {
         const upsertToolCalls = (incomingToolCalls) => {
             for (const toolCall of incomingToolCalls) {
                 const normalized = normalizeToolCall(toolCall);
+                if (isAssistantPreparationToolCall(normalized)) {
+                    if (hasReceivedModelOutput) {
+                        continue;
+                    }
+                    preparationToolCalls.length = 0;
+                    preparationToolCalls.push(normalized);
+                    continue;
+                }
+                if (preparationToolCalls.length > 0) {
+                    preparationToolCalls.length = 0;
+                }
                 const key = getToolCallKey(normalized);
                 const existingIndex = toolCalls.findIndex((existing) => getToolCallKey(existing) === key);
                 if (existingIndex === -1) {
@@ -24023,6 +24744,10 @@ class RemoteAgent extends Agent {
                 }
             }
         };
+        /**
+         * Builds the tool call list including any preparation marker still active.
+         */
+        const getActiveToolCalls = () => preparationToolCalls.length > 0 ? [...preparationToolCalls, ...toolCalls] : toolCalls;
         if (!bookResponse.body) {
             content = await bookResponse.text();
         }
@@ -24059,7 +24784,7 @@ class RemoteAgent extends Agent {
                                             rawPromptContent: {},
                                             rawRequest: {},
                                             rawResponse: {},
-                                            toolCalls: normalizedToolCalls,
+                                            toolCalls: getActiveToolCalls(),
                                         });
                                         sawToolCalls = true;
                                         isToolCallLine = true;
@@ -24087,6 +24812,10 @@ class RemoteAgent extends Agent {
                             // console.debug('RemoteAgent chunk:', textChunk);
                             content += textChunk;
                         }
+                        if (!hasReceivedModelOutput && content.trim().length > 0) {
+                            hasReceivedModelOutput = true;
+                            preparationToolCalls.length = 0;
+                        }
                         onProgress({
                             content,
                             modelName: this.modelName,
@@ -24095,7 +24824,7 @@ class RemoteAgent extends Agent {
                             rawPromptContent: {},
                             rawRequest: {},
                             rawResponse: {},
-                            toolCalls,
+                            toolCalls: getActiveToolCalls(),
                         });
                     }
                 }
@@ -24103,6 +24832,10 @@ class RemoteAgent extends Agent {
                 const lastChunk = decoder.decode();
                 if (lastChunk) {
                     content += lastChunk;
+                    if (!hasReceivedModelOutput && content.trim().length > 0) {
+                        hasReceivedModelOutput = true;
+                        preparationToolCalls.length = 0;
+                    }
                     onProgress({
                         content: lastChunk,
                         modelName: this.modelName,
@@ -24111,7 +24844,7 @@ class RemoteAgent extends Agent {
                         rawPromptContent: {},
                         rawRequest: {},
                         rawResponse: {},
-                        toolCalls,
+                        toolCalls: getActiveToolCalls(),
                     });
                 }
             }