@tempad-dev/mcp 0.3.4 → 0.3.5

package/dist/asset-http-server.mjs

@@ -0,0 +1,239 @@
+import { ASSET_DIR, log } from "./shared.mjs";
+import { getMcpServerConfig } from "./config.mjs";
+import { join } from "node:path";
+import { URL } from "node:url";
+import { createReadStream, createWriteStream, existsSync, renameSync, statSync, unlinkSync } from "node:fs";
+import { MCP_HASH_PATTERN } from "@tempad-dev/mcp-shared";
+import { nanoid } from "nanoid";
+import { createHash } from "node:crypto";
+import { createServer } from "node:http";
+import { Transform, pipeline } from "node:stream";
+
+//#region src/asset-http-server.ts
+const LOOPBACK_HOST = "127.0.0.1";
+const { maxAssetSizeBytes } = getMcpServerConfig();
+function createAssetHttpServer(store) {
+	const server = createServer(handleRequest);
+	let port = null;
+	async function start() {
+		if (port !== null) return;
+		await new Promise((resolve, reject) => {
+			const onError = (error) => {
+				server.off("listening", onListening);
+				reject(error);
+			};
+			const onListening = () => {
+				server.off("error", onError);
+				const address = server.address();
+				if (address && typeof address === "object") {
+					port = address.port;
+					resolve();
+				} else reject(/* @__PURE__ */ new Error("Failed to determine HTTP server port."));
+			};
+			server.once("error", onError);
+			server.once("listening", onListening);
+			server.listen(0, LOOPBACK_HOST);
+		});
+		log.info({ port }, "Asset HTTP server ready.");
+	}
+	function stop() {
+		if (port === null) return;
+		server.close();
+		port = null;
+	}
+	function getBaseUrl() {
+		if (port === null) throw new Error("Asset HTTP server is not running.");
+		return `http://${LOOPBACK_HOST}:${port}`;
+	}
+	function handleRequest(req, res) {
+		res.setHeader("Access-Control-Allow-Origin", "*");
+		res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
+		res.setHeader("Access-Control-Allow-Headers", "Content-Type, X-Asset-Width, X-Asset-Height");
+		if (req.method === "OPTIONS") {
+			res.writeHead(204);
+			res.end();
+			return;
+		}
+		if (!req.url) {
+			res.writeHead(400);
+			res.end("Missing URL");
+			return;
+		}
+		const segments = new URL(req.url, getBaseUrl()).pathname.split("/").filter(Boolean);
+		if (segments.length !== 2 || segments[0] !== "assets") {
+			res.writeHead(404);
+			res.end("Not Found");
+			return;
+		}
+		const hash = segments[1];
+		if (req.method === "POST") {
+			handleUpload(req, res, hash);
+			return;
+		}
+		if (req.method === "GET") {
+			handleDownload(req, res, hash);
+			return;
+		}
+		res.writeHead(405);
+		res.end("Method Not Allowed");
+	}
+	function handleDownload(req, res, hash) {
+		const record = store.get(hash);
+		if (!record) {
+			res.writeHead(404);
+			res.end("Not Found");
+			return;
+		}
+		let stat;
+		try {
+			stat = statSync(record.filePath);
+		} catch (error) {
+			if (error.code === "ENOENT") {
+				store.remove(hash, { removeFile: false });
+				res.writeHead(404);
+				res.end("Not Found");
+			} else {
+				log.error({
+					error,
+					hash
+				}, "Failed to stat asset file.");
+				res.writeHead(500);
+				res.end("Internal Server Error");
+			}
+			return;
+		}
+		res.writeHead(200, {
+			"Content-Type": record.mimeType,
+			"Content-Length": stat.size.toString(),
+			"Cache-Control": "public, max-age=31536000, immutable"
+		});
+		const stream = createReadStream(record.filePath);
+		stream.on("error", (error) => {
+			log.warn({
+				error,
+				hash
+			}, "Failed to stream asset file.");
+			if (!res.headersSent) res.writeHead(500);
+			res.end("Internal Server Error");
+		});
+		stream.on("open", () => {
+			store.touch(hash);
+		});
+		stream.pipe(res);
+	}
+	function handleUpload(req, res, hash) {
+		if (!MCP_HASH_PATTERN.test(hash)) {
+			res.writeHead(400);
+			res.end("Invalid Hash Format");
+			return;
+		}
+		const mimeType = req.headers["content-type"] || "application/octet-stream";
+		const filePath = join(ASSET_DIR, hash);
+		const width = parseInt(req.headers["x-asset-width"], 10);
+		const height = parseInt(req.headers["x-asset-height"], 10);
+		const metadata = !isNaN(width) && !isNaN(height) && width > 0 && height > 0 ? {
+			width,
+			height
+		} : void 0;
+		if (store.has(hash) && existsSync(filePath)) {
+			req.resume();
+			const existing = store.get(hash);
+			let changed = false;
+			if (metadata) {
+				existing.metadata = metadata;
+				changed = true;
+			}
+			if (existing.mimeType !== mimeType) {
+				existing.mimeType = mimeType;
+				changed = true;
+			}
+			if (changed) store.upsert(existing);
+			store.touch(hash);
+			res.writeHead(200);
+			res.end("OK");
+			return;
+		}
+		const tmpPath = `${filePath}.tmp.${nanoid()}`;
+		const writeStream = createWriteStream(tmpPath);
+		const hasher = createHash("sha256");
+		let size = 0;
+		const cleanup = () => {
+			if (existsSync(tmpPath)) try {
+				unlinkSync(tmpPath);
+			} catch (e) {
+				log.warn({
+					error: e,
+					tmpPath
+				}, "Failed to cleanup temp file.");
+			}
+		};
+		pipeline(req, new Transform({ transform(chunk, encoding, callback) {
+			size += chunk.length;
+			if (size > maxAssetSizeBytes) {
+				callback(/* @__PURE__ */ new Error("PayloadTooLarge"));
+				return;
+			}
+			hasher.update(chunk);
+			callback(null, chunk);
+		} }), writeStream, (err) => {
+			if (err) {
+				cleanup();
+				if (err.message === "PayloadTooLarge") {
+					res.writeHead(413);
+					res.end("Payload Too Large");
+				} else if (err.code === "ERR_STREAM_PREMATURE_CLOSE") log.warn({ hash }, "Upload request closed prematurely.");
+				else {
+					log.error({
+						error: err,
+						hash
+					}, "Upload pipeline failed.");
+					if (!res.headersSent) {
+						res.writeHead(500);
+						res.end("Internal Server Error");
+					}
+				}
+				return;
+			}
+			if (hasher.digest("hex") !== hash) {
+				cleanup();
+				res.writeHead(400);
+				res.end("Hash Mismatch");
+				return;
+			}
+			try {
+				renameSync(tmpPath, filePath);
+			} catch (error) {
+				log.error({
+					error,
+					hash
+				}, "Failed to rename temp file to asset.");
+				cleanup();
+				res.writeHead(500);
+				res.end("Internal Server Error");
+				return;
+			}
+			store.upsert({
+				hash,
+				filePath,
+				mimeType,
+				size,
+				metadata
+			});
+			log.info({
+				hash,
+				size
+			}, "Stored uploaded asset via HTTP.");
+			res.writeHead(201);
+			res.end("Created");
+		});
+	}
+	return {
+		start,
+		stop,
+		getBaseUrl
+	};
+}
+
+//#endregion
+export { createAssetHttpServer };
+//# sourceMappingURL=asset-http-server.mjs.map

package/dist/asset-http-server.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-http-server.mjs","names":["port: number | null"],"sources":["../src/asset-http-server.ts"],"sourcesContent":["import { MCP_HASH_PATTERN } from '@tempad-dev/mcp-shared'\nimport { nanoid } from 'nanoid'\nimport { createHash } from 'node:crypto'\nimport {\n  createReadStream,\n  createWriteStream,\n  existsSync,\n  renameSync,\n  statSync,\n  unlinkSync\n} from 'node:fs'\nimport { createServer, type IncomingMessage, type ServerResponse } from 'node:http'\nimport { join } from 'node:path'\nimport { pipeline, Transform } from 'node:stream'\nimport { URL } from 'node:url'\n\nimport type { AssetStore } from './asset-store'\n\nimport { getMcpServerConfig } from './config'\nimport { ASSET_DIR, log } from './shared'\n\nconst LOOPBACK_HOST = '127.0.0.1'\nconst { maxAssetSizeBytes } = getMcpServerConfig()\n\nexport interface AssetHttpServer {\n  start(): Promise<void>\n  stop(): void\n  getBaseUrl(): string\n}\n\nexport function createAssetHttpServer(store: AssetStore): AssetHttpServer {\n  const server = createServer(handleRequest)\n  let port: number | null = null\n\n  async function start(): Promise<void> {\n    if (port !== null) return\n    await new Promise<void>((resolve, reject) => {\n      const onError = (error: Error) => {\n        server.off('listening', onListening)\n        reject(error)\n      }\n      const onListening = () => {\n        server.off('error', onError)\n        const address = server.address()\n        if (address && typeof address === 'object') {\n          port = address.port\n          resolve()\n        } else {\n          reject(new Error('Failed to determine HTTP server port.'))\n        }\n      }\n      server.once('error', onError)\n      server.once('listening', onListening)\n      server.listen(0, LOOPBACK_HOST)\n    })\n    log.info({ port }, 'Asset HTTP server ready.')\n  }\n\n  function stop(): void {\n    if (port === null) return\n    server.close()\n    port = null\n  }\n\n  function getBaseUrl(): string {\n    if (port === null) throw new Error('Asset HTTP server is not running.')\n    return `http://${LOOPBACK_HOST}:${port}`\n  }\n\n  function handleRequest(req: IncomingMessage, res: ServerResponse): void {\n    res.setHeader('Access-Control-Allow-Origin', '*')\n    res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS')\n    res.setHeader('Access-Control-Allow-Headers', 'Content-Type, X-Asset-Width, X-Asset-Height')\n\n    if (req.method === 'OPTIONS') {\n      res.writeHead(204)\n      res.end()\n      return\n    }\n\n    if (!req.url) {\n      res.writeHead(400)\n      res.end('Missing URL')\n      return\n    }\n\n    const url = new URL(req.url, getBaseUrl())\n    const segments = url.pathname.split('/').filter(Boolean)\n    if (segments.length !== 2 || segments[0] !== 'assets') {\n      res.writeHead(404)\n      res.end('Not Found')\n      return\n    }\n\n    const hash = segments[1]\n\n    if (req.method === 'POST') {\n      handleUpload(req, res, hash)\n      return\n    }\n\n    if (req.method === 'GET') {\n      handleDownload(req, res, hash)\n      return\n    }\n\n    res.writeHead(405)\n    res.end('Method Not Allowed')\n  }\n\n  function handleDownload(req: IncomingMessage, res: ServerResponse, hash: string): void {\n    const record = store.get(hash)\n    if (!record) {\n      res.writeHead(404)\n      res.end('Not Found')\n      return\n    }\n\n    let stat\n    try {\n      stat = statSync(record.filePath)\n    } catch (error) {\n      const err = error as NodeJS.ErrnoException\n      if (err.code === 'ENOENT') {\n        store.remove(hash, { removeFile: false })\n        res.writeHead(404)\n        res.end('Not Found')\n      } else {\n        log.error({ error, hash }, 'Failed to stat asset file.')\n        res.writeHead(500)\n        res.end('Internal Server Error')\n      }\n      return\n    }\n\n    res.writeHead(200, {\n      'Content-Type': record.mimeType,\n      'Content-Length': stat.size.toString(),\n      'Cache-Control': 'public, max-age=31536000, immutable'\n    })\n\n    const stream = createReadStream(record.filePath)\n    stream.on('error', (error) => {\n      log.warn({ error, hash }, 'Failed to stream asset file.')\n      if (!res.headersSent) {\n        res.writeHead(500)\n      }\n      res.end('Internal Server Error')\n    })\n    stream.on('open', () => {\n      store.touch(hash)\n    })\n    stream.pipe(res)\n  }\n\n  function handleUpload(req: IncomingMessage, res: ServerResponse, hash: string): void {\n    if (!MCP_HASH_PATTERN.test(hash)) {\n      res.writeHead(400)\n      res.end('Invalid Hash Format')\n      return\n    }\n\n    const mimeType = req.headers['content-type'] || 'application/octet-stream'\n    const filePath = join(ASSET_DIR, hash)\n\n    const width = parseInt(req.headers['x-asset-width'] as string, 10)\n    const height = parseInt(req.headers['x-asset-height'] as string, 10)\n    const metadata =\n      !isNaN(width) && !isNaN(height) && width > 0 && height > 0 ? { width, height } : undefined\n\n    // If asset already exists and file is present, skip write\n    if (store.has(hash) && existsSync(filePath)) {\n      // Drain request to ensure connection is clean\n      req.resume()\n\n      const existing = store.get(hash)!\n      let changed = false\n      if (metadata) {\n        existing.metadata = metadata\n        changed = true\n      }\n      if (existing.mimeType !== mimeType) {\n        existing.mimeType = mimeType\n        changed = true\n      }\n      if (changed) {\n        store.upsert(existing)\n      }\n      store.touch(hash)\n      res.writeHead(200)\n      res.end('OK')\n      return\n    }\n\n    const tmpPath = `${filePath}.tmp.${nanoid()}`\n    const writeStream = createWriteStream(tmpPath)\n    const hasher = createHash('sha256')\n    let size = 0\n\n    const cleanup = () => {\n      if (existsSync(tmpPath)) {\n        try {\n          unlinkSync(tmpPath)\n        } catch (e) {\n          log.warn({ error: e, tmpPath }, 'Failed to cleanup temp file.')\n        }\n      }\n    }\n\n    const monitor = new Transform({\n      transform(chunk, encoding, callback) {\n        size += chunk.length\n        if (size > maxAssetSizeBytes) {\n          callback(new Error('PayloadTooLarge'))\n          return\n        }\n        hasher.update(chunk)\n        callback(null, chunk)\n      }\n    })\n\n    pipeline(req, monitor, writeStream, (err) => {\n      if (err) {\n        cleanup()\n        if (err.message === 'PayloadTooLarge') {\n          res.writeHead(413)\n          res.end('Payload Too Large')\n        } else if (err.code === 'ERR_STREAM_PREMATURE_CLOSE') {\n          log.warn({ hash }, 'Upload request closed prematurely.')\n        } else {\n          log.error({ error: err, hash }, 'Upload pipeline failed.')\n          if (!res.headersSent) {\n            res.writeHead(500)\n            res.end('Internal Server Error')\n          }\n        }\n        return\n      }\n\n      const computedHash = hasher.digest('hex')\n      if (computedHash !== hash) {\n        cleanup()\n        res.writeHead(400)\n        res.end('Hash Mismatch')\n        return\n      }\n\n      try {\n        renameSync(tmpPath, filePath)\n      } catch (error) {\n        log.error({ error, hash }, 'Failed to rename temp file to asset.')\n        cleanup()\n        res.writeHead(500)\n        res.end('Internal Server Error')\n        return\n      }\n\n      store.upsert({\n        hash,\n        filePath,\n        mimeType,\n        size,\n        metadata\n      })\n      log.info({ hash, size }, 'Stored uploaded asset via HTTP.')\n      res.writeHead(201)\n      res.end('Created')\n    })\n  }\n\n  return {\n    start,\n    stop,\n    getBaseUrl\n  }\n}\n"],"mappings":"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"}

package/dist/asset-store.mjs

@@ -0,0 +1,167 @@
+import { ASSET_DIR, ensureDir, ensureFile, log } from "./shared.mjs";
+import { join } from "node:path";
+import { existsSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { MCP_HASH_PATTERN } from "@tempad-dev/mcp-shared";
+
+//#region src/asset-store.ts
+const INDEX_FILENAME = "assets.json";
+const DEFAULT_INDEX_PATH = join(ASSET_DIR, INDEX_FILENAME);
+function readIndex(indexPath) {
+	if (!existsSync(indexPath)) return [];
+	try {
+		const raw = readFileSync(indexPath, "utf8").trim();
+		if (!raw) return [];
+		const parsed = JSON.parse(raw);
+		return Array.isArray(parsed) ? parsed : [];
+	} catch (error) {
+		log.warn({
+			error,
+			indexPath
+		}, "Failed to read asset catalog; starting fresh.");
+		return [];
+	}
+}
+function writeIndex(indexPath, values) {
+	writeFileSync(indexPath, JSON.stringify(values, null, 2), "utf8");
+}
+function createAssetStore(options = {}) {
+	ensureDir(ASSET_DIR);
+	const indexPath = options.indexPath ?? DEFAULT_INDEX_PATH;
+	ensureFile(indexPath);
+	const records = /* @__PURE__ */ new Map();
+	let persistTimer = null;
+	function loadExisting() {
+		const list$1 = readIndex(indexPath);
+		for (const record of list$1) if (record?.hash && record?.filePath) records.set(record.hash, record);
+	}
+	function persist() {
+		if (persistTimer) return;
+		persistTimer = setTimeout(() => {
+			persistTimer = null;
+			writeIndex(indexPath, [...records.values()]);
+		}, 5e3);
+		if (typeof persistTimer.unref === "function") persistTimer.unref();
+	}
+	function flush() {
+		if (persistTimer) {
+			clearTimeout(persistTimer);
+			persistTimer = null;
+		}
+		writeIndex(indexPath, [...records.values()]);
+	}
+	function list() {
+		return [...records.values()];
+	}
+	function has(hash) {
+		return records.has(hash);
+	}
+	function get(hash) {
+		return records.get(hash);
+	}
+	function getMany(hashes) {
+		return hashes.map((hash) => records.get(hash)).filter((record) => !!record);
+	}
+	function upsert(input) {
+		const now = Date.now();
+		const record = {
+			...input,
+			uploadedAt: input.uploadedAt ?? now,
+			lastAccess: input.lastAccess ?? now
+		};
+		records.set(record.hash, record);
+		persist();
+		return record;
+	}
+	function touch(hash) {
+		const existing = records.get(hash);
+		if (!existing) return void 0;
+		existing.lastAccess = Date.now();
+		persist();
+		return existing;
+	}
+	function remove(hash, { removeFile = true } = {}) {
+		const record = records.get(hash);
+		if (!record) return;
+		records.delete(hash);
+		persist();
+		if (removeFile) try {
+			rmSync(record.filePath, { force: true });
+		} catch (error) {
+			log.warn({
+				hash,
+				error
+			}, "Failed to remove asset file on delete.");
+		}
+	}
+	function reconcile() {
+		let changed = false;
+		for (const [hash, record] of records) if (!existsSync(record.filePath)) {
+			records.delete(hash);
+			changed = true;
+		}
+		try {
+			const files = readdirSync(ASSET_DIR);
+			const now = Date.now();
+			for (const file of files) {
+				if (file === INDEX_FILENAME) continue;
+				if (file.includes(".tmp.")) {
+					try {
+						const filePath = join(ASSET_DIR, file);
+						if (now - statSync(filePath).mtimeMs > 3600 * 1e3) {
+							rmSync(filePath, { force: true });
+							log.info({ file }, "Cleaned up stale temp file.");
+						}
+					} catch (e) {
+						log.debug({
+							error: e,
+							file
+						}, "Failed to cleanup stale temp file.");
+					}
+					continue;
+				}
+				if (!MCP_HASH_PATTERN.test(file)) continue;
+				if (!records.has(file)) {
+					const filePath = join(ASSET_DIR, file);
+					try {
+						const stat = statSync(filePath);
+						records.set(file, {
+							hash: file,
+							filePath,
+							mimeType: "application/octet-stream",
+							size: stat.size,
+							uploadedAt: stat.birthtimeMs,
+							lastAccess: stat.atimeMs
+						});
+						changed = true;
+						log.info({ hash: file }, "Recovered orphan asset file.");
+					} catch (e) {
+						log.warn({
+							error: e,
+							file
+						}, "Failed to stat orphan file.");
+					}
+				}
+			}
+		} catch (error) {
+			log.warn({ error }, "Failed to scan asset directory for orphans.");
+		}
+		if (changed) flush();
+	}
+	loadExisting();
+	reconcile();
+	return {
+		list,
+		has,
+		get,
+		getMany,
+		upsert,
+		touch,
+		remove,
+		reconcile,
+		flush
+	};
+}
+
+//#endregion
+export { createAssetStore };
+//# sourceMappingURL=asset-store.mjs.map

package/dist/asset-store.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-store.mjs","names":["persistTimer: NodeJS.Timeout | null","list","record: AssetRecord"],"sources":["../src/asset-store.ts"],"sourcesContent":["import { MCP_HASH_PATTERN } from '@tempad-dev/mcp-shared'\nimport { existsSync, readFileSync, rmSync, writeFileSync, readdirSync, statSync } from 'node:fs'\nimport { join } from 'node:path'\n\nimport type { AssetRecord } from './types'\n\nimport { ASSET_DIR, ensureDir, ensureFile, log } from './shared'\n\nconst INDEX_FILENAME = 'assets.json'\nconst DEFAULT_INDEX_PATH = join(ASSET_DIR, INDEX_FILENAME)\n\nexport interface AssetStoreOptions {\n  indexPath?: string\n}\n\nexport interface AssetStore {\n  list(): AssetRecord[]\n  has(hash: string): boolean\n  get(hash: string): AssetRecord | undefined\n  getMany(hashes: string[]): AssetRecord[]\n  upsert(\n    input: Omit<AssetRecord, 'uploadedAt' | 'lastAccess'> &\n      Partial<Pick<AssetRecord, 'uploadedAt' | 'lastAccess'>>\n  ): AssetRecord\n  touch(hash: string): AssetRecord | undefined\n  remove(hash: string, opts?: { removeFile?: boolean }): void\n  reconcile(): void\n  flush(): void\n}\n\nfunction readIndex(indexPath: string): AssetRecord[] {\n  if (!existsSync(indexPath)) return []\n  try {\n    const raw = readFileSync(indexPath, 'utf8').trim()\n    if (!raw) return []\n    const parsed = JSON.parse(raw)\n    return Array.isArray(parsed) ? (parsed as AssetRecord[]) : []\n  } catch (error) {\n    log.warn({ error, indexPath }, 'Failed to read asset catalog; starting fresh.')\n    return []\n  }\n}\n\nfunction writeIndex(indexPath: string, values: AssetRecord[]): void {\n  const payload = JSON.stringify(values, null, 2)\n  writeFileSync(indexPath, payload, 'utf8')\n}\n\nexport function createAssetStore(options: AssetStoreOptions = {}): AssetStore {\n  ensureDir(ASSET_DIR)\n  const indexPath = options.indexPath ?? DEFAULT_INDEX_PATH\n  ensureFile(indexPath)\n  const records = new Map<string, AssetRecord>()\n  let persistTimer: NodeJS.Timeout | null = null\n\n  function loadExisting(): void {\n    const list = readIndex(indexPath)\n    for (const record of list) {\n      if (record?.hash && record?.filePath) {\n        records.set(record.hash, record)\n      }\n    }\n  }\n\n  function persist(): void {\n    if (persistTimer) return\n    persistTimer = setTimeout(() => {\n      persistTimer = null\n      writeIndex(indexPath, [...records.values()])\n    }, 5000)\n    if (typeof persistTimer.unref === 'function') {\n      persistTimer.unref()\n    }\n  }\n\n  function flush(): void {\n    if (persistTimer) {\n      clearTimeout(persistTimer)\n      persistTimer = null\n    }\n    writeIndex(indexPath, [...records.values()])\n  }\n\n  function list(): AssetRecord[] {\n    return [...records.values()]\n  }\n\n  function has(hash: string): boolean {\n    return records.has(hash)\n  }\n\n  function get(hash: string): AssetRecord | undefined {\n    return records.get(hash)\n  }\n\n  function getMany(hashes: string[]): AssetRecord[] {\n    return hashes\n      .map((hash) => records.get(hash))\n      .filter((record): record is AssetRecord => !!record)\n  }\n\n  function upsert(\n    input: Omit<AssetRecord, 'uploadedAt' | 'lastAccess'> &\n      Partial<Pick<AssetRecord, 'uploadedAt' | 'lastAccess'>>\n  ): AssetRecord {\n    const now = Date.now()\n    const record: AssetRecord = {\n      ...input,\n      uploadedAt: input.uploadedAt ?? now,\n      lastAccess: input.lastAccess ?? now\n    }\n    records.set(record.hash, record)\n    persist()\n    return record\n  }\n\n  function touch(hash: string): AssetRecord | undefined {\n    const existing = records.get(hash)\n    if (!existing) return undefined\n    existing.lastAccess = Date.now()\n    persist()\n    return existing\n  }\n\n  function remove(hash: string, { removeFile = true } = {}): void {\n    const record = records.get(hash)\n    if (!record) return\n    records.delete(hash)\n    persist()\n\n    if (removeFile) {\n      try {\n        rmSync(record.filePath, { force: true })\n      } catch (error) {\n        log.warn({ hash, error }, 'Failed to remove asset file on delete.')\n      }\n    }\n  }\n\n  function reconcile(): void {\n    let changed = false\n    for (const [hash, record] of records) {\n      if (!existsSync(record.filePath)) {\n        records.delete(hash)\n        changed = true\n      }\n    }\n\n    try {\n      const files = readdirSync(ASSET_DIR)\n      const now = Date.now()\n      for (const file of files) {\n        if (file === INDEX_FILENAME) continue\n\n        // Cleanup stale tmp files (> 1 hour)\n        if (file.includes('.tmp.')) {\n          try {\n            const filePath = join(ASSET_DIR, file)\n            const stat = statSync(filePath)\n            if (now - stat.mtimeMs > 3600 * 1000) {\n              rmSync(filePath, { force: true })\n              log.info({ file }, 'Cleaned up stale temp file.')\n            }\n          } catch (e) {\n            // Ignore errors during cleanup\n            log.debug({ error: e, file }, 'Failed to cleanup stale temp file.')\n          }\n          continue\n        }\n\n        if (!MCP_HASH_PATTERN.test(file)) continue\n\n        if (!records.has(file)) {\n          const filePath = join(ASSET_DIR, file)\n          try {\n            const stat = statSync(filePath)\n            records.set(file, {\n              hash: file,\n              filePath,\n              mimeType: 'application/octet-stream',\n              size: stat.size,\n              uploadedAt: stat.birthtimeMs,\n              lastAccess: stat.atimeMs\n            })\n            changed = true\n            log.info({ hash: file }, 'Recovered orphan asset file.')\n          } catch (e) {\n            log.warn({ error: e, file }, 'Failed to stat orphan file.')\n          }\n        }\n      }\n    } catch (error) {\n      log.warn({ error }, 'Failed to scan asset directory for orphans.')\n    }\n\n    if (changed) flush()\n  }\n\n  loadExisting()\n  reconcile()\n\n  return {\n    list,\n    has,\n    get,\n    getMany,\n    upsert,\n    touch,\n    remove,\n    reconcile,\n    flush\n  }\n}\n"],"mappings":";;;;;;AAQA,MAAM,iBAAiB;AACvB,MAAM,qBAAqB,KAAK,WAAW,eAAe;AAqB1D,SAAS,UAAU,WAAkC;AACnD,KAAI,CAAC,WAAW,UAAU,CAAE,QAAO,EAAE;AACrC,KAAI;EACF,MAAM,MAAM,aAAa,WAAW,OAAO,CAAC,MAAM;AAClD,MAAI,CAAC,IAAK,QAAO,EAAE;EACnB,MAAM,SAAS,KAAK,MAAM,IAAI;AAC9B,SAAO,MAAM,QAAQ,OAAO,GAAI,SAA2B,EAAE;UACtD,OAAO;AACd,MAAI,KAAK;GAAE;GAAO;GAAW,EAAE,gDAAgD;AAC/E,SAAO,EAAE;;;AAIb,SAAS,WAAW,WAAmB,QAA6B;AAElE,eAAc,WADE,KAAK,UAAU,QAAQ,MAAM,EAAE,EACb,OAAO;;AAG3C,SAAgB,iBAAiB,UAA6B,EAAE,EAAc;AAC5E,WAAU,UAAU;CACpB,MAAM,YAAY,QAAQ,aAAa;AACvC,YAAW,UAAU;CACrB,MAAM,0BAAU,IAAI,KAA0B;CAC9C,IAAIA,eAAsC;CAE1C,SAAS,eAAqB;EAC5B,MAAMC,SAAO,UAAU,UAAU;AACjC,OAAK,MAAM,UAAUA,OACnB,KAAI,QAAQ,QAAQ,QAAQ,SAC1B,SAAQ,IAAI,OAAO,MAAM,OAAO;;CAKtC,SAAS,UAAgB;AACvB,MAAI,aAAc;AAClB,iBAAe,iBAAiB;AAC9B,kBAAe;AACf,cAAW,WAAW,CAAC,GAAG,QAAQ,QAAQ,CAAC,CAAC;KAC3C,IAAK;AACR,MAAI,OAAO,aAAa,UAAU,WAChC,cAAa,OAAO;;CAIxB,SAAS,QAAc;AACrB,MAAI,cAAc;AAChB,gBAAa,aAAa;AAC1B,kBAAe;;AAEjB,aAAW,WAAW,CAAC,GAAG,QAAQ,QAAQ,CAAC,CAAC;;CAG9C,SAAS,OAAsB;AAC7B,SAAO,CAAC,GAAG,QAAQ,QAAQ,CAAC;;CAG9B,SAAS,IAAI,MAAuB;AAClC,SAAO,QAAQ,IAAI,KAAK;;CAG1B,SAAS,IAAI,MAAuC;AAClD,SAAO,QAAQ,IAAI,KAAK;;CAG1B,SAAS,QAAQ,QAAiC;AAChD,SAAO,OACJ,KAAK,SAAS,QAAQ,IAAI,KAAK,CAAC,CAChC,QAAQ,WAAkC,CAAC,CAAC,OAAO;;CAGxD,SAAS,OACP,OAEa;EACb,MAAM,MAAM,KAAK,KAAK;EACtB,MAAMC,SAAsB;GAC1B,GAAG;GACH,YAAY,MAAM,cAAc;GAChC,YAAY,MAAM,cAAc;GACjC;AACD,UAAQ,IAAI,OAAO,MAAM,OAAO;AAChC,WAAS;AACT,SAAO;;CAGT,SAAS,MAAM,MAAuC;EACpD,MAAM,WAAW,QAAQ,IAAI,KAAK;AAClC,MAAI,CAAC,SAAU,QAAO;AACtB,WAAS,aAAa,KAAK,KAAK;AAChC,WAAS;AACT,SAAO;;CAGT,SAAS,OAAO,MAAc,EAAE,aAAa,SAAS,EAAE,EAAQ;EAC9D,MAAM,SAAS,QAAQ,IAAI,KAAK;AAChC,MAAI,CAAC,OAAQ;AACb,UAAQ,OAAO,KAAK;AACpB,WAAS;AAET,MAAI,WACF,KAAI;AACF,UAAO,OAAO,UAAU,EAAE,OAAO,MAAM,CAAC;WACjC,OAAO;AACd,OAAI,KAAK;IAAE;IAAM;IAAO,EAAE,yCAAyC;;;CAKzE,SAAS,YAAkB;EACzB,IAAI,UAAU;AACd,OAAK,MAAM,CAAC,MAAM,WAAW,QAC3B,KAAI,CAAC,WAAW,OAAO,SAAS,EAAE;AAChC,WAAQ,OAAO,KAAK;AACpB,aAAU;;AAId,MAAI;GACF,MAAM,QAAQ,YAAY,UAAU;GACpC,MAAM,MAAM,KAAK,KAAK;AACtB,QAAK,MAAM,QAAQ,OAAO;AACxB,QAAI,SAAS,eAAgB;AAG7B,QAAI,KAAK,SAAS,QAAQ,EAAE;AAC1B,SAAI;MACF,MAAM,WAAW,KAAK,WAAW,KAAK;AAEtC,UAAI,MADS,SAAS,SAAS,CAChB,UAAU,OAAO,KAAM;AACpC,cAAO,UAAU,EAAE,OAAO,MAAM,CAAC;AACjC,WAAI,KAAK,EAAE,MAAM,EAAE,8BAA8B;;cAE5C,GAAG;AAEV,UAAI,MAAM;OAAE,OAAO;OAAG;OAAM,EAAE,qCAAqC;;AAErE;;AAGF,QAAI,CAAC,iBAAiB,KAAK,KAAK,CAAE;AAElC,QAAI,CAAC,QAAQ,IAAI,KAAK,EAAE;KACtB,MAAM,WAAW,KAAK,WAAW,KAAK;AACtC,SAAI;MACF,MAAM,OAAO,SAAS,SAAS;AAC/B,cAAQ,IAAI,MAAM;OAChB,MAAM;OACN;OACA,UAAU;OACV,MAAM,KAAK;OACX,YAAY,KAAK;OACjB,YAAY,KAAK;OAClB,CAAC;AACF,gBAAU;AACV,UAAI,KAAK,EAAE,MAAM,MAAM,EAAE,+BAA+B;cACjD,GAAG;AACV,UAAI,KAAK;OAAE,OAAO;OAAG;OAAM,EAAE,8BAA8B;;;;WAI1D,OAAO;AACd,OAAI,KAAK,EAAE,OAAO,EAAE,8CAA8C;;AAGpE,MAAI,QAAS,QAAO;;AAGtB,eAAc;AACd,YAAW;AAEX,QAAO;EACL;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACD"}

package/dist/cli.mjs

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+import { LOCK_PATH, PACKAGE_VERSION, RUNTIME_DIR, SOCK_PATH, ensureDir, log } from "./shared.mjs";
+import { spawn } from "node:child_process";
+import { connect } from "node:net";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import lockfile from "proper-lockfile";
+
+//#region src/cli.ts
+let activeSocket = null;
+let shuttingDown = false;
+function closeActiveSocket() {
+	if (!activeSocket) return;
+	try {
+		activeSocket.end();
+	} catch {}
+	try {
+		activeSocket.destroy();
+	} catch {}
+	activeSocket = null;
+}
+function shutdownCli(reason) {
+	if (shuttingDown) return;
+	shuttingDown = true;
+	log.info(`${reason} Shutting down CLI.`);
+	closeActiveSocket();
+	process.exit(0);
+}
+process.on("SIGINT", () => shutdownCli("SIGINT received."));
+process.on("SIGTERM", () => shutdownCli("SIGTERM received."));
+const HUB_STARTUP_TIMEOUT = 5e3;
+const CONNECT_RETRY_DELAY = 200;
+const FAILED_RESTART_DELAY = 5e3;
+const HUB_ENTRY = join(fileURLToPath(new URL(".", import.meta.url)), "hub.js");
+ensureDir(RUNTIME_DIR);
+function bridge(socket) {
+	return new Promise((resolve) => {
+		log.info("Bridge established with Hub. Forwarding I/O.");
+		activeSocket = socket;
+		const onStdinEnd = () => {
+			shutdownCli("Consumer stream ended.");
+		};
+		process.stdin.once("end", onStdinEnd);
+		const onSocketClose = () => {
+			log.warn("Connection to Hub lost. Attempting to reconnect...");
+			activeSocket = null;
+			process.stdin.removeListener("end", onStdinEnd);
+			process.stdin.unpipe(socket);
+			socket.unpipe(process.stdout);
+			socket.removeAllListeners();
+			resolve();
+		};
+		socket.once("close", onSocketClose);
+		socket.on("error", (err) => log.warn({ err }, "Socket error occurred."));
+		process.stdin.pipe(socket, { end: false }).pipe(process.stdout);
+	});
+}
+function connectHub() {
+	return new Promise((resolve, reject) => {
+		const socket = connect(SOCK_PATH);
+		socket.on("connect", () => {
+			socket.removeAllListeners("error");
+			resolve(socket);
+		});
+		socket.on("error", reject);
+	});
+}
+async function connectWithRetry(timeout) {
+	const startTime = Date.now();
+	let delay = CONNECT_RETRY_DELAY;
+	while (Date.now() - startTime < timeout) try {
+		return await connectHub();
+	} catch (err) {
+		if (err && typeof err === "object" && "code" in err && (err.code === "ENOENT" || err.code === "ECONNREFUSED")) {
+			const remainingTime = timeout - (Date.now() - startTime);
+			const waitTime = Math.min(delay, remainingTime);
+			if (waitTime <= 0) break;
+			await new Promise((r) => setTimeout(r, waitTime));
+			delay = Math.min(delay * 1.5, 1e3);
+		} else throw err;
+	}
+	throw new Error(`Failed to connect to Hub within ${timeout}ms.`);
+}
+function startHub() {
+	log.info("Spawning new Hub process...");
+	return spawn(process.execPath, [HUB_ENTRY], {
+		detached: true,
+		stdio: "ignore"
+	});
+}
+async function tryBecomeLeaderAndStartHub() {
+	let releaseLock = null;
+	try {
+		releaseLock = await lockfile.lock(LOCK_PATH, {
+			retries: {
+				retries: 5,
+				factor: 1.2,
+				minTimeout: 50
+			},
+			stale: 15e3
+		});
+	} catch {
+		log.info("Another process is starting the Hub. Waiting...");
+		return connectWithRetry(HUB_STARTUP_TIMEOUT);
+	}
+	log.info("Acquired lock. Starting Hub as the leader...");
+	let child = null;
+	try {
+		try {
+			return await connectHub();
+		} catch {
+			log.info("Hub not running. Proceeding to start it...");
+		}
+		child = startHub();
+		child.on("error", (err) => log.error({ err }, "Hub child process error."));
+		const socket = await connectWithRetry(HUB_STARTUP_TIMEOUT);
+		child.unref();
+		return socket;
+	} catch (err) {
+		log.error({ err }, "Failed to start or connect to the Hub.");
+		if (child && !child.killed) {
+			log.warn(`Killing stale Hub process (PID: ${child.pid})...`);
+			child.kill("SIGTERM");
+		}
+		throw err;
+	} finally {
+		if (releaseLock) await releaseLock();
+	}
+}
+async function main() {
+	log.info({ version: PACKAGE_VERSION }, "TemPad MCP Client starting...");
+	while (true) try {
+		await bridge(await connectHub().catch(() => {
+			log.info("Hub not running. Initiating startup sequence...");
+			return tryBecomeLeaderAndStartHub();
+		}));
+		log.info("Bridge disconnected. Restarting connection process...");
+	} catch (err) {
+		log.error({ err }, `Connection attempt failed. Retrying in ${FAILED_RESTART_DELAY / 1e3}s...`);
+		await new Promise((r) => setTimeout(r, FAILED_RESTART_DELAY));
+	}
+}
+main();
+
+//#endregion
+export {  };
+//# sourceMappingURL=cli.mjs.map

package/dist/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":["activeSocket: Socket | null","err: unknown","releaseLock: (() => Promise<void>) | null","child: ChildProcess | null"],"sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n\nimport type { ChildProcess } from 'node:child_process'\nimport type { Socket } from 'node:net'\n\nimport { spawn } from 'node:child_process'\nimport { connect } from 'node:net'\nimport { join } from 'node:path'\nimport { fileURLToPath } from 'node:url'\nimport lockfile from 'proper-lockfile'\n\nimport { PACKAGE_VERSION, log, LOCK_PATH, RUNTIME_DIR, SOCK_PATH, ensureDir } from './shared'\n\nlet activeSocket: Socket | null = null\nlet shuttingDown = false\n\nfunction closeActiveSocket() {\n  if (!activeSocket) return\n  try {\n    activeSocket.end()\n  } catch {\n    // ignore\n  }\n  try {\n    activeSocket.destroy()\n  } catch {\n    // ignore\n  }\n  activeSocket = null\n}\n\nfunction shutdownCli(reason: string) {\n  if (shuttingDown) return\n  shuttingDown = true\n  log.info(`${reason} Shutting down CLI.`)\n  closeActiveSocket()\n  process.exit(0)\n}\n\nprocess.on('SIGINT', () => shutdownCli('SIGINT received.'))\nprocess.on('SIGTERM', () => shutdownCli('SIGTERM received.'))\n\nconst HUB_STARTUP_TIMEOUT = 5000\nconst CONNECT_RETRY_DELAY = 200\nconst FAILED_RESTART_DELAY = 5000\nconst HERE = fileURLToPath(new URL('.', import.meta.url))\nconst HUB_ENTRY = join(HERE, 'hub.js')\n\nensureDir(RUNTIME_DIR)\n\nfunction bridge(socket: Socket): Promise<void> {\n  return new Promise((resolve) => {\n    log.info('Bridge established with Hub. Forwarding I/O.')\n    activeSocket = socket\n\n    const onStdinEnd = () => {\n      shutdownCli('Consumer stream ended.')\n    }\n    process.stdin.once('end', onStdinEnd)\n\n    const onSocketClose = () => {\n      log.warn('Connection to Hub lost. Attempting to reconnect...')\n      activeSocket = null\n      process.stdin.removeListener('end', onStdinEnd)\n      process.stdin.unpipe(socket)\n      socket.unpipe(process.stdout)\n      socket.removeAllListeners()\n      resolve()\n    }\n    socket.once('close', onSocketClose)\n    socket.on('error', (err) => log.warn({ err }, 'Socket error occurred.'))\n\n    // The `{ end: false }` option prevents stdin from closing the socket.\n    process.stdin.pipe(socket, { end: false }).pipe(process.stdout)\n  })\n}\n\nfunction connectHub(): Promise<Socket> {\n  return new Promise((resolve, reject) => {\n    const socket = connect(SOCK_PATH)\n    socket.on('connect', () => {\n      socket.removeAllListeners('error')\n      resolve(socket)\n    })\n    socket.on('error', reject)\n  })\n}\n\nasync function connectWithRetry(timeout: number): Promise<Socket> {\n  const startTime = Date.now()\n  let delay = CONNECT_RETRY_DELAY\n  while (Date.now() - startTime < timeout) {\n    try {\n      return await connectHub()\n    } catch (err: unknown) {\n      if (\n        err &&\n        typeof err === 'object' &&\n        'code' in err &&\n        (err.code === 'ENOENT' || err.code === 'ECONNREFUSED')\n      ) {\n        const remainingTime = timeout - (Date.now() - startTime)\n        const waitTime = Math.min(delay, remainingTime)\n        if (waitTime <= 0) break\n        await new Promise((r) => setTimeout(r, waitTime))\n        delay = Math.min(delay * 1.5, 1000)\n      } else {\n        throw err\n      }\n    }\n  }\n  throw new Error(`Failed to connect to Hub within ${timeout}ms.`)\n}\n\nfunction startHub(): ChildProcess {\n  log.info('Spawning new Hub process...')\n  return spawn(process.execPath, [HUB_ENTRY], {\n    detached: true,\n    stdio: 'ignore'\n  })\n}\n\nasync function tryBecomeLeaderAndStartHub(): Promise<Socket> {\n  let releaseLock: (() => Promise<void>) | null = null\n  try {\n    releaseLock = await lockfile.lock(LOCK_PATH, {\n      retries: { retries: 5, factor: 1.2, minTimeout: 50 },\n      stale: 15000\n    })\n  } catch {\n    log.info('Another process is starting the Hub. Waiting...')\n    return connectWithRetry(HUB_STARTUP_TIMEOUT)\n  }\n\n  log.info('Acquired lock. Starting Hub as the leader...')\n  let child: ChildProcess | null = null\n  try {\n    try {\n      return await connectHub()\n    } catch {\n      // If the Hub is not running, we proceed to start it.\n      log.info('Hub not running. Proceeding to start it...')\n    }\n    child = startHub()\n    child.on('error', (err) => log.error({ err }, 'Hub child process error.'))\n    const socket = await connectWithRetry(HUB_STARTUP_TIMEOUT)\n    child.unref()\n    return socket\n  } catch (err: unknown) {\n    log.error({ err }, 'Failed to start or connect to the Hub.')\n    if (child && !child.killed) {\n      log.warn(`Killing stale Hub process (PID: ${child.pid})...`)\n      child.kill('SIGTERM')\n    }\n    throw err\n  } finally {\n    if (releaseLock) await releaseLock()\n  }\n}\n\nasync function main() {\n  log.info({ version: PACKAGE_VERSION }, 'TemPad MCP Client starting...')\n\n  while (true) {\n    try {\n      const socket = await connectHub().catch(() => {\n        log.info('Hub not running. Initiating startup sequence...')\n        return tryBecomeLeaderAndStartHub()\n      })\n      await bridge(socket)\n      log.info('Bridge disconnected. Restarting connection process...')\n    } catch (err: unknown) {\n      log.error(\n        { err },\n        `Connection attempt failed. Retrying in ${FAILED_RESTART_DELAY / 1000}s...`\n      )\n      await new Promise((r) => setTimeout(r, FAILED_RESTART_DELAY))\n    }\n  }\n}\n\nmain()\n"],"mappings":"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"}

package/dist/config.mjs

@@ -0,0 +1,29 @@
+import { MCP_AUTO_ACTIVATE_GRACE_MS, MCP_MAX_ASSET_BYTES, MCP_MAX_PAYLOAD_BYTES, MCP_PORT_CANDIDATES, MCP_TOOL_TIMEOUT_MS } from "@tempad-dev/mcp-shared";
+
+//#region src/config.ts
+function parsePositiveInt(envValue, fallback) {
+	const parsed = envValue ? Number.parseInt(envValue, 10) : NaN;
+	return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+function resolveToolTimeoutMs() {
+	return parsePositiveInt(process.env.TEMPAD_MCP_TOOL_TIMEOUT, MCP_TOOL_TIMEOUT_MS);
+}
+function resolveAutoActivateGraceMs() {
+	return parsePositiveInt(process.env.TEMPAD_MCP_AUTO_ACTIVATE_GRACE, MCP_AUTO_ACTIVATE_GRACE_MS);
+}
+function resolveMaxAssetSizeBytes() {
+	return parsePositiveInt(process.env.TEMPAD_MCP_MAX_ASSET_BYTES, MCP_MAX_ASSET_BYTES);
+}
+function getMcpServerConfig() {
+	return {
+		wsPortCandidates: [...MCP_PORT_CANDIDATES],
+		toolTimeoutMs: resolveToolTimeoutMs(),
+		maxPayloadBytes: MCP_MAX_PAYLOAD_BYTES,
+		autoActivateGraceMs: resolveAutoActivateGraceMs(),
+		maxAssetSizeBytes: resolveMaxAssetSizeBytes()
+	};
+}
+
+//#endregion
+export { getMcpServerConfig };
+//# sourceMappingURL=config.mjs.map

package/dist/config.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.mjs","names":[],"sources":["../src/config.ts"],"sourcesContent":["import {\n  MCP_AUTO_ACTIVATE_GRACE_MS,\n  MCP_MAX_ASSET_BYTES,\n  MCP_MAX_PAYLOAD_BYTES,\n  MCP_PORT_CANDIDATES,\n  MCP_TOOL_TIMEOUT_MS\n} from '@tempad-dev/mcp-shared'\n\nfunction parsePositiveInt(envValue: string | undefined, fallback: number): number {\n  const parsed = envValue ? Number.parseInt(envValue, 10) : Number.NaN\n  return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback\n}\n\nfunction resolveToolTimeoutMs(): number {\n  return parsePositiveInt(process.env.TEMPAD_MCP_TOOL_TIMEOUT, MCP_TOOL_TIMEOUT_MS)\n}\n\nfunction resolveAutoActivateGraceMs(): number {\n  return parsePositiveInt(process.env.TEMPAD_MCP_AUTO_ACTIVATE_GRACE, MCP_AUTO_ACTIVATE_GRACE_MS)\n}\n\nfunction resolveMaxAssetSizeBytes(): number {\n  return parsePositiveInt(process.env.TEMPAD_MCP_MAX_ASSET_BYTES, MCP_MAX_ASSET_BYTES)\n}\n\nexport function getMcpServerConfig() {\n  return {\n    wsPortCandidates: [...MCP_PORT_CANDIDATES],\n    toolTimeoutMs: resolveToolTimeoutMs(),\n    maxPayloadBytes: MCP_MAX_PAYLOAD_BYTES,\n    autoActivateGraceMs: resolveAutoActivateGraceMs(),\n    maxAssetSizeBytes: resolveMaxAssetSizeBytes()\n  }\n}\n"],"mappings":";;;AAQA,SAAS,iBAAiB,UAA8B,UAA0B;CAChF,MAAM,SAAS,WAAW,OAAO,SAAS,UAAU,GAAG,GAAG;AAC1D,QAAO,OAAO,SAAS,OAAO,IAAI,SAAS,IAAI,SAAS;;AAG1D,SAAS,uBAA+B;AACtC,QAAO,iBAAiB,QAAQ,IAAI,yBAAyB,oBAAoB;;AAGnF,SAAS,6BAAqC;AAC5C,QAAO,iBAAiB,QAAQ,IAAI,gCAAgC,2BAA2B;;AAGjG,SAAS,2BAAmC;AAC1C,QAAO,iBAAiB,QAAQ,IAAI,4BAA4B,oBAAoB;;AAGtF,SAAgB,qBAAqB;AACnC,QAAO;EACL,kBAAkB,CAAC,GAAG,oBAAoB;EAC1C,eAAe,sBAAsB;EACrC,iBAAiB;EACjB,qBAAqB,4BAA4B;EACjD,mBAAmB,0BAA0B;EAC9C"}