skybridge 0.0.0-dev.e3e0986 → 0.0.0-dev.e667e59

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 (71) hide show
  1. package/README.md +62 -11
  2. package/dist/src/server/index.d.ts +2 -2
  3. package/dist/src/server/inferUtilityTypes.d.ts +36 -15
  4. package/dist/src/server/server.d.ts +38 -9
  5. package/dist/src/server/server.js +4 -0
  6. package/dist/src/server/server.js.map +1 -1
  7. package/dist/src/test/utils.d.ts +61 -0
  8. package/dist/src/test/utils.js +121 -0
  9. package/dist/src/test/utils.js.map +1 -1
  10. package/dist/src/web/data-llm.d.ts +13 -0
  11. package/dist/src/web/data-llm.js +67 -0
  12. package/dist/src/web/data-llm.js.map +1 -0
  13. package/dist/src/web/data-llm.test.js +76 -0
  14. package/dist/src/web/data-llm.test.js.map +1 -0
  15. package/dist/src/web/generate-helpers.d.ts +113 -0
  16. package/dist/src/web/generate-helpers.js +109 -0
  17. package/dist/src/web/generate-helpers.js.map +1 -0
  18. package/dist/src/web/generate-helpers.test-d.js +153 -0
  19. package/dist/src/web/generate-helpers.test-d.js.map +1 -0
  20. package/dist/src/web/generate-helpers.test.d.ts +1 -0
  21. package/dist/src/web/generate-helpers.test.js +17 -0
  22. package/dist/src/web/generate-helpers.test.js.map +1 -0
  23. package/dist/src/web/hooks/index.d.ts +1 -3
  24. package/dist/src/web/hooks/index.js +1 -3
  25. package/dist/src/web/hooks/index.js.map +1 -1
  26. package/dist/src/web/hooks/use-call-tool.d.ts +57 -19
  27. package/dist/src/web/hooks/use-call-tool.js +7 -15
  28. package/dist/src/web/hooks/use-call-tool.js.map +1 -1
  29. package/dist/src/web/hooks/use-call-tool.test-d.d.ts +1 -0
  30. package/dist/src/web/hooks/use-call-tool.test-d.js +104 -0
  31. package/dist/src/web/hooks/use-call-tool.test-d.js.map +1 -0
  32. package/dist/src/web/hooks/use-call-tool.test.js +17 -9
  33. package/dist/src/web/hooks/use-call-tool.test.js.map +1 -1
  34. package/dist/src/web/hooks/use-tool-info.d.ts +1 -1
  35. package/dist/src/web/hooks/use-widget-state.js +30 -6
  36. package/dist/src/web/hooks/use-widget-state.js.map +1 -1
  37. package/dist/src/web/index.d.ts +3 -2
  38. package/dist/src/web/index.js +3 -2
  39. package/dist/src/web/index.js.map +1 -1
  40. package/dist/src/web/plugin/data-llm.test.d.ts +1 -0
  41. package/dist/src/web/plugin/data-llm.test.js +81 -0
  42. package/dist/src/web/plugin/data-llm.test.js.map +1 -0
  43. package/dist/src/web/{plugin.js → plugin/plugin.js} +5 -0
  44. package/dist/src/web/plugin/plugin.js.map +1 -0
  45. package/dist/src/web/plugin/transform-data-llm.d.ts +12 -0
  46. package/dist/src/web/plugin/transform-data-llm.js +93 -0
  47. package/dist/src/web/plugin/transform-data-llm.js.map +1 -0
  48. package/dist/src/web/plugin/transform-data-llm.test.d.ts +1 -0
  49. package/dist/src/web/plugin/transform-data-llm.test.js +81 -0
  50. package/dist/src/web/plugin/transform-data-llm.test.js.map +1 -0
  51. package/dist/src/web/types.d.ts +14 -0
  52. package/dist/src/web/types.js +1 -0
  53. package/dist/src/web/types.js.map +1 -1
  54. package/package.json +4 -2
  55. package/dist/src/web/hooks/use-tool-output.d.ts +0 -4
  56. package/dist/src/web/hooks/use-tool-output.js +0 -9
  57. package/dist/src/web/hooks/use-tool-output.js.map +0 -1
  58. package/dist/src/web/hooks/use-tool-response-metadata.d.ts +0 -4
  59. package/dist/src/web/hooks/use-tool-response-metadata.js +0 -8
  60. package/dist/src/web/hooks/use-tool-response-metadata.js.map +0 -1
  61. package/dist/src/web/plugin.js.map +0 -1
  62. package/dist/src/web/typed-hooks.d.ts +0 -61
  63. package/dist/src/web/typed-hooks.js +0 -61
  64. package/dist/src/web/typed-hooks.js.map +0 -1
  65. package/dist/src/web/typed-hooks.test-d.js +0 -72
  66. package/dist/src/web/typed-hooks.test-d.js.map +0 -1
  67. package/dist/src/web/typed-hooks.test.js +0 -10
  68. package/dist/src/web/typed-hooks.test.js.map +0 -1
  69. /package/dist/src/web/{typed-hooks.test-d.d.ts → data-llm.test.d.ts} +0 -0
  70. /package/dist/src/web/{typed-hooks.test.d.ts → generate-helpers.test-d.d.ts} +0 -0
  71. /package/dist/src/web/{plugin.d.ts → plugin/plugin.d.ts} +0 -0
@@ -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":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpD,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,IAAI,GAAG;;;;KAIZ,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAEjD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,SAAS,CAAC,4BAA4B,CAAC,CAAC;QAC7D,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,IAAI,GAAG;;;;;KAKZ,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAEjD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QACjD,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,IAAI,GAAG;;;;KAIZ,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAEjD,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,SAAS,CAAC,yCAAyC,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,sBAAsB;QACtB,MAAM,cAAc,GAAG;;;;;KAKtB,CAAC;QACF,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;QAC5D,MAAM,CACJ,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAC9D,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAElB,iDAAiD;QACjD,MAAM,cAAc,GAAG;;;;;;KAMtB,CAAC;QACF,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;QAC5D,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,SAAS,CAAC,2BAA2B,CAAC,CAAC;QAC7D,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,SAAS,CAAC,kCAAkC,CAAC,CAAC;QACpE,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,SAAS,CAAC,yCAAyC,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6DAA6D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,IAAI,GAAG;;;;;;;;;;;;;KAaZ,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAEjD,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,EAAE,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
@@ -1,4 +1,18 @@
1
+ import "react";
2
+ declare module "react" {
3
+ interface HTMLAttributes<T extends Element = HTMLElement> {
4
+ "data-llm"?: string;
5
+ }
6
+ }
1
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]-?: {} extends Pick<T, K> ? never : K;
14
+ }[keyof T];
15
+ export type HasRequiredKeys<T> = RequiredKeys<T> extends never ? false : true;
2
16
  type WidgetState = UnknownObject;
3
17
  type FileMetadata = {
4
18
  fileId: string;
@@ -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":"AAMA,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"}
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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "skybridge",
3
- "version": "0.0.0-dev.e3e0986",
3
+ "version": "0.0.0-dev.e667e59",
4
4
  "description": "Skybridge is a framework for building ChatGPT apps",
5
5
  "type": "module",
6
6
  "files": [
@@ -20,7 +20,7 @@
20
20
  "build": "tsc && pnpm run build:templates",
21
21
  "build:templates": "cp -r src/server/templates dist/src/server/",
22
22
  "test": "pnpm run test:unit && pnpm run test:type",
23
- "test:unit": "vitest run --silent",
23
+ "test:unit": "vitest run",
24
24
  "test:type": "tsc --noEmit",
25
25
  "docs:dev": "pnpm --filter @skybridge/docs start",
26
26
  "docs:build": "pnpm --filter @skybridge/docs build",
@@ -39,6 +39,7 @@
39
39
  "react-dom": ">=18.0.0"
40
40
  },
41
41
  "dependencies": {
42
+ "@babel/core": "^7.28.5",
42
43
  "@modelcontextprotocol/sdk": "^1.20.0",
43
44
  "cors": "^2.8.5",
44
45
  "express": "^5.1.0",
@@ -50,6 +51,7 @@
50
51
  "@testing-library/dom": "^10.4.1",
51
52
  "@testing-library/react": "^16.3.0",
52
53
  "@total-typescript/tsconfig": "^1.0.4",
54
+ "@types/babel__core": "^7.20.5",
53
55
  "@types/cors": "^2.8.19",
54
56
  "@types/express": "^5.0.3",
55
57
  "@types/jsdom": "^21.1.6",
@@ -1,4 +0,0 @@
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;
@@ -1,9 +0,0 @@
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
@@ -1 +0,0 @@
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"}
@@ -1,4 +0,0 @@
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;
@@ -1,8 +0,0 @@
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
@@ -1 +0,0 @@
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"}
@@ -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,61 +0,0 @@
1
- import { useCallTool } from "./hooks/use-call-tool.js";
2
- import type { ToolPendingState, ToolSuccessState } from "./hooks/use-tool-info.js";
3
- import type { McpServer, InferWidgets, AnyWidgetRegistry, WidgetInput, WidgetOutput } from "../server/index.js";
4
- import type { CallToolArgs, UnknownObject } from "./types.js";
5
- type TypedCallToolReturn<TInput, TOutput> = ReturnType<typeof useCallTool<TInput & CallToolArgs, {
6
- structuredContent: TOutput & UnknownObject;
7
- }>>;
8
- type TypedToolInfoReturn<TInput extends UnknownObject, TOutput extends UnknownObject, TResponseMetadata extends UnknownObject> = ToolPendingState<TInput> | ToolSuccessState<TInput, TOutput, TResponseMetadata>;
9
- /**
10
- * Creates typed versions of skybridge hooks with full type inference
11
- * for tool names, inputs, and outputs.
12
- *
13
- * Set this up once in a dedicated file and export the typed hooks:
14
- *
15
- * @example
16
- * ```typescript
17
- * // web/src/skybridge.ts (one-time setup)
18
- * import type { AppType } from "../server";
19
- * import { createTypedHooks } from "skybridge/web";
20
- *
21
- * export const { useCallTool, useToolInfo } = createTypedHooks<AppType>();
22
- * ```
23
- *
24
- * ```typescript
25
- * // web/src/widgets/search.tsx (usage)
26
- * import { useCallTool, useToolInfo } from "../skybridge";
27
- *
28
- * export function SearchWidget() {
29
- * const { callTool, data } = useCallTool("search");
30
- * // ^ autocomplete for tool names
31
- * callTool({ query: "test" });
32
- * // ^ autocomplete for input fields
33
- *
34
- * const toolInfo = useToolInfo<"search">();
35
- * // ^ autocomplete for tool names
36
- * // toolInfo.input is typed based on widget input schema
37
- * // toolInfo.output is typed based on widget output schema
38
- * }
39
- * ```
40
- */
41
- export declare function createTypedHooks<T extends McpServer<AnyWidgetRegistry>>(): {
42
- /**
43
- * Typed version of useCallTool that provides autocomplete for tool names
44
- * and type inference for inputs and outputs.
45
- */
46
- useCallTool: <K extends keyof InferWidgets<T> & string>(name: K) => TypedCallToolReturn<InferWidgets<T>[K]["input"], InferWidgets<T>[K]["output"]>;
47
- /**
48
- * Typed version of useToolInfo that provides autocomplete for widget names
49
- * and type inference for inputs, outputs, and responseMetadata.
50
- *
51
- * @example
52
- * ```typescript
53
- * const toolInfo = useToolInfo<"search-voyage">();
54
- * // toolInfo.input is typed as { destination: string; ... }
55
- * // toolInfo.output is typed as { results: Array<...>; ... } | undefined
56
- * // toolInfo.status narrows correctly: "pending" | "success"
57
- * ```
58
- */
59
- useToolInfo: <K extends keyof InferWidgets<T> & string>() => TypedToolInfoReturn<WidgetInput<T, K> & UnknownObject, WidgetOutput<T, K> & UnknownObject, UnknownObject>;
60
- };
61
- export {};
@@ -1,61 +0,0 @@
1
- import { useCallTool } from "./hooks/use-call-tool.js";
2
- import { useToolInfo } from "./hooks/use-tool-info.js";
3
- /**
4
- * Creates typed versions of skybridge hooks with full type inference
5
- * for tool names, inputs, and outputs.
6
- *
7
- * Set this up once in a dedicated file and export the typed hooks:
8
- *
9
- * @example
10
- * ```typescript
11
- * // web/src/skybridge.ts (one-time setup)
12
- * import type { AppType } from "../server";
13
- * import { createTypedHooks } from "skybridge/web";
14
- *
15
- * export const { useCallTool, useToolInfo } = createTypedHooks<AppType>();
16
- * ```
17
- *
18
- * ```typescript
19
- * // web/src/widgets/search.tsx (usage)
20
- * import { useCallTool, useToolInfo } from "../skybridge";
21
- *
22
- * export function SearchWidget() {
23
- * const { callTool, data } = useCallTool("search");
24
- * // ^ autocomplete for tool names
25
- * callTool({ query: "test" });
26
- * // ^ autocomplete for input fields
27
- *
28
- * const toolInfo = useToolInfo<"search">();
29
- * // ^ autocomplete for tool names
30
- * // toolInfo.input is typed based on widget input schema
31
- * // toolInfo.output is typed based on widget output schema
32
- * }
33
- * ```
34
- */
35
- export function createTypedHooks() {
36
- return {
37
- /**
38
- * Typed version of useCallTool that provides autocomplete for tool names
39
- * and type inference for inputs and outputs.
40
- */
41
- useCallTool: (name) => {
42
- return useCallTool(name);
43
- },
44
- /**
45
- * Typed version of useToolInfo that provides autocomplete for widget names
46
- * and type inference for inputs, outputs, and responseMetadata.
47
- *
48
- * @example
49
- * ```typescript
50
- * const toolInfo = useToolInfo<"search-voyage">();
51
- * // toolInfo.input is typed as { destination: string; ... }
52
- * // toolInfo.output is typed as { results: Array<...>; ... } | undefined
53
- * // toolInfo.status narrows correctly: "pending" | "success"
54
- * ```
55
- */
56
- useToolInfo: () => {
57
- return useToolInfo();
58
- },
59
- };
60
- }
61
- //# sourceMappingURL=typed-hooks.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"typed-hooks.js","sourceRoot":"","sources":["../../../src/web/typed-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAgCvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,gBAAgB;IAI9B,OAAO;QACL;;;WAGG;QACH,WAAW,EAAE,CACX,IAAO,EAIP,EAAE;YACF,OAAO,WAAW,CAGhB,IAAI,CAGL,CAAC;QACJ,CAAC;QACD;;;;;;;;;;;WAWG;QACH,WAAW,EAAE,GAIX,EAAE;YACF,OAAO,WAAW,EAQjB,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}
@@ -1,72 +0,0 @@
1
- import { expectTypeOf, test } from "vitest";
2
- import { createTypedHooks } from "./typed-hooks.js";
3
- test("InferWidgets extracts the widget registry type", () => {
4
- expectTypeOf().toHaveProperty("search-voyage");
5
- expectTypeOf().toHaveProperty("get-trip-details");
6
- expectTypeOf().toHaveProperty("no-input-widget");
7
- });
8
- test("WidgetNames returns a union of widget name literals", () => {
9
- expectTypeOf().toEqualTypeOf();
10
- });
11
- test("WidgetInput extracts the correct input type from Zod schema", () => {
12
- expectTypeOf().toEqualTypeOf();
13
- expectTypeOf().toEqualTypeOf();
14
- });
15
- test("WidgetOutput extracts the correct output type from Zod schema", () => {
16
- expectTypeOf().toEqualTypeOf();
17
- expectTypeOf().toEqualTypeOf();
18
- });
19
- test("createTypedHooks provides autocomplete for widget names", () => {
20
- const { useCallTool } = createTypedHooks();
21
- useCallTool("search-voyage");
22
- useCallTool("get-trip-details");
23
- useCallTool("no-input-widget");
24
- // @ts-expect-error - "invalid-name" is not a valid widget name
25
- useCallTool("invalid-name");
26
- });
27
- test("useCallTool returns correctly typed callTool function", () => {
28
- const { useCallTool } = createTypedHooks();
29
- const { callTool } = useCallTool("search-voyage");
30
- callTool({ destination: "Spain" });
31
- callTool({ destination: "France", departureDate: "2024-06-01" });
32
- callTool({ destination: "Italy", maxPrice: 1000 });
33
- });
34
- test("useCallTool returns correctly typed data", () => {
35
- const { useCallTool } = createTypedHooks();
36
- const { data } = useCallTool("search-voyage");
37
- if (data) {
38
- expectTypeOf(data.structuredContent).toExtend();
39
- expectTypeOf(data.structuredContent.results).toBeArray();
40
- expectTypeOf(data.structuredContent.totalCount).toBeNumber();
41
- }
42
- });
43
- test("widgets with no outputSchema have empty object output type", () => {
44
- expectTypeOf().toEqualTypeOf();
45
- });
46
- test("createTypedHooks provides autocomplete for widget names in useToolInfo", () => {
47
- const { useToolInfo } = createTypedHooks();
48
- useToolInfo();
49
- useToolInfo();
50
- useToolInfo();
51
- // @ts-expect-error - "invalid-name" is not a valid widget name
52
- useToolInfo();
53
- });
54
- test("useToolInfo infers input types from WidgetInput utility", () => {
55
- const { useToolInfo } = createTypedHooks();
56
- const toolInfo = useToolInfo();
57
- expectTypeOf(toolInfo.input).toExtend();
58
- const detailsInfo = useToolInfo();
59
- expectTypeOf(detailsInfo.input).toExtend();
60
- });
61
- test("useToolInfo infers output types from WidgetOutput utility", () => {
62
- const { useToolInfo } = createTypedHooks();
63
- const toolInfo = useToolInfo();
64
- if (toolInfo.status === "success") {
65
- expectTypeOf(toolInfo.output).toExtend();
66
- }
67
- const detailsInfo = useToolInfo();
68
- if (detailsInfo.status === "success") {
69
- expectTypeOf(detailsInfo.output).toExtend();
70
- }
71
- });
72
- //# sourceMappingURL=typed-hooks.test-d.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"typed-hooks.test-d.js","sourceRoot":"","sources":["../../../src/web/typed-hooks.test-d.ts"],"names":[],"mappings":"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"}
@@ -1,10 +0,0 @@
1
- import { describe, expect, it } from "vitest";
2
- import { createTypedHooks } from "./typed-hooks.js";
3
- describe("createTypedHooks", () => {
4
- it("should return an object with useCallTool hook", () => {
5
- const hooks = createTypedHooks();
6
- expect(hooks).toHaveProperty("useCallTool");
7
- expect(typeof hooks.useCallTool).toBe("function");
8
- });
9
- });
10
- //# sourceMappingURL=typed-hooks.test.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"typed-hooks.test.js","sourceRoot":"","sources":["../../../src/web/typed-hooks.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAYpD,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,KAAK,GAAG,gBAAgB,EAAc,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;QAC5C,MAAM,CAAC,OAAO,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}