skybridge 0.0.0-dev.feb36b5 → 0.0.0

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 (160) hide show
  1. package/LICENSE +21 -674
  2. package/dist/src/server/devtoolsStaticServer.d.ts +15 -0
  3. package/dist/src/server/devtoolsStaticServer.js +43 -0
  4. package/dist/src/server/devtoolsStaticServer.js.map +1 -0
  5. package/dist/src/server/index.d.ts +3 -0
  6. package/dist/src/server/index.js +1 -0
  7. package/dist/src/server/index.js.map +1 -1
  8. package/dist/src/server/inferUtilityTypes.d.ts +64 -0
  9. package/dist/src/server/inferUtilityTypes.js +2 -0
  10. package/dist/src/server/inferUtilityTypes.js.map +1 -0
  11. package/dist/src/server/server.d.ts +58 -9
  12. package/dist/src/server/server.js +13 -5
  13. package/dist/src/server/server.js.map +1 -1
  14. package/dist/src/server/templateHelper.js +5 -4
  15. package/dist/src/server/templateHelper.js.map +1 -1
  16. package/dist/src/server/templates/development.hbs +1 -1
  17. package/dist/src/server/widgetsDevServer.js +3 -3
  18. package/dist/src/server/widgetsDevServer.js.map +1 -1
  19. package/dist/src/test/utils.d.ts +97 -1
  20. package/dist/src/test/utils.js +182 -3
  21. package/dist/src/test/utils.js.map +1 -1
  22. package/dist/src/test/widget.test.js +45 -26
  23. package/dist/src/test/widget.test.js.map +1 -1
  24. package/dist/src/web/create-store.d.ts +3 -0
  25. package/dist/src/web/create-store.js +25 -0
  26. package/dist/src/web/create-store.js.map +1 -0
  27. package/dist/src/web/create-store.test.js +70 -0
  28. package/dist/src/web/create-store.test.js.map +1 -0
  29. package/dist/src/web/data-llm.d.ts +14 -0
  30. package/dist/src/web/data-llm.js +68 -0
  31. package/dist/src/web/data-llm.js.map +1 -0
  32. package/dist/src/web/data-llm.test.d.ts +1 -0
  33. package/dist/src/web/data-llm.test.js +76 -0
  34. package/dist/src/web/data-llm.test.js.map +1 -0
  35. package/dist/src/web/generate-helpers.d.ts +115 -0
  36. package/dist/src/web/generate-helpers.js +111 -0
  37. package/dist/src/web/generate-helpers.js.map +1 -0
  38. package/dist/src/web/generate-helpers.test-d.d.ts +1 -0
  39. package/dist/src/web/generate-helpers.test-d.js +180 -0
  40. package/dist/src/web/generate-helpers.test-d.js.map +1 -0
  41. package/dist/src/web/generate-helpers.test.d.ts +1 -0
  42. package/dist/src/web/generate-helpers.test.js +17 -0
  43. package/dist/src/web/generate-helpers.test.js.map +1 -0
  44. package/dist/src/web/helpers/state.d.ts +7 -0
  45. package/dist/src/web/helpers/state.js +40 -0
  46. package/dist/src/web/helpers/state.js.map +1 -0
  47. package/dist/src/web/helpers/state.test.d.ts +1 -0
  48. package/dist/src/web/helpers/state.test.js +53 -0
  49. package/dist/src/web/helpers/state.test.js.map +1 -0
  50. package/dist/src/web/hooks/index.d.ts +12 -0
  51. package/dist/src/web/hooks/index.js +13 -0
  52. package/dist/src/web/hooks/index.js.map +1 -0
  53. package/dist/src/web/hooks/use-call-tool.d.ts +100 -0
  54. package/dist/src/web/hooks/use-call-tool.js +60 -0
  55. package/dist/src/web/hooks/use-call-tool.js.map +1 -0
  56. package/dist/src/web/hooks/use-call-tool.test-d.d.ts +1 -0
  57. package/dist/src/web/hooks/use-call-tool.test-d.js +104 -0
  58. package/dist/src/web/hooks/use-call-tool.test-d.js.map +1 -0
  59. package/dist/src/web/hooks/use-call-tool.test.d.ts +1 -0
  60. package/dist/src/web/hooks/use-call-tool.test.js +165 -0
  61. package/dist/src/web/hooks/use-call-tool.test.js.map +1 -0
  62. package/dist/src/web/hooks/use-display-mode.d.ts +4 -0
  63. package/dist/src/web/hooks/use-display-mode.js +7 -0
  64. package/dist/src/web/hooks/use-display-mode.js.map +1 -0
  65. package/dist/src/web/hooks/use-display-mode.test.d.ts +1 -0
  66. package/dist/src/web/hooks/use-display-mode.test.js +40 -0
  67. package/dist/src/web/hooks/use-display-mode.test.js.map +1 -0
  68. package/dist/src/web/hooks/use-files.d.ts +10 -0
  69. package/dist/src/web/hooks/use-files.js +7 -0
  70. package/dist/src/web/hooks/use-files.js.map +1 -0
  71. package/dist/src/web/hooks/use-files.test.d.ts +1 -0
  72. package/dist/src/web/hooks/use-files.test.js +29 -0
  73. package/dist/src/web/hooks/use-files.test.js.map +1 -0
  74. package/dist/src/web/hooks/use-locale.d.ts +1 -0
  75. package/dist/src/web/hooks/use-locale.js +5 -0
  76. package/dist/src/web/hooks/use-locale.js.map +1 -0
  77. package/dist/src/web/hooks/use-locale.test.d.ts +1 -0
  78. package/dist/src/web/hooks/use-locale.test.js +21 -0
  79. package/dist/src/web/hooks/use-locale.test.js.map +1 -0
  80. package/dist/src/web/hooks/use-open-external.d.ts +1 -0
  81. package/dist/src/web/hooks/use-open-external.js +6 -0
  82. package/dist/src/web/hooks/use-open-external.js.map +1 -0
  83. package/dist/src/web/hooks/use-open-external.test.d.ts +1 -0
  84. package/dist/src/web/hooks/use-open-external.test.js +24 -0
  85. package/dist/src/web/hooks/use-open-external.test.js.map +1 -0
  86. package/dist/src/web/hooks/use-openai-global.d.ts +2 -0
  87. package/dist/src/web/{use-openai-global.js → hooks/use-openai-global.js} +7 -3
  88. package/dist/src/web/hooks/use-openai-global.js.map +1 -0
  89. package/dist/src/web/hooks/use-request-modal.d.ts +6 -0
  90. package/dist/src/web/hooks/use-request-modal.js +9 -0
  91. package/dist/src/web/hooks/use-request-modal.js.map +1 -0
  92. package/dist/src/web/hooks/use-request-modal.test.d.ts +1 -0
  93. package/dist/src/web/hooks/use-request-modal.test.js +24 -0
  94. package/dist/src/web/hooks/use-request-modal.test.js.map +1 -0
  95. package/dist/src/web/hooks/use-send-follow-up-message.d.ts +1 -0
  96. package/dist/src/web/hooks/use-send-follow-up-message.js +11 -0
  97. package/dist/src/web/hooks/use-send-follow-up-message.js.map +1 -0
  98. package/dist/src/web/hooks/use-theme.d.ts +1 -0
  99. package/dist/src/web/hooks/use-theme.js +5 -0
  100. package/dist/src/web/hooks/use-theme.js.map +1 -0
  101. package/dist/src/web/hooks/use-theme.test.d.ts +1 -0
  102. package/dist/src/web/hooks/use-theme.test.js +26 -0
  103. package/dist/src/web/hooks/use-theme.test.js.map +1 -0
  104. package/dist/src/web/hooks/use-tool-info.d.ts +25 -0
  105. package/dist/src/web/hooks/use-tool-info.js +20 -0
  106. package/dist/src/web/hooks/use-tool-info.js.map +1 -0
  107. package/dist/src/web/hooks/use-tool-info.test-d.d.ts +1 -0
  108. package/dist/src/web/hooks/use-tool-info.test-d.js +73 -0
  109. package/dist/src/web/hooks/use-tool-info.test-d.js.map +1 -0
  110. package/dist/src/web/hooks/use-tool-info.test.d.ts +1 -0
  111. package/dist/src/web/hooks/use-tool-info.test.js +59 -0
  112. package/dist/src/web/hooks/use-tool-info.test.js.map +1 -0
  113. package/dist/src/web/hooks/use-user-agent.d.ts +1 -0
  114. package/dist/src/web/hooks/use-user-agent.js +5 -0
  115. package/dist/src/web/hooks/use-user-agent.js.map +1 -0
  116. package/dist/src/web/hooks/use-user-agent.test.d.ts +1 -0
  117. package/dist/src/web/hooks/use-user-agent.test.js +31 -0
  118. package/dist/src/web/hooks/use-user-agent.test.js.map +1 -0
  119. package/dist/src/web/hooks/use-widget-state.d.ts +4 -0
  120. package/dist/src/web/hooks/use-widget-state.js +32 -0
  121. package/dist/src/web/hooks/use-widget-state.js.map +1 -0
  122. package/dist/src/web/hooks/use-widget-state.test.d.ts +1 -0
  123. package/dist/src/web/hooks/use-widget-state.test.js +60 -0
  124. package/dist/src/web/hooks/use-widget-state.test.js.map +1 -0
  125. package/dist/src/web/index.d.ts +6 -4
  126. package/dist/src/web/index.js +6 -4
  127. package/dist/src/web/index.js.map +1 -1
  128. package/dist/src/web/mount-widget.js +5 -0
  129. package/dist/src/web/mount-widget.js.map +1 -1
  130. package/dist/src/web/plugin/data-llm.test.d.ts +1 -0
  131. package/dist/src/web/plugin/data-llm.test.js +81 -0
  132. package/dist/src/web/plugin/data-llm.test.js.map +1 -0
  133. package/dist/src/web/{plugin.js → plugin/plugin.js} +5 -0
  134. package/dist/src/web/plugin/plugin.js.map +1 -0
  135. package/dist/src/web/plugin/transform-data-llm.d.ts +12 -0
  136. package/dist/src/web/plugin/transform-data-llm.js +93 -0
  137. package/dist/src/web/plugin/transform-data-llm.js.map +1 -0
  138. package/dist/src/web/plugin/transform-data-llm.test.d.ts +1 -0
  139. package/dist/src/web/plugin/transform-data-llm.test.js +81 -0
  140. package/dist/src/web/plugin/transform-data-llm.test.js.map +1 -0
  141. package/dist/src/web/proxy.d.ts +1 -0
  142. package/dist/src/web/proxy.js +48 -0
  143. package/dist/src/web/proxy.js.map +1 -0
  144. package/dist/src/web/types.d.ts +56 -18
  145. package/dist/src/web/types.js +1 -0
  146. package/dist/src/web/types.js.map +1 -1
  147. package/dist/vitest.config.js +0 -1
  148. package/dist/vitest.config.js.map +1 -1
  149. package/package.json +22 -11
  150. package/README.md +0 -126
  151. package/dist/src/test/setup.js +0 -9
  152. package/dist/src/test/setup.js.map +0 -1
  153. package/dist/src/web/plugin.js.map +0 -1
  154. package/dist/src/web/use-openai-global.d.ts +0 -2
  155. package/dist/src/web/use-openai-global.js.map +0 -1
  156. package/dist/src/web/use-tool-output.d.ts +0 -3
  157. package/dist/src/web/use-tool-output.js +0 -5
  158. package/dist/src/web/use-tool-output.js.map +0 -1
  159. /package/dist/src/{test/setup.d.ts → web/create-store.test.d.ts} +0 -0
  160. /package/dist/src/web/{plugin.d.ts → plugin/plugin.d.ts} +0 -0
@@ -0,0 +1,93 @@
1
+ const LLM_IMPORT_SOURCE = "skybridge/web";
2
+ function createBabelPlugin(t) {
3
+ return {
4
+ name: "data-llm-babel",
5
+ visitor: {
6
+ Program: {
7
+ enter(path, state) {
8
+ state.hasDataLLMImport = false;
9
+ state.needsDataLLMImport = false;
10
+ for (const node of path.node.body) {
11
+ if (!t.isImportDeclaration(node))
12
+ continue;
13
+ if (node.source.value !== LLM_IMPORT_SOURCE)
14
+ continue;
15
+ const hasSpecifier = node.specifiers.some((s) => t.isImportSpecifier(s) &&
16
+ t.isIdentifier(s.imported, { name: "DataLLM" }));
17
+ if (hasSpecifier) {
18
+ state.hasDataLLMImport = true;
19
+ break;
20
+ }
21
+ }
22
+ },
23
+ exit(path, state) {
24
+ if (state.needsDataLLMImport && !state.hasDataLLMImport) {
25
+ const importDecl = t.importDeclaration([
26
+ t.importSpecifier(t.identifier("DataLLM"), t.identifier("DataLLM")),
27
+ ], t.stringLiteral(LLM_IMPORT_SOURCE));
28
+ path.node.body.unshift(importDecl);
29
+ }
30
+ },
31
+ },
32
+ JSXElement(path, state) {
33
+ const opening = path.node.openingElement;
34
+ const attributes = opening.attributes;
35
+ const llmAttributeIndex = attributes.findIndex((attribute) => t.isJSXAttribute(attribute) &&
36
+ t.isJSXIdentifier(attribute.name, { name: "data-llm" }));
37
+ if (llmAttributeIndex === -1)
38
+ return;
39
+ const llmAttribute = attributes[llmAttributeIndex];
40
+ let contentExpression;
41
+ if (t.isStringLiteral(llmAttribute.value)) {
42
+ contentExpression = llmAttribute.value;
43
+ }
44
+ else if (t.isJSXExpressionContainer(llmAttribute.value)) {
45
+ contentExpression = llmAttribute.value.expression;
46
+ }
47
+ else {
48
+ return;
49
+ }
50
+ const contentAttr = t.jsxAttribute(t.jsxIdentifier("content"), t.isStringLiteral(contentExpression)
51
+ ? contentExpression
52
+ : t.jsxExpressionContainer(contentExpression));
53
+ const filteredAttributes = attributes.filter((_, index) => index !== llmAttributeIndex);
54
+ const newOpening = t.jsxOpeningElement(opening.name, filteredAttributes, opening.selfClosing);
55
+ const elementWithoutLlm = t.jsxElement(newOpening, path.node.closingElement, path.node.children, path.node.selfClosing);
56
+ const llmOpening = t.jsxOpeningElement(t.jsxIdentifier("DataLLM"), [
57
+ contentAttr,
58
+ ]);
59
+ const llmClosing = t.jsxClosingElement(t.jsxIdentifier("DataLLM"));
60
+ const wrapped = t.jsxElement(llmOpening, llmClosing, [elementWithoutLlm], false);
61
+ state.needsDataLLMImport = true;
62
+ path.replaceWith(wrapped);
63
+ },
64
+ },
65
+ };
66
+ }
67
+ export const transform = async (code, id) => {
68
+ if (!/\.(jsx|tsx)$/.test(id)) {
69
+ return null;
70
+ }
71
+ if (id.includes("node_modules")) {
72
+ return null;
73
+ }
74
+ // Dynamic import to ensure @babel/core is only loaded in Node.js context
75
+ const { types: t, transformSync } = await import("@babel/core");
76
+ const babelOptions = {
77
+ plugins: [createBabelPlugin(t)],
78
+ parserOpts: {
79
+ plugins: ["jsx", "typescript"],
80
+ },
81
+ filename: id,
82
+ sourceFileName: id,
83
+ };
84
+ const result = transformSync(code, babelOptions);
85
+ if (!result || !result.code) {
86
+ return null;
87
+ }
88
+ return {
89
+ code: result.code,
90
+ map: result.map || null,
91
+ };
92
+ };
93
+ //# sourceMappingURL=transform-data-llm.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"transform-data-llm.js","sourceRoot":"","sources":["../../../../src/web/plugin/transform-data-llm.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,81 @@
1
+ import { describe, expect, it } from "vitest";
2
+ import { transform } from "./transform-data-llm.js";
3
+ describe("data-llm plugin", () => {
4
+ it("should transform JSX element with data-llm string attribute", async () => {
5
+ const code = `
6
+ function Component() {
7
+ return <div data-llm="Test description">Content</div>;
8
+ }
9
+ `;
10
+ const result = await transform(code, "test.tsx");
11
+ expect(result).not.toBeNull();
12
+ expect(result?.code).toContain("DataLLM");
13
+ expect(result?.code).toContain('content="Test description"');
14
+ expect(result?.code).not.toContain("data-llm");
15
+ });
16
+ it("should transform JSX element with data-llm expression attribute", async () => {
17
+ const code = `
18
+ function Component() {
19
+ const desc = "Dynamic description";
20
+ return <div data-llm={desc}>Content</div>;
21
+ }
22
+ `;
23
+ const result = await transform(code, "test.tsx");
24
+ expect(result).not.toBeNull();
25
+ expect(result?.code).toContain("DataLLM");
26
+ expect(result?.code).toContain("content={desc}");
27
+ expect(result?.code).not.toContain("data-llm");
28
+ });
29
+ it("should add import for DataLLM when not present", async () => {
30
+ const code = `
31
+ function Component() {
32
+ return <div data-llm="Test">Content</div>;
33
+ }
34
+ `;
35
+ const result = await transform(code, "test.tsx");
36
+ expect(result).not.toBeNull();
37
+ expect(result?.code).toContain('import { DataLLM } from "skybridge/web"');
38
+ });
39
+ it("should handle DataLLM imports correctly", async () => {
40
+ // No duplicate import
41
+ const codeWithImport = `
42
+ import { DataLLM } from "skybridge/web";
43
+ function Component() {
44
+ return <div data-llm="Test">Content</div>;
45
+ }
46
+ `;
47
+ const result1 = await transform(codeWithImport, "test.tsx");
48
+ expect(result1?.code.match(/import.*DataLLM.*from.*skybridge\/web/g)).toHaveLength(1);
49
+ // Preserve other imports and add missing DataLLM
50
+ const codeWithOthers = `
51
+ import React from "react";
52
+ import { useState } from "react";
53
+ function Component() {
54
+ return <div data-llm="Test">Content</div>;
55
+ }
56
+ `;
57
+ const result2 = await transform(codeWithOthers, "test.tsx");
58
+ expect(result2?.code).toContain('import React from "react"');
59
+ expect(result2?.code).toContain('import { useState } from "react"');
60
+ expect(result2?.code).toContain('import { DataLLM } from "skybridge/web"');
61
+ });
62
+ it("should handle complex JSX with multiple data-llm attributes", async () => {
63
+ const code = `
64
+ function Component() {
65
+ return (
66
+ <div>
67
+ <section data-llm="Section 1">
68
+ <p>Content 1</p>
69
+ </section>
70
+ <section data-llm="Section 2">
71
+ <p>Content 2</p>
72
+ </section>
73
+ </div>
74
+ );
75
+ }
76
+ `;
77
+ const result = await transform(code, "test.tsx");
78
+ expect(result).toMatchSnapshot();
79
+ });
80
+ });
81
+ //# sourceMappingURL=transform-data-llm.test.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"transform-data-llm.test.js","sourceRoot":"","sources":["../../../../src/web/plugin/transform-data-llm.test.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1 @@
1
+ export declare function installOpenAILoggingProxy(): void;
@@ -0,0 +1,48 @@
1
+ const colors = {
2
+ brand: "#6366f1",
3
+ info: "#22223b",
4
+ success: "#22c55e",
5
+ error: "#ef4444",
6
+ };
7
+ export function installOpenAILoggingProxy() {
8
+ if (typeof window === "undefined" || !window.openai) {
9
+ console.warn("[openai-proxy] window.openai not found, skipping proxy installation");
10
+ return;
11
+ }
12
+ const originalOpenAI = window.openai;
13
+ const handler = {
14
+ get(target, prop, receiver) {
15
+ const value = Reflect.get(target, prop, receiver);
16
+ if (typeof value !== "function") {
17
+ return value;
18
+ }
19
+ return (...args) => {
20
+ const methodName = String(prop);
21
+ console.group(`%c[openai] %cmethod %c${methodName}`, `color: ${colors.brand}; font-weight: normal`, `color: ${colors.info}; font-weight: normal`, `color: ${colors.success}`);
22
+ console.log("%c← args:", `color: ${colors.info}`, args);
23
+ const result = value.apply(target, args);
24
+ if (result && typeof result.then === "function") {
25
+ return result.then((resolved) => {
26
+ console.log("%c→ resolved:", `color: ${colors.success}`, resolved);
27
+ console.groupEnd();
28
+ return resolved;
29
+ }, (error) => {
30
+ console.error("%c→ rejected:", `color: ${colors.error}`, error);
31
+ console.groupEnd();
32
+ throw error;
33
+ });
34
+ }
35
+ console.log("%c→ returned:", `color: ${colors.success}`, result);
36
+ console.groupEnd();
37
+ return result;
38
+ };
39
+ },
40
+ set(target, prop, value, receiver) {
41
+ console.log(`%c[openai] %cupdate %c${String(prop)}`, `color: ${colors.brand}`, `color: ${colors.info}`, `color: ${colors.success}; font-weight: bold`, "←", value);
42
+ return Reflect.set(target, prop, value, receiver);
43
+ },
44
+ };
45
+ window.openai = new Proxy(originalOpenAI, handler);
46
+ console.log("%c[openai-proxy] %cInstalled logging proxy for window.openai", `color: ${colors.brand}`, `color: ${colors.info}`);
47
+ }
48
+ //# sourceMappingURL=proxy.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"proxy.js","sourceRoot":"","sources":["../../../src/web/proxy.ts"],"names":[],"mappings":"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"}
@@ -1,14 +1,22 @@
1
- type UnknownObject = Record<string, unknown>;
2
- export type WidgetState = UnknownObject;
3
- export type SetWidgetState = (state: WidgetState) => Promise<void>;
4
- export type SendFollowUpMessage = (args: {
5
- prompt: string;
6
- }) => Promise<void>;
7
- export type RequestDisplayMode = (args: {
8
- mode: DisplayMode;
9
- }) => Promise<{
10
- mode: DisplayMode;
11
- }>;
1
+ import "react";
2
+ declare module "react" {
3
+ interface HTMLAttributes<T> {
4
+ "data-llm"?: string;
5
+ }
6
+ }
7
+ export type UnknownObject = Record<string, unknown>;
8
+ export type Prettify<T> = {
9
+ [K in keyof T]: T[K];
10
+ } & {};
11
+ export type Objectify<T> = T & UnknownObject;
12
+ type RequiredKeys<T> = {
13
+ [K in keyof T]-?: Record<string, never> extends Pick<T, K> ? never : K;
14
+ }[keyof T];
15
+ export type HasRequiredKeys<T> = RequiredKeys<T> extends never ? false : true;
16
+ type WidgetState = UnknownObject;
17
+ type FileMetadata = {
18
+ fileId: string;
19
+ };
12
20
  export declare const TOOL_RESPONSE_EVENT_TYPE = "openai:tool_response";
13
21
  export declare class ToolResponseEvent extends CustomEvent<{
14
22
  tool: {
@@ -20,13 +28,13 @@ export declare class ToolResponseEvent extends CustomEvent<{
20
28
  }
21
29
  declare global {
22
30
  interface Window {
23
- openai: API<WidgetState> & OpenAiGlobals;
31
+ openai: OpenAiMethods<WidgetState> & OpenAiProperties;
24
32
  }
25
33
  interface WindowEventMap {
26
34
  [SET_GLOBALS_EVENT_TYPE]: SetGlobalsEvent;
27
35
  }
28
36
  }
29
- export type OpenAiGlobals<ToolInput extends UnknownObject = UnknownObject, ToolOutput extends UnknownObject = UnknownObject, ToolResponseMetadata extends UnknownObject = UnknownObject, WidgetState extends UnknownObject = UnknownObject> = {
37
+ export type OpenAiProperties<ToolInput extends UnknownObject = Record<never, unknown>, ToolOutput extends UnknownObject = UnknownObject, ToolResponseMetadata extends UnknownObject = UnknownObject, WidgetState extends UnknownObject = UnknownObject> = {
30
38
  theme: Theme;
31
39
  userAgent: UserAgent;
32
40
  locale: string;
@@ -34,22 +42,32 @@ export type OpenAiGlobals<ToolInput extends UnknownObject = UnknownObject, ToolO
34
42
  displayMode: DisplayMode;
35
43
  safeArea: SafeArea;
36
44
  toolInput: ToolInput;
37
- toolOutput: ToolOutput | null;
45
+ toolOutput: ToolOutput | {
46
+ text: string;
47
+ } | null;
38
48
  toolResponseMetadata: ToolResponseMetadata | null;
39
49
  widgetState: WidgetState | null;
40
50
  };
51
+ export type CallToolArgs = Record<string, unknown> | null;
41
52
  export type CallToolResponse = {
53
+ content: {
54
+ type: "text";
55
+ text: string;
56
+ }[];
57
+ structuredContent: Record<string, unknown>;
58
+ isError: boolean;
42
59
  result: string;
60
+ meta: Record<string, unknown>;
43
61
  };
44
- type API<WidgetState extends UnknownObject> = {
62
+ export type OpenAiMethods<WidgetState extends UnknownObject = UnknownObject> = {
45
63
  /** Calls a tool on your MCP. Returns the full response. */
46
- callTool: (name: string, args: Record<string, unknown>) => Promise<CallToolResponse>;
64
+ callTool: <ToolArgs extends CallToolArgs = null, ToolResponse extends CallToolResponse = CallToolResponse>(name: string, args: ToolArgs) => Promise<ToolResponse>;
47
65
  /** Triggers a followup turn in the ChatGPT conversation */
48
66
  sendFollowUpMessage: (args: {
49
67
  prompt: string;
50
68
  }) => Promise<void>;
51
69
  /** Opens an external link, redirects web page or mobile app */
52
- openExternal(payload: {
70
+ openExternal(args: {
53
71
  href: string;
54
72
  }): void;
55
73
  /** For transitioning an app from inline to fullscreen or pip */
@@ -62,11 +80,31 @@ type API<WidgetState extends UnknownObject> = {
62
80
  */
63
81
  mode: DisplayMode;
64
82
  }>;
83
+ /**
84
+ * Sets the widget state.
85
+ * This state is persisted across widget renders.
86
+ */
65
87
  setWidgetState: (state: WidgetState) => Promise<void>;
88
+ /**
89
+ * Opens a modal portaled outside of the widget iFrame.
90
+ * This ensures the modal is correctly displayed and not limited to the widget's area.
91
+ */
92
+ requestModal: (args: {
93
+ title: string;
94
+ }) => Promise<void>;
95
+ /** Uploads a new file to the host */
96
+ uploadFile: (file: File) => Promise<FileMetadata>;
97
+ /**
98
+ * Downloads a file from the host that was previously uploaded.
99
+ * Only files uploaded by the same connector instance can be downloaded.
100
+ */
101
+ downloadFile: (file: FileMetadata) => Promise<{
102
+ downloadUrl: string;
103
+ }>;
66
104
  };
67
105
  export declare const SET_GLOBALS_EVENT_TYPE = "openai:set_globals";
68
106
  export declare class SetGlobalsEvent extends CustomEvent<{
69
- globals: Partial<OpenAiGlobals>;
107
+ globals: Partial<OpenAiProperties>;
70
108
  }> {
71
109
  readonly type = "openai:set_globals";
72
110
  }
@@ -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;
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/web/types.ts"],"names":[],"mappings":"AAYA,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAAsB,CAAC;AAC/D,MAAM,OAAO,iBAAkB,SAAQ,WAErC;IACkB,IAAI,GAAG,wBAAwB,CAAC;CACnD;AA+DD,sDAAsD;AACtD,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAC3D,MAAM,OAAO,eAAgB,SAAQ,WAEnC;IACkB,IAAI,GAAG,sBAAsB,CAAC;CACjD"}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/web/types.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,CAAC;AAuBf,MAAM,CAAC,MAAM,wBAAwB,GAAG,sBAAsB,CAAC;AAC/D,MAAM,OAAO,iBAAkB,SAAQ,WAErC;IACkB,IAAI,GAAG,wBAAwB,CAAC;CACnD;AA8FD,sDAAsD;AACtD,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAC3D,MAAM,OAAO,eAAgB,SAAQ,WAEnC;IACkB,IAAI,GAAG,sBAAsB,CAAC;CACjD"}
@@ -3,7 +3,6 @@ export default defineConfig({
3
3
  test: {
4
4
  environment: "jsdom",
5
5
  globals: true,
6
- setupFiles: ["./src/test/setup.ts"],
7
6
  },
8
7
  });
9
8
  //# sourceMappingURL=vitest.config.js.map
@@ -1 +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;QACb,UAAU,EAAE,CAAC,qBAAqB,CAAC;KACpC;CACF,CAAC,CAAC"}
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.feb36b5",
3
+ "version": "0.0.0",
4
4
  "description": "Skybridge is a framework for building ChatGPT apps",
5
5
  "type": "module",
6
6
  "files": [
@@ -16,11 +16,6 @@
16
16
  "default": "./dist/src/web/index.js"
17
17
  }
18
18
  },
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
19
  "keywords": [
25
20
  "chatgpt",
26
21
  "app",
@@ -30,19 +25,26 @@
30
25
  "author": "Frédéric Barthelet",
31
26
  "license": "ISC",
32
27
  "peerDependencies": {
28
+ "@modelcontextprotocol/sdk": ">=1.0.0",
33
29
  "react": ">=18.0.0",
34
30
  "react-dom": ">=18.0.0"
35
31
  },
36
32
  "dependencies": {
37
- "@modelcontextprotocol/sdk": "^1.20.0",
33
+ "@babel/core": "^7.28.5",
38
34
  "cors": "^2.8.5",
39
35
  "express": "^5.1.0",
40
36
  "handlebars": "^4.7.8",
37
+ "superjson": "^2.2.6",
41
38
  "vite": "^7.1.11",
42
- "zod": "^3.25.51"
39
+ "zustand": "^5.0.9"
43
40
  },
44
41
  "devDependencies": {
42
+ "@biomejs/biome": "2.3.8",
43
+ "@modelcontextprotocol/sdk": "^1.24.3",
44
+ "@testing-library/dom": "^10.4.1",
45
+ "@testing-library/react": "^16.3.0",
45
46
  "@total-typescript/tsconfig": "^1.0.4",
47
+ "@types/babel__core": "^7.20.5",
46
48
  "@types/cors": "^2.8.19",
47
49
  "@types/express": "^5.0.3",
48
50
  "@types/jsdom": "^21.1.6",
@@ -52,7 +54,16 @@
52
54
  "@vitest/ui": "^2.1.8",
53
55
  "jsdom": "^25.0.1",
54
56
  "typescript": "^5.9.3",
55
- "vitest": "^2.1.8"
57
+ "vitest": "^2.1.8",
58
+ "zod": "^4.1.13"
56
59
  },
57
- "packageManager": "pnpm@10.17.1"
58
- }
60
+ "scripts": {
61
+ "build": "tsc && pnpm run build:templates",
62
+ "build:templates": "cp -r src/server/templates dist/src/server/",
63
+ "format": "biome check --write --error-on-warnings",
64
+ "test": "pnpm run test:unit && pnpm run test:type && pnpm run test:format",
65
+ "test:unit": "vitest run",
66
+ "test:type": "tsc --noEmit",
67
+ "test:format": "biome ci"
68
+ }
69
+ }
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,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 +0,0 @@
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,2 +0,0 @@
1
- import { type OpenAiGlobals } from "./types.js";
2
- export declare function useOpenAiGlobal<K extends keyof OpenAiGlobals>(key: K): OpenAiGlobals[K] | undefined;
@@ -1 +0,0 @@
1
- {"version":3,"file":"use-openai-global.js","sourceRoot":"","sources":["../../../src/web/use-openai-global.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAsB,MAAM,YAAY,CAAC;AAEzF,MAAM,UAAU,eAAe,CAAgC,GAAM;IACnE,OAAO,oBAAoB,CACzB,CAAC,QAAQ,EAAE,EAAE;QACX,MAAM,eAAe,GAAG,CAAC,KAAsB,EAAE,EAAE;YACjD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACxC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,OAAO;YACT,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YACvD,QAAQ,EAAE,CAAC;QACb,CAAC,CAAC;QAEF,MAAM,CAAC,gBAAgB,CAAC,sBAAsB,EAAE,eAAe,EAAE;YAC/D,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;QAEH,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,mBAAmB,CAAC,sBAAsB,EAAE,eAAe,CAAC,CAAC;QACtE,CAAC,CAAC;IACJ,CAAC,EACD,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAC3B,CAAC;AACJ,CAAC"}
@@ -1,3 +0,0 @@
1
- export declare function useToolOutput(): {
2
- [x: string]: unknown;
3
- } | null | undefined;
@@ -1,5 +0,0 @@
1
- import { useOpenAiGlobal } from "./use-openai-global.js";
2
- export function useToolOutput() {
3
- return useOpenAiGlobal("toolOutput");
4
- }
5
- //# sourceMappingURL=use-tool-output.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"use-tool-output.js","sourceRoot":"","sources":["../../../src/web/use-tool-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,UAAU,aAAa;IAC3B,OAAO,eAAe,CAAC,YAAY,CAAC,CAAC;AACvC,CAAC"}