@promptbook/wizard 0.100.0-14 → 0.100.0-16

package/esm/index.es.js

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

package/esm/typings/src/_packages/core.index.d.ts

@@ -1,4 +1,11 @@
 import { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION } from '../version';
+import { parseAgentSource } from '../book-2.0/agent-source/parseAgentSource';
+import { isAgentSource } from '../book-2.0/agent-source/string_agent_source';
+import { validateAgentSource } from '../book-2.0/agent-source/string_agent_source';
+import { createEmptyAgentModelRequirements } from '../book-2.0/commitments/_base/createEmptyAgentModelRequirements';
+import { createBasicAgentModelRequirements } from '../book-2.0/commitments/_base/createEmptyAgentModelRequirements';
+import { NotYetImplementedCommitmentDefinition } from '../book-2.0/commitments/_base/NotYetImplementedCommitmentDefinition';
+import { createAgentModelRequirements } from '../book-2.0/commitments/_misc/createAgentModelRequirements';
 import { collectionToJson } from '../collection/collectionToJson';
 import { createCollectionFromJson } from '../collection/constructors/createCollectionFromJson';
 import { createCollectionFromPromise } from '../collection/constructors/createCollectionFromPromise';
@@ -148,6 +155,13 @@ import { SectionTypes } from '../types/SectionType';
 import { TaskTypes } from '../types/TaskType';
 import { REMOTE_SERVER_URLS } from '../../servers';
 export { BOOK_LANGUAGE_VERSION, PROMPTBOOK_ENGINE_VERSION };
+export { parseAgentSource };
+export { isAgentSource };
+export { validateAgentSource };
+export { createEmptyAgentModelRequirements };
+export { createBasicAgentModelRequirements };
+export { NotYetImplementedCommitmentDefinition };
+export { createAgentModelRequirements };
 export { collectionToJson };
 export { createCollectionFromJson };
 export { createCollectionFromPromise };

package/esm/typings/src/_packages/types.index.d.ts

@@ -1,3 +1,16 @@
+import type { AgentSourceBasicInformation } from '../book-2.0/agent-source/parseAgentSource';
+import type { string_agent_source } from '../book-2.0/agent-source/string_agent_source';
+import type { BookCommitment } from '../book-2.0/commitments/_base/BookCommitment';
+import type { CommitmentDefinition } from '../book-2.0/commitments/_base/CommitmentDefinition';
+import type { AgentModelRequirements } from '../book-2.0/commitments/_misc/AgentModelRequirements';
+import type { AgentSourceParseResult } from '../book-2.0/commitments/_misc/AgentSourceParseResult';
+import type { ParsedCommitment } from '../book-2.0/commitments/_misc/ParsedCommitment';
+import type { KnowledgeSourceFormat } from '../book-2.0/commitments/KNOWLEDGE/types';
+import type { KnowledgeSourceMetadata } from '../book-2.0/commitments/KNOWLEDGE/types';
+import type { KnowledgeChunk } from '../book-2.0/commitments/KNOWLEDGE/types';
+import type { KnowledgeBase } from '../book-2.0/commitments/KNOWLEDGE/types';
+import type { RetrievalResult } from '../book-2.0/commitments/KNOWLEDGE/types';
+import type { RAGConfig } from '../book-2.0/commitments/KNOWLEDGE/types';
 import type { PipelineCollection } from '../collection/PipelineCollection';
 import type { Command } from '../commands/_common/types/Command';
 import type { CommandParser } from '../commands/_common/types/CommandParser';
@@ -177,6 +190,7 @@ import type { InputParameters } from '../types/typeAliases';
 import type { string_reserved_parameter_name } from '../types/typeAliases';
 import type { ReservedParameters } from '../types/typeAliases';
 import type { string_title } from '../types/typeAliases';
+import type { string_agent_name } from '../types/typeAliases';
 import type { string_persona_description } from '../types/typeAliases';
 import type { string_model_description } from '../types/typeAliases';
 import type { string_knowledge_source_content } from '../types/typeAliases';
@@ -302,6 +316,19 @@ import type { TODO_any } from '../utils/organization/TODO_any';
 import type { CheckSerializableAsJsonOptions } from '../utils/serialization/checkSerializableAsJson';
 import type { ExportJsonOptions } from '../utils/serialization/exportJson';
 import type { string_promptbook_version } from '../version';
+export type { AgentSourceBasicInformation };
+export type { string_agent_source };
+export type { BookCommitment };
+export type { CommitmentDefinition };
+export type { AgentModelRequirements };
+export type { AgentSourceParseResult };
+export type { ParsedCommitment };
+export type { KnowledgeSourceFormat };
+export type { KnowledgeSourceMetadata };
+export type { KnowledgeChunk };
+export type { KnowledgeBase };
+export type { RetrievalResult };
+export type { RAGConfig };
 export type { PipelineCollection };
 export type { Command };
 export type { CommandParser };
@@ -481,6 +508,7 @@ export type { InputParameters };
 export type { string_reserved_parameter_name };
 export type { ReservedParameters };
 export type { string_title };
+export type { string_agent_name };
 export type { string_persona_description };
 export type { string_model_description };
 export type { string_knowledge_source_content };

package/esm/typings/src/book-2.0/agent-source/parseAgentSource.d.ts

@@ -0,0 +1,30 @@
+import type { string_agent_name } from '../../types/typeAliases';
+import type { string_url_image } from '../../types/typeAliases';
+import type { string_agent_source } from './string_agent_source';
+export interface AgentSourceBasicInformation {
+    /**
+     * Name of the agent
+     * This is the first line of the agent source
+     */
+    agentName: string_agent_name | null;
+    /**
+     * Optional description of the agent
+     * This is the line starting with "PERSONA"
+     */
+    personaDescription: string | null;
+    /**
+     * Optional profile image URL
+     * This is the line starting with "META IMAGE"
+     */
+    profileImageUrl: string_url_image;
+}
+/**
+ * Parses basic information from agent source
+ *
+ * There are 2 similar functions:
+ * - `parseAgentSource` which is a lightweight parser for agent source, it parses basic information and its purpose is to be quick and synchronous. The commitments there are hardcoded.
+ * - `createAgentModelRequirements` which is an asynchronous function that creates model requirements it applies each commitment one by one and works asynchronously.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function parseAgentSource(agentSource: string_agent_source): AgentSourceBasicInformation;

package/esm/typings/src/book-2.0/agent-source/parseAgentSource.test.d.ts

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

package/esm/typings/src/book-2.0/agent-source/string_agent_source.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Branded type for agent source strings
+ *
+ * This ensures type safety when working with agent source data throughout the application.
+ * Agent source strings contain structured data in a specific format:
+ * - First line: Agent name
+ * - PERSONA line: Agent persona/description (optional)
+ * - META IMAGE line: Profile image URL (optional)
+ * - Remaining content: System message (after removing META IMAGE line)
+ */
+export type string_agent_source = string & {
+    readonly __brand: 'agent_source';
+};
+/**
+ * Type guard to check if a string is a valid agent source
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function isAgentSource(value: string): value is string_agent_source;
+/**
+ * Creates a branded agent source string from a regular string
+ * Performs basic validation to ensure the string is suitable as agent source
+ *
+ * @private
+ * @deprecated Use `validateAgentSource` instead - these functions are now equivalent
+ */
+export declare function createAgentSource(source: string): string_agent_source;
+/**
+ * Safely converts a string to agent source with fallback
+ *
+ * @private
+ * @deprecated Use `validateAgentSource` instead - these functions are now equivalent
+ */
+export declare function toAgentSource(source: string, fallback?: string): string_agent_source;
+/**
+ * Validates and converts a string to agent source branded type
+ * This function should be used when you have a string that you know represents agent source
+ * but need to convert it to the branded type for type safety
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function validateAgentSource(source: string): string_agent_source;

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

@@ -0,0 +1,30 @@
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+import type { AgentModelRequirements } from '../_misc/AgentModelRequirements';
+/**
+ * ACTION commitment definition
+ *
+ * The ACTION commitment defines specific actions or capabilities that the agent can perform.
+ * This helps define what the agent is capable of doing and how it should approach tasks.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * ACTION Can generate code snippets and explain programming concepts
+ * ACTION Able to analyze data and provide insights
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class ActionCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor();
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+}
+/**
+ * Singleton instance of the ACTION commitment definition
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const ActionCommitment: ActionCommitmentDefinition;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

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

@@ -0,0 +1,31 @@
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+import type { AgentModelRequirements } from '../_misc/AgentModelRequirements';
+/**
+ * FORMAT commitment definition
+ *
+ * The FORMAT commitment defines the specific output structure and formatting
+ * that the agent should use in its responses. This includes data formats,
+ * response templates, and structural requirements.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * FORMAT Always respond in JSON format with 'status' and 'data' fields
+ * FORMAT Use markdown formatting for all code blocks
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class FormatCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor();
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+}
+/**
+ * Singleton instance of the FORMAT commitment definition
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const FormatCommitment: FormatCommitmentDefinition;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

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

@@ -0,0 +1,48 @@
+import type { string_url } from '../../../types/typeAliases';
+import type { RAGConfig } from './types';
+import type { RetrievalResult } from './types';
+/**
+ * Frontend RAG Service that uses backend APIs for processing
+ * This avoids Node.js dependencies in the frontend
+ *
+ * @private - TODO: [🧠] Maybe should be public?
+ */
+export declare class FrontendRAGService {
+    private chunks;
+    private sources;
+    private config;
+    private isInitialized;
+    constructor(config?: Partial<RAGConfig>);
+    /**
+     * Initialize knowledge sources by processing them on the backend
+     */
+    initializeKnowledgeSources(sources: string_url[]): Promise<void>;
+    /**
+     * Get relevant context for a user query
+     */
+    getContextForQuery(query: string): Promise<string>;
+    /**
+     * Get relevant chunks for a query (for debugging/inspection)
+     */
+    getRelevantChunks(query: string): Promise<RetrievalResult[]>;
+    /**
+     * Get knowledge base statistics
+     */
+    getStats(): {
+        sources: number;
+        chunks: number;
+        isInitialized: boolean;
+    };
+    /**
+     * Check if the service is ready to use
+     */
+    isReady(): boolean;
+    /**
+     * Clear all knowledge sources
+     */
+    clearKnowledgeBase(): void;
+    /**
+     * Add a single knowledge source (for incremental updates)
+     */
+    addKnowledgeSource(url: string_url): Promise<void>;
+}

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

@@ -0,0 +1,43 @@
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+import type { AgentModelRequirements } from '../_misc/AgentModelRequirements';
+import { FrontendRAGService } from './FrontendRAGService';
+/**
+ * KNOWLEDGE commitment definition
+ *
+ * The KNOWLEDGE commitment adds specific knowledge, facts, or context to the agent
+ * using RAG (Retrieval-Augmented Generation) approach for external sources.
+ *
+ * Supports both direct text knowledge and external sources like PDFs.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * KNOWLEDGE The company was founded in 2020 and specializes in AI-powered solutions
+ * KNOWLEDGE https://example.com/company-handbook.pdf
+ * KNOWLEDGE https://example.com/product-documentation.pdf
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class KnowledgeCommitmentDefinition extends BaseCommitmentDefinition {
+    private ragService;
+    constructor();
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+    /**
+     * Check if content is a URL
+     */
+    private isUrl;
+    /**
+     * Get RAG service instance for retrieving context during chat
+     */
+    getRagService(): FrontendRAGService;
+}
+/**
+ * Singleton instance of the KNOWLEDGE commitment definition
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const KnowledgeCommitment: KnowledgeCommitmentDefinition;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

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

@@ -0,0 +1,54 @@
+import type { string_url } from '../../../types/typeAliases';
+import type { RAGConfig } from './types';
+import type { RetrievalResult } from './types';
+/**
+ * RAG (Retrieval-Augmented Generation) Service
+ * Handles knowledge source processing and retrieval
+ *
+ * @private
+ */
+export declare class RAGService {
+    private knowledgeBase;
+    private config;
+    constructor(config?: Partial<RAGConfig>);
+    /**
+     * Add a knowledge source from URL
+     */
+    addKnowledgeSource(url: string_url): Promise<void>;
+    /**
+     * Retrieve relevant chunks for a query
+     */
+    retrieveRelevantChunks(query: string): RetrievalResult[];
+    /**
+     * Get formatted context for the agent
+     */
+    getContextForQuery(query: string): string;
+    /**
+     * Get knowledge base statistics
+     */
+    getStats(): {
+        sources: number;
+        chunks: number;
+        lastUpdated: Date;
+    };
+    /**
+     * Clear all knowledge sources
+     */
+    clearKnowledgeBase(): void;
+    /**
+     * Tokenize query into words for relevance scoring
+     */
+    private tokenizeQuery;
+    /**
+     * Calculate relevance score between content and query words
+     * Simple keyword matching - in production, use embeddings
+     */
+    private calculateRelevanceScore;
+    /**
+     * Generate content hash for caching
+     */
+    private generateContentHash;
+}
+/**
+ * TODO: !!!! use the already existing RAG instead of this
+ */

package/esm/typings/src/book-2.0/commitments/KNOWLEDGE/processors/BaseKnowledgeProcessor.d.ts

@@ -0,0 +1,45 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import type { TODO_any } from '../../../../utils/organization/TODO_any';
+import type { string_url } from '../../../../types/typeAliases';
+import type { KnowledgeChunk } from '../types';
+import type { KnowledgeSourceFormat } from '../types';
+import type { RAGConfig } from '../types';
+/**
+ * Base class for knowledge source processors
+ * Provides common functionality for all knowledge processors
+ *
+ * @private
+ */
+export declare abstract class BaseKnowledgeProcessor {
+    protected readonly config: RAGConfig;
+    constructor(config?: Partial<RAGConfig>);
+    /**
+     * The format this processor supports
+     */
+    abstract readonly supportedFormat: KnowledgeSourceFormat;
+    /**
+     * Process a buffer and return knowledge chunks
+     */
+    abstract processBuffer(buffer: Buffer, sourceUrl: string_url): Promise<KnowledgeChunk[]>;
+    /**
+     * Generate a content hash for caching purposes
+     */
+    protected generateContentHash(content: string): string;
+    /**
+     * Generate a unique chunk ID
+     */
+    protected generateChunkId(sourceUrl: string_url, chunkIndex: number): string;
+    /**
+     * Split text into sentences for better chunking
+     */
+    protected splitIntoSentences(text: string): string[];
+    /**
+     * Get overlap text from the end of current chunk
+     */
+    protected getOverlapText(text: string, overlapSize: number): string;
+    /**
+     * Create chunks from text with proper overlap handling
+     */
+    protected createChunksFromText(text: string, sourceUrl: string_url, additionalMetadata?: Record<string, TODO_any>): KnowledgeChunk[];
+}

package/esm/typings/src/book-2.0/commitments/KNOWLEDGE/processors/PdfProcessor.d.ts

@@ -0,0 +1,31 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import type { string_url } from '../../../../types/typeAliases';
+import type { KnowledgeChunk } from '../types';
+import { BaseKnowledgeProcessor } from './BaseKnowledgeProcessor';
+/**
+ * PDF knowledge source processor
+ * Handles extraction and chunking of PDF documents
+ *
+ * @private
+ */
+export declare class PdfProcessor extends BaseKnowledgeProcessor {
+    readonly supportedFormat: "pdf";
+    /**
+     * Process PDF buffer and extract text content
+     */
+    processBuffer(buffer: Buffer, sourceUrl: string_url): Promise<KnowledgeChunk[]>;
+    /**
+     * Extract title from PDF text (first meaningful line)
+     */
+    private extractTitleFromText;
+    /**
+     * Create chunks from PDF text with page awareness
+     */
+    protected createChunksFromText(text: string, sourceUrl: string_url, pdfInfo: {
+        totalPages: number;
+    }): KnowledgeChunk[];
+}
+/**
+ * TODO: !!!! Implement this through standard knowledge scraper
+ */

package/esm/typings/src/book-2.0/commitments/KNOWLEDGE/processors/ProcessorFactory.d.ts

@@ -0,0 +1,23 @@
+import type { string_url } from '../../../../types/typeAliases';
+import type { KnowledgeSourceFormat } from '../types';
+import type { RAGConfig } from '../types';
+import { BaseKnowledgeProcessor } from './BaseKnowledgeProcessor';
+/**
+ * Factory for creating knowledge source processors
+ *
+ * @private
+ */
+export declare class ProcessorFactory {
+    /**
+     * Get processor for a specific format
+     */
+    static getProcessor(format: KnowledgeSourceFormat, config?: Partial<RAGConfig>): BaseKnowledgeProcessor;
+    /**
+     * Detect format from URL
+     */
+    static detectFormat(url: string_url): KnowledgeSourceFormat;
+    /**
+     * Get all supported formats
+     */
+    static getSupportedFormats(): KnowledgeSourceFormat[];
+}

package/esm/typings/src/book-2.0/commitments/KNOWLEDGE/processors/TextProcessor.d.ts

@@ -0,0 +1,18 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import type { string_url } from '../../../../types/typeAliases';
+import type { KnowledgeChunk } from '../types';
+import { BaseKnowledgeProcessor } from './BaseKnowledgeProcessor';
+/**
+ * Text knowledge source processor
+ * Handles plain text documents
+ *
+ * @private
+ */
+export declare class TextProcessor extends BaseKnowledgeProcessor {
+    readonly supportedFormat: "text";
+    /**
+     * Process text buffer and extract content
+     */
+    processBuffer(buffer: Buffer, sourceUrl: string_url): Promise<KnowledgeChunk[]>;
+}

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

@@ -0,0 +1,56 @@
+import type { string_url } from '../../../types/typeAliases';
+/**
+ * Supported knowledge source formats
+ */
+export type KnowledgeSourceFormat = 'pdf' | 'text' | 'markdown' | 'html';
+/**
+ * Knowledge source metadata
+ */
+export interface KnowledgeSourceMetadata {
+    readonly url: string_url;
+    readonly format: KnowledgeSourceFormat;
+    readonly title?: string;
+    readonly lastFetched?: Date;
+    readonly contentHash?: string;
+}
+/**
+ * Processed knowledge chunk for RAG
+ */
+export interface KnowledgeChunk {
+    readonly id: string;
+    readonly sourceUrl: string_url;
+    readonly content: string;
+    readonly metadata: {
+        readonly pageNumber?: number;
+        readonly section?: string;
+        readonly chunkIndex: number;
+        readonly totalChunks: number;
+    };
+}
+/**
+ * Knowledge base containing all processed knowledge sources
+ */
+export interface KnowledgeBase {
+    readonly sources: KnowledgeSourceMetadata[];
+    readonly chunks: KnowledgeChunk[];
+    readonly lastUpdated: Date;
+}
+/**
+ * RAG retrieval result
+ */
+export interface RetrievalResult {
+    readonly chunk: KnowledgeChunk;
+    readonly relevanceScore: number;
+}
+/**
+ * Configuration for RAG processing
+ */
+export interface RAGConfig {
+    readonly maxChunkSize: number;
+    readonly chunkOverlap: number;
+    readonly maxRetrievedChunks: number;
+    readonly minRelevanceScore: number;
+}
+/**
+ * [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/book-2.0/commitments/KNOWLEDGE/utils/ragHelper.d.ts

@@ -0,0 +1,34 @@
+import type { AgentModelRequirements } from '../../_misc/AgentModelRequirements';
+import { FrontendRAGService } from '../FrontendRAGService';
+/**
+ * Helper utilities for RAG processing in chat systems
+ *
+ * @private
+ */
+export declare class RAGHelper {
+    /**
+     * Initialize knowledge sources from agent requirements
+     * This should be called when starting a chat session
+     */
+    static initializeKnowledgeSources(requirements: AgentModelRequirements): Promise<FrontendRAGService | null>;
+    /**
+     * Get relevant context for a user query
+     * This should be called before sending the query to the AI model
+     */
+    static getRelevantContext(ragService: FrontendRAGService | null, userQuery: string): Promise<string>;
+    /**
+     * Update system message with relevant context for a query
+     */
+    static updateSystemMessageWithContext(requirements: AgentModelRequirements, ragService: FrontendRAGService | null, userQuery: string): Promise<AgentModelRequirements>;
+    /**
+     * Get statistics about the knowledge base
+     */
+    static getKnowledgeStats(ragService: FrontendRAGService | null): {
+        sources: number;
+        chunks: number;
+        isInitialized: boolean;
+    } | null;
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

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

@@ -0,0 +1,36 @@
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+import type { AgentModelRequirements } from '../_misc/AgentModelRequirements';
+/**
+ * META IMAGE commitment definition
+ *
+ * The META IMAGE commitment sets the agent's avatar/profile image URL.
+ * This commitment is special because it doesn't affect the system message,
+ * but is handled separately in the parsing logic.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * META IMAGE https://example.com/avatar.jpg
+ * META IMAGE /assets/agent-avatar.png
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class MetaImageCommitmentDefinition extends BaseCommitmentDefinition {
+    constructor();
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+    /**
+     * Extracts the profile image URL from the content
+     * This is used by the parsing logic
+     */
+    extractProfileImageUrl(content: string): string | null;
+}
+/**
+ * Singleton instance of the META IMAGE commitment definition
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare const MetaImageCommitment: MetaImageCommitmentDefinition;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */