@downcity/agent 1.1.200 → 1.1.203

package/src/session/Session.ts

@@ -15,8 +15,8 @@ import type {
   AgentSession,
   AgentSessionConfigSnapshot,
   AgentSessionForkInput,
-  AgentSessionHistoryInput,
-  AgentSessionHistoryPage,
+  AgentSessionRecordsInput,
+  AgentSessionRecordsPage,
   AgentSessionInfo,
   AgentSessionSetInput,
   AgentSessionSystemBlock,
@@ -207,7 +207,7 @@ export class Session implements AgentSession {
   /**
    * 追加一条 user 文本消息。
    */
-  async appendUserMessage(input: {
+  async append_user_message(input: {
     text: string;
   }): Promise<void> {
     await this.stateService.append_user_message({
@@ -218,7 +218,7 @@ export class Session implements AgentSession {
   /**
    * 追加一条 assistant 文本消息。
    */
-  async appendAssistantMessage(input: {
+  async append_assistant_message(input: {
     text: string;
   }): Promise<void> {
     await this.stateService.append_assistant_message({
@@ -229,15 +229,15 @@ export class Session implements AgentSession {
   /**
    * 读取当前 session 详情。
    */
-  async getInfo(): Promise<AgentSessionInfo> {
+  async get_info(): Promise<AgentSessionInfo> {
     return await this.viewService.get_info();
   }
 
   /**
-   * 读取当前 session 历史分页。
+   * 读取当前 session records 分页。
    */
-  async history(input?: AgentSessionHistoryInput): Promise<AgentSessionHistoryPage> {
-    return await this.viewService.history(input);
+  async records(input?: AgentSessionRecordsInput): Promise<AgentSessionRecordsPage> {
+    return await this.viewService.records(input);
   }
 
   /**
@@ -288,10 +288,10 @@ export class Session implements AgentSession {
       afterSessionUpdatedAsync: async () => {
         await this.executor.afterSessionUpdatedAsync();
       },
-      appendUserMessage: async (message_params) => {
+      append_user_message: async (message_params) => {
         await this.stateService.append_user_message(message_params);
       },
-      appendAssistantMessage: async (message_params) => {
+      append_assistant_message: async (message_params) => {
         await this.stateService.append_assistant_message(message_params);
       },
       isExecuting: () => this.isExecuting(),

package/src/session/SessionTitle.ts

@@ -9,8 +9,8 @@
 
 import { generateText, type LanguageModel } from "ai";
 import type { SessionHistoryMetaV1 } from "@/executor/types/SessionHistoryMeta.js";
-import type { SessionMessageV1 } from "@/executor/types/SessionMessages.js";
-import { isSessionModelMessage } from "@/executor/types/SessionMessages.js";
+import type { SessionRecordV1 } from "@/executor/types/SessionRecords.js";
+import { is_session_message_record } from "@/executor/types/SessionRecords.js";
 import {
   normalizeSessionTitle,
   readSessionMetadata,
@@ -41,7 +41,7 @@ export interface EnsureSessionTitleParams {
   /**
    * 当前 session 已落盘消息。
    */
-  messages: SessionMessageV1[];
+  messages: SessionRecordV1[];
 
   /**
    * 可选模型实例；传入时会尝试生成更短标题。
@@ -61,8 +61,8 @@ function truncateTitle(input: string, maxChars: number): string {
   return title.slice(0, maxChars).trimEnd();
 }
 
-function extractTextFromMessage(message: SessionMessageV1): string {
-  if (!isSessionModelMessage(message)) return "";
+function extractTextFromMessage(message: SessionRecordV1): string {
+  if (!is_session_message_record(message)) return "";
   if (!Array.isArray(message.parts)) return "";
   const texts: string[] = [];
   for (const part of message.parts) {
@@ -76,9 +76,9 @@ function extractTextFromMessage(message: SessionMessageV1): string {
   return texts.join("\n").trim();
 }
 
-function resolveFirstUserText(messages: SessionMessageV1[]): string {
+function resolveFirstUserText(messages: SessionRecordV1[]): string {
   for (const message of messages) {
-    if (!isSessionModelMessage(message)) continue;
+    if (!is_session_message_record(message)) continue;
     if (message.role !== "user") continue;
     const text = extractTextFromMessage(message);
     if (text) return text;

package/src/session/browse/Browse.ts

@@ -17,24 +17,24 @@ import {
 } from "ai";
 import type {
   AgentListSessionsInput,
-  AgentSessionHistoryInput,
-  AgentSessionHistoryPage,
-  AgentSessionHistoryView,
+  AgentSessionRecordsInput,
+  AgentSessionRecordsPage,
+  AgentSessionRecordsView,
   AgentSessionInfo,
   AgentSessionSummary,
   AgentSessionSummaryPage,
   AgentSessionTimelineEvent,
 } from "@/types/agent/AgentTypes.js";
 import type {
-  SessionActionMessageV1,
-  SessionMessageV1,
+  SessionActionRecordV1,
+  SessionRecordV1,
   SessionMetadataV1,
-  SessionModelMessageV1,
-} from "@/executor/types/SessionMessages.js";
+  SessionMessageRecordV1,
+} from "@/executor/types/SessionRecords.js";
 import {
-  isSessionActionMessage,
-  isSessionModelMessage,
-} from "@/executor/types/SessionMessages.js";
+  is_session_action_record,
+  is_session_message_record,
+} from "@/executor/types/SessionRecords.js";
 import type { SessionHistoryMetaV1 } from "@/executor/types/SessionHistoryMeta.js";
 import { pickLastSuccessfulChatSendText } from "@/executor/messages/UserVisibleText.js";
 import { getSdkAgentSessionMessagesPath } from "@/session/storage/Paths.js";
@@ -81,7 +81,7 @@ type SessionBrowseBaseInput = {
   /**
    * 当前 session 已读取到的完整消息。
    */
-  messages: SessionMessageV1[];
+  messages: SessionRecordV1[];
 
   /**
    * 当前 session 是否正在执行。
@@ -177,7 +177,7 @@ function extractMessageText(parts: unknown): string {
   return texts.join("\n").trim();
 }
 
-function extractAssistantToolSummary(message: SessionModelMessageV1): string {
+function extractAssistantToolSummary(message: SessionMessageRecordV1): string {
   if (!Array.isArray(message.parts)) return "";
   const toolNames = new Set<string>();
   for (const part of message.parts as AnyUiPart[]) {
@@ -193,13 +193,13 @@ function extractAssistantToolSummary(message: SessionModelMessageV1): string {
 /**
  * 解析单条 session 消息的用户可见预览文本。
  */
-export function resolveSessionMessagePreview(message: SessionMessageV1): string {
-  if (isSessionActionMessage(message)) {
+export function resolveSessionMessagePreview(message: SessionRecordV1): string {
+  if (is_session_action_record(message)) {
     return message.description
       ? `${message.title}\n${message.description}`
       : message.title;
   }
-  if (!isSessionModelMessage(message)) return "";
+  if (!is_session_message_record(message)) return "";
   const plainText = extractMessageText(message.parts);
   if (plainText) return plainText;
   if (message.role !== "assistant") return "";
@@ -237,7 +237,7 @@ function extractToolResultOutput(part: ToolPartCompatShape): unknown {
 }
 
 function toTimelineEvent(params: {
-  message: SessionModelMessageV1;
+  message: SessionMessageRecordV1;
   role: AgentSessionTimelineEvent["role"];
   text: string;
   sequence: number;
@@ -256,7 +256,7 @@ function toTimelineEvent(params: {
 }
 
 function toActionTimelineEvent(
-  message: SessionActionMessageV1,
+  message: SessionActionRecordV1,
 ): AgentSessionTimelineEvent {
   const metadata = message.metadata || null;
   return {
@@ -274,13 +274,13 @@ function toActionTimelineEvent(
  * 把单条 session message 展平成时间线事件。
  */
 export function toSessionTimelineEvents(
-  message: SessionMessageV1,
+  message: SessionRecordV1,
 ): AgentSessionTimelineEvent[] {
-  if (isSessionActionMessage(message)) {
+  if (is_session_action_record(message)) {
     return [toActionTimelineEvent(message)];
   }
 
-  if (!isSessionModelMessage(message)) return [];
+  if (!is_session_message_record(message)) return [];
   if (message.role !== "assistant") {
     return [
       toTimelineEvent({
@@ -366,14 +366,14 @@ export function toSessionTimelineEvents(
  */
 export async function loadSessionMessagesFromPath(
   filePath: string,
-): Promise<SessionMessageV1[]> {
-  const messages: SessionMessageV1[] = [];
+): Promise<SessionRecordV1[]> {
+  const messages: SessionRecordV1[] = [];
   if (await fs.pathExists(filePath)) {
     const raw = await fs.readFile(filePath, "utf-8");
     const lines = raw.split("\n").filter(Boolean);
     for (const line of lines) {
       try {
-        const parsed = JSON.parse(line) as SessionMessageV1;
+        const parsed = JSON.parse(line) as SessionRecordV1;
         if (!parsed || typeof parsed !== "object") continue;
         const candidate = parsed as { type?: unknown; role?: unknown };
         if (
@@ -393,9 +393,9 @@ export async function loadSessionMessagesFromPath(
   const inflight_path = filePath.replace(/messages\.jsonl$/, "inflight.json");
   if (await fs.pathExists(inflight_path)) {
     try {
-      const parsed = (await fs.readJson(inflight_path)) as SessionMessageV1;
+      const parsed = (await fs.readJson(inflight_path)) as SessionRecordV1;
       if (
-        isSessionModelMessage(parsed) &&
+        is_session_message_record(parsed) &&
         parsed.role === "assistant" &&
         Array.isArray(parsed.parts)
       ) {
@@ -418,11 +418,11 @@ export async function loadSessionMessagesFromPath(
  */
 export async function loadSessionArchiveMessagesFromPath(
   filePath: string,
-): Promise<SessionMessageV1[]> {
+): Promise<SessionRecordV1[]> {
   try {
     const raw = (await fs.readJson(filePath)) as SessionArchiveFileV1 | null;
     const items = Array.isArray(raw?.messages) ? raw.messages : [];
-    return items.filter((item): item is SessionMessageV1 => {
+    return items.filter((item): item is SessionRecordV1 => {
       if (!item || typeof item !== "object") return false;
       const candidate = item as { type?: unknown; role?: unknown; parts?: unknown };
       return (
@@ -439,13 +439,13 @@ export async function loadSessionArchiveMessagesFromPath(
   }
 }
 
-function isCompactSummaryMessage(message: SessionMessageV1): boolean {
-  if (!isSessionModelMessage(message)) return false;
+function isCompactSummaryMessage(message: SessionRecordV1): boolean {
+  if (!is_session_message_record(message)) return false;
   const metadata = (message.metadata || null) as SessionMetadataV1 | null;
   return metadata?.source === "compact" || metadata?.kind === "summary";
 }
 
-function resolvePreviousArchiveId(messages: SessionMessageV1[]): string | undefined {
+function resolvePreviousArchiveId(messages: SessionRecordV1[]): string | undefined {
   for (const message of messages) {
     if (!isCompactSummaryMessage(message)) continue;
     const metadata = (message.metadata || null) as SessionMetadataV1 | null;
@@ -456,8 +456,8 @@ function resolvePreviousArchiveId(messages: SessionMessageV1[]): string | undefi
 }
 
 function filterUserVisibleHistoryMessages(
-  messages: SessionMessageV1[],
-): SessionMessageV1[] {
+  messages: SessionRecordV1[],
+): SessionRecordV1[] {
   return messages.filter((message) => !isCompactSummaryMessage(message));
 }
 
@@ -500,14 +500,14 @@ export function buildSessionInfo(
 }
 
 /**
- * 基于完整消息列表构建 session history 分页结果。
+ * 基于完整消息列表构建 session records 分页结果。
  */
-export function buildSessionHistoryPage(params: {
+export function buildSessionRecordsPage(params: {
   session: AgentSessionInfo;
-  messages: SessionMessageV1[];
-  input?: AgentSessionHistoryInput;
-}): AgentSessionHistoryPage {
-  const view: AgentSessionHistoryView = params.input?.view || "message";
+  messages: SessionRecordV1[];
+  input?: AgentSessionRecordsInput;
+}): AgentSessionRecordsPage {
+  const view: AgentSessionRecordsView = params.input?.view || "message";
   const order = params.input?.order || "asc";
   const limit = normalizeLimit(params.input?.limit, 50, 500);
   const cursor = normalizeCursor(params.input?.cursor);

package/src/session/index.ts

@@ -46,7 +46,7 @@ export {
   createRuntimeSessionPort,
 } from "./storage/RuntimeSessionPort.js";
 export {
-  buildSessionHistoryPage,
+  buildSessionRecordsPage,
   buildSessionInfo,
   listArchivedAgentSessionSummaryPage,
   listAgentSessionSummaryPage,

package/src/session/runtime/SessionPromptRuntime.ts

@@ -8,11 +8,11 @@
  */
 
 import { nanoid } from "nanoid";
-import type { SessionUserMessageV1 } from "@/executor/types/SessionMessages.js";
+import type { SessionUserMessageV1 } from "@/executor/types/SessionRecords.js";
 import type {
-  SessionMessageV1,
-  SessionModelMessageV1,
-} from "@/executor/types/SessionMessages.js";
+  SessionRecordV1,
+  SessionMessageRecordV1,
+} from "@/executor/types/SessionRecords.js";
 import type { AgentSessionEvent } from "@/types/sdk/AgentSessionEvent.js";
 import type { AgentSessionPromptInput } from "@/types/sdk/AgentSessionPrompt.js";
 import type { AgentSessionStopResult } from "@/types/sdk/AgentSessionStop.js";
@@ -109,7 +109,7 @@ export interface SessionPromptRuntimeOptions {
   }) => Promise<{
     text: string;
     success: boolean;
-    assistantMessage?: SessionModelMessageV1 | null;
+    assistantMessage?: SessionMessageRecordV1 | null;
     error?: string;
   }>;
 
@@ -349,7 +349,7 @@ export class SessionPromptRuntime {
 function buildPromptRuntimeErrorAssistantMessage(input: {
   sessionId: string;
   message: string;
-}): SessionModelMessageV1 {
+}): SessionMessageRecordV1 {
   return {
     id: `a:${input.sessionId}:${Date.now()}:${nanoid(6)}`,
     role: "assistant",

package/src/session/services/SessionStateService.ts

@@ -30,16 +30,15 @@ import type {
 import type {
   AgentSessionEvent,
 } from "@/types/sdk/AgentSessionEvent.js";
-import type {
-  AgentSessionActionEvent,
-  AgentSessionActionRecord,
-} from "@/types/sdk/AgentSessionAction.js";
 import type { AgentSessionPromptInput } from "@/types/sdk/AgentSessionPrompt.js";
 import type {
-  SessionMessageV1,
-  SessionModelMessageV1,
+  SessionActionRecordInputV1,
+  SessionActionRecordV1,
+  SessionRecordV1,
+  SessionMessageRecordV1,
   SessionUserMessageV1,
-} from "@/executor/types/SessionMessages.js";
+} from "@/executor/types/SessionRecords.js";
+import { to_session_action_record } from "@/executor/types/SessionRecords.js";
 import type { SessionLocalState } from "@/types/session/SessionLocalState.js";
 import { generateId } from "@/utils/Id.js";
 
@@ -96,8 +95,7 @@ type SessionSetOptions = {
   emit_action?: boolean;
 };
 
-type EmitActionInput = Omit<AgentSessionActionRecord, "id"> &
-  Partial<Pick<AgentSessionActionRecord, "id">>;
+type EmitActionInput = SessionActionRecordInputV1 | SessionActionRecordV1;
 
 /**
  * 本地 Session 状态与持久化服务。
@@ -228,9 +226,17 @@ export class SessionStateService {
     const next_model_label = input.model
       ? inferAgentModelLabel(input.model)
       : undefined;
+    const should_emit_model_switch_action = Boolean(
+      input.model &&
+        should_emit_action &&
+        this.state.sessionConfig.model &&
+        previous_model_label &&
+        next_model_label &&
+        previous_model_label !== next_model_label,
+    );
     const action_id = `model-switching:${this.session_id}:${Date.now()}:${generateId()}`;
 
-    if (input.model && should_emit_action) {
+    if (should_emit_model_switch_action) {
       await this.emit_action_event({
         id: action_id,
         title: "Switching session model",
@@ -254,7 +260,7 @@ export class SessionStateService {
         model: this.state.sessionConfig.model,
       });
     } catch (error) {
-      if (input.model && should_emit_action) {
+      if (should_emit_model_switch_action) {
         await this.emit_action_event({
           id: action_id,
           title: "Session model switch failed",
@@ -265,7 +271,7 @@ export class SessionStateService {
       throw error;
     }
 
-    if (input.model && should_emit_action) {
+    if (should_emit_model_switch_action) {
       await this.emit_action_event({
         id: action_id,
         title: "Session model switched",
@@ -281,10 +287,10 @@ export class SessionStateService {
    * 追加一条 user 消息并刷新标题与 metadata。
    */
   async append_user_message(params: {
-    message?: SessionMessageV1 | null;
+    message?: SessionRecordV1 | null;
     text?: string;
   }): Promise<void> {
-    await this.executor.appendUserMessage(params);
+    await this.executor.append_user_message(params);
     await this.ensure_title_from_history({ generate: true });
     await this.touch_metadata();
   }
@@ -293,10 +299,10 @@ export class SessionStateService {
    * 追加一条 assistant 消息并刷新 metadata。
    */
   async append_assistant_message(params: {
-    message?: SessionMessageV1 | null;
+    message?: SessionRecordV1 | null;
     fallbackText?: string;
   }): Promise<void> {
-    await this.executor.appendAssistantMessage(params);
+    await this.executor.append_assistant_message(params);
     await this.touch_metadata();
   }
 
@@ -321,7 +327,7 @@ export class SessionStateService {
      */
     generate?: boolean;
   }): Promise<void> {
-    const messages = await this.history_store.list();
+    const messages = await this.history_store.list_records();
     const before_metadata = await readSessionMetadata({
       projectRoot: this.project_root,
       agentId: this.agent_id,
@@ -349,7 +355,7 @@ export class SessionStateService {
    * 持久化最终 assistant 结果。
    */
   async persist_assistant_result(
-    assistant_message?: SessionModelMessageV1 | null,
+    assistant_message?: SessionMessageRecordV1 | null,
   ): Promise<void> {
     await persistSdkAssistantResult({
       projectRoot: this.project_root,
@@ -362,24 +368,13 @@ export class SessionStateService {
   }
 
   /**
-   * 持久化一条 action message。
+   * 持久化一条 action record。
    */
   async persist_action_event(
-    event: AgentSessionActionEvent,
+    event: SessionActionRecordV1,
   ): Promise<void> {
-    const message = this.history_store.action({
-      action: {
-        id: event.id,
-        title: event.title,
-        state: event.state,
-        ...(event.description ? { description: event.description } : {}),
-        ...(event.turnId ? { turnId: event.turnId } : {}),
-      },
-      metadata: {
-        sessionId: this.session_id,
-      },
-    });
-    await this.history_store.append(message);
+    const message = to_session_action_record(event, this.session_id);
+    await this.history_store.write_record(message);
     await this.touch_metadata();
   }
 
@@ -387,17 +382,15 @@ export class SessionStateService {
    * 写入并发布一条 action。
    */
   async emit_action_event(input: EmitActionInput): Promise<void> {
-    if (input.visible === false) return;
-    const action_id =
-      String(input.id || "").trim() ||
-      `action:${this.session_id}:${Date.now()}:${generateId()}`;
-    const { visible: _visible, ...public_input } = input;
-    const event: AgentSessionActionEvent = {
-      type: "action",
-      sessionId: this.session_id,
-      ...public_input,
-      id: action_id,
-    };
+    const event = to_session_action_record(
+      {
+        ...input,
+        id:
+          String(input.id || "").trim() ||
+          `action:${this.session_id}:${Date.now()}:${generateId()}`,
+      },
+      this.session_id,
+    );
     try {
       await this.persist_action_event(event);
     } catch {
@@ -420,7 +413,7 @@ export class SessionStateService {
           sessionId: this.session_id,
         },
       }) as SessionUserMessageV1;
-      await this.executor.appendUserMessage({
+      await this.executor.append_user_message({
         message,
       });
       await this.ensure_title_from_history({ generate: true });
@@ -445,7 +438,7 @@ export class SessionStateService {
         kind: "normal",
       },
     };
-    await this.executor.appendUserMessage({
+    await this.executor.append_user_message({
       message,
     });
     await this.ensure_title_from_history({ generate: true });
@@ -464,7 +457,7 @@ export class SessionStateService {
       : [];
     if (normalized_messages.length <= 0) return;
     for (const message of normalized_messages) {
-      await this.executor.appendUserMessage({
+      await this.executor.append_user_message({
         message,
       });
     }

package/src/session/services/SessionTurnService.ts

@@ -19,10 +19,10 @@ import type { AgentSessionPromptInput } from "@/types/sdk/AgentSessionPrompt.js"
 import type { AgentSessionStopResult } from "@/types/sdk/AgentSessionStop.js";
 import type { AgentSessionTurnHandle } from "@/types/sdk/AgentSessionTurn.js";
 import type {
-  SessionMessageV1,
-  SessionModelMessageV1,
+  SessionRecordV1,
+  SessionMessageRecordV1,
   SessionUserMessageV1,
-} from "@/executor/types/SessionMessages.js";
+} from "@/executor/types/SessionRecords.js";
 import { mapAgentEventToSessionEvent, mapUiMessageChunkToAgentEvent } from "@/session/SessionEventMapper.js";
 import { SessionEventHub } from "@/session/runtime/SessionEventHub.js";
 import { SessionPromptRuntime } from "@/session/runtime/SessionPromptRuntime.js";
@@ -145,7 +145,7 @@ export class SessionTurnService {
   }): Promise<{
     text: string;
     success: boolean;
-    assistantMessage?: SessionModelMessageV1 | null;
+    assistantMessage?: SessionMessageRecordV1 | null;
     error?: string;
   }> {
     const tool_name_by_call_id = new Map<string, string>();