Skip to content

High-performance browser automation bridge and multi-instance orchestrator with advanced stealth injection and real-time dashboard.

8.4 KB
Raw Blame
// Package types contains shared API types for the dashboard.
// These types are exported to TypeScript via tygo.
package types

import (
	"time"
)

// Matches internal/bridge/api.go ProfileInfo
type Profile struct {
	ID                string    `json:"id,omitempty"`
	Name              string    `json:"name"`
	Path              string    `json:"path,omitempty"`
	PathExists        bool      `json:"pathExists,omitempty"`
	Created           time.Time `json:"created"`
	LastUsed          time.Time `json:"lastUsed"`
	DiskUsage         int64     `json:"diskUsage"`
	SizeMB            float64   `json:"sizeMB,omitempty"`
	Running           bool      `json:"running"`
	Temporary         bool      `json:"temporary,omitempty"`
	Quarantined       bool      `json:"quarantined,omitempty"`
	Source            string    `json:"source,omitempty"`
	ChromeProfileName string    `json:"chromeProfileName,omitempty"`
	AccountEmail      string    `json:"accountEmail,omitempty"`
	AccountName       string    `json:"accountName,omitempty"`
	HasAccount        bool      `json:"hasAccount,omitempty"`
	UseWhen           string    `json:"useWhen,omitempty"`
	Description       string    `json:"description,omitempty"`
}

type SecurityPolicy struct {
	AllowedDomains []string `json:"allowedDomains,omitempty"`
}

// Matches internal/bridge/api.go Instance
type Instance struct {
	ID             string          `json:"id"`
	ProfileID      string          `json:"profileId"`
	ProfileName    string          `json:"profileName"`
	Port           string          `json:"port"` // Note: string not int
	URL            string          `json:"url,omitempty"`
	Mode           string          `json:"mode"`
	Headless       bool            `json:"headless"`
	Status         string          `json:"status"` // starting/running/stopping/stopped/error
	StartTime      time.Time       `json:"startTime"`
	Error          string          `json:"error,omitempty"`
	Attached       bool            `json:"attached"` // True if attached rather than locally launched
	AttachType     string          `json:"attachType,omitempty"`
	CdpURL         string          `json:"cdpUrl,omitempty"` // CDP WebSocket URL (for CDP-attached instances)
	SecurityPolicy *SecurityPolicy `json:"securityPolicy,omitempty"`

	Browser string `json:"browser,omitempty"`

	// FallbackFrom/FallbackReason are reserved for a future phase (always
	// empty in P2.4a).
	FallbackFrom   string `json:"fallbackFrom,omitempty"`
	FallbackReason string `json:"fallbackReason,omitempty"`

	Crashes *CrashSummary `json:"crashes,omitempty"`

	Responsiveness string `json:"responsiveness"` // responsive/unresponsive/unknown
}

type CrashEvent struct {
	Time       time.Time `json:"time"`
	TargetID   string    `json:"targetId,omitempty"`
	TabID      string    `json:"tabId,omitempty"`
	URL        string    `json:"url,omitempty"`
	Reason     string    `json:"reason"`
	LastError  string    `json:"lastError,omitempty"`
	InstanceID string    `json:"instanceId,omitempty"`
}

type CrashSummary struct {
	Total  uint64       `json:"total"`
	Recent []CrashEvent `json:"recent"`
}

type Agent struct {
	ID           string    `json:"id"`
	Name         string    `json:"name,omitempty"`
	ConnectedAt  time.Time `json:"connectedAt"`
	LastActivity time.Time `json:"lastActivity,omitempty"`
	RequestCount int       `json:"requestCount"`
}

type AgentDetail struct {
	Agent  Agent           `json:"agent"`
	Events []ActivityEvent `json:"events"`
}

type ActivityEvent struct {
	ID        string                 `json:"id"`
	AgentID   string                 `json:"agentId"`
	Channel   string                 `json:"channel"` // "tool_call" or "progress"
	Type      string                 `json:"type"`    // navigate/snapshot/action/screenshot/other
	Method    string                 `json:"method"`
	Path      string                 `json:"path"`
	Message   string                 `json:"message,omitempty"`  // human-readable (progress channel)
	Progress  *int                   `json:"progress,omitempty"` // 0-100 numeric progress
	Total     *int                   `json:"total,omitempty"`    // total steps
	Timestamp time.Time              `json:"timestamp"`
	Details   map[string]interface{} `json:"details,omitempty"`
}

type RouteAttempt struct {
	Browser  string `json:"provider"`
	Accepted bool   `json:"accepted"`
	Reason   string `json:"reason,omitempty"`
}

type RouteMetadata struct {
	RequestedBrowser string         `json:"requestedProvider"`
	UsedBrowser      string         `json:"usedProvider"`
	Escalated        bool           `json:"escalated"`
	Reason           string         `json:"reason,omitempty"`
	Quality          int            `json:"quality,omitempty"`
	FallbackAttempts int            `json:"fallbackAttempts,omitempty"`
	Attempts         []RouteAttempt `json:"attempts,omitempty"`
}

type ActivityLogEvent struct {
	Timestamp   time.Time      `json:"timestamp"`
	Source      string         `json:"source"`
	RequestID   string         `json:"requestId,omitempty"`
	SessionID   string         `json:"sessionId,omitempty"`
	AgentID     string         `json:"agentId,omitempty"`
	Method      string         `json:"method"`
	Path        string         `json:"path"`
	Status      int            `json:"status"`
	DurationMs  int64          `json:"durationMs"`
	RemoteAddr  string         `json:"remoteAddr,omitempty"`
	InstanceID  string         `json:"instanceId,omitempty"`
	ProfileID   string         `json:"profileId,omitempty"`
	ProfileName string         `json:"profileName,omitempty"`
	TabID       string         `json:"tabId,omitempty"`
	URL         string         `json:"url,omitempty"`
	Action      string         `json:"action,omitempty"`
	Route       *RouteMetadata `json:"route,omitempty"`
	Ref         string         `json:"ref,omitempty"`
	Code        string         `json:"code,omitempty"`
	Error       string         `json:"error,omitempty"`
}

type ActivityLogResponse struct {
	Events []ActivityLogEvent `json:"events"`
	Count  int                `json:"count"`
}

type ScreencastSettings struct {
	FPS      int `json:"fps"`
	Quality  int `json:"quality"`
	MaxWidth int `json:"maxWidth"`
}

type BrowserSettings struct {
	BlockImages  bool `json:"blockImages"`
	BlockMedia   bool `json:"blockMedia"`
	NoAnimations bool `json:"noAnimations"`
}

type Settings struct {
	Screencast ScreencastSettings `json:"screencast"`
	Stealth    string             `json:"stealth"` // light/medium/full
	Browser    BrowserSettings    `json:"browser"`
	Monitoring MonitoringSettings `json:"monitoring"`
	Agents     AgentSettings      `json:"agents"`
}

type AgentSettings struct {
	ReasoningMode string `json:"reasoningMode"` // "tool_calls" (default), "progress", "both"
}

type MonitoringSettings struct {
	MemoryMetrics bool `json:"memoryMetrics"` // Enable per-tab memory aggregation (can be heavy)
	PollInterval  int  `json:"pollInterval"`  // Poll interval in seconds (default 30)
}

type ServerInfo struct {
	Version   string `json:"version"`
	Uptime    int64  `json:"uptime"`
	Profiles  int    `json:"profiles"`
	Instances int    `json:"instances"`
	Agents    int    `json:"agents"`
}

type CreateProfileRequest struct {
	Name        string `json:"name"`
	Description string `json:"description,omitempty"`
	UseWhen     string `json:"useWhen,omitempty"`
}

type CreateProfileResponse struct {
	Status string `json:"status"`
	ID     string `json:"id"`
	Name   string `json:"name"`
}

type InstanceTab struct {
	ID         string `json:"id"`
	InstanceID string `json:"instanceId"`
	URL        string `json:"url"`
	Title      string `json:"title"`
}

type InstanceMetrics struct {
	InstanceID  string  `json:"instanceId"`
	ProfileName string  `json:"profileName"`
	MemoryMB    float64 `json:"memoryMB"`
	Renderers   int     `json:"renderers"`

	Page              *PageMetrics `json:"page,omitempty"`
	UnreadableTargets int          `json:"unreadableTargets"`
}

type PageMetrics struct {
	Targets          int     `json:"targets"`
	JSHeapUsedMB     float64 `json:"jsHeapUsedMB"`
	JSHeapTotalMB    float64 `json:"jsHeapTotalMB"`
	Documents        int     `json:"documents"`
	Frames           int     `json:"frames"`
	Nodes            int     `json:"nodes"`
	JSEventListeners int     `json:"jsEventListeners"`
}

type LaunchInstanceRequest struct {
	ProfileID string `json:"profileId,omitempty"` // profile ID (prof_XXXXXXXX) or existing profile name
	Mode      string `json:"mode,omitempty"`      // "headed" or empty for headless
	Port      string `json:"port,omitempty"`      // port number as string
	Browser   string `json:"browser,omitempty"`   // browser override (chrome, cloak, ghost-chrome)
}