export declare const AGENT_EXPERIENCE_SCHEMA: "comet.agent-experience.v1";
export type AgentExperienceEventType = 'user.signal' | 'episode.completed' | 'verification.completed' | 'review.resolved' | 'failure.resolved' | 'change.archived' | 'repository.changed' | 'context.applied' | 'context.outcome';
export type AgentExperienceActor = 'user' | 'agent' | 'tool' | 'workflow' | 'repository';
export type AgentExperienceScope = 'user' | 'project';
export type AgentLearningState = 'trial' | 'proven' | 'enforced' | 'superseded';
export type AgentLearningOwner = 'personal-memory' | 'project-knowledge' | string;
export type AgentMemoryType = 'core-profile' | 'collaboration-policy' | 'personal-episode' | 'project-model' | 'project-policy';
export interface AgentExperienceSource {
    readonly kind: 'user' | 'workflow' | 'tool' | 'repository' | 'system';
    readonly name: string;
    readonly workflow?: string;
    readonly changeId?: string;
    readonly command?: string;
}
export interface AgentExperienceContext {
    readonly task?: string;
    readonly workflow?: string;
    readonly changeId?: string;
    readonly phase?: string;
    readonly paths?: readonly string[];
    readonly operation?: string;
}
export interface AgentExperienceSignal {
    readonly kind: 'preference' | 'correction' | 'acceptance' | 'rejection' | 'remember' | 'forget';
    readonly explicit: boolean;
    readonly longTerm: boolean;
    readonly text: string;
    readonly category?: string;
    readonly targetId?: string;
    readonly selectors?: AgentContextSelectors;
}
export interface AgentExperienceEvidence {
    readonly id: string;
    readonly kind: 'user' | 'source' | 'verification' | 'review' | 'failure' | 'outcome';
    readonly summary: string;
    readonly source?: string;
    readonly anchor?: string;
    readonly digest?: string;
    readonly command?: string;
    readonly success?: boolean;
}
export type AgentContextOutcomeStatus = 'used-successfully' | 'ignored' | 'overridden' | 'corrected' | 'contributed-to-failure';
export interface AgentExperienceOutcome {
    readonly status: AgentContextOutcomeStatus;
    readonly previousStatus?: AgentContextOutcomeStatus;
    readonly revision?: number;
    readonly summary?: string;
    readonly applicationId?: string;
    readonly unitIds?: readonly string[];
}
export interface AgentExperienceEvent {
    readonly schema: typeof AGENT_EXPERIENCE_SCHEMA;
    readonly eventId: string;
    readonly episodeId: string;
    readonly occurredAt: string;
    readonly type: AgentExperienceEventType;
    readonly actor: AgentExperienceActor;
    readonly scope: AgentExperienceScope;
    readonly projectId?: string;
    readonly source: AgentExperienceSource;
    readonly context: AgentExperienceContext;
    readonly signal?: AgentExperienceSignal;
    readonly evidence: readonly AgentExperienceEvidence[];
    readonly outcome?: AgentExperienceOutcome;
    readonly causedByEventId?: string;
    readonly supersedesEventId?: string;
}
export interface AgentContextSelectors {
    readonly projectId?: string;
    readonly paths?: readonly string[];
    readonly operations?: readonly string[];
    readonly phases?: readonly string[];
    readonly tasks?: readonly string[];
}
export interface AgentContextSourceRef {
    readonly type: 'user' | 'repository' | 'workflow' | 'review' | 'verification' | 'inference';
    readonly source?: string;
    readonly anchor?: string;
    readonly digest?: string;
}
export interface AgentContextVerification {
    readonly command: string;
    readonly expected?: string;
}
export interface AgentContextCandidate {
    readonly id: string;
    readonly owner: AgentLearningOwner;
    readonly scope: AgentExperienceScope;
    readonly memoryType: AgentMemoryType;
    readonly kind: string;
    readonly state: AgentLearningState;
    readonly authority: 'explicit' | 'inferred' | 'repository' | 'user';
    readonly title: string;
    readonly summary: string;
    readonly content?: string;
    readonly selectors: AgentContextSelectors;
    readonly sources: readonly AgentContextSourceRef[];
    readonly verification: readonly AgentContextVerification[];
    readonly priority?: number;
    readonly matchReasons?: readonly string[];
    readonly digest?: string;
    readonly application?: AgentContextApplicationStats;
}
export interface AgentContextApplicationStats {
    readonly applied: number;
    readonly successful: number;
    readonly ignored: number;
    readonly negative: number;
    readonly lastOutcome?: AgentContextOutcomeStatus;
    readonly lastAppliedAt?: string;
}
/** A normalized Reflection result before a domain Provider consolidates it. */
export interface AgentLearningDelta {
    readonly action: 'create' | 'update' | 'supersede' | 'forget' | 'noop';
    readonly owner: AgentLearningOwner;
    readonly targetId?: string;
    readonly memoryType: AgentMemoryType;
    readonly kind: string;
    readonly title?: string;
    readonly statement: string;
    readonly applicability: AgentContextSelectors;
    readonly evidence: readonly AgentExperienceEvidence[];
    readonly authority?: AgentContextCandidate['authority'];
    readonly verification?: readonly AgentContextVerification[];
    readonly feedback?: {
        readonly applicationId: string;
        readonly status: AgentContextOutcomeStatus;
        readonly previousStatus?: AgentContextOutcomeStatus;
        readonly revision: number;
    };
    /** Domain-normalized payload retained across the Provider seam. */
    readonly payload?: Readonly<Record<string, unknown>>;
    readonly recommendedState: AgentLearningState;
}
export declare function validateAgentExperienceEvent(value: unknown): AgentExperienceEvent;
export declare function validateAgentContextCandidate(value: unknown): AgentContextCandidate;
//# sourceMappingURL=types.d.ts.map