import type { MemorySearchResultV1 } from "../memory/memoryCapability.js"; import type { ToolInvocationContext } from "./types.js"; import { type NativeToolOperationObservationV1 } from "./native-operation-observation.js"; /** Facts about returned records, not proof of reading their complete bodies or authoring a note. */ export interface NativeMemoryReadFacts { readonly status: MemorySearchResultV1['status']; readonly outcome: MemorySearchResultV1['outcome']; readonly reasonCode?: string; readonly returnedMatchCount: number; readonly executedRoutes: readonly string[]; readonly sourceNamespaceCounts: Readonly>; readonly declaredSourceKindCounts: Readonly>; readonly sourceManifestSha256: string; readonly authoringProof: 'none_from_read'; } interface Carrier { success: boolean; output?: string; error?: string; llmContent?: string; data?: unknown; partial?: boolean; noop?: boolean; dryRun?: boolean; } /** Only observations issued from a live original memory-result reader qualify. */ export declare function readIssuedNativeMemoryOperationObservation(value: unknown): Readonly | undefined; /** Host adapter for an existing producer. No query, source access, or authority is created here. */ export declare class NativeMemoryOperationObserver { private readonly producer; private readonly producerRef; private readonly carrierKey; private readonly issued; private readonly tickets; constructor(producer: { toolName: string; readParameters: () => unknown; readIssuedResult: (data: unknown) => MemorySearchResultV1 | undefined; }); begin(args: Record, context?: ToolInvocationContext): object | undefined; observe(ticket: object | undefined, args: Record, result: Carrier, context?: ToolInvocationContext): void; read(args: Record, result: Carrier): Readonly | undefined; } export {};