@rithien/comfy_adapter 0.1.0

package/dist/web/static/main.761df12d5815fb8e02fa.js

@@ -0,0 +1,121 @@
+/*
+ * ATTENTION: An "eval-source-map" devtool has been used.
+ * This devtool is neither made for production nor for readable output files.
+ * It uses "eval()" calls to create a separate source file with attached SourceMaps in the browser devtools.
+ * If you are trying to read the output file, select a different devtool (https://webpack.js.org/configuration/devtool/)
+ * or disable the default devtool with "devtool: false".
+ * If you are looking for production-ready output files, see mode: "production" (https://webpack.js.org/configuration/mode/).
+ */
+/******/ (() => { // webpackBootstrap
+/******/ 	"use strict";
+/******/ 	var __webpack_modules__ = ({
+
+/***/ 162
+/*!***********************!*\
+  !*** ./web/index.jsx ***!
+  \***********************/
+() {
+
+eval("{ // factorio-polska / comfy_adapter — web UI bundle (placeholder Faza 2.5).\n //\n // Plugin manifest jest eksportowany przez `./info.js` (zgodnie z webpack.config.js\n // `exposes: { \"./\" : \"./info.js\" }`). Ten plik istnieje jako entry point webpack'a;\n // faktyczne komponenty React per-instance panel (Faza 2.X: lista trusted, historia\n // eventów anti-grief, ręczne /trust) zostaną dodane w kolejnych iteracjach.\n //\n // W obecnej fazie (2.5) plugin nie eksponuje żadnego web UI — clusterio admin panel\n // pokazuje tylko config fields z info.js (controllerConfigFields).\n//# sourceURL=[module]\n//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMTYyLmpzIiwibWFwcGluZ3MiOiJBQUFhLENBQ2IsMEVBQTBFO0NBQzFFLEVBQUU7Q0FDRixtRkFBbUY7Q0FDbkYsb0ZBQW9GO0NBQ3BGLG1GQUFtRjtDQUNuRiw0RUFBNEU7Q0FDNUUsRUFBRTtDQUNGLG9GQUFvRjtDQUNwRixtRUFBbUUiLCJzb3VyY2VzIjpbIndlYnBhY2s6Ly9Acml0aGllbi9jb21meV9hZGFwdGVyLy4vd2ViL2luZGV4LmpzeD9lMjIzIl0sInNvdXJjZXNDb250ZW50IjpbIlwidXNlIHN0cmljdFwiO1xuLy8gZmFjdG9yaW8tcG9sc2thIC8gY29tZnlfYWRhcHRlciDigJQgd2ViIFVJIGJ1bmRsZSAocGxhY2Vob2xkZXIgRmF6YSAyLjUpLlxuLy9cbi8vIFBsdWdpbiBtYW5pZmVzdCBqZXN0IGVrc3BvcnRvd2FueSBwcnpleiBgLi9pbmZvLmpzYCAoemdvZG5pZSB6IHdlYnBhY2suY29uZmlnLmpzXG4vLyBgZXhwb3NlczogeyBcIi4vXCIgOiBcIi4vaW5mby5qc1wiIH1gKS4gVGVuIHBsaWsgaXN0bmllamUgamFrbyBlbnRyeSBwb2ludCB3ZWJwYWNrJ2E7XG4vLyBmYWt0eWN6bmUga29tcG9uZW50eSBSZWFjdCBwZXItaW5zdGFuY2UgcGFuZWwgKEZhemEgMi5YOiBsaXN0YSB0cnVzdGVkLCBoaXN0b3JpYVxuLy8gZXZlbnTDs3cgYW50aS1ncmllZiwgcsSZY3puZSAvdHJ1c3QpIHpvc3RhbsSFIGRvZGFuZSB3IGtvbGVqbnljaCBpdGVyYWNqYWNoLlxuLy9cbi8vIFcgb2JlY25laiBmYXppZSAoMi41KSBwbHVnaW4gbmllIGVrc3BvbnVqZSDFvGFkbmVnbyB3ZWIgVUkg4oCUIGNsdXN0ZXJpbyBhZG1pbiBwYW5lbFxuLy8gcG9rYXp1amUgdHlsa28gY29uZmlnIGZpZWxkcyB6IGluZm8uanMgKGNvbnRyb2xsZXJDb25maWdGaWVsZHMpLlxuIl0sIm5hbWVzIjpbXSwic291cmNlUm9vdCI6IiJ9\n//# sourceURL=webpack-internal:///162\n\n}");
+
+/***/ }
+
+/******/ 	});
+/************************************************************************/
+/******/ 	// The module cache
+/******/ 	var __webpack_module_cache__ = {};
+/******/ 	
+/******/ 	// The require function
+/******/ 	function __webpack_require__(moduleId) {
+/******/ 		// Check if module is in cache
+/******/ 		var cachedModule = __webpack_module_cache__[moduleId];
+/******/ 		if (cachedModule !== undefined) {
+/******/ 			return cachedModule.exports;
+/******/ 		}
+/******/ 		// Create a new module (and put it into the cache)
+/******/ 		var module = __webpack_module_cache__[moduleId] = {
+/******/ 			// no module.id needed
+/******/ 			// no module.loaded needed
+/******/ 			exports: {}
+/******/ 		};
+/******/ 	
+/******/ 		// Execute the module function
+/******/ 		if (!(moduleId in __webpack_modules__)) {
+/******/ 			delete __webpack_module_cache__[moduleId];
+/******/ 			var e = new Error("Cannot find module '" + moduleId + "'");
+/******/ 			e.code = 'MODULE_NOT_FOUND';
+/******/ 			throw e;
+/******/ 		}
+/******/ 		__webpack_modules__[moduleId](module, module.exports, __webpack_require__);
+/******/ 	
+/******/ 		// Return the exports of the module
+/******/ 		return module.exports;
+/******/ 	}
+/******/ 	
+/******/ 	// expose the modules object (__webpack_modules__)
+/******/ 	__webpack_require__.m = __webpack_modules__;
+/******/ 	
+/******/ 	// expose the module cache
+/******/ 	__webpack_require__.c = __webpack_module_cache__;
+/******/ 	
+/************************************************************************/
+/******/ 	/* webpack/runtime/hasOwnProperty shorthand */
+/******/ 	(() => {
+/******/ 		__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))
+/******/ 	})();
+/******/ 	
+/******/ 	/* webpack/runtime/sharing */
+/******/ 	(() => {
+/******/ 		__webpack_require__.S = {};
+/******/ 		var initPromises = {};
+/******/ 		var initTokens = {};
+/******/ 		__webpack_require__.I = (name, initScope) => {
+/******/ 			if(!initScope) initScope = [];
+/******/ 			// handling circular init calls
+/******/ 			var initToken = initTokens[name];
+/******/ 			if(!initToken) initToken = initTokens[name] = {};
+/******/ 			if(initScope.indexOf(initToken) >= 0) return;
+/******/ 			initScope.push(initToken);
+/******/ 			// only runs once
+/******/ 			if(initPromises[name]) return initPromises[name];
+/******/ 			// creates a new share scope if needed
+/******/ 			if(!__webpack_require__.o(__webpack_require__.S, name)) __webpack_require__.S[name] = {};
+/******/ 			// runs all init snippets from all modules reachable
+/******/ 			var scope = __webpack_require__.S[name];
+/******/ 			var warn = (msg) => {
+/******/ 				if (typeof console !== "undefined" && console.warn) console.warn(msg);
+/******/ 			};
+/******/ 			var uniqueName = "@rithien/comfy_adapter";
+/******/ 			var register = (name, version, factory, eager) => {
+/******/ 				var versions = scope[name] = scope[name] || {};
+/******/ 				var activeVersion = versions[version];
+/******/ 				if(!activeVersion || (!activeVersion.loaded && (!eager != !activeVersion.eager ? eager : uniqueName > activeVersion.from))) versions[version] = { get: factory, from: uniqueName, eager: !!eager };
+/******/ 			};
+/******/ 			var initExternal = (id) => {
+/******/ 				var handleError = (err) => (warn("Initialization of sharing external failed: " + err));
+/******/ 				try {
+/******/ 					var module = __webpack_require__(id);
+/******/ 					if(!module) return;
+/******/ 					var initFn = (module) => (module && module.init && module.init(__webpack_require__.S[name], initScope))
+/******/ 					if(module.then) return promises.push(module.then(initFn, handleError));
+/******/ 					var initResult = initFn(module);
+/******/ 					if(initResult && initResult.then) return promises.push(initResult['catch'](handleError));
+/******/ 				} catch(err) { handleError(err); }
+/******/ 			}
+/******/ 			var promises = [];
+/******/ 			switch(name) {
+/******/ 			}
+/******/ 			if(!promises.length) return initPromises[name] = 1;
+/******/ 			return initPromises[name] = Promise.all(promises).then(() => (initPromises[name] = 1));
+/******/ 		};
+/******/ 	})();
+/******/ 	
+/************************************************************************/
+/******/ 	
+/******/ 	// module cache are used so entry inlining is disabled
+/******/ 	// startup
+/******/ 	// Load entry module and return exports
+/******/ 	var __webpack_exports__ = __webpack_require__(162);
+/******/ 	
+/******/ })()
+;

package/dist/web/static/package_json.b88ad27d58c1784bb20f.js

@@ -0,0 +1,22 @@
+"use strict";
+/*
+ * ATTENTION: An "eval-source-map" devtool has been used.
+ * This devtool is neither made for production nor for readable output files.
+ * It uses "eval()" calls to create a separate source file with attached SourceMaps in the browser devtools.
+ * If you are trying to read the output file, select a different devtool (https://webpack.js.org/configuration/devtool/)
+ * or disable the default devtool with "devtool: false".
+ * If you are looking for production-ready output files, see mode: "production" (https://webpack.js.org/configuration/mode/).
+ */
+(self["webpackChunk_rithien_comfy_adapter"] = self["webpackChunk_rithien_comfy_adapter"] || []).push([["package_json"],{
+
+/***/ 330
+/*!**********************!*\
+  !*** ./package.json ***!
+  \**********************/
+(module) {
+
+module.exports = /*#__PURE__*/JSON.parse('{"name":"@rithien/comfy_adapter","version":"0.1.0","description":"Clusterio plugin: parses Comfy/factorio-polska scenario stdout tags ([DISCORD*], [ANTIGRIEF-LOG], [DATA-SET/GET]) and bridges to Discord + JSON datastore","main":"info.js","scripts":{"test":"echo \\"Error: no test specified\\" && exit 1","prepare":"webpack-cli --env production"},"keywords":["clusterio","clusterio-plugin","factorio","factorio-polska","discord","comfyfactorio"],"author":"rithien <jacek@zaluzje.bialystok.pl>","license":"MIT","peerDependencies":{"@clusterio/lib":"^2.0.0-alpha.14"},"devDependencies":{"@clusterio/lib":"^2.0.0-alpha.14","@clusterio/web_ui":"^2.0.0-alpha.14","webpack":"^5.88.2","webpack-cli":"^5.1.4","webpack-merge":"^5.9.0"},"publishConfig":{"access":"public"}}');
+
+/***/ }
+
+}]);

package/info.js

@@ -0,0 +1,245 @@
+"use strict";
+// factorio-polska / comfy_adapter — plugin manifest + event schemas (Faza 2.5).
+//
+// Plugin parsuje tagowany stdout scenariusza Lua (`@rithien/factorio-polska` v0.1.0+) i:
+//   1. Forwarduje `[DISCORD*]` + `[ANTIGRIEF-LOG]` tagi do Discord przez współistniejący
+//      `@rithien/discord_bridge` (channel routing per instancja z Fazy 1).
+//   2. Trzyma persistent JSON datastore na kontrolerze (`storage_path`) dla
+//      `[DATA-SET]` (UPSERT) i `[DATA-GET]` (read + RCON callback przez `/cc`).
+//
+// Architektura messaging:
+//   - Instance → Controller: 4 typy eventów (ScenarioDiscordEvent, AntigriefLogEvent,
+//     DataSetEvent, DataGetRequest).
+//   - Controller → Instance: brak eventów custom (responses do scenariusza idą przez
+//     `host.sendRconCommand('/cc ...')` które trzyma host clusterio; nie potrzebujemy
+//     own event schema dla controller→instance pipe).
+
+const lib = require("@clusterio/lib");
+
+// =========================================================================
+// Events: Instance → Controller
+// =========================================================================
+
+// Wysyłany przez instance.js gdy stdout match'uje `[DISCORD]`, `[DISCORD-RAW]`,
+// `[DISCORD-BOLD]`, `[DISCORD-ADMIN]`, `[DISCORD-ADMIN-RAW]`, `[DISCORD-EMBED]`,
+// `[DISCORD-EMBED-RAW]`, `[DISCORD-EMBED-PARSED]`, `[DISCORD-ADMIN-EMBED]`,
+// `[DISCORD-ADMIN-EMBED-RAW]`.
+//
+// variant: nazwa tagu bez prefiksu '[' i sufiksu ']' (np. "DISCORD", "DISCORD-EMBED-PARSED").
+// content: dla zwykłych tagów = surowy string wiadomości; dla `DISCORD-EMBED-PARSED` =
+//          JSON `{title, description, color?, fields?}` (string).
+class ScenarioDiscordEvent {
+	static type = "event";
+	static src = "instance";
+	static dst = "controller";
+	static plugin = "comfy_adapter";
+
+	constructor(instanceName, variant, content) {
+		this.instanceName = instanceName;
+		this.variant = variant;
+		this.content = content;
+	}
+
+	static jsonSchema = {
+		type: "object",
+		required: ["instanceName", "variant", "content"],
+		properties: {
+			"instanceName": { type: "string" },
+			"variant": { type: "string" },
+			"content": { type: "string" },
+		},
+	};
+
+	static fromJSON(json) {
+		return new this(json.instanceName, json.variant, json.content);
+	}
+}
+
+// Wysyłany przez instance.js gdy stdout match'uje `[ANTIGRIEF-LOG]{category, action}`.
+class AntigriefLogEvent {
+	static type = "event";
+	static src = "instance";
+	static dst = "controller";
+	static plugin = "comfy_adapter";
+
+	constructor(instanceName, category, action) {
+		this.instanceName = instanceName;
+		this.category = category;
+		this.action = action;
+	}
+
+	static jsonSchema = {
+		type: "object",
+		required: ["instanceName", "category", "action"],
+		properties: {
+			"instanceName": { type: "string" },
+			"category": { type: "string" },
+			"action": { type: "string" },
+		},
+	};
+
+	static fromJSON(json) {
+		return new this(json.instanceName, json.category, json.action);
+	}
+}
+
+// Wysyłany przez instance.js gdy stdout match'uje `[DATA-SET]{data_set, key, value?}`.
+// value === null oznacza usunięcie wpisu (DELETE).
+// value może być: string, number, boolean, object (deserializowany z formatu Lua serpent).
+class DataSetEvent {
+	static type = "event";
+	static src = "instance";
+	static dst = "controller";
+	static plugin = "comfy_adapter";
+
+	constructor(instanceName, dataSet, key, value) {
+		this.instanceName = instanceName;
+		this.dataSet = dataSet;
+		this.key = key;
+		this.value = value;
+	}
+
+	static jsonSchema = {
+		type: "object",
+		required: ["instanceName", "dataSet", "key"],
+		properties: {
+			"instanceName": { type: "string" },
+			"dataSet": { type: "string" },
+			"key": { type: "string" },
+			// value może być dowolnego typu (string|number|boolean|object|null) — bez `type:` constraint.
+			"value": {},
+		},
+	};
+
+	static fromJSON(json) {
+		return new this(json.instanceName, json.dataSet, json.key, json.value ?? null);
+	}
+}
+
+// Wysyłany przez instance.js gdy stdout match'uje `[DATA-GET]<token>{data_set, key}`,
+// `[DATA-GET-AND-PRINT]<token>{...,to_print}`, `[DATA-GET-ALL]<token>{data_set}`.
+//
+// mode: "get" | "get_and_print" | "get_all" — determinuje response shape.
+// token: callback_token Lua (Token.uid) — plugin echo'uje go w RCON response żeby
+//        Token.get(<token>)({...}) zadziałał lokalnie w scenariuszu.
+// key: dla "get_all" pole nieobecne (data_set entire dump).
+// toPrint: tylko dla "get_and_print" — nazwa gracza do print'u.
+class DataGetRequest {
+	static type = "event";
+	static src = "instance";
+	static dst = "controller";
+	static plugin = "comfy_adapter";
+
+	constructor(instanceName, instanceId, mode, token, dataSet, key, toPrint) {
+		this.instanceName = instanceName;
+		this.instanceId = instanceId;
+		this.mode = mode;
+		this.token = token;
+		this.dataSet = dataSet;
+		this.key = key ?? null;
+		this.toPrint = toPrint ?? null;
+	}
+
+	static jsonSchema = {
+		type: "object",
+		required: ["instanceName", "instanceId", "mode", "token", "dataSet"],
+		properties: {
+			"instanceName": { type: "string" },
+			"instanceId": { type: "integer" },
+			"mode": { type: "string", enum: ["get", "get_and_print", "get_all"] },
+			"token": { type: "integer" },
+			"dataSet": { type: "string" },
+			"key": { type: ["string", "null"] },
+			"toPrint": { type: ["string", "null"] },
+		},
+	};
+
+	static fromJSON(json) {
+		return new this(
+			json.instanceName,
+			json.instanceId,
+			json.mode,
+			json.token,
+			json.dataSet,
+			json.key,
+			json.toPrint,
+		);
+	}
+}
+
+// =========================================================================
+// Plugin manifest
+// =========================================================================
+
+const plugin = {
+	name: "comfy_adapter",
+	title: "Comfy Adapter",
+	description:
+		"Parses stdout tags from factorio-polska scenario: forwards [DISCORD*]/[ANTIGRIEF-LOG] to Discord " +
+		"(via discord_bridge channel routing) and persists [DATA-SET]/[DATA-GET] in a JSON file on the controller.",
+	instanceEntrypoint: "instance",
+	controllerEntrypoint: "controller",
+	instanceConfigFields: {},
+	controllerConfigFields: {
+		"comfy_adapter.storage_path": {
+			title: "Datastore path",
+			description:
+				"Path to the JSON file where comfy_adapter persists scenario datasets " +
+				"(sessions, future: jailed, warnings, ...). Path is relative to the controller's " +
+				"working directory unless absolute. Created on first write.",
+			type: "string",
+			initialValue: "comfy_adapter_storage.json",
+		},
+		"comfy_adapter.write_debounce_ms": {
+			title: "Write debounce (ms)",
+			description:
+				"Coalesce multiple [DATA-SET] writes within this window into a single disk flush. " +
+				"Reduces fsync churn at the cost of risking up to N ms of data loss on crash.",
+			type: "number",
+			initialValue: 1000,
+		},
+		"comfy_adapter.antigrief_log_as_embed": {
+			title: "Antigrief log as embed",
+			description:
+				"If true, [ANTIGRIEF-LOG] events are sent to Discord as color-coded embeds. " +
+				"If false, sent as plain `[ANTIGRIEF: <category>] <action>` messages.",
+			type: "boolean",
+			initialValue: true,
+		},
+		"comfy_adapter.admin_prefix": {
+			title: "Admin message prefix",
+			description:
+				"Prefix prepended to messages from [DISCORD-ADMIN*] tags before sending to the instance " +
+				"channel. The factorio-polska model uses a single Discord channel per instance, so admin " +
+				"messages are distinguished by prefix rather than a separate channel.",
+			type: "string",
+			initialValue: "[ADMIN] ",
+		},
+		"comfy_adapter.broadcast_data_sets": {
+			title: "Broadcast datasets",
+			description:
+				"Comma-separated list of dataset names whose [DATA-SET] writes are broadcast to ALL OTHER " +
+				"instances via /cc Server.raise_data_set(...). Enables cross-server sync (e.g., player trust " +
+				"earned on instance A is propagated to instance B immediately, instead of requiring B to " +
+				"refetch on next join). Leave empty to disable broadcast entirely. Default 'sessions' covers " +
+				"auto-trust playtime; add other datasets here as the scenario grows.",
+			type: "string",
+			initialValue: "sessions",
+		},
+	},
+
+	messages: [
+		ScenarioDiscordEvent,
+		AntigriefLogEvent,
+		DataSetEvent,
+		DataGetRequest,
+	],
+};
+
+module.exports = {
+	plugin,
+	ScenarioDiscordEvent,
+	AntigriefLogEvent,
+	DataSetEvent,
+	DataGetRequest,
+};

package/instance.js

@@ -0,0 +1,303 @@
+"use strict";
+// factorio-polska / comfy_adapter — instance plugin (Faza 2.5).
+//
+// Hook `onOutput` łapie każdą linię stdout scenariusza (output.message). Linie zaczynające się
+// od `[<TAG>]` parsuje wg jednej z 13 form:
+//
+//   Discord (10 wariantów):
+//     [DISCORD]<msg>             [DISCORD-RAW]<msg>            [DISCORD-BOLD]<msg>
+//     [DISCORD-ADMIN]<msg>       [DISCORD-ADMIN-RAW]<msg>
+//     [DISCORD-EMBED]<msg>       [DISCORD-EMBED-RAW]<msg>      [DISCORD-EMBED-PARSED]<json>
+//     [DISCORD-ADMIN-EMBED]<msg> [DISCORD-ADMIN-EMBED-RAW]<msg>
+//
+//   Antigrief log (1):
+//     [ANTIGRIEF-LOG]{category:"X",action:"Y"}
+//
+//   Datastore (4):
+//     [DATA-SET]{data_set:"X",key:"Y",value:Z?}     (Z = nil → DELETE)
+//     [DATA-GET]<token> {data_set:"X",key:"Y"}
+//     [DATA-GET-AND-PRINT]<token> {data_set:"X",key:"Y",to_print:"Z"}
+//     [DATA-GET-ALL]<token> {data_set:"X"}
+//
+// Payload format (`{key:"val",...}`) to **pseudo-JSON Comfy** — keys bez cudzysłowów,
+// values w double-quotes (string/number/boolean) lub single-quotes (serpent table).
+// Specjalna funkcja `parseComfyPayload` poniżej robi minimalny parser pod ten format.
+
+const { BaseInstancePlugin } = require("@clusterio/host");
+
+const {
+	ScenarioDiscordEvent,
+	AntigriefLogEvent,
+	DataSetEvent,
+	DataGetRequest,
+} = require("./info.js");
+
+
+// Stały zbiór nazw tagów Discord → variant string przekazywany w ScenarioDiscordEvent.
+const DISCORD_VARIANTS = new Set([
+	"DISCORD",
+	"DISCORD-RAW",
+	"DISCORD-BOLD",
+	"DISCORD-ADMIN",
+	"DISCORD-ADMIN-RAW",
+	"DISCORD-EMBED",
+	"DISCORD-EMBED-RAW",
+	"DISCORD-EMBED-PARSED",
+	"DISCORD-ADMIN-EMBED",
+	"DISCORD-ADMIN-EMBED-RAW",
+]);
+
+// `[TAG]<reszta>` — TAG to wielkie litery + myślniki.
+const TAG_RE = /^\[([A-Z][A-Z0-9-]*)\](.*)$/;
+
+// `[DATA-GET]<token> {payload}` (i warianty get_and_print / get_all).
+const DATA_GET_RE = /^(\d+)\s*(\{.*\})$/;
+
+
+/**
+ * Mini-parser pseudo-Lua-JSON format z Comfy: `{key:"val",key2:N,key3:"str"}`.
+ * - Klucze bez cudzysłowów (identyfikatory: [a-zA-Z_][a-zA-Z0-9_]*).
+ * - Stringi w double-quotes z escapami: \" \\ \n
+ * - Numery bez cudzysłowów (mimo że Lua side często wrapuje liczby w stringi).
+ * - Boolean: true / false.
+ * - Nested object: { ... }
+ *
+ * Zwraca obiekt JS lub rzuca Error przy malformed input.
+ */
+function parseComfyPayload(s) {
+	let i = 0;
+	const len = s.length;
+
+	function skipWs() {
+		while (i < len && (s[i] === " " || s[i] === "\t" || s[i] === "\n")) {
+			i++;
+		}
+	}
+
+	function expect(ch) {
+		if (s[i] !== ch) {
+			throw new Error(`parseComfyPayload: expected '${ch}' at pos ${i} in: ${s}`);
+		}
+		i++;
+	}
+
+	function parseString() {
+		const quote = s[i];
+		if (quote !== '"' && quote !== "'") {
+			throw new Error(`parseComfyPayload: expected string at pos ${i} in: ${s}`);
+		}
+		i++;
+		let out = "";
+		while (i < len && s[i] !== quote) {
+			if (s[i] === "\\" && i + 1 < len) {
+				const next = s[i + 1];
+				if (next === "n") { out += "\n"; }
+				else if (next === "t") { out += "\t"; }
+				else if (next === "r") { out += "\r"; }
+				else { out += next; }
+				i += 2;
+			} else {
+				out += s[i];
+				i++;
+			}
+		}
+		if (i >= len) {
+			throw new Error(`parseComfyPayload: unterminated string in: ${s}`);
+		}
+		i++; // closing quote
+		return out;
+	}
+
+	function parseIdent() {
+		const start = i;
+		while (i < len && /[a-zA-Z0-9_]/.test(s[i])) {
+			i++;
+		}
+		if (i === start) {
+			throw new Error(`parseComfyPayload: expected identifier at pos ${i} in: ${s}`);
+		}
+		return s.slice(start, i);
+	}
+
+	function parseValue() {
+		skipWs();
+		const ch = s[i];
+		if (ch === '"' || ch === "'") {
+			return parseString();
+		}
+		if (ch === "{") {
+			return parseObject();
+		}
+		// Number / boolean / bareword (np. nil).
+		const start = i;
+		while (i < len && /[^,}\s]/.test(s[i])) {
+			i++;
+		}
+		const raw = s.slice(start, i);
+		if (raw === "true") return true;
+		if (raw === "false") return false;
+		if (raw === "nil") return null;
+		const num = Number(raw);
+		if (!Number.isNaN(num)) return num;
+		// Fallback: traktuj jako string bez cudzysłowów (defensive).
+		return raw;
+	}
+
+	function parseObject() {
+		expect("{");
+		const out = {};
+		skipWs();
+		if (s[i] === "}") { i++; return out; }
+		while (i < len) {
+			skipWs();
+			const key = parseIdent();
+			skipWs();
+			expect(":");
+			out[key] = parseValue();
+			skipWs();
+			if (s[i] === ",") { i++; continue; }
+			if (s[i] === "}") { i++; break; }
+			throw new Error(`parseComfyPayload: expected ',' or '}' at pos ${i} in: ${s}`);
+		}
+		return out;
+	}
+
+	skipWs();
+	const obj = parseObject();
+	skipWs();
+	if (i < len) {
+		throw new Error(`parseComfyPayload: trailing data at pos ${i} in: ${s}`);
+	}
+	return obj;
+}
+
+
+class InstancePlugin extends BaseInstancePlugin {
+	async init() {
+		this.messageQueue = [];
+	}
+
+	onControllerConnectionEvent(event) {
+		if (event === "connect" && this.messageQueue.length > 0) {
+			for (const ev of this.messageQueue) {
+				this.instance.sendTo("controller", ev);
+			}
+			this.messageQueue = [];
+		}
+	}
+
+	/**
+	 * Wysyła event do kontrolera, lub buforuje gdy host disconnected.
+	 */
+	sendOrQueue(event) {
+		if (this.host.connector.connected) {
+			this.instance.sendTo("controller", event);
+		} else {
+			this.messageQueue.push(event);
+		}
+	}
+
+	/**
+	 * Hook clusterio: każda linia stdout scenariusza.
+	 */
+	async onOutput(output) {
+		// `output.type` może być "action" (Factorio's [JOIN]/[LEAVE]/... built-in tags handled
+		// przez discord_bridge) lub generic. Tagi naszego scenariusza idą zwykle przez
+		// `raw_print` (Lua native `print` → stdout) co clusterio kategorizuje jako "generic".
+		// Akceptujemy wszystkie typy — filtr jest na regex tagu.
+		const line = output.message;
+		if (!line || typeof line !== "string") return;
+
+		const match = line.match(TAG_RE);
+		if (!match) return;
+
+		const tag = match[1];
+		const rest = match[2];
+
+		try {
+			if (DISCORD_VARIANTS.has(tag)) {
+				this.handleDiscordTag(tag, rest);
+			} else if (tag === "ANTIGRIEF-LOG") {
+				this.handleAntigriefLog(rest);
+			} else if (tag === "DATA-SET") {
+				this.handleDataSet(rest);
+			} else if (tag === "DATA-GET") {
+				this.handleDataGet(rest, "get");
+			} else if (tag === "DATA-GET-AND-PRINT") {
+				this.handleDataGet(rest, "get_and_print");
+			} else if (tag === "DATA-GET-ALL") {
+				this.handleDataGet(rest, "get_all");
+			}
+			// Pozostałe tagi (np. [BAN-SYNC], [PING], [START-SCENARIO]) — silent skip.
+			// Bany robi clusterio natywnie, lifecycle nie używamy w naszym modelu.
+		} catch (err) {
+			this.logger.warn(`comfy_adapter parse error for "${tag}": ${err.message}`);
+		}
+	}
+
+	handleDiscordTag(variant, content) {
+		this.sendOrQueue(new ScenarioDiscordEvent(this.instance.name, variant, content));
+	}
+
+	handleAntigriefLog(payload) {
+		const obj = parseComfyPayload(payload);
+		const category = String(obj.category ?? "unknown");
+		const action = String(obj.action ?? "");
+		this.sendOrQueue(new AntigriefLogEvent(this.instance.name, category, action));
+	}
+
+	handleDataSet(payload) {
+		const obj = parseComfyPayload(payload);
+		const dataSet = String(obj.data_set ?? "");
+		const key = String(obj.key ?? "");
+		// Lua side wrapuje numery jako stringi (`value:"648000"`); spróbuj odzyskać typ.
+		let value = obj.value;
+		if (value === undefined) {
+			value = null; // DELETE
+		} else if (typeof value === "string") {
+			// String z escapowanym wewnętrznym cudzysłowem (`value:"\"actual\""`) → unwrap.
+			if (value.length >= 2 && value[0] === '"' && value[value.length - 1] === '"') {
+				value = value.slice(1, -1);
+			} else if (value === "true") {
+				value = true;
+			} else if (value === "false") {
+				value = false;
+			} else {
+				const num = Number(value);
+				if (!Number.isNaN(num) && value.trim() !== "") {
+					value = num;
+				}
+				// Else: pozostaje string (np. serpent-serialized table — controller deserializuje).
+			}
+		}
+		this.sendOrQueue(new DataSetEvent(this.instance.name, dataSet, key, value));
+	}
+
+	handleDataGet(rest, mode) {
+		// Format: `<token> {payload}` (z opcjonalnym whitespace).
+		const m = rest.match(DATA_GET_RE);
+		if (!m) {
+			throw new Error(`malformed DATA-GET payload: ${rest}`);
+		}
+		const token = parseInt(m[1], 10);
+		const obj = parseComfyPayload(m[2]);
+		const dataSet = String(obj.data_set ?? "");
+		const key = obj.key !== undefined ? String(obj.key) : null;
+		const toPrint = obj.to_print !== undefined ? String(obj.to_print) : null;
+		this.sendOrQueue(new DataGetRequest(
+			this.instance.name,
+			this.instance.id,
+			mode,
+			token,
+			dataSet,
+			key,
+			toPrint,
+		));
+	}
+}
+
+module.exports = {
+	InstancePlugin,
+	// Eksport dla unit testów (przyszłość — żaden plik testowy w Fazie 2.5).
+	_parseComfyPayload: parseComfyPayload,
+};