@fungi.computer/oyster 0.8.2 → 0.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +21 -17
- package/dist/agents.js +3 -0
- 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/build/candidate-cli.mjs +1 -0
- package/dist/host.js +11 -4
- package/dist/installation-client.d.ts +6 -5
- package/dist/installation-client.js +21 -17
- package/dist/installation-execution.js +41 -8
- package/dist/installation-operations.d.ts +30 -8
- package/dist/installation-operations.js +122 -24
- package/dist/instance-refusal.d.ts +4 -2
- package/dist/instance-refusal.js +5 -1
- package/dist/mcp.d.ts +4 -2
- package/dist/page/mount.d.ts +8 -1
- package/dist/page/mount.js +72 -6
- package/dist/page-script.js +3 -3
- package/dist/standalone/app-set.js +6 -7
- package/dist/standalone/computer-fleet.d.ts +8 -2
- package/dist/standalone/computer-fleet.js +21 -17
- package/dist/standalone/registry.js +9 -0
- package/dist/standalone/workflow-host.d.ts +5 -5
- package/dist/standalone/workflow-trigger-host.d.ts +1 -1
- package/docs/api/apps.md +31 -31
- package/docs/api/host.md +157 -0
- package/docs/api/mcp.md +6 -4
- package/docs/api/page/mount.md +6 -1
- package/docs/api/workers.md +3 -3
- package/docs/site/agent-quickstart.mdx +4 -2
- package/package.json +16 -16
package/docs/api/host.md
CHANGED
|
@@ -811,6 +811,163 @@ type InstallationOperations = Readonly<{
|
|
|
811
811
|
state: "pending";
|
|
812
812
|
}
|
|
813
813
|
| null>;
|
|
814
|
+
awaitSettled: Promise<
|
|
815
|
+
| {
|
|
816
|
+
requestId: string;
|
|
817
|
+
requestedInstallationId: string;
|
|
818
|
+
installationId: string;
|
|
819
|
+
release: {
|
|
820
|
+
releaseId: Schema.refine<ReleaseId, Schema.String>;
|
|
821
|
+
appId: Schema.refine<AppId, Schema.String>;
|
|
822
|
+
artifact: Schema.Struct<{
|
|
823
|
+
artifactRef: Schema.refine<ArtifactRef, Schema.String>;
|
|
824
|
+
artifactDigest: Schema.refine<Sha256Digest, Schema.String>;
|
|
825
|
+
provenance: Schema.Struct<{
|
|
826
|
+
sourceRevision: Schema.refine<..., ...>;
|
|
827
|
+
sourceTreeDigest: Schema.refine<..., ...>;
|
|
828
|
+
buildRecipeDigest: Schema.refine<..., ...>;
|
|
829
|
+
}>;
|
|
830
|
+
}>;
|
|
831
|
+
};
|
|
832
|
+
state: "refused";
|
|
833
|
+
status: number;
|
|
834
|
+
code: string;
|
|
835
|
+
}
|
|
836
|
+
| {
|
|
837
|
+
requestId: string;
|
|
838
|
+
requestedInstallationId: string;
|
|
839
|
+
installationId: string;
|
|
840
|
+
release: {
|
|
841
|
+
releaseId: Schema.refine<ReleaseId, Schema.String>;
|
|
842
|
+
appId: Schema.refine<AppId, Schema.String>;
|
|
843
|
+
artifact: Schema.Struct<{
|
|
844
|
+
artifactRef: Schema.refine<ArtifactRef, Schema.String>;
|
|
845
|
+
artifactDigest: Schema.refine<Sha256Digest, Schema.String>;
|
|
846
|
+
provenance: Schema.Struct<{
|
|
847
|
+
sourceRevision: Schema.refine<..., ...>;
|
|
848
|
+
sourceTreeDigest: Schema.refine<..., ...>;
|
|
849
|
+
buildRecipeDigest: Schema.refine<..., ...>;
|
|
850
|
+
}>;
|
|
851
|
+
}>;
|
|
852
|
+
};
|
|
853
|
+
state: "unconfirmed";
|
|
854
|
+
outcome: "cancelled" | "outcome_unknown" | "interrupted";
|
|
855
|
+
}
|
|
856
|
+
| {
|
|
857
|
+
requestId: string;
|
|
858
|
+
requestedInstallationId: string;
|
|
859
|
+
installationId: string;
|
|
860
|
+
release: {
|
|
861
|
+
releaseId: Schema.refine<ReleaseId, Schema.String>;
|
|
862
|
+
appId: Schema.refine<AppId, Schema.String>;
|
|
863
|
+
artifact: Schema.Struct<{
|
|
864
|
+
artifactRef: Schema.refine<ArtifactRef, Schema.String>;
|
|
865
|
+
artifactDigest: Schema.refine<Sha256Digest, Schema.String>;
|
|
866
|
+
provenance: Schema.Struct<{
|
|
867
|
+
sourceRevision: Schema.refine<..., ...>;
|
|
868
|
+
sourceTreeDigest: Schema.refine<..., ...>;
|
|
869
|
+
buildRecipeDigest: Schema.refine<..., ...>;
|
|
870
|
+
}>;
|
|
871
|
+
}>;
|
|
872
|
+
};
|
|
873
|
+
state: "succeeded";
|
|
874
|
+
reference: {
|
|
875
|
+
generation: string;
|
|
876
|
+
instanceId: InstanceId;
|
|
877
|
+
authorityVersion: number;
|
|
878
|
+
status: "enabled" | "disabled" | "deleted";
|
|
879
|
+
};
|
|
880
|
+
creation: "fresh" | "replacement" | "reminted";
|
|
881
|
+
uiCheck: | {
|
|
882
|
+
kind: "passed";
|
|
883
|
+
}
|
|
884
|
+
| {
|
|
885
|
+
kind: "failed";
|
|
886
|
+
code: "ui_mount_failed";
|
|
887
|
+
diagnostics?: {
|
|
888
|
+
failedPredicate: | "unexpected_candidate_request"
|
|
889
|
+
| "response_status"
|
|
890
|
+
| "request_failed"
|
|
891
|
+
| "page_error"
|
|
892
|
+
| "candidate_not_mounted";
|
|
893
|
+
errorName?: | "Error"
|
|
894
|
+
| "TypeError"
|
|
895
|
+
| "RangeError"
|
|
896
|
+
| "SyntaxError"
|
|
897
|
+
| "AbortError"
|
|
898
|
+
| "TimeoutError"
|
|
899
|
+
| "Other";
|
|
900
|
+
finalUrlPath: string;
|
|
901
|
+
consoleErrors: string[];
|
|
902
|
+
pageErrors: string[];
|
|
903
|
+
failedRequests: object[];
|
|
904
|
+
droppedCount: number;
|
|
905
|
+
};
|
|
906
|
+
}
|
|
907
|
+
| {
|
|
908
|
+
kind: "not_checked";
|
|
909
|
+
code: | "boot_runner_unavailable"
|
|
910
|
+
| "boot_browser_binding_missing"
|
|
911
|
+
| "boot_clone_unavailable"
|
|
912
|
+
| "boot_timeout"
|
|
913
|
+
| "boot_cleanup_failed"
|
|
914
|
+
| "ui_check_not_run_on_host";
|
|
915
|
+
}
|
|
916
|
+
| null;
|
|
917
|
+
installation: | {
|
|
918
|
+
installationId: string;
|
|
919
|
+
instanceId: InstanceId | null;
|
|
920
|
+
appId: AppId;
|
|
921
|
+
release: {
|
|
922
|
+
releaseId: Schema.refine<ReleaseId, Schema.String>;
|
|
923
|
+
appId: Schema.refine<AppId, Schema.String>;
|
|
924
|
+
artifact: Schema.Struct<{
|
|
925
|
+
artifactRef: Schema.refine<..., ...>;
|
|
926
|
+
artifactDigest: Schema.refine<..., ...>;
|
|
927
|
+
provenance: Schema.Struct<...>;
|
|
928
|
+
}>;
|
|
929
|
+
};
|
|
930
|
+
releasePin: "pinned" | "floating";
|
|
931
|
+
authority: {
|
|
932
|
+
authorityVersion: number;
|
|
933
|
+
declaredOperationsDigest: Sha256Digest;
|
|
934
|
+
approvedGrants: readonly Readonly<{
|
|
935
|
+
capability: ...;
|
|
936
|
+
capabilityApproved: ...;
|
|
937
|
+
operations: ...;
|
|
938
|
+
resources: ...;
|
|
939
|
+
}>[];
|
|
940
|
+
approval: | Readonly<{
|
|
941
|
+
by: ...;
|
|
942
|
+
at: ...;
|
|
943
|
+
authorityVersion: ...;
|
|
944
|
+
}>
|
|
945
|
+
| null;
|
|
946
|
+
};
|
|
947
|
+
status: "enabled" | "disabled" | "deleted";
|
|
948
|
+
}
|
|
949
|
+
| null;
|
|
950
|
+
}
|
|
951
|
+
| {
|
|
952
|
+
requestId: string;
|
|
953
|
+
requestedInstallationId: string;
|
|
954
|
+
installationId: string;
|
|
955
|
+
release: {
|
|
956
|
+
releaseId: Schema.refine<ReleaseId, Schema.String>;
|
|
957
|
+
appId: Schema.refine<AppId, Schema.String>;
|
|
958
|
+
artifact: Schema.Struct<{
|
|
959
|
+
artifactRef: Schema.refine<ArtifactRef, Schema.String>;
|
|
960
|
+
artifactDigest: Schema.refine<Sha256Digest, Schema.String>;
|
|
961
|
+
provenance: Schema.Struct<{
|
|
962
|
+
sourceRevision: Schema.refine<..., ...>;
|
|
963
|
+
sourceTreeDigest: Schema.refine<..., ...>;
|
|
964
|
+
buildRecipeDigest: Schema.refine<..., ...>;
|
|
965
|
+
}>;
|
|
966
|
+
}>;
|
|
967
|
+
};
|
|
968
|
+
state: "pending";
|
|
969
|
+
}
|
|
970
|
+
| null>;
|
|
814
971
|
load: Promise<
|
|
815
972
|
| {
|
|
816
973
|
admission: {
|
package/docs/api/mcp.md
CHANGED
|
@@ -91,6 +91,7 @@ type ComputerControlPort = Readonly<{
|
|
|
91
91
|
running: "running";
|
|
92
92
|
sleeping: "sleeping";
|
|
93
93
|
starting: "starting";
|
|
94
|
+
start_failed: "start_failed";
|
|
94
95
|
}>;
|
|
95
96
|
}
|
|
96
97
|
| {
|
|
@@ -104,6 +105,7 @@ type ComputerControlPort = Readonly<{
|
|
|
104
105
|
running: "running";
|
|
105
106
|
sleeping: "sleeping";
|
|
106
107
|
starting: "starting";
|
|
108
|
+
start_failed: "start_failed";
|
|
107
109
|
}>;
|
|
108
110
|
}
|
|
109
111
|
| {
|
|
@@ -249,14 +251,14 @@ One set of schemas and operations for MCP and direct broker invocation.
|
|
|
249
251
|
| `state.access` | `"read"` | - | - |
|
|
250
252
|
| `state.description` | `string` | `"Read runtime state without waking a Computer, including its live admission queue position."` | - |
|
|
251
253
|
| `state.input` | `ZodObject`\<\{ `computerId`: `ZodString`; \}, `$strict`\> | `fleetComputerId` | - |
|
|
252
|
-
| `state.output` | `ZodDiscriminatedUnion`\<\[`ZodObject`\<\{ `state`: `ZodEnum`\<\{ `running`: `"running"`; `sleeping`: `"sleeping"`; `starting`: `"starting"`; \}\>; \}, `$strict`\>, `ZodObject`\<\{ `state`: `ZodLiteral`\<`"queued"`\>; `position`: `ZodNumber`; \}, `$strict`\>\], `"state"`\>
|
|
253
|
-
| `state.execute()` | (`input`, `context`) => `Promise`\< \| \{ `state`: `"running"` \| `"sleeping"` \| `"starting"`; \} \| \{ `state`: `"queued"`; `position`: `number`; \}\>
|
|
254
|
+
| `state.output` | `ZodDiscriminatedUnion`\<\[`ZodObject`\<\{ `state`: `ZodEnum`\<\{ `running`: `"running"`; `sleeping`: `"sleeping"`; `starting`: `"starting"`; `start_failed`: `"start_failed"`; \}\>; \}, `$strict`\>, `ZodObject`\<\{ `state`: `ZodLiteral`\<`"queued"`\>; `position`: `ZodNumber`; \}, `$strict`\>\], `"state"`\> | `computerStateSchema` | - |
|
|
255
|
+
| `state.execute()` | (`input`, `context`) => `Promise`\< \| \{ `state`: `"running"` \| `"sleeping"` \| `"starting"` \| `"start_failed"`; \} \| \{ `state`: `"queued"`; `position`: `number`; \}\> | - | Return liveness without waking the runtime. |
|
|
254
256
|
| `start` | `object` | - | - |
|
|
255
257
|
| `start.replay` | `"unsafe"` | - | - |
|
|
256
258
|
| `start.description` | `string` | `"Start a hosted Computer through ordinary admission. Waits until connected; poll computers.state while queued. Safe to retry."` | - |
|
|
257
259
|
| `start.input` | `ZodObject`\<\{ `computerId`: `ZodString`; \}, `$strict`\> | `fleetComputerId` | - |
|
|
258
|
-
| `start.output` | `ZodDiscriminatedUnion`\<\[`ZodObject`\<\{ `state`: `ZodEnum`\<\{ `running`: `"running"`; `sleeping`: `"sleeping"`; `starting`: `"starting"`; \}\>; \}, `$strict`\>, `ZodObject`\<\{ `state`: `ZodLiteral`\<`"queued"`\>; `position`: `ZodNumber`; \}, `$strict`\>\], `"state"`\>
|
|
259
|
-
| `start.execute()` | (`input`, `context`) => `Promise`\< \| \{ `state`: `"running"` \| `"sleeping"` \| `"starting"`; \} \| \{ `state`: `"queued"`; `position`: `number`; \}\>
|
|
260
|
+
| `start.output` | `ZodDiscriminatedUnion`\<\[`ZodObject`\<\{ `state`: `ZodEnum`\<\{ `running`: `"running"`; `sleeping`: `"sleeping"`; `starting`: `"starting"`; `start_failed`: `"start_failed"`; \}\>; \}, `$strict`\>, `ZodObject`\<\{ `state`: `ZodLiteral`\<`"queued"`\>; `position`: `ZodNumber`; \}, `$strict`\>\], `"state"`\> | `computerStateSchema` | - |
|
|
261
|
+
| `start.execute()` | (`input`, `context`) => `Promise`\< \| \{ `state`: `"running"` \| `"sleeping"` \| `"starting"` \| `"start_failed"`; \} \| \{ `state`: `"queued"`; `position`: `number`; \}\> | - | Admit and start this Computer. |
|
|
260
262
|
| `create` | `object` | - | - |
|
|
261
263
|
| `create.replay` | `"unsafe"` | - | - |
|
|
262
264
|
| `create.description` | `string` | `"Create a Computer with an optional friendly name. Request identity is generated automatically. If the outcome is uncertain, retry with its returned requestId and the original name input; do not start a second creation."` | - |
|
package/docs/api/page/mount.md
CHANGED
|
@@ -330,7 +330,12 @@ Desktop chrome (menus, palette, status) belongs to the trusted shell.
|
|
|
330
330
|
function connectOysterApp(options): Promise<AppHost>;
|
|
331
331
|
```
|
|
332
332
|
|
|
333
|
-
Connect a child or home App using the same admitted Oyster slot handles.
|
|
333
|
+
Connect a child or home App using the same admitted Oyster slot handles. The
|
|
334
|
+
host navigates the App's frame (`config.uiUrl`) only once it listens for the
|
|
335
|
+
App's ready signal, so slow capability resolution on a cold Oyster can never
|
|
336
|
+
outlast that signal. Opening is bounded: the capabilities and the document get
|
|
337
|
+
the shared cold-document budget, and the handshake after the document loads gets
|
|
338
|
+
the App's own ready window.
|
|
334
339
|
|
|
335
340
|
#### Parameters
|
|
336
341
|
|
package/docs/api/workers.md
CHANGED
|
@@ -840,9 +840,9 @@ command for the caller's tenant scope.
|
|
|
840
840
|
|
|
841
841
|
###### Parameters
|
|
842
842
|
|
|
843
|
-
| Parameter | Type
|
|
844
|
-
| --------- |
|
|
845
|
-
| `input` | \| \{ `action`: `"admit"`; `scope`: \{ `tenantId`: `string` & `Brand`\<`"OysterTenantId"`\>; `origin`: `string`; \}; `input`: \{ `requestId`: `string`; `installationId`: `string`; `release`: \{ `releaseId`: `ReleaseId`; `appId`: `AppId`; `artifact`: \{ `artifactRef`: `ArtifactRef`; `artifactDigest`: `Sha256Digest`; `provenance`: \{ `sourceRevision`: `SourceRevision`; `sourceTreeDigest`: `Sha256Digest`; `buildRecipeDigest`: `Sha256Digest`; \}; \}; \}; `actor`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `intent`: `"install-or-select"` \| `"install-or-remint"` \| `"create-only"`; `origin`: `"workflow"` \| `"owner-direct"`; \}; \} \| \{ `action`: `"read"`; `scope`: \{ `tenantId`: `string` & `Brand`\<`"OysterTenantId"`\>; `origin`: `string`; \}; `requestId`: `string`; `installationId`: `string`; \} \| \{ `action`: `"load"`; `scope`: \{ `tenantId`: `string` & `Brand`\<`"OysterTenantId"`\>; `origin`: `string`; \}; `requestId`: `string`; \} \| \{ `action`: `"plan"`; `scope`: \{ `tenantId`: `string` & `Brand`\<`"OysterTenantId"`\>; `origin`: `string`; \}; `requestId`: `string`; `installation`: \{ `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"` \| `"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"`; \}; `hasBackend`: `boolean`; \} \| \{ `action`: `"commit"`; `scope`: \{ `tenantId`: `string` & `Brand`\<`"OysterTenantId"`\>; `origin`: `string`; \}; `requestId`: `string`; `uiCheck`: \| \{ `kind`: `"passed"`; \} \| \{ `kind`: `"failed"`; `code`: `"ui_mount_failed"`; `diagnostics?`: \{ `failedPredicate`: \| `"unexpected_candidate_request"` \| `"response_status"` \| `"request_failed"` \| `"page_error"` \| `"candidate_not_mounted"`; `errorName?`: \| `"Error"` \| `"TypeError"` \| `"RangeError"` \| `"SyntaxError"` \| `"AbortError"` \| `"TimeoutError"` \| `"Other"`; `finalUrlPath`: `string`; `consoleErrors`: `string`[]; `pageErrors`: `string`[]; `failedRequests`: `object`[]; `droppedCount`: `number`; \}; \} \| \{ `kind`: `"not_checked"`; `code`: \| `"boot_runner_unavailable"` \| `"boot_browser_binding_missing"` \| `"boot_clone_unavailable"` \| `"boot_timeout"` \| `"boot_cleanup_failed"` \| `"ui_check_not_run_on_host"`; \} \| `null`; \} |
|
|
843
|
+
| Parameter | Type |
|
|
844
|
+
| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
845
|
+
| `input` | \| \{ `action`: `"admit"`; `scope`: \{ `tenantId`: `string` & `Brand`\<`"OysterTenantId"`\>; `origin`: `string`; \}; `input`: \{ `requestId`: `string`; `installationId`: `string`; `release`: \{ `releaseId`: `ReleaseId`; `appId`: `AppId`; `artifact`: \{ `artifactRef`: `ArtifactRef`; `artifactDigest`: `Sha256Digest`; `provenance`: \{ `sourceRevision`: `SourceRevision`; `sourceTreeDigest`: `Sha256Digest`; `buildRecipeDigest`: `Sha256Digest`; \}; \}; \}; `actor`: \| \{ `kind`: `"member"`; `memberId`: `string`; \} \| \{ `kind`: `"agent"`; `agentId`: `string`; \} \| \{ `kind`: `"team-key"`; `keyId`: `string`; \}; `intent`: `"install-or-select"` \| `"install-or-remint"` \| `"create-only"`; `origin`: `"workflow"` \| `"owner-direct"`; \}; \} \| \{ `action`: `"read"`; `scope`: \{ `tenantId`: `string` & `Brand`\<`"OysterTenantId"`\>; `origin`: `string`; \}; `requestId`: `string`; `installationId`: `string`; \} \| \{ `action`: `"await"`; `scope`: \{ `tenantId`: `string` & `Brand`\<`"OysterTenantId"`\>; `origin`: `string`; \}; `requestId`: `string`; `installationId`: `string`; `waitMs`: `number`; \} \| \{ `action`: `"load"`; `scope`: \{ `tenantId`: `string` & `Brand`\<`"OysterTenantId"`\>; `origin`: `string`; \}; `requestId`: `string`; \} \| \{ `action`: `"plan"`; `scope`: \{ `tenantId`: `string` & `Brand`\<`"OysterTenantId"`\>; `origin`: `string`; \}; `requestId`: `string`; `installation`: \{ `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"` \| `"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"`; \}; `hasBackend`: `boolean`; \} \| \{ `action`: `"commit"`; `scope`: \{ `tenantId`: `string` & `Brand`\<`"OysterTenantId"`\>; `origin`: `string`; \}; `requestId`: `string`; `uiCheck`: \| \{ `kind`: `"passed"`; \} \| \{ `kind`: `"failed"`; `code`: `"ui_mount_failed"`; `diagnostics?`: \{ `failedPredicate`: \| `"unexpected_candidate_request"` \| `"response_status"` \| `"request_failed"` \| `"page_error"` \| `"candidate_not_mounted"`; `errorName?`: \| `"Error"` \| `"TypeError"` \| `"RangeError"` \| `"SyntaxError"` \| `"AbortError"` \| `"TimeoutError"` \| `"Other"`; `finalUrlPath`: `string`; `consoleErrors`: `string`[]; `pageErrors`: `string`[]; `failedRequests`: `object`[]; `droppedCount`: `number`; \}; \} \| \{ `kind`: `"not_checked"`; `code`: \| `"boot_runner_unavailable"` \| `"boot_browser_binding_missing"` \| `"boot_clone_unavailable"` \| `"boot_timeout"` \| `"boot_cleanup_failed"` \| `"ui_check_not_run_on_host"`; \} \| `null`; \} |
|
|
846
846
|
|
|
847
847
|
###### Returns
|
|
848
848
|
|
|
@@ -108,6 +108,10 @@ If it fails:
|
|
|
108
108
|
running `pnpm add`. If it names a new dependency not listed there, stop and
|
|
109
109
|
review that package before allowing its scripts; do not treat exit 1 as
|
|
110
110
|
success.
|
|
111
|
+
- `ERR_PNPM_UNEXPECTED_STORE`: this directory was installed from a different
|
|
112
|
+
pnpm store than your current default. Run the same `pnpm add` again with
|
|
113
|
+
`--store-dir` set to the store the error says the dependencies are linked
|
|
114
|
+
from; do not delete `node_modules` to get past it.
|
|
111
115
|
- `cp: cannot stat …/examples/standalone/…`: the install did not finish. Run
|
|
112
116
|
`pnpm add @fungi.computer/oyster @fungi.computer/computer react@^19.2.0 react-dom@^19.2.0`
|
|
113
117
|
again and read its first error.
|
|
@@ -380,8 +384,6 @@ If it fails:
|
|
|
380
384
|
|
|
381
385
|
- The Oyster README (`node_modules/@fungi.computer/oyster/README.md`) explains
|
|
382
386
|
the host, Apps, capabilities, MCP and the shell in depth.
|
|
383
|
-
- [oyster.shiit.app](https://oyster.shiit.app/) runs this same host with the
|
|
384
|
-
seven starter Apps.
|
|
385
387
|
- Oyster is built from the other Fungi packages, each its own repository under
|
|
386
388
|
[github.com/fungi-computer](https://github.com/fungi-computer) and on npm as
|
|
387
389
|
`@fungi.computer/<name>`. The README's "Part of Fungi" section lists them.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@fungi.computer/oyster",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.9.0",
|
|
4
4
|
"author": "Levi <levi@technomancy.dev>",
|
|
5
5
|
"description": "Run your own Apps on Cloudflare Workers or celld: installable App Releases, each with its own Durable Object, SQLite database and declared bindings",
|
|
6
6
|
"type": "module",
|
|
@@ -308,35 +308,35 @@
|
|
|
308
308
|
"dependencies": {
|
|
309
309
|
"@cfworker/json-schema": "4.1.1",
|
|
310
310
|
"@earendil-works/pi-ai": "1.3.0",
|
|
311
|
-
"@fungi.computer/agar": "0.
|
|
311
|
+
"@fungi.computer/agar": "0.7.0",
|
|
312
312
|
"@fungi.computer/bird-dog": "0.3.1",
|
|
313
|
-
"@fungi.computer/braid": "0.4.
|
|
313
|
+
"@fungi.computer/braid": "0.4.2",
|
|
314
314
|
"@fungi.computer/burrow": "0.2.0",
|
|
315
315
|
"@fungi.computer/cairn": "0.1.0",
|
|
316
316
|
"@fungi.computer/capnweb": "0.12.0",
|
|
317
|
-
"@fungi.computer/caps": "0.
|
|
317
|
+
"@fungi.computer/caps": "0.7.0",
|
|
318
318
|
"@fungi.computer/carrier": "0.2.0",
|
|
319
|
-
"@fungi.computer/computer": "0.
|
|
320
|
-
"@fungi.computer/computer-contract": "0.0.
|
|
321
|
-
"@fungi.computer/darkroom": "0.
|
|
319
|
+
"@fungi.computer/computer": "0.5.0",
|
|
320
|
+
"@fungi.computer/computer-contract": "0.0.9",
|
|
321
|
+
"@fungi.computer/darkroom": "0.5.0",
|
|
322
322
|
"@fungi.computer/ear-tag": "0.1.0",
|
|
323
|
-
"@fungi.computer/forage": "0.
|
|
323
|
+
"@fungi.computer/forage": "0.3.0",
|
|
324
324
|
"@fungi.computer/gills": "0.2.0",
|
|
325
|
-
"@fungi.computer/knapsack": "0.4.
|
|
326
|
-
"@fungi.computer/mycelium": "0.3.
|
|
327
|
-
"@fungi.computer/nacre": "0.1.
|
|
328
|
-
"@fungi.computer/puffball": "0.
|
|
325
|
+
"@fungi.computer/knapsack": "0.4.4",
|
|
326
|
+
"@fungi.computer/mycelium": "0.3.3",
|
|
327
|
+
"@fungi.computer/nacre": "0.1.3",
|
|
328
|
+
"@fungi.computer/puffball": "0.5.0",
|
|
329
329
|
"@fungi.computer/seam": "0.2.0",
|
|
330
|
-
"@fungi.computer/shiitake": "0.9.
|
|
331
|
-
"@fungi.computer/shiitake-extensions": "0.6.
|
|
330
|
+
"@fungi.computer/shiitake": "0.9.1",
|
|
331
|
+
"@fungi.computer/shiitake-extensions": "0.6.2",
|
|
332
332
|
"@fungi.computer/sigils": "0.3.0",
|
|
333
333
|
"@fungi.computer/sprite": "0.2.0",
|
|
334
334
|
"@fungi.computer/sprite-zdog": "0.3.0",
|
|
335
335
|
"@fungi.computer/veil": "0.3.0",
|
|
336
336
|
"@fungi.computer/watchdog": "0.1.0",
|
|
337
337
|
"@fungi.computer/whistle": "0.3.0",
|
|
338
|
-
"@fungi.computer/workflows-wire": "0.4.
|
|
339
|
-
"@fungi.computer/zookeeper": "0.0.
|
|
338
|
+
"@fungi.computer/workflows-wire": "0.4.2",
|
|
339
|
+
"@fungi.computer/zookeeper": "0.0.9",
|
|
340
340
|
"@modelcontextprotocol/server": "2.0.0",
|
|
341
341
|
"@pnpm/lockfile.fs": "1100.2.13",
|
|
342
342
|
"@pnpm/lockfile.pruner": "1100.0.27",
|