@promptbook/javascript 0.111.0-7 → 0.112.0-12

package/esm/src/commitments/USE_PROJECT/normalizeConfiguredProjects.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Configured project reference stored in model requirements metadata.
+ *
+ * @private type of UseProjectCommitmentDefinition
+ */
+export type UseProjectConfiguredProjectReference = {
+    url: string;
+    slug: string;
+    defaultBranch?: string;
+};
+/**
+ * Parses previously stored metadata value into a normalized project list.
+ *
+ * @private function of UseProjectCommitmentDefinition
+ */
+export declare function normalizeConfiguredProjects(rawValue: unknown): Array<UseProjectConfiguredProjectReference>;

package/esm/src/commitments/USE_PROJECT/normalizeOptionalToolText.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Normalizes optional text argument to `string | null`.
+ *
+ * @private function of UseProjectCommitmentDefinition
+ */
+export declare function normalizeOptionalToolText(value: unknown): string | null;
+/**
+ * Normalizes required text argument and throws when missing.
+ *
+ * @private function of UseProjectCommitmentDefinition
+ */
+export declare function normalizeRequiredToolText(value: unknown, fieldName: string): string;

package/esm/src/commitments/USE_PROJECT/projectReference.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Canonical GitHub repository reference resolved from commitment content.
+ *
+ * @private internal utility of USE PROJECT commitment
+ */
+export type GitHubRepositoryReference = {
+    owner: string;
+    repository: string;
+    slug: string;
+    url: string;
+    defaultBranch?: string;
+};
+/**
+ * Parsed `USE PROJECT` payload.
+ *
+ * @private internal utility of USE PROJECT commitment
+ */
+export type ParsedUseProjectCommitmentContent = {
+    repository: GitHubRepositoryReference | null;
+    repositoryReferenceRaw: string | null;
+    instructions: string;
+};
+/**
+ * Parses a repository reference into canonical owner/repository details.
+ *
+ * Supported input forms:
+ * - `https://github.com/owner/repository`
+ * - `github.com/owner/repository`
+ * - `owner/repository`
+ * - optional `.git` suffix and trailing slash are supported
+ *
+ * @private internal utility of USE PROJECT commitment
+ */
+export declare function parseGitHubRepositoryReference(rawReference: string): GitHubRepositoryReference | null;
+/**
+ * Parses `USE PROJECT` commitment content into repository reference + optional instructions.
+ *
+ * @private internal utility of USE PROJECT commitment
+ */
+export declare function parseUseProjectCommitmentContent(content: string): ParsedUseProjectCommitmentContent;
+/**
+ * Extracts canonical repository URLs from parsed commitments.
+ *
+ * @private internal utility of USE PROJECT commitment
+ */
+export declare function extractUseProjectRepositoryUrlsFromCommitments(commitments: ReadonlyArray<{
+    type: string;
+    content: string;
+}>): string[];
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/src/commitments/USE_PROJECT/projectReference.test.d.ts

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

package/esm/src/commitments/USE_PROJECT/resolveUseProjectToolRuntimeOrWalletCredentialResult.d.ts

@@ -0,0 +1,34 @@
+import { type GitHubRepositoryReference } from './projectReference';
+/**
+ * Shared hidden arguments potentially injected into any USE PROJECT tool call.
+ *
+ * @private type of UseProjectCommitmentDefinition
+ */
+export type UseProjectToolArgsBase = {
+    repository?: string;
+    __promptbookToolRuntimeContext?: unknown;
+};
+/**
+ * Resolved runtime payload used by USE PROJECT tools.
+ *
+ * @private type of resolveUseProjectToolRuntimeOrWalletCredentialResult
+ */
+type UseProjectResolvedRuntime = {
+    repositoryReference: GitHubRepositoryReference;
+    token: string;
+};
+/**
+ * Runtime resolution result for USE PROJECT tools.
+ *
+ * @private type of UseProjectCommitmentDefinition
+ */
+export type UseProjectToolRuntimeResolution = UseProjectResolvedRuntime | {
+    walletResult: string;
+};
+/**
+ * Resolves project runtime or returns a wallet-credential-required payload when missing.
+ *
+ * @private function of UseProjectCommitmentDefinition
+ */
+export declare function resolveUseProjectToolRuntimeOrWalletCredentialResult(args: UseProjectToolArgsBase): UseProjectToolRuntimeResolution;
+export {};

package/esm/src/commitments/USE_SPAWN/USE_SPAWN.d.ts

@@ -0,0 +1,41 @@
+import { string_javascript_name } from '../../_packages/types.index';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * USE SPAWN commitment definition.
+ *
+ * The `USE SPAWN` commitment enables creating new persistent child agents through one tool call.
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class UseSpawnCommitmentDefinition extends BaseCommitmentDefinition<'USE SPAWN'> {
+    constructor();
+    get requiresContent(): boolean;
+    /**
+     * Short one-line description of USE SPAWN.
+     */
+    get description(): string;
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string;
+    /**
+     * Markdown documentation for USE SPAWN commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+    /**
+     * Gets human-readable titles for tool functions provided by this commitment.
+     */
+    getToolTitles(): Record<string_javascript_name, string>;
+    /**
+     * Gets browser-safe `spawn_agent` implementation.
+     *
+     * Node.js runtime overrides this through `getAllCommitmentsToolFunctionsForNode`.
+     */
+    getToolFunctions(): Record<string_javascript_name, ToolFunction>;
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/src/commitments/USE_SPAWN/USE_SPAWN.test.d.ts

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

package/esm/src/commitments/USE_SPAWN/resolveSpawnAgentToolForNode.d.ts

@@ -0,0 +1,9 @@
+import type { ToolFunction } from '../../_packages/types.index';
+/**
+ * Resolves the server-side `spawn_agent` tool for Node.js runtimes.
+ *
+ * Uses lazy require so core package can load outside Agents Server.
+ *
+ * @private internal utility for USE SPAWN commitment
+ */
+export declare function resolveSpawnAgentToolForNode(): ToolFunction;

package/esm/src/commitments/USE_SPAWN/spawnAgentViaBrowser.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Browser-safe wrapper for spawning one persisted Agents Server agent.
+ *
+ * This function proxies requests to the Agents Server `/api/spawn-agent` endpoint.
+ *
+ * @param args Tool payload forwarded to server-side `spawn_agent` tool.
+ * @param agentsServerUrl Optional explicit agents server base URL.
+ * @returns JSON string with structured spawn result.
+ *
+ * @private internal utility for USE SPAWN commitment
+ */
+export declare function spawnAgentViaBrowser(args: Record<string, unknown>, agentsServerUrl?: string): Promise<string>;

package/esm/src/commitments/USE_TIMEOUT/TimeoutToolNames.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Tool names provided by the `USE TIMEOUT` commitment.
+ *
+ * @private internal USE TIMEOUT constant
+ */
+export declare const TimeoutToolNames: {
+    readonly set: string;
+    readonly cancel: string;
+};

package/esm/src/commitments/USE_TIMEOUT/TimeoutToolRuntimeAdapter.d.ts

@@ -0,0 +1,90 @@
+import type { TODO_any } from '../../_packages/types.index';
+/**
+ * Tool arguments for scheduling one timeout.
+ *
+ * @private type of UseTimeoutCommitmentDefinition
+ */
+export type SetTimeoutToolArgs = {
+    milliseconds?: number;
+    message?: string;
+    [key: string]: TODO_any;
+};
+/**
+ * Tool arguments for cancelling one timeout.
+ *
+ * @private type of UseTimeoutCommitmentDefinition
+ */
+export type CancelTimeoutToolArgs = {
+    timeoutId?: string;
+    [key: string]: TODO_any;
+};
+/**
+ * Runtime context available to `USE TIMEOUT` tools.
+ *
+ * @private type of UseTimeoutCommitmentDefinition
+ */
+export type TimeoutToolRuntimeContext = {
+    readonly enabled: boolean;
+    readonly chatId?: string;
+    readonly userId?: number;
+    readonly agentId?: string;
+    readonly agentName?: string;
+    readonly promptParameters: Record<string, string>;
+};
+/**
+ * Result payload returned by `set_timeout`.
+ *
+ * @private type of UseTimeoutCommitmentDefinition
+ */
+export type SetTimeoutToolResult = {
+    action: 'set';
+    status: 'set' | 'disabled' | 'error';
+    timeoutId?: string;
+    dueAt?: string;
+    message?: string;
+};
+/**
+ * Result payload returned by `cancel_timeout`.
+ *
+ * @private type of UseTimeoutCommitmentDefinition
+ */
+export type CancelTimeoutToolResult = {
+    action: 'cancel';
+    status: 'cancelled' | 'not_found' | 'disabled' | 'error';
+    timeoutId?: string;
+    dueAt?: string;
+    message?: string;
+};
+/**
+ * Union of all `USE TIMEOUT` tool actions.
+ *
+ * @private type of UseTimeoutCommitmentDefinition
+ */
+export type TimeoutToolAction = SetTimeoutToolResult['action'] | CancelTimeoutToolResult['action'];
+/**
+ * Union of all `USE TIMEOUT` tool results.
+ *
+ * @private type of UseTimeoutCommitmentDefinition
+ */
+export type TimeoutToolResult = SetTimeoutToolResult | CancelTimeoutToolResult;
+/**
+ * Runtime adapter used by `USE TIMEOUT` tools.
+ *
+ * @private type of UseTimeoutCommitmentDefinition
+ */
+export type TimeoutToolRuntimeAdapter = {
+    scheduleTimeout(args: {
+        milliseconds: number;
+        message?: string;
+    }, runtimeContext: TimeoutToolRuntimeContext): Promise<{
+        timeoutId: string;
+        dueAt: string;
+    }>;
+    cancelTimeout(args: {
+        timeoutId: string;
+    }, runtimeContext: TimeoutToolRuntimeContext): Promise<{
+        timeoutId: string;
+        dueAt?: string;
+        status: 'cancelled' | 'not_found';
+    }>;
+};

package/esm/src/commitments/USE_TIMEOUT/USE_TIMEOUT.d.ts

@@ -0,0 +1,41 @@
+import type { string_javascript_name } from '../../_packages/types.index';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import type { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+export { setTimeoutToolRuntimeAdapter } from './setTimeoutToolRuntimeAdapter';
+export type { CancelTimeoutToolResult, SetTimeoutToolResult, TimeoutToolRuntimeAdapter, TimeoutToolRuntimeContext, } from './TimeoutToolRuntimeAdapter';
+/**
+ * `USE TIMEOUT` commitment definition.
+ *
+ * The `USE TIMEOUT` commitment enables thread-scoped timers that wake the same chat later.
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class UseTimeoutCommitmentDefinition extends BaseCommitmentDefinition<'USE TIMEOUT'> {
+    constructor();
+    get requiresContent(): boolean;
+    /**
+     * Short one-line description of `USE TIMEOUT`.
+     */
+    get description(): string;
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string;
+    /**
+     * Markdown documentation for `USE TIMEOUT`.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+    /**
+     * Gets human-readable titles for tool functions provided by this commitment.
+     */
+    getToolTitles(): Record<string_javascript_name, string>;
+    /**
+     * Gets `USE TIMEOUT` tool function implementations.
+     */
+    getToolFunctions(): Record<string_javascript_name, ToolFunction>;
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/src/commitments/USE_TIMEOUT/USE_TIMEOUT.test.d.ts

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

package/esm/src/commitments/USE_TIMEOUT/createTimeoutSystemMessage.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Creates system-message instructions for `USE TIMEOUT`.
+ *
+ * @private internal utility of USE TIMEOUT
+ */
+export declare function createTimeoutSystemMessage(extraInstructions: string): string;

package/esm/src/commitments/USE_TIMEOUT/createTimeoutToolFunctions.d.ts

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

package/esm/src/commitments/USE_TIMEOUT/createTimeoutTools.d.ts

@@ -0,0 +1,7 @@
+import type { LlmToolDefinition } from '../../types/LlmToolDefinition';
+/**
+ * Adds `USE TIMEOUT` tool definitions while preserving already registered tools.
+ *
+ * @private internal utility of USE TIMEOUT
+ */
+export declare function createTimeoutTools(existingTools?: ReadonlyArray<LlmToolDefinition>): Array<LlmToolDefinition>;

package/esm/src/commitments/USE_TIMEOUT/getTimeoutToolRuntimeAdapterOrDisabledResult.d.ts

@@ -0,0 +1,17 @@
+import type { CancelTimeoutToolResult, SetTimeoutToolResult, TimeoutToolAction, TimeoutToolRuntimeAdapter, TimeoutToolRuntimeContext } from './TimeoutToolRuntimeAdapter';
+/**
+ * Return type of timeout adapter resolution helper.
+ *
+ * @private type of UseTimeoutCommitmentDefinition
+ */
+type TimeoutToolRuntimeAdapterResolution = {
+    adapter: TimeoutToolRuntimeAdapter | null;
+    disabledResult: SetTimeoutToolResult | CancelTimeoutToolResult | null;
+};
+/**
+ * Resolves the runtime adapter for timeout tools or returns disabled payload when unavailable.
+ *
+ * @private internal utility of USE TIMEOUT
+ */
+export declare function getTimeoutToolRuntimeAdapterOrDisabledResult(action: TimeoutToolAction, runtimeContext: TimeoutToolRuntimeContext): TimeoutToolRuntimeAdapterResolution;
+export {};

package/esm/src/commitments/USE_TIMEOUT/parseTimeoutToolArgs.d.ts

@@ -0,0 +1,34 @@
+import type { CancelTimeoutToolArgs, SetTimeoutToolArgs } from './TimeoutToolRuntimeAdapter';
+/**
+ * Parsed arguments for `set_timeout`.
+ *
+ * @private type of UseTimeoutCommitmentDefinition
+ */
+type ParsedSetTimeoutToolArgs = {
+    milliseconds: number;
+    message?: string;
+};
+/**
+ * Parsed arguments for `cancel_timeout`.
+ *
+ * @private type of UseTimeoutCommitmentDefinition
+ */
+type ParsedCancelTimeoutToolArgs = {
+    timeoutId: string;
+};
+/**
+ * Parses and validates `USE TIMEOUT` tool arguments.
+ *
+ * @private internal utility of USE TIMEOUT
+ */
+export declare const parseTimeoutToolArgs: {
+    /**
+     * Parses `set_timeout` input.
+     */
+    set(args: SetTimeoutToolArgs): ParsedSetTimeoutToolArgs;
+    /**
+     * Parses `cancel_timeout` input.
+     */
+    cancel(args: CancelTimeoutToolArgs): ParsedCancelTimeoutToolArgs;
+};
+export {};

package/esm/src/commitments/USE_TIMEOUT/resolveTimeoutRuntimeContext.d.ts

@@ -0,0 +1,8 @@
+import type { TODO_any } from '../../_packages/types.index';
+import type { TimeoutToolRuntimeContext } from './TimeoutToolRuntimeAdapter';
+/**
+ * Resolves timeout runtime context from hidden tool arguments.
+ *
+ * @private internal utility of USE TIMEOUT
+ */
+export declare function resolveTimeoutRuntimeContext(args: Record<string, TODO_any>): TimeoutToolRuntimeContext;

package/esm/src/commitments/USE_TIMEOUT/setTimeoutToolRuntimeAdapter.d.ts

@@ -0,0 +1,13 @@
+import type { TimeoutToolRuntimeAdapter } from './TimeoutToolRuntimeAdapter';
+/**
+ * Sets runtime adapter used by `USE TIMEOUT` tools.
+ *
+ * @private internal utility of USE TIMEOUT
+ */
+export declare function setTimeoutToolRuntimeAdapter(adapter: TimeoutToolRuntimeAdapter | null): void;
+/**
+ * Gets runtime adapter used by `USE TIMEOUT` tools.
+ *
+ * @private internal utility of USE TIMEOUT
+ */
+export declare function getTimeoutToolRuntimeAdapter(): TimeoutToolRuntimeAdapter | null;

package/esm/src/commitments/WALLET/WALLET.d.ts

@@ -0,0 +1,24 @@
+import type { string_javascript_name } from '../../_packages/types.index';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import type { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+export { setWalletToolRuntimeAdapter } from './setWalletToolRuntimeAdapter';
+export type { WalletRecordType, WalletToolRecord, WalletToolRuntimeAdapter, WalletToolRuntimeContext, } from './WalletToolRuntimeAdapter';
+/**
+ * WALLET commitment definition.
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class WalletCommitmentDefinition extends BaseCommitmentDefinition<'WALLET' | 'WALLETS'> {
+    constructor(type?: 'WALLET' | 'WALLETS');
+    get requiresContent(): boolean;
+    get description(): string;
+    get icon(): string;
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+    getToolTitles(): Record<string_javascript_name, string>;
+    getToolFunctions(): Record<string_javascript_name, ToolFunction>;
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/src/commitments/WALLET/WALLET.test.d.ts

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

package/esm/src/commitments/WALLET/WalletToolNames.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Names of tools used by the WALLET commitment.
+ *
+ * @private constant of WalletCommitmentDefinition
+ */
+export declare const WalletToolNames: {
+    readonly retrieve: string;
+    readonly store: string;
+    readonly update: string;
+    readonly delete: string;
+    readonly request: string;
+};

package/esm/src/commitments/WALLET/WalletToolRuntimeAdapter.d.ts

@@ -0,0 +1,163 @@
+import type { TODO_any } from '../../_packages/types.index';
+/**
+ * Supported wallet record types.
+ *
+ * @private type of WalletCommitmentDefinition
+ */
+export type WalletRecordType = 'USERNAME_PASSWORD' | 'SESSION_COOKIE' | 'ACCESS_TOKEN';
+/**
+ * Normalized wallet record payload used by runtime adapters.
+ *
+ * @private type of WalletCommitmentDefinition
+ */
+export type WalletToolRecord = {
+    id?: string;
+    recordType: WalletRecordType;
+    service: string;
+    key: string;
+    username?: string | null;
+    password?: string | null;
+    secret?: string | null;
+    cookies?: string | null;
+    isUserScoped: boolean;
+    isGlobal: boolean;
+    createdAt?: string;
+    updatedAt?: string;
+};
+/**
+ * Runtime context for wallet operations.
+ *
+ * @private type of WalletCommitmentDefinition
+ */
+export type WalletToolRuntimeContext = {
+    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 wallet tools.
+ *
+ * @private type of WalletCommitmentDefinition
+ */
+export type WalletToolRuntimeAdapter = {
+    retrieveWalletRecords(args: {
+        query?: string;
+        recordType?: WalletRecordType;
+        service?: string;
+        key?: string;
+        limit?: number;
+    }, runtimeContext: WalletToolRuntimeContext): Promise<WalletToolRecord[]>;
+    storeWalletRecord(args: WalletToolRecord & {
+        username?: string | null;
+        password?: string | null;
+        secret?: string | null;
+        cookies?: string | null;
+    }, runtimeContext: WalletToolRuntimeContext): Promise<WalletToolRecord>;
+    updateWalletRecord(args: WalletToolRecord & {
+        walletId: string;
+        username?: string | null;
+        password?: string | null;
+        secret?: string | null;
+        cookies?: string | null;
+    }, runtimeContext: WalletToolRuntimeContext): Promise<WalletToolRecord>;
+    deleteWalletRecord(args: {
+        walletId: string;
+    }, runtimeContext: WalletToolRuntimeContext): Promise<{
+        id?: string;
+    }>;
+};
+/**
+ * Arguments accepted by `retrieve_wallet_records`.
+ *
+ * @private type of WalletCommitmentDefinition
+ */
+export type RetrieveWalletRecordsToolArgs = {
+    query?: string;
+    recordType?: WalletRecordType;
+    service?: string;
+    key?: string;
+    limit?: number;
+    [key: string]: TODO_any;
+};
+/**
+ * Arguments accepted by `store_wallet_record`.
+ *
+ * @private type of WalletCommitmentDefinition
+ */
+export type StoreWalletRecordToolArgs = {
+    recordType?: WalletRecordType;
+    service?: string;
+    key?: string;
+    username?: string;
+    password?: string;
+    secret?: string;
+    cookies?: string;
+    isUserScoped?: boolean;
+    isGlobal?: boolean;
+    [key: string]: TODO_any;
+};
+/**
+ * Arguments accepted by `update_wallet_record`.
+ *
+ * @private type of WalletCommitmentDefinition
+ */
+export type UpdateWalletRecordToolArgs = StoreWalletRecordToolArgs & {
+    walletId?: string;
+};
+/**
+ * Arguments accepted by `delete_wallet_record`.
+ *
+ * @private type of WalletCommitmentDefinition
+ */
+export type DeleteWalletRecordToolArgs = {
+    walletId?: string;
+    [key: string]: TODO_any;
+};
+/**
+ * Arguments accepted by `request_wallet_record`.
+ *
+ * @private type of WalletCommitmentDefinition
+ */
+export type RequestWalletRecordToolArgs = {
+    recordType?: WalletRecordType;
+    service?: string;
+    key?: string;
+    message?: string;
+    isUserScoped?: boolean;
+    isGlobal?: boolean;
+    [key: string]: TODO_any;
+};
+/**
+ * Parsed request payload for `request_wallet_record`.
+ *
+ * @private type of WalletCommitmentDefinition
+ */
+export type WalletRequestRecord = {
+    recordType: WalletRecordType;
+    service: string;
+    key: string;
+    message?: string;
+    isUserScoped: boolean;
+    isGlobal: boolean;
+};
+/**
+ * Runtime wallet-tool action name.
+ *
+ * @private type of WalletCommitmentDefinition
+ */
+export type WalletRuntimeToolAction = 'retrieve' | 'store' | 'update' | 'delete';
+/**
+ * Result payload returned when a runtime wallet action is disabled.
+ *
+ * @private type of WalletCommitmentDefinition
+ */
+export type WalletDisabledToolResult = {
+    action: WalletRuntimeToolAction;
+    status: 'disabled';
+    records?: Array<never>;
+    message: string;
+};

package/esm/src/commitments/WALLET/createWalletSystemMessage.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Creates WALLET system-message instructions.
+ *
+ * @private function of WalletCommitmentDefinition
+ */
+export declare function createWalletSystemMessage(extraInstructions: string): string;

package/esm/src/commitments/WALLET/createWalletToolFunctions.d.ts

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

package/esm/src/commitments/WALLET/createWalletTools.d.ts

@@ -0,0 +1,7 @@
+import type { LlmToolDefinition } from '../../types/LlmToolDefinition';
+/**
+ * Creates tool definitions required by WALLET commitment.
+ *
+ * @private function of WalletCommitmentDefinition
+ */
+export declare function createWalletTools(existingTools: ReadonlyArray<LlmToolDefinition> | undefined): LlmToolDefinition[];