blockmine 1.24.0 → 1.27.0

package/backend/src/core/metrics/__tests__/MetricsCollector.test.js

@@ -0,0 +1,131 @@
+const { MetricsCollector } = require('../MetricsCollector');
+
+describe('MetricsCollector', () => {
+    let metrics;
+
+    beforeEach(() => {
+        metrics = new MetricsCollector();
+    });
+
+    describe('counters', () => {
+        it('starts at 0', () => {
+            expect(metrics.getCounter('requests')).toBe(0);
+        });
+
+        it('increments counter', () => {
+            metrics.incrementCounter('requests');
+            metrics.incrementCounter('requests');
+            expect(metrics.getCounter('requests')).toBe(2);
+        });
+
+        it('increments by custom value', () => {
+            metrics.incrementCounter('bytes', {}, 100);
+            metrics.incrementCounter('bytes', {}, 50);
+            expect(metrics.getCounter('bytes')).toBe(150);
+        });
+
+        it('isolates counters by labels', () => {
+            metrics.incrementCounter('requests', { method: 'GET' });
+            metrics.incrementCounter('requests', { method: 'POST' });
+            expect(metrics.getCounter('requests', { method: 'GET' })).toBe(1);
+            expect(metrics.getCounter('requests', { method: 'POST' })).toBe(1);
+        });
+    });
+
+    describe('histograms', () => {
+        it('returns null for unknown histogram', () => {
+            expect(metrics.getHistogram('duration')).toBeNull();
+        });
+
+        it('records duration and computes stats', () => {
+            metrics.recordDuration('duration', 10);
+            metrics.recordDuration('duration', 20);
+            metrics.recordDuration('duration', 30);
+            const h = metrics.getHistogram('duration');
+            expect(h.count).toBe(3);
+            expect(h.sum).toBe(60);
+            expect(h.min).toBe(10);
+            expect(h.max).toBe(30);
+            expect(h.avg).toBe(20);
+        });
+
+        it('computes percentiles', () => {
+            for (let i = 1; i <= 100; i++) metrics.recordDuration('latency', i);
+            const h = metrics.getHistogram('latency');
+            expect(h.p50).toBe(50);
+            expect(h.p95).toBe(95);
+            expect(h.p99).toBe(99);
+        });
+
+        it('isolates histograms by labels', () => {
+            metrics.recordDuration('duration', 10, { route: '/a' });
+            metrics.recordDuration('duration', 20, { route: '/b' });
+            expect(metrics.getHistogram('duration', { route: '/a' }).count).toBe(1);
+            expect(metrics.getHistogram('duration', { route: '/b' }).count).toBe(1);
+        });
+    });
+
+    describe('gauges', () => {
+        it('returns null for unknown gauge', () => {
+            expect(metrics.getGauge('bots')).toBeNull();
+        });
+
+        it('sets and gets gauge value', () => {
+            metrics.setGauge('bots', 5);
+            expect(metrics.getGauge('bots')).toBe(5);
+        });
+
+        it('overwrites gauge value', () => {
+            metrics.setGauge('bots', 5);
+            metrics.setGauge('bots', 3);
+            expect(metrics.getGauge('bots')).toBe(3);
+        });
+
+        it('isolates gauges by labels', () => {
+            metrics.setGauge('bots', 2, { status: 'running' });
+            metrics.setGauge('bots', 1, { status: 'stopped' });
+            expect(metrics.getGauge('bots', { status: 'running' })).toBe(2);
+            expect(metrics.getGauge('bots', { status: 'stopped' })).toBe(1);
+        });
+    });
+
+    describe('reset', () => {
+        it('clears all metrics', () => {
+            metrics.incrementCounter('requests');
+            metrics.recordDuration('duration', 10);
+            metrics.setGauge('bots', 5);
+            metrics.reset();
+            expect(metrics.getCounter('requests')).toBe(0);
+            expect(metrics.getHistogram('duration')).toBeNull();
+            expect(metrics.getGauge('bots')).toBeNull();
+        });
+    });
+
+    describe('toPrometheus', () => {
+        it('outputs counter in Prometheus format', () => {
+            metrics.incrementCounter('http_requests_total', { method: 'GET' }, 3);
+            const output = metrics.toPrometheus();
+            expect(output).toContain('# TYPE http_requests_total counter');
+            expect(output).toContain('http_requests_total{method="GET"} 3');
+        });
+
+        it('outputs histogram in Prometheus format', () => {
+            metrics.recordDuration('request_duration_ms', 100);
+            const output = metrics.toPrometheus();
+            expect(output).toContain('# TYPE request_duration_ms histogram');
+            expect(output).toContain('request_duration_ms_count 1');
+            expect(output).toContain('request_duration_ms_sum 100');
+        });
+
+        it('outputs gauge in Prometheus format', () => {
+            metrics.setGauge('active_bots', 7);
+            const output = metrics.toPrometheus();
+            expect(output).toContain('# TYPE active_bots gauge');
+            expect(output).toContain('active_bots 7');
+        });
+
+        it('returns empty string when no metrics', () => {
+            expect(metrics.toPrometheus()).toBe('');
+        });
+    });
+});

package/backend/src/core/node-registries/actionsNodes.js

@@ -0,0 +1,191 @@
+const { GRAPH_TYPES } = require('../../core/constants/graphTypes');
+
+const actionNodes = [
+  {
+    type: 'action:send_message',
+    label: '🗣️ Отправить сообщение',
+    category: 'Действия',
+    description: 'Отправляет сообщение в чат. Поддерживает переменные в формате {varName}',
+    graphType: GRAPH_TYPES.ALL,
+    executor: require('../../core/nodes/actions/send_message').execute,
+    computeInputs: (data) => [
+      { id: 'exec', name: 'Выполнить', type: 'Exec' },
+      { id: 'chat_type', name: 'Тип чата', type: 'String', required: true, inlineField: true, placeholder: 'global' },
+      { id: 'message', name: 'Сообщение', type: 'String', required: true, inlineField: true, placeholder: 'Привет!' },
+      { id: 'recipient', name: 'Адресат', type: 'String', required: false, inlineField: true, placeholder: 'никнейм' }
+    ],
+    computeOutputs: () => [
+      { id: 'exec', name: 'Выполнено', type: 'Exec' }
+    ],
+    defaultData: { chat_type: 'global', message: '', recipient: '' },
+    theme: { headerColor: '#d97706', accentColor: '#f59e0b' }
+  },
+  {
+    type: 'action:send_log',
+    label: '📝 Записать в лог (веб)',
+    category: 'Действия',
+    description: 'Отправляет сообщение в консоль на странице бота.',
+    graphType: GRAPH_TYPES.ALL,
+    executor: require('../../core/nodes/actions/send_log').execute,
+    computeInputs: (data) => [
+      { id: 'exec', name: 'Выполнить', type: 'Exec' },
+      { id: 'message', name: 'Сообщение', type: 'String', required: true, inlineField: true, placeholder: 'Отладочное сообщение' }
+    ],
+    computeOutputs: () => [
+      { id: 'exec', name: 'Выполнено', type: 'Exec' }
+    ],
+    defaultData: { message: '' },
+    theme: { headerColor: '#d97706', accentColor: '#f59e0b' }
+  },
+  {
+    type: 'action:send_websocket_response',
+    label: '📤 Отправить ответ в WebSocket',
+    category: 'WebSocket API',
+    description: 'Отправляет данные обратно клиенту, вызвавшему граф через WebSocket API.',
+    graphType: GRAPH_TYPES.EVENT,
+    executor: require('../../core/nodes/actions/send_websocket_response').execute,
+    computeInputs: (data) => [
+      { id: 'exec', name: 'Выполнить', type: 'Exec' },
+      { id: 'data', name: 'Данные', type: 'Wildcard', required: true }
+    ],
+    computeOutputs: () => [
+      { id: 'exec', name: 'Выполнено', type: 'Exec' }
+    ],
+    defaultData: { data: null },
+    theme: { headerColor: '#d97706', accentColor: '#f59e0b' }
+  },
+  {
+    type: 'action:bot_look_at',
+    label: '🤖 Бот: Посмотреть на',
+    category: 'Действия',
+    description: 'Поворачивает голову бота в сторону координат или сущности.',
+    graphType: GRAPH_TYPES.ALL,
+    executor: require('../../core/nodes/actions/bot_look_at').execute,
+    computeInputs: (data) => [
+      { id: 'exec', name: 'Выполнить', type: 'Exec' },
+      { id: 'target', name: 'Цель (Позиция/Сущность)', type: 'Object', required: true },
+      { id: 'add_y', name: 'Прибавить к Y', type: 'Number', required: false, inlineField: true, placeholder: '0' }
+    ],
+    computeOutputs: () => [
+      { id: 'exec', name: 'Выполнено', type: 'Exec' }
+    ],
+    defaultData: { target: null, add_y: 0 },
+    theme: { headerColor: '#d97706', accentColor: '#f59e0b' }
+  },
+  {
+    type: 'action:bot_set_variable',
+    label: '💾 Записать переменную',
+    category: 'Действия',
+    description: 'Сохраняет значение в переменную графа.',
+    graphType: GRAPH_TYPES.ALL,
+    executor: require('../../core/nodes/actions/bot_set_variable').execute,
+    computeInputs: (data) => [
+      { id: 'exec', name: 'Выполнить', type: 'Exec' },
+      { id: 'name', name: 'Имя', type: 'String', required: true, inlineField: true, placeholder: 'myVariable' },
+      { id: 'value', name: 'Значение', type: 'Wildcard', required: true },
+      { id: 'persist', name: 'Хранить в БД?', type: 'Boolean', required: false, inlineField: true }
+    ],
+    computeOutputs: () => [
+      { id: 'exec', name: 'Выполнено', type: 'Exec' }
+    ],
+    defaultData: { name: '', value: null, persist: false },
+    theme: { headerColor: '#d97706', accentColor: '#f59e0b' }
+  },
+  {
+    type: 'action:http_request',
+    label: '🌐 HTTP-запрос',
+    category: 'Действия',
+    description: 'Выполняет HTTP-запрос (GET, POST, PUT, DELETE и т.д.) и возвращает ответ.',
+    graphType: GRAPH_TYPES.ALL,
+    executor: require('../../core/nodes/actions/http_request').execute,
+    computeInputs: (data) => [
+      { id: 'exec', name: 'Выполнить', type: 'Exec' },
+      { id: 'url', name: 'URL', type: 'String', required: true, inlineField: true, placeholder: 'https://api.example.com' },
+      { id: 'method', name: 'Метод', type: 'String', required: false, inlineField: true, placeholder: 'GET' },
+      { id: 'queryParams', name: 'Query Params', type: 'Object', required: false },
+      { id: 'headers', name: 'Headers', type: 'Object', required: false },
+      { id: 'body', name: 'Тело (JSON)', type: 'Wildcard', required: false },
+      { id: 'timeout', name: 'Таймаут (мс)', type: 'Number', required: false, inlineField: true, placeholder: '5000' }
+    ],
+    computeOutputs: () => [
+      { id: 'exec', name: 'Успех', type: 'Exec' },
+      { id: 'exec_error', name: 'Ошибка', type: 'Exec' },
+      { id: 'status', name: 'Статус', type: 'Number' },
+      { id: 'response', name: 'Ответ', type: 'Wildcard' },
+      { id: 'response_headers', name: 'Заголовки ответа', type: 'Object' },
+      { id: 'success', name: 'Успешно', type: 'Boolean' },
+      { id: 'error', name: 'Ошибка', type: 'String' }
+    ],
+    defaultData: { url: '', method: 'GET', queryParams: null, headers: null, body: null, timeout: 5000 },
+    theme: { headerColor: '#d97706', accentColor: '#f59e0b' }
+  },
+  {
+    type: 'action:create_command',
+    label: '➕ Создать команду',
+    category: 'Действия',
+    description: 'Создает новую команду (временную или постоянную)',
+    graphType: GRAPH_TYPES.ALL,
+    executor: require('../../core/nodes/actions/create_command').execute,
+    computeInputs: (data) => [
+      { id: 'exec', name: 'Выполнить', type: 'Exec' },
+      { id: 'name', name: 'Имя команды', type: 'String', required: true, inlineField: true, placeholder: 'mycommand' },
+      { id: 'description', name: 'Описание', type: 'String', required: false, inlineField: true, placeholder: 'Описание команды' },
+      { id: 'aliases', name: 'Алиасы', type: 'Array', required: false },
+      { id: 'cooldown', name: 'Кулдаун (сек)', type: 'Number', required: false, inlineField: true, placeholder: '0' },
+      { id: 'allowedChatTypes', name: 'Типы чата', type: 'Array', required: false },
+      { id: 'permissionName', name: 'Название права', type: 'String', required: false, inlineField: true, placeholder: 'everyone' },
+      { id: 'temporary', name: 'Временная?', type: 'Boolean', required: false, inlineField: true }
+    ],
+    computeOutputs: () => [
+      { id: 'exec', name: 'Выполнено', type: 'Exec' },
+      { id: 'commandId', name: 'ID команды', type: 'Number' },
+      { id: 'success', name: 'Успешно', type: 'Boolean' }
+    ],
+    defaultData: { name: '', description: '', aliases: [], cooldown: 0, allowedChatTypes: [], permissionName: '', temporary: false },
+    theme: { headerColor: '#d97706', accentColor: '#f59e0b' }
+  },
+  {
+    type: 'action:update_command',
+    label: '✏️ Редактировать команду',
+    category: 'Действия',
+    description: 'Изменяет параметры существующей команды',
+    graphType: GRAPH_TYPES.ALL,
+    executor: require('../../core/nodes/actions/update_command').execute,
+    computeInputs: (data) => [
+      { id: 'exec', name: 'Выполнить', type: 'Exec' },
+      { id: 'commandName', name: 'Имя команды', type: 'String', required: true, inlineField: true, placeholder: 'mycommand' },
+      { id: 'newName', name: 'Новое имя', type: 'String', required: false, inlineField: true, placeholder: 'newcommand' },
+      { id: 'description', name: 'Описание', type: 'String', required: false, inlineField: true, placeholder: 'Новое описание' },
+      { id: 'aliases', name: 'Алиасы', type: 'Array', required: false },
+      { id: 'cooldown', name: 'Кулдаун (сек)', type: 'Number', required: false, inlineField: true, placeholder: '0' },
+      { id: 'allowedChatTypes', name: 'Типы чата', type: 'Array', required: false },
+      { id: 'permissionName', name: 'Название права', type: 'String', required: false, inlineField: true, placeholder: 'everyone' }
+    ],
+    computeOutputs: () => [
+      { id: 'exec', name: 'Выполнено', type: 'Exec' },
+      { id: 'success', name: 'Успешно', type: 'Boolean' }
+    ],
+    defaultData: { commandName: '', newName: '', description: '', aliases: [], cooldown: 0, allowedChatTypes: [], permissionName: '' },
+    theme: { headerColor: '#d97706', accentColor: '#f59e0b' }
+  },
+  {
+    type: 'action:delete_command',
+    label: '🗑️ Удалить команду',
+    category: 'Действия',
+    description: 'Удаляет существующую команду бота',
+    graphType: GRAPH_TYPES.ALL,
+    executor: require('../../core/nodes/actions/delete_command').execute,
+    computeInputs: (data) => [
+      { id: 'exec', name: 'Выполнить', type: 'Exec' },
+      { id: 'commandName', name: 'Имя команды', type: 'String', required: true, inlineField: true, placeholder: 'mycommand' }
+    ],
+    computeOutputs: () => [
+      { id: 'exec', name: 'Выполнено', type: 'Exec' },
+      { id: 'success', name: 'Успешно', type: 'Boolean' }
+    ],
+    defaultData: { commandName: '' },
+    theme: { headerColor: '#d97706', accentColor: '#f59e0b' }
+  }
+];
+
+module.exports = actionNodes;

package/backend/src/core/node-registries/arraysNodes.js

@@ -0,0 +1,152 @@
+const { GRAPH_TYPES } = require('../../core/constants/graphTypes');
+
+const arraysNodes = [
+  {
+    type: 'array:get_random_element',
+    label: '🎲 Случайный элемент',
+    category: 'Массив',
+    graphType: GRAPH_TYPES.ALL,
+    description: 'Возвращает случайный элемент из массива и его индекс.',
+    evaluator: require('../../core/nodes/arrays/get_random_element').evaluate,
+    computeInputs: () => [
+      { id: 'array', name: 'Массив', type: 'Array', required: true }
+    ],
+    computeOutputs: () => [
+      { id: 'element', name: 'Элемент', type: 'Any' },
+      { id: 'index', name: 'Индекс', type: 'Number' }
+    ],
+    defaultData: {}
+  },
+  {
+    type: 'array:contains',
+    label: '🔍 Массив: Содержит',
+    category: 'Массив',
+    graphType: GRAPH_TYPES.ALL,
+    description: 'Проверяет, содержит ли массив указанный элемент и возвращает его индекс.',
+    evaluator: require('../../core/nodes/arrays/contains').evaluate,
+    computeInputs: () => [
+      { id: 'array', name: 'Массив', type: 'Array', required: true },
+      { id: 'element', name: 'Элемент', type: 'Wildcard', required: true, inlineField: true }
+    ],
+    computeOutputs: () => [
+      { id: 'result', name: 'Найден', type: 'Boolean' },
+      { id: 'index', name: 'Индекс', type: 'Number' }
+    ],
+    defaultData: { element: null }
+  },
+  {
+    type: 'array:get_by_index',
+    label: '📦 Элемент по индексу',
+    category: 'Массив',
+    graphType: GRAPH_TYPES.ALL,
+    description: 'Получает элемент массива по его индексу.',
+    evaluator: require('../../core/nodes/arrays/get_by_index').evaluate,
+    computeInputs: (data) => [
+      { id: 'array', name: 'Массив', type: 'Array', required: true },
+      { id: 'index', name: 'Индекс', type: 'Number', required: true, inlineField: true, placeholder: '0' }
+    ],
+    computeOutputs: () => [
+      { id: 'element', name: 'Элемент', type: 'Any' }
+    ],
+    defaultData: { index: 0 }
+  },
+  {
+    type: 'array:get_next',
+    label: '➡️ Следующий элемент',
+    category: 'Массив',
+    graphType: GRAPH_TYPES.ALL,
+    description: 'Получает следующий элемент массива.',
+    evaluator: require('../../core/nodes/arrays/get_next').evaluate,
+    computeInputs: (data) => [
+      { id: 'array', name: 'Массив', type: 'Array', required: true },
+      { id: 'current_index', name: 'Текущий индекс', type: 'Number', required: true, inlineField: true, placeholder: '0' }
+    ],
+    computeOutputs: () => [
+      { id: 'next_element', name: 'Следующий элемент', type: 'Any' },
+      { id: 'next_index', name: 'Следующий индекс', type: 'Number' },
+      { id: 'has_next', name: 'Есть следующий?', type: 'Boolean' }
+    ],
+    defaultData: { current_index: 0 }
+  },
+  {
+    type: 'array:add_element',
+    label: '➕ Добавить элемент',
+    category: 'Массив',
+    graphType: GRAPH_TYPES.ALL,
+    description: 'Добавляет элемент в конец массива.',
+    evaluator: require('../../core/nodes/arrays/add_element').evaluate,
+    computeInputs: () => [
+      { id: 'array', name: 'Массив', type: 'Array', required: true },
+      { id: 'element', name: 'Элемент', type: 'Wildcard', required: true, inlineField: true }
+    ],
+    computeOutputs: () => [
+      { id: 'result', name: 'Новый массив', type: 'Array' }
+    ],
+    defaultData: { element: null }
+  },
+  {
+    type: 'array:remove_by_index',
+    label: '➖ Удалить по индексу',
+    category: 'Массив',
+    graphType: GRAPH_TYPES.ALL,
+    description: 'Удаляет элемент из массива по его индексу.',
+    evaluator: require('../../core/nodes/arrays/remove_by_index').evaluate,
+    computeInputs: (data) => [
+      { id: 'array', name: 'Массив', type: 'Array', required: true },
+      { id: 'index', name: 'Индекс', type: 'Number', required: true, inlineField: true, placeholder: '0' }
+    ],
+    computeOutputs: () => [
+      { id: 'result', name: 'Новый массив', type: 'Array' }
+    ],
+    defaultData: { index: 0 }
+  },
+  {
+    type: 'array:find_index',
+    label: '🔍 Найти индекс',
+    category: 'Массив',
+    graphType: GRAPH_TYPES.ALL,
+    description: 'Находит индекс элемента в массиве (или -1 если не найден).',
+    evaluator: require('../../core/nodes/arrays/find_index').evaluate,
+    computeInputs: () => [
+      { id: 'array', name: 'Массив', type: 'Array', required: true },
+      { id: 'element', name: 'Элемент', type: 'Wildcard', required: true, inlineField: true }
+    ],
+    computeOutputs: () => [
+      { id: 'index', name: 'Индекс', type: 'Number' }
+    ],
+    defaultData: { element: null }
+  },
+  {
+    type: 'array:join',
+    label: '🔗 Объединить в строку',
+    category: 'Массив',
+    graphType: GRAPH_TYPES.ALL,
+    description: 'Объединяет элементы массива в строку с разделителем.',
+    evaluator: require('../../core/nodes/arrays/join').evaluate,
+    computeInputs: (data) => [
+      { id: 'array', name: 'Массив', type: 'Array', required: false },
+      { id: 'separator', name: 'Разделитель', type: 'String', required: false, inlineField: true, placeholder: ',' }
+    ],
+    computeOutputs: () => [
+      { id: 'result', name: 'Result', type: 'String' }
+    ],
+    defaultData: { separator: ',' }
+  },
+  {
+    type: 'array:shuffle',
+    label: 'Перемешать массив',
+    category: 'Массив',
+    graphType: GRAPH_TYPES.ALL,
+    description: 'Возвращает новый массив с элементами в случайном порядке.',
+    evaluator: require('../../core/nodes/arrays/shuffle').evaluate,
+    computeInputs: () => [
+      { id: 'array', name: 'Массив', type: 'Array', required: true }
+    ],
+    computeOutputs: () => [
+      { id: 'shuffled', name: 'Перемешанный', type: 'Array' }
+    ],
+    defaultData: {}
+  }
+];
+
+module.exports = arraysNodes;

package/backend/src/core/node-registries/botNodes.js

@@ -0,0 +1,48 @@
+const { GRAPH_TYPES } = require('../../core/constants/graphTypes');
+
+const botNodes = [
+  {
+    type: 'bot:stop',
+    label: '🔴 Выключить бота',
+    category: 'Бот',
+    description: 'Останавливает бота.',
+    graphType: GRAPH_TYPES.ALL,
+    executor: require('../../core/nodes/bot/stop_bot').execute,
+    computeInputs: () => [
+      { id: 'exec', name: 'Выполнить', type: 'Exec' }
+    ],
+    computeOutputs: () => [],
+    defaultData: {},
+    theme: { headerColor: '#dc2626', accentColor: '#ef4444' }
+  },
+  {
+    type: 'bot:get_position',
+    label: '🤖 Позиция бота',
+    category: 'Бот',
+    description: 'Возвращает текущую позицию бота в мире.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../../core/nodes/bot/get_position').evaluate,
+    computeInputs: () => [],
+    computeOutputs: () => [
+      { id: 'position', name: 'Позиция', type: 'Object' }
+    ],
+    defaultData: {},
+    theme: { headerColor: '#059669', accentColor: '#10b981' }
+  },
+  {
+    type: 'bot:get_name',
+    label: '🤖 Имя бота',
+    category: 'Бот',
+    description: 'Возвращает имя (username) бота.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../../core/nodes/bot/get_name').evaluate,
+    computeInputs: () => [],
+    computeOutputs: () => [
+      { id: 'name', name: 'Имя', type: 'String' }
+    ],
+    defaultData: {},
+    theme: { headerColor: '#3b82f6', accentColor: '#60a5fa' }
+  }
+];
+
+module.exports = botNodes;

package/backend/src/core/node-registries/containerNodes.js

@@ -0,0 +1,141 @@
+const { GRAPH_TYPES } = require('../../core/constants/graphTypes');
+
+const containerNodes = [
+  {
+    type: 'container:open',
+    label: '📦 Контейнер: открыть',
+    category: 'Контейнеры',
+    description: 'Открывает контейнер (сундук, бочку) по координатам.',
+    graphType: GRAPH_TYPES.ALL,
+    executor: require('../../core/nodes/container/open').execute,
+    evaluator: require('../../core/nodes/container/open').evaluate,
+    computeInputs: (data) => [
+      { id: 'exec', name: 'Выполнить', type: 'Exec' },
+      { id: 'x', name: 'X', type: 'Number', required: false, inlineField: true, placeholder: '0' },
+      { id: 'y', name: 'Y', type: 'Number', required: false, inlineField: true, placeholder: '64' },
+      { id: 'z', name: 'Z', type: 'Number', required: false, inlineField: true, placeholder: '0' }
+    ],
+    computeOutputs: (data) => [
+      { id: 'exec', name: 'Открыт', type: 'Exec' },
+      { id: 'exec_failed', name: 'Ошибка', type: 'Exec' },
+      { id: 'container', name: 'Контейнер', type: 'Object' },
+      { id: 'success', name: 'Успех?', type: 'Boolean' }
+    ],
+    defaultData: { x: 0, y: 64, z: 0 },
+    theme: { headerColor: '#d97706', accentColor: '#f59e0b' }
+  },
+  {
+    type: 'container:close',
+    label: '📦 Контейнер: закрыть',
+    category: 'Контейнеры',
+    description: 'Закрывает текущий открытый контейнер.',
+    graphType: GRAPH_TYPES.ALL,
+    executor: require('../../core/nodes/container/close').execute,
+    computeInputs: () => [{ id: 'exec', name: 'Выполнить', type: 'Exec' }],
+    computeOutputs: () => [{ id: 'exec', name: 'Закрыт', type: 'Exec' }],
+    defaultData: {},
+    theme: { headerColor: '#d97706', accentColor: '#f59e0b' }
+  },
+  {
+    type: 'container:deposit',
+    label: '📦 Контейнер: положить',
+    category: 'Контейнеры',
+    description: 'Кладёт предмет из инвентаря в открытый контейнер.',
+    graphType: GRAPH_TYPES.ALL,
+    executor: require('../../core/nodes/container/deposit').execute,
+    evaluator: require('../../core/nodes/container/deposit').evaluate,
+    computeInputs: (data) => [
+      { id: 'exec', name: 'Выполнить', type: 'Exec' },
+      { id: 'itemName', name: 'Предмет', type: 'String', required: true, inlineField: true, placeholder: 'diamond...' },
+      { id: 'count', name: 'Кол-во', type: 'Number', required: false, inlineField: true, placeholder: 'Все' }
+    ],
+    computeOutputs: (data) => [
+      { id: 'exec', name: 'Готово', type: 'Exec' },
+      { id: 'exec_failed', name: 'Ошибка', type: 'Exec' },
+      { id: 'deposited', name: 'Положено', type: 'Number' },
+      { id: 'success', name: 'Успех?', type: 'Boolean' }
+    ],
+    defaultData: { itemName: '', count: null },
+    theme: { headerColor: '#d97706', accentColor: '#f59e0b' }
+  },
+  {
+    type: 'container:withdraw',
+    label: '📦 Контейнер: забрать',
+    category: 'Контейнеры',
+    description: 'Забирает предмет из контейнера в инвентарь.',
+    graphType: GRAPH_TYPES.ALL,
+    executor: require('../../core/nodes/container/withdraw').execute,
+    evaluator: require('../../core/nodes/container/withdraw').evaluate,
+    computeInputs: (data) => [
+      { id: 'exec', name: 'Выполнить', type: 'Exec' },
+      { id: 'itemName', name: 'Предмет', type: 'String', required: true, inlineField: true, placeholder: 'diamond...' },
+      { id: 'count', name: 'Кол-во', type: 'Number', required: false, inlineField: true, placeholder: 'Все' }
+    ],
+    computeOutputs: (data) => [
+      { id: 'exec', name: 'Готово', type: 'Exec' },
+      { id: 'exec_failed', name: 'Ошибка', type: 'Exec' },
+      { id: 'withdrawn', name: 'Забрано', type: 'Number' },
+      { id: 'success', name: 'Успех?', type: 'Boolean' }
+    ],
+    defaultData: { itemName: '', count: null },
+    theme: { headerColor: '#d97706', accentColor: '#f59e0b' }
+  },
+  {
+    type: 'container:deposit_all',
+    label: '📦 Контейнер: положить всё',
+    category: 'Контейнеры',
+    description: 'Кладёт все предметы (или определённого типа) в контейнер.',
+    graphType: GRAPH_TYPES.ALL,
+    executor: require('../../core/nodes/container/deposit_all').execute,
+    evaluator: require('../../core/nodes/container/deposit_all').evaluate,
+    computeInputs: (data) => [
+      { id: 'exec', name: 'Выполнить', type: 'Exec' },
+      { id: 'itemName', name: 'Предмет', type: 'String', required: false, inlineField: true, placeholder: 'Все' },
+      { id: 'keepOne', name: 'Оставить 1', type: 'Boolean', required: false, inlineField: true }
+    ],
+    computeOutputs: (data) => [
+      { id: 'exec', name: 'Готово', type: 'Exec' },
+      { id: 'deposited', name: 'Положено', type: 'Number' }
+    ],
+    defaultData: { itemName: '', keepOne: false },
+    theme: { headerColor: '#d97706', accentColor: '#f59e0b' }
+  },
+  {
+    type: 'container:get_items',
+    label: '📦 Контейнер: содержимое',
+    category: 'Контейнеры',
+    description: 'Получает список предметов из открытого контейнера.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../../core/nodes/container/get_items').evaluate,
+    computeInputs: (data) => [
+      { id: 'container', name: 'Контейнер', type: 'Object', required: false }
+    ],
+    computeOutputs: (data) => [
+      { id: 'items', name: 'Предметы', type: 'Array' },
+      { id: 'count', name: 'Кол-во слотов', type: 'Number' }
+    ],
+    defaultData: {},
+    theme: { headerColor: '#d97706', accentColor: '#f59e0b' }
+  },
+  {
+    type: 'container:find_item',
+    label: '📦 Контейнер: найти предмет',
+    category: 'Контейнеры',
+    description: 'Ищет предмет в открытом контейнере.',
+    graphType: GRAPH_TYPES.ALL,
+    evaluator: require('../../core/nodes/container/find_item').evaluate,
+    computeInputs: (data) => [
+      { id: 'itemName', name: 'Предмет', type: 'String', required: true, inlineField: true, placeholder: 'diamond...' }
+    ],
+    computeOutputs: (data) => [
+      { id: 'item', name: 'Предмет', type: 'Object' },
+      { id: 'slot', name: 'Слот', type: 'Number' },
+      { id: 'count', name: 'Кол-во', type: 'Number' },
+      { id: 'found', name: 'Найден?', type: 'Boolean' }
+    ],
+    defaultData: { itemName: '' },
+    theme: { headerColor: '#d97706', accentColor: '#f59e0b' }
+  }
+];
+
+module.exports = containerNodes;