@promptbook/javascript 0.111.0-7 → 0.112.0-11

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
+ */

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

@@ -1,32 +1,32 @@
 import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
 /**
- * SAMPLE commitment definition
+ * Legacy `SAMPLE` / `EXAMPLE` commitment definition.
  *
- * The SAMPLE/EXAMPLE commitment provides examples of how the agent should respond
- * or behave in certain situations. These examples help guide the agent's responses.
- *
- * Example usage in agent source:
- *
- * ```book
- * SAMPLE When asked about pricing, respond: "Our basic plan starts at $10/month..."
- * EXAMPLE For code questions, always include working code snippets
- * ```
+ * It stays runtime-compatible, but authors should migrate to `WRITING SAMPLE`
+ * for writing voice exemplars.
  *
  * @private [🪔] Maybe export the commitments through some package
  */
 export declare class SampleCommitmentDefinition extends BaseCommitmentDefinition<'SAMPLE' | 'EXAMPLE'> {
     constructor(type?: 'SAMPLE' | 'EXAMPLE');
     /**
-     * Short one-line description of SAMPLE/EXAMPLE.
+     * Short one-line description of `SAMPLE` / `EXAMPLE`.
      */
     get description(): string;
     /**
-     * Icon for this commitment.
+     * Optional UI/docs-only deprecation metadata.
+     */
+    get deprecation(): {
+        readonly message: "Use `WRITING SAMPLE` for explicit voice exemplars.";
+        readonly replacedBy: readonly ["WRITING SAMPLE"];
+    };
+    /**
+     * Icon for `SAMPLE` / `EXAMPLE`.
      */
     get icon(): string;
     /**
-     * Markdown documentation for SAMPLE/EXAMPLE commitment.
+     * Markdown documentation for `SAMPLE` / `EXAMPLE`.
      */
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;

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

@@ -10,7 +10,7 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * This commitment provides two levels of browser access:
  * 1. One-shot URL fetching: Simple function to fetch and scrape URL content
- * 2. Running browser: For complex tasks like scrolling, clicking, etc. (prepared but not active yet)
+ * 2. Running browser: For complex tasks like scrolling, clicking, form filling, etc.
  *
  * The content following `USE BROWSER` is ignored (similar to NOTE).
  *

package/umd/src/commitments/USE_BROWSER/resolveRunBrowserToolForNode.d.ts

@@ -0,0 +1,10 @@
+import type { ToolFunction } from '../../_packages/types.index';
+/**
+ * Resolves the server-side implementation of the `run_browser` tool for Node.js environments.
+ *
+ * This uses lazy `require` to keep the core package decoupled from Agents Server internals.
+ * When the server tool cannot be resolved, the fallback implementation throws a helpful error.
+ *
+ * @private internal utility for USE BROWSER commitment
+ */
+export declare function resolveRunBrowserToolForNode(): ToolFunction;

package/umd/src/commitments/USE_BROWSER/resolveRunBrowserToolForNode.test.d.ts

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

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

@@ -3,16 +3,9 @@ import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentMo
 import { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
 /**
- * USE EMAIL commitment definition
+ * USE EMAIL commitment definition.
  *
- * The `USE EMAIL` commitment enables the agent to send emails.
- *
- * Example usage in agent source:
- *
- * ```book
- * USE EMAIL
- * USE EMAIL Write always formal and polite emails, always greet.
- * ```
+ * The `USE EMAIL` commitment enables outbound email sending through the `send_email` tool.
  *
  * @private [🪔] Maybe export the commitments through some package
  */
@@ -37,9 +30,9 @@ export declare class UseEmailCommitmentDefinition extends BaseCommitmentDefiniti
      */
     getToolTitles(): Record<string_javascript_name, string>;
     /**
-     * Gets the `send_email` tool function implementation.
+     * Gets the browser-safe `send_email` implementation.
      *
-     * Note: [??] This function has implementation both for browser and node, this is the proxied one for browser.
+     * Node.js runtime overrides this via `getAllCommitmentsToolFunctionsForNode`.
      */
     getToolFunctions(): Record<string_javascript_name, ToolFunction>;
 }

package/umd/src/commitments/USE_EMAIL/USE_EMAIL.test.d.ts

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