import { type DataAuditResult } from '@sofagent/core';
export interface CreateEntityArgs {
    /** entity 名称（不含 .md 后缀） */
    name: string;
    /** 业务域归属 */
    domain: string;
    /** entity 页面内容（Markdown，含 frontmatter） */
    content: string;
    /** JSON 格式关联关系（belongs_to / has_many），可选 */
    relations?: string;
}
export interface CreateEntityResult {
    /** 首行必须 [sofagent] 前缀 */
    text: string;
    /** 结构化数据 */
    data: {
        action: 'created' | 'updated';
        path: string;
        warnings?: DataAuditResult['violations'];
        auditVerdict: 'PASS' | 'WARN' | 'FAIL';
        isError: boolean;
    };
}
/**
 * 创建/更新 entity
 *
 * @param args 创建参数
 * @returns 结构化结果（text + data）
 */
export declare function createEntity(args: CreateEntityArgs): CreateEntityResult;
//# sourceMappingURL=create-entity.d.ts.map