@downcity/agent 1.1.11 → 1.1.13

package/src/session/executors/local/{LocalSessionCore.ts → Runner.ts}

@@ -1,5 +1,5 @@
 /**
- * LocalSessionCore：本地 Session 执行内核。
+ * Runner：本地 Session 执行内核。
  *
  * 关键点（中文）
  * - 这个类只做“流程编排”，不承载业务策略。
@@ -33,9 +33,9 @@ import { SessionToolLoopRunner } from "@session/executors/local/SessionToolLoopR
 const MAX_COMPACTION_RETRY_ATTEMPTS = 3;
 
 /**
- * LocalSessionCore 构造参数。
+ * Runner 构造参数。
  */
-type LocalSessionCoreOptions = {
+type RunnerOptions = {
   /** 当前模型实例。 */
   model: LanguageModel;
 
@@ -57,9 +57,9 @@ type LocalSessionCoreOptions = {
 };
 
 /**
- * LocalSessionCore 主类。
+ * Runner 主类。
  */
-export class LocalSessionCore {
+export class Runner {
   /** 模型实例：用于真正执行 streamText。 */
   private readonly model: LanguageModel;
 
@@ -78,7 +78,7 @@ export class LocalSessionCore {
   /** system 解析器：用于解析 system messages。 */
   private readonly systemComposer: SessionSystemComposer;
 
-  /** 运行互斥锁：防止同一个 LocalSessionCore 实例并发 run。 */
+  /** 运行互斥锁：防止同一个 Runner 实例并发 run。 */
   private isRunning = false;
 
   /** context-length 重试计数。 */
@@ -87,7 +87,7 @@ export class LocalSessionCore {
   /**
    * 构造函数。
    */
-  constructor(options: LocalSessionCoreOptions) {
+  constructor(options: RunnerOptions) {
     // 注入模型。
     this.model = options.model;
 
@@ -109,7 +109,7 @@ export class LocalSessionCore {
   }
 
   /**
-   * 执行一次 LocalSessionCore run。
+   * 执行一次 Runner run。
    *
    * 关键点（中文）
    * - 这里只做入口控制，不直接做模型调用。
@@ -118,7 +118,7 @@ export class LocalSessionCore {
   async run(input: SessionRunInput): Promise<SessionRunResult> {
     // 如果当前实例已经在运行，则直接拒绝并发调用。
     if (this.isRunning) {
-      throw new Error("LocalSessionCore.run does not support concurrent execution");
+      throw new Error("Runner.run does not support concurrent execution");
     }
 
     // 标记运行中。
@@ -140,7 +140,7 @@ export class LocalSessionCore {
   }
 
   /**
-   * 执行一次 LocalSessionCore run（带可压缩错误重试）。
+   * 执行一次 Runner run（带可压缩错误重试）。
    *
    * 关键点（中文）
    * - 正常：准备输入 -> 执行。
@@ -159,7 +159,7 @@ export class LocalSessionCore {
       // 执行组装好的运行输入。
       return await this.executePreparedRun(prepared);
     } catch (error) {
-      // 是否应压缩重试由 compaction Composer 决策，LocalSessionCore 只消费布尔结果。
+      // 是否应压缩重试由 compaction Composer 决策，Runner 只消费布尔结果。
       if (this.compactionComposer.shouldCompactOnError(error)) {
         // 记录压缩重试日志，便于观测问题频率。
         await this.logger.log("info", "[agent] compacting", {
@@ -187,7 +187,7 @@ export class LocalSessionCore {
       const errorMsg = String(error);
 
       // 记录错误日志。
-      await this.logger.log("error", "LocalSessionCore execution failed", {
+      await this.logger.log("error", "Runner execution failed", {
         error: errorMsg,
       });
 
@@ -213,7 +213,7 @@ export class LocalSessionCore {
   private async prepareExecuteInput(query: string): Promise<SessionExecuteInput> {
     // 基础安全检查：historyComposer 必须携带 sessionId。
     if (!String(this.historyComposer.sessionId || "").trim()) {
-      throw new Error("LocalSessionCore.run requires historyComposer.sessionId");
+      throw new Error("Runner.run requires historyComposer.sessionId");
     }
 
     // 让 execution Composer 组装运行上下文（例如 tools 与 request 作用域）。

package/src/session/executors/local/SessionExecutionError.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - AI SDK 的最终错误有时只是兜底包装，底层 provider 错误会先从 stream `onError` 暴露。
- * - LocalSessionCore 只需要消费这里输出的日志字段与最终错误文本。
+ * - Runner 只需要消费这里输出的日志字段与最终错误文本。
  */
 
 import type { JsonObject } from "@/types/common/Json.js";

package/src/session/executors/local/SessionLoopDecision.ts

@@ -1,8 +1,8 @@
 /**
- * SessionLoopDecision：LocalSessionCore 执行循环的纯决策模块。
+ * SessionLoopDecision：Runner 执行循环的纯决策模块。
  *
  * 关键点（中文）
- * - 把 “是否继续下一轮” 的分支优先级从 LocalSessionCore 主流程中拆出。
+ * - 把 “是否继续下一轮” 的分支优先级从 Runner 主流程中拆出。
  * - 保持纯函数，不依赖模型、持久化或 logger，便于直接测试。
  */
 
@@ -13,7 +13,7 @@ import type {
 } from "@/session/types/SessionLoop.js";
 
 /**
- * 评估当前 step 完成后，LocalSessionCore 是否应继续下一轮。
+ * 评估当前 step 完成后，Runner 是否应继续下一轮。
  *
  * 优先级（中文）
  * 1. 不完整响应恢复

package/src/session/executors/local/SessionModelMessageState.ts

@@ -2,7 +2,7 @@
  * Session 模型消息运行态。
  *
  * 关键点（中文）
- * - LocalSessionCore 同时维护 session 语义消息与模型消息。
+ * - Runner 同时维护 session 语义消息与模型消息。
  * - 新增 user 消息可优先做增量转换，失败时再回退为全量重算。
  * - assistant UI 消息只需要进入 session 语义基线；模型侧使用 SDK 返回的 response messages。
  */
@@ -15,7 +15,7 @@ import {
 } from "@session/messages/SessionMessageCodec.js";
 
 /**
- * LocalSessionCore 单轮执行期间的消息基线。
+ * Runner 单轮执行期间的消息基线。
  */
 export class SessionModelMessageState {
   /**

package/src/session/executors/local/SessionSignals.ts

@@ -1,10 +1,10 @@
 /**
- * SessionLoopSignals：LocalSessionCore 执行循环的信号判断与调试摘要工具。
+ * SessionLoopSignals：Runner 执行循环的信号判断与调试摘要工具。
  *
  * 关键点（中文）
  * - 这里只放“如何判断继续执行 / 如何输出调试摘要”的纯函数。
- * - 不放 LocalSessionCore 主流程，避免执行内核被大量辅助细节淹没。
- * - 目标是让 LocalSessionCore 保持“只看主链路就能理解”的结构。
+ * - 不放 Runner 主流程，避免执行内核被大量辅助细节淹没。
+ * - 目标是让 Runner 保持“只看主链路就能理解”的结构。
  */
 
 import {

package/src/session/executors/local/SessionToolLoopRunner.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 这里只负责已准备好的 `SessionExecuteInput` 如何进入 `streamText` 循环。
- * - LocalSessionCore 保留入口、重试与输入准备职责，本模块负责 step 循环、续写、恢复和最终日志。
+ * - Runner 保留入口、重试与输入准备职责，本模块负责 step 循环、续写、恢复和最终日志。
  * - 运行过程中同时维护 UI assistant 消息、模型消息基线和 step 统计。
  */
 
@@ -334,7 +334,7 @@ export class SessionToolLoopRunner {
         streamError: lastObservedStreamError,
       });
 
-      await this.logger.log("error", "LocalSessionCore execution failed", {
+      await this.logger.log("error", "Runner execution failed", {
         error: errorMsg,
       });
 

package/src/session/types/SessionHistoryMeta.ts

@@ -27,6 +27,8 @@ export type SessionHistoryMetaV1 = {
   agentId?: string;
   /** 当前 session 首次创建时间戳（ms）。 */
   createdAt?: number;
+  /** 当前 session 初始化时解析到的系统时区。 */
+  timezone?: string;
   /** 最近一次更新元信息的时间戳（ms）。 */
   updatedAt: number;
   /** 固定注入到 Session 上下文的 skill id 列表。 */

package/src/session/types/SessionLoop.ts

@@ -1,5 +1,5 @@
 /**
- * LocalSessionCore tool-loop 决策相关类型。
+ * Runner tool-loop 决策相关类型。
  *
  * 关键点（中文）
  * - 这里只描述“是否继续下一轮”的纯决策输入/输出。

package/src/session/types/SessionRun.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - `SessionRunInput` 表示上层会话入口输入（例如 context query）。
- * - `SessionExecuteInput` 表示 LocalSessionCore 通过 Composer 装配后的中间运行态。
+ * - `SessionExecuteInput` 表示 Runner 通过 Composer 装配后的中间运行态。
  * - 输出仅暴露 assistantMessage（UIMessage）。
  */
 
@@ -107,7 +107,7 @@ export interface SessionRunInput {
 }
 
 /**
- * LocalSessionCore 通过 Composer 装配后的中间运行态。
+ * Runner 通过 Composer 装配后的中间运行态。
  */
 export interface SessionExecuteInput {
   /**