@promptbook/editable 0.112.0-46 → 0.112.0-48

package/esm/src/llm-providers/agent/RemoteAgent.d.ts

@@ -2,6 +2,7 @@ import type { CallChatModelStreamOptions } from '../../execution/LlmExecutionToo
 import type { ChatPromptResult } from '../../execution/PromptResult';
 import type { Prompt } from '../../types/Prompt';
 import type { string_agent_hash, string_agent_name } from '../../types/typeAliases';
+import type { AvatarVisualId } from '../../avatars/types/AvatarVisualDefinition';
 import { Agent } from './Agent';
 import type { RemoteAgentOptions } from './RemoteAgentOptions';
 /**
@@ -28,6 +29,8 @@ export declare class RemoteAgent extends Agent {
     toolTitles: Record<string, string>;
     private _isVoiceCallingEnabled;
     private _isVoiceTtsSttEnabled;
+    isMetaImageExplicit: boolean;
+    avatarVisualId: AvatarVisualId | undefined;
     /**
      * Indicates whether the remote server allows text-to-speech and speech-to-text.
      *

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

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

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

@@ -1,3 +1,5 @@
+import type { AvatarDefinition } from '../../avatars/types/AvatarDefinition';
+import type { AvatarVisualId } from '../../avatars/types/AvatarVisualDefinition';
 import type { AgentBasicInformation } from '../../book-2.0/agent-source/AgentBasicInformation';
 import type { string_url, string_url_image } from '../../types/typeAliases';
 /**
@@ -5,25 +7,67 @@ import type { string_url, string_url_image } from '../../types/typeAliases';
  *
  * @private utility of `<Chat/>`
  */
-export type ResolveAgentAvatarImageUrlOptions = {
+export type ResolveAgentAvatarOptions = {
     /**
      * Agent metadata used for avatar resolution.
      */
-    readonly agent: Pick<AgentBasicInformation, 'agentName' | 'permanentId' | 'meta'>;
+    readonly agent: Pick<AgentBasicInformation, 'agentName' | 'agentHash' | 'permanentId' | 'meta'> & {
+        /**
+         * Optional explicit marker coming from remote profile payloads.
+         * When `false`, `meta.image` is treated as the generated static fallback rather than a user-defined `META IMAGE`.
+         */
+        readonly isMetaImageExplicit?: boolean;
+        /**
+         * Optional preferred avatar visual id coming from remote profile payloads.
+         */
+        readonly avatarVisualId?: AvatarVisualId;
+    };
     /**
      * Optional base URL used to resolve relative meta images and placeholders.
      */
     readonly baseUrl?: string_url;
 };
+/**
+ * Backward-compatible alias kept for callers that only need image URLs.
+ *
+ * @private utility of `<Chat/>`
+ */
+export type ResolveAgentAvatarImageUrlOptions = ResolveAgentAvatarOptions;
+/**
+ * Default built-in avatar visual used when an agent does not define `META IMAGE`.
+ *
+ * @private shared avatar contract
+ */
+export declare const DEFAULT_AGENT_AVATAR_VISUAL_ID: AvatarVisualId;
+/**
+ * Resolved avatar descriptor used by interactive UIs to pick either an image or a live canvas visual.
+ *
+ * @private shared avatar contract
+ */
+export type ResolvedAgentAvatar = {
+    readonly type: 'image';
+    readonly imageUrl: string_url_image;
+} | {
+    readonly type: 'visual';
+    readonly avatarDefinition: AvatarDefinition;
+    readonly visualId: AvatarVisualId;
+};
 /**
  * Resolve the fallback avatar URL for an agent.
  *
  * @private utility of `<Chat/>`
  */
-export declare function resolveAgentAvatarFallbackUrl(options: ResolveAgentAvatarImageUrlOptions): string_url_image | null;
+export declare function resolveAgentAvatarFallbackUrl(options: ResolveAgentAvatarOptions): string_url_image | null;
+/**
+ * Resolve the best avatar representation for an agent, preferring explicit `META IMAGE`
+ * and otherwise returning the default deterministic canvas visual.
+ *
+ * @private utility of `<Chat/>`
+ */
+export declare function resolveAgentAvatar(options: ResolveAgentAvatarOptions): ResolvedAgentAvatar | null;
 /**
- * Resolve the best avatar URL for an agent, preferring META IMAGE and falling back to placeholders.
+ * Resolve the best avatar URL for an agent, preferring `META IMAGE` and falling back to the static placeholder route.
  *
  * @private utility of `<Chat/>`
  */
-export declare function resolveAgentAvatarImageUrl(options: ResolveAgentAvatarImageUrlOptions): string_url_image | null;
+export declare function resolveAgentAvatarImageUrl(options: ResolveAgentAvatarOptions): string_url_image | null;

package/esm/src/utils/agents/resolveAgentAvatarImageUrl.test.d.ts

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

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

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@promptbook/editable",
-    "version": "0.112.0-46",
-    "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
+    "version": "0.112.0-48",
+    "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,
     "repository": {
@@ -99,7 +99,7 @@
     "types": "./esm/src/_packages/editable.index.d.ts",
     "typings": "./esm/src/_packages/editable.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.112.0-46"
+        "@promptbook/core": "0.112.0-48"
     },
     "dependencies": {
         "crypto-js": "4.2.0",

package/umd/index.umd.js

@@ -22,7 +22,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-46';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-48';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -1034,7 +1034,7 @@
      *
      * @public exported from `@promptbook/core`
      */
-    const DEFAULT_BOOK_TITLE = `✨ Untitled Book`;
+    const DEFAULT_BOOK_TITLE = `🐙 Untitled agent`;
     /**
      * When the pipeline is flat and no name of return parameter is provided, this name is used
      *