@ait-co/devtools 0.1.40 → 0.1.43

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;;;UCkB/C,mBAAA;ED/BY;ECiC3B,SAAA,GAAY,SAAA;AAAA;;iBAIE,eAAA,CAAgB,IAAA,GAAM,mBAAA,GAA2B,MAAA;;iBA6D3C,YAAA,CAAA,GAAgB,OAAA"}

package/dist/mcp/server.js

@@ -3,7 +3,7 @@ import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 //#region src/mcp/ait-http-source.ts
-function isObject(value) {
+function isObject$1(value) {
 	return typeof value === "object" && value !== null;
 }
 var HttpAitSource = class {
@@ -17,7 +17,7 @@ var HttpAitSource = class {
 		const res = await this.fetchImpl(this.stateEndpoint);
 		if (!res.ok) throw new Error(`Failed to fetch mock state from ${this.stateEndpoint}: HTTP ${res.status} ${res.statusText}. Ensure the Vite dev server is running with the @ait-co/devtools unplugin option \`mcp: true\`.`);
 		const body = await res.json();
-		return isObject(body) ? body : {};
+		return isObject$1(body) ? body : {};
 	}
 	async get(method) {
 		switch (method) {
@@ -37,6 +37,144 @@ var HttpAitSource = class {
 		}
 	}
 };
+//#endregion
+//#region src/mcp/sdk-signatures.ts
+function isObject(v) {
+	return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function describeArgs(args) {
+	try {
+		return JSON.stringify(args);
+	} catch {
+		return String(args);
+	}
+}
+/**
+* 등록된 메서드 목록.
+*
+* 시그니처 출처 확인:
+*   - 함수가 인자를 받지 않으면 args[0] 없음 → `args.length === 0`을 체크하지 않고
+*     그냥 통과시킨다(args 무시하는 stub가 많아서 noArgs 체크가 noise).
+*   - 실 SDK 시그니처는 `src/__typecheck.ts`의 `Assert<Mock, Original>` 줄로 보장.
+*/
+const SIGNATURES = [
+	{
+		name: "setDeviceOrientation",
+		validateArgs(args) {
+			const arg = args[0];
+			if (!isObject(arg)) return {
+				ok: false,
+				expected: "{ type: 'portrait' | 'landscape' }",
+				received: describeArgs(args)
+			};
+			const type = arg.type;
+			if (type !== "portrait" && type !== "landscape") return {
+				ok: false,
+				expected: "{ type: 'portrait' | 'landscape' }",
+				received: describeArgs(args)
+			};
+			return { ok: true };
+		},
+		example: "call_sdk('setDeviceOrientation', [{ type: 'landscape' }])"
+	},
+	{
+		name: "setIosSwipeGestureEnabled",
+		validateArgs(args) {
+			const arg = args[0];
+			if (!isObject(arg) || typeof arg.isEnabled !== "boolean") return {
+				ok: false,
+				expected: "{ isEnabled: boolean }",
+				received: describeArgs(args)
+			};
+			return { ok: true };
+		},
+		example: "call_sdk('setIosSwipeGestureEnabled', [{ isEnabled: false }])"
+	},
+	{
+		name: "setSecureScreen",
+		validateArgs(args) {
+			const arg = args[0];
+			if (!isObject(arg) || typeof arg.enabled !== "boolean") return {
+				ok: false,
+				expected: "{ enabled: boolean }",
+				received: describeArgs(args)
+			};
+			return { ok: true };
+		},
+		example: "call_sdk('setSecureScreen', [{ enabled: true }])"
+	},
+	{
+		name: "setScreenAwakeMode",
+		validateArgs(args) {
+			const arg = args[0];
+			if (!isObject(arg) || typeof arg.enabled !== "boolean") return {
+				ok: false,
+				expected: "{ enabled: boolean }",
+				received: describeArgs(args)
+			};
+			return { ok: true };
+		},
+		example: "call_sdk('setScreenAwakeMode', [{ enabled: true }])"
+	},
+	{
+		name: "getOperationalEnvironment",
+		validateArgs(_args) {
+			return { ok: true };
+		},
+		example: "call_sdk('getOperationalEnvironment', [])"
+	},
+	{
+		name: "getPlatformOS",
+		validateArgs(_args) {
+			return { ok: true };
+		},
+		example: "call_sdk('getPlatformOS', [])"
+	},
+	{
+		name: "getDeviceId",
+		validateArgs(_args) {
+			return { ok: true };
+		},
+		example: "call_sdk('getDeviceId', [])"
+	},
+	{
+		name: "getLocale",
+		validateArgs(_args) {
+			return { ok: true };
+		},
+		example: "call_sdk('getLocale', [])"
+	},
+	{
+		name: "getNetworkStatus",
+		validateArgs(_args) {
+			return { ok: true };
+		},
+		example: "call_sdk('getNetworkStatus', [])"
+	},
+	{
+		name: "getSchemeUri",
+		validateArgs(_args) {
+			return { ok: true };
+		},
+		example: "call_sdk('getSchemeUri', [])"
+	},
+	{
+		name: "requestReview",
+		validateArgs(_args) {
+			return { ok: true };
+		},
+		example: "call_sdk('requestReview', [])"
+	},
+	{
+		name: "closeView",
+		validateArgs(_args) {
+			return { ok: true };
+		},
+		example: "call_sdk('closeView', [])"
+	}
+];
+new Map(SIGNATURES.map((s) => [s.name, s]));
+SIGNATURES.map((s) => s.name);
 new Set([
 	{
 		name: "list_console_messages",
@@ -45,7 +183,8 @@ new Set([
 			type: "object",
 			properties: {},
 			required: []
-		}
+		},
+		availableIn: "both"
 	},
 	{
 		name: "list_network_requests",
@@ -54,16 +193,18 @@ new Set([
 			type: "object",
 			properties: {},
 			required: []
-		}
+		},
+		availableIn: "both"
 	},
 	{
 		name: "list_pages",
-		description: "Lists the mini-app page(s) the Chii relay currently sees attached, plus whether the cloudflared tunnel is up and the public wss relay URL the phone uses to 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. 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",
@@ -85,7 +226,8 @@ new Set([
 				}
 			},
 			required: ["scheme_url"]
-		}
+		},
+		availableIn: "relay"
 	},
 	{
 		name: "get_dom_document",
@@ -94,7 +236,8 @@ new Set([
 			type: "object",
 			properties: {},
 			required: []
-		}
+		},
+		availableIn: "both"
 	},
 	{
 		name: "take_snapshot",
@@ -103,7 +246,8 @@ new Set([
 			type: "object",
 			properties: {},
 			required: []
-		}
+		},
+		availableIn: "both"
 	},
 	{
 		name: "take_screenshot",
@@ -112,16 +256,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",
@@ -133,11 +279,25 @@ new Set([
 				description: "JavaScript expression to evaluate in the page context."
 			} },
 			required: ["expression"]
-		}
+		},
+		availableIn: "both"
+	},
+	{
+		name: "list_exceptions",
+		description: "Lists JS-level exceptions captured via `Runtime.exceptionThrown` from the relay attached page. Includes timestamp, exception text, source URL/line, and stack trace. Use to root-cause SDK throws that may precede a Toss app crash (#265 / #267). The buffer holds up to 50 most recent exceptions and survives target replaced/crashed/destroyed events so an exception just before a crash is preserved. Returns up to 50 most recent by default.",
+		inputSchema: {
+			type: "object",
+			properties: { limit: {
+				type: "number",
+				description: "Maximum number of exceptions to return (default 50, max 50)."
+			} },
+			required: []
+		},
+		availableIn: "both"
 	},
 	{
 		name: "call_sdk",
-		description: "Calls a dogfood SDK method via the window.__sdkCall bridge (exported by @apps-in-toss/web-framework only in __DEBUG_BUILD__ bundles). NOT read-only — SDK calls have side effects (navigation, payments, permissions, etc.). On env 2/3 (real device relay) this hits the real SDK; on env 1 (local mock) it hits the mock SDK. Requires the relay to be attached — call list_pages first. Returns {ok: true, value} on success or {ok: false, error} on failure. Returns a clear error if window.__sdkCall is not available (non-dogfood bundle).",
+		description: "Calls a dogfood SDK method via the window.__sdkCall bridge (exported by @apps-in-toss/web-framework only in __DEBUG_BUILD__ bundles). NOT read-only — SDK calls have side effects (navigation, payments, permissions, etc.). On env 2/3 (real device relay) this hits the real SDK; on env 1 (local mock) it hits the mock SDK. Requires the relay to be attached — call list_pages first. Returns {ok: true, value} on success or {ok: false, error} on failure. If a Runtime.exceptionThrown event was observed within [callStart-50ms, callEnd+200ms], the result also includes `recentException` for crash triage. Returns a clear error if window.__sdkCall is not available (non-dogfood bundle).\n\nIMPORTANT — 인자 시그니처 (잘못된 인자로 호출하면 토스 앱 crash 위험):\n  setDeviceOrientation:        call_sdk(\"setDeviceOrientation\", [{ type: \"landscape\" }])  // NOT \"landscape\"\n  setIosSwipeGestureEnabled:   call_sdk(\"setIosSwipeGestureEnabled\", [{ isEnabled: false }])\n  setSecureScreen:             call_sdk(\"setSecureScreen\", [{ enabled: true }])\n  setScreenAwakeMode:          call_sdk(\"setScreenAwakeMode\", [{ enabled: true }])\n  getOperationalEnvironment:   call_sdk(\"getOperationalEnvironment\", [])\n  getPlatformOS:               call_sdk(\"getPlatformOS\", [])\n  getDeviceId:                 call_sdk(\"getDeviceId\", [])\n  getLocale:                   call_sdk(\"getLocale\", [])\n  getNetworkStatus:            call_sdk(\"getNetworkStatus\", [])\n  getSchemeUri:                call_sdk(\"getSchemeUri\", [])\n  requestReview:               call_sdk(\"requestReview\", [])\n  closeView:                   call_sdk(\"closeView\", [])",
 		inputSchema: {
 			type: "object",
 			properties: {
@@ -152,7 +312,8 @@ new Set([
 				}
 			},
 			required: ["name"]
-		}
+		},
+		availableIn: "both"
 	},
 	{
 		name: "AIT.getSdkCallHistory",
@@ -161,7 +322,8 @@ new Set([
 			type: "object",
 			properties: {},
 			required: []
-		}
+		},
+		availableIn: "both"
 	},
 	{
 		name: "AIT.getMockState",
@@ -170,7 +332,8 @@ new Set([
 			type: "object",
 			properties: {},
 			required: []
-		}
+		},
+		availableIn: "both"
 	},
 	{
 		name: "AIT.getOperationalEnvironment",
@@ -179,7 +342,8 @@ new Set([
 			type: "object",
 			properties: {},
 			required: []
-		}
+		},
+		availableIn: "both"
 	}
 ].map((t) => t.name));
 `
@@ -200,17 +364,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);
@@ -227,6 +402,7 @@ new Set([
   var result = {
     cssEnv: cssEnv,
     sdkInsets: sdkInsets,
+    sdkInsetsSource: sdkInsetsSource,
     navBarHeight: navBarHeight,
     navBarHeightSource: navBarHeightSource,
     innerWidth: window.innerWidth,
@@ -297,7 +473,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",
@@ -306,7 +488,8 @@ const DEV_TOOL_DEFINITIONS = [
 			type: "object",
 			properties: {},
 			required: []
-		}
+		},
+		availableIn: "both"
 	},
 	{
 		name: "AIT.getOperationalEnvironment",
@@ -315,7 +498,8 @@ const DEV_TOOL_DEFINITIONS = [
 			type: "object",
 			properties: {},
 			required: []
-		}
+		},
+		availableIn: "both"
 	},
 	{
 		name: "AIT.getSdkCallHistory",
@@ -324,7 +508,8 @@ const DEV_TOOL_DEFINITIONS = [
 			type: "object",
 			properties: {},
 			required: []
-		}
+		},
+		availableIn: "both"
 	},
 	{
 		name: "devtools_get_mock_state",
@@ -333,7 +518,8 @@ const DEV_TOOL_DEFINITIONS = [
 			type: "object",
 			properties: {},
 			required: []
-		}
+		},
+		availableIn: "both"
 	}
 ];
 const DEV_TOOL_NAMES = new Set(DEV_TOOL_DEFINITIONS.map((t) => t.name));
@@ -343,7 +529,7 @@ function createDevServer(deps = {}) {
 	const aitSource = deps.aitSource ?? new HttpAitSource({ stateEndpoint });
 	const server = new Server({
 		name: "ait-devtools",
-		version: "0.1.40"
+		version: "0.1.43"
 	}, { capabilities: { tools: {} } });
 	server.setRequestHandler(ListToolsRequestSchema, () => ({ tools: DEV_TOOL_DEFINITIONS.map((tool) => ({ ...tool })) }));
 	server.setRequestHandler(CallToolRequestSchema, async (request) => {