@fungi.computer/oyster 0.28.1 → 0.29.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 (43) hide show
  1. package/README.md +4 -0
  2. package/dist/apps/catalog.js +1 -1
  3. package/dist/apps/gate.d.ts +2 -1
  4. package/dist/apps/gate.js +10 -7
  5. package/dist/apps/index.d.ts +1 -1
  6. package/dist/apps/index.js +1 -1
  7. package/dist/apps/installation.d.ts +27 -5
  8. package/dist/apps/installation.js +86 -29
  9. package/dist/apps/operations.d.ts +5 -0
  10. package/dist/apps/operations.js +49 -10
  11. package/dist/apps/permissions.d.ts +23 -7
  12. package/dist/apps/permissions.js +5 -1
  13. package/dist/authorization.d.ts +2 -1
  14. package/dist/boot-host-script.js +1 -1
  15. package/dist/build/candidate-cli.mjs +1823 -1833
  16. package/dist/embed-metafiles.js +2 -2
  17. package/dist/embed-scripts.js +1 -1
  18. package/dist/host.js +7 -2
  19. package/dist/installation-migration.d.ts +5 -0
  20. package/dist/installation-migration.js +78 -0
  21. package/dist/installation-operations.d.ts +8 -0
  22. package/dist/installation-operations.js +2 -0
  23. package/dist/invocation.d.ts +3 -3
  24. package/dist/page-script.js +2 -2
  25. package/dist/standalone/computer.d.ts +2 -2
  26. package/dist/standalone/registry.d.ts +2 -2
  27. package/dist/standalone/workflow-host.d.ts +6 -1
  28. package/dist/tenancy/cloudflare/registry.js +6 -2
  29. package/dist/tenancy/contracts.d.ts +4 -3
  30. package/dist/tenancy/index.js +2 -1
  31. package/dist/tenant.d.ts +2 -1
  32. package/dist/workers.js +2 -0
  33. package/docs/api/apps.md +108 -81
  34. package/docs/api/authorization.md +1 -1
  35. package/docs/api/git.md +4 -4
  36. package/docs/api/host.md +8 -2
  37. package/docs/api/invocation.md +87 -87
  38. package/docs/api/mcp.md +16 -16
  39. package/docs/api/tenancy.md +3 -3
  40. package/docs/api/tenant.md +1 -1
  41. package/docs/api/workers-git.md +157 -157
  42. package/docs/api/workers.md +231 -221
  43. package/package.json +17 -17
package/docs/api/apps.md CHANGED
@@ -66,6 +66,7 @@ readonly read(appKey): Promise<
66
66
  | "channels.personal.manage";
67
67
  capabilityApproved: true;
68
68
  operations: readonly string[];
69
+ fingerprints: Readonly<Record<string, string>>;
69
70
  resources: "tenant-scope" | readonly Readonly<...>[];
70
71
  }>[];
71
72
  approval: | Readonly<{
@@ -122,6 +123,7 @@ readonly read(appKey): Promise<
122
123
  | "channels.read"
123
124
  | "channels.personal.manage";
124
125
  operations: readonly string[];
126
+ fingerprints: Readonly<Record<string, string>>;
125
127
  }>[];
126
128
  };
127
129
  };
@@ -155,9 +157,10 @@ and the available resources.
155
157
  `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \|
156
158
  `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \|
157
159
  `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`;
158
- `operations`: readonly `string`[]; `resources`: `"tenant-scope"` \| readonly
159
- `Readonly`\<...\>[]; \}\>[]; `approval`: \| `Readonly`\<\{ `by`: \| \{ `kind`:
160
- `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`:
160
+ `operations`: readonly `string`[]; `fingerprints`:
161
+ `Readonly`\<`Record`\<`string`, `string`\>\>; `resources`: `"tenant-scope"` \|
162
+ readonly `Readonly`\<...\>[]; \}\>[]; `approval`: \| `Readonly`\<\{ `by`: \| \{
163
+ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`:
161
164
  `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`;
162
165
  `authorityVersion`: `number`; \}\> \| `null`; \}; `declaredOperations`: \{
163
166
  `artifactDigest`: `Sha256Digest`; `digest`: `Sha256Digest`; `capabilities`:
@@ -171,7 +174,8 @@ readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \|
171
174
  `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \|
172
175
  `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \|
173
176
  `"channels.read"` \| `"channels.personal.manage"`; `operations`: readonly
174
- `string`[]; \}\>[]; \}; \}; `canEdit`: `boolean`; `resources`: `object`[]; \}\>
177
+ `string`[]; `fingerprints`: `Readonly`\<`Record`\<`string`, `string`\>\>;
178
+ \}\>[]; \}; \}; `canEdit`: `boolean`; `resources`: `object`[]; \}\>
175
179
 
176
180
  ##### submit()
177
181
 
@@ -240,7 +244,7 @@ Consent and resource semantics belong to the grant owner, not its UI.
240
244
  ```ts
241
245
  type HostPrincipal = Readonly<{
242
246
  actor: HostActor;
243
- role: "owner" | "member" | null;
247
+ role: TeamRole | null;
244
248
  }>;
245
249
  ```
246
250
 
@@ -426,7 +430,7 @@ host-owned.
426
430
  ```ts
427
431
  type GrantRefusal = Readonly<{
428
432
  kind: "refused";
429
- code: "stale_authority" | "not_owner" | "not_declared" | "invalid_command";
433
+ code: "stale_authority" | "not_approver" | "not_declared" | "invalid_command";
430
434
  }>;
431
435
  ```
432
436
 
@@ -451,7 +455,7 @@ host-owned.
451
455
  ```ts
452
456
  type CapabilityOperationDescriptor = Pick<
453
457
  CapabilityDescriptor,
454
- "id" | "methods"
458
+ "id" | "base" | "methods"
455
459
  > &
456
460
  Readonly<{
457
461
  permission: ApprovedGrant["capability"];
@@ -490,7 +494,7 @@ host-owned.
490
494
  ```ts
491
495
  type InstallationContext = Readonly<{
492
496
  by: HostActor;
493
- role: "owner" | "member" | null;
497
+ role: TeamRole | null;
494
498
  expectedVersion: number | null;
495
499
  declaration: AppDeclaration;
496
500
  declaredOperations: DeclaredOperations;
@@ -589,6 +593,7 @@ type InstallationReader = Readonly<{
589
593
  | ...;
590
594
  capabilityApproved: true;
591
595
  operations: readonly ...[];
596
+ fingerprints: Readonly<...>;
592
597
  resources: ... | ...;
593
598
  }>[];
594
599
  approval: | Readonly<{
@@ -656,6 +661,7 @@ type InstallationReader = Readonly<{
656
661
  | ...;
657
662
  capabilityApproved: true;
658
663
  operations: readonly ...[];
664
+ fingerprints: Readonly<...>;
659
665
  resources: ... | ...;
660
666
  }>[];
661
667
  approval: | Readonly<{
@@ -1104,6 +1110,18 @@ Installation names cannot contain the tenant separator.
1104
1110
 
1105
1111
  ---
1106
1112
 
1113
+ ### unstampedFingerprint
1114
+
1115
+ ```ts
1116
+ const unstampedFingerprint: "unstamped" = "unstamped";
1117
+ ```
1118
+
1119
+ Stands in for the fingerprint of an operation approved before fingerprints
1120
+ existed. The storage migration writes it; the first snapshot that carries the
1121
+ operation by name replaces it with the declared fingerprint (`carryGrant`).
1122
+
1123
+ ---
1124
+
1107
1125
  ### approvedGrantSchema
1108
1126
 
1109
1127
  ```ts
@@ -1142,6 +1160,7 @@ const approvedGrantSchema: ZodReadonly<ZodObject<{
1142
1160
  | "channels.personal.manage", unknown>>;
1143
1161
  capabilityApproved: ZodLiteral<true>;
1144
1162
  operations: ZodLazy<ZodReadonly<ZodArray<ZodString>>>;
1163
+ fingerprints: ZodLazy<ZodReadonly<ZodRecord<ZodString, ZodString>>>;
1145
1164
  resources: ZodUnion<readonly [ZodLiteral<"tenant-scope">, ZodReadonly<ZodArray<ZodLazy<ZodReadonly<ZodObject<{
1146
1165
  kind: ...;
1147
1166
  id: ...;
@@ -1152,13 +1171,17 @@ const approvedGrantSchema: ZodReadonly<ZodObject<{
1152
1171
  Consent approves capabilities, with explicit operation and resource ceilings. A
1153
1172
  Release adding a method that requires an already-approved capability needs no
1154
1173
  new consent; a new capability does. Release selection intersects stored
1155
- operations instead of adding approvals. Each Worker call is still restricted to
1156
- that method's declared requires, never the App's complete capability set. Only
1157
- an approved install or change-grants command mints capabilityApproved. Empty
1158
- operation rows retain that consent; removing the capability revokes it.
1159
- route:app.methods rows record approval detail, not a method allowlist: narrowing
1160
- them in change-grants does not restrict methods using an approved capability.
1161
- Exact operation rows are enforced for capability routes and backend bindings.
1174
+ operations instead of adding approvals: an operation carries only when its name
1175
+ and its fingerprint (the host descriptor method entry, or the binding operation,
1176
+ that defines what it does) both match the approval, so a same-named operation
1177
+ whose behavior changed needs approval again, as a new operation does. Each
1178
+ Worker call is still restricted to that method's declared requires, never the
1179
+ App's complete capability set. Only an approved install or change-grants command
1180
+ mints capabilityApproved. Empty operation rows retain that consent; removing the
1181
+ capability revokes it. route:app.methods rows record approval detail, not a
1182
+ method allowlist: narrowing them in change-grants does not restrict methods
1183
+ using an approved capability. Exact operation rows are enforced for capability
1184
+ routes and backend bindings.
1162
1185
 
1163
1186
  ---
1164
1187
 
@@ -1250,6 +1273,7 @@ const appAuthoritySchema: ZodObject<{
1250
1273
  | ..., unknown>>;
1251
1274
  capabilityApproved: ZodLiteral<true>;
1252
1275
  operations: ZodLazy<ZodReadonly<ZodArray<...>>>;
1276
+ fingerprints: ZodLazy<ZodReadonly<ZodRecord<..., ...>>>;
1253
1277
  resources: ZodUnion<readonly [ZodLiteral<...>, ZodReadonly<...>]>;
1254
1278
  }, $strict>>>>>;
1255
1279
  approval: ZodNullable<ZodLazy<ZodReadonly<ZodObject<{
@@ -1336,6 +1360,7 @@ const declaredOperationsSchema: ZodLazy<ZodObject<{
1336
1360
  | ...
1337
1361
  | ..., unknown>>;
1338
1362
  operations: ZodLazy<ZodReadonly<ZodArray<...>>>;
1363
+ fingerprints: ZodLazy<ZodReadonly<ZodRecord<..., ...>>>;
1339
1364
  }, $strict>>>>;
1340
1365
  }, $strict>>;
1341
1366
  ```
@@ -1376,6 +1401,7 @@ const installationSchema: ZodObject<{
1376
1401
  capability: ZodPipe<..., ...>;
1377
1402
  capabilityApproved: ZodLiteral<...>;
1378
1403
  operations: ZodLazy<...>;
1404
+ fingerprints: ZodLazy<...>;
1379
1405
  resources: ZodUnion<...>;
1380
1406
  }, $strict>>>>>;
1381
1407
  approval: ZodNullable<ZodLazy<ZodReadonly<ZodObject<{
@@ -1470,7 +1496,7 @@ const installationRefusalSchema: ZodLazy<
1470
1496
  stale_authority: "stale_authority";
1471
1497
  not_declared: "not_declared";
1472
1498
  release_app_mismatch: "release_app_mismatch";
1473
- not_owner: "not_owner";
1499
+ not_approver: "not_approver";
1474
1500
  invalid_command: "invalid_command";
1475
1501
  }>;
1476
1502
  },
@@ -1494,6 +1520,7 @@ const appPermissionsWireSchema: ZodObject<{
1494
1520
  capability: ZodPipe<..., ...>;
1495
1521
  capabilityApproved: ZodLiteral<...>;
1496
1522
  operations: ZodLazy<...>;
1523
+ fingerprints: ZodLazy<...>;
1497
1524
  resources: ZodUnion<...>;
1498
1525
  }, $strict>>>>>;
1499
1526
  approval: ZodNullable<ZodLazy<ZodReadonly<ZodObject<{
@@ -1508,6 +1535,7 @@ const appPermissionsWireSchema: ZodObject<{
1508
1535
  capabilities: ZodReadonly<ZodArray<ZodReadonly<ZodObject<{
1509
1536
  capability: ZodPipe<..., ...>;
1510
1537
  operations: ZodLazy<...>;
1538
+ fingerprints: ZodLazy<...>;
1511
1539
  }, $strict>>>>;
1512
1540
  }, $strict>>;
1513
1541
  }, $strict>;
@@ -1672,6 +1700,7 @@ function grantsFor(
1672
1700
  | "channels.personal.manage";
1673
1701
  capabilityApproved: true;
1674
1702
  operations: readonly string[];
1703
+ fingerprints: Readonly<Record<string, string>>;
1675
1704
  resources:
1676
1705
  | "tenant-scope"
1677
1706
  | readonly Readonly<{
@@ -1707,8 +1736,10 @@ resource selectors.
1707
1736
  `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \|
1708
1737
  `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \|
1709
1738
  `"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`;
1710
- `operations`: readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly
1711
- `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>\> \| `null`
1739
+ `operations`: readonly `string`[]; `fingerprints`:
1740
+ `Readonly`\<`Record`\<`string`, `string`\>\>; `resources`: \| `"tenant-scope"`
1741
+ \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>\> \|
1742
+ `null`
1712
1743
 
1713
1744
  ---
1714
1745
 
@@ -1877,6 +1908,7 @@ function applyGrantCommand(
1877
1908
  | "channels.personal.manage";
1878
1909
  capabilityApproved: true;
1879
1910
  operations: readonly string[];
1911
+ fingerprints: Readonly<Record<string, string>>;
1880
1912
  resources:
1881
1913
  | "tenant-scope"
1882
1914
  | readonly Readonly<{
@@ -1904,7 +1936,8 @@ function applyGrantCommand(
1904
1936
  },
1905
1937
  Readonly<{
1906
1938
  kind: "refused";
1907
- code: "stale_authority" | "not_declared" | "not_owner" | "invalid_command";
1939
+ code:
1940
+ "stale_authority" | "not_declared" | "not_approver" | "invalid_command";
1908
1941
  }>
1909
1942
  >;
1910
1943
  ```
@@ -1913,11 +1946,11 @@ One host-independent approval policy; selection only intersects existing grants.
1913
1946
 
1914
1947
  #### Parameters
1915
1948
 
1916
- | Parameter | Type |
1917
- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1918
- | `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.instructions"` \| `"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` |
1919
- | `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.instructions"` \| `"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"`; \} |
1920
- | `context` | [`GrantContext`](#grantcontext) |
1949
+ | Parameter | Type |
1950
+ | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
1951
+ | `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.instructions"` \| `"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`[]; `fingerprints`: `Readonly`\<`Record`\<`string`, `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` |
1952
+ | `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.instructions"` \| `"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"`; \} |
1953
+ | `context` | [`GrantContext`](#grantcontext) |
1921
1954
 
1922
1955
  #### Returns
1923
1956
 
@@ -1933,13 +1966,14 @@ One host-independent approval policy; selection only intersects existing grants.
1933
1966
  `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \|
1934
1967
  `"workflow.arm"` \| `"world"` \| `"channels.read"` \|
1935
1968
  `"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`:
1936
- readonly `string`[]; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{
1969
+ readonly `string`[]; `fingerprints`: `Readonly`\<`Record`\<`string`,
1970
+ `string`\>\>; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{
1937
1971
  `kind`: `string`; `id`: `string`; \}\>[]; \}\>[]; `approval`: \| `Readonly`\<\{
1938
1972
  `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`:
1939
1973
  `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`:
1940
1974
  `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null`; \},
1941
1975
  `Readonly`\<\{ `kind`: `"refused"`; `code`: `"stale_authority"` \|
1942
- `"not_declared"` \| `"not_owner"` \| `"invalid_command"`; \}\>\>
1976
+ `"not_declared"` \| `"not_approver"` \| `"invalid_command"`; \}\>\>
1943
1977
 
1944
1978
  ---
1945
1979
 
@@ -1962,7 +1996,7 @@ function applyInstallationCommand(
1962
1996
  | "stale_authority"
1963
1997
  | "not_declared"
1964
1998
  | "release_app_mismatch"
1965
- | "not_owner"
1999
+ | "not_approver"
1966
2000
  | "invalid_command";
1967
2001
  }
1968
2002
  >;
@@ -1972,18 +2006,18 @@ Pure transition; hosts retain transactions, receipts, epochs and delivery.
1972
2006
 
1973
2007
  #### Parameters
1974
2008
 
1975
- | Parameter | Type |
1976
- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
1977
- | `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.instructions"` \| `"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` |
1978
- | `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.instructions"` \| `"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`; \}\>[]; \} |
1979
- | `context` | [`InstallationContext`](#installationcontext) |
2009
+ | Parameter | Type |
2010
+ | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2011
+ | `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.instructions"` \| `"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`[]; `fingerprints`: `Readonly`\<`Record`\<`string`, `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` |
2012
+ | `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.instructions"` \| `"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`; \}\>[]; \} |
2013
+ | `context` | [`InstallationContext`](#installationcontext) |
1980
2014
 
1981
2015
  #### Returns
1982
2016
 
1983
2017
  `Result`\<`Readonly`\<\{ `next`: [`Installation`](#installation);
1984
2018
  `authorityChanged`: `boolean`; \}\>, \{ `kind`: `"refused"`; `code`: \|
1985
2019
  `"unavailable"` \| `"stale_authority"` \| `"not_declared"` \|
1986
- `"release_app_mismatch"` \| `"not_owner"` \| `"invalid_command"`; \}\>
2020
+ `"release_app_mismatch"` \| `"not_approver"` \| `"invalid_command"`; \}\>
1987
2021
 
1988
2022
  ---
1989
2023
 
@@ -2054,6 +2088,7 @@ function deriveDeclaredOperations(
2054
2088
  | "channels.read"
2055
2089
  | "channels.personal.manage";
2056
2090
  operations: readonly string[];
2091
+ fingerprints: Readonly<Record<string, string>>;
2057
2092
  }>[];
2058
2093
  }>
2059
2094
  >;
@@ -2092,7 +2127,8 @@ host adapters.
2092
2127
  `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \|
2093
2128
  `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \|
2094
2129
  `"workflow.arm"` \| `"world"` \| `"channels.read"` \|
2095
- `"channels.personal.manage"`; `operations`: readonly `string`[]; \}\>[]; \}\>\>
2130
+ `"channels.personal.manage"`; `operations`: readonly `string`[]; `fingerprints`:
2131
+ `Readonly`\<`Record`\<`string`, `string`\>\>; \}\>[]; \}\>\>
2096
2132
 
2097
2133
  ---
2098
2134
 
@@ -2138,15 +2174,18 @@ function pendingCapabilities(
2138
2174
  )[];
2139
2175
  ```
2140
2176
 
2141
- Includes newly declared operations and capabilities the owner has narrowed.
2177
+ Includes newly declared or changed operations and capabilities the owner has
2178
+ narrowed. The host sends grants already reduced by carryGrant, so a changed
2179
+ operation is absent from them exactly as a new one is.
2142
2180
 
2143
2181
  #### Parameters
2144
2182
 
2145
- | Parameter | Type |
2146
- | -------------------- | ------------------------------------------------------------- |
2147
- | `authority` | `Pick`\<[`AppAuthority`](#appauthority), `"approvedGrants"`\> |
2148
- | `declaration` | `Pick`\<`AppDeclaration`, `"capabilities"`\> |
2149
- | `declaredOperations` | [`DeclaredOperations`](#declaredoperations) |
2183
+ | Parameter | Type |
2184
+ | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2185
+ | `authority` | \{ `approvedGrants`: readonly `Pick`\<`Readonly`\<`Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"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`[]; `fingerprints`: `Readonly`\<`Record`\<`string`, `string`\>\>; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>\>, `"operations"` \| `"capability"` \| `"resources"`\>[]; \} |
2186
+ | `authority.approvedGrants` | readonly `Pick`\<`Readonly`\<`Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"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`[]; `fingerprints`: `Readonly`\<`Record`\<`string`, `string`\>\>; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>\>, `"operations"` \| `"capability"` \| `"resources"`\>[] |
2187
+ | `declaration` | `Pick`\<`AppDeclaration`, `"capabilities"`\> |
2188
+ | `declaredOperations` | [`DeclaredOperations`](#declaredoperations) |
2150
2189
 
2151
2190
  #### Returns
2152
2191
 
@@ -2178,16 +2217,16 @@ Bound the real SDK request; an Allow never silently widens selected resources.
2178
2217
 
2179
2218
  #### Parameters
2180
2219
 
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.instructions"` \| `"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.instructions"` \| `"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` |
2188
- | `facts` | `Readonly`\<\{ `declaration`: `Pick`\<`AppDeclaration`, `"capabilities"`\>; `declaredOperations`: [`DeclaredOperations`](#declaredoperations); \}\> |
2189
- | `request` | `AppPermissionRequest` |
2190
- | `window` | `Readonly`\<\{ `computerId`: `string` \| `null`; \}\> |
2220
+ | Parameter | Type |
2221
+ | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2222
+ | `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.instructions"` \| `"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`[]; `fingerprints`: `Readonly`\<`Record`\<`string`, `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`; \} |
2223
+ | `authority.authorityVersion` | `number` |
2224
+ | `authority.declaredOperationsDigest` | `Sha256Digest` |
2225
+ | `authority.approvedGrants` | readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"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`[]; `fingerprints`: `Readonly`\<`Record`\<`string`, `string`\>\>; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>[] |
2226
+ | `authority.approval` | \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null` |
2227
+ | `facts` | `Readonly`\<\{ `declaration`: `Pick`\<`AppDeclaration`, `"capabilities"`\>; `declaredOperations`: [`DeclaredOperations`](#declaredoperations); \}\> |
2228
+ | `request` | `AppPermissionRequest` |
2229
+ | `window` | `Readonly`\<\{ `computerId`: `string` \| `null`; \}\> |
2191
2230
 
2192
2231
  #### Returns
2193
2232
 
@@ -2206,13 +2245,10 @@ rows.
2206
2245
 
2207
2246
  #### Parameters
2208
2247
 
2209
- | Parameter | Type |
2210
- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2211
- | `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.instructions"` \| `"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`; \} |
2212
- | `authority.authorityVersion` | `number` |
2213
- | `authority.declaredOperationsDigest` | `Sha256Digest` |
2214
- | `authority.approvedGrants` | readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"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`; \}\>[]; \}\>[] |
2215
- | `authority.approval` | \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null` |
2248
+ | Parameter | Type |
2249
+ | -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2250
+ | `authority` | \{ `approvedGrants`: readonly `Pick`\<`Readonly`\<`Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"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`[]; `fingerprints`: `Readonly`\<`Record`\<`string`, `string`\>\>; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>\>, `"operations"` \| `"capability"` \| `"resources"`\>[]; \} |
2251
+ | `authority.approvedGrants` | readonly `Pick`\<`Readonly`\<`Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"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`[]; `fingerprints`: `Readonly`\<`Record`\<`string`, `string`\>\>; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>\>, `"operations"` \| `"capability"` \| `"resources"`\>[] |
2216
2252
 
2217
2253
  #### Returns
2218
2254
 
@@ -2298,14 +2334,11 @@ Only touched capability rows cross the save boundary.
2298
2334
 
2299
2335
  #### Parameters
2300
2336
 
2301
- | Parameter | Type |
2302
- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2303
- | `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.instructions"` \| `"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`; \} |
2304
- | `baseline.authorityVersion` | `number` |
2305
- | `baseline.declaredOperationsDigest` | `Sha256Digest` |
2306
- | `baseline.approvedGrants` | readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"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`; \}\>[]; \}\>[] |
2307
- | `baseline.approval` | \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null` |
2308
- | `draft` | [`PermissionDraft`](#permissiondraft) |
2337
+ | Parameter | Type |
2338
+ | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2339
+ | `baseline` | \{ `approvedGrants`: readonly `Pick`\<`Readonly`\<`Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"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`[]; `fingerprints`: `Readonly`\<`Record`\<`string`, `string`\>\>; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>\>, `"operations"` \| `"capability"` \| `"resources"`\>[]; \} |
2340
+ | `baseline.approvedGrants` | readonly `Pick`\<`Readonly`\<`Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"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`[]; `fingerprints`: `Readonly`\<`Record`\<`string`, `string`\>\>; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>\>, `"operations"` \| `"capability"` \| `"resources"`\>[] |
2341
+ | `draft` | [`PermissionDraft`](#permissiondraft) |
2309
2342
 
2310
2343
  #### Returns
2311
2344
 
@@ -2335,19 +2368,13 @@ capabilities.
2335
2368
 
2336
2369
  #### Parameters
2337
2370
 
2338
- | Parameter | Type |
2339
- | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2340
- | `draft` | [`PermissionDraft`](#permissiondraft) |
2341
- | `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.instructions"` \| `"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`; \} |
2342
- | `baseline.authorityVersion` | `number` |
2343
- | `baseline.declaredOperationsDigest` | `Sha256Digest` |
2344
- | `baseline.approvedGrants` | readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"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`; \}\>[]; \}\>[] |
2345
- | `baseline.approval` | \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null` |
2346
- | `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.instructions"` \| `"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`; \} |
2347
- | `current.authorityVersion` | `number` |
2348
- | `current.declaredOperationsDigest` | `Sha256Digest` |
2349
- | `current.approvedGrants` | readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"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`; \}\>[]; \}\>[] |
2350
- | `current.approval` | \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null` |
2371
+ | Parameter | Type |
2372
+ | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2373
+ | `draft` | [`PermissionDraft`](#permissiondraft) |
2374
+ | `baseline` | \{ `approvedGrants`: readonly `Pick`\<`Readonly`\<`Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"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`[]; `fingerprints`: `Readonly`\<`Record`\<`string`, `string`\>\>; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>\>, `"operations"` \| `"capability"` \| `"resources"`\>[]; \} |
2375
+ | `baseline.approvedGrants` | readonly `Pick`\<`Readonly`\<`Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"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`[]; `fingerprints`: `Readonly`\<`Record`\<`string`, `string`\>\>; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>\>, `"operations"` \| `"capability"` \| `"resources"`\>[] |
2376
+ | `current` | \{ `approvedGrants`: readonly `Pick`\<`Readonly`\<`Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"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`[]; `fingerprints`: `Readonly`\<`Record`\<`string`, `string`\>\>; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>\>, `"operations"` \| `"capability"` \| `"resources"`\>[]; \} |
2377
+ | `current.approvedGrants` | readonly `Pick`\<`Readonly`\<`Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"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`[]; `fingerprints`: `Readonly`\<`Record`\<`string`, `string`\>\>; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>\>, `"operations"` \| `"capability"` \| `"resources"`\>[] |
2351
2378
 
2352
2379
  #### Returns
2353
2380
 
@@ -2366,9 +2393,9 @@ longer listed by the host.
2366
2393
 
2367
2394
  #### Parameters
2368
2395
 
2369
- | Parameter | Type |
2370
- | --------- | ----------------------------------------------------------------------------------------------------------------- |
2371
- | `input` | `object` & `Readonly`\<\{ `resources`: readonly [`ResourceOption`](#resourceoption)[]; `canEdit`: `boolean`; \}\> |
2396
+ | Parameter | Type |
2397
+ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2398
+ | `input` | `Omit`\<\{ `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.instructions"` \| `"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`[]; `fingerprints`: `Readonly`\<`Record`\<`string`, `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`; \}; `declaredOperations`: \{ `artifactDigest`: `Sha256Digest`; `digest`: `Sha256Digest`; `capabilities`: readonly `Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"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"`; `operations`: readonly `string`[]; `fingerprints`: `Readonly`\<`Record`\<`string`, `string`\>\>; \}\>[]; \}; \}, `"authority"`\> & `Readonly`\<\{ `authority`: \{ `approvedGrants`: readonly `Pick`\<`Readonly`\<`Readonly`\<\{ `capability`: \| `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \| `"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`[]; `fingerprints`: `Readonly`\<`Record`\<..., ...\>\>; `resources`: `"tenant-scope"` \| readonly ...[]; \}\>\>, `"operations"` \| `"capability"` \| `"resources"`\>[]; \}; `resources`: readonly [`ResourceOption`](#resourceoption)[]; `canEdit`: `boolean`; \}\> |
2372
2399
 
2373
2400
  #### Returns
2374
2401