@fungi.computer/oyster 0.35.0 → 0.36.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/dist/boot-host-script.js +1 -1
- package/dist/build/candidate-cli.mjs +5 -0
- package/dist/cloudflare.js +1 -0
- package/dist/embed-metafiles.js +2 -2
- package/dist/embed-scripts.js +1 -1
- package/dist/host.d.ts +3 -1
- package/dist/host.js +8 -8
- package/dist/internal/delivery.js +1 -1
- package/dist/invocation.d.ts +27 -5
- package/dist/invocation.js +9 -7
- package/dist/mcp.d.ts +3 -3
- package/dist/mcp.js +1 -1
- package/dist/page-script.js +2 -2
- package/dist/standalone/workflow-git-capture.d.ts +1 -1
- package/dist/standalone/workflow-git-capture.js +1 -1
- package/dist/standalone/workflow-host.d.ts +9 -2
- package/dist/standalone/workflow-host.js +21 -3
- package/dist/standalone/workflow-node-capture.d.ts +1 -1
- package/dist/standalone/workflow-node-capture.js +1 -1
- package/dist/standalone/workflow-trigger-host.d.ts +1 -1
- package/dist/testing/capabilities.js +2 -0
- package/dist/testing/worker.js +1 -0
- package/dist/workers-git.js +2 -1
- package/dist/workers.js +5 -0
- package/docs/api/host.md +1 -0
- package/docs/api/invocation.md +135 -97
- package/docs/api/mcp.md +5 -5
- package/docs/api/workers-git.md +180 -179
- package/docs/api/workers.md +217 -215
- package/package.json +17 -17
package/docs/api/invocation.md
CHANGED
|
@@ -190,6 +190,14 @@ const invocationFactsSchema: Struct<{
|
|
|
190
190
|
subject: Union<readonly [Struct<{
|
|
191
191
|
kind: Literal<"call">;
|
|
192
192
|
context: declareConstructor<{
|
|
193
|
+
scope: | {
|
|
194
|
+
kind: "team";
|
|
195
|
+
teamId: string;
|
|
196
|
+
}
|
|
197
|
+
| {
|
|
198
|
+
kind: "standalone";
|
|
199
|
+
tenant: string;
|
|
200
|
+
};
|
|
193
201
|
computerId: string | null;
|
|
194
202
|
actor: | {
|
|
195
203
|
kind: "member";
|
|
@@ -218,6 +226,14 @@ const invocationFactsSchema: Struct<{
|
|
|
218
226
|
};
|
|
219
227
|
idempotencyKey?: string;
|
|
220
228
|
}, {
|
|
229
|
+
scope: | {
|
|
230
|
+
kind: "team";
|
|
231
|
+
teamId: string;
|
|
232
|
+
}
|
|
233
|
+
| {
|
|
234
|
+
kind: "standalone";
|
|
235
|
+
tenant: string;
|
|
236
|
+
};
|
|
221
237
|
computerId: string | null;
|
|
222
238
|
actor: | {
|
|
223
239
|
kind: "member";
|
|
@@ -246,6 +262,14 @@ const invocationFactsSchema: Struct<{
|
|
|
246
262
|
};
|
|
247
263
|
idempotencyKey?: string;
|
|
248
264
|
}, readonly [], {
|
|
265
|
+
scope: | {
|
|
266
|
+
kind: "team";
|
|
267
|
+
teamId: string;
|
|
268
|
+
}
|
|
269
|
+
| {
|
|
270
|
+
kind: "standalone";
|
|
271
|
+
tenant: string;
|
|
272
|
+
};
|
|
249
273
|
computerId: string | null;
|
|
250
274
|
actor: | {
|
|
251
275
|
kind: "member";
|
|
@@ -441,12 +465,12 @@ exclusively so the current cohort cannot be prolonged forever.
|
|
|
441
465
|
### invocationCallerContext()
|
|
442
466
|
|
|
443
467
|
```ts
|
|
444
|
-
function invocationCallerContext(principal, computerId): object;
|
|
468
|
+
function invocationCallerContext(principal, computerId, tenant): object;
|
|
445
469
|
```
|
|
446
470
|
|
|
447
|
-
Project an admitted principal into App attribution
|
|
448
|
-
fixed Computer context.
|
|
449
|
-
projection.
|
|
471
|
+
Project an Oyster-admitted principal into App attribution using its host's
|
|
472
|
+
tenant pin and fixed Computer context. Hub supplies Team scope separately. Host
|
|
473
|
+
admission reads the principal, never this projection.
|
|
450
474
|
|
|
451
475
|
#### Parameters
|
|
452
476
|
|
|
@@ -454,6 +478,7 @@ projection.
|
|
|
454
478
|
| ------------ | ---------------------------------------------- |
|
|
455
479
|
| `principal` | [`TenantPrincipal`](tenant.md#tenantprincipal) |
|
|
456
480
|
| `computerId` | `string` \| `null` |
|
|
481
|
+
| `tenant` | `string` & `Brand`\<`"OysterTenantId"`\> |
|
|
457
482
|
|
|
458
483
|
#### Returns
|
|
459
484
|
|
|
@@ -461,6 +486,7 @@ projection.
|
|
|
461
486
|
|
|
462
487
|
| Name | Type |
|
|
463
488
|
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
489
|
+
| `scope` | \| \{ `kind`: `"team"`; `teamId`: `string`; \} \| \{ `kind`: `"standalone"`; `tenant`: `string`; \} |
|
|
464
490
|
| `computerId` | `string` \| `null` |
|
|
465
491
|
| `actor` | \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \} |
|
|
466
492
|
| `backgroundLane?` | `string` |
|
|
@@ -524,58 +550,59 @@ Mint standalone facts only after host caller and Release admission.
|
|
|
524
550
|
|
|
525
551
|
#### Parameters
|
|
526
552
|
|
|
527
|
-
| Parameter | Type
|
|
528
|
-
| ---------------------------------- |
|
|
529
|
-
| `installation` | [`Installation`](apps.md#installation)
|
|
530
|
-
| `release` | [`VerifiedRelease`](host.md#verifiedrelease)
|
|
531
|
-
| `context` | \{ `computerId`: `string` \| `null`; `actor`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `backgroundLane?`: `string`; `backgroundOrigin?`: \{ `method`: `string`; `seal`: `string`; \}; `role?`: `"member"` \| `"owner"` \| `"admin"`; `soleMember?`: `true`; `workflow?`: \{ `workflowId`: `string`; `runId`: `string`; `nodeId`: `string`; `armedBy`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; \}; `idempotencyKey?`: `string`; \} | `undefined` |
|
|
532
|
-
| `context.
|
|
533
|
-
| `context.
|
|
534
|
-
| `context.
|
|
535
|
-
| `context.
|
|
536
|
-
| `context.backgroundOrigin
|
|
537
|
-
| `context.backgroundOrigin.
|
|
538
|
-
| `context.
|
|
539
|
-
| `context.
|
|
540
|
-
| `context.
|
|
541
|
-
| `context.workflow
|
|
542
|
-
| `context.workflow.
|
|
543
|
-
| `context.workflow.
|
|
544
|
-
| `context.workflow.
|
|
545
|
-
| `context.
|
|
546
|
-
| `
|
|
547
|
-
| `
|
|
548
|
-
| `
|
|
549
|
-
| `
|
|
550
|
-
| `agentPolicy
|
|
551
|
-
| `agentPolicy.
|
|
552
|
-
| `
|
|
553
|
-
| `method
|
|
554
|
-
| `method.
|
|
555
|
-
| `
|
|
556
|
-
| `origin
|
|
557
|
-
| `origin.
|
|
553
|
+
| Parameter | Type | Default value |
|
|
554
|
+
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
|
|
555
|
+
| `installation` | [`Installation`](apps.md#installation) | `undefined` |
|
|
556
|
+
| `release` | [`VerifiedRelease`](host.md#verifiedrelease) | `undefined` |
|
|
557
|
+
| `context` | \{ `scope`: \| \{ `kind`: `"team"`; `teamId`: `string`; \} \| \{ `kind`: `"standalone"`; `tenant`: `string`; \}; `computerId`: `string` \| `null`; `actor`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `backgroundLane?`: `string`; `backgroundOrigin?`: \{ `method`: `string`; `seal`: `string`; \}; `role?`: `"member"` \| `"owner"` \| `"admin"`; `soleMember?`: `true`; `workflow?`: \{ `workflowId`: `string`; `runId`: `string`; `nodeId`: `string`; `armedBy`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; \}; `idempotencyKey?`: `string`; \} | `undefined` |
|
|
558
|
+
| `context.scope` | \| \{ `kind`: `"team"`; `teamId`: `string`; \} \| \{ `kind`: `"standalone"`; `tenant`: `string`; \} | `undefined` |
|
|
559
|
+
| `context.computerId` | `string` \| `null` | `undefined` |
|
|
560
|
+
| `context.actor` | \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \} | `undefined` |
|
|
561
|
+
| `context.backgroundLane?` | `string` | `undefined` |
|
|
562
|
+
| `context.backgroundOrigin?` | \{ `method`: `string`; `seal`: `string`; \} | `undefined` |
|
|
563
|
+
| `context.backgroundOrigin.method?` | `string` | `undefined` |
|
|
564
|
+
| `context.backgroundOrigin.seal?` | `string` | `undefined` |
|
|
565
|
+
| `context.role?` | `"member"` \| `"owner"` \| `"admin"` | `undefined` |
|
|
566
|
+
| `context.soleMember?` | `true` | `undefined` |
|
|
567
|
+
| `context.workflow?` | \{ `workflowId`: `string`; `runId`: `string`; `nodeId`: `string`; `armedBy`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; \} | `undefined` |
|
|
568
|
+
| `context.workflow.workflowId?` | `string` | `undefined` |
|
|
569
|
+
| `context.workflow.runId?` | `string` | `undefined` |
|
|
570
|
+
| `context.workflow.nodeId?` | `string` | `undefined` |
|
|
571
|
+
| `context.workflow.armedBy?` | \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \} | `undefined` |
|
|
572
|
+
| `context.idempotencyKey?` | `string` | `undefined` |
|
|
573
|
+
| `grants?` | readonly `object`[] | `undefined` |
|
|
574
|
+
| `ancestry?` | readonly [`InstanceId`](index.md#instanceid)[] | `[]` |
|
|
575
|
+
| `sessionId?` | `string` | `undefined` |
|
|
576
|
+
| `agentPolicy?` | \{ `policyRevision`: `string`; `grantorMemberId`: `string`; \} | `undefined` |
|
|
577
|
+
| `agentPolicy.policyRevision?` | `string` | `appToolPolicySchema.fields.revision` |
|
|
578
|
+
| `agentPolicy.grantorMemberId?` | `string` | `appToolPolicySchema.fields.grantedBy` |
|
|
579
|
+
| `method?` | \{ `name`: `string`; `effect`: `"read"` \| `"write"` \| `"external"`; \} | `undefined` |
|
|
580
|
+
| `method.name?` | `string` | `appApiMethodNameSchema` |
|
|
581
|
+
| `method.effect?` | `"read"` \| `"write"` \| `"external"` | `...` |
|
|
582
|
+
| `origin?` | \{ `method`: `string`; `seal`: `string`; \} | `undefined` |
|
|
583
|
+
| `origin.method?` | `string` | `undefined` |
|
|
584
|
+
| `origin.seal?` | `string` | `undefined` |
|
|
558
585
|
|
|
559
586
|
#### Returns
|
|
560
587
|
|
|
561
588
|
`object`
|
|
562
589
|
|
|
563
|
-
| Name | Type
|
|
564
|
-
| ---------------------------- |
|
|
565
|
-
| `instanceId` | [`InstanceId`](index.md#instanceid)
|
|
566
|
-
| `selection` | `object`
|
|
567
|
-
| `selection.instanceId` | [`InstanceId`](index.md#instanceid)
|
|
568
|
-
| `selection.owner` | `object`
|
|
569
|
-
| `selection.owner.kind` | `"installation"` \| `"deployment"`
|
|
570
|
-
| `selection.owner.id` | `string`
|
|
571
|
-
| `selection.appId` | `AppId`
|
|
572
|
-
| `selection.releaseId` | `ReleaseId`
|
|
573
|
-
| `selection.authorityVersion` | `number`
|
|
574
|
-
| `artifactDigest` | `Sha256Digest`
|
|
575
|
-
| `subject` | \| \{ `kind`: `"call"`; `context`: \{ `computerId`: `string` \| `null`; `actor`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `backgroundLane?`: `string`; `backgroundOrigin?`: \{ `method`: `string`; `seal`: `string`; \}; `role?`: `"member"` \| `"owner"` \| `"admin"`; `soleMember?`: `true`; `workflow?`: \{ `workflowId`: `string`; `runId`: `string`; `nodeId`: `string`; `armedBy`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; \}; `idempotencyKey?`: `string`; \}; `sessionId?`: `string`; `agentPolicy?`: \{ `policyRevision`: `string`; `grantorMemberId`: `string`; \}; `method?`: \{ `name`: `string`; `effect`: `"read"` \| `"write"` \| `"external"`; \}; `replay?`: \{ `lane`: `string`; `epoch`: `number`; `admitted`: readonly `string`[]; \}; \} \| \{ `kind`: `"lifecycle"`; `name`: `"onGitPush"`; `eventId`: `string`; \} \| \{ `kind`: `"lifecycle"`; `name`: `"syncRefused"`; `lane`: `string`; `code`: `"access_changed"` \| `"installation_unavailable"`; \} | - |
|
|
576
|
-
| `grants` | readonly `object`[]
|
|
577
|
-
| `deadlineAt` | `number`
|
|
578
|
-
| `ancestry` | readonly [`InstanceId`](index.md#instanceid)[]
|
|
590
|
+
| Name | Type | Default value |
|
|
591
|
+
| ---------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
|
|
592
|
+
| `instanceId` | [`InstanceId`](index.md#instanceid) | `instanceIdSchema` |
|
|
593
|
+
| `selection` | `object` | `selectionSchema` |
|
|
594
|
+
| `selection.instanceId` | [`InstanceId`](index.md#instanceid) | `instanceIdSchema` |
|
|
595
|
+
| `selection.owner` | `object` | `ownerSchema` |
|
|
596
|
+
| `selection.owner.kind` | `"installation"` \| `"deployment"` | - |
|
|
597
|
+
| `selection.owner.id` | `string` | `Schema.NonEmptyString` |
|
|
598
|
+
| `selection.appId` | `AppId` | `appIdSchema` |
|
|
599
|
+
| `selection.releaseId` | `ReleaseId` | `releaseIdSchema` |
|
|
600
|
+
| `selection.authorityVersion` | `number` | - |
|
|
601
|
+
| `artifactDigest` | `Sha256Digest` | `sha256DigestSchema` |
|
|
602
|
+
| `subject` | \| \{ `kind`: `"call"`; `context`: \{ `scope`: \| \{ `kind`: `"team"`; `teamId`: `string`; \} \| \{ `kind`: `"standalone"`; `tenant`: `string`; \}; `computerId`: `string` \| `null`; `actor`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `backgroundLane?`: `string`; `backgroundOrigin?`: \{ `method`: `string`; `seal`: `string`; \}; `role?`: `"member"` \| `"owner"` \| `"admin"`; `soleMember?`: `true`; `workflow?`: \{ `workflowId`: `string`; `runId`: `string`; `nodeId`: `string`; `armedBy`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; \}; `idempotencyKey?`: `string`; \}; `sessionId?`: `string`; `agentPolicy?`: \{ `policyRevision`: `string`; `grantorMemberId`: `string`; \}; `method?`: \{ `name`: `string`; `effect`: `"read"` \| `"write"` \| `"external"`; \}; `replay?`: \{ `lane`: `string`; `epoch`: `number`; `admitted`: readonly `string`[]; \}; \} \| \{ `kind`: `"lifecycle"`; `name`: `"onGitPush"`; `eventId`: `string`; \} \| \{ `kind`: `"lifecycle"`; `name`: `"syncRefused"`; `lane`: `string`; `code`: `"access_changed"` \| `"installation_unavailable"`; \} | - |
|
|
603
|
+
| `grants` | readonly `object`[] | `grantsSchema` |
|
|
604
|
+
| `deadlineAt` | `number` | - |
|
|
605
|
+
| `ancestry` | readonly [`InstanceId`](index.md#instanceid)[] | - |
|
|
579
606
|
|
|
580
607
|
---
|
|
581
608
|
|
|
@@ -609,6 +636,15 @@ function admittedMethodCallerFacts(
|
|
|
609
636
|
| {
|
|
610
637
|
kind: "call";
|
|
611
638
|
context: {
|
|
639
|
+
scope:
|
|
640
|
+
| {
|
|
641
|
+
kind: "team";
|
|
642
|
+
teamId: string;
|
|
643
|
+
}
|
|
644
|
+
| {
|
|
645
|
+
kind: "standalone";
|
|
646
|
+
tenant: string;
|
|
647
|
+
};
|
|
612
648
|
computerId: string | null;
|
|
613
649
|
actor:
|
|
614
650
|
| {
|
|
@@ -686,35 +722,36 @@ Seal the host-verified named method after its current admission checks.
|
|
|
686
722
|
|
|
687
723
|
#### Parameters
|
|
688
724
|
|
|
689
|
-
| Parameter | Type
|
|
690
|
-
| ---------------------------------- |
|
|
691
|
-
| `host` | `Pick`\<[`OysterHost`](host.md#oysterhost), `"backgroundOriginKey"`\>
|
|
692
|
-
| `installation` | [`Installation`](apps.md#installation)
|
|
693
|
-
| `release` | [`VerifiedRelease`](host.md#verifiedrelease)
|
|
694
|
-
| `context` | \{ `computerId`: `string` \| `null`; `actor`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `backgroundLane?`: `string`; `backgroundOrigin?`: \{ `method`: `string`; `seal`: `string`; \}; `role?`: `"member"` \| `"owner"` \| `"admin"`; `soleMember?`: `true`; `workflow?`: \{ `workflowId`: `string`; `runId`: `string`; `nodeId`: `string`; `armedBy`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; \}; `idempotencyKey?`: `string`; \} | `undefined` |
|
|
695
|
-
| `context.
|
|
696
|
-
| `context.
|
|
697
|
-
| `context.
|
|
698
|
-
| `context.
|
|
699
|
-
| `context.backgroundOrigin
|
|
700
|
-
| `context.backgroundOrigin.
|
|
701
|
-
| `context.
|
|
702
|
-
| `context.
|
|
703
|
-
| `context.
|
|
704
|
-
| `context.workflow
|
|
705
|
-
| `context.workflow.
|
|
706
|
-
| `context.workflow.
|
|
707
|
-
| `context.workflow.
|
|
708
|
-
| `context.
|
|
709
|
-
| `
|
|
710
|
-
| `
|
|
711
|
-
| `method
|
|
712
|
-
| `method.
|
|
713
|
-
| `
|
|
714
|
-
| `
|
|
715
|
-
| `
|
|
716
|
-
| `agentPolicy
|
|
717
|
-
| `agentPolicy.
|
|
725
|
+
| Parameter | Type | Default value |
|
|
726
|
+
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
|
|
727
|
+
| `host` | `Pick`\<[`OysterHost`](host.md#oysterhost), `"backgroundOriginKey"`\> | `undefined` |
|
|
728
|
+
| `installation` | [`Installation`](apps.md#installation) | `undefined` |
|
|
729
|
+
| `release` | [`VerifiedRelease`](host.md#verifiedrelease) | `undefined` |
|
|
730
|
+
| `context` | \{ `scope`: \| \{ `kind`: `"team"`; `teamId`: `string`; \} \| \{ `kind`: `"standalone"`; `tenant`: `string`; \}; `computerId`: `string` \| `null`; `actor`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `backgroundLane?`: `string`; `backgroundOrigin?`: \{ `method`: `string`; `seal`: `string`; \}; `role?`: `"member"` \| `"owner"` \| `"admin"`; `soleMember?`: `true`; `workflow?`: \{ `workflowId`: `string`; `runId`: `string`; `nodeId`: `string`; `armedBy`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; \}; `idempotencyKey?`: `string`; \} | `undefined` |
|
|
731
|
+
| `context.scope` | \| \{ `kind`: `"team"`; `teamId`: `string`; \} \| \{ `kind`: `"standalone"`; `tenant`: `string`; \} | `undefined` |
|
|
732
|
+
| `context.computerId` | `string` \| `null` | `undefined` |
|
|
733
|
+
| `context.actor` | \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \} | `undefined` |
|
|
734
|
+
| `context.backgroundLane?` | `string` | `undefined` |
|
|
735
|
+
| `context.backgroundOrigin?` | \{ `method`: `string`; `seal`: `string`; \} | `undefined` |
|
|
736
|
+
| `context.backgroundOrigin.method?` | `string` | `undefined` |
|
|
737
|
+
| `context.backgroundOrigin.seal?` | `string` | `undefined` |
|
|
738
|
+
| `context.role?` | `"member"` \| `"owner"` \| `"admin"` | `undefined` |
|
|
739
|
+
| `context.soleMember?` | `true` | `undefined` |
|
|
740
|
+
| `context.workflow?` | \{ `workflowId`: `string`; `runId`: `string`; `nodeId`: `string`; `armedBy`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; \} | `undefined` |
|
|
741
|
+
| `context.workflow.workflowId?` | `string` | `undefined` |
|
|
742
|
+
| `context.workflow.runId?` | `string` | `undefined` |
|
|
743
|
+
| `context.workflow.nodeId?` | `string` | `undefined` |
|
|
744
|
+
| `context.workflow.armedBy?` | \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \} | `undefined` |
|
|
745
|
+
| `context.idempotencyKey?` | `string` | `undefined` |
|
|
746
|
+
| `grants?` | readonly `object`[] | `undefined` |
|
|
747
|
+
| `method?` | \{ `name`: `string`; `effect`: `"read"` \| `"write"` \| `"external"`; \} | `undefined` |
|
|
748
|
+
| `method.name?` | `string` | `appApiMethodNameSchema` |
|
|
749
|
+
| `method.effect?` | `"read"` \| `"write"` \| `"external"` | `...` |
|
|
750
|
+
| `ancestry?` | readonly [`InstanceId`](index.md#instanceid)[] | `[]` |
|
|
751
|
+
| `sessionId?` | `string` | `undefined` |
|
|
752
|
+
| `agentPolicy?` | \{ `policyRevision`: `string`; `grantorMemberId`: `string`; \} | `undefined` |
|
|
753
|
+
| `agentPolicy.policyRevision?` | `string` | `appToolPolicySchema.fields.revision` |
|
|
754
|
+
| `agentPolicy.grantorMemberId?` | `string` | `appToolPolicySchema.fields.grantedBy` |
|
|
718
755
|
|
|
719
756
|
#### Returns
|
|
720
757
|
|
|
@@ -722,21 +759,22 @@ Seal the host-verified named method after its current admission checks.
|
|
|
722
759
|
`instanceId`: [`InstanceId`](index.md#instanceid); `owner`: \{ `kind`:
|
|
723
760
|
`"installation"` \| `"deployment"`; `id`: `string`; \}; `appId`: `AppId`;
|
|
724
761
|
`releaseId`: `ReleaseId`; `authorityVersion`: `number`; \}; `artifactDigest`:
|
|
725
|
-
`Sha256Digest`; `subject`: \| \{ `kind`: `"call"`; `context`: \{ `
|
|
726
|
-
`
|
|
727
|
-
|
|
728
|
-
`
|
|
729
|
-
`
|
|
730
|
-
`
|
|
731
|
-
`
|
|
732
|
-
`
|
|
733
|
-
`kind`: `"
|
|
734
|
-
|
|
735
|
-
`
|
|
736
|
-
`
|
|
737
|
-
`
|
|
738
|
-
`
|
|
739
|
-
`
|
|
740
|
-
`
|
|
741
|
-
`
|
|
762
|
+
`Sha256Digest`; `subject`: \| \{ `kind`: `"call"`; `context`: \{ `scope`: \| \{
|
|
763
|
+
`kind`: `"team"`; `teamId`: `string`; \} \| \{ `kind`: `"standalone"`; `tenant`:
|
|
764
|
+
`string`; \}; `computerId`: `string` \| `null`; `actor`: \| \{ `kind`:
|
|
765
|
+
`"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`:
|
|
766
|
+
`string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \};
|
|
767
|
+
`backgroundLane?`: `string`; `backgroundOrigin?`: \{ `method`: `string`; `seal`:
|
|
768
|
+
`string`; \}; `role?`: `"member"` \| `"owner"` \| `"admin"`; `soleMember?`:
|
|
769
|
+
`true`; `workflow?`: \{ `workflowId`: `string`; `runId`: `string`; `nodeId`:
|
|
770
|
+
`string`; `armedBy`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{
|
|
771
|
+
`kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`:
|
|
772
|
+
`string`; \}; \}; `idempotencyKey?`: `string`; \}; `sessionId?`: `string`;
|
|
773
|
+
`agentPolicy?`: \{ `policyRevision`: `string`; `grantorMemberId`: `string`; \};
|
|
774
|
+
`method?`: \{ `name`: `string`; `effect`: `"read"` \| `"write"` \| `"external"`;
|
|
775
|
+
\}; `replay?`: \{ `lane`: `string`; `epoch`: `number`; `admitted`: readonly
|
|
776
|
+
`string`[]; \}; \} \| \{ `kind`: `"lifecycle"`; `name`: `"onGitPush"`;
|
|
777
|
+
`eventId`: `string`; \} \| \{ `kind`: `"lifecycle"`; `name`: `"syncRefused"`;
|
|
778
|
+
`lane`: `string`; `code`: `"access_changed"` \| `"installation_unavailable"`;
|
|
779
|
+
\}; `grants`: readonly `object`[]; `deadlineAt`: `number`; `ancestry`: readonly
|
|
742
780
|
[`InstanceId`](index.md#instanceid)[]; \}\>
|