atomix-cli 1.4.0 → 1.5.1

package/dist/session.d.ts

@@ -111,8 +111,30 @@ export interface FormAnswer {
 }
 /** 无人值守表单策略:抛错 / 非对象一律按跳过 */
 export type FormPolicy = (req: FormRequestInfo) => FormAnswer | Promise<FormAnswer>;
+/** 界面语言(docs/i18n-v1.md);与 core 的 Locale 同值,公开 d.ts 不能引 atomix-core 所以在此重声明 */
+export type SessionLocale = "zh-CN" | "en-US";
+/** 可嵌套的消息参数:值本身可以是另一条 {code, params}(与 core NestedMessage 同形),消费方可按自己的语言重译 */
+export interface NoteMessage {
+	code: string;
+	params?: NoteParams;
+}
+export type NoteParamValue = string | number | boolean | null | undefined | NoteMessage;
+export type NoteParams = Record<string, NoteParamValue>;
+/**
+ * 启动 / 切换备注(i18n-v1 §5):`notes: string[]` 保留不动,noteItems 是并行的结构化版本——
+ * code + params 稳定,message 已按本会话语言渲染,tone 给渲染层定色(不再靠文本前缀判警告)
+ */
+export interface NoteItem extends NoteMessage {
+	message: string;
+	tone: "info" | "warn";
+}
 export interface SessionCoreOptions {
 	cwd: string;
+	/**
+	 * 本会话的用户可见文案语言(i18n-v1 §2.2):只保存到实例,不改进程默认;
+	 * 缺省 = 进程默认(宿主 setLocale,或 ATOMIX_LANG / 系统 locale 惰性初始化)
+	 */
+	locale?: SessionLocale;
 	/** 缺省:interactive → step-by-step;headless → free-style(与现行 -p 一致,决策 1) */
 	permissionMode?: PermissionMode;
 	/** true = 有人值守(权限/提问/表单由宿主 UI 应答);false(默认)= 无人值守,自动应答器 fail-closed 接管(决策 1) */
@@ -152,8 +174,12 @@ export interface SessionCoreHandle {
 	readonly cwd: string;
 	readonly interactive: boolean;
 	readonly permissionMode: PermissionMode;
+	/** 本会话固定的文案语言(open 时解析,之后不变) */
+	readonly locale: SessionLocale;
 	/** 构造阶段的备注(如 marketplace 项目域与首个 session 不一致) */
 	readonly notes: string[];
+	/** notes 的结构化版本(同序) */
+	readonly noteItems: readonly NoteItem[];
 }
 export interface BlockedItem {
 	kind: "permission" | "question" | "form";
@@ -207,6 +233,8 @@ export interface AtomixSession<C extends SessionCoreApi = SessionCoreApi> {
 	readonly ready: SessionReadyInfo;
 	/** harness 加载告警、agent 名单应用失败、MCP override 备注、构造期备注 */
 	readonly notes: string[];
+	/** notes 的结构化版本(同序):code + params 稳定,message 已按会话语言渲染 */
+	readonly noteItems: readonly NoteItem[];
 	/** 发送一条用户输入,等到本轮 idle 后返回。多次调用按序排队 */
 	send(input: string, opts?: SendOptions): Promise<SendResult>;
 	/**
@@ -471,6 +499,7 @@ export interface ServeSessionInfo {
 }
 export interface ServeOpenResult extends ServeSessionInfo {
 	notes: string[];
+	noteItems: NoteItem[];
 	historyLoaded: boolean;
 	usage: Usage;
 }