@evolvingmachines/sdk 0.0.35 → 0.0.38
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 -52
- package/dist/index.d.cts +53 -11
- package/dist/index.d.ts +53 -11
- package/dist/index.js +64 -52
- package/package.json +11 -7
package/dist/index.d.cts
CHANGED
|
@@ -380,15 +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" | "actionbook";
|
|
383
|
+
type BrowserProvider = "browser-use" | "actionbook" | "agent-browser";
|
|
384
|
+
/** Browser providers backed by Evolve-managed browser transport. */
|
|
385
|
+
type ManagedBrowserProvider = "actionbook" | "agent-browser";
|
|
384
386
|
/** Actionbook browser configuration. */
|
|
385
387
|
interface ActionbookBrowserConfig {
|
|
386
388
|
provider: "actionbook";
|
|
387
|
-
/** Use Evolve-managed browser transport.
|
|
388
|
-
|
|
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;
|
|
389
397
|
}
|
|
390
398
|
/** Browser automation configuration. */
|
|
391
|
-
type BrowserConfig = BrowserProvider | ActionbookBrowserConfig;
|
|
399
|
+
type BrowserConfig = BrowserProvider | ActionbookBrowserConfig | AgentBrowserConfig;
|
|
392
400
|
/** Marketplace plugin shape for CLIs with explicit plugin install commands. */
|
|
393
401
|
interface MarketplaceAgentPluginConfig {
|
|
394
402
|
/** Marketplace URL/source to register in the sandbox user profile */
|
|
@@ -541,6 +549,7 @@ interface AgentOptions {
|
|
|
541
549
|
browserPrompt?: string;
|
|
542
550
|
/** Evolve-managed browser transport for browser automation */
|
|
543
551
|
managedBrowser?: {
|
|
552
|
+
provider: ManagedBrowserProvider;
|
|
544
553
|
apiKey: string;
|
|
545
554
|
dashboardUrl?: string;
|
|
546
555
|
};
|
|
@@ -612,6 +621,10 @@ type LifecycleReason = "browser_ready" | "sandbox_boot" | "sandbox_connected" |
|
|
|
612
621
|
/** Browser runtime info exposed to host applications. */
|
|
613
622
|
interface BrowserRuntimeInfo {
|
|
614
623
|
liveUrl: string;
|
|
624
|
+
/** Dashboard session ID for trace/replay APIs, present for managed browsers. */
|
|
625
|
+
sessionId?: string;
|
|
626
|
+
/** Session tag for checkpoint correlation, present for managed browsers. */
|
|
627
|
+
sessionTag?: string;
|
|
615
628
|
}
|
|
616
629
|
/** Lifecycle event emitted by the runtime */
|
|
617
630
|
interface LifecycleEvent {
|
|
@@ -636,6 +649,10 @@ interface SessionStatus {
|
|
|
636
649
|
interface AgentResponse {
|
|
637
650
|
/** Sandbox ID for session management */
|
|
638
651
|
sandboxId: string;
|
|
652
|
+
/** Dashboard session ID for trace/replay APIs, present in gateway mode when known. */
|
|
653
|
+
sessionId?: string;
|
|
654
|
+
/** Managed browser runtime info, present when a remote browser is configured. */
|
|
655
|
+
browser?: Pick<BrowserRuntimeInfo, "liveUrl">;
|
|
639
656
|
/** Run ID for spend/cost attribution (present for run(), undefined for executeCommand()) */
|
|
640
657
|
runId?: string;
|
|
641
658
|
/** Exit code of the command */
|
|
@@ -1007,6 +1024,7 @@ declare class Agent {
|
|
|
1007
1024
|
private readonly compiledValidator?;
|
|
1008
1025
|
constructor(agentConfig: ResolvedAgentConfig, options?: AgentOptions);
|
|
1009
1026
|
private browserRuntimeInfo;
|
|
1027
|
+
private browserResponseInfo;
|
|
1010
1028
|
private emitLifecycle;
|
|
1011
1029
|
private invalidateActiveOperation;
|
|
1012
1030
|
private beginOperation;
|
|
@@ -1025,6 +1043,7 @@ declare class Agent {
|
|
|
1025
1043
|
*/
|
|
1026
1044
|
private buildEnvironmentVariables;
|
|
1027
1045
|
private ensureManagedBrowserSession;
|
|
1046
|
+
private setupManagedBrowser;
|
|
1028
1047
|
private closeManagedBrowserSession;
|
|
1029
1048
|
/**
|
|
1030
1049
|
* Build the inline gateway config JSON for agents using gatewayConfigEnv
|
|
@@ -1487,14 +1506,18 @@ declare class Evolve extends EventEmitter {
|
|
|
1487
1506
|
/**
|
|
1488
1507
|
* Enable browser automation.
|
|
1489
1508
|
*
|
|
1490
|
-
*
|
|
1491
|
-
* transport in gateway mode. Pass "
|
|
1509
|
+
* .withBrowser() defaults to Actionbook with Evolve-managed remote browser
|
|
1510
|
+
* transport in gateway mode. Pass "actionbook" or "agent-browser" for local
|
|
1511
|
+
* skills-only mode, or "browser-use" to use the browser-use MCP server.
|
|
1512
|
+
*
|
|
1513
|
+
* @example
|
|
1514
|
+
* kit.withBrowser("browser-use") // browser-use MCP provider
|
|
1492
1515
|
*
|
|
1493
1516
|
* @example
|
|
1494
|
-
* kit.withBrowser(
|
|
1517
|
+
* kit.withBrowser() // defaults to remote managed Actionbook
|
|
1495
1518
|
*
|
|
1496
1519
|
* @example
|
|
1497
|
-
* kit.withBrowser() //
|
|
1520
|
+
* kit.withBrowser({ provider: "agent-browser", remote: true }) // managed remote agent-browser
|
|
1498
1521
|
*/
|
|
1499
1522
|
withBrowser(provider?: BrowserConfig | false): this;
|
|
1500
1523
|
/**
|
|
@@ -2666,8 +2689,8 @@ interface AgentRegistryEntry {
|
|
|
2666
2689
|
buildCommand: (opts: BuildCommandOptions) => string;
|
|
2667
2690
|
/** Extra setup step (e.g., codex login) */
|
|
2668
2691
|
setupCommand?: string;
|
|
2669
|
-
/**
|
|
2670
|
-
|
|
2692
|
+
/** Gateway path prefix for CLIs that use a provider-native passthrough endpoint */
|
|
2693
|
+
gatewayPath?: string;
|
|
2671
2694
|
/** Default base URL for direct mode (only needed if provider requires specific endpoint, e.g., Qwen → Dashscope) */
|
|
2672
2695
|
defaultBaseUrl?: string;
|
|
2673
2696
|
/** Available beta headers for this agent (for reference) */
|
|
@@ -3058,6 +3081,23 @@ interface DownloadSessionOptions {
|
|
|
3058
3081
|
/** Directory to save the JSONL file (default: cwd) */
|
|
3059
3082
|
to?: string;
|
|
3060
3083
|
}
|
|
3084
|
+
/** Options for waiting on browser replay readiness */
|
|
3085
|
+
interface BrowserReplayOptions {
|
|
3086
|
+
/** Max time to wait for replay readiness (default: 600000ms) */
|
|
3087
|
+
timeoutMs?: number;
|
|
3088
|
+
/** Poll interval while replay is processing (default: 5000ms) */
|
|
3089
|
+
intervalMs?: number;
|
|
3090
|
+
}
|
|
3091
|
+
/** Browser replay metadata and access URLs */
|
|
3092
|
+
interface BrowserReplay {
|
|
3093
|
+
sessionId: string;
|
|
3094
|
+
status: "ready";
|
|
3095
|
+
replayUrl: string;
|
|
3096
|
+
downloadUrl: string;
|
|
3097
|
+
suggestedStartSeconds?: number;
|
|
3098
|
+
sizeBytes?: number;
|
|
3099
|
+
readyAt?: string;
|
|
3100
|
+
}
|
|
3061
3101
|
/** Options for fetching parsed events */
|
|
3062
3102
|
interface GetEventsOptions {
|
|
3063
3103
|
/** Return only events after this index (delta fetching) */
|
|
@@ -3080,6 +3120,8 @@ interface SessionsClient {
|
|
|
3080
3120
|
events(id: string, options?: GetEventsOptions): Promise<SessionEvent[]>;
|
|
3081
3121
|
/** Download raw JSONL trace file. Returns the file path. */
|
|
3082
3122
|
download(id: string, options?: DownloadSessionOptions): Promise<string>;
|
|
3123
|
+
/** Wait for browser replay and return Dashboard-owned replay/download URLs. */
|
|
3124
|
+
browserReplay(id: string, options?: BrowserReplayOptions): Promise<BrowserReplay>;
|
|
3083
3125
|
}
|
|
3084
3126
|
|
|
3085
3127
|
/**
|
|
@@ -3099,4 +3141,4 @@ interface SessionsClient {
|
|
|
3099
3141
|
*/
|
|
3100
3142
|
declare function sessions(config?: SessionsConfig): SessionsClient;
|
|
3101
3143
|
|
|
3102
|
-
export { AGENT_REGISTRY, AGENT_TYPES, type ActionbookBrowserConfig, Agent, 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 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 };
|
|
3144
|
+
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 BrowserReplay, type BrowserReplayOptions, 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,15 +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" | "actionbook";
|
|
383
|
+
type BrowserProvider = "browser-use" | "actionbook" | "agent-browser";
|
|
384
|
+
/** Browser providers backed by Evolve-managed browser transport. */
|
|
385
|
+
type ManagedBrowserProvider = "actionbook" | "agent-browser";
|
|
384
386
|
/** Actionbook browser configuration. */
|
|
385
387
|
interface ActionbookBrowserConfig {
|
|
386
388
|
provider: "actionbook";
|
|
387
|
-
/** Use Evolve-managed browser transport.
|
|
388
|
-
|
|
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;
|
|
389
397
|
}
|
|
390
398
|
/** Browser automation configuration. */
|
|
391
|
-
type BrowserConfig = BrowserProvider | ActionbookBrowserConfig;
|
|
399
|
+
type BrowserConfig = BrowserProvider | ActionbookBrowserConfig | AgentBrowserConfig;
|
|
392
400
|
/** Marketplace plugin shape for CLIs with explicit plugin install commands. */
|
|
393
401
|
interface MarketplaceAgentPluginConfig {
|
|
394
402
|
/** Marketplace URL/source to register in the sandbox user profile */
|
|
@@ -541,6 +549,7 @@ interface AgentOptions {
|
|
|
541
549
|
browserPrompt?: string;
|
|
542
550
|
/** Evolve-managed browser transport for browser automation */
|
|
543
551
|
managedBrowser?: {
|
|
552
|
+
provider: ManagedBrowserProvider;
|
|
544
553
|
apiKey: string;
|
|
545
554
|
dashboardUrl?: string;
|
|
546
555
|
};
|
|
@@ -612,6 +621,10 @@ type LifecycleReason = "browser_ready" | "sandbox_boot" | "sandbox_connected" |
|
|
|
612
621
|
/** Browser runtime info exposed to host applications. */
|
|
613
622
|
interface BrowserRuntimeInfo {
|
|
614
623
|
liveUrl: string;
|
|
624
|
+
/** Dashboard session ID for trace/replay APIs, present for managed browsers. */
|
|
625
|
+
sessionId?: string;
|
|
626
|
+
/** Session tag for checkpoint correlation, present for managed browsers. */
|
|
627
|
+
sessionTag?: string;
|
|
615
628
|
}
|
|
616
629
|
/** Lifecycle event emitted by the runtime */
|
|
617
630
|
interface LifecycleEvent {
|
|
@@ -636,6 +649,10 @@ interface SessionStatus {
|
|
|
636
649
|
interface AgentResponse {
|
|
637
650
|
/** Sandbox ID for session management */
|
|
638
651
|
sandboxId: string;
|
|
652
|
+
/** Dashboard session ID for trace/replay APIs, present in gateway mode when known. */
|
|
653
|
+
sessionId?: string;
|
|
654
|
+
/** Managed browser runtime info, present when a remote browser is configured. */
|
|
655
|
+
browser?: Pick<BrowserRuntimeInfo, "liveUrl">;
|
|
639
656
|
/** Run ID for spend/cost attribution (present for run(), undefined for executeCommand()) */
|
|
640
657
|
runId?: string;
|
|
641
658
|
/** Exit code of the command */
|
|
@@ -1007,6 +1024,7 @@ declare class Agent {
|
|
|
1007
1024
|
private readonly compiledValidator?;
|
|
1008
1025
|
constructor(agentConfig: ResolvedAgentConfig, options?: AgentOptions);
|
|
1009
1026
|
private browserRuntimeInfo;
|
|
1027
|
+
private browserResponseInfo;
|
|
1010
1028
|
private emitLifecycle;
|
|
1011
1029
|
private invalidateActiveOperation;
|
|
1012
1030
|
private beginOperation;
|
|
@@ -1025,6 +1043,7 @@ declare class Agent {
|
|
|
1025
1043
|
*/
|
|
1026
1044
|
private buildEnvironmentVariables;
|
|
1027
1045
|
private ensureManagedBrowserSession;
|
|
1046
|
+
private setupManagedBrowser;
|
|
1028
1047
|
private closeManagedBrowserSession;
|
|
1029
1048
|
/**
|
|
1030
1049
|
* Build the inline gateway config JSON for agents using gatewayConfigEnv
|
|
@@ -1487,14 +1506,18 @@ declare class Evolve extends EventEmitter {
|
|
|
1487
1506
|
/**
|
|
1488
1507
|
* Enable browser automation.
|
|
1489
1508
|
*
|
|
1490
|
-
*
|
|
1491
|
-
* transport in gateway mode. Pass "
|
|
1509
|
+
* .withBrowser() defaults to Actionbook with Evolve-managed remote browser
|
|
1510
|
+
* transport in gateway mode. Pass "actionbook" or "agent-browser" for local
|
|
1511
|
+
* skills-only mode, or "browser-use" to use the browser-use MCP server.
|
|
1512
|
+
*
|
|
1513
|
+
* @example
|
|
1514
|
+
* kit.withBrowser("browser-use") // browser-use MCP provider
|
|
1492
1515
|
*
|
|
1493
1516
|
* @example
|
|
1494
|
-
* kit.withBrowser(
|
|
1517
|
+
* kit.withBrowser() // defaults to remote managed Actionbook
|
|
1495
1518
|
*
|
|
1496
1519
|
* @example
|
|
1497
|
-
* kit.withBrowser() //
|
|
1520
|
+
* kit.withBrowser({ provider: "agent-browser", remote: true }) // managed remote agent-browser
|
|
1498
1521
|
*/
|
|
1499
1522
|
withBrowser(provider?: BrowserConfig | false): this;
|
|
1500
1523
|
/**
|
|
@@ -2666,8 +2689,8 @@ interface AgentRegistryEntry {
|
|
|
2666
2689
|
buildCommand: (opts: BuildCommandOptions) => string;
|
|
2667
2690
|
/** Extra setup step (e.g., codex login) */
|
|
2668
2691
|
setupCommand?: string;
|
|
2669
|
-
/**
|
|
2670
|
-
|
|
2692
|
+
/** Gateway path prefix for CLIs that use a provider-native passthrough endpoint */
|
|
2693
|
+
gatewayPath?: string;
|
|
2671
2694
|
/** Default base URL for direct mode (only needed if provider requires specific endpoint, e.g., Qwen → Dashscope) */
|
|
2672
2695
|
defaultBaseUrl?: string;
|
|
2673
2696
|
/** Available beta headers for this agent (for reference) */
|
|
@@ -3058,6 +3081,23 @@ interface DownloadSessionOptions {
|
|
|
3058
3081
|
/** Directory to save the JSONL file (default: cwd) */
|
|
3059
3082
|
to?: string;
|
|
3060
3083
|
}
|
|
3084
|
+
/** Options for waiting on browser replay readiness */
|
|
3085
|
+
interface BrowserReplayOptions {
|
|
3086
|
+
/** Max time to wait for replay readiness (default: 600000ms) */
|
|
3087
|
+
timeoutMs?: number;
|
|
3088
|
+
/** Poll interval while replay is processing (default: 5000ms) */
|
|
3089
|
+
intervalMs?: number;
|
|
3090
|
+
}
|
|
3091
|
+
/** Browser replay metadata and access URLs */
|
|
3092
|
+
interface BrowserReplay {
|
|
3093
|
+
sessionId: string;
|
|
3094
|
+
status: "ready";
|
|
3095
|
+
replayUrl: string;
|
|
3096
|
+
downloadUrl: string;
|
|
3097
|
+
suggestedStartSeconds?: number;
|
|
3098
|
+
sizeBytes?: number;
|
|
3099
|
+
readyAt?: string;
|
|
3100
|
+
}
|
|
3061
3101
|
/** Options for fetching parsed events */
|
|
3062
3102
|
interface GetEventsOptions {
|
|
3063
3103
|
/** Return only events after this index (delta fetching) */
|
|
@@ -3080,6 +3120,8 @@ interface SessionsClient {
|
|
|
3080
3120
|
events(id: string, options?: GetEventsOptions): Promise<SessionEvent[]>;
|
|
3081
3121
|
/** Download raw JSONL trace file. Returns the file path. */
|
|
3082
3122
|
download(id: string, options?: DownloadSessionOptions): Promise<string>;
|
|
3123
|
+
/** Wait for browser replay and return Dashboard-owned replay/download URLs. */
|
|
3124
|
+
browserReplay(id: string, options?: BrowserReplayOptions): Promise<BrowserReplay>;
|
|
3083
3125
|
}
|
|
3084
3126
|
|
|
3085
3127
|
/**
|
|
@@ -3099,4 +3141,4 @@ interface SessionsClient {
|
|
|
3099
3141
|
*/
|
|
3100
3142
|
declare function sessions(config?: SessionsConfig): SessionsClient;
|
|
3101
3143
|
|
|
3102
|
-
export { AGENT_REGISTRY, AGENT_TYPES, type ActionbookBrowserConfig, Agent, 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 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 };
|
|
3144
|
+
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 BrowserReplay, type BrowserReplayOptions, 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 };
|