/**
 * agent_bridge built-in tool — `store_lesson`.
 *
 * Authoritative spec: `docs/tasks/T-warm-agent-chat-bridge.md` WAB.6 §"Tool
 * surface" + memory `project_opensquid_wedge_gate_two_stages` Stage 1 +
 * `project_opensquid_automation_buffer_pattern`.
 *
 * Why the automation buffer (not direct wedge-gate `capturePendingLesson`):
 *   The existing `src/runtime/wedge/capture.ts` writes to
 *   `~/.opensquid/sessions/<sessionId>/pending-lessons/potential-lessons/`
 *   — the buffer is SESSION-scoped, keyed by an opensquid hook session id
 *   (provided by the host's hook payload). The chat-bridge does NOT have a
 *   matching session id at this layer — the daemon-side SessionKey is a
 *   `(platform, chatId, threadId?)` tuple, not the opensquid hook session.
 *   Cross-wiring those would force a session-id translation table that
 *   doesn't exist yet (and would belong in WAB.7 daemon wiring, not in a
 *   tool wrapper).
 *
 *   So we follow the spec's recommendation: write to a separate
 *   automation-buffer file at `~/.opensquid/agent-bridge/captured-lessons.jsonl`
 *   (one JSON-per-line, append-only). End-of-run / user-driven validation
 *   walks this file in a later pass — the wedge-gate Stage 1 invariant
 *   holds because nothing here promotes silently; the user MUST review
 *   the JSONL before anything moves to the proper wedge-gate buffer.
 *
 * Failure mode:
 *   - Disk full / permission denied → the underlying `appendFile` throws,
 *     and the agent loop catches + feeds the error back to the model as a
 *     `tool_result`. The model can decide to retry or give up.
 *
 * Imports from: node:fs/promises, node:path, node:os, zod, ../types.js.
 * Imported by: ./index.ts (tools barrel).
 */
import type { ToolHandler, ToolSpec } from '../types.js';
export declare const storeLessonSpec: ToolSpec;
export declare function bufferPath(): string;
export interface MakeStoreLessonHandlerOptions {
    nowIso?: () => string;
}
export declare function makeStoreLessonHandler(opts?: MakeStoreLessonHandlerOptions): ToolHandler;
//# sourceMappingURL=store_lesson.d.ts.map