@promptbook/google 0.101.0-1 → 0.101.0-10

package/esm/typings/src/book-2.0/commitments/META/META.d.ts

@@ -0,0 +1,62 @@
+import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * META commitment definition
+ *
+ * The META commitment handles all meta-information about the agent such as:
+ * - META IMAGE: Sets the agent's avatar/profile image URL
+ * - META LINK: Provides profile/source links for the person the agent models
+ * - META TITLE: Sets the agent's display title
+ * - META DESCRIPTION: Sets the agent's description
+ * - META [ANYTHING]: Any other meta information in uppercase format
+ *
+ * These commitments are special because they don't affect the system message,
+ * but are handled separately in the parsing logic for profile display.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * META IMAGE https://example.com/avatar.jpg
+ * META LINK https://twitter.com/username
+ * META TITLE Professional Assistant
+ * META DESCRIPTION An AI assistant specialized in business tasks
+ * META AUTHOR John Doe
+ * META VERSION 1.0
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class MetaCommitmentDefinition extends BaseCommitmentDefinition<`META${string}`> {
+    constructor();
+    /**
+     * Short one-line description of META commitments.
+     */
+    get description(): string;
+    /**
+     * Markdown documentation for META commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+    /**
+     * Extracts meta information from the content based on the meta type
+     * This is used by the parsing logic
+     */
+    extractMetaValue(metaType: string, content: string): string | null;
+    /**
+     * Validates if the provided content is a valid URL (for IMAGE and LINK types)
+     */
+    isValidUrl(content: string): boolean;
+    /**
+     * Checks if this is a known meta type
+     */
+    isKnownMetaType(metaType: string): boolean;
+}
+/**
+ * Singleton instance of the META commitment definition
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const MetaCommitment: MetaCommitmentDefinition;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/book-2.0/commitments/MODEL/MODEL.d.ts

@@ -16,8 +16,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class ModelCommitmentDefinition extends BaseCommitmentDefinition<'MODEL'> {
-    constructor();
+export declare class ModelCommitmentDefinition extends BaseCommitmentDefinition<'MODEL' | 'MODELS'> {
+    constructor(type?: 'MODEL' | 'MODELS');
     /**
      * Short one-line description of MODEL.
      */
@@ -34,6 +34,12 @@ export declare class ModelCommitmentDefinition extends BaseCommitmentDefinition<
  * @private [🪔] Maybe export the commitments through some package
  */
 export declare const ModelCommitment: ModelCommitmentDefinition;
+/**
+ * Singleton instance of the MODELS commitment definition
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const ModelsCommitment: ModelCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/NOTE/NOTE.d.ts

@@ -26,8 +26,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class NoteCommitmentDefinition extends BaseCommitmentDefinition<'NOTE'> {
-    constructor();
+export declare class NoteCommitmentDefinition extends BaseCommitmentDefinition<'NOTE' | 'NOTES'> {
+    constructor(type?: 'NOTE' | 'NOTES');
     /**
      * Short one-line description of NOTE.
      */
@@ -44,6 +44,12 @@ export declare class NoteCommitmentDefinition extends BaseCommitmentDefinition<'
  * @private [🪔] Maybe export the commitments through some package
  */
 export declare const NoteCommitment: NoteCommitmentDefinition;
+/**
+ * Singleton instance of the NOTES commitment definition
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const NotesCommitment: NoteCommitmentDefinition;
 /**
  * [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/PERSONA/PERSONA.d.ts

@@ -23,8 +23,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class PersonaCommitmentDefinition extends BaseCommitmentDefinition<'PERSONA'> {
-    constructor();
+export declare class PersonaCommitmentDefinition extends BaseCommitmentDefinition<'PERSONA' | 'PERSONAE'> {
+    constructor(type?: 'PERSONA' | 'PERSONAE');
     /**
      * Short one-line description of PERSONA.
      */
@@ -41,6 +41,12 @@ export declare class PersonaCommitmentDefinition extends BaseCommitmentDefinitio
  * @private [🪔] Maybe export the commitments through some package
  */
 export declare const PersonaCommitment: PersonaCommitmentDefinition;
+/**
+ * Singleton instance of the PERSONAE commitment definition
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const PersonaeCommitment: PersonaCommitmentDefinition;
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/SCENARIO/SCENARIO.d.ts

@@ -0,0 +1,46 @@
+import type { AgentModelRequirements } from '../../agent-source/AgentModelRequirements';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * SCENARIO commitment definition
+ *
+ * The SCENARIO commitment defines a specific situation or context in which the AI
+ * assistant should operate. It helps to set the scene for the AI's responses.
+ * Later scenarios are more important than earlier scenarios.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * SCENARIO You are in a customer service call center during peak hours
+ * SCENARIO The customer is frustrated and has been on hold for 20 minutes
+ * SCENARIO This is the customer's third call about the same issue
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class ScenarioCommitmentDefinition extends BaseCommitmentDefinition<'SCENARIO' | 'SCENARIOS'> {
+    constructor(type?: 'SCENARIO' | 'SCENARIOS');
+    /**
+     * Short one-line description of SCENARIO.
+     */
+    get description(): string;
+    /**
+     * Markdown documentation for SCENARIO commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+}
+/**
+ * Singleton instance of the SCENARIO commitment definition
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const ScenarioCommitment: ScenarioCommitmentDefinition;
+/**
+ * Singleton instance of the SCENARIOS commitment definition
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const ScenariosCommitment: ScenarioCommitmentDefinition;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/book-2.0/commitments/STYLE/STYLE.d.ts

@@ -15,8 +15,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class StyleCommitmentDefinition extends BaseCommitmentDefinition<'STYLE'> {
-    constructor();
+export declare class StyleCommitmentDefinition extends BaseCommitmentDefinition<'STYLE' | 'STYLES'> {
+    constructor(type?: 'STYLE' | 'STYLES');
     /**
      * Short one-line description of STYLE.
      */
@@ -33,6 +33,12 @@ export declare class StyleCommitmentDefinition extends BaseCommitmentDefinition<
  * @private [🪔] Maybe export the commitments through some package
  */
 export declare const StyleCommitment: StyleCommitmentDefinition;
+/**
+ * Singleton instance of the STYLES commitment definition
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const StylesCommitment: StyleCommitmentDefinition;
 /**
  * [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/book-2.0/commitments/index.d.ts

@@ -1,15 +1,19 @@
 import type { BookCommitment } from './_base/BookCommitment';
 import type { CommitmentDefinition } from './_base/CommitmentDefinition';
 import { ActionCommitmentDefinition } from './ACTION/ACTION';
+import { DeleteCommitmentDefinition } from './DELETE/DELETE';
 import { FormatCommitmentDefinition } from './FORMAT/FORMAT';
+import { GoalCommitmentDefinition } from './GOAL/GOAL';
 import { KnowledgeCommitmentDefinition } from './KNOWLEDGE/KNOWLEDGE';
-import { MetaImageCommitmentDefinition } from './META_IMAGE/META_IMAGE';
-import { MetaLinkCommitmentDefinition } from './META_LINK/META_LINK';
+import { MemoryCommitmentDefinition } from './MEMORY/MEMORY';
+import { MessageCommitmentDefinition } from './MESSAGE/MESSAGE';
+import { MetaCommitmentDefinition } from './META/META';
 import { ModelCommitmentDefinition } from './MODEL/MODEL';
 import { NoteCommitmentDefinition } from './NOTE/NOTE';
 import { PersonaCommitmentDefinition } from './PERSONA/PERSONA';
 import { RuleCommitmentDefinition } from './RULE/RULE';
 import { SampleCommitmentDefinition } from './SAMPLE/SAMPLE';
+import { ScenarioCommitmentDefinition } from './SCENARIO/SCENARIO';
 import { StyleCommitmentDefinition } from './STYLE/STYLE';
 import { NotYetImplementedCommitmentDefinition } from './_base/NotYetImplementedCommitmentDefinition';
 /**
@@ -19,7 +23,7 @@ import { NotYetImplementedCommitmentDefinition } from './_base/NotYetImplemented
  *
  * @private Use functions to access commitments instead of this array directly
  */
-export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, MetaImageCommitmentDefinition, MetaLinkCommitmentDefinition, NoteCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"SCENARIO">, NotYetImplementedCommitmentDefinition<"SCENARIOS">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"GOAL">, NotYetImplementedCommitmentDefinition<"GOALS">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
+export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, MetaCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
 /**
  * Gets a commitment definition by its type
  * @param type The commitment type to look up

package/esm/typings/src/book-components/AvatarProfile/AvatarProfile/MockedChat.d.ts

@@ -0,0 +1,46 @@
+import type { ChatProps } from '../../Chat/Chat/ChatProps';
+/**
+ * Delay configuration for the MockedChat component
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type MockedChatDelayConfig = {
+    /**
+     * Delay before showing the first message (in milliseconds)
+     * @default 1000
+     */
+    beforeFirstMessage?: number;
+    /**
+     * Emulated thinking time between messages (in milliseconds)
+     * @default 2000
+     */
+    thinkingBetweenMessages?: number;
+    /**
+     * Wait time after each written word (in milliseconds)
+     * @default 100
+     */
+    waitAfterWord?: number;
+    /**
+     * Extra delay on top of the word waiting (in milliseconds)
+     * @default 50
+     */
+    extraWordDelay?: number;
+};
+/**
+ * Props for MockedChat component
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type MockedChatProps = ChatProps & {
+    /**
+     * Optional delays configuration for emulating typing behavior
+     */
+    delayConfig?: MockedChatDelayConfig;
+};
+/**
+ * MockedChat component that shows the same chat as Chat but emulates ongoing discussion
+ * with realistic typing delays and thinking pauses.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function MockedChat(props: MockedChatProps): import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/book-components/AvatarProfile/AvatarProfile/index.d.ts

@@ -0,0 +1,3 @@
+export * from './AvatarProfile';
+export * from './AvatarProfileFromSource';
+export * from './MockedChat';

package/esm/typings/src/book-components/BookEditor/BookEditor.d.ts

@@ -1,5 +1,7 @@
 import type { CSSProperties } from 'react';
+import type { Promisable } from 'type-fest';
 import type { string_book } from '../../book-2.0/agent-source/string_book';
+import { string_knowledge_source_content } from '../../types/typeAliases';
 /**
  * Props of `BookEditor`
  *
@@ -27,10 +29,18 @@ export type BookEditorProps = {
      * Callback function to handle changes in the book content.
      */
     onChange?(value: string_book): void;
+    /**
+     * returns the URL of the uploaded file on CDN or storage
+     */
+    onFileUpload?(file: File): Promisable<string_knowledge_source_content>;
     /**
      * If true, logs verbose debug info to the console and shows additional visual cues
      */
     readonly isVerbose?: boolean;
+    /**
+     * If true, disables border radius making the editor have sharp corners
+     */
+    readonly isBorderRadiusDisabled?: boolean;
 };
 /**
  * Renders a book editor

package/esm/typings/src/book-components/BookEditor/BookEditorInner.d.ts

@@ -1,3 +1,4 @@
+import { Promisable } from 'type-fest';
 import type { string_book } from '../../book-2.0/agent-source/string_book';
 /**
  * @private util of `<BookEditor />`
@@ -7,7 +8,9 @@ export type BookEditorInnerProps = {
     fontClassName?: string;
     value?: string_book;
     onChange?(value: string_book): void;
+    onFileUpload?(file: File): Promisable<string>;
     isVerbose?: boolean;
+    isBorderRadiusDisabled?: boolean;
 };
 /**
  * @private util of `<BookEditor />`

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

@@ -1,9 +1,4 @@
 import type { ChatProps } from './ChatProps';
-/**
- * @deprecated use `isComplete` instead
- * @private util of `<Chat />`
- */
-export declare const LOADING_INTERACTIVE_IMAGE = "Loading...";
 /**
  * Renders a chat with messages and input for new messages
  *

package/esm/typings/src/book-components/Chat/Chat/ChatProps.d.ts

@@ -23,10 +23,16 @@ export type ChatProps = {
      * Called when user sends a message
      *
      * Note: You must handle the message yourself and add it to the `messages` array
+     *
+     * - When set, the send textarea and button will be shown
+     * - When undefined, the chat has no input and is read-only showing only the messages
      */
-    onMessage(messageContent: string): Promisable<void>;
+    onMessage?(messageContent: string): Promisable<void>;
     /**
-     * Optional callback, when set, button for resetting chat will be shown
+     * Optional callback
+     *
+     * - When set, button for resetting chat will be shown
+     * - When undefined, no reset button will be shown
      */
     onReset?(): Promisable<void>;
     /**
@@ -113,4 +119,24 @@ export type ChatProps = {
      * Keys should match ChatMessage.from values (e.g., 'USER', 'AGENT_{id}', etc.)
      */
     readonly participants?: ReadonlyArray<ChatParticipant>;
+    /**
+     * Optional callback for handling user feedback on messages
+     * When provided, star rating buttons (1-5 stars) will be displayed next to each message
+     *
+     * @param feedback - Object containing the feedback data
+     * @param feedback.message - The message being rated
+     * @param feedback.rating - Star rating from 1 to 5
+     * @param feedback.textRating - Optional text feedback/note from user
+     * @param feedback.chatThread - Complete chat thread as string
+     * @param feedback.expectedAnswer - Optional expected answer provided by user
+     * @param feedback.url - Current page URL where feedback was given
+     */
+    onFeedback?(feedback: {
+        message: ChatMessage;
+        rating: number;
+        textRating: string;
+        chatThread: string;
+        expectedAnswer: string | null;
+        url: string;
+    }): Promisable<void>;
 };

package/esm/typings/src/book-components/Chat/Chat/constants.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @deprecated use `isComplete` instead
+ * @private util of `<Chat />`
+ */
+export declare const LOADING_INTERACTIVE_IMAGE = "Loading...";
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/book-components/icons/ArrowIcon.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Shows simple arrow icon pointing up or down
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare const ArrowIcon: ({ direction, size }: {
+    direction: string;
+    size: number;
+}) => import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/book-components/icons/ResetIcon.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Shows simple reset icon
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare const ResetIcon: () => import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/book-components/icons/SendIcon.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shows simple send icon
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare const SendIcon: ({ size }: {
+    size: number;
+}) => import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/book-components/icons/TemplateIcon.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shows simple template icon
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare const TemplateIcon: ({ size }: {
+    size: number;
+}) => import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/utils/markdown/humanizeAiText.d.ts

@@ -9,5 +9,6 @@ import { string_markdown } from '../../types/typeAliases';
  */
 export declare function humanizeAiText(aiText: string_markdown): string_markdown;
 /**
+ * TODO: [🧠] Maybe this should be exported from `@promptbook/utils` not `@promptbook/markdown-utils`
  * TODO: [🅾️] !!! Use this across the project where AI text is involved
  */

package/esm/typings/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.101.0-0`).
+ * It follows semantic versioning (e.g., `0.101.0-9`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/google",
-    "version": "0.101.0-1",
+    "version": "0.101.0-10",
     "description": "Promptbook: Run AI apps in plain human language across multiple models and platforms",
     "private": false,
     "sideEffects": false,
@@ -95,7 +95,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/google.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.101.0-1"
+        "@promptbook/core": "0.101.0-10"
     },
     "dependencies": {
         "@ai-sdk/google": "1.0.5",

package/umd/index.umd.js

@@ -23,7 +23,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.101.0-1';
+    const PROMPTBOOK_ENGINE_VERSION = '0.101.0-10';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name