/**
 * The optional-subject sub-form shared by every form that keys a run's state to a
 * conversation subject (the add-schedule dialog and the tool run panel). A collapsible
 * block whose target / kind / key fields render only while expanded, so a form's default
 * (collapsed) shape sends no subject.
 *
 * Presentational and prop-driven, like {@link ExecutionKeyPicker}: the host feature owns
 * the conversation-targets query (the SDK holds no data-fetching library) and hands the
 * resolved `targetOptions` in. {@link useSubjectFields} owns the field state; the host
 * feature wraps it with its own targets query under its own query-key namespace. The
 * caption and the two placeholders are the only copy that differs between hosts, so they
 * are props.
 */
import type { StateSubject } from '@tai42/api-client';
import { type ReactNode } from 'react';
/** One conversation-target option: `target_kind:target_name` value, `kind · name` label. */
export interface SubjectTargetOption {
    readonly value: string;
    readonly label: string;
}
/** The message a partially-filled subject is refused with (all three fields or none). */
export declare const SUBJECT_INCOMPLETE_MESSAGE = "A subject needs a target, a kind, and a key.";
/** Map the conversation routes read to the target select's options. */
export declare function toSubjectTargetOptions(routes: readonly {
    readonly target_kind: string;
    readonly target_name: string;
}[]): SubjectTargetOption[];
/**
 * Build a {@link StateSubject} from the sub-form values: `null` when untouched (no
 * subject), a subject when target, kind and key are all set, or a loud failure when only
 * some are — never a silently dropped partial subject. The target splits on its FIRST
 * colon, so a target name may itself contain one.
 */
export declare function buildSubject(v: {
    readonly target: string;
    readonly kind: string;
    readonly key: string;
}): {
    ok: true;
    subject: StateSubject | null;
} | {
    ok: false;
    message: string;
};
/** Subject field state + setters + the collapse toggle. The host feature owns the
 *  open-gated conversation-targets query and derives `targetOptions` from it. */
export declare function useSubjectFields(): {
    target: string;
    setTarget: import("react").Dispatch<import("react").SetStateAction<string>>;
    kind: string;
    setKind: import("react").Dispatch<import("react").SetStateAction<string>>;
    key: string;
    setKey: import("react").Dispatch<import("react").SetStateAction<string>>;
    error: string | null;
    setError: import("react").Dispatch<import("react").SetStateAction<string | null>>;
    open: boolean;
    setOpen: import("react").Dispatch<import("react").SetStateAction<boolean>>;
};
export interface SubjectSectionProps {
    readonly open: boolean;
    readonly onToggle: () => void;
    readonly target: string;
    readonly onTargetChange: (value: string) => void;
    readonly kind: string;
    readonly onKindChange: (value: string) => void;
    readonly subjectKey: string;
    readonly onKeyChange: (value: string) => void;
    readonly error: string | null;
    readonly targetOptions: readonly SubjectTargetOption[];
    /** The block's descriptive caption, shown under the expanded header. */
    readonly caption: string;
    /** The target select's empty-choice placeholder. */
    readonly targetPlaceholder: string;
    /** The Subject key field's helper description. */
    readonly subjectKeyDescription: string;
}
export declare function SubjectSection({ open, onToggle, target, onTargetChange, kind, onKindChange, subjectKey, onKeyChange, error, targetOptions, caption, targetPlaceholder, subjectKeyDescription, }: SubjectSectionProps): ReactNode;
//# sourceMappingURL=subject-section.d.ts.map