@evolvingmachines/sdk 0.0.37 → 0.0.39

package/dist/index.d.cts

@@ -621,6 +621,10 @@ type LifecycleReason = "browser_ready" | "sandbox_boot" | "sandbox_connected" |
 /** Browser runtime info exposed to host applications. */
 interface BrowserRuntimeInfo {
     liveUrl: string;
+    /** Dashboard session ID for trace/replay APIs, present for managed browsers. */
+    sessionId?: string;
+    /** Session tag for checkpoint correlation, present for managed browsers. */
+    sessionTag?: string;
 }
 /** Lifecycle event emitted by the runtime */
 interface LifecycleEvent {
@@ -645,6 +649,10 @@ interface SessionStatus {
 interface AgentResponse {
     /** Sandbox ID for session management */
     sandboxId: string;
+    /** Dashboard session ID for trace/replay APIs, present in gateway mode when known. */
+    sessionId?: string;
+    /** Managed browser runtime info, present when a remote browser is configured. */
+    browser?: Pick<BrowserRuntimeInfo, "liveUrl">;
     /** Run ID for spend/cost attribution (present for run(), undefined for executeCommand()) */
     runId?: string;
     /** Exit code of the command */
@@ -1016,6 +1024,7 @@ declare class Agent {
     private readonly compiledValidator?;
     constructor(agentConfig: ResolvedAgentConfig, options?: AgentOptions);
     private browserRuntimeInfo;
+    private browserResponseInfo;
     private emitLifecycle;
     private invalidateActiveOperation;
     private beginOperation;
@@ -1497,15 +1506,11 @@ declare class Evolve extends EventEmitter {
     /**
      * Enable browser automation.
      *
-     * .withBrowser() defaults to Actionbook with Evolve-managed remote browser
-     * transport in gateway mode. Pass "actionbook" or "agent-browser" for local
-     * skills-only mode, or "browser-use" to use the browser-use MCP server.
-     *
-     * @example
-     * kit.withBrowser("browser-use") // browser-use MCP provider
+     * .withBrowser() defaults to agent-browser with Evolve-managed remote browser
+     * transport in gateway mode.
      *
      * @example
-     * kit.withBrowser() // defaults to remote managed Actionbook
+     * kit.withBrowser() // defaults to remote managed agent-browser
      *
      * @example
      * kit.withBrowser({ provider: "agent-browser", remote: true }) // managed remote agent-browser
@@ -3072,6 +3077,23 @@ interface DownloadSessionOptions {
     /** Directory to save the JSONL file (default: cwd) */
     to?: string;
 }
+/** Options for waiting on browser replay readiness */
+interface BrowserReplayOptions {
+    /** Max time to wait for replay readiness (default: 600000ms) */
+    timeoutMs?: number;
+    /** Poll interval while replay is processing (default: 5000ms) */
+    intervalMs?: number;
+}
+/** Browser replay metadata and access URLs */
+interface BrowserReplay {
+    sessionId: string;
+    status: "ready";
+    replayUrl: string;
+    downloadUrl: string;
+    suggestedStartSeconds?: number;
+    sizeBytes?: number;
+    readyAt?: string;
+}
 /** Options for fetching parsed events */
 interface GetEventsOptions {
     /** Return only events after this index (delta fetching) */
@@ -3094,6 +3116,8 @@ interface SessionsClient {
     events(id: string, options?: GetEventsOptions): Promise<SessionEvent[]>;
     /** Download raw JSONL trace file. Returns the file path. */
     download(id: string, options?: DownloadSessionOptions): Promise<string>;
+    /** Wait for browser replay and return Dashboard-owned replay/download URLs. */
+    browserReplay(id: string, options?: BrowserReplayOptions): Promise<BrowserReplay>;
 }
 
 /**
@@ -3113,4 +3137,4 @@ interface SessionsClient {
  */
 declare function sessions(config?: SessionsConfig): SessionsClient;
 
-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 };
+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

@@ -621,6 +621,10 @@ type LifecycleReason = "browser_ready" | "sandbox_boot" | "sandbox_connected" |
 /** Browser runtime info exposed to host applications. */
 interface BrowserRuntimeInfo {
     liveUrl: string;
+    /** Dashboard session ID for trace/replay APIs, present for managed browsers. */
+    sessionId?: string;
+    /** Session tag for checkpoint correlation, present for managed browsers. */
+    sessionTag?: string;
 }
 /** Lifecycle event emitted by the runtime */
 interface LifecycleEvent {
@@ -645,6 +649,10 @@ interface SessionStatus {
 interface AgentResponse {
     /** Sandbox ID for session management */
     sandboxId: string;
+    /** Dashboard session ID for trace/replay APIs, present in gateway mode when known. */
+    sessionId?: string;
+    /** Managed browser runtime info, present when a remote browser is configured. */
+    browser?: Pick<BrowserRuntimeInfo, "liveUrl">;
     /** Run ID for spend/cost attribution (present for run(), undefined for executeCommand()) */
     runId?: string;
     /** Exit code of the command */
@@ -1016,6 +1024,7 @@ declare class Agent {
     private readonly compiledValidator?;
     constructor(agentConfig: ResolvedAgentConfig, options?: AgentOptions);
     private browserRuntimeInfo;
+    private browserResponseInfo;
     private emitLifecycle;
     private invalidateActiveOperation;
     private beginOperation;
@@ -1497,15 +1506,11 @@ declare class Evolve extends EventEmitter {
     /**
      * Enable browser automation.
      *
-     * .withBrowser() defaults to Actionbook with Evolve-managed remote browser
-     * transport in gateway mode. Pass "actionbook" or "agent-browser" for local
-     * skills-only mode, or "browser-use" to use the browser-use MCP server.
-     *
-     * @example
-     * kit.withBrowser("browser-use") // browser-use MCP provider
+     * .withBrowser() defaults to agent-browser with Evolve-managed remote browser
+     * transport in gateway mode.
      *
      * @example
-     * kit.withBrowser() // defaults to remote managed Actionbook
+     * kit.withBrowser() // defaults to remote managed agent-browser
      *
      * @example
      * kit.withBrowser({ provider: "agent-browser", remote: true }) // managed remote agent-browser
@@ -3072,6 +3077,23 @@ interface DownloadSessionOptions {
     /** Directory to save the JSONL file (default: cwd) */
     to?: string;
 }
+/** Options for waiting on browser replay readiness */
+interface BrowserReplayOptions {
+    /** Max time to wait for replay readiness (default: 600000ms) */
+    timeoutMs?: number;
+    /** Poll interval while replay is processing (default: 5000ms) */
+    intervalMs?: number;
+}
+/** Browser replay metadata and access URLs */
+interface BrowserReplay {
+    sessionId: string;
+    status: "ready";
+    replayUrl: string;
+    downloadUrl: string;
+    suggestedStartSeconds?: number;
+    sizeBytes?: number;
+    readyAt?: string;
+}
 /** Options for fetching parsed events */
 interface GetEventsOptions {
     /** Return only events after this index (delta fetching) */
@@ -3094,6 +3116,8 @@ interface SessionsClient {
     events(id: string, options?: GetEventsOptions): Promise<SessionEvent[]>;
     /** Download raw JSONL trace file. Returns the file path. */
     download(id: string, options?: DownloadSessionOptions): Promise<string>;
+    /** Wait for browser replay and return Dashboard-owned replay/download URLs. */
+    browserReplay(id: string, options?: BrowserReplayOptions): Promise<BrowserReplay>;
 }
 
 /**
@@ -3113,4 +3137,4 @@ interface SessionsClient {
  */
 declare function sessions(config?: SessionsConfig): SessionsClient;
 
-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 };
+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 };