@promptbook/vercel 0.103.0-35 → 0.103.0-37

package/esm/index.es.js

@@ -16,7 +16,7 @@ const BOOK_LANGUAGE_VERSION = '1.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.103.0-35';
+const PROMPTBOOK_ENGINE_VERSION = '0.103.0-37';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name

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

@@ -82,6 +82,7 @@ import { ExpectError } from '../errors/ExpectError';
 import { KnowledgeScrapeError } from '../errors/KnowledgeScrapeError';
 import { LimitReachedError } from '../errors/LimitReachedError';
 import { MissingToolsError } from '../errors/MissingToolsError';
+import { NotAllowed } from '../errors/NotAllowed';
 import { NotFoundError } from '../errors/NotFoundError';
 import { NotYetImplementedError } from '../errors/NotYetImplementedError';
 import { ParseError } from '../errors/ParseError';
@@ -129,6 +130,7 @@ import { limitTotalUsage } from '../llm-providers/_common/utils/count-total-usag
 import { getSingleLlmExecutionTools } from '../llm-providers/_multiple/getSingleLlmExecutionTools';
 import { joinLlmExecutionTools } from '../llm-providers/_multiple/joinLlmExecutionTools';
 import { MultipleLlmExecutionTools } from '../llm-providers/_multiple/MultipleLlmExecutionTools';
+import { Agent } from '../llm-providers/agent/Agent';
 import { AgentLlmExecutionTools } from '../llm-providers/agent/AgentLlmExecutionTools';
 import { createAgentLlmExecutionTools } from '../llm-providers/agent/createAgentLlmExecutionTools';
 import { _AgentMetadata } from '../llm-providers/agent/register-configuration';
@@ -264,6 +266,7 @@ export { ExpectError };
 export { KnowledgeScrapeError };
 export { LimitReachedError };
 export { MissingToolsError };
+export { NotAllowed };
 export { NotFoundError };
 export { NotYetImplementedError };
 export { ParseError };
@@ -311,6 +314,7 @@ export { limitTotalUsage };
 export { getSingleLlmExecutionTools };
 export { joinLlmExecutionTools };
 export { MultipleLlmExecutionTools };
+export { Agent };
 export { AgentLlmExecutionTools };
 export { createAgentLlmExecutionTools };
 export { _AgentMetadata };

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

@@ -99,7 +99,8 @@ import type { LlmToolsOptions } from '../llm-providers/_common/register/LlmTools
 import type { CacheItem } from '../llm-providers/_common/utils/cache/CacheItem';
 import type { CacheLlmToolsOptions } from '../llm-providers/_common/utils/cache/CacheLlmToolsOptions';
 import type { LlmExecutionToolsWithTotalUsage } from '../llm-providers/_common/utils/count-total-usage/LlmExecutionToolsWithTotalUsage';
-import type { CreateAgentLlmExecutionToolsOptions } from '../llm-providers/agent/createAgentLlmExecutionTools';
+import type { AgentOptions } from '../llm-providers/agent/AgentOptions';
+import type { CreateAgentLlmExecutionToolsOptions } from '../llm-providers/agent/CreateAgentLlmExecutionToolsOptions';
 import type { AnthropicClaudeExecutionToolsOptions } from '../llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions';
 import type { AnthropicClaudeExecutionToolsNonProxiedOptions } from '../llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions';
 import type { AnthropicClaudeExecutionToolsProxiedOptions } from '../llm-providers/anthropic-claude/AnthropicClaudeExecutionToolsOptions';
@@ -310,6 +311,7 @@ import type { number_kilobytes } from '../types/typeAliases';
 import type { number_megabytes } from '../types/typeAliases';
 import type { number_gigabytes } from '../types/typeAliases';
 import type { number_terabytes } from '../types/typeAliases';
+import type { Updatable } from '../types/Updatable';
 import type { ColorTransformer } from '../utils/color/operators/ColorTransformer';
 import type { PipelineEditableSerialized } from '../utils/editable/types/PipelineEditableSerialized';
 import type { ExecCommandOptions } from '../utils/execCommand/ExecCommandOptions';
@@ -437,6 +439,7 @@ export type { LlmToolsOptions };
 export type { CacheItem };
 export type { CacheLlmToolsOptions };
 export type { LlmExecutionToolsWithTotalUsage };
+export type { AgentOptions };
 export type { CreateAgentLlmExecutionToolsOptions };
 export type { AnthropicClaudeExecutionToolsOptions };
 export type { AnthropicClaudeExecutionToolsNonProxiedOptions };
@@ -648,6 +651,7 @@ export type { number_kilobytes };
 export type { number_megabytes };
 export type { number_gigabytes };
 export type { number_terabytes };
+export type { Updatable };
 export type { ColorTransformer };
 export type { PipelineEditableSerialized };
 export type { ExecCommandOptions };

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

@@ -55,5 +55,6 @@ export type AgentBasicInformation = {
     parameters: BookParameter[];
 };
 /**
+ * TODO: All readonly
  * TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
  */

package/esm/typings/src/book-components/Chat/save/html/htmlSaveFormatDefinition.d.ts

@@ -15,5 +15,6 @@ export declare const htmlSaveFormatDefinition: {
     readonly fileExtension: "html";
 };
 /**
+ * TODO: !!! Add QR code with branding to the footer
  *  TODO: [😬] Take chat save to HTML from existing parallel implementation
  */

package/esm/typings/src/book-components/Chat/save/pdf/pdfSaveFormatDefinition.d.ts

@@ -14,3 +14,7 @@ export declare const pdfSaveFormatDefinition: {
     readonly mimeType: "application/pdf";
     readonly fileExtension: "pdf";
 };
+/**
+ * TODO: !!! Add QR code with branding to the footer
+ * TODO: !!! Add print option
+ */

package/esm/typings/src/book-components/_common/Tooltip/Tooltip.d.ts

@@ -0,0 +1,47 @@
+import { ReactNode } from 'react';
+type TooltipProps = {
+    /**
+     * The content to display in the tooltip
+     */
+    content: string;
+    /**
+     * The element that triggers the tooltip
+     */
+    children: ReactNode;
+    /**
+     * The position of the tooltip relative to the trigger element
+     * @default "top"
+     */
+    position?: 'top' | 'right' | 'bottom' | 'left';
+    /**
+     * Optional delay before showing the tooltip (in milliseconds)
+     * @default 0
+     */
+    delay?: number;
+    /**
+     * Render the tooltip wrapper as a block-level element that spans full width.
+     * Useful when wrapping grid/list items so the clickable area matches the visual card.
+     * @default false
+     */
+    block?: boolean;
+    /**
+     * Enable tooltip on touch devices. By default tooltips are disabled on touch to avoid
+     * stealing clicks from the underlying element (eg. agent card selection).
+     * @default false
+     */
+    isEnabledOnTouch?: boolean;
+    /**
+     * If true, the tooltip will not be displayed but the content will still be rendered.
+     * In this case <Tooltip> is equivalent to a <React.Fragment> with the content.
+     *
+     * Note: Tooltip sometimes breaks the hover, temporarily disable via this prop
+     */
+    isDisabled?: boolean;
+};
+/**
+ * A tooltip component that displays additional information when hovering over an element
+ *
+ * @private Used internally in book components
+ */
+export declare function Tooltip({ content, children, position, delay, block, isEnabledOnTouch: enableOnTouch, isDisabled, }: TooltipProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/esm/typings/src/errors/0-index.d.ts

@@ -7,6 +7,7 @@ import { ExpectError } from './ExpectError';
 import { KnowledgeScrapeError } from './KnowledgeScrapeError';
 import { LimitReachedError } from './LimitReachedError';
 import { MissingToolsError } from './MissingToolsError';
+import { NotAllowed } from './NotAllowed';
 import { NotFoundError } from './NotFoundError';
 import { NotYetImplementedError } from './NotYetImplementedError';
 import { ParseError } from './ParseError';
@@ -40,6 +41,7 @@ export declare const PROMPTBOOK_ERRORS: {
     readonly PromptbookFetchError: typeof PromptbookFetchError;
     readonly UnexpectedError: typeof UnexpectedError;
     readonly WrappedError: typeof WrappedError;
+    readonly NotAllowed: typeof NotAllowed;
 };
 /**
  * Index of all javascript errors
@@ -88,6 +90,7 @@ export declare const ALL_ERRORS: {
     readonly PromptbookFetchError: typeof PromptbookFetchError;
     readonly UnexpectedError: typeof UnexpectedError;
     readonly WrappedError: typeof WrappedError;
+    readonly NotAllowed: typeof NotAllowed;
 };
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/esm/typings/src/errors/NotAllowed.d.ts

@@ -0,0 +1,9 @@
+/**
+ * This error indicates that promptbook operation is not allowed
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare class NotAllowed extends Error {
+    readonly name = "NotAllowed";
+    constructor(message: string);
+}

package/esm/typings/src/execution/AvailableModel.d.ts

@@ -46,5 +46,6 @@ export type AvailableModel = {
     readonly isDeprecated?: boolean;
 };
 /**
+ * TODO: [🕛] Extend this from sth like `AgentBasicInformation` / `ModelBasicInformation`
  * TODO: [🧠] Maybe rename to something else - like `ModelInformation` or `ModelMetadata`
  */

package/esm/typings/src/execution/Executables.d.ts

@@ -16,3 +16,6 @@ export type Executables = {
      */
     libreOfficePath?: string_executable_path;
 };
+/**
+ * <- TODO: Add !!! `browserPath` to `Executables`
+ */

package/esm/typings/src/execution/ExecutionTools.d.ts

@@ -67,3 +67,8 @@ export type ExecutionTools = {
      */
     readonly userInterface?: UserInterfaceTools;
 };
+/**
+ * <- TODO: Add !!! `promptbookAgent` to `ExecutionTools`
+ * <- TODO: Add !!! `mcps` to `ExecutionTools`
+ * <- TODO: Add !!! `prepareCache` to `ExecutionTools`
+ */

package/esm/typings/src/execution/LlmExecutionTools.d.ts

@@ -56,7 +56,7 @@ export type LlmExecutionTools = {
     callEmbeddingModel?(prompt: Prompt): Promise<EmbeddingPromptResult>;
 };
 /**
- * TODO: [🕛] Extend this from sth class
+ * TODO: [🕛] Extend this from sth class -  like `AgentBasicInformation` / `ModelBasicInformation``
  * TODO: [🍚] Implement destroyable pattern to free resources
  * TODO: [🏳] Add `callTranslationModel`
  * TODO: [🧠] Emulation of one type of model with another one - emuate chat with completion; emulate translation with chat

package/esm/typings/src/llm-providers/agent/Agent.d.ts

@@ -0,0 +1,44 @@
+import { BehaviorSubject } from 'rxjs';
+import { AgentBasicInformation, BookParameter, LlmExecutionTools, string_agent_name, string_book, string_url_image } from '../../_packages/types.index';
+import { AgentOptions } from './AgentOptions';
+/**
+ * Note: !!!! `Agent` vs `LlmExecutionTools`
+ *
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare class Agent implements AgentBasicInformation {
+    private readonly options;
+    /**
+     * Name of the agent
+     */
+    agentName: string_agent_name | null;
+    /**
+     * Description of the agent
+     */
+    personaDescription: string | null;
+    /**
+     * Metadata like image or color
+     */
+    meta: {
+        image?: string_url_image;
+        link?: string;
+        title?: string;
+        description?: string;
+        [key: string]: string | undefined;
+    };
+    /**
+     * Not used in Agent, always returns empty array
+     */
+    get parameters(): BookParameter[];
+    readonly agentSource: BehaviorSubject<string_book>;
+    constructor(options: AgentOptions);
+    /**
+     * Creates LlmExecutionTools which exposes the agent as a model
+     */
+    getLlmExecutionTools(): LlmExecutionTools;
+}
+/**
+ * TODO: [🧠][😰]Agent is not working with the parameters, should it be?
+ * TODO: !!! Agent on remote server
+ */

package/esm/typings/src/llm-providers/agent/AgentOptions.d.ts

@@ -0,0 +1,17 @@
+import { CommonToolsOptions, ExecutionTools, string_book } from '../../_packages/types.index';
+import { Updatable } from '../../types/Updatable';
+/**
+ * Options for creating an Agent
+ */
+export type AgentOptions = CommonToolsOptions & {
+    /**
+     * The execution tools available to the agent
+     *
+     * Here the agent has access to various LLM models, browser, scrapers, LibreOffice, tools, etc.
+     */
+    executionTools: ExecutionTools;
+    /**
+     * The source of the agent
+     */
+    agentSource: Updatable<string_book>;
+};

package/esm/typings/src/llm-providers/agent/CreateAgentLlmExecutionToolsOptions.d.ts

@@ -0,0 +1,16 @@
+import type { string_book } from '../../_packages/types.index';
+import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
+import type { OpenAiAssistantExecutionTools } from '../openai/OpenAiAssistantExecutionTools';
+/**
+ * Options for creating AgentLlmExecutionTools
+ */
+export type CreateAgentLlmExecutionToolsOptions = {
+    /**
+     * The underlying LLM execution tools to wrap
+     */
+    llmTools: LlmExecutionTools | OpenAiAssistantExecutionTools;
+    /**
+     * The agent source string that defines the agent's behavior
+     */
+    agentSource: string_book;
+};

package/esm/typings/src/llm-providers/agent/createAgentLlmExecutionTools.d.ts

@@ -1,19 +1,5 @@
-import type { string_book } from '../../book-2.0/agent-source/string_book';
-import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import { AgentLlmExecutionTools } from './AgentLlmExecutionTools';
-/**
- * Options for creating AgentLlmExecutionTools
- */
-export type CreateAgentLlmExecutionToolsOptions = {
-    /**
-     * The underlying LLM execution tools to wrap
-     */
-    llmTools: LlmExecutionTools;
-    /**
-     * The agent source string that defines the agent's behavior
-     */
-    agentSource: string_book;
-};
+import { CreateAgentLlmExecutionToolsOptions } from './CreateAgentLlmExecutionToolsOptions';
 /**
  * Creates new AgentLlmExecutionTools that wrap underlying LLM tools with agent-specific behavior
  *

package/esm/typings/src/llm-providers/openai/OpenAiAssistantExecutionTools.d.ts

@@ -13,6 +13,7 @@ import { OpenAiExecutionTools } from './OpenAiExecutionTools';
  */
 export declare class OpenAiAssistantExecutionTools extends OpenAiExecutionTools implements LlmExecutionTools {
     private readonly assistantId;
+    private readonly isCreatingNewAssistantsAllowed;
     /**
      * Creates OpenAI Execution Tools.
      *
@@ -25,6 +26,17 @@ export declare class OpenAiAssistantExecutionTools extends OpenAiExecutionTools
      * Calls OpenAI API to use a chat model.
      */
     callChatModel(prompt: Pick<Prompt, 'content' | 'parameters' | 'modelRequirements' | 'format'>): Promise<ChatPromptResult>;
+    createNewAssistant(): Promise<OpenAiAssistantExecutionTools>;
+    /**
+     * Discriminant for type guards
+     */
+    protected get discriminant(): string;
+    /**
+     * Type guard to check if given `LlmExecutionTools` are instanceof `OpenAiAssistantExecutionTools`
+     *
+     * Note: This is useful when you can possibly have multiple versions of `@promptbook/openai` installed
+     */
+    static isOpenAiAssistantExecutionTools(llmExecutionTools: LlmExecutionTools): llmExecutionTools is OpenAiAssistantExecutionTools;
 }
 /**
  * TODO: [🧠][🧙‍♂️] Maybe there can be some wizard for those who want to use just OpenAI

package/esm/typings/src/llm-providers/openai/OpenAiAssistantExecutionToolsOptions.d.ts

@@ -7,8 +7,14 @@ import type { OpenAiCompatibleExecutionToolsOptions } from './OpenAiCompatibleEx
  * @public exported from `@promptbook/openai`
  */
 export type OpenAiAssistantExecutionToolsOptions = OpenAiCompatibleExecutionToolsOptions & ClientOptions & {
+    /**
+     * Whether creating new assistants is allowed
+     *
+     * @default false
+     */
+    readonly isCreatingNewAssistantsAllowed?: boolean;
     /**
      * Which assistant to use
      */
-    assistantId: string_token;
+    readonly assistantId: string_token;
 };

package/esm/typings/src/remote-server/startRemoteServer.d.ts

@@ -11,6 +11,8 @@ import type { RemoteServerOptions } from './types/RemoteServerOptions';
  */
 export declare function startRemoteServer<TCustomOptions = undefined>(options: RemoteServerOptions<TCustomOptions>): RemoteServer;
 /**
+ * TODO !!!! Add agent
+ * TODO: !!!! Allow to chat with agents directly via remote server
  * TODO: [🕋] Use here `aboutPromptbookInformation`
  * TODO: [🌡] Add CORS and security - probably via `helmet`
  * TODO: Split this file into multiple functions - handler for each request

package/esm/typings/src/types/Updatable.d.ts

@@ -0,0 +1,19 @@
+import { BehaviorSubject } from 'rxjs';
+/**
+ * A type that represents a value that can be updated over time:
+ *
+ * 1) It can be a static value of type `TValue`
+ * 2) Or a `BehaviorSubject` that emits values of type `TValue`
+ * 3) Or pair of `[getValue, setValue]` functions for getting and setting the value
+ */
+export type Updatable<TValue> = TValue | BehaviorSubject<TValue> | [TValue, (value: TValue) => void];
+/**
+ * Restricts an Updatable to a (2) BehaviorSubject variant
+ *
+ * @see Updatable
+ * @private internal utility <- TODO: [🧠] Maybe export from `@promptbook/types`
+ */
+export declare function asUpdatableSubject<TValue>(value: Updatable<TValue>): BehaviorSubject<TValue>;
+/**
+ * TODO: [🧠] Maybe `BehaviorSubject` is too heavy for this use case, maybe just tuple `[value,setValue]` is enough
+ */

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.103.0-34`).
+ * It follows semantic versioning (e.g., `0.103.0-36`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/vercel",
-    "version": "0.103.0-35",
+    "version": "0.103.0-37",
     "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/vercel.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.103.0-35"
+        "@promptbook/core": "0.103.0-37"
     },
     "dependencies": {
         "colors": "^1.4.0",

package/umd/index.umd.js

@@ -23,7 +23,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-35';
+    const PROMPTBOOK_ENGINE_VERSION = '0.103.0-37';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name