@milaboratories/pl-mcp-server 0.2.0

package/dist/tools/ping.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ping.cjs","names":["textResult"],"sources":["../../src/tools/ping.ts"],"sourcesContent":["import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { ToolContext } from \"./types\";\nimport { textResult } from \"./types\";\n\nexport function registerPingTool(server: McpServer, ctx: ToolContext): void {\n  server.registerTool(\"ping\", { description: \"Health check\" }, async () => {\n    return textResult({ status: \"ok\", connected: !!ctx.getMl() });\n  });\n}\n"],"mappings":";;AAIA,SAAgB,iBAAiB,QAAmB,KAAwB;AAC1E,QAAO,aAAa,QAAQ,EAAE,aAAa,gBAAgB,EAAE,YAAY;AACvE,SAAOA,cAAAA,WAAW;GAAE,QAAQ;GAAM,WAAW,CAAC,CAAC,IAAI,OAAO;GAAE,CAAC;GAC7D"}

package/dist/tools/ping.js

@@ -0,0 +1,14 @@
+import { textResult } from "./types.js";
+//#region src/tools/ping.ts
+function registerPingTool(server, ctx) {
+	server.registerTool("ping", { description: "Health check" }, async () => {
+		return textResult({
+			status: "ok",
+			connected: !!ctx.getMl()
+		});
+	});
+}
+//#endregion
+export { registerPingTool };
+
+//# sourceMappingURL=ping.js.map

package/dist/tools/ping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ping.js","names":[],"sources":["../../src/tools/ping.ts"],"sourcesContent":["import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport type { ToolContext } from \"./types\";\nimport { textResult } from \"./types\";\n\nexport function registerPingTool(server: McpServer, ctx: ToolContext): void {\n  server.registerTool(\"ping\", { description: \"Health check\" }, async () => {\n    return textResult({ status: \"ok\", connected: !!ctx.getMl() });\n  });\n}\n"],"mappings":";;AAIA,SAAgB,iBAAiB,QAAmB,KAAwB;AAC1E,QAAO,aAAa,QAAQ,EAAE,aAAa,gBAAgB,EAAE,YAAY;AACvE,SAAO,WAAW;GAAE,QAAQ;GAAM,WAAW,CAAC,CAAC,IAAI,OAAO;GAAE,CAAC;GAC7D"}

package/dist/tools/projects.cjs

@@ -0,0 +1,56 @@
+const require_types = require("./types.cjs");
+let _milaboratories_pl_middle_layer = require("@milaboratories/pl-middle-layer");
+let zod = require("zod");
+//#region src/tools/projects.ts
+function registerProjectTools(server, ctx) {
+	server.registerTool("list_projects", { description: "List all projects with their IDs, labels, and status" }, async () => {
+		const ml = ctx.requireMl();
+		await ml.projectList.refreshState();
+		return require_types.textResult((await ml.projectList.awaitStableValue()).map((p) => ({
+			projectId: (0, _milaboratories_pl_middle_layer.resourceIdToString)(p.rid),
+			label: p.meta.label,
+			opened: p.opened,
+			created: p.created.toISOString(),
+			lastModified: p.lastModified.toISOString()
+		})));
+	});
+	server.registerTool("create_project", {
+		description: "Create a new project",
+		inputSchema: { label: zod.z.string().describe("Project name") }
+	}, async ({ label }) => {
+		const projectId = (0, _milaboratories_pl_middle_layer.resourceIdToString)(await ctx.requireMl().createProject({ label }));
+		await ctx.callbacks.onProjectCreated?.(projectId);
+		return require_types.textResult({ projectId });
+	});
+	server.registerTool("open_project", {
+		description: "Open a project for editing. Required before working with blocks.",
+		inputSchema: { projectId: zod.z.string().describe("Project ID from list_projects or create_project") }
+	}, async ({ projectId }) => {
+		const entry = await ctx.resolveProject(projectId);
+		await ctx.requireMl().openProject(entry.rid);
+		await ctx.callbacks.onProjectOpened?.(projectId);
+		return require_types.textResult({ ok: true });
+	});
+	server.registerTool("close_project", {
+		description: "Close an opened project, releasing its resources",
+		inputSchema: { projectId: zod.z.string().describe("Project ID") }
+	}, async ({ projectId }) => {
+		const entry = await ctx.resolveProject(projectId);
+		await ctx.requireMl().closeProject(entry.rid);
+		await ctx.callbacks.onProjectClosed?.(projectId);
+		return require_types.textResult({ ok: true });
+	});
+	server.registerTool("delete_project", {
+		description: "Delete a project permanently. The project must be closed first.",
+		inputSchema: { projectId: zod.z.string().describe("Project ID") }
+	}, async ({ projectId }) => {
+		const entry = await ctx.resolveProject(projectId);
+		await ctx.requireMl().deleteProject(entry.id);
+		await ctx.callbacks.onProjectDeleted?.(projectId);
+		return require_types.textResult({ ok: true });
+	});
+}
+//#endregion
+exports.registerProjectTools = registerProjectTools;
+
+//# sourceMappingURL=projects.cjs.map

package/dist/tools/projects.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.cjs","names":["textResult","z"],"sources":["../../src/tools/projects.ts"],"sourcesContent":["import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { resourceIdToString } from \"@milaboratories/pl-middle-layer\";\nimport { z } from \"zod\";\nimport type { ToolContext } from \"./types\";\nimport { textResult } from \"./types\";\n\nexport function registerProjectTools(server: McpServer, ctx: ToolContext): void {\n  server.registerTool(\n    \"list_projects\",\n    { description: \"List all projects with their IDs, labels, and status\" },\n    async () => {\n      const ml = ctx.requireMl();\n      await ml.projectList.refreshState();\n      const projects = await ml.projectList.awaitStableValue();\n      return textResult(\n        projects.map((p) => ({\n          projectId: resourceIdToString(p.rid),\n          label: p.meta.label,\n          opened: p.opened,\n          created: p.created.toISOString(),\n          lastModified: p.lastModified.toISOString(),\n        })),\n      );\n    },\n  );\n\n  server.registerTool(\n    \"create_project\",\n    {\n      description: \"Create a new project\",\n      inputSchema: { label: z.string().describe(\"Project name\") },\n    },\n    async ({ label }) => {\n      const rid = await ctx.requireMl().createProject({ label });\n      const projectId = resourceIdToString(rid);\n      await ctx.callbacks.onProjectCreated?.(projectId);\n      return textResult({ projectId });\n    },\n  );\n\n  server.registerTool(\n    \"open_project\",\n    {\n      description: \"Open a project for editing. Required before working with blocks.\",\n      inputSchema: {\n        projectId: z.string().describe(\"Project ID from list_projects or create_project\"),\n      },\n    },\n    async ({ projectId }) => {\n      const entry = await ctx.resolveProject(projectId);\n      await ctx.requireMl().openProject(entry.rid);\n      await ctx.callbacks.onProjectOpened?.(projectId);\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"close_project\",\n    {\n      description: \"Close an opened project, releasing its resources\",\n      inputSchema: { projectId: z.string().describe(\"Project ID\") },\n    },\n    async ({ projectId }) => {\n      const entry = await ctx.resolveProject(projectId);\n      await ctx.requireMl().closeProject(entry.rid);\n      await ctx.callbacks.onProjectClosed?.(projectId);\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"delete_project\",\n    {\n      description: \"Delete a project permanently. The project must be closed first.\",\n      inputSchema: { projectId: z.string().describe(\"Project ID\") },\n    },\n    async ({ projectId }) => {\n      const entry = await ctx.resolveProject(projectId);\n      await ctx.requireMl().deleteProject(entry.id);\n      await ctx.callbacks.onProjectDeleted?.(projectId);\n      return textResult({ ok: true });\n    },\n  );\n}\n"],"mappings":";;;;AAMA,SAAgB,qBAAqB,QAAmB,KAAwB;AAC9E,QAAO,aACL,iBACA,EAAE,aAAa,wDAAwD,EACvE,YAAY;EACV,MAAM,KAAK,IAAI,WAAW;AAC1B,QAAM,GAAG,YAAY,cAAc;AAEnC,SAAOA,cAAAA,YADU,MAAM,GAAG,YAAY,kBAAkB,EAE7C,KAAK,OAAO;GACnB,YAAA,GAAA,gCAAA,oBAA8B,EAAE,IAAI;GACpC,OAAO,EAAE,KAAK;GACd,QAAQ,EAAE;GACV,SAAS,EAAE,QAAQ,aAAa;GAChC,cAAc,EAAE,aAAa,aAAa;GAC3C,EAAE,CACJ;GAEJ;AAED,QAAO,aACL,kBACA;EACE,aAAa;EACb,aAAa,EAAE,OAAOC,IAAAA,EAAE,QAAQ,CAAC,SAAS,eAAe,EAAE;EAC5D,EACD,OAAO,EAAE,YAAY;EAEnB,MAAM,aAAA,GAAA,gCAAA,oBADM,MAAM,IAAI,WAAW,CAAC,cAAc,EAAE,OAAO,CAAC,CACjB;AACzC,QAAM,IAAI,UAAU,mBAAmB,UAAU;AACjD,SAAOD,cAAAA,WAAW,EAAE,WAAW,CAAC;GAEnC;AAED,QAAO,aACL,gBACA;EACE,aAAa;EACb,aAAa,EACX,WAAWC,IAAAA,EAAE,QAAQ,CAAC,SAAS,kDAAkD,EAClF;EACF,EACD,OAAO,EAAE,gBAAgB;EACvB,MAAM,QAAQ,MAAM,IAAI,eAAe,UAAU;AACjD,QAAM,IAAI,WAAW,CAAC,YAAY,MAAM,IAAI;AAC5C,QAAM,IAAI,UAAU,kBAAkB,UAAU;AAChD,SAAOD,cAAAA,WAAW,EAAE,IAAI,MAAM,CAAC;GAElC;AAED,QAAO,aACL,iBACA;EACE,aAAa;EACb,aAAa,EAAE,WAAWC,IAAAA,EAAE,QAAQ,CAAC,SAAS,aAAa,EAAE;EAC9D,EACD,OAAO,EAAE,gBAAgB;EACvB,MAAM,QAAQ,MAAM,IAAI,eAAe,UAAU;AACjD,QAAM,IAAI,WAAW,CAAC,aAAa,MAAM,IAAI;AAC7C,QAAM,IAAI,UAAU,kBAAkB,UAAU;AAChD,SAAOD,cAAAA,WAAW,EAAE,IAAI,MAAM,CAAC;GAElC;AAED,QAAO,aACL,kBACA;EACE,aAAa;EACb,aAAa,EAAE,WAAWC,IAAAA,EAAE,QAAQ,CAAC,SAAS,aAAa,EAAE;EAC9D,EACD,OAAO,EAAE,gBAAgB;EACvB,MAAM,QAAQ,MAAM,IAAI,eAAe,UAAU;AACjD,QAAM,IAAI,WAAW,CAAC,cAAc,MAAM,GAAG;AAC7C,QAAM,IAAI,UAAU,mBAAmB,UAAU;AACjD,SAAOD,cAAAA,WAAW,EAAE,IAAI,MAAM,CAAC;GAElC"}

package/dist/tools/projects.js

@@ -0,0 +1,56 @@
+import { textResult } from "./types.js";
+import { resourceIdToString } from "@milaboratories/pl-middle-layer";
+import { z } from "zod";
+//#region src/tools/projects.ts
+function registerProjectTools(server, ctx) {
+	server.registerTool("list_projects", { description: "List all projects with their IDs, labels, and status" }, async () => {
+		const ml = ctx.requireMl();
+		await ml.projectList.refreshState();
+		return textResult((await ml.projectList.awaitStableValue()).map((p) => ({
+			projectId: resourceIdToString(p.rid),
+			label: p.meta.label,
+			opened: p.opened,
+			created: p.created.toISOString(),
+			lastModified: p.lastModified.toISOString()
+		})));
+	});
+	server.registerTool("create_project", {
+		description: "Create a new project",
+		inputSchema: { label: z.string().describe("Project name") }
+	}, async ({ label }) => {
+		const projectId = resourceIdToString(await ctx.requireMl().createProject({ label }));
+		await ctx.callbacks.onProjectCreated?.(projectId);
+		return textResult({ projectId });
+	});
+	server.registerTool("open_project", {
+		description: "Open a project for editing. Required before working with blocks.",
+		inputSchema: { projectId: z.string().describe("Project ID from list_projects or create_project") }
+	}, async ({ projectId }) => {
+		const entry = await ctx.resolveProject(projectId);
+		await ctx.requireMl().openProject(entry.rid);
+		await ctx.callbacks.onProjectOpened?.(projectId);
+		return textResult({ ok: true });
+	});
+	server.registerTool("close_project", {
+		description: "Close an opened project, releasing its resources",
+		inputSchema: { projectId: z.string().describe("Project ID") }
+	}, async ({ projectId }) => {
+		const entry = await ctx.resolveProject(projectId);
+		await ctx.requireMl().closeProject(entry.rid);
+		await ctx.callbacks.onProjectClosed?.(projectId);
+		return textResult({ ok: true });
+	});
+	server.registerTool("delete_project", {
+		description: "Delete a project permanently. The project must be closed first.",
+		inputSchema: { projectId: z.string().describe("Project ID") }
+	}, async ({ projectId }) => {
+		const entry = await ctx.resolveProject(projectId);
+		await ctx.requireMl().deleteProject(entry.id);
+		await ctx.callbacks.onProjectDeleted?.(projectId);
+		return textResult({ ok: true });
+	});
+}
+//#endregion
+export { registerProjectTools };
+
+//# sourceMappingURL=projects.js.map

package/dist/tools/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","names":[],"sources":["../../src/tools/projects.ts"],"sourcesContent":["import type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { resourceIdToString } from \"@milaboratories/pl-middle-layer\";\nimport { z } from \"zod\";\nimport type { ToolContext } from \"./types\";\nimport { textResult } from \"./types\";\n\nexport function registerProjectTools(server: McpServer, ctx: ToolContext): void {\n  server.registerTool(\n    \"list_projects\",\n    { description: \"List all projects with their IDs, labels, and status\" },\n    async () => {\n      const ml = ctx.requireMl();\n      await ml.projectList.refreshState();\n      const projects = await ml.projectList.awaitStableValue();\n      return textResult(\n        projects.map((p) => ({\n          projectId: resourceIdToString(p.rid),\n          label: p.meta.label,\n          opened: p.opened,\n          created: p.created.toISOString(),\n          lastModified: p.lastModified.toISOString(),\n        })),\n      );\n    },\n  );\n\n  server.registerTool(\n    \"create_project\",\n    {\n      description: \"Create a new project\",\n      inputSchema: { label: z.string().describe(\"Project name\") },\n    },\n    async ({ label }) => {\n      const rid = await ctx.requireMl().createProject({ label });\n      const projectId = resourceIdToString(rid);\n      await ctx.callbacks.onProjectCreated?.(projectId);\n      return textResult({ projectId });\n    },\n  );\n\n  server.registerTool(\n    \"open_project\",\n    {\n      description: \"Open a project for editing. Required before working with blocks.\",\n      inputSchema: {\n        projectId: z.string().describe(\"Project ID from list_projects or create_project\"),\n      },\n    },\n    async ({ projectId }) => {\n      const entry = await ctx.resolveProject(projectId);\n      await ctx.requireMl().openProject(entry.rid);\n      await ctx.callbacks.onProjectOpened?.(projectId);\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"close_project\",\n    {\n      description: \"Close an opened project, releasing its resources\",\n      inputSchema: { projectId: z.string().describe(\"Project ID\") },\n    },\n    async ({ projectId }) => {\n      const entry = await ctx.resolveProject(projectId);\n      await ctx.requireMl().closeProject(entry.rid);\n      await ctx.callbacks.onProjectClosed?.(projectId);\n      return textResult({ ok: true });\n    },\n  );\n\n  server.registerTool(\n    \"delete_project\",\n    {\n      description: \"Delete a project permanently. The project must be closed first.\",\n      inputSchema: { projectId: z.string().describe(\"Project ID\") },\n    },\n    async ({ projectId }) => {\n      const entry = await ctx.resolveProject(projectId);\n      await ctx.requireMl().deleteProject(entry.id);\n      await ctx.callbacks.onProjectDeleted?.(projectId);\n      return textResult({ ok: true });\n    },\n  );\n}\n"],"mappings":";;;;AAMA,SAAgB,qBAAqB,QAAmB,KAAwB;AAC9E,QAAO,aACL,iBACA,EAAE,aAAa,wDAAwD,EACvE,YAAY;EACV,MAAM,KAAK,IAAI,WAAW;AAC1B,QAAM,GAAG,YAAY,cAAc;AAEnC,SAAO,YADU,MAAM,GAAG,YAAY,kBAAkB,EAE7C,KAAK,OAAO;GACnB,WAAW,mBAAmB,EAAE,IAAI;GACpC,OAAO,EAAE,KAAK;GACd,QAAQ,EAAE;GACV,SAAS,EAAE,QAAQ,aAAa;GAChC,cAAc,EAAE,aAAa,aAAa;GAC3C,EAAE,CACJ;GAEJ;AAED,QAAO,aACL,kBACA;EACE,aAAa;EACb,aAAa,EAAE,OAAO,EAAE,QAAQ,CAAC,SAAS,eAAe,EAAE;EAC5D,EACD,OAAO,EAAE,YAAY;EAEnB,MAAM,YAAY,mBADN,MAAM,IAAI,WAAW,CAAC,cAAc,EAAE,OAAO,CAAC,CACjB;AACzC,QAAM,IAAI,UAAU,mBAAmB,UAAU;AACjD,SAAO,WAAW,EAAE,WAAW,CAAC;GAEnC;AAED,QAAO,aACL,gBACA;EACE,aAAa;EACb,aAAa,EACX,WAAW,EAAE,QAAQ,CAAC,SAAS,kDAAkD,EAClF;EACF,EACD,OAAO,EAAE,gBAAgB;EACvB,MAAM,QAAQ,MAAM,IAAI,eAAe,UAAU;AACjD,QAAM,IAAI,WAAW,CAAC,YAAY,MAAM,IAAI;AAC5C,QAAM,IAAI,UAAU,kBAAkB,UAAU;AAChD,SAAO,WAAW,EAAE,IAAI,MAAM,CAAC;GAElC;AAED,QAAO,aACL,iBACA;EACE,aAAa;EACb,aAAa,EAAE,WAAW,EAAE,QAAQ,CAAC,SAAS,aAAa,EAAE;EAC9D,EACD,OAAO,EAAE,gBAAgB;EACvB,MAAM,QAAQ,MAAM,IAAI,eAAe,UAAU;AACjD,QAAM,IAAI,WAAW,CAAC,aAAa,MAAM,IAAI;AAC7C,QAAM,IAAI,UAAU,kBAAkB,UAAU;AAChD,SAAO,WAAW,EAAE,IAAI,MAAM,CAAC;GAElC;AAED,QAAO,aACL,kBACA;EACE,aAAa;EACb,aAAa,EAAE,WAAW,EAAE,QAAQ,CAAC,SAAS,aAAa,EAAE;EAC9D,EACD,OAAO,EAAE,gBAAgB;EACvB,MAAM,QAAQ,MAAM,IAAI,eAAe,UAAU;AACjD,QAAM,IAAI,WAAW,CAAC,cAAc,MAAM,GAAG;AAC7C,QAAM,IAAI,UAAU,mBAAmB,UAAU;AACjD,SAAO,WAAW,EAAE,IAAI,MAAM,CAAC;GAElC"}

package/dist/tools/sandbox.cjs

@@ -0,0 +1,51 @@
+let quickjs_emscripten = require("quickjs-emscripten");
+//#region src/tools/sandbox.ts
+/** Lazily initialized QuickJS runtime shared across evaluations. */
+let sharedRuntime;
+async function getRuntime() {
+	if (!sharedRuntime) {
+		sharedRuntime = (await (0, quickjs_emscripten.getQuickJS)()).newRuntime();
+		sharedRuntime.setMemoryLimit(1024 * 1024 * 16);
+		sharedRuntime.setMaxStackSize(1024 * 320);
+	}
+	return sharedRuntime;
+}
+/**
+* Evaluate a JS expression in a QuickJS sandbox.
+* Variables from `context` are injected as globals.
+* Data is marshaled via JSON — no access to Node APIs, filesystem, or process.
+*/
+async function safeEval(expression, context, timeout) {
+	const runtime = await getRuntime();
+	const deadline = Date.now() + timeout;
+	runtime.setInterruptHandler(() => Date.now() > deadline);
+	const vm = runtime.newContext();
+	try {
+		const contextJson = JSON.stringify(context);
+		const setup = `const __ctx = JSON.parse(${JSON.stringify(contextJson)});
+${Object.keys(context).map((k) => `const ${k} = __ctx[${JSON.stringify(k)}];`).join("\n")}`;
+		const setupResult = vm.evalCode(setup, "setup.js", { type: "global" });
+		if (setupResult.error) {
+			const err = vm.dump(setupResult.error);
+			setupResult.error.dispose();
+			throw new Error(`Context setup failed: ${err}`);
+		}
+		setupResult.value.dispose();
+		const result = vm.evalCode(`JSON.stringify((${expression}))`, "transform.js");
+		if (result.error) {
+			const err = vm.dump(result.error);
+			result.error.dispose();
+			throw new Error(String(err));
+		}
+		const json = vm.getString(result.value);
+		result.value.dispose();
+		return JSON.parse(json);
+	} finally {
+		runtime.setInterruptHandler(() => false);
+		vm.dispose();
+	}
+}
+//#endregion
+exports.safeEval = safeEval;
+
+//# sourceMappingURL=sandbox.cjs.map

package/dist/tools/sandbox.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.cjs","names":[],"sources":["../../src/tools/sandbox.ts"],"sourcesContent":["import { getQuickJS, type QuickJSRuntime } from \"quickjs-emscripten\";\n\n/** Lazily initialized QuickJS runtime shared across evaluations. */\nlet sharedRuntime: QuickJSRuntime | undefined;\n\nasync function getRuntime(): Promise<QuickJSRuntime> {\n  if (!sharedRuntime) {\n    const quickjs = await getQuickJS();\n    sharedRuntime = quickjs.newRuntime();\n    sharedRuntime.setMemoryLimit(1024 * 1024 * 16); // 16 MB\n    sharedRuntime.setMaxStackSize(1024 * 320);\n  }\n  return sharedRuntime;\n}\n\n/**\n * Evaluate a JS expression in a QuickJS sandbox.\n * Variables from `context` are injected as globals.\n * Data is marshaled via JSON — no access to Node APIs, filesystem, or process.\n */\nexport async function safeEval(\n  expression: string,\n  context: Record<string, unknown>,\n  timeout: number,\n): Promise<unknown> {\n  const runtime = await getRuntime();\n\n  // Set interrupt handler for timeout\n  const deadline = Date.now() + timeout;\n  runtime.setInterruptHandler(() => Date.now() > deadline);\n\n  const vm = runtime.newContext();\n  try {\n    // Inject context variables via JSON\n    const contextJson = JSON.stringify(context);\n    const setup = `const __ctx = JSON.parse(${JSON.stringify(contextJson)});\n${Object.keys(context)\n  .map((k) => `const ${k} = __ctx[${JSON.stringify(k)}];`)\n  .join(\"\\n\")}`;\n    const setupResult = vm.evalCode(setup, \"setup.js\", { type: \"global\" });\n    if (setupResult.error) {\n      const err = vm.dump(setupResult.error);\n      setupResult.error.dispose();\n      throw new Error(`Context setup failed: ${err}`);\n    }\n    setupResult.value.dispose();\n\n    // Evaluate the expression\n    const result = vm.evalCode(`JSON.stringify((${expression}))`, \"transform.js\");\n    if (result.error) {\n      const err = vm.dump(result.error);\n      result.error.dispose();\n      throw new Error(String(err));\n    }\n    const json = vm.getString(result.value);\n    result.value.dispose();\n    return JSON.parse(json);\n  } finally {\n    runtime.setInterruptHandler(() => false);\n    vm.dispose();\n  }\n}\n"],"mappings":";;;AAGA,IAAI;AAEJ,eAAe,aAAsC;AACnD,KAAI,CAAC,eAAe;AAElB,mBADgB,OAAA,GAAA,mBAAA,aAAkB,EACV,YAAY;AACpC,gBAAc,eAAe,OAAO,OAAO,GAAG;AAC9C,gBAAc,gBAAgB,OAAO,IAAI;;AAE3C,QAAO;;;;;;;AAQT,eAAsB,SACpB,YACA,SACA,SACkB;CAClB,MAAM,UAAU,MAAM,YAAY;CAGlC,MAAM,WAAW,KAAK,KAAK,GAAG;AAC9B,SAAQ,0BAA0B,KAAK,KAAK,GAAG,SAAS;CAExD,MAAM,KAAK,QAAQ,YAAY;AAC/B,KAAI;EAEF,MAAM,cAAc,KAAK,UAAU,QAAQ;EAC3C,MAAM,QAAQ,4BAA4B,KAAK,UAAU,YAAY,CAAC;EACxE,OAAO,KAAK,QAAQ,CACnB,KAAK,MAAM,SAAS,EAAE,WAAW,KAAK,UAAU,EAAE,CAAC,IAAI,CACvD,KAAK,KAAK;EACT,MAAM,cAAc,GAAG,SAAS,OAAO,YAAY,EAAE,MAAM,UAAU,CAAC;AACtE,MAAI,YAAY,OAAO;GACrB,MAAM,MAAM,GAAG,KAAK,YAAY,MAAM;AACtC,eAAY,MAAM,SAAS;AAC3B,SAAM,IAAI,MAAM,yBAAyB,MAAM;;AAEjD,cAAY,MAAM,SAAS;EAG3B,MAAM,SAAS,GAAG,SAAS,mBAAmB,WAAW,KAAK,eAAe;AAC7E,MAAI,OAAO,OAAO;GAChB,MAAM,MAAM,GAAG,KAAK,OAAO,MAAM;AACjC,UAAO,MAAM,SAAS;AACtB,SAAM,IAAI,MAAM,OAAO,IAAI,CAAC;;EAE9B,MAAM,OAAO,GAAG,UAAU,OAAO,MAAM;AACvC,SAAO,MAAM,SAAS;AACtB,SAAO,KAAK,MAAM,KAAK;WACf;AACR,UAAQ,0BAA0B,MAAM;AACxC,KAAG,SAAS"}

package/dist/tools/sandbox.js

@@ -0,0 +1,51 @@
+import { getQuickJS } from "quickjs-emscripten";
+//#region src/tools/sandbox.ts
+/** Lazily initialized QuickJS runtime shared across evaluations. */
+let sharedRuntime;
+async function getRuntime() {
+	if (!sharedRuntime) {
+		sharedRuntime = (await getQuickJS()).newRuntime();
+		sharedRuntime.setMemoryLimit(1024 * 1024 * 16);
+		sharedRuntime.setMaxStackSize(1024 * 320);
+	}
+	return sharedRuntime;
+}
+/**
+* Evaluate a JS expression in a QuickJS sandbox.
+* Variables from `context` are injected as globals.
+* Data is marshaled via JSON — no access to Node APIs, filesystem, or process.
+*/
+async function safeEval(expression, context, timeout) {
+	const runtime = await getRuntime();
+	const deadline = Date.now() + timeout;
+	runtime.setInterruptHandler(() => Date.now() > deadline);
+	const vm = runtime.newContext();
+	try {
+		const contextJson = JSON.stringify(context);
+		const setup = `const __ctx = JSON.parse(${JSON.stringify(contextJson)});
+${Object.keys(context).map((k) => `const ${k} = __ctx[${JSON.stringify(k)}];`).join("\n")}`;
+		const setupResult = vm.evalCode(setup, "setup.js", { type: "global" });
+		if (setupResult.error) {
+			const err = vm.dump(setupResult.error);
+			setupResult.error.dispose();
+			throw new Error(`Context setup failed: ${err}`);
+		}
+		setupResult.value.dispose();
+		const result = vm.evalCode(`JSON.stringify((${expression}))`, "transform.js");
+		if (result.error) {
+			const err = vm.dump(result.error);
+			result.error.dispose();
+			throw new Error(String(err));
+		}
+		const json = vm.getString(result.value);
+		result.value.dispose();
+		return JSON.parse(json);
+	} finally {
+		runtime.setInterruptHandler(() => false);
+		vm.dispose();
+	}
+}
+//#endregion
+export { safeEval };
+
+//# sourceMappingURL=sandbox.js.map

package/dist/tools/sandbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sandbox.js","names":[],"sources":["../../src/tools/sandbox.ts"],"sourcesContent":["import { getQuickJS, type QuickJSRuntime } from \"quickjs-emscripten\";\n\n/** Lazily initialized QuickJS runtime shared across evaluations. */\nlet sharedRuntime: QuickJSRuntime | undefined;\n\nasync function getRuntime(): Promise<QuickJSRuntime> {\n  if (!sharedRuntime) {\n    const quickjs = await getQuickJS();\n    sharedRuntime = quickjs.newRuntime();\n    sharedRuntime.setMemoryLimit(1024 * 1024 * 16); // 16 MB\n    sharedRuntime.setMaxStackSize(1024 * 320);\n  }\n  return sharedRuntime;\n}\n\n/**\n * Evaluate a JS expression in a QuickJS sandbox.\n * Variables from `context` are injected as globals.\n * Data is marshaled via JSON — no access to Node APIs, filesystem, or process.\n */\nexport async function safeEval(\n  expression: string,\n  context: Record<string, unknown>,\n  timeout: number,\n): Promise<unknown> {\n  const runtime = await getRuntime();\n\n  // Set interrupt handler for timeout\n  const deadline = Date.now() + timeout;\n  runtime.setInterruptHandler(() => Date.now() > deadline);\n\n  const vm = runtime.newContext();\n  try {\n    // Inject context variables via JSON\n    const contextJson = JSON.stringify(context);\n    const setup = `const __ctx = JSON.parse(${JSON.stringify(contextJson)});\n${Object.keys(context)\n  .map((k) => `const ${k} = __ctx[${JSON.stringify(k)}];`)\n  .join(\"\\n\")}`;\n    const setupResult = vm.evalCode(setup, \"setup.js\", { type: \"global\" });\n    if (setupResult.error) {\n      const err = vm.dump(setupResult.error);\n      setupResult.error.dispose();\n      throw new Error(`Context setup failed: ${err}`);\n    }\n    setupResult.value.dispose();\n\n    // Evaluate the expression\n    const result = vm.evalCode(`JSON.stringify((${expression}))`, \"transform.js\");\n    if (result.error) {\n      const err = vm.dump(result.error);\n      result.error.dispose();\n      throw new Error(String(err));\n    }\n    const json = vm.getString(result.value);\n    result.value.dispose();\n    return JSON.parse(json);\n  } finally {\n    runtime.setInterruptHandler(() => false);\n    vm.dispose();\n  }\n}\n"],"mappings":";;;AAGA,IAAI;AAEJ,eAAe,aAAsC;AACnD,KAAI,CAAC,eAAe;AAElB,mBADgB,MAAM,YAAY,EACV,YAAY;AACpC,gBAAc,eAAe,OAAO,OAAO,GAAG;AAC9C,gBAAc,gBAAgB,OAAO,IAAI;;AAE3C,QAAO;;;;;;;AAQT,eAAsB,SACpB,YACA,SACA,SACkB;CAClB,MAAM,UAAU,MAAM,YAAY;CAGlC,MAAM,WAAW,KAAK,KAAK,GAAG;AAC9B,SAAQ,0BAA0B,KAAK,KAAK,GAAG,SAAS;CAExD,MAAM,KAAK,QAAQ,YAAY;AAC/B,KAAI;EAEF,MAAM,cAAc,KAAK,UAAU,QAAQ;EAC3C,MAAM,QAAQ,4BAA4B,KAAK,UAAU,YAAY,CAAC;EACxE,OAAO,KAAK,QAAQ,CACnB,KAAK,MAAM,SAAS,EAAE,WAAW,KAAK,UAAU,EAAE,CAAC,IAAI,CACvD,KAAK,KAAK;EACT,MAAM,cAAc,GAAG,SAAS,OAAO,YAAY,EAAE,MAAM,UAAU,CAAC;AACtE,MAAI,YAAY,OAAO;GACrB,MAAM,MAAM,GAAG,KAAK,YAAY,MAAM;AACtC,eAAY,MAAM,SAAS;AAC3B,SAAM,IAAI,MAAM,yBAAyB,MAAM;;AAEjD,cAAY,MAAM,SAAS;EAG3B,MAAM,SAAS,GAAG,SAAS,mBAAmB,WAAW,KAAK,eAAe;AAC7E,MAAI,OAAO,OAAO;GAChB,MAAM,MAAM,GAAG,KAAK,OAAO,MAAM;AACjC,UAAO,MAAM,SAAS;AACtB,SAAM,IAAI,MAAM,OAAO,IAAI,CAAC;;EAE9B,MAAM,OAAO,GAAG,UAAU,OAAO,MAAM;AACvC,SAAO,MAAM,SAAS;AACtB,SAAO,KAAK,MAAM,KAAK;WACf;AACR,UAAQ,0BAA0B,MAAM;AACxC,KAAG,SAAS"}

package/dist/tools/screenshot.cjs

@@ -0,0 +1,35 @@
+const require_types = require("./types.cjs");
+let zod = require("zod");
+let node_fs_promises = require("node:fs/promises");
+let node_path = require("node:path");
+//#region src/tools/screenshot.ts
+function registerScreenshotTool(server, ctx) {
+	server.registerTool("capture_screenshot", {
+		description: "Capture a screenshot of the current application window. Optionally save to a file.",
+		inputSchema: { savePath: zod.z.string().optional().describe("Absolute file path to save the screenshot as PNG. If omitted, returns the image inline only.") }
+	}, async ({ savePath }) => {
+		if (!ctx.callbacks.captureScreenshot) return require_types.errorResult("Screenshot capture is not available.", "Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log");
+		const base64Png = await ctx.callbacks.captureScreenshot();
+		if (savePath) {
+			const absPath = (0, node_path.resolve)(savePath);
+			await (0, node_fs_promises.writeFile)(absPath, Buffer.from(base64Png, "base64"), { flag: "wx" });
+			return { content: [{
+				type: "image",
+				data: base64Png,
+				mimeType: "image/png"
+			}, {
+				type: "text",
+				text: `Screenshot saved to ${absPath}`
+			}] };
+		}
+		return { content: [{
+			type: "image",
+			data: base64Png,
+			mimeType: "image/png"
+		}] };
+	});
+}
+//#endregion
+exports.registerScreenshotTool = registerScreenshotTool;
+
+//# sourceMappingURL=screenshot.cjs.map

package/dist/tools/screenshot.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.cjs","names":["z","errorResult"],"sources":["../../src/tools/screenshot.ts"],"sourcesContent":["import { writeFile } from \"node:fs/promises\";\nimport { resolve } from \"node:path\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport type { ToolContext } from \"./types\";\nimport { errorResult } from \"./types\";\n\nexport function registerScreenshotTool(server: McpServer, ctx: ToolContext): void {\n  server.registerTool(\n    \"capture_screenshot\",\n    {\n      description:\n        \"Capture a screenshot of the current application window. Optionally save to a file.\",\n      inputSchema: {\n        savePath: z\n          .string()\n          .optional()\n          .describe(\n            \"Absolute file path to save the screenshot as PNG. If omitted, returns the image inline only.\",\n          ),\n      },\n    },\n    async ({ savePath }: { savePath?: string }) => {\n      if (!ctx.callbacks.captureScreenshot) {\n        return errorResult(\n          \"Screenshot capture is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      const base64Png = await ctx.callbacks.captureScreenshot();\n\n      if (savePath) {\n        const absPath = resolve(savePath);\n        await writeFile(absPath, Buffer.from(base64Png, \"base64\"), { flag: \"wx\" });\n        return {\n          content: [\n            { type: \"image\" as const, data: base64Png, mimeType: \"image/png\" },\n            { type: \"text\" as const, text: `Screenshot saved to ${absPath}` },\n          ],\n        };\n      }\n\n      return {\n        content: [{ type: \"image\" as const, data: base64Png, mimeType: \"image/png\" }],\n      };\n    },\n  );\n}\n"],"mappings":";;;;;AAOA,SAAgB,uBAAuB,QAAmB,KAAwB;AAChF,QAAO,aACL,sBACA;EACE,aACE;EACF,aAAa,EACX,UAAUA,IAAAA,EACP,QAAQ,CACR,UAAU,CACV,SACC,+FACD,EACJ;EACF,EACD,OAAO,EAAE,eAAsC;AAC7C,MAAI,CAAC,IAAI,UAAU,kBACjB,QAAOC,cAAAA,YACL,wCACA,sJACD;EAEH,MAAM,YAAY,MAAM,IAAI,UAAU,mBAAmB;AAEzD,MAAI,UAAU;GACZ,MAAM,WAAA,GAAA,UAAA,SAAkB,SAAS;AACjC,UAAA,GAAA,iBAAA,WAAgB,SAAS,OAAO,KAAK,WAAW,SAAS,EAAE,EAAE,MAAM,MAAM,CAAC;AAC1E,UAAO,EACL,SAAS,CACP;IAAE,MAAM;IAAkB,MAAM;IAAW,UAAU;IAAa,EAClE;IAAE,MAAM;IAAiB,MAAM,uBAAuB;IAAW,CAClE,EACF;;AAGH,SAAO,EACL,SAAS,CAAC;GAAE,MAAM;GAAkB,MAAM;GAAW,UAAU;GAAa,CAAC,EAC9E;GAEJ"}

package/dist/tools/screenshot.js

@@ -0,0 +1,35 @@
+import { errorResult } from "./types.js";
+import { z } from "zod";
+import { writeFile } from "node:fs/promises";
+import { resolve } from "node:path";
+//#region src/tools/screenshot.ts
+function registerScreenshotTool(server, ctx) {
+	server.registerTool("capture_screenshot", {
+		description: "Capture a screenshot of the current application window. Optionally save to a file.",
+		inputSchema: { savePath: z.string().optional().describe("Absolute file path to save the screenshot as PNG. If omitted, returns the image inline only.") }
+	}, async ({ savePath }) => {
+		if (!ctx.callbacks.captureScreenshot) return errorResult("Screenshot capture is not available.", "Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log");
+		const base64Png = await ctx.callbacks.captureScreenshot();
+		if (savePath) {
+			const absPath = resolve(savePath);
+			await writeFile(absPath, Buffer.from(base64Png, "base64"), { flag: "wx" });
+			return { content: [{
+				type: "image",
+				data: base64Png,
+				mimeType: "image/png"
+			}, {
+				type: "text",
+				text: `Screenshot saved to ${absPath}`
+			}] };
+		}
+		return { content: [{
+			type: "image",
+			data: base64Png,
+			mimeType: "image/png"
+		}] };
+	});
+}
+//#endregion
+export { registerScreenshotTool };
+
+//# sourceMappingURL=screenshot.js.map

package/dist/tools/screenshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenshot.js","names":[],"sources":["../../src/tools/screenshot.ts"],"sourcesContent":["import { writeFile } from \"node:fs/promises\";\nimport { resolve } from \"node:path\";\nimport type { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\";\nimport { z } from \"zod\";\nimport type { ToolContext } from \"./types\";\nimport { errorResult } from \"./types\";\n\nexport function registerScreenshotTool(server: McpServer, ctx: ToolContext): void {\n  server.registerTool(\n    \"capture_screenshot\",\n    {\n      description:\n        \"Capture a screenshot of the current application window. Optionally save to a file.\",\n      inputSchema: {\n        savePath: z\n          .string()\n          .optional()\n          .describe(\n            \"Absolute file path to save the screenshot as PNG. If omitted, returns the image inline only.\",\n          ),\n      },\n    },\n    async ({ savePath }: { savePath?: string }) => {\n      if (!ctx.callbacks.captureScreenshot) {\n        return errorResult(\n          \"Screenshot capture is not available.\",\n          \"Make sure the MCP server is running inside Platforma Desktop and MCP connected properly. If everything is fine check Electron logs with get_app_log\",\n        );\n      }\n      const base64Png = await ctx.callbacks.captureScreenshot();\n\n      if (savePath) {\n        const absPath = resolve(savePath);\n        await writeFile(absPath, Buffer.from(base64Png, \"base64\"), { flag: \"wx\" });\n        return {\n          content: [\n            { type: \"image\" as const, data: base64Png, mimeType: \"image/png\" },\n            { type: \"text\" as const, text: `Screenshot saved to ${absPath}` },\n          ],\n        };\n      }\n\n      return {\n        content: [{ type: \"image\" as const, data: base64Png, mimeType: \"image/png\" }],\n      };\n    },\n  );\n}\n"],"mappings":";;;;;AAOA,SAAgB,uBAAuB,QAAmB,KAAwB;AAChF,QAAO,aACL,sBACA;EACE,aACE;EACF,aAAa,EACX,UAAU,EACP,QAAQ,CACR,UAAU,CACV,SACC,+FACD,EACJ;EACF,EACD,OAAO,EAAE,eAAsC;AAC7C,MAAI,CAAC,IAAI,UAAU,kBACjB,QAAO,YACL,wCACA,sJACD;EAEH,MAAM,YAAY,MAAM,IAAI,UAAU,mBAAmB;AAEzD,MAAI,UAAU;GACZ,MAAM,UAAU,QAAQ,SAAS;AACjC,SAAM,UAAU,SAAS,OAAO,KAAK,WAAW,SAAS,EAAE,EAAE,MAAM,MAAM,CAAC;AAC1E,UAAO,EACL,SAAS,CACP;IAAE,MAAM;IAAkB,MAAM;IAAW,UAAU;IAAa,EAClE;IAAE,MAAM;IAAiB,MAAM,uBAAuB;IAAW,CAClE,EACF;;AAGH,SAAO,EACL,SAAS,CAAC;GAAE,MAAM;GAAkB,MAAM;GAAW,UAAU;GAAa,CAAC,EAC9E;GAEJ"}

package/dist/tools/tokens.cjs

@@ -0,0 +1,82 @@
+//#region src/tools/tokens.ts
+const NODE_LIMIT = 1e4;
+const CHARS_PER_TOKEN = 4;
+/**
+* Estimate the number of LLM tokens needed to represent a value as JSON,
+* without actually serializing it. Walks the object tree and sums up
+* the JSON character lengths, then divides by ~4 chars/token.
+*
+* Returns token estimate, or a string like ">1234 (truncated at 10000 nodes)"
+* if the object graph is too large to fully traverse.
+*/
+function estimateTokens(value, nodeLimit = NODE_LIMIT) {
+	let nodes = 0;
+	let chars = 0;
+	/** Returns true if node limit exceeded. */
+	function walk(v) {
+		if (++nodes > nodeLimit) return true;
+		if (v === null || v === void 0) {
+			chars += 4;
+			return false;
+		}
+		switch (typeof v) {
+			case "string":
+				chars += v.length + 2;
+				return false;
+			case "number":
+				chars += String(v).length;
+				return false;
+			case "boolean":
+				chars += v ? 4 : 5;
+				return false;
+			case "bigint":
+				chars += String(v).length;
+				return false;
+			default: break;
+		}
+		if (v instanceof Uint8Array || ArrayBuffer.isView(v)) {
+			const arr = v;
+			chars += 2 + Math.max(0, arr.length - 1);
+			for (let i = 0; i < arr.length; i++) chars += String(arr[i]).length;
+			return false;
+		}
+		if (Array.isArray(v)) {
+			chars += 2;
+			if (v.length > 1) chars += v.length - 1;
+			for (const item of v) if (walk(item)) return true;
+			return false;
+		}
+		if (typeof v === "object") {
+			const entries = Object.entries(v);
+			chars += 2;
+			if (entries.length > 1) chars += entries.length - 1;
+			for (const [k, val] of entries) {
+				chars += k.length + 3;
+				if (walk(val)) return true;
+			}
+		}
+		return false;
+	}
+	const overflow = walk(value);
+	const tokens = Math.ceil(chars / CHARS_PER_TOKEN);
+	return overflow ? `>${tokens} (truncated at ${nodeLimit} nodes)` : tokens;
+}
+/** Summarize block outputs as concise key/ok/hasValue/tokensEstimate entries. */
+function summarizeOutputs(outputs) {
+	if (!outputs) return [];
+	return Object.entries(outputs).map(([key, out]) => {
+		const o = out;
+		const hasValue = o?.value != null;
+		const tokensEstimate = hasValue ? estimateTokens(o.value) : void 0;
+		return {
+			key,
+			ok: o?.ok ?? false,
+			hasValue,
+			tokensEstimate
+		};
+	});
+}
+//#endregion
+exports.summarizeOutputs = summarizeOutputs;
+
+//# sourceMappingURL=tokens.cjs.map

package/dist/tools/tokens.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.cjs","names":[],"sources":["../../src/tools/tokens.ts"],"sourcesContent":["const NODE_LIMIT = 10_000;\nconst CHARS_PER_TOKEN = 4;\n\n/**\n * Estimate the number of LLM tokens needed to represent a value as JSON,\n * without actually serializing it. Walks the object tree and sums up\n * the JSON character lengths, then divides by ~4 chars/token.\n *\n * Returns token estimate, or a string like \">1234 (truncated at 10000 nodes)\"\n * if the object graph is too large to fully traverse.\n */\nexport function estimateTokens(value: unknown, nodeLimit = NODE_LIMIT): number | string {\n  let nodes = 0;\n  let chars = 0;\n\n  /** Returns true if node limit exceeded. */\n  function walk(v: unknown): boolean {\n    if (++nodes > nodeLimit) return true;\n    if (v === null || v === undefined) {\n      chars += 4; // \"null\"\n      return false;\n    }\n    switch (typeof v) {\n      case \"string\":\n        chars += v.length + 2; // content + quotes\n        return false;\n      case \"number\":\n        chars += String(v).length;\n        return false;\n      case \"boolean\":\n        chars += v ? 4 : 5; // \"true\" or \"false\"\n        return false;\n      case \"bigint\":\n        chars += String(v).length;\n        return false;\n      default:\n        break;\n    }\n    if (v instanceof Uint8Array || ArrayBuffer.isView(v)) {\n      // serialized as array of numbers\n      const arr = v as Uint8Array;\n      chars += 2 + Math.max(0, arr.length - 1); // [] + commas\n      for (let i = 0; i < arr.length; i++) {\n        chars += String(arr[i]).length;\n      }\n      return false;\n    }\n    if (Array.isArray(v)) {\n      chars += 2; // []\n      if (v.length > 1) chars += v.length - 1; // commas\n      for (const item of v) {\n        if (walk(item)) return true;\n      }\n      return false;\n    }\n    if (typeof v === \"object\") {\n      const entries = Object.entries(v as Record<string, unknown>);\n      chars += 2; // {}\n      if (entries.length > 1) chars += entries.length - 1; // commas\n      for (const [k, val] of entries) {\n        chars += k.length + 3; // \"key\":\n        if (walk(val)) return true;\n      }\n    }\n    return false;\n  }\n\n  const overflow = walk(value);\n  const tokens = Math.ceil(chars / CHARS_PER_TOKEN);\n  return overflow ? `>${tokens} (truncated at ${nodeLimit} nodes)` : tokens;\n}\n\n/** Summarize block outputs as concise key/ok/hasValue/tokensEstimate entries. */\nexport function summarizeOutputs(\n  outputs: Record<string, unknown> | undefined,\n): { key: string; ok: boolean; hasValue: boolean; tokensEstimate?: number | string }[] {\n  if (!outputs) return [];\n  return Object.entries(outputs).map(([key, out]) => {\n    const o = out as { ok?: boolean; value?: unknown } | undefined;\n    const hasValue = o?.value != null;\n    const tokensEstimate = hasValue ? estimateTokens(o!.value) : undefined;\n    return { key, ok: o?.ok ?? false, hasValue, tokensEstimate };\n  });\n}\n"],"mappings":";AAAA,MAAM,aAAa;AACnB,MAAM,kBAAkB;;;;;;;;;AAUxB,SAAgB,eAAe,OAAgB,YAAY,YAA6B;CACtF,IAAI,QAAQ;CACZ,IAAI,QAAQ;;CAGZ,SAAS,KAAK,GAAqB;AACjC,MAAI,EAAE,QAAQ,UAAW,QAAO;AAChC,MAAI,MAAM,QAAQ,MAAM,KAAA,GAAW;AACjC,YAAS;AACT,UAAO;;AAET,UAAQ,OAAO,GAAf;GACE,KAAK;AACH,aAAS,EAAE,SAAS;AACpB,WAAO;GACT,KAAK;AACH,aAAS,OAAO,EAAE,CAAC;AACnB,WAAO;GACT,KAAK;AACH,aAAS,IAAI,IAAI;AACjB,WAAO;GACT,KAAK;AACH,aAAS,OAAO,EAAE,CAAC;AACnB,WAAO;GACT,QACE;;AAEJ,MAAI,aAAa,cAAc,YAAY,OAAO,EAAE,EAAE;GAEpD,MAAM,MAAM;AACZ,YAAS,IAAI,KAAK,IAAI,GAAG,IAAI,SAAS,EAAE;AACxC,QAAK,IAAI,IAAI,GAAG,IAAI,IAAI,QAAQ,IAC9B,UAAS,OAAO,IAAI,GAAG,CAAC;AAE1B,UAAO;;AAET,MAAI,MAAM,QAAQ,EAAE,EAAE;AACpB,YAAS;AACT,OAAI,EAAE,SAAS,EAAG,UAAS,EAAE,SAAS;AACtC,QAAK,MAAM,QAAQ,EACjB,KAAI,KAAK,KAAK,CAAE,QAAO;AAEzB,UAAO;;AAET,MAAI,OAAO,MAAM,UAAU;GACzB,MAAM,UAAU,OAAO,QAAQ,EAA6B;AAC5D,YAAS;AACT,OAAI,QAAQ,SAAS,EAAG,UAAS,QAAQ,SAAS;AAClD,QAAK,MAAM,CAAC,GAAG,QAAQ,SAAS;AAC9B,aAAS,EAAE,SAAS;AACpB,QAAI,KAAK,IAAI,CAAE,QAAO;;;AAG1B,SAAO;;CAGT,MAAM,WAAW,KAAK,MAAM;CAC5B,MAAM,SAAS,KAAK,KAAK,QAAQ,gBAAgB;AACjD,QAAO,WAAW,IAAI,OAAO,iBAAiB,UAAU,WAAW;;;AAIrE,SAAgB,iBACd,SACqF;AACrF,KAAI,CAAC,QAAS,QAAO,EAAE;AACvB,QAAO,OAAO,QAAQ,QAAQ,CAAC,KAAK,CAAC,KAAK,SAAS;EACjD,MAAM,IAAI;EACV,MAAM,WAAW,GAAG,SAAS;EAC7B,MAAM,iBAAiB,WAAW,eAAe,EAAG,MAAM,GAAG,KAAA;AAC7D,SAAO;GAAE;GAAK,IAAI,GAAG,MAAM;GAAO;GAAU;GAAgB;GAC5D"}

package/dist/tools/tokens.js

@@ -0,0 +1,82 @@
+//#region src/tools/tokens.ts
+const NODE_LIMIT = 1e4;
+const CHARS_PER_TOKEN = 4;
+/**
+* Estimate the number of LLM tokens needed to represent a value as JSON,
+* without actually serializing it. Walks the object tree and sums up
+* the JSON character lengths, then divides by ~4 chars/token.
+*
+* Returns token estimate, or a string like ">1234 (truncated at 10000 nodes)"
+* if the object graph is too large to fully traverse.
+*/
+function estimateTokens(value, nodeLimit = NODE_LIMIT) {
+	let nodes = 0;
+	let chars = 0;
+	/** Returns true if node limit exceeded. */
+	function walk(v) {
+		if (++nodes > nodeLimit) return true;
+		if (v === null || v === void 0) {
+			chars += 4;
+			return false;
+		}
+		switch (typeof v) {
+			case "string":
+				chars += v.length + 2;
+				return false;
+			case "number":
+				chars += String(v).length;
+				return false;
+			case "boolean":
+				chars += v ? 4 : 5;
+				return false;
+			case "bigint":
+				chars += String(v).length;
+				return false;
+			default: break;
+		}
+		if (v instanceof Uint8Array || ArrayBuffer.isView(v)) {
+			const arr = v;
+			chars += 2 + Math.max(0, arr.length - 1);
+			for (let i = 0; i < arr.length; i++) chars += String(arr[i]).length;
+			return false;
+		}
+		if (Array.isArray(v)) {
+			chars += 2;
+			if (v.length > 1) chars += v.length - 1;
+			for (const item of v) if (walk(item)) return true;
+			return false;
+		}
+		if (typeof v === "object") {
+			const entries = Object.entries(v);
+			chars += 2;
+			if (entries.length > 1) chars += entries.length - 1;
+			for (const [k, val] of entries) {
+				chars += k.length + 3;
+				if (walk(val)) return true;
+			}
+		}
+		return false;
+	}
+	const overflow = walk(value);
+	const tokens = Math.ceil(chars / CHARS_PER_TOKEN);
+	return overflow ? `>${tokens} (truncated at ${nodeLimit} nodes)` : tokens;
+}
+/** Summarize block outputs as concise key/ok/hasValue/tokensEstimate entries. */
+function summarizeOutputs(outputs) {
+	if (!outputs) return [];
+	return Object.entries(outputs).map(([key, out]) => {
+		const o = out;
+		const hasValue = o?.value != null;
+		const tokensEstimate = hasValue ? estimateTokens(o.value) : void 0;
+		return {
+			key,
+			ok: o?.ok ?? false,
+			hasValue,
+			tokensEstimate
+		};
+	});
+}
+//#endregion
+export { summarizeOutputs };
+
+//# sourceMappingURL=tokens.js.map

package/dist/tools/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","names":[],"sources":["../../src/tools/tokens.ts"],"sourcesContent":["const NODE_LIMIT = 10_000;\nconst CHARS_PER_TOKEN = 4;\n\n/**\n * Estimate the number of LLM tokens needed to represent a value as JSON,\n * without actually serializing it. Walks the object tree and sums up\n * the JSON character lengths, then divides by ~4 chars/token.\n *\n * Returns token estimate, or a string like \">1234 (truncated at 10000 nodes)\"\n * if the object graph is too large to fully traverse.\n */\nexport function estimateTokens(value: unknown, nodeLimit = NODE_LIMIT): number | string {\n  let nodes = 0;\n  let chars = 0;\n\n  /** Returns true if node limit exceeded. */\n  function walk(v: unknown): boolean {\n    if (++nodes > nodeLimit) return true;\n    if (v === null || v === undefined) {\n      chars += 4; // \"null\"\n      return false;\n    }\n    switch (typeof v) {\n      case \"string\":\n        chars += v.length + 2; // content + quotes\n        return false;\n      case \"number\":\n        chars += String(v).length;\n        return false;\n      case \"boolean\":\n        chars += v ? 4 : 5; // \"true\" or \"false\"\n        return false;\n      case \"bigint\":\n        chars += String(v).length;\n        return false;\n      default:\n        break;\n    }\n    if (v instanceof Uint8Array || ArrayBuffer.isView(v)) {\n      // serialized as array of numbers\n      const arr = v as Uint8Array;\n      chars += 2 + Math.max(0, arr.length - 1); // [] + commas\n      for (let i = 0; i < arr.length; i++) {\n        chars += String(arr[i]).length;\n      }\n      return false;\n    }\n    if (Array.isArray(v)) {\n      chars += 2; // []\n      if (v.length > 1) chars += v.length - 1; // commas\n      for (const item of v) {\n        if (walk(item)) return true;\n      }\n      return false;\n    }\n    if (typeof v === \"object\") {\n      const entries = Object.entries(v as Record<string, unknown>);\n      chars += 2; // {}\n      if (entries.length > 1) chars += entries.length - 1; // commas\n      for (const [k, val] of entries) {\n        chars += k.length + 3; // \"key\":\n        if (walk(val)) return true;\n      }\n    }\n    return false;\n  }\n\n  const overflow = walk(value);\n  const tokens = Math.ceil(chars / CHARS_PER_TOKEN);\n  return overflow ? `>${tokens} (truncated at ${nodeLimit} nodes)` : tokens;\n}\n\n/** Summarize block outputs as concise key/ok/hasValue/tokensEstimate entries. */\nexport function summarizeOutputs(\n  outputs: Record<string, unknown> | undefined,\n): { key: string; ok: boolean; hasValue: boolean; tokensEstimate?: number | string }[] {\n  if (!outputs) return [];\n  return Object.entries(outputs).map(([key, out]) => {\n    const o = out as { ok?: boolean; value?: unknown } | undefined;\n    const hasValue = o?.value != null;\n    const tokensEstimate = hasValue ? estimateTokens(o!.value) : undefined;\n    return { key, ok: o?.ok ?? false, hasValue, tokensEstimate };\n  });\n}\n"],"mappings":";AAAA,MAAM,aAAa;AACnB,MAAM,kBAAkB;;;;;;;;;AAUxB,SAAgB,eAAe,OAAgB,YAAY,YAA6B;CACtF,IAAI,QAAQ;CACZ,IAAI,QAAQ;;CAGZ,SAAS,KAAK,GAAqB;AACjC,MAAI,EAAE,QAAQ,UAAW,QAAO;AAChC,MAAI,MAAM,QAAQ,MAAM,KAAA,GAAW;AACjC,YAAS;AACT,UAAO;;AAET,UAAQ,OAAO,GAAf;GACE,KAAK;AACH,aAAS,EAAE,SAAS;AACpB,WAAO;GACT,KAAK;AACH,aAAS,OAAO,EAAE,CAAC;AACnB,WAAO;GACT,KAAK;AACH,aAAS,IAAI,IAAI;AACjB,WAAO;GACT,KAAK;AACH,aAAS,OAAO,EAAE,CAAC;AACnB,WAAO;GACT,QACE;;AAEJ,MAAI,aAAa,cAAc,YAAY,OAAO,EAAE,EAAE;GAEpD,MAAM,MAAM;AACZ,YAAS,IAAI,KAAK,IAAI,GAAG,IAAI,SAAS,EAAE;AACxC,QAAK,IAAI,IAAI,GAAG,IAAI,IAAI,QAAQ,IAC9B,UAAS,OAAO,IAAI,GAAG,CAAC;AAE1B,UAAO;;AAET,MAAI,MAAM,QAAQ,EAAE,EAAE;AACpB,YAAS;AACT,OAAI,EAAE,SAAS,EAAG,UAAS,EAAE,SAAS;AACtC,QAAK,MAAM,QAAQ,EACjB,KAAI,KAAK,KAAK,CAAE,QAAO;AAEzB,UAAO;;AAET,MAAI,OAAO,MAAM,UAAU;GACzB,MAAM,UAAU,OAAO,QAAQ,EAA6B;AAC5D,YAAS;AACT,OAAI,QAAQ,SAAS,EAAG,UAAS,QAAQ,SAAS;AAClD,QAAK,MAAM,CAAC,GAAG,QAAQ,SAAS;AAC9B,aAAS,EAAE,SAAS;AACpB,QAAI,KAAK,IAAI,CAAE,QAAO;;;AAG1B,SAAO;;CAGT,MAAM,WAAW,KAAK,MAAM;CAC5B,MAAM,SAAS,KAAK,KAAK,QAAQ,gBAAgB;AACjD,QAAO,WAAW,IAAI,OAAO,iBAAiB,UAAU,WAAW;;;AAIrE,SAAgB,iBACd,SACqF;AACrF,KAAI,CAAC,QAAS,QAAO,EAAE;AACvB,QAAO,OAAO,QAAQ,QAAQ,CAAC,KAAK,CAAC,KAAK,SAAS;EACjD,MAAM,IAAI;EACV,MAAM,WAAW,GAAG,SAAS;EAC7B,MAAM,iBAAiB,WAAW,eAAe,EAAG,MAAM,GAAG,KAAA;AAC7D,SAAO;GAAE;GAAK,IAAI,GAAG,MAAM;GAAO;GAAU;GAAgB;GAC5D"}

package/dist/tools/types.cjs

@@ -0,0 +1,22 @@
+//#region src/tools/types.ts
+function textResult(data) {
+	return { content: [{
+		type: "text",
+		text: JSON.stringify(data)
+	}] };
+}
+/** Return an MCP error result with an actionable hint for the AI agent. */
+function errorResult(message, hint) {
+	return {
+		content: [{
+			type: "text",
+			text: hint ? `${message}\n\nHint: ${hint}` : message
+		}],
+		isError: true
+	};
+}
+//#endregion
+exports.errorResult = errorResult;
+exports.textResult = textResult;
+
+//# sourceMappingURL=types.cjs.map

package/dist/tools/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","names":[],"sources":["../../src/tools/types.ts"],"sourcesContent":["import type {\n  AuthorMarker,\n  MiddleLayer,\n  Project,\n  ProjectListEntry,\n} from \"@milaboratories/pl-middle-layer\";\nimport type { PlMcpServerCallbacks } from \"../server\";\n\nexport type { AuthorMarker };\n\nexport interface ToolContext {\n  getMl: () => MiddleLayer | null;\n  requireMl: () => MiddleLayer;\n  resolveProject: (projectId: string) => Promise<ProjectListEntry>;\n  getOpenedProject: (projectId: string) => Promise<Project>;\n  callbacks: PlMcpServerCallbacks;\n  /** Returns an AuthorMarker with auto-incrementing localVersion for this MCP session. */\n  getAuthorMarker: () => AuthorMarker;\n}\n\nexport function textResult(data: unknown) {\n  return {\n    content: [{ type: \"text\" as const, text: JSON.stringify(data) }],\n  };\n}\n\n/** Return an MCP error result with an actionable hint for the AI agent. */\nexport function errorResult(message: string, hint?: string) {\n  const text = hint ? `${message}\\n\\nHint: ${hint}` : message;\n  return {\n    content: [{ type: \"text\" as const, text }],\n    isError: true,\n  };\n}\n"],"mappings":";AAoBA,SAAgB,WAAW,MAAe;AACxC,QAAO,EACL,SAAS,CAAC;EAAE,MAAM;EAAiB,MAAM,KAAK,UAAU,KAAK;EAAE,CAAC,EACjE;;;AAIH,SAAgB,YAAY,SAAiB,MAAe;AAE1D,QAAO;EACL,SAAS,CAAC;GAAE,MAAM;GAAiB,MAFxB,OAAO,GAAG,QAAQ,YAAY,SAAS;GAET,CAAC;EAC1C,SAAS;EACV"}

package/dist/tools/types.js

@@ -0,0 +1,21 @@
+//#region src/tools/types.ts
+function textResult(data) {
+	return { content: [{
+		type: "text",
+		text: JSON.stringify(data)
+	}] };
+}
+/** Return an MCP error result with an actionable hint for the AI agent. */
+function errorResult(message, hint) {
+	return {
+		content: [{
+			type: "text",
+			text: hint ? `${message}\n\nHint: ${hint}` : message
+		}],
+		isError: true
+	};
+}
+//#endregion
+export { errorResult, textResult };
+
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":[],"sources":["../../src/tools/types.ts"],"sourcesContent":["import type {\n  AuthorMarker,\n  MiddleLayer,\n  Project,\n  ProjectListEntry,\n} from \"@milaboratories/pl-middle-layer\";\nimport type { PlMcpServerCallbacks } from \"../server\";\n\nexport type { AuthorMarker };\n\nexport interface ToolContext {\n  getMl: () => MiddleLayer | null;\n  requireMl: () => MiddleLayer;\n  resolveProject: (projectId: string) => Promise<ProjectListEntry>;\n  getOpenedProject: (projectId: string) => Promise<Project>;\n  callbacks: PlMcpServerCallbacks;\n  /** Returns an AuthorMarker with auto-incrementing localVersion for this MCP session. */\n  getAuthorMarker: () => AuthorMarker;\n}\n\nexport function textResult(data: unknown) {\n  return {\n    content: [{ type: \"text\" as const, text: JSON.stringify(data) }],\n  };\n}\n\n/** Return an MCP error result with an actionable hint for the AI agent. */\nexport function errorResult(message: string, hint?: string) {\n  const text = hint ? `${message}\\n\\nHint: ${hint}` : message;\n  return {\n    content: [{ type: \"text\" as const, text }],\n    isError: true,\n  };\n}\n"],"mappings":";AAoBA,SAAgB,WAAW,MAAe;AACxC,QAAO,EACL,SAAS,CAAC;EAAE,MAAM;EAAiB,MAAM,KAAK,UAAU,KAAK;EAAE,CAAC,EACjE;;;AAIH,SAAgB,YAAY,SAAiB,MAAe;AAE1D,QAAO;EACL,SAAS,CAAC;GAAE,MAAM;GAAiB,MAFxB,OAAO,GAAG,QAAQ,YAAY,SAAS;GAET,CAAC;EAC1C,SAAS;EACV"}