@rackbops/ac-plugin-contract 2.0.0-alpha.45 → 2.0.0-alpha.46

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/AUTHORING.md +7 -0
  2. package/package.json +1 -1
package/AUTHORING.md CHANGED
@@ -821,6 +821,13 @@ is granted. `hello`'s own manifest declares `agent.git.read` as the reference de
821
821
  never actually calls it -- the declaration alone is what the grid, a live pairing pass, and this
822
822
  guide need).
823
823
 
824
+ A grant outlives its declaration (#645): disabling a plugin, removing it, or dropping a capability from its
825
+ manifest does not revoke what an operator already granted, and does not block editing the other grants on that
826
+ machine. The stale pair has no row in the grid (only declared capabilities have one), the host keeps it as it
827
+ is, and re-enabling the plugin or restoring the capability brings the row, ticked, back. What the host will
828
+ not do is let anyone *add* a grant for a capability no loaded plugin declares. A stale pair has no checkbox
829
+ to untick; to revoke one, `PUT /api/agents/:id/grants` the machine's grant map without it.
830
+
824
831
  At runtime, call a granted capability on a specific paired machine through `host.agent`:
825
832
 
826
833
  ```ts
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@rackbops/ac-plugin-contract",
3
- "version": "2.0.0-alpha.45",
3
+ "version": "2.0.0-alpha.46",
4
4
  "private": false,
5
5
  "type": "module",
6
6
  "description": "The artifact-console plugin ABI for out-of-repo plugin authors: HostApi, the acPlugin manifest contribution points, the generated manifest JSON Schema, and the @ac/host ambient browser declaration.",