skybridge 0.0.0-dev.feb36b5 → 0.0.0-dev.feb6875

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (313) hide show
  1. package/LICENSE +21 -674
  2. package/README.md +104 -77
  3. package/bin/run.js +5 -0
  4. package/dist/cli/detect-port.d.ts +18 -0
  5. package/dist/cli/detect-port.js +61 -0
  6. package/dist/cli/detect-port.js.map +1 -0
  7. package/dist/cli/header.d.ts +4 -0
  8. package/dist/cli/header.js +6 -0
  9. package/dist/cli/header.js.map +1 -0
  10. package/dist/cli/run-command.d.ts +2 -0
  11. package/dist/cli/run-command.js +43 -0
  12. package/dist/cli/run-command.js.map +1 -0
  13. package/dist/cli/telemetry.d.ts +7 -0
  14. package/dist/cli/telemetry.js +123 -0
  15. package/dist/cli/telemetry.js.map +1 -0
  16. package/dist/cli/types.d.ts +5 -0
  17. package/dist/cli/types.js +2 -0
  18. package/dist/cli/types.js.map +1 -0
  19. package/dist/cli/use-execute-steps.d.ts +11 -0
  20. package/dist/cli/use-execute-steps.js +36 -0
  21. package/dist/cli/use-execute-steps.js.map +1 -0
  22. package/dist/cli/use-nodemon.d.ts +2 -0
  23. package/dist/cli/use-nodemon.js +80 -0
  24. package/dist/cli/use-nodemon.js.map +1 -0
  25. package/dist/cli/use-tunnel.d.ts +8 -0
  26. package/dist/cli/use-tunnel.js +101 -0
  27. package/dist/cli/use-tunnel.js.map +1 -0
  28. package/dist/cli/use-typescript-check.d.ts +8 -0
  29. package/dist/cli/use-typescript-check.js +59 -0
  30. package/dist/cli/use-typescript-check.js.map +1 -0
  31. package/dist/commands/build.d.ts +9 -0
  32. package/dist/commands/build.js +46 -0
  33. package/dist/commands/build.js.map +1 -0
  34. package/dist/commands/dev.d.ts +10 -0
  35. package/dist/commands/dev.js +44 -0
  36. package/dist/commands/dev.js.map +1 -0
  37. package/dist/commands/start.d.ts +9 -0
  38. package/dist/commands/start.js +52 -0
  39. package/dist/commands/start.js.map +1 -0
  40. package/dist/commands/telemetry/disable.d.ts +5 -0
  41. package/dist/commands/telemetry/disable.js +14 -0
  42. package/dist/commands/telemetry/disable.js.map +1 -0
  43. package/dist/commands/telemetry/enable.d.ts +5 -0
  44. package/dist/commands/telemetry/enable.js +14 -0
  45. package/dist/commands/telemetry/enable.js.map +1 -0
  46. package/dist/commands/telemetry/status.d.ts +5 -0
  47. package/dist/commands/telemetry/status.js +14 -0
  48. package/dist/commands/telemetry/status.js.map +1 -0
  49. package/dist/server/asset-base-url-transform-plugin.d.ts +10 -0
  50. package/dist/server/asset-base-url-transform-plugin.js +33 -0
  51. package/dist/server/asset-base-url-transform-plugin.js.map +1 -0
  52. package/dist/server/asset-base-url-transform-plugin.test.js +55 -0
  53. package/dist/server/asset-base-url-transform-plugin.test.js.map +1 -0
  54. package/dist/server/express.d.ts +15 -0
  55. package/dist/server/express.js +77 -0
  56. package/dist/server/express.js.map +1 -0
  57. package/dist/server/express.test.js +252 -0
  58. package/dist/server/express.test.js.map +1 -0
  59. package/dist/server/index.d.ts +5 -0
  60. package/dist/server/index.js.map +1 -0
  61. package/dist/server/inferUtilityTypes.d.ts +64 -0
  62. package/dist/server/inferUtilityTypes.js +2 -0
  63. package/dist/server/inferUtilityTypes.js.map +1 -0
  64. package/dist/server/metric.d.ts +13 -0
  65. package/dist/server/metric.js +48 -0
  66. package/dist/server/metric.js.map +1 -0
  67. package/dist/server/middleware.d.ts +124 -0
  68. package/dist/server/middleware.js +93 -0
  69. package/dist/server/middleware.js.map +1 -0
  70. package/dist/server/middleware.test-d.d.ts +1 -0
  71. package/dist/server/middleware.test-d.js +75 -0
  72. package/dist/server/middleware.test-d.js.map +1 -0
  73. package/dist/server/middleware.test.d.ts +1 -0
  74. package/dist/server/middleware.test.js +490 -0
  75. package/dist/server/middleware.test.js.map +1 -0
  76. package/dist/server/server.d.ts +150 -0
  77. package/dist/server/server.js +292 -0
  78. package/dist/server/server.js.map +1 -0
  79. package/dist/{src/server → server}/templateHelper.d.ts +3 -0
  80. package/dist/{src/server → server}/templateHelper.js +5 -4
  81. package/dist/server/templateHelper.js.map +1 -0
  82. package/dist/server/templates/development.hbs +12 -0
  83. package/dist/{src/server → server}/templates/production.hbs +1 -1
  84. package/dist/{src/server → server}/widgetsDevServer.d.ts +3 -2
  85. package/dist/{src/server → server}/widgetsDevServer.js +20 -7
  86. package/dist/server/widgetsDevServer.js.map +1 -0
  87. package/dist/test/utils.d.ts +135 -0
  88. package/dist/test/utils.js +242 -0
  89. package/dist/test/utils.js.map +1 -0
  90. package/dist/test/widget.test.d.ts +1 -0
  91. package/dist/test/widget.test.js +263 -0
  92. package/dist/test/widget.test.js.map +1 -0
  93. package/dist/web/bridges/apps-sdk/adaptor.d.ts +22 -0
  94. package/dist/web/bridges/apps-sdk/adaptor.js +75 -0
  95. package/dist/web/bridges/apps-sdk/adaptor.js.map +1 -0
  96. package/dist/web/bridges/apps-sdk/bridge.d.ts +10 -0
  97. package/dist/web/bridges/apps-sdk/bridge.js +46 -0
  98. package/dist/web/bridges/apps-sdk/bridge.js.map +1 -0
  99. package/dist/web/bridges/apps-sdk/index.d.ts +5 -0
  100. package/dist/web/bridges/apps-sdk/index.js +5 -0
  101. package/dist/web/bridges/apps-sdk/index.js.map +1 -0
  102. package/dist/web/bridges/apps-sdk/types.d.ts +121 -0
  103. package/dist/web/bridges/apps-sdk/types.js.map +1 -0
  104. package/dist/web/bridges/apps-sdk/use-apps-sdk-context.d.ts +2 -0
  105. package/dist/web/bridges/apps-sdk/use-apps-sdk-context.js +7 -0
  106. package/dist/web/bridges/apps-sdk/use-apps-sdk-context.js.map +1 -0
  107. package/dist/web/bridges/get-adaptor.d.ts +2 -0
  108. package/dist/web/bridges/get-adaptor.js +8 -0
  109. package/dist/web/bridges/get-adaptor.js.map +1 -0
  110. package/dist/web/bridges/index.d.ts +5 -0
  111. package/dist/web/bridges/index.js +6 -0
  112. package/dist/web/bridges/index.js.map +1 -0
  113. package/dist/web/bridges/mcp-app/adaptor.d.ts +38 -0
  114. package/dist/web/bridges/mcp-app/adaptor.js +184 -0
  115. package/dist/web/bridges/mcp-app/adaptor.js.map +1 -0
  116. package/dist/web/bridges/mcp-app/bridge.d.ts +26 -0
  117. package/dist/web/bridges/mcp-app/bridge.js +102 -0
  118. package/dist/web/bridges/mcp-app/bridge.js.map +1 -0
  119. package/dist/web/bridges/mcp-app/index.d.ts +4 -0
  120. package/dist/web/bridges/mcp-app/index.js +4 -0
  121. package/dist/web/bridges/mcp-app/index.js.map +1 -0
  122. package/dist/web/bridges/mcp-app/types.d.ts +8 -0
  123. package/dist/web/bridges/mcp-app/types.js +2 -0
  124. package/dist/web/bridges/mcp-app/types.js.map +1 -0
  125. package/dist/web/bridges/mcp-app/use-mcp-app-context.d.ts +7 -0
  126. package/dist/web/bridges/mcp-app/use-mcp-app-context.js +7 -0
  127. package/dist/web/bridges/mcp-app/use-mcp-app-context.js.map +1 -0
  128. package/dist/web/bridges/mcp-app/use-mcp-app-context.test.d.ts +1 -0
  129. package/dist/web/bridges/mcp-app/use-mcp-app-context.test.js +26 -0
  130. package/dist/web/bridges/mcp-app/use-mcp-app-context.test.js.map +1 -0
  131. package/dist/web/bridges/types.d.ts +103 -0
  132. package/dist/web/bridges/types.js +2 -0
  133. package/dist/web/bridges/types.js.map +1 -0
  134. package/dist/web/bridges/use-host-context.d.ts +2 -0
  135. package/dist/web/bridges/use-host-context.js +8 -0
  136. package/dist/web/bridges/use-host-context.js.map +1 -0
  137. package/dist/web/components/modal-provider.d.ts +4 -0
  138. package/dist/web/components/modal-provider.js +45 -0
  139. package/dist/web/components/modal-provider.js.map +1 -0
  140. package/dist/web/create-store.d.ts +3 -0
  141. package/dist/web/create-store.js +24 -0
  142. package/dist/web/create-store.js.map +1 -0
  143. package/dist/web/create-store.test.d.ts +1 -0
  144. package/dist/web/create-store.test.js +131 -0
  145. package/dist/web/create-store.test.js.map +1 -0
  146. package/dist/web/data-llm.d.ts +14 -0
  147. package/dist/web/data-llm.js +72 -0
  148. package/dist/web/data-llm.js.map +1 -0
  149. package/dist/web/data-llm.test.d.ts +1 -0
  150. package/dist/web/data-llm.test.js +142 -0
  151. package/dist/web/data-llm.test.js.map +1 -0
  152. package/dist/web/generate-helpers.d.ts +116 -0
  153. package/dist/web/generate-helpers.js +111 -0
  154. package/dist/web/generate-helpers.js.map +1 -0
  155. package/dist/web/generate-helpers.test-d.d.ts +1 -0
  156. package/dist/web/generate-helpers.test-d.js +209 -0
  157. package/dist/web/generate-helpers.test-d.js.map +1 -0
  158. package/dist/web/generate-helpers.test.d.ts +1 -0
  159. package/dist/web/generate-helpers.test.js +17 -0
  160. package/dist/web/generate-helpers.test.js.map +1 -0
  161. package/dist/web/helpers/state.d.ts +7 -0
  162. package/dist/web/helpers/state.js +45 -0
  163. package/dist/web/helpers/state.js.map +1 -0
  164. package/dist/web/helpers/state.test.d.ts +1 -0
  165. package/dist/web/helpers/state.test.js +53 -0
  166. package/dist/web/helpers/state.test.js.map +1 -0
  167. package/dist/web/hooks/index.d.ts +11 -0
  168. package/dist/web/hooks/index.js +12 -0
  169. package/dist/web/hooks/index.js.map +1 -0
  170. package/dist/web/hooks/test/utils.d.ts +16 -0
  171. package/dist/web/hooks/test/utils.js +64 -0
  172. package/dist/web/hooks/test/utils.js.map +1 -0
  173. package/dist/web/hooks/use-call-tool.d.ts +101 -0
  174. package/dist/web/hooks/use-call-tool.js +68 -0
  175. package/dist/web/hooks/use-call-tool.js.map +1 -0
  176. package/dist/web/hooks/use-call-tool.test-d.d.ts +1 -0
  177. package/dist/web/hooks/use-call-tool.test-d.js +104 -0
  178. package/dist/web/hooks/use-call-tool.test-d.js.map +1 -0
  179. package/dist/web/hooks/use-call-tool.test.d.ts +1 -0
  180. package/dist/web/hooks/use-call-tool.test.js +190 -0
  181. package/dist/web/hooks/use-call-tool.test.js.map +1 -0
  182. package/dist/web/hooks/use-display-mode.d.ts +4 -0
  183. package/dist/web/hooks/use-display-mode.js +9 -0
  184. package/dist/web/hooks/use-display-mode.js.map +1 -0
  185. package/dist/web/hooks/use-display-mode.test-d.d.ts +1 -0
  186. package/dist/web/hooks/use-display-mode.test-d.js +8 -0
  187. package/dist/web/hooks/use-display-mode.test-d.js.map +1 -0
  188. package/dist/web/hooks/use-display-mode.test.d.ts +1 -0
  189. package/dist/web/hooks/use-display-mode.test.js +41 -0
  190. package/dist/web/hooks/use-display-mode.test.js.map +1 -0
  191. package/dist/web/hooks/use-files.d.ts +6 -0
  192. package/dist/web/hooks/use-files.js +9 -0
  193. package/dist/web/hooks/use-files.js.map +1 -0
  194. package/dist/web/hooks/use-files.test.d.ts +1 -0
  195. package/dist/web/hooks/use-files.test.js +34 -0
  196. package/dist/web/hooks/use-files.test.js.map +1 -0
  197. package/dist/web/hooks/use-layout.d.ts +22 -0
  198. package/dist/web/hooks/use-layout.js +23 -0
  199. package/dist/web/hooks/use-layout.js.map +1 -0
  200. package/dist/web/hooks/use-layout.test.d.ts +1 -0
  201. package/dist/web/hooks/use-layout.test.js +96 -0
  202. package/dist/web/hooks/use-layout.test.js.map +1 -0
  203. package/dist/web/hooks/use-open-external.d.ts +3 -0
  204. package/dist/web/hooks/use-open-external.js +8 -0
  205. package/dist/web/hooks/use-open-external.js.map +1 -0
  206. package/dist/web/hooks/use-open-external.test.d.ts +1 -0
  207. package/dist/web/hooks/use-open-external.test.js +65 -0
  208. package/dist/web/hooks/use-open-external.test.js.map +1 -0
  209. package/dist/web/hooks/use-request-modal.d.ts +9 -0
  210. package/dist/web/hooks/use-request-modal.js +16 -0
  211. package/dist/web/hooks/use-request-modal.js.map +1 -0
  212. package/dist/web/hooks/use-request-modal.test.d.ts +1 -0
  213. package/dist/web/hooks/use-request-modal.test.js +61 -0
  214. package/dist/web/hooks/use-request-modal.test.js.map +1 -0
  215. package/dist/web/hooks/use-send-follow-up-message.d.ts +1 -0
  216. package/dist/web/hooks/use-send-follow-up-message.js +8 -0
  217. package/dist/web/hooks/use-send-follow-up-message.js.map +1 -0
  218. package/dist/web/hooks/use-set-open-in-app-url.d.ts +1 -0
  219. package/dist/web/hooks/use-set-open-in-app-url.js +8 -0
  220. package/dist/web/hooks/use-set-open-in-app-url.js.map +1 -0
  221. package/dist/web/hooks/use-set-open-in-app-url.test.d.ts +1 -0
  222. package/dist/web/hooks/use-set-open-in-app-url.test.js +43 -0
  223. package/dist/web/hooks/use-set-open-in-app-url.test.js.map +1 -0
  224. package/dist/web/hooks/use-tool-info.d.ts +36 -0
  225. package/dist/web/hooks/use-tool-info.js +26 -0
  226. package/dist/web/hooks/use-tool-info.js.map +1 -0
  227. package/dist/web/hooks/use-tool-info.test-d.d.ts +1 -0
  228. package/dist/web/hooks/use-tool-info.test-d.js +109 -0
  229. package/dist/web/hooks/use-tool-info.test-d.js.map +1 -0
  230. package/dist/web/hooks/use-tool-info.test.d.ts +1 -0
  231. package/dist/web/hooks/use-tool-info.test.js +130 -0
  232. package/dist/web/hooks/use-tool-info.test.js.map +1 -0
  233. package/dist/web/hooks/use-user.d.ts +18 -0
  234. package/dist/web/hooks/use-user.js +35 -0
  235. package/dist/web/hooks/use-user.js.map +1 -0
  236. package/dist/web/hooks/use-user.test.d.ts +1 -0
  237. package/dist/web/hooks/use-user.test.js +122 -0
  238. package/dist/web/hooks/use-user.test.js.map +1 -0
  239. package/dist/web/hooks/use-widget-state.d.ts +4 -0
  240. package/dist/web/hooks/use-widget-state.js +32 -0
  241. package/dist/web/hooks/use-widget-state.js.map +1 -0
  242. package/dist/web/hooks/use-widget-state.test.d.ts +1 -0
  243. package/dist/web/hooks/use-widget-state.test.js +64 -0
  244. package/dist/web/hooks/use-widget-state.test.js.map +1 -0
  245. package/dist/web/index.d.ts +8 -0
  246. package/dist/web/index.js +9 -0
  247. package/dist/web/index.js.map +1 -0
  248. package/dist/web/mount-widget.js +27 -0
  249. package/dist/web/mount-widget.js.map +1 -0
  250. package/dist/web/plugin/data-llm.test.d.ts +1 -0
  251. package/dist/web/plugin/data-llm.test.js +81 -0
  252. package/dist/web/plugin/data-llm.test.js.map +1 -0
  253. package/dist/web/plugin/plugin.js +54 -0
  254. package/dist/web/plugin/plugin.js.map +1 -0
  255. package/dist/web/plugin/transform-data-llm.d.ts +12 -0
  256. package/dist/web/plugin/transform-data-llm.js +96 -0
  257. package/dist/web/plugin/transform-data-llm.js.map +1 -0
  258. package/dist/web/plugin/transform-data-llm.test.d.ts +1 -0
  259. package/dist/web/plugin/transform-data-llm.test.js +81 -0
  260. package/dist/web/plugin/transform-data-llm.test.js.map +1 -0
  261. package/dist/web/plugin/validate-widget.d.ts +5 -0
  262. package/dist/web/plugin/validate-widget.js +27 -0
  263. package/dist/web/plugin/validate-widget.js.map +1 -0
  264. package/dist/web/plugin/validate-widget.test.d.ts +1 -0
  265. package/dist/web/plugin/validate-widget.test.js +42 -0
  266. package/dist/web/plugin/validate-widget.test.js.map +1 -0
  267. package/dist/web/proxy.d.ts +1 -0
  268. package/dist/web/proxy.js +52 -0
  269. package/dist/web/proxy.js.map +1 -0
  270. package/dist/web/types.d.ts +16 -0
  271. package/dist/web/types.js +2 -0
  272. package/dist/web/types.js.map +1 -0
  273. package/package.json +73 -30
  274. package/tsconfig.base.json +31 -0
  275. package/dist/src/server/index.d.ts +0 -2
  276. package/dist/src/server/index.js.map +0 -1
  277. package/dist/src/server/server.d.ts +0 -13
  278. package/dist/src/server/server.js +0 -54
  279. package/dist/src/server/server.js.map +0 -1
  280. package/dist/src/server/templateHelper.js.map +0 -1
  281. package/dist/src/server/templates/development.hbs +0 -12
  282. package/dist/src/server/widgetsDevServer.js.map +0 -1
  283. package/dist/src/test/setup.js +0 -9
  284. package/dist/src/test/setup.js.map +0 -1
  285. package/dist/src/test/utils.d.ts +0 -28
  286. package/dist/src/test/utils.js +0 -43
  287. package/dist/src/test/utils.js.map +0 -1
  288. package/dist/src/test/widget.test.js +0 -76
  289. package/dist/src/test/widget.test.js.map +0 -1
  290. package/dist/src/web/index.d.ts +0 -5
  291. package/dist/src/web/index.js +0 -6
  292. package/dist/src/web/index.js.map +0 -1
  293. package/dist/src/web/mount-widget.js +0 -14
  294. package/dist/src/web/mount-widget.js.map +0 -1
  295. package/dist/src/web/plugin.js +0 -28
  296. package/dist/src/web/plugin.js.map +0 -1
  297. package/dist/src/web/types.d.ts +0 -95
  298. package/dist/src/web/types.js.map +0 -1
  299. package/dist/src/web/use-openai-global.d.ts +0 -2
  300. package/dist/src/web/use-openai-global.js +0 -21
  301. package/dist/src/web/use-openai-global.js.map +0 -1
  302. package/dist/src/web/use-tool-output.d.ts +0 -3
  303. package/dist/src/web/use-tool-output.js +0 -5
  304. package/dist/src/web/use-tool-output.js.map +0 -1
  305. package/dist/vitest.config.d.ts +0 -2
  306. package/dist/vitest.config.js +0 -9
  307. package/dist/vitest.config.js.map +0 -1
  308. /package/dist/{src/test/setup.d.ts → server/asset-base-url-transform-plugin.test.d.ts} +0 -0
  309. /package/dist/{src/test/widget.test.d.ts → server/express.test.d.ts} +0 -0
  310. /package/dist/{src/server → server}/index.js +0 -0
  311. /package/dist/{src/web → web/bridges/apps-sdk}/types.js +0 -0
  312. /package/dist/{src/web → web}/mount-widget.d.ts +0 -0
  313. /package/dist/{src/web → web/plugin}/plugin.d.ts +0 -0
@@ -0,0 +1,135 @@
1
+ import { type MockInstance } from "vitest";
2
+ import { McpServer } from "../server/server.js";
3
+ /**
4
+ * Creates a real McpServer instance for testing
5
+ */
6
+ export declare function createMockMcpServer(): {
7
+ server: McpServer;
8
+ mockRegisterResource: MockInstance<McpServer["registerResource"]>;
9
+ mockRegisterTool: MockInstance<McpServer["registerTool"]>;
10
+ };
11
+ export declare function createTestServer(): McpServer<Record<never, import("../server/server.js").ToolDef<unknown, unknown, unknown>> & {
12
+ "search-voyage": import("../server/server.js").ToolDef<{
13
+ destination: string;
14
+ departureDate?: string | undefined;
15
+ maxPrice?: number | undefined;
16
+ }, {
17
+ results: {
18
+ id: string;
19
+ name: string;
20
+ price: number;
21
+ }[];
22
+ totalCount: number;
23
+ }, unknown>;
24
+ } & {
25
+ "get-trip-details": import("../server/server.js").ToolDef<{
26
+ tripId: string;
27
+ }, {
28
+ name: string;
29
+ description: string;
30
+ images: string[];
31
+ }, unknown>;
32
+ } & {
33
+ "no-input-widget": import("../server/server.js").ToolDef<{}, {}, unknown>;
34
+ } & {
35
+ "inferred-output-widget": import("../server/server.js").ToolDef<{
36
+ query: string;
37
+ }, {
38
+ inferredResults: {
39
+ id: string;
40
+ score: number;
41
+ }[];
42
+ inferredCount: number;
43
+ }, unknown>;
44
+ } & {
45
+ "calculate-price": import("../server/server.js").ToolDef<{
46
+ tripId: string;
47
+ passengers: number;
48
+ }, {
49
+ totalPrice: number;
50
+ currency: string;
51
+ }, unknown>;
52
+ } & {
53
+ "inferred-tool": import("../server/server.js").ToolDef<{
54
+ itemId: string;
55
+ }, {
56
+ itemDetails: {
57
+ name: string;
58
+ available: boolean;
59
+ };
60
+ fetchedAt: string;
61
+ }, unknown>;
62
+ } & {
63
+ "widget-with-metadata": import("../server/server.js").ToolDef<{
64
+ resourceId: string;
65
+ }, {
66
+ data: {
67
+ id: string;
68
+ loaded: boolean;
69
+ };
70
+ }, {
71
+ requestId: string;
72
+ timestamp: number;
73
+ cached: boolean;
74
+ }>;
75
+ } & {
76
+ "tool-with-metadata": import("../server/server.js").ToolDef<{
77
+ query: string;
78
+ }, {
79
+ results: string[];
80
+ }, {
81
+ executionTime: number;
82
+ source: string;
83
+ }>;
84
+ } & {
85
+ "widget-with-mixed-returns": import("../server/server.js").ToolDef<{
86
+ shouldSucceed: boolean;
87
+ }, {
88
+ error: string;
89
+ data?: undefined;
90
+ } | {
91
+ data: string;
92
+ error?: undefined;
93
+ }, {
94
+ processedAt: number;
95
+ region: string;
96
+ }>;
97
+ }>;
98
+ export declare function createMinimalTestServer(): McpServer<Record<never, import("../server/server.js").ToolDef<unknown, unknown, unknown>> & {
99
+ "search-voyage": import("../server/server.js").ToolDef<{
100
+ destination: string;
101
+ }, {
102
+ results: {
103
+ id: string;
104
+ }[];
105
+ }, unknown>;
106
+ }>;
107
+ export declare function createInterfaceTestServer(): McpServer<Record<never, import("../server/server.js").ToolDef<unknown, unknown, unknown>> & {
108
+ "interface-widget": import("../server/server.js").ToolDef<{
109
+ id: string;
110
+ }, {
111
+ itemName: string;
112
+ quantity: number;
113
+ }, {
114
+ processedBy: string;
115
+ version: number;
116
+ }>;
117
+ }>;
118
+ /**
119
+ * Mock extra parameter for resource callback
120
+ */
121
+ export declare function createMockExtra(host: string): {
122
+ requestInfo: {
123
+ headers: {
124
+ host: string;
125
+ };
126
+ };
127
+ };
128
+ /**
129
+ * Sets up environment variables for testing
130
+ */
131
+ export declare function setTestEnv(env: Record<string, string>): void;
132
+ /**
133
+ * Resets environment variables
134
+ */
135
+ export declare function resetTestEnv(): void;
@@ -0,0 +1,242 @@
1
+ import { vi } from "vitest";
2
+ import * as z from "zod";
3
+ import { McpServer } from "../server/server.js";
4
+ /**
5
+ * Creates a real McpServer instance for testing
6
+ */
7
+ export function createMockMcpServer() {
8
+ // Create a real McpServer instance
9
+ const server = new McpServer({
10
+ name: "alpic-openai-app",
11
+ version: "0.0.1",
12
+ }, { capabilities: {} });
13
+ // Mock the underlying methods to track calls
14
+ const mockRegisterResource = vi.spyOn(server, "registerResource");
15
+ const mockRegisterTool = vi.spyOn(server, "registerTool");
16
+ return {
17
+ server,
18
+ mockRegisterResource,
19
+ mockRegisterTool,
20
+ };
21
+ }
22
+ export function createTestServer() {
23
+ return new McpServer({ name: "test-app", version: "1.0.0" }, {})
24
+ .registerWidget("search-voyage", {}, {
25
+ description: "Search for voyages",
26
+ inputSchema: {
27
+ destination: z.string(),
28
+ departureDate: z.string().optional(),
29
+ maxPrice: z.number().optional(),
30
+ },
31
+ outputSchema: {
32
+ results: z.array(z.object({
33
+ id: z.string(),
34
+ name: z.string(),
35
+ price: z.number(),
36
+ })),
37
+ totalCount: z.number(),
38
+ },
39
+ }, async ({ destination }) => {
40
+ return {
41
+ content: [{ type: "text", text: `Found trips to ${destination}` }],
42
+ structuredContent: {
43
+ results: [{ id: "1", name: "Trip", price: 1000 }],
44
+ totalCount: 1,
45
+ },
46
+ };
47
+ })
48
+ .registerWidget("get-trip-details", {}, {
49
+ description: "Get trip details",
50
+ inputSchema: {
51
+ tripId: z.string(),
52
+ },
53
+ outputSchema: {
54
+ name: z.string(),
55
+ description: z.string(),
56
+ images: z.array(z.string()),
57
+ },
58
+ }, async ({ tripId }) => {
59
+ return {
60
+ content: [{ type: "text", text: `Details for ${tripId}` }],
61
+ structuredContent: {
62
+ name: "Trip",
63
+ description: "A great trip",
64
+ images: ["image1.jpg"],
65
+ },
66
+ };
67
+ })
68
+ .registerWidget("no-input-widget", {}, {
69
+ description: "Widget with no input",
70
+ inputSchema: {},
71
+ outputSchema: {},
72
+ }, async () => {
73
+ return {
74
+ content: [{ type: "text", text: "No input needed" }],
75
+ structuredContent: {},
76
+ };
77
+ })
78
+ .registerWidget("inferred-output-widget", {}, {
79
+ description: "Widget with output inferred from callback",
80
+ inputSchema: {
81
+ query: z.string(),
82
+ },
83
+ }, async ({ query }) => {
84
+ return {
85
+ content: [{ type: "text", text: `Query: ${query}` }],
86
+ structuredContent: {
87
+ inferredResults: [{ id: "inferred-1", score: 0.95 }],
88
+ inferredCount: 1,
89
+ },
90
+ };
91
+ })
92
+ .registerTool("calculate-price", {
93
+ description: "Calculate trip price",
94
+ inputSchema: {
95
+ tripId: z.string(),
96
+ passengers: z.number(),
97
+ },
98
+ outputSchema: {
99
+ totalPrice: z.number(),
100
+ currency: z.string(),
101
+ },
102
+ }, async ({ tripId, passengers }) => {
103
+ return {
104
+ content: [{ type: "text", text: `Price for ${tripId}` }],
105
+ structuredContent: {
106
+ totalPrice: 1000 * passengers,
107
+ currency: "USD",
108
+ },
109
+ };
110
+ })
111
+ .registerTool("inferred-tool", {
112
+ description: "Tool with output inferred from callback",
113
+ inputSchema: {
114
+ itemId: z.string(),
115
+ },
116
+ }, async ({ itemId }) => {
117
+ return {
118
+ content: [{ type: "text", text: `Item: ${itemId}` }],
119
+ structuredContent: {
120
+ itemDetails: { name: "Inferred Item", available: true },
121
+ fetchedAt: "2024-01-01",
122
+ },
123
+ };
124
+ })
125
+ .registerWidget("widget-with-metadata", {}, {
126
+ description: "Widget that returns response metadata",
127
+ inputSchema: {
128
+ resourceId: z.string(),
129
+ },
130
+ }, async ({ resourceId }) => {
131
+ return {
132
+ content: [{ type: "text", text: `Resource: ${resourceId}` }],
133
+ structuredContent: {
134
+ data: { id: resourceId, loaded: true },
135
+ },
136
+ _meta: {
137
+ requestId: "req-123",
138
+ timestamp: 1704067200000,
139
+ cached: false,
140
+ },
141
+ };
142
+ })
143
+ .registerTool("tool-with-metadata", {
144
+ description: "Tool that returns response metadata",
145
+ inputSchema: {
146
+ query: z.string(),
147
+ },
148
+ }, async ({ query }) => {
149
+ return {
150
+ content: [{ type: "text", text: `Query: ${query}` }],
151
+ structuredContent: {
152
+ results: [query],
153
+ },
154
+ _meta: {
155
+ executionTime: 150,
156
+ source: "cache",
157
+ },
158
+ };
159
+ })
160
+ .registerWidget("widget-with-mixed-returns", {}, {
161
+ description: "Widget with mixed return paths (some with _meta, some without)",
162
+ inputSchema: {
163
+ shouldSucceed: z.boolean(),
164
+ },
165
+ }, async ({ shouldSucceed }) => {
166
+ if (!shouldSucceed) {
167
+ // Error path - no _meta
168
+ return {
169
+ content: [{ type: "text", text: "Error occurred" }],
170
+ structuredContent: { error: "Something went wrong" },
171
+ };
172
+ }
173
+ // Success path - has _meta
174
+ return {
175
+ content: [{ type: "text", text: "Success" }],
176
+ structuredContent: { data: "result" },
177
+ _meta: {
178
+ processedAt: 1704067200000,
179
+ region: "eu-west-1",
180
+ },
181
+ };
182
+ });
183
+ }
184
+ export function createMinimalTestServer() {
185
+ return new McpServer({ name: "test-app", version: "1.0.0" }, {}).registerWidget("search-voyage", {}, {
186
+ description: "Search for voyages",
187
+ inputSchema: {
188
+ destination: z.string(),
189
+ },
190
+ outputSchema: {
191
+ results: z.array(z.object({ id: z.string() })),
192
+ },
193
+ }, async ({ destination }) => {
194
+ return {
195
+ content: [{ type: "text", text: `Found trips to ${destination}` }],
196
+ structuredContent: { results: [{ id: "1" }] },
197
+ };
198
+ });
199
+ }
200
+ export function createInterfaceTestServer() {
201
+ return new McpServer({ name: "interface-test-app", version: "1.0.0" }, {}).registerWidget("interface-widget", {}, {
202
+ description: "Widget with interface-typed output",
203
+ inputSchema: {
204
+ id: z.string(),
205
+ },
206
+ }, async ({ id }) => {
207
+ return {
208
+ content: [{ type: "text", text: `Item ${id}` }],
209
+ structuredContent: {
210
+ itemName: "Test Item",
211
+ quantity: 42,
212
+ },
213
+ _meta: {
214
+ processedBy: "test",
215
+ version: 1,
216
+ },
217
+ };
218
+ });
219
+ }
220
+ /**
221
+ * Mock extra parameter for resource callback
222
+ */
223
+ export function createMockExtra(host) {
224
+ return {
225
+ requestInfo: {
226
+ headers: { host },
227
+ },
228
+ };
229
+ }
230
+ /**
231
+ * Sets up environment variables for testing
232
+ */
233
+ export function setTestEnv(env) {
234
+ Object.assign(process.env, env);
235
+ }
236
+ /**
237
+ * Resets environment variables
238
+ */
239
+ export function resetTestEnv() {
240
+ delete process.env.NODE_ENV;
241
+ }
242
+ //# sourceMappingURL=utils.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/test/utils.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,263 @@
1
+ import { afterEach, beforeEach, describe, expect, it, vi, } from "vitest";
2
+ import { createMockExtra, createMockMcpServer, resetTestEnv, setTestEnv, } from "./utils.js";
3
+ const mockManifest = {
4
+ "src/widgets/my-widget.tsx": { file: "my-widget.js" },
5
+ "src/widgets/folder-widget/index.tsx": { file: "folder-widget.js" },
6
+ "style.css": { file: "style.css" },
7
+ };
8
+ const actual = vi.hoisted(() => require("node:fs"));
9
+ vi.mock("node:fs", () => {
10
+ const readFileSyncImpl = (path, ...args) => {
11
+ if (typeof path === "string" && path.includes("manifest.json")) {
12
+ return JSON.stringify(mockManifest);
13
+ }
14
+ return actual.readFileSync(path, ...args);
15
+ };
16
+ const readFileSync = vi.fn(readFileSyncImpl);
17
+ return {
18
+ readFileSync,
19
+ default: {
20
+ readFileSync,
21
+ },
22
+ };
23
+ });
24
+ describe("McpServer.registerWidget", () => {
25
+ let server;
26
+ let mockRegisterResource;
27
+ let mockRegisterTool;
28
+ beforeEach(() => {
29
+ ({ server, mockRegisterResource, mockRegisterTool } =
30
+ createMockMcpServer());
31
+ });
32
+ afterEach(() => {
33
+ vi.clearAllMocks();
34
+ resetTestEnv();
35
+ });
36
+ it("should generate correct HTML for development mode", async () => {
37
+ setTestEnv({ NODE_ENV: "development" });
38
+ const mockToolCallback = vi.fn();
39
+ const mockRegisterResourceConfig = { description: "Test widget" };
40
+ const mockToolConfig = { description: "Test tool" };
41
+ server.registerWidget("my-widget", mockRegisterResourceConfig, mockToolConfig, mockToolCallback);
42
+ // Get the resource callback function
43
+ const appsSdkResourceCallback = mockRegisterResource.mock
44
+ .calls[0]?.[3];
45
+ expect(appsSdkResourceCallback).toBeDefined();
46
+ const host = "localhost:3000";
47
+ const serverUrl = `http://${host}`;
48
+ const hmrUrl = `ws://${host}`;
49
+ const mockExtra = createMockExtra(host);
50
+ const result = await appsSdkResourceCallback(new URL("ui://widgets/apps-sdk/my-widget.html"), mockExtra);
51
+ expect(mockRegisterTool).toHaveBeenCalled();
52
+ expect(result).toEqual({
53
+ contents: [
54
+ {
55
+ uri: "ui://widgets/apps-sdk/my-widget.html",
56
+ mimeType: "text/html+skybridge",
57
+ text: expect.stringContaining('<div id="root"></div>'),
58
+ _meta: {
59
+ "openai/widgetCSP": {
60
+ resource_domains: [serverUrl],
61
+ connect_domains: [serverUrl, hmrUrl],
62
+ },
63
+ "openai/widgetDomain": serverUrl,
64
+ "openai/widgetDescription": "Test widget",
65
+ },
66
+ },
67
+ ],
68
+ });
69
+ // Check development-specific content
70
+ expect(result.contents[0]?.text).toContain(`${serverUrl}/assets/@react-refresh`);
71
+ expect(result.contents[0]?.text).toContain(`${serverUrl}/@vite/client`);
72
+ expect(result.contents[0]?.text).toContain(`${serverUrl}/src/widgets/my-widget`);
73
+ expect(result.contents[0]?.text).not.toContain(`${serverUrl}/src/widgets/my-widget.tsx`);
74
+ });
75
+ it("should generate correct HTML for production mode", async () => {
76
+ setTestEnv({ NODE_ENV: "production" });
77
+ const mockToolCallback = vi.fn();
78
+ const mockRegisterResourceConfig = { description: "Test widget" };
79
+ const mockToolConfig = { description: "Test tool" };
80
+ server.registerWidget("my-widget", mockRegisterResourceConfig, mockToolConfig, mockToolCallback);
81
+ // Get the resource callback function
82
+ const appsSdkResourceCallback = mockRegisterResource.mock
83
+ .calls[0]?.[3];
84
+ expect(appsSdkResourceCallback).toBeDefined();
85
+ const host = "myapp.com";
86
+ const serverUrl = `https://${host}`;
87
+ const mockExtra = createMockExtra(host);
88
+ const result = await appsSdkResourceCallback(new URL("ui://widgets/apps-sdk/my-widget.html"), mockExtra);
89
+ expect(result).toEqual({
90
+ contents: [
91
+ {
92
+ uri: "ui://widgets/apps-sdk/my-widget.html",
93
+ mimeType: "text/html+skybridge",
94
+ text: expect.stringContaining('<div id="root"></div>'),
95
+ _meta: {
96
+ "openai/widgetCSP": {
97
+ resource_domains: [serverUrl],
98
+ connect_domains: [serverUrl],
99
+ },
100
+ "openai/widgetDomain": serverUrl,
101
+ "openai/widgetDescription": "Test widget",
102
+ },
103
+ },
104
+ ],
105
+ });
106
+ // Check production-specific content
107
+ expect(result.contents[0]?.text).not.toContain(`${serverUrl}/assets/@react-refresh`);
108
+ expect(result.contents[0]?.text).not.toContain(`${serverUrl}@vite/client`);
109
+ expect(result.contents[0]?.text).toContain(`${serverUrl}/assets/my-widget.js`);
110
+ expect(result.contents[0]?.text).toContain(`${serverUrl}/assets/style.css`);
111
+ });
112
+ it("should resolve folder-based widgets (barrel files) in production mode", async () => {
113
+ setTestEnv({ NODE_ENV: "production" });
114
+ const mockToolCallback = vi.fn();
115
+ const mockRegisterResourceConfig = { description: "Folder widget" };
116
+ const mockToolConfig = { description: "Folder tool" };
117
+ server.registerWidget("folder-widget", mockRegisterResourceConfig, mockToolConfig, mockToolCallback);
118
+ const appsSdkResourceCallback = mockRegisterResource.mock
119
+ .calls[0]?.[3];
120
+ expect(appsSdkResourceCallback).toBeDefined();
121
+ const host = "myapp.com";
122
+ const serverUrl = `https://${host}`;
123
+ const mockExtra = createMockExtra(host);
124
+ const result = await appsSdkResourceCallback(new URL("ui://widgets/apps-sdk/folder-widget.html"), mockExtra);
125
+ // Should resolve to folder-widget.js from the manifest entry "src/widgets/folder-widget/index.tsx"
126
+ expect(result.contents[0]?.text).toContain(`${serverUrl}/assets/folder-widget.js`);
127
+ });
128
+ it("should register resources with correct hostType for both apps-sdk and ext-apps formats", async () => {
129
+ const mockToolCallback = vi.fn();
130
+ const mockRegisterResourceConfig = {
131
+ description: "Test widget",
132
+ _meta: { "openai/widgetPrefersBorder": true },
133
+ };
134
+ const mockToolConfig = { description: "Test tool" };
135
+ server.registerWidget("my-widget", mockRegisterResourceConfig, mockToolConfig, mockToolCallback);
136
+ expect(mockRegisterResource).toHaveBeenCalledTimes(2);
137
+ const appsSdkCallback = mockRegisterResource.mock
138
+ .calls[0]?.[3];
139
+ const appsSdkResult = await appsSdkCallback(new URL("ui://widgets/apps-sdk/my-widget.html"), createMockExtra("localhost:3000"));
140
+ const host = "localhost:3000";
141
+ const serverUrl = `http://${host}`;
142
+ const hmrUrl = `ws://${host}`;
143
+ expect(appsSdkResult).toEqual({
144
+ contents: [
145
+ {
146
+ uri: "ui://widgets/apps-sdk/my-widget.html",
147
+ mimeType: "text/html+skybridge",
148
+ text: expect.stringContaining('<div id="root"></div>'),
149
+ _meta: {
150
+ "openai/widgetCSP": {
151
+ resource_domains: [serverUrl],
152
+ connect_domains: [serverUrl, hmrUrl],
153
+ },
154
+ "openai/widgetDomain": serverUrl,
155
+ "openai/widgetDescription": "Test widget",
156
+ "openai/widgetPrefersBorder": true,
157
+ },
158
+ },
159
+ ],
160
+ });
161
+ expect(appsSdkResult.contents[0]?.text).toContain('window.skybridge = { hostType: "apps-sdk", serverUrl: "http://localhost:3000" };');
162
+ const extAppsResourceCallback = mockRegisterResource.mock
163
+ .calls[1]?.[3];
164
+ expect(extAppsResourceCallback).toBeDefined();
165
+ const extAppsResult = await extAppsResourceCallback(new URL("ui://widgets/ext-apps/my-widget.html"), createMockExtra(host));
166
+ expect(extAppsResult).toEqual({
167
+ contents: [
168
+ {
169
+ uri: "ui://widgets/ext-apps/my-widget.html",
170
+ mimeType: "text/html;profile=mcp-app",
171
+ text: expect.stringContaining('<div id="root"></div>'),
172
+ _meta: {
173
+ ui: {
174
+ csp: {
175
+ resourceDomains: [serverUrl],
176
+ connectDomains: [serverUrl, hmrUrl],
177
+ },
178
+ domain: serverUrl,
179
+ },
180
+ },
181
+ },
182
+ ],
183
+ });
184
+ expect(extAppsResult.contents[0]?.text).toContain('window.skybridge = { hostType: "mcp-app", serverUrl: "http://localhost:3000" };');
185
+ });
186
+ it("should register tool with ui.resourceUri metadata (not deprecated ui/resourceUri)", async () => {
187
+ const mockToolCallback = vi.fn();
188
+ const mockRegisterResourceConfig = { description: "Test widget" };
189
+ const mockToolConfig = { description: "Test tool" };
190
+ server.registerWidget("my-widget", mockRegisterResourceConfig, mockToolConfig, mockToolCallback);
191
+ expect(mockRegisterTool).toHaveBeenCalledTimes(1);
192
+ const toolCallArgs = mockRegisterTool.mock.calls[0];
193
+ const toolConfig = toolCallArgs?.[1];
194
+ expect(toolConfig._meta).toHaveProperty("ui");
195
+ expect(toolConfig._meta?.ui).toEqual({
196
+ resourceUri: "ui://widgets/ext-apps/my-widget.html",
197
+ });
198
+ });
199
+ it("should apply meta overrides in correct priority: defaults < ui.* < direct openai/* keys", async () => {
200
+ const mockToolCallback = vi.fn();
201
+ const mockRegisterResourceConfig = {
202
+ description: "Test widget",
203
+ _meta: {
204
+ // ui.csp overrides (middle priority)
205
+ ui: {
206
+ csp: {
207
+ resourceDomains: ["https://from-ui-csp.com"],
208
+ connectDomains: ["https://from-ui-csp.com"],
209
+ },
210
+ domain: "https://from-ui-domain.com",
211
+ prefersBorder: false,
212
+ },
213
+ // Direct openai/* keys (highest priority) - should override ui.*
214
+ "openai/widgetDomain": "https://direct-override.com",
215
+ "openai/widgetPrefersBorder": true,
216
+ },
217
+ };
218
+ const mockToolConfig = { description: "Test tool" };
219
+ server.registerWidget("override-test", mockRegisterResourceConfig, mockToolConfig, mockToolCallback);
220
+ const appsSdkCallback = mockRegisterResource.mock
221
+ .calls[0]?.[3];
222
+ const host = `localhost:3000`;
223
+ const serverUrl = `http://${host}`;
224
+ const hmrUrl = `ws://${host}`;
225
+ const result = await appsSdkCallback(new URL("ui://widgets/apps-sdk/override-test.html"), createMockExtra(host));
226
+ const meta = result.contents[0]?._meta;
227
+ // CSP arrays are merged with union - all unique domains from defaults and user config are preserved
228
+ expect(meta["openai/widgetCSP"]).toEqual({
229
+ resource_domains: [serverUrl, "https://from-ui-csp.com"],
230
+ connect_domains: [serverUrl, hmrUrl, "https://from-ui-csp.com"],
231
+ frame_domains: undefined,
232
+ redirect_domains: undefined,
233
+ });
234
+ // Domain should be overridden by direct openai/* key (highest priority)
235
+ expect(meta["openai/widgetDomain"]).toBe("https://direct-override.com");
236
+ // PrefersBorder should be overridden by direct openai/* key (highest priority)
237
+ expect(meta["openai/widgetPrefersBorder"]).toBe(true);
238
+ // Description should be from defaults (toolConfig.description)
239
+ expect(meta["openai/widgetDescription"]).toBe("Test widget");
240
+ });
241
+ it("should register tool with ui.resourceUri metadata only", async () => {
242
+ const mockToolCallback = vi.fn();
243
+ server.registerWidget("my-widget", { description: "Test widget", hosts: ["mcp-app"] }, { description: "Test tool" }, mockToolCallback);
244
+ expect(mockRegisterTool).toHaveBeenCalledTimes(1);
245
+ const toolCallArgs = mockRegisterTool.mock.calls[0];
246
+ const toolConfig = toolCallArgs?.[1];
247
+ expect(toolConfig._meta).toHaveProperty("ui");
248
+ expect(toolConfig._meta?.ui).toEqual({
249
+ resourceUri: "ui://widgets/ext-apps/my-widget.html",
250
+ });
251
+ expect(toolConfig._meta?.["openai/outputTemplate"]).to.be.undefined;
252
+ });
253
+ it("should register tool with uopenai/outputTemplate metadata only", async () => {
254
+ const mockToolCallback = vi.fn();
255
+ server.registerWidget("my-widget", { description: "Test widget", hosts: ["apps-sdk"] }, { description: "Test tool" }, mockToolCallback);
256
+ expect(mockRegisterTool).toHaveBeenCalledTimes(1);
257
+ const toolCallArgs = mockRegisterTool.mock.calls[0];
258
+ const toolConfig = toolCallArgs?.[1];
259
+ expect(toolConfig._meta).not.toHaveProperty("ui");
260
+ expect(toolConfig._meta?.["openai/outputTemplate"]).to.eq("ui://widgets/apps-sdk/my-widget.html");
261
+ });
262
+ });
263
+ //# sourceMappingURL=widget.test.js.map