@fungi.computer/oyster 0.4.1 → 0.6.0

package/docs/site/agent-quickstart.mdx

@@ -10,6 +10,33 @@ Run every command exactly as written, from the directory each step names.
 Compare its output with the expected output before you go on. When a step fails,
 read the "If it fails" notes under it before trying anything else.
 
+Not sure Oyster fits the job?
+[Is Oyster for you?](https://docs.fungi.computer/is-oyster-for-you/) compares it
+with Cloudflare Workers Builds before you install anything.
+
+## Before you start
+
+- **Cloudflare plan:** SQLite-backed Durable Objects are available on Workers
+  Free; they do not by themselves require Paid. Cloudflare's SQLite-backed
+  Durable Objects limits list 30 seconds of CPU per request by default,
+  configurable to 5 minutes. See Cloudflare's
+  [Durable Objects limits](https://developers.cloudflare.com/durable-objects/platform/limits/)
+  and
+  [Durable Objects pricing](https://developers.cloudflare.com/durable-objects/platform/pricing/).
+- **Agent chat and AI Gateway:** By default, Agent chat uses the Workers AI
+  binding; it needs no separate provider key or Gateway setup. Prints uses your
+  account's default AI Gateway (created automatically); set `AI_GATEWAY_ID` to
+  use another. The routed models include `openai/gpt-image-2` and video IDs
+  `bytedance/seedance-2.0`, `bytedance/seedance-2.0-fast`,
+  `bytedance/seedance-2.0-mini`, `google/veo-3.1`, `google/veo-3.1-fast` and
+  `minimax/h3-max`.
+
+- **Deployment plan:** Step 7 needs Workers Paid because this deployment uses
+  Containers for the Computer image; Cloudflare lists Containers as available on
+  the
+  [Workers Paid plan](https://developers.cloudflare.com/containers/platform/).
+  SQLite-backed Durable Objects alone do not require Paid.
+
 ## What Oyster is
 
 - Oyster hosts Apps on one Cloudflare Worker, or on celld, a Workers-compatible
@@ -280,8 +307,8 @@ If it fails:
 
 - `SESSION` is empty: the `initialize` call was refused. Check the key as in
   step 3.
-- Named keys for each agent (`POST /api/keys`) come with the Git worker in
-  step 6. The plain standalone Worker answers `404` there.
+- The copied Worker already includes `POST /api/keys`. Use the owner key to
+  create a separate key for each agent; no extra Worker is needed.
 
 ## 6. Add Git
 

package/examples/standalone/wrangler.celld.jsonc

@@ -0,0 +1,66 @@
+{
+  // Copy beside this package's worker.ts into a celld project as wrangler.jsonc.
+  // Set OYSTER_ORIGIN to the public HTTPS origin and keep the owner key out of
+  // this file (.dev.vars for dev; --secret-name / --secrets-file for a fleet).
+  "name": "oyster",
+  "main": "worker.ts",
+  "compatibility_date": "2026-09-04",
+  "compatibility_flags": ["nodejs_compat"],
+  // The React build uses console.createTask() without this production define.
+  "define": { "process.env.NODE_ENV": "\"production\"" },
+  "workflows": [
+    {
+      "binding": "GRAPH_WORKFLOWS",
+      "name": "oyster-graphs",
+      "class_name": "StandaloneGraphWorkflow",
+    },
+  ],
+  "worker_loaders": [{ "binding": "LOADER" }],
+  // celld requires distinct bucket names (unlike the Cloudflare example, which
+  // uses oyster-releases for both); these are prefixes in the same fleet bucket.
+  "r2_buckets": [
+    { "binding": "RELEASES", "bucket_name": "oyster-releases" },
+    { "binding": "APP_ARTIFACTS", "bucket_name": "oyster-media" },
+  ],
+  "vars": {
+    "OYSTER_ORIGIN": "https://oyster.example",
+    "OYSTER_COMPUTER_ID": "workspace",
+    "OYSTER_HOME_INSTALLATION": "tourtois",
+    "OYSTER_OWNER_NAME": "owner",
+  },
+  "durable_objects": {
+    "bindings": [
+      { "name": "TENANTS", "class_name": "StandaloneTenants" },
+      { "name": "MCP", "class_name": "OysterMcp" },
+      { "name": "REGISTRY", "class_name": "OysterRegistry" },
+      { "name": "WORKFLOW_RUNS", "class_name": "StandaloneWorkflowRuns" },
+      { "name": "INSTANCES", "class_name": "StandaloneInstance" },
+      { "name": "COMPUTER", "class_name": "ComputerDO" },
+      { "name": "KEYS", "class_name": "OysterKeys" },
+      { "name": "WEBHOOKS", "class_name": "OysterWebhooks" },
+      { "name": "AGENTS", "class_name": "StandaloneAgent" },
+      { "name": "AGENT_DIRECTORY", "class_name": "AgentDirectory" },
+      { "name": "MACHINE_LINK", "class_name": "MachineLinkDO" },
+      { "name": "MEDIA_OPERATION", "class_name": "MediaOperationDO" },
+    ],
+  },
+  "migrations": [
+    {
+      "tag": "oyster-v1",
+      "new_sqlite_classes": [
+        "StandaloneTenants",
+        "OysterMcp",
+        "OysterRegistry",
+        "StandaloneWorkflowRuns",
+        "StandaloneInstance",
+        "ComputerDO",
+        "OysterKeys",
+        "OysterWebhooks",
+        "StandaloneAgent",
+        "AgentDirectory",
+        "MachineLinkDO",
+        "MediaOperationDO",
+      ],
+    },
+  ],
+}

package/examples/standalone/wrangler.jsonc

@@ -40,10 +40,9 @@
     "OYSTER_HOME_INSTALLATION": "tourtois",
     "OYSTER_ORIGIN": "https://oyster.example",
     "OYSTER_OWNER_NAME": "owner",
-    // Names the AI Gateway that Prints' third-party models (GPT Image 2,
-    // Seedance, Veo) and the background media retry owner route through.
-    // Not a secret: Cloudflare creates the gateway by this id on first use.
-    "AI_GATEWAY_ID": "oyster",
+    // Cloudflare creates the account's default AI Gateway on first use.
+    // Set another ID here to route Prints through a Gateway you configured.
+    "AI_GATEWAY_ID": "default",
   },
   "durable_objects": {
     "bindings": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fungi.computer/oyster",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "author": "Levi <levi@technomancy.dev>",
   "description": "Run your own Apps on Cloudflare Workers or celld: installable App Releases, each with its own Durable Object, SQLite database and declared bindings",
   "type": "module",
@@ -104,6 +104,38 @@
       "types": "./dist/event-recipients.d.ts",
       "import": "./dist/event-recipients.js"
     },
+    "./channels/ids": {
+      "types": "./dist/channels/ids.d.ts",
+      "import": "./dist/channels/ids.js"
+    },
+    "./channels/binding": {
+      "types": "./dist/channels/binding.d.ts",
+      "import": "./dist/channels/binding.js"
+    },
+    "./channels/visitors": {
+      "types": "./dist/channels/visitors.d.ts",
+      "import": "./dist/channels/visitors.js"
+    },
+    "./channels/visitor-request": {
+      "types": "./dist/channels/visitor-request.d.ts",
+      "import": "./dist/channels/visitor-request.js"
+    },
+    "./channels/visitor-stream-slots": {
+      "types": "./dist/channels/visitor-stream-slots.d.ts",
+      "import": "./dist/channels/visitor-stream-slots.js"
+    },
+    "./channels/visitor-channel": {
+      "types": "./dist/channels/visitor-channel.d.ts",
+      "import": "./dist/channels/visitor-channel.js"
+    },
+    "./channels/visitor-edge": {
+      "types": "./dist/channels/visitor-edge.d.ts",
+      "import": "./dist/channels/visitor-edge.js"
+    },
+    "./channels/conversations": {
+      "types": "./dist/channels/conversations.d.ts",
+      "import": "./dist/channels/conversations.js"
+    },
     "./app-storage": {
       "types": "./dist/app-storage.d.ts",
       "import": "./dist/app-storage.js"
@@ -220,6 +252,10 @@
       "types": "./dist/auth.d.ts",
       "import": "./dist/auth.js"
     },
+    "./turnstile": {
+      "types": "./dist/turnstile.d.ts",
+      "import": "./dist/turnstile.js"
+    },
     "./apps": {
       "types": "./dist/apps/index.d.ts",
       "import": "./dist/apps/index.js"
@@ -252,35 +288,35 @@
   "dependencies": {
     "@cfworker/json-schema": "4.1.1",
     "@earendil-works/pi-ai": "1.3.0",
-    "@fungi.computer/agar": "0.3.1",
-    "@fungi.computer/bird-dog": "0.2.0",
-    "@fungi.computer/braid": "0.2.2",
+    "@fungi.computer/agar": "0.5.0",
+    "@fungi.computer/bird-dog": "0.3.0",
+    "@fungi.computer/braid": "0.2.4",
     "@fungi.computer/burrow": "0.1.0",
     "@fungi.computer/cairn": "0.1.0",
     "@fungi.computer/capnweb": "0.12.0",
-    "@fungi.computer/caps": "0.3.0",
+    "@fungi.computer/caps": "0.4.0",
     "@fungi.computer/carrier": "0.2.0",
-    "@fungi.computer/computer": "0.3.0",
-    "@fungi.computer/computer-contract": "0.0.3",
-    "@fungi.computer/darkroom": "0.2.1",
+    "@fungi.computer/computer": "0.3.2",
+    "@fungi.computer/computer-contract": "0.0.5",
+    "@fungi.computer/darkroom": "0.3.1",
     "@fungi.computer/ear-tag": "0.1.0",
     "@fungi.computer/forage": "0.2.0",
     "@fungi.computer/gills": "0.2.0",
-    "@fungi.computer/knapsack": "0.3.0",
-    "@fungi.computer/mycelium": "0.2.2",
-    "@fungi.computer/nacre": "0.0.2",
+    "@fungi.computer/knapsack": "0.4.0",
+    "@fungi.computer/mycelium": "0.2.3",
+    "@fungi.computer/nacre": "0.1.0",
     "@fungi.computer/puffball": "0.2.0",
     "@fungi.computer/seam": "0.2.0",
-    "@fungi.computer/shiitake": "0.4.0",
-    "@fungi.computer/shiitake-extensions": "0.2.0",
+    "@fungi.computer/shiitake": "0.6.0",
+    "@fungi.computer/shiitake-extensions": "0.4.0",
     "@fungi.computer/sigils": "0.2.0",
     "@fungi.computer/sprite": "0.2.0",
     "@fungi.computer/sprite-zdog": "0.2.0",
-    "@fungi.computer/veil": "0.2.0",
+    "@fungi.computer/veil": "0.2.1",
     "@fungi.computer/watchdog": "0.1.0",
-    "@fungi.computer/whistle": "0.1.0",
-    "@fungi.computer/workflows-wire": "0.2.2",
-    "@fungi.computer/zookeeper": "0.0.3",
+    "@fungi.computer/whistle": "0.3.0",
+    "@fungi.computer/workflows-wire": "0.2.4",
+    "@fungi.computer/zookeeper": "0.0.5",
     "@modelcontextprotocol/server": "2.0.0",
     "@pnpm/lockfile.fs": "1100.2.13",
     "@pnpm/lockfile.pruner": "1100.0.27",