@promptbook/openai 0.26.0 → 0.27.0-1

package/esm/index.es.js

@@ -191,7 +191,7 @@ var OpenAiExecutionTools = /** @class */ (function () {
     return OpenAiExecutionTools;
 }());
 /**
- * TODO: !!!! Allow to use other models - List all from openai
+
  * TODO: Maybe Create some common util for gptChat and gptComplete
  * TODO: Maybe make custom OpenaiError
  */

package/esm/typings/conversion/parseCommand.test.d.ts

@@ -1,6 +1,5 @@
 export {};
 /**
  * TODO: [🧠] Probbably change syntax MODEL VARIANT -> MODEL
- * TODO: !!!! Allow to skip segments SKIP IF {foo} NOT DEFINED
- * TODO: !!! Allow to EXPECT 3 words
+ * TODO: !!! Allow to skip segments SKIP IF {foo} NOT DEFINED
  */

package/esm/typings/conversion/promptTemplatePipelineStringToJson.d.ts

@@ -9,7 +9,5 @@ export declare function promptTemplatePipelineStringToJson(promptTemplatePipelin
 /**
  * TODO: Report here line/column of error
  * TODO: Use spaceTrim more effectively
- * TODO: !!!! Parameter flags - isInput, isOutput, isInternal, isBeforePostprocessing, isBeforeFinal, canonicalName
- * TODO: !!!! Allow to have non-immutable parameters - suffix them with fooPrevious3 -> fooPrevious2 -> fooPrevious1 -> foo
- *            This must work with other technial parameters
+ * TODO: [🧠] Parameter flags - isInput, isOutput, isInternal
  */

package/esm/typings/execution/ExpectError.d.ts

@@ -0,0 +1,10 @@
+/**
+ * This error occurs when some expectation is not met in the execution of the pipeline
+ */
+export declare class ExpectError extends Error {
+    readonly name = "ExpectError";
+    constructor(message: string);
+}
+/**
+ * TODO: [🧠] Should be this exported from the library
+ */

package/esm/typings/execution/PtpExecutor.d.ts

@@ -3,7 +3,7 @@ import type { string_name } from '.././types/typeAliases';
 import type { TaskProgress } from '../types/TaskProgress';
 import type { ExecutionReportJson } from '../types/execution-report/ExecutionReportJson';
 /**
- * Executor is a simple async function that takes input parameters and returns result parameters _(along with all intermediate parameters and input parameters = it extends input object)_.
+ * Executor is a simple async function that takes INPUT  PARAMETERs and returns result parameters _(along with all intermediate parameters and INPUT  PARAMETERs = it extends input object)_.
  * Executor is made by combining execution tools and prompt template pipeline library.
  *
  * It can be done in two ways:

package/esm/typings/execution/ScriptExecutionTools.d.ts

@@ -1,7 +1,7 @@
 import { string_name, string_script } from '.././types/typeAliases';
 import { ScriptLanguage } from '../types/ScriptLanguage';
 /**
- * Represents all the tools needed to execute scripts
+ * Represents all the tools needed to EXECUTE SCRIPTs
  *
  * @see https://github.com/webgptorg/promptbook#script-execution-tools
  */

package/esm/typings/execution/createPtpExecutor.d.ts

@@ -1,4 +1,4 @@
-import { PromptTemplatePipeline } from '../classes/PromptTemplatePipeline';
+import type { PromptTemplatePipeline } from '../classes/PromptTemplatePipeline';
 import { ExecutionTools } from './ExecutionTools';
 import { PtpExecutor } from './PtpExecutor';
 export interface CreatePtpExecutorSettings {
@@ -7,7 +7,7 @@ export interface CreatePtpExecutorSettings {
      *
      * @default 3
      */
-    readonly maxNaturalExecutionAttempts: number;
+    readonly maxExecutionAttempts: number;
 }
 /**
  * Options for creating a PTP (Prompt Template Pipeline) executor

package/esm/typings/execution/plugins/natural-execution-tools/openai/OpenAiExecutionTools.d.ts

@@ -22,7 +22,7 @@ export declare class OpenAiExecutionTools implements NaturalExecutionTools {
     gptComplete(prompt: Prompt): Promise<PromptCompletionResult>;
 }
 /**
- * TODO: !!!! Allow to use other models - List all from openai
+
  * TODO: Maybe Create some common util for gptChat and gptComplete
  * TODO: Maybe make custom OpenaiError
  */

package/esm/typings/types/Command.d.ts

@@ -46,7 +46,7 @@ export interface ModelCommand {
 /**
  * Parameter command describes one parameter of the prompt template
  *
- * - It can tell if it is input or output parameter
+ * - It can tell if it is input or OUTPUT PARAMETER
  * - It can have description
  * - In description it can have simple formatting BUT not markdown structure or reference to other parameters
  */
@@ -58,7 +58,7 @@ export interface ParameterCommand {
 }
 /**
  * Postprocess command describes which function to use for postprocessing
- * This will be created as separate execute script block bellow
+ * This will be created as separate EXECUTE SCRIPT block bellow
  */
 export interface PostprocessCommand {
     readonly type: 'POSTPROCESS';

package/esm/typings/types/Parameters.d.ts

@@ -2,9 +2,9 @@
  * Parameters of the prompt template (pipeline)
  *
  * There are three types of parameters:
- * - **Input parameters** are required to execute the prompt template pipeline.
+ * - **INPUT  PARAMETERs** are required to execute the prompt template pipeline.
  * - **Intermediate parameters** are used internally in the prompt template pipeline.
- * - **Output parameters** are not used internally in the prompt template pipeline, but are returned as the result of the prompt template pipeline execution.
+ * - **OUTPUT PARAMETERs** are not used internally in the prompt template pipeline, but are returned as the result of the prompt template pipeline execution.
  *
  * @see https://github.com/webgptorg/promptbook#parameters
  */

package/esm/typings/types/PromptTemplatePipelineJson/PromptTemplateJson.d.ts

@@ -1,4 +1,4 @@
-import { number_integer, number_positive_or_zero, string_javascript, string_markdown, string_name, string_prompt, string_template } from '../.././types/typeAliases';
+import { number_integer, number_positive_or_zero, string_javascript, string_javascript_name, string_markdown, string_name, string_prompt, string_template } from '../.././types/typeAliases';
 import { ExpectFormatCommand } from '../Command';
 import { ExecutionType } from '../ExecutionTypes';
 import { ModelRequirements } from '../ModelRequirements';
@@ -12,19 +12,6 @@ export type PromptTemplateJson = NaturalTemplateJson | SimpleTemplateJson | Scri
  */
 export interface NaturalTemplateJson extends PromptTemplateJsonCommon {
     readonly executionType: 'PROMPT_TEMPLATE';
-    /**
-     * Expect this amount of each unit in the answer
-     *
-     * For example 5 words, 3 sentences, 2 paragraphs, ...
-     */
-    readonly expectAmount?: Partial<Record<Lowercase<ExpectationUnit>, {
-        min?: ExpectationAmount;
-        max?: ExpectationAmount;
-    }>>;
-    /**
-     * Expect this format of the answer
-     */
-    readonly expectFormat?: ExpectFormatCommand['format'];
     /**
      * Requirements for the model
      * - This is required only for executionType PROMPT_TEMPLATE
@@ -97,6 +84,27 @@ interface PromptTemplateJsonCommon {
      * Content of the template with {placeholders} for parameters
      */
     readonly content: (string_prompt | string_javascript | string_markdown) & string_template;
+    /**
+     * List of postprocessing steps that are executed after the prompt template
+     */
+    readonly postprocessing?: Array<string_javascript_name>;
+    /**
+     * Expect this amount of each unit in the answer
+     *
+     * For example 5 words, 3 sentences, 2 paragraphs, ...
+     *
+     * Note: Expectations are performed after all postprocessing steps
+     */
+    readonly expectAmount?: Partial<Record<Lowercase<ExpectationUnit>, {
+        min?: ExpectationAmount;
+        max?: ExpectationAmount;
+    }>>;
+    /**
+     * Expect this format of the answer
+     *
+     * Note: Expectations are performed after all postprocessing steps
+     */
+    readonly expectFormat?: ExpectFormatCommand['format'];
     /**
      * Name of the parameter that is the result of the prompt template
      */

package/esm/typings/types/PromptTemplatePipelineJson/PromptTemplateParameterJson.d.ts

@@ -12,7 +12,7 @@ export interface PromptTemplateParameterJson {
     /**
      * The parameter is input of the pipeline
      *
-     * Note: Output parameter is every parameter including input one
+     * Note: OUTPUT PARAMETER is every parameter including input one
      */
     readonly isInput: boolean;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/openai",
-    "version": "0.26.0",
+    "version": "0.27.0-1",
     "description": "Library to supercharge your use of large language models",
     "private": false,
     "sideEffects": false,
@@ -37,7 +37,7 @@
         "openai": "4.2.0"
     },
     "peerDependencies": {
-        "@promptbook/core": "0.26.0"
+        "@promptbook/core": "0.27.0-1"
     },
     "main": "./umd/index.umd.js",
     "module": "./esm/index.es.js",

package/umd/index.umd.js

@@ -199,7 +199,7 @@
         return OpenAiExecutionTools;
     }());
     /**
-     * TODO: !!!! Allow to use other models - List all from openai
+
      * TODO: Maybe Create some common util for gptChat and gptComplete
      * TODO: Maybe make custom OpenaiError
      */

package/umd/typings/conversion/parseCommand.test.d.ts

@@ -1,6 +1,5 @@
 export {};
 /**
  * TODO: [🧠] Probbably change syntax MODEL VARIANT -> MODEL
- * TODO: !!!! Allow to skip segments SKIP IF {foo} NOT DEFINED
- * TODO: !!! Allow to EXPECT 3 words
+ * TODO: !!! Allow to skip segments SKIP IF {foo} NOT DEFINED
  */

package/umd/typings/conversion/promptTemplatePipelineStringToJson.d.ts

@@ -9,7 +9,5 @@ export declare function promptTemplatePipelineStringToJson(promptTemplatePipelin
 /**
  * TODO: Report here line/column of error
  * TODO: Use spaceTrim more effectively
- * TODO: !!!! Parameter flags - isInput, isOutput, isInternal, isBeforePostprocessing, isBeforeFinal, canonicalName
- * TODO: !!!! Allow to have non-immutable parameters - suffix them with fooPrevious3 -> fooPrevious2 -> fooPrevious1 -> foo
- *            This must work with other technial parameters
+ * TODO: [🧠] Parameter flags - isInput, isOutput, isInternal
  */

package/umd/typings/execution/ExpectError.d.ts

@@ -0,0 +1,10 @@
+/**
+ * This error occurs when some expectation is not met in the execution of the pipeline
+ */
+export declare class ExpectError extends Error {
+    readonly name = "ExpectError";
+    constructor(message: string);
+}
+/**
+ * TODO: [🧠] Should be this exported from the library
+ */

package/umd/typings/execution/PtpExecutor.d.ts

@@ -3,7 +3,7 @@ import type { string_name } from '.././types/typeAliases';
 import type { TaskProgress } from '../types/TaskProgress';
 import type { ExecutionReportJson } from '../types/execution-report/ExecutionReportJson';
 /**
- * Executor is a simple async function that takes input parameters and returns result parameters _(along with all intermediate parameters and input parameters = it extends input object)_.
+ * Executor is a simple async function that takes INPUT  PARAMETERs and returns result parameters _(along with all intermediate parameters and INPUT  PARAMETERs = it extends input object)_.
  * Executor is made by combining execution tools and prompt template pipeline library.
  *
  * It can be done in two ways:

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

@@ -1,7 +1,7 @@
 import { string_name, string_script } from '.././types/typeAliases';
 import { ScriptLanguage } from '../types/ScriptLanguage';
 /**
- * Represents all the tools needed to execute scripts
+ * Represents all the tools needed to EXECUTE SCRIPTs
  *
  * @see https://github.com/webgptorg/promptbook#script-execution-tools
  */

package/umd/typings/execution/createPtpExecutor.d.ts

@@ -1,4 +1,4 @@
-import { PromptTemplatePipeline } from '../classes/PromptTemplatePipeline';
+import type { PromptTemplatePipeline } from '../classes/PromptTemplatePipeline';
 import { ExecutionTools } from './ExecutionTools';
 import { PtpExecutor } from './PtpExecutor';
 export interface CreatePtpExecutorSettings {
@@ -7,7 +7,7 @@ export interface CreatePtpExecutorSettings {
      *
      * @default 3
      */
-    readonly maxNaturalExecutionAttempts: number;
+    readonly maxExecutionAttempts: number;
 }
 /**
  * Options for creating a PTP (Prompt Template Pipeline) executor

package/umd/typings/execution/plugins/natural-execution-tools/openai/OpenAiExecutionTools.d.ts

@@ -22,7 +22,7 @@ export declare class OpenAiExecutionTools implements NaturalExecutionTools {
     gptComplete(prompt: Prompt): Promise<PromptCompletionResult>;
 }
 /**
- * TODO: !!!! Allow to use other models - List all from openai
+
  * TODO: Maybe Create some common util for gptChat and gptComplete
  * TODO: Maybe make custom OpenaiError
  */

package/umd/typings/types/Command.d.ts

@@ -46,7 +46,7 @@ export interface ModelCommand {
 /**
  * Parameter command describes one parameter of the prompt template
  *
- * - It can tell if it is input or output parameter
+ * - It can tell if it is input or OUTPUT PARAMETER
  * - It can have description
  * - In description it can have simple formatting BUT not markdown structure or reference to other parameters
  */
@@ -58,7 +58,7 @@ export interface ParameterCommand {
 }
 /**
  * Postprocess command describes which function to use for postprocessing
- * This will be created as separate execute script block bellow
+ * This will be created as separate EXECUTE SCRIPT block bellow
  */
 export interface PostprocessCommand {
     readonly type: 'POSTPROCESS';

package/umd/typings/types/Parameters.d.ts

@@ -2,9 +2,9 @@
  * Parameters of the prompt template (pipeline)
  *
  * There are three types of parameters:
- * - **Input parameters** are required to execute the prompt template pipeline.
+ * - **INPUT  PARAMETERs** are required to execute the prompt template pipeline.
  * - **Intermediate parameters** are used internally in the prompt template pipeline.
- * - **Output parameters** are not used internally in the prompt template pipeline, but are returned as the result of the prompt template pipeline execution.
+ * - **OUTPUT PARAMETERs** are not used internally in the prompt template pipeline, but are returned as the result of the prompt template pipeline execution.
  *
  * @see https://github.com/webgptorg/promptbook#parameters
  */

package/umd/typings/types/PromptTemplatePipelineJson/PromptTemplateJson.d.ts

@@ -1,4 +1,4 @@
-import { number_integer, number_positive_or_zero, string_javascript, string_markdown, string_name, string_prompt, string_template } from '../.././types/typeAliases';
+import { number_integer, number_positive_or_zero, string_javascript, string_javascript_name, string_markdown, string_name, string_prompt, string_template } from '../.././types/typeAliases';
 import { ExpectFormatCommand } from '../Command';
 import { ExecutionType } from '../ExecutionTypes';
 import { ModelRequirements } from '../ModelRequirements';
@@ -12,19 +12,6 @@ export type PromptTemplateJson = NaturalTemplateJson | SimpleTemplateJson | Scri
  */
 export interface NaturalTemplateJson extends PromptTemplateJsonCommon {
     readonly executionType: 'PROMPT_TEMPLATE';
-    /**
-     * Expect this amount of each unit in the answer
-     *
-     * For example 5 words, 3 sentences, 2 paragraphs, ...
-     */
-    readonly expectAmount?: Partial<Record<Lowercase<ExpectationUnit>, {
-        min?: ExpectationAmount;
-        max?: ExpectationAmount;
-    }>>;
-    /**
-     * Expect this format of the answer
-     */
-    readonly expectFormat?: ExpectFormatCommand['format'];
     /**
      * Requirements for the model
      * - This is required only for executionType PROMPT_TEMPLATE
@@ -97,6 +84,27 @@ interface PromptTemplateJsonCommon {
      * Content of the template with {placeholders} for parameters
      */
     readonly content: (string_prompt | string_javascript | string_markdown) & string_template;
+    /**
+     * List of postprocessing steps that are executed after the prompt template
+     */
+    readonly postprocessing?: Array<string_javascript_name>;
+    /**
+     * Expect this amount of each unit in the answer
+     *
+     * For example 5 words, 3 sentences, 2 paragraphs, ...
+     *
+     * Note: Expectations are performed after all postprocessing steps
+     */
+    readonly expectAmount?: Partial<Record<Lowercase<ExpectationUnit>, {
+        min?: ExpectationAmount;
+        max?: ExpectationAmount;
+    }>>;
+    /**
+     * Expect this format of the answer
+     *
+     * Note: Expectations are performed after all postprocessing steps
+     */
+    readonly expectFormat?: ExpectFormatCommand['format'];
     /**
      * Name of the parameter that is the result of the prompt template
      */

package/umd/typings/types/PromptTemplatePipelineJson/PromptTemplateParameterJson.d.ts

@@ -12,7 +12,7 @@ export interface PromptTemplateParameterJson {
     /**
      * The parameter is input of the pipeline
      *
-     * Note: Output parameter is every parameter including input one
+     * Note: OUTPUT PARAMETER is every parameter including input one
      */
     readonly isInput: boolean;
     /**