@promptbook/javascript 0.111.0-7 → 0.112.0-12

package/esm/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/esm/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/esm/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/esm/src/commitments/USE_BROWSER/resolveRunBrowserToolForNode.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/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/esm/src/commitments/USE_EMAIL/USE_EMAIL.test.d.ts

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

package/esm/src/commitments/USE_EMAIL/parseUseEmailCommitmentContent.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Parsed payload of one `USE EMAIL` commitment.
+ *
+ * @private internal USE EMAIL type
+ */
+export type ParsedUseEmailCommitmentContent = {
+    senderEmail: string | null;
+    senderEmailRaw: string | null;
+    instructions: string;
+};
+/**
+ * Parses `USE EMAIL` commitment content into optional sender email + additional instructions.
+ *
+ * Examples:
+ * - `agent@example.com`
+ * - `agent@example.com Keep emails concise`
+ * - `Keep emails concise`
+ *
+ * @private internal utility of USE EMAIL commitment
+ */
+export declare function parseUseEmailCommitmentContent(content: string): ParsedUseEmailCommitmentContent;

package/esm/src/commitments/USE_EMAIL/parseUseEmailCommitmentContent.test.d.ts

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

package/esm/src/commitments/USE_EMAIL/sendEmailViaBrowser.d.ts

@@ -4,15 +4,10 @@
  * This function proxies requests to the Agents Server API endpoint for email queuing,
  * making it safe to use in browser environments.
  *
- * @param args Email payload containing recipients, subject, and body
+ * @param args Email payload forwarded to the server-side `send_email` tool
  * @param agentsServerUrl The base URL of the agents server (defaults to current origin)
  * @returns Result string from the server-side send_email tool
  *
  * @private internal utility for USE EMAIL commitment
  */
-export declare function sendEmailViaBrowser(args: {
-    to: string[];
-    cc?: string[];
-    subject: string;
-    body: string;
-}, agentsServerUrl?: string): Promise<string>;
+export declare function sendEmailViaBrowser(args: Record<string, unknown>, agentsServerUrl?: string): Promise<string>;

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

@@ -0,0 +1,49 @@
+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 POPUP commitment definition
+ *
+ * The `USE POPUP` commitment indicates that the agent can open a popup window with a specific website.
+ * This is useful, for example, when the agent writes a post on Facebook but wants the user to post it on Facebook.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * USE POPUP Allow to open Facebook and Linkedin
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class UsePopupCommitmentDefinition extends BaseCommitmentDefinition<'USE POPUP'> {
+    constructor();
+    /**
+     * The `USE POPUP` commitment is standalone or with instructions.
+     */
+    get requiresContent(): boolean;
+    /**
+     * Short one-line description of USE POPUP.
+     */
+    get description(): string;
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string;
+    /**
+     * Markdown documentation for USE POPUP 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 the `open_popup` tool function implementation.
+     */
+    getToolFunctions(): Record<string_javascript_name, ToolFunction>;
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

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

@@ -0,0 +1,39 @@
+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 PRIVACY commitment definition.
+ *
+ * The `USE PRIVACY` commitment enables an agent to request enabling private mode.
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class UsePrivacyCommitmentDefinition extends BaseCommitmentDefinition<'USE PRIVACY'> {
+    constructor();
+    get requiresContent(): boolean;
+    /**
+     * Short one-line description of USE PRIVACY.
+     */
+    get description(): string;
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string;
+    /**
+     * Markdown documentation for USE PRIVACY 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 the `turn_privacy_on` tool function implementation.
+     */
+    getToolFunctions(): Record<string_javascript_name, ToolFunction>;
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

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

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

package/esm/src/commitments/USE_PROJECT/USE_PROJECT.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 PROJECT commitment definition.
+ *
+ * `USE PROJECT` enables GitHub repository tooling so the agent can browse source files,
+ * edit code, and open pull requests against declared repositories.
+ *
+ * Authentication is expected through runtime context provided by the host app UI.
+ * Hosts can provide manual wallet tokens or auto-issued integration tokens (for example via GitHub App).
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class UseProjectCommitmentDefinition extends BaseCommitmentDefinition<'USE PROJECT'> {
+    constructor();
+    /**
+     * Short one-line description of USE PROJECT.
+     */
+    get description(): string;
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string;
+    /**
+     * Markdown documentation for USE PROJECT 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 GitHub project tool function implementations.
+     */
+    getToolFunctions(): Record<string_javascript_name, ToolFunction>;
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * Names of tools used by the USE PROJECT commitment.
+ *
+ * @private constant of UseProjectCommitmentDefinition
+ */
+export declare const UseProjectToolNames: {
+    readonly listFiles: string;
+    readonly readFile: string;
+    readonly upsertFile: string;
+    readonly deleteFile: string;
+    readonly createBranch: string;
+    readonly createPullRequest: string;
+};

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

@@ -0,0 +1,9 @@
+/**
+ * Wallet metadata used by USE PROJECT when resolving GitHub credentials.
+ *
+ * @private constant of UseProjectCommitmentDefinition
+ */
+export declare const UseProjectWallet: {
+    readonly service: "github";
+    readonly key: "use-project-github-token";
+};

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

@@ -0,0 +1,69 @@
+/**
+ * Minimal shape returned by GitHub content APIs.
+ *
+ * @private type of UseProjectCommitmentDefinition
+ */
+export type UseProjectGitHubContentsItem = {
+    type: string;
+    name: string;
+    path: string;
+    sha?: string;
+    size?: number;
+    content?: string;
+    html_url?: string;
+    download_url?: string;
+};
+/**
+ * Minimal shape of GitHub branch reference API response.
+ *
+ * @private type of UseProjectCommitmentDefinition
+ */
+export type UseProjectGitHubGitRefResponse = {
+    object?: {
+        sha?: string;
+    };
+};
+/**
+ * Minimal shape of GitHub repository API response.
+ *
+ * @private type of UseProjectCommitmentDefinition
+ */
+export type UseProjectGitHubRepositoryResponse = {
+    default_branch?: string;
+};
+/**
+ * Minimal shape of GitHub pull request response.
+ *
+ * @private type of UseProjectCommitmentDefinition
+ */
+export type UseProjectGitHubPullRequestResponse = {
+    number?: number;
+    html_url?: string;
+    title?: string;
+    state?: string;
+    head?: {
+        ref?: string;
+    };
+    base?: {
+        ref?: string;
+    };
+};
+/**
+ * Options for one GitHub API call.
+ *
+ * @private type of callGitHubApi
+ */
+type CallGitHubApiOptions = {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    path: string;
+    query?: Record<string, string>;
+    body?: Record<string, unknown>;
+    allowNotFound?: boolean;
+};
+/**
+ * Runs one GitHub API request and parses JSON response payload.
+ *
+ * @private function of UseProjectCommitmentDefinition
+ */
+export declare function callGitHubApi<TResponse = unknown>(token: string, options: CallGitHubApiOptions): Promise<TResponse | null>;
+export {};

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

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

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

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

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

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