pipework 0.243.0 → 0.245.0

package/dist/REFERENCE.md

@@ -1,7 +1,7 @@
 # Pipework API Reference
 
 > Auto-generated from source JSDoc. Do not edit manually.
-> Generated: 2026-10-25
+> Generated: 2026-10-09
 
 ## Contents
 
@@ -10,7 +10,6 @@
 - [jobs — Background Jobs](#jobs-background-jobs)
 - [pipeline — Multi-Step Pipelines](#pipeline-multi-step-pipelines)
 - [state — State Machines](#state-state-machines)
-- [steps](#steps)
 - [auth — Authentication](#auth-authentication)
 - [rbac — Access Control](#rbac-access-control)
 - [tenant — Multi-Tenancy](#tenant-multi-tenancy)
@@ -31,10 +30,7 @@
 - [cache — Caching](#cache-caching)
 - [credits](#credits)
 - [mail](#mail)
-- [untrustedFetch](#untrustedfetch)
-- [quota](#quota)
 - [storage](#storage)
-- [support](#support)
 - [webhook — Inbound & Outbound Webhooks](#webhook-inbound-outbound-webhooks)
 - [behavior — Resource Decorators](#behavior-resource-decorators)
 - [fitting — Dependency Injection](#fitting-dependency-injection)
@@ -46,7 +42,6 @@
 - [trace](#trace)
 - [data](#data)
 - [request](#request)
-- [async](#async)
 
 ## Core
 
@@ -79,7 +74,7 @@ export default manifold
 ```
 
 ```typescript
-function createManifold<const TEnv extends EnvDefs = EnvDefs>( raw: AcceptReadonly<Omit<BlueprintInput, 'env'>> &
+function createManifold<const TEnv extends EnvDefs = EnvDefs>( raw: Omit<BlueprintInput, 'env'> &
 ```
 
 ### Types
@@ -90,24 +85,6 @@ function createManifold<const TEnv extends EnvDefs = EnvDefs>( raw: AcceptReadon
 interface Manifold<TEnv extends EnvDefs = EnvDefs>
 ```
 
-**`StopResult`** — What {@link Manifold.stop} resolves with: `forced` is true when the drain deadline fired.
-
-```typescript
-interface StopResult
-```
-
-**`ScriptOptions`** — Options for {@link Manifold.script}.
-
-```typescript
-interface ScriptOptions
-```
-
-**`StartOptions`** — Options for {@link Manifold.start}.
-
-```typescript
-interface StartOptions
-```
-
 **`SeedOptions`** — ALS context the {@link Manifold.seed} callback runs under — tenant scope, auth principal, and job type.
 
 ```typescript
@@ -252,14 +229,6 @@ Creates a job queue with claim/complete/fail lifecycle, heartbeat, and dead lett
 
 Executes a fitting handler as a background job with its own Flow context.
 
-### `jobs.later`
-
-The error to throw to end an attempt as "later": pending again after `delayMs`, no attempt counted.
-
-### `jobs.permanent`
-
-The error to throw to dead-letter the job now, whatever attempts remain.
-
 ### `jobs.parseCron`
 
 Parses a 5-field cron expression into a CronSchedule (minute, hour, dom, month, dow).
@@ -300,14 +269,6 @@ Thrown when a transition is not allowed from the current state.
 
 Thrown when the state machine definition is internally inconsistent.
 
-## steps
-
-Step graphs over a job queue: results recorded by their inputs, only missing steps run.
-
-### `steps.define`
-
-Defines a graph of named steps over a jobs Queue. Pass it to `createWorkerSurface({ graphs })` to run its steps.
-
 ## auth — Authentication
 
 Authentication namespace — session management, multi-org support, auth chain resolution.
@@ -328,14 +289,6 @@ Hashes and verifies passwords with scrypt; reports when a stored hash needs reha
 
 Guarded password sign-in that slows, then refuses, repeated failures per account and per client.
 
-### `auth.guard`
-
-Guards wrong guesses at a secret the app checks itself: counted per key set before the check, reset on a right answer, refused with retryAfterSeconds.
-
-### `auth.emailLinks`
-
-Emailed single-use links that prove control of an address: password reset and address verification; the token is never stored.
-
 ### `auth.runChain`
 
 Executes an auth chain (strategy pipeline) to resolve auth + tenant from a request.
@@ -370,7 +323,7 @@ interface AuthContext
 interface AuthStrategy<TAuth>
 ```
 
-**`AuthRequest`** — Normalized request shape passed to auth strategies — headers, the parsed `Cookie` header, and the upper-case HTTP method.
+**`AuthRequest`** — Normalized request shape passed to auth strategies — headers, cookies, method, url.
 
 ```typescript
 interface AuthRequest
@@ -400,18 +353,6 @@ interface TenantResolver<TAuth>
 interface AuthChainConfig<TAuth>
 ```
 
-**`SessionAuth`** — What `sessions.strategy()` authenticates: the token's user and org, its roles, and where the token came from.
-
-```typescript
-type SessionAuth = BaseAuth &
-```
-
-**`SessionStrategyOptions`** — Options for `sessions.strategy()`.
-
-```typescript
-interface SessionStrategyOptions
-```
-
 **`SessionConfig`** — Session configuration — signing keys, issuer, audience, token TTLs, refresh rotation.
 
 ```typescript
@@ -683,18 +624,6 @@ Base error class with code, statusCode, and suggestion fields.
 
 403 — authenticated but insufficient permissions.
 
-### `errors.CrossSiteRequest`
-
-403 `CROSS_SITE_REQUEST` — a cookie-authenticated request that did not come from the app's own site.
-
-### `errors.AuthConfiguration`
-
-500 `AUTH_CONFIGURATION` — the auth setup itself is faulty (a signing key that will not load); never a refusal of the caller.
-
-### `errors.AuthUnavailable`
-
-503 `AUTH_UNAVAILABLE` — authentication could not be decided (its database failed); never read as signed out.
-
 ### `errors.Validation`
 
 422 — input validation failed, carries field-level details.
@@ -715,17 +644,13 @@ Base error class with code, statusCode, and suggestion fields.
 
 415 — request body media type not accepted by the route.
 
-### `errors.MalformedMultipart`
-
-400 `MALFORMED_MULTIPART` — a multipart body that cannot be parsed or ends before its closing boundary.
-
 ## lifecycle — Startup & Shutdown
 
 Application lifecycle namespace — startup orchestration with hooks and timeouts.
 
 ### `lifecycle.orchestrate`
 
-Runs pre-start hooks (DB readiness checks, migrations, etc.) with a configurable timeout. The hooks run in one trace that names the process; the trace-partition hook runs first, outside it.
+Runs pre-start hooks (DB readiness checks, migrations, etc.) with a configurable timeout.
 
 ## log — Structured Logging
 
@@ -765,7 +690,7 @@ Creates a worker surface — a long-running process that claims and executes job
 
 ### `surface.script`
 
-Creates a script surface — a one-shot process that runs and exits (migrations, seeds, CLI tools). The run is traced as a job-kind trace that names the surface.
+Creates a script surface — a one-shot process that runs and exits (migrations, seeds, CLI tools).
 
 ## pipe — Database
 
@@ -775,10 +700,6 @@ Database accessor — returns a Drizzle DB instance scoped to the current reques
 
 The system channel — deliberate cross-tenant access for pre-tenant surfaces (auth membership resolution, public webhook ingress, admin tooling). Never tenant-scoped or tenant-guarded; runs on the owner-role connection outside the request transaction.
 
-### `pipe.door`
-
-A named cross-tenant read: `pipe.door(name, db => ...)`. The door is declared under `doors` in config; the callback runs in one transaction on the platform-role connection and may SELECT from the door's table and from non-tenant tables. Needs `rls.platformRole`.
-
 ### `pipe.filter`
 
 Query operators and aggregates — eq, gt, lt, and, or, count, sum, etc.
@@ -836,18 +757,10 @@ Returns excluded-column references for onConflictDoUpdate set clauses.
 
 Acquires a transaction-scoped advisory lock. Released at commit/rollback.
 
-### `pipe.tryAdvisoryLock`
-
-Non-blocking advisoryLock: true if the transaction-scoped lock was won, false if another transaction holds it.
-
 ### `pipe.serializable`
 
 Runs a function in a SERIALIZABLE transaction with automatic retry on serialization failures and deadlocks.
 
-### `pipe.withTimeouts`
-
-Sets statement_timeout and/or lock_timeout for the current transaction in one statement, then runs fn; a statement cancelled for them rejects with StatementTimeoutError or LockTimeoutError.
-
 ### `pipe.bulkSet`
 
 Bulk UPDATE ... FROM (VALUES ...) — updates multiple rows with per-row values in a single statement.
@@ -856,10 +769,6 @@ Bulk UPDATE ... FROM (VALUES ...) — updates multiple rows with per-row values
 
 Produces a typed VALUES clause for bulk operations — the base primitive for bulkSet and bulkUpsert.
 
-### `pipe.fn`
-
-A set-returning SQL function as a typed source for `.from()` and joins — `pipe.fn('schema.f', { args: [field.uuid()], columns: { path: field.text() } })`. Arguments are bound and cast to their declared types.
-
 ### `pipe.field`
 
 Field builders for domain definitions — uuid(), text(), integer(), etc.
@@ -872,17 +781,13 @@ Registers a domain definition with table, validators, and factory projections. T
 
 Returns the global registry of all domain definitions.
 
-### `pipe.external`
-
-Declares a table or view another service owns (`pipe.external(name, fields, { schema, table? })`): typed columns and every query operator, read-only, never migrated, not tenant-scoped.
-
 ### `pipe.update`
 
 Pipework-owned UPDATE builder — the only consumer-facing way to update pipework-managed tables (Q8).
 
 ### `pipe.insert`
 
-Pipework-owned INSERT builder — the only consumer-facing way to insert into pipework-managed tables (Q8). A list of any size is split into statements under Postgres's parameter limit, in one transaction.
+Pipework-owned INSERT builder — the only consumer-facing way to insert into pipework-managed tables (Q8).
 
 ### `pipe.delete`
 
@@ -890,7 +795,7 @@ Pipework-owned DELETE builder — the only consumer-facing way to delete from pi
 
 ### `pipe.upsert`
 
-Pipework-owned UPSERT builder — insert with conflict resolution (Q8). A list of any size is split into statements under Postgres's parameter limit, in one transaction; rows repeating a conflict key across statements do not fail as one statement would.
+Pipework-owned UPSERT builder — insert with conflict resolution (Q8).
 
 ### Types
 
@@ -900,107 +805,25 @@ Pipework-owned UPSERT builder — insert with conflict resolution (Q8). A list o
 interface WindowSpec
 ```
 
-**`FrameBound`** — One end of a window frame. `{ preceding: n }` / `{ following: n }` take a non-negative integer.
-
-```typescript
-type FrameBound = 'unboundedPreceding' | 'currentRow' | 'unboundedFollowing' |
-```
-
-**`WindowFrame`** — A window frame: `rows|range|groups [between] start [and end]`.
-
-```typescript
-interface WindowFrame
-```
-
-**`Aggregate`** — An aggregate expression that can be narrowed with `FILTER (WHERE …)`; `undefined` leaves it unfiltered.
-
-```typescript
-type Aggregate<T> = SQL<T> &
-```
-
-**`EmptyableAggregate`** — An array or jsonb aggregate; `orEmpty()` replaces the no-rows NULL with an empty array.
-
-```typescript
-type EmptyableAggregate<T, E> = SQL<T> &
-```
-
-**`JsonOf`**
-
-The type a value takes after a round trip through jsonb: Date -> string (ISO text),
-bigint -> number, Buffer/Uint8Array -> string, objects and arrays mapped recursively,
-null kept. Column decoders are not applied inside jsonb.
-
-```typescript
-type JsonOf<T> =
-```
-
-**`AggregateOptions`** — `ORDER BY` terms inside an aggregate — `asc(col)` / `desc(col)` or an array of them.
-
-```typescript
-interface AggregateOptions
-```
-
 **`ValueColumnDef`** — One column of a typed `VALUES` clause: its name and the PostgreSQL type each value in that column is cast to. See {@link values}.
 
 ```typescript
 interface ValueColumnDef
 ```
 
-**`JsonbElements`** — A jsonb array read as its elements' text. Produced by {@link jsonbElements}.
-
-```typescript
-interface JsonbElements
-```
-
-**`ArraySource`** — Something whose elements `arrayAny` / `arrayAll` can test.
-
-```typescript
-type ArraySource =
-```
-
-**`ElementOf`** — The element type of an {@link ArraySource}.
-
-```typescript
-type ElementOf<S> =
-```
-
-**`FunctionSpec`** — Declares a SQL function's argument and result-column shapes. See {@link fn}.
-
-```typescript
-interface FunctionSpec<TArgs extends readonly AnyField[], TColumns extends Record<string, AnyField>>
-```
-
-**`FunctionSourceFields`** — The selected fields of a function source: each result column as a typed SQL expression.
-
-```typescript
-type FunctionSourceFields<TColumns extends Record<string, AnyField>> =
-```
-
-**`FunctionSource`** — A function call usable in `.from()` and joins; its result columns are properties of it.
-
-```typescript
-type FunctionSource<TAlias extends string, TColumns extends Record<string, AnyField>> =
-```
-
 **`SerializableOptions`** — Retry policy for {@link serializable}: how many attempts on a serialization failure / deadlock, and the base backoff between them.
 
 ```typescript
 interface SerializableOptions
 ```
 
-**`TimeoutOptions`** — Which timeouts {@link withTimeouts} sets; each a positive integer number of milliseconds.
-
-```typescript
-interface TimeoutOptions
-```
-
 **`ManagedConnection`** — A standalone pooled connection: the raw postgres.js client, its drizzle handle, and a `close()` that ends the pool.
 
 ```typescript
 interface ManagedConnection
 ```
 
-**`ConnectOptions`** — Options for `tap()` — pool size (default 1), idle timeout in seconds, and session settings (GUCs) sent in every connection's startup packet.
+**`ConnectOptions`** — Options for `tap()` — pool size (default 1) and idle timeout in seconds.
 
 ```typescript
 interface ConnectOptions
@@ -1014,14 +837,6 @@ JSONB query operators — typed helpers for PostgreSQL JSONB containment, key ch
 
 The @> containment operator — tests whether a JSONB column contains the given value.
 
-### `jsonb.merge`
-
-Merges an object into a JSONB column in `.set()`: `coalesce(col, '{}') || value`. Top-level keys overwrite; others are kept.
-
-### `jsonb.remove`
-
-Removes top-level keys from a JSONB column in `.set()`: `col - 'key'`. Composes as the column of `jsonb.merge`.
-
 ### `jsonb.containedBy`
 
 The <@ contained-by operator — tests whether a JSONB column is contained by the given value.
@@ -1088,66 +903,6 @@ type Schema<T = unknown> = z.ZodType<T>
 type Infer<T extends Schema> = z.infer<T>
 ```
 
-**`StringSchema`** — A string validator — what check.string() returns.
-
-```typescript
-type StringSchema = z.ZodString
-```
-
-**`NumberSchema`** — A number validator — what check.number() returns.
-
-```typescript
-type NumberSchema = z.ZodNumber
-```
-
-**`BooleanSchema`** — A boolean validator — what check.boolean() returns.
-
-```typescript
-type BooleanSchema = z.ZodBoolean
-```
-
-**`EnumSchema`** — An enum validator over string literals — what check.enum([...]) returns.
-
-```typescript
-type EnumSchema<V extends string = string> = z.ZodEnum<
-```
-
-**`LiteralSchema`** — A literal validator — what check.literal(v) returns.
-
-```typescript
-type LiteralSchema<V extends string | number | boolean | null = string> = z.ZodLiteral<V>
-```
-
-**`ArraySchema`** — An array validator — what check.array(item) returns.
-
-```typescript
-type ArraySchema<Item extends z.core.SomeType = z.core.SomeType> = z.ZodArray<Item>
-```
-
-**`OptionalSchema`** — An optional validator — what check.optional(inner) and .optional() return.
-
-```typescript
-type OptionalSchema<Inner extends z.core.SomeType = z.core.SomeType> = z.ZodOptional<Inner>
-```
-
-**`NullableSchema`** — A nullable validator — what check.nullable(inner) and .nullable() return.
-
-```typescript
-type NullableSchema<Inner extends z.core.SomeType = z.core.SomeType> = z.ZodNullable<Inner>
-```
-
-**`ObjectSchema`** — An object validator — what check.object({...}) returns; keeps .extend, .pick, .omit and .partial. For a shape with fields beyond the plain kinds, annotate with ObjectSchema<{ field: Schema<T> }>.
-
-```typescript
-type ObjectSchema<S extends Shape = Shape> = z.ZodObject<S, z.core.$strip>
-```
-
-**`ObjectOps`** — The object operations of ObjectSchema.
-
-```typescript
-type ObjectOps<S extends Shape> = Pick<ObjectSchema<S>, 'extend' | 'pick' | 'omit' | 'partial'>
-```
-
 ## temporal — Bitemporal Data
 
 Temporal (bitemporal) data namespace — version history with effective date ranges.
@@ -1192,14 +947,6 @@ Query all versions of temporal records (no date filter).
 
 Close the current version and create a new one with updated data.
 
-### `temporal.setVersion`
-
-Append the next version of an append-only-versions definition: serialised per scope, numbered, never back-dated, audited.
-
-### `temporal.versionAt`
-
-The version in force at a moment: the row with the greatest effectiveFrom at or before it.
-
 ## valve
 
 Valve namespace — typed, directional, gated boundaries between code silos.
@@ -1382,18 +1129,6 @@ Alerts namespace — raise and resolve keyed conditions, grouped, delivered to s
 
 Creates an alerts handle.
 
-### `alerts.http`
-
-Routes for an operations agent: list, get, totals, delivery health, acknowledge, resolve, link; bearer credentials.
-
-### `alerts.clientFaults`
-
-One POST route that records failures reported by browser code as a trace step and an alert; answers 204, no session needed. Send with `reportClientFault` from `pipework/client`.
-
-### `alerts.requestFaults`
-
-An `onInternalError` hook for the HTTP server: raises `request-fault:<METHOD> <route>` for each internal 500.
-
 ### `alerts.webhook`
 
 A sink that POSTs the alert as signed JSON to a URL.
@@ -1402,26 +1137,6 @@ A sink that POSTs the alert as signed JSON to a URL.
 
 A sink that keeps deliveries in `.delivered`, for tests.
 
-### `alerts.loopCheck`
-
-A `/ready` health check named `loops`: unhealthy while a background loop (the tick included) has not run or succeeded within its allowance.
-
-### `alerts.recordFault`
-
-Records a failure your code swallowed (logged and carried on) so `alerts.source.faults` can raise it; `void alerts.recordFault('my-kind', message, context?)`. Best effort, never throws, writes outside the caller's transaction. Does nothing without `alerts` in the blueprint.
-
-### `alerts.recordFaultFor`
-
-`recordFault` for code that holds the manifold and may run outside any Flow: `void alerts.recordFaultFor(manifold, kind, message, context?)`.
-
-### `alerts.useFaultTarget`
-
-Registers the manifold (or a `DB`, or a function returning one) that `alerts.recordFault` writes on outside any Flow; call once at boot in a process that is not a pipework surface, and keep the release for shutdown. A manifold without `alerts` registers nothing.
-
-### `alerts.recordBeat`
-
-Records one iteration of a background loop of your own for `alerts.source.loopStalled`: `void alerts.recordBeat(manifold, 'my-loop', { ok, error?, everyMs })`. Works outside any Flow; does nothing without `alerts`.
-
 ## audit — Audit Logging
 
 Audit logging namespace — structured audit trail for data changes.
@@ -1446,10 +1161,6 @@ The newest record's `{ seq, hash }` in the tenant's audit hash chain (blueprint
 
 Walks the tenant's audit hash chain and reports the first break (hash-mismatch, prev-mismatch, missing, head-mismatch, anchor-mismatch), or `{ ok: true }`.
 
-### `audit.removeTenant`
-
-Deletes every audit record of one tenant and its hash chain, for the closure of that tenant's account. Irreversible; returns the number of records removed. Other tenants' records and chains are untouched.
-
 ## cache — Caching
 
 In-memory caching namespace — TTL-based with stats, preload, and tenant-aware variants.
@@ -1502,64 +1213,6 @@ Inbound source: SES receipt rule storing raw messages in S3 and notifying a sign
 
 Inbound development source: `.eml` files dropped in a folder, received by `scan()`; refused in production.
 
-## untrustedFetch
-
-Untrusted fetch — fetch one URL a stranger gave without letting them reach the app's private network.
-
-### `untrustedFetch.get`
-
-Fetches `url` with GET and returns `{ ok: true, url, status, contentType, body, bytes }`, or `{ ok: false, reason, message }`
-naming the rule that refused: `scheme`, `address`, `redirects`, `too_large`, `timeout`, `status`, `rejected` or `network`.
-It does not throw for these.
-
-Rules, none of which can be switched off: only `http:` and `https:`; the name is resolved and every address is checked
-(loopback, private, link-local including cloud metadata, CGNAT, unique-local and site-local IPv6, multicast, reserved,
-unspecified, and IPv4-mapped or NAT64 forms of these; literal IP URLs likewise) and the connection goes to a checked
-address; redirects are followed up to `maxRedirects` and each hop is checked as the first, and the app's `headers` go only to the first origin;
-the body is stopped the moment it passes `maxBytes`, whatever Content-Length says; `timeoutMs` covers the whole fetch.
-`accept({ status, contentType, firstBytes })` sees the first 1024 bytes before the body is kept: return false, or a string
-(your own message), to refuse with `rejected`. Messages never contain an address or anything a server sent.
-
-`resolve` and `connect` are for tests: `resolve(hostname)` replaces DNS and `connect(target)` replaces the socket after the
-address check passed, so a test sends a fake public address to a local server. The address check always runs on what `resolve` returns.
-
-The call is the trace step `pipework/fetch:get`; its child `pipework/fetch:outcome` carries host, status, bytes and reason.
-The full URL is recorded only when `urlIsSafeToTrace` is true; otherwise only the host.
-
-```ts
-const got = await untrustedFetch.get(pasted, { maxBytes: 5_000_000, timeoutMs: 10_000, maxRedirects: 3,
-  accept: h => h.firstBytes[0] === 0x25 || 'That does not look like a PDF.' })
-if (!got.ok) return tell(got.message)
-```
-
-### `connectRetry.fetch`
-
-`fetch(input, init, opts)` that retries a fault in the connect phase (undici `UND_ERR_CONNECT_TIMEOUT`, `EAI_AGAIN`,
-`ENOTFOUND`, `ECONNREFUSED`, `ENETUNREACH`, `EHOSTUNREACH`), waiting `delaysMs` between tries (default 5 s, 15 s, 40 s: four
-tries over about a minute), then throws the last fault with its cause chain. A fault after the request was written
-(`ECONNRESET`, `UND_ERR_SOCKET`, a timeout, an abort) and a response of any status are never retried, because a POST may have taken effect.
-`signal` ends the waiting; `onRetry({ error, attempt, delayMs })` is called before each wait; `fetch` replaces the global fetch.
-
-```ts
-const res = await connectRetry.fetch('https://api.github.com/repos/o/r/issues', { method: 'POST', body })
-```
-
-### `connectRetry.call`
-
-Runs any `send()` with the same rule: retried only when `isUnsentFault(error)`; the last fault is thrown unchanged.
-
-### `connectRetry.isUnsentFault`
-
-True when the error, its `cause` chain or an `AggregateError`'s errors show a connect-phase fault and no sent-phase one.
-
-## quota
-
-Quota namespace — callers of one rate-limited upstream share its budget by class, read from the upstream's headers and kept in Postgres.
-
-### `quota.create`
-
-Creates a quota handle.
-
 ## storage
 
 Storage namespace — tenant-scoped, content-addressed file storage with signed URLs and retention.
@@ -1576,18 +1229,6 @@ S3-compatible backend (AWS S3, MinIO, R2): SigV4 over `fetch`, multipart streami
 
 Local-disk backend for development and tests; refused in production.
 
-## support
-
-Support namespace — tickets from email (and later chat), with replies sent only after an approval.
-
-### `support.create`
-
-Creates the support handle: tickets, messages, notes, links, drafts, `approve`, `receiveEmail`, and the events job.
-
-### `support.templates`
-
-The reply template to spread into `mail.create({ templates })`; it renders the approved draft verbatim.
-
 ## webhook — Inbound & Outbound Webhooks
 
 Webhook namespace — inbound verification, outbound delivery with retries, HMAC signing.
@@ -1678,13 +1319,9 @@ Returns the current Flow or undefined — use for optional context detection.
 
 Creates a Flow for test isolation with optional auth and tenant overrides.
 
-### `flow.actAs`
-
-Runs `fn` as a tenant and user chosen inside a tenantless Flow (sign-up, a public sign-in): RLS, audit and trace under that tenant, on the request's transaction.
-
 ## http — Server
 
-HTTP namespace: `http.file()` builds a file response; `http.detectMediaType()` names bytes the way uploads do; the server itself is managed by manifold.start().
+HTTP namespace: `http.file()` builds a file response; the server itself is managed by manifold.start().
 
 ### Types
 
@@ -1706,40 +1343,6 @@ interface SecurityConfig
 interface RateLimitConfig
 ```
 
-**`RateLimitWindow`** — One fixed window: at most `max` requests per `windowSeconds`.
-
-```typescript
-interface RateLimitWindow
-```
-
-**`RateLimitClass`**
-
-A named limit class: any of a per-user, per-tenant, per-address and total window, each counted on its own.
-Each key takes one window or an array of windows (distinct `windowSeconds`); a request is counted against
-all of a key's windows and refused if any is over.
-
-```typescript
-interface RateLimitClass
-```
-
-**`RateLimitRefusal`** — What `onRefused` is told about one refused window of one request.
-
-```typescript
-interface RateLimitRefusal
-```
-
-**`RateLimitClassesConfig`**
-
-Named limit classes, checked after auth and counted in Postgres (`pipework_rate_limit_counts`, opted in
-with the blueprint's `rateLimits: {}`), so every server process on the same database shares one count.
-Keys are counted perUser, perTenant, perAddress, total in turn, up to the first key with a window over its max, so one user's
-refused requests don't spend the tenant's budget. The 429's Retry-After is the longest wait of the windows that refused. A route is in `signedIn` (auth required, or optional with
-a user), `public` (no auth, or optional without a user) or the class its fitting names with `.rateLimit(name)`.
-
-```typescript
-interface RateLimitClassesConfig
-```
-
 **`InjectOptions`** — Options for server.inject() — method, url, headers, payload for testing without HTTP.
 
 ```typescript
@@ -1758,12 +1361,6 @@ interface InjectResponse
 interface ServerConfig
 ```
 
-**`InternalErrorFault`** — What `onInternalError` is told about one request that ended in an internal error.
-
-```typescript
-interface InternalErrorFault
-```
-
 **`HandlerResponse`** — Standard handler response shape — statusCode, headers, body.
 
 ```typescript
@@ -1822,7 +1419,7 @@ Generates an OpenAPI 3.1 document from route registrations — schemas derived f
 
 ## trace
 
-Trace namespace — hand the current trace to a process outside Node, record the steps it reports back, mark point events, and read a trace tree.
+Trace namespace — hand the current trace to a process outside Node and record the steps it reports back.
 
 ### `trace.traceparent`
 
@@ -1836,15 +1433,6 @@ W3C `traceparent` for the current trace and open step; `null` outside a traced f
 
 Records steps reported as JSON lines (or objects) by an outside process under the step open now. Synchronous; never throws.
 
-### `trace.event`
-
-Records one zero-length step `external:<name>` under the step open now, with an optional `capture` and `error`. A no-op outside a traced flow; never throws.
-
-### `trace.tree`
-
-Reads every hot trace sharing `rootId` (a request's trace and the jobs it queued) with their steps. Runs on the
-given `db`, so tenant policies apply: only an unrestricted connection (table owner, tests) sees every tenant's rows.
-
 ### Types
 
 **`FlowStepMeta`** — Trace metadata for one documented flow-step: its `path:symbol` graph node id and the per-argument capture projections.
@@ -1865,40 +1453,17 @@ type ExternalStepReport = z.infer<typeof externalStepReportSchema>
 interface ExternalRecordResult
 ```
 
-**`TraceStepNode`** — One step of a trace. `ref` is the flow step's `path:symbol`, or `external:<name>` for a recorded or point-event step.
-
-```typescript
-interface TraceStepNode
-```
-
-**`TraceNode`** — One trace of the tree, with its steps ordered by `seq`.
-
-```typescript
-interface TraceNode
-```
-
-**`TraceTree`** — The traces that share a root id, ordered by when they opened.
-
-```typescript
-interface TraceTree
-```
-
 ## data
 
-### `StatementTimeoutError`
-
-A statement was cancelled by Postgres for running past the statement timeout a {@link withTimeouts} call set. `cause` is the driver error.
-
-```typescript
-class StatementTimeoutError extends Error constructor(readonly statementTimeoutMs: number, cause: unknown)
-```
+### `tap`
 
-### `LockTimeoutError`
-
-A statement gave up waiting for a lock past the lock timeout a {@link withTimeouts} call set. `cause` is the driver error.
+Opens a standalone managed connection outside the manifold's pools — the
+sanctioned door for contexts where `pipe()` structurally cannot resolve:
+`worker_threads`, detached monitors, one-off scripts. Callers own the
+lifecycle: always `await conn.close()`.
 
 ```typescript
-class LockTimeoutError extends Error constructor(readonly lockTimeoutMs: number, cause: unknown)
+function tap(url: string, options?: ConnectOptions): ManagedConnection
 ```
 
 ## request
@@ -1910,24 +1475,3 @@ Creates a PipeworkServer — wraps Fastify with auto request IDs, CORS, rate lim
 ```typescript
 function createServer(instance: Manifold, config: ServerConfig = if (instance.config.environment === 'production')
 ```
-
-## async
-
-### `serializeError`
-
-Serialize an arbitrary thrown value for durable storage in a job's `error_payload`.
-
-A bare `{ message, stack }` capture is a diagnostics trap: wrapper errors hide the
-root cause. Drizzle throws `DrizzleQueryError` whose `.message` is only the failed
-SQL text; the real `PostgresError` — carrying `code`/`detail`/`constraint`/`table`
-— lives on `.cause`. This walks the full `cause` chain and copies each error's
-own-enumerable properties (where both Drizzle's `query` and Postgres' fields live),
-so a dead-lettered job records *why* it failed, not just *which query* failed.
-
-Parameters are never stored (`params`, `parameters`, `args`, `types`); `query` is cut
-to 2,000 characters and any other string to 4,000, ending `…[truncated N chars]`.
-Non-Error values pass through unchanged. Circular `cause` references are broken.
-
-```typescript
-function serializeError(error: unknown): unknown
-```