search

type ActionDef struct {
	ID       string
	Title    string
	Keywords string
	Scope    Scope
	Ability  string
	Confirm  bool
	Href     string
	// MCPTool is the MCP tool that performs the action; empty when none exists.
	MCPTool string
	// MCPNeeds are inputs the agent must supply on top of the target name.
	MCPNeeds []string
}

type ActionInfo struct {
	ID      string `json:"id"`
	Ability string `json:"ability"`
	Confirm bool   `json:"confirm"`
	// MCPTool, MCPArgs and MCPNeeds say which MCP tool runs this action, with
	// which arguments filled in, and which inputs the agent must still supply.
	MCPTool  string            `json:"mcp_tool,omitempty"`
	MCPArgs  map[string]string `json:"mcp_args,omitempty"`
	MCPNeeds []string          `json:"mcp_needs,omitempty"`
}

type ActionsProvider struct {
	AppNames      func(ctx context.Context) ([]string, error)
	DatabaseNames func(ctx context.Context) ([]string, error)
}

type Authorizer interface {
	Allowed(prefix, name, ability string) bool
}

type Caller struct {
	PrincipalID string
	Authz       Authorizer
}

type DB interface {
	ExecContext(ctx context.Context, query string, args ...any) (sql.Result, error)
	QueryContext(ctx context.Context, query string, args ...any) (*sql.Rows, error)
	QueryRowContext(ctx context.Context, query string, args ...any) *sql.Row
	BeginTx(ctx context.Context, opts *sql.TxOptions) (*sql.Tx, error)
}

type Doc struct {
	Ref       string
	Kind      Kind
	Title     string
	Body      string
	Tags      []string
	App       string
	Env       string
	Node      string
	Prefix    string
	Name      string
	Ability   string
	Confirm   bool
	Href      string
	ActionID  string
	UpdatedAt time.Time
}

type Hit struct {
	Ref        string      `json:"ref"`
	Kind       Kind        `json:"kind"`
	Title      string      `json:"title"`
	Subtitle   string      `json:"subtitle,omitempty"`
	AppName    string      `json:"app_name,omitempty"`
	Env        string      `json:"env,omitempty"`
	NodeName   string      `json:"node_name,omitempty"`
	Tags       []string    `json:"tags,omitempty"`
	Href       string      `json:"href,omitempty"`
	TitleSpans []Span      `json:"title_spans,omitempty"`
	Score      float64     `json:"score"`
	Action     *ActionInfo `json:"action,omitempty"`
}

type Kind string

type Provider interface {
	Kind() Kind
	Docs(ctx context.Context) ([]Doc, error)
}

type Query struct {
	Text []string
	App  string
	Env  string
	Tag  string
	Node string
	Kind Kind
}

type Request struct {
	Q      string
	Kind   Kind
	Limit  int
	Cursor string
}

type Response struct {
	Hits       []Hit  `json:"hits"`
	NextCursor string `json:"next_cursor,omitempty"`
	Total      int    `json:"total"`
}

type Saved struct {
	ID        string    `json:"id"`
	Name      string    `json:"name"`
	Query     string    `json:"query"`
	CreatedAt time.Time `json:"created_at"`
}

type Scope string

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

type Span struct {
	Start int `json:"start"`
	End   int `json:"end"`
}

type Suggestion struct {
	Text string `json:"text"`
	Kind string `json:"kind"`
	Ref  string `json:"ref,omitempty"`
}