@lydia-agent/core 0.1.2 → 0.1.3

package/dist/index.d.cts

@@ -2390,6 +2390,37 @@ declare const ConfigSchema: z.ZodObject<{
         checkpointTtlHours?: number | undefined;
         observationFrameTtlHours?: number | undefined;
     }>>;
+    browser: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        mode: z.ZodDefault<z.ZodEnum<["auto", "cdp", "headless", "remote"]>>;
+        cdpPort: z.ZodDefault<z.ZodNumber>;
+        remoteUrl: z.ZodDefault<z.ZodString>;
+        chromePath: z.ZodDefault<z.ZodString>;
+        launchHostBrowser: z.ZodDefault<z.ZodBoolean>;
+        navigationTimeoutMs: z.ZodDefault<z.ZodNumber>;
+        actionTimeoutMs: z.ZodDefault<z.ZodNumber>;
+        downloadDir: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        mode: "auto" | "cdp" | "headless" | "remote";
+        cdpPort: number;
+        remoteUrl: string;
+        chromePath: string;
+        launchHostBrowser: boolean;
+        navigationTimeoutMs: number;
+        actionTimeoutMs: number;
+        downloadDir: string;
+    }, {
+        enabled?: boolean | undefined;
+        mode?: "auto" | "cdp" | "headless" | "remote" | undefined;
+        cdpPort?: number | undefined;
+        remoteUrl?: string | undefined;
+        chromePath?: string | undefined;
+        launchHostBrowser?: boolean | undefined;
+        navigationTimeoutMs?: number | undefined;
+        actionTimeoutMs?: number | undefined;
+        downloadDir?: string | undefined;
+    }>>;
     skills: z.ZodDefault<z.ZodObject<{
         /** Maximum number of skills whose full content is injected into the prompt (default: 3) */
         matchTopK: z.ZodDefault<z.ZodNumber>;
@@ -2407,6 +2438,17 @@ declare const ConfigSchema: z.ZodObject<{
         extraDirs?: string[] | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
+    browser: {
+        enabled: boolean;
+        mode: "auto" | "cdp" | "headless" | "remote";
+        cdpPort: number;
+        remoteUrl: string;
+        chromePath: string;
+        launchHostBrowser: boolean;
+        navigationTimeoutMs: number;
+        actionTimeoutMs: number;
+        downloadDir: string;
+    };
     llm: {
         provider: "anthropic" | "openai" | "ollama" | "mock" | "auto";
         defaultModel: string;
@@ -2467,6 +2509,17 @@ declare const ConfigSchema: z.ZodObject<{
         extraDirs: string[];
     };
 }, {
+    browser?: {
+        enabled?: boolean | undefined;
+        mode?: "auto" | "cdp" | "headless" | "remote" | undefined;
+        cdpPort?: number | undefined;
+        remoteUrl?: string | undefined;
+        chromePath?: string | undefined;
+        launchHostBrowser?: boolean | undefined;
+        navigationTimeoutMs?: number | undefined;
+        actionTimeoutMs?: number | undefined;
+        downloadDir?: string | undefined;
+    } | undefined;
     llm?: {
         provider?: "anthropic" | "openai" | "ollama" | "mock" | "auto" | undefined;
         defaultModel?: string | undefined;
@@ -2682,6 +2735,7 @@ declare class Agent extends EventEmitter {
     private currentInput?;
     private currentTaskCreatedAt?;
     private builtinServerSpecs;
+    private browserServer?;
     private options;
     private computerUseAdapter;
     private computerUseOrchestrator;
@@ -2732,6 +2786,8 @@ declare class Agent extends EventEmitter {
     private parseCheckpointFrameIds;
     private executeToolWithComputerUseOrchestration;
     private resolveCanonicalComputerUseAction;
+    private attachInternalBrowserSessionArg;
+    private closeBrowserAutomationSession;
     private inferComputerUseDomain;
     private formatComputerUseFailure;
     private toDisplayText;
@@ -2812,6 +2868,132 @@ declare class InteractionServer extends EventEmitter {
     resolve(id: string, response: string): boolean;
 }
 
+type BrowserDriverMode = 'auto' | 'cdp' | 'headless' | 'remote';
+type ResolvedBrowserDriverMode = Exclude<BrowserDriverMode, 'auto'>;
+interface BrowserRuntimeConfig {
+    enabled: boolean;
+    mode: BrowserDriverMode;
+    cdpPort: number;
+    remoteUrl: string;
+    chromePath: string;
+    launchHostBrowser: boolean;
+    navigationTimeoutMs: number;
+    actionTimeoutMs: number;
+    downloadDir: string;
+}
+interface BrowserNavigateArgs {
+    url: string;
+    waitUntil?: 'load' | 'domcontentloaded' | 'networkidle' | 'commit';
+    timeoutMs?: number;
+}
+interface BrowserClickArgs {
+    selector: string;
+    timeoutMs?: number;
+}
+interface BrowserTypeArgs {
+    selector: string;
+    text: string;
+    clearExisting?: boolean;
+    timeoutMs?: number;
+}
+interface BrowserSelectArgs {
+    selector: string;
+    value: string | string[];
+    timeoutMs?: number;
+}
+interface BrowserWaitForArgs {
+    selector: string;
+    state?: 'attached' | 'detached' | 'visible' | 'hidden';
+    timeoutMs?: number;
+}
+interface BrowserExtractTextArgs {
+    selector: string;
+    timeoutMs?: number;
+}
+interface BrowserScreenshotArgs {
+    fullPage?: boolean;
+    timeoutMs?: number;
+}
+interface BrowserDownloadArgs {
+    selector?: string;
+    url?: string;
+    saveAs?: string;
+    timeoutMs?: number;
+}
+interface BrowserUploadArgs {
+    selector: string;
+    path: string;
+    timeoutMs?: number;
+}
+interface BrowserToolResult {
+    text: string;
+    imageBase64?: string;
+    mediaType?: string;
+    artifactPath?: string;
+    downloadPath?: string;
+    metadata?: Record<string, unknown>;
+}
+interface BrowserToolRuntime {
+    navigate(sessionId: string, args: BrowserNavigateArgs): Promise<BrowserToolResult>;
+    click(sessionId: string, args: BrowserClickArgs): Promise<BrowserToolResult>;
+    type(sessionId: string, args: BrowserTypeArgs): Promise<BrowserToolResult>;
+    select(sessionId: string, args: BrowserSelectArgs): Promise<BrowserToolResult>;
+    waitFor(sessionId: string, args: BrowserWaitForArgs): Promise<BrowserToolResult>;
+    extractText(sessionId: string, args: BrowserExtractTextArgs): Promise<BrowserToolResult>;
+    screenshot(sessionId: string, args: BrowserScreenshotArgs): Promise<BrowserToolResult>;
+    download(sessionId: string, args: BrowserDownloadArgs): Promise<BrowserToolResult>;
+    upload(sessionId: string, args: BrowserUploadArgs): Promise<BrowserToolResult>;
+    closeSession(sessionId: string): Promise<BrowserToolResult>;
+    getResolvedMode(): ResolvedBrowserDriverMode | null;
+    dispose(): Promise<void>;
+}
+interface BrowserToolError extends Error {
+    code: 'BROWSER_TIMEOUT' | 'ELEMENT_NOT_FOUND' | 'ELEMENT_NOT_INTERACTABLE' | 'NAVIGATION_BLOCKED' | 'DOWNLOAD_FAILED' | 'UPLOAD_FAILED' | 'SESSION_CLOSED' | 'CAPABILITY_UNAVAILABLE' | 'UNKNOWN';
+    retryable: boolean;
+}
+declare function createBrowserToolError(code: BrowserToolError['code'], message: string, retryable?: boolean): BrowserToolError;
+declare function createDefaultBrowserRuntimeConfig(partial?: Partial<BrowserRuntimeConfig>): BrowserRuntimeConfig;
+declare class BrowserAutomationManager implements BrowserToolRuntime {
+    private readonly config;
+    private readonly sessions;
+    private browser;
+    private resolvedMode;
+    private attemptedHostLaunch;
+    constructor(config?: Partial<BrowserRuntimeConfig>);
+    getResolvedMode(): ResolvedBrowserDriverMode | null;
+    navigate(sessionId: string, args: BrowserNavigateArgs): Promise<BrowserToolResult>;
+    click(sessionId: string, args: BrowserClickArgs): Promise<BrowserToolResult>;
+    type(sessionId: string, args: BrowserTypeArgs): Promise<BrowserToolResult>;
+    select(sessionId: string, args: BrowserSelectArgs): Promise<BrowserToolResult>;
+    waitFor(sessionId: string, args: BrowserWaitForArgs): Promise<BrowserToolResult>;
+    extractText(sessionId: string, args: BrowserExtractTextArgs): Promise<BrowserToolResult>;
+    screenshot(sessionId: string, args: BrowserScreenshotArgs): Promise<BrowserToolResult>;
+    download(sessionId: string, args: BrowserDownloadArgs): Promise<BrowserToolResult>;
+    upload(sessionId: string, args: BrowserUploadArgs): Promise<BrowserToolResult>;
+    closeSession(sessionId: string): Promise<BrowserToolResult>;
+    dispose(): Promise<void>;
+    private getPage;
+    private ensureBrowser;
+    private connectCdpOrThrow;
+    private connectRemoteOrThrow;
+    private connectHeadless;
+    private isCdpReachable;
+    private launchHostChrome;
+    private resolveChromeBinary;
+    private saveDownload;
+}
+declare function normalizeBrowserRuntimeError(error: unknown): BrowserToolError;
+
+declare class BrowserServer {
+    readonly server: Server;
+    private readonly runtime;
+    constructor(config?: Partial<BrowserRuntimeConfig>, runtime?: BrowserToolRuntime);
+    closeSession(sessionId: string): Promise<void>;
+    dispose(): Promise<void>;
+    private setupHandlers;
+    private ok;
+}
+
 interface McpServerConfig {
     id: string;
     type: 'stdio' | 'in-memory';
@@ -3431,4 +3613,4 @@ declare class ComputerUseSessionOrchestrator extends EventEmitter {
     private normalizeError;
 }
 
-export { Agent, type AgentContext, type AgentOptions, AnthropicProvider, BasicStrategyGate, COMPUTER_USE_ERROR_CODES, type CanonicalComputerUseAction, type Checkpoint, type ComputerUseActionEnvelope, type ComputerUseAdapterContext, type ComputerUseAdapterResult, type ComputerUseCapabilityAdapter, type ComputerUseCheckpoint, type ComputerUseDomain, type ComputerUseError, type ComputerUseErrorCode, type ComputerUseRiskLevel, ComputerUseSessionOrchestrator, type ComputerUseSessionSummary, type ComputerUseSessionSummaryRecord, ConfigLoader, ConfigSchema, type ContentBlock, ContentBlockSchema, type CreateLLMOptions, type DispatchCanonicalActionRequest, type DispatchCanonicalActionResult, type DynamicSkill, type Episode, type EvaluationMetrics, type EvaluationResult, type EvaluationSummary, EvolutionLimitValidator, type ExecutionSummary, type Fact, FallbackProvider, FeedbackCollector, FileSystemServer, type GateResult, type GateValidator, GitServer, type ILLMProvider, type IStrategy, type ImageContent, ImageContentSchema, type Intent, IntentAnalyzer, type IntentProfile, IntentProfileSchema, IntentSchema, type InteractionRequest, InteractionServer, type LLMRequest, LLMRequestSchema, type LLMResponse, LLMResponseSchema, type LydiaConfig, McpCanonicalCapabilityAdapter, McpClientManager, type McpServerConfig, McpServerSchema, MemoryManager, type MemoryManagerOptions, MemoryServer, type Message, MessageSchema, MockProvider, type ObservationArtifactKind, type ObservationBlock, type ObservationFrame, type ObservationFrameRecord, OllamaProvider, OpenAIProvider, type ReplayDeterminismMismatch, type ReplayDeterminismResult, ReplayLLMProvider, ReplayManager, ReplayMcpClientManager, ReplayPerformanceValidator, type ReviewFinding, ReviewManager, type ReviewOptions, type ReviewRequest, type ReviewSummary, type RiskAssessment, type RiskLevel, RiskSafetyValidator, type Role, RoleSchema, type RoutedStrategy, type ShadowPromotionDecision, ShadowRouter, ShellServer, SimplePlanner, type Skill, type SkillContext, SkillLoader, type SkillMeta, SkillMetaSchema, SkillParser, SkillRegistry, SkillSchema, SkillWatcher, type StaticSkill, StaticSkillSchema, type Step, type StepResult, StepSchema, type StepStatus, StepStatusSchema, type StepType, StepTypeSchema, type Strategy, StrategyApprovalService, type StrategyBranch, StrategyBranchManager, type StrategyComparison, type StrategyConfig, StrategyConstraintsSchema, type StrategyEpisodeSummary, StrategyEvaluator, StrategyEvolutionLimitsSchema, StrategyExecutionSchema, StrategyMetadataSchema, StrategyPlanningSchema, StrategyPreferencesSchema, StrategyPromptsSchema, type StrategyProposal, StrategyRegistry, StrategyReviewer, StrategySchema, StrategySystemSchema, StrategyUpdateGate, type StreamChunk, SyntaxValidator, type Task, type TaskContext, type TaskFeedback, type TaskFeedbackRecord, type TaskReport, type TaskReportRecord, TaskReporter, TaskSchema, type TaskStatus, TaskStatusSchema, type TextContent, TextContentSchema, type ThinkingContent, ThinkingContentSchema, type TokenUsage, TokenUsageSchema, type ToolDefinition, ToolDefinitionSchema, type ToolResultContent, ToolResultContentSchema, type ToolUseContent, ToolUseContentSchema, type Trace, type UpsertComputerUseSessionSummaryInput, type ValidationResult, assessRisk, createLLMFromConfig, getSkillContent, hasContent, isCanonicalComputerUseTool, isComputerUseErrorCode, isDynamicSkill, listCanonicalComputerUseActions, normalizeComputerUseError, resolveCanonicalComputerUseToolName };
+export { Agent, type AgentContext, type AgentOptions, AnthropicProvider, BasicStrategyGate, BrowserAutomationManager, type BrowserClickArgs, type BrowserDownloadArgs, type BrowserDriverMode, type BrowserExtractTextArgs, type BrowserNavigateArgs, type BrowserRuntimeConfig, type BrowserScreenshotArgs, type BrowserSelectArgs, BrowserServer, type BrowserToolError, type BrowserToolResult, type BrowserToolRuntime, type BrowserTypeArgs, type BrowserUploadArgs, type BrowserWaitForArgs, COMPUTER_USE_ERROR_CODES, type CanonicalComputerUseAction, type Checkpoint, type ComputerUseActionEnvelope, type ComputerUseAdapterContext, type ComputerUseAdapterResult, type ComputerUseCapabilityAdapter, type ComputerUseCheckpoint, type ComputerUseDomain, type ComputerUseError, type ComputerUseErrorCode, type ComputerUseRiskLevel, ComputerUseSessionOrchestrator, type ComputerUseSessionSummary, type ComputerUseSessionSummaryRecord, ConfigLoader, ConfigSchema, type ContentBlock, ContentBlockSchema, type CreateLLMOptions, type DispatchCanonicalActionRequest, type DispatchCanonicalActionResult, type DynamicSkill, type Episode, type EvaluationMetrics, type EvaluationResult, type EvaluationSummary, EvolutionLimitValidator, type ExecutionSummary, type Fact, FallbackProvider, FeedbackCollector, FileSystemServer, type GateResult, type GateValidator, GitServer, type ILLMProvider, type IStrategy, type ImageContent, ImageContentSchema, type Intent, IntentAnalyzer, type IntentProfile, IntentProfileSchema, IntentSchema, type InteractionRequest, InteractionServer, type LLMRequest, LLMRequestSchema, type LLMResponse, LLMResponseSchema, type LydiaConfig, McpCanonicalCapabilityAdapter, McpClientManager, type McpServerConfig, McpServerSchema, MemoryManager, type MemoryManagerOptions, MemoryServer, type Message, MessageSchema, MockProvider, type ObservationArtifactKind, type ObservationBlock, type ObservationFrame, type ObservationFrameRecord, OllamaProvider, OpenAIProvider, type ReplayDeterminismMismatch, type ReplayDeterminismResult, ReplayLLMProvider, ReplayManager, ReplayMcpClientManager, ReplayPerformanceValidator, type ResolvedBrowserDriverMode, type ReviewFinding, ReviewManager, type ReviewOptions, type ReviewRequest, type ReviewSummary, type RiskAssessment, type RiskLevel, RiskSafetyValidator, type Role, RoleSchema, type RoutedStrategy, type ShadowPromotionDecision, ShadowRouter, ShellServer, SimplePlanner, type Skill, type SkillContext, SkillLoader, type SkillMeta, SkillMetaSchema, SkillParser, SkillRegistry, SkillSchema, SkillWatcher, type StaticSkill, StaticSkillSchema, type Step, type StepResult, StepSchema, type StepStatus, StepStatusSchema, type StepType, StepTypeSchema, type Strategy, StrategyApprovalService, type StrategyBranch, StrategyBranchManager, type StrategyComparison, type StrategyConfig, StrategyConstraintsSchema, type StrategyEpisodeSummary, StrategyEvaluator, StrategyEvolutionLimitsSchema, StrategyExecutionSchema, StrategyMetadataSchema, StrategyPlanningSchema, StrategyPreferencesSchema, StrategyPromptsSchema, type StrategyProposal, StrategyRegistry, StrategyReviewer, StrategySchema, StrategySystemSchema, StrategyUpdateGate, type StreamChunk, SyntaxValidator, type Task, type TaskContext, type TaskFeedback, type TaskFeedbackRecord, type TaskReport, type TaskReportRecord, TaskReporter, TaskSchema, type TaskStatus, TaskStatusSchema, type TextContent, TextContentSchema, type ThinkingContent, ThinkingContentSchema, type TokenUsage, TokenUsageSchema, type ToolDefinition, ToolDefinitionSchema, type ToolResultContent, ToolResultContentSchema, type ToolUseContent, ToolUseContentSchema, type Trace, type UpsertComputerUseSessionSummaryInput, type ValidationResult, assessRisk, createBrowserToolError, createDefaultBrowserRuntimeConfig, createLLMFromConfig, getSkillContent, hasContent, isCanonicalComputerUseTool, isComputerUseErrorCode, isDynamicSkill, listCanonicalComputerUseActions, normalizeBrowserRuntimeError, normalizeComputerUseError, resolveCanonicalComputerUseToolName };

package/dist/index.d.ts

@@ -2390,6 +2390,37 @@ declare const ConfigSchema: z.ZodObject<{
         checkpointTtlHours?: number | undefined;
         observationFrameTtlHours?: number | undefined;
     }>>;
+    browser: z.ZodDefault<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        mode: z.ZodDefault<z.ZodEnum<["auto", "cdp", "headless", "remote"]>>;
+        cdpPort: z.ZodDefault<z.ZodNumber>;
+        remoteUrl: z.ZodDefault<z.ZodString>;
+        chromePath: z.ZodDefault<z.ZodString>;
+        launchHostBrowser: z.ZodDefault<z.ZodBoolean>;
+        navigationTimeoutMs: z.ZodDefault<z.ZodNumber>;
+        actionTimeoutMs: z.ZodDefault<z.ZodNumber>;
+        downloadDir: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        mode: "auto" | "cdp" | "headless" | "remote";
+        cdpPort: number;
+        remoteUrl: string;
+        chromePath: string;
+        launchHostBrowser: boolean;
+        navigationTimeoutMs: number;
+        actionTimeoutMs: number;
+        downloadDir: string;
+    }, {
+        enabled?: boolean | undefined;
+        mode?: "auto" | "cdp" | "headless" | "remote" | undefined;
+        cdpPort?: number | undefined;
+        remoteUrl?: string | undefined;
+        chromePath?: string | undefined;
+        launchHostBrowser?: boolean | undefined;
+        navigationTimeoutMs?: number | undefined;
+        actionTimeoutMs?: number | undefined;
+        downloadDir?: string | undefined;
+    }>>;
     skills: z.ZodDefault<z.ZodObject<{
         /** Maximum number of skills whose full content is injected into the prompt (default: 3) */
         matchTopK: z.ZodDefault<z.ZodNumber>;
@@ -2407,6 +2438,17 @@ declare const ConfigSchema: z.ZodObject<{
         extraDirs?: string[] | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
+    browser: {
+        enabled: boolean;
+        mode: "auto" | "cdp" | "headless" | "remote";
+        cdpPort: number;
+        remoteUrl: string;
+        chromePath: string;
+        launchHostBrowser: boolean;
+        navigationTimeoutMs: number;
+        actionTimeoutMs: number;
+        downloadDir: string;
+    };
     llm: {
         provider: "anthropic" | "openai" | "ollama" | "mock" | "auto";
         defaultModel: string;
@@ -2467,6 +2509,17 @@ declare const ConfigSchema: z.ZodObject<{
         extraDirs: string[];
     };
 }, {
+    browser?: {
+        enabled?: boolean | undefined;
+        mode?: "auto" | "cdp" | "headless" | "remote" | undefined;
+        cdpPort?: number | undefined;
+        remoteUrl?: string | undefined;
+        chromePath?: string | undefined;
+        launchHostBrowser?: boolean | undefined;
+        navigationTimeoutMs?: number | undefined;
+        actionTimeoutMs?: number | undefined;
+        downloadDir?: string | undefined;
+    } | undefined;
     llm?: {
         provider?: "anthropic" | "openai" | "ollama" | "mock" | "auto" | undefined;
         defaultModel?: string | undefined;
@@ -2682,6 +2735,7 @@ declare class Agent extends EventEmitter {
     private currentInput?;
     private currentTaskCreatedAt?;
     private builtinServerSpecs;
+    private browserServer?;
     private options;
     private computerUseAdapter;
     private computerUseOrchestrator;
@@ -2732,6 +2786,8 @@ declare class Agent extends EventEmitter {
     private parseCheckpointFrameIds;
     private executeToolWithComputerUseOrchestration;
     private resolveCanonicalComputerUseAction;
+    private attachInternalBrowserSessionArg;
+    private closeBrowserAutomationSession;
     private inferComputerUseDomain;
     private formatComputerUseFailure;
     private toDisplayText;
@@ -2812,6 +2868,132 @@ declare class InteractionServer extends EventEmitter {
     resolve(id: string, response: string): boolean;
 }
 
+type BrowserDriverMode = 'auto' | 'cdp' | 'headless' | 'remote';
+type ResolvedBrowserDriverMode = Exclude<BrowserDriverMode, 'auto'>;
+interface BrowserRuntimeConfig {
+    enabled: boolean;
+    mode: BrowserDriverMode;
+    cdpPort: number;
+    remoteUrl: string;
+    chromePath: string;
+    launchHostBrowser: boolean;
+    navigationTimeoutMs: number;
+    actionTimeoutMs: number;
+    downloadDir: string;
+}
+interface BrowserNavigateArgs {
+    url: string;
+    waitUntil?: 'load' | 'domcontentloaded' | 'networkidle' | 'commit';
+    timeoutMs?: number;
+}
+interface BrowserClickArgs {
+    selector: string;
+    timeoutMs?: number;
+}
+interface BrowserTypeArgs {
+    selector: string;
+    text: string;
+    clearExisting?: boolean;
+    timeoutMs?: number;
+}
+interface BrowserSelectArgs {
+    selector: string;
+    value: string | string[];
+    timeoutMs?: number;
+}
+interface BrowserWaitForArgs {
+    selector: string;
+    state?: 'attached' | 'detached' | 'visible' | 'hidden';
+    timeoutMs?: number;
+}
+interface BrowserExtractTextArgs {
+    selector: string;
+    timeoutMs?: number;
+}
+interface BrowserScreenshotArgs {
+    fullPage?: boolean;
+    timeoutMs?: number;
+}
+interface BrowserDownloadArgs {
+    selector?: string;
+    url?: string;
+    saveAs?: string;
+    timeoutMs?: number;
+}
+interface BrowserUploadArgs {
+    selector: string;
+    path: string;
+    timeoutMs?: number;
+}
+interface BrowserToolResult {
+    text: string;
+    imageBase64?: string;
+    mediaType?: string;
+    artifactPath?: string;
+    downloadPath?: string;
+    metadata?: Record<string, unknown>;
+}
+interface BrowserToolRuntime {
+    navigate(sessionId: string, args: BrowserNavigateArgs): Promise<BrowserToolResult>;
+    click(sessionId: string, args: BrowserClickArgs): Promise<BrowserToolResult>;
+    type(sessionId: string, args: BrowserTypeArgs): Promise<BrowserToolResult>;
+    select(sessionId: string, args: BrowserSelectArgs): Promise<BrowserToolResult>;
+    waitFor(sessionId: string, args: BrowserWaitForArgs): Promise<BrowserToolResult>;
+    extractText(sessionId: string, args: BrowserExtractTextArgs): Promise<BrowserToolResult>;
+    screenshot(sessionId: string, args: BrowserScreenshotArgs): Promise<BrowserToolResult>;
+    download(sessionId: string, args: BrowserDownloadArgs): Promise<BrowserToolResult>;
+    upload(sessionId: string, args: BrowserUploadArgs): Promise<BrowserToolResult>;
+    closeSession(sessionId: string): Promise<BrowserToolResult>;
+    getResolvedMode(): ResolvedBrowserDriverMode | null;
+    dispose(): Promise<void>;
+}
+interface BrowserToolError extends Error {
+    code: 'BROWSER_TIMEOUT' | 'ELEMENT_NOT_FOUND' | 'ELEMENT_NOT_INTERACTABLE' | 'NAVIGATION_BLOCKED' | 'DOWNLOAD_FAILED' | 'UPLOAD_FAILED' | 'SESSION_CLOSED' | 'CAPABILITY_UNAVAILABLE' | 'UNKNOWN';
+    retryable: boolean;
+}
+declare function createBrowserToolError(code: BrowserToolError['code'], message: string, retryable?: boolean): BrowserToolError;
+declare function createDefaultBrowserRuntimeConfig(partial?: Partial<BrowserRuntimeConfig>): BrowserRuntimeConfig;
+declare class BrowserAutomationManager implements BrowserToolRuntime {
+    private readonly config;
+    private readonly sessions;
+    private browser;
+    private resolvedMode;
+    private attemptedHostLaunch;
+    constructor(config?: Partial<BrowserRuntimeConfig>);
+    getResolvedMode(): ResolvedBrowserDriverMode | null;
+    navigate(sessionId: string, args: BrowserNavigateArgs): Promise<BrowserToolResult>;
+    click(sessionId: string, args: BrowserClickArgs): Promise<BrowserToolResult>;
+    type(sessionId: string, args: BrowserTypeArgs): Promise<BrowserToolResult>;
+    select(sessionId: string, args: BrowserSelectArgs): Promise<BrowserToolResult>;
+    waitFor(sessionId: string, args: BrowserWaitForArgs): Promise<BrowserToolResult>;
+    extractText(sessionId: string, args: BrowserExtractTextArgs): Promise<BrowserToolResult>;
+    screenshot(sessionId: string, args: BrowserScreenshotArgs): Promise<BrowserToolResult>;
+    download(sessionId: string, args: BrowserDownloadArgs): Promise<BrowserToolResult>;
+    upload(sessionId: string, args: BrowserUploadArgs): Promise<BrowserToolResult>;
+    closeSession(sessionId: string): Promise<BrowserToolResult>;
+    dispose(): Promise<void>;
+    private getPage;
+    private ensureBrowser;
+    private connectCdpOrThrow;
+    private connectRemoteOrThrow;
+    private connectHeadless;
+    private isCdpReachable;
+    private launchHostChrome;
+    private resolveChromeBinary;
+    private saveDownload;
+}
+declare function normalizeBrowserRuntimeError(error: unknown): BrowserToolError;
+
+declare class BrowserServer {
+    readonly server: Server;
+    private readonly runtime;
+    constructor(config?: Partial<BrowserRuntimeConfig>, runtime?: BrowserToolRuntime);
+    closeSession(sessionId: string): Promise<void>;
+    dispose(): Promise<void>;
+    private setupHandlers;
+    private ok;
+}
+
 interface McpServerConfig {
     id: string;
     type: 'stdio' | 'in-memory';
@@ -3431,4 +3613,4 @@ declare class ComputerUseSessionOrchestrator extends EventEmitter {
     private normalizeError;
 }
 
-export { Agent, type AgentContext, type AgentOptions, AnthropicProvider, BasicStrategyGate, COMPUTER_USE_ERROR_CODES, type CanonicalComputerUseAction, type Checkpoint, type ComputerUseActionEnvelope, type ComputerUseAdapterContext, type ComputerUseAdapterResult, type ComputerUseCapabilityAdapter, type ComputerUseCheckpoint, type ComputerUseDomain, type ComputerUseError, type ComputerUseErrorCode, type ComputerUseRiskLevel, ComputerUseSessionOrchestrator, type ComputerUseSessionSummary, type ComputerUseSessionSummaryRecord, ConfigLoader, ConfigSchema, type ContentBlock, ContentBlockSchema, type CreateLLMOptions, type DispatchCanonicalActionRequest, type DispatchCanonicalActionResult, type DynamicSkill, type Episode, type EvaluationMetrics, type EvaluationResult, type EvaluationSummary, EvolutionLimitValidator, type ExecutionSummary, type Fact, FallbackProvider, FeedbackCollector, FileSystemServer, type GateResult, type GateValidator, GitServer, type ILLMProvider, type IStrategy, type ImageContent, ImageContentSchema, type Intent, IntentAnalyzer, type IntentProfile, IntentProfileSchema, IntentSchema, type InteractionRequest, InteractionServer, type LLMRequest, LLMRequestSchema, type LLMResponse, LLMResponseSchema, type LydiaConfig, McpCanonicalCapabilityAdapter, McpClientManager, type McpServerConfig, McpServerSchema, MemoryManager, type MemoryManagerOptions, MemoryServer, type Message, MessageSchema, MockProvider, type ObservationArtifactKind, type ObservationBlock, type ObservationFrame, type ObservationFrameRecord, OllamaProvider, OpenAIProvider, type ReplayDeterminismMismatch, type ReplayDeterminismResult, ReplayLLMProvider, ReplayManager, ReplayMcpClientManager, ReplayPerformanceValidator, type ReviewFinding, ReviewManager, type ReviewOptions, type ReviewRequest, type ReviewSummary, type RiskAssessment, type RiskLevel, RiskSafetyValidator, type Role, RoleSchema, type RoutedStrategy, type ShadowPromotionDecision, ShadowRouter, ShellServer, SimplePlanner, type Skill, type SkillContext, SkillLoader, type SkillMeta, SkillMetaSchema, SkillParser, SkillRegistry, SkillSchema, SkillWatcher, type StaticSkill, StaticSkillSchema, type Step, type StepResult, StepSchema, type StepStatus, StepStatusSchema, type StepType, StepTypeSchema, type Strategy, StrategyApprovalService, type StrategyBranch, StrategyBranchManager, type StrategyComparison, type StrategyConfig, StrategyConstraintsSchema, type StrategyEpisodeSummary, StrategyEvaluator, StrategyEvolutionLimitsSchema, StrategyExecutionSchema, StrategyMetadataSchema, StrategyPlanningSchema, StrategyPreferencesSchema, StrategyPromptsSchema, type StrategyProposal, StrategyRegistry, StrategyReviewer, StrategySchema, StrategySystemSchema, StrategyUpdateGate, type StreamChunk, SyntaxValidator, type Task, type TaskContext, type TaskFeedback, type TaskFeedbackRecord, type TaskReport, type TaskReportRecord, TaskReporter, TaskSchema, type TaskStatus, TaskStatusSchema, type TextContent, TextContentSchema, type ThinkingContent, ThinkingContentSchema, type TokenUsage, TokenUsageSchema, type ToolDefinition, ToolDefinitionSchema, type ToolResultContent, ToolResultContentSchema, type ToolUseContent, ToolUseContentSchema, type Trace, type UpsertComputerUseSessionSummaryInput, type ValidationResult, assessRisk, createLLMFromConfig, getSkillContent, hasContent, isCanonicalComputerUseTool, isComputerUseErrorCode, isDynamicSkill, listCanonicalComputerUseActions, normalizeComputerUseError, resolveCanonicalComputerUseToolName };
+export { Agent, type AgentContext, type AgentOptions, AnthropicProvider, BasicStrategyGate, BrowserAutomationManager, type BrowserClickArgs, type BrowserDownloadArgs, type BrowserDriverMode, type BrowserExtractTextArgs, type BrowserNavigateArgs, type BrowserRuntimeConfig, type BrowserScreenshotArgs, type BrowserSelectArgs, BrowserServer, type BrowserToolError, type BrowserToolResult, type BrowserToolRuntime, type BrowserTypeArgs, type BrowserUploadArgs, type BrowserWaitForArgs, COMPUTER_USE_ERROR_CODES, type CanonicalComputerUseAction, type Checkpoint, type ComputerUseActionEnvelope, type ComputerUseAdapterContext, type ComputerUseAdapterResult, type ComputerUseCapabilityAdapter, type ComputerUseCheckpoint, type ComputerUseDomain, type ComputerUseError, type ComputerUseErrorCode, type ComputerUseRiskLevel, ComputerUseSessionOrchestrator, type ComputerUseSessionSummary, type ComputerUseSessionSummaryRecord, ConfigLoader, ConfigSchema, type ContentBlock, ContentBlockSchema, type CreateLLMOptions, type DispatchCanonicalActionRequest, type DispatchCanonicalActionResult, type DynamicSkill, type Episode, type EvaluationMetrics, type EvaluationResult, type EvaluationSummary, EvolutionLimitValidator, type ExecutionSummary, type Fact, FallbackProvider, FeedbackCollector, FileSystemServer, type GateResult, type GateValidator, GitServer, type ILLMProvider, type IStrategy, type ImageContent, ImageContentSchema, type Intent, IntentAnalyzer, type IntentProfile, IntentProfileSchema, IntentSchema, type InteractionRequest, InteractionServer, type LLMRequest, LLMRequestSchema, type LLMResponse, LLMResponseSchema, type LydiaConfig, McpCanonicalCapabilityAdapter, McpClientManager, type McpServerConfig, McpServerSchema, MemoryManager, type MemoryManagerOptions, MemoryServer, type Message, MessageSchema, MockProvider, type ObservationArtifactKind, type ObservationBlock, type ObservationFrame, type ObservationFrameRecord, OllamaProvider, OpenAIProvider, type ReplayDeterminismMismatch, type ReplayDeterminismResult, ReplayLLMProvider, ReplayManager, ReplayMcpClientManager, ReplayPerformanceValidator, type ResolvedBrowserDriverMode, type ReviewFinding, ReviewManager, type ReviewOptions, type ReviewRequest, type ReviewSummary, type RiskAssessment, type RiskLevel, RiskSafetyValidator, type Role, RoleSchema, type RoutedStrategy, type ShadowPromotionDecision, ShadowRouter, ShellServer, SimplePlanner, type Skill, type SkillContext, SkillLoader, type SkillMeta, SkillMetaSchema, SkillParser, SkillRegistry, SkillSchema, SkillWatcher, type StaticSkill, StaticSkillSchema, type Step, type StepResult, StepSchema, type StepStatus, StepStatusSchema, type StepType, StepTypeSchema, type Strategy, StrategyApprovalService, type StrategyBranch, StrategyBranchManager, type StrategyComparison, type StrategyConfig, StrategyConstraintsSchema, type StrategyEpisodeSummary, StrategyEvaluator, StrategyEvolutionLimitsSchema, StrategyExecutionSchema, StrategyMetadataSchema, StrategyPlanningSchema, StrategyPreferencesSchema, StrategyPromptsSchema, type StrategyProposal, StrategyRegistry, StrategyReviewer, StrategySchema, StrategySystemSchema, StrategyUpdateGate, type StreamChunk, SyntaxValidator, type Task, type TaskContext, type TaskFeedback, type TaskFeedbackRecord, type TaskReport, type TaskReportRecord, TaskReporter, TaskSchema, type TaskStatus, TaskStatusSchema, type TextContent, TextContentSchema, type ThinkingContent, ThinkingContentSchema, type TokenUsage, TokenUsageSchema, type ToolDefinition, ToolDefinitionSchema, type ToolResultContent, ToolResultContentSchema, type ToolUseContent, ToolUseContentSchema, type Trace, type UpsertComputerUseSessionSummaryInput, type ValidationResult, assessRisk, createBrowserToolError, createDefaultBrowserRuntimeConfig, createLLMFromConfig, getSkillContent, hasContent, isCanonicalComputerUseTool, isComputerUseErrorCode, isDynamicSkill, listCanonicalComputerUseActions, normalizeBrowserRuntimeError, normalizeComputerUseError, resolveCanonicalComputerUseToolName };