Class: KairosMcp::Tools::KnowledgeGet

Inherits:
BaseTool
  • Object
show all
Defined in:
lib/kairos_mcp/tools/knowledge_get.rb

Instance Method Summary collapse

Methods inherited from BaseTool

#harness_requirement, #initialize, #invoke_tool, #to_full_schema, #to_schema

Constructor Details

This class inherits a constructor from KairosMcp::Tools::BaseTool

Instance Method Details

#call(arguments) ⇒ Object 



68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
 
# File 'lib/kairos_mcp/tools/knowledge_get.rb', line 68

def call(arguments)
  name = arguments['name']
  return text_content("Error: name is required") unless name && !name.empty?

  provider = KnowledgeProvider.new(nil, user_context: @safety&.current_user)
  skill = provider.get(name)

  if skill.nil?
    available = provider.list.map { |s| s[:name] }.join(', ')
    return text_content("Knowledge '#{name}' not found. Available: #{available}")
  end

  output = build_output(skill, arguments, provider)
  # INV-A detection floor: reading L1 knowledge "in order to act upon" is a
  # point of reliance. Surface any divergence from the recorded provenance
  # here — never silently. Scoped to main-dir L1 (external SkillSet
  # knowledge has no chain provenance and would false-positive).
  banner = correspondence_banner(skill, provider)
  text_content(banner ? banner + output : output)
end

#category ⇒ Object 



18
19
20
 
# File 'lib/kairos_mcp/tools/knowledge_get.rb', line 18

def category
  :knowledge
end

#description ⇒ Object 



14
15
16
 
# File 'lib/kairos_mcp/tools/knowledge_get.rb', line 14

def description
  'Get the content of a specific L1 knowledge skill by name. Includes frontmatter metadata and full content.'
end

#examples ⇒ Object 



26
27
28
29
30
31
32
33
34
35
36
37
 
# File 'lib/kairos_mcp/tools/knowledge_get.rb', line 26

def examples
  [
    {
      title: 'Get knowledge content',
      code: 'knowledge_get(name: "api_guidelines")'
    },
    {
      title: 'Get knowledge with scripts',
      code: 'knowledge_get(name: "deployment_process", include_scripts: true)'
    }
  ]
end

#input_schema ⇒ Object 



43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
 
# File 'lib/kairos_mcp/tools/knowledge_get.rb', line 43

def input_schema
  {
    type: 'object',
    properties: {
      name: {
        type: 'string',
        description: 'The knowledge skill name to retrieve'
      },
      include_scripts: {
        type: 'boolean',
        description: 'Include list of scripts (default: false)'
      },
      include_assets: {
        type: 'boolean',
        description: 'Include list of assets (default: false)'
      },
      include_references: {
        type: 'boolean',
        description: 'Include list of references (default: false)'
      }
    },
    required: ['name']
  }
end

#name ⇒ Object 



10
11
12
 
# File 'lib/kairos_mcp/tools/knowledge_get.rb', line 10

def name
  'knowledge_get'
end

#related_tools ⇒ Object 



39
40
41
 
# File 'lib/kairos_mcp/tools/knowledge_get.rb', line 39

def related_tools
  %w[knowledge_list knowledge_update resource_read]
end

#usecase_tags ⇒ Object 



22
23
24
 
# File 'lib/kairos_mcp/tools/knowledge_get.rb', line 22

def usecase_tags
  %w[get read L1 knowledge detail content]
end