@buoy-gg/agent-core 7.0.84 → 7.0.86

package/lib/module/catalog/catalog.source.json

@@ -1956,11 +1956,10 @@
           "additionalProperties": false
         },
         "effect": "write",
-        "release": "noop",
+        "release": "works",
         "description": "Create (or replace by id) a rule that forces matching requests to return a chosen status/body, fail outright, or arrive late. Pick this over query.setQueryData when the change must survive a refetch or reload, or when the ask is about what the API returns; follow it with query.invalidate so the mounted screen refetches through the rule. To change ONE value of the real response send fromRequestId plus `bodyPath` and `bodyValue` (bodyPath:\"sprites.front_default\", or \"stats[stat.name=hp].base_stat\" for one row of a list) \u2014 there is no nesting to get wrong, which matters most here because you read that body through a wire that truncates at 24,000 characters. For several fields use `bodyPatch` with ONLY those fields; never paste a whole captured body back. For \"just the NEXT call\" / \"once, then let it work again\", send rule.times:1 \u2014 the rule auto-disables after one match. Without times it overrides EVERY matching request until deleted. Never fake one-shot by triggering the request yourself and deleting the rule: that spends the failure the user wanted to see. No captured request is needed: urlPattern + methods + status/body (or kind/delayMs) works for a call the app has not made yet \u2014 use fromRequestId only when you need the real response to edit.",
-        "releaseNote": "packages/network/src/network/overrides/engine.ts:74 \u2014 overrideForRequest returns null when __DEV__ === false. The rule is still created, persisted and listed, and this action still returns ok:true, but it is NEVER applied to real traffic in a release build. Confirm with debugOverrides \u2192 engine.devFlag before telling anyone the override took effect.",
+        "releaseNote": "A release build needs a paid Buoy plan and the Buoy menu on screen, or this is refused or saved without applying.",
         "requires": [
-          "a __DEV__ build for the rule to actually apply",
           "something holding the interceptor open (an enabled rule pins it itself)",
           "Buoy Pro only to keep more than 1 rule \u2014 and only in the on-device UI; this action is not license-gated"
         ]
@@ -1986,12 +1985,10 @@
           "additionalProperties": false
         },
         "effect": "write",
-        "release": "noop",
+        "release": "works",
         "description": "Flips a single rule's enabled flag without touching the other rules or the master switch. Use it to stage a rule and arm it later, or to silence one you want to keep. WARNING on optionality: `enabled` is read with a truthiness cast, so omitting it means DISABLE. Returns {ok:true} even when no rule has that id \u2014 it does not verify; confirm with listOverrideRules. Returns {ok:false,error:\"Missing rule id.\"} when `id` is absent. Note that arming a rule here does NOT turn the master switch on (unlike upsertOverrideRule), so a rule can read as enabled and still be dark.",
-        "releaseNote": "packages/network/src/network/overrides/engine.ts:74 \u2014 overrideForRequest returns null when __DEV__ === false, so arming a rule in a release build changes the flag and nothing else. The action still returns ok:true.",
-        "requires": [
-          "a __DEV__ build for the rule to actually apply"
-        ],
+        "releaseNote": "A release build needs a paid Buoy plan and the Buoy menu on screen, or this is refused or saved without applying.",
+        "requires": [],
         "undo": {
           "action": "setOverrideRuleEnabled",
           "note": "Call again with the same id and the inverted `enabled` value."
@@ -2012,12 +2009,10 @@
           "additionalProperties": false
         },
         "effect": "write",
-        "release": "noop",
+        "release": "works",
         "description": "One call changes how every matching request in the app behaves, so treat it as a broad-blast action rather than a toggle. WARNING on optionality: `enabled` is read with a truthiness cast, so calling this with no params DISABLES all overrides. Returns {ok:true, enabled:<the resulting state>} \u2014 read that back rather than assuming. This is also the re-arm for the auto-pause state: when listOverrideRules reports autoPaused:true the launch guard turned overrides off by itself after 3 launches with rules armed and untouched, and only this puts them back. Individual rules keep their own enabled flags underneath.",
-        "releaseNote": "packages/network/src/network/overrides/engine.ts:74 \u2014 overrideForRequest returns null when __DEV__ === false, so flipping the master switch in a release build changes nothing about real traffic in either direction. The action still returns ok:true with the new flag.",
-        "requires": [
-          "a __DEV__ build for rules to actually apply"
-        ],
+        "releaseNote": "A release build needs a paid Buoy plan and the Buoy menu on screen, or this is refused or saved without applying.",
+        "requires": [],
         "undo": {
           "action": "setOverridesEnabled",
           "note": "Call again with the inverted `enabled` value. Per-rule enabled flags are untouched either way."
@@ -2068,7 +2063,7 @@
       },
       {
         "action": "setNetworkConditions",
-        "summary": "Set profile for speed. Set connection for app link state. These work in dev builds. Down caps pace bytes in JS. Up caps wait before send based on body bytes. The socket is not paced. Set profile alone to normal to clear both. Reload clears them too. Set at least one field.",
+        "summary": "Set profile for speed. Set connection for app link state. These work in dev builds. A release build needs a paid Buoy plan and the Buoy menu on screen. Down caps pace bytes in JS. Up caps wait before send based on body bytes. The socket is not paced. Set profile alone to normal to clear both. Reload clears them too. Set at least one field.",
         "params": {
           "type": "object",
           "properties": {
@@ -2101,8 +2096,8 @@
           "additionalProperties": false
         },
         "effect": "write",
-        "release": "throws",
-        "releaseNote": "Release builds refuse active conditions. Normal can still clear the profile."
+        "release": "works",
+        "releaseNote": "A release build needs a paid Buoy plan and the Buoy menu on screen, or this is refused or saved without applying."
       }
     ],
     "unavailableWhen": "The app does not mount the network tool (the @buoy-gg/network preset is absent from the FloatingDevTools apps list), or the runtime has no XMLHttpRequest/fetch to intercept (Node/headless/desktop-mirror \u2014 there getCaptureStatus reports interceptorInstalled:null and debugOverrides throws). The override actions are additionally Pro-gated by the MCP/dashboard layer (requireProDevice)."
@@ -5183,13 +5178,12 @@
           "additionalProperties": false
         },
         "effect": "destructive",
-        "release": "throws",
+        "release": "works",
         "description": "Atomic pre-flight runs first: on failure it returns {ok:false, preflightErrors:[...], conflict} and NOTHING is applied. Otherwise returns a RunReport {ok, scenarioId, name, steps:[{label, ok, error, skipped, ms}], effects:[{kind,label,...}]}. Steps run in order and STOP at the first failure \u2014 later steps are marked skipped, and the steps before it already applied, leaving the device in a partial state (call deactivate). Exclusive activation: running a different scenario while one is active deactivates the active one first. Budgets are 10s per step and 60s overall. Effects vary in reversibility \u2014 a network override rule is removed on deactivate, but a storage write has NO automatic inverse and will be reported as unrestored. Drafts cannot run. After this, the device shows a SIMULATED banner: anything the user observes is partly fake until deactivate.",
-        "releaseNote": "packages/scenarios/src/store/scenariosStore.ts:98-104 (isRunnableInThisBuild) \u2014 in a release bundle checkBeforeRun injects \"Scenarios cannot run in a production build.\", so the adapter returns {ok:false, preflightErrors:[...]} and applies nothing; scenariosStore.run() at :346-348 throws the same message. Verified by packages/scenarios/src/__tests__/runGate.release.test.ts. Report the refusal \u2014 never claim the scenario was applied.",
+        "releaseNote": "A release build needs a paid Buoy plan and the Buoy menu on screen, or this is refused or saved without applying.",
         "requires": [
           "Scenarios tool installed in the app",
-          "every tool a step targets must be installed on the device (network, storage, impersonate, route-events, query, time-machine)",
-          "a development build \u2014 release builds refuse"
+          "every tool a step targets must be installed on the device (network, storage, impersonate, route-events, query, time-machine)"
         ]
       },
       {
@@ -5201,9 +5195,9 @@
           "additionalProperties": false
         },
         "effect": "write",
-        "release": "empty",
+        "release": "works",
         "description": "Returns {ok:true, report:{removedRules, stoppedImpersonation, clearedTransients, unrestoredStorageKeys[], undoStepsRan, errors[]}}. Deletes the override rules the run created, stops impersonation, and runs the author's undoSteps if any (which clears unrestoredStorageKeys). `unrestoredStorageKeys` names keys the app still holds scenario values for \u2014 surface those verbatim to the user, they are real leftover state. Safe when nothing is active: returns an all-zero report. Also the right call after a failed/partial run.",
-        "releaseNote": "Not itself __DEV__-gated, but run is (packages/scenarios/src/store/scenariosStore.ts:98-104), so a release build can never have an active scenario \u2014 expect an all-zero report rather than a real reversal.",
+        "releaseNote": "Works in a release build for a signed-in account.",
         "requires": [
           "Scenarios tool installed in the app"
         ]
@@ -7322,7 +7316,7 @@
   {
     "toolId": "bug-links",
     "title": "Bug links",
-    "summary": "One-tap bug reports a teammate can load. `report` captures the app's state, recent web calls, console, taps and screen, scrubs private data on the device, locks the case with a key that lives only in the link (after #), sends it and returns the link. `load` puts a case into this dev build: every web call is answered from the recording and all others are blocked, and the state, clock and screen are set to the reporter's. A dark pill at the top shows a case is loaded; `loadAgain` is the check after a fix and `undo` (Restore my app) puts the app back. Never paste a link's key into chat or logs; links returned here include it only where noted.",
+    "summary": "One-tap bug reports a teammate can load. `report` captures the app's state, recent web calls, console, taps and screen, scrubs private data on the device, locks the case with a key that lives only in the link (after #), sends it and returns the link. `load` puts a case into this app: every web call is answered from the recording and all others are blocked, and the state, clock and screen are set to the reporter's. A dark pill at the top shows a case is loaded; `loadAgain` is the check after a fix and `undo` (Restore my app) puts the app back. Never paste a link's key into chat or logs; links returned here include it only where noted.",
     "actions": [
       {
         "action": "getState",
@@ -7419,12 +7413,11 @@
           "action": "undo",
           "note": "Restore my app: state, clock and screen first, then real web calls. If it stops short, follow its steps and call undo again, or end."
         },
-        "release": "noop",
-        "releaseNote": "Release builds never fake web calls, so load refuses with loaded:false and changes nothing.",
+        "release": "works",
+        "releaseNote": "A release build needs a paid Buoy plan and the Buoy menu on screen, or this is refused or saved without applying.",
         "description": "Returns {ok, report:{steps[], replay, loaded}}. Each step is {part, ok, detail, warn?}; warn means it loaded but this phone differs from the reporter's (app version, language, time zone, dark mode, screen size), so a bug that needs those may not show. Always `undo` when done.",
         "requires": [
-          "Bug links tool installed in the app (@buoy-gg/bug-links)",
-          "A dev build"
+          "Bug links tool installed in the app (@buoy-gg/bug-links)"
         ]
       },
       {
@@ -7440,12 +7433,12 @@
           "action": "undo",
           "note": "Restore my app: state, clock and screen first, then real web calls. If it stops short, follow its steps and call undo again, or end."
         },
-        "release": "noop",
+        "release": "works",
         "description": "Returns {ok, report}. Refuses when the case wasn't saved on the phone.",
         "requires": [
           "Bug links tool installed in the app (@buoy-gg/bug-links)"
         ],
-        "releaseNote": "Release builds never fake web calls, so nothing is ever loaded to load again."
+        "releaseNote": "A release build needs a paid Buoy plan and the Buoy menu on screen, or this is refused or saved without applying."
       },
       {
         "action": "undo",
@@ -7456,12 +7449,12 @@
           "additionalProperties": false
         },
         "effect": "write",
-        "release": "noop",
+        "release": "works",
         "description": "Returns {ok, steps[]}. ok is false when Restore stopped short (a store whose screen isn't open, Network rules that couldn't come back): the case stays loaded and web calls stay blocked. Follow the step's advice and call undo again, or `end`.",
         "requires": [
           "Bug links tool installed in the app (@buoy-gg/bug-links)"
         ],
-        "releaseNote": "Nothing can be loaded in a release build, so there is nothing to put back."
+        "releaseNote": "Works in a release build for a signed-in account."
       },
       {
         "action": "end",
@@ -7472,12 +7465,12 @@
           "additionalProperties": false
         },
         "effect": "destructive",
-        "release": "noop",
+        "release": "works",
         "description": "Only for when undo can't finish. Takes the sandbox off; the app keeps the case's data.",
         "requires": [
           "Bug links tool installed in the app (@buoy-gg/bug-links)"
         ],
-        "releaseNote": "Nothing can be loaded in a release build, so there is nothing to end."
+        "releaseNote": "Works in a release build for a signed-in account."
       },
       {
         "action": "leaveSandbox",
@@ -7488,12 +7481,12 @@
           "additionalProperties": false
         },
         "effect": "write",
-        "release": "noop",
+        "release": "works",
         "description": "Returns {ok, detail?}. The app's own Network rules come back.",
         "requires": [
           "Bug links tool installed in the app (@buoy-gg/bug-links)"
         ],
-        "releaseNote": "Release builds never fake web calls, so there is no sandbox to leave."
+        "releaseNote": "Works in a release build for a signed-in account."
       },
       {
         "action": "listLinks",
@@ -7604,6 +7597,6 @@
         ]
       }
     ],
-    "unavailableWhen": "The app does not install @buoy-gg/bug-links (FloatingDevTools picks it up on its own when it is installed), so \"bug-links\" is absent from the device's capability list. Reports need a Pro plan and a Buoy sign-in on the phone; loading needs a dev build."
+    "unavailableWhen": "The app does not install @buoy-gg/bug-links (FloatingDevTools picks it up on its own when it is installed), so \"bug-links\" is absent from the device's capability list. Reports need a Pro plan and a Buoy sign-in on the phone; in a release build, loading also needs a paid Buoy plan and the Buoy menu on screen."
   }
 ]