@promptbook/components 0.112.0 → 0.113.0-0

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

@@ -1,4 +1,15 @@
 import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
+import { AGENT_VISIBILITY_VALUES } from '../book-2.0/agent-source/agentSourceVisibility';
+import type { AgentVisibility } from '../book-2.0/agent-source/agentSourceVisibility';
+import { DEFAULT_AGENT_VISIBILITY } from '../book-2.0/agent-source/agentSourceVisibility';
+import { isAgentVisibility } from '../book-2.0/agent-source/agentSourceVisibility';
+import { normalizeAgentVisibility } from '../book-2.0/agent-source/agentSourceVisibility';
+import { parseAgentVisibility } from '../book-2.0/agent-source/agentSourceVisibility';
+import { parseAgentVisibilityStrict } from '../book-2.0/agent-source/agentSourceVisibility';
+import { parseAgentSourceVisibility } from '../book-2.0/agent-source/agentSourceVisibility';
+import { isPublicAgentVisibility } from '../book-2.0/agent-source/agentSourceVisibility';
+import { getNextAgentVisibility } from '../book-2.0/agent-source/agentSourceVisibility';
+import { setAgentSourceVisibility } from '../book-2.0/agent-source/agentSourceVisibility';
 import { computeAgentHash } from '../book-2.0/agent-source/computeAgentHash';
 import { createAgentModelRequirements } from '../book-2.0/agent-source/createAgentModelRequirements';
 import type { CreateAgentModelRequirementsOptions } from '../book-2.0/agent-source/CreateAgentModelRequirementsOptions';
@@ -224,6 +235,17 @@ import { $generateBookBoilerplate } from '../utils/random/$generateBookBoilerpla
 import { CORE_AGENTS_SERVER_WELL_KNOWN_AGENT_NAMES } from '../../servers';
 import { PUBLIC_AGENTS_SERVERS } from '../../servers';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
+export { AGENT_VISIBILITY_VALUES };
+export type { AgentVisibility };
+export { DEFAULT_AGENT_VISIBILITY };
+export { isAgentVisibility };
+export { normalizeAgentVisibility };
+export { parseAgentVisibility };
+export { parseAgentVisibilityStrict };
+export { parseAgentSourceVisibility };
+export { isPublicAgentVisibility };
+export { getNextAgentVisibility };
+export { setAgentSourceVisibility };
 export { computeAgentHash };
 export { createAgentModelRequirements };
 export type { CreateAgentModelRequirementsOptions };

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

@@ -2,6 +2,7 @@ import type { BookParameter } from '../book-2.0/agent-source/AgentBasicInformati
 import type { AgentCapability } from '../book-2.0/agent-source/AgentBasicInformation';
 import type { AgentBasicInformation } from '../book-2.0/agent-source/AgentBasicInformation';
 import type { AgentModelRequirements } from '../book-2.0/agent-source/AgentModelRequirements';
+import type { AgentVisibility } from '../book-2.0/agent-source/agentSourceVisibility';
 import type { CreateAgentModelRequirementsOptions } from '../book-2.0/agent-source/CreateAgentModelRequirementsOptions';
 import type { string_book } from '../book-2.0/agent-source/string_book';
 import type { BookNodeAgentSource } from '../book-3.0/BookNodeAgentSource';
@@ -444,6 +445,7 @@ export type { BookParameter };
 export type { AgentCapability };
 export type { AgentBasicInformation };
 export type { AgentModelRequirements };
+export type { AgentVisibility };
 export type { CreateAgentModelRequirementsOptions };
 export type { string_book };
 export type { BookNodeAgentSource };

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

@@ -4,6 +4,7 @@ import type { string_agent_url } from '../../types/string_agent_url';
 import type { string_fonts } from '../../types/string_markdown';
 import type { string_color } from '../../types/string_person_fullname';
 import type { string_url_image } from '../../types/string_url_image';
+import type { AgentVisibility } from './agentSourceVisibility';
 /**
  * Unified parameter representation that supports two different notations:
  * 1. @Parameter - single word parameter starting with @
@@ -97,6 +98,7 @@ export type AgentBasicInformation = {
         font?: string_fonts;
         color?: string_color;
         voice?: string;
+        visibility?: AgentVisibility;
         [key: string]: string | undefined;
     };
     /**

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

@@ -0,0 +1,97 @@
+import type { string_book } from './string_book';
+/**
+ * Supported visibility states for persisted agents.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const AGENT_VISIBILITY_VALUES: readonly ["PRIVATE", "UNLISTED", "PUBLIC"];
+/**
+ * Canonical visibility union for agents.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export type AgentVisibility = (typeof AGENT_VISIBILITY_VALUES)[number];
+/**
+ * Fallback visibility used when no valid value is configured.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const DEFAULT_AGENT_VISIBILITY: AgentVisibility;
+/**
+ * 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`
+ */
+export declare function isAgentVisibility(value: unknown): value is AgentVisibility;
+/**
+ * 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`
+ */
+export declare function normalizeAgentVisibility(value: unknown): AgentVisibility | null;
+/**
+ * Parses visibility from an unknown value with a safe fallback.
+ *
+ * @param value - Raw visibility value.
+ * @param fallback - Fallback when the value is invalid.
+ * @returns Parsed visibility.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function parseAgentVisibility(value: unknown, fallback?: AgentVisibility): AgentVisibility;
+/**
+ * Parses visibility and throws when the value is not supported.
+ *
+ * @param value - Raw visibility value.
+ * @param sourceLabel - Human-readable source used in the error message.
+ * @returns Parsed visibility.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function parseAgentVisibilityStrict(value: unknown, sourceLabel?: string): AgentVisibility;
+/**
+ * Extracts the last `META VISIBILITY` value from an agent source.
+ *
+ * @param agentSource - Raw book source.
+ * @param options - Strict parsing options.
+ * @returns Normalized visibility, or `null` when no commitment is present.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function parseAgentSourceVisibility(agentSource: string_book, options?: {
+    readonly isStrict?: boolean;
+}): AgentVisibility | null;
+/**
+ * Returns whether an agent should be listed publicly in anonymous views.
+ *
+ * @param visibility - Agent visibility to evaluate.
+ * @returns `true` for publicly listed agents.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function isPublicAgentVisibility(visibility: AgentVisibility | null | undefined): boolean;
+/**
+ * Returns the next visibility in UI rotation order.
+ *
+ * @param visibility - Current visibility.
+ * @returns Next visibility value.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function getNextAgentVisibility(visibility: AgentVisibility | null | undefined): AgentVisibility;
+/**
+ * Inserts or replaces the `META VISIBILITY` commitment in a book source.
+ *
+ * @param agentSource - Raw book source.
+ * @param visibility - Visibility to persist.
+ * @returns Source with exactly one normalized `META VISIBILITY` line.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function setAgentSourceVisibility(agentSource: string_book, visibility: AgentVisibility): string_book;

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

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

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

@@ -19,6 +19,7 @@ export declare const BookEditorMonacoTokenization: {
     AGENT_URL_REFERENCE_REGEX: RegExp;
     AGENT_REFERENCE_TOKEN_REGEX: RegExp;
     AGENT_REFERENCE_BRACED_REGEX: RegExp;
+    NON_AGENT_REFERENCE_INLINE_AT_TOKEN_REGEX: RegExp;
     AGENT_REFERENCE_HIGHLIGHT_REGEXES: readonly [RegExp, RegExp, RegExp];
     extractAgentReferenceValue: (token: string) => string;
     resolveAgentReferenceToUrl: (referenceValue: string) => string | null;

package/esm/src/cli/cli-commands/agents-server/buildAgentsServer.d.ts

@@ -6,6 +6,12 @@
  * @private internal constant of `ptbk agents-server`
  */
 export declare const PTBK_AGENTS_SERVER_NODE_MODULES_PATH_ENV = "PTBK_AGENTS_SERVER_NODE_MODULES_PATH";
+/**
+ * Environment variable consumed by `apps/agents-server/next.config.ts` to throttle build workers.
+ *
+ * @private internal constant of `ptbk agents-server`
+ */
+export declare const PTBK_AGENTS_SERVER_BUILD_WORKER_COUNT_ENV = "PTBK_AGENTS_SERVER_BUILD_WORKER_COUNT";
 /**
  * Environment variable used only by the CLI-owned production build.
  *

package/esm/src/collection/agent-collection/CreateAgentInput.d.ts

@@ -1,4 +1,5 @@
 import type { string_book } from '../../book-2.0/agent-source/string_book';
+import { type AgentVisibility } from '../../book-2.0/agent-source/agentSourceVisibility';
 import type { LlmToolDefinition } from '../../types/LlmToolDefinition';
 /**
  * Supported visibility options for agent creation.
@@ -11,7 +12,7 @@ export declare const CREATE_AGENT_VISIBILITY_VALUES: readonly ["PRIVATE", "UNLIS
  *
  * @private shared create-agent contract
  */
-export type CreateAgentVisibility = (typeof CREATE_AGENT_VISIBILITY_VALUES)[number];
+export type CreateAgentVisibility = AgentVisibility;
 /**
  * Canonical input payload for creating one persisted agent entity.
  *

package/esm/src/collection/agent-collection/constructors/agent-collection-in-supabase/prepareAgentSourceForPersistence.d.ts

@@ -1,6 +1,22 @@
 import type { AgentBasicInformation } from '../../../../book-2.0/agent-source/AgentBasicInformation';
+import { type AgentVisibility } from '../../../../book-2.0/agent-source/agentSourceVisibility';
 import type { string_book } from '../../../../book-2.0/agent-source/string_book';
 import type { string_agent_permanent_id } from '../../../../types/string_agent_name';
+/**
+ * Options used while preparing a source for persistence.
+ *
+ * @private shared persistence helper for `AgentCollectionInSupabase`
+ */
+export type PrepareAgentSourceForPersistenceOptions = {
+    /**
+     * Visibility value that should be written into the book when present.
+     */
+    readonly visibility?: AgentVisibility | null;
+    /**
+     * Whether `visibility` should replace an existing `META VISIBILITY` commitment.
+     */
+    readonly isVisibilityOverride?: boolean;
+};
 /**
  * Prepared agent source payload ready for database persistence.
  *
@@ -22,6 +38,10 @@ export type PreparedAgentSourceForPersistence = {
      * Permanent id extracted from the original source before stripping `META ID`.
      */
     readonly permanentId: string_agent_permanent_id | undefined;
+    /**
+     * Visibility parsed from the normalized source.
+     */
+    readonly visibility: AgentVisibility | undefined;
 };
 /**
  * Normalizes one agent source before persistence.
@@ -33,4 +53,4 @@ export type PreparedAgentSourceForPersistence = {
  *
  * @private shared persistence helper for `AgentCollectionInSupabase`
  */
-export declare function prepareAgentSourceForPersistence(agentSource: string_book): PreparedAgentSourceForPersistence;
+export declare function prepareAgentSourceForPersistence(agentSource: string_book, options?: PrepareAgentSourceForPersistenceOptions): PreparedAgentSourceForPersistence;

package/esm/src/commitments/META_VISIBILITY/META_VISIBILITY.d.ts

@@ -0,0 +1,27 @@
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * 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.
+ */
+export declare class MetaVisibilityCommitmentDefinition extends BaseCommitmentDefinition<'META VISIBILITY'> {
+    constructor();
+    /**
+     * Short one-line description of META VISIBILITY.
+     */
+    get description(): string;
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string;
+    /**
+     * Markdown documentation for META VISIBILITY commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+}

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

@@ -25,6 +25,7 @@ import { MetaFontCommitmentDefinition } from './META_FONT/META_FONT';
 import { MetaImageCommitmentDefinition } from './META_IMAGE/META_IMAGE';
 import { MetaInputPlaceholderCommitmentDefinition } from './META_INPUT_PLACEHOLDER/META_INPUT_PLACEHOLDER';
 import { MetaLinkCommitmentDefinition } from './META_LINK/META_LINK';
+import { MetaVisibilityCommitmentDefinition } from './META_VISIBILITY/META_VISIBILITY';
 import { MetaVoiceCommitmentDefinition } from './META_VOICE/META_VOICE';
 import { ModelCommitmentDefinition } from './MODEL/MODEL';
 import { NoteCommitmentDefinition } from './NOTE/NOTE';
@@ -61,4 +62,4 @@ import { NotYetImplementedCommitmentDefinition } from './_base/NotYetImplemented
  *
  * @private Use functions to access commitments instead of this array directly
  */
-export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, LanguageCommitmentDefinition, LanguageCommitmentDefinition, WritingSampleCommitmentDefinition, WritingRulesCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, TemplateCommitmentDefinition, TemplateCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaAvatarCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaDomainCommitmentDefinition, MetaDisclaimerCommitmentDefinition, MetaInputPlaceholderCommitmentDefinition, MetaCommitmentDefinition, MetaVoiceCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, InternalMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageSuffixCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, WalletCommitmentDefinition, WalletCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, TeamCommitmentDefinition, UseBrowserCommitmentDefinition, UseDeepSearchCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseSpawnCommitmentDefinition, UseTimeoutCommitmentDefinition, UseTimeCommitmentDefinition, UseUserLocationCommitmentDefinition, UseCalendarCommitmentDefinition, UseEmailCommitmentDefinition, UsePopupCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseMcpCommitmentDefinition, UsePrivacyCommitmentDefinition, UseProjectCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
+export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, LanguageCommitmentDefinition, LanguageCommitmentDefinition, WritingSampleCommitmentDefinition, WritingRulesCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, TemplateCommitmentDefinition, TemplateCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaAvatarCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaDomainCommitmentDefinition, MetaDisclaimerCommitmentDefinition, MetaInputPlaceholderCommitmentDefinition, MetaVisibilityCommitmentDefinition, MetaCommitmentDefinition, MetaVoiceCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, InternalMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageSuffixCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, WalletCommitmentDefinition, WalletCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, TeamCommitmentDefinition, UseBrowserCommitmentDefinition, UseDeepSearchCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseSpawnCommitmentDefinition, UseTimeoutCommitmentDefinition, UseTimeCommitmentDefinition, UseUserLocationCommitmentDefinition, UseCalendarCommitmentDefinition, UseEmailCommitmentDefinition, UsePopupCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseMcpCommitmentDefinition, UsePrivacyCommitmentDefinition, UseProjectCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];

package/esm/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.112.0-140`).
+ * It follows semantic versioning (e.g., `0.112.0`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/components",
-    "version": "0.112.0",
+    "version": "0.113.0-0",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,

package/umd/index.umd.js

@@ -34,7 +34,7 @@
      * @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
@@ -12685,6 +12685,70 @@
     }
     // 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.spaceTrim(`
+            # 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
      *
@@ -19180,31 +19244,65 @@
     // 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.
@@ -21539,6 +21637,7 @@
         new MetaDomainCommitmentDefinition(),
         new MetaDisclaimerCommitmentDefinition(),
         new MetaInputPlaceholderCommitmentDefinition(),
+        new MetaVisibilityCommitmentDefinition(),
         new MetaCommitmentDefinition(),
         new MetaVoiceCommitmentDefinition(),
         new NoteCommitmentDefinition('NOTE'),
@@ -21990,6 +22089,7 @@
         'META COLOR': applyMetaColorContent,
         'META FONT': applyMetaFontContent,
         'META VOICE': applyMetaVoiceContent,
+        'META VISIBILITY': applyMetaVisibilityContent,
     };
     /**
      * Applies META-style commitments that mutate parsed profile metadata.
@@ -22019,6 +22119,10 @@
             applyMetaAvatarContent(state, metaValue);
             return;
         }
+        if (metaTypeRaw.toUpperCase() === 'VISIBILITY') {
+            applyMetaVisibilityContent(state, metaValue);
+            return;
+        }
         const metaType = normalizeTo_camelCase(metaTypeRaw);
         state.meta[metaType] = metaValue;
     }
@@ -22095,6 +22199,15 @@
     function applyMetaVoiceContent(state, content) {
         state.meta.voice = spacetrim.spaceTrim(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
      *
@@ -23599,6 +23712,15 @@
      * @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.
      *
@@ -23835,6 +23957,7 @@
         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,
@@ -24066,13 +24189,15 @@
         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
@@ -24081,7 +24206,8 @@
             [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