@promptbook/core 0.101.0-7 → 0.101.0-8

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

@@ -1,6 +1,7 @@
 import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
 import { createAgentModelRequirements } from '../book-2.0/agent-source/createAgentModelRequirements';
 import { parseAgentSource } from '../book-2.0/agent-source/parseAgentSource';
+import { parseParameters } from '../book-2.0/agent-source/parseParameters';
 import { isValidBook } from '../book-2.0/agent-source/string_book';
 import { validateBook } from '../book-2.0/agent-source/string_book';
 import { DEFAULT_BOOK } from '../book-2.0/agent-source/string_book';
@@ -166,6 +167,7 @@ import { REMOTE_SERVER_URLS } from '../../servers';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
 export { createAgentModelRequirements };
 export { parseAgentSource };
+export { parseParameters };
 export { isValidBook };
 export { validateBook };
 export { DEFAULT_BOOK };

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

@@ -1,3 +1,4 @@
+import type { BookParameter } 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 { string_book } from '../book-2.0/agent-source/string_book';
@@ -322,6 +323,7 @@ import type { CheckSerializableAsJsonOptions } from '../utils/serialization/chec
 import type { ExportJsonOptions } from '../utils/serialization/exportJson';
 import type { ITakeChain } from '../utils/take/interfaces/ITakeChain';
 import type { string_promptbook_version } from '../version';
+export type { BookParameter };
 export type { AgentBasicInformation };
 export type { AgentModelRequirements };
 export type { string_book };

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

@@ -1,4 +1,28 @@
 import type { string_agent_name, string_url_image } from '../../types/typeAliases';
+/**
+ * Unified parameter representation that supports two different notations:
+ * 1. @Parameter - single word parameter starting with @
+ * 2. {parameterName} or {parameter with multiple words} or {parameterName: description text}
+ * Both notations represent the same syntax feature - parameters
+ */
+export type BookParameter = {
+    /**
+     * The raw text of the parameter as it appears in the source
+     */
+    text: string;
+    /**
+     * The notation used for this parameter
+     */
+    notation: 'at' | 'brace';
+    /**
+     * The parameter name (without @ or {})
+     */
+    name: string;
+    /**
+     * Optional description for {parameterName: description} notation
+     */
+    description?: string;
+};
 export type AgentBasicInformation = {
     /**
      * Name of the agent
@@ -15,6 +39,13 @@ export type AgentBasicInformation = {
      * This is the line starting with "META IMAGE"
      */
     profileImageUrl: string_url_image;
+    /**
+     * Parameters found in the agent source
+     * Supports two different notations for the same syntax feature:
+     * - @Parameter (single word parameter starting with @)
+     * - {parameterName} or {parameter with multiple words} or {parameterName: description text}
+     */
+    parameters: BookParameter[];
 };
 /**
  * TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`

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

@@ -0,0 +1,13 @@
+import type { BookParameter } from './AgentBasicInformation';
+/**
+ * Parses parameters from text using both supported notations:
+ * 1. @Parameter - single word parameter starting with @
+ * 2. {parameterName} or {parameter with multiple words} or {parameterName: description text}
+ *
+ * Both notations represent the same syntax feature - parameters
+ *
+ * @param text - Text to extract parameters from
+ * @returns Array of parsed parameters with unified representation
+ * @public exported from `@promptbook/core`
+ */
+export declare function parseParameters(text: string): BookParameter[];

package/esm/typings/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.101.0-6`).
+ * It follows semantic versioning (e.g., `0.101.0-7`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/core",
-    "version": "0.101.0-7",
+    "version": "0.101.0-8",
     "description": "Promptbook: Run AI apps in plain human language across multiple models and platforms",
     "private": false,
     "sideEffects": false,

package/umd/index.umd.js

@@ -26,7 +26,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.101.0-7';
+    const PROMPTBOOK_ENGINE_VERSION = '0.101.0-8';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -2232,6 +2232,64 @@
         return generateGravatarUrl(agentName);
     }
 
+    /**
+     * Parses parameters from text using both supported notations:
+     * 1. @Parameter - single word parameter starting with @
+     * 2. {parameterName} or {parameter with multiple words} or {parameterName: description text}
+     *
+     * Both notations represent the same syntax feature - parameters
+     *
+     * @param text - Text to extract parameters from
+     * @returns Array of parsed parameters with unified representation
+     * @public exported from `@promptbook/core`
+     */
+    function parseParameters(text) {
+        const parameters = [];
+        // [🧠] Parameter syntax parsing - unified approach for two different notations of the same syntax feature
+        // The Book language supports parameters in two different notations but they represent the same concept
+        // Extract @Parameter notation (single word parameters starting with @)
+        const atParameterRegex = /@[\w\u00C0-\u017F\u0100-\u024F\u1E00-\u1EFF]+/gim;
+        text.replace(atParameterRegex, (match) => {
+            const parameterName = match.slice(1); // Remove the @ symbol
+            parameters.push({
+                text: match,
+                notation: 'at',
+                name: parameterName,
+            });
+            return match;
+        });
+        // Extract {parameter} notation (parameters in braces)
+        const braceParameterRegex = /\{([^}]+)\}/gim;
+        text.replace(braceParameterRegex, (match, content) => {
+            // Check if the parameter has a description (parameterName: description)
+            const colonIndex = content.indexOf(':');
+            if (colonIndex !== -1) {
+                const name = content.substring(0, colonIndex).trim();
+                const description = content.substring(colonIndex + 1).trim();
+                parameters.push({
+                    text: match,
+                    notation: 'brace',
+                    name,
+                    description,
+                });
+            }
+            else {
+                // Simple parameter without description
+                parameters.push({
+                    text: match,
+                    notation: 'brace',
+                    name: content.trim(),
+                });
+            }
+            return match;
+        });
+        // Remove duplicates based on name (keep the first occurrence)
+        const uniqueParameters = parameters.filter((param, index, array) => {
+            return array.findIndex(p => p.name === param.name) === index;
+        });
+        return uniqueParameters;
+    }
+
     /**
      * Parses basic information from agent source
      *
@@ -2258,10 +2316,14 @@
         if (!profileImageUrl) {
             profileImageUrl = generatePlaceholderAgentProfileImageUrl(parseResult.agentName || '!!');
         }
+        // Parse parameters using unified approach - both @Parameter and {parameter} notations
+        // are treated as the same syntax feature with unified representation
+        const parameters = parseParameters(agentSource);
         return {
             agentName: parseResult.agentName,
             personaDescription,
             profileImageUrl,
+            parameters,
         };
     }
     /**
@@ -14724,6 +14786,7 @@
     exports.makeKnowledgeSourceHandler = makeKnowledgeSourceHandler;
     exports.migratePipeline = migratePipeline;
     exports.parseAgentSource = parseAgentSource;
+    exports.parseParameters = parseParameters;
     exports.parsePipeline = parsePipeline;
     exports.pipelineJsonToString = pipelineJsonToString;
     exports.prepareKnowledgePieces = prepareKnowledgePieces;