import type { AgentsSession } from "../session/types.js";
import type { StructuredSchema } from "./schema.js";
/** List every structured-output schema visible to the session. */
export declare const listSchemas: (session: AgentsSession) => Promise<StructuredSchema[]>;
/** Find one schema by `id`, `schemaId`, or `name`. Returns `undefined` if not found. */
export declare const getSchema: (session: AgentsSession, idOrName: string) => Promise<StructuredSchema | undefined>;
export interface CreateSchemaInput {
    /** Display name and identifier of the schema. */
    name: string;
    description?: string;
    /** The JSON-Schema object the structured output must satisfy. */
    schema: Record<string, unknown>;
    /** Enforce the schema strictly. Defaults to true. */
    strict?: boolean;
    tags?: string[];
}
/**
 * Create a structured-output schema. **UNSTABLE — see the file header.**
 *
 * Replays the `/schemas/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 createSchema: (session: AgentsSession, input: CreateSchemaInput) => Promise<void>;
export interface UpdateSchemaInput extends CreateSchemaInput {
    /** Id of the schema to replace. */
    id: string;
}
/**
 * Update a structured-output schema. There is no REST update
 * (`PUT /api/schemas/{id}` → 405); instead the `/schemas/create` server
 * action upserts by name, so an update is a re-create — verified
 * 2026-05-17. `input.id` is unused: the server action keys on the name.
 */
export declare const updateSchema: (session: AgentsSession, input: UpdateSchemaInput) => Promise<void>;
/** Delete a schema (`DELETE /api/schemas/{id}`). **UNVERIFIED — returned 405; see header.** */
export declare const deleteSchema: (session: AgentsSession, id: string) => Promise<void>;