assist

type AgentExitError struct {
	ExitCode int
	Agent    string
}

type AnswersFile struct {
	SchemaVersion   int            `yaml:"schema_version" json:"schema_version"`
	Name            string         `yaml:"name" json:"name"`
	Task            string         `yaml:"task" json:"task"`
	TemplateVersion string         `yaml:"template_version,omitempty" json:"template_version"`
	SlingVersion    string         `yaml:"sling_version" json:"sling_version"`
	Created         time.Time      `yaml:"created" json:"created"`
	Agent           string         `yaml:"agent" json:"agent"`
	Parent          string         `yaml:"parent,omitempty" json:"parent"`
	Cwd             string         `yaml:"cwd" json:"cwd"`
	Answers         map[string]any `yaml:"answers" json:"answers"`
}

type AuthStatus string

type CellState int

type CheckResult struct {
	State CellState `json:"state"`
	Skill string    `json:"skill,omitempty"` // set for per-skill checks
	Note  string    `json:"note,omitempty"`  // short detail, no glyph
}

type Client interface {
	Name() string
	Kind() ClientKind
	Detect() bool
	WriteSkills(ctx context.Context, skillNames []string, scope Scope) error
	RemoveSkills(ctx context.Context, skillNames []string, scope Scope) error
	WriteMCP(ctx context.Context, scope Scope) error
	RemoveMCP(ctx context.Context, scope Scope) error
	// CheckSkills returns one typed result per skill (no glyph prefixes).
	CheckSkills(ctx context.Context, skillNames []string, scope Scope) []CheckResult
	// CheckMCP returns a typed MCP wiring status.
	CheckMCP(ctx context.Context, scope Scope) CheckResult
	// AuthState reports offline credential-file / env-key presence. Never launches a binary.
	AuthState() AuthStatus
}

type ClientKind int

type ClientResult struct {
	Name        string
	Kind        ClientKind
	WroteSkills bool
	WroteMCP    bool
	Authed      AuthStatus
	Notes       string
}

type DoctorFinding struct {
	ID      string `json:"id"`
	OK      bool   `json:"ok"`
	Summary string `json:"summary"`
	Detail  string `json:"detail,omitempty"`
	Hint    string `json:"hint,omitempty"`
}

type DoctorMatrix struct {
	Clients []string    `json:"clients"`
	Rows    []MatrixRow `json:"rows"`
}

type DoctorOptions struct {
	Scope Scope // must match install scope under test
}

type DoctorReport struct {
	OK           bool            `json:"ok"`
	SlingVersion string          `json:"sling_version"`
	Findings     []DoctorFinding `json:"findings"`
	Matrix       *DoctorMatrix   `json:"matrix,omitempty"`
	Lines        []string        `json:"-"` // CLI glyph prose
}

type Entry struct {
	ID      string
	Path    string
	Answers AnswersFile
	Meta    Meta
}

type ErrorLookupResult struct {
	Signature   string `json:"signature"`              // compact 8 or 16 hex
	PatternID   string `json:"pattern_id,omitempty"`   // first 8 of composite
	EdgeID      string `json:"edge_id,omitempty"`      // last 8 when full composite
	PatternOnly bool   `json:"pattern_only,omitempty"` // true when caller passed 8 hex
	Status      string `json:"status"`                 // known_config | known_bug | pending | unknown
	Title       string `json:"title,omitempty"`
	Guidance    string `json:"guidance,omitempty"`
	DocsURL     string `json:"docs_url,omitempty"`
	FixedIn     string `json:"fixed_in,omitempty"`
	IssueURL    string `json:"issue_url,omitempty"`
}

type FailureFooterOpts struct {
	ExecID   string
	ErrMsg   string
	SignMeta SignMeta
}

type FailureSnapshot struct {
	ExecID     string
	ErrMsg     string
	ConfigPath string // replication / pipeline config path when known
	ConnName   string // connection name for `sling conns test|discover`
	Rows       string
	Duration   string
	// RunLog is the captured log tail (env.RecentLogs). Written to stderr.log.
	RunLog string
	// ConfigBody is the replication/pipeline config file content. Written to
	// config.snapshot.yaml when set. Not used for conns test/discover.
	ConfigBody string
	// SignMeta optional connector types for error_signature.
	SignMeta SignMeta
	// Extra is merged into meta.json as-is (connector types, etc.).
	Extra map[string]any
}

type HarnessConfirmResult struct {
	Agent        string
	HintInErrors bool
	Scope        string
	Components   []string
}

type InstallFormResult struct {
	Agent        string
	HintInErrors bool
	Scope        string
}

type InstallOptions struct {
	Reconfigure    bool
	SkillsOnly     bool
	MCPOnly        bool
	Scope          Scope
	NonInteractive bool
	DefaultAgent   string // used only on non-interactive first-run
}

type InstallResult struct {
	ProfileWritten     bool
	CanonicalSkillsDir string
	WiredClients       []ClientResult
	SkippedClients     []string // not detected
}

type LandingKind string

type LaunchOptions struct {
	Agent      string
	Prompt     string
	PromptPath string
	Model      string
	SessionID  string // pre-assigned harness id (claude, grok)
}

type LocalExec struct {
	ID         string
	When       time.Time
	Status     string // "ok" | "err" | "?"
	ConfigPath string // replication / pipeline config path
	ConnName   string // connection name for conns test/discover
	Rows       string
	Duration   string
	LogDir     string // absolute path to the exec's snapshot dir
}

type MatrixRow struct {
	Label string               `json:"label"`
	Cells map[string]CellState `json:"cells"` // client name → state
	Notes map[string]string    `json:"notes,omitempty"`
}

type Meta struct {
	ID               string         `json:"id"`
	Task             string         `json:"task"`
	Agent            string         `json:"agent"`
	Model            string         `json:"model,omitempty"`
	HarnessSessionID string         `json:"harness_session_id,omitempty"`
	LaunchedAt       *time.Time     `json:"launched_at"`
	Doctor           map[string]any `json:"doctor,omitempty"`
	Parent           string         `json:"parent,omitempty"`
}

type Paths struct {
	SlingHome string
	UserHome  string
	CWD       string
}

type ProbeConn struct {
	Name   string
	Type   string
	Source string
}

type ProbeOptions struct {
	Ask            string
	IncludeFailure bool
	ExecID         string // target this exec instead of the latest failure
}

type Profile struct {
	Agent               string `yaml:"agent" json:"agent"`                                           // claude | codex | … | auto
	HintInErrors        bool   `yaml:"hint_in_errors" json:"hint_in_errors"`                         // run-error footer
	DefaultInstallScope string `yaml:"default_install_scope,omitempty" json:"default_install_scope"` // user | project
}

type PromptContext struct {
	Version         string
	Cwd             string
	ProjectName     string
	ProjectRoot     string
	HasProject      bool
	FileCounts      map[string]int
	Connections     []ProbeConn
	ConnectionExtra int
	RecentRuns      []LocalExec
	TargetExec      *LocalExec // set by --id: investigate this failure
	MCPWired        bool
	Signature       string
	Lookup          *ErrorLookupResult
	ErrorExcerpt    string
	RunLogExcerpt   string
	Ask             string
	Suggestions     []string
	Route           string
	Agent           string
}

type ProviderChoice struct {
	Kind       string         // zen-free | anthropic | openai | google | xai
	Model      string         // provider/model
	Provider   map[string]any // opencode.json `provider` map; nil if unused
	Disclosure string         // set for zen-free
}

type RankedAgent struct {
	Name    string
	Auth    AuthStatus
	Detect  bool
	Bundled bool // true when this is the downloadable opencode fallback
	Score   int  // lower is better
}

type ReportCmd struct {
	ExecID      string
	Title       string // optional override
	Description string // optional custom context, shown above the error
	GitHub      bool
	Email       bool
	Submit      bool // skip the confirm prompt (for agents)
}

type ReportDraft struct {
	Title       string `json:"title"`
	Description string `json:"description"`
	Config      string `json:"config"`
	LogExcerpt  string `json:"log_excerpt"`
	Version     string `json:"version"`
	OS          string `json:"os"`
	SourceType  string `json:"source_type"`
	TargetType  string `json:"target_type"`
	SignatureID string `json:"signature_id"`
	Skeleton    string `json:"skeleton"`
	ExecID      string `json:"exec_id"`
	ConnName    string `json:"conn_name,omitempty"`
	// CustomDescription is caller-supplied context, shown above the error.
	CustomDescription string `json:"custom_description,omitempty"`
}

type Scope int

type SensitiveClass struct {
	// ID is a stable key for manifests (e.g. "env.yaml", "claude.json").
	ID string `json:"id"`
	// Glob is matched against absolute or home-relative paths (slash-normalized).
	// Supports * and ** suffix style via pathMatch.
	Glob string `json:"glob"`
	// Class is the sensitivity tier.
	Class Sensitivity `json:"class"`
	// Reason is a short human explanation (never contains secret values).
	Reason string `json:"reason"`
}

type Sensitivity int

type SessionOptions struct {
	Ask            string
	Name           string
	Agent          string
	Model          string
	Print          bool
	OutputFile     string
	Headless       bool
	ExecID         string // --id: investigate this failure
	ResumeID       string
	ResumeSet      bool // --resume present (empty id → picker already resolved)
	NonInteractive map[string]string
}

type SetupAction string

type SignMeta struct {
	SourceType dbio.Type // e.g. dbio.TypeDbPrometheus
	TargetType dbio.Type // e.g. dbio.TypeDbPostgres
}

type Signature struct {
	ID              string // 16 hex chars (pattern||edge)
	PatternID       string // 8 hex — skeleton only
	EdgeID          string // 8 hex — types + skeleton
	Skeleton        string // normalized message body
	PatternMaterial string // v1p|<skeleton>
	EdgeMaterial    string // v1e|<source>|<target>|<skeleton>
	ShortLabel      string // human-only slug (not hashed)
	Algorithm       string // e.g. v1
	Meta            SignMeta
}

type UninstallOptions struct {
	All            bool
	SkillsOnly     bool
	MCPOnly        bool
	Scope          Scope
	NonInteractive bool
	IncludeClients []string // empty = all detected
}