@promptbook/markdown-utils 0.61.0 → 0.62.0-0

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

@@ -26,6 +26,7 @@ import { embeddingVectorToString } from '../execution/embeddingVectorToString';
 import { addUsage } from '../execution/utils/addUsage';
 import { checkExpectations, isPassingExpectations } from '../execution/utils/checkExpectations';
 import { usageToWorktime } from '../execution/utils/usageToWorktime';
+import { usageToHuman } from '../execution/utils/usageToHuman';
 import { CallbackInterfaceTools } from '../knowledge/dialogs/callback/CallbackInterfaceTools';
 import type { CallbackInterfaceToolsOptions } from '../knowledge/dialogs/callback/CallbackInterfaceToolsOptions';
 import { SimplePromptInterfaceTools } from '../knowledge/dialogs/simple-prompt/SimplePromptInterfaceTools';
@@ -39,7 +40,7 @@ import { executionReportJsonToString } from '../types/execution-report/execution
 import { PROMPTBOOK_VERSION } from '../version';
 export { PROMPTBOOK_VERSION };
 export { BlockTypes, RESERVED_PARAMETER_NAMES };
-export { addUsage, assertsExecutionSuccessful, checkExpectations, embeddingVectorToString, executionReportJsonToString, ExecutionReportStringOptions, ExecutionReportStringOptionsDefaults, isPassingExpectations, prepareKnowledgeFromMarkdown, prettifyPipelineString, usageToWorktime, };
+export { addUsage, assertsExecutionSuccessful, checkExpectations, embeddingVectorToString, executionReportJsonToString, ExecutionReportStringOptions, ExecutionReportStringOptionsDefaults, isPassingExpectations, prepareKnowledgeFromMarkdown, prettifyPipelineString, usageToWorktime, usageToHuman, };
 export { collectionToJson, createCollectionFromJson, createCollectionFromPromise, createCollectionFromUrl, createSubcollection, };
 export { SimplePromptInterfaceTools };
 export { pipelineJsonToString, pipelineStringToJson, pipelineStringToJsonSync, stringifyPipelineJson, validatePipeline, };

package/esm/typings/src/conversion/pipelineJsonToString.d.ts

@@ -10,5 +10,6 @@ export declare function pipelineJsonToString(pipelineJson: PipelineJson): Pipeli
 /**
  * TODO: !!!! Implement new features and commands into `promptTemplateParameterJsonToString`
  * TODO: [🧠] Is there a way to auto-detect missing features in pipelineJsonToString
- * TODO: Escape all
+ * TODO: [🏛] Maybe make some markdown builder
+ * TODO: [🏛] Escape all
  */

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

@@ -58,6 +58,7 @@ export declare function createPipelineExecutor(options: CreatePipelineExecutorOp
 export {};
 /**
  * TODO: Use isVerbose here (not only pass to `preparePipeline`)
+ * TODO: [🧠] Use here `countTotalUsage` and put preparation and prepared pipiline to report
  * TODO: [🪂] Use maxParallelCount here (not only pass to `preparePipeline`)
  * TODO: [♈] Probbably move expectations from templates to parameters
  * TODO: [🧠] When not meet expectations in PROMPT_DIALOG, make some way to tell the user

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

@@ -0,0 +1,15 @@
+import type { string_markdown } from '../../types/typeAliases';
+import type { PromptResultUsage } from '../PromptResultUsage';
+/**
+ * Function `usageToHuman` will take usage and convert it to human readable report
+ */
+export declare function usageToHuman(usage: PromptResultUsage): string_markdown;
+/**
+ * TODO: Use "$1" not "1 USD"
+ * TODO: Use markdown formatting like "Cost approximately **$1**"
+ * TODO: Report in minutes, seconds, days NOT 0.1 hours
+ * TODO: [🧠] Maybe make from `uncertainNumberToHuman` separate exported utility
+ * TODO: When negligible usage, report "Negligible" or just don't report it
+ * TODO: [🧠] Maybe use "~" instead of "approximately"
+ * TODO: [🏛] Maybe make some markdown builder
+ */

package/esm/typings/src/execution/utils/usageToHuman.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -27,4 +27,5 @@ export declare function createLlmToolsFromEnv(options?: CreateLlmToolsFromEnvOpt
  * TODO: [🧠] Is there some meaningfull way how to test this util
  * TODO: [🧠] Maybe pass env as argument
  * Note: [🟢] This code should never be published outside of `@promptbook/node`
+ * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
  */

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

@@ -1,10 +1,11 @@
-import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { LlmExecutionToolsWithTotalUsage } from './utils/count-total-usage/LlmExecutionToolsWithTotalUsage';
 /**
  * Returns LLM tools for CLI
  *
  * @private within the repository - for CLI utils
  */
-export declare function getLlmToolsForCli(): LlmExecutionTools;
+export declare function getLlmToolsForCli(): LlmExecutionToolsWithTotalUsage;
 /**
  * Note: [🟡] This code should never be published outside of `@promptbook/cli`
+ * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
  */

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

@@ -1,11 +1,12 @@
-import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import type { CreateLlmToolsFromEnvOptions } from './createLlmToolsFromEnv';
+import type { LlmExecutionToolsWithTotalUsage } from './utils/count-total-usage/LlmExecutionToolsWithTotalUsage';
 /**
  * Returns LLM tools for testing purposes
  *
  * @private within the repository - JUST FOR TESTS, SCRIPTS AND PLAYGROUND
  */
-export declare function getLlmToolsForTestingAndScriptsAndPlayground(options?: CreateLlmToolsFromEnvOptions): LlmExecutionTools;
+export declare function getLlmToolsForTestingAndScriptsAndPlayground(options?: CreateLlmToolsFromEnvOptions): LlmExecutionToolsWithTotalUsage;
 /**
  * Note: [⚪] This should never be in any released package
+ * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
  */

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

@@ -2,7 +2,7 @@ import type { PromptbookStorage } from '../../../../storage/_common/PromptbookSt
 import type { CacheItem } from './CacheItem';
 export type CacheLlmToolsOptions = {
     /**
-     * Total cost of the execution
+     * @@@
      *
      * @default MemoryStorage
      */

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

@@ -3,14 +3,17 @@ import type { CacheLlmToolsOptions } from './CacheLlmToolsOptions';
 /**
  * Intercepts LLM tools and counts total usage of the tools
  *
- * @param llmTools LLM tools to be intercepted with usage counting
+ * Note: It can take extended `LlmExecutionTools` and cache the
+ *
+ * @param llmTools LLM tools to be intercepted with usage counting, it can contain extra methods like `totalUsage`
  * @returns LLM tools with same functionality with added total cost counting
  */
-export declare function cacheLlmTools(llmTools: LlmExecutionTools, options?: Partial<CacheLlmToolsOptions>): LlmExecutionTools;
+export declare function cacheLlmTools<TLlmTools extends LlmExecutionTools>(llmTools: TLlmTools, options?: Partial<CacheLlmToolsOptions>): TLlmTools;
 /**
  * TODO: [🔼] !!! Export via `@promptbook/core`
- * TODO: @@@ write discussion about this and storages
- *            write how to combine multiple interceptors
  * TODO: [🧠][💸] Maybe make some common abstraction `interceptLlmTools` and use here (or use javascript Proxy?)
  * TODO: [🧠] Is there some meaningfull way how to test this util
+ * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
+ *            @@@ write discussion about this and storages
+ *            @@@ write how to combine multiple interceptors
  */

package/esm/typings/src/llm-providers/_common/utils/{count-total-cost/LlmExecutionToolsWithTotalCost.d.ts → count-total-usage/LlmExecutionToolsWithTotalUsage.d.ts}

@@ -1,11 +1,14 @@
 import type { LlmExecutionTools } from '../../../../execution/LlmExecutionTools';
 import type { PromptResultUsage } from '../../../../execution/PromptResultUsage';
 /**
- * LLM tools with option to get total cost of the execution
+ * LLM tools with option to get total usage of the execution
  */
-export type LlmExecutionToolsWithTotalCost = LlmExecutionTools & {
+export type LlmExecutionToolsWithTotalUsage = LlmExecutionTools & {
     /**
      * Total cost of the execution
      */
     totalUsage: PromptResultUsage;
 };
+/**
+ * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
+ */

package/{umd/typings/src/llm-providers/_common/utils/count-total-cost/countTotalCost.d.ts → esm/typings/src/llm-providers/_common/utils/count-total-usage/countTotalUsage.d.ts}

@@ -1,14 +1,17 @@
 import type { LlmExecutionTools } from '../../../../execution/LlmExecutionTools';
-import type { LlmExecutionToolsWithTotalCost } from './LlmExecutionToolsWithTotalCost';
+import type { LlmExecutionToolsWithTotalUsage } from './LlmExecutionToolsWithTotalUsage';
 /**
  * Intercepts LLM tools and counts total usage of the tools
  *
  * @param llmTools LLM tools to be intercepted with usage counting
  * @returns LLM tools with same functionality with added total cost counting
  */
-export declare function countTotalUsage(llmTools: LlmExecutionTools): LlmExecutionToolsWithTotalCost;
+export declare function countTotalUsage(llmTools: LlmExecutionTools): LlmExecutionToolsWithTotalUsage;
 /**
  * TODO: [🔼] !!! Export via `@promptbookcore/`
  * TODO: [🧠][💸] Maybe make some common abstraction `interceptLlmTools` and use here (or use javascript Proxy?)
  * TODO: [🧠] Is there some meaningfull way how to test this util
+ * TODO: [🧠][🌯] Maybe a way how to hide ability to `get totalUsage`
+ *     > const [llmToolsWithUsage,getUsage] = countTotalUsage(llmTools);
+ * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
  */

package/esm/typings/src/llm-providers/_common/utils/{count-total-cost/limitTotalCost.d.ts → count-total-usage/limitTotalUsage.d.ts}

@@ -2,17 +2,17 @@ import type { LlmExecutionTools } from '../../../../execution/LlmExecutionTools'
 import type { PromptResultUsage } from '../../../../execution/PromptResultUsage';
 import type { PromptbookStorage } from '../../../../storage/_common/PromptbookStorage';
 import type { TODO_any } from '../../../../utils/organization/TODO_any';
-import type { LlmExecutionToolsWithTotalCost } from './LlmExecutionToolsWithTotalCost';
+import type { LlmExecutionToolsWithTotalUsage } from './LlmExecutionToolsWithTotalUsage';
 /**
- * Options for `limitTotalCost`
+ * Options for `limitTotalUsage`
  */
-type LimitTotalCostOptions = {
+type LimitTotalUsageOptions = {
     /**
      * @@@
      *
      * @default ZERO_USAGE
      */
-    maxTotalCost: PromptResultUsage;
+    maxTotalUsage: PromptResultUsage;
     /**
      * @@@
      *
@@ -23,10 +23,13 @@ type LimitTotalCostOptions = {
 /**
  * @@@
  */
-export declare function limitTotalCost(llmTools: LlmExecutionTools, options?: Partial<LimitTotalCostOptions>): LlmExecutionToolsWithTotalCost;
+export declare function limitTotalUsage(llmTools: LlmExecutionTools, options?: Partial<LimitTotalUsageOptions>): LlmExecutionToolsWithTotalUsage;
 export {};
 /**
  * TODO: [🔼] !!! Export via `@promptbookcore/`
+ * TODO: Maybe internally use `countTotalUsage`
  * TODO: [🧠][💸] Maybe make some common abstraction `interceptLlmTools` and use here (or use javascript Proxy?)
  * TODO: [🧠] Is there some meaningfull way how to test this util
+ * TODO: [🧠][🌯] Maybe a way how to hide ability to `get totalUsage`
+ * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
  */

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

@@ -14,3 +14,6 @@ import { MultipleLlmExecutionTools } from './MultipleLlmExecutionTools';
  * Tip: You don't have to use this function directly, just pass an array of LlmExecutionTools to the `ExecutionTools`
  */
 export declare function joinLlmExecutionTools(...llmExecutionTools: Array<LlmExecutionTools>): MultipleLlmExecutionTools;
+/**
+ * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
+ */ 

package/esm/typings/src/prepare/preparePipeline.d.ts

@@ -12,6 +12,5 @@ export declare function preparePipeline(pipeline: PipelineJson, options: Prepare
  * TODO: Write tests for `preparePipeline`
  * TODO: [🏏] Leverage the batch API and build queues @see https://platform.openai.com/docs/guides/batch
  * TODO: [🧊] In future one preparation can take data from previous preparation and save tokens and time
- * TODO: [🎐] !!!!! Use here countTotalUsage
  * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/markdown-utils",
-    "version": "0.61.0",
+    "version": "0.62.0-0",
     "description": "Supercharge your use of large language models",
     "private": false,
     "sideEffects": false,
@@ -34,7 +34,7 @@
     },
     "homepage": "https://www.npmjs.com/package/@promptbook/core",
     "dependencies": {
-        "spacetrim": "0.11.37"
+        "spacetrim": "0.11.39"
     },
     "funding": [
         {
@@ -47,7 +47,7 @@
         }
     ],
     "peerDependencies": {
-        "@promptbook/core": "0.61.0"
+        "@promptbook/core": "0.62.0-0"
     },
     "main": "./umd/index.umd.js",
     "module": "./esm/index.es.js",

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

@@ -26,6 +26,7 @@ import { embeddingVectorToString } from '../execution/embeddingVectorToString';
 import { addUsage } from '../execution/utils/addUsage';
 import { checkExpectations, isPassingExpectations } from '../execution/utils/checkExpectations';
 import { usageToWorktime } from '../execution/utils/usageToWorktime';
+import { usageToHuman } from '../execution/utils/usageToHuman';
 import { CallbackInterfaceTools } from '../knowledge/dialogs/callback/CallbackInterfaceTools';
 import type { CallbackInterfaceToolsOptions } from '../knowledge/dialogs/callback/CallbackInterfaceToolsOptions';
 import { SimplePromptInterfaceTools } from '../knowledge/dialogs/simple-prompt/SimplePromptInterfaceTools';
@@ -39,7 +40,7 @@ import { executionReportJsonToString } from '../types/execution-report/execution
 import { PROMPTBOOK_VERSION } from '../version';
 export { PROMPTBOOK_VERSION };
 export { BlockTypes, RESERVED_PARAMETER_NAMES };
-export { addUsage, assertsExecutionSuccessful, checkExpectations, embeddingVectorToString, executionReportJsonToString, ExecutionReportStringOptions, ExecutionReportStringOptionsDefaults, isPassingExpectations, prepareKnowledgeFromMarkdown, prettifyPipelineString, usageToWorktime, };
+export { addUsage, assertsExecutionSuccessful, checkExpectations, embeddingVectorToString, executionReportJsonToString, ExecutionReportStringOptions, ExecutionReportStringOptionsDefaults, isPassingExpectations, prepareKnowledgeFromMarkdown, prettifyPipelineString, usageToWorktime, usageToHuman, };
 export { collectionToJson, createCollectionFromJson, createCollectionFromPromise, createCollectionFromUrl, createSubcollection, };
 export { SimplePromptInterfaceTools };
 export { pipelineJsonToString, pipelineStringToJson, pipelineStringToJsonSync, stringifyPipelineJson, validatePipeline, };

package/umd/typings/src/conversion/pipelineJsonToString.d.ts

@@ -10,5 +10,6 @@ export declare function pipelineJsonToString(pipelineJson: PipelineJson): Pipeli
 /**
  * TODO: !!!! Implement new features and commands into `promptTemplateParameterJsonToString`
  * TODO: [🧠] Is there a way to auto-detect missing features in pipelineJsonToString
- * TODO: Escape all
+ * TODO: [🏛] Maybe make some markdown builder
+ * TODO: [🏛] Escape all
  */

package/umd/typings/src/execution/createPipelineExecutor.d.ts

@@ -58,6 +58,7 @@ export declare function createPipelineExecutor(options: CreatePipelineExecutorOp
 export {};
 /**
  * TODO: Use isVerbose here (not only pass to `preparePipeline`)
+ * TODO: [🧠] Use here `countTotalUsage` and put preparation and prepared pipiline to report
  * TODO: [🪂] Use maxParallelCount here (not only pass to `preparePipeline`)
  * TODO: [♈] Probbably move expectations from templates to parameters
  * TODO: [🧠] When not meet expectations in PROMPT_DIALOG, make some way to tell the user

package/umd/typings/src/execution/utils/usageToHuman.d.ts

@@ -0,0 +1,15 @@
+import type { string_markdown } from '../../types/typeAliases';
+import type { PromptResultUsage } from '../PromptResultUsage';
+/**
+ * Function `usageToHuman` will take usage and convert it to human readable report
+ */
+export declare function usageToHuman(usage: PromptResultUsage): string_markdown;
+/**
+ * TODO: Use "$1" not "1 USD"
+ * TODO: Use markdown formatting like "Cost approximately **$1**"
+ * TODO: Report in minutes, seconds, days NOT 0.1 hours
+ * TODO: [🧠] Maybe make from `uncertainNumberToHuman` separate exported utility
+ * TODO: When negligible usage, report "Negligible" or just don't report it
+ * TODO: [🧠] Maybe use "~" instead of "approximately"
+ * TODO: [🏛] Maybe make some markdown builder
+ */

package/umd/typings/src/execution/utils/usageToHuman.test.d.ts

@@ -0,0 +1 @@
+export {};

package/umd/typings/src/llm-providers/_common/createLlmToolsFromEnv.d.ts

@@ -27,4 +27,5 @@ export declare function createLlmToolsFromEnv(options?: CreateLlmToolsFromEnvOpt
  * TODO: [🧠] Is there some meaningfull way how to test this util
  * TODO: [🧠] Maybe pass env as argument
  * Note: [🟢] This code should never be published outside of `@promptbook/node`
+ * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
  */

package/umd/typings/src/llm-providers/_common/getLlmToolsForCli.d.ts

@@ -1,10 +1,11 @@
-import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { LlmExecutionToolsWithTotalUsage } from './utils/count-total-usage/LlmExecutionToolsWithTotalUsage';
 /**
  * Returns LLM tools for CLI
  *
  * @private within the repository - for CLI utils
  */
-export declare function getLlmToolsForCli(): LlmExecutionTools;
+export declare function getLlmToolsForCli(): LlmExecutionToolsWithTotalUsage;
 /**
  * Note: [🟡] This code should never be published outside of `@promptbook/cli`
+ * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
  */

package/umd/typings/src/llm-providers/_common/getLlmToolsForTestingAndScriptsAndPlayground.d.ts

@@ -1,11 +1,12 @@
-import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import type { CreateLlmToolsFromEnvOptions } from './createLlmToolsFromEnv';
+import type { LlmExecutionToolsWithTotalUsage } from './utils/count-total-usage/LlmExecutionToolsWithTotalUsage';
 /**
  * Returns LLM tools for testing purposes
  *
  * @private within the repository - JUST FOR TESTS, SCRIPTS AND PLAYGROUND
  */
-export declare function getLlmToolsForTestingAndScriptsAndPlayground(options?: CreateLlmToolsFromEnvOptions): LlmExecutionTools;
+export declare function getLlmToolsForTestingAndScriptsAndPlayground(options?: CreateLlmToolsFromEnvOptions): LlmExecutionToolsWithTotalUsage;
 /**
  * Note: [⚪] This should never be in any released package
+ * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
  */

package/umd/typings/src/llm-providers/_common/utils/cache/CacheLlmToolsOptions.d.ts

@@ -2,7 +2,7 @@ import type { PromptbookStorage } from '../../../../storage/_common/PromptbookSt
 import type { CacheItem } from './CacheItem';
 export type CacheLlmToolsOptions = {
     /**
-     * Total cost of the execution
+     * @@@
      *
      * @default MemoryStorage
      */

package/umd/typings/src/llm-providers/_common/utils/cache/cacheLlmTools.d.ts

@@ -3,14 +3,17 @@ import type { CacheLlmToolsOptions } from './CacheLlmToolsOptions';
 /**
  * Intercepts LLM tools and counts total usage of the tools
  *
- * @param llmTools LLM tools to be intercepted with usage counting
+ * Note: It can take extended `LlmExecutionTools` and cache the
+ *
+ * @param llmTools LLM tools to be intercepted with usage counting, it can contain extra methods like `totalUsage`
  * @returns LLM tools with same functionality with added total cost counting
  */
-export declare function cacheLlmTools(llmTools: LlmExecutionTools, options?: Partial<CacheLlmToolsOptions>): LlmExecutionTools;
+export declare function cacheLlmTools<TLlmTools extends LlmExecutionTools>(llmTools: TLlmTools, options?: Partial<CacheLlmToolsOptions>): TLlmTools;
 /**
  * TODO: [🔼] !!! Export via `@promptbook/core`
- * TODO: @@@ write discussion about this and storages
- *            write how to combine multiple interceptors
  * TODO: [🧠][💸] Maybe make some common abstraction `interceptLlmTools` and use here (or use javascript Proxy?)
  * TODO: [🧠] Is there some meaningfull way how to test this util
+ * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
+ *            @@@ write discussion about this and storages
+ *            @@@ write how to combine multiple interceptors
  */

package/umd/typings/src/llm-providers/_common/utils/{count-total-cost/LlmExecutionToolsWithTotalCost.d.ts → count-total-usage/LlmExecutionToolsWithTotalUsage.d.ts}

@@ -1,11 +1,14 @@
 import type { LlmExecutionTools } from '../../../../execution/LlmExecutionTools';
 import type { PromptResultUsage } from '../../../../execution/PromptResultUsage';
 /**
- * LLM tools with option to get total cost of the execution
+ * LLM tools with option to get total usage of the execution
  */
-export type LlmExecutionToolsWithTotalCost = LlmExecutionTools & {
+export type LlmExecutionToolsWithTotalUsage = LlmExecutionTools & {
     /**
      * Total cost of the execution
      */
     totalUsage: PromptResultUsage;
 };
+/**
+ * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
+ */

package/{esm/typings/src/llm-providers/_common/utils/count-total-cost/countTotalCost.d.ts → umd/typings/src/llm-providers/_common/utils/count-total-usage/countTotalUsage.d.ts}

@@ -1,14 +1,17 @@
 import type { LlmExecutionTools } from '../../../../execution/LlmExecutionTools';
-import type { LlmExecutionToolsWithTotalCost } from './LlmExecutionToolsWithTotalCost';
+import type { LlmExecutionToolsWithTotalUsage } from './LlmExecutionToolsWithTotalUsage';
 /**
  * Intercepts LLM tools and counts total usage of the tools
  *
  * @param llmTools LLM tools to be intercepted with usage counting
  * @returns LLM tools with same functionality with added total cost counting
  */
-export declare function countTotalUsage(llmTools: LlmExecutionTools): LlmExecutionToolsWithTotalCost;
+export declare function countTotalUsage(llmTools: LlmExecutionTools): LlmExecutionToolsWithTotalUsage;
 /**
  * TODO: [🔼] !!! Export via `@promptbookcore/`
  * TODO: [🧠][💸] Maybe make some common abstraction `interceptLlmTools` and use here (or use javascript Proxy?)
  * TODO: [🧠] Is there some meaningfull way how to test this util
+ * TODO: [🧠][🌯] Maybe a way how to hide ability to `get totalUsage`
+ *     > const [llmToolsWithUsage,getUsage] = countTotalUsage(llmTools);
+ * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
  */

package/umd/typings/src/llm-providers/_common/utils/{count-total-cost/limitTotalCost.d.ts → count-total-usage/limitTotalUsage.d.ts}

@@ -2,17 +2,17 @@ import type { LlmExecutionTools } from '../../../../execution/LlmExecutionTools'
 import type { PromptResultUsage } from '../../../../execution/PromptResultUsage';
 import type { PromptbookStorage } from '../../../../storage/_common/PromptbookStorage';
 import type { TODO_any } from '../../../../utils/organization/TODO_any';
-import type { LlmExecutionToolsWithTotalCost } from './LlmExecutionToolsWithTotalCost';
+import type { LlmExecutionToolsWithTotalUsage } from './LlmExecutionToolsWithTotalUsage';
 /**
- * Options for `limitTotalCost`
+ * Options for `limitTotalUsage`
  */
-type LimitTotalCostOptions = {
+type LimitTotalUsageOptions = {
     /**
      * @@@
      *
      * @default ZERO_USAGE
      */
-    maxTotalCost: PromptResultUsage;
+    maxTotalUsage: PromptResultUsage;
     /**
      * @@@
      *
@@ -23,10 +23,13 @@ type LimitTotalCostOptions = {
 /**
  * @@@
  */
-export declare function limitTotalCost(llmTools: LlmExecutionTools, options?: Partial<LimitTotalCostOptions>): LlmExecutionToolsWithTotalCost;
+export declare function limitTotalUsage(llmTools: LlmExecutionTools, options?: Partial<LimitTotalUsageOptions>): LlmExecutionToolsWithTotalUsage;
 export {};
 /**
  * TODO: [🔼] !!! Export via `@promptbookcore/`
+ * TODO: Maybe internally use `countTotalUsage`
  * TODO: [🧠][💸] Maybe make some common abstraction `interceptLlmTools` and use here (or use javascript Proxy?)
  * TODO: [🧠] Is there some meaningfull way how to test this util
+ * TODO: [🧠][🌯] Maybe a way how to hide ability to `get totalUsage`
+ * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
  */

package/umd/typings/src/llm-providers/multiple/joinLlmExecutionTools.d.ts

@@ -14,3 +14,6 @@ import { MultipleLlmExecutionTools } from './MultipleLlmExecutionTools';
  * Tip: You don't have to use this function directly, just pass an array of LlmExecutionTools to the `ExecutionTools`
  */
 export declare function joinLlmExecutionTools(...llmExecutionTools: Array<LlmExecutionTools>): MultipleLlmExecutionTools;
+/**
+ * TODO: [👷‍♂️] @@@ Manual about construction of llmTools
+ */ 

package/umd/typings/src/prepare/preparePipeline.d.ts

@@ -12,6 +12,5 @@ export declare function preparePipeline(pipeline: PipelineJson, options: Prepare
  * TODO: Write tests for `preparePipeline`
  * TODO: [🏏] Leverage the batch API and build queues @see https://platform.openai.com/docs/guides/batch
  * TODO: [🧊] In future one preparation can take data from previous preparation and save tokens and time
- * TODO: [🎐] !!!!! Use here countTotalUsage
  * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
  */