@ait-co/devtools 0.1.41 → 0.1.44

package/dist/mcp/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","names":[],"sources":["../../src/mcp/ait-source.ts","../../src/mcp/server.ts"],"mappings":";;;;;;;AAsBA;;;;;AAGA;;;;;;;;;;;;;KAHY,kBAAA;AAqBZ;AAAA,UAlBiB,UAAA;;EAEf,MAAA;EAiBiB;EAfjB,IAAA;EAwBsB;EAtBtB,SAAA;EAsByB;EApBzB,MAAA;EAuBe;EArBf,MAAA;;EAEA,KAAA;EAuBU;EArBV,QAAA,EAAU,kBAAA;AAAA;;UAIK,iBAAA;EACf,KAAA,EAAO,UAAA;AAAA;;;;;;;KASG,YAAA,GAAe,MAAA;;UAGV,yBAAA;EAW2C;EAT1D,WAAA;EAYuB;EAVvB,UAAA;AAAA;;UAIe,YAAA;EACf,uBAAA,EAAyB,iBAAA;EACzB,kBAAA,EAAoB,YAAA;EACpB,+BAAA,EAAiC,yBAAA;AAAA;AAAA,KAGvB,aAAA,SAAsB,YAAA;;;;;UAMjB,SAAA;EACf,GAAA,WAAc,aAAA,EAAe,MAAA,EAAQ,CAAA,GAAI,OAAA,CAAQ,YAAA,CAAa,CAAA;AAAA;;;UCO/C,mBAAA;EDpBY;ECsB3B,SAAA,GAAY,SAAA;AAAA;;iBAIE,eAAA,CAAgB,IAAA,GAAM,mBAAA,GAA2B,MAAA;;iBA6D3C,YAAA,CAAA,GAAgB,OAAA"}
+{"version":3,"file":"server.d.ts","names":[],"sources":["../../src/mcp/ait-source.ts","../../src/mcp/server.ts"],"mappings":";;;;;;;AAsBA;;;;;AAGA;;;;;;;;;;;;;KAHY,kBAAA;AAqBZ;AAAA,UAlBiB,UAAA;;EAEf,MAAA;EAiBiB;EAfjB,IAAA;EAwBsB;EAtBtB,SAAA;EAsByB;EApBzB,MAAA;EAuBe;EArBf,MAAA;;EAEA,KAAA;EAuBU;EArBV,QAAA,EAAU,kBAAA;AAAA;;UAIK,iBAAA;EACf,KAAA,EAAO,UAAA;AAAA;;;;;;;KASG,YAAA,GAAe,MAAA;;UAGV,yBAAA;EAW2C;EAT1D,WAAA;EAYuB;EAVvB,UAAA;AAAA;;UAIe,YAAA;EACf,uBAAA,EAAyB,iBAAA;EACzB,kBAAA,EAAoB,YAAA;EACpB,+BAAA,EAAiC,yBAAA;AAAA;AAAA,KAGvB,aAAA,SAAsB,YAAA;;;;;UAMjB,SAAA;EACf,GAAA,WAAc,aAAA,EAAe,MAAA,EAAQ,CAAA,GAAI,OAAA,CAAQ,YAAA,CAAa,CAAA;AAAA;;;UCmB/C,mBAAA;EDhCY;ECkC3B,SAAA,GAAY,SAAA;AAAA;;iBAIE,eAAA,CAAgB,IAAA,GAAM,mBAAA,GAA2B,MAAA;;iBAsD3C,YAAA,CAAA,GAAgB,OAAA"}

package/dist/mcp/server.js

@@ -38,6 +38,22 @@ var HttpAitSource = class {
 	}
 };
 //#endregion
+//#region src/mcp/errors.ts
+/**
+* 한국어 한 줄 "원인 + 다음 행동" 포맷으로 에러 결과를 빌드한다.
+*
+* @param message - 사용자에게 보여줄 에러 본문 (원인 + 다음 행동 포함).
+*/
+function mcpError(message) {
+	return {
+		content: [{
+			type: "text",
+			text: message
+		}],
+		isError: true
+	};
+}
+//#endregion
 //#region src/mcp/sdk-signatures.ts
 function isObject(v) {
 	return typeof v === "object" && v !== null && !Array.isArray(v);
@@ -183,7 +199,8 @@ new Set([
 			type: "object",
 			properties: {},
 			required: []
-		}
+		},
+		availableIn: "both"
 	},
 	{
 		name: "list_network_requests",
@@ -192,16 +209,18 @@ new Set([
 			type: "object",
 			properties: {},
 			required: []
-		}
+		},
+		availableIn: "both"
 	},
 	{
 		name: "list_pages",
-		description: "Returns the single active page (at most one) the relay sees attached. When a second page attaches, the previous one is evicted (last-attach wins — single-attach model). The result includes `singleAttachModel: true` so the agent knows the array is always 0 or 1 entries. Also returns whether the cloudflared tunnel is up and the public wss relay URL. Each page entry includes a `lastSeenAt` ISO timestamp (last inbound CDP message from that target — useful to detect stale entries when the phone app backgrounded). The result also includes `crashDetectedAt` (ISO timestamp or null): when non-null, a page crash was detected via Inspector.targetCrashed / Target.targetDestroyed since the last attach, the pages list will be empty, and `crashWarning` shows a Korean hint to re-attach. Call this first to confirm a page is attached before reading console/network.",
+		description: "Returns the single active page (at most one) the relay sees attached. When a second page attaches, the previous one is evicted (last-attach wins — single-attach model). The result includes `singleAttachModel: true` so the agent knows the array is always 0 or 1 entries. Also returns whether the cloudflared tunnel is up and the public wss relay URL. The `tunnel` field includes `droppedAt` (ISO timestamp or null/undefined): when non-null the tunnel has permanently dropped after 3 failed reissue attempts — restart the debug server with `npx @ait-co/devtools devtools-mcp`. Each page entry includes a `lastSeenAt` ISO timestamp (last inbound CDP message from that target — useful to detect stale entries when the phone app backgrounded). The result also includes `crashDetectedAt` (ISO timestamp or null): when non-null, a page crash was detected via Inspector.targetCrashed / Target.targetDestroyed since the last attach, the pages list will be empty, and `crashWarning` shows a Korean hint to re-attach. Call this first to confirm a page is attached before reading console/network.",
 		inputSchema: {
 			type: "object",
 			properties: {},
 			required: []
-		}
+		},
+		availableIn: "both"
 	},
 	{
 		name: "build_attach_url",
@@ -223,7 +242,8 @@ new Set([
 				}
 			},
 			required: ["scheme_url"]
-		}
+		},
+		availableIn: "relay"
 	},
 	{
 		name: "get_dom_document",
@@ -232,7 +252,8 @@ new Set([
 			type: "object",
 			properties: {},
 			required: []
-		}
+		},
+		availableIn: "both"
 	},
 	{
 		name: "take_snapshot",
@@ -241,7 +262,8 @@ new Set([
 			type: "object",
 			properties: {},
 			required: []
-		}
+		},
+		availableIn: "both"
 	},
 	{
 		name: "take_screenshot",
@@ -250,16 +272,18 @@ new Set([
 			type: "object",
 			properties: {},
 			required: []
-		}
+		},
+		availableIn: "both"
 	},
 	{
 		name: "measure_safe_area",
-		description: "Runs a safe-area probe on the attached mini-app page via Runtime.evaluate and returns normalized safe-area insets, viewport geometry, device pixel ratio, and User-Agent. Read-only — does not modify page state. Use in a relay session (phone attached) to get ground-truth values for upgrading a viewport preset from extrapolated/placeholder to measured. Requires the relay to be attached — call list_pages first.",
+		description: "Runs a safe-area probe on the attached mini-app page via Runtime.evaluate and returns normalized safe-area insets, viewport geometry, device pixel ratio, and User-Agent. Read-only — does not modify page state. Tier C per RFC #277: the same Runtime.evaluate probe runs in both `mock` (devtools panel page with window.__ait state) and `relay` (real-device WebView with window.__sdk). The result includes a `source: \"mock\" | \"relay\"` field so consumers can identify provenance without inspecting payload values. Use in a relay session (phone attached) to get ground-truth values for upgrading a viewport preset from extrapolated/placeholder to measured. Requires a page to be attached — call list_pages first.",
 		inputSchema: {
 			type: "object",
 			properties: {},
 			required: []
-		}
+		},
+		availableIn: "both"
 	},
 	{
 		name: "evaluate",
@@ -271,7 +295,8 @@ new Set([
 				description: "JavaScript expression to evaluate in the page context."
 			} },
 			required: ["expression"]
-		}
+		},
+		availableIn: "both"
 	},
 	{
 		name: "list_exceptions",
@@ -283,7 +308,8 @@ new Set([
 				description: "Maximum number of exceptions to return (default 50, max 50)."
 			} },
 			required: []
-		}
+		},
+		availableIn: "both"
 	},
 	{
 		name: "call_sdk",
@@ -302,7 +328,8 @@ new Set([
 				}
 			},
 			required: ["name"]
-		}
+		},
+		availableIn: "both"
 	},
 	{
 		name: "AIT.getSdkCallHistory",
@@ -311,7 +338,8 @@ new Set([
 			type: "object",
 			properties: {},
 			required: []
-		}
+		},
+		availableIn: "both"
 	},
 	{
 		name: "AIT.getMockState",
@@ -320,7 +348,8 @@ new Set([
 			type: "object",
 			properties: {},
 			required: []
-		}
+		},
+		availableIn: "both"
 	},
 	{
 		name: "AIT.getOperationalEnvironment",
@@ -329,7 +358,21 @@ new Set([
 			type: "object",
 			properties: {},
 			required: []
-		}
+		},
+		availableIn: "both"
+	},
+	{
+		name: "get_diagnostics",
+		description: "Returns a single-call server status snapshot so the agent can diagnose \"why is this not working?\" without calling multiple tools. Fields: mcpVersion (MCP SDK version), devtoolsVersion (@ait-co/devtools package version), tunnel (up/wssUrl/pid/startedAt), pages (list_pages result + lastSeenAt stats), lastAttachAt, lastDetachAt, recentErrors (last N server-side errors, PII/secret redacted), environment (getEnvironment() result + reason), serverLockHolder (pid + startedAt from the lock file, or null). All fields are nullable — missing data is null, not an error. Tier C (both mock and relay). Call this first when debugging session state.",
+		inputSchema: {
+			type: "object",
+			properties: { recent_errors_limit: {
+				type: "number",
+				description: "Maximum number of recent server-side errors to include (default 10, max 50)."
+			} },
+			required: []
+		},
+		availableIn: "both"
 	}
 ].map((t) => t.name));
 `
@@ -350,17 +393,28 @@ new Set([
   };
   document.documentElement.removeChild(el);
   var sdkInsets = null;
+  var sdkInsetsSource = null;
   var sdkInsetsError = undefined;
   try {
     var sdk = window.__sdk;
+    var ait = window.__ait;
     if (sdk && sdk.SafeAreaInsets && typeof sdk.SafeAreaInsets.get === 'function') {
       sdkInsets = sdk.SafeAreaInsets.get();
+      sdkInsetsSource = 'window.__sdk';
     } else if (sdk && typeof sdk.getSafeAreaInsets === 'function') {
       sdkInsets = sdk.getSafeAreaInsets();
-    } else if (!sdk) {
-      sdkInsetsError = 'window.__sdk not available (non-dogfood bundle)';
-    } else {
+      sdkInsetsSource = 'window.__sdk';
+    } else if (ait && ait.state && ait.state.safeAreaInsets &&
+               typeof ait.state.safeAreaInsets.top === 'number') {
+      var s = ait.state.safeAreaInsets;
+      sdkInsets = { top: s.top, bottom: s.bottom, left: s.left, right: s.right };
+      sdkInsetsSource = 'window.__ait';
+    } else if (!sdk && !ait) {
+      sdkInsetsError = 'neither window.__sdk (relay) nor window.__ait (mock) available';
+    } else if (sdk) {
       sdkInsetsError = 'neither SafeAreaInsets.get nor getSafeAreaInsets found on window.__sdk';
+    } else {
+      sdkInsetsError = 'window.__ait.state.safeAreaInsets is missing or malformed';
     }
   } catch(e) {
     sdkInsetsError = String(e && e.message || e);
@@ -377,6 +431,7 @@ new Set([
   var result = {
     cssEnv: cssEnv,
     sdkInsets: sdkInsets,
+    sdkInsetsSource: sdkInsetsSource,
     navBarHeight: navBarHeight,
     navBarHeightSource: navBarHeightSource,
     innerWidth: window.innerWidth,
@@ -447,7 +502,13 @@ function getOperationalEnvironment(source) {
 *     }
 *   }
 */
-/** Tool descriptors served by the dev-mode server. */
+/**
+* Tool descriptors served by the dev-mode server.
+*
+* All dev-mode tools are Tier C (both envs) per RFC #277 — the dev-mode server
+* itself is the mock-side embodiment of those Tier C tools. `availableIn` is
+* declared so the surface stays consistent with the debug-mode registry.
+*/
 const DEV_TOOL_DEFINITIONS = [
 	{
 		name: "AIT.getMockState",
@@ -456,7 +517,8 @@ const DEV_TOOL_DEFINITIONS = [
 			type: "object",
 			properties: {},
 			required: []
-		}
+		},
+		availableIn: "both"
 	},
 	{
 		name: "AIT.getOperationalEnvironment",
@@ -465,7 +527,8 @@ const DEV_TOOL_DEFINITIONS = [
 			type: "object",
 			properties: {},
 			required: []
-		}
+		},
+		availableIn: "both"
 	},
 	{
 		name: "AIT.getSdkCallHistory",
@@ -474,7 +537,8 @@ const DEV_TOOL_DEFINITIONS = [
 			type: "object",
 			properties: {},
 			required: []
-		}
+		},
+		availableIn: "both"
 	},
 	{
 		name: "devtools_get_mock_state",
@@ -483,7 +547,8 @@ const DEV_TOOL_DEFINITIONS = [
 			type: "object",
 			properties: {},
 			required: []
-		}
+		},
+		availableIn: "both"
 	}
 ];
 const DEV_TOOL_NAMES = new Set(DEV_TOOL_DEFINITIONS.map((t) => t.name));
@@ -493,47 +558,23 @@ function createDevServer(deps = {}) {
 	const aitSource = deps.aitSource ?? new HttpAitSource({ stateEndpoint });
 	const server = new Server({
 		name: "ait-devtools",
-		version: "0.1.41"
+		version: "0.1.44"
 	}, { capabilities: { tools: {} } });
 	server.setRequestHandler(ListToolsRequestSchema, () => ({ tools: DEV_TOOL_DEFINITIONS.map((tool) => ({ ...tool })) }));
 	server.setRequestHandler(CallToolRequestSchema, async (request) => {
 		const name = request.params.name;
-		if (!DEV_TOOL_NAMES.has(name)) return {
-			content: [{
-				type: "text",
-				text: `Unknown tool: ${name}`
-			}],
-			isError: true
-		};
+		if (!DEV_TOOL_NAMES.has(name)) return mcpError(`알 수 없는 tool: ${name}`);
 		try {
 			const effective = name === "devtools_get_mock_state" ? "AIT.getMockState" : name;
-			if (!isAitToolName(effective)) return {
-				content: [{
-					type: "text",
-					text: `Unknown tool: ${name}`
-				}],
-				isError: true
-			};
+			if (!isAitToolName(effective)) return mcpError(`알 수 없는 tool: ${name}`);
 			switch (effective) {
 				case "AIT.getMockState": return jsonResult(await getMockState(aitSource));
 				case "AIT.getOperationalEnvironment": return jsonResult(await getOperationalEnvironment(aitSource));
 				case "AIT.getSdkCallHistory": return jsonResult(await getSdkCallHistory(aitSource));
-				default: return {
-					content: [{
-						type: "text",
-						text: `Unknown tool: ${name}`
-					}],
-					isError: true
-				};
+				default: return mcpError(`알 수 없는 tool: ${name}`);
 			}
 		} catch (err) {
-			return {
-				content: [{
-					type: "text",
-					text: `${err instanceof Error ? err.message : String(err)}\nIs the Vite dev server running with the @ait-co/devtools unplugin option \`mcp: true\`? Is AIT_DEVTOOLS_URL set correctly?`
-				}],
-				isError: true
-			};
+			return mcpError(`${name} 실패: ${err instanceof Error ? err.message : String(err)}\nVite dev 서버가 @ait-co/devtools unplugin \`mcp: true\` 옵션으로 실행 중인지 확인하세요. AIT_DEVTOOLS_URL 환경변수가 올바르게 설정됐는지도 확인하세요.`);
 		}
 	});
 	return server;