@evolvingmachines/sdk 0.0.34 → 0.0.37

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -380,7 +380,23 @@ type WorkspaceMode = "knowledge" | "swe";
380
380
  /** Available skills that can be enabled */
381
381
  type SkillName = "pdf" | "dev-browser" | (string & {});
382
382
  /** Browser automation providers that can be enabled explicitly */
383
- type BrowserProvider = "browser-use";
383
+ type BrowserProvider = "browser-use" | "actionbook" | "agent-browser";
384
+ /** Browser providers backed by Evolve-managed browser transport. */
385
+ type ManagedBrowserProvider = "actionbook" | "agent-browser";
386
+ /** Actionbook browser configuration. */
387
+ interface ActionbookBrowserConfig {
388
+ provider: "actionbook";
389
+ /** Use Evolve-managed remote browser transport. Defaults to false for object config. */
390
+ remote?: boolean;
391
+ }
392
+ /** Agent-browser browser configuration. */
393
+ interface AgentBrowserConfig {
394
+ provider: "agent-browser";
395
+ /** Use Evolve-managed remote browser transport. Defaults to false for object config. */
396
+ remote?: boolean;
397
+ }
398
+ /** Browser automation configuration. */
399
+ type BrowserConfig = BrowserProvider | ActionbookBrowserConfig | AgentBrowserConfig;
384
400
  /** Marketplace plugin shape for CLIs with explicit plugin install commands. */
385
401
  interface MarketplaceAgentPluginConfig {
386
402
  /** Marketplace URL/source to register in the sandbox user profile */
@@ -529,6 +545,14 @@ interface AgentOptions {
529
545
  files?: FileMap;
530
546
  /** MCP server configurations */
531
547
  mcpServers?: Record<string, McpServerConfig>;
548
+ /** Runtime browser prompt fragment appended to the agent system prompt */
549
+ browserPrompt?: string;
550
+ /** Evolve-managed browser transport for browser automation */
551
+ managedBrowser?: {
552
+ provider: ManagedBrowserProvider;
553
+ apiKey: string;
554
+ dashboardUrl?: string;
555
+ };
532
556
  /** Plugins/extensions to install in the sandbox user profile before first run */
533
557
  plugins?: AgentPluginConfig[];
534
558
  /** Skills to enable (e.g., ["pdf", "dev-browser"]) */
@@ -593,7 +617,11 @@ type SandboxLifecycleState = "booting" | "error" | "ready" | "running" | "paused
593
617
  /** High-level agent runtime state */
594
618
  type AgentRuntimeState = "idle" | "running" | "interrupted" | "error";
595
619
  /** Lifecycle transition reason */
596
- type LifecycleReason = "sandbox_boot" | "sandbox_connected" | "sandbox_ready" | "sandbox_pause" | "sandbox_resume" | "sandbox_killed" | "sandbox_error" | "run_start" | "run_complete" | "run_interrupted" | "run_failed" | "run_background_complete" | "run_background_failed" | "command_start" | "command_complete" | "command_interrupted" | "command_failed" | "command_background_complete" | "command_background_failed";
620
+ type LifecycleReason = "browser_ready" | "sandbox_boot" | "sandbox_connected" | "sandbox_ready" | "sandbox_pause" | "sandbox_resume" | "sandbox_killed" | "sandbox_error" | "run_start" | "run_complete" | "run_interrupted" | "run_failed" | "run_background_complete" | "run_background_failed" | "command_start" | "command_complete" | "command_interrupted" | "command_failed" | "command_background_complete" | "command_background_failed";
621
+ /** Browser runtime info exposed to host applications. */
622
+ interface BrowserRuntimeInfo {
623
+ liveUrl: string;
624
+ }
597
625
  /** Lifecycle event emitted by the runtime */
598
626
  interface LifecycleEvent {
599
627
  sandboxId: string | null;
@@ -601,6 +629,7 @@ interface LifecycleEvent {
601
629
  agent: AgentRuntimeState;
602
630
  timestamp: string;
603
631
  reason: LifecycleReason;
632
+ browser?: BrowserRuntimeInfo;
604
633
  }
605
634
  /** Snapshot of current runtime status */
606
635
  interface SessionStatus {
@@ -610,6 +639,7 @@ interface SessionStatus {
610
639
  activeProcessId: string | null;
611
640
  hasRun: boolean;
612
641
  timestamp: string;
642
+ browser?: BrowserRuntimeInfo;
613
643
  }
614
644
  /** Response from run() and executeCommand() */
615
645
  interface AgentResponse {
@@ -976,6 +1006,7 @@ declare class Agent {
976
1006
  private sandboxState;
977
1007
  private agentState;
978
1008
  private droidSessionId?;
1009
+ private managedBrowserSession?;
979
1010
  private readonly skills?;
980
1011
  private readonly storage?;
981
1012
  private lastCheckpointId?;
@@ -984,6 +1015,7 @@ declare class Agent {
984
1015
  private readonly schemaOptions?;
985
1016
  private readonly compiledValidator?;
986
1017
  constructor(agentConfig: ResolvedAgentConfig, options?: AgentOptions);
1018
+ private browserRuntimeInfo;
987
1019
  private emitLifecycle;
988
1020
  private invalidateActiveOperation;
989
1021
  private beginOperation;
@@ -1001,6 +1033,9 @@ declare class Agent {
1001
1033
  * Build environment variables for sandbox
1002
1034
  */
1003
1035
  private buildEnvironmentVariables;
1036
+ private ensureManagedBrowserSession;
1037
+ private setupManagedBrowser;
1038
+ private closeManagedBrowserSession;
1004
1039
  /**
1005
1040
  * Build the inline gateway config JSON for agents using gatewayConfigEnv
1006
1041
  * (e.g., OpenCode OPENCODE_CONFIG_CONTENT). Centralizes the provider config
@@ -1375,7 +1410,7 @@ interface EvolveConfig {
1375
1410
  files?: FileMap;
1376
1411
  mcpServers?: Record<string, McpServerConfig>;
1377
1412
  /** Browser automation provider to enable explicitly */
1378
- browser?: BrowserProvider;
1413
+ browser?: BrowserConfig;
1379
1414
  /** Agent plugins/extensions to install before first run */
1380
1415
  plugins?: AgentPluginConfig[];
1381
1416
  /** Skills to enable (e.g., ["pdf", "dev-browser"]) */
@@ -1462,16 +1497,20 @@ declare class Evolve extends EventEmitter {
1462
1497
  /**
1463
1498
  * Enable browser automation.
1464
1499
  *
1465
- * Gateway mode supports "browser-use", exposed as the same MCP server that
1466
- * was previously included automatically.
1500
+ * .withBrowser() defaults to Actionbook with Evolve-managed remote browser
1501
+ * transport in gateway mode. Pass "actionbook" or "agent-browser" for local
1502
+ * skills-only mode, or "browser-use" to use the browser-use MCP server.
1503
+ *
1504
+ * @example
1505
+ * kit.withBrowser("browser-use") // browser-use MCP provider
1467
1506
  *
1468
1507
  * @example
1469
- * kit.withBrowser("browser-use") // explicit provider
1508
+ * kit.withBrowser() // defaults to remote managed Actionbook
1470
1509
  *
1471
1510
  * @example
1472
- * kit.withBrowser() // defaults to "browser-use"
1511
+ * kit.withBrowser({ provider: "agent-browser", remote: true }) // managed remote agent-browser
1473
1512
  */
1474
- withBrowser(provider?: BrowserProvider | false): this;
1513
+ withBrowser(provider?: BrowserConfig | false): this;
1475
1514
  /**
1476
1515
  * Install agent plugins/extensions in the sandbox user profile.
1477
1516
  *
@@ -2641,8 +2680,8 @@ interface AgentRegistryEntry {
2641
2680
  buildCommand: (opts: BuildCommandOptions) => string;
2642
2681
  /** Extra setup step (e.g., codex login) */
2643
2682
  setupCommand?: string;
2644
- /** Whether this agent uses passthrough gateway (Gemini) */
2645
- usePassthroughGateway?: boolean;
2683
+ /** Gateway path prefix for CLIs that use a provider-native passthrough endpoint */
2684
+ gatewayPath?: string;
2646
2685
  /** Default base URL for direct mode (only needed if provider requires specific endpoint, e.g., Qwen → Dashscope) */
2647
2686
  defaultBaseUrl?: string;
2648
2687
  /** Available beta headers for this agent (for reference) */
@@ -2862,6 +2901,10 @@ declare const SYSTEM_PROMPT: string;
2862
2901
  * - {{schema}} - JSON schema for the expected output
2863
2902
  */
2864
2903
  declare const SCHEMA_PROMPT: string;
2904
+ /**
2905
+ * Actionbook browser automation prompt fragment
2906
+ */
2907
+ declare const BROWSER_ACTIONBOOK_PROMPT: string;
2865
2908
  /**
2866
2909
  * Judge system prompt template (for Swarm best_of)
2867
2910
  *
@@ -2903,6 +2946,7 @@ declare function applyTemplate(template: string, variables: Record<string, strin
2903
2946
  declare function buildWorkerSystemPrompt(options: {
2904
2947
  workingDir: string;
2905
2948
  systemPrompt?: string;
2949
+ browserPrompt?: string;
2906
2950
  schema?: z.ZodType<unknown> | Record<string, unknown>;
2907
2951
  mode?: "knowledge" | "swe";
2908
2952
  }): string;
@@ -3069,4 +3113,4 @@ interface SessionsClient {
3069
3113
  */
3070
3114
  declare function sessions(config?: SessionsConfig): SessionsClient;
3071
3115
 
3072
- export { AGENT_REGISTRY, AGENT_TYPES, Agent, type AgentConfig, type AgentOptions, type AgentOverride, type AgentParser, type AgentPluginConfig, type AgentRegistryEntry, type AgentResponse, type AgentRuntimeState, type AgentType, type BaseMeta, type BestOfConfig, type BestOfParams, type BestOfResult, type BrowserProvider, type CandidateCompleteEvent, type CheckpointInfo, type CodexAgentPluginConfig, type ComposioAuthResult, type ComposioConfig, type ComposioConnectionStatus, type ComposioSetup, type DownloadCheckpointOptions, type DownloadFilesOptions, type DownloadSessionOptions, type EmitOption, type EventHandler, type EventName, Evolve, type EvolveConfig, type EvolveEvents, type ExecuteCommandOptions, type FileMap, type FilterConfig, type FilterParams, type GeminiAgentPluginConfig, type GetEventsOptions, type IndexedMeta, type ItemInput, type ItemRetryEvent, JUDGE_PROMPT, type JsonSchema, type JudgeCompleteEvent, type JudgeDecision, type JudgeMeta, type LifecycleEvent, type LifecycleReason, type ListSessionsOptions, type MapConfig, type MapParams, type MarketplaceAgentPluginConfig, type McpConfigInfo, type McpServerConfig, type ModelInfo, type OnCandidateCompleteCallback, type OnItemRetryCallback, type OnJudgeCompleteCallback, type OnVerifierCompleteCallback, type OnWorkerCompleteCallback, type OperationType, type OutputEvent, type OutputResult, Pipeline, type PipelineContext, type PipelineEventMap, type PipelineEvents, type PipelineResult, type ProcessInfo, type Prompt, type PromptFn, RETRY_FEEDBACK_PROMPT, type ReasoningEffort, type ReduceConfig, type ReduceMeta, type ReduceParams, type ReduceResult, type ResolvedStorageConfig, type RetryConfig, type RunCost, type RunOptions, SCHEMA_PROMPT, SWARM_RESULT_BRAND, SYSTEM_PROMPT, type SandboxCommandHandle, type SandboxCommandResult, type SandboxCommands, type SandboxCreateOptions, type SandboxFiles, type SandboxInstance, type SandboxLifecycleState, type SandboxProvider, type SandboxRunOptions, type SandboxSpawnOptions, type SchemaValidationOptions, Semaphore, type SessionCost, type SessionEvent, type SessionInfo, type SessionPage, type SessionStatus, type SessionsClient, type SessionsConfig, type SkillName, type SkillsConfig, type StepCompleteEvent, type StepErrorEvent, type StepEvent, type StepResult, type StepStartEvent, type StorageClient, type StorageConfig, type StreamCallbacks, Swarm, type SwarmConfig, type SwarmResult, SwarmResultList, TerminalPipeline, type ToolsFilter, VALIDATION_PRESETS, VERIFY_PROMPT, type ValidationMode, type VerifierCompleteEvent, type VerifyConfig, type VerifyDecision, type VerifyInfo, type VerifyMeta, WORKSPACE_PROMPT, WORKSPACE_SWE_PROMPT, type WorkerCompleteEvent, type WorkspaceMode, applyTemplate, buildWorkerSystemPrompt, createAgentParser, createClaudeParser, createCodexParser, createDroidParser, createGeminiParser, executeWithRetry, expandPath, getAgentConfig, getMcpSettingsDir, getMcpSettingsPath, isValidAgentType, isZodSchema, jsonSchemaToString, parseNdjsonLine, parseNdjsonOutput, parseQwenOutput, readLocalDir, resolveStorageConfig, saveLocalDir, sessions, storage, writeClaudeMcpConfig, writeCodexMcpConfig, writeDroidGatewaySettings, writeDroidMcpConfig, writeGeminiMcpConfig, writeMcpConfig, writeQwenMcpConfig, zodSchemaToJson };
3116
+ export { AGENT_REGISTRY, AGENT_TYPES, type ActionbookBrowserConfig, Agent, type AgentBrowserConfig, type AgentConfig, type AgentOptions, type AgentOverride, type AgentParser, type AgentPluginConfig, type AgentRegistryEntry, type AgentResponse, type AgentRuntimeState, type AgentType, BROWSER_ACTIONBOOK_PROMPT, type BaseMeta, type BestOfConfig, type BestOfParams, type BestOfResult, type BrowserConfig, type BrowserProvider, type BrowserRuntimeInfo, type CandidateCompleteEvent, type CheckpointInfo, type CodexAgentPluginConfig, type ComposioAuthResult, type ComposioConfig, type ComposioConnectionStatus, type ComposioSetup, type DownloadCheckpointOptions, type DownloadFilesOptions, type DownloadSessionOptions, type EmitOption, type EventHandler, type EventName, Evolve, type EvolveConfig, type EvolveEvents, type ExecuteCommandOptions, type FileMap, type FilterConfig, type FilterParams, type GeminiAgentPluginConfig, type GetEventsOptions, type IndexedMeta, type ItemInput, type ItemRetryEvent, JUDGE_PROMPT, type JsonSchema, type JudgeCompleteEvent, type JudgeDecision, type JudgeMeta, type LifecycleEvent, type LifecycleReason, type ListSessionsOptions, type ManagedBrowserProvider, type MapConfig, type MapParams, type MarketplaceAgentPluginConfig, type McpConfigInfo, type McpServerConfig, type ModelInfo, type OnCandidateCompleteCallback, type OnItemRetryCallback, type OnJudgeCompleteCallback, type OnVerifierCompleteCallback, type OnWorkerCompleteCallback, type OperationType, type OutputEvent, type OutputResult, Pipeline, type PipelineContext, type PipelineEventMap, type PipelineEvents, type PipelineResult, type ProcessInfo, type Prompt, type PromptFn, RETRY_FEEDBACK_PROMPT, type ReasoningEffort, type ReduceConfig, type ReduceMeta, type ReduceParams, type ReduceResult, type ResolvedStorageConfig, type RetryConfig, type RunCost, type RunOptions, SCHEMA_PROMPT, SWARM_RESULT_BRAND, SYSTEM_PROMPT, type SandboxCommandHandle, type SandboxCommandResult, type SandboxCommands, type SandboxCreateOptions, type SandboxFiles, type SandboxInstance, type SandboxLifecycleState, type SandboxProvider, type SandboxRunOptions, type SandboxSpawnOptions, type SchemaValidationOptions, Semaphore, type SessionCost, type SessionEvent, type SessionInfo, type SessionPage, type SessionStatus, type SessionsClient, type SessionsConfig, type SkillName, type SkillsConfig, type StepCompleteEvent, type StepErrorEvent, type StepEvent, type StepResult, type StepStartEvent, type StorageClient, type StorageConfig, type StreamCallbacks, Swarm, type SwarmConfig, type SwarmResult, SwarmResultList, TerminalPipeline, type ToolsFilter, VALIDATION_PRESETS, VERIFY_PROMPT, type ValidationMode, type VerifierCompleteEvent, type VerifyConfig, type VerifyDecision, type VerifyInfo, type VerifyMeta, WORKSPACE_PROMPT, WORKSPACE_SWE_PROMPT, type WorkerCompleteEvent, type WorkspaceMode, applyTemplate, buildWorkerSystemPrompt, createAgentParser, createClaudeParser, createCodexParser, createDroidParser, createGeminiParser, executeWithRetry, expandPath, getAgentConfig, getMcpSettingsDir, getMcpSettingsPath, isValidAgentType, isZodSchema, jsonSchemaToString, parseNdjsonLine, parseNdjsonOutput, parseQwenOutput, readLocalDir, resolveStorageConfig, saveLocalDir, sessions, storage, writeClaudeMcpConfig, writeCodexMcpConfig, writeDroidGatewaySettings, writeDroidMcpConfig, writeGeminiMcpConfig, writeMcpConfig, writeQwenMcpConfig, zodSchemaToJson };
package/dist/index.d.ts CHANGED
@@ -380,7 +380,23 @@ type WorkspaceMode = "knowledge" | "swe";
380
380
  /** Available skills that can be enabled */
381
381
  type SkillName = "pdf" | "dev-browser" | (string & {});
382
382
  /** Browser automation providers that can be enabled explicitly */
383
- type BrowserProvider = "browser-use";
383
+ type BrowserProvider = "browser-use" | "actionbook" | "agent-browser";
384
+ /** Browser providers backed by Evolve-managed browser transport. */
385
+ type ManagedBrowserProvider = "actionbook" | "agent-browser";
386
+ /** Actionbook browser configuration. */
387
+ interface ActionbookBrowserConfig {
388
+ provider: "actionbook";
389
+ /** Use Evolve-managed remote browser transport. Defaults to false for object config. */
390
+ remote?: boolean;
391
+ }
392
+ /** Agent-browser browser configuration. */
393
+ interface AgentBrowserConfig {
394
+ provider: "agent-browser";
395
+ /** Use Evolve-managed remote browser transport. Defaults to false for object config. */
396
+ remote?: boolean;
397
+ }
398
+ /** Browser automation configuration. */
399
+ type BrowserConfig = BrowserProvider | ActionbookBrowserConfig | AgentBrowserConfig;
384
400
  /** Marketplace plugin shape for CLIs with explicit plugin install commands. */
385
401
  interface MarketplaceAgentPluginConfig {
386
402
  /** Marketplace URL/source to register in the sandbox user profile */
@@ -529,6 +545,14 @@ interface AgentOptions {
529
545
  files?: FileMap;
530
546
  /** MCP server configurations */
531
547
  mcpServers?: Record<string, McpServerConfig>;
548
+ /** Runtime browser prompt fragment appended to the agent system prompt */
549
+ browserPrompt?: string;
550
+ /** Evolve-managed browser transport for browser automation */
551
+ managedBrowser?: {
552
+ provider: ManagedBrowserProvider;
553
+ apiKey: string;
554
+ dashboardUrl?: string;
555
+ };
532
556
  /** Plugins/extensions to install in the sandbox user profile before first run */
533
557
  plugins?: AgentPluginConfig[];
534
558
  /** Skills to enable (e.g., ["pdf", "dev-browser"]) */
@@ -593,7 +617,11 @@ type SandboxLifecycleState = "booting" | "error" | "ready" | "running" | "paused
593
617
  /** High-level agent runtime state */
594
618
  type AgentRuntimeState = "idle" | "running" | "interrupted" | "error";
595
619
  /** Lifecycle transition reason */
596
- type LifecycleReason = "sandbox_boot" | "sandbox_connected" | "sandbox_ready" | "sandbox_pause" | "sandbox_resume" | "sandbox_killed" | "sandbox_error" | "run_start" | "run_complete" | "run_interrupted" | "run_failed" | "run_background_complete" | "run_background_failed" | "command_start" | "command_complete" | "command_interrupted" | "command_failed" | "command_background_complete" | "command_background_failed";
620
+ type LifecycleReason = "browser_ready" | "sandbox_boot" | "sandbox_connected" | "sandbox_ready" | "sandbox_pause" | "sandbox_resume" | "sandbox_killed" | "sandbox_error" | "run_start" | "run_complete" | "run_interrupted" | "run_failed" | "run_background_complete" | "run_background_failed" | "command_start" | "command_complete" | "command_interrupted" | "command_failed" | "command_background_complete" | "command_background_failed";
621
+ /** Browser runtime info exposed to host applications. */
622
+ interface BrowserRuntimeInfo {
623
+ liveUrl: string;
624
+ }
597
625
  /** Lifecycle event emitted by the runtime */
598
626
  interface LifecycleEvent {
599
627
  sandboxId: string | null;
@@ -601,6 +629,7 @@ interface LifecycleEvent {
601
629
  agent: AgentRuntimeState;
602
630
  timestamp: string;
603
631
  reason: LifecycleReason;
632
+ browser?: BrowserRuntimeInfo;
604
633
  }
605
634
  /** Snapshot of current runtime status */
606
635
  interface SessionStatus {
@@ -610,6 +639,7 @@ interface SessionStatus {
610
639
  activeProcessId: string | null;
611
640
  hasRun: boolean;
612
641
  timestamp: string;
642
+ browser?: BrowserRuntimeInfo;
613
643
  }
614
644
  /** Response from run() and executeCommand() */
615
645
  interface AgentResponse {
@@ -976,6 +1006,7 @@ declare class Agent {
976
1006
  private sandboxState;
977
1007
  private agentState;
978
1008
  private droidSessionId?;
1009
+ private managedBrowserSession?;
979
1010
  private readonly skills?;
980
1011
  private readonly storage?;
981
1012
  private lastCheckpointId?;
@@ -984,6 +1015,7 @@ declare class Agent {
984
1015
  private readonly schemaOptions?;
985
1016
  private readonly compiledValidator?;
986
1017
  constructor(agentConfig: ResolvedAgentConfig, options?: AgentOptions);
1018
+ private browserRuntimeInfo;
987
1019
  private emitLifecycle;
988
1020
  private invalidateActiveOperation;
989
1021
  private beginOperation;
@@ -1001,6 +1033,9 @@ declare class Agent {
1001
1033
  * Build environment variables for sandbox
1002
1034
  */
1003
1035
  private buildEnvironmentVariables;
1036
+ private ensureManagedBrowserSession;
1037
+ private setupManagedBrowser;
1038
+ private closeManagedBrowserSession;
1004
1039
  /**
1005
1040
  * Build the inline gateway config JSON for agents using gatewayConfigEnv
1006
1041
  * (e.g., OpenCode OPENCODE_CONFIG_CONTENT). Centralizes the provider config
@@ -1375,7 +1410,7 @@ interface EvolveConfig {
1375
1410
  files?: FileMap;
1376
1411
  mcpServers?: Record<string, McpServerConfig>;
1377
1412
  /** Browser automation provider to enable explicitly */
1378
- browser?: BrowserProvider;
1413
+ browser?: BrowserConfig;
1379
1414
  /** Agent plugins/extensions to install before first run */
1380
1415
  plugins?: AgentPluginConfig[];
1381
1416
  /** Skills to enable (e.g., ["pdf", "dev-browser"]) */
@@ -1462,16 +1497,20 @@ declare class Evolve extends EventEmitter {
1462
1497
  /**
1463
1498
  * Enable browser automation.
1464
1499
  *
1465
- * Gateway mode supports "browser-use", exposed as the same MCP server that
1466
- * was previously included automatically.
1500
+ * .withBrowser() defaults to Actionbook with Evolve-managed remote browser
1501
+ * transport in gateway mode. Pass "actionbook" or "agent-browser" for local
1502
+ * skills-only mode, or "browser-use" to use the browser-use MCP server.
1503
+ *
1504
+ * @example
1505
+ * kit.withBrowser("browser-use") // browser-use MCP provider
1467
1506
  *
1468
1507
  * @example
1469
- * kit.withBrowser("browser-use") // explicit provider
1508
+ * kit.withBrowser() // defaults to remote managed Actionbook
1470
1509
  *
1471
1510
  * @example
1472
- * kit.withBrowser() // defaults to "browser-use"
1511
+ * kit.withBrowser({ provider: "agent-browser", remote: true }) // managed remote agent-browser
1473
1512
  */
1474
- withBrowser(provider?: BrowserProvider | false): this;
1513
+ withBrowser(provider?: BrowserConfig | false): this;
1475
1514
  /**
1476
1515
  * Install agent plugins/extensions in the sandbox user profile.
1477
1516
  *
@@ -2641,8 +2680,8 @@ interface AgentRegistryEntry {
2641
2680
  buildCommand: (opts: BuildCommandOptions) => string;
2642
2681
  /** Extra setup step (e.g., codex login) */
2643
2682
  setupCommand?: string;
2644
- /** Whether this agent uses passthrough gateway (Gemini) */
2645
- usePassthroughGateway?: boolean;
2683
+ /** Gateway path prefix for CLIs that use a provider-native passthrough endpoint */
2684
+ gatewayPath?: string;
2646
2685
  /** Default base URL for direct mode (only needed if provider requires specific endpoint, e.g., Qwen → Dashscope) */
2647
2686
  defaultBaseUrl?: string;
2648
2687
  /** Available beta headers for this agent (for reference) */
@@ -2862,6 +2901,10 @@ declare const SYSTEM_PROMPT: string;
2862
2901
  * - {{schema}} - JSON schema for the expected output
2863
2902
  */
2864
2903
  declare const SCHEMA_PROMPT: string;
2904
+ /**
2905
+ * Actionbook browser automation prompt fragment
2906
+ */
2907
+ declare const BROWSER_ACTIONBOOK_PROMPT: string;
2865
2908
  /**
2866
2909
  * Judge system prompt template (for Swarm best_of)
2867
2910
  *
@@ -2903,6 +2946,7 @@ declare function applyTemplate(template: string, variables: Record<string, strin
2903
2946
  declare function buildWorkerSystemPrompt(options: {
2904
2947
  workingDir: string;
2905
2948
  systemPrompt?: string;
2949
+ browserPrompt?: string;
2906
2950
  schema?: z.ZodType<unknown> | Record<string, unknown>;
2907
2951
  mode?: "knowledge" | "swe";
2908
2952
  }): string;
@@ -3069,4 +3113,4 @@ interface SessionsClient {
3069
3113
  */
3070
3114
  declare function sessions(config?: SessionsConfig): SessionsClient;
3071
3115
 
3072
- export { AGENT_REGISTRY, AGENT_TYPES, Agent, type AgentConfig, type AgentOptions, type AgentOverride, type AgentParser, type AgentPluginConfig, type AgentRegistryEntry, type AgentResponse, type AgentRuntimeState, type AgentType, type BaseMeta, type BestOfConfig, type BestOfParams, type BestOfResult, type BrowserProvider, type CandidateCompleteEvent, type CheckpointInfo, type CodexAgentPluginConfig, type ComposioAuthResult, type ComposioConfig, type ComposioConnectionStatus, type ComposioSetup, type DownloadCheckpointOptions, type DownloadFilesOptions, type DownloadSessionOptions, type EmitOption, type EventHandler, type EventName, Evolve, type EvolveConfig, type EvolveEvents, type ExecuteCommandOptions, type FileMap, type FilterConfig, type FilterParams, type GeminiAgentPluginConfig, type GetEventsOptions, type IndexedMeta, type ItemInput, type ItemRetryEvent, JUDGE_PROMPT, type JsonSchema, type JudgeCompleteEvent, type JudgeDecision, type JudgeMeta, type LifecycleEvent, type LifecycleReason, type ListSessionsOptions, type MapConfig, type MapParams, type MarketplaceAgentPluginConfig, type McpConfigInfo, type McpServerConfig, type ModelInfo, type OnCandidateCompleteCallback, type OnItemRetryCallback, type OnJudgeCompleteCallback, type OnVerifierCompleteCallback, type OnWorkerCompleteCallback, type OperationType, type OutputEvent, type OutputResult, Pipeline, type PipelineContext, type PipelineEventMap, type PipelineEvents, type PipelineResult, type ProcessInfo, type Prompt, type PromptFn, RETRY_FEEDBACK_PROMPT, type ReasoningEffort, type ReduceConfig, type ReduceMeta, type ReduceParams, type ReduceResult, type ResolvedStorageConfig, type RetryConfig, type RunCost, type RunOptions, SCHEMA_PROMPT, SWARM_RESULT_BRAND, SYSTEM_PROMPT, type SandboxCommandHandle, type SandboxCommandResult, type SandboxCommands, type SandboxCreateOptions, type SandboxFiles, type SandboxInstance, type SandboxLifecycleState, type SandboxProvider, type SandboxRunOptions, type SandboxSpawnOptions, type SchemaValidationOptions, Semaphore, type SessionCost, type SessionEvent, type SessionInfo, type SessionPage, type SessionStatus, type SessionsClient, type SessionsConfig, type SkillName, type SkillsConfig, type StepCompleteEvent, type StepErrorEvent, type StepEvent, type StepResult, type StepStartEvent, type StorageClient, type StorageConfig, type StreamCallbacks, Swarm, type SwarmConfig, type SwarmResult, SwarmResultList, TerminalPipeline, type ToolsFilter, VALIDATION_PRESETS, VERIFY_PROMPT, type ValidationMode, type VerifierCompleteEvent, type VerifyConfig, type VerifyDecision, type VerifyInfo, type VerifyMeta, WORKSPACE_PROMPT, WORKSPACE_SWE_PROMPT, type WorkerCompleteEvent, type WorkspaceMode, applyTemplate, buildWorkerSystemPrompt, createAgentParser, createClaudeParser, createCodexParser, createDroidParser, createGeminiParser, executeWithRetry, expandPath, getAgentConfig, getMcpSettingsDir, getMcpSettingsPath, isValidAgentType, isZodSchema, jsonSchemaToString, parseNdjsonLine, parseNdjsonOutput, parseQwenOutput, readLocalDir, resolveStorageConfig, saveLocalDir, sessions, storage, writeClaudeMcpConfig, writeCodexMcpConfig, writeDroidGatewaySettings, writeDroidMcpConfig, writeGeminiMcpConfig, writeMcpConfig, writeQwenMcpConfig, zodSchemaToJson };
3116
+ export { AGENT_REGISTRY, AGENT_TYPES, type ActionbookBrowserConfig, Agent, type AgentBrowserConfig, type AgentConfig, type AgentOptions, type AgentOverride, type AgentParser, type AgentPluginConfig, type AgentRegistryEntry, type AgentResponse, type AgentRuntimeState, type AgentType, BROWSER_ACTIONBOOK_PROMPT, type BaseMeta, type BestOfConfig, type BestOfParams, type BestOfResult, type BrowserConfig, type BrowserProvider, type BrowserRuntimeInfo, type CandidateCompleteEvent, type CheckpointInfo, type CodexAgentPluginConfig, type ComposioAuthResult, type ComposioConfig, type ComposioConnectionStatus, type ComposioSetup, type DownloadCheckpointOptions, type DownloadFilesOptions, type DownloadSessionOptions, type EmitOption, type EventHandler, type EventName, Evolve, type EvolveConfig, type EvolveEvents, type ExecuteCommandOptions, type FileMap, type FilterConfig, type FilterParams, type GeminiAgentPluginConfig, type GetEventsOptions, type IndexedMeta, type ItemInput, type ItemRetryEvent, JUDGE_PROMPT, type JsonSchema, type JudgeCompleteEvent, type JudgeDecision, type JudgeMeta, type LifecycleEvent, type LifecycleReason, type ListSessionsOptions, type ManagedBrowserProvider, type MapConfig, type MapParams, type MarketplaceAgentPluginConfig, type McpConfigInfo, type McpServerConfig, type ModelInfo, type OnCandidateCompleteCallback, type OnItemRetryCallback, type OnJudgeCompleteCallback, type OnVerifierCompleteCallback, type OnWorkerCompleteCallback, type OperationType, type OutputEvent, type OutputResult, Pipeline, type PipelineContext, type PipelineEventMap, type PipelineEvents, type PipelineResult, type ProcessInfo, type Prompt, type PromptFn, RETRY_FEEDBACK_PROMPT, type ReasoningEffort, type ReduceConfig, type ReduceMeta, type ReduceParams, type ReduceResult, type ResolvedStorageConfig, type RetryConfig, type RunCost, type RunOptions, SCHEMA_PROMPT, SWARM_RESULT_BRAND, SYSTEM_PROMPT, type SandboxCommandHandle, type SandboxCommandResult, type SandboxCommands, type SandboxCreateOptions, type SandboxFiles, type SandboxInstance, type SandboxLifecycleState, type SandboxProvider, type SandboxRunOptions, type SandboxSpawnOptions, type SchemaValidationOptions, Semaphore, type SessionCost, type SessionEvent, type SessionInfo, type SessionPage, type SessionStatus, type SessionsClient, type SessionsConfig, type SkillName, type SkillsConfig, type StepCompleteEvent, type StepErrorEvent, type StepEvent, type StepResult, type StepStartEvent, type StorageClient, type StorageConfig, type StreamCallbacks, Swarm, type SwarmConfig, type SwarmResult, SwarmResultList, TerminalPipeline, type ToolsFilter, VALIDATION_PRESETS, VERIFY_PROMPT, type ValidationMode, type VerifierCompleteEvent, type VerifyConfig, type VerifyDecision, type VerifyInfo, type VerifyMeta, WORKSPACE_PROMPT, WORKSPACE_SWE_PROMPT, type WorkerCompleteEvent, type WorkspaceMode, applyTemplate, buildWorkerSystemPrompt, createAgentParser, createClaudeParser, createCodexParser, createDroidParser, createGeminiParser, executeWithRetry, expandPath, getAgentConfig, getMcpSettingsDir, getMcpSettingsPath, isValidAgentType, isZodSchema, jsonSchemaToString, parseNdjsonLine, parseNdjsonOutput, parseQwenOutput, readLocalDir, resolveStorageConfig, saveLocalDir, sessions, storage, writeClaudeMcpConfig, writeCodexMcpConfig, writeDroidGatewaySettings, writeDroidMcpConfig, writeGeminiMcpConfig, writeMcpConfig, writeQwenMcpConfig, zodSchemaToJson };