export const MODE_PLAN: 'plan';
export const MODE_WORKSPACE: 'workspace';
export const MODE_FULL: 'full';
export const MODES: string[];
export const DEFAULT_MODE: string;

export const ENFORCE_NATIVE: 'native';
export const ENFORCE_ADVISORY: 'advisory';

export function normalizeMode(mode: unknown): string;
export function normalizeEnforcement(e: unknown): string;
export function modeAtMost(a: string, b: string): string;
export function modeNeedsHuman(mode: string): boolean;

export interface OpencodePermissionRule {
  permission: string;
  action: string;
  pattern: string;
}
export function opencodePermissions(mode: string): OpencodePermissionRule[];

export function dshSandboxMode(mode: string): 'read-only' | 'workspace-write' | 'danger-full-access';
export function dshApprovalPolicy(mode: string): 'ask' | 'never';

export function piGuardedTools(mode: string): string[];
export function piBlocksOutright(mode: string): boolean;

export interface ModeBriefingCtx {
  mode: string;
  enforcement: string;
  workspace?: string;
}
export function modeBriefing(ctx: ModeBriefingCtx): string;