@promptbook/cli 0.62.2 → 0.63.0-0

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

@@ -1,99 +1,99 @@
-import type { string_date_iso8601 } from '../types/typeAliases';
-import type { string_model_name } from '../types/typeAliases';
-import type { string_prompt } from '../types/typeAliases';
-import type { TODO_object } from '../utils/organization/TODO_object';
-import type { EmbeddingVector } from './EmbeddingVector';
-import type { PromptResultUsage } from './PromptResultUsage';
-/**
- * Prompt result is the simplest concept of execution.
- * It is the result of executing one prompt _(NOT a template)_.
- *
- * @see https://github.com/webgptorg/promptbook#prompt-result
- */
-export type PromptResult = CompletionPromptResult | ChatPromptResult | EmbeddingPromptResult;
-/**
- * Completion prompt result
- *
- * Note:It contains only the newly generated text NOT the whole completion
- * Note: This is fully serializable as JSON
- */
-export type CompletionPromptResult = CommonPromptResult;
-/**
- *Chat prompt result
- *
- * Note: This is fully serializable as JSON
- */
-export type ChatPromptResult = CommonPromptResult & {};
-/**
- * Embedding prompt  result
- *
- * Note: This is fully serializable as JSON
- */
-export type EmbeddingPromptResult = Omit<CommonPromptResult, 'content'> & {
-    /**
-     * The response from the model
-     */
-    content: EmbeddingVector;
-};
-/**
- * Common properties for all prompt results
- *
- * Note: This is fully serializable as JSON
- */
-export type CommonPromptResult = {
-    /**
-     * Exact text response from the model
-     */
-    readonly content: string;
-    /**
-     * Name of the model used to generate the response
-     */
-    readonly modelName: string_model_name;
-    /**
-     * Timing
-     */
-    readonly timing: {
-        /**
-         * Start of the execution
-         */
-        readonly start: string_date_iso8601;
-        /**
-         * First token generated
-         */
-        readonly firstToken?: string_date_iso8601;
-        /**
-         * End of the execution
-         */
-        readonly complete: string_date_iso8601;
-    };
-    /**
-     * Usage of the prompt execution
-     */
-    readonly usage: PromptResultUsage;
-    /**
-     * Exact text of the prompt (with all replacements)
-     *
-     * Note: This contains redundant information
-     */
-    readonly rawPromptContent: string_prompt;
-    /**
-     * Raw request to the model
-     *
-     * Note: This contains redundant information
-     */
-    readonly rawRequest: TODO_object | null;
-    /**
-     * Raw response from the model
-     *
-     * Note: This contains redundant information
-     */
-    readonly rawResponse: TODO_object;
-};
-/**
- * TODO: [🧠] Maybe timing more accurate then seconds?
- * TODO: [🧠] Should here be link to the prompt?
- * TODO: [🧠] Maybe type `rawResponse` properly - not onject but OpenAI.result.whatever
- * TODO: [🧠] Maybe remove redundant raw.choices.text
- * TODO: Log raw even if prompt failed - log the raw error
- * TODO: [🏳] Add `TranslationPromptResult`
- */
+import type { string_date_iso8601 } from '../types/typeAliases';
+import type { string_model_name } from '../types/typeAliases';
+import type { string_prompt } from '../types/typeAliases';
+import type { TODO_object } from '../utils/organization/TODO_object';
+import type { EmbeddingVector } from './EmbeddingVector';
+import type { PromptResultUsage } from './PromptResultUsage';
+/**
+ * Prompt result is the simplest concept of execution.
+ * It is the result of executing one prompt _(NOT a template)_.
+ *
+ * @see https://github.com/webgptorg/promptbook#prompt-result
+ */
+export type PromptResult = CompletionPromptResult | ChatPromptResult | EmbeddingPromptResult;
+/**
+ * Completion prompt result
+ *
+ * Note:It contains only the newly generated text NOT the whole completion
+ * Note: This is fully serializable as JSON
+ */
+export type CompletionPromptResult = CommonPromptResult;
+/**
+ *Chat prompt result
+ *
+ * Note: This is fully serializable as JSON
+ */
+export type ChatPromptResult = CommonPromptResult & {};
+/**
+ * Embedding prompt  result
+ *
+ * Note: This is fully serializable as JSON
+ */
+export type EmbeddingPromptResult = Omit<CommonPromptResult, 'content'> & {
+    /**
+     * The response from the model
+     */
+    content: EmbeddingVector;
+};
+/**
+ * Common properties for all prompt results
+ *
+ * Note: This is fully serializable as JSON
+ */
+export type CommonPromptResult = {
+    /**
+     * Exact text response from the model
+     */
+    readonly content: string;
+    /**
+     * Name of the model used to generate the response
+     */
+    readonly modelName: string_model_name;
+    /**
+     * Timing
+     */
+    readonly timing: {
+        /**
+         * Start of the execution
+         */
+        readonly start: string_date_iso8601;
+        /**
+         * First token generated
+         */
+        readonly firstToken?: string_date_iso8601;
+        /**
+         * End of the execution
+         */
+        readonly complete: string_date_iso8601;
+    };
+    /**
+     * Usage of the prompt execution
+     */
+    readonly usage: PromptResultUsage;
+    /**
+     * Exact text of the prompt (with all replacements)
+     *
+     * Note: This contains redundant information
+     */
+    readonly rawPromptContent: string_prompt;
+    /**
+     * Raw request to the model
+     *
+     * Note: This contains redundant information
+     */
+    readonly rawRequest: TODO_object | null;
+    /**
+     * Raw response from the model
+     *
+     * Note: This contains redundant information
+     */
+    readonly rawResponse: TODO_object;
+};
+/**
+ * TODO: [🧠] Maybe timing more accurate then seconds?
+ * TODO: [🧠] Should here be link to the prompt?
+ * TODO: [🧠] Maybe type `rawResponse` properly - not onject but OpenAI.result.whatever
+ * TODO: [🧠] Maybe remove redundant raw.choices.text
+ * TODO: Log raw even if prompt failed - log the raw error
+ * TODO: [🏳] Add `TranslationPromptResult`
+ */

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

@@ -1,29 +1,29 @@
-import type { KebabCase } from 'type-fest';
-import type { ExpectationUnit } from '../types/PipelineJson/Expectations';
-import type { UncertainNumber } from './UncertainNumber';
-/**
- * Usage statistics for one or many prompt results
- */
-export type PromptResultUsage = {
-    /**
-     * Cost of the execution in USD
-     *
-     * Note: If the cost is unknown, the value 0 and isUncertain is true
-     */
-    readonly price: UncertainNumber;
-    /**
-     * Number of whatever used in the input aka. `prompt_tokens`
-     */
-    readonly input: PromptResultUsageCounts;
-    /**
-     * Number of tokens used in the output aka. `completion_tokens`
-     */
-    readonly output: PromptResultUsageCounts;
-};
-/**
- * Record of all possible measurable units
- */
-export type PromptResultUsageCounts = Record<`${KebabCase<'TOKENS' | ExpectationUnit>}Count`, UncertainNumber>;
-/**
- * TODO: [🍙] Make some standart order of json properties
- */
+import type { KebabCase } from 'type-fest';
+import type { ExpectationUnit } from '../types/PipelineJson/Expectations';
+import type { UncertainNumber } from './UncertainNumber';
+/**
+ * Usage statistics for one or many prompt results
+ */
+export type PromptResultUsage = {
+    /**
+     * Cost of the execution in USD
+     *
+     * Note: If the cost is unknown, the value 0 and isUncertain is true
+     */
+    readonly price: UncertainNumber;
+    /**
+     * Number of whatever used in the input aka. `prompt_tokens`
+     */
+    readonly input: PromptResultUsageCounts;
+    /**
+     * Number of tokens used in the output aka. `completion_tokens`
+     */
+    readonly output: PromptResultUsageCounts;
+};
+/**
+ * Record of all possible measurable units
+ */
+export type PromptResultUsageCounts = Record<`${KebabCase<'TOKENS' | ExpectationUnit>}Count`, UncertainNumber>;
+/**
+ * TODO: [🍙] Make some standart order of json properties
+ */

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

@@ -1,39 +1,39 @@
-import type { ScriptLanguage } from '../types/ScriptLanguage';
-import type { Parameters } from '../types/typeAliases';
-import type { string_script } from '../types/typeAliases';
-/**
- * Represents all the tools needed to EXECUTE SCRIPTs
- *
- * @see https://github.com/webgptorg/promptbook#script-execution-tools
- */
-export type ScriptExecutionTools = {
-    execute(options: ScriptExecutionToolsExecuteOptions): Promise<string>;
-};
-/**
- * Input for the script execution
- */
-export type ScriptExecutionToolsExecuteOptions = {
-    /**
-     * Language of the script
-     */
-    readonly scriptLanguage: ScriptLanguage;
-    /**
-     * Parameters for the script
-     * Theese parameters are passed to the script as variables
-     * For example: { "name": "John" } => const name = "John";
-     */
-    readonly parameters: Parameters;
-    /**
-     * The content of the script to execute
-     * - It can be a single statement
-     * - It can be multiple statements separated by semicolon and return
-     * - It can be a function (but you need to call it)
-     * - It can be IIFE (immediately invoked function expression)
-     * - It can use the parameters as variables and functions from global scope
-     */
-    readonly script: string_script;
-};
-/**
- * TODO: [🧠][💙] Distinct between options passed into ExecutionTools and to ExecutionTools.execute
- * TODO: [🧠][🪐] Should be common things like types, utils in folder containing A,B,C,.. or else outside this listing folder?
- */
+import type { ScriptLanguage } from '../types/ScriptLanguage';
+import type { Parameters } from '../types/typeAliases';
+import type { string_script } from '../types/typeAliases';
+/**
+ * Represents all the tools needed to EXECUTE SCRIPTs
+ *
+ * @see https://github.com/webgptorg/promptbook#script-execution-tools
+ */
+export type ScriptExecutionTools = {
+    execute(options: ScriptExecutionToolsExecuteOptions): Promise<string>;
+};
+/**
+ * Input for the script execution
+ */
+export type ScriptExecutionToolsExecuteOptions = {
+    /**
+     * Language of the script
+     */
+    readonly scriptLanguage: ScriptLanguage;
+    /**
+     * Parameters for the script
+     * Theese parameters are passed to the script as variables
+     * For example: { "name": "John" } => const name = "John";
+     */
+    readonly parameters: Parameters;
+    /**
+     * The content of the script to execute
+     * - It can be a single statement
+     * - It can be multiple statements separated by semicolon and return
+     * - It can be a function (but you need to call it)
+     * - It can be IIFE (immediately invoked function expression)
+     * - It can use the parameters as variables and functions from global scope
+     */
+    readonly script: string_script;
+};
+/**
+ * TODO: [🧠][💙] Distinct between options passed into ExecutionTools and to ExecutionTools.execute
+ * TODO: [🧠][🪐] Should be common things like types, utils in folder containing A,B,C,.. or else outside this listing folder?
+ */

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

@@ -1,18 +1,18 @@
-import type { number_positive } from '../types/typeAliases';
-import type { number_usd } from '../types/typeAliases';
-/**
- * Number which can be uncertain
- *
- * Note: If the value is completelly unknown, the value 0 and isUncertain is true
- * Note: Not using NaN or null because it looses the value which is better to be uncertain then not to be at all
- */
-export type UncertainNumber = {
-    /**
-     * The numeric value
-     */
-    readonly value: number_usd & (number_positive | 0);
-    /**
-     * Is the value uncertain
-     */
-    readonly isUncertain?: true;
-};
+import type { number_positive } from '../types/typeAliases';
+import type { number_usd } from '../types/typeAliases';
+/**
+ * Number which can be uncertain
+ *
+ * Note: If the value is completelly unknown, the value 0 and isUncertain is true
+ * Note: Not using NaN or null because it looses the value which is better to be uncertain then not to be at all
+ */
+export type UncertainNumber = {
+    /**
+     * The numeric value
+     */
+    readonly value: number_usd & (number_positive | 0);
+    /**
+     * Is the value uncertain
+     */
+    readonly isUncertain?: true;
+};

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

@@ -1,46 +1,46 @@
-import type { number_integer } from '../types/typeAliases';
-import type { number_positive } from '../types/typeAliases';
-/**
- * Represents all the tools needed to interact with the user.
- *
- * @see https://github.com/webgptorg/promptbook#user-interface-tools
- */
-export type UserInterfaceTools = {
-    /**
-     * Asks the user to answer a free-text (multi-line) question
-     *
-     * @param options the question to ask
-     * @returns the answer from the user
-     */
-    promptDialog(options: UserInterfaceToolsPromptDialogOptions): Promise<string>;
-};
-export type UserInterfaceToolsPromptDialogOptions = {
-    /**
-     * Prompt title
-     *
-     * Note: This is not a prompt to language model but a prompt to the user
-     * @example "Your name"
-     */
-    readonly promptTitle: string;
-    /**
-     * Prompt message
-     *
-     * Note: This is not a prompt to language model but a prompt to the user
-     * @example "Please enter your name, including your last name, title, etc."
-     */
-    readonly promptMessage: string;
-    /**
-     * Default value for the input/textarea
-     */
-    readonly defaultValue: string | null;
-    /**
-     * Placeholder for the input/textarea
-     */
-    readonly placeholder?: string;
-    /**
-     * Priority of the prompt
-     *
-     * Note: This would be reflected for example into the UI z-index of the prompt modal
-     */
-    readonly priority: number_integer & number_positive;
-};
+import type { number_integer } from '../types/typeAliases';
+import type { number_positive } from '../types/typeAliases';
+/**
+ * Represents all the tools needed to interact with the user.
+ *
+ * @see https://github.com/webgptorg/promptbook#user-interface-tools
+ */
+export type UserInterfaceTools = {
+    /**
+     * Asks the user to answer a free-text (multi-line) question
+     *
+     * @param options the question to ask
+     * @returns the answer from the user
+     */
+    promptDialog(options: UserInterfaceToolsPromptDialogOptions): Promise<string>;
+};
+export type UserInterfaceToolsPromptDialogOptions = {
+    /**
+     * Prompt title
+     *
+     * Note: This is not a prompt to language model but a prompt to the user
+     * @example "Your name"
+     */
+    readonly promptTitle: string;
+    /**
+     * Prompt message
+     *
+     * Note: This is not a prompt to language model but a prompt to the user
+     * @example "Please enter your name, including your last name, title, etc."
+     */
+    readonly promptMessage: string;
+    /**
+     * Default value for the input/textarea
+     */
+    readonly defaultValue: string | null;
+    /**
+     * Placeholder for the input/textarea
+     */
+    readonly placeholder?: string;
+    /**
+     * Priority of the prompt
+     *
+     * Note: This would be reflected for example into the UI z-index of the prompt modal
+     */
+    readonly priority: number_integer & number_positive;
+};

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

@@ -1,11 +1,12 @@
-import type { PipelineExecutor } from './PipelineExecutor';
-/**
- * Asserts that the execution of a promptnook is successful
- *
- * @param executionResult - The partial result of the promptnook execution
- * @throws {PipelineExecutionError} If the execution is not successful or if multiple errors occurred
- */
-export declare function assertsExecutionSuccessful(executionResult: Pick<Awaited<ReturnType<PipelineExecutor>>, 'isSuccessful' | 'errors'>): void;
-/**
- * TODO: [🧠] Can this return type be better typed than void
- */
+import type { PipelineExecutor } from './PipelineExecutor';
+/**
+ * Asserts that the execution of a promptnook is successful
+ *
+ * @param executionResult - The partial result of the promptnook execution
+ * @throws {PipelineExecutionError} If the execution is not successful or if multiple errors occurred
+ * @public exported from `@promptbook/core`
+ */
+export declare function assertsExecutionSuccessful(executionResult: Pick<Awaited<ReturnType<PipelineExecutor>>, 'isSuccessful' | 'errors'>): void;
+/**
+ * TODO: [🧠] Can this return type be better typed than void
+ */

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

@@ -1,70 +1,71 @@
-import type { PipelineJson } from '../types/PipelineJson/PipelineJson';
-import type { ExecutionTools } from './ExecutionTools';
-import type { PipelineExecutor } from './PipelineExecutor';
-type CreatePipelineExecutorSettings = {
-    /**
-     * When executor does not satisfy expectations it will be retried this amount of times
-     *
-     * @default MAX_EXECUTION_ATTEMPTS
-     */
-    readonly maxExecutionAttempts?: number;
-    /**
-     * Maximum number of tasks running in parallel
-     *
-     * @default MAX_PARALLEL_COUNT
-     */
-    readonly maxParallelCount?: number;
-    /**
-     * If true, the preparation logs additional information
-     *
-     * @default false
-     */
-    readonly isVerbose?: boolean;
-    /**
-     * If you pass fully prepared pipeline, this does not matter
-     *
-     * Otherwise:
-     * If false or not set, warning is shown when pipeline is not prepared
-     * If true, warning is suppressed
-     *
-     * @default false
-     */
-    readonly isNotPreparedWarningSupressed?: boolean;
-};
-/**
- * Options for `createPipelineExecutor`
- */
-interface CreatePipelineExecutorOptions {
-    /**
-     * The pipeline to be executed
-     */
-    readonly pipeline: PipelineJson;
-    /**
-     * The execution tools to be used during the execution of the pipeline
-     */
-    readonly tools: ExecutionTools;
-    /**
-     * Optional settings for the pipeline executor
-     */
-    readonly settings?: Partial<CreatePipelineExecutorSettings>;
-}
-/**
- * Creates executor function from pipeline and execution tools.
- *
- * @returns The executor function
- * @throws {PipelineLogicError} on logical error in the pipeline
- */
-export declare function createPipelineExecutor(options: CreatePipelineExecutorOptions): PipelineExecutor;
-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
- * TODO: [👧] Strongly type the executors to avoid need of remove nullables whtn noUncheckedIndexedAccess in tsconfig.json
- * Note: CreatePipelineExecutorOptions are just connected to PipelineExecutor so do not extract to types folder
- * TODO: [🧠][3] transparent = (report intermediate parameters) / opaque execution = (report only output parameters) progress reporting mode
- * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
- * TODO: [🧠][💷] `assertsExecutionSuccessful` should be the method of `PipelineExecutor` result BUT maybe NOT to preserve pure JSON object
- */
+import type { PipelineJson } from '../types/PipelineJson/PipelineJson';
+import type { ExecutionTools } from './ExecutionTools';
+import type { PipelineExecutor } from './PipelineExecutor';
+type CreatePipelineExecutorSettings = {
+    /**
+     * When executor does not satisfy expectations it will be retried this amount of times
+     *
+     * @default MAX_EXECUTION_ATTEMPTS
+     */
+    readonly maxExecutionAttempts?: number;
+    /**
+     * Maximum number of tasks running in parallel
+     *
+     * @default MAX_PARALLEL_COUNT
+     */
+    readonly maxParallelCount?: number;
+    /**
+     * If true, the preparation logs additional information
+     *
+     * @default false
+     */
+    readonly isVerbose?: boolean;
+    /**
+     * If you pass fully prepared pipeline, this does not matter
+     *
+     * Otherwise:
+     * If false or not set, warning is shown when pipeline is not prepared
+     * If true, warning is suppressed
+     *
+     * @default false
+     */
+    readonly isNotPreparedWarningSupressed?: boolean;
+};
+/**
+ * Options for `createPipelineExecutor`
+ */
+interface CreatePipelineExecutorOptions {
+    /**
+     * The pipeline to be executed
+     */
+    readonly pipeline: PipelineJson;
+    /**
+     * The execution tools to be used during the execution of the pipeline
+     */
+    readonly tools: ExecutionTools;
+    /**
+     * Optional settings for the pipeline executor
+     */
+    readonly settings?: Partial<CreatePipelineExecutorSettings>;
+}
+/**
+ * Creates executor function from pipeline and execution tools.
+ *
+ * @returns The executor function
+ * @throws {PipelineLogicError} on logical error in the pipeline
+ * @public exported from `@promptbook/core`
+ */
+export declare function createPipelineExecutor(options: CreatePipelineExecutorOptions): PipelineExecutor;
+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
+ * TODO: [👧] Strongly type the executors to avoid need of remove nullables whtn noUncheckedIndexedAccess in tsconfig.json
+ * Note: CreatePipelineExecutorOptions are just connected to PipelineExecutor so do not extract to types folder
+ * TODO: [🧠][3] transparent = (report intermediate parameters) / opaque execution = (report only output parameters) progress reporting mode
+ * TODO: [🛠] Actions, instruments (and maybe knowledge) => Functions and tools
+ * TODO: [🧠][💷] `assertsExecutionSuccessful` should be the method of `PipelineExecutor` result BUT maybe NOT to preserve pure JSON object
+ */

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

@@ -1,5 +1,7 @@
-import type { EmbeddingVector } from './EmbeddingVector';
-/**
- * Pretty print an embedding vector for logging
- */
-export declare function embeddingVectorToString(embeddingVector: EmbeddingVector): string;
+import type { EmbeddingVector } from './EmbeddingVector';
+/**
+ * Pretty print an embedding vector for logging
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function embeddingVectorToString(embeddingVector: EmbeddingVector): string;

package/umd/typings/src/execution/translation/automatic-translate/automatic-translators/AutomaticTranslator.d.ts

@@ -1,4 +1,4 @@
-import type { Promisable } from 'type-fest';
-export type AutomaticTranslator = {
-    translate(message: string): Promisable<string>;
-};
+import type { Promisable } from 'type-fest';
+export type AutomaticTranslator = {
+    translate(message: string): Promisable<string>;
+};