skybridge 0.0.0-dev.d0ea289 → 0.0.0-dev.d0fdafb

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 (234) hide show
  1. package/LICENSE +21 -674
  2. package/bin/run.js +9 -0
  3. package/dist/cli/header.d.ts +4 -0
  4. package/dist/cli/header.js +6 -0
  5. package/dist/cli/header.js.map +1 -0
  6. package/dist/cli/run-command.d.ts +2 -0
  7. package/dist/cli/run-command.js +43 -0
  8. package/dist/cli/run-command.js.map +1 -0
  9. package/dist/cli/use-execute-steps.d.ts +10 -0
  10. package/dist/cli/use-execute-steps.js +31 -0
  11. package/dist/cli/use-execute-steps.js.map +1 -0
  12. package/dist/commands/build.d.ts +9 -0
  13. package/dist/commands/build.js +44 -0
  14. package/dist/commands/build.js.map +1 -0
  15. package/dist/commands/dev.d.ts +7 -0
  16. package/dist/commands/dev.js +20 -0
  17. package/dist/commands/dev.js.map +1 -0
  18. package/dist/commands/start.d.ts +7 -0
  19. package/dist/commands/start.js +33 -0
  20. package/dist/commands/start.js.map +1 -0
  21. package/dist/server/index.d.ts +4 -0
  22. package/dist/server/index.js.map +1 -0
  23. package/dist/server/inferUtilityTypes.d.ts +64 -0
  24. package/dist/server/inferUtilityTypes.js +2 -0
  25. package/dist/server/inferUtilityTypes.js.map +1 -0
  26. package/dist/server/server.d.ts +103 -0
  27. package/dist/server/server.js +137 -0
  28. package/dist/server/server.js.map +1 -0
  29. package/dist/server/templateHelper.d.ts +18 -0
  30. package/dist/{src/server → server}/templateHelper.js +5 -12
  31. package/dist/server/templateHelper.js.map +1 -0
  32. package/dist/server/templates/development.hbs +66 -0
  33. package/dist/{src/server → server}/templates/production.hbs +3 -2
  34. package/dist/{src/server → server}/widgetsDevServer.d.ts +2 -2
  35. package/dist/{src/server → server}/widgetsDevServer.js +13 -5
  36. package/dist/server/widgetsDevServer.js.map +1 -0
  37. package/dist/test/utils.d.ts +135 -0
  38. package/dist/test/utils.js +242 -0
  39. package/dist/test/utils.js.map +1 -0
  40. package/dist/test/widget.test.js +255 -0
  41. package/dist/test/widget.test.js.map +1 -0
  42. package/dist/web/bridges/adaptors/apps-sdk-adaptor.d.ts +13 -0
  43. package/dist/web/bridges/adaptors/apps-sdk-adaptor.js +33 -0
  44. package/dist/web/bridges/adaptors/apps-sdk-adaptor.js.map +1 -0
  45. package/dist/web/bridges/adaptors/mcp-app-adaptor.d.ts +16 -0
  46. package/dist/web/bridges/adaptors/mcp-app-adaptor.js +120 -0
  47. package/dist/web/bridges/adaptors/mcp-app-adaptor.js.map +1 -0
  48. package/dist/web/bridges/apps-sdk-bridge.d.ts +10 -0
  49. package/dist/web/bridges/apps-sdk-bridge.js +46 -0
  50. package/dist/web/bridges/apps-sdk-bridge.js.map +1 -0
  51. package/dist/web/bridges/hooks/use-adaptor.d.ts +2 -0
  52. package/dist/web/bridges/hooks/use-adaptor.js +8 -0
  53. package/dist/web/bridges/hooks/use-adaptor.js.map +1 -0
  54. package/dist/web/bridges/hooks/use-apps-sdk-bridge.d.ts +2 -0
  55. package/dist/web/bridges/hooks/use-apps-sdk-bridge.js +7 -0
  56. package/dist/web/bridges/hooks/use-apps-sdk-bridge.js.map +1 -0
  57. package/dist/web/bridges/hooks/use-bridge.d.ts +2 -0
  58. package/dist/web/bridges/hooks/use-bridge.js +8 -0
  59. package/dist/web/bridges/hooks/use-bridge.js.map +1 -0
  60. package/dist/web/bridges/hooks/use-mcp-app-bridge.d.ts +5 -0
  61. package/dist/web/bridges/hooks/use-mcp-app-bridge.js +7 -0
  62. package/dist/web/bridges/hooks/use-mcp-app-bridge.js.map +1 -0
  63. package/dist/web/bridges/hooks/use-mcp-app-bridge.test.js +62 -0
  64. package/dist/web/bridges/hooks/use-mcp-app-bridge.test.js.map +1 -0
  65. package/dist/web/bridges/index.d.ts +4 -0
  66. package/dist/web/bridges/index.js +5 -0
  67. package/dist/web/bridges/index.js.map +1 -0
  68. package/dist/web/bridges/mcp-app-bridge.d.ts +49 -0
  69. package/dist/web/bridges/mcp-app-bridge.js +256 -0
  70. package/dist/web/bridges/mcp-app-bridge.js.map +1 -0
  71. package/dist/web/bridges/types.d.ts +57 -0
  72. package/dist/web/bridges/types.js +2 -0
  73. package/dist/web/bridges/types.js.map +1 -0
  74. package/dist/web/create-store.d.ts +3 -0
  75. package/dist/web/create-store.js +25 -0
  76. package/dist/web/create-store.js.map +1 -0
  77. package/dist/web/create-store.test.d.ts +1 -0
  78. package/dist/web/create-store.test.js +70 -0
  79. package/dist/web/create-store.test.js.map +1 -0
  80. package/dist/web/data-llm.d.ts +14 -0
  81. package/dist/web/data-llm.js +70 -0
  82. package/dist/web/data-llm.js.map +1 -0
  83. package/dist/web/data-llm.test.d.ts +1 -0
  84. package/dist/web/data-llm.test.js +76 -0
  85. package/dist/web/data-llm.test.js.map +1 -0
  86. package/dist/web/generate-helpers.d.ts +115 -0
  87. package/dist/web/generate-helpers.js +111 -0
  88. package/dist/web/generate-helpers.js.map +1 -0
  89. package/dist/web/generate-helpers.test-d.d.ts +1 -0
  90. package/dist/web/generate-helpers.test-d.js +209 -0
  91. package/dist/web/generate-helpers.test-d.js.map +1 -0
  92. package/dist/web/generate-helpers.test.d.ts +1 -0
  93. package/dist/web/generate-helpers.test.js +17 -0
  94. package/dist/web/generate-helpers.test.js.map +1 -0
  95. package/dist/web/helpers/state.d.ts +7 -0
  96. package/dist/web/helpers/state.js +40 -0
  97. package/dist/web/helpers/state.js.map +1 -0
  98. package/dist/web/helpers/state.test.d.ts +1 -0
  99. package/dist/web/helpers/state.test.js +53 -0
  100. package/dist/web/helpers/state.test.js.map +1 -0
  101. package/dist/web/hooks/index.d.ts +11 -0
  102. package/dist/web/hooks/index.js +12 -0
  103. package/dist/web/hooks/index.js.map +1 -0
  104. package/dist/web/hooks/test/utils.d.ts +10 -0
  105. package/dist/web/hooks/test/utils.js +40 -0
  106. package/dist/web/hooks/test/utils.js.map +1 -0
  107. package/dist/web/hooks/use-call-tool.d.ts +100 -0
  108. package/dist/web/hooks/use-call-tool.js +68 -0
  109. package/dist/web/hooks/use-call-tool.js.map +1 -0
  110. package/dist/web/hooks/use-call-tool.test-d.d.ts +1 -0
  111. package/dist/web/hooks/use-call-tool.test-d.js +104 -0
  112. package/dist/web/hooks/use-call-tool.test-d.js.map +1 -0
  113. package/dist/web/hooks/use-call-tool.test.d.ts +1 -0
  114. package/dist/web/hooks/use-call-tool.test.js +190 -0
  115. package/dist/web/hooks/use-call-tool.test.js.map +1 -0
  116. package/dist/web/hooks/use-display-mode.d.ts +4 -0
  117. package/dist/web/hooks/use-display-mode.js +10 -0
  118. package/dist/web/hooks/use-display-mode.js.map +1 -0
  119. package/dist/web/hooks/use-display-mode.test.d.ts +1 -0
  120. package/dist/web/hooks/use-display-mode.test.js +41 -0
  121. package/dist/web/hooks/use-display-mode.test.js.map +1 -0
  122. package/dist/web/hooks/use-files.d.ts +10 -0
  123. package/dist/web/hooks/use-files.js +7 -0
  124. package/dist/web/hooks/use-files.js.map +1 -0
  125. package/dist/web/hooks/use-files.test.d.ts +1 -0
  126. package/dist/web/hooks/use-files.test.js +29 -0
  127. package/dist/web/hooks/use-files.test.js.map +1 -0
  128. package/dist/web/hooks/use-layout.d.ts +22 -0
  129. package/dist/web/hooks/use-layout.js +23 -0
  130. package/dist/web/hooks/use-layout.js.map +1 -0
  131. package/dist/web/hooks/use-layout.test.d.ts +1 -0
  132. package/dist/web/hooks/use-layout.test.js +95 -0
  133. package/dist/web/hooks/use-layout.test.js.map +1 -0
  134. package/dist/web/hooks/use-open-external.d.ts +1 -0
  135. package/dist/web/hooks/use-open-external.js +8 -0
  136. package/dist/web/hooks/use-open-external.js.map +1 -0
  137. package/dist/web/hooks/use-open-external.test.d.ts +1 -0
  138. package/dist/web/hooks/use-open-external.test.js +50 -0
  139. package/dist/web/hooks/use-open-external.test.js.map +1 -0
  140. package/dist/web/hooks/use-openai-global.d.ts +3 -0
  141. package/dist/web/hooks/use-openai-global.js +6 -0
  142. package/dist/web/hooks/use-openai-global.js.map +1 -0
  143. package/dist/web/hooks/use-request-modal.d.ts +9 -0
  144. package/dist/web/hooks/use-request-modal.js +14 -0
  145. package/dist/web/hooks/use-request-modal.js.map +1 -0
  146. package/dist/web/hooks/use-request-modal.test.d.ts +1 -0
  147. package/dist/web/hooks/use-request-modal.test.js +57 -0
  148. package/dist/web/hooks/use-request-modal.test.js.map +1 -0
  149. package/dist/web/hooks/use-send-follow-up-message.d.ts +1 -0
  150. package/dist/web/hooks/use-send-follow-up-message.js +8 -0
  151. package/dist/web/hooks/use-send-follow-up-message.js.map +1 -0
  152. package/dist/web/hooks/use-tool-info.d.ts +36 -0
  153. package/dist/web/hooks/use-tool-info.js +26 -0
  154. package/dist/web/hooks/use-tool-info.js.map +1 -0
  155. package/dist/web/hooks/use-tool-info.test-d.d.ts +1 -0
  156. package/dist/web/hooks/use-tool-info.test-d.js +109 -0
  157. package/dist/web/hooks/use-tool-info.test-d.js.map +1 -0
  158. package/dist/web/hooks/use-tool-info.test.d.ts +1 -0
  159. package/dist/web/hooks/use-tool-info.test.js +130 -0
  160. package/dist/web/hooks/use-tool-info.test.js.map +1 -0
  161. package/dist/web/hooks/use-user.d.ts +18 -0
  162. package/dist/web/hooks/use-user.js +19 -0
  163. package/dist/web/hooks/use-user.js.map +1 -0
  164. package/dist/web/hooks/use-user.test.d.ts +1 -0
  165. package/dist/web/hooks/use-user.test.js +93 -0
  166. package/dist/web/hooks/use-user.test.js.map +1 -0
  167. package/dist/web/hooks/use-widget-state.d.ts +4 -0
  168. package/dist/web/hooks/use-widget-state.js +32 -0
  169. package/dist/web/hooks/use-widget-state.js.map +1 -0
  170. package/dist/web/hooks/use-widget-state.test.d.ts +1 -0
  171. package/dist/web/hooks/use-widget-state.test.js +61 -0
  172. package/dist/web/hooks/use-widget-state.test.js.map +1 -0
  173. package/dist/web/index.d.ts +8 -0
  174. package/dist/web/index.js +9 -0
  175. package/dist/web/index.js.map +1 -0
  176. package/dist/{src/web → web}/mount-widget.js +5 -0
  177. package/dist/web/mount-widget.js.map +1 -0
  178. package/dist/web/plugin/data-llm.test.d.ts +1 -0
  179. package/dist/web/plugin/data-llm.test.js +81 -0
  180. package/dist/web/plugin/data-llm.test.js.map +1 -0
  181. package/dist/web/plugin/plugin.js +39 -0
  182. package/dist/web/plugin/plugin.js.map +1 -0
  183. package/dist/web/plugin/transform-data-llm.d.ts +12 -0
  184. package/dist/web/plugin/transform-data-llm.js +96 -0
  185. package/dist/web/plugin/transform-data-llm.js.map +1 -0
  186. package/dist/web/plugin/transform-data-llm.test.d.ts +1 -0
  187. package/dist/web/plugin/transform-data-llm.test.js +81 -0
  188. package/dist/web/plugin/transform-data-llm.test.js.map +1 -0
  189. package/dist/web/proxy.d.ts +1 -0
  190. package/dist/web/proxy.js +53 -0
  191. package/dist/web/proxy.js.map +1 -0
  192. package/dist/web/types.d.ts +149 -0
  193. package/dist/{src/web → web}/types.js +1 -0
  194. package/dist/web/types.js.map +1 -0
  195. package/package.json +55 -24
  196. package/README.md +0 -126
  197. package/dist/src/server/index.d.ts +0 -2
  198. package/dist/src/server/index.js.map +0 -1
  199. package/dist/src/server/server.d.ts +0 -13
  200. package/dist/src/server/server.js +0 -56
  201. package/dist/src/server/server.js.map +0 -1
  202. package/dist/src/server/templateHelper.d.ts +0 -14
  203. package/dist/src/server/templateHelper.js.map +0 -1
  204. package/dist/src/server/templates/development.hbs +0 -12
  205. package/dist/src/server/widgetsDevServer.js.map +0 -1
  206. package/dist/src/test/setup.js +0 -9
  207. package/dist/src/test/setup.js.map +0 -1
  208. package/dist/src/test/utils.d.ts +0 -28
  209. package/dist/src/test/utils.js +0 -43
  210. package/dist/src/test/utils.js.map +0 -1
  211. package/dist/src/test/widget.test.js +0 -69
  212. package/dist/src/test/widget.test.js.map +0 -1
  213. package/dist/src/web/index.d.ts +0 -5
  214. package/dist/src/web/index.js +0 -6
  215. package/dist/src/web/index.js.map +0 -1
  216. package/dist/src/web/mount-widget.js.map +0 -1
  217. package/dist/src/web/plugin.js +0 -28
  218. package/dist/src/web/plugin.js.map +0 -1
  219. package/dist/src/web/types.d.ts +0 -95
  220. package/dist/src/web/types.js.map +0 -1
  221. package/dist/src/web/use-openai-global.d.ts +0 -2
  222. package/dist/src/web/use-openai-global.js +0 -21
  223. package/dist/src/web/use-openai-global.js.map +0 -1
  224. package/dist/src/web/use-tool-output.d.ts +0 -3
  225. package/dist/src/web/use-tool-output.js +0 -5
  226. package/dist/src/web/use-tool-output.js.map +0 -1
  227. package/dist/vitest.config.d.ts +0 -2
  228. package/dist/vitest.config.js +0 -9
  229. package/dist/vitest.config.js.map +0 -1
  230. /package/dist/{src/server → server}/index.js +0 -0
  231. /package/dist/{src/test → test}/widget.test.d.ts +0 -0
  232. /package/dist/{src/test/setup.d.ts → web/bridges/hooks/use-mcp-app-bridge.test.d.ts} +0 -0
  233. /package/dist/{src/web → web}/mount-widget.d.ts +0 -0
  234. /package/dist/{src/web → web/plugin}/plugin.d.ts +0 -0
@@ -0,0 +1,149 @@
1
+ import "react";
2
+ import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
3
+ import type { WidgetHostType } from "../server/index.js";
4
+ declare module "react" {
5
+ interface HTMLAttributes<T> {
6
+ "data-llm"?: string;
7
+ }
8
+ }
9
+ export type UnknownObject = Record<string, unknown>;
10
+ export type Prettify<T> = {
11
+ [K in keyof T]: T[K];
12
+ } & {};
13
+ export type Objectify<T> = T & UnknownObject;
14
+ type RequiredKeys<T> = {
15
+ [K in keyof T]-?: Record<string, never> extends Pick<T, K> ? never : K;
16
+ }[keyof T];
17
+ export type HasRequiredKeys<T> = RequiredKeys<T> extends never ? false : true;
18
+ type WidgetState = UnknownObject;
19
+ type FileMetadata = {
20
+ fileId: string;
21
+ };
22
+ export declare const TOOL_RESPONSE_EVENT_TYPE = "openai:tool_response";
23
+ export declare class ToolResponseEvent extends CustomEvent<{
24
+ tool: {
25
+ name: string;
26
+ args: UnknownObject;
27
+ };
28
+ }> {
29
+ readonly type = "openai:tool_response";
30
+ }
31
+ declare global {
32
+ interface Window {
33
+ skybridge: SkybridgeProperties;
34
+ openai: OpenAiMethods<WidgetState> & OpenAiProperties;
35
+ }
36
+ interface WindowEventMap {
37
+ [SET_GLOBALS_EVENT_TYPE]: SetGlobalsEvent;
38
+ }
39
+ }
40
+ export type SkybridgeProperties = {
41
+ hostType: WidgetHostType;
42
+ };
43
+ export type OpenAiProperties<ToolInput extends UnknownObject = Record<never, unknown>, ToolOutput extends UnknownObject = UnknownObject, ToolResponseMetadata extends UnknownObject = UnknownObject, WidgetState extends UnknownObject = UnknownObject> = {
44
+ theme: Theme;
45
+ userAgent: UserAgent;
46
+ locale: string;
47
+ maxHeight: number;
48
+ displayMode: DisplayMode;
49
+ safeArea: SafeArea;
50
+ view: View;
51
+ toolInput: ToolInput;
52
+ toolOutput: ToolOutput | {
53
+ text: string;
54
+ } | null;
55
+ toolResponseMetadata: ToolResponseMetadata | null;
56
+ widgetState: WidgetState | null;
57
+ };
58
+ export type CallToolArgs = Record<string, unknown> | null;
59
+ export type CallToolResponse = {
60
+ content: CallToolResult["content"];
61
+ structuredContent: Record<string, unknown>;
62
+ isError: boolean;
63
+ result: string;
64
+ _meta?: CallToolResult["_meta"];
65
+ };
66
+ export type RequestModalOptions = {
67
+ title?: string;
68
+ params?: Record<string, unknown>;
69
+ anchor?: {
70
+ top?: number;
71
+ left?: number;
72
+ width?: number;
73
+ height?: number;
74
+ };
75
+ };
76
+ export type OpenAiMethods<WidgetState extends UnknownObject = UnknownObject> = {
77
+ /** Calls a tool on your MCP. Returns the full response. */
78
+ callTool: <ToolArgs extends CallToolArgs = null, ToolResponse extends CallToolResponse = CallToolResponse>(name: string, args: ToolArgs) => Promise<ToolResponse>;
79
+ /** Triggers a followup turn in the ChatGPT conversation */
80
+ sendFollowUpMessage: (args: {
81
+ prompt: string;
82
+ }) => Promise<void>;
83
+ /** Opens an external link, redirects web page or mobile app */
84
+ openExternal(args: {
85
+ href: string;
86
+ }): void;
87
+ /** For transitioning an app from inline to fullscreen or pip */
88
+ requestDisplayMode: (args: {
89
+ mode: DisplayMode;
90
+ }) => Promise<{
91
+ /**
92
+ * The granted display mode. The host may reject the request.
93
+ * For mobile, PiP is always coerced to fullscreen.
94
+ */
95
+ mode: DisplayMode;
96
+ }>;
97
+ /**
98
+ * Sets the widget state.
99
+ * This state is persisted across widget renders.
100
+ */
101
+ setWidgetState: (state: WidgetState) => Promise<void>;
102
+ /**
103
+ * Opens a modal portaled outside of the widget iFrame.
104
+ * This ensures the modal is correctly displayed and not limited to the widget's area.
105
+ */
106
+ requestModal: (args: RequestModalOptions) => Promise<void>;
107
+ /** Uploads a new file to the host */
108
+ uploadFile: (file: File) => Promise<FileMetadata>;
109
+ /**
110
+ * Downloads a file from the host that was previously uploaded.
111
+ * Only files uploaded by the same connector instance can be downloaded.
112
+ */
113
+ getFileDownloadUrl: (file: FileMetadata) => Promise<{
114
+ downloadUrl: string;
115
+ }>;
116
+ };
117
+ export declare const SET_GLOBALS_EVENT_TYPE = "openai:set_globals";
118
+ export declare class SetGlobalsEvent extends CustomEvent<{
119
+ globals: Partial<OpenAiProperties>;
120
+ }> {
121
+ readonly type = "openai:set_globals";
122
+ }
123
+ export type CallTool = (name: string, args: Record<string, unknown>) => Promise<CallToolResponse>;
124
+ export type DisplayMode = "pip" | "inline" | "fullscreen" | "modal";
125
+ export type View = {
126
+ mode: DisplayMode;
127
+ params?: Record<string, unknown>;
128
+ };
129
+ export type Theme = "light" | "dark";
130
+ export type SafeAreaInsets = {
131
+ top: number;
132
+ bottom: number;
133
+ left: number;
134
+ right: number;
135
+ };
136
+ export type SafeArea = {
137
+ insets: SafeAreaInsets;
138
+ };
139
+ export type DeviceType = "mobile" | "tablet" | "desktop" | "unknown";
140
+ export type UserAgent = {
141
+ device: {
142
+ type: DeviceType;
143
+ };
144
+ capabilities: {
145
+ hover: boolean;
146
+ touch: boolean;
147
+ };
148
+ };
149
+ export {};
@@ -1,3 +1,4 @@
1
+ import "react";
1
2
  export const TOOL_RESPONSE_EVENT_TYPE = "openai:tool_response";
2
3
  export class ToolResponseEvent extends CustomEvent {
3
4
  type = TOOL_RESPONSE_EVENT_TYPE;
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/web/types.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,CAAC;AAyBf,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAAsB,CAAC;AAC/D,MAAM,OAAO,iBAAkB,SAAQ,WAErC;IACkB,IAAI,GAAG,wBAAwB,CAAC;CACnD;AAuGD,sDAAsD;AACtD,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAC3D,MAAM,OAAO,eAAgB,SAAQ,WAEnC;IACkB,IAAI,GAAG,sBAAsB,CAAC;CACjD"}
package/package.json CHANGED
@@ -1,26 +1,25 @@
1
1
  {
2
2
  "name": "skybridge",
3
- "version": "0.0.0-dev.d0ea289",
3
+ "version": "0.0.0-dev.d0fdafb",
4
4
  "description": "Skybridge is a framework for building ChatGPT apps",
5
+ "repository": {
6
+ "type": "git",
7
+ "url": "https://github.com/alpic-ai/skybridge.git"
8
+ },
5
9
  "type": "module",
6
10
  "files": [
7
11
  "dist"
8
12
  ],
9
13
  "exports": {
10
14
  "./server": {
11
- "types": "./dist/src/server/index.d.ts",
12
- "default": "./dist/src/server/index.js"
15
+ "types": "./dist/server/index.d.ts",
16
+ "default": "./dist/server/index.js"
13
17
  },
14
18
  "./web": {
15
- "types": "./dist/src/web/index.d.ts",
16
- "default": "./dist/src/web/index.js"
19
+ "types": "./dist/web/index.d.ts",
20
+ "default": "./dist/web/index.js"
17
21
  }
18
22
  },
19
- "scripts": {
20
- "build": "tsc && pnpm run build:templates",
21
- "build:templates": "cp -r src/server/templates dist/src/server/",
22
- "test": "vitest run --silent"
23
- },
24
23
  "keywords": [
25
24
  "chatgpt",
26
25
  "app",
@@ -30,29 +29,61 @@
30
29
  "author": "Frédéric Barthelet",
31
30
  "license": "ISC",
32
31
  "peerDependencies": {
32
+ "@modelcontextprotocol/sdk": ">=1.0.0",
33
33
  "react": ">=18.0.0",
34
34
  "react-dom": ">=18.0.0"
35
35
  },
36
36
  "dependencies": {
37
- "@modelcontextprotocol/sdk": "^1.20.0",
37
+ "@babel/core": "^7.28.5",
38
+ "@oclif/core": "^4.8.0",
38
39
  "cors": "^2.8.5",
39
- "express": "^5.1.0",
40
+ "dequal": "^2.0.3",
41
+ "es-toolkit": "^1.43.0",
42
+ "express": "^5.2.1",
40
43
  "handlebars": "^4.7.8",
41
- "vite": "^7.1.11",
42
- "zod": "^3.25.51"
44
+ "ink": "^6.6.0",
45
+ "superjson": "^2.2.6",
46
+ "vite": "^7.3.1",
47
+ "zustand": "^5.0.9"
43
48
  },
44
49
  "devDependencies": {
50
+ "@modelcontextprotocol/ext-apps": "^0.3.1",
51
+ "@modelcontextprotocol/sdk": "^1.25.2",
52
+ "@testing-library/dom": "^10.4.1",
53
+ "@testing-library/react": "^16.3.1",
45
54
  "@total-typescript/tsconfig": "^1.0.4",
55
+ "@types/babel__core": "^7.20.5",
46
56
  "@types/cors": "^2.8.19",
47
- "@types/express": "^5.0.3",
48
- "@types/jsdom": "^21.1.6",
49
- "@types/node": "^22.15.30",
50
- "@types/react": "^19.2.2",
51
- "@types/react-dom": "^19.2.2",
52
- "@vitest/ui": "^2.1.8",
53
- "jsdom": "^25.0.1",
57
+ "@types/express": "^5.0.6",
58
+ "@types/jsdom": "^27.0.0",
59
+ "@types/node": "^24.10.4",
60
+ "@types/react": "^19.2.7",
61
+ "@types/react-dom": "^19.2.3",
62
+ "@vitest/ui": "^4.0.16",
63
+ "jsdom": "^27.4.0",
64
+ "shx": "^0.3.4",
65
+ "ts-node": "^10.9.2",
54
66
  "typescript": "^5.9.3",
55
- "vitest": "^2.1.8"
67
+ "vitest": "^4.0.16",
68
+ "zod": "^4.3.5"
56
69
  },
57
- "packageManager": "pnpm@10.17.1"
58
- }
70
+ "bin": {
71
+ "sb": "./bin/run.js",
72
+ "skybridge": "./bin/run.js"
73
+ },
74
+ "oclif": {
75
+ "bin": "skybridge",
76
+ "commands": "./dist/commands",
77
+ "dirname": "skybridge",
78
+ "topicSeparator": " "
79
+ },
80
+ "scripts": {
81
+ "build": "shx rm -rf dist && tsc && pnpm run build:templates",
82
+ "build:templates": "cp -r src/server/templates dist/server/",
83
+ "format": "biome check --write --error-on-warnings",
84
+ "test": "pnpm run test:unit && pnpm run test:type && pnpm run test:format",
85
+ "test:unit": "vitest run",
86
+ "test:type": "tsc --noEmit",
87
+ "test:format": "biome ci"
88
+ }
89
+ }
package/README.md DELETED
@@ -1,126 +0,0 @@
1
- <div align="center">
2
-
3
- # Skybridge
4
-
5
- **Skybridge is the TypeScript framework for building ChatGPT apps**
6
-
7
- [![By Alpic](https://img.shields.io/badge/Made%20by%20Alpic-f6ffed?logo=alpic)](https://alpic.ai)
8
-
9
- ![NPM Downloads](https://img.shields.io/npm/dm/skybridge?color=e90060)
10
- ![NPM Version](https://img.shields.io/npm/v/skybridge?color=e90060)
11
- ![GitHub License](https://img.shields.io/github/license/alpic-ai/skybridge?color=e90060)
12
-
13
- </div>
14
-
15
- Skybridge comes with 2 packages:
16
-
17
- - `skybridge/server`: A drop-in replacement of the `@modelcontextprotocol/sdk` official `McpServer` class with extra features for widget development.
18
- - `skybridge/web`: A react library with hooks and components to build widgets on the underlying _OpenAI iFrame skybridge_ runtime.
19
-
20
- ## Quick start
21
-
22
- To get started in less than a minute, you can [create a new repository](https://github.com/new?template_name=apps-sdk-template&template_owner=alpic-ai) using our [ChatGPT SDK template](https://github.com/alpic-ai/apps-sdk-template). This template includes a basic setup for both the server and the widgets.
23
-
24
- ## Installation
25
-
26
- ```bash
27
- pnpm add skybridge
28
- ```
29
-
30
- ## Concepts
31
-
32
- ### Widgets
33
-
34
- > A widget is a UI component that turns structured tool results into a human-friendly UI. Those are built using React components. They are rendered inside an iframe inline with the conversation on ChatGPT.
35
-
36
- Each widget in your app must have a unique name. The name is used to bridge the tool invocation result with the widget React component.
37
-
38
- For example, in order to register a new widget named `pokemon` on your ChatGPT app. You should have the following file structure and file contents:
39
-
40
- _Project structure_
41
-
42
- ```
43
- server/
44
- └── src/
45
- └── index.ts // Register the widget with McpServer.widget()
46
- web/
47
- └── src/
48
- └── widgets/
49
- └── pokemon.tsx // Use the same widget name as the file name
50
- ```
51
-
52
- _server/src/index.ts_
53
-
54
- ```ts
55
- import { McpServer } from "skybridge/server";
56
-
57
- const server = new McpServer();
58
-
59
- server.widget(
60
- "pokemon"
61
- // Remaining arguments...
62
- );
63
- ```
64
-
65
- _web/src/widgets/pokemon.tsx_
66
-
67
- ```ts
68
- import { mountWidget } from "skybridge/web";
69
-
70
- const Pokemon: React.FunctionComponent = () => {
71
- // Your React component code goes here...
72
- };
73
-
74
- mountWidget(<Pokemon />);
75
- ```
76
-
77
- ## Packages
78
-
79
- ### skybridge/server
80
-
81
- The `skybridge/server` package is a drop-in replacement of the `@modelcontextprotocol/sdk` official `McpServer` class with extra features for widget development. If you're already using the `@modelcontextprotocol/sdk`, you can simply replace your `McpServer` import with `skybridge/server` and you're good to go.
82
-
83
- ### skybridge/web
84
-
85
- The `skybridge/web` package is a react library with hooks and components to build widgets on the underlying _OpenAI iFrame skybridge_ runtime.
86
-
87
- **Vite plugin**
88
-
89
- The `skybridge/web` package comes with a Vite plugin that allows you to build your widgets as regular Vite apps.
90
-
91
- ```ts
92
- import { defineConfig } from "vite";
93
- import { skybridge } from "skybridge/web";
94
-
95
- export default defineConfig({
96
- plugins: [skybridge()],
97
- });
98
- ```
99
-
100
- **Hooks**
101
-
102
- The `skybridge/web` package comes with a set of hooks to help you build your widgets.
103
-
104
- ```ts
105
- import { useToolOutput } from "skybridge/web";
106
-
107
- // Initial data returned by the tool invocation on structuredOutput
108
- const toolOutput = useToolOutput();
109
- ```
110
-
111
- ## Migrate your existing MCP server to a ChatGPT app
112
-
113
- If you're already using the `@modelcontextprotocol/sdk` to build a MCP server, you can migrate to a ChatGPT app by following these steps:
114
-
115
- 1. Replace your `McpServer` import from `@modelcontextprotocol/sdk` with the same import from `skybridge/server`
116
- 2. Create a new vite project in a folder named `web` and install the `skybridge` package
117
- 3. Replace the `vite.config.ts` file with the following:
118
-
119
- ```ts
120
- import { defineConfig } from "vite";
121
- import { skybridge } from "skybridge/web";
122
-
123
- export default defineConfig({
124
- plugins: [skybridge()],
125
- });
126
- ```
@@ -1,2 +0,0 @@
1
- export { McpServer } from "./server.js";
2
- export { widgetsDevServer } from "./widgetsDevServer.js";
@@ -1 +0,0 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}
@@ -1,13 +0,0 @@
1
- import { McpServer as McpServerBase, type ToolCallback } from "@modelcontextprotocol/sdk/server/mcp.js";
2
- import type { Resource } from "@modelcontextprotocol/sdk/types.js";
3
- import type { ZodRawShape } from "zod";
4
- type McpServerOriginalResourceConfig = Omit<Resource, "uri" | "name" | "mimeType">;
5
- type McpServerOriginalToolConfig = Omit<Parameters<McpServer["registerTool"]>[1], "inputSchema" | "outputSchema">;
6
- export declare class McpServer extends McpServerBase {
7
- widget<InputArgs extends ZodRawShape, OutputArgs extends ZodRawShape>(name: string, resourceConfig: McpServerOriginalResourceConfig, toolConfig: McpServerOriginalToolConfig & {
8
- inputSchema?: InputArgs;
9
- outputSchema?: OutputArgs;
10
- }, toolCallback: ToolCallback<InputArgs>): void;
11
- private lookupWidgetName;
12
- }
13
- export {};
@@ -1,56 +0,0 @@
1
- import { McpServer as McpServerBase, } from "@modelcontextprotocol/sdk/server/mcp.js";
2
- import { templateHelper } from "./templateHelper.js";
3
- import { readFileSync } from "node:fs";
4
- import path from "node:path";
5
- export class McpServer extends McpServerBase {
6
- widget(name, resourceConfig, toolConfig, toolCallback) {
7
- const uri = `ui://widgets/${name}.html`;
8
- const resourceMetadata = { ...(resourceConfig._meta ?? {}) };
9
- if (toolConfig.description !== undefined) {
10
- resourceMetadata["openai/widgetDescription"] = toolConfig.description;
11
- }
12
- this.resource(name, uri, {
13
- ...resourceConfig,
14
- _meta: resourceMetadata,
15
- }, async (_uri, extra) => {
16
- const serverUrl = process.env.NODE_ENV === "production"
17
- ? `https://${extra?.requestInfo?.headers?.["x-forwarded-host"] ??
18
- extra?.requestInfo?.headers?.host}`
19
- : `http://localhost:3000`;
20
- const templateData = {
21
- serverUrl,
22
- widgetName: process.env.NODE_ENV === "production"
23
- ? this.lookupWidgetName(`src/widgets/${name}.tsx`)
24
- : name,
25
- styleName: process.env.NODE_ENV === "production"
26
- ? this.lookupWidgetName("style.css")
27
- : undefined,
28
- };
29
- const html = process.env.NODE_ENV === "production"
30
- ? templateHelper.renderProduction(templateData)
31
- : templateHelper.renderDevelopment(templateData);
32
- return {
33
- contents: [
34
- {
35
- uri,
36
- mimeType: "text/html+skybridge",
37
- text: html,
38
- },
39
- ],
40
- };
41
- });
42
- const toolMeta = {
43
- ...toolConfig._meta,
44
- "openai/outputTemplate": uri,
45
- };
46
- this.registerTool(name, {
47
- ...toolConfig,
48
- _meta: toolMeta,
49
- }, toolCallback);
50
- }
51
- lookupWidgetName(key) {
52
- const manifest = JSON.parse(readFileSync(path.join(process.cwd(), "dist", "assets", ".vite", "manifest.json"), "utf-8"));
53
- return manifest[key]?.file.split("/").pop() ?? null;
54
- }
55
- }
56
- //# sourceMappingURL=server.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/server/server.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,IAAI,aAAa,GAE3B,MAAM,yCAAyC,CAAC;AAGjD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AA4B7B,MAAM,OAAO,SAAU,SAAQ,aAAa;IAC1C,MAAM,CACJ,IAAY,EACZ,cAA+C,EAC/C,UAGC,EACD,YAAqC;QAErC,MAAM,GAAG,GAAG,gBAAgB,IAAI,OAAO,CAAC;QACxC,MAAM,gBAAgB,GAAiB,EAAE,GAAG,CAAC,cAAc,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QAC3E,IAAI,UAAU,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACzC,gBAAgB,CAAC,0BAA0B,CAAC,GAAG,UAAU,CAAC,WAAW,CAAC;QACxE,CAAC;QAED,IAAI,CAAC,QAAQ,CACX,IAAI,EACJ,GAAG,EACH;YACE,GAAG,cAAc;YACjB,KAAK,EAAE,gBAAgB;SACxB,EACD,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;YACpB,MAAM,SAAS,GACb,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;gBACnC,CAAC,CAAC,WACE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,kBAAkB,CAAC;oBACjD,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,IAC/B,EAAE;gBACJ,CAAC,CAAC,uBAAuB,CAAC;YAE9B,MAAM,YAAY,GAAG;gBACnB,SAAS;gBACT,UAAU,EACR,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;oBACnC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,eAAe,IAAI,MAAM,CAAC;oBAClD,CAAC,CAAC,IAAI;gBACV,SAAS,EACP,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;oBACnC,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC;oBACpC,CAAC,CAAC,SAAS;aAChB,CAAC;YAEF,MAAM,IAAI,GACR,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;gBACnC,CAAC,CAAC,cAAc,CAAC,gBAAgB,CAAC,YAAY,CAAC;gBAC/C,CAAC,CAAC,cAAc,CAAC,iBAAiB,CAAC,YAAY,CAAC,CAAC;YAErD,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG;wBACH,QAAQ,EAAE,qBAAqB;wBAC/B,IAAI,EAAE,IAAI;qBACX;iBACF;aACF,CAAC;QACJ,CAAC,CACF,CAAC;QAEF,MAAM,QAAQ,GAAa;YACzB,GAAG,UAAU,CAAC,KAAK;YACnB,uBAAuB,EAAE,GAAG;SAC7B,CAAC;QAEF,IAAI,CAAC,YAAY,CACf,IAAI,EACJ;YACE,GAAG,UAAU;YACb,KAAK,EAAE,QAAQ;SAChB,EACD,YAAY,CACb,CAAC;IACJ,CAAC;IAEO,gBAAgB,CAAC,GAAW;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CACzB,YAAY,CACV,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,CAAC,EACpE,OAAO,CACR,CACF,CAAC;QAEF,OAAO,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC;IACtD,CAAC;CACF"}
@@ -1,14 +0,0 @@
1
- type TemplateData = {
2
- serverUrl: string;
3
- widgetName: string;
4
- };
5
- declare class TemplateHelper {
6
- private templateCache;
7
- private loadTemplate;
8
- renderProduction(data: TemplateData): string;
9
- renderDevelopment(data: TemplateData): string;
10
- renderViteClient(data: TemplateData): string;
11
- injectViteClient(html: string, data: TemplateData): string;
12
- }
13
- export declare const templateHelper: TemplateHelper;
14
- export {};
@@ -1 +0,0 @@
1
- {"version":3,"file":"templateHelper.js","sourceRoot":"","sources":["../../../src/server/templateHelper.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAOtC,MAAM,cAAc;IACV,aAAa,GAAG,IAAI,GAAG,EAAsC,CAAC;IAE9D,YAAY,CAAC,YAAoB;QACvC,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAE,CAAC;QAC/C,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,YAAY,MAAM,CAAC,CAAC;QACzE,MAAM,cAAc,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAEpD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAC/C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,gBAAgB,CAAC,IAAkB;QACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;QACjD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,iBAAiB,CAAC,IAAkB;QAClC,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;QAClD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,gBAAgB,CAAC,IAAkB;QACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;QAClD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,gBAAgB,CAAC,IAAY,EAAE,IAAkB;QAC/C,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACrD,OAAO,gBAAgB,GAAG,IAAI,CAAC;IACjC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC"}
@@ -1,12 +0,0 @@
1
- <base href="{{serverUrl}}" />
2
- <script type="module">
3
- import { injectIntoGlobalHook } from "{{serverUrl}}/@react-refresh";
4
- injectIntoGlobalHook(window); window.$RefreshReg$ = () => {};
5
- window.$RefreshSig$ = () => (type) => type;
6
- window.__vite_plugin_react_preamble_installed__ = true;
7
- </script>
8
- <script type="module" src="{{serverUrl}}/@vite/client"></script>
9
- <div id="root"></div>
10
- <script type="module">
11
- import('{{serverUrl}}/src/widgets/{{widgetName}}.tsx');
12
- </script>
@@ -1 +0,0 @@
1
- {"version":3,"file":"widgetsDevServer.js","sourceRoot":"","sources":["../../../src/server/widgetsDevServer.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,EAAE,EAAuB,MAAM,SAAS,CAAC;AACvD,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,IAA6B,EAAE;IAClE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAEhC,MAAM,EAAE,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,GAChE,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IACvB,MAAM,aAAa,GAAG,sBAAsB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IAEnD,MAAM,YAAY,GAAG,MAAM,kBAAkB,CAC3C,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,EACzC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,EACvC,UAAU,CACX,CAAC;IAEF,+DAA+D;IAC/D,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,SAAS,EAAE,GAAG,YAAY,EAAE,MAAM,IAAI,EAAE,CAAC;IAEpE,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC;QAC9B,GAAG,SAAS;QACZ,UAAU,EAAE,KAAK,EAAE,kFAAkF;QACrG,OAAO,EAAE,QAAQ;QACjB,MAAM,EAAE;YACN,YAAY,EAAE,IAAI;YAClB,cAAc,EAAE,IAAI;SACrB;QACD,IAAI,EAAE,UAAU;QAChB,YAAY,EAAE;YACZ,OAAO,EAAE,CAAC,OAAO,EAAE,kBAAkB,CAAC;SACvC;KACF,CAAC,CAAC;IAEH,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACnB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAElC,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}
@@ -1,9 +0,0 @@
1
- import { vi } from "vitest";
2
- // Mock console methods to avoid noise in tests
3
- global.console = {
4
- ...console,
5
- error: vi.fn(),
6
- warn: vi.fn(),
7
- log: vi.fn(),
8
- };
9
- //# sourceMappingURL=setup.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../src/test/setup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE5B,+CAA+C;AAC/C,MAAM,CAAC,OAAO,GAAG;IACf,GAAG,OAAO;IACV,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;IACd,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;IACb,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE;CACb,CAAC"}
@@ -1,28 +0,0 @@
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
- mockResource: MockInstance<McpServer["resource"]>;
9
- mockRegisterTool: MockInstance<McpServer["registerTool"]>;
10
- };
11
- /**
12
- * Mock extra parameter for resource callback
13
- */
14
- export declare function createMockExtra(host: string): {
15
- requestInfo: {
16
- headers: {
17
- host: string;
18
- };
19
- };
20
- };
21
- /**
22
- * Sets up environment variables for testing
23
- */
24
- export declare function setTestEnv(env: Record<string, string>): void;
25
- /**
26
- * Resets environment variables
27
- */
28
- export declare function resetTestEnv(): void;
@@ -1,43 +0,0 @@
1
- import { vi } from "vitest";
2
- import { McpServer, McpServer as McpServerBase } from "../server/server.js";
3
- /**
4
- * Creates a real McpServer instance for testing
5
- */
6
- export function createMockMcpServer() {
7
- // Create a real McpServer instance
8
- const server = new McpServer({
9
- name: "alpic-openai-app",
10
- version: "0.0.1",
11
- }, { capabilities: {} });
12
- // Mock the underlying methods to track calls
13
- const mockResource = vi.spyOn(server, "resource");
14
- const mockRegisterTool = vi.spyOn(server, "registerTool");
15
- return {
16
- server,
17
- mockResource,
18
- mockRegisterTool,
19
- };
20
- }
21
- /**
22
- * Mock extra parameter for resource callback
23
- */
24
- export function createMockExtra(host) {
25
- return {
26
- requestInfo: {
27
- headers: { host },
28
- },
29
- };
30
- }
31
- /**
32
- * Sets up environment variables for testing
33
- */
34
- export function setTestEnv(env) {
35
- Object.assign(process.env, env);
36
- }
37
- /**
38
- * Resets environment variables
39
- */
40
- export function resetTestEnv() {
41
- delete process.env.NODE_ENV;
42
- }
43
- //# sourceMappingURL=utils.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/test/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAqB,MAAM,QAAQ,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE5E;;GAEG;AACH,MAAM,UAAU,mBAAmB;IAKjC,mCAAmC;IACnC,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,OAAO;KACjB,EACD,EAAE,YAAY,EAAE,EAAE,EAAE,CACrB,CAAC;IAEF,6CAA6C;IAC7C,MAAM,YAAY,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAClD,MAAM,gBAAgB,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAE1D,OAAO;QACL,MAAM;QACN,YAAY;QACZ,gBAAgB;KACjB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO;QACL,WAAW,EAAE;YACX,OAAO,EAAE,EAAE,IAAI,EAAE;SAClB;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,GAA2B;IACpD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;AAC9B,CAAC"}