@promptbook/javascript 0.111.0-7 → 0.112.0-12

package/umd/src/collection/agent-collection/constructors/agent-collection-in-supabase/AgentsDatabaseSchema.d.ts

@@ -39,7 +39,7 @@ export type AgentsDatabaseSchema = {
                     folderId: number | null;
                     sortOrder: number;
                     deletedAt: string | null;
-                    visibility: 'PUBLIC' | 'PRIVATE';
+                    visibility: 'PUBLIC' | 'PRIVATE' | 'UNLISTED';
                 };
                 Insert: {
                     id?: number;
@@ -56,7 +56,7 @@ export type AgentsDatabaseSchema = {
                     folderId?: number | null;
                     sortOrder?: number;
                     deletedAt?: string | null;
-                    visibility?: 'PUBLIC' | 'PRIVATE';
+                    visibility?: 'PUBLIC' | 'PRIVATE' | 'UNLISTED';
                 };
                 Update: {
                     id?: number;
@@ -73,7 +73,7 @@ export type AgentsDatabaseSchema = {
                     folderId?: number | null;
                     sortOrder?: number;
                     deletedAt?: string | null;
-                    visibility?: 'PUBLIC' | 'PRIVATE';
+                    visibility?: 'PUBLIC' | 'PRIVATE' | 'UNLISTED';
                 };
                 Relationships: [
                     {
@@ -94,6 +94,7 @@ export type AgentsDatabaseSchema = {
                     previousAgentHash: string | null;
                     agentSource: string;
                     promptbookEngineVersion: string;
+                    versionName: string | null;
                 };
                 Insert: {
                     id?: number;
@@ -104,6 +105,7 @@ export type AgentsDatabaseSchema = {
                     previousAgentHash?: string | null;
                     agentSource: string;
                     promptbookEngineVersion: string;
+                    versionName?: string | null;
                 };
                 Update: {
                     id?: number;
@@ -114,6 +116,7 @@ export type AgentsDatabaseSchema = {
                     previousAgentHash?: string | null;
                     agentSource?: string;
                     promptbookEngineVersion?: string;
+                    versionName?: string | null;
                 };
                 Relationships: [
                     {

package/umd/src/collection/agent-collection/constructors/agent-collection-in-supabase/prepareAgentSourceForPersistence.d.ts

@@ -0,0 +1,36 @@
+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_agent_permanent_id } from '../../../../types/typeAliases';
+/**
+ * Prepared agent source payload ready for database persistence.
+ *
+ * The original source may contain `META ID`, which should not be stored verbatim
+ * because clones and imports must receive a fresh local permanent id.
+ *
+ * @private shared persistence helper for `AgentCollectionInSupabase`
+ */
+export type PreparedAgentSourceForPersistence = {
+    /**
+     * Parsed profile based on the normalized source that will be stored.
+     */
+    readonly agentProfile: AgentBasicInformation;
+    /**
+     * Source normalized for persistence, with any `META ID` lines removed.
+     */
+    readonly agentSource: string_book;
+    /**
+     * Permanent id extracted from the original source before stripping `META ID`.
+     */
+    readonly permanentId: string_agent_permanent_id | undefined;
+};
+/**
+ * Normalizes one agent source before persistence.
+ *
+ * This keeps create/update flows aligned when a source includes `META ID`.
+ *
+ * @param agentSource - Raw agent source about to be stored.
+ * @returns Parsed profile, normalized source, and extracted permanent id.
+ *
+ * @private shared persistence helper for `AgentCollectionInSupabase`
+ */
+export declare function prepareAgentSourceForPersistence(agentSource: string_book): PreparedAgentSourceForPersistence;

package/umd/src/commitments/KNOWLEDGE/KNOWLEDGE.d.ts

@@ -34,6 +34,3 @@ export declare class KnowledgeCommitmentDefinition extends BaseCommitmentDefinit
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
 }
-/**
- * Note: [💞] Ignore a discrepancy between file name and entity name
- */

package/umd/src/commitments/MEMORY/MEMORY.d.ts

@@ -1,64 +1,9 @@
-import { string_javascript_name } from '../../_packages/types.index';
+import type { string_javascript_name } from '../../_packages/types.index';
 import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
-import { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
+import type { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
-/**
- * Memory record returned by runtime adapters.
- *
- * @private internal MEMORY commitment types
- */
-export type MemoryToolRecord = {
-    id?: string;
-    content: string;
-    isGlobal: boolean;
-    createdAt?: string;
-    updatedAt?: string;
-};
-/**
- * Runtime context for MEMORY tools resolved from hidden tool arguments.
- *
- * @private internal MEMORY commitment types
- */
-export type MemoryToolRuntimeContext = {
-    readonly enabled: boolean;
-    readonly userId?: number;
-    readonly username?: string;
-    readonly agentId?: string;
-    readonly agentName?: string;
-    readonly isTeamConversation: boolean;
-    readonly isPrivateMode: boolean;
-};
-/**
- * Runtime adapter interface used by MEMORY tools.
- *
- * @private internal MEMORY commitment types
- */
-export type MemoryToolRuntimeAdapter = {
-    retrieveMemories(args: {
-        query?: string;
-        limit?: number;
-    }, runtimeContext: MemoryToolRuntimeContext): Promise<MemoryToolRecord[]>;
-    storeMemory(args: {
-        content: string;
-        isGlobal: boolean;
-    }, runtimeContext: MemoryToolRuntimeContext): Promise<MemoryToolRecord>;
-    updateMemory(args: {
-        memoryId: string;
-        content: string;
-        isGlobal?: boolean;
-    }, runtimeContext: MemoryToolRuntimeContext): Promise<MemoryToolRecord>;
-    deleteMemory(args: {
-        memoryId: string;
-    }, runtimeContext: MemoryToolRuntimeContext): Promise<{
-        id?: string;
-    }>;
-};
-/**
- * Sets runtime adapter used by MEMORY commitment tools.
- *
- * @private internal runtime wiring for MEMORY commitment
- */
-export declare function setMemoryToolRuntimeAdapter(adapter: MemoryToolRuntimeAdapter | null): void;
+export { setMemoryToolRuntimeAdapter } from './setMemoryToolRuntimeAdapter';
+export type { MemoryToolRecord, MemoryToolRuntimeAdapter, MemoryToolRuntimeContext } from './MemoryToolRuntimeAdapter';
 /**
  * MEMORY commitment definition
  *

package/umd/src/commitments/MEMORY/MemoryToolNames.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Names of tools used by the MEMORY commitment.
+ *
+ * @private function of MemoryCommitmentDefinition
+ */
+export declare const MemoryToolNames: {
+    readonly retrieve: string;
+    readonly store: string;
+    readonly update: string;
+    readonly delete: string;
+};

package/umd/src/commitments/MEMORY/MemoryToolRuntimeAdapter.d.ts

@@ -0,0 +1,149 @@
+import type { TODO_any } from '../../_packages/types.index';
+/**
+ * Tool arguments for retrieving memory.
+ *
+ * @private type of MemoryCommitmentDefinition
+ */
+export type RetrieveMemoryToolArgs = {
+    query?: string;
+    limit?: number;
+    [key: string]: TODO_any;
+};
+/**
+ * Tool arguments for storing memory.
+ *
+ * @private type of MemoryCommitmentDefinition
+ */
+export type StoreMemoryToolArgs = {
+    content?: string;
+    isGlobal?: boolean;
+    [key: string]: TODO_any;
+};
+/**
+ * Tool arguments for updating memory.
+ *
+ * @private type of MemoryCommitmentDefinition
+ */
+export type UpdateMemoryToolArgs = {
+    memoryId?: string;
+    content?: string;
+    isGlobal?: boolean;
+    [key: string]: TODO_any;
+};
+/**
+ * Tool arguments for deleting memory.
+ *
+ * @private type of MemoryCommitmentDefinition
+ */
+export type DeleteMemoryToolArgs = {
+    memoryId?: string;
+    [key: string]: TODO_any;
+};
+/**
+ * Memory record returned by runtime adapters.
+ *
+ * @private type of MemoryCommitmentDefinition
+ */
+export type MemoryToolRecord = {
+    id?: string;
+    content: string;
+    isGlobal: boolean;
+    createdAt?: string;
+    updatedAt?: string;
+};
+/**
+ * Runtime context for MEMORY tools resolved from hidden tool arguments.
+ *
+ * @private type of MemoryCommitmentDefinition
+ */
+export type MemoryToolRuntimeContext = {
+    readonly enabled: boolean;
+    readonly userId?: number;
+    readonly username?: string;
+    readonly agentId?: string;
+    readonly agentName?: string;
+    readonly isTeamConversation: boolean;
+    readonly isPrivateMode: boolean;
+};
+/**
+ * Result payload returned by retrieve memory tool.
+ *
+ * @private type of MemoryCommitmentDefinition
+ */
+export type RetrieveMemoryToolResult = {
+    action: 'retrieve';
+    status: 'ok' | 'disabled' | 'error';
+    query?: string;
+    memories: MemoryToolRecord[];
+    message?: string;
+};
+/**
+ * Result payload returned by store memory tool.
+ *
+ * @private type of MemoryCommitmentDefinition
+ */
+export type StoreMemoryToolResult = {
+    action: 'store';
+    status: 'stored' | 'disabled' | 'error';
+    memory?: MemoryToolRecord;
+    message?: string;
+};
+/**
+ * Result payload returned by update memory tool.
+ *
+ * @private type of MemoryCommitmentDefinition
+ */
+export type UpdateMemoryToolResult = {
+    action: 'update';
+    status: 'updated' | 'disabled' | 'error';
+    memory?: MemoryToolRecord;
+    message?: string;
+};
+/**
+ * Result payload returned by delete memory tool.
+ *
+ * @private type of MemoryCommitmentDefinition
+ */
+export type DeleteMemoryToolResult = {
+    action: 'delete';
+    status: 'deleted' | 'disabled' | 'error';
+    memoryId?: string;
+    message?: string;
+};
+/**
+ * Union of all MEMORY tool actions.
+ *
+ * @private type of MemoryCommitmentDefinition
+ */
+export type MemoryToolAction = RetrieveMemoryToolResult['action'] | StoreMemoryToolResult['action'] | UpdateMemoryToolResult['action'] | DeleteMemoryToolResult['action'];
+/**
+ * Union of all MEMORY tool result payloads.
+ *
+ * @private type of MemoryCommitmentDefinition
+ */
+export type MemoryToolResult = RetrieveMemoryToolResult | StoreMemoryToolResult | UpdateMemoryToolResult | DeleteMemoryToolResult;
+/**
+ * Runtime adapter interface used by MEMORY tools.
+ *
+ * @private type of MemoryCommitmentDefinition
+ */
+export type MemoryToolRuntimeAdapter = {
+    retrieveMemories(args: {
+        query?: string;
+        limit?: number;
+    }, runtimeContext: MemoryToolRuntimeContext): Promise<MemoryToolRecord[]>;
+    storeMemory(args: {
+        content: string;
+        isGlobal: boolean;
+    }, runtimeContext: MemoryToolRuntimeContext): Promise<MemoryToolRecord>;
+    updateMemory(args: {
+        memoryId: string;
+        content: string;
+        isGlobal?: boolean;
+    }, runtimeContext: MemoryToolRuntimeContext): Promise<MemoryToolRecord>;
+    deleteMemory(args: {
+        memoryId: string;
+    }, runtimeContext: MemoryToolRuntimeContext): Promise<{
+        id?: string;
+    }>;
+};

package/umd/src/commitments/MEMORY/createMemorySystemMessage.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Builds the MEMORY instruction block appended to the system message.
+ *
+ * @private function of MemoryCommitmentDefinition
+ */
+export declare function createMemorySystemMessage(extraInstructions: string): string;

package/umd/src/commitments/MEMORY/createMemoryToolFunctions.d.ts

@@ -0,0 +1,8 @@
+import type { string_javascript_name } from '../../_packages/types.index';
+import type { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
+/**
+ * Gets MEMORY tool function implementations.
+ *
+ * @private function of MemoryCommitmentDefinition
+ */
+export declare function createMemoryToolFunctions(): Record<string_javascript_name, ToolFunction>;

package/umd/src/commitments/MEMORY/createMemoryTools.d.ts

@@ -0,0 +1,14 @@
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+/**
+ * Concrete type of tool definitions in `AgentModelRequirements`.
+ *
+ * @private type of MemoryCommitmentDefinition
+ */
+type AgentModelTools = NonNullable<AgentModelRequirements['tools']>;
+/**
+ * Creates MEMORY tool definitions while preserving already-registered tools.
+ *
+ * @private function of MemoryCommitmentDefinition
+ */
+export declare function createMemoryTools(existingTools: AgentModelRequirements['tools']): AgentModelTools;
+export {};

package/umd/src/commitments/MEMORY/getMemoryCommitmentDocumentation.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Markdown documentation for MEMORY commitment.
+ *
+ * @private function of MemoryCommitmentDefinition
+ */
+export declare function getMemoryCommitmentDocumentation(type: 'MEMORY' | 'MEMORIES'): string;

package/umd/src/commitments/MEMORY/getMemoryToolRuntimeAdapterOrDisabledResult.d.ts

@@ -0,0 +1,17 @@
+import type { DeleteMemoryToolResult, MemoryToolAction, MemoryToolRuntimeAdapter, MemoryToolRuntimeContext, RetrieveMemoryToolResult, StoreMemoryToolResult, UpdateMemoryToolResult } from './MemoryToolRuntimeAdapter';
+/**
+ * Return type of MEMORY adapter resolution helper.
+ *
+ * @private type of MemoryCommitmentDefinition
+ */
+type MemoryToolRuntimeAdapterResolution = {
+    adapter: MemoryToolRuntimeAdapter | null;
+    disabledResult: RetrieveMemoryToolResult | StoreMemoryToolResult | UpdateMemoryToolResult | DeleteMemoryToolResult | null;
+};
+/**
+ * Gets the runtime adapter and returns a disabled result when unavailable.
+ *
+ * @private function of MemoryCommitmentDefinition
+ */
+export declare function getMemoryToolRuntimeAdapterOrDisabledResult(action: MemoryToolAction, runtimeContext: MemoryToolRuntimeContext): MemoryToolRuntimeAdapterResolution;
+export {};

package/umd/src/commitments/MEMORY/getMemoryToolTitles.d.ts

@@ -0,0 +1,7 @@
+import type { string_javascript_name } from '../../_packages/types.index';
+/**
+ * Gets human-readable titles for MEMORY tool functions.
+ *
+ * @private function of MemoryCommitmentDefinition
+ */
+export declare function getMemoryToolTitles(): Record<string_javascript_name, string>;

package/umd/src/commitments/MEMORY/parseMemoryToolArgs.d.ts

@@ -0,0 +1,61 @@
+import type { DeleteMemoryToolArgs, RetrieveMemoryToolArgs, StoreMemoryToolArgs, UpdateMemoryToolArgs } from './MemoryToolRuntimeAdapter';
+/**
+ * Parsed retrieve memory arguments.
+ *
+ * @private type of MemoryCommitmentDefinition
+ */
+type ParsedRetrieveMemoryArgs = {
+    query?: string;
+    limit?: number;
+};
+/**
+ * Parsed store memory arguments.
+ *
+ * @private type of MemoryCommitmentDefinition
+ */
+type ParsedStoreMemoryArgs = {
+    content: string;
+    isGlobal: boolean;
+};
+/**
+ * Parsed update memory arguments.
+ *
+ * @private type of MemoryCommitmentDefinition
+ */
+type ParsedUpdateMemoryArgs = {
+    memoryId: string;
+    content: string;
+    isGlobal?: boolean;
+};
+/**
+ * Parsed delete memory arguments.
+ *
+ * @private type of MemoryCommitmentDefinition
+ */
+type ParsedDeleteMemoryArgs = {
+    memoryId: string;
+};
+/**
+ * Collection of MEMORY tool argument parsers.
+ *
+ * @private function of MemoryCommitmentDefinition
+ */
+export declare const parseMemoryToolArgs: {
+    /**
+     * Parses retrieve memory arguments.
+     */
+    retrieve(args: RetrieveMemoryToolArgs): ParsedRetrieveMemoryArgs;
+    /**
+     * Parses store memory arguments.
+     */
+    store(args: StoreMemoryToolArgs): ParsedStoreMemoryArgs;
+    /**
+     * Parses update memory arguments.
+     */
+    update(args: UpdateMemoryToolArgs): ParsedUpdateMemoryArgs;
+    /**
+     * Parses delete memory arguments.
+     */
+    delete(args: DeleteMemoryToolArgs): ParsedDeleteMemoryArgs;
+};
+export {};

package/umd/src/commitments/MEMORY/resolveMemoryRuntimeContext.d.ts

@@ -0,0 +1,8 @@
+import type { TODO_any } from '../../_packages/types.index';
+import type { MemoryToolRuntimeContext } from './MemoryToolRuntimeAdapter';
+/**
+ * Resolves runtime context from hidden tool arguments.
+ *
+ * @private function of MemoryCommitmentDefinition
+ */
+export declare function resolveMemoryRuntimeContext(args: Record<string, TODO_any>): MemoryToolRuntimeContext;

package/umd/src/commitments/MEMORY/setMemoryToolRuntimeAdapter.d.ts

@@ -0,0 +1,13 @@
+import type { MemoryToolRuntimeAdapter } from './MemoryToolRuntimeAdapter';
+/**
+ * Sets runtime adapter used by MEMORY commitment tools.
+ *
+ * @private function of MemoryCommitmentDefinition
+ */
+export declare function setMemoryToolRuntimeAdapter(adapter: MemoryToolRuntimeAdapter | null): void;
+/**
+ * Gets runtime adapter used by MEMORY commitment tools.
+ *
+ * @private function of MemoryCommitmentDefinition
+ */
+export declare function getMemoryToolRuntimeAdapter(): MemoryToolRuntimeAdapter | null;

package/umd/src/commitments/MESSAGE/InternalMessageCommitmentDefinition.d.ts

@@ -0,0 +1,33 @@
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * INTERNAL MESSAGE commitment definition
+ *
+ * The INTERNAL MESSAGE commitment stores model-internal trace records related to one interaction
+ * (for example tool calls, raw request/response payloads, or reasoning metadata).
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * INTERNAL MESSAGE
+ * {"kind":"TOOL_CALL","toolCall":{"name":"search"}}
+ * ```
+ *
+ * @private Internal commitment used by self-learning sampling.
+ */
+export declare class InternalMessageCommitmentDefinition extends BaseCommitmentDefinition<'INTERNAL MESSAGE'> {
+    constructor();
+    /**
+     * Short one-line description of INTERNAL MESSAGE.
+     */
+    get description(): string;
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string;
+    /**
+     * Markdown documentation for INTERNAL MESSAGE commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+}

package/umd/src/commitments/MESSAGE/MESSAGE.d.ts

@@ -5,8 +5,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * The MESSAGE commitment contains 1:1 text of the message which AI assistant already
  * sent during the conversation. Later messages are later in the conversation.
- * It is similar to EXAMPLE but it is not example, it is the real message which
- * AI assistant already sent.
+ * It is similar to `WRITING SAMPLE`, but it is not a sample. It is the real
+ * message that the AI assistant already sent.
  *
  * Example usage in agent source:
  *

package/umd/src/commitments/META/META.d.ts

@@ -6,8 +6,10 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  * 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 DOMAIN: Sets the canonical custom domain/host of the agent
  * - META TITLE: Sets the agent's display title
  * - META DESCRIPTION: Sets the agent's description
+ * - META INPUT PLACEHOLDER: Sets chat input placeholder text
  * - META [ANYTHING]: Any other meta information in uppercase format
  *
  * These commitments are special because they don't affect the system message,
@@ -18,8 +20,10 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  * ```book
  * META IMAGE https://example.com/avatar.jpg
  * META LINK https://twitter.com/username
+ * META DOMAIN my-agent.com
  * META TITLE Professional Assistant
  * META DESCRIPTION An AI assistant specialized in business tasks
+ * META INPUT PLACEHOLDER Write a message...
  * META AUTHOR John Doe
  * META VERSION 1.0
  * ```

package/umd/src/commitments/META_DOMAIN/META_DOMAIN.d.ts

@@ -0,0 +1,33 @@
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * META DOMAIN commitment definition
+ *
+ * The `META DOMAIN` commitment sets the canonical host/domain of the agent.
+ * This commitment is metadata-only and does not modify model requirements.
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class MetaDomainCommitmentDefinition extends BaseCommitmentDefinition<'META DOMAIN'> {
+    constructor();
+    /**
+     * Short one-line description of META DOMAIN.
+     */
+    get description(): string;
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string;
+    /**
+     * Markdown documentation for META DOMAIN commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+    /**
+     * Extracts the domain value from commitment content.
+     */
+    extractDomain(content: string): string | null;
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/umd/src/commitments/META_INPUT_PLACEHOLDER/META_INPUT_PLACEHOLDER.d.ts

@@ -0,0 +1,33 @@
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * META INPUT PLACEHOLDER commitment definition.
+ *
+ * The `META INPUT PLACEHOLDER` commitment sets the chat input placeholder text
+ * that user interfaces should render for this agent.
+ *
+ * @private Metadata-only commitment used by chat UIs.
+ */
+export declare class MetaInputPlaceholderCommitmentDefinition extends BaseCommitmentDefinition<'META INPUT PLACEHOLDER'> {
+    constructor();
+    /**
+     * Short one-line description of META INPUT PLACEHOLDER.
+     */
+    get description(): string;
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string;
+    /**
+     * Markdown documentation for META INPUT PLACEHOLDER commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+    /**
+     * Convenience helper to normalize configured placeholder text.
+     */
+    extractInputPlaceholder(content: string): string | null;
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/umd/src/commitments/META_VOICE/META_VOICE.d.ts

@@ -0,0 +1,39 @@
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * META VOICE commitment definition
+ *
+ * The META VOICE commitment tells the agent which ElevenLabs voice ID should be used
+ * when text-to-speech playback is requested.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * META VOICE 21m00Tcm4TlvDq8ikWAM
+ * ```
+ *
+ * @private Voice-related metadata used only by the UI and TTS helpers
+ */
+export declare class MetaVoiceCommitmentDefinition extends BaseCommitmentDefinition<'META VOICE'> {
+    constructor();
+    /**
+     * Short one-line description of META VOICE.
+     */
+    get description(): string;
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string;
+    /**
+     * Markdown documentation for META VOICE commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+    /**
+     * Convenience helper to normalize the provided voice ID.
+     */
+    extractVoiceId(content: string): string | null;
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */