@promptbook/types 0.112.0-57 → 0.112.0-59

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/types",
-    "version": "0.112.0-57",
+    "version": "0.112.0-59",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,
@@ -96,6 +96,6 @@
     "types": "./esm/src/_packages/types.index.d.ts",
     "typings": "./esm/src/_packages/types.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.112.0-57"
+        "@promptbook/core": "0.112.0-59"
     }
 }

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