acrylblends 0.11.0 → 1.0.0

package/docs/framework/helpers/adapter.md

@@ -1,6 +1,6 @@
 # Adapter Helper
 
-The Adapter Helper provides a seamless way to interact with various platforms through a unified interface.
+The Adapter Helper reads an app's environment the same way on every runtime it runs on.
 
 ## Import
 
@@ -11,50 +11,25 @@ import { env, getRuntimeKey } from 'acrylblends/adapter'
 
 ## `env()`
 
-The `env()` function facilitates retrieving environment variables across different runtimes, extending beyond just Cloudflare Workers' Bindings. The value that can be retrieved with `env(c)` may be different for each runtime.
+The `env()` function returns the environment the host gives the app. On Node.js, the verified runtime, that is `process.env`; on Bun it is `Bun.env` (and `process.env`), and the two entries a `.env` file adds are there as well. A host that passes its own environment to `app.fetch(request, env)` gets that instead.
 
 ```ts
 import { env } from 'acrylblends/adapter'
 
 app.get('/env', (c) => {
-  // NAME is process.env.NAME on Node.js or Bun
-  // NAME is the value written in `wrangler.toml` on Cloudflare
+  // NAME is process.env.NAME on Node.js and Bun
   const { NAME } = env<{ NAME: string }>(c)
   return c.text(NAME)
 })
 ```
 
-Supported Runtimes, Serverless Platforms and Cloud Services:
-
-- Cloudflare Workers
-  - `wrangler.toml`
-  - `wrangler.jsonc`
-- Deno
-  - [`Deno.env`](https://docs.deno.com/runtime/manual/basics/env_variables)
-  - `.env` file
-- Bun
-  - [`Bun.env`](https://bun.com/guides/runtime/set-env)
-  - `process.env`
-- Node.js
-  - `process.env`
-- Vercel
-  - [Environment Variables on Vercel](https://vercel.com/docs/projects/environment-variables)
-- AWS Lambda
-  - [Environment Variables on AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/samples-blank.html#samples-blank-architecture)
-- Lambda@Edge\
-  Environment Variables on Lambda are [not supported](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/add-origin-custom-headers.html) by Lambda@Edge, you need to use [Lambda@Edge event](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/lambda-event-structure.html) as an alternative.
-- Fastly Compute\
-  On Fastly Compute, you can use the ConfigStore to manage user-defined data.
-- Netlify\
-  On Netlify, you can use the [Netlify Contexts](https://docs.netlify.com/site-deploys/overview/#deploy-contexts) to manage user-defined data.
-
 ### Specify the runtime
 
-You can specify the runtime to get environment variables by passing the runtime key as the second argument.
+`env()` reads the runtime itself. Pass the runtime key as the second argument when a host embeds the app and detects it differently, or in a test that fixes the key:
 
 ```ts
 app.get('/env', (c) => {
-  const { NAME } = env<{ NAME: string }>(c, 'workerd')
+  const { NAME } = env<{ NAME: string }>(c, 'node')
   return c.text(NAME)
 })
 ```
@@ -65,23 +40,18 @@ The `getRuntimeKey()` function returns the identifier of the current runtime.
 
 ```ts
 app.get('/', (c) => {
-  if (getRuntimeKey() === 'workerd') {
-    return c.text('You are on Cloudflare')
-  } else if (getRuntimeKey() === 'bun') {
+  if (getRuntimeKey() === 'bun') {
     return c.text('You are on Bun')
   }
-  ...
+  return c.text(`You are on ${getRuntimeKey()}`)
 })
 ```
 
-### Available Runtimes Keys
+### Available runtime keys
 
-Here are the available runtimes keys, unavailable runtime key runtimes may be supported and labeled as `other`, with some being inspired by [WinterCG's Runtime Keys](https://runtime-keys.proposal.wintercg.org/):
+The keys follow [WinterCG's Runtime Keys proposal](https://runtime-keys.proposal.wintercg.org/):
 
-- `workerd` - Cloudflare Workers
-- `deno`
-- `bun`
-- `node`
-- `edge-light` - Vercel Edge Functions
-- `fastly` - Fastly Compute
-- `other` - Other unknown runtimes keys
+- `node` - Node.js, the verified runtime
+- `bun` - Bun, experimental
+- `deno`, `workerd`, `edge-light`, `fastly` - keys the helper still recognizes for a host that embeds an app in that runtime; 1.0 ships no adapter for them (see [Other runtimes](../getting-started/other-runtimes.md))
+- `other` - a runtime the helper does not recognize

package/docs/framework/helpers/conninfo.md

@@ -4,14 +4,7 @@ The ConnInfo Helper helps you to get the connection information. For example, yo
 
 ## Import
 
-Each adapter has its own `getConnInfo`: `acrylblends/node-server`, `acrylblends/cloudflare-workers`, `acrylblends/vercel`, `acrylblends/aws-lambda`, `acrylblends/netlify`, `acrylblends/lambda-edge` and `acrylblends/bun`. The Bun example is not type-checked by the docs tests, which run without Bun's types.
-
-**Cloudflare Workers**
-
-```ts
-import { Acryl } from 'acrylblends'
-import { getConnInfo } from 'acrylblends/cloudflare-workers'
-```
+Each adapter has its own `getConnInfo`: `acrylblends/node-server` and `acrylblends/bun` (experimental).
 
 **Bun**
 
@@ -20,34 +13,6 @@ import { Acryl } from 'acrylblends'
 import { getConnInfo } from 'acrylblends/bun'
 ```
 
-**Vercel**
-
-```ts
-import { Acryl } from 'acrylblends'
-import { getConnInfo } from 'acrylblends/vercel'
-```
-
-**AWS Lambda**
-
-```ts
-import { Acryl } from 'acrylblends'
-import { getConnInfo } from 'acrylblends/aws-lambda'
-```
-
-**Netlify**
-
-```ts
-import { Acryl } from 'acrylblends'
-import { getConnInfo } from 'acrylblends/netlify'
-```
-
-**Lambda@Edge**
-
-```ts
-import { Acryl } from 'acrylblends'
-import { getConnInfo } from 'acrylblends/lambda-edge'
-```
-
 **Node.js**
 
 ```ts

package/docs/framework/helpers/streaming.md

@@ -47,7 +47,7 @@ app.get('/streamText', (c) => {
 
 **Warning.**
 
-If you are developing an application for Cloudflare Workers, streaming may not work well on Wrangler. If so, add `Identity` for `Content-Encoding` header.
+A proxy or a host that compresses the response body can hold a stream back until it ends. If a stream arrives only when it is complete, send `Content-Encoding: Identity` for that route.
 
 ```ts
 app.get('/streamText', (c) => {

package/docs/framework/helpers/websocket.md

@@ -1,18 +1,11 @@
 # WebSocket Helper
 
 WebSocket Helper is a helper for server-side WebSockets in Acryl applications.
-The Node.js, Cloudflare Workers and Bun adapters are available.
+The Node.js and Bun adapters are available.
 
 ## Import
 
-The Node.js adapter (`acrylblends/node-server`), the Cloudflare Workers adapter (`acrylblends/cloudflare-workers`) and the Bun adapter (`acrylblends/bun`) provide `upgradeWebSocket`. The other platforms have no WebSocket support in their adapters. The Bun adapter is checked on Bun in the framework's release check; its examples below are not type-checked by the docs tests, which run without Bun's types.
-
-**Cloudflare Workers**
-
-```ts
-import { Acryl } from 'acrylblends'
-import { upgradeWebSocket } from 'acrylblends/cloudflare-workers'
-```
+The Node.js adapter (`acrylblends/node-server`) and the Bun adapter (`acrylblends/bun`, experimental) provide `upgradeWebSocket`. The other platforms have no adapter in 1.0.
 
 **Bun**
 
@@ -63,7 +56,7 @@ app.get(
 
 Available events:
 
-- `onOpen` - Currently, Cloudflare Workers does not support it.
+- `onOpen`
 - `onMessage`
 - `onClose`
 - `onError`
@@ -103,7 +96,7 @@ See the examples using WebSocket Helper.
 ```ts
 // server.ts
 import { Acryl } from 'acrylblends'
-import { upgradeWebSocket } from 'acrylblends/cloudflare-workers'
+import { upgradeWebSocket } from 'acrylblends/node-server'
 
 const app = new Acryl().get(
   '/ws',

package/docs/framework/middleware/builtin/basic-auth.md

@@ -1,7 +1,7 @@
 # Basic Auth Middleware
 
 This middleware can apply Basic authentication to a specified path.
-Implementing Basic authentication with Cloudflare Workers or other platforms is more complicated than it seems, but with this middleware, it's a breeze.
+Implementing Basic authentication by hand is more complicated than it seems, but with this middleware, it's a breeze.
 
 For more information about how the Basic auth scheme works under the hood, see the [MDN docs](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication#basic_authentication_scheme).
 

package/docs/framework/middleware/builtin/cache.md

@@ -2,11 +2,7 @@
 
 The Cache middleware uses the Web Standards' [Cache API](https://developer.mozilla.org/en-US/docs/Web/API/Cache).
 
-The Cache middleware currently supports Cloudflare Workers projects using custom domains and Deno projects using [Deno 1.26+](https://github.com/denoland/deno/releases/tag/v1.26.0). Also available with Deno Deploy.
-
-Cloudflare Workers respects the `Cache-Control` header and return cached responses. For details, refer to [Cache on Cloudflare Docs](https://developers.cloudflare.com/workers/runtime-apis/cache/). Deno does not respect headers, so if you need to update the cache, you will need to implement your own mechanism.
-
-See [Usage](#usage) below for instructions on each platform.
+It needs a Cache API on the host: the middleware reads `globalThis.caches`. Node.js, the verified runtime, does not provide one, so on Node the middleware is not enabled and says so in one line; a host that embeds an app in a runtime with a Cache API (or provides `globalThis.caches` itself) gets it. `Cache-Control` handling and the QUERY-request cache below are implemented by the middleware, not by the platform.
 
 ## Import
 
@@ -17,28 +13,12 @@ import { cache } from 'acrylblends/cache'
 
 ## Usage
 
-**Cloudflare Workers**
-
-```ts
-app.get(
-  '*',
-  cache({
-    cacheName: 'my-app',
-    cacheControl: 'max-age=3600',
-  })
-)
-```
-
-**Deno**
-
 ```ts
-// Must use `wait: true` for the Deno runtime
 app.get(
   '*',
   cache({
     cacheName: 'my-app',
     cacheControl: 'max-age=3600',
-    wait: true,
   })
 )
 ```
@@ -59,7 +39,7 @@ The name of the cache. Can be used to store multiple caches with different ident
 
 ### *(optional)* wait: `boolean`
 
-A boolean indicating if Acryl should wait for the Promise of the `cache.put` function to resolve before continuing with the request. _Required to be true for the Deno environment_. The default is `false`.
+A boolean indicating if Acryl should wait for the Promise of the `cache.put` function to resolve before continuing with the request. The default is `false`. A runtime whose Cache API only completes a write after the response has finished needs `true`, or the write is dropped.
 
 ### *(optional)* cacheControl: `string`
 

package/docs/framework/middleware/builtin/compress.md

@@ -2,7 +2,7 @@
 
 This middleware compresses the response body, according to `Accept-Encoding` request header.
 
-> **Note.** On Cloudflare Workers and Deno Deploy, the response body will be compressed automatically, so there is no need to use this middleware.
+> **Note.** Node.js and Bun do not compress a response on their own, so this middleware is what compresses it. A host that already compresses at its edge does not need it.
 
 ## Import
 

package/docs/framework/middleware/builtin/context-storage.md

@@ -2,9 +2,7 @@
 
 The Context Storage Middleware stores the Acryl `Context` in the `AsyncLocalStorage`, to make it globally accessible.
 
-> **Note.** This middleware uses `AsyncLocalStorage`. The runtime should support it.
->
-> **Cloudflare Workers**: To enable `AsyncLocalStorage`, add the [`nodejs_compat` or `nodejs_als` flag](https://developers.cloudflare.com/workers/configuration/compatibility-dates/#nodejs-compatibility-flag) to your `wrangler.toml` file.
+> **Note.** This middleware uses `AsyncLocalStorage`. Node.js, the verified runtime, provides it; a host that embeds an app in a runtime without it cannot use this middleware.
 
 ## Import
 
@@ -47,22 +45,20 @@ app.get('/', (c) => {
 })
 ```
 
-On Cloudflare Workers, you can access the bindings outside the handler.
+Anything a handler puts on the context can be read further down the call stack, without passing `c` through every function:
 
 ```ts
-type Env = {
-  Bindings: {
-    KV: KVNamespace
-  }
-}
-
-const app = new Acryl<Env>()
+const app = new Acryl()
 
 app.use(contextStorage())
+app.use(async (c, next) => {
+  c.set('user', 'ada')
+  await next()
+})
 
-const setKV = (value: string) => {
-  return getContext<Env>().env.KV.put('key', value)
-}
+app.get('/', (c) => c.text(`Hello ${getUser()}`))
+
+const getUser = () => getContext().get('user')
 ```
 
 ## tryGetContext

package/docs/framework/middleware/builtin/cors.md

@@ -1,7 +1,6 @@
 # CORS Middleware
 
-There are many use cases of Cloudflare Workers as Web APIs and calling them from external front-end application.
-For them we have to implement CORS, let's do this with middleware as well.
+A web API is often called from a page served by another origin. For that we have to implement CORS, and this middleware does it.
 
 ## Import
 

package/docs/framework/middleware/builtin/ip-restriction.md

@@ -31,7 +31,7 @@ app.use(
 app.get('/', (c) => c.text('Acryl!'))
 ```
 
-Pass the `getConninfo` from the [ConnInfo helper](../../helpers/conninfo.md) appropriate for your environment as the first argument of `ipRestriction`. Every adapter has one (`acrylblends/bun`, `acrylblends/aws-lambda`, `acrylblends/node-server` and the others).
+Pass the `getConninfo` from the [ConnInfo helper](../../helpers/conninfo.md) appropriate for your environment as the first argument of `ipRestriction`. Every adapter has one (`acrylblends/node-server` and `acrylblends/bun`).
 
 ## Rules
 

package/docs/framework/middleware/builtin/jsx-renderer.md

@@ -224,7 +224,7 @@ app.get('/page/info', (c) => {
 
 **Warning.**
 
-You can't use `useRequestContext()` with the Deno's `precompile` JSX option. Use the `react-jsx`:
+You can't use `useRequestContext()` with a JSX option that precompiles the templates ahead of the build. Use `react-jsx`:
 
 ```json
    "compilerOptions": {

package/docs/framework/middleware/builtin/logger.md

@@ -32,7 +32,7 @@ By using the Logger Middleware, you can easily monitor the flow of requests and
 You can also extend the middleware further by providing your own `PrintFunc` function for tailored logging behavior.
 
 > **Tip.**
-> To disable _status code coloring_, you can set a `NO_COLOR` environment variable. This is a common way to disable ANSI color escape codes in logging libraries, and is described at <https://no-color.org/>. Note that Cloudflare Workers do not have a `process.env` object, so will default to plaintext log output.
+> To disable _status code coloring_, you can set a `NO_COLOR` environment variable. This is a common way to disable ANSI color escape codes in logging libraries, and is described at <https://no-color.org/>.
 
 ## PrintFunc
 

package/docs/framework/middleware/builtin/loopback-only.md

@@ -3,7 +3,7 @@
 The guard for a local app's own routes, such as a control API a desktop window calls:
 
 ```ts
-import { loopbackOnly } from 'acryl-router/middleware'
+import { loopbackOnly } from 'acrylblends/loopback-only'
 
 app.use('/control/*', loopbackOnly())
 ```

package/docs/framework/middleware/builtin/mount.md

@@ -29,7 +29,7 @@ app.all('/itty-router/*', mount(ittyRouter.handle))
 
 By default, the mounted application receives a new `Request` with the matched path prefix removed from its URL. A request to `/itty-router/hello` reaches itty-router as `/hello`.
 
-The mounted application is called as `handler(request, c.env, c.executionCtx)`, the same arguments as a Cloudflare Workers `fetch` handler. Use `optionHandler` to pass different arguments.
+The mounted application is called as `handler(request, c.env, c.executionCtx)`, the three arguments a `fetch`-style handler takes. Use `optionHandler` to pass different arguments.
 
 ## Options
 

package/docs/framework/middleware/builtin/request-id.md

@@ -72,23 +72,16 @@ The header name used for the request ID. The default is `X-Request-Id`.
 
 The request ID generation function. By default, it uses `crypto.randomUUID()`.
 
-## Platform specific Request IDs
-
-Some platform (such as AWS Lambda) already generate their own Request IDs per request.
-Without any additional configuration, this middleware is unaware of these specific Request IDs
-and generates a new Request ID. This can lead to confusion when looking at your application logs.
-
-To unify these IDs, use the `generator` function to capture the platform specific Request ID and to use it in this middleware.
-
-### Platform specific links
-
-- AWS Lambda
-  - [AWS documentation: Context object](https://docs.aws.amazon.com/lambda/latest/dg/nodejs-context.html)
-  - Acryl: Access AWS Lambda Object
-- Cloudflare
-  - [Cloudflare Ray ID
-    ](https://developers.cloudflare.com/fundamentals/reference/cloudflare-ray-id/)
-- Deno
-  - [Request ID on the Deno Blog](https://deno.com/blog/zero-config-debugging-deno-opentelemetry#:~:text=s%20automatically%20have-,unique%20request%20IDs,-associated%20with%20them)
-- Fastly
-  - [Fastly documentation: req.xid](https://www.fastly.com/documentation/reference/vcl/variables/client-request/req-xid/)
+## An ID that came from earlier in the chain
+
+A proxy, a load balancer or the host that starts the app may already put a request id on the request.
+Without configuration this middleware is unaware of it and generates a new one, which makes the two logs hard to line up.
+Use the `generator` function to read the incoming one and fall back to a fresh id:
+
+```ts
+app.use(
+  requestId({
+    generator: (c) => c.req.header('X-Request-Id') ?? crypto.randomUUID(),
+  })
+)
+```

package/docs/framework/middleware/builtin/timing.md

@@ -3,8 +3,7 @@
 The [Server-Timing](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Server-Timing) Middleware provides
 performance metrics in the response headers.
 
-> **Note.** On Cloudflare Workers, the timer metrics may not be accurate,
-> since [timers only show the time of last I/O](https://developers.cloudflare.com/workers/learning/security-model/#step-1-disallow-timers-and-multi-threading).
+> **Note.** The metrics come from timers around the handler, so they measure wall-clock time on the host the app runs on.
 
 ## Import
 

package/lib/cordis/door.d.ts

@@ -153,6 +153,11 @@ interface Config {
   tools?: {
     expose?: string[];
   };
+  /**
+   * The door is a development tool: with `NODE_ENV=production` the plugin starts nothing (no route, no `.acryl/` file, no service), and with `ACRYL_DOOR=off` it never does. A host that means to
+   * run it in production (a packaged desktop app whose user drives it with an agent) says so here; `ACRYL_DOOR=off` still wins.
+   */
+  allowInProduction?: boolean;
 }
 declare const Config: z<Config>;
 declare function apply(ctx: Context, rawConfig?: Config): void;

package/lib/cordis/door.js

@@ -1,12 +1,12 @@
 import { t as Acryl } from "../app-BM0rTCp7.js";
 import { n as clientModules } from "../client-modules-CLvWOjbd.js";
 import { MAX_SNAPSHOT_NODES, MAX_WAIT_MS, UiControlError, parseUiRequest } from "../door/protocol.js";
-import { a as INVALID_JSON, c as operatorOnly, d as AuditLog, f as auditPath, i as DOOR_PREFIX, l as privateApi, o as error, p as UiChannel, r as pageChannelRoutes, s as jsonBody, t as renderSnapshot, u as readJson } from "../snapshot-text-yaWlezbd.js";
-import "../src-DNzw0Qsb.js";
+import { a as INVALID_JSON, c as operatorOnly, d as AuditLog, f as auditPath, i as DOOR_PREFIX, l as privateApi, o as error, p as UiChannel, r as pageChannelRoutes, s as jsonBody, t as renderSnapshot, u as readJson } from "../snapshot-text-DmE0YfeZ.js";
+import "../src-2Z4mJg0x.js";
 import { isAbsolute, join, relative, resolve } from "node:path";
-import { randomBytes } from "node:crypto";
 import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import z from "@deepseek-ai/schemastery";
+import { randomBytes } from "node:crypto";
 //#region ../../plugins/acryl-door/src/host/verbs.ts
 /**
 * The one verb list (spec 049 slice 13). Every face of the door reads it: the operator client (`acryl <verb>`, its `verbs` and `brief`),
@@ -696,7 +696,10 @@ const inject = [
 	"appInstance",
 	"nodeServer"
 ];
-const Config = z.object({ tools: z.object({ expose: z.array(z.string().pattern(/^(?!door_)[A-Za-z][A-Za-z0-9_-]{0,63}$/u)).description("App tools (from the tools registry) the door offers; none by default.") }) });
+const Config = z.object({
+	allowInProduction: z.boolean().default(false).description("Run in production too (NODE_ENV=production); ACRYL_DOOR=off still turns it off."),
+	tools: z.object({ expose: z.array(z.string().pattern(/^(?!door_)[A-Za-z][A-Za-z0-9_-]{0,63}$/u)).description("App tools (from the tools registry) the door offers; none by default.") })
+});
 /** The page module, served compiled from source by the app's own TypeScript. */
 const PAGE_DIR = join(import.meta.dirname, import.meta.url.endsWith(".ts") ? "page" : join("..", "src", "page"));
 /** The operator client this build runs: the source next to this file, or the built `cli.js`. */
@@ -719,6 +722,7 @@ function loopbackUrl(url) {
 }
 function apply(ctx, rawConfig = {}) {
 	const config = Config(rawConfig);
+	if (process.env.ACRYL_DOOR === "off" || process.env.NODE_ENV === "production" && config.allowInProduction !== true) return;
 	const app = ctx.get("appInstance");
 	const server = ctx.get("nodeServer");
 	if (typeof app?.root !== "string") throw new Error("acryl-door: the appInstance service has no app folder (root)");

package/lib/cordis/inspect.js

@@ -1,6 +1,6 @@
 import { t as Acryl } from "../app-BM0rTCp7.js";
 import { loopbackOnly } from "../loopback-only.js";
-import "../src-DNzw0Qsb.js";
+import "../src-2Z4mJg0x.js";
 import "../middleware-CPQ8himN.js";
 import { Service } from "@deepseek-ai/cordis";
 //#region ../../plugins/acryl-inspect/src/report.ts

package/lib/cordis/router-http.js

@@ -1,8 +1,8 @@
 import { n as UpgradeEmitter, r as UpgradeHub } from "../test-websocket-ZXHNHQSU.js";
 import "./node-server.js";
-import { pipeline } from "node:stream/promises";
 import { Readable } from "node:stream";
 import { Service } from "@deepseek-ai/cordis";
+import { pipeline } from "node:stream/promises";
 //#region ../../plugins/acryl-router-http/src/bridge.ts
 const FALLBACK_ORIGIN = "http://localhost";
 /** Build the Web `Request` for an incoming message. The body, when the method has one, is streamed, not buffered. */

package/lib/cordis/router.d.ts

@@ -2,7 +2,6 @@ import { B as NotFoundHandler, L as MiddlewareHandler, O as Handler, Q as Valida
 import { c as StatusCode, n as ContentfulStatusCode } from "../http-status-DaAwGAFL.js";
 import { a as getConnInfo, i as connectionOf, n as RouterBindings, r as RouterEnv, t as ConnectionInfo } from "../connection-ZLEso7XL.js";
 import { t as Acryl } from "../app-D8riatvv.js";
-import { n as AppRequest, t as App } from "../deprecated-CTy4N7ng.js";
 import { a as TrailingSlash, i as RouterHttpService, n as MountableApp, o as apply, r as Router, s as name, t as Config } from "../index-D4nVR3wu.js";
 import { t as HTTPException } from "../http-exception-kpGJkmpi.js";
-export { Acryl, type AcrylRequest, App, type AppRequest, Config, type ConnectionInfo, type ContentfulStatusCode, Context, type ContextRenderer, type ContextVariableMap, type Env, type ErrorHandler, type ExecutionContext, HTTPException, type Handler, type Input, type MiddlewareHandler, type MountableApp, type Next, type NotFoundHandler, type NotFoundResponse, Router, type RouterBindings, type RouterEnv, type RouterHttpService, type Schema, type StatusCode, type ToSchema, type TrailingSlash, type TypedResponse, type ValidationTargets, apply, connectionOf, getConnInfo, name };
+export { Acryl, type AcrylRequest, Config, type ConnectionInfo, type ContentfulStatusCode, Context, type ContextRenderer, type ContextVariableMap, type Env, type ErrorHandler, type ExecutionContext, HTTPException, type Handler, type Input, type MiddlewareHandler, type MountableApp, type Next, type NotFoundHandler, type NotFoundResponse, Router, type RouterBindings, type RouterEnv, type RouterHttpService, type Schema, type StatusCode, type ToSchema, type TrailingSlash, type TypedResponse, type ValidationTargets, apply, connectionOf, getConnInfo, name };

package/lib/cordis/router.js

@@ -1,7 +1,6 @@
 import { HTTPException } from "../http-exception.js";
 import { t as Context } from "../context-DDO0cfuP.js";
 import { t as Acryl } from "../app-BM0rTCp7.js";
-import { t as App } from "../deprecated-BP4fPt38.js";
 import { n as getConnInfo, t as connectionOf } from "../connection-C7xgP1hP.js";
-import { i as name, n as Router, r as apply, t as Config } from "../src-DNzw0Qsb.js";
-export { Acryl, App, Config, Context, HTTPException, Router, apply, connectionOf, getConnInfo, name };
+import { i as name, n as Router, r as apply, t as Config } from "../src-2Z4mJg0x.js";
+export { Acryl, Config, Context, HTTPException, Router, apply, connectionOf, getConnInfo, name };

package/lib/cordis/state.js

@@ -3,7 +3,7 @@ import { methodNotAllowed } from "../method-not-allowed.js";
 import { r as streamSSE } from "../streaming-DHST3Scg.js";
 import { loopbackOnly } from "../loopback-only.js";
 import "../helpers-CvTauQT5.js";
-import "../src-DNzw0Qsb.js";
+import "../src-2Z4mJg0x.js";
 import "../middleware-CPQ8himN.js";
 import { Service } from "@deepseek-ai/cordis";
 //#region ../../plugins/acryl-state/src/cell.ts

package/lib/door/host.js

@@ -1,2 +1,2 @@
-import { d as AuditLog, f as auditPath, n as HEARTBEAT_MS, p as UiChannel, r as pageChannelRoutes, t as renderSnapshot } from "../snapshot-text-yaWlezbd.js";
+import { d as AuditLog, f as auditPath, n as HEARTBEAT_MS, p as UiChannel, r as pageChannelRoutes, t as renderSnapshot } from "../snapshot-text-DmE0YfeZ.js";
 export { AuditLog, HEARTBEAT_MS, UiChannel, auditPath, pageChannelRoutes, renderSnapshot };

package/lib/drivers.d.ts

@@ -0,0 +1,66 @@
+//#region ../../plugins/agent-panel/drivers.d.ts
+/**
+ * The drivers the agent panel can offer, in one registry (the `drivers` service the panel provides). A driver is one of two kinds of session:
+ *
+ * - `chat`: a message in, the panel's own events out (`text`, `tool`, `error`). The app's agent, the headless coding agents and a harness chat are chat drivers.
+ * - `terminal`: bytes in, bytes out, a real pseudo-terminal (the `driver-pty` plugin). Nothing is forced to speak bytes.
+ *
+ * This module is `acrylblends/drivers`: the contract a driver plugin writes against, with no dependency on Cordis. The panel lists every registered driver and picks the view by `kind`. A plugin that provides drivers injects `drivers`: with no panel mounted it is pending,
+ * and a panel without such a plugin simply lists none of its drivers.
+ */
+/** One event of a chat run. The panel adds `change` (a plugin was installed or removed) and `done` itself. */
+type ChatEvent = {
+  readonly event: 'text';
+  readonly data: {
+    readonly text: string;
+  };
+} | {
+  readonly event: 'tool';
+  readonly data: Record<string, unknown>;
+} | {
+  readonly event: 'error';
+  readonly data: {
+    readonly message: string;
+  };
+};
+interface ChatDriver {
+  readonly kind: 'chat';
+  readonly name: string;
+  /** Runs one message. Aborting `signal` stops the run. */
+  start(options: {
+    message: string;
+    signal: AbortSignal;
+  }): AsyncIterable<ChatEvent>;
+}
+/** A live pseudo-terminal session. */
+interface TerminalSession {
+  readonly id: string;
+  onData(listener: (chunk: string) => void): () => void;
+  onExit(listener: (code: number | null) => void): () => void;
+  write(data: string): void;
+  resize(cols: number, rows: number): void;
+  /** Resolves when the process (group) is gone. */
+  kill(): Promise<void>;
+}
+interface TerminalDriver {
+  readonly kind: 'terminal';
+  readonly name: string;
+  start(options: {
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    cols: number;
+    rows: number;
+  }): TerminalSession;
+}
+type Driver = ChatDriver | TerminalDriver;
+interface Drivers {
+  /** Add a driver. Returns the function that removes it; a plugin registers inside `ctx.effect` so the driver leaves with it. */
+  register(driver: Driver): () => void;
+  list(): Driver[];
+  get(name: string): Driver | undefined;
+  /** Whether a request may use the drivers' endpoints: it comes from the app's own page and carries the panel's token. */
+  authorized(headers: Headers): boolean;
+}
+declare function createDrivers(authorized?: (headers: Headers) => boolean): Drivers;
+//#endregion
+export { ChatDriver, ChatEvent, Driver, Drivers, TerminalDriver, TerminalSession, createDrivers };

package/lib/drivers.js

@@ -0,0 +1,16 @@
+//#region ../../plugins/agent-panel/drivers.ts
+function createDrivers(authorized = () => true) {
+	const table = /* @__PURE__ */ new Map();
+	return {
+		register(driver) {
+			if (table.has(driver.name)) throw new Error(`driver "${driver.name}" is already registered`);
+			table.set(driver.name, driver);
+			return () => void (table.get(driver.name) === driver && table.delete(driver.name));
+		},
+		list: () => [...table.values()],
+		get: (name) => table.get(name),
+		authorized
+	};
+}
+//#endregion
+export { createDrivers };

package/lib/index.d.ts

@@ -1,5 +1,4 @@
 import { B as NotFoundHandler, L as MiddlewareHandler, O as Handler, Q as ValidationTargets, V as NotFoundResponse, X as ToSchema, Y as Schema, Z as TypedResponse, a as ExecutionContext, j as Input, n as ContextRenderer, r as ContextVariableMap, s as AcrylRequest, t as Context, v as Env, y as ErrorHandler, z as Next } from "./context-DS3fYyG-.js";
 import { t as Acryl } from "./app-D8riatvv.js";
 import { c as InferRequestType, i as ClientRequestOptions, l as InferResponseType } from "./types-zNxyEpG2.js";
-import { n as AppRequest, t as App } from "./deprecated-CTy4N7ng.js";
-export { Acryl, type AcrylRequest, App, type AppRequest, type ClientRequestOptions, Context, type ContextRenderer, type ContextVariableMap, type Env, type ErrorHandler, type ExecutionContext, type Handler, type InferRequestType, type InferResponseType, type Input, type MiddlewareHandler, type Next, type NotFoundHandler, type NotFoundResponse, type Schema, type ToSchema, type TypedResponse, type ValidationTargets };
+export { Acryl, type AcrylRequest, type ClientRequestOptions, Context, type ContextRenderer, type ContextVariableMap, type Env, type ErrorHandler, type ExecutionContext, type Handler, type InferRequestType, type InferResponseType, type Input, type MiddlewareHandler, type Next, type NotFoundHandler, type NotFoundResponse, type Schema, type ToSchema, type TypedResponse, type ValidationTargets };

package/lib/index.js

@@ -1,5 +1,4 @@
 import { t as Context } from "./context-DDO0cfuP.js";
 import { t as Acryl } from "./app-BM0rTCp7.js";
 import "./core-CaY8XDZ6.js";
-import { t as App } from "./deprecated-BP4fPt38.js";
-export { Acryl, App, Context };
+export { Acryl, Context };