Get started

Install

Effect-native durable Session acceptance and bounded run orchestration

For a published npm release:

npm install @fungi.computer/shiitake hono

pnpm, Yarn and Bun work the same way.

Bring your own hono. @fungi.computer/shiitake lists it as a peer dependency so your app keeps one copy.

Needs Node.js >=22.13.

Entrypoints

@fungi.computer/shiitake
@fungi.computer/shiitake/effect
@fungi.computer/shiitake/client
@fungi.computer/shiitake/server-visitor-stream
@fungi.computer/shiitake/agent-control
@fungi.computer/shiitake/model-preference
@fungi.computer/shiitake/http
@fungi.computer/shiitake/cloudflare
@fungi.computer/shiitake/extensions
@fungi.computer/shiitake/hosted
@fungi.computer/shiitake/client-entry
@fungi.computer/shiitake/testing
@fungi.computer/shiitake/storage-conformance
@fungi.computer/shiitake/node
@fungi.computer/shiitake/agar-extension
@fungi.computer/shiitake/fleet
@fungi.computer/shiitake/delegation

What comes with it

Installing @fungi.computer/shiitake also installs @fungi.computer/bird-dog, @fungi.computer/cairn, @fungi.computer/carrier, @fungi.computer/knapsack, @fungi.computer/mule, @fungi.computer/mycelium, @fungi.computer/seam, @fungi.computer/watchdog, effect, zod, @earendil-works/pi-ai, @fungi.computer/gills, @fungi.computer/agar.

Set up

npm install @fungi.computer/shiitake

The package ships ESM only and depends on Effect, Zod, and Hono, plus the Fungi packages Cairn, Mule, Mycelium, Watchdog, Bird Dog and Knapsack, all installed automatically.

Shiitake.make(options) is the Promise constructor. The Effect 4 constructor is make from @fungi.computer/shiitake/effect. Both use the same owner. The host supplies:

Input	Responsibility
`store`	A native SQLite owner with scalar rows and synchronous transactions.
`runtime`	Bind reconciliation, commit mutations with a wake guarantee, schedule work and close the registration.
`model`	Acquire a Pi model and its stream, then release them. The host owns selection and credentials.
`instructions`	Load an instruction snapshot and revision for the run.
`extensions`	An explicit roster and capability grants. Use an empty roster and grants when none are needed.
`tools`	Optional Mycelium modules, sources, the host’s sandbox and `access` grants passed down as data.
`meta`	Optional schema for the opaque metadata the host attaches to prompts and operator lines.

Construction needs an owner and a runtime host that meet their transaction and wake contracts. Existing host fixtures show deterministic and native adapters.