@promptbook/markdown-utils 0.112.0-11 → 0.112.0-12

package/esm/index.es.js

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

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

@@ -31,7 +31,7 @@ export type AgentCapability = {
     /**
      * The type of the capability
      */
-    type: 'browser' | 'search-engine' | 'knowledge' | 'timeout' | 'time' | 'user-location' | 'inheritance' | 'import' | 'image-generator' | 'team' | 'email' | 'popup' | 'privacy' | 'project' | 'wallet';
+    type: 'browser' | 'search-engine' | 'knowledge' | 'timeout' | 'time' | 'user-location' | 'inheritance' | 'import' | 'image-generator' | 'team' | 'email' | 'popup' | 'privacy' | 'project' | 'calendar' | 'wallet';
     /**
      * The label to display for this capability
      */

package/esm/src/book-components/Chat/Chat/ChatToolCallModal.test.d.ts

@@ -0,0 +1,2 @@
+/** @jest-environment jsdom */
+export {};

package/esm/src/book-components/Chat/Chat/renderToolCallDetails.d.ts

@@ -25,6 +25,10 @@ type ToolCallDetailsOptions = {
      * Chat button color for fallback styling.
      */
     buttonColor: WithTake<Color>;
+    /**
+     * Requests switching the modal into advanced technical mode.
+     */
+    onRequestAdvancedView?: () => void;
 };
 /**
  * Renders the detail view for a single tool call.

package/esm/src/book-components/Chat/utils/getToolCallChipletInfo.timeout.test.d.ts

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

package/esm/src/book-components/Chat/utils/timeoutToolCallPresentation.d.ts

@@ -0,0 +1,123 @@
+import type { TODO_any } from '../../../utils/organization/TODO_any';
+/**
+ * Action performed by timeout tools.
+ *
+ * @private internal timeout-chat type
+ */
+export type TimeoutToolCallAction = 'set' | 'cancel';
+/**
+ * Friendly presentation payload derived from timeout tool arguments and result.
+ *
+ * @private internal utility of `<Chat/>`
+ */
+export type TimeoutToolCallPresentation = {
+    /**
+     * Timeout action represented by this tool call.
+     */
+    readonly action: TimeoutToolCallAction;
+    /**
+     * Timeout operation status from tool result.
+     */
+    readonly status: string | null;
+    /**
+     * Requested timeout duration in milliseconds.
+     */
+    readonly milliseconds: number | null;
+    /**
+     * Optional timeout identifier returned by runtime.
+     */
+    readonly timeoutId: string | null;
+    /**
+     * Optional custom timeout wake-up message.
+     */
+    readonly message: string | null;
+    /**
+     * Parsed due date for scheduled timeout.
+     */
+    readonly dueAtDate: Date | null;
+    /**
+     * Exact due timestamp in ISO UTC format.
+     */
+    readonly dueAtIsoUtc: string | null;
+    /**
+     * Local timezone used for user-facing rendering.
+     */
+    readonly localTimezone: string;
+    /**
+     * Compact duration label used by timeout chips.
+     */
+    readonly compactDurationLabel: string | null;
+    /**
+     * Long duration label used by timeout detail popup copy.
+     */
+    readonly humanDurationLabel: string | null;
+    /**
+     * Relative time label resolved from due date and current time.
+     */
+    readonly relativeDueLabel: string | null;
+    /**
+     * Localized due time for friendly popups.
+     */
+    readonly localDueTimeLabel: string | null;
+    /**
+     * Localized due date for friendly popups.
+     */
+    readonly localDueDateLabel: string | null;
+};
+/**
+ * Inputs required to derive timeout presentation metadata.
+ *
+ * @private internal timeout-chat type
+ */
+type ResolveTimeoutToolCallPresentationOptions = {
+    /**
+     * Tool name being rendered.
+     */
+    readonly toolCallName: string;
+    /**
+     * Parsed tool arguments.
+     */
+    readonly args: Record<string, TODO_any>;
+    /**
+     * Parsed raw tool result payload.
+     */
+    readonly resultRaw: TODO_any;
+    /**
+     * Current date used to calculate relative labels.
+     */
+    readonly currentDate?: Date;
+};
+/**
+ * Determines whether a tool name belongs to the timeout commitment.
+ *
+ * @private internal utility of `<Chat/>`
+ */
+export declare function isTimeoutToolCallName(toolName: string): boolean;
+/**
+ * Resolves friendly timeout presentation metadata from one tool call payload.
+ *
+ * @private internal utility of `<Chat/>`
+ */
+export declare function resolveTimeoutToolCallPresentation(options: ResolveTimeoutToolCallPresentationOptions): TimeoutToolCallPresentation | null;
+/**
+ * Builds concise chip text for timeout tool calls.
+ *
+ * @private internal utility of `<Chat/>`
+ */
+export declare function buildTimeoutToolCallChipLabel(presentation: TimeoutToolCallPresentation): string;
+/**
+ * Builds the primary timeout sentence shown in default modal view.
+ *
+ * @private internal utility of `<Chat/>`
+ */
+export declare function buildTimeoutToolPrimarySentence(presentation: TimeoutToolCallPresentation): string;
+/**
+ * Builds one default-view scheduling sentence with local-time and relative context.
+ *
+ * @private internal utility of `<Chat/>`
+ */
+export declare function buildTimeoutToolScheduleSentence(presentation: TimeoutToolCallPresentation): string | null;
+export {};
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/src/book-components/Chat/utils/timeoutToolCallPresentation.test.d.ts

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

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

@@ -0,0 +1,42 @@
+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';
+/**
+ * USE CALENDAR commitment definition.
+ *
+ * `USE CALENDAR` enables calendar tooling so the agent can read and manage events
+ * in one configured Google Calendar.
+ *
+ * Authentication is expected through runtime context provided by the host app UI.
+ * Hosts can provide manual wallet tokens or host-managed OAuth tokens.
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class UseCalendarCommitmentDefinition extends BaseCommitmentDefinition<'USE CALENDAR'> {
+    constructor();
+    /**
+     * Short one-line description of USE CALENDAR.
+     */
+    get description(): string;
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string;
+    /**
+     * Markdown documentation for USE CALENDAR 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 calendar tool function implementations.
+     */
+    getToolFunctions(): Record<string_javascript_name, ToolFunction>;
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

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

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

package/esm/src/commitments/USE_CALENDAR/UseCalendarToolNames.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Names of tools used by the USE CALENDAR commitment.
+ *
+ * @private constant of UseCalendarCommitmentDefinition
+ */
+export declare const UseCalendarToolNames: {
+    readonly listEvents: string;
+    readonly getEvent: string;
+    readonly createEvent: string;
+    readonly updateEvent: string;
+    readonly deleteEvent: string;
+    readonly inviteGuests: string;
+};

package/esm/src/commitments/USE_CALENDAR/UseCalendarWallet.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Wallet metadata used by USE CALENDAR when resolving Google Calendar credentials.
+ *
+ * @private constant of UseCalendarCommitmentDefinition
+ */
+export declare const UseCalendarWallet: {
+    readonly service: "google_calendar";
+    readonly key: "use-calendar-google-token";
+};

package/esm/src/commitments/USE_CALENDAR/calendarReference.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Default Google Calendar OAuth scopes when commitment content does not list any.
+ *
+ * @private internal USE CALENDAR constant
+ */
+export declare const DEFAULT_GOOGLE_CALENDAR_SCOPES: readonly ["https://www.googleapis.com/auth/calendar"];
+/**
+ * Calendar provider types currently supported by USE CALENDAR.
+ *
+ * @private internal utility of USE CALENDAR commitment
+ */
+export type CalendarProviderType = 'google';
+/**
+ * Canonical calendar reference resolved from commitment content.
+ *
+ * @private internal utility of USE CALENDAR commitment
+ */
+export type CalendarReference = {
+    provider: CalendarProviderType;
+    url: string;
+    calendarId: string;
+    scopes: string[];
+    tokenRef?: string;
+};
+/**
+ * Parsed `USE CALENDAR` payload.
+ *
+ * @private internal utility of USE CALENDAR commitment
+ */
+export type ParsedUseCalendarCommitmentContent = {
+    calendar: CalendarReference | null;
+    calendarUrlRaw: string | null;
+    instructions: string;
+};
+/**
+ * Parses one Google Calendar URL/reference into canonical details.
+ *
+ * Supported input forms:
+ * - `https://calendar.google.com/...`
+ * - `calendar.google.com/...`
+ *
+ * @private internal utility of USE CALENDAR commitment
+ */
+export declare function parseGoogleCalendarReference(rawReference: string): CalendarReference | null;
+/**
+ * Parses `USE CALENDAR` commitment content into calendar reference + optional instructions.
+ *
+ * @private internal utility of USE CALENDAR commitment
+ */
+export declare function parseUseCalendarCommitmentContent(content: string): ParsedUseCalendarCommitmentContent;
+/**
+ * Extracts canonical calendar references from parsed commitments.
+ *
+ * @private internal utility of USE CALENDAR commitment
+ */
+export declare function extractUseCalendarReferencesFromCommitments(commitments: ReadonlyArray<{
+    type: string;
+    content: string;
+}>): CalendarReference[];
+/**
+ * Attempts to resolve one concrete Google Calendar id from URL.
+ *
+ * @private internal utility of USE CALENDAR commitment
+ */
+export declare function parseGoogleCalendarIdFromUrl(url: URL): string | null;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/src/commitments/USE_CALENDAR/callGoogleCalendarApi.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Options for one Google Calendar API call.
+ *
+ * @private type of callGoogleCalendarApi
+ */
+type CallGoogleCalendarApiOptions = {
+    method: 'GET' | 'POST' | 'PATCH' | 'DELETE';
+    path: string;
+    query?: Record<string, string>;
+    body?: Record<string, unknown>;
+    allowNotFound?: boolean;
+};
+/**
+ * Runs one Google Calendar API request and parses JSON response payload.
+ *
+ * @private function of UseCalendarCommitmentDefinition
+ */
+export declare function callGoogleCalendarApi<TResponse = unknown>(accessToken: string, options: CallGoogleCalendarApiOptions): Promise<TResponse | null>;
+export {};

package/esm/src/commitments/USE_CALENDAR/createUseCalendarToolFunctions.d.ts

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

package/esm/src/commitments/USE_CALENDAR/createUseCalendarTools.d.ts

@@ -0,0 +1,7 @@
+import type { LlmToolDefinition } from '../../types/LlmToolDefinition';
+/**
+ * Adds USE CALENDAR tool definitions while keeping already registered tools untouched.
+ *
+ * @private function of UseCalendarCommitmentDefinition
+ */
+export declare function createUseCalendarTools(existingTools: ReadonlyArray<LlmToolDefinition>): Array<LlmToolDefinition>;

package/esm/src/commitments/USE_CALENDAR/getUseCalendarToolTitles.d.ts

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

package/esm/src/commitments/USE_CALENDAR/normalizeConfiguredCalendars.d.ts

@@ -0,0 +1,19 @@
+import type { CalendarProviderType } from './calendarReference';
+/**
+ * Normalized calendar definition persisted in USE CALENDAR metadata.
+ *
+ * @private internal utility of USE CALENDAR commitment
+ */
+export type ConfiguredCalendar = {
+    provider: CalendarProviderType;
+    url: string;
+    calendarId: string;
+    scopes: string[];
+    tokenRef?: string;
+};
+/**
+ * Normalizes unknown metadata payload into a typed list of configured calendars.
+ *
+ * @private internal utility of USE CALENDAR commitment
+ */
+export declare function normalizeConfiguredCalendars(rawCalendars: unknown): ConfiguredCalendar[];

package/esm/src/commitments/USE_CALENDAR/resolveUseCalendarToolRuntimeOrWalletCredentialResult.d.ts

@@ -0,0 +1,34 @@
+import { type CalendarReference } from './calendarReference';
+/**
+ * Shared hidden arguments potentially injected into any USE CALENDAR tool call.
+ *
+ * @private type of UseCalendarCommitmentDefinition
+ */
+export type UseCalendarToolArgsBase = {
+    calendarUrl?: string;
+    __promptbookToolRuntimeContext?: unknown;
+};
+/**
+ * Resolved runtime payload used by USE CALENDAR tools.
+ *
+ * @private type of resolveUseCalendarToolRuntimeOrWalletCredentialResult
+ */
+type UseCalendarResolvedRuntime = {
+    calendarReference: CalendarReference;
+    accessToken: string;
+};
+/**
+ * Runtime resolution result for USE CALENDAR tools.
+ *
+ * @private type of UseCalendarCommitmentDefinition
+ */
+export type UseCalendarToolRuntimeResolution = UseCalendarResolvedRuntime | {
+    walletResult: string;
+};
+/**
+ * Resolves calendar runtime or returns a wallet-credential-required payload when missing.
+ *
+ * @private function of UseCalendarCommitmentDefinition
+ */
+export declare function resolveUseCalendarToolRuntimeOrWalletCredentialResult(args: UseCalendarToolArgsBase): UseCalendarToolRuntimeResolution;
+export {};

package/esm/src/commitments/_common/toolRuntimeContext.d.ts

@@ -85,6 +85,15 @@ export type ToolRuntimeContext = {
         smtpCredential?: string;
         fromAddress?: string;
     };
+    calendars?: {
+        googleAccessToken?: string;
+        connections?: Array<{
+            provider: string;
+            url: string;
+            calendarId: string;
+            scopes?: string[];
+        }>;
+    };
     spawn?: {
         depth?: number;
         parentRunId?: string;

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

@@ -37,6 +37,7 @@ import { TeamCommitmentDefinition } from './TEAM/TEAM';
 import { TemplateCommitmentDefinition } from './TEMPLATE/TEMPLATE';
 import { UseCommitmentDefinition } from './USE/USE';
 import { UseBrowserCommitmentDefinition } from './USE_BROWSER/USE_BROWSER';
+import { UseCalendarCommitmentDefinition } from './USE_CALENDAR/USE_CALENDAR';
 import { UseEmailCommitmentDefinition } from './USE_EMAIL/USE_EMAIL';
 import { UseImageGeneratorCommitmentDefinition } from './USE_IMAGE_GENERATOR/USE_IMAGE_GENERATOR';
 import { UseMcpCommitmentDefinition } from './USE_MCP/USE_MCP';
@@ -58,7 +59,7 @@ import { NotYetImplementedCommitmentDefinition } from './_base/NotYetImplemented
  *
  * @private Use functions to access commitments instead of this array directly
  */
-export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, LanguageCommitmentDefinition, LanguageCommitmentDefinition, WritingSampleCommitmentDefinition, WritingRulesCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, TemplateCommitmentDefinition, TemplateCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaDomainCommitmentDefinition, MetaDisclaimerCommitmentDefinition, MetaInputPlaceholderCommitmentDefinition, MetaCommitmentDefinition, MetaVoiceCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, InternalMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageSuffixCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, TeamCommitmentDefinition, UseBrowserCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseSpawnCommitmentDefinition, UseTimeoutCommitmentDefinition, UseTimeCommitmentDefinition, UseUserLocationCommitmentDefinition, UseEmailCommitmentDefinition, UsePopupCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseMcpCommitmentDefinition, UsePrivacyCommitmentDefinition, UseProjectCommitmentDefinition, UseCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
+export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, LanguageCommitmentDefinition, LanguageCommitmentDefinition, WritingSampleCommitmentDefinition, WritingRulesCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, TemplateCommitmentDefinition, TemplateCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaDomainCommitmentDefinition, MetaDisclaimerCommitmentDefinition, MetaInputPlaceholderCommitmentDefinition, MetaCommitmentDefinition, MetaVoiceCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, InternalMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageSuffixCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, TeamCommitmentDefinition, UseBrowserCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseSpawnCommitmentDefinition, UseTimeoutCommitmentDefinition, UseTimeCommitmentDefinition, UseUserLocationCommitmentDefinition, UseCalendarCommitmentDefinition, UseEmailCommitmentDefinition, UsePopupCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseMcpCommitmentDefinition, UsePrivacyCommitmentDefinition, UseProjectCommitmentDefinition, UseCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
 /**
  * TODO: [🧠] Maybe create through standardized $register
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/esm/src/executables/apps/locateVscode.d.ts

@@ -0,0 +1,7 @@
+import type { string_executable_path } from '../../types/typeAliases';
+/**
+ * @@@
+ *
+ * @private within the repository
+ */
+export declare function locateVscode(): Promise<string_executable_path | null>;

package/esm/src/executables/apps/locateVscode.test.d.ts

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

package/esm/src/executables/browsers/locateBrowser.d.ts

@@ -0,0 +1,10 @@
+import type { string_executable_path } from '../../types/typeAliases';
+/**
+ * @@@
+ *
+ * @param browser It can be "default", "chrome", "firefox", "safari", "ie", "msie", "edge" or "msedge" or executable path to the browser
+ * @returns executable path to browser
+ *
+ * @private within the repository
+ */
+export declare function locateBrowser(browser: string): Promise<string_executable_path | null>;

package/esm/src/executables/browsers/locateBrowser.test.d.ts

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

package/esm/src/executables/browsers/locateChrome.d.ts

@@ -0,0 +1,7 @@
+import type { string_executable_path } from '../../types/typeAliases';
+/**
+ * @@@
+ *
+ * @private within the repository
+ */
+export declare function locateChrome(): Promise<string_executable_path | null>;

package/esm/src/executables/browsers/locateChrome.test.d.ts

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

package/esm/src/executables/browsers/locateDefaultSystemBrowser.d.ts

@@ -0,0 +1,10 @@
+import type { string_executable_path } from '../../types/typeAliases';
+/**
+ * @@@
+ *
+ * @param browser It can be "default", "chrome", "firefox", "safari", "ie", "msie", "edge" or "msedge" or executable path to the browser
+ * @returns executable path to browser
+ *
+ * @private within the repository
+ */
+export declare function locateDefaultSystemBrowser(): Promise<string_executable_path | null>;

package/esm/src/executables/browsers/locateDefaultSystemBrowser.test.d.ts

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

package/esm/src/executables/browsers/locateEdge.d.ts

@@ -0,0 +1,7 @@
+import type { string_executable_path } from '../../types/typeAliases';
+/**
+ * @@@
+ *
+ * @private within the repository
+ */
+export declare function locateEdge(): Promise<string_executable_path | null>;

package/esm/src/executables/browsers/locateEdge.test.d.ts

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

package/esm/src/executables/browsers/locateFirefox.d.ts

@@ -0,0 +1,7 @@
+import type { string_executable_path } from '../../types/typeAliases';
+/**
+ * @@@
+ *
+ * @private within the repository
+ */
+export declare function locateFirefox(): Promise<string_executable_path | null>;

package/esm/src/executables/browsers/locateFirefox.test.d.ts

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

package/esm/src/executables/browsers/locateInternetExplorer.d.ts

@@ -0,0 +1,7 @@
+import type { string_executable_path } from '../../types/typeAliases';
+/**
+ * @@@
+ *
+ * @private within the repository
+ */
+export declare function locateInternetExplorer(): Promise<string_executable_path | null>;

package/esm/src/executables/browsers/locateInternetExplorer.test.d.ts

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

package/esm/src/executables/browsers/locateSafari.d.ts

@@ -0,0 +1,7 @@
+import type { string_executable_path } from '../../types/typeAliases';
+/**
+ * @@@
+ *
+ * @private within the repository
+ */
+export declare function locateSafari(): Promise<string_executable_path | null>;

package/esm/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.112.0-0`).
+ * It follows semantic versioning (e.g., `0.112.0-11`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/markdown-utils",
-    "version": "0.112.0-11",
+    "version": "0.112.0-12",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,

package/umd/index.umd.js

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

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

@@ -31,7 +31,7 @@ export type AgentCapability = {
     /**
      * The type of the capability
      */
-    type: 'browser' | 'search-engine' | 'knowledge' | 'timeout' | 'time' | 'user-location' | 'inheritance' | 'import' | 'image-generator' | 'team' | 'email' | 'popup' | 'privacy' | 'project' | 'wallet';
+    type: 'browser' | 'search-engine' | 'knowledge' | 'timeout' | 'time' | 'user-location' | 'inheritance' | 'import' | 'image-generator' | 'team' | 'email' | 'popup' | 'privacy' | 'project' | 'calendar' | 'wallet';
     /**
      * The label to display for this capability
      */

package/umd/src/book-components/Chat/Chat/ChatToolCallModal.test.d.ts

@@ -0,0 +1,2 @@
+/** @jest-environment jsdom */
+export {};

package/umd/src/book-components/Chat/Chat/renderToolCallDetails.d.ts

@@ -25,6 +25,10 @@ type ToolCallDetailsOptions = {
      * Chat button color for fallback styling.
      */
     buttonColor: WithTake<Color>;
+    /**
+     * Requests switching the modal into advanced technical mode.
+     */
+    onRequestAdvancedView?: () => void;
 };
 /**
  * Renders the detail view for a single tool call.

package/umd/src/book-components/Chat/utils/getToolCallChipletInfo.timeout.test.d.ts

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

package/umd/src/book-components/Chat/utils/timeoutToolCallPresentation.d.ts

@@ -0,0 +1,123 @@
+import type { TODO_any } from '../../../utils/organization/TODO_any';
+/**
+ * Action performed by timeout tools.
+ *
+ * @private internal timeout-chat type
+ */
+export type TimeoutToolCallAction = 'set' | 'cancel';
+/**
+ * Friendly presentation payload derived from timeout tool arguments and result.
+ *
+ * @private internal utility of `<Chat/>`
+ */
+export type TimeoutToolCallPresentation = {
+    /**
+     * Timeout action represented by this tool call.
+     */
+    readonly action: TimeoutToolCallAction;
+    /**
+     * Timeout operation status from tool result.
+     */
+    readonly status: string | null;
+    /**
+     * Requested timeout duration in milliseconds.
+     */
+    readonly milliseconds: number | null;
+    /**
+     * Optional timeout identifier returned by runtime.
+     */
+    readonly timeoutId: string | null;
+    /**
+     * Optional custom timeout wake-up message.
+     */
+    readonly message: string | null;
+    /**
+     * Parsed due date for scheduled timeout.
+     */
+    readonly dueAtDate: Date | null;
+    /**
+     * Exact due timestamp in ISO UTC format.
+     */
+    readonly dueAtIsoUtc: string | null;
+    /**
+     * Local timezone used for user-facing rendering.
+     */
+    readonly localTimezone: string;
+    /**
+     * Compact duration label used by timeout chips.
+     */
+    readonly compactDurationLabel: string | null;
+    /**
+     * Long duration label used by timeout detail popup copy.
+     */
+    readonly humanDurationLabel: string | null;
+    /**
+     * Relative time label resolved from due date and current time.
+     */
+    readonly relativeDueLabel: string | null;
+    /**
+     * Localized due time for friendly popups.
+     */
+    readonly localDueTimeLabel: string | null;
+    /**
+     * Localized due date for friendly popups.
+     */
+    readonly localDueDateLabel: string | null;
+};
+/**
+ * Inputs required to derive timeout presentation metadata.
+ *
+ * @private internal timeout-chat type
+ */
+type ResolveTimeoutToolCallPresentationOptions = {
+    /**
+     * Tool name being rendered.
+     */
+    readonly toolCallName: string;
+    /**
+     * Parsed tool arguments.
+     */
+    readonly args: Record<string, TODO_any>;
+    /**
+     * Parsed raw tool result payload.
+     */
+    readonly resultRaw: TODO_any;
+    /**
+     * Current date used to calculate relative labels.
+     */
+    readonly currentDate?: Date;
+};
+/**
+ * Determines whether a tool name belongs to the timeout commitment.
+ *
+ * @private internal utility of `<Chat/>`
+ */
+export declare function isTimeoutToolCallName(toolName: string): boolean;
+/**
+ * Resolves friendly timeout presentation metadata from one tool call payload.
+ *
+ * @private internal utility of `<Chat/>`
+ */
+export declare function resolveTimeoutToolCallPresentation(options: ResolveTimeoutToolCallPresentationOptions): TimeoutToolCallPresentation | null;
+/**
+ * Builds concise chip text for timeout tool calls.
+ *
+ * @private internal utility of `<Chat/>`
+ */
+export declare function buildTimeoutToolCallChipLabel(presentation: TimeoutToolCallPresentation): string;
+/**
+ * Builds the primary timeout sentence shown in default modal view.
+ *
+ * @private internal utility of `<Chat/>`
+ */
+export declare function buildTimeoutToolPrimarySentence(presentation: TimeoutToolCallPresentation): string;
+/**
+ * Builds one default-view scheduling sentence with local-time and relative context.
+ *
+ * @private internal utility of `<Chat/>`
+ */
+export declare function buildTimeoutToolScheduleSentence(presentation: TimeoutToolCallPresentation): string | null;
+export {};
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/umd/src/book-components/Chat/utils/timeoutToolCallPresentation.test.d.ts

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

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

@@ -0,0 +1,42 @@
+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';
+/**
+ * USE CALENDAR commitment definition.
+ *
+ * `USE CALENDAR` enables calendar tooling so the agent can read and manage events
+ * in one configured Google Calendar.
+ *
+ * Authentication is expected through runtime context provided by the host app UI.
+ * Hosts can provide manual wallet tokens or host-managed OAuth tokens.
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class UseCalendarCommitmentDefinition extends BaseCommitmentDefinition<'USE CALENDAR'> {
+    constructor();
+    /**
+     * Short one-line description of USE CALENDAR.
+     */
+    get description(): string;
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string;
+    /**
+     * Markdown documentation for USE CALENDAR 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 calendar tool function implementations.
+     */
+    getToolFunctions(): Record<string_javascript_name, ToolFunction>;
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

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

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

package/umd/src/commitments/USE_CALENDAR/UseCalendarToolNames.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Names of tools used by the USE CALENDAR commitment.
+ *
+ * @private constant of UseCalendarCommitmentDefinition
+ */
+export declare const UseCalendarToolNames: {
+    readonly listEvents: string;
+    readonly getEvent: string;
+    readonly createEvent: string;
+    readonly updateEvent: string;
+    readonly deleteEvent: string;
+    readonly inviteGuests: string;
+};

package/umd/src/commitments/USE_CALENDAR/UseCalendarWallet.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Wallet metadata used by USE CALENDAR when resolving Google Calendar credentials.
+ *
+ * @private constant of UseCalendarCommitmentDefinition
+ */
+export declare const UseCalendarWallet: {
+    readonly service: "google_calendar";
+    readonly key: "use-calendar-google-token";
+};

package/umd/src/commitments/USE_CALENDAR/calendarReference.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Default Google Calendar OAuth scopes when commitment content does not list any.
+ *
+ * @private internal USE CALENDAR constant
+ */
+export declare const DEFAULT_GOOGLE_CALENDAR_SCOPES: readonly ["https://www.googleapis.com/auth/calendar"];
+/**
+ * Calendar provider types currently supported by USE CALENDAR.
+ *
+ * @private internal utility of USE CALENDAR commitment
+ */
+export type CalendarProviderType = 'google';
+/**
+ * Canonical calendar reference resolved from commitment content.
+ *
+ * @private internal utility of USE CALENDAR commitment
+ */
+export type CalendarReference = {
+    provider: CalendarProviderType;
+    url: string;
+    calendarId: string;
+    scopes: string[];
+    tokenRef?: string;
+};
+/**
+ * Parsed `USE CALENDAR` payload.
+ *
+ * @private internal utility of USE CALENDAR commitment
+ */
+export type ParsedUseCalendarCommitmentContent = {
+    calendar: CalendarReference | null;
+    calendarUrlRaw: string | null;
+    instructions: string;
+};
+/**
+ * Parses one Google Calendar URL/reference into canonical details.
+ *
+ * Supported input forms:
+ * - `https://calendar.google.com/...`
+ * - `calendar.google.com/...`
+ *
+ * @private internal utility of USE CALENDAR commitment
+ */
+export declare function parseGoogleCalendarReference(rawReference: string): CalendarReference | null;
+/**
+ * Parses `USE CALENDAR` commitment content into calendar reference + optional instructions.
+ *
+ * @private internal utility of USE CALENDAR commitment
+ */
+export declare function parseUseCalendarCommitmentContent(content: string): ParsedUseCalendarCommitmentContent;
+/**
+ * Extracts canonical calendar references from parsed commitments.
+ *
+ * @private internal utility of USE CALENDAR commitment
+ */
+export declare function extractUseCalendarReferencesFromCommitments(commitments: ReadonlyArray<{
+    type: string;
+    content: string;
+}>): CalendarReference[];
+/**
+ * Attempts to resolve one concrete Google Calendar id from URL.
+ *
+ * @private internal utility of USE CALENDAR commitment
+ */
+export declare function parseGoogleCalendarIdFromUrl(url: URL): string | null;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/umd/src/commitments/USE_CALENDAR/callGoogleCalendarApi.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Options for one Google Calendar API call.
+ *
+ * @private type of callGoogleCalendarApi
+ */
+type CallGoogleCalendarApiOptions = {
+    method: 'GET' | 'POST' | 'PATCH' | 'DELETE';
+    path: string;
+    query?: Record<string, string>;
+    body?: Record<string, unknown>;
+    allowNotFound?: boolean;
+};
+/**
+ * Runs one Google Calendar API request and parses JSON response payload.
+ *
+ * @private function of UseCalendarCommitmentDefinition
+ */
+export declare function callGoogleCalendarApi<TResponse = unknown>(accessToken: string, options: CallGoogleCalendarApiOptions): Promise<TResponse | null>;
+export {};

package/umd/src/commitments/USE_CALENDAR/createUseCalendarToolFunctions.d.ts

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

package/umd/src/commitments/USE_CALENDAR/createUseCalendarTools.d.ts

@@ -0,0 +1,7 @@
+import type { LlmToolDefinition } from '../../types/LlmToolDefinition';
+/**
+ * Adds USE CALENDAR tool definitions while keeping already registered tools untouched.
+ *
+ * @private function of UseCalendarCommitmentDefinition
+ */
+export declare function createUseCalendarTools(existingTools: ReadonlyArray<LlmToolDefinition>): Array<LlmToolDefinition>;

package/umd/src/commitments/USE_CALENDAR/getUseCalendarToolTitles.d.ts

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

package/umd/src/commitments/USE_CALENDAR/normalizeConfiguredCalendars.d.ts

@@ -0,0 +1,19 @@
+import type { CalendarProviderType } from './calendarReference';
+/**
+ * Normalized calendar definition persisted in USE CALENDAR metadata.
+ *
+ * @private internal utility of USE CALENDAR commitment
+ */
+export type ConfiguredCalendar = {
+    provider: CalendarProviderType;
+    url: string;
+    calendarId: string;
+    scopes: string[];
+    tokenRef?: string;
+};
+/**
+ * Normalizes unknown metadata payload into a typed list of configured calendars.
+ *
+ * @private internal utility of USE CALENDAR commitment
+ */
+export declare function normalizeConfiguredCalendars(rawCalendars: unknown): ConfiguredCalendar[];

package/umd/src/commitments/USE_CALENDAR/resolveUseCalendarToolRuntimeOrWalletCredentialResult.d.ts

@@ -0,0 +1,34 @@
+import { type CalendarReference } from './calendarReference';
+/**
+ * Shared hidden arguments potentially injected into any USE CALENDAR tool call.
+ *
+ * @private type of UseCalendarCommitmentDefinition
+ */
+export type UseCalendarToolArgsBase = {
+    calendarUrl?: string;
+    __promptbookToolRuntimeContext?: unknown;
+};
+/**
+ * Resolved runtime payload used by USE CALENDAR tools.
+ *
+ * @private type of resolveUseCalendarToolRuntimeOrWalletCredentialResult
+ */
+type UseCalendarResolvedRuntime = {
+    calendarReference: CalendarReference;
+    accessToken: string;
+};
+/**
+ * Runtime resolution result for USE CALENDAR tools.
+ *
+ * @private type of UseCalendarCommitmentDefinition
+ */
+export type UseCalendarToolRuntimeResolution = UseCalendarResolvedRuntime | {
+    walletResult: string;
+};
+/**
+ * Resolves calendar runtime or returns a wallet-credential-required payload when missing.
+ *
+ * @private function of UseCalendarCommitmentDefinition
+ */
+export declare function resolveUseCalendarToolRuntimeOrWalletCredentialResult(args: UseCalendarToolArgsBase): UseCalendarToolRuntimeResolution;
+export {};

package/umd/src/commitments/_common/toolRuntimeContext.d.ts

@@ -85,6 +85,15 @@ export type ToolRuntimeContext = {
         smtpCredential?: string;
         fromAddress?: string;
     };
+    calendars?: {
+        googleAccessToken?: string;
+        connections?: Array<{
+            provider: string;
+            url: string;
+            calendarId: string;
+            scopes?: string[];
+        }>;
+    };
     spawn?: {
         depth?: number;
         parentRunId?: string;

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

@@ -37,6 +37,7 @@ import { TeamCommitmentDefinition } from './TEAM/TEAM';
 import { TemplateCommitmentDefinition } from './TEMPLATE/TEMPLATE';
 import { UseCommitmentDefinition } from './USE/USE';
 import { UseBrowserCommitmentDefinition } from './USE_BROWSER/USE_BROWSER';
+import { UseCalendarCommitmentDefinition } from './USE_CALENDAR/USE_CALENDAR';
 import { UseEmailCommitmentDefinition } from './USE_EMAIL/USE_EMAIL';
 import { UseImageGeneratorCommitmentDefinition } from './USE_IMAGE_GENERATOR/USE_IMAGE_GENERATOR';
 import { UseMcpCommitmentDefinition } from './USE_MCP/USE_MCP';
@@ -58,7 +59,7 @@ import { NotYetImplementedCommitmentDefinition } from './_base/NotYetImplemented
  *
  * @private Use functions to access commitments instead of this array directly
  */
-export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, LanguageCommitmentDefinition, LanguageCommitmentDefinition, WritingSampleCommitmentDefinition, WritingRulesCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, TemplateCommitmentDefinition, TemplateCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaDomainCommitmentDefinition, MetaDisclaimerCommitmentDefinition, MetaInputPlaceholderCommitmentDefinition, MetaCommitmentDefinition, MetaVoiceCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, InternalMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageSuffixCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, TeamCommitmentDefinition, UseBrowserCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseSpawnCommitmentDefinition, UseTimeoutCommitmentDefinition, UseTimeCommitmentDefinition, UseUserLocationCommitmentDefinition, UseEmailCommitmentDefinition, UsePopupCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseMcpCommitmentDefinition, UsePrivacyCommitmentDefinition, UseProjectCommitmentDefinition, UseCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
+export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, LanguageCommitmentDefinition, LanguageCommitmentDefinition, WritingSampleCommitmentDefinition, WritingRulesCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, TemplateCommitmentDefinition, TemplateCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaDomainCommitmentDefinition, MetaDisclaimerCommitmentDefinition, MetaInputPlaceholderCommitmentDefinition, MetaCommitmentDefinition, MetaVoiceCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, InternalMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageSuffixCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, TeamCommitmentDefinition, UseBrowserCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseSpawnCommitmentDefinition, UseTimeoutCommitmentDefinition, UseTimeCommitmentDefinition, UseUserLocationCommitmentDefinition, UseCalendarCommitmentDefinition, UseEmailCommitmentDefinition, UsePopupCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseMcpCommitmentDefinition, UsePrivacyCommitmentDefinition, UseProjectCommitmentDefinition, UseCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
 /**
  * TODO: [🧠] Maybe create through standardized $register
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/umd/src/executables/apps/locateVscode.d.ts

@@ -0,0 +1,7 @@
+import type { string_executable_path } from '../../types/typeAliases';
+/**
+ * @@@
+ *
+ * @private within the repository
+ */
+export declare function locateVscode(): Promise<string_executable_path | null>;

package/umd/src/executables/apps/locateVscode.test.d.ts

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

package/umd/src/executables/browsers/locateBrowser.d.ts

@@ -0,0 +1,10 @@
+import type { string_executable_path } from '../../types/typeAliases';
+/**
+ * @@@
+ *
+ * @param browser It can be "default", "chrome", "firefox", "safari", "ie", "msie", "edge" or "msedge" or executable path to the browser
+ * @returns executable path to browser
+ *
+ * @private within the repository
+ */
+export declare function locateBrowser(browser: string): Promise<string_executable_path | null>;

package/umd/src/executables/browsers/locateBrowser.test.d.ts

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

package/umd/src/executables/browsers/locateChrome.d.ts

@@ -0,0 +1,7 @@
+import type { string_executable_path } from '../../types/typeAliases';
+/**
+ * @@@
+ *
+ * @private within the repository
+ */
+export declare function locateChrome(): Promise<string_executable_path | null>;

package/umd/src/executables/browsers/locateChrome.test.d.ts

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

package/umd/src/executables/browsers/locateDefaultSystemBrowser.d.ts

@@ -0,0 +1,10 @@
+import type { string_executable_path } from '../../types/typeAliases';
+/**
+ * @@@
+ *
+ * @param browser It can be "default", "chrome", "firefox", "safari", "ie", "msie", "edge" or "msedge" or executable path to the browser
+ * @returns executable path to browser
+ *
+ * @private within the repository
+ */
+export declare function locateDefaultSystemBrowser(): Promise<string_executable_path | null>;

package/umd/src/executables/browsers/locateDefaultSystemBrowser.test.d.ts

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

package/umd/src/executables/browsers/locateEdge.d.ts

@@ -0,0 +1,7 @@
+import type { string_executable_path } from '../../types/typeAliases';
+/**
+ * @@@
+ *
+ * @private within the repository
+ */
+export declare function locateEdge(): Promise<string_executable_path | null>;

package/umd/src/executables/browsers/locateEdge.test.d.ts

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

package/umd/src/executables/browsers/locateFirefox.d.ts

@@ -0,0 +1,7 @@
+import type { string_executable_path } from '../../types/typeAliases';
+/**
+ * @@@
+ *
+ * @private within the repository
+ */
+export declare function locateFirefox(): Promise<string_executable_path | null>;

package/umd/src/executables/browsers/locateFirefox.test.d.ts

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

package/umd/src/executables/browsers/locateInternetExplorer.d.ts

@@ -0,0 +1,7 @@
+import type { string_executable_path } from '../../types/typeAliases';
+/**
+ * @@@
+ *
+ * @private within the repository
+ */
+export declare function locateInternetExplorer(): Promise<string_executable_path | null>;

package/umd/src/executables/browsers/locateInternetExplorer.test.d.ts

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

package/umd/src/executables/browsers/locateSafari.d.ts

@@ -0,0 +1,7 @@
+import type { string_executable_path } from '../../types/typeAliases';
+/**
+ * @@@
+ *
+ * @private within the repository
+ */
+export declare function locateSafari(): Promise<string_executable_path | null>;

package/umd/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.112.0-0`).
+ * It follows semantic versioning (e.g., `0.112.0-11`).
  *
  * @generated
  */