@promptbook/components 0.112.0 → 0.113.0-0

package/README.md

@@ -41,14 +41,17 @@ Non-interactive mode takes defaults from command-line options. When `--openai-ap
 sudo curl -fsSL https://raw.githubusercontent.com/webgptorg/promptbook/refs/heads/main/other/vps/install.sh | bash -s -- \
     --non-interactive \
     --yes-i-understand-that-script-should-be-run-on-fresh-server \
-    --domain s24.ptbk.io \
-    --openai-api-key sk-proj-abcdef \
-    --sentry-dsn https://abc@def.ingest.de.sentry.io/123 \
+    --domain my-server.com \
+    --openai-api-key sk-proj-xxx \
     --admin-password xxx
 ```
 
 
 
+<blockquote style="color: #ff8811">
+    <b>⚠ Warning:</b> This is a pre-release version of the library. It is not yet ready for production use. Please look at <a href="https://www.npmjs.com/package/@promptbook/core?activeTab=versions">latest stable release</a>.
+</blockquote>
+
 ## 📦 Package `@promptbook/components`
 
 - Promptbooks are [divided into several](#-packages) packages, all are published from [single monorepo](https://github.com/webgptorg/promptbook).
@@ -221,7 +224,7 @@ Rest of the documentation is common for **entire promptbook ecosystem**:
 
 Promptbook lets you create **persistent AI agents** that work on real goals for your company. The [**Agents Server**](https://gallery.ptbk.io/) is the heart of the project - a place where your AI agents live, remember context, collaborate in teams, and get things done.
 
-Nowadays, the biggest challenge for most business applications isn't the raw capabilities of AI models. Large language models such as GPT-5.2 and Claude-4.5 are incredibly capable.
+Nowadays, the biggest challenge for most business applications isn't the raw capabilities of AI models. Large language models such as Claude Mythos, GPT-5.6 or Kimi K2.7 are incredibly capable.
 
 The main challenge lies in **managing the context**, providing rules and knowledge, and narrowing the personality.
 
@@ -229,17 +232,20 @@ In Promptbook, you define your agents **using simple Books** - a human-readable
 
 <table style="border: 1px solid #777; border-radius: 10px;"><tr><td>
 
-**<ins>Paul Smith</ins>**<br/>
+**<ins>Lawyer</ins>**<br/>
 <br/>
-**PERSONA** You are a company lawyer.<br/>
+GOAL You are a company lawyer.<br/>
 Your job is to provide legal advice and support to the company and its employees.<br/>
-**GOAL** Respond to incoming legal inquiries via email and keep the company website updated with the latest legal policies.<br/>
+Respond to incoming legal inquiries via email and keep the company website updated with the latest legal policies.<br/>
+<br/>
 **RULE** You are knowledgeable, professional, and detail-oriented.<br/>
 **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
 **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
-**USE EMAIL**<br/>
-**USE BROWSER**<br/>
-**TEAM** You are part of the legal team of Paul Smith & Associés, you discuss with {Emily White}, the head of the compliance department. {George Brown} is expert in corporate law and {Sophia Black} is expert in labor law.<br/>
+<br/>
+USE EMAIL<br/>
+USE BROWSER<br/>
+<br/>
+TEAM You are part of the legal team of Paul Smith & Associés, you discuss with {Emily White}, the head of the compliance department. {George Brown} is expert in corporate law and {Sophia Black} is expert in labor law.<br/>
 
 </td></tr></table>
 
@@ -272,12 +278,12 @@ Goals define what the agent should actively work toward. Unlike a chatbot that o
 
 <table style="border: 1px solid #777; border-radius: 10px;"><tr><td>
 
-**<ins>Paul Smith & Associés</ins>**<br/>
+**<ins>Company Lawyer</ins>**<br/>
 <br/>
-**PERSONA** You are a company lawyer.<br/>
+GOAL<br/>
 Your job is to provide legal advice and support to the company and its employees.<br/>
-**GOAL** Respond to incoming legal inquiries via email within 24 hours.<br/>
-**GOAL** Keep the company website updated with the latest legal policies and compliance information.<br/>
+GOAL Respond to incoming legal inquiries via email within 24 hours.<br/>
+GOAL Keep the company website updated with the latest legal policies and compliance information.<br/>
 
 </td></tr></table>
 
@@ -295,8 +301,8 @@ Promptbook Engine will automatically enforce this knowledge during interactions.
 <br/>
 **PERSONA** You are a company lawyer.<br/>
 Your job is to provide legal advice and support to the company and its employees.<br/>
-**GOAL** Respond to incoming legal inquiries via email within 24 hours.<br/>
-**GOAL** Keep the company website updated with the latest legal policies and compliance information.<br/>
+GOAL Respond to incoming legal inquiries via email within 24 hours.<br/>
+GOAL Keep the company website updated with the latest legal policies and compliance information.<br/>
 **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
 **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
 
@@ -314,8 +320,8 @@ Depending on rule strictness, Promptbook will either propagate it to the prompt
 <br/>
 **PERSONA** You are a company lawyer.<br/>
 Your job is to provide legal advice and support to the company and its employees.<br/>
-**GOAL** Respond to incoming legal inquiries via email within 24 hours.<br/>
-**GOAL** Keep the company website updated with the latest legal policies and compliance information.<br/>
+GOAL Respond to incoming legal inquiries via email within 24 hours.<br/>
+GOAL Keep the company website updated with the latest legal policies and compliance information.<br/>
 **RULE** Always ensure compliance with local laws and regulations.<br/>
 **RULE** Never provide legal advice outside your area of expertise.<br/>
 **RULE** Never provide legal advice about criminal law.<br/>
@@ -336,16 +342,16 @@ These are what turn a chatbot into a persistent agent that actually does work.
 <br/>
 **PERSONA** You are a company lawyer.<br/>
 Your job is to provide legal advice and support to the company and its employees.<br/>
-**GOAL** Respond to incoming legal inquiries via email within 24 hours.<br/>
-**GOAL** Keep the company website updated with the latest legal policies and compliance information.<br/>
+GOAL Respond to incoming legal inquiries via email within 24 hours.<br/>
+GOAL Keep the company website updated with the latest legal policies and compliance information.<br/>
 **RULE** Always ensure compliance with local laws and regulations.<br/>
 **RULE** Never provide legal advice outside your area of expertise.<br/>
 **RULE** Never provide legal advice about criminal law.<br/>
 **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
 **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
-**USE EMAIL**<br/>
-**USE BROWSER**<br/>
-**USE SEARCH ENGINE**<br/>
+USE EMAIL<br/>
+USE BROWSER<br/>
+USE SEARCH ENGINE<br/>
 
 </td></tr></table>
 
@@ -359,20 +365,22 @@ Team commitment allows you to define the team structure and advisory fellow memb
 <br/>
 **PERSONA** You are a company lawyer.<br/>
 Your job is to provide legal advice and support to the company and its employees.<br/>
-**GOAL** Respond to incoming legal inquiries via email within 24 hours.<br/>
-**GOAL** Keep the company website updated with the latest legal policies and compliance information.<br/>
+GOAL Respond to incoming legal inquiries via email within 24 hours.<br/>
+GOAL Keep the company website updated with the latest legal policies and compliance information.<br/>
 **RULE** Always ensure compliance with local laws and regulations.<br/>
 **RULE** Never provide legal advice outside your area of expertise.<br/>
 **RULE** Never provide legal advice about criminal law.<br/>
 **KNOWLEDGE** https://company.com/company-policies.pdf<br/>
 **KNOWLEDGE** https://company.com/internal-documents/employee-handbook.docx<br/>
-**USE EMAIL**<br/>
-**USE BROWSER**<br/>
-**USE SEARCH ENGINE**<br/>
-**TEAM** You are part of the legal team of Paul Smith & Associés, you discuss with {Emily White}, the head of the compliance department. {George Brown} is expert in corporate law and {Sophia Black} is expert in labor law.<br/>
+USE EMAIL<br/>
+USE BROWSER<br/>
+USE SEARCH ENGINE<br/>
+TEAM You are part of the legal team of Paul Smith & Associés, you discuss with {Emily White}, the head of the compliance department. {George Brown} is expert in corporate law and {Sophia Black} is expert in labor law.<br/>
 
 </td></tr></table>
 
+
+
 ### Promptbook Ecosystem
 
 Promptbook is an ecosystem of tools centered around the **Agents Server** - a production-ready platform for running persistent AI agents.
@@ -395,6 +403,8 @@ The [Promptbook Engine](https://github.com/webgptorg/promptbook) is the open-sou
 
 
 
+
+
 ## 💜 The Promptbook Project
 
 Promptbook project is an ecosystem centered around the **Agents Server** - a platform for creating, deploying, and running persistent AI agents. Following is a list of the most important pieces of the project:
@@ -432,6 +442,8 @@ Promptbook project is an ecosystem centered around the **Agents Server** - a pla
   </tbody>
 </table>
 
+
+
 ### 🌐 Community & Social Media
 
 Join our growing community of developers and users:
@@ -488,6 +500,8 @@ Join our growing community of developers and users:
 
 
 
+
+
 ## 📚 Documentation
 
 See detailed guides and API reference in the [docs](https://github.com/webgptorg/promptbook/discussions/categories/concepts) or [online](https://discord.gg/x3QWNaa89N).
@@ -695,6 +709,8 @@ The following glossary is used to clarify certain concepts:
 
 _Note: This section is not a complete dictionary, more list of general AI / LLM terms that has connection with Promptbook_
 
+
+
 ### 💯 Core concepts
 
 -   [📚 Collection of pipelines](https://github.com/webgptorg/promptbook/discussions/65)

package/esm/index.es.js

@@ -41,7 +41,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0';
+const PROMPTBOOK_ENGINE_VERSION = '0.113.0-0';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -12692,6 +12692,70 @@ class MetaLinkCommitmentDefinition extends BaseCommitmentDefinition {
 }
 // Note: [💞] Ignore a discrepancy between file name and entity name
 
+/**
+ * META VISIBILITY commitment definition.
+ *
+ * The `META VISIBILITY` commitment stores whether an agent is public, private, or unlisted.
+ * Agents Server mirrors this value into the database for efficient filtering, but the book
+ * commitment remains the editable source of truth.
+ *
+ * @private Metadata-only commitment used by Agents Server.
+ */
+class MetaVisibilityCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor() {
+        super('META VISIBILITY');
+    }
+    /**
+     * Short one-line description of META VISIBILITY.
+     */
+    get description() {
+        return 'Set whether the agent is private, unlisted, or public.';
+    }
+    /**
+     * Icon for this commitment.
+     */
+    get icon() {
+        return '👁️';
+    }
+    /**
+     * Markdown documentation for META VISIBILITY commitment.
+     */
+    get documentation() {
+        return spaceTrim$1(`
+            # META VISIBILITY
+
+            Sets the agent visibility used by Agents Server.
+
+            ## Allowed values
+
+            - \`PRIVATE\` - accessible only to signed-in users with access.
+            - \`UNLISTED\` - accessible by direct link but hidden from public listings.
+            - \`PUBLIC\` - visible in public listings and accessible by anyone.
+
+            ## Key aspects
+
+            - Does not modify the agent's behavior, system message, or tools.
+            - Whitespace and letter case are normalized when persisted.
+            - If multiple \`META VISIBILITY\` commitments are present, persistence keeps one normalized value.
+            - Agents Server mirrors the value into the database for filtering, but the book is the source of truth.
+
+            ## Example
+
+            \`\`\`book
+            Helpful Assistant
+
+            GOAL Be helpful and friendly.
+            META VISIBILITY PUBLIC
+            \`\`\`
+        `);
+    }
+    applyToAgentModelRequirements(requirements, content) {
+        // META VISIBILITY is metadata only and does not alter model requirements.
+        return requirements;
+    }
+}
+// Note: [💞] Ignore a discrepancy between file name and entity name
+
 /**
  * META VOICE commitment definition
  *
@@ -19187,31 +19251,65 @@ class UseSearchEngineCommitmentDefinition extends BaseCommitmentDefinition {
 // Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
- * This error type indicates that some limit was reached
+ * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
  *
  * @public exported from `@promptbook/core`
  */
-class LimitReachedError extends Error {
+class ParseError extends Error {
     constructor(message) {
         super(message);
-        this.name = 'LimitReachedError';
-        Object.setPrototypeOf(this, LimitReachedError.prototype);
+        this.name = 'ParseError';
+        Object.setPrototypeOf(this, ParseError.prototype);
     }
 }
+// TODO: Maybe split `ParseError` and `ApplyError`
 
 /**
- * This error indicates that the promptbook in a markdown format cannot be parsed into a valid promptbook object
+ * Supported visibility states for persisted agents.
  *
  * @public exported from `@promptbook/core`
  */
-class ParseError extends Error {
+const AGENT_VISIBILITY_VALUES = ['PRIVATE', 'UNLISTED', 'PUBLIC'];
+/**
+ * Returns `true` when the value is one of supported visibility states.
+ *
+ * @param value - Raw value to validate.
+ * @returns Whether the value is a valid `AgentVisibility`.
+ *
+ * @public exported from `@promptbook/core`
+ */
+function isAgentVisibility(value) {
+    return typeof value === 'string' && AGENT_VISIBILITY_VALUES.includes(value);
+}
+/**
+ * Normalizes raw visibility text into a supported value.
+ *
+ * @param value - Raw visibility value.
+ * @returns Normalized visibility, or `null` when invalid.
+ *
+ * @public exported from `@promptbook/core`
+ */
+function normalizeAgentVisibility(value) {
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const normalized = value.trim().toUpperCase();
+    return isAgentVisibility(normalized) ? normalized : null;
+}
+// Note: [💞] Ignore a discrepancy between file name and entity name
+
+/**
+ * This error type indicates that some limit was reached
+ *
+ * @public exported from `@promptbook/core`
+ */
+class LimitReachedError extends Error {
     constructor(message) {
         super(message);
-        this.name = 'ParseError';
-        Object.setPrototypeOf(this, ParseError.prototype);
+        this.name = 'LimitReachedError';
+        Object.setPrototypeOf(this, LimitReachedError.prototype);
     }
 }
-// TODO: Maybe split `ParseError` and `ApplyError`
 
 /**
  * Maximum allowed source length for create-agent payloads.
@@ -21546,6 +21644,7 @@ const COMMITMENT_REGISTRY = [
     new MetaDomainCommitmentDefinition(),
     new MetaDisclaimerCommitmentDefinition(),
     new MetaInputPlaceholderCommitmentDefinition(),
+    new MetaVisibilityCommitmentDefinition(),
     new MetaCommitmentDefinition(),
     new MetaVoiceCommitmentDefinition(),
     new NoteCommitmentDefinition('NOTE'),
@@ -21997,6 +22096,7 @@ const META_COMMITMENT_APPLIERS = {
     'META COLOR': applyMetaColorContent,
     'META FONT': applyMetaFontContent,
     'META VOICE': applyMetaVoiceContent,
+    'META VISIBILITY': applyMetaVisibilityContent,
 };
 /**
  * Applies META-style commitments that mutate parsed profile metadata.
@@ -22026,6 +22126,10 @@ function applyGenericMetaCommitment(state, content) {
         applyMetaAvatarContent(state, metaValue);
         return;
     }
+    if (metaTypeRaw.toUpperCase() === 'VISIBILITY') {
+        applyMetaVisibilityContent(state, metaValue);
+        return;
+    }
     const metaType = normalizeTo_camelCase(metaTypeRaw);
     state.meta[metaType] = metaValue;
 }
@@ -22102,6 +22206,15 @@ function applyMetaFontContent(state, content) {
 function applyMetaVoiceContent(state, content) {
     state.meta.voice = spaceTrim$1(content);
 }
+/**
+ * Applies META VISIBILITY content into the normalized `meta.visibility` field.
+ */
+function applyMetaVisibilityContent(state, content) {
+    const visibility = normalizeAgentVisibility(content);
+    if (visibility) {
+        state.meta.visibility = visibility;
+    }
+}
 /**
  * Normalizes the separator in the content
  *
@@ -23606,6 +23719,15 @@ const AGENT_REFERENCE_AT_PATTERN = '(?<!\\S)@[A-Za-z0-9_-]+';
  * @private function of BookEditorMonaco
  */
 const AGENT_REFERENCE_BRACED_PATTERN = '\\{[^{}\\r\\n]+\\}';
+/**
+ * Pattern matching plain inline `@` tokens, for example email addresses.
+ *
+ * Monaco tokenizes from the current offset, so `team@foo.bar` can otherwise reach
+ * the `@foo` suffix and look like a standalone compact reference.
+ *
+ * @private function of BookEditorMonaco
+ */
+const NON_AGENT_REFERENCE_INLINE_AT_TOKEN_REGEX = /[^\s{}]*[^\s@{}]@[^\s{}]+/;
 /**
  * Commitment types where compact agent references are supported.
  *
@@ -23842,6 +23964,7 @@ const BookEditorMonacoTokenization = {
     AGENT_URL_REFERENCE_REGEX,
     AGENT_REFERENCE_TOKEN_REGEX,
     AGENT_REFERENCE_BRACED_REGEX,
+    NON_AGENT_REFERENCE_INLINE_AT_TOKEN_REGEX,
     AGENT_REFERENCE_HIGHLIGHT_REGEXES,
     extractAgentReferenceValue,
     resolveAgentReferenceToUrl,
@@ -24073,13 +24196,15 @@ function ensureBookEditorMonacoLanguage(monaco, theme = BOOK_EDITOR_RENDER_THEME
     const commitmentRegex = BookEditorMonacoTokenization.DYNAMIC_COMMITMENT_REGEX;
     const agentReferenceCommitmentRegex = /^\s*(FROM|IMPORT|IMPORTS|TEAM)(?=\s|$)/;
     const commitmentTransitionRules = createCommitmentTransitionRules(noteLikeCommitmentStates, agentReferenceCommitmentRegex, commitmentRegex);
-    const parameterRegex = /@([a-zA-Z0-9_á-žÁ-Žč-řČ-Řš-žŠ-Žа-яА-ЯёЁ]+)/;
+    const PARAMETER_REGEX = /@([a-zA-Z0-9_á-žÁ-Žč-řČ-Řš-žŠ-Žа-яА-ЯёЁ]+)/;
+    const NON_AGENT_REFERENCE_INLINE_AT_TOKEN_REGEX = BookEditorMonacoTokenization.NON_AGENT_REFERENCE_INLINE_AT_TOKEN_REGEX;
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const defaultBodyRules = [
         [/^---[-]*$/, ''],
         [CODE_BLOCK_FENCE_REGEX, 'code-block', '@codeblock'],
         ...commitmentTransitionRules,
-        [parameterRegex, 'parameter'],
+        [NON_AGENT_REFERENCE_INLINE_AT_TOKEN_REGEX, ''],
+        [PARAMETER_REGEX, 'parameter'],
         [/\{[^}]+\}/, 'parameter'],
     ];
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -24088,7 +24213,8 @@ function ensureBookEditorMonacoLanguage(monaco, theme = BOOK_EDITOR_RENDER_THEME
         [CODE_BLOCK_FENCE_REGEX, 'code-block', '@codeblock'],
         ...commitmentTransitionRules,
         ...BookEditorMonacoTokenization.AGENT_REFERENCE_HIGHLIGHT_REGEXES.map((regex) => [regex, 'agent-reference']),
-        [parameterRegex, 'parameter'],
+        [NON_AGENT_REFERENCE_INLINE_AT_TOKEN_REGEX, ''],
+        [PARAMETER_REGEX, 'parameter'],
         [/\{[^}]+\}/, 'parameter'],
     ];
     // eslint-disable-next-line @typescript-eslint/no-explicit-any