@promptbook/cli 0.112.0-46 → 0.112.0-48

package/esm/src/book-components/Chat/Chat/ChatToolCallModalComponents.d.ts

@@ -1,4 +1,6 @@
 import { type ReactNode } from 'react';
+import type { AvatarDefinition } from '../../../avatars/types/AvatarDefinition';
+import type { AvatarVisualId } from '../../../avatars/types/AvatarVisualDefinition';
 /**
  * Props for a team modal header profile badge.
  *
@@ -7,6 +9,8 @@ import { type ReactNode } from 'react';
 export type TeamHeaderProfileProps = {
     label: string;
     avatarSrc?: string | null;
+    avatarDefinition?: AvatarDefinition;
+    avatarVisualId?: AvatarVisualId;
     href?: string;
     fallbackColor?: string;
 };
@@ -15,7 +19,7 @@ export type TeamHeaderProfileProps = {
  *
  * @private component of `<Chat/>`
  */
-export declare function TeamHeaderProfile({ label, avatarSrc, href, fallbackColor }: TeamHeaderProfileProps): import("react/jsx-runtime").JSX.Element;
+export declare function TeamHeaderProfile({ label, avatarSrc, avatarDefinition, avatarVisualId, href, fallbackColor, }: TeamHeaderProfileProps): import("react/jsx-runtime").JSX.Element;
 /**
  * Props for a self-learning modal avatar.
  *
@@ -24,6 +28,8 @@ export declare function TeamHeaderProfile({ label, avatarSrc, href, fallbackColo
 export type SelfLearningAvatarProps = {
     label: string;
     avatarSrc?: string | null;
+    avatarDefinition?: AvatarDefinition;
+    avatarVisualId?: AvatarVisualId;
     fallbackColor?: string;
     className?: string;
     children?: ReactNode;
@@ -33,4 +39,4 @@ export type SelfLearningAvatarProps = {
  *
  * @private component of `<Chat/>`
  */
-export declare function SelfLearningAvatar({ label, avatarSrc, fallbackColor, className, children, }: SelfLearningAvatarProps): import("react/jsx-runtime").JSX.Element;
+export declare function SelfLearningAvatar({ label, avatarSrc, avatarDefinition, avatarVisualId, fallbackColor, className, children, }: SelfLearningAvatarProps): import("react/jsx-runtime").JSX.Element;

package/esm/src/book-components/Chat/Chat/TeamToolCallModalContent.test.d.ts

@@ -0,0 +1,2 @@
+/** @jest-environment jsdom */
+export {};

package/esm/src/book-components/Chat/hooks/useChatCompleteNotification.d.ts

@@ -8,6 +8,8 @@ import type { ChatMessage } from '../types/ChatMessage';
  * - Every streaming chunk / intermediate content update
  * - `message_typing` lifecycle events before the message is finalized
  * - Re-renders of an already-notified completed message (idempotent)
+ * - Initial mount hydration with preloaded completed chat history
+ * - Switching to another chat thread that already contains completed history
  * - User-originated messages
  *
  * @param messages - Current list of chat messages

package/esm/src/book-components/Chat/types/ChatParticipant.d.ts

@@ -1,6 +1,8 @@
 import type { string_book } from '../../../book-2.0/agent-source/string_book';
 import type { id, string_color, string_person_fullname, string_url_image } from '../../../types/typeAliases';
 import { Color } from '../../../utils/color/Color';
+import type { AvatarDefinition } from '../../../avatars/types/AvatarDefinition';
+import type { AvatarVisualId } from '../../../avatars/types/AvatarVisualDefinition';
 /**
  * A participant in the chat
  *
@@ -23,6 +25,14 @@ export type ChatParticipant = {
      * Profile picture
      */
     avatarSrc?: string_url_image;
+    /**
+     * Deterministic avatar definition used when no static image should be shown.
+     */
+    avatarDefinition?: AvatarDefinition;
+    /**
+     * Built-in avatar visual id used with `avatarDefinition`.
+     */
+    avatarVisualId?: AvatarVisualId;
     /**
      * Color associated with the participant
      */

package/esm/src/cli/cli-commands/coder/ensureCoderGitignoreFile.d.ts

@@ -1,6 +1,6 @@
 import type { InitializationStatus } from './boilerplateTemplates';
 /**
- * Ensures `.gitignore` contains the standalone Promptbook coder cache entry.
+ * Ensures `.gitignore` contains the standalone Promptbook coder temp and cache entries.
  *
  * @private function of `initializeCoderProjectConfiguration`
  */

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

@@ -9,6 +9,7 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  * 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
  *

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

@@ -6,7 +6,7 @@ import type { ParsedCommitment } from '../_base/ParsedCommitment';
  *
  * @private internal utility of `createAgentModelRequirementsWithCommitments`
  */
-type AggregatedUseCommitmentType = 'USE BROWSER' | 'USE SEARCH ENGINE' | 'USE TIME';
+type AggregatedUseCommitmentType = 'USE BROWSER' | 'USE DEEPSEARCH' | '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.
  *

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

@@ -0,0 +1,47 @@
+import { string_javascript_name } from '../../_packages/types.index';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * USE DEEPSEARCH commitment definition
+ *
+ * The `USE DEEPSEARCH` commitment indicates that the agent should use a deeper research-oriented
+ * search workflow instead of lightweight web search when it needs fresh information from the internet.
+ *
+ * The content following `USE DEEPSEARCH` is an arbitrary text that the agent should know
+ * (e.g. search scope or research instructions).
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * USE DEEPSEARCH
+ * USE DEEPSEARCH Compare official vendor documentation with independent benchmarks.
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class UseDeepSearchCommitmentDefinition extends BaseCommitmentDefinition<'USE DEEPSEARCH'> {
+    constructor();
+    get requiresContent(): boolean;
+    /**
+     * Short one-line description of USE DEEPSEARCH.
+     */
+    get description(): string;
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string;
+    /**
+     * Markdown documentation for USE DEEPSEARCH commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+    /**
+     * Gets human-readable titles for tool functions provided by this commitment.
+     */
+    getToolTitles(): Record<string_javascript_name, string>;
+    /**
+     * Gets the local fallback implementation for the `deep_search` tool.
+     */
+    getToolFunctions(): Record<string_javascript_name, ToolFunction>;
+}

package/esm/src/commitments/USE_DEEPSEARCH/USE_DEEPSEARCH.test.d.ts

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

package/esm/src/commitments/_common/createSerpSearchToolFunction.d.ts

@@ -0,0 +1,12 @@
+import { string_javascript_name } from '../../_packages/types.index';
+import type { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
+/**
+ * Creates one SERP-backed tool function used as a local fallback for search-like commitments.
+ *
+ * @param toolName - Technical tool name used for validation messages.
+ * @param resultLabel - Human-readable label used in formatted results.
+ * @returns Async tool function compatible with commitment tool registration.
+ *
+ * @private internal helper for search-like commitments
+ */
+export declare function createSerpSearchToolFunction(toolName: string_javascript_name, resultLabel: string): ToolFunction;

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

@@ -38,6 +38,7 @@ import { TemplateCommitmentDefinition } from './TEMPLATE/TEMPLATE';
 import { UseCommitmentDefinition } from './USE/USE';
 import { UseBrowserCommitmentDefinition } from './USE_BROWSER/USE_BROWSER';
 import { UseCalendarCommitmentDefinition } from './USE_CALENDAR/USE_CALENDAR';
+import { UseDeepSearchCommitmentDefinition } from './USE_DEEPSEARCH/USE_DEEPSEARCH';
 import { UseEmailCommitmentDefinition } from './USE_EMAIL/USE_EMAIL';
 import { UseImageGeneratorCommitmentDefinition } from './USE_IMAGE_GENERATOR/USE_IMAGE_GENERATOR';
 import { UseMcpCommitmentDefinition } from './USE_MCP/USE_MCP';
@@ -59,4 +60,4 @@ import { NotYetImplementedCommitmentDefinition } from './_base/NotYetImplemented
  *
  * @private Use functions to access commitments instead of this array directly
  */
-export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, LanguageCommitmentDefinition, LanguageCommitmentDefinition, WritingSampleCommitmentDefinition, WritingRulesCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, TemplateCommitmentDefinition, TemplateCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaDomainCommitmentDefinition, MetaDisclaimerCommitmentDefinition, MetaInputPlaceholderCommitmentDefinition, MetaCommitmentDefinition, MetaVoiceCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, InternalMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageSuffixCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, TeamCommitmentDefinition, UseBrowserCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseSpawnCommitmentDefinition, UseTimeoutCommitmentDefinition, UseTimeCommitmentDefinition, UseUserLocationCommitmentDefinition, UseCalendarCommitmentDefinition, UseEmailCommitmentDefinition, UsePopupCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseMcpCommitmentDefinition, UsePrivacyCommitmentDefinition, UseProjectCommitmentDefinition, UseCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
+export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, LanguageCommitmentDefinition, LanguageCommitmentDefinition, WritingSampleCommitmentDefinition, WritingRulesCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, TemplateCommitmentDefinition, TemplateCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaDomainCommitmentDefinition, MetaDisclaimerCommitmentDefinition, MetaInputPlaceholderCommitmentDefinition, MetaCommitmentDefinition, MetaVoiceCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, InternalMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageSuffixCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, TeamCommitmentDefinition, UseBrowserCommitmentDefinition, UseDeepSearchCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseSpawnCommitmentDefinition, UseTimeoutCommitmentDefinition, UseTimeCommitmentDefinition, UseUserLocationCommitmentDefinition, UseCalendarCommitmentDefinition, UseEmailCommitmentDefinition, UsePopupCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseMcpCommitmentDefinition, UsePrivacyCommitmentDefinition, UseProjectCommitmentDefinition, UseCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];

package/esm/src/config.d.ts

@@ -41,7 +41,7 @@ export declare const ADMIN_GITHUB_NAME: string_name;
  *
  * @public exported from `@promptbook/core`
  */
-export declare const CLAIM = "Turn your company's scattered knowledge into AI ready books";
+export declare const CLAIM = "Create persistent AI agents that turn your company's scattered knowledge into action";
 /**
  * Color of the Promptbook
  *
@@ -89,7 +89,7 @@ export declare const USER_CHAT_COLOR: import("./utils/take/interfaces/ITakeChain
  *
  * @public exported from `@promptbook/core`
  */
-export declare const DEFAULT_BOOK_TITLE = "\u2728 Untitled Book";
+export declare const DEFAULT_BOOK_TITLE = "\uD83D\uDC19 Untitled agent";
 /**
  * When the title of task is not provided, the default title is used
  *

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/cli",
-    "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": {
@@ -102,6 +102,7 @@
         "@azure/openai": "1.0.0-beta.13",
         "@mozilla/readability": "0.6.0",
         "@openai/agents": "0.4.12",
+        "@supabase/supabase-js": "2.81.1",
         "bottleneck": "2.19.5",
         "colors": "1.4.0",
         "commander": "12.0.0",
@@ -121,6 +122,7 @@
         "pg": "8.16.3",
         "prompts": "2.4.2",
         "react": "18.2.0",
+        "react-dom": "18.2.0",
         "rxjs": "7.8.2",
         "showdown": "2.1.0",
         "socket.io": "4.8.3",