@quickback-dev/cli 0.16.0 → 0.16.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/docs/content.d.ts.map +1 -1
- package/dist/docs/content.js +9 -4
- package/dist/docs/content.js.map +1 -1
- package/dist/index.js +1 -1
- package/dist/skill/docs/changelog.md +98 -0
- package/dist/skill/docs/compiler/definitions/access.md +1 -1
- package/dist/skill/docs/compiler/targets/hono-api/using-the-api/errors.md +84 -2
- package/dist/skill/docs/stack/auth/plugins/agent-auth.md +131 -0
- package/dist/skill/docs/stack/realtime/partyserver-rooms.md +10 -2
- package/package.json +1 -1
- package/src/skill/docs/changelog.md +98 -0
- package/src/skill/docs/compiler/definitions/access.md +1 -1
- package/src/skill/docs/compiler/targets/hono-api/using-the-api/errors.md +84 -2
- package/src/skill/docs/stack/auth/plugins/agent-auth.md +131 -0
- package/src/skill/docs/stack/realtime/partyserver-rooms.md +10 -2
package/dist/docs/content.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"content.js","sourceRoot":"","sources":["../../src/docs/content.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"content.js","sourceRoot":"","sources":["../../src/docs/content.ts"],"names":[],"mappings":"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"}
|
package/dist/index.js
CHANGED
|
@@ -4,6 +4,104 @@ Release notes for the Quickback compiler, CLI, and platform.
|
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
+
## v0.16.1 — May 9, 2026
|
|
8
|
+
|
|
9
|
+
### Cloudflare ASSETS canonicalization — worker SPA emits no longer 307-loop
|
|
10
|
+
|
|
11
|
+
Cloudflare's static-assets binding canonicalizes any request for `/<dir>/index.html` into a 307 redirect to `/<dir>/` (the default `html_handling=auto-trailing-slash`). When a worker subrequest issues `c.env.ASSETS.fetch(new Request(new URL('/<dir>/index.html', …)))`, the binding returns the 307; the worker forwards it; the browser re-requests `/<dir>/`; the same SPA-fallback handler (or hostname middleware) catches the directory request and re-fetches `/<dir>/index.html`. Infinite loop. Caught by AttendVIP writing custom `/admin/` and `/m/` host-routing patches on the deployed worker — the fix in their patches was switching to `/admin/` (trailing slash, no `index.html`), which Cloudflare resolves to the directory's `index.html` content with a 200.
|
|
12
|
+
|
|
13
|
+
The compiler had the same bug baked into every emit point. `cloudflare.ts` now fetches `/<dir>/` everywhere it previously asked for `/<dir>/index.html`: CMS hostname middleware, `/cms/*` SPA catchall, apex `/` handler, account/admin hostname middleware, `/account/*` SPA catchall, and the multi-domain catchall. Eight regression tests in `cf-assets-canonicalization-spa-fallback.test.ts` pin every emit so a future copy/paste can't sneak the literal back in.
|
|
14
|
+
|
|
15
|
+
### `account.customLogin` — drop a project-branded sign-in page in front of the SPA
|
|
16
|
+
|
|
17
|
+
A new `account: { customLogin: true }` flag emits an explicit `app.get('/account/login', …)` route that serves a project-supplied static page instead of letting the bundled Account SPA's client router handle the path. Drop the page at `quickback/public/account/login/index.html` (a *directory*, not a bare `login.html` — see the canonicalization note above) and the existing `quickback/public/` passthrough copies it into the asset binding. The route is registered before the `/account/*` SPA catch-all so the static handler wins; everything else under `/account/...` (profile, organizations, devices, …) keeps going through the React SPA. Same surface AttendVIP was hand-patching post-compile — promoting the flag means the next compile no longer wipes their override. Default `false`.
|
|
18
|
+
|
|
19
|
+
### Project-level realtime auto-broadcasts every resource by default
|
|
20
|
+
|
|
21
|
+
`dbConfig.realtime: true` now treats every resource as realtime-enabled unless its `realtime` block explicitly opts out. The previous behavior set `effectiveResourceRealtime` to `undefined` when a resource didn't declare its own block — so a project that flipped the project-level flag still had to add per-table `realtime: { enabled: true }` everywhere to actually get auto-broadcasts. Caught against AttendVIP after the v0.15.x auto-broadcast wiring landed but didn't fire. New default: project-level on with no per-resource override = `{ enabled: true }`. Per-resource `realtime: { enabled: false }` still wins.
|
|
22
|
+
|
|
23
|
+
### Drizzle metadata gets a DO NOT EDIT header + journal drift warning
|
|
24
|
+
|
|
25
|
+
Two changes that protect the drizzle plumbing from quiet corruption.
|
|
26
|
+
|
|
27
|
+
`compile-runner.ts:addJsonHeader` now stamps drizzle's generated JSON (`_journal.json`, `<n>_snapshot.json`) with a `$__quickback_warning__$` key explaining the file is regenerated by the compiler and should not be edited by hand. The disclaimer matches the one already on `.ts` outputs — the journal had been the one drizzle file users felt entitled to "tidy up" because nothing in it said otherwise.
|
|
28
|
+
|
|
29
|
+
A new check in the same module compares the journal entry count against the snapshot file count. drizzle-kit only produces one snapshot per `generate` run, so `journal.entries.length > snapshots + 1` means the journal claims migrations the snapshot side has lost (typical cause: a manual delete of an `<n>_snapshot.json` that left the journal entry behind). The compiler logs a warning and lists the orphan entries. Detected directly out of AttendVIP's `Travel 500` triage — drizzle-kit was diffing against a stale `0002_snapshot.json` and emitting bogus full `CREATE TABLE` migrations for tables that had been added in subsequent (now-orphaned) journal entries.
|
|
30
|
+
|
|
31
|
+
### Two new compile-time validators (LOUD failures over silent traps)
|
|
32
|
+
|
|
33
|
+
**`AUTHENTICATED` + tenant-scoped firewall now refuses to compile.** `pseudo-role-validator.ts` rejects any access tree that admits `AUTHENTICATED` on a resource whose firewall scopes by `organizationId`. The combination is the silent-empty trap: a sign-in-only caller with no active org passes the role gate, the firewall WHERE clause filters every row out, and the API returns `[]` with a 200. The error message names three valid resolutions — drop the org scope (`firewall: { exception: true }`), tighten the role to `USER` or a role with implied org membership, or split the route into a token-auth branch and an org-membership branch.
|
|
34
|
+
|
|
35
|
+
**`createRealtime` imports without `dbConfig.realtime: true` now throw.** Project lib + action + feature-lib files are scanned at compile time for `import { createRealtime }` (and the equivalent named binding). When the project hasn't enabled realtime, the compile fails with the offending file paths and remediation: either enable `dbConfig.realtime: true` so the runtime helper exists, or remove the import. Caught against AttendVIP — three handler files (`broadcastAnnouncement.ts`, `declineActivityForGuest.ts`, `applyRsvp.ts`) imported `createRealtime` after the v0.15 auto-broadcast wiring landed, but their config never set `realtime: true`. The Worker compiled, deployed, and 500'd at first call. The user's framing was "config should be the source of truth" — this validator enforces that. Five regression tests in `realtime-import-without-config-rejected.test.ts`.
|
|
36
|
+
|
|
37
|
+
### Fixes
|
|
38
|
+
|
|
39
|
+
**1. `SYSADMIN` was missing from the per-feature standalone gate's `allowsWithoutOrg` set.** The standalone-action wrapper skips its `if (!ctx.activeOrgId)` gate for any access tree referencing a pseudo-role (`PUBLIC`, `AUTHENTICATED`, `USER`, `ADMIN`) — but `SYSADMIN`, the v0.15.0 fifth marker, was missing from the matcher. Sysadmin actions on `cms.sysadmin: true` projects were 403'ing on cross-tenant calls (sysadmins have no member rows, so `ctx.activeOrgId` is unset by design). The matcher now includes `SYSADMIN`.
|
|
40
|
+
|
|
41
|
+
**2. Apex `/` and `/account/login` get fallback redirects when neither CMS nor Account SPA is bundled.** Projects that opt out of both bundled SPAs still receive traffic at `/` (no apex handler, 404) and `/account/login` (no Account fallback, 404). Setting `auth.loginUrl` to an external sign-in host now activates two compiler-emitted redirects so those natural inbound URLs land somewhere useful: `/account/login → loginUrl?redirect=…` (preserves the bounce param) and `/ → loginUrl` (or `/account` when the Account SPA is bundled). Both opt in via `auth.loginUrl !== '/account/login'` so projects using the built-in `/account/login` keep the existing SPA-fallback behavior unchanged.
|
|
42
|
+
|
|
43
|
+
**3. Record-based action URLs are now kebab-case to match OpenAPI.** `record-based.ts` was emitting URL paths from the camelCase action name (e.g. `/api/v1/widgets/:id/sendInvite`) while OpenAPI emit produced `/widgets/:id/send-invite`. Admin tooling and SDK consumers reading the OpenAPI spec hit 404s on every multi-word action. URL paths and OpenAPI emit now share a `urlPath = toKebabCase(urlSegment)` helper. Identifiers in audit `actionName`, error messages, and console logs stay camel — those are programmatic surfaces and breaking them would churn audit logs. Same fix shape as the v0.15.0 standalone-action URL casing.
|
|
44
|
+
|
|
45
|
+
### Notes
|
|
46
|
+
|
|
47
|
+
Test coverage: 1175 → 1183 (+8 across the canonicalization, customLogin, and createRealtime regression files). Verified end-to-end against AttendVIP — `quickback compile` produces a worker whose `/account/login`, hostname-routed account/admin SPAs, and apex / handler all return 200 with the right SPA shell on the deployed Cloudflare worker, no 307 loops.
|
|
48
|
+
|
|
49
|
+
The bundled docs (`packages/claude-skill/docs/changelog.md`, `packages/cli/src/skill/docs/changelog.md`) and the CLI's `packages/cli/src/docs/content.ts` are regenerated by `scripts/bundle-docs.ts` — run that before publishing the CLI bump.
|
|
50
|
+
|
|
51
|
+
---
|
|
52
|
+
|
|
53
|
+
## v0.16.0 — May 9, 2026
|
|
54
|
+
|
|
55
|
+
### Agent Auth Protocol — first-class agent identity for AI callers
|
|
56
|
+
|
|
57
|
+
Quickback now ships a server implementation of the [Agent Auth Protocol](https://agentauthprotocol.com) by way of `@better-auth/agent-auth`. Opt in with `auth.plugins.agentAuth: true` (or the array form `plugins: ["agentAuth"]`). When enabled, the compiler emits a complete agent-auth surface: discovery at `/.well-known/agent-configuration`, capability projection from the project's OpenAPI spec, a device-authorization approval page in the Account SPA at `/agents/approve`, and the four agent-auth tables (`agent`, `agentHost`, `agentCapabilityGrant`, `approvalRequest`) added to the auth schema automatically by `auth generate`.
|
|
58
|
+
|
|
59
|
+
**OpenAPI capability projection runs by default.** The compiler emits `src/lib/openapi-spec.ts` (the project's full OpenAPI spec inlined as a const) and wires `createFromOpenAPI(openapiSpec, { ... })` into the `agentAuth(...)` call. Every operation with an `operationId` becomes an agent capability. Default `approvalStrength` map: `GET → "session"`, `POST/PUT/PATCH/DELETE → "webauthn"`. Default `defaultHostCapabilities`: `["GET", "HEAD"]`.
|
|
60
|
+
|
|
61
|
+
The proxy `onExecute` makes a self-fetch to the worker's own URL with a Better Auth JWT minted for `agentSession.user.id`, so the inner request hits the existing JWT fast-path, populates `ctx`, and the full firewall + access + masking pipeline runs on the proxied call. No new middleware code, no parallel security path — agent capability calls go through the same gates as regular REST traffic. The cost is one Cloudflare subrequest per capability call (~50ms); fine for typical agent traffic. Opt out of OpenAPI projection with `agentAuth: { fromOpenAPI: false }` and wire `capabilities` + `onExecute` by hand.
|
|
62
|
+
|
|
63
|
+
The Account SPA gains `/agents/approve` (`packages/account/app/routes/agents.approve.tsx`) — modeled on the existing `/cli/authorize` device-code page. Pastes the user code, fetches the pending request, lists the requested capabilities with a "Step-up" badge on any capability whose `approvalStrength` is `"webauthn"`, then approves or denies. WebAuthn step-up itself is a placeholder for v0.16.0 — the upstream agent-auth API for the escalation call is still settling, so capabilities tagged `"webauthn"` will fail server-side until that lands. The badge tells the user what's coming.
|
|
64
|
+
|
|
65
|
+
### Bearer-only on `/mcp` and the agent-auth surface
|
|
66
|
+
|
|
67
|
+
`/mcp` now forwards **only** `Authorization: Bearer …` into the inner `app.request()` re-entry. Cookie + `x-api-key` forwarding has been removed. The MCP surface is server-to-server by nature — there are no browser callers, no CSRF surface to defend, and no benefit to fragmenting the auth model across three header conventions. Three Bearer flavors all land on the same header, resolved by the inner Hono middleware chain:
|
|
68
|
+
|
|
69
|
+
- Better Auth session token via the official `bearer` plugin
|
|
70
|
+
- OAuth access token via the OAuth Provider plugin
|
|
71
|
+
- Agent JWT via `@better-auth/agent-auth`
|
|
72
|
+
|
|
73
|
+
If a project still wants API-key auth here, configure the `apiKey` plugin to accept its key via `Authorization: Bearer` so everything stays one channel. The existing `mcp-server.test.ts` regression seal flips from "forwards Cookie + x-api-key" to "forwards only Authorization (bearer-only surface)".
|
|
74
|
+
|
|
75
|
+
### Auth DSL: `bearer`, `oauthProvider`, `agentAuth` are now first-class plugin entries
|
|
76
|
+
|
|
77
|
+
Both the array-form union and the `BetterAuthPlugins` interface in `apps/compiler/src/define/auth.ts` gain `"bearer"`, `"oauthProvider"`, and `"agentAuth"`. `bearer` was previously in the runtime registry but missing from the TS type, so callsites had to use `as any` or `// @ts-expect-error` to set it. Both are gone now. New typed options interfaces — `OAuthProviderOptions` (audience, login/consent paths, dynamic registration) and `AgentAuthOptions` (providerName, providerDescription, modes, fromOpenAPI, approvalStrength, defaultHostCapabilities) — let users override defaults through the object form.
|
|
78
|
+
|
|
79
|
+
Auto-enable rule lives in the canonical `computeAutoAddedPlugins` (`generators/auth.ts`): turning on `agentAuth` force-adds `bearer` + `oauthProvider`. There is no useful agent-auth deployment without those two — surfacing it as auto-add rather than a confusing "missing dependency" runtime error matches the existing pattern (`oauthProvider` already auto-adds `jwt`).
|
|
80
|
+
|
|
81
|
+
### `queue-consumer.ts` now emitted for `additionalQueues` too
|
|
82
|
+
|
|
83
|
+
Prior to this release, the queue consumer emit gated on `embeddingFeatures.length > 0 || queueHandlers.length > 0`. Projects that declared queue infrastructure via `dbConfig.additionalQueues` but had no embeddings + no `services/queues/*` handlers shipped a `wrangler.toml` with `[[queues.consumers]]` entries pointing at a missing worker `queue` export. The CLI's archive-restore step kept a stale `queue-consumer.ts` around, so the file appeared "stuck" across compiles — same class of bug as the v0.15.0 services/queues/* regression caught against AttendVIP, just one source removed.
|
|
84
|
+
|
|
85
|
+
The gate is now a three-way OR: `hasEmbeddings || hasQueueHandlers || hasAdditionalQueues`. When only `additionalQueues` is set, the compiler emits a stub `queue-consumer.ts` whose `queue` export acks every message with a warning — Cloudflare needs an export for every consumer binding, and a noisy-but-correct stub beats a silent deploy break. `MainAppOptions` and `CloudflareMainAppOptions` gain `hasAdditionalQueues`; `generateQueueImport` and `generateCloudflareExport` mirror the new gate. Regression test: `src/__tests__/queue-additional-queues-gate.test.ts`.
|
|
86
|
+
|
|
87
|
+
### Fixes
|
|
88
|
+
|
|
89
|
+
**1. `bearer` was missing from the `BetterAuthPlugins` TypeScript interface.** The runtime plugin registry has had `bearer` since the pre-1.0 cuts, but `apps/compiler/src/define/auth.ts` never declared it on the typed shape — so any `quickback.config.ts` using `plugins: { bearer: true }` had to `as any`-cast or sit behind a `@ts-expect-error`. Both `bearer` and `oauthProvider` (same gap, same workaround) are now first-class typed entries; `agentAuth` joins them. The array-form union also gains all three. No behavior change at runtime; existing casts can come out.
|
|
90
|
+
|
|
91
|
+
**2. MCP `buildInternalRequest` no longer forwards Cookie or `x-api-key`.** The MCP surface is server-to-server — there are no browser callers, no CSRF surface to defend, and no benefit to fragmenting the auth model across three header conventions. The inner `app.request()` re-entry now forwards only `Authorization: Bearer …`. Three Bearer flavors all land on the same header (BA session token via the `bearer` plugin, OAuth access token via OAuth Provider, agent JWT via `@better-auth/agent-auth`). Existing `mcp-server.test.ts` regression flipped from "forwards Cookie + x-api-key" to "forwards only Authorization (bearer-only surface)".
|
|
92
|
+
|
|
93
|
+
**3. `agentAuth` now auto-enables `bearer` + `oauthProvider`.** There is no useful agent-auth deployment without those two — the agent surface is bearer-only and MCP clients need OAuth to register. Auto-enable lives in the canonical `computeAutoAddedPlugins` (`generators/auth.ts`), so it propagates to every consumer (better-auth generator, schema generation, package-deps emission). Same pattern as the existing `oauthProvider` → `jwt` rule. Surfaced in `agent-auth.test.ts` with a regression seal that asserts both plugins land in the merged plugin list whether the user wrote the array form or the object form.
|
|
94
|
+
|
|
95
|
+
**4. `OpenAPISpec` literal type rejected by tsc on inlined spec.** Quickback's OpenAPI emit produces `$ref`-style parameter entries (`{ "$ref": "#/components/parameters/X" }`) that the agent-auth plugin's stricter `OpenAPIParameter` type doesn't model — `tsc` fails the generated project with "Type … is not assignable to OpenAPIParameter". The plugin handles refs correctly at runtime; only the structural narrowing on the TS literal needed help. The generated `agentAuth({ ...createFromOpenAPI(openapiSpec as any, { ... }) })` call now carries an `as any` cast on the spec with an inline comment explaining why. Drop when upstream models `$ref` parameters.
|
|
96
|
+
|
|
97
|
+
### Notes
|
|
98
|
+
|
|
99
|
+
`@better-auth/agent-auth` 0.4.5 ships ESM-only exports without a `require` condition, so the Better Auth CLI's `auth generate` step (jiti / CJS resolver) bails with `ERR_PACKAGE_PATH_NOT_EXPORTED`. The compiler image patches the package's `package.json` at install time to add a matching `require` condition pointing at the same dist file (Node 22+ supports `require(esm)`). Remove the patch in `apps/compiler/Dockerfile` when upstream ships proper exports.
|
|
100
|
+
|
|
101
|
+
Test coverage: 1136 → 1152 (+11 `agent-auth.test.ts`, +5 `queue-additional-queues-gate.test.ts`). Verified end-to-end against `examples/recruitment` with `agentAuth` enabled — `quickback compile` produces a project whose `npm run build` typechecks clean and whose generated schema includes all four agent-auth tables (`agent`, `agentHost`, `agentCapabilityGrant`, `approvalRequest`).
|
|
102
|
+
|
|
103
|
+
---
|
|
104
|
+
|
|
7
105
|
## v0.15.0 — May 7, 2026
|
|
8
106
|
|
|
9
107
|
### Sysadmin tier — cross-tenant DB-admin role for the CMS
|
|
@@ -286,7 +286,7 @@ type FieldCondition =
|
|
|
286
286
|
|
|
287
287
|
Beyond Better Auth roles (org membership, user-table role) and pseudo-roles, Quickback supports **relationship-based authorization roles** — names that bind to a declared relationship between the caller and a resource. Use these when access should follow a domain-table membership ("user is a confirmed guest of this event") rather than an org/admin gate.
|
|
288
288
|
|
|
289
|
-
### `authz.relationships`
|
|
289
|
+
### `authz.relationships`
|
|
290
290
|
|
|
291
291
|
Declare relationships once in `quickback.config.ts`:
|
|
292
292
|
|
|
@@ -17,7 +17,7 @@ The generated API returns structured error responses with consistent fields acro
|
|
|
17
17
|
|
|
18
18
|
## Error Response Format
|
|
19
19
|
|
|
20
|
-
All errors use a flat structure with contextual fields:
|
|
20
|
+
All errors use a flat structure with contextual fields. Every structured error response also carries a `request` block with the HTTP method, URL, request ID, and a redacted+truncated copy of the request body — enough to triage or hand the response to an LLM agent without grepping logs:
|
|
21
21
|
|
|
22
22
|
```json
|
|
23
23
|
{
|
|
@@ -28,7 +28,13 @@ All errors use a flat structure with contextual fields:
|
|
|
28
28
|
"required": ["hiring-manager"],
|
|
29
29
|
"current": ["interviewer"]
|
|
30
30
|
},
|
|
31
|
-
"hint": "Contact an administrator to grant necessary permissions"
|
|
31
|
+
"hint": "Contact an administrator to grant necessary permissions",
|
|
32
|
+
"request": {
|
|
33
|
+
"method": "POST",
|
|
34
|
+
"url": "/api/v1/candidates/cnd_01H.../advance",
|
|
35
|
+
"body": "{\"stage\":\"offer\"}",
|
|
36
|
+
"requestId": "0c4f2c9e-..."
|
|
37
|
+
}
|
|
32
38
|
}
|
|
33
39
|
```
|
|
34
40
|
|
|
@@ -39,6 +45,7 @@ All errors use a flat structure with contextual fields:
|
|
|
39
45
|
| `code` | string | Machine-readable error code |
|
|
40
46
|
| `details` | object | Layer-specific context (optional) |
|
|
41
47
|
| `hint` | string | Actionable guidance for resolution (optional) |
|
|
48
|
+
| `request` | object | Method, URL, redacted body, and request ID. Auto-attached by the runtime so the error body is self-contained — bodies are capped at 4 KB and well-known sensitive keys (`password`, `token`, `secret`, `apiKey`, `otp`, `code`, `authorization`, …) are replaced with `"[REDACTED]"` |
|
|
42
49
|
|
|
43
50
|
## Errors by Security Layer
|
|
44
51
|
|
|
@@ -222,3 +229,78 @@ Batch operations can return:
|
|
|
222
229
|
| `BATCH_SIZE_EXCEEDED` | Too many records in a single request |
|
|
223
230
|
| `BATCH_ATOMIC_FAILED` | Atomic batch failed, all changes rolled back |
|
|
224
231
|
| `BATCH_MISSING_IDS` | Batch update/delete missing required IDs |
|
|
232
|
+
|
|
233
|
+
## Action Failures (500)
|
|
234
|
+
|
|
235
|
+
When an action's `execute()` body throws something that isn't a known
|
|
236
|
+
transition / state / FK / constraint failure (e.g. a `TypeError`, a
|
|
237
|
+
fetch timeout, a third-party API error), the route returns
|
|
238
|
+
`ACTION_EXECUTION_FAILED`. The body forwards as much of the underlying
|
|
239
|
+
error as is safe to expose: error class name, message, cause-chain
|
|
240
|
+
message, and the top three stack frames with absolute paths sanitized
|
|
241
|
+
to basename + line number.
|
|
242
|
+
|
|
243
|
+
```json
|
|
244
|
+
{
|
|
245
|
+
"error": "Cannot read properties of undefined (reading 'getXmlFragment')",
|
|
246
|
+
"layer": "action",
|
|
247
|
+
"code": "ACTION_EXECUTION_FAILED",
|
|
248
|
+
"details": {
|
|
249
|
+
"name": "TypeError",
|
|
250
|
+
"frames": [
|
|
251
|
+
"at updateContent (notebooks.ts:142:31)",
|
|
252
|
+
"at execute (actions.ts:88:7)"
|
|
253
|
+
]
|
|
254
|
+
},
|
|
255
|
+
"hint": "The action handler threw an unhandled error. Check server logs for the underlying cause.",
|
|
256
|
+
"request": {
|
|
257
|
+
"method": "POST",
|
|
258
|
+
"url": "/api/v1/notebooks/nb_123/updateContent",
|
|
259
|
+
"body": "{\"content\":\"...\"}",
|
|
260
|
+
"requestId": "0c4f2c9e-..."
|
|
261
|
+
}
|
|
262
|
+
}
|
|
263
|
+
```
|
|
264
|
+
|
|
265
|
+
## Internal Errors (500)
|
|
266
|
+
|
|
267
|
+
Uncaught throws that escape every route handler land in the global
|
|
268
|
+
`onError` and return `INTERNAL_ERROR`. The body carries the same
|
|
269
|
+
underlying-error context as `ACTION_EXECUTION_FAILED`: `name`, `cause`,
|
|
270
|
+
sanitized `frames`, and the request block.
|
|
271
|
+
|
|
272
|
+
```json
|
|
273
|
+
{
|
|
274
|
+
"error": "Connection terminated unexpectedly",
|
|
275
|
+
"layer": "database",
|
|
276
|
+
"code": "INTERNAL_ERROR",
|
|
277
|
+
"details": {
|
|
278
|
+
"name": "Error",
|
|
279
|
+
"cause": "ECONNRESET",
|
|
280
|
+
"frames": ["at query (db.ts:54:12)"]
|
|
281
|
+
},
|
|
282
|
+
"hint": "Uncaught error during request handling. Look up the requestId in server logs for the full stack trace, or set EXPOSE_ERROR_STACK=1 to include it inline.",
|
|
283
|
+
"requestId": "0c4f2c9e-...",
|
|
284
|
+
"request": {
|
|
285
|
+
"method": "GET",
|
|
286
|
+
"url": "/api/v1/jobs",
|
|
287
|
+
"requestId": "0c4f2c9e-..."
|
|
288
|
+
}
|
|
289
|
+
}
|
|
290
|
+
```
|
|
291
|
+
|
|
292
|
+
### Exposing the full stack
|
|
293
|
+
|
|
294
|
+
By default the response body only carries the top three sanitized
|
|
295
|
+
frames — full stack traces stay server-side so the worker bundle's
|
|
296
|
+
on-disk layout doesn't leak to API clients. To include the full stack
|
|
297
|
+
in the response (useful in dev / staging), set `EXPOSE_ERROR_STACK=1`
|
|
298
|
+
on the worker (`wrangler.toml` `[vars]`, or `wrangler secret put`):
|
|
299
|
+
|
|
300
|
+
```toml
|
|
301
|
+
[vars]
|
|
302
|
+
EXPOSE_ERROR_STACK = "1"
|
|
303
|
+
```
|
|
304
|
+
|
|
305
|
+
When set, both the global 500 and `ACTION_EXECUTION_FAILED` bodies
|
|
306
|
+
gain a `details.stack` field with the unsanitized stack trace.
|
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
# Agent Auth Plugin
|
|
2
|
+
|
|
3
|
+
`@better-auth/agent-auth` is the official server implementation of the [Agent Auth Protocol](https://agentauthprotocol.com). When you enable it, your Quickback worker becomes an Agent Auth provider: AI agents can register, request scoped capability grants from a real user, get approved through device-authorization or CIBA, and then call your API with short-lived signed JWTs.
|
|
4
|
+
|
|
5
|
+
> The upstream `@better-auth/agent-auth` package is in heavy development and not yet stable. The Quickback integration pins a specific version and exposes a deliberately small surface for v1 — see "Limitations" at the bottom.
|
|
6
|
+
|
|
7
|
+
|
|
8
|
+
## What gets enabled
|
|
9
|
+
|
|
10
|
+
Adding `agentAuth` to your auth config force-enables two more plugins:
|
|
11
|
+
|
|
12
|
+
| Plugin | Why |
|
|
13
|
+
|--------|-----|
|
|
14
|
+
| `bearer` | Lets clients send Better Auth session tokens via `Authorization: Bearer …` instead of cookies. The agent surface is bearer-only. |
|
|
15
|
+
| `oauthProvider` | OAuth 2.1 + OIDC provider so MCP clients can register, get tokens, and call your API as a real user. Replaces the deprecated `mcp` plugin. |
|
|
16
|
+
|
|
17
|
+
There's no useful Agent Auth deployment without these — the compiler auto-adds them so you don't trip over a confusing runtime error.
|
|
18
|
+
|
|
19
|
+
The full Bearer matrix on the agent surface (everything reached through `/mcp` and the agent-auth REST projection):
|
|
20
|
+
|
|
21
|
+
| Bearer flavor | Resolved by | Identity |
|
|
22
|
+
|---------------|-------------|----------|
|
|
23
|
+
| BA session token | `bearer` plugin | The signed-in user |
|
|
24
|
+
| OAuth access token | `oauthProvider` plugin | The user who consented at OAuth time |
|
|
25
|
+
| Agent JWT | `@better-auth/agent-auth` | The agent (acting on behalf of its bound user) |
|
|
26
|
+
|
|
27
|
+
Cookie auth is **not** forwarded into `/mcp` — bearer is the only channel, and CSRF surface is zero.
|
|
28
|
+
|
|
29
|
+
## Configuration
|
|
30
|
+
|
|
31
|
+
```ts
|
|
32
|
+
import { defineAuth, defineConfig, defineDatabase, defineRuntime } from "@quickback/compiler";
|
|
33
|
+
|
|
34
|
+
export default defineConfig({
|
|
35
|
+
name: "acme-api",
|
|
36
|
+
providers: {
|
|
37
|
+
runtime: defineRuntime("cloudflare"),
|
|
38
|
+
database: defineDatabase("cloudflare-d1"),
|
|
39
|
+
auth: defineAuth("better-auth", {
|
|
40
|
+
emailAndPassword: { enabled: true },
|
|
41
|
+
plugins: {
|
|
42
|
+
agentAuth: {
|
|
43
|
+
providerName: "Acme",
|
|
44
|
+
providerDescription: "Acme APIs for AI agents.",
|
|
45
|
+
modes: ["delegated", "autonomous"],
|
|
46
|
+
defaultHostCapabilities: ["GET", "HEAD"],
|
|
47
|
+
},
|
|
48
|
+
},
|
|
49
|
+
}),
|
|
50
|
+
},
|
|
51
|
+
});
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
The plain-flag form is also valid — use it when you don't need to override any defaults:
|
|
55
|
+
|
|
56
|
+
```ts
|
|
57
|
+
auth: defineAuth("better-auth", {
|
|
58
|
+
plugins: ["agentAuth"],
|
|
59
|
+
})
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
### Options
|
|
63
|
+
|
|
64
|
+
| Option | Type | Default | Notes |
|
|
65
|
+
|--------|------|---------|-------|
|
|
66
|
+
| `providerName` | `string` | `env.APP_NAME` | Shown in the discovery doc and in the approval UI. |
|
|
67
|
+
| `providerDescription` | `string` | `"Agent-callable API powered by Quickback."` | Free-form description in `/.well-known/agent-configuration`. |
|
|
68
|
+
| `modes` | `("delegated" \| "autonomous")[]` | `["delegated", "autonomous"]` | Supported agent modes. |
|
|
69
|
+
| `defaultHostCapabilities` | `string[]` \| `true` | `["GET", "HEAD"]` | Capabilities auto-granted to a newly registered host. |
|
|
70
|
+
|
|
71
|
+
Most of the underlying plugin's surface (capability list, `onExecute`, custom approval-method resolver, `onEvent` audit hook) isn't projected through the compiler in v1 — see "Limitations".
|
|
72
|
+
|
|
73
|
+
## Routes
|
|
74
|
+
|
|
75
|
+
When the plugin is enabled the compiler emits:
|
|
76
|
+
|
|
77
|
+
- `GET /.well-known/agent-configuration` — discovery document with issuer, endpoints, supported modes, default location.
|
|
78
|
+
- All of the plugin's own endpoints, mounted by Better Auth under `/auth/v1/agent/*`.
|
|
79
|
+
|
|
80
|
+
The Account SPA gets a new route at `/agents/approve` for device-code approval. The plugin's `deviceAuthorizationPage` is automatically pinned at `${ACCOUNT_URL}/agents/approve`.
|
|
81
|
+
|
|
82
|
+
## Approval flow
|
|
83
|
+
|
|
84
|
+
1. The agent calls `/auth/v1/agent/register` to create itself, then requests a capability grant.
|
|
85
|
+
2. The user enters the device code at `${ACCOUNT_URL}/agents/approve` (or follows the deep-link the agent showed them).
|
|
86
|
+
3. The Account SPA fetches the pending request, shows the agent name + provider name + the capabilities being requested, with a "Step-up" badge on any capability whose `approvalStrength` is `"webauthn"`.
|
|
87
|
+
4. User clicks **Authorize** (or **Deny**). Approval grants the capabilities; denial leaves the request pending.
|
|
88
|
+
5. The agent polls or receives the token via the configured method, then calls capabilities with `Authorization: Bearer <agent-jwt>`.
|
|
89
|
+
|
|
90
|
+
You revoke an agent at any time from your account settings (or directly via the BA admin API).
|
|
91
|
+
|
|
92
|
+
## Schema
|
|
93
|
+
|
|
94
|
+
The plugin adds tables for `agent`, `host`, `grant`, and `approval`. They're created automatically by `auth migrate` / `auth generate` — no manual Drizzle work needed.
|
|
95
|
+
|
|
96
|
+
## OpenAPI capability projection (default on)
|
|
97
|
+
|
|
98
|
+
When `agentAuth` is enabled, the compiler emits `src/lib/openapi-spec.ts` (the project's full OpenAPI spec inlined as a const) and wires `createFromOpenAPI(openapiSpec, { ... })` into the `agentAuth(...)` call. Every operation with an `operationId` becomes a capability. No manual capability list required.
|
|
99
|
+
|
|
100
|
+
**How requests flow:**
|
|
101
|
+
|
|
102
|
+
1. Agent calls `POST /capability/execute` with its agent JWT.
|
|
103
|
+
2. The plugin verifies JWT + grant + constraints, then runs `onExecute`.
|
|
104
|
+
3. `onExecute` (the plugin's built-in proxy) makes a self-fetch to the worker's own URL (`env.BETTER_AUTH_URL`).
|
|
105
|
+
4. `resolveHeaders` mints a Better Auth JWT with `sub: agentSession.user.id` so the inner request looks like an authenticated user call.
|
|
106
|
+
5. The worker's JWT fast-path picks it up, populates `ctx`, and the full firewall + access + masking pipeline runs.
|
|
107
|
+
|
|
108
|
+
**Default approval strength:** GET → `"session"`, POST/PUT/PATCH/DELETE → `"webauthn"`. Override with the `approvalStrength` option.
|
|
109
|
+
|
|
110
|
+
**To opt out** and wire capabilities by hand:
|
|
111
|
+
|
|
112
|
+
```ts
|
|
113
|
+
auth: defineAuth("better-auth", {
|
|
114
|
+
plugins: {
|
|
115
|
+
agentAuth: { fromOpenAPI: false },
|
|
116
|
+
},
|
|
117
|
+
})
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
When `fromOpenAPI: false`, the emitted call has `capabilities: []` and no proxy — you write the capability list + `onExecute` in your own `lib/auth.ts` overrides.
|
|
121
|
+
|
|
122
|
+
## Limitations (v1)
|
|
123
|
+
|
|
124
|
+
- **WebAuthn step-up isn't wired in the approval UI yet.** Capabilities tagged `approvalStrength: "webauthn"` show a Step-up badge but the actual escalation call isn't made — the upstream API for that escalation is still settling. Until it lands, those capabilities will fail server-side regardless of approval.
|
|
125
|
+
- **No CLI helpers for listing / revoking agents.** Use the BA admin API directly.
|
|
126
|
+
- **Self-fetch on Cloudflare Workers** adds one subrequest per capability call (~50ms). For typical agent traffic this is fine; for very high-frequency agents consider pinning a custom `onExecute` that uses `app.request()` for in-process routing.
|
|
127
|
+
- **`@better-auth/agent-auth` 0.4.5 ships ESM-only exports** without a `require` condition. The compiler image patches the package's `package.json` at install time so the Better Auth CLI's `auth generate` step (jiti / CJS) can resolve it. Remove the patch in the Dockerfile when upstream ships proper exports.
|
|
128
|
+
|
|
129
|
+
## Why bearer-only?
|
|
130
|
+
|
|
131
|
+
The MCP and agent surfaces are server-to-server by nature. Cookies on those surfaces add CSRF surface for no benefit (no browser callers), and `x-api-key` was the legacy `apiKey`-plugin path that fragments the auth model. Bearer is the one true channel here. If your project still wants API-key auth, configure the `apiKey` plugin to accept its key via `Authorization: Bearer` so everything stays one channel.
|
|
@@ -148,6 +148,13 @@ bindings: {
|
|
|
148
148
|
},
|
|
149
149
|
},
|
|
150
150
|
|
|
151
|
+
// Multi-table feature: pin the gate to a specific table so the
|
|
152
|
+
// firewall + id query is unambiguous (v0.16.1+).
|
|
153
|
+
{
|
|
154
|
+
name: 'NotepadInteractions', className: 'NotepadInteractions', from: 'lib/NotepadInteractions',
|
|
155
|
+
access: { resource: { feature: 'interactions', table: 'interactions' } },
|
|
156
|
+
},
|
|
157
|
+
|
|
151
158
|
// Genuinely public room (no auth, no row lookup) — opt out explicitly.
|
|
152
159
|
{ name: 'PublicLobby', className: 'PublicLobby', from: 'lib/PublicLobby',
|
|
153
160
|
access: 'public' },
|
|
@@ -158,11 +165,12 @@ bindings: {
|
|
|
158
165
|
What the compiler emits:
|
|
159
166
|
|
|
160
167
|
- **`access: { resource: 'chats' }`** — `app.use('/realtime/chat/*', …)` that 401s anonymous, parses the URL segment as a row id, queries `chats` with the resource's `buildFirewallConditions(ctx)` and `eq(chats.id, rowId)`, and 403s when the row is invisible to the caller (out-of-org, soft-deleted, etc.). The DO's `onLoad` / `onConnect` then runs only for rows the user can already read.
|
|
161
|
-
-
|
|
168
|
+
- **`access: { resource: { feature, table } }`** — same gate, but the schema import + firewall alias are keyed off the pinned `table` instead of the feature name. Required when a feature owns more than one resourceful table; the access gate emit can't pick which table's firewall to query otherwise.
|
|
169
|
+
- **Multi-resource form** — same gate but with a regex parser dispatching to per-kind firewall lookups. Unknown kinds 400 at the gate. Each `resources[kind].resource` accepts either form (string shorthand or `{ feature, table }`).
|
|
162
170
|
- **`access: 'public'`** — `app.use('/realtime/<kebab>/*', …)` that just passes through. Use for anonymous game lobbies / public collab pads where the room itself is the unit of access.
|
|
163
171
|
- **No `access` declared** — falls through to the catchall `/realtime/*` gate that just checks `ctx.authenticated`. (v0.11.1 behavior.)
|
|
164
172
|
|
|
165
|
-
Compile-time validation: every `resource` / `resources[].resource` value is checked against the project's feature names so typos surface as build errors, not as runtime 400s on the first WS upgrade.
|
|
173
|
+
Compile-time validation: every `resource` / `resources[].resource` value is checked against the project's feature names so typos surface as build errors, not as runtime 400s on the first WS upgrade. The string shorthand requires the feature to have exactly one resourceful table; multi-table features must use the long form `{ feature, table }` to pin a specific table.
|
|
166
174
|
|
|
167
175
|
### Hand-written mount with `onBeforeConnect`
|
|
168
176
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@quickback-dev/cli",
|
|
3
|
-
"version": "0.16.
|
|
3
|
+
"version": "0.16.1",
|
|
4
4
|
"description": "CLI for Quickback — define your backend in TypeScript, compile to a fully wired Cloudflare Worker (or Bun / Node) with auth, database, migrations, security, CMS, and Account UI.",
|
|
5
5
|
"author": "Kardoe Incorporated <paul@kardoe.com>",
|
|
6
6
|
"license": "MIT",
|
|
@@ -4,6 +4,104 @@ Release notes for the Quickback compiler, CLI, and platform.
|
|
|
4
4
|
|
|
5
5
|
---
|
|
6
6
|
|
|
7
|
+
## v0.16.1 — May 9, 2026
|
|
8
|
+
|
|
9
|
+
### Cloudflare ASSETS canonicalization — worker SPA emits no longer 307-loop
|
|
10
|
+
|
|
11
|
+
Cloudflare's static-assets binding canonicalizes any request for `/<dir>/index.html` into a 307 redirect to `/<dir>/` (the default `html_handling=auto-trailing-slash`). When a worker subrequest issues `c.env.ASSETS.fetch(new Request(new URL('/<dir>/index.html', …)))`, the binding returns the 307; the worker forwards it; the browser re-requests `/<dir>/`; the same SPA-fallback handler (or hostname middleware) catches the directory request and re-fetches `/<dir>/index.html`. Infinite loop. Caught by AttendVIP writing custom `/admin/` and `/m/` host-routing patches on the deployed worker — the fix in their patches was switching to `/admin/` (trailing slash, no `index.html`), which Cloudflare resolves to the directory's `index.html` content with a 200.
|
|
12
|
+
|
|
13
|
+
The compiler had the same bug baked into every emit point. `cloudflare.ts` now fetches `/<dir>/` everywhere it previously asked for `/<dir>/index.html`: CMS hostname middleware, `/cms/*` SPA catchall, apex `/` handler, account/admin hostname middleware, `/account/*` SPA catchall, and the multi-domain catchall. Eight regression tests in `cf-assets-canonicalization-spa-fallback.test.ts` pin every emit so a future copy/paste can't sneak the literal back in.
|
|
14
|
+
|
|
15
|
+
### `account.customLogin` — drop a project-branded sign-in page in front of the SPA
|
|
16
|
+
|
|
17
|
+
A new `account: { customLogin: true }` flag emits an explicit `app.get('/account/login', …)` route that serves a project-supplied static page instead of letting the bundled Account SPA's client router handle the path. Drop the page at `quickback/public/account/login/index.html` (a *directory*, not a bare `login.html` — see the canonicalization note above) and the existing `quickback/public/` passthrough copies it into the asset binding. The route is registered before the `/account/*` SPA catch-all so the static handler wins; everything else under `/account/...` (profile, organizations, devices, …) keeps going through the React SPA. Same surface AttendVIP was hand-patching post-compile — promoting the flag means the next compile no longer wipes their override. Default `false`.
|
|
18
|
+
|
|
19
|
+
### Project-level realtime auto-broadcasts every resource by default
|
|
20
|
+
|
|
21
|
+
`dbConfig.realtime: true` now treats every resource as realtime-enabled unless its `realtime` block explicitly opts out. The previous behavior set `effectiveResourceRealtime` to `undefined` when a resource didn't declare its own block — so a project that flipped the project-level flag still had to add per-table `realtime: { enabled: true }` everywhere to actually get auto-broadcasts. Caught against AttendVIP after the v0.15.x auto-broadcast wiring landed but didn't fire. New default: project-level on with no per-resource override = `{ enabled: true }`. Per-resource `realtime: { enabled: false }` still wins.
|
|
22
|
+
|
|
23
|
+
### Drizzle metadata gets a DO NOT EDIT header + journal drift warning
|
|
24
|
+
|
|
25
|
+
Two changes that protect the drizzle plumbing from quiet corruption.
|
|
26
|
+
|
|
27
|
+
`compile-runner.ts:addJsonHeader` now stamps drizzle's generated JSON (`_journal.json`, `<n>_snapshot.json`) with a `$__quickback_warning__$` key explaining the file is regenerated by the compiler and should not be edited by hand. The disclaimer matches the one already on `.ts` outputs — the journal had been the one drizzle file users felt entitled to "tidy up" because nothing in it said otherwise.
|
|
28
|
+
|
|
29
|
+
A new check in the same module compares the journal entry count against the snapshot file count. drizzle-kit only produces one snapshot per `generate` run, so `journal.entries.length > snapshots + 1` means the journal claims migrations the snapshot side has lost (typical cause: a manual delete of an `<n>_snapshot.json` that left the journal entry behind). The compiler logs a warning and lists the orphan entries. Detected directly out of AttendVIP's `Travel 500` triage — drizzle-kit was diffing against a stale `0002_snapshot.json` and emitting bogus full `CREATE TABLE` migrations for tables that had been added in subsequent (now-orphaned) journal entries.
|
|
30
|
+
|
|
31
|
+
### Two new compile-time validators (LOUD failures over silent traps)
|
|
32
|
+
|
|
33
|
+
**`AUTHENTICATED` + tenant-scoped firewall now refuses to compile.** `pseudo-role-validator.ts` rejects any access tree that admits `AUTHENTICATED` on a resource whose firewall scopes by `organizationId`. The combination is the silent-empty trap: a sign-in-only caller with no active org passes the role gate, the firewall WHERE clause filters every row out, and the API returns `[]` with a 200. The error message names three valid resolutions — drop the org scope (`firewall: { exception: true }`), tighten the role to `USER` or a role with implied org membership, or split the route into a token-auth branch and an org-membership branch.
|
|
34
|
+
|
|
35
|
+
**`createRealtime` imports without `dbConfig.realtime: true` now throw.** Project lib + action + feature-lib files are scanned at compile time for `import { createRealtime }` (and the equivalent named binding). When the project hasn't enabled realtime, the compile fails with the offending file paths and remediation: either enable `dbConfig.realtime: true` so the runtime helper exists, or remove the import. Caught against AttendVIP — three handler files (`broadcastAnnouncement.ts`, `declineActivityForGuest.ts`, `applyRsvp.ts`) imported `createRealtime` after the v0.15 auto-broadcast wiring landed, but their config never set `realtime: true`. The Worker compiled, deployed, and 500'd at first call. The user's framing was "config should be the source of truth" — this validator enforces that. Five regression tests in `realtime-import-without-config-rejected.test.ts`.
|
|
36
|
+
|
|
37
|
+
### Fixes
|
|
38
|
+
|
|
39
|
+
**1. `SYSADMIN` was missing from the per-feature standalone gate's `allowsWithoutOrg` set.** The standalone-action wrapper skips its `if (!ctx.activeOrgId)` gate for any access tree referencing a pseudo-role (`PUBLIC`, `AUTHENTICATED`, `USER`, `ADMIN`) — but `SYSADMIN`, the v0.15.0 fifth marker, was missing from the matcher. Sysadmin actions on `cms.sysadmin: true` projects were 403'ing on cross-tenant calls (sysadmins have no member rows, so `ctx.activeOrgId` is unset by design). The matcher now includes `SYSADMIN`.
|
|
40
|
+
|
|
41
|
+
**2. Apex `/` and `/account/login` get fallback redirects when neither CMS nor Account SPA is bundled.** Projects that opt out of both bundled SPAs still receive traffic at `/` (no apex handler, 404) and `/account/login` (no Account fallback, 404). Setting `auth.loginUrl` to an external sign-in host now activates two compiler-emitted redirects so those natural inbound URLs land somewhere useful: `/account/login → loginUrl?redirect=…` (preserves the bounce param) and `/ → loginUrl` (or `/account` when the Account SPA is bundled). Both opt in via `auth.loginUrl !== '/account/login'` so projects using the built-in `/account/login` keep the existing SPA-fallback behavior unchanged.
|
|
42
|
+
|
|
43
|
+
**3. Record-based action URLs are now kebab-case to match OpenAPI.** `record-based.ts` was emitting URL paths from the camelCase action name (e.g. `/api/v1/widgets/:id/sendInvite`) while OpenAPI emit produced `/widgets/:id/send-invite`. Admin tooling and SDK consumers reading the OpenAPI spec hit 404s on every multi-word action. URL paths and OpenAPI emit now share a `urlPath = toKebabCase(urlSegment)` helper. Identifiers in audit `actionName`, error messages, and console logs stay camel — those are programmatic surfaces and breaking them would churn audit logs. Same fix shape as the v0.15.0 standalone-action URL casing.
|
|
44
|
+
|
|
45
|
+
### Notes
|
|
46
|
+
|
|
47
|
+
Test coverage: 1175 → 1183 (+8 across the canonicalization, customLogin, and createRealtime regression files). Verified end-to-end against AttendVIP — `quickback compile` produces a worker whose `/account/login`, hostname-routed account/admin SPAs, and apex / handler all return 200 with the right SPA shell on the deployed Cloudflare worker, no 307 loops.
|
|
48
|
+
|
|
49
|
+
The bundled docs (`packages/claude-skill/docs/changelog.md`, `packages/cli/src/skill/docs/changelog.md`) and the CLI's `packages/cli/src/docs/content.ts` are regenerated by `scripts/bundle-docs.ts` — run that before publishing the CLI bump.
|
|
50
|
+
|
|
51
|
+
---
|
|
52
|
+
|
|
53
|
+
## v0.16.0 — May 9, 2026
|
|
54
|
+
|
|
55
|
+
### Agent Auth Protocol — first-class agent identity for AI callers
|
|
56
|
+
|
|
57
|
+
Quickback now ships a server implementation of the [Agent Auth Protocol](https://agentauthprotocol.com) by way of `@better-auth/agent-auth`. Opt in with `auth.plugins.agentAuth: true` (or the array form `plugins: ["agentAuth"]`). When enabled, the compiler emits a complete agent-auth surface: discovery at `/.well-known/agent-configuration`, capability projection from the project's OpenAPI spec, a device-authorization approval page in the Account SPA at `/agents/approve`, and the four agent-auth tables (`agent`, `agentHost`, `agentCapabilityGrant`, `approvalRequest`) added to the auth schema automatically by `auth generate`.
|
|
58
|
+
|
|
59
|
+
**OpenAPI capability projection runs by default.** The compiler emits `src/lib/openapi-spec.ts` (the project's full OpenAPI spec inlined as a const) and wires `createFromOpenAPI(openapiSpec, { ... })` into the `agentAuth(...)` call. Every operation with an `operationId` becomes an agent capability. Default `approvalStrength` map: `GET → "session"`, `POST/PUT/PATCH/DELETE → "webauthn"`. Default `defaultHostCapabilities`: `["GET", "HEAD"]`.
|
|
60
|
+
|
|
61
|
+
The proxy `onExecute` makes a self-fetch to the worker's own URL with a Better Auth JWT minted for `agentSession.user.id`, so the inner request hits the existing JWT fast-path, populates `ctx`, and the full firewall + access + masking pipeline runs on the proxied call. No new middleware code, no parallel security path — agent capability calls go through the same gates as regular REST traffic. The cost is one Cloudflare subrequest per capability call (~50ms); fine for typical agent traffic. Opt out of OpenAPI projection with `agentAuth: { fromOpenAPI: false }` and wire `capabilities` + `onExecute` by hand.
|
|
62
|
+
|
|
63
|
+
The Account SPA gains `/agents/approve` (`packages/account/app/routes/agents.approve.tsx`) — modeled on the existing `/cli/authorize` device-code page. Pastes the user code, fetches the pending request, lists the requested capabilities with a "Step-up" badge on any capability whose `approvalStrength` is `"webauthn"`, then approves or denies. WebAuthn step-up itself is a placeholder for v0.16.0 — the upstream agent-auth API for the escalation call is still settling, so capabilities tagged `"webauthn"` will fail server-side until that lands. The badge tells the user what's coming.
|
|
64
|
+
|
|
65
|
+
### Bearer-only on `/mcp` and the agent-auth surface
|
|
66
|
+
|
|
67
|
+
`/mcp` now forwards **only** `Authorization: Bearer …` into the inner `app.request()` re-entry. Cookie + `x-api-key` forwarding has been removed. The MCP surface is server-to-server by nature — there are no browser callers, no CSRF surface to defend, and no benefit to fragmenting the auth model across three header conventions. Three Bearer flavors all land on the same header, resolved by the inner Hono middleware chain:
|
|
68
|
+
|
|
69
|
+
- Better Auth session token via the official `bearer` plugin
|
|
70
|
+
- OAuth access token via the OAuth Provider plugin
|
|
71
|
+
- Agent JWT via `@better-auth/agent-auth`
|
|
72
|
+
|
|
73
|
+
If a project still wants API-key auth here, configure the `apiKey` plugin to accept its key via `Authorization: Bearer` so everything stays one channel. The existing `mcp-server.test.ts` regression seal flips from "forwards Cookie + x-api-key" to "forwards only Authorization (bearer-only surface)".
|
|
74
|
+
|
|
75
|
+
### Auth DSL: `bearer`, `oauthProvider`, `agentAuth` are now first-class plugin entries
|
|
76
|
+
|
|
77
|
+
Both the array-form union and the `BetterAuthPlugins` interface in `apps/compiler/src/define/auth.ts` gain `"bearer"`, `"oauthProvider"`, and `"agentAuth"`. `bearer` was previously in the runtime registry but missing from the TS type, so callsites had to use `as any` or `// @ts-expect-error` to set it. Both are gone now. New typed options interfaces — `OAuthProviderOptions` (audience, login/consent paths, dynamic registration) and `AgentAuthOptions` (providerName, providerDescription, modes, fromOpenAPI, approvalStrength, defaultHostCapabilities) — let users override defaults through the object form.
|
|
78
|
+
|
|
79
|
+
Auto-enable rule lives in the canonical `computeAutoAddedPlugins` (`generators/auth.ts`): turning on `agentAuth` force-adds `bearer` + `oauthProvider`. There is no useful agent-auth deployment without those two — surfacing it as auto-add rather than a confusing "missing dependency" runtime error matches the existing pattern (`oauthProvider` already auto-adds `jwt`).
|
|
80
|
+
|
|
81
|
+
### `queue-consumer.ts` now emitted for `additionalQueues` too
|
|
82
|
+
|
|
83
|
+
Prior to this release, the queue consumer emit gated on `embeddingFeatures.length > 0 || queueHandlers.length > 0`. Projects that declared queue infrastructure via `dbConfig.additionalQueues` but had no embeddings + no `services/queues/*` handlers shipped a `wrangler.toml` with `[[queues.consumers]]` entries pointing at a missing worker `queue` export. The CLI's archive-restore step kept a stale `queue-consumer.ts` around, so the file appeared "stuck" across compiles — same class of bug as the v0.15.0 services/queues/* regression caught against AttendVIP, just one source removed.
|
|
84
|
+
|
|
85
|
+
The gate is now a three-way OR: `hasEmbeddings || hasQueueHandlers || hasAdditionalQueues`. When only `additionalQueues` is set, the compiler emits a stub `queue-consumer.ts` whose `queue` export acks every message with a warning — Cloudflare needs an export for every consumer binding, and a noisy-but-correct stub beats a silent deploy break. `MainAppOptions` and `CloudflareMainAppOptions` gain `hasAdditionalQueues`; `generateQueueImport` and `generateCloudflareExport` mirror the new gate. Regression test: `src/__tests__/queue-additional-queues-gate.test.ts`.
|
|
86
|
+
|
|
87
|
+
### Fixes
|
|
88
|
+
|
|
89
|
+
**1. `bearer` was missing from the `BetterAuthPlugins` TypeScript interface.** The runtime plugin registry has had `bearer` since the pre-1.0 cuts, but `apps/compiler/src/define/auth.ts` never declared it on the typed shape — so any `quickback.config.ts` using `plugins: { bearer: true }` had to `as any`-cast or sit behind a `@ts-expect-error`. Both `bearer` and `oauthProvider` (same gap, same workaround) are now first-class typed entries; `agentAuth` joins them. The array-form union also gains all three. No behavior change at runtime; existing casts can come out.
|
|
90
|
+
|
|
91
|
+
**2. MCP `buildInternalRequest` no longer forwards Cookie or `x-api-key`.** The MCP surface is server-to-server — there are no browser callers, no CSRF surface to defend, and no benefit to fragmenting the auth model across three header conventions. The inner `app.request()` re-entry now forwards only `Authorization: Bearer …`. Three Bearer flavors all land on the same header (BA session token via the `bearer` plugin, OAuth access token via OAuth Provider, agent JWT via `@better-auth/agent-auth`). Existing `mcp-server.test.ts` regression flipped from "forwards Cookie + x-api-key" to "forwards only Authorization (bearer-only surface)".
|
|
92
|
+
|
|
93
|
+
**3. `agentAuth` now auto-enables `bearer` + `oauthProvider`.** There is no useful agent-auth deployment without those two — the agent surface is bearer-only and MCP clients need OAuth to register. Auto-enable lives in the canonical `computeAutoAddedPlugins` (`generators/auth.ts`), so it propagates to every consumer (better-auth generator, schema generation, package-deps emission). Same pattern as the existing `oauthProvider` → `jwt` rule. Surfaced in `agent-auth.test.ts` with a regression seal that asserts both plugins land in the merged plugin list whether the user wrote the array form or the object form.
|
|
94
|
+
|
|
95
|
+
**4. `OpenAPISpec` literal type rejected by tsc on inlined spec.** Quickback's OpenAPI emit produces `$ref`-style parameter entries (`{ "$ref": "#/components/parameters/X" }`) that the agent-auth plugin's stricter `OpenAPIParameter` type doesn't model — `tsc` fails the generated project with "Type … is not assignable to OpenAPIParameter". The plugin handles refs correctly at runtime; only the structural narrowing on the TS literal needed help. The generated `agentAuth({ ...createFromOpenAPI(openapiSpec as any, { ... }) })` call now carries an `as any` cast on the spec with an inline comment explaining why. Drop when upstream models `$ref` parameters.
|
|
96
|
+
|
|
97
|
+
### Notes
|
|
98
|
+
|
|
99
|
+
`@better-auth/agent-auth` 0.4.5 ships ESM-only exports without a `require` condition, so the Better Auth CLI's `auth generate` step (jiti / CJS resolver) bails with `ERR_PACKAGE_PATH_NOT_EXPORTED`. The compiler image patches the package's `package.json` at install time to add a matching `require` condition pointing at the same dist file (Node 22+ supports `require(esm)`). Remove the patch in `apps/compiler/Dockerfile` when upstream ships proper exports.
|
|
100
|
+
|
|
101
|
+
Test coverage: 1136 → 1152 (+11 `agent-auth.test.ts`, +5 `queue-additional-queues-gate.test.ts`). Verified end-to-end against `examples/recruitment` with `agentAuth` enabled — `quickback compile` produces a project whose `npm run build` typechecks clean and whose generated schema includes all four agent-auth tables (`agent`, `agentHost`, `agentCapabilityGrant`, `approvalRequest`).
|
|
102
|
+
|
|
103
|
+
---
|
|
104
|
+
|
|
7
105
|
## v0.15.0 — May 7, 2026
|
|
8
106
|
|
|
9
107
|
### Sysadmin tier — cross-tenant DB-admin role for the CMS
|
|
@@ -286,7 +286,7 @@ type FieldCondition =
|
|
|
286
286
|
|
|
287
287
|
Beyond Better Auth roles (org membership, user-table role) and pseudo-roles, Quickback supports **relationship-based authorization roles** — names that bind to a declared relationship between the caller and a resource. Use these when access should follow a domain-table membership ("user is a confirmed guest of this event") rather than an org/admin gate.
|
|
288
288
|
|
|
289
|
-
### `authz.relationships`
|
|
289
|
+
### `authz.relationships`
|
|
290
290
|
|
|
291
291
|
Declare relationships once in `quickback.config.ts`:
|
|
292
292
|
|