@promptbook/javascript 0.111.0-3 → 0.111.0-7

package/umd/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments.agentReferenceResolver.test.d.ts

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

package/umd/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments.blocks.test.d.ts

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

package/umd/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments.closed.test.d.ts

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

package/umd/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments.d.ts

@@ -0,0 +1,10 @@
+import type { string_model_name } from '../../types/typeAliases';
+import type { AgentModelRequirements } from './AgentModelRequirements';
+import type { CreateAgentModelRequirementsOptions } from './CreateAgentModelRequirementsOptions';
+import type { string_book } from './string_book';
+/**
+ * @@@
+ *
+ * @private @@@
+ */
+export declare function createAgentModelRequirementsWithCommitments(agentSource: string_book, modelName?: string_model_name, options?: CreateAgentModelRequirementsOptions): Promise<AgentModelRequirements>;

package/umd/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments.delete.test.d.ts

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

package/umd/src/book-2.0/agent-source/createAgentModelRequirementsWithCommitments.import.test.d.ts

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

package/umd/src/book-2.0/agent-source/createCommitmentRegex.d.ts

@@ -0,0 +1,20 @@
+import type { BookCommitment } from '../../commitments/_base/BookCommitment';
+/**
+ * Generates a regex pattern to match a specific commitment
+ *
+ * Note: It always creates new Regex object
+ * Note: Uses word boundaries to ensure only full words are matched (e.g., "PERSONA" matches but "PERSONALITY" does not)
+ *
+ * @private - TODO: [🧠] Maybe should be public?
+ */
+export declare function createCommitmentRegex(commitment: BookCommitment, aliases?: BookCommitment[], requiresContent?: boolean): RegExp;
+/**
+ * Generates a regex pattern to match a specific commitment type
+ *
+ * Note: It just matches the type part of the commitment
+ * Note: It always creates new Regex object
+ * Note: Uses word boundaries to ensure only full words are matched (e.g., "PERSONA" matches but "PERSONALITY" does not)
+ *
+ * @private
+ */
+export declare function createCommitmentTypeRegex(commitment: BookCommitment, aliases?: BookCommitment[]): RegExp;

package/umd/src/book-2.0/agent-source/createDefaultAgentName.d.ts

@@ -0,0 +1,8 @@
+import { string_agent_name } from '../../types/typeAliases';
+import { string_book } from './string_book';
+/**
+ * Creates temporary default agent name based on agent source hash
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function createDefaultAgentName(agentSource: string_book): string_agent_name;

package/umd/src/book-2.0/agent-source/extractMetaLinks.d.ts

@@ -0,0 +1,8 @@
+import type { string_book } from './string_book';
+/**
+ * Extracts META LINK commitments from agent source
+ * Returns an array of all META LINK URLs found in the agent source
+ *
+ * @private - TODO: [🧠] Maybe should be public?
+ */
+export declare function extractMetaLinks(agentSource: string_book): string[];

package/umd/src/book-2.0/agent-source/normalizeAgentName.d.ts

@@ -0,0 +1,9 @@
+import { string_agent_name } from '../../types/typeAliases';
+/**
+ * Normalizes agent name from arbitrary string to valid agent name
+ *
+ * Note: [🔂] This function is idempotent.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function normalizeAgentName(rawAgentName: string): string_agent_name;

package/umd/src/book-2.0/agent-source/normalizeAgentName.test.d.ts

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

package/umd/src/book-2.0/agent-source/padBook.d.ts

@@ -0,0 +1,18 @@
+import type { string_book } from './string_book';
+/**
+ *  Number of padding lines to add at the end of the book content
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const PADDING_LINES = 11;
+/**
+ * A function that adds padding to the book content
+ *
+ * Note: [🔂] This function is idempotent.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function padBook(content: string_book): string_book;
+/**
+ * TODO: [🧠] Maybe export
+ */

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

@@ -0,0 +1,15 @@
+import type { AgentBasicInformation } from './AgentBasicInformation';
+import type { string_book } from './string_book';
+/**
+ * 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_book): AgentBasicInformation;
+/**
+ * TODO: [🕛] Unite `AgentBasicInformation`, `ChatParticipant`, `LlmExecutionTools` +  `LlmToolsMetadata`
+ */

package/umd/src/book-2.0/agent-source/parseAgentSource.import.test.d.ts

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

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

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

package/umd/src/book-2.0/agent-source/parseAgentSourceWithCommitments.blocks.test.d.ts

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

package/umd/src/book-2.0/agent-source/parseAgentSourceWithCommitments.d.ts

@@ -0,0 +1,9 @@
+import type { AgentSourceParseResult } from './AgentSourceParseResult';
+import type { string_book } from './string_book';
+/**
+ * Parses agent source using the new commitment system with multiline support
+ * This function replaces the hardcoded commitment parsing in the original parseAgentSource
+ *
+ * @private internal utility of `parseAgentSource`
+ */
+export declare function parseAgentSourceWithCommitments(agentSource: string_book): Omit<AgentSourceParseResult, 'agentHash'>;

package/umd/src/book-2.0/agent-source/parseParameters.d.ts

@@ -0,0 +1,13 @@
+import type { BookParameter } from './AgentBasicInformation';
+/**
+ * Parses parameters from text using both supported notations:
+ * 1. @Parameter - single word parameter starting with @
+ * 2. {parameterName} or {parameter with multiple words} or {parameterName: description text}
+ *
+ * Both notations represent the same syntax feature - parameters
+ *
+ * @param text - Text to extract parameters from
+ * @returns Array of parsed parameters with unified representation
+ * @public exported from `@promptbook/core`
+ */
+export declare function parseParameters(text: string): BookParameter[];

package/umd/src/book-2.0/agent-source/parseTeamCommitment.d.ts

@@ -0,0 +1,28 @@
+import type { string_agent_url } from '../../types/typeAliases';
+/**
+ * Parsed TEAM teammate entry.
+ *
+ * @private
+ */
+export type TeamTeammate = {
+    url: string_agent_url;
+    label: string;
+    instructions: string;
+};
+/**
+ * Options for parsing TEAM commitment content.
+ *
+ * @private
+ */
+export type ParseTeamCommitmentOptions = {
+    strict?: boolean;
+};
+/**
+ * Parses TEAM commitment content into teammates with instructions.
+ *
+ * @private
+ */
+export declare function parseTeamCommitmentContent(content: string, options?: ParseTeamCommitmentOptions): TeamTeammate[];
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/umd/src/book-2.0/agent-source/removeCommentsFromSystemMessage.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Removes comment lines (lines starting with #) from a system message
+ * This is used to clean up the final system message before sending it to the AI model
+ * while preserving the original content with comments in metadata
+ *
+ * @param systemMessage The system message that may contain comment lines
+ * @returns The system message with comment lines removed
+ *
+ * @private - TODO: [🧠] Maybe should be public?
+ */
+export declare function removeCommentsFromSystemMessage(systemMessage: string): string;

package/umd/src/book-2.0/agent-source/string_book.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Branded type for books
+ */
+export type string_book = string & {
+    readonly __type: 'book';
+};
+/**
+ * Type guard to check if a string is a valid agent source
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function isValidBook(value: string): value is string_book;
+/**
+ * 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
+ *
+ * Note: [🔂] This function is idempotent.
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function validateBook(source: string): string_book;
+/**
+ * Default book
+ *
+ * @deprecated Use `$generateBookBoilerplate` instead
+ * @public exported from `@promptbook/core`
+ */
+export declare const DEFAULT_BOOK: string_book;

package/umd/src/book-2.0/utils/generatePlaceholderAgentProfileImageUrl.d.ts

@@ -0,0 +1,13 @@
+import type { string_agent_name, string_agent_permanent_id, string_url, string_url_image } from '../../types/typeAliases';
+/**
+ * Generates an image for the agent to use as profile image
+ *
+ * @param agentId - The permanent ID of the agent
+ * @returns The placeholder profile image URL for the agent
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function generatePlaceholderAgentProfileImageUrl(agentIdOrName: string_agent_permanent_id | string_agent_name, agentsServerUrl: URL | string_url): string_url_image;
+/**
+ * TODO: [🤹] Figure out best placeholder image generator https://i.pravatar.cc/1000?u=568
+ */

package/umd/src/book-components/AvatarProfile/AvatarChip/AvatarChip.d.ts

@@ -0,0 +1,38 @@
+import type { AgentBasicInformation } from '../../../book-2.0/agent-source/AgentBasicInformation';
+import type { string_css_class } from '../../../types/typeAliases';
+/**
+ * Props of `AvatarChip`
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type AvatarChipProps = {
+    /**
+     * Avatar to be shown
+     */
+    readonly avatarBasicInformation: Omit<AgentBasicInformation, 'parameters'>;
+    /**
+     * Whether this chip is a template avatar
+     */
+    readonly isTemplate: boolean;
+    /**
+     * Optional CSS class name which will be added to root <div> element
+     */
+    readonly className?: string_css_class;
+    /**
+     * Called when chip is clicked
+     */
+    readonly onSelect?: (avatar: Omit<AgentBasicInformation, 'parameters'>) => void;
+    /**
+     * Whether this chip is selected
+     */
+    readonly isSelected?: boolean;
+};
+/**
+ * Shows a chip with avatar's avatar and name
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function AvatarChip(props: AvatarChipProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * TODO: [☁️] Export component prop types only to `@promptbook/components` (not `@promptbook/types`)
+ */

package/umd/src/book-components/AvatarProfile/AvatarChip/AvatarChipFromSource.d.ts

@@ -0,0 +1,21 @@
+import type { string_book } from '../../../book-2.0/agent-source/string_book';
+import type { AvatarChipProps } from './AvatarChip';
+/**
+ * Props of `AvatarChipFromSource`
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type AvatarChipFromSourceProps = Omit<AvatarChipProps, 'avatarBasicInformation'> & {
+    /**
+     * Avatar to be shown
+     */
+    readonly source: string_book;
+};
+/**
+ * Shows a chip with avatar's avatar and name based on the avatar source string
+ *
+ * This component is wrapped around the `<AvatarChip/>`, it just parses the avatar source string into `AvatarBasicInformation` and passes it to the `<AvatarChip/>` component.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function AvatarChipFromSource(props: AvatarChipFromSourceProps): import("react/jsx-runtime").JSX.Element;

package/umd/src/book-components/AvatarProfile/AvatarChip/index.d.ts

@@ -0,0 +1,2 @@
+export * from './AvatarChip';
+export * from './AvatarChipFromSource';

package/umd/src/book-components/AvatarProfile/AvatarProfile/AvatarProfile.d.ts

@@ -0,0 +1,36 @@
+import { CSSProperties } from 'react';
+import type { AgentBasicInformation } from '../../../book-2.0/agent-source/AgentBasicInformation';
+import type { string_book } from '../../../book-2.0/agent-source/string_book';
+import type { string_css_class } from '../../../types/typeAliases';
+/**
+ * Props of `AvatarProfile`
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type AvatarProfileProps = {
+    /**
+     * Agent to be shown
+     */
+    readonly agent: AgentBasicInformation;
+    /**
+     * The source of the agent, used to enable profile actions in the UI.
+     */
+    readonly agentSource?: string_book;
+    /**
+     * Optional CSS class name which will be added to root <div> element
+     */
+    readonly className?: string_css_class;
+    /**
+     * Optional CSS style which will be added to root <div/> element
+     */
+    readonly style?: CSSProperties;
+};
+/**
+ * Shows a box with user avatar, name and description
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function AvatarProfile(props: AvatarProfileProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * TODO: [☁️] Export component prop types only to `@promptbook/components` (not `@promptbook/types`)
+ */

package/umd/src/book-components/AvatarProfile/AvatarProfile/AvatarProfileFromSource.d.ts

@@ -0,0 +1,19 @@
+import type { string_book } from '../../../book-2.0/agent-source/string_book';
+import type { AvatarProfileProps } from './AvatarProfile';
+/**
+ * Props of `AvatarProfileFromSource`
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type AvatarProfileFromSourceProps = Omit<AvatarProfileProps, 'agent'> & {
+    /**
+     * Agent source to be shown
+     */
+    readonly agentSource: string_book;
+};
+/**
+ * Shows a box with user avatar, name and description from a string source
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function AvatarProfileFromSource(props: AvatarProfileFromSourceProps): import("react/jsx-runtime").JSX.Element;

package/umd/src/book-components/AvatarProfile/AvatarProfile/AvatarProfileTooltip.d.ts

@@ -0,0 +1,15 @@
+/// <reference types="react" />
+import type { string_book } from '../../../book-2.0/agent-source/string_book';
+type AvatarProfileTooltipProps = {
+    agentSource: string_book;
+    position: {
+        top: number;
+        left: number;
+    };
+};
+/**
+ *
+ * @private internal subcomponent of `<Chat>` component
+ */
+export declare const AvatarProfileTooltip: import("react").ForwardRefExoticComponent<AvatarProfileTooltipProps & import("react").RefAttributes<HTMLDivElement>>;
+export {};

package/umd/src/book-components/BookEditor/BookEditor.d.ts

@@ -0,0 +1,209 @@
+import { CSSProperties } from 'react';
+import type { Promisable } from 'type-fest';
+import type { string_book } from '../../book-2.0/agent-source/string_book';
+import type { number_percent, number_positive, string_css_value, string_knowledge_source_content } from '../../types/typeAliases';
+/**
+ * Monaco diagnostic shown inside `BookEditor`.
+ *
+ * @private internal type of `BookEditor`
+ */
+type BookEditorDiagnostic = {
+    /**
+     * 1-based start line.
+     */
+    readonly startLineNumber: number;
+    /**
+     * 1-based start column.
+     */
+    readonly startColumn: number;
+    /**
+     * 1-based end line.
+     */
+    readonly endLineNumber: number;
+    /**
+     * 1-based end column.
+     */
+    readonly endColumn: number;
+    /**
+     * Diagnostic message shown by Monaco.
+     */
+    readonly message: string;
+    /**
+     * Marker severity used for color coding in Monaco.
+     *
+     * @default 'error'
+     */
+    readonly severity?: 'error' | 'warning' | 'info' | 'hint';
+    /**
+     * Optional source label shown in Monaco hover.
+     */
+    readonly source?: string;
+};
+/**
+ * Default height of the book editor
+ *
+ * Note: This height is computed based on the number of lines in the default book + padding multiplied by an estimated line height.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare const DEFAULT_BOOK_EDITOR_HEIGHT: number;
+/**
+ * Upload progress callback for BookEditor uploads.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type BookEditorUploadProgressCallback = (progress: number_percent, stats?: {
+    loadedBytes: number;
+    totalBytes: number;
+}) => void;
+/**
+ * Options for BookEditor uploads.
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type BookEditorUploadOptions = {
+    /**
+     * Progress callback invoked during upload.
+     */
+    readonly onProgress?: BookEditorUploadProgressCallback;
+    /**
+     * Optional abort signal for canceling an upload.
+     */
+    readonly abortSignal?: AbortSignal;
+};
+/**
+ * Props of `BookEditor`
+ *
+ * @public exported from `@promptbook/components`
+ */
+export type BookEditorProps = {
+    /**
+     * The source of the agent to be displayed in the editor.
+     */
+    readonly agentSource?: string_book;
+    /**
+     * Additional CSS classes to apply to the editor container.
+     */
+    readonly className?: string;
+    /**
+     * Optional CSS style which will be added to root <div/> element
+     */
+    readonly style?: CSSProperties;
+    /**
+     * Height of the `BookEditor` component
+     *
+     * - You can use any valid CSS value, e.g., `500px`, `100%`, `50vh`, etc.
+     * - If not set, the default height is `DEFAULT_BOOK_EDITOR_HEIGHT`.
+     * - If set to `null`, the height should be controlled entirely via `className` or `style`, otherwise the editor will have zero height.
+     *
+     * @default `DEFAULT_BOOK_EDITOR_HEIGHT`
+     */
+    readonly height?: string_css_value | null;
+    /**
+     * Zoom level of the editor
+     *
+     * @default 1 (100%)
+     */
+    readonly zoom?: number_percent & number_positive;
+    /**
+     * The book which is being edited.
+     */
+    readonly value?: string_book;
+    /**
+     * Callback function to handle changes in the book content.
+     */
+    onChange?(value: string_book): void;
+    /**
+     * Optional Monaco diagnostics shown as squiggle markers in the editor.
+     */
+    readonly diagnostics?: ReadonlyArray<BookEditorDiagnostic>;
+    /**
+     * Returns the URL of the uploaded file on CDN or storage.
+     */
+    onFileUpload?(file: File, options?: BookEditorUploadOptions | BookEditorUploadProgressCallback): 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;
+    /**
+     * If true, the editor is in read-only mode
+     *
+     * @default false
+     */
+    readonly isReadonly?: boolean;
+    /**
+     * Optional translations for the component
+     */
+    readonly translations?: {
+        /**
+         * Message to show when trying to edit a readonly editor
+         *
+         * @default "You cannot edit this book"
+         */
+        readonly readonlyMessage?: string;
+    };
+    /**
+     * If true, shows the upload button in the action bar.
+     * By default, the upload button is shown.
+     */
+    readonly isUploadButtonShown?: boolean;
+    /**
+     * If true, shows the camera button in the action bar.
+     * By default, the camera button is shown on mobile devices.
+     */
+    readonly isCameraButtonShown?: boolean;
+    /**
+     * If true, shows the download button in the action bar.
+     * By default, the download button is shown.
+     */
+    readonly isDownloadButtonShown?: boolean;
+    /**
+     * If true, shows the about button in the action bar.
+     * By default, the about button is shown.
+     */
+    readonly isAboutButtonShown?: boolean;
+    /**
+     * If true, shows the fullscreen button in the action bar.
+     * By default, the fullscreen button is shown.
+     */
+    readonly isFullscreenButtonShown?: boolean;
+    /**
+     * Callback function to handle fullscreen button click.
+     * Note: This is for internal use between BookEditor and BookEditorMonaco
+     * @private
+     */
+    onFullscreenClick?(): void;
+    /**
+     * If true, the editor is in fullscreen mode.
+     * Note: This is for internal use between BookEditor and BookEditorMonaco
+     * @private
+     */
+    readonly isFullscreen?: boolean;
+    /**
+     * If defined, the editor will be synced with other editors with the same sync configuration.
+     */
+    readonly sync?: {
+        /**
+         * The URL of the y-websocket server.
+         */
+        readonly serverUrl: string;
+        /**
+         * The name of the room to join.
+         */
+        readonly roomName: string;
+    };
+};
+/**
+ * Renders a book editor
+ *
+ * @public exported from `@promptbook/components`
+ */
+export declare function BookEditor(props: BookEditorProps): import("react/jsx-runtime").JSX.Element;
+export {};
+/**
+ * TODO: [☁️] Export component prop types only to `@promptbook/components` (not `@promptbook/types`)
+ */

package/umd/src/book-components/BookEditor/BookEditorActionbar.d.ts

@@ -0,0 +1,18 @@
+type BookEditorActionbarProps = {
+    value: string | undefined;
+    isDownloadButtonShown?: boolean;
+    isUploadButtonShown?: boolean;
+    isCameraButtonShown?: boolean;
+    isAboutButtonShown?: boolean;
+    isFullscreenButtonShown?: boolean;
+    onFullscreenClick?: () => void;
+    onUploadDocument?: () => void;
+    onTakePhoto?: () => void;
+    isFullscreen?: boolean;
+};
+/**
+ *
+ * @private Internal component used by `BookEditor`
+ */
+export declare function BookEditorActionbar(props: BookEditorActionbarProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/umd/src/book-components/BookEditor/BookEditorMonaco.d.ts

@@ -0,0 +1,5 @@
+import type { BookEditorProps } from './BookEditor';
+/**
+ * @private Internal component used by `BookEditor`
+ */
+export declare function BookEditorMonaco(props: BookEditorProps): import("react/jsx-runtime").JSX.Element;

package/umd/src/book-components/BookEditor/BookEditorMonacoConstants.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Shared constants for `BookEditorMonaco`.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare const BookEditorMonacoConstants: {
+    readonly BOOK_LANGUAGE_ID: "book";
+    readonly LINE_HEIGHT: 28;
+    readonly CONTENT_PADDING_LEFT: 20;
+    readonly VERTICAL_LINE_LEFT: 0;
+    readonly UPLOAD_EDIT_DEBOUNCE_MS: 300;
+    readonly UPLOAD_PROGRESS_DEBOUNCE_MS: 150;
+    readonly DIAGNOSTIC_MARKER_OWNER: "book-editor-diagnostics";
+};

package/umd/src/book-components/BookEditor/BookEditorMonacoFormatting.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Formatting helpers for `BookEditorMonaco`.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare const BookEditorMonacoFormatting: {
+    getUploadPlaceholderText: (fileName: string) => string;
+    formatBytes: (bytes: number) => string;
+    formatDuration: (durationMs: number) => string;
+};

package/umd/src/book-components/BookEditor/BookEditorMonacoTokenization.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Agent reference helpers for `BookEditorMonaco`.
+ *
+ * @private function of BookEditorMonaco
+ */
+export declare const BookEditorMonacoTokenization: {
+    AGENT_URL_REFERENCE_REGEX: RegExp;
+    AGENT_REFERENCE_TOKEN_REGEX: RegExp;
+    AGENT_REFERENCE_BRACED_REGEX: RegExp;
+    AGENT_REFERENCE_HIGHLIGHT_REGEXES: readonly [RegExp, RegExp, RegExp, RegExp, RegExp];
+    extractAgentReferenceValue: (token: string) => string;
+    resolveAgentReferenceToUrl: (referenceValue: string) => string | null;
+    extractAgentReferenceMatches: (content: string) => {
+        value: string;
+        url: string;
+        index: number;
+        length: number;
+    }[];
+};