import type { MessageRef, MessageContent, MessageContext, MessageEditContext, ActionContext, ModalSubmitContext, ModalDefinition, PlatformCapabilities, PlatformFileRef, DownloadedFile, Destination, PostMessageOpts, FileUploadOpts, ActionElement } from './types.js';
import type { OutputStream, OpenOutputStreamOpts } from './output-stream.js';
export interface PlatformAdapter {
    readonly name: string;
    readonly capabilities: PlatformCapabilities;
    start(): Promise<void>;
    stop(): Promise<void>;
    onMessage(handler: (ctx: MessageContext) => Promise<void>): void;
    onMessageEdit(handler: (ctx: MessageEditContext) => Promise<void>): void;
    onAction(actionId: string, handler: (ctx: ActionContext) => Promise<void>): void;
    onModalSubmit(callbackId: string, handler: (ctx: ModalSubmitContext) => Promise<void>): void;
    postMessage(destination: Destination, content: MessageContent, opts?: PostMessageOpts): Promise<MessageRef>;
    updateMessage(ref: MessageRef, content: MessageContent): Promise<void>;
    deleteMessage(ref: MessageRef): Promise<void>;
    postInteractive(destination: Destination, content: MessageContent & {
        actions: ActionElement[];
    }, opts?: PostMessageOpts): Promise<MessageRef>;
    openModal(triggerId: string, modal: ModalDefinition): Promise<void>;
    markQueued(ref: MessageRef): Promise<void>;
    uploadFile(destination: Destination, filePath: string, opts?: FileUploadOpts): Promise<void>;
    downloadFile(fileRef: PlatformFileRef, destDir: string): Promise<DownloadedFile>;
    getPermalink(ref: MessageRef): Promise<string | null>;
    /** Open a new OutputStream for streaming agent output to the given destination. */
    openOutputStream(destination: Destination, opts?: OpenOutputStreamOpts): OutputStream;
    /** Register a conduit (channel/chat) for project-report destinations. */
    bindProjectConduit(projectId: string, conduitHint: string): Promise<void>;
    /** Remove a conduit registration. */
    unbindProjectConduit(projectId: string): Promise<void>;
    /** Get all registered project→conduit mappings. */
    getProjectConduits(): Promise<Record<string, string>>;
    /** Inverse lookup: given an inbound conduit (e.g., a Slack channel id), return
     *  the project it is currently bound to, or null if unbound. Used by the
     *  orchestration layer to attach inbound messages to their project. */
    resolveInboundProject(conduit: string): Promise<string | null>;
    /** True if the given (prefixed) conduit belongs to this adapter. Used by
     *  CompositeAdapter to route outbound operations to the right sub-adapter when
     *  multiple platforms are online simultaneously. Each adapter owns a conduit
     *  namespace by prefix: Slack `slack:`, Feishu `feishu:`, TUI `tui-`/`tui:`. */
    ownsConduit(conduit: string): boolean;
}