@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.
Files changed (61) hide show
  1. package/README.md +178 -1552
  2. package/dist/agents.d.ts +8 -0
  3. package/dist/agents.js +6 -0
  4. package/dist/app-builds.d.ts +5 -6
  5. package/dist/app-builds.js +3 -10
  6. package/dist/apps/permissions.js +8 -1
  7. package/dist/auth.d.ts +2 -0
  8. package/dist/auth.js +9 -8
  9. package/dist/boot-host-script.js +1 -1
  10. package/dist/build/candidate-cli.mjs +4 -0
  11. package/dist/catalog-frame.d.ts +0 -1
  12. package/dist/computer.d.ts +5 -0
  13. package/dist/computer.js +1 -0
  14. package/dist/embed-metafiles.js +2 -2
  15. package/dist/embed-scripts.js +3 -3
  16. package/dist/hello-app-script.js +1 -1
  17. package/dist/host-page-assets.js +1 -1
  18. package/dist/host-page.d.ts +5 -1
  19. package/dist/host-page.js +23 -23
  20. package/dist/host.js +6 -1
  21. package/dist/page/app-access.js +23 -1
  22. package/dist/page/app-permissions.js +165 -50
  23. package/dist/page/app-rights.d.ts +8 -0
  24. package/dist/page/app-rights.js +13 -0
  25. package/dist/page/computer-handles.d.ts +15 -0
  26. package/dist/page/computer-handles.js +4 -1
  27. package/dist/page/mount.d.ts +5 -0
  28. package/dist/page/mount.js +4 -0
  29. package/dist/page-script.js +3 -3
  30. package/dist/standalone/agents.js +10 -0
  31. package/dist/standalone/app-set.d.ts +9 -0
  32. package/dist/standalone/app-set.js +43 -0
  33. package/dist/standalone/app-source.js +16 -1
  34. package/dist/standalone/builds.d.ts +2 -2
  35. package/dist/standalone/builds.js +4 -0
  36. package/dist/standalone/cloudflare-account.d.ts +10 -0
  37. package/dist/standalone/cloudflare-account.js +17 -0
  38. package/dist/standalone/computer.d.ts +8 -3
  39. package/dist/standalone/computer.js +26 -3
  40. package/dist/standalone/install-apps-cli.js +1 -1
  41. package/dist/standalone/local-desktop.d.ts +19 -2
  42. package/dist/standalone/local-desktop.js +38 -15
  43. package/dist/standalone/media.d.ts +2 -0
  44. package/dist/standalone/media.js +17 -1
  45. package/dist/standalone/registry.d.ts +4 -1
  46. package/dist/standalone/registry.js +6 -0
  47. package/dist/standalone/sign-in-link.d.ts +1 -1
  48. package/dist/standalone/sign-in-link.js +9 -18
  49. package/dist/standalone/try-cli.d.ts +7 -0
  50. package/dist/standalone/try-cli.js +88 -8
  51. package/dist/starter-agent.d.ts +59 -0
  52. package/dist/starter-agent.js +85 -0
  53. package/docs/api/README.md +744 -88
  54. package/docs/api/agents.md +6 -0
  55. package/docs/api/auth.md +10 -0
  56. package/docs/api/computer.md +4 -0
  57. package/docs/api/page/mount.md +2 -0
  58. package/docs/api/workers-git.md +14 -9
  59. package/docs/api/workers.md +8 -3
  60. package/docs/site/agent-quickstart.mdx +1 -1
  61. package/package.json +34 -50
@@ -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()
@@ -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` |
@@ -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
  }>;
@@ -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 \[\]; `next?`:
1080
- `string`; \} \| \{ `viewId`: `string`; `title`: `string`; `state`: `"error"`;
1081
- `rows`: readonly \[\]; `reason?`: `"disabled"` \| `"exec_isolation_required"` \|
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
 
@@ -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 \[\]; `next?`:
2111
- `string`; \} \| \{ `viewId`: `string`; `title`: `string`; `state`: `"error"`;
2112
- `rows`: readonly \[\]; `reason?`: `"disabled"` \| `"exec_isolation_required"` \|
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-an-agent-over-mcp)
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.14.1",
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.7.3",
348
- "@fungi.computer/bird-dog": "0.3.5",
349
- "@fungi.computer/braid": "0.4.5",
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.7.1",
354
- "@fungi.computer/carrier": "0.2.3",
355
- "@fungi.computer/computer": "0.6.3",
356
- "@fungi.computer/computer-contract": "0.0.12",
357
- "@fungi.computer/darkroom": "0.5.3",
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.3",
360
- "@fungi.computer/gills": "0.2.2",
361
- "@fungi.computer/knapsack": "0.4.7",
362
- "@fungi.computer/lantern": "0.4.1",
363
- "@fungi.computer/mycelium": "0.3.6",
364
- "@fungi.computer/nacre": "0.2.2",
365
- "@fungi.computer/parakeet": "0.9.1",
366
- "@fungi.computer/puffball": "0.5.3",
367
- "@fungi.computer/seam": "0.2.4",
368
- "@fungi.computer/shiitake": "0.12.1",
369
- "@fungi.computer/shiitake-extensions": "0.6.8",
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.0",
372
- "@fungi.computer/sprite-zdog": "0.3.0",
373
- "@fungi.computer/veil": "0.6.3",
374
- "@fungi.computer/watchdog": "0.1.2",
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.5",
377
- "@fungi.computer/zookeeper": "0.0.15",
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",