@promptbook/javascript 0.112.0-34 → 0.112.0-35

package/esm/src/formats/json/JsonFormatParser.d.ts

@@ -6,14 +6,3 @@ import type { FormatParser } from '../_common/FormatParser';
  * @private still in development [🏢]
  */
 export declare const JsonFormatParser: FormatParser<string, string, TODO_any, TODO_any>;
-/**
- * TODO: [🧠] Maybe proper instance of object
- * TODO: [0] Make string_serialized_json
- * TODO: [1] Make type for JSON Settings and Schema
- * TODO: [🧠] What to use for validating JSONs - JSON Schema, ZoD, typescript types/interfaces,...?
- * TODO: [🍓] In `JsonFormatParser` implement simple `isValid`
- * TODO: [🍓] In `JsonFormatParser` implement partial `canBeValid`
- * TODO: [🍓] In `JsonFormatParser` implement `heal
- * TODO: [🍓] In `JsonFormatParser` implement `subvalueParsers`
- * TODO: [🏢] Allow to expect something inside JSON objects and other formats
- */

package/esm/src/formats/text/TextFormatParser.d.ts

@@ -8,12 +8,3 @@ import type { FormatParser } from '../_common/FormatParser';
  * @public exported from `@promptbook/core`
  */
 export declare const TextFormatParser: FormatParser<string, string, TODO_any, TODO_any>;
-/**
- * TODO: [1] Make type for XML Text and Schema
- * TODO: [🧠][🤠] Here should be all words, characters, lines, paragraphs, pages available as subvalues
- * TODO: [🍓] In `TextFormatParser` implement simple `isValid`
- * TODO: [🍓] In `TextFormatParser` implement partial `canBeValid`
- * TODO: [🍓] In `TextFormatParser` implement `heal
- * TODO: [🍓] In `TextFormatParser` implement `subvalueParsers`
- * TODO: [🏢] Allow to expect something inside each item of list and other formats
- */

package/esm/src/formats/xml/XmlFormatParser.d.ts

@@ -6,14 +6,3 @@ import type { FormatParser } from '../_common/FormatParser';
  * @private still in development [🏢]
  */
 export declare const XmlFormatParser: FormatParser<string, string, TODO_any, TODO_any>;
-/**
- * TODO: [🧠] Maybe proper instance of object
- * TODO: [0] Make string_serialized_xml
- * TODO: [1] Make type for XML Settings and Schema
- * TODO: [🧠] What to use for validating XMLs - XSD,...
- * TODO: [🍓] In `XmlFormatParser` implement simple `isValid`
- * TODO: [🍓] In `XmlFormatParser` implement partial `canBeValid`
- * TODO: [🍓] In `XmlFormatParser` implement `heal
- * TODO: [🍓] In `XmlFormatParser` implement `subvalueParsers`
- * TODO: [🏢] Allow to expect something inside XML and other formats
- */

package/esm/src/formfactors/_common/AbstractFormfactorDefinition.d.ts

@@ -9,6 +9,7 @@ import type { string_SCREAMING_CASE } from '../../utils/normalization/normalizeT
  * implemented by specific form factors.
  *
  * Note: [🚉] This is fully serializable as JSON
+ *
  * @see https://github.com/webgptorg/promptbook/discussions/172
  */
 export type AbstractFormfactorDefinition = {
@@ -44,6 +45,3 @@ export type AbstractFormfactorDefinition = {
      */
     readonly pipelineInterface: PipelineInterface;
 };
-/**
- * TODO: [🧠][🤓] How to pass optional parameters - for example summary in FORMFACTOR Translator
- */

package/esm/src/formfactors/_common/FormfactorDefinition.d.ts

@@ -5,6 +5,7 @@ import { FORMFACTOR_DEFINITIONS } from '../index';
  * to represent how a particular interface handles inputs, outputs, and behaviors.
  *
  * Note: [🚉] This is fully serializable as JSON
+ *
  * @see https://github.com/webgptorg/promptbook/discussions/172
  */
 export type FormfactorDefinition = (typeof FORMFACTOR_DEFINITIONS)[number];

package/esm/src/formfactors/index.d.ts

@@ -165,6 +165,3 @@ export declare const FORMFACTOR_DEFINITIONS: readonly [{
         }];
     };
 }];
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/esm/src/high-level-abstractions/_common/HighLevelAbstraction.d.ts

@@ -14,8 +14,3 @@ export type SyncHighLevelAbstraction = {
      */
     $applyToPipelineJson($pipelineJson: $PipelineJson): $side_effect;
 };
-/**
- * TODO: [♓️] Add order here
- * TODO: [🧠][🍱] Maybe make some common abstraction between `HighLevelAbstraction` and `CommandParser`
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/esm/src/high-level-abstractions/index.d.ts

@@ -48,7 +48,3 @@ export declare const HIGH_LEVEL_ABSTRACTIONS: readonly [{
         readonly formfactorName?: "CHATBOT" | "COMPLETION" | "GENERATOR" | "GENERIC" | "IMAGE_GENERATOR" | "EXPERIMENTAL_MATCHER" | "SHEETS" | "TRANSLATOR" | undefined;
     }>): void;
 }];
-/**
- * TODO: Test that all sync high-level abstractions are before async high-level abstractions
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/esm/src/high-level-abstractions/quick-chatbot/QuickChatbotHla.d.ts

@@ -8,6 +8,3 @@ export declare const QuickChatbotHla: {
     type: "SYNC";
     $applyToPipelineJson($pipelineJson: $PipelineJson): void;
 };
-/**
- * TODO: [🧠][📛] Should this be here?
- */

package/esm/src/llm-providers/_common/register/$llmToolsMetadataRegister.d.ts

@@ -4,10 +4,9 @@ import type { LlmToolsMetadata } from './LlmToolsMetadata';
  * Register for LLM tools metadata.
  *
  * Note: `$` is used to indicate that this interacts with the global scope
+ *
  * @singleton Only one instance of each register is created per build, but there can be more instances across different builds or environments.
+ *
  * @public exported from `@promptbook/core`
  */
 export declare const $llmToolsMetadataRegister: $Register<LlmToolsMetadata>;
-/**
- * TODO: [®] DRY Register logic
- */

package/esm/src/llm-providers/_common/register/$llmToolsRegister.d.ts

@@ -4,10 +4,9 @@ import { $Register } from '../../../utils/misc/$Register';
  * Register for LLM tools.
  *
  * Note: `$` is used to indicate that this interacts with the global scope
+ *
  * @singleton Only one instance of each register is created per build, but there can be more instances across different builds or environments.
+ *
  * @public exported from `@promptbook/core`
  */
 export declare const $llmToolsRegister: $Register<LlmExecutionToolsConstructor>;
-/**
- * TODO: [®] DRY Register logic
- */

package/esm/src/llm-providers/_common/register/$provideEnvFilename.d.ts

@@ -7,4 +7,3 @@ import type { string_filename } from '../../../types/typeAliases';
  * @private within the repository - for CLI utils
  */
 export declare function $provideEnvFilename(): Promise<string_filename | null>;
-/** Note: [🟢] Code for Node environment helper [$provideEnvFilename](src/llm-providers/_common/register/$provideEnvFilename.ts) should never be published into packages that could be imported into browser environment */

package/esm/src/llm-providers/_common/register/$provideLlmToolsConfigurationFromEnv.d.ts

@@ -11,7 +11,7 @@ import type { LlmToolsConfiguration } from './LlmToolsConfiguration';
  *
  * @see Environment variables documentation or .env file for required variables.
  * @returns A promise that resolves to the LLM tools configuration, or null if configuration is incomplete or missing.
+ *
  * @public exported from `@promptbook/node`
  */
 export declare function $provideLlmToolsConfigurationFromEnv(): Promise<LlmToolsConfiguration>;
-/** Note: [🟢] Code for Node environment helper [$provideLlmToolsConfigurationFromEnv](src/llm-providers/_common/register/$provideLlmToolsConfigurationFromEnv.ts) should never be published into packages that could be imported into browser environment */

package/esm/src/llm-providers/_common/register/$provideLlmToolsForTestingAndScriptsAndPlayground.d.ts

@@ -1,6 +1,9 @@
 import '../../../_packages/cli.index';
 import type { LlmExecutionToolsWithTotalUsage } from '../utils/count-total-usage/LlmExecutionToolsWithTotalUsage';
 import type { CreateLlmToolsFromConfigurationOptions } from './createLlmToolsFromConfiguration';
+/**
+ * Options for get Llm tools for testing and scripts and playground.
+ */
 type GetLlmToolsForTestingAndScriptsAndPlaygroundOptions = CreateLlmToolsFromConfigurationOptions & {
     /**
      * Flag indicating whether the cache should be reloaded or reused
@@ -19,9 +22,3 @@ type GetLlmToolsForTestingAndScriptsAndPlaygroundOptions = CreateLlmToolsFromCon
  */
 export declare function $provideLlmToolsForTestingAndScriptsAndPlayground(options?: GetLlmToolsForTestingAndScriptsAndPlaygroundOptions): Promise<LlmExecutionToolsWithTotalUsage>;
 export {};
-/**
- * Note: [⚪] This should never be in any released package
- * TODO: [👷‍♂️] Write a comprehensive manual about the construction of LLM tools
- * TODO: This should be maybe not under `_common` but under `utils-internal` / `utils/internal`
- * TODO: [®] DRY Register logi
- */

package/esm/src/llm-providers/_common/register/$provideLlmToolsForWizardOrCli.d.ts

@@ -4,6 +4,9 @@ import type { string_app_id, string_url } from '../../../types/typeAliases';
 import type { chococake } from '../../../utils/organization/really_any';
 import type { CacheLlmToolsOptions } from '../utils/cache/CacheLlmToolsOptions';
 import type { LlmExecutionToolsWithTotalUsage } from '../utils/count-total-usage/LlmExecutionToolsWithTotalUsage';
+/**
+ * Options for provide Llm tools for wizard or Cli.
+ */
 type ProvideLlmToolsForWizardOrCliOptions = {
     /**
      * If true, user will be always prompted for login
@@ -49,10 +52,3 @@ type ProvideLlmToolsForWizardOrCliOptions = {
  */
 export declare function $provideLlmToolsForWizardOrCli(options?: ProvideLlmToolsForWizardOrCliOptions): Promise<LlmExecutionToolsWithTotalUsage>;
 export {};
-/** Note: [🟢] Code for Node environment helper [$provideLlmToolsForWizardOrCli](src/llm-providers/_common/register/$provideLlmToolsForWizardOrCli.ts) should never be published into packages that could be imported into browser environment */
-/**
- * TODO: [👷‍♂️] Write a comprehensive manual about the construction of LLM tools
- * TODO: [🥃] Allow `ptbk make` without llm tools
- * TODO: This should be maybe not under `_common` but under `utils-internal` / `utils/internal`
- * TODO: [®] DRY Register logic
- */

package/esm/src/llm-providers/_common/register/$provideLlmToolsFromEnv.d.ts

@@ -18,22 +18,7 @@ import type { CreateLlmToolsFromConfigurationOptions } from './createLlmToolsFro
  *
  * @param options Configuration options for the LLM tools
  * @returns A unified interface containing all detected and configured LLM tools
+ *
  * @public exported from `@promptbook/node`
  */
 export declare function $provideLlmToolsFromEnv(options?: CreateLlmToolsFromConfigurationOptions): Promise<MultipleLlmExecutionTools>;
-/** Note: [🟢] Code for Node environment helper [$provideLlmToolsFromEnv](src/llm-providers/_common/register/$provideLlmToolsFromEnv.ts) should never be published into packages that could be imported into browser environment */
-/**
- * TODO: The architecture for LLM tools configuration consists of three key functions:
- * 1. `$provideLlmToolsFromEnv` - High-level function that detects available providers from env vars and returns ready-to-use LLM tools
- * 2. `$provideLlmToolsConfigurationFromEnv` - Middle layer that extracts configuration objects from environment variables
- * 3. `createLlmToolsFromConfiguration` - Low-level function that instantiates LLM tools from explicit configuration
- * This layered approach allows flexibility in how tools are configured:
- * - Use $provideLlmToolsFromEnv for automatic detection and setup in Node.js environments
- * - Use $provideLlmToolsConfigurationFromEnv to extract config objects for modification before instantiation
- * - Use createLlmToolsFromConfiguration for explicit control over tool configurations
- * TODO: [🧠][🍛] Which name is better `$provideLlmToolsFromEnv` or `$provideLlmToolsFromEnvironment`?
- * TODO: [🧠] Is there some meaningfull way how to test this util
- * TODO: [🥃] Allow `ptbk make` without llm tools
- * TODO: This should be maybe not under `_common` but under `utils`
- * TODO: [®] DRY Register logic
- */

package/esm/src/llm-providers/_common/register/$registeredLlmToolsMessage.d.ts

@@ -16,7 +16,3 @@ export declare function $setUsedEnvFilename(filepath: string_filename): $side_ef
  * @private internal function of `createLlmToolsFromConfiguration` and `$provideLlmToolsFromEnv`
  */
 export declare function $registeredLlmToolsMessage(): string_markdown;
-/**
- * TODO: [®] DRY Register logic
- * TODO: [🧠][⚛] Maybe pass env as argument
- */

package/esm/src/llm-providers/_common/register/LlmToolsConfiguration.d.ts

@@ -23,8 +23,3 @@ export type LlmToolsConfiguration = ReadonlyArray<Registered & {
      */
     readonly options: LlmToolsOptions;
 }>;
-/**
- * TODO: [🧠][🌰] `title` is redundant BUT maybe allow each provider pass it's own title for tracking purposes
- * TODO: Maybe instead of `LlmToolsConfiguration[number]` make `LlmToolsConfigurationItem`
- * TODO: [®] DRY Register logic
- */

package/esm/src/llm-providers/_common/register/LlmToolsMetadata.d.ts

@@ -49,9 +49,3 @@ export type LlmToolsMetadata = Registered & {
      */
     createConfigurationFromEnv(env: Record<string_name, string>): LlmToolsConfiguration[number] | null;
 };
-/**
- * TODO: [🕛] Extend this
- * TODO: Add configuration schema and maybe some documentation link
- * TODO: Maybe constrain LlmToolsConfiguration[number] by generic to ensure that `createConfigurationFromEnv` and `getBoilerplateConfiguration` always create same `packageName` and `className`
- * TODO: [®] DRY Register logic
- */

package/esm/src/llm-providers/_common/register/LlmToolsOptions.d.ts

@@ -4,7 +4,6 @@ import type { TODO_object } from '../../../utils/organization/TODO_object';
  *
  * This type is used to pass provider-specific options to LLM execution tools.
  *
- *
  * The Promptbook LLM tools architecture involves several related types:
  * - `LlmToolsMetadata`: Contains static metadata about the tool, such as name, version, and capabilities
  * - `LlmToolsConfiguration`: Runtime configuration from environment variables or settings
@@ -12,6 +11,3 @@ import type { TODO_object } from '../../../utils/organization/TODO_object';
  * - `Registered`: The record of a registered tool in the global registry
  */
 export type LlmToolsOptions = TODO_object;
-/**
- * TODO: [®] DRY Register logic
- */

package/esm/src/llm-providers/_common/register/createLlmToolsFromConfiguration.d.ts

@@ -37,6 +37,7 @@ export type CreateLlmToolsFromConfigurationOptions = {
  * @param configuration Array of LLM tool configurations to instantiate
  * @param options Additional options for configuring the LLM tools
  * @returns A unified interface combining all successfully instantiated LLM tools
+ *
  * @public exported from `@promptbook/core`
  */
 export declare function createLlmToolsFromConfiguration(configuration: LlmToolsConfiguration, options?: CreateLlmToolsFromConfigurationOptions): MultipleLlmExecutionTools;

package/esm/src/llm-providers/_common/utils/assertUniqueModels.d.ts

@@ -7,6 +7,3 @@ import { AvailableModel } from '../../../execution/AvailableModel';
  * @private internal utility of unit tests
  */
 export declare function assertUniqueModels(models: ReadonlyArray<AvailableModel>): void;
-/**
- * Note: [⚪] This should never be in any released package
- */

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

@@ -28,6 +28,3 @@ export type CacheItem = {
      */
     promptResult: PromptResult;
 };
-/**
- * TODO: [🧠] Should be this exported alongsite `cacheLlmTools` through `@promptbook/utils` OR through `@promptbook/types`
- */

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

@@ -8,6 +8,7 @@ import type { CacheLlmToolsOptions } from './CacheLlmToolsOptions';
  *
  * @param llmTools LLM tools to be intercepted with usage counting, it can contain extra methods like `totalUsage`
  * @returns Full proxy of LLM tools with same functionality with added caching
+ *
  * @public exported from `@promptbook/core`
  */
 export declare function cacheLlmTools<TLlmTools extends LlmExecutionTools>(llmTools: TLlmTools, options?: Partial<CacheLlmToolsOptions>): TLlmTools;

package/esm/src/llm-providers/_common/utils/count-total-usage/LlmExecutionToolsWithTotalUsage.d.ts

@@ -16,7 +16,3 @@ export type LlmExecutionToolsWithTotalUsage = LlmExecutionTools & {
      */
     spending(): Observable<Usage>;
 };
-/**
- * TODO: [👷‍♂️] Write a comprehensive manual about the construction of LLM tools
- * Note: [🥫] Not using getter `get totalUsage` but `getTotalUsage` to allow this object to be proxied
- */

package/esm/src/llm-providers/_common/utils/count-total-usage/countUsage.d.ts

@@ -9,6 +9,7 @@ import type { LlmExecutionToolsWithTotalUsage } from './LlmExecutionToolsWithTot
  *
  * @param llmTools - The LLM tools to be intercepted and tracked
  * @returns Full proxy of the tools with added usage tracking capabilities
+ *
  * @public exported from `@promptbook/core`
  */
 export declare function countUsage<TLlmTools extends LlmExecutionTools>(llmTools: TLlmTools): TLlmTools & LlmExecutionToolsWithTotalUsage;

package/esm/src/llm-providers/_common/utils/count-total-usage/limitTotalUsage.d.ts

@@ -27,10 +27,3 @@ type LimitTotalUsageOptions = {
  */
 export declare function limitTotalUsage(llmTools: LlmExecutionTools, options?: Partial<LimitTotalUsageOptions>): LlmExecutionToolsWithTotalUsage;
 export {};
-/**
- * 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: [👷‍♂️] Write a comprehensive manual about the construction of LLM tools
- */

package/esm/src/llm-providers/_common/utils/removeUnsupportedModelRequirements.d.ts

@@ -4,6 +4,7 @@ import type { ModelRequirements } from '../../../types/ModelRequirements';
  *
  * @param errorMessage The error message from OpenAI API
  * @returns The parameter name that is unsupported, or null if not an unsupported parameter error
+ *
  * @private utility of LLM Tools
  */
 export declare function parseUnsupportedParameterError(errorMessage: string): string | null;
@@ -13,13 +14,16 @@ export declare function parseUnsupportedParameterError(errorMessage: string): st
  * @param modelRequirements Original model requirements
  * @param unsupportedParameter The parameter to remove
  * @returns New model requirements without the unsupported parameter
+ *
  * @private utility of LLM Tools
  */
 export declare function removeUnsupportedModelRequirement(modelRequirements: ModelRequirements, unsupportedParameter: string): ModelRequirements;
 /**
  * Checks if an error is an "Unsupported value" error from OpenAI
+ *
  * @param error The error to check
  * @returns true if this is an unsupported parameter error
+ *
  * @private utility of LLM Tools
  */
 export declare function isUnsupportedParameterError(error: Error): boolean;

package/esm/src/llm-providers/_multiple/MultipleLlmExecutionTools.d.ts

@@ -8,6 +8,7 @@ import type { string_markdown, string_markdown_text, string_title } from '../../
  * Multiple LLM Execution Tools is a proxy server that uses multiple execution tools internally and exposes the executor interface externally.
  *
  * Note: Internal utility of `joinLlmExecutionTools` but exposed type
+ *
  * @public exported from `@promptbook/core`
  */
 export declare class MultipleLlmExecutionTools implements LlmExecutionTools {

package/esm/src/llm-providers/_multiple/getSingleLlmExecutionTools.d.ts

@@ -6,7 +6,3 @@ import { MultipleLlmExecutionTools } from './MultipleLlmExecutionTools';
  * @public exported from `@promptbook/core`
  */
 export declare function getSingleLlmExecutionTools(oneOrMoreLlmExecutionTools: undefined | LlmExecutionTools | ReadonlyArray<LlmExecutionTools>): LlmExecutionTools | MultipleLlmExecutionTools;
-/**
- * TODO: [🙆] `getSingleLlmExecutionTools` vs `joinLlmExecutionTools` - explain difference or pick one
- * TODO: [👷‍♂️] Write a comprehensive manual about how to construct and use LLM execution tools in Promptbook
- */

package/esm/src/llm-providers/_multiple/joinLlmExecutionTools.d.ts

@@ -8,20 +8,16 @@ import { MultipleLlmExecutionTools } from './MultipleLlmExecutionTools';
  * `MultipleLlmExecutionTools` object. It provides failover and aggregation logic:
  *
  * 1.  **Failover**: When a model call is made, it tries providers in the order they were provided.
- *     If the first provider doesn't support the requested model or fails, it tries the next one.
+ * If the first provider doesn't support the requested model or fails, it tries the next one.
  * 2.  **Aggregation**: `listModels` returns a combined list of all models available from all providers.
  * 3.  **Empty case**: If no tools are provided, it logs a warning (as Promptbook requires LLMs to function).
  *
+ * Tip: You don't have to use this function directly, just pass an array of LlmExecutionTools to the `ExecutionTools`.
+ *
  * @param title - A descriptive title for this collection of joined tools
  * @param llmExecutionTools - An array of execution tools to be joined
  * @returns A single unified execution tool wrapper
  *
- * Tip: You don't have to use this function directly, just pass an array of LlmExecutionTools to the `ExecutionTools`.
- *
  * @public exported from `@promptbook/core`
  */
 export declare function joinLlmExecutionTools(title: string_title & string_markdown_text, ...llmExecutionTools: ReadonlyArray<LlmExecutionTools>): MultipleLlmExecutionTools;
-/**
- * TODO: [🙆] `getSingleLlmExecutionTools` vs `joinLlmExecutionTools` - explain difference or pick one
- * TODO: [👷‍♂️] Write a comprehensive manual about how to construct and use LLM execution tools in Promptbook
- */

package/esm/src/llm-providers/_multiple/playground/playground.d.ts

@@ -1,3 +1,2 @@
 #!/usr/bin/env ts-node
 export {};
-/** Note: [⚫] Code for playground [_multiple playground](src/llm-providers/_multiple/playground/playground.ts) should never be published in any package */

package/esm/src/llm-providers/agent/Agent.d.ts

@@ -94,6 +94,3 @@ export declare class Agent extends AgentLlmExecutionTools implements LlmExecutio
      */
     callChatModelStream(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void, options?: CallChatModelStreamOptions): Promise<ChatPromptResult>;
 }
-/**
- * TODO: [🧠][😰]Agent is not working with the parameters, should it be?
- */

package/esm/src/llm-providers/agent/AgentLlmExecutionTools.d.ts

@@ -85,7 +85,3 @@ export declare class AgentLlmExecutionTools implements LlmExecutionTools {
      */
     callChatModelStream(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void, options?: CallChatModelStreamOptions): Promise<ChatPromptResult>;
 }
-/**
- * TODO: [🍚] Implement Destroyable pattern to free resources
- * TODO: [🧠] Adding parameter substitution support (here or should be responsibility of the underlying LLM Tools)
- */

package/esm/src/llm-providers/agent/RemoteAgent.d.ts

@@ -58,7 +58,3 @@ export declare class RemoteAgent extends Agent {
     }>) | undefined;
     callChatModelStream(prompt: Prompt, onProgress: (chunk: ChatPromptResult) => void, options?: CallChatModelStreamOptions): Promise<ChatPromptResult>;
 }
-/**
- * TODO: [🧠][😰]Agent is not working with the parameters, should it be?
- * TODO: !!! Agent on remote server
- */

package/esm/src/llm-providers/agent/playground/playground.d.ts

@@ -1,8 +1,2 @@
 #!/usr/bin/env ts-node
 export {};
-/** Note: [⚫] Code for playground [agent playground](src/llm-providers/agent/playground/playground.ts) should never be published in any package */
-/**
- * TODO: [🧠] Add more complex agent scenarios
- * TODO: [🧠] Add parameter substitution demo
- * TODO: [🧠] Add multi-turn conversation demo
- */

package/esm/src/llm-providers/agent/register-configuration.d.ts

@@ -4,8 +4,3 @@
  * @public exported from `@promptbook/core`
  */
 export declare const _AgentMetadata: import("../../_packages/types.index").Registration;
-/**
- * TODO: [🧠] Consider adding a special trust level for AgentLlmExecutionTools
- * TODO: [🎶] Naming "constructor" vs "creator" vs "factory"
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/esm/src/llm-providers/agent/register-constructor.d.ts

@@ -7,7 +7,3 @@ import type { Registration } from '../../utils/misc/$Register';
  * @public exported from `@promptbook/core`
  */
 export declare const _AgentRegistration: Registration;
-/**
- * TODO: [🎶] Naming "constructor" vs "creator" vs "factory"
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/esm/src/llm-providers/anthropic-claude/AnthropicClaudeExecutionTools.d.ts

@@ -9,8 +9,9 @@ import type { AnthropicClaudeExecutionToolsNonProxiedOptions } from './Anthropic
 /**
  * Execution Tools for calling Anthropic Claude API.
  *
- * @public exported from `@promptbook/anthropic-claude`
  * @deprecated use `createAnthropicClaudeExecutionTools` instead
+ *
+ * @public exported from `@promptbook/anthropic-claude`
  */
 export declare class AnthropicClaudeExecutionTools implements LlmExecutionTools {
     protected readonly options: AnthropicClaudeExecutionToolsNonProxiedOptions;
@@ -50,12 +51,3 @@ export declare class AnthropicClaudeExecutionTools implements LlmExecutionTools
      */
     private getDefaultChatModel;
 }
-/**
- * TODO:  [🍆] JSON mode
- * TODO: [🧠] Maybe handle errors via transformAnthropicError (like transformAzureError)
- * TODO: Maybe Create some common util for callChatModel and callCompletionModel
- * TODO: Maybe make custom OpenAiError
- * TODO: [🧠][🈁] Maybe use `isDeterministic` from options
- * TODO: [🧠][🌰] Allow to pass `title` for tracking purposes
- * TODO: [📅] Maybe instead of `RemoteLlmExecutionToolsOptions` use `proxyWithAnonymousRemoteServer` (if implemented)
- */

package/esm/src/llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions.d.ts

@@ -5,6 +5,7 @@ import type { RemoteClientOptions } from '../../remote-server/types/RemoteClient
  * Options for `createAnthropicClaudeExecutionTools` and `AnthropicClaudeExecutionTools`
  *
  * This extends Anthropic's `ClientOptions` with are directly passed to the Anthropic client.
+ *
  * @public exported from `@promptbook/anthropic-claude`
  */
 export type AnthropicClaudeExecutionToolsOptions = AnthropicClaudeExecutionToolsNonProxiedOptions | AnthropicClaudeExecutionToolsProxiedOptions;
@@ -12,6 +13,7 @@ export type AnthropicClaudeExecutionToolsOptions = AnthropicClaudeExecutionTools
  * Options for directly used `AnthropicClaudeExecutionTools`
  *
  * This extends Anthropic's `ClientOptions` with are directly passed to the Anthropic client.
+ *
  * @public exported from `@promptbook/anthropic-claude`
  */
 export type AnthropicClaudeExecutionToolsNonProxiedOptions = CommonToolsOptions & ClientOptions & {
@@ -21,11 +23,9 @@ export type AnthropicClaudeExecutionToolsNonProxiedOptions = CommonToolsOptions
  * Options for proxied `AnthropicClaudeExecutionTools`
  *
  * This extends Anthropic's `ClientOptions` with are directly passed to the Anthropic client.
+ *
  * @public exported from `@promptbook/anthropic-claude`
  */
 export type AnthropicClaudeExecutionToolsProxiedOptions = CommonToolsOptions & ClientOptions & {
     isProxied: true;
 } & Pick<RemoteClientOptions<undefined>, 'remoteServerUrl'>;
-/**
- * TODO: [🧠][🤺] Pass `userId`
- */

package/esm/src/llm-providers/anthropic-claude/anthropic-claude-models.d.ts

@@ -6,6 +6,7 @@ import type { number_usd } from '../../types/typeAliases';
  * Note: Synced with official API docs at 2026-03-22
  *
  * @see https://docs.anthropic.com/en/docs/models-overview
+ *
  * @public exported from `@promptbook/anthropic-claude`
  */
 export declare const ANTHROPIC_CLAUDE_MODELS: ReadonlyArray<AvailableModel & {
@@ -14,11 +15,3 @@ export declare const ANTHROPIC_CLAUDE_MODELS: ReadonlyArray<AvailableModel & {
         readonly output: number_usd;
     };
 }>;
-/**
- * Note: [🤖] Add models of new variant
- * TODO: [🧠][main] !!3 Add embedding models OR Anthropic has only chat+completion models?
- * TODO: [🧠] Some mechanism to propagate unsureness
- * TODO: [🧠][👮‍♀️] Put here more info like description, isVision, trainingDateCutoff, languages, strengths (	Top-level performance, intelligence, fluency, and understanding), contextWindow,...
- * TODO: [🎰] Some mechanism to auto-update available models
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/esm/src/llm-providers/anthropic-claude/computeAnthropicClaudeUsage.d.ts

@@ -11,10 +11,8 @@ import type { Prompt } from '../../types/Prompt';
  * @param rawResponse The raw response from Anthropic Claude API
  * @param duration The duration of the execution
  * @throws {PipelineExecutionError} If the usage is not defined in the response from Anthropic Claude
+ *
  * @private internal utility of `AnthropicClaudeExecutionTools`
  */
 export declare function computeAnthropicClaudeUsage(promptContent: Prompt['content'], // <- Note: Intentionally using [] to access type properties to bring jsdoc from Prompt/PromptResult to consumer
 resultContent: string, rawResponse: PartialDeep<Pick<Anthropic.Messages.Message, 'model' | 'usage'>>, duration?: UncertainNumber): Usage;
-/**
- * TODO: [🤝] DRY Maybe some common abstraction between `computeOpenAiUsage` and `computeAnthropicClaudeUsage`
- */

package/esm/src/llm-providers/anthropic-claude/computeAnthropicClaudeUsage.test.d.ts

@@ -1,4 +1 @@
 export {};
-/**
- * TODO: [🤝] DRY Maybe some common abstraction between `computeOpenAiUsage` and `computeAnthropicClaudeUsage`
- */

package/esm/src/llm-providers/anthropic-claude/createAnthropicClaudeExecutionTools.d.ts

@@ -10,10 +10,3 @@ export declare const createAnthropicClaudeExecutionTools: ((options: AnthropicCl
     packageName: string;
     className: string;
 };
-/**
- * TODO: [🧠][main] !!4 Make anonymous this with all LLM providers
- * TODO: [🧠][🧱][main] !!4 Maybe change all `new AnthropicClaudeExecutionTools` -> `createAnthropicClaudeExecutionTools` in manual
- * TODO: [🧠] Maybe auto-detect usage in browser and determine default value of `isProxied`
- * TODO: [🦺] Is there some way how to put `packageName` and `className` on top and function definition on bottom?
- * TODO: [🎶] Naming "constructor" vs "creator" vs "factory"
- */

package/esm/src/llm-providers/anthropic-claude/playground/playground.d.ts

@@ -1,7 +1,2 @@
 #!/usr/bin/env ts-node
 export {};
-/** Note: [⚫] Code for playground [anthropic-claude playground](src/llm-providers/anthropic-claude/playground/playground.ts) should never be published in any package */
-/**
- * TODO: [main] !!3 Playground with WebGPT / Promptbook.studio anonymous server
- * TODO: [main] !!3 Test here that `systemMessage`, `temperature` and `seed` are working correctly
- */

package/esm/src/llm-providers/anthropic-claude/register-configuration.d.ts

@@ -9,6 +9,3 @@ import type { Registration } from '../../utils/misc/$Register';
  * @public exported from `@promptbook/cli`
  */
 export declare const _AnthropicClaudeMetadataRegistration: Registration;
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/esm/src/llm-providers/anthropic-claude/register-constructor.d.ts

@@ -7,10 +7,5 @@ import type { Registration } from '../../utils/misc/$Register';
  * @public exported from `@promptbook/anthropic-claude`
  * @public exported from `@promptbook/wizard`
  * @public exported from `@promptbook/cli`
- *
  */
 export declare const _AnthropicClaudeRegistration: Registration;
-/**
- * TODO: [🎶] Naming "constructor" vs "creator" vs "factory"
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/esm/src/llm-providers/azure-openai/AzureOpenAiExecutionTools.d.ts

@@ -58,9 +58,3 @@ export declare class AzureOpenAiExecutionTools implements LlmExecutionTools {
      */
     private transformAzureError;
 }
-/**
- * TODO: Maybe Create some common util for callChatModel and callCompletionModel
- * TODO: Maybe make custom AzureOpenAiError
- * TODO: [🧠][🈁] Maybe use `isDeterministic` from options
- * TODO: [🧠][🌰] Allow to pass `title` for tracking purposes
- */

package/esm/src/llm-providers/azure-openai/AzureOpenAiExecutionToolsOptions.d.ts

@@ -6,6 +6,7 @@ import type { string_user_id } from '../../types/typeAliases';
  * Options for `createAzureOpenAiExecutionTools` and `AzureOpenAiExecutionTools`
  *
  * @see https://oai.azure.com/portal/
+ *
  * @public exported from `@promptbook/azure-openai`
  */
 export type AzureOpenAiExecutionToolsOptions = CommonToolsOptions & {

package/esm/src/llm-providers/azure-openai/createAzureOpenAiExecutionTools.d.ts

@@ -9,7 +9,3 @@ export declare const createAzureOpenAiExecutionTools: ((options: AzureOpenAiExec
     packageName: string;
     className: string;
 };
-/**
- * TODO: [🦺] Is there some way how to put `packageName` and `className` on top and function definition on bottom?
- * TODO: [🎶] Naming "constructor" vs "creator" vs "factory"
- */