import type { AgentsSession } from "../session/types.js";
import type { HtmlTemplate } from "./schema.js";
/** List every HTML template visible to the session. */
export declare const listHtmlTemplates: (session: AgentsSession) => Promise<HtmlTemplate[]>;
/** Find one HTML template by `id`, `templateId`, or `name`. `undefined` if not found. */
export declare const getHtmlTemplate: (session: AgentsSession, idOrName: string) => Promise<HtmlTemplate | undefined>;
export interface CreateHtmlTemplateInput {
    /** Display name and identifier of the template. */
    name: string;
    /** The template's HTML body. */
    code: string;
    description?: string;
    tags?: string[];
}
/**
 * Create an HTML template. **UNSTABLE — see the file header.**
 *
 * Replays the `/html-templates/create` server action. Throws
 * `AGENTS_API_FAILED` with a re-capture hint when the action hash has
 * rotated (the most likely failure after an Agentic Studio deploy).
 */
export declare const createHtmlTemplate: (session: AgentsSession, input: CreateHtmlTemplateInput) => Promise<void>;
export interface UpdateHtmlTemplateInput extends CreateHtmlTemplateInput {
    /** Id of the HTML template to replace. */
    id: string;
}
/**
 * Update an HTML template — replays the `updateHtmlTemplateAction` server
 * action `POST /html-templates/{id}`. The hash, route, router tree, and
 * argument tuple (`[id, {templateId, name, description, code, tags}]`)
 * were captured live 2026-05-17 — see the file header.
 */
export declare const updateHtmlTemplate: (session: AgentsSession, input: UpdateHtmlTemplateInput) => Promise<void>;
/** Delete an HTML template (`DELETE /api/html-templates/{id}`). **UNVERIFIED — 404; see header.** */
export declare const deleteHtmlTemplate: (session: AgentsSession, id: string) => Promise<void>;