@fungi.computer/oyster 0.28.0 → 0.28.2
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.
- package/dist/apps/gate.js +10 -7
- package/dist/apps/installation.d.ts +23 -2
- package/dist/apps/installation.js +66 -11
- package/dist/apps/operations.d.ts +5 -0
- package/dist/apps/operations.js +49 -10
- package/dist/apps/permissions.d.ts +23 -7
- package/dist/apps/permissions.js +5 -1
- package/dist/embed-metafiles.js +1 -1
- package/dist/embed-scripts.js +2 -2
- package/dist/host.js +7 -2
- package/dist/installation-migration.d.ts +5 -0
- package/dist/installation-migration.js +78 -0
- package/dist/installation-operations.d.ts +8 -0
- package/dist/installation-operations.js +2 -0
- package/dist/page-script.js +3 -3
- package/dist/standalone/workflow-host.d.ts +5 -0
- package/dist/workers.js +2 -0
- package/docs/api/apps.md +87 -73
- package/docs/api/git.md +3 -3
- package/docs/api/host.md +6 -0
- package/docs/api/mcp.md +16 -16
- package/docs/api/workers.md +54 -44
- package/package.json +11 -11
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`[]; `
|
|
159
|
-
`Readonly
|
|
160
|
-
|
|
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`[];
|
|
177
|
+
`string`[]; `fingerprints`: `Readonly`\<`Record`\<`string`, `string`\>\>;
|
|
178
|
+
\}\>[]; \}; \}; `canEdit`: `boolean`; `resources`: `object`[]; \}\>
|
|
175
179
|
|
|
176
180
|
##### submit()
|
|
177
181
|
|
|
@@ -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"];
|
|
@@ -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<{
|
|
@@ -1142,6 +1148,7 @@ const approvedGrantSchema: ZodReadonly<ZodObject<{
|
|
|
1142
1148
|
| "channels.personal.manage", unknown>>;
|
|
1143
1149
|
capabilityApproved: ZodLiteral<true>;
|
|
1144
1150
|
operations: ZodLazy<ZodReadonly<ZodArray<ZodString>>>;
|
|
1151
|
+
fingerprints: ZodLazy<ZodReadonly<ZodRecord<ZodString, ZodString>>>;
|
|
1145
1152
|
resources: ZodUnion<readonly [ZodLiteral<"tenant-scope">, ZodReadonly<ZodArray<ZodLazy<ZodReadonly<ZodObject<{
|
|
1146
1153
|
kind: ...;
|
|
1147
1154
|
id: ...;
|
|
@@ -1152,13 +1159,17 @@ const approvedGrantSchema: ZodReadonly<ZodObject<{
|
|
|
1152
1159
|
Consent approves capabilities, with explicit operation and resource ceilings. A
|
|
1153
1160
|
Release adding a method that requires an already-approved capability needs no
|
|
1154
1161
|
new consent; a new capability does. Release selection intersects stored
|
|
1155
|
-
operations instead of adding approvals
|
|
1156
|
-
|
|
1157
|
-
|
|
1158
|
-
|
|
1159
|
-
|
|
1160
|
-
|
|
1161
|
-
|
|
1162
|
+
operations instead of adding approvals: an operation carries only when its name
|
|
1163
|
+
and its fingerprint (the host descriptor method entry, or the binding operation,
|
|
1164
|
+
that defines what it does) both match the approval, so a same-named operation
|
|
1165
|
+
whose behavior changed needs approval again, as a new operation does. Each
|
|
1166
|
+
Worker call is still restricted to that method's declared requires, never the
|
|
1167
|
+
App's complete capability set. Only an approved install or change-grants command
|
|
1168
|
+
mints capabilityApproved. Empty operation rows retain that consent; removing the
|
|
1169
|
+
capability revokes it. route:app.methods rows record approval detail, not a
|
|
1170
|
+
method allowlist: narrowing them in change-grants does not restrict methods
|
|
1171
|
+
using an approved capability. Exact operation rows are enforced for capability
|
|
1172
|
+
routes and backend bindings.
|
|
1162
1173
|
|
|
1163
1174
|
---
|
|
1164
1175
|
|
|
@@ -1250,6 +1261,7 @@ const appAuthoritySchema: ZodObject<{
|
|
|
1250
1261
|
| ..., unknown>>;
|
|
1251
1262
|
capabilityApproved: ZodLiteral<true>;
|
|
1252
1263
|
operations: ZodLazy<ZodReadonly<ZodArray<...>>>;
|
|
1264
|
+
fingerprints: ZodLazy<ZodReadonly<ZodRecord<..., ...>>>;
|
|
1253
1265
|
resources: ZodUnion<readonly [ZodLiteral<...>, ZodReadonly<...>]>;
|
|
1254
1266
|
}, $strict>>>>>;
|
|
1255
1267
|
approval: ZodNullable<ZodLazy<ZodReadonly<ZodObject<{
|
|
@@ -1336,6 +1348,7 @@ const declaredOperationsSchema: ZodLazy<ZodObject<{
|
|
|
1336
1348
|
| ...
|
|
1337
1349
|
| ..., unknown>>;
|
|
1338
1350
|
operations: ZodLazy<ZodReadonly<ZodArray<...>>>;
|
|
1351
|
+
fingerprints: ZodLazy<ZodReadonly<ZodRecord<..., ...>>>;
|
|
1339
1352
|
}, $strict>>>>;
|
|
1340
1353
|
}, $strict>>;
|
|
1341
1354
|
```
|
|
@@ -1376,6 +1389,7 @@ const installationSchema: ZodObject<{
|
|
|
1376
1389
|
capability: ZodPipe<..., ...>;
|
|
1377
1390
|
capabilityApproved: ZodLiteral<...>;
|
|
1378
1391
|
operations: ZodLazy<...>;
|
|
1392
|
+
fingerprints: ZodLazy<...>;
|
|
1379
1393
|
resources: ZodUnion<...>;
|
|
1380
1394
|
}, $strict>>>>>;
|
|
1381
1395
|
approval: ZodNullable<ZodLazy<ZodReadonly<ZodObject<{
|
|
@@ -1494,6 +1508,7 @@ const appPermissionsWireSchema: ZodObject<{
|
|
|
1494
1508
|
capability: ZodPipe<..., ...>;
|
|
1495
1509
|
capabilityApproved: ZodLiteral<...>;
|
|
1496
1510
|
operations: ZodLazy<...>;
|
|
1511
|
+
fingerprints: ZodLazy<...>;
|
|
1497
1512
|
resources: ZodUnion<...>;
|
|
1498
1513
|
}, $strict>>>>>;
|
|
1499
1514
|
approval: ZodNullable<ZodLazy<ZodReadonly<ZodObject<{
|
|
@@ -1508,6 +1523,7 @@ const appPermissionsWireSchema: ZodObject<{
|
|
|
1508
1523
|
capabilities: ZodReadonly<ZodArray<ZodReadonly<ZodObject<{
|
|
1509
1524
|
capability: ZodPipe<..., ...>;
|
|
1510
1525
|
operations: ZodLazy<...>;
|
|
1526
|
+
fingerprints: ZodLazy<...>;
|
|
1511
1527
|
}, $strict>>>>;
|
|
1512
1528
|
}, $strict>>;
|
|
1513
1529
|
}, $strict>;
|
|
@@ -1672,6 +1688,7 @@ function grantsFor(
|
|
|
1672
1688
|
| "channels.personal.manage";
|
|
1673
1689
|
capabilityApproved: true;
|
|
1674
1690
|
operations: readonly string[];
|
|
1691
|
+
fingerprints: Readonly<Record<string, string>>;
|
|
1675
1692
|
resources:
|
|
1676
1693
|
| "tenant-scope"
|
|
1677
1694
|
| readonly Readonly<{
|
|
@@ -1707,8 +1724,10 @@ resource selectors.
|
|
|
1707
1724
|
`"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \|
|
|
1708
1725
|
`"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \|
|
|
1709
1726
|
`"channels.read"` \| `"channels.personal.manage"`; `capabilityApproved`: `true`;
|
|
1710
|
-
`operations`: readonly `string`[]; `
|
|
1711
|
-
`Readonly
|
|
1727
|
+
`operations`: readonly `string`[]; `fingerprints`:
|
|
1728
|
+
`Readonly`\<`Record`\<`string`, `string`\>\>; `resources`: \| `"tenant-scope"`
|
|
1729
|
+
\| readonly `Readonly`\<\{ `kind`: `string`; `id`: `string`; \}\>[]; \}\>\> \|
|
|
1730
|
+
`null`
|
|
1712
1731
|
|
|
1713
1732
|
---
|
|
1714
1733
|
|
|
@@ -1877,6 +1896,7 @@ function applyGrantCommand(
|
|
|
1877
1896
|
| "channels.personal.manage";
|
|
1878
1897
|
capabilityApproved: true;
|
|
1879
1898
|
operations: readonly string[];
|
|
1899
|
+
fingerprints: Readonly<Record<string, string>>;
|
|
1880
1900
|
resources:
|
|
1881
1901
|
| "tenant-scope"
|
|
1882
1902
|
| readonly Readonly<{
|
|
@@ -1913,11 +1933,11 @@ One host-independent approval policy; selection only intersects existing grants.
|
|
|
1913
1933
|
|
|
1914
1934
|
#### Parameters
|
|
1915
1935
|
|
|
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)
|
|
1936
|
+
| Parameter | Type |
|
|
1937
|
+
| ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
1938
|
+
| `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` |
|
|
1939
|
+
| `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"`; \} |
|
|
1940
|
+
| `context` | [`GrantContext`](#grantcontext) |
|
|
1921
1941
|
|
|
1922
1942
|
#### Returns
|
|
1923
1943
|
|
|
@@ -1933,7 +1953,8 @@ One host-independent approval policy; selection only intersects existing grants.
|
|
|
1933
1953
|
`"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \|
|
|
1934
1954
|
`"workflow.arm"` \| `"world"` \| `"channels.read"` \|
|
|
1935
1955
|
`"channels.personal.manage"`; `capabilityApproved`: `true`; `operations`:
|
|
1936
|
-
readonly `string`[]; `
|
|
1956
|
+
readonly `string`[]; `fingerprints`: `Readonly`\<`Record`\<`string`,
|
|
1957
|
+
`string`\>\>; `resources`: \| `"tenant-scope"` \| readonly `Readonly`\<\{
|
|
1937
1958
|
`kind`: `string`; `id`: `string`; \}\>[]; \}\>[]; `approval`: \| `Readonly`\<\{
|
|
1938
1959
|
`by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`:
|
|
1939
1960
|
`"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`:
|
|
@@ -1972,11 +1993,11 @@ Pure transition; hosts retain transactions, receipts, epochs and delivery.
|
|
|
1972
1993
|
|
|
1973
1994
|
#### Parameters
|
|
1974
1995
|
|
|
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)
|
|
1996
|
+
| Parameter | Type |
|
|
1997
|
+
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
1998
|
+
| `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` |
|
|
1999
|
+
| `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`; \}\>[]; \} |
|
|
2000
|
+
| `context` | [`InstallationContext`](#installationcontext) |
|
|
1980
2001
|
|
|
1981
2002
|
#### Returns
|
|
1982
2003
|
|
|
@@ -2054,6 +2075,7 @@ function deriveDeclaredOperations(
|
|
|
2054
2075
|
| "channels.read"
|
|
2055
2076
|
| "channels.personal.manage";
|
|
2056
2077
|
operations: readonly string[];
|
|
2078
|
+
fingerprints: Readonly<Record<string, string>>;
|
|
2057
2079
|
}>[];
|
|
2058
2080
|
}>
|
|
2059
2081
|
>;
|
|
@@ -2092,7 +2114,8 @@ host adapters.
|
|
|
2092
2114
|
`"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \|
|
|
2093
2115
|
`"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \|
|
|
2094
2116
|
`"workflow.arm"` \| `"world"` \| `"channels.read"` \|
|
|
2095
|
-
`"channels.personal.manage"`; `operations`: readonly `string`[];
|
|
2117
|
+
`"channels.personal.manage"`; `operations`: readonly `string`[]; `fingerprints`:
|
|
2118
|
+
`Readonly`\<`Record`\<`string`, `string`\>\>; \}\>[]; \}\>\>
|
|
2096
2119
|
|
|
2097
2120
|
---
|
|
2098
2121
|
|
|
@@ -2138,15 +2161,18 @@ function pendingCapabilities(
|
|
|
2138
2161
|
)[];
|
|
2139
2162
|
```
|
|
2140
2163
|
|
|
2141
|
-
Includes newly declared operations and capabilities the owner has
|
|
2164
|
+
Includes newly declared or changed operations and capabilities the owner has
|
|
2165
|
+
narrowed. The host sends grants already reduced by carryGrant, so a changed
|
|
2166
|
+
operation is absent from them exactly as a new one is.
|
|
2142
2167
|
|
|
2143
2168
|
#### Parameters
|
|
2144
2169
|
|
|
2145
|
-
| Parameter
|
|
2146
|
-
|
|
|
2147
|
-
| `authority`
|
|
2148
|
-
| `
|
|
2149
|
-
| `
|
|
2170
|
+
| Parameter | Type |
|
|
2171
|
+
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
2172
|
+
| `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"`\>[]; \} |
|
|
2173
|
+
| `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"`\>[] |
|
|
2174
|
+
| `declaration` | `Pick`\<`AppDeclaration`, `"capabilities"`\> |
|
|
2175
|
+
| `declaredOperations` | [`DeclaredOperations`](#declaredoperations) |
|
|
2150
2176
|
|
|
2151
2177
|
#### Returns
|
|
2152
2178
|
|
|
@@ -2178,16 +2204,16 @@ Bound the real SDK request; an Allow never silently widens selected resources.
|
|
|
2178
2204
|
|
|
2179
2205
|
#### Parameters
|
|
2180
2206
|
|
|
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`; \}\>
|
|
2207
|
+
| Parameter | Type |
|
|
2208
|
+
| ------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
2209
|
+
| `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`; \} |
|
|
2210
|
+
| `authority.authorityVersion` | `number` |
|
|
2211
|
+
| `authority.declaredOperationsDigest` | `Sha256Digest` |
|
|
2212
|
+
| `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`; \}\>[]; \}\>[] |
|
|
2213
|
+
| `authority.approval` | \| `Readonly`\<\{ `by`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null` |
|
|
2214
|
+
| `facts` | `Readonly`\<\{ `declaration`: `Pick`\<`AppDeclaration`, `"capabilities"`\>; `declaredOperations`: [`DeclaredOperations`](#declaredoperations); \}\> |
|
|
2215
|
+
| `request` | `AppPermissionRequest` |
|
|
2216
|
+
| `window` | `Readonly`\<\{ `computerId`: `string` \| `null`; \}\> |
|
|
2191
2217
|
|
|
2192
2218
|
#### Returns
|
|
2193
2219
|
|
|
@@ -2206,13 +2232,10 @@ rows.
|
|
|
2206
2232
|
|
|
2207
2233
|
#### Parameters
|
|
2208
2234
|
|
|
2209
|
-
| Parameter
|
|
2210
|
-
|
|
|
2211
|
-
| `authority`
|
|
2212
|
-
| `authority.
|
|
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` |
|
|
2235
|
+
| Parameter | Type |
|
|
2236
|
+
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
2237
|
+
| `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"`\>[]; \} |
|
|
2238
|
+
| `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
2239
|
|
|
2217
2240
|
#### Returns
|
|
2218
2241
|
|
|
@@ -2298,14 +2321,11 @@ Only touched capability rows cross the save boundary.
|
|
|
2298
2321
|
|
|
2299
2322
|
#### Parameters
|
|
2300
2323
|
|
|
2301
|
-
| Parameter
|
|
2302
|
-
|
|
|
2303
|
-
| `baseline`
|
|
2304
|
-
| `baseline.
|
|
2305
|
-
| `
|
|
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) |
|
|
2324
|
+
| Parameter | Type |
|
|
2325
|
+
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
2326
|
+
| `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"`\>[]; \} |
|
|
2327
|
+
| `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"`\>[] |
|
|
2328
|
+
| `draft` | [`PermissionDraft`](#permissiondraft) |
|
|
2309
2329
|
|
|
2310
2330
|
#### Returns
|
|
2311
2331
|
|
|
@@ -2335,19 +2355,13 @@ capabilities.
|
|
|
2335
2355
|
|
|
2336
2356
|
#### Parameters
|
|
2337
2357
|
|
|
2338
|
-
| Parameter
|
|
2339
|
-
|
|
|
2340
|
-
| `draft`
|
|
2341
|
-
| `baseline`
|
|
2342
|
-
| `baseline.
|
|
2343
|
-
| `
|
|
2344
|
-
| `
|
|
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` |
|
|
2358
|
+
| Parameter | Type |
|
|
2359
|
+
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
2360
|
+
| `draft` | [`PermissionDraft`](#permissiondraft) |
|
|
2361
|
+
| `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"`\>[]; \} |
|
|
2362
|
+
| `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"`\>[] |
|
|
2363
|
+
| `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"`\>[]; \} |
|
|
2364
|
+
| `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
2365
|
|
|
2352
2366
|
#### Returns
|
|
2353
2367
|
|
|
@@ -2366,9 +2380,9 @@ longer listed by the host.
|
|
|
2366
2380
|
|
|
2367
2381
|
#### Parameters
|
|
2368
2382
|
|
|
2369
|
-
| Parameter | Type
|
|
2370
|
-
| --------- |
|
|
2371
|
-
| `input` | `
|
|
2383
|
+
| Parameter | Type |
|
|
2384
|
+
| --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
2385
|
+
| `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
2386
|
|
|
2373
2387
|
#### Returns
|
|
2374
2388
|
|