@downcity/agent 1.1.199 → 1.1.202

package/src/types/agent/SessionTypes.ts

@@ -8,7 +8,7 @@
 
 import type { LanguageModel } from "ai";
 import type { AgentModel } from "@/model/CityModelAdapter.js";
-import type { SessionMessageV1 } from "@/executor/types/SessionMessages.js";
+import type { SessionRecordV1 } from "@/executor/types/SessionRecords.js";
 
 /**
  * 新建 session 的输入参数。
@@ -83,9 +83,9 @@ export interface AgentSessionConfigSnapshot {
 }
 
 /**
- * Session 历史视图类型。
+ * Session records视图类型。
  */
-export type AgentSessionHistoryView = "message" | "timeline";
+export type AgentSessionRecordsView = "message" | "timeline";
 
 /**
  * Session 时间线事件。
@@ -99,7 +99,7 @@ export interface AgentSessionTimelineEvent {
    * 说明（中文）
    * - `tool-call` / `tool-result` 用于把 assistant 内部工具过程平铺给 UI。
    */
-  role: "user" | "assistant" | "tool-call" | "tool-result" | "operation";
+  role: "user" | "assistant" | "tool-call" | "tool-result" | "action";
   /** 事件时间戳（毫秒）。 */
   ts?: number;
   /** 事件所属消息种类。 */
@@ -116,26 +116,26 @@ export interface AgentSessionTimelineEvent {
    */
   toolName?: string;
   /**
-   * 当前 operation ID。
+   * 当前 action 标题。
    *
    * 说明（中文）
-   * - 仅 `role=operation` 的事件通常会携带该字段。
+   * - 仅 `role=action` 的事件通常会携带该字段。
    */
-  operationId?: string;
+  actionTitle?: string;
   /**
-   * 当前 operation 名称。
+   * 当前 action 描述。
    *
    * 说明（中文）
-   * - 仅 `role=operation` 的事件通常会携带该字段。
+   * - 仅 `role=action` 的事件通常会携带该字段。
    */
-  operationName?: string;
+  actionDescription?: string;
   /**
-   * 当前 operation 状态。
+   * 当前 action 状态。
    *
    * 说明（中文）
-   * - 仅 `role=operation` 的事件通常会携带该字段。
+   * - 仅 `role=action` 的事件通常会携带该字段。
    */
-  operationStatus?: string;
+  actionState?: string;
 }
 
 /**
@@ -286,9 +286,9 @@ export interface AgentSessionSummaryPage {
 }
 
 /**
- * Session 历史读取输入。
+ * Session records 读取输入。
  */
-export interface AgentSessionHistoryInput {
+export interface AgentSessionRecordsInput {
   /** 当前页返回上限。 */
   limit?: number;
   /** 分页游标。 */
@@ -316,25 +316,25 @@ export interface AgentSessionHistoryInput {
    * - `message`：原始 session 消息
    * - `timeline`：适合直接渲染 UI 的平铺事件
    */
-  view?: AgentSessionHistoryView;
+  view?: AgentSessionRecordsView;
 }
 
 /**
- * Session 历史分页结果。
+ * Session records 分页结果。
  */
-export interface AgentSessionHistoryPage {
+export interface AgentSessionRecordsPage {
   /** 当前读取所对应的 session 信息。 */
   session: AgentSessionInfo;
   /** 当前页实际返回视图。 */
-  view: AgentSessionHistoryView;
+  view: AgentSessionRecordsView;
   /**
    * 当前页数据列表。
    *
    * 说明（中文）
-   * - `view=message` 时返回 `SessionMessageV1[]`
+   * - `view=message` 时返回 `SessionRecordV1[]`
    * - `view=timeline` 时返回 `AgentSessionTimelineEvent[]`
    */
-  items: SessionMessageV1[] | AgentSessionTimelineEvent[];
+  items: SessionRecordV1[] | AgentSessionTimelineEvent[];
   /**
    * 过滤前后的总条数。
    *
@@ -360,7 +360,7 @@ export interface AgentSessionHistoryPage {
    *
    * 关键点（中文）
    * - compact summary 不会出现在 `items` 中。
-   * - 若当前层包含 compact summary，则这里暴露其 archive ID，供调用方继续 `session.history({ archive_id })`。
+   * - 若当前层包含 compact summary，则这里暴露其 archive ID，供调用方继续 `session.records({ archive_id })`。
    */
   previous_archive_id?: string;
 }

package/src/types/executor/SessionRunContext.ts

@@ -8,15 +8,15 @@
  */
 
 import type {
-  AgentSessionOperationCallback,
-  AgentSessionOperationEvent,
-  AgentSessionOperationRecord,
-} from "@/types/sdk/AgentSessionOperation.js";
+  AgentSessionActionCallback,
+  AgentSessionActionEvent,
+  AgentSessionActionRecord,
+} from "@/types/sdk/AgentSessionAction.js";
 import type {
   SessionAssistantStepCallback,
   SessionUiMessageChunkCallback,
 } from "@/executor/types/SessionRun.js";
-import type { SessionUserMessageV1 } from "@/executor/types/SessionMessages.js";
+import type { SessionUserMessageV1 } from "@/executor/types/SessionRecords.js";
 import type { FileUIPart } from "ai";
 
 /**
@@ -72,13 +72,13 @@ export interface SessionRunContext {
   onUiMessageChunkCallback?: SessionUiMessageChunkCallback;
 
   /**
-   * operation 发布回调。
+   * action 发布回调。
    *
    * 关键点（中文）
-   * - 用于把 compaction 等辅助操作转成 session event 与 operation message。
-   * - operation 不代表 assistant 正文，也不会进入 LLM 输入。
+   * - 用于把 compaction 等辅助动作转成 session event 与 action record。
+   * - action 不代表 assistant 正文，也不会进入 LLM 输入。
    */
-  onOperationCallback?: AgentSessionOperationCallback;
+  onActionCallback?: AgentSessionActionCallback;
 
   /**
    * 当前 turn 的取消信号。
@@ -117,7 +117,7 @@ export interface SessionRunContext {
 }
 
 export type {
-  AgentSessionOperationCallback,
-  AgentSessionOperationEvent,
-  AgentSessionOperationRecord,
+  AgentSessionActionCallback,
+  AgentSessionActionEvent,
+  AgentSessionActionRecord,
 };

package/src/types/rpc/RpcProtocol.ts

@@ -15,7 +15,7 @@ import type {
   AgentArchiveSessionResult,
   AgentArchiveSessionsResult,
   AgentCleanArchiveResult,
-  AgentSessionHistoryInput,
+  AgentSessionRecordsInput,
   AgentSessionStopResult,
   AgentSessionSystemSnapshot,
 } from "@/types/agent/AgentTypes.js";
@@ -112,14 +112,14 @@ export type RpcRequest =
   | {
       /** 请求 id，用于匹配响应。 */
       id: string;
-      /** 读取 session history。 */
-      method: "sdk.sessions.history";
-      /** history 查询参数。 */
+      /** 读取 session records。 */
+      method: "sdk.sessions.records";
+      /** records 查询参数。 */
       params: {
         /** 目标 session id。 */
         sessionId: string;
-        /** history 分页与视图参数。 */
-        input?: AgentSessionHistoryInput;
+        /** records 分页与视图参数。 */
+        input?: AgentSessionRecordsInput;
       };
     }
   | {

package/src/types/runtime/agent/AgentContext.ts

@@ -19,8 +19,8 @@ import type { AgentPlugins } from "@/plugin/types/Plugin.js";
 import type { Plugin } from "@/types/plugin/PluginDefinition.js";
 import type {
   SessionMetadataV1,
-  SessionMessageV1,
-} from "@/executor/types/SessionMessages.js";
+  SessionRecordV1,
+} from "@/executor/types/SessionRecords.js";
 import type {
   SessionRunInput,
   SessionRunResult,
@@ -133,7 +133,7 @@ export interface SessionPort {
    *
    * 关键点（中文）
    * - 只广播订阅之后产生的事件。
-   * - 历史消息仍通过 `getHistoryStore()` / SDK `history()` 读取。
+   * - session records 仍通过 `getHistoryStore()` / SDK `records()` 读取。
    */
   subscribe(subscriber: AgentSessionSubscriber): AgentSessionUnsubscribe;
   /**
@@ -141,7 +141,7 @@ export interface SessionPort {
    *
    * 关键点（中文）
    * - plugin runtime 用它把审批、外部进度等非模型 chunk 事件推送给订阅方。
-   * - 历史消息持久化仍由 appendUserMessage / appendAssistantMessage 负责。
+   * - 历史消息持久化仍由 append_user_message / append_assistant_message 负责。
    */
   publishEvent(event: AgentSessionEvent): void;
   /**
@@ -155,11 +155,11 @@ export interface SessionPort {
   /**
    * 追加一条 user 消息。
    */
-  appendUserMessage(params: {
+  append_user_message(params: {
     /**
      * 已构造好的完整消息。
      */
-    message?: SessionMessageV1 | null;
+    message?: SessionRecordV1 | null;
     /**
      * 兜底文本内容。
      */
@@ -172,11 +172,11 @@ export interface SessionPort {
   /**
    * 追加一条 assistant 消息。
    */
-  appendAssistantMessage(params: {
+  append_assistant_message(params: {
     /**
      * 已构造好的完整消息。
      */
-    message?: SessionMessageV1 | null;
+    message?: SessionRecordV1 | null;
     /**
      * 兜底文本内容。
      */

package/src/types/sdk/AgentSessionAction.ts

@@ -0,0 +1,35 @@
+/**
+ * Agent Session action 公开类型。
+ *
+ * 关键点（中文）
+ * - action 是 session records 中的 `type: "action"` 记录。
+ * - 同一份结构同时用于 JSONL 持久化与 `session.subscribe()` 实时事件。
+ * - action 不进入 LLM 输入；组装模型消息前必须过滤。
+ */
+
+import type {
+  SessionActionRecordV1,
+  SessionActionStateV1,
+} from "@/executor/types/SessionRecords.js";
+
+/**
+ * Session action 当前状态。
+ */
+export type AgentSessionActionState = SessionActionStateV1;
+
+/**
+ * Session action 记录。
+ */
+export type AgentSessionActionRecord = SessionActionRecordV1;
+
+/**
+ * Session action 订阅事件。
+ */
+export type AgentSessionActionEvent = SessionActionRecordV1;
+
+/**
+ * Session action 发布回调。
+ */
+export type AgentSessionActionCallback = (
+  action: AgentSessionActionEvent,
+) => Promise<void>;

package/src/types/sdk/AgentSessionEvent.ts

@@ -8,7 +8,7 @@
 
 import type { JsonValue } from "@/types/common/Json.js";
 import type { SessionAssistantStepVisibility } from "@/executor/types/SessionRun.js";
-import type { AgentSessionOperationEvent } from "@/types/sdk/AgentSessionOperation.js";
+import type { AgentSessionActionEvent } from "@/types/sdk/AgentSessionAction.js";
 
 /**
  * 单个 turn 开始事件。
@@ -355,7 +355,7 @@ export type AgentSessionEvent =
   | AgentSessionToolApprovalResultEvent
   | AgentSessionAssistantStepEvent
   | AgentSessionTitleEvent
-  | AgentSessionOperationEvent
+  | AgentSessionActionEvent
   | AgentSessionTurnFinishEvent
   | AgentSessionErrorEvent;
 

package/src/types/sdk/AgentSessionTurn.ts

@@ -7,7 +7,7 @@
  * - 增量过程继续通过 `session.subscribe()` 观察；turn handle 只负责等待最终完成结果。
  */
 
-import type { SessionModelMessageV1 } from "@/executor/types/SessionMessages.js";
+import type { SessionMessageRecordV1 } from "@/executor/types/SessionRecords.js";
 
 /**
  * 单个 Session turn 的最终结果。
@@ -35,7 +35,7 @@ export interface AgentSessionTurnResult {
    * - `turn.finished` 返回的结果以这条消息作为最终事实源。
    * - transport / runtime service 若需要读取最终结构化输出，应优先消费这里。
    */
-  assistantMessage?: SessionModelMessageV1;
+  assistantMessage?: SessionMessageRecordV1;
 
   /**
    * 当前 turn 失败时的错误文本。