import type { TaskplaneEventDraft, TaskplaneOutboxEvent } from "./types.js";
export declare class TaskOutboxFullError extends Error {
    readonly retryable = true;
    constructor();
}
/**
 * Append one event durably. Events over the per-event cap are truncated (the
 * content is telemetry — losing detail beats losing the event); a full outbox
 * throws and the caller must back off.
 */
export declare function appendTaskplaneEvent(draft: TaskplaneEventDraft, options?: {
    directory?: string;
}): TaskplaneOutboxEvent;
export declare function flushTaskplaneEventOutbox(options: {
    platformUrl: string;
    koiId: string;
    gatewayToken: string;
    directory?: string;
    fetchImpl?: typeof fetch;
}): Promise<{
    sent: number;
    remaining: number;
}>;
export declare function taskplaneEventOutboxSize(directory?: string): number;