handoff-app 2.0.0-12 → 2.0.0-13

package/src/app/components/McpIntegration/McpConfigDialog.tsx

@@ -134,18 +134,13 @@ type EndpointStatus = 'checking' | 'live' | 'unreachable';
 let cachedStatus: EndpointStatus | null = null;
 let inFlight: Promise<EndpointStatus> | null = null;
 
-/**
- * Statuses that prove the route is being served. A GET is the cheapest question to ask: the handler
- * answers 405 without ever building an MCP server, and a registry answers 401 ahead of that because
- * the credential check runs first. Anything else, 404 and 5xx included, means it is not there.
- */
-const LIVE_STATUSES = new Set([200, 401, 403, 405]);
-
 const probeEndpoint = (url: string): Promise<EndpointStatus> => {
   if (cachedStatus) return Promise.resolve(cachedStatus);
   if (inFlight) return inFlight;
-  inFlight = fetch(url, { method: 'GET' })
-    .then((res): EndpointStatus => (LIVE_STATUSES.has(res.status) ? 'live' : 'unreachable'))
+  // The endpoint answers HEAD with 204 before the credential check. Thus a served route never logs an
+  // error status to the console.
+  inFlight = fetch(url, { method: 'HEAD' })
+    .then((res): EndpointStatus => (res.ok ? 'live' : 'unreachable'))
     .catch((): EndpointStatus => 'unreachable')
     .then((status) => {
       cachedStatus = status;
@@ -184,29 +179,19 @@ const StatusDot: React.FC<{ status: EndpointStatus; className?: string }> = ({ s
   <span role="status" aria-label={DOT[status].label} title={DOT[status].label} className={cn('size-1.5 rounded-full', DOT[status].className, className)} />
 );
 
-const Snippet: React.FC<{ label: string; value: string; compact?: boolean }> = ({ label, value, compact }) => (
+const Snippet: React.FC<{ label: string; value: string }> = ({ label, value }) => (
   <div className="min-w-0 space-y-1.5">
     <div className="flex items-center justify-between gap-2">
       <code className="truncate rounded bg-muted px-1.5 py-0.5 text-[11px] text-muted-foreground">{label}</code>
       <CopyToClipboard value={value} tooltip={`Copy ${label}`} showTooltip={false} className="relative size-7 shrink-0" />
     </div>
-    <pre
-      className={cn(
-        'overflow-auto rounded-md border bg-muted/50 p-3 leading-relaxed',
-        compact ? 'max-h-48 text-[10px]' : 'max-h-64 text-xs'
-      )}
-    >
+    <pre className="max-h-64 overflow-auto rounded-md border bg-muted/50 p-3 text-xs leading-relaxed">
       <code>{value}</code>
     </pre>
   </div>
 );
 
-const ClientConfig: React.FC<{ client: McpClient; name: string; target: McpTarget; compact?: boolean }> = ({
-  client,
-  name,
-  target,
-  compact,
-}) => {
+const ClientConfig: React.FC<{ client: McpClient; name: string; target: McpTarget }> = ({ client, name, target }) => {
   // A one-click install would write the `<your-token>` placeholder verbatim and register a server
   // that cannot connect, so a registry gets the snippet and the token pointer instead.
   const deeplink = isRegistryRuntime ? undefined : client.deeplink?.(name, target);
@@ -222,8 +207,8 @@ const ClientConfig: React.FC<{ client: McpClient; name: string; target: McpTarge
           </a>
         </Button>
       )}
-      {command && <Snippet label="command line" value={command} compact={compact} />}
-      <Snippet label={client.configPath} value={JSON.stringify(client.file(name, target), null, 2)} compact={compact} />
+      {command && <Snippet label="command line" value={command} />}
+      <Snippet label={client.configPath} value={JSON.stringify(client.file(name, target), null, 2)} />
       <p className="text-xs text-muted-foreground">{client.note}</p>
     </div>
   );
@@ -261,8 +246,8 @@ const Credential: React.FC = () => (
   </p>
 );
 
-/** Endpoint, per-client config and credential guidance. Shared by the dialog and the mobile nav. */
-const ConnectionDetails: React.FC<{ url: string; status: EndpointStatus; compact?: boolean }> = ({ url, status, compact }) => {
+/** Endpoint, per-client config and credential guidance. */
+const ConnectionDetails: React.FC<{ url: string; status: EndpointStatus }> = ({ url, status }) => {
   const name = useServerName();
   const target: McpTarget = { url, headers: isRegistryRuntime ? CREDENTIAL_HEADERS : undefined };
 
@@ -279,7 +264,7 @@ const ConnectionDetails: React.FC<{ url: string; status: EndpointStatus; compact
         </TabsList>
         {CLIENTS.map((client) => (
           <TabsContent key={client.id} value={client.id} className="min-w-0">
-            <ClientConfig client={client} name={name} target={target} compact={compact} />
+            <ClientConfig client={client} name={name} target={target} />
           </TabsContent>
         ))}
       </Tabs>
@@ -323,27 +308,3 @@ const McpDialog: React.FC = () => {
     </Dialog>
   );
 };
-
-/**
- * Inline variant for the mobile nav, which is itself a sheet, so a nested dialog would sit on top of
- * it. It owns its divider, so a build without the endpoint renders nothing and leaves no stray rule.
- */
-export function McpConfigMobile() {
-  return isAvailable ? <McpMobile /> : null;
-}
-
-const McpMobile: React.FC = () => {
-  const url = useMcpEndpoint();
-  const status = useEndpointStatus(url);
-
-  return (
-    <div className="mt-4 space-y-3 border-t pt-4">
-      <div className="flex flex-wrap items-center gap-2">
-        <McpIcon className="h-4 w-4" />
-        <span className="text-sm font-medium">Connect a coding agent</span>
-        <RuntimeModeBadge mode={mode} />
-      </div>
-      <ConnectionDetails url={url} status={status} compact />
-    </div>
-  );
-};

package/src/app/components/Navigation/MobileNav.tsx

@@ -4,7 +4,6 @@ import { useTheme } from 'next-themes';
 import Link from 'next/link';
 import { useRouter } from 'next/router';
 import { AiAssistantMobileTrigger } from '../../components/AiAssistant/AiAssistantProvider';
-import { McpConfigMobile } from '../../components/McpIntegration/McpConfigDialog';
 import { Button } from '../../components/ui/button';
 import { Sheet, SheetContent, SheetHeader, SheetTitle, SheetTrigger } from '../../components/ui/sheet';
 import { cn } from '../../lib/utils';
@@ -72,7 +71,6 @@ export function MobileNav() {
                 </Link>
               );
             })}
-          <McpConfigMobile />
           <div className="mt-4 border-t pt-4">
             <Button variant="ghost" className="w-full justify-start font-normal" onClick={toggleTheme}>
               {theme === 'light' && (

package/src/app/components/util/index.ts

@@ -557,17 +557,6 @@ export const fetchDocPageMetadataAndContent = (localPath: string, slug: string |
  */
 export const filterOutUndefined = <T>(value: T): value is NonNullable<T> => value !== undefined;
 
-/**
- * Create a title string from a prefix
- * @param prefix
- * @returns
- */
-export const titleString = (prefix: string | null): string => {
-  const config = getClientRuntimeConfig();
-  const prepend = prefix ? `${prefix} | ` : '';
-  return `${prepend}${config?.app?.client} Design System`;
-};
-
 /**
  * Get the tokens for a component
  * @param component

package/src/app/lib/asset-storage.ts

@@ -1,20 +1,20 @@
 /**
- * Server-only asset storage runtime. Resolves the active adapter from the baked server runtime
- * config and lazily builds and memoizes it. Writes use the active adapter. Reads resolve by each
- * blob's recorded provider, so `database` blobs (inline bytea) stay readable when a `custom` adapter
- * is active. `database` has no adapter: its bytes live directly in `asset_blobs.content`.
+ * Server-only asset storage runtime. Resolves the active provider from the baked server runtime
+ * config and lazily builds and memoizes it. Writes use the active provider. Reads resolve by each
+ * blob's recorded provider, so `database` blobs (inline bytea) stay readable when a `custom` provider
+ * is active. `database` has no module: its bytes live directly in `asset_blobs.content`.
  *
  * Imported exclusively by registry API route handlers and the registry store.
  */
 
 import { resolveAssetStorageSettings, type ResolvedAssetStorage } from '@handoff/registry/asset-storage/resolve';
-import type { AssetStorage } from '@handoff/registry/asset-storage/types';
+import type { StorageProvider } from '@handoff/registry/asset-storage/types';
 import type { AssetStorageProvider } from '@handoff/registry/db/schema';
 import { getServerRuntimeConfig } from './docs-api/runtime-config';
 import { loadServerModule } from './server-module';
 
 let activeCache: ResolvedAssetStorage | null = null;
-const adapterCache = new Map<string, AssetStorage | null>();
+const providerCache = new Map<string, StorageProvider | null>();
 
 /** The active, fully-resolved asset storage settings for new uploads. */
 export const getActiveAssetStorage = (): ResolvedAssetStorage => {
@@ -32,49 +32,49 @@ export class AssetStorageError extends Error {
   }
 }
 
-/** Load a custom adapter module and coerce its default export (adapter object or factory) to an adapter. */
-const loadCustomAdapter = async (active: ResolvedAssetStorage): Promise<AssetStorage> => {
+/** Load a custom provider module and coerce its default export (provider object or factory) to a provider. */
+const loadCustomProvider = async (active: ResolvedAssetStorage): Promise<StorageProvider> => {
   if (!active.module) {
-    throw new AssetStorageError('A custom asset storage adapter is selected but no module path is configured.');
+    throw new AssetStorageError('A custom asset storage provider is selected but no module path is configured.');
   }
-  const candidate = (await loadServerModule(active.module, { options: active.options })) as Partial<AssetStorage> | null;
+  const candidate = (await loadServerModule(active.module, { options: active.options })) as Partial<StorageProvider> | null;
   if (!candidate || typeof candidate.put !== 'function' || typeof candidate.get !== 'function' || typeof candidate.delete !== 'function') {
-    throw new AssetStorageError(`Custom asset storage module "${active.module}" must default-export a defineAssetStorage adapter.`);
+    throw new AssetStorageError(`Custom asset storage module "${active.module}" must default-export a defineStorageProvider() result.`);
   }
-  return candidate as AssetStorage;
+  return candidate as StorageProvider;
 };
 
 /**
- * Resolve the {@link AssetStorage} adapter for a recorded provider, or `null` when the provider is the
- * inline `database` default (there is no adapter; content lives in the DB row). Reading a blob whose
+ * Resolve the {@link StorageProvider} for a recorded provider, or `null` when the provider is the
+ * inline `database` default (there is no module; content lives in the DB row). Reading a blob whose
  * provider is no longer configured throws an actionable error rather than silently failing.
  */
-export const getAssetStorageAdapter = async (provider: AssetStorageProvider): Promise<AssetStorage | null> => {
+export const getStorageProvider = async (provider: AssetStorageProvider): Promise<StorageProvider | null> => {
   if (provider === 'database') {
     return null;
   }
-  if (adapterCache.has(provider)) {
-    return adapterCache.get(provider) ?? null;
+  if (providerCache.has(provider)) {
+    return providerCache.get(provider) ?? null;
   }
 
   const active = getActiveAssetStorage();
-  if (active.adapterKind !== provider) {
+  if (active.provider !== provider) {
     throw new AssetStorageError(
-      `No asset storage adapter is configured for provider "${provider}". A blob was stored by that ` +
+      `No asset storage module is configured for provider "${provider}". A blob was stored by that ` +
         'provider but it is no longer selected. Restore its configuration to read it.'
     );
   }
-  const adapter = await loadCustomAdapter(active);
+  const storage = await loadCustomProvider(active);
 
-  adapterCache.set(provider, adapter);
-  return adapter;
+  providerCache.set(provider, storage);
+  return storage;
 };
 
-/** The adapter for the active provider (used for new uploads), or `null` for the inline database default. */
-export const getActiveAssetStorageAdapter = (): Promise<AssetStorage | null> => getAssetStorageAdapter(getActiveAssetStorage().adapterKind);
+/** The active provider (used for new uploads), or `null` for the inline database default. */
+export const getActiveStorageProvider = (): Promise<StorageProvider | null> => getStorageProvider(getActiveAssetStorage().provider);
 
 /** Reset memoized state (test seam only). */
 export const __resetAssetStorageCache = (): void => {
   activeCache = null;
-  adapterCache.clear();
+  providerCache.clear();
 };

package/src/app/lib/auth/email.ts

@@ -1,13 +1,12 @@
 import { isEnvReference, resolveEnvReferences } from '@handoff/config/from-env';
-import { createResendProvider } from '@handoff/registry/email/adapters/resend';
-import { createSmtpProvider } from '@handoff/registry/email/adapters/smtp';
+import { createSmtpProvider } from '@handoff/registry/email/providers/smtp';
 import type { EmailProviderKind, EmailSettings } from '@handoff/registry/email/resolve';
 import type { EmailProvider } from '@handoff/registry/email/types';
 import { getServerRuntimeConfig } from '../docs-api/runtime-config';
 import { loadServerModule } from '../server-module';
 
 /** Options a provider needs before email counts as configured. */
-const REQUIRED_OPTIONS: Record<EmailProviderKind, readonly string[]> = { resend: ['apiKey'], smtp: ['host'], custom: [] };
+const REQUIRED_OPTIONS: Record<EmailProviderKind, readonly string[]> = { smtp: ['host'], custom: [] };
 
 /**
  * The settings that still need a value, named as the administrator sets them: the config key, or the
@@ -17,6 +16,7 @@ export const missingRegistryEmailSettings = (): string[] => {
   const settings = getServerRuntimeConfig().email;
   const options = resolveEnvReferences(settings.options, process.env);
   const missing = settings.from ? [] : ['runtime.registry.email.from'];
+  if (!settings.provider) return [...missing, 'runtime.registry.email.provider'];
   if (settings.provider === 'custom' && !settings.module) missing.push('runtime.registry.email.module');
   for (const key of REQUIRED_OPTIONS[settings.provider]) {
     if (options[key] !== undefined) continue;
@@ -31,7 +31,7 @@ export const registryEmailIsConfigured = (): boolean => missingRegistryEmailSett
 /** The provider name for messages shown to an administrator. */
 export const registryEmailProviderName = (): string => {
   const { provider } = getServerRuntimeConfig().email;
-  return provider === 'resend' ? 'Resend' : provider === 'smtp' ? 'SMTP' : 'the custom email provider';
+  return provider === 'smtp' ? 'SMTP' : 'the custom email provider';
 };
 
 let customProvider: Promise<EmailProvider> | null = null;
@@ -46,7 +46,6 @@ const loadCustomProvider = async (settings: EmailSettings, options: Record<strin
 };
 
 const getEmailProvider = (settings: EmailSettings, options: Record<string, unknown>): Promise<EmailProvider> => {
-  if (settings.provider === 'resend') return Promise.resolve(createResendProvider(options));
   if (settings.provider === 'smtp') return Promise.resolve(createSmtpProvider(options));
   customProvider ??= loadCustomProvider(settings, options).catch((error) => {
     customProvider = null;

package/src/app/lib/docs-api/page-rendering.ts

@@ -31,7 +31,7 @@ export const documentationMetadata = (source: Record<string, unknown>) => {
   return {
     title,
     description,
-    metaTitle: value('metaTitle') || title,
+    metaTitle: value('metaTitle'),
     metaDescription: value('metaDescription') || description,
   };
 };

package/src/app/lib/docs-api/registry.ts

@@ -21,7 +21,7 @@ import {
 import { defaultPageDetail, type BakedDefaultPage } from './page-rendering';
 import { MAX_SEARCH_BODY_LENGTH, MAX_SEARCH_CANDIDATES, truncateSearchBody, type SearchResponse } from './search';
 import { getRegistryConnection } from '../registry-connection';
-import { getAssetStorageAdapter } from '../asset-storage';
+import { getStorageProvider } from '../asset-storage';
 // A static import includes package defaults in each registry serverless bundle. A deployed function
 // cannot read the build machine's `config/docs` directory.
 import defaultPages from '../../generated/default-pages.json';
@@ -148,8 +148,7 @@ const searchRegistryPages = async (db: RegistryDatabase, request: PageSearchRequ
 export const createRegistryDocsBackend = async (): Promise<DocsBackend> => {
   const connection = await getRegistryConnection();
   const { db } = connection;
-  // Inject the storage-adapter resolver so object-backed asset content resolves by provider id.
-  const store = createRegistryStore({ db, resolveAssetAdapter: getAssetStorageAdapter });
+  const store = createRegistryStore({ db, resolveStorageProvider: getStorageProvider });
 
   return {
     async listComponents() {

package/src/app/lib/docs-api/runtime-config.ts

@@ -2,9 +2,9 @@ import fs from 'fs-extra';
 import path from 'path';
 import type { RuntimeMode } from '@handoff/types/config';
 import { DEFAULT_DATABASE_URL_ENV, DEFAULT_REGISTRY_DRIVER, type RegistryDatabaseDriver } from '@handoff/registry/db/driver';
-import { DEFAULT_ASSET_STORAGE_ADAPTER, type AssetStorageSettings } from '@handoff/registry/asset-storage/resolve';
+import { DEFAULT_ASSET_STORAGE_PROVIDER, type AssetStorageSettings } from '@handoff/registry/asset-storage/resolve';
 import { mergeAiConnections, parseAiConnections, type AiSettings } from '@handoff/ai/connections';
-import { DEFAULT_EMAIL_PROVIDER, parseEmailSettings, type EmailSettings } from '@handoff/registry/email/resolve';
+import { parseEmailSettings, type EmailSettings } from '@handoff/registry/email/resolve';
 
 /**
  * Server-side runtime resolution for the docs read API.
@@ -41,7 +41,7 @@ export interface ServerRuntimeConfig {
   ai: AiSettings;
   registry: ServerRegistryRuntimeConfig;
   /**
-   * Asset storage adapter, module, and options for registry mode. Options hold `{ $env }` references,
+   * Asset storage provider, module, and options for registry mode. Options hold `{ $env }` references,
    * never secret values.
    */
   assetStorage: AssetStorageSettings;
@@ -60,13 +60,13 @@ const defaults = (): ServerRuntimeConfig => ({
     driver: DEFAULT_REGISTRY_DRIVER,
     databaseUrlEnv: DEFAULT_DATABASE_URL_ENV,
   },
-  assetStorage: { adapter: DEFAULT_ASSET_STORAGE_ADAPTER },
-  email: { provider: DEFAULT_EMAIL_PROVIDER, options: {} },
+  assetStorage: { provider: DEFAULT_ASSET_STORAGE_PROVIDER },
+  email: { options: {} },
 });
 
 /** Parse the baked asset-storage selection from env (names/selectors only; JSON options tolerated). */
 const assetStorageFromEnv = (): AssetStorageSettings => {
-  const adapter = process.env.HANDOFF_ASSET_STORAGE_ADAPTER?.trim();
+  const provider = process.env.HANDOFF_ASSET_STORAGE_PROVIDER?.trim();
   let options: Record<string, unknown> | undefined;
   const rawOptions = process.env.HANDOFF_ASSET_STORAGE_OPTIONS?.trim();
   if (rawOptions) {
@@ -79,7 +79,7 @@ const assetStorageFromEnv = (): AssetStorageSettings => {
   }
   const maxInline = Number(process.env.HANDOFF_ASSET_STORAGE_MAX_INLINE_BYTES);
   return {
-    adapter: adapter === 'custom' ? adapter : DEFAULT_ASSET_STORAGE_ADAPTER,
+    provider: provider === 'custom' ? provider : DEFAULT_ASSET_STORAGE_PROVIDER,
     module: process.env.HANDOFF_ASSET_STORAGE_MODULE?.trim() || undefined,
     maxInlineBytes: Number.isFinite(maxInline) && maxInline > 0 ? maxInline : undefined,
     options,
@@ -167,7 +167,7 @@ export const getServerRuntimeConfig = (): ServerRuntimeConfig => {
           ? parsed.registry.databaseUrlEnv.trim()
           : DEFAULT_DATABASE_URL_ENV;
       const assetStorage: AssetStorageSettings =
-        parsed?.assetStorage && typeof parsed.assetStorage === 'object' ? parsed.assetStorage : { adapter: DEFAULT_ASSET_STORAGE_ADAPTER };
+        parsed?.assetStorage && typeof parsed.assetStorage === 'object' ? parsed.assetStorage : { provider: DEFAULT_ASSET_STORAGE_PROVIDER };
       cached = {
         mode: parsed?.mode === 'registry' ? 'registry' : 'workspace',
         mcp: parsed?.mcp !== false,

package/src/app/lib/registry-api/asset-transfer.ts

@@ -6,9 +6,9 @@ import type { RegistryDatabase } from '@handoff/registry/db/client';
 import { assetBlobs, assetCollections, assets } from '@handoff/registry/db/schema';
 import { isAssetCollection, type AssetCollection } from '@handoff/registry/assets/sets';
 import type { AssetCollectionTransferPackage, AssetManifestEntry } from '@handoff/registry/assets/transfer';
-import type { AssetStorage } from '@handoff/registry/asset-storage/types';
+import type { StorageProvider } from '@handoff/registry/asset-storage/types';
 import { singleQueryValue } from '../api/query';
-import { getActiveAssetStorage, getActiveAssetStorageAdapter, getAssetStorageAdapter } from '../asset-storage';
+import { getActiveAssetStorage, getActiveStorageProvider, getStorageProvider } from '../asset-storage';
 import { sendRegistryError } from './errors';
 import { buildMeta } from './meta';
 import { handleRegistryRoute, sendRegistryData } from './handler';
@@ -318,10 +318,10 @@ export const handleAssetBlobRoute = (req: NextApiRequest, res: NextApiResponse):
         'application/octet-stream';
       const active = getActiveAssetStorage();
 
-      const storageProvider = active.adapterKind;
+      const storageProvider = active.provider;
       let content: Buffer | null = null;
       let storageRef: string | null = null;
-      if (active.adapterKind === 'database') {
+      if (active.provider === 'database') {
         if (bytes.length > active.maxInlineBytes) {
           sendRegistryError(
             res,
@@ -332,12 +332,12 @@ export const handleAssetBlobRoute = (req: NextApiRequest, res: NextApiResponse):
         }
         content = bytes;
       } else {
-        const adapter = await getActiveAssetStorageAdapter();
-        if (!adapter) {
-          sendRegistryError(res, 'unexpected_error', `No storage adapter is available for provider "${active.adapterKind}".`);
+        const storage = await getActiveStorageProvider();
+        if (!storage) {
+          sendRegistryError(res, 'unexpected_error', `No asset storage is available for provider "${active.provider}".`);
           return;
         }
-        ({ storageRef } = await adapter.put({ hash, bytes, contentType, size: bytes.length }));
+        ({ storageRef } = await storage.put({ hash, bytes, contentType, size: bytes.length }));
       }
 
       await db
@@ -376,12 +376,12 @@ export const handleAssetBlobRoute = (req: NextApiRequest, res: NextApiResponse):
       sendRegistryError(res, 'not_found', `Blob "${hash}" has no resolvable content.`);
       return;
     }
-    const adapter = await getAssetStorageAdapter(blob.storageProvider);
-    if (!adapter) {
-      sendRegistryError(res, 'unexpected_error', `No storage adapter is available for provider "${blob.storageProvider}".`);
+    const storage = await getStorageProvider(blob.storageProvider);
+    if (!storage) {
+      sendRegistryError(res, 'unexpected_error', `No asset storage is available for provider "${blob.storageProvider}".`);
       return;
     }
-    const result = await adapter.get(blob.storageRef);
+    const result = await storage.get(blob.storageRef);
     if (result.kind === 'redirect') {
       res.redirect(302, result.url);
       return;
@@ -394,13 +394,13 @@ export const handleAssetBlobRoute = (req: NextApiRequest, res: NextApiResponse):
     result.stream.pipe(res);
   });
 
-/** The active adapter when it supports direct uploads, otherwise `null` (the client then uses `PUT`). */
-const getDirectUploadAdapter = async (): Promise<AssetStorage | null> => {
-  if (getActiveAssetStorage().adapterKind === 'database') {
+/** The active provider when it supports direct uploads, otherwise `null` (the client then uses `PUT`). */
+const getDirectUploadProvider = async (): Promise<StorageProvider | null> => {
+  if (getActiveAssetStorage().provider === 'database') {
     return null;
   }
-  const adapter = await getActiveAssetStorageAdapter();
-  return adapter?.createUpload ? adapter : null;
+  const storage = await getActiveStorageProvider();
+  return storage?.createUpload ? storage : null;
 };
 
 const readDirectUploadRequest = (req: NextApiRequest, res: NextApiResponse): { hash: string; size: number; contentType: string } | null => {
@@ -422,8 +422,8 @@ const readDirectUploadRequest = (req: NextApiRequest, res: NextApiResponse): { h
  * Throw unless `storageRef` resolves to a stored object. A redirect is checked with a one-byte
  * ranged `GET`, because a signed read URL usually rejects `HEAD`.
  */
-const assertStored = async (adapter: AssetStorage, storageRef: string, size: number): Promise<void> => {
-  const result = await adapter.get(storageRef);
+const assertStored = async (storage: StorageProvider, storageRef: string, size: number): Promise<void> => {
+  const result = await storage.get(storageRef);
   if (result.kind === 'bytes') {
     if (result.bytes.length !== size) {
       throw new Error(`stored size ${result.bytes.length} does not match ${size}`);
@@ -452,8 +452,8 @@ export const handleAssetBlobUploadRoute = (req: NextApiRequest, res: NextApiResp
       sendRegistryData(res, 200, { upload: null, stored: true }, buildMeta());
       return;
     }
-    const adapter = await getDirectUploadAdapter();
-    const upload = adapter?.createUpload ? await adapter.createUpload(input) : null;
+    const storage = await getDirectUploadProvider();
+    const upload = storage?.createUpload ? await storage.createUpload(input) : null;
     sendRegistryData(res, 200, { upload }, buildMeta());
   });
 
@@ -468,13 +468,13 @@ export const handleAssetBlobCompleteRoute = (req: NextApiRequest, res: NextApiRe
       return;
     }
 
-    const adapter = await getDirectUploadAdapter();
-    if (!adapter) {
+    const storage = await getDirectUploadProvider();
+    if (!storage) {
       sendRegistryError(res, 'bad_request', 'The active asset storage provider does not accept direct uploads.');
       return;
     }
     try {
-      await assertStored(adapter, storageRef, input.size);
+      await assertStored(storage, storageRef, input.size);
     } catch (error) {
       const reason = error instanceof Error ? error.message : String(error);
       sendRegistryError(res, 'bad_request', `Blob "${input.hash}" was not found in storage (${reason}).`, {
@@ -487,7 +487,7 @@ export const handleAssetBlobCompleteRoute = (req: NextApiRequest, res: NextApiRe
       .insert(assetBlobs)
       .values({
         hash: input.hash,
-        storageProvider: getActiveAssetStorage().adapterKind,
+        storageProvider: getActiveAssetStorage().provider,
         content: null,
         storageRef,
         contentType: input.contentType,

package/src/app/lib/server-module.ts

@@ -4,7 +4,7 @@ import { pathToFileURL } from 'url';
 import { resolveEnvReferences } from '@handoff/config/from-env';
 
 /**
- * Import a consumer's server-only module (a custom asset storage adapter, AI provider or email
+ * Import a consumer's server-only module (a custom asset storage, AI or email
  * provider) by the path the config gives, relative to the project.
  *
  * A registry bundle mirrors the tracing root and runs with its root as the working directory, so the

package/src/app/lib/utils.ts

@@ -51,3 +51,10 @@ export const filterOutNull = <T>(value: T): value is NonNullable<T> => value !==
  */
 export const hasRenderableNav = (section?: SectionLink | null): boolean =>
   !!section?.subSections?.some((sub) => (sub.menu && sub.menu.length > 0) || !!sub.dynamic);
+
+/**
+ * The browser title: a page's own `metaTitle` as written, otherwise its title followed by the
+ * site title from `app.title`.
+ */
+export const pageTitle = (metadata: { title?: string; metaTitle?: string }, siteTitle?: string): string =>
+  metadata.metaTitle || [metadata.title, siteTitle].filter(Boolean).join(' | ');

package/src/app/next.config.mjs

@@ -113,9 +113,9 @@ const nextConfig = {
     HANDOFF_AI_DEFAULT_MODEL: '%HANDOFF_AI_DEFAULT_MODEL%',
     HANDOFF_REGISTRY_DRIVER: '%HANDOFF_REGISTRY_DRIVER%',
     HANDOFF_REGISTRY_DATABASE_URL_ENV: '%HANDOFF_REGISTRY_DATABASE_URL_ENV%',
-    // Asset storage adapter, module, and options JSON. Option references keep only their variable
+    // Asset storage provider, module, and options JSON. Option references keep only their variable
     // name and are resolved at request time, so secret values are never baked.
-    HANDOFF_ASSET_STORAGE_ADAPTER: '%HANDOFF_ASSET_STORAGE_ADAPTER%',
+    HANDOFF_ASSET_STORAGE_PROVIDER: '%HANDOFF_ASSET_STORAGE_PROVIDER%',
     HANDOFF_ASSET_STORAGE_MODULE: '%HANDOFF_ASSET_STORAGE_MODULE%',
     HANDOFF_ASSET_STORAGE_MAX_INLINE_BYTES: '%HANDOFF_ASSET_STORAGE_MAX_INLINE_BYTES%',
     HANDOFF_ASSET_STORAGE_OPTIONS: '%HANDOFF_ASSET_STORAGE_OPTIONS%',

package/src/app/pages/[...slug]/index.tsx

@@ -20,6 +20,7 @@ import {
 } from '../../components/util';
 import { resolveDocsBackend } from '../../lib/docs-api/backend';
 import { documentationMetadata, REGISTRY_PAGE_REVALIDATE_SECONDS } from '../../lib/docs-api/page-rendering';
+import { pageTitle } from '../../lib/utils';
 import { Home, getStaticProps as getHomeStaticProps } from '../index';
 
 type CatchAllDocumentationProps = DocumentationProps & { homeAlias?: boolean };
@@ -114,7 +115,7 @@ export default function DocCatchAllPage({
     return (
       <div className="flex min-h-screen flex-col items-center justify-center bg-white dark:bg-gray-900">
         <Head>
-          <title>404 - Page Not Found</title>
+          <title>{pageTitle({ title: 'Page Not Found' }, config?.app?.title)}</title>
           <meta name="description" content="Page Not Found" />
         </Head>
         <NotFound />

package/src/app/pages/account/ai.tsx

@@ -34,7 +34,7 @@ export const getStaticProps: GetStaticProps = async () => ({ props: { config: ge
 
 export default function AiKeysPage({ config }: { config: ClientConfig }) {
   if (process.env.HANDOFF_RUNTIME_MODE !== 'registry') {
-    return <AccountLayout title="AI providers">{null}</AccountLayout>;
+    return <AccountLayout config={config} title="AI providers">{null}</AccountLayout>;
   }
 
   return <RegistryAiKeysPage config={config} />;

package/src/app/pages/account/index.tsx

@@ -25,7 +25,7 @@ export const getStaticProps: GetStaticProps = async () => ({ props: { config: ge
 
 export default function AccountPage({ config }: { config: ClientConfig }) {
   if (process.env.HANDOFF_RUNTIME_MODE !== 'registry') {
-    return <AccountLayout title="Profile">{null}</AccountLayout>;
+    return <AccountLayout config={config} title="Profile">{null}</AccountLayout>;
   }
 
   return <RegistryAccountPage config={config} />;

package/src/app/pages/account/tokens.tsx

@@ -37,7 +37,7 @@ export const getStaticProps: GetStaticProps = async () => ({ props: { config: ge
 
 export default function TokensPage({ config }: { config: ClientConfig }) {
   if (process.env.HANDOFF_RUNTIME_MODE !== 'registry') {
-    return <AccountLayout title="Access tokens">{null}</AccountLayout>;
+    return <AccountLayout config={config} title="Access tokens">{null}</AccountLayout>;
   }
 
   return <RegistryTokensPage config={config} />;

package/src/app/pages/account/users.tsx

@@ -37,7 +37,7 @@ export const getStaticProps: GetStaticProps = async () => ({ props: { config: ge
 
 export default function UsersPage({ config }: { config: ClientConfig }) {
   if (process.env.HANDOFF_RUNTIME_MODE !== 'registry') {
-    return <AccountLayout title="Users">{null}</AccountLayout>;
+    return <AccountLayout config={config} title="Users">{null}</AccountLayout>;
   }
 
   return <RegistryUsersPage config={config} />;

package/src/app/pages/api/docs/nav.json.ts

@@ -5,7 +5,7 @@ import { ensureGet, resolveDocsBackend, sendDocsData, sendDocsError } from '@/li
 // Kept static so the baked structure is traced into every registry serverless bundle.
 import navShell from '@/generated/nav-shell.json';
 
-/** Thin registry refresh adapter. The adapter/resolver owns all navigation structure and filling. */
+/** Thin route: `getRegistryNavData` builds and fills the whole navigation. */
 export default async function handler(req: NextApiRequest, res: NextApiResponse): Promise<void> {
   if (!ensureGet(req, res)) return;
 

package/src/app/pages/api/mcp.ts

@@ -22,6 +22,12 @@ export default async function handler(req: NextApiRequest, res: NextApiResponse)
     return;
   }
 
+  // The status probe of the docs app. A 204 shows only that the route is served, so the probe needs no credential.
+  if (req.method === 'HEAD') {
+    res.status(204).end();
+    return;
+  }
+
   if (!(await authorizeMcpRequest(req, res))) {
     return;
   }

package/src/app/pages/api/registry/transfer/assets/blobs/[hash].ts

@@ -5,7 +5,7 @@ import { handleAssetBlobRoute } from '@/lib/registry-api/asset-transfer';
  * `/api/registry/transfer/assets/blobs/:hash`: one content-addressed blob.
  *
  * - `PUT` stores the raw binary body through the active storage provider (inline `bytea` by default,
- *   or an object-storage adapter). Idempotent by hash; requires a `registry:write` token.
+ *   or a custom storage provider). Idempotent by hash; requires a `registry:write` token.
  * - `GET` returns the blob's bytes, or redirects to a provider URL for object-backed content.
  *   Requires a `registry:read` token.
  *