@promptbook/browser 0.104.0-17 → 0.104.0-19

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

@@ -1,5 +1,5 @@
 import type { LlmToolDefinition } from '../../types/LlmToolDefinition';
-import type { string_knowledge_source_link } from '../../types/typeAliases';
+import type { string_agent_url, string_knowledge_source_link } from '../../types/typeAliases';
 import type { TODO_any } from '../../utils/organization/TODO_any';
 /**
  * Model requirements for an agent
@@ -21,8 +21,13 @@ export type AgentModelRequirements = {
     readonly mcpServers?: ReadonlyArray<string>;
     /**
      * Optional link to the parent agent from which this agent inherits
+     *
+     * Note: [🆓] There are several cases what the agent ancestor could be:
+     * -  1) `parentAgentUrl` is `string_agent_url` valid agent URL
+     * -  2) `parentAgentUrl` is explicitly `null` (forcefully no parent)
+     * -  3) `parentAgentUrl` is not defined `undefined`,  the default ancestor agent, Adam,  will be used
      */
-    readonly parentAgentUrl?: string_knowledge_source_link;
+    readonly parentAgentUrl?: string_agent_url | null;
     /**
      * Optional list of knowledge source links that the agent can use
      */

package/esm/typings/src/book-2.0/utils/generatePlaceholderAgentProfileImageUrl.d.ts

@@ -7,7 +7,7 @@ import type { string_agent_name, string_agent_permanent_id, string_url, string_u
  *
  * @public exported from `@promptbook/core`
  */
-export declare function generatePlaceholderAgentProfileImageUrl(agentIdOrName: string_agent_permanent_id | string_agent_name, agentsServerUrl?: URL | string_url): string_url_image;
+export declare function generatePlaceholderAgentProfileImageUrl(agentIdOrName: string_agent_permanent_id | string_agent_name, agentsServerUrl: URL | string_url): string_url_image;
 /**
  * TODO: [🤹] Figure out best placeholder image generator https://i.pravatar.cc/1000?u=568
  */

package/esm/typings/src/config.d.ts

@@ -1,6 +1,6 @@
 import type { CsvSettings } from './formats/csv/CsvSettings';
 import type { IntermediateFilesStrategy } from './types/IntermediateFilesStrategy';
-import type { string_app_id, string_email, string_name, string_promptbook_server_url } from './types/typeAliases';
+import type { string_app_id, string_email, string_legal_entity, string_name, string_promptbook_server_url } from './types/typeAliases';
 import { Color } from './utils/color/Color';
 /**
  * Warning message for the generated sections and files files
@@ -22,6 +22,12 @@ export declare const NAME = "Promptbook";
  * @public exported from `@promptbook/core`
  */
 export declare const ADMIN_EMAIL: string_email;
+/**
+ * Email of the responsible person
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const PROMPTBOOK_LEGAL_ENTITY: string_legal_entity;
 /**
  * Name of the responsible person for the Promptbook on GitHub
  *
@@ -295,6 +301,7 @@ export declare const MOMENT_ARG_THRESHOLDS: {
 /**
  * Default remote server URL for the Promptbook
  *
+ * @deprecated !!!! Deprecate all pipelines server
  * @public exported from `@promptbook/core`
  */
 export declare const DEFAULT_REMOTE_SERVER_URL: string_promptbook_server_url;

package/esm/typings/src/utils/validators/url/isValidAgentUrl.d.ts

@@ -0,0 +1,16 @@
+import type { string_agent_url } from '../../../types/typeAliases';
+import type { really_unknown } from '../../organization/really_unknown';
+/**
+ * Tests if given string is valid agent URL
+ *
+ * Note: There are few similar functions:
+ * - `isValidUrl` which tests any URL
+ * - `isValidAgentUrl` *(this one)* which tests just agent URL
+ * - `isValidPipelineUrl` which tests just pipeline URL
+ *
+ * @public exported from `@promptbook/utils`
+ */
+export declare function isValidAgentUrl(url: really_unknown): url is string_agent_url;
+/**
+ * TODO: [🐠] Maybe more info why the URL is invalid
+ */

package/esm/typings/src/utils/validators/url/isValidAgentUrl.test.d.ts

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

package/esm/typings/src/utils/validators/url/isValidPipelineUrl.d.ts

@@ -3,8 +3,9 @@ import type { really_unknown } from '../../organization/really_unknown';
 /**
  * Tests if given string is valid pipeline URL URL.
  *
- * Note: There are two similar functions:
+ * Note: There are few similar functions:
  * - `isValidUrl` which tests any URL
+ * - `isValidAgentUrl` which tests just agent URL
  * - `isValidPipelineUrl` *(this one)* which tests just pipeline URL
  *
  * @public exported from `@promptbook/utils`

package/esm/typings/src/utils/validators/url/isValidUrl.d.ts

@@ -5,9 +5,10 @@ import type { really_unknown } from '../../organization/really_unknown';
  *
  * Note: [🔂] This function is idempotent.
  * Note: Dataurl are considered perfectly valid.
- * Note: There are two similar functions:
- * - `isValidUrl` which tests any URL
- * - `isValidPipelineUrl` *(this one)* which tests just promptbook URL
+ * Note: There are few similar functions:
+ * - `isValidUrl` *(this one)* which tests any URL
+ * - `isValidAgentUrl` which tests just agent URL
+ * - `isValidPipelineUrl` which tests just pipeline URL
  *
  * @public exported from `@promptbook/utils`
  */

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.104.0-16`).
+ * It follows semantic versioning (e.g., `0.104.0-18`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/browser",
-    "version": "0.104.0-17",
+    "version": "0.104.0-19",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,
@@ -94,7 +94,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/browser.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.104.0-17"
+        "@promptbook/core": "0.104.0-19"
     },
     "dependencies": {
         "crypto": "1.0.1",

package/umd/index.umd.js

@@ -23,7 +23,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.104.0-17';
+    const PROMPTBOOK_ENGINE_VERSION = '0.104.0-19';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -2212,9 +2212,10 @@
      *
      * Note: [🔂] This function is idempotent.
      * Note: Dataurl are considered perfectly valid.
-     * Note: There are two similar functions:
-     * - `isValidUrl` which tests any URL
-     * - `isValidPipelineUrl` *(this one)* which tests just promptbook URL
+     * Note: There are few similar functions:
+     * - `isValidUrl` *(this one)* which tests any URL
+     * - `isValidAgentUrl` which tests just agent URL
+     * - `isValidPipelineUrl` which tests just pipeline URL
      *
      * @public exported from `@promptbook/utils`
      */
@@ -2624,6 +2625,39 @@
      * Note: [💞] Ignore a discrepancy between file name and entity name
      */
 
+    /**
+     * Tests if given string is valid agent URL
+     *
+     * Note: There are few similar functions:
+     * - `isValidUrl` which tests any URL
+     * - `isValidAgentUrl` *(this one)* which tests just agent URL
+     * - `isValidPipelineUrl` which tests just pipeline URL
+     *
+     * @public exported from `@promptbook/utils`
+     */
+    function isValidAgentUrl(url) {
+        if (!isValidUrl(url)) {
+            return false;
+        }
+        if (!url.startsWith('https://') && !url.startsWith('http://') /* <- Note: [👣] */) {
+            return false;
+        }
+        if (url.includes('#')) {
+            // TODO: [🐠]
+            return false;
+        }
+        /*
+        Note: [👣][🧠] Is it secure to allow pipeline URLs on private and unsecured networks?
+        if (isUrlOnPrivateNetwork(url)) {
+            return false;
+        }
+        */
+        return true;
+    }
+    /**
+     * TODO: [🐠] Maybe more info why the URL is invalid
+     */
+
     /**
      * Normalizes agent name from arbitrary string to valid agent name
      *
@@ -3340,21 +3374,36 @@
         applyToAgentModelRequirements(requirements, content) {
             const trimmedContent = content.trim();
             if (!trimmedContent) {
-                return requirements;
+                return {
+                    ...requirements,
+                    parentAgentUrl: undefined,
+                };
             }
-            // Validate URL
-            try {
-                // eslint-disable-next-line @typescript-eslint/no-unused-vars
-                const url = new URL(trimmedContent);
-                // TODO: Add more validation if needed (e.g. check for valid protocol)
+            if (trimmedContent.toUpperCase() === 'VOID' ||
+                trimmedContent.toUpperCase() === 'NULL' ||
+                trimmedContent.toUpperCase() === 'NONE' ||
+                trimmedContent.toUpperCase() === 'NIL') {
+                return {
+                    ...requirements,
+                    parentAgentUrl: null,
+                };
             }
-            catch (error) {
-                console.warn(`Invalid URL in FROM commitment: ${trimmedContent}`);
-                return requirements;
+            if (!isValidAgentUrl(trimmedContent)) {
+                throw new Error(spaceTrim$1.spaceTrim((block) => `
+                        Invalid agent URL in FROM commitment: "${trimmedContent}"
+
+                        \`\`\`book
+                        ${block(content)}
+                        \`\`\`
+
+
+                `));
             }
+            const parentAgentUrl = trimmedContent;
+            console.log('!!!! parentAgentUrl', parentAgentUrl);
             return {
                 ...requirements,
-                parentAgentUrl: trimmedContent,
+                parentAgentUrl,
             };
         }
     }