@promptbook/node 0.111.0-10 → 0.111.0-11

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

@@ -82,6 +82,7 @@ export type AgentBasicInformation = {
         disclaimer?: string;
         messageSuffix?: string;
         image?: string_url_image;
+        domain?: string;
         font?: string_fonts;
         color?: string_color;
         voice?: string;

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

@@ -6,6 +6,7 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  * The META commitment handles all meta-information about the agent such as:
  * - META IMAGE: Sets the agent's avatar/profile image URL
  * - META LINK: Provides profile/source links for the person the agent models
+ * - META DOMAIN: Sets the canonical custom domain/host of the agent
  * - META TITLE: Sets the agent's display title
  * - META DESCRIPTION: Sets the agent's description
  * - META [ANYTHING]: Any other meta information in uppercase format
@@ -18,6 +19,7 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  * ```book
  * META IMAGE https://example.com/avatar.jpg
  * META LINK https://twitter.com/username
+ * META DOMAIN my-agent.com
  * META TITLE Professional Assistant
  * META DESCRIPTION An AI assistant specialized in business tasks
  * META AUTHOR John Doe

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

@@ -0,0 +1,33 @@
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * META DOMAIN commitment definition
+ *
+ * The `META DOMAIN` commitment sets the canonical host/domain of the agent.
+ * This commitment is metadata-only and does not modify model requirements.
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class MetaDomainCommitmentDefinition extends BaseCommitmentDefinition<'META DOMAIN'> {
+    constructor();
+    /**
+     * Short one-line description of META DOMAIN.
+     */
+    get description(): string;
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string;
+    /**
+     * Markdown documentation for META DOMAIN commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+    /**
+     * Extracts the domain value from commitment content.
+     */
+    extractDomain(content: string): string | null;
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

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

@@ -17,6 +17,7 @@ import { UserMessageCommitmentDefinition } from './MESSAGE/UserMessageCommitment
 import { MessageSuffixCommitmentDefinition } from './MESSAGE_SUFFIX/MESSAGE_SUFFIX';
 import { MetaCommitmentDefinition } from './META/META';
 import { MetaColorCommitmentDefinition } from './META_COLOR/META_COLOR';
+import { MetaDomainCommitmentDefinition } from './META_DOMAIN/META_DOMAIN';
 import { MetaDisclaimerCommitmentDefinition } from './META_DISCLAIMER/META_DISCLAIMER';
 import { MetaFontCommitmentDefinition } from './META_FONT/META_FONT';
 import { MetaImageCommitmentDefinition } from './META_IMAGE/META_IMAGE';
@@ -48,7 +49,7 @@ 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, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, TemplateCommitmentDefinition, TemplateCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaDisclaimerCommitmentDefinition, MetaCommitmentDefinition, MetaVoiceCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageSuffixCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, TeamCommitmentDefinition, UseBrowserCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseTimeCommitmentDefinition, UseUserLocationCommitmentDefinition, UseEmailCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseMcpCommitmentDefinition, UseCommitmentDefinition, 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, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, TemplateCommitmentDefinition, TemplateCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaDomainCommitmentDefinition, MetaDisclaimerCommitmentDefinition, MetaCommitmentDefinition, MetaVoiceCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageSuffixCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, TeamCommitmentDefinition, UseBrowserCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseTimeCommitmentDefinition, UseUserLocationCommitmentDefinition, UseEmailCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseMcpCommitmentDefinition, UseCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
 /**
  * TODO: [🧠] Maybe create through standardized $register
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/esm/src/utils/validators/url/normalizeDomainForMatching.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Normalizes a domain-like string into a comparable hostname form.
+ *
+ * The returned value is lowercased and stripped to hostname only
+ * (protocol, path, query, hash, and port are removed).
+ *
+ * @param rawDomain - Raw domain value (for example `my-agent.com` or `https://my-agent.com/path`).
+ * @returns Normalized hostname or `null` when the value cannot be normalized.
+ * @private utility for host/domain matching
+ */
+export declare function normalizeDomainForMatching(rawDomain: string): string | null;

package/esm/src/utils/validators/url/normalizeDomainForMatching.test.d.ts

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

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.111.0-9`).
+ * It follows semantic versioning (e.g., `0.111.0-10`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/node",
-    "version": "0.111.0-10",
+    "version": "0.111.0-11",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,
@@ -96,7 +96,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/node.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.111.0-10"
+        "@promptbook/core": "0.111.0-11"
     },
     "dependencies": {
         "@mozilla/readability": "0.6.0",

package/umd/index.umd.js

@@ -48,7 +48,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.111.0-10';
+    const PROMPTBOOK_ENGINE_VERSION = '0.111.0-11';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -16051,6 +16051,7 @@
      * The META commitment handles all meta-information about the agent such as:
      * - META IMAGE: Sets the agent's avatar/profile image URL
      * - META LINK: Provides profile/source links for the person the agent models
+     * - META DOMAIN: Sets the canonical custom domain/host of the agent
      * - META TITLE: Sets the agent's display title
      * - META DESCRIPTION: Sets the agent's description
      * - META [ANYTHING]: Any other meta information in uppercase format
@@ -16063,6 +16064,7 @@
      * ```book
      * META IMAGE https://example.com/avatar.jpg
      * META LINK https://twitter.com/username
+     * META DOMAIN my-agent.com
      * META TITLE Professional Assistant
      * META DESCRIPTION An AI assistant specialized in business tasks
      * META AUTHOR John Doe
@@ -16100,6 +16102,7 @@
 
             - **META IMAGE** - Sets the agent's avatar/profile image URL
             - **META LINK** - Provides profile/source links for the person the agent models
+            - **META DOMAIN** - Sets the canonical custom domain/host of the agent
             - **META TITLE** - Sets the agent's display title
             - **META DESCRIPTION** - Sets the agent's description
             - **META [ANYTHING]** - Any other meta information in uppercase format
@@ -16286,6 +16289,73 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
+    /**
+     * META DOMAIN commitment definition
+     *
+     * The `META DOMAIN` commitment sets the canonical host/domain of the agent.
+     * This commitment is metadata-only and does not modify model requirements.
+     *
+     * @private [🪔] Maybe export the commitments through some package
+     */
+    class MetaDomainCommitmentDefinition extends BaseCommitmentDefinition {
+        constructor() {
+            super('META DOMAIN', ['DOMAIN']);
+        }
+        /**
+         * Short one-line description of META DOMAIN.
+         */
+        get description() {
+            return "Set the agent's canonical domain/host.";
+        }
+        /**
+         * Icon for this commitment.
+         */
+        get icon() {
+            return '🌐';
+        }
+        /**
+         * Markdown documentation for META DOMAIN commitment.
+         */
+        get documentation() {
+            return spaceTrim$1.spaceTrim(`
+            # META DOMAIN
+
+            Sets the canonical domain (host) of the agent, for example a custom domain that should open this agent directly.
+
+            ## Key aspects
+
+            - Does not modify the agent's behavior or responses.
+            - Used by server routing to map incoming hostnames to this agent.
+            - If multiple \`META DOMAIN\` commitments are specified, the last one takes precedence.
+            - Prefer hostname-only values such as \`my-agent.com\`.
+
+            ## Examples
+
+            \`\`\`book
+            My agent
+
+            PERSONA My agent is an expert in something.
+            META DOMAIN my-agent.com
+            \`\`\`
+        `);
+        }
+        applyToAgentModelRequirements(requirements, content) {
+            // META DOMAIN does not modify the model requirements.
+            // It is consumed by profile parsing and server routing.
+            return requirements;
+        }
+        /**
+         * Extracts the domain value from commitment content.
+         */
+        extractDomain(content) {
+            const trimmedContent = content.trim();
+            return trimmedContent || null;
+        }
+    }
+    /**
+     * Note: [💞] Ignore a discrepancy between file name and entity name
+     */
+
     /**
      * META DISCLAIMER commitment definition
      *
@@ -19644,6 +19714,7 @@
         new MetaColorCommitmentDefinition(),
         new MetaFontCommitmentDefinition(),
         new MetaLinkCommitmentDefinition(),
+        new MetaDomainCommitmentDefinition(),
         new MetaDisclaimerCommitmentDefinition(),
         new MetaCommitmentDefinition(),
         new MetaVoiceCommitmentDefinition(),
@@ -21576,6 +21647,42 @@
         return normalizeAgentName(`Agent ${agentHash.substring(0, LIMITS.SHORT_NAME_LENGTH)}`);
     }
 
+    /**
+     * Normalizes a domain-like string into a comparable hostname form.
+     *
+     * The returned value is lowercased and stripped to hostname only
+     * (protocol, path, query, hash, and port are removed).
+     *
+     * @param rawDomain - Raw domain value (for example `my-agent.com` or `https://my-agent.com/path`).
+     * @returns Normalized hostname or `null` when the value cannot be normalized.
+     * @private utility for host/domain matching
+     */
+    function normalizeDomainForMatching(rawDomain) {
+        const trimmedDomain = rawDomain.trim();
+        if (!trimmedDomain) {
+            return null;
+        }
+        const candidateUrl = hasHttpProtocol(trimmedDomain) ? trimmedDomain : `https://${trimmedDomain}`;
+        try {
+            const parsedUrl = new URL(candidateUrl);
+            const normalizedHostname = parsedUrl.hostname.trim().toLowerCase();
+            return normalizedHostname || null;
+        }
+        catch (_a) {
+            return null;
+        }
+    }
+    /**
+     * Checks whether the value already includes an HTTP(S) protocol prefix.
+     *
+     * @param value - Raw value to inspect.
+     * @returns True when the value starts with `http://` or `https://`.
+     * @private utility for host/domain matching
+     */
+    function hasHttpProtocol(value) {
+        return value.startsWith('http://') || value.startsWith('https://');
+    }
+
     /**
      * Regex pattern to match horizontal lines (markdown thematic breaks)
      * Matches 3 or more hyphens, underscores, or asterisks (with optional spaces between)
@@ -22060,6 +22167,10 @@
                 meta.link = linkValue;
                 continue;
             }
+            if (commitment.type === 'META DOMAIN') {
+                meta.domain = normalizeMetaDomain(commitment.content);
+                continue;
+            }
             if (commitment.type === 'META IMAGE') {
                 meta.image = spaceTrim__default["default"](commitment.content);
                 continue;
@@ -22134,6 +22245,16 @@
         }
         return trimmed.split(/\s+/).join(', ');
     }
+    /**
+     * Normalizes META DOMAIN content to a hostname-like value when possible.
+     *
+     * @param content - Raw META DOMAIN content.
+     * @returns Normalized domain or a trimmed fallback.
+     */
+    function normalizeMetaDomain(content) {
+        const trimmed = spaceTrim__default["default"](content);
+        return normalizeDomainForMatching(trimmed) || trimmed.toLowerCase();
+    }
     /**
      * TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
      */