@promptbook/utils 0.112.0-58 → 0.112.0-60

package/esm/index.es.js

@@ -18,7 +18,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-58';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-60';
 /**
  * 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/src/book-components/BookEditor/useBookEditorMonacoInteractions.d.ts

@@ -0,0 +1,40 @@
+import type { editor } from 'monaco-editor';
+import { type ChangeEvent, type ClipboardEvent, type DragEvent, type RefObject, type TouchEvent } from 'react';
+/**
+ * Type describing the file handler used by Monaco upload interactions.
+ */
+type HandleFiles = (files: File[]) => Promise<void>;
+/**
+ * Props for use book editor monaco interactions.
+ */
+type UseBookEditorMonacoInteractionsProps = {
+    readonly editor: editor.IStandaloneCodeEditor | null;
+    readonly handleFiles: HandleFiles;
+};
+/**
+ * Result of use book editor monaco interactions.
+ */
+type UseBookEditorMonacoInteractionsResult = {
+    readonly isDragOver: boolean;
+    readonly fileUploadInputRef: RefObject<HTMLInputElement | null>;
+    readonly cameraInputRef: RefObject<HTMLInputElement | null>;
+    readonly handleDrop: (event: DragEvent<HTMLDivElement>) => Promise<void>;
+    readonly handlePaste: (event: ClipboardEvent<HTMLDivElement>) => Promise<void>;
+    readonly handleUploadDocument: () => void;
+    readonly handleTakePhoto: () => void;
+    readonly handleFileInputChange: (event: ChangeEvent<HTMLInputElement>) => void;
+    readonly handleDragOver: (event: DragEvent<HTMLDivElement>) => void;
+    readonly handleDragEnter: (event: DragEvent<HTMLDivElement>) => void;
+    readonly handleDragLeave: (event: DragEvent<HTMLDivElement>) => void;
+    readonly focusOverlayTouchHandlers: {
+        readonly onTouchStart: (event: TouchEvent<HTMLDivElement>) => void;
+        readonly onTouchEnd: (event: TouchEvent<HTMLDivElement>) => void;
+    };
+};
+/**
+ * Manages drag, paste and file input interactions for `BookEditorMonaco`.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function useBookEditorMonacoInteractions({ editor, handleFiles, }: UseBookEditorMonacoInteractionsProps): UseBookEditorMonacoInteractionsResult;
+export {};

package/esm/src/book-components/BookEditor/useBookEditorMonacoLifecycle.d.ts

@@ -0,0 +1,34 @@
+import type { editor } from 'monaco-editor';
+/**
+ * Type describing monaco editor.
+ */
+type MonacoEditor = typeof import('monaco-editor');
+/**
+ * Resolved visual theme supported by the Book editor.
+ */
+type BookEditorTheme = 'LIGHT' | 'DARK';
+/**
+ * Props for use book editor monaco lifecycle.
+ */
+type UseBookEditorMonacoLifecycleProps = {
+    readonly monaco: MonacoEditor | null;
+    readonly theme: BookEditorTheme;
+};
+/**
+ * Result of use book editor monaco lifecycle.
+ */
+type UseBookEditorMonacoLifecycleResult = {
+    readonly editor: editor.IStandaloneCodeEditor | null;
+    readonly isFocused: boolean;
+    readonly isTouchDevice: boolean;
+    readonly isSavedShown: boolean;
+    readonly handleBeforeMonacoMount: (beforeMountMonaco: MonacoEditor) => void;
+    readonly handleMonacoMount: (mountedEditor: editor.IStandaloneCodeEditor, mountedMonaco: MonacoEditor) => void;
+};
+/**
+ * Manages Monaco lifecycle wiring for `BookEditorMonaco`.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function useBookEditorMonacoLifecycle({ monaco, theme, }: UseBookEditorMonacoLifecycleProps): UseBookEditorMonacoLifecycleResult;
+export {};

package/esm/src/commitments/_base/BaseCommitmentDefinition.d.ts

@@ -96,6 +96,32 @@ export declare abstract class BaseCommitmentDefinition<TBookCommitment extends s
      * but can be useful for organizing and structuring the message during processing
      */
     protected addCommentSection(requirements: AgentModelRequirements, commentTitle: string, content: string, position?: 'beginning' | 'end'): AgentModelRequirements;
+    /**
+     * Helper method to append a bullet point to an existing `## SectionTitle` section in the system
+     * message, or to create a new section when it does not yet exist.
+     *
+     * Handles the case where the same commitment type appears multiple times in the book source and
+     * all entries should be grouped under one shared heading rather than emitting a duplicate block.
+     *
+     * @param requirements - Current model requirements.
+     * @param sectionTitle - Section title without the `##` prefix.
+     * @param bulletContent - Bullet content without the leading `-   ` prefix.
+     * @returns Requirements with the bullet appended to the section.
+     */
+    protected appendBulletPointToSection(requirements: AgentModelRequirements, sectionTitle: string, bulletContent: string): AgentModelRequirements;
+    /**
+     * Helper method to replace an existing `## SectionTitle` section in the system message, or to
+     * append a new one when the section does not yet exist.
+     *
+     * Use this when a commitment type can appear multiple times and each subsequent occurrence should
+     * update the single shared section rather than appending a duplicate block.
+     *
+     * @param requirements - Current model requirements.
+     * @param sectionTitle - Section title without the `##` prefix.
+     * @param sectionContent - Full section content including the `## Title` header line.
+     * @returns Requirements with the section replaced or appended.
+     */
+    protected replaceOrCreateSection(requirements: AgentModelRequirements, sectionTitle: string, sectionContent: string): AgentModelRequirements;
     /**
      * Gets tool function implementations provided by this commitment
      *

package/esm/src/llm-providers/openai/OpenAiAgentKitExecutionTools.d.ts

@@ -1,3 +1,4 @@
+import type { Tool as AgentKitTool } from '@openai/agents';
 import { Agent as AgentFromKit } from '@openai/agents';
 import OpenAI from 'openai';
 import { TODO_any } from '../../_packages/types.index';
@@ -109,6 +110,7 @@ export declare class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandl
         readonly instructions: string_markdown;
         readonly knowledgeSources?: ReadonlyArray<string>;
         readonly tools?: ModelRequirements['tools'];
+        readonly nativeAgentKitTools?: ReadonlyArray<AgentKitTool>;
         readonly vectorStoreId?: string;
         readonly storeAsPrepared?: boolean;
     }): Promise<OpenAiAgentKitPreparedAgent>;

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.112.0-57`).
+ * It follows semantic versioning (e.g., `0.112.0-59`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/utils",
-    "version": "0.112.0-58",
+    "version": "0.112.0-60",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,

package/umd/index.umd.js

@@ -22,7 +22,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-58';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-60';
     /**
      * 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/umd/src/book-components/BookEditor/useBookEditorMonacoInteractions.d.ts

@@ -0,0 +1,40 @@
+import type { editor } from 'monaco-editor';
+import { type ChangeEvent, type ClipboardEvent, type DragEvent, type RefObject, type TouchEvent } from 'react';
+/**
+ * Type describing the file handler used by Monaco upload interactions.
+ */
+type HandleFiles = (files: File[]) => Promise<void>;
+/**
+ * Props for use book editor monaco interactions.
+ */
+type UseBookEditorMonacoInteractionsProps = {
+    readonly editor: editor.IStandaloneCodeEditor | null;
+    readonly handleFiles: HandleFiles;
+};
+/**
+ * Result of use book editor monaco interactions.
+ */
+type UseBookEditorMonacoInteractionsResult = {
+    readonly isDragOver: boolean;
+    readonly fileUploadInputRef: RefObject<HTMLInputElement | null>;
+    readonly cameraInputRef: RefObject<HTMLInputElement | null>;
+    readonly handleDrop: (event: DragEvent<HTMLDivElement>) => Promise<void>;
+    readonly handlePaste: (event: ClipboardEvent<HTMLDivElement>) => Promise<void>;
+    readonly handleUploadDocument: () => void;
+    readonly handleTakePhoto: () => void;
+    readonly handleFileInputChange: (event: ChangeEvent<HTMLInputElement>) => void;
+    readonly handleDragOver: (event: DragEvent<HTMLDivElement>) => void;
+    readonly handleDragEnter: (event: DragEvent<HTMLDivElement>) => void;
+    readonly handleDragLeave: (event: DragEvent<HTMLDivElement>) => void;
+    readonly focusOverlayTouchHandlers: {
+        readonly onTouchStart: (event: TouchEvent<HTMLDivElement>) => void;
+        readonly onTouchEnd: (event: TouchEvent<HTMLDivElement>) => void;
+    };
+};
+/**
+ * Manages drag, paste and file input interactions for `BookEditorMonaco`.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function useBookEditorMonacoInteractions({ editor, handleFiles, }: UseBookEditorMonacoInteractionsProps): UseBookEditorMonacoInteractionsResult;
+export {};

package/umd/src/book-components/BookEditor/useBookEditorMonacoLifecycle.d.ts

@@ -0,0 +1,34 @@
+import type { editor } from 'monaco-editor';
+/**
+ * Type describing monaco editor.
+ */
+type MonacoEditor = typeof import('monaco-editor');
+/**
+ * Resolved visual theme supported by the Book editor.
+ */
+type BookEditorTheme = 'LIGHT' | 'DARK';
+/**
+ * Props for use book editor monaco lifecycle.
+ */
+type UseBookEditorMonacoLifecycleProps = {
+    readonly monaco: MonacoEditor | null;
+    readonly theme: BookEditorTheme;
+};
+/**
+ * Result of use book editor monaco lifecycle.
+ */
+type UseBookEditorMonacoLifecycleResult = {
+    readonly editor: editor.IStandaloneCodeEditor | null;
+    readonly isFocused: boolean;
+    readonly isTouchDevice: boolean;
+    readonly isSavedShown: boolean;
+    readonly handleBeforeMonacoMount: (beforeMountMonaco: MonacoEditor) => void;
+    readonly handleMonacoMount: (mountedEditor: editor.IStandaloneCodeEditor, mountedMonaco: MonacoEditor) => void;
+};
+/**
+ * Manages Monaco lifecycle wiring for `BookEditorMonaco`.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare function useBookEditorMonacoLifecycle({ monaco, theme, }: UseBookEditorMonacoLifecycleProps): UseBookEditorMonacoLifecycleResult;
+export {};

package/umd/src/commitments/_base/BaseCommitmentDefinition.d.ts

@@ -96,6 +96,32 @@ export declare abstract class BaseCommitmentDefinition<TBookCommitment extends s
      * but can be useful for organizing and structuring the message during processing
      */
     protected addCommentSection(requirements: AgentModelRequirements, commentTitle: string, content: string, position?: 'beginning' | 'end'): AgentModelRequirements;
+    /**
+     * Helper method to append a bullet point to an existing `## SectionTitle` section in the system
+     * message, or to create a new section when it does not yet exist.
+     *
+     * Handles the case where the same commitment type appears multiple times in the book source and
+     * all entries should be grouped under one shared heading rather than emitting a duplicate block.
+     *
+     * @param requirements - Current model requirements.
+     * @param sectionTitle - Section title without the `##` prefix.
+     * @param bulletContent - Bullet content without the leading `-   ` prefix.
+     * @returns Requirements with the bullet appended to the section.
+     */
+    protected appendBulletPointToSection(requirements: AgentModelRequirements, sectionTitle: string, bulletContent: string): AgentModelRequirements;
+    /**
+     * Helper method to replace an existing `## SectionTitle` section in the system message, or to
+     * append a new one when the section does not yet exist.
+     *
+     * Use this when a commitment type can appear multiple times and each subsequent occurrence should
+     * update the single shared section rather than appending a duplicate block.
+     *
+     * @param requirements - Current model requirements.
+     * @param sectionTitle - Section title without the `##` prefix.
+     * @param sectionContent - Full section content including the `## Title` header line.
+     * @returns Requirements with the section replaced or appended.
+     */
+    protected replaceOrCreateSection(requirements: AgentModelRequirements, sectionTitle: string, sectionContent: string): AgentModelRequirements;
     /**
      * Gets tool function implementations provided by this commitment
      *

package/umd/src/llm-providers/openai/OpenAiAgentKitExecutionTools.d.ts

@@ -1,3 +1,4 @@
+import type { Tool as AgentKitTool } from '@openai/agents';
 import { Agent as AgentFromKit } from '@openai/agents';
 import OpenAI from 'openai';
 import { TODO_any } from '../../_packages/types.index';
@@ -109,6 +110,7 @@ export declare class OpenAiAgentKitExecutionTools extends OpenAiVectorStoreHandl
         readonly instructions: string_markdown;
         readonly knowledgeSources?: ReadonlyArray<string>;
         readonly tools?: ModelRequirements['tools'];
+        readonly nativeAgentKitTools?: ReadonlyArray<AgentKitTool>;
         readonly vectorStoreId?: string;
         readonly storeAsPrepared?: boolean;
     }): Promise<OpenAiAgentKitPreparedAgent>;

package/umd/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.112.0-57`).
+ * It follows semantic versioning (e.g., `0.112.0-59`).
  *
  * @generated
  */