kairos-chain 3.28.1 → 3.28.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 603eca51c926a1987575ae63a1266a34840fc59e7a3603685e03c37676ba23ba
-  data.tar.gz: c4da91a87396d878a62465219d80fa4e26219766f4ca8389ea132a0c7828d873
+  metadata.gz: 1ff86076f5769d3e1a773ad792416fddb4198df5c979159fafc353ec49a57bc0
+  data.tar.gz: b05464fc1d1830246de471e5964444035de03249638c1bb2b8746d272e51f506
 SHA512:
-  metadata.gz: ea9230f6dbe43986f6a2f81c0c77a549567110dda38205d769f0802c4ccb8418db4c5dee8e3ac037ae91082eab5cb5b5d890feb823119f0182980abf92e217c9
-  data.tar.gz: 906f320cc565a68ac28d644978c35a8234d1aecc0cb50f828260d407d425f90f3f514c968c0f391e46b69f2db2842ecd33ae31ed85760d4d2b4410723f7ca509
+  metadata.gz: 4ad7dc9c3f4bad3714e56698f4e97b797e084869ae207203f077b4d2fe8eb9295f763f82b832371c990a3cd157a8b051d95aae4ea9986560a1d8ac7820bc8661
+  data.tar.gz: 3a30fbbad2d529c1f3910e902baf8117faac9516e1b8361047c47800492657a2b7ec219a961e266360b9ace6031b86ccfd85ea60584006a1ddd614e55f681bbf

data/lib/kairos_mcp/tool_registry.rb

@@ -215,6 +215,7 @@ module KairosMcp
       # Resource tools (unified access to L0/L1/L2 resources)
       register_if_defined('KairosMcp::Tools::ResourceList')
       register_if_defined('KairosMcp::Tools::ResourceRead')
+      register_if_defined('KairosMcp::Tools::ResourceRender')
 
       # L1: knowledge/ (Anthropic skills format with hash-only blockchain record)
       register_if_defined('KairosMcp::Tools::KnowledgeList')

data/lib/kairos_mcp/tools/knowledge_update.rb

@@ -12,7 +12,9 @@ module KairosMcp
       end
 
       def description
-        'Create, update, or delete L1 knowledge skills. Changes are recorded with hash references to the blockchain.'
+        'Create, update, or delete L1 knowledge skills. Changes are recorded with hash references to the blockchain. ' \
+        'NOTE: MCP stdio transport may silently drop large arguments. Keep combined content + reason under ~2 KB. ' \
+        'For larger L1 entries, trim prose or split into multiple entries.'
       end
 
       def category
@@ -105,14 +107,14 @@ module KairosMcp
       private
 
       def handle_create(provider, name, content, reason, create_subdirs)
-        return text_content("Error: content is required for create") unless content && !content.empty?
+        return text_content(content_missing_error("create", content)) unless content && !content.empty?
 
         result = provider.create(name, content, reason: reason, create_subdirs: create_subdirs)
         format_result(result, 'created')
       end
 
       def handle_update(provider, name, content, reason)
-        return text_content("Error: content is required for update") unless content && !content.empty?
+        return text_content(content_missing_error("update", content)) unless content && !content.empty?
 
         result = provider.update(name, content, reason: reason)
         format_result(result, 'updated')
@@ -123,6 +125,17 @@ module KairosMcp
         format_result(result, 'deleted')
       end
 
+      def content_missing_error(command, content)
+        if content.nil?
+          "Error: content is required for #{command}. " \
+          "The content argument arrived as nil — this often means the MCP transport silently dropped it " \
+          "because the combined argument size exceeded the client limit (~2 KB for stdio). " \
+          "Try trimming content and reason, or split into smaller entries."
+        else
+          "Error: content is required for #{command} (received empty string)"
+        end
+      end
+
       def format_result(result, action)
         if result[:success]
           output = "SUCCESS: Knowledge #{action}\n\n"

data/lib/kairos_mcp/tools/resource_render.rb

@@ -0,0 +1,187 @@
+# frozen_string_literal: true
+
+require 'open3'
+require 'timeout'
+require_relative 'base_tool'
+require_relative '../anthropic_skill_parser'
+
+module KairosMcp
+  module Tools
+    class ResourceRender < BaseTool
+      RENDER_TIMEOUT = 30
+
+      def name
+        'resource_render'
+      end
+
+      def description
+        'Execute a render script from a knowledge entry to generate an HTML asset. ' \
+        'Scripts live in knowledge/{name}/scripts/ and output HTML to assets/. ' \
+        'Data is passed via stdin as JSON. Convention: scripts named render_*.rb.'
+      end
+
+      def category
+        :resource
+      end
+
+      def usecase_tags
+        %w[render html visualize dashboard asset generate]
+      end
+
+      def examples
+        [
+          {
+            title: 'Generate review dashboard',
+            code: 'resource_render(knowledge: "multi_llm_review_workflow", ' \
+                  'script: "render_dashboard.rb", data: "{...}", open: true)'
+          },
+          {
+            title: 'Generate with custom output name',
+            code: 'resource_render(knowledge: "multi_llm_review_workflow", ' \
+                  'script: "render_dashboard.rb", data: "{...}", output: "round2.html")'
+          }
+        ]
+      end
+
+      def related_tools
+        %w[resource_list resource_read knowledge_get]
+      end
+
+      def input_schema
+        {
+          type: 'object',
+          properties: {
+            knowledge: {
+              type: 'string',
+              description: 'L1 knowledge entry name (e.g., "multi_llm_review_workflow")'
+            },
+            script: {
+              type: 'string',
+              description: 'Script filename in the knowledge scripts/ directory (e.g., "render_dashboard.rb")'
+            },
+            data: {
+              type: 'string',
+              description: 'JSON data to pass to the script via stdin'
+            },
+            output: {
+              type: 'string',
+              description: 'Output filename in assets/ (default: derived from script name, e.g., render_dashboard.rb -> dashboard.html)'
+            },
+            open: {
+              type: 'boolean',
+              description: 'Open the generated HTML in the default browser (default: false)'
+            }
+          },
+          required: %w[knowledge script data]
+        }
+      end
+
+      def call(arguments)
+        knowledge_name = arguments['knowledge']
+        script_name = arguments['script']
+        data = arguments['data']
+        output_name = arguments['output']
+        open_after = arguments['open'] || false
+
+        return text_content("Error: knowledge is required") unless knowledge_name && !knowledge_name.empty?
+        return text_content("Error: script is required") unless script_name && !script_name.empty?
+        return text_content("Error: data is required") unless data && !data.empty?
+
+        # Validate JSON
+        begin
+          JSON.parse(data)
+        rescue JSON::ParserError => e
+          return text_content("Error: invalid JSON data — #{e.message}")
+        end
+
+        # Resolve knowledge directory
+        knowledge_dir = File.join(KairosMcp.knowledge_dir(user_context: @safety&.current_user), knowledge_name)
+        unless File.directory?(knowledge_dir)
+          return text_content("Error: knowledge '#{knowledge_name}' not found")
+        end
+
+        # Security: normalize script name to prevent path traversal
+        safe_script = File.basename(script_name)
+        script_path = File.join(knowledge_dir, 'scripts', safe_script)
+        unless File.exist?(script_path)
+          return text_content("Error: script '#{safe_script}' not found in #{knowledge_name}/scripts/")
+        end
+
+        # Derive output filename
+        if output_name
+          safe_output = File.basename(output_name)
+        else
+          safe_output = safe_script
+                          .sub(/\Arender_/, '')
+                          .sub(/\.rb\z/, '.html')
+        end
+
+        # Ensure assets/ directory exists
+        assets_dir = File.join(knowledge_dir, 'assets')
+        FileUtils.mkdir_p(assets_dir)
+
+        # Execute script with data on stdin
+        stdout, stderr, status = execute_script(script_path, data, knowledge_dir)
+
+        unless status.success?
+          error_msg = "Error: script exited with code #{status.exitstatus}"
+          error_msg += "\n\nstderr:\n```\n#{stderr}\n```" unless stderr.empty?
+          return text_content(error_msg)
+        end
+
+        if stdout.nil? || stdout.empty?
+          return text_content("Error: script produced no output")
+        end
+
+        # Write output to assets/
+        output_path = File.join(assets_dir, safe_output)
+        AnthropicSkillParser.atomic_write(output_path, stdout)
+
+        # Open in browser if requested
+        if open_after
+          system('open', output_path)
+        end
+
+        uri = "knowledge://#{knowledge_name}/assets/#{safe_output}"
+        build_success_response(uri, output_path, stdout.bytesize, open_after)
+      end
+
+      private
+
+      def execute_script(script_path, data, working_dir)
+        Timeout.timeout(RENDER_TIMEOUT) do
+          Open3.capture3(
+            'ruby', script_path,
+            stdin_data: data,
+            chdir: working_dir
+          )
+        end
+      rescue Timeout::Error
+        ["", "Script execution timed out after #{RENDER_TIMEOUT}s", OpenStruct.new(success?: false, exitstatus: 124)]
+      end
+
+      def build_success_response(uri, path, size, opened)
+        output = "## Resource Rendered\n\n"
+        output += "| Property | Value |\n"
+        output += "|----------|-------|\n"
+        output += "| **URI** | `#{uri}` |\n"
+        output += "| **Path** | `#{path}` |\n"
+        output += "| **Size** | #{format_size(size)} |\n"
+        output += "| **Opened** | #{opened ? 'Yes' : 'No'} |\n\n"
+        output += "Use `resource_read(uri: \"#{uri}\")` to read the generated content.\n"
+        output += "Use `open #{path}` to view in browser." unless opened
+        text_content(output)
+      end
+
+      def format_size(bytes)
+        if bytes < 1024
+          "#{bytes} B"
+        elsif bytes < 1024 * 1024
+          "#{(bytes / 1024.0).round(1)} KB"
+        else
+          "#{(bytes / (1024.0 * 1024)).round(1)} MB"
+        end
+      end
+    end
+  end
+end

data/lib/kairos_mcp/version.rb

@@ -1,4 +1,4 @@
 module KairosMcp
-  VERSION = "3.28.1"
+  VERSION = "3.28.4"
   CHANGELOG_URL = "https://github.com/masaomi/KairosChain_2026/blob/main/CHANGELOG.md"
 end

data/templates/knowledge/multi_llm_review_workflow/multi_llm_review_workflow.md

@@ -193,7 +193,7 @@ starting** and verify each against `config/multi_llm_review.yml`:
 - [ ] Your model (orchestrator): ___
 - [ ] Agent Team Personas model: = orchestrator model (NOT a different model)
 - [ ] Subprocess CLI model: opposite Opus (4.6 if you are 4.7, vice versa)
-- [ ] Codex models: gpt-5.4 AND gpt-5.5 (both, not either/or)
+- [ ] Codex models: gpt-5.5 (default) AND gpt-5.4 (both, not either/or)
 - [ ] Cursor model: default (composer-2.5, no --model flag)
 - [ ] Total reviewer count: 5 (or 4 after orchestrator exclusion from subprocess)
 - [ ] Convergence rule: 3/5 APPROVE (full) or 3/4 APPROVE (after exclusion)
@@ -410,7 +410,7 @@ which claude 2>/dev/null && echo "claude: available" || echo "claude: NOT FOUND"
 
 | Tool | Command | Prompt Input | Output Collection | Model |
 |------|---------|-------------|-------------------|-------|
-| **Codex** | `codex exec` | stdin pipe: `cat prompt.md \| codex exec -` | `-o /path/output.md` | GPT-5.4 (default) |
+| **Codex** | `codex exec` | stdin pipe: `cat prompt.md \| codex exec -` | `-o /path/output.md` | GPT-5.5 (default) |
 | **Cursor Agent** | `agent -p` | File reference (stdin NOT supported) | stdout redirect: `> output.md` | Composer-2.5 (default) |
 | **Claude Code** | Agent tool (internal) | Direct prompt string | Write to workspace file | Opus 4.6 (session) |
 | **Claude CLI (4.7)** | `claude -p --model claude-opus-4-7 --bare` | stdin pipe: `cat prompt.md \| claude -p --model claude-opus-4-7 --bare` | stdout redirect: `> output.md` | Opus 4.7 |
@@ -426,7 +426,7 @@ Based on cross-evaluation experiment (7 models × 4 tasks + Nomic, 518 CLI calls
 | **Reviewer: Claude CLI** | Opus 4.7 | `--effort low` | Evaluator quality is effort-independent (low≈high: 8.35 vs 8.16) |
 | **Coding sub-agent** | Opus 4.7 | `--effort medium` | Cost-effective default; use `high` for complex tasks |
 | **Design sub-agent** | Opus 4.7 | `--effort medium` | Cost-effective default; use `high` for complex tasks |
-| **Codex** | GPT-5.4 | (no flag) | Fixed effort |
+| **Codex** | GPT-5.5 (default) | (no flag) | Fixed effort |
 | **Cursor Agent** | Composer-2.5 | (no flag) | Fixed effort |
 
 Key findings:
@@ -709,7 +709,7 @@ Step 1: Generate review prompt
 Step 2: Detect environment and models
   - Run: which codex && which agent && which claude
   - Detect default models
-  - Report: "Auto mode: Codex (gpt-5.4), Agent (composer-2.5), Claude (opus-4.6), Claude CLI (opus-4.7)"
+  - Report: "Auto mode: Codex (gpt-5.5), Agent (composer-2.5), Claude (opus-4.6), Claude CLI (opus-4.7)"
 
 Step 3: Execute N reviews in parallel (default 4 reviewers)
   - Bash(background): cat prompt.md | codex exec -C workspace -o log/review_codex.md -
@@ -753,7 +753,7 @@ log/{artifact}_review{N}_consensus_{date}.md       # Consensus analysis
 ```
 
 LLM identifiers: `claude_opus4.6`, `claude_team_opus4.6`,
-`claude_cli_opus4.7`, `codex_gpt5.4`, `cursor_composer2`, `cursor_gpt5.4`,
+`claude_cli_opus4.7`, `codex_gpt5.5`, `codex_gpt5.4`, `cursor_composer2`, `cursor_gpt5.4`,
 `cursor_premium`
 
 ## Internal Agent Team Review

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kairos-chain
 version: !ruby/object:Gem::Version
-  version: 3.28.1
+  version: 3.28.4
 platform: ruby
 authors:
 - Masaomi Hatakeyama
@@ -194,6 +194,7 @@ files:
 - lib/kairos_mcp/tools/knowledge_update.rb
 - lib/kairos_mcp/tools/resource_list.rb
 - lib/kairos_mcp/tools/resource_read.rb
+- lib/kairos_mcp/tools/resource_render.rb
 - lib/kairos_mcp/tools/skills_audit.rb
 - lib/kairos_mcp/tools/skills_dsl_get.rb
 - lib/kairos_mcp/tools/skills_dsl_list.rb