@evolvingmachines/sdk 0.0.37 → 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.
Files changed (5) hide show
  1. package/dist/index.cjs +50 -50
  2. package/dist/index.d.cts +29 -1
  3. package/dist/index.d.ts +29 -1
  4. package/dist/index.js +50 -50
  5. package/package.json +5 -5
package/dist/index.d.cts CHANGED
@@ -621,6 +621,10 @@ type LifecycleReason = "browser_ready" | "sandbox_boot" | "sandbox_connected" |
621
621
  /** Browser runtime info exposed to host applications. */
622
622
  interface BrowserRuntimeInfo {
623
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;
624
628
  }
625
629
  /** Lifecycle event emitted by the runtime */
626
630
  interface LifecycleEvent {
@@ -645,6 +649,10 @@ interface SessionStatus {
645
649
  interface AgentResponse {
646
650
  /** Sandbox ID for session management */
647
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">;
648
656
  /** Run ID for spend/cost attribution (present for run(), undefined for executeCommand()) */
649
657
  runId?: string;
650
658
  /** Exit code of the command */
@@ -1016,6 +1024,7 @@ declare class Agent {
1016
1024
  private readonly compiledValidator?;
1017
1025
  constructor(agentConfig: ResolvedAgentConfig, options?: AgentOptions);
1018
1026
  private browserRuntimeInfo;
1027
+ private browserResponseInfo;
1019
1028
  private emitLifecycle;
1020
1029
  private invalidateActiveOperation;
1021
1030
  private beginOperation;
@@ -3072,6 +3081,23 @@ interface DownloadSessionOptions {
3072
3081
  /** Directory to save the JSONL file (default: cwd) */
3073
3082
  to?: string;
3074
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
+ }
3075
3101
  /** Options for fetching parsed events */
3076
3102
  interface GetEventsOptions {
3077
3103
  /** Return only events after this index (delta fetching) */
@@ -3094,6 +3120,8 @@ interface SessionsClient {
3094
3120
  events(id: string, options?: GetEventsOptions): Promise<SessionEvent[]>;
3095
3121
  /** Download raw JSONL trace file. Returns the file path. */
3096
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>;
3097
3125
  }
3098
3126
 
3099
3127
  /**
@@ -3113,4 +3141,4 @@ interface SessionsClient {
3113
3141
  */
3114
3142
  declare function sessions(config?: SessionsConfig): SessionsClient;
3115
3143
 
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 };
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
@@ -621,6 +621,10 @@ type LifecycleReason = "browser_ready" | "sandbox_boot" | "sandbox_connected" |
621
621
  /** Browser runtime info exposed to host applications. */
622
622
  interface BrowserRuntimeInfo {
623
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;
624
628
  }
625
629
  /** Lifecycle event emitted by the runtime */
626
630
  interface LifecycleEvent {
@@ -645,6 +649,10 @@ interface SessionStatus {
645
649
  interface AgentResponse {
646
650
  /** Sandbox ID for session management */
647
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">;
648
656
  /** Run ID for spend/cost attribution (present for run(), undefined for executeCommand()) */
649
657
  runId?: string;
650
658
  /** Exit code of the command */
@@ -1016,6 +1024,7 @@ declare class Agent {
1016
1024
  private readonly compiledValidator?;
1017
1025
  constructor(agentConfig: ResolvedAgentConfig, options?: AgentOptions);
1018
1026
  private browserRuntimeInfo;
1027
+ private browserResponseInfo;
1019
1028
  private emitLifecycle;
1020
1029
  private invalidateActiveOperation;
1021
1030
  private beginOperation;
@@ -3072,6 +3081,23 @@ interface DownloadSessionOptions {
3072
3081
  /** Directory to save the JSONL file (default: cwd) */
3073
3082
  to?: string;
3074
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
+ }
3075
3101
  /** Options for fetching parsed events */
3076
3102
  interface GetEventsOptions {
3077
3103
  /** Return only events after this index (delta fetching) */
@@ -3094,6 +3120,8 @@ interface SessionsClient {
3094
3120
  events(id: string, options?: GetEventsOptions): Promise<SessionEvent[]>;
3095
3121
  /** Download raw JSONL trace file. Returns the file path. */
3096
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>;
3097
3125
  }
3098
3126
 
3099
3127
  /**
@@ -3113,4 +3141,4 @@ interface SessionsClient {
3113
3141
  */
3114
3142
  declare function sessions(config?: SessionsConfig): SessionsClient;
3115
3143
 
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 };
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 };