/**
 * V2 (opencode2) TUI plugin API — 最小本地类型（实验版）。
 * 运行时由 opencode2 提供，此处仅用于本地类型检查；
 * 结构对应 v2 分支 packages/plugin/src/tui/context.ts。
 */
export interface App {
    readonly version: string;
    readonly channel: string;
}
export interface Theme {
    readonly hue: {
        /** V1 primary 的 V2 等价（v1-migrate.ts：interactive = hues.byToken.primary）。
         *  取 300：更亮（暗背景下 400/500 偏深）。 */
        readonly interactive: {
            readonly 300: string;
        };
        /** 主题强调色别名。 */
        readonly accent: {
            readonly 500: string;
        };
    };
    /** 文本色 token 存在两代命名：base/muted 与 default/subdued。宿主按其中一代提供，
     *  读取时以 base/muted 为准，故全部声明为可选。 */
    readonly text: {
        readonly base?: string;
        readonly muted?: string;
        readonly default?: string;
        readonly subdued?: string;
        readonly feedback: {
            readonly success: {
                readonly base?: string;
                readonly default?: string;
            };
            readonly error: {
                readonly base?: string;
                readonly default?: string;
            };
            readonly warning: {
                readonly base?: string;
                readonly default?: string;
            };
        };
    };
}
/** token 用量：结构与 V1 的 message.tokens 同构，字段以运行时实际数据为准。 */
export interface TokenUsage {
    input?: number;
    output?: number;
    reasoning?: number;
    cache?: {
        read?: number;
        write?: number;
    };
}
export interface MessageInfo {
    readonly id: string;
    readonly type: string;
    readonly agent?: string;
    readonly model?: string;
    readonly time: {
        readonly created: number;
        readonly completed?: number;
    };
    readonly cost?: unknown;
    readonly tokens?: TokenUsage;
    readonly content?: unknown[];
}
export interface SessionInfo {
    readonly id: string;
    readonly title?: string;
    readonly time?: {
        readonly created: number;
        readonly updated: number;
    };
    readonly model?: string;
    readonly agent?: string;
    readonly parentID?: string;
}
export interface Data {
    readonly session: {
        get(sessionID: string): SessionInfo | undefined;
        list(): SessionInfo[];
        cost(sessionID: string): number;
        status(sessionID: string): string;
        readonly message: {
            list(sessionID: string): MessageInfo[];
            sync(sessionID: string): Promise<void>;
        };
    };
    readonly location: {
        readonly provider: {
            list(location?: unknown): unknown[];
        };
        readonly model: {
            list(location?: unknown): unknown[];
        };
        readonly mcp: {
            readonly server: {
                list(location?: unknown): unknown[];
            };
        };
    };
    readonly on: (type: string, handler: (event: unknown) => void) => () => void;
    readonly listen: (handler: (event: unknown) => void) => () => void;
}
export interface Storage {
    store<Value extends object>(key: string, options: {
        readonly initial: Value;
    }): readonly [Value, (mutation: (draft: Value) => void) => Promise<void>];
    memory<Value extends object>(key: string, options: {
        readonly initial: Value;
    }): readonly [Value, (mutation: (draft: Value) => void) => void];
}
export type SlotClaim = {
    readonly render: (input: Record<string, any>) => unknown;
} & ({
    readonly append: string;
    readonly prepend?: never;
    readonly before?: never;
    readonly after?: never;
    readonly replace?: never;
} | {
    readonly prepend: string;
    readonly append?: never;
    readonly before?: never;
    readonly after?: never;
    readonly replace?: never;
} | {
    readonly before: string;
    readonly append?: never;
    readonly prepend?: never;
    readonly after?: never;
    readonly replace?: never;
} | {
    readonly after: string;
    readonly append?: never;
    readonly prepend?: never;
    readonly before?: never;
    readonly replace?: never;
} | {
    readonly replace: string;
    readonly append?: never;
    readonly prepend?: never;
    readonly before?: never;
    readonly after?: never;
});
export interface KeymapCommand {
    readonly id?: string;
    readonly title?: string;
    readonly description?: string;
    readonly group?: string;
    readonly palette?: true;
    readonly slash?: {
        readonly name: string;
        readonly aliases?: string[];
        readonly arguments?: true;
    };
    /** 旧字段（opencode-dcp 兼容写法：palette 可见性 + slash 补全依赖它们） */
    readonly namespace?: string;
    readonly name?: string;
    readonly desc?: string;
    readonly category?: string;
    readonly slashName?: string;
    readonly slashAliases?: string[];
    readonly run: (input?: string) => void | false | Promise<void>;
}
export interface Context {
    readonly app: App;
    readonly options: Record<string, any>;
    readonly location: {
        readonly directory?: string;
    } | undefined;
    readonly renderer: {
        readonly terminalWidth: number;
    };
    readonly theme: Theme;
    readonly data: Data;
    readonly storage: Storage;
    readonly ui: {
        slot(claim: SlotClaim): () => void;
        readonly toast: {
            show(options: {
                readonly message: string;
                readonly title?: string;
                readonly variant?: string;
            }): void;
        };
        readonly dialog: {
            prompt(options: {
                readonly title: string;
                readonly description?: string;
                readonly placeholder?: string;
                readonly value?: string;
            }): Promise<string | undefined>;
            select<Value>(options: {
                readonly title: string;
                readonly placeholder?: string;
                readonly options: readonly {
                    readonly title: string;
                    readonly value: Value;
                    readonly description?: string;
                    readonly category?: string;
                    readonly disabled?: boolean;
                }[];
                readonly current?: Value;
            }): Promise<Value | undefined>;
        };
        /** 当前路由：命令需要当前会话 ID（V2 Route = { type: "session", sessionID }）。 */
        readonly router: {
            current(): {
                readonly type?: string;
                readonly sessionID?: string;
                readonly params?: Record<string, unknown>;
            };
        };
    };
    readonly keymap: {
        layer(input: () => {
            readonly commands?: readonly KeymapCommand[];
        }): void;
        shortcuts(id: string): readonly string[];
    };
}
export type PluginModule = {
    readonly id: string;
    readonly setup: (context: Context) => void | (() => void | Promise<void>) | Promise<void | (() => void | Promise<void>)>;
};