@gjsify/devtools-protocol 0.30.0 → 0.31.0

package/README.md

@@ -28,7 +28,7 @@ Each method carries a **kind** that the pause guard enforces. When a host pauses
 |---|---|---|
 | `read-only` | Observation / diagnostics (`GetStatus`, `Screenshot`, `DumpTree`, …) | allowed |
 | `presence` | An external driver's own awareness channel (cursor / label) | allowed |
-| `mutating` | Edits app state or the user's UI (`ActivateAction`, `SetProperty`, `SwapCss`, …) | rejected |
+| `mutating` | Edits app state or the user's UI (`ActivateAction`, `ActivateWidget`, `SwapCss`, …) | rejected |
 
 `GENERIC_METHODS` is the toolkit-neutral baseline (core control + full introspection). Adapters implement the subset they support; the bridge advertises only the implemented ones. App-specific methods are added via extensions with their own kinds — **the registry rejects an unclassified method name**, so a new method cannot silently bypass the pause policy.
 

package/lib/esm/methods.js

@@ -1 +1 @@
-const e={GetStatus:`read-only`,Screenshot:`read-only`,ListActions:`read-only`,ActivateAction:`mutating`,ChangeActionState:`mutating`,PresentWindow:`read-only`,ResizeWindow:`mutating`,ListToplevels:`read-only`,DumpTree:`read-only`,GetProperty:`read-only`,SetProperty:`mutating`,GetFocused:`read-only`,ActivateWidget:`mutating`,EmitSignal:`mutating`,DumpGSettings:`read-only`,DumpCss:`read-only`,SwapCss:`mutating`};export{e as GENERIC_METHODS};
+const e={GetStatus:`read-only`,Screenshot:`read-only`,ListActions:`read-only`,ActivateAction:`mutating`,ChangeActionState:`mutating`,PresentWindow:`read-only`,ResizeWindow:`mutating`,ListToplevels:`read-only`,DumpTree:`read-only`,GetProperty:`read-only`,GetFocused:`read-only`,ActivateWidget:`mutating`,DumpGSettings:`read-only`,DumpCss:`read-only`,SwapCss:`mutating`};export{e as GENERIC_METHODS};

package/lib/types/methods.d.ts

@@ -11,6 +11,15 @@ export type MethodKind = 'read-only' | 'presence' | 'mutating';
  * advertises only the implemented ones. App-specific methods are added via
  * extensions with their own kinds — the registry rejects an unclassified
  * method name, so a new method cannot bypass the pause policy unnoticed.
+ *
+ * A NAME HERE IS A PROMISE, so nothing may be listed ahead of an adapter.
+ * `SetProperty` and `EmitSignal` were classified `mutating` here and existed on
+ * no wire at all: no `<method>` fragment in `GENERIC_METHODS_XML`, no handler
+ * in `DevtoolsService`, no MCP tool. A caller reading this contract saw the
+ * name and the kind, called it, and got `UnknownMethod` — the classification
+ * made a method look supported and the pause policy look complete. Both were
+ * removed rather than stubbed; add each back in the change that lands its
+ * adapter, which is the only change that can prove the kind is right.
  */
 export declare const GENERIC_METHODS: {
     readonly GetStatus: "read-only";
@@ -23,10 +32,8 @@ export declare const GENERIC_METHODS: {
     readonly ListToplevels: "read-only";
     readonly DumpTree: "read-only";
     readonly GetProperty: "read-only";
-    readonly SetProperty: "mutating";
     readonly GetFocused: "read-only";
     readonly ActivateWidget: "mutating";
-    readonly EmitSignal: "mutating";
     readonly DumpGSettings: "read-only";
     readonly DumpCss: "read-only";
     readonly SwapCss: "mutating";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/devtools-protocol",
-    "version": "0.30.0",
+    "version": "0.31.0",
     "description": "Transport-agnostic devtools contract (methods, JSON envelope, method-kinds, transport interface) shared by every gjsify devtools adapter and the MCP bridge",
     "type": "module",
     "module": "lib/esm/index.js",
@@ -35,8 +35,8 @@
     ],
     "dependencies": {},
     "devDependencies": {
-        "@gjsify/cli": "^0.30.0",
-        "@gjsify/unit": "^0.30.0",
+        "@gjsify/cli": "^0.31.0",
+        "@gjsify/unit": "^0.31.0",
         "@types/node": "^25.9.2",
         "typescript": "^6.0.3"
     },