/**
 * 客户端与服务端共享的契约（架构设计第 2 节）。
 *
 * 只放类型与模式定义，不引入运行时依赖：这一层被所有包依赖，任何依赖都会变成全局耦合。
 * 引擎差异不在这里体现——引擎事件经适配层转成下面的平台事件，界面对引擎无感。
 */

/** 能力标识，形如 `aps.schedule.preview`。命名与描述规范见 docs/spec/capability-description.md */
export type CapabilityId = string;

/** 执行回执：所有能力调用的统一返回（架构设计 4.2） */
export interface ExecutionReceipt {
  executionId: string;
  status: 'accepted' | 'succeeded' | 'failed' | 'pending-confirmation';
  result?: unknown;
  errorKind?: string;
}

/** 平台事件：唯一面向客户端的事件形态（实施设计 1.7 定义事件模型） */
export type PlatformEvent =
  | { type: 'message.delta'; sessionId: string; text: string }
  | { type: 'tool.call'; sessionId: string; capabilityId: CapabilityId }
  | { type: 'receipt'; sessionId: string; receipt: ExecutionReceipt };