skybridge 0.0.0-dev.e0ede01 → 0.0.0-dev.e112094

package/dist/{src/web → web}/generate-helpers.js

@@ -4,7 +4,7 @@ import { useToolInfo } from "./hooks/use-tool-info.js";
  * Creates typed versions of skybridge hooks with full type inference
  * for tool names, inputs, and outputs.
  *
- * This is the recommended way to use skybridge hooks in your widgets.
+ * This is the recommended way to use skybridge hooks in your views.
  * Set this up once in a dedicated file and export the typed hooks for use across your app.
  *
  * @typeParam ServerType - The type of your McpServer instance (use `typeof server`).
@@ -13,11 +13,13 @@ import { useToolInfo } from "./hooks/use-tool-info.js";
  *
  * @example
  * ```typescript
- * // server/src/index.ts
+ * // src/server.ts
  * const server = new McpServer({ name: "my-app", version: "1.0" }, {})
- *   .widget("search-voyage", {}, {
+ *   .registerTool({
+ *     name: "search-trip",
  *     inputSchema: { destination: z.string() },
  *     outputSchema: { results: z.array(z.string()) },
+ *     view: { component: "search-trip", description: "Search trips" },
  *   }, async ({ destination }) => {
  *     return { content: [{ type: "text", text: `Found trips to ${destination}` }] };
  *   });
@@ -27,8 +29,8 @@ import { useToolInfo } from "./hooks/use-tool-info.js";
  *
  * @example
  * ```typescript
- * // web/src/skybridge.ts (one-time setup)
- * import type { AppType } from "../server";
+ * // src/helpers.ts (one-time setup)
+ * import type { AppType } from "./server";
  * import { generateHelpers } from "skybridge/web";
  *
  * export const { useCallTool, useToolInfo } = generateHelpers<AppType>();
@@ -36,19 +38,19 @@ import { useToolInfo } from "./hooks/use-tool-info.js";
  *
  * @example
  * ```typescript
- * // web/src/widgets/search.tsx (usage)
- * import { useCallTool, useToolInfo } from "../skybridge";
+ * // src/views/search.tsx (usage)
+ * import { useCallTool, useToolInfo } from "../helpers";
  *
- * export function SearchWidget() {
- *   const { callTool, data } = useCallTool("search-voyage");
+ * export function SearchView() {
+ *   const { callTool, data } = useCallTool("search-trip");
  *   //                                      ^ autocomplete for tool names
  *   callTool({ destination: "Spain" });
  *   //         ^ autocomplete for input fields
  *
- *   const toolInfo = useToolInfo<"search-voyage">();
- *   //                              ^ autocomplete for widget names
- *   // toolInfo.input is typed based on widget input schema
- *   // toolInfo.output.structuredContent is typed based on widget output schema
+ *   const toolInfo = useToolInfo<"search-trip">();
+ *   //                              ^ autocomplete for view names
+ *   // toolInfo.input is typed based on view input schema
+ *   // toolInfo.output.structuredContent is typed based on view output schema
  * }
  * ```
  */
@@ -58,12 +60,12 @@ export function generateHelpers() {
          * Typed version of `useCallTool` that provides autocomplete for tool names
          * and type inference for inputs and outputs.
          *
-         * @param name - The name of the widget to call. Autocompletes based on your server's widget registry.
+         * @param name - The name of the tool to call. Autocompletes based on your server's tool registry.
          * @returns A hook with typed `callTool` function and `data` property.
          *
          * @example
          * ```typescript
-         * const { callTool, data, isPending } = useCallTool("search-voyage");
+         * const { callTool, data, isPending } = useCallTool("search-trip");
          * // TypeScript knows callTool expects { destination: string }
          * callTool({ destination: "Spain" });
          *
@@ -77,27 +79,29 @@ export function generateHelpers() {
             return useCallTool(name);
         },
         /**
-         * Typed version of `useToolInfo` that provides autocomplete for widget names
+         * Typed version of `useToolInfo` that provides autocomplete for tool names
          * and type inference for inputs, outputs, and responseMetadata.
          *
-         * @typeParam K - The name of the widget. Autocompletes based on your server's widget registry.
+         * @typeParam K - The name of the tool. Autocompletes based on your server's tool registry.
          * @returns A discriminated union with `status: "pending" | "success"` that narrows correctly.
          *
          * @example
          * ```typescript
-         * const toolInfo = useToolInfo<"search-voyage">();
+         * const toolInfo = useToolInfo<"search-trip">();
          * // toolInfo.input is typed as { destination: string; ... }
          * // toolInfo.output is typed as { results: Array<...>; ... }
+         * // toolInfo.responseMetadata is typed based on _meta in callback return
          * // toolInfo.status narrows correctly: "pending" | "success"
          *
          * if (toolInfo.isPending) {
-         *   // TypeScript knows output is undefined here
+         *   // TypeScript knows output and responseMetadata are undefined here
          *   console.log(toolInfo.input.destination);
          * }
          *
          * if (toolInfo.isSuccess) {
-         *   // TypeScript knows output is defined here
+         *   // TypeScript knows output and responseMetadata are defined here
          *   console.log(toolInfo.output.results);
+         *   console.log(toolInfo.responseMetadata);
          * }
          * ```
          */

package/dist/web/generate-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-helpers.js","sourceRoot":"","sources":["../../src/web/generate-helpers.ts"],"names":[],"mappings":"AAOA,OAAO,EAIL,WAAW,GACZ,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAkB,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAoBvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,MAAM,UAAU,eAAe;IAI7B,OAAO;QACL;;;;;;;;;;;;;;;;;;WAkBG;QACH,WAAW,EAAE,CACX,IAAc,EAId,EAAE;YACF,OAAO,WAAW,CAAC,IAAI,CAGtB,CAAC;QACJ,CAAC;QAED;;;;;;;;;;;;;;;;;;;;;;;;;;WA0BG;QACH,WAAW,EAAE,GAIX,EAAE;YACF,OAAO,WAAW,EAIjB,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/{src/web → web}/generate-helpers.test-d.js

@@ -1,16 +1,20 @@
 import { expectTypeOf, test } from "vitest";
+import { createInterfaceTestServer, createTestServer } from "../test/utils.js";
 import { generateHelpers } from "./generate-helpers.js";
-import { createTestServer } from "../test/utils.js";
 const server = createTestServer();
-test("InferTools extracts the tool registry type (widgets + registerTool)", () => {
-    expectTypeOf().toHaveProperty("search-voyage");
+const interfaceServer = createInterfaceTestServer();
+test("InferTools extracts the tool registry type (views + registerTool)", () => {
+    expectTypeOf().toHaveProperty("search-trip");
     expectTypeOf().toHaveProperty("get-trip-details");
-    expectTypeOf().toHaveProperty("no-input-widget");
+    expectTypeOf().toHaveProperty("no-input-view");
     expectTypeOf().toHaveProperty("calculate-price");
-    expectTypeOf().toHaveProperty("inferred-output-widget");
+    expectTypeOf().toHaveProperty("inferred-output-view");
     expectTypeOf().toHaveProperty("inferred-tool");
+    expectTypeOf().toHaveProperty("view-with-metadata");
+    expectTypeOf().toHaveProperty("tool-with-metadata");
+    expectTypeOf().toHaveProperty("view-with-mixed-returns");
 });
-test("ToolNames returns a union of tool name literals (widgets + registerTool)", () => {
+test("ToolNames returns a union of tool name literals (views + registerTool)", () => {
     expectTypeOf().toEqualTypeOf();
 });
 test("ToolInput extracts the correct input type from Zod schema", () => {
@@ -28,20 +32,23 @@ test("ToolOutput extracts the correct output type from callback (inferred)", ()
     expectTypeOf().toEqualTypeOf();
     expectTypeOf().toEqualTypeOf();
 });
-test("generateHelpers provides autocomplete for tool names (widgets + registerTool)", () => {
+test("generateHelpers provides autocomplete for tool names (views + registerTool)", () => {
     const { useCallTool } = generateHelpers();
-    useCallTool("search-voyage");
+    useCallTool("search-trip");
     useCallTool("get-trip-details");
-    useCallTool("no-input-widget");
+    useCallTool("no-input-view");
     useCallTool("calculate-price");
-    useCallTool("inferred-output-widget");
+    useCallTool("inferred-output-view");
     useCallTool("inferred-tool");
+    useCallTool("view-with-metadata");
+    useCallTool("tool-with-metadata");
+    useCallTool("view-with-mixed-returns");
     // @ts-expect-error - "invalid-name" is not a valid tool name
     useCallTool("invalid-name");
 });
 test("useCallTool returns correctly typed callTool function", () => {
     const { useCallTool } = generateHelpers();
-    const { callTool } = useCallTool("search-voyage");
+    const { callTool } = useCallTool("search-trip");
     callTool({ destination: "Spain" });
     callTool({ destination: "France", departureDate: "2024-06-01" });
     callTool({ destination: "Italy", maxPrice: 1000 });
@@ -50,7 +57,7 @@ test("useCallTool returns correctly typed callTool function", () => {
 });
 test("callTool can be called without args for tools with no required inputs", () => {
     const { useCallTool } = generateHelpers();
-    const { callTool, callToolAsync } = useCallTool("no-input-widget");
+    const { callTool, callToolAsync } = useCallTool("no-input-view");
     callTool();
     callTool({});
     callToolAsync();
@@ -58,7 +65,7 @@ test("callTool can be called without args for tools with no required inputs", ()
 });
 test("callTool requires args for tools with required inputs", () => {
     const { useCallTool } = generateHelpers();
-    const { callTool } = useCallTool("search-voyage");
+    const { callTool } = useCallTool("search-trip");
     // @ts-expect-error - "destination" is required
     callTool();
     // @ts-expect-error - "destination" is required
@@ -68,7 +75,7 @@ test("callTool requires args for tools with required inputs", () => {
 });
 test("callTool supports sideEffects for tools with required inputs", () => {
     const { useCallTool } = generateHelpers();
-    const { callTool, data } = useCallTool("search-voyage");
+    const { callTool } = useCallTool("search-trip");
     callTool({ destination: "Spain" }, {
         onSuccess: (response, args) => {
             expectTypeOf(response.structuredContent.results).toBeArray();
@@ -82,13 +89,14 @@ test("callTool supports sideEffects for tools with required inputs", () => {
             if (response) {
                 expectTypeOf(response.structuredContent.totalCount).toBeNumber();
             }
+            expectTypeOf(error).toBeUnknown();
             expectTypeOf(args.destination).toBeString();
         },
     });
 });
 test("callTool supports sideEffects for tools with no required inputs", () => {
     const { useCallTool } = generateHelpers();
-    const { callTool } = useCallTool("no-input-widget");
+    const { callTool } = useCallTool("no-input-view");
     callTool({
         onSuccess: (response) => {
             expectTypeOf(response).toHaveProperty("structuredContent");
@@ -102,16 +110,16 @@ test("callTool supports sideEffects for tools with no required inputs", () => {
 });
 test("callToolAsync returns correctly typed promise", () => {
     const { useCallTool } = generateHelpers();
-    const { callToolAsync: searchAsync } = useCallTool("search-voyage");
+    const { callToolAsync: searchAsync } = useCallTool("search-trip");
     const searchPromise = searchAsync({ destination: "Spain" });
     expectTypeOf(searchPromise).resolves.toHaveProperty("structuredContent");
-    const { callToolAsync: noInputAsync } = useCallTool("no-input-widget");
+    const { callToolAsync: noInputAsync } = useCallTool("no-input-view");
     const noInputPromise = noInputAsync();
     expectTypeOf(noInputPromise).resolves.toHaveProperty("structuredContent");
 });
 test("useCallTool returns correctly typed data", () => {
     const { useCallTool } = generateHelpers();
-    const { data } = useCallTool("search-voyage");
+    const { data } = useCallTool("search-trip");
     if (data) {
         expectTypeOf(data.structuredContent).toExtend();
         expectTypeOf(data.structuredContent.results).toBeArray();
@@ -120,16 +128,16 @@ test("useCallTool returns correctly typed data", () => {
 });
 test("useCallTool returns correctly typed data for callback-inferred outputs", () => {
     const { useCallTool } = generateHelpers();
-    const { data: widgetData } = useCallTool("inferred-output-widget");
-    if (widgetData) {
-        expectTypeOf(widgetData.structuredContent).toExtend();
+    const { data: viewData } = useCallTool("inferred-output-view");
+    if (viewData) {
+        expectTypeOf(viewData.structuredContent).toExtend();
     }
     const { data: toolData } = useCallTool("inferred-tool");
     if (toolData) {
         expectTypeOf(toolData.structuredContent).toExtend();
     }
 });
-test("generateHelpers provides autocomplete for tool names in useToolInfo (widgets + registerTool)", () => {
+test("generateHelpers provides autocomplete for tool names in useToolInfo (views + registerTool)", () => {
     const { useToolInfo } = generateHelpers();
     useToolInfo();
     useToolInfo();
@@ -137,17 +145,65 @@ test("generateHelpers provides autocomplete for tool names in useToolInfo (widge
     useToolInfo();
     useToolInfo();
     useToolInfo();
+    useToolInfo();
+    useToolInfo();
+    useToolInfo();
     // @ts-expect-error - "invalid-name" is not a valid tool name
     useToolInfo();
 });
 test("useToolInfo infers input and output types", () => {
     const { useToolInfo } = generateHelpers();
     const toolInfo = useToolInfo();
-    expectTypeOf(toolInfo.input).toExtend();
+    // Input is only available when not in idle state
+    if (!(toolInfo.status === "idle")) {
+        expectTypeOf(toolInfo.input).toExtend();
+    }
     if (toolInfo.status === "success") {
         expectTypeOf(toolInfo.output).toExtend();
         expectTypeOf(toolInfo.output.results).toBeArray();
         expectTypeOf(toolInfo.output.totalCount).toBeNumber();
     }
 });
+test("ToolResponseMetadata extracts _meta type from callback", () => {
+    expectTypeOf().toEqualTypeOf();
+    expectTypeOf().toEqualTypeOf();
+    expectTypeOf().toBeUnknown();
+});
+test("useToolInfo infers responseMetadata type from generateHelpers", () => {
+    const { useToolInfo } = generateHelpers();
+    const toolInfo = useToolInfo();
+    if (toolInfo.isSuccess) {
+        expectTypeOf(toolInfo.responseMetadata.requestId).toBeString();
+        expectTypeOf(toolInfo.responseMetadata.timestamp).toBeNumber();
+        expectTypeOf(toolInfo.responseMetadata.cached).toBeBoolean();
+    }
+});
+test("ToolResponseMetadata extracts _meta from mixed return paths", () => {
+    expectTypeOf().toEqualTypeOf();
+});
+test("ToolOutput extracts correct type when using interface declaration", () => {
+    expectTypeOf().toHaveProperty("itemName");
+    expectTypeOf().toBeString();
+    expectTypeOf().toBeNumber();
+});
+test("ToolResponseMetadata extracts correct type when using interface declaration", () => {
+    expectTypeOf().toHaveProperty("processedBy");
+    expectTypeOf().toBeString();
+    expectTypeOf().toBeNumber();
+});
+test("generateHelpers works with interface-typed server", () => {
+    const { useCallTool, useToolInfo } = generateHelpers();
+    const { data } = useCallTool("interface-view");
+    if (data) {
+        expectTypeOf(data.structuredContent.itemName).toBeString();
+        expectTypeOf(data.structuredContent.quantity).toBeNumber();
+    }
+    const toolInfo = useToolInfo();
+    if (toolInfo.isSuccess) {
+        expectTypeOf(toolInfo.output.itemName).toBeString();
+        expectTypeOf(toolInfo.output.quantity).toBeNumber();
+        expectTypeOf(toolInfo.responseMetadata.processedBy).toBeString();
+        expectTypeOf(toolInfo.responseMetadata.version).toBeNumber();
+    }
+});
 //# sourceMappingURL=generate-helpers.test-d.js.map

package/dist/web/generate-helpers.test-d.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-helpers.test-d.js","sourceRoot":"","sources":["../../src/web/generate-helpers.test-d.ts"],"names":[],"mappings":"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"}

package/dist/{src/web → web}/generate-helpers.test.js

@@ -1,6 +1,6 @@
 import { describe, expect, it } from "vitest";
-import { generateHelpers } from "./generate-helpers.js";
 import { createMinimalTestServer } from "../test/utils.js";
+import { generateHelpers } from "./generate-helpers.js";
 const server = createMinimalTestServer();
 describe("generateHelpers", () => {
     it("should return an object with useCallTool hook", () => {

package/dist/web/generate-helpers.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-helpers.test.js","sourceRoot":"","sources":["../../src/web/generate-helpers.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,MAAM,GAAG,uBAAuB,EAAE,CAAC;AAGzC,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,KAAK,GAAG,eAAe,EAAc,CAAC;QAC5C,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;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,KAAK,GAAG,eAAe,EAAc,CAAC;QAC5C,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"}

package/dist/web/helpers/state.d.ts

@@ -0,0 +1,7 @@
+import { type SuperJSONResult } from "superjson";
+import type { UnknownObject } from "../types.js";
+export declare function filterViewContext<T extends UnknownObject>(state?: T | null): T | null;
+export declare function injectViewContext<T extends UnknownObject>(newState: T | null): T | null;
+export declare function serializeState(value: UnknownObject): unknown;
+export declare function deserializeState(value: SuperJSONResult): unknown;
+export declare function getInitialState<State extends UnknownObject>(defaultState?: State | (() => State)): State | null;

package/dist/web/helpers/state.js

@@ -0,0 +1,45 @@
+import superjson, {} from "superjson";
+import { getAdaptor } from "../bridges/index.js";
+import { VIEW_CONTEXT_KEY } from "../data-llm.js";
+export function filterViewContext(state) {
+    if (state === null || state === undefined) {
+        return null;
+    }
+    const { [VIEW_CONTEXT_KEY]: _, ...filteredState } = state;
+    return filteredState;
+}
+export function injectViewContext(newState) {
+    if (newState === null) {
+        return null;
+    }
+    const currentState = getAdaptor()
+        .getHostContextStore("viewState")
+        .getSnapshot();
+    if (currentState !== null &&
+        currentState !== undefined &&
+        VIEW_CONTEXT_KEY in currentState) {
+        return {
+            ...newState,
+            [VIEW_CONTEXT_KEY]: currentState[VIEW_CONTEXT_KEY],
+        };
+    }
+    return newState;
+}
+export function serializeState(value) {
+    return superjson.parse(superjson.stringify(value)); // Strips functions
+}
+export function deserializeState(value) {
+    return superjson.deserialize(value);
+}
+export function getInitialState(defaultState) {
+    const viewState = getAdaptor()
+        .getHostContextStore("viewState")
+        .getSnapshot();
+    if (viewState !== null && viewState !== undefined) {
+        return filterViewContext(viewState);
+    }
+    return typeof defaultState === "function"
+        ? defaultState()
+        : (defaultState ?? null);
+}
+//# sourceMappingURL=state.js.map

package/dist/web/helpers/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/web/helpers/state.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,EAAE,EAAwB,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGlD,MAAM,UAAU,iBAAiB,CAC/B,KAAgB;IAEhB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC,EAAE,GAAG,aAAa,EAAE,GAAG,KAEnD,CAAC;IAEF,OAAO,aAAkB,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,QAAkB;IAElB,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,UAAU,EAAE;SAC9B,mBAAmB,CAAC,WAAW,CAAC;SAChC,WAAW,EAAmD,CAAC;IAElE,IACE,YAAY,KAAK,IAAI;QACrB,YAAY,KAAK,SAAS;QAC1B,gBAAgB,IAAI,YAAY,EAChC,CAAC;QACD,OAAO;YACL,GAAG,QAAQ;YACX,CAAC,gBAAgB,CAAC,EAAE,YAAY,CAAC,gBAAgB,CAAC;SAC9C,CAAC;IACT,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAoB;IACjD,OAAO,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB;AACzE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAsB;IACrD,OAAO,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,YAAoC;IAEpC,MAAM,SAAS,GAAG,UAAU,EAAE;SAC3B,mBAAmB,CAAC,WAAW,CAAC;SAChC,WAAW,EAAkB,CAAC;IAEjC,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAClD,OAAO,iBAAiB,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,OAAO,YAAY,KAAK,UAAU;QACvC,CAAC,CAAC,YAAY,EAAE;QAChB,CAAC,CAAC,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/web/helpers/state.test.js

@@ -0,0 +1,53 @@
+import { describe, expect, it } from "vitest";
+import { VIEW_CONTEXT_KEY } from "../data-llm.js";
+import { filterViewContext, serializeState } from "./state.js";
+describe("state helpers", () => {
+    describe("filterViewContext", () => {
+        it("should return null when state is null", () => {
+            expect(filterViewContext(null)).toBe(null);
+        });
+        it("should return null when state is undefined", () => {
+            expect(filterViewContext(undefined)).toBe(null);
+        });
+        it("should correctly filter VIEW_CONTEXT_KEY and preserve other properties", () => {
+            const stateWithContextAndOthers = {
+                a: 1,
+                b: "two",
+                c: { nested: true },
+                [VIEW_CONTEXT_KEY]: "context",
+            };
+            const filteredWithContextAndOthers = filterViewContext(stateWithContextAndOthers);
+            expect(filteredWithContextAndOthers).toEqual({
+                a: 1,
+                b: "two",
+                c: { nested: true },
+            });
+            const stateNoContext = { count: 5, name: "test" };
+            const filteredNoContext = filterViewContext(stateNoContext);
+            expect(filteredNoContext).toEqual(stateNoContext);
+        });
+    });
+    describe("serializeState", () => {
+        it("should serialize plain objects", () => {
+            const array = [1, "two", { three: 3 }];
+            const date = new Date("2023-01-01T00:00:00Z");
+            const object = {
+                a: 1,
+                b: "test",
+                c: true,
+                array,
+                date,
+                function: () => "test",
+            };
+            const result = serializeState(object);
+            expect(result).toEqual({
+                a: 1,
+                b: "test",
+                c: true,
+                array: [1, "two", { three: 3 }],
+                date: new Date("2023-01-01T00:00:00.000Z"),
+            });
+        });
+    });
+});
+//# sourceMappingURL=state.test.js.map

package/dist/web/helpers/state.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.test.js","sourceRoot":"","sources":["../../../src/web/helpers/state.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE/D,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;QACjC,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;YACpD,MAAM,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;YAChF,MAAM,yBAAyB,GAAG;gBAChC,CAAC,EAAE,CAAC;gBACJ,CAAC,EAAE,KAAK;gBACR,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;gBACnB,CAAC,gBAAgB,CAAC,EAAE,SAAS;aAC9B,CAAC;YACF,MAAM,4BAA4B,GAAG,iBAAiB,CACpD,yBAAyB,CAC1B,CAAC;YACF,MAAM,CAAC,4BAA4B,CAAC,CAAC,OAAO,CAAC;gBAC3C,CAAC,EAAE,CAAC;gBACJ,CAAC,EAAE,KAAK;gBACR,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;aACpB,CAAC,CAAC;YAEH,MAAM,cAAc,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;YAClD,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,cAAc,CAAC,CAAC;YAC5D,MAAM,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;YACxC,MAAM,KAAK,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;YACvC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,sBAAsB,CAAC,CAAC;YAC9C,MAAM,MAAM,GAAG;gBACb,CAAC,EAAE,CAAC;gBACJ,CAAC,EAAE,MAAM;gBACT,CAAC,EAAE,IAAI;gBACP,KAAK;gBACL,IAAI;gBACJ,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM;aACvB,CAAC;YACF,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;YAEtC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;gBACrB,CAAC,EAAE,CAAC;gBACJ,CAAC,EAAE,MAAM;gBACT,CAAC,EAAE,IAAI;gBACP,KAAK,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;gBAC/B,IAAI,EAAE,IAAI,IAAI,CAAC,0BAA0B,CAAC;aAC3C,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/web/hooks/index.d.ts

@@ -0,0 +1,11 @@
+export { type CallToolAsyncFn, type CallToolFn, type CallToolState, type SideEffects, useCallTool, } from "./use-call-tool.js";
+export { useDisplayMode } from "./use-display-mode.js";
+export { useFiles } from "./use-files.js";
+export { type LayoutState, useLayout } from "./use-layout.js";
+export { type OpenExternalFn, useOpenExternal } from "./use-open-external.js";
+export { useRequestModal } from "./use-request-modal.js";
+export { useSendFollowUpMessage } from "./use-send-follow-up-message.js";
+export { useSetOpenInAppUrl } from "./use-set-open-in-app-url.js";
+export { useToolInfo } from "./use-tool-info.js";
+export { type UserState, useUser } from "./use-user.js";
+export { useViewState } from "./use-view-state.js";

package/dist/{src/web → web}/hooks/index.js

@@ -1,13 +1,12 @@
 export { useCallTool, } from "./use-call-tool.js";
 export { useDisplayMode } from "./use-display-mode.js";
 export { useFiles } from "./use-files.js";
-export { useLocale } from "./use-locale.js";
-export { useOpenAiGlobal } from "./use-openai-global.js";
+export { useLayout } from "./use-layout.js";
 export { useOpenExternal } from "./use-open-external.js";
 export { useRequestModal } from "./use-request-modal.js";
 export { useSendFollowUpMessage } from "./use-send-follow-up-message.js";
-export { useTheme } from "./use-theme.js";
+export { useSetOpenInAppUrl } from "./use-set-open-in-app-url.js";
 export { useToolInfo } from "./use-tool-info.js";
-export { useUserAgent } from "./use-user-agent.js";
-export { useWidgetState } from "./use-widget-state.js";
+export { useUser } from "./use-user.js";
+export { useViewState } from "./use-view-state.js";
 //# sourceMappingURL=index.js.map

package/dist/web/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/web/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAoB,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAuB,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAkB,OAAO,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/web/hooks/test/utils.d.ts

@@ -0,0 +1,16 @@
+import type { McpUiHostContext, McpUiToolResultNotification } from "@modelcontextprotocol/ext-apps";
+export declare class MockResizeObserver {
+    observe(): void;
+    unobserve(): void;
+    disconnect(): void;
+}
+export declare const getMcpAppHostPostMessageMock: (initialContext?: McpUiHostContext) => import("vitest").Mock<(message: {
+    method: string;
+    id: number;
+}) => void>;
+export declare const fireToolInputNotification: (args: Record<string, unknown>) => void;
+export declare const fireToolResultNotification: (params: {
+    content: McpUiToolResultNotification["params"]["content"];
+    structuredContent: Record<string, unknown>;
+    _meta?: Record<string, unknown>;
+}) => void;

package/dist/web/hooks/test/utils.js

@@ -0,0 +1,64 @@
+import { fireEvent } from "@testing-library/react";
+import { act } from "react";
+import { vi } from "vitest";
+export class MockResizeObserver {
+    observe() { }
+    unobserve() { }
+    disconnect() { }
+}
+const DEFAULT_CONTEXT = {};
+export const getMcpAppHostPostMessageMock = (initialContext = DEFAULT_CONTEXT) => vi.fn((message) => {
+    switch (message.method) {
+        case "ui/initialize": {
+            const result = {
+                protocolVersion: "2025-06-18",
+                hostInfo: { name: "test-host", version: "1.0.0" },
+                hostCapabilities: {},
+                hostContext: initialContext,
+            };
+            act(() => fireEvent(window, new MessageEvent("message", {
+                source: window.parent,
+                data: {
+                    jsonrpc: "2.0",
+                    id: message.id,
+                    result,
+                },
+            })));
+            break;
+        }
+        case "ui/update-model-context": {
+            act(() => fireEvent(window, new MessageEvent("message", {
+                source: window.parent,
+                data: {
+                    jsonrpc: "2.0",
+                    id: message.id,
+                    result: {},
+                },
+            })));
+            break;
+        }
+    }
+});
+export const fireToolInputNotification = (args) => {
+    fireEvent(window, new MessageEvent("message", {
+        source: window.parent,
+        data: {
+            jsonrpc: "2.0",
+            method: "ui/notifications/tool-input",
+            params: {
+                arguments: args,
+            },
+        },
+    }));
+};
+export const fireToolResultNotification = (params) => {
+    fireEvent(window, new MessageEvent("message", {
+        source: window.parent,
+        data: {
+            jsonrpc: "2.0",
+            method: "ui/notifications/tool-result",
+            params,
+        },
+    }));
+};
+//# sourceMappingURL=utils.js.map

package/dist/web/hooks/test/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../src/web/hooks/test/utils.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE5B,MAAM,OAAO,kBAAkB;IAC7B,OAAO,KAAU,CAAC;IAClB,SAAS,KAAU,CAAC;IACpB,UAAU,KAAU,CAAC;CACtB;AAED,MAAM,eAAe,GAAqB,EAAE,CAAC;AAE7C,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAC1C,iBAAmC,eAAe,EAClD,EAAE,CACF,EAAE,CAAC,EAAE,CAAC,CAAC,OAAuC,EAAE,EAAE;IAChD,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;QACvB,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,MAAM,GAA0B;gBACpC,eAAe,EAAE,YAAY;gBAC7B,QAAQ,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE;gBACjD,gBAAgB,EAAE,EAAE;gBACpB,WAAW,EAAE,cAAc;aAC5B,CAAC;YACF,GAAG,CAAC,GAAG,EAAE,CACP,SAAS,CACP,MAAM,EACN,IAAI,YAAY,CAIb,SAAS,EAAE;gBACZ,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,IAAI,EAAE;oBACJ,OAAO,EAAE,KAAK;oBACd,EAAE,EAAE,OAAO,CAAC,EAAE;oBACd,MAAM;iBACP;aACF,CAAC,CACH,CACF,CAAC;YACF,MAAM;QACR,CAAC;QACD,KAAK,yBAAyB,CAAC,CAAC,CAAC;YAC/B,GAAG,CAAC,GAAG,EAAE,CACP,SAAS,CACP,MAAM,EACN,IAAI,YAAY,CACd,SAAS,EACT;gBACE,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,IAAI,EAAE;oBACJ,OAAO,EAAE,KAAK;oBACd,EAAE,EAAE,OAAO,CAAC,EAAE;oBACd,MAAM,EAAE,EAAE;iBACX;aACF,CACF,CACF,CACF,CAAC;YACF,MAAM;QACR,CAAC;IACH,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,IAA6B,EAAE,EAAE;IACzE,SAAS,CACP,MAAM,EACN,IAAI,YAAY,CACd,SAAS,EACT;QACE,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,IAAI,EAAE;YACJ,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,6BAA6B;YACrC,MAAM,EAAE;gBACN,SAAS,EAAE,IAAI;aAChB;SACF;KACF,CACF,CACF,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,MAI1C,EAAE,EAAE;IACH,SAAS,CACP,MAAM,EACN,IAAI,YAAY,CACd,SAAS,EACT;QACE,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,IAAI,EAAE;YACJ,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,8BAA8B;YACtC,MAAM;SACP;KACF,CACF,CACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/{src/web → web}/hooks/use-call-tool.d.ts

@@ -1,4 +1,5 @@
-import type { CallToolArgs, CallToolResponse, HasRequiredKeys } from "../types.js";
+import { type CallToolArgs, type CallToolResponse } from "../bridges/index.js";
+import type { HasRequiredKeys } from "../types.js";
 type CallToolIdleState = {
     status: "idle";
     isIdle: true;
@@ -56,7 +57,7 @@ export type CallToolAsyncFn<TArgs, TResponse> = IsArgsOptional<TArgs> extends tr
     (args: TArgs): Promise<TResponse>;
 } : (args: TArgs) => Promise<TResponse>;
 type ToolResponseSignature = Pick<CallToolResponse, "structuredContent" | "meta">;
-export declare const useCallTool: <ToolArgs extends CallToolArgs = null, ToolResponse extends Partial<ToolResponseSignature> = {}>(name: string) => {
+export declare const useCallTool: <ToolArgs extends CallToolArgs = null, ToolResponse extends Partial<ToolResponseSignature> = Record<string, never>>(name: string) => {
     callTool: CallToolFn<ToolArgs, CallToolResponse & ToolResponse>;
     callToolAsync: CallToolAsyncFn<ToolArgs, CallToolResponse & ToolResponse>;
     status: "idle";