@fungi.computer/oyster 0.37.1 → 0.38.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 +5 -4
- package/dist/agents.js +9 -2
- package/dist/app-builds.d.ts +1 -1
- package/dist/app-region.d.ts +94 -0
- package/dist/app-region.js +316 -0
- package/dist/authorization.d.ts +58 -9
- package/dist/authorization.js +56 -11
- package/dist/boot-host-script.js +1 -1
- package/dist/build/candidate-builder.d.ts +1 -1
- package/dist/build/candidate-cli.mjs +284 -17
- package/dist/build/effect.d.ts +3 -3
- package/dist/build/submission-contract.d.ts +1 -1
- package/dist/build/workspace-build.d.ts +2 -2
- package/dist/channels/discord-replies.d.ts +8 -1
- package/dist/channels/discord-replies.js +80 -29
- package/dist/cloudflare.d.ts +1 -0
- package/dist/cloudflare.js +11 -0
- package/dist/credential-migration-001.d.ts +14 -0
- package/dist/credential-migration-001.js +13 -0
- package/dist/credential-migration-002.d.ts +38 -0
- package/dist/credential-migration-002.js +74 -0
- package/dist/embed-metafiles.js +2 -2
- package/dist/embed-scripts.js +1 -1
- package/dist/host.d.ts +2 -0
- package/dist/host.js +20 -1
- package/dist/index.d.ts +15 -1
- package/dist/index.js +19 -0
- package/dist/invocation.d.ts +165 -0
- package/dist/invocation.js +67 -0
- package/dist/keys.d.ts +4 -3
- package/dist/keys.js +5 -4
- package/dist/mcp-owner.d.ts +4 -3
- package/dist/mcp-owner.js +3 -2
- package/dist/page/mount.js +5 -1
- package/dist/page/region.d.ts +6 -0
- package/dist/page/region.js +12 -0
- package/dist/page-config.d.ts +2 -0
- package/dist/page-config.js +2 -0
- package/dist/page-script.js +3 -3
- package/dist/source/seed-receipt.d.ts +1 -1
- package/dist/source/template-seed.d.ts +1 -1
- package/dist/standalone/agent-connections.d.ts +49 -1
- package/dist/standalone/agent-connections.js +101 -12
- package/dist/standalone/agent-self.js +2 -1
- package/dist/standalone/agents.d.ts +7 -3
- package/dist/standalone/agents.js +42 -19
- package/dist/standalone/computer-fleet.d.ts +12 -6
- package/dist/standalone/computer-fleet.js +70 -29
- package/dist/standalone/computer.js +39 -14
- package/dist/standalone/instance.d.ts +3 -1
- package/dist/standalone/instance.js +8 -0
- package/dist/standalone/model-key-vault.d.ts +33 -4
- package/dist/standalone/model-key-vault.js +74 -17
- package/dist/standalone/preview.js +11 -10
- package/dist/standalone/try-cli.d.ts +12 -2
- package/dist/standalone/try-cli.js +170 -32
- package/dist/standalone/try-worker.d.ts +2 -0
- package/dist/standalone/try-worker.js +15 -0
- package/dist/standalone/worker.js +3 -3
- package/dist/standalone/workflow-host.d.ts +1 -1
- package/dist/standalone/workflows.d.ts +3 -3
- package/dist/standalone/workflows.js +7 -0
- package/dist/testing/capabilities.d.ts +2 -0
- package/dist/testing/capabilities.js +2 -0
- package/dist/webhook-custody.d.ts +14 -3
- package/dist/webhook-custody.js +165 -43
- package/dist/webhooks.d.ts +1 -1
- package/dist/webhooks.js +15 -3
- package/dist/workers-git.d.ts +24 -8
- package/dist/workers-git.js +105 -15
- package/dist/workers.d.ts +16 -0
- package/dist/workers.js +95 -5
- package/docs/api/apps.md +31 -31
- package/docs/api/authorization.md +119 -17
- package/docs/api/build-contract.md +8 -8
- package/docs/api/build.md +163 -174
- package/docs/api/cloudflare.md +171 -0
- package/docs/api/host.md +1 -0
- package/docs/api/index.md +23 -0
- package/docs/api/invocation.md +623 -23
- package/docs/api/keys.md +6 -6
- package/docs/api/pack.md +3 -3
- package/docs/api/page/mount.md +22 -20
- package/docs/api/workers-git.md +273 -157
- package/docs/api/workers.md +257 -175
- package/package.json +19 -18
package/docs/api/keys.md
CHANGED
|
@@ -86,10 +86,11 @@ const oysterKeyVocabulary: GrantVocabulary<OysterKeyCapability>;
|
|
|
86
86
|
|
|
87
87
|
`apps.use` also reaches `apps.read` (one level, per `defineGrants`'s own
|
|
88
88
|
`implies`): a key that may change an App's data may also read it. `computer.use`
|
|
89
|
-
has no narrower capability under it
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
89
|
+
has no narrower capability under it. Over all Computers it follows the owner's
|
|
90
|
+
current selection; over selected Computer ids it stays on those Computers
|
|
91
|
+
whatever the owner selects. `agents.use` selects Agent ids independently of App
|
|
92
|
+
grants. `machine.enroll` admits enrollment only; it implies no App or Computer
|
|
93
|
+
access. The enrollment owner, not this vocabulary, owns one-use consumption.
|
|
93
94
|
|
|
94
95
|
---
|
|
95
96
|
|
|
@@ -99,8 +100,7 @@ owner, not this vocabulary, owns one-use consumption.
|
|
|
99
100
|
const computerUseGrant: Grant<OysterKeyCapability>;
|
|
100
101
|
```
|
|
101
102
|
|
|
102
|
-
The grant that turns on the Computer for a key
|
|
103
|
-
target.
|
|
103
|
+
The grant that turns on the owner's currently selected Computer for a key.
|
|
104
104
|
|
|
105
105
|
## Functions
|
|
106
106
|
|
package/docs/api/pack.md
CHANGED
|
@@ -307,9 +307,9 @@ retains its original lifetime.
|
|
|
307
307
|
|
|
308
308
|
#### Parameters
|
|
309
309
|
|
|
310
|
-
| Parameter | Type
|
|
311
|
-
| --------- |
|
|
312
|
-
| `input` | `Readonly`\<\{ `appId`: `string`; `releaseId?`: `string`; `recipe`: \{ `kind?`: `"bundled-html"` \| `"source-html"`; `entry`: `string`; `assets?`: \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \}; `assetBase?`: `string`; `backend`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `maxOutputBytes`: `number`; \}; `source`: `Readonly`\<\{ `remote`: `string`; `token`: `string`; `sourceRevision`: `string`; \}\>; `packageStoreDirectory?`: `string`; `url`: `string`; `key`: `string`; `installationId`: `string`; \}\> & `Readonly`\<\{ `waitMs?`: `number`; `signal?`: `AbortSignal`; \}\> |
|
|
310
|
+
| Parameter | Type |
|
|
311
|
+
| --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
312
|
+
| `input` | `Readonly`\<\{ `appId`: `string`; `releaseId?`: `string`; `recipe`: \{ `kind?`: `"bundled-html"` \| `"source-html"`; `entry`: `string`; `assets?`: \{ `maxManifestBytes`: `number`; `maxObjects`: `number`; `maxObjectBytes`: `number`; `maxTotalBytes`: `number`; \}; `assetBase?`: `string`; `backend`: \| \{ `entry?`: `string`; `runtime`: \{ `kind`: `"durable-facet"` \| `"region"`; `stateSchema`: `number`; \}; `compatibilityDate`: `string`; `exportName`: `string`; \} \| `null`; `maxOutputBytes`: `number`; \}; `source`: `Readonly`\<\{ `remote`: `string`; `token`: `string`; `sourceRevision`: `string`; \}\>; `packageStoreDirectory?`: `string`; `url`: `string`; `key`: `string`; `installationId`: `string`; \}\> & `Readonly`\<\{ `waitMs?`: `number`; `signal?`: `AbortSignal`; \}\> |
|
|
313
313
|
|
|
314
314
|
#### Returns
|
|
315
315
|
|
package/docs/api/page/mount.md
CHANGED
|
@@ -182,6 +182,7 @@ Read the server-admitted configuration this page was served with.
|
|
|
182
182
|
| `uiUrl` | `string` | `Schema.String` | - |
|
|
183
183
|
| `backendUrl` | `string` | `Schema.String` | - |
|
|
184
184
|
| `methodsUrl` | `string` | `Schema.String` | - |
|
|
185
|
+
| `regionUrl?` | `string` | - | The admitted Region socket door; absent when the App has no backend. |
|
|
185
186
|
| `capabilities` | readonly `object`[] | - | - |
|
|
186
187
|
|
|
187
188
|
---
|
|
@@ -212,26 +213,27 @@ would, without a frame between the shell and its host.
|
|
|
212
213
|
|
|
213
214
|
#### Parameters
|
|
214
215
|
|
|
215
|
-
| Parameter | Type
|
|
216
|
-
| ------------------------- |
|
|
217
|
-
| `config` | \{ `workbench`: `boolean`; `shellModuleUrl`: `string` \| `null`; `storage`: `boolean`; `appsOpen`: `boolean`; `computerId`: `string` \| `null`; `computerName?`: `string` \| `null`; `authorityVersion`: `number`; `commands`: readonly `Readonly`\<\{ `id`: `string`; `title`: `string`; `category`: `string`; `description?`: `string`; `sigil?`: `string`; `projections?`: `Readonly`\<\{ `bindings?`: `Readonly`\<\{ `order?`: ...; \}\> & `Readonly`\<\{ `values`: ...; \}\>; `agent?`: `Readonly`\<\{ `order?`: ...; \}\> & `Readonly`\<\{ `keybind?`: ...; \}\>; `help?`: `Readonly`\<\{ `order?`: ... \| ...; \}\>; `menu?`: `Readonly`\<\{ `order?`: ... \| ...; \}\>; `palette?`: `Readonly`\<\{ `order?`: ... \| ...; \}\>; `slash?`: `Readonly`\<\{ `order?`: ...; \}\> & `Readonly`\<\{ `aliases`: ...; \}\>; \}\>; \}\>[]; `icon`: `string` \| `null`; `roles`: readonly `string`[]; `installationId`: `string`; `appId`: `string`; `releaseId`: `string`; `uiUrl`: `string`; `backendUrl`: `string`; `methodsUrl`: `string`; `capabilities`: readonly `object`[]; \} | - |
|
|
218
|
-
| `config.workbench` | `boolean`
|
|
219
|
-
| `config.shellModuleUrl` | `string` \| `null`
|
|
220
|
-
| `config.storage` | `boolean`
|
|
221
|
-
| `config.appsOpen` | `boolean`
|
|
222
|
-
| `config.computerId` | `string` \| `null`
|
|
223
|
-
| `config.computerName?` | `string` \| `null`
|
|
224
|
-
| `config.authorityVersion` | `number`
|
|
225
|
-
| `config.commands` | readonly `Readonly`\<\{ `id`: `string`; `title`: `string`; `category`: `string`; `description?`: `string`; `sigil?`: `string`; `projections?`: `Readonly`\<\{ `bindings?`: `Readonly`\<\{ `order?`: ...; \}\> & `Readonly`\<\{ `values`: ...; \}\>; `agent?`: `Readonly`\<\{ `order?`: ...; \}\> & `Readonly`\<\{ `keybind?`: ...; \}\>; `help?`: `Readonly`\<\{ `order?`: ... \| ...; \}\>; `menu?`: `Readonly`\<\{ `order?`: ... \| ...; \}\>; `palette?`: `Readonly`\<\{ `order?`: ... \| ...; \}\>; `slash?`: `Readonly`\<\{ `order?`: ...; \}\> & `Readonly`\<\{ `aliases`: ...; \}\>; \}\>; \}\>[]
|
|
226
|
-
| `config.icon` | `string` \| `null`
|
|
227
|
-
| `config.roles` | readonly `string`[]
|
|
228
|
-
| `config.installationId` | `string`
|
|
229
|
-
| `config.appId` | `string`
|
|
230
|
-
| `config.releaseId` | `string`
|
|
231
|
-
| `config.uiUrl` | `string`
|
|
232
|
-
| `config.backendUrl` | `string`
|
|
233
|
-
| `config.methodsUrl` | `string`
|
|
234
|
-
| `config.
|
|
216
|
+
| Parameter | Type | Description |
|
|
217
|
+
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
|
|
218
|
+
| `config` | \{ `workbench`: `boolean`; `shellModuleUrl`: `string` \| `null`; `storage`: `boolean`; `appsOpen`: `boolean`; `computerId`: `string` \| `null`; `computerName?`: `string` \| `null`; `authorityVersion`: `number`; `commands`: readonly `Readonly`\<\{ `id`: `string`; `title`: `string`; `category`: `string`; `description?`: `string`; `sigil?`: `string`; `projections?`: `Readonly`\<\{ `bindings?`: `Readonly`\<\{ `order?`: ...; \}\> & `Readonly`\<\{ `values`: ...; \}\>; `agent?`: `Readonly`\<\{ `order?`: ...; \}\> & `Readonly`\<\{ `keybind?`: ...; \}\>; `help?`: `Readonly`\<\{ `order?`: ... \| ...; \}\>; `menu?`: `Readonly`\<\{ `order?`: ... \| ...; \}\>; `palette?`: `Readonly`\<\{ `order?`: ... \| ...; \}\>; `slash?`: `Readonly`\<\{ `order?`: ...; \}\> & `Readonly`\<\{ `aliases`: ...; \}\>; \}\>; \}\>[]; `icon`: `string` \| `null`; `roles`: readonly `string`[]; `installationId`: `string`; `appId`: `string`; `releaseId`: `string`; `uiUrl`: `string`; `backendUrl`: `string`; `methodsUrl`: `string`; `regionUrl?`: `string`; `capabilities`: readonly `object`[]; \} | - |
|
|
219
|
+
| `config.workbench` | `boolean` | - |
|
|
220
|
+
| `config.shellModuleUrl` | `string` \| `null` | The home shell Release's own module, imported top-level; null if it ships none. |
|
|
221
|
+
| `config.storage` | `boolean` | - |
|
|
222
|
+
| `config.appsOpen` | `boolean` | The Release declares `apps.open`; only an embedding shell can serve it. |
|
|
223
|
+
| `config.computerId` | `string` \| `null` | - |
|
|
224
|
+
| `config.computerName?` | `string` \| `null` | - |
|
|
225
|
+
| `config.authorityVersion` | `number` | - |
|
|
226
|
+
| `config.commands` | readonly `Readonly`\<\{ `id`: `string`; `title`: `string`; `category`: `string`; `description?`: `string`; `sigil?`: `string`; `projections?`: `Readonly`\<\{ `bindings?`: `Readonly`\<\{ `order?`: ...; \}\> & `Readonly`\<\{ `values`: ...; \}\>; `agent?`: `Readonly`\<\{ `order?`: ...; \}\> & `Readonly`\<\{ `keybind?`: ...; \}\>; `help?`: `Readonly`\<\{ `order?`: ... \| ...; \}\>; `menu?`: `Readonly`\<\{ `order?`: ... \| ...; \}\>; `palette?`: `Readonly`\<\{ `order?`: ... \| ...; \}\>; `slash?`: `Readonly`\<\{ `order?`: ...; \}\> & `Readonly`\<\{ `aliases`: ...; \}\>; \}\>; \}\>[] | - |
|
|
227
|
+
| `config.icon` | `string` \| `null` | - |
|
|
228
|
+
| `config.roles` | readonly `string`[] | - |
|
|
229
|
+
| `config.installationId` | `string` | - |
|
|
230
|
+
| `config.appId` | `string` | - |
|
|
231
|
+
| `config.releaseId` | `string` | - |
|
|
232
|
+
| `config.uiUrl` | `string` | - |
|
|
233
|
+
| `config.backendUrl` | `string` | - |
|
|
234
|
+
| `config.methodsUrl` | `string` | - |
|
|
235
|
+
| `config.regionUrl?` | `string` | The admitted Region socket door; absent when the App has no backend. |
|
|
236
|
+
| `config.capabilities` | readonly `object`[] | - |
|
|
235
237
|
|
|
236
238
|
#### Returns
|
|
237
239
|
|