import type { Context } from './context-types.ts';
import { type SidechatLiveEvent, type SidechatLogEvent, type SidechatThreadInfo } from './sidechat-core.ts';
import type { AssistantLiveBuffer } from './assistant-live.ts';
/** The six Side Chat routes of the sidebar API (wire method names). */
export interface SidechatRoutes {
    /** Create a side thread child seeded with the parent's log up to now.
     *  `question` is optional: empty creates an EMPTY thread (Codex-style
     *  immediate create); the first `sidechat.prompt` then carries the
     *  boundary + snapshot and earns the thread its real label. */
    'sidechat.start'(payload: unknown): Promise<{
        childId: string;
    }>;
    /** Deliver one follow-up message to a thread (live, or cold-resumed). */
    'sidechat.prompt'(payload: unknown): Promise<{
        accepted: true;
    }>;
    /** Abort the thread's running turn (queued work is preserved). */
    'sidechat.cancel'(payload: unknown): Promise<{
        accepted: true;
    }>;
    /** Release the thread's live agent (session and history stay persisted). */
    'sidechat.dispose'(payload: unknown): Promise<{
        accepted: true;
    }>;
    /** Live state + agent identity for the thread header. */
    'sidechat.info'(payload: unknown): Promise<SidechatThreadInfo>;
    /** The thread's OWN transcript events, seed-cut host-side (the inherited
     *  parent log never crosses the wire); `afterSeq` narrows the response to
     *  the delta beyond it (poll tail). `live` carries the thread's in-flight
     *  model deltas, which DSH 0.1.5 publishes outside the session log — it is
     *  the CURRENT attempt's rows on every poll, never a delta. */
    'sidechat.events'(payload: unknown): Promise<{
        events: SidechatLogEvent[];
        live: SidechatLiveEvent[];
    }>;
}
/** Build the Side Chat routes (all optional services degrade to a wire
 *  error the tab surfaces inline). The record keys are the FULL wire method
 *  names the /sidebar/api dispatcher looks up (`api[method]`).
 *  @param ctx - host plugin context.
 *  @param live - the live assistant stream buffer; absent only in tests that
 *    never exercise streaming (then every `live` response is empty). */
export declare function buildSidechatApi(ctx: Context, live?: AssistantLiveBuffer): SidechatRoutes;