@promptbook/node 0.112.0-53 → 0.112.0-56

package/umd/src/utils/agents/resolveAgentAvatarImageUrl.d.ts

@@ -21,6 +21,10 @@ export type ResolveAgentAvatarOptions = {
          * Optional preferred avatar visual id coming from remote profile payloads.
          */
         readonly avatarVisualId?: AvatarVisualId;
+        /**
+         * Optional server-wide fallback visual id forwarded by federated server payloads.
+         */
+        readonly defaultAgentAvatarVisualId?: AvatarVisualId;
     };
     /**
      * Optional base URL used to resolve relative meta images and placeholders.
@@ -52,6 +56,17 @@ export type ResolvedAgentAvatar = {
     readonly avatarDefinition: AvatarDefinition;
     readonly visualId: AvatarVisualId;
 };
+/**
+ * Resolves the avatar visual preferred by an agent, then falls back to a federated server default
+ * and finally to the caller/server default.
+ *
+ * @param agent Agent metadata and optional remote-profile visual id.
+ * @param defaultAvatarVisualId Optional metadata-resolved server default.
+ * @returns Supported avatar visual id.
+ *
+ * @private shared avatar contract
+ */
+export declare function resolveAgentAvatarVisualId(agent: ResolveAgentAvatarOptions['agent'], defaultAvatarVisualId?: AvatarVisualId): AvatarVisualId;
 /**
  * Resolve the fallback avatar URL for an agent.
  *

package/umd/src/utils/markdown/humanizeAiTextEmdashed.d.ts

@@ -1,6 +1,6 @@
 import type { string_markdown } from '../../types/typeAliases';
 /**
- * Change dash-like characters to regular dashes `—` -> `-` and remove soft hyphens
+ * Change dash-like characters to regular dashes `-` -> `-` and remove soft hyphens
  *
  * Note: [🔂] This function is idempotent.
  * Tip: If you want to do the full cleanup, look for `humanizeAiText` exported `@promptbook/markdown-utils`

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

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

@@ -1,51 +0,0 @@
-import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
-import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
-/**
- * USE commitment definition
- *
- * The USE commitment indicates that the agent should utilize specific tools or capabilities
- * to access and interact with external systems when necessary.
- *
- * Supported USE types:
- * - USE BROWSER: Enables the agent to use a web browser tool
- * - USE SEARCH ENGINE (future): Enables search engine access
- * - USE DEEPSEARCH: Enables deeper research-oriented search access
- * - USE FILE SYSTEM (future): Enables file system operations
- * - USE MCP (future): Enables MCP server connections
- *
- * The content following the USE commitment is ignored (similar to NOTE).
- *
- * Example usage in agent source:
- *
- * ```book
- * USE BROWSER
- * USE SEARCH ENGINE
- * ```
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare class UseCommitmentDefinition extends BaseCommitmentDefinition<`USE${string}`> {
-    constructor();
-    /**
-     * Short one-line description of USE commitments.
-     */
-    get description(): string;
-    /**
-     * Icon for this commitment.
-     */
-    get icon(): string;
-    /**
-     * Markdown documentation for USE commitment.
-     */
-    get documentation(): string;
-    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
-    /**
-     * Extracts the tool type from the USE commitment
-     * This is used by the parsing logic
-     */
-    extractToolType(content: string): string | null;
-    /**
-     * Checks if this is a known USE type
-     */
-    isKnownUseType(useType: string): boolean;
-}

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

@@ -1,51 +0,0 @@
-import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
-import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
-/**
- * USE commitment definition
- *
- * The USE commitment indicates that the agent should utilize specific tools or capabilities
- * to access and interact with external systems when necessary.
- *
- * Supported USE types:
- * - USE BROWSER: Enables the agent to use a web browser tool
- * - USE SEARCH ENGINE (future): Enables search engine access
- * - USE DEEPSEARCH: Enables deeper research-oriented search access
- * - USE FILE SYSTEM (future): Enables file system operations
- * - USE MCP (future): Enables MCP server connections
- *
- * The content following the USE commitment is ignored (similar to NOTE).
- *
- * Example usage in agent source:
- *
- * ```book
- * USE BROWSER
- * USE SEARCH ENGINE
- * ```
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare class UseCommitmentDefinition extends BaseCommitmentDefinition<`USE${string}`> {
-    constructor();
-    /**
-     * Short one-line description of USE commitments.
-     */
-    get description(): string;
-    /**
-     * Icon for this commitment.
-     */
-    get icon(): string;
-    /**
-     * Markdown documentation for USE commitment.
-     */
-    get documentation(): string;
-    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
-    /**
-     * Extracts the tool type from the USE commitment
-     * This is used by the parsing logic
-     */
-    extractToolType(content: string): string | null;
-    /**
-     * Checks if this is a known USE type
-     */
-    isKnownUseType(useType: string): boolean;
-}