@fungi.computer/oyster 0.9.0 → 0.10.0

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 (49) hide show
  1. package/README.md +13 -0
  2. package/dist/agents.d.ts +16 -1
  3. package/dist/agents.js +60 -3
  4. package/dist/computer-control-port.d.ts +20 -1
  5. package/dist/mcp.d.ts +128 -0
  6. package/dist/mcp.js +63 -1
  7. package/dist/standalone/agent-computers.d.ts +12 -1
  8. package/dist/standalone/agent-computers.js +35 -0
  9. package/dist/standalone/agent-connections.d.ts +47 -0
  10. package/dist/standalone/agent-connections.js +170 -0
  11. package/dist/standalone/agent-model-choice.d.ts +7 -3
  12. package/dist/standalone/agent-model-choice.js +33 -4
  13. package/dist/standalone/agents.d.ts +70 -9
  14. package/dist/standalone/agents.js +187 -110
  15. package/dist/standalone/browser.d.ts +4 -3
  16. package/dist/standalone/browser.js +4 -3
  17. package/dist/standalone/computer-control.js +55 -1
  18. package/dist/standalone/computer-fleet.d.ts +21 -0
  19. package/dist/standalone/computer-fleet.js +30 -6
  20. package/dist/standalone/computer.d.ts +20 -1
  21. package/dist/standalone/computer.js +63 -1
  22. package/dist/standalone/model-key-vault.d.ts +50 -0
  23. package/dist/standalone/model-key-vault.js +147 -0
  24. package/dist/standalone/registry.d.ts +23 -0
  25. package/dist/standalone/registry.js +30 -0
  26. package/dist/standalone/web.d.ts +10 -0
  27. package/dist/standalone/web.js +34 -0
  28. package/dist/standalone/worker-routes.d.ts +3 -1
  29. package/dist/standalone/worker-routes.js +1 -0
  30. package/dist/standalone/worker.js +9 -1
  31. package/dist/web/index.d.ts +3 -0
  32. package/dist/web/index.js +3 -0
  33. package/dist/web/search-contract.d.ts +19 -0
  34. package/dist/web/search-contract.js +14 -0
  35. package/dist/web/search.d.ts +25 -0
  36. package/dist/web/search.js +123 -0
  37. package/dist/web/source.d.ts +46 -0
  38. package/dist/web/source.js +335 -0
  39. package/dist/workers-git.js +2 -1
  40. package/docs/api/agents.md +81 -3
  41. package/docs/api/apps.md +129 -111
  42. package/docs/api/build-contract.md +27 -21
  43. package/docs/api/build.md +55 -54
  44. package/docs/api/git.md +3 -3
  45. package/docs/api/host.md +69 -60
  46. package/docs/api/mcp.md +81 -44
  47. package/docs/api/workers-git.md +6 -6
  48. package/docs/api/workers.md +53 -47
  49. package/package.json +27 -22
package/docs/api/apps.md CHANGED
@@ -46,6 +46,7 @@ readonly read(appKey): Promise<
46
46
  | "agent.send"
47
47
  | "llm.generation"
48
48
  | "media.generation"
49
+ | "media.share"
49
50
  | "games:servers"
50
51
  | "git.repository"
51
52
  | "apps.open"
@@ -101,6 +102,7 @@ readonly read(appKey): Promise<
101
102
  | "agent.send"
102
103
  | "llm.generation"
103
104
  | "media.generation"
105
+ | "media.share"
104
106
  | "games:servers"
105
107
  | "git.repository"
106
108
  | "apps.open"
@@ -144,11 +146,11 @@ and the available resources.
144
146
  `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \|
145
147
  `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \|
146
148
  `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \|
147
- `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \|
148
- `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \|
149
- `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \|
150
- `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \|
151
- `"workflow.arm"` \| `"world"` \| `"channels.read"` \|
149
+ `"llm.generation"` \| `"media.generation"` \| `"media.share"` \|
150
+ `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \|
151
+ `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \|
152
+ `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \|
153
+ `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \|
152
154
  `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`:
153
155
  readonly `string`[]; `resources`: `"tenant-scope"` \| readonly
154
156
  `Readonly`\<...\>[]; \}\>[]; `approval`: \| `Readonly`\<\{ `by`: \| \{ `kind`:
@@ -160,11 +162,11 @@ readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \|
160
162
  `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \|
161
163
  `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \|
162
164
  `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \|
163
- `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \|
164
- `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \|
165
- `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \|
166
- `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \|
167
- `"workflow.arm"` \| `"world"` \| `"channels.read"` \|
165
+ `"llm.generation"` \| `"media.generation"` \| `"media.share"` \|
166
+ `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \|
167
+ `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \|
168
+ `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \|
169
+ `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \|
168
170
  `"channels.personal.manage"`; `operations`: readonly `string`[]; \}\>[]; \}; \};
169
171
  `canEdit`: `boolean`; `resources`: `object`[]; \}\>
170
172
 
@@ -183,14 +185,14 @@ digest. The host checks authorization and freshness before saving.
183
185
 
184
186
  ###### Parameters
185
187
 
186
- | Parameter | Type |
187
- | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
188
- | `appKey` | `string` |
189
- | `pins` | \{ `storeGeneration`: `string`; `authorityVersion`: `number`; `artifactDigest`: `Sha256Digest`; \} |
190
- | `pins.storeGeneration` | `string` |
191
- | `pins.authorityVersion` | `number` |
192
- | `pins.artifactDigest` | `Sha256Digest` |
193
- | `changes` | readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `grant`: \| `Readonly`\<\{ `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\> \| `null`; \}\>[] |
188
+ | Parameter | Type |
189
+ | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
190
+ | `appKey` | `string` |
191
+ | `pins` | \{ `storeGeneration`: `string`; `authorityVersion`: `number`; `artifactDigest`: `Sha256Digest`; \} |
192
+ | `pins.storeGeneration` | `string` |
193
+ | `pins.authorityVersion` | `number` |
194
+ | `pins.artifactDigest` | `Sha256Digest` |
195
+ | `changes` | readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `grant`: \| `Readonly`\<\{ `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\> \| `null`; \}\>[] |
194
196
 
195
197
  ###### Returns
196
198
 
@@ -578,6 +580,7 @@ type InstallationReader = Readonly<{
578
580
  | ...
579
581
  | ...
580
582
  | ...
583
+ | ...
581
584
  | ...;
582
585
  capabilityApproved: true;
583
586
  operations: readonly ...[];
@@ -643,6 +646,7 @@ type InstallationReader = Readonly<{
643
646
  | ...
644
647
  | ...
645
648
  | ...
649
+ | ...
646
650
  | ...;
647
651
  capabilityApproved: true;
648
652
  operations: readonly ...[];
@@ -896,6 +900,7 @@ Every capability selects one consent class and one resource grammar.
896
900
  | <a id="property-computerexecute"></a> `computer.execute` | `Readonly`\<\{ `group`: \| `"computers"` \| `"workflows"` \| `"git"` \| `"agents"` \| `"generation"` \| `"bazaar"` \| `"data"` \| `"channels"` \| `"apps"` \| `"shell"` \| `"other"`; `label`: `string`; `caption`: `string`; `description`: `string`; `sigil`: \| `"error"` \| `"read"` \| `"write"` \| `"computer"` \| `"list"` \| `"loop"` \| `"run"` \| `"agent"` \| `"bonsai"` \| `"prints"` \| `"inkcap"` \| `"vishnu"` \| `"generateText"` \| `"generateMedia"` \| `"buyApps"` \| `"browseBazaar"` \| `"chat"` \| `"readConversations"` \| `"listAgents"` \| `"createAgents"` \| `"sendPrompts"` \| `"connected"` \| `"working"` \| `"complete"` \| `"installApps"` \| `"restricted"` \| `"trellis"` \| `"games"` \| `"oyster"` \| `"tourtois"` \| `"allApps"` \| `"search"` \| `"browser"` \| `"internet"` \| `"members"` \| `"sell"` \| `"schedule"` \| `"fungi"`; `consent`: `"affordance"` \| `"install"` \| `"ask"`; `scope`: `"computer"` \| `"agent"` \| `null`; `warning`: `string` \| `null`; \}\> |
897
901
  | <a id="property-llmgeneration"></a> `llm.generation` | `Readonly`\<\{ `group`: \| `"computers"` \| `"workflows"` \| `"git"` \| `"agents"` \| `"generation"` \| `"bazaar"` \| `"data"` \| `"channels"` \| `"apps"` \| `"shell"` \| `"other"`; `label`: `string`; `caption`: `string`; `description`: `string`; `sigil`: \| `"error"` \| `"read"` \| `"write"` \| `"computer"` \| `"list"` \| `"loop"` \| `"run"` \| `"agent"` \| `"bonsai"` \| `"prints"` \| `"inkcap"` \| `"vishnu"` \| `"generateText"` \| `"generateMedia"` \| `"buyApps"` \| `"browseBazaar"` \| `"chat"` \| `"readConversations"` \| `"listAgents"` \| `"createAgents"` \| `"sendPrompts"` \| `"connected"` \| `"working"` \| `"complete"` \| `"installApps"` \| `"restricted"` \| `"trellis"` \| `"games"` \| `"oyster"` \| `"tourtois"` \| `"allApps"` \| `"search"` \| `"browser"` \| `"internet"` \| `"members"` \| `"sell"` \| `"schedule"` \| `"fungi"`; `consent`: `"affordance"` \| `"install"` \| `"ask"`; `scope`: `"computer"` \| `"agent"` \| `null`; `warning`: `string` \| `null`; \}\> |
898
902
  | <a id="property-mediageneration"></a> `media.generation` | `Readonly`\<\{ `group`: \| `"computers"` \| `"workflows"` \| `"git"` \| `"agents"` \| `"generation"` \| `"bazaar"` \| `"data"` \| `"channels"` \| `"apps"` \| `"shell"` \| `"other"`; `label`: `string`; `caption`: `string`; `description`: `string`; `sigil`: \| `"error"` \| `"read"` \| `"write"` \| `"computer"` \| `"list"` \| `"loop"` \| `"run"` \| `"agent"` \| `"bonsai"` \| `"prints"` \| `"inkcap"` \| `"vishnu"` \| `"generateText"` \| `"generateMedia"` \| `"buyApps"` \| `"browseBazaar"` \| `"chat"` \| `"readConversations"` \| `"listAgents"` \| `"createAgents"` \| `"sendPrompts"` \| `"connected"` \| `"working"` \| `"complete"` \| `"installApps"` \| `"restricted"` \| `"trellis"` \| `"games"` \| `"oyster"` \| `"tourtois"` \| `"allApps"` \| `"search"` \| `"browser"` \| `"internet"` \| `"members"` \| `"sell"` \| `"schedule"` \| `"fungi"`; `consent`: `"affordance"` \| `"install"` \| `"ask"`; `scope`: `"computer"` \| `"agent"` \| `null`; `warning`: `string` \| `null`; \}\> |
903
+ | <a id="property-mediashare"></a> `media.share` | `Readonly`\<\{ `group`: \| `"computers"` \| `"workflows"` \| `"git"` \| `"agents"` \| `"generation"` \| `"bazaar"` \| `"data"` \| `"channels"` \| `"apps"` \| `"shell"` \| `"other"`; `label`: `string`; `caption`: `string`; `description`: `string`; `sigil`: \| `"error"` \| `"read"` \| `"write"` \| `"computer"` \| `"list"` \| `"loop"` \| `"run"` \| `"agent"` \| `"bonsai"` \| `"prints"` \| `"inkcap"` \| `"vishnu"` \| `"generateText"` \| `"generateMedia"` \| `"buyApps"` \| `"browseBazaar"` \| `"chat"` \| `"readConversations"` \| `"listAgents"` \| `"createAgents"` \| `"sendPrompts"` \| `"connected"` \| `"working"` \| `"complete"` \| `"installApps"` \| `"restricted"` \| `"trellis"` \| `"games"` \| `"oyster"` \| `"tourtois"` \| `"allApps"` \| `"search"` \| `"browser"` \| `"internet"` \| `"members"` \| `"sell"` \| `"schedule"` \| `"fungi"`; `consent`: `"affordance"` \| `"install"` \| `"ask"`; `scope`: `"computer"` \| `"agent"` \| `null`; `warning`: `string` \| `null`; \}\> |
899
904
  | <a id="property-gamesservers"></a> `games:servers` | `Readonly`\<\{ `group`: \| `"computers"` \| `"workflows"` \| `"git"` \| `"agents"` \| `"generation"` \| `"bazaar"` \| `"data"` \| `"channels"` \| `"apps"` \| `"shell"` \| `"other"`; `label`: `string`; `caption`: `string`; `description`: `string`; `sigil`: \| `"error"` \| `"read"` \| `"write"` \| `"computer"` \| `"list"` \| `"loop"` \| `"run"` \| `"agent"` \| `"bonsai"` \| `"prints"` \| `"inkcap"` \| `"vishnu"` \| `"generateText"` \| `"generateMedia"` \| `"buyApps"` \| `"browseBazaar"` \| `"chat"` \| `"readConversations"` \| `"listAgents"` \| `"createAgents"` \| `"sendPrompts"` \| `"connected"` \| `"working"` \| `"complete"` \| `"installApps"` \| `"restricted"` \| `"trellis"` \| `"games"` \| `"oyster"` \| `"tourtois"` \| `"allApps"` \| `"search"` \| `"browser"` \| `"internet"` \| `"members"` \| `"sell"` \| `"schedule"` \| `"fungi"`; `consent`: `"affordance"` \| `"install"` \| `"ask"`; `scope`: `"computer"` \| `"agent"` \| `null`; `warning`: `string` \| `null`; \}\> |
900
905
  | <a id="property-gitrepository"></a> `git.repository` | `Readonly`\<\{ `group`: \| `"computers"` \| `"workflows"` \| `"git"` \| `"agents"` \| `"generation"` \| `"bazaar"` \| `"data"` \| `"channels"` \| `"apps"` \| `"shell"` \| `"other"`; `label`: `string`; `caption`: `string`; `description`: `string`; `sigil`: \| `"error"` \| `"read"` \| `"write"` \| `"computer"` \| `"list"` \| `"loop"` \| `"run"` \| `"agent"` \| `"bonsai"` \| `"prints"` \| `"inkcap"` \| `"vishnu"` \| `"generateText"` \| `"generateMedia"` \| `"buyApps"` \| `"browseBazaar"` \| `"chat"` \| `"readConversations"` \| `"listAgents"` \| `"createAgents"` \| `"sendPrompts"` \| `"connected"` \| `"working"` \| `"complete"` \| `"installApps"` \| `"restricted"` \| `"trellis"` \| `"games"` \| `"oyster"` \| `"tourtois"` \| `"allApps"` \| `"search"` \| `"browser"` \| `"internet"` \| `"members"` \| `"sell"` \| `"schedule"` \| `"fungi"`; `consent`: `"affordance"` \| `"install"` \| `"ask"`; `scope`: `"computer"` \| `"agent"` \| `null`; `warning`: `string` \| `null`; \}\> |
901
906
  | <a id="property-appsopen"></a> `apps.open` | `Readonly`\<\{ `group`: \| `"computers"` \| `"workflows"` \| `"git"` \| `"agents"` \| `"generation"` \| `"bazaar"` \| `"data"` \| `"channels"` \| `"apps"` \| `"shell"` \| `"other"`; `label`: `string`; `caption`: `string`; `description`: `string`; `sigil`: \| `"error"` \| `"read"` \| `"write"` \| `"computer"` \| `"list"` \| `"loop"` \| `"run"` \| `"agent"` \| `"bonsai"` \| `"prints"` \| `"inkcap"` \| `"vishnu"` \| `"generateText"` \| `"generateMedia"` \| `"buyApps"` \| `"browseBazaar"` \| `"chat"` \| `"readConversations"` \| `"listAgents"` \| `"createAgents"` \| `"sendPrompts"` \| `"connected"` \| `"working"` \| `"complete"` \| `"installApps"` \| `"restricted"` \| `"trellis"` \| `"games"` \| `"oyster"` \| `"tourtois"` \| `"allApps"` \| `"search"` \| `"browser"` \| `"internet"` \| `"members"` \| `"sell"` \| `"schedule"` \| `"fungi"`; `consent`: `"affordance"` \| `"install"` \| `"ask"`; `scope`: `"computer"` \| `"agent"` \| `null`; `warning`: `string` \| `null`; \}\> |
@@ -948,6 +953,7 @@ const gateRequestSchema: ZodLazy<ZodDiscriminatedUnion<[ZodObject<{
948
953
  | "agent.send"
949
954
  | "llm.generation"
950
955
  | "media.generation"
956
+ | "media.share"
951
957
  | "games:servers"
952
958
  | "git.repository"
953
959
  | "apps.open"
@@ -985,6 +991,7 @@ const gateRequestSchema: ZodLazy<ZodDiscriminatedUnion<[ZodObject<{
985
991
  | "agent.send"
986
992
  | "llm.generation"
987
993
  | "media.generation"
994
+ | "media.share"
988
995
  | "games:servers"
989
996
  | "git.repository"
990
997
  | "apps.open"
@@ -1107,6 +1114,7 @@ const approvedGrantSchema: ZodReadonly<ZodObject<{
1107
1114
  | "agent.send"
1108
1115
  | "llm.generation"
1109
1116
  | "media.generation"
1117
+ | "media.share"
1110
1118
  | "games:servers"
1111
1119
  | "git.repository"
1112
1120
  | "apps.open"
@@ -1163,6 +1171,7 @@ const grantChangeSchema: ZodReadonly<ZodObject<{
1163
1171
  | "agent.send"
1164
1172
  | "llm.generation"
1165
1173
  | "media.generation"
1174
+ | "media.share"
1166
1175
  | "games:servers"
1167
1176
  | "git.repository"
1168
1177
  | "apps.open"
@@ -1225,6 +1234,7 @@ const appAuthoritySchema: ZodObject<{
1225
1234
  | ...
1226
1235
  | ...
1227
1236
  | ...
1237
+ | ...
1228
1238
  | ..., unknown>>;
1229
1239
  capabilityApproved: ZodLiteral<true>;
1230
1240
  operations: ZodLazy<ZodReadonly<ZodArray<...>>>;
@@ -1310,6 +1320,7 @@ const declaredOperationsSchema: ZodLazy<ZodObject<{
1310
1320
  | ...
1311
1321
  | ...
1312
1322
  | ...
1323
+ | ...
1313
1324
  | ..., unknown>>;
1314
1325
  operations: ZodLazy<ZodReadonly<ZodArray<...>>>;
1315
1326
  }, $strict>>>>;
@@ -1619,6 +1630,7 @@ function grantsFor(
1619
1630
  | "agent.send"
1620
1631
  | "llm.generation"
1621
1632
  | "media.generation"
1633
+ | "media.share"
1622
1634
  | "games:servers"
1623
1635
  | "git.repository"
1624
1636
  | "apps.open"
@@ -1651,13 +1663,13 @@ resource selectors.
1651
1663
 
1652
1664
  #### Parameters
1653
1665
 
1654
- | Parameter | Type | Default value |
1655
- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |
1656
- | `installation` | `Pick`\<[`GateFacts`](#gatefacts)\[`"installation"`\], `"status"` \| `"authority"` \| `"artifactDigest"`\> | `undefined` |
1657
- | `declaration` | `AppDeclaration` | `undefined` |
1658
- | `snapshot` | [`DeclaredOperations`](#declaredoperations) | `undefined` |
1659
- | `capability` | \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"` | `undefined` |
1660
- | `resource` | \| `"any"` \| `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\> | `"any"` |
1666
+ | Parameter | Type | Default value |
1667
+ | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |
1668
+ | `installation` | `Pick`\<[`GateFacts`](#gatefacts)\[`"installation"`\], `"status"` \| `"authority"` \| `"artifactDigest"`\> | `undefined` |
1669
+ | `declaration` | `AppDeclaration` | `undefined` |
1670
+ | `snapshot` | [`DeclaredOperations`](#declaredoperations) | `undefined` |
1671
+ | `capability` | \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"` | `undefined` |
1672
+ | `resource` | \| `"any"` \| `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\> | `"any"` |
1661
1673
 
1662
1674
  #### Returns
1663
1675
 
@@ -1665,11 +1677,11 @@ resource selectors.
1665
1677
  `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \|
1666
1678
  `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \|
1667
1679
  `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \|
1668
- `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \|
1669
- `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \|
1670
- `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \|
1671
- `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \|
1672
- `"workflow.arm"` \| `"world"` \| `"channels.read"` \|
1680
+ `"llm.generation"` \| `"media.generation"` \| `"media.share"` \|
1681
+ `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \|
1682
+ `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \|
1683
+ `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \|
1684
+ `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \|
1673
1685
  `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`:
1674
1686
  readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{
1675
1687
  `kind`: `string`; `id`: `string`; \}\>[]; \}\>\> \| `null`
@@ -1715,11 +1727,11 @@ resource authority.
1715
1727
 
1716
1728
  #### Parameters
1717
1729
 
1718
- | Parameter | Type | Default value |
1719
- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |
1720
- | `captured` | readonly `object`[] | `undefined` |
1721
- | `method?` | `Readonly`\<\{ `description`: `string`; `input`: \{ \[`key`: `string`\]: \| `null` \| `string` \| `number` \| `false` \| `true` \| AppApiJsonObject \| \{ \[`index`: `number`\]: AppApiJsonValue; `length`: `number`; \}; \}; `output`: \{ \[`key`: `string`\]: \| `null` \| `string` \| `number` \| `false` \| `true` \| AppApiJsonObject \| \{ \[`index`: `number`\]: AppApiJsonValue; `length`: `number`; \}; \}; `effect`: `"read"` \| `"write"` \| `"external"`; `requires`: readonly ( \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`)[]; `pending?`: `true`; `hidden?`: `true`; `present?`: `Readonly`\<\{ `verb`: `string`; \}\>; \}\> | `undefined` |
1722
- | `ceiling?` | `"read"` \| `"write"` | `"write"` |
1730
+ | Parameter | Type | Default value |
1731
+ | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |
1732
+ | `captured` | readonly `object`[] | `undefined` |
1733
+ | `method?` | `Readonly`\<\{ `description`: `string`; `input`: \{ \[`key`: `string`\]: \| `null` \| `string` \| `number` \| `false` \| `true` \| AppApiJsonObject \| \{ \[`index`: `number`\]: AppApiJsonValue; `length`: `number`; \}; \}; `output`: \{ \[`key`: `string`\]: \| `null` \| `string` \| `number` \| `false` \| `true` \| AppApiJsonObject \| \{ \[`index`: `number`\]: AppApiJsonValue; `length`: `number`; \}; \}; `effect`: `"read"` \| `"write"` \| `"external"`; `requires`: readonly ( \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`)[]; `pending?`: `true`; `hidden?`: `true`; `present?`: `Readonly`\<\{ `verb`: `string`; \}\>; \}\> | `undefined` |
1734
+ | `ceiling?` | `"read"` \| `"write"` | `"write"` |
1723
1735
 
1724
1736
  #### Returns
1725
1737
 
@@ -1784,10 +1796,10 @@ stay outside this pure gate.
1784
1796
 
1785
1797
  #### Parameters
1786
1798
 
1787
- | Parameter | Type |
1788
- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1789
- | `facts` | [`GateFacts`](#gatefacts) |
1790
- | `rawRequest` | \| \{ `kind`: `"method"`; `name`: `string`; `input`: `unknown`; `via`: `"ui"` \| `"agent"` \| `"mcp"` \| `"workflow"`; `resource?`: `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>; \} \| \{ `kind`: `"capability"`; `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `operation?`: `string`; `resource`: \| `"any"` \| `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>; \} \| \{ `kind`: `"capability-route"`; `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `operation`: `string`; `effect`: `"read"` \| `"write"`; \} \| \{ `kind`: `"binding"`; `binding`: \| `"BACKGROUND"` \| `"GIT"` \| `"EVENTS"` \| `"APPS"` \| `"WORKFLOWS"` \| `"APP_STORAGE"` \| `"MEDIA"` \| `"COMPUTER"` \| `"INBOX"` \| `"AGENTS"`; `operation`: `string`; \} \| \{ `kind`: `"list-tools"`; \} \| \{ `kind`: `"backend"`; \} |
1799
+ | Parameter | Type |
1800
+ | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1801
+ | `facts` | [`GateFacts`](#gatefacts) |
1802
+ | `rawRequest` | \| \{ `kind`: `"method"`; `name`: `string`; `input`: `unknown`; `via`: `"ui"` \| `"agent"` \| `"mcp"` \| `"workflow"`; `resource?`: `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>; \} \| \{ `kind`: `"capability"`; `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `operation?`: `string`; `resource`: \| `"any"` \| `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>; \} \| \{ `kind`: `"capability-route"`; `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `operation`: `string`; `effect`: `"read"` \| `"write"`; \} \| \{ `kind`: `"binding"`; `binding`: \| `"BACKGROUND"` \| `"GIT"` \| `"EVENTS"` \| `"APPS"` \| `"WORKFLOWS"` \| `"APP_STORAGE"` \| `"MEDIA"` \| `"COMPUTER"` \| `"INBOX"` \| `"AGENTS"`; `operation`: `string`; \} \| \{ `kind`: `"list-tools"`; \} \| \{ `kind`: `"backend"`; \} |
1791
1803
 
1792
1804
  #### Returns
1793
1805
 
@@ -1822,6 +1834,7 @@ function applyGrantCommand(
1822
1834
  | "agent.send"
1823
1835
  | "llm.generation"
1824
1836
  | "media.generation"
1837
+ | "media.share"
1825
1838
  | "games:servers"
1826
1839
  | "git.repository"
1827
1840
  | "apps.open"
@@ -1875,11 +1888,11 @@ One host-independent approval policy; selection only intersects existing grants.
1875
1888
 
1876
1889
  #### Parameters
1877
1890
 
1878
- | Parameter | Type |
1879
- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1880
- | `current` | \| \{ `authorityVersion`: `number`; `declaredOperationsDigest`: `Sha256Digest`; `approvedGrants`: readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>[]; `approval`: \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null`; \} \| `null` |
1881
- | `rawCommand` | \| \{ `kind`: `"install"`; \} \| \{ `kind`: `"change-grants"`; `changes`: readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `grant`: \| `Readonly`\<\{ `operations`: readonly `string`[]; `resources`: `"tenant-scope"` \| readonly `Readonly`\<...\>[]; \}\> \| `null`; \}\>[]; \} \| \{ `kind`: `"select-release"`; \} \| \{ `kind`: `"delete"`; \} |
1882
- | `context` | [`GrantContext`](#grantcontext) |
1891
+ | Parameter | Type |
1892
+ | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
1893
+ | `current` | \| \{ `authorityVersion`: `number`; `declaredOperationsDigest`: `Sha256Digest`; `approvedGrants`: readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>[]; `approval`: \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null`; \} \| `null` |
1894
+ | `rawCommand` | \| \{ `kind`: `"install"`; \} \| \{ `kind`: `"change-grants"`; `changes`: readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `grant`: \| `Readonly`\<\{ `operations`: readonly `string`[]; `resources`: `"tenant-scope"` \| readonly `Readonly`\<...\>[]; \}\> \| `null`; \}\>[]; \} \| \{ `kind`: `"select-release"`; \} \| \{ `kind`: `"delete"`; \} |
1895
+ | `context` | [`GrantContext`](#grantcontext) |
1883
1896
 
1884
1897
  #### Returns
1885
1898
 
@@ -1889,15 +1902,15 @@ One host-independent approval policy; selection only intersects existing grants.
1889
1902
  `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \|
1890
1903
  `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"`
1891
1904
  \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \|
1892
- `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \|
1893
- `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \|
1894
- `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \|
1895
- `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \|
1896
- `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`:
1897
- readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{
1898
- `kind`: `string`; `id`: `string`; \}\>[]; \}\>[]; `approval`: \| `Readonly`\<\{
1899
- `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`:
1900
- `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`:
1905
+ `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \|
1906
+ `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \|
1907
+ `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \|
1908
+ `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \|
1909
+ `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`;
1910
+ `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly
1911
+ `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>[]; `approval`: \|
1912
+ `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{
1913
+ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`:
1901
1914
  `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null`; \},
1902
1915
  `Readonly`\<\{ `kind`: `"refused"`; `code`: `"stale_authority"` \|
1903
1916
  `"not_declared"` \| `"not_owner"` \| `"invalid_command"`; \}\>\>
@@ -1933,11 +1946,11 @@ Pure transition; hosts retain transactions, receipts, epochs and delivery.
1933
1946
 
1934
1947
  #### Parameters
1935
1948
 
1936
- | Parameter | Type |
1937
- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1938
- | `current` | \| `Readonly`\<\{ `installationId`: `string`; `instanceId`: [`InstanceId`](index.md#instanceid) \| `null`; `appId`: `AppId`; `release`: \{ `releaseId`: `ReleaseId`; `appId`: `AppId`; `artifact`: \{ `artifactRef`: `ArtifactRef`; `artifactDigest`: `Sha256Digest`; `provenance`: \{ `sourceRevision`: `SourceRevision`; `sourceTreeDigest`: `Sha256Digest`; `buildRecipeDigest`: `Sha256Digest`; \}; \}; \}; `releasePin`: `"pinned"` \| `"floating"`; `authority`: \{ `authorityVersion`: `number`; `declaredOperationsDigest`: `Sha256Digest`; `approvedGrants`: readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: ...; `id`: ...; \}\>[]; \}\>[]; `approval`: \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null`; \}; `status`: `"enabled"` \| `"disabled"` \| `"deleted"`; \}\> \| `null` |
1939
- | `rawCommand` | \| \{ `release`: \{ `releaseId`: `ReleaseId`; `appId`: `AppId`; `artifact`: \{ `artifactRef`: `ArtifactRef`; `artifactDigest`: `Sha256Digest`; `provenance`: \{ `sourceRevision`: `SourceRevision`; `sourceTreeDigest`: `Sha256Digest`; `buildRecipeDigest`: `Sha256Digest`; \}; \}; \}; `releasePin`: `"pinned"` \| `"floating"`; `kind`: `"install"`; \} \| \{ `release`: \{ `releaseId`: `ReleaseId`; `appId`: `AppId`; `artifact`: \{ `artifactRef`: `ArtifactRef`; `artifactDigest`: `Sha256Digest`; `provenance`: \{ `sourceRevision`: `SourceRevision`; `sourceTreeDigest`: `Sha256Digest`; `buildRecipeDigest`: `Sha256Digest`; \}; \}; \}; `releasePin`: `"pinned"` \| `"floating"`; `kind`: `"select-release"`; \} \| \{ `kind`: `"set-status"`; `status`: `"enabled"` \| `"disabled"` \| `"deleted"`; \} \| \{ `kind`: `"change-grants"`; `changes`: readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `grant`: \| `Readonly`\<\{ `operations`: readonly `string`[]; `resources`: `"tenant-scope"` \| readonly `Readonly`\<...\>[]; \}\> \| `null`; \}\>[]; \} |
1940
- | `context` | [`InstallationContext`](#installationcontext) |
1949
+ | Parameter | Type |
1950
+ | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1951
+ | `current` | \| `Readonly`\<\{ `installationId`: `string`; `instanceId`: [`InstanceId`](index.md#instanceid) \| `null`; `appId`: `AppId`; `release`: \{ `releaseId`: `ReleaseId`; `appId`: `AppId`; `artifact`: \{ `artifactRef`: `ArtifactRef`; `artifactDigest`: `Sha256Digest`; `provenance`: \{ `sourceRevision`: `SourceRevision`; `sourceTreeDigest`: `Sha256Digest`; `buildRecipeDigest`: `Sha256Digest`; \}; \}; \}; `releasePin`: `"pinned"` \| `"floating"`; `authority`: \{ `authorityVersion`: `number`; `declaredOperationsDigest`: `Sha256Digest`; `approvedGrants`: readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: ...; `id`: ...; \}\>[]; \}\>[]; `approval`: \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null`; \}; `status`: `"enabled"` \| `"disabled"` \| `"deleted"`; \}\> \| `null` |
1952
+ | `rawCommand` | \| \{ `release`: \{ `releaseId`: `ReleaseId`; `appId`: `AppId`; `artifact`: \{ `artifactRef`: `ArtifactRef`; `artifactDigest`: `Sha256Digest`; `provenance`: \{ `sourceRevision`: `SourceRevision`; `sourceTreeDigest`: `Sha256Digest`; `buildRecipeDigest`: `Sha256Digest`; \}; \}; \}; `releasePin`: `"pinned"` \| `"floating"`; `kind`: `"install"`; \} \| \{ `release`: \{ `releaseId`: `ReleaseId`; `appId`: `AppId`; `artifact`: \{ `artifactRef`: `ArtifactRef`; `artifactDigest`: `Sha256Digest`; `provenance`: \{ `sourceRevision`: `SourceRevision`; `sourceTreeDigest`: `Sha256Digest`; `buildRecipeDigest`: `Sha256Digest`; \}; \}; \}; `releasePin`: `"pinned"` \| `"floating"`; `kind`: `"select-release"`; \} \| \{ `kind`: `"set-status"`; `status`: `"enabled"` \| `"disabled"` \| `"deleted"`; \} \| \{ `kind`: `"change-grants"`; `changes`: readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `grant`: \| `Readonly`\<\{ `operations`: readonly `string`[]; `resources`: `"tenant-scope"` \| readonly `Readonly`\<...\>[]; \}\> \| `null`; \}\>[]; \} |
1953
+ | `context` | [`InstallationContext`](#installationcontext) |
1941
1954
 
1942
1955
  #### Returns
1943
1956
 
@@ -1997,6 +2010,7 @@ function deriveDeclaredOperations(
1997
2010
  | "agent.send"
1998
2011
  | "llm.generation"
1999
2012
  | "media.generation"
2013
+ | "media.share"
2000
2014
  | "games:servers"
2001
2015
  | "git.repository"
2002
2016
  | "apps.open"
@@ -2046,11 +2060,12 @@ host adapters.
2046
2060
  `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \|
2047
2061
  `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"`
2048
2062
  \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \|
2049
- `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \|
2050
- `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \|
2051
- `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \|
2052
- `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \|
2053
- `"channels.personal.manage"`; `operations`: readonly `string`[]; \}\>[]; \}\>\>
2063
+ `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \|
2064
+ `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \|
2065
+ `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \|
2066
+ `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \|
2067
+ `"channels.read"` \| `"channels.personal.manage"`; `operations`: readonly
2068
+ `string`[]; \}\>[]; \}\>\>
2054
2069
 
2055
2070
  ---
2056
2071
 
@@ -2076,6 +2091,7 @@ function pendingCapabilities(
2076
2091
  | "agent.send"
2077
2092
  | "llm.generation"
2078
2093
  | "media.generation"
2094
+ | "media.share"
2079
2095
  | "games:servers"
2080
2096
  | "git.repository"
2081
2097
  | "apps.open"
@@ -2110,11 +2126,12 @@ readonly ( \| `"computer.list"` \| `"computer.readFile"` \|
2110
2126
  `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \|
2111
2127
  `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \|
2112
2128
  `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"`
2113
- \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \|
2114
- `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \|
2115
- `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \|
2116
- `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \|
2117
- `"channels.read"` \| `"channels.personal.manage"`)[]
2129
+ \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \|
2130
+ `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \|
2131
+ `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \|
2132
+ `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \|
2133
+ `"workflow.arm"` \| `"world"` \| `"channels.read"` \|
2134
+ `"channels.personal.manage"`)[]
2118
2135
 
2119
2136
  ---
2120
2137
 
@@ -2133,16 +2150,16 @@ Bound the real SDK request; an Allow never silently widens selected resources.
2133
2150
 
2134
2151
  #### Parameters
2135
2152
 
2136
- | Parameter | Type |
2137
- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2138
- | `authority` | \{ `authorityVersion`: `number`; `declaredOperationsDigest`: `Sha256Digest`; `approvedGrants`: readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>[]; `approval`: \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null`; \} |
2139
- | `authority.authorityVersion` | `number` |
2140
- | `authority.declaredOperationsDigest` | `Sha256Digest` |
2141
- | `authority.approvedGrants` | readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>[] |
2142
- | `authority.approval` | \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null` |
2143
- | `facts` | `Readonly`\<\{ `declaration`: `Pick`\<`AppDeclaration`, `"capabilities"`\>; `declaredOperations`: [`DeclaredOperations`](#declaredoperations); \}\> |
2144
- | `request` | `AppPermissionRequest` |
2145
- | `window` | `Readonly`\<\{ `computerId`: `string` \| `null`; \}\> |
2153
+ | Parameter | Type |
2154
+ | ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2155
+ | `authority` | \{ `authorityVersion`: `number`; `declaredOperationsDigest`: `Sha256Digest`; `approvedGrants`: readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>[]; `approval`: \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null`; \} |
2156
+ | `authority.authorityVersion` | `number` |
2157
+ | `authority.declaredOperationsDigest` | `Sha256Digest` |
2158
+ | `authority.approvedGrants` | readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>[] |
2159
+ | `authority.approval` | \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null` |
2160
+ | `facts` | `Readonly`\<\{ `declaration`: `Pick`\<`AppDeclaration`, `"capabilities"`\>; `declaredOperations`: [`DeclaredOperations`](#declaredoperations); \}\> |
2161
+ | `request` | `AppPermissionRequest` |
2162
+ | `window` | `Readonly`\<\{ `computerId`: `string` \| `null`; \}\> |
2146
2163
 
2147
2164
  #### Returns
2148
2165
 
@@ -2161,13 +2178,13 @@ rows.
2161
2178
 
2162
2179
  #### Parameters
2163
2180
 
2164
- | Parameter | Type |
2165
- | ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2166
- | `authority` | \{ `authorityVersion`: `number`; `declaredOperationsDigest`: `Sha256Digest`; `approvedGrants`: readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>[]; `approval`: \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null`; \} |
2167
- | `authority.authorityVersion` | `number` |
2168
- | `authority.declaredOperationsDigest` | `Sha256Digest` |
2169
- | `authority.approvedGrants` | readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>[] |
2170
- | `authority.approval` | \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null` |
2181
+ | Parameter | Type |
2182
+ | ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2183
+ | `authority` | \{ `authorityVersion`: `number`; `declaredOperationsDigest`: `Sha256Digest`; `approvedGrants`: readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>[]; `approval`: \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null`; \} |
2184
+ | `authority.authorityVersion` | `number` |
2185
+ | `authority.declaredOperationsDigest` | `Sha256Digest` |
2186
+ | `authority.approvedGrants` | readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>[] |
2187
+ | `authority.approval` | \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null` |
2171
2188
 
2172
2189
  #### Returns
2173
2190
 
@@ -2220,6 +2237,7 @@ function planGrantChange(
2220
2237
  | "agent.send"
2221
2238
  | "llm.generation"
2222
2239
  | "media.generation"
2240
+ | "media.share"
2223
2241
  | "games:servers"
2224
2242
  | "git.repository"
2225
2243
  | "apps.open"
@@ -2251,14 +2269,14 @@ Only touched capability rows cross the save boundary.
2251
2269
 
2252
2270
  #### Parameters
2253
2271
 
2254
- | Parameter | Type |
2255
- | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2256
- | `baseline` | \{ `authorityVersion`: `number`; `declaredOperationsDigest`: `Sha256Digest`; `approvedGrants`: readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>[]; `approval`: \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null`; \} |
2257
- | `baseline.authorityVersion` | `number` |
2258
- | `baseline.declaredOperationsDigest` | `Sha256Digest` |
2259
- | `baseline.approvedGrants` | readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>[] |
2260
- | `baseline.approval` | \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null` |
2261
- | `draft` | [`PermissionDraft`](#permissiondraft) |
2272
+ | Parameter | Type |
2273
+ | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2274
+ | `baseline` | \{ `authorityVersion`: `number`; `declaredOperationsDigest`: `Sha256Digest`; `approvedGrants`: readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>[]; `approval`: \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null`; \} |
2275
+ | `baseline.authorityVersion` | `number` |
2276
+ | `baseline.declaredOperationsDigest` | `Sha256Digest` |
2277
+ | `baseline.approvedGrants` | readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>[] |
2278
+ | `baseline.approval` | \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null` |
2279
+ | `draft` | [`PermissionDraft`](#permissiondraft) |
2262
2280
 
2263
2281
  #### Returns
2264
2282
 
@@ -2266,11 +2284,11 @@ readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \|
2266
2284
  `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \|
2267
2285
  `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \|
2268
2286
  `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \|
2269
- `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \|
2270
- `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \|
2271
- `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \|
2272
- `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \|
2273
- `"workflow.arm"` \| `"world"` \| `"channels.read"` \|
2287
+ `"llm.generation"` \| `"media.generation"` \| `"media.share"` \|
2288
+ `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \|
2289
+ `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \|
2290
+ `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \|
2291
+ `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \|
2274
2292
  `"channels.personal.manage"`; `grant`: \| `Readonly`\<\{ `operations`: readonly
2275
2293
  `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`:
2276
2294
  `string`; `id`: `string`; \}\>[]; \}\> \| `null`; \}\>[]
@@ -2288,19 +2306,19 @@ capabilities.
2288
2306
 
2289
2307
  #### Parameters
2290
2308
 
2291
- | Parameter | Type |
2292
- | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2293
- | `draft` | [`PermissionDraft`](#permissiondraft) |
2294
- | `baseline` | \{ `authorityVersion`: `number`; `declaredOperationsDigest`: `Sha256Digest`; `approvedGrants`: readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>[]; `approval`: \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null`; \} |
2295
- | `baseline.authorityVersion` | `number` |
2296
- | `baseline.declaredOperationsDigest` | `Sha256Digest` |
2297
- | `baseline.approvedGrants` | readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>[] |
2298
- | `baseline.approval` | \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null` |
2299
- | `current` | \{ `authorityVersion`: `number`; `declaredOperationsDigest`: `Sha256Digest`; `approvedGrants`: readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>[]; `approval`: \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null`; \} |
2300
- | `current.authorityVersion` | `number` |
2301
- | `current.declaredOperationsDigest` | `Sha256Digest` |
2302
- | `current.approvedGrants` | readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>[] |
2303
- | `current.approval` | \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null` |
2309
+ | Parameter | Type |
2310
+ | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2311
+ | `draft` | [`PermissionDraft`](#permissiondraft) |
2312
+ | `baseline` | \{ `authorityVersion`: `number`; `declaredOperationsDigest`: `Sha256Digest`; `approvedGrants`: readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>[]; `approval`: \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null`; \} |
2313
+ | `baseline.authorityVersion` | `number` |
2314
+ | `baseline.declaredOperationsDigest` | `Sha256Digest` |
2315
+ | `baseline.approvedGrants` | readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>[] |
2316
+ | `baseline.approval` | \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null` |
2317
+ | `current` | \{ `authorityVersion`: `number`; `declaredOperationsDigest`: `Sha256Digest`; `approvedGrants`: readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>[]; `approval`: \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null`; \} |
2318
+ | `current.authorityVersion` | `number` |
2319
+ | `current.declaredOperationsDigest` | `Sha256Digest` |
2320
+ | `current.approvedGrants` | readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>[] |
2321
+ | `current.approval` | \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null` |
2304
2322
 
2305
2323
  #### Returns
2306
2324