@promptbook/javascript 0.112.0-26 → 0.112.0-28

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-26';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-28';
 /**
  * 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-2.0/agent-source/createAgentModelRequirements.useCommitmentAggregation.test.d.ts

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

package/esm/src/book-components/_common/MenuHoisting/MenuHoistingContext.d.ts

@@ -26,45 +26,6 @@ export type HoistedMenuItem = {
      */
     isActive?: boolean;
 };
-/**
- * Shared actions provided to hoisted mobile menu-section renderers.
- *
- * @private mechanism inside Promptbook
- */
-export type HoistedMobileMenuSectionRenderOptions = {
-    /**
-     * Closes the owning mobile header menu.
-     */
-    readonly closeMenu: () => void;
-};
-/**
- * Mobile-only section hoisted into the shared application menu.
- *
- * @private mechanism inside Promptbook
- */
-export type HoistedMobileMenuSection = {
-    /**
-     * Stable identifier used to preserve section open state.
-     */
-    readonly key: string;
-    /**
-     * Visible section label rendered by the mobile menu.
-     */
-    readonly label: ReactNode;
-    /**
-     * Whether the section should start expanded whenever the menu opens.
-     */
-    readonly isDefaultOpen?: boolean;
-    /**
-     * Lazily renders section content inside the mobile header menu.
-     */
-    readonly renderContent: (options: HoistedMobileMenuSectionRenderOptions) => ReactNode;
-};
-/**
- * Value exposed through the shared menu-hoisting context.
- *
- * @private mechanism inside Promptbook
- */
 type MenuHoistingContextType = {
     /**
      * The currently hoisted menu items
@@ -74,14 +35,6 @@ type MenuHoistingContextType = {
      * Set the hoisted menu items
      */
     setMenu: (items: HoistedMenuItem[]) => void;
-    /**
-     * Mobile-only sections hoisted into the shared application menu.
-     */
-    mobileMenuSections: HoistedMobileMenuSection[];
-    /**
-     * Sets the mobile-only hoisted menu sections.
-     */
-    setMobileMenuSections: (sections: HoistedMobileMenuSection[]) => void;
 };
 /**
  * Provider for menu hoisting

package/esm/src/commitments/USE/aggregateUseCommitmentSystemMessages.d.ts

@@ -0,0 +1,30 @@
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import type { ParsedCommitment } from '../_base/ParsedCommitment';
+/**
+ * `USE` commitment types whose system-message sections are aggregated after the
+ * commitment-by-commitment application step.
+ *
+ * @private internal utility of `createAgentModelRequirementsWithCommitments`
+ */
+type AggregatedUseCommitmentType = 'USE BROWSER' | 'USE SEARCH ENGINE' | 'USE TIME';
+/**
+ * Adds the placeholder for an aggregated `USE` system-message section only once, preserving the section position from the first occurrence.
+ *
+ * @param requirements - Current model requirements.
+ * @param type - Aggregated `USE` commitment type being applied.
+ * @returns Requirements with the placeholder inserted when it was not already present.
+ * @private internal utility of `USE` commitments
+ */
+export declare function appendAggregatedUseCommitmentPlaceholder(requirements: AgentModelRequirements, type: AggregatedUseCommitmentType): AgentModelRequirements;
+/**
+ * Replaces temporary `USE` placeholders with one aggregated system-message block per commitment type.
+ *
+ * Distinct additional-instruction blocks are merged in stable source order while the hard-coded section is emitted only once.
+ *
+ * @param requirements - Model requirements produced by commitment-by-commitment application.
+ * @param commitments - Filtered commitments in their original source order.
+ * @returns Requirements with aggregated `USE` system-message sections.
+ * @private internal utility of `createAgentModelRequirementsWithCommitments`
+ */
+export declare function aggregateUseCommitmentSystemMessages(requirements: AgentModelRequirements, commitments: ReadonlyArray<ParsedCommitment>): AgentModelRequirements;
+export {};

package/esm/src/commitments/USE_BROWSER/USE_BROWSER.d.ts

@@ -12,13 +12,14 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  * 1. One-shot URL fetching: Simple function to fetch and scrape URL content
  * 2. Running browser: For complex tasks like scrolling, clicking, form filling, etc.
  *
- * The content following `USE BROWSER` is ignored (similar to NOTE).
+ * The content following `USE BROWSER` is an arbitrary text that the agent should know
+ * (e.g. browsing scope or preferred sources).
  *
  * Example usage in agent source:
  *
  * ```book
  * USE BROWSER
- * USE BROWSER This will be ignored
+ * USE BROWSER Prefer official documentation and source websites.
  * ```
  *
  * @private [🪔] Maybe export the commitments through some package

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

package/package.json

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

package/umd/index.umd.js

@@ -22,7 +22,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-26';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-28';
     /**
      * 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-2.0/agent-source/createAgentModelRequirements.useCommitmentAggregation.test.d.ts

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

package/umd/src/book-components/_common/MenuHoisting/MenuHoistingContext.d.ts

@@ -26,45 +26,6 @@ export type HoistedMenuItem = {
      */
     isActive?: boolean;
 };
-/**
- * Shared actions provided to hoisted mobile menu-section renderers.
- *
- * @private mechanism inside Promptbook
- */
-export type HoistedMobileMenuSectionRenderOptions = {
-    /**
-     * Closes the owning mobile header menu.
-     */
-    readonly closeMenu: () => void;
-};
-/**
- * Mobile-only section hoisted into the shared application menu.
- *
- * @private mechanism inside Promptbook
- */
-export type HoistedMobileMenuSection = {
-    /**
-     * Stable identifier used to preserve section open state.
-     */
-    readonly key: string;
-    /**
-     * Visible section label rendered by the mobile menu.
-     */
-    readonly label: ReactNode;
-    /**
-     * Whether the section should start expanded whenever the menu opens.
-     */
-    readonly isDefaultOpen?: boolean;
-    /**
-     * Lazily renders section content inside the mobile header menu.
-     */
-    readonly renderContent: (options: HoistedMobileMenuSectionRenderOptions) => ReactNode;
-};
-/**
- * Value exposed through the shared menu-hoisting context.
- *
- * @private mechanism inside Promptbook
- */
 type MenuHoistingContextType = {
     /**
      * The currently hoisted menu items
@@ -74,14 +35,6 @@ type MenuHoistingContextType = {
      * Set the hoisted menu items
      */
     setMenu: (items: HoistedMenuItem[]) => void;
-    /**
-     * Mobile-only sections hoisted into the shared application menu.
-     */
-    mobileMenuSections: HoistedMobileMenuSection[];
-    /**
-     * Sets the mobile-only hoisted menu sections.
-     */
-    setMobileMenuSections: (sections: HoistedMobileMenuSection[]) => void;
 };
 /**
  * Provider for menu hoisting

package/umd/src/commitments/USE/aggregateUseCommitmentSystemMessages.d.ts

@@ -0,0 +1,30 @@
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import type { ParsedCommitment } from '../_base/ParsedCommitment';
+/**
+ * `USE` commitment types whose system-message sections are aggregated after the
+ * commitment-by-commitment application step.
+ *
+ * @private internal utility of `createAgentModelRequirementsWithCommitments`
+ */
+type AggregatedUseCommitmentType = 'USE BROWSER' | 'USE SEARCH ENGINE' | 'USE TIME';
+/**
+ * Adds the placeholder for an aggregated `USE` system-message section only once, preserving the section position from the first occurrence.
+ *
+ * @param requirements - Current model requirements.
+ * @param type - Aggregated `USE` commitment type being applied.
+ * @returns Requirements with the placeholder inserted when it was not already present.
+ * @private internal utility of `USE` commitments
+ */
+export declare function appendAggregatedUseCommitmentPlaceholder(requirements: AgentModelRequirements, type: AggregatedUseCommitmentType): AgentModelRequirements;
+/**
+ * Replaces temporary `USE` placeholders with one aggregated system-message block per commitment type.
+ *
+ * Distinct additional-instruction blocks are merged in stable source order while the hard-coded section is emitted only once.
+ *
+ * @param requirements - Model requirements produced by commitment-by-commitment application.
+ * @param commitments - Filtered commitments in their original source order.
+ * @returns Requirements with aggregated `USE` system-message sections.
+ * @private internal utility of `createAgentModelRequirementsWithCommitments`
+ */
+export declare function aggregateUseCommitmentSystemMessages(requirements: AgentModelRequirements, commitments: ReadonlyArray<ParsedCommitment>): AgentModelRequirements;
+export {};

package/umd/src/commitments/USE_BROWSER/USE_BROWSER.d.ts

@@ -12,13 +12,14 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  * 1. One-shot URL fetching: Simple function to fetch and scrape URL content
  * 2. Running browser: For complex tasks like scrolling, clicking, form filling, etc.
  *
- * The content following `USE BROWSER` is ignored (similar to NOTE).
+ * The content following `USE BROWSER` is an arbitrary text that the agent should know
+ * (e.g. browsing scope or preferred sources).
  *
  * Example usage in agent source:
  *
  * ```book
  * USE BROWSER
- * USE BROWSER This will be ignored
+ * USE BROWSER Prefer official documentation and source websites.
  * ```
  *
  * @private [🪔] Maybe export the commitments through some package

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