skybridge 0.0.0-dev.da7ba17 → 0.0.0-dev.dafb590

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 (130) hide show
  1. package/dist/server/auth/discovery.js +1 -13
  2. package/dist/server/auth/discovery.js.map +1 -1
  3. package/dist/server/auth/discovery.test.js +0 -22
  4. package/dist/server/auth/discovery.test.js.map +1 -1
  5. package/dist/server/auth/providers/custom.d.ts +4 -16
  6. package/dist/server/auth/providers/custom.js +9 -18
  7. package/dist/server/auth/providers/custom.js.map +1 -1
  8. package/dist/server/auth/providers/custom.test.js +4 -20
  9. package/dist/server/auth/providers/custom.test.js.map +1 -1
  10. package/dist/server/auth/setup.js +2 -2
  11. package/dist/server/auth/setup.js.map +1 -1
  12. package/dist/server/auth/verify.d.ts +2 -3
  13. package/dist/server/auth/verify.js +1 -2
  14. package/dist/server/auth/verify.js.map +1 -1
  15. package/dist/server/auth/verify.test.js +0 -13
  16. package/dist/server/auth/verify.test.js.map +1 -1
  17. package/dist/server/index.d.ts +0 -5
  18. package/dist/server/index.js +0 -5
  19. package/dist/server/index.js.map +1 -1
  20. package/dist/server/server.d.ts +4 -12
  21. package/dist/server/server.js +99 -68
  22. package/dist/server/server.js.map +1 -1
  23. package/dist/server/view-resource-resolution.test.js +9 -24
  24. package/dist/server/view-resource-resolution.test.js.map +1 -1
  25. package/dist/test/view.test.js +101 -69
  26. package/dist/test/view.test.js.map +1 -1
  27. package/dist/web/bridges/apps-sdk/adaptor.d.ts +29 -0
  28. package/dist/web/bridges/apps-sdk/adaptor.js +117 -0
  29. package/dist/web/bridges/apps-sdk/adaptor.js.map +1 -0
  30. package/dist/web/bridges/apps-sdk/bridge.d.ts +2 -6
  31. package/dist/web/bridges/apps-sdk/bridge.js +4 -15
  32. package/dist/web/bridges/apps-sdk/bridge.js.map +1 -1
  33. package/dist/web/bridges/apps-sdk/index.d.ts +1 -0
  34. package/dist/web/bridges/apps-sdk/index.js +1 -0
  35. package/dist/web/bridges/apps-sdk/index.js.map +1 -1
  36. package/dist/web/bridges/get-adaptor.d.ts +4 -4
  37. package/dist/web/bridges/get-adaptor.js +11 -6
  38. package/dist/web/bridges/get-adaptor.js.map +1 -1
  39. package/dist/web/bridges/mcp-app/adaptor.d.ts +53 -0
  40. package/dist/web/bridges/mcp-app/adaptor.js +283 -0
  41. package/dist/web/bridges/mcp-app/adaptor.js.map +1 -0
  42. package/dist/web/bridges/mcp-app/bridge.d.ts +2 -13
  43. package/dist/web/bridges/mcp-app/bridge.js +4 -46
  44. package/dist/web/bridges/mcp-app/bridge.js.map +1 -1
  45. package/dist/web/bridges/mcp-app/index.d.ts +1 -0
  46. package/dist/web/bridges/mcp-app/index.js +1 -0
  47. package/dist/web/bridges/mcp-app/index.js.map +1 -1
  48. package/dist/web/bridges/mcp-app/view-tools.test.js +6 -5
  49. package/dist/web/bridges/mcp-app/view-tools.test.js.map +1 -1
  50. package/dist/web/bridges/types.d.ts +0 -10
  51. package/dist/web/bridges/types.js +1 -14
  52. package/dist/web/bridges/types.js.map +1 -1
  53. package/dist/web/components/modal-provider.js +3 -4
  54. package/dist/web/components/modal-provider.js.map +1 -1
  55. package/dist/web/create-store.test.js +5 -8
  56. package/dist/web/create-store.test.js.map +1 -1
  57. package/dist/web/data-llm.test.js +5 -9
  58. package/dist/web/data-llm.test.js.map +1 -1
  59. package/dist/web/hooks/use-call-tool.test.js +23 -37
  60. package/dist/web/hooks/use-call-tool.test.js.map +1 -1
  61. package/dist/web/hooks/use-display-mode.test.js +20 -56
  62. package/dist/web/hooks/use-display-mode.test.js.map +1 -1
  63. package/dist/web/hooks/use-download.test.js +3 -11
  64. package/dist/web/hooks/use-download.test.js.map +1 -1
  65. package/dist/web/hooks/use-files.test.js +2 -10
  66. package/dist/web/hooks/use-files.test.js.map +1 -1
  67. package/dist/web/hooks/use-layout.test.js +26 -59
  68. package/dist/web/hooks/use-layout.test.js.map +1 -1
  69. package/dist/web/hooks/use-open-external.test.js +3 -13
  70. package/dist/web/hooks/use-open-external.test.js.map +1 -1
  71. package/dist/web/hooks/use-request-close.test.js +40 -35
  72. package/dist/web/hooks/use-request-close.test.js.map +1 -1
  73. package/dist/web/hooks/use-request-modal.test.js +0 -10
  74. package/dist/web/hooks/use-request-modal.test.js.map +1 -1
  75. package/dist/web/hooks/use-request-size.test.js +53 -35
  76. package/dist/web/hooks/use-request-size.test.js.map +1 -1
  77. package/dist/web/hooks/use-set-open-in-app-url.test.js +8 -28
  78. package/dist/web/hooks/use-set-open-in-app-url.test.js.map +1 -1
  79. package/dist/web/hooks/use-tool-info.test.js +27 -37
  80. package/dist/web/hooks/use-tool-info.test.js.map +1 -1
  81. package/dist/web/hooks/use-user.test.js +35 -81
  82. package/dist/web/hooks/use-user.test.js.map +1 -1
  83. package/dist/web/hooks/use-view-state.test.js +2 -6
  84. package/dist/web/hooks/use-view-state.test.js.map +1 -1
  85. package/package.json +1 -1
  86. package/dist/server/auth/providers/auth0.d.ts +0 -18
  87. package/dist/server/auth/providers/auth0.js +0 -31
  88. package/dist/server/auth/providers/auth0.js.map +0 -1
  89. package/dist/server/auth/providers/auth0.test.d.ts +0 -1
  90. package/dist/server/auth/providers/auth0.test.js +0 -48
  91. package/dist/server/auth/providers/auth0.test.js.map +0 -1
  92. package/dist/server/auth/providers/clerk.d.ts +0 -14
  93. package/dist/server/auth/providers/clerk.js +0 -16
  94. package/dist/server/auth/providers/clerk.js.map +0 -1
  95. package/dist/server/auth/providers/clerk.test.d.ts +0 -1
  96. package/dist/server/auth/providers/clerk.test.js +0 -28
  97. package/dist/server/auth/providers/clerk.test.js.map +0 -1
  98. package/dist/server/auth/providers/descope.d.ts +0 -15
  99. package/dist/server/auth/providers/descope.js +0 -33
  100. package/dist/server/auth/providers/descope.js.map +0 -1
  101. package/dist/server/auth/providers/descope.test.d.ts +0 -1
  102. package/dist/server/auth/providers/descope.test.js +0 -37
  103. package/dist/server/auth/providers/descope.test.js.map +0 -1
  104. package/dist/server/auth/providers/shared.d.ts +0 -2
  105. package/dist/server/auth/providers/shared.js +0 -6
  106. package/dist/server/auth/providers/shared.js.map +0 -1
  107. package/dist/server/auth/providers/shared.test.d.ts +0 -1
  108. package/dist/server/auth/providers/shared.test.js +0 -10
  109. package/dist/server/auth/providers/shared.test.js.map +0 -1
  110. package/dist/server/auth/providers/stytch.d.ts +0 -12
  111. package/dist/server/auth/providers/stytch.js +0 -13
  112. package/dist/server/auth/providers/stytch.js.map +0 -1
  113. package/dist/server/auth/providers/workos.d.ts +0 -11
  114. package/dist/server/auth/providers/workos.js +0 -12
  115. package/dist/server/auth/providers/workos.js.map +0 -1
  116. package/dist/web/bridges/adaptor.d.ts +0 -51
  117. package/dist/web/bridges/adaptor.js +0 -310
  118. package/dist/web/bridges/adaptor.js.map +0 -1
  119. package/dist/web/bridges/adaptor.test.d.ts +0 -1
  120. package/dist/web/bridges/adaptor.test.js +0 -197
  121. package/dist/web/bridges/adaptor.test.js.map +0 -1
  122. package/dist/web/bridges/get-adaptor.test.d.ts +0 -1
  123. package/dist/web/bridges/get-adaptor.test.js +0 -32
  124. package/dist/web/bridges/get-adaptor.test.js.map +0 -1
  125. package/dist/web/bridges/mcp-app/bridge.test.d.ts +0 -1
  126. package/dist/web/bridges/mcp-app/bridge.test.js +0 -17
  127. package/dist/web/bridges/mcp-app/bridge.test.js.map +0 -1
  128. package/dist/web/bridges/types.test.d.ts +0 -1
  129. package/dist/web/bridges/types.test.js +0 -19
  130. package/dist/web/bridges/types.test.js.map +0 -1
@@ -0,0 +1,29 @@
1
+ import type { Adaptor, CallToolResponse, DownloadParams, DownloadResult, FileMetadata, HostContext, HostContextStore, OpenExternalOptions, RequestDisplayMode, RequestModalOptions, RequestSizeOptions, SendFollowUpMessageOptions, SetViewStateAction, UploadFileOptions } from "../types.js";
2
+ /** @internal Apps SDK implementation of {@link Adaptor}. Resolved via {@link getAdaptor}. */
3
+ export declare class AppsSdkAdaptor implements Adaptor {
4
+ private static instance;
5
+ static getInstance(): AppsSdkAdaptor;
6
+ static resetInstance(): void;
7
+ getHostContextStore<K extends keyof HostContext>(key: K): HostContextStore<K>;
8
+ callTool: <ToolArgs extends Record<string, unknown> | null = null, ToolResponse extends CallToolResponse = CallToolResponse>(name: string, args: ToolArgs) => Promise<ToolResponse>;
9
+ requestDisplayMode: (mode: RequestDisplayMode) => Promise<{
10
+ mode: RequestDisplayMode;
11
+ }>;
12
+ requestClose: () => Promise<void>;
13
+ requestSize: (_size: RequestSizeOptions) => Promise<void>;
14
+ sendFollowUpMessage: (prompt: string, options?: SendFollowUpMessageOptions) => Promise<void>;
15
+ download: (_params: DownloadParams) => Promise<DownloadResult>;
16
+ openExternal(href: string, options?: OpenExternalOptions): void;
17
+ setViewState: (stateOrUpdater: SetViewStateAction) => Promise<void>;
18
+ uploadFile: (file: File, options?: UploadFileOptions) => Promise<FileMetadata>;
19
+ getFileDownloadUrl: (file: {
20
+ fileId: string;
21
+ }) => Promise<{
22
+ downloadUrl: string;
23
+ }>;
24
+ selectFiles: () => Promise<FileMetadata[]>;
25
+ private trackFileIds;
26
+ openModal(options: RequestModalOptions): Promise<void>;
27
+ setOpenInAppUrl(href: string): Promise<void>;
28
+ registerViewTool: () => (() => void);
29
+ }
@@ -0,0 +1,117 @@
1
+ import { AppsSdkBridge } from "./bridge.js";
2
+ /** @internal Apps SDK implementation of {@link Adaptor}. Resolved via {@link getAdaptor}. */
3
+ export class AppsSdkAdaptor {
4
+ static instance = null;
5
+ static getInstance() {
6
+ if (!AppsSdkAdaptor.instance) {
7
+ AppsSdkAdaptor.instance = new AppsSdkAdaptor();
8
+ }
9
+ return AppsSdkAdaptor.instance;
10
+ }
11
+ static resetInstance() {
12
+ AppsSdkAdaptor.instance = null;
13
+ }
14
+ getHostContextStore(key) {
15
+ const bridge = AppsSdkBridge.getInstance();
16
+ if (key === "viewState") {
17
+ return {
18
+ subscribe: bridge.subscribe("widgetState"),
19
+ getSnapshot: () => bridge.getSnapshot("widgetState")?.modelContent ?? null,
20
+ };
21
+ }
22
+ if (key === "display") {
23
+ return {
24
+ subscribe: bridge.subscribe("view"),
25
+ getSnapshot: () => bridge.getSnapshot("view"),
26
+ };
27
+ }
28
+ return {
29
+ subscribe: bridge.subscribe(key),
30
+ getSnapshot: () => bridge.getSnapshot(key),
31
+ };
32
+ }
33
+ callTool = async (name, args) => {
34
+ const response = await window.openai.callTool(name, args);
35
+ return {
36
+ content: response.content,
37
+ structuredContent: response.structuredContent ?? {},
38
+ isError: response.isError ?? false,
39
+ meta: response._meta ?? response.meta ?? {},
40
+ };
41
+ };
42
+ requestDisplayMode = (mode) => {
43
+ return window.openai.requestDisplayMode({ mode });
44
+ };
45
+ requestClose = () => {
46
+ return window.openai.requestClose();
47
+ };
48
+ requestSize = async (_size) => {
49
+ console.warn("[skybridge] requestSize: not supported on Apps SDK");
50
+ };
51
+ sendFollowUpMessage = (prompt, options) => {
52
+ return window.openai.sendFollowUpMessage({
53
+ prompt,
54
+ scrollToBottom: options?.scrollToBottom,
55
+ });
56
+ };
57
+ download = async (_params) => {
58
+ console.error("[skybridge] download: not supported on Apps SDK");
59
+ return { isError: true };
60
+ };
61
+ openExternal(href, options = {}) {
62
+ window.openai.openExternal({ href, ...options });
63
+ }
64
+ setViewState = (stateOrUpdater) => {
65
+ const modelContent = typeof stateOrUpdater === "function"
66
+ ? stateOrUpdater(window.openai.widgetState?.modelContent ?? null)
67
+ : stateOrUpdater;
68
+ return window.openai.setWidgetState({
69
+ privateContent: {},
70
+ ...window.openai.widgetState,
71
+ modelContent,
72
+ });
73
+ };
74
+ uploadFile = async (file, options) => {
75
+ const metadata = await window.openai.uploadFile(file, options);
76
+ await this.trackFileIds(metadata.fileId);
77
+ return metadata;
78
+ };
79
+ getFileDownloadUrl = (file) => {
80
+ return window.openai.getFileDownloadUrl(file);
81
+ };
82
+ selectFiles = async () => {
83
+ if (!window.openai.selectFiles) {
84
+ throw new Error("selectFiles is not supported by the current host version.");
85
+ }
86
+ const files = await window.openai.selectFiles();
87
+ if (files.length > 0) {
88
+ await this.trackFileIds(...files.map((f) => f.fileId));
89
+ }
90
+ return files;
91
+ };
92
+ async trackFileIds(...fileIds) {
93
+ const state = window.openai.widgetState
94
+ ? { ...window.openai.widgetState }
95
+ : { modelContent: {}, privateContent: {} };
96
+ if (!state.imageIds) {
97
+ state.imageIds = [];
98
+ }
99
+ state.imageIds.push(...fileIds);
100
+ await window.openai.setWidgetState(state);
101
+ }
102
+ openModal(options) {
103
+ return window.openai.requestModal(options);
104
+ }
105
+ setOpenInAppUrl(href) {
106
+ href = href.trim();
107
+ if (!href) {
108
+ throw new Error("The href parameter is required.");
109
+ }
110
+ return window.openai.setOpenInAppUrl({ href });
111
+ }
112
+ registerViewTool = () => {
113
+ console.warn("[skybridge] registerViewTool: view tools are not supported on the Apps SDK runtime");
114
+ return () => { };
115
+ };
116
+ }
117
+ //# sourceMappingURL=adaptor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"adaptor.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/adaptor.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n Adaptor,\n CallToolResponse,\n DownloadParams,\n DownloadResult,\n FileMetadata,\n HostContext,\n HostContextStore,\n OpenExternalOptions,\n RequestDisplayMode,\n RequestModalOptions,\n RequestSizeOptions,\n SendFollowUpMessageOptions,\n SetViewStateAction,\n UploadFileOptions,\n} from \"../types.js\";\nimport { AppsSdkBridge } from \"./bridge.js\";\nimport type { AppsSdkWidgetState } from \"./types.js\";\n\n/** @internal Apps SDK implementation of {@link Adaptor}. Resolved via {@link getAdaptor}. */\nexport class AppsSdkAdaptor implements Adaptor {\n private static instance: AppsSdkAdaptor | null = null;\n\n public static getInstance(): AppsSdkAdaptor {\n if (!AppsSdkAdaptor.instance) {\n AppsSdkAdaptor.instance = new AppsSdkAdaptor();\n }\n return AppsSdkAdaptor.instance;\n }\n\n public static resetInstance(): void {\n AppsSdkAdaptor.instance = null;\n }\n\n public getHostContextStore<K extends keyof HostContext>(\n key: K,\n ): HostContextStore<K> {\n const bridge = AppsSdkBridge.getInstance();\n\n if (key === \"viewState\") {\n return {\n subscribe: bridge.subscribe(\"widgetState\"),\n getSnapshot: () =>\n bridge.getSnapshot(\"widgetState\")?.modelContent ?? null,\n } as HostContextStore<K>;\n }\n\n if (key === \"display\") {\n return {\n subscribe: bridge.subscribe(\"view\"),\n getSnapshot: () => bridge.getSnapshot(\"view\"),\n } as HostContextStore<K>;\n }\n\n return {\n subscribe: bridge.subscribe(key),\n getSnapshot: () => bridge.getSnapshot(key),\n } as HostContextStore<K>;\n }\n\n public callTool = async <\n ToolArgs extends Record<string, unknown> | null = null,\n ToolResponse extends CallToolResponse = CallToolResponse,\n >(\n name: string,\n args: ToolArgs,\n ): Promise<ToolResponse> => {\n const response = await (window.openai.callTool(name, args) as Promise<\n CallToolResponse & { _meta?: CallToolResponse[\"meta\"] }\n >);\n return {\n content: response.content,\n structuredContent: response.structuredContent ?? {},\n isError: response.isError ?? false,\n meta: response._meta ?? response.meta ?? {},\n } as ToolResponse;\n };\n\n public requestDisplayMode = (\n mode: RequestDisplayMode,\n ): Promise<{ mode: RequestDisplayMode }> => {\n return window.openai.requestDisplayMode({ mode });\n };\n\n public requestClose = (): Promise<void> => {\n return window.openai.requestClose();\n };\n\n public requestSize = async (_size: RequestSizeOptions): Promise<void> => {\n console.warn(\"[skybridge] requestSize: not supported on Apps SDK\");\n };\n\n public sendFollowUpMessage = (\n prompt: string,\n options?: SendFollowUpMessageOptions,\n ): Promise<void> => {\n return window.openai.sendFollowUpMessage({\n prompt,\n scrollToBottom: options?.scrollToBottom,\n });\n };\n\n public download = async (\n _params: DownloadParams,\n ): Promise<DownloadResult> => {\n console.error(\"[skybridge] download: not supported on Apps SDK\");\n return { isError: true };\n };\n\n public openExternal(href: string, options: OpenExternalOptions = {}): void {\n window.openai.openExternal({ href, ...options });\n }\n\n public setViewState = (stateOrUpdater: SetViewStateAction): Promise<void> => {\n const modelContent =\n typeof stateOrUpdater === \"function\"\n ? stateOrUpdater(window.openai.widgetState?.modelContent ?? null)\n : stateOrUpdater;\n\n return window.openai.setWidgetState({\n privateContent: {},\n ...window.openai.widgetState,\n modelContent,\n });\n };\n\n public uploadFile = async (file: File, options?: UploadFileOptions) => {\n const metadata = await window.openai.uploadFile(file, options);\n await this.trackFileIds(metadata.fileId);\n return metadata;\n };\n\n public getFileDownloadUrl = (file: { fileId: string }) => {\n return window.openai.getFileDownloadUrl(file);\n };\n\n public selectFiles = async (): Promise<FileMetadata[]> => {\n if (!window.openai.selectFiles) {\n throw new Error(\n \"selectFiles is not supported by the current host version.\",\n );\n }\n const files = await window.openai.selectFiles();\n if (files.length > 0) {\n await this.trackFileIds(...files.map((f) => f.fileId));\n }\n return files;\n };\n\n private async trackFileIds(...fileIds: string[]): Promise<void> {\n const state: AppsSdkWidgetState = window.openai.widgetState\n ? { ...window.openai.widgetState }\n : { modelContent: {}, privateContent: {} };\n if (!state.imageIds) {\n state.imageIds = [];\n }\n state.imageIds.push(...fileIds);\n await window.openai.setWidgetState(state);\n }\n\n public openModal(options: RequestModalOptions) {\n return window.openai.requestModal(options);\n }\n\n public setOpenInAppUrl(href: string): Promise<void> {\n href = href.trim();\n\n if (!href) {\n throw new Error(\"The href parameter is required.\");\n }\n\n return window.openai.setOpenInAppUrl({ href });\n }\n\n public registerViewTool = (): (() => void) => {\n console.warn(\n \"[skybridge] registerViewTool: view tools are not supported on the Apps SDK runtime\",\n );\n return () => {};\n };\n}\n"]}
@@ -1,6 +1,6 @@
1
- import type { Bridge, HostContextStore, Subscribe } from "../types.js";
1
+ import type { Bridge, Subscribe } from "../types.js";
2
2
  import { type AppsSdkContext } from "./types.js";
3
- /** @internal Singleton bridge over `window.openai` events. Used by `HostAdaptor`. */
3
+ /** @internal Singleton bridge over `window.openai` events. Used by {@link AppsSdkAdaptor}. */
4
4
  export declare class AppsSdkBridge implements Bridge<AppsSdkContext> {
5
5
  private static instance;
6
6
  static getInstance(): AppsSdkBridge;
@@ -8,8 +8,4 @@ export declare class AppsSdkBridge implements Bridge<AppsSdkContext> {
8
8
  subscribe(key: keyof AppsSdkContext): Subscribe;
9
9
  subscribe(keys: readonly (keyof AppsSdkContext)[]): Subscribe;
10
10
  getSnapshot: <K extends keyof AppsSdkContext>(key: K) => (import("./types.js").AppsSdkMethods<import("./types.js").AppsSdkWidgetState> & AppsSdkContext<Record<never, unknown>, import("../../types.js").UnknownObject, import("../../types.js").UnknownObject, import("./types.js").AppsSdkWidgetState>)[K];
11
- createOverlayStores(): {
12
- display: HostContextStore<"display">;
13
- viewState: HostContextStore<"viewState">;
14
- };
15
11
  }
@@ -1,10 +1,11 @@
1
1
  import { SET_GLOBALS_EVENT_TYPE, } from "./types.js";
2
- /** @internal Singleton bridge over `window.openai` events. Used by `HostAdaptor`. */
2
+ /** @internal Singleton bridge over `window.openai` events. Used by {@link AppsSdkAdaptor}. */
3
3
  export class AppsSdkBridge {
4
4
  static instance = null;
5
5
  static getInstance() {
6
- if (window.openai === undefined) {
7
- throw new Error("Apps SDK Bridge requires window.openai (Apps SDK runtime).");
6
+ if (window.skybridge.hostType !== "apps-sdk" ||
7
+ window.openai === undefined) {
8
+ throw new Error("Apps SDK Bridge can only be used in the apps-sdk runtime");
8
9
  }
9
10
  if (AppsSdkBridge.instance === null) {
10
11
  AppsSdkBridge.instance = new AppsSdkBridge();
@@ -42,17 +43,5 @@ export class AppsSdkBridge {
42
43
  }
43
44
  return window.openai[key];
44
45
  };
45
- createOverlayStores() {
46
- return {
47
- display: {
48
- subscribe: this.subscribe("view"),
49
- getSnapshot: () => this.getSnapshot("view"),
50
- },
51
- viewState: {
52
- subscribe: this.subscribe("widgetState"),
53
- getSnapshot: () => this.getSnapshot("widgetState")?.modelContent ?? null,
54
- },
55
- };
56
- }
57
46
  }
58
47
  //# sourceMappingURL=bridge.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/bridge.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,sBAAsB,GAEvB,MAAM,YAAY,CAAC;AAEpB,qFAAqF;AACrF,MAAM,OAAO,aAAa;IAChB,MAAM,CAAC,QAAQ,GAAyB,IAAI,CAAC;IAE9C,MAAM,CAAC,WAAW;QACvB,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,4DAA4D,CAC7D,CAAC;QACJ,CAAC;QACD,IAAI,aAAa,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YACpC,aAAa,CAAC,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;QAC/C,CAAC;QACD,OAAO,aAAa,CAAC,QAAQ,CAAC;IAChC,CAAC;IAEM,MAAM,CAAC,aAAa;QACzB,IAAI,aAAa,CAAC,QAAQ,EAAE,CAAC;YAC3B,aAAa,CAAC,QAAQ,GAAG,IAAI,CAAC;QAChC,CAAC;IACH,CAAC;IAIM,SAAS,CACd,SAAmE;QAEnE,MAAM,IAAI,GAAsC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;YACtE,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAChB,OAAO,CAAC,QAAoB,EAAE,EAAE;YAC9B,MAAM,eAAe,GAAG,CAAC,KAAsB,EAAE,EAAE;gBACjD,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CACjC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,CACjD,CAAC;gBACF,IAAI,CAAC,iBAAiB,EAAE,CAAC;oBACvB,OAAO;gBACT,CAAC;gBACD,QAAQ,EAAE,CAAC;YACb,CAAC,CAAC;YAEF,MAAM,CAAC,gBAAgB,CAAC,sBAAsB,EAAE,eAAe,EAAE;gBAC/D,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YAEH,OAAO,GAAG,EAAE;gBACV,MAAM,CAAC,mBAAmB,CAAC,sBAAsB,EAAE,eAAe,CAAC,CAAC;YACtE,CAAC,CAAC;QACJ,CAAC,CAAC;IACJ,CAAC;IAEM,WAAW,GAAG,CAAiC,GAAM,EAAE,EAAE;QAC9D,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,+EAA+E,GAAG,8CAA8C,CACjI,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC,CAAC;IAEK,mBAAmB;QAIxB,OAAO;YACL,OAAO,EAAE;gBACP,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC;gBACjC,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;aAC5C;YACD,SAAS,EAAE;gBACT,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC;gBACxC,WAAW,EAAE,GAAG,EAAE,CAChB,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,EAAE,YAAY,IAAI,IAAI;aACxD;SACF,CAAC;IACJ,CAAC","sourcesContent":["import type { Bridge, HostContextStore, Subscribe } from \"../types.js\";\nimport {\n type AppsSdkContext,\n SET_GLOBALS_EVENT_TYPE,\n type SetGlobalsEvent,\n} from \"./types.js\";\n\n/** @internal Singleton bridge over `window.openai` events. Used by `HostAdaptor`. */\nexport class AppsSdkBridge implements Bridge<AppsSdkContext> {\n private static instance: AppsSdkBridge | null = null;\n\n public static getInstance(): AppsSdkBridge {\n if (window.openai === undefined) {\n throw new Error(\n \"Apps SDK Bridge requires window.openai (Apps SDK runtime).\",\n );\n }\n if (AppsSdkBridge.instance === null) {\n AppsSdkBridge.instance = new AppsSdkBridge();\n }\n return AppsSdkBridge.instance;\n }\n\n public static resetInstance(): void {\n if (AppsSdkBridge.instance) {\n AppsSdkBridge.instance = null;\n }\n }\n\n public subscribe(key: keyof AppsSdkContext): Subscribe;\n public subscribe(keys: readonly (keyof AppsSdkContext)[]): Subscribe;\n public subscribe(\n keyOrKeys: keyof AppsSdkContext | readonly (keyof AppsSdkContext)[],\n ): Subscribe {\n const keys: readonly (keyof AppsSdkContext)[] = Array.isArray(keyOrKeys)\n ? keyOrKeys\n : [keyOrKeys];\n return (onChange: () => void) => {\n const handleSetGlobal = (event: SetGlobalsEvent) => {\n const hasRelevantChange = keys.some(\n (key) => event.detail.globals[key] !== undefined,\n );\n if (!hasRelevantChange) {\n return;\n }\n onChange();\n };\n\n window.addEventListener(SET_GLOBALS_EVENT_TYPE, handleSetGlobal, {\n passive: true,\n });\n\n return () => {\n window.removeEventListener(SET_GLOBALS_EVENT_TYPE, handleSetGlobal);\n };\n };\n }\n\n public getSnapshot = <K extends keyof AppsSdkContext>(key: K) => {\n if (window.openai === undefined) {\n throw new Error(\n `window.openai is not available. Make sure you're calling the hook requiring ${key} within the OpenAI iFrame skybridge runtime.`,\n );\n }\n\n return window.openai[key];\n };\n\n public createOverlayStores(): {\n display: HostContextStore<\"display\">;\n viewState: HostContextStore<\"viewState\">;\n } {\n return {\n display: {\n subscribe: this.subscribe(\"view\"),\n getSnapshot: () => this.getSnapshot(\"view\"),\n },\n viewState: {\n subscribe: this.subscribe(\"widgetState\"),\n getSnapshot: () =>\n this.getSnapshot(\"widgetState\")?.modelContent ?? null,\n },\n };\n }\n}\n"]}
1
+ {"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/bridge.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,sBAAsB,GAEvB,MAAM,YAAY,CAAC;AAEpB,8FAA8F;AAC9F,MAAM,OAAO,aAAa;IAChB,MAAM,CAAC,QAAQ,GAAyB,IAAI,CAAC;IAE9C,MAAM,CAAC,WAAW;QACvB,IACE,MAAM,CAAC,SAAS,CAAC,QAAQ,KAAK,UAAU;YACxC,MAAM,CAAC,MAAM,KAAK,SAAS,EAC3B,CAAC;YACD,MAAM,IAAI,KAAK,CACb,0DAA0D,CAC3D,CAAC;QACJ,CAAC;QACD,IAAI,aAAa,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YACpC,aAAa,CAAC,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;QAC/C,CAAC;QACD,OAAO,aAAa,CAAC,QAAQ,CAAC;IAChC,CAAC;IAEM,MAAM,CAAC,aAAa;QACzB,IAAI,aAAa,CAAC,QAAQ,EAAE,CAAC;YAC3B,aAAa,CAAC,QAAQ,GAAG,IAAI,CAAC;QAChC,CAAC;IACH,CAAC;IAIM,SAAS,CACd,SAAmE;QAEnE,MAAM,IAAI,GAAsC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;YACtE,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAChB,OAAO,CAAC,QAAoB,EAAE,EAAE;YAC9B,MAAM,eAAe,GAAG,CAAC,KAAsB,EAAE,EAAE;gBACjD,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CACjC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS,CACjD,CAAC;gBACF,IAAI,CAAC,iBAAiB,EAAE,CAAC;oBACvB,OAAO;gBACT,CAAC;gBACD,QAAQ,EAAE,CAAC;YACb,CAAC,CAAC;YAEF,MAAM,CAAC,gBAAgB,CAAC,sBAAsB,EAAE,eAAe,EAAE;gBAC/D,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YAEH,OAAO,GAAG,EAAE;gBACV,MAAM,CAAC,mBAAmB,CAAC,sBAAsB,EAAE,eAAe,CAAC,CAAC;YACtE,CAAC,CAAC;QACJ,CAAC,CAAC;IACJ,CAAC;IAEM,WAAW,GAAG,CAAiC,GAAM,EAAE,EAAE;QAC9D,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACb,+EAA+E,GAAG,8CAA8C,CACjI,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC,CAAC","sourcesContent":["import type { Bridge, Subscribe } from \"../types.js\";\nimport {\n type AppsSdkContext,\n SET_GLOBALS_EVENT_TYPE,\n type SetGlobalsEvent,\n} from \"./types.js\";\n\n/** @internal Singleton bridge over `window.openai` events. Used by {@link AppsSdkAdaptor}. */\nexport class AppsSdkBridge implements Bridge<AppsSdkContext> {\n private static instance: AppsSdkBridge | null = null;\n\n public static getInstance(): AppsSdkBridge {\n if (\n window.skybridge.hostType !== \"apps-sdk\" ||\n window.openai === undefined\n ) {\n throw new Error(\n \"Apps SDK Bridge can only be used in the apps-sdk runtime\",\n );\n }\n if (AppsSdkBridge.instance === null) {\n AppsSdkBridge.instance = new AppsSdkBridge();\n }\n return AppsSdkBridge.instance;\n }\n\n public static resetInstance(): void {\n if (AppsSdkBridge.instance) {\n AppsSdkBridge.instance = null;\n }\n }\n\n public subscribe(key: keyof AppsSdkContext): Subscribe;\n public subscribe(keys: readonly (keyof AppsSdkContext)[]): Subscribe;\n public subscribe(\n keyOrKeys: keyof AppsSdkContext | readonly (keyof AppsSdkContext)[],\n ): Subscribe {\n const keys: readonly (keyof AppsSdkContext)[] = Array.isArray(keyOrKeys)\n ? keyOrKeys\n : [keyOrKeys];\n return (onChange: () => void) => {\n const handleSetGlobal = (event: SetGlobalsEvent) => {\n const hasRelevantChange = keys.some(\n (key) => event.detail.globals[key] !== undefined,\n );\n if (!hasRelevantChange) {\n return;\n }\n onChange();\n };\n\n window.addEventListener(SET_GLOBALS_EVENT_TYPE, handleSetGlobal, {\n passive: true,\n });\n\n return () => {\n window.removeEventListener(SET_GLOBALS_EVENT_TYPE, handleSetGlobal);\n };\n };\n }\n\n public getSnapshot = <K extends keyof AppsSdkContext>(key: K) => {\n if (window.openai === undefined) {\n throw new Error(\n `window.openai is not available. Make sure you're calling the hook requiring ${key} within the OpenAI iFrame skybridge runtime.`,\n );\n }\n\n return window.openai[key];\n };\n}\n"]}
@@ -1,3 +1,4 @@
1
+ export { AppsSdkAdaptor } from "./adaptor.js";
1
2
  export { AppsSdkBridge } from "./bridge.js";
2
3
  export type { AppsSdkContext, AppsSdkMethods, AppsSdkWidgetState, ToolResponseEvent, } from "./types.js";
3
4
  export { SET_GLOBALS_EVENT_TYPE, SetGlobalsEvent, TOOL_RESPONSE_EVENT_TYPE, } from "./types.js";
@@ -1,3 +1,4 @@
1
+ export { AppsSdkAdaptor } from "./adaptor.js";
1
2
  export { AppsSdkBridge } from "./bridge.js";
2
3
  export { SET_GLOBALS_EVENT_TYPE, SetGlobalsEvent, TOOL_RESPONSE_EVENT_TYPE, } from "./types.js";
3
4
  export { useAppsSdkContext } from "./use-apps-sdk-context.js";
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAO5C,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC","sourcesContent":["export { AppsSdkBridge } from \"./bridge.js\";\nexport type {\n AppsSdkContext,\n AppsSdkMethods,\n AppsSdkWidgetState,\n ToolResponseEvent,\n} from \"./types.js\";\nexport {\n SET_GLOBALS_EVENT_TYPE,\n SetGlobalsEvent,\n TOOL_RESPONSE_EVENT_TYPE,\n} from \"./types.js\";\nexport { useAppsSdkContext } from \"./use-apps-sdk-context.js\";\n"]}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/web/bridges/apps-sdk/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAO5C,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,wBAAwB,GACzB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC","sourcesContent":["export { AppsSdkAdaptor } from \"./adaptor.js\";\nexport { AppsSdkBridge } from \"./bridge.js\";\nexport type {\n AppsSdkContext,\n AppsSdkMethods,\n AppsSdkWidgetState,\n ToolResponseEvent,\n} from \"./types.js\";\nexport {\n SET_GLOBALS_EVENT_TYPE,\n SetGlobalsEvent,\n TOOL_RESPONSE_EVENT_TYPE,\n} from \"./types.js\";\nexport { useAppsSdkContext } from \"./use-apps-sdk-context.js\";\n"]}
@@ -1,9 +1,9 @@
1
1
  import type { Adaptor } from "./types.js";
2
2
  /**
3
3
  * @internal
4
- * Resolve the single host {@link Adaptor} instance. Prefer the documented
5
- * hooks (`useCallTool`, `useViewState`, etc.) over calling this directly;
6
- * it's the escape hatch used by the hooks themselves and by advanced
7
- * integrations.
4
+ * Resolve the host-specific {@link Adaptor} based on `window.skybridge.hostType`.
5
+ * Prefer the documented hooks (`useCallTool`, `useViewState`, etc.) over
6
+ * calling this directly — it's the escape hatch used by the hooks themselves
7
+ * and by advanced integrations.
8
8
  */
9
9
  export declare const getAdaptor: () => Adaptor;
@@ -1,10 +1,15 @@
1
- import { HostAdaptor } from "./adaptor.js";
1
+ import { AppsSdkAdaptor } from "./apps-sdk/adaptor.js";
2
+ import { McpAppAdaptor } from "./mcp-app/adaptor.js";
2
3
  /**
3
4
  * @internal
4
- * Resolve the single host {@link Adaptor} instance. Prefer the documented
5
- * hooks (`useCallTool`, `useViewState`, etc.) over calling this directly;
6
- * it's the escape hatch used by the hooks themselves and by advanced
7
- * integrations.
5
+ * Resolve the host-specific {@link Adaptor} based on `window.skybridge.hostType`.
6
+ * Prefer the documented hooks (`useCallTool`, `useViewState`, etc.) over
7
+ * calling this directly — it's the escape hatch used by the hooks themselves
8
+ * and by advanced integrations.
8
9
  */
9
- export const getAdaptor = () => HostAdaptor.getInstance();
10
+ export const getAdaptor = () => {
11
+ return window.skybridge.hostType === "apps-sdk"
12
+ ? AppsSdkAdaptor.getInstance()
13
+ : McpAppAdaptor.getInstance();
14
+ };
10
15
  //# sourceMappingURL=get-adaptor.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"get-adaptor.js","sourceRoot":"","sources":["../../../src/web/bridges/get-adaptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAY,EAAE,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC","sourcesContent":["import { HostAdaptor } from \"./adaptor.js\";\nimport type { Adaptor } from \"./types.js\";\n\n/**\n * @internal\n * Resolve the single host {@link Adaptor} instance. Prefer the documented\n * hooks (`useCallTool`, `useViewState`, etc.) over calling this directly;\n * it's the escape hatch used by the hooks themselves and by advanced\n * integrations.\n */\nexport const getAdaptor = (): Adaptor => HostAdaptor.getInstance();\n"]}
1
+ {"version":3,"file":"get-adaptor.js","sourceRoot":"","sources":["../../../src/web/bridges/get-adaptor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAY,EAAE;IACtC,OAAO,MAAM,CAAC,SAAS,CAAC,QAAQ,KAAK,UAAU;QAC7C,CAAC,CAAC,cAAc,CAAC,WAAW,EAAE;QAC9B,CAAC,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC,CAAC","sourcesContent":["import { AppsSdkAdaptor } from \"./apps-sdk/adaptor.js\";\nimport { McpAppAdaptor } from \"./mcp-app/adaptor.js\";\nimport type { Adaptor } from \"./types.js\";\n\n/**\n * @internal\n * Resolve the host-specific {@link Adaptor} based on `window.skybridge.hostType`.\n * Prefer the documented hooks (`useCallTool`, `useViewState`, etc.) over\n * calling this directly it's the escape hatch used by the hooks themselves\n * and by advanced integrations.\n */\nexport const getAdaptor = (): Adaptor => {\n return window.skybridge.hostType === \"apps-sdk\"\n ? AppsSdkAdaptor.getInstance()\n : McpAppAdaptor.getInstance();\n};\n"]}
@@ -0,0 +1,53 @@
1
+ import type { Adaptor, AnyViewToolHandler, CallToolResponse, DownloadParams, DownloadResult, HostContext, HostContextStore, OpenExternalOptions, RequestDisplayMode, RequestModalOptions, RequestSizeOptions, SendFollowUpMessageOptions, SetViewStateAction, ViewToolConfig } from "../types.js";
2
+ /** @internal MCP Apps implementation of {@link Adaptor}. Resolved via {@link getAdaptor}. */
3
+ export declare class McpAppAdaptor implements Adaptor {
4
+ private static instance;
5
+ private stores;
6
+ private _viewState;
7
+ private viewStateListeners;
8
+ private _viewUUID;
9
+ private _displayState;
10
+ private displayListeners;
11
+ private constructor();
12
+ static getInstance(): McpAppAdaptor;
13
+ static resetInstance(): void;
14
+ getHostContextStore<K extends keyof HostContext>(key: K): HostContextStore<K>;
15
+ callTool: <ToolArgs extends Record<string, unknown> | null = null, ToolResponse extends CallToolResponse = CallToolResponse>(name: string, args: ToolArgs) => Promise<ToolResponse>;
16
+ requestDisplayMode: (mode: RequestDisplayMode) => Promise<{
17
+ [x: string]: unknown;
18
+ mode: "inline" | "fullscreen" | "pip";
19
+ }>;
20
+ requestClose: () => Promise<void>;
21
+ requestSize: (size: RequestSizeOptions) => Promise<void>;
22
+ sendFollowUpMessage: (prompt: string, _options?: SendFollowUpMessageOptions) => Promise<void>;
23
+ download: (params: DownloadParams) => Promise<DownloadResult>;
24
+ openExternal(href: string, options?: OpenExternalOptions): void;
25
+ private initializeStores;
26
+ setViewState: (stateOrUpdater: SetViewStateAction) => Promise<void>;
27
+ /**
28
+ * @throws File upload is not supported in MCP App.
29
+ */
30
+ uploadFile(): Promise<{
31
+ fileId: string;
32
+ }>;
33
+ /**
34
+ * @throws File download is not supported in MCP App.
35
+ */
36
+ getFileDownloadUrl(): Promise<{
37
+ downloadUrl: string;
38
+ }>;
39
+ /**
40
+ * @throws File selection is not supported in MCP App.
41
+ */
42
+ selectFiles(): Promise<{
43
+ fileId: string;
44
+ }[]>;
45
+ openModal(options: RequestModalOptions): void;
46
+ closeModal(): void;
47
+ setOpenInAppUrl(_href: string): Promise<void>;
48
+ registerViewTool: (config: ViewToolConfig, handler: AnyViewToolHandler) => (() => void);
49
+ private subscribeToViewUUID;
50
+ private restoreFromLocalStorage;
51
+ private persistToLocalStorage;
52
+ private createHostContextStore;
53
+ }
@@ -0,0 +1,283 @@
1
+ import { dequal } from "dequal/lite";
2
+ import { McpAppBridge } from "./bridge.js";
3
+ const STORAGE_PREFIX = "sb:";
4
+ const MAX_STORAGE_ENTRIES = 200;
5
+ function findStorageKey(viewUUID) {
6
+ const suffix = `:${viewUUID}`;
7
+ for (let i = 0; i < localStorage.length; i++) {
8
+ const key = localStorage.key(i);
9
+ if (key?.startsWith(STORAGE_PREFIX) && key.endsWith(suffix)) {
10
+ return key;
11
+ }
12
+ }
13
+ return undefined;
14
+ }
15
+ /** @internal MCP Apps implementation of {@link Adaptor}. Resolved via {@link getAdaptor}. */
16
+ export class McpAppAdaptor {
17
+ static instance = null;
18
+ stores;
19
+ _viewState = null;
20
+ viewStateListeners = new Set();
21
+ _viewUUID = null;
22
+ _displayState = {
23
+ mode: "inline",
24
+ };
25
+ displayListeners = new Set();
26
+ constructor() {
27
+ this.stores = this.initializeStores();
28
+ this.subscribeToViewUUID();
29
+ }
30
+ static getInstance() {
31
+ if (!McpAppAdaptor.instance) {
32
+ McpAppAdaptor.instance = new McpAppAdaptor();
33
+ }
34
+ return McpAppAdaptor.instance;
35
+ }
36
+ static resetInstance() {
37
+ McpAppAdaptor.instance = null;
38
+ }
39
+ getHostContextStore(key) {
40
+ return this.stores[key];
41
+ }
42
+ callTool = async (name, args) => {
43
+ const app = await McpAppBridge.getInstance().getApp();
44
+ const response = await app.callServerTool({
45
+ name,
46
+ arguments: args ?? undefined,
47
+ });
48
+ return {
49
+ content: response.content,
50
+ structuredContent: response.structuredContent ?? {},
51
+ isError: response.isError ?? false,
52
+ meta: response._meta ?? {},
53
+ };
54
+ };
55
+ requestDisplayMode = async (mode) => {
56
+ const app = await McpAppBridge.getInstance().getApp();
57
+ return app.requestDisplayMode({ mode });
58
+ };
59
+ requestClose = async () => {
60
+ const app = await McpAppBridge.getInstance().getApp();
61
+ await app.requestTeardown();
62
+ };
63
+ requestSize = async (size) => {
64
+ const app = await McpAppBridge.getInstance().getApp();
65
+ await app.sendSizeChanged(size);
66
+ };
67
+ sendFollowUpMessage = async (prompt, _options) => {
68
+ const app = await McpAppBridge.getInstance().getApp();
69
+ await app.sendMessage({
70
+ role: "user",
71
+ content: [
72
+ {
73
+ type: "text",
74
+ text: prompt,
75
+ },
76
+ ],
77
+ });
78
+ };
79
+ download = async (params) => {
80
+ const app = await McpAppBridge.getInstance().getApp();
81
+ if (!app.getHostCapabilities()?.downloadFile) {
82
+ console.error("[skybridge] download: host does not support ui/download-file");
83
+ return { isError: true };
84
+ }
85
+ return app.downloadFile(params);
86
+ };
87
+ openExternal(href, options) {
88
+ if (options?.redirectUrl === false) {
89
+ console.warn("[skybridge] redirectUrl option is not supported by the MCP ui/open-link protocol and will be ignored.");
90
+ }
91
+ McpAppBridge.getInstance()
92
+ .getApp()
93
+ .then((app) => app.openLink({ url: href }))
94
+ .catch((err) => {
95
+ console.error("Failed to open external link:", err);
96
+ });
97
+ }
98
+ initializeStores() {
99
+ return {
100
+ theme: this.createHostContextStore(["theme"], ({ theme }) => theme ?? "light"),
101
+ locale: this.createHostContextStore(["locale"], ({ locale }) => locale ?? "en-US"),
102
+ safeArea: this.createHostContextStore(["safeAreaInsets"], ({ safeAreaInsets }) => ({
103
+ insets: safeAreaInsets ?? { top: 0, right: 0, bottom: 0, left: 0 },
104
+ })),
105
+ displayMode: this.createHostContextStore(["displayMode"], ({ displayMode }) => displayMode ?? "inline"),
106
+ maxHeight: this.createHostContextStore(["containerDimensions"], ({ containerDimensions }) => {
107
+ if (containerDimensions && "maxHeight" in containerDimensions) {
108
+ return containerDimensions.maxHeight;
109
+ }
110
+ return undefined;
111
+ }),
112
+ userAgent: this.createHostContextStore(["platform", "deviceCapabilities"], ({ platform, deviceCapabilities }) => ({
113
+ device: {
114
+ type: platform === "web" ? "desktop" : (platform ?? "unknown"),
115
+ },
116
+ capabilities: {
117
+ hover: true,
118
+ touch: true,
119
+ ...deviceCapabilities,
120
+ },
121
+ })),
122
+ toolInput: this.createHostContextStore(["toolInput"], ({ toolInput }) => toolInput ?? null),
123
+ toolOutput: this.createHostContextStore(["toolResult"], ({ toolResult }) => toolResult?.structuredContent ?? null),
124
+ toolResponseMetadata: this.createHostContextStore(["toolResult"], ({ toolResult }) => toolResult?._meta ?? null),
125
+ display: {
126
+ subscribe: (onChange) => {
127
+ this.displayListeners.add(onChange);
128
+ return () => {
129
+ this.displayListeners.delete(onChange);
130
+ };
131
+ },
132
+ getSnapshot: () => this._displayState,
133
+ },
134
+ viewState: {
135
+ subscribe: (onChange) => {
136
+ this.viewStateListeners.add(onChange);
137
+ return () => {
138
+ this.viewStateListeners.delete(onChange);
139
+ };
140
+ },
141
+ getSnapshot: () => this._viewState,
142
+ },
143
+ };
144
+ }
145
+ setViewState = async (stateOrUpdater) => {
146
+ const newState = typeof stateOrUpdater === "function"
147
+ ? stateOrUpdater(this._viewState)
148
+ : stateOrUpdater;
149
+ // must happen before the async bridge call to ensure the state is updated immediately for the UI,
150
+ // otherwise successive calls to setViewState may have stale state
151
+ this._viewState = newState;
152
+ this.viewStateListeners.forEach((listener) => {
153
+ listener();
154
+ });
155
+ this.persistToLocalStorage(newState);
156
+ try {
157
+ const app = await McpAppBridge.getInstance().getApp();
158
+ await app.updateModelContext({
159
+ structuredContent: newState,
160
+ content: [{ type: "text", text: JSON.stringify(newState) }],
161
+ });
162
+ }
163
+ catch (error) {
164
+ console.error("Failed to update view state in MCP App.", error);
165
+ }
166
+ };
167
+ /**
168
+ * @throws File upload is not supported in MCP App.
169
+ */
170
+ uploadFile() {
171
+ throw new Error("File upload is not supported in MCP App.");
172
+ }
173
+ /**
174
+ * @throws File download is not supported in MCP App.
175
+ */
176
+ getFileDownloadUrl() {
177
+ throw new Error("File download is not supported in MCP App.");
178
+ }
179
+ /**
180
+ * @throws File selection is not supported in MCP App.
181
+ */
182
+ selectFiles() {
183
+ throw new Error("File selection is not supported in MCP App.");
184
+ }
185
+ openModal(options) {
186
+ this._displayState = { mode: "modal", params: options.params };
187
+ this.displayListeners.forEach((listener) => {
188
+ listener();
189
+ });
190
+ }
191
+ closeModal() {
192
+ this._displayState = { mode: "inline" };
193
+ this.displayListeners.forEach((listener) => {
194
+ listener();
195
+ });
196
+ }
197
+ setOpenInAppUrl(_href) {
198
+ throw new Error("setOpenInAppUrl is not implemented in MCP App.");
199
+ }
200
+ registerViewTool = (config, handler) => {
201
+ return McpAppBridge.getInstance().registerViewTool(config, handler);
202
+ };
203
+ subscribeToViewUUID() {
204
+ const bridge = McpAppBridge.getInstance();
205
+ bridge.subscribe("toolResult")(() => {
206
+ const toolResult = bridge.getSnapshot("toolResult");
207
+ const viewUUID = toolResult?._meta?.viewUUID;
208
+ if (viewUUID && viewUUID !== this._viewUUID) {
209
+ this._viewUUID = viewUUID;
210
+ this.restoreFromLocalStorage(viewUUID);
211
+ }
212
+ });
213
+ }
214
+ // localStorage keys: sb:{unix_ms}:{viewUUID}
215
+ // Timestamp is updated on every write (LRU); eviction drops the least recently used entries.
216
+ restoreFromLocalStorage(viewUUID) {
217
+ try {
218
+ const existingKey = findStorageKey(viewUUID);
219
+ if (existingKey) {
220
+ const stored = localStorage.getItem(existingKey);
221
+ if (stored !== null) {
222
+ this._viewState = JSON.parse(stored);
223
+ this.viewStateListeners.forEach((listener) => {
224
+ listener();
225
+ });
226
+ }
227
+ }
228
+ }
229
+ catch (err) {
230
+ console.error(err);
231
+ }
232
+ }
233
+ persistToLocalStorage(state) {
234
+ if (!this._viewUUID || state === null) {
235
+ return;
236
+ }
237
+ try {
238
+ // Remove old key for this view, write with fresh timestamp (LRU)
239
+ const oldKey = findStorageKey(this._viewUUID);
240
+ if (oldKey) {
241
+ localStorage.removeItem(oldKey);
242
+ }
243
+ const newKey = `${STORAGE_PREFIX}${Date.now()}:${this._viewUUID}`;
244
+ localStorage.setItem(newKey, JSON.stringify(state));
245
+ // lru cleanup
246
+ const keys = [];
247
+ for (let i = 0; i < localStorage.length; i++) {
248
+ const key = localStorage.key(i);
249
+ if (key?.startsWith(STORAGE_PREFIX)) {
250
+ keys.push(key);
251
+ }
252
+ }
253
+ if (keys.length <= MAX_STORAGE_ENTRIES) {
254
+ return;
255
+ }
256
+ keys.sort();
257
+ const toRemove = keys.slice(0, keys.length - MAX_STORAGE_ENTRIES);
258
+ for (const key of toRemove) {
259
+ localStorage.removeItem(key);
260
+ }
261
+ }
262
+ catch (err) {
263
+ console.error(err);
264
+ }
265
+ }
266
+ createHostContextStore(keys, computeSnapshot) {
267
+ const bridge = McpAppBridge.getInstance();
268
+ let cachedValue;
269
+ return {
270
+ subscribe: bridge.subscribe(keys),
271
+ getSnapshot: () => {
272
+ const context = Object.fromEntries(keys.map((k) => [k, bridge.getSnapshot(k)]));
273
+ const newValue = computeSnapshot(context);
274
+ if (cachedValue !== undefined && dequal(cachedValue, newValue)) {
275
+ return cachedValue;
276
+ }
277
+ cachedValue = newValue;
278
+ return newValue;
279
+ },
280
+ };
281
+ }
282
+ }
283
+ //# sourceMappingURL=adaptor.js.map