@fungi.computer/oyster 0.24.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.
- package/dist/agent-instructions.d.ts +35 -0
- package/dist/agent-instructions.js +42 -0
- package/dist/agents.d.ts +14 -0
- package/dist/agents.js +43 -1
- package/dist/apps/catalog.d.ts +11 -0
- package/dist/apps/catalog.js +1 -0
- package/dist/apps/gate.d.ts +2 -2
- package/dist/apps/installation.d.ts +7 -7
- package/dist/apps/permissions.d.ts +5 -5
- package/dist/boot-host-script.js +1 -1
- package/dist/browser/boot-once.d.ts +84 -0
- package/dist/browser/boot-once.js +48 -0
- package/dist/build/candidate-cli.mjs +6 -0
- package/dist/embed-metafiles.js +2 -2
- package/dist/embed-scripts.js +1 -1
- package/dist/installation-operations.d.ts +8 -8
- package/dist/page-script.js +2 -2
- package/dist/standalone/agents.d.ts +6 -0
- package/dist/standalone/agents.js +35 -2
- package/dist/standalone/computer.d.ts +3 -3
- package/dist/standalone/computer.js +34 -1
- package/dist/standalone/workflow-host.d.ts +5 -5
- package/dist/standalone/workflow-trigger-host.d.ts +1 -1
- package/docs/api/agents.md +18 -0
- package/docs/api/apps.md +148 -131
- package/docs/api/browser/boot-once.md +169 -0
- package/docs/api/build-contract.md +27 -21
- package/docs/api/build.md +70 -69
- package/docs/api/git.md +3 -3
- package/docs/api/host.md +91 -85
- package/docs/api/mcp.md +16 -16
- package/docs/api/modules.md +1 -0
- package/docs/api/workers-git.md +7 -7
- package/docs/api/workers.md +24 -21
- 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.
|
|
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
|
-
|
|
2019
|
-
`
|
|
2020
|
-
`
|
|
2021
|
-
`
|
|
2022
|
-
`
|
|
2023
|
-
`"
|
|
2024
|
-
\| `"
|
|
2025
|
-
`"
|
|
2026
|
-
`"
|
|
2027
|
-
`"
|
|
2028
|
-
`"
|
|
2029
|
-
`"
|
|
2030
|
-
`
|
|
2031
|
-
|
|
2032
|
-
`
|
|
2033
|
-
`
|
|
2034
|
-
`
|
|
2035
|
-
`
|
|
2036
|
-
`
|
|
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.
|
|
2052
|
-
\| `"agent.
|
|
2053
|
-
`"media.
|
|
2054
|
-
`"apps.
|
|
2055
|
-
`"
|
|
2056
|
-
`"
|
|
2057
|
-
`"
|
|
2058
|
-
`Readonly`\<\{ `appId`:
|
|
2059
|
-
`
|
|
2060
|
-
readonly `"
|
|
2061
|
-
`
|
|
2062
|
-
`
|
|
2063
|
-
`
|
|
2064
|
-
`
|
|
2065
|
-
`
|
|
2066
|
-
`
|
|
2067
|
-
|
|
2068
|
-
`
|
|
2069
|
-
`Readonly`\<...\>; \}\>; \}\>
|
|
2070
|
-
`
|
|
2071
|
-
`
|
|
2072
|
-
`
|
|
2073
|
-
|
|
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.
|
|
2182
|
-
`"
|
|
2183
|
-
`"
|
|
2184
|
-
`"
|
|
2185
|
-
`"
|
|
2186
|
-
`"workflow.
|
|
2187
|
-
`"channels.personal.manage"`)[]; `calls?`: readonly
|
|
2188
|
-
`methods`: ...; \}\>[]; `guidance?`: `string`;
|
|
2189
|
-
`"file.open"`[]; `receives?`: readonly `"git.push"`[];
|
|
2190
|
-
`roles`: readonly (`"files"` \| `"dashboard"` \| `"inbox"` \|
|
|
2191
|
-
`"sessions"` \| `"terminal"`)[]; `storage?`: readonly
|
|
2192
|
-
`scopes`: ...; `maxBytes`: ...; \}\>[]; `commands?`:
|
|
2193
|
-
`id`: ...; `title`: ...; `category`: ...;
|
|
2194
|
-
`projections?`: ...; \}\>[]; `gills?`:
|
|
2195
|
-
`
|
|
2196
|
-
\}\>[]; `backend?`: `Readonly`\<\{ `bindings`:
|
|
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
|
|
package/docs/api/modules.md
CHANGED
|
@@ -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) | - |
|