@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.
- package/README.md +4 -0
- package/dist/apps/catalog.js +1 -1
- package/dist/apps/gate.d.ts +2 -1
- package/dist/apps/gate.js +10 -7
- package/dist/apps/index.d.ts +1 -1
- package/dist/apps/index.js +1 -1
- package/dist/apps/installation.d.ts +27 -5
- package/dist/apps/installation.js +86 -29
- 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/authorization.d.ts +2 -1
- package/dist/boot-host-script.js +1 -1
- package/dist/build/candidate-cli.mjs +1823 -1833
- package/dist/embed-metafiles.js +2 -2
- package/dist/embed-scripts.js +1 -1
- 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/invocation.d.ts +3 -3
- package/dist/page-script.js +2 -2
- package/dist/standalone/computer.d.ts +2 -2
- package/dist/standalone/registry.d.ts +2 -2
- package/dist/standalone/workflow-host.d.ts +6 -1
- package/dist/tenancy/cloudflare/registry.js +6 -2
- package/dist/tenancy/contracts.d.ts +4 -3
- package/dist/tenancy/index.js +2 -1
- package/dist/tenant.d.ts +2 -1
- package/dist/workers.js +2 -0
- package/docs/api/apps.md +108 -81
- package/docs/api/authorization.md +1 -1
- package/docs/api/git.md +4 -4
- package/docs/api/host.md +8 -2
- package/docs/api/invocation.md +87 -87
- package/docs/api/mcp.md +16 -16
- package/docs/api/tenancy.md +3 -3
- package/docs/api/tenant.md +1 -1
- package/docs/api/workers-git.md +157 -157
- package/docs/api/workers.md +231 -221
- 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`[]; `
|
|
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
|
|
|
@@ -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:
|
|
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" | "
|
|
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:
|
|
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
|
|
1156
|
-
|
|
1157
|
-
|
|
1158
|
-
|
|
1159
|
-
|
|
1160
|
-
|
|
1161
|
-
|
|
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
|
-
|
|
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`[]; `
|
|
1711
|
-
`Readonly
|
|
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:
|
|
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`[]; `
|
|
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"` \| `"
|
|
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
|
-
| "
|
|
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"` \| `"
|
|
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
|
|
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
|
|
2146
|
-
|
|
|
2147
|
-
| `authority`
|
|
2148
|
-
| `
|
|
2149
|
-
| `
|
|
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
|
|
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` |
|
|
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
|
|
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) |
|
|
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
|
|
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` |
|
|
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` | `
|
|
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
|
|