@promptbook/components 0.100.0-24

package/esm/typings/src/book-2.0/commitments/_misc/AgentSourceParseResult.d.ts

@@ -0,0 +1,18 @@
+import type { ParsedCommitment } from './ParsedCommitment';
+/**
+ * Result of parsing agent source for commitments
+ */
+export interface AgentSourceParseResult {
+    /**
+     * The agent name (first line)
+     */
+    agentName: string | null;
+    /**
+     * All parsed commitments
+     */
+    commitments: ParsedCommitment[];
+    /**
+     * Lines that are not commitments (for system message)
+     */
+    nonCommitmentLines: string[];
+}

package/esm/typings/src/book-2.0/commitments/_misc/ParsedCommitment.d.ts

@@ -0,0 +1,22 @@
+import type { BookCommitment } from '../_base/BookCommitment';
+/**
+ * Parsed commitment line from agent source
+ */
+export interface ParsedCommitment {
+    /**
+     * The commitment type (e.g., 'PERSONA', 'KNOWLEDGE')
+     */
+    type: BookCommitment;
+    /**
+     * The content part of the commitment
+     */
+    content: string;
+    /**
+     * The original line from the agent source
+     */
+    originalLine: string;
+    /**
+     * Line number in the agent source (1-based)
+     */
+    lineNumber: number;
+}

package/esm/typings/src/book-2.0/commitments/_misc/createAgentModelRequirements.d.ts

@@ -0,0 +1,61 @@
+import type { string_book } from '../../agent-source/string_book';
+import type { AgentModelRequirements } from './AgentModelRequirements';
+/**
+ * Creates model requirements for an agent based on its source
+ * Results are cached to improve performance for repeated calls with the same agentSource and modelName
+ *
+ * There are 2 similar functions:
+ * - `parseAgentSource` which is a lightweight parser for agent source, it parses basic information and its purpose is to be quick and synchronous. The commitments there are hardcoded.
+ * - `createAgentModelRequirements` which is an asynchronous function that creates model requirements it applies each commitment one by one and works asynchronously.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function createAgentModelRequirements(agentSource: string_book, modelName?: string): Promise<AgentModelRequirements>;
+/**
+ * Clears the cache for createAgentModelRequirements
+ * Useful when agent sources are updated and cached results should be invalidated
+ *
+ * @private
+ */
+export declare function clearAgentModelRequirementsCache(): void;
+/**
+ * Removes cache entries for a specific agent source (all model variants)
+ * @param agentSource The agent source to remove from cache
+ * @private
+ */
+export declare function invalidateAgentModelRequirementsCache(agentSource: string_book): void;
+/**
+ * Gets the current cache size (for debugging/monitoring)
+ *
+ * @private
+ */
+export declare function getAgentModelRequirementsCacheSize(): number;
+/**
+ * Extracts MCP servers from agent source
+ *
+ * @param agentSource The agent source string that may contain MCP lines
+ * @returns Array of MCP server identifiers
+ *
+ * @private TODO: [🧠] Maybe should be public
+ */
+export declare function extractMcpServers(agentSource: string_book): string[];
+/**
+ * Creates a system message for an agent based on its source
+ * @deprecated Use createAgentModelRequirements instead
+ * @private
+ */
+export declare function createAgentSystemMessage(agentSource: string_book): Promise<string>;
+/**
+ * Extracts the agent name from the first line of the agent source
+ * @deprecated Use parseAgentSource instead
+ * @private
+ */
+export declare function extractAgentName(agentSource: string_book): string;
+/**
+ * Extracts the profile image URL from agent source or returns gravatar fallback
+ * @param agentSource The agent source string that may contain META IMAGE line
+ * @returns Profile image URL (from source or gravatar fallback)
+ * @deprecated Use parseAgentSource instead
+ * @private
+ */
+export declare function extractAgentProfileImage(agentSource: string_book): string;

package/esm/typings/src/book-2.0/commitments/_misc/createAgentModelRequirementsWithCommitments.d.ts

@@ -0,0 +1,35 @@
+import type { string_book } from '../../agent-source/string_book';
+import type { AgentModelRequirements } from './AgentModelRequirements';
+/**
+ * Creates agent model requirements using the new commitment system
+ * This function uses a reduce-like pattern where each commitment applies its changes
+ * to build the final requirements starting from a basic empty model
+ *
+ * @private
+ */
+export declare function createAgentModelRequirementsWithCommitments(agentSource: string_book, modelName?: string): Promise<AgentModelRequirements>;
+/**
+ * Cached version of createAgentModelRequirementsWithCommitments
+ * This maintains the same caching behavior as the original function
+ *
+ * @private
+ */
+export declare function createAgentModelRequirementsWithCommitmentsCached(agentSource: string_book, modelName?: string): Promise<AgentModelRequirements>;
+/**
+ * Clears the cache for createAgentModelRequirementsWithCommitments
+ *
+ * @private
+ */
+export declare function clearAgentModelRequirementsWithCommitmentsCache(): void;
+/**
+ * Removes cache entries for a specific agent source
+ *
+ * @private
+ */
+export declare function invalidateAgentModelRequirementsWithCommitmentsCache(agentSource: string_book): void;
+/**
+ * Gets the current cache size
+ *
+ * @private
+ */
+export declare function getAgentModelRequirementsWithCommitmentsCacheSize(): number;

package/esm/typings/src/book-2.0/commitments/_misc/createCommitmentRegex.d.ts

@@ -0,0 +1,20 @@
+import type { BookCommitment } from '../_base/BookCommitment';
+/**
+ * Generates a regex pattern to match a specific commitment
+ *
+ * Note: It always creates new Regex object
+ * Note: Uses word boundaries to ensure only full words are matched (e.g., "PERSONA" matches but "PERSONALITY" does not)
+ *
+ * @private
+ */
+export declare function createCommitmentRegex(commitment: BookCommitment): RegExp;
+/**
+ * Generates a regex pattern to match a specific commitment type
+ *
+ * Note: It just matches the type part of the commitment
+ * Note: It always creates new Regex object
+ * Note: Uses word boundaries to ensure only full words are matched (e.g., "PERSONA" matches but "PERSONALITY" does not)
+ *
+ * @private
+ */
+export declare function createCommitmentTypeRegex(commitment: BookCommitment): RegExp;

package/esm/typings/src/book-2.0/commitments/_misc/parseAgentSourceWithCommitments.d.ts

@@ -0,0 +1,24 @@
+import type { AgentSourceBasicInformation } from '../../agent-source/parseAgentSource';
+import type { string_book } from '../../agent-source/string_book';
+import type { AgentSourceParseResult } from './AgentSourceParseResult';
+/**
+ * Parses agent source using the new commitment system with multiline support
+ * This function replaces the hardcoded commitment parsing in the original parseAgentSource
+ *
+ * @private
+ */
+export declare function parseAgentSourceWithCommitments(agentSource: string_book): AgentSourceParseResult;
+/**
+ * Extracts basic information from agent source using the new commitment system
+ * This maintains compatibility with the original parseAgentSource interface
+ *
+ * @private
+ */
+export declare function parseAgentSourceBasicInfo(agentSource: string_book): AgentSourceBasicInformation;
+/**
+ * Extracts META LINK commitments from agent source
+ * Returns an array of all META LINK URLs found in the agent source
+ *
+ * @private
+ */
+export declare function extractMetaLinks(agentSource: string_book): string[];

package/esm/typings/src/book-2.0/commitments/_misc/removeCommentsFromSystemMessage.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Removes comment lines (lines starting with #) from a system message
+ * This is used to clean up the final system message before sending it to the AI model
+ * while preserving the original content with comments in metadata
+ *
+ * @param systemMessage The system message that may contain comment lines
+ * @returns The system message with comment lines removed
+ *
+ * @private - TODO: [🧠] Maybe should be public?
+ */
+export declare function removeCommentsFromSystemMessage(systemMessage: string): string;

package/esm/typings/src/book-2.0/commitments/index.d.ts

@@ -0,0 +1,56 @@
+import type { BookCommitment } from './_base/BookCommitment';
+import type { CommitmentDefinition } from './_base/CommitmentDefinition';
+import { ActionCommitmentDefinition } from './ACTION/ACTION';
+import { FormatCommitmentDefinition } from './FORMAT/FORMAT';
+import { KnowledgeCommitmentDefinition } from './KNOWLEDGE/KNOWLEDGE';
+import { MetaImageCommitmentDefinition } from './META_IMAGE/META_IMAGE';
+import { MetaLinkCommitmentDefinition } from './META_LINK/META_LINK';
+import { ModelCommitmentDefinition } from './MODEL/MODEL';
+import { NoteCommitmentDefinition } from './NOTE/NOTE';
+import { PersonaCommitmentDefinition } from './PERSONA/PERSONA';
+import { RuleCommitmentDefinition } from './RULE/RULE';
+import { SampleCommitmentDefinition } from './SAMPLE/SAMPLE';
+import { StyleCommitmentDefinition } from './STYLE/STYLE';
+import { NotYetImplementedCommitmentDefinition } from './_base/NotYetImplementedCommitmentDefinition';
+/**
+ * Registry of all available commitment definitions
+ * This array contains instances of all commitment definitions
+ * This is the single source of truth for all commitments in the system
+ *
+ * @private Use functions to access commitments instead of this array directly
+ */
+export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, MetaImageCommitmentDefinition, MetaLinkCommitmentDefinition, NoteCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"SCENARIO">, NotYetImplementedCommitmentDefinition<"SCENARIOS">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"GOAL">, NotYetImplementedCommitmentDefinition<"GOALS">, 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;
+/**
+ * TODO: !!!! Maybe create through standardized $register
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/book-2.0/utils/profileImageUtils.d.ts

@@ -0,0 +1,39 @@
+import type { string_url_image } from '../../types/typeAliases';
+/**
+ * Extracts profile image URL from agent definition text and returns cleaned system message
+ * @param systemMessage The original system message that may contain META IMAGE line
+ * @returns Object with profileImageUrl (if found) and cleanedSystemMessage (without META IMAGE line)
+ *
+ * @private - TODO: [🧠] Maybe should be public?
+ */
+export declare function extractProfileImageFromSystemMessage(systemMessage: string): {
+    profileImageUrl?: string_url_image;
+    cleanedSystemMessage: string;
+};
+/**
+ * Extracts persona, examples, and profile image from agent definition text
+ * @param systemMessage The original system message that may contain PERSONA, EXAMPLE, and META IMAGE lines
+ * @returns Object with extracted information and cleaned system message
+ *
+ * @private - TODO: [🧠] Maybe should be public?
+ */
+export declare function extractAgentMetadata(systemMessage: string): {
+    persona?: {
+        name: string;
+        description?: string;
+    };
+    examples: string[];
+    profileImageUrl?: string_url_image;
+    cleanedSystemMessage: string;
+};
+/**
+ * Generates a gravatar URL based on agent name for fallback avatar
+ * @param name The agent name to generate avatar for
+ * @returns Gravatar URL
+ *
+ * @private - TODO: [🧠] Maybe should be public?
+ */
+export declare function generateGravatarUrl(name?: string | null): string;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/book-components/BookEditor/BookEditor.d.ts

@@ -0,0 +1,26 @@
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+export interface BookEditorProps {
+    /**
+     * Additional CSS classes to apply to the editor container.
+     */
+    className?: string;
+    /**
+     * CSS className for a font (e.g. from next/font) to style the editor text.
+     * If omitted, defaults to system fonts.
+     */
+    fontClassName?: string;
+    /**
+     * The book which is being edited.
+     */
+    value?: string_book;
+    /**
+     * Callback function to handle changes in the book content.
+     */
+    onChange?: (value: string_book) => void;
+}
+/**
+ * Renders a book editor
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function BookEditor(props: BookEditorProps): import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/cli/cli-commands/_boilerplate.d.ts

@@ -0,0 +1,13 @@
+import type { Command as Program } from 'commander';
+/**
+ * Initializes `boilerplate` command for Promptbook CLI utilities
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
+ *
+ * @private internal function of `promptbookCli`
+ */
+export declare function $initializeBoilerplateCommand(program: Program): void;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ */

package/esm/typings/src/cli/cli-commands/about.d.ts

@@ -0,0 +1,14 @@
+import type { Command as Program } from 'commander';
+/**
+ * Initializes `about` command for Promptbook CLI utilities
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
+ *
+ * @private internal function of `promptbookCli`
+ */
+export declare function $initializeAboutCommand(program: Program): void;
+/**
+ * TODO: [🗽] Unite branding and make single place for it
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ */

package/esm/typings/src/cli/cli-commands/common/handleActionErrors.d.ts

@@ -0,0 +1,11 @@
+import type { Command as Program } from 'commander';
+type actionCallbackFunction = Parameters<Program['action']>[0];
+/**
+ * Wraps action to handle error console logging and exit process with error code
+ *
+ * @param action Action to be wrapped in error handling
+ * @returns Wrapped action
+ * @private internal helper function for CLI commands
+ */
+export declare function handleActionErrors(action: actionCallbackFunction): actionCallbackFunction;
+export {};

package/esm/typings/src/cli/cli-commands/hello.d.ts

@@ -0,0 +1,14 @@
+import type { Command as Program } from 'commander';
+/**
+ * Initializes testing `hello` command for Promptbook CLI utilities
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
+ *
+ * @private internal function of `promptbookCli`
+ */
+export declare function $initializeHelloCommand(program: Program): void;
+/**
+ * TODO: [🧠][🐣] Make here some easter egg with generated hello greeting via LLM models
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ */

package/esm/typings/src/cli/cli-commands/list-models.d.ts

@@ -0,0 +1,13 @@
+import type { Command as Program } from 'commander';
+/**
+ * Initializes `list-models` command for Promptbook CLI utilities
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
+ *
+ * @private internal function of `promptbookCli`
+ */
+export declare function $initializeListModelsCommand(program: Program): void;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ */

package/esm/typings/src/cli/cli-commands/list-scrapers.d.ts

@@ -0,0 +1,13 @@
+import type { Command as Program } from 'commander';
+/**
+ * Initializes `list-scrapers` command for Promptbook CLI utilities
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
+ *
+ * @private internal function of `promptbookCli`
+ */
+export declare function $initializeListScrapersCommand(program: Program): void;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ */

package/esm/typings/src/cli/cli-commands/login.d.ts

@@ -0,0 +1,14 @@
+import type { Command as Program } from 'commander';
+/**
+ * Initializes `login` command for Promptbook CLI utilities
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
+ *
+ * @private internal function of `promptbookCli`
+ */
+export declare function $initializeLoginCommand(program: Program): void;
+/**
+ * TODO: Implement non-interactive login
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ */

package/esm/typings/src/cli/cli-commands/make.d.ts

@@ -0,0 +1,16 @@
+import type { Command as Program } from 'commander';
+/**
+ * Initializes `make` command for Promptbook CLI utilities
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
+ *
+ * @private internal function of `promptbookCli`
+ */
+export declare function $initializeMakeCommand(program: Program): void;
+/**
+ * TODO: [🥃][main] !!3 Allow `ptbk make` without configuring any llm tools
+ * TODO: [0] DRY Javascript and typescript - Maybe make ONLY typescript and for javascript just remove types
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ * TODO: [🖇] What about symlinks? Maybe flag --follow-symlinks
+ */

package/esm/typings/src/cli/cli-commands/prettify.d.ts

@@ -0,0 +1,15 @@
+import type { Command as Program } from 'commander';
+/**
+ * Initializes `prettify` command for Promptbook CLI utilities
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
+ *
+ * @private internal function of `promptbookCli`
+ */
+export declare function $initializePrettifyCommand(program: Program): void;
+/**
+ * TODO: [😶] Unite folder listing
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ * TODO: [🖇] What about symlinks? Maybe flag --follow-symlinks
+ */

package/esm/typings/src/cli/cli-commands/run.d.ts

@@ -0,0 +1,17 @@
+import type { Command as Program } from 'commander';
+/**
+ * Initializes `run` command for Promptbook CLI utilities
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
+ *
+ * @private internal function of `promptbookCli`
+ */
+export declare function $initializeRunCommand(program: Program): void;
+/**
+ * TODO: !!5 Catch and wrap all errors from CLI
+ * TODO: [🧠] Pass `maxExecutionAttempts`, `csvSettings`
+ * TODO: [🥃][main] !!3 Allow `ptbk run` without configuring any llm tools
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ * TODO: [🖇] What about symlinks? Maybe flag --follow-symlinks
+ */

package/esm/typings/src/cli/cli-commands/runInteractiveChatbot.d.ts

@@ -0,0 +1,32 @@
+import type { PipelineExecutor } from '../../execution/PipelineExecutor';
+import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
+/**
+ * Options for running the interactive chatbot
+ */
+type RunInteractiveChatbotOptions = {
+    /**
+     * Prepared pipeline to run
+     */
+    pipeline: PipelineJson;
+    /**
+     * Prepared pipeline executor
+     */
+    pipelineExecutor: PipelineExecutor;
+    /**
+     * Whether to show verbose output
+     */
+    isVerbose: boolean;
+};
+/**
+ * Run the interactive chatbot in CLI
+ *
+ * @returns Never-ending promise or process exit
+ * @private internal function of `promptbookCli` and `initializeRunCommand`
+ */
+export declare function runInteractiveChatbot(options: RunInteractiveChatbotOptions): Promise<void | never>;
+export {};
+/**
+ * TODO: Saving reports from the chatbot conversation
+ * TODO: [⛲️] This is the right place to start implementing INK
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ */

package/esm/typings/src/cli/cli-commands/start-server.d.ts

@@ -0,0 +1,13 @@
+import type { Command as Program } from 'commander';
+/**
+ * Initializes `start-server` command for Promptbook CLI utilities
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
+ *
+ * @private internal function of `promptbookCli`
+ */
+export declare function $initializeStartServerCommand(program: Program): void;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ */

package/esm/typings/src/cli/cli-commands/test-command.d.ts

@@ -0,0 +1,16 @@
+import type { Command as Program } from 'commander';
+/**
+ * Initializes `test` command for Promptbook CLI utilities
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
+ *
+ * @private internal function of `promptbookCli`
+ */
+export declare function $initializeTestCommand(program: Program): void;
+/**
+ * TODO: [😶] Unite folder listing
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ * TODO: [🖇] What about symlinks? Maybe flag --follow-symlinks
+ * Note: This is named "test-command.ts" to avoid name collision with jest unit test files
+ */

package/esm/typings/src/cli/common/$addGlobalOptionsToCommand.d.ts

@@ -0,0 +1,7 @@
+import { Command } from 'commander';
+/**
+ * Note: `$` is used to indicate that this function is not a pure function - it registers an option in the CLI
+ *
+ * @private utility of CLI
+ */
+export declare function $addGlobalOptionsToCommand(command: Command): void;

package/esm/typings/src/cli/common/$provideLlmToolsForCli.d.ts

@@ -0,0 +1,28 @@
+import type { CacheLlmToolsOptions } from '../../llm-providers/_common/utils/cache/CacheLlmToolsOptions';
+import type { LlmExecutionToolsWithTotalUsage } from '../../llm-providers/_common/utils/count-total-usage/LlmExecutionToolsWithTotalUsage';
+import type { string_promptbook_server_url } from '../../types/typeAliases';
+type ProvideLlmToolsForCliOptions = Pick<CacheLlmToolsOptions, 'isCacheReloaded'> & {
+    /**
+     * If true, user will be always prompted for login
+     *
+     * Note: This is used in `ptbk login` command
+     */
+    isLoginloaded?: true;
+    /**
+     * CLI options
+     */
+    cliOptions: {
+        verbose: boolean;
+        interactive: boolean;
+        provider: 'BYOK' | 'BRING_YOUR_OWN_KEYS' | 'REMOTE_SERVER' | 'RS' | string;
+        remoteServerUrl: string_promptbook_server_url;
+    };
+};
+/**
+ * @private utility of CLI
+ */
+export declare function $provideLlmToolsForCli(options: ProvideLlmToolsForCliOptions): Promise<{
+    strategy: 'BRING_YOUR_OWN_KEYS' | 'REMOTE_SERVER';
+    llm: LlmExecutionToolsWithTotalUsage;
+}>;
+export {};

package/esm/typings/src/cli/main.d.ts

@@ -0,0 +1,16 @@
+import { promptbookCli } from './promptbookCli';
+/**
+ * Note: [🔺] Purpose of this file is to export CLI for production environment
+ */
+/**
+ * Hidden utilities which should not be used by external consumers.
+ *
+ * @public exported from `@promptbook/cli`
+ */
+export declare const _CLI: {
+    _initialize_promptbookCli: typeof promptbookCli;
+};
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ */

package/esm/typings/src/cli/promptbookCli.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Runs CLI utilities of Promptbook package
+ *
+ * @private within the `@promptbook/cli`
+ */
+export declare function promptbookCli(): Promise<void>;
+/**
+ * TODO: [🧠] Maybe `run` command the default, instead of `ptbk run ./foo.book` -> `ptbk ./foo.book`
+ * TODO: [🥠] Do not export, its just for CLI script
+ * TODO: [🕌] When more functionalities, rename
+ * Note: 11:11
+ * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ */

package/esm/typings/src/cli/test/ptbk.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env ts-node
+/**
+ * Note: [🔺] Purpose of this file is to test and use the current CLI in development environment
+ */
+import '../../_packages/cli.index';

package/esm/typings/src/cli/test/ptbk.test.d.ts

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

package/esm/typings/src/collection/PipelineCollection.d.ts

@@ -0,0 +1,25 @@
+import type { Promisable } from 'type-fest';
+import type { PipelineJson } from '../pipeline/PipelineJson/PipelineJson';
+import type { Prompt } from '../types/Prompt';
+import type { string_pipeline_url } from '../types/typeAliases';
+/**
+ * Collection that groups together pipelines, knowledge, personas, tools and actions
+ */
+export type PipelineCollection = {
+    /**
+     * Gets all pipelines in the collection
+     */
+    listPipelines(): Promisable<ReadonlyArray<string_pipeline_url>>;
+    /**
+     * Gets pipeline by its URL
+     *
+     * Note: This is not a direct fetching from the URL, but a lookup in the collection
+     */
+    getPipelineByUrl(url: string_pipeline_url): Promisable<PipelineJson>;
+    /**
+     * Checks whether given prompt was defined in any pipeline in the collection
+     *
+     * @deprecated Make better mechanism for skimming the remote server
+     */
+    isResponsibleForPrompt(prompt: Prompt): Promisable<boolean>;
+};