@downcity/agent 1.1.203 → 1.1.205

package/src/session/SessionTitle.ts

@@ -11,6 +11,7 @@ import { generateText, type LanguageModel } from "ai";
 import type { SessionHistoryMetaV1 } from "@/executor/types/SessionHistoryMeta.js";
 import type { SessionRecordV1 } from "@/executor/types/SessionRecords.js";
 import { is_session_message_record } from "@/executor/types/SessionRecords.js";
+import type { Logger } from "@/utils/logger/Logger.js";
 import {
   normalizeSessionTitle,
   readSessionMetadata,
@@ -48,6 +49,16 @@ export interface EnsureSessionTitleParams {
    */
   model?: LanguageModel;
 
+  /**
+   * 当前模型展示标签；仅用于排障日志，不参与生成逻辑。
+   */
+  modelLabel?: string;
+
+  /**
+   * 当前 session 运行日志器；标题生成失败时仅记录摘要，不影响主流程。
+   */
+  logger?: Logger;
+
   /**
    * 是否允许调用模型生成标题。
    */
@@ -102,31 +113,135 @@ function normalizeGeneratedTitle(input: string): string | undefined {
     : undefined;
 }
 
+function summarizeTitleError(error: unknown): {
+  /**
+   * 错误对象名称。
+   */
+  name: string | null;
+
+  /**
+   * 错误消息摘要。
+   */
+  message: string | null;
+
+  /**
+   * 字符串化后的错误摘要。
+   */
+  error: string;
+} {
+  const record =
+    error && typeof error === "object" && !Array.isArray(error)
+      ? (error as Record<string, unknown>)
+      : {};
+  return {
+    name: typeof record.name === "string" ? record.name : null,
+    message: typeof record.message === "string" ? record.message : null,
+    error: String(error),
+  };
+}
+
+async function logSessionTitleDiagnostic(input: {
+  /**
+   * 当前 session 标识。
+   */
+  sessionId: string;
+
+  /**
+   * 日志级别。
+   */
+  level: "debug" | "warn";
+
+  /**
+   * 日志消息。
+   */
+  message: string;
+
+  /**
+   * 结构化日志字段。
+   */
+  details: Record<string, string | number | boolean | null | undefined>;
+
+  /**
+   * 当前 session 运行日志器。
+   */
+  logger?: Logger;
+}): Promise<void> {
+  if (!input.logger) return;
+  try {
+    await input.logger.log(input.level, input.message, {
+      sessionId: input.sessionId,
+      ...input.details,
+    });
+  } catch {
+    // 关键点（中文）：标题诊断日志失败不能影响 session 主流程。
+  }
+}
+
 async function generateSessionTitle(input: {
   /**
    * 当前模型实例。
    */
   model: LanguageModel;
 
+  /**
+   * 当前 session 标识。
+   */
+  sessionId: string;
+
+  /**
+   * 当前模型展示标签；仅用于排障日志。
+   */
+  modelLabel?: string;
+
   /**
    * 首条用户消息文本。
    */
   firstUserText: string;
+
+  /**
+   * 当前 session 运行日志器。
+   */
+  logger?: Logger;
 }): Promise<string | undefined> {
   try {
     const result = await generateText({
       model: input.model,
       system:
-        "你负责为一段会话生成极简标题。只输出标题本身，不要解释，不要使用引号。",
+        "You generate minimal conversation titles. Output only the title itself, with no explanation and no quotation marks.",
       prompt: [
-        "根据下面这条用户首条消息，生成一个简短的会话标题。",
-        "要求：3 到 12 个汉字或 2 到 6 个英文词；不要句号；不要前缀。",
+        "Generate a short conversation title from the first user message below.",
+        "Requirements: 3 to 12 Chinese characters or 2 to 6 English words; no period; no prefix.",
         "",
         input.firstUserText,
       ].join("\n"),
     });
-    return normalizeGeneratedTitle(result.text);
-  } catch {
+    const generatedTitle = normalizeGeneratedTitle(result.text);
+    if (!generatedTitle) {
+      await logSessionTitleDiagnostic({
+        logger: input.logger,
+        sessionId: input.sessionId,
+        level: "warn",
+        message: "[agent] session_title.empty",
+        details: {
+          modelLabel: input.modelLabel || null,
+          firstUserTextLength: input.firstUserText.length,
+          rawTitleLength: String(result.text || "").length,
+        },
+      });
+    }
+    return generatedTitle;
+  } catch (error) {
+    await logSessionTitleDiagnostic({
+      logger: input.logger,
+      sessionId: input.sessionId,
+      level: "warn",
+      message: "[agent] session_title.generate_failed",
+      details: {
+        modelLabel: input.modelLabel || null,
+        firstUserTextLength: input.firstUserText.length,
+        ...summarizeTitleError(error),
+      },
+    });
     // 关键点（中文）：标题生成失败不能影响 session 主流程。
     return undefined;
   }
@@ -142,13 +257,30 @@ export async function ensureSessionTitle(
   if (current.title) return current;
 
   const firstUserText = resolveFirstUserText(input.messages);
-  if (input.generate !== true || !input.model || !firstUserText) {
+  if (input.generate !== true) {
+    return current;
+  }
+  if (!input.model || !firstUserText) {
+    await logSessionTitleDiagnostic({
+      logger: input.logger,
+      sessionId: input.sessionId,
+      level: "debug",
+      message: "[agent] session_title.skipped",
+      details: {
+        reason: !input.model ? "missing_model" : "missing_first_user_text",
+        modelLabel: input.modelLabel || null,
+        messageCount: input.messages.length,
+      },
+    });
     return current;
   }
 
   const generatedTitle = await generateSessionTitle({
     model: input.model,
+    sessionId: input.sessionId,
+    modelLabel: input.modelLabel,
     firstUserText,
+    logger: input.logger,
   });
   if (!generatedTitle) return current;
 

package/src/session/services/SessionStateService.ts

@@ -41,6 +41,7 @@ import type {
 import { to_session_action_record } from "@/executor/types/SessionRecords.js";
 import type { SessionLocalState } from "@/types/session/SessionLocalState.js";
 import { generateId } from "@/utils/Id.js";
+import type { Logger } from "@/utils/logger/Logger.js";
 
 type SessionStateServiceOptions = {
   /**
@@ -73,6 +74,11 @@ type SessionStateServiceOptions = {
    */
   state: SessionLocalState;
 
+  /**
+   * 当前 session 运行日志器。
+   */
+  logger: Logger;
+
   /**
    * 在执行前补齐宿主级配置。
    */
@@ -107,6 +113,7 @@ export class SessionStateService {
   private readonly history_store: JsonlSessionHistoryStore;
   private readonly executor: Executor;
   private readonly state: SessionLocalState;
+  private readonly logger: Logger;
   private readonly ensure_configured_hook?: SessionStateServiceOptions["ensure_configured_hook"];
   private readonly publish_event: SessionStateServiceOptions["publish_event"];
 
@@ -117,6 +124,7 @@ export class SessionStateService {
     this.history_store = options.history_store;
     this.executor = options.executor;
     this.state = options.state;
+    this.logger = options.logger;
     this.ensure_configured_hook = options.ensure_configured_hook;
     this.publish_event = options.publish_event;
   }
@@ -340,6 +348,10 @@ export class SessionStateService {
       sessionId: this.session_id,
       messages,
       ...(input?.generate ? { model: this.state.sessionConfig.model } : {}),
+      ...(this.state.sessionConfig.modelLabel
+        ? { modelLabel: this.state.sessionConfig.modelLabel }
+        : {}),
+      logger: this.logger,
       generate: input?.generate === true,
     });
     const next_title = String(next_metadata.title || "").trim();

package/src/session/services/SessionViewService.ts

@@ -31,6 +31,7 @@ import type {
 import type { SessionRecordV1 } from "@/executor/types/SessionRecords.js";
 import { SessionStateService } from "@/session/services/SessionStateService.js";
 import type { SessionRunContext } from "@/types/executor/SessionRunContext.js";
+import type { Logger } from "@/utils/logger/Logger.js";
 
 type SessionViewServiceOptions<TSession extends Pick<AgentSession, "set">> = {
   /**
@@ -58,6 +59,11 @@ type SessionViewServiceOptions<TSession extends Pick<AgentSession, "set">> = {
    */
   state_service: SessionStateService;
 
+  /**
+   * 当前 session 运行日志器。
+   */
+  logger: Logger;
+
   /**
    * 判断当前 session 是否正在执行。
    */
@@ -106,6 +112,7 @@ export class SessionViewService<TSession extends Pick<AgentSession, "set">> {
   private readonly session_id: string;
   private readonly history_store: JsonlSessionHistoryStore;
   private readonly state_service: SessionStateService;
+  private readonly logger: Logger;
   private readonly is_executing: SessionViewServiceOptions<TSession>["is_executing"];
   private readonly get_instruction_system_blocks: SessionViewServiceOptions<TSession>["get_instruction_system_blocks"];
   private readonly get_managed_plugin_system_blocks: SessionViewServiceOptions<TSession>["get_managed_plugin_system_blocks"];
@@ -119,6 +126,7 @@ export class SessionViewService<TSession extends Pick<AgentSession, "set">> {
     this.session_id = options.session_id;
     this.history_store = options.history_store;
     this.state_service = options.state_service;
+    this.logger = options.logger;
     this.is_executing = options.is_executing;
     this.get_instruction_system_blocks = options.get_instruction_system_blocks;
     this.get_managed_plugin_system_blocks =
@@ -164,6 +172,7 @@ export class SessionViewService<TSession extends Pick<AgentSession, "set">> {
           agentId: this.agent_id,
           sessionId: this.session_id,
           messages: input.messages,
+          logger: this.logger,
         });
     return buildSessionInfo({
       projectRoot: this.project_root,

package/src/types/runtime/auth/AuthPermission.ts

@@ -93,19 +93,19 @@ export interface AuthDefaultRoleDefinition {
 export const AUTH_DEFAULT_ROLES: AuthDefaultRoleDefinition[] = [
   {
     name: "admin",
-    description: "系统管理员，可管理统一账户与所有控制面能力。",
+    description: "System administrator who can manage unified accounts and all control-plane capabilities.",
     permissions: [...AUTH_PERMISSION_KEYS],
   },
   {
     name: "operator",
-    description: "运维角色，可查看并操作运行时，但不管理统一账户。",
+    description: "Operations role that can view and operate the runtime but cannot manage unified accounts.",
     permissions: AUTH_PERMISSION_KEYS.filter((permission) =>
       permission !== "auth.write" && permission !== "auth.read"
     ),
   },
   {
     name: "viewer",
-    description: "只读角色，可查看状态但不能执行高危变更。",
+    description: "Read-only role that can view status but cannot perform high-risk changes.",
     permissions: [
       "agent.read",
       "task.read",