import type { AuthoringApiClient } from "../api/client.js";
/** Name of the scai-owned Template Section the marker field lives under. */
export declare const SCAI_SECTION_NAME = "Scai";
/** Outcome of {@link ensureMarkerField}. */
export interface EnsureMarkerFieldResult {
    /** `"created"` when this call added the field; `"already-present"` when it was found. */
    status: "created" | "already-present";
    /** itemId of the `Scai Handle` Template Field item. */
    fieldItemId: string;
    /** itemId of the Template Section the field lives under. */
    sectionItemId: string;
}
/**
 * Ensure the `Scai Handle` marker field exists on the Standard Template.
 *
 * Idempotent: scans every Template Section directly under the Standard
 * Template for an existing `Scai Handle` field and returns it untouched when
 * found (even if a prior bootstrap placed it under a differently-named
 * section). Otherwise it ensures the `Scai` section and creates the field.
 *
 * Throws `INPUT_INVALID` when the Standard Template can't be resolved — the
 * environment isn't pointed at an XM Cloud authoring endpoint, or the
 * authoring database lacks the built-in template.
 */
export declare const ensureMarkerField: (client: AuthoringApiClient) => Promise<EnsureMarkerFieldResult>;