@promptbook/node 0.104.0-17 → 0.104.0-19

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

@@ -29,6 +29,7 @@ import type { GroupedCommitmentDefinition } from '../commitments/index';
 import { getGroupedCommitmentDefinitions } from '../commitments/index';
 import { NAME } from '../config';
 import { ADMIN_EMAIL } from '../config';
+import { PROMPTBOOK_LEGAL_ENTITY } from '../config';
 import { ADMIN_GITHUB_NAME } from '../config';
 import { CLAIM } from '../config';
 import { PROMPTBOOK_COLOR } from '../config';
@@ -191,9 +192,9 @@ import { SectionTypes } from '../types/SectionType';
 import { TaskTypes } from '../types/TaskType';
 import { aboutPromptbookInformation } from '../utils/misc/aboutPromptbookInformation';
 import { $generateBookBoilerplate } from '../utils/random/$generateBookBoilerplate';
-import { CORE_SERVER } from '../../servers';
-import { REMOTE_SERVER_URLS } from '../../servers';
-import { AUTO_FEDERATED_AGENT_SERVER_URLS } from '../../servers';
+import { CORE_AGENTS_SERVER } from '../../servers';
+import { CORE_AGENTS_SERVER_WELL_KNOWN_AGENT_NAMES } from '../../servers';
+import { PUBLIC_AGENTS_SERVERS } from '../../servers';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
 export { computeAgentHash };
 export { createAgentModelRequirements };
@@ -225,6 +226,7 @@ export type { GroupedCommitmentDefinition };
 export { getGroupedCommitmentDefinitions };
 export { NAME };
 export { ADMIN_EMAIL };
+export { PROMPTBOOK_LEGAL_ENTITY };
 export { ADMIN_GITHUB_NAME };
 export { CLAIM };
 export { PROMPTBOOK_COLOR };
@@ -387,6 +389,6 @@ export { SectionTypes };
 export { TaskTypes };
 export { aboutPromptbookInformation };
 export { $generateBookBoilerplate };
-export { CORE_SERVER };
-export { REMOTE_SERVER_URLS };
-export { AUTO_FEDERATED_AGENT_SERVER_URLS };
+export { CORE_AGENTS_SERVER };
+export { CORE_AGENTS_SERVER_WELL_KNOWN_AGENT_NAMES };
+export { PUBLIC_AGENTS_SERVERS };

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

@@ -83,6 +83,7 @@ import { isValidPromptbookVersion } from '../utils/validators/semanticVersion/is
 import { isValidSemanticVersion } from '../utils/validators/semanticVersion/isValidSemanticVersion';
 import { isHostnameOnPrivateNetwork } from '../utils/validators/url/isHostnameOnPrivateNetwork';
 import { isUrlOnPrivateNetwork } from '../utils/validators/url/isUrlOnPrivateNetwork';
+import { isValidAgentUrl } from '../utils/validators/url/isValidAgentUrl';
 import { isValidPipelineUrl } from '../utils/validators/url/isValidPipelineUrl';
 import { isValidUrl } from '../utils/validators/url/isValidUrl';
 import { isValidUuid } from '../utils/validators/uuid/isValidUuid';
@@ -171,6 +172,7 @@ export { isValidPromptbookVersion };
 export { isValidSemanticVersion };
 export { isHostnameOnPrivateNetwork };
 export { isUrlOnPrivateNetwork };
+export { isValidAgentUrl };
 export { isValidPipelineUrl };
 export { isValidUrl };
 export { isValidUuid };

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/node",
-    "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,
@@ -93,7 +93,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/node.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.104.0-17"
+        "@promptbook/core": "0.104.0-19"
     },
     "dependencies": {
         "colors": "1.4.0",

package/umd/index.umd.js

@@ -45,7 +45,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
@@ -1724,9 +1724,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`
      */
@@ -1752,8 +1753,9 @@
     /**
      * 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`