@foldkit/devtools-mcp 0.24.0-canary.26e27fd937f9 → 0.24.0-canary.482593707a08

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 (2) hide show
  1. package/README.md +9 -1
  2. package/package.json +4 -4
package/README.md CHANGED
@@ -51,6 +51,14 @@ Restart your dev server, then restart your AI agent. The MCP server will appear
51
51
 
52
52
  The browser bridge runs inside your app, so the MCP server only sees a Runtime while the app is open in a browser tab. Close the tab and the Runtime disappears from `foldkit_list_runtimes`.
53
53
 
54
+ ## Sensitive Runtime Data
55
+
56
+ Treat this server as privileged access to the running application. A connected agent can read the current, initial, and retained historical Models; every retained Message payload; and the arguments passed to recorded Commands and Mounts. Anything returned by one of these tools enters the agent's context.
57
+
58
+ Keep API keys, passwords, access and refresh tokens, authorization headers, session material, and private personal data out of those values. Long-lived secrets belong behind a server boundary, including in local demos. If the browser must temporarily carry a sensitive value, use Effect `Redacted` with a `Schema.Redacted` field configured with `disallowJsonEncode: true`. `Redacted` protects normal string, JSON, and inspection output; it does not encrypt the value or hide a browser-side credential from the person running the browser.
59
+
60
+ `excludeFromHistory` is for noisy Messages, not sensitive ones. The resulting Model remains inspectable. Omitting `DevToolsConfig.Message` disables dispatch only; read and replay tools remain available. Set `devToolsMcpPort: false` in the Foldkit Vite plugin options to keep the in-browser DevTools without starting the MCP relay, or set `devTools: false` in the application config to disable recording and the browser bridge too.
61
+
54
62
  ## Tools
55
63
 
56
64
  Each tool accepts an optional `runtime_id`. When omitted, the most recently connected Runtime is used.
@@ -110,7 +118,7 @@ The MCP server looks for a running dev server in its project directory. If sever
110
118
  | `FOLDKIT_DEVTOOLS_MCP_HOST` | Overrides the hostname of a discovered relay or configured port. |
111
119
  | `FOLDKIT_DEVTOOLS_RELAY_DIRECTORY` | Registry location. Defaults to a directory under `XDG_RUNTIME_DIR` when set, or under the OS temporary directory. Set it in both processes if they use different sandboxes. |
112
120
 
113
- A relay discovered through the registry requires the token in its published address. The plugin will not publish that token into a directory owned by another user or readable by other users. A configured `devToolsMcpPort` opens a separate socket on every interface without a token.
121
+ A relay discovered through the registry requires the token in its published address. The plugin will not publish that token into a directory owned by another user or readable by other users. This token keeps unapproved clients from connecting; it does not hide runtime data from the agent that was given the MCP server. A configured `devToolsMcpPort` opens a separate socket on every interface without a token. Do not use a fixed port on a shared or untrusted network.
114
122
 
115
123
  On Windows, directory ownership cannot be verified, so automatic discovery is unavailable. Use `devToolsMcpPort` in the Vite config and set `FOLDKIT_DEVTOOLS_MCP_PORT` to the same port.
116
124
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@foldkit/devtools-mcp",
3
- "version": "0.24.0-canary.26e27fd937f9",
3
+ "version": "0.24.0-canary.482593707a08",
4
4
  "description": "MCP server exposing Foldkit DevTools to AI agents (Claude Code, Cursor, etc.)",
5
5
  "type": "module",
6
6
  "main": "./dist/server.js",
@@ -17,7 +17,7 @@
17
17
  },
18
18
  "peerDependencies": {
19
19
  "effect": "4.0.0",
20
- "foldkit": "0.165.0-canary.26e27fd937f9"
20
+ "foldkit": "0.165.0-canary.482593707a08"
21
21
  },
22
22
  "dependencies": {
23
23
  "@modelcontextprotocol/sdk": "1.29.0",
@@ -33,8 +33,8 @@
33
33
  "typescript": "^7.0.2",
34
34
  "vite": "^8.3.1",
35
35
  "vitest": "^4.1.11",
36
- "@foldkit/vite-plugin": "0.26.0-canary.26e27fd937f9",
37
- "foldkit": "0.165.0-canary.26e27fd937f9"
36
+ "@foldkit/vite-plugin": "0.26.0-canary.482593707a08",
37
+ "foldkit": "0.165.0-canary.482593707a08"
38
38
  },
39
39
  "files": [
40
40
  "dist"