@downcity/agent 1.1.51 → 1.1.63

package/src/agent/Agent.ts

@@ -13,7 +13,7 @@
 
 import fs from "fs-extra";
 import { nanoid } from "nanoid";
-import type { LanguageModel, Tool } from "ai";
+import type { Tool } from "ai";
 import type { BasePlugin } from "@/plugin/core/BasePlugin.js";
 import type {
   AgentContext,
@@ -41,6 +41,7 @@ import type {
   AgentSessionSummaryPage,
   AgentSessionSystemBlock,
 } from "@/types/agent/AgentTypes.js";
+import type { AgentModel } from "@/model/CityModelAdapter.js";
 import { Logger } from "@/utils/logger/Logger.js";
 import { Session } from "@/session/Session.js";
 import { DEFAULT_SHIP_PROMPTS } from "@executor/composer/system/default/SystemDomain.js";
@@ -124,7 +125,7 @@ export class Agent {
   private readonly pluginRegistry: PluginRegistry;
   private readonly config: DowncityConfig;
   private readonly env: Record<string, string>;
-  private readonly defaultModel?: LanguageModel;
+  private readonly defaultModel?: AgentModel;
   private readonly pluginInstances: Map<string, BasePlugin>;
   private readonly sessionCollection: AgentSessionCollection;
 

package/src/config/AgentInitializer.ts

@@ -2,7 +2,7 @@
  * Agent 项目初始化模块。
  *
  * 职责说明（中文）
- * - CLI `city agent create` 与 Console 共用同一套初始化逻辑，避免模板与目录结构分叉。
+ * - CLI `town agent create` 与 Console 共用同一套初始化逻辑，避免模板与目录结构分叉。
  * - 负责创建项目骨架、静态 prompt、默认 `downcity.json`、基础目录与 schema 文件。
  * - 负责把用户在创建阶段提供的最小执行配置与渠道配置写入项目。
  *

package/src/config/DowncitySchema.ts

@@ -51,7 +51,7 @@ export const DOWNCITY_JSON_SCHEMA: JsonObject = {
         modelId: {
           type: "string",
           description:
-            "API 执行模式下绑定的平台全局模型 ID。",
+            "API 执行模式下绑定的 City AIService 模型 ID。",
         },
       },
       required: ["type", "modelId"],

package/src/config/ExecutionBinding.ts

@@ -7,7 +7,7 @@
  * - 让初始化、配置装配、运行时启动都复用同一套执行目标解释规则。
  *
  * 边界说明（中文）
- * - 这里只解析配置结构，不负责验证模型是否真实存在于平台模型池中。
+ * - 这里只解析配置结构，不负责验证模型是否真实存在于 City AIService 中。
  * - 当前只接受 agent 包已经落地支持的执行绑定格式。
  */
 

package/src/executor/composer/compaction/jsonl/JsonlSessionCompactionExecutor.ts

@@ -191,10 +191,6 @@ export async function compactSessionMessagesIfNeeded(
     await deps.writeMetaUnsafe({
       ...prevMeta,
       updatedAt: Date.now(),
-      lastArchiveId: params.archiveOnCompact ? archiveId : undefined,
-      keepLastMessages: Math.max(1, currentKept.length),
-      maxInputTokensApprox: params.maxInputTokensApprox,
-      compactRatio,
     });
   });
 

package/src/executor/composer/system/default/InitPrompts.ts

@@ -1,5 +1,5 @@
 /**
- * InitPrompts：`city agent create` 默认 prompt 资产加载器。
+ * InitPrompts：`town agent create` 默认 prompt 资产加载器。
  *
  * 职责说明（中文）
  * - 统一管理 create 生成的 `PROFILE.md` / `SOUL.md` 默认内容。

package/src/executor/composer/system/default/SystemDomain.ts

@@ -74,7 +74,7 @@ export function buildContextSystemPrompt(input: {
   const outputRules = [
     "Task-run output rules:",
     "- This is a task execution context, not an interactive chat turn.",
-    "- Do NOT send external channel messages via `city chat send` unless explicitly required by the task itself.",
+    "- Do NOT send external channel messages via `town chat send` unless explicitly required by the task itself.",
     "- Reply with result-oriented content; do NOT paste raw tool outputs or JSON logs.",
     "- Keep output compact and avoid unnecessary conversational fillers.",
   ].join("\n");

package/src/executor/composer/system/default/assets/core.prompt.ts

@@ -4,6 +4,6 @@
  */
 
 // Source: src/executor/composer/system/default/assets/core.prompt.ts.txt
-const TEXT_MODULE_CONTENT = "你拥有且仅拥有当前项目 {{project_path}} 的使用权和修改权。当前年份是 {{current_year}} 年。\n1. `.downcity/` 是 Downcity 的运行时数据目录（通常不需要你手动读取/修改；系统会自动写入与注入）。结构与逻辑如下：\n   - `.downcity/agents/<agentId>/sessions/` 是会话消息。\n   - `.downcity/memory/` 是中长期记忆。\n   - `.downcity/profile/Primary.md`、`.downcity/profile/other.md`：全局 profile 记忆；存在时会自动作为 system prompt 注入。\n   - `.downcity/public/`：对外静态资源目录，通过 `GET /downcity/public/<path>` 访问；用于给外部访问的路径。不要存放敏感信息，运行中的 agent server 会把 `.downcity/public/` 暴露为 HTTP 静态资源：`GET /downcity/public/<path>`，你可以把该 URL 发给用户用于下载/查看生成的文件（注意不要暴露敏感信息）。\n   - `.downcity/logs/<YYYY-MM-DD>.jsonl`：运行日志（JSONL）；用于排查问题，避免把原始日志整段贴给用户。\n   - `.downcity/.cache/`：幂等/去重缓存（ingress/egress）；不要手动改。\n   - `.downcity/.debug/`：调试产物（daemon pid/log/meta、适配器事件抓取等）；仅在排查问题时查看。\n   - `.downcity/data/`：小型持久化数据（预留）。\n   - `.downcity/task/`：Task 目录。\n2. PROFILE.md + SOUL.md + downcity.json 是你的一些配置文件，你不需要读取。\n\n# 最重要\n【关于命令执行工具】（重要）\n- 短命令、一次性命令优先使用 `shell_exec`。\n- 长任务、需要中途查状态、需要 stdin 交互时，使用 `shell_start` / `shell_status` / `shell_read` / `shell_write` / `shell_wait` / `shell_close`。\n- 先用 `shell_start` 启动命令并拿到 `shell_id`。\n- `shell_id` 是 shell 会话标识；它不是 chat `session_id`。\n- 长任务期间，优先使用 `shell_status` 查询进度，或使用 `shell_wait` 等待状态变化；不要自己写高频空轮询循环。\n- 只有在确实需要原始增量输出时，才使用 `shell_read` 按 `from_cursor` 继续读取。\n- 需要向进程 stdin 输入内容时，使用 `shell_write`。\n- 命令会话完成后若不再需要，使用 `shell_close` 主动释放资源。\n- 不要把原始超长 shell 输出直接转发给用户，应先总结。\n\n# 默认决策与澄清\n- 默认先执行，再沟通：对低风险、可回滚、用户意图已经足够明显的请求，优先基于当前日期、时区、聊天上下文与常见默认值直接执行，不要在事件标题、默认平台、显然的时间表达上反复追问。\n- 只有当“缺失信息会实质改变结果”时才追问；例如：会影响日期/对象/金额/账户/发送目标，或会触发不可逆、高风险、涉隐私操作。\n- 处理时间表达时，优先使用当前环境提供的 `current_date`、`current_time` 与 `timezone`；如果入站 `<info>` 明确提供了 `user_timezone`，则优先按 `user_timezone` 解析，否则按 runtime clock 的 `timezone` 解析。像“今天/明天/下午两点/提前两小时”这类表达，应先解析为绝对时间，再执行，并在回复里明确写出绝对日期时间。\n- 当任务依赖外部权限、系统能力或第三方连接（如日历、提醒事项、聊天渠道、系统授权）时，先探测可用性，再决定是否承诺“我来创建/发送/写入”。\n- 如果探测结果显示被系统权限、宿主环境或连接状态阻塞，要直接说明真实阻塞点和下一步，而不是先给出“可以，我来做”的承诺后再多轮追问。\n- 若已经有足够信息可以一次完成多个低风险默认动作，应直接完成，并在结果里简短说明采用了哪些默认假设。\n\n# 很重要\n\n安全与边界\n- 不要执行破坏性命令（如 `rm -rf`、`git reset --hard`）除非用户明确要求。\n- 遇到 API Key、Token、Secret、环境变量、bot 凭据等密钥管理问题时，优先指导用户使用 Console（如 `Global / Env`、`Global / Channel Accounts`）维护，不要要求用户把密钥明文直接发送到当前聊天里。\n- `city keys` 只能列出已配置的 key 名与描述，不会返回密钥值。不要让用户把密钥“发给你自己”或继续尝试通过 `city keys` 获取明文。\n";
+const TEXT_MODULE_CONTENT = "你拥有且仅拥有当前项目 {{project_path}} 的使用权和修改权。当前年份是 {{current_year}} 年。\n1. `.downcity/` 是 Downcity 的运行时数据目录（通常不需要你手动读取/修改；系统会自动写入与注入）。结构与逻辑如下：\n   - `.downcity/agents/<agentId>/sessions/` 是会话消息。\n   - `.downcity/memory/` 是中长期记忆。\n   - `.downcity/profile/Primary.md`、`.downcity/profile/other.md`：全局 profile 记忆；存在时会自动作为 system prompt 注入。\n   - `.downcity/public/`：对外静态资源目录，通过 `GET /downcity/public/<path>` 访问；用于给外部访问的路径。不要存放敏感信息，运行中的 agent server 会把 `.downcity/public/` 暴露为 HTTP 静态资源：`GET /downcity/public/<path>`，你可以把该 URL 发给用户用于下载/查看生成的文件（注意不要暴露敏感信息）。\n   - `.downcity/logs/<YYYY-MM-DD>.jsonl`：运行日志（JSONL）；用于排查问题，避免把原始日志整段贴给用户。\n   - `.downcity/.cache/`：幂等/去重缓存（ingress/egress）；不要手动改。\n   - `.downcity/.debug/`：调试产物（daemon pid/log/meta、适配器事件抓取等）；仅在排查问题时查看。\n   - `.downcity/data/`：小型持久化数据（预留）。\n   - `.downcity/task/`：Task 目录。\n2. PROFILE.md + SOUL.md + downcity.json 是你的一些配置文件，你不需要读取。\n\n# 最重要\n【关于命令执行工具】（重要）\n- 短命令、一次性命令优先使用 `shell_exec`。\n- 长任务、需要中途查状态、需要 stdin 交互时，使用 `shell_start` / `shell_status` / `shell_read` / `shell_write` / `shell_wait` / `shell_close`。\n- 先用 `shell_start` 启动命令并拿到 `shell_id`。\n- `shell_id` 是 shell 会话标识；它不是 chat `session_id`。\n- 长任务期间，优先使用 `shell_status` 查询进度，或使用 `shell_wait` 等待状态变化；不要自己写高频空轮询循环。\n- 只有在确实需要原始增量输出时，才使用 `shell_read` 按 `from_cursor` 继续读取。\n- 需要向进程 stdin 输入内容时，使用 `shell_write`。\n- 命令会话完成后若不再需要，使用 `shell_close` 主动释放资源。\n- 不要把原始超长 shell 输出直接转发给用户，应先总结。\n\n# 默认决策与澄清\n- 默认先执行，再沟通：对低风险、可回滚、用户意图已经足够明显的请求，优先基于当前日期、时区、聊天上下文与常见默认值直接执行，不要在事件标题、默认平台、显然的时间表达上反复追问。\n- 只有当“缺失信息会实质改变结果”时才追问；例如：会影响日期/对象/金额/账户/发送目标，或会触发不可逆、高风险、涉隐私操作。\n- 处理时间表达时，优先使用当前环境提供的 `current_date`、`current_time` 与 `timezone`；如果入站 `<info>` 明确提供了 `user_timezone`，则优先按 `user_timezone` 解析，否则按 runtime clock 的 `timezone` 解析。像“今天/明天/下午两点/提前两小时”这类表达，应先解析为绝对时间，再执行，并在回复里明确写出绝对日期时间。\n- 当任务依赖外部权限、系统能力或第三方连接（如日历、提醒事项、聊天渠道、系统授权）时，先探测可用性，再决定是否承诺“我来创建/发送/写入”。\n- 如果探测结果显示被系统权限、宿主环境或连接状态阻塞，要直接说明真实阻塞点和下一步，而不是先给出“可以，我来做”的承诺后再多轮追问。\n- 若已经有足够信息可以一次完成多个低风险默认动作，应直接完成，并在结果里简短说明采用了哪些默认假设。\n\n# 很重要\n\n安全与边界\n- 不要执行破坏性命令（如 `rm -rf`、`git reset --hard`）除非用户明确要求。\n- 遇到 API Key、Token、Secret、环境变量、bot 凭据等密钥管理问题时，优先指导用户使用 Console（如 `Global / Env`、`Global / Channel Accounts`）维护，不要要求用户把密钥明文直接发送到当前聊天里。\n- `town keys` 只能列出已配置的 key 名与描述，不会返回密钥值。不要让用户把密钥“发给你自己”或继续尝试通过 `town keys` 获取明文。\n";
 
 export default TEXT_MODULE_CONTENT;

package/src/executor/composer/system/default/assets/core.prompt.ts.txt

@@ -36,4 +36,4 @@
 安全与边界
 - 不要执行破坏性命令（如 `rm -rf`、`git reset --hard`）除非用户明确要求。
 - 遇到 API Key、Token、Secret、环境变量、bot 凭据等密钥管理问题时，优先指导用户使用 Console（如 `Global / Env`、`Global / Channel Accounts`）维护，不要要求用户把密钥明文直接发送到当前聊天里。
-- `city keys` 只能列出已配置的 key 名与描述，不会返回密钥值。不要让用户把密钥“发给你自己”或继续尝试通过 `city keys` 获取明文。
+- `town keys` 只能列出已配置的 key 名与描述，不会返回密钥值。不要让用户把密钥“发给你自己”或继续尝试通过 `town keys` 获取明文。

package/src/executor/composer/system/default/assets/plugin.prompt.ts

@@ -4,6 +4,6 @@
  */
 
 // Source: src/executor/composer/system/default/assets/plugin.prompt.ts.txt
-const TEXT_MODULE_CONTENT = "# Plugin State\n\n你正在一个基于 plugin 的执行环境中工作。\n\n## 可用命令总览\n- plugin 状态管理（统一使用 `city plugin`）：\n  - `city plugin list`\n  - `city plugin status <pluginName>`\n  - `city plugin start <pluginName>`\n  - `city plugin stop <pluginName>`\n  - `city plugin restart <pluginName>`\n  - `city plugin command <pluginName> <command> [--payload '<json>']`\n  - `city plugin schedule list`\n  - `city plugin schedule info <jobId>`\n  - `city plugin schedule cancel <jobId>`\n- ActionSchedule 管理命令用于查看/取消延迟执行的 plugin action，不是独立 plugin。\n- 当前内建托管 plugin：`shell` / `chat` / `task` / `memory` / `contact`。\n- 当前内建本地 plugin：`auth` / `skill` / `asr` / `tts`。\n- 模块级 action 命令：\n  - `city shell <action> ...`\n  - `city chat <action> ...`\n  - `city task <action> ...`\n  - `city memory <action> ...`\n  - `city plugin action <plugin> <action> ...`\n  - `city skill <action> ...`\n  - `city asr <action> ...`\n  - `city tts <action> ...`\n\n具体 plugin 的执行参考对应文档。\n";
+const TEXT_MODULE_CONTENT = "# Plugin State\n\n你正在一个基于 plugin 的执行环境中工作。\n\n## 可用命令总览\n- plugin 状态管理（统一使用 `town plugin`）：\n  - `town plugin list`\n  - `town plugin status <pluginName>`\n  - `town plugin start <pluginName>`\n  - `town plugin stop <pluginName>`\n  - `town plugin restart <pluginName>`\n  - `town plugin command <pluginName> <command> [--payload '<json>']`\n  - `town plugin schedule list`\n  - `town plugin schedule info <jobId>`\n  - `town plugin schedule cancel <jobId>`\n- ActionSchedule 管理命令用于查看/取消延迟执行的 plugin action，不是独立 plugin。\n- 当前内建托管 plugin：`shell` / `chat` / `task` / `memory` / `contact`。\n- 当前内建本地 plugin：`auth` / `skill` / `asr` / `tts`。\n- 模块级 action 命令：\n  - `town shell <action> ...`\n  - `town chat <action> ...`\n  - `town task <action> ...`\n  - `town memory <action> ...`\n  - `town plugin action <plugin> <action> ...`\n  - `town skill <action> ...`\n  - `town asr <action> ...`\n  - `town tts <action> ...`\n\n具体 plugin 的执行参考对应文档。\n";
 
 export default TEXT_MODULE_CONTENT;

package/src/executor/composer/system/default/assets/plugin.prompt.ts.txt

@@ -3,27 +3,27 @@
 你正在一个基于 plugin 的执行环境中工作。
 
 ## 可用命令总览
-- plugin 状态管理（统一使用 `city plugin`）：
-  - `city plugin list`
-  - `city plugin status <pluginName>`
-  - `city plugin start <pluginName>`
-  - `city plugin stop <pluginName>`
-  - `city plugin restart <pluginName>`
-  - `city plugin command <pluginName> <command> [--payload '<json>']`
-  - `city plugin schedule list`
-  - `city plugin schedule info <jobId>`
-  - `city plugin schedule cancel <jobId>`
+- plugin 状态管理（统一使用 `town plugin`）：
+  - `town plugin list`
+  - `town plugin status <pluginName>`
+  - `town plugin start <pluginName>`
+  - `town plugin stop <pluginName>`
+  - `town plugin restart <pluginName>`
+  - `town plugin command <pluginName> <command> [--payload '<json>']`
+  - `town plugin schedule list`
+  - `town plugin schedule info <jobId>`
+  - `town plugin schedule cancel <jobId>`
 - ActionSchedule 管理命令用于查看/取消延迟执行的 plugin action，不是独立 plugin。
 - 当前内建托管 plugin：`shell` / `chat` / `task` / `memory` / `contact`。
 - 当前内建本地 plugin：`auth` / `skill` / `asr` / `tts`。
 - 模块级 action 命令：
-  - `city shell <action> ...`
-  - `city chat <action> ...`
-  - `city task <action> ...`
-  - `city memory <action> ...`
-  - `city plugin action <plugin> <action> ...`
-  - `city skill <action> ...`
-  - `city asr <action> ...`
-  - `city tts <action> ...`
+  - `town shell <action> ...`
+  - `town chat <action> ...`
+  - `town task <action> ...`
+  - `town memory <action> ...`
+  - `town plugin action <plugin> <action> ...`
+  - `town skill <action> ...`
+  - `town asr <action> ...`
+  - `town tts <action> ...`
 
 具体 plugin 的执行参考对应文档。

package/src/executor/composer/system/default/assets/task.prompt.ts

@@ -4,6 +4,6 @@
  */
 
 // Source: src/executor/composer/system/default/assets/task.prompt.ts.txt
-const TEXT_MODULE_CONTENT = "你正在执行 Task 系统内部任务（非聊天会话）。\n\n运行约束（关键）：\n- 当前上下文用于任务执行与审计，不是用户聊天回合。\n- 除非任务正文明确要求，否则不要调用 `city chat send` 或任何外部渠道发送动作。\n- 不要把自己当作“即时对话客服”；优先完成任务目标并输出可审计结果。\n- 允许在执行过程中产生必要的中间说明，但你**最后一条 assistant 返回**会被系统直接当作 `output.md` 与最终发送内容。\n\n输出原则：\n- 你的最后一条 assistant 返回必须是“任务交付物本身”。\n- 最后一条 assistant 返回不要包含过程汇报、状态说明、任务管理说明或发送说明。\n- 优先返回可复用、结构化、简洁的结果内容。\n- 不要回显冗长原始日志；必要时给摘要与关键结论。\n- 如任务输入要求固定格式（例如 JSON），严格遵守该格式。\n- 如果任务要求“发送到当前会话”或“发送给用户”，默认理解为：系统会把你的最后一条 assistant 返回直接回发；因此你应该直接输出那段要发给用户的正文。\n- 除非任务正文明确要求输出执行摘要，否则最后一条 assistant 返回不要输出“任务已完成”“已发送”“我先查看一下”“我来为你处理”等元话术。\n\n最后一条 assistant 返回禁止的常见内容：\n- “我来为你……”\n- “首先让我……”\n- “我看到已经有一个同名任务……”\n- “任务已发送 / 已完成 / 已更新……”\n- “任务状态总结……”\n- 任何围绕 task 管理流程的说明性文字\n\n结束前自检：\n- 在结束前检查：你准备发出的最后一条 assistant 返回，是否就是最终交付物本身。\n- 如果最后一条 assistant 返回主要是在描述执行过程、任务状态或发送情况，而不是最终交付内容本身，说明输出方向错误，必须重写。\n- 如果删掉“我来”“首先”“已发送”“任务状态”这类句子后几乎没有剩余内容，说明这不是合格的 task 输出。\n\n上下文原则：\n- 该任务上下文是独立执行上下文，不继承聊天对话目标。\n- 如与系统其他提示冲突，以“任务执行上下文规则”为准。\n";
+const TEXT_MODULE_CONTENT = "你正在执行 Task 系统内部任务（非聊天会话）。\n\n运行约束（关键）：\n- 当前上下文用于任务执行与审计，不是用户聊天回合。\n- 除非任务正文明确要求，否则不要调用 `town chat send` 或任何外部渠道发送动作。\n- 不要把自己当作“即时对话客服”；优先完成任务目标并输出可审计结果。\n- 允许在执行过程中产生必要的中间说明，但你**最后一条 assistant 返回**会被系统直接当作 `output.md` 与最终发送内容。\n\n输出原则：\n- 你的最后一条 assistant 返回必须是“任务交付物本身”。\n- 最后一条 assistant 返回不要包含过程汇报、状态说明、任务管理说明或发送说明。\n- 优先返回可复用、结构化、简洁的结果内容。\n- 不要回显冗长原始日志；必要时给摘要与关键结论。\n- 如任务输入要求固定格式（例如 JSON），严格遵守该格式。\n- 如果任务要求“发送到当前会话”或“发送给用户”，默认理解为：系统会把你的最后一条 assistant 返回直接回发；因此你应该直接输出那段要发给用户的正文。\n- 除非任务正文明确要求输出执行摘要，否则最后一条 assistant 返回不要输出“任务已完成”“已发送”“我先查看一下”“我来为你处理”等元话术。\n\n最后一条 assistant 返回禁止的常见内容：\n- “我来为你……”\n- “首先让我……”\n- “我看到已经有一个同名任务……”\n- “任务已发送 / 已完成 / 已更新……”\n- “任务状态总结……”\n- 任何围绕 task 管理流程的说明性文字\n\n结束前自检：\n- 在结束前检查：你准备发出的最后一条 assistant 返回，是否就是最终交付物本身。\n- 如果最后一条 assistant 返回主要是在描述执行过程、任务状态或发送情况，而不是最终交付内容本身，说明输出方向错误，必须重写。\n- 如果删掉“我来”“首先”“已发送”“任务状态”这类句子后几乎没有剩余内容，说明这不是合格的 task 输出。\n\n上下文原则：\n- 该任务上下文是独立执行上下文，不继承聊天对话目标。\n- 如与系统其他提示冲突，以“任务执行上下文规则”为准。\n";
 
 export default TEXT_MODULE_CONTENT;

package/src/executor/composer/system/default/assets/task.prompt.ts.txt

@@ -2,7 +2,7 @@
 
 运行约束（关键）：
 - 当前上下文用于任务执行与审计，不是用户聊天回合。
-- 除非任务正文明确要求，否则不要调用 `city chat send` 或任何外部渠道发送动作。
+- 除非任务正文明确要求，否则不要调用 `town chat send` 或任何外部渠道发送动作。
 - 不要把自己当作“即时对话客服”；优先完成任务目标并输出可审计结果。
 - 允许在执行过程中产生必要的中间说明，但你**最后一条 assistant 返回**会被系统直接当作 `output.md` 与最终发送内容。
 

package/src/executor/messages/ChatMessageMarkupTypes.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 统一描述 chat plugin runtime 中可见的消息协议：frontmatter metadata + `<file>` 标签。
- * - direct 模式、`city chat send`、入站附件注入、渠道出站解析都应复用本类型。
+ * - direct 模式、`town chat send`、入站附件注入、渠道出站解析都应复用本类型。
  */
 
 /**

package/src/executor/store/history/jsonl/JsonlSessionHistoryStore.ts

@@ -194,29 +194,9 @@ export class JsonlSessionHistoryStore implements SessionHistoryStore {
     await fs.ensureFile(this.getMessagesFilePath());
   }
 
-  private normalizePinnedSkillIds(input: string[] | undefined): string[] {
-    if (!Array.isArray(input)) return [];
-    const out: string[] = [];
-    for (const raw of input) {
-      const id = typeof raw === "string" ? raw.trim() : "";
-      if (!id) continue;
-      out.push(id);
-    }
-    return Array.from(new Set(out)).slice(0, 2000);
-  }
-
-  private normalizeSdkConfig(
-    input: SessionHistoryMetaV1["sdkConfig"],
-  ): SessionHistoryMetaV1["sdkConfig"] {
-    if (!input || typeof input !== "object" || Array.isArray(input)) {
-      return undefined;
-    }
-    const modelLabel =
-      typeof input.modelLabel === "string" ? input.modelLabel.trim() : "";
-    if (!modelLabel) return undefined;
-    return {
-      modelLabel,
-    };
+  private normalizeText(input: unknown): string | undefined {
+    const value = typeof input === "string" ? input.trim() : "";
+    return value || undefined;
   }
 
   private async readMetaUnsafe(): Promise<SessionHistoryMetaV1> {
@@ -235,24 +215,15 @@ export class JsonlSessionHistoryStore implements SessionHistoryStore {
         ...(typeof raw.createdAt === "number" && Number.isFinite(raw.createdAt)
           ? { createdAt: raw.createdAt }
           : {}),
-        updatedAt: typeof raw.updatedAt === "number" ? raw.updatedAt : 0,
-        pinnedSkillIds: this.normalizePinnedSkillIds(raw.pinnedSkillIds),
-        ...(typeof raw.lastArchiveId === "string" && raw.lastArchiveId.trim()
-          ? { lastArchiveId: raw.lastArchiveId.trim() }
-          : {}),
-        ...(typeof raw.keepLastMessages === "number" &&
-        Number.isFinite(raw.keepLastMessages)
-          ? { keepLastMessages: raw.keepLastMessages }
-          : {}),
-        ...(typeof raw.maxInputTokensApprox === "number" &&
-        Number.isFinite(raw.maxInputTokensApprox)
-          ? { maxInputTokensApprox: raw.maxInputTokensApprox }
+        ...(this.normalizeText(raw.timezone)
+          ? { timezone: this.normalizeText(raw.timezone) }
           : {}),
-        ...(typeof raw.compactRatio === "number" && Number.isFinite(raw.compactRatio)
-          ? { compactRatio: raw.compactRatio }
+        updatedAt: typeof raw.updatedAt === "number" ? raw.updatedAt : 0,
+        ...(this.normalizeText(raw.title)
+          ? { title: this.normalizeText(raw.title) }
           : {}),
-        ...(this.normalizeSdkConfig(raw.sdkConfig)
-          ? { sdkConfig: this.normalizeSdkConfig(raw.sdkConfig) }
+        ...(this.normalizeText(raw.modelLabel)
+          ? { modelLabel: this.normalizeText(raw.modelLabel) }
           : {}),
       };
     } catch {
@@ -261,7 +232,6 @@ export class JsonlSessionHistoryStore implements SessionHistoryStore {
         sessionId: this.sessionId,
         createdAt: Date.now(),
         updatedAt: 0,
-        pinnedSkillIds: [],
       };
     }
   }
@@ -276,26 +246,16 @@ export class JsonlSessionHistoryStore implements SessionHistoryStore {
       ...(typeof next.createdAt === "number" && Number.isFinite(next.createdAt)
         ? { createdAt: next.createdAt }
         : {}),
+      ...(this.normalizeText(next.timezone)
+        ? { timezone: this.normalizeText(next.timezone) }
+        : {}),
       updatedAt:
         typeof next.updatedAt === "number" ? next.updatedAt : Date.now(),
-      pinnedSkillIds: this.normalizePinnedSkillIds(next.pinnedSkillIds),
-      ...(typeof next.lastArchiveId === "string" && next.lastArchiveId.trim()
-        ? { lastArchiveId: next.lastArchiveId.trim() }
-        : {}),
-      ...(typeof next.keepLastMessages === "number" &&
-      Number.isFinite(next.keepLastMessages)
-        ? { keepLastMessages: next.keepLastMessages }
-        : {}),
-      ...(typeof next.maxInputTokensApprox === "number" &&
-      Number.isFinite(next.maxInputTokensApprox)
-        ? { maxInputTokensApprox: next.maxInputTokensApprox }
-        : {}),
-      ...(typeof next.compactRatio === "number" &&
-      Number.isFinite(next.compactRatio)
-        ? { compactRatio: next.compactRatio }
+      ...(this.normalizeText(next.title)
+        ? { title: this.normalizeText(next.title) }
         : {}),
-      ...(this.normalizeSdkConfig(next.sdkConfig)
-        ? { sdkConfig: this.normalizeSdkConfig(next.sdkConfig) }
+      ...(this.normalizeText(next.modelLabel)
+        ? { modelLabel: this.normalizeText(next.modelLabel) }
         : {}),
     };
     await fs.writeJson(this.getMetaFilePath(), normalized, { spaces: 2 });

package/src/executor/tools/shell/ShellToolBridge.ts

@@ -75,7 +75,7 @@ function tryParseJsonObject(raw: string): JsonObject | null {
 function shouldEnableCommandBridge(command: string): boolean {
   const raw = String(command || "").trim();
   if (!raw) return false;
-  return /(?:^|\s)(?:city|downcity)(?:\s|$)/i.test(raw);
+  return /(?:^|\s)(?:city|town)(?:\s|$)/i.test(raw);
 }
 
 async function injectUserTextMessage(params: {

package/src/executor/tools/shell/ShellToolFormatting.ts

@@ -33,7 +33,7 @@ function applyEnvMap(
 }
 
 /**
- * 对 `city chat send` 命令做前置安全校验。
+ * 对 `town chat send` 命令做前置安全校验。
  *
  * 关键点（中文）
  * - 历史上模型会把长文本直接拼进多行 shell 命令，导致后续行被 zsh 当作独立命令解析。
@@ -42,20 +42,20 @@ function applyEnvMap(
  */
 export function validateChatSendCommand(cmd: string): string | null {
   const source = String(cmd ?? "");
-  if (!/\b(?:city|downcity)\s+chat\s+send\b/.test(source)) return null;
+  if (!/\bbay\s+chat\s+send\b/.test(source)) return null;
   if (!/[\r\n]/.test(source)) return null;
-  if (/\b(?:city|downcity)\s+chat\s+send\b[\s\S]*\s--stdin(?:\s|$)/.test(source)) {
+  if (/\bbay\s+chat\s+send\b[\s\S]*\s--stdin(?:\s|$)/.test(source)) {
     return null;
   }
-  if (/\b(?:city|downcity)\s+chat\s+send\b[\s\S]*\s--text(?:\s|$)/.test(source)) {
+  if (/\bbay\s+chat\s+send\b[\s\S]*\s--text(?:\s|$)/.test(source)) {
     return null;
   }
-  if (/\b(?:city|downcity)\s+chat\s+send\b[\s\S]*\s--text-file(?:\s|$)/.test(source)) {
+  if (/\bbay\s+chat\s+send\b[\s\S]*\s--text-file(?:\s|$)/.test(source)) {
     return null;
   }
   return [
-    "Unsafe `city chat send` command: real newlines are not allowed.",
-    "If your message is multi-line, use `city chat send --stdin` (with heredoc/pipe), `--text-file`, or explicit `--text`.",
+    "Unsafe `town chat send` command: real newlines are not allowed.",
+    "If your message is multi-line, use `town chat send --stdin` (with heredoc/pipe), `--text-file`, or explicit `--text`.",
   ].join(" ");
 }
 

package/src/executor/types/SessionHistoryMeta.ts

@@ -3,21 +3,9 @@
  *
  * 关键点（中文）
  * - 存储位置：`.downcity/agents/<encodedAgentId>/sessions/<encodedSessionId>/messages/meta.json`
- * - 用于保存 compact 元数据与固定注入的 skills 信息
+ * - 用于保存 session 列表、详情和索引所需的轻量元信息
  */
 
-/**
- * SDK Session 配置摘要。
- *
- * 关键点（中文）
- * - 这里只存可稳定序列化、仅用于回显/索引的轻量配置摘要。
- * - 例如本地注入的 `LanguageModel` 实例本身不可序列化，因此仅记录其可读标签。
- */
-export type SessionHistorySdkConfigV1 = {
-  /** 当前 session 绑定模型的可读标签。 */
-  modelLabel?: string;
-};
-
 export type SessionHistoryMetaV1 = {
   /** schema 版本。 */
   v: 1;
@@ -31,16 +19,8 @@ export type SessionHistoryMetaV1 = {
   timezone?: string;
   /** 最近一次更新元信息的时间戳（ms）。 */
   updatedAt: number;
-  /** 固定注入到 Session 上下文的 skill id 列表。 */
-  pinnedSkillIds: string[];
-  /** 最近一次归档生成的 archive id。 */
-  lastArchiveId?: string;
-  /** 最近一次 compact 生效的保留消息数。 */
-  keepLastMessages?: number;
-  /** 最近一次 compact 生效的输入 token 近似上限。 */
-  maxInputTokensApprox?: number;
-  /** 最近一次 compact 生效的前段压缩比例。 */
-  compactRatio?: number;
-  /** SDK 侧的轻量配置摘要。 */
-  sdkConfig?: SessionHistorySdkConfigV1;
+  /** 当前 session 持久化标题。 */
+  title?: string;
+  /** 当前 session 绑定模型的可读标签。 */
+  modelLabel?: string;
 };

package/src/index.ts

@@ -10,8 +10,13 @@
 // Agent 入口
 export { Agent } from "./agent/Agent.js";
 export { RemoteAgent } from "./agent/RemoteAgent.js";
+export {
+  inferAgentModelLabel,
+  normalizeAgentModel,
+} from "./model/CityModelAdapter.js";
 export type {
   AgentSessionCollection,
+  AgentModel,
   AgentSessionActor,
   AgentSession,
   AgentCreateSessionInput,
@@ -281,14 +286,9 @@ export type {
   StoredChannelAccountChannel,
   StoredEnvEntry,
   StoredGlobalEnvEntry,
-  StoredModel,
-  StoredModelProvider,
-  StoredProviderMeta,
   UpsertChannelAccountInput,
   UpsertEnvEntryInput,
   UpsertGlobalEnvEntryInput,
-  UpsertModelInput,
-  UpsertModelProviderInput,
 } from "./types/runtime/host/Store.js";
 
 // HTTP auth 协议类型