@fungi.computer/oyster 0.23.0 → 0.25.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.
Files changed (41) hide show
  1. package/dist/agent-instructions.d.ts +35 -0
  2. package/dist/agent-instructions.js +42 -0
  3. package/dist/agents.d.ts +14 -0
  4. package/dist/agents.js +43 -1
  5. package/dist/apps/catalog.d.ts +11 -0
  6. package/dist/apps/catalog.js +1 -0
  7. package/dist/apps/gate.d.ts +2 -2
  8. package/dist/apps/installation.d.ts +7 -7
  9. package/dist/apps/permissions.d.ts +5 -5
  10. package/dist/boot-host-script.js +1 -1
  11. package/dist/browser/boot-once.d.ts +84 -0
  12. package/dist/browser/boot-once.js +48 -0
  13. package/dist/build/candidate-cli.mjs +6 -0
  14. package/dist/channels/discord-interactions.d.ts +15 -0
  15. package/dist/channels/discord-interactions.js +29 -0
  16. package/dist/channels/discord-replies.d.ts +9 -1
  17. package/dist/channels/discord-replies.js +34 -9
  18. package/dist/embed-metafiles.js +2 -2
  19. package/dist/embed-scripts.js +1 -1
  20. package/dist/installation-operations.d.ts +8 -8
  21. package/dist/machine-link/link.js +3 -1
  22. package/dist/page/computer-handles.d.ts +4 -0
  23. package/dist/page-script.js +2 -2
  24. package/dist/standalone/agents.d.ts +20 -0
  25. package/dist/standalone/agents.js +96 -13
  26. package/dist/standalone/computer.d.ts +3 -3
  27. package/dist/standalone/computer.js +37 -1
  28. package/dist/standalone/workflow-host.d.ts +5 -5
  29. package/dist/standalone/workflow-trigger-host.d.ts +1 -1
  30. package/docs/api/agents.md +18 -0
  31. package/docs/api/apps.md +148 -131
  32. package/docs/api/browser/boot-once.md +169 -0
  33. package/docs/api/build-contract.md +27 -21
  34. package/docs/api/build.md +70 -69
  35. package/docs/api/git.md +3 -3
  36. package/docs/api/host.md +91 -85
  37. package/docs/api/mcp.md +16 -16
  38. package/docs/api/modules.md +1 -0
  39. package/docs/api/workers-git.md +7 -7
  40. package/docs/api/workers.md +24 -21
  41. package/package.json +25 -17
package/docs/api/git.md CHANGED
@@ -217,9 +217,9 @@ storage.
217
217
 
218
218
  #### Parameters
219
219
 
220
- | Parameter | Type |
221
- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
222
- | `ports` | `Readonly`\<\{ `currentInstallation`: `Promise`\< \| `Readonly`\<\{ `installationId`: `string`; `instanceId`: [`InstanceId`](index.md#instanceid) \| `null`; `appId`: `AppId`; `release`: \{ `releaseId`: `Schema.refine`\<`ReleaseId`, `Schema.String`\>; `appId`: `Schema.refine`\<`AppId`, `Schema.String`\>; `artifact`: `Schema.Struct`\<\{ `artifactRef`: `Schema.refine`\<`ArtifactRef`, `Schema.String`\>; `artifactDigest`: `Schema.refine`\<`Sha256Digest`, `Schema.String`\>; `provenance`: `Schema.Struct`\<\{ `sourceRevision`: ...; `sourceTreeDigest`: ...; `buildRecipeDigest`: ...; \}\>; \}\>; \}; `releasePin`: `"pinned"` \| `"floating"`; `authority`: \{ `authorityVersion`: `number`; `declaredOperationsDigest`: `Sha256Digest`; `approvedGrants`: readonly `Readonly`\<\{ `capability`: \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ...; `capabilityApproved`: `true`; `operations`: readonly ...[]; `resources`: ... \| ...; \}\>[]; `approval`: \| `Readonly`\<\{ `by`: ... \| ... \| ...; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null`; \}; `status`: `"enabled"` \| `"disabled"` \| `"deleted"`; \}\> \| `null`\>; `declaration`: `Promise`\< \| `Readonly`\<\{ `api?`: `AppApi`; `displayName?`: `string`; `capabilities`: readonly `AppCapabilityId`[]; `calls?`: readonly `Readonly`\<\{ `appId`: ...; `methods`: ...; \}\>[]; `guidance?`: `string`; `handlers`: readonly `AppHandler`[]; `receives?`: readonly `"git.push"`[]; `icon?`: `string`; `roles`: readonly `AppRole`[]; `storage?`: readonly `AppStorageKey`[]; `commands?`: readonly `AppDeclaredCommand`[]; `gills?`: readonly `AppDeclaredGill`[]; `backend?`: `Readonly`\<\{ `bindings`: readonly ...[]; `sync?`: `Readonly`\<\{ `method`: ...; \}\>; \}\>; \}\> \| `null`\>; \}\> |
220
+ | Parameter | Type |
221
+ | --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
222
+ | `ports` | `Readonly`\<\{ `currentInstallation`: `Promise`\< \| `Readonly`\<\{ `installationId`: `string`; `instanceId`: [`InstanceId`](index.md#instanceid) \| `null`; `appId`: `AppId`; `release`: \{ `releaseId`: `Schema.refine`\<`ReleaseId`, `Schema.String`\>; `appId`: `Schema.refine`\<`AppId`, `Schema.String`\>; `artifact`: `Schema.Struct`\<\{ `artifactRef`: `Schema.refine`\<`ArtifactRef`, `Schema.String`\>; `artifactDigest`: `Schema.refine`\<`Sha256Digest`, `Schema.String`\>; `provenance`: `Schema.Struct`\<\{ `sourceRevision`: ...; `sourceTreeDigest`: ...; `buildRecipeDigest`: ...; \}\>; \}\>; \}; `releasePin`: `"pinned"` \| `"floating"`; `authority`: \{ `authorityVersion`: `number`; `declaredOperationsDigest`: `Sha256Digest`; `approvedGrants`: readonly `Readonly`\<\{ `capability`: \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ... \| ...; `capabilityApproved`: `true`; `operations`: readonly ...[]; `resources`: ... \| ...; \}\>[]; `approval`: \| `Readonly`\<\{ `by`: ... \| ... \| ...; `at`: `number`; `authorityVersion`: `number`; \}\> \| `null`; \}; `status`: `"enabled"` \| `"disabled"` \| `"deleted"`; \}\> \| `null`\>; `declaration`: `Promise`\< \| `Readonly`\<\{ `api?`: `AppApi`; `displayName?`: `string`; `capabilities`: readonly `AppCapabilityId`[]; `calls?`: readonly `Readonly`\<\{ `appId`: ...; `methods`: ...; \}\>[]; `guidance?`: `string`; `handlers`: readonly `AppHandler`[]; `receives?`: readonly `"git.push"`[]; `icon?`: `string`; `roles`: readonly `AppRole`[]; `storage?`: readonly `AppStorageKey`[]; `commands?`: readonly `AppDeclaredCommand`[]; `gills?`: readonly `AppDeclaredGill`[]; `backend?`: `Readonly`\<\{ `bindings`: readonly ...[]; `sync?`: `Readonly`\<\{ `method`: ...; \}\>; \}\>; \}\> \| `null`\>; \}\> |
223
223
 
224
224
  #### Returns
225
225
 
package/docs/api/host.md CHANGED
@@ -1209,6 +1209,7 @@ type InstallationOperations = Readonly<{
1209
1209
  | ...
1210
1210
  | ...
1211
1211
  | ...
1212
+ | ...
1212
1213
  | ...;
1213
1214
  capabilityApproved: true;
1214
1215
  operations: readonly ...[];
@@ -1653,6 +1654,7 @@ function verifyRelease(
1653
1654
  | "agent.manage"
1654
1655
  | "agent.rename"
1655
1656
  | "agent.avatar"
1657
+ | "agent.instructions"
1656
1658
  | "agent.toolPolicy"
1657
1659
  | "agent.read"
1658
1660
  | "agent.send"
@@ -1722,6 +1724,7 @@ function verifyRelease(
1722
1724
  | "agent.manage"
1723
1725
  | "agent.rename"
1724
1726
  | "agent.avatar"
1727
+ | "agent.instructions"
1725
1728
  | "agent.toolPolicy"
1726
1729
  | "agent.read"
1727
1730
  | "agent.send"
@@ -1784,6 +1787,7 @@ function verifyRelease(
1784
1787
  | "agent.manage"
1785
1788
  | "agent.rename"
1786
1789
  | "agent.avatar"
1790
+ | "agent.instructions"
1787
1791
  | "agent.toolPolicy"
1788
1792
  | "agent.read"
1789
1793
  | "agent.send"
@@ -1871,6 +1875,7 @@ function verifyRelease(
1871
1875
  | "agent.manage"
1872
1876
  | "agent.rename"
1873
1877
  | "agent.avatar"
1878
+ | "agent.instructions"
1874
1879
  | "agent.toolPolicy"
1875
1880
  | "agent.read"
1876
1881
  | "agent.send"
@@ -1975,30 +1980,7 @@ standalone HTML.
1975
1980
  `events?`: ...; \}\>; `displayName?`: `string`; `capabilities`: readonly ( \|
1976
1981
  `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \|
1977
1982
  `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \|
1978
- `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"`
1979
- \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \|
1980
- `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \|
1981
- `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \|
1982
- `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \|
1983
- `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \|
1984
- `"channels.read"` \| `"channels.personal.manage"`)[]; `calls?`: readonly
1985
- `Readonly`\<...\>[]; `guidance?`: `string`; `handlers`: readonly
1986
- `"file.open"`[]; `receives?`: readonly `"git.push"`[]; `icon?`: `string`;
1987
- `roles`: readonly (`"files"` \| `"dashboard"` \| `"inbox"` \| `"media"` \|
1988
- `"sessions"` \| `"terminal"`)[]; `storage?`: readonly `Readonly`\<...\>[];
1989
- `commands?`: readonly `Readonly`\<...\>[]; `gills?`: readonly
1990
- `Readonly`\<...\>[]; `backend?`: `Readonly`\<\{ `bindings`: ...; `sync?`: ...;
1991
- \}\>; \}\>; `format`: `"fungi-app-v1"`; `ui`: \{ `mediaType`:
1992
- `"text/html; charset=utf-8"` \| `"application/vnd.fungi.app-assets+json"`;
1993
- `artifactRef`: `ArtifactRef`; `digest`: `Sha256Digest`; `version`: `string`;
1994
- `byteLength`: `number`; \}; `backend`: \{ `mediaType`:
1995
- `"application/vnd.fungi.app-backend+json"`; `artifactRef`: `ArtifactRef`;
1996
- `digest`: `Sha256Digest`; `version`: `string`; `byteLength`: `number`; \}; \} \|
1997
- \{ `declaration?`: `Readonly`\<\{ `api?`: `Readonly`\<\{ `methods`: ...;
1998
- `toolFamily?`: ...; `events?`: ...; \}\>; `displayName?`: `string`;
1999
- `capabilities`: readonly ( \| `"computer.list"` \| `"computer.readFile"` \|
2000
- `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \|
2001
- `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \|
1983
+ `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \|
2002
1984
  `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"`
2003
1985
  \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \|
2004
1986
  `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \|
@@ -2014,26 +1996,49 @@ readonly `"git.push"`[]; `icon?`: `string`; `roles`: readonly (`"files"` \|
2014
1996
  `Readonly`\<\{ `bindings`: ...; `sync?`: ...; \}\>; \}\>; `format`:
2015
1997
  `"fungi-app-v1"`; `ui`: \{ `mediaType`: `"text/html; charset=utf-8"` \|
2016
1998
  `"application/vnd.fungi.app-assets+json"`; `artifactRef`: `ArtifactRef`;
2017
- `digest`: `Sha256Digest`; `version`: `string`; `byteLength`: `number`; \}; \} \|
2018
- \{ `declaration?`: `Readonly`\<\{ `api?`: `Readonly`\<\{ `methods`: ...;
2019
- `toolFamily?`: ...; `events?`: ...; \}\>; `displayName?`: `string`;
2020
- `capabilities`: readonly ( \| `"computer.list"` \| `"computer.readFile"` \|
2021
- `"computer.writeFile"` \| `"computer.execute"` \| `"approvals"` \|
2022
- `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \| `"agent.avatar"` \|
2023
- `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"`
2024
- \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \|
2025
- `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \|
2026
- `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \|
2027
- `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \|
2028
- `"workflow.arm"` \| `"world"` \| `"channels.read"` \|
2029
- `"channels.personal.manage"`)[]; `calls?`: readonly `Readonly`\<...\>[];
2030
- `guidance?`: `string`; `handlers`: readonly `"file.open"`[]; `receives?`:
2031
- readonly `"git.push"`[]; `icon?`: `string`; `roles`: readonly (`"files"` \|
2032
- `"dashboard"` \| `"inbox"` \| `"media"` \| `"sessions"` \| `"terminal"`)[];
2033
- `storage?`: readonly `Readonly`\<...\>[]; `commands?`: readonly
2034
- `Readonly`\<...\>[]; `gills?`: readonly `Readonly`\<...\>[]; `backend?`:
2035
- `Readonly`\<\{ `bindings`: ...; `sync?`: ...; \}\>; \}\>; `format`:
2036
- `"fungi-app-v1"`; `backend`: \{ `mediaType`:
1999
+ `digest`: `Sha256Digest`; `version`: `string`; `byteLength`: `number`; \};
2000
+ `backend`: \{ `mediaType`: `"application/vnd.fungi.app-backend+json"`;
2001
+ `artifactRef`: `ArtifactRef`; `digest`: `Sha256Digest`; `version`: `string`;
2002
+ `byteLength`: `number`; \}; \} \| \{ `declaration?`: `Readonly`\<\{ `api?`:
2003
+ `Readonly`\<\{ `methods`: ...; `toolFamily?`: ...; `events?`: ...; \}\>;
2004
+ `displayName?`: `string`; `capabilities`: readonly ( \| `"computer.list"` \|
2005
+ `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \|
2006
+ `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \|
2007
+ `"agent.avatar"` \| `"agent.instructions"` \| `"agent.toolPolicy"` \|
2008
+ `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"`
2009
+ \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"`
2010
+ \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \|
2011
+ `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \|
2012
+ `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \|
2013
+ `"channels.read"` \| `"channels.personal.manage"`)[]; `calls?`: readonly
2014
+ `Readonly`\<...\>[]; `guidance?`: `string`; `handlers`: readonly
2015
+ `"file.open"`[]; `receives?`: readonly `"git.push"`[]; `icon?`: `string`;
2016
+ `roles`: readonly (`"files"` \| `"dashboard"` \| `"inbox"` \| `"media"` \|
2017
+ `"sessions"` \| `"terminal"`)[]; `storage?`: readonly `Readonly`\<...\>[];
2018
+ `commands?`: readonly `Readonly`\<...\>[]; `gills?`: readonly
2019
+ `Readonly`\<...\>[]; `backend?`: `Readonly`\<\{ `bindings`: ...; `sync?`: ...;
2020
+ \}\>; \}\>; `format`: `"fungi-app-v1"`; `ui`: \{ `mediaType`:
2021
+ `"text/html; charset=utf-8"` \| `"application/vnd.fungi.app-assets+json"`;
2022
+ `artifactRef`: `ArtifactRef`; `digest`: `Sha256Digest`; `version`: `string`;
2023
+ `byteLength`: `number`; \}; \} \| \{ `declaration?`: `Readonly`\<\{ `api?`:
2024
+ `Readonly`\<\{ `methods`: ...; `toolFamily?`: ...; `events?`: ...; \}\>;
2025
+ `displayName?`: `string`; `capabilities`: readonly ( \| `"computer.list"` \|
2026
+ `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \|
2027
+ `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \|
2028
+ `"agent.avatar"` \| `"agent.instructions"` \| `"agent.toolPolicy"` \|
2029
+ `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"`
2030
+ \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"`
2031
+ \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \|
2032
+ `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \|
2033
+ `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \|
2034
+ `"channels.read"` \| `"channels.personal.manage"`)[]; `calls?`: readonly
2035
+ `Readonly`\<...\>[]; `guidance?`: `string`; `handlers`: readonly
2036
+ `"file.open"`[]; `receives?`: readonly `"git.push"`[]; `icon?`: `string`;
2037
+ `roles`: readonly (`"files"` \| `"dashboard"` \| `"inbox"` \| `"media"` \|
2038
+ `"sessions"` \| `"terminal"`)[]; `storage?`: readonly `Readonly`\<...\>[];
2039
+ `commands?`: readonly `Readonly`\<...\>[]; `gills?`: readonly
2040
+ `Readonly`\<...\>[]; `backend?`: `Readonly`\<\{ `bindings`: ...; `sync?`: ...;
2041
+ \}\>; \}\>; `format`: `"fungi-app-v1"`; `backend`: \{ `mediaType`:
2037
2042
  `"application/vnd.fungi.app-backend+json"`; `artifactRef`: `ArtifactRef`;
2038
2043
  `digest`: `Sha256Digest`; `version`: `string`; `byteLength`: `number`; \}; \};
2039
2044
  `api`: \| `Readonly`\<\{ `methods`: `Readonly`\<`Record`\<`string`,
@@ -2048,30 +2053,30 @@ readonly ...; `pending?`: ... \| ...; `hidden?`: ... \| ...; `present?`: ... \|
2048
2053
  `Readonly`\<...\>; \}\>; `displayName?`: `string`; `capabilities`: readonly ( \|
2049
2054
  `"computer.list"` \| `"computer.readFile"` \| `"computer.writeFile"` \|
2050
2055
  `"computer.execute"` \| `"approvals"` \| `"agent.list"` \| `"agent.manage"` \|
2051
- `"agent.rename"` \| `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"`
2052
- \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"` \|
2053
- `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"` \|
2054
- `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \|
2055
- `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \|
2056
- `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \|
2057
- `"channels.read"` \| `"channels.personal.manage"`)[]; `calls?`: readonly
2058
- `Readonly`\<\{ `appId`: `string`; `methods`: readonly ...[]; \}\>[];
2059
- `guidance?`: `string`; `handlers`: readonly `"file.open"`[]; `receives?`:
2060
- readonly `"git.push"`[]; `icon?`: `string`; `roles`: readonly (`"files"` \|
2061
- `"dashboard"` \| `"inbox"` \| `"media"` \| `"sessions"` \| `"terminal"`)[];
2062
- `storage?`: readonly `Readonly`\<\{ `key`: `string`; `scopes`: readonly ...[];
2063
- `maxBytes`: `number`; \}\>[]; `commands?`: readonly `Readonly`\<\{ `id`:
2064
- `string`; `title`: `string`; `category`: `string`; `description?`: ... \| ...;
2065
- `sigil?`: ... \| ...; `projections?`: ... \| ...; \}\>[]; `gills?`: readonly
2066
- `Readonly`\<\{ `id`: `string`; `source`: `string`; `title`: `string`; `params?`:
2067
- ... \| ...; `watch?`: ... \| ...; `desktop?`: ... \| ...; \}\>[]; `backend?`:
2068
- `Readonly`\<\{ `bindings`: readonly `Readonly`\<...\>[]; `sync?`:
2069
- `Readonly`\<...\>; \}\>; \}\> \| `null`; `ui`: \| `Readonly`\<\{ `kind`:
2070
- `"html"`; `artifactRef`: `ArtifactRef`; `digest`: `Sha256Digest`; \}\> \|
2071
- `Readonly`\<\{ `kind`: `"assets"`; `build`: \{ `format`: `"fungi-assets-v1"`;
2072
- `base`: `string`; `assets`: readonly `object`[]; \}; \}\> \| `null`; `backend`:
2073
- \| `Readonly`\<\{ `artifactRef`: `ArtifactRef`; `digest`: `Sha256Digest`; \}\>
2074
- \| `null`; \}\>\>
2056
+ `"agent.rename"` \| `"agent.avatar"` \| `"agent.instructions"` \|
2057
+ `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \| `"llm.generation"`
2058
+ \| `"media.generation"` \| `"media.share"` \| `"games:servers"` \|
2059
+ `"git.repository"` \| `"apps.open"` \| `"apps.call"` \| `"app.storage"` \|
2060
+ `"app.events.emit"` \| `"team.workbenchHost"` \| `"marketplace.browse"` \|
2061
+ `"marketplace.purchase"` \| `"workflow.run"` \| `"workflow.publish"` \|
2062
+ `"workflow.arm"` \| `"world"` \| `"channels.read"` \|
2063
+ `"channels.personal.manage"`)[]; `calls?`: readonly `Readonly`\<\{ `appId`:
2064
+ `string`; `methods`: readonly ...[]; \}\>[]; `guidance?`: `string`; `handlers`:
2065
+ readonly `"file.open"`[]; `receives?`: readonly `"git.push"`[]; `icon?`:
2066
+ `string`; `roles`: readonly (`"files"` \| `"dashboard"` \| `"inbox"` \|
2067
+ `"media"` \| `"sessions"` \| `"terminal"`)[]; `storage?`: readonly
2068
+ `Readonly`\<\{ `key`: `string`; `scopes`: readonly ...[]; `maxBytes`: `number`;
2069
+ \}\>[]; `commands?`: readonly `Readonly`\<\{ `id`: `string`; `title`: `string`;
2070
+ `category`: `string`; `description?`: ... \| ...; `sigil?`: ... \| ...;
2071
+ `projections?`: ... \| ...; \}\>[]; `gills?`: readonly `Readonly`\<\{ `id`:
2072
+ `string`; `source`: `string`; `title`: `string`; `params?`: ... \| ...;
2073
+ `watch?`: ... \| ...; `desktop?`: ... \| ...; \}\>[]; `backend?`: `Readonly`\<\{
2074
+ `bindings`: readonly `Readonly`\<...\>[]; `sync?`: `Readonly`\<...\>; \}\>; \}\>
2075
+ \| `null`; `ui`: \| `Readonly`\<\{ `kind`: `"html"`; `artifactRef`:
2076
+ `ArtifactRef`; `digest`: `Sha256Digest`; \}\> \| `Readonly`\<\{ `kind`:
2077
+ `"assets"`; `build`: \{ `format`: `"fungi-assets-v1"`; `base`: `string`;
2078
+ `assets`: readonly `object`[]; \}; \}\> \| `null`; `backend`: \| `Readonly`\<\{
2079
+ `artifactRef`: `ArtifactRef`; `digest`: `Sha256Digest`; \}\> \| `null`; \}\>\>
2075
2080
 
2076
2081
  ---
2077
2082
 
@@ -2099,6 +2104,7 @@ function resolveBackend(store, release): Promise<
2099
2104
  | "agent.manage"
2100
2105
  | "agent.rename"
2101
2106
  | "agent.avatar"
2107
+ | "agent.instructions"
2102
2108
  | "agent.toolPolicy"
2103
2109
  | "agent.read"
2104
2110
  | "agent.send"
@@ -2178,23 +2184,23 @@ root artifact, then the backend descriptor it names.
2178
2184
  \}\>; `displayName?`: `string`; `capabilities`: readonly ( \| `"computer.list"`
2179
2185
  \| `"computer.readFile"` \| `"computer.writeFile"` \| `"computer.execute"` \|
2180
2186
  `"approvals"` \| `"agent.list"` \| `"agent.manage"` \| `"agent.rename"` \|
2181
- `"agent.avatar"` \| `"agent.toolPolicy"` \| `"agent.read"` \| `"agent.send"` \|
2182
- `"llm.generation"` \| `"media.generation"` \| `"media.share"` \|
2183
- `"games:servers"` \| `"git.repository"` \| `"apps.open"` \| `"apps.call"` \|
2184
- `"app.storage"` \| `"app.events.emit"` \| `"team.workbenchHost"` \|
2185
- `"marketplace.browse"` \| `"marketplace.purchase"` \| `"workflow.run"` \|
2186
- `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \| `"channels.read"` \|
2187
- `"channels.personal.manage"`)[]; `calls?`: readonly `Readonly`\<\{ `appId`: ...;
2188
- `methods`: ...; \}\>[]; `guidance?`: `string`; `handlers`: readonly
2189
- `"file.open"`[]; `receives?`: readonly `"git.push"`[]; `icon?`: `string`;
2190
- `roles`: readonly (`"files"` \| `"dashboard"` \| `"inbox"` \| `"media"` \|
2191
- `"sessions"` \| `"terminal"`)[]; `storage?`: readonly `Readonly`\<\{ `key`: ...;
2192
- `scopes`: ...; `maxBytes`: ...; \}\>[]; `commands?`: readonly `Readonly`\<\{
2193
- `id`: ...; `title`: ...; `category`: ...; `description?`: ...; `sigil?`: ...;
2194
- `projections?`: ...; \}\>[]; `gills?`: readonly `Readonly`\<\{ `id`: ...;
2195
- `source`: ...; `title`: ...; `params?`: ...; `watch?`: ...; `desktop?`: ...;
2196
- \}\>[]; `backend?`: `Readonly`\<\{ `bindings`: readonly ...[]; `sync?`: ... \|
2197
- ...; \}\>; \}\> \| `null`; \}\> \| `null`\>
2187
+ `"agent.avatar"` \| `"agent.instructions"` \| `"agent.toolPolicy"` \|
2188
+ `"agent.read"` \| `"agent.send"` \| `"llm.generation"` \| `"media.generation"`
2189
+ \| `"media.share"` \| `"games:servers"` \| `"git.repository"` \| `"apps.open"`
2190
+ \| `"apps.call"` \| `"app.storage"` \| `"app.events.emit"` \|
2191
+ `"team.workbenchHost"` \| `"marketplace.browse"` \| `"marketplace.purchase"` \|
2192
+ `"workflow.run"` \| `"workflow.publish"` \| `"workflow.arm"` \| `"world"` \|
2193
+ `"channels.read"` \| `"channels.personal.manage"`)[]; `calls?`: readonly
2194
+ `Readonly`\<\{ `appId`: ...; `methods`: ...; \}\>[]; `guidance?`: `string`;
2195
+ `handlers`: readonly `"file.open"`[]; `receives?`: readonly `"git.push"`[];
2196
+ `icon?`: `string`; `roles`: readonly (`"files"` \| `"dashboard"` \| `"inbox"` \|
2197
+ `"media"` \| `"sessions"` \| `"terminal"`)[]; `storage?`: readonly
2198
+ `Readonly`\<\{ `key`: ...; `scopes`: ...; `maxBytes`: ...; \}\>[]; `commands?`:
2199
+ readonly `Readonly`\<\{ `id`: ...; `title`: ...; `category`: ...;
2200
+ `description?`: ...; `sigil?`: ...; `projections?`: ...; \}\>[]; `gills?`:
2201
+ readonly `Readonly`\<\{ `id`: ...; `source`: ...; `title`: ...; `params?`: ...;
2202
+ `watch?`: ...; `desktop?`: ...; \}\>[]; `backend?`: `Readonly`\<\{ `bindings`:
2203
+ readonly ...[]; `sync?`: ... \| ...; \}\>; \}\> \| `null`; \}\> \| `null`\>
2198
2204
 
2199
2205
  ## References
2200
2206
 
package/docs/api/mcp.md CHANGED
@@ -373,15 +373,15 @@ Derive the current principal's admitted App modules and grants.
373
373
 
374
374
  #### Parameters
375
375
 
376
- | Parameter | Type |
377
- | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
378
- | `host` | `Pick`\<[`OysterHost`](host.md#oysterhost), \| `"installations"` \| `"instances"` \| `"artifacts"` \| `"guestLimits"` \| `"backgroundOriginKey"` \| `"computerId"` \| `"capabilities"` \| `"appToolPolicy"` \| `"keys"` \| `"approvals"`\> |
379
- | `surfaces` | [`AppSurfaceCache`](#appsurfacecache) |
380
- | `principal` | [`TenantPrincipal`](tenant.md#tenantprincipal) |
381
- | `installations` | readonly `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.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"`; \}\>[] |
382
- | `access` | [`OysterCallerAccess`](#oystercalleraccess) |
383
- | `sessionId` | `string` \| `null` |
384
- | `mode` | `"approval"` \| `"direct"` |
376
+ | Parameter | Type |
377
+ | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
378
+ | `host` | `Pick`\<[`OysterHost`](host.md#oysterhost), \| `"installations"` \| `"instances"` \| `"artifacts"` \| `"guestLimits"` \| `"backgroundOriginKey"` \| `"computerId"` \| `"capabilities"` \| `"appToolPolicy"` \| `"keys"` \| `"approvals"`\> |
379
+ | `surfaces` | [`AppSurfaceCache`](#appsurfacecache) |
380
+ | `principal` | [`TenantPrincipal`](tenant.md#tenantprincipal) |
381
+ | `installations` | readonly `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"`; \}\>[] |
382
+ | `access` | [`OysterCallerAccess`](#oystercalleraccess) |
383
+ | `sessionId` | `string` \| `null` |
384
+ | `mode` | `"approval"` \| `"direct"` |
385
385
 
386
386
  #### Returns
387
387
 
@@ -428,13 +428,13 @@ installation authority or the caller's own grants.
428
428
 
429
429
  #### Parameters
430
430
 
431
- | Parameter | Type |
432
- | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
433
- | `host` | `Pick`\<[`OysterHost`](host.md#oysterhost), \| `"installations"` \| `"instances"` \| `"artifacts"` \| `"guestLimits"` \| `"backgroundOriginKey"` \| `"computerId"` \| `"capabilities"` \| `"appToolPolicy"` \| `"keys"` \| `"approvals"`\> |
434
- | `principal` | [`TenantPrincipal`](tenant.md#tenantprincipal) |
435
- | `access` | [`OysterCallerAccess`](#oystercalleraccess) |
436
- | `surfaces` | [`AppSurfaceCache`](#appsurfacecache) |
437
- | `preloadedInstallations?` | readonly `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.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`\<...\>[]; \}\>[]; `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"`; \}\>[] |
431
+ | Parameter | Type |
432
+ | ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
433
+ | `host` | `Pick`\<[`OysterHost`](host.md#oysterhost), \| `"installations"` \| `"instances"` \| `"artifacts"` \| `"guestLimits"` \| `"backgroundOriginKey"` \| `"computerId"` \| `"capabilities"` \| `"appToolPolicy"` \| `"keys"` \| `"approvals"`\> |
434
+ | `principal` | [`TenantPrincipal`](tenant.md#tenantprincipal) |
435
+ | `access` | [`OysterCallerAccess`](#oystercalleraccess) |
436
+ | `surfaces` | [`AppSurfaceCache`](#appsurfacecache) |
437
+ | `preloadedInstallations?` | readonly `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`\<...\>[]; \}\>[]; `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"`; \}\>[] |
438
438
 
439
439
  #### Returns
440
440
 
@@ -16,6 +16,7 @@
16
16
  | [apps](apps.md) | - |
17
17
  | [auth](auth.md) | - |
18
18
  | [authorization](authorization.md) | - |
19
+ | [browser/boot-once](browser/boot-once.md) | - |
19
20
  | [browser/boot](browser/boot.md) | - |
20
21
  | [browser](browser.md) | - |
21
22
  | [build-contract](build-contract.md) | - |