import type { ProcessorContext } from '@mastra/core/processors';
import type { RequestContext } from '@mastra/core/request-context';
import { z } from 'zod';
import type { Memory } from '../../index.js';
type ExtractorMode = 'inline' | 'structured';
export type ExtractorSource = 'observer' | 'reflector';
export interface ExtractorRuntimeContext {
    source: ExtractorSource;
    threadId?: string;
    resourceId?: string;
    mainAgent?: ProcessorContext['agent'];
    memory?: Memory;
    requestContext?: RequestContext;
}
export interface ExtractorOnExtractedContext<T = unknown> extends ExtractorRuntimeContext {
    extractor: Extractor<T>;
    threadId: string;
    previous?: T;
    current: T;
    sendSignal?: ProcessorContext['sendSignal'];
}
type MaybePromise<T> = T | Promise<T>;
type ExtractorConfigValue<TValue> = TValue | ((context: ExtractorRuntimeContext) => MaybePromise<TValue>);
export interface ExtractorConfig<T = unknown> {
    /** Human-readable extractor name. Converted to a stable kebab-case slug for XML tags and metadata keys. */
    name: string;
    /** Instructions describing what this extractor should return. */
    instructions: ExtractorConfigValue<string>;
    /** Zod schema used for structured extraction. Omit to extract an inline string value from the observer/reflector output. */
    schema?: ExtractorConfigValue<z.ZodType<T> | undefined>;
    /** Whether the previous extraction should be shown to the extractor prompt. Defaults to true. */
    includePreviousExtraction?: boolean;
    /** Dot-separated OM metadata path for persistence. Defaults to `extracted.<slug>`. Set false to skip OM metadata persistence. */
    metadataKeyPath?: string | false;
    /** Optional lifecycle hook invoked after a value is parsed and before it is persisted. */
    onExtracted?: (context: ExtractorOnExtractedContext<T>) => Promise<T | void | undefined> | T | void | undefined;
}
export declare const BUILT_IN_EXTRACTOR_SLUGS: readonly string[];
export type BuiltInExtractorSlug = (typeof BUILT_IN_EXTRACTOR_SLUGS)[number];
export declare function isBuiltInExtractorSlug(slug: string): slug is BuiltInExtractorSlug;
export declare function slugifyExtractorName(name: string): string;
export declare class Extractor<T = unknown> {
    readonly name: string;
    readonly slug: string;
    readonly instructions: string;
    readonly schema: z.ZodType<T>;
    readonly mode: ExtractorMode;
    readonly includePreviousExtraction: boolean;
    readonly metadataKeyPath: string | false;
    readonly onExtracted?: ExtractorConfig<T>['onExtracted'];
    /** @internal */
    readonly internal: boolean;
    private readonly instructionsConfig;
    private readonly schemaConfig?;
    constructor(config: ExtractorConfig<T>, internal?: boolean);
    resolve(context: ExtractorRuntimeContext): Promise<Extractor<T>>;
}
export declare function resolveExtractors(extractors: readonly Extractor<any>[], context: ExtractorRuntimeContext): Promise<Extractor<any>[]>;
export declare function validateExtractorList(extractors: readonly Extractor<any>[]): Extractor<any>[];
export declare function parseExtractorValue<T>(extractor: Extractor<T>, raw: string): T;
export interface ParsedExtractedValues {
    values: Record<string, unknown>;
    failures: Array<{
        slug: string;
        error: string;
    }>;
}
export declare function parseExtractedValues(output: string, extractors: readonly Extractor<any>[]): ParsedExtractedValues;
export declare function stripExtractorSections(output: string, extractors: readonly Extractor<any>[]): string;
export declare function buildExtractorOutputSections(extractors: readonly Extractor<any>[]): string;
export declare function buildExtractorPriorLines(extractors: readonly Extractor<any>[], priorExtractedValues?: Record<string, unknown>): string[];
export {};
//# sourceMappingURL=extractor.d.ts.map