import type { AgentToolResult, AgentToolUpdateCallback, ExtensionAPI, ExtensionContext, ToolDefinition } from "@earendil-works/pi-coding-agent";
import { Type, type Static, type TSchema } from "typebox";
import type { ContextManagementMode } from "../adapter/activation/config.ts";
import type { ContextRouter, SharedContextRequest, RemoteNoteReference } from "../context-sharing.ts";
import { type NotesAction } from "./tool-contract.ts";
declare const HISTORY_PARAMETERS: Type.TObject<{
    action: Type.TOptional<import("typebox").TUnsafe<string>>;
    agent_name: Type.TOptional<Type.TUnion<[Type.TString, Type.TNull]>>;
    item_id: Type.TOptional<Type.TString>;
    limit: Type.TOptional<Type.TInteger>;
    limit_chars: Type.TOptional<Type.TInteger>;
    max_chars_per_item: Type.TOptional<Type.TInteger>;
    offset_chars: Type.TOptional<Type.TInteger>;
    query: Type.TOptional<Type.TString>;
    recent_first: Type.TOptional<Type.TBoolean>;
    role: Type.TOptional<Type.TUnion<[import("typebox").TUnsafe<"assistant" | "developer" | "system" | "tool" | "user">, Type.TNull]>>;
    tool_name: Type.TOptional<Type.TUnion<[Type.TString, Type.TNull]>>;
    tool_namespace: Type.TOptional<Type.TUnion<[Type.TString, Type.TNull]>>;
    window_id: Type.TOptional<Type.TUnion<[Type.TString, Type.TNull]>>;
}>;
declare const NOTES_PARAMETERS: Type.TObject<{
    action: Type.TOptional<import("typebox").TUnsafe<string>>;
    file_order: Type.TOptional<import("typebox").TUnsafe<"ascending" | "descending">>;
    file_order_by: Type.TOptional<import("typebox").TUnsafe<"created_at" | "name" | "updated_at">>;
    max_files: Type.TOptional<Type.TInteger>;
    max_matches_per_file: Type.TOptional<Type.TInteger>;
    max_results: Type.TOptional<Type.TInteger>;
    path: Type.TOptional<Type.TString>;
    path_prefix: Type.TOptional<Type.TUnion<[Type.TString, Type.TNull]>>;
    prefix: Type.TOptional<Type.TUnion<[Type.TString, Type.TNull]>>;
    query: Type.TOptional<Type.TString>;
    recent_file_first: Type.TOptional<Type.TBoolean>;
    start_line: Type.TOptional<Type.TUnion<[Type.TInteger, Type.TNull]>>;
    stop_line: Type.TOptional<Type.TUnion<[Type.TInteger, Type.TNull]>>;
    text: Type.TOptional<Type.TString>;
}>;
export interface CodexHistoryNotesDetails {
    codexHistoryNotes: Record<string, unknown>;
}
type HistoryNotesTool<TParams extends TSchema> = Omit<ToolDefinition<TParams, CodexHistoryNotesDetails>, "execute"> & {
    execute(toolCallId: string, params: Static<TParams>, signal: AbortSignal | undefined, onUpdate: AgentToolUpdateCallback<CodexHistoryNotesDetails> | undefined, ctx: ExtensionContext): Promise<AgentToolResult<CodexHistoryNotesDetails>>;
};
export declare function createHistoryNotesTools(pi?: Pick<ExtensionAPI, "appendEntry">, resolveMode?: (ctx: ExtensionContext) => ContextManagementMode, prepareNoteWrite?: (action: NotesAction, path: unknown, ctx: ExtensionContext) => () => boolean, route?: ContextRouter): [HistoryNotesTool<typeof HISTORY_PARAMETERS>, HistoryNotesTool<typeof NOTES_PARAMETERS>];
export declare function loadHistoryNotesThreadHint(ctx: ExtensionContext, mode: ContextManagementMode, signal?: AbortSignal): Promise<string | undefined>;
/** Read-only bridge access captures the wire body before envelope decoding. */
export declare function lookupRemoteHistoryNotes(namespace: "history" | "notes", params: Record<string, unknown>, ctx: ExtensionContext, signal?: AbortSignal): Promise<{
    bytes: Uint8Array;
    encoding: string;
    source: string;
}>;
/** The caller authenticates and owns protected delivery; the reference owns backend addressing. */
export declare function executeRemoteAttachment(ctx: ExtensionContext, reference: RemoteNoteReference, request: SharedContextRequest, signal?: AbortSignal): Promise<AgentToolResult<CodexHistoryNotesDetails>>;
export declare function usesRemoteHistoryNotes(ctx: Pick<ExtensionContext, "model" | "sessionManager">, mode: ContextManagementMode): boolean;
export {};