{"report":"{\"v\":1,\"package\":\"@foldkit/devtools-mcp\",\"version\":\"0.26.0\",\"ranAt\":\"2026-11-16T11:24:24.445Z\",\"install\":{\"ok\":true,\"integrity\":\"sha512-MhIAG28hBsGV43XuXbpschvp+D0UKNTF6YwNCDn7mYHxfaIFx56GONAAvmupuHSxZgEtbEXSmOetMB8vukxSFw==\",\"deps\":101,\"scripts\":[],\"bins\":[\"foldkit-devtools-mcp\"],\"license\":\"MIT\",\"engines\":\"node >=22.19.0\",\"repository\":\"https://github.com/foldkit/foldkit.git\",\"bin\":\"foldkit-devtools-mcp\"},\"start\":{\"ok\":true,\"ms\":142,\"serverName\":\"@foldkit/devtools-mcp\",\"serverVersion\":\"0.1.0\",\"protocol\":\"2025-06-18\",\"stderr\":\"[foldkit-devtools-mcp] looking up Foldkit dev servers for / on each tool call\\n[foldkit-devtools-mcp] MCP server ready on stdio\\n\"},\"tools\":[{\"name\":\"foldkit_get_model\",\"description\":\"Snapshot the current Model from a connected Foldkit runtime. By default the response is summarized (large arrays/records/strings collapse to `_summary` placeholders) to keep payloads small for AI agents. Pass `path` (e.g. 'root.session.user') to narrow to a subtree, and `expand: true` to receive the literal value at that path. Returns `{ value, atPath, summarized }`.\",\"params\":[\"runtime_id\",\"path\",\"expand\"]},{\"name\":\"foldkit_get_model_at\",\"description\":\"Snapshot a historical Model after a given history entry was applied. Pass `index: N - 1` to read the Model just before message N. Same `path`/`expand` semantics as foldkit_get_model. Indices outside the retained history range (older entries are evicted past the rolling buffer) are rejected with the readable range. For the initial Model (and the names of Commands returned from the application's `init`), use foldkit_get_init.\",\"params\":[\"runtime_id\",\"index\",\"path\",\"expand\"]},{\"name\":\"foldkit_list_messages\",\"description\":\"List Message history entries from a Foldkit runtime. Filter server-side with `changed_paths_match` to ask in Model terms (which Messages touched this subtree), read the most recent entries with `from_end: true`, and paginate forward via `since_index` using the returned `maybeNextIndex` (the absolute index of the next matching entry). On busy histories (drag, scroll, keystroke flows), call foldkit_count_messages_by_tag first to learn what is worth filtering.\",\"params\":[\"runtime_id\",\"limit\",\"since_index\",\"changed_paths_match\",\"from_end\"]},{\"name\":\"foldkit_count_messages_by_tag\",\"description\":\"Count retained Message history entries by tag, without payloads. Returns `{ counts: [{ tag, count }], totalCount, scannedFromIndex, scannedToIndex }` sorted by count descending. A cheap reconnaissance call before paging through history: it surfaces the high-frequency Messages worth filtering out, and with `changed_paths_match` it answers which Message tags touch a Model subtree. Accepts the same `since_index`/`changed_paths_match` filters as foldkit_list_messages.\",\"params\":[\"runtime_id\",\"since_index\",\"changed_paths_match\"]},{\"name\":\"foldkit_diff_models\",\"description\":\"Diff the Models at two history indices server-side. Returns path-level changes `{ path, before, after }` sorted by path (numeric segments in numeric order), with values summarized. Each side is `{ _tag: 'Present', value }`, or `{ _tag: 'Absent' }` when the path does not exist on that side (a key or element that was added or removed). `from_index`/`to_index` follow foldkit_get_model_at semantics: the Model right after that entry was applied, with -1 for the initial Model. Pass `changed_paths_match` to narrow the diff to a Model subtree. Far cheaper than fetching two snapshots and diffing client-side; follow up with foldkit_get_model_at plus `path`/`expand: true` to read a changed subtree at full fidelity.\",\"params\":[\"runtime_id\",\"from_index\",\"to_index\",\"changed_paths_match\"]},{\"name\":\"foldkit_get_message\",\"description\":\"Read a single Message history entry by absolute index. The response carries the SerializedEntry (tag, message body, commands, mountStarts, mountEnds, timestamp, `isModelChanged`, `changedPaths` for leaf-level mutations, `affectedPaths` adding their ancestor paths). Each entry in `commands` carries the Command name, `args` (`Some(record)` when the Command declared an args schema, `None` otherwise), and `maybeSubmodelPath` (`None` before the result resolves, `Some([])` for a resolved top-level Command, or `Some(tags)` for a resolved Submodel Command). `mountStarts` lists Mounts that fired during the render after this Message; `mountEnds` lists Mounts whose elements were unmounted during that render. Each Mount carries its `name` and `args` (`Some(record)` when the Mount declared an args schema, `None` otherwise). For Submodel-routed entries (tag matches `Got*Message`), the entry also carries `submodelPath` listing wrapper tags from outer to inner and `maybeLeafTag` naming the innermost child Message. Model snapshots are not included; call foldkit_get_model_at with `index - 1` (before) and `index` (after) to inspect Model state around the entry.\",\"params\":[\"runtime_id\",\"index\"]},{\"name\":\"foldkit_get_init\",\"description\":\"Read the runtime's initial Model, the Commands returned from the application's `init` function, and the Mounts that fired during the first render. The init entry is the synthetic row at index -1 in the DevTools panel; this tool exposes the same data without time-travelling the runtime. `maybeModel` is `None` until the runtime has finished its first render and recorded init, then stays `Some` for the rest of the runtime's life. `commands` lists init-time Commands in the order they were produced, each with its name, `args` (`Some(record)` when the Command declared an args schema, `None` otherwise), and `maybeSubmodelPath` (`None` before the result resolves, `Some([])` for a resolved top-level Command, or `Some(tags)` for a resolved Submodel Command); `mountStarts` lists Mounts whose elements appeared in the initial render, each with its name and `args` (`Some(record)` when the Mount declared an args schema, `None` otherwise).\",\"params\":[\"runtime_id\"]},{\"name\":\"foldkit_get_runtime_state\",\"description\":\"Snapshot the runtime's DevTools state: history bounds, current paused/live status, and whether init is recorded. Returns `currentIndex` (the absolute index of the most recent Message, or -1 when none), `startIndex` (the earliest absolute index still retained in the rolling buffer), `totalEntries` (count of retained entries), `isPaused`, `maybePausedAtIndex` (`Some(index)` when paused, `None` otherwise), and `hasInitModel`. Use it to reason about what `foldkit_list_messages` and `foldkit_get_message` will see, and to detect whether the runtime is currently paused at a replayed snapshot.\",\"params\":[\"runtime_id\"]},{\"name\":\"foldkit_list_keyframes\",\"description\":\"List the available keyframes (replayable Model snapshots) from a Foldkit runtime.\",\"params\":[\"runtime_id\"]},{\"name\":\"foldkit_replay_to_keyframe\",\"description\":\"Time-travel a Foldkit runtime back to a previous Model snapshot. Pass `keyframe_index: -1` for the initial Model, or a non-negative index for the state right after that history entry. The runtime is paused at the snapshot until foldkit_resume is called.\",\"params\":[\"runtime_id\",\"keyframe_index\"]},{\"name\":\"foldkit_resume\",\"description\":\"Resume normal execution of a Foldkit runtime that was paused by foldkit_replay_to_keyframe.\",\"params\":[\"runtime_id\"]},{\"name\":\"foldkit_get_message_schema\",\"description\":\"Describe the Message Schema for a Foldkit runtime so agents can construct valid payloads for `foldkit_dispatch_message`. Call with no arguments to receive a small variant index (every top-level variant's `_tag`, its payload field names, and which payload fields are themselves tagged-union shapes). Then call with `variant_tag: \\\"ChosenVariant\\\"` to drill in. The argument is a dot-separated path of variant `_tag` values: each segment names a variant, and the walker steps through the variant's single tagged-union payload field to reach the next. So `\\\"GotMobileMenuDialogMessage\\\"` narrows one level; `\\\"GotMobileMenuDialogMessage.GotAnimationMessage\\\"` narrows two levels of a Submodel chain. Discriminated unions deeper than the supplied path collapse to `{ \\\"_summary\\\": \\\"union\\\", \\\"variants\\\": [...] }` placeholders so the response stays compact even for deeply-nested apps; extend the path to drill further. `Schema.Option` fields render as `anyOf: [{_tag: \\\"Some\\\", value}, {_tag: \\\"None\\\"}]`. The full document follows the JSON Schema draft-2020-12 shape from `Schema.toJsonSchemaDocument`: `{ dialect, schema, definitions }`. Returns `maybeResult: None` when the runtime hasn't configured `DevToolsConfig.Message` (dispatch is also unavailable). Fields with no JSON representation, notably `Schema.instanceOf(File)` for user-uploaded files, render as `{type: \\\"null\\\"}`; those variants can't be dispatched via MCP because their values live in browser memory.\",\"params\":[\"runtime_id\",\"variant_tag\"]},{\"name\":\"foldkit_dispatch_message\",\"description\":\"Dispatch a Message into a Foldkit runtime, as if the application itself produced it. Requires the runtime to have configured DevToolsConfig.Message; without it, dispatch is rejected. Call `foldkit_get_message_schema` with no arguments to enumerate the variants, then with `variant_tag` to learn one variant's exact payload shape, before constructing the Message object. The runtime decodes the payload and returns a clean error if it doesn't match. To dispatch several Messages in order with one call, use foldkit_dispatch_messages.\",\"params\":[\"runtime_id\",\"message\"]},{\"name\":\"foldkit_dispatch_messages\",\"description\":\"Dispatch an ordered batch of Messages into a Foldkit runtime in one call, first to last, as if the application produced them in quick succession. Prefer this over repeated foldkit_dispatch_message calls when staging state that takes several Messages: reproducing a bug, filling a form, or building a history fixture. Takes 1 to 100 Messages. Validation is all-or-nothing: the runtime decodes every payload against the Message Schema before dispatching any of them, and one invalid entry rejects the whole batch with an error naming its zero-based position, so there is never a partially applied prefix to clean up. On success the response carries acceptedAtIndices, the predicted history index for each Message in request order; the runtime may still record its own Messages between entries (for example a Command completing mid-burst), exactly as with rapid user input, and Messages excluded from history via excludeFromHistory are dispatched but never recorded, so entries after one land below their predicted index. Requires DevToolsConfig.Message, like foldkit_dispatch_message.\",\"params\":[\"runtime_id\",\"messages\"]},{\"name\":\"foldkit_list_runtimes\",\"description\":\"List Foldkit runtimes (browser tabs) connected to every Foldkit dev server under the project root, or else to every dev server at the nearest root that encloses the project root, oldest dev server first. Each runtime carries `projectRoot`, the root of the dev server it belongs to, unless the MCP server uses a fixed relay address.\",\"params\":[]}],\"toolsHash\":\"914113b93bc869fbd28db89a1bbdf14dc6555bb0f5e7a222626a0eac40257706\",\"wrote\":[],\"callsAt\":\"2026-11-16T11:24:33.521Z\",\"calls\":[{\"tool\":\"foldkit_get_model\",\"ok\":false,\"ms\":9,\"bytes\":0,\"error\":\"tool reported an error: Error: Not connected to a Foldkit dev server. Start your Foldkit Vite dev server and retry the tool call.\"},{\"tool\":\"foldkit_get_runtime_state\",\"ok\":false,\"ms\":1,\"bytes\":0,\"error\":\"tool reported an error: Error: Not connected to a Foldkit dev server. Start your Foldkit Vite dev server and retry the tool call.\"},{\"tool\":\"foldkit_list_keyframes\",\"ok\":false,\"ms\":2,\"bytes\":0,\"error\":\"tool reported an error: Error: Not connected to a Foldkit dev server. Start your Foldkit Vite dev server and retry the tool call.\"},{\"tool\":\"foldkit_list_runtimes\",\"ok\":false,\"ms\":1,\"bytes\":0,\"error\":\"tool reported an error: Error: Not connected to a Foldkit dev server. Start your Foldkit Vite dev server and retry the tool call.\"}],\"host\":{\"commit\":\"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c\",\"run\":\"https://github.com/itsHaddad/bragproof/actions/runs/43857070216\"},\"network\":{\"names\":[\"registry.npmjs.org\"],\"conns\":[],\"callNames\":[],\"callConns\":[]}}","token":"eyJhbGciOiJSUzI1NiIsImtpZCI6IjM4ODI2YjE3LTZhMzAtNWY5Yi1iMTY5LThiZWI4MjAyZjcyMyIsInR5cCI6IkpXVCIsIng1dCI6InlrTmFZNHFNX3RhNGsyVGdaT0NFWUxrY1lsQSJ9.eyJhY3RvciI6Iml0c0hhZGRhZCIsImFjdG9yX2lkIjoiMTE0NzMyNjEiLCJhdWQiOiJicmFncHJvb2YtcmVwb3J0OmZkNmMzOWNhYmUyZGU5NzI1OTNjMjlmMzcyNjYyMTg0YzFkZGUxNmI0ZDBlMzRkMGM1NDZlNGMwNTIyZTdlMmIiLCJiYXNlX3JlZiI6IiIsImNoZWNrX3J1bl9pZCI6IjEzMzI2Mzk5NTUxMyIsImV2ZW50X25hbWUiOiJzY2hlZHVsZSIsImV4cCI6MTc5NDgyODU3OSwiaGVhZF9yZWYiOiIiLCJpYXQiOjE3OTQ4MjgyNzksImlzcyI6Imh0dHBzOi8vdG9rZW4uYWN0aW9ucy5naXRodWJ1c2VyY29udGVudC5jb20iLCJqb2Jfd29ya2Zsb3dfcmVmIjoiaXRzSGFkZGFkL2JyYWdwcm9vZi8uZ2l0aHViL3dvcmtmbG93cy9yZXBvcnQueW1sQHJlZnMvaGVhZHMvbWFpbiIsImpvYl93b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIiwianRpIjoiMGIzOTNhMGQtN2E4Zi00ZDI3LTliZGUtODBkM2IwMGMwYWZiIiwibmJmIjoxNzk0ODI3OTc5LCJyZWYiOiJyZWZzL2hlYWRzL21haW4iLCJyZWZfcHJvdGVjdGVkIjoiZmFsc2UiLCJyZWZfdHlwZSI6ImJyYW5jaCIsInJlcG9zaXRvcnkiOiJpdHNIYWRkYWQvYnJhZ3Byb29mIiwicmVwb3NpdG9yeV9pZCI6IjE0NTQ2MjExODMiLCJyZXBvc2l0b3J5X293bmVyIjoiaXRzSGFkZGFkIiwicmVwb3NpdG9yeV9vd25lcl9pZCI6IjExNDczMjYxIiwicmVwb3NpdG9yeV92aXNpYmlsaXR5IjoicHVibGljIiwicnVuX2F0dGVtcHQiOiIxIiwicnVuX2lkIjoiNDM4NTcwNzAyMTYiLCJydW5fbnVtYmVyIjoiMjQiLCJydW5uZXJfZW52aXJvbm1lbnQiOiJnaXRodWItaG9zdGVkIiwic2hhIjoiZWFhZmZmZmFmNTIyNTVkMWI3N2RjNGFhY2ZmZGZhZjM1M2YwYzEyYyIsInN1YiI6InJlcG86aXRzSGFkZGFkQDExNDczMjYxL2JyYWdwcm9vZkAxNDU0NjIxMTgzOnJlZjpyZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvdyI6InJlcG9ydCIsIndvcmtmbG93X3JlZiI6Iml0c0hhZGRhZC9icmFncHJvb2YvLmdpdGh1Yi93b3JrZmxvd3MvcmVwb3J0LnltbEByZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIn0.NicwSWrjTMfbWb__YVAOmpP8R9tdG9IVBV-mkvjs_9CHIf538oolp-Weejx5sLu4u9-pZ9uYlr4WxCnXFO95pt13fJ-yYUHxA8XLA4yIgnsHW54pOOoc329sHAZpMZZFT7EBc5xvZHYHk3dyWcIZvAXSc-dcELGPcVryyGlqRHW4UTTexNzcK3YqytHnwnLVKo0Xz1UC5BRSGvAMxLP8nlz0vm0Eyvhdw4U6ST1DkZYdtOuxsltUzxzGjwx9J45_usQCB3bAQ7ffMfdesRAnoOxDc-ryHR7HWuPsD2INz3GRhAc7kAIw-z4AJaA3OjdoIWVZ6XXFmKnm-gH9zo5b5Q"}