skybridge 2.0.3 → 2.1.0

package/dist/web/hooks/use-open-file.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Ask ChatGPT to open a local file by its absolute path, through the OpenAI
+ * MCP extensions (`openai/files/open`). ChatGPT desktop only, with a path on
+ * the machine that runs ChatGPT, which shows the file in its built-in viewer
+ * rather than in the app's own file entrypoint. Rejects with `NotSupportedError` on
+ * hosts that don't advertise `openai/files`: check `useHost().openaiCapabilities.files`
+ * before showing the control.
+ *
+ * @example
+ * ```tsx
+ * const { openaiCapabilities } = useHost();
+ * const openFile = useOpenFile();
+ * if (openaiCapabilities.files) {
+ *   return <button onClick={() => openFile(part.path)}>Open in ChatGPT</button>;
+ * }
+ * ```
+ *
+ * @see https://docs.skybridge.tech/api-reference/use-open-file
+ */
+export declare function useOpenFile(): (path: string) => Promise<void>;

package/dist/web/hooks/use-open-file.js

@@ -0,0 +1,25 @@
+import { useCallback } from "react";
+import { getAdaptor } from "../bridges/index.js";
+/**
+ * Ask ChatGPT to open a local file by its absolute path, through the OpenAI
+ * MCP extensions (`openai/files/open`). ChatGPT desktop only, with a path on
+ * the machine that runs ChatGPT, which shows the file in its built-in viewer
+ * rather than in the app's own file entrypoint. Rejects with `NotSupportedError` on
+ * hosts that don't advertise `openai/files`: check `useHost().openaiCapabilities.files`
+ * before showing the control.
+ *
+ * @example
+ * ```tsx
+ * const { openaiCapabilities } = useHost();
+ * const openFile = useOpenFile();
+ * if (openaiCapabilities.files) {
+ *   return <button onClick={() => openFile(part.path)}>Open in ChatGPT</button>;
+ * }
+ * ```
+ *
+ * @see https://docs.skybridge.tech/api-reference/use-open-file
+ */
+export function useOpenFile() {
+    return useCallback((path) => getAdaptor().openFile(path), []);
+}
+//# sourceMappingURL=use-open-file.js.map

package/dist/web/hooks/use-open-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-open-file.js","sourceRoot":"","sources":["../../../src/web/hooks/use-open-file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,WAAW,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;AACxE,CAAC","sourcesContent":["import { useCallback } from \"react\";\nimport { getAdaptor } from \"../bridges/index.js\";\n\n/**\n * Ask ChatGPT to open a local file by its absolute path, through the OpenAI\n * MCP extensions (`openai/files/open`). ChatGPT desktop only, with a path on\n * the machine that runs ChatGPT, which shows the file in its built-in viewer\n * rather than in the app's own file entrypoint. Rejects with `NotSupportedError` on\n * hosts that don't advertise `openai/files`: check `useHost().openaiCapabilities.files`\n * before showing the control.\n *\n * @example\n * ```tsx\n * const { openaiCapabilities } = useHost();\n * const openFile = useOpenFile();\n * if (openaiCapabilities.files) {\n *   return <button onClick={() => openFile(part.path)}>Open in ChatGPT</button>;\n * }\n * ```\n *\n * @see https://docs.skybridge.tech/api-reference/use-open-file\n */\nexport function useOpenFile(): (path: string) => Promise<void> {\n  return useCallback((path: string) => getAdaptor().openFile(path), []);\n}\n"]}

package/dist/web/hooks/use-register-view-tool.d.ts

@@ -7,7 +7,7 @@ import type { ViewToolConfig, ViewToolHandler, ViewToolInputShape } from "../bri
  * {@link useCallTool} (which calls a server tool). Registered on mount, removed
  * on unmount; re-registered when `config.name` changes.
  *
- * MCP Apps only — on the Apps SDK (`window.openai`) runtime it is a no-op.
+ * MCP Apps only — on the ChatGPT (`window.openai`) runtime it is a no-op.
  *
  * @example
  * ```tsx

package/dist/web/hooks/use-register-view-tool.js

@@ -8,7 +8,7 @@ import { getAdaptor } from "../bridges/index.js";
  * {@link useCallTool} (which calls a server tool). Registered on mount, removed
  * on unmount; re-registered when `config.name` changes.
  *
- * MCP Apps only — on the Apps SDK (`window.openai`) runtime it is a no-op.
+ * MCP Apps only — on the ChatGPT (`window.openai`) runtime it is a no-op.
  *
  * @example
  * ```tsx

package/dist/web/hooks/use-register-view-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-register-view-tool.js","sourceRoot":"","sources":["../../../src/web/hooks/use-register-view-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAQjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAGjC,MAA8B,EAC9B,OAAgC,EAChC,EAAE;IACF,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IACxB,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;IAC3B,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;QAC7B,MAAM,cAAc,GAAuB,CAAC,IAAI,EAAE,EAAE,CAClD,UAAU,CAAC,OAAO,CAAC,IAA8C,CAAC,CAAC;QAErE,OAAO,OAAO,CAAC,gBAAgB,CAC7B,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,EAC9B,cAAc,CACf,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;AACb,CAAC,CAAC","sourcesContent":["import { useEffect, useRef } from \"react\";\nimport { getAdaptor } from \"../bridges/index.js\";\nimport type {\n  AnyViewToolHandler,\n  ViewToolConfig,\n  ViewToolHandler,\n  ViewToolInputShape,\n} from \"../bridges/types.js\";\n\n/**\n * Register a tool the view exposes to the host and model — the MCP Apps\n * \"app-provided tools\" feature. A view tool runs *inside the view*: the host\n * discovers it via `tools/list` and invokes it via `tools/call`, and the\n * handler executes against the view's live state. It is the inverse of\n * {@link useCallTool} (which calls a server tool). Registered on mount, removed\n * on unmount; re-registered when `config.name` changes.\n *\n * MCP Apps only — on the Apps SDK (`window.openai`) runtime it is a no-op.\n *\n * @example\n * ```tsx\n * import * as z from \"zod\";\n * import { useRegisterViewTool } from \"skybridge/web\";\n *\n * useRegisterViewTool(\n *   {\n *     name: \"chess_make_move\",\n *     description: \"Play a move in algebraic notation, e.g. 'e4' or 'Nf3'.\",\n *     inputSchema: { san: z.string() },\n *     annotations: { readOnlyHint: false },\n *   },\n *   ({ san }) => {\n *     const move = game.move(san);\n *     return {\n *       content: [{ type: \"text\", text: move ? `Played ${move.san}` : \"Illegal move\" }],\n *       structuredContent: { fen: game.fen() },\n *       isError: !move,\n *     };\n *   },\n * );\n * ```\n *\n * @see https://docs.skybridge.tech/api-reference/use-register-view-tool\n */\nexport const useRegisterViewTool = <\n  TInput extends ViewToolInputShape = ViewToolInputShape,\n>(\n  config: ViewToolConfig<TInput>,\n  handler: ViewToolHandler<TInput>,\n) => {\n  const { name } = config;\n  const configRef = useRef(config);\n  configRef.current = config;\n  const handlerRef = useRef(handler);\n  handlerRef.current = handler;\n\n  useEffect(() => {\n    const adaptor = getAdaptor();\n    const wrappedHandler: AnyViewToolHandler = (args) =>\n      handlerRef.current(args as Parameters<ViewToolHandler<TInput>>[0]);\n\n    return adaptor.registerViewTool(\n      { ...configRef.current, name },\n      wrappedHandler,\n    );\n  }, [name]);\n};\n"]}
+{"version":3,"file":"use-register-view-tool.js","sourceRoot":"","sources":["../../../src/web/hooks/use-register-view-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAQjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAGjC,MAA8B,EAC9B,OAAgC,EAChC,EAAE;IACF,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IACxB,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;IAC3B,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC;IAE7B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;QAC7B,MAAM,cAAc,GAAuB,CAAC,IAAI,EAAE,EAAE,CAClD,UAAU,CAAC,OAAO,CAAC,IAA8C,CAAC,CAAC;QAErE,OAAO,OAAO,CAAC,gBAAgB,CAC7B,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,EAC9B,cAAc,CACf,CAAC;IACJ,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;AACb,CAAC,CAAC","sourcesContent":["import { useEffect, useRef } from \"react\";\nimport { getAdaptor } from \"../bridges/index.js\";\nimport type {\n  AnyViewToolHandler,\n  ViewToolConfig,\n  ViewToolHandler,\n  ViewToolInputShape,\n} from \"../bridges/types.js\";\n\n/**\n * Register a tool the view exposes to the host and model — the MCP Apps\n * \"app-provided tools\" feature. A view tool runs *inside the view*: the host\n * discovers it via `tools/list` and invokes it via `tools/call`, and the\n * handler executes against the view's live state. It is the inverse of\n * {@link useCallTool} (which calls a server tool). Registered on mount, removed\n * on unmount; re-registered when `config.name` changes.\n *\n * MCP Apps only — on the ChatGPT (`window.openai`) runtime it is a no-op.\n *\n * @example\n * ```tsx\n * import * as z from \"zod\";\n * import { useRegisterViewTool } from \"skybridge/web\";\n *\n * useRegisterViewTool(\n *   {\n *     name: \"chess_make_move\",\n *     description: \"Play a move in algebraic notation, e.g. 'e4' or 'Nf3'.\",\n *     inputSchema: { san: z.string() },\n *     annotations: { readOnlyHint: false },\n *   },\n *   ({ san }) => {\n *     const move = game.move(san);\n *     return {\n *       content: [{ type: \"text\", text: move ? `Played ${move.san}` : \"Illegal move\" }],\n *       structuredContent: { fen: game.fen() },\n *       isError: !move,\n *     };\n *   },\n * );\n * ```\n *\n * @see https://docs.skybridge.tech/api-reference/use-register-view-tool\n */\nexport const useRegisterViewTool = <\n  TInput extends ViewToolInputShape = ViewToolInputShape,\n>(\n  config: ViewToolConfig<TInput>,\n  handler: ViewToolHandler<TInput>,\n) => {\n  const { name } = config;\n  const configRef = useRef(config);\n  configRef.current = config;\n  const handlerRef = useRef(handler);\n  handlerRef.current = handler;\n\n  useEffect(() => {\n    const adaptor = getAdaptor();\n    const wrappedHandler: AnyViewToolHandler = (args) =>\n      handlerRef.current(args as Parameters<ViewToolHandler<TInput>>[0]);\n\n    return adaptor.registerViewTool(\n      { ...configRef.current, name },\n      wrappedHandler,\n    );\n  }, [name]);\n};\n"]}

package/dist/web/hooks/use-send-follow-up-message.d.ts

@@ -1,4 +1,4 @@
-import { type SendFollowUpMessageOptions } from "../bridges/index.js";
+import { type FollowUpMessage, type SendFollowUpMessageOptions } from "../bridges/index.js";
 /**
  * Send a follow-up message to the LLM on behalf of the view, as if the user
  * had sent it. Use to chain interactions from view UI (e.g. a button that
@@ -8,6 +8,12 @@ import { type SendFollowUpMessageOptions } from "../bridges/index.js";
  * posts the message. This option is Apps-SDK-only; it is silently ignored in
  * the MCP Apps runtime.
  *
+ * `prompt` can also be an array of content blocks. On ChatGPT, a text block
+ * with `_meta["openai/title"]` becomes a labeled item the user can remove, and
+ * `target: "new"` sends the message to a new conversation. Both use the OpenAI
+ * MCP extensions: other hosts ignore the title, and `target: "new"` rejects
+ * with `NotSupportedError` on hosts that don't advertise `openai/message`.
+ *
  * @example
  * ```tsx
  * const send = useSendFollowUpMessage();
@@ -16,4 +22,4 @@ import { type SendFollowUpMessageOptions } from "../bridges/index.js";
  *
  * @see https://docs.skybridge.tech/api-reference/use-send-follow-up-message
  */
-export declare function useSendFollowUpMessage(): (prompt: string, options?: SendFollowUpMessageOptions) => Promise<void>;
+export declare function useSendFollowUpMessage(): (prompt: FollowUpMessage, options?: SendFollowUpMessageOptions) => Promise<void>;

package/dist/web/hooks/use-send-follow-up-message.js

@@ -9,6 +9,12 @@ import { getAdaptor, } from "../bridges/index.js";
  * posts the message. This option is Apps-SDK-only; it is silently ignored in
  * the MCP Apps runtime.
  *
+ * `prompt` can also be an array of content blocks. On ChatGPT, a text block
+ * with `_meta["openai/title"]` becomes a labeled item the user can remove, and
+ * `target: "new"` sends the message to a new conversation. Both use the OpenAI
+ * MCP extensions: other hosts ignore the title, and `target: "new"` rejects
+ * with `NotSupportedError` on hosts that don't advertise `openai/message`.
+ *
  * @example
  * ```tsx
  * const send = useSendFollowUpMessage();

package/dist/web/hooks/use-send-follow-up-message.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-send-follow-up-message.js","sourceRoot":"","sources":["../../../src/web/hooks/use-send-follow-up-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EACL,UAAU,GAEX,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,mBAAmB,GAAG,WAAW,CACrC,CAAC,MAAc,EAAE,OAAoC,EAAE,EAAE,CACvD,OAAO,CAAC,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9C,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,mBAAmB,CAAC;AAC7B,CAAC","sourcesContent":["import { useCallback } from \"react\";\nimport {\n  getAdaptor,\n  type SendFollowUpMessageOptions,\n} from \"../bridges/index.js\";\n\n/**\n * Send a follow-up message to the LLM on behalf of the view, as if the user\n * had sent it. Use to chain interactions from view UI (e.g. a button that\n * triggers the next assistant turn).\n *\n * Pass `scrollToBottom: false` to keep the chat scroll position when the host\n * posts the message. This option is Apps-SDK-only; it is silently ignored in\n * the MCP Apps runtime.\n *\n * @example\n * ```tsx\n * const send = useSendFollowUpMessage();\n * <button onClick={() => send(\"Summarize the last 5 results\")}>Summarize</button>\n * ```\n *\n * @see https://docs.skybridge.tech/api-reference/use-send-follow-up-message\n */\nexport function useSendFollowUpMessage() {\n  const adaptor = getAdaptor();\n  const sendFollowUpMessage = useCallback(\n    (prompt: string, options?: SendFollowUpMessageOptions) =>\n      adaptor.sendFollowUpMessage(prompt, options),\n    [adaptor],\n  );\n\n  return sendFollowUpMessage;\n}\n"]}
+{"version":3,"file":"use-send-follow-up-message.js","sourceRoot":"","sources":["../../../src/web/hooks/use-send-follow-up-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAEL,UAAU,GAEX,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,mBAAmB,GAAG,WAAW,CACrC,CAAC,MAAuB,EAAE,OAAoC,EAAE,EAAE,CAChE,OAAO,CAAC,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9C,CAAC,OAAO,CAAC,CACV,CAAC;IAEF,OAAO,mBAAmB,CAAC;AAC7B,CAAC","sourcesContent":["import { useCallback } from \"react\";\nimport {\n  type FollowUpMessage,\n  getAdaptor,\n  type SendFollowUpMessageOptions,\n} from \"../bridges/index.js\";\n\n/**\n * Send a follow-up message to the LLM on behalf of the view, as if the user\n * had sent it. Use to chain interactions from view UI (e.g. a button that\n * triggers the next assistant turn).\n *\n * Pass `scrollToBottom: false` to keep the chat scroll position when the host\n * posts the message. This option is Apps-SDK-only; it is silently ignored in\n * the MCP Apps runtime.\n *\n * `prompt` can also be an array of content blocks. On ChatGPT, a text block\n * with `_meta[\"openai/title\"]` becomes a labeled item the user can remove, and\n * `target: \"new\"` sends the message to a new conversation. Both use the OpenAI\n * MCP extensions: other hosts ignore the title, and `target: \"new\"` rejects\n * with `NotSupportedError` on hosts that don't advertise `openai/message`.\n *\n * @example\n * ```tsx\n * const send = useSendFollowUpMessage();\n * <button onClick={() => send(\"Summarize the last 5 results\")}>Summarize</button>\n * ```\n *\n * @see https://docs.skybridge.tech/api-reference/use-send-follow-up-message\n */\nexport function useSendFollowUpMessage() {\n  const adaptor = getAdaptor();\n  const sendFollowUpMessage = useCallback(\n    (prompt: FollowUpMessage, options?: SendFollowUpMessageOptions) =>\n      adaptor.sendFollowUpMessage(prompt, options),\n    [adaptor],\n  );\n\n  return sendFollowUpMessage;\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "skybridge",
-  "version": "2.0.3",
-  "description": "Skybridge is a framework for building ChatGPT and MCP Apps",
+  "version": "2.1.0",
+  "description": "Skybridge is a framework for building ChatGPT plugins and MCP Apps",
   "repository": {
     "type": "git",
     "url": "https://github.com/alpic-ai/skybridge.git"
@@ -49,11 +49,11 @@
     "zod": "^4.2.0"
   },
   "dependencies": {
+    "@modelcontextprotocol/client": "^2.0.0",
     "@modelcontextprotocol/core": "^2.0.0",
-    "@modelcontextprotocol/ext-apps": "^1.7.4",
+    "@modelcontextprotocol/ext-apps": "^2.0.0",
     "@modelcontextprotocol/express": "^2.0.0",
     "@modelcontextprotocol/node": "^2.0.0",
-    "@modelcontextprotocol/sdk": "^1.29.0",
     "@modelcontextprotocol/server": "^2.0.0",
     "@oclif/core": "^4.11.14",
     "ci-info": "^4.4.0",
@@ -67,13 +67,14 @@
     "jose": "^6.2.3",
     "open": "^11.0.0",
     "posthog-node": "^5.45.2",
+    "request-filtering-agent": "^3.2.1",
+    "standardwebhooks": "^1.1.1",
     "std-env": "^4.2.0",
     "superjson": "^2.2.6",
     "yaml": "^2.9.0",
     "zustand": "^5.0.14"
   },
   "devDependencies": {
-    "@modelcontextprotocol/client": "^2.0.0",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/react": "^16.3.2",
     "@total-typescript/tsconfig": "^1.0.4",