@promptbook/node 0.112.0-12 → 0.112.0-15

package/umd/apps/agents-server/src/tools/runBrowserErrorHandling.d.ts

@@ -1,60 +0,0 @@
-import type { RunBrowserExecutionMode, TaggedRunBrowserError } from './RunBrowserArgs';
-import { type RunBrowserToolError } from './runBrowserErrors';
-/**
- * Error classification and cancellation helpers used by `run_browser`.
- *
- * @private function of `run_browser`
- */
-export declare const runBrowserErrorHandling: {
-    /**
-     * Creates one tagged ParseError used for deterministic input validation failures.
-     */
-    createRunBrowserValidationError(options: {
-        readonly message: string;
-        readonly debug: Record<string, unknown>;
-    }): TaggedRunBrowserError;
-    /**
-     * Creates one tagged KnowledgeScrapeError used for navigation failures.
-     */
-    createRunBrowserNavigationError(options: {
-        readonly message: string;
-        readonly debug: Record<string, unknown>;
-        readonly cause?: unknown;
-    }): TaggedRunBrowserError;
-    /**
-     * Creates one tagged KnowledgeScrapeError used for action failures.
-     */
-    createRunBrowserActionError(options: {
-        readonly message: string;
-        readonly debug: Record<string, unknown>;
-        readonly cause?: unknown;
-    }): TaggedRunBrowserError;
-    /**
-     * Creates one tagged KnowledgeScrapeError used for cancellation.
-     */
-    createRunBrowserCancelledError(options: {
-        readonly message: string;
-        readonly debug: Record<string, unknown>;
-        readonly cause?: unknown;
-    }): TaggedRunBrowserError;
-    /**
-     * Checks whether an unknown error carries run_browser classification tags.
-     */
-    isTaggedRunBrowserError(error: unknown): error is TaggedRunBrowserError;
-    /**
-     * Converts unknown errors into structured tool error payloads.
-     */
-    classifyRunBrowserToolError(options: {
-        readonly error: unknown;
-        readonly sessionId: string;
-        readonly mode: RunBrowserExecutionMode;
-    }): RunBrowserToolError;
-    /**
-     * Asserts that the run was not aborted.
-     */
-    assertNotAborted(signal: AbortSignal | undefined, sessionId: string): void;
-    /**
-     * Returns true when the tool error represents remote browser unavailability.
-     */
-    isRemoteBrowserUnavailableCode(code: string): boolean;
-};

package/umd/apps/agents-server/src/tools/runBrowserErrors.d.ts

@@ -1,73 +0,0 @@
-import { KnowledgeScrapeError } from '../../../../src/errors/KnowledgeScrapeError';
-/**
- * Structured error payload returned by the `run_browser` tool.
- */
-export type RunBrowserToolError = {
-    readonly code: string;
-    readonly message: string;
-    readonly isRetryable: boolean;
-    readonly suggestedNextSteps: ReadonlyArray<string>;
-    readonly debug: Record<string, unknown>;
-};
-/**
- * Metadata describing the sanitized remote browser endpoint used for debugging.
- */
-export type RemoteBrowserEndpointDebug = {
-    readonly protocol: string | null;
-    readonly host: string | null;
-    readonly port: number | null;
-};
-/**
- * Structured details captured when remote browser infrastructure is unavailable.
- */
-export type RemoteBrowserUnavailableDebug = {
-    readonly endpoint: RemoteBrowserEndpointDebug;
-    readonly attempts: number;
-    readonly connectTimeoutMs: number;
-    readonly durationMs: number;
-    readonly networkErrorCode: string | null;
-    readonly originalMessage: string;
-};
-/**
- * Error code used for remote-browser infrastructure outages.
- */
-export declare const REMOTE_BROWSER_UNAVAILABLE_ERROR_CODE = "REMOTE_BROWSER_UNAVAILABLE";
-/**
- * Error thrown when a remote Playwright browser cannot be reached.
- */
-export declare class RemoteBrowserUnavailableError extends KnowledgeScrapeError {
-    readonly code = "REMOTE_BROWSER_UNAVAILABLE";
-    readonly isRetryable = true;
-    readonly suggestedNextSteps: ReadonlyArray<string>;
-    readonly debug: RemoteBrowserUnavailableDebug;
-    constructor(options: {
-        readonly message: string;
-        readonly debug: RemoteBrowserUnavailableDebug;
-        readonly suggestedNextSteps?: ReadonlyArray<string>;
-        readonly cause?: unknown;
-    });
-}
-/**
- * Returns true when an unknown value is one of the remote-browser outage errors.
- */
-export declare function isRemoteBrowserUnavailableError(error: unknown): error is RemoteBrowserUnavailableError;
-/**
- * Sanitizes a remote websocket endpoint so debug payloads never expose path secrets.
- */
-export declare function sanitizeRemoteBrowserEndpoint(wsEndpoint: string): RemoteBrowserEndpointDebug;
-/**
- * Extracts network-like error code from unknown error payload.
- */
-export declare function extractNetworkErrorCode(error: unknown): string | null;
-/**
- * Classifies whether an unknown error most likely represents remote browser infra outage.
- */
-export declare function isRemoteBrowserInfrastructureError(error: unknown): boolean;
-/**
- * Converts unknown thrown values into safe string messages.
- */
-export declare function getErrorMessage(error: unknown): string;
-/**
- * Converts unknown errors into stack payloads that are safe to render in debug mode.
- */
-export declare function getErrorStack(error: unknown): string | null;

package/umd/apps/agents-server/src/tools/runBrowserObservability.d.ts

@@ -1,36 +0,0 @@
-import type { RunBrowserModeUsed } from './RunBrowserArgs';
-/**
- * Observability counters and metric logging for `run_browser`.
- *
- * @private function of `run_browser`
- */
-export declare const runBrowserObservability: {
-    /**
-     * Increments total-run counter and returns the updated value.
-     */
-    incrementTotalRuns(): number;
-    /**
-     * Returns current total run count.
-     */
-    getTotalRuns(): number;
-    /**
-     * Increments fallback counter and returns updated metrics.
-     */
-    incrementFallbackRunsAndGetMetrics(): {
-        readonly fallbackRuns: number;
-        readonly fallbackRate: number;
-    };
-    /**
-     * Increments one error-code counter and returns the updated value.
-     */
-    incrementRunBrowserErrorCodeCounter(code: string): number;
-    /**
-     * Writes one structured metric line for browser-tool observability.
-     */
-    logRunBrowserMetric(options: {
-        readonly event: string;
-        readonly sessionId: string;
-        readonly mode: RunBrowserModeUsed;
-        readonly payload?: Record<string, unknown>;
-    }): void;
-};

package/umd/apps/agents-server/src/tools/runBrowserResultFormatting.d.ts

@@ -1,47 +0,0 @@
-import type { NormalizedRunBrowserAction, RunBrowserArtifact, RunBrowserExecutionMode, RunBrowserModeUsed, RunBrowserResultPayload } from './RunBrowserArgs';
-import type { RunBrowserToolError } from './runBrowserErrors';
-/**
- * Payload and markdown formatters for `run_browser` outcomes.
- *
- * @private function of `run_browser`
- */
-export declare const runBrowserResultFormatting: {
-    /**
-     * Produces one structured payload consumed by chat UI browser replay renderers.
-     */
-    createResultPayload(options: {
-        readonly sessionId: string;
-        readonly mode: RunBrowserExecutionMode;
-        readonly modeUsed: RunBrowserModeUsed;
-        readonly initialUrl: string;
-        readonly finalUrl: string | null;
-        readonly finalTitle: string | null;
-        readonly executedActions: ReadonlyArray<NormalizedRunBrowserAction>;
-        readonly artifacts: ReadonlyArray<RunBrowserArtifact>;
-        readonly warning: string | null;
-        readonly error: RunBrowserToolError | null;
-        readonly fallbackContent: string | null;
-        readonly timing: RunBrowserResultPayload['timing'];
-    }): RunBrowserResultPayload;
-    /**
-     * Produces a model-friendly markdown summary from browser execution artifacts.
-     */
-    formatSuccessResult(options: {
-        readonly payload: RunBrowserResultPayload;
-        readonly snapshotPath: string | null;
-    }): string;
-    /**
-     * Produces a model-friendly markdown payload when fallback scraping is used.
-     */
-    formatFallbackResult(options: {
-        readonly payload: RunBrowserResultPayload;
-        readonly fallbackContent: string;
-        readonly requestedActions: number;
-    }): string;
-    /**
-     * Produces a model-friendly markdown error payload from browser execution failures.
-     */
-    formatErrorResult(options: {
-        readonly payload: RunBrowserResultPayload;
-    }): string;
-};

package/umd/apps/agents-server/src/tools/runBrowserRuntime.d.ts

@@ -1,24 +0,0 @@
-import type { RunBrowserArgs, RunBrowserExecutionMode, RunBrowserTimeoutConfiguration } from './RunBrowserArgs';
-/**
- * Runtime helpers for mode/session/timeout handling in `run_browser`.
- *
- * @private function of `run_browser`
- */
-export declare const runBrowserRuntime: {
-    /**
-     * Creates a dedicated session id for one tool invocation.
-     */
-    createRunBrowserSessionId(): string;
-    /**
-     * Determines whether the browser tool is running in local or remote mode.
-     */
-    resolveExecutionMode(): RunBrowserExecutionMode;
-    /**
-     * Converts the execution mode into a human-readable label.
-     */
-    formatExecutionMode(mode: RunBrowserExecutionMode): string;
-    /**
-     * Resolves timeout configuration from env defaults and optional call overrides.
-     */
-    resolveTimeoutConfiguration(overrides: RunBrowserArgs['timeouts'] | undefined): RunBrowserTimeoutConfiguration;
-};

package/umd/apps/agents-server/src/tools/runBrowserWorkflow.d.ts

@@ -1,36 +0,0 @@
-import type { Page } from 'playwright';
-import type { NormalizedRunBrowserAction, OpenPageWithUrlResult, RunBrowserAction, RunBrowserTimeoutConfiguration } from './RunBrowserArgs';
-/**
- * Page open, action normalization and action execution helpers for `run_browser`.
- *
- * @private function of `run_browser`
- */
-export declare const runBrowserWorkflow: {
-    /**
-     * Opens a new browser page and navigates to the requested URL.
-     */
-    openPageWithUrl(options: {
-        readonly url: string;
-        readonly sessionId: string;
-        readonly timeouts: RunBrowserTimeoutConfiguration;
-        readonly signal?: AbortSignal;
-    }): Promise<OpenPageWithUrlResult>;
-    /**
-     * Validates and normalizes browser actions received from the model.
-     */
-    normalizeActions(actions: ReadonlyArray<RunBrowserAction> | undefined): Array<NormalizedRunBrowserAction>;
-    /**
-     * Validates and normalizes a single action.
-     */
-    normalizeAction(action: RunBrowserAction, index: number): NormalizedRunBrowserAction;
-    /**
-     * Executes one normalized browser action on a Playwright page.
-     */
-    executeAction(options: {
-        readonly page: Page;
-        readonly action: NormalizedRunBrowserAction;
-        readonly actionIndex: number;
-        readonly timeouts: RunBrowserTimeoutConfiguration;
-        readonly signal?: AbortSignal;
-    }): Promise<void>;
-};

package/umd/apps/agents-server/src/tools/run_browser.d.ts

@@ -1,11 +0,0 @@
-import type { RunBrowserInternalOptions } from './RunBrowserArgs';
-export type { RunBrowserActionType, RunBrowserAction, RunBrowserArgs } from './RunBrowserArgs';
-import type { RunBrowserArgs } from './RunBrowserArgs';
-/**
- * Runs interactive browser automation through Playwright.
- *
- * @param args Tool arguments provided by the model.
- * @param internalOptions Optional runtime options for cancellation.
- * @returns Markdown summary with structured playback payload.
- */
-export declare function run_browser(args: RunBrowserArgs, internalOptions?: RunBrowserInternalOptions): Promise<string>;

package/umd/apps/agents-server/src/utils/retryWithBackoff.d.ts

@@ -1,95 +0,0 @@
-/**
- * Callback invoked before one retry wait.
- *
- * @private utility for Agents Server runtime retries
- */
-export type RetryWithBackoffAttempt = {
-    /**
-     * Number of failed attempts completed so far (1-based).
-     */
-    readonly attempt: number;
-    /**
-     * Configured number of retries after the first attempt.
-     */
-    readonly retries: number;
-    /**
-     * Delay scheduled before the next attempt.
-     */
-    readonly delayMs: number;
-    /**
-     * Error from the attempt that just failed.
-     */
-    readonly error: unknown;
-};
-/**
- * Result metadata returned from a retry operation.
- *
- * @private utility for Agents Server runtime retries
- */
-export type RetryWithBackoffResult<TValue> = {
-    /**
-     * Value returned from the successful attempt.
-     */
-    readonly value: TValue;
-    /**
-     * Number of attempts used (first try + retries).
-     */
-    readonly attempts: number;
-    /**
-     * Total elapsed time in milliseconds across attempts and waits.
-     */
-    readonly durationMs: number;
-};
-/**
- * Configurable options for retrying one asynchronous operation with backoff.
- *
- * @private utility for Agents Server runtime retries
- */
-export type RetryWithBackoffOptions = {
-    /**
-     * Number of retries after the initial attempt.
-     */
-    readonly retries: number;
-    /**
-     * Initial backoff delay before retry #1.
-     */
-    readonly initialDelayMs: number;
-    /**
-     * Upper bound for one backoff delay.
-     */
-    readonly maxDelayMs: number;
-    /**
-     * Multiplier used for exponential growth between retry delays.
-     */
-    readonly backoffFactor: number;
-    /**
-     * Randomized extra delay ratio relative to the exponential delay.
-     */
-    readonly jitterRatio: number;
-    /**
-     * Optional cancellation signal.
-     */
-    readonly signal?: AbortSignal;
-    /**
-     * Optional predicate deciding if the thrown error can be retried.
-     */
-    readonly shouldRetry?: (error: unknown, attempt: number) => boolean;
-    /**
-     * Optional callback called before waiting for one retry.
-     */
-    readonly onRetry?: (attempt: RetryWithBackoffAttempt) => void;
-    /**
-     * Random provider used for jitter; defaults to `Math.random`.
-     */
-    readonly random?: () => number;
-    /**
-     * Sleep implementation used during backoff; defaults to an abort-aware timeout.
-     */
-    readonly sleep?: (delayMs: number, signal?: AbortSignal) => Promise<void>;
-};
-/**
- * Retries one async operation with exponential backoff and jitter.
- *
- * @private utility for Agents Server runtime retries
- */
-export declare function retryWithBackoff<TValue>(operation: (attempt: number) => Promise<TValue>, options: RetryWithBackoffOptions): Promise<RetryWithBackoffResult<TValue>>;

package/umd/apps/agents-server/src/utils/runBrowserArtifactStorage.d.ts

@@ -1,26 +0,0 @@
-/**
- * Logical public directory marker used in `run_browser` payload paths.
- *
- * This value is kept stable for UI parsing and `/api/browser-artifacts/*` URL mapping.
- */
-export declare const RUN_BROWSER_ARTIFACT_PUBLIC_DIRECTORY = ".playwright-cli";
-/**
- * Whitelist pattern for browser artifact filenames produced by `run_browser`.
- */
-export declare const RUN_BROWSER_ARTIFACT_FILENAME_PATTERN: RegExp;
-/**
- * Resolves writable filesystem directory used for artifact persistence.
- */
-export declare function resolveRunBrowserArtifactStorageDirectory(): string;
-/**
- * Resolves absolute filesystem path of one artifact filename.
- */
-export declare function resolveRunBrowserArtifactFilesystemPath(artifactFilename: string): string;
-/**
- * Resolves payload path of one artifact filename used by replay renderers.
- */
-export declare function resolveRunBrowserArtifactPublicPath(artifactFilename: string): string;
-/**
- * Validates whether one filename belongs to the supported browser artifact set.
- */
-export declare function isRunBrowserArtifactFilename(artifactFilename: string): boolean;