harness

type Adapter interface {
	Definition() Definition
}

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

type Capabilities struct {
	SessionStart      bool
	SessionEnd        bool
	RunningIdle       bool
	WaitingPermission bool
	ProcessIdentity   bool
	NativeCatalog     bool
	TTYTmuxContext    bool
}

type CommandHookInstallSpec struct {
	Event   string
	Matcher string
	Command string
}

type CursorCommandHookInstallSpec struct {
	Event   string
	Command string
}

type CursorJSONHookInstallPlan struct {
	Path        string
	Source      string
	Label       string
	ConfigLabel string
	Hooks       []CursorCommandHookInstallSpec
}

type CursorJSONHooksAction struct {
	Plan CursorJSONHookInstallPlan
}

type Definition struct {
	ID                 registry.Harness
	Aliases            []string
	ProcessNames       []string
	Env                EnvKeys
	Capabilities       Capabilities
	IntegrationVersion int
}

type EnvField string

type EnvKeys struct {
	SessionID   []string
	SessionPath []string
	ProjectRoot []string
	PID         []string
	Event       []string
}

type HookAdapter interface {
	HandleHook(invocation HookInvocation) HookResult
}

type HookInvocation struct {
	Event      string
	RawPayload json.RawMessage
	Payload    map[string]any
	ParentArgs []string
}

type HookPayloadValidator func(json.RawMessage) bool

type HookResult struct {
	Report   registry.Observation
	ReportOK bool
	Response map[string]any
}

type HookTransition string

type ImportManifestInstallPlan struct {
	Path       string
	Name       string
	Source     string
	Components []string
}

type InstallAction interface {
	// contains filtered or unexported methods
}

type InstallAdvisor interface {
	InstallNextStep(changed bool, dryRun bool) string
	StatusNextStep(current bool, stale bool) string
}

type InstallPlan struct {
	Actions []InstallAction
}

type Installable interface {
	InstallPlan(binary string) InstallPlan
}

type JSONCommandHookInstallPlan struct {
	Path              string
	Source            string
	Label             string
	ConfigLabel       string
	StatusMessage     string
	OmitStatusMessage bool
	HooksAtRoot       bool
	Hooks             []CommandHookInstallSpec
}

type JSONCommandHooksAction struct {
	Plan JSONCommandHookInstallPlan
}

type ManagedTextBlockAction struct {
	Plan ManagedTextBlockInstallPlan
}

type ManagedTextBlockInstallPlan struct {
	Path        string
	Label       string
	ConfigLabel string
	StartMarker string
	EndMarker   string
	Block       string
}

type PayloadAdapter interface {
	PayloadCompatible(rawPayload json.RawMessage) bool
	PayloadDefaults(payload map[string]any) (PayloadDefaults, error)
}

type PayloadDefaults struct {
	SessionID   string
	SessionPath string
	CWD         string
	ProjectRoot string
	Event       string
	Attributes  map[string]string
}

type PluginDirectoryAction struct {
	Plan PluginDirectoryInstallPlan
}

type PluginDirectoryInstallPlan struct {
	Dir            string
	Label          string
	Files          []RenderedFileInstallSpec
	SnippetOrder   []string
	MarkerFile     string
	ObsoleteFiles  []string
	ImportManifest *ImportManifestInstallPlan
	Registration   PluginRegistration
}

type PluginRegistration interface {
	ID() string
	Label() string
	Inspect(ctx context.Context, pluginDir string) (PluginRegistrationState, error)
	EnsureMutable(pluginDir string) error
	Install(ctx context.Context, pluginDir string) error
	CleanupFailedInstall(ctx context.Context, previousState PluginRegistrationState, pluginDir string) error
	Remove(ctx context.Context, pluginDir string) error
}

type PluginRegistrationState uint8

type RenderedFileAction struct {
	Plan RenderedFileInstallPlan
}

type RenderedFileInstallPlan struct {
	Path        string
	Label       string
	ConfigLabel string
	Content     string
	JSONContent any
}

type RenderedFileInstallSpec struct {
	Name        string
	Content     string
	JSONContent any
}

type RenderedFilesAction struct {
	Plan RenderedFilesInstallPlan
}

type RenderedFilesInstallPlan struct {
	Dir          string
	Label        string
	ConfigLabel  string
	Files        []RenderedFileInstallSpec
	SnippetOrder []string
}

type Resumable interface {
	ResumeCommand(sessionID string, sessionPath string) []string
}

type ScreenManifestProvider interface {
	ScreenManifest() string
}

type ShimAction struct{}

type Transition interface {
	registry.Activity | registry.Presence | HookTransition
}