import { z } from 'zod';
import type { WorldConfig, WorldServiceEvent, WorldValidationFinding } from '@volter-ai-dev/twin';
export { MISSING_WORLD_TWIN_MESSAGE } from './worldTwinRuntime.js';
export declare const WorldAnnotationSchema: z.ZodObject<{
    id: z.ZodString;
    service: z.ZodString;
    eventId: z.ZodString;
    classification: z.ZodEnum<{
        source: "source";
        noise: "noise";
        duplicate: "duplicate";
    }>;
    quote: z.ZodOptional<z.ZodString>;
    payloadPath: z.ZodOptional<z.ZodString>;
    resourcePath: z.ZodOptional<z.ZodString>;
    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
    annotator: z.ZodEnum<{
        agent: "agent";
        human: "human";
    }>;
    createdAt: z.ZodString;
}, z.core.$strip>;
export type WorldAnnotation = z.infer<typeof WorldAnnotationSchema>;
export declare function createAnnotation(input: Omit<WorldAnnotation, 'createdAt'> & {
    createdAt?: string;
}): WorldAnnotation;
export declare function listAnnotations(service: string, root?: string): Promise<WorldAnnotation[]>;
/** Append an annotation. Idempotent on id; refuses to annotate a missing event. */
export declare function addAnnotation(annotation: WorldAnnotation, root?: string): Promise<WorldAnnotation>;
/**
 * True when an event must NOT be routed through the annotation pipeline — a
 * mechanical sync record: egress ledger events, connector-origin deltas, or any
 * event of a service whose world config sets annotationPolicy: 'exempt'.
 */
export declare function isAnnotationExemptEvent(event: WorldServiceEvent, config?: WorldConfig): Promise<boolean>;
/** Validate every annotation in a service: schema, quote resolution, links, unannotated events. */
export declare function validateServiceAnnotations(root: string, service: string): Promise<WorldValidationFinding[]>;