import type { ControlLogBatch, ControlLogSnapshot, ControlLogSource } from "@onebots/core/control";
import type { PersistedOperationObserver } from "../persisted-operation-observer.js";
/** 写入与读取共用权限边界，绝不跟随预置链接或修正外部文件权限。 */
export declare function openGatewayLog(workspace: string): {
    fd: number;
    close(): void;
};
export declare function appendGatewayLog(workspace: string, text: string): void;
/** Fixed-source append only; callers must provide already-redacted, bounded records. */
export declare function appendControlLog(workspace: string, source: ControlLogSource, text: string): void;
/** CLI 与运行中的 manager 共用同一条安全 operation.log 写入边界。 */
export declare function createControlOperationObserver(workspace: string): PersistedOperationObserver;
export declare function createControlLogWriter(workspace: string, managerId: string): {
    manager: (event: "started" | "ready" | "stopped") => void;
    operation: PersistedOperationObserver;
};
/** 固定文件、有界读取；不依赖网关在线，不提供任意路径或读取整个文件。 */
export declare function readGatewayLog(workspace: string): ControlLogSnapshot;
/** Fixed file, bounded incremental read. Cursor mismatch is a visible reset, never a path fallback. */
export declare function readControlLog(workspace: string, source: ControlLogSource, priorCursor?: string): ControlLogBatch;
//# sourceMappingURL=gateway-log.d.ts.map