semantic

type Adapter interface {
	Run(input ToolInput) (ToolResult, error)
}

type AdapterFactory func() Adapter

type Capabilities struct {
	Diagnostics   bool `json:"diagnostics"`
	Definition    bool `json:"definition"`
	Hover         bool `json:"hover"`
	Rename        bool `json:"rename"`
	References    bool `json:"references"`
	CodeActions   bool `json:"code_actions"`
	InlayHints    bool `json:"inlay_hints"`
	SignatureHelp bool `json:"signature_help"`
}

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

type Position struct {
	Line   int `json:"line"`
	Column int `json:"column"`
}

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

type SessionAdapter interface {
	Adapter
	// Healthy returns true if the session is still usable.
	// A false return causes the pool to close and replace the session.
	// Healthy must be safe for concurrent calls and must never block on a
	// mutex that a concurrent Run holds while the pool mutex is held — the
	// pool calls Healthy outside its own lock for exactly this reason.
	Healthy() bool
	// Close tears down the session and releases its resources.
	// Close must be idempotent and safe for concurrent calls: the pool may
	// close a session from multiple paths (eviction, TTL recycle, unhealthy
	// replacement) even while another goroutine is inside Healthy.
	Close() error
}

type SessionFactory func(workspaceRoot string) (SessionAdapter, error)

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

type ToolCodeAction struct {
	Title string               `json:"title"` // human-readable label like "Add import", "Organize imports"
	Kind  string               `json:"kind"`  // "quickfix", "refactor.extract", "source.organizeImports", etc
	Edits []ToolCodeActionEdit `json:"edits"`
}

type ToolCodeActionEdit struct {
	FilePath string `json:"filePath"`
	From     int    `json:"from"` // 0-based byte offset
	To       int    `json:"to"`   // 0-based byte offset
	NewText  string `json:"newText"`
}

type ToolDefinition struct {
	Path   string `json:"path"`
	Line   int    `json:"line"`
	Column int    `json:"column"`
}

type ToolDiagnostic struct {
	From     int    `json:"from"`
	To       int    `json:"to"`
	Severity string `json:"severity"`
	Message  string `json:"message"`
	Source   string `json:"source"`
}

type ToolHover struct {
	Contents    string `json:"contents"` // Markdown content
	StartLine   int    `json:"start_line,omitempty"`
	StartColumn int    `json:"start_column,omitempty"`
	EndLine     int    `json:"end_line,omitempty"`
	EndColumn   int    `json:"end_column,omitempty"`
}

type ToolInlayHint struct {
	From  int    `json:"from"`  // 0-based byte offset where hint is displayed
	To    int    `json:"to"`    // 0-based byte offset (end of hint range, typically From)
	Label string `json:"label"` // text to display
	Kind  string `json:"kind"`  // "type", "parameter", or "none"
}

type ToolInput struct {
	WorkspaceRoot string    `json:"workspaceRoot"`
	FilePath      string    `json:"filePath"`
	Content       string    `json:"content"`
	Method        string    `json:"method"`
	Position      *Position `json:"position,omitempty"`
	// Trigger distinguishes how the request was initiated.
	// "edit" means an in-progress keystroke; "save" means an explicit save.
	// Adapters may use this to skip expensive checks on "edit" (e.g. go vet).
	Trigger string `json:"trigger,omitempty"`
}

type ToolReferenceLocation struct {
	FilePath string `json:"filePath"`
	Line     int    `json:"line"`     // 1-based line number
	StartCol int    `json:"startCol"` // 1-based start column
	EndCol   int    `json:"endCol"`   // 1-based end column
	LineText string `json:"lineText"`
}

type ToolReferences struct {
	Locations []ToolReferenceLocation `json:"locations"`
	// SymbolName is the resolved name of the referenced symbol.
	SymbolName string `json:"symbolName"`
}

type ToolRename struct {
	Locations []ToolRenameLocation `json:"locations"`
}

type ToolRenameLocation struct {
	FilePath string `json:"filePath"`
	From     int    `json:"from"` // 0-based byte offset
	To       int    `json:"to"`   // 0-based byte offset
}

type ToolResult struct {
	Capabilities  Capabilities       `json:"capabilities"`
	Diagnostics   []ToolDiagnostic   `json:"diagnostics,omitempty"`
	Definition    *ToolDefinition    `json:"definition,omitempty"`
	Hover         *ToolHover         `json:"hover,omitempty"`
	Rename        *ToolRename        `json:"rename,omitempty"`
	References    *ToolReferences    `json:"references,omitempty"`
	CodeActions   []ToolCodeAction   `json:"code_actions,omitempty"`
	InlayHints    []ToolInlayHint    `json:"inlay_hints,omitempty"`
	SignatureHelp *ToolSignatureHelp `json:"signature_help,omitempty"`
	Error         string             `json:"error,omitempty"`
	// DurationMs is the wall-clock time the adapter took to run, in milliseconds.
	// Populated by the registry dispatch layer, not by individual adapters.
	DurationMs int64 `json:"duration_ms,omitempty"`
}

type ToolSignatureHelp struct {
	Signatures      []ToolSignatureHelpSignature `json:"signatures"`
	ActiveSignature int                          `json:"activeSignature"`
	ActiveParameter int                          `json:"activeParameter"`
}

type ToolSignatureHelpParameter struct {
	Label         string `json:"label"`
	Documentation string `json:"documentation,omitempty"`
}

type ToolSignatureHelpSignature struct {
	Label         string                       `json:"label"`
	Documentation string                       `json:"documentation,omitempty"`
	Parameters    []ToolSignatureHelpParameter `json:"parameters"`
}