McpRuntimeTools.hpp

浏览该文件的文档.

#pragma once
 
// MCP runtime-observation tools.
//
// The embedded MCP server already exposes the debugger, the editor command
// protocol and the Play Host. What it did not expose was the engine's own
// runtime console (devtools/ConsolePanel): a Squirrel `print()` or an uncaught
// script error only reached the process stdout/stderr, which the stdio
// transport deliberately keeps free of anything but JSON-RPC frames. An
// unattended agent therefore could not see the primary diagnostic channel of a
// scripted game at all.
//
// This module owns the tool family that closes that gap:
//
//   eve_console_read   read retained console lines from a monotonic cursor
//   eve_console_write  append an agent marker to the same ordered stream
//   eve_console_clear  drop retained lines without rewinding the cursor
//   eve_screenshot_image  capture the presented frame as an MCP image item
//   eve_restart        soft-restart the game without unloading the resource cache
//
// Console lines carry a process-lifetime sequence number so a caller can read
// incrementally and tell "nothing new happened" apart from "lines were dropped
// before I read them".
 
#include <Poco/JSON/Object.h>
 
#include "common/Export.h"
 
#include <string>
#include <string_view>
 
namespace eve::dev {
 
EVENGINE_API_FOUNDATION bool isMcpRuntimeTool(std::string_view name);
 
EVENGINE_API_FOUNDATION std::string callMcpRuntimeTool(std::string_view name, Poco::JSON::Object::Ptr args);
 
EVENGINE_API_FOUNDATION std::string_view mcpRuntimeToolSchemas();
 
[[nodiscard]] EVENGINE_API_FOUNDATION Poco::JSON::Object::Ptr crashLogSummary();
 
}  // namespace eve::dev