@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.cjs +64 -49
- package/dist/index.d.cts +55 -11
- package/dist/index.d.ts +55 -11
- package/dist/index.js +64 -49
- package/package.json +10 -6
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?:
|
|
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
|
-
*
|
|
1466
|
-
*
|
|
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(
|
|
1508
|
+
* kit.withBrowser() // defaults to remote managed Actionbook
|
|
1470
1509
|
*
|
|
1471
1510
|
* @example
|
|
1472
|
-
* kit.withBrowser() //
|
|
1511
|
+
* kit.withBrowser({ provider: "agent-browser", remote: true }) // managed remote agent-browser
|
|
1473
1512
|
*/
|
|
1474
|
-
withBrowser(provider?:
|
|
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
|
-
/**
|
|
2645
|
-
|
|
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?:
|
|
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
|
-
*
|
|
1466
|
-
*
|
|
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(
|
|
1508
|
+
* kit.withBrowser() // defaults to remote managed Actionbook
|
|
1470
1509
|
*
|
|
1471
1510
|
* @example
|
|
1472
|
-
* kit.withBrowser() //
|
|
1511
|
+
* kit.withBrowser({ provider: "agent-browser", remote: true }) // managed remote agent-browser
|
|
1473
1512
|
*/
|
|
1474
|
-
withBrowser(provider?:
|
|
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
|
-
/**
|
|
2645
|
-
|
|
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 };
|