fileforge_devtools_action

Previous value: -"The action to perform. Available actions: query_devtools: Unified GraphQL-feel DevTools query. Select modules (console, jsErrors, network, apiResponses, graphql, performance, webSockets, coverage, storageSummary, sourceMaps, requestChains, apiInsights, harSummary, security, thirdParties, issues, recommendations, summary) and presets in one call. start_session: Start an instrumented DevTools capture session for a tab. stop_session: Stop the DevTools capture session. clear_session: Clear captured DevTools session data without detaching. session: Unified session lifecycle action: operation = start | stop | clear | status. get_console: Read recent console messages. Legacy action — prefer query_devtools with console module. get_js_errors: Get JavaScript errors. Legacy action — prefer query_devtools with jsErrors module. get_network: Inspect network requests. Legacy action — prefer query_devtools with network module. get_api_responses: Extract API response bodies. Legacy action — prefer query_devtools with apiResponses module. get_performance: Get performance timing metrics. Legacy action — prefer query_devtools with performance module. get_websockets: Inspect WebSocket frames. Legacy action — prefer query_devtools with webSockets module. evaluate: Run JS in page context via DevTools. Guarded: dryRun supported, dangerous patterns blocked unless allowDangerous=true. replay_request: Replay a captured network request. Guarded: dryRun supported, non-idempotent methods and risky endpoints blocked unless allowUnsafeMethods=true. export_har: Export the captured session as a HAR archive on disk."New value: +"What to do. Required parameters are in brackets. query_devtools: Unified GraphQL-feel DevTools query. Select modules (console, jsErrors, network, apiResponses, graphql, performance, webSockets, coverage, storageSummary, sourceMaps, requestChains, apiInsights, harSummary, security, thirdParties, issues, recommendations, summary) and presets in one call. start_session: Start an instrumented DevTools capture session for a tab. stop_session: Stop the DevTools capture session. clear_session: Clear captured DevTools session data without detaching. session (operation): Unified session lifecycle action: operation = start | stop | clear | status. get_console: Read recent console messages. Legacy action — prefer query_devtools with console module. get_js_errors: Get JavaScript errors. Legacy action — prefer query_devtools with jsErrors module. get_network: Inspect network requests. Legacy action — prefer query_devtools with network module. get_api_responses: Extract API response bodies. Legacy action — prefer query_devtools with apiResponses module. get_performance: Get performance timing metrics. Legacy action — prefer query_devtools with performance module. get_websockets: Inspect WebSocket frames. Legacy action — prefer query_devtools with webSockets module. evaluate (expression): Run JS in page context via DevTools. Guarded: dryRun supported, dangerous patterns blocked unless allowDangerous=true. replay_request (requestId): Replay a captured network request. Guarded: dryRun supported, non-idempotent methods and risky endpoints blocked unless allowUnsafeMethods=true. export_har: Export the captured session as a HAR archive on disk."

Added value: +"Allow expressions the safety check blocks. Use with care."

Added value: +"Allow replaying non-idempotent requests. Use with care."

Added value: +"Start a capture session if none is running."

Added value: +"How long to capture, in milliseconds."

Added value: +"Report what would happen without doing it."

Added value: +"JavaScript to run in the page."

Added value: +"Output filename."

Added value: +"Filter by status, type or URL."

Added value: +"Include response bodies."

Added value: +"Console levels to include."

Added value: +"Session operation to perform."

Added value: +"Request fields to change when replaying, such as method."

Added value: +"Named set of query modules."

Added value: +"Modules to return and their options. Takes priority over preset. Modules: session, page, console, jsErrors, network, apiResponses, graphql, performance, webSockets, coverage, storageSummary, sourceMaps, requestChains, apiInsights, harSummary, security, thirdParties, issues, recommendations, summary, privacy."

Added value: +"ID of a captured network request."

Added value: +"Stop the session after capturing."

Added value: +"Save the result in ~/.fileforge and return a ref."

Added value: +"Tab ID, or \"active\" for the active tab."

Previous value: -nullNew value: +{
+  "description": "query_* actions return their modules as extra top-level fields.",
+  "properties": {
+    "data": {
+      "description": "The result. Its shape depends on the action."
+    },
+    "error": {
+      "description": "Failure code and message."
+    },
+    "meta": {
+      "description": "Tool, action and context."
+    },
+    "ok": {
+      "description": "False if the action failed or a check did not pass.",
+      "type": "boolean"
+    },
+    "ref": {
+      "description": "Stored result ID, for fileforge_result_action."
+    },
+    "warnings": {
+      "description": "Notes about a call that still ran."
+    }
+  },
+  "required": [
+    "ok"
+  ],
+  "type": "object"
+}