import { Entity } from "../../../common";
import type { HandbookThread } from "./handbook-thread";
export type HandbookThreadMessageRole = "user" | "assistant";
/**
 * One turn of a handbook conversation.
 *
 * `sources` holds repo-relative HandbookPage paths rather than `CITES` edges to
 * `Chunk` nodes (the shape `AssistantMessage` uses). The handbook answer is
 * attributed to the PAGE a reader can open, chunk boundaries are an ingest
 * detail, and the paths are resolved once at write time — so a re-ingest that
 * replaces the chunks leaves the rendered provenance intact.
 *
 * `isCompanyScoped: false` for the same reason as the thread; access is
 * inherited from the parent thread's owner edge, enforced in
 * `HandbookThreadMessageRepository.buildUserHasAccess()`.
 */
export type HandbookThreadMessage = Entity & {
    role: HandbookThreadMessageRole;
    content: string;
    position: number;
    sources?: string[];
    thread?: HandbookThread;
};
export declare const HandbookThreadMessageDescriptor: import("../../../common").EntityDescriptor<HandbookThreadMessage, {
    thread: {
        model: import("../../../common").DataMeta;
        direction: "in";
        relationship: string;
        cardinality: "one";
        required: true;
        dtoKey: string;
        immutable: true;
    };
}>;
export type HandbookThreadMessageDescriptorType = typeof HandbookThreadMessageDescriptor;
//# sourceMappingURL=handbook-thread-message.d.ts.map