skybridge 0.0.0-dev.66b8f6b → 0.0.0-dev.6ca41d7

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 (123) hide show
  1. package/README.md +196 -1
  2. package/dist/{server → src/server}/index.d.ts +0 -1
  3. package/dist/{server → src/server}/index.js +0 -1
  4. package/dist/src/server/index.js.map +1 -0
  5. package/dist/{server → src/server}/server.d.ts +1 -0
  6. package/dist/src/server/server.js +57 -0
  7. package/dist/src/server/server.js.map +1 -0
  8. package/dist/src/server/templateHelper.d.ts +15 -0
  9. package/dist/src/server/templateHelper.js +29 -0
  10. package/dist/src/server/templateHelper.js.map +1 -0
  11. package/dist/src/server/templates/development.hbs +12 -0
  12. package/dist/src/server/templates/production.hbs +6 -0
  13. package/dist/{server → src/server}/widgetsDevServer.d.ts +5 -2
  14. package/dist/{server → src/server}/widgetsDevServer.js +5 -2
  15. package/dist/src/server/widgetsDevServer.js.map +1 -0
  16. package/dist/src/test/utils.d.ts +28 -0
  17. package/dist/src/test/utils.js +43 -0
  18. package/dist/src/test/utils.js.map +1 -0
  19. package/dist/src/test/widget.test.d.ts +1 -0
  20. package/dist/src/test/widget.test.js +90 -0
  21. package/dist/src/test/widget.test.js.map +1 -0
  22. package/dist/src/web/hooks/index.d.ts +13 -0
  23. package/dist/src/web/hooks/index.js +14 -0
  24. package/dist/src/web/hooks/index.js.map +1 -0
  25. package/dist/src/web/hooks/use-call-tool.d.ts +62 -0
  26. package/dist/src/web/hooks/use-call-tool.js +66 -0
  27. package/dist/src/web/hooks/use-call-tool.js.map +1 -0
  28. package/dist/src/web/hooks/use-call-tool.test.d.ts +1 -0
  29. package/dist/src/web/hooks/use-call-tool.test.js +163 -0
  30. package/dist/src/web/hooks/use-call-tool.test.js.map +1 -0
  31. package/dist/src/web/hooks/use-display-mode.d.ts +4 -0
  32. package/dist/src/web/hooks/use-display-mode.js +7 -0
  33. package/dist/src/web/hooks/use-display-mode.js.map +1 -0
  34. package/dist/src/web/hooks/use-display-mode.test.d.ts +1 -0
  35. package/dist/src/web/hooks/use-display-mode.test.js +40 -0
  36. package/dist/src/web/hooks/use-display-mode.test.js.map +1 -0
  37. package/dist/src/web/hooks/use-locale.d.ts +1 -0
  38. package/dist/src/web/hooks/use-locale.js +5 -0
  39. package/dist/src/web/hooks/use-locale.js.map +1 -0
  40. package/dist/src/web/hooks/use-locale.test.d.ts +1 -0
  41. package/dist/src/web/hooks/use-locale.test.js +21 -0
  42. package/dist/src/web/hooks/use-locale.test.js.map +1 -0
  43. package/dist/src/web/hooks/use-open-external.d.ts +1 -0
  44. package/dist/src/web/hooks/use-open-external.js +6 -0
  45. package/dist/src/web/hooks/use-open-external.js.map +1 -0
  46. package/dist/src/web/hooks/use-open-external.test.d.ts +1 -0
  47. package/dist/src/web/hooks/use-open-external.test.js +24 -0
  48. package/dist/src/web/hooks/use-open-external.test.js.map +1 -0
  49. package/dist/{web → src/web/hooks}/use-openai-global.d.ts +1 -1
  50. package/dist/{web → src/web/hooks}/use-openai-global.js +4 -2
  51. package/dist/src/web/hooks/use-openai-global.js.map +1 -0
  52. package/dist/src/web/hooks/use-request-modal.d.ts +5 -0
  53. package/dist/src/web/hooks/use-request-modal.js +9 -0
  54. package/dist/src/web/hooks/use-request-modal.js.map +1 -0
  55. package/dist/src/web/hooks/use-request-modal.test.d.ts +1 -0
  56. package/dist/src/web/hooks/use-request-modal.test.js +24 -0
  57. package/dist/src/web/hooks/use-request-modal.test.js.map +1 -0
  58. package/dist/src/web/hooks/use-send-follow-up-message.d.ts +1 -0
  59. package/dist/src/web/hooks/use-send-follow-up-message.js +11 -0
  60. package/dist/src/web/hooks/use-send-follow-up-message.js.map +1 -0
  61. package/dist/src/web/hooks/use-theme.d.ts +1 -0
  62. package/dist/src/web/hooks/use-theme.js +5 -0
  63. package/dist/src/web/hooks/use-theme.js.map +1 -0
  64. package/dist/src/web/hooks/use-theme.test.d.ts +1 -0
  65. package/dist/src/web/hooks/use-theme.test.js +26 -0
  66. package/dist/src/web/hooks/use-theme.test.js.map +1 -0
  67. package/dist/src/web/hooks/use-tool-info.d.ts +23 -0
  68. package/dist/src/web/hooks/use-tool-info.js +22 -0
  69. package/dist/src/web/hooks/use-tool-info.js.map +1 -0
  70. package/dist/src/web/hooks/use-tool-info.test.d.ts +1 -0
  71. package/dist/src/web/hooks/use-tool-info.test.js +133 -0
  72. package/dist/src/web/hooks/use-tool-info.test.js.map +1 -0
  73. package/dist/src/web/hooks/use-tool-output.d.ts +4 -0
  74. package/dist/src/web/hooks/use-tool-output.js +9 -0
  75. package/dist/src/web/hooks/use-tool-output.js.map +1 -0
  76. package/dist/src/web/hooks/use-tool-response-metadata.d.ts +4 -0
  77. package/dist/src/web/hooks/use-tool-response-metadata.js +8 -0
  78. package/dist/src/web/hooks/use-tool-response-metadata.js.map +1 -0
  79. package/dist/src/web/hooks/use-user-agent.d.ts +1 -0
  80. package/dist/src/web/hooks/use-user-agent.js +5 -0
  81. package/dist/src/web/hooks/use-user-agent.js.map +1 -0
  82. package/dist/src/web/hooks/use-user-agent.test.d.ts +1 -0
  83. package/dist/src/web/hooks/use-user-agent.test.js +31 -0
  84. package/dist/src/web/hooks/use-user-agent.test.js.map +1 -0
  85. package/dist/src/web/hooks/use-widget-state.d.ts +4 -0
  86. package/dist/src/web/hooks/use-widget-state.js +30 -0
  87. package/dist/src/web/hooks/use-widget-state.js.map +1 -0
  88. package/dist/src/web/hooks/use-widget-state.test.d.ts +1 -0
  89. package/dist/src/web/hooks/use-widget-state.test.js +60 -0
  90. package/dist/src/web/hooks/use-widget-state.test.js.map +1 -0
  91. package/dist/src/web/index.d.ts +4 -0
  92. package/dist/src/web/index.js +5 -0
  93. package/dist/src/web/index.js.map +1 -0
  94. package/dist/src/web/mount-widget.js +14 -0
  95. package/dist/src/web/mount-widget.js.map +1 -0
  96. package/dist/src/web/plugin.d.ts +2 -0
  97. package/dist/src/web/plugin.js +28 -0
  98. package/dist/src/web/plugin.js.map +1 -0
  99. package/dist/{web → src/web}/types.d.ts +17 -3
  100. package/dist/src/web/types.js.map +1 -0
  101. package/dist/vitest.config.d.ts +2 -0
  102. package/dist/vitest.config.js +8 -0
  103. package/dist/vitest.config.js.map +1 -0
  104. package/package.json +26 -12
  105. package/dist/server/index.js.map +0 -1
  106. package/dist/server/middleware.d.ts +0 -3
  107. package/dist/server/middleware.js +0 -47
  108. package/dist/server/middleware.js.map +0 -1
  109. package/dist/server/server.js +0 -70
  110. package/dist/server/server.js.map +0 -1
  111. package/dist/server/widgetsDevServer.js.map +0 -1
  112. package/dist/web/index.d.ts +0 -4
  113. package/dist/web/index.js +0 -5
  114. package/dist/web/index.js.map +0 -1
  115. package/dist/web/mount-widget.js +0 -10
  116. package/dist/web/mount-widget.js.map +0 -1
  117. package/dist/web/types.js.map +0 -1
  118. package/dist/web/use-openai-global.js.map +0 -1
  119. package/dist/web/use-tool-output.d.ts +0 -3
  120. package/dist/web/use-tool-output.js +0 -5
  121. package/dist/web/use-tool-output.js.map +0 -1
  122. /package/dist/{web → src/web}/mount-widget.d.ts +0 -0
  123. /package/dist/{web → src/web}/types.js +0 -0
@@ -0,0 +1,23 @@
1
+ import type { UnknownObject } from "../types.js";
2
+ type ToolState<ToolInput extends UnknownObject, ToolOutput extends UnknownObject, ToolResponseMetadata extends UnknownObject> = {
3
+ status: "pending";
4
+ isPending: true;
5
+ isSuccess: false;
6
+ input: ToolInput;
7
+ output: undefined;
8
+ responseMetadata: undefined;
9
+ } | {
10
+ status: "success";
11
+ isPending: false;
12
+ isSuccess: true;
13
+ input: ToolInput;
14
+ output: ToolOutput;
15
+ responseMetadata: ToolResponseMetadata;
16
+ };
17
+ type ToolSignature = {
18
+ input: UnknownObject;
19
+ output: UnknownObject;
20
+ responseMetadata: UnknownObject;
21
+ };
22
+ export declare function useToolInfo<TS extends Partial<ToolSignature> = {}>(): ToolState<TS["input"] extends UnknownObject ? TS["input"] : UnknownObject, TS["output"] extends UnknownObject ? TS["output"] : UnknownObject, TS["responseMetadata"] extends UnknownObject ? TS["responseMetadata"] : UnknownObject>;
23
+ export {};
@@ -0,0 +1,22 @@
1
+ import { useOpenAiGlobal } from "./use-openai-global.js";
2
+ import { useEffect, useState } from "react";
3
+ export function useToolInfo() {
4
+ const [status, setStatus] = useState("pending");
5
+ const input = useOpenAiGlobal("toolInput");
6
+ const output = useOpenAiGlobal("toolOutput") ?? undefined;
7
+ const responseMetadata = useOpenAiGlobal("toolResponseMetadata") ?? undefined;
8
+ useEffect(() => {
9
+ setStatus(output === undefined && responseMetadata === undefined
10
+ ? "pending"
11
+ : "success");
12
+ }, [output, responseMetadata]);
13
+ return {
14
+ input,
15
+ status,
16
+ isPending: status === "pending",
17
+ isSuccess: status === "success",
18
+ output,
19
+ responseMetadata,
20
+ };
21
+ }
22
+ //# sourceMappingURL=use-tool-info.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-tool-info.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-tool-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AA+B5C,MAAM,UAAU,WAAW;IACzB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAwB,SAAS,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,CAAE,CAAC;IAC5C,MAAM,MAAM,GAAG,eAAe,CAAC,YAAY,CAAC,IAAI,SAAS,CAAC;IAC1D,MAAM,gBAAgB,GAAG,eAAe,CAAC,sBAAsB,CAAC,IAAI,SAAS,CAAC;IAE9E,SAAS,CAAC,GAAG,EAAE;QACb,SAAS,CACP,MAAM,KAAK,SAAS,IAAI,gBAAgB,KAAK,SAAS;YACpD,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,SAAS,CACd,CAAC;IACJ,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAU/B,OAAO;QACL,KAAK;QACL,MAAM;QACN,SAAS,EAAE,MAAM,KAAK,SAAS;QAC/B,SAAS,EAAE,MAAM,KAAK,SAAS;QAC/B,MAAM;QACN,gBAAgB;KACqB,CAAC;AAC1C,CAAC"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,133 @@
1
+ import { fireEvent, renderHook, waitFor, act } from "@testing-library/react";
2
+ import { afterEach, beforeEach, describe, expect, it, vi, expectTypeOf, } from "vitest";
3
+ import { useToolInfo } from "./use-tool-info.js";
4
+ import { SET_GLOBALS_EVENT_TYPE, SetGlobalsEvent, } from "../types.js";
5
+ describe("useToolInfo", () => {
6
+ let OpenaiMock;
7
+ beforeEach(() => {
8
+ OpenaiMock = {
9
+ toolInput: { name: "pokemon", args: { name: "pikachu" } },
10
+ toolOutput: null,
11
+ toolResponseMetadata: null,
12
+ };
13
+ vi.stubGlobal("openai", OpenaiMock);
14
+ });
15
+ afterEach(() => {
16
+ vi.unstubAllGlobals();
17
+ vi.resetAllMocks();
18
+ });
19
+ it("should return toolInput on initial mount window.openai", () => {
20
+ const { result } = renderHook(() => useToolInfo());
21
+ expect(result.current).toMatchObject({
22
+ input: { name: "pokemon", args: { name: "pikachu" } },
23
+ status: "pending",
24
+ isPending: true,
25
+ isSuccess: false,
26
+ });
27
+ });
28
+ it("should eventually return tool output and response metadata once tool call completes", async () => {
29
+ const toolOutput = {
30
+ name: "pikachu",
31
+ color: "yellow",
32
+ description: "When several of these POKéMON gather, their\felectricity could build and cause lightning storms.",
33
+ };
34
+ const toolResponseMetadata = { id: 12 };
35
+ const { result } = renderHook(() => useToolInfo());
36
+ act(() => {
37
+ OpenaiMock.toolOutput = toolOutput;
38
+ OpenaiMock.toolResponseMetadata = toolResponseMetadata;
39
+ fireEvent(window, new SetGlobalsEvent(SET_GLOBALS_EVENT_TYPE, {
40
+ detail: {
41
+ globals: {
42
+ toolOutput,
43
+ toolResponseMetadata,
44
+ },
45
+ },
46
+ }));
47
+ });
48
+ await waitFor(() => {
49
+ expect(result.current).toMatchObject({
50
+ status: "success",
51
+ isPending: false,
52
+ isSuccess: true,
53
+ output: toolOutput,
54
+ responseMetadata: toolResponseMetadata,
55
+ });
56
+ });
57
+ });
58
+ });
59
+ describe("useToolInfo - TypeScript typing", () => {
60
+ it("should have correct types when no generic parameter is provided", () => {
61
+ const { result } = renderHook(() => useToolInfo());
62
+ expectTypeOf(result.current.status);
63
+ expectTypeOf(result.current.isPending);
64
+ expectTypeOf(result.current.isSuccess);
65
+ expectTypeOf(result.current.input);
66
+ });
67
+ it("should correctly type input, output, and responseMetadata with explicit ToolSignature", () => {
68
+ const { result } = renderHook(() => useToolInfo());
69
+ expectTypeOf(result.current.input);
70
+ // When pending, output and responseMetadata should be undefined
71
+ if (result.current.status === "pending") {
72
+ expectTypeOf(result.current.output);
73
+ expectTypeOf(result.current.responseMetadata);
74
+ expectTypeOf(result.current.isPending);
75
+ expectTypeOf(result.current.isSuccess);
76
+ }
77
+ // When success, output and responseMetadata should be defined
78
+ if (result.current.status === "success") {
79
+ expectTypeOf(result.current.output);
80
+ expectTypeOf(result.current.responseMetadata);
81
+ expectTypeOf(result.current.isPending);
82
+ expectTypeOf(result.current.isSuccess);
83
+ }
84
+ });
85
+ it("should correctly narrow types based on status discriminated union", () => {
86
+ const { result } = renderHook(() => useToolInfo());
87
+ // Test type narrowing
88
+ if (result.current.isPending) {
89
+ expectTypeOf(result.current.status);
90
+ expectTypeOf(result.current.isPending);
91
+ expectTypeOf(result.current.isSuccess);
92
+ expectTypeOf(result.current.output);
93
+ expectTypeOf(result.current.responseMetadata);
94
+ }
95
+ if (result.current.isSuccess) {
96
+ expectTypeOf(result.current.status);
97
+ expectTypeOf(result.current.isPending);
98
+ expectTypeOf(result.current.isSuccess);
99
+ expectTypeOf(result.current.output);
100
+ expectTypeOf(result.current.responseMetadata);
101
+ }
102
+ if (result.current.status === "pending") {
103
+ expectTypeOf(result.current.input);
104
+ expectTypeOf(result.current.isPending);
105
+ expectTypeOf(result.current.isSuccess);
106
+ expectTypeOf(result.current.output);
107
+ expectTypeOf(result.current.responseMetadata);
108
+ }
109
+ if (result.current.status === "success") {
110
+ expectTypeOf(result.current.input);
111
+ expectTypeOf(result.current.isPending);
112
+ expectTypeOf(result.current.isSuccess);
113
+ expectTypeOf(result.current.output);
114
+ expectTypeOf(result.current.responseMetadata);
115
+ }
116
+ });
117
+ it("should handle partial ToolSignature with only input specified", () => {
118
+ const { result } = renderHook(() => useToolInfo());
119
+ expectTypeOf(result.current.input);
120
+ if (result.current.status === "success") {
121
+ expectTypeOf(result.current.output);
122
+ expectTypeOf(result.current.responseMetadata);
123
+ }
124
+ });
125
+ it("should handle ToolSignature with only output specified", () => {
126
+ const { result } = renderHook(() => useToolInfo());
127
+ expectTypeOf(result.current.input);
128
+ if (result.current.status === "success") {
129
+ expectTypeOf(result.current.output);
130
+ }
131
+ });
132
+ });
133
+ //# sourceMappingURL=use-tool-info.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-tool-info.test.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-tool-info.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ /**
2
+ * @deprecated This hook is deprecated. Use `useToolInfo()` instead and access the `output` property.
3
+ */
4
+ export declare function useToolOutput(): import("../types.js").UnknownObject | undefined;
@@ -0,0 +1,9 @@
1
+ import { useToolInfo } from "./use-tool-info.js";
2
+ /**
3
+ * @deprecated This hook is deprecated. Use `useToolInfo()` instead and access the `output` property.
4
+ */
5
+ export function useToolOutput() {
6
+ const { output } = useToolInfo();
7
+ return output;
8
+ }
9
+ //# sourceMappingURL=use-tool-output.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-tool-output.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-tool-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;IAEjC,OAAO,MAAM,CAAC;AAChB,CAAC"}
@@ -0,0 +1,4 @@
1
+ /**
2
+ * @deprecated This hook is deprecated. Use `useToolInfo()` instead and access the `responseMetadata` property.
3
+ */
4
+ export declare function useToolResponseMetadata(): import("../types.js").UnknownObject | null | undefined;
@@ -0,0 +1,8 @@
1
+ import { useOpenAiGlobal } from "./use-openai-global.js";
2
+ /**
3
+ * @deprecated This hook is deprecated. Use `useToolInfo()` instead and access the `responseMetadata` property.
4
+ */
5
+ export function useToolResponseMetadata() {
6
+ return useOpenAiGlobal("toolResponseMetadata");
7
+ }
8
+ //# sourceMappingURL=use-tool-response-metadata.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-tool-response-metadata.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-tool-response-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,eAAe,CAAC,sBAAsB,CAAC,CAAC;AACjD,CAAC"}
@@ -0,0 +1 @@
1
+ export declare function useUserAgent(): import("../types.js").UserAgent;
@@ -0,0 +1,5 @@
1
+ import { useOpenAiGlobal } from "./use-openai-global.js";
2
+ export function useUserAgent() {
3
+ return useOpenAiGlobal("userAgent");
4
+ }
5
+ //# sourceMappingURL=use-user-agent.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-user-agent.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-user-agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,UAAU,YAAY;IAC1B,OAAO,eAAe,CAAC,WAAW,CAAE,CAAC;AACvC,CAAC"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,31 @@
1
+ import { useUserAgent } from "./use-user-agent.js";
2
+ import { describe, it, expect, vi, beforeEach, afterEach, } from "vitest";
3
+ import { renderHook } from "@testing-library/react";
4
+ describe("useUserAgent", () => {
5
+ let OpenaiMock;
6
+ beforeEach(() => {
7
+ OpenaiMock = {
8
+ userAgent: {
9
+ device: { type: "mobile" },
10
+ capabilities: { hover: false, touch: true },
11
+ },
12
+ };
13
+ vi.stubGlobal("openai", OpenaiMock);
14
+ });
15
+ afterEach(() => {
16
+ vi.unstubAllGlobals();
17
+ vi.resetAllMocks();
18
+ });
19
+ it("should return the current user agent from window.openai.userAgent", () => {
20
+ OpenaiMock.userAgent = {
21
+ device: { type: "mobile" },
22
+ capabilities: { hover: false, touch: true },
23
+ };
24
+ const { result } = renderHook(() => useUserAgent());
25
+ expect(result.current).toEqual({
26
+ device: { type: "mobile" },
27
+ capabilities: { hover: false, touch: true },
28
+ });
29
+ });
30
+ });
31
+ //# sourceMappingURL=use-user-agent.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-user-agent.test.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-user-agent.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EACL,QAAQ,EACR,EAAE,EACF,MAAM,EACN,EAAE,EACF,UAAU,EACV,SAAS,GAEV,MAAM,QAAQ,CAAC;AAChB,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,IAAI,UAEH,CAAC;IAEF,UAAU,CAAC,GAAG,EAAE;QACd,UAAU,GAAG;YACX,SAAS,EAAE;gBACT,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAC1B,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE;aAC5C;SACF,CAAC;QACF,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,gBAAgB,EAAE,CAAC;QACtB,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,UAAU,CAAC,SAAS,GAAG;YACrB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC1B,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE;SAC5C,CAAC;QACF,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC;QAEpD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;YAC7B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAC1B,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE;SAC5C,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -0,0 +1,4 @@
1
+ import { type SetStateAction } from "react";
2
+ import type { UnknownObject } from "../types.js";
3
+ export declare function useWidgetState<T extends UnknownObject>(defaultState: T | (() => T)): readonly [T, (state: SetStateAction<T>) => void];
4
+ export declare function useWidgetState<T extends UnknownObject>(defaultState?: T | (() => T | null) | null): readonly [T | null, (state: SetStateAction<T | null>) => void];
@@ -0,0 +1,30 @@
1
+ import { useCallback, useEffect, useState } from "react";
2
+ import { useOpenAiGlobal } from "./use-openai-global.js";
3
+ export function useWidgetState(defaultState) {
4
+ const widgetStateFromWindow = useOpenAiGlobal("widgetState");
5
+ const [widgetState, _setWidgetState] = useState(() => {
6
+ if (widgetStateFromWindow !== null) {
7
+ return widgetStateFromWindow;
8
+ }
9
+ return typeof defaultState === "function"
10
+ ? defaultState()
11
+ : defaultState ?? null;
12
+ });
13
+ useEffect(() => {
14
+ // Fixes openai implementation bug
15
+ if (widgetStateFromWindow !== null) {
16
+ _setWidgetState(widgetStateFromWindow);
17
+ }
18
+ }, [widgetStateFromWindow]);
19
+ const setWidgetState = useCallback((state) => {
20
+ _setWidgetState((prevState) => {
21
+ const newState = typeof state === "function" ? state(prevState) : state;
22
+ if (newState !== null) {
23
+ window.openai.setWidgetState(newState);
24
+ }
25
+ return newState;
26
+ });
27
+ }, [window.openai.setWidgetState]);
28
+ return [widgetState, setWidgetState];
29
+ }
30
+ //# sourceMappingURL=use-widget-state.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-widget-state.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-widget-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAuB,MAAM,OAAO,CAAC;AAE9E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAQzD,MAAM,UAAU,cAAc,CAC5B,YAA0C;IAE1C,MAAM,qBAAqB,GAAG,eAAe,CAAC,aAAa,CAAM,CAAC;IAElE,MAAM,CAAC,WAAW,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAW,GAAG,EAAE;QAC7D,IAAI,qBAAqB,KAAK,IAAI,EAAE,CAAC;YACnC,OAAO,qBAAqB,CAAC;QAC/B,CAAC;QAED,OAAO,OAAO,YAAY,KAAK,UAAU;YACvC,CAAC,CAAC,YAAY,EAAE;YAChB,CAAC,CAAC,YAAY,IAAI,IAAI,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,kCAAkC;QAClC,IAAI,qBAAqB,KAAK,IAAI,EAAE,CAAC;YACnC,eAAe,CAAC,qBAAqB,CAAC,CAAC;QACzC,CAAC;IACH,CAAC,EAAE,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAE5B,MAAM,cAAc,GAAG,WAAW,CAChC,CAAC,KAA+B,EAAE,EAAE;QAClC,eAAe,CAAC,CAAC,SAAS,EAAE,EAAE;YAC5B,MAAM,QAAQ,GAAG,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YAExE,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACtB,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;YACzC,CAAC;YAED,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC,EACD,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAC/B,CAAC;IAEF,OAAO,CAAC,WAAW,EAAE,cAAc,CAAU,CAAC;AAChD,CAAC"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,60 @@
1
+ import { useWidgetState } from "./use-widget-state.js";
2
+ import { describe, it, expect, vi, beforeEach, afterEach, } from "vitest";
3
+ import { renderHook, act } from "@testing-library/react";
4
+ describe("useWidgetState", () => {
5
+ let OpenaiMock;
6
+ beforeEach(() => {
7
+ OpenaiMock = {
8
+ widgetState: null,
9
+ setWidgetState: vi.fn().mockResolvedValue(undefined),
10
+ };
11
+ vi.stubGlobal("openai", OpenaiMock);
12
+ });
13
+ afterEach(() => {
14
+ vi.unstubAllGlobals();
15
+ vi.resetAllMocks();
16
+ });
17
+ const defaultState = { count: 0, name: "test" };
18
+ const windowState = { count: 5, name: "window" };
19
+ it("should initialize with default state when window.openai.widgetState is null", () => {
20
+ OpenaiMock.widgetState = null;
21
+ const { result } = renderHook(() => useWidgetState(defaultState));
22
+ expect(result.current[0]).toEqual(defaultState);
23
+ });
24
+ it("should initialize with window.openai.widgetState when available", () => {
25
+ OpenaiMock.widgetState = windowState;
26
+ const { result } = renderHook(() => useWidgetState(defaultState));
27
+ expect(result.current[0]).toEqual(windowState);
28
+ });
29
+ it("should call window.openai.setWidgetState when setWidgetState is called with a new state", async () => {
30
+ const { result } = renderHook(() => useWidgetState(defaultState));
31
+ const newState = { count: 10, name: "updated" };
32
+ act(() => {
33
+ result.current[1](newState);
34
+ });
35
+ expect(OpenaiMock.setWidgetState).toHaveBeenCalledWith(newState);
36
+ expect(result.current[0]).toEqual(newState);
37
+ });
38
+ it("should call window.openai.setWidgetState when setWidgetState is called with a function updater", async () => {
39
+ const { result } = renderHook(() => useWidgetState(defaultState));
40
+ act(() => {
41
+ result.current[1]((prev) => ({ ...prev, count: prev.count + 1 }));
42
+ });
43
+ expect(OpenaiMock.setWidgetState).toHaveBeenCalledWith({
44
+ count: 1,
45
+ name: "test",
46
+ });
47
+ expect(result.current[0]).toEqual({ count: 1, name: "test" });
48
+ });
49
+ it("should update state when window.openai.widgetState changes", () => {
50
+ OpenaiMock.widgetState = defaultState;
51
+ const { result, rerender } = renderHook(() => useWidgetState(defaultState));
52
+ expect(result.current[0]).toEqual(defaultState);
53
+ // Simulate window.openai.widgetState changing
54
+ OpenaiMock.widgetState = windowState;
55
+ // Trigger re-render to simulate the useEffect running
56
+ rerender();
57
+ expect(result.current[0]).toEqual(windowState);
58
+ });
59
+ });
60
+ //# sourceMappingURL=use-widget-state.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"use-widget-state.test.js","sourceRoot":"","sources":["../../../../src/web/hooks/use-widget-state.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ export * from "./types.js";
2
+ export { mountWidget } from "./mount-widget.js";
3
+ export { skybridge } from "./plugin.js";
4
+ export * from "./hooks/index.js";
@@ -0,0 +1,5 @@
1
+ export * from "./types.js";
2
+ export { mountWidget } from "./mount-widget.js";
3
+ export { skybridge } from "./plugin.js";
4
+ export * from "./hooks/index.js";
5
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/web/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,cAAc,kBAAkB,CAAC"}
@@ -0,0 +1,14 @@
1
+ import { createElement, StrictMode } from "react";
2
+ import { createRoot } from "react-dom/client";
3
+ let rootInstance = null;
4
+ export const mountWidget = (component) => {
5
+ const rootElement = document.getElementById("root");
6
+ if (!rootElement) {
7
+ throw new Error("Root element not found");
8
+ }
9
+ if (!rootInstance) {
10
+ rootInstance = createRoot(rootElement);
11
+ }
12
+ rootInstance.render(createElement(StrictMode, null, component));
13
+ };
14
+ //# sourceMappingURL=mount-widget.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mount-widget.js","sourceRoot":"","sources":["../../../src/web/mount-widget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAClD,OAAO,EAAE,UAAU,EAAa,MAAM,kBAAkB,CAAC;AAEzD,IAAI,YAAY,GAAgB,IAAI,CAAC;AAErC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,SAA0B,EAAE,EAAE;IACxD,MAAM,WAAW,GAAG,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IACpD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,YAAY,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC;IAED,YAAY,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;AAClE,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ import type { Plugin } from "vite";
2
+ export declare function skybridge(): Plugin;
@@ -0,0 +1,28 @@
1
+ export function skybridge() {
2
+ return {
3
+ name: "skybridge",
4
+ async config(config) {
5
+ // Dynamic imports to ensure Node modules are only loaded in Node.js context
6
+ const { globSync } = await import("node:fs");
7
+ const { resolve } = await import("node:path");
8
+ const projectRoot = config.root || process.cwd();
9
+ const widgetsPattern = resolve(projectRoot, "src/widgets/*.{js,ts,jsx,tsx,html}");
10
+ const input = Object.fromEntries(globSync(widgetsPattern).map((file) => [
11
+ file.match(/src\/widgets\/(.+)\.tsx$/)?.[1],
12
+ file,
13
+ ]));
14
+ return {
15
+ base: "/assets",
16
+ build: {
17
+ manifest: true,
18
+ minify: true,
19
+ cssCodeSplit: false,
20
+ rollupOptions: {
21
+ input,
22
+ },
23
+ },
24
+ };
25
+ },
26
+ };
27
+ }
28
+ //# sourceMappingURL=plugin.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/web/plugin.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,SAAS;IACvB,OAAO;QACL,IAAI,EAAE,WAAW;QAEjB,KAAK,CAAC,MAAM,CAAC,MAAM;YACjB,4EAA4E;YAC5E,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;YAC7C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;YAE9C,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YACjD,MAAM,cAAc,GAAG,OAAO,CAC5B,WAAW,EACX,oCAAoC,CACrC,CAAC;YAEF,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAC9B,QAAQ,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;gBACrC,IAAI,CAAC,KAAK,CAAC,0BAA0B,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC3C,IAAI;aACL,CAAC,CACH,CAAC;YAEF,OAAO;gBACL,IAAI,EAAE,SAAS;gBACf,KAAK,EAAE;oBACL,QAAQ,EAAE,IAAI;oBACd,MAAM,EAAE,IAAI;oBACZ,YAAY,EAAE,KAAK;oBACnB,aAAa,EAAE;wBACb,KAAK;qBACN;iBACF;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}
@@ -1,4 +1,4 @@
1
- type UnknownObject = Record<string, unknown>;
1
+ export type UnknownObject = Record<string, unknown>;
2
2
  export type WidgetState = UnknownObject;
3
3
  export type SetWidgetState = (state: WidgetState) => Promise<void>;
4
4
  export type SendFollowUpMessage = (args: {
@@ -9,6 +9,10 @@ export type RequestDisplayMode = (args: {
9
9
  }) => Promise<{
10
10
  mode: DisplayMode;
11
11
  }>;
12
+ export type RequestModal = (options: RequestModalOptions) => Promise<void>;
13
+ export type RequestModalOptions = {
14
+ title: string;
15
+ };
12
16
  export declare const TOOL_RESPONSE_EVENT_TYPE = "openai:tool_response";
13
17
  export declare class ToolResponseEvent extends CustomEvent<{
14
18
  tool: {
@@ -26,7 +30,7 @@ declare global {
26
30
  [SET_GLOBALS_EVENT_TYPE]: SetGlobalsEvent;
27
31
  }
28
32
  }
29
- export type OpenAiGlobals<ToolInput extends UnknownObject = UnknownObject, ToolOutput extends UnknownObject = UnknownObject, ToolResponseMetadata extends UnknownObject = UnknownObject, WidgetState extends UnknownObject = UnknownObject> = {
33
+ export type OpenAiGlobals<ToolInput extends UnknownObject = {}, ToolOutput extends UnknownObject = UnknownObject, ToolResponseMetadata extends UnknownObject = UnknownObject, WidgetState extends UnknownObject = UnknownObject> = {
30
34
  theme: Theme;
31
35
  userAgent: UserAgent;
32
36
  locale: string;
@@ -37,13 +41,23 @@ export type OpenAiGlobals<ToolInput extends UnknownObject = UnknownObject, ToolO
37
41
  toolOutput: ToolOutput | null;
38
42
  toolResponseMetadata: ToolResponseMetadata | null;
39
43
  widgetState: WidgetState | null;
44
+ requestDisplayMode: RequestDisplayMode;
45
+ requestModal: RequestModal;
40
46
  };
47
+ export type CallToolArgs = Record<string, unknown> | null;
41
48
  export type CallToolResponse = {
49
+ content: {
50
+ type: "text";
51
+ text: string;
52
+ }[];
53
+ structuredContent: Record<string, unknown>;
54
+ isError: boolean;
42
55
  result: string;
56
+ meta: Record<string, unknown>;
43
57
  };
44
58
  type API<WidgetState extends UnknownObject> = {
45
59
  /** Calls a tool on your MCP. Returns the full response. */
46
- callTool: (name: string, args: Record<string, unknown>) => Promise<CallToolResponse>;
60
+ callTool: <ToolArgs extends CallToolArgs = null, ToolResponse extends CallToolResponse = CallToolResponse>(name: string, args: ToolArgs) => Promise<CallToolResponse & ToolResponse>;
47
61
  /** Triggers a followup turn in the ChatGPT conversation */
48
62
  sendFollowUpMessage: (args: {
49
63
  prompt: string;
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/web/types.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAAsB,CAAC;AAC/D,MAAM,OAAO,iBAAkB,SAAQ,WAErC;IACkB,IAAI,GAAG,wBAAwB,CAAC;CACnD;AA6ED,sDAAsD;AACtD,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAC3D,MAAM,OAAO,eAAgB,SAAQ,WAEnC;IACkB,IAAI,GAAG,sBAAsB,CAAC;CACjD"}
@@ -0,0 +1,2 @@
1
+ declare const _default: import("vite").UserConfig;
2
+ export default _default;
@@ -0,0 +1,8 @@
1
+ import { defineConfig } from "vitest/config";
2
+ export default defineConfig({
3
+ test: {
4
+ environment: "jsdom",
5
+ globals: true,
6
+ },
7
+ });
8
+ //# sourceMappingURL=vitest.config.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"vitest.config.js","sourceRoot":"","sources":["../vitest.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,eAAe,YAAY,CAAC;IAC1B,IAAI,EAAE;QACJ,WAAW,EAAE,OAAO;QACpB,OAAO,EAAE,IAAI;KACd;CACF,CAAC,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "skybridge",
3
- "version": "0.0.0-dev.66b8f6b",
3
+ "version": "0.0.0-dev.6ca41d7",
4
4
  "description": "Skybridge is a framework for building ChatGPT apps",
5
5
  "type": "module",
6
6
  "files": [
@@ -8,16 +8,23 @@
8
8
  ],
9
9
  "exports": {
10
10
  "./server": {
11
- "types": "./dist/server/index.d.ts",
12
- "default": "./dist/server/index.js"
11
+ "types": "./dist/src/server/index.d.ts",
12
+ "default": "./dist/src/server/index.js"
13
13
  },
14
14
  "./web": {
15
- "types": "./dist/web/index.d.ts",
16
- "default": "./dist/web/index.js"
15
+ "types": "./dist/src/web/index.d.ts",
16
+ "default": "./dist/src/web/index.js"
17
17
  }
18
18
  },
19
19
  "scripts": {
20
- "build": "tsc"
20
+ "build": "tsc && pnpm run build:templates",
21
+ "build:templates": "cp -r src/server/templates dist/src/server/",
22
+ "test": "pnpm run test:unit && pnpm run test:type",
23
+ "test:unit": "vitest run --silent",
24
+ "test:type": "tsc --noEmit",
25
+ "docs:dev": "pnpm --filter @skybridge/docs start",
26
+ "docs:build": "pnpm --filter @skybridge/docs build",
27
+ "docs:serve": "pnpm --filter @skybridge/docs serve"
21
28
  },
22
29
  "keywords": [
23
30
  "chatgpt",
@@ -28,24 +35,31 @@
28
35
  "author": "Frédéric Barthelet",
29
36
  "license": "ISC",
30
37
  "peerDependencies": {
31
- "react": ">=19.0.0",
32
- "react-dom": ">=19.0.0"
38
+ "react": ">=18.0.0",
39
+ "react-dom": ">=18.0.0"
33
40
  },
34
41
  "dependencies": {
35
42
  "@modelcontextprotocol/sdk": "^1.20.0",
36
- "zod": "^3.25.51",
37
43
  "cors": "^2.8.5",
38
44
  "express": "^5.1.0",
39
- "vite": "^7.1.11"
45
+ "handlebars": "^4.7.8",
46
+ "vite": "^7.1.11",
47
+ "zod": "^3.25.51"
40
48
  },
41
49
  "devDependencies": {
50
+ "@testing-library/dom": "^10.4.1",
51
+ "@testing-library/react": "^16.3.0",
42
52
  "@total-typescript/tsconfig": "^1.0.4",
43
53
  "@types/cors": "^2.8.19",
44
54
  "@types/express": "^5.0.3",
55
+ "@types/jsdom": "^21.1.6",
45
56
  "@types/node": "^22.15.30",
46
- "@types/react-dom": "^19.2.2",
47
57
  "@types/react": "^19.2.2",
48
- "typescript": "^5.9.3"
58
+ "@types/react-dom": "^19.2.2",
59
+ "@vitest/ui": "^2.1.8",
60
+ "jsdom": "^25.0.1",
61
+ "typescript": "^5.9.3",
62
+ "vitest": "^2.1.8"
49
63
  },
50
64
  "packageManager": "pnpm@10.17.1"
51
65
  }
@@ -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;AACzD,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC"}