@beremaran/godot-agent-loop 1.0.0

package/build/runtime-protocol.js

@@ -0,0 +1,202 @@
+/** Versioned JSON-RPC 2.0 contract for the Godot runtime TCP endpoint. */
+export const RUNTIME_PROTOCOL_VERSION = '1.0';
+export const RUNTIME_CAPABILITIES = ['runtime-commands', 'godot-json-values'];
+export const AUTHORING_COMMANDS_CAPABILITY = 'authoring-commands';
+export const RENDERING_CONTEXT_CAPABILITY = 'rendering-context';
+export const HANDSHAKE_METHOD = 'godot.runtime.handshake';
+export const COMMAND_METHOD_PREFIX = 'godot.runtime.';
+export const CANCEL_METHOD = 'godot.runtime.cancel';
+export const CANCELLABLE_RUNTIME_COMMANDS = ['wait', 'await_signal', 'resource', 'http_request'];
+export const PRIVILEGED_RUNTIME_CAPABILITY = 'privileged-commands';
+export const SESSION_AUTHENTICATION_CAPABILITY = 'session-authentication';
+export const PRIVILEGED_RUNTIME_GROUPS = ['reflection', 'code-execution', 'network'];
+export const PRIVILEGED_RUNTIME_COMMANDS = [
+    'call_method',
+    'eval',
+    'get_property',
+    'http_request',
+    'rpc',
+    'script',
+    'set_property',
+    'websocket',
+];
+export const PRIVILEGED_RUNTIME_COMMAND_GROUPS = {
+    call_method: 'reflection',
+    eval: 'code-execution',
+    get_property: 'reflection',
+    http_request: 'network',
+    rpc: 'network',
+    script: 'code-execution',
+    set_property: 'reflection',
+    websocket: 'network',
+};
+export function privilegedGroupCapability(group) {
+    return `privileged-${group}`;
+}
+/**
+ * Every runtime command in the published contract, sorted. The manifest of
+ * record is `x-runtime-contract.commands` in docs/runtime-api.schema.json;
+ * this mirror lets the TypeScript binding reject unknown commands before they
+ * reach the wire, and the contract test verifies the two never drift.
+ */
+export const RUNTIME_COMMANDS = [
+    '3d_effects',
+    'add_collision',
+    'animation_control',
+    'animation_tree',
+    'audio_bus',
+    'audio_bus_layout',
+    'audio_effect',
+    'audio_play',
+    'audio_spatial',
+    'await_signal',
+    'bone_pose',
+    'call_method',
+    'camera_attributes',
+    'canvas',
+    'canvas_draw',
+    'change_scene',
+    'click',
+    'connect_signal',
+    'create_animation',
+    'create_joint',
+    'create_timer',
+    'csg',
+    'debug_draw',
+    'disconnect_signal',
+    'emit_signal',
+    'environment',
+    'eval',
+    'find_nodes_by_class',
+    'gamepad',
+    'get_audio',
+    'get_camera',
+    'get_node_info',
+    'get_nodes_in_group',
+    'get_performance',
+    'get_property',
+    'get_scene_tree',
+    'get_ui_elements',
+    'gi',
+    'gridmap',
+    'http_request',
+    'input_action',
+    'input_state',
+    'instantiate_scene',
+    'key_hold',
+    'key_press',
+    'key_release',
+    'light_2d',
+    'light_3d',
+    'list_signals',
+    'locale',
+    'manage_group',
+    'mesh_instance',
+    'mouse_drag',
+    'mouse_move',
+    'multimesh',
+    'multiplayer',
+    'navigate_path',
+    'navigation_3d',
+    'os_info',
+    'parallax',
+    'path_2d',
+    'path_3d',
+    'pause',
+    'physics_2d',
+    'physics_3d',
+    'physics_body',
+    'play_animation',
+    'procedural_mesh',
+    'process_mode',
+    'raycast',
+    'remove_node',
+    'render_settings',
+    'reparent_node',
+    'resource',
+    'rpc',
+    'screenshot',
+    'script',
+    'scroll',
+    'serialize_state',
+    'set_camera',
+    'set_particles',
+    'set_property',
+    'set_shader_param',
+    'shape_2d',
+    'skeleton_ik',
+    'sky',
+    'spawn_node',
+    'terrain',
+    'tilemap',
+    'time_scale',
+    'touch',
+    'tween_property',
+    'ui_control',
+    'ui_item_list',
+    'ui_menu',
+    'ui_popup',
+    'ui_range',
+    'ui_tabs',
+    'ui_text',
+    'ui_theme',
+    'ui_tree',
+    'video',
+    'viewport',
+    'visual_shader',
+    'wait',
+    'websocket',
+    'window',
+    'world_settings',
+];
+const RUNTIME_COMMAND_SET = new Set(RUNTIME_COMMANDS);
+/**
+ * File-backed operations exposed only by the harness-owned authoring session.
+ * They share the runtime transport, but remain distinct from game commands so
+ * tools can migrate from the subprocess backend one at a time.
+ */
+export const AUTHORING_COMMANDS = [
+    'authoring_add_node',
+    'authoring_attach_script',
+    'authoring_create_resource',
+    'authoring_create_scene',
+    'authoring_export_mesh_library',
+    'authoring_get_uid',
+    'authoring_load_sprite',
+    'authoring_manage_resource',
+    'authoring_manage_scene_signals',
+    'authoring_manage_scene_structure',
+    'authoring_manage_theme_resource',
+    'authoring_modify_node',
+    'authoring_read_scene',
+    'authoring_remove_node',
+    'authoring_resave_resources',
+    'authoring_save_scene',
+];
+export const SESSION_COMMANDS = [...RUNTIME_COMMANDS, ...AUTHORING_COMMANDS].sort();
+const AUTHORING_COMMAND_SET = new Set(AUTHORING_COMMANDS);
+export function isRuntimeCommand(command) {
+    return RUNTIME_COMMAND_SET.has(command);
+}
+export function isAuthoringCommand(command) {
+    return AUTHORING_COMMAND_SET.has(command);
+}
+export function isSessionCommand(command) {
+    return isRuntimeCommand(command) || isAuthoringCommand(command);
+}
+export function commandMethod(command) { return `${COMMAND_METHOD_PREFIX}${command}`; }
+export function isJsonRpcResponse(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const response = value;
+    return response.jsonrpc === '2.0'
+        && (typeof response.id === 'number' || typeof response.id === 'string' || response.id === null)
+        && (Object.hasOwn(response, 'result') || typeof response.error === 'object');
+}
+export function isHandshakeResult(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const result = value;
+    return typeof result.protocolVersion === 'string' && Array.isArray(result.capabilities)
+        && result.capabilities.every(capability => typeof capability === 'string');
+}