@fungi.computer/oyster 0.5.0 → 0.7.0

package/docs/site/agent-quickstart.mdx

@@ -10,6 +10,10 @@ 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
@@ -303,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fungi.computer/oyster",
-  "version": "0.5.0",
+  "version": "0.7.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",
@@ -112,6 +112,26 @@
       "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"
@@ -140,6 +160,14 @@
       "types": "./dist/agents.d.ts",
       "import": "./dist/agents.js"
     },
+    "./agent-schedules": {
+      "types": "./dist/agent-schedules.d.ts",
+      "import": "./dist/agent-schedules.js"
+    },
+    "./agent-archive": {
+      "types": "./dist/standalone/agent-archive-owner.d.ts",
+      "import": "./dist/standalone/agent-archive-owner.js"
+    },
     "./agent-computers": {
       "types": "./dist/agent-computers.d.ts",
       "import": "./dist/agent-computers.js"
@@ -232,14 +260,30 @@
       "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"
     },
+    "./apps/permissions-view": {
+      "types": "./dist/page/app-permissions.d.ts",
+      "import": "./dist/page/app-permissions.js"
+    },
+    "./apps/permissions-port": {
+      "types": "./dist/page/app-permissions-port.d.ts",
+      "import": "./dist/page/app-permissions-port.js"
+    },
     "./keys": {
       "types": "./dist/keys.d.ts",
       "import": "./dist/keys.js"
     },
+    "./authorization": {
+      "types": "./dist/authorization.d.ts",
+      "import": "./dist/authorization.js"
+    },
     "./testing": {
       "types": "./dist/testing/index.d.ts",
       "import": "./dist/testing/index.js"
@@ -264,42 +308,41 @@
   "dependencies": {
     "@cfworker/json-schema": "4.1.1",
     "@earendil-works/pi-ai": "1.3.0",
-    "@fungi.computer/agar": "0.4.0",
-    "@fungi.computer/bird-dog": "0.2.1",
-    "@fungi.computer/braid": "0.2.3",
-    "@fungi.computer/burrow": "0.1.0",
+    "@fungi.computer/agar": "0.6.0",
+    "@fungi.computer/bird-dog": "0.3.1",
+    "@fungi.computer/braid": "0.3.0",
+    "@fungi.computer/burrow": "0.2.0",
     "@fungi.computer/cairn": "0.1.0",
     "@fungi.computer/capnweb": "0.12.0",
-    "@fungi.computer/caps": "0.3.1",
+    "@fungi.computer/caps": "0.5.0",
     "@fungi.computer/carrier": "0.2.0",
-    "@fungi.computer/computer": "0.3.1",
-    "@fungi.computer/computer-contract": "0.0.4",
-    "@fungi.computer/darkroom": "0.3.0",
+    "@fungi.computer/computer": "0.4.0",
+    "@fungi.computer/computer-contract": "0.0.6",
+    "@fungi.computer/darkroom": "0.4.0",
     "@fungi.computer/ear-tag": "0.1.0",
-    "@fungi.computer/forage": "0.2.0",
+    "@fungi.computer/forage": "0.2.1",
     "@fungi.computer/gills": "0.2.0",
-    "@fungi.computer/knapsack": "0.3.1",
-    "@fungi.computer/mycelium": "0.2.2",
-    "@fungi.computer/nacre": "0.0.3",
-    "@fungi.computer/puffball": "0.2.0",
+    "@fungi.computer/knapsack": "0.4.1",
+    "@fungi.computer/mycelium": "0.3.0",
+    "@fungi.computer/nacre": "0.1.1",
+    "@fungi.computer/puffball": "0.3.0",
     "@fungi.computer/seam": "0.2.0",
-    "@fungi.computer/shiitake": "0.5.0",
-    "@fungi.computer/shiitake-extensions": "0.3.0",
+    "@fungi.computer/shiitake": "0.7.0",
+    "@fungi.computer/shiitake-extensions": "0.5.0",
     "@fungi.computer/sigils": "0.2.0",
     "@fungi.computer/sprite": "0.2.0",
-    "@fungi.computer/sprite-zdog": "0.2.0",
+    "@fungi.computer/sprite-zdog": "0.3.0",
     "@fungi.computer/veil": "0.2.1",
     "@fungi.computer/watchdog": "0.1.0",
-    "@fungi.computer/whistle": "0.2.0",
-    "@fungi.computer/workflows-wire": "0.2.3",
-    "@fungi.computer/zookeeper": "0.0.4",
+    "@fungi.computer/whistle": "0.3.0",
+    "@fungi.computer/workflows-wire": "0.3.0",
+    "@fungi.computer/zookeeper": "0.0.6",
     "@modelcontextprotocol/server": "2.0.0",
     "@pnpm/lockfile.fs": "1100.2.13",
     "@pnpm/lockfile.pruner": "1100.0.27",
     "effect": "4.0.2",
     "esbuild": "0.28.2",
     "eventsource": "5.1.1",
-    "fast-json-stable-stringify": "2.1.0",
     "hono": "4.13.5",
     "jose": "6.2.11",
     "mime": "4.1.0",

package/dist/standalone/channel-session-door.d.ts

@@ -1,4 +0,0 @@
-import type { ShiitakeOwnerAgent } from "@fungi.computer/shiitake/cloudflare";
-import type { SessionDoor } from "../channels/conversations.js";
-/** Translate a standalone Agent's Shiitake owner into Oyster's channel Session port. */
-export declare function channelSessionDoor(open: () => Promise<ShiitakeOwnerAgent>, deliverGrants: (sessionId: string) => void): SessionDoor;

package/dist/standalone/channel-session-door.js

@@ -1,42 +0,0 @@
-import { authorMeta } from "@fungi.computer/agar/agents";
-import { ShiitakeError } from "@fungi.computer/shiitake";
-/** Translate a standalone Agent's Shiitake owner into Oyster's channel Session port. */
-export function channelSessionDoor(open, deliverGrants) {
-    return {
-        createSession: async (requestId) => (await open()).createSession(requestId),
-        deliverGrants,
-        withdraw: async (sessionId, requestId) => (await open()).session(sessionId).withdraw(requestId),
-        latestPending: async (sessionId, visitor) => (await open())
-            .withMeta(authorMeta(visitor))
-            .session(sessionId)
-            .latestPending(),
-        prompt: async (sessionId, { requestId, text, meta }) => {
-            // The conversation row exists now, so its channel admission is known;
-            // deliver Agent tools before the first run can call one.
-            deliverGrants(sessionId);
-            const agent = await open();
-            return await agent.withMeta(meta).session(sessionId).command({
-                type: "prompt",
-                requestId,
-                text,
-                delivery: "followUp",
-            });
-        },
-        line: async (sessionId, input) => {
-            const agent = await open();
-            const meta = input.author === "operator" ? authorMeta(input.identity) : input.meta;
-            await agent.withMeta(meta).session(sessionId).command({
-                type: "operator",
-                requestId: input.requestId,
-                author: input.author,
-                text: input.text,
-            });
-        },
-        errorKind: (error, requestId) => error instanceof ShiitakeError &&
-            error.boundary === "contract" &&
-            error.cause === "closed" &&
-            error.requestId === requestId
-            ? "closed_request"
-            : null,
-    };
-}