refactor(agent): polishing

Author: roxblnfk

src/agent/src/agent.lua

@@ -504,6 +504,32 @@ function agent:step(prompt_builder, runtime_options)
         options.stream = runtime_options.stream_target
     end
 
+    --if has_tools_with_schemas(self.tools) then
+    --    options.tools = extract_tool_schemas_for_llm(self.tools)
+    --
+    --    -- DEBUG: Print tools being sent to LLM
+    --    print("=== TOOLS SENT TO LLM ===")
+    --    for i, tool in ipairs(options.tools) do
+    --        print(string.format("Tool %d: %s", i, tool.name))
+    --        print("  Description:", tool.description or "nil")
+    --        print("  Registry ID:", tool.registry_id or "nil")
+    --        if tool.meta then
+    --            local meta_keys = {}
+    --            for k, _ in pairs(tool.meta) do
+    --                table.insert(meta_keys, k)
+    --            end
+    --            print("  Meta keys:", table.concat(meta_keys, ", "))
+    --            print("  Meta content:", json.encode(tool.meta))
+    --        else
+    --            print("  Meta: nil")
+    --        end
+    --        print("  Schema present:", tool.schema and "yes" or "no")
+    --        print("---")
+    --    end
+    --    print("=== END TOOLS DEBUG ===")
+    --end
+
+
     local result, err = llm_instance.generate(final_messages, options)
     if err then
         return nil, err

src/agent/src/compiler/compiler.lua

@@ -296,21 +296,25 @@ local function process_tools(raw_spec, additional_tools, trait_contexts, trait_t
             tool_entry.description = tool_info.description or ("Inline tool: " .. canonical_name)
             tool_entry.schema = tool_info.inline_schema
             tool_entry.registry_id = nil
+            tool_entry.meta = {}
         else
             if trait_tool_schemas[canonical_name] then
                 tool_entry.description = tool_info.description or trait_tool_schemas[canonical_name].description or ("Trait tool: " .. canonical_name)
                 tool_entry.schema = trait_tool_schemas[canonical_name].schema
                 tool_entry.registry_id = tool_info.id
+                tool_entry.meta = trait_tool_schemas[canonical_name].meta or {}
             else
                 local original_schema, err = get_tools().get_tool_schema(tool_info.id)
                 if original_schema then
                     tool_entry.description = tool_info.description or original_schema.description
                     tool_entry.schema = original_schema.schema
                     tool_entry.registry_id = tool_info.id
+                    tool_entry.meta = original_schema.meta or {}
                 else
                     tool_entry.description = tool_info.description or ("Tool: " .. canonical_name)
                     tool_entry.schema = nil
                     tool_entry.registry_id = tool_info.id
+                    tool_entry.meta = {}
                 end
             end
         end

src/agent/src/discovery/tools.lua

@@ -131,6 +131,36 @@ local function run_input_schema_processors(input_schema, tool_id)
     return input_schema
 end
 
+-- Filter out meta fields that are already extracted for LLM tool construction
+local function filter_meta_for_llm(meta)
+    if not meta then
+        return {}
+    end
+
+    local filtered = {}
+
+    -- Fields already extracted and used in tool construction, exclude them
+    local excluded_fields = {
+        input_schema = true,
+        llm_description = true,
+        llm_descirtion = true,  -- typo variant
+        llm_alias = true,
+        title = true,
+        description = true,
+        comment = true,
+        type = true,  -- tool type marker, not needed by LLM
+        name = true   -- if present, already used
+    }
+
+    for key, value in pairs(meta) do
+        if not excluded_fields[key] then
+            filtered[key] = value
+        end
+    end
+
+    return filtered
+end
+
 -- Get the LLM-friendly tool name
 function tool_resolver.get_tool_name(entry)
     -- If llm_alias is specified, use that
@@ -222,7 +252,7 @@ function tool_resolver.get_tool_schema(tool_id)
         title = entry.meta.title or display_name,
         description = description,
         schema = run_input_schema_processors(schema, tool_id), -- Process input schema (cached separately)
-        meta = entry.meta
+        meta = filter_meta_for_llm(entry.meta) -- Filter out redundant fields
     }
 
     return tool
@@ -330,7 +360,7 @@ function tool_resolver.find_tools(criteria)
     -- Add additional criteria
     if criteria then
         if criteria.namespace then
-            query[".ns"] = criteria.namespace  -- ← FIXED: Use .ns instead of ~namespace
+            query[".ns"] = criteria.namespace  -- ↠FIXED: Use .ns instead of ~namespace
         end
 
         if criteria.tags and #criteria.tags > 0 then