@fungi.computer/oyster 0.14.1 → 0.16.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 +178 -1552
- package/dist/agents.d.ts +8 -0
- package/dist/agents.js +6 -0
- package/dist/app-builds.d.ts +5 -6
- package/dist/app-builds.js +3 -10
- package/dist/apps/permissions.js +8 -1
- package/dist/auth.d.ts +2 -0
- package/dist/auth.js +9 -8
- package/dist/boot-host-script.js +1 -1
- package/dist/build/candidate-cli.mjs +4 -0
- package/dist/catalog-frame.d.ts +0 -1
- package/dist/computer.d.ts +5 -0
- package/dist/computer.js +1 -0
- package/dist/embed-metafiles.js +2 -2
- package/dist/embed-scripts.js +3 -3
- package/dist/hello-app-script.js +1 -1
- package/dist/host-page-assets.js +1 -1
- package/dist/host-page.d.ts +5 -1
- package/dist/host-page.js +23 -23
- package/dist/host.js +6 -1
- package/dist/page/app-access.js +23 -1
- package/dist/page/app-permissions.js +165 -50
- package/dist/page/app-rights.d.ts +8 -0
- package/dist/page/app-rights.js +13 -0
- package/dist/page/computer-handles.d.ts +15 -0
- package/dist/page/computer-handles.js +4 -1
- package/dist/page/mount.d.ts +5 -0
- package/dist/page/mount.js +4 -0
- package/dist/page-script.js +3 -3
- package/dist/standalone/agents.js +10 -0
- package/dist/standalone/app-set.d.ts +9 -0
- package/dist/standalone/app-set.js +43 -0
- package/dist/standalone/app-source.js +16 -1
- package/dist/standalone/builds.d.ts +2 -2
- package/dist/standalone/builds.js +4 -0
- package/dist/standalone/cloudflare-account.d.ts +10 -0
- package/dist/standalone/cloudflare-account.js +17 -0
- package/dist/standalone/computer.d.ts +8 -3
- package/dist/standalone/computer.js +26 -3
- package/dist/standalone/install-apps-cli.js +1 -1
- package/dist/standalone/local-desktop.d.ts +19 -2
- package/dist/standalone/local-desktop.js +38 -15
- package/dist/standalone/media.d.ts +2 -0
- package/dist/standalone/media.js +17 -1
- package/dist/standalone/registry.d.ts +4 -1
- package/dist/standalone/registry.js +6 -0
- package/dist/standalone/sign-in-link.d.ts +1 -1
- package/dist/standalone/sign-in-link.js +9 -18
- package/dist/standalone/try-cli.d.ts +7 -0
- package/dist/standalone/try-cli.js +88 -8
- package/dist/starter-agent.d.ts +59 -0
- package/dist/starter-agent.js +85 -0
- package/docs/api/README.md +744 -88
- package/docs/api/agents.md +6 -0
- package/docs/api/auth.md +10 -0
- package/docs/api/computer.md +4 -0
- package/docs/api/page/mount.md +2 -0
- package/docs/api/workers-git.md +14 -9
- package/docs/api/workers.md +8 -3
- package/docs/site/agent-quickstart.mdx +1 -1
- package/package.json +34 -50
package/docs/api/agents.md
CHANGED
|
@@ -323,6 +323,12 @@ type OysterAgents = Readonly<{
|
|
|
323
323
|
error: "not_found" | "revision_conflict" | "not_granted";
|
|
324
324
|
}>
|
|
325
325
|
>;
|
|
326
|
+
setup: Promise<
|
|
327
|
+
Readonly<{
|
|
328
|
+
models: "ready" | "missing";
|
|
329
|
+
media: "ready" | "missing";
|
|
330
|
+
}>
|
|
331
|
+
>;
|
|
326
332
|
modelKeys: Promise<
|
|
327
333
|
readonly Readonly<{
|
|
328
334
|
keyId: string;
|
package/docs/api/auth.md
CHANGED
|
@@ -18,6 +18,16 @@ const ownerKeyCookieName: "oyster_session" = "oyster_session";
|
|
|
18
18
|
|
|
19
19
|
Cookie emitted by ownerKeyAuth, for composing credential-specific adapters.
|
|
20
20
|
|
|
21
|
+
---
|
|
22
|
+
|
|
23
|
+
### returningCookieName
|
|
24
|
+
|
|
25
|
+
```ts
|
|
26
|
+
const returningCookieName: "oyster_returning" = "oyster_returning";
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
Marks a browser that has signed in here before; it carries no authority.
|
|
30
|
+
|
|
21
31
|
## Functions
|
|
22
32
|
|
|
23
33
|
### ownerKeyAuth()
|
package/docs/api/computer.md
CHANGED
|
@@ -192,6 +192,10 @@ Computer routes supplied by the host; execution stays in the Computer runtime.
|
|
|
192
192
|
| `processes.methods.kill.kind` | `"json"` | `"json"` |
|
|
193
193
|
| `processes.methods.kill.method` | `"POST"` | `"POST"` |
|
|
194
194
|
| `processes.methods.kill.path` | `"processes/kill"` | `"processes/kill"` |
|
|
195
|
+
| `processes.methods.logs` | `object` | - |
|
|
196
|
+
| `processes.methods.logs.kind` | `"json"` | `"json"` |
|
|
197
|
+
| `processes.methods.logs.method` | `"GET"` | `"GET"` |
|
|
198
|
+
| `processes.methods.logs.path` | `"processes/logs"` | `"processes/logs"` |
|
|
195
199
|
| <a id="property-terminal"></a> `terminal` | `object` | - |
|
|
196
200
|
| `terminal.id` | `string` | `computerTerminal.id` |
|
|
197
201
|
| `terminal.version` | `number` | `computerTerminal.version` |
|
package/docs/api/page/mount.md
CHANGED
|
@@ -132,6 +132,8 @@ type OysterAppConnectionOptions = Readonly<{
|
|
|
132
132
|
appOpen?: OysterAppOpenRouting;
|
|
133
133
|
openRequest?: AppHostLaunch["context"]["value"]["openRequest"];
|
|
134
134
|
surfaceId?: string;
|
|
135
|
+
setup?: AppSetup;
|
|
136
|
+
permissions?: AppPermissions;
|
|
135
137
|
reservedChords: readonly AppHostReservedChord[];
|
|
136
138
|
theme: string;
|
|
137
139
|
}>;
|
package/docs/api/workers-git.md
CHANGED
|
@@ -1012,6 +1012,10 @@ gill(
|
|
|
1012
1012
|
title: string;
|
|
1013
1013
|
state: "empty";
|
|
1014
1014
|
rows: readonly [];
|
|
1015
|
+
emptyText?: string;
|
|
1016
|
+
action?: {
|
|
1017
|
+
kind: "open";
|
|
1018
|
+
};
|
|
1015
1019
|
next?: string;
|
|
1016
1020
|
}
|
|
1017
1021
|
| {
|
|
@@ -1076,9 +1080,10 @@ Invoke a Release-declared Gill in a fresh immutable frame.
|
|
|
1076
1080
|
###### Returns
|
|
1077
1081
|
|
|
1078
1082
|
`Promise`\<[`InstanceResult`](host.md#instanceresult)\< \| \{ `viewId`:
|
|
1079
|
-
`string`; `title`: `string`; `state`: `"empty"`; `rows`: readonly \[\];
|
|
1080
|
-
`string`;
|
|
1081
|
-
|
|
1083
|
+
`string`; `title`: `string`; `state`: `"empty"`; `rows`: readonly \[\];
|
|
1084
|
+
`emptyText?`: `string`; `action?`: \{ `kind`: `"open"`; \}; `next?`: `string`;
|
|
1085
|
+
\} \| \{ `viewId`: `string`; `title`: `string`; `state`: `"error"`; `rows`:
|
|
1086
|
+
readonly \[\]; `reason?`: `"disabled"` \| `"exec_isolation_required"` \|
|
|
1082
1087
|
`"params_required"`; `error`: `string`; `recovery?`: \| \{ `kind`:
|
|
1083
1088
|
`"configure"`; `param`: `string`; \} \| \{ `kind`: `"open"`; \}; \} \| \{
|
|
1084
1089
|
`viewId`: `string`; `title`: `string`; `state`: `"full"`; `rows`: readonly
|
|
@@ -1722,12 +1727,12 @@ both compose it here.
|
|
|
1722
1727
|
|
|
1723
1728
|
#### Parameters
|
|
1724
1729
|
|
|
1725
|
-
| Parameter | Type
|
|
1726
|
-
| ----------------- |
|
|
1727
|
-
| `env` | [`OysterGitEnv`](#oystergitenv)
|
|
1728
|
-
| `scope` | [`TenantScope`](tenant.md#tenantscope)
|
|
1729
|
-
| `hostOwnerRoutes` | \| [`Routes`](authorization.md#routes)\<[`OysterEnv`](host.md#oysterenv)\> \| `undefined`
|
|
1730
|
-
| `agents` | \| `Readonly`\<\{ `list`: `Promise`\<readonly `Readonly`\<\{ `agentId`: `string`; `name`: `string`; `avatar`: \{ `v`: `1`; `character`: `"mushroom"` \| `"cat"` \| `"burger"`; `appearance`: `z.ZodRecord`\<`z.ZodString`, `z.ZodUnion`\<readonly ...\>\>; `expression`: `string`; `renderStyle`: \| `"plain"` \| `"pencil"` \| `"manga"` \| `"riso"` \| `"halftone"` \| `"blueprint"` \| `"crt"` \| `"watercolor"`; \}; `sessionOperations`: readonly (`"agent.manage"` \| `"agent.read"` \| `"agent.send"`)[]; \}\>[]\>; `setArchived`: `Promise`\< \| `Readonly`\<\{ `archived`: `boolean`; `revision`: `number`; \}\> \| `Readonly`\<\{ `error`: \| `"archived"` \| `"pending"` \| `"not_found"` \| `"running"` \| `"not_granted"` \| `"self"` \| `"not_creator"` \| `"unreadable"`; `message?`: `string`; `archived?`: `boolean`; `revision?`: `number`; \}\>\>; `create`: `Promise`\<`Readonly`\<\{ `agentId`: `string`; `name`: `string`; `avatar`: \{ `v`: `1`; `character`: `"mushroom"` \| `"cat"` \| `"burger"`; `appearance`: `z.ZodRecord`\<`z.ZodString`, `z.ZodUnion`\<readonly \[..., ..., ...\]\>\>; `expression`: `string`; `renderStyle`: \| `"plain"` \| `"pencil"` \| `"manga"` \| `"riso"` \| `"halftone"` \| `"blueprint"` \| `"crt"` \| `"watercolor"`; \}; `sessionOperations`: readonly (`"agent.manage"` \| `"agent.read"` \| `"agent.send"`)[]; \}\>\>; `rename`: `Promise`\< \| `Readonly`\<\{ `agentId`: `string`; `name`: `string`; `avatar`: \{ `v`: `1`; `character`: `"mushroom"` \| `"cat"` \| `"burger"`; `appearance`: `z.ZodRecord`\<`z.ZodString`, `z.ZodUnion`\<readonly ...\>\>; `expression`: `string`; `renderStyle`: \| `"plain"` \| `"pencil"` \| `"manga"` \| `"riso"` \| `"halftone"` \| `"blueprint"` \| `"crt"` \| `"watercolor"`; \}; `sessionOperations`: readonly (`"agent.manage"` \| `"agent.read"` \| `"agent.send"`)[]; \}\> \| `Readonly`\<\{ `error`: `"not_found"` \| `"not_granted"` \| `"name_taken"`; \}\>\>; `setAvatar`: `Promise`\< \| `Readonly`\<\{ `agentId`: `string`; `name`: `string`; `avatar`: \{ `v`: `1`; `character`: `"mushroom"` \| `"cat"` \| `"burger"`; `appearance`: `z.ZodRecord`\<`z.ZodString`, `z.ZodUnion`\<readonly ...\>\>; `expression`: `string`; `renderStyle`: \| `"plain"` \| `"pencil"` \| `"manga"` \| `"riso"` \| `"halftone"` \| `"blueprint"` \| `"crt"` \| `"watercolor"`; \}; `sessionOperations`: readonly (`"agent.manage"` \| `"agent.read"` \| `"agent.send"`)[]; \}\> \| `Readonly`\<\{ `error`: `"not_found"` \| `"not_granted"`; \}\>\>; `readModelChoice`: `Promise`\< \| \{ `keySource`: `"workers-ai"` \| `"ai-gateway"` \| `"byok"`; `model`: \{ `providerId`: `string`; `modelId`: `string`; `reasoning?`: `"max"` \| `"low"` \| `"medium"` \| `"high"` \| `"minimal"` \| `"xhigh"`; \}; `keyId?`: `string`; \} \| `null`\>; `decodeModelChoice`: \| \{ `keySource`: `"workers-ai"` \| `"ai-gateway"` \| `"byok"`; `model`: \{ `providerId`: `string`; `modelId`: `string`; `reasoning?`: `"max"` \| `"low"` \| `"medium"` \| `"high"` \| `"minimal"` \| `"xhigh"`; \}; `keyId?`: `string`; \} \| `null`; `setModelChoice`: `Promise`\< \| \{ `keySource`: `"workers-ai"` \| `"ai-gateway"` \| `"byok"`; `model`: \{ `providerId`: `string`; `modelId`: `string`; `reasoning?`: `"max"` \| `"low"` \| `"medium"` \| `"high"` \| `"minimal"` \| `"xhigh"`; \}; `keyId?`: `string`; \} \| `Readonly`\<\{ `error`: \| `"not_found"` \| `"not_granted"` \| [`AgentModelRefusal`](agents.md#agentmodelrefusal); \}\>\>; `policyStatus`: `Promise`\< \| `Readonly`\<\{ `status`: `"pending"` \| `"approved"`; `revision`: `string`; \}\> \| `null`\>; `appToolPolicy`: `Promise`\< \| \{ `level`: `"read"` \| `"write"`; `revision`: `string`; `grantedBy`: `string`; \} \| `null`\>; `policyRevision`: `Promise`\<`string` \| `null`\>; `approveAppToolPolicy`: `Promise`\< \| \{ `level`: `"read"` \| `"write"`; `revision`: `string`; `grantedBy`: `string`; \} \| `Readonly`\<\{ `status`: `"pending"`; `revision`: `string`; \}\> \| `Readonly`\<\{ `error`: `"not_found"` \| `"not_granted"` \| `"revision_conflict"`; \}\>\>; `modelKeys`: `Promise`\<readonly `Readonly`\<\{ `keyId`: `string`; `provider`: `"anthropic"` \| `"openai"` \| `"openrouter"` \| `"openai-compatible"`; `label`: `string`; `createdAt`: `number`; `validatedAt`: `number`; \}\>[]\>; `sealModelKey`: `Promise`\< \| `Readonly`\<\{ `keyId`: `string`; `provider`: `"anthropic"` \| `"openai"` \| `"openrouter"` \| `"openai-compatible"`; `label`: `string`; `createdAt`: `number`; `validatedAt`: `number`; \}\> \| `Readonly`\<\{ `error`: [`ModelKeyRefusal`](agents.md#modelkeyrefusal); \}\>\>; `removeModelKey`: `Promise`\<`"deleted"` \| `"absent"`\>; `connections`: `Promise`\<readonly `Readonly`\<\{ `connectionId`: `string`; `name`: `string`; `label`: `string`; `kind`: `"mcp"` \| `"openapi"`; `url`: `string`; `auth`: `"none"` \| `"token"` \| `"oauth"`; `state`: `"pending"` \| `"connected"` \| `"reconnect_required"`; `grants`: readonly `Readonly`\<\{ `agentId`: `string`; `access`: [`ConnectionAccess`](agents.md#connectionaccess); \}\>[]; \}\>[]\>; `addConnection`: `Promise`\< \| `Readonly`\<\{ `connectionId`: `string`; `authorizeUrl`: `string` \| `null`; \}\> \| `Readonly`\<\{ `error`: `"limit"` \| `"not_found"` \| `"duplicate_name"` \| `"invalid_endpoint"`; \}\>\>; `grantConnection`: `Promise`\< \| `Readonly`\<\{ `error`: `"limit"` \| `"not_found"` \| `"duplicate_name"` \| `"invalid_endpoint"`; \}\> \| `Readonly`\<\{ `ok`: `true`; \}\>\>; `ungrantConnection`: `Promise`\<`boolean`\>; `removeConnection`: `Promise`\<`boolean`\>; `connectionTools`: `Promise`\< \| readonly `string`[] \| `Readonly`\<\{ `error`: `"limit"` \| `"not_found"` \| `"duplicate_name"` \| `"invalid_endpoint"`; \}\>\>; `completeMcpConnection`: `Promise`\< \| `Readonly`\<\{ `ok`: `true`; \}\> \| `Readonly`\<\{ `error`: `string`; \}\>\>; `mcpCallbackUrl`: `string`; `fetch`: `Promise`\<`Response` \| `null`\>; `inbox`: `Promise`\<`Readonly`\<\{ `items`: readonly ( \| \{ `agentId`: `string`; `sessionId`: `string`; `title`: `string`; `triggerId?`: `string`; `createdAt`: `number`; `lastActivityAt`: `number`; `settledAt?`: `number`; `visitedAt?`: `number`; `state`: `"running"` \| `"done"` \| `"errored"` \| `"needs_you"`; \} \| \{ `agentId`: `string`; `sessionId`: `string`; `state`: `"unavailable"`; \} \| \{ `kind`: `"workflow-review"`; `key`: \{ `runId`: `string`; `nodeId`: `string`; `iteration`: `string`; \}; `installationId`: `string`; `workflowId`: `string` \| `null`; `workflowTitle`: `string`; `reviewTitle`: `string`; `reviewers`: `"runner"` \| `"owners"`; `show`: readonly `Json`[]; `choices?`: readonly ...[]; `openedAt`: `number`; `expiresAt`: `number`; `state`: `"pending"` \| `"delivered"` \| `"answered"` \| `"timed_out"` \| `"closed"`; \})[]; `revision`: `number`; \}\>\>; `revision`: `Promise`\<`number`\>; `visit`: `Promise`\<`boolean`\>; \}\> \| `undefined` |
|
|
1730
|
+
| Parameter | Type |
|
|
1731
|
+
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
1732
|
+
| `env` | [`OysterGitEnv`](#oystergitenv) |
|
|
1733
|
+
| `scope` | [`TenantScope`](tenant.md#tenantscope) |
|
|
1734
|
+
| `hostOwnerRoutes` | \| [`Routes`](authorization.md#routes)\<[`OysterEnv`](host.md#oysterenv)\> \| `undefined` |
|
|
1735
|
+
| `agents` | \| `Readonly`\<\{ `list`: `Promise`\<readonly `Readonly`\<\{ `agentId`: `string`; `name`: `string`; `avatar`: \{ `v`: `1`; `character`: `"mushroom"` \| `"cat"` \| `"burger"`; `appearance`: `z.ZodRecord`\<`z.ZodString`, `z.ZodUnion`\<readonly ...\>\>; `expression`: `string`; `renderStyle`: \| `"plain"` \| `"pencil"` \| `"manga"` \| `"riso"` \| `"halftone"` \| `"blueprint"` \| `"crt"` \| `"watercolor"`; \}; `sessionOperations`: readonly (`"agent.manage"` \| `"agent.read"` \| `"agent.send"`)[]; \}\>[]\>; `setArchived`: `Promise`\< \| `Readonly`\<\{ `archived`: `boolean`; `revision`: `number`; \}\> \| `Readonly`\<\{ `error`: \| `"archived"` \| `"pending"` \| `"not_found"` \| `"running"` \| `"not_granted"` \| `"self"` \| `"not_creator"` \| `"unreadable"`; `message?`: `string`; `archived?`: `boolean`; `revision?`: `number`; \}\>\>; `create`: `Promise`\<`Readonly`\<\{ `agentId`: `string`; `name`: `string`; `avatar`: \{ `v`: `1`; `character`: `"mushroom"` \| `"cat"` \| `"burger"`; `appearance`: `z.ZodRecord`\<`z.ZodString`, `z.ZodUnion`\<readonly \[..., ..., ...\]\>\>; `expression`: `string`; `renderStyle`: \| `"plain"` \| `"pencil"` \| `"manga"` \| `"riso"` \| `"halftone"` \| `"blueprint"` \| `"crt"` \| `"watercolor"`; \}; `sessionOperations`: readonly (`"agent.manage"` \| `"agent.read"` \| `"agent.send"`)[]; \}\>\>; `rename`: `Promise`\< \| `Readonly`\<\{ `agentId`: `string`; `name`: `string`; `avatar`: \{ `v`: `1`; `character`: `"mushroom"` \| `"cat"` \| `"burger"`; `appearance`: `z.ZodRecord`\<`z.ZodString`, `z.ZodUnion`\<readonly ...\>\>; `expression`: `string`; `renderStyle`: \| `"plain"` \| `"pencil"` \| `"manga"` \| `"riso"` \| `"halftone"` \| `"blueprint"` \| `"crt"` \| `"watercolor"`; \}; `sessionOperations`: readonly (`"agent.manage"` \| `"agent.read"` \| `"agent.send"`)[]; \}\> \| `Readonly`\<\{ `error`: `"not_found"` \| `"not_granted"` \| `"name_taken"`; \}\>\>; `setAvatar`: `Promise`\< \| `Readonly`\<\{ `agentId`: `string`; `name`: `string`; `avatar`: \{ `v`: `1`; `character`: `"mushroom"` \| `"cat"` \| `"burger"`; `appearance`: `z.ZodRecord`\<`z.ZodString`, `z.ZodUnion`\<readonly ...\>\>; `expression`: `string`; `renderStyle`: \| `"plain"` \| `"pencil"` \| `"manga"` \| `"riso"` \| `"halftone"` \| `"blueprint"` \| `"crt"` \| `"watercolor"`; \}; `sessionOperations`: readonly (`"agent.manage"` \| `"agent.read"` \| `"agent.send"`)[]; \}\> \| `Readonly`\<\{ `error`: `"not_found"` \| `"not_granted"`; \}\>\>; `readModelChoice`: `Promise`\< \| \{ `keySource`: `"workers-ai"` \| `"ai-gateway"` \| `"byok"`; `model`: \{ `providerId`: `string`; `modelId`: `string`; `reasoning?`: `"max"` \| `"low"` \| `"medium"` \| `"high"` \| `"minimal"` \| `"xhigh"`; \}; `keyId?`: `string`; \} \| `null`\>; `decodeModelChoice`: \| \{ `keySource`: `"workers-ai"` \| `"ai-gateway"` \| `"byok"`; `model`: \{ `providerId`: `string`; `modelId`: `string`; `reasoning?`: `"max"` \| `"low"` \| `"medium"` \| `"high"` \| `"minimal"` \| `"xhigh"`; \}; `keyId?`: `string`; \} \| `null`; `setModelChoice`: `Promise`\< \| \{ `keySource`: `"workers-ai"` \| `"ai-gateway"` \| `"byok"`; `model`: \{ `providerId`: `string`; `modelId`: `string`; `reasoning?`: `"max"` \| `"low"` \| `"medium"` \| `"high"` \| `"minimal"` \| `"xhigh"`; \}; `keyId?`: `string`; \} \| `Readonly`\<\{ `error`: \| `"not_found"` \| `"not_granted"` \| [`AgentModelRefusal`](agents.md#agentmodelrefusal); \}\>\>; `policyStatus`: `Promise`\< \| `Readonly`\<\{ `status`: `"pending"` \| `"approved"`; `revision`: `string`; \}\> \| `null`\>; `appToolPolicy`: `Promise`\< \| \{ `level`: `"read"` \| `"write"`; `revision`: `string`; `grantedBy`: `string`; \} \| `null`\>; `policyRevision`: `Promise`\<`string` \| `null`\>; `approveAppToolPolicy`: `Promise`\< \| \{ `level`: `"read"` \| `"write"`; `revision`: `string`; `grantedBy`: `string`; \} \| `Readonly`\<\{ `status`: `"pending"`; `revision`: `string`; \}\> \| `Readonly`\<\{ `error`: `"not_found"` \| `"not_granted"` \| `"revision_conflict"`; \}\>\>; `setup`: `Promise`\<`Readonly`\<\{ `models`: `"ready"` \| `"missing"`; `media`: `"ready"` \| `"missing"`; \}\>\>; `modelKeys`: `Promise`\<readonly `Readonly`\<\{ `keyId`: `string`; `provider`: `"anthropic"` \| `"openai"` \| `"openrouter"` \| `"openai-compatible"`; `label`: `string`; `createdAt`: `number`; `validatedAt`: `number`; \}\>[]\>; `sealModelKey`: `Promise`\< \| `Readonly`\<\{ `keyId`: `string`; `provider`: `"anthropic"` \| `"openai"` \| `"openrouter"` \| `"openai-compatible"`; `label`: `string`; `createdAt`: `number`; `validatedAt`: `number`; \}\> \| `Readonly`\<\{ `error`: [`ModelKeyRefusal`](agents.md#modelkeyrefusal); \}\>\>; `removeModelKey`: `Promise`\<`"deleted"` \| `"absent"`\>; `connections`: `Promise`\<readonly `Readonly`\<\{ `connectionId`: `string`; `name`: `string`; `label`: `string`; `kind`: `"mcp"` \| `"openapi"`; `url`: `string`; `auth`: `"none"` \| `"token"` \| `"oauth"`; `state`: `"pending"` \| `"connected"` \| `"reconnect_required"`; `grants`: readonly `Readonly`\<\{ `agentId`: `string`; `access`: [`ConnectionAccess`](agents.md#connectionaccess); \}\>[]; \}\>[]\>; `addConnection`: `Promise`\< \| `Readonly`\<\{ `connectionId`: `string`; `authorizeUrl`: `string` \| `null`; \}\> \| `Readonly`\<\{ `error`: `"limit"` \| `"not_found"` \| `"duplicate_name"` \| `"invalid_endpoint"`; \}\>\>; `grantConnection`: `Promise`\< \| `Readonly`\<\{ `error`: `"limit"` \| `"not_found"` \| `"duplicate_name"` \| `"invalid_endpoint"`; \}\> \| `Readonly`\<\{ `ok`: `true`; \}\>\>; `ungrantConnection`: `Promise`\<`boolean`\>; `removeConnection`: `Promise`\<`boolean`\>; `connectionTools`: `Promise`\< \| readonly `string`[] \| `Readonly`\<\{ `error`: `"limit"` \| `"not_found"` \| `"duplicate_name"` \| `"invalid_endpoint"`; \}\>\>; `completeMcpConnection`: `Promise`\< \| `Readonly`\<\{ `ok`: `true`; \}\> \| `Readonly`\<\{ `error`: `string`; \}\>\>; `mcpCallbackUrl`: `string`; `fetch`: `Promise`\<`Response` \| `null`\>; `inbox`: `Promise`\<`Readonly`\<\{ `items`: readonly ( \| \{ `agentId`: `string`; `sessionId`: `string`; `title`: `string`; `triggerId?`: `string`; `createdAt`: `number`; `lastActivityAt`: `number`; `settledAt?`: `number`; `visitedAt?`: `number`; `state`: `"running"` \| `"done"` \| `"errored"` \| `"needs_you"`; \} \| \{ `agentId`: `string`; `sessionId`: `string`; `state`: `"unavailable"`; \} \| \{ `kind`: `"workflow-review"`; `key`: \{ `runId`: `string`; `nodeId`: `string`; `iteration`: `string`; \}; `installationId`: `string`; `workflowId`: `string` \| `null`; `workflowTitle`: `string`; `reviewTitle`: `string`; `reviewers`: `"runner"` \| `"owners"`; `show`: readonly `Json`[]; `choices?`: readonly ...[]; `openedAt`: `number`; `expiresAt`: `number`; `state`: `"pending"` \| `"delivered"` \| `"answered"` \| `"timed_out"` \| `"closed"`; \})[]; `revision`: `number`; \}\>\>; `revision`: `Promise`\<`number`\>; `visit`: `Promise`\<`boolean`\>; \}\> \| `undefined` |
|
|
1731
1736
|
|
|
1732
1737
|
#### Returns
|
|
1733
1738
|
|
package/docs/api/workers.md
CHANGED
|
@@ -2043,6 +2043,10 @@ gill(
|
|
|
2043
2043
|
title: string;
|
|
2044
2044
|
state: "empty";
|
|
2045
2045
|
rows: readonly [];
|
|
2046
|
+
emptyText?: string;
|
|
2047
|
+
action?: {
|
|
2048
|
+
kind: "open";
|
|
2049
|
+
};
|
|
2046
2050
|
next?: string;
|
|
2047
2051
|
}
|
|
2048
2052
|
| {
|
|
@@ -2107,9 +2111,10 @@ Invoke a Release-declared Gill in a fresh immutable frame.
|
|
|
2107
2111
|
###### Returns
|
|
2108
2112
|
|
|
2109
2113
|
`Promise`\<[`InstanceResult`](host.md#instanceresult)\< \| \{ `viewId`:
|
|
2110
|
-
`string`; `title`: `string`; `state`: `"empty"`; `rows`: readonly \[\];
|
|
2111
|
-
`string`;
|
|
2112
|
-
|
|
2114
|
+
`string`; `title`: `string`; `state`: `"empty"`; `rows`: readonly \[\];
|
|
2115
|
+
`emptyText?`: `string`; `action?`: \{ `kind`: `"open"`; \}; `next?`: `string`;
|
|
2116
|
+
\} \| \{ `viewId`: `string`; `title`: `string`; `state`: `"error"`; `rows`:
|
|
2117
|
+
readonly \[\]; `reason?`: `"disabled"` \| `"exec_isolation_required"` \|
|
|
2113
2118
|
`"params_required"`; `error`: `string`; `recovery?`: \| \{ `kind`:
|
|
2114
2119
|
`"configure"`; `param`: `string`; \} \| \{ `kind`: `"open"`; \}; \} \| \{
|
|
2115
2120
|
`viewId`: `string`; `title`: `string`; `state`: `"full"`; `rows`: readonly
|
|
@@ -131,7 +131,7 @@ has exact edit commands and the next App to build.
|
|
|
131
131
|
Stop here unless the person wants the next step. These are separate tasks:
|
|
132
132
|
|
|
133
133
|
- **Connect MCP:** use the
|
|
134
|
-
[MCP guide](https://docs.fungi.computer/oyster/concepts/#connect-
|
|
134
|
+
[MCP guide](https://docs.fungi.computer/oyster/concepts/#connect-your-agents)
|
|
135
135
|
for the `/mcp` endpoint and authentication. For this trial, use the printed
|
|
136
136
|
local Oyster address and the owner key in `my-oyster/.oyster-owner`. Hello is
|
|
137
137
|
a static page; connecting MCP does not give it backend methods.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@fungi.computer/oyster",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.16.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",
|
|
@@ -116,10 +116,6 @@
|
|
|
116
116
|
"types": "./dist/standalone/worker.d.ts",
|
|
117
117
|
"import": "./dist/standalone/worker.js"
|
|
118
118
|
},
|
|
119
|
-
"./standalone/visitor-edge": {
|
|
120
|
-
"types": "./dist/standalone/visitor-edge.d.ts",
|
|
121
|
-
"import": "./dist/standalone/visitor-edge.js"
|
|
122
|
-
},
|
|
123
119
|
"./standalone/app-set": {
|
|
124
120
|
"types": "./dist/standalone/app-set.d.ts",
|
|
125
121
|
"import": "./dist/standalone/app-set.js"
|
|
@@ -204,6 +200,10 @@
|
|
|
204
200
|
"types": "./dist/standalone/agent-archive-owner.d.ts",
|
|
205
201
|
"import": "./dist/standalone/agent-archive-owner.js"
|
|
206
202
|
},
|
|
203
|
+
"./starter-agent": {
|
|
204
|
+
"types": "./dist/starter-agent.d.ts",
|
|
205
|
+
"import": "./dist/starter-agent.js"
|
|
206
|
+
},
|
|
207
207
|
"./agent-computers": {
|
|
208
208
|
"types": "./dist/agent-computers.d.ts",
|
|
209
209
|
"import": "./dist/agent-computers.js"
|
|
@@ -216,10 +216,6 @@
|
|
|
216
216
|
"types": "./dist/build.d.ts",
|
|
217
217
|
"import": "./dist/build.js"
|
|
218
218
|
},
|
|
219
|
-
"./app-builds": {
|
|
220
|
-
"types": "./dist/app-builds.d.ts",
|
|
221
|
-
"import": "./dist/app-builds.js"
|
|
222
|
-
},
|
|
223
219
|
"./build-contract": {
|
|
224
220
|
"types": "./dist/build-contract.d.ts",
|
|
225
221
|
"import": "./dist/build-contract.js"
|
|
@@ -240,14 +236,6 @@
|
|
|
240
236
|
"types": "./dist/source/template-push.d.ts",
|
|
241
237
|
"import": "./dist/source/template-push.js"
|
|
242
238
|
},
|
|
243
|
-
"./app-sources": {
|
|
244
|
-
"types": "./dist/app-sources.d.ts",
|
|
245
|
-
"import": "./dist/app-sources.js"
|
|
246
|
-
},
|
|
247
|
-
"./catalog-frame": {
|
|
248
|
-
"types": "./dist/catalog-frame.d.ts",
|
|
249
|
-
"import": "./dist/catalog-frame.js"
|
|
250
|
-
},
|
|
251
239
|
"./media": {
|
|
252
240
|
"types": "./dist/media.d.ts",
|
|
253
241
|
"import": "./dist/media.js"
|
|
@@ -308,10 +296,6 @@
|
|
|
308
296
|
"types": "./dist/page/app-permissions.d.ts",
|
|
309
297
|
"import": "./dist/page/app-permissions.js"
|
|
310
298
|
},
|
|
311
|
-
"./apps/permissions-port": {
|
|
312
|
-
"types": "./dist/page/app-permissions-port.d.ts",
|
|
313
|
-
"import": "./dist/page/app-permissions-port.js"
|
|
314
|
-
},
|
|
315
299
|
"./keys": {
|
|
316
300
|
"types": "./dist/keys.d.ts",
|
|
317
301
|
"import": "./dist/keys.js"
|
|
@@ -324,14 +308,14 @@
|
|
|
324
308
|
"types": "./dist/testing/index.d.ts",
|
|
325
309
|
"import": "./dist/testing/index.js"
|
|
326
310
|
},
|
|
327
|
-
"./testing/workers-runtime": {
|
|
328
|
-
"types": "./dist/testing/workers-runtime.d.ts",
|
|
329
|
-
"import": "./dist/testing/workers-runtime.js"
|
|
330
|
-
},
|
|
331
311
|
"./testing/worker": {
|
|
332
312
|
"types": "./dist/testing/worker.d.ts",
|
|
333
313
|
"import": "./dist/testing/worker.js"
|
|
334
314
|
},
|
|
315
|
+
"./testing/workers-runtime": {
|
|
316
|
+
"types": "./dist/testing/workers-runtime.d.ts",
|
|
317
|
+
"import": "./dist/testing/workers-runtime.js"
|
|
318
|
+
},
|
|
335
319
|
"./machine-link": {
|
|
336
320
|
"types": "./dist/machine-link/index.d.ts",
|
|
337
321
|
"import": "./dist/machine-link/index.js"
|
|
@@ -344,37 +328,37 @@
|
|
|
344
328
|
"dependencies": {
|
|
345
329
|
"@cfworker/json-schema": "4.1.1",
|
|
346
330
|
"@earendil-works/pi-ai": "1.3.0",
|
|
347
|
-
"@fungi.computer/agar": "0.
|
|
348
|
-
"@fungi.computer/bird-dog": "0.3.
|
|
349
|
-
"@fungi.computer/braid": "0.4.
|
|
331
|
+
"@fungi.computer/agar": "0.9.0",
|
|
332
|
+
"@fungi.computer/bird-dog": "0.3.6",
|
|
333
|
+
"@fungi.computer/braid": "0.4.7",
|
|
350
334
|
"@fungi.computer/burrow": "0.2.1",
|
|
351
335
|
"@fungi.computer/cairn": "0.1.0",
|
|
352
336
|
"@fungi.computer/capnweb": "0.12.0-fungi.0",
|
|
353
|
-
"@fungi.computer/caps": "0.
|
|
354
|
-
"@fungi.computer/carrier": "0.2.
|
|
355
|
-
"@fungi.computer/computer": "0.
|
|
356
|
-
"@fungi.computer/computer-contract": "0.0
|
|
357
|
-
"@fungi.computer/darkroom": "0.5.
|
|
337
|
+
"@fungi.computer/caps": "0.9.0",
|
|
338
|
+
"@fungi.computer/carrier": "0.2.4",
|
|
339
|
+
"@fungi.computer/computer": "0.8.0",
|
|
340
|
+
"@fungi.computer/computer-contract": "0.1.0",
|
|
341
|
+
"@fungi.computer/darkroom": "0.5.5",
|
|
358
342
|
"@fungi.computer/ear-tag": "0.1.0",
|
|
359
|
-
"@fungi.computer/forage": "0.3.
|
|
360
|
-
"@fungi.computer/gills": "0.
|
|
361
|
-
"@fungi.computer/knapsack": "0.4.
|
|
362
|
-
"@fungi.computer/lantern": "0.4.
|
|
363
|
-
"@fungi.computer/mycelium": "0.3.
|
|
364
|
-
"@fungi.computer/nacre": "0.
|
|
365
|
-
"@fungi.computer/parakeet": "0.
|
|
366
|
-
"@fungi.computer/puffball": "0.5.
|
|
367
|
-
"@fungi.computer/seam": "0.2.
|
|
368
|
-
"@fungi.computer/shiitake": "0.12.
|
|
369
|
-
"@fungi.computer/shiitake-extensions": "0.6.
|
|
343
|
+
"@fungi.computer/forage": "0.3.5",
|
|
344
|
+
"@fungi.computer/gills": "0.3.0",
|
|
345
|
+
"@fungi.computer/knapsack": "0.4.9",
|
|
346
|
+
"@fungi.computer/lantern": "0.4.2",
|
|
347
|
+
"@fungi.computer/mycelium": "0.3.8",
|
|
348
|
+
"@fungi.computer/nacre": "0.3.0",
|
|
349
|
+
"@fungi.computer/parakeet": "0.10.0",
|
|
350
|
+
"@fungi.computer/puffball": "0.5.5",
|
|
351
|
+
"@fungi.computer/seam": "0.2.5",
|
|
352
|
+
"@fungi.computer/shiitake": "0.12.3",
|
|
353
|
+
"@fungi.computer/shiitake-extensions": "0.6.10",
|
|
370
354
|
"@fungi.computer/sigils": "0.3.0",
|
|
371
|
-
"@fungi.computer/sprite": "0.2.
|
|
372
|
-
"@fungi.computer/sprite-zdog": "0.3.
|
|
373
|
-
"@fungi.computer/veil": "0.6.
|
|
374
|
-
"@fungi.computer/watchdog": "0.1.
|
|
355
|
+
"@fungi.computer/sprite": "0.2.2",
|
|
356
|
+
"@fungi.computer/sprite-zdog": "0.3.2",
|
|
357
|
+
"@fungi.computer/veil": "0.6.5",
|
|
358
|
+
"@fungi.computer/watchdog": "0.1.3",
|
|
375
359
|
"@fungi.computer/whistle": "0.3.0",
|
|
376
|
-
"@fungi.computer/workflows-wire": "0.4.
|
|
377
|
-
"@fungi.computer/zookeeper": "0.0.
|
|
360
|
+
"@fungi.computer/workflows-wire": "0.4.7",
|
|
361
|
+
"@fungi.computer/zookeeper": "0.0.17",
|
|
378
362
|
"@modelcontextprotocol/server": "2.0.0",
|
|
379
363
|
"@pnpm/lockfile.fs": "1100.2.13",
|
|
380
364
|
"@pnpm/lockfile.pruner": "1100.0.27",
|