@promptbook/fake-llm 0.105.0-21 → 0.105.0-26

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

@@ -0,0 +1,48 @@
+import { string_javascript_name } from '../../_packages/types.index';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * USE EMAIL commitment definition
+ *
+ * The `USE EMAIL` commitment enables the agent to send emails.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * USE EMAIL
+ * USE EMAIL Write always formal and polite emails, always greet.
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class UseEmailCommitmentDefinition extends BaseCommitmentDefinition<'USE EMAIL'> {
+    constructor();
+    get requiresContent(): boolean;
+    /**
+     * Short one-line description of USE EMAIL.
+     */
+    get description(): string;
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string;
+    /**
+     * Markdown documentation for USE EMAIL commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+    /**
+     * Gets human-readable titles for tool functions provided by this commitment.
+     */
+    getToolTitles(): Record<string_javascript_name, string>;
+    /**
+     * Gets the `send_email` tool function implementation.
+     *
+     * Note: [??] This function has implementation both for browser and node, this is the proxied one for browser.
+     */
+    getToolFunctions(): Record<string_javascript_name, ToolFunction>;
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/commitments/USE_EMAIL/resolveSendEmailToolForNode.d.ts

@@ -0,0 +1,11 @@
+import type { ToolFunction } from '../../_packages/types.index';
+/**
+ * Resolves the server-side implementation of the send_email tool for Node.js environments.
+ *
+ * This uses a lazy require so the core package can still load even if the Agents Server
+ * module is unavailable. When the server tool cannot be resolved, a fallback implementation
+ * throws a helpful error message.
+ *
+ * @private internal utility for USE EMAIL commitment
+ */
+export declare function resolveSendEmailToolForNode(): ToolFunction;

package/esm/typings/src/commitments/USE_EMAIL/sendEmailViaBrowser.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Client-side safe wrapper for sending emails.
+ *
+ * This function proxies requests to the Agents Server API endpoint for email queuing,
+ * making it safe to use in browser environments.
+ *
+ * @param args Email payload containing recipients, subject, and body
+ * @param agentsServerUrl The base URL of the agents server (defaults to current origin)
+ * @returns Result string from the server-side send_email tool
+ *
+ * @private internal utility for USE EMAIL commitment
+ */
+export declare function sendEmailViaBrowser(args: {
+    to: string[];
+    cc?: string[];
+    subject: string;
+    body: string;
+}, agentsServerUrl?: string): Promise<string>;

package/esm/typings/src/commitments/_common/commitmentToolFunctions.d.ts

@@ -0,0 +1,26 @@
+import { ToolFunction } from '../../_packages/types.index';
+import { string_javascript_name } from '../../types/typeAliases';
+/**
+ * Map of tool functions keyed by function name.
+ *
+ * @private internal helper for commitment tool registry
+ */
+export type CommitmentToolFunctions = Record<string_javascript_name, ToolFunction>;
+/**
+ * Collects tool functions from all commitment definitions.
+ *
+ * @returns Map of tool function implementations.
+ * @private internal helper for commitment tool registry
+ */
+export declare function collectCommitmentToolFunctions(): CommitmentToolFunctions;
+/**
+ * Creates a proxy that resolves tool functions on demand.
+ *
+ * @param getFunctions - Provider of current tool functions.
+ * @returns Proxy exposing tool functions as properties.
+ * @private internal helper for commitment tool registry
+ */
+export declare function createToolFunctionsProxy(getFunctions: () => CommitmentToolFunctions): CommitmentToolFunctions;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/commitments/_common/getAllCommitmentDefinitions.d.ts

@@ -0,0 +1,8 @@
+import type { CommitmentDefinition } from '../_base/CommitmentDefinition';
+/**
+ * Gets all available commitment definitions
+ * @returns Array of all commitment definitions
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function getAllCommitmentDefinitions(): ReadonlyArray<CommitmentDefinition>;

package/esm/typings/src/commitments/_common/getAllCommitmentTypes.d.ts

@@ -0,0 +1,8 @@
+import type { BookCommitment } from '../_base/BookCommitment';
+/**
+ * Gets all available commitment types
+ * @returns Array of all commitment types
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function getAllCommitmentTypes(): ReadonlyArray<BookCommitment>;

package/esm/typings/src/commitments/_common/getAllCommitmentsToolFunctionsForBrowser.d.ts

@@ -0,0 +1,9 @@
+import type { CommitmentToolFunctions } from './commitmentToolFunctions';
+/**
+ * Gets all function implementations provided by all commitments
+ *
+ * Note: This function is intended for browser use, there is also equivalent `getAllCommitmentsToolFunctionsForNode` for server use
+ *
+ * @public exported from `@promptbook/browser`
+ */
+export declare function getAllCommitmentsToolFunctionsForBrowser(): CommitmentToolFunctions;

package/esm/typings/src/commitments/_common/getAllCommitmentsToolFunctionsForNode.d.ts

@@ -0,0 +1,13 @@
+import { type CommitmentToolFunctions } from './commitmentToolFunctions';
+/**
+ * Gets all function implementations provided by all commitments
+ *
+ * Note: This function is intended for server use, there is also equivalent `getAllCommitmentsToolFunctionsForBrowser` for browser use
+ *
+ * @public exported from `@promptbook/node`
+ */
+export declare function getAllCommitmentsToolFunctionsForNode(): CommitmentToolFunctions;
+/**
+ * Note: [??] Code in this file should never be never released in packages that could be imported into browser environment
+ * TODO: [??] Unite `xxxForServer` and `xxxForNode` naming
+ */

package/esm/typings/src/commitments/_common/getAllCommitmentsToolTitles.d.ts

@@ -0,0 +1,7 @@
+import { string_javascript_name } from '../../types/typeAliases';
+/**
+ * Gets all tool titles provided by all commitments
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function getAllCommitmentsToolTitles(): Record<string_javascript_name, string>;

package/esm/typings/src/commitments/_common/getCommitmentDefinition.d.ts

@@ -0,0 +1,10 @@
+import type { BookCommitment } from '../_base/BookCommitment';
+import type { CommitmentDefinition } from '../_base/CommitmentDefinition';
+/**
+ * Gets a commitment definition by its type
+ * @param type The commitment type to look up
+ * @returns The commitment definition or null if not found
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function getCommitmentDefinition(type: BookCommitment): CommitmentDefinition | null;

package/esm/typings/src/commitments/_common/getGroupedCommitmentDefinitions.d.ts

@@ -0,0 +1,17 @@
+import { CommitmentDefinition } from '../_base/CommitmentDefinition';
+/**
+ * Grouped commitment definition
+ */
+type GroupedCommitmentDefinition = {
+    primary: CommitmentDefinition;
+    aliases: string[];
+};
+/**
+ * Gets all commitment definitions grouped by their aliases
+ *
+ * @returns Array of grouped commitment definitions
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function getGroupedCommitmentDefinitions(): ReadonlyArray<GroupedCommitmentDefinition>;
+export {};

package/esm/typings/src/commitments/_common/isCommitmentSupported.d.ts

@@ -0,0 +1,9 @@
+import type { BookCommitment } from '../_base/BookCommitment';
+/**
+ * Checks if a commitment type is supported
+ * @param type The commitment type to check
+ * @returns True if the commitment type is supported
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function isCommitmentSupported(type: BookCommitment): boolean;

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

@@ -1,7 +1,3 @@
-import type { BookCommitment } from './_base/BookCommitment';
-import type { CommitmentDefinition } from './_base/CommitmentDefinition';
-import { ToolFunction } from '../scripting/javascript/JavascriptExecutionToolsOptions';
-import { string_javascript_name } from '../types/typeAliases';
 import { ActionCommitmentDefinition } from './ACTION/ACTION';
 import { ClosedCommitmentDefinition } from './CLOSED/CLOSED';
 import { ComponentCommitmentDefinition } from './COMPONENT/COMPONENT';
@@ -32,8 +28,10 @@ import { SampleCommitmentDefinition } from './SAMPLE/SAMPLE';
 import { ScenarioCommitmentDefinition } from './SCENARIO/SCENARIO';
 import { StyleCommitmentDefinition } from './STYLE/STYLE';
 import { TeamCommitmentDefinition } from './TEAM/TEAM';
+import { TemplateCommitmentDefinition } from './TEMPLATE/TEMPLATE';
 import { UseCommitmentDefinition } from './USE/USE';
 import { UseBrowserCommitmentDefinition } from './USE_BROWSER/USE_BROWSER';
+import { UseEmailCommitmentDefinition } from './USE_EMAIL/USE_EMAIL';
 import { UseImageGeneratorCommitmentDefinition } from './USE_IMAGE_GENERATOR/USE_IMAGE_GENERATOR';
 import { UseMcpCommitmentDefinition } from './USE_MCP/USE_MCP';
 import { UseSearchEngineCommitmentDefinition } from './USE_SEARCH_ENGINE/USE_SEARCH_ENGINE';
@@ -46,66 +44,7 @@ import { NotYetImplementedCommitmentDefinition } from './_base/NotYetImplemented
  *
  * @private Use functions to access commitments instead of this array directly
  */
-export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, LanguageCommitmentDefinition, LanguageCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, TeamCommitmentDefinition, UseBrowserCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseTimeCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseMcpCommitmentDefinition, UseCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
-/**
- * Gets a commitment definition by its type
- * @param type The commitment type to look up
- * @returns The commitment definition or null if not found
- *
- * @public exported from `@promptbook/core`
- */
-export declare function getCommitmentDefinition(type: BookCommitment): CommitmentDefinition | null;
-/**
- * Gets all available commitment definitions
- * @returns Array of all commitment definitions
- *
- * @public exported from `@promptbook/core`
- */
-export declare function getAllCommitmentDefinitions(): ReadonlyArray<CommitmentDefinition>;
-/**
- * Gets all available commitment types
- * @returns Array of all commitment types
- *
- * @public exported from `@promptbook/core`
- */
-export declare function getAllCommitmentTypes(): ReadonlyArray<BookCommitment>;
-/**
- * Checks if a commitment type is supported
- * @param type The commitment type to check
- * @returns True if the commitment type is supported
- *
- * @public exported from `@promptbook/core`
- */
-export declare function isCommitmentSupported(type: BookCommitment): boolean;
-/**
- * Grouped commitment definition
- *
- * @public exported from `@promptbook/core`
- */
-export type GroupedCommitmentDefinition = {
-    primary: CommitmentDefinition;
-    aliases: string[];
-};
-/**
- * Gets all commitment definitions grouped by their aliases
- *
- * @returns Array of grouped commitment definitions
- *
- * @public exported from `@promptbook/core`
- */
-export declare function getGroupedCommitmentDefinitions(): ReadonlyArray<GroupedCommitmentDefinition>;
-/**
- * Gets all function implementations provided by all commitments
- *
- * @public exported from `@promptbook/core`
- */
-export declare function getAllCommitmentsToolFunctions(): Record<string_javascript_name, ToolFunction>;
-/**
- * Gets all tool titles provided by all commitments
- *
- * @public exported from `@promptbook/core`
- */
-export declare function getAllCommitmentsToolTitles(): Record<string_javascript_name, string>;
+export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, LanguageCommitmentDefinition, LanguageCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, TemplateCommitmentDefinition, TemplateCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, TeamCommitmentDefinition, UseBrowserCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseTimeCommitmentDefinition, UseEmailCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseMcpCommitmentDefinition, UseCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
 /**
  * TODO: [🧠] Maybe create through standardized $register
  * Note: [💞] Ignore a discrepancy between file name and entity name

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

@@ -116,6 +116,10 @@ export declare const LIMITS: {
  * @public exported from `@promptbook/core`
  */
 export declare const TIME_INTERVALS: {
+    /**
+         * Hundred milliseconds
+         */
+    readonly HUNDRED_MILLISECONDS: 100;
     /**
      * One second in milliseconds
      */

package/esm/typings/src/executables/$provideExecutablesForNode.d.ts

@@ -9,4 +9,5 @@ export declare function $provideExecutablesForNode(options?: PrepareAndScrapeOpt
 /**
  * TODO: [🧠] Allow to override the executables without need to call `locatePandoc` / `locateLibreoffice` in case of provided
  * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ * TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming
  */

package/esm/typings/src/execution/utils/$provideExecutionToolsForNode.d.ts

@@ -10,4 +10,5 @@ import type { ExecutionTools } from '../ExecutionTools';
 export declare function $provideExecutionToolsForNode(options?: PrepareAndScrapeOptions): Promise<ExecutionTools>;
 /**
  * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ * TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming
  */

package/esm/typings/src/pipeline/prompt-notation.d.ts

@@ -1,4 +1,28 @@
 import type { string_prompt } from '../types/typeAliases';
+import type { really_unknown } from '../utils/organization/really_unknown';
+/**
+ * Prompt string wrapper to retain prompt context across interpolations.
+ *
+ * @public exported from `@promptbook/utils`
+ */
+export declare class PromptString extends String {
+    /**
+     * @param value Prompt content.
+     */
+    constructor(value: string_prompt);
+    /**
+     * Returns the prompt as a primitive string.
+     */
+    toString(): string_prompt;
+    /**
+     * Returns the prompt as a primitive string for implicit coercion.
+     */
+    valueOf(): string_prompt;
+    /**
+     * Ensures template literal coercion returns the raw string.
+     */
+    [Symbol.toPrimitive](): string_prompt;
+}
 /**
  * Tag function for notating a prompt as template literal
  *
@@ -9,10 +33,10 @@ import type { string_prompt } from '../types/typeAliases';
  *
  * @param strings
  * @param values
- * @returns the prompt string
+ * @returns prompt content wrapped as a PromptString
  * @public exported from `@promptbook/utils`
  */
-export declare function prompt(strings: TemplateStringsArray, ...values: Array<string>): string_prompt;
+export declare function prompt(strings: TemplateStringsArray, ...values: Array<really_unknown>): PromptString;
 /**
  * Tag function for notating a prompt as template literal
  *
@@ -26,6 +50,7 @@ export declare function prompt(strings: TemplateStringsArray, ...values: Array<s
  */
 export declare const promptTemplate: typeof prompt;
 /**
+ * TODO: Maybe split into multiple files
  * TODO: [🧠][🈴] Where is the best location for this file
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/pipeline/prompt-notation.test.d.ts

@@ -1,4 +1,4 @@
 export {};
 /**
- * TODO: [🧠][🈴] Where is the best location for this file
+ * TODO: [??][??] Where is the best location for this file
  */

package/esm/typings/src/scrapers/_common/register/$provideFilesystemForNode.d.ts

@@ -9,4 +9,5 @@ import type { PrepareAndScrapeOptions } from '../../../prepare/PrepareAndScrapeO
 export declare function $provideFilesystemForNode(options?: Pick<PrepareAndScrapeOptions, 'isVerbose'>): FilesystemTools;
 /**
  * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ * TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming
  */

package/esm/typings/src/scrapers/_common/register/$provideScrapersForNode.d.ts

@@ -10,4 +10,5 @@ import type { Scraper } from '../Scraper';
 export declare function $provideScrapersForNode(tools: Pick<ExecutionTools, 'fs' | 'llm' | 'executables'>, options?: PrepareAndScrapeOptions): Promise<ReadonlyArray<Scraper>>;
 /**
  * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ * TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming
  */

package/esm/typings/src/scrapers/_common/register/$provideScriptingForNode.d.ts

@@ -8,4 +8,5 @@ import type { PrepareAndScrapeOptions } from '../../../prepare/PrepareAndScrapeO
 export declare function $provideScriptingForNode(options?: PrepareAndScrapeOptions): Promise<ReadonlyArray<ScriptExecutionTools>>;
 /**
  * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ * TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming
  */

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

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.105.0-20`).
+ * It follows semantic versioning (e.g., `0.105.0-25`).
  *
  * @generated
  */

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

@@ -2,10 +2,7 @@ import type { ExecutionTools } from '../execution/ExecutionTools';
 import type { PipelineExecutorResult } from '../execution/PipelineExecutorResult';
 import type { PipelineJson } from '../pipeline/PipelineJson/PipelineJson';
 import type { PipelineString } from '../pipeline/PipelineString';
-import type { InputParameters } from '../types/typeAliases';
-import type { string_filename } from '../types/typeAliases';
-import type { string_parameter_value } from '../types/typeAliases';
-import type { string_pipeline_url } from '../types/typeAliases';
+import type { InputParameters, string_filename, string_parameter_value, string_pipeline_url } from '../types/typeAliases';
 /**
  * Options for wizard methods
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/fake-llm",
-    "version": "0.105.0-21",
+    "version": "0.105.0-26",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,
@@ -96,13 +96,11 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/fake-llm.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.105.0-21"
+        "@promptbook/core": "0.105.0-26"
     },
     "dependencies": {
         "crypto": "1.0.1",
-        "crypto-js": "4.2.0",
         "lorem-ipsum": "2.0.8",
-        "moment": "2.30.1",
         "spacetrim": "0.11.60",
         "waitasecond": "1.11.160"
     }