@promptbook/cli 0.112.0-32 → 0.112.0-35

package/esm/scripts/find-fresh-emoji-tags/find-fresh-emoji-tags.d.ts

@@ -4,6 +4,3 @@
  * @public exported from `@promptbook/cli`
  */
 export declare function findFreshEmojiTag(): Promise<void>;
-/**
- * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
- */

package/esm/scripts/find-fresh-emoji-tags/utils/$shuffleItems.d.ts

@@ -10,6 +10,3 @@
  * @throws No exceptions are thrown by this function.
  */
 export declare function $shuffleItems<TItem>(...items: ReadonlyArray<TItem>): ReadonlyArray<TItem>;
-/**
- * TODO: [🧠][👵] Figure out something between rotateItems and shuffleItems which is more generic and receives a ruleset how to reordeto the array in some general way
- */

package/esm/scripts/find-fresh-emoji-tags/utils/emojis.d.ts

@@ -14,8 +14,3 @@ export declare const EMOJIS: Set<string_char_emoji>;
  * Emojis which are single pictograms like "🍆", "🍡", "🍤"...
  */
 export declare const EMOJIS_OF_SINGLE_PICTOGRAM: Set<string_char_emoji>;
-/**
- * TODO: [💴] DRY - just one version of emojis.ts
- * TODO: Mirror from Collboard or some common package
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/esm/scripts/find-refactor-candidates/analyzeSourceFileForRefactorCandidate.d.ts

@@ -0,0 +1,26 @@
+import type { RefactorCandidate } from './RefactorCandidate';
+/**
+ * Input required to analyze one source file for refactor candidacy.
+ *
+ * @private type of findRefactorCandidates
+ */
+export type AnalyzeSourceFileForRefactorCandidateOptions = {
+    /**
+     * Absolute path to the source file.
+     */
+    readonly filePath: string;
+    /**
+     * Repository root used for relative path generation.
+     */
+    readonly rootDir: string;
+    /**
+     * Normalized absolute paths exempt from line-count checks.
+     */
+    readonly lineCountExemptPaths: ReadonlySet<string>;
+};
+/**
+ * Resolves whether a source file should produce a refactor candidate entry.
+ *
+ * @private function of findRefactorCandidates
+ */
+export declare function analyzeSourceFileForRefactorCandidate(options: AnalyzeSourceFileForRefactorCandidateOptions): Promise<RefactorCandidate | null>;

package/esm/scripts/find-refactor-candidates/buildPromptContent.d.ts

@@ -0,0 +1,7 @@
+import type { RefactorCandidate } from './RefactorCandidate';
+/**
+ * Builds prompt content for a refactor candidate.
+ *
+ * @private function of findRefactorCandidates
+ */
+export declare function buildPromptContent(candidate: RefactorCandidate, emojiTag: string): string;

package/esm/scripts/find-refactor-candidates/find-refactor-candidates.d.ts

@@ -4,6 +4,3 @@
  * @public exported from `@promptbook/cli`
  */
 export declare function findRefactorCandidates(): Promise<void>;
-/**
- * Note: [?] Code in this file should never be published in any package
- */

package/esm/scripts/find-refactor-candidates/findRefactorCandidatesInProject.d.ts

@@ -0,0 +1,7 @@
+import type { RefactorCandidate } from './RefactorCandidate';
+/**
+ * Scans the repository and returns all files that qualify as refactor candidates.
+ *
+ * @private function of findRefactorCandidates
+ */
+export declare function findRefactorCandidatesInProject(rootDir: string): Promise<ReadonlyArray<RefactorCandidate>>;

package/esm/scripts/find-refactor-candidates/loadExistingPromptTargets.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Collects all repo-relative target paths already referenced in prompts.
+ *
+ * @private function of findRefactorCandidates
+ */
+export declare function loadExistingPromptTargets(promptsDir: string): Promise<Set<string>>;

package/esm/scripts/find-refactor-candidates/normalizeRefactorCandidatePath.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Normalizes a repo-relative path to use forward slashes.
+ *
+ * @private function of findRefactorCandidates
+ */
+export declare function normalizeRefactorCandidatePath(pathValue: string): string;

package/esm/scripts/find-refactor-candidates/writeRefactorCandidatePrompts.d.ts

@@ -0,0 +1,26 @@
+import type { RefactorCandidate } from './RefactorCandidate';
+/**
+ * Input required to create prompt files for refactor candidates.
+ *
+ * @private type of findRefactorCandidates
+ */
+export type WriteRefactorCandidatePromptsOptions = {
+    /**
+     * Candidates that still need prompt files.
+     */
+    readonly candidates: ReadonlyArray<RefactorCandidate>;
+    /**
+     * Repository root used for fresh emoji scanning.
+     */
+    readonly rootDir: string;
+    /**
+     * Prompts directory where files should be written.
+     */
+    readonly promptsDir: string;
+};
+/**
+ * Creates prompt files for each refactor candidate and returns written filenames.
+ *
+ * @private function of findRefactorCandidates
+ */
+export declare function writeRefactorCandidatePrompts(options: WriteRefactorCandidatePromptsOptions): Promise<ReadonlyArray<string>>;

package/esm/scripts/run-codex-prompts/common/appendCoderContext.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Appends optional coding context to a runner prompt.
+ */
+export declare function appendCoderContext(prompt: string, context: string | undefined): string;

package/esm/scripts/run-codex-prompts/common/formatUsagePrice.d.ts

@@ -2,9 +2,9 @@ import type { Usage } from '../../../src/execution/Usage';
 /**
  * Formats usage price for display in checkbox.
  * Examples:
- *   - "$0.12" (certain)
- *   - "~$3.05" (uncertain)
- *   - "$0.00" (zero cost)
- *   - "<$0.01" (tiny non-zero cost)
+ * - "$0.12" (certain)
+ * - "~$3.05" (uncertain)
+ * - "$0.00" (zero cost)
+ * - "<$0.01" (tiny non-zero cost)
  */
 export declare function formatUsagePrice(usage: Usage): string;

package/esm/scripts/run-codex-prompts/common/resolveCoderContext.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Resolves optional coding context provided inline or via a file path.
+ */
+export declare function resolveCoderContext(contextReference: string | undefined, currentWorkingDirectory: string): Promise<string | undefined>;

package/esm/scripts/run-codex-prompts/git/runGitCommand.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Minimal command options used by `runGitCommand`.
+ */
+type RunGitCommandOptions = {
+    readonly command: string;
+    readonly cwd?: string;
+    readonly env?: Record<string, string>;
+    readonly isVerbose?: boolean;
+};
+/**
+ * Runs one Git command and retries when the repository index is still temporarily locked.
+ */
+export declare function runGitCommand(options: RunGitCommandOptions): Promise<string>;
+export {};

package/esm/scripts/run-codex-prompts/main/runCodexPrompts.d.ts

@@ -3,6 +3,7 @@ import type { RunOptions } from '../cli/RunOptions';
  * Main entry point for running prompts with the selected agent.
  *
  * @param providedOptions - Optional pre-parsed options. If not provided, will parse from process.argv
+ *
  * @public exported from `@promptbook/cli`
  */
 export declare function runCodexPrompts(providedOptions?: RunOptions): Promise<void>;

package/esm/scripts/run-codex-prompts/prompts/writePromptErrorLog.d.ts

@@ -1,5 +1,8 @@
 import type { PromptFile } from './types/PromptFile';
 import type { PromptSection } from './types/PromptSection';
+/**
+ * Options for write prompt error log.
+ */
 type WritePromptErrorLogOptions = {
     file: PromptFile;
     section: PromptSection;

package/esm/scripts/run-codex-prompts/runners/gemini/gemini-pricing.d.ts

@@ -2,6 +2,7 @@
  * The pricing for Gemini models per 1 million tokens in USD.
  *
  * Note: This is an estimation.
+ *
  * @see https://ai.google.dev/pricing
  */
 export declare const GEMINI_PRICING: {

package/esm/scripts/utils/autocommit/isWorkingTreeClean.d.ts

@@ -1,4 +1,4 @@
-export declare function isWorkingTreeClean(path: string): Promise<boolean>;
 /**
- * Note: [🟡] Code in this file should never be published outside of `@promptbook/cli`
+ * Checks working tree clean.
  */
+export declare function isWorkingTreeClean(path: string): Promise<boolean>;

package/esm/scripts/utils/prompts/getPromptNumbering.d.ts

@@ -48,6 +48,3 @@ export declare function formatPromptNumber(value: number): string;
  * Builds a prompt filename using the date prefix, number, and slug.
  */
 export declare function buildPromptFilename(datePrefix: string, number: number, slug: string): string;
-/**
- * Note: [?] Code in this file should never be published in any package
- */

package/esm/scripts/utils/prompts/promptEmojiTags.d.ts

@@ -53,6 +53,3 @@ export declare function formatPromptEmojiTag(emoji: string_char_emoji, tagPrefix
  * Selects fresh emoji tags that are not present anywhere in the repository.
  */
 export declare function getFreshPromptEmojiTags(options: PromptEmojiTagOptions): Promise<PromptEmojiTagSelection>;
-/**
- * Note: [?] Code in this file should never be published in any package
- */

package/esm/scripts/verify-prompts/verify-prompts.d.ts

@@ -2,6 +2,7 @@
  * Starts the verification loop and exits when no `[ ]` prompts remain.
  *
  * @param reverse - Process files in reverse order
+ *
  * @public exported from `@promptbook/cli`
  */
 export declare function verifyPrompts(reverse?: boolean): Promise<void>;

package/esm/src/_packages/types.index.d.ts

@@ -233,31 +233,34 @@ import type { EmbeddingModelRequirements } from '../types/ModelRequirements';
 import type { ModelVariant } from '../types/ModelVariant';
 import type { NonEmptyArray } from '../types/NonEmptyArray';
 import type { NonEmptyReadonlyArray } from '../types/NonEmptyArray';
+import type { number_bytes } from '../types/number_bytes';
+import type { number_kilobytes } from '../types/number_bytes';
+import type { number_megabytes } from '../types/number_bytes';
+import type { number_gigabytes } from '../types/number_bytes';
+import type { number_terabytes } from '../types/number_bytes';
+import type { number_id } from '../types/number_id';
+import type { number_linecol_number } from '../types/number_id';
+import type { number_tokens } from '../types/number_id';
+import type { number_likeness } from '../types/number_likeness';
+import type { number_milliseconds } from '../types/number_milliseconds';
+import type { number_seconds } from '../types/number_milliseconds';
+import type { number_minutes } from '../types/number_milliseconds';
+import type { number_hours } from '../types/number_milliseconds';
+import type { number_days } from '../types/number_milliseconds';
+import type { number_weeks } from '../types/number_milliseconds';
+import type { number_months } from '../types/number_milliseconds';
+import type { number_years } from '../types/number_milliseconds';
+import type { number_percent } from '../types/number_percent';
+import type { number_model_temperature } from '../types/number_percent';
+import type { number_seed } from '../types/number_percent';
+import type { number_positive } from '../types/number_positive';
+import type { number_negative } from '../types/number_positive';
+import type { number_integer } from '../types/number_positive';
+import type { number_port } from '../types/number_positive';
 import type { number_usd } from '../types/number_usd';
-import type { number_id } from '../types/number_usd';
-import type { number_linecol_number } from '../types/number_usd';
-import type { number_tokens } from '../types/number_usd';
-import type { number_positive } from '../types/number_usd';
-import type { number_negative } from '../types/number_usd';
-import type { number_integer } from '../types/number_usd';
-import type { number_port } from '../types/number_usd';
-import type { number_percent } from '../types/number_usd';
-import type { number_model_temperature } from '../types/number_usd';
-import type { number_seed } from '../types/number_usd';
-import type { number_likeness } from '../types/number_usd';
-import type { number_milliseconds } from '../types/number_usd';
-import type { number_seconds } from '../types/number_usd';
-import type { number_minutes } from '../types/number_usd';
-import type { number_hours } from '../types/number_usd';
-import type { number_days } from '../types/number_usd';
-import type { number_weeks } from '../types/number_usd';
-import type { number_months } from '../types/number_usd';
-import type { number_years } from '../types/number_usd';
-import type { number_bytes } from '../types/number_usd';
-import type { number_kilobytes } from '../types/number_usd';
-import type { number_megabytes } from '../types/number_usd';
-import type { number_gigabytes } from '../types/number_usd';
-import type { number_terabytes } from '../types/number_usd';
+import type { Parameters } from '../types/Parameters';
+import type { InputParameters } from '../types/Parameters';
+import type { ReservedParameters } from '../types/Parameters';
 import type { Prompt } from '../types/Prompt';
 import type { CompletionPrompt } from '../types/Prompt';
 import type { ChatPrompt } from '../types/Prompt';
@@ -270,6 +273,11 @@ import type { SpeechRecognition } from '../types/SpeechRecognition';
 import type { SpeechRecognitionStartOptions } from '../types/SpeechRecognition';
 import type { SpeechRecognitionState } from '../types/SpeechRecognition';
 import type { SpeechRecognitionEvent } from '../types/SpeechRecognition';
+import type { string_agent_name } from '../types/string_agent_name';
+import type { string_agent_name_in_book } from '../types/string_agent_name';
+import type { string_agent_hash } from '../types/string_agent_name';
+import type { string_agent_permanent_id } from '../types/string_agent_name';
+import type { string_business_category_name } from '../types/string_business_category_name';
 import type { string_absolute_filename } from '../types/string_filename';
 import type { string_relative_filename } from '../types/string_filename';
 import type { string_filename } from '../types/string_filename';
@@ -298,31 +306,13 @@ import type { string_css_property } from '../types/string_markdown';
 import type { string_fonts } from '../types/string_markdown';
 import type { string_css_value } from '../types/string_markdown';
 import type { string_css_selector } from '../types/string_markdown';
-import type { string_business_category_name } from '../types/string_parameter_name';
-import type { string_model_name } from '../types/string_parameter_name';
-import type { string_prompt } from '../types/string_parameter_name';
-import type { string_prompt_image } from '../types/string_parameter_name';
-import type { string_template } from '../types/string_parameter_name';
-import type { string_text_prompt } from '../types/string_parameter_name';
-import type { string_chat_prompt } from '../types/string_parameter_name';
-import type { string_system_message } from '../types/string_parameter_name';
-import type { string_completion_prompt } from '../types/string_parameter_name';
-import type { string_page } from '../types/string_parameter_name';
-import type { string_char } from '../types/string_parameter_name';
-import type { string_name } from '../types/string_parameter_name';
-import type { string_parameter_name } from '../types/string_parameter_name';
-import type { string_parameter_value } from '../types/string_parameter_name';
-import type { Parameters } from '../types/string_parameter_name';
-import type { InputParameters } from '../types/string_parameter_name';
-import type { string_reserved_parameter_name } from '../types/string_parameter_name';
-import type { ReservedParameters } from '../types/string_parameter_name';
-import type { string_title } from '../types/string_parameter_name';
-import type { string_agent_name } from '../types/string_parameter_name';
-import type { string_agent_name_in_book } from '../types/string_parameter_name';
-import type { string_agent_hash } from '../types/string_parameter_name';
-import type { string_agent_permanent_id } from '../types/string_parameter_name';
-import type { string_persona_description } from '../types/string_parameter_name';
-import type { string_model_description } from '../types/string_parameter_name';
+import type { string_model_name } from '../types/string_model_name';
+import type { string_name } from '../types/string_name';
+import type { string_parameter_name } from '../types/string_name';
+import type { string_parameter_value } from '../types/string_name';
+import type { string_reserved_parameter_name } from '../types/string_name';
+import type { string_page } from '../types/string_page';
+import type { string_char } from '../types/string_page';
 import type { string_person_fullname } from '../types/string_person_fullname';
 import type { string_person_firstname } from '../types/string_person_fullname';
 import type { string_person_lastname } from '../types/string_person_fullname';
@@ -337,12 +327,22 @@ import type { string_translate_name_not_normalized } from '../types/string_perso
 import type { string_translate_language } from '../types/string_person_fullname';
 import type { string_javascript_name } from '../types/string_person_fullname';
 import type { string_postprocessing_function_name } from '../types/string_person_fullname';
+import type { string_persona_description } from '../types/string_persona_description';
+import type { string_model_description } from '../types/string_persona_description';
+import type { string_prompt } from '../types/string_prompt';
+import type { string_prompt_image } from '../types/string_prompt';
+import type { string_template } from '../types/string_prompt';
+import type { string_text_prompt } from '../types/string_prompt';
+import type { string_chat_prompt } from '../types/string_prompt';
+import type { string_system_message } from '../types/string_prompt';
+import type { string_completion_prompt } from '../types/string_prompt';
 import type { string_uuid } from '../types/string_sha256';
 import type { string_sha256 } from '../types/string_sha256';
 import type { string_base_58 } from '../types/string_sha256';
 import type { string_semantic_version } from '../types/string_sha256';
 import type { string_version_dependency } from '../types/string_sha256';
 import type { string_file_extension } from '../types/string_sha256';
+import type { string_title } from '../types/string_title';
 import type { id } from '../types/string_token';
 import type { task_id } from '../types/string_token';
 import type { string_token } from '../types/string_token';
@@ -357,9 +357,15 @@ import type { string_app_id } from '../types/string_token';
 import type { string_user_id } from '../types/string_token';
 import type { string_mime_type } from '../types/string_url';
 import type { string_mime_type_with_wildcard } from '../types/string_url';
+import type { string_base64 } from '../types/string_url';
+import type { string_data_url } from '../types/string_url';
 import type { string_domain } from '../types/string_url';
 import type { string_origin } from '../types/string_url';
 import type { string_tdl } from '../types/string_url';
+import type { string_hostname } from '../types/string_url';
+import type { string_host } from '../types/string_url';
+import type { string_protocol } from '../types/string_url';
+import type { string_ip_address } from '../types/string_url';
 import type { string_url } from '../types/string_url';
 import type { string_promptbook_server_url } from '../types/string_url';
 import type { string_base_url } from '../types/string_url';
@@ -367,16 +373,10 @@ import type { string_pipeline_root_url } from '../types/string_url';
 import type { string_agent_url } from '../types/string_url';
 import type { string_pipeline_url } from '../types/string_url';
 import type { string_pipeline_url_with_task_hash } from '../types/string_url';
-import type { string_base64 } from '../types/string_url';
-import type { string_data_url } from '../types/string_url';
 import type { string_href } from '../types/string_url';
 import type { string_url_image } from '../types/string_url';
 import type { string_uri } from '../types/string_url';
 import type { string_uri_part } from '../types/string_url';
-import type { string_hostname } from '../types/string_url';
-import type { string_host } from '../types/string_url';
-import type { string_protocol } from '../types/string_url';
-import type { string_ip_address } from '../types/string_url';
 import type { string_email } from '../types/string_url';
 import type { string_emails } from '../types/string_url';
 import type { TaskType } from '../types/TaskType';
@@ -661,17 +661,14 @@ export type { EmbeddingModelRequirements };
 export type { ModelVariant };
 export type { NonEmptyArray };
 export type { NonEmptyReadonlyArray };
-export type { number_usd };
+export type { number_bytes };
+export type { number_kilobytes };
+export type { number_megabytes };
+export type { number_gigabytes };
+export type { number_terabytes };
 export type { number_id };
 export type { number_linecol_number };
 export type { number_tokens };
-export type { number_positive };
-export type { number_negative };
-export type { number_integer };
-export type { number_port };
-export type { number_percent };
-export type { number_model_temperature };
-export type { number_seed };
 export type { number_likeness };
 export type { number_milliseconds };
 export type { number_seconds };
@@ -681,11 +678,17 @@ export type { number_days };
 export type { number_weeks };
 export type { number_months };
 export type { number_years };
-export type { number_bytes };
-export type { number_kilobytes };
-export type { number_megabytes };
-export type { number_gigabytes };
-export type { number_terabytes };
+export type { number_percent };
+export type { number_model_temperature };
+export type { number_seed };
+export type { number_positive };
+export type { number_negative };
+export type { number_integer };
+export type { number_port };
+export type { number_usd };
+export type { Parameters };
+export type { InputParameters };
+export type { ReservedParameters };
 export type { Prompt };
 export type { CompletionPrompt };
 export type { ChatPrompt };
@@ -698,6 +701,11 @@ export type { SpeechRecognition };
 export type { SpeechRecognitionStartOptions };
 export type { SpeechRecognitionState };
 export type { SpeechRecognitionEvent };
+export type { string_agent_name };
+export type { string_agent_name_in_book };
+export type { string_agent_hash };
+export type { string_agent_permanent_id };
+export type { string_business_category_name };
 export type { string_absolute_filename };
 export type { string_relative_filename };
 export type { string_filename };
@@ -726,31 +734,13 @@ export type { string_css_property };
 export type { string_fonts };
 export type { string_css_value };
 export type { string_css_selector };
-export type { string_business_category_name };
 export type { string_model_name };
-export type { string_prompt };
-export type { string_prompt_image };
-export type { string_template };
-export type { string_text_prompt };
-export type { string_chat_prompt };
-export type { string_system_message };
-export type { string_completion_prompt };
-export type { string_page };
-export type { string_char };
 export type { string_name };
 export type { string_parameter_name };
 export type { string_parameter_value };
-export type { Parameters };
-export type { InputParameters };
 export type { string_reserved_parameter_name };
-export type { ReservedParameters };
-export type { string_title };
-export type { string_agent_name };
-export type { string_agent_name_in_book };
-export type { string_agent_hash };
-export type { string_agent_permanent_id };
-export type { string_persona_description };
-export type { string_model_description };
+export type { string_page };
+export type { string_char };
 export type { string_person_fullname };
 export type { string_person_firstname };
 export type { string_person_lastname };
@@ -765,12 +755,22 @@ export type { string_translate_name_not_normalized };
 export type { string_translate_language };
 export type { string_javascript_name };
 export type { string_postprocessing_function_name };
+export type { string_persona_description };
+export type { string_model_description };
+export type { string_prompt };
+export type { string_prompt_image };
+export type { string_template };
+export type { string_text_prompt };
+export type { string_chat_prompt };
+export type { string_system_message };
+export type { string_completion_prompt };
 export type { string_uuid };
 export type { string_sha256 };
 export type { string_base_58 };
 export type { string_semantic_version };
 export type { string_version_dependency };
 export type { string_file_extension };
+export type { string_title };
 export type { id };
 export type { task_id };
 export type { string_token };
@@ -785,9 +785,15 @@ export type { string_app_id };
 export type { string_user_id };
 export type { string_mime_type };
 export type { string_mime_type_with_wildcard };
+export type { string_base64 };
+export type { string_data_url };
 export type { string_domain };
 export type { string_origin };
 export type { string_tdl };
+export type { string_hostname };
+export type { string_host };
+export type { string_protocol };
+export type { string_ip_address };
 export type { string_url };
 export type { string_promptbook_server_url };
 export type { string_base_url };
@@ -795,16 +801,10 @@ export type { string_pipeline_root_url };
 export type { string_agent_url };
 export type { string_pipeline_url };
 export type { string_pipeline_url_with_task_hash };
-export type { string_base64 };
-export type { string_data_url };
 export type { string_href };
 export type { string_url_image };
 export type { string_uri };
 export type { string_uri_part };
-export type { string_hostname };
-export type { string_host };
-export type { string_protocol };
-export type { string_ip_address };
 export type { string_email };
 export type { string_emails };
 export type { TaskType };

package/esm/src/book-2.0/agent-source/AgentBasicInformation.d.ts

@@ -46,6 +46,9 @@ export type AgentCapability = {
      */
     agentUrl?: string_agent_url;
 };
+/**
+ * Information about agent basic.
+ */
 export type AgentBasicInformation = {
     /**
      * Name of the agent
@@ -123,7 +126,3 @@ export type AgentBasicInformation = {
         filename: string;
     }>;
 };
-/**
- * TODO: [🐱‍🚀] Make all properties of `AgentBasicInformation` readonly
- * TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
- */

package/esm/src/book-2.0/agent-source/AgentModelRequirements.d.ts

@@ -75,7 +75,3 @@ export type AgentModelRequirements = {
      */
     readonly _metadata?: Record<string, chococake>;
 };
-/**
- * TODO: [🐤] DRY `AgentModelRequirements` and `ModelRequirements`
- * TODO: [🧠] `isClosed` and `parentAgentUrl` doesn't truly belong to `AgentModelRequirements` nor agent profile but it is in the `AgentModelRequirements` because of some legacy - maybe figure out better place
- */

package/esm/src/book-2.0/agent-source/createAgentModelRequirements.d.ts

@@ -16,6 +16,7 @@ import type { string_book } from './string_book';
  * @param availableModels - Models that could fulfill the agent.
  * @param llmTools - Execution tools used when selecting a best model.
  * @param options - Optional hooks such as the agent reference resolver.
+ *
  * @public exported from `@promptbook/core`
  */
 export declare function createAgentModelRequirements(agentSource: string_book, modelName?: string_model_name, availableModels?: readonly AvailableModel[], llmTools?: LlmExecutionTools, options?: CreateAgentModelRequirementsOptions): Promise<AgentModelRequirements>;
@@ -30,21 +31,27 @@ export declare function createAgentModelRequirements(agentSource: string_book, m
 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_system_message>;
 /**
  * Extracts the agent name from the first non-empty line of the agent source.
+ *
  * @deprecated Use parseAgentSource instead
+ *
  * @private
  */
 export declare function extractAgentName(agentSource: string_book): string_agent_name;
 /**
  * Extracts the profile image URL from agent source or returns default avatar fallback
+ *
  * @param agentSource The agent source string that may contain META IMAGE line
  * @returns Profile image URL (from source or default avatar fallback)
  * @deprecated Use parseAgentSource instead
+ *
  * @private
  */
 export declare function extractAgentProfileImage(agentSource: string_book): string_url_image | null;

package/esm/src/book-2.0/agent-source/createTeamToolName.d.ts

@@ -7,6 +7,7 @@
  * @param _teammateUrl - Canonical teammate URL (kept for API compatibility, not used).
  * @param teammateLabel - Human-readable teammate label used as the basis for the name.
  * @returns TEAM tool name derived from the label.
+ *
  * @private internal utility of TEAM commitments and chat UI mapping
  */
 export declare function createTeamToolName(_teammateUrl: string, teammateLabel?: string): string;

package/esm/src/book-2.0/agent-source/extractOpenTeacherInstructions.d.ts

@@ -7,6 +7,7 @@ import type { string_book } from './string_book';
  *
  * @param agentSource - The raw agent book source
  * @returns The trimmed instructions or `null` when no instructive `OPEN` commitment exists.
+ *
  * @private Internal helper shared between self-learning and related features.
  */
 export declare function extractOpenTeacherInstructions(agentSource: string_book): string | null;

package/esm/src/book-2.0/agent-source/padBook.d.ts

@@ -1,6 +1,6 @@
 import type { string_book } from './string_book';
 /**
- *  Number of padding lines to add at the end of the book content
+ * Number of padding lines to add at the end of the book content
  *
  * @public exported from `@promptbook/core`
  */
@@ -13,6 +13,3 @@ export declare const PADDING_LINES = 11;
  * @public exported from `@promptbook/core`
  */
 export declare function padBook(content: string_book): string_book;
-/**
- * TODO: [🧠] Maybe export
- */

package/esm/src/book-2.0/agent-source/parseAgentSource.d.ts

@@ -10,6 +10,3 @@ import type { string_book } from './string_book';
  * @public exported from `@promptbook/core`
  */
 export declare function parseAgentSource(agentSource: string_book): AgentBasicInformation;
-/**
- * TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
- */