@fungi.computer/oyster 0.37.2 → 0.38.1
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/backend-request.d.ts +4 -0
- package/dist/backend-request.js +3 -10
- 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 +12 -2
- 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 +23 -13
- 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 +2 -2
- 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
|
|