acrylblends 0.7.7 → 0.7.8

package/plugins/save/cli.ts

@@ -4,7 +4,7 @@ import { fileURLToPath } from 'node:url'
 import { saveFolder } from './index.ts'
 
 if (process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
-  const appRoot = fileURLToPath(new URL('../../..', import.meta.url))
+  const appRoot = fileURLToPath(new URL('../..', import.meta.url))
   const result = saveFolder(appRoot, process.argv.slice(2).join(' ').trim() || 'save the app')
   if (result.status === 'refused') {
     console.error(`not saved: ${result.reason}`)

package/plugins/save/plugin.json

@@ -8,5 +8,5 @@
     "@deepseek-ai/cordis": "4.0.4",
     "@webboxes/app-persistence": "0.1.1"
   },
-  "mount": "add a script \"save\": \"node src/plugins/save/cli.ts\" to package.json; mount the plugin to give the agent a save_app tool"
+  "mount": "add a script \"save\": \"node plugins/save/cli.ts\" to package.json; mount the plugin to give the agent a save_app tool"
 }

package/shared/AGENTS.core.md

@@ -9,17 +9,17 @@ Start at `docs/framework/README.md`; `api/summary.md` is the one-page summary. R
 `api/context.md` (`c`), `cordis/validation.md` and `guides/validation.md`, `guides/helpers.md` (`streamSSE`), `concepts/middleware.md`, `cordis/plugin-lifecycle.md` (what a plugin
 owns and when it is unloaded), `cordis/mounting.md` and `cordis/node-server.md`. Pages marked "not yet available" describe parts that are not in this app.
 
-The docs write `import { Acryl } from 'acrylblends'` and `from 'acrylblends/<subpath>'`. In this app the framework is the vendored plugin source in `src/plugins/acryl-router/src`
+The docs write `import { Acryl } from 'acrylblends'` and `from 'acrylblends/<subpath>'`. In this app the framework is the vendored plugin source in `plugins/acryl-router/src`
 (read it, do not edit it: a change belongs in ACRYL, upstream), so from a file in `src/` import:
 
-- `./plugins/acryl-router/src/index.ts` for `Acryl`, `Context`, `HTTPException`, `connectionOf`, `getConnInfo` and the types;
-- `./plugins/acryl-router/src/middleware/index.ts` for every middleware (`cors`, `bodyLimit`, `trimTrailingSlash`, `loopbackOnly`, ...);
-- `./plugins/acryl-router/src/helpers/index.ts` for the helpers and validators (`streamSSE`, `schemaValidator`, `validator`, cookies, `testClient`, ...).
-- `./plugins/acryl-router/src/core/jsx/index.ts` for `acrylblends/jsx` (`jsx`, `Fragment`, the types), and `.../core/jsx/streaming.ts` for `acrylblends/jsx/streaming`.
+- `../plugins/acryl-router/src/index.ts` for `Acryl`, `Context`, `HTTPException`, `connectionOf`, `getConnInfo` and the types;
+- `../plugins/acryl-router/src/middleware/index.ts` for every middleware (`cors`, `bodyLimit`, `trimTrailingSlash`, `loopbackOnly`, ...);
+- `../plugins/acryl-router/src/helpers/index.ts` for the helpers and validators (`streamSSE`, `schemaValidator`, `validator`, cookies, `testClient`, ...).
+- `../plugins/acryl-router/src/core/jsx/index.ts` for `acrylblends/jsx` (`jsx`, `Fragment`, the types), and `.../core/jsx/streaming.ts` for `acrylblends/jsx/streaming`.
 
-**JSX: write `.tsx`.** The scripts in `package.json` run Node.js with `--import ./src/plugins/acryl-node-server/src/register.ts`, which compiles `.tsx` files with this app's own `typescript`; `tsconfig.json` sets `jsx: react-jsx` and `jsxImportSource: #acryl-jsx`, which `package.json`'s `imports` maps to the vendored runtime in `src/plugins/acryl-router`. See `src/about.tsx` (blank template) for a page and `test/app.test.ts` for how it is tested. Render a component with `.toString()` and return it with `c.html(...)`; import `jsx`, `Fragment` and the types from `./plugins/acryl-router/src/core/jsx/index.ts` when you need them. A command that starts the app without those scripts (a bare `node src/main.ts`) cannot load a `.tsx` file. Without a build step you can write the call JSX compiles to instead: `jsx('h1', { class: 'title' }, 'Hello')`, children after the props.
+**JSX: write `.tsx`.** The scripts in `package.json` run Node.js with `--import ./plugins/acryl-node-server/src/register.ts`, which compiles `.tsx` files with this app's own `typescript`; `tsconfig.json` sets `jsx: react-jsx` and `jsxImportSource: #acryl-jsx`, which `package.json`'s `imports` maps to the vendored runtime in `plugins/acryl-router`. See `src/about.tsx` (blank template) for a page and `test/app.test.ts` for how it is tested. Render a component with `.toString()` and return it with `c.html(...)`; import `jsx`, `Fragment` and the types from `../plugins/acryl-router/src/core/jsx/index.ts` when you need them. A command that starts the app without those scripts (a bare `node src/main.ts`) cannot load a `.tsx` file. Without a build step you can write the call JSX compiles to instead: `jsx('h1', { class: 'title' }, 'Hello')`, children after the props.
 
-A plugin written into `extensions/` while the app runs may use the docs' own names instead: `acrylblends` and `acrylblends/<subpath>` resolve to the same files. `App` is the
+A plugin written into `plugins/` while the app runs may use the docs' own names instead: `acrylblends` and `acrylblends/<subpath>` resolve to the same files. `App` is the
 deprecated name of `Acryl`.
 
 ## How a feature is built
@@ -28,8 +28,8 @@ Routes are an ordinary `Acryl` app that a plugin mounts once with `ctx.router.ro
 
 ```ts
 import type { Context } from '@deepseek-ai/cordis'
-import { Acryl, HTTPException } from './plugins/acryl-router/src/index.ts'
-import { schemaValidator, type StandardSchema } from './plugins/acryl-router/src/helpers/index.ts'
+import { Acryl, HTTPException } from '../plugins/acryl-router/src/index.ts'
+import { schemaValidator, type StandardSchema } from '../plugins/acryl-router/src/helpers/index.ts'
 
 export const name = 'notes'               // a plugin's name; blend.yaml refers to it
 export const inject = ['router']          // services it needs
@@ -44,7 +44,7 @@ export function apply(ctx: Context) {
 
 - A small route goes on the `App` in `src/routes.ts`. A new feature is a new plugin file: add it to `registry` in `src/app.ts`, add a row
   (`- id: notes` / `name: notes`) to `blend.yaml` before the `acryl-node-server` row, and pass runtime values (a data file) as its config in `createApp`.
-- State, when `src/plugins/acryl-state` exists: `const cell = ctx.state.cell<T>('notes.list', initial)` (add `'state'` to `inject`), then
+- State, when `plugins/acryl-state` exists: `const cell = ctx.state.cell<T>('notes.list', initial)` (add `'state'` to `inject`), then
   `cell.get()`, `cell.set(value)`, `cell.update(fn)` and `cell.subscribe(fn)` (returns the unsubscribe). Every cell is also served as JSON at `/api/state/<key>`
   and streamed at `/api/state/<key>/events`.
 - Test a route without a socket: `await ctx.router.request('/notes')`, or boot the app as `test/app.test.ts` does and use `fetch`.

package/shared/DEFAULTS.md

@@ -0,0 +1,40 @@
+
+## Defaults you can swap
+
+The framework is not rigid. Every choice is a plugin behind a port, and what the app starts with is only a fallback. Name the default before you change it,
+and swap it at the one place that mounts it.
+
+| Choice | Default | To swap it |
+| --- | --- | --- |
+| Records | none until you add one: `npx acrylblends add db` mounts the `db` port on SQLite | mount another provider of `db` in `src/app.ts`; plugins use `ctx.db` and do not change |
+| Small state | none until you add one: `npx acrylblends add kv` mounts the `kv` port on one JSON file | mount `acryl-kv-db` (the same port over `db`) or a provider of your own |
+| Server | Node (`acryl-node-server`) | mount the adapter of another runtime in `src/app.ts` |
+| Window | the browser | `npx acrylblends add desktop` adds an Electron window on the same server |
+
+- **An outside tool** (a database server, a bundler, a router such as Vike) joins the app as a provider: a plugin in `plugins/<name>/` that implements a port and
+  passes that port's conformance tests, then `src/app.ts` mounts it. Postgres is such a provider and is not part of this package; add it when the app needs it.
+- **The dependency rule:** only the file that mounts a provider imports it; everything else takes the port as an argument or injects it. `npx acrylblends check-deps` enforces it.
+
+## Plugins
+
+There is one plugin folder: `plugins/` at the root of the app. A plugin is a folder `plugins/<name>/` with an `index.ts`. `npx acrylblends add <name>` copies a library
+plugin there; a plugin you or an agent write goes there too (the `extensions` plugin installs it into the running app, and `plugins/library.json` lists the copies it must not
+install a second time). Do not create `src/plugins/` or `extensions/`.
+
+## The door
+
+The door is a command in this folder, `.acryl/bin/acryl`, that lets you look at and change the running app; it reaches only the app running from this folder. Its state (a secret and an audit log) lives under `.acryl/`, which git ignores: never commit it. If `.acryl/bin/acryl` is not here, this app has no door yet: run it with its scripts and check it with `npm test`.
+
+```
+.acryl/bin/acryl brief                      what this app is: its plugins, where the docs are, the verbs
+.acryl/bin/acryl look                       a snapshot of the page, with refs (r1, r2, ...)
+.acryl/bin/acryl act click --ref <r>
+.acryl/bin/acryl act type --ref <r> --text <t> [--submit] [--no-clear]
+.acryl/bin/acryl act select --ref <r> --option <o>
+.acryl/bin/acryl act press --key <Enter|Escape|...>
+.acryl/bin/acryl act scroll [--ref <r>] --direction up|down [--amount <n>]
+.acryl/bin/acryl act wait (--text <t> | --role <role> [--name <n>]) [--gone] [--timeout-ms <ms>]
+.acryl/bin/acryl plugin list | add <folder> | remove <name> | reload
+.acryl/bin/acryl tool list | call --tool <name> --args '<json>'
+```
+Every verb takes `--json`. `plugin add plugins/<name>` checks the plugin, installs it and makes it live without a restart. `tool call` reaches only the tools on the door's allowlist (empty by default). On Windows the command is `.acryl\bin\acryl.cmd`.

package/shared/SKILL.md

@@ -0,0 +1,14 @@
+---
+name: app-guide
+description: How to change, run and check the __APP_NAME__ app. Use it before adding a feature, a route, a plugin or a dependency to this app, and before saying the work is done.
+---
+
+# Working in __APP_NAME__
+
+1. **Read first.** `AGENTS.md` in this folder says how the app is laid out. The framework's API is in `docs/framework/`: start at `docs/framework/README.md`, and
+   `docs/framework/api/summary.md` is the one-page summary. Parts the docs mark "not yet available" are not in this app.
+2. **Make the change small.** Your own routes are a plugin (`src/routes.ts`) that builds an `Acryl` app and mounts it; test a route with `await app.request('/path')`.
+3. **One plugin folder.** A plugin lives in `plugins/<name>/` (`npx acrylblends add <name>` copies a library plugin there). There is no `src/plugins/` and no `extensions/`.
+4. **Defaults are swappable.** The database, the key-value store, the server and the window are plugins behind ports. The table "Defaults you can swap" in `AGENTS.md` names each default and where it is swapped. Never reach around a port to a driver: `npx acrylblends check-deps` fails the check.
+5. **Look at the running app.** The door is a command in this folder, `.acryl/bin/acryl`, that lets you look at and change the running app; it reaches only the app running from this folder. Its state (a secret and an audit log) lives under `.acryl/`, which git ignores: never commit it. If `.acryl/bin/acryl` is not here, this app has no door yet: run it with its scripts and check it with `npm test`. Start with `.acryl/bin/acryl brief`, then `look` for the page and `act` to click or type on it; the full list is in `AGENTS.md`.
+6. **Done means checked.** `npm test` passes, and the change shows in the running app after a restart. No secret goes in a file or in `git status`: keys come from environment variables.

package/templates/agent/AGENTS.md

@@ -1,6 +1,6 @@
 
 ## This app (agent)
 
-Besides `src/routes.ts`, the app runs an agent (`POST /ask`) that can write plugins into `extensions/` while the app runs and install them with
+Besides `src/routes.ts`, the app runs an agent (`POST /ask`) that can write plugins into `plugins/` while the app runs and install them with
 rollback; `GET /extensions` and `GET /tasks` show what it did. A plugin there is a folder with an `index.ts` exporting `name`, `inject`, `apply(ctx)`
 and an optional `check(ctx)` that receives the plugin's own context (so `ctx.router` reads as in `apply`). It may import `acryl-router`.

package/templates/agent/README.md

@@ -13,14 +13,14 @@ curl -X POST <url>/ask -H 'content-type: application/json' -d '{"question":"add
 # {"status":"completed","output":"The answer is 5.","steps":2}
 ```
 
-- `src/main.ts` chooses where the app lives (`src/plugins/instance`) and starts it.
+- `src/main.ts` chooses where the app lives (`plugins/instance`) and starts it.
 - `blend.yaml` is the app as data: which plugins it mounts, in what order, with what config and parameters. Switch
   one off with `disabled: true`. `npm run lock` writes `blend.lock.json`: the manifest's digest and a digest of
   every plugin folder, so a diff of the lock shows what changed.
 - `src/app.ts` holds the registry of plugins the code provides, and mounts the manifest's rows.
-- `src/plugins/agent` is the offline agent: a scripted model, a tool registry, memory, and one child fiber per run.
-- `src/plugins/extensions` installs, updates and removes plugins while the app runs; a failed update keeps the previous
-  version running. `src/plugins/builder` gives the agent tools to do that itself, writing into `extensions/`.
+- `plugins/agent` is the offline agent: a scripted model, a tool registry, memory, and one child fiber per run.
+- `plugins/extensions` installs, updates and removes plugins while the app runs; a failed update keeps the previous
+  version running. `plugins/builder` gives the agent tools to do that itself, writing into `plugins/`.
 
 Give it a real model and it builds any Cordis plugin you describe (any OpenAI-compatible API; nothing is installed):
 
@@ -40,9 +40,9 @@ curl <url>/tasks              # every run as a durable task, with the tool calls
 ```
 
 Other commands: `update route <name> <path> <text>`, `break plugin <name>` (shows the rollback), `remove plugin <name>`,
-`list plugins`. What the agent writes lands in `extensions/`, is part of your app, and starts again at the next start.
+`list plugins`. What the agent writes lands in `plugins/`, is part of your app, and starts again at the next start.
 - `src/routes.ts` is your own plugin: it builds an `App` (`import { App } from './plugins/acryl-router/src/index.ts'`) and mounts it with `ctx.router.route(prefix, app)`. Routes added to the app after it is mounted are not served. A page mounted at `/x` answers `/x`, not `/x/` (trailing slashes are strict). The router API is documented at https://acrylblends.github.io/docs/framework/the-acryl-framework and in `docs/framework` of the acrylblends repository.
-- `src/plugins/` holds the plugins copied from the ACRYLBLENDS library. They are yours now; edit them freely.
+- `plugins/` holds the plugins copied from the ACRYLBLENDS library. They are yours now; edit them freely.
   Add more with `acrylblends add <plugin>`.
 
 `npm run save -- "message"` commits the app with git (and pushes when it has a remote). It refuses a file that looks like

package/templates/agent/gitignore

@@ -1,2 +1,3 @@
 node_modules/
 .acrylblends/
+.acryl/

package/templates/agent/package.json

@@ -4,20 +4,20 @@
   "private": true,
   "type": "module",
   "imports": {
-    "#acryl-jsx/jsx-runtime": "./src/plugins/acryl-router/src/core/jsx/jsx-runtime.ts",
-    "#acryl-jsx/jsx-dev-runtime": "./src/plugins/acryl-router/src/core/jsx/jsx-dev-runtime.ts"
+    "#acryl-jsx/jsx-runtime": "./plugins/acryl-router/src/core/jsx/jsx-runtime.ts",
+    "#acryl-jsx/jsx-dev-runtime": "./plugins/acryl-router/src/core/jsx/jsx-dev-runtime.ts"
   },
   "engines": {
     "node": ">=22.19.0"
   },
   "scripts": {
-    "start": "node --import ./src/plugins/acryl-node-server/src/register.ts src/main.ts",
-    "dev": "node --watch --import ./src/plugins/acryl-node-server/src/register.ts src/main.ts",
-    "test": "node --import ./src/plugins/acryl-node-server/src/register.ts --test \"test/**/*.test.{ts,tsx}\"",
+    "start": "node --import ./plugins/acryl-node-server/src/register.ts src/main.ts",
+    "dev": "node --watch --import ./plugins/acryl-node-server/src/register.ts src/main.ts",
+    "test": "node --import ./plugins/acryl-node-server/src/register.ts --test \"test/**/*.test.{ts,tsx}\"",
     "check": "tsc --noEmit",
-    "lock": "node src/plugins/manifest/lock.ts",
-    "save": "node src/plugins/save/cli.ts",
-    "upgrade": "node src/plugins/manifest/upgrade-cli.ts"
+    "lock": "node plugins/manifest/lock.ts",
+    "save": "node plugins/save/cli.ts",
+    "upgrade": "node plugins/manifest/upgrade-cli.ts"
   },
   "dependencies": {
     "typescript": "6.0.3"

package/templates/agent/src/app.ts

@@ -1,23 +1,24 @@
+import { existsSync } from 'node:fs'
 import { join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { Context, type Fiber } from '@deepseek-ai/cordis'
-import * as nodeServer from './plugins/acryl-node-server/src/index.ts'
-import * as router from './plugins/acryl-router/src/index.ts'
-import * as state from './plugins/acryl-state/src/index.ts'
-import { agent, memory, model, tools } from './plugins/agent/index.ts'
-import { builder } from './plugins/builder/index.ts'
-import { extensions } from './plugins/extensions/index.ts'
-import { type AppInstance, instance } from './plugins/instance/index.ts'
+import * as nodeServer from '../plugins/acryl-node-server/src/index.ts'
+import * as router from '../plugins/acryl-router/src/index.ts'
+import * as state from '../plugins/acryl-state/src/index.ts'
+import { agent, memory, model, tools } from '../plugins/agent/index.ts'
+import { builder } from '../plugins/builder/index.ts'
+import { extensions } from '../plugins/extensions/index.ts'
+import { type AppInstance, instance } from '../plugins/instance/index.ts'
 import {
   blueprintsIn,
   compose,
   loadManifest,
   type ParameterValue,
-} from './plugins/manifest/index.ts'
-import { type OpenAIConfig, openai } from './plugins/openai/index.ts'
-import { sandboxPlugin } from './plugins/sandbox/index.ts'
-import { save } from './plugins/save/index.ts'
-import { tasks } from './plugins/tasks/index.ts'
+} from '../plugins/manifest/index.ts'
+import { type OpenAIConfig, openai } from '../plugins/openai/index.ts'
+import { sandboxPlugin } from '../plugins/sandbox/index.ts'
+import { save } from '../plugins/save/index.ts'
+import { tasks } from '../plugins/tasks/index.ts'
 import { routes } from './routes.ts'
 
 /** The plugins this app's code provides. `blend.yaml` chooses, orders and configures them. */
@@ -59,7 +60,7 @@ export interface App {
 }
 
 /**
- * The app: `instance` first (where it lives, chosen at run time), then the manifest's rows in order. The app's own `extensions/`
+ * The app: `instance` first (where it lives, chosen at run time), then the manifest's rows in order. The app's `plugins/`
  * folder is trusted to install at start, and is where the builder writes.
  */
 export async function createApp(
@@ -71,7 +72,14 @@ export async function createApp(
   } = {},
 ): Promise<App> {
   const manifest = readManifest(options.values)
-  const extensionsDir = join(chosen.root, 'extensions')
+  const extensionsDir = join(chosen.root, 'plugins')
+  // One release of grace: an app made before 0.7.8 kept what the agent wrote in `extensions/`. It is still installed, with a warning.
+  const legacyDir = join(chosen.root, 'extensions')
+  const legacy = existsSync(legacyDir)
+  if (legacy)
+    console.warn(
+      'warning: extensions/ is the old folder for plugins the agent writes; move them to plugins/ ("git mv extensions/<name> plugins/<name>"). extensions/ is read for this release only.',
+    )
   const root = new Context()
   const first = root.plugin(instance, chosen)
   await first.await()
@@ -83,7 +91,12 @@ export async function createApp(
       // Runtime values the manifest cannot hold: the manifest's own digest (every task records it), and who may install.
       tasks: { manifest: `sha256:${manifest.digest}` },
       // The `approval` parameter in blend.yaml (the extensions row) turns this source into one that asks.
-      extensions: { sources: [{ dir: extensionsDir, trust: 'install' }] },
+      extensions: {
+        sources: [
+          { dir: extensionsDir, trust: 'install' },
+          ...(legacy ? [{ dir: legacyDir, trust: 'install' as const }] : []),
+        ],
+      },
       builder: { dir: extensionsDir },
       server: { port: chosen.port.start, scan: chosen.port.scan ? 20 : 0, hostname: chosen.host },
     })),

package/templates/agent/src/main.ts

@@ -1,7 +1,7 @@
 import { fileURLToPath } from 'node:url'
+import { selectInstance } from '../plugins/instance/index.ts'
+import { modelConfigFrom } from '../plugins/openai/index.ts'
 import { createApp } from './app.ts'
-import { selectInstance } from './plugins/instance/index.ts'
-import { modelConfigFrom } from './plugins/openai/index.ts'
 import { APP_NAME } from './routes.ts'
 
 // The composition root: the one place that reads the environment. selectInstance chooses where the app lives;

package/templates/agent/src/routes.ts

@@ -1,9 +1,9 @@
 import type { Context } from '@deepseek-ai/cordis'
-import { Acryl } from './plugins/acryl-router/src/index.ts'
-import { bodyLimit } from './plugins/acryl-router/src/middleware/index.ts'
-import type {} from './plugins/agent/index.ts'
-import type {} from './plugins/extensions/index.ts'
-import type {} from './plugins/tasks/index.ts'
+import { Acryl } from '../plugins/acryl-router/src/index.ts'
+import { bodyLimit } from '../plugins/acryl-router/src/middleware/index.ts'
+import type {} from '../plugins/agent/index.ts'
+import type {} from '../plugins/extensions/index.ts'
+import type {} from '../plugins/tasks/index.ts'
 
 export const APP_NAME = '__APP_NAME__'
 

package/templates/agent/test/agent.test.ts

@@ -4,8 +4,8 @@ import { tmpdir } from 'node:os'
 import { join } from 'node:path'
 import { test } from 'node:test'
 import { fileURLToPath } from 'node:url'
+import { pinnedInstance, withPort } from '../plugins/instance/index.ts'
 import { type App, createApp } from '../src/app.ts'
-import { pinnedInstance, withPort } from '../src/plugins/instance/index.ts'
 
 const projectRoot = fileURLToPath(new URL('..', import.meta.url))
 

package/templates/agent/test/app.test.ts

@@ -4,8 +4,8 @@ import { tmpdir } from 'node:os'
 import { join } from 'node:path'
 import { test } from 'node:test'
 import { fileURLToPath } from 'node:url'
+import { pinnedInstance, withPort } from '../plugins/instance/index.ts'
 import { type App, createApp } from '../src/app.ts'
-import { pinnedInstance, withPort } from '../src/plugins/instance/index.ts'
 import { APP_NAME } from '../src/routes.ts'
 
 const projectRoot = fileURLToPath(new URL('..', import.meta.url))

package/templates/agent/test/builder.test.ts

@@ -3,8 +3,8 @@ import { mkdtemp, rm } from 'node:fs/promises'
 import { tmpdir } from 'node:os'
 import { join } from 'node:path'
 import { test } from 'node:test'
+import { pinnedInstance, withPort } from '../plugins/instance/index.ts'
 import { createApp } from '../src/app.ts'
-import { pinnedInstance, withPort } from '../src/plugins/instance/index.ts'
 
 /** The agent extends the running app through POST /ask; a restart keeps what it built. */
 test('the agent builds, updates, protects and removes a plugin in the running app, and a restart keeps it', async () => {

package/templates/agent/test/model.test.ts

@@ -5,8 +5,8 @@ import type { AddressInfo } from 'node:net'
 import { tmpdir } from 'node:os'
 import { join } from 'node:path'
 import { test } from 'node:test'
+import { pinnedInstance, withPort } from '../plugins/instance/index.ts'
 import { createApp } from '../src/app.ts'
-import { pinnedInstance, withPort } from '../src/plugins/instance/index.ts'
 
 /** A plugin no scripted command knows: the model writes it from scratch. */
 const COUNTER = `import type { Context } from '@deepseek-ai/cordis'

package/templates/agent/tsconfig.json

@@ -13,58 +13,56 @@
     "skipLibCheck": true,
     "types": ["node"],
     "paths": {
-      "acrylblends": ["./src/plugins/acryl-router/src/index.ts"],
-      "acrylblends/conninfo": ["./src/plugins/acryl-router/src/index.ts"],
-      "acrylblends/http-exception": ["./src/plugins/acryl-router/src/index.ts"],
-      "acrylblends/types": ["./src/plugins/acryl-router/src/index.ts"],
-      "acrylblends/client": ["./src/plugins/acryl-router/src/client.ts"],
-      "acrylblends/basic-auth": ["./src/plugins/acryl-router/src/middleware/index.ts"],
-      "acrylblends/bearer-auth": ["./src/plugins/acryl-router/src/middleware/index.ts"],
-      "acrylblends/body-limit": ["./src/plugins/acryl-router/src/middleware/index.ts"],
-      "acrylblends/combine": ["./src/plugins/acryl-router/src/middleware/index.ts"],
-      "acrylblends/compress": ["./src/plugins/acryl-router/src/middleware/index.ts"],
-      "acrylblends/context-storage": ["./src/plugins/acryl-router/src/middleware/index.ts"],
-      "acrylblends/cors": ["./src/plugins/acryl-router/src/middleware/index.ts"],
-      "acrylblends/csrf": ["./src/plugins/acryl-router/src/middleware/index.ts"],
-      "acrylblends/etag": ["./src/plugins/acryl-router/src/middleware/index.ts"],
-      "acrylblends/ip-restriction": ["./src/plugins/acryl-router/src/middleware/index.ts"],
-      "acrylblends/jwk": ["./src/plugins/acryl-router/src/middleware/index.ts"],
-      "acrylblends/jwt": ["./src/plugins/acryl-router/src/middleware/index.ts"],
-      "acrylblends/language": ["./src/plugins/acryl-router/src/middleware/index.ts"],
-      "acrylblends/logger": ["./src/plugins/acryl-router/src/middleware/index.ts"],
-      "acrylblends/loopback-only": ["./src/plugins/acryl-router/src/middleware/index.ts"],
-      "acrylblends/method-not-allowed": ["./src/plugins/acryl-router/src/middleware/index.ts"],
-      "acrylblends/method-override": ["./src/plugins/acryl-router/src/middleware/index.ts"],
-      "acrylblends/powered-by": ["./src/plugins/acryl-router/src/middleware/index.ts"],
-      "acrylblends/pretty-json": ["./src/plugins/acryl-router/src/middleware/index.ts"],
-      "acrylblends/request-id": ["./src/plugins/acryl-router/src/middleware/index.ts"],
-      "acrylblends/secure-headers": ["./src/plugins/acryl-router/src/middleware/index.ts"],
-      "acrylblends/serve-static": ["./src/plugins/acryl-router/src/middleware/index.ts"],
-      "acrylblends/timeout": ["./src/plugins/acryl-router/src/middleware/index.ts"],
-      "acrylblends/timing": ["./src/plugins/acryl-router/src/middleware/index.ts"],
-      "acrylblends/trailing-slash": ["./src/plugins/acryl-router/src/middleware/index.ts"],
-      "acrylblends/accepts": ["./src/plugins/acryl-router/src/helpers/index.ts"],
-      "acrylblends/cookie": ["./src/plugins/acryl-router/src/helpers/index.ts"],
-      "acrylblends/factory": ["./src/plugins/acryl-router/src/helpers/index.ts"],
-      "acrylblends/html": ["./src/plugins/acryl-router/src/helpers/index.ts"],
-      "acrylblends/route": ["./src/plugins/acryl-router/src/helpers/index.ts"],
-      "acrylblends/schema-validator": ["./src/plugins/acryl-router/src/helpers/index.ts"],
-      "acrylblends/streaming": ["./src/plugins/acryl-router/src/helpers/index.ts"],
-      "acrylblends/testing": ["./src/plugins/acryl-router/src/helpers/index.ts"],
-      "acrylblends/validator": ["./src/plugins/acryl-router/src/helpers/index.ts"],
-      "acrylblends/ws": ["./src/plugins/acryl-router/src/helpers/index.ts"],
-      "acryl-router": ["./src/plugins/acryl-router/src/index.ts"],
-      "acryl-router/middleware": ["./src/plugins/acryl-router/src/middleware/index.ts"],
-      "acryl-router/helpers": ["./src/plugins/acryl-router/src/helpers/index.ts"],
-      "acrylblends/jsx": ["./src/plugins/acryl-router/src/core/jsx/index.ts"],
-      "acrylblends/jsx/jsx-runtime": ["./src/plugins/acryl-router/src/core/jsx/jsx-runtime.ts"],
-      "acrylblends/jsx/jsx-dev-runtime": [
-        "./src/plugins/acryl-router/src/core/jsx/jsx-dev-runtime.ts"
-      ],
-      "acrylblends/jsx/streaming": ["./src/plugins/acryl-router/src/core/jsx/streaming.ts"]
+      "acrylblends": ["./plugins/acryl-router/src/index.ts"],
+      "acrylblends/conninfo": ["./plugins/acryl-router/src/index.ts"],
+      "acrylblends/http-exception": ["./plugins/acryl-router/src/index.ts"],
+      "acrylblends/types": ["./plugins/acryl-router/src/index.ts"],
+      "acrylblends/client": ["./plugins/acryl-router/src/client.ts"],
+      "acrylblends/basic-auth": ["./plugins/acryl-router/src/middleware/index.ts"],
+      "acrylblends/bearer-auth": ["./plugins/acryl-router/src/middleware/index.ts"],
+      "acrylblends/body-limit": ["./plugins/acryl-router/src/middleware/index.ts"],
+      "acrylblends/combine": ["./plugins/acryl-router/src/middleware/index.ts"],
+      "acrylblends/compress": ["./plugins/acryl-router/src/middleware/index.ts"],
+      "acrylblends/context-storage": ["./plugins/acryl-router/src/middleware/index.ts"],
+      "acrylblends/cors": ["./plugins/acryl-router/src/middleware/index.ts"],
+      "acrylblends/csrf": ["./plugins/acryl-router/src/middleware/index.ts"],
+      "acrylblends/etag": ["./plugins/acryl-router/src/middleware/index.ts"],
+      "acrylblends/ip-restriction": ["./plugins/acryl-router/src/middleware/index.ts"],
+      "acrylblends/jwk": ["./plugins/acryl-router/src/middleware/index.ts"],
+      "acrylblends/jwt": ["./plugins/acryl-router/src/middleware/index.ts"],
+      "acrylblends/language": ["./plugins/acryl-router/src/middleware/index.ts"],
+      "acrylblends/logger": ["./plugins/acryl-router/src/middleware/index.ts"],
+      "acrylblends/loopback-only": ["./plugins/acryl-router/src/middleware/index.ts"],
+      "acrylblends/method-not-allowed": ["./plugins/acryl-router/src/middleware/index.ts"],
+      "acrylblends/method-override": ["./plugins/acryl-router/src/middleware/index.ts"],
+      "acrylblends/powered-by": ["./plugins/acryl-router/src/middleware/index.ts"],
+      "acrylblends/pretty-json": ["./plugins/acryl-router/src/middleware/index.ts"],
+      "acrylblends/request-id": ["./plugins/acryl-router/src/middleware/index.ts"],
+      "acrylblends/secure-headers": ["./plugins/acryl-router/src/middleware/index.ts"],
+      "acrylblends/serve-static": ["./plugins/acryl-router/src/middleware/index.ts"],
+      "acrylblends/timeout": ["./plugins/acryl-router/src/middleware/index.ts"],
+      "acrylblends/timing": ["./plugins/acryl-router/src/middleware/index.ts"],
+      "acrylblends/trailing-slash": ["./plugins/acryl-router/src/middleware/index.ts"],
+      "acrylblends/accepts": ["./plugins/acryl-router/src/helpers/index.ts"],
+      "acrylblends/cookie": ["./plugins/acryl-router/src/helpers/index.ts"],
+      "acrylblends/factory": ["./plugins/acryl-router/src/helpers/index.ts"],
+      "acrylblends/html": ["./plugins/acryl-router/src/helpers/index.ts"],
+      "acrylblends/route": ["./plugins/acryl-router/src/helpers/index.ts"],
+      "acrylblends/schema-validator": ["./plugins/acryl-router/src/helpers/index.ts"],
+      "acrylblends/streaming": ["./plugins/acryl-router/src/helpers/index.ts"],
+      "acrylblends/testing": ["./plugins/acryl-router/src/helpers/index.ts"],
+      "acrylblends/validator": ["./plugins/acryl-router/src/helpers/index.ts"],
+      "acrylblends/ws": ["./plugins/acryl-router/src/helpers/index.ts"],
+      "acryl-router": ["./plugins/acryl-router/src/index.ts"],
+      "acryl-router/middleware": ["./plugins/acryl-router/src/middleware/index.ts"],
+      "acryl-router/helpers": ["./plugins/acryl-router/src/helpers/index.ts"],
+      "acrylblends/jsx": ["./plugins/acryl-router/src/core/jsx/index.ts"],
+      "acrylblends/jsx/jsx-runtime": ["./plugins/acryl-router/src/core/jsx/jsx-runtime.ts"],
+      "acrylblends/jsx/jsx-dev-runtime": ["./plugins/acryl-router/src/core/jsx/jsx-dev-runtime.ts"],
+      "acrylblends/jsx/streaming": ["./plugins/acryl-router/src/core/jsx/streaming.ts"]
     },
     "jsx": "react-jsx",
     "jsxImportSource": "#acryl-jsx"
   },
-  "include": ["src", "test", "extensions"]
+  "include": ["src", "test", "plugins"]
 }

package/templates/blank/AGENTS.md

@@ -2,4 +2,4 @@
 ## This app (blank)
 
 `src/routes.ts` is the app's own plugin: add routes to its `App`. `blend.yaml` lists the plugins that are mounted. `acrylblends add <plugin>` copies
-another library plugin (for example `acryl-state`) into `src/plugins/`.
+another library plugin (for example `acryl-state`) into `plugins/`.

package/templates/blank/README.md

@@ -10,13 +10,13 @@ npm test
 npm run check      # type-check
 ```
 
-- `src/main.ts` chooses where the app lives (`src/plugins/instance`) and starts it.
+- `src/main.ts` chooses where the app lives (`plugins/instance`) and starts it.
 - `blend.yaml` is the app as data: which plugins it mounts, in what order, with what config and parameters. Switch
   one off with `disabled: true`. `npm run lock` writes `blend.lock.json`: the manifest's digest and a digest of
   every plugin folder, so a diff of the lock shows what changed.
 - `src/app.ts` holds the registry of plugins the code provides, and mounts the manifest's rows.
 - `src/routes.ts` is your own plugin: it builds an `App` (`import { App } from './plugins/acryl-router/src/index.ts'`) and mounts it with `ctx.router.route(prefix, app)`. Routes added to the app after it is mounted are not served. A page mounted at `/x` answers `/x`, not `/x/` (trailing slashes are strict). The router API is documented at https://acrylblends.github.io/docs/framework/the-acryl-framework and in `docs/framework` of the acrylblends repository.
-- `src/plugins/` holds the plugins copied from the ACRYLBLENDS library. They are yours now; edit them freely.
+- `plugins/` holds the plugins copied from the ACRYLBLENDS library. They are yours now; edit them freely.
   Add more with `acrylblends add <plugin>`.
 
 `npm run save -- "message"` commits the app with git (and pushes when it has a remote). It refuses a file that looks like

package/templates/blank/gitignore

@@ -1,2 +1,3 @@
 node_modules/
 .acrylblends/
+.acryl/

package/templates/blank/package.json

@@ -4,20 +4,20 @@
   "private": true,
   "type": "module",
   "imports": {
-    "#acryl-jsx/jsx-runtime": "./src/plugins/acryl-router/src/core/jsx/jsx-runtime.ts",
-    "#acryl-jsx/jsx-dev-runtime": "./src/plugins/acryl-router/src/core/jsx/jsx-dev-runtime.ts"
+    "#acryl-jsx/jsx-runtime": "./plugins/acryl-router/src/core/jsx/jsx-runtime.ts",
+    "#acryl-jsx/jsx-dev-runtime": "./plugins/acryl-router/src/core/jsx/jsx-dev-runtime.ts"
   },
   "engines": {
     "node": ">=22.19.0"
   },
   "scripts": {
-    "start": "node --import ./src/plugins/acryl-node-server/src/register.ts src/main.ts",
-    "dev": "node --watch --import ./src/plugins/acryl-node-server/src/register.ts src/main.ts",
-    "test": "node --import ./src/plugins/acryl-node-server/src/register.ts --test \"test/**/*.test.{ts,tsx}\"",
+    "start": "node --import ./plugins/acryl-node-server/src/register.ts src/main.ts",
+    "dev": "node --watch --import ./plugins/acryl-node-server/src/register.ts src/main.ts",
+    "test": "node --import ./plugins/acryl-node-server/src/register.ts --test \"test/**/*.test.{ts,tsx}\"",
     "check": "tsc --noEmit",
-    "lock": "node src/plugins/manifest/lock.ts",
-    "save": "node src/plugins/save/cli.ts",
-    "upgrade": "node src/plugins/manifest/upgrade-cli.ts"
+    "lock": "node plugins/manifest/lock.ts",
+    "save": "node plugins/save/cli.ts",
+    "upgrade": "node plugins/manifest/upgrade-cli.ts"
   },
   "dependencies": {
     "typescript": "6.0.3"

package/templates/blank/src/about.tsx

@@ -1,8 +1,8 @@
-/** A page written in JSX: the scripts in package.json run Node.js with the vendored register hook (src/plugins/acryl-node-server/src/register.ts), which compiles .tsx with this app's own typescript. */
+/** A page written in JSX: the scripts in package.json run Node.js with the vendored register hook (plugins/acryl-node-server/src/register.ts), which compiles .tsx with this app's own typescript. */
 const About = () => (
   <main>
     <h1>About</h1>
-    <p>Rendered on the server with the JSX runtime in src/plugins/acryl-router.</p>
+    <p>Rendered on the server with the JSX runtime in plugins/acryl-router.</p>
   </main>
 )
 

package/templates/blank/src/app.ts

@@ -1,15 +1,15 @@
 import { join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { Context, type Fiber } from '@deepseek-ai/cordis'
-import * as nodeServer from './plugins/acryl-node-server/src/index.ts'
-import * as router from './plugins/acryl-router/src/index.ts'
-import { type AppInstance, instance } from './plugins/instance/index.ts'
+import * as nodeServer from '../plugins/acryl-node-server/src/index.ts'
+import * as router from '../plugins/acryl-router/src/index.ts'
+import { type AppInstance, instance } from '../plugins/instance/index.ts'
 import {
   blueprintsIn,
   compose,
   loadManifest,
   type ParameterValue,
-} from './plugins/manifest/index.ts'
+} from '../plugins/manifest/index.ts'
 import { routes } from './routes.ts'
 
 /** The plugins this app's code provides. `blend.yaml` chooses, orders and configures them. */

package/templates/blank/src/main.ts

@@ -1,6 +1,6 @@
 import { fileURLToPath } from 'node:url'
+import { selectInstance } from '../plugins/instance/index.ts'
 import { createApp } from './app.ts'
-import { selectInstance } from './plugins/instance/index.ts'
 import { APP_NAME } from './routes.ts'
 
 // The composition root: the one place that reads the environment (through selectInstance) and chooses where the app lives.

package/templates/blank/src/routes.ts

@@ -1,6 +1,6 @@
 import type { Context } from '@deepseek-ai/cordis'
+import { Acryl } from '../plugins/acryl-router/src/index.ts'
 import { aboutPage } from './about.tsx'
-import { Acryl } from './plugins/acryl-router/src/index.ts'
 
 export const APP_NAME = '__APP_NAME__'
 

package/templates/blank/test/app.test.ts

@@ -4,8 +4,8 @@ import { tmpdir } from 'node:os'
 import { join } from 'node:path'
 import { test } from 'node:test'
 import { fileURLToPath } from 'node:url'
+import { pinnedInstance, withPort } from '../plugins/instance/index.ts'
 import { type App, createApp } from '../src/app.ts'
-import { pinnedInstance, withPort } from '../src/plugins/instance/index.ts'
 import { APP_NAME } from '../src/routes.ts'
 
 const projectRoot = fileURLToPath(new URL('..', import.meta.url))

package/templates/blank/tsconfig.json

@@ -15,5 +15,5 @@
     "jsx": "react-jsx",
     "jsxImportSource": "#acryl-jsx"
   },
-  "include": ["src", "test"]
+  "include": ["src", "test", "plugins"]
 }