@agntcms/next 0.2.0

package/dist/handlers.d.cts

@@ -0,0 +1,330 @@
+import { C as ContentStorageAdapter, A as AssetStorageAdapter } from './assets-Cyt9upqW.cjs';
+import { l as Runtime, R as RateLimit } from './rateLimit-CiROGTLE.cjs';
+import { A as AnyFormDefinition, o as SubmissionStorageAdapter } from './form-BqY0H1V5.cjs';
+import './global-CV23g5Bn.cjs';
+
+type TaskId = string;
+interface Task {
+    readonly id: TaskId;
+    readonly type: string;
+    readonly payload: unknown;
+}
+type TaskResult = unknown;
+type TaskState = 'pending' | 'in_progress' | 'completed' | 'failed';
+type TaskEvent = {
+    readonly kind: 'progress';
+    readonly message: string;
+} | {
+    readonly kind: 'completed';
+    readonly result: TaskResult;
+} | {
+    readonly kind: 'failed';
+    readonly error: string;
+};
+interface TaskSnapshot {
+    readonly id: TaskId;
+    readonly type: string;
+    readonly state: TaskState;
+    readonly result?: TaskResult;
+    readonly error?: string;
+}
+type TaskEventListener = (event: TaskEvent) => void;
+type Unsubscribe = () => void;
+interface TaskStore {
+    readonly create: (task: Task) => Promise<TaskResult>;
+    readonly get: (id: TaskId) => TaskSnapshot | undefined;
+    readonly progress: (id: TaskId, message: string) => void;
+    readonly complete: (id: TaskId, result: TaskResult) => void;
+    readonly fail: (id: TaskId, error: string) => void;
+    readonly subscribe: (id: TaskId, listener: TaskEventListener) => Unsubscribe;
+}
+
+declare const createTaskStore: () => TaskStore;
+
+type AgentBridgeStatus = 'stopped' | 'starting' | 'running' | 'failed';
+/**
+ * Typed error subclass thrown when `pushTask` is called against a bridge
+ * that is not in the 'running' state, or when `start()` fails the health
+ * check. The handler layer discriminates on this class to choose a 503
+ * vs 500 HTTP status.
+ */
+declare class AgentUnreachableError extends Error {
+    readonly name = "AgentUnreachableError";
+    readonly status: AgentBridgeStatus;
+    constructor(message: string, status: AgentBridgeStatus);
+}
+interface AgentBridge {
+    /**
+     * Health-checks the channel server. Idempotent: calling it twice on a
+     * started bridge returns the same promise (so concurrent callers
+     * converge on a single check). Calling it after `stop()` re-starts.
+     */
+    readonly start: () => Promise<void>;
+    /**
+     * Registers `task` with the injected task store, then fires an HTTP
+     * POST to the channel server. The returned promise IS the store's
+     * promise: it resolves when the channel server POSTs back a
+     * `task_callback` with event 'completed'.
+     *
+     * Rejects with `AgentUnreachableError` if the bridge is not 'running'.
+     */
+    readonly pushTask: (task: Task) => Promise<TaskResult>;
+    /**
+     * Fails all inflight tasks. Idempotent. Safe to call before `start`,
+     * during `start`, after `start` succeeds, and after failure. Never
+     * throws.
+     */
+    readonly stop: () => Promise<void>;
+    /**
+     * Synchronous status getter. Handlers call this to emit 503-style
+     * errors without having to await a round-trip to the bridge.
+     */
+    readonly status: () => AgentBridgeStatus;
+}
+interface CreateAgentBridgeOptions {
+    readonly taskStore: TaskStore;
+    /** Port the channel server listens on. Defaults to 4819. */
+    readonly channelPort?: number;
+    /** Host the channel server listens on. Defaults to '127.0.0.1'. */
+    readonly channelHost?: string;
+    /** Callback URL the channel server will POST results to. Defaults to 'http://localhost:3000/api/agntcms/mcp'. */
+    readonly callbackUrl?: string;
+    /**
+     * How long to wait, after the HTTP POST to the channel server has
+     * returned 200, for the agent to acknowledge via `report_task_progress`
+     * or `report_task_done` before failing the task with
+     * `TASK_ACK_TIMEOUT_MESSAGE`. Default 15000 ms.
+     *
+     * Set to 0 to disable the watchdog (useful for tests that drive the
+     * store manually).
+     *
+     * Once any progress or terminal event has been seen, the watchdog is
+     * considered satisfied and is not re-armed. The agent owns the
+     * long-tail timing after that point.
+     */
+    readonly taskAckTimeoutMs?: number;
+    /** Test seam: override fetch for HTTP calls. */
+    readonly fetch?: typeof globalThis.fetch;
+    /**
+     * Test seams for the watchdog timer. When `taskAckTimeoutMs > 0`, the
+     * bridge calls `setTimeoutFn(callback, ms)` and `clearTimeoutFn(handle)`
+     * to drive the watchdog. Defaults to the global `setTimeout` /
+     * `clearTimeout`.
+     */
+    readonly setTimeoutFn?: (cb: () => void, ms: number) => unknown;
+    readonly clearTimeoutFn?: (handle: unknown) => void;
+}
+/**
+ * Primary factory. See file header for design notes.
+ */
+declare const createAgentBridge: (options: CreateAgentBridgeOptions) => AgentBridge;
+
+interface McpHandlerDeps {
+    readonly bridge: AgentBridge;
+    readonly taskStore: TaskStore;
+}
+interface McpHandler {
+    readonly POST: (req: Request) => Promise<Response>;
+}
+declare const createMcpHandler: (deps: McpHandlerDeps) => McpHandler;
+
+interface EventsHandlerDeps {
+    readonly taskStore: TaskStore;
+}
+interface EventsHandler {
+    readonly GET: (req: Request) => Response;
+}
+declare const createEventsHandler: (deps: EventsHandlerDeps) => EventsHandler;
+
+interface PreviewToken {
+    readonly token: string;
+    readonly slug: string;
+    readonly createdAt: number;
+}
+interface PreviewTokenStoreOptions {
+    /** Time-to-live in milliseconds. Defaults to 600_000 (10 minutes). */
+    readonly ttlMs?: number;
+}
+interface PreviewTokenStore {
+    /** Issue a new single-use preview token for the given slug. */
+    readonly issue: (slug: string) => PreviewToken;
+    /**
+     * Consume a token. Returns the associated slug if the token exists and
+     * has not expired; returns `null` otherwise. A consumed token is deleted
+     * and cannot be reused.
+     */
+    readonly consume: (token: string) => string | null;
+}
+
+declare const createPreviewTokenStore: (options?: PreviewTokenStoreOptions) => PreviewTokenStore;
+
+interface PreviewHandlerDeps {
+    /** Cookie name used for preview mode flag. Default: '__agntcms_preview' */
+    readonly cookieName?: string;
+    /** Optional token store for single-use preview links. */
+    readonly tokenStore?: PreviewTokenStore;
+}
+interface PreviewHandler {
+    /** POST /api/agntcms/preview/enter -- enable preview mode */
+    readonly enter: (req: Request) => Response;
+    /** POST /api/agntcms/preview/exit -- disable preview mode */
+    readonly exit: (req: Request) => Response;
+    /** GET /api/agntcms/preview/enter?token=... -- token exchange + redirect */
+    readonly enterWithToken: (req: Request) => Response;
+    /** POST /api/agntcms/preview/token -- issue a single-use preview token */
+    readonly issueToken: (req: Request) => Promise<Response>;
+}
+declare function createPreviewHandler(deps?: PreviewHandlerDeps): PreviewHandler;
+
+interface DraftHandlerDeps {
+    readonly contentAdapter: ContentStorageAdapter;
+    readonly runtime: Runtime;
+}
+interface DraftHandler {
+    /** POST /api/agntcms/draft/save -- save a draft page */
+    readonly save: (req: Request) => Promise<Response>;
+    /** GET /api/agntcms/draft/list -- list all drafts */
+    readonly list: (req: Request) => Promise<Response>;
+    /** POST /api/agntcms/draft/publish -- publish a draft */
+    readonly publish: (req: Request) => Promise<Response>;
+    /** POST /api/agntcms/draft/reorder -- reorder sections within a draft */
+    readonly reorder: (req: Request) => Promise<Response>;
+    /** POST /api/agntcms/draft/discard -- delete a draft (published version must exist) */
+    readonly discard: (req: Request) => Promise<Response>;
+}
+declare function createDraftHandler(deps: DraftHandlerDeps): DraftHandler;
+
+interface AssetsHandlerDeps {
+    readonly assetAdapter: AssetStorageAdapter;
+}
+interface AssetsHandler {
+    /** GET /api/agntcms/assets -- list every asset (newest first) */
+    readonly list: (req: Request) => Promise<Response>;
+    /** POST /api/agntcms/assets -- upload bytes */
+    readonly upload: (req: Request) => Promise<Response>;
+}
+declare function createAssetsHandler(deps: AssetsHandlerDeps): AssetsHandler;
+
+interface PageHandlerDeps {
+    readonly contentAdapter: ContentStorageAdapter;
+    /**
+     * Runtime instance. Required: `rollback` saves a draft then republishes
+     * it via `runtime.publishDraft`, and the `tag/limit/sort` mode of `list`
+     * routes through `runtime.listPages`. Both code paths are part of the
+     * public surface, so the type forbids constructing the handler without
+     * it. Template route files (frozen zone) all wire it in.
+     */
+    readonly runtime: Runtime;
+}
+interface PageHandler {
+    readonly list: (req: Request) => Promise<Response>;
+    readonly read: (req: Request) => Promise<Response>;
+    readonly deletePage: (req: Request) => Promise<Response>;
+    readonly unpublish: (req: Request) => Promise<Response>;
+    readonly listHistory: (req: Request) => Promise<Response>;
+    readonly rollback: (req: Request) => Promise<Response>;
+    readonly rename: (req: Request) => Promise<Response>;
+    /** POST /api/agntcms/page/duplicate -- clone a page under a new slug as a draft */
+    readonly duplicate: (req: Request) => Promise<Response>;
+}
+declare function createPageHandler(deps: PageHandlerDeps): PageHandler;
+
+interface GlobalHandlerDeps {
+    readonly contentAdapter: ContentStorageAdapter;
+    /** When provided, `save` rejects types not in this set with 400 `unknown_type`. */
+    readonly allowedTypes?: ReadonlySet<string>;
+    /** Pre-resolved section defaults. When provided, the save handler fills
+     *  missing fields in global data with these defaults so that a freshly
+     *  created global (with `data: {}`) starts with valid placeholder values
+     *  instead of crashing the section component at render time. */
+    readonly sectionDefaults?: ReadonlyMap<string, Readonly<Record<string, unknown>>>;
+}
+interface GlobalHandler {
+    /** GET /api/agntcms/global/list */
+    readonly list: (req: Request) => Promise<Response>;
+    /** GET /api/agntcms/global/read?name=xxx */
+    readonly read: (req: Request) => Promise<Response>;
+    /** POST /api/agntcms/global/save */
+    readonly save: (req: Request) => Promise<Response>;
+    /** POST /api/agntcms/global/delete */
+    readonly delete: (req: Request) => Promise<Response>;
+    /**
+     * GET /api/agntcms/global/history?name=xxx[&ts=...]
+     *
+     * Without `ts`: returns the list of history entries for the global.
+     * With `ts`: returns the full body of the matching single snapshot.
+     * Mirrors the page handler's `listHistory`/?ts= behaviour exactly.
+     */
+    readonly listHistory: (req: Request) => Promise<Response>;
+    /** POST /api/agntcms/global/rollback — body: { name, timestamp } */
+    readonly rollback: (req: Request) => Promise<Response>;
+}
+declare function createGlobalHandler(deps: GlobalHandlerDeps): GlobalHandler;
+
+/**
+ * Template definition shape matching `PageTemplate` from config.
+ * Redeclared here as a structural type so the handler does not import
+ * from config/ (invariant 1).
+ */
+interface TemplateDef {
+    readonly name: string;
+    readonly description?: string;
+    readonly sectionTypes: readonly string[];
+}
+interface TemplateHandlerDeps {
+    /**
+     * Pre-resolved map: section type name -> default data for that section.
+     * Built by the wiring layer from the registered `AnySectionDefinition[]`.
+     */
+    readonly sectionDefaults: ReadonlyMap<string, Readonly<Record<string, unknown>>>;
+    /** The template definitions from config. */
+    readonly templates: readonly TemplateDef[];
+}
+interface TemplateHandler {
+    /** GET /api/agntcms/template/list */
+    readonly list: (req: Request) => Promise<Response>;
+}
+declare function createTemplateHandler(deps: TemplateHandlerDeps): TemplateHandler;
+
+interface SubmitHandlerDeps {
+    readonly runtime: Runtime;
+    readonly rateLimit: RateLimit;
+}
+declare function createSubmitFormHandler(deps: SubmitHandlerDeps): (req: Request) => Promise<Response>;
+
+/**
+ * Adapter info surfaced to the AdminModal. Two shapes:
+ *   - `{ kind: 'fs' }`               — local FS submissions; readable.
+ *   - `{ kind: 'webhook', host }`    — webhook adapter; not locally readable.
+ */
+type FormsListAdapterInfo = {
+    readonly kind: 'fs';
+} | {
+    readonly kind: 'webhook';
+    readonly host: string;
+};
+interface FormsListHandlerDeps {
+    /** Registered form definitions (from `defineConfig({ forms: [...] })`). */
+    readonly forms: ReadonlyArray<AnyFormDefinition>;
+    /**
+     * Optional adapter descriptor. When omitted, the handler reports
+     * `{ kind: 'fs' }` — the v1 default adapter (ARCHITECTURE.md §6.5).
+     * Frozen routes that wire a webhook adapter pass `{ kind: 'webhook',
+     * host: '<host>' }` here; the host is computed once at handler-construction
+     * time from the configured webhook URL.
+     */
+    readonly adapter?: FormsListAdapterInfo;
+}
+/** Forms list handler. */
+declare function createFormsListHandler(deps: FormsListHandlerDeps): (_req: Request) => Promise<Response>;
+
+interface FormsReadHandlerDeps {
+    readonly submissionAdapter: SubmissionStorageAdapter;
+    /** Registered form names — used to 404 unknown forms before hitting the adapter. */
+    readonly knownForms: ReadonlySet<string>;
+}
+declare function createFormsReadHandler(deps: FormsReadHandlerDeps): (req: Request) => Promise<Response>;
+
+declare function createFormsDeleteHandler(): (_req: Request) => Promise<Response>;
+
+export { type AgentBridge, type AgentBridgeStatus, AgentUnreachableError, type AssetsHandler, type AssetsHandlerDeps, type CreateAgentBridgeOptions, type DraftHandler, type DraftHandlerDeps, type EventsHandler, type EventsHandlerDeps, type FormsListAdapterInfo, type FormsListHandlerDeps, type FormsReadHandlerDeps, type GlobalHandler, type GlobalHandlerDeps, type McpHandler, type McpHandlerDeps, type PageHandler, type PageHandlerDeps, type PreviewHandler, type PreviewHandlerDeps, type PreviewToken, type PreviewTokenStore, type PreviewTokenStoreOptions, type SubmitHandlerDeps, type Task, type TaskEvent, type TaskId, type TaskSnapshot, type TaskState, type TaskStore, type TemplateHandler, type TemplateHandlerDeps, createAgentBridge, createAssetsHandler, createDraftHandler, createEventsHandler, createFormsDeleteHandler, createFormsListHandler, createFormsReadHandler, createGlobalHandler, createMcpHandler, createPageHandler, createPreviewHandler, createPreviewTokenStore, createSubmitFormHandler, createTaskStore, createTemplateHandler };

package/dist/handlers.d.ts

@@ -0,0 +1,330 @@
+import { C as ContentStorageAdapter, A as AssetStorageAdapter } from './assets-P8OCigDG.js';
+import { l as Runtime, R as RateLimit } from './rateLimit-CXptRM_K.js';
+import { A as AnyFormDefinition, o as SubmissionStorageAdapter } from './form-BqY0H1V5.js';
+import './global-CV23g5Bn.js';
+
+type TaskId = string;
+interface Task {
+    readonly id: TaskId;
+    readonly type: string;
+    readonly payload: unknown;
+}
+type TaskResult = unknown;
+type TaskState = 'pending' | 'in_progress' | 'completed' | 'failed';
+type TaskEvent = {
+    readonly kind: 'progress';
+    readonly message: string;
+} | {
+    readonly kind: 'completed';
+    readonly result: TaskResult;
+} | {
+    readonly kind: 'failed';
+    readonly error: string;
+};
+interface TaskSnapshot {
+    readonly id: TaskId;
+    readonly type: string;
+    readonly state: TaskState;
+    readonly result?: TaskResult;
+    readonly error?: string;
+}
+type TaskEventListener = (event: TaskEvent) => void;
+type Unsubscribe = () => void;
+interface TaskStore {
+    readonly create: (task: Task) => Promise<TaskResult>;
+    readonly get: (id: TaskId) => TaskSnapshot | undefined;
+    readonly progress: (id: TaskId, message: string) => void;
+    readonly complete: (id: TaskId, result: TaskResult) => void;
+    readonly fail: (id: TaskId, error: string) => void;
+    readonly subscribe: (id: TaskId, listener: TaskEventListener) => Unsubscribe;
+}
+
+declare const createTaskStore: () => TaskStore;
+
+type AgentBridgeStatus = 'stopped' | 'starting' | 'running' | 'failed';
+/**
+ * Typed error subclass thrown when `pushTask` is called against a bridge
+ * that is not in the 'running' state, or when `start()` fails the health
+ * check. The handler layer discriminates on this class to choose a 503
+ * vs 500 HTTP status.
+ */
+declare class AgentUnreachableError extends Error {
+    readonly name = "AgentUnreachableError";
+    readonly status: AgentBridgeStatus;
+    constructor(message: string, status: AgentBridgeStatus);
+}
+interface AgentBridge {
+    /**
+     * Health-checks the channel server. Idempotent: calling it twice on a
+     * started bridge returns the same promise (so concurrent callers
+     * converge on a single check). Calling it after `stop()` re-starts.
+     */
+    readonly start: () => Promise<void>;
+    /**
+     * Registers `task` with the injected task store, then fires an HTTP
+     * POST to the channel server. The returned promise IS the store's
+     * promise: it resolves when the channel server POSTs back a
+     * `task_callback` with event 'completed'.
+     *
+     * Rejects with `AgentUnreachableError` if the bridge is not 'running'.
+     */
+    readonly pushTask: (task: Task) => Promise<TaskResult>;
+    /**
+     * Fails all inflight tasks. Idempotent. Safe to call before `start`,
+     * during `start`, after `start` succeeds, and after failure. Never
+     * throws.
+     */
+    readonly stop: () => Promise<void>;
+    /**
+     * Synchronous status getter. Handlers call this to emit 503-style
+     * errors without having to await a round-trip to the bridge.
+     */
+    readonly status: () => AgentBridgeStatus;
+}
+interface CreateAgentBridgeOptions {
+    readonly taskStore: TaskStore;
+    /** Port the channel server listens on. Defaults to 4819. */
+    readonly channelPort?: number;
+    /** Host the channel server listens on. Defaults to '127.0.0.1'. */
+    readonly channelHost?: string;
+    /** Callback URL the channel server will POST results to. Defaults to 'http://localhost:3000/api/agntcms/mcp'. */
+    readonly callbackUrl?: string;
+    /**
+     * How long to wait, after the HTTP POST to the channel server has
+     * returned 200, for the agent to acknowledge via `report_task_progress`
+     * or `report_task_done` before failing the task with
+     * `TASK_ACK_TIMEOUT_MESSAGE`. Default 15000 ms.
+     *
+     * Set to 0 to disable the watchdog (useful for tests that drive the
+     * store manually).
+     *
+     * Once any progress or terminal event has been seen, the watchdog is
+     * considered satisfied and is not re-armed. The agent owns the
+     * long-tail timing after that point.
+     */
+    readonly taskAckTimeoutMs?: number;
+    /** Test seam: override fetch for HTTP calls. */
+    readonly fetch?: typeof globalThis.fetch;
+    /**
+     * Test seams for the watchdog timer. When `taskAckTimeoutMs > 0`, the
+     * bridge calls `setTimeoutFn(callback, ms)` and `clearTimeoutFn(handle)`
+     * to drive the watchdog. Defaults to the global `setTimeout` /
+     * `clearTimeout`.
+     */
+    readonly setTimeoutFn?: (cb: () => void, ms: number) => unknown;
+    readonly clearTimeoutFn?: (handle: unknown) => void;
+}
+/**
+ * Primary factory. See file header for design notes.
+ */
+declare const createAgentBridge: (options: CreateAgentBridgeOptions) => AgentBridge;
+
+interface McpHandlerDeps {
+    readonly bridge: AgentBridge;
+    readonly taskStore: TaskStore;
+}
+interface McpHandler {
+    readonly POST: (req: Request) => Promise<Response>;
+}
+declare const createMcpHandler: (deps: McpHandlerDeps) => McpHandler;
+
+interface EventsHandlerDeps {
+    readonly taskStore: TaskStore;
+}
+interface EventsHandler {
+    readonly GET: (req: Request) => Response;
+}
+declare const createEventsHandler: (deps: EventsHandlerDeps) => EventsHandler;
+
+interface PreviewToken {
+    readonly token: string;
+    readonly slug: string;
+    readonly createdAt: number;
+}
+interface PreviewTokenStoreOptions {
+    /** Time-to-live in milliseconds. Defaults to 600_000 (10 minutes). */
+    readonly ttlMs?: number;
+}
+interface PreviewTokenStore {
+    /** Issue a new single-use preview token for the given slug. */
+    readonly issue: (slug: string) => PreviewToken;
+    /**
+     * Consume a token. Returns the associated slug if the token exists and
+     * has not expired; returns `null` otherwise. A consumed token is deleted
+     * and cannot be reused.
+     */
+    readonly consume: (token: string) => string | null;
+}
+
+declare const createPreviewTokenStore: (options?: PreviewTokenStoreOptions) => PreviewTokenStore;
+
+interface PreviewHandlerDeps {
+    /** Cookie name used for preview mode flag. Default: '__agntcms_preview' */
+    readonly cookieName?: string;
+    /** Optional token store for single-use preview links. */
+    readonly tokenStore?: PreviewTokenStore;
+}
+interface PreviewHandler {
+    /** POST /api/agntcms/preview/enter -- enable preview mode */
+    readonly enter: (req: Request) => Response;
+    /** POST /api/agntcms/preview/exit -- disable preview mode */
+    readonly exit: (req: Request) => Response;
+    /** GET /api/agntcms/preview/enter?token=... -- token exchange + redirect */
+    readonly enterWithToken: (req: Request) => Response;
+    /** POST /api/agntcms/preview/token -- issue a single-use preview token */
+    readonly issueToken: (req: Request) => Promise<Response>;
+}
+declare function createPreviewHandler(deps?: PreviewHandlerDeps): PreviewHandler;
+
+interface DraftHandlerDeps {
+    readonly contentAdapter: ContentStorageAdapter;
+    readonly runtime: Runtime;
+}
+interface DraftHandler {
+    /** POST /api/agntcms/draft/save -- save a draft page */
+    readonly save: (req: Request) => Promise<Response>;
+    /** GET /api/agntcms/draft/list -- list all drafts */
+    readonly list: (req: Request) => Promise<Response>;
+    /** POST /api/agntcms/draft/publish -- publish a draft */
+    readonly publish: (req: Request) => Promise<Response>;
+    /** POST /api/agntcms/draft/reorder -- reorder sections within a draft */
+    readonly reorder: (req: Request) => Promise<Response>;
+    /** POST /api/agntcms/draft/discard -- delete a draft (published version must exist) */
+    readonly discard: (req: Request) => Promise<Response>;
+}
+declare function createDraftHandler(deps: DraftHandlerDeps): DraftHandler;
+
+interface AssetsHandlerDeps {
+    readonly assetAdapter: AssetStorageAdapter;
+}
+interface AssetsHandler {
+    /** GET /api/agntcms/assets -- list every asset (newest first) */
+    readonly list: (req: Request) => Promise<Response>;
+    /** POST /api/agntcms/assets -- upload bytes */
+    readonly upload: (req: Request) => Promise<Response>;
+}
+declare function createAssetsHandler(deps: AssetsHandlerDeps): AssetsHandler;
+
+interface PageHandlerDeps {
+    readonly contentAdapter: ContentStorageAdapter;
+    /**
+     * Runtime instance. Required: `rollback` saves a draft then republishes
+     * it via `runtime.publishDraft`, and the `tag/limit/sort` mode of `list`
+     * routes through `runtime.listPages`. Both code paths are part of the
+     * public surface, so the type forbids constructing the handler without
+     * it. Template route files (frozen zone) all wire it in.
+     */
+    readonly runtime: Runtime;
+}
+interface PageHandler {
+    readonly list: (req: Request) => Promise<Response>;
+    readonly read: (req: Request) => Promise<Response>;
+    readonly deletePage: (req: Request) => Promise<Response>;
+    readonly unpublish: (req: Request) => Promise<Response>;
+    readonly listHistory: (req: Request) => Promise<Response>;
+    readonly rollback: (req: Request) => Promise<Response>;
+    readonly rename: (req: Request) => Promise<Response>;
+    /** POST /api/agntcms/page/duplicate -- clone a page under a new slug as a draft */
+    readonly duplicate: (req: Request) => Promise<Response>;
+}
+declare function createPageHandler(deps: PageHandlerDeps): PageHandler;
+
+interface GlobalHandlerDeps {
+    readonly contentAdapter: ContentStorageAdapter;
+    /** When provided, `save` rejects types not in this set with 400 `unknown_type`. */
+    readonly allowedTypes?: ReadonlySet<string>;
+    /** Pre-resolved section defaults. When provided, the save handler fills
+     *  missing fields in global data with these defaults so that a freshly
+     *  created global (with `data: {}`) starts with valid placeholder values
+     *  instead of crashing the section component at render time. */
+    readonly sectionDefaults?: ReadonlyMap<string, Readonly<Record<string, unknown>>>;
+}
+interface GlobalHandler {
+    /** GET /api/agntcms/global/list */
+    readonly list: (req: Request) => Promise<Response>;
+    /** GET /api/agntcms/global/read?name=xxx */
+    readonly read: (req: Request) => Promise<Response>;
+    /** POST /api/agntcms/global/save */
+    readonly save: (req: Request) => Promise<Response>;
+    /** POST /api/agntcms/global/delete */
+    readonly delete: (req: Request) => Promise<Response>;
+    /**
+     * GET /api/agntcms/global/history?name=xxx[&ts=...]
+     *
+     * Without `ts`: returns the list of history entries for the global.
+     * With `ts`: returns the full body of the matching single snapshot.
+     * Mirrors the page handler's `listHistory`/?ts= behaviour exactly.
+     */
+    readonly listHistory: (req: Request) => Promise<Response>;
+    /** POST /api/agntcms/global/rollback — body: { name, timestamp } */
+    readonly rollback: (req: Request) => Promise<Response>;
+}
+declare function createGlobalHandler(deps: GlobalHandlerDeps): GlobalHandler;
+
+/**
+ * Template definition shape matching `PageTemplate` from config.
+ * Redeclared here as a structural type so the handler does not import
+ * from config/ (invariant 1).
+ */
+interface TemplateDef {
+    readonly name: string;
+    readonly description?: string;
+    readonly sectionTypes: readonly string[];
+}
+interface TemplateHandlerDeps {
+    /**
+     * Pre-resolved map: section type name -> default data for that section.
+     * Built by the wiring layer from the registered `AnySectionDefinition[]`.
+     */
+    readonly sectionDefaults: ReadonlyMap<string, Readonly<Record<string, unknown>>>;
+    /** The template definitions from config. */
+    readonly templates: readonly TemplateDef[];
+}
+interface TemplateHandler {
+    /** GET /api/agntcms/template/list */
+    readonly list: (req: Request) => Promise<Response>;
+}
+declare function createTemplateHandler(deps: TemplateHandlerDeps): TemplateHandler;
+
+interface SubmitHandlerDeps {
+    readonly runtime: Runtime;
+    readonly rateLimit: RateLimit;
+}
+declare function createSubmitFormHandler(deps: SubmitHandlerDeps): (req: Request) => Promise<Response>;
+
+/**
+ * Adapter info surfaced to the AdminModal. Two shapes:
+ *   - `{ kind: 'fs' }`               — local FS submissions; readable.
+ *   - `{ kind: 'webhook', host }`    — webhook adapter; not locally readable.
+ */
+type FormsListAdapterInfo = {
+    readonly kind: 'fs';
+} | {
+    readonly kind: 'webhook';
+    readonly host: string;
+};
+interface FormsListHandlerDeps {
+    /** Registered form definitions (from `defineConfig({ forms: [...] })`). */
+    readonly forms: ReadonlyArray<AnyFormDefinition>;
+    /**
+     * Optional adapter descriptor. When omitted, the handler reports
+     * `{ kind: 'fs' }` — the v1 default adapter (ARCHITECTURE.md §6.5).
+     * Frozen routes that wire a webhook adapter pass `{ kind: 'webhook',
+     * host: '<host>' }` here; the host is computed once at handler-construction
+     * time from the configured webhook URL.
+     */
+    readonly adapter?: FormsListAdapterInfo;
+}
+/** Forms list handler. */
+declare function createFormsListHandler(deps: FormsListHandlerDeps): (_req: Request) => Promise<Response>;
+
+interface FormsReadHandlerDeps {
+    readonly submissionAdapter: SubmissionStorageAdapter;
+    /** Registered form names — used to 404 unknown forms before hitting the adapter. */
+    readonly knownForms: ReadonlySet<string>;
+}
+declare function createFormsReadHandler(deps: FormsReadHandlerDeps): (req: Request) => Promise<Response>;
+
+declare function createFormsDeleteHandler(): (_req: Request) => Promise<Response>;
+
+export { type AgentBridge, type AgentBridgeStatus, AgentUnreachableError, type AssetsHandler, type AssetsHandlerDeps, type CreateAgentBridgeOptions, type DraftHandler, type DraftHandlerDeps, type EventsHandler, type EventsHandlerDeps, type FormsListAdapterInfo, type FormsListHandlerDeps, type FormsReadHandlerDeps, type GlobalHandler, type GlobalHandlerDeps, type McpHandler, type McpHandlerDeps, type PageHandler, type PageHandlerDeps, type PreviewHandler, type PreviewHandlerDeps, type PreviewToken, type PreviewTokenStore, type PreviewTokenStoreOptions, type SubmitHandlerDeps, type Task, type TaskEvent, type TaskId, type TaskSnapshot, type TaskState, type TaskStore, type TemplateHandler, type TemplateHandlerDeps, createAgentBridge, createAssetsHandler, createDraftHandler, createEventsHandler, createFormsDeleteHandler, createFormsListHandler, createFormsReadHandler, createGlobalHandler, createMcpHandler, createPageHandler, createPreviewHandler, createPreviewTokenStore, createSubmitFormHandler, createTaskStore, createTemplateHandler };