@promptbook/javascript 0.111.0-7 → 0.112.0-12

package/umd/src/types/typeAliases.d.ts

@@ -1,745 +1,13 @@
-import type { TupleToUnion } from 'type-fest';
-import { RESERVED_PARAMETER_NAMES } from '../constants';
-import type { really_unknown } from '../utils/organization/really_unknown';
+export type { InputParameters, Parameters, ReservedParameters, string_agent_hash, string_agent_name, string_agent_name_in_book, string_agent_permanent_id, string_business_category_name, string_char, string_chat_prompt, string_completion_prompt, string_model_description, string_model_name, string_name, string_page, string_parameter_name, string_parameter_value, string_persona_description, string_prompt, string_prompt_image, string_reserved_parameter_name, string_system_message, string_template, string_text_prompt, string_title, } from './string_parameter_name';
+export type { string_base_58, string_file_extension, string_semantic_version, string_sha256, string_uuid, string_version_dependency, } from './string_sha256';
+export type { string_css, string_css_class, string_css_property, string_css_selector, string_css_value, string_fonts, string_html, string_javascript, string_json, string_markdown, string_markdown_codeblock_language, string_markdown_section, string_markdown_section_content, string_markdown_text, string_promptbook_documentation_url, string_script, string_svg, string_typescript, string_xml, } from './string_markdown';
+export type { string_absolute_dirname, string_absolute_filename, string_dirname, string_executable_path, string_filename, string_relative_dirname, string_relative_filename, } from './string_filename';
+export type { string_base64, string_base_url, string_data_url, string_domain, string_email, string_emails, string_host, string_hostname, string_href, string_ip_address, string_mime_type, string_mime_type_with_wildcard, string_origin, string_pipeline_root_url, string_pipeline_url, string_pipeline_url_with_task_hash, string_promptbook_server_url, string_protocol, string_tdl, string_uri, string_uri_part, string_url, string_url_image, string_agent_url, } from './string_url';
+export type { string_knowledge_source_content, string_knowledge_source_link } from './string_knowledge_source_content';
+export type { string_attribute, string_attribute_value_scope, string_color, string_javascript_name, string_legal_entity, string_license, string_person_firstname, string_person_fullname, string_person_lastname, string_person_profile, string_postprocessing_function_name, string_translate_language, string_translate_name, string_translate_name_not_normalized, } from './string_person_fullname';
+export type { id, string_app_id, string_date_iso8601, string_language, string_license_token, string_password, string_pgp_key, string_promptbook_token, string_ssh_key, string_token, string_user_id, task_id, } from './string_token';
+export type { number_bytes, number_days, number_gigabytes, number_hours, number_id, number_integer, number_kilobytes, number_likeness, number_linecol_number, number_megabytes, number_milliseconds, number_minutes, number_model_temperature, number_months, number_negative, number_percent, number_port, number_positive, number_seconds, number_seed, number_terabytes, number_tokens, number_usd, number_weeks, number_years, } from './number_usd';
 /**
- * Semantic helper
- */
-export type string_business_category_name = 'restaurant' | 'grocery' | 'person' | 'conference' | string;
-/**
- * Semantic helper
- *
- * For example `"gpt-4"`
- */
-export type string_model_name = 'gpt-4' | 'gpt-4-0314' | 'gpt-4-0613' | 'gpt-4-32k' | 'gpt-4-32k-0314' | 'gpt-4-32k-0613' | 'gpt-3.5-turbo' | 'gpt-3.5-turbo-16k' | 'gpt-3.5-turbo-0301' | 'gpt-3.5-turbo-0613' | 'gpt-3.5-turbo-16k-0613' | string;
-/**
- * Semantic helper
- *
- * For example `"How many eyes does a cat have?"`
- */
-export type string_prompt = string;
-/**
- * Semantic helper
- *
- * For example `"A cat wearing a hat"`
- */
-export type string_prompt_image = string;
-/**
- * Semantic helper
- *
- * For example `"A cat wearing a {item}"`
- */
-export type string_template = string;
-/**
- * Semantic helper
- *
- * For example `"How many hats does the cat wear?"`
- */
-export type string_text_prompt = string_prompt;
-/**
- * Semantic helper
- *
- * For example `"How many hats does the cat wear?"`
- */
-export type string_chat_prompt = string_text_prompt;
-/**
- * Semantic helper
- *
- * For example `"You are an AI assistant. You are here to help me with my work."`
- */
-export type string_system_message = string_text_prompt;
-/**
- * Semantic helper
- *
- * For example `"Following is a text about cats: Once upon a time there was a cat"`
- */
-export type string_completion_prompt = string_text_prompt;
-/**
- * Semantic helper
- *
- * For example `"index"` or `"explanation"`
- * Always in kebab-case
- */
-export type string_page = 'index' | string;
-/**
- * Semantic helper
- *
- * For example `"text/plain"` or `"application/collboard"`
- */
-export type string_mime_type = string;
-/**
- * Semantic helper
- *
- * For example `"text/*"` or `"image/*"`
- *
- *
- * @see https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input/file#unique_file_type_specifiers
- */
-export type string_mime_type_with_wildcard = string;
-/**
- * Semantic helper
- *
- * For example `"a"`
- */
-export type string_char = string;
-/**
- * Semantic helper
- * Unique identifier of anything
- *
- * For example `"ainautes"`
- */
-export type string_name = string;
-/**
- * Semantic helper
- * Unique identifier of anything
- *
- * For example `"eventTitle"`
- */
-export type string_parameter_name = string_name;
-/**
- * Semantic helper
- * Unique identifier of parameter
- *
- * For example `"DevConf 2024"`
- */
-export type string_parameter_value = string;
-/**
- * Parameters of the pipeline
- *
- * There are three types of parameters:
- * - **INPUT PARAMETERs** are required to execute the pipeline.
- * - **Intermediate parameters** are used internally in the pipeline.
- * - **OUTPUT PARAMETERs** are not used internally in the pipeline, but are returned as the result of the pipeline execution.
- *
- * Note: [🚉] This is fully serializable as JSON
- * @see https://ptbk.io/parameters
- */
-export type Parameters = Exclude<Record<string_parameter_name, string_parameter_value>, ReservedParameters>;
-/**
- * Parameters to pass to execution of the pipeline
- *
- * Note: [🚉] This should be fully serializable as JSON
- * @see https://ptbk.io/parameters
- */
-export type InputParameters = Exclude<Record<string_parameter_name, really_unknown>, ReservedParameters>;
-/**
- * Semantic helper
- * Unique identifier of reserved parameter
- *
- * For example `"context"`
- */
-export type string_reserved_parameter_name = TupleToUnion<typeof RESERVED_PARAMETER_NAMES>;
-/**
- * Represents a mapping of reserved parameter names to their values.
- * Reserved parameters are used internally by the pipeline and should not be set by users.
- *
- * Note: [🚉] This is fully serializable as JSON
- */
-export type ReservedParameters = Record<string_reserved_parameter_name, string_parameter_value>;
-/**
- * Semantic helper
- * Title of anything
- *
- * For example `"Ai*nautes"`
- */
-export type string_title = string;
-/**
- * Semantic helper
- *
- * For example `"My AI Assistant"`
- *
- * TODO: !!!! Brand the type
- */
-export type string_agent_name = string;
-/**
- * Semantic helper
- *
- * For example `"My AI Assistant"`
- */
-export type string_agent_name_in_book = string;
-/**
- * Semantic helper
- *
- * For example `"b126926439c5fcb83609888a11283723c1ef137c0ad599a77a1be81812bd221d"`
- */
-export type string_agent_hash = string_sha256;
-/**
- * Semantic helper
- *
- * For example `"3mJr7AoUXx2Wqd"`
- *
- * TODO: !!!! Brand the type
- */
-export type string_agent_permanent_id = string_base_58;
-/**
- * Unstructured description of the persona
- *
- * For example `"Skilled copywriter"`
- */
-export type string_persona_description = string;
-/**
- * Unstructured description of the model
- *
- * For example `"Model with logical reasoning and creative mindset"`
- */
-export type string_model_description = string;
-/**
- * Source of one knowledge piece.
- *
- * It can be a link, a relative path to file or direct text content.
- *
- * For example `"https://pavolhejny.com/"`
- * For example `"./pavol-hejny-cv.pdf"`
- * For example `"Pavol Hejný has web https://pavolhejny.com/"`
- * For example `"Pavol Hejný is web developer and creator of Promptbook and Collboard"`
- *
- * Note: Distinguishes between `string_knowledge_source_content` and `string_knowledge_source_link`:
- * `string_knowledge_source_content` refers to the actual content or source of knowledge
- * `string_knowledge_source_link` refers to a reference or link to the knowledge source
- */
-export type string_knowledge_source_content = string_knowledge_source_link | string_markdown;
-/**
- * One link to a knowledge source.
- *
- * It can be a URL or relative path.
- *
- * For example `"https://pavolhejny.com/"`
- * For example `"./pavol-hejny-cv.pdf"`
- *
- * Note: string_knowledge_source_link refers to a reference or link to the knowledge source, while string_knowledge_source_content can be the link or the actual content.
- */
-export type string_knowledge_source_link = string_url | string_filename;
-/**
- * Semantic helper
- *
- * For example `"<div>Hello World!</div>"`
- */
-export type string_html = string;
-/**
- * Semantic helper
- *
- * For example `"<foo>bar</foo>"`
- *
- *
- * TODO: [🎞️] Probably use some object-based method for working with XMLs
- */
-export type string_xml = string;
-/**
- * Semantic helper
- *
- * For example `"**Hello** World!"`
- *
- * @public exported from `@promptbook/markdown-utils`
- */
-export type string_markdown = string;
-/**
- * Semantic helper
- *
- * Markdown text with exactly ONE heading on first line NO less NO more
- *
- * @public exported from `@promptbook/markdown-utils`
- */
-export type string_markdown_section = string;
-/**
- * Semantic helper
- *
- * Markdown without any headings like h1, h2
- * BUT with formatting, lists, blockquotes, blocks, etc. is allowed
- *
- * @public exported from `@promptbook/markdown-utils`
- */
-export type string_markdown_section_content = string;
-/**
- * Semantic helper
- *
- * Markdown text without any structure like h1, h2, lists, blockquotes, blocks, etc.
- * BUT with bold, italic, etc. is allowed
- *
- * For example `"**Hello** World!"`
- *
- * @public exported from `@promptbook/markdown-utils`
- */
-export type string_markdown_text = string;
-/**
- * Semantic helper
- *
- * Markdown code block language
- *
- * For example ```js -> `"js"`
- *
- * @public exported from `@promptbook/markdown-utils`
- */
-export type string_markdown_codeblock_language = 'book' | 'markdown' | 'text' | 'javascript' | 'css' | 'json';
-/**
- * A URL pointing to Promptbook documentation or a specific discussion.
- *
- * For example: `https://github.com/webgptorg/promptbook/discussions/123`
- */
-export type string_promptbook_documentation_url = `https://github.com/webgptorg/promptbook/discussions/${number | `@@${string}`}`;
-/**
- * Semantic helper
- *
- * For example `"towns.cz"`
- */
-export type string_domain = string;
-/**
- * Semantic helper
- *
- * For example `"https://*.pavolhejny.com/*"`
- */
-export type string_origin = string;
-/**
- * Semantic helper
- *
- * For example `"com"`
- */
-export type string_tdl = string;
-/**
- * Semantic helper
- *
- * For example `.foo{border: 1px solid red}`
- */
-export type string_css = string;
-/**
- * Semantic helper
- *
- * For example `"<svg><circle cx="50" cy="50" r="40" stroke="green" stroke-width="4" fill="yellow" /></svg>"`
- */
-export type string_svg = string;
-/**
- * Semantic helper
- *
- * For example `console.info("Hello World!")` or `print("Hello World!")`
- */
-export type string_script = string;
-/**
- * Semantic helper
- *
- * For example `console.info("Hello World!")`
- */
-export type string_javascript = string;
-/**
- * Semantic helper
- *
- * For example `console.info("Hello World!" as string)`
- */
-export type string_typescript = string;
-/**
- * Semantic helper for JSON strings
- *
- * Note: TType is a type of the JSON object inside the string
- *
- * For example `{"foo": "bar"}`
- */
-export type string_json<TType> = string & {
-    _type: 'string_json';
-    scheme: TType;
-};
-/**
- * Semantic helper
- *
- * For example `menu`
- */
-export type string_css_class = string;
-/**
- * Semantic helper
- *
- * For example `border`
- */
-export type string_css_property = string;
-/**
- * Semantic helper
- *
- * For example `"Arial, sans-serif"`
- */
-export type string_fonts = string;
-/**
- * Semantic helper
- *
- * For example `13px`
- */
-export type string_css_value = string | number;
-/**
- * Semantic helper
- *
- * For example `.foo`
- */
-export type string_css_selector = string;
-/**
- * Semantic helper
- *
- * For example `"https://collboard.com/9SeSQTupmQHwuSrLi"`
- */
-export type string_url = string;
-/**
- * Semantic helper
- *
- * For example `"https://s1.ptbk.io/promptbook"`
- */
-export type string_promptbook_server_url = string;
-/**
- * Semantic helper
- *
- * For example `"https://collboard.com"`
- */
-export type string_base_url = string;
-/**
- * Semantic helper
- *
- * For example `"https://promptbook.studio/webgpt/"`
- */
-export type string_pipeline_root_url = string;
-/**
- * Semantic helper
- *
- * For example `"https://s6.ptbk.io/agents/agent-007"`
- */
-export type string_agent_url = string;
-/**
- * Semantic helper
- *
- * For example `"https://promptbook.studio/webgpt/write-website-content-cs.book"`
- */
-export type string_pipeline_url = string;
-/**
- * Semantic helper
- *
- * For example `"https://promptbook.studio/webgpt/write-website-content-cs.book#keywords"`
- */
-export type string_pipeline_url_with_task_hash = string;
-/**
- * Semantic helper
- *
- * For example `"data:text/plain;base64,SGVsbG8sIFdvcmxkIQ=="`
- */
-export type string_data_url = `data:${string_mime_type};base64,${string_base64}`;
-/**
- * Semantic helper
- *
- * For example `"SGVsbG8sIFdvcmxkIQ=="`
- */
-export type string_base64 = string;
-/**
- * Semantic helper
- *
- * For example `"https://collboard.com/9SeSQTupmQHwuSrLi"` OR `/9SeSQTupmQHwuSrLi`
- */
-export type string_href = string;
-/**
- * Semantic helper
- *
- * For example `"https://collboard.com/9SeSQTupmQHwuSrLi.png?width=1200&height=630"`
- */
-export type string_url_image = string;
-/**
- * Semantic helper
- *
- * For example `"C:/Users/me/AppData/Local/Pandoc/pandoc.exe"`
- * For example `"C:/Program Files/LibreOffice/program/swriter.exe"`
- */
-export type string_executable_path = string;
-/**
- * Semantic helper
- *
- * For example `"/9SeSQTupmQHwuSrLi"`
- */
-export type string_uri = string;
-/**
- * Semantic helper
- *
- * For example `"9SeSQTupmQHwuSrLi"`
- */
-export type string_uri_part = string;
-/**
- * Semantic helper
- *
- * For example `"localhost"` or `"collboard.com"`
- */
-export type string_hostname = string;
-/**
- * Semantic helper
- *
- * For example `"localhost:9977"` or `"collboard.com"`
- */
-export type string_host = string;
-/**
- * Semantic helper
- */
-export type string_protocol = 'http:' | 'https:';
-/**
- * Semantic helper
- *
- * For example `"192.168.1.1"` (IPv4)
- * For example `"2001:0db8:85a3:0000:0000:8a2e:0370:7334"` (IPv6)
- */
-export type string_ip_address = string;
-/**
- * Semantic helper
- *
- * For example `"pavol@hejny.org"`
- */
-export type string_email = string;
-/**
- * Semantic helper
- *
- * For example `"pavol@hejny.org, jirka@webgpt.cz"`
- */
-export type string_emails = string;
-/**
- * Branded type for UUIDs version 4
- * This will not allow to pass some random string where should be only a valid UUID
- *
- * Use utils:
- *   - `randomUuid` to generate
- *   - `isValidUuid  to check validity
- *
- * For example `"5a0a153d-7be9-4018-9eda-e0e2e2b89bd9"`
- * TODO: [🥬] Make some system for hashes and ids of promptbook
- */
-export type string_uuid = string & {
-    readonly _type: 'uuid';
-};
-/**
- * Application identifier, used to distinguish different apps or clients.
- *
- * For example: 'cli', 'playground', or a custom app id.
- */
-export type string_app_id = id | 'app';
-/**
- * End user identifier, can be a user id or email address.
- * Used for tracking and abuse prevention.
- */
-export type string_user_id = id | string_email;
-/**
- * Semantic helper
- *
- * For example `"b126926439c5fcb83609888a11283723c1ef137c0ad599a77a1be81812bd221d"`
- */
-export type string_sha256 = string;
-/**
- * Semantic helper
- *
- * For example `"4JmF3b2J5dGVz"`
- */
-export type string_base_58 = string;
-/**
- * Semantic helper
- *
- * For example `"4.2.4"`
- */
-export type string_semantic_version = string;
-/**
- * Semantic helper
- *
- * For example `"^4.2.4"`
- */
-export type string_version_dependency = string;
-/**
- * Semantic helper
- *
- * For example `"png"`
- */
-export type string_file_extension = string;
-/**
- * Semantic helper
- *
- * For example `"C:/Users/me/work/collboard/modules-sdk/src/colldev/commands/develop/ColldevDevelop.tsx"`
- */
-export type string_absolute_filename = string;
-/**
- * Semantic helper
- *
- * For example `"./src/colldev/commands/develop/ColldevDevelop.tsx"`
- */
-export type string_relative_filename = string;
-/**
- * Semantic helper
- */
-export type string_filename = string_absolute_filename | string_relative_filename;
-/**
- * Semantic helper
- *
- * For example `"C:/Users/me/work/collboard/modules-sdk/src/colldev/commands/develop/ColldevDevelop.tsx"`
- */
-export type string_absolute_dirname = string;
-/**
- * Semantic helper
- *
- * For example `"./src/colldev/commands/develop/ColldevDevelop.tsx"`
- */
-export type string_relative_dirname = string;
-/**
- * Semantic helper
- */
-export type string_dirname = string_absolute_dirname | string_relative_dirname;
-/**
- * Semantic helper
- *
- * For example `"John Smith"`
- */
-export type string_person_fullname = `${string_person_firstname} ${string_person_lastname}` | string;
-/**
- * Semantic helper
- *
- * For example `"John Smith"`
- */
-export type string_person_firstname = string;
-/**
- * Semantic helper
- *
- * For example `"John Smith"`
- */
-export type string_person_lastname = string;
-/**
- * Semantic helper
- * Full profile of the person with his email and web (like in package.json)
- *
- * For example `"Pavol Hejný <pavol@hejny.org> (https://pavolhejny.com)"`
- */
-export type string_person_profile = string;
-/**
- * Semantic helper
- *
- * For example `"MIT"`
- */
-export type string_license = string;
-/**
- * Semantic helper
- *
- * For example `"Pavol Hejný <pavol@ptbk.io> (https://www.pavolhejny.com/)"`
- * For example `"AI Web, LLC <legal@ptbk.io> (https://www.ptbk.io/)"`
- */
-export type string_legal_entity = string | string_person_profile | string_title;
-/**
- * Semantic helper for attributes
- *
- * - case insensitive
- *
- * For example `"color"`
- */
-export type string_attribute = string;
-/**
- * Semantic helper for attributes context
- * Each attribute value scope with a attribute name has its own current value
- *
- * - case insensitive
- *
- * For example `"tools"`
- */
-export type string_attribute_value_scope = string;
-/**
- * Semantic helper for css/html colors
- *
- * For example `"white"` or `"#009edd"`
- */
-export type string_color = string;
-/**
- * Semantic helper; For example "SHARE_ICON/EDIT_LINK"
- */
-export type string_translate_name = string;
-/**
- * Semantic helper; For example "ShareIcon/ edit link"
- */
-export type string_translate_name_not_normalized = string;
-/**
- * Semantic helper; For example "cs" or "en"
- * Implementing ISO 639-1
- *
- * TODO: Probably use enum
- */
-export type string_translate_language = 'en' | 'cs';
-/**
- * Semantic helper; For example "callbackName" or "renderMe"
- */
-export type string_javascript_name = string;
-/**
- * Semantic helper; For example "unwrapResult" or "spaceTrim"
- */
-export type string_postprocessing_function_name = string;
-export type id = string | number;
-export type task_id = string;
-export type string_token = string;
-/**
- * Semantic helper
- *
- * Made by `identificationToPromptbookToken` exported from `@promptbook/core`
- */
-export type string_promptbook_token = string_token;
-export type string_license_token = string_token;
-export type string_password = string;
-export type string_ssh_key = string;
-export type string_pgp_key = string;
-/**
- * Language as a string, e.g. 'en-US', 'cs-CZ', 'en'
- */
-export type string_language = string;
-/**
- * Semantic helper for `Date.toISOString()` result
- *
- * @example "2011-10-05T14:48:00.000Z".
- * @see https://en.wikipedia.org/wiki/ISO_8601
- * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString
- */
-export type string_date_iso8601 = `${number}-${number}-${number}${string}${number}:${number}:${number}${string}`;
-/**
- * Semantic helper for US Dollars
- */
-export type number_usd = number;
-/**
- * Semantic helper for incremental IDs
- */
-export type number_id = number_integer & (number_positive | 0);
-/**
- * Semantic helper for number of rows and columns
- */
-export type number_linecol_number = number_integer & number_positive;
-/**
- * Semantic helper for number of tokens
- */
-export type number_tokens = number_integer & (number_positive | 0);
-export type number_positive = number;
-export type number_negative = number;
-export type number_integer = number;
-export type number_port = number_positive & number_integer;
-/**
- * Semantic helper;
- * Percentage from 0 to 1 (100%) (and below and above)
- */
-export type number_percent = number;
-/**
- * Semantic helper;
- * Model temperature
- */
-export type number_model_temperature = number_percent;
-/**
- * Semantic helper;
- * Seed for random generator
- *
- * Percentage from 0 to 1 (100%)
- * TODO: Is seed (in OpenAI) number from 0 to 1?
- */
-export type number_seed = number_percent;
-/**
- * Likeness of the wallpaper
- *
- * - 👍 is equivalent to 1
- * - 👎 is equivalent to -1
- * - ❤ is equivalent to more than 1
- */
-export type number_likeness = number;
-export type number_milliseconds = number_integer;
-export type number_seconds = number;
-export type number_minutes = number;
-export type number_hours = number;
-export type number_days = number;
-export type number_weeks = number;
-export type number_months = number;
-export type number_years = number;
-export type number_bytes = number_integer & number_positive;
-export type number_kilobytes = number_positive;
-export type number_megabytes = number_positive;
-export type number_gigabytes = number_positive;
-export type number_terabytes = number_positive;
-/**.
  * TODO: [main] !!3 Change "For example" to @example
  * TODO: Change to branded types
  * TODO: Delete type aliases that are not exported or used internally