session

type ArtifactSummary struct {
	Kind      string `json:"kind,omitempty"`
	Name      string `json:"name,omitempty"`
	MIME      string `json:"mime,omitempty"`
	Source    string `json:"source,omitempty"`
	SourceTyp string `json:"source_type,omitempty"`
	Width     int64  `json:"width,omitempty"`
	Height    int64  `json:"height,omitempty"`
}

type AssistantProvider interface {
	Assist(AssistantRequest) (AssistantResponse, error)
}

type AssistantRequest struct {
	Kind    string
	Prompt  string
	Context SessionInspect
}

type AssistantResponse struct {
	Text string
}

type CheckpointID string

type DebugStep struct {
	Index      int               `json:"index"`
	Statement  string            `json:"statement"`
	OK         bool              `json:"ok"`
	Result     string            `json:"result,omitempty"`
	Error      string            `json:"error,omitempty"`
	Variables  map[string]string `json:"variables,omitempty"`
	DurationMS int64             `json:"duration_ms"`
}

type DebugTrace struct {
	SessionID   SessionID   `json:"session_id"`
	ExecutionID ExecutionID `json:"execution_id"`
	OK          bool        `json:"ok"`
	Steps       []DebugStep `json:"steps"`
	Error       string      `json:"error,omitempty"`
}

type ErrorKind string

type EventKind string

type ExecutionEvent struct {
	ID          string         `json:"id"`
	SessionID   SessionID      `json:"session_id"`
	ExecutionID ExecutionID    `json:"execution_id,omitempty"`
	Kind        EventKind      `json:"kind"`
	Time        time.Time      `json:"time"`
	Message     string         `json:"message,omitempty"`
	Data        map[string]any `json:"data,omitempty"`
}

type ExecutionID string

type ExecutionMetrics struct {
	Duration    time.Duration `json:"duration"`
	Steps       int64         `json:"steps"`
	OutputBytes int64         `json:"output_bytes"`
	ResultType  string        `json:"result_type,omitempty"`
	Error       string        `json:"error,omitempty"`
	ErrorKind   ErrorKind     `json:"error_kind,omitempty"`
}

type ExecutionRequest struct {
	Source     string
	Path       string
	Data       map[string]interface{}
	Print      bool
	Replay     bool
	Record     bool
	Checkpoint CheckpointID
}

type ExecutionResult struct {
	ID          ExecutionID       `json:"id"`
	SessionID   SessionID         `json:"session_id"`
	Source      string            `json:"source,omitempty"`
	Path        string            `json:"path,omitempty"`
	OK          bool              `json:"ok"`
	Result      object.Object     `json:"-"`
	ResultText  string            `json:"result,omitempty"`
	Output      string            `json:"output,omitempty"`
	Error       string            `json:"error,omitempty"`
	Diagnostics []string          `json:"diagnostics,omitempty"`
	Artifacts   []ArtifactSummary `json:"artifacts,omitempty"`
	Metrics     ExecutionMetrics  `json:"metrics"`
	StartedAt   time.Time         `json:"started_at"`
	FinishedAt  time.Time         `json:"finished_at"`
}

type RuntimeInspector interface {
	Inspect() SessionInspect
}

type Session struct {
	// contains filtered or unexported fields
}

type SessionID string

type SessionInspect struct {
	ID             SessionID         `json:"id"`
	Profile        string            `json:"profile"`
	ModuleDir      string            `json:"module_dir,omitempty"`
	SourcePath     string            `json:"source_path,omitempty"`
	Variables      map[string]string `json:"variables"`
	History        []ExecutionResult `json:"history"`
	Checkpoints    []SessionSnapshot `json:"checkpoints"`
	Events         []ExecutionEvent  `json:"events"`
	RuntimeLimits  map[string]any    `json:"runtime_limits,omitempty"`
	RenderArtifact int               `json:"render_artifacts,omitempty"`
}

type SessionOptions struct {
	ID             SessionID
	Profile        string
	Args           []string
	ModuleDir      string
	SourcePath     string
	Output         io.Writer
	Security       *object.SecurityPolicy
	Sandbox        *sandbox.SandboxConfig
	MaxDepth       int
	MaxSteps       int64
	MaxHeapMB      int64
	MaxOutputBytes int64
	Timeout        time.Duration
	Persist        bool
	PersistenceDir string
	Assistant      AssistantProvider
	EventLimit     int
}

type SessionSnapshot struct {
	ID          CheckpointID      `json:"id"`
	SessionID   SessionID         `json:"session_id"`
	CreatedAt   time.Time         `json:"created_at"`
	Description string            `json:"description,omitempty"`
	Variables   map[string]string `json:"variables"`
	// contains filtered or unexported fields
}