testui

Documentation

Index

• Constants
• type AgentInterfaceProbeRequest
• type AgentObservation
• type AgentRun
• type AgentRunRequest
• type AgentRunResponse
• type AgentSessionSnapshot
• type AgentStreamEvent
• type AgentStreamEventType
• type AgentStreamSink
• type AgentToolOption
• type AgentToolsUpdateRequest
• type AgentTurnRequest
• type AgentTurnSummary
• type ArtifactSnapshot
• type CapabilityDiagnostic
• type CapabilityState
• type CatalogProvider
• type ConfigInfo
• type ConfigState
• type LocalTimeInfo
• type MCPCapabilityState
• type ObservedArtifactRef
• type ObservedCacheSummary
• type ObservedCompactionEvent
• type ObservedContextProjection
• type ObservedContextSegment
• type ObservedContextStatus
• type ObservedProviderEvent
• type ObservedProviderRequest
• type ObservedRawSegment
• type ObservedSessionEntry
• type ObservedSessionMessage
• type ObservedToolResultView
• type PackageSummary
• type ProviderProfile
• type RunRequest
• type RunResponse
• type Runner
  • func NewRunner(root string) Runner
  • func (r *Runner) AgentSession(ctx context.Context, sessionID string) (AgentSessionSnapshot, error)
  • func (r *Runner) AgentSessions(ctx context.Context) []AgentSessionSnapshot
  • func (r Runner) Catalog() []CatalogProvider
  • func (r *Runner) ConfigInfo() ConfigInfo
  • func (r *Runner) ConfigState() (ConfigState, error)
  • func (r *Runner) CreateAgentSession(ctx context.Context, req AgentRunRequest) AgentRunResponse
  • func (r *Runner) CreateIdleAgentSession(ctx context.Context, req AgentRunRequest) (AgentSessionSnapshot, error)
  • func (r *Runner) DeleteAgentSession(ctx context.Context, sessionID string) error
  • func (r *Runner) InstallSkill(ctx context.Context, req SkillInstallRequest) (SkillInstallResponse, error)
  • func (r *Runner) PreviewSkillInstall(ctx context.Context, req SkillInstallPreviewRequest) (SkillInstallPreview, error)
  • func (r Runner) Run(ctx context.Context, target string) RunResponse
  • func (r *Runner) RunAgent(ctx context.Context, req AgentRunRequest) AgentRunResponse
  • func (r *Runner) RunAgentTurn(ctx context.Context, sessionID string, req AgentTurnRequest) AgentRunResponse
  • func (r *Runner) RunAgentTurnStream(ctx context.Context, sessionID string, req AgentTurnRequest, ...) AgentRunResponse
  • func (r *Runner) RunInterfaceProbe(ctx context.Context, req AgentInterfaceProbeRequest) AgentRunResponse
  • func (r Runner) RunWithOptions(ctx context.Context, target string, opts runOptions) RunResponse
  • func (r *Runner) SaveConfigState(req SaveConfigRequest) (ConfigState, error)
  • func (r *Runner) UpdateAgentSessionTools(ctx context.Context, sessionID string, req AgentToolsUpdateRequest) (AgentSessionSnapshot, error)
• type SaveConfigRequest
• type SaveSearchProvider
• type SearchProviderInfo
• type SearchWireShape
• type Server
  • func NewServer(r Runner) (*Server, error)
  • func (s *Server) Handler() http.Handler
• type SkillCapabilityState
• type SkillInstallFile
• type SkillInstallPreview
• type SkillInstallPreviewRequest
• type SkillInstallRequest
• type SkillInstallResponse
• type SkillSourceState
• type StateTransition
• type TestTotals

Constants

const (
	TargetUnit              = "unit"
	TargetRace              = "race"
	TargetEvalDemo          = "eval-demo"
	TargetProviderSmoke     = "provider-smoke"
	TargetToolScenarios     = "tool-scenarios"
	TargetLiveToolScenarios = "live-tool-scenarios"
	TargetAll               = "all"
)

const (
	StorageModeSQLite = "sqlite"
	StorageModeFile   = "file"
	StorageModeMemory = "memory"
)

Types

type AgentInterfaceProbeRequest

type AgentInterfaceProbeRequest struct {
	ProfileID     string               `json:"profile_id,omitempty"`
	SelectedTools []string             `json:"selected_tools,omitempty"`
	ContextPolicy config.ContextPolicy `json:"context_policy,omitempty"`
}

type AgentObservation

type AgentObservation struct {
	ProviderRequests  []ObservedProviderRequest    `json:"provider_requests"`
	ProviderEvents    []ObservedProviderEvent      `json:"provider_events"`
	ContextStatuses   []ObservedContextStatus      `json:"context_statuses,omitempty"`
	CompactionEvents  []ObservedCompactionEvent    `json:"compaction_events,omitempty"`
	ActivityTimeline  observation.ActivityTimeline `json:"activity_timeline"`
	SessionMessages   []ObservedSessionMessage     `json:"session_messages"`
	ActiveContext     []ObservedSessionMessage     `json:"active_context"`
	ContextProjection ObservedContextProjection    `json:"context_projection,omitempty"`
	PathEntries       []ObservedSessionEntry       `json:"path_entries"`
	Transitions       []StateTransition            `json:"transitions"`
	Diagnostics       map[string]string            `json:"diagnostics,omitempty"`
}

type AgentRun

type AgentRun struct {
	EngineStatus string                      `json:"engine_status"`
	Output       string                      `json:"output"`
	Metrics      engine.RunMetrics           `json:"metrics"`
	Events       []event.Event               `json:"events"`
	Eval         *eval.Result                `json:"eval,omitempty"`
	Artifacts    map[string]ArtifactSnapshot `json:"artifacts,omitempty"`
	Config       ConfigInfo                  `json:"config,omitempty"`
}

type AgentRunRequest

type AgentRunRequest struct {
	ProfileID      string                `json:"profile_id"`
	Profile        ProviderProfile       `json:"profile,omitempty"`
	AgentProfile   config.AgentProfile   `json:"agent_profile,omitempty"`
	PromptIdentity config.PromptIdentity `json:"prompt_identity,omitempty"`
	Message        string                `json:"message"`
	SystemPrompt   string                `json:"system_prompt"`
	SelectedTools  []string              `json:"selected_tools,omitempty"`
	ContextPolicy  config.ContextPolicy  `json:"context_policy,omitempty"`
}

type AgentRunResponse

type AgentRunResponse struct {
	StatusCode         int                          `json:"-"`
	ID                 string                       `json:"id"`
	Probe              bool                         `json:"probe,omitempty"`
	SessionID          string                       `json:"session_id"`
	TurnID             string                       `json:"turn_id"`
	Status             string                       `json:"status"`
	StartedAt          time.Time                    `json:"started_at"`
	FinishedAt         time.Time                    `json:"finished_at"`
	DurationMS         int64                        `json:"duration_ms"`
	Summary            string                       `json:"summary"`
	Output             string                       `json:"output"`
	Error              string                       `json:"error,omitempty"`
	Profile            ProviderProfile              `json:"profile"`
	Metrics            engine.RunMetrics            `json:"metrics"`
	Events             []event.Event                `json:"events"`
	HarnessEvents      []agentharness.HarnessEvent  `json:"harness_events,omitempty"`
	CompletionReason   string                       `json:"completion_reason,omitempty"`
	ContinuationReason string                       `json:"continuation_reason,omitempty"`
	FinishReason       string                       `json:"finish_reason,omitempty"`
	RawFinishReason    string                       `json:"raw_finish_reason,omitempty"`
	FinishInferred     bool                         `json:"finish_inferred,omitempty"`
	Diagnostics        map[string]string            `json:"diagnostics,omitempty"`
	CanAppendMessage   bool                         `json:"can_append_message"`
	WaitingPrompt      string                       `json:"waiting_prompt,omitempty"`
	ActivityTimeline   observation.ActivityTimeline `json:"activity_timeline"`
	Session            AgentSessionSnapshot         `json:"session"`
	Observation        AgentObservation             `json:"observation"`
}

type AgentSessionSnapshot

type AgentSessionSnapshot struct {
	ID                      string                          `json:"id"`
	Title                   string                          `json:"title,omitempty"`
	TitleStatus             string                          `json:"title_status,omitempty"`
	TitleSource             string                          `json:"title_source,omitempty"`
	TitleUpdatedAt          time.Time                       `json:"title_updated_at,omitempty"`
	TitleError              string                          `json:"title_error,omitempty"`
	Status                  string                          `json:"status"`
	Phase                   string                          `json:"phase"`
	LeafID                  string                          `json:"leaf_id,omitempty"`
	CreatedAt               time.Time                       `json:"created_at"`
	UpdatedAt               time.Time                       `json:"updated_at"`
	Profile                 ProviderProfile                 `json:"profile"`
	AgentProfile            config.AgentProfile             `json:"agent_profile"`
	PromptIdentity          config.PromptIdentity           `json:"prompt_identity"`
	SystemPrompt            string                          `json:"system_prompt"`
	SelectedTools           []string                        `json:"selected_tools"`
	HostedTools             []provider.HostedToolDefinition `json:"hosted_tools,omitempty"`
	UnavailableCapabilities []string                        `json:"unavailable_capabilities,omitempty"`
	Capabilities            CapabilityState                 `json:"capabilities"`
	ContextPolicy           config.ContextPolicy            `json:"context_policy"`
	LatestTurnID            string                          `json:"latest_turn_id,omitempty"`
	WaitingPrompt           string                          `json:"waiting_prompt,omitempty"`
	Recoverable             bool                            `json:"recoverable,omitempty"`
	CanAppendMessage        bool                            `json:"can_append_message"`
	Turns                   []AgentTurnSummary              `json:"turns"`
	ActiveContext           []ObservedSessionMessage        `json:"active_context"`
	ContextProjection       ObservedContextProjection       `json:"context_projection,omitempty"`
	PathEntries             []ObservedSessionEntry          `json:"path_entries"`
	AllEntries              []ObservedSessionEntry          `json:"all_entries"`
	AggregateMetrics        engine.RunMetrics               `json:"aggregate_metrics"`
	Compactions             int                             `json:"compactions"`
	ContextStatuses         []ObservedContextStatus         `json:"context_statuses,omitempty"`
	CompactionEvents        []ObservedCompactionEvent       `json:"compaction_events,omitempty"`
	ActivityTimeline        observation.ActivityTimeline    `json:"activity_timeline"`
	Observation             AgentObservation                `json:"observation,omitempty"`
}

type AgentStreamEvent

type AgentStreamEvent struct {
	Sequence         int64                         `json:"sequence"`
	Type             AgentStreamEventType          `json:"type"`
	SessionID        string                        `json:"session_id,omitempty"`
	TurnID           string                        `json:"turn_id,omitempty"`
	EntryID          string                        `json:"entry_id,omitempty"`
	Step             int                           `json:"step,omitempty"`
	At               time.Time                     `json:"at"`
	Entry            *ObservedSessionEntry         `json:"entry,omitempty"`
	ProviderRequest  *ObservedProviderRequest      `json:"provider_request,omitempty"`
	ProviderEvent    *ObservedProviderEvent        `json:"provider_event,omitempty"`
	ContextStatus    *ObservedContextStatus        `json:"context_status,omitempty"`
	Compaction       *ObservedCompactionEvent      `json:"compaction,omitempty"`
	ActivityTimeline *observation.ActivityTimeline `json:"activity_timeline,omitempty"`
	EngineEvent      *event.Event                  `json:"engine_event,omitempty"`
	Snapshot         *AgentSessionSnapshot         `json:"session_snapshot,omitempty"`
	Result           *AgentRunResponse             `json:"result,omitempty"`
	Message          string                        `json:"message,omitempty"`
	Error            string                        `json:"error,omitempty"`
	Metadata         map[string]string             `json:"metadata,omitempty"`
}

type AgentStreamEventType

type AgentStreamEventType string

const (
	AgentStreamTurnStarted              AgentStreamEventType = "turn_started"
	AgentStreamUserMessageAppended      AgentStreamEventType = "user_message_appended"
	AgentStreamProviderRequest          AgentStreamEventType = "provider_request"
	AgentStreamProviderDelta            AgentStreamEventType = "provider_delta"
	AgentStreamContextStatus            AgentStreamEventType = "context_status"
	AgentStreamContextCompaction        AgentStreamEventType = "context_compaction"
	AgentStreamActivity                 AgentStreamEventType = "activity"
	AgentStreamAssistantMessageAppended AgentStreamEventType = "assistant_message_appended"
	AgentStreamToolCall                 AgentStreamEventType = "tool_call"
	AgentStreamToolResult               AgentStreamEventType = "tool_result"
	AgentStreamTurnSavePoint            AgentStreamEventType = "turn_save_point"
	AgentStreamSessionSnapshot          AgentStreamEventType = "session_snapshot"
	AgentStreamTurnCompleted            AgentStreamEventType = "turn_completed"
	AgentStreamTurnFailed               AgentStreamEventType = "turn_failed"
)

type AgentStreamSink

type AgentStreamSink interface {
	EmitAgentStream(AgentStreamEvent)
}

type AgentToolOption

type AgentToolOption struct {
	Name        string `json:"name"`
	Title       string `json:"title"`
	Description string `json:"description"`
	Group       string `json:"group"`
	GroupTitle  string `json:"group_title"`
	Risk        string `json:"risk,omitempty"`
	Permission  string `json:"permission_mode,omitempty"`
	Kind        string `json:"kind,omitempty"`
	Available   bool   `json:"available"`
	Unavailable string `json:"unavailable,omitempty"`
	Source      string `json:"source,omitempty"`
	Status      string `json:"status,omitempty"`
	Exposure    string `json:"exposure,omitempty"`
	WireShape   string `json:"wire_shape,omitempty"`
}

type AgentToolsUpdateRequest

type AgentToolsUpdateRequest struct {
	SelectedTools *[]string `json:"selected_tools"`
	Reason        string    `json:"reason,omitempty"`
}

type AgentTurnRequest

type AgentTurnRequest struct {
	Message string `json:"message"`
}

type AgentTurnSummary

type AgentTurnSummary struct {
	ID                 string            `json:"id"`
	Status             string            `json:"status"`
	Output             string            `json:"output,omitempty"`
	Error              string            `json:"error,omitempty"`
	StartedAt          time.Time         `json:"started_at,omitempty"`
	FinishedAt         time.Time         `json:"finished_at,omitempty"`
	Metrics            engine.RunMetrics `json:"metrics,omitempty"`
	CompletionReason   string            `json:"completion_reason,omitempty"`
	ContinuationReason string            `json:"continuation_reason,omitempty"`
	FinishReason       string            `json:"finish_reason,omitempty"`
	RawFinishReason    string            `json:"raw_finish_reason,omitempty"`
	FinishInferred     bool              `json:"finish_inferred,omitempty"`
}

type ArtifactSnapshot

type ArtifactSnapshot struct {
	Path    string `json:"path"`
	Content string `json:"content"`
}

type CapabilityDiagnostic

type CapabilityDiagnostic struct {
	Kind       string `json:"kind"`
	Capability string `json:"capability,omitempty"`
	SourceKind string `json:"source_kind,omitempty"`
	Message    string `json:"message"`
	NextAction string `json:"next_action,omitempty"`
}

type CapabilityState

type CapabilityState struct {
	MCPServers   []MCPCapabilityState   `json:"mcp_servers"`
	SkillSources []SkillSourceState     `json:"skill_sources,omitempty"`
	Skills       []SkillCapabilityState `json:"skills"`
	Diagnostics  []CapabilityDiagnostic `json:"diagnostics,omitempty"`
}

type CatalogProvider

type CatalogProvider = catalog.Provider

type ConfigInfo

type ConfigInfo struct {
	Provider     string        `json:"provider"`
	Model        string        `json:"model"`
	EnvFile      string        `json:"env_file"`
	EnvFileFound bool          `json:"env_file_found"`
	LiveProvider bool          `json:"live_provider"`
	BaseURL      string        `json:"base_url,omitempty"`
	Storage      storageStatus `json:"storage"`
}

type ConfigState

type ConfigState struct {
	EnvFile               string                `json:"env_file"`
	EnvFileFound          bool                  `json:"env_file_found"`
	ActiveProfileID       string                `json:"active_profile_id"`
	Profiles              []ProviderProfile     `json:"profiles"`
	AgentProfile          config.AgentProfile   `json:"agent_profile"`
	PromptIdentity        config.PromptIdentity `json:"prompt_identity"`
	Catalog               []CatalogProvider     `json:"catalog"`
	ContextPolicyDefaults config.ContextPolicy  `json:"context_policy_defaults"`
	Tools                 []AgentToolOption     `json:"tools"`
	SearchWireShapes      []SearchWireShape     `json:"search_wire_shapes"`
	SearchProvider        SearchProviderInfo    `json:"search_provider"`
	Capabilities          CapabilityState       `json:"capabilities"`
	LocalTime             LocalTimeInfo         `json:"local_time"`
	Storage               storageStatus         `json:"storage"`
}

type LocalTimeInfo

type LocalTimeInfo struct {
	Now           string `json:"now"`
	TimeZone      string `json:"time_zone"`
	OffsetMinutes int    `json:"offset_minutes"`
	OffsetLabel   string `json:"offset_label"`
}

type MCPCapabilityState

type MCPCapabilityState struct {
	Name            string `json:"name"`
	Status          string `json:"status"`
	Transport       string `json:"transport,omitempty"`
	ToolCount       int    `json:"tool_count,omitempty"`
	PermissionMode  string `json:"permission_mode,omitempty"`
	FailureCategory string `json:"failure_category,omitempty"`
	NextAction      string `json:"next_action,omitempty"`
}

type ObservedArtifactRef

type ObservedArtifactRef struct {
	ID        string `json:"id,omitempty"`
	SafeLabel string `json:"safe_label,omitempty"`
	URL       string `json:"url,omitempty"`
	Kind      string `json:"kind,omitempty"`
	MIME      string `json:"mime,omitempty"`
	SizeBytes int64  `json:"size_bytes,omitempty"`
	SHA256    string `json:"sha256,omitempty"`
}

type ObservedCacheSummary

type ObservedCacheSummary struct {
	Namespace            string `json:"namespace,omitempty"`
	Retention            string `json:"retention,omitempty"`
	PrefixHash           string `json:"prefix_hash,omitempty"`
	PayloadHash          string `json:"payload_hash,omitempty"`
	ToolsetID            string `json:"toolset_id,omitempty"`
	ToolsetEpoch         int    `json:"toolset_epoch,omitempty"`
	CompactionGeneration int    `json:"compaction_generation,omitempty"`
	CompactionWindowID   string `json:"compaction_window_id,omitempty"`
	CompactionEntryID    string `json:"compaction_entry_id,omitempty"`
	ReusedSegments       int    `json:"reused_segments,omitempty"`
	NewSegments          int    `json:"new_segments,omitempty"`
	CacheReadTokens      int64  `json:"cache_read_tokens,omitempty"`
	CacheWriteTokens     int64  `json:"cache_write_tokens,omitempty"`
}

type ObservedCompactionEvent

type ObservedCompactionEvent struct {
	observation.CompactionEvent
	SummaryPreview string `json:"summary_preview,omitempty"`
	Summary        string `json:"summary,omitempty"`
}

type ObservedContextProjection

type ObservedContextProjection struct {
	Messages []ObservedSessionMessage `json:"messages,omitempty"`
	Segments []ObservedContextSegment `json:"segments,omitempty"`
}

type ObservedContextSegment

type ObservedContextSegment struct {
	EntryID       string                `json:"entry_id,omitempty"`
	EntryType     sessiontree.EntryType `json:"entry_type,omitempty"`
	MessageIndex  int                   `json:"message_index"`
	Role          string                `json:"role,omitempty"`
	ToolCallID    string                `json:"tool_call_id,omitempty"`
	ToolName      string                `json:"tool_name,omitempty"`
	TokenEstimate int64                 `json:"token_estimate,omitempty"`
	ArtifactRefs  []ObservedArtifactRef `json:"artifact_refs,omitempty"`
	UIPreview     string                `json:"ui_preview,omitempty"`
}

type ObservedContextStatus

type ObservedContextStatus = observation.ContextStatus

type ObservedProviderEvent

type ObservedProviderEvent struct {
	RunID        string                         `json:"run_id,omitempty"`
	ThreadID     string                         `json:"thread_id,omitempty"`
	TurnID       string                         `json:"turn_id,omitempty"`
	Step         int                            `json:"step"`
	Type         provider.EventType             `json:"type"`
	ObservedAt   time.Time                      `json:"observed_at"`
	ResponseID   string                         `json:"response_id,omitempty"`
	Text         string                         `json:"text,omitempty"`
	Reasoning    string                         `json:"reasoning,omitempty"`
	ToolCalls    []provider.ToolCall            `json:"tool_calls,omitempty"`
	HostedResult *provider.HostedToolResultData `json:"hosted_result,omitempty"`
	Metadata     map[string]string              `json:"metadata,omitempty"`
	Reason       string                         `json:"reason,omitempty"`
	Usage        provider.Usage                 `json:"usage,omitempty"`
}

type ObservedProviderRequest

type ObservedProviderRequest struct {
	RunID                   string                          `json:"run_id,omitempty"`
	ThreadID                string                          `json:"thread_id,omitempty"`
	TurnID                  string                          `json:"turn_id,omitempty"`
	PromptScopeID           string                          `json:"prompt_scope_id,omitempty"`
	Step                    int                             `json:"step"`
	LogicalRequestID        string                          `json:"logical_request_id,omitempty"`
	Attempt                 int                             `json:"attempt,omitempty"`
	OverflowRetried         bool                            `json:"overflow_retried,omitempty"`
	Provider                string                          `json:"provider"`
	Model                   string                          `json:"model"`
	ObservedAt              time.Time                       `json:"observed_at"`
	Messages                []ObservedSessionMessage        `json:"messages"`
	Tools                   []provider.ToolDefinition       `json:"tools"`
	HostedTools             []provider.HostedToolDefinition `json:"hosted_tools,omitempty"`
	UnavailableCapabilities []string                        `json:"unavailable_capabilities,omitempty"`
	RequestEstimate         contextpolicy.RequestEstimate   `json:"request_estimate,omitempty"`
	ProjectedPressure       contextpolicy.ContextPressure   `json:"projected_context_pressure,omitempty"`
	RawSegments             []ObservedRawSegment            `json:"raw_segments,omitempty"`
	CacheSummary            ObservedCacheSummary            `json:"cache_summary,omitempty"`
}

type ObservedRawSegment

type ObservedRawSegment struct {
	ID                   string            `json:"id"`
	PromptScopeID        string            `json:"prompt_scope_id,omitempty"`
	CreatedByRunID       string            `json:"created_by_run_id,omitempty"`
	CreatedByTurnID      string            `json:"created_by_turn_id,omitempty"`
	ThreadID             string            `json:"thread_id,omitempty"`
	EntryID              string            `json:"entry_id,omitempty"`
	ParentEntryID        string            `json:"parent_entry_id,omitempty"`
	Kind                 cache.SegmentKind `json:"kind"`
	Role                 string            `json:"role,omitempty"`
	SHA256               string            `json:"sha256"`
	ByteLength           int               `json:"byte_length"`
	Epoch                int               `json:"epoch,omitempty"`
	Sequence             int64             `json:"sequence,omitempty"`
	Reused               bool              `json:"reused"`
	FragmentType         string            `json:"fragment_type,omitempty"`
	StructuredRefID      string            `json:"structured_ref_id,omitempty"`
	CompactionGeneration int               `json:"compaction_generation,omitempty"`
	CompactionWindowID   string            `json:"compaction_window_id,omitempty"`
	CompactionEntryID    string            `json:"compaction_entry_id,omitempty"`
	Fingerprint          string            `json:"fingerprint,omitempty"`
	SchemaVersion        string            `json:"schema_version,omitempty"`
	AdapterVersion       string            `json:"adapter_version,omitempty"`
	Raw                  string            `json:"raw,omitempty"`
	RawTruncated         bool              `json:"raw_truncated,omitempty"`
	RawPreview           string            `json:"raw_preview,omitempty"`
}

type ObservedSessionEntry

type ObservedSessionEntry struct {
	ID                      string                       `json:"id"`
	ParentID                string                       `json:"parent_id,omitempty"`
	ThreadID                string                       `json:"thread_id,omitempty"`
	TurnID                  string                       `json:"turn_id,omitempty"`
	Type                    sessiontree.EntryType        `json:"type"`
	CreatedAt               time.Time                    `json:"created_at"`
	Message                 ObservedSessionMessage       `json:"message,omitempty"`
	TurnStatus              sessiontree.TurnMarkerStatus `json:"turn_status,omitempty"`
	CompactionID            string                       `json:"compaction_id,omitempty"`
	PreviousCompactionID    string                       `json:"previous_compaction_id,omitempty"`
	CompactedThroughEntryID string                       `json:"compacted_through_entry_id,omitempty"`
	SummarySchemaVersion    string                       `json:"summary_schema_version,omitempty"`
	CompactionGeneration    int                          `json:"compaction_generation,omitempty"`
	CompactionWindowID      string                       `json:"compaction_window_id,omitempty"`
	FirstKeptEntryID        string                       `json:"first_kept_entry_id,omitempty"`
	KeptUserEntryIDs        []string                     `json:"kept_user_entry_ids,omitempty"`
	Summary                 string                       `json:"summary,omitempty"`
	CompactionTrigger       string                       `json:"compaction_trigger,omitempty"`
	CompactionReason        string                       `json:"compaction_reason,omitempty"`
	CompactionPhase         string                       `json:"compaction_phase,omitempty"`
	TokensBefore            int64                        `json:"tokens_before,omitempty"`
	TokensAfterEstimate     int64                        `json:"tokens_after_estimate,omitempty"`
	ContextUsageBefore      contextpolicy.Usage          `json:"context_usage_before,omitempty"`
	ContextUsageAfter       contextpolicy.Usage          `json:"context_usage_after,omitempty"`
	Error                   string                       `json:"error,omitempty"`
	Metadata                map[string]string            `json:"metadata,omitempty"`
	RawHash                 string                       `json:"raw_hash,omitempty"`
}

type ObservedSessionMessage

type ObservedSessionMessage struct {
	Role                 string                  `json:"role"`
	Content              string                  `json:"content,omitempty"`
	Reasoning            string                  `json:"reasoning,omitempty"`
	ToolCallID           string                  `json:"tool_call_id,omitempty"`
	ToolName             string                  `json:"tool_name,omitempty"`
	ToolArgs             string                  `json:"tool_args,omitempty"`
	Kind                 string                  `json:"kind,omitempty"`
	ToolResult           *ObservedToolResultView `json:"tool_result,omitempty"`
	EntryID              string                  `json:"entry_id,omitempty"`
	ParentEntryID        string                  `json:"parent_entry_id,omitempty"`
	CompactionID         string                  `json:"compaction_id,omitempty"`
	CompactionGeneration int                     `json:"compaction_generation,omitempty"`
	CompactionWindowID   string                  `json:"compaction_window_id,omitempty"`
}

type ObservedToolResultView

type ObservedToolResultView struct {
	Truncated     bool                 `json:"truncated,omitempty"`
	OriginalBytes int                  `json:"original_bytes,omitempty"`
	VisibleBytes  int                  `json:"visible_bytes,omitempty"`
	OriginalLines int                  `json:"original_lines,omitempty"`
	VisibleLines  int                  `json:"visible_lines,omitempty"`
	Strategy      string               `json:"strategy,omitempty"`
	ContentSHA256 string               `json:"content_sha256,omitempty"`
	FullOutput    *ObservedArtifactRef `json:"full_output,omitempty"`
}

type PackageSummary

type PackageSummary struct {
	Name       string  `json:"name"`
	Status     string  `json:"status"`
	ElapsedSec float64 `json:"elapsed_sec,omitempty"`
	Tests      int     `json:"tests,omitempty"`
	Passed     int     `json:"passed,omitempty"`
	Failed     int     `json:"failed,omitempty"`
	Skipped    int     `json:"skipped,omitempty"`
}

type ProviderProfile

type ProviderProfile struct {
	ID           string               `json:"id"`
	Name         string               `json:"name"`
	Provider     string               `json:"provider"`
	Model        string               `json:"model"`
	BaseURL      string               `json:"base_url,omitempty"`
	APIKey       string               `json:"api_key,omitempty"`
	APIKeySet    bool                 `json:"api_key_set,omitempty"`
	FakeResponse string               `json:"fake_response,omitempty"`
	WebSearch    searchcap.Capability `json:"web_search,omitempty"`
}

type RunRequest

type RunRequest struct {
	Target    string `json:"target"`
	ProfileID string `json:"profile_id,omitempty"`
}

type RunResponse

type RunResponse struct {
	ID         string           `json:"id"`
	Target     string           `json:"target"`
	Title      string           `json:"title"`
	Kind       string           `json:"kind"`
	Status     string           `json:"status"`
	StartedAt  time.Time        `json:"started_at"`
	FinishedAt time.Time        `json:"finished_at"`
	DurationMS int64            `json:"duration_ms"`
	Summary    string           `json:"summary"`
	Command    []string         `json:"command,omitempty"`
	ExitCode   int              `json:"exit_code,omitempty"`
	Output     string           `json:"output,omitempty"`
	Error      string           `json:"error,omitempty"`
	Packages   []PackageSummary `json:"packages,omitempty"`
	TestTotals TestTotals       `json:"test_totals,omitempty"`
	Agent      *AgentRun        `json:"agent,omitempty"`
	Parts      []RunResponse    `json:"parts,omitempty"`
}

type Runner

type Runner struct {
	Root                 string
	EnvFile              string
	Now                  func() time.Time
	Exec                 func(context.Context, string, []string, string, []string) ([]byte, int)
	ProviderFactory      func(config.Config) (provider.Provider, error)
	TitleProviderFactory func(config.Config) (provider.Provider, error)
	Sessions             *agentSessionRegistry
	StorageMode          string
	StoragePath          string
	// contains filtered or unexported fields
}

func NewRunner

func NewRunner(root string) Runner

func (*Runner) AgentSession

func (r *Runner) AgentSession(ctx context.Context, sessionID string) (AgentSessionSnapshot, error)

func (*Runner) AgentSessions

func (r *Runner) AgentSessions(ctx context.Context) []AgentSessionSnapshot

func (Runner) Catalog

func (r Runner) Catalog() []CatalogProvider

func (*Runner) ConfigInfo

func (r *Runner) ConfigInfo() ConfigInfo

func (*Runner) ConfigState

func (r *Runner) ConfigState() (ConfigState, error)

func (*Runner) CreateAgentSession

func (r *Runner) CreateAgentSession(ctx context.Context, req AgentRunRequest) AgentRunResponse

func (*Runner) CreateIdleAgentSession

func (r *Runner) CreateIdleAgentSession(ctx context.Context, req AgentRunRequest) (AgentSessionSnapshot, error)

func (*Runner) DeleteAgentSession

func (r *Runner) DeleteAgentSession(ctx context.Context, sessionID string) error

func (*Runner) InstallSkill

func (r *Runner) InstallSkill(ctx context.Context, req SkillInstallRequest) (SkillInstallResponse, error)

func (*Runner) PreviewSkillInstall

func (r *Runner) PreviewSkillInstall(ctx context.Context, req SkillInstallPreviewRequest) (SkillInstallPreview, error)

func (Runner) Run

func (r Runner) Run(ctx context.Context, target string) RunResponse

func (*Runner) RunAgent

func (r *Runner) RunAgent(ctx context.Context, req AgentRunRequest) AgentRunResponse

func (*Runner) RunAgentTurn

func (r *Runner) RunAgentTurn(ctx context.Context, sessionID string, req AgentTurnRequest) AgentRunResponse

func (*Runner) RunAgentTurnStream

func (r *Runner) RunAgentTurnStream(ctx context.Context, sessionID string, req AgentTurnRequest, sink AgentStreamSink) AgentRunResponse

func (*Runner) RunInterfaceProbe

func (r *Runner) RunInterfaceProbe(ctx context.Context, req AgentInterfaceProbeRequest) AgentRunResponse

func (Runner) RunWithOptions

func (r Runner) RunWithOptions(ctx context.Context, target string, opts runOptions) RunResponse

func (*Runner) SaveConfigState

func (r *Runner) SaveConfigState(req SaveConfigRequest) (ConfigState, error)

func (*Runner) UpdateAgentSessionTools

func (r *Runner) UpdateAgentSessionTools(ctx context.Context, sessionID string, req AgentToolsUpdateRequest) (AgentSessionSnapshot, error)

type SaveConfigRequest

type SaveConfigRequest struct {
	ActiveProfileID string             `json:"active_profile_id"`
	Profiles        []ProviderProfile  `json:"profiles"`
	SearchProvider  SaveSearchProvider `json:"search_provider,omitempty"`
}

type SaveSearchProvider

type SaveSearchProvider struct {
	Provider string  `json:"provider,omitempty"`
	APIKey   string  `json:"api_key,omitempty"`
	Endpoint *string `json:"endpoint,omitempty"`
}

type SearchProviderInfo

type SearchProviderInfo struct {
	Provider    string `json:"provider"`
	APIKeySet   bool   `json:"api_key_set"`
	Endpoint    string `json:"endpoint,omitempty"`
	EnvKey      string `json:"env_key"`
	EndpointKey string `json:"endpoint_key"`
	Capability  string `json:"capability"`
}

type SearchWireShape

type SearchWireShape struct {
	ID    string `json:"id"`
	Title string `json:"title"`
}

type Server

type Server struct {
	Runner  Runner
	Timeout time.Duration
	// contains filtered or unexported fields
}

func NewServer

func NewServer(r Runner) (*Server, error)

func (*Server) Handler

func (s *Server) Handler() http.Handler

type SkillCapabilityState

type SkillCapabilityState struct {
	Name         string `json:"name"`
	Description  string `json:"description,omitempty"`
	SourceKind   string `json:"source_kind,omitempty"`
	SourceLabel  string `json:"source_label,omitempty"`
	RelativePath string `json:"relative_path,omitempty"`
	ContentHash  string `json:"content_hash,omitempty"`
	License      string `json:"license,omitempty"`
	Status       string `json:"status"`
}

type SkillInstallFile

type SkillInstallFile struct {
	Path  string `json:"path"`
	Bytes int64  `json:"bytes"`
}

type SkillInstallPreview

type SkillInstallPreview struct {
	URL             string             `json:"url"`
	PreviewToken    string             `json:"preview_token"`
	Repo            string             `json:"repo"`
	Ref             string             `json:"ref"`
	SourcePath      string             `json:"source_path"`
	Name            string             `json:"name"`
	Description     string             `json:"description"`
	License         string             `json:"license,omitempty"`
	Files           []SkillInstallFile `json:"files"`
	TotalBytes      int64              `json:"total_bytes"`
	TargetPath      string             `json:"target_path"`
	ExistingHash    string             `json:"existing_hash,omitempty"`
	ContentHash     string             `json:"content_hash"`
	RequiresReplace bool               `json:"requires_replace"`
}

type SkillInstallPreviewRequest

type SkillInstallPreviewRequest struct {
	URL string `json:"url"`
}

type SkillInstallRequest

type SkillInstallRequest struct {
	URL          string `json:"url"`
	PreviewToken string `json:"preview_token"`
	Replace      bool   `json:"replace,omitempty"`
}

type SkillInstallResponse

type SkillInstallResponse struct {
	Skill        SkillInstallPreview `json:"skill"`
	Capabilities CapabilityState     `json:"capabilities"`
	SourceRoot   string              `json:"source_root"`
	EnvUpdated   bool                `json:"env_updated"`
}

type SkillSourceState

type SkillSourceState struct {
	Root       string `json:"root"`
	Kind       string `json:"kind"`
	Label      string `json:"label,omitempty"`
	Enabled    bool   `json:"enabled"`
	Managed    bool   `json:"managed"`
	SkillCount int    `json:"skill_count,omitempty"`
}

type StateTransition

type StateTransition struct {
	At      time.Time `json:"at"`
	Step    int       `json:"step,omitempty"`
	From    string    `json:"from"`
	To      string    `json:"to"`
	Reason  string    `json:"reason,omitempty"`
	Details string    `json:"details,omitempty"`
}

type TestTotals

type TestTotals struct {
	Packages int `json:"packages"`
	Tests    int `json:"tests"`
	Passed   int `json:"passed"`
	Failed   int `json:"failed"`
	Skipped  int `json:"skipped"`
}